locale/ru/LC_MESSAGES/initdb-9.6.mo 0000644 00000072365 14751153420 0012355 0 ustar 00 �� � , � <
�
R �
* 5 - F g t ` � � = W W X � A � 5 � J / z 6 � P � C : b Q � 5 � ] % 4 � B � H � G D > � 4 � 9 3 : ? n / � - � > y K ( � # � , - ? 7 m ( � 6 � , ' 2 5 Z F � " � < � & 7 - ^ - � ! � 1 � ? & N / u = � ! � " 6 ( + _ � 0 � ; � $ / 4 & d � $ � ~ � 1 M < � G � 3 " 8 V ( � J � � � � C � - C! 8 q! ! �! , �! �! J " 0 \" 4 �" A �" @ # R E# K �# " �# ! $ � )$ d �$ % %% � D% [ �% R $& K w& % �& �& ' ' ; 8' ; t' � �' @ A( ; �( �( u �) q E* f �* s + & �+ �+ ) �+ t �+ / `, �, & �, 0 �, . �, - &- T- k- & }- # �- �- $ �- ( . + 7. " c. �. " �. ! �. , �. $ / * 8/ % c/ ! �/ �/ �/ 0 �/ 0 (0 ,0 ;0 - M0 {0 & �0 % �0 �0 3 1 :1 T1 ( h1 � �1 � �3 9 4 M4 " c4 W �4 � �4 � r5 v 56 � �7 � m8 T =9 ` �: @ �: s 4; , �; Q �; � '< i �< X K= s �= n > � �> N +? H z? _ �? ` #@ ` �@ d �@ H JA U �A j �A < TB S �B { �B aC = xD 1 �D a �D D JE U �E ? �E h %F X �F C �F d +G � �G S H t qH ? �H M &I M tI 9 �I ` �I ]J C �J Q !K p sK U �K ; :L k vL F �L 4 )M ^ ^M \ �M G N ^ bN P �N , O ( ?O � hO { AP | �P 0 :Q ~ kQ i �Q ] TR P �R � S / �S " �T ( �T } U O �U M �U 8 V O YV �V � �V _ fW h �W � /X � �X � KY � �Y V {Z T �Z � '[ � \ �\ K �\ � )] � ^ � �^ t 0_ G �_ & �_ : ` D O` � �` e a � �a � gb h �b � Rc � Je � +f � �f � �g [ fh �h ] �h =i p ?j �j V �j l $k J �k K �k ) (l " Rl = ul ; �l C �l Q 3m J �m y �m ; Jn K �n ? �n S o Q fo O �o i p [ rp B �p ( q - :q Y hq 5 �q �q �q r R 5r H �r Q �r P #s H ts j �s 5 (t 2 ^t c �t � � 5 ( � ] � � J l 6 H X � � K z � � r I � � { � N d R V o | ~ � . y U } � m � ` G = * f / $ � > _ � # A � t C 8 Y 0 T , � % + v L 3 � 2 n � � h B j E ? 9 ) ! & � � � q � � D S Z g
e ; ' ^ " F x c � w P [ s � @ i �
1 - \ � u : k � 4 W Q 7 � O � < M p a b �
If the data directory is not specified, the environment variable PGDATA
is used.
Less commonly used options:
Options:
Other options:
Report bugs to <pgsql-bugs@postgresql.org>.
Success. You can now start the database server using:
%s%s%spg_ctl%s -D %s%s%s -l logfile start
Sync to disk skipped.
The data directory might become corrupt if the operating system crashes.
WARNING: enabling "trust" authentication for local connections
You can change this by editing pg_hba.conf or using the option -A, or
--auth-local and --auth-host, the next time you run initdb.
--auth-host=METHOD default authentication method for local TCP/IP connections
--auth-local=METHOD default authentication method for local-socket connections
--lc-collate=, --lc-ctype=, --lc-messages=LOCALE
--lc-monetary=, --lc-numeric=, --lc-time=LOCALE
set default locale in the respective category for
new databases (default taken from environment)
--locale=LOCALE set default locale for new databases
--no-locale equivalent to --locale=C
--pwfile=FILE read password for the new superuser from file
%s [OPTION]... [DATADIR]
-?, --help show this help, then exit
-A, --auth=METHOD default authentication method for local connections
-E, --encoding=ENCODING set default encoding for new databases
-L DIRECTORY where to find the input files
-N, --nosync do not wait for changes to be written safely to disk
-S, --sync-only only sync data directory
-T, --text-search-config=CFG
default text search configuration
-U, --username=NAME database superuser name
-V, --version output version information, then exit
-W, --pwprompt prompt for a password for the new superuser
-X, --xlogdir=XLOGDIR location for the transaction log directory
-d, --debug generate lots of debugging output
-k, --data-checksums use data page checksums
-n, --noclean do not clean up after errors
-s, --show show internal settings
[-D, --pgdata=]DATADIR location for this database cluster
%s initializes a PostgreSQL database cluster.
%s: "%s" is not a valid server encoding name
%s: WARNING: cannot create restricted tokens on this platform
%s: cannot be run as root
Please log in (using, e.g., "su") as the (unprivileged) user that will
own the server process.
%s: could not access directory "%s": %s
%s: could not access file "%s": %s
%s: could not allocate SIDs: error code %lu
%s: could not change permissions of "%s": %s
%s: could not change permissions of directory "%s": %s
%s: could not create directory "%s": %s
%s: could not create restricted token: error code %lu
%s: could not create symbolic link "%s": %s
%s: could not execute command "%s": %s
%s: could not find suitable encoding for locale "%s"
%s: could not find suitable text search configuration for locale "%s"
%s: could not fsync file "%s": %s
%s: could not get exit code from subprocess: error code %lu
%s: could not open directory "%s": %s
%s: could not open file "%s" for reading: %s
%s: could not open file "%s" for writing: %s
%s: could not open file "%s": %s
%s: could not open process token: error code %lu
%s: could not re-execute with restricted token: error code %lu
%s: could not read directory "%s": %s
%s: could not read password from file "%s": %s
%s: could not start process for command "%s": error code %lu
%s: could not stat file "%s": %s
%s: could not write file "%s": %s
%s: data directory "%s" not removed at user's request
%s: directory "%s" exists but is not empty
%s: encoding mismatch
%s: failed to remove contents of data directory
%s: failed to remove contents of transaction log directory
%s: failed to remove data directory
%s: failed to remove transaction log directory
%s: failed to restore old locale "%s"
%s: file "%s" does not exist
%s: file "%s" is not a regular file
%s: input file "%s" does not belong to PostgreSQL %s
Check your installation or specify the correct path using the option -L.
%s: input file location must be an absolute path
%s: invalid authentication method "%s" for "%s" connections
%s: invalid locale name "%s"
%s: invalid locale settings; check LANG and LC_* environment variables
%s: locale "%s" requires unsupported encoding "%s"
%s: locale name has non-ASCII characters, skipped: "%s"
%s: locale name too long, skipped: "%s"
%s: must specify a password for the superuser to enable %s authentication
%s: no data directory specified
You must identify the directory where the data for this database system
will reside. Do this with either the invocation option -D or the
environment variable PGDATA.
%s: out of memory
%s: password file "%s" is empty
%s: password prompt and password file cannot be specified together
%s: removing contents of data directory "%s"
%s: removing contents of transaction log directory "%s"
%s: removing data directory "%s"
%s: removing transaction log directory "%s"
%s: setlocale() failed
%s: superuser name "%s" is disallowed; role names cannot begin with "pg_"
%s: symlinks are not supported on this platform
%s: too many command-line arguments (first is "%s")
%s: transaction log directory "%s" not removed at user's request
%s: transaction log directory location must be an absolute path
%s: warning: specified text search configuration "%s" might not match locale "%s"
%s: warning: suitable text search configuration for locale "%s" is unknown
Data page checksums are disabled.
Data page checksums are enabled.
Encoding "%s" implied by locale is not allowed as a server-side encoding.
The default database encoding will be set to "%s" instead.
Encoding "%s" is not allowed as a server-side encoding.
Rerun %s with a different locale selection.
Enter it again: Enter new superuser password: If you want to create a new database system, either remove or empty
the directory "%s" or run %s
with an argument other than "%s".
If you want to store the transaction log there, either
remove or empty the directory "%s".
It contains a dot-prefixed/invisible file, perhaps due to it being a mount point.
It contains a lost+found directory, perhaps due to it being a mount point.
No usable system locales were found.
Passwords didn't match.
Rerun %s with the -E option.
Running in debug mode.
Running in noclean mode. Mistakes will not be cleaned up.
The database cluster will be initialized with locale "%s".
The database cluster will be initialized with locales
COLLATE: %s
CTYPE: %s
MESSAGES: %s
MONETARY: %s
NUMERIC: %s
TIME: %s
The default database encoding has accordingly been set to "%s".
The default text search configuration will be set to "%s".
The encoding you selected (%s) and the encoding that the
selected locale uses (%s) do not match. This would lead to
misbehavior in various character string processing functions.
Rerun %s and either do not specify an encoding explicitly,
or choose a matching combination.
The files belonging to this database system will be owned by user "%s".
This user must also own the server process.
The program "postgres" is needed by %s but was not found in the
same directory as "%s".
Check your installation.
The program "postgres" was found by "%s"
but was not the same version as %s.
Check your installation.
This might mean you have a corrupted installation or identified
the wrong directory with the invocation option -L.
Try "%s --help" for more information.
Usage:
Use the option "--debug" to see details.
Using a mount point directly as the data directory is not recommended.
Create a subdirectory under the mount point.
cannot duplicate null pointer (internal error)
caught signal
child process exited with exit code %d child process exited with unrecognized status %d child process was terminated by exception 0x%X child process was terminated by signal %d: %s command not executable command not found could not change directory to "%s": %s could not close directory "%s": %s
could not find a "%s" to execute could not get junction for "%s": %s
could not identify current directory: %s could not look up effective user ID %ld: %s could not open directory "%s": %s
could not read binary "%s" could not read directory "%s": %s
could not read symbolic link "%s" could not remove file or directory "%s": %s
could not set junction for "%s": %s
could not stat file or directory "%s": %s
could not write to child process: %s
creating configuration files ... creating directory %s ... creating subdirectories ... fixing permissions on existing directory %s ... invalid binary "%s" ok
out of memory
pclose failed: %s performing post-bootstrap initialization ... running bootstrap script ... selecting default max_connections ... selecting default shared_buffers ... selecting default timezone ... selecting dynamic shared memory implementation ... syncing data to disk ... user does not exist user name lookup failure: error code %lu Project-Id-Version: initdb (PostgreSQL current)
Report-Msgid-Bugs-To: pgsql-bugs@postgresql.org
POT-Creation-Date: 2020-08-10 10:44+0300
PO-Revision-Date: 2021-08-14 07:49+0300
Last-Translator: Alexander Lakhin <exclusion@gmail.com>
Language-Team: Russian <pgsql-ru-general@postgresql.org>
Language: ru
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Plural-Forms: nplurals=3; plural=(n%10==1 && n%100!=11 ? 0 : n%10>=2 && n%10<=4 && (n%100<10 || n%100>=20) ? 1 : 2);
Если каталог данных не указан, используется переменная окружения PGDATA.
Редко используемые параметры:
Параметры:
Другие параметры:
Об ошибках сообщайте по адресу <pgsql-bugs@postgresql.org>.
Готово. Теперь вы можете запустить сервер баз данных:
%s%s%spg_ctl%s -D %s%s%s -l logfile start
Сохранение данных на диск пропускается.
Каталог данных может повредиться при сбое операционной системы.
ПРЕДУПРЕЖДЕНИЕ: используется проверка подлинности "trust" для локальных подключений.
Другой метод можно выбрать, отредактировав pg_hba.conf или используя ключи -A,
--auth-local или --auth-host при следующем выполнении initdb.
--auth-host=МЕТОД метод проверки подлинности по умолчанию
для локальных TCP/IP-подключений
--auth-local=МЕТОД метод проверки подлинности по умолчанию
для локальных подключений через сокет
--lc-collate=, --lc-ctype=, --lc-messages=ЛОКАЛЬ
--lc-monetary=, --lc-numeric=, --lc-time=ЛОКАЛЬ
установить соответствующий параметр локали
для новых баз (вместо значения из окружения)
--locale=ЛОКАЛЬ локаль по умолчанию для новых баз
--no-locale эквивалентно --locale=C
--pwfile=ФАЙЛ прочитать пароль суперпользователя из файла
%s [ПАРАМЕТР]... [КАТАЛОГ]
-?, --help показать эту справку и выйти
-A, --auth=МЕТОД метод проверки подлинности по умолчанию
для локальных подключений
-E, --encoding=КОДИРОВКА кодировка по умолчанию для новых баз
-L КАТАЛОГ расположение входных файлов
-N, --nosync не ждать завершения сохранения данных на диске
-S, --sync-only только синхронизировать с ФС каталог данных
-T, --text-search-config=КОНФИГУРАЦИЯ
конфигурация текстового поиска по умолчанию
-U, --username=ИМЯ имя суперпользователя БД
-V, --version показать версию и выйти
-W, --pwprompt запросить пароль суперпользователя
-X, --xlogdir=КАТАЛОГ расположение журнала транзакций
-d, --debug выдавать много отладочных сообщений
-k, --data-checksums включить контроль целостности страниц
-n, --noclean не очищать после ошибок
-s, --show показать внутренние установки
[-D, --pgdata=]КАТАЛОГ расположение данных этого кластера БД
%s инициализирует кластер PostgreSQL.
%s: "%s" — некорректное имя серверной кодировки
%s: ПРЕДУПРЕЖДЕНИЕ: в этой ОС нельзя создавать ограниченные маркеры
Запускать %s от имени root нельзя.
Пожалуйста, переключитесь на обычного пользователя (например,
используя "su"), который будет запускать серверный процесс.
%s: ошибка доступа к каталогу "%s": %s
%s: нет доступа к файлу "%s": %s
%s: не удалось подготовить структуры SID (код ошибки: %lu)
%s: не удалось поменять права для "%s": %s
%s: не удалось поменять права для каталога "%s": %s
%s: не удалось создать каталог "%s": %s
%s: не удалось создать ограниченный маркер (код ошибки: %lu)
%s: не удалось создать символическую ссылку "%s": %s
%s: не удалось выполнить команду "%s": %s
%s: не удалось найти подходящую кодировку для локали "%s"
%s: не удалось найти подходящую конфигурацию текстового поиска для локали "%s"
%s: не удалось синхронизировать с ФС файл "%s": %s
%s: не удалось получить код выхода от подпроцесса (код ошибки: %lu)
%s: не удалось открыть каталог "%s": %s
%s: не удалось открыть файл "%s" для чтения: %s
%s: не удалось открыть файл "%s" для записи: %s
%s: не удалось открыть файл "%s": %s
%s: не удалось открыть маркер процесса (код ошибки: %lu)
%s: не удалось перезапуститься с ограниченным маркером (код ошибки: %lu)
%s: не удалось прочитать каталог "%s": %s
%s: не удалось прочитать пароль из файла "%s": %s
%s: не удалось запустить процесс для команды "%s" (код ошибки: %lu)
%s: не удалось получить информацию о файле "%s": %s
%s: не удалось записать файл "%s": %s
%s: каталог данных "%s" не был удалён по запросу пользователя
%s: каталог "%s" существует, но он не пуст
%s: несоответствие кодировки
%s: ошибка при удалении содержимого каталога данных
%s: ошибка при очистке каталога журнала транзакций
%s: ошибка при удалении каталога данных
%s: ошибка при удалении каталога журнала транзакций
%s: не удалось восстановить старую локаль "%s"
%s: файл "%s" не существует
%s: "%s" - не обычный файл
%s: входной файл "%s" не принадлежит PostgreSQL %s
Проверьте правильность установки или укажите корректный путь в параметре -L.
%s: расположение входных файлов должно задаваться абсолютным путём
%s: нераспознанный метод проверки подлинности "%s" для подключений "%s"
%s: ошибочное имя локали "%s"
%s: неверные установки локали; проверьте переменные окружения LANG и LC_*
%s: для локали "%s" требуется неподдерживаемая кодировка "%s"
%s: имя локали содержит не ASCII-символы, пропущено: "%s"
%s: слишком длинное имя локали, пропущено: "%s"
%s: для применения метода %s необходимо указать пароль суперпользователя
%s: каталог данных не определён.
Вы должны указать, где будут располагаться данные этой СУБД.
Это можно сделать, добавив ключ -D или установив переменную
окружения PGDATA.
%s: нехватка памяти
%s: файл пароля "%s" пуст
%s: нельзя одновременно запросить пароль и прочитать пароль из файла
%s: удаление содержимого каталога данных "%s"
%s: очистка каталога журнала транзакций "%s"
%s: удаление каталога данных "%s"
%s: удаление каталога журнала транзакций "%s"
%s: ошибка в setlocale()
%s: имя "%s" для суперпользователя не допускается; имена ролей не могут начинаться с "pg_"
%s: символические ссылки не поддерживаются в этой ОС
%s: слишком много аргументов командной строки (первый: "%s")
%s: каталог журнала транзакций "%s" не был удалён по запросу пользователя
%s: расположение каталога журнала транзакций должно определяться абсолютным путём
%s: внимание: указанная конфигурация текстового поиска "%s" может не соответствовать локали "%s"
%s: внимание: для локали "%s" нет известной конфигурации текстового поиска
Контроль целостности страниц данных отключён.
Контроль целостности страниц данных включён.
Кодировка "%s", подразумеваемая локалью, не годится для сервера.
Вместо неё в качестве кодировки БД по умолчанию будет выбрана "%s".
Кодировка "%s" недопустима в качестве кодировки сервера.
Перезапустите %s, выбрав другую локаль.
Повторите его: Введите новый пароль суперпользователя: Если вы хотите создать новую систему баз данных,
удалите или очистите каталог "%s",
либо при запуске %s в качестве пути укажите не "%s".
Если вы хотите хранить журнал транзакций здесь,
удалите или очистите каталог "%s".
Он содержит файл с точкой (невидимый), возможно это точка монтирования.
Он содержит подкаталог lost+found, возможно это точка монтирования.
Пригодные локали в системе не найдены.
Пароли не совпадают.
Перезапустите %s с параметром -E.
Программа запущена в режиме отладки.
Программа запущена в режим 'noclean' - очистки и исправления ошибок не будет.
Кластер баз данных будет инициализирован с локалью "%s".
Кластер баз данных будет инициализирован со следующими параметрами локали:
COLLATE: %s
CTYPE: %s
MESSAGES: %s
MONETARY: %s
NUMERIC: %s
TIME: %s
Кодировка БД по умолчанию, выбранная в соответствии с настройками: "%s".
Выбрана конфигурация текстового поиска по умолчанию "%s".
Выбранная вами кодировка (%s) не совпадает с кодировкой
локали (%s). Это может привести к неправильной работе
различных функций обработки текстовых строк.
Для исправления перезапустите %s, не указывая кодировку явно,
либо выберите подходящее сочетание параметров локализации.
Файлы, относящиеся к этой СУБД, будут принадлежать пользователю "%s".
От его имени также будет запускаться процесс сервера.
Программа "postgres" нужна для %s, но она не найдена
в каталоге "%s".
Проверьте правильность установки СУБД.
Программа "postgres" найдена программой "%s",
но её версия отличается от версии %s.
Проверьте правильность установки СУБД.
Это означает, что ваша установка PostgreSQL испорчена или в параметре -L
задан неправильный каталог.
Для дополнительной информации попробуйте "%s --help".
Использование:
Добавьте параметр "--debug", чтобы узнать подробности.
Использовать в качестве каталога данных точку монтирования не рекомендуется.
Создайте в монтируемом ресурсе подкаталог и используйте его.
попытка дублирования нулевого указателя (внутренняя ошибка)
получен сигнал
дочерний процесс завершился с кодом возврата %d дочерний процесс завершился с нераспознанным состоянием %d дочерний процесс прерван исключением 0x%X дочерний процесс завершён по сигналу %d: %s неисполняемая команда команда не найдена не удалось перейти в каталог "%s": %s не удалось закрыть каталог "%s": %s
не удалось найти запускаемый файл "%s" не удалось получить связь для каталога "%s": %s
не удалось определить текущий каталог: %s выяснить эффективный идентификатор пользователя (%ld) не удалось: %s не удалось открыть каталог "%s": %s
не удалось прочитать исполняемый файл "%s" не удалось прочитать каталог "%s": %s
не удалось прочитать символическую ссылку "%s" ошибка при удалении файла или каталога "%s": %s
не удалось создать связь для каталога "%s": %s
не удалось получить информацию о файле или каталоге "%s": %s
не удалось записать в поток дочернего процесса: %s
создание конфигурационных файлов... создание каталога %s... создание подкаталогов... исправление прав для существующего каталога %s... неверный исполняемый файл "%s" ок
нехватка памяти
ошибка pclose: %s выполняется заключительная инициализация... выполняется подготовительный скрипт... выбирается значение max_connections по умолчанию... выбирается значение shared_buffers по умолчанию... выбирается часовой пояс по умолчанию... выбирается реализация динамической разделяемой памяти... сохранение данных на диске... пользователь не существует распознать имя пользователя не удалось (код ошибки: %lu) locale/ru/LC_MESSAGES/pg_basebackup-9.6.mo 0000644 00000107461 14751153420 0013666 0 ustar 00 �� � �
` a { � � ! �
� - � X T l R � ` I u D � 3 K J < � j � > > N } @ � 3
Y A > � 1 � j < w ? � M � k B J � Y � + S 0 B � B � * 6 8 a � � 5 ) � _ r � o Z 1 � 3 � K 0 - | F � \ � P N 2 � 4 � 8 @ 1 G 4 y 1 � . � @ 1 P E � B � 7 ! C! ]! & }! ; �! ( �! # " - -" ' [" " �" �" 2 �" , �" + '# . S# ( �# # �# 5 �# f $ , l$ 9 �$ 4 �$ 7 % = @% d ~% A �% " %& & H& & o& # �& / �& > �& a )' & �' & �' % �' 2 �' 1 2( 0 d( 8 �( ( �( 2 �( *) & K) ' r) . �) + �) # �) A * 2 [* & �* & �* / �* + + 4 8+ / m+ ! �+ 1 �+ ) �+ ( , 2 D, 2 w, 3 �, 0 �, % - # 5- + Y- �- �- 2 �- # �- . , (. , U. # �. i �. i / ? z/ 9 �/ " �/ A 0 # Y0 }0 9 �0 �0 �0 !
1 D /1 & t1 # �1 A �1 - 2 D /2 ! t2 �2 �2 " �2 �2 9 3 1 C3 D u3 , �3 �3 ' �3 D "4 M g4 : �4 8 �4 6 )5 `5 E y5 G �5 z 6 c �6 % �6 . 7 2 ;7 6 n7 # �7 �7 % �7 0 8 R 98 , �8 4 �8 K �8 @ :9 > {9 - �9 , �9 ' : , =: o j: k �: 4 F; % {; ( �; ; �;
< & < 8< / @< p< / < �< A �> , �> "? 0 C? < t? �? W �? � @ �@ � *A � �A s IB � �B NC N jC ~ �C r 8D � �D k UE � �E � WF P �F p *G ] �G i �G � cH � YI E �I q ,J � �J j cK � �K C gL C �L q �L k aM \ �M b *N � �N G yO � �O � �P � yQ P 0R B �R m �R 9 2S � lS � >T � 1U f V ` yV p �V KW e RW c �W l X O �X � �X U dY ` �Y ] Z N yZ 9 �Z a [ J d[ v �[ = &\ 8 d\ F �\ ? �\ 9 $] C ^] U �] I �] Z B^ F �^ ? �^ 9 $_ _ ^_ � �_ X Y` ` �` b a b va ] �a � 7b � �b S kc b �c I "d ] ld u �d � @e � �e u uf ? �f H +g b tg ] �g a 5h { �h R i j fi @ �i C j R Vj O �j M �j E Gk o �k n �k K ll F �l U �l P Um Y �m b n U cn a �n M o I io H �o S �o d Pp H �p ; �p : :q F uq : �q �q m r : r 3 �r I �r Z 8s > �s � �s � t � ,u v �u K Av � �v 6 w N Mw ` �w 0 �w # .x T Rx � �x H _y M �y } �y t tz � �z 0 }{ , �{ �{ 4 �{ , 0| l ]| s �| � >} ] �} " 2~ Z U~ � �~ � 1 � � Z F� z �� ! � � >� z �� � :� � � L Ń W � h j� O ӄ > #� & b� V �� _ � � @� V �� h R� � �� � K� s � b X� c �� E � K e� � �� � ~� K c� D �� G � s <� �� [ �� � p 8� �� h Ȏ � * � � o C $ e 7 ] � j @ � � � � f � - R � � � � O = � s � F } 2 M � p c { < N 8 � � � ) B + Y � � � � � z & T k h � I H K ~ � t w X v � � � : � > � � . / � 5 � U � � � � � _ � � 6 [ E
Z � S J , � � d # x � � Q y A P � � i � � u ^ � ? � � V
� 0 n � ( � � \ ; � � r � � � � 4 � g � " � 3 1 � D m l 9 a � � b G q � % W � � � � ! � � | ` L � � � ' �
Action to be performed:
Connection options:
General options:
Optional actions:
Options controlling the output:
Options:
Report bugs to <pgsql-bugs@postgresql.org>.
--create-slot create a new replication slot (for the slot's name see --slot)
--drop-slot drop the replication slot (for the slot's name see --slot)
--if-not-exists do not error if slot already exists when creating a slot
--start start streaming in a replication slot (for the slot's name see --slot)
--synchronous flush transaction log immediately after writing
--xlogdir=XLOGDIR location for the transaction log directory
%s [OPTION]...
-?, --help show this help, then exit
-D, --directory=DIR receive transaction log files into this directory
-D, --pgdata=DIRECTORY receive base backup into directory
-F --fsync-interval=SECS
time between fsyncs to the output file (default: %d)
-F, --format=p|t output format (plain (default), tar)
-I, --startpos=LSN where in an existing slot should the streaming start
-P, --plugin=PLUGIN use output plugin PLUGIN (default: %s)
-P, --progress show progress information
-R, --write-recovery-conf
write recovery.conf for replication
-S, --slot=SLOTNAME name of the logical replication slot
-S, --slot=SLOTNAME replication slot to use
-T, --tablespace-mapping=OLDDIR=NEWDIR
relocate tablespace in OLDDIR to NEWDIR
-U, --username=NAME connect as specified database user
-V, --version output version information, then exit
-W, --password force password prompt (should happen automatically)
-X, --xlog-method=fetch|stream
include required WAL files with specified method
-Z, --compress=0-9 compress tar output with given compression level
-c, --checkpoint=fast|spread
set fast or spread checkpointing
-d, --dbname=CONNSTR connection string
-d, --dbname=DBNAME database to connect to
-f, --file=FILE receive log into this file, - for stdout
-h, --host=HOSTNAME database server host or socket directory
-l, --label=LABEL set backup label
-n, --no-loop do not loop on connection lost
-o, --option=NAME[=VALUE]
pass option NAME with optional value VALUE to the
output plugin
-p, --port=PORT database server port number
-r, --max-rate=RATE maximum transfer rate to transfer data directory
(in kB/s, or use suffix "k" or "M")
-s, --status-interval=INTERVAL
time between status packets sent to server (in seconds)
-s, --status-interval=SECS
time between status packets sent to server (default: %d)
-v, --verbose output verbose messages
-w, --no-password never prompt for password
-x, --xlog include required WAL files in backup (fetch mode)
-z, --gzip compress tar output
%*s/%s kB (%d%%), %d/%d tablespace %*s/%s kB (%d%%), %d/%d tablespaces %*s/%s kB (%d%%), %d/%d tablespace (%s%-*.*s) %*s/%s kB (%d%%), %d/%d tablespaces (%s%-*.*s) %*s/%s kB (100%%), %d/%d tablespace %*s %*s/%s kB (100%%), %d/%d tablespaces %*s %s controls PostgreSQL logical decoding streams.
%s receives PostgreSQL streaming transaction logs.
%s takes a base backup of a running PostgreSQL server.
%s: %s %s: %s needs a slot to be specified using --slot
%s: COPY stream ended before last file was finished
%s: WAL streaming can only be used in plain mode
%s: at least one action needs to be specified
%s: can only write single tablespace to stdout, database has %d
%s: cannot specify both --xlog and --xlog-method
%s: cannot use --create-slot or --drop-slot together with --startpos
%s: cannot use --create-slot or --start together with --drop-slot
%s: cannot use --create-slot together with --drop-slot
%s: checkpoint completed
%s: child %d died, expected %d
%s: child thread exited with error %u
%s: confirming write up to %X/%X, flush to %X/%X (slot %s)
%s: could not access directory "%s": %s
%s: could not clear search_path: %s %s: could not close compressed file "%s": %s
%s: could not close directory "%s": %s
%s: could not close file "%s": %s
%s: could not connect to server
%s: could not create archive status file "%s": %s
%s: could not create background process: %s
%s: could not create background thread: %s
%s: could not create compressed file "%s": %s
%s: could not create directory "%s": %s
%s: could not create file "%s": %s
%s: could not create pipe for background process: %s
%s: could not create replication slot "%s": got %d rows and %d fields, expected %d rows and %d fields
%s: could not create symbolic link "%s": %s
%s: could not create symbolic link from "%s" to "%s": %s
%s: could not create timeline history file "%s": %s
%s: could not determine seek position in file "%s": %s
%s: could not determine server setting for integer_datetimes
%s: could not drop replication slot "%s": got %d rows and %d fields, expected %d rows and %d fields
%s: could not establish database-specific replication connection
%s: could not fsync file "%s": %s
%s: could not fsync log file "%s": %s
%s: could not get COPY data stream: %s %s: could not get backup header: %s %s: could not get child thread exit status: %s
%s: could not get transaction log end position from server: %s %s: could not identify system: got %d rows and %d fields, expected %d rows and %d or more fields
%s: could not initiate base backup: %s %s: could not open directory "%s": %s
%s: could not open log file "%s": %s
%s: could not open timeline history file "%s": %s
%s: could not open transaction log file "%s": %s
%s: could not pad transaction log file "%s": %s
%s: could not parse next timeline's starting point "%s"
%s: could not parse start position "%s"
%s: could not parse transaction log location "%s"
%s: could not read COPY data: %s %s: could not read directory "%s": %s
%s: could not read from ready pipe: %s
%s: could not receive data from WAL stream: %s %s: could not rename file "%s" to "%s": %s
%s: could not rename file "%s": %s
%s: could not seek to beginning of transaction log file "%s": %s
%s: could not send command to background pipe: %s
%s: could not send copy-end packet: %s %s: could not send feedback packet: %s %s: could not send replication command "%s": %s %s: could not set compression level %d: %s
%s: could not set permissions on directory "%s": %s
%s: could not set permissions on file "%s": %s
%s: could not stat file "%s": %s
%s: could not stat transaction log file "%s": %s
%s: could not wait for child process: %s
%s: could not wait for child thread: %s
%s: could not write %u bytes to WAL file "%s": %s
%s: could not write %u bytes to log file "%s": %s
%s: could not write timeline history file "%s": %s
%s: could not write to compressed file "%s": %s
%s: could not write to file "%s": %s
%s: creating replication slot "%s"
%s: directory "%s" exists but is not empty
%s: directory name too long
%s: disconnected
%s: disconnected; waiting %d seconds to try again
%s: dropping replication slot "%s"
%s: final receive failed: %s %s: finished segment at %X/%X (timeline %u)
%s: got WAL data offset %08x, expected %08x
%s: incompatible server version %s
%s: incompatible server version %s; client does not support streaming from server versions newer than %s
%s: incompatible server version %s; client does not support streaming from server versions older than %s
%s: initiating base backup, waiting for checkpoint to complete
%s: integer_datetimes compile flag does not match server
%s: invalid --max-rate unit: "%s"
%s: invalid checkpoint argument "%s", must be "fast" or "spread"
%s: invalid compression level "%s"
%s: invalid fsync interval "%s"
%s: invalid output format "%s", must be "plain" or "tar"
%s: invalid port number "%s"
%s: invalid socket: %s %s: invalid status interval "%s"
%s: invalid tablespace mapping format "%s", must be "OLDDIR=NEWDIR"
%s: invalid tar block header size: %d
%s: invalid transfer rate "%s": %s
%s: invalid xlog-method option "%s", must be "fetch" or "stream"
%s: multiple "=" signs in tablespace mapping
%s: new directory is not an absolute path in tablespace mapping: %s
%s: no data returned from server
%s: no database specified
%s: no slot specified
%s: no target directory specified
%s: no target file specified
%s: no transaction log end position returned from server
%s: not renaming "%s%s", segment is not complete
%s: old directory is not an absolute path in tablespace mapping: %s
%s: only tar mode backups can be compressed
%s: out of memory
%s: received interrupt signal, exiting
%s: received transaction log record for offset %u with no file open
%s: replication connection using slot "%s" is unexpectedly database specific
%s: replication slots can only be used with WAL streaming
%s: replication stream was terminated before stop point
%s: segment file "%s" has incorrect size %d, skipping
%s: select() failed: %s
%s: server reported unexpected history file name for timeline %u: %s
%s: server reported unexpected next timeline %u, following timeline %u
%s: server returned unexpected response to BASE_BACKUP command; got %d rows and %d fields, expected %d rows and %d fields
%s: server stopped streaming timeline %u at %X/%X, but reported next timeline %u to begin at %X/%X
%s: starting background WAL receiver
%s: starting log streaming at %X/%X (slot %s)
%s: starting log streaming at %X/%X (timeline %u)
%s: starting timeline %u is not present in the server
%s: streaming header too small: %d
%s: streaming initiated
%s: switched to timeline %u at %X/%X
%s: symlinks are not supported on this platform
%s: system identifier does not match between base backup and streaming connection
%s: this build does not support compression
%s: too many command-line arguments (first is "%s")
%s: transaction log directory location can only be specified in plain mode
%s: transaction log directory location must be an absolute path
%s: transaction log file "%s" has %d bytes, should be 0 or %d
%s: transfer rate "%s" exceeds integer range
%s: transfer rate "%s" is not a valid value
%s: transfer rate "%s" is out of range
%s: transfer rate must be greater than zero
%s: unexpected response to TIMELINE_HISTORY command: got %d rows and %d fields, expected %d rows and %d fields
%s: unexpected result set after end-of-timeline: got %d rows and %d fields, expected %d rows and %d fields
%s: unexpected termination of replication stream: %s %s: unrecognized link indicator "%c"
%s: unrecognized streaming header: "%c"
%s: waiting for background process to finish streaming ...
Password: Try "%s --help" for more information.
Usage:
cannot duplicate null pointer (internal error)
out of memory
transaction log start point: %s on timeline %u
Project-Id-Version: pg_basebackup (PostgreSQL current)
Report-Msgid-Bugs-To: pgsql-bugs@postgresql.org
POT-Creation-Date: 2020-11-09 07:37+0300
PO-Revision-Date: 2021-08-14 07:50+0300
Last-Translator: Alexander Lakhin <exclusion@gmail.com>
Language-Team: Russian <pgsql-ru-general@postgresql.org>
Language: ru
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Plural-Forms: nplurals=3; plural=n%10==1 && n%100!=11 ? 0 : n%10>=2 && n%10<=4 && (n%100<10 || n%100>=20) ? 1 : 2;
Действие, которое будет выполнено:
Параметры подключения:
Общие параметры:
Дополнительные действия:
Параметры, управляющие выводом:
Параметры:
Об ошибках сообщайте по адресу <pgsql-bugs@postgresql.org>.
--create-slot создать новый слот репликации (имя слота задаёт параметр --slot)
--drop-slot удалить слот репликации (имя слота задаёт параметр --slot)
--if-not-exists не выдавать ошибку при попытке создать уже существующий слот
--start начать передачу в слоте репликации (имя слота задаёт параметр --slot)
--synchronous сбрасывать журнал транзакций сразу после записи
--xlogdir=КАТАЛОГ_XLOG
расположение каталога с журналом транзакций
%s [ПАРАМЕТР]...
-?, --help показать эту справку и выйти
-D, --directory=ПУТЬ сохранять файлы журнала транзакций в данный каталог
-D, --pgdata=КАТАЛОГ сохранить базовую копию в указанный каталог
-F --fsync-interval=СЕК
периодичность сброса на диск выходного файла (по умолчанию: %d)
-F, --format=p|t формат вывода (p (по умолчанию) - простой, t - tar)
-I, --startpos=LSN определяет, с какой позиции в существующем слоте начнётся передача
-P, --plugin=МОДУЛЬ использовать заданный модуль вывода (по умолчанию: %s)
-P, --progress показывать прогресс операции
-R, --write-recovery-conf
записать recovery.conf для репликации
-S, --slot=ИМЯ_СЛОТА имя слота логической репликации
-S, --slot=ИМЯ_СЛОТА использовать заданный слот репликации
-T, --tablespace-mapping=СТАРЫЙ_КАТАЛОГ=НОВЫЙ_КАТАЛОГ
перенести табличное пространство из старого каталога
в новый
-U, --username=NAME connect as specified database user
-U, --username=ИМЯ имя пользователя баз данных
-V, --version показать версию и выйти
-W, --password запрашивать пароль всегда (обычно не требуется)
-X, --xlog-method=fetch|stream
включить в копию требуемые файлы WAL, используя
заданный метод
-Z, --compress=0-9 установить уровень сжатия выходного архива
-c, --checkpoint=fast|spread
режим быстрых или распределённых контрольных точек
-d, --dbname=СТРОКА строка подключения
-d, --dbname=ИМЯ_БД целевая база данных
-f, --file=ФАЙЛ сохранять журнал в этот файл, - обозначает stdout
-h, --host=ИМЯ имя сервера баз данных или каталог сокетов
-l, --label=МЕТКА установить метку резервной копии
-n, --no-loop прерывать работу при потере соединения
-o, --option=ИМЯ[=ЗНАЧЕНИЕ]
передать параметр с заданным именем и необязательным
значением модулю вывода
-p, --port=ПОРТ номер порта сервера БД
-r, --max-rate=СКОРОСТЬ макс. скорость передачи данных в целевой каталог
(в КБ/с, либо добавьте суффикс "k" или "M")
-s, --status-interval=ИНТЕРВАЛ
интервал между передаваемыми серверу
пакетами состояния (в секундах)
-s, --status-interval=СЕК
интервал между отправкой статусных пакетов серверу (по умолчанию: %d)
-v, --verbose выводить подробные сообщения
-w, --no-password не запрашивать пароль
-x, --xlog включить в копию требуемые файлы WAL (режим fetch)
-z, --gzip сжать выходной tar
%*s/%s КБ (%d%%), табличное пространство %d/%d %*s/%s КБ (%d%%), табличное пространство %d/%d %*s/%s КБ (%d%%), табличное пространство %d/%d %*s/%s КБ (%d%%), табличное пространство %d/%d (%s%-*.*s) %*s/%s КБ (%d%%), табличное пространство %d/%d (%s%-*.*s) %*s/%s КБ (%d%%), табличное пространство %d/%d (%s%-*.*s) %*s/%s КБ (100%%), табличное пространство %d/%d %*s %*s/%s КБ (100%%), табличное пространство %d/%d %*s %*s/%s КБ (100%%), табличное пространство %d/%d %*s %s управляет потоками логического декодирования PostgreSQL.
%s получает транслируемые журналы транзакций PostgreSQL.
%s делает базовую резервную копию работающего сервера PostgreSQL.
%s: %s %s: для %s необходимо задать слот с помощью параметра --slot
%s: поток COPY закончился до завершения последнего файла
%s: потоковая передача WAL поддерживается только в режиме plain
%s: необходимо задать минимум одно действие
%s: в stdout можно вывести только одно табличное пространство, всего в СУБД их %d
%s: указать и --xlog, и --xlog-method одновременно нельзя
%s: --create-slot или --drop-slot нельзя применять вместе с --startpos
%s: --create-slot или --start нельзя применять вместе с --drop-slot
%s: --create-slot нельзя применять вместе с --drop-slot
%s: контрольная точка завершена
%s: завершился дочерний процесс %d вместо ожидаемого %d
%s: дочерний поток завершился с ошибкой %u
%s: подтверждается запись до %X/%X, синхронизация с ФС до %X/%X (слот %s)
%s: ошибка доступа к каталогу "%s": %s
%s: не удалось очистить search_path: %s %s: не удалось закрыть сжатый файл "%s": %s
%s: не удалось закрыть каталог "%s": %s
%s: не удалось закрыть файл "%s": %s
%s: не удалось подключиться к серверу
%s: не удалось создать файл статуса архива "%s": %s
%s: не удалось создать фоновый процесс: %s
%s: не удалось создать фоновый поток выполнения: %s
%s: не удалось создать сжатый файл "%s": %s
%s: не удалось создать каталог "%s": %s
%s: не удалось создать файл "%s": %s
%s: не удалось создать канал для фонового процесса: %s
%s: создать слот репликации "%s" не удалось; получено строк: %d, полей: %d (ожидалось: %d и %d)
%s: не удалось создать символическую ссылку "%s": %s
%s: не удалось создать символическую ссылку "%s" в "%s": %s
%s: не удалось создать файл истории линии времени "%s": %s
%s: не удалось определить текущую позицию в файле "%s": %s
%s: не удалось получить настройку сервера integer_datetimes
%s: удалить слот репликации "%s" не получилось; получено строк: %d, полей: %d (ожидалось: %d и %d)
%s: не удалось установить подключение для репликации к определённой базе данных
%s: не удалось синхронизировать с ФС файл "%s": %s
%s: не удалось синхронизировать с ФС файл журнала "%s": %s
%s: не удалось получить поток данных COPY: %s %s: не удалось получить заголовок резервной копии: %s %s: не удалось получить состояние завершения дочернего потока: %s
%s: не удалось получить от сервера конечную позицию в журнале транзакций: %s %s: не удалось идентифицировать систему; получено строк: %d, полей: %d (ожидалось: %d и %d (или более))
%s: не удалось инициализировать базовое резервное копирование: %s %s: не удалось открыть каталог "%s": %s
%s: не удалось открыть файл журнала "%s": %s
%s: не удалось открыть файл истории линии времени "%s": %s
%s: не удалось открыть файл журнала транзакций "%s": %s
%s: не удалось дополнить файл журнала транзакций "%s": %s
%s: не удалось разобрать начальную точку следующей линии времени "%s"
%s: не удалось разобрать начальную позицию "%s"
%s: не удалось разобрать положение в журнале транзакций "%s"
%s: не удалось прочитать данные COPY: %s %s: не удалось прочитать каталог "%s": %s
%s: не удалось прочитать из готового канала: %s
%s: не удалось получить данные из потока WAL: %s %s: не удалось переименовать файл "%s" в "%s": %s
%s: не удалось переименовать файл "%s": %s
%s: не удалось перейти к началу файла журнала транзакций "%s": %s
%s: не удалось отправить команду в канал фонового процесса: %s
%s: не удалось отправить пакет "конец COPY": %s %s: не удалось отправить пакет ответа: %s %s: не удалось передать команду репликации "%s": %s %s: не удалось установить уровень сжатия %d: %s
%s: не удалось установить права для каталога "%s": %s
%s: не удалось установить права доступа для файла "%s": %s
%s: не удалось получить информацию о файле "%s": %s
%s: не удалось проверить файл журнала транзакций "%s": %s
%s: сбой при ожидании дочернего процесса: %s
%s: сбой при ожидании дочернего потока: %s
%s: не удалось записать %u Б в файл WAL "%s": %s
%s: не удалось записать %u Б в файл журнала "%s": %s
%s: не удалось записать файл истории линии времени "%s": %s
%s: не удалось записать сжатый файл "%s": %s
%s: не удалось записать файл "%s": %s
%s: создание слота репликации "%s"
%s: каталог "%s" существует, но он не пуст
%s: слишком длинное имя каталога
%s: отключение
%s: отключение; через %d сек. последует повторное подключение
%s: удаление слота репликации "%s"
%s: ошибка в конце передачи: %s %s: завершён сегмент %X/%X (линия времени %u)
%s: получено смещение данных WAL %08x, но ожидалось %08x
%s: несовместимая версия сервера %s
%s: несовместимая версия сервера %s; клиент не поддерживает репликацию с серверов версии выше %s
%s: несовместимая версия сервера %s; клиент не поддерживает репликацию с серверов версии ниже %s
%s: начинается базовое резервное копирование, ожидается завершение контрольной точки
%s: флаг компиляции integer_datetimes не соответствует настройке сервера
%s: неверная единица измерения в --max-rate: "%s"
%s: неверный аргумент режима контрольных точек "%s", должен быть "fast" или "spread"
%s: неверный уровень сжатия "%s"
%s: неверный интервал синхронизации с ФС "%s"
%s: неверный формат вывода "%s", должен быть "plain" или "tar"
%s: неверный номер порта "%s"
%s: неверный сокет: %s %s: неверный интервал сообщений о состоянии "%s"
%s: сопоставление табл. пространства записано неверно: "%s"; должно быть "СТАРЫЙ_КАТАЛОГ=НОВЫЙ_КАТАЛОГ"
%s: неверный размер заголовка блока tar: %d
%s: неверная скорость передачи данных "%s": %s
%s: неверный аргумент для xlog-method - "%s", допускается только "fetch" или "stream"
%s: несколько знаков "=" в сопоставлении табличного пространства
%s: новый каталог в сопоставлении табл. пространства задан не абсолютным путём: %s
%s: сервер не вернул данные
%s: база данных не задана
%s: слот не указан
%s: целевой каталог не указан
%s: целевой файл не задан
%s: сервер не передал конечную позицию в журнале транзакций
%s: файл "%s%s" не переименовывается, так как это не полный сегмент
%s: старый каталог в сопоставлении табл. пространства задан не абсолютным путём: %s
%s: сжимать можно только резервные копии в архиве tar
%s: нехватка памяти
%s: получен сигнал прерывания, работа завершается
%s: получена запись журнала транзакций по смещению %u, но файл не открыт
%s: подключение для репликации через слот "%s" оказалось привязано к базе данных
%s: слоты репликации можно использовать только при потоковой передаче WAL
%s: поток репликации закончился до точки останова
%s: файл сегмента "%s" имеет неправильный размер %d, файл пропускается
%s: ошибка в select(): %s
%s: сервер сообщил неожиданное имя файла истории для линии времени %u: %s
%s: сервер неожиданно сообщил линию времени %u после линии времени %u
%s: сервер вернул неожиданный ответ на команду BASE_BACKUP; получено строк: %d, полей: %d, а ожидалось строк: %d, полей: %d
%s: сервер прекратил передачу линии времени %u в %X/%X, но сообщил, что следующая линии времени %u начнётся в %X/%X
%s: запуск фонового процесса считывания WAL
%s: начало передачи журнала с позиции %X/%X (слот %s)
%s: начало передачи журнала с позиции %X/%X (линия времени %u)
%s: на сервере нет начальной линии времени %u
%s: заголовок потока слишком мал: %d
%s: передача запущена
%s: переключение на линию времени %u (позиция %X/%X)
%s: символические ссылки не поддерживаются в этой ОС
%s: системный идентификатор базовой резервной копии отличается от идентификатора потоковой передачи
%s: эта сборка программы не поддерживает сжатие
%s: слишком много аргументов командной строки (первый: "%s")
%s: расположение каталога журнала транзакций можно указать только в режиме plain
%s: расположение каталога журнала транзакций должно определяться абсолютным путём
%s: файл журнала транзакций "%s" имеет размер %d Б, а должен - 0 или %d
%s: скорость передачи "%s" вне целочисленного диапазона
%s: неверное значение ("%s") для скорости передачи данных
%s: скорость передачи "%s" вне диапазона
%s: скорость передачи должна быть больше 0
%s: сервер вернул неожиданный ответ на команду TIMELINE_HISTORY; получено строк: %d, полей: %d, а ожидалось строк: %d, полей: %d
%s: сервер вернул неожиданный набор данных после конца линии времени; получено строк: %d, полей: %d, а ожидалось строк: %d, полей: %d
%s: неожиданный конец потока репликации: %s %s: нераспознанный индикатор связи "%c"
%s: нераспознанный заголовок потока: "%c"
%s: ожидание завершения потоковой передачи фоновым процессом...
Пароль: Для дополнительной информации попробуйте "%s --help".
Использование:
попытка дублирования нулевого указателя (внутренняя ошибка)
нехватка памяти
стартовая точка журнала транзакций: %s на линии времени %u
locale/ru/LC_MESSAGES/ecpglib6-9.6.mo 0000644 00000011026 14751153420 0012562 0 ustar 00 �� ! $ / , � � � � ) ' - Q : 0 � $ � ( 9 L * c ; � > � 3 < = & z 1 � � + � ' @ % Y � , � � 2 0 ; / l � � � � � & � � G � S C
� �
L ' = t O � , " N O l � p
Z |
h �
9 @ j z % � I D U / � 9 � @ A E Y � ? � Q ! M s T �
! <DEFAULT> <empty> NULL SQL error %d on line %d SQL error: %s
connection "%s" does not exist on line %d could not connect to database "%s" on line %d could not convert boolean value: size mismatch, on line %d data read from server is not an array on line %d descriptor "%s" not found on line %d descriptor index out of range on line %d empty message text empty query on line %d error in transaction processing on line %d inserting an array of variables is not supported on line %d invalid input syntax for floating-point type: "%s", on line %d invalid input syntax for type int: "%s", on line %d invalid input syntax for type unsigned int: "%s", on line %d invalid statement name "%s" on line %d invalid syntax for type boolean: "%s", on line %d no data found on line %d not connected to connection "%s" on line %d null value without indicator on line %d out of memory on line %d the connection to the server was lost too few arguments on line %d too many arguments on line %d unrecognized descriptor item "%s" on line %d unsupported type "%s" on line %d variable does not have a character type on line %d variable does not have a numeric type on line %d variable does not have an array type on line %d Project-Id-Version: ecpglib (PostgreSQL current)
Report-Msgid-Bugs-To: pgsql-bugs@postgresql.org
POT-Creation-Date: 2021-09-13 07:59+0300
PO-Revision-Date: 2016-09-20 12:00+0300
Last-Translator: Alexander Lakhin <exclusion@gmail.com>
Language-Team: Russian <pgsql-ru-general@postgresql.org>
Language: ru
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Plural-Forms: nplurals=3; plural=(n%10==1 && n%100!=11 ? 0 : n%10>=2 && n%10<=4 && (n%100<10 || n%100>=20) ? 1 : 2);
<ПО_УМОЛЧАНИЮ> <> NULL SQL-ошибка %d в строке %d ошибка SQL: %s
подключение "%s" не существует (строка %d) ошибка подключения к базе данных "%s" (строка %d) не удалось преобразовать логическое значение: несовпадение размера (строка %d) полученные с сервера данные - не массив (%d) дескриптор "%s" не найден (строка %d) индекс дескриптора вне диапазона (строка %d) пустое сообщение пустой запрос в строке %d ошибка при обработке транзакции в строке %d добавление массива переменных не поддерживается (строка %d) неверный синтаксис для числа с плавающей точкой: "%s" (строка %d) неверный синтаксис для целого числа: "%s" (строка %d) неверный синтаксис для беззнакового целого: "%s" (строка %d) неверный оператор "%s" в строке %d неверный синтаксис для логического значения: "%s" (строка %d) нет данных (строка %d) подключение "%s" не установлено (строка %d) значение NULL без индикатора в строке %d нехватка памяти (строка %d) подключение к серверу потеряно недостаточно аргументов в строке %d слишком много аргументов в строке %d нераспознанный элемент дескриптора "%s" (строка %d) неподдерживаемый тип "%s" в строке %d переменная должна быть символьной (строка %d) переменная должна быть числовой (строка %d) переменная должна иметь тип массива (строка %d) locale/ru/LC_MESSAGES/libpq5-9.6.mo 0000644 00000071721 14751153420 0012273 0 ustar 00 �� � l
� � �
"
8 ' F ( n � # � � � $ � 9
R 0 ] ( � ( � � � � 5 � 8 3 0 l � $ � # � - % 8 S � � . � ( � , I \ : k " � � � < � a / 0 � ) � ' � * . ? + n ' � ' � * � * + @ * l , � ) � ) � + - D / r + � ( � ) � & ! 5 H 3 ~ & � ! � � + " G v j w � r Y � ! � ' , - T � � # 9 : & t ) � * � # � 9 ) N ' x ) � � ) � " 9 5 . o ' � * � " � " ! . 7! / f! - �! @ �! 2 " ! 8" % Z" % �" & �" V �" = $# ; b# 4 �# 0 �# $ : !$ \$ |$ �$ �$ - �$ -
% ;% + W% 2 �% 7 �% = �% ! ,& . N& 8 }& " �& �& F �& C @' $ �' �' B �' ( ( ; 4( ( p( * �( & �( % �( ! ) 6 3) C j) ? �) 2 �) 1 !* = S* ) �* J �* + + 1+ N+ m+ 1 �+
�+ �+ + �+ , ) #, " M, [ p, �, ? �, 1 %- 8 W- > �- � �- # P. t. : �. � �. 2 N/ Q �/ J �/ K 0 j0 �0 �0 ? �0 ! �0 + 1 @1 Q1 L m1 D �1 % �1 . %2 C T2 �2 $ �2 5 �2 ) 3 � >3 <5 M5 P5 U5 [5 p5 �5 N �5 O �5 < C6 E �6 �6 �6 Q �6 - O7 0 }7 �7 S �7 J 8 J f8 �8 �8 �8 Z �8 ] G9 V �9 @ �9 L =: ^ �: �: �: H
; e V; �; 6 �; N < M `< F �< �< = \ (= O �= + �= > Y > � p> Z =? 2 �? : �? N @ R U@ O �@ O �@ M HA E �A E �A F "B E iB G �B D �B D <C F �C H �C J D F \D C �D D �D > ,E g kE i �E < =F G zF D �F ) G 7 1G D iG � �G � �H � TI ; !J < ]J 2 �J F �J U K + jK T �L W �L P CM V �M R �M H >N e �N W �N x EO L �O 5 P P AP 9 �P e �P c 2Q H �Q S �Q E 3R I yR q �R � 5S _ �S a T M yT 7 �T = �T A =U B U N �U j V f |V q �V O UW 8 �W k �W 7 JX ? �X ? �X ? Y [ BY [ �Y & �Y V !Z b xZ j �Z n F[ E �[ X �[ u T\ / �\ < �\ q 7] n �] H ^ - a^ c �^ �^ 0 _ \ A_ J �_ ] �_ e G` O �` 7 �` } 5a � �a d 6b f �b @ c m Cc S �c � d 2 �d / �d 0 e : 8e , se H �e �e f E &f P lf @ �f 1 �f � 0g ) �g } h S �h P �h � ;i � �i : �j �j s
k � �k r el � �l � �m � /n B �n # o :o g Zo A �o q p vp ' �p o �p k q @ �q [ �q g (r 9 �r A �r _ s d ls } ) � E � f * B 0 W > � H � 6 � T � a i h 2 � � + � P � ' w < � � u 7 �
� M � � ? o l X L � � � � � � � m � � { Z g n � @ � � . � � � � 3 � R S D � � c 9 N J � j G % � � z � � � & � 4 r 1 Q � | : � � I � � � b � Y # x ; ` 8
t e � � y ( � � � � � = ^ - � � � � U V ] $ " � ~ � d � � \ _ p , k � A C [ 5 K � ! � � q s O v � � / � � � F � � at character %s %s %s, %s:%s COLUMN NAME: %s
CONSTRAINT NAME: %s
CONTEXT: %s
COPY IN state must be terminated first
COPY OUT state must be terminated first
COPY terminated by new PQexec Crypt authentication not supported
DATATYPE NAME: %s
DETAIL: %s
GSSAPI authentication not supported
GSSAPI continuation error GSSAPI name import error HINT: %s
IPv6 host address may not be empty in URI: "%s"
Kerberos 4 authentication not supported
Kerberos 5 authentication not supported
LINE %d: LOCATION: NOTICE PGEventProc "%s" failed during PGEVT_CONNRESET event
PGEventProc "%s" failed during PGEVT_RESULTCREATE event
PGresult cannot support more than INT_MAX tuples PGresult is not an error result
PQexec not allowed during COPY BOTH
PQgetline: not doing text COPY OUT
QUERY: %s
SCHEMA NAME: %s
SCM_CRED authentication method not supported
SCRAM authentication requires libpq version 10 or above
SSL SYSCALL error: %s
SSL SYSCALL error: EOF detected
SSL certificate's name contains embedded null
SSL certificate's name entry is missing
SSL connection has been closed unexpectedly
SSL error code %lu SSL error: %s
SSL library does not support CRL certificates (file "%s")
SSPI authentication not supported
SSPI continuation error TABLE NAME: %s
Unix-domain socket path "%s" is too long (maximum %d bytes)
WARNING: password file "%s" has group or world access; permissions should be u=rw (0600) or less
WARNING: password file "%s" is not a plain file
WSAIoctl(SIO_KEEPALIVE_VALS) failed: %ui
another command is already in progress
argument of lo_read exceeds integer range
argument of lo_truncate exceeds integer range
argument of lo_write exceeds integer range
attribute has no values on LDAP lookup
authentication method %u not supported
cannot determine OID of function lo_close
cannot determine OID of function lo_creat
cannot determine OID of function lo_create
cannot determine OID of function lo_lseek
cannot determine OID of function lo_lseek64
cannot determine OID of function lo_open
cannot determine OID of function lo_tell
cannot determine OID of function lo_tell64
cannot determine OID of function lo_truncate
cannot determine OID of function lo_truncate64
cannot determine OID of function lo_unlink
cannot determine OID of function loread
cannot determine OID of function lowrite
certificate could not be obtained: %s
certificate does not match private key file "%s": %s
certificate present, but not private key file "%s"
column number %d is out of range 0..%d command string is a null pointer
connection in wrong state
connection not open
connection pointer is NULL
could not acquire SSPI credentials could not connect to server: %s
Is the server running locally and accepting
connections on Unix domain socket "%s"?
could not connect to server: %s
Is the server running on host "%s" (%s) and accepting
TCP/IP connections on port %s?
could not connect to server: %s
Is the server running on host "%s" and accepting
TCP/IP connections on port %s?
could not create LDAP structure
could not create SSL context: %s
could not create socket: %s
could not establish SSL connection: %s
could not get client address from socket: %s
could not get home directory to locate root certificate file
Either provide the file or change sslmode to disable server certificate verification.
could not get peer credentials: %s
could not get server's host name from server certificate
could not get socket error status: %s
could not initialize SSL engine "%s": %s
could not interpret result from server: %s could not load SSL engine "%s": %s
could not load private SSL key "%s" from engine "%s": %s
could not load private key file "%s": %s
could not look up local user ID %d: %s
could not open certificate file "%s": %s
could not open file "%s": %s
could not read certificate file "%s": %s
could not read from file "%s": %s
could not read private SSL key "%s" from engine "%s": %s
could not read root certificate file "%s": %s
could not receive data from server: %s
could not send SSL negotiation packet: %s
could not send data to server: %s
could not send startup packet: %s
could not set socket to TCP no delay mode: %s
could not set socket to close-on-exec mode: %s
could not set socket to nonblocking mode: %s
could not translate Unix-domain socket path "%s" to address: %s
could not translate host name "%s" to address: %s
could not write to file "%s": %s
definition of service "%s" not found
duplicate GSS authentication request
duplicate SSPI authentication request
end of string reached when looking for matching "]" in IPv6 host address in URI: "%s"
expected authentication request from server, but received %c
extra key/value separator "=" in URI query parameter: "%s"
forbidden value %%00 in percent-encoded value: "%s"
function requires at least protocol version 3.0
host name must be specified
host name must be specified for a verified SSL connection
incomplete multibyte character
insufficient data in "D" message insufficient data in "T" message insufficient data in "t" message integer of size %lu not supported by pqGetInt integer of size %lu not supported by pqPutInt invalid ExecStatusType code invalid LDAP URL "%s": invalid port number
invalid LDAP URL "%s": missing distinguished name
invalid LDAP URL "%s": must have exactly one attribute
invalid LDAP URL "%s": must have search scope (base/one/sub)
invalid LDAP URL "%s": no filter
invalid LDAP URL "%s": scheme must be ldap://
invalid URI propagated to internal parser routine: "%s"
invalid URI query parameter: "%s"
invalid connection option "%s"
invalid connection state %d, probably indicative of memory corruption
invalid connection state, probably indicative of memory corruption
invalid percent-encoded token: "%s"
invalid port number: "%s"
invalid setenv state %c, probably indicative of memory corruption
invalid socket
invalid sslmode value: "%s"
invalid state %c, probably indicative of memory corruption
keepalives parameter must be an integer
length must be given for binary parameter
line %d too long in service file "%s"
local user with ID %d does not exist
lookup on LDAP server failed: %s
lost synchronization with server, resetting connection lost synchronization with server: got message type "%c", length %d
message contents do not agree with length in message type "%c"
message type 0x%02x arrived from server while idle missing "=" after "%s" in connection info string
missing key/value separator "=" in URI query parameter: "%s"
more than one entry found on LDAP lookup
nested service specifications not supported in service file "%s", line %d
no COPY in progress
no SSL error reported no connection to the server
no entry found on LDAP lookup
no error message available
number of parameters must be between 0 and 65535
out of memory out of memory
out of memory allocating GSSAPI buffer (%d) out of memory for query result parameter number %d is out of range 0..%d password retrieved from file "%s"
private key file "%s" has group or world access; permissions should be u=rw (0600) or less
protocol error: id=0x%x
query to initialize large object functions did not return data
received invalid response to SSL negotiation: %c
requirepeer parameter is not supported on this platform
requirepeer specifies "%s", but actual peer user name is "%s"
root certificate file "%s" does not exist
Either provide the file or change sslmode to disable server certificate verification.
row number %d is out of range 0..%d select() failed: %s
server certificate for "%s" does not match host name "%s"
server closed the connection unexpectedly
This probably means the server terminated abnormally
before or while processing the request.
server does not support SSL, but SSL was required
server sent binary data ("B" message) without prior row description ("T" message) server sent data ("D" message) without prior row description ("T" message) server sent data ("D" message) without prior row description ("T" message)
service file "%s" not found
setsockopt(%s) failed: %s
size_t overflow sslmode value "%s" invalid when SSL support is not compiled in
statement name is a null pointer
syntax error in service file "%s", line %d
timeout expired
unexpected asyncStatus: %d
unexpected character "%c" at position %d in URI (expected ":" or "/"): "%s"
unexpected character %c following empty query response ("I" message) unexpected field count in "D" message unexpected message from server during startup
unexpected response from server; first received character was "%c"
unrecognized SSL error code: %d
unrecognized socket error: 0x%08X/%d unterminated quoted string in connection info string
user name lookup failure: error code %lu
Project-Id-Version: libpq (PostgreSQL current)
Report-Msgid-Bugs-To: pgsql-bugs@postgresql.org
POT-Creation-Date: 2021-08-09 23:08+0300
PO-Revision-Date: 2021-05-13 09:59+0300
Last-Translator: Alexander Lakhin <exclusion@gmail.com>
Language-Team: Russian <pgsql-ru-general@postgresql.org>
Language: ru
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Plural-Forms: nplurals=3; plural=(n%10==1 && n%100!=11 ? 0 : n%10>=2 && n%10<=4 && (n%100<10 || n%100>=20) ? 1 : 2);
символ %s %s %s, %s:%s СТОЛБЕЦ: %s
ОГРАНИЧЕНИЕ: %s
КОНТЕКСТ: %s
сначала должно завершиться состояние COPY IN
сначала должно завершиться состояние COPY OUT
операция COPY прервана вызовом PQexec аутентификация Crypt не поддерживается
ТИП ДАННЫХ: %s
ПОДРОБНОСТИ: %s
аутентификация через GSSAPI не поддерживается
ошибка продолжения в GSSAPI ошибка импорта имени в GSSAPI ПОДСКАЗКА: %s
IPv6, содержащийся в URI, не может быть пустым: "%s"
аутентификация Kerberos 4 не поддерживается
аутентификация Kerberos 5 не поддерживается
СТРОКА %d: ПОЛОЖЕНИЕ: ЗАМЕЧАНИЕ ошибка в PGEventProc "%s" при обработке события PGEVT_CONNRESET
ошибка в PGEventProc "%s" при обработке события PGEVT_RESULTCREATE
PGresult не может вместить больше чем INT_MAX кортежей В PGresult не передан результат ошибки
вызов PQexec не допускается в процессе COPY BOTH
PQgetline можно вызывать только во время COPY OUT с текстом
ЗАПРОС: %s
СХЕМА: %s
аутентификация SCM_CRED не поддерживается
для аутентификации SCRAM требуется libpq версии 10 или новее
ошибка SSL SYSCALL: %s
ошибка SSL SYSCALL: конец файла (EOF)
имя в SSL-сертификате включает нулевой байт
запись имени в SSL-сертификате отсутствует
SSL-соединение было неожиданно закрыто
код ошибки SSL: %lu ошибка SSL: %s
Библиотека SSL не поддерживает проверку CRL (файл "%s")
аутентификация через SSPI не поддерживается
ошибка продолжения в SSPI ТАБЛИЦА: %s
длина пути Unix-сокета "%s" превышает предел (%d байт)
ПРЕДУПРЕЖДЕНИЕ: к файлу паролей "%s" имеют доступ все или группа; права должны быть u=rw (0600) или более ограниченные
ПРЕДУПРЕЖДЕНИЕ: файл паролей "%s" - не обычный файл
ошибка в WSAIoctl(SIO_KEEPALIVE_VALS): %ui
уже выполняется другая команда
аргумент lo_read не умещается в обычном целом
аргумент lo_truncate не умещается в обычном целом
аргумент lo_write не умещается в обычном целом
атрибут не содержит значений при поиске LDAP
метод аутентификации %u не поддерживается
не удалось определить OID функции lo_close
не удалось определить OID функции lo_creat
не удалось определить OID функции lo_create
не удалось определить OID функции lo_lseek
не удалось определить OID функции lo_lseek64
не удалось определить OID функции lo_open
не удалось определить OID функции lo_tell
не удалось определить OID функции lo_tell64
не удалось определить OID функции lo_truncate
не удалось определить OID функции lo_truncate64
не удалось определить OID функции lo_unlink
не удалось определить OID функции loread
не удалось определить OID функции lowrite
не удалось получить сертификат: %s
сертификат не соответствует файлу закрытого ключа "%s": %s
сертификат присутствует, но файла закрытого ключа "%s" нет
номер столбца %d вне диапазона 0..%d указатель на командную строку нулевой
соединение в неправильном состоянии
соединение не открыто
нулевой указатель соединения
не удалось получить удостоверение SSPI не удалось подключиться к серверу: %s
Он действительно работает локально и принимает
соединения через Unix-сокет "%s"?
не удалось подключиться к серверу: %s
Он действительно работает по адресу "%s" (%s)
и принимает TCP-соединения (порт %s)?
не удалось подключиться к серверу: %s
Он действительно работает по адресу "%s"
и принимает TCP-соединения (порт %s)?
не удалось создать структуру LDAP
не удалось создать контекст SSL: %s
не удалось создать сокет: %s
не удалось установить SSL-соединение: %s
не удалось получить адрес клиента из сокета: %s
не удалось получить домашний каталог для поиска файла корневых сертификатов
Укажите полный путь к файлу или отключите проверку сертификата сервера, изменив sslmode.
не удалось получить учётные данные сервера: %s
не удалось получить имя сервера из сертификата
не удалось получить статус ошибки сокета: %s
не удалось инициализировать модуль SSL ENGINE "%s": %s
не удалось интерпретировать ответ сервера: %s не удалось загрузить модуль SSL ENGINE "%s": %s
не удалось загрузить закрытый ключ SSL "%s" из модуля "%s": %s
не удалось загрузить файл закрытого ключа "%s": %s
найти локального пользователя по идентификатору (%d) не удалось: %s
не удалось открыть файл сертификата "%s": %s
не удалось открыть файл "%s": %s
не удалось прочитать файл сертификата "%s": %s
не удалось прочитать файл "%s": %s
не удалось прочитать закрытый ключ SSL "%s" из модуля "%s": %s
не удалось прочитать файл корневых сертификатов "%s": %s
не удалось получить данные с сервера: %s
не удалось отправить пакет согласования SSL: %s
не удалось передать данные серверу: %s
не удалось отправить стартовый пакет: %s
не удалось перевести сокет в режим TCP-передачи без задержки: %s
не удалось перевести сокет в режим закрытия при выполнении (close-on-exec): %s
не удалось перевести сокет в неблокирующий режим: %s
преобразовать путь Unix-сокета "%s" в адрес не удалось: %s
преобразовать имя "%s" в адрес не удалось: %s
не удалось записать файл "%s": %s
определение службы "%s" не найдено
повторный запрос аутентификации GSS
повторный запрос аутентификации SSPI
URI не содержит символ "]" после адреса IPv6: "%s"
ожидался запрос аутентификации от сервера, но получено: %c
лишний разделитель ключа/значения "=" в параметрах URI: "%s"
недопустимое значение %%00 для символа, закодированного с %%: "%s"
функция требует протокол минимум версии 3.0
требуется указать имя сервера
для проверенного SSL-соединения требуется указать имя узла
неполный многобайтный символ
недостаточно данных в сообщении "D" недостаточно данных в сообщении "T" недостаточно данных в сообщении "t" функция pqGetInt не поддерживает integer размером %lu байт функция pqPutInt не поддерживает integer размером %lu байт неверный код ExecStatusType некорректный адрес LDAP "%s": неверный номер порта
некорректный адрес LDAP "%s": отсутствует уникальное имя
некорректный адрес LDAP "%s": должен быть только один атрибут
некорректный адрес LDAP "%s": не указана область поиска (base/one/sub)
некорректный адрес LDAP "%s": нет фильтра
некорректный адрес LDAP "%s": схема должна быть ldap://
во внутреннюю процедуру разбора строки передан ошибочный URI: "%s"
неверный параметр в URI: "%s"
неверный параметр соединения "%s"
неверное состояние соединения %d - возможно разрушение памяти
неверное состояние соединения - возможно разрушение памяти
неверный символ, закодированный с %%: "%s"
неверный номер порта: "%s"
неверное состояние setenv %c - возможно разрушение памяти
неверный сокет
неверное значение sslmode: "%s"
неверное состояние %c - возможно разрушение памяти
параметр keepalives должен быть целым числом
для двоичного параметра должна быть указана длина
слишком длинная строка (%d) в файле определений служб "%s"
локальный пользователь с ID %d не существует
ошибка поиска на сервере LDAP: %s
потеряна синхронизация с сервером; попытка восстановить соединение потеряна синхронизация с сервером: получено сообщение типа "%c", длина %d
содержимое не соответствует длине в сообщении типа "%c"
от сервера во время простоя получено сообщение типа 0x%02x в строке соединения нет "=" после "%s"
в параметрах URI не хватает разделителя ключа/значения "=": "%s"
при поиске LDAP найдено более одного вхождения
рекурсивные определения служб не поддерживаются (файл определения служб "%s", строка %d)
операция COPY не выполняется
нет сообщения об ошибке SSL нет соединения с сервером
при поиске LDAP ничего не найдено
нет сообщения об ошибке
число параметров должно быть от 0 до 65535
нехватка памяти нехватка памяти
недостаточно памяти для буфера GSSAPI (%d) недостаточно памяти для результата запроса номер параметра %d вне диапазона 0..%d пароль получен из файла "%s"
к файлу закрытого ключа "%s" имеют доступ все или группа; права должны быть u=rw (0600) или более ограниченные
ошибка протокола: id=0x%x
запрос инициализации функций для больших объектов не вернул данные
получен неверный ответ при согласовании SSL: %c
параметр requirepeer не поддерживается в этой ОС
requirepeer допускает подключение только к "%s", но сервер работает под именем "%s"
файл корневых сертификатов "%s" не существует
Укажите полный путь к файлу или отключите проверку сертификата сервера, изменив sslmode.
номер записи %d вне диапазона 0..%d ошибка в select(): %s
серверный сертификат для "%s" не соответствует имени сервера "%s"
сервер неожиданно закрыл соединение
Скорее всего сервер прекратил работу из-за сбоя
до или в процессе выполнения запроса.
затребовано подключение через SSL, но сервер не поддерживает SSL
сервер отправил двоичные данные (сообщение "B") без предварительного описания строки (сообщение "T") сервер отправил данные (сообщение "D") без предварительного описания строки (сообщение "T") сервер отправил данные (сообщение "D") без предварительного описания строки (сообщение "T")
файл определений служб "%s" не найден
ошибка в setsockopt(%s): %s
переполнение size_t значение sslmode "%s" недопустимо для сборки без поддержки SSL
указатель на имя оператора нулевой
синтаксическая ошибка в файле определения служб "%s" (строка %d)
тайм-аут
неожиданный asyncStatus: %d
неожиданный символ "%c" в позиции %d в URI (ожидалось ":" или "/"): "%s"
неожиданный символ %c вслед за пустым ответом (сообщение "I") неверное число полей в сообщении "D" неожиданное сообщение от сервера в начале работы
неожиданный ответ сервера; первый полученный символ: "%c"
нераспознанный код ошибки SSL: %d
нераспознанная ошибка сокета: 0x%08X/%d в строке соединения не хватает закрывающей кавычки
распознать имя пользователя не удалось (код ошибки: %lu)
locale/ru/LC_MESSAGES/psql-9.6.mo 0000644 00000364240 14751153420 0012057 0 ustar 00 �� : �! � �C XZ YZ oZ �Z � �Z D[ `[
y[ �[ > �[ = �[ < \ p R\ s �\ 5 7] 7 m] K �] o �] 2 a^ 4 �^ N �^ t _ Q �_ O �_ > /` A n` O �` @ a 6 Aa 0 xa N �a G �a 8 @b A yb T �b ? c L Pc A �c @ �c H d A id + �d � �d 5 me 9 �e n �e Q Lf : �f � �f ; fg y �g � h ; �h z �h T oi A �i L j B Sj \ �j 4 �j J (k \ sk 6 �k 4 l G <l = �l ; �l ( �l ; 'm ; cm ; �m ; �m 8 n _ Pn J �n F �n ` Bo h �o G p 5 Tp 2 �p X �p Q q : hq 3 �q ; �q S r M gr 9 �r @ �r 8 0s ; is @ �s K �s J 2t | }t � �t > �u F �u N v F Uv H �v - �v $ w & 8w - _w 9 �w 7 �w 2 �w 4 2x 3 gx ) �x ) �x ; �x B +y ) ny * �y * �y J �y 1 9z . kz - �z , �z 4 �z I *{ $ t{ & �{ > �{ 1 �{ & 1| ( X| J �| : �| ( } % 0} $ V} $ {} ) �} - �} N �} 9 G~ G �~ 5 �~ M �~ C M P � K � N .� K }� L ɀ 4 � K K� ( �� q �� A 2� ? t� A �� > �� � 5� # � F � 8 O� < �� M Ņ ; � 6 O� 2 �� 7 �� B � : 4� 4 o� 9 �� ? އ % � + D� 9 p� 5 �� I � K *� M v� Z ĉ S � K s� � �� N J� @ �� : ڋ ( � B >� L �� C Ό � � M �� = � � M� � � � "� 5� 9� M� ]� 0 e� $ �� # �� * ߏ %
� * 0� [� # |� < �� ݐ �� � 6 1� h� � }� : #� ^� p� |� �� �� �� �� ̒ ޒ Q � B� I V� [ ��
�� � �
-� 8� V� C c� A �� � �� �� � � $� +� , =� j� �� �� �� �� �� �� ̕ � ��
� � � '� ' 4� \� & z� ' �� 7 ɖ 0 � 2� N� ^� q� �� �� �� �� w �� %� 6� K� Q� k� ( �� �� �� ˘ Ԙ �
� #� 8� Q� ]� f� o� �� �� �� ��
�� Ù ə ̙ ֙
ܙ � � � � � �
,� :�
L� Z� & g� �� ��
��
�� ɚ ܚ �
� � 0� D� W� i� y� �� �� �� ݛ � � � 0�
B� P� `� % q� �� " �� Μ � � )� ' ?� & g� �� �� �� �� ˝ ՝
ڝ � L � A� P� n� > �� ʞ ߞ � 2
� =� D� W� k� �� �� �� �� ȟ ߟ �� X � m� v� �� ��
�� ˠ � ' � . � ! D� ' f� �� �� ��
�� ʡ � �� � :� Z� i� z� , �� �� Ģ Т ߢ � � � !� E (� n� ~� �� �� ��
�� �� �� �� ƣ ң ޣ �� � � � $� .� B�
H� V� r�
�� �� �� �� �� ͤ � � !
� /� G� 9 b� y �� 9 � F P� 5 �� B ͦ C � 5 T� : �� 9 ŧ @ �� ; @� K |� B Ȩ C � 6 O� 8 �� �� ۩ �
�� � � (�
.� 9� U� t� �� �� �� & �� � �� � � � ,� � # � # &� # J� n� " �� �� �� Ǭ ެ � �
�� � � �
)� c 4� � �� Y� K v� Q ® / � O D� U �� 5 � = � ^� , j� 4 �� " ̰ ! � � 1� >� Y� " u� + �� + ı 6 � X '� 7 �� 8 �� T � 5 F� I |� 6 Ƴ # �� = !� = _� = �� i ۴ 9 E� � �� * �� � � � @� S� Z� ^� m� �� �� �� �� �� �� ϶ # � � &� $ ?� d�
w� �� �� �� �� �� ��
�� Ʒ > з � � (� 9� C� K� Q� C ^� �� / �� ( � � � (� :� Q� ' m� �� $ �� % ٹ ! �� ) !� ( K� / t� # �� ' Ⱥ , � . � 4 L� �� ! �� - û � % � 4 8� 1 m� - �� / ͼ " �� � ' @� h� . �� ) �� % � ! � $ )� * N� + y� A �� � � & � 0 '� . X� - �� �� % Ŀ �
�
�� � # � 3� @� R� d� p� |� �� �� �� �� C �� � #� 9� C� [� k� {� ��
�� �� $ �� & � - � # 9� ]� 1 ~� ( �� ) �� + � ' /� ! W� y� # �� ! �� ( �� � � 9� V� t� �� �� �� �� ��
�� �� �
� !� .� >� Y� y� �� �� �� �� �� � $� @� ! [� }� �� 2 �� �� �� � *� G� h� 2 �� 5 �� �� �� � . 2� a� & y� # �� �� ! �� � � 2� D� ]� 6 ~� ) �� ��
�� �� �� � � .�
;� & I� p� �� �� �� �� �� �� �� �� ��
� �
� )� U 6� �� �� �� , �� �� �� � ,� ?�
S� ^� m� y� �� �� �� �� �� " ��
�� �� �� � � '�
B� 1 P� �� ��
�� �� �� �� . �� � . $�
S� a� k� q� �� ��
�� �� E �� �
� !� 3� B� Q� X� m� u� �� �� �� * �� ��
�� � � � )� 3� 9� C�
T� _� h� r� �� �� �� �� �� �� �� �� � � � "� '� 9�
B� P� W� ^� q� z� % �� �� �� �� �� �� �� �� � � $� 3� <� F�
O� Z� d� s� � �� �� �� �� �� �� �� �� �� �� �� � � � � $� 3�
C� Q� X�
j� x� �� �� �� �� �� �� �� �� �� �� � � #� ! -� 4 O�
�� �� . �� �� �� �� �� � � � 2�
;�
I�
W� e� x� �� �� �� �� " �� �� � 0� B� ]� z� / �� �� �� �� �� " � (� H� d� �� �� * ��
�� �� �� � -� E� Y� i� |� �� 0 �� + �� � � � > %�
d� o� ) {� " �� �� ��
�� �� ��
� #� (� 2� 7� G� V� e� q� v�
}� ��
��
�� �� �� �� 7 �� 2 � 6 ?� V v� �� & �� & �� . !� P� \� l�
}�
�� �� �� �� �� �� �� �� �� � � � ! *� L� T� f� s�
�� �� �� �� �� . �� � � � )�
F� Q� a� s� � �� �� �� �� ��
�� �� �� �� �� � � � <� Z� d� h� $ �� # �� �� �� 0 �� � � 5� <� S� ( g� �� �� �� �� �� �� �� �� �� �� � � , '� T� l� �� $ �� �� ' �� � #� B� \� t� �� �� ! �� �� �� �
� � (� � ,� , )� , V� * �� �� - �� " �� � -� T L� l �� � � � �� � c� P +� ] |� } �� � X� L '� ` t� � �� � �� { z� j �� ^ a� G �� s � m |� Z �� S E� } �� r � h �� c �� � W� Y � h Z� | �� k @� ~ �� t +� H �� � � D � ] � � q� � ?� k � Q 6� Z �� � � & � l �� � b� � ;� x ( q � y � � ` 1 � � � w � [ [ _ � U S m 9 � { � S w S � Z c z � � w � } | � �
s �
o P � � � � k Z � K W
_ �
� � � G � g � Y 7 | � e | t � � � � � u J l U � X
p f � � I c K � : � K 4 f � ^ � f F ^ � I M V C � y � � b O U ` H � x � L x O � K a a Z � � 6 � < f S i � 4 $ @ Y � � c S! R �! 8
" 6 C" F z" @ �" S # � V# b �# � ?$ p �$ � 3% � �% � >& � �& � �' � 4( m �( O D) � �) ? 6* � v* { + [ �+ d �+ � \, � �, . �. | / D }/ f �/ � )0 y �0 Z `1 e �1 \ !2 e ~2 h �2 T M3 ~ �3 t !4 7 �4 < �4 ] 5 l i5 � �5 � f6 � �6 � �7 v [8 t �8 � G9 � : q �: k A; @ �; �; � n< r = z= � �> � ? � �? , �@ M �@
A $
A 2A 6A ! PA rA g zA I �A : ,B L gB L �B P C G RC 9 �C � �C ; hD " �D C �D b E 6 nE � �E @ bF �F " �F �F + �F !G 6G NG ) mG �G � �G * BH z mH � �H �I # �I �I �I 3 �I ! 3J | UJ � �J XK rK ( �K �K
�K �K " �K G L ! QL sL �L �L �L �L 1 �L . �L , $M QM jM �M �M �M / �M 9 �M - N 2 NN U �N O �N = 'O & eO ( �O I �O �O P P ! 2P � TP Q ( 7Q `Q 4 oQ 2 �Q U �Q -R GR eR ) xR = �R ) �R .
S 3 9S mS �S �S �S # �S : �S 2 %T XT mT �T �T �T �T �T �T �T �T U - )U 4 WU �U �U �U �U N �U <V EV dV & �V �V 0 �V * �V 0 %W , VW . �W ) �W $ �W X "X 4 >X 0 sX , �X ; �X
Y < )Y fY ! �Y �Y �Y �Y ! �Y : Z 6 MZ G �Z ? �Z G [ ? T[ B �[ E �[ C \ a\ E z\ �\
�\ �\ �\ ] ] 0] � N] �] G �] G A^ � �^ ( _ ( ;_ & d_ o �_ �_ ` (` + H` ( t` �` �` �` �` @ �` e 7a + �a C �a
c 7 *c * bc % �c �c & �c �c O �c X Jd > �d E �d (e ? :e ze �e # �e 8 �e - f B 3f A vf �f ) �f �f V g ( gg # �g ( �g �g �g 8 �g J /h zh \ �h �h
�h i , "i Oi \i mi �i �i �i �i 1 �i j $ j Aj Tj " cj �j �j �j , �j 8 �j " /k 1 Rk �k �k �k , �k �k ? �k B =l ; �l > �l g �l " cm Z �n r �n ` To � �o � <p S �p ` q ` q m �q f Nr w �r t -s { �s j t t �t �t u & 1u $ Xu }u $ �u �u �u @ �u C )v : mv L �v �v w [ w H xw F �w x D x Tx 8 ty 2 �y 6 �y 2 z 3 Jz d ~z 5 �z { 4 6{ k{ �{ �{ �{ �{ " �{ 2 | 5| � N| � } 2 �~ � �~ � z V � � ]� � ߀ ^ k� d ʁ /� C A� d �� C � 9 .� C h� �� ( �� ; � > � F ]� ? �� d � � I� R � c A� � �� ` R� � �� [ V� V �� W � [ a� _ �� z � M �� 2 � 5 � N O� * �� 4 ɋ 8 �� " 7� Z� k� s� ( �� �� ̌ � � � , 0� C ]� F �� ) � ) � = <� z� & �� �� ю � � #� =� N� h� w {� � � � )� % ?� e� ! l� { �� +
� p 6� b �� '
� 2� 7 E� 7 }� 6 �� I � 8 6� K o� D �� 4 � K 5� I �� V ˔ 6 "� G Y� g �� K � b U� 6 �� 2 � a "� 6 �� U �� b � X t� ` ͘ X .� 8 �� 0 �� F � B 8� K {� O ǚ < � 6 T� : �� I ƛ O � o `�
М # ۜ V �� l V� J Ý K � Z� C v� �� ֞ & � # � < 8� ! u� % �� % �� � �� � ) -� W� ) f� " �� � �� > 9� & x� �� ) �� * ء � C #� # g� �� �� 4 �� = �� h 3� ? �� C ܣ n � J �� E ڤ y � H �� ? � K #� C o� S �� M � C U� / �� = ɧ Q � ; Y�
�� $ �� / Ũ �� � � B +� n�
�� * �� �� 3 ة 2 � . ?� 2 n� " �� 5 Ī �� > � 2 S� . �� 0 �� = � $� B� m ^� L ̬ � . 9� 6 h� . �� 2 έ j � f l� Ӯ H � 6� H T� : �� I د ? "� E b� = �� + � � ) 0� . Z� F �� r б J C� �� �� �� * Dz � # � + -� ! Y� R {� γ � ��
� 0 � # L� # p� �� �� B �� �� � � ! 6� � X� ڵ � ! �� D � @ e� 7 �� ' < � B C� �� �� �� 5 Ϸ # � )� ;� # [� � ] �� ! �� � 3� Q� p� ) � �� h �� 1 (� . Z� �� ) �� # Ǻ 0 � L � i� g ~� � � � $ � ! ;� ]� w� ! �� ] ��
� ) -� ! W� 4 y� �� Ƚ ) Ͻ
�� � 5 � $ P� - u� R �� ��
� # !� # E� ' i� ��
�� �� # ʿ * � 2 � L� . ^� " �� % �� � � %
� G 3� {� �� �� ) � �� � = !� _� y�
�� , �� * �� �� ( � R 9� * �� 5 �� / �� � ! $� " F� i� * �� �� 4 �� � � 2� F� \� , v� �� �� % �� = �� &� 5� >� ^� z� �� �� �� �� �� �� � $� 5� ' U� }� �� & �� �� �� ' � 4� P� l� }� �� �� # �� �� � ! � >� O� C l� g �� � 6� G I� �� �� �� % �� ! �� � % <� b� �� �� , �� 2 �� + � " D� $ g� 5 �� �� C �� 0 � = Q� �� L �� . �� 2 )� ] \� �� 3 �� � : &� I a� ? �� E �� = 1� + o� �� m �� ) '� ( Q� ( z� 2 �� 2 �� # � -� I� . i� 6 �� X �� e (� �� ) �� ' �� b �� R� " k� J �� Q �� +� * C� n� �� �� 7 �� �� �� � � & 8� _� y� �� �� �� $ �� + �� ' !� I� _� u� r �� A � p F� � �� ! l� A �� I �� _ � z� ' �� ' �� % �� ) � # .� R� r� �� �� # �� ! �� � , � & K� r� < �� �� ! �� �� � )� C� . P� , � , �� J �� $� % 3� % Y� 9 � �� ! �� 2 �� $� <� R�
_� j� t� �� �� �� �� �� � B ,� o� ; v� = �� �� � ; � M @� D �� �� �� d �� d� < }� �� , �� 2 �� c !� �� - �� �� �� � $� 5� B� 5 ]� 4 �� > �� � G � - d� 0 �� - �� < �� .� G M� + �� : �� < �� # 9� - ]� / �� 6 �� < �� /� >� ^� n� �� �� n J � � � � � � � � ) B 5 � L ( ; $ � � � ] k e ( � � � % � � � k � 7 , � � � � � / v � � �
z � T q < � v � | � � z � � � 3 � g y � � M 2 Z � � e i
* � C � � < & � � � ) Q 6 � 9 � & � T � � s � � / t � � A Y u � 0 � � � � t � - , � � � � J s ~ r � F p R � � � � � � N 3 � D � S � � Q � y � c � � � E w ` m � � � � M � , � _ U � X b + 4 ` � � � � w � � � o < � � � � [ � - . � � � 7 � y j 5 � � & � = � U l � � � � g � � Y ( � � ] � f x � } � � � " � � � T � v 0 X \ � H � b 1 � � � # � k K � � : � � � 1 � 2 * ] W � � � $ � u C � I h V x S � � � � H f � 7 [ Q � 7 � � � j c � � � � � � � � / 4 � � � 2 � � � � P r � � � i a h �
� � � � � � � � � � N � � � � 9 p w � � � o > � � R . � � ) � � � � � g 8 > L ' � � c � z x � � � U x E � G � � � � � � Y � � B � � � � � ~ � � � � � v l 8 = C � 2 � � � o � [ � � 6 � r � � � � " � ? u t � u M a � � � � � p Z � ; � � � � g h � � 9 1 � � + � � j � � � G � � � � � � | � q K � � \ � � � � � _ � O E Z i B m � � � q � � 9 K � � 5 � . � � � � O } - $ � � � G � � ( � { X � M
� � � n � ! � � r � h # � � � � [ � � � J 1 I 4 � �
P � � � � � � k � � � � � 0 � � W 5 P � " ` N O V p � I � � : t � & m 0 � W f @ � b : 7 ; R B H � L ] � � T � � � � 8 � d F � � ~ @ � � � 0 4 � � > ! � � � Q % * � o & A y � L $ � � � { = � ~ ! ^ � ! @ � � : C F � � � � � 8 V ' � � n $ � � \ � � � � � � � = - n � � � X � A \ � � _ a R �
' W D ^ j w " � � � � � � N � � � � � � � A � � l # � � � � � _ � � { O F Y 2 d � � f ? � � � e } # { � � % E � � � � � � � # + ) H ? q | � , * � � � : � � � � � �
b � < � - � I 6 ( ^ � ; � % �
|
� � D . � s @ � � � � � � a 3 � � / ' � � ' 1 � s 9 � � � ! c � ? � � � / " J � d � � � � � � � � 3 � � > % � ) � � � 4 � l � � 3 � � � � � 8 � � � . � U � � � � * � � � � � � 6 � K ,
� � m � � � � i � S ^ � � ` � � V 6 P � G } � � S � D d + Z � � � � z � � � � � + � � � 5 e
Connection options:
Display settings:
Environment variables:
For more information, type "\?" (for internal commands) or "\help" (for SQL
commands) from within psql, or consult the psql section in the PostgreSQL
documentation.
Input and output options:
Output format options:
Parser: "%s"
Parser: "%s.%s" --help=commands list backslash commands, then exit
--help=variables list special variables, then exit
(options: S = show system objects, + = additional detail)
-0, --record-separator-zero
set record separator for unaligned output to zero byte
-1 ("one"), --single-transaction
execute as a single transaction (if non-interactive)
-?, --help[=options] show this help, then exit
-A, --no-align unaligned table output mode
-E, --echo-hidden display queries that internal commands generate
-F, --field-separator=STRING
field separator for unaligned output (default: "%s")
-H, --html HTML table output mode
-L, --log-file=FILENAME send session log to file
-P, --pset=VAR[=ARG] set printing option VAR to ARG (see \pset command)
-R, --record-separator=STRING
record separator for unaligned output (default: newline)
-S, --single-line single-line mode (end of line terminates SQL command)
-T, --table-attr=TEXT set HTML table tag attributes (e.g., width, border)
-U, --username=USERNAME database user name (default: "%s")
-V, --version output version information, then exit
-W, --password force password prompt (should happen automatically)
-X, --no-psqlrc do not read startup file (~/.psqlrc)
-a, --echo-all echo all input from script
-b, --echo-errors echo failed commands
-c, --command=COMMAND run only single command (SQL or internal) and exit
-d, --dbname=DBNAME database name to connect to (default: "%s")
-e, --echo-queries echo commands sent to server
-f, --file=FILENAME execute commands from file, then exit
-h, --host=HOSTNAME database server host or socket directory (default: "%s")
-l, --list list available databases, then exit
-n, --no-readline disable enhanced command line editing (readline)
-o, --output=FILENAME send query results to file (or |pipe)
-p, --port=PORT database server port (default: "%s")
-q, --quiet run quietly (no messages, only query output)
-s, --single-step single-step mode (confirm each query)
-t, --tuples-only print rows only
-v, --set=, --variable=NAME=VALUE
set psql variable NAME to VALUE
(e.g., -v ON_ERROR_STOP=1)
-w, --no-password never prompt for password
-x, --expanded turn on expanded table output
-z, --field-separator-zero
set field separator for unaligned output to zero byte
AUTOCOMMIT if set, successful SQL commands are automatically committed
COLUMNS number of columns for wrapped format
COMP_KEYWORD_CASE determines the case used to complete SQL key words
[lower, upper, preserve-lower, preserve-upper]
DBNAME the currently connected database name
ECHO controls what input is written to standard output
[all, errors, none, queries]
ECHO_HIDDEN if set, display internal queries executed by backslash commands;
if set to "noexec", just show without execution
ENCODING current client character set encoding
FETCH_COUNT the number of result rows to fetch and display at a time
(default: 0=unlimited)
HISTCONTROL controls command history [ignorespace, ignoredups, ignoreboth]
HISTFILE file name used to store the command history
HISTSIZE the number of commands to store in the command history
HOST the currently connected database server host
IGNOREEOF if unset, sending an EOF to interactive session terminates application
LASTOID value of the last affected OID
NAME=VALUE [NAME=VALUE] psql ...
or \setenv NAME [VALUE] inside psql
ON_ERROR_ROLLBACK if set, an error doesn't stop a transaction (uses implicit savepoints)
ON_ERROR_STOP stop batch execution after error
PAGER name of external pager program
PGAPPNAME same as the application_name connection parameter
PGDATABASE same as the dbname connection parameter
PGHOST same as the host connection parameter
PGPASSFILE password file name
PGPASSWORD connection password (not recommended)
PGPORT same as the port connection parameter
PGUSER same as the user connection parameter
PORT server port of the current connection
PROMPT1 specifies the standard psql prompt
PROMPT2 specifies the prompt used when a statement continues from a previous line
PROMPT3 specifies the prompt used during COPY ... FROM STDIN
PSQLRC alternative location for the user's .psqlrc file
PSQL_EDITOR, EDITOR, VISUAL
editor used by the \e, \ef, and \ev commands
PSQL_EDITOR_LINENUMBER_ARG
how to specify a line number when invoking the editor
PSQL_HISTORY alternative location for the command history file
QUIET run quietly (same as -q option)
SHELL shell used by the \! command
SHOW_CONTEXT controls display of message context fields [never, errors, always]
SINGLELINE end of line terminates SQL command mode (same as -S option)
SINGLESTEP single-step mode (same as -s option)
TMPDIR directory for temporary files
USER the currently connected database user
VERBOSITY controls verbosity of error reports [default, verbose, terse]
\! [COMMAND] execute command in shell or start interactive shell
\? [commands] show help on backslash commands
\? options show help on psql command-line options
\? variables show help on special variables
\C [STRING] set table title, or unset if none
\H toggle HTML output mode (currently %s)
\T [STRING] set HTML <table> tag attributes, or unset if none
\a toggle between unaligned and aligned output mode
\c[onnect] {[DBNAME|- USER|- HOST|- PORT|-] | conninfo}
connect to new database (currently "%s")
\c[onnect] {[DBNAME|- USER|- HOST|- PORT|-] | conninfo}
connect to new database (currently no connection)
\cd [DIR] change the current working directory
\conninfo display information about current connection
\copy ... perform SQL COPY with data stream to the client host
\copyright show PostgreSQL usage and distribution terms
\crosstabview [COLUMNS] execute query and display results in crosstab
\dA[+] [PATTERN] list access methods
\dC[+] [PATTERN] list casts
\dD[S+] [PATTERN] list domains
\dE[S+] [PATTERN] list foreign tables
\dF[+] [PATTERN] list text search configurations
\dFd[+] [PATTERN] list text search dictionaries
\dFp[+] [PATTERN] list text search parsers
\dFt[+] [PATTERN] list text search templates
\dL[S+] [PATTERN] list procedural languages
\dO[S+] [PATTERN] list collations
\dT[S+] [PATTERN] list data types
\d[S+] list tables, views, and sequences
\d[S+] NAME describe table, view, sequence, or index
\da[S] [PATTERN] list aggregates
\db[+] [PATTERN] list tablespaces
\dc[S+] [PATTERN] list conversions
\dd[S] [PATTERN] show object descriptions not displayed elsewhere
\ddp [PATTERN] list default privileges
\des[+] [PATTERN] list foreign servers
\det[+] [PATTERN] list foreign tables
\deu[+] [PATTERN] list user mappings
\dew[+] [PATTERN] list foreign-data wrappers
\df[antw][S+] [PATRN] list [only agg/normal/trigger/window] functions
\dg[S+] [PATTERN] list roles
\di[S+] [PATTERN] list indexes
\dl list large objects, same as \lo_list
\dm[S+] [PATTERN] list materialized views
\dn[S+] [PATTERN] list schemas
\do[S+] [PATTERN] list operators
\dp [PATTERN] list table, view, and sequence access privileges
\drds [PATRN1 [PATRN2]] list per-database role settings
\ds[S+] [PATTERN] list sequences
\dt[S+] [PATTERN] list tables
\du[S+] [PATTERN] list roles
\dv[S+] [PATTERN] list views
\dx[+] [PATTERN] list extensions
\dy[+] [PATTERN] list event triggers
\e [FILE] [LINE] edit the query buffer (or file) with external editor
\echo [STRING] write string to standard output
\ef [FUNCNAME [LINE]] edit function definition with external editor
\encoding [ENCODING] show or set client encoding
\errverbose show most recent error message at maximum verbosity
\ev [VIEWNAME [LINE]] edit view definition with external editor
\f [STRING] show or set field separator for unaligned query output
\g [FILE] or ; execute query (and send results to file or |pipe)
\gexec execute query, then execute each value in its result
\gset [PREFIX] execute query and store results in psql variables
\h [NAME] help on syntax of SQL commands, * for all commands
\i FILE execute commands from file
\ir FILE as \i, but relative to location of current script
\l[+] [PATTERN] list databases
\lo_export LOBOID FILE
\lo_import FILE [COMMENT]
\lo_list
\lo_unlink LOBOID large object operations
\o [FILE] send all query results to file or |pipe
\p show the contents of the query buffer
\password [USERNAME] securely change the password for a user
\prompt [TEXT] NAME prompt user to set internal variable
\pset [NAME [VALUE]] set table output option
(NAME := {border|columns|expanded|fieldsep|fieldsep_zero|
footer|format|linestyle|null|numericlocale|pager|
pager_min_lines|recordsep|recordsep_zero|tableattr|title|
tuples_only|unicode_border_linestyle|
unicode_column_linestyle|unicode_header_linestyle})
\q quit psql
\qecho [STRING] write string to query output stream (see \o)
\r reset (clear) the query buffer
\s [FILE] display history or save it to file
\set [NAME [VALUE]] set internal variable, or list all if no parameters
\setenv NAME [VALUE] set or unset environment variable
\sf[+] FUNCNAME show a function's definition
\sv[+] VIEWNAME show a view's definition
\t [on|off] show only rows (currently %s)
\timing [on|off] toggle timing of commands (currently %s)
\unset NAME unset (delete) internal variable
\w FILE write query buffer to file
\watch [SEC] execute query every SEC seconds
\x [on|off|auto] toggle expanded output (currently %s)
\z [PATTERN] same as \dp
border border style (number)
columns target width for the wrapped format
expanded (or x) expanded output [on, off, auto]
fieldsep field separator for unaligned output (default "%s")
fieldsep_zero set field separator for unaligned output to zero byte
footer enable or disable display of the table footer [on, off]
format set output format [unaligned, aligned, wrapped, html, asciidoc, ...]
linestyle set the border line drawing style [ascii, old-ascii, unicode]
null set the string to be printed in place of a null value
numericlocale enable or disable display of a locale-specific character to separate
groups of digits [on, off]
pager control when an external pager is used [yes, no, always]
psql --pset=NAME[=VALUE]
or \pset NAME [VALUE] inside psql
psql --set=NAME=VALUE
or \set NAME VALUE inside psql
psql [OPTION]... [DBNAME [USERNAME]]
recordsep record (line) separator for unaligned output
recordsep_zero set record separator for unaligned output to zero byte
set NAME=VALUE
psql ...
or \setenv NAME [VALUE] inside psql
tableattr (or T) specify attributes for table tag in html format or proportional
column widths for left-aligned data types in latex-longtable format
title set the table title for any subsequently printed tables
tuples_only if set, only actual table data is shown
unicode_border_linestyle
unicode_column_linestyle
unicode_header_linestyle
set the style of Unicode line drawing [single, double]
"%s.%s" is not a view
%d connection %d connections %s %s %s (every %gs)
%s
%s (%s, server %s)
%s (every %gs)
%s: %s
%s: -1 can only be used in non-interactive mode
%s: cannot copy from/to a directory
%s: could not delete variable "%s"
%s: could not find own program executable
%s: could not open log file "%s": %s
%s: could not set printing parameter "%s"
%s: could not set variable "%s"
%s: current transaction is aborted
%s: invalid encoding name or conversion procedure not found
%s: not connected to a database
%s: out of memory
%s: unknown transaction status
%s: warning: extra command-line argument "%s" ignored
(%lu row) (%lu rows) ***(Single step mode: verify command)*******************************************
%s
***(press return to proceed or enter x and return to cancel)********************
********* QUERY **********
%s
**************************
+ opt(%d) = |%s|
, clustered , deferrable , initially deferred , invalid , predicate (%s) , replica identity , tablespace "%s" Access privileges All connection parameters must be supplied because no database connection exists
Argument data types Asynchronous notification "%s" received from server process with PID %d.
Asynchronous notification "%s" with payload "%s" received from server process with PID %d.
Attributes Available help:
Border style is %d.
Bypass RLS COPY data transfer failed: %s Call Handler Cannot add cell to table content: total cell count of %d exceeded.
Cannot add header to table content: column count of %d exceeded.
Cannot login Check Check constraints: Child tables Collate Column Column privileges Command: %s
Description: %s
Syntax:
%s
Composite type "%s.%s" Connection
Create DB Create role Ctype Database Default access privileges Default footer is off.
Default footer is on.
Default? Definition Description Destination Dictionaries Did not find any extension named "%s".
Did not find any extensions.
Did not find any relation named "%s".
Did not find any relation with OID %s.
Did not find any text search configuration named "%s".
Did not find any text search parser named "%s".
Disabled internal triggers: Disabled rules: Disabled triggers: Disabled user triggers: Elements Enabled Encoding End parse Enter data to be copied followed by a newline.
End with a backslash and a period on a line by itself, or an EOF signal. Enter it again: Enter new password: Event Expanded display is off.
Expanded display is on.
Expanded display is used automatically.
FDW Options FDW Options: (%s) Failed.
Field separator is "%s".
Field separator is zero byte.
Foreign table "%s.%s" Foreign-data wrapper Foreign-key constraints: Formatting
Function General
General options:
Get headline Get next token Get token types Handler Has OIDs: yes Help
ID Implicit? Index Index "%s.%s" Indexes: Informational
Inherits Init Init options Inline Handler Input/Output
Internal Language Internal name Interrupted
Invalid command \%s. Try \? for help.
Language Large Objects
Large objects Left arg type Lexize Line style is %s.
List of access methods List of aggregate functions List of casts List of collations List of conversions List of data types List of databases List of domains List of event triggers List of foreign servers List of foreign tables List of foreign-data wrappers List of functions List of installed extensions List of languages List of operators List of relations List of roles List of schemas List of settings List of specially treated variables
List of tablespaces List of text search configurations List of text search dictionaries List of text search parsers List of text search templates List of user mappings Locale-adjusted numeric output is off.
Locale-adjusted numeric output is on.
Location Materialized view "%s.%s" Member of Method Modifier Modifiers Name No changes No connections No help available for "%s".
Try \h with no arguments to see available help.
No inheritance No matching relations found.
No matching settings found.
No per-database role settings support in this server version.
No relations found.
No settings found.
Null display is "%s".
Number of child tables: %d (Use \d+ to list them.) Object Object Description Object descriptions Objects in extension "%s" Operating System
Options Output format is %s.
Owned by: %s Owner Pager is always used.
Pager is used for long output.
Pager usage is off.
Pager won't be used for less than %d line.
Pager won't be used for less than %d lines.
Parallel Password encryption failed.
Password for user %s: Password valid until Password: Passwords didn't match.
Policies Policies (forced row security enabled): Policies (forced row security enabled): (none) Policies (row security disabled): Policies (row security enabled): (none) Policies: Previous connection kept
Procedure Query Buffer
Query buffer is empty. Query buffer reset (cleared). Record separator is "%s".
Record separator is <newline>.
Record separator is zero byte.
Referenced by: Replica Identity Replication Report bugs to <pgsql-bugs@postgresql.org>.
Result data type Result type Right arg type Role Role name Rules firing always: Rules firing on replica only: Rules: SSL connection (protocol: %s, cipher: %s, bits: %s, compression: %s)
STATEMENT: %s
Schema Security Sequence "%s.%s" Server Server: %s Settings Size Source Source code Source type Special relation "%s.%s" Start parse Stats target Storage Succeeded.
Superuser TOAST table "%s.%s" Table Table "%s.%s" Table attributes are "%s".
Table attributes unset.
Tablespace Tablespace: "%s" Tags Target type Target width is %d.
Target width is unset.
Template Text search configuration "%s" Text search configuration "%s.%s" Text search parser "%s" Text search parser "%s.%s" The connection to the server was lost. Attempting reset: The input is a PostgreSQL custom-format dump.
Use the pg_restore command-line client to restore this dump to a database.
The server (version %s) does not support access methods.
The server (version %s) does not support altering default privileges.
The server (version %s) does not support collations.
The server (version %s) does not support editing function source.
The server (version %s) does not support editing view definitions.
The server (version %s) does not support extensions.
The server (version %s) does not support foreign servers.
The server (version %s) does not support foreign tables.
The server (version %s) does not support foreign-data wrappers.
The server (version %s) does not support full text search.
The server (version %s) does not support savepoints for ON_ERROR_ROLLBACK.
The server (version %s) does not support showing function source.
The server (version %s) does not support showing view definitions.
The server (version %s) does not support tablespaces.
The server (version %s) does not support user mappings.
There is no previous error. Time: %.3f ms
Timing is off. Timing is on. Title is "%s".
Title is unset.
Token Token name Token types for parser "%s" Token types for parser "%s.%s" Triggers firing always: Triggers firing on replica only: Triggers: Trusted Try "%s --help" for more information.
Tuples only is off.
Tuples only is on.
Type Type "help" for help.
Type: \copyright for distribution terms
\h for help with SQL commands
\? for help with psql commands
\g or terminate with semicolon to execute query
\q to quit
Typed table of type: %s Unicode border line style is "%s".
Unicode column line style is "%s".
Unicode header line style is "%s".
Unlogged index "%s.%s" Unlogged materialized view "%s.%s" Unlogged table "%s.%s" Usage:
Use "\q" to leave %s.
User name Validator Value Variables
Version View "%s.%s" View definition: Volatility WARNING: %s major version %s, server major version %s.
Some psql features might not work.
WARNING: Console code page (%u) differs from Windows code page (%u)
8-bit characters might not work correctly. See psql reference
page "Notes for Windows users" for details.
Wrote history to file "%s".
You are connected to database "%s" as user "%s" on host "%s" at port "%s".
You are connected to database "%s" as user "%s" via socket in "%s" at port "%s".
You are currently not connected to a database.
You are now connected to database "%s" as user "%s" on host "%s" at port "%s".
You are now connected to database "%s" as user "%s" via socket in "%s" at port "%s".
You are now connected to database "%s" as user "%s".
You are using psql, the command-line interface to PostgreSQL. \!: failed
\%s: could not change directory to "%s": %s
\%s: environment variable name must not contain "="
\%s: error while setting variable
\%s: extra argument "%s" ignored
\%s: missing required argument
\connect: %s \copy: arguments required
\copy: parse error at "%s"
\copy: parse error at end of line
\crosstabview: ambiguous column name: "%s"
\crosstabview: column name not found: "%s"
\crosstabview: column number %d is out of range 1..%d
\crosstabview: data column must be specified when query returns more than three columns
\crosstabview: maximum number of columns (%d) exceeded
\crosstabview: query must return at least three columns
\crosstabview: query result contains multiple data values for row "%s", column "%s"
\crosstabview: statement did not return a result set
\crosstabview: vertical and horizontal headers must be different columns
\df does not take a "w" option with server version %s
\df only takes [antwS+] as options
\pset: allowed Unicode border line styles are single, double
\pset: allowed Unicode column line styles are single, double
\pset: allowed Unicode header line styles are single, double
\pset: allowed formats are unaligned, aligned, wrapped, html, asciidoc, latex, latex-longtable, troff-ms
\pset: allowed line styles are ascii, old-ascii, unicode
\pset: unknown option: %s
\watch cannot be used with COPY
\watch cannot be used with an empty query
abbreviated_grant_or_revoke abort the current transaction aborted because of read failure access_method_type action agg aggregate_name aggregate_signature alias alignment allowconn always analyze_function and aggregate_signature is: and conflict_action is one of: and grouping_element can be one of: and like_option is: and table_constraint is: and table_constraint_using_index is: and with_query is: arg_data_type arg_name arg_type argmode argname argtype argument argument_type arguments attempt to \gset into specially treated variable "%s" ignored
attribute attribute_name attribute_option base_type boolean cache call_handler cancel a transaction that was earlier prepared for two-phase commit canceled by user cannot duplicate null pointer (internal error)
cannot escape without active connection
canonical_function category change a database change a database role change a run-time parameter change a server configuration parameter change role name or membership change the definition of a collation change the definition of a conversion change the definition of a domain change the definition of a foreign server change the definition of a foreign table change the definition of a foreign-data wrapper change the definition of a function change the definition of a large object change the definition of a materialized view change the definition of a procedural language change the definition of a row level security policy change the definition of a rule change the definition of a schema change the definition of a sequence generator change the definition of a table change the definition of a tablespace change the definition of a text search configuration change the definition of a text search dictionary change the definition of a text search parser change the definition of a text search template change the definition of a trigger change the definition of a type change the definition of a user mapping change the definition of a view change the definition of an aggregate function change the definition of an event trigger change the definition of an extension change the definition of an index change the definition of an operator change the definition of an operator class change the definition of an operator family change the ownership of database objects owned by a database role channel check_expression child process exited with exit code %d child process exited with unrecognized status %d child process was terminated by exception 0x%X child process was terminated by signal %d: %s close a cursor cluster a table according to an index code collatable collate %s collation collect statistics about a database column_alias column_constraint column_definition column_name column_type com_op combinefunc command command not executable command not found commit a transaction that was earlier prepared for two-phase commit commit the current transaction compute a set of rows condition configuration_parameter conflict_action conflict_target connection to server was lost
connlimit constraint constraint_name copy data between a file and a table could not change directory to "%s": %s could not close pipe to external command: %s
could not execute command "%s": %s
could not find a "%s" to execute could not get home directory for user ID %ld: %s
could not identify current directory: %s could not locate temporary directory: %s
could not look up effective user ID %ld: %s could not open temporary file "%s": %s
could not parse reloptions array
could not read binary "%s" could not read from input file: %s
could not read symbolic link "%s" could not save history to file "%s": %s
could not set variable "%s"
could not start /bin/sh
could not start editor "%s"
could not stat file "%s": %s
could not write COPY data: %s
count create a new database create new rows in a table cursor_name data_type database_name deallocate a prepared statement default default %s default_expr define a cursor define a new access method define a new aggregate function define a new cast define a new collation define a new data type define a new database role define a new domain define a new encoding conversion define a new event trigger define a new foreign server define a new foreign table define a new foreign-data wrapper define a new function define a new index define a new mapping of a user to a foreign server define a new materialized view define a new operator define a new operator class define a new operator family define a new procedural language define a new rewrite rule define a new row level security policy for a table define a new savepoint within the current transaction define a new schema define a new sequence generator define a new table define a new table from the results of a query define a new tablespace define a new text search configuration define a new text search dictionary define a new text search parser define a new text search template define a new transform define a new trigger define a new view define access privileges define default access privileges define or change a security label applied to an object define or change the comment of an object definer definition delete delete rows of a table delimiter delimiter_character deserialfunc dest_encoding destroy a previously defined savepoint dictionary_name direction directory disabled discard session state domain constraint domain_constraint domain_name element empty a table or set of tables enabled encoding encoding_name end_function environment variable PSQL_EDITOR_LINENUMBER_ARG must be set to specify a line number
escape_character event exclude_element exclude_element in an EXCLUDE constraint is: execute a prepared statement execute an anonymous code block execution_cost existing_collation existing_enum_value expression extension_name family_name fdw_name ffunc filename filter_value filter_variable for table "%s.%s" force a transaction log checkpoint foreign table format_name from_item from_sql_function_name function function name is required
function_name garbage-collect and optionally analyze a database generate a notification gettoken_function group_name grouping_element handler_function headline_function history is not supported by this installation
immutable import table definitions from a foreign server in assignment increment index index_column_name index_expression index_method index_name index_parameters index_parameters in UNIQUE, PRIMARY KEY, and EXCLUDE constraints are: index_predicate init_function initial_condition inline_handler input_function insert install an extension integer internallength invalid binary "%s" invalid command \%s
invalid line number: %s
invalid output format (internal error): %d invoker istemplate join_column join_condition join_proc join_type label lang_name large_object_oid lc_collate lc_ctype left_type lexize_function lextypes_function like_option like_type link_symbol listen for a notification load a shared library file local socket local_schema locale lock a table lockmode loid materialized view maxvalue member_object method mffunc minitial_condition minvalue minvfunc more than one row returned for \gset
msfunc mstate_data_size mstate_data_type name neg_op new_attribute_name new_column_name new_constraint_name new_dictionary new_enum_value new_name new_owner new_role new_schema new_table new_tablespace new_version no no query buffer
no rows returned for \gset
normal not null null_string obj_file object_name off old_dictionary old_role old_version on op_type opclass operator operator class operator family operator_name option or the old syntax out of memory out of memory
output_expression output_function output_name parameter parent_table parser_name password payload pclose failed: %s policy_name position a cursor predicate preferred prepare a statement for execution prepare the current transaction for two-phase commit primary key, provider psql is the PostgreSQL interactive terminal.
psql variables:
query quote_character rebuild indexes receive_function refcolumn referenced_table_name reftable relation_name remote_schema remove a cast remove a collation remove a conversion remove a data type remove a database remove a database role remove a domain remove a foreign server descriptor remove a foreign table remove a foreign-data wrapper remove a function remove a materialized view remove a procedural language remove a rewrite rule remove a row level security policy from a table remove a schema remove a sequence remove a table remove a tablespace remove a text search configuration remove a text search dictionary remove a text search parser remove a text search template remove a transform remove a trigger remove a user mapping for a foreign server remove a view remove access privileges remove an access method remove an aggregate function remove an event trigger remove an extension remove an index remove an operator remove an operator class remove an operator family remove database objects owned by a database role replace the contents of a materialized view replica res_proc restart restore the value of a run-time parameter to the default value restricted result_rows retrieve rows from a query using a cursor retrieve rows from a table or view rettype rewrite_rule_name right_type role_name role_specification roll back to a savepoint rule rule_name safe sampling_method savepoint_name schema_element schema_name seed select send_function sequence sequence_name serialfunc server_name server_type server_version set constraint check timing for the current transaction set the characteristics of the current transaction set the current user identifier of the current session set the session user identifier and the current user identifier of the current session sfunc show the execution plan of a statement show the value of a run-time parameter skipping recursive expansion of variable "%s"
snapshot_id sort_expression sort_family_name sort_operator source_config source_encoding source_table source_type special stable start start a transaction block start_function state_data_size state_data_type statement stop listening for a notification storage storage_parameter storage_type strategy_number sub-SELECT subtype subtype_diff_function subtype_operator_class support_number tab completion query failed: %s
Query was:
%s
table table constraint table_constraint table_constraint_using_index table_name tablespace_name tablespace_option target_role target_type template text timestamp timezone to_sql_function_name token_type transaction_id transaction_mode trigger trigger_name trying to exit copy mode type type_modifier_input_function type_modifier_output_function type_name uid unexpected PQresultStatus: %d
unexpected result status for \watch
unexpected transaction status (%d)
unique, unknown unrecognized value "%s" for "%s"; assuming "%s"
unsafe unterminated quoted string
update update rows of a table user does not exist user name lookup failure: error code %lu user_name using_expression valfunction validator_function value values version view view name is required
view_option_name view_option_value volatile where abbreviated_grant_or_revoke is one of: where action is one of: where aggregate_signature is: where column_constraint is: where conflict_target can be one of: where constraint is: where direction can be empty or one of: where event can be one of: where from_item can be one of: where lockmode is one of: where member_object is: where option can be one of: where option can be: where role_specification can be: where transaction_mode is one of: window window_definition window_name with_query with_query_name yes Project-Id-Version: psql (PostgreSQL current)
Report-Msgid-Bugs-To: pgsql-bugs@postgresql.org
POT-Creation-Date: 2021-09-29 11:53+0300
PO-Revision-Date: 2021-11-08 05:44+0300
Last-Translator: Alexander Lakhin <exclusion@gmail.com>
Language-Team: Russian <pgsql-ru-general@postgresql.org>
Language: ru
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Plural-Forms: nplurals=3; plural=(n%10==1 && n%100!=11 ? 0 : n%10>=2 && n%10<=4 && (n%100<10 || n%100>=20) ? 1 : 2);
Параметры подключения:
Параметры отображения:
Переменные окружения:
Чтобы узнать больше, введите "\?" (список внутренних команд) или "\help"
(справка по операторам SQL) в psql, либо обратитесь к разделу psql в
документации PostgreSQL.
Параметры ввода/вывода:
Параметры вывода:
Анализатор: "%s"
Анализатор: "%s.%s" --help=commands перечислить команды с \ и выйти
--help=variables перечислить специальные переменные и выйти
(дополнения: S = показывать системные объекты, + = дополнительные подробности)
-0, --record-separator-zero
сделать разделителем записей при невыровненном
нулевой байт
-1 ("один"), --single-transaction
выполнить как одну транзакцию
(в неинтерактивном режиме)
-?, --help[=options] показать эту справку и выйти
-A, --no-align режим вывода невыровненной таблицы
-E, --echo-hidden выводить запросы, порождённые внутренними командами
-F, --field-separator=СТРОКА
разделителей полей при невыровненном выводе
(по умолчанию: "%s")
-H, --html вывод таблицы в формате HTML
-L, --log-file=ИМЯ_ФАЙЛА сохранять протокол работы в файл
-P, --pset=ПАР[=ЗНАЧ] определить параметр печати ПАР (с заданным ЗНАЧЕНИЕМ)
(см. описание \pset)
-R, --record-separator=СТРОКА
разделитель записей при невыровненном выводе
(по умолчанию: новая строка)
-S, --single-line однострочный режим (конец строки завершает команду)
-T, --table-attr=ТЕКСТ установить атрибуты HTML-таблицы (width, border)
-U, --username=ИМЯ имя пользователя (по умолчанию: "%s")
-V, --version показать версию и выйти
-W, --password запрашивать пароль всегда (обычно не требуется)
-X, --no-psqlrc игнорировать файл параметров запуска (~/.psqlrc)
-a, --echo-all отображать все команды из скрипта
-b, --echo-errors отображать команды с ошибками
-c, --command=КОМАНДА выполнить одну команду (SQL или внутреннюю) и выйти
-d, --dbname=БД имя подключаемой базы данных (по умолчанию "%s")
-e, --echo-queries отображать команды, отправляемые серверу
-f, --file=ИМЯ_ФАЙЛА выполнить команды из файла и выйти
-h, --host=ИМЯ имя сервера баз данных или каталог сокетов
(по умолчанию: "%s")
-l, --list вывести список баз данных и выйти
-n, --no-readline отключить редактор командной строки readline
-o, --output=ИМЯ_ФАЙЛА направить результаты запроса в файл (или канал |)
-p, --port=ПОРТ порт сервера баз данных (по умолчанию: "%s")
-q, --quiet показывать только результаты запросов, без сообщений
-s, --single-step пошаговый режим (подтверждение каждого запроса)
-t, --tuples-only выводить только кортежи
-v, --set=, --variable=ИМЯ=ЗНАЧЕНИЕ
присвоить переменной psql ИМЯ заданное ЗНАЧЕНИЕ
(например: -v ON_ERROR_STOP=1)
-w, --no-password не запрашивать пароль
-x, --expanded включить развёрнутый вывод таблицы
-z, --field-separator-zero
сделать разделителем полей при невыровненном
выводе нулевой байт
AUTOCOMMIT если установлен, успешные SQL-команды фиксируются автоматически
COLUMNS число столбцов для форматирования с переносом
COMP_KEYWORD_CASE определяет регистр для автодополнения ключевых слов SQL
[lower (нижний), upper (верхний),
preserve-lower (сохранять нижний),
preserve-upper (сохранять верхний)]
DBNAME имя текущей подключённой базы данных
ECHO определяет, что выдаётся на стандартный вывод
[all (всё), errors (ошибки), none (ничего),
queries (запросы)]
ECHO_HIDDEN если установлено, выводит внутренние запросы, порождаемые командами с \;
если установлено значение "noexec", они выводятся, но не выполняются
ENCODING текущая кодировка клиентского набора символов
FETCH_COUNT число результирующих строк, извлекаемых и отображаемых за раз
(по умолчанию: 0=без ограничений)
HISTCONTROL управляет историей команд [ignorespace (игнорировать пробелы),
ignoredups (игнорировать дубли), ignoreboth (и то, и другое)]
HISTFILE имя файла, в котором будет сохраняться история команд
HISTSIZE число команд, которые будут сохраняться в истории
HOST сервер баз данных, к которому установлено подключение
IGNOREEOF если не установлено, отправка EOF в интерактивном сеансе завершает приложение
LASTOID значение последнего задействованного OID
ИМЯ=ЗНАЧЕНИЕ [ИМЯ=ЗНАЧЕНИЕ] psql ...
или \setenv ИМЯ [ЗНАЧЕНИЕ] в приглашении psql
ON_ERROR_ROLLBACK если установлено, транзакция не прекращается при ошибке (используются неявные точки сохранения)
ON_ERROR_STOP останавливать выполнение пакета команд после ошибки
PAGER имя программы внешнего постраничника
PGAPPNAME синоним параметра подключения application_name
PGDATABASE синоним параметра подключения dbname
PGHOST синоним параметра подключения host
PGPASSFILE имя файла с паролем
PGPASSWORD пароль для подключения (использовать не рекомендуется)
PGPORT синоним параметра подключения port
PGUSER синоним параметра подключения user
PORT порт сервера для текущего соединения
PROMPT1 устанавливает стандартное приглашение psql
PROMPT2 устанавливает приглашение, которое выводится при переносе оператора на новую строку
PROMPT3 устанавливает приглашения для выполнения COPY ... FROM STDIN
PSQLRC альтернативное размещение пользовательского файла .psqlrc
PSQL_EDITOR, EDITOR, VISUAL
редактор, вызываемый командами \e, \ef и \ev
PSQL_EDITOR_LINENUMBER_ARG
определяет способ передачи номера строки при вызове редактора
PSQL_HISTORY альтернативное размещение файла с историей команд
QUIET выводить минимум сообщений (как и с параметром -q)
SHELL оболочка, вызываемая командой \!
SHOW_CONTEXT управляет отображением полей контекста сообщений [never, errors, always]
SINGLELINE конец строки завершает режим ввода SQL-команды (как и с параметром -S)
SINGLESTEP пошаговый режим (как и с параметром -s)
TMPDIR каталог для временных файлов
USER текущий пользователь, подключённый к БД
VERBOSITY управляет детализацией отчётов об ошибках [default (по умолчанию), verbose (подробно), terse (кратко)]
\! [КОМАНДА] выполнить команду в командной оболочке
или запустить интерактивную оболочку
\? [commands] справка по командам psql c \
\? options справка по параметрам командной строки psql
\? variables справка по специальным переменным
\C [СТРОКА] задать заголовок таблицы или убрать, если не задан
\H переключить режим вывода в HTML (текущий: %s)
\T [СТРОКА] задать атрибуты для <table> или убрать, если не заданы
\a переключение режимов вывода:
неформатированный/выровненный
\c[onnect] {[БД|- ПОЛЬЗОВАТЕЛЬ|- СЕРВЕР|- ПОРТ|-] | conninfo}
подключиться к другой базе данных
(текущая: "%s")
\c[onnect] {[БД|- ПОЛЬЗОВАТЕЛЬ|- СЕРВЕР|- ПОРТ|-] | conninfo}
подключиться к другой базе данных
(сейчас подключения нет)
\cd [ПУТЬ] сменить текущий каталог
\conninfo информация о текущем соединении
\copy ... выполнить SQL COPY на стороне клиента
\copyright условия использования и распространения PostgreSQL
\crosstabview [СТОЛБЦЫ] выполнить запрос и вывести результат в перекрёстном виде
\dA[+] [МАСКА] список методов доступа
\dC[+] [МАСКА] список приведений типов
\dD[S+] [МАСКА] список доменов
\dE[S+] [МАСКА] список сторонних таблиц
\dF[+] [МАСКА] список конфигураций текстового поиска
\dFd[+] [МАСКА] список словарей текстового поиска
\dFp[+] [МАСКА] список анализаторов текстового поиска
\dFt[+] [МАСКА] список шаблонов текстового поиска
\dL[S+] [МАСКА] список языков процедур
\dO[S+] [МАСКА] список правил сортировки
\dT[S+] [МАСКА] список типов данных
\d[S+] список таблиц, представлений и последовательностей
\d[S+] ИМЯ описание таблицы, представления, последовательности
или индекса
\da[S] [МАСКА] список агрегатных функций
\db[+] [МАСКА] список табличных пространств
\dc[S+] [МАСКА] список преобразований
\dd[S] [МАСКА] описания объектов, не выводимые в других режимах
\ddp [МАСКА] список прав по умолчанию
\des[+] [МАСКА] список сторонних серверов
\det[+] [МАСКА] список сторонних таблиц
\deu[+] [МАСКА] список сопоставлений пользователей
\dew[+] [МАСКА] список обёрток сторонних данных
\df[antw][S+] [МАСКА] список [агрегатных/нормальных/триггерных/оконных]
функций соответственно
\dg[S+] [МАСКА] список ролей
\di[S+] [МАСКА] список индексов
\dl список больших объектов (то же, что и \lo_list)
\dm[S+] [МАСКА] список материализованных представлений
\dn[S+] [МАСКА] список схем
\do[S+] [МАСКА] список операторов
\dp [МАСКА] список прав доступа к таблицам, представлениям и
последовательностям
\drds [МАСК1 [МАСК2]] список параметров роли на уровне БД
\ds[S+] [МАСКА] список последовательностей
\dt[S+] [МАСКА] список таблиц
\du[S+] [МАСКА] список ролей
\dv[S+] [МАСКА] список представлений
\dx[+] [МАСКА] список расширений
\dy[+] [МАСКА] список событийных триггеров
\e [ФАЙЛ] [СТРОКА] править буфер запроса (или файл) во внешнем редакторе
\echo [СТРОКА] записать строку в стандартный вывод
\ef [ФУНКЦИЯ [СТРОКА]] править определение функции во внешнем редакторе
\encoding [КОДИРОВКА] показать/установить клиентскую кодировку
\errverbose вывести максимально подробное сообщение о последней ошибке
\ev [VIEWNAME [LINE]] править определение представления во внешнем редакторе
\f [СТРОКА] показать или установить разделитель полей для
неформатированного вывода
\g [ФАЙЛ] или ; выполнить запрос
(и направить результаты в файл или канал |)
\gexec выполнить запрос, а затем выполнить каждую строку в результате
\gset [ПРЕФИКС] выполнить запрос и сохранить результаты в переменных
psql
\h [ИМЯ] справка по заданному SQL-оператору; * - по всем
\i ФАЙЛ выполнить команды из файла
\ir ФАЙЛ подобно \i, но путь задаётся относительно
текущего скрипта
\l[+] [МАСКА] список баз данных
\lo_export LOBOID ФАЙЛ
\lo_import ФАЙЛ [КОММЕНТАРИЙ]
\lo_list
\lo_unlink LOBOID операции с большими объектами
\o [ФАЙЛ] выводить все результаты запросов в файл или канал |
\p вывести содержимое буфера запросов
\password [ИМЯ] безопасно сменить пароль пользователя
\prompt [ТЕКСТ] ИМЯ предложить пользователю задать внутреннюю переменную
\pset [ИМЯ [ЗНАЧЕНИЕ]] установить параметр вывода таблицы, где
(ИМЯ := {border|columns|expanded|fieldsep|fieldsep_zero|
footer|format|linestyle|null|numericlocale|pager|
pager_min_lines|recordsep|recordsep_zero|tableattr|title|
tuples_only|unicode_border_linestyle|
unicode_column_linestyle|unicode_header_linestyle})
\q выйти из psql
\qecho [СТРОКА] записать строку в поток результатов запроса (см. \o)
\r очистить буфер запроса
\s [ФАЙЛ] вывести историю или сохранить её в файл
\set [ИМЯ [ЗНАЧЕНИЕ]] установить внутреннюю переменную или вывести все,
если имя не задано
\setenv ИМЯ [ЗНАЧЕНИЕ] установить или сбросить переменную окружения
\sf[+] ИМЯ_ФУНКЦИИ показать определение функции
\sv[+] ИМЯ_ПРЕДСТ показать определение представления
\t [on|off] режим вывода только строк (сейчас: %s)
\timing [on|off] включить/выключить секундомер (сейчас: %s)
\unset ИМЯ сбросить (удалить) внутреннюю переменную
\w ФАЙЛ записать буфер запроса в файл
\watch [СЕК] повторять запрос в цикле через заданное число секунд
\x [on|off|auto] переключить режим расширенного вывода (сейчас: %s)
\z [МАСКА] то же, что и \dp
border стиль границы (число)
columns целевая ширина для формата с переносом
expanded (или x) расширенный вывод [on (вкл.), off (выкл.), auto (авто)]
fieldsep разделитель полей для неформатированного вывода (по умолчанию "%s")
fieldsep_zero устанавливает ноль разделителем полей при неформатированном выводе
footer включает или выключает вывод подписей таблицы [on (вкл.), off (выкл.)]
format устанавливает формат вывода [unaligned (неформатированный), aligned (выровненный), wrapped (с переносом), html, asciidoc, ...]
linestyle задаёт стиль рисования линий границы [ascii, old-ascii, unicode]
null устанавливает строку, выводимую вместо значения NULL
numericlocale включает или отключает вывод заданного локалью разделителя
группы цифр [on (вкл.), off (выкл.)]
pager определяет, используется ли внешний постраничник [yes (да), no (нет), always (всегда)]
psql --pset=ИМЯ[=ЗНАЧЕНИЕ]
или \pset ИМЯ [ЗНАЧЕНИЕ] в приглашении psql
psql --set=ИМЯ=ЗНАЧЕНИЕ
или \set ИМЯ ЗНАЧЕНИЕ в приглашении psql
psql [ПАРАМЕТР]... [БД [ПОЛЬЗОВАТЕЛЬ]]
recordsep разделитель записей (строк) при неформатированном выводе
recordsep_zero устанавливает ноль разделителем записей при неформатированном выводе
set ИМЯ=ЗНАЧЕНИЕ
psql ...
или \setenv ИМЯ ЗНАЧЕНИЕ в приглашении psql
tableattr (или T) задаёт атрибуты для тега table в формате html или пропорциональные
ширины столбцов для выровненных влево данных, в формате latex-longtable
title задаёт заголовок таблицы для последовательно печатаемых таблиц
tuples_only если установлено, выводятся только непосредственно табличные данные
unicode_border_linestyle
unicode_column_linestyle
unicode_header_linestyle
задаёт стиль рисуемых линий Unicode [single (одинарные), double (двойные)]
"%s.%s" — не представление
%d подключение %d подключения %d подключений %s %s %s (обновление: %g с)
%s
%s (%s, сервер %s)
%s (обновление: %g с)
%s: %s
%s: -1 можно использовать только в неинтерактивном режиме
COPY FROM/TO не может работать с каталогом (%s)
%s: удалить переменную "%s" нельзя
%s: не удалось найти свой исполняемый файл
%s: не удалось открыть файл протокола "%s": %s
%s: не удалось установить параметр печати "%s"
%s: не удалось установить переменную "%s"
%s: текущая транзакция прервана
%s: неверное название кодировки символов или не найдена процедура перекодировки
%s: нет соединения с базой данных
%s: нехватка памяти
%s: неизвестное состояние транзакции
%s: предупреждение: лишний аргумент "%s" проигнорирован
(%lu строка) (%lu строки) (%lu строк) ***(Пошаговый режим: проверка команды)******************************************
%s
***(Enter - выполнение; x и Enter - отмена)**************
********* ЗАПРОС *********
%s
**************************
+ opt(%d) = |%s|
, кластеризованный , откладываемый , изначально отложенный , нерабочий , предикат (%s) , репликационный , табл. пространство "%s" Права доступа Без подключения к базе данных необходимо указывать все параметры подключения
Типы данных аргументов Получено асинхронное уведомление "%s" от серверного процесса с PID %d.
Получено асинхронное уведомление "%s" с сообщением-нагрузкой "%s" от серверного процесса с PID %d.
Атрибуты Имеющаяся справка:
Стиль границ: %d.
Пропускать RLS ошибка передачи данных COPY: %s Обработчик вызова Ошибка добавления ячейки в таблицу: превышен предел числа ячеек (%d).
Ошибка добавления заголовка таблицы: превышен предел числа столбцов (%d).
Вход запрещён Проверка Ограничения-проверки: Дочерние таблицы LC_COLLATE Столбец Права для столбцов Команда: %s
Описание: %s
Синтаксис:
%s
Составной тип "%s.%s" Соединение
Создаёт БД Создаёт роли LC_CTYPE БД Права доступа по умолчанию Строка итогов выключена.
Строка итогов включена.
По умолчанию? Определение Описание Назначение Словари Расширение "%s" не найдено.
Никакие расширения не найдены.
Отношение "%s" не найдено.
Отношение с OID %s не найдено.
Конфигурация текстового поиска "%s" не найдена.
Анализатор текстового поиска "%s" не найден.
Отключённые внутренние триггеры: Отключённые правила: Отключённые триггеры: Отключённые пользовательские триггеры: Элементы Включён Кодировка Окончание разбора Вводите данные для копирования, разделяя строки переводом строки.
Закончите ввод строкой '\.' или сигналом EOF. Повторите его: Введите новый пароль: Событие Расширенный вывод выключен.
Расширенный вывод включён.
Расширенный вывод применяется автоматически.
Параметры ОСД Параметр ОСД: (%s) неудачна.
Разделитель полей: "%s".
Разделитель полей - нулевой байт.
Сторонняя таблица "%s.%s" Обёртка сторонних данных Ограничения внешнего ключа: Форматирование
Функция Общие
Общие параметры:
Получение выдержки Получение следующего фрагмента Получение типов фрагментов Обработчик Содержит OID: да Справка
ID Неявное? Индекс Индекс "%s.%s" Индексы: Информационные
Наследует Инициализация Параметры инициализации Обработчик внедрённого кода Ввод/Вывод
Внутренний язык Внутреннее имя Прервано
Неверная команда \%s. Справка по командам: \?
Язык Большие объекты
Большие объекты Тип левого аргумента Выделение лексем Установлен стиль линий: %s.
Список методов доступа Список агрегатных функций Список приведений типов Список правил сортировки Список преобразований Список типов данных Список баз данных Список доменов Список событийных триггеров Список сторонних серверов Список сторонних таблиц Список обёрток сторонних данных Список функций Список установленных расширений Список языков Список операторов Список отношений Список ролей Список схем Список параметров Список специальных переменных
Список табличных пространств Список конфигураций текстового поиска Список словарей текстового поиска Список анализаторов текстового поиска Список шаблонов текстового поиска Список сопоставлений пользователей Локализованный вывод чисел выключен.
Локализованный вывод чисел включён.
Расположение Материализованное представление "%s.%s" Член ролей Метод Модификатор Модификаторы Имя Изменений нет Нет подключений Нет справки по команде "%s".
Попробуйте \h без аргументов и посмотрите, что есть.
Не наследуется Соответствующие отношения не найдены.
Соответствующие параметры не найдены.
Это версия сервера не поддерживает параметры ролей на уровне базы данных.
Отношения не найдены.
Параметры не найдены.
Null выводится как: "%s".
Дочерних таблиц: %d (чтобы просмотреть и их, воспользуйтесь \d+) Объект Описание объекта Описание объекта Объекты в расширении "%s" Операционная система
Параметры Формат вывода: %s.
Владелец: %s Владелец Постраничник используется всегда.
Постраничник используется для вывода длинного текста.
Постраничник выключен.
Постраничник не будет использоваться, если строк меньше %d
Постраничник не будет использоваться, если строк меньше %d
Постраничник не будет использоваться, если строк меньше %d
Параллельность Ошибка при шифровании пароля.
Пароль пользователя %s: Пароль действует до Пароль: Пароли не совпадают.
Политики Политики (усиленная защита строк включена): Политики (усиленная защита строк включена): (Нет) Политики (защита строк выключена): Политики (защита строк включена): (Нет) Политики: Сохранено предыдущее подключение
Процедура Буфер запроса
Буфер запроса пуст. Буфер запроса сброшен (очищен). Разделитель записей: "%s".
Разделитель записей: <новая строка>.
Разделитель записей - нулевой байт.
Ссылки извне: Идентификация реплики Репликация Об ошибках сообщайте по адресу <pgsql-bugs@postgresql.org>.
Тип данных результата Результирующий тип Тип правого аргумента Роль Имя роли Правила, срабатывающие всегда: Правила, срабатывающие только в реплике: Правила: SSL-соединение (протокол: %s, шифр: %s, бит: %s, сжатие: %s)
ОПЕРАТОР: %s
Схема Безопасность Последовательность "%s.%s" Сервер Сервер: %s Параметры Размер Источник Исходный код Исходный тип Специальное отношение "%s.%s" Начало разбора Цель для статистики Хранилище удачна.
Суперпользователь TOAST-таблица "%s.%s" Таблица Таблица "%s.%s" Атрибуты HTML-таблицы: "%s".
Атрибуты HTML-таблицы не заданы.
Табл. пространство Табличное пространство: "%s" Теги Целевой тип Ширина вывода: %d.
Ширина вывода сброшена.
Шаблон Конфигурация текстового поиска "%s" Конфигурация текстового поиска "%s.%s" Анализатор текстового поиска "%s" Анализатор текстового поиска "%s.%s" Подключение к серверу потеряно. Попытка восстановления Результат выдаётся в специальном формате выгрузки PostgreSQL.
Чтобы восстановить базу данных из этого формата, воспользуйтесь программой командной строки pg_restore.
Сервер (версия %s) не поддерживает методы доступа.
Сервер (версия %s) не поддерживает изменение прав по умолчанию.
Сервер (версия %s) не поддерживает правила сравнения.
Сервер (версия %s) не поддерживает редактирование исходного кода функции.
Сервер (версия %s) не поддерживает редактирование определения представления.
Сервер (версия %s) не поддерживает расширения.
Сервер (версия %s) не поддерживает сторонние серверы.
Сервер (версия %s) не поддерживает сторонние таблицы.
Сервер (версия %s) не поддерживает обёртки сторонних данных.
Сервер (версия %s) не поддерживает полнотекстовый поиск.
Сервер (версия %s) не поддерживает точки сохранения для ON_ERROR_ROLLBACK.
Сервер (версия %s) не поддерживает вывод исходного кода функции.
Сервер (версия %s) не поддерживает вывод определения представлений.
Сервер (версия %s) не поддерживает табличные пространства.
Сервер (версия %s) не поддерживает сопоставления пользователей.
Ошибки не было. Время: %.3f мс
Секундомер выключен. Секундомер включён. Заголовок: "%s".
Заголовок не задан.
Фрагмент Имя фрагмента Типы фрагментов для анализатора "%s" Типы фрагментов для анализатора "%s.%s" Триггеры, срабатывающие всегда: Триггеры, срабатывающие только в реплике: Триггеры: Доверенный Для дополнительной информации попробуйте "%s --help".
Режим вывода только кортежей выключен.
Режим вывода только кортежей включён.
Тип Введите "help", чтобы получить справку.
Азы: \copyright - условия распространения
\h - справка по операторам SQL
\? - справка по командам psql
\g или ; в конце строки - выполнение запроса
\q - выход
Типизированная таблица типа: %s Стиль Unicode-линий границ: "%s".
Стиль Unicode-линий столбцов: "%s".
Стиль Unicode-линий границ: "%s".
Нежурналируемый индекс "%s.%s" Нежурналируемое материализованное представление "%s.%s" Нежурналируемая таблица "%s.%s" Использование:
Чтобы выйти из %s, введите "\q".
Имя пользователя Функция проверки Значение Переменные
Версия Представление "%s.%s" Определение представления: Изменчивость ПРЕДУПРЕЖДЕНИЕ: %s имеет базовую версию %s, а сервер - %s.
Часть функций psql может не работать.
ПРЕДУПРЕЖДЕНИЕ: Кодовая страница консоли (%u) отличается от основной
страницы Windows (%u).
8-битовые (русские) символы могут отображаться некорректно.
Подробнее об этом смотрите документацию psql, раздел
"Notes for Windows users".
История записана в файл "%s".
Вы подключены к базе данных "%s" как пользователь "%s" (сервер "%s", порт "%s").
Вы подключены к базе данных "%s" как пользователь "%s" через сокет в "%s", порт "%s".
В данный момент вы не подключены к базе данных.
Вы подключены к базе данных "%s" как пользователь "%s" (сервер "%s", порт "%s").
Вы подключены к базе данных "%s" как пользователь "%s" через сокет в "%s", порт "%s".
Вы подключены к базе данных "%s" как пользователь "%s".
Вы используете psql - интерфейс командной строки к PostgreSQL. \!: ошибка
\%s: не удалось перейти в каталог "%s": %s
\%s: имя переменной окружения не может содержать знак "="
\%s: не удалось установить переменную
\%s: лишний аргумент "%s" пропущен
отсутствует необходимый аргумент \%s
\connect: %s укажите аргументы \copy
\copy: ошибка разбора аргумента "%s"
\copy: ошибка разбора в конце строки
\crosstabview: неоднозначное имя столбца: "%s"
\crosstabview: имя столбца не найдено: "%s"
\crosstabview: номер столбца %d выходит за рамки диапазона 1..%d
\crosstabview: когда запрос возвращает больше трёх столбцов, необходимо указать столбец данных
\crosstabview: превышен максимум числа столбцов (%d)
\crosstabview: запрос должен возвращать минимум три столбца
\crosstabview: в результатах запроса содержится несколько значений данных для строки "%s", столбца "%s"
\crosstabview: оператор не возвратил результирующий набор
\crosstabview: для вертикальных и горизонтальных заголовков должны задаваться разные столбцы
\df не поддерживает параметр "w" с сервером версии %s
\df принимает в качестве параметров только [antwS+]
\pset: допустимые стили Unicode-линий границ: single, double
\pset: допустимые стили Unicode-линий столбцов: single, double
\pset: допустимые стили Unicode-линий заголовков: single, double
\pset: допустимые форматы: unaligned, aligned, wrapped, html, asciidoc, latex, latex-longtable, troff-ms
\pset: допустимые стили линий: ascii, old-ascii, unicode
неизвестный параметр \pset: %s
\watch нельзя использовать с COPY
\watch нельзя использовать с пустым запросом
предложение_GRANT_или_REVOKE прервать текущую транзакцию прерывание из-за ошибки чтения тип_метода_доступа действие агр. имя_агр_функции сигнатура_агр_функции псевдоним выравнивание разр_подключения всегда функция_анализа и сигнатура_агр_функции: а допустимое действие_при_конфликте: где допустимый элемент_группирования: и параметр_порождения: и ограничение_таблицы: и ограничение_таблицы_с_индексом: и запрос_WITH: тип_данных_аргумента имя_аргумента тип_аргумента режим_аргумента имя_аргумента тип_аргумента аргумент тип_аргумента аргументы попытка выполнить \gset со специальной переменной "%s" игнорируется
атрибут имя_атрибута атрибут базовый_тип логическое_значение кеш обработчик_вызова отменить транзакцию, подготовленную ранее для двухфазной фиксации отменено пользователем попытка дублирования нулевого указателя (внутренняя ошибка)
экранирование строк не работает без подключения к БД
каноническая_функция категория изменить атрибуты базы данных изменить роль пользователя БД изменить параметр выполнения изменить параметр конфигурации сервера изменить имя роли или членство изменить определение правила сортировки изменить определение преобразования изменить определение домена изменить определение стороннего сервера изменить определение сторонней таблицы изменить определение обёртки сторонних данных изменить определение функции изменить определение большого объекта изменить определение материализованного представления изменить определение процедурного языка изменить определение политики защиты на уровне строк изменить определение правила изменить определение схемы изменить определение генератора последовательности изменить определение таблицы изменить определение табличного пространства изменить определение конфигурации текстового поиска изменить определение словаря текстового поиска изменить определение анализатора текстового поиска изменить определение шаблона текстового поиска изменить определение триггера изменить определение типа изменить сопоставление пользователей изменить определение представления изменить определение агрегатной функции изменить определение событийного триггера изменить определение расширения изменить определение индекса изменить определение оператора изменить определение класса операторов изменить определение семейства операторов изменить владельца объектов БД, принадлежащих заданной роли канал выражение_проверки дочерний процесс завершился с кодом возврата %d дочерний процесс завершился с нераспознанным состоянием %d дочерний процесс прерван исключением 0x%X дочерний процесс завершён по сигналу %d: %s закрыть курсор перегруппировать таблицу по индексу внедрённый_код сортируемый правило сортировки %s правило_сортировки собрать статистику о базе данных псевдоним_столбца ограничение_столбца определение_столбца имя_столбца тип_столбца коммут_оператор комбинирующая_функция команда неисполняемая команда команда не найдена зафиксировать транзакцию, ранее подготовленную для двухфазной фиксации зафиксировать текущую транзакцию получить набор строк условие параметр_конфигурации действие_при_конфликте объект_конфликта подключение к серверу было потеряно
предел_подключений ограничение имя_ограничения импорт/экспорт данных в файл не удалось перейти в каталог "%s": %s не удалось закрыть канал сообщений с внешней командой: %s
не удалось выполнить команду "%s": %s
не удалось найти запускаемый файл "%s" не удалось получить домашний каталог пользователя c ид. %ld: %s
не удалось определить текущий каталог: %s не удалось найти временный каталог: %s
выяснить эффективный идентификатор пользователя (%ld) не удалось: %s не удалось открыть временный файл "%s": %s
не удалось разобрать массив reloptions
не удалось прочитать исполняемый файл "%s" не удалось прочитать входной файл: %s
не удалось прочитать символическую ссылку "%s" не удалось сохранить историю в файле "%s": %s
не удалось установить переменную "%s"
не удалось запустить /bin/sh
не удалось запустить редактор "%s"
не удалось получить информацию о файле "%s": %s
не удалось записать данные COPY: %s
число создать базу данных добавить строки в таблицу имя_курсора тип_данных имя_БД освободить подготовленный оператор по_умолчанию DEFAULT %s выражение_по_умолчанию создать курсор создать новый метод доступа создать агрегатную функцию создать приведение типов создать правило сортировки создать тип данных создать роль пользователя БД создать домен создать преобразование кодировки создать событийный триггер создать сторонний сервер создать стороннюю таблицу создать обёртку сторонних данных создать функцию создать индекс создать сопоставление пользователя для стороннего сервера создать материализованное представление создать оператор создать класс операторов создать семейство операторов создать процедурный язык создать правило перезаписи создать новую политику защиты на уровне строк для таблицы определить новую точку сохранения в текущей транзакции создать схему создать генератор последовательностей создать таблицу создать таблицу из результатов запроса создать табличное пространство создать конфигурацию текстового поиска создать словарь текстового поиска создать анализатор текстового поиска создать шаблон текстового поиска создать преобразование создать триггер создать представление определить права доступа определить права доступа по умолчанию задать или изменить метку безопасности, применённую к объекту задать или изменить комментарий объекта определившего определение delete удалить записи таблицы разделитель символ_разделитель функция_десериализации целевая_кодировка удалить ранее определённую точку сохранения имя_словаря направление каталог отключён очистить состояние сеанса ограничение домена ограничение_домена имя_домена элемент опустошить таблицу или набор таблиц включён кодировка имя_кодировки функция_окончания в переменной окружения PSQL_EDITOR_LINENUMBER_ARG должен быть указан номер строки
спецсимвол событие объект_исключения объект_исключения в ограничении EXCLUDE: выполнить подготовленный оператор выполнить анонимный блок кода стоимость_выполнения существующее_правило_сортировки существующее_значение_перечисления выражение имя_расширения имя_семейства имя_обёртки_сторонних_данных функция_завершения имя_файла значение_фильтра переменная_фильтра для таблицы "%s.%s" произвести контрольную точку в журнале транзакций сторонняя таблица имя_формата источник_данных имя_функции_из_sql функция требуется имя функции
имя_функции произвести сборку мусора и проанализировать базу данных сгенерировать уведомление функция_выдачи_фрагмента имя_группы элемент_группирования функция_обработчик функция_создания_выдержек в данной среде история не поддерживается
постоянная импортировать определения таблиц со стороннего сервера в присваивании шаг индекс имя_столбца_индекса выражение_индекса метод_индекса имя_индекса параметры_индекса параметры_индекса в ограничениях UNIQUE, PRIMARY KEY и EXCLUDE: предикат_индекса функция_инициализации начальное_условие обработчик_внедрённого_кода функция_ввода insert установить расширение целое внутр_длина неверный исполняемый файл "%s" неверная команда \%s
неверный номер строки: %s
неверный формат вывода (внутренняя ошибка): %d вызывающего это_шаблон столбец_соединения условие_соединения процедура_соединения тип_соединения метка имя_языка oid_большого_объекта код_правила_сортировки код_классификации_символов тип_слева функция_выделения_лексем функция_лекс_типов параметр_порождения тип_образец символ_в_экспорте ожидать уведомления загрузить файл разделяемой библиотеки локальный сокет локальная_схема код_локали заблокировать таблицу режим_блокировки код_БО материализованное представление макс_значение элемент_объект метод функция_завершения_движ начальное_условие_движ мин_значение обратная_функция_движ сервер возвратил больше одной строки для \gset
функция_состояния_движ размер_данных_состояния_движ тип_данных_состояния_движ имя обратный_оператор новое_имя_атрибута новое_имя_столбца имя_нового_ограничения новый_словарь новое_значение_перечисления новое_имя новый_владелец новая_роль новая_схема новая_таблица новое_табл_пространство новая_версия нет нет буфера запросов
сервер не возвратил строк для \gset
обычная NOT NULL представление_NULL объектный_файл имя_объекта выкл. старый_словарь старая_роль старая_версия вкл. тип_операции класс_оператора оператор класс операторов семейство операторов имя_оператора параметр или старый синтаксис нехватка памяти нехватка памяти
выражение_результата функция_вывода имя_результата параметр таблица_родитель имя_анализатора пароль сообщение_нагрузка ошибка pclose: %s имя_политики установить курсор предикат предпочитаемый подготовить оператор для выполнения подготовить текущую транзакцию для двухфазной фиксации первичный ключ, провайдер psql - это интерактивный терминал PostgreSQL.
Переменные psql:
запрос символ_кавычек перестроить индексы функция_получения целевой_столбец ссылающаяся_таблица целевая_таблица имя_отношения удалённая_схема удалить приведение типа удалить правило сортировки удалить преобразование удалить тип данных удалить базу данных удалить роль пользователя БД удалить домен удалить описание стороннего сервера удалить стороннюю таблицу удалить обёртку сторонних данных удалить функцию удалить материализованное представление удалить процедурный язык удалить правило перезаписи удалить из таблицы политику защиты на уровне строк удалить схему удалить последовательность удалить таблицу удалить табличное пространство удалить конфигурацию текстового поиска удалить словарь текстового поиска удалить анализатор текстового поиска удалить шаблон текстового поиска удалить преобразование удалить триггер удалить сопоставление пользователя для стороннего сервера удалить представление удалить права доступа удалить метод доступа удалить агрегатную функцию удалить событийный триггер удалить расширение удалить индекс удалить оператор удалить класс операторов удалить семейство операторов удалить объекты базы данных, принадлежащие роли заменить содержимое материализованного представления реплика процедура_ограничения значение_перезапуска восстановить исходное значение параметра выполнения ограниченная строк_в_результате получить результат запроса через курсор выбрать строки из таблицы или представления тип_возврата имя_правила_перезаписи тип_справа имя_роли указание_роли откатиться к точке сохранения правило имя_правила безопасная метод_выборки имя_точки_сохранения элемент_схемы имя_схемы начальное_число select функция_отправки последовательность имя_последовательности функция_сериализации имя_сервера тип_сервера версия_сервера установить время проверки ограничений для текущей транзакции задать свойства текущей транзакции задать идентификатор текущего пользователя в текущем сеансе задать идентификатор пользователя сеанса и идентификатор текущего пользователя в текущем сеансе функция_состояния показать план выполнения оператора показать значение параметра выполнения рекурсивное расширение переменной "%s" пропускается
код_снимка выражение_сортировки семейство_сортировки оператор_сортировки исходная_конфигурация исходная_кодировка исходная_таблица исходный_тип спец. отношение стабильная начальное_значение начать транзакцию функция_начала размер_данных_состояния тип_данных_состояния оператор прекратить ожидание уведомлений хранение параметр_хранения тип_хранения номер_стратегии вложенный_SELECT подтип функция_различий_подтипа класс_оператора_подтипа номер_опорной_процедуры ошибка запроса Tab-дополнения: %s
Запрос:
%s
таблица ограничение таблицы ограничение_таблицы ограничение_таблицы_с_индексом имя_таблицы табл_пространство параметр_табл_пространства целевая_роль целевой_тип шаблон текст timestamp часовой_пояс имя_функции_в_sql тип_фрагмента код_транзакции режим_транзакции триггерная имя_триггера попытка выйти из режима копирования тип функция_ввода_модификатора_типа функция_вывода_модификатора_типа имя_типа uid неожиданное значение PQresultStatus: %d
неожиданное состояние результата для \watch
неожиданное состояние транзакции (%d)
уникальный, неизвестно нераспознанное значение "%s" для "%s"; подразумевается "%s"
небезопасная незавершённая строка в кавычках
update изменить строки таблицы пользователь не существует распознать имя пользователя не удалось (код ошибки: %lu) имя_пользователя выражение_использования функция_проверки функция_проверки значение значения версия представление требуется имя представления
имя_параметра_представления значение_параметра_представления изменчивая где допустимое предложение_GRANT_или_REVOKE: где допустимое действие: где сигнатура_агр_функции: где ограничение_столбца: где допустимый объект_конфликта: где ограничение: где допустимое направление пустое или: где допустимое событие: где допустимый источник_данных: где допустимый режим_блокировки: где элемент_объект: где допустимый параметр: где допустимые параметры: где допустимое указание_роли: где допустимый режим_транзакции: оконная определение_окна имя_окна запрос_WITH имя_запроса_WITH да locale/ru/LC_MESSAGES/pg_ctl-9.6.mo 0000644 00000055466 14751153420 0012357 0 ustar 00 �� � � � , 0 D 1 ? v � � & �
0
- O
}
�
= �
�
� ! � a � K 0 | A � ! � 3 � ? / H o D � C � E A ? � ? � > 9 F L � B � E � V 0 � F > S 8 � I � % 2 ; O n 7 � � � M - f ! � > � E � C ; y 9 � D 3 C x D � > A @ ( � , � 2 � 6 > B * � / � % � 1 0 4 # e � 4 � 2 � 1 0 A , r . � 3 � + " 1 N 6 � : � 1 � * $ " O 7 r " � $ � J � = Y 3 p 0 � � ! � $ ; - \ � 4 � % � $ ! " *! ! M! F o! u �! F ," s" 7 �" ) �" k �" ` U# % �# & �# $ d $ p$ / �$ & �$ 0 �$ . % - F% t% �% & �% �% , �% ( & ;& ! V& x& �& �& �& �& �& �& ' ' $' 4' " L' o' � �' � �) v * C �* �* G �* > 7+ B v+ W �+ " , 4, \ O, �, 3 �, � �, 3 �- � . � �. . 2/ g a/ ) �/ N �/ ` B0 g �0 y 1 Y �1 v �1 E V2 O �2 \ �2 Q I3 � �3 { }4 U �4 � O5 C 6 | `6 p �6 J N7 � �7 G 8 L g8 � �8 h x9 �9 �9 ) �9 � ): K �: 0
; { >; � �; � T< �< k �= e> � �> � g? � �? { x@ = �@ a 2A c �A h �A o aB L �B L C = kC ` �C T
D C _D 9 �D f �D g DE ] �E `
F J kF Z �F n G < �G S �G X H V jH u �H e 7I R �I 2 �I f #J 9 �J G �J � K ' �K ' �K ^ �K c CL 5 �L - �L > M < JM T �M �M h �M > eN > �N < �N < O � ]O � �O t �P " Q X ;Q I �Q � �Q � �R M ^S [ �S T � %T 2 �T p U V �U l �U J KV K �V ) �V " W = /W C mW Z �W J X K WX S �X 5 �X -Y LY 2 dY " �Y , �Y / �Y Z $ 4Z " YZ B |Z D �Z 1 [ P W � , � ` n m $ p � ~ < A 9 T ! : M D a G 2 E I { c # d � K | � � Q & ) 8 B 4 _ > f � y ( v L [ h \ ^ Z � 5 X R C F O } + � r � ] u w Y
e � x
7 / k - 0 � q 1 � b j ; 6 t g � N " @ U z H J . � ? s V � % S = � l ' * o 3 i �
%s: -w option cannot use a relative socket directory specification
%s: -w option is not supported when starting a pre-9.1 server
Allowed signal names for kill:
Common options:
Options for register and unregister:
Options for start or restart:
Options for stop or restart:
Report bugs to <pgsql-bugs@postgresql.org>.
Shutdown modes are:
Start types are:
%s init[db] [-D DATADIR] [-s] [-o "OPTIONS"]
%s kill SIGNALNAME PID
%s promote [-D DATADIR] [-s]
%s register [-N SERVICENAME] [-U USERNAME] [-P PASSWORD] [-D DATADIR]
[-S START-TYPE] [-w] [-t SECS] [-o "OPTIONS"]
%s reload [-D DATADIR] [-s]
%s restart [-w] [-t SECS] [-D DATADIR] [-s] [-m SHUTDOWN-MODE]
[-o "OPTIONS"]
%s start [-w] [-t SECS] [-D DATADIR] [-s] [-l FILENAME] [-o "OPTIONS"]
%s status [-D DATADIR]
%s stop [-W] [-t SECS] [-D DATADIR] [-s] [-m SHUTDOWN-MODE]
%s unregister [-N SERVICENAME]
-?, --help show this help, then exit
-D, --pgdata=DATADIR location of the database storage area
-N SERVICENAME service name with which to register PostgreSQL server
-P PASSWORD password of account to register PostgreSQL server
-S START-TYPE service start type to register PostgreSQL server
-U USERNAME user name of account to register PostgreSQL server
-V, --version output version information, then exit
-W do not wait until operation completes
-c, --core-files allow postgres to produce core files
-c, --core-files not applicable on this platform
-e SOURCE event source for logging when running as a service
-l, --log=FILENAME write (or append) server log to FILENAME
-m, --mode=MODE MODE can be "smart", "fast", or "immediate"
-o OPTIONS command line options to pass to postgres
(PostgreSQL server executable) or initdb
-p PATH-TO-POSTGRES normally not necessary
-s, --silent only print errors, no informational messages
-t, --timeout=SECS seconds to wait when using -w option
-w wait until operation completes
auto start service automatically during system startup (default)
demand start service on demand
fast quit directly, with proper shutdown
immediate quit without complete shutdown; will lead to recovery on restart
smart quit after all clients have disconnected
done
failed
stopped waiting
%s is a utility to initialize, start, stop, or control a PostgreSQL server.
%s: -S option not supported on this platform
%s: PID file "%s" does not exist
%s: WARNING: cannot create restricted tokens on this platform
%s: WARNING: could not locate all job object functions in system API
%s: another server might be running; trying to start server anyway
%s: cannot be run as root
Please log in (using, e.g., "su") as the (unprivileged) user that will
own the server process.
%s: cannot promote server; server is not in standby mode
%s: cannot promote server; single-user server is running (PID: %ld)
%s: cannot reload server; single-user server is running (PID: %ld)
%s: cannot restart server; single-user server is running (PID: %ld)
%s: cannot set core file size limit; disallowed by hard limit
%s: cannot stop server; single-user server is running (PID: %ld)
%s: could not access directory "%s": %s
%s: could not allocate SIDs: error code %lu
%s: could not create promote signal file "%s": %s
%s: could not create restricted token: error code %lu
%s: could not determine the data directory using command "%s"
%s: could not find own program executable
%s: could not find postgres program executable
%s: could not open PID file "%s": %s
%s: could not open process token: error code %lu
%s: could not open service "%s": error code %lu
%s: could not open service manager
%s: could not read file "%s"
%s: could not register service "%s": error code %lu
%s: could not remove promote signal file "%s": %s
%s: could not send promote signal (PID: %ld): %s
%s: could not send reload signal (PID: %ld): %s
%s: could not send signal %d (PID: %ld): %s
%s: could not send stop signal (PID: %ld): %s
%s: could not start server
Examine the log output.
%s: could not start server: %s
%s: could not start server: error code %lu
%s: could not start service "%s": error code %lu
%s: could not unregister service "%s": error code %lu
%s: could not wait for server because of misconfiguration
%s: could not write promote signal file "%s": %s
%s: database system initialization failed
%s: directory "%s" does not exist
%s: directory "%s" is not a database cluster directory
%s: invalid data in PID file "%s"
%s: missing arguments for kill mode
%s: no database directory specified and environment variable PGDATA unset
%s: no operation specified
%s: no server running
%s: old server process (PID: %ld) seems to be gone
%s: option file "%s" must have exactly one line
%s: server does not shut down
%s: server is running (PID: %ld)
%s: service "%s" already registered
%s: service "%s" not registered
%s: single-user server is running (PID: %ld)
%s: the PID file "%s" is empty
%s: too many command-line arguments (first is "%s")
%s: unrecognized operation mode "%s"
%s: unrecognized shutdown mode "%s"
%s: unrecognized signal name "%s"
%s: unrecognized start type "%s"
(The default is to wait for shutdown, but not for start or restart.)
HINT: The "-m fast" option immediately disconnects sessions rather than
waiting for session-initiated disconnection.
If the -D option is omitted, the environment variable PGDATA is used.
Is server running?
Please terminate the single-user server and try again.
Server started and accepting connections
The program "%s" is needed by %s but was not found in the
same directory as "%s".
Check your installation.
The program "%s" was found by "%s"
but was not the same version as %s.
Check your installation.
Timed out waiting for server startup
Try "%s --help" for more information.
Usage:
WARNING: online backup mode is active
Shutdown will not complete until pg_stop_backup() is called.
Waiting for server startup...
cannot duplicate null pointer (internal error)
child process exited with exit code %d child process exited with unrecognized status %d child process was terminated by exception 0x%X child process was terminated by signal %d: %s command not executable command not found could not change directory to "%s": %s could not find a "%s" to execute could not get current working directory: %s
could not identify current directory: %s could not read binary "%s" could not read symbolic link "%s" invalid binary "%s" out of memory
pclose failed: %s server is still starting up
server promoting
server shutting down
server signaled
server started
server starting
server stopped
starting server anyway
waiting for server to shut down... waiting for server to start... Project-Id-Version: pg_ctl (PostgreSQL current)
Report-Msgid-Bugs-To: pgsql-bugs@postgresql.org
POT-Creation-Date: 2020-08-10 10:44+0300
PO-Revision-Date: 2021-08-14 07:35+0300
Last-Translator: Alexander Lakhin <exclusion@gmail.com>
Language-Team: Russian <pgsql-ru-general@postgresql.org>
Language: ru
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Plural-Forms: nplurals=3; plural=(n%10==1 && n%100!=11 ? 0 : n%10>=2 && n%10<=4 && (n%100<10 || n%100>=20) ? 1 : 2);
%s: в параметре -w нельзя указывать относительный путь к каталогу сокетов
%s: параметр -w не поддерживается при запуске сервера до версии 9.1
Разрешённые сигналы для команды kill:
Общие параметры:
Параметры для регистрации и удаления:
Параметры запуска и перезапуска:
Параметры остановки и перезапуска:
Об ошибках сообщайте по адресу <pgsql-bugs@postgresql.org>.
Режимы остановки:
Типы запуска:
%s init[db] [-D КАТАЛОГ-ДАННЫХ] [-s] [-o "ПАРАМЕТРЫ"]
%s kill СИГНАЛ PID
%s promote [-D КАТАЛОГ-ДАННЫХ] [-s]
%s register [-N ИМЯ-СЛУЖБЫ] [-U ПОЛЬЗОВАТЕЛЬ] [-P ПАРОЛЬ]
[-D КАТАЛОГ-ДАННЫХ] [-S ТИП-ЗАПУСКА] [-w] [-t СЕК]
[-o "ПАРАМЕТРЫ"]
%s reload [-D КАТАЛОГ-ДАННЫХ] [-s]
%s restart [-w] [-t СЕК] [-D КАТАЛОГ-ДАННЫХ] [-s] [-m РЕЖИМ-ОСТАНОВКИ]
[-o "ПАРАМЕТРЫ"]
%s start [-w] [-t СЕК] [-D КАТАЛОГ-ДАННЫХ] [-s] [-l ИМЯ-ФАЙЛА]
[-o "ПАРАМЕТРЫ"]
%s status [-D КАТАЛОГ-ДАННЫХ]
%s stop [-W] [-t СЕК] [-D КАТАЛОГ-ДАННЫХ] [-s] [-m РЕЖИМ-ОСТАНОВКИ]
%s unregister [-N ИМЯ-СЛУЖБЫ]
-?, --help показать эту справку и выйти
-D, --pgdata=КАТАЛОГ расположение хранилища баз данных
-N ИМЯ-СЛУЖБЫ имя службы для регистрации сервера PostgreSQL
-P ПАРОЛЬ пароль учётной записи для регистрации сервера PostgreSQL
-S ТИП-ЗАПУСКА тип запуска службы сервера PostgreSQL
-U ПОЛЬЗОВАТЕЛЬ имя пользователя для регистрации сервера PostgreSQL
-V, --version показать версию и выйти
-W не ждать завершения операции
-c, --core-files указать postgres создавать дампы памяти
-c, --core-files неприменимо на этой платформе
-e ИСТОЧНИК источник событий, устанавливаемый при записи в журнал,
когда сервер работает в виде службы
-l, --log=ФАЙЛ записывать (или добавлять) протокол сервера в ФАЙЛ.
-m, --mode=РЕЖИМ может быть "smart", "fast" или "immediate"
-o ПАРАМЕТРЫ параметры командной строки для postgres
(исполняемого файла сервера PostgreSQL) или initdb
-p ПУТЬ-К-POSTGRES обычно не требуется
-s, --silent выводить только ошибки, без информационных сообщений
-t, --timeout=СЕК время ожидания при использовании параметра -w
-w ждать завершения операции
auto запускать службу автоматически при старте системы (по умолчанию)
demand запускать службу по требованию
fast закончить сразу, в штатном режиме
immediate закончить немедленно, в экстренном режиме; влечёт за собой
восстановление при перезапуске
smart закончить работу после отключения всех клиентов
готово
ошибка
прекращение ожидания
%s - это утилита для инициализации, запуска, остановки и управления сервером PostgreSQL.
%s: параметр -S не поддерживается в этой ОС
%s: файл PID "%s" не существует
%s: ПРЕДУПРЕЖДЕНИЕ: в этой ОС нельзя создавать ограниченные маркеры
%s: ПРЕДУПРЕЖДЕНИЕ: не удалось найти все функции для работы с задачами в системном API
%s: возможно, уже работает другой сервер; всё же пробуем запустить этот сервер
Запускать %s от имени root нельзя.
Пожалуйста, переключитесь на обычного пользователя (например,
используя "su"), который будет запускать серверный процесс.
%s: повысить сервер нельзя - он работает не в режиме резерва
%s: повысить сервер с PID %ld нельзя - он выполняется в монопольном режиме
%s: перезагрузить сервер с PID %ld нельзя - он запущен в монопольном режиме
%s: перезапустить сервер с PID %ld нельзя - он запущен в монопольном режиме
%s: не удалось ограничить размер дампа памяти; запрещено жёстким ограничением
%s: остановить сервер с PID %ld нельзя - он запущен в монопольном режиме
%s: ошибка доступа к каталогу "%s": %s
%s: не удалось подготовить структуры SID (код ошибки: %lu)
%s: не удалось создать файл "%s" с сигналом к повышению: %s
%s: не удалось создать ограниченный маркер (код ошибки: %lu)
%s: не удалось определить каталог данных с помощью команды "%s"
%s: не удалось найти свой исполняемый файл
%s: не удалось найти исполняемый файл postgres
%s: не удалось открыть файл PID "%s": %s
%s: не удалось открыть маркер процесса (код ошибки: %lu)
%s: не удалось открыть службу "%s" (код ошибки: %lu)
%s: не удалось открыть менеджер служб
%s: не удалось прочитать файл "%s"
%s: не удалось зарегистрировать службу "%s" (код ошибки: %lu)
%s: ошибка при удалении файла "%s" с сигналом к повышению: %s
%s: не удалось отправить сигнал к повышению (PID: %ld): %s
%s: не удалось отправить сигнал перезагрузки (PID: %ld): %s
%s: не удалось отправить сигнал %d (PID: %ld): %s
%s: не удалось отправить сигнал остановки (PID: %ld): %s
%s: не удалось запустить сервер
Изучите протокол выполнения.
%s: не удалось запустить сервер: %s
%s: не удалось запустить сервер (код ошибки: %lu)
%s: не удалось запустить службу "%s" (код ошибки: %lu)
%s: ошибка при удалении службы "%s" (код ошибки: %lu)
%s: не удалось дождаться сервера вследствие ошибки конфигурации
%s: не удалось записать файл "%s" с сигналом к повышению: %s
%s: сбой при инициализации системы баз данных
%s: каталог "%s" не существует
%s: каталог "%s" не содержит структуры кластера баз данных
%s: неверные данные в файле PID "%s"
%s: отсутствуют аргументы для режима kill
%s: каталог баз данных не указан и переменная окружения PGDATA не установлена
%s: команда не указана
%s: сервер не работает
%s: похоже, что старый серверный процесс (PID: %ld) исчез
%s: в файле параметров "%s" должна быть ровно одна строка
%s: сервер не останавливается
%s: сервер работает (PID: %ld)
%s: служба "%s" уже зарегистрирована
%s: служба "%s" не зарегистрирована
%s: сервер работает в монопольном режиме (PID: %ld)
%s: файл PID "%s" пуст
%s: слишком много аргументов командной строки (первый: "%s")
%s: нераспознанный режим работы "%s"
%s: неизвестный режим остановки "%s"
%s: нераспознанное имя сигнала "%s"
%s: нераспознанный тип запуска "%s"
(По умолчанию ожидание имеет место при остановке, но не при (пере)запуске.)
ПОДСКАЗКА: Параметр "-m fast" может сбросить сеансы принудительно,
не дожидаясь, пока они завершатся сами.
Если параметр -D опущен, используется переменная окружения PGDATA.
Запущен ли сервер?
Пожалуйста, остановите его и повторите попытку.
Сервер запущен и принимает подключения
Программа "%s" нужна для %s, но она не найдена
в каталоге "%s".
Проверьте правильность установки СУБД.
Программа "%s" найдена программой "%s",
но её версия отличается от версии %s.
Проверьте правильность установки СУБД.
Превышено время ожидания запуска сервера
Для дополнительной информации попробуйте "%s --help".
Использование:
ПРЕДУПРЕЖДЕНИЕ: активен режим копирования "на ходу"
Выключение произойдёт только при вызове pg_stop_backup().
Ожидание запуска сервера...
попытка дублирования нулевого указателя (внутренняя ошибка)
дочерний процесс завершился с кодом возврата %d дочерний процесс завершился с нераспознанным состоянием %d дочерний процесс прерван исключением 0x%X дочерний процесс завершён по сигналу %d: %s неисполняемая команда команда не найдена не удалось перейти в каталог "%s": %s не удалось найти запускаемый файл "%s" не удалось определить текущий рабочий каталог: %s
не удалось определить текущий каталог: %s не удалось прочитать исполняемый файл "%s" не удалось прочитать символическую ссылку "%s" неверный исполняемый файл "%s" нехватка памяти
ошибка pclose: %s сервер всё ещё запускается
сервер повышается
сервер останавливается
сигнал отправлен серверу
сервер запущен
сервер запускается
сервер остановлен
сервер запускается, несмотря на это
ожидание завершения работы сервера... ожидание запуска сервера... locale/ru/LC_MESSAGES/pgscripts-9.6.mo 0000644 00000100703 14751153420 0013106 0 ustar 00 �� � � � @ K A �
� > � > � = , - j � � C 0 A t � � # � ( I I f E � � > v ; � = � : / < j 9 � 6 � 5 C N C � 9 � 4 E E = � . � ; � E 4 : z ? � A � < 7 9 t 7 � 4 � L J h 3 � H � E 0 B v A � 5 � 2 1 N d 7 � 2 � 2 J Q : � 5 � G
0 U < � 0 � ) � M J l G � 4 � C 4! H x! E �! D " = L" v �" < # � ># Q �# I $ @ ^$ 5 �$ 4 �$ 1
% 0 <% ; m% 5 �% ' �% 6 & 3 >& 9 r& @ �& ; �& ; )' ` e' 8 �' 2 �' 9 2( 6 l( > �( �( / �( < ) # [) # ) ? �) 8 �) % * # B* f* 3 �* & �* �* E �* 6 .+ E e+ F �+ K �+ 7 >, K v, 7 �, J �, 6 E- < |- D �- 5 �- 4. * R. 8 }. 6 �. ( �. 4 / $ K/ # p/ �/ �/ - �/ 8 0 4 <0 $ q0 �0 , �0 , �0 ( 1 / 91 ; i1 9 �1 ! �1 2 \ 2 s2 �2 * �2 8 �2 9 3 , B3 8 o3 # �3 4 �3 . 4 04 ) M4 7 w4 �4
�4 �4 C �4 A +5 ! m5 + �5 �5 �5 �5 6 . #6 3 R6 2 �6 �6 �6 �6
�6 �6 7 )7 ' >7 " f7 2 �7 7 �7 �7 & �7 $8 ,8 / C8 + s8 * �8 �8 �8 �8 �8 �8 �8 9 9 ( +9 T9 V9 Z9 � \; , �; < � !< � �< v '= W �= �= ^ �> \ Z? �? �? 2 �? ) '@ < Q@ - �@ j �@ m 'A � �A X oB U �B c C ^ �C W �C T 9D Q �D P �D v 1E � �E Q 3F W �F x �F H VG N �G X �G r GH P �H m I ~ yI s �I j lJ r �J o JK � �K � jL n "M N �M K �M H ,N G uN ? �N < �N � :O P �O I 6P \ �P � �P Z zQ a �Q m 7R ` �R j S R qS - �S o �S l bT i �T S 9U c �U q �U n cV m �V j @W � �W U hX � �X { �Y b �Y O `Z x �Z O )[ L y[ K �[ K \ T ^\ S �\ ^ ] d f] p �] q <^ s �^ y "_ � �_ a `` [ �` H a E ga a �a b O +b } {b 5 �b A /c n qc S �c E 4d 5 zd ( �d O �d R )e |e x �e m �e � jf � �f � �g q !h � �h o *i � �i s 5j x �j y "k n �k - l F 9l ] �l q �l C Pm ` �m T �m 3 Jn @ ~n B �n P o N So ` �o N p J Rp a �p ` �p T `q a �q D r F \r 6 �r ? �r � s �s < t Y Lt U �t _ �t b \u c �u : #v h ^v � �v . Lw G {w Q �w 6 x Lx - gx | �x � y D �y O �y -z + Iz 3 uz 8 �z o �z l R{ q �{ 1| C| 7 J| �| & �| 7 �| ! �| B } i U} ` �} ` ~ �~ [ �~ �~ * p ; y � R &� y� {� - �� �� ŀ * � � 2 %� c X� �� �� � Z 9 � � t � � � I S � w & % � � � � G � � - . � � X � { � " � 7 � o � � < � � � L � 4 / K i u � J � ~ B m � ( � � * �
n f H p � # D g @ ' > � � U � v � x [ � 3
N � � k ! � 8 , � Y F ; � � z � � � T � � 6 r M � + a 2 W � � $ ] _ � � } = s � j � � ? � ` � c | � l \ V � � � � � E ) : q � � Q C b 1 0 h A y � d R � ^ O � � � � � � � 5 � � � e P
By default, a database with the same name as the current user is created.
Connection options:
Options:
Read the description of the SQL command CLUSTER for details.
Read the description of the SQL command REINDEX for details.
Read the description of the SQL command VACUUM for details.
Report bugs to <pgsql-bugs@postgresql.org>.
--analyze-in-stages only update optimizer statistics, in multiple
stages for faster results; no vacuum
--lc-collate=LOCALE LC_COLLATE setting for the database
--lc-ctype=LOCALE LC_CTYPE setting for the database
%s [OPTION]...
%s [OPTION]... DBNAME
%s [OPTION]... LANGNAME [DBNAME]
%s [OPTION]... [DBNAME]
%s [OPTION]... [DBNAME] [DESCRIPTION]
%s [OPTION]... [ROLENAME]
--if-exists don't report error if database doesn't exist
--if-exists don't report error if user doesn't exist
--interactive prompt for missing role name and attributes rather
than using defaults
--maintenance-db=DBNAME alternate maintenance database
--maintenance-db=DBNAME alternate maintenance database
--no-replication role cannot initiate replication
--replication role can initiate replication
-?, --help show this help, then exit
-?, --help show this help, then exit
-?, --help show this help, then exit
-?, --help show this help, then exit
-D, --no-createdb role cannot create databases (default)
-D, --tablespace=TABLESPACE default tablespace for the database
-E, --encoding=ENCODING encoding for the database
-E, --encrypted encrypt stored password
-F, --freeze freeze row transaction information
-I, --no-inherit role does not inherit privileges
-L, --no-login role cannot login
-N, --unencrypted do not encrypt stored password
-O, --owner=OWNER database user to own the new database
-P, --pwprompt assign a password to new role
-R, --no-createrole role cannot create roles (default)
-S, --no-superuser role will not be superuser (default)
-S, --schema=SCHEMA reindex specific schema(s) only
-T, --template=TEMPLATE template database to copy
-U, --username=USERNAME user name to connect as
-U, --username=USERNAME user name to connect as
-U, --username=USERNAME user name to connect as (not the one to create)
-U, --username=USERNAME user name to connect as (not the one to drop)
-U, --username=USERNAME user name to connect as
-V, --version output version information, then exit
-V, --version output version information, then exit
-V, --version output version information, then exit
-V, --version output version information, then exit
-W, --password force password prompt
-W, --password force password prompt
-Z, --analyze-only only update optimizer statistics; no vacuum
-a, --all vacuum all databases
-a, --all cluster all databases
-a, --all reindex all databases
-c, --connection-limit=N connection limit for role (default: no limit)
-d, --createdb role can create new databases
-d, --dbname=DBNAME database to vacuum
-d, --dbname=DBNAME database from which to remove the language
-d, --dbname=DBNAME database to cluster
-d, --dbname=DBNAME database to install language in
-d, --dbname=DBNAME database to reindex
-d, --dbname=DBNAME database name
-e, --echo show the commands being sent to the server
-e, --echo show the commands being sent to the server
-e, --echo show the commands being sent to the server
-f, --full do full vacuuming
-g, --role=ROLE new role will be a member of this role
-h, --host=HOSTNAME database server host or socket directory
-h, --host=HOSTNAME database server host or socket directory
-h, --host=HOSTNAME database server host or socket directory
-i, --index=INDEX recreate specific index(es) only
-i, --inherit role inherits privileges of roles it is a
member of (default)
-i, --interactive prompt before deleting anything
-i, --interactive prompt before deleting anything, and prompt for
role name if not specified
-j, --jobs=NUM use this many concurrent connections to vacuum
-l, --list show a list of currently installed languages
-l, --locale=LOCALE locale settings for the database
-l, --login role can login (default)
-p, --port=PORT database server port
-p, --port=PORT database server port
-p, --port=PORT database server port
-q, --quiet don't write any messages
-q, --quiet don't write any messages
-q, --quiet run quietly
-r, --createrole role can create new roles
-s, --superuser role will be superuser
-s, --system reindex system catalogs only
-t, --table='TABLE[(COLUMNS)]' vacuum specific table(s) only
-t, --table=TABLE cluster specific table(s) only
-t, --table=TABLE reindex specific table(s) only
-t, --timeout=SECS seconds to wait when attempting connection, 0 disables (default: %s)
-v, --verbose write a lot of output
-v, --verbose write a lot of output
-w, --no-password never prompt for password
-w, --no-password never prompt for password
-z, --analyze update optimizer statistics
%s (%s/%s) %s cleans and analyzes a PostgreSQL database.
%s clusters all previously clustered tables in a database.
%s creates a PostgreSQL database.
%s creates a new PostgreSQL role.
%s installs a procedural language into a PostgreSQL database.
%s issues a connection check to a PostgreSQL database.
%s reindexes a PostgreSQL database.
%s removes a PostgreSQL database.
%s removes a PostgreSQL role.
%s removes a procedural language from a database.
%s: "%s" is not a valid encoding name
%s: %s %s: cannot cluster all databases and a specific one at the same time
%s: cannot cluster specific table(s) in all databases
%s: cannot reindex all databases and a specific one at the same time
%s: cannot reindex all databases and system catalogs at the same time
%s: cannot reindex specific index(es) and system catalogs at the same time
%s: cannot reindex specific index(es) in all databases
%s: cannot reindex specific schema(s) and system catalogs at the same time
%s: cannot reindex specific schema(s) in all databases
%s: cannot reindex specific table(s) and system catalogs at the same time
%s: cannot reindex specific table(s) in all databases
%s: cannot use the "%s" option when performing only analyze
%s: cannot vacuum all databases and a specific one at the same time
%s: cannot vacuum specific table(s) in all databases
%s: clustering database "%s"
%s: clustering of database "%s" failed: %s %s: clustering of table "%s" in database "%s" failed: %s %s: comment creation failed (database was created): %s %s: could not connect to database %s: %s %s: could not connect to database %s: out of memory
%s: could not fetch default options
%s: creation of new role failed: %s %s: database creation failed: %s %s: database removal failed: %s %s: invalid value for --connection-limit: %s
%s: language "%s" is already installed in database "%s"
%s: language "%s" is not installed in database "%s"
%s: language installation failed: %s %s: language removal failed: %s %s: missing required argument database name
%s: missing required argument language name
%s: missing required argument role name
%s: number of parallel jobs must be at least 1
%s: only one of --locale and --lc-collate can be specified
%s: only one of --locale and --lc-ctype can be specified
%s: processing database "%s": %s
%s: query failed: %s %s: query returned %d row instead of one: %s
%s: query returned %d rows instead of one: %s
%s: query was: %s
%s: reindexing database "%s"
%s: reindexing of database "%s" failed: %s %s: reindexing of index "%s" in database "%s" failed: %s %s: reindexing of schema "%s" in database "%s" failed: %s %s: reindexing of system catalogs failed: %s %s: reindexing of table "%s" in database "%s" failed: %s %s: removal of role "%s" failed: %s %s: too many command-line arguments (first is "%s")
%s: too many jobs for this platform -- try %d
%s: vacuuming database "%s"
%s: vacuuming of database "%s" failed: %s %s: vacuuming of table "%s" in database "%s" failed: %s (%lu row) (%lu rows) Are you sure? Cancel request sent
Cannot add cell to table content: total cell count of %d exceeded.
Cannot add header to table content: column count of %d exceeded.
Could not send cancel request: %s Database "%s" will be permanently removed.
Enter it again: Enter name of role to add: Enter name of role to drop: Enter password for new role: Generating default (full) optimizer statistics Generating medium optimizer statistics (10 targets) Generating minimal optimizer statistics (1 target) Interrupted
Name Password encryption failed.
Password: Passwords didn't match.
Please answer "%s" or "%s".
Procedural Languages Role "%s" will be permanently removed.
Shall the new role be a superuser? Shall the new role be allowed to create databases? Shall the new role be allowed to create more new roles? Trusted? Try "%s --help" for more information.
Usage:
accepting connections
cannot duplicate null pointer (internal error)
could not look up effective user ID %ld: %s invalid output format (internal error): %d n no no attempt
no response
out of memory
rejecting connections
unknown
user does not exist user name lookup failure: error code %lu y yes Project-Id-Version: pgscripts (PostgreSQL current)
Report-Msgid-Bugs-To: pgsql-bugs@postgresql.org
POT-Creation-Date: 2021-11-08 05:27+0300
PO-Revision-Date: 2021-11-08 05:30+0300
Last-Translator: Alexander Lakhin <exclusion@gmail.com>
Language-Team: Russian <pgsql-ru-general@postgresql.org>
Language: ru
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Plural-Forms: nplurals=3; plural=(n%10==1 && n%100!=11 ? 0 : n%10>=2 && n%10<=4 && (n%100<10 || n%100>=20) ? 1 : 2);
По умолчанию именем базы данных считается имя текущего пользователя.
Параметры подключения:
Параметры:
Подробнее о кластеризации вы можете узнать в описании SQL-команды CLUSTER.
Подробнее о переиндексации вы можете узнать в описании SQL-команды REINDEX.
Подробнее об очистке вы можете узнать в описании SQL-команды VACUUM.
Об ошибках сообщайте по адресу <pgsql-bugs@postgresql.org>.
--analyze-in-stages только пересчитать статистику для оптимизатора
(в несколько проходов для большей скорости), без очистки
--lc-collate=ЛОКАЛЬ параметр LC_COLLATE для базы данных
--lc-ctype=ЛОКАЛЬ параметр LC_CTYPE для базы данных
%s [ПАРАМЕТР]...
%s [ПАРАМЕТР]... БД
%s [ПАРАМЕТР]... ЯЗЫК [ИМЯ_БД]
%s [ПАРАМЕТР]... [ИМЯ_БД]
%s [ПАРАМЕТР]... [ИМЯ_БД] [ОПИСАНИЕ]
%s [ПАРАМЕТР]... [ИМЯ_РОЛИ]
--if-exists не считать ошибкой отсутствие базы данных
--if-exists не считать ошибкой отсутствие пользователя
--interactive запрашивать отсутствующие атрибуты и имя роли,
а не использовать значения по умолчанию
--maintenance-db=ИМЯ_БД сменить опорную базу данных
--maintenance-db=ИМЯ_БД сменить опорную базу данных
--no-replication роль не может инициировать репликацию
--replication роль может инициировать репликацию
-?, --help показать эту справку и выйти
-?, --help показать эту справку и выйти
-?, --help показать эту справку и выйти
-?, --help показать эту справку и выйти
-D, --no-createdb роль без права создания баз данных (по умолчанию)
-D, --tablespace=ТАБЛ_ПРОСТР табличное пространство по умолчанию для базы данных
-E, --encoding=КОДИРОВКА кодировка базы данных
-E, --encrypted зашифровать сохранённый пароль
-F, --freeze заморозить информацию о транзакциях в строках
-I, --no-inherit роль не наследует права
-L, --no-login роль без права подключения
-N, --unencrypted не шифровать сохранённый пароль
-O, --owner=ВЛАДЕЛЕЦ пользователь-владелец новой базы данных
-P, --pwprompt назначить пароль новой роли
-R, --no-createrole роль без права создания ролей (по умолчанию)
-S, --no-superuser роль без полномочий суперпользователя (по умолчанию)
-S, --schema=СХЕМА переиндексировать только указанную схему(ы)
-T, --template=ШАБЛОН исходная база данных для копирования
-U, --username=ИМЯ имя пользователя для подключения к серверу
-U, --username=ИМЯ имя пользователя для подключения к серверу
-U, --username=ИМЯ имя пользователя для выполнения операции
(но не имя новой роли)
-U, --username=ИМЯ имя пользователя для выполнения операции
(но не имя удаляемой роли)
-U, --username=ИМЯ имя пользователя для подключения к серверу
-V, --version показать версию и выйти
-V, --version показать версию и выйти
-V, --version показать версию и выйти
-V, --version показать версию и выйти
-W, --password запросить пароль
-W, --password запросить пароль
-Z, --analyze-only только обновить статистику оптимизатора,
не очищать БД
-a, --all очистить все базы данных
-a, --all кластеризовать все базы
-a, --all переиндексировать все базы данных
-c, --connection-limit=N предел подключений для роли
(по умолчанию предела нет)
-d, --createdb роль с правом создания баз данных
-d, --dbname=ИМЯ_БД очистить указанную базу данных
-d, --dbname=ИМЯ_БД база данных, из которой будет удалён язык
-d, --dbname=ИМЯ_БД имя базы данных для кластеризации
-d, --dbname=ИМЯ_БД база данных, куда будет установлен язык
-d, --dbname=БД имя базы для переиндексации
-d, --dbname=БД имя базы
-e, --echo отображать команды, отправляемые серверу
-e, --echo отображать команды, отправляемые серверу
-e, --echo отображать команды, отправляемые серверу
-f, --full произвести полную очистку
-g, --role=РОЛЬ новая роль будет включена в эту роль
-h, --host=ИМЯ имя сервера баз данных или каталог сокетов
-h, --host=ИМЯ имя сервера баз данных или каталог сокетов
-h, --host=ИМЯ имя сервера баз данных или каталог сокетов
-i, --index=ИНДЕКС пересоздать только указанный индекс(ы)
-i, --inherit роль наследует права ролей (групп), в которые она
включена (по умолчанию)
-i, --interactive подтвердить операцию удаления
-i, --interactive подтверждать операцию удаления и запрашивать
имя роли, если оно не указано
-j, --jobs=ЧИСЛО запускать для очистки заданное число заданий
-l, --list показать список установленных языков
-l, --locale=ЛОКАЛЬ локаль для базы данных
-l, --login роль с правом подключения к серверу (по умолчанию)
-p, --port=ПОРТ порт сервера баз данных
-p, --port=ПОРТ порт сервера баз данных
-p, --port=ПОРТ порт сервера баз данных
-q, --quiet не выводить сообщения
-q, --quiet не выводить никакие сообщения
-q, --quiet не выводить никакие сообщения
-r, --createrole роль с правом создания других ролей
-s, --superuser роль с полномочиями суперпользователя
-s, --system переиндексировать только системные каталоги
-t, --table='ТАБЛ[(СТОЛБЦЫ)]' очистить только указанную таблицу(ы)
-t, --table=ТАБЛИЦА кластеризовать только указанную таблицу(ы)
-t, --table=ТАБЛИЦА переиндексировать только указанную таблицу(ы)
-t, --timeout=СЕК время ожидания при попытке подключения;
0 - без ограничения (по умолчанию: %s)
-v, --verbose выводить исчерпывающие сообщения
-v, --verbose выводить исчерпывающие сообщения
-w, --no-password не запрашивать пароль
-w, --no-password не запрашивать пароль
-z, --analyze обновить статистику оптимизатора
%s (%s - да/%s - нет) %s очищает и анализирует базу данных PostgreSQL.
%s упорядочивает данные всех кластеризованных таблиц в базе данных.
%s создаёт базу данных PostgreSQL.
%s создаёт роль пользователя PostgreSQL.
%s устанавливает поддержку процедурного языка в базу PostgreSQL.
%s проверяет подключение к базе данных PostgreSQL.
%s переиндексирует базу данных PostgreSQL.
%s удаляет базу данных PostgreSQL.
%s удаляет роль PostgreSQL.
%s удаляет процедурный язык из базы данных.
%s: "%s" не является верным названием кодировки
%s: %s %s: нельзя кластеризовать все базы и одну конкретную одновременно
%s: нельзя кластеризовать указанную таблицу(ы) во всех базах
%s: нельзя переиндексировать все базы данных и одну конкретную одновременно
%s: нельзя переиндексировать все базы данных и системные каталоги одновременно
%s: нельзя переиндексировать указанный индекс(ы) и системные каталоги одновременно
%s: нельзя переиндексировать указанный индекс(ы) во всех базах
%s: нельзя переиндексировать указанную схему(ы) и системные каталоги одновременно
%s: нельзя переиндексировать указанную схему(ы) во всех базах
%s: нельзя переиндексировать указанную таблицу(ы) и системные каталоги одновременно
%s: нельзя переиндексировать указанную таблицу(ы) во всех базах
%s: при выполнении только анализа нельзя использовать параметр "%s"
%s: нельзя очистить все базы данных и одну конкретную одновременно
%s: нельзя очистить только указанную таблицу(ы) во всех базах
%s: кластеризация базы "%s"
%s: кластеризовать базу "%s" не удалось: %s %s: кластеризовать таблицу "%s" в базе "%s" не удалось: %s %s: создать комментарий не удалось (база данных была создана): %s %s: не удалось подключиться к базе %s: %s %s: не удалось подключиться к базе %s (нехватка памяти)
%s: не удалось получить параметры по умолчанию
%s: создать роль не удалось: %s %s: создать базу данных не удалось: %s %s: ошибка при удалении базы данных: %s %s: неверное значение параметра --connection-limit: %s
%s: поддержка языка "%s" уже имеется в базе "%s"
%s: поддержка языка "%s" не установлена в базе данных"%s"
%s: установить поддержку языка не удалось: %s %s: ошибка при удалении поддержки языка: %s %s: отсутствует необходимый аргумент: имя базы данных
%s: отсутствует необходимый аргумент: название языка
%s: отсутствует необходимый аргумент: имя роли
%s: число параллельных заданий должно быть не меньше 1
%s: можно указать только --locale и --lc-collate
%s: можно указать только --locale или --lc-ctype
%s: обработка базы данных "%s": %s
%s: ошибка при выполнении запроса: %s %s: запрос вернул %d строку вместо одной: %s
%s: запрос вернул %d строки вместо одной: %s
%s: запрос вернул %d строк вместо одной: %s
%s: запрос: %s
%s: переиндексация базы данных "%s"
%s: переиндексировать базу данных "%s" не удалось: %s %s: перестроить индекс "%s" в базе "%s" не удалось: %s %s: переиндексировать схему "%s" в базе "%s" не удалось: %s %s: переиндексировать системные каталоги не удалось: %s %s: переиндексировать таблицу "%s" в базе "%s" не удалось: %s %s: ошибка при удалении роли "%s": %s %s: слишком много аргументов командной строки (первый: "%s")
%s: слишком много заданий для этой платформы — попробуйте уменьшить до %d
%s: очистка базы данных "%s"
%s: очистить базу данных "%s" не удалось: %s %s: очистить таблицу "%s" в базе "%s" не удалось: %s (%lu строка) (%lu строки) (%lu строк) Вы уверены? (y/n) Сигнал отмены отправлен
Ошибка добавления ячейки в таблицу: превышен предел числа ячеек (%d).
Ошибка добавления заголовка таблицы: превышен предел числа столбцов (%d).
Отправить сигнал отмены не удалось: %s База данных "%s" будет удалена безвозвратно.
Повторите его: Введите имя новой роли: Введите имя удаляемой роли: Введите пароль для новой роли: Вычисление стандартной (полной) статистики для оптимизатора Вычисление средней статистики для оптимизатора (10 записей) Вычисление минимальной статистики для оптимизатора (1 запись) Прервано
Имя Ошибка при шифровании пароля.
Пароль: Пароли не совпадают.
Пожалуйста, введите "%s" или "%s".
Процедурные языки Роль "%s" будет удалена безвозвратно.
Должна ли новая роль иметь полномочия суперпользователя? Новая роль должна иметь право создавать базы данных? Новая роль должна иметь право создавать другие роли? Доверенный? Для дополнительной информации попробуйте "%s --help".
Использование:
принимает подключения
попытка дублирования нулевого указателя (внутренняя ошибка)
выяснить эффективный идентификатор пользователя (%ld) не удалось: %s неверный формат вывода (внутренняя ошибка): %d n нет проверка не выполнялась
нет ответа
нехватка памяти
отвергает подключения
неизвестно
пользователь не существует распознать имя пользователя не удалось (код ошибки: %lu) y да locale/ru/LC_MESSAGES/pg_dump-9.6.mo 0000644 00000235743 14751153420 0012540 0 ustar 00 �� � L � | �( �( �( X �( [ 3) B �) ) �) " �) x * �* �* �* �* A �* N &+ P u+ I �+ 3 , y D, G �, C - N J- K �- v �- F \. > �. R �. B 5/ E x/ ? �/ L �/ 3 K0 6 0 Q �0 T 1 M ]1 ? �1 � �1 � y2 ? 23 9 r3 5 �3 : �3 K 4 B i4 D �4 � �4 3 r5 � �5 ? (6 D h6 x �6 6 &7 Q ]7 O �7 F �7 > F8 5 �8 > �8 E �8 A @9 O �9 H �9 B : @ ^: = �: O �: H -; ; v; , �; 4 �; E < 0 Z< = �< ; �< F = D L= C �= F �= 8 > ? U> C �> = �> 4 ? 7 L? L �? = �? @ @ J P@ < �@ L �@ , %A ( RA 5 {A E �A T �A LB 9 OB D �B G �B C 1C ? LC ' �C * �C e �C ! ED , gD 4 �D 6 �D ( E / )E YE wE $ �E * �E 2 �E B F > OF J �F P �F N *G H yG - �G �G H / H HH 4 ZH $ �H & �H * �H # I *I P II C �I A �I ( J IJ gJ �J �J = �J � �J
�K , �K � �K � SL , �L M p +M e �M & N )N ` 1N p �N 4 O X 8O _ �O E �O 1 7P 6 iP 4 �P * �P - Q D .Q . sQ + �Q + �Q ) �Q * $R > OR : �R ' �R = �R ) /S 1 YS �S @ �S 7 �S 6 T 6 VT < �T = �T 4 U 3 =U b qU 9 �U < V t KV # �V , �V 5 W GW hW �W
�W ' �W �W % �W �W / X X JX & �X 0 �X . �X - *Y XY oY �Y 3 �Y ( �Y �Y # �Y !Z & BZ K iZ & �Z �Z ! �Z ( [ ' E[ # m[ # �[ �[ / �[ \ &\ # B\ % f\ �\ , �\ $ �\ $ �\ $ ] 6 E] |] �] B �] � �] � �^ _ $ >_ < c_ 3 �_ * �_ ' �_ + '` ( S` ( |` # �` - �` � �` + �a , �a ! b & Bb ' ib # �b �b " �b 8 �b $ 0c Uc uc Q �c & �c a
d @ od 5 �d , �d e " .e # Qe , ue �e ! �e * �e # f % 2f 0 Xf & �f $ �f �f " �f = g # Ug 1 yg �g �g �g : �g ) h B Gh P �h �h �h
i (i " 8i [i ui & �i & �i % �i 2 j 9j Nj & jj ! �j ) �j # �j " k $k r 5k < �k D �k N *l F yl �l �l & �l , m - Mm {m " �m / �m �m n ( n @ Fn �n �n �n P �n +o > Ao 1 �o > �o / �o Y !p > {p �p �p " �p q & 3q < Zq �q ' �q ( �q ' �q $r Br Yr 1 lr + �r �r % �r 3 s Es ^s " ws ; �s �s �s 0 t 6t / Ut �t �t �t . �t I u > Su D �u �u �u v 7 v 9 Mv 6 �v H �v @ w Hw 3 Zw & �w 0 �w 6 �w / x ( Mx , vx �x " �x �x �x y h !y T �y � �y 6 bz L �z J �z 9 1{ k{ $ z{ + �{ �{ �{ �{ | -| 2 A| t| " �| �| �| �| �| $ } +} & <} c} w} # �} �} $ �} ) �} ~ ! 1~ % S~ + y~ �~ & �~ ' �~ 4 0 Q . � ) � + � � ( #� L� 4 j� � �� # "� * F� q� �� �� �� ( ҁ �� " � 5� E J� # �� �� ̂ � ; � '� =� J� ' f� �� ' �� % � � 0� B M� 0 �� ! �� 8 � : � W� s� 3 �� 1 ƅ 1 �� + *� $ V� $ {� h �� � � , � 6� � W� � � � l� < � L >� � �� Q� W� ) s� & �� Z Č u � � �� � <� Z � � K� | 3� e �� j � � �� � � p �� g (� � �� v L� y Ô p =� � �� \ h� h Ŗ � .� � Ɨ ~ d� t � # X� � |� r a� T ԛ P )� S z� t Μ o C� v �� � *� [ � � z� ^ H� g �� � � ` ܡ { =� � �� o �� d � [ q� R ͤ K � G l� s �� U (� _ ~� e ަ [ D� y �� � � p �� R ,� b � o � L R� _ �� q �� r q� m � � R� � �� f �� [ � n P� f �� F &� I m� � �� _ h� e Ȱ � .� l Ʊ � 3� P � R 9� D �� d ѳ � 6� մ y ش ~ R� � ѵ 4 X� �� m �� P � E m� � �� A O� J �� � ܸ � b� Y �� [ O� 3 �� ߺ H �� ^ G� L �� [ � W O� c �� i � g u� a ݽ Y ?� ? �� پ P � @� h a� = ʿ 3 � N <� 5 �� ; �� � �� P �� N � G P� : �� * �� 0 �� = /� x m� � �� m� V |� � �� � �� X �� * � � 6� � �� [ �� &� � C� � *� � �� � q� � 0� �� g b� l �� j 7� f �� K � � U� a �� ^ =� ^ �� \ �� ] X� � �� � J� r �� � C� _ �� \ ,� N �� � �� | c� u �� y V� � �� � Y� q �� u Z� � �� { �� � � � �� F T� g �� ` � D d� N �� �� � : %� `� F y� R �� p � � �� V .� l �� J �� K =� ) �� " �� �� I �� M ,� z� T �� @ �� A -� � o� = �� E /� = u� I �� L �� B J� ; �� ? �� j � A t� G �� C �� C B� 0 �� n �� ; &� E b� E �� W �� 3 F� C z� r �� = 1� C o� . �� = �� e � P �� Z �� a 2� W �� L �� J 9� K �� [ �� � ,� ^ �� ^
� J l� Y �� Y � D k� ? �� E �� ~ 6� F �� A �� ? >� � ~� Z � � a� w � p �� L � K M� ? �� C � V � C t� S �� R � O _� L �� ^ �� ^ [� 5 �� < � f -� t �� F � T P� �� �� ! � e � U h� � �� g F� ) �� < � : P ? j 8 � ? � ) # ) M ( w j � M = Y S � @ � _ , ! � � � X � w F � � � T � � = � 6 � N Q n T � - 1 C A u ' � D � U $
r z
( �
5 V L � � $ � � � 8 F
c
r �
� V X � - 5 5 c A � / � D i P 5 � M � I > L � ) � + � + l G d � D > ^ o � .
- < G j h � > ; T z B � X 2 k A � / � H b Y W � ] r U � + � � � � � 5 � � � ] � Z ] n V � ] # P � N � @ ! b A � + � D � ; 6 � r � > � ! u �" � 8# � �# � a$ �$ G �$ \ =% $ �% . �% > �% 5 -& " c& W �& �& 5 �& - 3' a' 1 ~' / �' F �' '( K >( * �( �( 7 �( - ) L <) R �) P �) K -* R y* _ �* = ,+ R j+ T �+ C , ; V, i �, a �, i ^- a �- 9 *. I d. 8 �. � �. �/ G �0 : �0 B ,1 - o1 5 �1 & �1 6 �1 $ 12 / V2 �2 � �2 5 /3 / e3 3 �3 �3 u �3 ( F4 o4 6 �4 A �4 & �4 J &5 B q5 M �5 0 6 3 36 ` g6 Y �6 ? "7 p b7 b �7 5 68 7 l8 r �8 Q 9 Q i9 W �9 D : U X: 4 �: � � p � � � � m � _ � @ � 8 � �
= n k t ! � � � E � � � � . � & � ] � a � � � � � ! � ( � � ] � U � � j A 0 � � : � '
V ~ q Q � � F � � � - v � � � � Y � � i > � g � � � � � D a T � & + � � j D l � � � � � � � 3 � � � � � � � � f � � � { � � � � 7 � � � � � � r K � � 7 � � I � � I L v � � R � � / � � � � � 9 2 � < 4 $ � d ( � + � � � � � � o c � � 1 u � s � * b � � r � � � - i : � / � 3 ^ z K X X G � ) % � \ � � C � � � # � 2 � H � Q = � B J S ~ T � } � n E H 5 6 �
x � [ J � � y 6 � c o l w h s � � F ? m # p 9 � Z � � � � � ` � Y
� � 5 4 B @ � � z � � � g y { O � , " � � ? � � � � � S b > � N � � � P N . � ; � � � � � ` � q ) � � � � � � � � | � � t ^ � O ; h " � G w � � R V % � , � � � � � � � � � C � � M 0 � W � � _ � � � � f � ' < * � � � \ � L | [ Z } P � � � $ W � � � � � � � 8 � � x A e � d � U � � � � 1 � u e � M � k �
Connection options:
General options:
If -f/--file is not used, then the SQL script will be written to the standard
output.
If no database name is supplied, then the PGDATABASE environment
variable value is used.
If no input file name is supplied, then standard input is used.
Options controlling the output content:
Options controlling the restore:
The options -I, -n, -P, -t, -T, and --section can be combined and specified
multiple times to select multiple objects.
%s
%s [OPTION]...
%s [OPTION]... [DBNAME]
%s [OPTION]... [FILE]
--binary-upgrade for use by upgrade utilities only
--column-inserts dump data as INSERT commands with column names
--disable-dollar-quoting disable dollar quoting, use SQL standard quoting
--disable-triggers disable triggers during data-only restore
--enable-row-security enable row security
--enable-row-security enable row security (dump only content user has
access to)
--exclude-table-data=TABLE do NOT dump data for the named table(s)
--if-exists use IF EXISTS when dropping objects
--inserts dump data as INSERT commands, rather than COPY
--lock-wait-timeout=TIMEOUT fail after waiting TIMEOUT for a table lock
--no-data-for-failed-tables do not restore data of tables that could not be
created
--no-security-labels do not dump security label assignments
--no-security-labels do not restore security labels
--no-synchronized-snapshots do not use synchronized snapshots in parallel jobs
--no-tablespaces do not dump tablespace assignments
--no-tablespaces do not restore tablespace assignments
--no-unlogged-table-data do not dump unlogged table data
--quote-all-identifiers quote all identifiers, even if not key words
--role=ROLENAME do SET ROLE before dump
--role=ROLENAME do SET ROLE before restore
--section=SECTION dump named section (pre-data, data, or post-data)
--section=SECTION restore named section (pre-data, data, or post-data)
--serializable-deferrable wait until the dump can run without anomalies
--snapshot=SNAPSHOT use given snapshot for the dump
--strict-names require table and/or schema include patterns to
match at least one entity each
--use-set-session-authorization
use SET SESSION AUTHORIZATION commands instead of
ALTER OWNER commands to set ownership
-1, --single-transaction restore as a single transaction
-?, --help show this help, then exit
-?, --help show this help, then exit
-C, --create create the target database
-C, --create include commands to create database in dump
-E, --encoding=ENCODING dump the data in encoding ENCODING
-F, --format=c|d|t backup file format (should be automatic)
-F, --format=c|d|t|p output file format (custom, directory, tar,
plain text (default))
-I, --index=NAME restore named index
-L, --use-list=FILENAME use table of contents from this file for
selecting/ordering output
-N, --exclude-schema=SCHEMA do NOT dump the named schema(s)
-O, --no-owner skip restoration of object ownership
-O, --no-owner skip restoration of object ownership in
plain-text format
-P, --function=NAME(args) restore named function
-S, --superuser=NAME superuser user name to use for disabling triggers
-S, --superuser=NAME superuser user name to use in plain-text format
-S, --superuser=NAME superuser user name to use in the dump
-T, --exclude-table=TABLE do NOT dump the named table(s)
-T, --trigger=NAME restore named trigger
-U, --username=NAME connect as specified database user
-V, --version output version information, then exit
-V, --version output version information, then exit
-W, --password force password prompt (should happen automatically)
-Z, --compress=0-9 compression level for compressed formats
-a, --data-only dump only the data, not the schema
-a, --data-only restore only the data, no schema
-b, --blobs include large objects in dump
-c, --clean clean (drop) database objects before recreating
-c, --clean clean (drop) databases before recreating
-d, --dbname=CONNSTR connect using connection string
-d, --dbname=DBNAME database to dump
-d, --dbname=NAME connect to database name
-e, --exit-on-error exit on error, default is to continue
-f, --file=FILENAME output file name
-f, --file=FILENAME output file or directory name
-f, --file=FILENAME output file name (- for stdout)
-g, --globals-only dump only global objects, no databases
-h, --host=HOSTNAME database server host or socket directory
-j, --jobs=NUM use this many parallel jobs to dump
-j, --jobs=NUM use this many parallel jobs to restore
-l, --database=DBNAME alternative default database
-l, --list print summarized TOC of the archive
-n, --schema=NAME restore only objects in this schema
-n, --schema=SCHEMA dump the named schema(s) only
-o, --oids include OIDs in dump
-p, --port=PORT database server port number
-r, --roles-only dump only roles, no databases or tablespaces
-s, --schema-only dump only the schema, no data
-s, --schema-only restore only the schema, no data
-t, --table=NAME restore named relation (table, view, etc.)
-t, --table=TABLE dump the named table(s) only
-t, --tablespaces-only dump only tablespaces, no databases or roles
-v, --verbose verbose mode
-v, --verbose verbose mode
-w, --no-password never prompt for password
-x, --no-privileges do not dump privileges (grant/revoke)
-x, --no-privileges skip restoration of access privileges (grant/revoke)
%s %s dumps a database as a text file or to other formats.
%s extracts a PostgreSQL database cluster into an SQL script file.
%s restores a PostgreSQL database from an archive created by pg_dump.
%s: %s Command was: %s
%s: WSAStartup failed: %d
%s: cannot specify both --single-transaction and multiple jobs
%s: could not connect to database "%s"
%s: could not connect to database "%s": %s %s: could not connect to databases "postgres" or "template1"
Please specify an alternative database.
%s: could not get server version
%s: could not open the output file "%s": %s
%s: could not parse ACL list (%s) for database "%s"
%s: could not parse ACL list (%s) for tablespace "%s"
%s: could not parse server version "%s"
%s: could not re-open the output file "%s": %s
%s: dumping database "%s"...
%s: executing %s
%s: invalid number of parallel jobs
%s: maximum number of parallel jobs is %d
%s: option --if-exists requires option -c/--clean
%s: options -c/--clean and -a/--data-only cannot be used together
%s: options -d/--dbname and -f/--file cannot be used together
%s: options -g/--globals-only and -r/--roles-only cannot be used together
%s: options -g/--globals-only and -t/--tablespaces-only cannot be used together
%s: options -r/--roles-only and -t/--tablespaces-only cannot be used together
%s: options -s/--schema-only and -a/--data-only cannot be used together
%s: pg_dump failed on database "%s", exiting
%s: query failed: %s %s: query was: %s
%s: role name starting with "pg_" skipped (%s)
%s: running "%s"
%s: too many command-line arguments (first is "%s")
%s: unrecognized section name: "%s"
(The INSERT command cannot set OIDs.)
(The system catalogs might be corrupted.)
-C and -1 are incompatible options
COPY failed for table "%s": %s Consider using a full dump instead of a --data-only dump to avoid this problem.
Dumping the contents of table "%s" failed: PQgetCopyData() failed.
Dumping the contents of table "%s" failed: PQgetResult() failed.
Error from TOC entry %d; %u %u %s %s %s
Error message from server: %s Error while FINALIZING:
Error while INITIALIZING:
Error while PROCESSING TOC:
Exported snapshots are not supported by this server version.
NOTICE: there are circular foreign-key constraints on this table:
NOTICE: there are circular foreign-key constraints among these tables:
Password: Report bugs to <pgsql-bugs@postgresql.org>.
Synchronized snapshots are not supported by this server version.
Run with --no-synchronized-snapshots instead if you do not need
synchronized snapshots.
Synchronized snapshots are not supported on standby servers.
Run with --no-synchronized-snapshots instead if you do not need
synchronized snapshots.
TOC Entry %s at %s (length %s, checksum %d)
The command was: %s
The program "pg_dump" is needed by %s but was not found in the
same directory as "%s".
Check your installation.
The program "pg_dump" was found by "%s"
but was not the same version as %s.
Check your installation.
Try "%s --help" for more information.
Usage:
WARNING: aggregate function %s could not be dumped correctly for this database version; ignored
WARNING: archive is compressed, but this installation does not support compression -- no data will be available
WARNING: archive items not in correct section order
WARNING: archive was made on a machine with larger integers, some operations might fail
WARNING: bogus transform definition, at least one of trffromsql and trftosql should be nonzero
WARNING: bogus value in pg_cast.castfunc or pg_cast.castmethod field
WARNING: bogus value in pg_cast.castmethod field
WARNING: bogus value in pg_transform.trffromsql field
WARNING: bogus value in pg_transform.trftosql field
WARNING: bogus value in proargmodes array
WARNING: could not find operator with OID %s
WARNING: could not find where to insert IF EXISTS in statement "%s"
WARNING: could not parse proallargtypes array
WARNING: could not parse proargmodes array
WARNING: could not parse proargnames array
WARNING: could not parse proconfig array
WARNING: could not parse reloptions array
WARNING: could not resolve dependency loop among these items:
WARNING: don't know how to set owner for object type "%s"
WARNING: errors ignored on restore: %d
WARNING: ftell mismatch with expected position -- ftell used
WARNING: invalid creation date in header
WARNING: invalid type "%c" of access method "%s"
WARNING: line ignored: %s
WARNING: owner of aggregate function "%s" appears to be invalid
WARNING: owner of data type "%s" appears to be invalid
WARNING: owner of function "%s" appears to be invalid
WARNING: owner of operator "%s" appears to be invalid
WARNING: owner of operator class "%s" appears to be invalid
WARNING: owner of operator family "%s" appears to be invalid
WARNING: owner of schema "%s" appears to be invalid
WARNING: owner of table "%s" appears to be invalid
WARNING: requested compression not available in this installation -- archive will be uncompressed
WARNING: typtype of data type "%s" appears to be invalid
WARNING: unexpected extra results during COPY of table "%s"
You might not be able to restore the dump without using --disable-triggers or temporarily dropping the constraints.
a worker process died unexpectedly
aborting because of server version mismatch
actual file length (%s) does not match expected (%s)
allocating AH for %s, format %d
already connected to a database
archiver archiver (db) attempting to ascertain archive format
bad dumpId
bad table dumpId for TABLE DATA item
can only reopen input archives
cannot duplicate null pointer (internal error)
cannot restore from compressed archive (compression not supported in this installation)
child process exited with exit code %d child process exited with unrecognized status %d child process was terminated by exception 0x%X child process was terminated by signal %d: %s command not executable command not found compress_io compression is not supported by tar archive format
compression level must be in range 0..9
compressor active
connecting to database for restore
connecting to new database "%s"
connection to database "%s" failed: %s corrupt tar header found in %s (expected %d, computed %d) file position %s
could not change directory to "%s": %s could not close TOC file: %s
could not close archive file: %s
could not close compression library: %s
could not close compression stream: %s
could not close data file "%s": %s
could not close directory "%s": %s
could not close input file: %s
could not close large object TOC file "%s": %s
could not close output file: %s
could not close tar member
could not close temporary file: %s
could not commit database transaction could not compress data: %s
could not create communication channels: %s
could not create directory "%s": %s
could not create large object %u: %s could not create worker process: %s
could not determine seek position in archive file: %s
could not execute query could not find a "%s" to execute could not find block ID %d in archive -- possibly corrupt archive
could not find block ID %d in archive -- possibly due to out-of-order restore request, which cannot be handled due to lack of data offsets in archive
could not find block ID %d in archive -- possibly due to out-of-order restore request, which cannot be handled due to non-seekable input file
could not find entry for ID %d
could not find file "%s" in archive
could not find function definition for function with OID %u
could not find header for file "%s" in tar archive
could not find parent extension for %s %s
could not find slot of finished worker
could not generate temporary file name: %s
could not get server_version from libpq
could not identify current directory: %s could not identify dependency loop
could not initialize compression library: %s
could not obtain lock on relation "%s"
This usually means that someone requested an ACCESS EXCLUSIVE lock on the table after the pg_dump parent process had gotten the initial ACCESS SHARE lock on the table.
could not open TOC file "%s" for input: %s
could not open TOC file "%s" for output: %s
could not open TOC file "%s": %s
could not open TOC file for input: %s
could not open TOC file for output: %s
could not open input file "%s": %s
could not open input file: %s
could not open large object %u: %s could not open large object TOC file "%s" for input: %s
could not open output file "%s": %s
could not open output file: %s
could not open temporary file
could not parse GRANT ACL list (%s) or REVOKE ACL list (%s) for object "%s" (%s)
could not parse default ACL list (%s)
could not parse initial GRANT ACL list (%s) or initial REVOKE ACL list (%s) for object "%s" (%s)
could not parse numeric array "%s": invalid character in number
could not parse numeric array "%s": too many numbers
could not parse result of current_schemas()
could not read binary "%s" could not read directory "%s": %s
could not read from input file: %s
could not read from input file: end of file
could not read input file: %s
could not read symbolic link "%s" could not set default_tablespace to %s: %s could not set default_with_oids: %s could not set search_path to "%s": %s could not set seek position in archive file: %s
could not set session user to "%s": %s could not start database transaction could not uncompress data: %s
could not write to blobs TOC file
could not write to large object (result: %lu, expected: %lu)
could not write to output file: %s
could not write to the communication channel: %s
creating %s "%s"
creating %s "%s.%s"
custom archiver definition of view "%s" appears to be empty (length zero)
did not find magic string in file header
direct database connections are not supported in pre-1.3 archives
directory "%s" does not appear to be a valid archive ("toc.dat" does not exist)
directory archiver directory name too long: "%s"
disabling triggers for %s
dropping %s %s
dumping contents of table "%s.%s"
enabling triggers for %s
entering main parallel loop
entering restore_toc_entries_parallel
entering restore_toc_entries_postfork
entering restore_toc_entries_prefork
entry ID %d out of range -- perhaps a corrupt TOC
error during backup
error during file seek: %s
error processing a parallel work item
error reading large object %u: %s error reading large object TOC file "%s"
error returned by PQputCopyData: %s error returned by PQputCopyEnd: %s executing %s %s
expected %d check constraint on table "%s" but found %d
expected %d check constraints on table "%s" but found %d
expected format (%d) differs from format found in file (%d)
failed sanity check, parent OID %u of table "%s" (OID %u) not found
failed sanity check, parent table OID %u of pg_rewrite entry OID %u not found
failed sanity check, parent table OID %u of sequence OID %u not found
failed to connect to database
file name too long: "%s"
file offset in dump file is too large
finding check constraints for table "%s.%s"
finding default expressions of table "%s.%s"
finding extension tables
finding inheritance relationships
finding the columns and types of table "%s.%s"
finished item %d %s %s
finished main parallel loop
flagging inherited columns in subtables
found unexpected block ID (%d) when reading data -- expected %d
function "%s" not found
identifying extension members
implied data-only restore
incomplete tar header found (%lu byte)
incomplete tar header found (%lu bytes)
index "%s" not found
input file appears to be a text format dump. Please use psql.
input file does not appear to be a valid archive
input file does not appear to be a valid archive (too short?)
input file is too short (read %lu, expected 5)
internal error -- WriteData cannot be called outside the context of a DataDumper routine
internal error -- neither th nor fh specified in tarReadRaw()
invalid ENCODING item: %s
invalid OID for large object
invalid OID for large object (%u)
invalid STDSTRINGS item: %s
invalid adnum value %d for table "%s"
invalid argument string (%s) for trigger "%s" on table "%s"
invalid binary "%s" invalid client encoding "%s" specified
invalid column number %d for table "%s"
invalid column numbering in table "%s"
invalid compression code: %d
invalid dependency %d
invalid dumpId %d
invalid line in large object TOC file "%s": "%s"
invalid message received from worker: "%s"
invalid number of parallel jobs
invalid output format "%s" specified
large-object output not supported in chosen format
last built-in OID is %u
launching item %d %s %s
missing index for constraint "%s"
moving from position %s to next member at file position %s
no item ready
no matching schemas were found
no matching schemas were found for pattern "%s"
no matching tables were found
no matching tables were found for pattern "%s"
no output directory specified
not built with zlib support
now at file position %s
option --if-exists requires option -c/--clean
options --inserts/--column-inserts and -o/--oids cannot be used together
options -c/--clean and -a/--data-only cannot be used together
options -s/--schema-only and -a/--data-only cannot be used together
out of memory
out of on_exit_nicely slots
parallel archiver parallel backup only supported by the directory format
parallel restore from non-seekable file is not supported
parallel restore from standard input is not supported
parallel restore is not supported with archives made by pre-8.0 pg_dump
parallel restore is not supported with this archive file format
pclose failed: %s pgpipe: could not accept connection: error code %d
pgpipe: could not bind: error code %d
pgpipe: could not connect socket: error code %d
pgpipe: could not create second socket: error code %d
pgpipe: could not create socket: error code %d
pgpipe: could not listen: error code %d
pgpipe: getsockname() failed: error code %d
processing %s
processing data for table "%s.%s"
processing item %d %s %s
processing missed item %d %s %s
query failed: %s query produced null referenced table name for foreign key trigger "%s" on table "%s" (OID of table: %u)
query returned %d row instead of one: %s
query returned %d rows instead of one: %s
query to get data of sequence "%s" returned %d row (expected 1)
query to get data of sequence "%s" returned %d rows (expected 1)
query to get data of sequence "%s" returned name "%s"
query to get rule "%s" for table "%s" failed: wrong number of rows returned
query to obtain definition of view "%s" returned more than one definition
query to obtain definition of view "%s" returned no data
query was: %s
read TOC entry %d (ID %d) for %s %s
reading column info for interesting tables
reading constraints
reading default privileges
reading dependency data
reading event triggers
reading extensions
reading foreign key constraints for table "%s.%s"
reading indexes
reading indexes for table "%s.%s"
reading large objects
reading policies
reading procedural languages
reading rewrite rules
reading row-level security policies
reading schemas
reading table inheritance information
reading transforms
reading triggers
reading triggers for table "%s.%s"
reading type casts
reading user-defined access methods
reading user-defined aggregate functions
reading user-defined collations
reading user-defined conversions
reading user-defined foreign servers
reading user-defined foreign-data wrappers
reading user-defined functions
reading user-defined operator classes
reading user-defined operator families
reading user-defined operators
reading user-defined tables
reading user-defined text search configurations
reading user-defined text search dictionaries
reading user-defined text search parsers
reading user-defined text search templates
reading user-defined types
reconnection to database "%s" failed: %s reducing dependencies for %d
restored %d large object
restored %d large objects
restoring data out of order is not supported in this archive format: "%s" is required, but comes before "%s" in the archive file.
restoring large object with OID %u
sanity check on integer size (%lu) failed
saving database definition
saving encoding = %s
saving large objects
saving search_path = %s
saving standard_conforming_strings = %s
schema "%s" not found
schema with OID %u does not exist
select() failed: %s
server version must be at least 7.3 to use schema selection switches
server version: %s; %s version: %s
skipping item %d %s %s
skipping tar member %s
sorter table "%s" could not be created, will not restore its data
table "%s" not found
tar archiver this format cannot be read
transferring dependency %d -> %d to %d
trigger "%s" not found
unexpected COPY statement syntax: "%s"
unexpected data offset flag %d
unexpected policy command type: "%s"
unexpected section code %d
unexpected tgtype value: %d
unrecognized archive format "%s"; please specify "c", "d", or "t"
unrecognized command received from master: "%s"
unrecognized constraint type: %c
unrecognized data block type %d while restoring archive
unrecognized data block type (%d) while searching archive
unrecognized encoding "%s"
unrecognized file format "%d"
unrecognized object type in default privileges: %d
unrecognized proparallel value for function "%s"
unrecognized provolatile value for function "%s"
unsupported version (%d.%d) in file header
warning from original dump file: %s
worker process failed: exit code %d
wrote %lu byte of large object data (result = %lu)
wrote %lu bytes of large object data (result = %lu)
Project-Id-Version: pg_dump (PostgreSQL current)
Report-Msgid-Bugs-To: pgsql-bugs@postgresql.org
POT-Creation-Date: 2021-11-08 05:27+0300
PO-Revision-Date: 2021-09-06 07:09+0300
Last-Translator: Alexander Lakhin <exclusion@gmail.com>
Language-Team: Russian <pgsql-ru-general@postgresql.org>
Language: ru
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Plural-Forms: nplurals=3; plural=(n%10==1 && n%100!=11 ? 0 : n%10>=2 && n%10<=4 && (n%100<10 || n%100>=20) ? 1 : 2);
Параметры подключения:
Общие параметры:
Если не указан параметр -f/--file, SQL-скрипт записывается в стандартный вывод.
Если имя базы данных не указано, используется переменная окружения PGDATABASE.
Если имя входного файла не указано, используется стандартное устройство ввода.
Параметры, управляющие выводом:
Параметры, управляющие восстановлением:
Параметры -I, -n, -P, -t, -T и --section можно комбинировать и указывать
несколько раз для выбора нескольких объектов.
%s
%s [ПАРАМЕТР]...
%s [ПАРАМЕТР]... [ИМЯ_БД]
%s [ПАРАМЕТР]... [ФАЙЛ]
--binary-upgrade только для утилит обновления БД
--column-inserts выгружать данные в виде INSERT с именами столбцов
--disable-dollar-quoting отключить спецстроки с $, выводить строки
по стандарту SQL
--disable-triggers отключить триггеры при восстановлении
только данных, без схемы
--enable-row-security включить защиту на уровне строк
--enable-row-security включить защиту на уровне строк (выгружать только
те данные, которые доступны пользователю)
--exclude-table-data=ТАБЛИЦА НЕ выгружать данные указанной таблицы (таблиц)
--if-exists применять IF EXISTS при удалении объектов
--inserts выгрузить данные в виде команд INSERT, не COPY
--lock-wait-timeout=ТАЙМ-АУТ прервать операцию при тайм-ауте блокировки таблицы
--no-data-for-failed-tables не восстанавливать данные таблиц, которые
не удалось создать
--no-security-labels не выгружать назначения меток безопасности
--no-security-labels не восстанавливать метки безопасности
--no-synchronized-snapshots не использовать синхронизированные снимки
в параллельных заданиях
--no-tablespaces не выгружать назначения табличных пространств
--no-tablespaces не восстанавливать назначения табл. пространств
--no-unlogged-table-data не выгружать данные нежурналируемых таблиц
--quote-all-identifiers заключать в кавычки все идентификаторы,
а не только ключевые слова
--role=ИМЯ_РОЛИ выполнить SET ROLE перед выгрузкой
--role=ИМЯ_РОЛИ выполнить SET ROLE перед восстановлением
--section=РАЗДЕЛ выгрузить заданный раздел
(pre-data, data или post-data)
--section=РАЗДЕЛ восстановить заданный раздел
(pre-data, data или post-data)
--serializable-deferrable дождаться момента для выгрузки данных без аномалий
--snapshot=СНИМОК использовать при выгрузке заданный снимок
--strict-names требовать, чтобы при указании шаблона включения
таблицы и/или схемы ему соответствовал минимум
один объект
--use-set-session-authorization
устанавливать владельца, используя команды
SET SESSION AUTHORIZATION вместо ALTER OWNER
-1, --single-transaction выполнить восстановление в одной транзакции
-?, --help показать эту справку и выйти
-?, --help показать эту справку и выйти
-C, --create создать целевую базу данных
-C, --create добавить в копию команды создания базы данных
-E, --encoding=КОДИРОВКА выгружать данные в заданной кодировке
-F, --format=c|d|t формат файла (должен определяться автоматически)
-F, --format=c|d|t|p формат выводимых данных
(пользовательский | каталог | tar |
текстовый (по умолчанию))
-I, --index=ИМЯ восстановить указанный индекс
-L, --use-list=ИМЯ_ФАЙЛА использовать оглавление из этого файла для
чтения/упорядочивания данных
-N, --exclude-schema=СХЕМА НЕ выгружать указанную схему(ы)
-O, --no-owner не восстанавливать владение объектами
-O, --no-owner не восстанавливать владение объектами
при использовании текстового формата
-P, --function=ИМЯ(арг-ты) восстановить заданную функцию
-S, --superuser=ИМЯ имя суперпользователя для отключения триггеров
-S, --superuser=ИМЯ имя пользователя, который будет задействован
при восстановлении из текстового формата
-S, --superuser=ИМЯ имя пользователя для выполнения выгрузки
-T, --exclude-table=ТАБЛИЦА НЕ выгружать указанную таблицу(ы)
-T, --trigger=ИМЯ восстановить заданный триггер
-U, --username=ИМЯ имя пользователя баз данных
-V, --version показать версию и выйти
-V, --version показать версию и выйти
-W, --password запрашивать пароль всегда (обычно не требуется)
-Z, --compress=0-9 уровень сжатия при архивации
-a, --data-only выгрузить только данные, без схемы
-a, --data-only восстановить только данные, без схемы
-b, --blobs выгрузить также большие объекты
-c, --clean очистить (удалить) объекты БД при восстановлении
-c, --clean очистить (удалить) базы данных перед
восстановлением
-d, --dbname=СТРОКА подключиться с данной строкой подключения
-d, --dbname=БД имя базы данных для выгрузки
-d, --dbname=БД подключиться к указанной базе данных
-e, --exit-on-error выйти при ошибке (по умолчанию - продолжать)
-f, --file=ИМЯ_ФАЙЛА имя выходного файла
-f, --file=ИМЯ имя выходного файла или каталога
-f, --file=ИМЯ_ФАЙЛА имя выходного файла (или - для вывода в stdout)
-g, --globals-only выгрузить только глобальные объекты, без баз
-h, --host=ИМЯ имя сервера баз данных или каталог сокетов
-j, --jobs=ЧИСЛО распараллелить копирование на указанное число
заданий
-j, --jobs=ЧИСЛО распараллелить восстановление на указанное число заданий
-l, --database=ИМЯ_БД выбор другой базы данных по умолчанию
-l, --list вывести краткое оглавление архива
-n, --schema=ИМЯ восстановить объекты только в этой схеме
-n, --schema=СХЕМА выгрузить только указанную схему(ы)
-o, --oids выгружать данные с OID
-p, --port=ПОРТ номер порта сервера БД
-r, --roles-only выгрузить только роли, без баз данных
и табличных пространств
-s, --schema-only выгрузить только схему, без данных
-s, --schema-only восстановить только схему, без данных
-t, --table=ИМЯ восстановить заданное отношение (таблицу, представление и т. п.)
-t, --table=ТАБЛИЦА выгрузить только указанную таблицу(ы)
-t, --tablespaces-only выгружать только табличные пространства,
без баз данных и ролей
-v, --verbose режим подробных сообщений
-v, --verbose выводить подробные сообщения
-w, --no-password не запрашивать пароль
-x, --no-privileges не выгружать права (назначение/отзыв)
-x, --no-privileges не восстанавливать права доступа
(назначение/отзыв)
%s %s сохраняет резервную копию БД в текстовом файле или другом виде.
%s экспортирует всё содержимое кластера баз данных PostgreSQL в SQL-скрипт.
%s восстанавливает базу данных PostgreSQL из архива, созданного командой pg_dump.
%s: %s Выполнялась команда: %s
%s: ошибка WSAStartup: %d
%s: параметр --single-transaction допускается только с одним заданием
%s: не удалось подключиться к базе данных: "%s"
%s: не удалось подключиться к базе "%s": %s %s: не удалось подключиться к базе данных "postgres" или "template1"
Укажите другую базу данных.
%s: не удалось узнать версию сервера
%s: не удалось открыть выходной файл "%s": %s
%s: не удалось разобрать список управления доступом (%s) для базы данных "%s"
%s: не удалось разобрать список управления доступом (%s) для табл. пространства "%s"
%s: не удалось разобрать строку версии сервера "%s"
%s: не удалось повторно открыть выходной файл "%s": %s
%s: выгрузка базы данных "%s"...
%s: выполняется %s
%s: неверное число параллельных заданий
%s: максимальное число параллельных заданий равно %d
%s: параметр --if-exists требует указания -c/--clean
%s: параметры -c/--clean и -a/--data-only исключают друг друга
%s: параметры -d/--dbname и -f/--file исключают друг друга
%s: параметры -g/--globals-only и -r/--roles-only исключают друг друга
%s: параметры -g/--globals-only и -t/--tablespaces-only исключают друг друга
%s: параметры -r/--roles-only и -t/--tablespaces-only исключают друг друга
%s: параметры -s/--schema-only и -a/--data-only исключают друг друга
%s: ошибка при обработке базы "%s", pg_dump завершается
%s: ошибка при выполнении запроса: %s %s: запрос: %s
%s: имя роли, начинающееся с "pg_", пропущено (%s)
%s: выполняется "%s"
%s: слишком много аргументов командной строки (первый: "%s")
%s: нераспознанное имя раздела: "%s"
(В INSERT нельзя определять OID.)
(Возможно, повреждены системные каталоги.)
Параметры -C и -1 несовместимы
сбой команды COPY для таблицы "%s": %s Во избежание этой проблемы, вероятно, стоит выгружать всю базу данных, а не только данные (--data-only).
Ошибка выгрузки таблицы "%s": сбой в PQgetCopyData().
Ошибка выгрузки таблицы "%s": сбой в PQgetResult().
Ошибка из записи оглавления %d; %u %u %s %s %s
Сообщение об ошибке с сервера: %s Ошибка при завершении:
Ошибка при инициализации:
Ошибка при обработке оглавления:
Экспортированные снимки не поддерживаются этой версией сервера.
ЗАМЕЧАНИЕ: в следующей таблице зациклены ограничения внешних ключей:
ЗАМЕЧАНИЕ: в следующих таблицах зациклены ограничения внешних ключей:
ЗАМЕЧАНИЕ: в следующих таблицах зациклены ограничения внешних ключей:
Пароль: Об ошибках сообщайте по адресу <pgsql-bugs@postgresql.org>.
В этой версии сервера синхронизированные снимки не поддерживаются.
Если они вам не нужны, укажите при запуске ключ
--no-synchronized-snapshots.
На ведомых серверах синхронизированные снимки не поддерживаются.
Если они вам не нужны, укажите при запуске ключ
--no-synchronized-snapshots.
Запись оглавления %s в %s (длина: %s, контр. сумма: %d)
Выполнялась команда: %s
Для %s необходима программа "pg_dump", но она не найдена
в каталоге "%s".
Проверьте правильность установки СУБД.
Программа "pg_dump" найдена программой "%s",
но её версия отличается от версии %s.
Проверьте правильность установки СУБД.
Для дополнительной информации попробуйте "%s --help".
Использование:
ПРЕДУПРЕЖДЕНИЕ: агрегатная функция %s не может быть правильно выгружена для этой версии базы данных; функция проигнорирована
ПРЕДУПРЕЖДЕНИЕ: архив сжат, но установленная версия не поддерживает сжатие -- данные недоступны
ПРЕДУПРЕЖДЕНИЕ: в последовательности элементов архива нарушен порядок разделов
ПРЕДУПРЕЖДЕНИЕ: архив был сделан на компьютере большей разрядности -- возможен сбой некоторых операций
ПРЕДУПРЕЖДЕНИЕ: неприемлемое определение преобразования (trffromsql или trftosql должно быть ненулевым)
ПРЕДУПРЕЖДЕНИЕ: неприемлемое значение в поле pg_cast.castfunc или pg_cast.castmethod
ПРЕДУПРЕЖДЕНИЕ: неприемлемое значение в поле pg_cast.castmethod
ПРЕДУПРЕЖДЕНИЕ: неприемлемое значение в поле pg_transform.trffromsql
ПРЕДУПРЕЖДЕНИЕ: неприемлемое значение в поле pg_transform.trftosql
ПРЕДУПРЕЖДЕНИЕ: неприемлемое значение в массиве proargmodes
ПРЕДУПРЕЖДЕНИЕ: оператор с OID %s не найден
ПРЕДУПРЕЖДЕНИЕ: не удалось определить, куда добавить IF EXISTS в оператор "%s"
ПРЕДУПРЕЖДЕНИЕ: не удалось разобрать массив proallargtypes
ПРЕДУПРЕЖДЕНИЕ: не удалось разобрать массив proargmodes
ПРЕДУПРЕЖДЕНИЕ: не удалось разобрать массив proargnames
ПРЕДУПРЕЖДЕНИЕ: не удалось разобрать массив proconfig
ПРЕДУПРЕЖДЕНИЕ: не удалось разобрать массив reloptions
ПРЕДУПРЕЖДЕНИЕ: не удалось разрешить цикл зависимостей для следующих объектов:
ПРЕДУПРЕЖДЕНИЕ: неизвестно, как назначить владельца для объекта типа "%s"
ПРЕДУПРЕЖДЕНИЕ: при восстановлении проигнорировано ошибок: %d
ПРЕДУПРЕЖДЕНИЕ: позиция ftell не соответствует ожидаемой -- используется ftell
ПРЕДУПРЕЖДЕНИЕ: неверная дата создания в заголовке
ПРЕДУПРЕЖДЕНИЕ: неверный тип "%c" метода доступа "%s"
ПРЕДУПРЕЖДЕНИЕ: строка проигнорирована: %s
ПРЕДУПРЕЖДЕНИЕ: у агрегатной функции "%s" по-видимому неправильный владелец
ПРЕДУПРЕЖДЕНИЕ: у типа данных "%s" по-видимому неправильный владелец
ПРЕДУПРЕЖДЕНИЕ: у функции "%s" по-видимому неправильный владелец
ПРЕДУПРЕЖДЕНИЕ: у оператора "%s" по-видимому неправильный владелец
ПРЕДУПРЕЖДЕНИЕ: у класса операторов "%s" по-видимому неправильный владелец
ПРЕДУПРЕЖДЕНИЕ: у семейства операторов "%s" по-видимому неправильный владелец
ПРЕДУПРЕЖДЕНИЕ: у схемы "%s" по-видимому неправильный владелец
ПРЕДУПРЕЖДЕНИЕ: у таблицы "%s" по-видимому неправильный владелец
ПРЕДУПРЕЖДЕНИЕ: установленная версия программы не поддерживает сжатие -- архив не будет сжиматься
ПРЕДУПРЕЖДЕНИЕ: у типа данных "%s" по-видимому неправильный тип типа
ПРЕДУПРЕЖДЕНИЕ: неожиданные лишние результаты получены при COPY для таблицы "%s"
Возможно, для восстановления базы потребуется использовать --disable-triggers или временно удалить ограничения.
рабочий процесс неожиданно прервался
продолжение работы с другой версией сервера невозможно
действительная длина файла (%s) не равна ожидаемой (%s)
выделение структуры AH для %s, формат %d
подключение к базе данных уже установлено
архиватор архиватор (БД) попытка выяснить формат архива
неверный dumpId
неверный dumpId таблицы в элементе TABLE DATA
повторно открыть можно только входные файлы
попытка дублирования нулевого указателя (внутренняя ошибка)
восстановить данные из сжатого архива нельзя (установленная версия не поддерживает сжатие)
дочерний процесс завершился с кодом возврата %d дочерний процесс завершился с нераспознанным состоянием %d дочерний процесс прерван исключением 0x%X дочерний процесс завершён по сигналу %d: %s неисполняемая команда команда не найдена compress_io формат архива tar не поддерживает сжатие
уровень сжатия должен быть в диапазоне 0..9
сжатие активно
подключение к базе данных для восстановления
подключение к новой базе данных "%s"
не удалось подключиться к базе "%s": %s заголовок tar в %s повреждён (ожидалось: %d, получено: %d), позиция в файле: %s
не удалось перейти в каталог "%s": %s не удалось закрыть файл оглавления: %s
не удалось закрыть файл архива: %s
не удалось закрыть библиотеку сжатия: %s
не удалось закрыть поток сжатых данных: %s
не удалось закрыть файл данных "%s": %s
не удалось закрыть каталог "%s": %s
не удалось закрыть входной файл: %s
не удалось закрыть файл оглавления больших объектов "%s": %s
не удалось закрыть выходной файл: %s
не удалось закрыть компонент tar-архива
не удалось закрыть временный файл: %s
не удалось зафиксировать транзакцию не удалось сжать данные: %s
не удалось создать каналы межпроцессного взаимодействия: %s
не удалось создать каталог "%s": %s
не удалось создать большой объект %u: %s не удалось создать рабочий процесс: %s
не удалось определить позицию в файле архива: %s
не удалось выполнить запрос не удалось найти запускаемый файл "%s" не удалось найти в архиве блок с ID %d -- возможно, архив испорчен
не удалось найти в архиве блок с ID %d -- возможно, по причине не последовательного запроса восстановления, который нельзя обработать из-за отсутствия смещений данных в архиве
не удалось найти в архиве блок с ID %d -- возможно, по причине не последовательного запроса восстановления, который нельзя обработать с файлом, не допускающим произвольный доступ
не найдена запись для ID %d
не удалось найти файл "%s" в архиве
не удалось найти определение функции для функции с OID %u
в архиве tar не найден заголовок для файла "%s"
не удалось найти родительское расширение для %s %s
не удалось найти слот законченного рабочего объекта
не удалось получить имя для временного файла: %s
не удалось получить версию сервера из libpq
не удалось определить текущий каталог: %s не удалось определить цикл зависимостей
не удалось инициализировать библиотеку сжатия: %s
не удалось получить блокировку отношения "%s".
Обычно это означает, что кто-то запросил блокировку ACCESS EXCLUSIVE для этой таблицы после того, как родительский процесс pg_dump получил для неё начальную блокировку ACCESS SHARE.
не удалось открыть для чтения файл оглавления "%s": %s
не удалось открыть для записи файл оглавления "%s": %s
не удалось открыть файл оглавления "%s": %s
не удалось открыть для чтения файл оглавления: %s
не удалось открыть для записи файл оглавления: %s
не удалось открыть входной файл "%s": %s
не удалось открыть входной файл: %s
не удалось открыть большой объект %u: %s не удалось открыть для чтения файл оглавления больших объектов "%s": %s
не удалось открыть выходной файл "%s": %s
не удалось открыть выходной файл: %s
не удалось открыть временный файл
не удалось разобрать список GRANT ACL (%s) или список REVOKE ACL (%s) для объекта "%s" (%s)
не удалось разобрать список прав по умолчанию (%s)
не удалось разобрать изначальный список GRANT ACL (%s) или изначальный список REVOKE ACL (%s) для объекта "%s" (%s)
не удалось разобрать числовой массив "%s": неверный символ в числе
не удалось разобрать числовой массив "%s": слишком много чисел
не удалось разобрать результат current_schemas()
не удалось прочитать исполняемый файл "%s" не удалось прочитать каталог "%s": %s
не удалось прочитать входной файл: %s
не удалось прочитать входной файл: конец файла
не удалось прочитать входной файл: %s
не удалось прочитать символическую ссылку "%s" не удалось задать для default_tablespace значение %s: %s не удалось установить параметр default_with_oids: %s не удалось присвоить search_path значение "%s": %s не удалось задать текущую позицию в файле архива: %s
не удалось переключить пользователя сессии на "%s": %s не удаётся начать транзакцию не удалось распаковать данные: %s
не удалось записать в файл оглавления больших объектов
не удалось записать большой объект (результат: %lu, ожидалось: %lu)
не удалось записать в выходной файл: %s
не удалось записать в канал взаимодействия: %s
создаётся %s "%s"
создаётся %s "%s.%s"
внешний архиватор определение представления "%s" пустое (длина равна нулю)
в заголовке файла не найдена нужная сигнатура
прямые подключения к базе данных не поддерживаются в архивах до версии 1.3
каталог "%s" не похож на архивный (в нём отсутствует "toc.dat")
каталоговый архиватор слишком длинное имя каталога: "%s"
отключаются триггеры таблицы %s
удаляется %s %s
выгрузка содержимого таблицы "%s.%s"
включаются триггеры таблицы %s
вход в основной параллельный цикл
вход в restore_toc_entries_parallel
вход в restore_toc_entries_postfork
вход в restore_toc_entries_prefork
ID записи %d вне диапазона - возможно повреждено оглавление
ошибка в процессе резервного копирования
ошибка при перемещении в файле: %s
ошибка выполнения части параллельной работы
ошибка чтения большого объекта %u: %s ошибка чтения файла оглавления больших объектов "%s"
ошибка в PQputCopyData: %s ошибка в PQputCopyEnd: %s выполняется %s %s
ожидалось %d ограничение-проверка для таблицы "%s", но найдено: %d
ожидалось %d ограничения-проверки для таблицы "%s", но найдено: %d
ожидалось %d ограничений-проверок для таблицы "%s", но найдено: %d
ожидаемый формат (%d) отличается от формата, указанного в файле (%d)
нарушение целостности: родительская таблица с OID %u для таблицы "%s" (OID %u) не найдена
нарушение целостности: по OID %u не удалось найти родительскую таблицу для записи pg_rewrite с OID %u
нарушение целостности: по OID %u не удалось найти родительскую таблицу последовательности с OID %u
ошибка подключения к базе данных
слишком длинное имя файла: "%s"
слишком большое смещение в файле выгрузки
поиск ограничений-проверок для таблицы "%s.%s"
поиск выражений по умолчанию для таблицы "%s.%s"
поиск таблиц расширений
поиск связей наследования
поиск столбцов и типов таблицы "%s.%s"
закончен объект %d %s %s
основной параллельный цикл закончен
пометка наследованных столбцов в подтаблицах
при чтении данных получен неожиданный ID блока (%d) -- ожидался: %d
функция "%s" не найдена
выявление членов расширений
подразумевается восстановление только данных
найден неполный заголовок tar (размер %lu байт)
найден неполный заголовок tar (размер %lu байта)
найден неполный заголовок tar (размер %lu байт)
индекс "%s" не найден
входной файл, видимо, имеет текстовый формат. Загрузите его с помощью psql.
входной файл не похож на архив
входной файл не похож на архив (возможно, слишком мал?)
входной файл слишком короткий (прочитано байт: %lu, ожидалось: 5)
внутренняя ошибка -- WriteData нельзя вызывать вне контекста процедуры DataDumper
внутренняя ошибка -- в tarReadRaw() не указан ни th, ни fh
неверный элемент ENCODING: %s
неверный OID большого объекта
неверный OID для большого объекта (%u)
неверный элемент STDSTRINGS: %s
неверное значение adnum (%d) в таблице "%s"
неверная строка аргументов (%s) для триггера "%s" таблицы "%s"
неверный исполняемый файл "%s" указана неверная клиентская кодировка "%s"
неверный номер столбца %d для таблицы "%s"
неверная нумерация столбцов в таблице "%s"
неверный код сжатия: %d
неверная зависимость %d
неверный dumpId %d
неверная строка в файле оглавления больших объектов "%s": "%s"
от рабочего процесса получено ошибочное сообщение: "%s"
неверное число параллельных заданий
указан неверный формат вывода: "%s"
выбранный формат не поддерживает выгрузку больших объектов
последний системный OID: %u
объект %d %s %s запускается
отсутствует индекс для ограничения "%s"
переход от позиции %s к следующему компоненту в позиции %s
элемент не готов
соответствующие схемы не найдены
схемы, соответствующие шаблону "%s", не найдены
соответствующие таблицы не найдены
таблицы, соответствующие шаблону "%s", не найдены
выходной каталог не указан
программа собрана без поддержки zlib
текущая позиция в файле %s
параметр --if-exists требует указания -c/--clean
параметры --inserts/--column-inserts и -o/--oids исключают друг друга
параметры -c/--clean и -a/--data-only исключают друг друга
параметры -s/--schema-only и -a/--data-only исключают друг друга
нехватка памяти
превышен предел обработчиков штатного выхода
параллельный архиватор параллельное резервное копирование поддерживается только с форматом "каталог"
параллельное восстановление возможно только с файлом произвольного доступа
параллельное восстановление из стандартного ввода не поддерживается
параллельное восстановление возможно только для архивов, созданных pg_dump версии 8.0 и новее
параллельное восстановление не поддерживается с выбранным форматом архивного файла
ошибка pclose: %s pgpipe: не удалось принять соединение (код ошибки: %d)
pgpipe: не удалось привязаться к сокету (код ошибки: %d)
pgpipe: не удалось подключить сокет (код ошибки: %d)
pgpipe: не удалось создать второй сокет (код ошибки: %d)
pgpipe: не удалось создать сокет (код ошибки: %d)
pgpipe: не удалось начать приём (код ошибки: %d)
pgpipe: ошибка в getsockname() (код ошибки: %d)
обрабатывается %s
обрабатываются данные таблицы "%s.%s"
обработка объекта %d %s %s
обработка пропущенного объекта %d %s %s
ошибка при выполнении запроса: %s запрос выдал NULL вместо имени целевой таблицы для триггера внешнего ключа "%s" в таблице "%s" (OID целевой таблицы: %u)
запрос вернул %d строку вместо одной: %s
запрос вернул %d строки вместо одной: %s
запрос вернул %d строк вместо одной: %s
запрос на получение данных последовательности "%s" вернул %d строку (ожидалась 1)
запрос на получение данных последовательности "%s" вернул %d строки (ожидалась 1)
запрос на получение данных последовательности "%s" вернул %d строк (ожидалась 1)
запрос на получение данных последовательности "%s" вернул имя "%s"
запрос на получение правила "%s" для таблицы "%s" возвратил неверное число строк
запрос на получение определения представления "%s" возвратил несколько определений
запрос на получение определения представления "%s" не возвратил данные
запрос: %s
прочитана запись оглавления %d (ID %d): %s %s
чтение информации о столбцах интересующих таблиц
чтение ограничений
чтение прав по умолчанию
чтение информации о зависимостях
чтение событийных триггеров
чтение расширений
чтение ограничений внешних ключей таблицы "%s.%s"
чтение индексов
чтение индексов таблицы "%s.%s"
чтение больших объектов
чтение политик
чтение процедурных языков
чтение правил перезаписи
чтение политик защиты на уровне строк
чтение схем
чтение информации о наследовании таблиц
чтение преобразований
чтение триггеров
чтение триггеров таблицы "%s.%s"
чтение приведений типов
чтение пользовательских методов доступа
чтение пользовательских агрегатных функций
чтение пользовательских правил сортировки
чтение пользовательских преобразований
чтение пользовательских сторонних серверов
чтение пользовательских оболочек сторонних данных
чтение пользовательских функций
чтение пользовательских классов операторов
чтение пользовательских семейств операторов
чтение пользовательских операторов
чтение пользовательских таблиц
чтение пользовательских конфигураций текстового поиска
чтение пользовательских словарей текстового поиска
чтение пользовательских анализаторов текстового поиска
чтение пользовательских шаблонов текстового поиска
чтение пользовательских типов
не удалось переподключиться к базе "%s": %s уменьшение зависимостей для %d
восстановлен %d большой объект
восстановлено %d больших объекта
восстановлено %d больших объектов
непоследовательное восстановление данных для данного формата архива не поддерживается: требуется компонент "%s", но в файле архива прежде идёт "%s".
восстановление большого объекта с OID %u
несоответствие размера integer (%lu)
сохранение определения базы данных
сохранение кодировки (%s)
сохранение больших объектов
сохранение search_path = %s
сохранение standard_conforming_strings (%s)
схема "%s" не найдена
схема с OID %u не существует
ошибка в select(): %s
для использования параметров выбора схемы нужен сервер версии 7.3 или новее
версия сервера: %s; версия %s: %s
объект %d %s %s пропускается
пропускается компонент tar %s
sorter создать таблицу "%s" не удалось, её данные не будут восстановлены
таблица "%s" не найдена
архиватор tar этот формат нельзя прочитать
переключение зависимости %d -> %d на %d
триггер "%s" не найден
недопустимый синтаксис оператора COPY: "%s"
неожиданный флаг смещения данных: %d
нераспознанный тип команды в политике: "%s"
неожиданный код раздела %d
неожиданное значение tgtype: %d
нераспознанный формат архива "%s"; укажите "c", "d" или "t"
от ведущего получена нераспознанная команда: "%s"
нераспознанный тип ограничения: %c
нераспознанный тип блока данных %d при восстановлении архива
нераспознанный тип блока данных (%d) при поиске архива
нераспознанная кодировка "%s"
неопознанный формат файла: "%d"
нераспознанный тип объекта в определении прав по умолчанию: %d
недопустимое значение proparallel для функции "%s"
недопустимое значение provolatile для функции "%s"
неподдерживаемая версия (%d.%d) в заголовке файла
предупреждение из исходного файла: %s
рабочий процесс завершился с кодом возврата %d
записан %lu байт данных большого объекта (результат = %lu)
записано %lu байта данных большого объекта (результат = %lu)
записано %lu байт данных большого объекта (результат = %lu)
locale/ru/LC_MESSAGES/pg_config-9.6.mo 0000644 00000016545 14751153420 0013035 0 ustar 00 �� * l ; � � E � 0 � : 3 E n I � L � s K K � = B I i � G � J > M � M � ? % G e > � 6 � < # > ` F � P � I 7
4 �
2 �
* �
. , 8 & e � & � � ( � ! B V c u n w s � Z f w f � c E m � � l � h ( m � � � � k F n � n ! s � h o m f � g D v � # � � # A � M � L 7 * � � V � [ w = � C � J K a S � 5 7 M % * ) $
" '
& ( ! #
%s provides information about the installed version of PostgreSQL.
With no arguments, all known items are shown.
%s [OPTION]...
--bindir show location of user executables
--cc show CC value used when PostgreSQL was built
--cflags show CFLAGS value used when PostgreSQL was built
--cflags_sl show CFLAGS_SL value used when PostgreSQL was built
--configure show options given to "configure" script when
PostgreSQL was built
--cppflags show CPPFLAGS value used when PostgreSQL was built
--docdir show location of documentation files
--htmldir show location of HTML documentation files
--includedir show location of C header files of the client
interfaces
--includedir-server show location of C header files for the server
--ldflags show LDFLAGS value used when PostgreSQL was built
--ldflags_ex show LDFLAGS_EX value used when PostgreSQL was built
--ldflags_sl show LDFLAGS_SL value used when PostgreSQL was built
--libdir show location of object code libraries
--libs show LIBS value used when PostgreSQL was built
--localedir show location of locale support files
--mandir show location of manual pages
--pgxs show location of extension makefile
--pkgincludedir show location of other C header files
--pkglibdir show location of dynamically loadable modules
--sharedir show location of architecture-independent support files
--sysconfdir show location of system-wide configuration files
--version show the PostgreSQL version
-?, --help show this help, then exit
%s: could not find own program executable
%s: invalid argument: %s
Options:
Report bugs to <pgsql-bugs@postgresql.org>.
Try "%s --help" for more information.
Usage:
could not change directory to "%s": %s could not find a "%s" to execute could not identify current directory: %s could not read binary "%s" could not read symbolic link "%s" invalid binary "%s" not recorded pclose failed: %s Project-Id-Version: pg_config (PostgreSQL current)
Report-Msgid-Bugs-To: pgsql-bugs@postgresql.org
POT-Creation-Date: 2016-09-20 18:13+0000
PO-Revision-Date: 2016-09-20 12:00+0300
Last-Translator: Alexander Lakhin <exclusion@gmail.com>
Language-Team: Russian <pgsql-ru-general@postgresql.org>
Language: ru
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Plural-Forms: nplurals=3; plural=(n%10==1 && n%100!=11 ? 0 : n%10>=2 && n%10<=4 && (n%100<10 || n%100>=20) ? 1 : 2);
%s предоставляет информацию об установленной версии PostgreSQL.
При запуске без аргументов выводятся все известные значения.
%s [ПАРАМЕТР]...
--bindir показать расположение исполняемых файлов
--cc показать, с каким значением CC собран PostgreSQL
--cflags показать, с какими флагами C собран PostgreSQL
--cflags_sl показать, с каким значением CFLAGS_SL собран PostgreSQL
--configure показать параметры скрипта "configure", с которыми
был собран PostgreSQL
--cppflags показать, с каким значением CPPFLAGS собран PostgreSQL
--docdir показать расположение файлов документации
--htmldir показать расположение HTML-файлов документации
--includedir показать расположение файлов-заголовков (.h) для
клиентских интерфейсов на языке C
--includedir-server показать расположение файлов-заголовков (.h) для сервера
--ldflags показать, с каким значением LDFLAGS собран PostgreSQL
--ldflags_ex показать, с каким значением LDFLAGS_EX собран PostgreSQL
--ldflags_sl показать, с каким значением LDFLAGS_SL собран PostgreSQL
--libdir показать расположение библиотек объектного кода
--libs показать, с каким значением LIBS собран PostgreSQL
--localedir показать расположение файлов описания локалей
--mandir показать расположение справочных страниц
--pgxs показать расположение makefile для расширений
--pkgincludedir показать расположение других файлов-заголовков (.h)
--pkglibdir показать расположение динамически загружаемых модулей
--sharedir показать расположение платформенно-независимых файлов
--sysconfdir показать расположение общесистемных файлов конфигурации
--version показать версию PostgreSQL
-?, --help показать эту справку и выйти
%s: не удалось найти свой исполняемый файл
%s: неверный аргумент: %s
Параметры:
Об ошибках сообщайте по адресу <pgsql-bugs@postgresql.org>.
Для дополнительной информации попробуйте "%s --help".
Использование:
не удалось перейти в каталог "%s": %s не удалось найти запускаемый файл "%s" не удалось определить текущий каталог: %s не удалось прочитать исполняемый файл "%s" не удалось прочитать символическую ссылку "%s" неверный исполняемый файл "%s" не записано ошибка pclose: %s locale/ru/LC_MESSAGES/ecpg-9.6.mo 0000644 00000044266 14751153420 0012021 0 ustar 00 �� { � � � h
~ i
- �
0 + G g s � 4 � 7 0 s h . � G
4 S
) �
w �
4 * _ @ r = � , � ! @ , ^ 1 � * � - � 1 ' H & p + � " � # �
) = < z � & � < � ! & - 0 + ^ " � � , � � * 3 " ^ ' � � � ! � � ! 5 J 3 k / � ' � ) � * ! 5 L I � , � / � * ) T T ' � � � 1 - K , y , � 5 � ) % ? O 8 � � � _ 0 y 5 � � A � L 7 + �
� 6 � ' � # A ( N 4 w ) � � / � # < $ ] � " � , � � ' " J i $ � D � + � ? 0 Z � 8 � � & F � g � b! W " ` X" F �" � # B �# l �# = U$ � �$ h E% i �% b & E {& � �& P z' 0 �' d �' p a( l �( 9 ?) ' y) i �) \ * U h* X �* \ + R t+ Q �+ V , < p, 3 �, �, ` �, � Q- �- $ �- [ . ` t. D �. / L 9/ W �/ H �/ + '0 A S0 + �0 3 �0 S �0 I I1 C �1 % �1 < �1 G :2 A �2 H �2 !
3 G /3 w w3 Q �3 P A4 T �4 V �4 a >5 y �5 X 6 W s6 [ �6 � '7 P �7 , 8 2 ;8 $ n8 $ �8 ( �8 S �8 R 59 R �9 L �9 7 (: G `: u �: X ; � w; 3 A= l u= p �= " S> x v> | �> X l? �? t �? ; X@ G �@ ! �@ D �@ CA J �A % B P 4B . �B > �B N �B = BC D �C Z �C 4 D 0 UD D �D I �D ; E S QE � �E N )F f xF R �F 3 2G i fG - �G 1 �G I 0H ; zH j 4 f g ? ^ l x
T ( 9 u 8 _ L t I d \ % ) < i = ' Q N & : M v , 7 B . z ; S n # > P " H r ] [ ! * s Z 6 G A O - X 2 q 3 W w 1 k + U e Y o K p 0 a J 5 { h c m E C @ V F D y R / ` $
b
If no output file is specified, the name is formed by adding .c to the
input file name, after stripping off .pgc if present.
Report bugs to <pgsql-bugs@postgresql.org>.
--regression run in regression testing mode
-?, --help show this help, then exit
-C MODE set compatibility mode; MODE can be one of
"INFORMIX", "INFORMIX_SE"
-D SYMBOL define SYMBOL
-I DIRECTORY search DIRECTORY for include files
-V, --version output version information, then exit
-c automatically generate C code from embedded SQL code;
this affects EXEC SQL TYPE
-d generate parser debug output
-h parse a header file, this option includes option "-c"
-i parse system include files as well
-o OUTFILE write result to OUTFILE
-r OPTION specify run-time behavior; OPTION can be:
"no_indicator", "prepare", "questionmarks"
-t turn on autocommit of transactions
%s at or near "%s" %s is the PostgreSQL embedded SQL preprocessor for C programs.
%s, the PostgreSQL embedded C preprocessor, version %d.%d.%d
%s: could not locate my own executable path
%s: could not open file "%s": %s
%s: no input files specified
%s: parser debug support (-d) not available
AT option not allowed in CLOSE DATABASE statement AT option not allowed in CONNECT statement AT option not allowed in DISCONNECT statement AT option not allowed in SET CONNECTION statement AT option not allowed in TYPE statement AT option not allowed in VAR statement AT option not allowed in WHENEVER statement COPY FROM STDIN is not implemented CREATE TABLE AS cannot specify INTO ERROR: EXEC SQL INCLUDE ... search starts here:
Error: include path "%s/%s" is too long on line %d, skipping
Options:
SHOW ALL is not implemented Try "%s --help" for more information.
Unix-domain sockets only work on "localhost" but not on "%s" Usage:
%s [OPTION]... FILE...
WARNING: arrays of indicators are not allowed on input could not open include file "%s" on line %d could not remove output file "%s"
cursor "%s" does not exist cursor "%s" has been declared but not opened cursor "%s" is already defined descriptor "%s" does not exist descriptor header item "%d" does not exist descriptor item "%s" cannot be set descriptor item "%s" is not implemented end of search list
expected "://", found "%s" expected "@" or "://", found "%s" expected "@", found "%s" expected "postgresql", found "%s" incomplete statement incorrectly formed variable "%s" indicator for array/pointer has to be array/pointer indicator for simple data type has to be simple indicator for struct has to be a struct indicator struct "%s" has too few members indicator struct "%s" has too many members indicator variable "%s" is hidden by a local variable indicator variable "%s" is hidden by a local variable of a different type indicator variable must have an integer type initializer not allowed in EXEC SQL VAR command initializer not allowed in type definition internal error: unreachable state; please report this to <pgsql-bugs@postgresql.org> interval specification not allowed here invalid bit string literal invalid connection type: %s invalid data type key_member is always 0 missing "EXEC SQL ENDIF;" missing identifier in EXEC SQL DEFINE command missing identifier in EXEC SQL IFDEF command missing identifier in EXEC SQL UNDEF command missing matching "EXEC SQL IFDEF" / "EXEC SQL IFNDEF" more than one EXEC SQL ELSE multidimensional arrays are not supported multidimensional arrays for simple data types are not supported multidimensional arrays for structures are not supported multilevel pointers (more than 2 levels) are not supported; found %d level multilevel pointers (more than 2 levels) are not supported; found %d levels nested /* ... */ comments nested arrays are not supported (except strings) no longer supported LIMIT #,# syntax passed to server nullable is always 1 only data types numeric and decimal have precision/scale argument only protocols "tcp" and "unix" and database type "postgresql" are supported operator not allowed in variable definition out of memory pointer to pointer is not supported for this data type pointers to varchar are not implemented subquery in FROM must have an alias syntax error syntax error in EXEC SQL INCLUDE command too many levels in nested structure/union definition too many nested EXEC SQL IFDEF conditions type "%s" is already defined type name "string" is reserved in Informix mode unmatched EXEC SQL ENDIF unrecognized data type name "%s" unrecognized descriptor item code %d unrecognized token "%s" unrecognized variable type code %d unsupported feature will be passed to server unterminated /* comment unterminated bit string literal unterminated hexadecimal string literal unterminated quoted identifier unterminated quoted string using unsupported DESCRIBE statement using variable "%s" in different declare statements is not supported variable "%s" is hidden by a local variable variable "%s" is hidden by a local variable of a different type variable "%s" is neither a structure nor a union variable "%s" is not a pointer variable "%s" is not a pointer to a structure or a union variable "%s" is not an array variable "%s" is not declared variable "%s" must have a numeric type zero-length delimited identifier Project-Id-Version: ecpg (PostgreSQL current)
Report-Msgid-Bugs-To: pgsql-bugs@postgresql.org
POT-Creation-Date: 2019-04-29 07:28+0300
PO-Revision-Date: 2021-09-04 10:54+0300
Last-Translator: Alexander Lakhin <exclusion@gmail.com>
Language-Team: Russian <pgsql-ru-general@postgresql.org>
Language: ru
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Plural-Forms: nplurals=3; plural=n%10==1 && n%100!=11 ? 0 : n%10>=2 && n%10<=4 && (n%100<10 || n%100>=20) ? 1 : 2;
Если выходной файл не указан, к имени входного файла без расширения .pgc
добавляется .c.
Об ошибках сообщайте по адресу <pgsql-bugs@postgresql.org>.
--regression запустить в режиме тестирования регрессии
-?, --help показать эту справку и выйти
-C РЕЖИМ установить режим совместимости; допустимый РЕЖИМ:
"INFORMIX" или "INFORMIX_SE"
-D СИМВОЛ определить (define) СИМВОЛ
-I КАТАЛОГ искать включаемые файлы в указанном каталоге
-V, --version показать версию и выйти
-c автоматически генерировать код C из внедрённого SQL-кода;
(это касается EXEC SQL TYPE)
-d генерировать отладочные сообщения при разборе
-h разобрать файл заголовка (включает параметр "-c")
-i разобрать также системные включаемые файлы
-o ФАЙЛ записать результат в ФАЙЛ
-r ПАРАМЕТР определить режим выполнения; допустимый ПАРАМЕТР:
"no_indicator", "prepare" или "questionmarks"
-t включить автофиксацию транзакций
%s (примерное положение: "%s") %s - препроцессор SQL-вставок в программах на C для PostgreSQL.
%s, препроцессор внедрённого в С языка СУБД PostgreSQL, версия %d.%d.%d
%s: не удалось найти путь к собственному исполняемому файлу
%s: не удалось открыть файл "%s": %s
%s: нет входных файлов
%s: отладочные сообщения при разборе (-d) не поддерживаются
оператор CLOSE DATABASE с параметром AT не поддерживается оператор CONNECT с параметром AT не поддерживается оператор DISCONNECT с параметром AT не поддерживается оператор SET CONNECTION с параметром AT не поддерживается оператор TYPE с параметром AT не поддерживается оператор VAR с параметром AT не поддерживается оператор WHENEVER с параметром AT не поддерживается операция COPY FROM STDIN не реализована в CREATE TABLE AS нельзя указать INTO ОШИБКА: поиск файлов для EXEC SQL INCLUDE ... начинается в каталогах:
Ошибка: путь включаемых файлов "%s/%s" в строке %d слишком длинный, пропускается
Параметры:
SHOW ALL не реализовано Для дополнительной информации попробуйте "%s --help".
Unix-сокеты работают только с "localhost", но не с адресом "%s" Использование:
%s [ПАРАМЕТР]... ФАЙЛ...
ПРЕДУПРЕЖДЕНИЕ: массивы индикаторов на входе недопустимы не удалось открыть включаемый файл "%s" (строка %d) ошибка при удалении выходного файла "%s"
курсор "%s" не существует курсор "%s" был объявлен, но не открыт курсор "%s" уже определён дескриптор "%s" не существует заголовок дескриптора не содержит элемент "%d" установить поле "%s" в дескрипторе нельзя поле "%s" в дескрипторе не реализовано конец списка поиска
ожидалось "://", но на этом месте "%s" ожидалось "@" или "://", но на этом месте "%s" ожидался знак "@", но на этом месте "%s" ожидался тип "postgresql", но на этом месте "%s" неполный оператор неправильно оформленная переменная "%s" индикатор для массива/указателя должен быть массивом/указателем индикатор простого типа должен быть простым индикатор структуры должен быть структурой в структуре индикаторе "%s" слишком мало членов в структуре индикаторе "%s" слишком много членов переменная-индикатор "%s" скрыта локальной переменной переменная-индикатор "%s" скрыта локальной переменной другого типа переменная-индикатор должна быть целочисленной команда EXEC SQL VAR не может включать инициализатор определение типа не может включать инициализатор внутренняя ошибка: недостижимое состояние; пожалуйста, сообщите в <pgsql-bugs@postgresql.org> определение интервала здесь не допускается неверная битовая строка неверный тип подключения: %s неверный тип данных KEY_MEMBER всегда равно 0 отсутствует "EXEC SQL ENDIF;" в команде EXEC SQL DEFINE отсутствует идентификатор в команде EXEC SQL IFDEF отсутствует идентификатор в команде EXEC SQL UNDEF отсутствует идентификатор нет соответствующего "EXEC SQL IFDEF" / "EXEC SQL IFNDEF" неоднократная команда EXEC SQL ELSE многомерные массивы не поддерживаются многомерные массивы с простыми типами данных не поддерживаются многомерные массивы структур не поддерживаются многоуровневые указатели (больше 2 уровней) не поддерживаются, обнаружен %d уровень многоуровневые указатели (больше 2 уровней) не поддерживаются, обнаружено %d уровня многоуровневые указатели (больше 2 уровней) не поддерживаются, обнаружено %d уровней вложенные комментарии /* ... */ вложенные массивы не поддерживаются (за исключением строк) не поддерживаемое более предложение LIMIT #,# передано на сервер NULLABLE всегда равно 1 точность/масштаб можно указать только для типов данных numeric и decimal поддерживаются только протоколы "tcp" и "unix", а тип базы данных - "postgresql" недопустимый оператор в определении переменной нехватка памяти для этого типа данных указатели на указатели не поддерживаются указатели на varchar не реализованы подзапрос во FROM должен иметь псевдоним ошибка синтаксиса ошибка синтаксиса в команде EXEC SQL INCLUDE слишком много уровней в определении вложенной структуры/объединения слишком много вложенных условий EXEC SQL IFDEF тип "%s" уже определён имя типа "string" в режиме Informix зарезервировано непарная команда EXEC SQL ENDIF нераспознанное имя типа данных "%s" нераспознанный код элемента дескриптора %d нераспознанное ключевое слово "%s" нераспознанный код типа переменной %d неподдерживаемая функция будет передана серверу незавершённый комментарий /* оборванная битовая строка оборванная шестнадцатеричная строка незавершённый идентификатор в кавычках незавершённая строка в кавычках используется неподдерживаемый оператор DESCRIBE использование переменной "%s" в разных операторах DECLARE не поддерживается переменная "%s" скрыта локальной переменной переменная "%s" скрыта локальной переменной другого типа переменная "%s" - не структура и не объединение переменная "%s" - не указатель переменная "%s" - не указатель на структуру или объединение переменная "%s" - не массив переменная "%s" не объявлена переменная "%s" должна иметь числовой тип пустой идентификатор в кавычках locale/ru/LC_MESSAGES/pg_rewind-9.6.mo 0000644 00000062337 14751153420 0013060 0 ustar 00 �� � $ � ,
�
- �
1 �
? K I C � ; � C 9 Y G � @ � O ( x � � � � � � J > L , � 6 � < � 1 , ? ^ = � = � 9 D T 4 � 9 � 4 2 = @ p R � > C J 1 k � � � � o � d ] - � 4 � & % L � f P � R : c � - � > / \ ; � � � � # B % a $ � + � � $ � L , h 0 � " � ) � , @ $ ^ $ � # � ' � " � " 5 & X $ � ( � � " ' 1 Y v � � 2 � � ' D / c - � � 6 � ; + ) g � + � % � ! ! ! 4! 3 V! 6 �! 1 �! �! ' " < :" _ w" �" �" ! �" F # c# z# �# 1 �# C �# " $$ . G$ # v$ > �$ 6 �$ 3 % 6 D% 0 {% �% + �% & �% & ;& ! Z& ( |& I �& $ �& ' ' <' - Y' J �' = �' A ( 6 R( 5 �( 5 �( ! �( 7 ) / O) 6 ) 1 �) - �) 9 * P* W R, f �, m - � - � . V �. � �. b r/ M �/ w #0 �0 � �0 . =1 7 l1 E �1 ) �1 2 '2 *2 j 32 { �2 a 3 h |3 t �3 ` Z4 �4 p ;5 c �5 S 6 T d6 h �6 o "7 X �7 | �7 � h8 � �8 z �9 3: Z B: o �: 0
; >; = S; ? �; � �; � �< Z c= � �= [ Q> 8 �> � �> � �? � .@ � �@ ` HA > �A = �A p &B O �B @ �B R (C 4 {C ; �C 5 �C D "D ; gD T �D B �D H ;E � �E ] F a pF ; �F I G M XG 5 �G F �G D #H P hH T �H ? I 9 NI 9 �I X �I ? J 5 [J V �J F �J R /K U �K < �K l L D �L 7 �L k �L Q kM Y �M 7 N c ON ^ �N , O f ?O 3 �O � �O N rP Q �P M Q C aQ 1 �Q ; �Q ? R v SR p �R p ;S 5 �S V �S { 9T � �T + TU �U b �U � V 4 �V 8 �V 6 W T JW s �W R X \ fX E �X � Y a �Y c �Y h bZ w �Z 9 C[ e }[ c �[ F G\ J �\ K �\ P %] � v] 4 �] F 0^ W w^ _ �^ � /_ ~ �_ � F` ` �` r 3a p �a 9 b � Qb ^ �b u 2c f �c R d | bd � ' 6 � Y | � � � [ ? r " p � J } � � & = d � 2 { y ; � u / i F
f R 7 � b � 9 k I ) ! l _ q � � � B : � t $ � � 1 % 4 � � � ` U P h � x � ~ * � ]
C w L E @ g 3 a Q c s � 0 m A � < � S X v T , e M z ^ K � H N G 5 O j > � � Z ( o - W . � � D V \ # + � 8 n �
Report bugs to <pgsql-bugs@postgresql.org>.
creating backup label and updating control file
--debug write a lot of debug messages
--source-pgdata=DIRECTORY source data directory to synchronize with
--source-server=CONNSTR source server to synchronize with
-?, --help show this help, then exit
-D, --target-pgdata=DIRECTORY existing data directory to modify
-P, --progress write progress messages
-V, --version output version information, then exit
-n, --dry-run stop before modifying anything
block %u
"%s" is a symbolic link, but symbolic links are not supported on this platform
"%s" is not a directory
"%s" is not a regular file
"%s" is not a symbolic link
%*s/%s kB (%d%%) copied %d: %X/%X - %X/%X
%s %s (%s)
%s resynchronizes a PostgreSQL cluster with another copy of the cluster.
%s: WARNING: cannot create restricted tokens on this platform
%s: could not allocate SIDs: error code %lu
%s: could not create restricted token: error code %lu
%s: could not get exit code from subprocess: error code %lu
%s: could not open process token: error code %lu
%s: could not re-execute with restricted token: error code %lu
%s: could not start process for command "%s": error code %lu
%s: no source specified (--source-pgdata or --source-server)
%s: no target data directory specified (--target-pgdata)
%s: only one of --source-pgdata or --source-server can be specified
%s: too many command-line arguments (first is "%s")
BKPBLOCK_HAS_DATA not set, but data length is %u at %X/%X BKPBLOCK_HAS_DATA set, but no data included at %X/%X BKPBLOCK_SAME_REL set but no previous rel at %X/%X BKPIMAGE_HAS_HOLE not set, but hole offset %u length %u at %X/%X BKPIMAGE_HAS_HOLE set, but hole offset %u length %u block image length %u at %X/%X BKPIMAGE_IS_COMPRESSED set, but block image length %u at %X/%X Done!
Expected a numeric timeline ID.
Expected a transaction log switchpoint location.
Failure, exiting
Options:
Source timeline history:
Target timeline history:
The program "initdb" is needed by %s but was
not found in the same directory as "%s".
Check your installation.
The program "initdb" was found by "%s"
but was not the same version as %s.
Check your installation.
Timeline IDs must be in increasing sequence.
Timeline IDs must be less than child timeline's ID.
Try "%s --help" for more information.
Usage:
%s [OPTION]...
WAL file is from different database system: WAL file database system identifier is %s, pg_control database system identifier is %s WAL file is from different database system: incorrect XLOG_BLCKSZ in page header WAL file is from different database system: incorrect XLOG_SEG_SIZE in page header WAL record modifies a relation, but record type is not recognized
lsn: %X/%X, rmgr: %s, info: %02X
You must run %s as the PostgreSQL superuser.
backup label buffer too small
cannot be executed by "root"
cannot duplicate null pointer (internal error)
clusters are not compatible with this version of pg_rewind
connected to server
contrecord is requested by %X/%X could not clear search_path: %s could not close directory "%s": %s
could not close file "%s": %s
could not close target file "%s": %s
could not create directory "%s": %s
could not create symbolic link at "%s": %s
could not fetch file list: %s could not fetch remote file "%s": %s could not find common ancestor of the source and target cluster's timelines
could not find previous WAL record at %X/%X
could not find previous WAL record at %X/%X: %s
could not open directory "%s": %s
could not open file "%s" for reading: %s
could not open file "%s" for truncation: %s
could not open file "%s": %s
could not open source file "%s": %s
could not open target file "%s": %s
could not read WAL record at %X/%X
could not read WAL record at %X/%X: %s
could not read directory "%s": %s
could not read file "%s": %s
could not read from file "%s": %s
could not read symbolic link "%s": %s
could not remove directory "%s": %s
could not remove file "%s": %s
could not remove symbolic link "%s": %s
could not seek in file "%s": %s
could not seek in source file: %s
could not seek in target file "%s": %s
could not send COPY data: %s could not send end-of-COPY: %s could not send file list: %s could not send query: %s could not set libpq connection to single row mode
could not stat file "%s": %s
could not truncate file "%s" to %u: %s
could not write file "%s": %s
data file "%s" in source is not a regular file
error running query (%s) in source server: %s fetched file "%s", length %d
full_page_writes must be enabled in the source server
getting file chunks
incorrect resource manager data checksum in record at %X/%X invalid action (CREATE) for regular file
invalid block_id %u at %X/%X invalid compressed image at %X/%X, block %d invalid contrecord length %u at %X/%X invalid control file
invalid data in history file
invalid data in history file: %s
invalid info bits %04X in log segment %s, offset %u invalid magic number %04X in log segment %s, offset %u invalid record length at %X/%X: wanted %u, got %u invalid record offset at %X/%X invalid resource manager ID %u at %X/%X need to copy %lu MB (total source directory size is %lu MB)
neither BKPIMAGE_HAS_HOLE nor BKPIMAGE_IS_COMPRESSED set, but block image length is %u at %X/%X no rewind required
out of memory
out-of-order block_id %u at %X/%X out-of-sequence timeline ID %u (after %u) in log segment %s, offset %u reading WAL in target
reading source file list
reading target file list
received chunk for file "%s", offset %s, size %d
received null value for chunk for file "%s", file has been deleted
record length %u at %X/%X too long record with incorrect prev-link %X/%X at %X/%X record with invalid length at %X/%X rewinding from last common checkpoint at %X/%X on timeline %u
servers diverged at WAL position %X/%X on timeline %u
source and target cluster are on the same timeline
source and target clusters are from different systems
source data directory must be shut down cleanly
source file list is empty
source server must not be in recovery mode
symbolic link "%s" target is too long
sync of target directory failed
syncing target data directory
syntax error in history file: %s
target server must be shut down cleanly
target server needs to use either data checksums or "wal_log_hints = on"
there is no contrecord flag at %X/%X unexpected EOF while reading file "%s"
unexpected control file CRC
unexpected control file size %d, expected %d
unexpected data types in result set while fetching remote files: %u %u %u
unexpected null values in result while fetching remote files
unexpected page modification for directory or symbolic link "%s"
unexpected pageaddr %X/%X in log segment %s, offset %u unexpected result format while fetching remote files
unexpected result length while fetching remote files
unexpected result set from query
unexpected result set size while fetching remote files
unexpected result set while fetching file list
unexpected result set while fetching remote file "%s"
unexpected result while fetching remote files: %s unexpected result while sending file list: %s unrecognized result "%s" for current WAL insert location
Project-Id-Version: pg_rewind (PostgreSQL current)
Report-Msgid-Bugs-To: pgsql-bugs@postgresql.org
POT-Creation-Date: 2021-11-08 05:27+0300
PO-Revision-Date: 2021-08-14 07:50+0300
Last-Translator: Alexander Lakhin <exclusion@gmail.com>
Language-Team: Russian <pgsql-ru-general@postgresql.org>
Language: ru
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Plural-Forms: nplurals=3; plural=(n%10==1 && n%100!=11 ? 0 : n%10>=2 && n%10<=4 && (n%100<10 || n%100>=20) ? 1 : 2);
Об ошибках сообщайте по адресу <pgsql-bugs@postgresql.org>.
создание метки копии и модификация управляющего файла
--debug выдавать множество отладочных сообщений
--source-pgdata=КАТАЛОГ исходный каталог, с которым будет проведена синхронизация
--source-server=СТР_ПОДКЛ сервер, с которым будет проведена синхронизация
-?, --help показать эту справку и выйти
-D, --target-pgdata=КАТАЛОГ существующий каталог, куда будут записаны данные
-P, --progress выводить сообщения о ходе процесса
-V, --version показать версию и выйти
-n, --dry-run остановиться до внесения каких-либо изменений
блок %u
"%s" — символическая ссылка, но в этой ОС символические ссылки не поддерживаются
"%s" не является каталогом
"%s" не является обычным файлом
"%s" не является символической ссылкой
%*s/%s КБ (%d%%) скопировано %d: %X/%X - %X/%X
%s %s (%s)
%s синхронизирует кластер PostgreSQL с другой копией кластера.
%s: ПРЕДУПРЕЖДЕНИЕ: в этой ОС нельзя создавать ограниченные маркеры
%s: не удалось подготовить структуры SID (код ошибки: %lu)
%s: не удалось создать ограниченный маркер (код ошибки: %lu)
%s: не удалось получить код выхода от подпроцесса (код ошибки: %lu)
%s: не удалось открыть маркер процесса (код ошибки: %lu)
%s: не удалось перезапуститься с ограниченным маркером (код ошибки: %lu)
%s: не удалось запустить процесс для команды "%s" (код ошибки: %lu)
%s: источник не указан (требуется --source-pgdata или --source-server)
%s: целевой каталог данных не указан (--target-pgdata)
%s: указать можно только --source-pgdata либо --source-server
%s: слишком много аргументов командной строки (первый: "%s")
BKPBLOCK_HAS_DATA не установлен, но длина данных равна %u в позиции %X/%X BKPBLOCK_HAS_DATA установлен, но данных в позиции %X/%X нет BKPBLOCK_SAME_REL установлен, но предыдущее значение не задано в позиции %X/%X BKPIMAGE_HAS_HOLE не установлен, но для пропуска заданы смещение %u и длина %u в позиции %X/%X BKPIMAGE_HAS_HOLE установлен, но для пропуска заданы смещение %u и длина %u при длине образа блока %u в позиции %X/%X BKPIMAGE_IS_COMPRESSED установлен, но длина образа блока равна %u в позиции %X/%X Готово!
Ожидается числовой идентификатор линии времени.
Ожидается положение точки переключения журнала транзакций.
Ошибка, выполняется выход
Параметры:
История линии времени источника:
История линии времени получателя:
Для %s необходима программа "initdb", но она не найдена
в каталоге "%s".
Проверьте правильность установки СУБД.
Программа "initdb" найдена программой "%s",
но её версия отличается от версии %s.
Проверьте правильность установки СУБД.
Идентификаторы линий времени должны возрастать.
Идентификаторы линий времени должны быть меньше идентификатора линии-потомка.
Для дополнительной информации попробуйте "%s --help".
Использование:
%s [ПАРАМЕТР]...
файл WAL принадлежит другой СУБД: в нём указан идентификатор системы БД %s, а идентификатор системы pg_control: %s файл WAL принадлежит другой СУБД: некорректный XLOG_BLCKSZ в заголовке страницы файл WAL принадлежит другой СУБД: некорректный XLOG_SEG_SIZE в заголовке страницы Запись WAL модифицирует отношение, но тип записи не распознан
lsn: %X/%X, rmgr: %s, info: %02X
Запускать %s нужно от имени суперпользователя PostgreSQL.
буфер для метки копии слишком мал
программу не должен запускать root
попытка дублирования нулевого указателя (внутренняя ошибка)
кластеры несовместимы с этой версией pg_rewind
подключение к серверу установлено
по смещению %X/%X запрошено продолжение записи не удалось очистить search_path: %s не удалось закрыть каталог "%s": %s
не удалось закрыть файл "%s": %s
не удалось закрыть целевой файл "%s": %s
не удалось создать каталог "%s": %s
не удалось создать символическую ссылку "%s": %s
не удалось получить список файлов: %s не удалось получить с сервера файл "%s": %s не удалось найти общего предка линий времени исходного и целевого кластеров
не удалось найти предыдущую запись WAL в позиции %X/%X
не удалось найти предыдущую запись WAL в позиции %X/%X: %s
не удалось открыть каталог "%s": %s
не удалось открыть файл "%s" для чтения: %s
не удалось открыть файл "%s" для усечения: %s
не удалось открыть файл "%s": %s
не удалось открыть исходный файл "%s": %s
не удалось открыть целевой файл "%s": %s
не удалось прочитать запись WAL в позиции %X/%X
не удалось прочитать запись WAL в позиции %X/%X: %s
не удалось прочитать каталог "%s": %s
не удалось прочитать файл "%s": %s
не удалось прочитать файл "%s": %s
не удалось прочитать символическую ссылку "%s": %s
ошибка при удалении каталога "%s": %s
не удалось стереть файл "%s": %s
ошибка при удалении символической ссылки "%s": %s
не удалось переместиться в файле "%s": %s
не удалось переместиться в исходном файле: %s
не удалось переместиться в целевом файле "%s": %s
не удалось отправить данные COPY: %s не удалось отправить сообщение о завершении копирования: %s не удалось отправить список файлов: %s не удалось отправить запрос: %s не удалось перевести подключение libpq в однострочный режим
не удалось получить информацию о файле "%s": %s
не удалось усечь файл "%s" до нужного размера (%u): %s
не удалось записать файл "%s": %s
файл данных "%s" в источнике не является обычным файлом
ошибка выполнения запроса (%s) на исходном сервере: %s получен файл "%s", длина %d
на исходном сервере должен быть включён режим full_page_writes
получение сегментов файлов
некорректная контрольная сумма данных менеджера ресурсов в записи по смещению %X/%X неверное действие (CREATE) для обычного файла
неверный идентификатор блока %u в позиции %X/%X неверный сжатый образ в позиции %X/%X, блок %d неверная длина contrecord (%u) в позиции %X/%X неверный управляющий файл
неверные данные в файле истории
неверные данные в файле истории: %s
неверные информационные биты %04X в сегменте журнала %s, смещение %u неверное магическое число %04X в сегменте журнала %s, смещение %u неверная длина записи по смещению %X/%X: ожидалось %u, получено %u неверное смещение записи: %X/%X неверный ID менеджера ресурсов %u по смещению %X/%X требуется скопировать %lu МБ (общий размер исходного каталога: %lu МБ)
ни BKPIMAGE_HAS_HOLE, ни BKPIMAGE_IS_COMPRESSED не установлены, но длина образа блока равна %u в позиции %X/%X перемотка не требуется
нехватка памяти
идентификатор блока %u идёт не по порядку в позиции %X/%X нарушение последовательности ID линии времени %u (после %u) в сегменте журнала %s, смещение %u чтение WAL в целевом кластере
чтение списка исходных файлов
чтение списка целевых файлов
получен сегмент файла "%s": смещение %s, размер %d
для файла "%s" вместо сегмента получено NULL-значение, файл удалён
длина записи %u по смещению %X/%X слишком велика запись с неверной ссылкой назад %X/%X по смещению %X/%X запись с неверной длиной в позиции %X/%X перемотка от последней общей контрольной точки в позиции %X/%X на линии времени %u
Серверы разошлись в позиции WAL %X/%X на линии времени %u.
исходный и целевой кластер уже на одной линии времени
исходный и целевой кластеры относятся к разным системам
работа с исходным каталогом данных должна быть завершена штатно
список файлов в источнике пуст
исходный сервер должен выйти из режима восстановления
целевой путь символической ссылки "%s" слишком длинный
сбой синхронизации целевого каталога
синхронизация целевого каталога данных
синтаксическая ошибка в файле истории: %s
целевой сервер должен быть выключен штатно
на целевом сервере должны быть контрольные суммы данных или "wal_log_hints = on"
нет флага contrecord в позиции %X/%X неожиданный конец файла при чтении "%s"
неверная контрольная сумма управляющего файла
неверный размер управляющего файла (%d), ожидалось: %d
неожиданные типы данных в наборе результатов при получении файлов с сервера: %u %u %u
неожиданные значения NULL в результате при получении файлов с сервера
неожиданная модификация страницы для каталога или символической ссылки "%s"
неожиданный pageaddr %X/%X в сегменте журнала %s, смещение %u неожиданный формат результата при получении файлов с сервера
неожиданная длина результата при получении файлов с сервера
неожиданный результат запроса
неожиданный размер набора результатов при получении файлов с сервера
неожиданный результат при получении списка файлов
неожиданный набор результатов при получении файла "%s" с сервера
неожиданный результат при получении файлов с сервера: %s неожиданный результат при передаче списка: %s нераспознанный результат "%s" вместо текущей позиции добавления в WAL
locale/sv/LC_MESSAGES/psql-9.6.mo 0000644 00000272040 14751153420 0012055 0 ustar 00 �� : �! � �C XZ YZ oZ �Z � �Z D[ `[
y[ �[ > �[ = �[ < \ p R\ s �\ 5 7] 7 m] K �] o �] 2 a^ 4 �^ N �^ t _ Q �_ O �_ > /` A n` O �` @ a 6 Aa 0 xa N �a G �a 8 @b A yb T �b ? c L Pc A �c @ �c H d A id + �d � �d 5 me 9 �e n �e Q Lf : �f � �f ; fg y �g � h ; �h z �h T oi A �i L j B Sj \ �j 4 �j J (k \ sk 6 �k 4 l G <l = �l ; �l ( �l ; 'm ; cm ; �m ; �m 8 n _ Pn J �n F �n ` Bo h �o G p 5 Tp 2 �p X �p Q q : hq 3 �q ; �q S r M gr 9 �r @ �r 8 0s ; is @ �s K �s J 2t | }t � �t > �u F �u N v F Uv H �v - �v $ w & 8w - _w 9 �w 7 �w 2 �w 4 2x 3 gx ) �x ) �x ; �x B +y ) ny * �y * �y J �y 1 9z . kz - �z , �z 4 �z I *{ $ t{ & �{ > �{ 1 �{ & 1| ( X| J �| : �| ( } % 0} $ V} $ {} ) �} - �} N �} 9 G~ G �~ 5 �~ M �~ C M P � K � N .� K }� L ɀ 4 � K K� ( �� q �� A 2� ? t� A �� > �� � 5� # � F � 8 O� < �� M Ņ ; � 6 O� 2 �� 7 �� B � : 4� 4 o� 9 �� ? އ % � + D� 9 p� 5 �� I � K *� M v� Z ĉ S � K s� � �� N J� @ �� : ڋ ( � B >� L �� C Ό � � M �� = � � M� � � � "� 5� 9� M� ]� 0 e� $ �� # �� * ߏ %
� * 0� [� # |� < �� ݐ �� � 6 1� h� � }� : #� ^� p� |� �� �� �� �� ̒ ޒ Q � B� I V� [ ��
�� � �
-� 8� V� C c� A �� � �� �� � � $� +� , =� j� �� �� �� �� �� �� ̕ � ��
� � � '� ' 4� \� & z� ' �� 7 ɖ 0 � 2� N� ^� q� �� �� �� �� w �� %� 6� K� Q� k� ( �� �� �� ˘ Ԙ �
� #� 8� Q� ]� f� o� �� �� �� ��
�� Ù ə ̙ ֙
ܙ � � � � � �
,� :�
L� Z� & g� �� ��
��
�� ɚ ܚ �
� � 0� D� W� i� y� �� �� �� ݛ � � � 0�
B� P� `� % q� �� " �� Μ � � )� ' ?� & g� �� �� �� �� ˝ ՝
ڝ � L � A� P� n� > �� ʞ ߞ � 2
� =� D� W� k� �� �� �� �� ȟ ߟ �� X � m� v� �� ��
�� ˠ � ' � . � ! D� ' f� �� �� ��
�� ʡ � �� � :� Z� i� z� , �� �� Ģ Т ߢ � � � !� E (� n� ~� �� �� ��
�� �� �� �� ƣ ң ޣ �� � � � $� .� B�
H� V� r�
�� �� �� �� �� ͤ � � !
� /� G� 9 b� y �� 9 � F P� 5 �� B ͦ C � 5 T� : �� 9 ŧ @ �� ; @� K |� B Ȩ C � 6 O� 8 �� �� ۩ �
�� � � (�
.� 9� U� t� �� �� �� & �� � �� � � � ,� � # � # &� # J� n� " �� �� �� Ǭ ެ � �
�� � � �
)� c 4� � �� Y� K v� Q ® / � O D� U �� 5 � = � ^� , j� 4 �� " ̰ ! � � 1� >� Y� " u� + �� + ı 6 � X '� 7 �� 8 �� T � 5 F� I |� 6 Ƴ # �� = !� = _� = �� i ۴ 9 E� � �� * �� � � � @� S� Z� ^� m� �� �� �� �� �� �� ϶ # � � &� $ ?� d�
w� �� �� �� �� �� ��
�� Ʒ > з � � (� 9� C� K� Q� C ^� �� / �� ( � � � (� :� Q� ' m� �� $ �� % ٹ ! �� ) !� ( K� / t� # �� ' Ⱥ , � . � 4 L� �� ! �� - û � % � 4 8� 1 m� - �� / ͼ " �� � ' @� h� . �� ) �� % � ! � $ )� * N� + y� A �� � � & � 0 '� . X� - �� �� % Ŀ �
�
�� � # � 3� @� R� d� p� |� �� �� �� �� C �� � #� 9� C� [� k� {� ��
�� �� $ �� & � - � # 9� ]� 1 ~� ( �� ) �� + � ' /� ! W� y� # �� ! �� ( �� � � 9� V� t� �� �� �� �� ��
�� �� �
� !� .� >� Y� y� �� �� �� �� �� � $� @� ! [� }� �� 2 �� �� �� � *� G� h� 2 �� 5 �� �� �� � . 2� a� & y� # �� �� ! �� � � 2� D� ]� 6 ~� ) �� ��
�� �� �� � � .�
;� & I� p� �� �� �� �� �� �� �� �� ��
� �
� )� U 6� �� �� �� , �� �� �� � ,� ?�
S� ^� m� y� �� �� �� �� �� " ��
�� �� �� � � '�
B� 1 P� �� ��
�� �� �� �� . �� � . $�
S� a� k� q� �� ��
�� �� E �� �
� !� 3� B� Q� X� m� u� �� �� �� * �� ��
�� � � � )� 3� 9� C�
T� _� h� r� �� �� �� �� �� �� �� �� � � � "� '� 9�
B� P� W� ^� q� z� % �� �� �� �� �� �� �� �� � � $� 3� <� F�
O� Z� d� s� � �� �� �� �� �� �� �� �� �� �� �� � � � � $� 3�
C� Q� X�
j� x� �� �� �� �� �� �� �� �� �� �� � � #� ! -� 4 O�
�� �� . �� �� �� �� �� � � � 2�
;�
I�
W� e� x� �� �� �� �� " �� �� � 0� B� ]� z� / �� �� �� �� �� " � (� H� d� �� �� * ��
�� �� �� � -� E� Y� i� |� �� 0 �� + �� � � � > %�
d� o� ) {� " �� �� ��
�� �� ��
� #� (� 2� 7� G� V� e� q� v�
}� ��
��
�� �� �� �� 7 �� 2 � 6 ?� V v� �� & �� & �� . !� P� \� l�
}�
�� �� �� �� �� �� �� �� �� � � � ! *� L� T� f� s�
�� �� �� �� �� . �� � � � )�
F� Q� a� s� � �� �� �� �� ��
�� �� �� �� �� � � � <� Z� d� h� $ �� # �� �� �� 0 �� � � 5� <� S� ( g� �� �� �� �� �� �� �� �� �� �� � � , '� T� l� �� $ �� �� ' �� � #� B� \� t� �� �� ! �� �� �� �
� � (� � ,� �� �� � � � �� ��
��
� D � D `� 6 �� v �� y S� < �� :
� E E� u �� 5 � 9 7� T q� ~ �� P E� N �� I �� C /� G s� < �� 8 �� 6 1� S h� K �� C � F L� y �� H
� R V� G �� B �� M 4� C �� - �� � �� 9 �� @ �� v
� Q �� 6 �� �
� 5 �� | �� � P� 7 �� z *� S �� A �� D ;� 6 �� e �� : � N X� d �� 3 � 8 @� H y� > � < � ' >� B f� ; �� < � ? "� 6 b� ` �� L �� F G� h �� ^ �� B V� 6 �� 9 � T
� ^ _� ; �� 1 �� 8 ,� Q e� L �� < � C A� < �� = � P � Q Q� H �� � � � y 4 A H K � B � K - e / � ( � 3 � 7 1 X / � . � . � 9 ) R < | A � 2 � . . . ] R � 4 � 2 3 G 1 { : � O � & 8 % _ @ � 4 � ' � * # V N ? � ) � ( & 8 $ _ + � 2 � V � 5 :
L p
B �
J E K S � R � I 8 L � W � 2 '
K Z
) �
v �
D G < � L � F � ] & G E = � F � Q D d 6 � 0 � B U T 1 � 6 � 4 M H ' � & � 3 � 7 L Q Q � @ � [ 1 D � I � | O � E � ? / - o B � P � H 1 � z K / 5 { � � K c � � � � � � 3 � + � & ) 7 P ( � . � % � % D , ! q � � 7 � � � ; � �
' = G W j � O � � D � W : � � � � * � � V ! T c! �! �! �! �! �! �! " , " B" Y" e"
n" y" " �" �" �" �"
�" �" �" �" - # % 4# , Z# ) �# 9 �# 2 �# $ <$ O$ e$ �$ �$ �$ �$ z �$ *% =% V% `% y% & �% �% �% �% �% & "& <& W& r& &
�& �&
�& �& �& �& �& �& �& ' '
' ' &' 5' <' A' W' h' w' �' �' 4 �' �'
�' �' �' ( ( -( E( b( $ |( �( �( �( �( �( ) /) $ M) r) " �) �) �) �) �) �) * * !* L* ! e* �* �* �* �* ' �* ( + D+ J+ d+ n+ t+ �+ �+ �+ �+ k �+ , ! *, % L, B r, �, �, �, 8 - 9- @- R- f- ~-
�- �- �- �- �- ( �- . | $. �. # �. �. �. / # / 6/ ) >/ 1 h/ ! �/ ) �/ �/ " �/ 0 0 *0 % C0 i0 �0 �0
�0 �0 �0 1 �0 1 ,1 81 K1 P1 Y1 & t1 �1 H �1
�1 �1 �1 2 2
2 *2 92 A2 H2 Q2 Z2 u2
�2 �2
�2 �2 �2 �2 �2 �2 �2
3 +3 ?3 I3 Q3 c3 |3 �3 �3 �3 �3 = �3 � #4 1 �4 D �4 > 5 C Z5 @ �5 / �5 6 6 7 F6 > ~6 4 �6 F �6 @ 97 = z7 2 �7 7 �7 #8
A8 O8 b8 v8 �8 �8
�8 �8 �8 �8 + 9
:9 E9 / T9 �9 �9 �9 �9 � �9 �: �: " �: " ; 1; ! G; i;
�; ! �;
�;
�; �;
�; �;
�;
�; �; o < � y< c= Y �= W �= 8 6> Z o> \ �> = '? 9 e? �? + �? 3 �? # @ # 5@ # Y@ }@ �@ �@ �@ * �@ * A D /A T tA 9 �A ; B X ?B 7 �B M �B 0 C " OC 6 rC = �C > �C j &D ; �D �D # �D , E ;E YE tE �E �E �E �E �E �E �E �E �E �E �E F & 4F [F sF ! �F �F �F �F �F �F �F �F �F G G L G dG mG zG �G �G �G �G C �G �G - H , <H iH {H �H �H �H ) �H �H & I & 8I _I + �I + �I 4 �I "
J ' 0J + XJ * �J 7 �J �J ! K * )K TK ( uK / �K * �K ( �K & "L # IL mL + �L �L * �L , �L # ,M PM " qM ' �M ( �M 7 �M N
#N 1N - RN ) �N ) �N �N ! �N O O O #O 0O QO
]O kO
|O �O �O
�O �O �O �O N �O ! 2P TP mP uP �P �P ' �P �P �P �P ( �P % Q 2 DQ & wQ " �Q 7 �Q * �Q " $R 2 GR ) zR $ �R �R # �R %
S 2 0S ! cS �S �S ) �S �S T T %T AT MT UT aT T
�T �T �T �T �T �T U 0U HU dU * {U " �U ! �U ! �U *
V 8V QV C fV ! �V �V �V W " "W ! EW < gW 5 �W �W �W X 7 ,X dX % �X �X �X �X Y "Y <Y OY $ mY : �Y 2 �Y Z
Z Z Z
7Z
BZ PZ eZ ( qZ �Z �Z �Z �Z �Z
�Z �Z
�Z [ [ ([ 2[ :[ G[ I T[
�[ �[ �[ * �[ �[
\ %\ 1\ J\ a\ i\ x\ �\ �\ �\ �\ �\ �\ 1 �\ �\
] ] #] ;] D]
Z] / h] �] �] �] �] �] �] - �] ,^ 7 ;^
s^ �^ �^ �^ �^
�^ �^ �^ @ �^
_
'_ 5_ A_ R_ e_ l_ �_ �_ �_ �_ �_ ' �_ ` ` ` ` -` 7` @`
H` S`
d` o` x` �` �` �` �`
�` �` - �` a
1a ?a Ea Ta ^a ca ua
a �a �a �a �a �a ' �a �a �a �a b b b /b ?b Pb \b lb vb �b �b �b �b
�b �b �b # �b �b c
c c
c *c -c =c Ic Xc \c cc lc
uc �c �c �c �c �c �c
�c �c
�c d d
"d -d 7d Ad
Yd dd vd d �d / �d �d �d 1 �d )e :e Ae Me ^e oe ye �e
�e �e �e �e �e �e f $f ;f ' Mf uf $ �f �f �f �f g 8 !g Zg mg �g �g �g �g �g h h 0h 6 Eh
|h �h �h �h �h �h i !i 5i Ni - hi + �i �i �i �i = �i
j
&j 5 4j % jj �j �j
�j �j �j �j �j �j k k
k $k
3k >k Ck
Jk Xk `k lk
k �k
�k : �k 1 �k * l c :l �l ! �l % �l 4 �l !m -m ?m Tm gm sm �m �m �m �m �m �m
�m �m �m n " n )n 1n Cn On
^n in pn �n
�n : �n �n
�n
�n o
o )o <o Uo ^o fo ko po }o �o �o �o �o �o �o " �o p p $p Bp Jp Np $ kp ! �p �p �p ) �p �p �p q q 5q 3 Lq
�q
�q �q �q �q �q �q �q �q �q �q r , r Lr cr ~r ! �r �r ' �r �r s /s Is as ~s �s ! �s �s �s �s t
t t n J � � � � � � � � ) B 5 � L ( ; $ � � � ] k e ( � � � % � � � k � 7 , � � � � � / v � � �
z � T q < � v � | � � z � � � 3 � g y � � M 2 Z � � e i
* � C � � < & � � � ) Q 6 � 9 � & � T � � s � � / t � � A Y u � 0 � � � � t � - , � � � � J s ~ r � F p R � � � � � � N 3 � D � S � � Q � y � c � � � E w ` m � � � � M � , � _ U � X b + 4 ` � � � � w � � � o < � � � � [ � - . � � � 7 � y j 5 � � & � = � U l � � � � g � � Y ( � � ] � f x � } � � � " � � � T � v 0 X \ � H � b 1 � � � # � k K � � : � � � 1 � 2 * ] W � � � $ � u C � I h V x S � � � � H f � 7 [ Q � 7 � � � j c � � � � � � � � / 4 � � � 2 � � � � P r � � � i a h �
� � � � � � � � � � N � � � � 9 p w � � � o > � � R . � � ) � � � � � g 8 > L ' � � c � z x � � � U x E � G � � � � � � Y � � B � � � � � ~ � � � � � v l 8 = C � 2 � � � o � [ � � 6 � r � � � � " � ? u t � u M a � � � � � p Z � ; � � � � g h � � 9 1 � � + � � j � � � G � � � � � � | � q K � � \ � � � � � _ � O E Z i B m � � � q � � 9 K � � 5 � . � � � � O } - $ � � � G � � ( � { X � M
� � � n � ! � � r � h # � � � � [ � � � J 1 I 4 � �
P � � � � � � k � � � � � 0 � � W 5 P � " ` N O V p � I � � : t � & m 0 � W f @ � b : 7 ; R B H � L ] � � T � � � � 8 � d F � � ~ @ � � � 0 4 � � > ! � � � Q % * � o & A y � L $ � � � { = � ~ ! ^ � ! @ � � : C F � � � � � 8 V ' � � n $ � � \ � � � � � � � = - n � � � X � A \ � � _ a R �
' W D ^ j w " � � � � � � N � � � � � � � A � � l # � � � � � _ � � { O F Y 2 d � � f ? � � � e } # { � � % E � � � � � � � # + ) H ? q | � , * � � � : � � � � � �
b � < � - � I 6 ( ^ � ; � % �
|
� � D . � s @ � � � � � � a 3 � � / ' � � ' 1 � s 9 � � � ! c � ? � � � / " J � d � � � � � � � � 3 � � > % � ) � � � 4 � l � � 3 � � � � � 8 � � � . � U � � � � * � � � � � � 6 � K ,
� � m � � � � i � S ^ � � ` � � V 6 P � G } � � S � D d + Z � � � � z � � � � � + � � � 5 e
Connection options:
Display settings:
Environment variables:
For more information, type "\?" (for internal commands) or "\help" (for SQL
commands) from within psql, or consult the psql section in the PostgreSQL
documentation.
Input and output options:
Output format options:
Parser: "%s"
Parser: "%s.%s" --help=commands list backslash commands, then exit
--help=variables list special variables, then exit
(options: S = show system objects, + = additional detail)
-0, --record-separator-zero
set record separator for unaligned output to zero byte
-1 ("one"), --single-transaction
execute as a single transaction (if non-interactive)
-?, --help[=options] show this help, then exit
-A, --no-align unaligned table output mode
-E, --echo-hidden display queries that internal commands generate
-F, --field-separator=STRING
field separator for unaligned output (default: "%s")
-H, --html HTML table output mode
-L, --log-file=FILENAME send session log to file
-P, --pset=VAR[=ARG] set printing option VAR to ARG (see \pset command)
-R, --record-separator=STRING
record separator for unaligned output (default: newline)
-S, --single-line single-line mode (end of line terminates SQL command)
-T, --table-attr=TEXT set HTML table tag attributes (e.g., width, border)
-U, --username=USERNAME database user name (default: "%s")
-V, --version output version information, then exit
-W, --password force password prompt (should happen automatically)
-X, --no-psqlrc do not read startup file (~/.psqlrc)
-a, --echo-all echo all input from script
-b, --echo-errors echo failed commands
-c, --command=COMMAND run only single command (SQL or internal) and exit
-d, --dbname=DBNAME database name to connect to (default: "%s")
-e, --echo-queries echo commands sent to server
-f, --file=FILENAME execute commands from file, then exit
-h, --host=HOSTNAME database server host or socket directory (default: "%s")
-l, --list list available databases, then exit
-n, --no-readline disable enhanced command line editing (readline)
-o, --output=FILENAME send query results to file (or |pipe)
-p, --port=PORT database server port (default: "%s")
-q, --quiet run quietly (no messages, only query output)
-s, --single-step single-step mode (confirm each query)
-t, --tuples-only print rows only
-v, --set=, --variable=NAME=VALUE
set psql variable NAME to VALUE
(e.g., -v ON_ERROR_STOP=1)
-w, --no-password never prompt for password
-x, --expanded turn on expanded table output
-z, --field-separator-zero
set field separator for unaligned output to zero byte
AUTOCOMMIT if set, successful SQL commands are automatically committed
COLUMNS number of columns for wrapped format
COMP_KEYWORD_CASE determines the case used to complete SQL key words
[lower, upper, preserve-lower, preserve-upper]
DBNAME the currently connected database name
ECHO controls what input is written to standard output
[all, errors, none, queries]
ECHO_HIDDEN if set, display internal queries executed by backslash commands;
if set to "noexec", just show without execution
ENCODING current client character set encoding
FETCH_COUNT the number of result rows to fetch and display at a time
(default: 0=unlimited)
HISTCONTROL controls command history [ignorespace, ignoredups, ignoreboth]
HISTFILE file name used to store the command history
HISTSIZE the number of commands to store in the command history
HOST the currently connected database server host
IGNOREEOF if unset, sending an EOF to interactive session terminates application
LASTOID value of the last affected OID
NAME=VALUE [NAME=VALUE] psql ...
or \setenv NAME [VALUE] inside psql
ON_ERROR_ROLLBACK if set, an error doesn't stop a transaction (uses implicit savepoints)
ON_ERROR_STOP stop batch execution after error
PAGER name of external pager program
PGAPPNAME same as the application_name connection parameter
PGDATABASE same as the dbname connection parameter
PGHOST same as the host connection parameter
PGPASSFILE password file name
PGPASSWORD connection password (not recommended)
PGPORT same as the port connection parameter
PGUSER same as the user connection parameter
PORT server port of the current connection
PROMPT1 specifies the standard psql prompt
PROMPT2 specifies the prompt used when a statement continues from a previous line
PROMPT3 specifies the prompt used during COPY ... FROM STDIN
PSQLRC alternative location for the user's .psqlrc file
PSQL_EDITOR, EDITOR, VISUAL
editor used by the \e, \ef, and \ev commands
PSQL_EDITOR_LINENUMBER_ARG
how to specify a line number when invoking the editor
PSQL_HISTORY alternative location for the command history file
QUIET run quietly (same as -q option)
SHELL shell used by the \! command
SHOW_CONTEXT controls display of message context fields [never, errors, always]
SINGLELINE end of line terminates SQL command mode (same as -S option)
SINGLESTEP single-step mode (same as -s option)
TMPDIR directory for temporary files
USER the currently connected database user
VERBOSITY controls verbosity of error reports [default, verbose, terse]
\! [COMMAND] execute command in shell or start interactive shell
\? [commands] show help on backslash commands
\? options show help on psql command-line options
\? variables show help on special variables
\C [STRING] set table title, or unset if none
\H toggle HTML output mode (currently %s)
\T [STRING] set HTML <table> tag attributes, or unset if none
\a toggle between unaligned and aligned output mode
\c[onnect] {[DBNAME|- USER|- HOST|- PORT|-] | conninfo}
connect to new database (currently "%s")
\c[onnect] {[DBNAME|- USER|- HOST|- PORT|-] | conninfo}
connect to new database (currently no connection)
\cd [DIR] change the current working directory
\conninfo display information about current connection
\copy ... perform SQL COPY with data stream to the client host
\copyright show PostgreSQL usage and distribution terms
\crosstabview [COLUMNS] execute query and display results in crosstab
\dA[+] [PATTERN] list access methods
\dC[+] [PATTERN] list casts
\dD[S+] [PATTERN] list domains
\dE[S+] [PATTERN] list foreign tables
\dF[+] [PATTERN] list text search configurations
\dFd[+] [PATTERN] list text search dictionaries
\dFp[+] [PATTERN] list text search parsers
\dFt[+] [PATTERN] list text search templates
\dL[S+] [PATTERN] list procedural languages
\dO[S+] [PATTERN] list collations
\dT[S+] [PATTERN] list data types
\d[S+] list tables, views, and sequences
\d[S+] NAME describe table, view, sequence, or index
\da[S] [PATTERN] list aggregates
\db[+] [PATTERN] list tablespaces
\dc[S+] [PATTERN] list conversions
\dd[S] [PATTERN] show object descriptions not displayed elsewhere
\ddp [PATTERN] list default privileges
\des[+] [PATTERN] list foreign servers
\det[+] [PATTERN] list foreign tables
\deu[+] [PATTERN] list user mappings
\dew[+] [PATTERN] list foreign-data wrappers
\df[antw][S+] [PATRN] list [only agg/normal/trigger/window] functions
\dg[S+] [PATTERN] list roles
\di[S+] [PATTERN] list indexes
\dl list large objects, same as \lo_list
\dm[S+] [PATTERN] list materialized views
\dn[S+] [PATTERN] list schemas
\do[S+] [PATTERN] list operators
\dp [PATTERN] list table, view, and sequence access privileges
\drds [PATRN1 [PATRN2]] list per-database role settings
\ds[S+] [PATTERN] list sequences
\dt[S+] [PATTERN] list tables
\du[S+] [PATTERN] list roles
\dv[S+] [PATTERN] list views
\dx[+] [PATTERN] list extensions
\dy[+] [PATTERN] list event triggers
\e [FILE] [LINE] edit the query buffer (or file) with external editor
\echo [STRING] write string to standard output
\ef [FUNCNAME [LINE]] edit function definition with external editor
\encoding [ENCODING] show or set client encoding
\errverbose show most recent error message at maximum verbosity
\ev [VIEWNAME [LINE]] edit view definition with external editor
\f [STRING] show or set field separator for unaligned query output
\g [FILE] or ; execute query (and send results to file or |pipe)
\gexec execute query, then execute each value in its result
\gset [PREFIX] execute query and store results in psql variables
\h [NAME] help on syntax of SQL commands, * for all commands
\i FILE execute commands from file
\ir FILE as \i, but relative to location of current script
\l[+] [PATTERN] list databases
\lo_export LOBOID FILE
\lo_import FILE [COMMENT]
\lo_list
\lo_unlink LOBOID large object operations
\o [FILE] send all query results to file or |pipe
\p show the contents of the query buffer
\password [USERNAME] securely change the password for a user
\prompt [TEXT] NAME prompt user to set internal variable
\pset [NAME [VALUE]] set table output option
(NAME := {border|columns|expanded|fieldsep|fieldsep_zero|
footer|format|linestyle|null|numericlocale|pager|
pager_min_lines|recordsep|recordsep_zero|tableattr|title|
tuples_only|unicode_border_linestyle|
unicode_column_linestyle|unicode_header_linestyle})
\q quit psql
\qecho [STRING] write string to query output stream (see \o)
\r reset (clear) the query buffer
\s [FILE] display history or save it to file
\set [NAME [VALUE]] set internal variable, or list all if no parameters
\setenv NAME [VALUE] set or unset environment variable
\sf[+] FUNCNAME show a function's definition
\sv[+] VIEWNAME show a view's definition
\t [on|off] show only rows (currently %s)
\timing [on|off] toggle timing of commands (currently %s)
\unset NAME unset (delete) internal variable
\w FILE write query buffer to file
\watch [SEC] execute query every SEC seconds
\x [on|off|auto] toggle expanded output (currently %s)
\z [PATTERN] same as \dp
border border style (number)
columns target width for the wrapped format
expanded (or x) expanded output [on, off, auto]
fieldsep field separator for unaligned output (default "%s")
fieldsep_zero set field separator for unaligned output to zero byte
footer enable or disable display of the table footer [on, off]
format set output format [unaligned, aligned, wrapped, html, asciidoc, ...]
linestyle set the border line drawing style [ascii, old-ascii, unicode]
null set the string to be printed in place of a null value
numericlocale enable or disable display of a locale-specific character to separate
groups of digits [on, off]
pager control when an external pager is used [yes, no, always]
psql --pset=NAME[=VALUE]
or \pset NAME [VALUE] inside psql
psql --set=NAME=VALUE
or \set NAME VALUE inside psql
psql [OPTION]... [DBNAME [USERNAME]]
recordsep record (line) separator for unaligned output
recordsep_zero set record separator for unaligned output to zero byte
set NAME=VALUE
psql ...
or \setenv NAME [VALUE] inside psql
tableattr (or T) specify attributes for table tag in html format or proportional
column widths for left-aligned data types in latex-longtable format
title set the table title for any subsequently printed tables
tuples_only if set, only actual table data is shown
unicode_border_linestyle
unicode_column_linestyle
unicode_header_linestyle
set the style of Unicode line drawing [single, double]
"%s.%s" is not a view
%d connection %d connections %s %s %s (every %gs)
%s
%s (%s, server %s)
%s (every %gs)
%s: %s
%s: -1 can only be used in non-interactive mode
%s: cannot copy from/to a directory
%s: could not delete variable "%s"
%s: could not find own program executable
%s: could not open log file "%s": %s
%s: could not set printing parameter "%s"
%s: could not set variable "%s"
%s: current transaction is aborted
%s: invalid encoding name or conversion procedure not found
%s: not connected to a database
%s: out of memory
%s: unknown transaction status
%s: warning: extra command-line argument "%s" ignored
(%lu row) (%lu rows) ***(Single step mode: verify command)*******************************************
%s
***(press return to proceed or enter x and return to cancel)********************
********* QUERY **********
%s
**************************
+ opt(%d) = |%s|
, clustered , deferrable , initially deferred , invalid , predicate (%s) , replica identity , tablespace "%s" Access privileges All connection parameters must be supplied because no database connection exists
Argument data types Asynchronous notification "%s" received from server process with PID %d.
Asynchronous notification "%s" with payload "%s" received from server process with PID %d.
Attributes Available help:
Border style is %d.
Bypass RLS COPY data transfer failed: %s Call Handler Cannot add cell to table content: total cell count of %d exceeded.
Cannot add header to table content: column count of %d exceeded.
Cannot login Check Check constraints: Child tables Collate Column Column privileges Command: %s
Description: %s
Syntax:
%s
Composite type "%s.%s" Connection
Create DB Create role Ctype Database Default access privileges Default footer is off.
Default footer is on.
Default? Definition Description Destination Dictionaries Did not find any extension named "%s".
Did not find any extensions.
Did not find any relation named "%s".
Did not find any relation with OID %s.
Did not find any text search configuration named "%s".
Did not find any text search parser named "%s".
Disabled internal triggers: Disabled rules: Disabled triggers: Disabled user triggers: Elements Enabled Encoding End parse Enter data to be copied followed by a newline.
End with a backslash and a period on a line by itself, or an EOF signal. Enter it again: Enter new password: Event Expanded display is off.
Expanded display is on.
Expanded display is used automatically.
FDW Options FDW Options: (%s) Failed.
Field separator is "%s".
Field separator is zero byte.
Foreign table "%s.%s" Foreign-data wrapper Foreign-key constraints: Formatting
Function General
General options:
Get headline Get next token Get token types Handler Has OIDs: yes Help
ID Implicit? Index Index "%s.%s" Indexes: Informational
Inherits Init Init options Inline Handler Input/Output
Internal Language Internal name Interrupted
Invalid command \%s. Try \? for help.
Language Large Objects
Large objects Left arg type Lexize Line style is %s.
List of access methods List of aggregate functions List of casts List of collations List of conversions List of data types List of databases List of domains List of event triggers List of foreign servers List of foreign tables List of foreign-data wrappers List of functions List of installed extensions List of languages List of operators List of relations List of roles List of schemas List of settings List of specially treated variables
List of tablespaces List of text search configurations List of text search dictionaries List of text search parsers List of text search templates List of user mappings Locale-adjusted numeric output is off.
Locale-adjusted numeric output is on.
Location Materialized view "%s.%s" Member of Method Modifier Modifiers Name No changes No connections No help available for "%s".
Try \h with no arguments to see available help.
No inheritance No matching relations found.
No matching settings found.
No per-database role settings support in this server version.
No relations found.
No settings found.
Null display is "%s".
Number of child tables: %d (Use \d+ to list them.) Object Object Description Object descriptions Objects in extension "%s" Operating System
Options Output format is %s.
Owned by: %s Owner Pager is always used.
Pager is used for long output.
Pager usage is off.
Pager won't be used for less than %d line.
Pager won't be used for less than %d lines.
Parallel Password encryption failed.
Password for user %s: Password valid until Password: Passwords didn't match.
Policies Policies (forced row security enabled): Policies (forced row security enabled): (none) Policies (row security disabled): Policies (row security enabled): (none) Policies: Previous connection kept
Procedure Query Buffer
Query buffer is empty. Query buffer reset (cleared). Record separator is "%s".
Record separator is <newline>.
Record separator is zero byte.
Referenced by: Replica Identity Replication Report bugs to <pgsql-bugs@postgresql.org>.
Result data type Result type Right arg type Role Role name Rules firing always: Rules firing on replica only: Rules: SSL connection (protocol: %s, cipher: %s, bits: %s, compression: %s)
STATEMENT: %s
Schema Security Sequence "%s.%s" Server Server: %s Settings Size Source Source code Source type Special relation "%s.%s" Start parse Stats target Storage Succeeded.
Superuser TOAST table "%s.%s" Table Table "%s.%s" Table attributes are "%s".
Table attributes unset.
Tablespace Tablespace: "%s" Tags Target type Target width is %d.
Target width is unset.
Template Text search configuration "%s" Text search configuration "%s.%s" Text search parser "%s" Text search parser "%s.%s" The connection to the server was lost. Attempting reset: The input is a PostgreSQL custom-format dump.
Use the pg_restore command-line client to restore this dump to a database.
The server (version %s) does not support access methods.
The server (version %s) does not support altering default privileges.
The server (version %s) does not support collations.
The server (version %s) does not support editing function source.
The server (version %s) does not support editing view definitions.
The server (version %s) does not support extensions.
The server (version %s) does not support foreign servers.
The server (version %s) does not support foreign tables.
The server (version %s) does not support foreign-data wrappers.
The server (version %s) does not support full text search.
The server (version %s) does not support savepoints for ON_ERROR_ROLLBACK.
The server (version %s) does not support showing function source.
The server (version %s) does not support showing view definitions.
The server (version %s) does not support tablespaces.
The server (version %s) does not support user mappings.
There is no previous error. Time: %.3f ms
Timing is off. Timing is on. Title is "%s".
Title is unset.
Token Token name Token types for parser "%s" Token types for parser "%s.%s" Triggers firing always: Triggers firing on replica only: Triggers: Trusted Try "%s --help" for more information.
Tuples only is off.
Tuples only is on.
Type Type "help" for help.
Type: \copyright for distribution terms
\h for help with SQL commands
\? for help with psql commands
\g or terminate with semicolon to execute query
\q to quit
Typed table of type: %s Unicode border line style is "%s".
Unicode column line style is "%s".
Unicode header line style is "%s".
Unlogged index "%s.%s" Unlogged materialized view "%s.%s" Unlogged table "%s.%s" Usage:
Use "\q" to leave %s.
User name Validator Value Variables
Version View "%s.%s" View definition: Volatility WARNING: %s major version %s, server major version %s.
Some psql features might not work.
WARNING: Console code page (%u) differs from Windows code page (%u)
8-bit characters might not work correctly. See psql reference
page "Notes for Windows users" for details.
Wrote history to file "%s".
You are connected to database "%s" as user "%s" on host "%s" at port "%s".
You are connected to database "%s" as user "%s" via socket in "%s" at port "%s".
You are currently not connected to a database.
You are now connected to database "%s" as user "%s" on host "%s" at port "%s".
You are now connected to database "%s" as user "%s" via socket in "%s" at port "%s".
You are now connected to database "%s" as user "%s".
You are using psql, the command-line interface to PostgreSQL. \!: failed
\%s: could not change directory to "%s": %s
\%s: environment variable name must not contain "="
\%s: error while setting variable
\%s: extra argument "%s" ignored
\%s: missing required argument
\connect: %s \copy: arguments required
\copy: parse error at "%s"
\copy: parse error at end of line
\crosstabview: ambiguous column name: "%s"
\crosstabview: column name not found: "%s"
\crosstabview: column number %d is out of range 1..%d
\crosstabview: data column must be specified when query returns more than three columns
\crosstabview: maximum number of columns (%d) exceeded
\crosstabview: query must return at least three columns
\crosstabview: query result contains multiple data values for row "%s", column "%s"
\crosstabview: statement did not return a result set
\crosstabview: vertical and horizontal headers must be different columns
\df does not take a "w" option with server version %s
\df only takes [antwS+] as options
\pset: allowed Unicode border line styles are single, double
\pset: allowed Unicode column line styles are single, double
\pset: allowed Unicode header line styles are single, double
\pset: allowed formats are unaligned, aligned, wrapped, html, asciidoc, latex, latex-longtable, troff-ms
\pset: allowed line styles are ascii, old-ascii, unicode
\pset: unknown option: %s
\watch cannot be used with COPY
\watch cannot be used with an empty query
abbreviated_grant_or_revoke abort the current transaction aborted because of read failure access_method_type action agg aggregate_name aggregate_signature alias alignment allowconn always analyze_function and aggregate_signature is: and conflict_action is one of: and grouping_element can be one of: and like_option is: and table_constraint is: and table_constraint_using_index is: and with_query is: arg_data_type arg_name arg_type argmode argname argtype argument argument_type arguments attempt to \gset into specially treated variable "%s" ignored
attribute attribute_name attribute_option base_type boolean cache call_handler cancel a transaction that was earlier prepared for two-phase commit canceled by user cannot duplicate null pointer (internal error)
cannot escape without active connection
canonical_function category change a database change a database role change a run-time parameter change a server configuration parameter change role name or membership change the definition of a collation change the definition of a conversion change the definition of a domain change the definition of a foreign server change the definition of a foreign table change the definition of a foreign-data wrapper change the definition of a function change the definition of a large object change the definition of a materialized view change the definition of a procedural language change the definition of a row level security policy change the definition of a rule change the definition of a schema change the definition of a sequence generator change the definition of a table change the definition of a tablespace change the definition of a text search configuration change the definition of a text search dictionary change the definition of a text search parser change the definition of a text search template change the definition of a trigger change the definition of a type change the definition of a user mapping change the definition of a view change the definition of an aggregate function change the definition of an event trigger change the definition of an extension change the definition of an index change the definition of an operator change the definition of an operator class change the definition of an operator family change the ownership of database objects owned by a database role channel check_expression child process exited with exit code %d child process exited with unrecognized status %d child process was terminated by exception 0x%X child process was terminated by signal %d: %s close a cursor cluster a table according to an index code collatable collate %s collation collect statistics about a database column_alias column_constraint column_definition column_name column_type com_op combinefunc command command not executable command not found commit a transaction that was earlier prepared for two-phase commit commit the current transaction compute a set of rows condition configuration_parameter conflict_action conflict_target connection to server was lost
connlimit constraint constraint_name copy data between a file and a table could not change directory to "%s": %s could not close pipe to external command: %s
could not execute command "%s": %s
could not find a "%s" to execute could not get home directory for user ID %ld: %s
could not identify current directory: %s could not locate temporary directory: %s
could not look up effective user ID %ld: %s could not open temporary file "%s": %s
could not parse reloptions array
could not read binary "%s" could not read from input file: %s
could not read symbolic link "%s" could not save history to file "%s": %s
could not set variable "%s"
could not start /bin/sh
could not start editor "%s"
could not stat file "%s": %s
could not write COPY data: %s
count create a new database create new rows in a table cursor_name data_type database_name deallocate a prepared statement default default %s default_expr define a cursor define a new access method define a new aggregate function define a new cast define a new collation define a new data type define a new database role define a new domain define a new encoding conversion define a new event trigger define a new foreign server define a new foreign table define a new foreign-data wrapper define a new function define a new index define a new mapping of a user to a foreign server define a new materialized view define a new operator define a new operator class define a new operator family define a new procedural language define a new rewrite rule define a new row level security policy for a table define a new savepoint within the current transaction define a new schema define a new sequence generator define a new table define a new table from the results of a query define a new tablespace define a new text search configuration define a new text search dictionary define a new text search parser define a new text search template define a new transform define a new trigger define a new view define access privileges define default access privileges define or change a security label applied to an object define or change the comment of an object definer definition delete delete rows of a table delimiter delimiter_character deserialfunc dest_encoding destroy a previously defined savepoint dictionary_name direction directory disabled discard session state domain constraint domain_constraint domain_name element empty a table or set of tables enabled encoding encoding_name end_function environment variable PSQL_EDITOR_LINENUMBER_ARG must be set to specify a line number
escape_character event exclude_element exclude_element in an EXCLUDE constraint is: execute a prepared statement execute an anonymous code block execution_cost existing_collation existing_enum_value expression extension_name family_name fdw_name ffunc filename filter_value filter_variable for table "%s.%s" force a transaction log checkpoint foreign table format_name from_item from_sql_function_name function function name is required
function_name garbage-collect and optionally analyze a database generate a notification gettoken_function group_name grouping_element handler_function headline_function history is not supported by this installation
immutable import table definitions from a foreign server in assignment increment index index_column_name index_expression index_method index_name index_parameters index_parameters in UNIQUE, PRIMARY KEY, and EXCLUDE constraints are: index_predicate init_function initial_condition inline_handler input_function insert install an extension integer internallength invalid binary "%s" invalid command \%s
invalid line number: %s
invalid output format (internal error): %d invoker istemplate join_column join_condition join_proc join_type label lang_name large_object_oid lc_collate lc_ctype left_type lexize_function lextypes_function like_option like_type link_symbol listen for a notification load a shared library file local socket local_schema locale lock a table lockmode loid materialized view maxvalue member_object method mffunc minitial_condition minvalue minvfunc more than one row returned for \gset
msfunc mstate_data_size mstate_data_type name neg_op new_attribute_name new_column_name new_constraint_name new_dictionary new_enum_value new_name new_owner new_role new_schema new_table new_tablespace new_version no no query buffer
no rows returned for \gset
normal not null null_string obj_file object_name off old_dictionary old_role old_version on op_type opclass operator operator class operator family operator_name option or the old syntax out of memory out of memory
output_expression output_function output_name parameter parent_table parser_name password payload pclose failed: %s policy_name position a cursor predicate preferred prepare a statement for execution prepare the current transaction for two-phase commit primary key, provider psql is the PostgreSQL interactive terminal.
psql variables:
query quote_character rebuild indexes receive_function refcolumn referenced_table_name reftable relation_name remote_schema remove a cast remove a collation remove a conversion remove a data type remove a database remove a database role remove a domain remove a foreign server descriptor remove a foreign table remove a foreign-data wrapper remove a function remove a materialized view remove a procedural language remove a rewrite rule remove a row level security policy from a table remove a schema remove a sequence remove a table remove a tablespace remove a text search configuration remove a text search dictionary remove a text search parser remove a text search template remove a transform remove a trigger remove a user mapping for a foreign server remove a view remove access privileges remove an access method remove an aggregate function remove an event trigger remove an extension remove an index remove an operator remove an operator class remove an operator family remove database objects owned by a database role replace the contents of a materialized view replica res_proc restart restore the value of a run-time parameter to the default value restricted result_rows retrieve rows from a query using a cursor retrieve rows from a table or view rettype rewrite_rule_name right_type role_name role_specification roll back to a savepoint rule rule_name safe sampling_method savepoint_name schema_element schema_name seed select send_function sequence sequence_name serialfunc server_name server_type server_version set constraint check timing for the current transaction set the characteristics of the current transaction set the current user identifier of the current session set the session user identifier and the current user identifier of the current session sfunc show the execution plan of a statement show the value of a run-time parameter skipping recursive expansion of variable "%s"
snapshot_id sort_expression sort_family_name sort_operator source_config source_encoding source_table source_type special stable start start a transaction block start_function state_data_size state_data_type statement stop listening for a notification storage storage_parameter storage_type strategy_number sub-SELECT subtype subtype_diff_function subtype_operator_class support_number tab completion query failed: %s
Query was:
%s
table table constraint table_constraint table_constraint_using_index table_name tablespace_name tablespace_option target_role target_type template text timestamp timezone to_sql_function_name token_type transaction_id transaction_mode trigger trigger_name trying to exit copy mode type type_modifier_input_function type_modifier_output_function type_name uid unexpected PQresultStatus: %d
unexpected result status for \watch
unexpected transaction status (%d)
unique, unknown unrecognized value "%s" for "%s"; assuming "%s"
unsafe unterminated quoted string
update update rows of a table user does not exist user name lookup failure: error code %lu user_name using_expression valfunction validator_function value values version view view name is required
view_option_name view_option_value volatile where abbreviated_grant_or_revoke is one of: where action is one of: where aggregate_signature is: where column_constraint is: where conflict_target can be one of: where constraint is: where direction can be empty or one of: where event can be one of: where from_item can be one of: where lockmode is one of: where member_object is: where option can be one of: where option can be: where role_specification can be: where transaction_mode is one of: window window_definition window_name with_query with_query_name yes Project-Id-Version: PostgreSQL 9.6
Report-Msgid-Bugs-To: pgsql-bugs@postgresql.org
POT-Creation-Date: 2021-11-07 09:51+0000
PO-Revision-Date: 2021-11-07 21:00+0100
Last-Translator: Dennis Björklund <db@zigo.dhs.org>
Language-Team: Swedish <pgsql-translators@postgresql.org>
Language: sv
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Plural-Forms: nplurals=2; plural=(n != 1);
Flaggor för anslutning:
Visningsinställningar:
Omgivningsvariabler:
För mer information, skriv "\?" (för interna kommandon) eller
"\help" (för SQL-kommandon) i psql, eller läs avsnittet om psql
i PostgreSQL-dokumentationen.
Flaggor för in-/utmatning:
Flaggor för utdataformat:
Parser: "%s"
Parser: "%s.%s" --help=commands lista bakstreck-kommandon, avsluta sedan
--help=variabler lista speciella variabler, avsluta sedan
(flaggor: S = lista systemobjekt, + = mer detaljer)
-0, --record-separator=zero
sätt postseparator för icke justerad utdata till noll-byte
-1 ("ett"), --single-transaction
kör kommandofilen som en transaktion (om icke-interaktiv)
-?, --help[=alternativ] visa denna hjälp, avsluta sedan
-A, --no-align ojusterad utskrift av tabeller
-E, --echo-hidden visa frågor som interna kommandon skapar
-F, --field-separator=STRÄNG
fältseparator för icke justerad utdata (standard: "%s")
-H, --html HTML-utskrift av tabeller
-L, --log-file=FILENAME skicka sessions-logg till fil
-P, --pset=VAR[=ARG] sätt utskriftsvariabel VAR till ARG (se kommando \pset)
-R, --record-separator=STRÄNG
sätt postseparator för icke justerad utdata (standard: newline)
-S, --single-line enradsläge (slutet på raden avslutar SQL-kommando)
-T, --table-attr=TEXT sätt HTML-tabellers flaggor (t.ex. width, border)
-U, --username=ANVNAMN användarnamn för databasen (standard: "%s")
-V, --version visa versionsinformation, avsluta sedan
-W, --password fråga om lösenord (borde ske automatiskt)
-X, --no-psqlrc läs inte startfilen (~/.psqlrc)
-a, --echo-all visa all indata från skript
-b, --echo-errors visa misslyckade kommandon
-c, --command=KOMMANDO kör ett kommando (SQL eller internt) och avsluta sedan
-d, --dbname=DBNAMN databasnamn att koppla upp mot (standard: "%s")
-e, --echo-queries visa kommandon som skickas till servern
-f, --file=FILNAMN kör kommandon från fil och avsluta sedan
-h, --host=VÄRDNAMN databasens värdnamn eller uttagkatalog (socket)
(standard: "%s")
-l, --list lista befintliga databaser och avsluta sedan
-n, --no-readline slå av förbättrad kommandoradsredigering (readline)
-o, --output=FILNAMN skriv frågeresultat till fil (eller |rör)
-p, --port=PORT databasens serverport (standard: "%s")
-q, --quiet kör tyst (inga meddelanden, endast frågeutdata)
-s, --single-step stegningsläge (bekräfta varje fråga)
-t, --tuples-only visa endast rader
-v, --set=, --variale=NAMN=VÄRDE
sätt psql-variabel NAMN till VÄRDE
(t.ex. -v ON_ERROR_STOP=1)
-w, --no-password fråga aldrig efter lösenord
-x, --expanded slå på utökad utsrift av tabeller
-z, --field-separator-zero
sätt fältseparator för icke justerad utdata till noll-byte
AUTOCOMMIT om satt, efterföljande SQL-kommandon commit:as automatiskt
COLUMNS antal kolumner i wrappade format
COMP_KEYWORD_CASE bestämmer skiftläge för att komplettera SQL-nyckelord
[lower, upper, preserve-lower, preserve-upper]
DBNAME den uppkopplade databasens namn
ECHO bestämmer vilken indata som skrivs till standard ut
[all, errors, none, queries]
ECHO_HIDDEN om satt, visa interna frågor som körs av backåtstreckkommandon:
om satt till "noexec", bara visa dem utan att köra
ENCODING aktuell teckenkodning för klient
FETCH_COUNT antal resultatrader som hämtas och visas åt gången
(standard: 0=obegränsat)
HISTCONTROL styr kommandohistoriken [ignorespace, ignoredups, ignoreboth]
HISTFILE filnamn för att spara kommandohistoriken i
HISTSIZE antal kommandon att spara i kommandohistoriken
HOST den uppkopplade databasens värd
IGNOREEOF om ej satt, att skicka en EOF till en interaktiv session avslutar applikationen
LASTOID värdet av den senast påverkade OID
NAMN=VÄRDE [NAMN=VÄRDE] psql ...
eller \setenv NAMN [VÄRDE] inne psql
ON_ERROR_ROLLBACK om satt, ett fel stoppar inte en transaktion (använder implicita sparpunkter)
ON_ERROR_STOP avsluta batchkörning vid fel
PAGER namnet på den externa pageneraren
PGAPPNAME samma som anslutningsparametern "application_name"
PGDATABASE samma som anslutningsparametern "dbname"
PGHOST samma som anslutningsparametern "host"
PGPASSFILE lösenordsfilnamn
PGPASSWORD uppkoppingens lösenord (rekommenderas inte)
PGPORT samma som anslutingsparametern "port"
PGUSER samma som anslutningsparametern "user"
PORT värdport för den aktuella uppkopplingen
PROMPT1 anger standardprompten för psql
PROMPT2 anger den prompt som används om en sats forsätter på efterföljande rad
PROMPT3 anger den prompt som används för COPY ... FROM STDIN
PSQLRC alternativ plats för användarens ".psqlrc"-fil
PSQL_EDITOR, EDITOR, VISUAL
redigerare som används av kommanona \e, \ef och \ev
PSQL_EDITOR_LINENUMBER_ARG
hur radnummer anges när redigerare startas
PSQL_HISTORY alternativ plats för kommandohistorikfilen
QUIET kör tyst (samma som flaggan -q)
SHELL skalet som används av kommandot \!
SHOW_CONTEXT styr visning av meddelandekontextfält [never, errors, always]
SINGLELINE läge där slut på raden avslutar SQL-kommandon (samma som flaggan -S )
SINGLESTEP stegningsläge (samma som flaggan -s)
TMPDIR katalog för temporärfiler
USER den uppkopplade databasanvändaren
VERBOSITY styr verbositet för felrapporter [default, verbose, terse]
\! [KOMMANDO] kör kommando i skal eller starta interaktivt skal
\? [kommandon] visa hjälp om backstreckkommandon
\? options visa hjälp för psqls kommandoradflaggor
\? variables visa hjälp om speciella variabler
\C [TEXT] sätt tabelltitel, eller nollställ
\H slå på/av HTML-utskriftsläge (för närvarande: %s)
\T [TEXT] sätt HTML-tabellens <table>-attribut, eller nollställ
\a byt mellan ojusterat och justerat utdataformat
\c[onnect] {[DBNAMN|- ANVÄNDARE|- VÄRD|- PORT|-] | conninfo}
koppla upp mot ny databas (för närvarande "%s")
\c[onnect] {[DBNAMN|- ANVÄNDARE|- VÄRD|- PORT|-] | conninfo}
koppla upp mot ny databas (för närvarande ingen uppkoppling)
\cd [KATALOG] byt den aktuella katalogen
\conninfo visa information om aktuell uppkoppling
\copy ... utför SQL COPY med dataström till klientvärden
\copyright visa PostgreSQL-upphovsrättsinformation
\crosstabview [KOLUMNER] kör fråga och visa resultatet i en korstabell
\dA[+] [MALL] lista accessmetoder
\dC[+] [MALL] lista typomvandlingar
\dD[S+] [MALL] lista domäner
\dE[S+] [MALL] lista främmande tabeller
\dF[+] [MALL] lista textsökkonfigurationer
\dFd[+] [MALL] lista textsökordlistor
\dFp[+] [MALL] lista textsökparsrar
\dFt[+] [MALL] lista textsökmallar
\dL[S+] [MALL] lista procedurspråk
\dO[S+] [MALL] lista jämförelser (collation)
\dT[S+] [MALL] lista datatyper
\d[S+] lista tabeller, vyer och sekvenser
\d[S+] NAMN beskriv tabell, vy, sekvens eller index
\da[S] [MALL] lista aggregatfunktioner
\db[+] [MALL] lista tabellutrymmen
\dc[S+] [MALL] lista konverteringar
\dd[S] [MALL] visa objektbeskrivning som inte visas på andra ställen
\ddp [MALL] lista standardrättigheter
\des[+] [MALL] lista främmande servrar
\det[+] [MALL] lista främmande tabeller
\deu[+] [MALL] lista användarmappning
\dew[+] [MALL] lista främmande data-omvandlare
\df[antw][S+] [MALL] lista [endast agg/normala/utlösar/window] funktioner
\dg[S+] [MALL] lista roller
\di[S+] [MALL] lista index
\dl lista stora objekt, samma som \lo_list
\dm[S+] [MALL] lista materialiserade vyer
\dn[S+] [MALL] lista scheman
\do[S+] [MALL] lista operatorer
\dp [MALL] lista åtkomsträttigheter för tabeller, vyer och sekvenser
\drds [MALL1 [MALL2]] lista rollinställningar per databas
\ds[S+] [MALL] lista sekvenser
\dt[S+] [MALL] lista tabeller
\du[S+] [MALL] lista roller
\dv[S+] [MALL] lista vyer
\dx[+] [MALL] lista utökningar
\dy[+] [MALL] lista händelseutlösare
\e [FIL] [RAD] redigera frågebufferten (eller filen) med extern redigerare
\echo [TEXT] skriv text till standard ut
\ef [FUNKNAMN [RAD]] redigera funktionsdefinition med extern redigerare
\encoding [KODNING] visa eller sätt klientens teckenkodning
\errverbose visa senste felmeddelande vid maximal verbositet
\ev [FUNKNAMN [RAD]] redigera vydefinition med extern redigerare
\f [TEXT] visa eller sätt fältseparatorn för ojusterad utmatning
\g [FILNAMN] eller ; kör frågan (och skriv resultatet till fil eller |rör)
\gexec kör fråga, kör sen varje värde i resultatet
\gset [PREFIX] kör frågan och spara resultatet i psql-variabler
\h [NAMN] hjälp med syntaxen för SQL-kommandon, * för alla kommandon
\i FILNAMN kör kommandon från fil
\ir FIL som \i, men relativt platsen för aktuellt script
\l[+] [MALL] lista databaser
\lo_export LOBOID FIL
\lo_import FIL [KOMMENTAR]
\lo_list
\lo_unlink LOBOID operationer på stora objekt
\o [FIL] skicka frågeresultat till fil eller |rör
\p visa innehållet i frågebufferten
\password [ANVÄNDARNAMN] byt användares lösenord på ett säkert sätt
\prompt [TEXT] NAMN be användaren att sätta en intern variabel
\pset [NAMN [VÄRDE]] sätt utmatningsalternativ för tabeller
(NAMN := {border|columns|expanded|fieldsep|fieldsep_zero|
footer|format|linestyle|null|numericlocale|pager|
pager_min_lines|recordsep|recordsep_zero|tableattr|title|
tuples_only|unicode_border_linestyle|
unicode_column_linestyle|unicode_header_linestyle})
\q avsluta psql
\qecho [TEXT] skriv text till frågeutdataströmmen (se \o)
\r nollställ (radera) frågebufferten
\s [FILNAMN] visa kommandohistorien eller spara den i fil
\set [NAMN [VÄRDE]] sätt intern variabel, eller lista alla om ingen param
\setenv NAMN [VÄRDE] sätt eller nollställ omgivningsvariabel
\sf[+] FUNKNAMN visa en funktions definition
\sv[+] VYNAMN visa en vys definition
\t [on|off] visa endast rader (för närvarande: %s)
\timing [on|off] slå på/av tidstagning av kommandon (för närvarande: %s)
\unset NAME ta bort intern variabel
\w FILNAMN skriv frågebuffert till fil
\watch [SEK] kör fråga var SEK sekund
\x [on|off|auto] slå på/av utökad utskrift (för närvarande: %s)
\z [MALL] samma som \dp
border ramstil (nummer)
columns målvidd för wrappade format
expanded (eller x) expanderad utdata [on, off, auto]
fieldsep fältseparator för ej justeras utdata (standard "%s")
fieldsep_zero sätt fältseparator för ej justerad utdata till noll-byte
footer slå på/av visning av tabellfot [on, off]
format sätt utdataformat [unaligned, aligned, wrapped, html, asciidoc, ...]
linestyle sätt ramlinjestil [ascii, old-ascii, unicode]
null sätt sträng som visas istället för null-värden
numericlocale slå på/av visning av lokalspecifika tecken för gruppering
av siffror [on, off]
pager styr när en extern pagenerare används [yes, no, always]
psql --pset=NAMN[=VÄRDE]
eller \pset NAMN [VÄRDE] inne i psql
psql --set=NAMN=VÄRDE
eller \set NAMN VÄRDE inne i psql
psql [FLAGGA]... [DBNAMN [ANVÄNDARNAMN]]
recordsep post (rad) separator för ej justerad utdata
recordsep_zero sätt postseparator för ej justerad utdata till noll-byte
set NAMN=VÄRDE
psql ...
eller \setenv NAMN [VÄRDE] inne i psql
tableattr (el. T) ange attribut för tabelltaggen i html-format eller proportionella
kolumnvidder för vänsterjusterade datatypet i latex-longtable-format
title sätt tabelltitel för efterkommande tabellutskrifter
tuples_only om satt, bara tabelldatan visas
unicode_border_linestyle
unicode_column_linestyle
unicode_header_linestyle
sätter stilen på Unicode-linjer [single, double]
"%s.%s" är inte en vy
%d uppkoppling %d uppkopplingar %s %s %s (varje %gs)
%s
%s (%s, server %s)
%s (varje %gs)
%s: %s
%s: -1 kan bara användas i icke-interaktivt läge
%s: kan inte kopiera från/till en katalog
%s: kunde inte ta bort variabeln "%s"
%s: kunde inte hitta det egna programmets körbara fil
%s: kunde inte öppna logg-fil "%s": %s
%s: kunde inte sätta utskriftsparameter "%s"
%s: kunde inte sätta variabeln "%s"
%s: aktuell transaktion är avbruten
%s: ogiltigt kodningsnamn eller konverteringsprocedur hittades inte
%s: ej uppkopplad mot en databas
%s: slut på minne
%s: okänd transaktionsstatus
%s: varning: extra kommandoradsargument "%s" ignorerad
(%lu rad) (%lu rader) ***(Stegningsläge: Verifiera kommando)*******************************************
%s
***(tryck return för att fortsätta eller skriv x och return för att avbryta)*****
********* FRÅGA **********
%s
**************************
+ opt(%d) = |%s|
, klustrad , uppskjutbar , initialt uppskjuten , ogiltig , predikat (%s) , replikaidentitet , tabellutrymme: "%s" Åtkomsträttigheter Alla anslutningsparametrar måste anges då ingen databasuppkoppling är gjord
Argumentdatatyp Asynkron notificering "%s" mottagen från serverprocess med PID %d.
Asynkron notificering "%s" mottagen med innehåll "%s" från serverprocess med PID %d.
Attribut Tillgänglig hjälp:
Ramstil är %d.
Hopp över RLS COPY-överföring av data misslyckades: %s Anropshanterare Kan inte lägga till cell till tabellinnehåll: totala cellantalet (%d) överskridet.
Kan inte lägga till rubrik till tabellinnehåll: antal kolumner (%d) överskridet.
Kan inte logga in Check Kontrollvillkor: Barntabeller Jämförelse Kolumn Kolumnrättigheter Kommando: %s
Beskrivning: %s
Syntax:
%s
Sammansatt typ "%s.%s" Anslutning
Skapa DB Skapa roll Ctype Databas Standard accessrättigheter Standard sidfot är av.
Standard sidfot är på.
Standard? Definition Beskrivning Mål Ordlistor Kunde inte hitta en utökning med namn "%s".
Kunde inte hitta några utökningar.
Kunde inte hitta en relation med namn "%s".
Kunde inte hitta en relation med OID %s.
Kunde inte hitta en textsökkonfiguration med namn "%s".
Kunde inte hitta en textsökparser med namn "%s".
Avstängda interna utlösare: Avstängda regler: Avstängda utlösare: Avstängda användarutlösare: Element Påslagen Kodning Avsluta parsning Mata in data som skall kopieras följt av en nyrad.
Avsluta med bakstreck och en punkt ensamma på en rad eller av en EOF. Mata in det igen: Mata in nytt lösenord: Händelse Utökad visning är av.
Utökad visning är på.
Utökad visning används automatiskt.
FDW-Flaggor FDW-Flaggor: (%s) Misslyckades.
Fältseparatorn är "%s".
Fältseparatorn är noll-byte.
Främmande tabell "%s.%s" Främmande data-omvandlare Främmande nyckel-villkor: Formatering
Funktion Allmänna
Allmänna flaggor:
Hämta rubrik Hämta nästa symbol Hämta symboltyper Hanterare Har OID:er: ja Hjälp
ID Implicit? Index Index "%s.%s" Index: Informationer
Ärver Init Initieringsalternativ Inline-hanterare In-/Utmatning
Internt språk Internt namn Avbruten
Ogiltigt kommando \%s. Försök med \? för hjälp.
Språk Stora objekt
Stora objekt Vänster argumenttyp Symboluppdelning Linjestil är %s.
Lista med accessmetoder Lista med aggregatfunktioner Lista med typomvandlingar Lista med jämförelser (collations) Lista med konverteringar Lista med datatyper Lista med databaser Lista med domäner Lista med händelseutlösare Lista med främmande servrar Lista med främmande tabeller Lista med främmande data-omvandlare Lista med funktioner Lista med installerade utökningar Lista med språk Lista med operatorer Lista med relationer Lista med roller Lista med scheman Lista med inställningar Lista av variabler som hanteras speciellt
Lista med tabellutrymmen Lista med textsökkonfigurationer Lista med textsökordlistor Lista med textsökparsrar Lista med textsökmallar Lista av användarmappningar Lokal-anpassad numerisk utdata är av.
Lokal-anpassad numerisk utdata är på.
Plats Materialiserad vy "%s.%s" Medlem av Metod Modifierare Modifierare Namn Inga ändringar Inga uppkopplingar Ingen hjälp tillgänglig för "%s".
Försök med \h utan argument för att se den tillgängliga hjälpen.
Inget arv Inga matchande relationer funna.
Inga matchande inställningar funna.
Inga rollinställningar per databas stöds i denna serverversion.
Inga relationer funna.
Inga inställningar funna.
Null-visare är "%s".
Antal barntabeller: %d (Använd \d+ för att lista dem.) Objekt Objektbeskrivning Objektbeskrivningar Objekt i utökning "%s" Operativsystem
Alternativ Utdataformatet är "%s".
Ägd av: %s Ägare Siduppdelare används alltid.
Siduppdelare är på för lång utdata.
Siduppdelare är av.
Siduppdelare kommer inte användas för färre än %d linje.
Siduppdelare kommer inte användas för färre än %d linjer.
Parallell Lösenordskryptering misslyckades.
Lösenord för användare %s: Lösenord giltigt till Lösenord: Lösenorden stämde inte överens.
Policys Policys (tvingad radsäkerhet påslagen): Policys (tvingad radsäkerhet påslagen): (ingen) Policys (radsäkerhet avstängd): Policys (radsäkerhet påslagna): (ingen) Policys: Föregående förbindelse bevarad
Procedur Frågebuffert
Frågebufferten är tom. Frågebufferten har blivit borttagen. Postseparatorn är "%s".
Postseparatorn är <nyrad>.
Postseparatorn är noll-byte.
Refererad av: Replikaidentitet Replikering Rapportera fel till <pgsql-bugs@postgresql.org>.
Resultatdatatyp Resultattyp Höger argumenttyp Roll Rollnamn Regler som alltid utförs: Regler som utförs enbart på replika: Regler: SSL-anslutning (protokoll: %s, krypto: %s, bitar: %s, komprimering: %s)
SATS: %s
Schema Säkerhet Sekvens "%s.%s" Server Server: %s Inställningar Storlek Källa Källkod Källtyp Särskild relation "%s.%s" Starta parsning Statistikmål Lagring Lyckades.
Superanvändare TOAST-tabell "%s.%s" Tabell Tabell "%s.%s" Tabellattributen är "%s".
Tabellattributen är ej satta.
Tabellutrymme Tabellutrymme: "%s" Etiketter Måltyp Målvidd är %d.
Målvidd är inte satt.
Mall Textsökkonfiguration "%s" Textsökkonfiguration "%s.%s" Textsökparser "%s" Textsökparser "%s.%s" Anslutningen till servern har brutits. Försöker starta om: Indatan är en PostgreSQL-specifik dump.
Använd kommandoradsprogrammet pg_restore för att läsa in denna dump till databasen.
Servern (version %s) stöder inte accessmetoder.
Servern (version %s) stöder inte ändring av standardrättigheter.
Servern (version %s) stöder inte jämförelser (collations).
Servern (version %s) stöder inte redigering av funktionskällkod.
Servern (version %s) stöder inte redigering av vydefinitioner.
Servern (version %s) stöder inte utökningar.
Servern (version %s) stöder inte främmande servrar.
Servern (version %s) stöder inte främmande tabeller.
Servern (version %s) stöder inte främmande data-omvandlare.
Servern (version %s) stöder inte fulltextsökning.
Servern (version %s) stöder inte sparpunkter för ON_ERROR_ROLLBACK.
Servern (version %s) stöder inte visning av funktionskällkod.
Servern (version %s) stöder inte visning av vydefinitioner.
Servern (version %s) stöder inte tabellutrymmen.
Servern (version %s) stöder inte användarmappningar.
Det finns inget tidigare fel. Tid: %.3f ms
Tidtagning är av. Tidtagning är på. Titeln är "%s".
Titeln är inte satt.
Symbol Symbolnamn Symboltyper för parser "%s" Symboltyper för parser "%s.%s" Utlösare som alltid aktiveras: Utlösare som aktiveras enbart på replika: Utlösare: Tillförlitlig Försök med "%s --help" för mer information.
Visa bara tupler är av.
Visa bara tupler är på.
Typ Skriv "help" för hjälp.
Skriv: \copyright för upphovsrättsinformation
\h för hjälp om SQL-kommandon
\? för hjälp om psql-kommandon
\g eller avsluta med semikolon för att köra en fråga
\q för att avsluta
Typad tabell av typ: %s Unicode-ramstil är "%s".
Unicode-kolumnLinjestil är "%s".
Unicode-rubriklinjestil är "%s".
Ologgat index "%s.%s" Ologgad materialiserad vy "%s.%s" Ologgad tabell "%s.%s" Användning:
Använd "\q" för att lämna %s.
Användarnamn Validerare Värde Variabler
Version Vy "%s.%s" Vydefinition: Instabilitet VARNING: %s huvudversion %s, server huvudversion %s.
En del psql-finesser kommer kanske inte fungera.
VARNING: Konsollens "code page" (%u) skiljer sig fån Windows "code page" (%u)
8-bitars tecken kommer troligen inte fungera korrekt. Se psql:s
referensmanual i sektionen "Notes for Windows users" för mer detaljer.
Skrev historiken till fil "%s".
Du är uppkopplad upp mot databas "%s" som användare "%s" på värd "%s" på port "%s".
Du är uppkopplad mot databas "%s" som användare "%s" via uttag i "%s" på port "%s".
Du är för närvarande inte uppkopplad mot en databas.
Du är nu uppkopplad mot databasen "%s" som användare "%s" på värd "%s" på port "%s".
Du är nu uppkopplad mot databasen "%s" som användare "%s" via uttag i "%s" på port "%s".
Du är nu uppkopplad mot databasen "%s" som användare "%s".
Du använder psql, den interaktiva PostgreSQL-terminalen. \!: misslyckades
\%s: kunde inte byta katalog till "%s": %s
\%s: omgivningsvariabelnamn får ej innehålla "="
\%s: fel vid sättande av variabel
\%s: extra argument "%s" ignorerat
\%s: obligatoriskt argument saknas
\connect: %s \copy: argument krävs
\copy: parsfel vid "%s"
\copy: parsfel vid radslutet
\crosstabview: tvetydigt kolumnnamn: "%s"
\crosstabview: hittar ej kolumnnamn: "%s"
\crosstabview: kolumnnummer %d är utanför giltigt intervall 1..%d
\crosstabview: datakolumn måste anges när frågan returnerar mer än tre kolumner
\crosstabview: maximalt antal kolumner (%d) överskridet
\crosstabview: frågan måste returnera minst tre kolumner
\crosstabview: frågeresultatet innehåller multipla värden för rad "%s", kolumn "%s"
\crosstabview: satsen returnerade ingen resultatmängd
\crosstabview: vertikala och horisontala rubriker måste vara olika kolumner
\df tar inte en "w"-flagga med serverversion %s
\df tar bara [antwS+] som flaggor
\pset: tillåtna Unicode-ramstilar är single, double
\pset: tillåtna Unicode-kolumnlinjestilar ärsingle, double
\pset: tillåtna Unicode-rubriklinjestilar är single, double
\pset: tillåtna format är unaligned, aligned, wrapped, html, asciidoc, latex, latex-longtable, troff-ms
\pset: tillåtna linjestilar är ascii, old-ascii, unicode
\pset: okänd parameter: %s
\watch kan inte användas med COPY
\watch kan inte användas på en tom fråga
förkortad_grant_eller_revoke avbryt aktuell transaktion avbruten på grund av läsfel accessmetodtyp aktion agg aggregatnamn aggregatsignatur alias justering tillåtansl alltid analysfunktion och aggregatsignatur är: och konfliktaktion är en av: och grupperingselement kan vara en av: och likealternativ är: och tabellvillkor är: och tabellvillkor_för_index är: och with_fråga är: arg_datatyp arg_namn arg_typ arg_läge arg_namn arg_typ argument argumenttyp argument hoppar över försök att anropa \gset in i speciellt hanterad varibel "%s"
attribut attributnamn attributalternativ bastyp boolean cache anropshanterare avbryt en transaktion som tidigare förberetts för två-fas-commit avbruten av användaren kan inte duplicera null-pekare (internt fel)
kan inte escape:a utan en aktiv uppkoppling
kanonisk_funktion kategori ändra en databas ändra databasroll ändra en körningsparameter ändra en servers konfigurationsparameter ändra rollnamn eller medlemskap ändra definitionen av en jämförelse ändra definitionen av en konvertering ändra definitionen av en domän ändra definitionen av en främmande server ändra definitionen av en främmande tabell ändra definitionen av en främmande data-omvandlare ändra definitionen av en funktion ändra definitionen av ett stort objekt ändra definitionen av en materialiserad vy ändra definitionen av ett procedur-språk ändra definitionen av en säkerhetspolicy på radnivå ändra definitionen av en regel ändra definitionen av ett schema ändra definitionen av en sekvensgenerator ändra definitionen av en tabell ändra definitionen av ett tabellutrymme ändra definitionen av en textsökkonfiguration ändra definitionen av en textsökordlista ändra definitionen av en textsökparser ändra definitionen av en textsökmall ändra definitionen av en utlösare ändra definitionen av en typ ändra definitionen av en användarmappning ändra definitionen av en vy ändra definitionen av en aggregatfunktion ändra definitionen av en händelseutlösare ändra definitionen av en utökning ändra definitionen av ett index ändra definitionen av en operator ändra definitionen av en operatorklass ändra definitionen av en operatorfamilj byt ägare på databasobjekt som ägs av en databasroll kanal check-uttryck barnprocess avslutade med kod %d barnprocess avslutade med okänd statuskod %d barnprocess terminerades med avbrott 0x%X barnprocess terminerades av signal %d: %s stäng en markör klustra en tabell efter ett index kod sorterbar sortering %s jämförelse samla in statistik om en databas kolumnalias kolumnvillkor kolumndefinition kolumnnamn kolumntyp com_op kombinerafunk kommando kommandot är inte körbart kommandot kan ej hittas utför commit på en transaktion som tidigare förberetts för två-fas-commit utför den aktuella transaktionen beräkna en mängd rader villkor konfigurationsparameter konfliktaktion konfliktmål förbindelsen till servern har brutits
anslutningstak villkor villkorsnamn kopiera data mellan en fil och en tabell kunde inte byta katalog till "%s": %s kunde inte stänga rör till externt komamndo: %s
kunde inte utföra kommandot "%s": %s
kunde inte hitta en "%s" att köra kunde inte hämta hemkatalog för användar-ID %ld: %s
kunde inte identifiera aktuell katalog: %s kunde inte hitta temp-katalog: %s
kunde inte slå upp effektivt användar-id %ld: %s kunde inte öppna temporär fil "%s": %s
kunde inte parsa arrayen reloptions
kunde inte läsa binär "%s" kunde inte läsa från infilen: %s
kunde inte läsa symbolisk länk "%s" kunde inte skriva kommandohistorien till "%s": %s
kunde inte sätta variabeln "%s"
kunde inte starta /bin/sh
kunde inte starta editorn "%s"
kunde inte göra stat() på fil "%s": %s
kunde inte skriva COPY-data: %s
antal skapa en ny databas skapa nya rader i en tabell markörnamn datatyp databasnamn deallokera en förberedd sats standard default %s default_uttryck definiera en markör definiera en ny accessmetod definiera en ny aggregatfunktion definiera en ny typomvandling definiera en ny jämförelse definiera en ny datatyp definiera en ny databasroll definiera en ny domän definiera en ny teckenkodningskonvertering definiera en ny händelseutlösare definiera en ny främmande server definiera en ny främmande tabell definiera en ny främmande data-omvandlare definiera en ny funktion skapa ett nytt index definiera en ny mappning av en användare till en främmande server definiera en ny materialiserad vy definiera en ny operator definiera en ny operatorklass definiera en ny operatorfamilj definiera ett nytt procedur-språk definiera en ny omskrivningsregel definiera en ny säkerhetspolicy på radnivå för en tabell definera en ny sparpunkt i den aktuella transaktionen definiera ett nytt schema definiera en ny sekvensgenerator definiera en ny tabell definiera en ny tabell utifrån resultatet av en fråga definiera ett nytt tabellutrymme definiera en ny textsökkonfiguration definiera en ny textsökordlista definiera en ny textsökparser definiera en ny textsökmall definiera en ny transform definiera en ny utlösare definiera en ny vy definera åtkomsträttigheter definiera standardaccessrättigheter definiera eller ändra en säkerhetsetikett på ett objekt definiera eller ändra en kommentar på ett objekt definierare definition delete radera rader i en tabell avskiljare avdelartecken deserialiseringsfunk målkodning ta bort en tidigare definierad sparpunkt ordlistnamn riktning katalog avstängd släng sessionstillstånd domänvillkor domain_villkor domännamn element töm en eller flera tabeller påslagen kodning kodningsnamn slutfunktion omgivningsvariabeln PSQL_EDITOR_LINENUMBER_ARG måste ange ett radnummer
escape-tecken händelse uteslutelement uteslutelement i ett EXCLUDE-villkort är: utför en förberedd sats kör ett annonymt kodblock körkostnad existerande_jämförelse existerande_enumvärde uttryck utökningsnamn familjenamn fdw-namn ffunc filnamn filtervärde filtervariabel för tabell "%s.%s" tvinga transaktionsloggen att göra en checkpoint främmande tabell formatnamn frånval från_sql_funktionsnamn funktion funktionsnamn krävs
funktionsnamn skräpsamla och eventuellt analysera en databas generera en notifiering gettoken_funktion gruppnamn gruperingselement hanterarfunktion rubrikfunktion historia stöds inte av denna installationen
oföränderlig importera tabelldefinitioner från en främmande server i tilldelning ökningsvärde index indexkolumnnamn indexuttryck indexmetod indexnamn indexparametrar indexparametrar i UNIQUE-, PRIMARY KEY- och EXCLUDE-villkor är: indexpredikat init_funktion startvärde inline-hanterare inmatningsfunktion insert installera en utökning heltal internlängd ogiltig binär "%s" ogiltigt kommando \%s
ogiltigt radnummer: %s
ogiltigt utdataformat (internt fel): %d anropare ärmall join-kolumn join-villkor join_proc join-typ etikett språknamn stort_objekt_oid lc_collate lc_ctype vänster_typ symboluppdelningsfunktion symboltypfunktion like_alternativ liketyp linksymbol lyssna efter notifiering ladda en delad biblioteksfil (shared library) lokalt uttag (socket) lokalt_schema lokal lås en tabell låsläge loid materialiserad vy maxvärde medlemsobjekt metod mffunk mstartvärde minvärde minvfunk mer än en rad returnerades för \gset
msfunk ntillståndsstorlek mtillståndsdatatyp namn neg_op nytt_attributnamn nytt_kolumnnamn nyy_villkorsnamn ny_ordlista nytt_enumvärde nytt_namn ny_ägare ny_roll nytt_schema ny_tabell nytt_tabellutrymme ny_version nej ingen frågebuffert
inga rader returnerades för \gset
normal inte null null-sträng obj-fil objektnamn av gammal_ordlista gammal_roll gammal_version på op_typ op-klass operator operatorklass operatorfamilj operatornamn flaggor eller gamla syntaxen slut på minne slut på minne
utdatauttryck utmatningsfunktion utdatanamn parameter föräldertabell parsernamn lösenord innehåll pclose misslyckades: %s policynamn flytta en markör predikat föredragen förbered en sats för körning avbryt aktuell transaktion för två-fas-commit primärnyckel, leverantör psql är den interaktiva PostgreSQL-terminalen.
psql-variabler:
fråga citattecken återskapa index mottagarfunktion refkolumn refererat_tabellnamn reftabell relationsnamn externt_schema ta bort en typomvandling ta bort en jämförelse ta bort en konvertering ta bort en datatyp ta bort en databas ta bort en databasroll ta bort en domän ta bort en främmande server-deskriptor ta bort en främmande tabell ta bort en frammande data-omvandlare ta bort en funktion ta bort en materialiserad vy ta bort ett procedur-språk ta bort en omskrivningsregel ta bort en säkerhetspolicy på radnivå från en tabell ta bort ett schema ta bort en sekvens ta bort en tabell ta bort ett tabellutrymme ta bort en textsökkonfiguration ta bort en textsökordlista ta bort en textsökparser ta bort en textsökmall ta bort en transform ta bort en utlösare ta bort en användarmappning för en främmande server ta bort en vy ta bort åtkomsträttigheter ta bort en accessmetod ta bort en aggregatfunktioner ta bort en händelseutlösare ta bort en utökning ta bort ett index ta bort en operator ta bort en operatorklass ta bort en operatorfamilj ta bort databasobjekt som ägs av databasroll ersätt innehållet av en materialiserad vy replika res_proc starta om återställ värde av körningsparameter till standardvärdet begränsad resultatrader hämta rader från en fråga med hjälp av en markör hämta rader från en tabell eller vy rettyp omskrivningsregelnamn höger_typ rollnamn rollspecifikation rulla tillbaka till sparpunkt rule regelnamn säker samplingsmetod sparpunktnamn schema-element schemanamn frö select sändfunktion sekvens sekvensnamn serialiseringsfunk servernamn servertyp serverversion sätt integritetsvillkorstiming för nuvarande transaktion sätt inställningar för nuvarande transaktionen sätt användare för den aktiva sessionen sätt sessionsanvändaridentifierare och nuvarande användaridentifierare för den aktiva sessionen sfunc visa körningsplanen för en sats visa värde på en körningsparameter hoppar över rekursiv expandering av variabeln "%s"
snapshot_id sorteringsuttryck sorteringsfamiljnamn sorteringsoperator källkonfig källkodning källtabell källtyp särskild stabil start starta ett transaktionsblock startfunktion tillståndsdatastorlek tillståndsdatatyp sats sluta att lyssna efter notifiering lagring lagringsparameter lagringstyp strateginummer sub-SELECT subtyp subtyp_diff_funktion subtypoperatorklass supportnummer tab-kompletteringsfråga misslyckades: %s
Frågan var:
%s
tabell tabellvillkor tabellvillkor tabellvillkor_för_index tabellnamn tabellutrymmesnamn tabellutrymmesalternativ målroll måltyp mall text tidsstämpel tidszon till_sql_funktionsnamn symboltyp transaktions-id transaktionsläge utlösare utlösarnamn försöker avsluta kopieringsläge typ typmodifiering_indatafunktion typmodifiering_utdatafunktion typnamn uid oväntad PQresultStatus: %d
oväntat resultatstatus för \watch
oväntad transaktionsstatus (%d)
unik, okänd okänt värde "%s" för "%s"; antar "%s"
osäker icketerminerad citerat sträng
update uppdatera rader i en tabell användaren finns inte misslyckad sökning efter användarnamn: felkod %lu användarnamn using-uttryck val-funktion valideringsfunktion värde värden version vy vynamn krävs
visningsalternativnamn visningsalternativvärde instabil där förkortad_grant_eller_revok är en av: där aktion är en av: där aggregatsignatur är: där kolumnvillkor är: där konfliktmål kan vara en av: där villkor är: där riktning kan vara tom eller en av: där händelse kan vara en av: där frånval kan vara en av: där låsläge är en av: där medlemsobjekt är: där flaggor kan vara en av: där flaggor kan vara: där rollspecifikation kan vara: där transaktionsläge är en av: fönster fönsterdefinition fönsternamn with_fråga with_frågenamn ja locale/sv/LC_MESSAGES/pg_config-9.6.mo 0000644 00000013434 14751153420 0013031 0 ustar 00 �� * l ; � � E � 0 � : 3 E n I � L � s K K � = B I i � G � J > M � M � ? % G e > � 6 � < # > ` F � P � I 7
4 �
2 �
* �
. , 8 & e � & � � ( � ! B V c � u B + \ � < � C � G J d u � I % A o F � l � K e H � K � K F F � E � > 9 ^ D � < � G G b G � 5 � 9 ( 7 b � � 1 � / �
! % / " U * x � % � � � % * ) $
" '
& ( ! #
%s provides information about the installed version of PostgreSQL.
With no arguments, all known items are shown.
%s [OPTION]...
--bindir show location of user executables
--cc show CC value used when PostgreSQL was built
--cflags show CFLAGS value used when PostgreSQL was built
--cflags_sl show CFLAGS_SL value used when PostgreSQL was built
--configure show options given to "configure" script when
PostgreSQL was built
--cppflags show CPPFLAGS value used when PostgreSQL was built
--docdir show location of documentation files
--htmldir show location of HTML documentation files
--includedir show location of C header files of the client
interfaces
--includedir-server show location of C header files for the server
--ldflags show LDFLAGS value used when PostgreSQL was built
--ldflags_ex show LDFLAGS_EX value used when PostgreSQL was built
--ldflags_sl show LDFLAGS_SL value used when PostgreSQL was built
--libdir show location of object code libraries
--libs show LIBS value used when PostgreSQL was built
--localedir show location of locale support files
--mandir show location of manual pages
--pgxs show location of extension makefile
--pkgincludedir show location of other C header files
--pkglibdir show location of dynamically loadable modules
--sharedir show location of architecture-independent support files
--sysconfdir show location of system-wide configuration files
--version show the PostgreSQL version
-?, --help show this help, then exit
%s: could not find own program executable
%s: invalid argument: %s
Options:
Report bugs to <pgsql-bugs@postgresql.org>.
Try "%s --help" for more information.
Usage:
could not change directory to "%s": %s could not find a "%s" to execute could not identify current directory: %s could not read binary "%s" could not read symbolic link "%s" invalid binary "%s" not recorded pclose failed: %s Project-Id-Version: PostgreSQL 9.6
Report-Msgid-Bugs-To: pgsql-bugs@postgresql.org
POT-Creation-Date: 2021-11-07 09:51+0000
PO-Revision-Date: 2021-11-07 06:44+0100
Last-Translator: Dennis Björklund <db@zigo.dhs.org>
Language-Team: Swedish <pgsql-translators@postgresql.org>
Language: sv
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Plural-Forms: nplurals=2; plural=n != 1;
%s ger information on den installerade versionen av PostgreSQL.
Utan argument visas alla kända värden.
%s [FLAGGA]...
--bindir visa filkatalog för körbara filer
--cc visa värde på CC när PostgreSQL byggdes
--cflags visa värde på CFLAGS när PostgreSQL byggdes
--cflags_sl visa värde på CFLAGS_SL när PostgreSQL byggdes
--configure dessa flaggor gavs till "configure"-skriptet när
PostgreSQL byggdes
--cppflags visa värde på CPPFLAGS när PostgreSQL byggdes
--docdir visa filkatalog för dokumentationsfiler
--htmldir visa filkatalog för HTML-dokumentationsfiler
--includedir visa filkatalog för C-header-filerna med
klientgränssnitt
--includedir-server visa filkatalog för C-header-filerna till servern
--ldflags visa värde på LDFLAGS när PostgreSQL byggdes
--ldflags_ex visa värde på LDFLAGS_EX när PostgreSQL byggdes
--ldflags_sl visa värde på LDFLAGS_SL när PostgreSQL byggdes
--libdir visa filkatalog för bibliotekens objektfiler
--libs visa värde på LIBS när PostgreSQL byggdes
--localedir visa filkatalog för lokalstödsfiler
--mandir visa filkatalog för manualsidor
--pgxs visa plats för make-filen vid utvidgningar
--pkgincludedir visa filkatalog för C-header-filer
--pkglibdir visa filkatalog för dynamiskt laddade moduler
--sharedir visa filkatalog för arkitekturoberoende filer
--sysconfdir visa filkatalog för systemkonfigurationsfiler
--version visa version för PostgreSQL
-?, --help visa denna hjälp, avsluta sedan
%s: kunde inte hitta det egna programmets körbara fil
%s: ogiltigt argument: %s
Flaggor:
Rapportera fel till <pgsql-bugs@postgresql.org>.
Försök med "%s --help" för mer information.
Användning:
kunde inte byta katalog till "%s": %s kunde inte hitta en "%s" att köra kunde inte identifiera aktuell katalog: %s kunde inte läsa binär "%s" kunde inte läsa symbolisk länk "%s" ogiltig binär "%s" ej sparad pclose misslyckades: %s locale/sv/LC_MESSAGES/pg_rewind-9.6.mo 0000644 00000044620 14751153420 0013055 0 ustar 00 �� � $ � ,
�
- �
1 �
? K I C � ; � C 9 Y G � @ � O ( x � � � � � � J > L , � 6 � < � 1 , ? ^ = � = � 9 D T 4 � 9 � 4 2 = @ p R � > C J 1 k � � � � o � d ] - � 4 � & % L � f P � R : c � - � > / \ ; � � � � # B % a $ � + � � $ � L , h 0 � " � ) � , @ $ ^ $ � # � ' � " � " 5 & X $ � ( � � " ' 1 Y v � � 2 � � ' D / c - � � 6 � ; + ) g � + � % � ! ! ! 4! 3 V! 6 �! 1 �! �! ' " < :" _ w" �" �" ! �" F # c# z# �# 1 �# C �# " $$ . G$ # v$ > �$ 6 �$ 3 % 6 D% 0 {% �% + �% & �% & ;& ! Z& ( |& I �& $ �& ' ' <' - Y' J �' = �' A ( 6 R( 5 �( 5 �( ! �( 7 ) / O) 6 ) 1 �) - �) 9 * � P* 2 �+ 1 ', D Y, G �, B �, E )- G o- > �- O �- @ F. �. S �. �. / ! / @/ Z/ m/ p/ K y/ < �/ ( 0 @ +0 ? l0 . �0 F �0 = "1 @ `1 4 �1 > �1 8 2 : N2 ; �2 7 �2 @ �2 S >3 @ �3 �3 ) �3 6 4 ;4 S4 ]4 z4 k �4 i 5 3 l5 > �5 / �5 6 � /6 K �6 L 7 a N7 5 �7 �7 8 - "8 < P8 �8 �8 & �8 $ �8 9 $ 19 " V9 2 y9 �9 % �9 M �9 0 ?: 5 p: # �: - �: / �: (; $ F; # k; $ �; ( �; " �; < $ < * D< # o< �< + �< �< = $ "= G= # g= �= �= 4 �= ) �= ) &> P> . p> 1 �> �> 6 �> &? 9 8? ( r? �? - �? & �? @ #@ ?@ 3 _@ 9 �@ 6 �@ A ' !A ? IA c �A �A B " B H 5B ~B �B �B 0 �B A �B & 1C , XC ! �C F �C > �C / -D . ]D - �D �D 3 �D . E ! 5E WE oE ( �E P �E + F ( 2F [F 0 uF M �F A �F @ 6G 4 wG 7 �G 7 �G % H > BH 2 �H 9 �H 1 �H / I ? PI � ' 6 � Y | � � � [ ? r " p � J } � � & = d � 2 { y ; � u / i F
f R 7 � b � 9 k I ) ! l _ q � � � B : � t $ � � 1 % 4 � � � ` U P h � x � ~ * � ]
C w L E @ g 3 a Q c s � 0 m A � < � S X v T , e M z ^ K � H N G 5 O j > � � Z ( o - W . � � D V \ # + � 8 n �
Report bugs to <pgsql-bugs@postgresql.org>.
creating backup label and updating control file
--debug write a lot of debug messages
--source-pgdata=DIRECTORY source data directory to synchronize with
--source-server=CONNSTR source server to synchronize with
-?, --help show this help, then exit
-D, --target-pgdata=DIRECTORY existing data directory to modify
-P, --progress write progress messages
-V, --version output version information, then exit
-n, --dry-run stop before modifying anything
block %u
"%s" is a symbolic link, but symbolic links are not supported on this platform
"%s" is not a directory
"%s" is not a regular file
"%s" is not a symbolic link
%*s/%s kB (%d%%) copied %d: %X/%X - %X/%X
%s %s (%s)
%s resynchronizes a PostgreSQL cluster with another copy of the cluster.
%s: WARNING: cannot create restricted tokens on this platform
%s: could not allocate SIDs: error code %lu
%s: could not create restricted token: error code %lu
%s: could not get exit code from subprocess: error code %lu
%s: could not open process token: error code %lu
%s: could not re-execute with restricted token: error code %lu
%s: could not start process for command "%s": error code %lu
%s: no source specified (--source-pgdata or --source-server)
%s: no target data directory specified (--target-pgdata)
%s: only one of --source-pgdata or --source-server can be specified
%s: too many command-line arguments (first is "%s")
BKPBLOCK_HAS_DATA not set, but data length is %u at %X/%X BKPBLOCK_HAS_DATA set, but no data included at %X/%X BKPBLOCK_SAME_REL set but no previous rel at %X/%X BKPIMAGE_HAS_HOLE not set, but hole offset %u length %u at %X/%X BKPIMAGE_HAS_HOLE set, but hole offset %u length %u block image length %u at %X/%X BKPIMAGE_IS_COMPRESSED set, but block image length %u at %X/%X Done!
Expected a numeric timeline ID.
Expected a transaction log switchpoint location.
Failure, exiting
Options:
Source timeline history:
Target timeline history:
The program "initdb" is needed by %s but was
not found in the same directory as "%s".
Check your installation.
The program "initdb" was found by "%s"
but was not the same version as %s.
Check your installation.
Timeline IDs must be in increasing sequence.
Timeline IDs must be less than child timeline's ID.
Try "%s --help" for more information.
Usage:
%s [OPTION]...
WAL file is from different database system: WAL file database system identifier is %s, pg_control database system identifier is %s WAL file is from different database system: incorrect XLOG_BLCKSZ in page header WAL file is from different database system: incorrect XLOG_SEG_SIZE in page header WAL record modifies a relation, but record type is not recognized
lsn: %X/%X, rmgr: %s, info: %02X
You must run %s as the PostgreSQL superuser.
backup label buffer too small
cannot be executed by "root"
cannot duplicate null pointer (internal error)
clusters are not compatible with this version of pg_rewind
connected to server
contrecord is requested by %X/%X could not clear search_path: %s could not close directory "%s": %s
could not close file "%s": %s
could not close target file "%s": %s
could not create directory "%s": %s
could not create symbolic link at "%s": %s
could not fetch file list: %s could not fetch remote file "%s": %s could not find common ancestor of the source and target cluster's timelines
could not find previous WAL record at %X/%X
could not find previous WAL record at %X/%X: %s
could not open directory "%s": %s
could not open file "%s" for reading: %s
could not open file "%s" for truncation: %s
could not open file "%s": %s
could not open source file "%s": %s
could not open target file "%s": %s
could not read WAL record at %X/%X
could not read WAL record at %X/%X: %s
could not read directory "%s": %s
could not read file "%s": %s
could not read from file "%s": %s
could not read symbolic link "%s": %s
could not remove directory "%s": %s
could not remove file "%s": %s
could not remove symbolic link "%s": %s
could not seek in file "%s": %s
could not seek in source file: %s
could not seek in target file "%s": %s
could not send COPY data: %s could not send end-of-COPY: %s could not send file list: %s could not send query: %s could not set libpq connection to single row mode
could not stat file "%s": %s
could not truncate file "%s" to %u: %s
could not write file "%s": %s
data file "%s" in source is not a regular file
error running query (%s) in source server: %s fetched file "%s", length %d
full_page_writes must be enabled in the source server
getting file chunks
incorrect resource manager data checksum in record at %X/%X invalid action (CREATE) for regular file
invalid block_id %u at %X/%X invalid compressed image at %X/%X, block %d invalid contrecord length %u at %X/%X invalid control file
invalid data in history file
invalid data in history file: %s
invalid info bits %04X in log segment %s, offset %u invalid magic number %04X in log segment %s, offset %u invalid record length at %X/%X: wanted %u, got %u invalid record offset at %X/%X invalid resource manager ID %u at %X/%X need to copy %lu MB (total source directory size is %lu MB)
neither BKPIMAGE_HAS_HOLE nor BKPIMAGE_IS_COMPRESSED set, but block image length is %u at %X/%X no rewind required
out of memory
out-of-order block_id %u at %X/%X out-of-sequence timeline ID %u (after %u) in log segment %s, offset %u reading WAL in target
reading source file list
reading target file list
received chunk for file "%s", offset %s, size %d
received null value for chunk for file "%s", file has been deleted
record length %u at %X/%X too long record with incorrect prev-link %X/%X at %X/%X record with invalid length at %X/%X rewinding from last common checkpoint at %X/%X on timeline %u
servers diverged at WAL position %X/%X on timeline %u
source and target cluster are on the same timeline
source and target clusters are from different systems
source data directory must be shut down cleanly
source file list is empty
source server must not be in recovery mode
symbolic link "%s" target is too long
sync of target directory failed
syncing target data directory
syntax error in history file: %s
target server must be shut down cleanly
target server needs to use either data checksums or "wal_log_hints = on"
there is no contrecord flag at %X/%X unexpected EOF while reading file "%s"
unexpected control file CRC
unexpected control file size %d, expected %d
unexpected data types in result set while fetching remote files: %u %u %u
unexpected null values in result while fetching remote files
unexpected page modification for directory or symbolic link "%s"
unexpected pageaddr %X/%X in log segment %s, offset %u unexpected result format while fetching remote files
unexpected result length while fetching remote files
unexpected result set from query
unexpected result set size while fetching remote files
unexpected result set while fetching file list
unexpected result set while fetching remote file "%s"
unexpected result while fetching remote files: %s unexpected result while sending file list: %s unrecognized result "%s" for current WAL insert location
Project-Id-Version: PostgreSQL 9.6
Report-Msgid-Bugs-To: pgsql-bugs@postgresql.org
POT-Creation-Date: 2021-11-07 09:52+0000
PO-Revision-Date: 2021-11-07 07:17+0100
Last-Translator: Dennis Björklund <db@zigo.dhs.org>
Language-Team: Swedish <pgsql-translators@postgresql.org>
Language: sv
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Plural-Forms: nplurals=2; plural=n != 1;
Rapportera fel till <pgsql-bugs@postgresql.org>.
skapar backupetikett och uppdaterar kontrollfil
--debug skriv ut en massa debugmeddelanden
--source-pgdata=KATALOG källdatakatalog att synkronisera med
--source-server=ANSLSTR källserver att synkronisera med
-?, --help visa denna hjälp och avsluta sedan
-D, --target-pgdata=KATALOG existerande datakatalog att modifiera
-P, --progress skriv ut förloppmeddelanden
-V, --version skriv ut versioninformation och avsluta sedan
-n, --dry-run stoppa innan något modifieras
block %u
"%s" är en symbolisk länk men symboliska länkar stöds inte på denna plattform
"%s" är inte en katalog
"%s" är inte en vanlig fil
"%s" är inte en symbolisk länk
%*s/%s kB (%d%%) kopierad %d: %X/%X - %X/%X
%s %s (%s)
%s resynkroniserar ett PostgreSQL-kluster med en annan kopia av klustret.
%s: VARNING: "restricted Token" stöds inte av plattformen.
%s: kunde inte tilldela SID: felkod %lu
%s: kunde inte skapa restriktivt styrmärke (token): felkod %lu
%s: kunde inte utvinna statuskod för underprocess: felkod %lu
%s: kunde inte skapa processtoken: felkod %lu
%s: kunde inte upprepa med restriktivt styrmärke (token): felkod %lu
%s: kunde inte starta process för kommando "%s": felkod %lu
%s: ingen källa angavs (--source-pgdata eller --source-server)
%s: ingen måldatakatalog angiven (--target-pgdata)
%s: bara en av --source-pgdata och --source-server får anges
%s: för många kommandoradsargument (första är "%s")
BKPBLOCK_HAS_DATA ej satt, men datalängd är %u vid %X/%X BKPBLOCK_HAS_DATA satt, men ingen data inkluderad vid %X/%X BKPBLOCK_SAME_REL satt men ingen tidigare rel vid %X/%X BKPIMAGE_HAS_HOLE ej satt, men håloffset %u längd %u vid %X/%X BKPIMAGE_HAS_HOLE satt, men håloffset %u längd %u block-image-längd %u vid %X/%X BKPIMAGE_IS_COMPRESSED satt, men block-image-längd %u vid %X/%X Klar!
Förväntade ett numeriskt tidslinje-ID.
Förväntade en transaktionsloggs bytespunktposition.
Misslyckades, avslutar
Flaggor:
Källans tidslinjehistorik:
Målets tidslinjehistorik:
Programmet "initdb" krävs av %s men
hittades inte i samma katalog som "%s".
Kontrollera din installation.
Programmet "initdb" hittades av "%s"
men var inte av samma version som %s.
Kontrollera din installation.
Tidslinje-ID:er måste komma i en ökande sekvens.
Tidslinje-ID:er måste vara mindre än barnets tidslinjes ID.
Försök med "%s --help" för mer information.
Användning:
%s [FLAGGA]...
WAL-fil är från ett annat databassystem: WAL-filens databassystemidentifierare är %s, pg_control databassystemidentifierare är %s WAL-fil är från ett annat databassystem: inkorrekt XLOG_BLCKSZ i sidhuvud WAL-fil är från ett annat databassystem: felaktig XLOG_SEG_SIZE i sidhuvud WAL-post modifierar en relation, men posttypen känns inte igen
lsn: %X/%X, rmgr: %s, info: %02X
Du måste köra %s som PostgreSQL:s superanvändare.
backupetikett-buffer för liten
kan inte köras av "root"
kan inte duplicera null-pekare (internt fel)
klustren är inte kompatibla med denna version av pg_rewind
ansluten till server
contrecord är begärd vid %X/%X kunde inte nollställa search_path: %s kunde inte stänga katalog "%s": %s
kunde inte stänga fil "%s": %s
kunde inte stänga målfil "%s": %s
kunde inte skapa katalog "%s": %s
kunde inte skapa en symnbolisk länk vid "%s": %s
kunde inte hämta fillista: %s kunde inte hämta extern fil "%s": %s kunde inte finna en gemensam anfader av källa och målklusterets tidslinjer
kunde inte hitta förgående WAL-post vid %X/%X
kunde inte hitta föregående WAL-post vid %X/%X: %s
kunde inte öppna katalog "%s": %s
kunde inte öppna fil "%s" för läsning: %s
kunde inte öppna fil "%s" för trunkering: %s
kan inte öppna fil "%s": %s
kunde inte öppna källfil "%s": %s
kunde inte öppna målfil "%s": %s
kunde inte läsa WAL-post vid %X/%X
kunde inte läsa WAL-post vid %X/%X: %s
kunde inte läsa katalog "%s": %s
kunde inte läsa fil "%s": %s
kunde inte läsa från fil "%s": %s
kunde inte läsa symbolisk länk "%s": %s
kunde inte radera katalog "%s": %s
kunde inte ta bort fil "%s": %s
kunde inte radera symbolisk länk "%s": %s
kunde inte söka i fil "%s": %s
kunde inte söka i källfil: %s
kunde inte söka i målfil "%s": %s
kunde inte skicka COPY-data: %s kunde inte skicka slut-på-COPY: %s kunde inte skicka fillista: %s kunde inte skicka fråga: %s kunde inte sätta libpq-anslutning till enradsläge
kunde inte göra stat() på fil "%s": %s
kunde inte trunkera fil "%s" till %u: %s
kunde inte skriva fil "%s": %s
datafil "%s" i källan är inte en vanlig fil
fel vid körande av fråga (%s) i källserver: %s hämtade fil "%s", längd %d
full_page_writes måste vara påslagen i källservern
hämtar fildelar
felaktig resurshanterardatakontrollsumma i post vid %X/%X ogiltig aktion (CREATE) för vanlig fil
ogiltig block_id %u vid %X/%X ogiltig komprimerad image vid %X/%X, block %d ogiltig contrecord-längd %u vid %X/%X ogiltig kontrollfil
ogiltig data i historikfil
ogiltig data i historikfil: %s
ogiltiga infobitar %04X i loggsegment %s, offset %u felaktigt magiskt nummer %04X i loggsegment %s, offset %u ogiltig postlängd vid %X/%X: förväntade %u, fick %u ogiltig postoffset vid %X/%X ogiltigt resurshanterar-ID %u vid %X/%X behöver kopiera %lu MB (total källkatalogstorlek är %lu MB)
varken BKPIMAGE_HAS_HOLE eller BKPIMAGE_IS_COMPRESSED satt, men block-image-längd är %u vid %X/%X ingen rewind krävs
slut på minne
ej-i-sekvens block_id %u vid %X/%X ej-i-sekvens för tidslinje-ID %u (efter %u) i loggsegment %s, offset %u läser WAL i målet
läser källfillista
läser målfillista
mottog del för fil "%s", offset %s, storlek %d
mottog null-värde som del av fil "%s", filen har blivit raderad
postlängd %u vid %X/%X är för lång post med inkorrekt prev-link %X/%X vid %X/%X post med ogiltig längd vid %X/%X rewind från senaste gemensamma checkpoint vid %X/%X på tidslinje %u
servrarna divergerade vid WAL-position %X/%X på tidslinje %u
källa och målkluster är på samma tidslinje
källa och målkluster är från olika system
måldatakatalog måste stängas ner utan fel
källfillistan är tom
källserver får inte vara i återställningsläge
mål för symbolisk länk "%s" är för lång
synk av målkatalog misslyckades
synkar måldatakatalog
syntaxfel i historikfil: %s
målserver måste stängas ner utan fel
målservern behöver använda antingen datachecksums eller "wal_log_hints = on"
det finns ingen contrecord-flagga vid %X/%X oväntad EOF under läsning av fil "%s"
oväntad kontrollfil-CRC
oväntad kontrollfilstorlek %d, förväntade %d
oväntade datayper i resultatmängd vid hämtning av externa filer: %u %u %u
oväntade null-värden i resultat vid hämtning av externa filer
oväntad sidmodifiering för katalog eller symbolisk länk "%s"
oväntad sidadress %X/%X i loggsegment %s, offset %u oväntat resultatformat vid hämtning av externa filer
oväntad resultatlängd vid hämtning av externa filer
oväntad resultatmängd från fråga
oväntad resultatmängdstorlek vid hämtning av externa filer
oväntad resultatmängd vid hämtning av fillista
oväntat resultatmängd vid hämtning av extern fil "%s"
oväntat resultat vid hämtning av extern fil: %s oväntat resultat vid skickande av fillista: %s oväntat resultat "%s" för nuvarande WAL-insättningsposition
locale/sv/LC_MESSAGES/pg_basebackup-9.6.mo 0000644 00000066076 14751153420 0013676 0 ustar 00 �� � �
` a { � � ! �
� - � X T l R � ` I u D � 3 K J < � j � > > N } @ � 3
Y A > � 1 � j < w ? � M � k B J � Y � + S 0 B � B � * 6 8 a � � 5 ) � _ r � o Z 1 � 3 � K 0 - | F � \ � P N 2 � 4 � 8 @ 1 G 4 y 1 � . � @ 1 P E � B � 7 ! C! ]! & }! ; �! ( �! # " - -" ' [" " �" �" 2 �" , �" + '# . S# ( �# # �# 5 �# f $ , l$ 9 �$ 4 �$ 7 % = @% d ~% A �% " %& & H& & o& # �& / �& > �& a )' & �' & �' % �' 2 �' 1 2( 0 d( 8 �( ( �( 2 �( *) & K) ' r) . �) + �) # �) A * 2 [* & �* & �* / �* + + 4 8+ / m+ ! �+ 1 �+ ) �+ ( , 2 D, 2 w, 3 �, 0 �, % - # 5- + Y- �- �- 2 �- # �- . , (. , U. # �. i �. i / ? z/ 9 �/ " �/ A 0 # Y0 }0 9 �0 �0 �0 !
1 D /1 & t1 # �1 A �1 - 2 D /2 ! t2 �2 �2 " �2 �2 9 3 1 C3 D u3 , �3 �3 ' �3 D "4 M g4 : �4 8 �4 6 )5 `5 E y5 G �5 z 6 c �6 % �6 . 7 2 ;7 6 n7 # �7 �7 % �7 0 8 R 98 , �8 4 �8 K �8 @ :9 > {9 - �9 , �9 ' : , =: o j: k �: 4 F; % {; ( �; ; �;
< & < 8< / @< p< / < � �< S> k> �> �> �>
�> 2 �> [
? V i? Q �? f @ K y@ 9 �@ �@ ? A J QA 6 �A a �A > 5B M tB L �B 3 C Z CC C �C 8 �C m D ? �D A �D N E n ZE L �E i F , �F 2 �F D �F H %G . nG 9 �G � �G 4 rH � �H w FI u �I 8 4J 7 mJ U �J / �J E +K [ qK O �K 2 L 8 PL 7 �L �L , �L 5 �L 7 +M # cM J �M 1 �M Q N N VN @ �N �N ! �N # O E AO , �O * �O 0 �O ( P $ 9P # ^P - �P * �P ( �P . Q ( 3Q " \Q ; Q k �Q . 'R > VR 3 �R 7 �R E S m GS @ �S 0 �S ( 'T * PT ' {T 2 �T G �T o U % �U ' �U ( �U 6 V 3 <V : pV 8 �V ( �V 3
W " AW & dW 1 �W 0 �W / �W * X C IX = �X * �X ( �X 3 Y 0 SY 8 �Y 4 �Y ' �Y ; Z * VZ ( �Z 4 �Z 4 �Z 4 [ 4 I[ ( ~[ ! �[ / �[ �[ \ < &\ # c\ % �\ 0 �\ 1 �\ " ] f 3] g �] D ^ ? G^ ( �^ I �^ $ �^ " _ @ B_ �_ �_ # �_ J �_ ) '` , Q` F ~` . �` F �` * ;a fa �a �a �a F �a < b J Wb / �b �b # �b I
c P Tc < �c 2 �c ; d Qd H pd P �d �
e w �e $ f 0 +f 5 \f 8 �f % �f �f & g / 2g Q bg * �g 8 �g D h J ]h @ �h > �h < (i < ei : �i p �i u Nj 2 �j �j # k C ;k k / �k
�k - �k �k 6 l � * � � o C $ e 7 ] � j @ � � � � f � - R � � � � O = � s � F } 2 M � p c { < N 8 � � � ) B + Y � � � � � z & T k h � I H K ~ � t w X v � � � : � > � � . / � 5 � U � � � � � _ � � 6 [ E
Z � S J , � � d # x � � Q y A P � � i � � u ^ � ? � � V
� 0 n � ( � � \ ; � � r � � � � 4 � g � " � 3 1 � D m l 9 a � � b G q � % W � � � � ! � � | ` L � � � ' �
Action to be performed:
Connection options:
General options:
Optional actions:
Options controlling the output:
Options:
Report bugs to <pgsql-bugs@postgresql.org>.
--create-slot create a new replication slot (for the slot's name see --slot)
--drop-slot drop the replication slot (for the slot's name see --slot)
--if-not-exists do not error if slot already exists when creating a slot
--start start streaming in a replication slot (for the slot's name see --slot)
--synchronous flush transaction log immediately after writing
--xlogdir=XLOGDIR location for the transaction log directory
%s [OPTION]...
-?, --help show this help, then exit
-D, --directory=DIR receive transaction log files into this directory
-D, --pgdata=DIRECTORY receive base backup into directory
-F --fsync-interval=SECS
time between fsyncs to the output file (default: %d)
-F, --format=p|t output format (plain (default), tar)
-I, --startpos=LSN where in an existing slot should the streaming start
-P, --plugin=PLUGIN use output plugin PLUGIN (default: %s)
-P, --progress show progress information
-R, --write-recovery-conf
write recovery.conf for replication
-S, --slot=SLOTNAME name of the logical replication slot
-S, --slot=SLOTNAME replication slot to use
-T, --tablespace-mapping=OLDDIR=NEWDIR
relocate tablespace in OLDDIR to NEWDIR
-U, --username=NAME connect as specified database user
-V, --version output version information, then exit
-W, --password force password prompt (should happen automatically)
-X, --xlog-method=fetch|stream
include required WAL files with specified method
-Z, --compress=0-9 compress tar output with given compression level
-c, --checkpoint=fast|spread
set fast or spread checkpointing
-d, --dbname=CONNSTR connection string
-d, --dbname=DBNAME database to connect to
-f, --file=FILE receive log into this file, - for stdout
-h, --host=HOSTNAME database server host or socket directory
-l, --label=LABEL set backup label
-n, --no-loop do not loop on connection lost
-o, --option=NAME[=VALUE]
pass option NAME with optional value VALUE to the
output plugin
-p, --port=PORT database server port number
-r, --max-rate=RATE maximum transfer rate to transfer data directory
(in kB/s, or use suffix "k" or "M")
-s, --status-interval=INTERVAL
time between status packets sent to server (in seconds)
-s, --status-interval=SECS
time between status packets sent to server (default: %d)
-v, --verbose output verbose messages
-w, --no-password never prompt for password
-x, --xlog include required WAL files in backup (fetch mode)
-z, --gzip compress tar output
%*s/%s kB (%d%%), %d/%d tablespace %*s/%s kB (%d%%), %d/%d tablespaces %*s/%s kB (%d%%), %d/%d tablespace (%s%-*.*s) %*s/%s kB (%d%%), %d/%d tablespaces (%s%-*.*s) %*s/%s kB (100%%), %d/%d tablespace %*s %*s/%s kB (100%%), %d/%d tablespaces %*s %s controls PostgreSQL logical decoding streams.
%s receives PostgreSQL streaming transaction logs.
%s takes a base backup of a running PostgreSQL server.
%s: %s %s: %s needs a slot to be specified using --slot
%s: COPY stream ended before last file was finished
%s: WAL streaming can only be used in plain mode
%s: at least one action needs to be specified
%s: can only write single tablespace to stdout, database has %d
%s: cannot specify both --xlog and --xlog-method
%s: cannot use --create-slot or --drop-slot together with --startpos
%s: cannot use --create-slot or --start together with --drop-slot
%s: cannot use --create-slot together with --drop-slot
%s: checkpoint completed
%s: child %d died, expected %d
%s: child thread exited with error %u
%s: confirming write up to %X/%X, flush to %X/%X (slot %s)
%s: could not access directory "%s": %s
%s: could not clear search_path: %s %s: could not close compressed file "%s": %s
%s: could not close directory "%s": %s
%s: could not close file "%s": %s
%s: could not connect to server
%s: could not create archive status file "%s": %s
%s: could not create background process: %s
%s: could not create background thread: %s
%s: could not create compressed file "%s": %s
%s: could not create directory "%s": %s
%s: could not create file "%s": %s
%s: could not create pipe for background process: %s
%s: could not create replication slot "%s": got %d rows and %d fields, expected %d rows and %d fields
%s: could not create symbolic link "%s": %s
%s: could not create symbolic link from "%s" to "%s": %s
%s: could not create timeline history file "%s": %s
%s: could not determine seek position in file "%s": %s
%s: could not determine server setting for integer_datetimes
%s: could not drop replication slot "%s": got %d rows and %d fields, expected %d rows and %d fields
%s: could not establish database-specific replication connection
%s: could not fsync file "%s": %s
%s: could not fsync log file "%s": %s
%s: could not get COPY data stream: %s %s: could not get backup header: %s %s: could not get child thread exit status: %s
%s: could not get transaction log end position from server: %s %s: could not identify system: got %d rows and %d fields, expected %d rows and %d or more fields
%s: could not initiate base backup: %s %s: could not open directory "%s": %s
%s: could not open log file "%s": %s
%s: could not open timeline history file "%s": %s
%s: could not open transaction log file "%s": %s
%s: could not pad transaction log file "%s": %s
%s: could not parse next timeline's starting point "%s"
%s: could not parse start position "%s"
%s: could not parse transaction log location "%s"
%s: could not read COPY data: %s %s: could not read directory "%s": %s
%s: could not read from ready pipe: %s
%s: could not receive data from WAL stream: %s %s: could not rename file "%s" to "%s": %s
%s: could not rename file "%s": %s
%s: could not seek to beginning of transaction log file "%s": %s
%s: could not send command to background pipe: %s
%s: could not send copy-end packet: %s %s: could not send feedback packet: %s %s: could not send replication command "%s": %s %s: could not set compression level %d: %s
%s: could not set permissions on directory "%s": %s
%s: could not set permissions on file "%s": %s
%s: could not stat file "%s": %s
%s: could not stat transaction log file "%s": %s
%s: could not wait for child process: %s
%s: could not wait for child thread: %s
%s: could not write %u bytes to WAL file "%s": %s
%s: could not write %u bytes to log file "%s": %s
%s: could not write timeline history file "%s": %s
%s: could not write to compressed file "%s": %s
%s: could not write to file "%s": %s
%s: creating replication slot "%s"
%s: directory "%s" exists but is not empty
%s: directory name too long
%s: disconnected
%s: disconnected; waiting %d seconds to try again
%s: dropping replication slot "%s"
%s: final receive failed: %s %s: finished segment at %X/%X (timeline %u)
%s: got WAL data offset %08x, expected %08x
%s: incompatible server version %s
%s: incompatible server version %s; client does not support streaming from server versions newer than %s
%s: incompatible server version %s; client does not support streaming from server versions older than %s
%s: initiating base backup, waiting for checkpoint to complete
%s: integer_datetimes compile flag does not match server
%s: invalid --max-rate unit: "%s"
%s: invalid checkpoint argument "%s", must be "fast" or "spread"
%s: invalid compression level "%s"
%s: invalid fsync interval "%s"
%s: invalid output format "%s", must be "plain" or "tar"
%s: invalid port number "%s"
%s: invalid socket: %s %s: invalid status interval "%s"
%s: invalid tablespace mapping format "%s", must be "OLDDIR=NEWDIR"
%s: invalid tar block header size: %d
%s: invalid transfer rate "%s": %s
%s: invalid xlog-method option "%s", must be "fetch" or "stream"
%s: multiple "=" signs in tablespace mapping
%s: new directory is not an absolute path in tablespace mapping: %s
%s: no data returned from server
%s: no database specified
%s: no slot specified
%s: no target directory specified
%s: no target file specified
%s: no transaction log end position returned from server
%s: not renaming "%s%s", segment is not complete
%s: old directory is not an absolute path in tablespace mapping: %s
%s: only tar mode backups can be compressed
%s: out of memory
%s: received interrupt signal, exiting
%s: received transaction log record for offset %u with no file open
%s: replication connection using slot "%s" is unexpectedly database specific
%s: replication slots can only be used with WAL streaming
%s: replication stream was terminated before stop point
%s: segment file "%s" has incorrect size %d, skipping
%s: select() failed: %s
%s: server reported unexpected history file name for timeline %u: %s
%s: server reported unexpected next timeline %u, following timeline %u
%s: server returned unexpected response to BASE_BACKUP command; got %d rows and %d fields, expected %d rows and %d fields
%s: server stopped streaming timeline %u at %X/%X, but reported next timeline %u to begin at %X/%X
%s: starting background WAL receiver
%s: starting log streaming at %X/%X (slot %s)
%s: starting log streaming at %X/%X (timeline %u)
%s: starting timeline %u is not present in the server
%s: streaming header too small: %d
%s: streaming initiated
%s: switched to timeline %u at %X/%X
%s: symlinks are not supported on this platform
%s: system identifier does not match between base backup and streaming connection
%s: this build does not support compression
%s: too many command-line arguments (first is "%s")
%s: transaction log directory location can only be specified in plain mode
%s: transaction log directory location must be an absolute path
%s: transaction log file "%s" has %d bytes, should be 0 or %d
%s: transfer rate "%s" exceeds integer range
%s: transfer rate "%s" is not a valid value
%s: transfer rate "%s" is out of range
%s: transfer rate must be greater than zero
%s: unexpected response to TIMELINE_HISTORY command: got %d rows and %d fields, expected %d rows and %d fields
%s: unexpected result set after end-of-timeline: got %d rows and %d fields, expected %d rows and %d fields
%s: unexpected termination of replication stream: %s %s: unrecognized link indicator "%c"
%s: unrecognized streaming header: "%c"
%s: waiting for background process to finish streaming ...
Password: Try "%s --help" for more information.
Usage:
cannot duplicate null pointer (internal error)
out of memory
transaction log start point: %s on timeline %u
Project-Id-Version: PostgreSQL 9.6
Report-Msgid-Bugs-To: pgsql-bugs@postgresql.org
POT-Creation-Date: 2021-11-07 09:52+0000
PO-Revision-Date: 2021-11-07 06:43+0100
Last-Translator: Dennis Björklund <db@zigo.dhs.org>
Language-Team: Swedish <pgsql-translators@postgresql.org>
Language: sv
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Plural-Forms: nplurals=2; plural=n != 1;
Handling att utföra:
Flaggor för anslutning:
Allmänna flaggor:
Valfria handlingar:
Flaggor som styr utmatning:
Flaggor:
Rapportera fel till <pgsql-bugs@postgresql.org>.
--create-slot skapa en ny replikeringsslot (angående slot:ens namn, se --slot)
--drop-slot släng replikeringsslot (angående slot:ens namn, se --slot)
--if-not-exists inget fel om slot:en redan finns när vi skapar slot:en
--start starta strömning i en replikeringsslot (angående slot:ens namn, se --slot)
--synchronous flush:a transaktionsloggar direkt efter skrivning
--xlogdir=XLOGDIR katalog för transaktionsloggen
%s [FLAGGA]...
-?, --help visa den här hjälpen, avsluta sedan
-D, --directory=DIR ta emot transaktionsloggfiler till denna katalog
-D, --pgdata=KATALOG ta emot basbackup till katalog
-F --fsync-interval=SEK
tid mellan fsync av utdatafil (standard: %d)
-F, --format=p|t utdataformat (plain (standard), tar)
-I, --startpos=LSN var i en existerande slot skall strömningen starta
-P, --plugin=PLUGIN använd utmatnings-plugin:en PLUGIN (standard: %s)
-P, --progress visa förloppsinformation
-R, --write-recovery-conf
skriv recovery.conf för replikering
-S, --slot=SLOTNAMN namn på den logiska replikerings-slotten
-S, --slot=SLOTNAMN replikerings-slot att använda
-T, --tablespace-mapping=GAMMALKAT=NYKAT
flytta tablespace i GAMMALKAT till NYKAT
-U, --username=NAMN ansluta som angiven databasanvändare
-V, --version visa versionsinformation, avsluta sedan
-W, --password tvinga fram lösenordsfråga (skall ske automatiskt)
-X, --xlog-method=fetch|stream
inkludera WAL-filer som krävs med respektive metod
-Z, --compress=0-9 komprimera tar-utdata med given komprimeringsnivå
-c, --checkpoint=fast|spread
ställ in "fast" eller "spread" checkpoint-metod
-d, --dbname=CONNSTR anslutningssträng
-d, --dbname=DBNAMN databas att ansluta till
-f, --file=FIL ta emot logg till denna fil, - för stdout
-h, --host=HOSTNAMN databasserverns värdnamn eller socket-katalog
-l, --label=ETIKETT sätt backup-etikett
-n, --no-loop loopa inte om anslutning tappas
-o, --option=NAMN[=VÄRDE]
skicka vidare flaggan NAMN med ev. värde VÄRDE till
utmatnings-plugin:en
-p, --port=PORT databasserverns postnummer
-r, --max-rate=RATE maximal överföringshastighet för att överföra datakatalog
(i kB/s, eller använd suffix "k" resp. "M")
-s, --status-interval=INTERVAL
tid mellan att statuspaket skickas till servern (i sekunder)
-s, --status-interval=SEKS
tid mellan att statuspaket skickas till serverb (standard: %d)
-v, --verbose mata ut utförliga meddelanden
-w, --no-password fråga aldrig efter lösenord
-x, --xlog inkludera WAL-filer som krävs i backup:en (läget "fetch")
-z, --gzip komprimera tar-utdata
%*s/%s kB (%d%%), %d/%d tablespace %*s/%s kB (%d%%), %d/%d tablespace %*s/%s kB (%d%%), %d/%d tablespace (%s%-*.*s) %*s/%s kB (%d%%), %d/%d tablespace (%s%-*.*s) %*s/%s kB (100%%), %d/%d tablespace %*s %*s/%s kB (100%%), %d/%d tablespace %*s %s styr PostgreSQL:s logiskt avkodade strömmar.
%s tar emot PostgreSQL strömmande transaktionsloggar.
%s tar en basbackup av en körande PostgreSQL-server.
%s: %s %s: %s kräver att en slot anges med --slot
%s: COPY-ström avslutade innan sista filen var klar
%s: WAL-strömning kan bara användas i läget "plain"
%s: minst en handling måste anges
%s: kunde bara skriva en endaste tablespace till stdout, databasen har %d
%s: kan inte ange både --xlog och --xlog-method
%s: kan inte använda --create-slot eller --drop-slot tillsammans med --startpos
%s: kan inte använda --create-slot eller --start tillsammans med --drop-slot
%s: kan inte använda --create-slot tillsammans med --drop-slot
%s: checkpoint klar
%s: barn %d dog, förväntade %d
%s: barntråd avslutade med fel %u
%s: bekräftar skrivning fram till %X/%X, flush till %X/%X (slot %s)
%s: kunde inte komma åt katalogen "%s": %s
%s: kunde inte nollställa search_path: %s %s: kunde inte stänga komprimerad fil "%s": %s
%s: kunde inte stänga katalog "%s": %s
%s: kunde inte stänga fil "%s": %s
%s: kunde inte ansluta till server
%s: kunde inte skapa arkivstatusfil "%s": %s
%s: kunde inte skapa bakgrundsprocess: %s
%s: kunde inte skapa bakgrundstråd: %s
%s: kunde inte skapa komprimerad fil "%s": %s
%s: kunde inte skapa katalogen "%s": %s
%s: kunde inte skapa fil "%s": %s
%s: kunde inte skapa rör (pipe) för bakgrundsprocess: %s
%s: kunde inte skapa replikeringsslot "%s": fick %d rader och %d fält, förväntade %d rader och %d fält
%s: kunde inte skapa symbolisk länk "%s": %s
%s: kunde inte skapa symbolisk länk från "%s" till "%s": %s
%s: kunde inte skapa tidslinjehistorikfil "%s": %s
%s: kunde inte fastställa sökposition i fil "%s": %s
%s: kunde inte lista ut serverns inställning för integer_datetimes
%s: kunde inte slänga replikeringsslot "%s": fick %d rader och %d fält, förväntade %d rader och %d fält
%s: kunde inte upprätta databasspecifik replikeringsanslutning
%s: kunde inte utföra fsync på filen "%s": %s
%s: kunde inte fsync:a loggfil "%s": %s
%s: kunde inte hämta COPY-data-ström: %s %s: kunde inte hämta backup-header: %s %s: kunde inte hämta barntrådens slutstatus: %s
%s: kunde inte få slutposition för transaktionslogg från servern: %s %s: kunde inte identifiera systemet: fick %d rader och %d fält, förväntade %d rader och %d eller fler fält
%s: kunde inte initiera basbackup: %s %s: kunde inte öppna katalog "%s": %s
%s: kunde inte öppna logg-fil "%s": %s
%s: kunde inte öppna tidslinjes historikfil "%s": %s
%s: kunde inte öppna transaktionsloggfil "%s": %s
%s: kunde inte justera (pad) transaktionsloggfil "%s": %s
%s: kunde inte parsa nästa tidslinjens startpunkt "%s"
%s: kunde inte parsa startposition "%s"
%s: kunde inte parsa transaktionsloggsplatsen "%s"
%s: kunde inte läsa COPY-data: %s %s: kunde inte läsa katalog "%s": %s
%s: kunde inte läsa från klart rör (pipe): %s
%s: kunde inte ta emot data från WAL-ström: %s %s: kunde inte döpa om fil "%s" till "%s": %s
%s: kunde inte byta namn på fil "%s": %s
%s: kunde inte hoppa till början på transaktionsloggfil "%s": %s
%s: kunde inte skicka kommando till bakgrundsrör (pipe): %s
%s: kunde inte skicka "copy-end"-paket: %s %s: kunde inte skicka feedback-paket: %s %s: kunde inte skicka replikeringskommando "%s": %s %s: kunde inte sätta komprimeringsnivå %d: %s
%s: kunde inte sätta rättigheter på katalog "%s": %s
%s: kunde inte sätta rättigheter på fil "%s": %s
%s: kunde ta status på filen "%s": %s
%s: kunde inte göra stat på transaktionsloggfil "%s": %s
%s: kunde inte vänta på barnprocess: %s
%s: kunde inte vänta på barntråd: %s
%s: kunde inte skriva %u byte till WAL-fil "%s": %s
%s: kunde inte skriva %u byte till loggfil "%s": %s
%s: kunde inte skriva tidslinjehistorikfil "%s": %s
%s: kunde inte skriva till komprimerad fil "%s": %s
%s: kunde inte skriva till fil "%s": %s
%s: skapar replikeringsslot "%s"
%s: katalogen "%s" existerar men är inte tom.
%s: katalognamn för långt
%s: nerkopplad
%s: nerkopplad; väntar %d sekunder för att försöka igen
%s: slänger replikeringsslot "%s"
%s: sista mottagning misslyckades: %s %s: slutförde segment vid %X/%X (tidslinje %u)
%s: fick WAL-data-offset %08x, förväntade %08x
%s: inkompatibel serverversion %s
%s: inkompatibel serverversion %s; klienten stöder inte stömning från serverversioner nyare än %s
%s: inkompatibel serverversion %s; klienten stöder inte stömning från serverversioner äldre än %s
%s: initierar basbackup, väntar på att checkpoint skall gå klart
%s: kompileringsflaggan integer_datetimes matchar inte servern
%s: ogiltig enhet för --max-rate: "%s"
%s: ogiltigt checkpoint-argument "%s", måste vara "fast" eller "spread"
%s: ogiltig komprimeringsnivå "%s"
%s: ogiltigt fsync-intervall "%s"
%s: ogiltigt utdataformat "%s", måste vara "plain" eller "tar"
%s: ogiltigt portnummer "%s"
%s: ogiltigt uttag: %s %s: ogiltigt status-intervall "%s"
%s: ogiltigt tablespace-mappningsformat "%s", måste vara "OLDDIR=NEWDIR"
%s: ogiltig tar-block-header-storlek: %d
%s: ogiltig överföringshastighet "%s": %s
%s: ogiltig xlog-metodflagga "%s", måste vara "fetch" eller "stream"
%s: multipla "="-tecken i tablespace-mappning
%s: ny katalog är inte en absolut sökväg i tablespace-mappning: %s
%s: ingen data returnerades från servern
%s: ingen databas angiven
%s: ingen slot angiven
%s: ingen målkatalog angiven
%s: ingen målfil angiven
%s: ingen slutposition för transaktionslogg returnerad från servern
%s: byter inte namn på "%s%s", segmentet är inte komplett
%s: gammal katalog är inte en absolut sökväg i tablespace-mappning: %s
%s: bara backupper i tar-läge kan komprimeras
%s: slut på minne
%s: mottog avbrottsignal, avslutar
%s: tog emot transaktionsloggspost för offset %u utan någon öppen fil
%s: replikeringsanslutning som använder slot "%s" är oväntat databasspecifik
%s: replikerings-slot kan bara användas med WAL-strömning
%s: replikeringsström avslutades innan stoppunkt
%s: segmentfil "%s" har inkorrekt storlek %d, hoppar över
%s: select() misslyckades: %s
%s: servern rapporterade oväntat historikfilnamn för tidslinje %u: %s
%s: servern rapporterade oväntad nästa tidslinje %u, följer på tidslinje %u
%s: servern retunerade ett oväntat svar på BASE_BACKUP-kommandot; fick %d rader och %d fält, förväntade %d rader och %d fält
%s: servern stoppade strömning av tidslinje %u vid %X/%X men rapporterade nästa tidslinje %u skulle börja vid %X/%X
%s: startar bakgrunds-WAL-mottagare
%s: startar logg-strömning vid %X/%X (slot %s)
%s: startar logg-strömning vid %X/%X (tidslinje %u)
%s: starttidslinje %u finns inte tillgänglig i servern
%s: strömningsheader för liten: %d
%s: strömning initierad
%s: bytte till tidslinje %u vid %X/%X
%s: symlänkar stöds inte på denna plattform
%s: systemidentifieraren matchar inte mellan basbackup och strömningsanslutning
%s: detta bygge stöder inte komprimering
%s: för många kommandoradsargument (första är "%s")
%s: katalog för transaktionsloggar kan bara anges i läget "plain"
%s: Filkatalogen för transaktionsloggar måste vara en absolut sökväg.
%s: transaktionsloggfil "%s" har %d byte, skall vara 0 eller %d
%s: överföringshastighet "%s" överskrider heltalsintervall
%s: överföringshastighet "%s" är inte ett giltigt värde
%s: överföringshastighet "%s" är utanför sitt intervall
%s: överföringshastigheten måste vara större än noll
%s: oväntat svar på TIMELINE_HISTORY-kommando: fick %d rader och %d fält, förväntade %d rader och %d fält
%s: oväntad resultatmängd efter slut-på-tidslinje: fick %d rader och %d fält, förväntade %d rader och %d fält
%s: oväntad terminering av replikeringsström: %s %s: okänd länkindikator "%c"
%s: okänd strömningsheader: "%c"
%s: väntat på att bakgrundsprocess skall avsluta strömmande ...
Lösenord: Försök med "%s --help" för mer information.
Användning:
kan inte duplicera null-pekare (internt fel)
slut på minne
startpunkt för transaktionslogg: %s på tidslinje %u
locale/sv/LC_MESSAGES/ecpglib6-9.6.mo 0000644 00000006740 14751153420 0012573 0 ustar 00 �� ! $ / , � � � � ) ' - Q : 0 � $ � ( 9 L * c ; � > � 3 < = & z 1 � � + � ' @ % Y � , � � 2 0 ; / l � � @ J P U k % x / � M � 7
( T
3 }
�
�
( �
7 7 ; 2 s ; � ! � 1 6 + S % � " � � � &
! F
( h
' �
& �
! <DEFAULT> <empty> NULL SQL error %d on line %d SQL error: %s
connection "%s" does not exist on line %d could not connect to database "%s" on line %d could not convert boolean value: size mismatch, on line %d data read from server is not an array on line %d descriptor "%s" not found on line %d descriptor index out of range on line %d empty message text empty query on line %d error in transaction processing on line %d inserting an array of variables is not supported on line %d invalid input syntax for floating-point type: "%s", on line %d invalid input syntax for type int: "%s", on line %d invalid input syntax for type unsigned int: "%s", on line %d invalid statement name "%s" on line %d invalid syntax for type boolean: "%s", on line %d no data found on line %d not connected to connection "%s" on line %d null value without indicator on line %d out of memory on line %d the connection to the server was lost too few arguments on line %d too many arguments on line %d unrecognized descriptor item "%s" on line %d unsupported type "%s" on line %d variable does not have a character type on line %d variable does not have a numeric type on line %d variable does not have an array type on line %d Project-Id-Version: PostgreSQL 9.6
Report-Msgid-Bugs-To: pgsql-bugs@postgresql.org
POT-Creation-Date: 2021-11-07 09:48+0000
PO-Revision-Date: 2021-11-07 10:36+0100
Last-Translator: Dennis Björklund <db@zigo.dhs.org>
Language-Team: Swedish <pgsql-translators@postgresql.org>
Language: sv
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Plural-Forms: nplurals=2; plural=n != 1;
<DEFAULT> <tom> NULL SQL-fel %d på rad %d SQL-fel: %s
anslutning "%s" funns inte på rad %d kunde inte ansluta till databas "%s" på rad %d kunde inte konvertera booleanskt värde: storlekarna matchar inte, på rad %d data inläst från servern är inte en array på rad %d deskriptor "%s" hittades inte på rad %d deskriptor-index utanför sitt intervall på rad %d tom meddelandetext tom fråga på rad %d fel i transaktionsprocessande på rad %d sätta in en array med variabler stöds inte på rad %d ogiltig inputsyntaxc för flyttalstyp: "%s", på rad %d ogiltig inputsyntax för typ int: "%s", på rad %d ogiltig inputsyntax för typ unsigned int: "%s", på rad %d ogiltigt satsnamn "%s" på rad %d ogiltig syntax för typ boolean: "%s", på rad %d ingen data hittad på rad %d ej ansluten till anslutning "%s" på rad %d null-värde utan indikator på rad %d slut på minne på rad %d anslutningen till servern tappades för få argument på rad %d för många argument på rad %d okänd deskriptor-post "%s" på rad %d ej stöd för typ "%s" på rad %d variabel har ej character-typ på rad %d variabel har ej numerisk typ på rad %d variabel har inte array-typ på rad %d locale/sv/LC_MESSAGES/initdb-9.6.mo 0000644 00000054457 14751153420 0012361 0 ustar 00 �� � , � <
�
R �
* 5 - F g t ` � � = W W X � A � 5 � J / z 6 � P � C : b Q � 5 � ] % 4 � B � H � G D > � 4 � 9 3 : ? n / � - � > y K ( � # � , - ? 7 m ( � 6 � , ' 2 5 Z F � " � < � & 7 - ^ - � ! � 1 � ? & N / u = � ! � " 6 ( + _ � 0 � ; � $ / 4 & d � $ � ~ � 1 M < � G � 3 " 8 V ( � J � � � � C � - C! 8 q! ! �! , �! �! J " 0 \" 4 �" A �" @ # R E# K �# " �# ! $ � )$ d �$ % %% � D% [ �% R $& K w& % �& �& ' ' ; 8' ; t' � �' @ A( ; �( �( u �) q E* f �* s + & �+ �+ ) �+ t �+ / `, �, & �, 0 �, . �, - &- T- k- & }- # �- �- $ �- ( . + 7. " c. �. " �. ! �. , �. $ / * 8/ % c/ ! �/ �/ �/ 0 �/ 0 (0 ,0 ;0 - M0 {0 & �0 % �0 �0 3 1 :1 T1 ( h1 � �1 K 53 �3
�3 �3 2 �3 ` �3 q K4 � �4 I �5 Q �5 � :6 E :7 1 �7 L �7 �7 = 8 P ]8 E �8 B �8 F 79 ; ~9 c �9 @ : D _: G �: I �: A 6; > x; 8 �; 8 �; < )< 2 f< 8 �< < �< ~ = , �= ( �= ( �= 0
> : >> ( y> @ �> . �> * ? ? =? Q }? 0 �? ? @ ' @@ 1 h@ 2 �@ # �@ 7 �@ F )A & pA 0 �A = �A ' B # .B < RB / �B ! �B - �B C C . SC @ �C 3 �C �C ! D | 9D < �D @ �D 4E B PE = �E > �E 6 F c GF � �F lG ! �G A �G , �G C H UH , uH �H K �H / I 8 <I R uI J �I ^ J L rJ + �J ' �J � K T �K �K 2 L � ?L Z �L a M C �M ) �M # �M # N 7N 8 LN 6 �N � �N : QO G �O �O � �P r eQ u �Q o NR / �R
�R - �R z *S - �S �S �S - T ) 1T ) [T �T �T % �T $ �T " U 5 'U * ]U 2 �U # �U �U " �U % V . EV 8 tV 4 �V ' �V
W *W AW 4 \W �W �W �W �W ( �W �W 1 X 0 HX yX 1 �X �X �X 3 �X � � 5 ( � ] � � J l 6 H X � � K z � � r I � � { � N d R V o | ~ � . y U } � m � ` G = * f / $ � > _ � # A � t C 8 Y 0 T , � % + v L 3 � 2 n � � h B j E ? 9 ) ! & � � � q � � D S Z g
e ; ' ^ " F x c � w P [ s � @ i �
1 - \ � u : k � 4 W Q 7 � O � < M p a b �
If the data directory is not specified, the environment variable PGDATA
is used.
Less commonly used options:
Options:
Other options:
Report bugs to <pgsql-bugs@postgresql.org>.
Success. You can now start the database server using:
%s%s%spg_ctl%s -D %s%s%s -l logfile start
Sync to disk skipped.
The data directory might become corrupt if the operating system crashes.
WARNING: enabling "trust" authentication for local connections
You can change this by editing pg_hba.conf or using the option -A, or
--auth-local and --auth-host, the next time you run initdb.
--auth-host=METHOD default authentication method for local TCP/IP connections
--auth-local=METHOD default authentication method for local-socket connections
--lc-collate=, --lc-ctype=, --lc-messages=LOCALE
--lc-monetary=, --lc-numeric=, --lc-time=LOCALE
set default locale in the respective category for
new databases (default taken from environment)
--locale=LOCALE set default locale for new databases
--no-locale equivalent to --locale=C
--pwfile=FILE read password for the new superuser from file
%s [OPTION]... [DATADIR]
-?, --help show this help, then exit
-A, --auth=METHOD default authentication method for local connections
-E, --encoding=ENCODING set default encoding for new databases
-L DIRECTORY where to find the input files
-N, --nosync do not wait for changes to be written safely to disk
-S, --sync-only only sync data directory
-T, --text-search-config=CFG
default text search configuration
-U, --username=NAME database superuser name
-V, --version output version information, then exit
-W, --pwprompt prompt for a password for the new superuser
-X, --xlogdir=XLOGDIR location for the transaction log directory
-d, --debug generate lots of debugging output
-k, --data-checksums use data page checksums
-n, --noclean do not clean up after errors
-s, --show show internal settings
[-D, --pgdata=]DATADIR location for this database cluster
%s initializes a PostgreSQL database cluster.
%s: "%s" is not a valid server encoding name
%s: WARNING: cannot create restricted tokens on this platform
%s: cannot be run as root
Please log in (using, e.g., "su") as the (unprivileged) user that will
own the server process.
%s: could not access directory "%s": %s
%s: could not access file "%s": %s
%s: could not allocate SIDs: error code %lu
%s: could not change permissions of "%s": %s
%s: could not change permissions of directory "%s": %s
%s: could not create directory "%s": %s
%s: could not create restricted token: error code %lu
%s: could not create symbolic link "%s": %s
%s: could not execute command "%s": %s
%s: could not find suitable encoding for locale "%s"
%s: could not find suitable text search configuration for locale "%s"
%s: could not fsync file "%s": %s
%s: could not get exit code from subprocess: error code %lu
%s: could not open directory "%s": %s
%s: could not open file "%s" for reading: %s
%s: could not open file "%s" for writing: %s
%s: could not open file "%s": %s
%s: could not open process token: error code %lu
%s: could not re-execute with restricted token: error code %lu
%s: could not read directory "%s": %s
%s: could not read password from file "%s": %s
%s: could not start process for command "%s": error code %lu
%s: could not stat file "%s": %s
%s: could not write file "%s": %s
%s: data directory "%s" not removed at user's request
%s: directory "%s" exists but is not empty
%s: encoding mismatch
%s: failed to remove contents of data directory
%s: failed to remove contents of transaction log directory
%s: failed to remove data directory
%s: failed to remove transaction log directory
%s: failed to restore old locale "%s"
%s: file "%s" does not exist
%s: file "%s" is not a regular file
%s: input file "%s" does not belong to PostgreSQL %s
Check your installation or specify the correct path using the option -L.
%s: input file location must be an absolute path
%s: invalid authentication method "%s" for "%s" connections
%s: invalid locale name "%s"
%s: invalid locale settings; check LANG and LC_* environment variables
%s: locale "%s" requires unsupported encoding "%s"
%s: locale name has non-ASCII characters, skipped: "%s"
%s: locale name too long, skipped: "%s"
%s: must specify a password for the superuser to enable %s authentication
%s: no data directory specified
You must identify the directory where the data for this database system
will reside. Do this with either the invocation option -D or the
environment variable PGDATA.
%s: out of memory
%s: password file "%s" is empty
%s: password prompt and password file cannot be specified together
%s: removing contents of data directory "%s"
%s: removing contents of transaction log directory "%s"
%s: removing data directory "%s"
%s: removing transaction log directory "%s"
%s: setlocale() failed
%s: superuser name "%s" is disallowed; role names cannot begin with "pg_"
%s: symlinks are not supported on this platform
%s: too many command-line arguments (first is "%s")
%s: transaction log directory "%s" not removed at user's request
%s: transaction log directory location must be an absolute path
%s: warning: specified text search configuration "%s" might not match locale "%s"
%s: warning: suitable text search configuration for locale "%s" is unknown
Data page checksums are disabled.
Data page checksums are enabled.
Encoding "%s" implied by locale is not allowed as a server-side encoding.
The default database encoding will be set to "%s" instead.
Encoding "%s" is not allowed as a server-side encoding.
Rerun %s with a different locale selection.
Enter it again: Enter new superuser password: If you want to create a new database system, either remove or empty
the directory "%s" or run %s
with an argument other than "%s".
If you want to store the transaction log there, either
remove or empty the directory "%s".
It contains a dot-prefixed/invisible file, perhaps due to it being a mount point.
It contains a lost+found directory, perhaps due to it being a mount point.
No usable system locales were found.
Passwords didn't match.
Rerun %s with the -E option.
Running in debug mode.
Running in noclean mode. Mistakes will not be cleaned up.
The database cluster will be initialized with locale "%s".
The database cluster will be initialized with locales
COLLATE: %s
CTYPE: %s
MESSAGES: %s
MONETARY: %s
NUMERIC: %s
TIME: %s
The default database encoding has accordingly been set to "%s".
The default text search configuration will be set to "%s".
The encoding you selected (%s) and the encoding that the
selected locale uses (%s) do not match. This would lead to
misbehavior in various character string processing functions.
Rerun %s and either do not specify an encoding explicitly,
or choose a matching combination.
The files belonging to this database system will be owned by user "%s".
This user must also own the server process.
The program "postgres" is needed by %s but was not found in the
same directory as "%s".
Check your installation.
The program "postgres" was found by "%s"
but was not the same version as %s.
Check your installation.
This might mean you have a corrupted installation or identified
the wrong directory with the invocation option -L.
Try "%s --help" for more information.
Usage:
Use the option "--debug" to see details.
Using a mount point directly as the data directory is not recommended.
Create a subdirectory under the mount point.
cannot duplicate null pointer (internal error)
caught signal
child process exited with exit code %d child process exited with unrecognized status %d child process was terminated by exception 0x%X child process was terminated by signal %d: %s command not executable command not found could not change directory to "%s": %s could not close directory "%s": %s
could not find a "%s" to execute could not get junction for "%s": %s
could not identify current directory: %s could not look up effective user ID %ld: %s could not open directory "%s": %s
could not read binary "%s" could not read directory "%s": %s
could not read symbolic link "%s" could not remove file or directory "%s": %s
could not set junction for "%s": %s
could not stat file or directory "%s": %s
could not write to child process: %s
creating configuration files ... creating directory %s ... creating subdirectories ... fixing permissions on existing directory %s ... invalid binary "%s" ok
out of memory
pclose failed: %s performing post-bootstrap initialization ... running bootstrap script ... selecting default max_connections ... selecting default shared_buffers ... selecting default timezone ... selecting dynamic shared memory implementation ... syncing data to disk ... user does not exist user name lookup failure: error code %lu Project-Id-Version: PostgreSQL 9.6
Report-Msgid-Bugs-To: pgsql-bugs@postgresql.org
POT-Creation-Date: 2021-11-07 09:52+0000
PO-Revision-Date: 2021-11-07 09:53+0100
Last-Translator: Dennis Björklund <db@zigo.dhs.org>
Language-Team: Swedish <pgsql-translators@postgresql.org>
Language: sv
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Plural-Forms: nplurals=2; plural=n != 1;
Om datakatalogen inte anges så tas den från omgivningsvariabeln PGDATA.
Mindre vanliga flaggor:
Flaggor:
Andra flaggor:
Rapportera fel till <pgsql-bugs@postgresql.org>.
Lyckades. Du kan nu starta databasservern med:
%s%s%spg_ctl%s -D %s%s%s -l loggfil start
Avstod från synkning mot lagringsmedium.
Datakatalogen kan komma att fördärvas om operativsystemet störtar.
VARNING: Autentiseringsmetod "trust" är aktiv för någon uppkoppling.
Du kan ändra detta genom att redigera "pg_hba.conf" eller genom att sätta
flaggor -A eller --auth-local och --auth-host nästa gång du kör initdb.
--auth-host=METOD autentiseringsmetod för TCP/IP-anslutningar
--auth-local=METOD autentiseringsmetod för anslutningar via unix-uttag
--lc-collate=, --lc-ctype=, --lc-messages=LOKAL
--lc-monetary=, --lc-numeric=, --lc-time=LOKAL
sätter standardlokal i utvald kategori för
nya databaser (förval hämtas ur omgivningen)
--locale=LOKAL sätter standardlokal för nya databaser
--no-locale samma som --locale=C
--pwfile=FIL läser lösenord för superanvändare från fil
%s [FLAGGA]... [DATAKATALOG]
-?, --help visa denna hjälp, avsluta sedan
-A, --auth=METOD förvald autentiseringsmetod för alla anslutningar
-E, --encoding=KODNING sätter teckenkodning för nya databaser
-L KATALOG katalog där indatafiler skall sökas
-N, --nosync invänta ej skrivning till lagringsmedium
-S, --sync-only synkning endast av datakatalog
-T, --text-search-config=CFG
standardkonfiguration för textsökning
-U, --username=NAMN namn på databasens superanvändare
-V, --version visa versionsinformation, avsluta sedan
-W, --pwprompt efterfråga lösenord för superanvändare
-X, --xlogdir=XLOGDIR läge för filkatalog med transaktionsloggar
-d, --debug generera massor med debug-utskrifter
-k, --data-checksums använd checksummor på datablock
-n, --noclean städa inte efter felutfall
-s, --show visa interna inställningar
[-D, --pgdata=]DATAKATALOG läge för detta databaskluster
%s initierar ett databaskluster för PostgreSQL.
%s: "%s" är inte en giltig teckenkodning för servern.
%s: VARNING: "Restricted Token" stöds inte av plattformen.
%s: kan inte köras som root
Logga in (t.ex. med "su") som den (opriviligerade) användare
vilken skall äga serverprocessen.
%s: kunde inte komma åt katalogen "%s": %s
%s: kunde inte komma åt filen "%s": %s
%s: kunde inte tilldela SID: felkod %lu
%s: kunde inte ändra rättigheter på "%s": %s
%s: kunde inte ändra rättigheter på katalogen "%s": %s
%s: kunde inte skapa katalogen "%s": %s
%s: kunde inte skapa restriktivt styrmärke (token): felkod %lu
%s: kunde inte skapa symbolisk länk "%s": %s
%s: kunde inte utföra kommandot "%s": %s
%s: kunde inte välja en lämplig kodning för lokalnamn "%s".
%s: kunde inte hitta en lämplig textsökningskonfiguration för lokalnamn "%s".
%s: kunde inte utföra fsync på filen "%s": %s
%s: kunde inte utvinna statuskod för underprocess: felkod %lu
%s: kunde inte öppna katalog "%s": %s
%s: kunde inte öppna fil "%s" för läsning: %s
%s: kunde inte öppna fil "%s" för skrivning: %s
%s: kunde inte öppna fil "%s": %s
%s: kunde inte skapa processmärke (token): felkod %lu
%s: kunde inte upprepa med restriktivt styrmärke (token): felkod %lu
%s: kunde inte läsa katalog "%s": %s
%s: kunde inte läsa lösenord i filen "%s": %s
%s: kunde inte starta process för kommando "%s": felkod %lu
%s: kunde ta status på filen "%s": %s
%s: kunde inte skriva fil "%s": %s
%s: Datakatalog "%s" ej borttagen på användares begäran.
%s: katalogen "%s" existerar men är inte tom.
%s: Oförenliga teckenkodningar.
%s: misslyckades med att tömma datakatalog.
%s: Misslyckades med att tömma katalogen för transaktionsloggar.
%s: misslyckades med att ta bort datakatalog.
%s: Misslyckades med att ta bort katalog för transaktionslogg.
%s: misslyckades att återställa lokalspråk "%s"
%s: Filen "%s" existerar inte.
%s: "%s" är inte en normal fil.
%s: Indatafilen "%s" hör inte till PostgreSQL %s.
Kontrollera din installation eller ange korrekt sökväg med flaggan -L.
%s: plats för indatafiler måste vara en absolut sökväg.
%s: Ogiltig autentiseringsmetod "%s" vid förbindelseslag "%s".
%s: okänt lokalnamn "%s".
%s: ogiltigt språkval. Kontrollera miljövariablerna LANG, LC_*.
%s: Lokalnamn "%s" kräver otillgänglig teckenkodning "%s".
%s: lokalnamnet innehåller annat än ASCII, förkastas: "%s"
%s: lokalnamnet är alltför långt, förkastas: "%s"
%s: Du måste ange ett lösenord för superanvändaren för att
kunna slå på autentisering "%s".
%s: Ingen datakatalog angiven.
Du måste uppge den katalog där data för detta databassystem
skall lagras. Gör det antingen med flaggan -D eller genom att
sätta omgivningsvariabeln PGDATA.
%s: slut på minne
%s: lösenordsfilen "%s" är tom
%s: lösenordsfråga och lösenordsfil kan inte anges samtidigt.
%s: tömmer innehållet i datakatalog "%s".
%s: Tömmer innehållet ur katalogen för transaktionsloggar "%s".
%s: tar bort datakatalog "%s".
%s: Tar bort transaktionsloggskatalog "%s".
%s: setlocale() misslyckades
%s: superuser-namn "%s" tillåts inte; rollnamn får inte börja på "pg_"
%s: symlänkar stöds inte på denna plattform
%s: för många kommandoradsargument (första är "%s")
%s: Katalogen för transaktionsloggar "%s" ej borttagen på användares begäran.
%s: Filkatalogen för transaktionsloggar måste vara en absolut sökväg.
%s: Varning: Uppgiven textsökningskonfiguration "%s" passar
kanske inte till lokalnamn "%s".
%s: Varning: Ingen lämplig textsökningskonfiguration för lokalnamn "%s".
Checksummor för datablock är avstängda.
Checksummor för datablock är aktiva.
Teckenkodning "%s", tagen ur lokalnamnet, är inte godtagbar för servern.
I dess ställe sättes databasens förvalda teckenkodning till "%s".
Teckenkodning "%s" är inte godtagbar för servern.
Upprepa %s med annat lokalnamn.
Mata in det igen: Mata in ett nytt lösenord för superanvändaren: Om du vill skapa ett nytt databassystem, tag då antingen bort
eller töm katalogen "%s" eller kör %s
med annat argument än "%s".
Om du vill lagra transaktionsloggen där, radera eller töm
då filkatalogen "%s" först.
Den innehåller en gömd fil, med inledande punkt i namnet; kanske är detta en monteringspunkt.
Den innehåller "lost+found"; kanske är detta en monteringspunkt.
Inga tjänliga lokalnamn kunde uppdagas.
Lösenorden stämde inte överens.
Upprepa %s, men nu med flaggan -E.
Kör i debug-läge.
Kör i noclean-läge. Misstag kommer inte städas bort.
Databasklustret kommer att skapas med lokalnamn "%s".
Databasklustret kommer att initieras med lokalkategorier:
COLLATE: %s
CTYPE: %s
MESSAGES: %s
MONETARY: %s
NUMERIC: %s
TIME: %s
Förvald teckenkodning för databaser är satt till "%s".
Förvald textsökningskonfiguration för databaser är satt till "%s".
Teckenkodningen du har valt (%s) och teckenkodningen som
valda lokalen använder (%s) passar inte ihop. Detta kommer leda
till problem för funktioner som arbetar med strängar.
Kör %s igen och låt bli ange teckenkodning eller välj
en kombination som passar ihop.
Filer tillhörande databasen kommer att ägas av användaren "%s".
Denna användare måste också vara ägare av server-processen.
Programmet "postgres" behövs av %s men kunde inte hittas
i samma katalog som "%s".
Kontrollera din installation.
Programmet "postgres" hittades av "%s",
men det är inte byggt i samma version som %s.
Kontrollera din installation.
Detta kan betyda att du har en korrupt installation eller att du har
angivit felaktig katalog till flaggan -L.
Försök med "%s --help" för mer information.
Användning:
Nyttja flaggan "--debug" för fler detaljer.
Att använda en monteringspunkt som datakatalog rekommenderas inte.
Skapa först en underkatalog under monteringspunkten.
kan inte duplicera null-pekare (internt fel)
mottog signal
barnprocess avslutade med kod %d barnprocess avslutade med okänd statuskod %d barnprocess terminerades med avbrott 0x%X barnprocess terminerades av signal %d: %s kommandot är inte körbart kommandot kan ej hittas kunde inte byta katalog till "%s": %s kunde inte stänga katalog "%s": %s
kunde inte hitta en "%s" att köra kunde inte få en knutpunkt (junction) för "%s": %s
kunde inte identifiera aktuell katalog: %s kunde inte slå upp effektivt användar-id %ld: %s kunde inte öppna katalog "%s": %s
kunde inte läsa binär "%s" kunde inte läsa katalog "%s": %s
kunde inte läsa symbolisk länk "%s" kunde inte ta bort fil eller katalog "%s": %s
kunde inte sätta en knutpunkt (junction) för "%s": %s
kunde inte ta status på fil eller katalog "%s": %s
kunde inte skriva till barnprocess: %s
skapar konfigurationsfiler ... skapar katalog %s ... Skapar underkataloger ... sätter rättigheter på existerande katalog %s ... ogiltig binär "%s" ok
slut på minne
pclose misslyckades: %s utför initiering efter uppstättning... kör uppsättningsskript... sätter förvalt värde för max_connections ... sätter förvalt värde för shared_buffers ... sätter förvald tidszon ... väljer mekanism för dynamiskt, delat minne ... synkar data till disk ... användaren finns inte misslyckad sökning efter användarnamn: felkod %lu locale/sv/LC_MESSAGES/pg_ctl-9.6.mo 0000644 00000043155 14751153420 0012351 0 ustar 00 �� � � � , 0 D 1 ? v � � & �
0
- O
}
�
= �
�
� ! � a � K 0 | A � ! � 3 � ? / H o D � C � E A ? � ? � > 9 F L � B � E � V 0 � F > S 8 � I � % 2 ; O n 7 � � � M - f ! � > � E � C ; y 9 � D 3 C x D � > A @ ( � , � 2 � 6 > B * � / � % � 1 0 4 # e � 4 � 2 � 1 0 A , r . � 3 � + " 1 N 6 � : � 1 � * $ " O 7 r " � $ � J � = Y 3 p 0 � � ! � $ ; - \ � 4 � % � $ ! " *! ! M! F o! u �! F ," s" 7 �" ) �" k �" ` U# % �# & �# $ d $ p$ / �$ & �$ 0 �$ . % - F% t% �% & �% �% , �% ( & ;& ! V& x& �& �& �& �& �& �& ' ' $' 4' " L' o' � �' D 2) : w) , �) �) / �) # %* # I* 2 m* �* �* 3 �* + + � ?+ �+ c �+ I U, �, C �, ! �, ? - < `- F �- O �- M 4. R �. A �. C / ? [/ : �/ T �/ K +0 J w0 � �0 J _1 I �1 L �1 > A2 D �2 ( �2 C �2 S 23 5 �3 �3 �3 �3 Z �3 0 A4 r4 < �4 B �4 D 5 ~ V5 C �5 C 6 C ]6 E �6 S �6 E ;7 , �7 ( �7 3 �7 @ 8 ? L8 7 �8 ' �8 ' �8 0 9 1 E9 ) w9 �9 5 �9 5 �9 7 .: 7 f: / �: 2 �: 9 ; " ;; * ^; 1 �; 7 �; < �; 4 0< , e< " �< ; �< �< * = N == �= �= 7 �= : �= 3> R> ) o> ( �> ) �> �> 8 ? A? " b? �? �? Y �? p @ I �@ �@ E �@ . -A h \A e �A , +B / XB
�B � �B C - 5C cC - �C ) �C ) �C D "D % :D " `D 3 �D * �D �D % �D %E 9E IE & aE �E �E �E �E �E �E F , F ' EF P W � , � ` n m $ p � ~ < A 9 T ! : M D a G 2 E I { c # d � K | � � Q & ) 8 B 4 _ > f � y ( v L [ h \ ^ Z � 5 X R C F O } + � r � ] u w Y
e � x
7 / k - 0 � q 1 � b j ; 6 t g � N " @ U z H J . � ? s V � % S = � l ' * o 3 i �
%s: -w option cannot use a relative socket directory specification
%s: -w option is not supported when starting a pre-9.1 server
Allowed signal names for kill:
Common options:
Options for register and unregister:
Options for start or restart:
Options for stop or restart:
Report bugs to <pgsql-bugs@postgresql.org>.
Shutdown modes are:
Start types are:
%s init[db] [-D DATADIR] [-s] [-o "OPTIONS"]
%s kill SIGNALNAME PID
%s promote [-D DATADIR] [-s]
%s register [-N SERVICENAME] [-U USERNAME] [-P PASSWORD] [-D DATADIR]
[-S START-TYPE] [-w] [-t SECS] [-o "OPTIONS"]
%s reload [-D DATADIR] [-s]
%s restart [-w] [-t SECS] [-D DATADIR] [-s] [-m SHUTDOWN-MODE]
[-o "OPTIONS"]
%s start [-w] [-t SECS] [-D DATADIR] [-s] [-l FILENAME] [-o "OPTIONS"]
%s status [-D DATADIR]
%s stop [-W] [-t SECS] [-D DATADIR] [-s] [-m SHUTDOWN-MODE]
%s unregister [-N SERVICENAME]
-?, --help show this help, then exit
-D, --pgdata=DATADIR location of the database storage area
-N SERVICENAME service name with which to register PostgreSQL server
-P PASSWORD password of account to register PostgreSQL server
-S START-TYPE service start type to register PostgreSQL server
-U USERNAME user name of account to register PostgreSQL server
-V, --version output version information, then exit
-W do not wait until operation completes
-c, --core-files allow postgres to produce core files
-c, --core-files not applicable on this platform
-e SOURCE event source for logging when running as a service
-l, --log=FILENAME write (or append) server log to FILENAME
-m, --mode=MODE MODE can be "smart", "fast", or "immediate"
-o OPTIONS command line options to pass to postgres
(PostgreSQL server executable) or initdb
-p PATH-TO-POSTGRES normally not necessary
-s, --silent only print errors, no informational messages
-t, --timeout=SECS seconds to wait when using -w option
-w wait until operation completes
auto start service automatically during system startup (default)
demand start service on demand
fast quit directly, with proper shutdown
immediate quit without complete shutdown; will lead to recovery on restart
smart quit after all clients have disconnected
done
failed
stopped waiting
%s is a utility to initialize, start, stop, or control a PostgreSQL server.
%s: -S option not supported on this platform
%s: PID file "%s" does not exist
%s: WARNING: cannot create restricted tokens on this platform
%s: WARNING: could not locate all job object functions in system API
%s: another server might be running; trying to start server anyway
%s: cannot be run as root
Please log in (using, e.g., "su") as the (unprivileged) user that will
own the server process.
%s: cannot promote server; server is not in standby mode
%s: cannot promote server; single-user server is running (PID: %ld)
%s: cannot reload server; single-user server is running (PID: %ld)
%s: cannot restart server; single-user server is running (PID: %ld)
%s: cannot set core file size limit; disallowed by hard limit
%s: cannot stop server; single-user server is running (PID: %ld)
%s: could not access directory "%s": %s
%s: could not allocate SIDs: error code %lu
%s: could not create promote signal file "%s": %s
%s: could not create restricted token: error code %lu
%s: could not determine the data directory using command "%s"
%s: could not find own program executable
%s: could not find postgres program executable
%s: could not open PID file "%s": %s
%s: could not open process token: error code %lu
%s: could not open service "%s": error code %lu
%s: could not open service manager
%s: could not read file "%s"
%s: could not register service "%s": error code %lu
%s: could not remove promote signal file "%s": %s
%s: could not send promote signal (PID: %ld): %s
%s: could not send reload signal (PID: %ld): %s
%s: could not send signal %d (PID: %ld): %s
%s: could not send stop signal (PID: %ld): %s
%s: could not start server
Examine the log output.
%s: could not start server: %s
%s: could not start server: error code %lu
%s: could not start service "%s": error code %lu
%s: could not unregister service "%s": error code %lu
%s: could not wait for server because of misconfiguration
%s: could not write promote signal file "%s": %s
%s: database system initialization failed
%s: directory "%s" does not exist
%s: directory "%s" is not a database cluster directory
%s: invalid data in PID file "%s"
%s: missing arguments for kill mode
%s: no database directory specified and environment variable PGDATA unset
%s: no operation specified
%s: no server running
%s: old server process (PID: %ld) seems to be gone
%s: option file "%s" must have exactly one line
%s: server does not shut down
%s: server is running (PID: %ld)
%s: service "%s" already registered
%s: service "%s" not registered
%s: single-user server is running (PID: %ld)
%s: the PID file "%s" is empty
%s: too many command-line arguments (first is "%s")
%s: unrecognized operation mode "%s"
%s: unrecognized shutdown mode "%s"
%s: unrecognized signal name "%s"
%s: unrecognized start type "%s"
(The default is to wait for shutdown, but not for start or restart.)
HINT: The "-m fast" option immediately disconnects sessions rather than
waiting for session-initiated disconnection.
If the -D option is omitted, the environment variable PGDATA is used.
Is server running?
Please terminate the single-user server and try again.
Server started and accepting connections
The program "%s" is needed by %s but was not found in the
same directory as "%s".
Check your installation.
The program "%s" was found by "%s"
but was not the same version as %s.
Check your installation.
Timed out waiting for server startup
Try "%s --help" for more information.
Usage:
WARNING: online backup mode is active
Shutdown will not complete until pg_stop_backup() is called.
Waiting for server startup...
cannot duplicate null pointer (internal error)
child process exited with exit code %d child process exited with unrecognized status %d child process was terminated by exception 0x%X child process was terminated by signal %d: %s command not executable command not found could not change directory to "%s": %s could not find a "%s" to execute could not get current working directory: %s
could not identify current directory: %s could not read binary "%s" could not read symbolic link "%s" invalid binary "%s" out of memory
pclose failed: %s server is still starting up
server promoting
server shutting down
server signaled
server started
server starting
server stopped
starting server anyway
waiting for server to shut down... waiting for server to start... Project-Id-Version: PostgreSQL 9.6
Report-Msgid-Bugs-To: pgsql-bugs@postgresql.org
POT-Creation-Date: 2021-11-07 09:51+0000
PO-Revision-Date: 2021-11-07 06:46+0100
Last-Translator: Dennis Björklund <db@zigo.dhs.org>
Language-Team: Swedish <pgsql-translators@postgresql.org>
Language: sv
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Plural-Forms: nplurals=2; plural=n != 1;
%s: växeln -w kan inte nyttja uttag (socket) med relativ sökväg
%s: växeln -w stöds inte av server i version före 9.1
Tillåtna signalnamn för kommando "kill":
Gemensamma flaggor:
Flaggor för registrering och avregistrering:
Flaggor för start eller omstart:
Flaggor för stopp eller omstart:
Rapportera fel till <pgsql-bugs@postgresql.org>.
Stängningsmetoder är:
Startmetoder är:
%s init[db] [-D DATAKAT] [-s] [-o "FLAGGOR"]
%s kill SIGNALNAMN PID
%s promote [-D DATAKAT] [-s]
%s register [-N TJÄNSTNAMN] [-U ANVÄNDARNAMN] [-P LÖSENORD] [-D DATAKAT]
[-S STARTSÄTT] [-w] [-t SEK] [-o "FLAGGOR"]
%s reload [-D DATAKAT] [-s]
%s restart [-w] [-t SEK] [-D DATAKAT] [-s] [-m STÄNGNINGSMETOD]
[-o "FLAGGOR"]
%s start [-w] [-t SEK] [-D DATAKAT] [-s] [-l FILNAMN] [-o "FLAGGOR"]
%s status [-D DATAKAT]
%s stop [-W] [-t SEK] [-D DATAKAT] [-s] [-m STÄNGNINGSMETOD]
%s unregister [-N TJÄNSTNAMN]
-?, --help visa den här hjälpen, avsluta sedan
-D, --pgdata=DATAKAT plats för databasens lagringsarea
-N TJÄNSTENAMN tjänstenamn att registrera PostgreSQL-servern med
-P LÖSENORD lösenord för konto vid registrering av PostgreSQL-servern
-S STARTSÄTT sätt att registrera PostgreSQL-servern vid tjänstestart
-U NAMN användarnamn för konto vid registrering av PostgreSQL-servern
-V, --version visa versionsinformation, avsluta sedan
-W vänta inte på att operationen slutförs
-c, --core-files tillåt postgres att skapa core-filer
-c, --core-files inte giltig för denna plattform
-e KÄLLA händelsekälla för loggning när vi kör som en tjänst
-l, --log=FILNAMN skriv, eller tillfoga, server-loggen till FILNAMN
-m, --mode=METOD METOD kan vara "smart", "fast" eller "immediate"
-o FLAGGOR kommandoradsflaggor som skickas vidare till postgres
(PostgreSQL-serverns körbara fil) eller till initdb
-p SÖKVÄG-TILL-POSTGRES
behövs normalt inte
-s, --silent skriv bara ut fel, inga informationsmeddelanden
-t, --timeout=SEK antal sekunder att vänta när växeln -w används
-w vänta på att operationen slutförs
auto starta tjänsten automatiskt vid systemstart (förval)
demand starta tjänsten vid behov
fast stäng omedelbart, med en kontrollerad nedstängning
immediate stäng utan kontroller; kommer leda till återställning vid omstart
smart stäng när alla klienter har avslutat
klar
misslyckades
avslutade väntan
%s är ett verktyg för att initiera, starta, stanna och att styra
PostgreSQL-tjänsten.
%s: flaggan -S stöds inte på denna plattform.
%s: PID-filen "%s" finns inte
%s: VARNING: "Restricted Token" stöds inte av plattformen.
%s: VARNING: kunde inte hitta alla jobb-funktioner system-API:et.
%s: en annan server verkar köra; försöker starta servern ändå.
%s: kan inte köras som root
Logga in (t.ex. med "su") som den (opriviligerade) användare
vilken skall äga serverprocessen.
%s: kan inte befordra servern; servern är inte i beredskapsläge.
%s: kan inte befordra servern; en-användar-server kör (PID: %ld)
%s: kan inte ladda om servern; en-användar-server kör (PID: %ld)
%s: kan inte starta om servern. En-användar-server kör (PID: %ld).
%s: kan inte sätta storleksgränsning på core-fil; tillåts inte av hård gräns
%s: Kan inte stanna servern. En-användar-server i drift (PID: %ld).
%s: kunde inte komma åt katalogen "%s": %s
%s: kunde inte tilldela SID: felkod %lu
%s: kunde inte skapa befordringssignalfil "%s": %s
%s: kunde inte skapa restriktivt styrmärke (token): felkod %lu
%s: kunde inte bestämma databaskatalogen från kommandot "%s"
%s: kunde inte hitta det egna programmets körbara fil
%s: kunde inte hitta körbar postgres.
%s: kunde inte öppna PID-fil "%s": %s
%s: kunde inte öppna process-token: felkod %lu
%s: kunde inte öppna tjänsten "%s": felkod %lu
%s: kunde inte öppna tjänstehanteraren
%s: kunde inte läsa filen "%s"
%s: kunde inte registrera tjänsten "%s": felkod %lu
%s: kunde inte ta bort befordringssignalfil "%s": %s
%s: kunde inte skicka befordringssignal (PID: %ld): %s
%s: kunde inte skicka signalen "reload" (PID: %ld): %s
%s: kunde inte skicka signal %d (PID: %ld): %s
%s: kunde inte skicka stopp-signal (PID: %ld): %s
%s: kunde inte starta servern
Undersök logg-utskriften.
%s: kunde inte starta servern: %s
%s: kunde inte starta servern: felkod %lu
%s: kunde inte starta tjänsten "%s": felkod %lu
%s: kunde inte avregistrera tjänsten "%s": felkod %lu
%s: kunde inte invänta server på grund av felinställning
%s: kunde inte skriva befordringssignalfil "%s": %s
%s: skapande av databaskluster misslyckades
%s: katalogen "%s" existerar inte
%s: katalogen "%s" innehåller inte något databaskluster.
%s: ogiltig data i PID-fil "%s"
%s: saknar argument för "kill"-kommando.
%s: ingen databaskatalog angiven och omgivningsvariabeln PGDATA är inte satt
%s: ingen operation angiven
%s: ingen server kör
%s: gamla serverprocessen (PID: %ld) verkar vara borta
%s: inställningsfilen "%s" måste bestå av en enda rad.
%s: servern stänger inte ner
%s: servern kör (PID: %ld)
%s: tjänsten "%s" är redan registrerad
%s: tjänsten "%s" är inte registrerad
%s: en-användar-server kör. (PID: %ld)
%s: PID-filen "%s" är tom
%s: för många kommandoradsargument (första är "%s")
%s: okänd operationsmetod "%s"
%s: ogiltig stängningsmetod "%s"
%s: ogiltigt signalnamn "%s"
%s: ogiltigt startvillkor "%s"
Standard är att vänta på nedstängning, men inte att vänta på start
eller omstart.
TIPS: Flaggan "-m fast" avslutar sessioner omedelbart, i stället för att
vänta på deras självvalda avslut.
Om flaggan -D inte har angivits så används omgivningsvariabeln PGDATA.
Kör servern?
Var vänlig att stanna en-användar-servern och försök sedan igen.
Server startad och accepterar nu anslutningar
Programmet "%s" behövs av %s men hittades inte i samma
katalog som "%s".
Kontrollera din installation.
Programmet "%s" hittades av "%s"
men är inte av samma version som %s.
Kontrollera din installation.
Tidsfristen ute vid väntan på serverstart
Försök med "%s --help" för mer information.
Användning:
VARNING: Läget för backup under drift är i gång.
Nedstängning är inte fullständig förrän pg_stop_backup() har anropats.
Väntar på serverstart...
kan inte duplicera null-pekare (internt fel)
barnprocess avslutade med kod %d barnprocess avslutade med okänd statuskod %d barnprocess terminerades med avbrott 0x%X barnprocess terminerades av signal %d: %s kommandot är inte körbart kommandot kan ej hittas kunde inte byta katalog till "%s": %s kunde inte hitta en "%s" att köra kunde inte fastställa nuvarande arbetskatalog: %s
kunde inte identifiera aktuell katalog: %s kunde inte läsa binär "%s" kunde inte läsa symbolisk länk "%s" ogiltig binär "%s" slut på minne
pclose misslyckades: %s Servern är fortfarande i startläge.
servern befordras
servern stänger ner
servern är signalerad
servern startad
servern startar
servern är stoppad
startar servern ändå
väntar på att servern skall stänga ner... väntar på att servern skall starta... locale/sv/LC_MESSAGES/ecpg-9.6.mo 0000644 00000033224 14751153420 0012013 0 ustar 00 �� { � � � h
~ i
- �
0 + G g s � 4 � 7 0 s h . � G
4 S
) �
w �
4 * _ @ r = � , � ! @ , ^ 1 � * � - � 1 ' H & p + � " � # �
) = < z � & � < � ! & - 0 + ^ " � � , � � * 3 " ^ ' � � � ! � � ! 5 J 3 k / � ' � ) � * ! 5 L I � , � / � * ) T T ' � � � 1 - K , y , � 5 � ) % ? O 8 � � � _ 0 y 5 � � A � L 7 + �
� 6 � ' � # A ( N 4 w ) � � / � # < $ ] � " � , � � ' " J i $ � D � + � ? 0 Z � 8 � � & F � g � ! 2 �! / �! 2 �! l 1" " �" 4 �" 9 �" t 0# 1 �# K �# 5 #$ + Y$ { �$ 7 % 9% @ Q% < �% 5 �% # & )& 3 G& . {& ' �& * �& . �& $ ,' # Q' ( u' & �' " �' �' , �' F ( b( l( / �( C �( & ) ') 0 1) , b) " �) �) 0 �) # �) #* & >* % e* + �* �* �* * �* + ' 6+ ^+ # q+ 7 �+ 0 �+ 2 �+ - 1, 0 _, 2 �, ? �, ) - 4 -- , b- g �- ) �- !. =. X. h. �. / �. . �. . �. 5 '/ ]/ ' v/ < �/ 5 �/ � 0 �0 3 �0 < �0 *1 A @1 C �1 + �1 �1 1 2 * 32 $ ^2 �2 % �2 9 �2 , �2 3 0 :3 k3 �3 �3 �3 �3 ( �3 4 *4 ' J4 ! r4 �4 ! �4 = �4 ) 5 6 =5 3 t5 �5 = �5 6 ! '6 ' I6 " q6 j 4 f g ? ^ l x
T ( 9 u 8 _ L t I d \ % ) < i = ' Q N & : M v , 7 B . z ; S n # > P " H r ] [ ! * s Z 6 G A O - X 2 q 3 W w 1 k + U e Y o K p 0 a J 5 { h c m E C @ V F D y R / ` $
b
If no output file is specified, the name is formed by adding .c to the
input file name, after stripping off .pgc if present.
Report bugs to <pgsql-bugs@postgresql.org>.
--regression run in regression testing mode
-?, --help show this help, then exit
-C MODE set compatibility mode; MODE can be one of
"INFORMIX", "INFORMIX_SE"
-D SYMBOL define SYMBOL
-I DIRECTORY search DIRECTORY for include files
-V, --version output version information, then exit
-c automatically generate C code from embedded SQL code;
this affects EXEC SQL TYPE
-d generate parser debug output
-h parse a header file, this option includes option "-c"
-i parse system include files as well
-o OUTFILE write result to OUTFILE
-r OPTION specify run-time behavior; OPTION can be:
"no_indicator", "prepare", "questionmarks"
-t turn on autocommit of transactions
%s at or near "%s" %s is the PostgreSQL embedded SQL preprocessor for C programs.
%s, the PostgreSQL embedded C preprocessor, version %d.%d.%d
%s: could not locate my own executable path
%s: could not open file "%s": %s
%s: no input files specified
%s: parser debug support (-d) not available
AT option not allowed in CLOSE DATABASE statement AT option not allowed in CONNECT statement AT option not allowed in DISCONNECT statement AT option not allowed in SET CONNECTION statement AT option not allowed in TYPE statement AT option not allowed in VAR statement AT option not allowed in WHENEVER statement COPY FROM STDIN is not implemented CREATE TABLE AS cannot specify INTO ERROR: EXEC SQL INCLUDE ... search starts here:
Error: include path "%s/%s" is too long on line %d, skipping
Options:
SHOW ALL is not implemented Try "%s --help" for more information.
Unix-domain sockets only work on "localhost" but not on "%s" Usage:
%s [OPTION]... FILE...
WARNING: arrays of indicators are not allowed on input could not open include file "%s" on line %d could not remove output file "%s"
cursor "%s" does not exist cursor "%s" has been declared but not opened cursor "%s" is already defined descriptor "%s" does not exist descriptor header item "%d" does not exist descriptor item "%s" cannot be set descriptor item "%s" is not implemented end of search list
expected "://", found "%s" expected "@" or "://", found "%s" expected "@", found "%s" expected "postgresql", found "%s" incomplete statement incorrectly formed variable "%s" indicator for array/pointer has to be array/pointer indicator for simple data type has to be simple indicator for struct has to be a struct indicator struct "%s" has too few members indicator struct "%s" has too many members indicator variable "%s" is hidden by a local variable indicator variable "%s" is hidden by a local variable of a different type indicator variable must have an integer type initializer not allowed in EXEC SQL VAR command initializer not allowed in type definition internal error: unreachable state; please report this to <pgsql-bugs@postgresql.org> interval specification not allowed here invalid bit string literal invalid connection type: %s invalid data type key_member is always 0 missing "EXEC SQL ENDIF;" missing identifier in EXEC SQL DEFINE command missing identifier in EXEC SQL IFDEF command missing identifier in EXEC SQL UNDEF command missing matching "EXEC SQL IFDEF" / "EXEC SQL IFNDEF" more than one EXEC SQL ELSE multidimensional arrays are not supported multidimensional arrays for simple data types are not supported multidimensional arrays for structures are not supported multilevel pointers (more than 2 levels) are not supported; found %d level multilevel pointers (more than 2 levels) are not supported; found %d levels nested /* ... */ comments nested arrays are not supported (except strings) no longer supported LIMIT #,# syntax passed to server nullable is always 1 only data types numeric and decimal have precision/scale argument only protocols "tcp" and "unix" and database type "postgresql" are supported operator not allowed in variable definition out of memory pointer to pointer is not supported for this data type pointers to varchar are not implemented subquery in FROM must have an alias syntax error syntax error in EXEC SQL INCLUDE command too many levels in nested structure/union definition too many nested EXEC SQL IFDEF conditions type "%s" is already defined type name "string" is reserved in Informix mode unmatched EXEC SQL ENDIF unrecognized data type name "%s" unrecognized descriptor item code %d unrecognized token "%s" unrecognized variable type code %d unsupported feature will be passed to server unterminated /* comment unterminated bit string literal unterminated hexadecimal string literal unterminated quoted identifier unterminated quoted string using unsupported DESCRIBE statement using variable "%s" in different declare statements is not supported variable "%s" is hidden by a local variable variable "%s" is hidden by a local variable of a different type variable "%s" is neither a structure nor a union variable "%s" is not a pointer variable "%s" is not a pointer to a structure or a union variable "%s" is not an array variable "%s" is not declared variable "%s" must have a numeric type zero-length delimited identifier Project-Id-Version: PostgreSQL 9.6
Report-Msgid-Bugs-To: pgsql-bugs@postgresql.org
POT-Creation-Date: 2021-11-07 09:48+0000
PO-Revision-Date: 2021-11-06 21:58+0100
Last-Translator: Dennis Björklund <db@zigo.dhs.org>
Language-Team: Swedish <pgsql-translators@postgresql.org>
Language: sv
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Plural-Forms: nplurals=2; plural=n != 1;
Om ingen utdatafil anges så skapas namnet genom att lägga till .c till
indatafilnamnet, detta efter att .pgc strippats bort om det var med.
Rapportera fel till <pgsql-bugs@postgresql.org>.
--regression kör i regressions-test-läge
-?, --help visa denna hjälp, avsluta sedan
-C LÄGE sätt kompabilitetsläge; LÄGE kan vara en av
"INFORMIX", "INFORMIX_SE"
-D SYMBOL definiera SYMBOL
-I KATALOG sök i KATALOG efter include-filer
-V, --version visa versionsinformation, avsluta sedan
-c generera automatiskt C-kod från inbäddad SQL-kod;
detta påverkar EXEC SQL TYPE
-d generera parser-debug-utmatning
-h parsa en header-fil, denna flagga inkluderar flaggan "-c"
-i parsa system-include-filer dessutom
-o UTFIL skriv resultat till UTFIL
-r FLAGGA ange runtime-beteende; FLAGGA kan vara en av:
"no_indicator", "prepare", "questionmarks"
-t slå på auto-commit av transaktioner
%s vid eller nära "%s" %s är PostgreSQLs inbäddade SQL-preprocessor för C-program.
%s, PostgreSQLs inbäddade C-preprocessor, version %d.%d.%d
%s: kunde inte hitta min egna körbara fils sökväg
%s: kunde inte öppna fil "%s": %s
%s: inga indatafiler angivna
%s: parser-debug-stöd (-d) är inte tillgängligt
AT-flaggan tillåts inte i CLOSE DATABASE-sats AT-flaggan tillåts inte i CONNECT-sats AT-flaggan tillåts inte i DISCONNECT-sats AT-flaggan tillåts inte i SET CONNECTION-sats AT-flaggan tillåts inte i TYPE-sats AT-flaggan tillåts inte i VAR-sats AT-flaggan tillåts inte i WHENEVER-sats COPY FROM STDIN är inte implementerad CREATE TABLE AS kan inte ange INTO FEL: EXEC SQL INCLUDE ... sökning startar här:
Fel: include-sökväg "%s/%s" är för lång på rad %d, hoppar över
Flaggor:
SHOW ALL är inte implementerad Försök med "%s --help" för mer information.
Unix-domän-socket fungerart bara på "localhost" men inte på "%s" Användning:
%s [FLAGGA]... FIL...
VARNING: array:er av indikatorer tillåts inte vid indata kunde inte öppna inkludefil "%s" på rad %d kunde inte ta bort utdatafil "%s"
markör "%s" existerar inte markören "%s" har deklarerats men inte öppnats markören "%s" är redan definierad deskriptor "%s" finns inte deskriptor-header-post "%d" finns inte deskriptor-post "%s" kan inte sättas deskriptor-post "%s" är inte implementerad slut på söklista
förväntade "://", hittade "%s" förväntade "@" eller "://", hittade "%s" förväntade "@", hittade "%s" förväntade "postgresql", hittade "%s" ofullständig sats inkorrekt formatterad variabel "%s" indikator för array/pekare måste vara en array/pekare indikator för enkla datatyper måste vara enkel indikator för en struktur måste vara en struktur indikatorstruktur "%s" har för få medlemmar indikatorstruktur "%s" har för många medlemmar indikatorvariabel "%s" döljs av en lokal variabel indikatorvariabel "%s" döljs av en lokal variabel av annan typ indikatorvariabel måste ha en heltalstyp initialiserare tillåts inte i EXEC SQL VAR-kommando initialiserare tillåts inte i typdefinition internt fel: state som ej skall kunna nås; vänligen rapportera detta till <pgsql-bugs@postgresql.org> intervallspecifikation tillåts inte här ogiltig bit-sträng-literal ogiltig anslutningstyp: %s ogiltig datatyp key_member är alltid 0 saknar "EXEC SQL ENDIF;" saknar identifierare i EXEC SQL DEFINE-kommando saknar identifierare i EXEC SQL IFDEF-kommando saknar identifierare i EXEC SQL UNDEF-kommando saknar matchande "EXEC SQL IFDEF" / "EXEC SQL IFNDEF" mer än en EXEC SQL ELSE multidimensionella array:er stöds inte multidimensionella array:er för enkla datatyper stöds inte multidimensionella array:er av strukturer stöds inte multinivåpekare (mer än 2 nivåer) stöds inte; hittade %d nivå multinivåpekare (mer än 2 nivåer) stöds inte; hittade %d nivåer nästlade /* ... */-kommentarer nästlade array:er stöds inte (förutom strängar) ej längre stödd syntax LIMIT #,# har skickats till servern nullable är alltid 1 bara datatyperna numeric och decimal har precision/skala-argument bara protokoll "tcp" och "unix" samt databastyp "postgresql" stöds operator tillåts inte i variabeldefinition slut på minne pekare till pekare stöds inte för denna datatyp pekare till varchar är inte implementerat subfråga i FROM måste ha ett alias syntaxfel syntaxfel i EXEC SQL INCLUDE-kommando för många nästlade nivåer i struktur/union-definition för många nästlade EXEC SQL IFDEF-villkor typen "%s" är redan definierad typnamn "string" är reserverat i Informix-läge ej matchad EXEC SQL ENDIF okänt datatypsnamn "%s" okänd deskriptor-post-kod %d okänd symbol "%s" okänd variabeltypkod %d ej stödd funktion skickass till servern ej avslutad /*-kommentar ej avslutad bitsträngslitteral ej avslutad hexadecimal stränglitteral ej avslutad citerad identifierare icketerminerad citerad sträng använder ej stödd DESCRIBE-sats använda variabel "%s" i olika deklarationssatser stöds inte variabel "%s" döljs av en lokal variabel variabel "%s" döljs av en lokal variabel av annan typ variabel "%s" är varken en struktur eller en union variabel "%s" är inte en pekare variabel "%s" är inte en pekare till en struktur eller union variabel "%s" är inte en array variabel "%s" är inte deklarerad variabel "%s" måste ha en numerisk typ noll-längds avdelad identifierare locale/sv/LC_MESSAGES/pgscripts-9.6.mo 0000644 00000062552 14751153420 0013121 0 ustar 00 �� � � � @ K A �
� > � > � = , - j � � C 0 A t � � # � ( I I f E � � > v ; � = � : / < j 9 � 6 � 5 C N C � 9 � 4 E E = � . � ; � E 4 : z ? � A � < 7 9 t 7 � 4 � L J h 3 � H � E 0 B v A � 5 � 2 1 N d 7 � 2 � 2 J Q : � 5 � G
0 U < � 0 � ) � M J l G � 4 � C 4! H x! E �! D " = L" v �" < # � ># Q �# I $ @ ^$ 5 �$ 4 �$ 1
% 0 <% ; m% 5 �% ' �% 6 & 3 >& 9 r& @ �& ; �& ; )' ` e' 8 �' 2 �' 9 2( 6 l( > �( �( / �( < ) # [) # ) ? �) 8 �) % * # B* f* 3 �* & �* �* E �* 6 .+ E e+ F �+ K �+ 7 >, K v, 7 �, J �, 6 E- < |- D �- 5 �- 4. * R. 8 }. 6 �. ( �. 4 / $ K/ # p/ �/ �/ - �/ 8 0 4 <0 $ q0 �0 , �0 , �0 ( 1 / 91 ; i1 9 �1 ! �1 2 \ 2 s2 �2 * �2 8 �2 9 3 , B3 8 o3 # �3 4 �3 . 4 04 ) M4 7 w4 �4
�4 �4 C �4 A +5 ! m5 + �5 �5 �5 �5 6 . #6 3 R6 2 �6 �6 �6 �6
�6 �6 7 )7 ' >7 " f7 2 �7 7 �7 �7 & �7 $8 ,8 / C8 + s8 * �8 �8 �8 �8 �8 �8 �8 9 9 ( +9 T9 V9 � Z9 S ; T;
o; < z; < �; ; �; 2 0< � c< D = B K= �= �= ! �= �= ( �= > A <> C ~> � �> ? L? < �? @ �? :
@ C E@ @ �@ = �@ < A G EA E �A < �A ? B G PB < �B 5 �B : C J FC B �C D �C H D ? bD 7 �D > �D ; E O UE M �E : �E J .F G yF D �F C G > JG ; �G W �G : H 3 XH 7 �H Q �H ; I 7 RI I �I 0 �I > J 4 DJ + yJ J �J G �J D 8K 8 }K F �K I �K F GL E �L < �L | M 9 �M � �M ^ JN > �N 8 �N ; !O 4 ]O 1 �O 0 �O C �O = 9P ) wP 8 �P ; �P A Q B XQ < �Q @ �Q [ R : uR 4 �R 9 �R 6 S A VS �S 2 �S < �S " T " 7T < ZT = �T ( �T $ �T #U 2 DU + wU �U C �U 7 �U I &V G pV G �V 7 W L 8W 9 �W H �W 7 X 6 @X I wX 9 �X �X . Y < IY = �Y * �Y 7 �Y ( 'Z * PZ & {Z + �Z 0 �Z : �Z 7 :[ ' r[ * �[ $ �[ - �[ % \ 0 >\ 5 o\ 3 �\ ! �\ �\ [ ] s] # �] 3 �] @ �] B !^ 6 d^ A �^ / �^ 8
_ = F_ �_ 0 �_ > �_ ` '` " 6` V Y` T �` & a . ,a [a 2 na 1 �a ' �a + �a , 'b , Tb �b �b ! �b �b # �b ' �b
c + c - Ec / sc 5 �c �c / �c
d (d - Ad 2 od ' �d �d �d �d �d �d �d e e 3 1e ee ge � Z 9 � � t � � � I S � w & % � � � � G � � - . � � X � { � " � 7 � o � � < � � � L � 4 / K i u � J � ~ B m � ( � � * �
n f H p � # D g @ ' > � � U � v � x [ � 3
N � � k ! � 8 , � Y F ; � � z � � � T � � 6 r M � + a 2 W � � $ ] _ � � } = s � j � � ? � ` � c | � l \ V � � � � � E ) : q � � Q C b 1 0 h A y � d R � ^ O � � � � � � � 5 � � � e P
By default, a database with the same name as the current user is created.
Connection options:
Options:
Read the description of the SQL command CLUSTER for details.
Read the description of the SQL command REINDEX for details.
Read the description of the SQL command VACUUM for details.
Report bugs to <pgsql-bugs@postgresql.org>.
--analyze-in-stages only update optimizer statistics, in multiple
stages for faster results; no vacuum
--lc-collate=LOCALE LC_COLLATE setting for the database
--lc-ctype=LOCALE LC_CTYPE setting for the database
%s [OPTION]...
%s [OPTION]... DBNAME
%s [OPTION]... LANGNAME [DBNAME]
%s [OPTION]... [DBNAME]
%s [OPTION]... [DBNAME] [DESCRIPTION]
%s [OPTION]... [ROLENAME]
--if-exists don't report error if database doesn't exist
--if-exists don't report error if user doesn't exist
--interactive prompt for missing role name and attributes rather
than using defaults
--maintenance-db=DBNAME alternate maintenance database
--maintenance-db=DBNAME alternate maintenance database
--no-replication role cannot initiate replication
--replication role can initiate replication
-?, --help show this help, then exit
-?, --help show this help, then exit
-?, --help show this help, then exit
-?, --help show this help, then exit
-D, --no-createdb role cannot create databases (default)
-D, --tablespace=TABLESPACE default tablespace for the database
-E, --encoding=ENCODING encoding for the database
-E, --encrypted encrypt stored password
-F, --freeze freeze row transaction information
-I, --no-inherit role does not inherit privileges
-L, --no-login role cannot login
-N, --unencrypted do not encrypt stored password
-O, --owner=OWNER database user to own the new database
-P, --pwprompt assign a password to new role
-R, --no-createrole role cannot create roles (default)
-S, --no-superuser role will not be superuser (default)
-S, --schema=SCHEMA reindex specific schema(s) only
-T, --template=TEMPLATE template database to copy
-U, --username=USERNAME user name to connect as
-U, --username=USERNAME user name to connect as
-U, --username=USERNAME user name to connect as (not the one to create)
-U, --username=USERNAME user name to connect as (not the one to drop)
-U, --username=USERNAME user name to connect as
-V, --version output version information, then exit
-V, --version output version information, then exit
-V, --version output version information, then exit
-V, --version output version information, then exit
-W, --password force password prompt
-W, --password force password prompt
-Z, --analyze-only only update optimizer statistics; no vacuum
-a, --all vacuum all databases
-a, --all cluster all databases
-a, --all reindex all databases
-c, --connection-limit=N connection limit for role (default: no limit)
-d, --createdb role can create new databases
-d, --dbname=DBNAME database to vacuum
-d, --dbname=DBNAME database from which to remove the language
-d, --dbname=DBNAME database to cluster
-d, --dbname=DBNAME database to install language in
-d, --dbname=DBNAME database to reindex
-d, --dbname=DBNAME database name
-e, --echo show the commands being sent to the server
-e, --echo show the commands being sent to the server
-e, --echo show the commands being sent to the server
-f, --full do full vacuuming
-g, --role=ROLE new role will be a member of this role
-h, --host=HOSTNAME database server host or socket directory
-h, --host=HOSTNAME database server host or socket directory
-h, --host=HOSTNAME database server host or socket directory
-i, --index=INDEX recreate specific index(es) only
-i, --inherit role inherits privileges of roles it is a
member of (default)
-i, --interactive prompt before deleting anything
-i, --interactive prompt before deleting anything, and prompt for
role name if not specified
-j, --jobs=NUM use this many concurrent connections to vacuum
-l, --list show a list of currently installed languages
-l, --locale=LOCALE locale settings for the database
-l, --login role can login (default)
-p, --port=PORT database server port
-p, --port=PORT database server port
-p, --port=PORT database server port
-q, --quiet don't write any messages
-q, --quiet don't write any messages
-q, --quiet run quietly
-r, --createrole role can create new roles
-s, --superuser role will be superuser
-s, --system reindex system catalogs only
-t, --table='TABLE[(COLUMNS)]' vacuum specific table(s) only
-t, --table=TABLE cluster specific table(s) only
-t, --table=TABLE reindex specific table(s) only
-t, --timeout=SECS seconds to wait when attempting connection, 0 disables (default: %s)
-v, --verbose write a lot of output
-v, --verbose write a lot of output
-w, --no-password never prompt for password
-w, --no-password never prompt for password
-z, --analyze update optimizer statistics
%s (%s/%s) %s cleans and analyzes a PostgreSQL database.
%s clusters all previously clustered tables in a database.
%s creates a PostgreSQL database.
%s creates a new PostgreSQL role.
%s installs a procedural language into a PostgreSQL database.
%s issues a connection check to a PostgreSQL database.
%s reindexes a PostgreSQL database.
%s removes a PostgreSQL database.
%s removes a PostgreSQL role.
%s removes a procedural language from a database.
%s: "%s" is not a valid encoding name
%s: %s %s: cannot cluster all databases and a specific one at the same time
%s: cannot cluster specific table(s) in all databases
%s: cannot reindex all databases and a specific one at the same time
%s: cannot reindex all databases and system catalogs at the same time
%s: cannot reindex specific index(es) and system catalogs at the same time
%s: cannot reindex specific index(es) in all databases
%s: cannot reindex specific schema(s) and system catalogs at the same time
%s: cannot reindex specific schema(s) in all databases
%s: cannot reindex specific table(s) and system catalogs at the same time
%s: cannot reindex specific table(s) in all databases
%s: cannot use the "%s" option when performing only analyze
%s: cannot vacuum all databases and a specific one at the same time
%s: cannot vacuum specific table(s) in all databases
%s: clustering database "%s"
%s: clustering of database "%s" failed: %s %s: clustering of table "%s" in database "%s" failed: %s %s: comment creation failed (database was created): %s %s: could not connect to database %s: %s %s: could not connect to database %s: out of memory
%s: could not fetch default options
%s: creation of new role failed: %s %s: database creation failed: %s %s: database removal failed: %s %s: invalid value for --connection-limit: %s
%s: language "%s" is already installed in database "%s"
%s: language "%s" is not installed in database "%s"
%s: language installation failed: %s %s: language removal failed: %s %s: missing required argument database name
%s: missing required argument language name
%s: missing required argument role name
%s: number of parallel jobs must be at least 1
%s: only one of --locale and --lc-collate can be specified
%s: only one of --locale and --lc-ctype can be specified
%s: processing database "%s": %s
%s: query failed: %s %s: query returned %d row instead of one: %s
%s: query returned %d rows instead of one: %s
%s: query was: %s
%s: reindexing database "%s"
%s: reindexing of database "%s" failed: %s %s: reindexing of index "%s" in database "%s" failed: %s %s: reindexing of schema "%s" in database "%s" failed: %s %s: reindexing of system catalogs failed: %s %s: reindexing of table "%s" in database "%s" failed: %s %s: removal of role "%s" failed: %s %s: too many command-line arguments (first is "%s")
%s: too many jobs for this platform -- try %d
%s: vacuuming database "%s"
%s: vacuuming of database "%s" failed: %s %s: vacuuming of table "%s" in database "%s" failed: %s (%lu row) (%lu rows) Are you sure? Cancel request sent
Cannot add cell to table content: total cell count of %d exceeded.
Cannot add header to table content: column count of %d exceeded.
Could not send cancel request: %s Database "%s" will be permanently removed.
Enter it again: Enter name of role to add: Enter name of role to drop: Enter password for new role: Generating default (full) optimizer statistics Generating medium optimizer statistics (10 targets) Generating minimal optimizer statistics (1 target) Interrupted
Name Password encryption failed.
Password: Passwords didn't match.
Please answer "%s" or "%s".
Procedural Languages Role "%s" will be permanently removed.
Shall the new role be a superuser? Shall the new role be allowed to create databases? Shall the new role be allowed to create more new roles? Trusted? Try "%s --help" for more information.
Usage:
accepting connections
cannot duplicate null pointer (internal error)
could not look up effective user ID %ld: %s invalid output format (internal error): %d n no no attempt
no response
out of memory
rejecting connections
unknown
user does not exist user name lookup failure: error code %lu y yes Project-Id-Version: PostgreSQL 9.6
Report-Msgid-Bugs-To: pgsql-bugs@postgresql.org
POT-Creation-Date: 2021-11-07 09:52+0000
PO-Revision-Date: 2021-11-07 15:07+0100
Last-Translator: Dennis Björklund <db@zigo.dhs.org>
Language-Team: Swedish <pgsql-translators@postgresql.org>
Language: sv
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Plural-Forms: nplurals=2; plural=(n != 1);
Som standard skapas en databas med samma namn som den nuvarande användares namn.
Flaggor för anslutning:
Flaggor:
Läs beskrivningen av SQL-kommandot CLUSTER för detaljer.
Läs beskrivningen av SQL-kommandot REINDEX för detaljer.
Läs beskrivningen av SQL-kommandot VACUUM för detaljer.
Rapportera fel till <pgsql-bugs@postgresql.org>.
--analyze-in-stages uppdatera bara optimeringsstatistik, men i
flera steg för snabbare resultat; ingen städning
--lc-collate=LOKAL värde på LC_COLLATE för databasen
--lc-ctype=LOKAL värde på LC_CTYPE för databasen
%s [FLAGGA]...
%s [FLAGGA]... DBNAMN
%s [FLAGGA]... SPRÅK [DBNAMN]
%s [FLAGGA]... [DBNAMN]
%s [FLAGGA]... [DBNAMN] [BESKRIVNING]
%s [FLAGGA]... [ROLLNAMN]
--if-exists felrapportera ej om databasen saknas
--if-exists felrapportera ej om användaren saknas
--interactive fråga efter rollnamn och egenskaper, snarare än
att falla tillbaka på förval
--maintenance-db=DBNAMN annat val av underhållsdatabas
--maintenance-db=DBNAMN annat val av underhållsdatabas
--no-replication rollen får inte starta replikering
--replication rollen kan starta replikering
-?, --help visa denna hjälp, avsluta sedan
-?, --help visa denna hjälp, avsluta sedan
-?, --help visa denna hjälp, avsluta sedan
-?, --help visa denna hjälp, avsluta sedan
-D, --no-createdb rollen kan inte skapa databaser (standard)
-D, --tablespace=TABELLRYMD förvalt tabellutrymme för databasen
-E, --encoding=KODNING teckenkodning för databasen
-E, --encrypted lösenordet skall sparas krypterat
-F, --freeze frys information om radtransaktioner
-I, --no-inherit rollen ärver inga rättigheter
-L, --no-login rollen kan inte logga in
-N, --unencrypted lösenordet sparas okrypterat
-O, --owner=ÄGARE databasanvändare som äger nya databasen
-P, --pwprompt tilldela den nya rollen ett lösenord
-R, --no-createrole rollen kan inte skapa roller (standard)
-S, --no-superuser rollen blir inte superanvändare (standard)
-S, --schema=SCHEMA indexera enbart om angivna scheman
-T, --template=MALL databasmall att kopiera
-U, --username=ANVÄNDARE användarnamn att ansluta som
-U, --username=ANVÄNDARE användarnamn att ansluta som
-U, --username=ANVÄNDARE användarnamn att ansluta som (ej den som skapas)
-U, --username=ANVÄNDARE användare som ansluter (inte den som tas bort)
-U, --username=ANVÄNDARE användarnamn att ansluta som
-V, --version visa versionsinformation, avsluta sedan
-V, --version visa versionsinformation, avsluta sedan
-V, --version visa versionsinformation, avsluta sedan
-V, --version visa versionsinformation, avsluta sedan
-W, --password framtvinga fråga om lösenord
-W, --password framtvinga fråga om lösenord
-Z, --analyze-only uppdatera bara optimeringsstatistik; ingen städning
-a, --all städa i alla databaser
-a, --all klustra alla databaser
-a, --all indexera om alla databaser
-c, --connection-limit=N anslutningsgräns för roll (standard: ingen gräns)
-d, --createdb rollen kan skapa nya databaser
-d, --dbname=DBNAMN databas att städa i
-d, --dbname=DBNAMN databas från vilken språket skall tas bort
-d, --dbname=DBNAME databas att klustra
-d, --dbname=DBNAMN databas där språket installeras
-d, --dbname=DBNAME databas att indexera om
-d, --dbname=DBNAMN databasens namn
-e, --echo visa kommandon som skickas till servern
-e, --echo visa kommandon som skickas till servern
-e, --echo visa kommandon som skickas till servern
-f, --full utför full städning
-g, --role=ROLL nya rollen kommer bli medlem i denna roll
-h, --host=VÄRDNAMN databasens värdnamn eller socketkatalog
-h, --host=VÄRDNAMN databasens värdnamn eller socketkatalog
-h, --host=VÄRDNAMN databasens värdnamn eller socketkatalog
-i, --index=INDEX återskapa enbart angivna index
-i, --inherit rollen ärver rättigheter från roller den
är medlem i (standard)
-i, --interactive fråga innan något tas bort
-i, --interactive fråga innan något tas bort och fråga efter
rollnamn om sådant saknas
-j, --jobs=NUM använd så här många samtida anslutningar för städning
-l, --list lista alla nu installerade språk
-l, --locale=LOKAL lokalnamn för databasen
-l, --login rollen kan logga in (standard)
-p, --port=PORT databasserverns port
-p, --port=PORT databasserverns port
-p, --port=PORT databasserverns port
-q, --quiet skriv inte ut några meddelanden
-q, --quiet skriv inte ut några meddelanden
-q, --quiet tyst körning
-r, --createrole rollen kan skapa nya roller
-s, --superuser rollen blir en superanvändare
-s, --system indexera enbart om systemkatalogerna
-t, --table='TABELL[(KOLUMNER)]' städa enbart i dessa tabeller
-t, --table=TABELL klustra enbart ingivna tabeller
-t, --table=TABELL indexera endast om angivna tabeller
-t, --timeout=SEK sekunder att vänta på anslutning; 0 stänger av (förval: %s)
-v, --verbose skriv massor med utdata
-v, --verbose skriv massor med utdata
-w, --no-password fråga ej efter lösenord
-w, --no-password fråga ej efter lösenord
-z, --analyze uppdatera optimeringsstatistik
%s (%s/%s) %s städar och analyserar en PostgreSQL-databas.
%s klustrar alla tidigare klustrade tabeller i en databas.
%s skapar en PostgreSQL-databas.
%s skapar en ny PostgreSQL-roll.
%s installerar ett procedurspråk i en PostgreSQL-databas.
%s utför en anslutningskontroll mot en PostgreSQL-databas.
%s indexerar om en PostgreSQL-databas.
%s tar bort en PostgreSQL-databas.
%s tar bort en PostgreSQL-roll.
%s tar bort ett procedurspråk från en databas.
%s: "%s" är inte en giltig teckenkodning.
%s: %s %s: kan inte klustra alla databaser och en angiven på samma gång
%s: kan inte klustra angivna tabeller i alla databaser
%s: kan inte omindexera alla databaser och samtidigt en specifik databas
%s: kan inte omindexera alla databaser samtidigt med systemkatalogerna
%s: kan inte omindexera angivna index och systemkatalogerna samtidigt.
%s: Kan inte omindexera angivet index i alla databaser
%s: kan inte omindexera angivna scheman och systemkataloger på samma gång
%s: kan inte omindexera angivna scheman i alla databaser
%s: kan inte omindexera specifik tabell och systemkatalogerna samtidigt
%s: Kan inte indexera specifik tabell i alla databaser
%s: flaggan "%s" kan inte användas vid enbart analys
%s: kan inte städa alla databaser och endast en angiven på samma gång
%s: kan inte städa en specifik tabell i alla databaser.
%s: klustring av databas "%s"
%s: klustring av databas "%s" misslyckades: %s %s: klustring av tabell "%s" i databas "%s" misslyckades: %s %s: misslyckades att skapa kommentar (databasen skapades): %s %s: kunde inte ansluta till databas %s: %s %s: kunde inte ansluta till databas %s: slut på minne
%s: kunde inte hämta förvalda värde.
%s: misslyckades med att skapa ny roll: %s %s: misslyckades att skapa databas: %s %s: borttagning av databas misslyckades: %s %s: ogiltigt värde till --connection-limit: %s
%s: Språket "%s" är redan installerat i databasen "%s".
%s: Språk "%s" är inte installerat i databasen "%s".
%s: Språkinstallation misslyckades: %s %s: Borttagning av språk misslyckades: %s %s: saknar nödvändigt databasnamn
%s: Saknar nödvändigt språknamnsargument.
%s: saknar ett nödvändigt rollnamn
%s: antalet parallella jobb måste vara minst 1
%s: endast en av --locale och --lc-collate kan anges
%s: endast en av --locale och --lc-ctype kan anges
%s: processar databasen "%s": %s
%s: fråga misslyckades: %s %s: fråga gav %d rad istället för en: %s
%s: fråga gav %d rader istället för en: %s
%s: frågan var: %s
%s: omindexering av databasen "%s"
%s: omindexering av databasen "%s" misslyckades: %s %s: omindexering av index "%s" i databasen "%s" misslyckades: %s %s: omindexering av schemat "%s" i databasen "%s" misslyckades: %s %s: omindexering av systemkatalogerna misslyckades: %s %s: omindexering av tabell "%s" i databasen "%s" misslyckades: %s %s: borttagning av rollen "%s" misslyckades: %s %s: för många kommandoradsargument (första är "%s")
%s: för många jobb för denna plattform -- försök med %d
%s: städar databasen "%s".
%s: städning av databasen "%s" misslyckades: %s %s: städning av tabell "%s" i databasen "%s" misslyckades: %s (%lu rad) (%lu rader) Är du säker? Förfrågan om avbrytning skickad
Kan inte lägga till cell till tabellinnehåll: totala cellantalet (%d) överskridet.
Kan inte lägga till rubrik till tabellinnehåll: antal kolumner (%d) överskridet.
Kunde inte skicka avbrottsbegäran: %s Databasen "%s" kommer att tas bort permanent.
Mata in det igen: Mata in namn på den roll som skall läggas till: Mata inn namnet på den roll som skall tas bort: Mata in lösenord för den nya rollen: Skapar förvald (full) optimeringsstatistik Skapar medium optimeringsstatistik (10 mål) Skapar minimal optimeringsstatistik (1 mål) Avbruten
Namn Misslyckad lösenordskryptering.
Lösenord: Lösenorden stämde inte överens.
Var vänlig att svara "%s" eller "%s".
Procedurspråk Rollen "%s" kommer att tas bort permanent.
Skall den nya rollen vara en superanvändare? Skall den nya rollen tillåtas skapa databaser? Skall den nya rollen tillåtas skapa fler nya roller? Tillförlitligt? Försök med "%s --help" för mer information.
Användning:
accepterar anslutningar
kan inte duplicera null-pekare (internt fel)
kunde inte slå upp effektivt användar-id %ld: %s ogiltigt utdataformat (internt fel): %d n nej inget försök
inget svar
slut på minne
vägrar anslutningar
okänt
användaren finns inte misslyckad sökning efter användarnamn: felkod %lu j ja locale/sv/LC_MESSAGES/pg_dump-9.6.mo 0000644 00000166237 14751153420 0012543 0 ustar 00 �� � L � | �( �( �( X �( [ 3) B �) ) �) " �) x * �* �* �* �* A �* N &+ P u+ I �+ 3 , y D, G �, C - N J- K �- v �- F \. > �. R �. B 5/ E x/ ? �/ L �/ 3 K0 6 0 Q �0 T 1 M ]1 ? �1 � �1 � y2 ? 23 9 r3 5 �3 : �3 K 4 B i4 D �4 � �4 3 r5 � �5 ? (6 D h6 x �6 6 &7 Q ]7 O �7 F �7 > F8 5 �8 > �8 E �8 A @9 O �9 H �9 B : @ ^: = �: O �: H -; ; v; , �; 4 �; E < 0 Z< = �< ; �< F = D L= C �= F �= 8 > ? U> C �> = �> 4 ? 7 L? L �? = �? @ @ J P@ < �@ L �@ , %A ( RA 5 {A E �A T �A LB 9 OB D �B G �B C 1C ? LC ' �C * �C e �C ! ED , gD 4 �D 6 �D ( E / )E YE wE $ �E * �E 2 �E B F > OF J �F P �F N *G H yG - �G �G H / H HH 4 ZH $ �H & �H * �H # I *I P II C �I A �I ( J IJ gJ �J �J = �J � �J
�K , �K � �K � SL , �L M p +M e �M & N )N ` 1N p �N 4 O X 8O _ �O E �O 1 7P 6 iP 4 �P * �P - Q D .Q . sQ + �Q + �Q ) �Q * $R > OR : �R ' �R = �R ) /S 1 YS �S @ �S 7 �S 6 T 6 VT < �T = �T 4 U 3 =U b qU 9 �U < V t KV # �V , �V 5 W GW hW �W
�W ' �W �W % �W �W / X X JX & �X 0 �X . �X - *Y XY oY �Y 3 �Y ( �Y �Y # �Y !Z & BZ K iZ & �Z �Z ! �Z ( [ ' E[ # m[ # �[ �[ / �[ \ &\ # B\ % f\ �\ , �\ $ �\ $ �\ $ ] 6 E] |] �] B �] � �] � �^ _ $ >_ < c_ 3 �_ * �_ ' �_ + '` ( S` ( |` # �` - �` � �` + �a , �a ! b & Bb ' ib # �b �b " �b 8 �b $ 0c Uc uc Q �c & �c a
d @ od 5 �d , �d e " .e # Qe , ue �e ! �e * �e # f % 2f 0 Xf & �f $ �f �f " �f = g # Ug 1 yg �g �g �g : �g ) h B Gh P �h �h �h
i (i " 8i [i ui & �i & �i % �i 2 j 9j Nj & jj ! �j ) �j # �j " k $k r 5k < �k D �k N *l F yl �l �l & �l , m - Mm {m " �m / �m �m n ( n @ Fn �n �n �n P �n +o > Ao 1 �o > �o / �o Y !p > {p �p �p " �p q & 3q < Zq �q ' �q ( �q ' �q $r Br Yr 1 lr + �r �r % �r 3 s Es ^s " ws ; �s �s �s 0 t 6t / Ut �t �t �t . �t I u > Su D �u �u �u v 7 v 9 Mv 6 �v H �v @ w Hw 3 Zw & �w 0 �w 6 �w / x ( Mx , vx �x " �x �x �x y h !y T �y � �y 6 bz L �z J �z 9 1{ k{ $ z{ + �{ �{ �{ �{ | -| 2 A| t| " �| �| �| �| �| $ } +} & <} c} w} # �} �} $ �} ) �} ~ ! 1~ % S~ + y~ �~ & �~ ' �~ 4 0 Q . � ) � + � � ( #� L� 4 j� � �� # "� * F� q� �� �� �� ( ҁ �� " � 5� E J� # �� �� ̂ � ; � '� =� J� ' f� �� ' �� % � � 0� B M� 0 �� ! �� 8 � : � W� s� 3 �� 1 ƅ 1 �� + *� $ V� $ {� h �� � � �� ʈ N ߈ ` .� L �� ܉ # �� r � �� �� �� Ċ E ܊ D "� V g� T �� 5 � � I� L ˌ E � J ^� W �� x � M z� D Ȏ V
� G d� M �� = �� X 8� 6 �� ? Ȑ X � ^ a� M �� J � � Y� � � A �� @ � < .� 3 k� U �� B �� F 8� � � ; � � G� ? Ԗ = � } R� > З Q � L a� P �� B �� ? B� H �� G ˙ C � G W� K �� < � C (� ? l� S �� O � 9 P� 7 �� 6 L �� - F� A t� 9 �� I � E :� U �� \ ֞ 6 3� > j� H �� < � ; /� 0 k� X �� = �� C 3� Q w� B ɡ Y � 4 f� 0 �� 9 ̢ F � T M� �� ; �� D � K &� r� �� > �� + � . � Z J� & �� + ̥ 7 �� = 0� + n� . �� ɦ � " � ) � 3 ?� D s� @ �� W �� ` Q� _ �� J � 4 ]� �� �� 5 é �� 8 � A� * `� & �� # �� & ֪ \ �� P Z� R �� $ �� #� D� [� p� 9 �� � Ŭ ]� 1 i� � �� � 5� 3 ̮ � q � j �� / �
� \ .� v �� : � ^ =� a �� N �� 7 M� < �� : ² 0 �� 2 .� F a� 1 �� . ڳ . � , 8� - e� > �� = Ҵ 0 � G A� ' �� 0 �� � = �� 4 <� 5 q� 5 �� : ݶ < � 3 U� 3 �� i �� 7 '� G _� r �� � ) 9� : c� �� $ ��
� � �� � . 2� # a� - �� ^ �� � - 3� ) a� ) �� �� ѻ � 3 �� 2 )� \� - p� �� - �� M � % ;� ! a� �� 0 �� . ս " � $ '� # L� 2 p� # �� Ǿ % � * � 7� + W� " �� $ �� # ˿ 1 � !� " ;� D ^� � �� � D� $ � " � @ (� 4 i� 0 �� - �� + �� . )� * X� $ �� / �� � �� 1 �� 4 �� % �� , %� / R� ' �� �� % �� ? �� ' +� " S� v� X �� ) �� h � ? �� 9 �� 2 �� 0� " M� # p� / �� �� % �� 0 � ' 7� + _� 6 �� 2 �� & �� � ( ;� F d� % �� / �� � � $� 4 4� 4 i� I �� I �� 2� D� c� �� $ �� �� ! �� ' �� ' � & F� ; m� �� �� , �� ' �� / $� # T� " x� �� } �� J %� ^ p� f �� _ 6� , �� �� & �� ) � + 5� a� |� . �� �� �� ) �� G &� n� ! �� * �� P �� )� < C� / �� < �� 7 �� T %� 9 z� �� �� # �� � + /� @ [� �� ) �� * �� ' � -� K� a� / u� 2 �� �� # �� ; � X� s� * �� = �� �� � 0 ,� ]� 1 ~� �� �� �� / �� R -� P �� Q �� #� 3� T� / i� ? �� 8 �� R � < e� �� 3 �� + �� : � = U� 3 �� - �� . ��
$� # 2� V� ! q� �� x �� S $� � x� D � ^ e� O �� D � Y� & j� + �� �� �� ��
� %� 5 9�
o� ! }� �� �� �� �� & �� � & -� T� h� % z� �� * �� / �� * � + >� / j� 7 �� ' �� , �� . '� ' V� % ~� 4 �� . �� , � + 5� " a� 2 �� �� < �� m � & � 9 �� �� �� � $� ( =� f� ! �� �� [ �� # � >� \� x� A �� �� �� �� $ � 1� O� o� ' �� �� �� ; �� , (� $ U� ; z� ? �� �� ! � , 3� - `� - �� * �� # �� & � l 2� � � p � � � � m � _ � @ � 8 � �
= n k t ! � � � E � � � � . � & � ] � a � � � � � ! � ( � � ] � U � � j A 0 � � : � '
V ~ q Q � � F � � � - v � � � � Y � � i > � g � � � � � D a T � & + � � j D l � � � � � � � 3 � � � � � � � � f � � � { � � � � 7 � � � � � � r K � � 7 � � I � � I L v � � R � � / � � � � � 9 2 � < 4 $ � d ( � + � � � � � � o c � � 1 u � s � * b � � r � � � - i : � / � 3 ^ z K X X G � ) % � \ � � C � � � # � 2 � H � Q = � B J S ~ T � } � n E H 5 6 �
x � [ J � � y 6 � c o l w h s � � F ? m # p 9 � Z � � � � � ` � Y
� � 5 4 B @ � � z � � � g y { O � , " � � ? � � � � � S b > � N � � � P N . � ; � � � � � ` � q ) � � � � � � � � | � � t ^ � O ; h " � G w � � R V % � , � � � � � � � � � C � � M 0 � W � � _ � � � � f � ' < * � � � \ � L | [ Z } P � � � $ W � � � � � � � 8 � � x A e � d � U � � � � 1 � u e � M � k �
Connection options:
General options:
If -f/--file is not used, then the SQL script will be written to the standard
output.
If no database name is supplied, then the PGDATABASE environment
variable value is used.
If no input file name is supplied, then standard input is used.
Options controlling the output content:
Options controlling the restore:
The options -I, -n, -P, -t, -T, and --section can be combined and specified
multiple times to select multiple objects.
%s
%s [OPTION]...
%s [OPTION]... [DBNAME]
%s [OPTION]... [FILE]
--binary-upgrade for use by upgrade utilities only
--column-inserts dump data as INSERT commands with column names
--disable-dollar-quoting disable dollar quoting, use SQL standard quoting
--disable-triggers disable triggers during data-only restore
--enable-row-security enable row security
--enable-row-security enable row security (dump only content user has
access to)
--exclude-table-data=TABLE do NOT dump data for the named table(s)
--if-exists use IF EXISTS when dropping objects
--inserts dump data as INSERT commands, rather than COPY
--lock-wait-timeout=TIMEOUT fail after waiting TIMEOUT for a table lock
--no-data-for-failed-tables do not restore data of tables that could not be
created
--no-security-labels do not dump security label assignments
--no-security-labels do not restore security labels
--no-synchronized-snapshots do not use synchronized snapshots in parallel jobs
--no-tablespaces do not dump tablespace assignments
--no-tablespaces do not restore tablespace assignments
--no-unlogged-table-data do not dump unlogged table data
--quote-all-identifiers quote all identifiers, even if not key words
--role=ROLENAME do SET ROLE before dump
--role=ROLENAME do SET ROLE before restore
--section=SECTION dump named section (pre-data, data, or post-data)
--section=SECTION restore named section (pre-data, data, or post-data)
--serializable-deferrable wait until the dump can run without anomalies
--snapshot=SNAPSHOT use given snapshot for the dump
--strict-names require table and/or schema include patterns to
match at least one entity each
--use-set-session-authorization
use SET SESSION AUTHORIZATION commands instead of
ALTER OWNER commands to set ownership
-1, --single-transaction restore as a single transaction
-?, --help show this help, then exit
-?, --help show this help, then exit
-C, --create create the target database
-C, --create include commands to create database in dump
-E, --encoding=ENCODING dump the data in encoding ENCODING
-F, --format=c|d|t backup file format (should be automatic)
-F, --format=c|d|t|p output file format (custom, directory, tar,
plain text (default))
-I, --index=NAME restore named index
-L, --use-list=FILENAME use table of contents from this file for
selecting/ordering output
-N, --exclude-schema=SCHEMA do NOT dump the named schema(s)
-O, --no-owner skip restoration of object ownership
-O, --no-owner skip restoration of object ownership in
plain-text format
-P, --function=NAME(args) restore named function
-S, --superuser=NAME superuser user name to use for disabling triggers
-S, --superuser=NAME superuser user name to use in plain-text format
-S, --superuser=NAME superuser user name to use in the dump
-T, --exclude-table=TABLE do NOT dump the named table(s)
-T, --trigger=NAME restore named trigger
-U, --username=NAME connect as specified database user
-V, --version output version information, then exit
-V, --version output version information, then exit
-W, --password force password prompt (should happen automatically)
-Z, --compress=0-9 compression level for compressed formats
-a, --data-only dump only the data, not the schema
-a, --data-only restore only the data, no schema
-b, --blobs include large objects in dump
-c, --clean clean (drop) database objects before recreating
-c, --clean clean (drop) databases before recreating
-d, --dbname=CONNSTR connect using connection string
-d, --dbname=DBNAME database to dump
-d, --dbname=NAME connect to database name
-e, --exit-on-error exit on error, default is to continue
-f, --file=FILENAME output file name
-f, --file=FILENAME output file or directory name
-f, --file=FILENAME output file name (- for stdout)
-g, --globals-only dump only global objects, no databases
-h, --host=HOSTNAME database server host or socket directory
-j, --jobs=NUM use this many parallel jobs to dump
-j, --jobs=NUM use this many parallel jobs to restore
-l, --database=DBNAME alternative default database
-l, --list print summarized TOC of the archive
-n, --schema=NAME restore only objects in this schema
-n, --schema=SCHEMA dump the named schema(s) only
-o, --oids include OIDs in dump
-p, --port=PORT database server port number
-r, --roles-only dump only roles, no databases or tablespaces
-s, --schema-only dump only the schema, no data
-s, --schema-only restore only the schema, no data
-t, --table=NAME restore named relation (table, view, etc.)
-t, --table=TABLE dump the named table(s) only
-t, --tablespaces-only dump only tablespaces, no databases or roles
-v, --verbose verbose mode
-v, --verbose verbose mode
-w, --no-password never prompt for password
-x, --no-privileges do not dump privileges (grant/revoke)
-x, --no-privileges skip restoration of access privileges (grant/revoke)
%s %s dumps a database as a text file or to other formats.
%s extracts a PostgreSQL database cluster into an SQL script file.
%s restores a PostgreSQL database from an archive created by pg_dump.
%s: %s Command was: %s
%s: WSAStartup failed: %d
%s: cannot specify both --single-transaction and multiple jobs
%s: could not connect to database "%s"
%s: could not connect to database "%s": %s %s: could not connect to databases "postgres" or "template1"
Please specify an alternative database.
%s: could not get server version
%s: could not open the output file "%s": %s
%s: could not parse ACL list (%s) for database "%s"
%s: could not parse ACL list (%s) for tablespace "%s"
%s: could not parse server version "%s"
%s: could not re-open the output file "%s": %s
%s: dumping database "%s"...
%s: executing %s
%s: invalid number of parallel jobs
%s: maximum number of parallel jobs is %d
%s: option --if-exists requires option -c/--clean
%s: options -c/--clean and -a/--data-only cannot be used together
%s: options -d/--dbname and -f/--file cannot be used together
%s: options -g/--globals-only and -r/--roles-only cannot be used together
%s: options -g/--globals-only and -t/--tablespaces-only cannot be used together
%s: options -r/--roles-only and -t/--tablespaces-only cannot be used together
%s: options -s/--schema-only and -a/--data-only cannot be used together
%s: pg_dump failed on database "%s", exiting
%s: query failed: %s %s: query was: %s
%s: role name starting with "pg_" skipped (%s)
%s: running "%s"
%s: too many command-line arguments (first is "%s")
%s: unrecognized section name: "%s"
(The INSERT command cannot set OIDs.)
(The system catalogs might be corrupted.)
-C and -1 are incompatible options
COPY failed for table "%s": %s Consider using a full dump instead of a --data-only dump to avoid this problem.
Dumping the contents of table "%s" failed: PQgetCopyData() failed.
Dumping the contents of table "%s" failed: PQgetResult() failed.
Error from TOC entry %d; %u %u %s %s %s
Error message from server: %s Error while FINALIZING:
Error while INITIALIZING:
Error while PROCESSING TOC:
Exported snapshots are not supported by this server version.
NOTICE: there are circular foreign-key constraints on this table:
NOTICE: there are circular foreign-key constraints among these tables:
Password: Report bugs to <pgsql-bugs@postgresql.org>.
Synchronized snapshots are not supported by this server version.
Run with --no-synchronized-snapshots instead if you do not need
synchronized snapshots.
Synchronized snapshots are not supported on standby servers.
Run with --no-synchronized-snapshots instead if you do not need
synchronized snapshots.
TOC Entry %s at %s (length %s, checksum %d)
The command was: %s
The program "pg_dump" is needed by %s but was not found in the
same directory as "%s".
Check your installation.
The program "pg_dump" was found by "%s"
but was not the same version as %s.
Check your installation.
Try "%s --help" for more information.
Usage:
WARNING: aggregate function %s could not be dumped correctly for this database version; ignored
WARNING: archive is compressed, but this installation does not support compression -- no data will be available
WARNING: archive items not in correct section order
WARNING: archive was made on a machine with larger integers, some operations might fail
WARNING: bogus transform definition, at least one of trffromsql and trftosql should be nonzero
WARNING: bogus value in pg_cast.castfunc or pg_cast.castmethod field
WARNING: bogus value in pg_cast.castmethod field
WARNING: bogus value in pg_transform.trffromsql field
WARNING: bogus value in pg_transform.trftosql field
WARNING: bogus value in proargmodes array
WARNING: could not find operator with OID %s
WARNING: could not find where to insert IF EXISTS in statement "%s"
WARNING: could not parse proallargtypes array
WARNING: could not parse proargmodes array
WARNING: could not parse proargnames array
WARNING: could not parse proconfig array
WARNING: could not parse reloptions array
WARNING: could not resolve dependency loop among these items:
WARNING: don't know how to set owner for object type "%s"
WARNING: errors ignored on restore: %d
WARNING: ftell mismatch with expected position -- ftell used
WARNING: invalid creation date in header
WARNING: invalid type "%c" of access method "%s"
WARNING: line ignored: %s
WARNING: owner of aggregate function "%s" appears to be invalid
WARNING: owner of data type "%s" appears to be invalid
WARNING: owner of function "%s" appears to be invalid
WARNING: owner of operator "%s" appears to be invalid
WARNING: owner of operator class "%s" appears to be invalid
WARNING: owner of operator family "%s" appears to be invalid
WARNING: owner of schema "%s" appears to be invalid
WARNING: owner of table "%s" appears to be invalid
WARNING: requested compression not available in this installation -- archive will be uncompressed
WARNING: typtype of data type "%s" appears to be invalid
WARNING: unexpected extra results during COPY of table "%s"
You might not be able to restore the dump without using --disable-triggers or temporarily dropping the constraints.
a worker process died unexpectedly
aborting because of server version mismatch
actual file length (%s) does not match expected (%s)
allocating AH for %s, format %d
already connected to a database
archiver archiver (db) attempting to ascertain archive format
bad dumpId
bad table dumpId for TABLE DATA item
can only reopen input archives
cannot duplicate null pointer (internal error)
cannot restore from compressed archive (compression not supported in this installation)
child process exited with exit code %d child process exited with unrecognized status %d child process was terminated by exception 0x%X child process was terminated by signal %d: %s command not executable command not found compress_io compression is not supported by tar archive format
compression level must be in range 0..9
compressor active
connecting to database for restore
connecting to new database "%s"
connection to database "%s" failed: %s corrupt tar header found in %s (expected %d, computed %d) file position %s
could not change directory to "%s": %s could not close TOC file: %s
could not close archive file: %s
could not close compression library: %s
could not close compression stream: %s
could not close data file "%s": %s
could not close directory "%s": %s
could not close input file: %s
could not close large object TOC file "%s": %s
could not close output file: %s
could not close tar member
could not close temporary file: %s
could not commit database transaction could not compress data: %s
could not create communication channels: %s
could not create directory "%s": %s
could not create large object %u: %s could not create worker process: %s
could not determine seek position in archive file: %s
could not execute query could not find a "%s" to execute could not find block ID %d in archive -- possibly corrupt archive
could not find block ID %d in archive -- possibly due to out-of-order restore request, which cannot be handled due to lack of data offsets in archive
could not find block ID %d in archive -- possibly due to out-of-order restore request, which cannot be handled due to non-seekable input file
could not find entry for ID %d
could not find file "%s" in archive
could not find function definition for function with OID %u
could not find header for file "%s" in tar archive
could not find parent extension for %s %s
could not find slot of finished worker
could not generate temporary file name: %s
could not get server_version from libpq
could not identify current directory: %s could not identify dependency loop
could not initialize compression library: %s
could not obtain lock on relation "%s"
This usually means that someone requested an ACCESS EXCLUSIVE lock on the table after the pg_dump parent process had gotten the initial ACCESS SHARE lock on the table.
could not open TOC file "%s" for input: %s
could not open TOC file "%s" for output: %s
could not open TOC file "%s": %s
could not open TOC file for input: %s
could not open TOC file for output: %s
could not open input file "%s": %s
could not open input file: %s
could not open large object %u: %s could not open large object TOC file "%s" for input: %s
could not open output file "%s": %s
could not open output file: %s
could not open temporary file
could not parse GRANT ACL list (%s) or REVOKE ACL list (%s) for object "%s" (%s)
could not parse default ACL list (%s)
could not parse initial GRANT ACL list (%s) or initial REVOKE ACL list (%s) for object "%s" (%s)
could not parse numeric array "%s": invalid character in number
could not parse numeric array "%s": too many numbers
could not parse result of current_schemas()
could not read binary "%s" could not read directory "%s": %s
could not read from input file: %s
could not read from input file: end of file
could not read input file: %s
could not read symbolic link "%s" could not set default_tablespace to %s: %s could not set default_with_oids: %s could not set search_path to "%s": %s could not set seek position in archive file: %s
could not set session user to "%s": %s could not start database transaction could not uncompress data: %s
could not write to blobs TOC file
could not write to large object (result: %lu, expected: %lu)
could not write to output file: %s
could not write to the communication channel: %s
creating %s "%s"
creating %s "%s.%s"
custom archiver definition of view "%s" appears to be empty (length zero)
did not find magic string in file header
direct database connections are not supported in pre-1.3 archives
directory "%s" does not appear to be a valid archive ("toc.dat" does not exist)
directory archiver directory name too long: "%s"
disabling triggers for %s
dropping %s %s
dumping contents of table "%s.%s"
enabling triggers for %s
entering main parallel loop
entering restore_toc_entries_parallel
entering restore_toc_entries_postfork
entering restore_toc_entries_prefork
entry ID %d out of range -- perhaps a corrupt TOC
error during backup
error during file seek: %s
error processing a parallel work item
error reading large object %u: %s error reading large object TOC file "%s"
error returned by PQputCopyData: %s error returned by PQputCopyEnd: %s executing %s %s
expected %d check constraint on table "%s" but found %d
expected %d check constraints on table "%s" but found %d
expected format (%d) differs from format found in file (%d)
failed sanity check, parent OID %u of table "%s" (OID %u) not found
failed sanity check, parent table OID %u of pg_rewrite entry OID %u not found
failed sanity check, parent table OID %u of sequence OID %u not found
failed to connect to database
file name too long: "%s"
file offset in dump file is too large
finding check constraints for table "%s.%s"
finding default expressions of table "%s.%s"
finding extension tables
finding inheritance relationships
finding the columns and types of table "%s.%s"
finished item %d %s %s
finished main parallel loop
flagging inherited columns in subtables
found unexpected block ID (%d) when reading data -- expected %d
function "%s" not found
identifying extension members
implied data-only restore
incomplete tar header found (%lu byte)
incomplete tar header found (%lu bytes)
index "%s" not found
input file appears to be a text format dump. Please use psql.
input file does not appear to be a valid archive
input file does not appear to be a valid archive (too short?)
input file is too short (read %lu, expected 5)
internal error -- WriteData cannot be called outside the context of a DataDumper routine
internal error -- neither th nor fh specified in tarReadRaw()
invalid ENCODING item: %s
invalid OID for large object
invalid OID for large object (%u)
invalid STDSTRINGS item: %s
invalid adnum value %d for table "%s"
invalid argument string (%s) for trigger "%s" on table "%s"
invalid binary "%s" invalid client encoding "%s" specified
invalid column number %d for table "%s"
invalid column numbering in table "%s"
invalid compression code: %d
invalid dependency %d
invalid dumpId %d
invalid line in large object TOC file "%s": "%s"
invalid message received from worker: "%s"
invalid number of parallel jobs
invalid output format "%s" specified
large-object output not supported in chosen format
last built-in OID is %u
launching item %d %s %s
missing index for constraint "%s"
moving from position %s to next member at file position %s
no item ready
no matching schemas were found
no matching schemas were found for pattern "%s"
no matching tables were found
no matching tables were found for pattern "%s"
no output directory specified
not built with zlib support
now at file position %s
option --if-exists requires option -c/--clean
options --inserts/--column-inserts and -o/--oids cannot be used together
options -c/--clean and -a/--data-only cannot be used together
options -s/--schema-only and -a/--data-only cannot be used together
out of memory
out of on_exit_nicely slots
parallel archiver parallel backup only supported by the directory format
parallel restore from non-seekable file is not supported
parallel restore from standard input is not supported
parallel restore is not supported with archives made by pre-8.0 pg_dump
parallel restore is not supported with this archive file format
pclose failed: %s pgpipe: could not accept connection: error code %d
pgpipe: could not bind: error code %d
pgpipe: could not connect socket: error code %d
pgpipe: could not create second socket: error code %d
pgpipe: could not create socket: error code %d
pgpipe: could not listen: error code %d
pgpipe: getsockname() failed: error code %d
processing %s
processing data for table "%s.%s"
processing item %d %s %s
processing missed item %d %s %s
query failed: %s query produced null referenced table name for foreign key trigger "%s" on table "%s" (OID of table: %u)
query returned %d row instead of one: %s
query returned %d rows instead of one: %s
query to get data of sequence "%s" returned %d row (expected 1)
query to get data of sequence "%s" returned %d rows (expected 1)
query to get data of sequence "%s" returned name "%s"
query to get rule "%s" for table "%s" failed: wrong number of rows returned
query to obtain definition of view "%s" returned more than one definition
query to obtain definition of view "%s" returned no data
query was: %s
read TOC entry %d (ID %d) for %s %s
reading column info for interesting tables
reading constraints
reading default privileges
reading dependency data
reading event triggers
reading extensions
reading foreign key constraints for table "%s.%s"
reading indexes
reading indexes for table "%s.%s"
reading large objects
reading policies
reading procedural languages
reading rewrite rules
reading row-level security policies
reading schemas
reading table inheritance information
reading transforms
reading triggers
reading triggers for table "%s.%s"
reading type casts
reading user-defined access methods
reading user-defined aggregate functions
reading user-defined collations
reading user-defined conversions
reading user-defined foreign servers
reading user-defined foreign-data wrappers
reading user-defined functions
reading user-defined operator classes
reading user-defined operator families
reading user-defined operators
reading user-defined tables
reading user-defined text search configurations
reading user-defined text search dictionaries
reading user-defined text search parsers
reading user-defined text search templates
reading user-defined types
reconnection to database "%s" failed: %s reducing dependencies for %d
restored %d large object
restored %d large objects
restoring data out of order is not supported in this archive format: "%s" is required, but comes before "%s" in the archive file.
restoring large object with OID %u
sanity check on integer size (%lu) failed
saving database definition
saving encoding = %s
saving large objects
saving search_path = %s
saving standard_conforming_strings = %s
schema "%s" not found
schema with OID %u does not exist
select() failed: %s
server version must be at least 7.3 to use schema selection switches
server version: %s; %s version: %s
skipping item %d %s %s
skipping tar member %s
sorter table "%s" could not be created, will not restore its data
table "%s" not found
tar archiver this format cannot be read
transferring dependency %d -> %d to %d
trigger "%s" not found
unexpected COPY statement syntax: "%s"
unexpected data offset flag %d
unexpected policy command type: "%s"
unexpected section code %d
unexpected tgtype value: %d
unrecognized archive format "%s"; please specify "c", "d", or "t"
unrecognized command received from master: "%s"
unrecognized constraint type: %c
unrecognized data block type %d while restoring archive
unrecognized data block type (%d) while searching archive
unrecognized encoding "%s"
unrecognized file format "%d"
unrecognized object type in default privileges: %d
unrecognized proparallel value for function "%s"
unrecognized provolatile value for function "%s"
unsupported version (%d.%d) in file header
warning from original dump file: %s
worker process failed: exit code %d
wrote %lu byte of large object data (result = %lu)
wrote %lu bytes of large object data (result = %lu)
Project-Id-Version: PostgreSQL 9.6
Report-Msgid-Bugs-To: pgsql-bugs@postgresql.org
POT-Creation-Date: 2021-11-07 09:52+0000
PO-Revision-Date: 2021-11-07 20:58+0100
Last-Translator: Dennis Björklund <db@zigo.dhs.org>
Language-Team: Swedish <pgsql-translators@postgresql.org>
Language: sv
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Plural-Forms: nplurals=2; plural=(n != 1);
Flaggor för anslutning:
Allmänna flaggor:
Om -f/--file inte används så kommer SQL-skriptet skriva till standard ut.
Om inget databasnamn anges, då kommer värdet i omgivningsvariabel
PGDATABASE att användas.
Om inget indatafilnamn är angivet, så kommer standard in att användas.
Flaggor som styr utmatning:
Flaggor som styr återställning:
Flaggorna -I, -n, -P, -t, -T och --section kan kombineras och anges
många gånger för att välja flera objekt.
%s
%s [FLAGGA]...
%s [FLAGGA]... [DBNAMN]
%s [FLAGGA]... [FIL]
--binary-upgrade används bara av uppgraderingsverktyg
--column-inserts dumpa data som INSERT med kolumnnamn
--disable-dollar-quoting slå av dollar-citering, använd standard SQL-citering
--disable-triggers slå av utlösare vid återställning av enbart data
--enable-row-security aktivera radsäkerhet
--enable-row-security slå på radsäkerhet (dumpa bara data användaren
har rätt till)
--exclude-table-data=TABELL dumpa INTE data för de namngivna tabellerna
--if-exists använd IF EXISTS när objekt droppas
--inserts dumpa data som INSERT, istället för COPY
--lock-wait-timeout=TIMEOUT misslyckas efter att ha väntat i TIMEOUT på tabellås
--no-data-for-failed-tables återställ inte data för tabeller som
inte kunde skapas
--no-security-labels dumpa inte tilldelning av säkerhetsetiketter
--no-security-labels återställ inte säkerhetsetiketter
--no-synchronized-snapshots använd inte synkroniserade snapshots i parallella job
--no-tablespaces dumpa inte användning av tabellutymmen
--no-tablespaces återställ inte användning av tabellutymmen
--no-unlogged-table-data dumpa inte ologgad tabelldata
--quote-all-identifiers citera alla identifierar, även om de inte är nyckelord
--role=ROLLNAMN gör SET ROLE innan dumpen
--role=ROLENAME gör SET ROLE innan återställning
--section=SEKTION dumpa namngiven sektion (pre-data, data eller post-data)
--section=SEKTION återställ namngiven sektion (pre-data, data eller post-data)
--serializable-deferrable wait until the dump can run without anomalies
--snapshot=SNAPSHOT använda namngivet snapshot för att dumpa
--strict-names kräv att mallar för tabeller och/eller scheman matchar
minst en sak var
--use-set-session-authorization
använd kommandot SET SESSION AUTHORIZATION istället för
kommandot ALTER OWNER för att sätta ägare
-1, --single-transaction återställ i en enda transaktion
-?, --help visa denna hjälp, avsluta sedan
-?, --help visa denna hjälp, avsluta sedan
-C, --create skapa måldatabasen
-C, --create inkludera kommandon för att skapa databasen i dumpen
-E, --encoding=KODNING dumpa data i teckenkodning KODNING
-F, --format=c|d|t backupens filformat (bör ske automatiskt)
-F, --format=c|d|t|p utdatans filformat (egen (c), katalog (d), tar (t),
ren text (p) (standard))
-I, --index=NAMN återställ namngivet index
-L, --use-list=FILNAMN använd innehållsförteckning från denna fil för
att välja/sortera utdata
-N, --exclude-schema=SCHEMA dumpa INTE de namngivna scheman
-O, --no-owner återställ inte objektägare
-O, --no-owner hoppa över återställande av objektägare i
textformatdumpar
-P, --function=NAMN(arg) återställ namngiven funktion
-S, --superuser=NAMN superanvändarens namn för att slå av utlösare
-S, --superuser=NAME superanvändarens namn för textformatdumpar
-S, --superuser=NAMN superanvändarens namn för användning i dumpen
-T, --exclude-table=TABELL dumpa INTE de namngivna tabellerna
-T, --trigger=NAMN återställ namngiven utlösare
-U, --username=NAMN anslut med datta användarnamn mot databasen
-V, --version visa versionsinformation, avsluta sedan
-V, --version visa versionsinformation, avsluta sedan
-W, --password fråga om lösenord (borde ske automatiskt)
-Z, --compress=0-9 komprimeringsnivå för komprimerade format
-a, --data-only dumpa bara data, inte schema
-a, --data-only återställ bara data, inte scheman
-b, --blobs inkludera stora objekt i dumpen
-c, --clean nollställ (drop) databasobjekt innan återskapande
-c, --clean nollställ (drop) databaser innan återskapning
-d, --dbname=ANSLSTR anslut med anslutningssträng
-d, --dbname=DBNAMN databasens som skall dumpas
-d, --dbname=NAMN koppla upp med databasnamn
-e, --exit-on-error avsluta vid fel, standard är att fortsätta
-f, --file=FILENAME utdatafilnamn
-f, --file=FILENAME fil eller katalognamn för utdata
-f, --file=FILNAMN utdatafilnamn (- för stdout)
-g, --globals-only dumpa bara globala objekt, inte databaser
-h, --host=VÄRDNAMN databasens värdnamn eller socketkatalog
-j, --jobs=NUM använd så här många parellella job för att dumpa
-j, --jobs=NUM använda så här många parallella job för återställning
-l, --database=DBNAMN alternativ standarddatabas
-l, --list skriv ut summerad TOC för arkivet
-n, --schema=NAMN återställ enbart objekt i detta schema
-n, --schema=SCHEMA dumpa bara namngivna scheman
-o, --oids inkludera OID:er i dumpning
-p, --port=PORT databasens värdport
-r, --roles-only dumpa endast roller, inte databaser eller tabellutrymmen
-s, --schema-only dumpa bara scheman, inte data
-s, --schema-only återställ bara scheman, inte data
-t, --table=NAMN återställ namngiven relation (tabell, vy, osv.)
-t, --table=TABELL dumpa bara de namngivna tabellerna
-t, --tablespaces-only dumpa endasdt tabellutrymmen, inte databaser eller roller
-v, --verbose visa mer information
-v, --verbose visa mer information
-w, --no-password fråga aldrig efter lösenord
-x, --no-privileges dumpa inte rättigheter (grant/revoke)
-x, --no-privileges återställ inte åtkomsträttigheter (grant/revoke)
%s %s dumpar en databas som en textfil eller i andra format.
%s extraherar ett PostgreSQL databaskluster till en SQL-scriptfil.
%s återställer en PostgreSQL-databas från ett arkiv skapat av pg_dump.
%s: %s Kommandot var: %s
%s: WSAStartup misslyckades: %d
%s: kan inte ange både --single-transaction och multipla job
%s: kunde inte ansluta till databasen "%s"
%s: kunde inte ansluta till databasen "%s": %s %s: kunde inte ansluta till databasen "postgres" eller "template1"
Ange en annan databas.
%s: kunde inte hämta serverversionen
%s: kunde inte öppna utdatafilen "%s": %s
%s: kunde inte tolka ACL-listan (%s) för databas "%s"
%s: kunde inte tolka ACL-listan (%s) för tabellutrymme "%s"
%s: kunde inte tolka versionsträngen "%s"
%s: kunde inte öppna om utdatafilen "%s": %s
%s: dumpar databas "%s"...
%s: kör %s
%s: ogiltigt antal parallella job
%s: maximalt antal parallella job är %d
%s: flaggan --if-exists kräver flaggan -c/--clean
%s: flaggorna -c/--clean och -a/--data-only kan inte användas ihop
%s: flaggorna -d/--dbname och -f/--file kan inte användas ihop
%s: flaggorna "bara gobala" (-g) och "bara roller" (-r) kan inte användas tillsammans
%s: flaggorna "bara globala" (-g) och "bara tabellutrymmen" (-t) kan inte användas tillsammans
%s: flaggorna "bara roller" (-r) och "bara tabellutrymmen" (-t) kan inte användas tillsammans
%s: flaggorna -s/--schema-only och -a/--data-only kan inte användas ihop
%s: pg_dump misslyckades med databas "%s", avslutar
%s: fråga misslyckades: %s %s: frågan var: %s
%s: rollnamn som startar med "pg_" hoppas över (%s)
%s: kör "%s"
%s: för många kommandoradsargument (första är "%s")
%s: okänt sektionsnamn: "%s"
(Kommandot INSERT kan inte sätta OID:s.)
(systemkatalogerna kan vara trasiga.)
-C och -1 är inkompatibla flaggor
COPY misslyckades för tabell "%s": %s Överväg att göra en full dump istället för --data-only för att undvika detta problem.
Dumpning av innehållet i tabellen "%s" misslyckades: PQendcopy() misslyckades.
Dumpning av innehållet i tabellen "%s" misslyckades: PQgetResult() misslyckades.
Fel på TOC-post %d; %u %u %s %s %s
Felmeddelandet från servern: %s Fel vid SLUTFÖRANDE:
Fel vid INITIERING:
Fel vid HANTERING AV TOC:
Exporterade snapshots stöds inte i denna serverversion.
NOTIS: det finns cirkulära främmande nyckelberoenden för denna tabell:
NOTIS: det finns cirkulära främmande nyckelberoenden för dessa tabeller:
Lösenord: Rapportera fel till <pgsql-bugs@postgresql.org>.
Synkroniseringssnapshots stöds inte av denna serverversion.
Kör med --no-synchronized-snapshots istället om du inte kräver
synkroniserade snapshots.
Synkroniserade snapshots stöds inte av standby-servrar.
Kör med --no-synchronized-snapshots istället om du inte
behöver synkroniserade snapshots.
TOC-objekt %s vid %s (längd %s, kontrollsumma %d)
Kommandot var: %s
Programmet "pg_dump" behövs av %s men kunde inte hittas i samma katalog
som "%s".
Kontrollera din installation.
Programmet "pg_dump" hittades av "%s"
men hade inte samma version som "%s".
Kontrollera din installation.
Försök med "%s --help" för mer information.
Användning:
VARNING: aggregatfunktion %s kunde inte dumpas korrekt för denna databasversion; ignorerad
VARNING: arkivet är komprimerat, men denna installation stödjer inte komprimering -- ingen data kommer kunna läsas
VARNING: arkivobjekten är inte i korrekt sektionsordning
VARNING: arkivet skapades på en maskin med större heltal, en del operationer kan misslyckas
VARNING: felaktig transform-definition, minst en av trffromsql och trftosql måste vara ickenoll
VARNING: felaktigt värde i fältet pg_cast.castfunc eller pg_cast.castmethod
VARNING: felaktigt värde i fältet pg_cast.castmethod
VARNING: felaktigt värde i fältet pg_transform.trffromsql
VARNING: felaktigt värde i fältet pg_transform.trftosql
VARNING: felaktigt värde i arrayen proargmodes
VARNING: kunde inte hitta en operator med OID %s.
VARNING: kunde inte hitta var IF EXISTS skulle stoppas in i sats "%s"
VARNING: kunde inte tolka arrayen proallargtypes
VARNING: kunde inte tolka arrayen proargmodes
VARNING: kunde inte tolka arrayen proargnames
VARNING: kunde inte tolka arrayen proconfig
VARNING: kunde inte parsa arrayen reloptions
VARNING: kunde inte räta ut beroendeloopen för dessa saker:
VARNING: vet inte hur man sätter ägare för objekttyp "%s"
VARNING: fel ignorerade vid återställande: %d
VARNING: ftell stämmer inte med förväntad position -- ftell använd
VARNING: ogiltig skapandedatum i huvud
VARNING: ogiltig typ "%c" för accessmetod "%s"
VARNING: rad ignorerad: %s
VARNING: ägare av aggregatfunktion "%s" verkar vara ogiltig
VARNING: ägare av datatyp "%s" verkar vara ogiltig
VARNING: ägare av funktion "%s" verkar vara ogiltig
VARNING: ägare av operator "%s" verkar vara ogiltig
VARNING: ägare av operatorklass "%s" verkar vara ogiltig
VARNING: ägare av operator-familj "%s" verkar vara ogiltig
VARNING: ägare av schema "%s" verkar vara ogiltig
VARNING: ägare av tabell "%s" verkar vara ogiltig
VARNING: efterfrågad komprimering finns inte i denna installation -- arkivet kommer sparas okomprimerat
VARNING: typtype för datatyp "%s" verkar vara ogiltig
VARNING: oväntade extraresultat under kopiering (COPY) av tabell "%s"
Du kan eventiellt inte återställa dumpen utan att använda --disable-triggers eller temporärt droppa vilkoren.
en arbetsprocess dog oväntat
avbryter då serverversionerna i matchar
verklig fillängd (%s) matchar inte det förväntade (%s)
allokerar AH för %s, format %d
är redan uppkopplad mot en databas
arkiverare arkiverare (db) försöker lista ut arkivformat
felaktigt dumpId
felaktig tabell-dumpId för TABLE DATA-objekt
kan inte återöppna indataarkiven
kan inte duplicera null-pekare (internt fel)
kan inte återställa från komprimerat arkiv (inte konfigurerad med stöd för komprimering)
barnprocess avslutade med kod %d barnprocess avslutade med okänd statuskod %d barnprocess terminerades med avbrott 0x%X barnprocess terminerades av signal %d: %s kommandot är inte körbart kommandot kan ej hittas compress_io komprimering är stödjs inte av arkivformatet tar
komprimeringsnivå måste vara i intervallet 0..9
komprimerare aktiv
kopplar upp mot databas för återställning
kopplar upp mot ny databas "%s"
uppkoppling mot databas "%s" misslyckades: %s trasigt tar-huvud hittat i %s (förväntade %d, beräknad %d) filposition %s
kunde inte byta katalog till "%s": %s kunde inte stänga TOC-filen: %s
kan inte stänga arkivfilen: %s
kunde inte stänga komprimeringsbiblioteket: %s
kunde inte stänga komprimeringsströmmen: %s
kan inte stänga datafil "%s": %s
kunde inte stänga katalog "%s": %s
kunde inte stänga indatafilen: %s
kunde inte stänga stora objekts TOC-fil "%s": %s
kunde inte stänga utdatafilen: %s
kunde inte stänga tar-medlem
kunde inte stänga temporär fil: %s
kunde inte genomföra databastransaktionen kunde inte komprimera data: %s
kunde inte skapa kommunikationskanaler: %s
kunde inte skapa katalog "%s": %s
kunde inte skapa stort objekt %u: %s kunde inte skapa arbetsprocess: %s
kunde inte bestämma sökposition i arkivfil: %s
kunde inte utföra fråga kunde inte hitta en "%s" att köra kunde inte hitta block ID %d i arkiv -- möjligen ett trasigt arkiv
kunde inte hitta block ID %d i arkiv -- kanske på grund av en återställningbegäran i oordning vilket inte kan hanteras då det saknas dataoffsets i arkivet
kunde inte hitta block ID %d i arkiv -- kanske på grund av en återställningbegäran i oordning vilket inte kan hanteras då inputfilen inte är sökbar
kunde inte hitta en post för ID %d
kunde inte hitta fil "%s" i arkiv
kunde inte hitta funktionsdefinitionen för funktion med OID %u
kunde inte hitta filhuvud för fil "%s" i tar-arkiv
kunde inte hitta föräldrautökning för %s %s
kunde inte hitta slot för avslutad arbetare
kunde inte generera temporärt filnamn: %s
kunde inte hämta serverversionen från libpq
kunde inte identifiera aktuell katalog: %s kunde inte fastställa beroendeloop
kunde inte initiera komprimeringsbibliotek: %s
kunde inte låsa relationen "%s"
Dette beror oftast på att någon tagit ett ACCESS EXCLUSIVE-lås på tabellen
efter att pg_dumps föräldraprocess tagit ett ACCESS SHARE-lås på tabellen.
kunde inte öppna TOC-fil "%s" för läsning: %s
kunde inte öppna TOC-filen "%s" för utmatning: %s
kunde inte öppna TOC-filen "%s": %s
kunde inte öppna TOC-fil för läsning: %s
kunde inte öppna TOC-filen för utmatning: %s
kunde inte öppna indatafilen "%s": %s
kan inte öppna infil: %s
kunde inte öppna stort objekt %u: %s kunde inte öppna stora objekts TOC-fil "%s" för läsning: %s
kunde inte öppna utdatafilen "%s": %s
kunde inte öppna utdatafilen: %s
kunde inte öppna temporär fil
kunde inte parsa GRANT ACL-lista (%s) eller REVOKE ACL-lista (%s) för objekt "%s" (%s)
kunde inte parsa standard-ACL-lista (%s)
kunde inte parsa initial GRANT ACL-lista (%s) eller initial REVOKE ACL-lista (%s) för objekt "%s" (%s)
kunde inte tolka numerisk array "%s": ogiltigt tecken i nummer
kunde inte tolka numerisk array "%s": för många nummer
kunde inte parsa resultat från current_schemas()
kunde inte läsa binär "%s" kunde inte läsa katalog "%s": %s
kunde inte läsa från infilen: %s
kunde inte läsa från infilen: slut på filen
kan inte läsa infilen: %s
kunde inte läsa symbolisk länk "%s" kunde inte sätta default_tablespace till %s: %s kunde inte sätta default_with_oids: %s kunde inte sätta search_path till "%s": %s kunde inte söka till rätt position i arkivfilen: %s
kunde inte sätta sessionsanvändare till "%s": %s kunde inte starta databastransaktionen kunde inte packa upp data: %s
kunde inte skriva till blobbars TOC-fil
kunde inte skriva till stort objekt (resultat: %lu, förväntat: %lu)
kunde inte skriva till utdatafil: %s
kunde inte skriva till kommunikationskanal: %s
skapar %s "%s"
skapar %s "%s.%s"
egen arkiverare definition av vy "%s" verkar vara tom (längd noll)
kunde inte hitta den magiska strängen i filhuvudet
direkta databasuppkopplingar stöds inte i arkiv från före version 1.3
katalogen "%s" verkar inte vara ett giltigt arkiv ("toc.dat" finns inte)
katalogarkiverare katalognamn för långt: "%s"
stänger av utlösare för %s
tar bort %s %s
dumpar innehållet i tabell "%s.%s"
slår på utlösare för %s
går in i parallella huvudloopen
går in i restore_toc_entries_parallel
går in i restore_toc_entries_postfork
går in i restore_toc_entries_prefork
post-ID %d utanför sitt intervall -- kanske en trasig TOC
fel vid backup
fel vid sökning: %s
fel vid processande av parallell arbetspost
fel vid läsning av stort objekt %u: %s fel vid lösning av stora objekts TOC-fil "%s"
fel returnerat av PQputCopyData: %s fel returnerat av PQputCopyEnd: %s kör %s %s
förväntade %d check-villkor för tabell "%s" men hittade %d
förväntade %d check-villkor för tabell "%s" men hittade %d
förväntat format (%d) skiljer sig från formatet som fanns i filen (%d)
misslyckades med riktighetskontroll, hittade inte förälder-OID %u för tabell "%s" (OID %u)
misslyckades med riktighetskontroll, föräldratabell OID %u för pg_rewrite-rad OID %u hittades inte
misslyckades med riktighetskontroll, föräldratabell OID %u för sekvens-OID %u hittades inte
misslyckades med att koppla upp mot databas
filnamnet är för långt: "%s"
fil-offset i dumpfilen är för stort
hittar check-villkor för tabell "%s.%s"
hittar default-uttryck för tabell "%s.%s"
hittar utökningstabeller
hittar arvrelationer
hittar kolumner och typer för tabell "%s.%s"
klar med objekt %d %s %s
klar med parallella huvudloopen
markerar ärvda kolumner i undertabeller
hittade oväntat block-ID (%d) vid läsning av data -- förväntade %d
funktion "%s" hittades inte
identifierar utökningsmedlemmar
implicerad återställning av enbart data
inkomplett tar-huvud hittat (%lu byte)
inkomplett tar-huvud hittat (%lu bytes)
index "%s" hittades inte
indatafilen verkar vara en dump i textformat. Använd psql.
indatafilen verkar inte vara ett korrekt arkiv
indatafilen verkar inte vara ett korrekt arkiv (för kort?)
indatafilen är för kort (läste %lu, förväntade 5)
internt fel -- WriteData kan inte anropas utanför kontexten av en DataDumper-rutin
internt fel -- varken th eller fh angiven i tarReadRaw()
ogiltigt ENCODING-val: %s
ogiltig OID för stort objekt
ogiltig OID för stort objekt (%u)
ogiltigt STDSTRINGS-val: %s
felaktigt adnum-värde %d för tabell "%s"
felaktig argumentsträng (%s) för utlösare "%s" i tabell "%s"
ogiltig binär "%s" ogiltig klientteckenkodning "%s" angiven
ogiltigt kolumnnummer %d för tabell "%s"
ogiltigt kolumnnumrering i tabell "%s"
ogiltig komprimeringskod: %d
ogiltigt beroende %d
ogiltigt dumpId %d
ogiltig rad i stora objekts TOC-fil "%s": "%s"
ogiltigt meddelande mottaget från arbetare: "%s"
felaktigt antal parallella job
ogiltigt utdataformat "%s" angivet
utmatning av stora objekt stöds inte i det valda formatet
sista inbyggda OID är %u
startar objekt %d %s %s
saknar index för integritetsvillkor "%s"
flyttar från position %s till nästa del vid filposition %s
inget objekt är redo
hittade inga matchande scheman
hittade inga matchande scheman för mallen "%s"
hittade inga matchande tabeller
hittade inga matchande tabeller för mallen "%s"
ingen utdatakatalog angiven
ej byggt med zlib-stöd
nu på filposition %s
flaggan --if-exists kräver flaggan -c/--clean
flaggorna --inserts/--column-inserts och -o/--oids kan inte användas tillsammans
flaggorna "nollställ" (-c) och "bara data" (-a) kan inte användas tillsammans
flaggorna "bara schema" (-s) och "bara data" (-a) kan inte användas tillsammans
slut på minne
slut på on_exit_nicely-slottar
parallell arkiverare parallell backup stöds bara med katalogformat
parallell återställning för en icke sökbar fil stöds inte
parallell återställning från standard in stöds inte
parallell återställning stöds inte med arkiv som skapats av en pre-8.0 pg_dump
parallell återställning stöds inte med detta arkivformat
pclose misslyckades: %s pgpipe: kunde inte acceptera anslutning: felkod %d
pgpipe: kunde inte göra "bind": felkod %d
pgpipe: kunde itne ansluta till uttag (socket): felkod %d
pgpipe: kunde inte skapa ett andra uttag (socket): felkod %d
pgpipe: kunde inte skapa uttag (socket): felkod %d
pgpipe: kunde inte göra "listen": felkod %d
pgpipe: getsockname() misslyckades: felkod %d
processar %s
processar data för tabell "%s.%s"
processar objekt %d %s %s
processar saknat objekt %d %s %s
fråga misslyckades: %s fråga producerade null som refererad tabell för främmande nyckel-utlösare "%s" i tabell "%s" (OID för tabell : %u)
fråga gav %d rad istället för en: %s
fråga gav %d rader istället för en: %s
fråga för att hämta data för sekvens "%s" returnerade %d rad (förväntade 1)
fråga för att hämta data för sekvens "%s" returnerade %d rader (förväntade 1)
fråga för att hämta data för sekvens "%s" returnerade namn "%s"
fråga för att hämta regel "%s" för tabell "%s" misslyckades: fel antal rader returnerades
fråga för att hämta definition av vy "%s" returnerade mer än en definition
fråga för att hämta definition av vy "%s" returnerade ingen data
frågan var: %s
läste TOC-post %d (ID %d) för %s %s
läser kolumninfo flr intressanta tabeller
läser integritetsvillkor
läser standardrättigheter
läser beroendedata
läser händelseutlösare
läser utökningar
läser främmande nyckel-villkor för tabell "%s.%s"
läser index
läser index för tabell "%s.%s"
läser stora objekt
läser policys
läser procedurspråk
läser omskrivningsregler
läser säkerhetspolicys på radnivå
läser scheman
läser information om arv av tabeller
läser transformer
läser utlösare
läser utlösare för tabell "%s.%s"
läser typomvandlingar
läser användardefinierade accessmetoder
läser användardefinierade aggregatfunktioner
läser användardefinierade jämförelser
läser användardefinierade konverteringar
läser användardefinierade främmande servrar
läser användardefinierade främmande data-omvandlare
läser användardefinierade funktioner
läser användardefinierade operatorklasser
läser användardefinierade operator-familjer
läser användardefinierade operatorer
läser användardefinierade tabeller
läser användardefinierade textsökkonfigurationer
läser användardefinierade textsökordlistor
läser användardefinierade textsöktolkare
läser användardefinierade textsökmallar
läser användardefinierade typer
återuppkoppling mot databas "%s" misslyckades: %s reducerar beroenden för %d
återställde %d stor objekt
återställde %d stora objekt
dumpa data i oordning stöds inte av detta arkivformat: "%s" krävs, men kommer före "%s" i denna arkivfil.
återställer stort objekt med OID %u
riktighetskontroll på heltalsstorlek (%lu) misslyckades
sparar databasdefinition
sparar kodning = %s
sparar stora objekt
sparar search_path = %s
sparar standard_conforming_strings = %s
schema "%s" hittades inte
schema med OID %u existerar inte
select() misslyckades: %s
serverversionen måste vara minst 7.3 för att man skall kunna använda schemavalflaggorna
server version: %s; %s version: %s
hoppar över objekt %d %s %s
hoppar över tar-medlem %s
sorterare tabell "%s" kunde inte skapas, dess data kommer ej återställas
tabell "%s" hittades inte
tar-arkiverare detta format kan inte läsas
överför beroende %d -> %d till %d
utlösare "%s" hittades inte
oväntad COPY-satssyntax: "%s"
oväntad data-offset-flagga %d
oväntat kommandotyp för policy: "%s"
oväntad sektionskod %d
oväntat tgtype-värde: %d
okänt arkivformat "%s"; vänligen ange "c", "d" eller "t"
okänt kommando mottaget från master: "%s"
oväntad integritetsvillkorstyp: %c
ej igenkänd datablockstyp %d vid återställande av arkiv
känner inte igen datablocktyp (%d) vid genomsökning av arkiv
okänd teckenkodning "%s"
känner inte igen filformat "%d"
okänd objekttyp i standardrättigheter: %d
okänt proparallel-värde för funktion "%s"
okänt provolatile-värde för funktion "%s"
ej supportad version (%d.%d) i filhuvudet
varning från orginaldumpfilen: %s
arbetsprocess misslyckades: felkod %d
skrev %lu byte av stort objekt-data (resultat = %lu)
skrev %lu bytes av stort objekt-data (resultat = %lu)
locale/sv/LC_MESSAGES/libpq5-9.6.mo 0000644 00000054743 14751153420 0012302 0 ustar 00 �� � l
� � �
"
8 ' F ( n � # � � � $ � 9
R 0 ] ( � ( � � � � 5 � 8 3 0 l � $ � # � - % 8 S � � . � ( � , I \ : k " � � � < � a / 0 � ) � ' � * . ? + n ' � ' � * � * + @ * l , � ) � ) � + - D / r + � ( � ) � & ! 5 H 3 ~ & � ! � � + " G v j w � r Y � ! � ' , - T � � # 9 : & t ) � * � # � 9 ) N ' x ) � � ) � " 9 5 . o ' � * � " � " ! . 7! / f! - �! @ �! 2 " ! 8" % Z" % �" & �" V �" = $# ; b# 4 �# 0 �# $ : !$ \$ |$ �$ �$ - �$ -
% ;% + W% 2 �% 7 �% = �% ! ,& . N& 8 }& " �& �& F �& C @' $ �' �' B �' ( ( ; 4( ( p( * �( & �( % �( ! ) 6 3) C j) ? �) 2 �) 1 !* = S* ) �* J �* + + 1+ N+ m+ 1 �+
�+ �+ + �+ , ) #, " M, [ p, �, ? �, 1 %- 8 W- > �- � �- # P. t. : �. � �. 2 N/ Q �/ J �/ K 0 j0 �0 �0 ? �0 ! �0 + 1 @1 Q1 L m1 D �1 % �1 . %2 C T2 �2 $ �2 5 �2 ) 3 � >3 �4 �4 �4 �4 �4 5
#5 % 15 & W5 ~5 �5 �5 �5 �5 �5 6
06 . ;6 # j6 # �6 �6 �6 �6 > �6 A 7 , K7 " x7 % �7 % �7 �7 �7 ) 8 : /8 j8 8 0 �8 �8 % �8 9 $9 5 19 g9 �9 �9 E �9 � �9 / u: / �: ! �: : �: < 2; ; o; / �; ! �; 2 �; 3 0< 3 d< 2 �< 4 �< 1 = 1 2= 3 d= 5 �= 7 �= 3 > 0 :> 1 k> $ �> ; �> @ �> 4 ?? % t? " �? �? �? ! �? s @ ~ �@ { A �A ! �A �A " �A ? B � GB . �B ? &C 4 fC ' �C ) �C $ �C = D . PD / D ) �D �D ( �D $ E = EE / �E ( �E > �E & F ! BF I dF A �F @ �F N 1G 6 �G " �G ) �G , H - 1H ^ _H B �H > I 3 @I . tI �I 9 �I �I ( J ( ?J ( hJ . �J . �J �J +
K / 6K 8 fK ; �K % �K 3 L 8 5L " nL " �L > �L ; �L $ /M TM @ nM �M % �M 9 �M , N / LN $ |N * �N , �N < �N G 6O G ~O 6 �O + �O ? )P * iP G �P �P �P
Q % (Q ( NQ 0 wQ �Q �Q 8 �Q # R 8 $R ! ]R | R �R F S = ZS 6 �S @ �S � T 1 �T �T 8 �T � #U - �U ^ �U X OV a �V
W )W JW M \W ! �W $ �W �W X N X C mX $ �X 0 �X > Y FY ]Y 4 yY 4 �Y } ) � E � f * B 0 W > � H � 6 � T � a i h 2 � � + � P � ' w < � � u 7 �
� M � � ? o l X L � � � � � � � m � � { Z g n � @ � � . � � � � 3 � R S D � � c 9 N J � j G % � � z � � � & � 4 r 1 Q � | : � � I � � � b � Y # x ; ` 8
t e � � y ( � � � � � = ^ - � � � � U V ] $ " � ~ � d � � \ _ p , k � A C [ 5 K � ! � � q s O v � � / � � � F � � at character %s %s %s, %s:%s COLUMN NAME: %s
CONSTRAINT NAME: %s
CONTEXT: %s
COPY IN state must be terminated first
COPY OUT state must be terminated first
COPY terminated by new PQexec Crypt authentication not supported
DATATYPE NAME: %s
DETAIL: %s
GSSAPI authentication not supported
GSSAPI continuation error GSSAPI name import error HINT: %s
IPv6 host address may not be empty in URI: "%s"
Kerberos 4 authentication not supported
Kerberos 5 authentication not supported
LINE %d: LOCATION: NOTICE PGEventProc "%s" failed during PGEVT_CONNRESET event
PGEventProc "%s" failed during PGEVT_RESULTCREATE event
PGresult cannot support more than INT_MAX tuples PGresult is not an error result
PQexec not allowed during COPY BOTH
PQgetline: not doing text COPY OUT
QUERY: %s
SCHEMA NAME: %s
SCM_CRED authentication method not supported
SCRAM authentication requires libpq version 10 or above
SSL SYSCALL error: %s
SSL SYSCALL error: EOF detected
SSL certificate's name contains embedded null
SSL certificate's name entry is missing
SSL connection has been closed unexpectedly
SSL error code %lu SSL error: %s
SSL library does not support CRL certificates (file "%s")
SSPI authentication not supported
SSPI continuation error TABLE NAME: %s
Unix-domain socket path "%s" is too long (maximum %d bytes)
WARNING: password file "%s" has group or world access; permissions should be u=rw (0600) or less
WARNING: password file "%s" is not a plain file
WSAIoctl(SIO_KEEPALIVE_VALS) failed: %ui
another command is already in progress
argument of lo_read exceeds integer range
argument of lo_truncate exceeds integer range
argument of lo_write exceeds integer range
attribute has no values on LDAP lookup
authentication method %u not supported
cannot determine OID of function lo_close
cannot determine OID of function lo_creat
cannot determine OID of function lo_create
cannot determine OID of function lo_lseek
cannot determine OID of function lo_lseek64
cannot determine OID of function lo_open
cannot determine OID of function lo_tell
cannot determine OID of function lo_tell64
cannot determine OID of function lo_truncate
cannot determine OID of function lo_truncate64
cannot determine OID of function lo_unlink
cannot determine OID of function loread
cannot determine OID of function lowrite
certificate could not be obtained: %s
certificate does not match private key file "%s": %s
certificate present, but not private key file "%s"
column number %d is out of range 0..%d command string is a null pointer
connection in wrong state
connection not open
connection pointer is NULL
could not acquire SSPI credentials could not connect to server: %s
Is the server running locally and accepting
connections on Unix domain socket "%s"?
could not connect to server: %s
Is the server running on host "%s" (%s) and accepting
TCP/IP connections on port %s?
could not connect to server: %s
Is the server running on host "%s" and accepting
TCP/IP connections on port %s?
could not create LDAP structure
could not create SSL context: %s
could not create socket: %s
could not establish SSL connection: %s
could not get client address from socket: %s
could not get home directory to locate root certificate file
Either provide the file or change sslmode to disable server certificate verification.
could not get peer credentials: %s
could not get server's host name from server certificate
could not get socket error status: %s
could not initialize SSL engine "%s": %s
could not interpret result from server: %s could not load SSL engine "%s": %s
could not load private SSL key "%s" from engine "%s": %s
could not load private key file "%s": %s
could not look up local user ID %d: %s
could not open certificate file "%s": %s
could not open file "%s": %s
could not read certificate file "%s": %s
could not read from file "%s": %s
could not read private SSL key "%s" from engine "%s": %s
could not read root certificate file "%s": %s
could not receive data from server: %s
could not send SSL negotiation packet: %s
could not send data to server: %s
could not send startup packet: %s
could not set socket to TCP no delay mode: %s
could not set socket to close-on-exec mode: %s
could not set socket to nonblocking mode: %s
could not translate Unix-domain socket path "%s" to address: %s
could not translate host name "%s" to address: %s
could not write to file "%s": %s
definition of service "%s" not found
duplicate GSS authentication request
duplicate SSPI authentication request
end of string reached when looking for matching "]" in IPv6 host address in URI: "%s"
expected authentication request from server, but received %c
extra key/value separator "=" in URI query parameter: "%s"
forbidden value %%00 in percent-encoded value: "%s"
function requires at least protocol version 3.0
host name must be specified
host name must be specified for a verified SSL connection
incomplete multibyte character
insufficient data in "D" message insufficient data in "T" message insufficient data in "t" message integer of size %lu not supported by pqGetInt integer of size %lu not supported by pqPutInt invalid ExecStatusType code invalid LDAP URL "%s": invalid port number
invalid LDAP URL "%s": missing distinguished name
invalid LDAP URL "%s": must have exactly one attribute
invalid LDAP URL "%s": must have search scope (base/one/sub)
invalid LDAP URL "%s": no filter
invalid LDAP URL "%s": scheme must be ldap://
invalid URI propagated to internal parser routine: "%s"
invalid URI query parameter: "%s"
invalid connection option "%s"
invalid connection state %d, probably indicative of memory corruption
invalid connection state, probably indicative of memory corruption
invalid percent-encoded token: "%s"
invalid port number: "%s"
invalid setenv state %c, probably indicative of memory corruption
invalid socket
invalid sslmode value: "%s"
invalid state %c, probably indicative of memory corruption
keepalives parameter must be an integer
length must be given for binary parameter
line %d too long in service file "%s"
local user with ID %d does not exist
lookup on LDAP server failed: %s
lost synchronization with server, resetting connection lost synchronization with server: got message type "%c", length %d
message contents do not agree with length in message type "%c"
message type 0x%02x arrived from server while idle missing "=" after "%s" in connection info string
missing key/value separator "=" in URI query parameter: "%s"
more than one entry found on LDAP lookup
nested service specifications not supported in service file "%s", line %d
no COPY in progress
no SSL error reported no connection to the server
no entry found on LDAP lookup
no error message available
number of parameters must be between 0 and 65535
out of memory out of memory
out of memory allocating GSSAPI buffer (%d) out of memory for query result parameter number %d is out of range 0..%d password retrieved from file "%s"
private key file "%s" has group or world access; permissions should be u=rw (0600) or less
protocol error: id=0x%x
query to initialize large object functions did not return data
received invalid response to SSL negotiation: %c
requirepeer parameter is not supported on this platform
requirepeer specifies "%s", but actual peer user name is "%s"
root certificate file "%s" does not exist
Either provide the file or change sslmode to disable server certificate verification.
row number %d is out of range 0..%d select() failed: %s
server certificate for "%s" does not match host name "%s"
server closed the connection unexpectedly
This probably means the server terminated abnormally
before or while processing the request.
server does not support SSL, but SSL was required
server sent binary data ("B" message) without prior row description ("T" message) server sent data ("D" message) without prior row description ("T" message) server sent data ("D" message) without prior row description ("T" message)
service file "%s" not found
setsockopt(%s) failed: %s
size_t overflow sslmode value "%s" invalid when SSL support is not compiled in
statement name is a null pointer
syntax error in service file "%s", line %d
timeout expired
unexpected asyncStatus: %d
unexpected character "%c" at position %d in URI (expected ":" or "/"): "%s"
unexpected character %c following empty query response ("I" message) unexpected field count in "D" message unexpected message from server during startup
unexpected response from server; first received character was "%c"
unrecognized SSL error code: %d
unrecognized socket error: 0x%08X/%d unterminated quoted string in connection info string
user name lookup failure: error code %lu
Project-Id-Version: PostgreSQL 9.6
Report-Msgid-Bugs-To: pgsql-bugs@postgresql.org
POT-Creation-Date: 2021-11-07 09:48+0000
PO-Revision-Date: 2021-11-07 09:56+0100
Last-Translator: Dennis Björklund <db@zigo.dhs.org>
Language-Team: Swedish <pgsql-translators@postgresql.org>
Language: sv
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Plural-Forms: nplurals=2; plural=n != 1;
vid tecken %s %s %s, %s:%s KOLUMNNAMN: %s
VILLKORSNAMN: %s
KONTEXT: %s
COPY IN-läge måste avslutas först
COPY OUT-läge måste avslutas först
COPY terminerad av ny PQexec Crypt-autentisering stöds ej
DATATYPNAMN: %s
DETALJ: %s
GSSAPI-autentisering stöds ej
GSSAPI fortsättningsfel GSSAPI-fel vid import av namn TIPS: %s
IPv6-värdadress får ej vara tom i URI: "%s"
Kerberos-4-autentisering stöds ej
Kerberos-5-autentisering stöds ej
RAD %d: PLATS: NOTIS PGEventProc "%s" misslyckades under PGEVT_CONNRESET-händelse
PGEventProc "%s" misslyckades under PGEVT_RESULTCREATE-händelse
PGresult stöder inte mer än INT_MAX tupler PGresult är inte ett felresultat
PQexec tillåts inte under COPY BOTH
PQgetline: utför inte text-COPY OUT
FRÅGA: %s
SCHEMANAMN: %s
autentiseringsmetoden SCM_CRED stöds ej
SCRAM-autentisering kräver libpq version 10 eller högre
SSL SYSCALL fel: %s
SSL SYSCALL-fel: EOF upptäckt
SSL-certifikatets namn innehåller null-värden
SSL-certifikatets namn saknas
SSL-anslutning har oväntat stängts
SSL-felkod %lu SSL-fel: %s
SSL-bibliotek stöder inte CRL-certifikat (fil "%s")
SSPI-autentisering stöds ej
SSPI fortsättningsfel TABELLNAMN: %s
Sökväg till unixdomänuttag "%s" är för lång (maximalt %d byte)
VARNING: lösenordsfilen "%s" har läsrättigheter för gruppen eller världen; rättigheten skall vara u=rw (0600) eller mindre
FEL: lösenordsfil "%s" är inte en vanlig fil
WSAIoctl(SIO_KEEPALIVE_VALS) misslyckades: %ui
ett annat kommando pågår redan
ett argument till lo_read överskriver heltalsintervallet
argumentet till lo_truncate överskrider heltalsintervallet
ett argument till lo_write överskriver heltalsintervallet
attributet har inga värden i LDAP-uppslagning
autentiseringsmetod %u stöds ej
kan inte ta reda på OID för funktionen lo_close
kan inte ta reda på OID för funktionen lo_create
kan inte ta reda på OID för funktionen lo_create
kan inte ta reda på OID för funktionen lo_lseek
kan inte ta reda på OID för funktionen lo_lseek64
kan inte ta reda på OID för funktionen lo_open
kan inte ta reda på OID för funktionen lo_tell
kan inte ta reda på OID för funktionen lo_tell64
kan inte ta reda på OID för funktionen lo_truncate
kan inte ta reda på OID för funktionen lo_truncate64
kan inte ta reda på OID för funktionen lo_unlink
kan inte ta reda på OID för funktionen loread
kan inte ta reda på OID för funktionen lowrite
certifikatet kunde inte hämtas: %s
certifikatet matchar inte den privata nyckelfilen "%s": %s
certifikat tillgängligt, men inte den privata nyckelfilen "%s"
kolumnnummer %d är utanför giltigt intervall 0..%d kommandosträngen är en null-pekare
anslutning i felaktigt tillstånd
anslutningen är inte öppen
anslutningspekare är NULL
kunde inte hämta SSPI-referenser kan inte ansluta till servern: %s
Kör servern på lokalt och accepterar den
anslutningar på Unix-uttaget "%s"?
kunde inte ansluta till servern: %s
Kör servern på värden "%s" (%s) och accepterar
den TCP/IP-uppkopplingar på port %s?
kunde inte ansluta till servern: %s
Kör servern på värden "%s" och accepterar
den TCP/IP-uppkopplingar på porten %s?
kunde inte skapa LDAP-struktur
kan inte skapa SSL-omgivning: %s
kan inte skapa uttag: %s
kan inte skapa SSL-anslutning: %s
kunde inte få tag på klientadressen från uttag (socket): %s
kunde inte hämta hemkatalogen för att lokalisera root-certifikatfilen
Antingen tillhandahåll filen eller ändra sslmode för att stänga av serverns certifikatverifiering.
kunde inte hämta andra sidans referenser: %s
kan inte hämta ut serverns värdnamn från servercertifikatet
kunde inte hämta felstatus för uttag (socket): %s
kunde inte initiera SSL-motor "%s": %s
kunde inte tolka svaret från servern: %s kunde inte ladda SSL-motor "%s": %s
kunde inte ladda privat SSL-nyckel "%s" från motor "%s": %s
kunde inte ladda privata nyckelfilen "%s": %s
kunde inte slå upp lokalt användar-id %d: %s
kunde inte öppna certifikatfil "%s": %s
kan inte öppna fil "%s": %s
kunde inte läsa certifikatfil "%s": %s
kunde inte läsa från fil "%s": %s
kunde inte läsa privat SSL-nyckel "%s" från motor "%s": %s
kunde inte läsa root-certifikatfilen "%s": %s
kan inte ta emot data från servern: %s
kunde inte skicka SSL-paket för uppkopplingsförhandling: %s
kan inte skicka data till servern: %s
kan inte skicka startpaketet: %s
kunde inte sätta uttag (socket) till läget TCP-ingen-fördröjning: %s
kunde inte ställa in uttag (socket) i "close-on-exec"-läge: %s
kunde inte sätta uttag (socket) till ickeblockerande läge: %s
kunde inte översätta sökväg till unix-uttag (socket) "%s" till adress: %s
kunde inte översätta värdnamn "%s" till adress: %s
kan inte skriva till fil "%s": %s
definition av service "%s" hittades inte
duplicerad autentiseringsbegäran från GSS
duplicerad autentiseringsbegäran från SSPI
nådde slutet på strängen när vi letade efter matchande "]" i IPv6-värdadress i URI: "%s"
förväntade autentiseringsförfrågan från servern, men fick %c
extra nyckel/värde-separator "=" i URI-frågeparameter: "%s"
förbjudet värde %%00 i procentkodat värde: "%s"
funktionen kräver minst protokollversion 3.0
värdnamn måste anges
värdnamn måste anges för en verifierad SSL-anslutning
ofullständigt multibyte-tecken
otillräckligt med data i "D"-meddelande otillräckligt med data i "T"-meddelande otillräckligt med data i "t"-meddelande heltal med storlek %lu stöds inte av pqGetInt heltal med storlek %lu stöds inte av pqPutInt ogiltig ExecStatusType-kod ogiltig LDAP URL "%s": ogiltigt portnummer
ogiltig LDAP URL "%s": saknar urskiljbart namn
ogiltig LDAP URL "%s": måste finnas exakt ett attribut
ogiltig LDAP URL "%s": måste ha sök-scope (base/one/sub)
ogiltigt LDAP URL "%s": inget filter
ogiltig LDAP URL "%s": schemat måste vara ldap://
ogiltig URI propagerad till intern parsningsrutin: "%s"
ogiltig URI-frågeparameter: "%s"
ogiltig anslutningsparameter "%s"
ogiltigt tillstånd %d i anslutning, antagligen korrupt minne
ogiltigt tillstånd i anslutning, antagligen korrupt minne
ogiltigt procent-kodad symbol: "%s"
ogiltigt portnummer "%s"
ogiltigt setenv-tillstånd %c, indikerar troligen ett minnesfel
ogiltigt uttag
ogiltigt värde för ssl-läge: "%s"
ogiltigt tillstånd %c, indikerar troligen ett minnesfel
keepalives-parameter måste vara ett heltal
längden måste anges för en binär parameter
rad %d för lång i servicefil "%s"
lokal användare med ID %d existerar inte
uppslagning av LDAP-server misslyckades: %s
tappade synkronisering med servern, startar o, uppkopplingen tappade synkronisering med servern: fick meddelandetyp "%c", längd %d
meddelandeinnehåll stämmer inte med längden för meddelandetyp "%c"
meddelandetyp 0x%02x kom från server under viloperiod "=" efter "%s" saknas i anslutningssträng
saknar nyckel/värde-separator "=" i URI-frågeparameter: "%s"
mer än en post hittad i LDAP-uppslagning
nästlade servicespecifikationer stöds inte i servicefil "%s", rad %d
ingen COPY pågår
inget SSL-fel rapporterat inte förbunden till servern
ingen post hittad i LDAP-uppslagning
inget felmeddelande finns tillgängligt
antal parametrar måste bara mellan 0 och 65535
slut på minne slut på minne
slut på minne vid allokering av buffer till GSSAPI (%d) slut på minnet för frågeresultat parameter nummer %d är utanför giltigt intervall 0..%d lösenord hämtat från fil "%s"
privata nyckelfilen "%s" har läsrättigheter för gruppen eller världen; rättigheten skall vara u=rw (0600) eller mindre
protokollfel: id=0x%x
fråga för att initiera stort objekt-funktion returnerade ingen data
tog emot ogiltigt svar till SSL-uppkopplingsförhandling: %c
requirepeer-parameter stöds inte på denna plattform
requirepeer anger "%s", men andra sidans användarnamn är "%s"
root-certifikatfilen "%s" finns inte
Antingen tillhandahåll filen eller ändra sslmode för att stänga av serverns certifikatverifiering.
radnummer %d är utanför giltigt intervall 0..%d select() misslyckades: %s
servercertifikat för "%s" matchar inte värdnamn "%s"
servern stängde oväntat ner uppkopplingen
Troligen så terminerade servern pga något fel antingen
innan eller under tiden den bearbetade en förfrågan.
SSL stöds inte av servern, men SSL krävdes
servern skickade binärdata (meddelande "B") utan föregående radbeskrivning (meddelande "T") servern skickade data (meddelande "D") utan föregående radbeskrivning (meddelande "T") servern skickade data (meddelande "D") utan att först skicka en radbeskrivning (meddelande "T")
servicefil "%s" hittades inte
setsockopt(%s) misslyckades: %s
size_t-överspill värde för ssl-läge, "%s", är ogiltigt när SSL-stöd inte kompilerats in
satsens namn är en null-pekare
syntaxfel i servicefel "%s", rad %d
timeout utgången
oväntad asyncStatus: %d
oväntat tecken "%c" vid position %d i URI (förväntade ":" eller "/"): "%s"
oväntat tecken %c följer på ett tomt frågesvar (meddelande "I") oväntat fältantal i "D"-meddelande oväntat meddelande från servern under starten
oväntat svar för servern; första mottagna tecknet var "%c"
okänd SSL-felkod: %d
okänt uttagsfel: 0x%08X/%d icke terminerad sträng i uppkopplingsinformationen
misslyckad sökning efter användarnamn: felkod %lu
locale/ko/LC_MESSAGES/pg_ctl-9.6.mo 0000644 00000046270 14751153420 0012333 0 ustar 00 �� � � � < P D Q ? � � � &
0
P
- o
�
�
= �
! � A � a � K P � A � ! � 3 ? O H � D � C E a ? � ? � > ' 9 f L � B � E 0 � v 0 � F , > s 8 � I � % 5 2 [ O � 7 � & M 8 - � ! � > � E C [ y � 9 D S C � D � > ! A ` ( � , � 2 � 6 + > b * � / � % � 1 " 0 T # � � 4 � 2 � 1 / 0 a , � . � 3 � " + B 1 n 6 � : � 1 * D " o 7 � " � $ � J ] y 3 � 0 � � ! $ 6 [ - | � 4 � % � $ %! " J! ! m! F �! u �! F L" �" 7 �" ) �" k # ` u# % �# & �# #$ d +$ �$ / �$ & �$ 0 % . 7% ) f% ) �% �% �% & �%
& , +& ( X& �& ! �& �& �& �& �& ' "' 8' I' Y' j' z' " �' �' � �' O g) V �) < * K* ' _* 4 �* 4 �* , �* + 5+ J L+ ! �+ - �+ � �+ - �, l �, [ &- ( �- M �- % �- > . c ^. L �. A / M Q/ > �/ > �/ H 0 8 f0 E �0 ` �0 L F1 M �1 � �1 4 v2 Y �2 A 3 > G3 W �3 �3 W �3 b R4 N �4 5
5 5 b 05 ? �5 $ �5 I �5 N B6 T �6 � �6 L �7 O 8 l g8 _ �8 o 49 K �9 5 �9 3 &: J Z: = �: I �: = -; @ k; * �; = �; 8 < * N< % y< > �< J �< H )= 9 r= 5 �= 7 �= I > ( d> 6 �> > �> O ? J S? F �? ( �? @ Z ,@ ! �@ 7 �@ U �@ 5 7A # mA ? �A E �A " B ' :B 2 bB 1 �B 7 �B . �B 4 .C & cC ! �C $ �C % �C c �C � [D J E dE @ �E 1 �E � �E � �F 6 *G * aG �G � �G 2 "H 6 UH 8 �H ? �H ; I 4 AI = vI �I �I = �I * 0J 1 [J ) �J - �J * �J " K 3K EK ( WK + �K �K + �K �K L L $ 2L . WL 1 �L ? L y ' { � V r � & $ o @ � � P b [ - C U � " ( _ . � ; X Y ! 6 � A B = / w � % 7 E K
v
J q c M , ~ # 3 ) 0 W � F s � ] 1 ` u } � � � h � f x m t d : z j � * g S O 9 Q D < G I 4 > 2 5 N Z � | l ^ p i + a H R n 8 � e � � T \ k
%s: -w option cannot use a relative socket directory specification
%s: -w option is not supported when starting a pre-9.1 server
Allowed signal names for kill:
Common options:
Options for register and unregister:
Options for start or restart:
Options for stop or restart:
Report bugs to <pgsql-bugs@postgresql.org>.
Shutdown modes are:
Start types are:
%s init[db] [-D DATADIR] [-s] [-o "OPTIONS"]
%s kill SIGNALNAME PID
%s promote [-D DATADIR] [-s]
%s register [-N SERVICENAME] [-U USERNAME] [-P PASSWORD] [-D DATADIR]
[-S START-TYPE] [-w] [-t SECS] [-o "OPTIONS"]
%s reload [-D DATADIR] [-s]
%s restart [-w] [-t SECS] [-D DATADIR] [-s] [-m SHUTDOWN-MODE]
[-o "OPTIONS"]
%s start [-w] [-t SECS] [-D DATADIR] [-s] [-l FILENAME] [-o "OPTIONS"]
%s status [-D DATADIR]
%s stop [-W] [-t SECS] [-D DATADIR] [-s] [-m SHUTDOWN-MODE]
%s unregister [-N SERVICENAME]
-?, --help show this help, then exit
-D, --pgdata=DATADIR location of the database storage area
-N SERVICENAME service name with which to register PostgreSQL server
-P PASSWORD password of account to register PostgreSQL server
-S START-TYPE service start type to register PostgreSQL server
-U USERNAME user name of account to register PostgreSQL server
-V, --version output version information, then exit
-W do not wait until operation completes
-c, --core-files allow postgres to produce core files
-c, --core-files not applicable on this platform
-e SOURCE event source for logging when running as a service
-l, --log=FILENAME write (or append) server log to FILENAME
-m, --mode=MODE MODE can be "smart", "fast", or "immediate"
-o OPTIONS command line options to pass to postgres
(PostgreSQL server executable) or initdb
-p PATH-TO-POSTGRES normally not necessary
-s, --silent only print errors, no informational messages
-t, --timeout=SECS seconds to wait when using -w option
-w wait until operation completes
auto start service automatically during system startup (default)
demand start service on demand
fast quit directly, with proper shutdown
immediate quit without complete shutdown; will lead to recovery on restart
smart quit after all clients have disconnected
done
failed
stopped waiting
%s is a utility to initialize, start, stop, or control a PostgreSQL server.
%s: -S option not supported on this platform
%s: PID file "%s" does not exist
%s: WARNING: cannot create restricted tokens on this platform
%s: WARNING: could not locate all job object functions in system API
%s: another server might be running; trying to start server anyway
%s: cannot be run as root
Please log in (using, e.g., "su") as the (unprivileged) user that will
own the server process.
%s: cannot promote server; server is not in standby mode
%s: cannot promote server; single-user server is running (PID: %ld)
%s: cannot reload server; single-user server is running (PID: %ld)
%s: cannot restart server; single-user server is running (PID: %ld)
%s: cannot set core file size limit; disallowed by hard limit
%s: cannot stop server; single-user server is running (PID: %ld)
%s: could not access directory "%s": %s
%s: could not allocate SIDs: error code %lu
%s: could not create promote signal file "%s": %s
%s: could not create restricted token: error code %lu
%s: could not determine the data directory using command "%s"
%s: could not find own program executable
%s: could not find postgres program executable
%s: could not open PID file "%s": %s
%s: could not open process token: error code %lu
%s: could not open service "%s": error code %lu
%s: could not open service manager
%s: could not read file "%s"
%s: could not register service "%s": error code %lu
%s: could not remove promote signal file "%s": %s
%s: could not send promote signal (PID: %ld): %s
%s: could not send reload signal (PID: %ld): %s
%s: could not send signal %d (PID: %ld): %s
%s: could not send stop signal (PID: %ld): %s
%s: could not start server
Examine the log output.
%s: could not start server: %s
%s: could not start server: error code %lu
%s: could not start service "%s": error code %lu
%s: could not unregister service "%s": error code %lu
%s: could not wait for server because of misconfiguration
%s: could not write promote signal file "%s": %s
%s: database system initialization failed
%s: directory "%s" does not exist
%s: directory "%s" is not a database cluster directory
%s: invalid data in PID file "%s"
%s: missing arguments for kill mode
%s: no database directory specified and environment variable PGDATA unset
%s: no operation specified
%s: no server running
%s: old server process (PID: %ld) seems to be gone
%s: option file "%s" must have exactly one line
%s: server does not shut down
%s: server is running (PID: %ld)
%s: service "%s" already registered
%s: service "%s" not registered
%s: single-user server is running (PID: %ld)
%s: the PID file "%s" is empty
%s: too many command-line arguments (first is "%s")
%s: unrecognized operation mode "%s"
%s: unrecognized shutdown mode "%s"
%s: unrecognized signal name "%s"
%s: unrecognized start type "%s"
(The default is to wait for shutdown, but not for start or restart.)
HINT: The "-m fast" option immediately disconnects sessions rather than
waiting for session-initiated disconnection.
If the -D option is omitted, the environment variable PGDATA is used.
Is server running?
Please terminate the single-user server and try again.
Server started and accepting connections
The program "%s" is needed by %s but was not found in the
same directory as "%s".
Check your installation.
The program "%s" was found by "%s"
but was not the same version as %s.
Check your installation.
Timed out waiting for server startup
Try "%s --help" for more information.
Usage:
WARNING: online backup mode is active
Shutdown will not complete until pg_stop_backup() is called.
Waiting for server startup...
cannot duplicate null pointer (internal error)
child process exited with exit code %d child process exited with unrecognized status %d child process was terminated by exception 0x%X child process was terminated by signal %d child process was terminated by signal %s command not executable command not found could not change directory to "%s": %s could not find a "%s" to execute could not get current working directory: %s
could not identify current directory: %s could not read binary "%s" could not read symbolic link "%s" invalid binary "%s" out of memory
pclose failed: %s server is still starting up
server promoting
server shutting down
server signaled
server started
server starting
server stopped
starting server anyway
waiting for server to shut down... waiting for server to start... Project-Id-Version: PostgreSQL 9.6
Report-Msgid-Bugs-To: pgsql-bugs@postgresql.org
POT-Creation-Date: 2016-09-26 14:02+0900
PO-Revision-Date: 2016-09-26 17:02+0900
Last-Translator: Ioseph Kim <ioseph@uri.sarang.net>
Language-Team: Korean <pgsql-kr@postgresql.kr>
Language: ko
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Plural-Forms: nplurals=1; plural=0;
%s: -w 옵션은 소켓 디렉터리로 상대 경로를 사용할 수 없음
%s: -w 옵션은 9.1 이전 버전의 서버를 실행할 때는 지원하지 않음
사용할 수 있는 중지용(for kill) 시그널 이름:
일반 옵션들:
서비스 등록/제거용 옵션들:
start, restart 때 사용할 수 있는 옵션들:
stop, restart 때 사용 할 수 있는 옵션들:
오류보고: <pgsql-bugs@postgresql.org>.
중지방법 설명:
시작형태 설명:
%s init[db] [-D 데이터디렉터리] [-s] [-o "옵션"]
%s kill 시그널이름 PID
%s promote [-D 데이터디렉터리] [-s]
%s register [-N 서비스이름] [-U 사용자이름] [-P 암호] [-D 데이터디렉터리]
[-S 시작형태] [-w] [-t 초] [-o "옵션"]
%s reload [-D 데이터디렉터리] [-s]
%s restart [-w] [-t 초] [-D 데이터디렉터리] [-s] [-m 중지모드]
[-o "옵션"]
%s start [-w] [-t 초] [-D 데이터디렉터리] [-s] [-l 로그파일] [-o "옵션"]
%s status [-D 데이터디렉터리]
%s stop [-W] [-t 초] [-D 데이터디렉터리] [-s] [-m 중지모드]
%s unregister [-N 서비스이름]
-?, --help 이 도움말을 보여주고 마침
-D, --pgdata=데이터디렉터리 데이터베이스 자료가 저장되어있는 디렉터리
-N SERVICENAME 서비스 목록에 등록될 PostgreSQL 서비스 이름
-P PASSWORD 이 서비스를 실행할 사용자의 암호
-S 시작형태 서비스로 등록된 PostgreSQL 서버 시작 방법
-U USERNAME 이 서비스를 실행할 사용자 이름
-V, --version 버전 정보를 보여주고 마침
-W 작업이 끝날 때까지 기다리지 않음
-c, --core-files 코어 덤프 파일을 만듬
-c, --core-files 이 플랫폼에서는 사용할 수 없음
-e SOURCE 서비스가 실행 중일때 쌓을 로그를 위한 이벤트 소스
-l, --log=로그파일 서버 로그를 이 로그파일에 기록함
-m, --mode=모드 모드는 "smart", "fast", "immediate" 중 하나
-o 옵션들 PostgreSQL 서버프로그램인 postgres나 initdb
명령에서 사용할 명령행 옵션들
-p PATH-TO-POSTGRES 보통은 필요치 않음
-s, --silent 일반적인 메시지는 보이지 않고, 오류만 보여줌
-t, --timeout=초 -w 옵션 사용 시 대기 시간(초)
-w 작업이 끝날 때까지 기다림
auto 시스템이 시작되면 자동으로 서비스가 시작됨 (초기값)
demand 수동 시작
fast 클라이언트의 연결을 강제로 끊고 정상적으로 중지 됨
immediate 그냥 무조건 중지함; 다시 시작할 때 복구 작업을 할 수도 있음
smart 모든 클라이언트의 연결이 끊기게 되면 중지 됨
완료
실패
중지 기다리는 중
%s 프로그램은 PostgreSQL 서버를 초기화, 시작, 중지, 제어하는 도구입니다.
%s: -S 옵션은 이 운영체제에서는 지원하지 않음
%s: "%s" PID 파일이 없습니다
%s: 경고: 이 운영체제에서 restricted token을 만들 수 없음
%s: 경고: 시스템 API에서 모든 job 객체 함수를 찾을 수 없음
%s: 다른 서버가 가동 중인 것 같음; 어째든 서버 가동을 시도함
%s: root로 이 프로그램을 실행하지 마십시오
시스템관리자 권한이 없는, 서버프로세스의 소유주가 될 일반 사용자로
로그인 해서("su", "runas" 같은 명령 이용) 실행하십시오.
%s: 운영서버 전환 실패; 서버가 대기 모드로 상태가 아님
%s: 운영서버 전환 실패; 단일사용자 서버가 실행 중(PID: %ld)
%s: 서버 환경설정을 다시 불러올 수 없음; 단일 사용자 서버가 실행 중임 (PID: %ld)
%s: 서버를 다시 시작 할 수 없음; 단일사용자 서버가 실행 중임 (PID: %ld)
%s: 코어 파일 크기 한도를 설정할 수 없음, 하드 디스크 용량 초과로 허용되지 않음
%s: 서버 중지 실패; 단일 사용자 서버가 실행 중 (PID: %ld)
%s: "%s" 디렉터리에 액세스할 수 없음: %s
%s: SID를 할당할 수 없음: 오류 코드 %lu
%s: 운영전환 시그널 파일인 "%s" 파일을 만들 수 없음: %s
%s: restricted token을 만들 수 없음: 오류 코드 %lu
%s: "%s" 명령에서 사용할 데이터 디렉터리를 알 수 없음
%s: 실행 가능한 프로그램을 찾을 수 없습니다
%s: 실행 가능한 postgres 프로그램을 찾을 수 없음
%s: "%s" PID 파일을 열 수 없음: %s
%s: 프로세스 토큰을 열 수 없음: 오류 코드 %lu
%s: "%s" 서비스를 열 수 없음: 오류 코드 %lu
%s: 서비스 관리자를 열 수 없음
%s: "%s" 파일을 읽을 수 없음
%s: "%s" 서비스를 등록할 수 없음: 오류 코드 %lu
%s: 운영전환 시그널 파일인 "%s" 파일을 지울 수 없음: %s
%s: 운영전환 시그널을 서버(PID: %ld)로 보낼 수 없음: %s
%s: reload 시그널을 보낼 수 없음 (PID: %ld): %s
%s: %d 시그널을 보낼 수 없음 (PID: %ld): %s
%s: stop 시그널을 보낼 수 없음 (PID: %ld): %s
%s: 서버를 시작 할 수 없음
로그 출력을 살펴보십시오.
%s: 서버를 시작 할 수 없음: %s
%s: 서버를 시작할 수 없음: 오류 코드 %lu
%s: "%s" 서비스를 시작할 수 없음: 오류 코드 %lu
%s: "%s" 서비스를 서비스 목록에서 뺄 수 없음: 오류 코드 %lu
%s: 잘못된 환경 설정 때문에 대기를 더 이상 할 수 없음
%s: 운영전환 시그널 파일인 "%s" 파일에 쓰기 실패: %s
%s: 데이터베이스 초기화 실패
%s: "%s" 디렉터리 없음
%s: 지정한 "%s" 디렉터리는 데이터베이스 클러스트 디렉터리가 아님
%s: "%s" PID 파일이 비었음
%s: kill 작업에 필요한 인수가 빠졌습니다
%s: -D 옵션도 없고, PGDATA 환경변수값도 지정되어 있지 않습니다.
%s: 수행할 작업을 지정하지 않았습니다
%s: 가동 중인 서버가 없음
%s: 이전 서버 프로세스(PID: %ld)가 없어졌습니다
%s: "%s" 환경설정파일은 반드시 한 줄을 가져야한다?
%s: 서버를 멈추지 못했음
%s: 서버가 실행 중임 (PID: %ld)
%s: "%s" 서비스가 이미 등록 되어 있음
%s: "%s" 서비스가 등록되어 있지 않음
%s: 단일사용자 서버가 실행 중임 (PID: %ld)
%s: "%s" PID 파일에 내용이 없습니다
%s: 너무 많은 명령행 인수들 (시작 "%s")
%s: 알 수 없는 작업 모드 "%s"
%s: 잘못된 중지 방법 "%s"
%s: 잘못된 시그널 이름 "%s"
%s: 알 수 없는 시작형태 "%s"
(기본 설정은 중지 할 때는 기다리고, 시작이나 재시작할 때는 안 기다림.)
힌트: "-m fast" 옵션을 사용하면 접속한 세션들을 즉시 정리합니다.
이 옵션을 사용하지 않으면 접속한 세션들 스스로 끊을 때까지 기다립니다.
-D 옵션을 사용하지 않으면, PGDATA 환경변수값을 사용함.
서버가 실행 중입니까?
단일 사용자 서버를 멈추고 다시 시도하십시오.
서버가 시작되었으며 연결을 허용함
"%s" 프로그램은 %s 에서 필요로 합니다. 그런데, 이 파일이
"%s" 디렉터리 안에 없습니다.
설치 상태를 확인해 주십시오.
"%s" 프로그램을 "%s" 에서 필요해서 찾았지만 이 파일은
%s 버전과 같지 않습니다.
설치 상태를 확인해 주십시오.
서버 시작을 기다리는 동안 시간 초과됨
보다 자세한 사용법은 "%s --help"
사용법:
경고: 온라인 백업 모드가 활성 상태입니다.
pg_stop_backup()이 호출될 때까지 종료가 완료되지 않습니다.
서버를 시작하기 위해 기다리는 중...
null 포인터를 복제할 수 없음(내부 오류)
하위 프로세스가 종료되었음, 종료 코드 %d 하위 프로세스가 종료되었음, 알수 없는 상태 %d 0x%X 예외처리로 하위 프로세스가 종료되었음 하위 프로세스가 종료되었음, 시그널 %d %s 시그널 감지로 하위 프로세스가 종료되었음 명령을 실행할 수 없음 명령어를 찾을 수 없음 "%s" 이름의 디렉터리로 이동할 수 없습니다: %s 실행할 "%s" 파일을 찾을 수 없음 현재 작업 디렉터리를 알 수 없음: %s
현재 디렉터리를 알 수 없음: %s "%s" 바이너리 파일을 읽을 수 없음 "%s" 심벌릭 링크를 읽을 수 없음 잘못된 바이너리 파일 "%s" 메모리 부족
pclose 실패: %s 서버가 여전히 시작 중입니다
서버를 운영 모드로 전환합니다
서버를 멈춥니다
서버가 시스템 시그널을 받았음
서버 시작됨
서버를 시작합니다
서버 멈추었음
어째든 서버를 시작합니다
서버를 멈추기 위해 기다리는 중... 서버를 시작하기 위해 기다리는 중... locale/ko/LC_MESSAGES/libpq5-9.6.mo 0000644 00000060127 14751153420 0012254 0 ustar 00 �� � � � P Q b e j p �
� ' � ( � � # 9 M $ Z �
� 0 � ( � ( @ J V 5 ] 8 � � $ � # 6 B - T � � . � ( � , ? R : a " � � � < � a % 0 � ) � ' � *
. 5 + d ' � ' � * � * + 6 * b , � ) � ) � + - : / h + � ( � ) � & 5 > 3 t & � ! � � ! " = ` v } w � r l � ! " ' ? - g � � > ) # h 9 � & � ) � * # B 9 f ) � ' � ) � ) : " d 9 � . � ' � * ! " C! " f! . �! / �! - �! @ " 2 W" ! �" % �" % �" V �" = O# ; �# �# �# $ 4 &$ 0 [$ �$ : �$ �$ % %% - F% - t% �% + �% 2 �% 7 & = U& ! �& . �& 8 �& " ' @' F `' C �' $ �' ( B +( n( ~( ; �( ( �( * ) & +) % R) ! x) 6 �) C �) ? * 2 U* 1 �* = �* ) �* J "+ m+ �+ �+ �+ �+ 1 �+
", 0, + ?, k, ) �, " �, [ �, 3- ? L- 1 �- 8 �- > �- � 6. # �. �. : �. � +/ 2 �/ Q �/ J :0 K �0 �0 $ �0 % 1 # 91 $ ]1 % �1 ? �1 ! �1 +
2 62 G2 L c2 D �2 % �2 . 3 C J3 �3 $ �3 5 �3 )
4 � 44 �5 �5 �5 �5 �5 �5 6 & "6 ' I6 : q6 ( �6 �6 �6 % �6 %7 ! :7 \7 8 i7 0 �7 0 �7 8
8 8 D 8 ? c8 $ �8 7 �8 2 9 39 @9 . W9 �9 " �9 1 �9 , �9 ) : J: `: J p: # �: �: �: Q ; � [; ; �; ) < 0 J< 7 {< ; �< 8 �< * (= ( S= 0 |= 1 �= 1 �= 0 > + B> / n> / �> * �> 2 �> . ,? 1 [? . �? / �? + �? > @ 8 W@ - �@ # �@ �@ �@ A * .A YA � rA � B � �B ! =C % _C �C ' �C = �C � D G �D 0 E D @E . �E 4 �E < �E 1 &F D XF ; �F 7 �F + G " =G / `G % �G D �G 6 �G 2 2H + eH - �H ' �H = �H ; %I 9 aI X �I G �I " <J + _J �J ] �J 2 K S 9K ( �K ( �K ( �K ; L J DL % �L J �L + M + ,M ( XM A �M A �M N 3 %N 7 YN > �N G �N ' O 8 @O * yO + �O �O B �O > 1P + pP �P H �P Q Q ; 3Q 6 oQ U �Q = �Q :R % YR 9 R J �R K S H PS : �S S �S @ (T G iT �T �T " �T ' U % <U F bU �U �U / �U / �U 6 ,V . cV ~ �V W X /W : �W G �W \ X � hX 2 Y AY Z VY � �Y K iZ i �Z \ [ ] |[ + �[ $ \ % +\ # Q\ $ u\ % �\ w �\ ? 8] > x] �] ( �] v �] W f^ 0 �^ B �^ \ 2_ % �_ & �_ G �_ 2 $` � � ~ l � ? � N � m , K f � d � F > � s ( � k T � 2 � � a � � - E � S # � 3 Y t �
* � � � � Q 5 4 � � y � � R 8 9 / [ J � + � Z w ` r n � � � I L % � � x
b � 6 1 � � � � � ; ^ ! : � � � V c D & � \ p u P M � � � 7 � } q � � o � � H � @ v " U | W � B � C � 0 � h � $ i � _ � � . � � � � X < � g e = ' � � � � � ) � { G z � A ] j � � � O � � � � � at character %s %s %s, %s:%s COLUMN NAME: %s
CONSTRAINT NAME: %s
CONTEXT: %s
COPY IN state must be terminated first
COPY OUT state must be terminated first
COPY terminated by new PQexec Crypt authentication not supported
DATATYPE NAME: %s
DETAIL: %s
GSSAPI authentication not supported
GSSAPI continuation error GSSAPI name import error HINT: %s
IPv6 host address may not be empty in URI: "%s"
Kerberos 4 authentication not supported
Kerberos 5 authentication not supported
LINE %d: LOCATION: NOTICE PGEventProc "%s" failed during PGEVT_CONNRESET event
PGEventProc "%s" failed during PGEVT_RESULTCREATE event
PGresult is not an error result
PQexec not allowed during COPY BOTH
PQgetline: not doing text COPY OUT
QUERY: %s
SCHEMA NAME: %s
SCM_CRED authentication method not supported
SSL SYSCALL error: %s
SSL SYSCALL error: EOF detected
SSL certificate's name contains embedded null
SSL certificate's name entry is missing
SSL connection has been closed unexpectedly
SSL error code %lu SSL error: %s
SSL library does not support CRL certificates (file "%s")
SSPI authentication not supported
SSPI continuation error TABLE NAME: %s
Unix-domain socket path "%s" is too long (maximum %d bytes)
WARNING: password file "%s" has group or world access; permissions should be u=rw (0600) or less
WARNING: password file "%s" is not a plain file
WSAIoctl(SIO_KEEPALIVE_VALS) failed: %ui
another command is already in progress
argument of lo_read exceeds integer range
argument of lo_truncate exceeds integer range
argument of lo_write exceeds integer range
attribute has no values on LDAP lookup
authentication method %u not supported
cannot determine OID of function lo_close
cannot determine OID of function lo_creat
cannot determine OID of function lo_create
cannot determine OID of function lo_lseek
cannot determine OID of function lo_lseek64
cannot determine OID of function lo_open
cannot determine OID of function lo_tell
cannot determine OID of function lo_tell64
cannot determine OID of function lo_truncate
cannot determine OID of function lo_truncate64
cannot determine OID of function lo_unlink
cannot determine OID of function loread
cannot determine OID of function lowrite
certificate could not be obtained: %s
certificate does not match private key file "%s": %s
certificate present, but not private key file "%s"
column number %d is out of range 0..%d command string is a null pointer
connection in wrong state
connection not open
connection pointer is NULL
could not acquire SSPI credentials could not acquire mutex: %s
could not connect to server: %s
Is the server running locally and accepting
connections on Unix domain socket "%s"?
could not connect to server: %s
Is the server running on host "%s" (%s) and accepting
TCP/IP connections on port %s?
could not connect to server: %s
Is the server running on host "%s" and accepting
TCP/IP connections on port %s?
could not create LDAP structure
could not create SSL context: %s
could not create socket: %s
could not establish SSL connection: %s
could not get client address from socket: %s
could not get home directory to locate root certificate file
Either provide the file or change sslmode to disable server certificate verification.
could not get home directory to locate service definition file could not get peer credentials: %s
could not get server's host name from server certificate
could not get socket error status: %s
could not initialize SSL engine "%s": %s
could not interpret result from server: %s could not load SSL engine "%s": %s
could not load private SSL key "%s" from engine "%s": %s
could not load private key file "%s": %s
could not look up local user ID %d: %s
could not open certificate file "%s": %s
could not open file "%s": %s
could not read certificate file "%s": %s
could not read from file "%s": %s
could not read private SSL key "%s" from engine "%s": %s
could not read root certificate file "%s": %s
could not receive data from server: %s
could not send SSL negotiation packet: %s
could not send data to server: %s
could not send startup packet: %s
could not set socket to TCP no delay mode: %s
could not set socket to close-on-exec mode: %s
could not set socket to nonblocking mode: %s
could not translate Unix-domain socket path "%s" to address: %s
could not translate host name "%s" to address: %s
could not write to file "%s": %s
definition of service "%s" not found
duplicate GSS authentication request
end of string reached when looking for matching "]" in IPv6 host address in URI: "%s"
expected authentication request from server, but received %c
extra key/value separator "=" in URI query parameter: "%s"
extraneous data in "D" message extraneous data in "T" message extraneous data in "t" message forbidden value %%00 in percent-encoded value: "%s"
function requires at least protocol version 3.0
host name must be specified
host name must be specified for a verified SSL connection
incomplete multibyte character
insufficient data in "D" message insufficient data in "T" message integer of size %lu not supported by pqGetInt integer of size %lu not supported by pqPutInt invalid ExecStatusType code invalid LDAP URL "%s": invalid port number
invalid LDAP URL "%s": missing distinguished name
invalid LDAP URL "%s": must have exactly one attribute
invalid LDAP URL "%s": must have search scope (base/one/sub)
invalid LDAP URL "%s": no filter
invalid LDAP URL "%s": scheme must be ldap://
invalid URI propagated to internal parser routine: "%s"
invalid URI query parameter: "%s"
invalid connection option "%s"
invalid connection state %d, probably indicative of memory corruption
invalid connection state, probably indicative of memory corruption
invalid percent-encoded token: "%s"
invalid port number: "%s"
invalid setenv state %c, probably indicative of memory corruption
invalid socket
invalid sslmode value: "%s"
invalid state %c, probably indicative of memory corruption
keepalives parameter must be an integer
length must be given for binary parameter
line %d too long in service file "%s"
local user with ID %d does not exist
lookup on LDAP server failed: %s
lost synchronization with server, resetting connection lost synchronization with server: got message type "%c", length %d
message contents do not agree with length in message type "%c"
message type 0x%02x arrived from server while idle missing "=" after "%s" in connection info string
missing key/value separator "=" in URI query parameter: "%s"
more than one entry found on LDAP lookup
nested service specifications not supported in service file "%s", line %d
no COPY in progress
no SSL error reported no connection to the server
no entry found on LDAP lookup
no error message available
number of parameters must be between 0 and 65535
out of memory out of memory
out of memory allocating GSSAPI buffer (%d) out of memory for query result parameter number %d is out of range 0..%d password retrieved from file "%s"
private key file "%s" has group or world access; permissions should be u=rw (0600) or less
protocol error: id=0x%x
query to initialize large object functions did not return data
received invalid response to SSL negotiation: %c
requirepeer parameter is not supported on this platform
requirepeer specifies "%s", but actual peer user name is "%s"
root certificate file "%s" does not exist
Either provide the file or change sslmode to disable server certificate verification.
row number %d is out of range 0..%d select() failed: %s
server certificate for "%s" does not match host name "%s"
server closed the connection unexpectedly
This probably means the server terminated abnormally
before or while processing the request.
server does not support SSL, but SSL was required
server sent binary data ("B" message) without prior row description ("T" message) server sent data ("D" message) without prior row description ("T" message) server sent data ("D" message) without prior row description ("T" message)
service file "%s" not found
setsockopt(SO_KEEPALIVE) failed: %s
setsockopt(TCP_KEEPALIVE) failed: %s
setsockopt(TCP_KEEPCNT) failed: %s
setsockopt(TCP_KEEPIDLE) failed: %s
setsockopt(TCP_KEEPINTVL) failed: %s
sslmode value "%s" invalid when SSL support is not compiled in
statement name is a null pointer
syntax error in service file "%s", line %d
timeout expired
unexpected asyncStatus: %d
unexpected character "%c" at position %d in URI (expected ":" or "/"): "%s"
unexpected character %c following empty query response ("I" message) unexpected field count in "D" message unexpected message from server during startup
unexpected response from server; first received character was "%c"
unrecognized SSL error code: %d
unrecognized socket error: 0x%08X/%d unterminated quoted string in connection info string
user name lookup failure: error code %lu
Project-Id-Version: PostgreSQL 9.6 libpq
Report-Msgid-Bugs-To: pgsql-bugs@postgresql.org
POT-Creation-Date: 2016-09-26 14:02+0900
PO-Revision-Date: 2016-09-26 16:37+0900
Last-Translator: Ioseph Kim <ioseph@uri.sarang.net>
Language-Team: Korean <pgsql-kr@postgresql.kr>
Language: ko
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Plural-Forms: nplurals=1; plural=0;
위치: %s %s %s, %s:%s 칼럼 이름: %s
제약조건 이름: %s
구문: %s
COPY IN 상태가 먼저 끝나야함
COPY OUT 상태가 먼저 끝나야함
새 PQexec 호출로 COPY 작업이 중지 되었습니다 암호화 인증은 지원되지 않음
자료형 이름: %s
상세정보: %s
GSSAPI 인증은 지원되지 않음
GSSAPI 연속 오류 GSSAPI 이름 가져오기 오류 힌트: %s
IPv6 호스트 주소가 없습니다, 해당 URI: "%s"
Kerberos 4 인증 방법이 지원되지 않음
Kerberos 5 인증 방법이 지원되지 않음
줄 %d: 위치: 알림 PGEVT_CONNRESET 이벤트 동안 PGEventProc "%s"이(가) 실패함
PGEVT_RESULTCREATE 이벤트 동안 PGEventProc "%s" 실패함
PGresult가 오류 결과가 아님
COPY BOTH 작업 중에는 PQexec 사용할 수 없음
PQgetline: text COPY OUT 작업을 할 수 없음
쿼리: %s
스키마 이름: %s
SCM_CRED 인증 방법이 지원되지 않음
SSL SYSCALL 오류: %s
SSL SYSCALL 오류: EOF 감지됨
SSL 인증서의 이름에 null 문자가 있음
SSL 인증서의 이름 항목이 잘못됨
SSL 연결이 예상치 못하게 끊김
SSL 오류 번호 %lu SSL 오류: %s
SSL 라이브러리가 CRL 인증서 ("%s" 파일)를 지원하지 않음
SSPI 인증은 지원되지 않음
SSPI 연속 오류 테이블 이름: %s
"%s" 유닉스 도메인 소켓 경로가 너무 깁니다 (최대 %d 바이트)
경고: 패스워드 파일 "%s"에 그룹 또는 범용 액세스 권한이 있습니다. 권한은 u=rw(0600) 이하여야 합니다.
경고: "%s" 패스워드 파일이 plain 파일이 아님
WSAIoctl(SIO_KEEPALIVE_VALS) 실패: %ui
처리 중에 이미 다른 명령이 존재함
lo_read 함수의 인자값이 정수 범위가 아님
lo_truncate 함수의 인자값이 정수 범위가 아님
lo_write 함수의 인자값이 정수 범위가 아님
LDAP 검색에서 속성의 값이 없음
%u 인증 방법이 지원되지 않음
lo_close 함수의 OID 조사를 할 수 없음
lo_create 함수의 OID 조사를 할 수 없음
lo_create 함수의 OID 조사를 할 수 없음
lo_lseek 함수의 OID 조사를 할 수 없음
lo_lseek64 함수의 OID를 알 수 없음
lo_open 함수의 OID 조사를 할 수 없음
lo_tell 함수의 OID 조사를 할 수 없음
lo_tell64 함수의 OID를 알 수 없음
lo_truncate 함수의 OID를 결정할 수 없음
lo_truncate64 함수의 OID를 알 수 없음
lo_unlink 함수의 OID 조사를 할 수 없음
loread 함수의 OID 조사를 할 수 없음
lowrite 함수의 OID 조사를 할 수 없음
인증서를 구하질 못했습니다: %s
인증서가 "%s" 개인키 파일과 맞지 않습니다: %s
인증서가 있지만, "%s" 개인키가 아닙니다.
%d 번째 열은 0..%d 범위를 벗어났음 명령 문자열이 null 포인터
잘못된 상태의 연결
연결 열기 실패
연결 포인터가 NULL
SSPI 자격 증명을 가져올 수 없음 mutex 취득 실패: %s
서버에 연결할 수 없음: %s
로컬호스트에 서버가 가동 중인지,
"%s" 유닉스 도메인 소켓 접근이 가능한지 살펴보십시오.
서버에 연결할 수 없음: %s
"%s" (%s) 호스트에 서버가 가동 중인지,
%s 포트로 TCP/IP 연결이 가능한지 살펴보십시오.
서버에 연결할 수 없음: %s
"%s" 호스트에 서버가 가동 중인지,
%s 포트로 TCP/IP 연결이 가능한지 살펴보십시오.
LDAP 구조를 만들 수 없음
SSL context를 만들 수 없음: %s
소켓을 만들 수 없음: %s
SSL 연결을 확립할 수 없음: %s
소켓에서 클라이언트 주소를 구할 수 없음: %s
루트 인증서 파일이 있는 홈 디렉터리를 찾을 수 없음
해당 파일을 제공하거나 서버 인증서 확인을 사용하지 않도록 sslmode를 변경하십시오.
서비스 정의 파일이 있는 홈 디렉토리를 찾을 수 없음 신뢰성 피어를 얻을 수 없습니다: %s
서버 인증서에서 서버 호스트 이름을 찾을 수 없음
소켓 오류 상태를 구할 수 없음: %s
SSL 엔진 "%s"을(를) 초기화할 수 없음: %s
서버로부터 결과처리를 중지 시킬 수 없음: %s SSL 엔진 "%s"을(를) 로드할 수 없음: %s
개인 SSL 키 "%s"을(를) "%s" 엔진에서 읽을 수 없음: %s
"%s" 개인키 파일을 불러들일 수 없습니다: %s
UID %d 해당하는 사용자를 찾을 수 없음: %s
"%s" 인증서 파일을 열수 없음: %s
"%s" 파일을 열 수 없음: %s
"%s" 인증서 파일을 읽을 수 없음: %s
"%s" 파일을 읽을 수 없음: %s
개인 SSL 키 "%s"을(를) "%s" 엔진에서 읽을 수 없음: %s
"%s" 루트 인증서 파일을 읽을 수 없음: %s
서버로부터 데이터를 받지 못했음: %s
SSL 교섭 패킷을 보낼 수 없음: %s
서버에 데이터를 보낼 수 없음: %s
시작 패킷을 보낼 수 없음: %s
소켓을 TCP에 no delay 모드로 지정할 수 없음: %s
소켓을 close-on-exec 모드로 지정할 수 없음: %s
소켓을 nonblocking 모드로 지정할 수 없음: %s
"%s" 유닉스 도메인 소켓 경로를 전송할 수 없습니다: 대상 주소: %s
"%s" 호스트 이름을 전송할 수 없습니다: 대상 주소: %s
"%s" 파일을 쓸 수 없음: %s
"%s" 서비스 정의를 찾을 수 없음
중복된 GSS 인증 요청
URI의 IPv6 호스트 주소에서 "]" 매칭 검색을 실패했습니다, 해당 URI: "%s"
서버가 인증을 요구했지만, %c 받았음
키/밸류 구분자 "=" 문자가 필요함, 해당 URI 쿼리 매개변수: "%s"
"D" 메시지 안에 잘못된 데이터 "T" 메시지 안에 잘못된 데이터 "t" 메시지 안에 잘못된 데이터 퍼센트 인코드 값에 %%00 숨김 값이 있음: "%s"
함수는 적어도 버전 3의 프로토콜을 요구하고 있습니다
호스트 이름을 지정해야 함
인증된 SSL 접속을 위해서는 호스트 이름을 지정해야 함
완성되지 않은 멀티바이트 문자
"D" 메시지 안에 불충분한 데이터 "T" 메시지 안에 부족자 데이터 %lu 정수형 크기는 pqGetInt 함수에서 지원하지 않음 %lu 정수형 크기는 pqPutInt 함수에서 지원하지 않음 잘못된 ExecStatusType 코드 잘못된 LDAP URL "%s": 포트번호가 잘못됨
잘못된 LDAP URL "%s": 식별자 이름이 빠졌음
잘못된 LDAP URL "%s": 단 하나의 속성만 가져야함
잘못된 LDAP URL "%s": 검색범위(base/one/sub)를 지정해야함
잘못된 LDAP URL "%s": 필터 없음
잘못된 LDAP URL "%s": 스키마는 ldap:// 여야함
URI 구문 분석을 할 수 없음: "%s"
잘못된 URL 쿼리 매개변수값: "%s"
잘못된 연결 옵션 "%s"
잘못된 연결 상태 %d, 메모리 손상일 가능성이 큼
잘못된 연결 상태, 메모리 손상일 가능성이 큼
잘못된 퍼센트 인코드 토큰: "%s"
잘못된 포트 번호: "%s"
잘못된 환경변수 상태 %c, 메모리 손상일 가능성이 큼
잘못된 소켓
잘못된 sslmode 값: "%s"
잘못된 상태 %c, 메모리 손상일 가능성이 큼
keepalives 매개변수값은 정수여야 합니다.
바이너리 자료 매개 변수를 사용할 때는 그 길이를 지정해야 함
%d번째 줄이 "%s" 서비스 파일에서 너무 깁니다
ID %d 로컬 사용자 없음
LDAP 서버를 찾을 수 없음: %s
서버와의 동기화가 끊김, 연결을 재 시도함 서버와의 동기화가 끊김: "%c" 형태 길이 %d 메시지 받음
메시지 내용이 "%c" 메시지 형태의 길이를 허락하지 않음
휴지(idle)동안 서버로 부터 0x%02x 형태 메시지를 받았음 연결문자열에서 "%s" 다음에 "=" 문자 빠졌음
키/밸류 구분자 "=" 문자가 필요함, 해당 URI 쿼리 매개변수: "%s"
LDAP 검색에서 하나 이상의 엔트리가 발견되었음
"%s" 서비스 파일의 %d번째 줄에 설정을 지원하지 않음
처리 가운데 COPY가 없음
SSL 오류 없음이 보고됨 서버에 대한 연결이 없음
LDAP 검색에서 해당 항목 없음
보여줄 오류 메시지가 없음
매개변수값으로 숫자는 0에서 65535까지만 쓸 수 있음
메모리 부족 메모리 부족
GSSAPI 버퍼(%d)에 할당할 메모리 부족 쿼리 결과 처리를 위한 메모리 부족 %d개의 매개 변수는 0..%d 범위를 벗어났음 "%s" 파일에서 암호를 찾을 수 없음
개인 키 파일 "%s"에 그룹 또는 범용 액세스 권한이 있습니다. 권한은 u=rw(0600) 이하여야 합니다.
프로토콜 오류: id=0x%x
large object function을 초기화 하는 쿼리가 데이터를 리턴하지 않았음
SSL 교섭에 대한 잘못된 응답을 감지했음: %c
requirepeer 매개변수는 이 운영체제에서 지원하지 않음
"%s" 이름으로 requirepeer를 지정했지만, 실재 사용자 이름은 "%s" 입니다
루트 인증서 파일 "%s"이(가) 없습니다.
해당 파일을 제공하거나 서버 인증서 확인을 사용하지 않도록 sslmode를 변경하십시오.
%d 번째 행(row)은 0..%d 범위를 벗어났음 select() 실패: %s
서버 인증서의 이름 "%s"이(가) 호스트 이름 "%s"과(와) 일치하지 않음
서버가 갑자기 연결을 닫았음
이런 처리는 클라이언트의 요구를 처리하는 동안이나
처리하기 전에 서버가 갑자기 종료되었음을 의미함
서버가 SSL 기능을 지원하지 않는데, SSL 기능을 요구했음
서버에서 먼저 행(row) 설명("T" 메시지) 없이 바이너리 자료("B" 메시지)를 보냈음 서버에서 먼저 행(row) 설명("T" 메시지) 없이 자료("D" 메시지)를 보냈음 서버에서 먼저 행(row) 설명("T" 메시지) 없이 자료("D" 메시지)를 보냈음
"%s" 서비스 파일을 찾을 수 없음
setsockopt(SO_KEEPALIVE) 실패: %s
setsockopt(TCP_KEEPALIVE) 실패: %s
setsockopt(TCP_KEEPCNT) 실패: %s
setsockopt(TCP_KEEPIDLE) 실패: %s
setsockopt(TCP_KEEPINTVL) 실패: %s
SSL 연결 기능을 지원하지 않고 컴파일 된 경우는 sslmode 값으로 "%s" 값은 타당치 않습니다
실행 구문 이름이 null 포인트(값이 없음)입니다
"%s" 서비스 파일의 %d번째 줄에 구문 오류 있음
시간 초과
기대되지 않은 동기화상태: %d
잘못된 "%c" 문자가 URI 문자열 가운데 %d 번째 있습니다(":" 또는 "/" 문자가 있어야 함): "%s"
비어있는 쿼리 응답("I" 메시지)에 뒤이어 %c의 잘못된 문자가 있음 "D" 메시지 안에 예상치 못한 필드 수 시작하는 동안 서버로부터 기대되지 않는 메시지
서버로부터 예상치 못한 응답을 받았음; "%c" 문자를 첫문자로 받았음
알 수 없는 SSL 오류 코드: %d
알 수 없는 소켓오류: 0x%08X/%d 연결문자열에서 완성되지 못한 따옴표문자열이 있음
사용자 이름 찾기 실패: 오류 코드 %lu
locale/ko/LC_MESSAGES/psql-9.6.mo 0000644 00000247573 14751153420 0012053 0 ustar 00 �� � 4 � L: �M �M �M �M � N �N �N
�N �N > O = OO < �O p �O s ;P 5 �P 7 �P K Q o iQ 2 �Q 4 R N AR t �R Q S O WS > �S A �S O (T @ xT 6 �T 0 �T N !U G pU 8 �U A �U T 3V ? �V L �V A W @ WW H �W A �W + #X � OX 5 �X 9 Y n UY Q �Y : Z ; QZ ; �Z B �Z 4 [ J A[ 4 �[ G �[ = \ ; G\ ( �\ ; �\ ; �\ ; $] ; `] F �] ` �] h D^ G �^ 5 �^ 2 +_ 3 ^_ ; �_ M �_ 9 ` @ V` 8 �` ; �` @ a K Ma J �a | �a � ab > �b F &c N mc F �c H d - Ld $ zd & �d - �d 9 �d 7 .e 2 fe 4 �e 3 �e ) f ) ,f ; Vf B �f ) �f * �f * *g J Ug 1 �g . �g - h , /h 4 \h I �h $ �h & i > 'i 1 fi & �i ( �i J �i : 3j ( nj % �j $ �j $ �j ) k - 1k N _k 9 �k G �k 5 0l M fl C �l P �l K Im N �m K �m L 0n 4 }n K �n ( �n q 'o A �o ? �o A p > ]p X �p # �q F r 8 `r < �r M �r ; $s 6 `s 2 �s 7 �s B t : Et 4 �t 9 �t ? �t % /u + Uu 9 �u 5 �u I �u K ;v M �v Z �v @ 0w : qw ( �w B �w L x C ex M �x = �x � 5y �y �y z
z z !z 5z Ez 0 Mz $ ~z # �z * �z % �z * { C{ # d{ < �{ �{ �{ �{ 6 | P| � e| : } F} X} d} n} } �} Q �} �} I ~ [ S~
�~ �~ �~ �~ �~ C A O � � � � � � � , � � )� 5� ?� K� Q� Z� t� �� ��
�� �� À π ' ܀ � & "� ' I� 7 q� 0 �� ځ �� � � 1� :� B� K� e U� �� ̂ � � � ( � C� O� X� r� �� �� �� Ճ � � � � � !� 1�
9� G� M� P� Z�
`� n� w� �� �� �� ��
�� ��
Є ބ & � � �
*�
8� F� M� `� w�
�� �� �� ȅ ۅ � �� � ,� C� a� s� �� �� ��
Ɔ Ԇ � % �� � " /� R� s� �� �� ' Ç & � � � 5� ?� F� O� Y�
^� i� L x� ň Ԉ � > � N� c� w� 2 �� �� ȉ ۉ � � � #� 9� F� L� c� �� X �� � �� �
.� 9� R� [� u�
� �� �� �� � ,� , 8� e� v� �� �� �� �� �� ӌ E ڌ � 0� 7� @� Q� X� a� f� m� y� �� �� �� �� �� ˍ Ս �
� �� �
2� =� N� Z� o� �� �� ! �� ю � 9 � 9 >� F x� 5 �� B �� C 8� 5 |� : �� 9 � @ '� ; h� K �� B � C 3� 6 w� 8 �� � � �
!� /� ?� P�
V� a� }� �� �� Փ ߓ & � � #� 7� <� � T� # � # 6� # Z� ~� " �� �� ϕ ו � �� �
� � � (�
9� c D� � �� i� K �� Q җ / $� O T� U �� 5 �� = 0� n� , z� 4 �� " ܙ ! �� !� A� N� i� " �� + �� + Ԛ 6 � X 7� 7 �� 8 ț T � 5 V� I �� 6 ֜ #
� = 1� = o� = �� i � 9 U� �� �� * ˞ �� � 4� ;� ?� N� b� l� }� ��
�� ß ̟ ՟ ݟ � �
�� � � � '� 8� B� C H� �� / �� ( ͠ �� � � ' ;� c� $ �� % �� ! ͡ ) � ( � / B� # r� ' �� , �� . � 4 � O� ! o� - �� �� % � 4 � 1 ;� - m� / �� " ˤ � ' � 6� . V� ) �� % �� ! ե $ �� * � + G� A s� & �� 0 ܦ .
� ) <� ) f� �� % ��
ŧ Ч # ڧ �� � � /� ;� C� Z� C l� �� Ϩ � � �
&� 1� $ A� & f� - �� # �� ߩ 1 � ( 2� ) [� + �� ' �� ! ٪ �� # � ! :� ( \� �� �� �� ث �� � � 1� L� X�
b� p� ��
�� �� �� �� ۬ ��
� $� ;� V� j� �� �� ! ݭ �� � 2 (� [� z� �� �� ɮ � 2 � 5 7� m� �� �� . �� � & �� # "� F� ! f� �� �� �� ư ߰ 6 � ) 7� a�
i� t� �� ��
�� & �� ޱ � �� � � !� 3� E� Q� Y� x� ��
�� �� U �� �� � � .�
=� H� W� `� " r�
�� �� �� ��
ӳ 1 � � +�
=� H� Y� . k� �� . ��
Ӵ � � ��
�
� "�
3� A� P� X� l� �� * �� ŵ
͵ ص � � �� � � *� 6� P� k� x� �� �� �� �� �� �� % Ķ � � � � &� 5� >� H�
Q� \� f� u� �� �� �� �� �� �� ͷ ַ � � �� ��
�
� � � -�
=� K�
R� `� o� �� �� �� �� �� �� ϸ ۸ � ! �� 4 �
N� . \� �� �� �� �� ¹ ӹ ݹ
�
�
� � #� 7� J� \� s� " �� �� �� ۺ � � %� / ;� k� {� �� �� " �� ӻ � � -� @� * Q�
|� �� �� �� ؼ � � � '� @� 0 Z� �� > ��
ҽ ) ݽ " �
*� 5� ?� R� k� p� z� � �� ��
�� ��
�� Ͼ ۾ � 7 �� 2 .� 6 a� V �� & � & � . =�
l�
z� �� �� �� �� �� �� � � � ! �� � #� . 0� _� e� v�
�� �� �� �� �� �
� � � �� � � $� .� $ M� # r� �� �� 0 �� �� �� �� � ( &� O� Y� e� x� ~� �� �� �� �� �� �� �� �� $ � :� ' O� w� �� �� �� �� ! �� � '� 9� E� � I� �� �� � � %� �� ��
� � ` � A �� B �� z � s �� @ �� K 6� G �� x �� 9 C� = }� S �� � � Q �� O � Q V� @ �� U �� E ?� @ �� 6 �� ] �� Q [� : �� Q �� � :� ] �� Z � P {� N �� S � C o� ) �� � �� > v� : �� v �� R g� 8 �� @ �� 6 4� @ k� 1 �� ^ �� J =� @ �� 9 �� 7 � N ;� F �� - �� J �� 4 J� ? � o �� p /� B �� < �� 3 � = T� C �� G �� < � @ [� G �� \ �� > A� b �� ] �� � A� � �� ; Z� H �� ^ �� J >� c �� . �� 4 � * Q� 1 |� 8 �� 8 �� 8 � ; Y� 4 �� * �� 1 �� = '� K e� . �� 6 �� 4 � W L� 4 �� . �� 1 � 1 :� 8 l� H �� $ �� * � F >� 1 �� * �� * �� N
� B \� * �� * �� $ �� $ � . ?� 4 n� Q �� > �� I 4� H ~� ] �� F %� Z l� [ �� Q #� O u� ` �� 4 &� Z [� 3 �� k �� T V� 8 �� A �� [ &� � �� % � S /� @ �� ? �� b � 9 g� 2 �� . �� 2 � @ 6� = w� ; �� 5 �� = '� ' e� / �� 7 �� ? �� L 5� S �� D �� ] � T y� N �� ( � B F� V �� W � - 8� 4 f� � �� +� H� U� X� n� r� �� �� C �� C � % (� = N� - �� 3 �� ( � " � R :� 1 �� �� ' � 3 �� 1� � >� < � � &� 5� A� R� o� e �� � A �� N 9� �� �� 9 �� � � ] � \ s� � � � � � � (� & <� c� {� ��
�� �� �� �� $ � $ �
� � '� .� 5� @ <� * }� . �� > � C C Z ! � � � $ � ) 3 � H � � ! ! ; 8 ]
� � � * � � 7 F M U e � � �
� � � � �
& 0 A U
d
r � ( � � �
� � � � # 8 L + a � � � � �
8 F
d r �
� �
� & � � 6 U ! t � + � + �
& 5
<
J X _
t { �
� < I N i � � & � :
J
Q
_
- m
�
�
�
�
�
�
- @ 2 M s � � � ) ! 0 R _ n $ � � 2 � ' � %
=
+ D
p
�
�
�
�
�
' �
Q ` t ~ � � � � �
� � % � �
* 3 @ X b t � � � � � * 4 Q q � P � D � Y D W � S � P J G � H � K , R x H � _ S t P � L K f � � � ! < > {
� � � � * �
% # / S q � 6 � � � ( � % � % � " @ # " d � ) � � � � � � � � � < � T � Q 8 > � T � Q 7 p T � � 3 ? = } + � # � � ! � 2 6 S * � = � m � - a Q � Z � A <! I ~! J �! * " L >" M �" M �" q '# D �# ! �# 8 $ 6 9$ p$ �$ �$ �$ �$ �$ �$ �$ �$ ! % 5% E% R% b% o% |% �% �% �% �% �%
�% �% �% Q �% 8& 6 Y& G �& �& �& $ ' , 5' $ b' �' 6 �' �' �' ! ( ( 5( ^( v( ! �( $ �( / �( ) !) <) W) & r) ( �) ( �) ( �) + * @* [* ! v* �* �* �* �* + + $ :+ $ _+ a �+ 0 �+ C , B [, : �, = �,
- E %-
k- v- 4 �- �- �- �- �- �- �- . L 8. �. �. �. �. . �. / / . '/ = V/ 7 �/ ( �/ ' �/ ? 0 , ]0 1 �0 7 �0 ) �0 * 1 - I1 ' w1 * �1 3 �1 $ �1 ' #2 1 K2 / }2 ( �2 �2 �2 �2 3 "3 ,3 + E3 q3 {3 �3
�3 �3 �3 �3 �3 4 $ )4 N4 2 f4 ! �4 �4 �4 " �4 5 (5 3 @5 t5 �5 ! �5 �5 $ �5 6 6 )6 7 `6 �6 �6 �6 + �6 # 7 " 87 " [7 " ~7 % �7 �7 �7 �7
8 (8 8 D8 7 }8 �8 �8 �8 �8 �8 �8 ' 9 49 A9 H9 U9 b9 w9 �9 �9 �9 I �9 : : :
*: � 8: �: �: + �: ; ; (; ;; H; . a; �; �; �; ! �; �; 7 �; %< D< S< `< q< B �< �< 4 �<
= = = 0= C= P= `=
s= ~= �= # �= �= �= + �= >
> &> 8> A> X> e> t> �> ! �> $ �>
�> �> �> ? ? +? 5? B? / L? |? �? �? �? �? �? �? �? �? �? �? @ @ )@ B@ ^@ e@ q@ ~@ �@ �@ �@ �@ �@ �@ �@ �@ �@ �@ A A A -A ?A OA \A iA zA �A �A �A �A �A . �A ; B MB 2 YB �B �B �B �B �B �B �B �B C C 1C , BC oC �C �C �C �C �C D
D -D ED cD @ tD �D �D �D �D
E ,E KE ! jE �E �E / �E �E �E
F "F 7F RF gF xF �F �F ] �F G ; $G `G ! jG ' �G �G �G
�G �G �G H H H &H 5H EH RH \H lH
yH
�H - �H * �H 5 �H A $I fI * �I 4 �I �I
�I �I J J /J 6J =J DJ
eJ sJ ) �J �J �J ; �J K K )K @K PK lK �K �K �K
�K �K �K �K ! �K
L L * L / JL ( zL �L �L M �L M M /M GM 0 XM �M �M �M �M �M �M �M �M �M N N $ 'N LN kN �N 3 �N �N �N �N
O O 5O SO WO gO wO E � V 1 � � � � v O c � � � A d 3 � � % � � 1 W * � � � [ � � ? � � s V 0 � � � � 7 u ] [ _ � � � � a y B � � _ � � J � y v � � < � = E � + � � � � i ' O � � � ! 1 T 0 � � � � � � � � � � � � � ? * �
+ G | x � < � � % q � m U Y # | l � 9 � B n # 2 K u ~ � � " e C � � � P ) � R � � � k � � \ n � � � 2 � R � - � � P � � g � - � � 5 � � I ? � � w � j 6 � � � � . h � � � � � � � : r � � � v < �
i ) . � \ S � = ; @ { [ L � X N ^ � � � � � � / � E � � � ^ � F � E � � U � X X g n M
� I * � � � , � � � � } � z � � P � 8 � ' � Y � � � � t � k � & } e ) c H � � � h � f � @ ! � + � � K � � N Q � $ D � � 2 � � > 6 � V � � � � � � � @ ; 1 l o s v � O ~ � L �
� / � , J G D , P � � � � � � � �
� � l � : � � � � V / 6 � p � x � � T J � j { 7 Y � t ( � � R $ � M z H � � � # q � i � � S I � � � � > � f � � � 5 T � � � y � � s � � ` � � ! = � b 3 4 ] ? � � � } � m � � � U > � � L � F � � � � � � � Q � " ; � � Z � 8 � q q � � � M � � � � � " x � � x � 5 � ' m 0 � 2 G � � $ ; @ � � � K a � � � 7 � � 8 � % w � � � Q R � 8 . w d + X � - � � � U t � � � 7 ] H � _ � � � � � � � � K [ � � � � � � � " � � . f � G u � r 3 � � � � � b D � � & � ^ w � � �
� 9 � � $ � � r � # � � e � � ) b � /
| 6 � � � c c � � } { � � C m � � � � � � I � � � � � � � & b ` J � � � � � � � ( � � B � � � H F ( M � ~ f > � � S y 5 � s � ~ a � W � = � % � ! 4 � � � C � Z O A z � � � � � � o d L \ N � � � n � � p j W � ` p � g ] j � o S A � { � p � � , Z � W � � N � � a 3 � � : o F | A B g � 0 � � � 4 � h h ( � � � � \ ` t & C Z Q � � T � k � � � 4 D � � � z i Y � 9 < u � * ^ � 9 : d r k - � � � � � � l � ' � � _
� e
Connection options:
Display settings:
Environment variables:
For more information, type "\?" (for internal commands) or "\help" (for SQL
commands) from within psql, or consult the psql section in the PostgreSQL
documentation.
Input and output options:
Output format options:
Parser: "%s"
Parser: "%s.%s" --help=commands list backslash commands, then exit
--help=variables list special variables, then exit
(options: S = show system objects, + = additional detail)
-0, --record-separator-zero
set record separator for unaligned output to zero byte
-1 ("one"), --single-transaction
execute as a single transaction (if non-interactive)
-?, --help[=options] show this help, then exit
-A, --no-align unaligned table output mode
-E, --echo-hidden display queries that internal commands generate
-F, --field-separator=STRING
field separator for unaligned output (default: "%s")
-H, --html HTML table output mode
-L, --log-file=FILENAME send session log to file
-P, --pset=VAR[=ARG] set printing option VAR to ARG (see \pset command)
-R, --record-separator=STRING
record separator for unaligned output (default: newline)
-S, --single-line single-line mode (end of line terminates SQL command)
-T, --table-attr=TEXT set HTML table tag attributes (e.g., width, border)
-U, --username=USERNAME database user name (default: "%s")
-V, --version output version information, then exit
-W, --password force password prompt (should happen automatically)
-X, --no-psqlrc do not read startup file (~/.psqlrc)
-a, --echo-all echo all input from script
-b, --echo-errors echo failed commands
-c, --command=COMMAND run only single command (SQL or internal) and exit
-d, --dbname=DBNAME database name to connect to (default: "%s")
-e, --echo-queries echo commands sent to server
-f, --file=FILENAME execute commands from file, then exit
-h, --host=HOSTNAME database server host or socket directory (default: "%s")
-l, --list list available databases, then exit
-n, --no-readline disable enhanced command line editing (readline)
-o, --output=FILENAME send query results to file (or |pipe)
-p, --port=PORT database server port (default: "%s")
-q, --quiet run quietly (no messages, only query output)
-s, --single-step single-step mode (confirm each query)
-t, --tuples-only print rows only
-v, --set=, --variable=NAME=VALUE
set psql variable NAME to VALUE
(e.g., -v ON_ERROR_STOP=1)
-w, --no-password never prompt for password
-x, --expanded turn on expanded table output
-z, --field-separator-zero
set field separator for unaligned output to zero byte
AUTOCOMMIT if set, successful SQL commands are automatically committed
COLUMNS number of columns for wrapped format
DBNAME the currently connected database name
ENCODING current client character set encoding
HOST the currently connected database server host
LASTOID value of the last affected OID
NAME=VALUE [NAME=VALUE] psql ...
or \setenv NAME [VALUE] inside psql
PAGER name of external pager program
PGAPPNAME same as the application_name connection parameter
PGDATABASE same as the dbname connection parameter
PGHOST same as the host connection parameter
PGPASSFILE password file name
PGPASSWORD connection password (not recommended)
PGPORT same as the port connection parameter
PGUSER same as the user connection parameter
PORT server port of the current connection
PSQLRC alternative location for the user's .psqlrc file
PSQL_EDITOR, EDITOR, VISUAL
editor used by the \e, \ef, and \ev commands
PSQL_EDITOR_LINENUMBER_ARG
how to specify a line number when invoking the editor
PSQL_HISTORY alternative location for the command history file
QUIET run quietly (same as -q option)
SHELL shell used by the \! command
TMPDIR directory for temporary files
USER the currently connected database user
\! [COMMAND] execute command in shell or start interactive shell
\? [commands] show help on backslash commands
\? options show help on psql command-line options
\? variables show help on special variables
\C [STRING] set table title, or unset if none
\H toggle HTML output mode (currently %s)
\T [STRING] set HTML <table> tag attributes, or unset if none
\a toggle between unaligned and aligned output mode
\c[onnect] {[DBNAME|- USER|- HOST|- PORT|-] | conninfo}
connect to new database (currently "%s")
\c[onnect] {[DBNAME|- USER|- HOST|- PORT|-] | conninfo}
connect to new database (currently no connection)
\cd [DIR] change the current working directory
\conninfo display information about current connection
\copy ... perform SQL COPY with data stream to the client host
\copyright show PostgreSQL usage and distribution terms
\crosstabview [COLUMNS] execute query and display results in crosstab
\dA[+] [PATTERN] list access methods
\dC[+] [PATTERN] list casts
\dD[S+] [PATTERN] list domains
\dE[S+] [PATTERN] list foreign tables
\dF[+] [PATTERN] list text search configurations
\dFd[+] [PATTERN] list text search dictionaries
\dFp[+] [PATTERN] list text search parsers
\dFt[+] [PATTERN] list text search templates
\dL[S+] [PATTERN] list procedural languages
\dO[S+] [PATTERN] list collations
\dT[S+] [PATTERN] list data types
\d[S+] list tables, views, and sequences
\d[S+] NAME describe table, view, sequence, or index
\da[S] [PATTERN] list aggregates
\db[+] [PATTERN] list tablespaces
\dc[S+] [PATTERN] list conversions
\dd[S] [PATTERN] show object descriptions not displayed elsewhere
\ddp [PATTERN] list default privileges
\des[+] [PATTERN] list foreign servers
\det[+] [PATTERN] list foreign tables
\deu[+] [PATTERN] list user mappings
\dew[+] [PATTERN] list foreign-data wrappers
\df[antw][S+] [PATRN] list [only agg/normal/trigger/window] functions
\dg[S+] [PATTERN] list roles
\di[S+] [PATTERN] list indexes
\dl list large objects, same as \lo_list
\dm[S+] [PATTERN] list materialized views
\dn[S+] [PATTERN] list schemas
\do[S] [PATTERN] list operators
\dp [PATTERN] list table, view, and sequence access privileges
\drds [PATRN1 [PATRN2]] list per-database role settings
\ds[S+] [PATTERN] list sequences
\dt[S+] [PATTERN] list tables
\du[S+] [PATTERN] list roles
\dv[S+] [PATTERN] list views
\dx[+] [PATTERN] list extensions
\dy [PATTERN] list event triggers
\e [FILE] [LINE] edit the query buffer (or file) with external editor
\echo [STRING] write string to standard output
\ef [FUNCNAME [LINE]] edit function definition with external editor
\encoding [ENCODING] show or set client encoding
\errverbose show most recent error message at maximum verbosity
\ev [VIEWNAME [LINE]] edit view definition with external editor
\f [STRING] show or set field separator for unaligned query output
\g [FILE] or ; execute query (and send results to file or |pipe)
\gexec execute query, then execute each value in its result
\gset [PREFIX] execute query and store results in psql variables
\h [NAME] help on syntax of SQL commands, * for all commands
\i FILE execute commands from file
\ir FILE as \i, but relative to location of current script
\l[+] [PATTERN] list databases
\lo_export LOBOID FILE
\lo_import FILE [COMMENT]
\lo_list
\lo_unlink LOBOID large object operations
\o [FILE] send all query results to file or |pipe
\p show the contents of the query buffer
\password [USERNAME] securely change the password for a user
\prompt [TEXT] NAME prompt user to set internal variable
\pset [NAME [VALUE]] set table output option
(NAME := {format|border|expanded|fieldsep|fieldsep_zero|footer|null|
numericlocale|recordsep|recordsep_zero|tuples_only|title|tableattr|pager|
unicode_border_linestyle|unicode_column_linestyle|unicode_header_linestyle})
\q quit psql
\qecho [STRING] write string to query output stream (see \o)
\r reset (clear) the query buffer
\s [FILE] display history or save it to file
\set [NAME [VALUE]] set internal variable, or list all if no parameters
\setenv NAME [VALUE] set or unset environment variable
\sf[+] FUNCNAME show a function's definition
\sv[+] VIEWNAME show a view's definition
\t [on|off] show only rows (currently %s)
\timing [on|off] toggle timing of commands (currently %s)
\unset NAME unset (delete) internal variable
\w FILE write query buffer to file
\watch [SEC] execute query every SEC seconds
\x [on|off|auto] toggle expanded output (currently %s)
\z [PATTERN] same as \dp
border border style (number)
columns target width for the wrapped format
expanded (or x) expanded output [on, off, auto]
fieldsep field separator for unaligned output (default "%s")
fieldsep_zero set field separator for unaligned output to zero byte
footer enable or disable display of the table footer [on, off]
format set output format [unaligned, aligned, wrapped, html, asciidoc, ...]
psql --pset=NAME[=VALUE]
or \pset NAME [VALUE] inside psql
psql --set=NAME=VALUE
or \set NAME VALUE inside psql
psql [OPTION]... [DBNAME [USERNAME]]
recordsep record (line) separator for unaligned output
recordsep_zero set record separator for unaligned output to zero byte
set NAME=VALUE
psql ...
or \setenv NAME [VALUE] inside psql
title set the table title for any subsequently printed tables
tuples_only if set, only actual table data is shown
unicode_border_linestyle
unicode_column_linestyle
unicode_header_linestyle
set the style of Unicode line drawing [single, double]
"%s.%s" is not a view
%d connection %d connections %s %s %s (every %gs)
%s
%s (%s, server %s)
%s (every %gs)
%s: %s
%s: -1 can only be used in non-interactive mode
%s: cannot copy from/to a directory
%s: could not delete variable "%s"
%s: could not find own program executable
%s: could not open log file "%s": %s
%s: could not set printing parameter "%s"
%s: could not set variable "%s"
%s: current transaction is aborted
%s: invalid encoding name or conversion procedure not found
%s: not connected to a database
%s: out of memory
%s: unknown transaction status
%s: warning: extra command-line argument "%s" ignored
(%lu row) (%lu rows) ***(Single step mode: verify command)*******************************************
%s
***(press return to proceed or enter x and return to cancel)********************
********* QUERY **********
%s
**************************
+ opt(%d) = |%s|
, clustered , invalid , predicate (%s) , tablespace "%s" Access privileges All connection parameters must be supplied because no database connection exists
Argument data types Asynchronous notification "%s" received from server process with PID %d.
Asynchronous notification "%s" with payload "%s" received from server process with PID %d.
Attributes Available help:
Border style is %d.
COPY data transfer failed: %s Call Handler Cannot add cell to table content: total cell count of %d exceeded.
Cannot add header to table content: column count of %d exceeded.
Cannot login Check Check constraints: Child tables Collate Column Column privileges Command: %s
Description: %s
Syntax:
%s
Composite type "%s.%s" Connection
Create DB Create role Ctype Database Default access privileges Default footer is off.
Default footer is on.
Default? Definition Description Destination Dictionaries Did not find any extension named "%s".
Did not find any extensions.
Did not find any relation named "%s".
Did not find any relation with OID %s.
Did not find any text search configuration named "%s".
Did not find any text search parser named "%s".
Disabled internal triggers: Disabled rules: Disabled triggers: Disabled user triggers: Elements Enabled Encoding End parse Enter data to be copied followed by a newline.
End with a backslash and a period on a line by itself. Enter it again: Enter new password: Event Expanded display is off.
Expanded display is on.
Expanded display is used automatically.
FDW Options Failed.
Field separator is "%s".
Field separator is zero byte.
Foreign table "%s.%s" Foreign-data wrapper Foreign-key constraints: Formatting
Function General
General options:
Get headline Get next token Get token types Handler Has OIDs: yes Help
ID Implicit? Index Index "%s.%s" Indexes: Informational
Inherits Init Init options Inline Handler Input/Output
Internal Language Internal name Interrupted
Invalid command \%s. Try \? for help.
Language Large Objects
Large objects Left arg type Lexize Line style is %s.
List of access methods List of aggregate functions List of casts List of collations List of conversions List of data types List of databases List of domains List of event triggers List of foreign servers List of foreign tables List of foreign-data wrappers List of functions List of installed extensions List of languages List of operators List of relations List of roles List of schemas List of settings List of specially treated variables
List of tablespaces List of text search configurations List of text search dictionaries List of text search parsers List of text search templates List of user mappings Locale-adjusted numeric output is off.
Locale-adjusted numeric output is on.
Location Materialized view "%s.%s" Member of Method Modifier Modifiers Name No changes No connections No help available for "%s".
Try \h with no arguments to see available help.
No inheritance No matching relations found.
No matching settings found.
No per-database role settings support in this server version.
No relations found.
No settings found.
Null display is "%s".
Number of child tables: %d (Use \d+ to list them.) Object Object Description Object descriptions Objects in extension "%s" Operating System
Options Output format is %s.
Owned by: %s Owner Pager is always used.
Pager is used for long output.
Pager usage is off.
Pager won't be used for less than %d line.
Pager won't be used for less than %d lines.
Parallel Password encryption failed.
Password for user %s: Password: Passwords didn't match.
Policies Previous connection kept
Procedure Query Buffer
Query buffer is empty. Query buffer reset (cleared). Record separator is "%s".
Record separator is <newline>.
Record separator is zero byte.
Referenced by: Replication Report bugs to <pgsql-bugs@postgresql.org>.
Result data type Result type Right arg type Role Role name Rules firing always: Rules firing on replica only: Rules: SSL connection (protocol: %s, cipher: %s, bits: %s, compression: %s)
STATEMENT: %s
Schema Security Sequence "%s.%s" Server Settings Size Source Source code Source type Special relation "%s.%s" Start parse Stats target Storage Succeeded.
Superuser TOAST table "%s.%s" Table Table "%s.%s" Table attributes are "%s".
Table attributes unset.
Tablespace Tablespace: "%s" Target type Target width is %d.
Target width is unset.
Template Text search configuration "%s" Text search configuration "%s.%s" Text search parser "%s" Text search parser "%s.%s" The connection to the server was lost. Attempting reset: The server (version %s) does not support access methods.
The server (version %s) does not support altering default privileges.
The server (version %s) does not support collations.
The server (version %s) does not support editing function source.
The server (version %s) does not support editing view definitions.
The server (version %s) does not support extensions.
The server (version %s) does not support foreign servers.
The server (version %s) does not support foreign tables.
The server (version %s) does not support foreign-data wrappers.
The server (version %s) does not support full text search.
The server (version %s) does not support savepoints for ON_ERROR_ROLLBACK.
The server (version %s) does not support showing function source.
The server (version %s) does not support showing view definitions.
The server (version %s) does not support tablespaces.
The server (version %s) does not support user mappings.
There is no previous error. Time: %.3f ms
Timing is off. Timing is on. Title is "%s".
Title is unset.
Token Token name Token types for parser "%s" Token types for parser "%s.%s" Triggers firing always: Triggers firing on replica only: Triggers: Trusted Try "%s --help" for more information.
Tuples only is off.
Tuples only is on.
Type Type "help" for help.
Type: \copyright for distribution terms
\h for help with SQL commands
\? for help with psql commands
\g or terminate with semicolon to execute query
\q to quit
Unicode border line style is "%s".
Unicode column line style is "%s".
Unicode header line style is "%s".
Unlogged index "%s.%s" Unlogged materialized view "%s.%s" Unlogged table "%s.%s" Usage:
Use "\q" to leave %s.
User name Validator Value Variables
Version View "%s.%s" View definition: Volatility WARNING: %s major version %s, server major version %s.
Some psql features might not work.
WARNING: Console code page (%u) differs from Windows code page (%u)
8-bit characters might not work correctly. See psql reference
page "Notes for Windows users" for details.
Wrote history to file "%s".
You are connected to database "%s" as user "%s" on host "%s" at port "%s".
You are connected to database "%s" as user "%s" via socket in "%s" at port "%s".
You are currently not connected to a database.
You are now connected to database "%s" as user "%s" on host "%s" at port "%s".
You are now connected to database "%s" as user "%s" via socket in "%s" at port "%s".
You are now connected to database "%s" as user "%s".
You are using psql, the command-line interface to PostgreSQL. \!: failed
\%s: could not change directory to "%s": %s
\%s: environment variable name must not contain "="
\%s: error while setting variable
\%s: extra argument "%s" ignored
\%s: missing required argument
\connect: %s \copy: arguments required
\copy: parse error at "%s"
\copy: parse error at end of line
\crosstabview: ambiguous column name: "%s"
\crosstabview: column name not found: "%s"
\crosstabview: column number %d is out of range 1..%d
\crosstabview: data column must be specified when query returns more than three columns
\crosstabview: maximum number of columns (%d) exceeded
\crosstabview: query must return at least three columns
\crosstabview: query result contains multiple data values for row "%s", column "%s"
\crosstabview: statement did not return a result set
\crosstabview: vertical and horizontal headers must be different columns
\df does not take a "w" option with server version %s
\df only takes [antwS+] as options
\pset: allowed Unicode border line styles are single, double
\pset: allowed Unicode column line styles are single, double
\pset: allowed Unicode header line styles are single, double
\pset: allowed formats are unaligned, aligned, wrapped, html, asciidoc, latex, latex-longtable, troff-ms
\pset: allowed line styles are ascii, old-ascii, unicode
\pset: unknown option: %s
\watch cannot be used with COPY
\watch cannot be used with an empty query
abort the current transaction aborted because of read failure action agg aggregate_name aggregate_signature alignment analyze_function and conflict_action is one of: and table_constraint is: arg_data_type arg_name arg_type argmode argname argtype argument argument_type arguments attribute attribute_name attribute_option base_type cache cancel a transaction that was earlier prepared for two-phase commit canceled by user cannot duplicate null pointer (internal error)
cannot escape without active connection
change a database change a database role change a run-time parameter change a server configuration parameter change role name or membership change the definition of a collation change the definition of a conversion change the definition of a domain change the definition of a foreign server change the definition of a foreign table change the definition of a foreign-data wrapper change the definition of a function change the definition of a large object change the definition of a materialized view change the definition of a procedural language change the definition of a row level security policy change the definition of a rule change the definition of a schema change the definition of a sequence generator change the definition of a table change the definition of a tablespace change the definition of a text search configuration change the definition of a text search dictionary change the definition of a text search parser change the definition of a text search template change the definition of a trigger change the definition of a type change the definition of a user mapping change the definition of a view change the definition of an aggregate function change the definition of an event trigger change the definition of an extension change the definition of an index change the definition of an operator change the definition of an operator class change the definition of an operator family change the ownership of database objects owned by a database role child process exited with exit code %d child process exited with unrecognized status %d child process was terminated by exception 0x%X child process was terminated by signal %d child process was terminated by signal %s close a cursor cluster a table according to an index collate %s collation collect statistics about a database column_alias column_constraint column_definition column_name command command not executable command not found commit a transaction that was earlier prepared for two-phase commit commit the current transaction compute a set of rows condition configuration_parameter connection to server was lost
constraint constraint_name copy data between a file and a table could not change directory to "%s": %s could not close pipe to external command: %s
could not execute command "%s": %s
could not find a "%s" to execute could not get home directory for user ID %ld: %s
could not identify current directory: %s could not locate temporary directory: %s
could not look up effective user ID %ld: %s could not open temporary file "%s": %s
could not parse reloptions array
could not read binary "%s" could not read from input file: %s
could not read symbolic link "%s" could not save history to file "%s": %s
could not set variable "%s"
could not start /bin/sh
could not start editor "%s"
could not stat file "%s": %s
could not write COPY data: %s
count create a new database create new rows in a table cursor_name data_type database_name deallocate a prepared statement default default %s default_expr define a cursor define a new access method define a new aggregate function define a new cast define a new collation define a new data type define a new database role define a new domain define a new encoding conversion define a new event trigger define a new foreign server define a new foreign table define a new foreign-data wrapper define a new function define a new index define a new mapping of a user to a foreign server define a new materialized view define a new operator define a new operator class define a new operator family define a new procedural language define a new rewrite rule define a new row level security policy for a table define a new savepoint within the current transaction define a new schema define a new sequence generator define a new table define a new table from the results of a query define a new tablespace define a new text search configuration define a new text search dictionary define a new text search parser define a new text search template define a new transform define a new trigger define a new view define access privileges define default access privileges define or change a security label applied to an object define or change the comment of an object definer definition delete rows of a table delimiter delimiter_character dest_encoding destroy a previously defined savepoint dictionary_name direction directory disabled discard session state domain constraint domain_constraint domain_name element empty a table or set of tables enabled encoding encoding_name end_function environment variable PSQL_EDITOR_LINENUMBER_ARG must be set to specify a line number
escape_character event execute a prepared statement execution_cost expression extension_name filename for table "%s.%s" force a transaction log checkpoint foreign table format_name function function name is required
function_name garbage-collect and optionally analyze a database generate a notification gettoken_function group_name handler_function headline_function history is not supported by this installation
immutable import table definitions from a foreign server in assignment index index_column_name index_expression index_method index_name index_parameters init_function input_function integer invalid binary "%s" invalid command \%s
invalid line number: %s
invalid output format (internal error): %d invoker istemplate large_object_oid lc_ctype left_type lexize_function lextypes_function like_option link_symbol listen for a notification load a shared library file local socket local_schema locale lock a table materialized view maxvalue method minvalue more than one row returned for \gset
name new_attribute_name new_column_name new_constraint_name new_dictionary new_name new_owner new_role new_schema new_table new_tablespace new_version no no query buffer
no rows returned for \gset
normal not null null_string obj_file object_name off old_dictionary old_role old_version on op_type operator operator class operator family operator_name option out of memory out of memory
output_expression output_function parameter parent_table parser_name password pclose failed: %s policy_name position a cursor predicate prepare a statement for execution prepare the current transaction for two-phase commit primary key, psql is the PostgreSQL interactive terminal.
psql variables:
query quote_character rebuild indexes receive_function refcolumn reftable relation_name remote_schema remove a cast remove a collation remove a conversion remove a data type remove a database remove a database role remove a domain remove a foreign server descriptor remove a foreign table remove a foreign-data wrapper remove a function remove a materialized view remove a procedural language remove a rewrite rule remove a row level security policy from a table remove a schema remove a sequence remove a table remove a tablespace remove a text search configuration remove a text search dictionary remove a text search parser remove a text search template remove a transform remove a trigger remove a user mapping for a foreign server remove a view remove access privileges remove an access method remove an aggregate function remove an event trigger remove an extension remove an index remove an operator remove an operator class remove an operator family remove database objects owned by a database role restart restore the value of a run-time parameter to the default value restricted retrieve rows from a query using a cursor retrieve rows from a table or view right_type role_name role_specification roll back to a savepoint rule rule_name safe sampling_method savepoint_name schema_name send_function sequence sequence_name server_name server_type server_version set constraint check timing for the current transaction set the characteristics of the current transaction set the current user identifier of the current session set the session user identifier and the current user identifier of the current session show the execution plan of a statement show the value of a run-time parameter skipping recursive expansion of variable "%s"
sort_operator source_config source_encoding source_table source_type special stable start start a transaction block start_function statement stop listening for a notification storage storage_type tab completion query failed: %s
Query was:
%s
table table constraint table_constraint table_name tablespace_name tablespace_option target_role target_type template token_type transaction_mode trigger trigger_name trying to exit copy mode type type_name unexpected PQresultStatus: %d
unexpected result status for \watch
unexpected transaction status (%d)
unique, unknown unrecognized value "%s" for "%s"; assuming "%s"
unsafe unterminated quoted string
update rows of a table user does not exist user name lookup failure: error code %lu user_name valfunction validator_function value values version view view name is required
view_option_name volatile where action is one of: where aggregate_signature is: where column_constraint is: where conflict_target can be one of: where constraint is: where direction can be empty or one of: where event can be one of: where lockmode is one of: where option can be one of: where option can be: where role_specification can be: where transaction_mode is one of: window window_definition window_name yes Project-Id-Version: PostgreSQL 9.6
Report-Msgid-Bugs-To: pgsql-bugs@postgresql.org
POT-Creation-Date: 2016-09-26 14:02+0900
PO-Revision-Date: 2016-09-27 01:42+0900
Last-Translator: Ioseph Kim <ioseph@uri.sarang.net>
Language-Team: Korean <pgsql-translators@postgresql.org>
Language: ko
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: 8bit
Plural-Forms: nplurals=1; plural=0;
연결 옵션들:
출력 설정들:
OS 환경 변수들:
자세한 내용을 보려면 psql 내에서 "\?"(내부 명령) 또는 "\help"(SQL
명령)를 입력하거나 PostgreSQL
설명서에서 psql 섹션을 참조하십시오.
입출력 옵션:
출력 형식 옵션:
파서: "%s"
파서: "%s.%s" --help=commands psql 내장명령어(\문자로 시작하는)를 표시하고 종료
--help=variables 특별 변수들 보여주고, 종료
(옵션: S = 시스템 개체 표시, + = 추가 상세 정보)
-0, --record-separator-zero
unaligned 출력용 레코드 구분자를 0 바이트로 지정
-1 ("one"), --single-transaction
명령 파일을 하나의 트랜잭션으로 실행
-?, --help[=options] 이 도움말을 표시하고 종료
-A, --no-align 정렬되지 않은 표 형태의 출력 모드
-E, --echo-hidden 내부 명령이 생성하는 쿼리 표시
-F, --field-separator=STRING
unaligned 출력용 필드 구분자 설정(기본 값: "%s")
-H, --html HTML 표 형태 출력 모드
-L, --log-file=FILENAME 세션 로그를 파일로 보냄
-P, --pset=VAR[=ARG] 인쇄 옵션 VAR을 ARG로 설정(\pset 명령 참조)
-R, --record-separator=STRING
unaligned 출력용 레코드 구분자 설정
(기본 값: 줄바꿈 문자)
-S, --single-line 한 줄 모드(줄 끝에서 SQL 명령이 종료됨)
-T, --table-attr=TEXT HTML table 태그 속성 설정(예: width, border)
-U, --username=USERNAME 데이터베이스 사용자 이름(기본 값: "%s")
-V, --version 버전 정보를 보여주고 마침
-W, --password 암호 입력 프롬프트 보임(자동으로 처리함)
-X, --no-psqlrc 시작 파일(~/.psqlrc)을 읽지 않음
-a, --echo-all 스크립트의 모든 입력 표시
-b, --echo-errors 실패한 명령들 출력
-c, --command=COMMAND 하나의 명령(SQL 또는 내부 명령)만 실행하고 끝냄
-d, --dbname=DBNAME 연결할 데이터베이스 이름(기본 값: "%s")
-e, --echo-queries 서버로 보낸 명령 표시
-f, --file=FILENAME 파일 안에 지정한 명령을 실행하고 끝냄
-h, --host=HOSTNAME 데이터베이스 서버 호스트 또는 소켓 디렉터리
(기본값: "%s")
-l, --list 사용 가능한 데이터베이스 목록을 표시하고 끝냄
-n, --no-readline 확장된 명령행 편집 기능을 사용중지함(readline)
-o, --output=FILENAME 쿼리 결과를 파일(또는 |파이프)로 보냄
-p, --port=PORT 데이터베이스 서버 포트(기본 값: "%s")
-q, --quiet 자동 실행(메시지 없이 쿼리 결과만 표시)
-s, --single-step 단독 순차 모드(각 쿼리 확인)
-t, --tuples-only 행만 인쇄
-v, --set=, --variable=NAME=VALUE
psql 변수 NAME을 VALUE로 설정
(예, -v ON_ERROR_STOP=1)
-w, --no-password 암호 프롬프트 표시 안 함
-x, --expanded 확장된 표 형태로 출력
-z, --field-separator-zero
unaligned 출력용 필드 구분자를 0 바이트로 지정
AUTOCOMMIT 지정 하면 SQL 명령이 성공하면 자동으로 커밋
COLUMNS 다음 줄로 넘어갈 칼럼 수
DBNAME 현재 접속한 데이터베이스 이름
ENCODING 현재 클라이언트 인코딩
HOST 현재 접속한 데이터베이스 서버
LASTOID 마지막 영향 받은 OID
NAME=VALUE [NAME=VALUE] psql ...
또는 psql 명령 모드에서는 \setenv NAME [VALUE]
PAGER 페이지 단위 보기에서 사용할 프로그램
PGAPPNAME application_name 변수값으로 사용됨
PGDATABASE 접속할 데이터베이스 이름
PGHOST 서버 접속용 호스트 이름
PGPASSFILE 서버 접속용 비밀번호가 저장된 파일 이름
PGPASSWORD 서버 접속 비밀번호 (보안에 취약함)
PGPORT 서버 접속용 포트
PGUSER 서버 접속용 데이터베이스 사용자 이름
PORT 현재 접속한 서버 포트
PSQLRC 사용자 .psqlrc 파일의 임의 지정
PSQL_EDITOR, EDITOR, VISUAL
\e, \ef, \ev 명령에서 사용할 외부 편집기 경로
PSQL_EDITOR_LINENUMBER_ARG
외부 편집기 호출 시 사용할 줄번호 선택 옵션
PSQL_HISTORY 사용자 .psql_history 파일 임의 지정
QUIET 조용히 실행 (-q 옵션과 같음)
SHELL \! 명령에서 사용할 쉘
TMPDIR 임시 파일을 사용할 디렉터리
USER 현재 접속한 데이터베이스 사용자
\! [COMMAND] 셸 명령 실행 또는 대화식 셸 시작
\? [commands] psql 역슬래시 명령어 설명
\? options psql 명령행 옵션 도움말 보기
\? variables psql 환경 설정 변수들에 설명 보기
\C [STRING] 테이블 제목 설정 또는 값이 없는 경우 설정 안 함
\H HTML 출력 모드 전환(현재 %s)
\T [STRING] HTML <table> 태그 속성 설정 또는 비었는 경우 설정 안 함
\a 정렬되지 않은 출력 모드와 정렬된 출력 모드 전환
\c[onnect] {[DBNAME|- USER|- HOST|- PORT|-] | conninfo}
새 데이터베이스에 접속 (현재 "%s")
\c[onnect] {[DBNAME|- USER|- HOST|- PORT|-] | conninfo}
새 데이터베이스에 접속 (현재 접속해 있지 않음)
\cd [DIR] 현재 작업 디렉터리 변경
\conninfo 현재 데이터베이스 접속 정보 보기
\copy ... 클라이언트 호스트에 있는 자료를 SQL COPY 명령 실행
\copyright PostgreSQL 사용법 및 저작권 정보 표시
\crosstabview [칼럼들] 쿼리를 실행하고, 피봇 테이블 형태로 자료를 보여줌
\dA[+] [PATTERN] 접근 방법 목록
\dC[+] [PATTERN] 자료형 변환자 목록
\dD[S+] [PATTERN] 도메인 목록
\dE[S+] [PATTERN] 외부 테이블 목록
\dF[+] [PATTERN] 텍스트 검색 구성 목록
\dFd[+] [PATTERN] 텍스트 검색 사전 목록
\dFp[+] [PATTERN] 텍스트 검색 파서 목록
\dFt[+] [PATTERN] 텍스트 검색 템플릿 목록
\dL[S+] [PATTERN] 프로시져 언어 목록
\dO[S+] [PATTERN] collation 목록
\dT[S+] [PATTERN] 데이터 형식 목록
\d[S+] 테이블, 뷰 및 시퀀스 목록
\d[S+] NAME 테이블, 뷰, 시퀀스 또는 인덱스 설명
\da[S] [PATTERN] 집계 함수 목록
\db[+] [PATTERN] 테이블스페이스 목록
\dc[S+] [PATTERN] 문자셋 변환자 목록
\dd[S] [PATTERN] 다른 곳에서는 볼 수 없는 객체 설명을 보여줌
\ddp [PATTERN] 기본 접근권한 목록
\des[+] [PATTERN] 외부 서버 목록
\det[+] [PATTERN] 외부 테이블 목록
\deu[+] [PATTERN] 사용자 매핑 목록
\dew[+] [PATTERN] 외부 데이터 래퍼 목록
\df[antw][S+] [PATRN] [only agg/normal/trigger/window] 함수 목록
\dg[S+] [PATTERN] 롤 목록
\di[S+] [PATTERN] 인덱스 목록
\dl 큰 개체 목록, \lo_list 명령과 같음
\dm[S+] [PATTERN] materialized 뷰 목록
\dn[S+] [PATTERN] 스키마 목록
\do[S] [PATTERN] 연산자 목록
\dp [PATTERN] 테이블, 뷰 및 시퀀스 액세스 권한 목록
\drds [PATRN1 [PATRN2]] 데이터베이스별 롤 설정 목록
\ds[S+] [PATTERN] 시퀀스 목록
\dt[S+] [PATTERN] 테이블 목록
\du[S+] [PATTERN] 롤 목록
\dv[S+] [PATTERN] 뷰 목록
\dx[+] [PATTERN] 확장 모듈 목록
\dy [PATTERN] 이벤트 트리거 목록
\e [FILE] [LINE] 외부 편집기로 쿼리 버퍼(또는 파일) 편집
\echo [STRING] 문자열을 표준 출력에 기록
\ef [FUNCNAME [LINE]] 외부 편집기로 해당 함수 내용 편집
\encoding [ENCODING] 클라이언트 인코딩 표시 또는 설정
\errverbose 최대 자세히 보기 상태에서 최근 오류를 다 보여줌
\ev [VIEWNAME [LINE]] 외부 편집기로 해당 뷰 정의 편집
\f [STRING] unaligned 출력에 대해 필드 구분자 표시 또는 설정
\g [FILE] 또는 ; 쿼리 실행(및 결과를 파일 또는 |파이프로 보냄)
\gexec 쿼리를 실행하고, 그 결과를 각각 실행 함
\gset [PREFIX] 쿼리 실행 뒤 그 결과를 psql 변수로 저장
\h [NAME] SQL 명령 구문 도움말, 모든 명령을 표시하려면 * 입력
\i FILE 파일에서 명령 실행
\ir FILE \i 명령과 같으나, 경로가 현재 위치 기준 상대적
\l[+] [PATTERN] 데이터베이스 목록
\lo_export LOBOID FILE
\lo_import FILE [COMMENT]
\lo_list
\lo_unlink LOBOID 큰 개체 작업
\o [FILE] 모든 쿼리 결과를 파일 또는 |파이프로 보냄
\p 쿼리 버퍼의 내용 표시
\password [USERNAME] 사용자 암호를 안전하게 변경
\prompt [TEXT] NAME 사용자에게 내부 변수를 설정하라는 메시지 표시
\pset [NAME [VALUE]] 표 출력 옵션
(NAME := {format|border|expanded|fieldsep|
fieldsep_zero|footer|null|numericlocale|recordsep|
recordsep_zero|tuples_only|title|tableattr|pager|
unicode_border_linestyle|unicode_column_linestyle|
unicode_header_linestyle})
\q psql 종료
\qecho [STRING] 문자열을 쿼리 출력 스트림에 기록(\o 참조)
\r 쿼리 버퍼 초기화(모두 지움)
\s [FILE] 기록 표시 또는 파일에 저장
\set [NAME [VALUE]] 내부 변수 설정 또는 미지정 경우 모든 변수 목록 표시
\setenv NAME [VALUE] 환경 변수 지정 및 해제
\sf[+] 함수이름 함수 정의 보기
\sv[+] 뷰이름 뷰 정의 보기
\t [on|off] 행만 표시(현재 %s)
\timing [on|off] 명령 실행 시간 전환(현재 %s)
\unset NAME 내부 변수 설정 해제(삭제)
\w FILE 쿼리 버퍼를 파일에 기록
\watch [SEC] 매 초마다 쿼리 실행
\x [on|off|auto] 확장된 출력 전환 (현재 %s)
\z [PATTERN] \dp와 같음
border 테두리 모양 (숫자)
columns 줄바꿈을 위한 너비 지정
expanded (또는 x) 확장된 출력 전환 [on, off, auto]
fieldsep unaligned 출력용 필드 구분자 (초기값 "%s"')
fieldsep_zero unaligned 출력용 필드 구분자를 0 바이트로 지정
footer 테이블 꼬리말 보이기 전환 [on, off]
format 출력 양식 지정 [unaligned, aligned, wrapped, html, asciidoc, ...]
psql --pset=NAME[=VALUE]
또는 psql 명령 모드에서는 \pset NAME [VALUE]
psql --set=NAME=VALUE
또는 psql 명령 모드에서는 \set NAME VALUE
psql [OPTION]... [DBNAME [USERNAME]]
recordsep unaligned 출력용 레코드(줄) 구분자
recordsep_zero unaligned 출력용 레코드 구분자를 0 바이트로 지정
set NAME=VALUE
psql ...
또는 psql 명령 모드에서는 \setenv NAME [VALUE]
title 테이블 제목 지정
tuples_only 지정되면, 자료만 보임
unicode_border_linestyle
unicode_column_linestyle
unicode_header_linestyle
유니코드 선 종류 [single, double]
"%s.%s" 뷰(view)가 아님
%d개 연결 %s %s %s (%g초 간격)
%s
%s(%s, %s 서버)
%s (%g초 간격)
%s: %s
%s: -1 옵션은 비대화형 모드에서만 사용할 수 있음
%s: 디렉터리부터 또는 디렉터리로 복사할 수 없음
%s: "%s" 변수를 지울 수 없음
%s: 실행 가능한 프로그램을 찾을 수 없습니다
%s: "%s" 로그 파일을 열 수 없음: %s
%s: 출력 매개 변수 "%s" 지정할 수 없음
%s: "%s" 변수를 지정할 수 없음
%s: 현재 트랜잭션 중지됨
%s: 타당치 못한 인코딩 이름 또는 문자셋 변환 프로시저 없음
%s: 데이터베이스에 연되어있지 않음
%s: 메모리 부족
%s: 알 수 없는 트랜잭션 상태
%s: 경고: 추가 명령행 인수 "%s" 무시됨
(%lu개 행) ***(단독 순차 모드: 쿼리 확인)*********************************************
%s
***(Enter: 계속 진행, x Enter: 중지)********************
********** 쿼리 **********
%s
**************************
+ opt(%d) = |%s|
, 클러스됨 , 잘못됨 , predicate (%s) , "%s" 테이블스페이스 액세스 권한 현재 접속 정보가 없습니다. 접속을 위한 연결 관련 매개변수를 지정하세요
인자 자료형 동기화 신호 "%s" 받음, 해당 서버 프로세스 PID %d.
"%s" 비동기 통지를 받음, 부가정보: "%s", 보낸 프로세스: %d.
속성 사용 가능한 도움말:
html 테이블의 테두리를 %d로 지정했습니다.
COPY 자료 변환 실패: %s 호출 핸들러 테이블 내용에 셀을 추가할 수 없음: 총 셀 수가 %d개를 초과했습니다.
테이블 내용에 헤더를 추가할 수 없음: 열 수가 %d개를 초과했습니다.
로그인할 수 없음 체크 체크 제약 조건: 하위 테이블 Collate 필드명 칼럼 접근권한 명령: %s
설명: %s
문법:
%s
"%s.%s" 복합자료형 연결
DB 만들기 롤 만들기 Ctype 데이터베이스 기본 접근권한 기본 꼬릿말 보기 기능 끔.
기본 꼬릿말 보기 기능 켬.
초기값? 정의 설명 설명 사전 "%s" 이름의 확장 기능 모듈을 찾을 수 없습니다.
추가할 확장 기능 모듈이 없음.
"%s" 이름을 릴레이션(relation) 없음.
%s oid의 어떤 릴레이션(relation)도 찾을 수 없음.
"%s"(이)라는 텍스트 검색 구성을 찾지 못했습니다.
"%s"(이)라는 텍스트 검색 파서를 찾지 못했습니다.
사용중지된 내부 트리거: 사용중지된 규칙: 사용중지된 트리거: 사용중지된 사용자 트리거: 요소 활성화 인코딩 구문 분석 종료 한 줄에 한 레코드씩 데이터를 입력하고
자료입력이 끝나면 backslash 점 (\.) 마지막 줄 처음에 입력합니다. 다시 입력해 주세요: 새 암호를 입력하세요: 이벤트 칼럼 단위 보기 기능 끔.
칼럼 단위 보기 기능 켬.
칼럼 단위 보기 기능을 자동으로 지정 함.
FDW 옵션 실패.
필드 구분자 "%s".
필드 구분자가 0 바이트입니다.
"%s.%s" 외부 테이블 외부 데이터 래퍼 참조키 제약 조건: 출력 형식
함수 일반
일반 옵션:
헤드라인 가져오기 다음 토큰 가져오기 토큰 형식 가져오기 핸들러 OID 사용: yes 도움말
ID Implicit? 인덱스 "%s.%s" 인덱스 인덱스들: 정보보기
상속 초기화 초기화 옵션 인라인 핸들러 입력/출력
내부 언어 내부 이름 인트럽트발생
잘못된 명령: \%s. 도움말은 \?.
언어 큰 개체
Large objects 왼쪽 인수 자료형 Lexize 선 모양: %s.
접근 방법 목록 통계 함수 목록 형변환자 목록 문자 정렬 목록 문자코드변환규칙(conversion) 목록 자료형 목록 데이터베이스 목록 도메인(domain) 목록 이벤트 트리거 목록 외부 서버 목록 외부 테이블 목록 외부 데이터 래퍼 목록 함수 목록 설치된 확장기능 목록 언어 목록 연산자 목록 릴레이션(relation) 목록 롤 목록 스키마(schema) 목록 설정 목록 특별한 기능 설정 변수 목록
테이블스페이스 목록 텍스트 검색 구성 목록 텍스트 검색 사전 목록 텍스트 검색 파서 목록 텍스트 검색 템플릿 목록 사용자 매핑 목록 로케일 맞춤 숫자 표기 기능 끔.
로케일 맞춤 숫자 표기 기능 켬.
위치 Materialized 뷰 "%s.%s" 소속 그룹: 방법 기타 조건 기타 조건 이름 변경 내용 없음 연결 없음 "%s" 명령에 대한 도움말 없음.
\h 명령을 인자 없이 호출 하면 사용 가능한 모든 명령 보여줌.
상속 없음 검색조건에 일치하는 릴레이션(relation) 없음.
찾는 설정이 없습니다.
이 버전의 서버는 데이터베이스 단위 롤 설정이 안됩니다.
릴레이션(relation) 없음.
설정 없음.
Null 값은 "%s" 문자로 보여짐.
하위 테이블 수: %d (\d+ 명령으로 볼 수 있음) 개체 객체 설명 개체 설명 "%s" 확장 기능 안에 포함된 객체들 운영 체제
옵션 현재 출력 형식: %s.
소유주: %s 소유주 항상 페이저가 사용됨.
긴 출력을 위해 페이저가 사용됨.
화면단위 보기 기능 끔(전체 자료 모두 보여줌).
%d 줄보다 적은 경우는 페이지 단위 보기가 사용되지 않음
병렬처리 암호 암호화 실패
%s 사용자의 암호: 암호: 암호가 서로 틀립니다.
정책 이전 연결이 유지되었음
프로시져 쿼리 버퍼
쿼리 버퍼가 비었음. 쿼리 버퍼 초기화 (비웠음). 레코드 구분자 "%s".
레코드 구분자는 줄바꿈 문자입니다.
레코드 구분자가 0 바이트임.
다음에서 참조됨: 복제 오류보고: <pgsql-bugs@postgresql.org>.
반환 자료형 반환 자료형 오른쪽 인수 자료형 롤 롤 이름 항상 발생하는 규칙: 복제본에서만 발생하는 규칙: 룰(rule)들: SSL 연결정보 (프로토콜: %s, 암호화기법: %s, 비트: %s, 압축: %s)
명령 구문: %s
스키마 보안 "%s.%s" 시퀀스 서버 설정 크기 소스 소스 코드 Source 자료형 "%s.%s" 특수 릴레이션(relation) 구문 분석 시작 통계수집량 스토리지 성공.
슈퍼유저 "%s.%s" TOAST 테이블 테이블 "%s.%s" 테이블 테이블 속성: "%s".
테이블 속성 모두 지움.
테이블스페이스 테이블스페이스: "%s" Target 자료형 대상 너비는 %d입니다.
대상 너비 미지정.
템플릿 텍스트 검색 구성 "%s" 텍스트 검색 구성 "%s.%s" "%s" 텍스트 검색 파서 "%s.%s" 텍스트 검색 파서 서버로부터 연결이 끊어졌습니다. 다시 연결을 시도합니다: 서버(%s 버전)에서 접근 방법을 지원하지 않습니다.
이 서버(%s 버전)는 기본 접근권한 변경 기능을 제공하지 않습니다.
이 서버(%s 버전)는 문자 정렬(collation) 기능을 지원하지 않습니다.
이 서버(%s 버전)는 함수 소스 편집 기능을 제공하지 않습니다.
이 서버(%s 버전)는 뷰 정의 편집 기능을 제공하지 않습니다.
이 서버(%s 버전)에서 확장기능을 지원하지 않습니다.
이 서버(%s 버전)에서 외부 서버를 지원하지 않습니다.
이 서버(%s 버전)에서 외부 테이블을 지원하지 않습니다.
이 서버(%s 버전)에서 외부 데이터 래퍼를 지원하지 않습니다.
이 서버(%s 버전)에서 전문 검색을 지원하지 않습니다.
서버(%s 버전)에서 ON_ERROR_ROLLBACK에 사용할 savepoint를 지원하지 않습니다.
이 서버(%s 버전)는 함수 소스 보기 기능을 제공하지 않습니다.
이 서버(%s 버전)는 뷰 정의 보기 기능을 제공하지 않습니다.
서버(%s 버전)에서 테이블스페이스를 지원하지 않습니다.
이 서버(%s 버전)에서 사용자 매핑을 지원하지 않습니다.
이전 오류가 없습니다. 작업시간: %.3f ms
작업수행시간 숨김 작업수행시간 보임 출력 테이블의 제목: "%s"
출력 테이블의 제목을 지정하지 않았습니다.
토큰 토큰 이름 "%s" 파서의 토큰 형식 "%s.%s" 파서의 토큰 형식 항상 발생하는 트리거: 복제본에서만 발생하는 트리거: 트리거들: 신뢰됨 자세한 도움말은 "%s --help"
자료만 보기 기능 끔.
자료만 보기 기능 켬.
종류 도움말을 보려면 "help"를 입력하십시오.
사용법: \copyright 저작권 정보
\h SQL 명령 도움말
\? psql 명령 도움말
\g 또는 명령 끝에 세미콜론(;) 쿼리 실행
\q 종료
유니코드 테두리 선문자: "%s".
유니코드 칼럼 선문자: "%s".
유니코드 헤더 선문자: "%s".
"%s.%s" 로그 미사용 인덱스 트랜잭션 로그를 남기지 않은 구체화된 뷰 "%s.%s" 로그 미사용 테이블 "%s.%s" 사용법:
마치려면 "\q"를 입력하세요: %s
사용자 이름 유효성 검사기 값 변수
버전 "%s.%s" 뷰(view) 뷰 정의: 휘발성 경고: %s 메이저 버전 %s, 서버 메이저 버전 %s.
일부 psql 기능이 작동하지 않을 수도 있습니다.
경고: 콘솔 코드 페이지(%u)가 Windows 코드 페이지(%u)와 달라서
8비트 문자가 올바르게 표시되지 않을 수 있습니다. 자세한 내용은 psql 참조
페이지 "Notes for Windows users"를 참조하십시오.
명령내역(history)을 "%s" 파일에 기록했습니다.
접속정보: 데이터베이스="%s", 사용자="%s", 호스트="%s", 포트="%s".
접속정보: 데이터베이스="%s", 사용자="%s", 소켓="%s", 포트="%s".
현재 데이터베이스에 연결되어있지 않습니다.
접속정보: 데이터베이스="%s", 사용자="%s", 호스트="%s", 포트="%s".
접속정보: 데이터베이스="%s", 사용자="%s", 소켓="%s", 포트="%s".
접속정보: 데이터베이스="%s", 사용자="%s".
PostgreSQL에 대한 명령행 인터페이스인 psql을 사용하고 있습니다. \!: 실패
\%s: "%s" 디렉터리로 이동할 수 없음: %s
\%s: OS 환경 변수 이름에는 "=" 문자가 없어야 함
\%s: 변수 지정 실패
\%s: "%s" 추가 인수가 무시되었음
\%s: 필요한 인수가 빠졌음
\연결: %s \copy: 인수가 필요합니다
\copy: 구문 오류: "%s"
\copy: 줄 끝에 구문 오류
\crosstabview: 칼럼 이름이 중복되었음: "%s"
\crosstabview: 칼럼 이름 없음: "%s"
\crosstabview: %d 번째 열은 0..%d 범위를 벗어났음
\crosstabview: 처리할 칼럼이 세개보다 많을 때는 자료로 사용할 칼럼을 지정해야 함
\crosstabview: 최대 칼럼 수 (%d) 초과
\crosstabview: 쿼리 결과는 적어도 세 개의 칼럼은 반환 해야 함
\crosstabview: "%s" 로우, "%s" 칼럼에 대해 쿼리 결과는 다중값이어야 함
\crosstabview: 구문 결과가 집합을 반환하지 않았음
\crosstabview: 행과 열의 칼럼이 각각 다른 칼럼이어야 함
\df 명령은 %s 버전 서버에서는 "w" 옵션을 사용하지 않음
\df는 [antwS+]만 옵션으로 사용함
\pset: 사용할 수 있는 유니코드 테두리 모양은 single, double
\pset: 사용할 수 있는 유니코드 칼럼 선 모양은 single, double
\pset: 사용할 수 있는 유니코드 헤더 선 모양은 single, double
\pset: 허용되는 출력 형식: unaligned, aligned, wrapped, html, asciidoc, latex, latex-longtable, troff-ms
\pset: 사용할 수 있는 선 모양은 ascii, old-ascii, unicode
\pset: 알 수 없는 옵션: %s
\watch 작업으로 COPY 명령은 사용할 수 없음
\watch 명령으로 수행할 쿼리가 없습니다.
현재 트랜잭션 중지함 읽기 실패로 중지됨 동작 집계 집계함수이름 집계함수_식별구문 정렬 분석함수 conflict_action 사용법: 테이블_제약조건 사용법: 인자자료형 인자이름 인자자료형 인자모드 인자이름 인자자료형 인자 인자자료형 인자들 속성 속성이름 속성_옵션 기본자료형 캐쉬 two-phase 커밋을 위해 먼저 준비되었던 트랜잭션 실행취소하기 사용자에 의해서 취소됨 null 포인터를 복제할 수 없음(내부 오류)
현재 접속한 연결 없이는 특수문자처리를 할 수 없음
데이터베이스 변경 데이터베이스 롤 변경 실시간 환경 변수값 바꾸기 서버 환경 설정 매개 변수 바꾸기 롤 이름이나 맴버쉽 바꾸기 collation 정의 바꾸기 문자코드 변환규칙(conversion) 정보 바꾸기 도메인 정보 바꾸기 외부 서버 정의 바꾸기 외부 테이블 정의 바꾸기 외부 데이터 래퍼 정의 바꾸기 함수 정보 바꾸기 대형 객체 정의 바꾸기 materialized 뷰 정의 바꾸기 procedural language 정보 바꾸기 로우 단위 보안 정책의 정의 바꾸기 룰 정의 바꾸기 스키마 이름 바꾸기 시퀀스 정보 바꾸기 테이블 정보 바꾸기 테이블스페이스 정의 바꾸기 텍스트 검색 구성 정의 바꾸기 텍스트 검색 사전 정의 바꾸기 텍스트 검색 파서 정의 바꾸기 텍스트 검색 템플릿 정의 바꾸기 트리거 정보 바꾸기 자료형 정의 바꾸기 사용자 매핑 정의 바꾸기 뷰 정의 바꾸기 집계함수 정보 바꾸기 트리거 정보 바꾸기 확장모듈 정의 바꾸기 인덱스 정의 바꾸기 연산자 정의 바꾸기 연산자 클래스 정보 바꾸기 연산자 부류의 정의 바꾸기 데이터베이스 롤로 권한이 부여된 데이터베이스 개체들의 소유주 바꾸기 하위 프로세스가 %d 코드로 종료했음 하위 프로세스가 알 수 없는 상태(%d)로 종료되었음 0x%X 예외처리에 의해 하위 프로세스가 종료되었음 하위 프로세스가 %d 신호를 받고 종료되었음 %s 시그널 감지로 하위 프로세스가 종료되었음 커서 닫기 지정한 인덱스 기준으로 테이블 자료를 다시 저장함 collate %s collation 데이터베이스 사용 통계 정보를 갱신함 칼럼별칭 칼럼_제약조건 칼럼정의 칼럼이름 명령어 명령을 실행할 수 없음 명령어를 찾을 수 없음 two-phase 커밋을 위해 먼저 준비된 트랜잭션을 커밋하세요. 현재 트랜잭션 commit compute a set of rows 조건 환경설정_매개변수 서버로부터 연결이 끊어졌습니다.
제약조건 제약조건_이름 테이블과 파일 사이 자료를 복사함 "%s" 이름의 디렉터리로 이동할 수 없습니다: %s 외부 명령으로 파이프를 닫을 수 없음: %s
"%s" 명령을 실행할 수 없음: %s
실행할 "%s" 파일 찾을 수 없음 UID %ld 사용자의 홈 디렉터리를 찾을 수 없음: %s
현재 디렉터리를 찾을 수 없음: %s 임시 디렉터리 경로를 알 수 없음: %s
UID %ld 해당하는 사용자를 찾을 수 없음: %s "%s" 임시 파일을 열 수 없음: %s
reloptions 배열을 분석할 수 없음
"%s" 바이너리 파일을 읽을 수 없음 입력 파일을 읽을 수 없음: %s
"%s" 실벌릭 링크를 읽을 수 없음 history를 "%s" 파일로 저장할 수 없음: %s
"%s" 변수를 지정할 수 없음
/bin/sh 명령을 실행할 수 없음
"%s" 문서 편집기를 실행시킬 수 없음
"%s" 파일의 상태값을 알 수 없음: %s
COPY 자료를 기록할 수 없음: %s
출력개수 데이터베이스 생성 테이블 자료 삽입 커서이름 자료형 데이터베이스이름 준비된 구문(prepared statement) 정의 기본값 초기값 %s 초기값_표현식 커서 지정 새 접속 방법 정의 새 집계합수 만들기 새 형변환자 만들기 새 collation 만들기 새 자료형 만들기 새 데이터베이스 롤 만들기 새 도메인 만들기 새 문자코드변환규칙(conversion) 만들기 새 이벤트 트리거 만들기 새 외부 서버 정의 새 외부 테이블 정의 새 외부 데이터 래퍼 정의 새 함수 만들기 새 인덱스 만들기 사용자와 외부 서버 간의 새 매핑 정의 새 materialized 뷰 만들기 새 연산자 만들기 새 연잔자 클래스 만들기 새 연산자 부류 만들기 새 프로시주얼 언어 만들기 새 룰(rule) 만들기 특정 테이블에 로우 단위 보안 정책 정의 현재 트랜잭션에서 새로운 savepoint 만들기 새 스키마(schema) 만들기 새 시퀀스 만들기 새 테이블 만들기 쿼리 결과를 새 테이블로 만들기 새 테이블스페이스 만들기 새 텍스트 검색 구성 정의 새 텍스트 검색 사전 정의 새 텍스트 검색 파서 정의 새 텍스트 검색 템플릿 정의 새 transform 만들기 새 트리거 만들기 새 view 만들기 액세스 권한 지정하기 기본 접근 권한 정의 해당 개체에 보안 라벨을 정의하거나 변경 해당 개체의 코멘트를 지정하거나 수정함 definer 함수정의 테이블의 자료 삭제 구분자 구분문자 대상인코딩 이전 정의된 savepoint를 파기함 사전이름 방향 디렉터리 비활성화 세션 상태 삭제 도메인 제약조건 도메인_제약조건 도메인이름 요소 하나 또는 지정한 여러개의 테이블에서 모든 자료 지움 활성화 인코딩 인코딩이름 종료_함수 지정한 줄번호를 사용하기 위해서는 PSQL_EDITOR_LINENUMBER_ARG 이름의 OS 환경변수가 설정되어 있어야 합니다.
이스케이프 문자 이벤트 준비된 구문(prepared statement) 실행 실행비용 표현식 확장모듈이름 파일이름 적용테이블: "%s.%s" 트랜잭션 로그를 강제로 checkpoint함 외부 테이블 입출력양식이름 함수 함수 이름이 필요합니다
함수이름 물리적인 자료 정리 작업 - 쓰레기값 청소 특정 서버 메시지 발생 gettoken함수 그룹이름 핸들러_함수 headline함수 히스토리 기능은 이 설치본에서는 지원하지 않음
immutable 외부 서버로부터 테이블 정의 가져오기 in assignment 인덱스 인덱스칼럼이름 인덱스표현식 색인방법 인덱스이름 색인매개변수 init함수 입력함수 정수 잘못된 바이너리 파일: "%s" 잘못된 명령: \%s
잘못된 줄 번호: %s
잘못된 출력 형식 (내부 오류): %d invoker true|false 대형_객체_oid lc_ctype 왼쪽인자_자료형 lexize함수 lextypes함수 LIKE구문옵션 연결할_함수명 특정 서버 메시지 수신함 공유 라이브러리 파일 로드 로컬 소켓 로컬_스키마 로케일 테이블 잠금 구체화된 뷰 최대값 색인방법 최소값 \gset 실행 결과가 단일 자료가 아님
이름 새속성이름 새칼럼이름 새제약조건_이름 새사전 새이름 새사용자 새롤 새스키마 새테이블 새테이블스페이스 새버전 아니오 쿼리 버퍼가 없음
\gset 해당 자료 없음
일반 Null 아님 널문자열 오브젝트파일 객체이름 off 옛사전 기존롤 옛버전 on 연산자자료형 연산자 연산자 클래스 연산자 부류 연산자이름 옵션 메모리 부족 메모리 부족
출력표현식 출력함수 매개변수 상위_테이블 구문분석기_이름 암호 pclose 실패: %s 정책이름 커서 위치 옮기기 범위한정구문 준비된 구문(prepared statement) 만들기 two-phase 커밋을 위해 현재 트랜잭션을 준비함 기본키, psql은 PostgreSQL 대화식 터미널입니다.
psql 변수들:
쿼리문 인용부호 인덱스 다시 만들기 받는함수 참조칼럼 참조테이블 릴레이션이름 원격_스키마 형변환자 삭제 collation 삭제 문자코드 변환규칙(conversion) 삭제 자료형 삭제 데이터베이스 삭제 데이터베이스 롤 삭제 도메인 삭제 외부 서버 설명자 제거 외부 테이블 삭제 외부 데이터 래퍼 제거 함수 삭제 materialized 뷰 삭제 프로시주얼 언어 삭제 룰(rule) 삭제 특정 테이블에 정의된 로우 단위 보안 정책 삭제 스키마(schema) 삭제 시퀀스 삭제 테이블 삭제 테이블스페이스 삭제 텍스트 검색 구성 제거 텍스트 검색 사전 제거 텍스트 검색 파서 제거 텍스트 검색 템플릿 제거 transform 삭제 트리거 삭제 외부 서버에 대한 사용자 매핑 제거 뷰(view) 삭제 액세스 권한 해제하기 접근 방법 삭제 집계 함수 삭제 이벤트 트리거 삭제 확장 모듈 삭제 인덱스 삭제 연산자 삭제 연산자 클래스 삭제 연산자 부류 삭제 데이터베이스 롤로 권한이 부여된 데이터베이스 개체들을 삭제하세요 재시작 실시간 환경 변수값을 초기값으로 다시 지정 엄격함 해당 커서에서 자료 뽑기 테이블이나 뷰의 자료를 출력 오른쪽인자_자료형 롤이름 롤_명세 savepoint 파기하기 룰(rule) 룰이름 safe 표본추출방법 savepoint_name 스키마이름 주는함수 시퀀스 시퀀스이름 서버이름 서버_종류 서버_버전 현재 트랜잭션에서 제약조건 설정 현재 트랜잭션의 성질을 지정함 현재 세션의 현재 사용자 식별자를 지정 현재 세션의 사용자 인증을 지정함 - 사용자 지정 쿼리 실행계획 보기 실시간 환경 변수값들을 보여줌 "%s" 변수의 재귀적 확장을 건너뛰는 중
정렬연산자 원본_설정 원래인코딩 원본테이블 기존자료형 특수 stable 시작 트랜잭션 블럭을 시작함 시작_함수 명령구문 특정 서버 메시지 수신 기능 끔 스토리지 스토리지_유형 탭 자동완성용 쿼리 실패: %s
사용한 쿼리:
%s
테이블 테이블 제약 조건 테이블_제약조건 테이블이름 테이블스페이스이름 테이블스페이스_옵션 대상롤 대상자료형 템플릿 토큰_종류 트랜잭션모드 트리거 트리거이름 복사 모드를 종료하는 중 type 자료형이름 PQresultStatus 반환값이 잘못됨: %d
\watch 쿼리 결과가 비정상적입니다.
알 수 없는 트랜잭션 상태 (%d)
고유, 알수없음 "%s" 값은 "%s" 변수값으로 사용할 수 없음; "%s" 값을 사용함
unsafe 인용 부호 짝 맞지 않음
테이블 자료 갱신 사용자 없음 사용자 이름 찾기 실패: 오류번호 %lu 사용자이름 구문검사함수 유효성검사_함수 값 값 버전 뷰(view) 뷰 이름이 필요합니다
뷰_옵션이름 volatile 동작 사용법: 집계함수_식별구문 사용법: 칼럼_제약조건 사용법: conflict_target 사용법: 제약조건 사용법: 방향 자리는 비워두거나 다음 중 하나: 이벤트 사용법: lockmode 사용법: 옵션 사용법: 옵션 사용법: 롤_명세 사용법: 트랜잭션모드 사용법: 창 원도우정의 윈도우이름 예 locale/ko/LC_MESSAGES/pg_basebackup-9.6.mo 0000644 00000071075 14751153420 0013652 0 ustar 00 �� � � � P Q k � � ! �
� - � X T \ R � ` I e D � � 3 K : < � j � > . N m @ � 3 � V 1 > � 1 � j � < d ? � M � k / J � Y � + @ 0 l B � B � * # 8 N � � 5 � L r � o G 1 � 3 � K - i F � \ � P ; 2 � 4 � 8 � 1 - 4 _ 1 � . � @ � 1 6 E h B � 7 � )! ( I! ' r! & �! ; �! ( �! - &" ' T" " |" �" # �" 2 �" , # + D# . p# ( �# # �# 5 �# f "$ , �$ 9 �$ 4 �$ 7 %% = ]% d �% A & " B& & e& & �& # �& / �& > ' a F' & �' & �' % �' 2 ( 1 O( 0 �( 8 �( ( �( 2 ) G) & h) ' �) . �) + �) # * A 6* 2 x* & �* & �* / �* + )+ 4 U+ / �+ ! �+ 1 �+ ) , ( 8, 2 a, 2 �, 3 �, 0 �, % ,- # R- + v- �- �- 2 �- # . (. , E. , r. # �. i �. i -/ 9 �/ " �/ A �/ # 60 Z0 9 {0 �0 �0 ! �0 D 1 & Q1 # x1 A �1 - �1 D 2 ! Q2 s2 �2 " �2 �2 9 �2 1 3 D R3 , �3 �3 ' �3 D �3 M D4 : �4 8 �4 6 5 =5 E V5 G �5 z �5 c _6 % �6 . �6 2 7 6 K7 # �7 �7 % �7 0 �7 R 8 , i8 4 �8 K �8 @ 9 > X9 - �9 , �9 ' �9 , : o G: k �: 4 #; % X; ( ~; ; �;
�; & �; < / < M< / \< � �< /> P> d> x> ) �> �> , �> ` �> Y N? [ �? s @ W x@ A �@ A > $A [ cA S �A z B @ �B H �B G C 1 `C h �C 9 �C B 5D p xD J �D ; 4E [ pE f �E F 3F O zF 7 �F : G X =G Z �G 0 �G I "H lH C �H � 0I i �I � 6J > �J ; �J V 4K 1 �K - �K 8 �K 2 $L P WL a �L m
M : xM E �M C �M A =N � N C O ` SO d �O N P = hP 9 �P A �P > "Q D aQ 5 �Q ) �Q / R " 6R # YR & }R = �R 6 �R 3 S , MS , zS % �S J �S n T 3 �T B �T = �T = <U 6 zU q �U D #V , hV ( �V 8 �V * �V A "W N dW p �W 4 $X ) YX - �X : �X : �X = 'Y 9 eY + �Y 2 �Y ( �Y / 'Z 3 WZ 0 �Z B �Z 3 �Z L 3[ A �[ , �[ - �[ / \ # M\ C q\ < �\ - �\ D ] 4 e] 1 �] : �] 6 ^ : >^ ) y^ " �^ 2 �^ 8 �^ & 2_ Y_ J l_ / �_ & �_ > ` 5 M` ) �` � �` � 7a K �a &
b V 4b ! �b 1 �b P �b ! 0c Rc , kc i �c ' d % *d [ Pd U �d T e 3 We . �e % �e / �e , f Q =f H �f T �f 1 -g _g 0 ug U �g ` �g D ]h > �h = �h i O 8i _ �i � �i y |j - �j > $k ? ck P �k 4 �k )l - Il T wl W �l W $m H |m Z �m G n a hn 5 �n + o ( ,o ( Uo ~o { �o 3 zp ) �p - �p ] q dq A mq �q 6 �q �q 8 r � * � � o C $ e [ ] � j ? � � � � f � - R � � � � O < � s � } 2 B � p c { ; N 7 � � ) @ + Y � � � � � z & T J h � H G K ~ � t w X v � � � 9 � = � � . / � k 5 A U � � � q � � _ � � 6 � E
Z � S I , � � d # x � � Q y l P � � i � � u ^ � > � � V
� 0 n � ( � � \ : � � r � � � � 4 � g � M " 3 1 � D m � 8 a � � b F � % W � � � � ! � � | ` L � � � ' �
Action to be performed:
Connection options:
General options:
Optional actions:
Options controlling the output:
Options:
Report bugs to <pgsql-bugs@postgresql.org>.
--create-slot create a new replication slot (for the slot's name see --slot)
--drop-slot drop the replication slot (for the slot's name see --slot)
--if-not-exists do not error if slot already exists when creating a slot
--start start streaming in a replication slot (for the slot's name see --slot)
--synchronous flush transaction log immediately after writing
--xlogdir=XLOGDIR location for the transaction log directory
%s [OPTION]...
-?, --help show this help, then exit
-D, --directory=DIR receive transaction log files into this directory
-D, --pgdata=DIRECTORY receive base backup into directory
-F --fsync-interval=SECS
time between fsyncs to the output file (default: %d)
-F, --format=p|t output format (plain (default), tar)
-I, --startpos=LSN where in an existing slot should the streaming start
-P, --plugin=PLUGIN use output plugin PLUGIN (default: %s)
-P, --progress show progress information
-R, --write-recovery-conf
write recovery.conf after backup
-S, --slot=SLOTNAME name of the logical replication slot
-S, --slot=SLOTNAME replication slot to use
-T, --tablespace-mapping=OLDDIR=NEWDIR
relocate tablespace in OLDDIR to NEWDIR
-U, --username=NAME connect as specified database user
-V, --version output version information, then exit
-W, --password force password prompt (should happen automatically)
-X, --xlog-method=fetch|stream
include required WAL files with specified method
-Z, --compress=0-9 compress tar output with given compression level
-c, --checkpoint=fast|spread
set fast or spread checkpointing
-d, --dbname=CONNSTR connection string
-d, --dbname=DBNAME database to connect to
-f, --file=FILE receive log into this file, - for stdout
-h, --host=HOSTNAME database server host or socket directory
-l, --label=LABEL set backup label
-n, --no-loop do not loop on connection lost
-o, --option=NAME[=VALUE]
pass option NAME with optional value VALUE to the
output plugin
-p, --port=PORT database server port number
-r, --max-rate=RATE maximum transfer rate to transfer data directory
(in kB/s, or use suffix "k" or "M")
-s, --status-interval=INTERVAL
time between status packets sent to server (in seconds)
-s, --status-interval=SECS
time between status packets sent to server (default: %d)
-v, --verbose output verbose messages
-w, --no-password never prompt for password
-x, --xlog include required WAL files in backup (fetch mode)
-z, --gzip compress tar output
%*s/%s kB (%d%%), %d/%d tablespace %*s/%s kB (%d%%), %d/%d tablespaces %*s/%s kB (%d%%), %d/%d tablespace (%s%-*.*s) %*s/%s kB (%d%%), %d/%d tablespaces (%s%-*.*s) %*s/%s kB (100%%), %d/%d tablespace %*s %*s/%s kB (100%%), %d/%d tablespaces %*s %s controls PostgreSQL logical decoding streams.
%s receives PostgreSQL streaming transaction logs.
%s takes a base backup of a running PostgreSQL server.
%s: %s needs a slot to be specified using --slot
%s: COPY stream ended before last file was finished
%s: WAL streaming can only be used in plain mode
%s: at least one action needs to be specified
%s: can only write single tablespace to stdout, database has %d
%s: cannot specify both --xlog and --xlog-method
%s: cannot use --create-slot or --drop-slot together with --startpos
%s: cannot use --create-slot or --start together with --drop-slot
%s: cannot use --create-slot together with --drop-slot
%s: child %d died, expected %d
%s: child process did not exit normally
%s: child process exited with error %d
%s: child thread exited with error %u
%s: confirming write up to %X/%X, flush to %X/%X (slot %s)
%s: could not access directory "%s": %s
%s: could not close compressed file "%s": %s
%s: could not close directory "%s": %s
%s: could not close file "%s": %s
%s: could not connect to server
%s: could not connect to server: %s %s: could not create archive status file "%s": %s
%s: could not create background process: %s
%s: could not create background thread: %s
%s: could not create compressed file "%s": %s
%s: could not create directory "%s": %s
%s: could not create file "%s": %s
%s: could not create pipe for background process: %s
%s: could not create replication slot "%s": got %d rows and %d fields, expected %d rows and %d fields
%s: could not create symbolic link "%s": %s
%s: could not create symbolic link from "%s" to "%s": %s
%s: could not create timeline history file "%s": %s
%s: could not determine seek position in file "%s": %s
%s: could not determine server setting for integer_datetimes
%s: could not drop replication slot "%s": got %d rows and %d fields, expected %d rows and %d fields
%s: could not establish database-specific replication connection
%s: could not fsync file "%s": %s
%s: could not fsync log file "%s": %s
%s: could not get COPY data stream: %s %s: could not get backup header: %s %s: could not get child thread exit status: %s
%s: could not get transaction log end position from server: %s %s: could not identify system: got %d rows and %d fields, expected %d rows and %d or more fields
%s: could not initiate base backup: %s %s: could not open directory "%s": %s
%s: could not open log file "%s": %s
%s: could not open timeline history file "%s": %s
%s: could not open transaction log file "%s": %s
%s: could not pad transaction log file "%s": %s
%s: could not parse next timeline's starting point "%s"
%s: could not parse start position "%s"
%s: could not parse transaction log location "%s"
%s: could not read COPY data: %s %s: could not read directory "%s": %s
%s: could not read from ready pipe: %s
%s: could not receive data from WAL stream: %s %s: could not rename file "%s" to "%s": %s
%s: could not rename file "%s": %s
%s: could not seek to beginning of transaction log file "%s": %s
%s: could not send command to background pipe: %s
%s: could not send copy-end packet: %s %s: could not send feedback packet: %s %s: could not send replication command "%s": %s %s: could not set compression level %d: %s
%s: could not set permissions on directory "%s": %s
%s: could not set permissions on file "%s": %s
%s: could not stat file "%s": %s
%s: could not stat transaction log file "%s": %s
%s: could not wait for child process: %s
%s: could not wait for child thread: %s
%s: could not write %u bytes to WAL file "%s": %s
%s: could not write %u bytes to log file "%s": %s
%s: could not write timeline history file "%s": %s
%s: could not write to compressed file "%s": %s
%s: could not write to file "%s": %s
%s: creating replication slot "%s"
%s: directory "%s" exists but is not empty
%s: directory name too long
%s: disconnected
%s: disconnected; waiting %d seconds to try again
%s: dropping replication slot "%s"
%s: final receive failed: %s %s: finished segment at %X/%X (timeline %u)
%s: got WAL data offset %08x, expected %08x
%s: incompatible server version %s
%s: incompatible server version %s; client does not support streaming from server versions newer than %s
%s: incompatible server version %s; client does not support streaming from server versions older than %s
%s: integer_datetimes compile flag does not match server
%s: invalid --max-rate unit: "%s"
%s: invalid checkpoint argument "%s", must be "fast" or "spread"
%s: invalid compression level "%s"
%s: invalid fsync interval "%s"
%s: invalid output format "%s", must be "plain" or "tar"
%s: invalid port number "%s"
%s: invalid socket: %s %s: invalid status interval "%s"
%s: invalid tablespace mapping format "%s", must be "OLDDIR=NEWDIR"
%s: invalid tar block header size: %d
%s: invalid transfer rate "%s": %s
%s: invalid xlog-method option "%s", must be "fetch" or "stream"
%s: multiple "=" signs in tablespace mapping
%s: new directory is not an absolute path in tablespace mapping: %s
%s: no data returned from server
%s: no database specified
%s: no slot specified
%s: no target directory specified
%s: no target file specified
%s: no transaction log end position returned from server
%s: not renaming "%s%s", segment is not complete
%s: old directory is not an absolute path in tablespace mapping: %s
%s: only tar mode backups can be compressed
%s: out of memory
%s: received interrupt signal, exiting
%s: received transaction log record for offset %u with no file open
%s: replication connection using slot "%s" is unexpectedly database specific
%s: replication slots can only be used with WAL streaming
%s: replication stream was terminated before stop point
%s: segment file "%s" has incorrect size %d, skipping
%s: select() failed: %s
%s: server reported unexpected history file name for timeline %u: %s
%s: server reported unexpected next timeline %u, following timeline %u
%s: server returned unexpected response to BASE_BACKUP command; got %d rows and %d fields, expected %d rows and %d fields
%s: server stopped streaming timeline %u at %X/%X, but reported next timeline %u to begin at %X/%X
%s: starting background WAL receiver
%s: starting log streaming at %X/%X (slot %s)
%s: starting log streaming at %X/%X (timeline %u)
%s: starting timeline %u is not present in the server
%s: streaming header too small: %d
%s: streaming initiated
%s: switched to timeline %u at %X/%X
%s: symlinks are not supported on this platform
%s: system identifier does not match between base backup and streaming connection
%s: this build does not support compression
%s: too many command-line arguments (first is "%s")
%s: transaction log directory location can only be specified in plain mode
%s: transaction log directory location must be an absolute path
%s: transaction log file "%s" has %d bytes, should be 0 or %d
%s: transfer rate "%s" exceeds integer range
%s: transfer rate "%s" is not a valid value
%s: transfer rate "%s" is out of range
%s: transfer rate must be greater than zero
%s: unexpected response to TIMELINE_HISTORY command: got %d rows and %d fields, expected %d rows and %d fields
%s: unexpected result set after end-of-timeline: got %d rows and %d fields, expected %d rows and %d fields
%s: unexpected termination of replication stream: %s %s: unrecognized link indicator "%c"
%s: unrecognized streaming header: "%c"
%s: waiting for background process to finish streaming ...
Password: Try "%s --help" for more information.
Usage:
cannot duplicate null pointer (internal error)
out of memory
transaction log start point: %s on timeline %u
Project-Id-Version: pg_basebackup (PostgreSQL) 9.6
Report-Msgid-Bugs-To: pgsql-bugs@postgresql.org
POT-Creation-Date: 2016-09-26 14:02+0900
PO-Revision-Date: 2016-09-26 16:40+0900
Last-Translator: Ioseph Kim <ioseph@uri.sarang.net>
Language-Team: Korean <pgsql-kr@postgresql.kr>
Language: ko
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Plural-Forms: nplurals=1; plural=0;
성능에 관계된 기능들:
연결 옵션들:
일반 옵션들:
추가 기능:
출력물을 제어야하는 옵션들:
옵션들:
오류보고: <pgsql-bugs@postgresql.org>.
--create-slot 새 복제 슬롯을 만듬 (--slot 옵션에서 슬롯 이름 지정)
--drop-slot 복제 슬롯 삭제 (--slot 옵션에서 슬롯 이름 지정)
--if-not-exists 슬롯을 새로 만들 때 이미 있어도 오류 내지 않음
--start 복제 슬롯을 이용한 스트리밍 시작 (--slot 옵션에서 슬롯 이름 지정)
--synchronous 쓰기 작업 후 즉시 트랜잭션 로그를 플러시 함
--xlogdir=XLOGDIR 트랜잭션 로그 디렉터리 지정
%s [옵션]...
-?, --help 이 도움말을 보여주고 마침
-D, --directory=DIR 지정한 디렉터리로 트랜잭션 로그 파일을 백업함
-D, --pgdata=디렉터리 베이스 백업 결과물이 저장될 디렉터리
-F --fsync-interval=초
지정한 초 간격으로 파일 fsync 작업을 함 (초기값: %d)
-F, --format=p|t 출력 형식 (plain (초기값), tar)
-I, --startpos=LSN 스트리밍을 시작할 기존 슬롯 위치
-P, --plugin=PLUGIN 사용할 출력 플러그인 (초기값: %s)
-P, --progress 진행 과정 보여줌
-R, --write-recovery-conf
백업이 끝나고 recovery.conf 파일도 만듬
-S, --slot=슬롯이름 논리 복제 슬롯 이름
-S, --slot=슬롯이름 지정한 복제 슬롯을 사용함
-T, --tablespace-mapping=옛DIR=새DIR
테이블스페이스 디렉터리 새 맵핑
-U, --username=사용자 접속할 특정 데이터베이스 사용자
-V, --version 버전 정보 보여주고 마침
-W, --password 항상 비밀번호 프롬프트 보임 (자동으로 판단 함)
-X, --xlog-method=fetch|stream
필요한 WAL 파일을 백업하는 방법
-Z, --compress=0-9 압축된 tar 파일의 압축 수위 지정
-c, --checkpoint=fast|spread
체크포인트 방법
-d, --dbname=접속문자열 서버 접속 문자열
-d, --dbname=디비이름 접속할 데이터베이스
-f, --file=파일 작업 로그를 해당 파일에 기록, 표준 출력은 -
-h, --host=호스트이름 접속할 데이터베이스 서버나 소켓 디렉터리
-l, --label=라벨 백업 라벨 지정
-n, --no-loop 접속이 끊겼을 때 재연결 하지 않음
-o, --option=이름[=값]
출력 플러그인에서 사용할 옵션들의 옵션 이름과 그 값
-p, --port=포트 데이터베이스 서버 포트 번호
-r, --max-rate=속도 최대 전송 속도
(단위는 kB/s, 또는 숫자 뒤에 "k" 또는 "M" 단위 문자 지정 가능)
-s, --status-interval=초
초 단위 매번 서버로 상태 패킷을 보냄
-s, --status-interval=초
지정한 초 간격으로 서버로 상태 패킷을 보냄 (초기값: %d)
-v, --verbose 자세한 작업 메시지 보여줌
-w, --no-password 비밀번호 물어 보지 않음
-x, --xlog 백업 안에 필요한 WAL 파일도 포함함 (fetch mode)
-z, --gzip tar 출력물을 압축
%*s/%s kB (%d%%), %d/%d 테이블스페이스 %*s/%s kB (%d%%), %d/%d 테이블스페이스 (%s%-*.*s) %*s/%s kB (100%%), %d/%d 테이블스페이스 %*s %s 프로그램은 논리 디코딩 스트림을 제어하는 도구입니다.
%s 프로그램은 PostgreSQL 스트리밍 트랜잭션 로그를 수신하는 도구입니다.
%s 프로그램은 운영 중인 PostgreSQL 서버에 대해서 베이스 백업을 하는 도구입니다.
%s: %s 옵션은 --slot 옵션을 함께 사용해야 함
%s: 마지막 파일을 끝내기 전에 COPY 스트림이 끝났음
%s: WAL 스트리밍은 plain 모드에서만 사용할 수 있음
%s: 적어도 하나 이상의 작업 방법을 지정해야 함
%s: 표준 출력으로는 하나의 테이블스페이스만 쓸 수 있음, 데이터베이스는 %d 개의 테이블 스페이스가 있음
%s: --xlog 옵션과 --xlog-method 옵션은 함께 쓸 수 없음
%s: --create-slot 옵션이나 --drop-slot 옵션은 --startpos 옵션과 함께 쓸 수 없음
%s: --create-slot 옵션 또는 --start 옵션은 --drop-slot 옵션과 함께 사용할 수 없음
%s: --create-slot 옵션과 --drop-slot 옵션을 함께 사용할 수 없음
%s: %d 개의 하위 프로세스가 종료됨, 기대값 %d
%s: 하위 프로세스가 정상 종료되지 못했음
%s: 하위 프로세스가 비정상 종료됨: 오류 코드 %d
%s: 하위 스레드가 비정상 종료됨: 오류 코드 %u
%s: 쓰기 확인 위치: %X/%X, 플러시 위치 %X/%X (슬롯 %s)
%s: "%s" 디렉터리에 액세스할 수 없음: %s
%s: "%s" 압축 파일 닫기 실패: %s
%s: "%s" 디렉터리를 닫을 수 없음: %s
%s: "%s" 파일 닫기 실패: %s
%s: 서버에 접속할 수 없음
%s: 서버에 접속할 수 없음: %s %s: "%s" 아카이브 상태 파일을 만들 수 없음: %s
%s: 백그라운드 프로세스 만들기 실패: %s
%s: 백그라운드 스래드 만들기 실패: %s
%s: "%s" 압축 파일 만들기 실패: %s
%s: "%s" 디렉터리 만들 수 없음: %s
%s: "%s" 파일 만들기 실패: %s
%s: 백그라운드 프로세스를 위한 파이프 만들기 실패: %s
%s: "%s" 복제 슬롯을 만들 수 없음: 로우수 %d, 필드수 %d, 기대값 로우수 %d, 필드수 %d
%s: "%s" 심벌릭 링크를 만들 수 없음: %s
%s: "%s" 파일을 "%s" 심볼릭 링크로 만들 수 없음: %s
%s: "%s" 타임라인 내역 파일을 만들 수 없음: %s
%s: "%s" 파일의 시작 위치를 결정할 수 없음: %s
%s: integer_datetimes 서버 설정을 알 수 없음
%s: "%s" 복제 슬롯을 삭제할 수 없음: 로우수 %d, 필드수 %d, 기대값 로우수 %d, 필드수 %d
%s: 데이터베이스 의존적인 복제 연결을 할 수 없음
%s: "%s" 파일을 fsync 할 수 없음: %s
%s: "%s" 로그 파일 fsync 실패: %s
%s: COPY 데이터 스트림을 사용할 수 없음: %s %s: 백업 헤더를 구할 수 없음: %s %s: 하위 스레드 종료 상태가 정상적이지 않음: %s
%s: 서버에서 트랜잭션 로그 마지막 위치를 구할 수 없음: %s %s: 시스템을 식별할 수 없음: 로우수 %d, 필드수 %d, 예상값: 로우수 %d, 필드수 %d 이상
%s: 베이스 백업을 초기화 할 수 없음: %s %s: "%s" 디렉터리 열 수 없음: %s
%s: "%s" 로그 파일을 열 수 없음: %s
%s: "%s" 타임라인 내역 파일을 열 수 없음: %s
%s: "%s" 트랜잭션 로그 파일을 열 수 없음: %s
%s: "%s" 트랜잭션 로그 파일을 채울 수 없음: %s
%s: 다음 타임라인 시작 위치 분석 실패 "%s"
%s: 시작 위치 구문이 잘못됨 "%s"
%s: 트랜잭션 로그 위치 "%s" 분석 실패
%s: COPY 자료를 읽을 수 없음: %s %s: "%s" 디렉터리를 읽을 수 없음: %s
%s: 준비된 파이프로부터 읽기 실패: %s
%s: WAL 스트림에서 자료 받기 실패: %s %s: "%s" 파일을 "%s" 파일로 이름을 바꿀 수 없음: %s
%s: "%s" 파일의 이름을 바꿀 수 없음: %s
%s: "%s" 트랜잭션 로그파일의 시작위치를 찾을 수 없음: %s
%s: 백그라운드 파이프로 명령을 보낼 수 없음: %s
%s: copy-end 패킷을 보낼 수 없음: %s %s: 피드백 패킷을 보낼 수 없음: %s %s: "%s" 복제 명령을 보낼 수 없음: %s %s: 잘못된 압축 수위 %d: %s
%s: "%s" 디렉터리의 접근 권한을 지정할 수 없음: %s
%s: "%s" 파일의 접근권한을 지정할 수 없음: %s
%s: "%s" 파일 상태를 알 수 없음: %s
%s: "%s" 트랜잭션 로그 파일의 상태를 알 수 없음: %s
%s: 하위 프로세스를 기다릴 수 없음: %s
%s: 하위 스레드를 기다릴 수 없음: %s
%s: %u 바이트를 "%s" WAL 파일에 쓸 수 없음: %s
%s: %u 바이트 쓰기 실패, 로그파일 "%s": %s
%s: "%s" 타임라인 내역 파일에 쓸 수 없음: %s
%s: "%s" 압축 파일 쓰기 실패: %s
%s: "%s" 파일 쓰기 실패: %s
%s: "%s" 이름의 복제 슬롯을 만드는 중
%s: "%s" 디렉터리가 있지만 비어 있지 않음
%s: 디렉터리 이름이 너무 김
%s: 연결 끊김
%s: 연결 끊김; 다시 연결 하기 위해 %d 초를 기다리는 중
%s: "%s" 이름의 복제 슬롯을 삭제 중
%s: 수신 작업 마무리 실패: %s %s: 마무리된 세그먼트 위치: %X/%X (타임라인 %u)
%s: 잘못된 WAL 자료 위치 %08x, 기대값 %08x
%s: 호환하지 않는 서버 버전 %s
%s: %s 서버 버전은 호환되지 않음; 클라이언트는 %s 버전 보다 새로운 서버의 스트리밍은 지원하지 않음
%s: %s 서버 버전은 호환되지 않음; 클라이언트는 %s 버전 보다 오래된 서버의 스트리밍은 지원하지 않음
%s: integer_datetimes 컴파일 플래그가 서버와 일치하지 않음
%s: 잘못된 --max-rate 단위: "%s"
%s: 잘못된 체크포인트 옵션값 "%s", "fast" 또는 "spread"만 사용 가능
%s: 잘못된 압축 수위 "%s"
%s: "%s" 값은 잘못된 fsync 반복주기 임
%s: "%s" 값은 잘못된 출력 형식, "plain" 또는 "tar" 만 사용 가능
%s: 잘못된 포트 번호 "%s"
%s: 잘못된 소켓: %s %s: 잘못된 상태값 전단 간격: "%s"
%s: "%s" 형식의 테이블스페이스 맵핑이 잘못 되었음, "OLDDIR=NEWDIR" 형식이어야 함
%s: 잘못된 블럭 헤더 크기: %d
%s: 잘못된 전송 속도 "%s": %s
%s: "%s" 값은 잘못된 xlog-method 옵션값, "fetch" 또는 "stream" 만 사용 가능
%s: 테이블스페이스 맵핑 하는 곳에서 "=" 문자가 중복 되어 있음
%s: 테이블스페이스 맵핑용 새 디렉터리가 절대 경로가 아님: %s
%s: 서버가 아무런 자료도 주지 않았음
%s: 데이터베이스 지정하지 않았음
%s: 슬롯을 지정하지 않았음
%s: 대상 디렉터리를 지정하지 않음
%s: 대상 파일을 지정하지 않았음
%s: 서버에서 트랜잭션 로그 마지막 위치가 수신 되지 않았음
%s: "%s%s" 이름 변경 실패, 세그먼트가 완료되지 않았음
%s: 테이블스페이스 맵핑용 옛 디렉터리가 절대 경로가 아님: %s
%s: tar 형식만 압축을 사용할 수 있음
%s: 메모리 부족
%s: 인터럽터 시그널을 받음, 종료함
%s: %u 위치의 수신된 트랜잭션 로그 레코드에 파일을 열 수 없음
%s: "%s" 슬롯을 이용한 복제 연결은 이 데이터베이스에서 사용할 수 없음
%s: 복제 슬롯은 WAL 스트리밍에서만 사용할 수 있음
%s: 복제 스트림이 중지 위치 전에 종료 되었음
%s: "%s" 조각 파일은 잘못된 크기임: %d, 무시함
%s: select() 실패: %s
%s: 타임라인 %u 번을 위한 내역 파일 이름이 잘못 되었음: %s
%s: 서버가 잘못된 다음 타임라인 번호 %u 보고함, 이전 타임라인 번호 %u
%s: 서버가 BASE_BACKUP 명령에 대해서 잘못된 응답을 했습니다; 응답값: %d 로우, %d 필드, (기대값: %d 로우, %d 필드)
%s: 서버의 중지 위치: 타임라인 %u, 위치 %X/%X, 하지만 보고 받은 위치: 타임라인 %u 위치 %X/%X
%s: 백그라운드 WAL 수신자 시작 중
%s: 로그 스트리밍 시작 함, 위치: %X/%X (슬롯 %s)
%s: 로그 스트리밍 시작 위치: %X/%X (타임라인 %u)
%s: %u 타임라인으로 시작하는 것을 서버에서 제공 하지 않음
%s: 스트리밍 헤더 크기가 너무 작음: %d
%s: 스트리밍 초기화 됨
%s: 전환됨: 타임라인 %u, 위치 %X/%X
%s: 이 운영체제에서는 심볼릭 링크 기능을 지원하지 않습니다.
%s: 시스템 식별자가 베이스 백업과 스트리밍 연결에서 서로 다름
%s: 이 버전은 압축 하는 기능을 포함 하지 않고 빌드 되었습니다.
%s: 너무 많은 명령행 인수를 지정했습니다. (처음 "%s")
%s: 트랜잭션 로그 디렉터리 위치는 plain 모드에서만 사용할 수 있음
%s: 트랜잭션 로그 디렉터리 위치는 절대 경로여야 함
%s: "%s" 트랜잭션 로그파일의 크기가 %d 바이트임, 0 또는 %d 바이트여야 함
%s: "%s" 전송 속도는 정수형 범위가 아님
%s: "%s" 전송 속도는 잘못된 값임
%s: "%s" 전송 속도는 범위 초과
%s: 전송 속도는 0보다 커야 함
%s: TIMELINE_HISTORY 명령 결과가 잘못됨: 받은 값: 로우수 %d, 필드수 %d, 예상값: 로우수 %d, 필드수 %d
%s: 타임라인 끝에 잘못된 결과가 발견 됨: 로우수 %d, 필드수 %d / 예상값: 로우수 %d, 필드수 %d
%s: 복제 스트림의 예상치 못한 종료: %s %s: 알 수 없는 링크 지시자 "%c"
%s: 알 수 없는 스트리밍 헤더: "%c"
%s: 스트리밍을 끝내기 위해서 백그라운드 프로세스를 기다리는 중 ...
암호: 자제한 사항은 "%s --help" 명령으로 살펴보십시오.
사용법:
null 포인터를 복제할 수 없음(내부 오류)
메모리 부족
트랙잭션 로그 시작 위치: %s, 타임라인: %u
locale/ko/LC_MESSAGES/initdb-9.6.mo 0000644 00000060562 14751153420 0012334 0 ustar 00 �� � , � <
�
R �
* 5 - F g t ` � � = W W X � A � 5 � J / z 6 � P � C : b Q � 5 � ] % 4 � B � H � G D > � 4 � 9 3 : ? n / � - � > y K ( � # � , - ? 7 m ( � 6 � , ' 2 5 Z F � " � < � & 7 - ^ - � ! � 1 � ? & N / u = � ! � " 6 ( + _ � 0 � ; � $ / 4 & d � $ � ~ � 1 M < � G � 3 " 8 V ( � J � � � � C � - C! 8 q! ! �! , �! �! J " / \" 4 �" A �" @ # R D# K �# " �# ! $ � ($ d �$ % $% � C% [ �% R #& K v& % �& �& ' ' ; 7' ; s' � �' @ @( ; �( �( u �) q D* f �* s + & �+ �+ ) �+ t �+ / _, �, & �, 0 �, . �, ) %- ) O- y- �- & �- # �- �- $ . ( 3. + \. " �. �. " �. ! �. , / $ 8/ * ]/ % �/ ! �/ �/ �/ 0 0 90 M0 Q0 `0 - r0 �0 & �0 % �0 3 1 ?1 Y1 ( m1 � �1 _ 03 - �3 �3 �3 , �3 � 4 � �4 - E5 O s6 O �6 7 K 8 0 f8 H �8 �8 A �8 B >9 G �9 C �9 Z
: @ h: Z �: @ ; A E; B �; D �; Q < > a< K �< = �< W *= Q �= M �= I "> � l> 5 P? / �? 3 �? 0 �? I @ , e@ = �@ 3 �@ , A < 1A I nA = �A Q �A ) HB 3 rB 6 �B # �B = C F ?C / �C A �C K �C 0 DD " uD [ �D 8 �D -E E FE O �E > �E H F 1 dF �F + �F � �F C rG K �G ! H U $H J zH L �H 6 I ` II �I �J - �J x �J I qK S �K ; L E KL �L � �L ? .M H nM e �M G N X eN K �N 7
O - BO � pO � �O �P + �P � �P n ~Q u �Q X cR 0 �R �R +
S 9S V ZS S �S � T S �T @ U C JU � �V � OW � X v �X O #Y sY J Y � �Y 7 �Z - �Z 8 �Z ? 0[ 6 p[ 4 �[ C �[ \ ?\ * W\ + �\ ' �\ / �\ ) ] 0] ( Q] - z] + �] * �] 9 �] 2 9^ F l^ * �^ ( �^ ! _ % )_ F O_ 5 �_ �_ �_ �_ 0 �_ , )` 1 V` - �` G �` 0 �` /a 1 @a � � 5 ( � Z � J l 6 H X � � K z � � � r I � � { � N d R V o | ~ � � . y U } � m � ` G = * f / $ � > _ � # A � t C 8 Y 0 T , � % + v L 3 � 2 n � � h B j E ? ] 9 ) ! & � � � q � � D S g
e ; ' ^ " F x c � w P [ s � @ i �
1 - \ � u : k � 4 W Q 7 O � < M p a b �
If the data directory is not specified, the environment variable PGDATA
is used.
Less commonly used options:
Options:
Other options:
Report bugs to <pgsql-bugs@postgresql.org>.
Success. You can now start the database server using:
%s%s%spg_ctl%s -D %s%s%s -l logfile start
Sync to disk skipped.
The data directory might become corrupt if the operating system crashes.
WARNING: enabling "trust" authentication for local connections
You can change this by editing pg_hba.conf or using the option -A, or
--auth-local and --auth-host, the next time you run initdb.
--auth-host=METHOD default authentication method for local TCP/IP connections
--auth-local=METHOD default authentication method for local-socket connections
--lc-collate=, --lc-ctype=, --lc-messages=LOCALE
--lc-monetary=, --lc-numeric=, --lc-time=LOCALE
set default locale in the respective category for
new databases (default taken from environment)
--locale=LOCALE set default locale for new databases
--no-locale equivalent to --locale=C
--pwfile=FILE read password for the new superuser from file
%s [OPTION]... [DATADIR]
-?, --help show this help, then exit
-A, --auth=METHOD default authentication method for local connections
-E, --encoding=ENCODING set default encoding for new databases
-L DIRECTORY where to find the input files
-N, --nosync do not wait for changes to be written safely to disk
-S, --sync-only only sync data directory
-T, --text-search-config=CFG
default text search configuration
-U, --username=NAME database superuser name
-V, --version output version information, then exit
-W, --pwprompt prompt for a password for the new superuser
-X, --xlogdir=XLOGDIR location for the transaction log directory
-d, --debug generate lots of debugging output
-k, --data-checksums use data page checksums
-n, --noclean do not clean up after errors
-s, --show show internal settings
[-D, --pgdata=]DATADIR location for this database cluster
%s initializes a PostgreSQL database cluster.
%s: "%s" is not a valid server encoding name
%s: WARNING: cannot create restricted tokens on this platform
%s: cannot be run as root
Please log in (using, e.g., "su") as the (unprivileged) user that will
own the server process.
%s: could not access directory "%s": %s
%s: could not access file "%s": %s
%s: could not allocate SIDs: error code %lu
%s: could not change permissions of "%s": %s
%s: could not change permissions of directory "%s": %s
%s: could not create directory "%s": %s
%s: could not create restricted token: error code %lu
%s: could not create symbolic link "%s": %s
%s: could not execute command "%s": %s
%s: could not find suitable encoding for locale "%s"
%s: could not find suitable text search configuration for locale "%s"
%s: could not fsync file "%s": %s
%s: could not get exit code from subprocess: error code %lu
%s: could not open directory "%s": %s
%s: could not open file "%s" for reading: %s
%s: could not open file "%s" for writing: %s
%s: could not open file "%s": %s
%s: could not open process token: error code %lu
%s: could not re-execute with restricted token: error code %lu
%s: could not read directory "%s": %s
%s: could not read password from file "%s": %s
%s: could not start process for command "%s": error code %lu
%s: could not stat file "%s": %s
%s: could not write file "%s": %s
%s: data directory "%s" not removed at user's request
%s: directory "%s" exists but is not empty
%s: encoding mismatch
%s: failed to remove contents of data directory
%s: failed to remove contents of transaction log directory
%s: failed to remove data directory
%s: failed to remove transaction log directory
%s: failed to restore old locale "%s"
%s: file "%s" does not exist
%s: file "%s" is not a regular file
%s: input file "%s" does not belong to PostgreSQL %s
Check your installation or specify the correct path using the option -L.
%s: input file location must be an absolute path
%s: invalid authentication method "%s" for "%s" connections
%s: invalid locale name "%s"
%s: invalid locale settings; check LANG and LC_* environment variables
%s: locale "%s" requires unsupported encoding "%s"
%s: locale name has non-ASCII characters, skipped: "%s"
%s: locale name too long, skipped: "%s"
%s: must specify a password for the superuser to enable %s authentication
%s: no data directory specified
You must identify the directory where the data for this database system
will reside. Do this with either the invocation option -D or the
environment variable PGDATA.
%s: out of memory
%s: password file "%s" is empty
%s: password prompt and password file cannot be specified together
%s: removing contents of data directory "%s"
%s: removing contents of transaction log directory "%s"
%s: removing data directory "%s"
%s: removing transaction log directory "%s"
%s: setlocale() failed
%s: superuser name "%s" is disallowed; role names cannot begin with "pg_"
%s: symlinks are not supported on this platform %s: too many command-line arguments (first is "%s")
%s: transaction log directory "%s" not removed at user's request
%s: transaction log directory location must be an absolute path
%s: warning: specified text search configuration "%s" might not match locale "%s"
%s: warning: suitable text search configuration for locale "%s" is unknown
Data page checksums are disabled.
Data page checksums are enabled.
Encoding "%s" implied by locale is not allowed as a server-side encoding.
The default database encoding will be set to "%s" instead.
Encoding "%s" is not allowed as a server-side encoding.
Rerun %s with a different locale selection.
Enter it again: Enter new superuser password: If you want to create a new database system, either remove or empty
the directory "%s" or run %s
with an argument other than "%s".
If you want to store the transaction log there, either
remove or empty the directory "%s".
It contains a dot-prefixed/invisible file, perhaps due to it being a mount point.
It contains a lost+found directory, perhaps due to it being a mount point.
No usable system locales were found.
Passwords didn't match.
Rerun %s with the -E option.
Running in debug mode.
Running in noclean mode. Mistakes will not be cleaned up.
The database cluster will be initialized with locale "%s".
The database cluster will be initialized with locales
COLLATE: %s
CTYPE: %s
MESSAGES: %s
MONETARY: %s
NUMERIC: %s
TIME: %s
The default database encoding has accordingly been set to "%s".
The default text search configuration will be set to "%s".
The encoding you selected (%s) and the encoding that the
selected locale uses (%s) do not match. This would lead to
misbehavior in various character string processing functions.
Rerun %s and either do not specify an encoding explicitly,
or choose a matching combination.
The files belonging to this database system will be owned by user "%s".
This user must also own the server process.
The program "postgres" is needed by %s but was not found in the
same directory as "%s".
Check your installation.
The program "postgres" was found by "%s"
but was not the same version as %s.
Check your installation.
This might mean you have a corrupted installation or identified
the wrong directory with the invocation option -L.
Try "%s --help" for more information.
Usage:
Use the option "--debug" to see details.
Using a mount point directly as the data directory is not recommended.
Create a subdirectory under the mount point.
cannot duplicate null pointer (internal error)
caught signal
child process exited with exit code %d child process exited with unrecognized status %d child process was terminated by exception 0x%X child process was terminated by signal %d child process was terminated by signal %s command not executable command not found could not change directory to "%s": %s could not close directory "%s": %s
could not find a "%s" to execute could not get junction for "%s": %s
could not identify current directory: %s could not look up effective user ID %ld: %s could not open directory "%s": %s
could not read binary "%s" could not read directory "%s": %s
could not read symbolic link "%s" could not remove file or directory "%s": %s
could not set junction for "%s": %s
could not stat file or directory "%s": %s
could not write to child process: %s
creating configuration files ... creating directory %s ... creating subdirectories ... fixing permissions on existing directory %s ... invalid binary "%s" ok
out of memory
pclose failed: %s performing post-bootstrap initialization ... running bootstrap script ... selecting default max_connections ... selecting default shared_buffers ... selecting dynamic shared memory implementation ... syncing data to disk ... user does not exist user name lookup failure: error code %lu Project-Id-Version: PostgreSQL 9.6 initdb
Report-Msgid-Bugs-To: pgsql-bugs@postgresql.org
POT-Creation-Date: 2016-09-26 14:02+0900
PO-Revision-Date: 2016-09-26 16:16+0900
Last-Translator: Ioseph Kim <ioseph@uri.sarang.net>
Language-Team: Korean <pgsql-kr@postgresql.kr>
Language: ko
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Plural-Forms: nplurals=1; plural=0;
데이터 디렉터리를 지정하지 않으면, PGDATA 환경 변수값을 사용합니다.
덜 일반적으로 사용되는 옵션들:
옵션들:
기타 옵션:
오류보고: <pgsql-bugs@postgresql.org>.
작업완료. 이제 다음 명령을 이용해서 서버를 가동 할 수 있습니다:
%s%s%spg_ctl%s -D %s%s%s -l 로그파일 start
디스크 동기화 작업은 생략했습니다.
이 상태에서 OS가 갑자기 중지 되면 데이터 디렉토리 안에 있는 자료가 깨질 수 있습니다.
경고: 로컬 연결의 인증 방법으로 "trust" 방식을 지정했습니다.
이 값을 바꾸려면, pg_hba.conf 파일을 수정하든지,
다음번 initdb 명령을 사용할 때, -A 옵션 또는 --auth-local,
--auth-host 옵션을 사용해서 인증 방법을 지정할 수 있습니다.
--auth-host=METHOD local TCP/IP 연결에 대한 기본 인증 방법
--auth-local=METHOD local-socket 연결에 대한 기본 인증 방법
--lc-collate=, --lc-ctype=, --lc-messages=LOCALE
--lc-monetary=, --lc-numeric=, --lc-time=LOCALE
새 데이터베이스의 각 범주에 기본 로캘 설정
(환경에서 가져온 기본 값)
--locale=LOCALE 새 데이터베이스의 기본 로캘 설정
--no-locale -locale=C와 같음
--pwfile=FILE 파일에서 새 superuser의 암호 읽기
%s [옵션]... [DATADIR]
-?, --help 이 도움말을 보여주고 마침
-A, --auth=METHOD 로컬 연결의 기본 인증 방법
-E, --encoding=ENCODING 새 데이터베이스의 기본 인코딩
-L DIRECTORY 입력파일들이 있는 디렉터리
-N, --nosync 작업 완료 뒤 디스크 동기화 작업을 하지 않음
-S, --sync-only 데이터 디렉터리만 동기화
-T, --text-search-config=CFG
기본 텍스트 검색 구성
-U, --username=NAME 데이터베이스 superuser 이름
-V, --version 버전 정보를 보여주고 마침
-W, --pwprompt 새 superuser 암호를 입력 받음
-X, --xlogdir=XLOGDIR 트랜잭션 로그 디렉터리 위치
-d, --debug 디버깅에 필요한 정보들도 함께 출력함
-k, --data-checksums 자료 페이지 체크섬 사용
-n, --noclean 오류가 발생되었을 경우 그대로 둠
-s, --show 내부 설정값들을 보여줌
[-D, --pgdata=]DATADIR 새 데이터베이스 클러스터를 만들 디렉터리
%s PostgreSQL 데이터베이스 클러스터를 초기화 하는 프로그램.
%s: "%s" 인코딩은 서버 인코딩 이름을 사용할 수 없습니다.
%s: 경고: 이 운영체제에서 restricted token을 만들 수 없음
%s: root로 이 프로그램을 실행하지 마십시오
시스템관리자 권한이 없는, 서버프로세스의 소유주가 될 일반 사용자로
로그인 해서("su", "runas" 같은 명령 이용) 실행하십시오.
%s: "%s" 디렉터리에 액세스할 수 없음: %s
%s: "%s" 파일에 액세스할 수 없음: %s
%s: SID를 할당할 수 없음: 오류 코드 %lu
%s: "%s" 접근 권한을 바꿀 수 없음: %s
%s: "%s" 디렉터리의 액세스 권한을 바꿀 수 없습니다: %s
%s: "%s" 디렉터리 만들 수 없음: %s
%s: 상속된 토큰을 만들 수 없음: 오류 코드 %lu
%s: "%s" 심벌릭 링크를 만들 수 없음: %s
%s: "%s" 명령을 실행할 수 없음: %s
%s: "%s" 로캘에 알맞은 인코딩을 찾을 수 없음
%s: "%s" 로케일에 알맞은 전문검색 설정을 찾을 수 없음
%s: "%s" 파일에 대한 fsync 작업을 할 수 없음: %s
%s: 하위 프로세스의 종료 코드를 구할 수 없음: 오류 코드 %lu
%s: "%s" 디렉터리 열 수 없음: %s
%s: "%s" 파일 읽기 모드로 열기 실패: %s
%s: "%s" 파일을 쓰기 모드로 열기 실패: %s
%s: "%s" 파일 열 수 없음: %s
%s: 프로세스 토큰을 열 수 없음: 오류 코드 %lu
%s: 상속된 토큰으로 재실행할 수 없음: 오류 코드 %lu
%s: "%s" 디렉터리를 읽을 수 없음: %s
%s: file "%s" 파일에서 암호를 읽을 수 없습니다: %s
%s: "%s" 명령용 프로세스를 시작할 수 없음: 오류 코드 %lu
%s: "%s" 파일의 상태를 알 수 없음: %s
%s: "%s" 파일 쓰기 실패: %s
%s: "%s" 데이터 디렉터리가 사용자의 요청으로 삭제되지 않았습니다.
%s: "%s" 디렉터리가 있지만 비어 있지 않음
%s: 인코딩 불일치
%s: 데이터 디렉터리 내용을 지우는데 실패했습니다
%s: 트랜잭션 로그 디렉터리 내용을 지우는데 실패했습니다
%s: 데이터 디렉터리를 지우는데 실패했습니다
%s: 트랜잭션 로그 디렉터리를 지우는데 실패했습니다
%s: "%s" 옛 로케일로 복원하지 못했음
%s: "%s" 파일이 없음
%s: "%s" 파일은 일반 파일이 아님
%s: "%s" 입력 파일은 PostgreSQL %s 용이 아닙니다.
설치상태를 확인해 보고, -L 옵션으로 바른 경로를 지정하십시오.
%s: 입력 파일 위치는 반드시 절대경로여야합니다.
%s: "%s" 인증 방법은 "%s" 연결에서는 사용할 수 없습니다.
%s: 잘못된 로캘 이름 "%s"
%s: 잘못된 로케일 설정; LANG 또는 LC_* OS 환경 변수를 확인하세요
%s: "%s" 로케일은 지원하지 않는 "%s" 인코딩을 필요로 함
%s: 로케일 이름이 ASCII 문자로 되어있지 않아 무시함: "%s"
%s: 로케일 이름이 너무 길어 무시함: "%s"
%s: %s 인증방식을 사용하려면, 반드시 superuser의 암호를 지정해야합니다.
%s: 데이터 디렉터리를 지정하지 않았습니다
이 작업을 진행하려면, 반드시 이 데이터 디렉터리를 지정해 주어야합니다.
지정하는 방법은 -D 옵션의 값이나, PGDATA 환경 변수값으로 지정해 주면 됩니다.
%s: 메모리 부족
%s: "%s" 패스워드 파일이 비어있음
%s: 암호를 입력받는 옵션과 암호를 파일에서 가져오는 옵션은 동시에 사용될 수 없습니다
%s: "%s" 데이터 디렉터리 안의 내용을 지우고 있습니다.
%s: "%s" 트랜잭션 로그 디렉터리 안의 내용을 지우고 있습니다.
%s: "%s" 데이터 디렉터리를 지우고 있습니다.
%s: "%s" 트랜잭션 로그 디렉터리를 지우고 있습니다.
%s: setlocale() 실패
%s: "%s" 사용자는 슈퍼유저 이름으로 쓸 수 없습니다. "pg_"로 시작하는롤 이름은 허용하지 않습니다.
%s: 이 플랫폼에서는 심볼 링크가 지원되지 않음 %s: 너무 많은 명령행 인수를 지정했습니다. (처음 "%s")
%s: "%s" 트랜잭션 로그 디렉터리가 사용자의 요청으로 삭제되지 않았습니다.
%s: 트랜잭션 로그 디렉터리 위치는 절대 경로여야 함
%s: 경고: 지정한 "%s" 전문검색 설정은 "%s" 로케일과 일치하지 않음
%s: 경고: "%s" 로캘에 알맞은 전문검색 설정을 알 수 없음
자료 페이지 체크섬 기능 사용 하지 않음
자료 페이지 체크섬 기능 사용함.
"%s" 인코딩을 서버측 인코딩으로 사용할 수 없습니다.
기본 데이터베이스는 "%s" 인코딩으로 지정됩니다.
"%s" 인코딩을 서버측 인코딩으로 사용할 수 없습니다.
다른 로캘을 선택하고 %s을(를) 다시 실행하십시오.
암호 확인: 새 superuser 암호를 입력하십시오: 새로운 데이터베이스 시스템을 만들려면
"%s" 디렉터리를 제거하거나 비우십시오. 또는 %s을(를)
"%s" 이외의 인수를 사용하여 실행하십시오.
트랜잭션 로그를 해당 위치에 저장하려면
"%s" 디렉터리를 제거하거나 비우십시오.
점(.)으로 시작하는 숨은 파일이 포함되어 있습니다. 마운트 최상위 디렉터리 같습니다.
lost-found 디렉터리가 있습니다. 마운트 최상위 디렉터리 같습니다.
사용 가능한 시스템 로케일이 없음.
암호가 서로 틀립니다.
-E 옵션으로 %s 지정해 주십시오.
디버그 모드로 실행 중.
지저분 모드로 실행 중. 오류가 발생되어도 뒷정리를 안합니다.
데이터베이스 클러스터는 "%s" 로케일으로 초기화될 것입니다.
데이터베이스 클러스터는 다음 로케일으로 초기화될 것입니다.
COLLATE: %s
CTYPE: %s
MESSAGES: %s
MONETARY: %s
NUMERIC: %s
TIME: %s
기본 데이터베이스 인코딩은 "%s" 인코딩으로 설정되었습니다.
기본 텍스트 검색 구성이 "%s"(으)로 설정됩니다.
선택한 인코딩(%s)과 선택한 로캘에서 사용하는
인코딩(%s)이 일치하지 않습니다. 이로 인해
여러 문자열 처리 함수에 오작동이 발생할 수 있습니다.
%s을(를) 다시 실행하고 인코딩을 명시적으로 지정하지 않거나
일치하는 조합을 선택하십시오.
이 데이터베이스 시스템에서 만들어지는 파일들은 그 소유주가 "%s" id로
지정될 것입니다. 또한 이 사용자는 서버 프로세스의 소유주가 됩니다.
%s 프로그램은 "postgres" 프로그램을 필요로 합니다. 그런데, 이 파일이
"%s" 파일이 있는 디렉터리안에 없습니다.
설치 상태를 확인해 주십시오.
"%s" 프로그램은 "postgres" 프로그램을 찾았지만 이 파일은
%s 프로그램의 버전과 틀립니다.
설치 상태를 확인해 주십시오.
설치가 잘못되었거나 –L 호출 옵션으로 식별한 디렉터리가
잘못되었을 수 있습니다.
보다 자세한 정보를 보려면 "%s --help" 옵션을 사용하십시오.
사용법:
보다 자세한 내용을 보려면 "--debug" 옵션을 사용하세요.
마운트 최상위 디렉터리를 데이터 디렉터리로 사용하는 것은 권장하지 않습니다.
하위 디렉터리를 만들어서 그것을 데이터 디렉터리로 사용하세요.
null 포인터를 중복할 수 없음 (내부 오류)
시스템의 간섭 신호(signal) 받았음
하위 프로세스가 종료되었음, 종료 코드 %d 하위 프로세스가 종료되었음, 알수 없는 상태 %d 0x%X 예외로 하위 프로세스가 종료되었음. 하위 프로세스가 종료되었음, 시그널 %d %s 시그널이 감지되어 하위 프로세스가 종료되었음 명령을 실행할 수 없음 해당 명령어 없음 "%s" 디렉터리로 바꿀 수 없음: %s "%s" 디렉터리를 닫을 수 없음: %s
"%s" 실행 파일을 찾을 수 없음 "%s" 파일의 정션을 구할 수 없음: %s
현재 디렉터리를 알 수 없음: %s %ld UID를 찾을 수 없음: %s "%s" 디렉터리를 열 수 없음: %s
"%s" 바이너리 파일을 읽을 수 없음 "%s" 디렉터리를 읽을 수 없음: %s
"%s" 심벌릭 링크를 읽을 수 없음 "%s" 파일 또는 디렉터리를 지울 수 없음: %s
"%s" 파일의 연결을 설정할 수 없음: %s
파일 또는 디렉터리 "%s"의 상태를 확인할 수 없음: %s
하위 프로세스에 쓸 수 없음: %s
환경설정 파일을 만드는 중 ... %s 디렉터리 만드는 중 ... 하위 디렉터리 만드는 중 ... 이미 있는 %s 디렉터리의 액세스 권한을 고치는 중 ... "%s" 파일은 잘못된 바이너리 파일입니다 완료
메모리 부족
pclose 실패: %s 부트스트랩 다음 초기화 작업 중 ... 부트스트랩 스크립트 실행 중 ... max_connections 초기값을 선택하는 중 ... 기본 shared_buffers를 선택하는 중... 사용할 동적 공유 메모리 관리방식을 선택하는 중 ... 자료를 디스크에 동기화 하는 중 ... 사용자 없음 사용자 이름 찾기 실패: 오류 코드 %lu locale/ko/LC_MESSAGES/pgscripts-9.6.mo 0000644 00000065616 14751153420 0013106 0 ustar 00 �� � | � 0 K 1 }
� > � > � = - Z � � C A d � � # � � ( 9 I V E � � > f ; � = � : < Z 9 � 6 � 5 C > C � 9 � 4 E 5 = { . � ; � E $ : j ? � A � < ' 9 d 7 � 4 � L J X 3 � H � E B f A � 5 � 2 ! N T 7 � 2 � 2 J A : � 5 � G � 0 E < v 0 � ) � M J \ G � 4 � C $! H h! E �! D �! = <" v z" < �" � .# Q �# I $ @ N$ 5 �$ 4 �$ 1 �$ 0 ,% ; ]% 5 �% ' �% 6 �% 3 .& 4 b& @ �& ; �& ; ' ` P' 8 �' 2 �' 9 ( 6 W( > �( �( / �( < ) # F) # j) ? �) 8 �) % * # -* Q* 3 q* & �* �* E �* 6 + E P+ F �+ K �+ 7 ), K a, 7 �, J �, 6 0- < g- D �- 5 �- . * =. 8 h. 6 �. ( �. 4 / $ 6/ # [/ / �/ �/ 8 �/ 4 0 $ E0 j0 , �0 , �0 ( �0 /
1 ; =1 9 y1 ! �1 �1 �1 �1 * 2 8 F2 9 2 , �2 8 �2 # 3 4 C3 3 x3 �3 ) �3 7 �3 +4
@4 N4 C c4 A �4 ! �4 + 5 75 H5 d5 �5 . �5 3 �5 2 6 56 B6 G6
d6 o6 �6 �6 ' �6 " �6 2 7 7 87 p7 & y7 �7 �7 / �7 + �7 * 8 F8 H8 K8 W8 d8 s8 �8 �8 ( �8 �8 �8 � �8 � u: �: ; S ; S p; R �; , < � D< G �< E 8= ~= �= ) �= �= % �= > a 6> R �> � �> J w? G �? B
@ C M@ G �@ D �@ A A @ `A ^ �A Y B < ZB 7 �B A �B F C 5 XC B �C < �C 5 D L DD C �D D �D F E 3 aE 6 �E � �E N PF 5 �F G �F D G A bG @ �G = �G : #H b ^H C �H F I @ LI E �I H �I C J C `J 6 �J 9 �J M K 5 cK M �K Q �K K 9L , �L O �L Z M [ ]M Z �M D N j YN C �N | O ^ �O N �O C 3P 9 wP @ �P = �P < 0Q M mQ G �Q / R 9 3R : mR = �R J �R C 1S G uS N �S C T 1 PT B �T ? �T M U SU } _U �U C ]V 4 �V ` �V M 7W Q �W F �W 7 X X VX B �X �X L �X P FY � �Y � Z h �Z u [ h [ { �[ h d\ x �\ M F] o �] ] ^ 4 b^ 3 �^ A �^ M
_ 6 [_ E �_ . �_ ` + (` ( T` }` P �` O �` 7a Ta B qa K �a 0 b 2 1b A db ? �b + �b c (c 1 Bc 7 tc > �c > �c 6 *d > ad �d 4 �d 4 �d * )e 3 Te < �e �e �e �e ] f \ lf ) �f > �f 2g Bg , bg �g ? �g 6 �g 5 h Ph dh kh �h �h & �h �h . �h 2 i N Ji J �i
�i * �i j &j 6 Ej 7 |j + �j �j �j �j �j
k k
8k Fk 0 Wk �k �k � � 9 � � t � � � I S � w & % � � � � G � � - . � � X � { � " � 7 � o � � < � � � L � 4 / K i u � J � ~ B m ( � � � � * �
n f H p � # D g @ ' > � � U � v � x [ � 3
N � � k ! � 8 , � Y F ; � z � � Z � T � � 6 r M � + a 2 W � � $ ] _ � � } = s � j � � ? � ` � c | � l \ V � � � � � E ) : q � � Q C b 1 0 h A y � d R ^ O � � � � � � 5 � � � e P
By default, a database with the same name as the current user is created.
Connection options:
Options:
Read the description of the SQL command CLUSTER for details.
Read the description of the SQL command REINDEX for details.
Read the description of the SQL command VACUUM for details.
Report bugs to <pgsql-bugs@postgresql.org>.
--analyze-in-stages only update optimizer statistics, in multiple
stages for faster results; no vacuum
--lc-collate=LOCALE LC_COLLATE setting for the database
--lc-ctype=LOCALE LC_CTYPE setting for the database
%s [OPTION]...
%s [OPTION]... DBNAME
%s [OPTION]... LANGNAME [DBNAME]
%s [OPTION]... [DBNAME]
%s [OPTION]... [DBNAME] [DESCRIPTION]
%s [OPTION]... [ROLENAME]
--if-exists don't report error if database doesn't exist
--if-exists don't report error if user doesn't exist
--interactive prompt for missing role name and attributes rather
than using defaults
--maintenance-db=DBNAME alternate maintenance database
--maintenance-db=DBNAME alternate maintenance database
--no-replication role cannot initiate replication
--replication role can initiate replication
-?, --help show this help, then exit
-?, --help show this help, then exit
-?, --help show this help, then exit
-?, --help show this help, then exit
-D, --no-createdb role cannot create databases (default)
-D, --tablespace=TABLESPACE default tablespace for the database
-E, --encoding=ENCODING encoding for the database
-E, --encrypted encrypt stored password
-F, --freeze freeze row transaction information
-I, --no-inherit role does not inherit privileges
-L, --no-login role cannot login
-N, --unencrypted do not encrypt stored password
-O, --owner=OWNER database user to own the new database
-P, --pwprompt assign a password to new role
-R, --no-createrole role cannot create roles (default)
-S, --no-superuser role will not be superuser (default)
-S, --schema=SCHEMA reindex specific schema(s) only
-T, --template=TEMPLATE template database to copy
-U, --username=USERNAME user name to connect as
-U, --username=USERNAME user name to connect as
-U, --username=USERNAME user name to connect as (not the one to create)
-U, --username=USERNAME user name to connect as (not the one to drop)
-U, --username=USERNAME user name to connect as
-V, --version output version information, then exit
-V, --version output version information, then exit
-V, --version output version information, then exit
-V, --version output version information, then exit
-W, --password force password prompt
-W, --password force password prompt
-Z, --analyze-only only update optimizer statistics; no vacuum
-a, --all vacuum all databases
-a, --all cluster all databases
-a, --all reindex all databases
-c, --connection-limit=N connection limit for role (default: no limit)
-d, --createdb role can create new databases
-d, --dbname=DBNAME database to vacuum
-d, --dbname=DBNAME database from which to remove the language
-d, --dbname=DBNAME database to cluster
-d, --dbname=DBNAME database to install language in
-d, --dbname=DBNAME database to reindex
-d, --dbname=DBNAME database name
-e, --echo show the commands being sent to the server
-e, --echo show the commands being sent to the server
-e, --echo show the commands being sent to the server
-f, --full do full vacuuming
-g, --role=ROLE new role will be a member of this role
-h, --host=HOSTNAME database server host or socket directory
-h, --host=HOSTNAME database server host or socket directory
-h, --host=HOSTNAME database server host or socket directory
-i, --index=INDEX recreate specific index(es) only
-i, --inherit role inherits privileges of roles it is a
member of (default)
-i, --interactive prompt before deleting anything
-i, --interactive prompt before deleting anything, and prompt for
role name if not specified
-j, --jobs=NUM use this many concurrent connections to vacuum
-l, --list show a list of currently installed languages
-l, --locale=LOCALE locale settings for the database
-l, --login role can login (default)
-p, --port=PORT database server port
-p, --port=PORT database server port
-p, --port=PORT database server port
-q, --quiet don't write any messages
-q, --quiet don't write any messages
-q, --quiet run quietly
-r, --createrole role can create new roles
-s, --superuser role will be superuser
-s, --system reindex system catalogs
-t, --table='TABLE[(COLUMNS)]' vacuum specific table(s) only
-t, --table=TABLE cluster specific table(s) only
-t, --table=TABLE reindex specific table(s) only
-t, --timeout=SECS seconds to wait when attempting connection, 0 disables (default: %s)
-v, --verbose write a lot of output
-v, --verbose write a lot of output
-w, --no-password never prompt for password
-w, --no-password never prompt for password
-z, --analyze update optimizer statistics
%s (%s/%s) %s cleans and analyzes a PostgreSQL database.
%s clusters all previously clustered tables in a database.
%s creates a PostgreSQL database.
%s creates a new PostgreSQL role.
%s installs a procedural language into a PostgreSQL database.
%s issues a connection check to a PostgreSQL database.
%s reindexes a PostgreSQL database.
%s removes a PostgreSQL database.
%s removes a PostgreSQL role.
%s removes a procedural language from a database.
%s: "%s" is not a valid encoding name
%s: %s %s: cannot cluster all databases and a specific one at the same time
%s: cannot cluster specific table(s) in all databases
%s: cannot reindex all databases and a specific one at the same time
%s: cannot reindex all databases and system catalogs at the same time
%s: cannot reindex specific index(es) and system catalogs at the same time
%s: cannot reindex specific index(es) in all databases
%s: cannot reindex specific schema(s) and system catalogs at the same time
%s: cannot reindex specific schema(s) in all databases
%s: cannot reindex specific table(s) and system catalogs at the same time
%s: cannot reindex specific table(s) in all databases
%s: cannot use the "%s" option when performing only analyze
%s: cannot vacuum all databases and a specific one at the same time
%s: cannot vacuum specific table(s) in all databases
%s: clustering database "%s"
%s: clustering of database "%s" failed: %s %s: clustering of table "%s" in database "%s" failed: %s %s: comment creation failed (database was created): %s %s: could not connect to database %s: %s %s: could not connect to database %s: out of memory
%s: could not fetch default options
%s: creation of new role failed: %s %s: database creation failed: %s %s: database removal failed: %s %s: invalid socket: %s %s: language "%s" is already installed in database "%s"
%s: language "%s" is not installed in database "%s"
%s: language installation failed: %s %s: language removal failed: %s %s: missing required argument database name
%s: missing required argument language name
%s: missing required argument role name
%s: number of parallel jobs must be at least 1
%s: only one of --locale and --lc-collate can be specified
%s: only one of --locale and --lc-ctype can be specified
%s: processing database "%s": %s
%s: query failed: %s %s: query was: %s
%s: reindexing database "%s"
%s: reindexing of database "%s" failed: %s %s: reindexing of index "%s" in database "%s" failed: %s %s: reindexing of schema "%s" in database "%s" failed: %s %s: reindexing of system catalogs failed: %s %s: reindexing of table "%s" in database "%s" failed: %s %s: removal of role "%s" failed: %s %s: too many command-line arguments (first is "%s")
%s: too many parallel jobs requested (maximum: %d)
%s: vacuuming database "%s"
%s: vacuuming of database "%s" failed: %s %s: vacuuming of table "%s" in database "%s" failed: %s (%lu row) (%lu rows) Are you sure? Cancel request sent
Cannot add cell to table content: total cell count of %d exceeded.
Cannot add header to table content: column count of %d exceeded.
Could not send cancel request: %s Database "%s" will be permanently removed.
Enter it again: Enter name of role to add: Enter name of role to drop: Enter password for new role: Generating default (full) optimizer statistics Generating medium optimizer statistics (10 targets) Generating minimal optimizer statistics (1 target) Interrupted
Name Password encryption failed.
Password: Passwords didn't match.
Please answer "%s" or "%s".
Procedural Languages Role "%s" will be permanently removed.
Shall the new role be a superuser? Shall the new role be allowed to create databases? Shall the new role be allowed to create more new roles? Trusted? Try "%s --help" for more information.
Usage:
accepting connections
cannot duplicate null pointer (internal error)
could not look up effective user ID %ld: %s invalid output format (internal error): %d n no no attempt
no response
out of memory
rejecting connections
unknown
user does not exist user name lookup failure: error code %lu y yes Project-Id-Version: pgscripts (PostgreSQL 9.6)
Report-Msgid-Bugs-To: pgsql-bugs@postgresql.org
POT-Creation-Date: 2016-09-26 14:02+0900
PO-Revision-Date: 2016-09-26 19:04+0900
Last-Translator: Ioseph Kim <ioseph@uri.sarang.net>
Language-Team: Korean <pgsql-kr@postgresql.kr>
Language: ko
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Plural-Forms: nplurals=1; plural=0;
초기값으로, DB이름을 지정하지 않으면, 현재 사용자의 이름과 같은 데이터베이스가 만들어집니다.
연결 옵션들:
옵션들:
보다 자세한 내용은 CLUSTER SQL 명령어 설명서를 참조하십시오.
보다 자세한 내용은 REINDEX SQL 명령어 설명서를 참조하십시오.
보다 자세한 내용은 VACUUM SQL 명령어 설명서를 참조하십시오.
오류보고: <pgsql-bugs@postgresql.org>.
--analyze-in-stages 보다 빠른 결과를 위해 다중 스테이지에서 최적화 통계치만 갱신함;청소 안함
--lc-collate=LOCALE 데이터베이스의 LC_COLLATE 설정
--lc-ctype=LOCALE 데이터베이스의 LC_CTYPE 설정
%s [옵션]...
%s [옵션]... DB이름
%s [옵션]... 언어이름 [DB이름]
%s [옵션]... [DB이름]
%s [옵션]... [DB이름] [설명]
%s [옵션]... [롤이름]
--if-exists 해당 데이터베이스가 없어도 오류를 보고하지 않음
--if-exists 해당 롤이 없어도 오류를 보고하지 않음
--interactive 롤 이름과 속성을 초기값을 쓰지 않고
각각 직접 입력 선택 함
--maintenance-db=DBNAME 대체용 관리 대상 데이터베이스
--maintenance-db=DBNAME 대체용 관리 대상 데이터베이스
--no-replication 복제 기능을 이용할 수 없음
--replication 복제 기능 이용할 수 있는 롤
-?, --help 이 도움말을 표시하고 종료
-?, --help 이 도움말을 보여주고 마침
-?, --help 이 도움말을 보여주고 마침
-?, --help 이 도움말을 보여주고 마침
-D, --no-createdb 데이터베이스를 만들 수 있는 권한 없음 (초기값)
-D, --tablespace=TABLESPACE 데이터베이스를 위한 기본 테이블스페이스
-E, --encoding=ENCODING 데이터베이스 인코딩
-E, --encrypted 암호화된 암호 사용
-F, --freeze 행 트랜잭션 정보 동결
-I, --no-inherit 이 롤의 권한을 상속할 수 없음
-L, --no-login 로그인 할 수 없음
-N, --unencrypted 암호화 되지 않은 암호 사용
-O, --owner=OWNER 데이터베이스 소유주
-P, --pwprompt 새 롤의 암호 지정
-R, --no-createrole 롤 만들 수 있는 권한 없음 (초기값)
-S, --no-superuser 슈퍼유저 권한 없음 (초기값)
-S, --schema=SCHEMA 지정한 스키마들 자료만 덤프
-T, --template=TEMPLATE 복사할 템플릿 데이터베이스
-U, --username=USERNAME 접속할 사용자
-U, --username=USERNAME 접속할 사용자이름
-U, --username=USERNAME 서버에 접속할 사용자
(사용자만들기 작업을 할 사용자)
-U, --username=USERNAME 이 작업을 진행할 DB에 접속할 사용자
-U, --username=USERNAME 접속할 사용자이름
-V, --version 버전 정보를 보여주고 마침
-V, --version 버전 정보를 보여주고 마침
-V, --version 버전 정보를 보여주고 마침
-V, --version 버전 정보를 보여주고 마침
-W, --password 암호 프롬프트 표시함
-W, --password 암호 프롬프트 표시함
-Z, --analyze-only 청소 작업 없이 쿼리최적화 통계 정보만 갱신함
-a, --all 모든 데이터베이스 청소
-a, --all 모든 데이터베이스를 대상으로
-a, --all 모든 데이터베이스 재색인
-c, --connection-limit=N 연결 제한 수 (초기값: 무제한)
-d, --createdb 새 데이터베이스를 만들 수 있음
-d, --dbname=DBNAME DBNAME 데이터베이스 청소
-d, --dbname=DBNAME 언어를 삭제할 데이터베이스
-d, --dbname=DBNAME 클러스터 작업할 DB
-d, --dbname=DBNAME 언어를 설치할 DB이름
-d, --dbname=DBNAME 지정한 데이터베이스의 재색인 작업
-d, --dbname=DBNAME 데이터베이스 이름
-e, --echo 서버로 보내는 명령들을 보여줌
-e, --echo 서버로 보내는 작업 명령들을 보여줌
-e, --echo 서버로 보내는 작업 명령을 보여줌
-f, --full 대청소
-g, --role=ROLE 만들어지는 롤이 이 롤의 구성원이 됨
-h, --host=HOSTNAME 데이터베이스 서버 호스트나 소켓 디렉터리
-h, --host=HOSTNAME 데이터베이스 서버 호스트 또는 소켓 디렉터리
-h, --host=HOSTNAME 접속할 데이터베이스 서버 또는 소켓 디렉터리
-i, --index=INDEX 지정한 인덱스들만 다시 만듬
-i, --inherit 롤의 권한을 상속할 수 있음
(초기값)
-i, --interactive 지우기 전에 한 번 더 물어봄
-i, --interactive 롤 이름을 입력하지 않았다면,
해당 이름을 물어봄
-j, --jobs=NUM 청소 작업을 여러개의 연결로 동시에 작업함
-l, --list 현재 설치 되어있는 언어들을 보여줌
-l, --locale=LOCALE 데이터베이스의 로캘 설정
-l, --login 로그인 허용 (초기값)
-p, --port=PORT 데이터베이스 서버 포트
-p, --port=PORT 데이터베이스 서버 포트
-p, --port=PORT 데이터베이스 서버 포트
-q, --quiet 어떠한 메시지도 보여주지 않음
-q, --quiet 어떠한 메시지도 보여주지 않음
-q, --quiet 조용히 실행함
-r, --createrole 새 롤을 만들 수 있음
-s, --superuser superuser 권한으로 지정
-s, --system 시스템 카탈로그 재색인
-t, --table='TABLE[(COLUMNS)]' 지정한 특정 테이블들만 청소
-t, --table=TABLE 지정한 테이블들만 클러스터
-t, --table=TABLE 지정한 테이블들만 재색인 작업
-t, --timeout=초 연결 제한 시간, 0 무제한 (초기값: %s)
-v, --verbose 작업내역의 자세한 출력
-v, --verbose 많은 출력 작성
-w, --no-password 암호 프롬프트 표시 안 함
-w, --no-password 암호 프롬프트 표시 안 함
-z, --analyze 쿼리최적화 통계 정보를 갱신함
%s (%s/%s) %s 프로그램은 PostgreSQL 데이터베이스 자료 정리 및
퀴리 최적화기의 참고 자료를 갱신합니다.
%s 프로그램은 DB 안에서 이전에 클러스터된 모든 테이블을 찾아
다시 클러스터 작업을 합니다.
%s 프로그램은 PostgreSQL 데이터베이스를 만듭니다.
%s 프로그램은 PostgreSQL 롤을 만듭니다.
%s 프로그램은 PostgreSQL 데이터베이스에 프로시쥬얼 언어를 설치합니다.
%s 프로그램은 PostgreSQL 데이터베이스 접속을 검사합니다.
%s 프로그램은 PostgreSQL 데이터베이스 재색인 작업을 합니다.
%s 프로그램은 PostgreSQL 데이터베이스를 삭제합니다.
%s 프로그램은 PostgreSQL 롤을 삭제합니다.
%s 프로그램은 데이터베이스에서 프로시쥬얼 언어를 삭제합니다.
%s: "%s" 인코딩은 사용 가능한 인코딩 이름이 아님
%s: %s %s: 모든 DB 작업과 특정 DB 작업은 동시에 할 수 없습니다.
%s: 모든 DB를 대상으로 특정 테이블들을 클러스터할 수 없음
%s: 모든 데이터베이스 재색인 작업과 특정 데이터베이스 재색인 작업은 동시에 진행할 수 없습니다
%s: 모든 데이터베이스 재색인 작업과 시스템 카탈로그 재색인 작업은 동시에 진행할 수 없습니다
%s: 특정 인덱스와 시스템 카탈로그 재색인 작업은 동시에 진행할 수 없습니다
%s: 모든 데이터베이스 재색인 작업에서 특정 인덱스 재색인 작업을 지정할 수 없습니다
%s: 특정 스키마와 시스템 카탈로그 재색인 작업은 동시에 진행할 수 없습니다
%s: 모든 데이터베이스 재색인 작업에서 특정 스키마들의 재색인 작업을 지정할 수 없습니다
%s: 특정 테이블과 시스템 카탈로그 재색인 작업은 동시에 진행할 수 없습니다
%s: 모든 데이터베이스 재색인 작업에서 특정 테이블의 재색인 작업을 지정할 수 없습니다
%s: 통계 수집 전용 작업에서는 "%s" 옵션을 사용할 수 없음
%s: -a 옵션이 있을 경우는 한 데이터베이스를 대상으로 작업을 진행할 수 없습니다.
%s: 모든 데이터베이스를 대상으로 특정 테이블들을 청소할 수는 없음
%s: "%s" 데이터베이스 클러스터 작업 중
%s: "%s" 데이터베이스 클러스터 실패: %s %s: "%s" 테이블(해당DB: "%s") 클러스터 작업 실패: %s %s: 코멘트 추가하기 실패 (데이터베이스는 만들어졌음): %s %s: %s 데이터베이스에 연결 할 수 없음: %s %s: %s 데이터베이스에 연결 할 수 없음: 메모리 부족
%s: 기본 옵션 값을 가져올 수 없음
%s: 새 롤 만들기 실패: %s %s: 데이터베이스 만들기 실패: %s %s: 데이터베이스 삭제 실패: %s %s: 잘못된 소켓: %s %s: "%s" 언어는 이미 "%s" 데이터베이스에 설치되어 있습니다.
%s: "%s" 언어는 "%s" 데이터베이스에 설치 되어있지 않습니다
%s: 언어 설치 실패: %s %s: 언어 삭제 실패: %s %s: 필수 항목인 데이터베이스 이름이 빠졌습니다
%s: 필수 항목인, 언어 이름을 지정할 인수가 빠졌습니다
%s: 롤 이름은 필수 입력 인자입니다
%s: 병렬 작업 숫자는 최소 1이어야 함
%s: --locale 및 --lc-collate 중 하나만 지정할 수 있음
%s: --locale 및 --lc-ctype 중 하나만 지정할 수 있음
%s: "%s" 데이터베이스 작업 중: %s
%s: 쿼리 실패: %s %s: 사용된 쿼리: %s
%s: "%s" 데이터베이스 재색인 작업 중
%s: "%s" 데이터베이스 재색인 작업 실패: %s %s: "%s" 인덱스(해당DB: "%s") 재색인 작업 실패: %s %s: "%s" 스키마(해당DB: "%s") 재색인 작업 실패: %s %s: 시스템 카탈로그 재색인 작업 실패: %s %s: "%s" 테이블(해당DB: "%s") 재색인 작업 실패: %s %s: "%s" 롤 삭제 실패: %s %s: 너무 많은 명령행 인수들 (시작 "%s")
%s: 너무 많은 병렬 작업 요청 (최대: %d)
%s: "%s" 데이터베이스를 청소 중
%s: "%s" 데이터베이스 청소하기 실패: %s %s: "%s" 테이블 (해당 DB: "%s") 청소하기 실패: %s (%lu개 행) 정말 계속 할까요? (y/n) 취소 요청을 전송함
테이블 내용에 셀을 추가할 수 없음: 총 셀 수가 %d개를 초과했습니다.
테이블 내용에 헤더를 추가할 수 없음: 열 수가 %d개를 초과했습니다.
취소 요청을 전송할 수 없음: %s "%s" 데이터베이스가 완전히 삭제 될 것입니다.
암호 확인: 추가할 새 롤(role)이름: 삭제할 롤 이름을 입력하십시오: 새 롤의 암호: 최대 최적화 통계 수집 수행중 (모든 자료 대상) 일반 최적화 통계 수집 수행 중 (10% 대상) 최소 최적화 통계 수집 수행 중 (1% 대상) 인트럽트발생
이름 암호 암호화 실패.
암호: 암호가 서로 틀림.
"%s" 또는 "%s" 만 허용합니다.
프로시쥬얼 언어들 "%s" 롤은 영구히 삭제될 것입니다.
새 롤을 superuser 권한으로 지정할까요? 이 새 롤에게 데이터베이스를 만들 수 있는 권할을 줄까요? 이 새 롤에게 또 다른 롤을 만들 수 있는 권한을 줄까요? 신뢰된? 보다 자세한 사용법은 "%s --help"
사용법:
접속을 받아드리는 중
null 포인터를 복제할 수 없음(내부 오류)
UID %ld 해당하는 사용자를 찾을 수 없음: %s 잘못된 출력 형식 (내부 오류): %d n 아니오 시도 없음
응답 없음
메모리 부족
접속을 거절하는 중
알수없음
사용자 없음 사용자 이름 찾기 실패: 오류번호 %lu y 예 locale/ko/LC_MESSAGES/pg_config-9.6.mo 0000644 00000014120 14751153420 0013003 0 ustar 00 �� * l ; � � E � 0 � : 3 E n I � L � s K K � = B I i � G � J > M � M � ? % G e > � 6 � < # > ` F � P � I 7
4 �
2 �
* �
. , 8 & e � & � � ( � ! B V c � u V M n � � � L V Q � F � � < E � G B N � � F R Z U � G < K O � J � 9 # < ] C � K � ` * U � 7 � = = W � � + � 5 � * ) ' T ) | - � * � # � # > % * ) $
" '
& ( ! #
%s provides information about the installed version of PostgreSQL.
With no arguments, all known items are shown.
%s [OPTION]...
--bindir show location of user executables
--cc show CC value used when PostgreSQL was built
--cflags show CFLAGS value used when PostgreSQL was built
--cflags_sl show CFLAGS_SL value used when PostgreSQL was built
--configure show options given to "configure" script when
PostgreSQL was built
--cppflags show CPPFLAGS value used when PostgreSQL was built
--docdir show location of documentation files
--htmldir show location of HTML documentation files
--includedir show location of C header files of the client
interfaces
--includedir-server show location of C header files for the server
--ldflags show LDFLAGS value used when PostgreSQL was built
--ldflags_ex show LDFLAGS_EX value used when PostgreSQL was built
--ldflags_sl show LDFLAGS_SL value used when PostgreSQL was built
--libdir show location of object code libraries
--libs show LIBS value used when PostgreSQL was built
--localedir show location of locale support files
--mandir show location of manual pages
--pgxs show location of extension makefile
--pkgincludedir show location of other C header files
--pkglibdir show location of dynamically loadable modules
--sharedir show location of architecture-independent support files
--sysconfdir show location of system-wide configuration files
--version show the PostgreSQL version
-?, --help show this help, then exit
%s: could not find own program executable
%s: invalid argument: %s
Options:
Report bugs to <pgsql-bugs@postgresql.org>.
Try "%s --help" for more information.
Usage:
could not change directory to "%s": %s could not find a "%s" to execute could not identify current directory: %s could not read binary "%s" could not read symbolic link "%s" invalid binary "%s" not recorded pclose failed: %s Project-Id-Version: PostgreSQL 9.6 pg_config
Report-Msgid-Bugs-To: pgsql-bugs@postgresql.org
POT-Creation-Date: 2016-09-26 14:02+0900
PO-Revision-Date: 2016-09-26 16:47+0900
Last-Translator: Ioseph Kim <ioseph@uri.sarang.net>
Language-Team: Korean team <pgsql-kr@postgresql.kr>
Language: ko
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Plural-Forms: nplurals=1; plural=0;
%s 프로그램은 설치된 PostgreSQL 버전에 대한 정보를 제공합니다.
명령행 인수가 없으면 모든 항목에 대한 정보를 보여 줌
%s [OPTION]...
--bindir 사용자가 실행할 수 있는 응용프로그램들이 있는
경로를 보여줌
--cc PostgreSQL 만들 때 사용된 CC 값을 보여줌
--cflags PostgreSQL 만들 때, 사용한 CFLAGS 값을 보여줌
--cflags_sl PostgreSQL 만들 때 지정한 CFLAGS_SL 값
--configure PostgreSQL 만들 때 사용한 "configure" 스크립트의
옵션들을 보여줌
--cppflags PostgreSQL 만들 때 지정한 CPPFLAGS 값
--docdir 문서 파일들이 있는 위치를 보여줌
--htmldir HTML 문서 파일의 위치를 보여줌
--includedir 클라이언트 인터페이스의 C 헤더 파일이 있는 경로를
보여줌
--includedir-server 서버용 C 헤더 파일 경로를 보여줌
--ldflags PostgreSQL 만들 때, 사용한 LDFLAGS 값을 보여줌
--ldflags_ex PostgreSQL 만들 때, 사용한 LDFLAGS_EX 값을 보여줌
--ldflags_sl PostgreSQL 만들 때 지정한 LDFLAGS_SL 값
--libdir 라이브러리 경로를 보여줌
--libs PostgreSQL 만들 때, 사용한 LIBS 값을 보여줌
--localedir 로케인 지원 파일들의 위치를 보여줌
--mandir 맨페이지 위치를 보여줌
--pgxs 확장 makefile 경로를 보여줌
--pkgincludedir 기타 C 헤더 파일 위치를 보여줌
--pkglibdir 동적 호출 가능 모듈의 경로를 보여줌
--sharedir 각종 공용으로 사용되는 share 파일들의 위치를 보여줌
--sysconfdir 시스템 전역 환경 설정 파일의 위치를 보여줌
--version PostgreSQL 버전을 보여줌
-?, --help 이 도움말을 보여주고 마침
%s: 실행 가능한 프로그램을 찾을 수 없습니다
%s: 잘못된 인수: %s
옵션들:
오류보고: <pgsql-bugs@postgresql.org>.
보다 자세한 정보가 필요하면, "%s --help"
사용법:
"%s" 디렉터리로 바꿀 수 없음: %s 실행할 "%s" 파일 찾을 수 없음 현재 디렉터리를 알 수 없음: %s "%s" 바이너리 파일을 읽을 수 없음 "%s" 심벌릭 링크를 읽을 수 없음 잘못된 바이너리 파일: "%s" 기록되어 있지 않음 pclose 실패: %s locale/ko/LC_MESSAGES/pg_dump-9.6.mo 0000644 00000175577 14751153420 0012533 0 ustar 00 �� � D � l �( �( �( X �( [ ) B g) ) �) " �) x �) p* v* �* �* A �* N �* P M+ I �+ 3 �+ y , G �, C �, N "- K q- v �- F 4. > {. R �. B
/ E P/ ? �/ L �/ 3 #0 6 W0 Q �0 T �0 M 51 ? �1 � �1 � Q2 ?
3 9 J3 5 �3 : �3 K �3 B A4 D �4 � �4 3 J5 � ~5 ? 6 D @6 x �6 6 �6 Q 57 O �7 F �7 > 8 5 ]8 > �8 E �8 A 9 O Z9 H �9 B �9 @ 6: = w: O �: H ; ; N; , �; 4 �; E �; 0 2< = c< , �< F �< D = C Z= F �= 8 �= ? > C ^> = �> 4 �> 7 ? L M? = �? @ �? J @ < d@ L �@ , �@ ( A 5 DA E zA T �A B 9 B D RB G �B �B �B ? C ' UC + }C e �C ! D , 1D 4 ^D 6 �D ( �D / �D #E AE $ SE * xE 2 �E B �E > F J XF P �F N �F H CG - �G �G �G / �G H 4 $H $ YH & ~H * �H # �H �H P I C dI A �I ( �I J 1J JJ eJ = �J � �J
KK , VK � �K � L , �L �L p �L e fM & �M �M ` �M p \N 4 �N X O _ [O E �O 1 P 6 3P 4 jP * �P - �P . �P + 'Q + SQ ) Q * �Q > �Q 8 R ' LR = tR ) �R 1 �R S @ )S 7 jS 6 �S 6 �S < T = MT 4 �T 3 �T b �T 9 WU < �U t �U # CV , gV 5 �V �V �V W
W ' #W KW % WW }W / �W X �W & &X 0 MX . ~X ) �X ) �X Y Y *Y 3 6Y ( jY �Y ) �Y # �Y �Y Z & 0Z K WZ & �Z �Z ! �Z (
[ ' 3[ [[ # z[ �[ / �[ �[ \ # +\ % O\ u\ , �\ $ �\ $ �\ $ ] 6 .] e] }] B �] � �] � x^ _ $ '_ 3 L_ ' �_ ' �_ + �_ ( �_ ( %` # N` - r` � �` + pa , �a ! �a & �a ' b # :b ^b " }b 8 �b $ �b �b c Q =c & �c a �c @ d 5 Yd �d " �d # �d , �d e ! =e # _e * �e # �e % �e 0 �e & )f $ Pf uf " �f = �f 1 �f 'g 9g Ng : ^g ) �g B �g P h Wh jh �h �h " �h �h �h & i & 5i % \i 2 �i �i �i & �i !
j ) /j # Yj " }j �j r �j < $k D ak N �k �k l 5l & Ol , vl - �l �l " �l / m >m Vm ( sm @ �m �m �m n P 0n �n > �n 1 �n > o / Go Y wo > �o p +p " Ip lp & �p < �p �p ' q ( )q ' Rq zq �q �q 1 �q + �q % r 3 Fr zr �r " �r ; �r s s :s / Ys �s �s �s . �s I
t > Wt D �t �t �t u 7 u 9 Qu 6 �u H �u @ v Lv 3 ^v & �v 0 �v 6 �v / !w ( Qw , zw �w " �w �w �w x h %x T �x � �x 6 fy L �y J �y 9 5z oz $ ~z + �z �z �z { { 1{ 2 E{ x{ " �{ �{ �{ # �{ �{ | / .| ^| & o| �| �| # �| �| $ �| ) } C} ! d} % �} + �} �} & �} ' ~ G~ g~ 0 �~ . �~ ) �~ + : V 4 t � � # ,� * P� {� �� �� ( À � " � &� E ;� # �� ) �� , ρ �� � ,� ; 3� o� �� �� ' �� ւ ' � � % 6� \� x� B �� 0 ! � 8 +� : d� �� �� 3 ڄ 1 � 1 @� + r� $ �� $ Å h � � Q� � �� \ � i n� a ؈ ' :� * b� � �� � #� 5� R� C m� Y �� Y � R e� 7 �� � � K �� I ӌ M � ^ k� i ʍ L 4� D �� [ Ǝ S "� S v� T ʏ ^ � 9 ~� 9 �� R � � E� � ˑ A u� � �� � i� M &� D t� @ �� J �� Y E� Q �� V � � H� : ޖ � � K �� D �� � A� 7 Ø � �� e �� Q � G B� : �� B Ś D � @ M� U �� ; � A � G b� C �� c � \ R� 8 �� 8 � ? !� V a� 8 �� L � 0 >� ] o� Z ͟ D (� K m� ? �� C �� J =� D �� 7 ͡ F � l L� A �� A �� P =� J �� l ٣ > F� 6 �� > �� U �� I Q� �� u �� � � � �� � ! :� M \� 4 �� 8 ߧ � � $ �� 2 è W �� Y N� / �� 9 ة * � =� O� - p� G �� N � D 5� P z� V ˫ T "� T w� X ̬ %� ;� 6 U� �� 4 �� " խ : �� = 3� ( q� ( �� e î P )� N z� 1 ɯ ( �� ! $� F� d� 8 �� F �� � + � � 7� � � , ݲ
� � � � ճ * ]� �� u �� �
� I �� �
� b �� U � = X� B �� @ ٷ 6 � 1 Q� < �� 9 �� 9 �� 8 4� 2 m� A �� = � ? � Q `� 4 �� = � %� G @� B �� @ ˻ B � M O� I �� > � C &� � j� : �� I 7� | �� 2 �� 6 1� A h� , �� . � � ' #� K� : ]� - �� 7 � } �� 8 |� ? �� ; �� 4 1� = f� �� �� �� = �� = %� c� = u� D �� / �� (� 4 G� Y |� * �� $ � ' &� 0 N� * � ' �� + �� ' �� 7 &� ' ^� % �� $ �� 8 �� #
� ' .� + V� ( �� 0 �� D �� !� + A� m m� � �� � �� + c� 4 �� I �� A � 3 P� 3 �� 3 �� ) �� ' � 7 >� � v� 1 T� 5 �� + �� + �� + � ) @� $ j� % �� > �� ) �� $ � C� c d� / �� w �� Z p� J �� - � + D� ' p� / �� ' �� * �� 2 � 9 N� + �� 4 �� D �� > .� 7 m� * �� " �� @ �� ' 4� \� s� �� 0 �� ? �� T � V g� �� ( �� I � K� ' c� + �� ) �� 1 �� . � ' B� P j� �� A �� & � % 7� 3 ]� 8 �� 7 �� � L � P a� X �� Y � ! e� $ �� " �� : �� H
� 5 S� �� �� 7 �� �� � / 2� K b� ! �� �� 8 �� 0 &� $ W� Z |� F �� Y � B x� ] �� H � b� �� �� �� 9 �� T � " p� = �� / �� G � I� f� ~� 9 �� A �� 5 � I E� �� $ �� : �� J � V� + r� + �� = �� ; � D� # b� C �� O �� D � J _� �� ' �� �� R �� k K� M �� X � M ^� �� 9 �� 3 �� / ,� @ \� 6 �� 0 �� / � 5� * D� $ o� 3 �� �� � �� : \� a �� L �� ` F� 6 �� ' �� � 2 � N O� �� �� �� % � &� J @� �� @ �� �� � . � % C� i� B � �� & �� � &� @ B� ) �� - �� - �� 5 � 6 ?� - v� 7 �� & �� 3 � 0 7� ) h� , �� 7 �� 7 �� 7 /� : g� ) �� ( �� ! �� � � ! �� , �� 6 #� Z� ' t� + �� $ �� ) �� � Y ,� ! �� A �� D � $ /� ! T� v� W }� $ � �� ' � . 3� $ b� �� , �� , � " �� # � R B� 6 �� ( � W �� V M� �� # � B � 9 +� 9 e� B �� 0 � 0 � : D� f � � � � y � � � � E L � � � * � 9 } � ' � K G 3 W ) B � � � f � � C H V � � � Z a � } ( � F � c � � > � G � S C � � � � 0 ~ i ) A � � !
[ � � � � * � l � z o � � � � � � � ^ � . V � o � ` � � � � 1 � � � N P � � � M � � q � c � 2 t 5 � h � � � < � � E M � � { � � J > � � � � I Y � � � � � � � + b � � � � � � \ � O r u : - � � R � j ^ � 4 I � F � � " w N
� � � ' d B " � � � � � � � 3 q � 5 � � | � � � { w � r � & L � i � � � � / ` � D [ � n a � ; ~ g @ �
\ p X � T � � % p � � X � � � � P | . n � � � � � � � ? � � � � � � � = � � � � ] � � 7 D � � v � � � � ( @ s � � ! � O � g � � Q H � k R � y � & � = 8 ? $ � e 9 � � - : � � 7 � � l t � � � � � � # � � � j , # � b � � � _ � � S � � � 2 k h � � m J � e 6 Z � � K � 4 Q � < � � � 6 � � 1 � � � s � + / � $ � x � � % _ � ] u d , � � 0 � U � � A T Y � 8 � � � � m ; U � z W x v �
Connection options:
General options:
If -f/--file is not used, then the SQL script will be written to the standard
output.
If no database name is supplied, then the PGDATABASE environment
variable value is used.
If no input file name is supplied, then standard input is used.
Options controlling the output content:
Options controlling the restore:
The options -I, -n, -P, -t, -T, and --section can be combined and specified
multiple times to select multiple objects.
%s
%s [OPTION]...
%s [OPTION]... [DBNAME]
%s [OPTION]... [FILE]
--binary-upgrade for use by upgrade utilities only
--column-inserts dump data as INSERT commands with column names
--disable-dollar-quoting disable dollar quoting, use SQL standard quoting
--disable-triggers disable triggers during data-only restore
--enable-row-security enable row security
--enable-row-security enable row security (dump only content user has
access to)
--exclude-table-data=TABLE do NOT dump data for the named table(s)
--if-exists use IF EXISTS when dropping objects
--inserts dump data as INSERT commands, rather than COPY
--lock-wait-timeout=TIMEOUT fail after waiting TIMEOUT for a table lock
--no-data-for-failed-tables do not restore data of tables that could not be
created
--no-security-labels do not dump security label assignments
--no-security-labels do not restore security labels
--no-synchronized-snapshots do not use synchronized snapshots in parallel jobs
--no-tablespaces do not dump tablespace assignments
--no-tablespaces do not restore tablespace assignments
--no-unlogged-table-data do not dump unlogged table data
--quote-all-identifiers quote all identifiers, even if not key words
--role=ROLENAME do SET ROLE before dump
--role=ROLENAME do SET ROLE before restore
--section=SECTION dump named section (pre-data, data, or post-data)
--section=SECTION restore named section (pre-data, data, or post-data)
--serializable-deferrable wait until the dump can run without anomalies
--snapshot=SNAPSHOT use given snapshot for the dump
--strict-names require table and/or schema include patterns to
match at least one entity each
--use-set-session-authorization
use SET SESSION AUTHORIZATION commands instead of
ALTER OWNER commands to set ownership
-1, --single-transaction restore as a single transaction
-?, --help show this help, then exit
-?, --help show this help, then exit
-C, --create create the target database
-C, --create include commands to create database in dump
-E, --encoding=ENCODING dump the data in encoding ENCODING
-F, --format=c|d|t backup file format (should be automatic)
-F, --format=c|d|t|p output file format (custom, directory, tar,
plain text (default))
-I, --index=NAME restore named index
-L, --use-list=FILENAME use table of contents from this file for
selecting/ordering output
-N, --exclude-schema=SCHEMA do NOT dump the named schema(s)
-O, --no-owner skip restoration of object ownership
-O, --no-owner skip restoration of object ownership in
plain-text format
-P, --function=NAME(args) restore named function
-S, --superuser=NAME superuser user name to use for disabling triggers
-S, --superuser=NAME superuser user name to use in plain-text format
-S, --superuser=NAME superuser user name to use in the dump
-T, --exclude-table=TABLE do NOT dump the named table(s)
-T, --trigger=NAME restore named trigger
-U, --username=NAME connect as specified database user
-V, --version output version information, then exit
-V, --version output version information, then exit
-W, --password force password prompt (should happen automatically)
-Z, --compress=0-9 compression level for compressed formats
-a, --data-only dump only the data, not the schema
-a, --data-only restore only the data, no schema
-b, --blobs include large objects in dump
-c, --clean clean (drop) database objects before recreating
-c, --clean clean (drop) databases before recreating
-d, --dbname=CONNSTR connect using connection string
-d, --dbname=DBNAME database to dump
-d, --dbname=NAME connect to database name
-e, --exit-on-error exit on error, default is to continue
-f, --file=FILENAME output file name
-f, --file=FILENAME output file or directory name
-f, --file=FILENAME output file name
-g, --globals-only dump only global objects, no databases
-h, --host=HOSTNAME database server host or socket directory
-j, --jobs=NUM use this many parallel jobs to dump
-j, --jobs=NUM use this many parallel jobs to restore
-l, --database=DBNAME alternative default database
-l, --list print summarized TOC of the archive
-n, --schema=NAME restore only objects in this schema
-n, --schema=SCHEMA dump the named schema(s) only
-o, --oids include OIDs in dump
-p, --port=PORT database server port number
-r, --roles-only dump only roles, no databases or tablespaces
-s, --schema-only dump only the schema, no data
-s, --schema-only restore only the schema, no data
-t, --table=NAME restore named relation (table, view, etc.)
-t, --table=TABLE dump the named table(s) only
-t, --tablespaces-only dump only tablespaces, no databases or roles
-v, --verbose verbose mode
-v, --verbose verbose mode
-w, --no-password never prompt for password
-x, --no-privileges do not dump privileges (grant/revoke)
-x, --no-privileges skip restoration of access privileges (grant/revoke)
%s %s dumps a database as a text file or to other formats.
%s extracts a PostgreSQL database cluster into an SQL script file.
%s restores a PostgreSQL database from an archive created by pg_dump.
%s: %s Command was: %s
%s: WSAStartup failed: %d
%s: cannot specify both --single-transaction and multiple jobs
%s: could not connect to database "%s"
%s: could not connect to database "%s": %s
%s: could not connect to databases "postgres" or "template1"
Please specify an alternative database.
%s: could not get server version
%s: could not open the output file "%s": %s
%s: could not parse ACL list (%s) for database "%s"
%s: could not parse ACL list (%s) for tablespace "%s"
%s: could not parse server version "%s"
%s: could not re-open the output file "%s": %s
%s: dumping database "%s"...
%s: executing %s
%s: invalid number of parallel jobs
%s: maximum number of parallel jobs is %d
%s: option --if-exists requires option -c/--clean
%s: options -c/--clean and -a/--data-only cannot be used together
%s: options -d/--dbname and -f/--file cannot be used together
%s: options -g/--globals-only and -r/--roles-only cannot be used together
%s: options -g/--globals-only and -t/--tablespaces-only cannot be used together
%s: options -r/--roles-only and -t/--tablespaces-only cannot be used together
%s: options -s/--schema-only and -a/--data-only cannot be used together
%s: pg_dump failed on database "%s", exiting
%s: query failed: %s %s: query was: %s
%s: role name starting with "pg_" skipped (%s)
%s: running "%s"
%s: too many command-line arguments (first is "%s")
%s: unrecognized section name: "%s"
(The INSERT command cannot set OIDs.)
(The system catalogs might be corrupted.)
-C and -1 are incompatible options
COPY failed for table "%s": %s Consider using a full dump instead of a --data-only dump to avoid this problem.
Dumping the contents of table "%s" failed: PQgetCopyData() failed.
Dumping the contents of table "%s" failed: PQgetResult() failed.
Error from TOC entry %d; %u %u %s %s %s
Error message from server: %s Error while FINALIZING:
Error while INITIALIZING:
Error while PROCESSING TOC:
Exported snapshots are not supported by this server version.
NOTICE: there are circular foreign-key constraints on this table:
NOTICE: there are circular foreign-key constraints among these tables:
Password: Report bugs to <pgsql-bugs@postgresql.org>.
Synchronized snapshots are not supported by this server version.
Run with --no-synchronized-snapshots instead if you do not need
synchronized snapshots.
Synchronized snapshots are not supported on standby servers.
Run with --no-synchronized-snapshots instead if you do not need
synchronized snapshots.
TOC Entry %s at %s (length %s, checksum %d)
The command was: %s
The program "pg_dump" is needed by %s but was not found in the
same directory as "%s".
Check your installation.
The program "pg_dump" was found by "%s"
but was not the same version as %s.
Check your installation.
Try "%s --help" for more information.
Usage:
WARNING: aggregate function %s could not be dumped correctly for this database version; ignored
WARNING: archive is compressed, but this installation does not support compression -- no data will be available
WARNING: archive items not in correct section order
WARNING: archive was made on a machine with larger integers, some operations might fail
WARNING: bogus transform definition, at least one of trffromsql and trftosql should be nonzero
WARNING: bogus value in pg_cast.castfunc or pg_cast.castmethod field
WARNING: bogus value in pg_cast.castmethod field
WARNING: bogus value in pg_transform.trffromsql field
WARNING: bogus value in pg_transform.trftosql field
WARNING: bogus value in proargmodes array
WARNING: could not find operator with OID %s
WARNING: could not parse proallargtypes array
WARNING: could not parse proargmodes array
WARNING: could not parse proargnames array
WARNING: could not parse proconfig array
WARNING: could not parse reloptions array
WARNING: could not resolve dependency loop among these items:
WARNING: don't know how to set owner for object type %s
WARNING: errors ignored on restore: %d
WARNING: ftell mismatch with expected position -- ftell used
WARNING: invalid creation date in header
WARNING: invalid type "%c" of access method "%s"
WARNING: line ignored: %s
WARNING: owner of aggregate function "%s" appears to be invalid
WARNING: owner of data type "%s" appears to be invalid
WARNING: owner of function "%s" appears to be invalid
WARNING: owner of operator "%s" appears to be invalid
WARNING: owner of operator class "%s" appears to be invalid
WARNING: owner of operator family "%s" appears to be invalid
WARNING: owner of schema "%s" appears to be invalid
WARNING: owner of table "%s" appears to be invalid
WARNING: requested compression not available in this installation -- archive will be uncompressed
WARNING: typtype of data type "%s" appears to be invalid
WARNING: unexpected extra results during COPY of table "%s"
You might not be able to restore the dump without using --disable-triggers or temporarily dropping the constraints.
a worker process died unexpectedly
aborting because of server version mismatch
actual file length (%s) does not match expected (%s)
allocating AH for %s, format %d
already connected to a database
archiver archiver (db) attempting to ascertain archive format
bad dumpId
bad table dumpId for TABLE DATA item
can only reopen input archives
cannot duplicate null pointer (internal error)
cannot restore from compressed archive (compression not supported in this installation)
child process exited with exit code %d child process exited with unrecognized status %d child process was terminated by exception 0x%X child process was terminated by signal %d child process was terminated by signal %s command not executable command not found compress_io compression is not supported by tar archive format
compression level must be in range 0..9
compressor active
connecting to database "%s" as user "%s"
connecting to database for restore
connecting to new database "%s"
connection needs password
connection to database "%s" failed: %s corrupt tar header found in %s (expected %d, computed %d) file position %s
could not change directory to "%s": %s could not close TOC file: %s
could not close archive file: %s
could not close compression library: %s
could not close compression stream: %s
could not close data file: %s
could not close directory "%s": %s
could not close input file: %s
could not close large object TOC file "%s": %s
could not close output file: %s
could not close tar member
could not close temporary file: %s
could not commit database transaction could not compress data: %s
could not create communication channels: %s
could not create directory "%s": %s
could not create large object %u: %s could not create worker process: %s
could not determine seek position in archive file: %s
could not execute query could not find a "%s" to execute could not find block ID %d in archive -- possibly corrupt archive
could not find block ID %d in archive -- possibly due to out-of-order restore request, which cannot be handled due to lack of data offsets in archive
could not find block ID %d in archive -- possibly due to out-of-order restore request, which cannot be handled due to non-seekable input file
could not find entry for ID %d
could not find file "%s" in archive
could not find header for file "%s" in tar archive
could not find parent extension for %s
could not find slot of finished worker
could not generate temporary file name: %s
could not get server_version from libpq
could not identify current directory: %s could not identify dependency loop
could not initialize compression library: %s
could not obtain lock on relation "%s"
This usually means that someone requested an ACCESS EXCLUSIVE lock on the table after the pg_dump parent process had gotten the initial ACCESS SHARE lock on the table.
could not open TOC file "%s" for input: %s
could not open TOC file "%s" for output: %s
could not open TOC file "%s": %s
could not open TOC file for input: %s
could not open TOC file for output: %s
could not open input file "%s": %s
could not open input file: %s
could not open large object %u: %s could not open large object TOC file "%s" for input: %s
could not open output file "%s": %s
could not open output file: %s
could not open temporary file
could not parse GRANT ACL list (%s) or REVOKE ACL list (%s) for object "%s" (%s)
could not parse default ACL list (%s)
could not parse initial GRANT ACL list (%s) or initial REVOKE ACL list (%s) for object "%s" (%s)
could not parse numeric array "%s": invalid character in number
could not parse numeric array "%s": too many numbers
could not read binary "%s" could not read directory "%s": %s
could not read from input file: %s
could not read from input file: end of file
could not read input file: %s
could not read symbolic link "%s" could not reconnect to database: %s could not set default_tablespace to %s: %s could not set default_with_oids: %s could not set search_path to "%s": %s could not set seek position in archive file: %s
could not set session user to "%s": %s could not start database transaction could not uncompress data: %s
could not write to blobs TOC file
could not write to large object (result: %lu, expected: %lu)
could not write to the communication channel: %s
creating %s "%s"
creating %s "%s.%s"
custom archiver definition of view "%s" appears to be empty (length zero)
did not find magic string in file header
direct database connections are not supported in pre-1.3 archives
directory "%s" does not appear to be a valid archive ("toc.dat" does not exist)
directory archiver directory name too long: "%s"
disabling triggers for %s
dropping %s %s
dumping contents of table "%s.%s"
enabling triggers for %s
entering main parallel loop
entering restore_toc_entries_parallel
entering restore_toc_entries_postfork
entering restore_toc_entries_prefork
entry ID %d out of range -- perhaps a corrupt TOC
error during backup
error during file seek: %s
error processing a parallel work item
error reading large object %u: %s error reading large object TOC file "%s"
error returned by PQputCopyData: %s error returned by PQputCopyEnd: %s executing %s %s
expected %d check constraint on table "%s" but found %d
expected %d check constraints on table "%s" but found %d
expected format (%d) differs from format found in file (%d)
failed sanity check, parent OID %u of table "%s" (OID %u) not found
failed sanity check, parent table OID %u of pg_rewrite entry OID %u not found
failed to connect to database
failed to reconnect to database
file name too long: "%s"
file offset in dump file is too large
finding check constraints for table "%s.%s"
finding default expressions of table "%s.%s"
finding extension tables
finding inheritance relationships
finding the columns and types of table "%s.%s"
finished item %d %s %s
finished main parallel loop
flagging inherited columns in subtables
found unexpected block ID (%d) when reading data -- expected %d
function "%s" not found
identifying extension members
implied data-only restore
incomplete tar header found (%lu byte)
incomplete tar header found (%lu bytes)
index "%s" not found
input file appears to be a text format dump. Please use psql.
input file does not appear to be a valid archive
input file does not appear to be a valid archive (too short?)
input file is too short (read %lu, expected 5)
internal error -- WriteData cannot be called outside the context of a DataDumper routine
internal error -- neither th nor fh specified in tarReadRaw()
invalid ENCODING item: %s
invalid OID for large object
invalid OID for large object (%u)
invalid STDSTRINGS item: %s
invalid adnum value %d for table "%s"
invalid argument string (%s) for trigger "%s" on table "%s"
invalid binary "%s" invalid client encoding "%s" specified
invalid column number %d for table "%s"
invalid column numbering in table "%s"
invalid compression code: %d
invalid dependency %d
invalid dumpId %d
invalid line in large object TOC file "%s": "%s"
invalid message received from worker: "%s"
invalid output format "%s" specified
large-object output not supported in chosen format
last built-in OID is %u
launching item %d %s %s
missing index for constraint "%s"
moving from position %s to next member at file position %s
no item ready
no matching schemas were found
no matching tables were found
no matching tables were found for pattern "%s"
no output directory specified
not built with zlib support
now at file position %s
option --if-exists requires option -c/--clean
options --inserts/--column-inserts and -o/--oids cannot be used together
options -c/--clean and -a/--data-only cannot be used together
options -s/--schema-only and -a/--data-only cannot be used together
out of memory
out of on_exit_nicely slots
parallel archiver parallel backup only supported by the directory format
parallel restore from non-seekable file is not supported
parallel restore from standard input is not supported
parallel restore is not supported with archives made by pre-8.0 pg_dump
parallel restore is not supported with this archive file format
pclose failed: %s pgpipe: could not accept connection: error code %d
pgpipe: could not bind: error code %d
pgpipe: could not connect socket: error code %d
pgpipe: could not create second socket: error code %d
pgpipe: could not create socket: error code %d
pgpipe: could not listen: error code %d
pgpipe: getsockname() failed: error code %d
processing %s
processing data for table "%s.%s"
processing item %d %s %s
processing missed item %d %s %s
query failed: %s query produced null referenced table name for foreign key trigger "%s" on table "%s" (OID of table: %u)
query returned %d row instead of one: %s
query returned %d rows instead of one: %s
query to get data of sequence "%s" returned %d row (expected 1)
query to get data of sequence "%s" returned %d rows (expected 1)
query to get data of sequence "%s" returned name "%s"
query to get rule "%s" for table "%s" failed: wrong number of rows returned
query to obtain definition of view "%s" returned more than one definition
query to obtain definition of view "%s" returned no data
query was: %s
read TOC entry %d (ID %d) for %s %s
reading column info for interesting tables
reading constraints
reading default privileges
reading dependency data
reading event triggers
reading extensions
reading foreign key constraints for table "%s.%s"
reading indexes
reading indexes for table "%s.%s"
reading large objects
reading policies
reading policies for table "%s.%s"
reading procedural languages
reading rewrite rules
reading row security enabled for table "%s.%s"
reading schemas
reading table inheritance information
reading transforms
reading triggers
reading triggers for table "%s.%s"
reading type casts
reading user-defined access methods
reading user-defined aggregate functions
reading user-defined collations
reading user-defined conversions
reading user-defined foreign servers
reading user-defined foreign-data wrappers
reading user-defined functions
reading user-defined operator classes
reading user-defined operator families
reading user-defined operators
reading user-defined tables
reading user-defined text search configurations
reading user-defined text search dictionaries
reading user-defined text search parsers
reading user-defined text search templates
reading user-defined types
reducing dependencies for %d
restored %d large object
restored %d large objects
restoring data out of order is not supported in this archive format: "%s" is required, but comes before "%s" in the archive file.
restoring large object with OID %u
sanity check on integer size (%lu) failed
saving database definition
saving encoding = %s
saving large objects
saving standard_conforming_strings = %s
schema "%s" not found
schema with OID %u does not exist
select() failed: %s
server version must be at least 7.3 to use schema selection switches
server version: %s; %s version: %s
setting owner and privileges for %s "%s"
setting owner and privileges for %s "%s.%s"
skipping item %d %s %s
skipping tar member %s
sorter table "%s" could not be created, will not restore its data
table "%s" not found
tar archiver this format cannot be read
transferring dependency %d -> %d to %d
trigger "%s" not found
unexpected COPY statement syntax: "%s"
unexpected data offset flag %d
unexpected policy command type: "%s"
unexpected section code %d
unexpected tgtype value: %d
unrecognized archive format "%s"; please specify "c", "d", or "t"
unrecognized command received from master: "%s"
unrecognized constraint type: %c
unrecognized data block type %d while restoring archive
unrecognized data block type (%d) while searching archive
unrecognized encoding "%s"
unrecognized file format "%d"
unrecognized object type in default privileges: %d
unrecognized proparallel value for function "%s"
unrecognized provolatile value for function "%s"
unsupported version (%d.%d) in file header
warning from original dump file: %s
worker process failed: exit code %d
wrote %lu byte of large object data (result = %lu)
wrote %lu bytes of large object data (result = %lu)
Project-Id-Version: PostgreSQL 9.6
Report-Msgid-Bugs-To: pgsql-bugs@postgresql.org
POT-Creation-Date: 2016-09-26 14:02+0900
PO-Revision-Date: 2016-09-26 18:26+0900
Last-Translator: Ioseph Kim <ioseph@uri.sarang.net>
Language-Team: Korean Team <pgsql-kr@postgresql.kr>
Language: ko
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: 8bit
Plural-Forms: nplurals=1; plural=0;
연결 옵션들:
일반 옵션들:
-f/--file을 사용하지 않으면 SQL 스크립트가 표준
출력에 쓰여집니다.
데이터베이스 이름을 지정하지 않았다면, PGDATABASE 환경변수값을
사용합니다.
사용할 입력 파일을 지정하지 않았다면, 표준 입력(stdin)을 사용합니다.
출력 내용을 다루는 옵션들:
리스토어 처리를 위한 옵션들:
-I, -n, -P, -t, -T, --section 옵션은 그 대상이 되는 객체를 복수로 지정하기
위해서 여러번 사용할 수 있습니다.
%s
%s [옵션]...
%s [옵션]... [DB이름]
%s [옵션]... [파일]
--binary-upgrade 업그레이드 유틸리티 전용
--column-inserts 칼럼 이름과 함께 INSERT 명령으로 자료 덤프
--disable-dollar-quoting $ 인용 구문 사용안함, SQL 표준 따옴표 사용
--disable-triggers 자료만 복원할 때 트리거 사용을 안함
--enable-row-security 로우 보안 활성화
--enable-row-security 로우 보안 활성화 (현재 작업자가 접근할 수
있는 자료만 덤프 함)
--exclude-table-data=테이블 해당 테이블 자료는 덤프 안함
--if-exists 객체 삭제 시 IF EXISTS 구문 사용
--inserts COPY 대신 INSERT 명령으로 자료 덤프
--lock-wait-timeout=초 테이블 잠금 시 지정한 초만큼 기다린 후 실패
--no-data-for-failed-tables 만들 수 없는 테이블에 대해서는 자료를 덤프하지 않음
--no-security-labels 보안 라벨 할당을 덤프 하지 않음
--no-security-labels 보안 라벨을 복원하지 않음
--no-synchronized-snapshots 병렬 작업에서 스냅샷 일관성을 맞추지 않음
--no-tablespaces 테이블스페이스 할당을 덤프하지 않음
--no-tablespaces 테이블스페이스 할당을 복원하지 않음
--no-unlogged-table-data 언로그드 테이블 자료는 덤프하지 않음
--quote-all-identifiers 예약어가 아니여도 모든 식별자는 따옴표를 씀
--role=ROLENAME 덤프 전에 SET ROLE 수행
--role=ROLENAME 복원 전에 SET ROLE 수행
--section=SECTION 해당 섹션(pre-data, data, post-data)만 덤프
--section=SECTION 지정한 섹션만 복원함
섹션 종류: pre-data, data, post-data
--serializable-deferrable 자료 정합성을 보장하기 위해 덤프 작업을
직렬화 가능한 트랜잭션으로 처리 함
--snapshot=SNAPSHOT 지정한 스냅샷을 덤프 함
--strict-names 테이블이나 스키마를 지정했을 때 그 패턴에 맞는
객체가 적어도 하나 이상 있어야 함
--use-set-session-authorization
SET SESSION AUTHORIZATION 명령을 ALTER OWNER 명령
대신 사용하여 소유권 설정
-1, --single-transaction 하나의 트랜잭션 작업으로 복원함
-?, --help 이 도움말을 보여주고 마침
-?, --help 이 도움말을 보여주고 마침
-C, --create 작업 대상 데이터베이스를 만듦
-C, --create 데이터베이스 만드는 명령구문도 포함시킴
-E, --encoding=인코딩 지정한 인코딩으로 자료를 덤프 함
-F, --format=c|d|t 백업 파일 형식 (지정하지 않으면 자동분석)
-F, --format=c|d|t|p 출력 파일 형식(사용자 지정, 디렉터리, tar,
일반 텍스트(초기값))
-I, --index=NAME 지정한 인덱스 만듦
-L, --use-list=FILENAME 출력을 선택하고 해당 순서를 지정하기 위해
이 파일의 목차 사용
-N, --exclude-schema=SCHEMA 지정한 SCHEMA들만 빼고 모두 덤프
-O, --no-owner 개체 소유권 복원 건너뛰기
-O, --no-owner 일반 텍스트 형식에서
개체 소유권 복원 건너뛰기
-P, --function=NAME(args) 지정한 함수 만듦
-S, --superuser=NAME 트리거를 사용하지 않기 위해 사용할 슈퍼유저
사용자 이름
-S, --superuser=NAME 일반 텍스트 형식에서 사용할 슈퍼유저 사용자 이름
-S, --superuser=NAME 덤프에 사용할 슈퍼유저 사용자 이름
-T, --exclude-table=TABLE 지정한 테이블들만 빼고 덤프
-T, --trigger=NAME 지정한 트리거 만듦
-U, --username=NAME 연결할 데이터베이스 사용자
-V, --version 버전 정보를 보여주고 마침
-V, --version 버전 정보를 보여주고 마침
-W, --password 암호 입력 프롬프트 보임(자동으로 처리함)
-Z, --compress=0-9 출력 자료 압축 수위
-a, --data-only 스키마 빼고 자료만 덤프
-a, --data-only 스키마는 빼고 자료만 입력함
-b, --blobs Large Object들도 함께 덤프함
-c, --clean 다시 만들기 전에 데이터베이스 개체 지우기(삭제)
-c, --clean 다시 만들기 전에 데이터베이스 지우기(삭제)
-d, --dbname=접속문자열 서버 접속 문자열
-d, --dbname=DBNAME 덤프할 데이터베이스
-d, --dbname=NAME 접속할 데이터베이스 이름
-e, --exit-on-error 오류가 생기면 끝냄, 기본은 계속 진행함
-f, --file=파일이름 출력 파일 이름
-f, --file=파일이름 출력 파일 또는 디렉터리 이름
-f, --file=FILENAME 출력 파일 이름
-g, --globals-only 데이터베이스는 제외하고 글로벌 개체만 덤프
-h, --host=HOSTNAME 접속할 데이터베이스 서버 또는 소켓 디렉터리
-j, --jobs=개수 덤프 작업을 병렬 처리 함
-j, --jobs=NUM 여러 병렬 작업을 사용하여 복원
-l, --database=DBNAME 대체용 기본 데이터베이스
-l, --list 자료의 요약된 목차를 보여줌
-n, --schema=NAME 해당 스키마의 개체들만 복원함
-n, --schema=SCHEMA 지정한 SCHEMA들 자료만 덤프
-o, --oids OID 포함해서 덤프
-p, --port=PORT 데이터베이스 서버의 포트 번호
-r, --roles-only 데이터베이스나 테이블스페이스는 제외하고 역할만 덤프
-s, --schema-only 자료구조(스키마)만 덤프
-s, --schema-only 자료구조(스키마)만 만듦
-t, --table=NAME 복원할 객체 이름 (테이블, 뷰, 기타)
-t, --table=TABLE 지정한 이름의 테이블들만 덤프
-t, --tablespaces-only 데이터베이스나 역할은 제외하고 테이블스페이스만 덤프
-v, --verbose 작업 내역을 자세히 봄
-v, --verbose 자세한 정보 보여줌
-w, --no-password 암호 프롬프트 표시 안 함
-x, --no-privileges 접근 권한 (grant/revoke) 정보는 덤프 안 함
-x, --no-privileges 접근 권한(grant/revoke) 지정 안함
%s %s 프로그램은 데이터베이스를 텍스트 파일 또는 기타
다른 형태의 파일로 덤프합니다.
%s 프로그램은 PostgreSQL 데이터베이스 클러스터를 SQL 스크립트 파일로
추출하는 프로그램입니다.
%s 프로그램은 pg_dump로 만들어진 자료파일로 PostgreSQL 데이터베이스에
그 자료를 일괄 입력합니다.
%s: %s 사용된 명령: %s
%s: WSAStartup 작업 실패: %d
%s: --single-transaction 및 여러 작업을 모두 지정할 수는 없음
%s: "%s" 데이터베이스에 접속할 수 없음
%s: "%s" 데이터베이스에 접속할 수 없음: %s
%s: "postgres" 또는 "template1" 데이터베이스에 연결할 수 없습니다.
다른 데이터베이스를 지정하십시오.
%s: 서버 버전을 알 수 없음
%s: 출력 파일 "%s"을(를) 열 수 없음: %s
%s: 데이터베이스 용 ACL 목록 (%s)을 분석할 수 없음, 해당개체: "%s"
%s: 테이블스페이스 용 ACL 목록 (%s)을 분석할 수 없음, 해당개체 "%s"
%s: "%s" 서버 버전을 분석할 수 없음
%s: 출력 파일 "%s"을(를) 다시 열 수 없음: %s
%s: "%s" 데이터베이스 덤프 중...
%s: %s 실행중
%s: 잘못된 병렬 작업 수
%s: 병렬 작업 최대수는 %d 입니다.
%s: --if-exists 옵션은 -c/--clean 옵션과 함께 사용해야 함
%s: -c/--clean 옵션과 -a/--data-only 옵션은 함께 사용할 수 없음
%s: -d/--dbname 및 -f/--file 옵션은 함께 사용할 수 없음
%s: -g/--globals-only 및 -r/--roles-only 옵션은 함께 사용할 수 없음
%s: -g/--globals-only 및 -t/--tablespaces-only 옵션은 함께 사용할 수 없음
%s: -r/--roles-only 및 -t/--tablespaces-only 옵션은 함께 사용할 수 없음
%s: -s/--schema-only 옵션과 -a/--data-only 옵션은 함께 사용할 수 없음
%s: "%s" 데이터베이스에서 pg_dump 작업 중에 오류가 발생, 끝냅니다.
%s: 쿼리 실패: %s %s: 사용한 쿼리: %s
%s: 롤 이름이 "pg_"로 시작함, 무시함: (%s)
%s: "%s" 가동중
%s: 너무 많은 명령행 인수들 (시작 "%s")
%s: 잘못된 섹션 이름: "%s"
(INSERT 명령으로는 OID 값을 입력할 수 없음.)
(시스템 카탈로그가 손상되었는 것 같습니다)
-C와 -1은 함께 사용할 수 없음
"%s" 테이블을 위한 COPY 실패: %s 이 문제를 피하려면, --data-only 덤프 대신에 모든 덤프를 사용하길 권합니다.
"%s" 테이블 내용을 덤프하면서 오류 발생: PQgetCopyData() 실패.
"%s" 테이블 내용을 덤프하면서 오류 발생: PQgetResult() 실패.
%d TOC 항목에서 오류발견; %u %u %s %s %s
서버에서 보낸 오류 메시지: %s 뒷 마무리 작업 중 오류:
초기화 작업 중 오류:
TOC 처리하는 중 오류:
이 서버는 exported snapshot를 지원하지 않음.
주의: 다음 데이블 간 참조키가 서로 교차하고 있음:
암호: 오류보고: <pgsql-bugs@postgresql.org>.
이 서버 버전에서는 동기화된 스냅샷 기능을 사용할 수 없음.
동기화된 스냅샷 기능이 필요 없다면, --no-synchronized-snapshots
옵션을 지정해서 덤프할 수 있습니다.
대기 서버에서는 동기화된 스냅샷 기능을 사용할 수 없음.
동기화된 스냅샷 기능이 필요 없다면, --no-synchronized-snapshots
옵션을 지정해서 덤프할 수 있습니다.
TOC Entry %s at %s (length %s, checksum %d)
사용된 명령: %s
"pg_dump" 프로그램이 %s 작업에서 필요로 하지만, "%s" 프로그램이
있는 같은 디렉터리에서 찾을 수 없습니다.
설치 상태를 살펴 보십시오.
"pg_dump" 프로그램이 "%s" 작업 때문에 찾았지만,
%s 버전과 서로 틀립니다.
설치 상태를 살펴 보십시오.
보다 자세한 사용법은 "%s --help"
사용법:
경고: %s 집계 함수는 이 데이터베이스 버전에서는 바르게 덤프되질 못했습니다; 무시함
경고: 아카이브는 압축되어있지만, 이 프로그램에서는 압축기능을 지원하지 못합니다 -- 이 안에 있는 자료를 모두 사용할 수 없습니다.
경고: 아카이브 아이템의 순서가 섹션에서 비정상적임
경고: 이 아카이브는 큰 정수를 지원하는 시스템에서 만들어졌습니다. 그래서 몇 동작이 실패할 수도 있습니다
경고: 잘못된 전송 정의, trffromsql 또는 trftosql 중 하나는 비어 있으면 안됨
경고: pg_cast.castfunc 또는 pg_cast.castmethod 필드에 잘못된 값이 있음
경고: pg_cast.castmethod 필드에 잘못된 값이 있음
경고: pg_transform.trffromsql 필드에 잘못된 값이 있음
경고: pg_transform.trftosql 필드에 잘못된 값이 있음
경고: proargmodes 배열에 잘못된 값이 있음
경고: %s OID의 연산자를 찾을 수 없음
경고: proallargtypes 배열을 분석할 수 없습니다
경고: proargmodes 배열을 분석할 수 없습니다
경고: proargnames 배열을 분석할 수 없습니다
경고: proconfig 배열을 구문 분석할 수 없음
경고: reloptions 배열을 분석할 수 없음
경고: 다음 항목 간 의존 관계를 분석할 수 없음:
경고: %s 개체의 소유주를 지정할 수 없습니다
경고: 복원작업에서의 오류들이 무시되었음: %d
경고: ftell 값과, 예상되는 위치값이 틀림 -- ftell 값이 사용됨
경고: 헤더에 잘못된 생성 날짜가 있음
경고: "%c" 잘못된 자료형, 해당 접근 방법: "%s"
경고: 줄 무시됨: %s
WARNING: "%s" 집계 함수의 소유주가 적당하지 않습니다.
경고: "%s" 자료형의 소유주가 적당하지 않습니다.
WARNING: "%s" 함수의 소유주가 적당하지 않습니다.
경고: "%s" 연산자의 소유주가 적당하지 않습니다.
WARNING: "%s" 연산자 클래스의 소유주가 적당하지 않습니다.
경고: "%s" 연산자 부류의 소유주가 적당하지 않습니다.
경고: "%s" 스키마의 소유주가 바르지 않습니다
WARNING: "%s" 테이블의 소유주가 적당하지 않습니다.
경고: 요청한 압축 기능은 이 설치판에서는 사용할 수 없습니다 -- 자료 파일은 압축 없이 만들어질 것입니다
경고: "%s" 자료형의 typtype가 잘못 되어 있음
경고: "%s" 테이블 COPY 작업 중 잘못된 부가 결과가 있음
--disable-triggers 옵션으로 복원할 수 있습니다. 또는 임시로 제약 조건을 삭제하고 복원하세요.
작업 프로세스가 예상치 않게 종료됨
서버 버전이 일치하지 않아 중단하는 중
실재 파일 길이(%s)와 예상되는 값(%s)이 틀립니다
%s 위한 AH를 할당하는 중, 포멧 %d
데이터베이스에 이미 접속해 있음
아카이버 덤프받을 DB 아카이브 포멧을 결정합니다
잘못된 dumpID
TABLE DATA 아이템에 대한 잘못된 테이블 dumpId
입력 아카이브만 다시 열 수 있음
null 포인터를 중복할 수 없음 (내부 오류)
압축된 자료파일을 복원용으로 사용할 수 없습니다(압축기능을 지원하지 않고 컴파일되었음)
하위 프로세스가 종료되었음, 종료 코드 %d 하위 프로세스가 종료되었음, 알수 없는 상태 %d 0x%X 예외처리로 하위 프로세스가 종료되었음 하위 프로세스가 종료되었음, 시그널 %d %s 시그널 감지로 하위 프로세스가 종료되었음 명령을 실행할 수 없음 해당 명령어 없음 compress_io tar 출력 포멧에서 압축 기능을 지원하지 않음
압축 수위는 0부터 9까지 지정할 수 있습니다.
압축기 사용
"%s" 데이터베이스를 "%s" 사용자로 접속합니다
리스토어 작업을 위해 데이터베이스에 접속합니다
"%s" 새 데이터베이스에 접속합니다
연결하려면 암호 필요
"%s" 데이터베이스에 접속 할 수 없음: %s %s 안에 손상된 tar 헤더 발견 (예상치 %d, 계산된 값 %d), 파일 위치 %s
"%s" 디렉터리로 바꿀 수 없음: %s TOC 파일을 닫을 수 없음: %s
자료 파일을 닫을 수 없음: %s
압축 라이브러리를 닫을 수 없음: %s
압축 스트림을 닫을 수 없음: %s
자료 파일을 닫을 수 없음: %s
"%s" 디렉터리를 닫을 수 없음: %s
입력 파일을 닫을 수 없음: %s
large object TOC 파일("%s")을 닫을 수 없음: %s
출력 파일을 닫을 수 없음: %s
tar 맴버를 닫지 못했습니다
임시 파일을 열 수 없음: %s
데이터베이스 트랜잭션을 commit 할 수 없음 자료를 압축할 수 없음: %s
통신 체널을 만들 수 없음: %s
"%s" 디렉터리를 만들 수 없음: %s
%u large object를 만들 수 없음: %s 작업자 프로세스를 만들 수 없음: %s
아카이브 파일에서 검색 위치를 확인할 수 없음: %s
쿼리를 실행 할 수 없음 실행 할 "%s" 파일을 찾을 수 없음 아카이브에서 블록 ID %d을(를) 찾을 수 없습니다. 아카이브가 손상된 것 같습니다.
아카이브에서 블록 ID %d을(를) 찾지 못했습니다. 복원 요청이 잘못된 것 같습니다. 아카이브의 데이터 오프셋이 부족하여 요청을 처리할 수 없습니다.
아카이브에서 블록 ID %d을(를) 찾지 못했습니다. 복원 요청이 잘못된 것 같습니다. 입력 파일을 검색할 수 없으므로 요청을 처리할 수 없습니다.
%d ID에 대한 항목을 찾지 못했음
아카이브에서 "%s" 파일을 찾을 수 없음
tar 아카이브에서 "%s" 파일을 위한 헤더를 찾을 수 없음
%s 객체와 관련된 상위 확장 기능을 찾을 수 없음
완료된 작업자의 슬롯을 찾을 수 없음
임시 파일 이름을 짓지 못했습니다: %s
libpq에서 server_verion 값을 구할 수 없음
현재 디렉터리를 알 수 없음: %s 의존 관계를 식별 할 수 없음
압축 라이브러리를 초기화 할 수 없음: %s
"%s" 릴레이션을 선점할 수 없음
이 상황은 일반적으로 다른 세션에서 해당 테이블을 이미 덤프하고 있거나 기타 다른 이유로 다른 세션에 의해서 선점 된 경우입니다.
입력용 TOC 파일("%s")을 열 수 없음: %s
출력용 TOC 파일 "%s"을(를) 열 수 없음: %s
TOC 파일 "%s"을(를) 열 수 없음: %s
입력용 TOC 파일을 열 수 없음: %s
출력용 TOC 파일을 열 수 없음: %s
"%s" 입력 파일을 열 수 없음: %s
입력 파일을 열 수 없음: %s
%u large object를 열 수 없음: %s 입력용 large object TOC 파일("%s")을 열 수 없음: %s
"%s" 출력 파일을 열 수 없음: %s
출력 파일을 열 수 없음: %s
임시 파일을 열 수 없음
GRANT ACL 목록 (%s) 또는 REVOKE ACL 목록 (%s) 분석할 수 없음, 해당 객체: "%s" (%s)
기본 ACL 목록 (%s)을 분석할 수 없음
GRANT ACL 목록 초기값 (%s) 또는 REVOKE ACL 목록 초기값 (%s) 분석할 수 없음, 해당 객체: "%s" (%s)
"%s" 숫자 배열을 분석할 수 없음: 숫자안에 이상한 글자가 있습니다
"%s" 숫자 배열을 분석할 수 없음: 너무 숫자가 있습니다
"%s" 바이너리 파일을 읽을 수 없음 "%s" 디렉터리를 읽을 수 없음: %s
입력 파일을 읽을 수 없음: %s
입력 파일을 읽을 수 없음: 파일 끝
입력 파일을 읽을 수 없음: %s
"%s" 심벌릭 링크를 읽을 수 없음 데이터베이스 재접속을 할 수 없음: %s default_tablespace로 %s(으)로 지정할 수 없음: %s default_with_oids 설정 할 수 없음: %s search_path를 "%s"(으)로 지정할 수 없음: %s 아카이브 파일에서 검색 위치를 설정할 수 없음: %s
"%s" 사용자로 세션 사용자를 지정할 수 없음: %s 데이터베이스 트랜잭션을 시작할 수 없음 자료 압축을 풀 수 없습니다: %s
blob TOC 파일에 쓸 수 없음
large object를 쓸 수 없음 (결과값: %lu, 예상값: %lu)
통신 체널에에 쓸 수 없음: %s
%s "%s" 만드는 중
%s "%s.%s" 만드는 중
custom 아카이버 "%s" 뷰의 정의 내용이 비어있습니다
파일 헤더에서 매직 문자열을 찾지 못했습니다
pre-1.3 archive에서 직통 데이터베이스 접속은 지원되지 않습니다
"%s" 디렉터리가 알맞은 아카이브용이 아님 ("toc.dat" 파일이 없음)
디렉터리 아카이버 디렉터리 이름이 너무 긺: "%s"
%s 자료 복원을 하면서 트리거 작동을 비활성화 합니다
%s %s 삭제하는 중
"%s.%s" 테이블의 내용 덤프 중
%s 트리거 작동을 활성화 합니다
기본 병렬 루프를 시작하는 중
restore_toc_entries_parallel을 시작하는 중
restore_toc_entries_postfork 시작하는 중
restore_toc_entries_prefork 시작 함
%d ID 항목은 범위를 벗어났음 -- TOC 정보가 손상된 듯 합니다
백업 중 오류
파일 seek 작업하는 도중 오류가 발생했습니다: %s
병렬 작업 아이템 처리 오류
%u large object 읽는 중 오류: %s large object TOC 파일("%s")을 닫을 수 없음
PQputCopyData에 의해서 오류가 반환되었음: %s PQputCopyEnd에 의해서 오류가 반환되었음: %s 실행중: %s %s
%d 제약 조건 확인이 "%s" 테이블에 필요한데 %d이(가) 있음
예상되는 포멧 (%d)와 발견된 파일 포멧 (%d)이 서로 틀립니다
안전 검사 실패, OID %u인 부모 개체가 없음. 해당 테이블 "%s" (OID %u)
의존성 검사 실패, 부모 테이블 OID %u 없음. 해당 pg_rewrite 개체 OID %u
데이터베이스 접속 실패
데이터베이스 재접속 실패
파일 이름이 너무 긺: "%s"
덤프 파일에서 파일 옵셋 값이 너무 큽니다
"%s.%s" 테이블에서 사용하는 체크 제약 조건을 찾는 중
"%s.%s" 테이블에서 default 표현들 찾는 중
확장 테이블을 찾는 중
상속 관계를 조사중
"%s.%s" 테이블의 칼럼과 자료형을 찾는 중
%d %s %s 항목 마침
기본 병렬 루프 마침
하위 테이블에서 상속된 열 구분중
자료를 읽는 동안 예상치 못한 ID (%d) 발견됨 -- 예상값 %d
"%s" 함수를 찾을 수 없음
확장 멤버를 식별 중
암시된 자료만 복원하기 - 아주 나쁜 번역
불완전한 tar 헤더가 있음(%lu바이트)
"%s" 인덱스를 찾을 수 없음
입력 파일은 일반 텍스트 덤프 파일입니다. psql 명령을 사용하세요.
입력 파일에서 타당한 아카이브를 찾을 수 없습니다
입력 파일에서 타당한 아카이브를 찾을 수 없습니다(너무 짧은지?)
입력 파일이 너무 짧습니다 (%lu 읽었음, 예상치 5)
내부 오류 -- WriteData가 DataDumper 루틴 영역 밖에서 호출 될 수 없습니다
내부 오류 - tarReadRaw()에서 th, fh 둘다 지정하지 않았음
잘못된 ENCODING 항목: %s
잘못된 large object용 OID
잘못된 large object OID: %u
잘못된 STDSTRINGS 항목: %s
적당하지 않는 adnum 값: %d, 해당 테이블 "%s"
잘못된 인수 문자열 (%s), 해당 트리거 "%s", 사용되는 테이블 "%s"
잘못된 바이너리 파일 "%s" 클라이언트 인코딩 값이 잘못되었습니다: "%s"
잘못된 열 번호 %d, 해당 테이블 "%s"
"%s" 테이블에 매겨져 있는 열 번호가 잘못되었습니다
잘못된 압축 수위: %d
잘못된 의존성 %d
잘못된 dumpId %d
large object TOC 파일("%s")을 닫을 수 없음: "%s"
작업 프로세스로부터 잘못된 메시지를 받음: "%s"
"%s" 값은 잘못된 출력 파일 형태입니다.
선택한 파일 형태로는 large-object를 덤프할 수 없습니다
마지막 내장 OID는 %u
%d %s %s 항목을 시작하는 중
"%s" 제약 조건을 위한 인덱스가 빠졌습니다
%s 위치에서 다음 맴버로 이동합니다, 해당 파일 위치 %s
준비된 항목이 없음
조건에 맞는 스키마가 없습니다
조건에 맞는 테이블이 없습니다
"%s" 검색 조건에 만족하는 테이블이 없습니다
자료가 저장될 디렉터리를 지정하지 않았음
zlib 지원 기능이 없음
새로 이동된 파일 위치: %s
--if-exists 옵션은 -c/--clean 옵션과 함께 사용해야 함
--inserts/--column-inserts 및 -o/--oids 옵션은 함께 사용할 수 없음
-c/--clean 및 -a/--data-only 옵션은 함께 사용할 수 없음
-s/--schema-only 및 -a/--data-only 옵션은 함께 사용할 수 없음
메모리 부족
on_exit_nicely 슬롯 범위 벗어남
병렬 아카이버 병렬 백업은 디렉터리 기반 출력일 때만 사용할 수 없습니다.
시작 위치를 임의로 지정할 수 없는 파일로는 병렬 복원 작업을 할 수 없습니다.
표준 입력을 이용한 병렬 복원 작업은 지원하지 않습니다
8.0 이전 pg_dump로 만든 아카이브에서는 병렬 복원이 지원되지 않음
이 아카이브 파일 형식에서는 병렬 복원이 지원되지 않음
pclose 실패: %s pgpipe: 접속을 승인할 수 없음: 오류 코드 %d
pgpipe: 바인딩 할 수 없음: 오류 코드 %d
pgpipe: 소켓 접속 실패: 오류 코드 %d
pgpipe: 두번째 소켓을 만들 수 없음: 오류 코드 %d
pgpipe: 소켓을 만들 수 없음: 오류 코드 %d
pgpipe: 리슨 할 수 없음: 오류 코드 %d
pgpipe: getsockname() 실패: 오류 코드 %d
%s 처리 중
"%s.%s" 테이블의 자료를 처리 중
%d %s %s 항목을 처리하는 중
누락된 항목 %d %s %s을(를) 처리하는 중
쿼리 실패: %s 쿼리가 참조테이블 정보가 없는 "%s" 참조키 트리거를 "%s" (해당 OID: %u) 테이블에서 만들었습니다.
쿼리에서 한 개가 아닌 %d개의 행을 반환: %s
"%s" 시퀀스의 데이터를 가져오기 위한 쿼리에서 %d개의 행 반환(1개 필요)
"%s" 시퀀스의 자료를 구하는 쿼리가 "%s" 이름을 리턴했음
"%s" 규칙("%s" 테이블)을(를) 가져오기 위한 쿼리 실패: 잘못된 행 수 반환
"%s" 뷰 정의 정보가 하나 이상 있습니다.
"%s" 뷰 정의 정보가 없습니다
사용한 쿼리: %s
%d TOC 항목 (%d ID) 읽기, 해당개체: %s %s
재미난 테이블들(interesting tables)을 위해 열 정보를 읽는 중
제약 조건들을 읽는 중
기본 접근 권한 읽는 중
의존 관계 자료 읽는 중
이벤트 트리거들을 읽는 중
확장 기능 읽는 중
"%s.%s" 테이블에서 사용하는 참조키 제약조건을 읽는 중
인덱스들을 읽는 중
"%s.%s" 테이블에서 사용하는 인덱스들을 읽는 중
large object 읽는 중
정책 읽는 중
"%s.%s" 테이블을 위한 정책 읽는 중
프로시쥬얼 언어를 읽는 중
룰(rule) 읽는 중
"%s.%s" 테이블을 위한 로우 보안 활성화를 읽는 중
스키마들을 읽는 중
테이블 상속 정보를 읽는 중
변환자(transform) 읽는 중
트리거들을 읽는 중
"%s.%s" 테이블에서 사용하는 트리거들을 읽는 중
형변환자(type cast)들을 읽는 중
사용자 정의 접근 방법을 읽는 중
사용자 정의 집계 함수를 읽는 중
사용자 정의 글자 정렬(collation) 읽는 중
사용자 정의 인코딩 변환규칙을 읽는 중
사용자 정의 외부 서버를 읽는 중
사용자 정의 외부 데이터 래퍼를 읽는 중
사용자 정의 함수들 읽는 중
사용자 정의 연산자 클래스를 읽는 중
사용자 정의 연산자 부류들 읽는 중
사용자 정의 연산자를 읽는 중
사용자 정의 테이블들을 읽는 중
사용자 정의 텍스트 검색 구성을 읽는 중
사용자 정의 텍스트 검색 사전을 읽는 중
사용자 정의 텍스트 검색 파서를 읽는 중
사용자 정의 텍스트 검색 템플릿을 읽는 중
사용자 정의 자료형을 읽는 중
%d에 대한 종속성을 줄이는 중
%d개의 큰 개체가 복원됨
순서를 넘어서는 자료 덤프 작업은 이 아카이브 포멧에서는 지원하지 않습니다: "%s" 요구되었지만, 이 아카이브 파일에서는 "%s" 전에 옵니다.
%u OID large object를 복원중
정수 크기 (%lu) 안전성 검사 실패
데이터베이스 구성정보를 저장중입니다
인코딩 = %s 저장중
large object들을 저장 중입니다
standard_conforming_strings = %s 저장함
"%s" 스키마를 찾을 수 없음
OID가 %u 인 스키마가 없습니다.
select() 실패: %s
스키마 선택 옵션을 사용하려면 서버 버전이 7.3 이상이어야합니다
서버 버전: %s; %s 버전: %s
%s "%s" 객체의 소유주와 접근 권한을 지정하는 중
%s "%s.%s" 객체의 소유주와 접근 권한을 지정하는 중
%d %s %s 항목을 건너뛰는 중
%s tar 맴버는 건너뜁니다
sorter "%s" 테이블을 만들 수 없어, 해당 자료는 복원되지 않을 것입니다
"%s" 테이블을 찾을 수 없음
tar 아카이버 이 파일 형태는 읽을 수 없음
%d -> %d - %d(으)로 종속성 변경 중
"%s" 트리거를 찾을 수 없음
COPY 구문 오류: "%s"
예상치 못한 자료 옵셋 플래그 %d
예상치 못한 정책 명령 형태: "%s"
예상치 못한 섹션 코드 %d
기대되지 않은 tgtype 값: %d
알 수 없는 아카이브 형식: "%s"; 사용할 수 있는 값: "c", "d", "t"
마스터에서 알 수 없는 명령을 받음: "%s"
알 수 없는 제약 조건 종류: %c
아카이브 복원하는 중에, 알 수 없는 자료 블럭 형태 %d 를 발견함
아카이브 검색하는 동안 알 수 없는 자료 블럭 형태(%d)를 발견함
알 수 없는 인코딩: "%s"
알 수 없는 파일 포멧: "%d"
기본 접근 권한에서 알 수 없는 객체형이 있음: %d
"%s" 함수의 proparallel 값이 잘못 되었습니다
"%s" 함수의 provolatile 값이 잘못 되었습니다
파일 헤더에 있는 %d.%d 버전은 지원되지 않습니다
원본 덤프 파일에서 발생한 경고: %s
작업자 프로세스 실패: 종료 코드 %d
%lu바이트의 큰 개체 데이터를 씀(결과 = %lu)
locale/ko/LC_MESSAGES/ecpg-9.6.mo 0000644 00000034245 14751153420 0012000 0 ustar 00 �� y � � � 8
~ 9
- �
0 �
7 + O g { � 4 s 8 . � G � 4 #
) X
w �
4 �
/ @ B = � , � ! � , . 1 [ * � - � 1 � ' & @ + g " � # � � ) � = J T & p < � ! � � - + . " Z } , � � � * " . ' Q y � ! � � ! � 3 ; / o ' � 5 � I � , G / t * � T � ' $ L g � � � - � , � , ! 5 N � ) � ? � 8
� C � 0 � 5 % [ A p L � + �
+ 6 9 ' p # � � ( � 4 � ) ' Q / n � � $ � � " , 8 e } ' � � � $ � D $ + i ? � 0 � 8 % ^ | & � � � � � z , ! 6 A! 6 x! 6 �! � �! w" 6 �" � �" 0 \# O �# : �# * $ � C$ 3 �$ % K -% 7 y% : �% # �% # & 8 4& 6 m& / �& 2 �& 6 ' , >' + k' 0 �' & �' 2 �' "( . +( M Z( �( �( A �( Y ) $ p) �) 7 �) 5 �) 0 * =* 2 ]* �* �* + �* 2 �* 1 (+ Z+ ) p+ 4 �+ ' �+ 0 �+ (, 9, ; Y, ; �, ' �, = �, Q 7- 2 �- @ �- : �- n 8. 1 �. $ �. �. / 5/ L/ * e/ ) �/ ) �/ 8 �/ 0 ' =0 B e0 4 �0 S �0 11 9 L1 F �1 �1 Z �1 T G2 ? �2 �2 O �2 2 =3 J p3
�3 / �3 8 �3 0 24 c4 P �4 " �4 1 �4 / )5 Y5 , z5 1 �5 �5 ( �5 * 6 + H6 + t6 ' �6 Q �6 3 7 G N7 ( �7 " �7 5 �7 8 " 88 ) [8 �8 Y * - < w ? " 9 M O = ^ 0 f y , P 2 l
t ) G v 5 x C : e F Z ] X % k J H ; [ U i d
E N $ a b T ! 6 D h ( & g p u A K W # 1 V n B I + o _ 8 s Q 4 / 7 S ` L c > \ m ' 3 @ q R j r .
If no output file is specified, the name is formed by adding .c to the
input file name, after stripping off .pgc if present.
Report bugs to <pgsql-bugs@postgresql.org>.
--regression run in regression testing mode
--version output version information, then exit
-?, --help show this help, then exit
-C MODE set compatibility mode; MODE can be one of
"INFORMIX", "INFORMIX_SE"
-D SYMBOL define SYMBOL
-I DIRECTORY search DIRECTORY for include files
-c automatically generate C code from embedded SQL code;
this affects EXEC SQL TYPE
-d generate parser debug output
-h parse a header file, this option includes option "-c"
-i parse system include files as well
-o OUTFILE write result to OUTFILE
-r OPTION specify run-time behavior; OPTION can be:
"no_indicator", "prepare", "questionmarks"
-t turn on autocommit of transactions
%s at or near "%s" %s is the PostgreSQL embedded SQL preprocessor for C programs.
%s, the PostgreSQL embedded C preprocessor, version %d.%d.%d
%s: could not locate my own executable path
%s: could not open file "%s": %s
%s: no input files specified
%s: parser debug support (-d) not available
AT option not allowed in CLOSE DATABASE statement AT option not allowed in CONNECT statement AT option not allowed in DISCONNECT statement AT option not allowed in SET CONNECTION statement AT option not allowed in TYPE statement AT option not allowed in VAR statement AT option not allowed in WHENEVER statement COPY FROM STDIN is not implemented CREATE TABLE AS cannot specify INTO ERROR: EXEC SQL INCLUDE ... search starts here:
Error: include path "%s/%s" is too long on line %d, skipping
Options:
SHOW ALL is not implemented Try "%s --help" for more information.
Unix-domain sockets only work on "localhost" but not on "%s" Usage:
%s [OPTION]... FILE...
WARNING: arrays of indicators are not allowed on input could not open include file "%s" on line %d could not remove output file "%s"
cursor "%s" does not exist cursor "%s" has been declared but not opened cursor "%s" is already defined descriptor "%s" does not exist descriptor header item "%d" does not exist descriptor item "%s" cannot be set descriptor item "%s" is not implemented end of search list
expected "://", found "%s" expected "@" or "://", found "%s" expected "@", found "%s" expected "postgresql", found "%s" incomplete statement incorrectly formed variable "%s" indicator for array/pointer has to be array/pointer indicator for simple data type has to be simple indicator for struct has to be a struct indicator variable "%s" is hidden by a local variable indicator variable "%s" is hidden by a local variable of a different type indicator variable must have an integer type initializer not allowed in EXEC SQL VAR command initializer not allowed in type definition internal error: unreachable state; please report this to <pgsql-bugs@postgresql.org> interval specification not allowed here invalid bit string literal invalid connection type: %s invalid data type key_member is always 0 missing "EXEC SQL ENDIF;" missing identifier in EXEC SQL DEFINE command missing identifier in EXEC SQL IFDEF command missing identifier in EXEC SQL UNDEF command missing matching "EXEC SQL IFDEF" / "EXEC SQL IFNDEF" more than one EXEC SQL ELSE multidimensional arrays are not supported multidimensional arrays for simple data types are not supported multidimensional arrays for structures are not supported multilevel pointers (more than 2 levels) are not supported; found %d level multilevel pointers (more than 2 levels) are not supported; found %d levels nested /* ... */ comments nested arrays are not supported (except strings) no longer supported LIMIT #,# syntax passed to server nullable is always 1 only data types numeric and decimal have precision/scale argument only protocols "tcp" and "unix" and database type "postgresql" are supported operator not allowed in variable definition out of memory pointer to pointer is not supported for this data type pointers to varchar are not implemented subquery in FROM must have an alias syntax error syntax error in EXEC SQL INCLUDE command too many levels in nested structure/union definition too many nested EXEC SQL IFDEF conditions type "%s" is already defined type name "string" is reserved in Informix mode unmatched EXEC SQL ENDIF unrecognized data type name "%s" unrecognized descriptor item code %d unrecognized token "%s" unrecognized variable type code %d unsupported feature will be passed to server unterminated /* comment unterminated bit string literal unterminated hexadecimal string literal unterminated quoted identifier unterminated quoted string using unsupported DESCRIBE statement using variable "%s" in different declare statements is not supported variable "%s" is hidden by a local variable variable "%s" is hidden by a local variable of a different type variable "%s" is neither a structure nor a union variable "%s" is not a pointer variable "%s" is not a pointer to a structure or a union variable "%s" is not an array variable "%s" is not declared variable "%s" must have a numeric type zero-length delimited identifier Project-Id-Version: PostgreSQL 9.6
Report-Msgid-Bugs-To: pgsql-bugs@postgresql.org
POT-Creation-Date: 2016-09-26 14:02+0900
PO-Revision-Date: 2016-09-26 15:33+0900
Last-Translator: Ioseph Kim <ioseph@uri.sarang.net>
Language-Team: Korean Team <pgsql-kr@postgresql.kr>
Language: ko
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Plural-Forms: nplurals=1; plural=0;
출력 파일 이름을 지정하지 않으면 입력 파일 이름에 .pgc가 있을 경우 제거하고
.c를 추가하여 이름이 지정됩니다.
오류보고: <pgsql-bugs@postgresql.org>.
--regression 회귀 테스트 모드에서 실행
--version 버전 정보를 출력하고 종료
-?, --help 이 도움말을 보여주고 마침
-C MODE 호환성 모드를 설정합니다. MODE는 다음 중 하나일 수 있습니다.
"INFORMIX", "INFORMIX_SE"
-D SYMBOL SYMBOL 정의
-I DIRECTORY DIRECTORY에서 포함 파일 검색
-c 포함된 SQL 코드에서 자동으로 C 코드를 생성합니다.
EXEC SQL TYPE에 영향을 줍니다.
-d 파서 디버그 출력 생성
-h 헤더 파일 구문 분석. 이 옵션은 "-c" 옵션 포함
-i 시스템 포함 파일도 구문 분석
-o OUTFILE OUTFILE에 결과 쓰기
-r OPTION 런타임 동작을 지정합니다. 사용 가능한 OPTION은 다음과 같습니다.
"no_indicator", "prepare", "questionmarks"
-t 트랜잭션 자동 커밋 설정
%s, "%s" 부근 %s은(는) C 프로그램용 PostgreSQL 포함 SQL 전처리기입니다.
PostgreSQL 포함 C 전처리기 %s의 버전 %d.%d.%d
%s: 실행 가능한 경로를 지정할 수 없습니다
%s: "%s" 파일 열 수 없음: %s
%s: 지정된 입력 파일 없음
%s: 파서 디버그 지원(-d)을 사용할 수 없음
CLOSE DATABASE 문에 AT 옵션이 허용되지 않음 CONNECT 문에 AT 옵션이 허용되지 않음 DISCONNECT 문에 AT 옵션이 허용되지 않음 SET CONNECTION 문에 AT 옵션이 허용되지 않음 TYPE 문에 AT 옵션이 허용되지 않음 VAR 문에 AT 옵션이 허용되지 않음 WHENEVER 문에 AT 옵션이 허용되지 않음 COPY FROM STDIN이 구현되지 않음 CREATE TABLE AS에서 INTO를 지정할 수 없음 오류: EXEC SQL INCLUDE ... 여기서 검색 시작:
오류: 포함 경로 "%s/%s"이(가) %d줄에서 너무 길어서 건너뜀
옵션들:
SHOW ALL이 구현되지 않음 자제한 사항은 "%s --help" 명령으로 살펴보십시오.
Unix-domain 소켓은 "localhost"에서만 작동하며 "%s"에서는 작동하지 않음 사용:
%s [OPTION]... 파일...
경고: 입력에서 표시기의 배열이 허용되지 않음 포함 파일 "%s"을(를) %d줄에서 열 수 없음 출력 파일 "%s"을(를) 제거할 수 없음
"%s" 이름의 커서가 없음 "%s" 커서가 선언되었지만 열리지 않음 "%s" 커서가 이미 정의됨 "%s" 설명자가 없음 설명자 헤더 항목 "%d"이(가) 없음 설명자 항목 "%s"을(를) 설정할 수 없음 설명자 항목 "%s"이(가) 구현되지 않음 검색 목록의 끝
"://"가 필요한데 "%s"이(가) 있음 "@" 또는 "://"가 필요한데 "%s"이(가) 있음 "@"이 필요한데 "%s"이(가) 있음 "postgresql"이 필요한데 "%s"이(가) 있음 불완전한 문 잘못된 형식의 변수 "%s" 배열/포인터의 표시기는 배열/포인터여야 함 단순 데이터 형식의 표시기는 단순이어야 함 구조의 표시기는 구조여야 함 "%s" 지시자 변수가 지역 변수에 의해 숨겨졌음 "%s" 지시자 변수가 지역 변수의 다른 자료형 때문에 숨겨졌음 표시기 변수에 정수 형식이 있어야 함 EXEC SQL VAR 명령에 이니셜라이저가 허용되지 않음 형식 정의에 이니셜라이저가 허용되지 않음 내부 오류: 연결할 수 없습니다. 이 문제를 <pgsql-bugs@postgresql.org>로 알려주십시오. 여기에는 간격 지정이 허용되지 않음 잘못된 비트 문자열 리터럴 잘못된 연결 형식: %s 잘못된 데이터 형식 key_member는 항상 0 "EXEC SQL ENDIF;" 누락 EXEC SQL DEFINE 명령에 식별자 누락 EXEC SQL IFDEF 명령에 식별자 누락 EXEC SQL UNDEF 명령에 식별자 누락 일치하는 "EXEC SQL IFDEF" / "EXEC SQL IFNDEF" 누락 두 개 이상의 EXEC SQL ELSE 다차원 배열이 지원되지 않음 단순 데이터 형식에 다차원 배열이 지원되지 않음 구조에는 다차원 배열이 지원되지 않음 다중단계 포인터(2단계 이상)는 지원하지 않음; 발견된 레벨: %d 중첩된 /* ... */ 주석 중첩된 배열은 지원되지 않음(문자열 제외) 더 이상 지원되지 않는 LIMIT #,# 구문이 서버에 전달됨 null 허용 여부는 항상 1 숫자 및 10진수 데이터 형식에만 전체 자릿수/소수 자릿수 인수 포함 "tcp" 및 "unix" 프로토콜과 데이터베이스 형식 "postgresql"만 지원됨 연산자는 동적 정의 영역에서는 사용할 수 없음 메모리 부족 이 데이터 형식에는 포인터에 대한 포인터가 지원되지 않음 varchar에 대한 포인터가 구현되지 않음 FROM 절 내의 subquery 에는 반드시 alias 를 가져야만 합니다 구문 오류 EXEC SQL INCLUDE 명령에 구문 오류 발생 중첩된 구조/union 정의에 수준이 너무 많음 중첩된 EXEC SQL IFDEF 조건이 너무 많음 "%s" 형식이 이미 정의됨 "string" 자료형 이름은 인포믹스 모드에서 예약어로 쓰입니다 일치하지 않는 EXEC SQL ENDIF 인식할 수 없는 데이터 형식 이름 "%s" 인식할 수 없는 설명자 항목 코드 %d 인식할 수 없는 토큰 "%s" 인식할 수 없는 변수 형식 코드 %d 지원되지 않는 기능이 서버에 전달됨 마무리 안된 /* 주석 마무리 안된 비트 문자열 문자 마무리 안된 16진수 문자열 문자 마무리 안된 따옴표 안의 식별자 마무리 안된 따옴표 안의 문자열 지원되지 않는 DESCRIBE 문 사용 서로 다른 선언 구문에서 "%s" 변수 사용은 지원하지 않습니다 "%s" 변수가 지역 변수에 의해 숨겨졌음 "%s" 변수가 다른 자료형의 지역 변수에 의해 숨겨졌음 "%s" 변수가 구조나 union이 아님 "%s" 변수가 포인터가 아님 "%s" 변수가 구조나 union의 포인터가 아님 "%s" 변수가 배열이 아님 "%s" 변수가 선언되지 않음 "%s" 변수는 숫자 형식이어야 함 길이가 0인 구분 식별자 locale/ko/LC_MESSAGES/pg_rewind-9.6.mo 0000644 00000047535 14751153420 0013046 0 ustar 00 �� � �
�
- �
1 �
? �
K 9 C � ; � C 9 I G � @ � O h � � � � � J � > 9 , x 6 � < � 1 ? K = � = � 9 4 A 9 v 4 � 2 � @ R Y > � � � 1 E W a { o � d - j 4 � & � � � P � R � c 5 - � � � / ; 4 p � # � � % � $ / + T $ � � $ � L � , 5 0 b " � ) � , �
$ + $ P # u ' � " � � " & % $ L q ( � � " � ' � & C b 2 � � ' � / 0 - ` � 6 � � ; � ) 4 ^ + { % � � � ! ! 3 "! 6 V! 1 �! �! ' �! < " _ C" �" �" ! �" F �" /# F# `# 1 z# C �# " �# . $ # B$ > f$ 6 �$ 3 �$ 6 % 0 G% x% + �% & �% �% & ! && ( H& I q& $ �& ' �& ' - %' J S' = �' A �' 6 ( 5 U( 5 �( ! �( 7 �( / ) 6 K) 1 �) - �) 9 �) z * , �+ < �+ B , W D, C �, F �, L '- F t- F �- P . S. s `. �. �. / 0/ K/ ^/ r g/ L �/ 3 '0 = [0 Q �0 = �0 D )1 R n1 j �1 \ ,2 H �2 R �2 = %3 R c3 V �3 p
4 ] ~4 �4 ( �4 7 5 F5 Y5 e5 �5 � �5 � ,6 7 �6 > 7 A E7 �7 w �7 z 8 | �8 � 9 ? �9 & �9 - : 6 0: G g: �: ' �: + �: % ; , ?; l; + �; 9 �; ) �; ) < . ?< N n< = �< A �< % == 3 c= 9 �= " �= ) �= ) > 6 H> : > + �> % �> % ? 6 2? / i? ( �? 3 �? 1 �? 6 (@ ; _@ $ �@ �@ & �@ A = (A / fA 5 �A �A . �A / B $ JB C oB �B F �B 3 C # NC 3 rC , �C �C , �C * D 9 FD < �D = �D ! �D , E S JE r �E F *F 0 <F P mF # �F �F G 6 $G E [G 5 �G A �G ( H P BH - �H 8 �H S �H E NI " �I 3 �I 1 �I % J , CJ * pJ , �J � �J . KK / zK �K = �K X L H ^L P �L = �L H 6M @ M " �M K �M 0 /N E `N < �N : �N > O � % 4 � X { � � � Z � q o � L I | � � $ ; c T � 0 z x 9 � t - h E
e Q 5 � a � 7 j H ' k ^ p � � � ? 8 � s C " � � / # 2 � � � _ O g w � } ( � \
A v K D = f 1 ` P b r � . l > � : � R W u S * d y ] J � G M F 3 N i < � � Y & n + V , � � B @ ~ U [ ! ) 6 m �
Report bugs to <pgsql-bugs@postgresql.org>.
creating backup label and updating control file
--debug write a lot of debug messages
--source-pgdata=DIRECTORY source data directory to synchronize with
--source-server=CONNSTR source server to synchronize with
-?, --help show this help, then exit
-D, --target-pgdata=DIRECTORY existing data directory to modify
-P, --progress write progress messages
-V, --version output version information, then exit
-n, --dry-run stop before modifying anything
block %u
"%s" is a symbolic link, but symbolic links are not supported on this platform
"%s" is not a directory
"%s" is not a regular file
"%s" is not a symbolic link
%*s/%s kB (%d%%) copied %d: %X/%X - %X/%X
%s (%s)
%s resynchronizes a PostgreSQL cluster with another copy of the cluster.
%s: WARNING: cannot create restricted tokens on this platform
%s: could not allocate SIDs: error code %lu
%s: could not create restricted token: error code %lu
%s: could not get exit code from subprocess: error code %lu
%s: could not open process token: error code %lu
%s: could not re-execute with restricted token: error code %lu
%s: could not start process for command "%s": error code %lu
%s: no source specified (--source-pgdata or --source-server)
%s: no target data directory specified (--target-pgdata)
%s: too many command-line arguments (first is "%s")
BKPBLOCK_HAS_DATA not set, but data length is %u at %X/%X BKPBLOCK_HAS_DATA set, but no data included at %X/%X BKPBLOCK_SAME_REL set but no previous rel at %X/%X BKPIMAGE_HAS_HOLE not set, but hole offset %u length %u at %X/%X BKPIMAGE_HAS_HOLE set, but hole offset %u length %u block image length %u at %X/%X BKPIMAGE_IS_COMPRESSED set, but block image length %u at %X/%X Done!
Expected a numeric timeline ID.
Expected a transaction log switchpoint location.
Failure, exiting
Options:
Source timeline history:
Target timeline history:
The program "initdb" is needed by %s but was
not found in the same directory as "%s".
Check your installation.
The program "initdb" was found by "%s"
but was not the same version as %s.
Check your installation.
Timeline IDs must be in increasing sequence.
Timeline IDs must be less than child timeline's ID.
Try "%s --help" for more information.
Usage:
%s [OPTION]...
WAL file is from different database system: WAL file database system identifier is %s, pg_control database system identifier is %s WAL file is from different database system: incorrect XLOG_BLCKSZ in page header WAL file is from different database system: incorrect XLOG_SEG_SIZE in page header WAL record modifies a relation, but record type is not recognized
lsn: %X/%X, rmgr: %s, info: %02X
You must run %s as the PostgreSQL superuser.
backup label buffer too small
cannot be executed by "root"
cannot duplicate null pointer (internal error)
clusters are not compatible with this version of pg_rewind
connected to server
contrecord is requested by %X/%X could not close directory "%s": %s
could not close file "%s": %s
could not close target file "%s": %s
could not connect to server: %s could not create directory "%s": %s
could not create symbolic link at "%s": %s
could not create temporary table: %s could not fetch file list: %s could not fetch remote file "%s": %s could not find common ancestor of the source and target cluster's timelines
could not find previous WAL record at %X/%X
could not find previous WAL record at %X/%X: %s
could not open directory "%s": %s
could not open file "%s" for reading: %s
could not open file "%s" for truncation: %s
could not open file "%s": %s
could not open source file "%s": %s
could not open target file "%s": %s
could not read WAL record at %X/%X
could not read WAL record at %X/%X: %s
could not read directory "%s": %s
could not read file "%s": %s
could not read from file "%s": %s
could not read symbolic link "%s": %s
could not remove directory "%s": %s
could not remove file "%s": %s
could not remove symbolic link "%s": %s
could not seek in file "%s": %s
could not seek in source file: %s
could not seek in target file "%s": %s
could not send COPY data: %s could not send end-of-COPY: %s could not send file list: %s could not send query: %s could not set libpq connection to single row mode
could not stat file "%s": %s
could not truncate file "%s" to %u: %s
could not write file "%s": %s
data file "%s" in source is not a regular file
error running query (%s) in source server: %s fetched file "%s", length %d
full_page_writes must be enabled in the source server
getting file chunks
incorrect resource manager data checksum in record at %X/%X invalid action (CREATE) for regular file
invalid block_id %u at %X/%X invalid compressed image at %X/%X, block %d invalid contrecord length %u at %X/%X invalid control file invalid data in history file
invalid data in history file: %s
invalid info bits %04X in log segment %s, offset %u invalid magic number %04X in log segment %s, offset %u invalid record length at %X/%X: wanted %u, got %u invalid record offset at %X/%X invalid resource manager ID %u at %X/%X need to copy %lu MB (total source directory size is %lu MB)
neither BKPIMAGE_HAS_HOLE nor BKPIMAGE_IS_COMPRESSED set, but block image length is %u at %X/%X no rewind required
out of memory
out-of-order block_id %u at %X/%X out-of-sequence timeline ID %u (after %u) in log segment %s, offset %u reading WAL in target
reading source file list
reading target file list
received chunk for file "%s", offset %d, size %d
received null value for chunk for file "%s", file has been deleted
record length %u at %X/%X too long record with incorrect prev-link %X/%X at %X/%X record with invalid length at %X/%X rewinding from last common checkpoint at %X/%X on timeline %u
servers diverged at WAL position %X/%X on timeline %u
source and target cluster are on the same timeline
source and target clusters are from different systems
source data directory must be shut down cleanly
source file list is empty
source server must not be in recovery mode
symbolic link "%s" target is too long
sync of target directory failed
syncing target data directory
syntax error in history file: %s
target server must be shut down cleanly
target server needs to use either data checksums or "wal_log_hints = on"
there is no contrecord flag at %X/%X unexpected EOF while reading file "%s"
unexpected control file CRC
unexpected control file size %d, expected %d
unexpected data types in result set while fetching remote files: %u %u %u
unexpected null values in result while fetching remote files
unexpected page modification for directory or symbolic link "%s"
unexpected pageaddr %X/%X in log segment %s, offset %u unexpected result format while fetching remote files
unexpected result length while fetching remote files
unexpected result set from query
unexpected result set size while fetching remote files
unexpected result set while fetching file list
unexpected result set while fetching remote file "%s"
unexpected result while fetching remote files: %s unexpected result while sending file list: %s unrecognized result "%s" for current WAL insert location
Project-Id-Version: pg_rewind (PostgreSQL) 9.6
Report-Msgid-Bugs-To: pgsql-bugs@postgresql.org
POT-Creation-Date: 2016-09-26 14:02+0900
PO-Revision-Date: 2016-09-26 18:50+0900
Last-Translator: Ioseph Kim <ioseph@uri.sarang.net>
Language-Team: Korean <pgsql-kr@postgresql.kr>
Language: ko
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
오류보고: <pgsql-bugs@postgresql.org>.
백업 라벨을 만들고, 컨트롤 파일을 갱신 중
--debug 디버그 메시지를 보여줌
--source-pgdata=디렉터리 동기화 원본이 되는 데이터 디렉터리
--source-server=연결문자열 원본 서버 접속 정보
-?, --help 이 도움말을 보여주고 마침
-D, --target-pgdata=디렉터리 변경하려는 데이터 디렉터리
-P, --progress 진행 과정 메시지를 보여줌
-V, --version 버전 정보를 보여주고 마침
-n, --dry-run 변경 작업 전에 멈춤(검사, 확인용)
블록 %u
"%s" 파일은 심볼릭 링크 파일이지만 이 운영체제는 심볼릭 링크 파일을 지원하지 않음
"%s" 디렉터리가 아님
"%s" 일반 파일이 아님
"%s" 심볼릭 링크가 아님
%*s/%s kB (%d%%) 복사됨 %d: %X/%X - %X/%X
%s (%s)
%s 프로그램은 PostgreSQL 한 클러스터에서 다른 클러스터로 재동기화 하는 도구입니다.
%s: 경고: restricted token을 이 운영체제에서는 만들 수 없음
%s: SID를 할당할 수 없음: 오류 코드 %lu
%s: restricted token을 만들 수 없음: 오류 코드 %lu
%s: 하위 프로세스의 종료 코드를 구할 수 없음: 오류 코드 %lu
%s: 프로세스 토큰을 열 수 없음: 오류 코드 %lu
%s: restricted token을 재실행 할 수 없음: 오류 코드 %lu
%s: "%s" 명령을 위한 프로세스를 시작할 수 없음: 오류 코드 %lu
%s: 원본을 지정하지 않았음 (--source-pgdata 또는 --source-server 옵션을 지정 해야 함)
%s: 대상 데이터 디렉토리가 지정되지 않았음 (--target-pgdata 옵션 사용)
%s: 너무 많은 명령행 인수를 지정했습니다. (처음 "%s")
BKPBLOCK_HAS_DATA 지정 않았지만, %u 길이의 자료가 있음, 위치 %X/%X BKPBLOCK_HAS_DATA 지정했지만, %X/%X 에 자료가 없음 BKPBLOCK_SAME_REL 설정이 되어 있지만, %X/%X 에 이전 릴레이션 없음 BKPIMAGE_HAS_HOLE 설정이 안되어 있지만, 옵셋: %u, 길이: %u, 대상: %X/%X BKPIMAGE_HAS_HOLE 설정이 되어 있지만, 옵셋: %u, 길이: %u, 블록 이미지 길이: %u, 대상: %X/%X BKPIMAGE_IS_COMPRESSED 설정이 되어 있지만, 블록 이미지 길이: %u, 대상: %X/%X 완료!
타임라인 ID 값은 숫자여야 함
트랜잭션 로그 전환 위치 값이 있어야 함
실패, 종료함
옵션들:
원본 타임라인 내역:
대상 타임라인 내역:
%s 프로그램은 "initdb" 프로그램이 필요하지만
"%s" 디렉터리 안에 없습니다.
설치 상태를 확인해 주십시오.
"%s" 프로그램은 "initdb" 프로그램이 필요해서 찾았지만 이 파일은
%s 버전과 같지 않습니다.
설치 상태를 확인해 주십시오.
타임라인 ID은 순차적인 증가값이어야 함
타임라인 ID는 하위 타임라인 ID보다 적어야 함
자제한 사항은 "%s --help" 명령으로 살펴보십시오.
사용법:
%s [옵션]...
WAL 파일이 다른 시스템의 것입니다. WAL 파일의 시스템 식별자는 %s, pg_control 의 식별자는 %s WAL 파일이 다른 데이터베이스 시스템의 것입니다: 페이지 헤더의 XLOG_BLCKSZ 값이 바르지 않음 WAL 파일이 다른 데이터베이스 시스템의 것입니다: 페이지 헤더의 XLOG_SEG_SIZE 값이 바르지 않음 WAL 레코드가 릴레이션을 변경하려고 하지만, 레코드 형태가 올바르지 않음
lsn: %X/%X, rmgr: %s, info: %02X
PostgreSQL superuser로 %s 프로그램을 실행하십시오.
백업 라벨 버퍼가 너무 작음
"root" 계정으로는 실행 할 수 없음
null 포인터를 복제할 수 없음(내부 오류)
해당 클러스터는 이 pg_rewind 버전으로 작업할 수 없음
서버 접속 완료
%X/%X에서 contrecord를 필요로 함 "%s" 디렉터리를 닫을 수 없음: %s
"%s" 파일을 닫을 수 없음: %s
"%s" 대상 파일을 닫을 수 없음: %s
서버 접속 실패: %s "%s" 디렉터리를 만들 수 없음: %s
"%s"에 대한 심볼릭 링크를 만들 수 없음: %s
임시 테이블을 만들 수 없음: %s 파일 목록을 가져올 수 없음: %s "%s" 원격 파일을 가져올 수 없음: %s 원본과 대상 서버의 공통된 상위 타임라인을 찾을 수 없음
%X/%X 위치에서 이전 WAL 레코드를 찾을 수 없음
%X/%X 위치에서 이전 WAL 레코드를 찾을 수 없음: %s
"%s" 디렉터리 열 수 없음: %s
읽기를 위한 "%s" 파일을 열 수 없음: %s
트랙잭션을 위한 "%s" 파일을 열 수 없음: %s
"%s" 파일을 열 수 없음: %s
"%s" 원본 파일을 열 수 없음: %s
"%s" 대상 파일을 열 수 없음: %s
%X/%X 위치에서 WAL 레코드를 읽을 수 없음
%X/%X 위치에서 WAL 레코드를 읽을 수 없음: %s
"%s" 디렉터리를 읽을 수 없음: %s
"%s" 파일을 읽을 수 없음: %s
"%s" 파일을 읽을 수 없음: %s
"%s" 심볼릭 링크 파일을 읽을 수 없음: %s
"%s" 디렉터리를 삭제 할 수 없음: %s
"%s" 파일을 삭제할 수 없음: %s
"%s" 심볼릭 링크를 삭제 할 수 없음: %s
"%s" 파일의 seek 작업을 할 수 없음: %s
원본 파일에서 seek 작업을 할 수 없음: %s
"%s" 대상 파일에서 seek 작업을 할 수 없음: %s
COPY 자료를 보낼 수 없음: %s COPY끝을 보낼 수 없음: %s 파일 목록을 보낼 수 없음: %s 쿼리를 보낼 수 없음: %s libpq 연결을 단일 로우 모드로 지정할 수 없음
"%s" 파일의 상태값을 알 수 없음: %s
"%s" 파일을 %u 크기로 정리할 수 없음: %s
"%s" 파일 쓰기 실패: %s
"%s" 원본 파일은 일반 파일이 아님
원본에서에서 쿼리(%s) 실행 오류: %s "%s" 파일을 가져옴, 길이 %d
원본 서버는 full_page_writes 옵션으로 운영되어야 함
파일 청크 가져오는 중
잘못된 자원관리자 데이터 체크섬, 위치: %X/%X 레코드 일반 파일에 대한 잘못 된 작업 (CREATE)
잘못된 block_id %u, 위치 %X/%X 잘못된 압축 이미지, 위치 %X/%X, 블록 %d 잘못된 contrecord 길이 %u, 위치 %X/%X 잘못된 컨트롤 파일 내역 파일에 잘못된 자료가 있음
내역 파일 안에 잘못된 자료: %s
잘못된 정보 비트 %04X, 로그 파일 %s, 위치 %u %04X 매직 번호가 잘못됨, 로그 파일 %s, 위치 %u 잘못된 레코드 길이: %X/%X, 기대값 %u, 실재값 %u 잘못된 레코드 위치: %X/%X 잘못된 자원 관리 ID %u, 위치: %X/%X 복사를 위해서 %lu MB 필요함 (원본 디렉토리 전체 크기는 %lu MB)
BKPIMAGE_HAS_HOLE, BKPIMAGE_IS_COMPRESSED 지정 안되어 있으나, 블록 이미지 길이는 %u, 대상: %X/%X 되감을 필요 없음
메모리 부족
%u block_id는 범위를 벗어남, 위치 %X/%X 타임라인 범위 벗어남 %u (이전 번호 %u), 로그 파일 %s, 위치 %u 대상 서버에서 WAL 읽는 중
원본 파일 목록 읽는 중
대상 파일 목록 읽는 중
"%s" 파일의 청크를 받음, 옵셋 %d, 크기 %d
"%s" 파일을 위한 청크에 null 값을 받음, 파일 지워짐
너무 긴 길이(%u)의 레코드가 %X/%X에 있음 레코드의 잘못된 프리링크 %X/%X, 해당 레코드 %X/%X 잘못된 레코드 길이, 위치 %X/%X 재동기화 시작함, 마지막 체크포인트 위치 %X/%X, 타임라인 %u
서버 분기 위치: %X/%X, 타임라인 %u
원본과 대상 클러스터의 타임라인이 같음
원본과 대상 클러스터의 데이터 클러스터의 식별 번호가 다름
원본 데이터 디렉토리는 정상적으로 종료되어야 함
원본 파일 목록이 비었음
원본 서버는 복구 모드가 아니여야 함
"%s" 심볼릭 링크의 대상이 너무 길음
대상 디렉터리 동기화 실패
대상 데이터 디렉터리 동기화 중
내역 파일 내용의 구문 오류: %s
대상 서버는 정상 종료되어야 함
대상 서버의 데이터 클러스터가 데이터 체크섬 기능을 켰거나, "wal_log_hints = on" 설정이 되어야 함
%X/%X 위치에 contrecord 플래그가 없음 "%s" 파일을 읽는 중 예상치 못한 EOF
컨트롤 파일 CRC 오류
컨트롤 파일의 크기가 %d 로 비정상, 정상값 %d
원격 파일을 가져오는 도중 결과 집합의 자료형이 잘못 됨: %u %u %u
원격 파일을 가져오는 도중 결과안에 null 값이 잘못됨
디텍터리나 심볼릭 링크 "%s" 의 페이지 변경 정보가 잘못 됨
잘못된 페이지 주소 %X/%X, 로그 파일 %s, 위치 %u 원격 파일을 가져오는 중 예상치 못한 결과 형식 발견
원격 파일을 가져오는 도중 결과 길이가 잘못됨
쿼리 결과가 바르지 않음
원격 파일을 가져오는 도중 결과 집합의 크기가 잘못 됨
파일 목록을 가져온 결과가 잘못 됨
"%s" 원격파일을 가져오는 도중 결과 집합이 잘못 됨
원격 파일을 가져오는 도중 결과가 잘못됨: %s 파일 목록을 보내는 도중 결과가 잘못 됨: %s 현재 WAL 삽입 위치를 위한 결과가 잘못됨 : "%s"
locale/ko/LC_MESSAGES/ecpglib6-9.6.mo 0000644 00000007231 14751153420 0012550 0 ustar 00 �� ! $ / , � � � � ) ' - Q : 0 � $ � ( 9 L * c ; � > � 3 < = & z 1 � � + � ' @ % Y � , � � 2 0 ; / l x � ! ) . K $ [ > � 7 � @ � 1 8
3 j
�
�
- �
P �
F O ; � D � ; ? S � . � ( �
(
# =
# a
= �
+ �
0 �
. I O
! <DEFAULT> <empty> NULL SQL error %d on line %d SQL error: %s
connection "%s" does not exist on line %d could not connect to database "%s" on line %d could not convert boolean value: size mismatch, on line %d data read from server is not an array on line %d descriptor "%s" not found on line %d descriptor index out of range on line %d empty message text empty query on line %d error in transaction processing on line %d inserting an array of variables is not supported on line %d invalid input syntax for floating-point type: "%s", on line %d invalid input syntax for type int: "%s", on line %d invalid input syntax for type unsigned int: "%s", on line %d invalid statement name "%s" on line %d invalid syntax for type boolean: "%s", on line %d no data found on line %d not connected to connection "%s" on line %d null value without indicator on line %d out of memory on line %d the connection to the server was lost too few arguments on line %d too many arguments on line %d unrecognized descriptor item "%s" on line %d unsupported type "%s" on line %d variable does not have a character type on line %d variable does not have a numeric type on line %d variable does not have an array type on line %d Project-Id-Version: ecpglib (PostgreSQL) 9.6
Report-Msgid-Bugs-To: pgsql-bugs@postgresql.org
POT-Creation-Date: 2016-09-26 14:02+0900
PO-Revision-Date: 2016-09-26 15:37+0900
Last-Translator: Ioseph Kim <ioseph@uri.sarang.net>
Language-Team: Korean <pgsql-kr@postgresql.kr>
Language: ko
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
<초기값> <empty> NULL SQL 오류 %d: %d 번째 줄 SQL 오류: %s
"%s" 연결이 없음: %d 번째 줄 "%s" 데이터베이스로 접속할 수 없음: %d 번째 줄 boolean 값 변환 실패: 크기 다름, %d 번째 줄 서버에서 읽은 자료가 배열형이 아님: %d 번째 줄 "%s" 이름의 기술자가 없음: %d 번째 줄 기술자 색인 범위를 벗어남: %d 번째 줄 빈 메시지 텍스트 빈 쿼리: %d 번째 줄 트랜잭션 처리 중 실패: %d 번째 줄 변수들의 배열을 삽입하는 기능을 제공하지 않음: %d 번째 줄 floating-point 형에 대한 입력 구문 오류: "%s", %d 번째 줄 int 형에 대한 입력 구문 오류: "%s", %d 번째 줄 unsigned int 형에 대한 입력 구문 오류: "%s", %d 번째 줄 "%s" 이름은 잘못된 쿼리구문 이름: %d 번째 줄 boolean 형에 대한 입력 구문 오류: "%s", %d 번째 줄 자료 없음: %d 번째 줄 "%s" 연결이 현재 끊겼음: %d 번째 줄 지시자 없는 null 값: %d 번째 줄 메모리 부족: %d 번째 줄 서버 연결 끊김 너무 적은 인자: %d 번째 줄 너무 많은 인자: %d 번째 줄 "%s" 이름은 알 수 없는 기술자 항목: %d 번째 줄 "%s" 형 지원하지 않음: %d 번째 줄 변수에 character 형이 없음: %d 번째 줄 변수에 numeric 형이 없음: %d 번째 줄 variable 형에서 배열형을 사용하고 있지 않음: %d 번째 줄 locale/ja/LC_MESSAGES/pg_ctl-9.6.mo 0000644 00000050665 14751153420 0012317 0 ustar 00 �� � � � < P D Q ? � � � &
0
P
- o
�
�
= �
! � A � a � K P � A � ! � 3 ? O H � D � C E a ? � ? � > ' 9 f L � B � E 0 � v 0 � F , > s 8 � I � % 5 2 [ O � 7 � & M 8 - � ! � > � E C [ y � 9 D S C � D � > ! A ` ( � , � 2 � 6 + > b * � / � % � 1 " 0 T # � � 4 � 2 � 1 / 0 a , � . � 3 � " + B 1 n 6 � : � 1 * D " o 7 � " � $ � J ] y 3 � 0 � � ! $ 6 [ - | � 4 � % � $ %! " J! ! m! F �! u �! F L" �" 7 �" ) �" k # ` u# % �# & �# #$ d +$ �$ / �$ & �$ 0 % . 7% ) f% ) �% �% �% & �%
& , +& ( X& �& ! �& �& �& �& �& ' "' 8' I' Y' j' z' " �' �' � �' n |) b �) 1 N* �* - �* * �* * �* J #+ 9 n+ ' �+ E �+ , 3, � T, �, a - K c- �- A �- ! . J .. G y. S �. \ / \ r/ Y �/ P )0 A z0 ^ �0 S 1 t o1 Z �1 P ?2 � �2 / 63 q f3 R �3 D +4 h p4 > �4 B 5 � [5 H �5 56 =6 & Q6 g x6 [ �6 * <7 a g7 p �7 r :8 � �8 e Z9 c �9 i $: i �: r �: l k; F �; G < U g< V �< ` = J u= ; �= C �= \ @> Q �> D �> ? 4? K t? F �? I @ O Q@ B �@ I �@ ] .A 3 �A D �A K B Q QB P �B U �B D JC 2 �C h �C ? +D 0 kD S �D 2 �D ) #E N ME O �E ) �E * F , AF 3 nF ? �F $ �F A G ' IG 6 qG ' �G $ �G t �G � jH K I & QI X xI : �I � J � �J : uK 3 �K �K � �K 1 �L B �L 8 M A AM 1 �M 5 �M 5 �M 0 !N $ RN ; wN + �N G �N @ 'O 1 hO C �O �O �O P % 5P [P {P . �P �P �P �P . Q 6 MQ 0 �Q ? L y ' { � V r � & $ o @ � � P b [ - C U � " ( _ . � ; X Y ! 6 � A B = / w � % 7 E K
v
J q c M , ~ # 3 ) 0 W � F s � ] 1 ` u } � � � h � f x m t d : z j � * g S O 9 Q D < G I 4 > 2 5 N Z � | l ^ p i + a H R n 8 � e � � T \ k
%s: -w option cannot use a relative socket directory specification
%s: -w option is not supported when starting a pre-9.1 server
Allowed signal names for kill:
Common options:
Options for register and unregister:
Options for start or restart:
Options for stop or restart:
Report bugs to <pgsql-bugs@postgresql.org>.
Shutdown modes are:
Start types are:
%s init[db] [-D DATADIR] [-s] [-o "OPTIONS"]
%s kill SIGNALNAME PID
%s promote [-D DATADIR] [-s]
%s register [-N SERVICENAME] [-U USERNAME] [-P PASSWORD] [-D DATADIR]
[-S START-TYPE] [-w] [-t SECS] [-o "OPTIONS"]
%s reload [-D DATADIR] [-s]
%s restart [-w] [-t SECS] [-D DATADIR] [-s] [-m SHUTDOWN-MODE]
[-o "OPTIONS"]
%s start [-w] [-t SECS] [-D DATADIR] [-s] [-l FILENAME] [-o "OPTIONS"]
%s status [-D DATADIR]
%s stop [-W] [-t SECS] [-D DATADIR] [-s] [-m SHUTDOWN-MODE]
%s unregister [-N SERVICENAME]
-?, --help show this help, then exit
-D, --pgdata=DATADIR location of the database storage area
-N SERVICENAME service name with which to register PostgreSQL server
-P PASSWORD password of account to register PostgreSQL server
-S START-TYPE service start type to register PostgreSQL server
-U USERNAME user name of account to register PostgreSQL server
-V, --version output version information, then exit
-W do not wait until operation completes
-c, --core-files allow postgres to produce core files
-c, --core-files not applicable on this platform
-e SOURCE event source for logging when running as a service
-l, --log=FILENAME write (or append) server log to FILENAME
-m, --mode=MODE MODE can be "smart", "fast", or "immediate"
-o OPTIONS command line options to pass to postgres
(PostgreSQL server executable) or initdb
-p PATH-TO-POSTGRES normally not necessary
-s, --silent only print errors, no informational messages
-t, --timeout=SECS seconds to wait when using -w option
-w wait until operation completes
auto start service automatically during system startup (default)
demand start service on demand
fast quit directly, with proper shutdown
immediate quit without complete shutdown; will lead to recovery on restart
smart quit after all clients have disconnected
done
failed
stopped waiting
%s is a utility to initialize, start, stop, or control a PostgreSQL server.
%s: -S option not supported on this platform
%s: PID file "%s" does not exist
%s: WARNING: cannot create restricted tokens on this platform
%s: WARNING: could not locate all job object functions in system API
%s: another server might be running; trying to start server anyway
%s: cannot be run as root
Please log in (using, e.g., "su") as the (unprivileged) user that will
own the server process.
%s: cannot promote server; server is not in standby mode
%s: cannot promote server; single-user server is running (PID: %ld)
%s: cannot reload server; single-user server is running (PID: %ld)
%s: cannot restart server; single-user server is running (PID: %ld)
%s: cannot set core file size limit; disallowed by hard limit
%s: cannot stop server; single-user server is running (PID: %ld)
%s: could not access directory "%s": %s
%s: could not allocate SIDs: error code %lu
%s: could not create promote signal file "%s": %s
%s: could not create restricted token: error code %lu
%s: could not determine the data directory using command "%s"
%s: could not find own program executable
%s: could not find postgres program executable
%s: could not open PID file "%s": %s
%s: could not open process token: error code %lu
%s: could not open service "%s": error code %lu
%s: could not open service manager
%s: could not read file "%s"
%s: could not register service "%s": error code %lu
%s: could not remove promote signal file "%s": %s
%s: could not send promote signal (PID: %ld): %s
%s: could not send reload signal (PID: %ld): %s
%s: could not send signal %d (PID: %ld): %s
%s: could not send stop signal (PID: %ld): %s
%s: could not start server
Examine the log output.
%s: could not start server: %s
%s: could not start server: error code %lu
%s: could not start service "%s": error code %lu
%s: could not unregister service "%s": error code %lu
%s: could not wait for server because of misconfiguration
%s: could not write promote signal file "%s": %s
%s: database system initialization failed
%s: directory "%s" does not exist
%s: directory "%s" is not a database cluster directory
%s: invalid data in PID file "%s"
%s: missing arguments for kill mode
%s: no database directory specified and environment variable PGDATA unset
%s: no operation specified
%s: no server running
%s: old server process (PID: %ld) seems to be gone
%s: option file "%s" must have exactly one line
%s: server does not shut down
%s: server is running (PID: %ld)
%s: service "%s" already registered
%s: service "%s" not registered
%s: single-user server is running (PID: %ld)
%s: the PID file "%s" is empty
%s: too many command-line arguments (first is "%s")
%s: unrecognized operation mode "%s"
%s: unrecognized shutdown mode "%s"
%s: unrecognized signal name "%s"
%s: unrecognized start type "%s"
(The default is to wait for shutdown, but not for start or restart.)
HINT: The "-m fast" option immediately disconnects sessions rather than
waiting for session-initiated disconnection.
If the -D option is omitted, the environment variable PGDATA is used.
Is server running?
Please terminate the single-user server and try again.
Server started and accepting connections
The program "%s" is needed by %s but was not found in the
same directory as "%s".
Check your installation.
The program "%s" was found by "%s"
but was not the same version as %s.
Check your installation.
Timed out waiting for server startup
Try "%s --help" for more information.
Usage:
WARNING: online backup mode is active
Shutdown will not complete until pg_stop_backup() is called.
Waiting for server startup...
cannot duplicate null pointer (internal error)
child process exited with exit code %d child process exited with unrecognized status %d child process was terminated by exception 0x%X child process was terminated by signal %d child process was terminated by signal %s command not executable command not found could not change directory to "%s": %s could not find a "%s" to execute could not get current working directory: %s
could not identify current directory: %s could not read binary "%s" could not read symbolic link "%s" invalid binary "%s" out of memory
pclose failed: %s server is still starting up
server promoting
server shutting down
server signaled
server started
server starting
server stopped
starting server anyway
waiting for server to shut down... waiting for server to start... Project-Id-Version: PostgreSQL 9.6.3
Report-Msgid-Bugs-To: pgsql-bugs@postgresql.org
POT-Creation-Date: 2017-04-04 11:59+0900
PO-Revision-Date: 2013-08-18 11:39+0900
Last-Translator: Daisuke Higuchi <higuchi.daisuke@jp.fujitsu.com>
Language-Team: jpug-doc <jpug-doc@ml.postgresql.jp>
Language: ja
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Plural-Forms: nplurals=1; plural=0;
%s: -wオプションでは相対ソケットディレクトリ指定を使用することができません
%s: 9.1より前のサーバを起動する際に-wオプションはサポートされません
killモードで利用できるシグナル名:
一般的なオプション:
登録、登録解除用のオプション:
起動、再起動用のオプション:
停止、再起動用のオプション:
不具合は<pgsql-bugs@postgresql.org>まで報告してください。
シャットダウンモードは以下の通りです:
起動種類は以下の通りです:
%s init[db] [-D DATADIR] [-s] [-o "オプション"]
%s kill SIGNALNAME PID
%s promote [-D DATADIR] [-s]
%s register [-N SERVICENAME] [-U USERNAME] [-P PASSWORD] [-D DATADIR]
[-S START-TYPE] [-w] [-t SECS] [-o "OPTIONS"]
%s reload [-D DATADIR] [-s]
%s restart [-w] [-t SECS] [-D DATADIR] [-s] [-m SHUTDOWN-MODE]
[-o "OPTIONS"]
%s start [-w] [-t SECS] [-D DATADIR] [-s] [-l FILENAME] [-o "OPTIONS"]
%s status [-D DATADIR]
%s stop [-W] [-t SECS] [-D DATADIR] [-s] [-m SHUTDOWN-MODE]
%s unregister [-N SERVICENAME]
-?, --help このヘルプを表示し、終了します
-D, --pgdata DATADIR データベース格納領域の場所です
-N SERVICENAME PostgreSQLサーバを登録するためのサービス名です
-P PASSWORD PostgreSQLサーバを登録するアカウントのパスワードです
-S START-TYPE PostgreSQLサーバを登録するためのサービス起動種類です
-U USERNAME PostgreSQLサーバを登録するアカウントのユーザ名です
-V, --version バージョン情報を表示し、終了します
-W 作業の完了まで待機しません
-c, --core-files postgresはコアファイルを生成することができます。
-c, --core-files このプラットフォームでは実行できません
-e SOURCE サービスとして実行する時のログ収集のためのイベントソースです
-l, --log FILENAME サーバログをFILENAMEへ出力(あるいは追加)します
-m, --mode=MODE MODEは"smart"、"fast"、"immediate"のいずれかです
-o オプション postgres(PostgreSQLサーバ実行ファイル)または
initdb に渡すコマンドラインオプション
-p PATH-TO-POSTGRES 通常は不要です
-s, --silent エラーメッセージのみを表示し、情報メッセージは表示しません
-t, --timeout=SECS -wオプションを使用する時に待機する秒数
-w 作業が完了するまで待機します
auto システムの起動時にサービスを自動的に開始します（デフォルト）
demand 必要に応じてサービスを開始します
fast シャットダウン手続き後に停止します
immediate シャットダウン手続きを行わずに停止します。再起動時にリカバリ状態になる可能性があります
smart 全クライアントの接続切断後に停止します
完了
失敗しました
待機処理が停止されました
%sはPostgreSQLサーバの初期化、起動、停止、制御を行うユーティリティです。
%s: -Sオプションはこのプラットフォームでサポートされていません
%s: PIDファイル"%s"がありません
%s: 警告: このプラットフォームでは制限付きトークンを作成できません
%s: 警告: システムAPI内にすべてのジョブオブジェクト関数を格納できませんでした
%s: 他のサーバが動作中の可能性がありますが、とにかくpostmasterの起動を試みます。
%s: rootでは実行できません
サーバプロセスの所有者となる(非特権)ユーザとして(例えば"su"を使用して)
ログインしてください。
%s: サーバを昇進できません。サーバはスタンバイモードではありません。
%s: サーバを昇進できません。シングルユーザサーバ(PID: %ld)が動作中です
%s: サーバをリロードできません。シングルユーザサーバ(PID: %ld)が動作中です
%s: サーバを再起動できません。シングルユーザサーバ(PID: %ld)が動作中です。
%s: コアファイルのサイズ制限を設定できません:固定の制限により許されていません
%s: サーバを停止できません。シングルユーザサーバ(PID: %ld)が動作しています。
%s: ディレクトリ"%s"にアクセスできませんでした: %s
%s: SIDを割り当てられませんでした: エラーコード %lu
%s: "%s"昇進通知ファイルを作成することができませんでした: %s
%s: 制限付きトークンを作成できませんでした: エラーコード %lu
%s: コマンド"%s"を使用するデータディレクトリを決定できませんでした
%s: 本プログラムの実行ファイルの検索に失敗しました
%s: postgres の実行ファイルが見つかりません
%s: PIDファイル"%s"をオープンできませんでした: %s
%s: プロセストークンをオープンできませんでした: エラーコード %lu
%s: サービス"%s"のオープンに失敗しました: エラーコード %lu
%s: サービスマネージャのオープンに失敗しました
%s: ファイル"%s"を読み取ることに失敗しました
%s: サービス"%s"の登録に失敗しました: エラーコード %lu
%s: "%s"昇進通知ファイルを削除できませんでした: %s
%s: 昇進シグナルを送信できませんでした。(PID: %ld): %s
%s: リロードシグナルを送信できませんでした。(PID: %ld): %s
%s: シグナル%dを送信できませんでした(PID: %ld): %s
%s: 停止シグナルを送信できませんでした。(PID: %ld): %s
%s: サーバを起動できませんでした。
ログ出力を確認してください。
%s: サーバを起動できませんでした: %s
%s: サーバの起動に失敗しました: エラーコード %lu
%s: サービス"%s"の起動に失敗しました: エラーコード %lu
%s: サービス"%s"の登録削除に失敗しました: エラーコード %lu
%s: 誤設定のためサーバを待機することができませんでした
%s: "%s"昇進通知ファイルを書き出すことができませんでした: %s
%s: データベースシステムが初期化に失敗しました
%s: ディレクトリ "%s" は存在しません
%s: ディレクトリ "%s" はデータベースクラスタのディレクトリではありません
%s: PIDファイル"%s"内に無効なデータがあります
%s: killモード用の引数がありません
%s: データベースの指定も、PGDATA環境変数の設定もありません
%s: 操作モードが指定されていません
%s: サーバが動作していません
%s: 古いサーバプロセス(PID: %ld)が動作していないようです
%s: オプションファイル"%s"は1行のみでなければなりません
%s: サーバは停止していません
%s: サーバが動作中です(PID: %ld)
%s: サービス\"%s\"は登録済みです
%s: サービス"%s"は登録されていません
%s: シングルユーザサーバが動作中です(PID: %ld)
%s: PIDファイル"%s"が空です
%s: コマンドライン引数が多すぎます(先頭は"%s")
%s: 操作モード"%s"は不明です
%s: シャットダウンモード"%s"は不明です
%s: シグナル名"%s"は不明です
%s: 起動種類"%s"は不明です
(デフォルトでは、シャットダウン時は待機し、起動と再起動の時は待機し
ません。)
ヒント: "-m fast"オプションは、セッション切断が始まるまで待機するのではなく
即座にセッションを切断します。
-Dオプションの省略時、PGDATA環境変数が使用されます。
サーバが動作していますか?
シングルユーザサーバを終了させてから、再度実行してください
サーバは起動し、接続を受け付けています
%2$sには"%1$s"プログラムが必要ですが、"%3$s"と同じディレクトリ
にありませんでした。
インストール状況を確認してください。
"%2$s"がプログラム"%1$s"を見つけましたが、これは%3$sと同じ
バージョンではありませんでした。
インストレーションを検査してください。
サーバの起動待機がタイムアウトしました
詳細は"%s --help"を実行してください。
使用方法:
警告: オンラインバックアップモードが実行中です。
pg_stop_backup()が呼び出されるまでシャットダウンは完了しません
サーバの起動完了を待っています...
null ポインタを複製できません（内部エラー）。
子プロセスが終了コード%dで終了しました 子プロセスが未知のステータス%dで終了しました 子プロセスが例外0x%Xで終了しました 子プロセスがシグナル%dで終了しました 子プロセスがシグナル%sで終了しました コマンドは実行形式ではありません コマンドが見つかりません ディレクトリ"%s"に移動できませんでした: %s 実行する"%s"がありませんでした 現在の作業ディレクトリを取得できませんでした: %s
現在のディレクトリを認識できませんでした: %s バイナリ"%s"を読み取れませんでした シンボリックリンク"%s"の読み取りに失敗しました バイナリ"%s"は無効です メモリ不足です
pcloseが失敗しました: %s サーバは依然起動中です。
サーバを昇進中です。
サーバの停止中です
サーバにシグナルを送信しました
サーバ起動完了
サーバは起動中です。
サーバは停止しました
とにかくサーバを起動しています
サーバ停止処理の完了を待っています... サーバの起動完了を待っています... locale/ja/LC_MESSAGES/pg_config-9.6.mo 0000644 00000014705 14751153420 0012775 0 ustar 00 �� * l ; � � E � 0 � : 3 E n I � L � s K K � = B I i � G � J > M � M � ? % G e > � 6 � < # > ` F � P � I 7
4 �
2 �
* �
. , 8 & e � & � � ( � ! B V c � u f " H � � O � U > Y � \ � y K [ � F ! K h t � V ) Z � ] � ] 9 ^ � W � X N L � B � V 7 X � v � [ ^ G � J 8 M � � I � - / ; > + z @ � 1 � O i � � % * ) $
" '
& ( ! #
%s provides information about the installed version of PostgreSQL.
With no arguments, all known items are shown.
%s [OPTION]...
--bindir show location of user executables
--cc show CC value used when PostgreSQL was built
--cflags show CFLAGS value used when PostgreSQL was built
--cflags_sl show CFLAGS_SL value used when PostgreSQL was built
--configure show options given to "configure" script when
PostgreSQL was built
--cppflags show CPPFLAGS value used when PostgreSQL was built
--docdir show location of documentation files
--htmldir show location of HTML documentation files
--includedir show location of C header files of the client
interfaces
--includedir-server show location of C header files for the server
--ldflags show LDFLAGS value used when PostgreSQL was built
--ldflags_ex show LDFLAGS_EX value used when PostgreSQL was built
--ldflags_sl show LDFLAGS_SL value used when PostgreSQL was built
--libdir show location of object code libraries
--libs show LIBS value used when PostgreSQL was built
--localedir show location of locale support files
--mandir show location of manual pages
--pgxs show location of extension makefile
--pkgincludedir show location of other C header files
--pkglibdir show location of dynamically loadable modules
--sharedir show location of architecture-independent support files
--sysconfdir show location of system-wide configuration files
--version show the PostgreSQL version
-?, --help show this help, then exit
%s: could not find own program executable
%s: invalid argument: %s
Options:
Report bugs to <pgsql-bugs@postgresql.org>.
Try "%s --help" for more information.
Usage:
could not change directory to "%s": %s could not find a "%s" to execute could not identify current directory: %s could not read binary "%s" could not read symbolic link "%s" invalid binary "%s" not recorded pclose failed: %s Project-Id-Version: PostgreSQL 9.0 beta 3
Report-Msgid-Bugs-To: pgsql-bugs@postgresql.org
POT-Creation-Date: 2017-04-03 13:41+0900
PO-Revision-Date: 2017-02-01 16:53+0900
Last-Translator: Ideriha Takeshi <ideriha.takeshi@jp.fujitsu.com>
Language-Team: jpug-doc <jpug-doc@ml.postgresql.jp>
Language: ja
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Plural-Forms: nplurals=1; plural=0;
%sはインストールされたバージョンのPostgreSQLに関する情報を提供します。
引数がない場合、既知の項目をすべて表示します。
%s [オプション]...
--bindir ユーザ実行ファイルの場所を表示します
--cc PostgreSQL構築時に使用したCCの値を表示します
--cflags PostgreSQL構築時に使用したCFLAGSの値を表示します
--cflags_sl PostgreSQL構築時に使用したCFLAGS_SLの値を表示します
--configure PostgreSQL構築時の"configure"スクリプトで指定したオプションを表示します
--cppflags PostgreSQL構築時に使用したCPPFLAGSの値を表示します
--docdir 文書ファイルの場所を表示します
--htmldir html文書ファイルの場所を表示します
--includedir クライアントインタフェース用Cヘッダファイルの場所を表示します
--includedir-server サーバ用Cヘッダファイルの場所を表示します
--ldflags PostgreSQL構築時に使用したLDFLAGSの値を表示します
--ldflags_ex PostgreSQL構築時に使用したLDFLAGS_EXの値を表示します
--ldflags_sl PostgreSQL構築時に使用したLDFLAGS_SLの値を表示します
--libdir オブジェクトコードライブラリの場所を表示します
--libs PostgreSQL構築時に使用したLIBSの値を表示します
--localedir ロケールサポートファイルの場所を表示します
--mandir マニュアルページの場所を表示します
--pgxs 拡張makefileの場所を表示します
--pkgincludedir その他のCヘッダファイルの場所を表示します
--pkglibdir 動的ロード可能モジュールの場所を表示します
--sharedir アーキテクチャに依存しないサポートファイルの場所を表示します。
--sysconfdir システム全体の設定ファイルの場所を表示します
--version PostgreSQLのバージョンを表示します
-?, --help このヘルプを表示し、終了します
%s: 実行ファイル自体がありませんでした
%s: 無効な引数です: %s
オプション:
不具合は<pgsql-bugs@postgresql.org>まで報告してください。
詳細は"%s --help"を行ってください
使用方法:
ディレクトリ"%s"に移動できませんでした: %s 実行する"%s"がありませんでした 現在のディレクトリを認識できませんでした: %s バイナリ"%s"を読み取れませんでした シンボリックリンク"%s"を読み取ることができませんでした バイナリ"%s"は無効です 記録されていません pcloseが失敗しました: %s locale/ja/LC_MESSAGES/libpq5-9.6.mo 0000644 00000062210 14751153420 0012230 0 ustar 00 �� � T
� � � � � � � �
' ( > g # � � � $ � �
" 0 - ( ^ ( � � � � 5 � 8 < $ ] # � � � - � � . * ( Y , � � � : � " / G < X a � 0 � ) ( ' R * z . � + � ' ' ( * P * { + � * � , � ) * ) T + ~ - � / � + ( 4 ) ] & � 5 � 3 � & ! ? a | � " � v � w G r � 2 ! S u ' � - � � � # | 9 � & � ) * + # V 9 z ) � ' � ) 0 ) N " x 9 � . � ' * , " W " z . � / � - � @ *! 2 k! ! �! % �! % �! V " = c" ; �" �" �" # 4 :# 0 o# �# : �# �# $ 9$ - Z$ - �$ �$ + �$ 2 �$ 7 1% = i% ! �% . �% 8 �% " 1& T& F t& C �& $ �& $' B ?' �' �' ; �' ( �' * ( & ?( % f( ! �( 6 �( C �( ? )) 2 i) 1 �) = �) ) * J 6* �* �* �* �* �* 1 +
6+ D+ + S+ + ) �+ " �+ [ �+ G, ? `, 1 �, 8 �, > - � J- # �- �- : . � ?. 2 �. Q �. J N/ K �/ �/ ? 0 ! B0 + d0 �0 �0 L �0 D
1 % O1 . u1 C �1 �1 $ 2 5 .2 ) d2 � �2 +4 >4 A4 F4 L4 ^4
t4 > �4 ? �4 2 5 0 45 e5 y5 1 �5 �5 $ �5
�5 O �5 5 M6 5 �6 �6 �6 �6 G �6 J 7 3 h7 = �7 ; �7 8 "8 9 48 n8 # �8 8 �8 / �8 7 9 M9 h9 S z9 / �9 �9 : Q #: � u: Y 2; 6 �; + �; ; �; ? +< < k< 5 �< 3 �< - = - @= . n= - �= / �= , �= , (> . U> 0 �> 2 �> . �> + ? , C? / p? B �? Y �? 1 =@ 1 o@ �@ + �@ �@ + A � 7A � !B � �B / ~C ; �C 2 �C / D V MD � �D ; �E d �E D &F < kF = �F ? �F O &G E vG A �G E �G < DH ? �H 6 �H [ �H < TI > �I ; �I ; J 8 HJ J �J K �J S K ^ lK E �K 6 L / HL xL y �L W M a gM 5 �M 3 �M 3 3N M gN I �N 4 �N V 4O % �O 4 �O 3 �O D P D _P & �P 7 �P 4 Q S 8Q ] �Q 7 �Q K "R 7 nR 0 �R ) �R K S I MS 4 �S % �S K �S >T # [T E T C �T O U > YU : �U 0 �U Q V d VV P �V H W M UW ] �W ) X v +X # �X ' �X ( �X Y 1 8Y F jY �Y �Y : �Y < Z 7 VZ > �Z � �Z " �[ j �[ > \ e U\ P �\ � ] 1 �] " �] B ^ � W^ R _ y o_ m �_ o W` 5 �` T �` ( Ra F {a + �a �a ^ b ^ jb ? �b I c _ Sc # �c ( �c O d 7 Pd � ' � C � d ( @ . U < � F � � R � _ g f 0 � � ) � N � % w : � � r 5 �
� K � � t = 4 m j V J � � � � � � k � � { X e l � > � � , � � � � 1 � P Q B � a 7 L H u h E # � � z � � � $ � 2 � / O � | 8 � � G � � � ` � � W ! ~ x 9 ^ 6
q c � � � y & � � � � � ; \ + � � � � S T [ " � } � b � � Z ] n * i ? A Y 3 I � s � o p M v � - � � D � � at character %s %s %s, %s:%s COLUMN NAME: %s
CONSTRAINT NAME: %s
CONTEXT: %s
COPY IN state must be terminated first
COPY OUT state must be terminated first
COPY terminated by new PQexec Crypt authentication not supported
DATATYPE NAME: %s
DETAIL: %s
GSSAPI authentication not supported
GSSAPI continuation error GSSAPI name import error HINT: %s
IPv6 host address may not be empty in URI: "%s"
Kerberos 4 authentication not supported
Kerberos 5 authentication not supported
LINE %d: LOCATION: NOTICE PGEventProc "%s" failed during PGEVT_CONNRESET event
PGEventProc "%s" failed during PGEVT_RESULTCREATE event
PGresult is not an error result
PQexec not allowed during COPY BOTH
PQgetline: not doing text COPY OUT
QUERY: %s
SCHEMA NAME: %s
SCM_CRED authentication method not supported
SSL SYSCALL error: %s
SSL SYSCALL error: EOF detected
SSL certificate's name contains embedded null
SSL certificate's name entry is missing
SSL connection has been closed unexpectedly
SSL error code %lu SSL error: %s
SSL library does not support CRL certificates (file "%s")
SSPI authentication not supported
SSPI continuation error TABLE NAME: %s
Unix-domain socket path "%s" is too long (maximum %d bytes)
WARNING: password file "%s" has group or world access; permissions should be u=rw (0600) or less
WARNING: password file "%s" is not a plain file
WSAIoctl(SIO_KEEPALIVE_VALS) failed: %ui
another command is already in progress
argument of lo_read exceeds integer range
argument of lo_truncate exceeds integer range
argument of lo_write exceeds integer range
attribute has no values on LDAP lookup
authentication method %u not supported
cannot determine OID of function lo_close
cannot determine OID of function lo_creat
cannot determine OID of function lo_create
cannot determine OID of function lo_lseek
cannot determine OID of function lo_lseek64
cannot determine OID of function lo_open
cannot determine OID of function lo_tell
cannot determine OID of function lo_tell64
cannot determine OID of function lo_truncate
cannot determine OID of function lo_truncate64
cannot determine OID of function lo_unlink
cannot determine OID of function loread
cannot determine OID of function lowrite
certificate could not be obtained: %s
certificate does not match private key file "%s": %s
certificate present, but not private key file "%s"
column number %d is out of range 0..%d command string is a null pointer
connection in wrong state
connection not open
connection pointer is NULL
could not acquire SSPI credentials could not connect to server: %s
Is the server running locally and accepting
connections on Unix domain socket "%s"?
could not connect to server: %s
Is the server running on host "%s" (%s) and accepting
TCP/IP connections on port %s?
could not connect to server: %s
Is the server running on host "%s" and accepting
TCP/IP connections on port %s?
could not create LDAP structure
could not create SSL context: %s
could not create socket: %s
could not establish SSL connection: %s
could not get client address from socket: %s
could not get home directory to locate root certificate file
Either provide the file or change sslmode to disable server certificate verification.
could not get peer credentials: %s
could not get server's host name from server certificate
could not get socket error status: %s
could not initialize SSL engine "%s": %s
could not interpret result from server: %s could not load SSL engine "%s": %s
could not load private SSL key "%s" from engine "%s": %s
could not load private key file "%s": %s
could not look up local user ID %d: %s
could not open certificate file "%s": %s
could not open file "%s": %s
could not read certificate file "%s": %s
could not read from file "%s": %s
could not read private SSL key "%s" from engine "%s": %s
could not read root certificate file "%s": %s
could not receive data from server: %s
could not send SSL negotiation packet: %s
could not send data to server: %s
could not send startup packet: %s
could not set socket to TCP no delay mode: %s
could not set socket to close-on-exec mode: %s
could not set socket to nonblocking mode: %s
could not translate Unix-domain socket path "%s" to address: %s
could not translate host name "%s" to address: %s
could not write to file "%s": %s
definition of service "%s" not found
duplicate GSS authentication request
end of string reached when looking for matching "]" in IPv6 host address in URI: "%s"
expected authentication request from server, but received %c
extra key/value separator "=" in URI query parameter: "%s"
extraneous data in "D" message extraneous data in "T" message extraneous data in "t" message forbidden value %%00 in percent-encoded value: "%s"
function requires at least protocol version 3.0
host name must be specified
host name must be specified for a verified SSL connection
incomplete multibyte character
insufficient data in "D" message insufficient data in "T" message integer of size %lu not supported by pqGetInt integer of size %lu not supported by pqPutInt invalid ExecStatusType code invalid LDAP URL "%s": invalid port number
invalid LDAP URL "%s": missing distinguished name
invalid LDAP URL "%s": must have exactly one attribute
invalid LDAP URL "%s": must have search scope (base/one/sub)
invalid LDAP URL "%s": no filter
invalid LDAP URL "%s": scheme must be ldap://
invalid URI propagated to internal parser routine: "%s"
invalid URI query parameter: "%s"
invalid connection option "%s"
invalid connection state %d, probably indicative of memory corruption
invalid connection state, probably indicative of memory corruption
invalid percent-encoded token: "%s"
invalid port number: "%s"
invalid setenv state %c, probably indicative of memory corruption
invalid socket
invalid sslmode value: "%s"
invalid state %c, probably indicative of memory corruption
keepalives parameter must be an integer
length must be given for binary parameter
line %d too long in service file "%s"
local user with ID %d does not exist
lookup on LDAP server failed: %s
lost synchronization with server, resetting connection lost synchronization with server: got message type "%c", length %d
message contents do not agree with length in message type "%c"
message type 0x%02x arrived from server while idle missing "=" after "%s" in connection info string
missing key/value separator "=" in URI query parameter: "%s"
more than one entry found on LDAP lookup
nested service specifications not supported in service file "%s", line %d
no COPY in progress
no SSL error reported no connection to the server
no entry found on LDAP lookup
no error message available
number of parameters must be between 0 and 65535
out of memory out of memory
out of memory allocating GSSAPI buffer (%d) out of memory for query result parameter number %d is out of range 0..%d password retrieved from file "%s"
private key file "%s" has group or world access; permissions should be u=rw (0600) or less
protocol error: id=0x%x
query to initialize large object functions did not return data
received invalid response to SSL negotiation: %c
requirepeer parameter is not supported on this platform
requirepeer specifies "%s", but actual peer user name is "%s"
root certificate file "%s" does not exist
Either provide the file or change sslmode to disable server certificate verification.
row number %d is out of range 0..%d select() failed: %s
server certificate for "%s" does not match host name "%s"
server closed the connection unexpectedly
This probably means the server terminated abnormally
before or while processing the request.
server does not support SSL, but SSL was required
server sent binary data ("B" message) without prior row description ("T" message) server sent data ("D" message) without prior row description ("T" message) server sent data ("D" message) without prior row description ("T" message)
service file "%s" not found
sslmode value "%s" invalid when SSL support is not compiled in
statement name is a null pointer
syntax error in service file "%s", line %d
timeout expired
unexpected asyncStatus: %d
unexpected character "%c" at position %d in URI (expected ":" or "/"): "%s"
unexpected character %c following empty query response ("I" message) unexpected field count in "D" message unexpected message from server during startup
unexpected response from server; first received character was "%c"
unrecognized SSL error code: %d
unrecognized socket error: 0x%08X/%d unterminated quoted string in connection info string
user name lookup failure: error code %lu
Project-Id-Version: PostgreSQL 9.6
Report-Msgid-Bugs-To: pgsql-bugs@postgresql.org
POT-Creation-Date: 2019-11-09 07:39+0000
PO-Revision-Date: 2014-08-16 16:38+0900
Last-Translator: OkanoNaoki <okano.naoki@jp.fujitsu.com>
Language-Team: jpug-doc <jpug-doc@ml.postgresql.jp>
Language: ja
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Plural-Forms: nplurals=1; plural=0;
(文字位置: %s) %s %s, %s:%s COLUMN NAME: %s
CONSTRAINT NAME: %s
CONTEXT: %s
まずCOPY IN状態を終了させなければなりません
まずCOPY OUT状態を終了させなければなりません
新たなPQexec"によりCOPYが終了しました Crypt認証はサポートされていません
DATATYPE NAME: %s
DETAIL: %s
GSSAPI認証はサポートされていません
GSSAI続行エラー GSSAPI名のインポートエラー HINT: %s
URI "%s"内のIPv6ホストアドレスが空である可能性があります
Kerberos 4認証はサポートされていません
Kerberos 5認証はサポートされていません
行 %d: LOCATION: 注意 PGEVT_CONNRESETイベント中にPGEventProc "%s"に失敗しました
PGEVT_RESULTCREATEイベント中にPGEventProc "%s"に失敗しました
PGresultはエラーの結果ではありません
COPY BOTH 実行中の PQexec は許可されていません
PQgetline: テキストのCOPY OUTを行っていません
QUERY: %s
SCHEMA NAME: %s
SCM_CRED認証方式はサポートされていません
SSL SYSCALLエラー: %s
SSL SYSCALLエラー: EOFを検知
SSL 証明書名項目に null が含まれています
SSL 証明書名項目が見つかりません
SSL接続が意図せずにクローズされました
SSLエラーコード: %lu SSLエラー: %s
SSLライブラリがCRL証明書（"%s"）をオープンできませんでした
SSPI認証はサポートされていません
SSPI続行エラー TABLE NAME: %s
Unixドメインソケットのパス"%s"が長すぎます(最大 %d バイト)
警告: パスワードファイル "%s" がグループメンバもしくは他のユーザから読める状態になっています。この権限はu=rw (0600)以下にすべきです
WARNING: パスワードファイル"%s"がテキストファイルではありません
WSAIoctl(SIO_KEEPALIVE_VALS)に失敗しました:%ui
他のコマンドを処理しています
lo_readへの引数が整数範囲を超えています。
lo_truncateへの引数が整数範囲を超えています。
lo_writeへの引数が整数範囲を超えています。
LDAP検索で属性に値がありませんでした
認証方式%uはサポートされていません
lo_close関数のOIDを決定できません
lo_creat関数のOIDを決定できません
lo_create関数のOIDを決定できません
lo_lseek関数のOIDを決定できません
lo_lseek64関数のOIDを決定できません
lo_open関数のOIDを決定できません
lo_tell関数のOIDを決定できません
lo_tell64関数のOIDを決定できません
lo_truncate関数のOIDを決定できません
lo_truncate64関数のOIDを決定できません
lo_unlink関数のOIDを決定できません
loread関数のOIDを決定できません
lowrite関数のOIDを決定できません
証明書を入手できませんでした: %s
証明書と秘密キーファイル"%s"が一致しません: %s
証明書はありましたが、秘密キーファイル"%s"はありませんでした
列番号%dは0..%dの範囲を超えています コマンド文字列がヌルポインタです
接続状態が異常です
接続はオープンされていません
接続ポインタはNULLです
SSPI資格を入手できませんでした サーバに接続できませんでした: %s
ローカルにサーバが稼動していますか?
Unixドメインソケット"%s"で通信を受け付けていますか?
サーバに接続できませんでした: %s
サーバはホスト "%s" (%s) で稼動しており、
また、ポート %s で TCP/IP 接続を受け付けていますか?
サーバに接続できませんでした: %s
サーバはホスト"%s"で稼動していますか?
また、ポート%sでTCP/IP接続を受け付けていますか?
LDAP構造体を作成できませんでした
SSLコンテキストを作成できませんでした: %s
ソケットを作成できませんでした: %s
SSL接続を確立できませんでした: %s
ソケットからクライアントアドレスを入手できませんでした: %s
ルート証明書ファイルを置くためのホームディレクトリが存在しません。
ファイルを用意するか、サーバ証明書の検証を無効にするように sslmode を変更してください
ピアの資格証明を入手できませんでした: %s
サーバ証明書からサーバのホスト名を取り出すことができませんでした。
ソケットのエラー状態を入手できませんでした: %s
SSLエンジン"%s"を初期化できませんでした: %s
サーバからの結果を解釈できませんでした: %s SSLエンジン"%s"を読み込みできませんでした: %s
SSL秘密キー"%s"をエンジン"%s"から読み取れませんでした: %s
秘密キーファイル"%s"をロードできませんでした: %s
ローカルユーザID %d が見つかりませんでした: %s
証明書ファイル"%s"をオープンできませんでした: %s
ファイル"%s"をオープンできませんでした: %s
証明書ファイル"%s"を読み込めませんでした: %s
ファイル"%s"を読み込めませんでした: %s
SSL秘密キーファイル"%s"をエンジン"%s"から読み取れませんでした: %s
ルート証明書"%s"を読み取れませんでした: %s
サーバからデータを受信できませんでした: %s
SSL調停パケットを送信できませんでした: %s
サーバにデータを送信できませんでした: %s
開始パケットを送信できませんでした: %s
TCPソケットを非遅延モードに設定できませんでした: %s
ソケットをclose-on-execモードに設定できませんでした: %s
ソケットを非ブロッキングモードに設定できませんでした: %s
Unixドメインソケットのパス"%s"をアドレスに変換できませんでした: %s
ホスト名"%s"をアドレスに変換できませんでした: %s
ファイル"%s"に書き込めませんでした: %s
サービス定義"%s"がみつかりません
重複するGSS認証要求
URI "%s"内のIPv6ホストアドレスにおいて対応する"]"を探している間に文字列が終わりました
サーバからの認証要求を想定していましたが、%cを受信しました
URI問い合わせパラメータ内に余分なキーと値を分ける"="があります: "%s"
”D"メッセージ内のデータが無関係です "T"メッセージ内のデータが無関係です "t"メッセージ内のデータが無関係です パーセント符号化された値では%%00値は許されません: "%s"
関数は少なくともプロトコルバージョン3.0が必要です
ホスト名を指定しなければなりません
SSL 接続を検証するためにホスト名を指定しなければなりません
不完全なマルチバイト文字
"D""メッセージ内のデータが不十分です "T"メッセージ内のデータが不十分です サイズ%luの整数はpqGetIntでサポートされていません サイズ%luの整数はpqPutIntでサポートされていません ExecStatusTypeコードが無効です 無効なLDAP URL "%s": ポート番号が無効です
無効なLDAP URL "%s": 区別名がありません
無効なLDAP URL "%s": 正確に1つの属性を持たなければなりません
無効なLDAP URL "%s": 検索スコープ(base/one/sub)を持たなければなりません
無効なLDAP URL "%s": フィルタがありません
無効なLDAP URL"%s":スキーマはldap://でなければなりません
内部パーサ処理へ伝わった無効なURI: "%s"
無効なURI問い合わせパラメータ:"%s"
接続オプション"%s"は無効です
接続状態%dが無効です。メモリ障害の可能性があります
接続状態が無効です。メモリ障害の可能性があります
無効なパーセント符号化トークン: "%s"
無効なポート番号です: "%s"
setenv状態%cは無効です。メモリ障害の可能性があります
無効なソケットです
sslmodeの値が無効です: "%s"
状態%cは無効です。メモリ障害の可能性があります
keepaliveのパラメータは整数でなければなりません
バイナリパラメータには長さを指定しなければなりません
サービスファイル"%2$s"の行%1$dが長すぎます。
ID %d を持つローカルユーザは存在しません
LDAPサーバで検索に失敗しました: %s
サーバとの動機が失われました。接続をリセットしています サーバとの同期が失われました。受信したメッセージ種類は"%c"、長さは%d
メッセージの内容がメッセージ種類"%c"の長さに合いません
待機中にサーバからメッセージ種類0x%02xが届きました 接続情報文字列において"%s"の後に"="がありませんでした
URI問い合わせパラメータ内にキーと値を分ける\"=\"がありません: "%s"
LDAP検索結果が複数ありました
サービスファイル"%s"の行%dにおいて、入れ子のサービス指定はサポートされていません
実行中のCOPYはありません
SSLエラーはありませんでした サーバへの接続がありません
LDAP検索結果が空でした
エラーメッセージが利用できません
パラメータ数は0から65535まででなければなりません
メモリ不足です メモリ不足です
GSSAPIバッファの割り当て時のメモリ不足(%d) 問い合わせ結果用のメモリが不足しています パラメータ%dは0..%dの範囲を超えています ファイル"%s"からパスワードを読み込みました
警告：秘密キーファイル "%s" がグループメンバや第三者から読める状態になっています。この権限はu=rw (0600)またはそれ以下とすべきです
プロトコルエラー: id=0x%x
ラージオブジェクト機能を初期化する問い合わせがデータを返しませんでした
SSL調停に対して無効な応答を受信しました: %c
このプラットフォームでは requirepeer パラメータはサポートされていません
requirepeerは"%s"を指定していますが、実際のピア名は"%s"です
ルート証明書ファイル"%s"が存在しません。
ファイルを用意するかサーバ証明書の検証を無効にするようにsslmodeを変更してください
行番号%dは0..%dの範囲を超えています select()が失敗しました: %s
"%s"のサーバ証明書がホスト名"%s"と一致しません
サーバとの接続が想定外にクローズされました
おそらく要求の処理前または処理中にサーバが異常終了
したことを意味しています。
サーバはSSLをサポートしていませんが、SSLが要求されました
サーバが事前の行記述("T"メッセージ)なしにバイナリデータ("B"メッセージ)を送信しました サーバが事前の行記述("T"メッセージ)なしにデータ("D"メッセージ)を送信しました サーバが事前の行記述("T"メッセージ)なしにデータ("D"メッセージ)を送信しました"
サービスファイル"%s"がみつかりません
SSLサポートが組み込まれていない場合sslmodeの値"%s"は無効です
文の名前がヌルポインタです
サービスファイル"%s"の行%dに構文エラーがあります
タイムアウト期間が過ぎました
想定外のasyncStatus: %d
URI（":"と"/"を除く）内の位置%2$dに想定外の"%1$c"文字があります: "%3$s"
空の問い合わせ応答("I"メッセージ)の後に想定外の文字%cがありました "D"メッセージ内のフィールド数が想定外です。 起動時にサーバから想定外のメッセージがありました
サーバから想定外の応答がありました。受け付けた先頭文字は"%c"です
不明のSSLエラーコード: %d
不明なソケットエラー 0x%08X/%d 接続情報文字列において閉じていない引用符がありました
ユーザ名の検索に失敗: エラーコード %lu
locale/ja/LC_MESSAGES/ecpg-9.6.mo 0000644 00000037456 14751153420 0011770 0 ustar 00 �� y � � � 8
~ 9
- �
0 �
+ g C � 4 � 7 s 8 . � G � 4 #
) X
w �
4 �
/ @ B = � , � ! � , . 1 [ * � - � 1 � ' & @ + g " � # � � ) � = J T & p < � ! � � - + . " Z } , � � � * " . ' Q y � ! � � ! � 3 ; / o ' � 5 � I � , G / t * � T � ' $ L g � � � - � , � , ! 5 N � ) � ? � 8
� C � 0 � 5 % [ A p L � + �
+ 6 9 ' p # � � ( � 4 � ) ' Q / n � � $ � � " , 8 e } ' � � � $ � D $ + i ? � 0 � 8 % ^ | & � � � � � � G n! H �! J �! � J" 4 �" g ## P �# � �# E �$ | �$ W G% J �% � �% T �& " �& Q ' K q' D �' @ ( 5 C( E y( = �( 6 �( 9 4) = n) 3 �) 2 �) 7 * - K* . y* �* . �* h �* L+ & ^+ 3 �+ ^ �+ 9 , R, 3 [, j �, 8 �, % 3- M Y- 4 �- �- / �- ) -. / W. �. $ �. 0 �. " �. + / L/ 1 \/ V �/ T �/ B :0 O }0 j �0 9 81 H r1 9 �1 q �1 6 g2 ' �2 �2 �2 �2 # 3 B 53 A x3 A �3 B �3 - ?4 - m4 K �4 ? �4 � '5 2 6 Q 46 T �6 �6 l �6 � a7 0 �7 8 f /8 @ �8 I �8 !9 F 19 F x9 5 �9 + �9 F !: 5 h: + �: 2 �: " �: & ; 3 G; & {; 9 �; 8 �; - < - C< & q< k �< F = a K= = �= . �= [ > ( v> ( �> 4 �> 0 �> Y * - < ? " 9 M O = ^ 0 w y , P 2 l
t ) G v 5 x C : e F Z ] X % k J H ; [ U i d
E N $ a b T ! 6 D h ( & g f u A K W # 1 V n B I + o _ 8 s Q 4 / 7 S ` L c > \ m p ' 3 @ q R j r .
If no output file is specified, the name is formed by adding .c to the
input file name, after stripping off .pgc if present.
Report bugs to <pgsql-bugs@postgresql.org>.
--regression run in regression testing mode
-?, --help show this help, then exit
-C MODE set compatibility mode; MODE can be one of
"INFORMIX", "INFORMIX_SE"
-D SYMBOL define SYMBOL
-I DIRECTORY search DIRECTORY for include files
-V, --version output version information, then exit
-c automatically generate C code from embedded SQL code;
this affects EXEC SQL TYPE
-d generate parser debug output
-h parse a header file, this option includes option "-c"
-i parse system include files as well
-o OUTFILE write result to OUTFILE
-r OPTION specify run-time behavior; OPTION can be:
"no_indicator", "prepare", "questionmarks"
-t turn on autocommit of transactions
%s at or near "%s" %s is the PostgreSQL embedded SQL preprocessor for C programs.
%s, the PostgreSQL embedded C preprocessor, version %d.%d.%d
%s: could not locate my own executable path
%s: could not open file "%s": %s
%s: no input files specified
%s: parser debug support (-d) not available
AT option not allowed in CLOSE DATABASE statement AT option not allowed in CONNECT statement AT option not allowed in DISCONNECT statement AT option not allowed in SET CONNECTION statement AT option not allowed in TYPE statement AT option not allowed in VAR statement AT option not allowed in WHENEVER statement COPY FROM STDIN is not implemented CREATE TABLE AS cannot specify INTO ERROR: EXEC SQL INCLUDE ... search starts here:
Error: include path "%s/%s" is too long on line %d, skipping
Options:
SHOW ALL is not implemented Try "%s --help" for more information.
Unix-domain sockets only work on "localhost" but not on "%s" Usage:
%s [OPTION]... FILE...
WARNING: arrays of indicators are not allowed on input could not open include file "%s" on line %d could not remove output file "%s"
cursor "%s" does not exist cursor "%s" has been declared but not opened cursor "%s" is already defined descriptor "%s" does not exist descriptor header item "%d" does not exist descriptor item "%s" cannot be set descriptor item "%s" is not implemented end of search list
expected "://", found "%s" expected "@" or "://", found "%s" expected "@", found "%s" expected "postgresql", found "%s" incomplete statement incorrectly formed variable "%s" indicator for array/pointer has to be array/pointer indicator for simple data type has to be simple indicator for struct has to be a struct indicator variable "%s" is hidden by a local variable indicator variable "%s" is hidden by a local variable of a different type indicator variable must have an integer type initializer not allowed in EXEC SQL VAR command initializer not allowed in type definition internal error: unreachable state; please report this to <pgsql-bugs@postgresql.org> interval specification not allowed here invalid bit string literal invalid connection type: %s invalid data type key_member is always 0 missing "EXEC SQL ENDIF;" missing identifier in EXEC SQL DEFINE command missing identifier in EXEC SQL IFDEF command missing identifier in EXEC SQL UNDEF command missing matching "EXEC SQL IFDEF" / "EXEC SQL IFNDEF" more than one EXEC SQL ELSE multidimensional arrays are not supported multidimensional arrays for simple data types are not supported multidimensional arrays for structures are not supported multilevel pointers (more than 2 levels) are not supported; found %d level multilevel pointers (more than 2 levels) are not supported; found %d levels nested /* ... */ comments nested arrays are not supported (except strings) no longer supported LIMIT #,# syntax passed to server nullable is always 1 only data types numeric and decimal have precision/scale argument only protocols "tcp" and "unix" and database type "postgresql" are supported operator not allowed in variable definition out of memory pointer to pointer is not supported for this data type pointers to varchar are not implemented subquery in FROM must have an alias syntax error syntax error in EXEC SQL INCLUDE command too many levels in nested structure/union definition too many nested EXEC SQL IFDEF conditions type "%s" is already defined type name "string" is reserved in Informix mode unmatched EXEC SQL ENDIF unrecognized data type name "%s" unrecognized descriptor item code %d unrecognized token "%s" unrecognized variable type code %d unsupported feature will be passed to server unterminated /* comment unterminated bit string literal unterminated hexadecimal string literal unterminated quoted identifier unterminated quoted string using unsupported DESCRIBE statement using variable "%s" in different declare statements is not supported variable "%s" is hidden by a local variable variable "%s" is hidden by a local variable of a different type variable "%s" is neither a structure nor a union variable "%s" is not a pointer variable "%s" is not a pointer to a structure or a union variable "%s" is not an array variable "%s" is not declared variable "%s" must have a numeric type zero-length delimited identifier Project-Id-Version: PostgreSQL 9.6.3
Report-Msgid-Bugs-To: pgsql-bugs@postgresql.org
POT-Creation-Date: 2017-04-03 13:17+0900
PO-Revision-Date: 2017-02-01 18:37+0900
Last-Translator: Ideriha Takeshi <ideriha.takeshi@jp.fujitsu.com>
Language-Team: jpug-doc <jpug-doc@ml.postgresql.jp>
Language: ja
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Plural-Forms: nplurals=2; plural=n != 1;
出力ファイルが指定されていない場合、入力ファイルの名前に.cを付けた名前になります。
ただし、もし.pgcがある場合はこれを取り除いてから.cが付けられます。
不具合は<pgsql-bugs@postgresql.org>に報告してください。
--regression リグレッション試験モードで実行します
-?, --help このヘルプを表示し、終了します
-C モード 互換モードを設定します。モードは"INFORMIX", "INFORMIX_SE"
のいずれかを設定することができます
-D シンボル シンボルを定義します
-I ディレクトリ インクルードファイルの検索にディレクトリを使用します
-V, --version バージョン情報を表示し、終了します
-c 埋め込まれたSQLコードを元にC言語コードを自動的に生成します
これはEXEC SQL TYPEに影響を与えます
-d パーサのデバッグ出力を有効にします
-h ヘッダファイルを解析します。このオプションには"-c"オプションが含まれます
-i システムインクルードファイルも同時に解析します
-o 出力ファイル 結果を出力ファイルに書き出します
-r OPTION 実行時の動作を指定します。オプションは次のいずれかを取ることができます。
"no_indicator"、"prepare"、"questionmarks"
-t トランザクションの自動コミットを有効にします
"%2$s"またはその近辺で%1$s %sはCプログラム用のPostgreSQL埋込みSQLプリプロセッサです。
%s PostgreSQL埋込みC言語プリプロセッサ バージョン%d.%d.%d
%s: 自身の実行可能パスを見つけられませんでした
%s: ファイル"%s"をオープンできませんでした: %s
%s: 入力ファイルが指定されていません
%s: パーサデバッグのサポート(-d)を利用できません
CLOSE DATABASE文ではATオプションは許されません CONNECT文ではATオプションは許されません DISCONNECT文ではATオプションは許されません SET CONNECTION文ではATオプションは許されません TYPE文ではATオプションは許されません VAR文ではATオプションは許されません WHENEVER文ではATオプションは許されません COPY FROM STDINは実装されていません CREATE TABLE ASはINTOを指定できません エラー: EXEC SQL INCLUDE ... 検索が始まります
エラー:行番号%3$dのインクルードパス"%1$s/%2$s"が長すぎます。無視しました。
オプション:
SHOW ALLは実装されていません 詳細は"%s --help"を実行してください。
Unixドメインソケットは"localhost"でのみで動作し、"%s"では動作しません 使用方法:
%s [オプション]... ファイル...
警告: 指示子配列は入力として許されません 行番号%2$dのインクルードファイル"%1$s"をオープンすることができませんでした 出力ファイル"%s"を削除できませんでした
カーソル"%s"は存在しません カーソル%sは宣言されましたが、オープンされていません カーソル"%s"はすでに定義されています %s記述子は存在しません 記述子ヘッダ項目%dは存在しません 記述子項目%sは設定できません 記述子項目%sは実装されていません 検索リストの終端です
想定では"://"、結果では"%s" 想定では"@または""://"、結果では"%s" 想定では"@"、結果では"%s" 想定では"postgresql"、結果では"%s" 不完全な文 正しく成形されていない変数"%s"です 配列/ポインタ用の指示子は配列/ポインタでなければなりません 単純なデータ型用の指示子は単純なものでなければなりません 構造体用の指示子は構造体でなければなりません 指示子変数"%s"はローカル変数により不可視になっています 指示子変数"%s"は、異なった型を持つローカル変数により不可視になっています 指示子変数は整数型でなければなりません EXEC SQL VARコマンドではイニシャライザは許されません 型定義ではイニシャライザは許されません 内部エラー: 到達しないはずの状態です。<pgsql-bugs@postgresql.org>まで報告してください 時間間隔の指定はここでは許されません 無効なビット列リテラルです 無効な接続種類: %s 無効なデータ型 key_memberは常に0です "EXEC SQL ENDIF;"がありません EXEC SQL DEFINEコマンドにおいて識別子がありません EXEC SQL IFDEFコマンドにおいて識別子がありません EXEC SQL UNDEFコマンドにおいて識別子がありません 対応する"EXEC SQL IFDEF" / "EXEC SQL IFNDEF"がありません 1つ以上のEXEC SQL ELSE"が存在します 多次元配列はサポートされません 単純なデータ型の多次元配列はサポートされていません 構造体の多次元配列はサポートされていません 複数レベルのポインタ（2レベル以上）はサポートされません。%dレベルあります 複数レベルのポインタ（2レベル以上）はサポートされません。%dレベルあります 入れ子になったコメント /* ... */ です 入れ子状の配列はサポートされません（文字列は除きます） サーバに渡されるLIMIT #,#構文はもはやサポートされていません nullableは常に1です 数値データ型または10進数データ型のみが精度/位取り引数と取ることができます プロトコルでは"tcp"および"unix"のみ、データベースの種類では"postgresql"のみがサポートされています 変数定義では演算子は許されません メモリ不足です このデータ型では、ポインタを指し示すポインタはサポートされていません varcharを指し示すポインタは実装されていません FROM句の副問い合わせは別名を持たなければなりません 構文エラー EXEC SQL INCLUDEコマンドにおいて構文エラーがあります 構造体/ユニオンの定義の入れ子レベルが深すぎます 入れ子状のEXEC SQL IFDEF条件が多すぎます "%s"型はすでに定義されています 型名"string"はInformixモードですでに予約されています EXEC SQL ENDIFに対応するものがありません データ型名"%s"は認識できません 認識できない記述子項目コード%dです 認識できないトークン"%s" 認識できない変数型コード%d サーバに未サポート機能が渡されます /*コメントが閉じていません ビット文字列リテラルの終端がありません 16進数文字列リテラルの終端がありません 識別子の引用符が閉じていません 文字列の引用符が閉じていません 未サポートのDESCRIBE文の使用 異なったdeclareステートメントにおける変数"%s"の使用はサポートされていません 変数"%s"はローカル変数により不可視になっています 変数"%s"は、異なった型を持つローカル変数により不可視になっています 変数"%s"は構造体でもユニオンでもありません 変数"%s"はポインタではありません 変数"%s"は構造体またはユニオンを指し示すポインタではありません 変数"%s"は配列ではありません 変数"%s"は宣言されていません 変数"%s"は数値型でなければなりません 区切りつき識別子の長さがゼロです locale/ja/LC_MESSAGES/pg_rewind-9.6.mo 0000644 00000054232 14751153420 0013017 0 ustar 00 �� � � � H
- I
1 w
? �
K �
C 5 ; y C � 9 � G 3 @ { � O � 1 M j � � J � > � , ( 6 U < � 1 � ? � = ; = y 9 � D � 4 6 9 k 4 � 2 � @
R N > � � � 1 : L V p o � d � - _ 4 � & � � � P � R � c * - � � � / � ; ) e z # � � % � $ $ + I u $ � L � , 0 2 " c ) � , � � $ � $ # E ' i " � � " � & � $ A ( a � " � ' � � 2 O 2 h � ' � � / - 0 ^ 6 | � ; � ) . + K % w � ! � 3 � 6 ! 1 H! z! ' �! < �! _ �! ^" r" ! �" F �" �" # # C 5# " y# . �# # �# > �# 6 .$ 3 e$ 6 �$ 0 �$ % + % & H% o% �% ! �% ( �% I �% $ D& ' i& �& - �& J �& = '' A e' 6 �' 5 �' 5 ( ! J( 7 l( / �( 6 �( 1 ) - =) 9 k) � �) J 5+ G �+ X �+ T !, ? v, J �, T - O V- P �- I �- A. � U. / �. 3 / 8 I/ & �/ �/ �/ W �/ a 0 G 0 V �0 e 1 \ �1 F �1 ` (2 T �2 V �2 Y 53 D �3 Z �3 U /4 p �4 | �4 � s5 t 6
x6 - �6 R �6 % 7 *7 % <7 , b7 � �7 � <8 < �8 J 59 3 �9 * �9 � �9 � �: � b; � �; O �< @ �< " = ? 4= C t= �= $ �= B �= > @> K > . �> < �> H 7? @ �? G �? v @ ? �@ C �@ B A M GA N �A > �A T #B K xB 9 �B = �B < <C 8 yC 6 �C G �C < 1D 6 nD G �D 9 �D M 'E H uE : �E 5 �E ; /F . kF B �F 7 �F C G 6 YG S �G ? �G . $H P SH " �H b �H H *I 1 sI ? �I 4 �I + J / FJ [ vJ _ �J j 2K 2 �K = �K p L � L + M 7M " NM o qM 1 �M : N @ NN l �N 4 �N N 1O / �O m �O U P O tP [ �P g Q + �Q I �Q > �Q @ =R = ~R , �R [ �R � ES / �S G �S * AT P lT b �T J U h kU b �U F 7V I ~V + �V R �V F GW N �W C �W : !X = \X ' � z ! < V $ @ � � + ) ] 1 W � b L D ( � A � | T � 7 h � * - H � n j � � �
� k _ r � y v u t N � � R a � Z ^ F P & { > : O Y � S c g s ` 6 [ K J 4 � i f B � � w . G 0 d Q / � � x � } \ � = � e E p 8 ~ % � # ? , � I � m l U o C
9 M � � X 2 ; q 5 3 "
Report bugs to <pgsql-bugs@postgresql.org>.
creating backup label and updating control file
--debug write a lot of debug messages
--source-pgdata=DIRECTORY source data directory to synchronize with
--source-server=CONNSTR source server to synchronize with
-?, --help show this help, then exit
-D, --target-pgdata=DIRECTORY existing data directory to modify
-P, --progress write progress messages
-V, --version output version information, then exit
-n, --dry-run stop before modifying anything
block %u
"%s" is a symbolic link, but symbolic links are not supported on this platform
"%s" is not a directory
"%s" is not a regular file
"%s" is not a symbolic link
%*s/%s kB (%d%%) copied %d: %X/%X - %X/%X
%s (%s)
%s resynchronizes a PostgreSQL cluster with another copy of the cluster.
%s: WARNING: cannot create restricted tokens on this platform
%s: could not allocate SIDs: error code %lu
%s: could not create restricted token: error code %lu
%s: could not get exit code from subprocess: error code %lu
%s: could not open process token: error code %lu
%s: could not re-execute with restricted token: error code %lu
%s: could not start process for command "%s": error code %lu
%s: no source specified (--source-pgdata or --source-server)
%s: no target data directory specified (--target-pgdata)
%s: only one of --source-pgdata or --source-server can be specified
%s: too many command-line arguments (first is "%s")
BKPBLOCK_HAS_DATA not set, but data length is %u at %X/%X BKPBLOCK_HAS_DATA set, but no data included at %X/%X BKPBLOCK_SAME_REL set but no previous rel at %X/%X BKPIMAGE_HAS_HOLE not set, but hole offset %u length %u at %X/%X BKPIMAGE_HAS_HOLE set, but hole offset %u length %u block image length %u at %X/%X BKPIMAGE_IS_COMPRESSED set, but block image length %u at %X/%X Done!
Expected a numeric timeline ID.
Expected a transaction log switchpoint location.
Failure, exiting
Options:
Source timeline history:
Target timeline history:
The program "initdb" is needed by %s but was
not found in the same directory as "%s".
Check your installation.
The program "initdb" was found by "%s"
but was not the same version as %s.
Check your installation.
Timeline IDs must be in increasing sequence.
Timeline IDs must be less than child timeline's ID.
Try "%s --help" for more information.
Usage:
%s [OPTION]...
WAL file is from different database system: WAL file database system identifier is %s, pg_control database system identifier is %s WAL file is from different database system: incorrect XLOG_BLCKSZ in page header WAL file is from different database system: incorrect XLOG_SEG_SIZE in page header WAL record modifies a relation, but record type is not recognized
lsn: %X/%X, rmgr: %s, info: %02X
You must run %s as the PostgreSQL superuser.
backup label buffer too small
cannot be executed by "root"
cannot duplicate null pointer (internal error)
clusters are not compatible with this version of pg_rewind
connected to server
contrecord is requested by %X/%X could not close directory "%s": %s
could not close file "%s": %s
could not close target file "%s": %s
could not connect to server: %s could not create directory "%s": %s
could not create symbolic link at "%s": %s
could not fetch file list: %s could not fetch remote file "%s": %s could not find common ancestor of the source and target cluster's timelines
could not find previous WAL record at %X/%X
could not find previous WAL record at %X/%X: %s
could not open directory "%s": %s
could not open file "%s" for reading: %s
could not open file "%s" for truncation: %s
could not open file "%s": %s
could not open source file "%s": %s
could not open target file "%s": %s
could not read WAL record at %X/%X
could not read WAL record at %X/%X: %s
could not read directory "%s": %s
could not read file "%s": %s
could not read from file "%s": %s
could not read symbolic link "%s": %s
could not remove directory "%s": %s
could not remove file "%s": %s
could not remove symbolic link "%s": %s
could not seek in file "%s": %s
could not seek in source file: %s
could not seek in target file "%s": %s
could not send COPY data: %s could not send end-of-COPY: %s could not send file list: %s could not send query: %s could not set libpq connection to single row mode
could not stat file "%s": %s
could not truncate file "%s" to %u: %s
could not write file "%s": %s
data file "%s" in source is not a regular file
error running query (%s) in source server: %s fetched file "%s", length %d
full_page_writes must be enabled in the source server
getting file chunks
incorrect resource manager data checksum in record at %X/%X invalid action (CREATE) for regular file
invalid block_id %u at %X/%X invalid compressed image at %X/%X, block %d invalid contrecord length %u at %X/%X invalid data in history file
invalid data in history file: %s
invalid info bits %04X in log segment %s, offset %u invalid magic number %04X in log segment %s, offset %u invalid record length at %X/%X: wanted %u, got %u invalid record offset at %X/%X invalid resource manager ID %u at %X/%X need to copy %lu MB (total source directory size is %lu MB)
neither BKPIMAGE_HAS_HOLE nor BKPIMAGE_IS_COMPRESSED set, but block image length is %u at %X/%X no rewind required
out of memory
out-of-order block_id %u at %X/%X out-of-sequence timeline ID %u (after %u) in log segment %s, offset %u reading WAL in target
reading source file list
reading target file list
received null value for chunk for file "%s", file has been deleted
record length %u at %X/%X too long record with incorrect prev-link %X/%X at %X/%X record with invalid length at %X/%X rewinding from last common checkpoint at %X/%X on timeline %u
servers diverged at WAL position %X/%X on timeline %u
source and target cluster are on the same timeline
source and target clusters are from different systems
source data directory must be shut down cleanly
source file list is empty
source server must not be in recovery mode
symbolic link "%s" target is too long
sync of target directory failed
syncing target data directory
syntax error in history file: %s
target server must be shut down cleanly
target server needs to use either data checksums or "wal_log_hints = on"
there is no contrecord flag at %X/%X unexpected EOF while reading file "%s"
unexpected control file CRC
unexpected control file size %d, expected %d
unexpected data types in result set while fetching remote files: %u %u %u
unexpected null values in result while fetching remote files
unexpected page modification for directory or symbolic link "%s"
unexpected pageaddr %X/%X in log segment %s, offset %u unexpected result format while fetching remote files
unexpected result length while fetching remote files
unexpected result set from query
unexpected result set size while fetching remote files
unexpected result set while fetching file list
unexpected result set while fetching remote file "%s"
unexpected result while fetching remote files: %s unexpected result while sending file list: %s unrecognized result "%s" for current WAL insert location
Project-Id-Version: pg_rewind (PostgreSQL) 9.6.3
Report-Msgid-Bugs-To: pgsql-bugs@postgresql.org
POT-Creation-Date: 2019-11-09 07:43+0000
PO-Revision-Date: 2016-MO-DA HO:MI+ZONE
Last-Translator: Daisuke Higuchi <higuchi.daisuke@jp.fujitsu.com>
Language-Team: jpug-doc <jpug-doc@ml.postgresql.jp>
Language: ja
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
不具合は<pgsql-bugs@postgresql.org>まで報告してください。
backup labelを作成して制御ファイルを更新しています
--debug 多くのデバッグメッセージを出力します
--source-pgdata=DIRECTORY 同期するソースデータのディレクトリ
--source-server=CONNSTR 同期するソースサーバ
-?, --help このヘルプを表示し、終了します
-D, --target-pgdata=DIRECTORY 既存のデータディレクトリを修正する
-P, --progress 進行中のメッセージを出力します
-V, --version バージョン情報を表示し、終了します
-n, --dry-run 何かを修正する前に停止する
ブロック数 %u
"%s"はシンボリックリンクですが、このプラットフォームではシンボリックリンクをサポートしていません
"%s"はディレクトリではありません
"%s" は通常のファイルではありません
"%s"はシンボリックリンクではありません
%*s/%s kB (%d%%) コピーしました %d: %X/%X - %X/%X
%s (%s)
%s はPostgreSQLクラスタをそのクラスタのコピーで再同期します。
%s: 警告: このプラットフォームでは制限付きトークンを作成できません
%s: SIDを割り当てられませんでした: エラーコード %lu
%s: 制限付きトークンを作成できませんでした: エラーコード %lu
%s: サブプロセスの終了コードを入手できませんでした。: エラーコード %lu
%s: プロセストークンをオープンできませんでした: エラーコード %lu
%s: 制限付きトークンで再実行できませんでした: %lu
%s: "%s"コマンド用のプロセスを起動できませんでした: エラーコード %lu
%s: ソースが特定されていません（--source-pgdata or --source-server）
%s: データディレクトリ対象が指定されていません (--target-pgdata)
%s: --source-pgdata か --source-server のいずれかのみを指定してください
%s: コマンドライン引数が多すぎます。(始めは"%s")
BKPBLOCK_HAS_DATAが設定されていませんが、%2$X/%3$Xのデータ長は%1$uです BKPBLOCK_HAS_DATAが設定されていますが、%X/%Xにデータがありません BKPBLOCK_SAME_RELが設定されていますが、%X/%Xにおいて以前のリレーションがありません BKPIMAGE_HAS_HOLEが設定されていませんが、%3$X/%4$Xにおけるホールオフセット%1$uの長さが%2$uです BKPIMAGE_HAS_HOLEが設定されていますが、%4$X/%5$Xでホールオフセット%1$u、長さ%2$u、ブロックイメージ長%3$uです BKPIMAGE_IS_COMPRESSEDが設定されていますが、%2$X/%3$Xにおいてブロックイメージ長が%1$uです 完了！
数字の時系列IDを想定しました。
トランザクションログの切替えポイントを想定しています。
失敗しました、終了します
オプション:
ソースタイムラインの履歴
ターゲットタイムラインの履歴:
%sには "initdb" プログラムが必要ですが、"%s"と同じディレクトリ
にありませんでした。
インストール状況を確認してください。
"%s"がプログラム "initdb" を見つけましたが、これは%sと同じ
バージョンではありませんでした。
インストレーションを検査してください。
時系列IDは昇順の並びでなければなりません
時系列IDは副時系列IDより小さくなければなりません。
詳細は"%s --help"を実行してください。
使用方法:
" %s [オプション]...
WAL ファイルは異なるデータベースシステム由来ものです: WAL ファイルにおけるデータベースシステムの識別子は %s で、pg_control におけるデータベースシステムの識別子は %s です。 WAL ファイルは異なるデータベースシステム由来のものです: ページヘッダーのXLOG_BLCKSZが正しくありません WAL ファイルは異なるデータベースシステム由来のものです: ページヘッダーのXLOG_SEG_SIZEが正しくありません WALレコードはリレーションを修正しますが、レコードの型を認識できません。
lsn: %X/%X, rmgr: %s, info: %02X
PostgreSQLのスーパーユーザで%sを実行しなければなりません
バックアップラベルのバッファが小さすぎます
"root"では実行できません
null ポインタを複製できません（内部エラー）
クラスタが、pg_rewindのバージョンと一致しません
サーバへ接続しました
%X/%Xではcontrecordが必要です ディレクトリ"%s"をクローズできませんでした: %s
ファイル "%s" をクローズできませんでした: %s
ターゲットファイル"%s"をクローズできませんでした: %s
サーバに接続できませんでした: %s ディレクトリ"%s"を作成できませんでした: %s
"%s"でシンボリックリンクを作成できませんでした: %s
ファイルリストをフェッチできませんでした: %s リモートファイル"%s"をフェッチできませんでした: %s ソースクラスタ、ターゲットクラスタのタイムラインの共通の祖先を見つけられません
%X/%Xで前のWALレコードが見つかりませんでした
%X/%Xで前のWALレコードが見つかりませんでした: %s
ディレクトリ"%s"をオープンできませんでした: %s
読み取り用のファイル"%s"をオープンできませんでした:%s
ファイル"%s"を切り詰め用にオープンできませんでした: %s
ファイル "%s" をオープンできませんでした: %s
ソースファイル"%s"をオープンすることができませんでした: %s
ターゲットファイル"%s"をオープンできませんでした: %s
%X/%XでWALレコードを読み取れませんでした
%X/%XでWALレコードを読み取れませんでした: %s
ディレクトリ"%s"を読み取れませんでした: %s
ファイル "%s" を読み込めませんでした: %s
ファイル"%s"を読み込めませんでした: %s
シンボリックリンク "%s" を読み込めませんでした: %s
ディレクトリ"%s"を削除できませんでした: %s
ファイル"%s"を削除できませんでした: %s
シンボリックリンク "%s" を削除できませんでした: %s
ファイル"%s"をシークできませんでした: %s
ソースファイルをシークすることができませんでした: %s
ターゲットファイル"%s"をシークできませんでした: %s
COPY 対象データを送信できませんでした：%s コピー終端を送信できませんでした：%s ファイルリストを送信できませんでした：%s クエリを送信できませんでした: %s libpq接続を単一行モードに設定できませんでした
ファイル"%s"のstatができませんでした: %s
ファイル "%s" を%uに切り詰められませんでした: %s
ファイル"%s"に書き込めませんでした: %s
ソースのデータファイル"%s"は通常のファイルではありません
ソースサーバの実行中のクエリ(%s)でエラー：%s フェッチしたファイル "%s",長さ %d
ソースサーバではfull_pate_writesは有効でなければなりません
ファイルチャンクの取得
%X/%Xのレコード内のリソースマネージャデータのチェックサムが不正です 通常のファイルに対する不正なアクション(CREATE)です
%2$X/%3$Xにおけるblock_id %1$uが無効です %X/%X、ブロック %d での圧縮イメージが無効です %2$X/%3$Xのcontrecordの長さ %1$u が無効です 履歴ファイル内の無効なデータ
履歴ファイル内の無効なデータ: %s
ログセグメント %2$s、オフセット %3$u の情報ビット %1$04X は無効です ログセグメント%2$s、オフセット%3$uのマジックナンバー%1$04Xは無効です %X/%Xのレコード長が無効です:長さは%uである必要がありますが、長さは%uでした %X/%Xのレコードオフセットが無効です %2$X/%3$XのリソースマネージャID %1$uが無効です %lu MBをコピーする必要があります（ソースディレクトリサイズの合計は%lu MBです）
BKPIMAGE_HAS_HOLEもBKPIMAGE_IS_COMPRESSEDも設定されていませんが、%2$X/%3$Xにおいてブロックイメージ長が%1$uです 巻き戻しは必要ではありません
メモリ不足です
block_id %uが%X/%Xで無効です ログセグメント%3$s、オフセット%4$uの時系列ID %1$u(%2$uの後)は順序に従っていません ターゲットでWALを読み込んでいます
ソースファイルリストを読み込んでいます
ターゲットファイルリストを読み込んでいます
ファイル"%s"のNULL値のチャンクを受け取りました。ファイルは削除されました。
%2$X/%3$Xのレコード長%1$uが大きすぎます 直前のリンク%1$X/%2$Xが不正なレコードが%3$X/%4$Xにあります %X/%Xのレコードのサイズが無効です タイムライン%3$uの %1$X/%2$X で最新の共通チェックポイントから巻き戻しています
タイムライン%3$uの WALの位置 %1$X/%2$Xでサーバが分岐しています
変換元と変換先のクラスタが同一タイムラインにあります
ソースクラスタとターゲットクラスタは異なるシステムのものです
ソースデータディレクトリはきれいにシャットダウンしなければなりません
ソースファイルリストが空です
ソースサーバはリカバリモードであってはなりません
シンボリックリンク"%s"の参照先は長すぎます
ターゲットディレクトリの同期が失敗しました
同期しているターゲットデータディレクトリ
履歴ファイル内の構文エラー: %s
ターゲットサーバはきれいにシャットダウンしなければなりません
ターゲットサーバはデータチェックサムを利用するあるいは"wal_log_hints = onである必要があります
%X/%Xで contrecord フラグがありません ファイル"%s"を読み込み中に想定外のEOFがありました
想定外の制御ファイル CRC です
想定外の制御ファイルのサイズ%dです、その期待値は%dです
リモートファイルをフェッチ中の結果セットに想定外のデータ型: %u %u %u
リモートファイルをフェッチ中の結果に想定外のNULL値
ディレクトリまたはシンボリックリンク"%s"に対する想定外のページ修正です
ログセグメント%3$s、オフセット%4$uのページアドレス%1$X/%2$Xは想定外です リモートファイルをフェッチ中に想定外の結果形式
リモートファイルをフェッチ中に想定外の結果の長さ
クエリから想定外の結果セット
リモートファイルをフェッチ中に想定外の結果セットサイズ
ファイルリストをフェッチ中に想定外の結果セット
リモートファイル "%s"をフェッチ中に想定外の結果セット
リモートファイルをフェッチ中に想定外の結果: %s ファイルリストを送信中に想定外の結果: %s 現在のWALの挿入場所に対する未知の結果 "%s"
locale/ja/LC_MESSAGES/initdb-9.6.mo 0000644 00000065733 14751153420 0012322 0 ustar 00 �� � \ � �
( R ) |
� � - � � � ` n � � W � W � B A I 5 � J � 6 ( P _ C � : � Q / 5 � ] � 4 B J H � G � > 4 ] 9 � 3 � ? / @ - p > � y � ( W # � 7 � ( � 6 , < ' i 5 � F � " ( 1 < Z 8 � & � - � - % ! S 1 u ? � & � / = > ! | / � " � 6 � + ( T 0 k ; � $ � / � & - T $ r ~ � 1 < H � 3 � 8 � ( J 9 � � L! C _! - �! 8 �! !
" , ," / Y" 4 �" A �" @ # R A# K �# " �# ! $ � %$ d �$ % !% � @% [ �% R & K s& % �& �& �& ' ; 4' ; p' � �' @ =( ; ~( �( u �) q A* f �* s + & �+ �+ ) �+ t �+ / \, �, & �, 0 �, . �, ) "- ) L- v- �- " �- # �- & �-
. $ .. ( S. " |. �. " �. ! �. , �. $ ,/ * Q/ % |/ �/ ! �/ �/ �/ 0 -0 N0 k0 - �0 0 �0 �0 1 1 * 41 ) _1 �1 �1 �1 �1 & �1 % �1 2 + 12 ]2 ! w2 � �2 e :4 ' �4 �4 �4 J �4 � E5 � 6 �6 e �7 h J8 s �8 c ': 7 �: s �: 7; J S; _ �; b �; J a< a �< T = m c= S �= P %> h v> \ �> P <? V �? J �? ; /@ J k@ F �@ : �@ a 8A � �A F NB @ �B I �B C C V dC I �C 7 D N =D T �D 9 �D H E e dE W �E F "F Q iF Q �F @
G \ NG F �G R �G a EH ` �H C I G LI < �I Q �I K #J & oJ G �J \ �J > ;K S zK G �K ' L 7 >L � vL M ,M = zM * �M U �M O 9N A �N j �N B 6O yP b �P E �P Z =Q < �Q Q �Q d 'R D �R f �R q 8S m �S Q T : jT : �T � �T � �U VV L sV � �V � �W � X } �X @ ,Y ( mY A �Y 1 �Y j
Z M uZ � �Z c p[ K �[ U \ � v] � #^ � �^ � �_ 0 -` ^` X m` � �` B �a " �a 8 b A :b 1 |b 5 �b 5 �b 0 c $ Kc 7 pc 8 �c ; �c + d 6 Id @ �d E �d 1 e ? 9e F ye ] �e 6 f f Uf A �f ) �f / (g # Xg / |g 1 �g / �g 5 h 2 Dh D wh : �h , �h ) $i Ni A ni G �i @ �i 9j =j Tj > tj ? �j , �j D k 3 ek A �k � � $ 7 � _ v ` � { z 2 M w � + � = f 8 � . R * & ! ' � � E � � P - d # � ? , O � 9 ] I � U � i h 6 \ ; " ~ L � Q 5 � N s 1 � � j
� � J A u ( x m � B � � | Z t > 0 � : } < ) � o p b �
� l q / T % � � F g � K � H ^ W � 3 V c � � D k G � X @ Y 4 S a e n � � y r � � C � [
If the data directory is not specified, the environment variable PGDATA
is used.
Less commonly used options:
Options:
Other options:
Report bugs to <pgsql-bugs@postgresql.org>.
Success. You can now start the database server using:
%s%s%spostgres%s -D %s%s%s
or
%s%s%spg_ctl%s -D %s%s%s -l logfile start
Sync to disk skipped.
The data directory might become corrupt if the operating system crashes.
WARNING: enabling "trust" authentication for local connections
You can change this by editing pg_hba.conf or using the option -A, or
--auth-local and --auth-host, the next time you run initdb.
--auth-host=METHOD default authentication method for local TCP/IP connections
--auth-local=METHOD default authentication method for local-socket connections
--lc-collate=, --lc-ctype=, --lc-messages=LOCALE
--lc-monetary=, --lc-numeric=, --lc-time=LOCALE
set default locale in the respective category for
new databases (default taken from environment)
--locale=LOCALE set default locale for new databases
--no-locale equivalent to --locale=C
--pwfile=FILE read password for the new superuser from file
%s [OPTION]... [DATADIR]
-?, --help show this help, then exit
-A, --auth=METHOD default authentication method for local connections
-E, --encoding=ENCODING set default encoding for new databases
-L DIRECTORY where to find the input files
-N, --nosync do not wait for changes to be written safely to disk
-S, --sync-only only sync data directory
-T, --text-search-config=CFG
default text search configuration
-U, --username=NAME database superuser name
-V, --version output version information, then exit
-W, --pwprompt prompt for a password for the new superuser
-X, --xlogdir=XLOGDIR location for the transaction log directory
-d, --debug generate lots of debugging output
-k, --data-checksums use data page checksums
-n, --noclean do not clean up after errors
-s, --show show internal settings
[-D, --pgdata=]DATADIR location for this database cluster
%s initializes a PostgreSQL database cluster.
%s: "%s" is not a valid server encoding name
%s: WARNING: cannot create restricted tokens on this platform
%s: cannot be run as root
Please log in (using, e.g., "su") as the (unprivileged) user that will
own the server process.
%s: could not access directory "%s": %s
%s: could not access file "%s": %s
%s: could not change permissions of directory "%s": %s
%s: could not create directory "%s": %s
%s: could not create restricted token: error code %lu
%s: could not create symbolic link "%s": %s
%s: could not execute command "%s": %s
%s: could not find suitable encoding for locale "%s"
%s: could not find suitable text search configuration for locale "%s"
%s: could not fsync file "%s": %s
%s: could not get current user name: %s
%s: could not get exit code from subprocess: error code %lu
%s: could not obtain information about current user: %s
%s: could not open directory "%s": %s
%s: could not open file "%s" for reading: %s
%s: could not open file "%s" for writing: %s
%s: could not open file "%s": %s
%s: could not open process token: error code %lu
%s: could not re-execute with restricted token: error code %lu
%s: could not read directory "%s": %s
%s: could not read password from file "%s": %s
%s: could not start process for command "%s": error code %lu
%s: could not stat file "%s": %s
%s: could not to allocate SIDs: error code %lu
%s: could not write file "%s": %s
%s: data directory "%s" not removed at user's request
%s: directory "%s" exists but is not empty
%s: encoding mismatch
%s: failed to remove contents of data directory
%s: failed to remove contents of transaction log directory
%s: failed to remove data directory
%s: failed to remove transaction log directory
%s: failed to restore old locale "%s"
%s: file "%s" does not exist
%s: file "%s" is not a regular file
%s: input file "%s" does not belong to PostgreSQL %s
Check your installation or specify the correct path using the option -L.
%s: input file location must be an absolute path
%s: invalid authentication method "%s" for "%s" connections
%s: invalid locale name "%s"
%s: locale "%s" requires unsupported encoding "%s"
%s: locale name has non-ASCII characters, skipped: "%s"
%s: locale name too long, skipped: "%s"
%s: must specify a password for the superuser to enable %s authentication
%s: no data directory specified
You must identify the directory where the data for this database system
will reside. Do this with either the invocation option -D or the
environment variable PGDATA.
%s: out of memory
%s: password prompt and password file cannot be specified together
%s: removing contents of data directory "%s"
%s: removing contents of transaction log directory "%s"
%s: removing data directory "%s"
%s: removing transaction log directory "%s"
%s: symlinks are not supported on this platform %s: too many command-line arguments (first is "%s")
%s: transaction log directory "%s" not removed at user's request
%s: transaction log directory location must be an absolute path
%s: warning: specified text search configuration "%s" might not match locale "%s"
%s: warning: suitable text search configuration for locale "%s" is unknown
Data page checksums are disabled.
Data page checksums are enabled.
Encoding "%s" implied by locale is not allowed as a server-side encoding.
The default database encoding will be set to "%s" instead.
Encoding "%s" is not allowed as a server-side encoding.
Rerun %s with a different locale selection.
Enter it again: Enter new superuser password: If you want to create a new database system, either remove or empty
the directory "%s" or run %s
with an argument other than "%s".
If you want to store the transaction log there, either
remove or empty the directory "%s".
It contains a dot-prefixed/invisible file, perhaps due to it being a mount point.
It contains a lost+found directory, perhaps due to it being a mount point.
No usable system locales were found.
Passwords didn't match.
Rerun %s with the -E option.
Running in debug mode.
Running in noclean mode. Mistakes will not be cleaned up.
The database cluster will be initialized with locale "%s".
The database cluster will be initialized with locales
COLLATE: %s
CTYPE: %s
MESSAGES: %s
MONETARY: %s
NUMERIC: %s
TIME: %s
The default database encoding has accordingly been set to "%s".
The default text search configuration will be set to "%s".
The encoding you selected (%s) and the encoding that the
selected locale uses (%s) do not match. This would lead to
misbehavior in various character string processing functions.
Rerun %s and either do not specify an encoding explicitly,
or choose a matching combination.
The files belonging to this database system will be owned by user "%s".
This user must also own the server process.
The program "postgres" is needed by %s but was not found in the
same directory as "%s".
Check your installation.
The program "postgres" was found by "%s"
but was not the same version as %s.
Check your installation.
This might mean you have a corrupted installation or identified
the wrong directory with the invocation option -L.
Try "%s --help" for more information.
Usage:
Use the option "--debug" to see details.
Using a mount point directly as the data directory is not recommended.
Create a subdirectory under the mount point.
cannot duplicate null pointer (internal error)
caught signal
child process exited with exit code %d child process exited with unrecognized status %d child process was terminated by exception 0x%X child process was terminated by signal %d child process was terminated by signal %s command not executable command not found copying template1 to postgres ... copying template1 to template0 ... could not change directory to "%s": %s could not find a "%s" to execute could not get junction for "%s": %s
could not identify current directory: %s could not open directory "%s": %s
could not read binary "%s" could not read directory "%s": %s
could not read symbolic link "%s" could not remove file or directory "%s": %s
could not set junction for "%s": %s
could not stat file or directory "%s": %s
could not write to child process: %s
creating collations ... creating configuration files ... creating conversions ... creating dictionaries ... creating directory %s ... creating information schema ... creating subdirectories ... creating system views ... creating template1 database in %s/base/1 ... fixing permissions on existing directory %s ... initializing dependencies ... initializing pg_authid ... invalid binary "%s" loading PL/pgSQL server-side language ... loading system objects' descriptions ... not supported on this platform
ok
out of memory
pclose failed: %s selecting default max_connections ... selecting default shared_buffers ... setting password ... setting privileges on built-in objects ... syncing data to disk ... vacuuming database template1 ... Project-Id-Version: PostgreSQL 9.0.0rc1
Report-Msgid-Bugs-To: pgsql-bugs@postgresql.org
POT-Creation-Date: 2013-08-18 10:06+0900
PO-Revision-Date: 2013-08-18 10:47+0900
Last-Translator: HOTTA Michihide <hotta@net-newbie.com>
Language-Team: jpug-doc <jpug-doc@ml.postgresql.jp>
Language: ja
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Plural-Forms: nplurals=1; plural=0;
データディレクトリが指定されない場合、PGDATA環境変数が使用されます。
使用頻度の低いオプション:
オプション:
その他のオプション:
不具合は<pgsql-bugs@postgresql.org>まで報告してください。
成功しました。以下を使用してデータベースサーバを起動することができます。
%s%s%spostmaster%s -D %s%s%s
または
%s%s%spg_ctl%s -D %s%s%s -l logfile start
ディスクへの同期がスキップされました。
オペレーティングシステムがクラッシュした場合データディレクトリは破損されるかもしれません。
警告: ローカル接続向けに"trust"認証が有効です。
pg_hba.confを編集する、もしくは、次回initdbを実行する時に-Aオプショ
ン、または、--auth-localおよび--auth-hostを使用することで変更するこ
とができます。
--auth-host=METHOD ローカルなTCP/IP接続向けのデフォルトの認証方式です
--auth-local=METHOD ローカルソケット接続向けのデフォルトの認証方式です
--lc-collate, --lc-ctype, --lc-messages=ロケール名
--lc-monetary, --lc-numeric, --lc-time=ロケール名
新しいデータベースに対応するカテゴリに対する
デフォルトロケールをセット(デフォルト値は
環境変数から選ばれます)
--locale=LOCALE 新しいデータベースのデフォルトロケールをセット
--no-locale --locale=C と同じです
--pwfile=ファイル名 新しいスーパーユーザのパスワードをファイルから読み込む
%s [OPTION]... [DATADIR]
-?, --help このヘルプを表示し、終了します
-A, --auth=METHOD ローカルな接続向けのデフォルトの認証方式です
-E, --encoding=ENCODING 新規データベース用のデフォルトの符号化方式です
-L DIRECTORY 入力ファイルの場所を指定します
-N, --nosync 変更の安全なディスクへの書き出しを待機しません
-S, --sync-only データディレクトリのsyncのみを実行します
-T, --text-search-config=CFG\
デフォルトのテキスト検索設定です
-U, --username=NAME データベーススーパーユーザの名前です
-V, --version バージョン情報を表示し、終了します
-W, --pwprompt 新規スーパーユーザに対してパスワード入力を促します
-X, --xlogdir=XLOGDIR トランザクションログディレクトリの場所です
-d, --debug 多くのデバッグ用の出力を生成します
-k, --data-checksums データページのチェックサムを使用します
-n, --noclean エラー発生後の削除を行いません
-s, --show 内部設定を表示します
[-D, --pgdata=]DATADIR データベースクラスタの場所です
%sはPostgreSQLデータベースクラスタを初期化します。
%s: "%s" は無効なサーバ符号化方式名です。
%s: 警告: このプラットフォームでは制限付きトークンを作成できません
%s: ルートでは実行できません。
サーバプロセスの所有者となる(非特権)ユーザとして(例えば"su"を使用して)ログインしてください。
%s: ディレクトリ"%s"にアクセスできませんでした: %s
%s: ファイル"%s"にアクセスできませんでした: %s
%s: ディレクトリ"%s"の権限を変更できませんでした: %s
%s: ディレクトリ"%s"を作成できませんでした。: %s
%s: 制限付きトークンを作成できませんでした: エラーコード %lu
%s: シンボリックリンク"%s"を作成できませんでした: %s
%s: コマンド"%s"の実効に失敗しました: %s
%s: ロケール"%s"用に適切な符号化方式がありませんでした
%s: ロケール"%s"用の適切なテキスト検索設定が見つかりません
%s: ファイル"%s"をfsyncできませんでした: %s
%s: 現在のユーザ名を得ることができませんでした: %s
%s: サブプロセスの終了コードを入手できませんでした。: エラーコード %lu
%s: 現在のユーザに関する情報を得ることができませんでした: %s
%s: ディレクトリ"%s"をオープンできませんでした: %s
%s: 読み取り用のファイル"%s"をオープンできませんでした:%s
%s:書き込み用のファイル"%s"をオープンできませんでした: %s
%s: ファイル"%s"をオープンできませんでした: %s
%s: プロセストークンをオープンできませんでした: エラーコード %lu
%s: 制限付きトークンで再実行できませんでした: %lu
%s: ディレクトリ"%s"を読み取ることができませんでした。: %s
%s: ファイル"%s"からパスワードを読み取ることができませんでした。: %s
%s: "%s"コマンド用のプロセスを起動できませんでした: エラーコード %lu
%s: "%s"ファイルの状態を確認できませんでした: %s
%s: SIDを割り当てられませんでした: エラーコード %lu
%s:ファイル"%s"の書き込みに失敗しました: %s
%s: ユーザが要求したデータディレクトリ"%s"を削除しません
%s: ディレクトリ"%s"は存在しますが、空ではありません
%s: 符号化方式が合いません
%s: データディレクトリの内容の削除に失敗しました
%s: トランザクションログディレクトリの内容の削除に失敗しました
%s: データディレクトリの削除に失敗しました
%s: トランザクションログディレクトリの削除に失敗しました
%s:古いロケール"%s"を戻すことができませんでした。
%s: ファイル"%s"がありません
%s: "%s" は通常のファイルではありません
%s: 入力ファイル"%s"がPostgreSQL %sにありません
インストレーションを検査し、-Lオプションを使用して正しいパスを指定してください。
%s: 入力ファイルの場所は絶対パスでなければなりません
%1$s: "%3$s"接続では認証方式"%2$s"は無効です。
%s: ロケール名"%s"は無効です。
%s: ロケール"%s"はサポートしない符号化方式"%s"を必要とします
%s: ロケール名に非ASCII文字がありますので飛ばします: "%s"
%s: ロケール名が長過ぎますので飛ばします: "%s"
%s: %s認証を有効にするためにスーパーユーザのパスワードを指定してください
%s: データディレクトリが指定されていません
データベースシステム用のデータを格納するディレクトリを指定しなければなり
ません。-Dオプションを付けて呼び出す、あるいは、PGDATA環境変数を使用する
ことで指定することができます。
%s: メモリ不足です
%s: パスワードプロンプトとパスワードファイルは同時に指定できません
%s: データディレクトリ"%s"の内容を削除しています
%s: トランザクションログディレクトリ"%s"の内容を削除しています
%s: データディレクトリ"%s"を削除しています
%s: トランザクションログディレクトリ"%s"を削除しています
%s: このプラットフォームでシンボリックリンクはサポートされていません %s: コマンドライン引数が多すぎます。(始めは"%s")
%s: ユーザが要求したトランザクションログディレクトリ"%s"を削除しません
%s: トランザクションログのディレクトリの位置は、絶対パスでなければなりません
%s:警告:指定したテキスト検索設定"%s"がロケール"%s"に合わない可能性があります
%s:警告:ロケール"%s"に適したテキスト検索設定が不明です。
データベージのチェックサムは無効です。
データページのチェックサムは有効です。
ロケールにより暗示される符号化方式"%s"はサーバ側の符号化方式として使用できません。
デフォルトのデータベース符号化方式は代わりに"%s"に設定されます。
符号化方式"%s"はサーバ側の符号化方式として使用できません。
別のロケールを選択して%sを再実行してください。
再入力してください: 新しいスーパーユーザのパスワードを入力してください: 新規にデータベースシステムを作成したいのであれば、ディレクトリ"%s"
を削除するか空にしてください。または、%sを"%s"以外の引数で実行して
ください。
そこにトランザクションログを格納したい場合はディレクトリ"%s"を削除するか
空にしてください
先頭がドットまたは不可視なファイルが含まれています。マウントポイントであることが原因かもしれません
lost+foundディレクトリが含まれています。マウントポイントであることが原因かもしれません
使用できるシステムロケールが見つかりません
パスワードが一致しません。
-Eオプションを付けて%sを再実行してください。
デバッグモードで実行しています。
削除を行わないモードで実行しています。失敗した場合でも削除されません。
データベースクラスタはロケール"%s"で初期化されます。
データベースクラスタは以下のロケールで初期化されます。
COLLATE: %s
CTYPE: %s
MESSAGES: %s
MONETARY: %s
NUMERIC: %s
TIME: %s
したがってデフォルトのデータベース符号化方式は%sに設定されました。
デフォルトのテキスト検索設定は%sに設定されました。
選択した符号化方式(%s)と選択したロケールが使用する符号化方式(%s)が
合いません。これにより各種の文字列処理関数が不正な動作をする可能性が
あります。明示的な符号化方式の指定を止めるか合致する組み合わせを
選択して%sを再実行してください
データベースシステム内のファイルの所有者は"%s"ユーザでした。
このユーザがサーバプロセスを所有しなければなりません。
%sでは"postgres"プログラムが必要ですが、"%s"と同じディレクトリにあり
ませんでした。
インストレーションを検査してください。
"postgres"プログラムは"%s"にありましたが、%sと同じバージョンで
はありませんでした。
インストレーションを検査してください。
インストレーションが破損しているか-Lオプションで指定したディ
レクトリが間違っているかを意味する可能性があります。
詳細は"%s --help"を行ってください。
使用方法:
詳細を確認するためには"--debug"オプションを使用してください。
マウントポイントであるディレクトリをデータディレクトリとして使用することは勧めません
マウントポイントの下にサブディレクトリを作成してください
null ポインタを複製できません（内部エラー）。
シグナルが発生しました
子プロセスが終了コード%dで終了しました 子プロセスが未知のステータス%dで終了しました 子プロセスが例外0x%Xで終了しました 子プロセスがシグナル%dで終了しました 子プロセスがシグナル%sで終了しました コマンドは実行形式ではありません コマンドが見つかりません template1からpostgresへコピーしています ... template1からtemplate0へコピーしています ... ディレクトリ"%s"に移動できませんでした: %s 実行する"%s"がありませんでした "%s"のjunctionを入手できませんでした: %s
現在のディレクトリを識別できませんでした: %s ディレクトリ"%s"をオープンできませんでした。: %s
バイナリ"%s"を読み取れませんでした ディレクトリ"%s"を読み取れませんでした。: %s
シンボリックリンク"%s"を読み取りできませんでした "%s"というファイルまたはディレクトリを削除できませんでした。: %s
"%s"のjunctionを設定できませんでした: %s
"%s"というファイルまたはディレクトリの情報を取得できませんでした。: %s
子プロセスへの書き込みができませんでした: %s
照合順序を作成しています ... 設定ファイルを作成しています ... 変換を作成しています ... ディレクトリを作成しています ... ディレクトリ%sを作成しています ... 情報スキーマを作成しています ... サブディレクトリを作成しています ... システムビューを作成しています ... %s/base/1にtemplate1データベースを作成しています ... ディレクトリ%sの権限を設定しています ... 依存関係を初期化しています ... pg_authidを初期化しています ... バイナリ"%s"は無効です PL/pgSQL サーバサイド言語をロードしています ... システムオブジェクトの定義をロードしています ... このプラットフォームではサポートされません
ok
メモリ不足です
pcloseが失敗しました: %s デフォルトのmax_connectionsを選択しています ... デフォルトの shared_buffers を選択しています ... パスワードを設定しています ... 組み込みオブジェクトに権限を設定しています ... データをディスクに同期しています... template1データベースをバキュームしています ... locale/ja/LC_MESSAGES/psql-9.6.mo 0000644 00000322275 14751153420 0012025 0 ustar 00 �� 8 �! � �C 8Z 9Z OZ cZ � |Z $[ @[
Y[ g[ > x[ = �[ < �[ p 2\ s �\ 5 ] 7 M] K �] o �] 2 A^ 4 t^ N �^ t �^ Q m_ O �_ > ` A N` O �` @ �` 6 !a 0 Xa N �a G �a 8 b A Yb T �b ? �b L 0c A }c @ �c H d A Id + �d � �d 5 Me 9 �e n �e Q ,f : ~f � �f ; Fg y �g � �g ; �h z �h T Oi A �i L �i B 3j \ vj 4 �j J k \ Sk 6 �k 4 �k G l = dl ; �l ( �l ; m ; Cm ; m ; �m 8 �m _ 0n J �n F �n ` "o h �o G �o 5 4p 2 jp X �p Q �p : Hq 3 �q ; �q S �q M Gr 9 �r @ �r 8 s ; Is @ �s K �s J t | ]t � �t > `u F �u N �u F 5v H |v - �v $ �v & w - ?w 9 mw 7 �w 2 �w 4 x 3 Gx ) {x ) �x ; �x B y ) Ny * xy * �y J �y 1 z . Kz - zz , �z 4 �z I
{ $ T{ & y{ > �{ 1 �{ & | ( 8| J a| : �| ( �| % } $ 6} $ [} ) �} - �} N �} 9 '~ G a~ 5 �~ M �~ C - P q K � N � K ]� L �� 4 �� K +� ( w� q �� A � ? T� A �� > ւ X � # n� F �� 8 ل < � M O� ; �� 6 م 2 � 7 C� B {� : �� 4 �� 9 .� ? h� % �� + · 9 �� 5 4� I j� K �� M � Z N� S �� K �� � I� N Ԋ @ #� : d� ( �� B ȋ L � C X� � �� M K� = �� � u� �� �� �� �� Î � 0 � $ � # E� * i� % �� * �� � # � < *� g� �� �� 6 �� � � � : �� � �� � � (� 2� C� V� h� Q z� ̒ I � [ *�
�� �� ��
�� � C � A 1� s� �� �� �� �� �� �� , ǔ � � � !� -� 3� <� V� n� ��
�� �� �� �� ' �� � & � ' +� 7 S� 0 �� �� ؖ � �� � � $� -� e 7� �� �� × ɗ � ( �� %� 1� :� T� s� �� �� �� Ø ̘ � � � �
� )� /� 2� <�
B� P� Y� h� q� v� ��
�� ��
�� �� & ͙ � ��
�
� (� /� B� Y�
u� �� �� �� �� Ϛ ߚ �� � %� C� U� r� �� ��
�� �� ƛ % כ �� " � 4� U� q� �� ' �� & ͜ � �� � !� (� 1� ;�
@� K� L Z� �� �� ԝ > � 0� E� Y� 2 p� �� �� �� ў � �� � � (� .� E� e� z� �� �� ��
͟ ؟ � ' �� . "� ! Q� ' s� �� �� ��
ɠ נ � � '� G� g� v� �� , �� �� ѡ ݡ � � �� � .� E 5� {� �� �� �� �� �� �� �� Ȣ Ԣ � �� � � � &� 0� D�
J� X� t�
�� �� �� �� �� ϣ � � ! � 1� I� 9 d� y �� 9 � F R� 5 �� B ϥ C � 5 V� : �� 9 Ǧ @ � ; B� K ~� B ʧ C
� 6 Q� 8 �� �� ݨ �
�� � � *�
0� ;� W� v� �� �� �� & �� � �� � � � .� � # � # (� # L� p� " �� �� �� ɫ � � �
�� �
� �
+� c 6� � �� [� K x� Q ĭ / � O F� U �� 5 � = "� `� , l� 4 �� " ί ! � � 3� @� [� " w� + �� + ư 6 � X )� 7 �� 8 �� T � 5 H� I ~� 6 Ȳ # �� = #� = a� = �� i ݳ 9 G� �� �� * �� � � "� B� U� \� `� o� �� �� �� �� �� �� ѵ # � � (� $ A� f�
y� �� �� �� �� �� ��
�� ȶ Ҷ ܶ � �� � � � C !� e� / v� ( �� Ϸ � � �� � ' 0� X� $ w� % �� ! ¸ ) � ( � / 7� # g� ' �� , �� . � 4 � D� ! d� - �� �� % պ 4 �� 1 0� - b� / �� " �� � ' � +� . K� ) z� % �� ! ʼ $ � * � + <� A h� �� �� & ý 0 � . � ) J� ) t� �� % �� Ӿ
ؾ
� � # �� � )� ;� M� Y� e� l� x� �� �� C �� � � "� ,� D� T� d� ��
�� �� $ �� & � - � # "� F� 1 g� ( �� ) � + � ' � ! @� b� # }� ! �� ( �� �� � "� ?� ]� |� �� �� �� ��
�� �� ��
��
� � '� B� b� t� �� �� �� �� ��
� )� ! D� f� |� 2 �� �� �� �� � 0� Q� 2 k� 5 �� �� �� � . � J� & b� # �� �� ! �� �� � � -� F� 6 g� ) �� ��
�� �� �� �� � �
$� & 2� Y� i� s� }� �� �� �� �� �� �� �� ��
� � U � u� �� �� , �� �� �� � � (�
<� G� V� b� k� q� z� �� " ��
�� �� �� �� �� �
�
(� 1 6� h� ��
�� �� �� �� . �� � .
�
9� G� Q� W� i� z�
�� �� E �� ��
�� � � (� 7� >� S� [� j� ~� �� * �� ��
�� �� �� � � � � )�
:� E� N� X� h� z� �� �� �� �� �� �� �� �� �� �
� �
(� 6� =� D� W� `� % i� �� �� �� �� �� �� �� �� ��
� � "� ,�
5� @� J� Y� e� h� y� �� �� �� �� �� �� �� �� �� �� �� �� �
� �
)� 7� >�
P� ^� m� � �� �� �� �� �� �� �� �� �� �� � ! � 4 5�
j� x� . �� �� �� �� �� �� �� � �
!�
/�
=� K� ^� r� �� �� �� " �� �� �� � (� C� `� / v� �� �� �� �� " �� � .� J� h� {� * ��
�� �� �� �� � +� ?� O� b� {� 0 �� + �� �� �� � > �
J� U� ) a� " �� �� ��
�� �� �� �� � � � � -� <� K� W� \�
c� q�
z�
�� �� �� �� 7 �� 2 �� 6 %� V \� �� & �� & �� . � 6� B� R�
c�
q� � �� �� �� �� �� �� �� �� �� � ! � 2� :� L� Y�
i� t� |� �� �� . �� �� �� �� �
,� 7� G� Y� e� q� z� � �� ��
�� �� �� �� �� �� � � "� @� J� N� $ m� # �� �� �� 0 �� �� �� � "� 9� ( M� v� ��
�� �� �� �� �� �� �� �� �� �� � , � E� ]� {� $ �� �� ' �� �� � 3� M� e� �� �� ! �� �� �� ��
�� � � � � �� �� �� � �� �� * �� � -� [ C� F �� L �� � 3� � �� @ R� I �� U �� � 3� < �� U � r X� � �� _ ^� Y �� [ � F t� � �� S ]� O �� = � j ?� ^ �� L � c V� � �� Z F� _ �� d � j f� f �� ` 8� . �� � �� C h� F �� � �� g �� , �� � � C �� � � � �� R �� t � W J� ^ �� F � U H� y �� : � U S� � �� = 5� = s� D �� : �� 8 1� 4 j� I �� 8 � 8 "� C [� 8 �� g � ` @� G �� � � o n� F � B %� ? h� p �� c U } @ � L T a i � S W t > � f O r g � W * � � � * A � J z g I � ] , N � B � B H _ N � Q � W I ] � E � B E
B �
\ �
s ( B � N � E . c t K � H $
H m
N �
Q y W ? � H e Z W � C = \ o � z
E � B � ? ? N < � K � z D � P � � ( _ � V � i P � O � U " Z x j � H > � � o M � Q � ] 0 { � .
d 9 Y � W � { P G � 8 < M E � V � 8 ' ` ` D � A + H . t / � 2 � h ! m o! \ �! ^ :" S �" J �" � 8# [ �# L $ D c$ D �$ W �$ m E% N �% � & g �& O ' � p' * ( 3( S( V( h( l( �( �( = �( V �( 2 2) 8 e) ? �) G �) 5 &* 2 \* b �* > �* 1+ 8 L+ V �+ �+ � �+ E �, �, �, - # - B-
K- Y- l- �- y �- . ` *. � �. / / ) 1/ $ [/ 7 �/ �/ t �/ q I0 �0 �0
�0 �0 �0 1 1 4 1 R1 d1 l1 �1 �1 �1 $ �1 - �1 , 2 G2 Z2 a2 h2 o2 9 v2 . �2 E �2 > %3 = d3 @ �3 $ �3 4 '4 ' F4 n4 u4 |4 �4 � �4 ' 15 Y5 t5 �5 �5 . �5 �5
6 1 6 : =6 x6 �6 �6
�6 �6 �6 �6 7 7 /7 N7 ^7
t7 7 �7 �7 �7 �7 �7 �7 �7 �7 �7
8 )8 68 @8 O W8 �8 �8 �8 �8
�8 ) �8 )9 H9 [9 n9 �9 �9 �9 �9 �9 �9 : $ ': L: * Y: �: �: �: �: �: �: & �: ; ! 6; $ X; $ }; - �; ! �; 9 �; 8 ,< e< ) l< �< �< �< �< �< �< �< � �< u= : �= . �= y �= ( f> �> �> 3 �> �> ? .? " J? % m? �? ) �?
�? �? ( �? : @ - I@ w@ 4 �@ ! �@ �@ �@ ( A 2A B ?A c �A . �A O B
eB . sB �B �B * �B K �B . IC 3 xC 7 �C �C �C D I D gD }D �D �D �D �D - �D
�D R E YE uE �E �E �E �E �E �E �E �E # �E F ,F ?F
OF ZF pF �F �F % �F 7 �F G $G BG IG _G . xG �G �G # �G # �G & #H J JH � �H h hI n �I \ @J h �J h K V oK b �K b )L k �L \ �L � UM h �M h AN h �N b O ' vO �O �O �O �O 1 P BP OP ' _P * �P �P - �P
�P
Q / Q - BQ , pQ �Q ( �Q q �Q ) <S 5 fS 5 �S ; �S / T > >T ) }T �T �T �T �T �T �T �T U !U 2U � <U h �U 2 MW j �W k �W : WX p �X v Y G zY [ �Y Z > *Z < iZ 0 �Z 6 �Z ' [ 6[ # C[ ( g[ ) �[ % �[ 4 �[ E \ z [\ @ �\ _ ] q w] R �] ^ <^ V �^ K �^ L >_ L �_ R �_ { +` G �` ( �` 8 a F Qa ! �a 0 �a 9 �a %b Ab Qb ab wb �b �b �b �b �b 0 �b + c 1 1c cc {c U �c �c �c d d &d 9d Cd Pd Wd dd kd rd |d �d �d �d �d f �d 0 ?e B pe : �e �e �e ! f - 0f ' ^f - �f ? �f $ �f ? g $ Yg * ~g * �g 3 �g h 3 'h 9 [h ' �h B �h ! i $ "i < Gi $ �i 0 �i 0 �i 0 j 3 <j < pj ! �j �j 0 �j ! k $ >k - ck �k * �k ! �k * �k - (l o Vl �l �l = �l A m ? bm C �m C �m *n B Cn �n �n �n �n 0 �n �n �n o o o o 0o =o 0 Jo $ {o l �o 6
p Dp cp jp �p �p . �p �p �p �p < �p ; -q S iq 6 �q 3 �q K (r F tr 5 �r ; �r / -s 5 ]s B �s ; �s E t G Xt 1 �t - �t 7 u 7 8u ; pu �u * �u * �u v v ,v 3 Bv vv
�v �v �v 0 �v $ �v $ w $ Dw $ iw 6 �w $ �w B �w - -x * [x * �x 3 �x �x * y Q /y 9 �y ! �y * �y - z ' 6z - ^z Q �z Z �z $ 9{ < ^{ $ �{ ? �{ 0 | 0 1| 3 b| 6 �| < �|
} ! )} ! K} ! m} 3 �} ] �} ? !~ a~ k~ r~ ! |~ �~ �~ �~ $ �~ 6 �~ 3 = D Z ' a � � � � K � � � 2� N� l [� Ȁ ހ � 2 �� 3 +� * _� �� �� �� Á ́ ׁ � � � #� 6� N O� �� �� ǂ ӂ $ � � � (� c 2� $ �� �� ׃ � � � I #� m� B t� �� �� ń � � 2� ' H� _ p� Ѕ � �� � +� 8� ! B� d� k� A u� " �� چ ; �� 4� D� Z� d�
q� � �� �� ! �� �� ̇ � � � �
(� 3� $ I� 3 n� �� �� Ԉ � � � ! 1� S� ]� y� ' �� ' �� ։ � 3 �� *� 6 C� 0 z� �� �� Ŋ ؊ � �� � � .� A� T� j� �� �� �� 1 �� 3 � � .�
7� ! E� g� }� �� �� �� �� �� Ό � � �� � � (� >� T� k� x� �� �� �� �� �� ύ ߍ �� � .� 5� 9 <� Q v� Ȏ � : �
+� 9� I� $ Y� ~� �� �� �� �� ˏ � � 6 � S� ! o� - �� �� * ې ! � * (� S� 0 i� �� $ �� K ޑ *� F� e� ' �� ' �� * ђ - �� 6 *� a� w� 6 �� Ǔ ! � ' � *� $ F� k� ! �� �� ! �� $ ޔ f � < j� �� �� ĕ < ѕ � "� ? 2� 9 r� �� �� Ֆ � � 3 � 6� @�
M� [� z� �� �� �� �� ʗ ח � �� � #� <� Z [� < �� K � x ?� �� 6 ˙ - � 8 0� i� �� �� �� Ú $ Ӛ �� � !� (� /� 3 9� m� z� �� �� - � ! � "� 8� Q� d� q� ! �� �� B �� � � "� 3 5� i� y� * �� �� ӝ � �� � � ! 2� T� g� $ �� �� �� 9 Ϟ �
� )� E� L� [� + {� 0 �� ؟ � 9 � )� . <� k� ! u� �� 6 �� � �� � � /� E� I� S� c� m� �� �� ȡ < ҡ * � 3 :� n� % {� �� 6 �� ' � % � - 6� . d� * �� $ �� % � ? � I� e� {� �� �� �� m I � � � � � � � � & A 5 � L % ! � �
Y g b ' � � � # � � � k � 7 + � � � � � - s � � �
w � P p 9 � v � { � � z � � � � c y � � J 0 Z � � a h
' � ? �
� 8 % � � � ' M 4 � 7 � $ � S � � 1 � � / q � � = X r � - � � � q � - , � � � � G r { o � F m O � � � � � M 3 � C � P � � N � v � ` � � � D t \ j � � � � M � ) � [ Q � X a ( 3 ] � � � � w � � � l ; � � � � Z � , , � � � 4 � x g 2 � y # � < � U k � � � � d � � U ( � ~ Z � e w � } � & � � o � � � T � s . U X � D � _ 1 � � � # � j K � � 7 � � � . � 1 * ] W � p � " � r B � E d S u S � � � � H b � 5 X Q � 6 � � � i c � � � � � � � � , 1 } � � � / � � � } L n � � � i a h � } � � � � � � � � � K � � � 9 o t � � � o : � � Q + � � & � � � � � � g � 6 > K % � � _ � y u � � � R x E � D � � � � � � Y � � � > � � � � � � � � � � u h 7 = C � 2 � � � k � W � � 5
� r � � � � ! � ? u t � t I ^ � � � � � p V � 8 � � � � f g � � 8 / � � * � � f � � � F � ~ � � � � � y � m H � [ � � � � � _ ; K B W e B l � � � n � � 6 G � � 2 � . � � � � O z + ! � � � C � � % � x W � L
� � � k � � � q � e � � � � [ � � � � F . F 1 � �
M � � � � � � h � � � � / � � S 3 P � � ` N L U l � I � � 8 � s � & m - � � V f @ � ^ : 4 : R ? E � H | \ � � Q � � � � 5 � � a B � � ~ < � 0 2 � � � ; � � � P % ) � n # A v � I # � � � � z 9 � { ] � ! = � � 9 @ C � � � � � 5 R $ � � j $ � � \ � � � � � � � : * n � � � T � > � � � \ ~ ] N �
' T D [ j v � � � � � � J � � � � � � � � @ � � l � � � � � ^ � � { N E V / ` � � | c < � � � � e | ! x � � " A � � � � � � � " ) ) G > q $ � * ( � � � 7 � � � � � �
b � < � * � H 3 Y Z � ; � $ �
| � A - � p � ? � � � � � � ` 0 � � , & � � � 0 � s 6 � � b � � � � � . " J � d � � � � � � � � 2 � � = " � ( � � � 4 � i � � 0 � � � � � 8 � � � � + � T � � � � ' � � � � � � 6 � J ) � � i � � � � f � R ^ � � _ � � V 3 O � G z � � O � @ c ( Y � � � w � � � � � + � � � 4 d
Connection options:
Display settings:
Environment variables:
For more information, type "\?" (for internal commands) or "\help" (for SQL
commands) from within psql, or consult the psql section in the PostgreSQL
documentation.
Input and output options:
Output format options:
Parser: "%s"
Parser: "%s.%s" --help=commands list backslash commands, then exit
--help=variables list special variables, then exit
(options: S = show system objects, + = additional detail)
-0, --record-separator-zero
set record separator for unaligned output to zero byte
-1 ("one"), --single-transaction
execute as a single transaction (if non-interactive)
-?, --help[=options] show this help, then exit
-A, --no-align unaligned table output mode
-E, --echo-hidden display queries that internal commands generate
-F, --field-separator=STRING
field separator for unaligned output (default: "%s")
-H, --html HTML table output mode
-L, --log-file=FILENAME send session log to file
-P, --pset=VAR[=ARG] set printing option VAR to ARG (see \pset command)
-R, --record-separator=STRING
record separator for unaligned output (default: newline)
-S, --single-line single-line mode (end of line terminates SQL command)
-T, --table-attr=TEXT set HTML table tag attributes (e.g., width, border)
-U, --username=USERNAME database user name (default: "%s")
-V, --version output version information, then exit
-W, --password force password prompt (should happen automatically)
-X, --no-psqlrc do not read startup file (~/.psqlrc)
-a, --echo-all echo all input from script
-b, --echo-errors echo failed commands
-c, --command=COMMAND run only single command (SQL or internal) and exit
-d, --dbname=DBNAME database name to connect to (default: "%s")
-e, --echo-queries echo commands sent to server
-f, --file=FILENAME execute commands from file, then exit
-h, --host=HOSTNAME database server host or socket directory (default: "%s")
-l, --list list available databases, then exit
-n, --no-readline disable enhanced command line editing (readline)
-o, --output=FILENAME send query results to file (or |pipe)
-p, --port=PORT database server port (default: "%s")
-q, --quiet run quietly (no messages, only query output)
-s, --single-step single-step mode (confirm each query)
-t, --tuples-only print rows only
-v, --set=, --variable=NAME=VALUE
set psql variable NAME to VALUE
(e.g., -v ON_ERROR_STOP=1)
-w, --no-password never prompt for password
-x, --expanded turn on expanded table output
-z, --field-separator-zero
set field separator for unaligned output to zero byte
AUTOCOMMIT if set, successful SQL commands are automatically committed
COLUMNS number of columns for wrapped format
COMP_KEYWORD_CASE determines the case used to complete SQL key words
[lower, upper, preserve-lower, preserve-upper]
DBNAME the currently connected database name
ECHO controls what input is written to standard output
[all, errors, none, queries]
ECHO_HIDDEN if set, display internal queries executed by backslash commands;
if set to "noexec", just show without execution
ENCODING current client character set encoding
FETCH_COUNT the number of result rows to fetch and display at a time
(default: 0=unlimited)
HISTCONTROL controls command history [ignorespace, ignoredups, ignoreboth]
HISTFILE file name used to store the command history
HISTSIZE the number of commands to store in the command history
HOST the currently connected database server host
IGNOREEOF if unset, sending an EOF to interactive session terminates application
LASTOID value of the last affected OID
NAME=VALUE [NAME=VALUE] psql ...
or \setenv NAME [VALUE] inside psql
ON_ERROR_ROLLBACK if set, an error doesn't stop a transaction (uses implicit savepoints)
ON_ERROR_STOP stop batch execution after error
PAGER name of external pager program
PGAPPNAME same as the application_name connection parameter
PGDATABASE same as the dbname connection parameter
PGHOST same as the host connection parameter
PGPASSFILE password file name
PGPASSWORD connection password (not recommended)
PGPORT same as the port connection parameter
PGUSER same as the user connection parameter
PORT server port of the current connection
PROMPT1 specifies the standard psql prompt
PROMPT2 specifies the prompt used when a statement continues from a previous line
PROMPT3 specifies the prompt used during COPY ... FROM STDIN
PSQLRC alternative location for the user's .psqlrc file
PSQL_EDITOR, EDITOR, VISUAL
editor used by the \e, \ef, and \ev commands
PSQL_EDITOR_LINENUMBER_ARG
how to specify a line number when invoking the editor
PSQL_HISTORY alternative location for the command history file
QUIET run quietly (same as -q option)
SHELL shell used by the \! command
SHOW_CONTEXT controls display of message context fields [never, errors, always]
SINGLELINE end of line terminates SQL command mode (same as -S option)
SINGLESTEP single-step mode (same as -s option)
TMPDIR directory for temporary files
USER the currently connected database user
VERBOSITY controls verbosity of error reports [default, verbose, terse]
\! [COMMAND] execute command in shell or start interactive shell
\? [commands] show help on backslash commands
\? options show help on psql command-line options
\? variables show help on special variables
\C [STRING] set table title, or unset if none
\H toggle HTML output mode (currently %s)
\T [STRING] set HTML <table> tag attributes, or unset if none
\a toggle between unaligned and aligned output mode
\c[onnect] {[DBNAME|- USER|- HOST|- PORT|-] | conninfo}
connect to new database (currently "%s")
\c[onnect] {[DBNAME|- USER|- HOST|- PORT|-] | conninfo}
connect to new database (currently no connection)
\cd [DIR] change the current working directory
\conninfo display information about current connection
\copy ... perform SQL COPY with data stream to the client host
\copyright show PostgreSQL usage and distribution terms
\crosstabview [COLUMNS] execute query and display results in crosstab
\dA[+] [PATTERN] list access methods
\dC[+] [PATTERN] list casts
\dD[S+] [PATTERN] list domains
\dE[S+] [PATTERN] list foreign tables
\dF[+] [PATTERN] list text search configurations
\dFd[+] [PATTERN] list text search dictionaries
\dFp[+] [PATTERN] list text search parsers
\dFt[+] [PATTERN] list text search templates
\dL[S+] [PATTERN] list procedural languages
\dO[S+] [PATTERN] list collations
\dT[S+] [PATTERN] list data types
\d[S+] list tables, views, and sequences
\d[S+] NAME describe table, view, sequence, or index
\da[S] [PATTERN] list aggregates
\db[+] [PATTERN] list tablespaces
\dc[S+] [PATTERN] list conversions
\dd[S] [PATTERN] show object descriptions not displayed elsewhere
\ddp [PATTERN] list default privileges
\des[+] [PATTERN] list foreign servers
\det[+] [PATTERN] list foreign tables
\deu[+] [PATTERN] list user mappings
\dew[+] [PATTERN] list foreign-data wrappers
\df[antw][S+] [PATRN] list [only agg/normal/trigger/window] functions
\dg[S+] [PATTERN] list roles
\di[S+] [PATTERN] list indexes
\dl list large objects, same as \lo_list
\dm[S+] [PATTERN] list materialized views
\dn[S+] [PATTERN] list schemas
\do[S] [PATTERN] list operators
\dp [PATTERN] list table, view, and sequence access privileges
\drds [PATRN1 [PATRN2]] list per-database role settings
\ds[S+] [PATTERN] list sequences
\dt[S+] [PATTERN] list tables
\du[S+] [PATTERN] list roles
\dv[S+] [PATTERN] list views
\dx[+] [PATTERN] list extensions
\dy [PATTERN] list event triggers
\e [FILE] [LINE] edit the query buffer (or file) with external editor
\echo [STRING] write string to standard output
\ef [FUNCNAME [LINE]] edit function definition with external editor
\encoding [ENCODING] show or set client encoding
\errverbose show most recent error message at maximum verbosity
\ev [VIEWNAME [LINE]] edit view definition with external editor
\f [STRING] show or set field separator for unaligned query output
\g [FILE] or ; execute query (and send results to file or |pipe)
\gexec execute query, then execute each value in its result
\gset [PREFIX] execute query and store results in psql variables
\h [NAME] help on syntax of SQL commands, * for all commands
\i FILE execute commands from file
\ir FILE as \i, but relative to location of current script
\l[+] [PATTERN] list databases
\lo_export LOBOID FILE
\lo_import FILE [COMMENT]
\lo_list
\lo_unlink LOBOID large object operations
\o [FILE] send all query results to file or |pipe
\p show the contents of the query buffer
\password [USERNAME] securely change the password for a user
\prompt [TEXT] NAME prompt user to set internal variable
\pset [NAME [VALUE]] set table output option
(NAME := {format|border|expanded|fieldsep|fieldsep_zero|footer|null|
numericlocale|recordsep|recordsep_zero|tuples_only|title|tableattr|pager|
unicode_border_linestyle|unicode_column_linestyle|unicode_header_linestyle})
\q quit psql
\qecho [STRING] write string to query output stream (see \o)
\r reset (clear) the query buffer
\s [FILE] display history or save it to file
\set [NAME [VALUE]] set internal variable, or list all if no parameters
\setenv NAME [VALUE] set or unset environment variable
\sf[+] FUNCNAME show a function's definition
\sv[+] VIEWNAME show a view's definition
\t [on|off] show only rows (currently %s)
\timing [on|off] toggle timing of commands (currently %s)
\unset NAME unset (delete) internal variable
\w FILE write query buffer to file
\watch [SEC] execute query every SEC seconds
\x [on|off|auto] toggle expanded output (currently %s)
\z [PATTERN] same as \dp
border border style (number)
columns target width for the wrapped format
expanded (or x) expanded output [on, off, auto]
fieldsep field separator for unaligned output (default "%s")
fieldsep_zero set field separator for unaligned output to zero byte
footer enable or disable display of the table footer [on, off]
format set output format [unaligned, aligned, wrapped, html, asciidoc, ...]
linestyle set the border line drawing style [ascii, old-ascii, unicode]
null set the string to be printed in place of a null value
numericlocale enable or disable display of a locale-specific character to separate
groups of digits [on, off]
pager control when an external pager is used [yes, no, always]
psql --pset=NAME[=VALUE]
or \pset NAME [VALUE] inside psql
psql --set=NAME=VALUE
or \set NAME VALUE inside psql
psql [OPTION]... [DBNAME [USERNAME]]
recordsep record (line) separator for unaligned output
recordsep_zero set record separator for unaligned output to zero byte
set NAME=VALUE
psql ...
or \setenv NAME [VALUE] inside psql
tableattr (or T) specify attributes for table tag in html format or proportional
column widths for left-aligned data types in latex-longtable format
title set the table title for any subsequently printed tables
tuples_only if set, only actual table data is shown
unicode_border_linestyle
unicode_column_linestyle
unicode_header_linestyle
set the style of Unicode line drawing [single, double]
"%s.%s" is not a view
%d connection %d connections %s %s %s (every %gs)
%s
%s (%s, server %s)
%s (every %gs)
%s: %s
%s: -1 can only be used in non-interactive mode
%s: cannot copy from/to a directory
%s: could not delete variable "%s"
%s: could not find own program executable
%s: could not open log file "%s": %s
%s: could not set printing parameter "%s"
%s: could not set variable "%s"
%s: current transaction is aborted
%s: invalid encoding name or conversion procedure not found
%s: not connected to a database
%s: out of memory
%s: unknown transaction status
%s: warning: extra command-line argument "%s" ignored
(%lu row) (%lu rows) ***(Single step mode: verify command)*******************************************
%s
***(press return to proceed or enter x and return to cancel)********************
********* QUERY **********
%s
**************************
+ opt(%d) = |%s|
, clustered , deferrable , initially deferred , invalid , predicate (%s) , replica identity , tablespace "%s" Access privileges All connection parameters must be supplied because no database connection exists
Argument data types Asynchronous notification "%s" received from server process with PID %d.
Asynchronous notification "%s" with payload "%s" received from server process with PID %d.
Attributes Available help:
Border style is %d.
Bypass RLS COPY data transfer failed: %s Call Handler Cannot add cell to table content: total cell count of %d exceeded.
Cannot add header to table content: column count of %d exceeded.
Cannot login Check Check constraints: Child tables Collate Column Column privileges Command: %s
Description: %s
Syntax:
%s
Composite type "%s.%s" Connection
Create DB Create role Ctype Database Default access privileges Default footer is off.
Default footer is on.
Default? Definition Description Destination Dictionaries Did not find any extension named "%s".
Did not find any extensions.
Did not find any relation named "%s".
Did not find any relation with OID %s.
Did not find any text search configuration named "%s".
Did not find any text search parser named "%s".
Disabled internal triggers: Disabled rules: Disabled triggers: Disabled user triggers: Elements Enabled Encoding End parse Enter data to be copied followed by a newline.
End with a backslash and a period on a line by itself. Enter it again: Enter new password: Event Expanded display is off.
Expanded display is on.
Expanded display is used automatically.
FDW Options Failed.
Field separator is "%s".
Field separator is zero byte.
Foreign table "%s.%s" Foreign-data wrapper Foreign-key constraints: Formatting
Function General
General options:
Get headline Get next token Get token types Handler Has OIDs: yes Help
ID Implicit? Index Index "%s.%s" Indexes: Informational
Inherits Init Init options Inline Handler Input/Output
Internal Language Internal name Interrupted
Invalid command \%s. Try \? for help.
Language Large Objects
Large objects Left arg type Lexize Line style is %s.
List of access methods List of aggregate functions List of casts List of collations List of conversions List of data types List of databases List of domains List of event triggers List of foreign servers List of foreign tables List of foreign-data wrappers List of functions List of installed extensions List of languages List of operators List of relations List of roles List of schemas List of settings List of specially treated variables
List of tablespaces List of text search configurations List of text search dictionaries List of text search parsers List of text search templates List of user mappings Locale-adjusted numeric output is off.
Locale-adjusted numeric output is on.
Location Materialized view "%s.%s" Member of Method Modifier Modifiers Name No changes No connections No help available for "%s".
Try \h with no arguments to see available help.
No inheritance No matching relations found.
No matching settings found.
No per-database role settings support in this server version.
No relations found.
No settings found.
Null display is "%s".
Number of child tables: %d (Use \d+ to list them.) Object Object Description Object descriptions Objects in extension "%s" Operating System
Options Output format is %s.
Owned by: %s Owner Pager is always used.
Pager is used for long output.
Pager usage is off.
Parallel Password encryption failed.
Password for user %s: Password valid until Password: Passwords didn't match.
Policies Policies (forced row security enabled): Policies (forced row security enabled): (none) Policies (row security disabled): Policies (row security enabled): (none) Policies: Previous connection kept
Procedure Query Buffer
Query buffer is empty. Query buffer reset (cleared). Record separator is "%s".
Record separator is <newline>.
Record separator is zero byte.
Referenced by: Replica Identity Replication Report bugs to <pgsql-bugs@postgresql.org>.
Result data type Result type Right arg type Role Role name Rules firing always: Rules firing on replica only: Rules: SSL connection (protocol: %s, cipher: %s, bits: %s, compression: %s)
STATEMENT: %s
Schema Security Sequence "%s.%s" Server Settings Size Source Source code Source type Special relation "%s.%s" Start parse Stats target Storage Succeeded.
Superuser TOAST table "%s.%s" Table Table "%s.%s" Table attributes are "%s".
Table attributes unset.
Tablespace Tablespace: "%s" Tags Target type Target width is %d.
Target width is unset.
Template Text search configuration "%s" Text search configuration "%s.%s" Text search parser "%s" Text search parser "%s.%s" The connection to the server was lost. Attempting reset: The input is a PostgreSQL custom-format dump.
Use the pg_restore command-line client to restore this dump to a database.
The server (version %s) does not support access methods.
The server (version %s) does not support altering default privileges.
The server (version %s) does not support collations.
The server (version %s) does not support editing function source.
The server (version %s) does not support editing view definitions.
The server (version %s) does not support extensions.
The server (version %s) does not support foreign servers.
The server (version %s) does not support foreign tables.
The server (version %s) does not support foreign-data wrappers.
The server (version %s) does not support full text search.
The server (version %s) does not support savepoints for ON_ERROR_ROLLBACK.
The server (version %s) does not support showing function source.
The server (version %s) does not support showing view definitions.
The server (version %s) does not support tablespaces.
The server (version %s) does not support user mappings.
There is no previous error. Time: %.3f ms
Timing is off. Timing is on. Title is "%s".
Title is unset.
Token Token name Token types for parser "%s" Token types for parser "%s.%s" Triggers firing always: Triggers firing on replica only: Triggers: Trusted Try "%s --help" for more information.
Tuples only is off.
Tuples only is on.
Type Type "help" for help.
Type: \copyright for distribution terms
\h for help with SQL commands
\? for help with psql commands
\g or terminate with semicolon to execute query
\q to quit
Typed table of type: %s Unicode border line style is "%s".
Unicode column line style is "%s".
Unicode header line style is "%s".
Unlogged index "%s.%s" Unlogged materialized view "%s.%s" Unlogged table "%s.%s" Usage:
Use "\q" to leave %s.
User name Validator Value Variables
Version View "%s.%s" View definition: Volatility WARNING: %s major version %s, server major version %s.
Some psql features might not work.
WARNING: Console code page (%u) differs from Windows code page (%u)
8-bit characters might not work correctly. See psql reference
page "Notes for Windows users" for details.
Wrote history to file "%s".
You are connected to database "%s" as user "%s" on host "%s" at port "%s".
You are connected to database "%s" as user "%s" via socket in "%s" at port "%s".
You are currently not connected to a database.
You are now connected to database "%s" as user "%s" on host "%s" at port "%s".
You are now connected to database "%s" as user "%s" via socket in "%s" at port "%s".
You are now connected to database "%s" as user "%s".
You are using psql, the command-line interface to PostgreSQL. \!: failed
\%s: could not change directory to "%s": %s
\%s: environment variable name must not contain "="
\%s: error while setting variable
\%s: extra argument "%s" ignored
\%s: missing required argument
\connect: %s \copy: arguments required
\copy: parse error at "%s"
\copy: parse error at end of line
\crosstabview: ambiguous column name: "%s"
\crosstabview: column name not found: "%s"
\crosstabview: column number %d is out of range 1..%d
\crosstabview: data column must be specified when query returns more than three columns
\crosstabview: maximum number of columns (%d) exceeded
\crosstabview: query must return at least three columns
\crosstabview: query result contains multiple data values for row "%s", column "%s"
\crosstabview: statement did not return a result set
\crosstabview: vertical and horizontal headers must be different columns
\df does not take a "w" option with server version %s
\df only takes [antwS+] as options
\pset: allowed Unicode border line styles are single, double
\pset: allowed Unicode column line styles are single, double
\pset: allowed Unicode header line styles are single, double
\pset: allowed formats are unaligned, aligned, wrapped, html, asciidoc, latex, latex-longtable, troff-ms
\pset: allowed line styles are ascii, old-ascii, unicode
\pset: unknown option: %s
\watch cannot be used with COPY
\watch cannot be used with an empty query
abbreviated_grant_or_revoke abort the current transaction aborted because of read failure access_method_type action agg aggregate_name aggregate_signature alias alignment allowconn always analyze_function and aggregate_signature is: and conflict_action is one of: and grouping_element can be one of: and like_option is: and table_constraint is: and table_constraint_using_index is: and with_query is: arg_data_type arg_name arg_type argmode argname argtype argument argument_type arguments attribute attribute_name attribute_option base_type boolean cache call_handler cancel a transaction that was earlier prepared for two-phase commit canceled by user cannot duplicate null pointer (internal error)
cannot escape without active connection
canonical_function category change a database change a database role change a run-time parameter change a server configuration parameter change role name or membership change the definition of a collation change the definition of a conversion change the definition of a domain change the definition of a foreign server change the definition of a foreign table change the definition of a foreign-data wrapper change the definition of a function change the definition of a large object change the definition of a materialized view change the definition of a procedural language change the definition of a row level security policy change the definition of a rule change the definition of a schema change the definition of a sequence generator change the definition of a table change the definition of a tablespace change the definition of a text search configuration change the definition of a text search dictionary change the definition of a text search parser change the definition of a text search template change the definition of a trigger change the definition of a type change the definition of a user mapping change the definition of a view change the definition of an aggregate function change the definition of an event trigger change the definition of an extension change the definition of an index change the definition of an operator change the definition of an operator class change the definition of an operator family change the ownership of database objects owned by a database role channel check_expression child process exited with exit code %d child process exited with unrecognized status %d child process was terminated by exception 0x%X child process was terminated by signal %d child process was terminated by signal %s close a cursor cluster a table according to an index code collatable collate %s collation collect statistics about a database column_alias column_constraint column_definition column_name column_type com_op combinefunc command command not executable command not found commit a transaction that was earlier prepared for two-phase commit commit the current transaction compute a set of rows condition configuration_parameter conflict_action conflict_target connection to server was lost
connlimit constraint constraint_name copy data between a file and a table could not change directory to "%s": %s could not close pipe to external command: %s
could not execute command "%s": %s
could not find a "%s" to execute could not get home directory for user ID %ld: %s
could not identify current directory: %s could not locate temporary directory: %s
could not look up effective user ID %ld: %s could not open temporary file "%s": %s
could not parse reloptions array
could not read binary "%s" could not read from input file: %s
could not read symbolic link "%s" could not save history to file "%s": %s
could not set variable "%s"
could not start /bin/sh
could not start editor "%s"
could not stat file "%s": %s
could not write COPY data: %s
count create a new database create new rows in a table cursor_name data_type database_name deallocate a prepared statement default default %s default_expr define a cursor define a new access method define a new aggregate function define a new cast define a new collation define a new data type define a new database role define a new domain define a new encoding conversion define a new event trigger define a new foreign server define a new foreign table define a new foreign-data wrapper define a new function define a new index define a new mapping of a user to a foreign server define a new materialized view define a new operator define a new operator class define a new operator family define a new procedural language define a new rewrite rule define a new row level security policy for a table define a new savepoint within the current transaction define a new schema define a new sequence generator define a new table define a new table from the results of a query define a new tablespace define a new text search configuration define a new text search dictionary define a new text search parser define a new text search template define a new transform define a new trigger define a new view define access privileges define default access privileges define or change a security label applied to an object define or change the comment of an object definer definition delete delete rows of a table delimiter delimiter_character deserialfunc dest_encoding destroy a previously defined savepoint dictionary_name direction directory disabled discard session state domain constraint domain_constraint domain_name element empty a table or set of tables enabled encoding encoding_name end_function environment variable PSQL_EDITOR_LINENUMBER_ARG must be set to specify a line number
escape_character event exclude_element exclude_element in an EXCLUDE constraint is: execute a prepared statement execute an anonymous code block execution_cost existing_collation existing_enum_value expression extension_name family_name fdw_name ffunc filename filter_variable for table "%s.%s" force a transaction log checkpoint foreign table format_name from_item from_list from_sql_function_name function function name is required
function_name garbage-collect and optionally analyze a database generate a notification gettoken_function group_name grouping_element handler_function headline_function history is not supported by this installation
immutable import table definitions from a foreign server in assignment increment index index_column_name index_expression index_method index_name index_parameters index_parameters in UNIQUE, PRIMARY KEY, and EXCLUDE constraints are: index_predicate init_function initial_condition inline_handler input_function insert install an extension integer internallength invalid binary "%s" invalid command \%s
invalid line number: %s
invalid output format (internal error): %d invoker istemplate join_column join_condition join_proc join_type label lang_name large_object_oid lc_collate lc_ctype left_type lexize_function lextypes_function like_option like_type link_symbol listen for a notification load a shared library file local socket local_schema locale lock a table lockmode loid materialized view maxvalue member_object method mffunc minitial_condition minvalue minvfunc more than one row returned for \gset
msfunc mstate_data_size mstate_data_type name neg_op new_attribute_name new_column_name new_constraint_name new_dictionary new_enum_value new_name new_owner new_role new_schema new_table new_tablespace new_version no no query buffer
no rows returned for \gset
normal not null null_string obj_file object_name off old_dictionary old_role old_version on op_type opclass operator operator class operator family operator_name option or the old syntax out of memory out of memory
output_expression output_function output_name parameter parent_table parser_name password payload pclose failed: %s policy_name position a cursor predicate preferred prepare a statement for execution prepare the current transaction for two-phase commit primary key, provider psql is the PostgreSQL interactive terminal.
psql variables:
query quote_character rebuild indexes receive_function refcolumn referenced_table_name reftable relation_name remote_schema remove a cast remove a collation remove a conversion remove a data type remove a database remove a database role remove a domain remove a foreign server descriptor remove a foreign table remove a foreign-data wrapper remove a function remove a materialized view remove a procedural language remove a rewrite rule remove a row level security policy from a table remove a schema remove a sequence remove a table remove a tablespace remove a text search configuration remove a text search dictionary remove a text search parser remove a text search template remove a transform remove a trigger remove a user mapping for a foreign server remove a view remove access privileges remove an access method remove an aggregate function remove an event trigger remove an extension remove an index remove an operator remove an operator class remove an operator family remove database objects owned by a database role replace the contents of a materialized view replica res_proc restart restore the value of a run-time parameter to the default value restricted result_rows retrieve rows from a query using a cursor retrieve rows from a table or view rettype rewrite_rule_name right_type role_name role_specification roll back to a savepoint rule rule_name safe sampling_method savepoint_name schema_element schema_name seed select send_function sequence sequence_name serialfunc server_name server_type server_version set constraint check timing for the current transaction set the characteristics of the current transaction set the current user identifier of the current session set the session user identifier and the current user identifier of the current session sfunc show the execution plan of a statement show the value of a run-time parameter skipping recursive expansion of variable "%s"
snapshot_id sort_expression sort_family_name sort_operator source_config source_encoding source_table source_type special stable start start a transaction block start_function state_data_size state_data_type statement stop listening for a notification storage storage_parameter storage_type strategy_number sub-SELECT subtype subtype_diff_function subtype_operator_class support_number tab completion query failed: %s
Query was:
%s
table table constraint table_constraint table_constraint_using_index table_name tablespace_name tablespace_option target_role target_type template text timestamp timezone to_sql_function_name token_type transaction_id transaction_mode trigger trigger_name trying to exit copy mode type type_modifier_input_function type_modifier_output_function type_name uid unexpected PQresultStatus: %d
unexpected result status for \watch
unexpected transaction status (%d)
unique, unknown unrecognized value "%s" for "%s"; assuming "%s"
unsafe unterminated quoted string
update update rows of a table user does not exist user name lookup failure: error code %lu user_name using_expression using_list valfunction validator_function value values version view view name is required
view_option_name view_option_value volatile where abbreviated_grant_or_revoke is one of: where action is one of: where aggregate_signature is: where column_constraint is: where conflict_target can be one of: where constraint is: where direction can be empty or one of: where event can be one of: where from_item can be one of: where lockmode is one of: where member_object is: where option can be one of: where option can be: where role_specification can be: where transaction_mode is one of: window window_definition window_name with_query with_query_name yes Project-Id-Version: PostgreSQL 9.6.1
Report-Msgid-Bugs-To: pgsql-bugs@postgresql.org
POT-Creation-Date: 2017-01-09 22:43+0000
PO-Revision-Date: 2015-05-27 18:55+0900
Last-Translator: Okano Naoki <okano.naoki@jp.fujitsu.com>
Language-Team: jpug-doc <jpug-doc@ml.postgresql.jp>
Language: ja
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Plural-Forms: nplurals=2; plural=n != 1;
接続オプション:
設定を表示:
環境変数:
詳細は psql の中で "\?" (内部コマンドの場合) または "\help"
(SQL コマンドの場合) をタイプするか、PostgreSQL ドキュメントの psql の
セクションを参照のこと。
入出力オプション：
出力フォーマットオプション:
パーサ："%s"
パーサ： "%s.%s" --help=commands バックスラッシュコマンド一覧を表示して終了
--help=variables 特別な変数一覧を表示して終了
(修飾子: S = システムオブジェクトを表示 + = 付加情報)
-0, --record-separator-zero
桁揃えなしの出力でのレコード区切り文字をゼロバイトに設定
-1(数字の１), --single-transaction
単一のトランザクションとして実行(対話式でない場合)
-?, --help[=options] このヘルプを表示して終了
-A, --no-align 桁揃えなしのテーブル出力モード
-E, --echo-hidden 内部コマンドが生成した問い合わせを表示
-F, --field-separator=文字列
桁揃えなしの出力でのフィールド区切り文字(デフォルト: "%s")
-H, --html HTML テーブル出力モード
-L, --log-file=ファイル名 セッションログをファイルに書き込む
-P, --pset=変数[=値] 表示オプション '変数' を '値' にセット (\pset コマンドを参照)
-R, --record-separator=文字列
桁揃えなしの出力でのレコード区切り文字(デフォルト：改行)
-S, --single-line 単一行モード(行末を SQL コマンドの終了とみなす)
-T, --table-attr=TEXT HTMLテーブルのタグ属性をセット(width, border等)
-U, --username=ユーザー名 データベースのユーザ名(デフォルト: "%s")
-V, --version バージョン情報を表示して終了
-W, --password パスワードプロンプトを強制表示する
（本来は自動的に表示されるはずです）
-X, --no-psqlrc 初期化ファイル (~/.psqlrc) を読みこまない
-a, --echo-all スクリプトからのすべての入力を表示
-b, --echo-errors 失敗したコマンドを表示
-c, --command=コマンド (SQLまたは内部の)単一コマンドを一つだけ実行して終了
-d, --dbname=DB名 接続するデータベース名を指定(デフォルト: "%s")
-e, --echo-queries サーバーへ送信したコマンドを表示
-f, --file=ファイル名 ファイルからコマンドを読み込んで実行後、終了
-h, --host=ホスト名 データベースサーバーのホストまたはソケットのディレクトリ(デフォルト: "%s")
-l(エル), --list 使用可能なデータベース一覧を表示して終了
-n, --no-readline 拡張コマンドライン編集機能(readline)を無効にする
-o, --output=ファイル名 問い合わせ結果をファイル(または |パイプ)に送る
-p, --port=ポート番号 データベースサーバーのポート番号(デフォルト： "%s")
-q, --quiet 静かに実行(メッセージなしで、問い合わせの出力のみ)
-s, --single-step シングルステップモード(各問い合わせごとに確認)
-t, --tuples-only 行のみを表示
-v, --set=, --variable=名前=値
psql 変数 '名前' に '値' をセット
(-v ON_ERROR_STOP=1 等)
-w, --no-password パスワード入力を要求しない
-x, --expanded 拡張テーブル出力を有効にする
-z, --field-separator-zero
桁揃えなしの出力でのフィールド区切り文字をゼロバイトに設定
AUTOCOMMIT 設定すると、成功したSQLコマンドは自動的にコミットされる
COLUMNS wrapped形式の列数
COMP_KEYWORD_CASE SQLキーワードを補完する時に大文字小文字のどちらを使用するか決定する
[lower, upper, preserve-lower, preserve-upper]
DBNAME 現在接続しているデータベース名
ECHO どの入力を標準出力へ出力するかを制御する
[all, errors, none, queries]
ECHO_HIDDEN 設定すると、バックスラッシュコマンドによって実行される内部問い合わせを表示する;
"noexec" に設定すると、実行せずに表示のみ行う
ENCODING 現在のクライアントの文字セット符号化方式
FETCH_COUNT 一度にフェッチして表示する行数
(デフォルト: 0=無限)
HISTCONTROL コマンド履歴の制御 [ignorespace, ignoredups, ignoreboth]
HISTFILE コマンド履歴を格納するために使用されるファイル名
HISTSIZE コマンド履歴に格納するコマンド数
HOST 現在接続しているデータベースサーバのホスト
IGNOREEOF 未設定の場合、対話セッションにEOFを送信するとアプリケーションが終了
LASTOID 最後に影響を受けたOIDの値
NAME=VALUE [NAME=VALUE] psql ...
または、psqlの中で \setenv NAME [VALUE]
ON_ERROR_ROLLBACK 設定すると、エラーでトランザクションが停止しない (暗黙的にセーブポイントを使用)
ON_ERROR_STOP エラー後のバッチ実行を停止
PAGER 外部のページャプログラム名
PGAPPNAME application_name接続パラメータと同じ
PGDATABASE dbname接続パラメータと同じ
PGHOST host接続パラメータと同じ
PGPASSFILE パスワードファイル名
PGPASSWORD 接続パスワード (推奨されていません)
PGPORT port接続パラメータと同じ
PGUSER user接続パラメータと同じ
PORT 現在の接続のサーバのポート番号
PROMPT1 標準psqlプロンプトを指定
PROMPT2 前の行から文が続いているときに使用するプロンプトを指定
PROMPT3 COPY ... FROM STDIN の実行中に使用されるプロンプトを指定
PSQLRC ユーザの.psqlrcファイルの場所を指定
PSQL_EDITOR, EDITOR, VISUAL
\eコマンド、\efコマンド、\evコマンドで使用されるエディタ
PSQL_EDITOR_LINENUMBER_ARG
エディタを呼び出すときの行番号の指定方法
PSQL_HISTORY コマンド履歴ファイルの場所を指定
QUIET 静かに実行 (-qオプションと同じ)
SHELL \!コマンドで使用されるシェル
SHOW_CONTEXT メッセージコンテキストフィールドの表示を制御 [never, errors, always]
SINGLELINE 行の終端でSQLコマンドモードを終了 (-Sオプションと同じ)
SINGLESTEP シングルステップモード (-s オプションと同じ)
TMPDIR 一時ファイル用のディレクトリ
USER 現在接続しているデータベースユーザー
VERBOSITY エラー報告の冗長性を制御 [default, verbose, terse]
\! [コマンド] シェルでコマンドを実行、もしくは会話型シェルを起動
\? [commands] バックスラッシュコマンドのヘルプを表示
\? options psqlコマンドラインオプションのヘルプを表示
\? variables 特別な変数のヘルプを表示
\C タイトル テーブルのタイトルを設定する。指定がなければ解除
\H HTML の出力モードを切り替える(現在: %s)
\T [文字列] HTML の <table> タグの属性をセット。引数がなければ解除
\a 出力モードの 'unaligned' / 'aligned' を切り替える
\c[onnect] {[DB名|- ユーザ名|- ホスト名|- ポート番号|-] | conninfo}
新しいデータベースに接続する (現在: "%s")
\c[onnect] {[DB名|- ユーザ名|- ホスト名|- ポート番号|-] | conninfo}
新しいデータベースに接続する (現在: 接続無し)
\cd [DIR] カレントディレクトリを変更
\conninfo 現在の接続に関する情報を表示する
\copy ... クライアントホストに対し、データストリームを使ってSQLコピーを行う
\copyright PostgreSQL の使い方と配布条件を表示
\crosstabview [COLUMNS] 問い合わせを実行してクロス表形式で結果を表示
\dA[+] [パターン] アクセスメソッドの一覧を表示する
\dC[+] [パターン] キャストの一覧を表示する
\dD[S+] [パターン] ドメインの一覧を表示する
\dE[S+] [パターン] 外部テーブルの一覧を表示する
\dF[+] [パターン] テキスト検索設定の一覧を表示する
\dFd[+] [パターン] テキスト検索用辞書の一覧を表示する
\dFp[+] [パターン] テキスト検索用パーサーの一覧を表示する
\dFt[+] [パターン] テキスト検索用テンプレートの一覧を表示する
\dL[S+] [パターン] 手続き言語の一覧を表示する
\dO[S+] [パターン] 照合順序の一覧を表示する
\dT[S+] [パターン] データ型の一覧を表示する
\d[S+] テーブル、ビュー、シーケンスの一覧を表示する
\d[S+] 名前 テーブル、ビュー、シーケンス、インデックスの説明を表示する
\da[S] [パターン] 集約関数の一覧を表示する
\db[+] [パターン] テーブルスペースの一覧を表示する
\dc[S+] [パターン] 変換ルールの一覧を表示する
\dd[S] [パターン] 他では表示されないオブジェクトの説明を表示する
\ddp [パターン] デフォルト権限の一覧を表示する
\des[+] [パターン] 外部サーバーの一覧を表示する
\det[+] [パターン] 外部テーブルの一覧を表示する
\deu[+] [パターン] ユーザマッピングの一覧を表示する
\dew[+] [パターン] 外部データラッパーの一覧を表示する
\df[antw][S+] [パターン] 関数（集約/通常/トリガー/ウィンドウのみ）の一覧を表示する
\dg[S+] [パターン] ロールの一覧を表示する
\di[S+] [パターン] インデックスの一覧を表示する
\dl ラージオブジェクトの一覧を表示する。\lo_list と同じ。
\dm[S+] [パターン] マテリアライズドビューの一覧を表示する
\dn[S+] [パターン] スキーマの一覧を表示する
\do[S] [名前] 演算子の一覧を表示する
\dp [パターン] テーブル、ビュー、シーケンスのアクセス権一覧を表示する
\drds [パターン1 [パターン2]] データベース毎のロール（ユーザー）設定の一覧を表示する
\ds[S+] [パターン] シーケンスの一覧を表示する
\dt[S+] [パターン] テーブルの一覧を表示する
\du[S+] [パターン] ロールの一覧を表示する
\dv[S+] [パターン] ビューの一覧を表示する
\dx[+] [パターン] 拡張の一覧を表示する
\dy [パターン] イベントトリガの一覧を表示する
\e [ファイル] [行番号] 現在の問い合わせバッファ(やファイル)を外部エディタで編集する
\echo [文字列] 文字列を標準出力に書き出す
\ef [関数名 [行番号]] 関数定義を外部エディタで編集する
\encoding [エンコーディング]
クライアントのエンコーディングを表示またはセット
\errverbose 最も最近のエラーメッセージを最大の冗長さで表示
\ev [ビュー名 [行番号]] ビュー定義を外部エディタで編集する
\f [文字列] 桁揃えを行わない(unaligned)問い合わせ出力におけるフィールド区切り文字を表示または設定
\g [ファイル] または ';' 問い合わせを実行（し、結果をファイルまたは |パイプ へ書き出す)
\gexec 問い合わせを実行して結果の各値を実行
\gset [PREFIX] 問い合わせを実行し結果をpsql変数に格納
\h [名前] SQL コマンドの文法ヘルプ、* で全コマンド
\i ファイル ファイルからコマンドを読み込んで実行する
\ir ファイル \iと同じ。ただし現在のスクリプトの場所からの相対パス
\l[+] [パターン] データベースの一覧を表示する
\lo_export LOBOID ファイル名
\lo_import ファイル名 [コメント]
\lo_list
\lo_unlink LOBOID ラージオブジェクトの操作
\o [ファイル] すべての問い合わせの結果をファイルまたは |パイプ へ送る
\p 問い合わせバッファの内容を表示する
\password [ユーザ名] ユーザのパスワードを安全に変更する
\prompt [テキスト] 変数名 ユーザに内部変数をセットするよう促す
\pset [名前 [値]] テーブル出力のオプションを設定する
(名前 := {format|border|expanded|fieldsep|fieldsep_zero|footer|null|
numericlocale|recordsep|recordsep_zero|tuples_only|title|tableattr|pager|
unicode_border_linestyle|unicode_column_linestyle|unicode_header_linestyle})
\q psql を終了する
\qecho [文字列] 文字列を問い合わせ出力ストリームに出力(\o を参照)
\r 問い合わせバッファをリセット（クリア）する
\s [ファイル] ヒストリを表示またはファイルに保存する
\set [変数名 [値]]
内部変数の値をセット。引数がない場合は一覧表示。
\setenv NAME [VALUE] 環境変数の設定、設定解除を行う
\sf[+] 関数名 関数定義を表示する
\sv[+] ビュー名 ビュー定義を表示する
\t [on|off] 行のみを表示するか？ (現在: %s)
\timing [on|off] コマンドのタイミングを切り替える(現在: %s)
\unset 変数名 内部変数を削除する
\w ファイル 問い合わせバッファの内容をファイルに書き出す
\watch [SEC] SEC秒毎に問い合わせを実行する
\x [on|off|auto] 拡張出力の切り替え(現在: %s)
\z [パターン] \dp と同じ
border 境界線の形式 (数)
columns wrapped書式の対象幅
expanded (or x) 拡張表示 [on, off, auto]
fieldsep 桁揃えなしの出力でのフィールド区切り文字(デフォルト "%s")
fieldsep_zero 桁揃えなしの出力でのフィールド区切り文字をゼロバイトに設定
footer テーブルフッタの表示を有効化または無効化 [on, off]
format 出力形式を設定 [unaligned, aligned, wrapped, html, asciidoc, ...]
linestyle 境界線の表示形式を設定 [ascii, old-ascii, unicode]
null null値の代わりに表示する文字列を設定
numericlocale 桁のくくりを分離するロケール固有の文字の表示を
有効化または無効化 [on, off]
pager いつ外部ページャが使用されるか制御 [yes, no, always]
psql --pset=NAME[=VALUE]
または、psql の中で \pset NAME [VALUE]
psql --set=NAME=VALUE
または psql の中で \set NAME VALUE
psql [オプション]... [データベース名 [ユーザ名]]
recordsep 桁揃えなしの出力でのレコード(行)の区切り文字
recordsep_zero 桁揃えなしの出力でのレコードの区切り文字をゼロバイトに設定
set NAME=VALUE
psql ...
または、psqlの中で \setenv NAME [VALUE]
tableattr (または T) html形式でのテーブルタグの属性や
latex-longtable書式での左揃えされたデータ型の列幅の比率を指定
title 今後表示される全てのテーブル用にテーブルタイトルを設定
tuples_only 設定すると、実テーブルデータのみを表示
unicode_border_linestyle
unicode_column_linestyle
unicode_header_linestyle
Unicodeの線の形式を設定 [single, double]
"%s.%s" はビューではありません
%d 個の接続 %d 個の接続 %s %s %s (%g秒毎)
%s
%s (%s, サーバー %s)
%s (%g秒毎)
%s: %s
%s: -1は対話式モード以外でのみ使用できます
%s: ディレクトリから／ディレクトリへのコピーはできません。
%s: 変数 "%s" を削除できませんでした
%s: 実行ファイル自体がありませんでした
%s: ログファイル "%s" をオープンできません: %s
%s: 表示用パラメータ "%s" をセットできませんでした
%s: 変数 "%s" をセットできませんでした
%s: トランザクションを中断しました
%s: 符号化方式名が無効、または変換用プロシージャが見つかりません。
%s: どのデータベースにも接続されていません
%s: メモリ不足です
%s: トランザクションの状態が不明です。
%s: 警告：余分なコマンドラインオプション "%s" は無視されます
(%lu 行) (%lu 行) ***(シングルステップモード: 問い合わせを検査してください)********
%s
***([Enter] を押して進むか、x [Enter] でキャンセル)**************
********* 問い合わせ ********
%s
*****************************
+ opt(%d) = |%s|
, クラスタ化済み , 遅延可能 , 最初から遅延されている , 無効 , 述語 (%s) レプリカ特性 テーブルスペース "%s" アクセス権 データベース接続がありませんのですべての接続パラメータを指定しなければなりません
引数のデータ型 PID %2$d を持つサーバープロセスから非同期通知 "%1$s" を受信しました。
PID %3$d を持つサーバープロセスから、ペイロード "%2$s" を持つ非同期通知 "%1$s" を受信しました。
属性 利用可能なヘルプ:
境界線のスタイルは %d です。
行単位セキュリティを無視 COPY 対象データの転送に失敗しました：%s 呼び出しハンドラー テーブルの内容にセルを追加できませんでした：全セル数 %d が制限を越えています。
テーブルの内容に見出しを追加できませんでした：列数 %d が制限を越えています。
ログインできない チェック 検査制約: 子テーブル 照合順序 列 列の権限 コマンド: %s
説明: %s
書式:
%s
複合型 "%s.%s" 接続
DBを作成できる ロールを作成できる Ctype(変換演算子) データベース デフォルトのアクセス権限 デフォルトのフッタは off です。
デフォルトのフッタは on です。
デフォルト？ 定義 説明 宛先 辞書 "%s" という名前の拡張が見つかりません。
拡張がまったく見つかりません。
"%s" という名前のリレーションが見つかりません。
OID %s を持つリレーションが見つかりません。
テキスト検索用設定 "%s" が見つかりません。
テキスト検索用パーサ "%s" が見つかりません。
無効にされた内部トリガ： 無効にされたルール： 無効にされたトリガ： 無効にされたユーザトリガ： 要素 有効 エンコーディング パース終了 コピーするデータに続いて改行を入力します。
バックスラッシュ(\)とピリオドだけの行で終了します。 もう一度入力してください： 新しいパスワード: イベント 拡張表示は off です。
拡張表示は on です。
拡張表示が自動的に使用されます
FDWオプション 失敗。
フィールド区切り文字は "%s" です。
フィールド区切り文字はゼロバイトです。
外部テーブル "%s.%s" 外部データラッパー 外部キー制約: 書式設定
関数 一般
一般的なオプション：
見出しの取得 次のトークンを取得 トークンタイプの取得 ハンドラー OID を持つ: はい ヘルプ
ID 暗黙? インデックス インデックス "%s.%s" インデックス: 情報
継承 初期化 初期化オプション: インラインハンドラー 入出力
内部言語 内部名 中断されました
\%sコマンドは無効です。\? でヘルプを参照してください。
言語 ラージオブジェクト
ラージオブジェクト 左辺の型 Lex 処理 境界線のスタイルは %s です。
アクセスメソッド一覧 集約関数一覧 キャスト一覧 照合順序一覧 変換ルール一覧 データ型一覧 データベース一覧 ドメイン一覧 イベントトリガの一覧 外部サーバー一覧 外部テーブル一覧 外部データラッパーの一覧 関数一覧 インストール済みの拡張の一覧 言語一覧 演算子一覧 リレーションの一覧 ロール一覧 スキーマ一覧 設定の一覧 特別に扱われる変数の一覧
テーブルスペース一覧 テキスト検索用設定一覧 テキスト検索用辞書の一覧 テキスト検索用パーサ一覧 テキスト検索用テンプレート一覧 ユーザマッピングの一覧 「数値出力のロケール調整」は off です。
「数値出力のロケール調整」は on です。
場所 マテリアライズドビュー "%s.%s" メンバー メソッド 修飾語 修飾語 名前 変更なし 接続なし "%s" についてはヘルプ情報がありません。
引数なしで \h とタイプすると、ヘルプの一覧が表示されます。
継承なし マッチするリレーションが見つかりません
マッチする設定が見つかりません
このバージョンのサーバーでは、データベース毎のロール設定をサポートしていません。
リレーションがありません。
設定がありません。
Null 表示は "%s" です。
子テーブルの数：%d（\d+ で一覧表示） オブジェクト オブジェクトの説明 オブジェクトの説明 拡張"%s"内のオブジェクト オペレーティングシステム
オプション 出力フォーマットは %s です。
所有者: %s 所有者 常にページャが使われます。
出力が長い場合はページャが使われます。
「ページャを使う」は off です。
パラレル パスワードの暗号化に失敗しました。
ユーザ %s のパスワード: パスワード有効期限 パスワード: パスワードが一致しません。
ポリシー ポリシー (FORCE指定された行セキュリティが有効): ポリシー (FORCE指定された行セキュリティが有効): (ポリシーがありません) ポリシー (行セキュリティが無効): ポリシー (行セキュリティが有効): (ポリシーがありません) ポリシー: 以前の接続は保持されています。
プロシージャ 問い合わせバッファ
問い合わせバッファは空です。 問い合わせバッファがリセット（クリア）されました。 レコード区切り文字は "%s" です。
レコード区切り文字は <newline> です。
レコード区切り文字はゼロバイトです。
参照元： レプリカ特性 レプリケーション 不具合は<pgsql-bugs@postgresql.org>まで報告してください。
結果のデータ型 結果の型 右辺の型 ロール ロール名 常に無視されるルール レプリカでのみ無視されるルール ルール: SSL接続(プロトコル: %s, 暗号化方式: %s, ビット長: %s, 圧縮: %s)
ステートメント: %s
スキーマ セキュリティ シーケンス "%s.%s" サーバー 設定 サイズ ソース ソースコード ソースの型 特殊なリレーション "%s.%s" パース起動 対象統計情報 ストレージ 成功。
スーパーユーザ TOAST テーブル "%s.%s" テーブル テーブル "%s.%s" テーブル属性は "%s" です。
テーブル属性はセットされていません。
テーブルスペース テーブルスペース "%s" タグ ターゲットの型 対象幅は%dです。
対象幅はセットされていません。
テンプレート テキスト検索用設定 "%s" テキスト検索用設定 "%s.%s" テキスト検索用パーサ "%s" テキスト検索用パーサ "%s.%s" サーバーへの接続が切れました。リセットしています: 入力はPostgreSQLのカスタム書式のダンプです。
データベースへこのダンプをリストアするには pg_restore コマンドライン・クライアントを使用してください。
このサーバー (バージョン %s) はアクセスメソッドをサポートしていません。
このサーバー (バージョン %s) は代替のデフォルト権限をサポートしていません。
このサーバー (バージョン %s) は照合順序をサポートしていません。
このサーバー (バージョン %s) は関数のソース編集をサポートしていません。
このサーバー (バージョン %s) は関数のソース編集をサポートしていません。
このサーバー (バージョン %s) は拡張をサポートしていません。
このサーバー (バージョン %s) は外部サーバーをサポートしていません。
このサーバー (バージョン %s) は外部テーブルをサポートしていません。
このサーバー (バージョン %s) は外部データラッパーをサポートしていません。
このサーバー (バージョン %s) は全文検索をサポートしていません。
このサーバー (バージョン %s) では、ON_ERROR_ROLLBACK用のセーブポイントをサポートしていません。
このサーバー (バージョン %s) は関数ソースの表示をサポートしていません。
このサーバー (バージョン %s) はビュー定義の表示をサポートしていません。
このサーバー (バージョン %s) はテーブルスペースをサポートしていません。
このサーバー (バージョン %s) はユーザマップをサポートしていません。
直前のエラーがありません。 時間: %.3f ms
タイミングは off です。 タイミングは on です。 タイトルは "%s" です。
タイトルはセットされていません。
トークン トークン名 パーサ "%s" のトークンタイプ パーサ "%s.%s" のトークンタイプ 常に無視されるトリガ レプリカでのみ無視されるトリガ トリガ: 信頼? 詳細は '%s --help' をごらんください
「タプルのみ表示」は off です。
「タプルのみ表示」は on です。
型 "help" でヘルプを表示します.
\copyright とタイプすると、配布条件を表示します。
\h とタイプすると、SQL コマンドのヘルプを表示します。
\? とタイプすると、psql コマンドのヘルプを表示します。
\g と打つかセミコロンで閉じると、問い合わせを実行します。
\q で終了します。
型付けされたテーブルの型：%s Unicodeの境界線のスタイルは "%s" です。
Unicodeの列の線のスタイルは "%s" です。
Unicodeのヘッダの線のスタイルは "%s" です。
ログを取らないインデックス "%s.%s" ログを取らないマテリアライズドビュー "%s.%s" ログを取らないテーブル "%s.%s" 使用方法:
"\q" で %s を抜けます。
ユーザ名 バリデータ 値 変数
バージョン ビュー "%s.%s" ビュー定義: 揮発性 注意： %s メジャーバージョン %s, サーバーバージョン %s.
psql の機能の中で、動作しないものがあるかもしれません。
警告：コンソールのコードページ (%u) が Windows のコードページ (%u) と
異なるため、8 ビット文字列が正しく動作しない可能性があります。
詳細は psql リファレンスマニュアルの "Notes for Windows users"
（ウィンドウズユーザのために）を参照してください。
ファイル"%s"に履歴を出力しました。
ホスト"%3$s"上のポート"%4$s"のデータベース"%1$s"にユーザ"%2$s"で接続しています
データベース"%s"にユーザ"%s"でソケット"%s"経由のポート"%s"で接続しています。
現在データベースには接続していません。
ホスト"%3$s"上のポート"%4$s"でデータベース"%1$s"にユーザ"%2$s"として接続しました。
ポート"%4$s"のソケット"%3$s"経由でデータベース"%1$s"にユーザ"%2$s"として接続しました。
データベース "%s" にユーザ"%s"として接続しました。
PostgreSQL へのコマンドライン・インターフェース、psql へようこそ。 \!: 失敗
\%s: ディレクトリを "%s" に変更できません：%s
\%s: 環境変数の名前には"="を含められません
\%s: 変数を設定している時にエラー
\%s: 余分な引数 "%s" は無視されました。
\%s: 必要な引数がありません
\connect: %s \copy: 引数がありません。
\copy: "%s" でパースエラー発生
\copy: 行末でパースエラー発生
\crosstabview: 曖昧な列名: "%s"
\crosstabview: 列名が見つかりません: "%s"
\crosstabview: 列番号 %d は 1..%d の範囲を超えています
\crosstabview: 問い合わせが3つより多く列を返すときは出力列が指定されなければなりません
\crosstabview: 列の最大数 (%d) の制限を越えました
\crosstabview: 問い合わせは少なくとも3つの列を返さなければなりません
\crosstabview: 行 "%s", 列 "%s" について問い合わせ結果が複数のデータ値を含んでいます
\crosstabview: ステートメントは結果セットを返しませんでした
\crosstabview: 縦方向と横方向のヘッダは異なる列でなければなりません
サーバーバージョン %s では\dfは"w"オプションを受け付けません
\dfはオプションとして[antwS+]のみを取ることができます
\pset: 有効なUnicodeの境界線のスタイルは single, double です
\pset: 有効なUnicodeの列の線のスタイルは single, double です
\pset: 有効なUnicodeのヘッダの線のスタイルは single, double です
\pset: 有効なフォーマットは unaligned, aligned, wrapped, html, asciidoc, latex, latex-longtable, troff-ms です
\pset: 有効な行スタイルは ascii, old-ascii, unicode です。
\pset: 未定義のオプション：%s
\watchではCOPYを使用することができません
\watchを空の問い合わせで使用することができません
権限付与／剥奪の省略形 現在のトランザクションを中断する 読み込みに失敗したため異常終了しました アクセスメソッド型 アクション agg（集約） 集約関数の名前 集約関数の呼出し情報 別名 アラインメント 接続許可 常に 分析関数 集約関数の呼出し情報は以下の通り 競合時の動作は以下のいずれか: グループ化の要素は以下のいずれか: LIKE オプション： テーブル制約: またインデックスを使用するテーブルの制約条件は以下の通り: WITH問い合わせ： 入力データ型 引数名 引数の型 引数のモード 引数名 引数の型 引数 引数の型 引数 属性 属性名 属性オプション 基本の型 ブール値 キャッシュ 呼び出しハンドラー ２フェーズコミット用に事前準備されたトランザクションをキャンセルする ユーザによりキャンセルされました null ポインタを複製できません（内部エラー）。
有効な接続なしではエスケープできません
正規化関数 カテゴリー データベースを変更する データベースのロールを変更する 実行時パラメータを変更する サーバ設定パラメータを変更する ロールの名前またはメンバーシップを変更する 照合順序の定義を変更する エンコーディング変換ルールの定義を変更する ドメインの定義を変更する 外部サーバーの定義を変更する 外部テーブルの定義を変更する 外部データラッパーの定義を変更する 関数の定義を変更する ラージオブジェクトの定義を変更する マテリアライズドビューの定義を変更する 手続き言語の定義を変更する 行レベルセキュリティポリシーの定義を変更する ルールの定義を変更する スキーマの定義を変更する シーケンスジェネレーターの定義を変更する テーブルの定義を変更する テーブルスペースの定義を変更する テキスト検索設定の定義を変更する テキスト検索辞書の定義を変更する テキスト検索パーサの定義を変更する テキスト検索テンプレートの定義を変更する トリガの定義を変更する 型の定義を変更する ユーザマッピングの定義を変更する ビューの定義を変更する 集約関数の定義を変更する イベントトリガの定義を変更する 拡張の定義を変更する インデックスの定義を変更する 演算子の定義を変更する 演算子クラスの定義を変更する 演算子ファミリの定義を変更する あるデータベースロールが所有するデータベースオブジェクトの所有者を変更する チャネル CHECK評価式 子プロセスが終了コード %d で終了しました。 子プロセスが不明な状態%dにより終了しました。 子プロセスが例外 0x%X で終了させられました。 子プロセスがシグナル %d で終了させられました。 子プロセスがシグナル %s で終了させられました。 カーソルを閉じる インデックスに従ってテーブルをクラスタ化する コード 照合順序 照合順序 %s 照合順序 データベースの統計情報を収集する 列の別名 列制約 列定義 列名 列の型 交換用演算子 結合関数 コマンド コマンドは実行形式ではありません コマンドが見つかりません ２フェーズコミットのために事前に準備されたトランザクションをコミットする 現在のトランザクションをコミットする 行セットを計算します 条件 設定パラメータ 競合時の動作 競合対象 サーバーへの接続が切れました。
最大接続数 制約 制約名 ファイルとテーブル間でデータをコピーする ディレクトリ"%s"に移動できませんでした: %s 外部コマンドに対するパイプをクローズできませんでした: %s
コマンド"%s"を実行できませんでした: %s
実行に必要な "%s" が見つかりません。 ユーザID %ld のホームディレクトリを特定できません: %s
カレントディレクトリを識別できませんでした。: %s 一時ディレクトリに移動できません: %s
実効ユーザID %ld が見つかりませんでした: %s 一時ファイル "%s" を開けません: %s
reloptions配列の解析ができませんでした
バイナリファイル "%s" を読み込めませんでした。 入力ファイルから読み込めませんでした: %s
シンボリックリンク "%s" を読み込めませんでした。 ファイル "%s" にヒストリを保存できませんでした: %s
変数 "%s" をセットできませんでした
/bin/sh を起動できませんでした。
エディタ "%s" を起動できませんでした。
ファイル"%s"のstatができませんでした: %s
COPY 対象データを書き込めませんでした：%s
カウント 新しいデータベースを作成する テーブルに新しい行を作成する カーソル名 データ型 データベース名 プリペアドステートメントを開放する デフォルト default %s デフォルトの評価式 カーソルを定義する 新しいアクセスメソッドを定義する 新しい集約関数を定義する 新しいキャストを定義する 新しい照合順序を定義する 新しいデータ型を定義する データベースの新しいロールを定義する 新しいドメインを定義する 新しいエンコーディングの変換ルールを定義する 新しいイベントトリガを定義する 新しい外部サーバーを定義する 新しい外部テーブルを定義する 新しい外部データラッパーを定義する 新しい関数を定義する 新しいインデックスを定義する 外部サーバーに対してユーザの新しいマッピングを定義する 新しいマテリアライズドビューを定義する 新しい演算子を定義する 新しい演算子クラスを定義する 新しい演算子ファミリを定義する 新しい手続き言語を定義する 新しい書き換えルールを定義する テーブルに新しい行レベルセキュリティポリシーを定義する 現在のトランザクションに対して新しいセーブポイントを定義する 新しいスキーマを定義する 新しいシーケンスジェネレーターを定義する 新しいテーブルを定義する 問い合わせ結果から新しいテーブルを生成する 新しいテーブルスペースを定義する 新しいテキスト検索設定を定義する 新しいテキスト検索用辞書を定義する 新しいテキスト検索用パーサを定義する 新しいテキスト検索テンプレートを定義する 新しい変換を定義する 新しいトリガを定義する 新しいビューを定義する アクセス権限を定義する デフォルトのアクセス権限を定義する オブジェクトに適用されるセキュリティラベルを定義または変更する オブジェクトのコメントを定義または変更する 定義元 定義 DELETE句 テーブルの行を削除する デリミタ 区切り文字 デシリアライズ関数 変換先のエンコーディング 前回定義したセーブポイントを削除する 辞書名 方向 ディレクトリー 無効 セッションの状態を破棄する ドメイン制約 ドメイン制約 ドメイン名 要素 テーブルもしくはテーブルのセットを 0 件に切り詰める 有効 エンコーディング エンコーディング名 終了関数 行番号を指定するためにはPSQL_EDITOR_LINENUMBER_ARG変数を設定しなければなりません
エスケープ文字 イベント 排他要素 EXCLUDE における排他要素の制約条件： プリペアドステートメントを実行する 無名コードブロックを実行する 実行コスト 既存の照合順序 既存の列挙値 評価式 拡張名 ファミリー名 外部データラッパー 終了関数 ファイル名 フィルタ変数 テーブル "%s.%s" 用 トランザクションログのチェックポイントを強制設定する 外部テーブル フォーマット名 FROM 項目 FROM リスト SQLの型から変換する関数名 関数 関数名が必要です
関数名 ガーベジコレクションを行い、オプションでデータベースの分析をします 通知メッセージを生成する トークン取得用関数 グループ名 グループ化の要素 ハンドラ関数 見出し関数 この環境ではヒストリ機能をサポートしていません。
不変 外部サーバーからテーブル定義をインポートする 代入 増分 インデックス インデックスの列名 インデックスの評価式 インデックスメソッド インデックス名 インデックスのパラメーター UNIQUE, PRIMARY KEY, EXCLUDE におけるインデックスパラメーターの制約条件： インデックスの述語 初期処理関数 初期条件 インラインハンドラー 入力関数 INSERT句 拡張をインストールする 整数 内部長 "%s" は有効なバイナリファイルではありません。 \%sは無効なコマンドです
無効な行番号です: %s
出力フォーマットが無効（内部エラー）：%d 呼び出し元 テンプレートか 結合列 結合条件 JOIN手続き 結合種類 ラベル 言語 ラージオブジェクトのoid 照合順序 Ctype(変換演算子) 左辺の型 LEX 処理関数 LEX 型の関数 LIKE オプション: LIKEの型 リンクシンボル 通知メッセージを監視する 共有ライブラリファイルをロードする ローカルソケット ローカルスキーマ ロケール テーブルをロックする ロックモード ラージオブジェクトid マテリアライズドビュー 最大値 メンバオブジェクト メソッド 移動集約モードでの終了関数 移動集約モードでの初期条件 最小値 逆状態遷移関数 \gsetに対して複数の行が返されました
前方状態遷移関数 移動集約モードでの状態データの大きさ 移動集約モードでの状態データの型 名前 否定用演算子 新しい属性名 新しい列名 新しい制約名 新しい辞書 新しい列挙値 新しい名前 新しい所有者 新しいロール 新しいスキーマ 新しいテーブル テーブルスペース 新しいバージョン no 問い合わせバッファがありません。
\gsetに対して行が返されませんでした
normal（通常） not null null文字列 オブジェクトファイル名 オブジェクト名 オフ 元の辞書 元のロール 古いバージョン オン 演算子の型 演算子クラス 演算子 演算子クラス 演算子族 演算子名 オプション または古い構文 メモリ不足です メモリ不足です
出力表現 出力関数 出力名 パラメータ 親テーブル パーサー名 パスワード ペイロード pcloseが失敗しました: %s ポリシー名 カーソルを位置付ける 述語 推奨 実行に先立ってステートメントを準備する ２フェーズコミット用に現在のトランザクションを準備する プライマリキー, プロバイダ psql は PostgreSQL の会話型ターミナルです。
psql 変数:
問い合わせ 引用符文字 インデックスを再構築する 受信関数 参照列 非参照テーブル名 参照テーブル 拡張名 リモートスキーマ キャストを削除する 照合順序を削除する エンコーディング変換ルールを削除する データ型を削除する データベースを削除する データベースのロールを削除する ドメインを削除する 外部サーバー識別子を削除する 外部テーブルを削除する 外部データラッパーを削除する 関数を削除する マテリアライズドビューを削除する 手続き言語を削除する 書き換えルールを削除する テーブルから行レベルセキュリティポリシーを削除する スキーマを削除する シーケンスを削除する テーブルを削除する テーブルスペースを削除する テキスト検索設定を削除する テキスト検索用辞書を削除する テキスト検索用パーサを削除する テキスト検索用テンプレートを削除する 変換を削除する トリガを削除する 外部サーバーのユーザマッピングを削除 ビューを削除する アクセス権限を剥奪する アクセスメソッドを削除する 集約関数を削除する イベントトリガを削除する 拡張を削除する インデックスを削除する 演算子を削除する 演算子クラスを削除する 演算子ファミリを削除する 特定のデータベースロールが所有するデータベースオブジェクトを削除する マテリアライズドビューの内容を置き換える レプリカ 制約手続き 再開始値 実行時パラメータの値をデフォルト値に戻す restricted (制限) 結果の行数 カーソルを使って問い合わせから行を取り出す テーブルもしくはビューから行を取り出す 戻り値の型 書き換えルール名 右辺の型 ロール名 ロールの指定 セーブポイントまでロールバックする ルール ロール名 safe (安全) サンプリングメソッド セーブポイント名 スキーマ要素 スキーマ名 シード SELECT句 送信関数 シーケンス シーケンス名 シリアライズ関数 サーバー名 サーバーのタイプ サーバーのバージョン 現在のトランザクションに対して制約検査のタイミングを設定する 現在のトランザクションの特性を設定します 現在のセッションにおける現在のユーザ識別を設定する セッションのユーザ識別、および現在のセッションにおける現在のユーザ識別を設定する 状態遷移関数 ステートメントの実行プランを表示する 実行時パラメータの値を表示する 変数"%s"の再帰展開をスキップしています
スナップショットID ソート表現 ソートファミリー名 ソート演算子 ソース設定 変換元のエンコーディング ソースのテーブル ソースの型 特殊 安定 開始値 トランザクションブロックを開始する 開始関数 状態データの大きさ 状態データの型 ステートメント 通知メッセージの監視を中止する ストレージ ストレージパラメーター ストレージの型 ストラテジー番号 副問い合わせ 派生元型 派生元型差異関数 派生元型の演算子クラス サポート番号 問い合わせのタブ補完に失敗: %s
問い合わせは
%s
テーブル テーブル制約 テーブル制約 インデックスを使用するテーブル制約 テーブル名 テーブルスペース名 テーブルスペース・オプション 対象のロール ターゲットの型 テンプレート テキスト タイムスタンプ タイムゾーン SQLの型へ変換する関数名 トークンの型 トランザクション ID トランザクションのモード trigger（トリガ） トリガー名 コピーモードを終了しようとしています。 型 型修飾子の入力関数 型修飾子の出力関数 型名 ユーザーID 想定外のPQresultStatus: %d
\watchに対する想定外の結果状態
想定外のトランザクション状態 (%d)
ユニーク, unknown "%2$s" の不明な値 "%1$s"。"%3$s"と仮定します
unsafe (非安全) 文字列の引用符が閉じていません
UPDATE句 テーブルの行を更新する ユーザが存在しません ユーザ名の検索に失敗: エラーコード %lu ユーザ名 USING評価式 USING リスト バリデータ関数 バリデータ関数 値 VALUES句 バージョン ビュー ビュー名が必要です
ビューのオプション名 ビューのオプション値 揮発性 権限付与／剥奪の省略形は以下のいずれか： アクションは以下のいずれか： 集約関数の呼出し情報は以下の通り： 列制約： 競合対象は以下のいずれか: 制約条件： 方向は無指定もしくは以下のいずれか： イベントは以下のいずれか： FROM項目は以下のいずれか： ロックモードは以下のいずれか： メンバオブジェクトは以下の通り: オプションは以下のいずれか： オプションは以下の通り： ロールの指定は以下の通り: トランザクションのモードは以下のいずれか： window（ウィンドウ） ウィンドウ定義 ウィンドウ名 WITH問い合わせ WITH問い合わせ名 yes locale/ja/LC_MESSAGES/pg_dump-9.6.mo 0000644 00000213117 14751153420 0012473 0 ustar 00 �� � l � � �( �( ) X ) [ s) B �) ) * " <* x _* �* �* �* + A $+ N f+ P �+ I , 3 P, y �, G �, C F- N �- K �- v %. F �. > �. R "/ B u/ E �/ ? �/ L >0 3 �0 6 �0 Q �0 T H1 M �1 ? �1 � +2 � �2 ? r3 9 �3 5 �3 : "4 K ]4 B �4 D �4 � 15 3 �5 � �5 ? h6 D �6 x �6 6 f7 Q �7 O �7 F ?8 > �8 5 �8 > �8 E :9 A �9 O �9 H : B [: @ �: = �: O ; H m; ; �; , �; 4 < E T< 0 �< = �< , = F 6= D }= C �= F > 8 M> ? �> C �> =
? 4 H? 7 }? L �? = @ @ @@ J �@ < �@ L A , VA ( �A 5 �A E �A T (B }B 9 �B D �B G �B GC bC ? }C ' �C + �C e D ! wD , �D 4 �D 6 �D ( 2E / [E �E �E $ �E * �E 2 F B >F > �F J �F P G N \G H �G - �G "H 7H / JH zH 4 �H $ �H & �H *
I # 8I \I P {I C �I A J ( RJ {J �J �J �J = �J � (K
�K , �K � �K � �L , M HM p ]M e �M & 4N [N ` cN p �N 4 5O X jO _ �O E #P 1 iP 6 �P 4 �P * Q - 2Q D `Q . �Q + �Q + R ) ,R * VR > �R 8 �R ' �R = !S ) _S 1 �S �S @ �S 7 T 6 OT 6 �T < �T = �T 4 8U 3 mU b �U 9 V < >V t {V # �V , W 5 AW wW �W �W
�W ' �W �W % X *X / JX X zX & �X 0 �X . +Y ) ZY ) �Y �Y �Y �Y 3 �Y ( Z @Z ) SZ # }Z �Z �Z & �Z K [ & P[ w[ ! �[ ( �[ ' �[ \ # '\ K\ / k\ �\ �\ # �\ % �\ "] , ?] $ l] $ �] $ �] 6 �] ^ *^ B K^ � �^ � %_ �_ $ �_ < �_ 3 6` ' j` ' �` + �` ( �` ( a # 8a - \a � �a + Zb , �b ! �b & �b ' �b # $c Hc " gc 8 �c $ �c �c d Q 'd & yd a �d @ e 5 Ce ye " �e # �e , �e f ! 'f # If * mf # �f % �f 0 �f & g $ :g _g " ~g = �g 1 �g h #h 8h : Hh ) �h B �h P �h Ai Ti si �i " �i �i �i & �i & j % Fj 2 lj �j �j & �j ! �j ) k # Ck " gk �k r �k < l D Kl N �l F �l &m Em fm & �m , �m - �m n " n / ?n on �n ( �n @ �n o 'o Fo P ao �o > �o 1 p > 9p / xp Y �p > q Aq \q " zq �q & �q < �q r ' 2r ( Zr ' �r �r �r �r 1 �r + %s Qs % rs 3 �s �s �s " �s ; !t ]t lt 0 �t �t / �t u +u Hu . au I �u > �u D v ^v mv �v 7 �v 9 �v 6 w H Ew @ �w �w 3 �w & x 0 <x 6 mx / �x ( �x , �x *y " 9y \y vy �y h �y T z � fz 6 �z L { J m{ 9 �{ �{ $ | + &| R| g| �| �| �| 2 �| �| " } /} F} # X} |} �} / �} �} & �} ~ -~ # ?~ c~ $ w~ ) �~ �~ ! �~ % + / [ & { ' � � � 0 � . 8� ) g� + �� �� ـ 4 �� � ,� # �� * Ӂ �� � 0� ( F� o� " �� �� E �� # � ) (� , R� � �� �� ; �� � � � ' 1� Y� ' q� �� % �� ߄ �� B � 0 [� ! �� 8 �� : � "� >� 3 ]� 1 �� 1 Æ + �� $ !� $ F� h k� � ԇ y� �� g �� g � Z �� 6 ܊ * � � >� � � � � X 5� O �� � ތ g t� G ܍ � $� ` َ g :� c �� S � � Z� a � R O� q �� [ � X p� d ɒ | .� G �� J � z >� | �� j 6� h �� �
� � ʖ V �� J �� J G� @ �� ^ Ә K 2� � ~� �
� I �� � � R z� L ͛ � � K �� ^ �� � X� a ܝ T >� @ �� U Ԟ P *� P {� � ̟ F h� a �� d � R v� d ɡ R .� ? �� H �� =
� L H� 9 �� Z ϣ 7 *� b� p � U S� X �� O � C R� ^ �� F �� : <� O w� � ǧ a ]� d �� s $� F �� y ߩ . Y� 1 �� C �� H �� N G� �� g �� e � i g� Ѭ ( � P � < f� @ �� � � > r� H �� U �� U P� B �� K � 9 5� o� & �� + �� S � G 6� \ ~� h ۱ o D� n �� M #� U q� , dz � 8
� ! F� A h� & �� 9 Ѵ H � ) T� 5 ~� � �� X B� V �� 4 � ( '� , P� / }� , �� � ڷ � `� �� I � � Z� � ?� E � d� � �� � 1� 2 � � � "� � �� Q a� � �� � S� a � I C� N �� L � > )� 6 h� L �� A � > .� > m� < �� = �� ] '� Z �� = �� _ � 3 ~� F �� % �� = � = ]� 7 �� : �� C � = R� = �� = �� � � ; �� R �� � #� : �� L �� B F� 7 �� + �� �� �� 4 �
F� 5 T� : �� B �� � � 8 �� A �� 1 #� 5 U� 5 �� 0 �� $ �� � S #� @ w� �� ? �� C � 8 Y� 1 �� ; �� i � ; j� ; �� G �� A *� D l� ? �� B �� > 4� Z s� > �� 4
� 3 B� Q v� / �� ; �� < 4� D q� > �� S �� 0 I� + z� x �� � � � � 0 �� A � ; W� ` �� * �� F � ; f� ; �� @ �� : � > Z� �� K �� K � @ Q� G �� G �� D "� > g� J �� l �� D ^� > �� : �� � � F �� � �� V �� M �� 1 %� < W� ; �� T �� 8 %� C ^� > �� < �� 6 � 7 U� V �� D �� K )� / u� 7 �� l �� ; J� �� # �� �� : �� F "� j i� l �� ! A� 1 c� * �� �� : �� * � + E� - q� - �� , �� O �� 4 J� ; � ( �� S �� _ 8� 6 �� 5 �� � � $� H �� p 5� n �� m � 4 �� 7 �� ( �� I � ; c� A �� + �� %
� 8 3� & l� . �� @ �� ^ � % b� + �� : �� s �� 1 c� e �� F �� X B� G �� x �� T \� �� 1 �� 5 � 9� 7 Z� O �� �� > � 2 A� , t� �� �� �� ] �� C K� " �� 2 �� [ � $ A� # f� ; �� M � 1 � 4 F� I {� 4 � I �� 7 D� , |� ' �� O � L !� C n� I �� �� $ � 8� U N� a �� L � n S� m � 0� M P� D �� M � S 1� M �� D � B � [� 9 w� " �� A � ( � � ?� w � � O c % ~ � d V m � D � = " \ : 1 � 1 � " G A . � G � 7 ( 8 A a + � 1 � R ( T 7 } " � % � > � + = F i : � : � @ & C g L � 1 � @ * : k 4 � : � F
F ]
F �
R �
. > + m � � C � H .
1 w
' �
4 �
: + A + m " � � � 6 N 8 � ; � / � ' * R ^ Y + � � % � > ( \ # � 8 � 7 � ( C a ^ @ � ] " Y � 7 � & G 9 + � + � V � 5 0 D f � � � � s � � � � m � _ � � B � 8 � �
? � n n w ! � � � � H � � � � 0 � & � ` � a � � � � � # � ( � � ] � X � � � j D 0 � � : � )
V � � q T � � I � � � - ! y � � � � Y � � � � @ � j � � � � � G d T � ( - � � m D l � � � � � � 3 � � � � � � � � i � � ~ � � � 9 � � � � � � r � � � 7 � I � � L v � � R � 1 � � � � ; 2 � > 4 & � g � * � + � � � � � r f � � 1 x � v � , e � � u � � � /
� l < � / � 5 ^ z N [ i X J � + ' � \ � � C � � � # � 4 � H � Q = � B J V ~ W � � � q E K 7 6 C x � [ M � � | 8 � c o o w h s � � F " ? p � % p 9 � Z � � � � � c � \
� � 5 6 E @ � � } � � � g y K { R � � , $ � � A � � � � � S b > � Q � � � P N . � ; � � � � � ` � t ) � � � � � � � | � � t a � O = k " � G z � � U Y % � . � � � � � � � � F � � P 2 � Z � � b � � � � f � ' < * � � � _ � O ^ ] } S � � � $ W � � � � � L � � � : � � { A e � d � U � � � 3 � u h � M � k �
Connection options:
General options:
If -f/--file is not used, then the SQL script will be written to the standard
output.
If no database name is supplied, then the PGDATABASE environment
variable value is used.
If no input file name is supplied, then standard input is used.
Options controlling the output content:
Options controlling the restore:
The options -I, -n, -P, -t, -T, and --section can be combined and specified
multiple times to select multiple objects.
%s
%s [OPTION]...
%s [OPTION]... [DBNAME]
%s [OPTION]... [FILE]
--binary-upgrade for use by upgrade utilities only
--column-inserts dump data as INSERT commands with column names
--disable-dollar-quoting disable dollar quoting, use SQL standard quoting
--disable-triggers disable triggers during data-only restore
--enable-row-security enable row security
--enable-row-security enable row security (dump only content user has
access to)
--exclude-table-data=TABLE do NOT dump data for the named table(s)
--if-exists use IF EXISTS when dropping objects
--inserts dump data as INSERT commands, rather than COPY
--lock-wait-timeout=TIMEOUT fail after waiting TIMEOUT for a table lock
--no-data-for-failed-tables do not restore data of tables that could not be
created
--no-security-labels do not dump security label assignments
--no-security-labels do not restore security labels
--no-synchronized-snapshots do not use synchronized snapshots in parallel jobs
--no-tablespaces do not dump tablespace assignments
--no-tablespaces do not restore tablespace assignments
--no-unlogged-table-data do not dump unlogged table data
--quote-all-identifiers quote all identifiers, even if not key words
--role=ROLENAME do SET ROLE before dump
--role=ROLENAME do SET ROLE before restore
--section=SECTION dump named section (pre-data, data, or post-data)
--section=SECTION restore named section (pre-data, data, or post-data)
--serializable-deferrable wait until the dump can run without anomalies
--snapshot=SNAPSHOT use given snapshot for the dump
--strict-names require table and/or schema include patterns to
match at least one entity each
--use-set-session-authorization
use SET SESSION AUTHORIZATION commands instead of
ALTER OWNER commands to set ownership
-1, --single-transaction restore as a single transaction
-?, --help show this help, then exit
-?, --help show this help, then exit
-C, --create create the target database
-C, --create include commands to create database in dump
-E, --encoding=ENCODING dump the data in encoding ENCODING
-F, --format=c|d|t backup file format (should be automatic)
-F, --format=c|d|t|p output file format (custom, directory, tar,
plain text (default))
-I, --index=NAME restore named index
-L, --use-list=FILENAME use table of contents from this file for
selecting/ordering output
-N, --exclude-schema=SCHEMA do NOT dump the named schema(s)
-O, --no-owner skip restoration of object ownership
-O, --no-owner skip restoration of object ownership in
plain-text format
-P, --function=NAME(args) restore named function
-S, --superuser=NAME superuser user name to use for disabling triggers
-S, --superuser=NAME superuser user name to use in plain-text format
-S, --superuser=NAME superuser user name to use in the dump
-T, --exclude-table=TABLE do NOT dump the named table(s)
-T, --trigger=NAME restore named trigger
-U, --username=NAME connect as specified database user
-V, --version output version information, then exit
-V, --version output version information, then exit
-W, --password force password prompt (should happen automatically)
-Z, --compress=0-9 compression level for compressed formats
-a, --data-only dump only the data, not the schema
-a, --data-only restore only the data, no schema
-b, --blobs include large objects in dump
-c, --clean clean (drop) database objects before recreating
-c, --clean clean (drop) databases before recreating
-d, --dbname=CONNSTR connect using connection string
-d, --dbname=DBNAME database to dump
-d, --dbname=NAME connect to database name
-e, --exit-on-error exit on error, default is to continue
-f, --file=FILENAME output file name
-f, --file=FILENAME output file or directory name
-f, --file=FILENAME output file name
-g, --globals-only dump only global objects, no databases
-h, --host=HOSTNAME database server host or socket directory
-j, --jobs=NUM use this many parallel jobs to dump
-j, --jobs=NUM use this many parallel jobs to restore
-l, --database=DBNAME alternative default database
-l, --list print summarized TOC of the archive
-n, --schema=NAME restore only objects in this schema
-n, --schema=SCHEMA dump the named schema(s) only
-o, --oids include OIDs in dump
-p, --port=PORT database server port number
-r, --roles-only dump only roles, no databases or tablespaces
-s, --schema-only dump only the schema, no data
-s, --schema-only restore only the schema, no data
-t, --table=NAME restore named relation (table, view, etc.)
-t, --table=TABLE dump the named table(s) only
-t, --tablespaces-only dump only tablespaces, no databases or roles
-v, --verbose verbose mode
-v, --verbose verbose mode
-w, --no-password never prompt for password
-x, --no-privileges do not dump privileges (grant/revoke)
-x, --no-privileges skip restoration of access privileges (grant/revoke)
%s %s dumps a database as a text file or to other formats.
%s extracts a PostgreSQL database cluster into an SQL script file.
%s restores a PostgreSQL database from an archive created by pg_dump.
%s: %s Command was: %s
%s: WSAStartup failed: %d
%s: cannot specify both --single-transaction and multiple jobs
%s: could not connect to database "%s"
%s: could not connect to database "%s": %s
%s: could not connect to databases "postgres" or "template1"
Please specify an alternative database.
%s: could not get server version
%s: could not open the output file "%s": %s
%s: could not parse ACL list (%s) for database "%s"
%s: could not parse ACL list (%s) for tablespace "%s"
%s: could not parse server version "%s"
%s: could not re-open the output file "%s": %s
%s: dumping database "%s"...
%s: executing %s
%s: invalid number of parallel jobs
%s: maximum number of parallel jobs is %d
%s: option --if-exists requires option -c/--clean
%s: options -c/--clean and -a/--data-only cannot be used together
%s: options -d/--dbname and -f/--file cannot be used together
%s: options -g/--globals-only and -r/--roles-only cannot be used together
%s: options -g/--globals-only and -t/--tablespaces-only cannot be used together
%s: options -r/--roles-only and -t/--tablespaces-only cannot be used together
%s: options -s/--schema-only and -a/--data-only cannot be used together
%s: pg_dump failed on database "%s", exiting
%s: query failed: %s %s: query was: %s
%s: role name starting with "pg_" skipped (%s)
%s: running "%s"
%s: too many command-line arguments (first is "%s")
%s: unrecognized section name: "%s"
(The INSERT command cannot set OIDs.)
(The system catalogs might be corrupted.)
-C and -1 are incompatible options
COPY failed for table "%s": %s Consider using a full dump instead of a --data-only dump to avoid this problem.
Dumping the contents of table "%s" failed: PQgetCopyData() failed.
Dumping the contents of table "%s" failed: PQgetResult() failed.
Error from TOC entry %d; %u %u %s %s %s
Error message from server: %s Error while FINALIZING:
Error while INITIALIZING:
Error while PROCESSING TOC:
Exported snapshots are not supported by this server version.
NOTICE: there are circular foreign-key constraints on this table:
NOTICE: there are circular foreign-key constraints among these tables:
Password: Report bugs to <pgsql-bugs@postgresql.org>.
Synchronized snapshots are not supported by this server version.
Run with --no-synchronized-snapshots instead if you do not need
synchronized snapshots.
Synchronized snapshots are not supported on standby servers.
Run with --no-synchronized-snapshots instead if you do not need
synchronized snapshots.
TOC Entry %s at %s (length %s, checksum %d)
The command was: %s
The program "pg_dump" is needed by %s but was not found in the
same directory as "%s".
Check your installation.
The program "pg_dump" was found by "%s"
but was not the same version as %s.
Check your installation.
Try "%s --help" for more information.
Usage:
WARNING: aggregate function %s could not be dumped correctly for this database version; ignored
WARNING: archive is compressed, but this installation does not support compression -- no data will be available
WARNING: archive items not in correct section order
WARNING: archive was made on a machine with larger integers, some operations might fail
WARNING: bogus transform definition, at least one of trffromsql and trftosql should be nonzero
WARNING: bogus value in pg_cast.castfunc or pg_cast.castmethod field
WARNING: bogus value in pg_cast.castmethod field
WARNING: bogus value in pg_transform.trffromsql field
WARNING: bogus value in pg_transform.trftosql field
WARNING: bogus value in proargmodes array
WARNING: could not find operator with OID %s
WARNING: could not find where to insert IF EXISTS in statement "%s"
WARNING: could not parse proallargtypes array
WARNING: could not parse proargmodes array
WARNING: could not parse proargnames array
WARNING: could not parse proconfig array
WARNING: could not parse reloptions array
WARNING: could not resolve dependency loop among these items:
WARNING: don't know how to set owner for object type %s
WARNING: errors ignored on restore: %d
WARNING: ftell mismatch with expected position -- ftell used
WARNING: invalid creation date in header
WARNING: invalid type "%c" of access method "%s"
WARNING: line ignored: %s
WARNING: owner of aggregate function "%s" appears to be invalid
WARNING: owner of data type "%s" appears to be invalid
WARNING: owner of function "%s" appears to be invalid
WARNING: owner of operator "%s" appears to be invalid
WARNING: owner of operator class "%s" appears to be invalid
WARNING: owner of operator family "%s" appears to be invalid
WARNING: owner of schema "%s" appears to be invalid
WARNING: owner of table "%s" appears to be invalid
WARNING: requested compression not available in this installation -- archive will be uncompressed
WARNING: typtype of data type "%s" appears to be invalid
WARNING: unexpected extra results during COPY of table "%s"
You might not be able to restore the dump without using --disable-triggers or temporarily dropping the constraints.
a worker process died unexpectedly
aborting because of server version mismatch
actual file length (%s) does not match expected (%s)
allocating AH for %s, format %d
already connected to a database
archiver archiver (db) attempting to ascertain archive format
bad dumpId
bad table dumpId for TABLE DATA item
can only reopen input archives
cannot duplicate null pointer (internal error)
cannot restore from compressed archive (compression not supported in this installation)
child process exited with exit code %d child process exited with unrecognized status %d child process was terminated by exception 0x%X child process was terminated by signal %d child process was terminated by signal %s command not executable command not found compress_io compression is not supported by tar archive format
compression level must be in range 0..9
compressor active
connecting to database "%s" as user "%s"
connecting to database for restore
connecting to new database "%s"
connection needs password
connection to database "%s" failed: %s corrupt tar header found in %s (expected %d, computed %d) file position %s
could not change directory to "%s": %s could not close TOC file: %s
could not close archive file: %s
could not close compression library: %s
could not close compression stream: %s
could not close data file: %s
could not close directory "%s": %s
could not close input file: %s
could not close large object TOC file "%s": %s
could not close output file: %s
could not close tar member
could not close temporary file: %s
could not commit database transaction could not compress data: %s
could not create communication channels: %s
could not create directory "%s": %s
could not create large object %u: %s could not create worker process: %s
could not determine seek position in archive file: %s
could not execute query could not find a "%s" to execute could not find block ID %d in archive -- possibly corrupt archive
could not find block ID %d in archive -- possibly due to out-of-order restore request, which cannot be handled due to lack of data offsets in archive
could not find block ID %d in archive -- possibly due to out-of-order restore request, which cannot be handled due to non-seekable input file
could not find entry for ID %d
could not find file "%s" in archive
could not find function definition for function with OID %u
could not find header for file "%s" in tar archive
could not find parent extension for %s
could not find slot of finished worker
could not generate temporary file name: %s
could not get server_version from libpq
could not identify current directory: %s could not identify dependency loop
could not initialize compression library: %s
could not obtain lock on relation "%s"
This usually means that someone requested an ACCESS EXCLUSIVE lock on the table after the pg_dump parent process had gotten the initial ACCESS SHARE lock on the table.
could not open TOC file "%s" for input: %s
could not open TOC file "%s" for output: %s
could not open TOC file "%s": %s
could not open TOC file for input: %s
could not open TOC file for output: %s
could not open input file "%s": %s
could not open input file: %s
could not open large object %u: %s could not open large object TOC file "%s" for input: %s
could not open output file "%s": %s
could not open output file: %s
could not open temporary file
could not parse GRANT ACL list (%s) or REVOKE ACL list (%s) for object "%s" (%s)
could not parse default ACL list (%s)
could not parse initial GRANT ACL list (%s) or initial REVOKE ACL list (%s) for object "%s" (%s)
could not parse numeric array "%s": invalid character in number
could not parse numeric array "%s": too many numbers
could not read binary "%s" could not read directory "%s": %s
could not read from input file: %s
could not read from input file: end of file
could not read input file: %s
could not read symbolic link "%s" could not reconnect to database: %s could not set default_tablespace to %s: %s could not set default_with_oids: %s could not set search_path to "%s": %s could not set seek position in archive file: %s
could not set session user to "%s": %s could not start database transaction could not uncompress data: %s
could not write to blobs TOC file
could not write to large object (result: %lu, expected: %lu)
could not write to the communication channel: %s
creating %s "%s"
creating %s "%s.%s"
custom archiver definition of view "%s" appears to be empty (length zero)
did not find magic string in file header
direct database connections are not supported in pre-1.3 archives
directory "%s" does not appear to be a valid archive ("toc.dat" does not exist)
directory archiver directory name too long: "%s"
disabling triggers for %s
dropping %s %s
dumping contents of table "%s.%s"
enabling triggers for %s
entering main parallel loop
entering restore_toc_entries_parallel
entering restore_toc_entries_postfork
entering restore_toc_entries_prefork
entry ID %d out of range -- perhaps a corrupt TOC
error during backup
error during file seek: %s
error processing a parallel work item
error reading large object %u: %s error reading large object TOC file "%s"
error returned by PQputCopyData: %s error returned by PQputCopyEnd: %s executing %s %s
expected %d check constraint on table "%s" but found %d
expected %d check constraints on table "%s" but found %d
expected format (%d) differs from format found in file (%d)
failed sanity check, parent OID %u of table "%s" (OID %u) not found
failed sanity check, parent table OID %u of pg_rewrite entry OID %u not found
failed sanity check, parent table OID %u of sequence OID %u not found
failed to connect to database
failed to reconnect to database
file name too long: "%s"
file offset in dump file is too large
finding check constraints for table "%s.%s"
finding default expressions of table "%s.%s"
finding extension tables
finding inheritance relationships
finding the columns and types of table "%s.%s"
finished item %d %s %s
finished main parallel loop
flagging inherited columns in subtables
found unexpected block ID (%d) when reading data -- expected %d
function "%s" not found
identifying extension members
implied data-only restore
incomplete tar header found (%lu byte)
incomplete tar header found (%lu bytes)
index "%s" not found
input file appears to be a text format dump. Please use psql.
input file does not appear to be a valid archive
input file does not appear to be a valid archive (too short?)
input file is too short (read %lu, expected 5)
internal error -- WriteData cannot be called outside the context of a DataDumper routine
internal error -- neither th nor fh specified in tarReadRaw()
invalid ENCODING item: %s
invalid OID for large object
invalid OID for large object (%u)
invalid STDSTRINGS item: %s
invalid adnum value %d for table "%s"
invalid argument string (%s) for trigger "%s" on table "%s"
invalid binary "%s" invalid client encoding "%s" specified
invalid column number %d for table "%s"
invalid column numbering in table "%s"
invalid compression code: %d
invalid dependency %d
invalid dumpId %d
invalid line in large object TOC file "%s": "%s"
invalid message received from worker: "%s"
invalid number of parallel jobs
invalid output format "%s" specified
large-object output not supported in chosen format
last built-in OID is %u
launching item %d %s %s
missing index for constraint "%s"
moving from position %s to next member at file position %s
no item ready
no matching schemas were found
no matching schemas were found for pattern "%s"
no matching tables were found
no matching tables were found for pattern "%s"
no output directory specified
not built with zlib support
now at file position %s
option --if-exists requires option -c/--clean
options --inserts/--column-inserts and -o/--oids cannot be used together
options -c/--clean and -a/--data-only cannot be used together
options -s/--schema-only and -a/--data-only cannot be used together
out of memory
out of on_exit_nicely slots
parallel archiver parallel backup only supported by the directory format
parallel restore from non-seekable file is not supported
parallel restore from standard input is not supported
parallel restore is not supported with archives made by pre-8.0 pg_dump
parallel restore is not supported with this archive file format
pclose failed: %s pgpipe: could not accept connection: error code %d
pgpipe: could not bind: error code %d
pgpipe: could not connect socket: error code %d
pgpipe: could not create second socket: error code %d
pgpipe: could not create socket: error code %d
pgpipe: could not listen: error code %d
pgpipe: getsockname() failed: error code %d
processing %s
processing data for table "%s.%s"
processing item %d %s %s
processing missed item %d %s %s
query failed: %s query produced null referenced table name for foreign key trigger "%s" on table "%s" (OID of table: %u)
query returned %d row instead of one: %s
query returned %d rows instead of one: %s
query to get data of sequence "%s" returned %d row (expected 1)
query to get data of sequence "%s" returned %d rows (expected 1)
query to get data of sequence "%s" returned name "%s"
query to get rule "%s" for table "%s" failed: wrong number of rows returned
query to obtain definition of view "%s" returned more than one definition
query to obtain definition of view "%s" returned no data
query was: %s
read TOC entry %d (ID %d) for %s %s
reading column info for interesting tables
reading constraints
reading default privileges
reading dependency data
reading event triggers
reading extensions
reading foreign key constraints for table "%s.%s"
reading indexes
reading indexes for table "%s.%s"
reading large objects
reading policies
reading policies for table "%s.%s"
reading procedural languages
reading rewrite rules
reading row security enabled for table "%s.%s"
reading schemas
reading table inheritance information
reading transforms
reading triggers
reading triggers for table "%s.%s"
reading type casts
reading user-defined access methods
reading user-defined aggregate functions
reading user-defined collations
reading user-defined conversions
reading user-defined foreign servers
reading user-defined foreign-data wrappers
reading user-defined functions
reading user-defined operator classes
reading user-defined operator families
reading user-defined operators
reading user-defined tables
reading user-defined text search configurations
reading user-defined text search dictionaries
reading user-defined text search parsers
reading user-defined text search templates
reading user-defined types
reducing dependencies for %d
restored %d large object
restored %d large objects
restoring data out of order is not supported in this archive format: "%s" is required, but comes before "%s" in the archive file.
restoring large object with OID %u
sanity check on integer size (%lu) failed
saving database definition
saving encoding = %s
saving large objects
saving standard_conforming_strings = %s
schema "%s" not found
schema with OID %u does not exist
select() failed: %s
server version must be at least 7.3 to use schema selection switches
server version: %s; %s version: %s
setting owner and privileges for %s "%s"
setting owner and privileges for %s "%s.%s"
skipping item %d %s %s
skipping tar member %s
sorter table "%s" could not be created, will not restore its data
table "%s" not found
tar archiver this format cannot be read
transferring dependency %d -> %d to %d
trigger "%s" not found
unexpected COPY statement syntax: "%s"
unexpected data offset flag %d
unexpected policy command type: "%s"
unexpected section code %d
unexpected tgtype value: %d
unrecognized archive format "%s"; please specify "c", "d", or "t"
unrecognized command received from master: "%s"
unrecognized constraint type: %c
unrecognized data block type %d while restoring archive
unrecognized data block type (%d) while searching archive
unrecognized encoding "%s"
unrecognized file format "%d"
unrecognized object type in default privileges: %d
unrecognized proparallel value for function "%s"
unrecognized provolatile value for function "%s"
unsupported version (%d.%d) in file header
warning from original dump file: %s
worker process failed: exit code %d
wrote %lu byte of large object data (result = %lu)
wrote %lu bytes of large object data (result = %lu)
Project-Id-Version: PostgreSQL 9.6.3
Report-Msgid-Bugs-To: pgsql-bugs@postgresql.org
POT-Creation-Date: 2017-04-04 09:28+0900
PO-Revision-Date: 2013-08-18 12:05+0900
Last-Translator: Okano Naoki <okano.naoki@jp.fujitsu.com>
Language-Team: jpug-doc <jpug-doc@ml.postgresql.jp>
Language: ja
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Plural-Forms: nplurals=2; plural=n != 1;
接続オプション:
一般的なオプション;
-f/--file が指定されない場合、SQLスクリプトは標準出力に書き出されます。
データベース名が指定されなかった場合、環境変数PGDATABASEが使用されます
入力ファイル名が指定されない場合、標準入力が使用されます。
出力内容を制御するためのオプション:
リストア制御用のオプション:
オプション -I, -n, -P, -t, -T, と --section は複数のオブジェクトを選択するために
複数回組み合わせて指定することができます。
%s
%s [OPTION]...
%s [OPTION]... [DBNAME]
%s [OPTION]... [FILE]
--binary-upgrade 用途はアップグレードユーティリティのみ
--column-inserts 列名付きのINSERTコマンドでデータをダンプ
--disable-dollar-quoting ドル記号による引用符付けを行わず、SQL標準の引用符付けを使い
ます
--disable-triggers データのみのリストアをする際、トリガを無効にします
--enable-row-security 行セキュリティを有効にする
--enable-row-security 行セキュリティを有効化します
(現在のユーザがアクセスできる部分のみダンプします)
--exclude-table-data=TABLE 指定したテーブルのデータをダンプしません
--if-exists オブジェクトを削除する場合に IF EXISTS を使用します
--inserts COPYではなくINSERTコマンドでデータをダンプします
--lock-wait-timeout=TIMEOUT テーブルロックをTIMEOUT待ってから失敗
--no-data-for-failed-tables 作成できなかったテーッブルのデータはリストア
しません
--no-security-labels セキュリティラベルの割り当てをダンプしません
--no-security-labels セキュリティラベルをリストアしません
--no-synchronized-snapshots 並行ジョブにおいて同期化スナップショットを使用しません
--no-tablespaces テーブルスペースの割り当てをダンプしません
--no-tablespaces テーブル空間の割り当てをリストアしません
--no-unlogged-table-data ログを取らないテーブルのデータをダンプしません
--quote-all-identifiers すべての識別子をキーワードでなかったとしても引用符でくくります
--role=ROLENAME ダンプの前に SET ROLE を行います
--role=ROLENAME リストアに先立って SET ROLE します
--section=SECTION 指定したセクション（データ前部、データ、データ後部）をダンプ
--section=SECTION 指定されたセクション（データ前部、データ、データ後部）をリストア
--serializable-deferrable 例外なくダンプを実行できるようになるまで待機します
--snapshot=SNAPSHOT ダンプ用に与えられたスナップショットを使用します
--strict-names 少なくとも1つのエンティティとマッチするパターンを含む
テーブルおよびスキーマが必要です
--use-set-session-authorization
所有者をセットする際、ALTER OWNER コマンドの代わりに
SET SESSION AUTHORIZATION コマンドを使用します
-1, --single-transaction 単一のトランザクションとしてリストア
-?, --help このヘルプを表示し、終了します
-?, --help このヘルプを表示し、終了します
-C, --create 対象のデータベースを作成
-C, --create ダンプにデータベース生成用コマンドを含めます
-E, --encoding=ENCODING ENCODING符号化方式でデータをダンプ
-F, --format=c|d|t バックアップファイルの書式
（自動的に設定されるはずです）
-F, --format=c|d|t|p 出力ファイルの書式(custom, directory, tar,
plain text（デフォルト）)
-I, --index=NAME 指名したインデックスをリストア
-L, --use-list=FILENAME このファイルの内容に従って SELECT や
出力のソートを行います
-N, --exclude-schema=SCHEMA 指名されたスキーマをダンプしません
-O, --no-owner オブジェクトの所有権の復元を省略
-O, --no-owner プレインテキスト形式で、オブジェクト所有権の
復元を行いません
-P, --function=NAME(args) 指名された関数をリストア
-S, --superuser=NAME トリガを無効にするためのスーパーユーザの名前
-S, --superuser=NAME プレインテキスト形式で使用するスーパーユーザの
名前
-S, --superuser=NAME ダンプで使用するスーパーユーザのユーザ名を指定
-T, --exclude-table=TABLE 指定したテーブルをダンプしません
-T, --trigger=NAME 指名したトリガをリストア
-U, --username=NAME 指定したデータベースユーザで接続します
-V, --version バージョン情報を表示し、終了します
-V, --version バージョン情報を表示し、終了します
-W, --password パスワードプロンプトを強制表示します
（自動的に表示されるはずです）
-Z, --compress=0-9 圧縮形式における圧縮レベル
-a, --data-only データのみをダンプし、スキーマをダンプしません
-a, --data-only データのみをリストア。スキーマをリストアしません
-b, --blobs ラージオブジェクトと共にダンプします
-c, --clean 再作成前にデータベースオブジェクトを整理（削除）
-c, --clean 再作成前にデータベースを整理（削除）
-d, --dbname=CONSTR 接続文字列を用いた接続
-d, --dbname=データベース名 ダンプするデータベース
-d, --dbname=NAME 接続するデータベース名
-e, --exit-on-error エラー時に終了。デフォルトは継続
-f, --file=ファイル名 出力ファイル名
-f, --file=ファイル名 出力ファイルまたはディレクトリの名前
-f, --file=FILENAME 出力ファイル名です
-g, --globals-only グローバルオブジェクトのみをダンプし、データベースをダンプしません
-h, --host=HOSTNAME データベースサーバのホストまたはソケットディレクトリです
-j, --jobs=NUM ダンプ時に指定した数の並列ジョブを使用
-j, --jobs=NUM リストア時に指定した数の並列ジョブを使用
-l, --database=DBNAME 代替のデフォルトデータベースを指定
-l, --list アーカイブのTOCの要約を表示
-n, --schema=NAME 指定したスキーマのオブジェクトのみをリストア
-n, --schema=SCHEMA 指名したスキーマのみをダンプ
-o, --oids ダンプにOIDを含めます
-p, --port=PORT データベースサーバのポート番号です
-r, --roles-only ロールのみをダンプ。
データベースとテーブル空間をダンプしません
-s, --schema-only スキーマのみをダンプし、データはダンプしません
-s, --schema-only スキーマのみをリストア。データをリストアしません
-t, --table=NAME 指定されたリレーション(テーブル、ビュー、など)をリストア
-t, --table=TABLE 指定したテーブルのみをダンプ
-t, --tablespaces-only テーブル空間のみをダンプ。データベースとロールをダンプしません
-v, --verbose 冗長モード
-v, --verbose 冗長モードです
-w, --no-password パスワード入力を要求しない
-x, --no-privileges 権限(grant/revoke)をダンプしません
-x, --no-privileges アクセス権限(grant/revoke)の復元を省略
%s %sはデータベースをテキストファイルまたはその他の書式でダンプします。
%sはPostgreSQLデータベースクラスタをSQLスクリプトファイルに展開します。
%sはpg_dumpで作成したアーカイブからPostgreSQLデータベースをリストアします。
%s: %s コマンド: %s
%s: WSAStartupが失敗しました: %d
%s: --single-transaction と並列ジョブは同時には指定できません
%s: データベース"%s"へ接続できませんでした
%s: データベース"%s"へ接続できませんでした: %s
%s: "postgres"または"template1"データベースに接続できませんでした
他のデータベースを指定してください。
%s: サーババージョンを入手できませんでした
%s: 出力ファイル "%s" をオープンできませんでした: %s
%1$s: データベース"%3$s"のACLリスト(%2$s)を解析できませんでした
%1$s: テーブル空間"%3$s"のACLリスト(%2$s)を解析できませんでした
%s: サーババージョン"%s"を解析できませんでした
%s: 出力ファイル "%s" を再オープンできませんでした: %s
%s: データベース"%s"をダンプしています...
%s: %sを実行しています
%s: 無効な並行ジョブ数です
%s: 並行ジョブの最大数は%dです
%s: --if-exists オプションは -c/--clean オプションを必要とします
%s: -c/--clean と -a/--data-only は同時には使用できません
"%s: -d/--dbnameオプションと-f/--fileオプションは同時に使用できません
"%s: -g/--globals-onlyオプションと-r/--roles-onlyオプションは同時に使用できません
"%s: -g/--globals-onlyオプションと-t/--tablespaces-onlyオプションは同時
に使用できません
"%s: -r/--roles-onlyオプションと-t/--tablespaces-onlyオプション)は同時
に使用できません
%s: -s/--schema-only と -a/--data-only は同時には使用できません
%s: データベース"%s"に対するpg_dumpが失敗しました。終了します
%s: 問い合わせが失敗しました: %s %s: 問い合わせ: %s
%s: "pg_"で始まるロール名(%s)を飛ばします
%s: "%s"を実行しています
%s: コマンドライン引数が多すぎます(先頭は"%s")
%s: 不明なセクション名: "%s"
(INSERTコマンドではOIDを設定できません。)
(システムカタログが破損している可能性があります)
-C と -1 は互換性がありません
テーブル"%s"のコピーに失敗しました: %s この問題を回避するために--data-onlyダンプの代わりに完全なダンプを使用することを検討してください。
テーブル"%s"の内容のダンプに失敗: PQgetCopyData()が失敗しました。
テーブル"%s"の内容のダンプに失敗: PQgetResult()が失敗しました。
TOCエントリ%d; %u %u %s %s %sのエラーです
サーバのエラーメッセージ: %s 後処理中にエラーがありました:
初期処理中にエラーがありました:
TOC処理中にエラーがありました:
このバージョンのサーバーでは、エクスポートされたスナップショットをサポートしていません。
注意: 次のテーブルの中で外部キー制約の循環があります
注意: 次のテーブルの中で外部キー制約の循環があります
パスワード: 不具合は<pgsql-bugs@postgresql.org>まで報告してください。
同期化スナップショットはこのサーババージョンではサポートされていません。
同期化スナップショットが不要ならば--no-synchronized-snapshotsを付けて実
行してください。
同期化スナップショットはスタンバイサーバではサポートされていません。
同期化スナップショットが不要ならば--no-synchronized-snapshotsを付けて
実行してください。
%2$s のTOCエントリ %1$s (長さ %3$s、チェックサム %4$d)
次のコマンドでした: %s
プログラム"pg_dump"が%sで必要ですが、"%s"と同じディレクトリにありません
でした。
インストールの状況を確認してください。
プログラム"pg_dump"が"%s"にありましたが、%sと同じバージョンではありま
せんでした。
インストールの状況を確認してください。
詳細は "%s --help" を実行してください
使用方法:
警告: このデータベースバージョンの集約関数%sを正確にダンプできませんでした。(無視します)
警告: アーカイブは圧縮されていますが、このインストレーションでは圧縮機能をサポートしていません -- 利用できるデータはありません
警告: アーカイブ項目が正確にセクション順ではありません
警告: アーカイブはより大きなサイズの整数を持つマシンで作成されました。一部の操作が失敗する可能性があります
警告: 無効な変換定義があります。trffromsqlとtrftosqlの少なくともどちらかは非ゼロでなければなりません
警告: pg_cast.castfuncまたはpg_cast.castmethodフィールドに無効な値があります
警告: pg_cast.castmethod フィールドに無効な値があります
警告: pg_transform.trffromsql フィールドに無効な値があります
警告: pg_transform.trftosql フィールドに無効な値があります
警告: proargnames配列内におかしな値があります
警告: OID %sの演算子がありませんでした
警告: 文"%s"にIF EXISTSを挿入する場所がありませんでした
警告: proallargtypes配列の解析ができませんでした
警告: proargmodes配列の解析ができませんでした
警告: proargnames配列の解析ができませんでした
警告: proconfig配列の解析ができませんでした
警告: reloptions配列の解析ができませんでした
警告: これらの項目の中の依存関係のループを識別できませんでした
WARNING: オブジェクト種類%sに対する所有者の設定方法が不明です。
警告: リストアにてエラーを無視しました: %d
警告: ftellで想定位置との不整合がありました -- ftellが使用されました
警告: ヘッダ内の作成日付が無効です
警告: アクセスメソッド "%2$s" の型 "%1$c" は無効です
警告: 行を無視しました: %s
警告: 集約関数"%s"の所有者が無効なようです
警告: データ型"%s"の所有者が無効なようです
警告: 関数"%s"の所有者が無効なようです
警告: 演算子"%s"の所有者が無効なようです
警告: 演算子クラス"%s"の所有者が無効なようです
警告: 演算子族"%s"の所有者が無効なようです
警告: スキーマ"%s"の所有者が無効なようです
警告: テーブル"%s"の所有者が無効なようです
警告: 要求された圧縮方法はこのインストレーションで利用できません --アーカイブを圧縮しません
警告: データ型"%s"のtyptypeが無効なようです
警告: テーブル "%s" のCOPY中に想定外の余分な結果があります
--disable-triggersの使用または一時的な制約の削除を行わずにダンプをリストアすることはできないかもしれません。
ワーカープロセスが想定外に終了しました
サーババージョンの不整合のため処理を中断しています
実際のファイル長(%s)が期待値(%s)と一致しません
%sにAHを割り当てています。書式は%dです
データベースに接続済みでした
アーカイバ アーカイバ(db) アーカイブ書式の確認を試んでいます
不良dumpId
TABLE DATA項目に対する不良テーブルdumpId
入力アーカイブだけを再オープンできます
null ポインタを複製できません（内部エラー）。
圧縮されたアーカイブからリストアできません(導入されたバイナリには圧縮機能のサポートが組み込まれていません)
子プロセスが終了コード%dで終了しました 子プロセスが未知のステータス%dで終了しました 子プロセスが例外0x%Xで終了しました 子プロセスがシグナル%dで終了しました 子プロセスがシグナル%sで終了しました コマンドは実行形式ではありません コマンドが見つかりません compress_io tar アーカイブフォーマットでは圧縮をサポートしていません
圧縮レベルは 0..9 の範囲でなければなりません
圧縮処理が有効です
データベース"%s"にユーザ"%s"で接続しています
リストアのためにデータベースに接続しています
新しいデータベース"%s"に接続しています
この接続にはパスワードが必要です
データベース"%s"への接続が失敗しました: %s 破損したtarヘッダがファイル位置%4$sの%1$sにありました(期待値 %2$d、結果 %3$d)
ディレクトリ"%s"に移動できませんでした: %s TOCファイルをクローズできませんでした: %s
アーカイブファイルをクローズできませんでした: %s
圧縮ライブラリをクローズできませんでした: %s
圧縮用ストリームをクローズできませんでした: %s
データファイル%sをクローズできませんでした
ディレクトリ"%s"をクローズできませんでした: %s
入力ファイルをクローズできませんでした: %s
ラージオブジェクトTOCファイル"%s"をクローズできませんでした: %s
出力ファイルをクローズできませんでした: %s
tarメンバをクローズできませんでした
一時ファイルを開けませんでした：%s
データベーストランザクションをコミットできませんでした データを圧縮できませんでした: %s
通信チャンネルを作成できませんでした: %s
ディレクトリ"%s"を作成できませんでした: %s
ラージオブジェクト %u を作成できませんでした: %s ワーカープロセスを作成できませんでした: %s
アーカイブファイルのシーク位置を決定できませんでした: %s
問い合わせを実行できませんでした 実行する"%s"がありませんでした アーカイブ内にブロック ID %d がありませんでした -- おそらくアーカイブが壊れています
アーカイブ中にブロックID %d がありません -- おそらくリストア要求の順序が誤っているためです。この場合、アーカイブ中にオフセットの情報がないため処理できません
アーカイブ中にブロックID %d がありません -- おそらくリストア要求の順序が誤っているためです。この場合、入力ファイルがシーク不能となるので処理できません
ID %dのエントリがありませんでした
アーカイブ内にファイル"%s"がありませんでした
OID %u の関数定義を見つけられませんでした
tar アーカイブ内でファイル"%s"用のファイルヘッダがありませんでした
%sの親拡張がありませんでした
終了したワーカーのスロットの検索に失敗しました
一時ファイル名を生成できませんでした: %s
libpqからserver_versionを取り出せませんでした
現在のディレクトリを認識できませんでした: %s 依存関係のループを識別できませんでした
圧縮ライブラリを初期化できませんでした: %s
リレーション"%s"に対するロックを獲得できませんでした。
通常これは、pg_dumpの親プロセスが初期のACCESS SHAREロックを入手した後にだれかがテーブルに対してACCESS EXCLUSIVEロックを要求したことを意味しています。
入力用のTOCファイル"%s"をオープンできませんでした: %s
出力用のTOCファイル"%s"をオープンできませんでした: %s
TOCファイル"%s"をオープンできませんでした：%s
入力用のTOCファイルをオープンできませんでした: %s
出力用のTOCファイルをオープンできませんでした: %s
入力ファイル "%s" をオープンできませんでした: %s
入力ファイルをオープンできませんでした: %s
ラージオブジェクト %u をオープンできませんでした: %s ラージオブジェクトTOCファイル"%s"を入力用としてオープンできませんでした: %s
出力ファイル "%s" をオープンできませんでした: %s
出力ファイルをオープンできませんでした: %s
一時ファイルをオープンできませんでした
オブジェクト"%3$s"(%4$s)用のGRANT ACL リスト(%1$s) またはREVOKE ACL リスト(%2$s) を解析できませんでした
デフォルトの ACL リスト(%s)を解析できませんでした
オブジェクト"%3$s"(%4$s)用の初期のGRANT ACL リスト(%1$s) または初期のREVOKE ACL リスト(%2$s) を解析できませんでした
数値配列 "%s" の解析に失敗しました:数に無効な文字があります
数値配列 "%s" の解析に失敗しました:桁数が大きすぎます
バイナリ"%s"を読み取れませんでした ディレクトリ"%s"を読み取れませんでした: %s
入力ファイルから読み込めませんでした: %s
入力ファイルから読み込めませんでした: ファイルの終了です
入力ファイルを読み込めませんでした: %s
シンボリックリンク"%s"の読み取りに失敗しました データベース%sへの再接続ができませんでした default_tablespaceを%sに設定できませんでした: %s default_with_oidsを設定できませんでした: %s search_pathを"%s"に設定できませんでした: %s アーカイブファイルのシーク位置をセットできませんでした: %s
セッションユーザを"%s"に設定できませんでした: %s データベーストランザクションを開始できませんでした データを伸長できませんでした: %s
blobs TOCファイルに書き出せませんでした
ラージオブジェクトを書き出すことができませんでした(結果は%lu、期待値は%lu)
通信チャンネルに書き込めませんでした: %s
%s "%s"を作成しています
%s "%s.%s"を作成しています
カスタムアーカイバ ビュー\"%s\"の定義が空(長さが0)のようです
ファイルヘッダにマジック番号がありませんでした
1.3以前のアーカイブではデータベースへの直接接続はサポートされていません
"%s"ディレクトリは有効なアーカイブではないようです（""toc.dat"がありません）
ディレクトリアーカイバ ディレクトリ名称が長すぎます: "%s"
%sのトリガを無効にしています
%s %sを削除しています
テーブル "%s.%s" の内容をダンプしています
%sのトリガを有効にしています
メインの並列ループに入ります
restore_toc_entries_parallel に入ります
restore_toc_entries_postfork に入ります
restore_toc_entries_prefork に入ります
エントリID %dは範囲外です -- TOCの破損の可能性があります
バックアップ中にエラーがありました
ファイルシーク中にエラーがありました: %s
並行作業項目の処理でエラー
ラージオブジェクト %u を読み取り中にエラーがありました: %s ラージオブジェクトTOCファイル"%s"を読み取り中にエラーがありました
PQputCopyData からエラーが返されました: %s PQputCopyEnd からエラーが返されました: %s %s %sを実行しています
テーブル"%2$s"の検査制約は%1$dと期待していましましたが、%3$dありました
テーブル"%2$s"の検査制約は%1$dと期待していましましたが、%3$dありました
想定した書式(%d)はファイル内の書式(%d)と異なります
健全性検査に失敗しました。テーブル"%2$s"(OID %3$u)の親のOID %1$uがありませんでした
健全性検査に失敗しました。pg_rewrite項目OID %2$u の親テーブルOID %1$u がありません
健全性検査に失敗しました。シーケンスOID %2$u の親テーブルOID %1$u がありません
データベースへの接続に失敗しました
データベースへの再接続に失敗しました
ファイル名が長すぎます: "%s"
ダンプファイルのファイルオフセットが大きすぎます
テーブル"%s.%s"の検査制約を検索しています
テーブル"%s.%s"のデフォルト式を検索しています
拡張のテーブルを探しています
継承関係を検索しています
テーブル"%s.%s"の列と型を検索しています
項目 %d %s %s を完了しました
メインの並列ループを終了します
子テーブルの継承列にフラグを設定しています
データ読み込み時に想定外のブロックID(%d)がありました -- 期待値は%d
関数 "%s" が見つかりません
拡張のメンバを識別しています
データのみのリストアを目的としています
不完全なtarヘッダがありました(%luバイト)
不完全なtarヘッダがありました(%luバイト)
インデックス "%s" が見つかりません
入力ファイルがテキスト形式のダンプのようです。psqlを使用してください
入力ファイルが有効なアーカイブではないようです
入力ファイルが有効なアーカイブではないようです(小さすぎる?)
入力ファイルが小さすぎます(読み取り%lu、期待値 5)
内部的エラー -- WriteDataはDataDumper処理のコンテキスト外部では呼び出すことができません
内部エラー -- tarReadRaw()にてthもfhも指定されていませんでした
無効な ENCODING 項目：%s
ラージオブジェクトのOIDが無効です
ラージオブジェクトのOIDが無効です(%u)
無効なSTDSTRINGS 項目：%s
テーブル"%2$s"用のadnumの値%1$dが無効です
テーブル"%3$s"のトリガ"%2$s"用の引数文字列(%1$s)が無効です
バイナリ"%s"は無効です クライアントエンコーディング"%s"は無効です
テーブル"%2$s"の列番号%1$dは無効です
テーブル"%s"の列番号が無効です
無効な圧縮コード: %d
無効な依存関係 %d
無効なdumpId %d
ラージオブジェクトTOCファイル"%s"の中に無効な行がありました: "%s"
ワーカから無効なメッセージを受信しました: "%s"
無効な並行ジョブ数です
不明な出力書式"%s"が指定されました
選択した書式ではラージオブジェクト出力をサポートしていません
最終の組み込みOIDは%uです
項目 %d %s %s に着手します
制約"%s"用のインデックスが見つかりません
位置%sからファイル位置%sの次のメンバへ移動しています
準備ができている項目はありません
マッチするスキーマが見つかりません
パターン "%s" にマッチするスキーマが見つかりません
マッチするテーブルが見つかりません
パターン "%s" にマッチするテーブルが見つかりません
出力ディレクトリが指定されていません
zlibサポートがないビルドです。
現在のファイル位置は%sです
--if-exists オプションは -c/--clean オプションを必要とします
"--inserts/--column-insertsと-o/--oidsは同時には使用できません
-c/--clean と -a/--data-only は同時には使用できません
-s/--schema-only と -a/--data-only は同時には使用できません
メモリ不足です
on_exit_nicelyスロットの不足
並行アーカイバ 並行バックアップはディレクトリ書式でのみサポートされます
シークできないファイルからの平行リストアはサポートされていません
標準入力からの並行リストアはサポートされていません
8.0 以前の pg_dump で作られたアーカイブでは並列リストアをサポートしていません
このアーカイブファイルフォーマットでは並列リストアをサポートしていません
pcloseが失敗しました: %s pgpipe: 接続を受け付けられませんでした: エラーコード %d
pgpipe: バインドできませんでした: エラーコード %d
pgpipe: ソケットを作成できませんでした: エラーコード %d
pgpipe: 第二ソケットを作成できませんでした: エラーコード %d
pgpipe: ソケットを作成できませんでした: エラーコード %d
pgpipe: リッスンできませんでした: エラーコード %d
pgpipe: getsockname()が失敗しました: エラーコード %d
%sを処理しています
テーブル "%s.%s"のデータを処理しています
%d %s %s を処理しています
見つからなかった項目 %d %s %s を処理しています
問い合わせが失敗しました: %s テーブル"%2$s"上の外部キートリガ"%1$s"用の非参照テーブル名の問い合わせがNULLを返しました(テーブルのOID: %3$u)
問い合わせが1行ではなく%d行返しました: %s
問い合わせが1行ではなく%d行返しました: %s
シーケンス"%s"のデータを得るための問い合わせが%d行返しました(想定行数は1)
シーケンス"%s"のデータを得るための問い合わせが%d行返しました(想定行数は1)
シーケンス "%s"のデータを得るための問い合わせが名前 "%s" を返しました
テーブル"%2$s"用のルール"%1$s"を得るための問い合わせに失敗しました:行数が
間違っています
ビュー\"%s\"の定義を取り出すための問い合わせが複数の定義を返しました
ビュー"%s"の定義を取り出すための問い合わせが空を返しました
問い合わせ: %s
%3$s %4$s用にTOCエントリ%1$d(ID %2$d)を読み込みました
継承テーブル用の列情報を読み込んでいます
制約を読み込んでいます
デフォルトの権限設定を読み込んでいます
データの依存性を読み込んでいます
イベントトリガを読み込んでいます
拡張を読み込んでいます
テーブル"%s.%s"用の外部キー制約を読み込んでいます
インデックスを読み込んでいます
テーブル"%s.%s"用のインデックスを読み込んでいます
ラージオブジェクトを読み込んでいます
ポリシーを読み込んでいます
テーブル"%s.%s"用のポリシーを読み込んでいます
手続き言語を読み込んでいます
書き換えルールを読み込んでいます
テーブル "%s.%s" に有効な行セキュリティを読み込んでいます
スキーマを読み込んでいます
テーブルの継承情報を読み込んでいます
変換を読み込んでいます
トリガを読み込んでいます
テーブル"%s.%s"用のトリガを読み込んでいます
型キャストを読み込んでいます
ユーザ定義のアクセスメソッドを読み込んでいます
ユーザ定義の集約関数を読み込んでいます
ユーザ定義の照合順序を読み込んでいます
ユーザ定義の変換ルーチンを読み込んでいます
ユーザ定義の外国語サーバーを読み込んでいます
ユーザ定義の外国語データラッパーを読み込んでいます
ユーザ定義関数を読み込んでいます
ユーザ定義の演算子クラスを読み込んでいます
ユーザ定義の演算子群を読み込んでいます
ユーザ定義演算子を読み込んでいます
ユーザ定義のテーブルを読み込んでいます
ユーザ定義のテキスト検索設定を読み込んでいます
ユーザ定義のテキスト検索辞書を読み込んでいます
ユーザ定義テキスト検索パーサを読み込んでいます
ユーザ定義のテキスト検索テンプレートを読み込んでいます
ユーザ定義型を読み込んでいます
%d の依存関係を軽減しています
%d個のラージオブジェクトをリストアしました
%d個のラージオブジェクトをリストアしました
このアーカイブ書式では、順序外のデータのダンプはサポートされていません:"%s"を想定していましたが、アーカイブファイル内では"%s"の前にありました
OID %uのラージオブジェクトをリストアしています
整数のサイズ(%lu)に関する健全性検査が失敗しました
データベース定義を保存しています
encoding = %s を保存しています
ラージオブジェクトを保存しています
standard_conforming_strings = %s を保存しています
スキーマ "%s" が見つかりません
OID %uのスキーマが存在しません
select()が失敗しました: %s
スキーマ選択スイッチを使用するには、サーバのバージョンが
少なくとも 7.3 以降である必要があります。
サーババージョン: %s、%s バージョン: %s
%s "%s"用の所有者と権限を設定しています
%s "%s.%s"用の所有者と権限を設定しています
項目 %d %s %s をスキップしています
tarメンバ%sを飛ばしています
sorter テーブル "%s" を作成できませんでした。そのデータは復元されません
テーブル "%s" が見つかりません
tarアーカイバ この書式は読み込めません
%d -> %d から %d への依存関係を転送しています
トリガ "%s" が見つかりません
想定外のCOPY文の構文: "%s"
想定外のデータオフセットフラグ %d です
想定しないポリシーコマンドタイプ: "%s"
想定外のセクションコード %d
想定外のtgtype値: %d
未知のアーカイブフォーマット"%s"; "c"、"d"または"t"を指定してください
マスタから受け取ったコマンドが不明です: "%s"
制約種類が不明です: %c
アーカイブのりストア中に未知のデータブロック種類%dがありました
アーカイブの検索中に未知のデータブロック種類(%d)がありました
エンコーディング "%s" を認識できません
ファイル書式"%d"は不明です
デフォルト権限内の認識できないオブジェクト型: %d
関数"%s"のproparallel値が不明です
関数"%s"のprovolatile値が不明です
ファイルヘッダ内のバージョン(%d.%d)はサポートされていません
オリジナルのダンプファイルの警告: %s
ワーカープロセスが終了コード %d で終了しました
ラージオブジェクトの%luバイトを書き出しました(結果は%lu)
ラージオブジェクトの%luバイトを書き出しました(結果は%lu)
locale/ja/LC_MESSAGES/pg_basebackup-9.6.mo 0000644 00000077635 14751153420 0013643 0 ustar 00 �� � � � P Q k � � ! �
� - � X T \ R � ` I e D � � 3 K : < � j � > . N m @ � 3 � V 1 > � 1 � j � < d ? � M � k / J � Y � + @ 0 l B � B � * # 8 N � � 5 � L r � o G 1 � 3 � K - i F � \ � P ; 2 � 4 � 8 � 1 - 4 _ 1 � . � @ � 1 6 E h B � 7 � )! ( I! ' r! & �! ; �! ( �! - &" ' T" " |" �" # �" 2 �" , # + D# . p# ( �# # �# 5 �# f "$ , �$ 9 �$ 4 �$ 7 %% = ]% d �% A & " B& & e& & �& # �& / �& > ' a F' & �' & �' % �' 2 ( 1 O( 0 �( 8 �( ( �( 2 ) G) & h) ' �) . �) + �) # * A 6* 2 x* & �* & �* / �* + )+ 4 U+ / �+ ! �+ 1 �+ ) , ( 8, 2 a, 2 �, 3 �, 0 �, % ,- # R- + v- �- �- 2 �- # . (. , E. , r. # �. i �. i -/ 9 �/ " �/ A �/ # 60 Z0 9 {0 �0 �0 ! �0 D 1 & Q1 # x1 A �1 - �1 D 2 ! Q2 s2 �2 " �2 �2 9 �2 1 3 D R3 , �3 �3 ' �3 D �3 M D4 : �4 8 �4 6 5 =5 E V5 G �5 z �5 c _6 % �6 . �6 2 7 6 K7 # �7 �7 % �7 0 �7 R 8 , i8 4 �8 K �8 @ 9 > X9 - �9 , �9 ' �9 , : o G: k �: 4 #; % X; ( ~; ; �;
�; & �; < / < M< / \< � �< !> @> Y> u> ' �> �> A �> w ? r z? � �? � q@ h �@ Y dA �A J �A b B a ~B w �B c XC \ �C Y D 1 sD o �D M E Q cE Q �E L F P TF o �F m G U �G � �G - oH E �H | �H g `I @ �I L J � VJ I �J � HK �K � rL : �L @ 3M v tM 4 �M U N k vN _ �N W BO \ �O X �O _ PP T �P b Q P hQ � �Q < ?R K |R H �R @ S : RS ; �S = �S 7 T ` ?T F �T L �T H 4U F }U / �U 2 �U L 'V K tV K �V O W O \W I �W \ �W � SX I Y Y YY a �Y L Z I bZ � �Z _ h[ 9 �[ ? \ E B\ D �\ Q �\ e ] � �] G .^ F v^ ? �^ Q �^ W O_ d �_ W ` 6 d` N �` E �` R 0a E �a J �a J b C _b d �b W c G `c J �c Q �c M Ed X �d C �d C 0e Z te 9 �e 9 f _ Cf N �f a �f O Tg I �g E �g H 4h 2 }h �h : �h E i ) Ii = si @ �i 3 �i � &j � �j O �k + �k m
l ' {l & �l ` �l ) +m # Um % ym o �m 3 n . Cn e rn M �n o &o ; �o 5 �o / p ; 8p > tp _ �p Y q l mq M �q (r G Cr v �r q s J ts b �s S "t & vt q �t ~ u � �u � ?v ; �v I w O ^w I �w < �w 2 5x < hx h �x q y > �y G �y s z q {z t �z = b{ * �{ ' �{ ? �{ � 3| � �| D �} $ �} 6 �} i !~ �~ ? �~ �~ B �~ / V F � * � � o C $ e [ ] � j ? � � � � f � - R � � � � O < � s � } 2 B � p c { ; N 7 � � ) @ + Y � � � � � z & T J h � H G K ~ � t w X v � � � 9 � = � � . / � k 5 A U � � � q � � _ � � 6 � E
Z � S I , � � d # x � � Q y l P � � i � � u ^ � > � � V
� 0 n � ( � � \ : � � r � � � � 4 � g � M " 3 1 � D m � 8 a � � b F � % W � � � � ! � � | ` L � � � ' �
Action to be performed:
Connection options:
General options:
Optional actions:
Options controlling the output:
Options:
Report bugs to <pgsql-bugs@postgresql.org>.
--create-slot create a new replication slot (for the slot's name see --slot)
--drop-slot drop the replication slot (for the slot's name see --slot)
--if-not-exists do not error if slot already exists when creating a slot
--start start streaming in a replication slot (for the slot's name see --slot)
--synchronous flush transaction log immediately after writing
--xlogdir=XLOGDIR location for the transaction log directory
%s [OPTION]...
-?, --help show this help, then exit
-D, --directory=DIR receive transaction log files into this directory
-D, --pgdata=DIRECTORY receive base backup into directory
-F --fsync-interval=SECS
time between fsyncs to the output file (default: %d)
-F, --format=p|t output format (plain (default), tar)
-I, --startpos=LSN where in an existing slot should the streaming start
-P, --plugin=PLUGIN use output plugin PLUGIN (default: %s)
-P, --progress show progress information
-R, --write-recovery-conf
write recovery.conf after backup
-S, --slot=SLOTNAME name of the logical replication slot
-S, --slot=SLOTNAME replication slot to use
-T, --tablespace-mapping=OLDDIR=NEWDIR
relocate tablespace in OLDDIR to NEWDIR
-U, --username=NAME connect as specified database user
-V, --version output version information, then exit
-W, --password force password prompt (should happen automatically)
-X, --xlog-method=fetch|stream
include required WAL files with specified method
-Z, --compress=0-9 compress tar output with given compression level
-c, --checkpoint=fast|spread
set fast or spread checkpointing
-d, --dbname=CONNSTR connection string
-d, --dbname=DBNAME database to connect to
-f, --file=FILE receive log into this file, - for stdout
-h, --host=HOSTNAME database server host or socket directory
-l, --label=LABEL set backup label
-n, --no-loop do not loop on connection lost
-o, --option=NAME[=VALUE]
pass option NAME with optional value VALUE to the
output plugin
-p, --port=PORT database server port number
-r, --max-rate=RATE maximum transfer rate to transfer data directory
(in kB/s, or use suffix "k" or "M")
-s, --status-interval=INTERVAL
time between status packets sent to server (in seconds)
-s, --status-interval=SECS
time between status packets sent to server (default: %d)
-v, --verbose output verbose messages
-w, --no-password never prompt for password
-x, --xlog include required WAL files in backup (fetch mode)
-z, --gzip compress tar output
%*s/%s kB (%d%%), %d/%d tablespace %*s/%s kB (%d%%), %d/%d tablespaces %*s/%s kB (%d%%), %d/%d tablespace (%s%-*.*s) %*s/%s kB (%d%%), %d/%d tablespaces (%s%-*.*s) %*s/%s kB (100%%), %d/%d tablespace %*s %*s/%s kB (100%%), %d/%d tablespaces %*s %s controls PostgreSQL logical decoding streams.
%s receives PostgreSQL streaming transaction logs.
%s takes a base backup of a running PostgreSQL server.
%s: %s needs a slot to be specified using --slot
%s: COPY stream ended before last file was finished
%s: WAL streaming can only be used in plain mode
%s: at least one action needs to be specified
%s: can only write single tablespace to stdout, database has %d
%s: cannot specify both --xlog and --xlog-method
%s: cannot use --create-slot or --drop-slot together with --startpos
%s: cannot use --create-slot or --start together with --drop-slot
%s: cannot use --create-slot together with --drop-slot
%s: child %d died, expected %d
%s: child process did not exit normally
%s: child process exited with error %d
%s: child thread exited with error %u
%s: confirming write up to %X/%X, flush to %X/%X (slot %s)
%s: could not access directory "%s": %s
%s: could not close compressed file "%s": %s
%s: could not close directory "%s": %s
%s: could not close file "%s": %s
%s: could not connect to server
%s: could not connect to server: %s %s: could not create archive status file "%s": %s
%s: could not create background process: %s
%s: could not create background thread: %s
%s: could not create compressed file "%s": %s
%s: could not create directory "%s": %s
%s: could not create file "%s": %s
%s: could not create pipe for background process: %s
%s: could not create replication slot "%s": got %d rows and %d fields, expected %d rows and %d fields
%s: could not create symbolic link "%s": %s
%s: could not create symbolic link from "%s" to "%s": %s
%s: could not create timeline history file "%s": %s
%s: could not determine seek position in file "%s": %s
%s: could not determine server setting for integer_datetimes
%s: could not drop replication slot "%s": got %d rows and %d fields, expected %d rows and %d fields
%s: could not establish database-specific replication connection
%s: could not fsync file "%s": %s
%s: could not fsync log file "%s": %s
%s: could not get COPY data stream: %s %s: could not get backup header: %s %s: could not get child thread exit status: %s
%s: could not get transaction log end position from server: %s %s: could not identify system: got %d rows and %d fields, expected %d rows and %d or more fields
%s: could not initiate base backup: %s %s: could not open directory "%s": %s
%s: could not open log file "%s": %s
%s: could not open timeline history file "%s": %s
%s: could not open transaction log file "%s": %s
%s: could not pad transaction log file "%s": %s
%s: could not parse next timeline's starting point "%s"
%s: could not parse start position "%s"
%s: could not parse transaction log location "%s"
%s: could not read COPY data: %s %s: could not read directory "%s": %s
%s: could not read from ready pipe: %s
%s: could not receive data from WAL stream: %s %s: could not rename file "%s" to "%s": %s
%s: could not rename file "%s": %s
%s: could not seek to beginning of transaction log file "%s": %s
%s: could not send command to background pipe: %s
%s: could not send copy-end packet: %s %s: could not send feedback packet: %s %s: could not send replication command "%s": %s %s: could not set compression level %d: %s
%s: could not set permissions on directory "%s": %s
%s: could not set permissions on file "%s": %s
%s: could not stat file "%s": %s
%s: could not stat transaction log file "%s": %s
%s: could not wait for child process: %s
%s: could not wait for child thread: %s
%s: could not write %u bytes to WAL file "%s": %s
%s: could not write %u bytes to log file "%s": %s
%s: could not write timeline history file "%s": %s
%s: could not write to compressed file "%s": %s
%s: could not write to file "%s": %s
%s: creating replication slot "%s"
%s: directory "%s" exists but is not empty
%s: directory name too long
%s: disconnected
%s: disconnected; waiting %d seconds to try again
%s: dropping replication slot "%s"
%s: final receive failed: %s %s: finished segment at %X/%X (timeline %u)
%s: got WAL data offset %08x, expected %08x
%s: incompatible server version %s
%s: incompatible server version %s; client does not support streaming from server versions newer than %s
%s: incompatible server version %s; client does not support streaming from server versions older than %s
%s: integer_datetimes compile flag does not match server
%s: invalid --max-rate unit: "%s"
%s: invalid checkpoint argument "%s", must be "fast" or "spread"
%s: invalid compression level "%s"
%s: invalid fsync interval "%s"
%s: invalid output format "%s", must be "plain" or "tar"
%s: invalid port number "%s"
%s: invalid socket: %s %s: invalid status interval "%s"
%s: invalid tablespace mapping format "%s", must be "OLDDIR=NEWDIR"
%s: invalid tar block header size: %d
%s: invalid transfer rate "%s": %s
%s: invalid xlog-method option "%s", must be "fetch" or "stream"
%s: multiple "=" signs in tablespace mapping
%s: new directory is not an absolute path in tablespace mapping: %s
%s: no data returned from server
%s: no database specified
%s: no slot specified
%s: no target directory specified
%s: no target file specified
%s: no transaction log end position returned from server
%s: not renaming "%s%s", segment is not complete
%s: old directory is not an absolute path in tablespace mapping: %s
%s: only tar mode backups can be compressed
%s: out of memory
%s: received interrupt signal, exiting
%s: received transaction log record for offset %u with no file open
%s: replication connection using slot "%s" is unexpectedly database specific
%s: replication slots can only be used with WAL streaming
%s: replication stream was terminated before stop point
%s: segment file "%s" has incorrect size %d, skipping
%s: select() failed: %s
%s: server reported unexpected history file name for timeline %u: %s
%s: server reported unexpected next timeline %u, following timeline %u
%s: server returned unexpected response to BASE_BACKUP command; got %d rows and %d fields, expected %d rows and %d fields
%s: server stopped streaming timeline %u at %X/%X, but reported next timeline %u to begin at %X/%X
%s: starting background WAL receiver
%s: starting log streaming at %X/%X (slot %s)
%s: starting log streaming at %X/%X (timeline %u)
%s: starting timeline %u is not present in the server
%s: streaming header too small: %d
%s: streaming initiated
%s: switched to timeline %u at %X/%X
%s: symlinks are not supported on this platform
%s: system identifier does not match between base backup and streaming connection
%s: this build does not support compression
%s: too many command-line arguments (first is "%s")
%s: transaction log directory location can only be specified in plain mode
%s: transaction log directory location must be an absolute path
%s: transaction log file "%s" has %d bytes, should be 0 or %d
%s: transfer rate "%s" exceeds integer range
%s: transfer rate "%s" is not a valid value
%s: transfer rate "%s" is out of range
%s: transfer rate must be greater than zero
%s: unexpected response to TIMELINE_HISTORY command: got %d rows and %d fields, expected %d rows and %d fields
%s: unexpected result set after end-of-timeline: got %d rows and %d fields, expected %d rows and %d fields
%s: unexpected termination of replication stream: %s %s: unrecognized link indicator "%c"
%s: unrecognized streaming header: "%c"
%s: waiting for background process to finish streaming ...
Password: Try "%s --help" for more information.
Usage:
cannot duplicate null pointer (internal error)
out of memory
transaction log start point: %s on timeline %u
Project-Id-Version: PostgreSQL 9.6
Report-Msgid-Bugs-To: pgsql-bugs@postgresql.org
POT-Creation-Date: 2017-01-30 16:49+0900
PO-Revision-Date: 2013-08-18 11:17+0900
Last-Translator: <iwata.aya@jp.fujitsu.com>
Language-Team: jpug-doc <jpug-doc@ml.postgresql.jp>
Language: ja
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Plural-Forms: nplurals=2; plural=(n!=1);
:実行されるべき操作
接続オプション:
汎用のオプション:
追加操作:
出力を制御するオプション:
オプション:
不具合は<pgsql-bugs@postgresql.org>まで報告ください
--create-slot 新しいレプリケーションスロットを作成する(スロット名は--slotを参照)
--drop-slotp レプリケーションスロットを削除する (スロット名は--slotを参照)
--if-not-exists スロットを作成したときにスロットが既に存在しているならエラーとしない
--start レプリケーションスロットでストリーミングを開始する (スロット名は--slotを参照)
--synchronous トランザクションログは書き込み後すぐにフラッシュする
--xlogdir=XLOGDIR トランザクションログディレクトリの場所です
%s [OPTION]...
-?, --help このヘルプを表示し、終了します
-D, --directory=DIR 受信したトランザクションログの格納ディレクトリ
-D, --pgdata=DIRECTORY ディレクトリ内にベースバックアップを格納します
-F --fsync-interval=SECS
出力ファイルへのfsyncs 時間間隔(デフォルト: %d)
-F, --format=p|t 出力フォーマット（プレイン(デフォルト)またはtar）
-I, --startpos=LSN 既存スロットのストリーミングが始まるべき場所
-P, --plugin=PLUGIN 出力プラグインPLUGINを使用する(デフォルト: %s)
-P, --progress 進行状況の表示
-R, --write-recovery-conf
バックアップの後にrecovery.confを書き出す
-S, --slot=SLOT名 ロジカルレプリケーションスロット名
-S, --slot=スロット名 使用するレプリケーションスロット
-T, --tablespace-mapping=古いディレクトリ=新しいディレクトリ
-U, --username=NAME 指定したデータベースユーザで接続
-V, --version バージョン情報を表示し、終了します
-W, --password 強制的にパスワード入力を促す（自動的に行われるはずです）
-X, --xlog-method=fetch|stream
必要なWALファイルを指定した方法で含めます
-Z, --compress=0-9 指定した圧縮レベルでtar出力を圧縮します
-c, --checkpoint=fast|spread
高速チェックポイント処理または分散チェックポイント処理の設定
-d, --dbname=CONSTR 接続文字列
-d, --dbname=データベース名 接続するデータベース
-f, --file=FILE このファイルにログを受け取ります。 stdout に出力するには - を使います
-h, --host=HOSTNAME データベースサーバホストまたはソケットディレクトリ
-l, --label=LABEL バックアップラベルの設定
-n, --no-loop 接続がなくなった時に繰り返さない
-o, --option=NAME[=VALUE]
オプションの値VALUEと共にオプション名NAMEを
出力プラグインに渡す
-p, --port=PORT データベースサーバのポート番号
-r, --max-rate=RATE データディレクトリへ転送する際の最大転送速度
(kB/s で,または 接尾辞 "k" か"M" を使用)
-s, --status-interval=INTERVAL
サーバへ状態パケットを送信する間隔（秒単位）
-s, --status-interval=SECS
サーバへ状態パケットを送信する間隔（デフォルト: %d）
-v, --verbose 冗長メッセージの出力
-w, --no-password パスワード入力を促さない
-x, --xlog 必要なWALファイルをバックアップ内に含めます（フェッチモード）
-z, --gzip 出力を圧縮します
%*s/%s kB (%d%%), %d/%d テーブル空間 %*s/%s kB (%d%%), %d/%d テーブル空間 %*s/%s kB (%d%%), %d/%d テーブル空間 (%s%-*.*s) %*s/%s kB (%d%%), %d/%d テーブル空間 (%s%-*.*s) %*s/%s kB (100%%), %d/%d テーブル空間 %*s %*s/%s kB (100%%), %d/%d テーブル空間 %*s %s はPostgreSQLロジカルデコーディングストリームを制御します。
%sはPostgreSQLのトランザクションログストリーミングを受信します。
%sは実行中のPostgreSQLサーバのベースバックアップを取得します。
%s: %sオプションは--slot を使用してスロットを指定する必要があります
%s: 最後のファイルが終わる前にCOPYストリームが完了しました
%s: WALストリーミングはプレインモードでのみ使用することができます。
%s: 少なくとも一つのアクションを指定する必要があります
%s: データベースには%dありましたが、１つのテーブル空間のみ標準出力に書き出すことができます
%s: --xlogと--xlog-methodは同時に指定できません
%s: --create-slotや--drop-slotは--startposと共に使用できません
%s: --create-slotや--startは--drop-slotと共に使用できません
%s: --create-slot は --drop-slotと共に使用できません
%s: 子プロセス%d 終了、その期待値は%dです
%s: 子プロセスが正常に終わりませんでした
%s: 子プロセスが終了コード%dで終了しました
%s: 子スレッドがエラー%uで終了しました
%s: %X/%Xへの書き上げと, %X/%X (スロット %sへのフラッシュを確認します
%s: "%s"ディレクトリにアクセスできませんでした: %s
%s: "%s"圧縮ファイルを閉じることができませんでした: %s
%s: ディレクトリ "%s" をクローズできませんでした: %s
%s: ファイル"%s"を閉じることができませんでした: %s
%s: サーバに接続できませんでした
%s: サーバに接続できませんでした: %s %s: アーカイブ状態ファイル"%s"の作成に失敗しました: %s
%s: バックグランドプロセスを作成できませんでした: %s
%s: バックグランドスレッドを作成できませんでした: %s
%s: "%s"圧縮ファイルを作成することができませんでした: %s
%s: "%s"ディレクトリを作成することができませんでした: %s
%s: "%s"ファイルを作成することができませんでした: %s
%s: バックグランドプロセス用のパイプを作成できませんでした: "%s"
%s: レプリケーションスロット"%s"を作成できませんでした; %d行と%dフィールドを取得しましたが、期待していたのは%d行と%dフィールドです
%s: シンボリックリンク"%s"を作成できませんでした: %s
%s: "%s"から"%s"へのシンボリックリンクを作成できませんでした: %s
%s: "%s"タイムライン履歴ファイルを作成することができませんでした: %s
%s: ファイル"%s"のシーク位置を決定できませんでした: %s
%s: integer_datetimesのサーバ設定を決定できませんでした
%s: レプリケーションスロット"%s"を削除できませんでした; %d行と%dフィールドを取得しましたが、期待していたのは%d行と%dフィールドです
%s: データベース指定のレプリケーション接続が確立できませんでした
%s: ファイル"%s"をfsyncできませんでした: %s
%s: ログファイル"%s"をfsyncできませんでした: %s
%s: COPYデータストリームを入手できませんでした: %s %s: バックアップヘッダを入手できませんでした: %s %s: 子スレッドの終了ステータスを入手できませんでした: %s
%s: サーバからトランザクションログの終了位置を入手できませんでした: %s %s: システムを識別できませんでした: %d行と%dフィールドを取得しましたが、期待していたのは%d行と%d以上のフィールドです
%s: ベースバックアップを初期化できませんでした: %s %s: ディレクトリ"%s"をオープンできませんでした: %s
%s: ログファイル "%s" をオープンできません: %s
%s: タイムライン履歴ファイル "%s" をオープンできません: %s
%s: トランザクションログファイル "%s" をオープンできません: %s
%s: トランザクションログファイル"%s"を埋めることができませんでした: %s
%s: 次のタイムラインの開始ポイント"%s"を解析できませんでした
%s: 開始位置"%s"を解析できませんでした
%s: トランザクションログ位置"%s"を解析できませんでした
%s: COPYデータを読み取ることができませんでした: %s %s: ディレクトリ"%s"を読み取ることができませんでした。: %s
%s: 準備されたパイプから読み込めませんでした: %s
%s: WALストリームからデータを受信できませんでした: %s %s: ファイル"%s"の名前を"%s"に変更できませんでした: %s
%s: "%s"ファイルの名前を変更できませんでした: %s
%s: トランザクションログファイル"%s"の先頭にシークできませんでした: %s
%s: バックグランドパイプにコマンドを送信できませんでした: %s
%s: コピーエンドパケットを送信できませんでした: %s %s: フィードバックパケットを送信できませんでした: %s %s: レプリケーションコマンド"%s"を送信できませんでした: %s %s: 圧縮レベルを%dに設定することができませんでした: %s
%s: "%s"ディレクトリの権限を設定することができませんでした: %s
%s: "%s"ファイルの権限を設定できませんでした: %s
%s: "%s"ファイルの状態を確認できませんでした: %s
%s: トランザクションログファイル "%s" の状態を確認できません: %s
%s: 子プロセスを待機できませんでした: %s
%s: 子スレッドを待機できませんでした: %s
%1$s: WALファイル"%3$s"に%2$uバイト書き出すことができませんでした: %4$s
%s: %uバイトをログファイル"%s"に書き込めませんでした: %s
%s: "%s"タイムライン履歴ファイルに書き出すことができませんでした: %s
%s: "%s"圧縮ファイルに書き出すことができませんでした: %s
%s: "%s"ファイルに書き出すことができませんでした: %s
%s: レプリケーションスロット"%s"を作成しています
%s: "%s"ディレクトリは存在しますが空ではありません
%s: ディレクトリの名前が長すぎます
%s: 切断しました
%s: 切断しました。%d秒待機し再試行します
%s: レプリケーションスロット"%s"を削除しています
%s: 最終受信に失敗しました: %s %s: %X/%X (タイムライン %u)でセグメントが完了
%s: WALデータオフセット%08xを入手。想定値は%08x
%s: 互換性がないサーババージョン"%s"
%s: 互換性のないサーババージョン%sです; クライアントは%sより新しいサーババージョンからのストリーミングをサポートしていません
%s: 互換性のないサーババージョン%sです; クライアントは%sより古いサーババージョンからのストリーミングをサポートしていません
%s: integer_datetimesコンパイルフラグがサーバと一致しません
%s: 無効な --max-rate単位です: "%s"
%s: "%s"チェックポイント引数は無効です。"fast"または"spreadでなければなりません
%s: "%s"圧縮レベルは無効です
%s: 無効なfsyncの間隔"%s"です
%s: "%s"出力フォーマットは無効です。"plain"か"tar"でなければなりません
%s: 無効なポート番号です: "%s"
%s: 無効なソケットです: %s %s: "%s" 状態間隔は無効です
%s: 無効なテーブル空間マッピング形式"%s"です。"OLDDIR=NEWDIR"でなければなりません
%s: 無効なtarブロックヘッダサイズ: %d
%s: 転送速度"%s"が無効な値です: %s
%s: "%s" xlog方式は無効です。"fetch"、"stream"のいずれかでなければなりません
%s: 複数の"="記号がテーブル空間マッピングに存在します
%s: 新しいディレクトリはテーブル空間マッピングでは絶対パスではありません: %s
%s: サーバから返されるデータがありません
%s: データベースが指定されていません
%s: スロットが指定されていません
%s: 対象ディレクトリが指定されていません
%s: ターゲットファイルが指定されていません
%s: サーバからトランザクションログの終了位置が返されませんでした
%s: "%s%s"の名前を変更しません。セグメントが完了していません。
%s: 古いディレクトリはテーブル空間マッピングでは絶対パスではありません: %s
%s: tarモードのバックアップのみ圧縮することができます
%s: メモリ不足です
%s: 割り込みシグナルを受け取りました。終了します
%s: ファイルオープンがないオフセット%uに対するトランザクションログレコードを受信
%s: スロット "%s" を使用するレプリケーション接続は予想外のデータベース特定です
%s: WAL ストリーミングはplainモードでのみ使用できます
%s: レプリケーションストリームがストップポイントの前に終了しました
%s: セグメントファイル"%s"のサイズ%dが不正です。飛ばします
%s: select()が失敗しました: %s
%s: サーバはライムライン%u用の履歴ファイルが想定外であることを報告しました: %s
%1$s: サーバがタイムライン%3$uに続く次のタイムライン%2$uが想定外であることを報告しました
%s: サーバはBASE_BACKUPコマンドに想定外の応答を返しました: %d行と%dフィールドを入手しました。想定では%d行と%dフィールドでした
%s: サーバはストリーミングタイムライン%uを%X%Xで停止しました。しかし次のタイムライン%uが%X%Xで始まりました
%s: バックグランドWAL受信処理を開始します
%s: %X/%X (スロット %s)でログストリーミングを始めます
%s: %X/%X (タイムライン %u)でログストリーミングを始めます
%s: 開始するタイムライン%uがサーバ上に存在しません
%s: ストリーミングヘッダが小さ過ぎます: %d
%s: ストリーミングを初期化しました
%s: タイムライン%uに%X/%Xで切り替わりました
%s: シンボリックリンクはこのプラットフォームではサポートされていません
%s: システム識別子がベースバックアップとストリーミング接続の間で一致しません
%s: この構築では圧縮をサポートしていません
%s: コマンドライン引数が多過ぎます(最初は"%s"です)
%s: トランザクションログの格納ディレクトリの場所はplainモードでのみ指定できます
%s: トランザクションログのディレクトリの位置は、絶対パスでなければなりません
%s: トランザクションログファイル"%s"は%dバイトです。0または%dでなければなりません
%s: 転送速度"%s"がintegerの範囲を超えています
%s: 転送速度"%s"が無効な値です
%s: 転送速度"%s"が範囲外です
%s: 転送速度は0より大きくなければなりません
%s: TIMELINE_HISTORYコマンドへの想定外の応答: %d行と%dフィールドを入手しました。想定では%d行と%dフィールドでした
%s: タイムラインの終了後の想定外の結果セット: %d行、%dフィールドを入手しましたが、想定していたのは%d行、%dフィールドでした
%s: レプリケーションストリームの想定外の終了: %s %s: 未知のリンク指示子"%c"
%s: ストリーミングヘッダ"%c"は不明です
%s: ストリーミング処理が終わるまでバックグランドプロセスを待機します ...
パスワード: 詳細については"%s --help"を実行してください。
使用方法:
null ポインタを複製できません（内部エラー）。
メモリ不足です
トランザクションログの開始ポイント: タイムライン%2$u上の%1$s
locale/ja/LC_MESSAGES/ecpglib6-9.6.mo 0000644 00000010424 14751153420 0012527 0 ustar 00 �� ! $ / , � � � � ) ' - Q : 0 � $ � ( 9 L * c ; � > � 3 < = & z 1 � � + � ' @ % Y � , � � 2 0 ; / l � � # 5 ; ; B ~ = � U � h $
_ �
= �
J + ' v 2 � V � S ( e | \ � h ?
= �
\ �
; C C ; � , � ' , 2 T / � I � L A N A � A �
! <DEFAULT> <empty> NULL SQL error %d on line %d SQL error: %s
connection "%s" does not exist on line %d could not connect to database "%s" on line %d could not convert boolean value: size mismatch, on line %d data read from server is not an array on line %d descriptor "%s" not found on line %d descriptor index out of range on line %d empty message text empty query on line %d error in transaction processing on line %d inserting an array of variables is not supported on line %d invalid input syntax for floating-point type: "%s", on line %d invalid input syntax for type int: "%s", on line %d invalid input syntax for type unsigned int: "%s", on line %d invalid statement name "%s" on line %d invalid syntax for type boolean: "%s", on line %d no data found on line %d not connected to connection "%s" on line %d null value without indicator on line %d out of memory on line %d the connection to the server was lost too few arguments on line %d too many arguments on line %d unrecognized descriptor item "%s" on line %d unsupported type "%s" on line %d variable does not have a character type on line %d variable does not have a numeric type on line %d variable does not have an array type on line %d Project-Id-Version: PostgreSQL 9.0 beta 3
Report-Msgid-Bugs-To: pgsql-bugs@postgresql.org
POT-Creation-Date: 2010-07-20 12:52+0900
PO-Revision-Date: 2013-09-04 20:34-0400
Last-Translator: HOTTA Michihide <hotta@net-newbie.com>
Language-Team: Japanese
Language: ja
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Plural-Forms: nplurals=1; plural=0;
<デフォルト> <空> ヌル 行番号%2$dにおいて、SQLエラー%1$dがあります SQLエラー: %s
行番号%2$dにおいて、接続"%1$s"は存在しません 行番号%2$dにおいて、データベース"%1$s"に接続できませんでした 行番号%dにおいて、論理型に変換できませんでした。サイズが合っていません 行番号%dにおいて、サーバから読み込んだデータは配列ではありません 行番号%2$dにおいて、記述子"%1$s"がありません 行番号%dにおいて、記述子のインデックスが範囲外です メッセージテキストが空です 行番号%dにおいて問い合わせが空です 行番号%dにおいて、トランザクション処理がエラーになりました 行番号%dにおいて、変数の配列への挿入はサポートされません 行番号%2$dにおいて、浮動小数点型に対して無効な入力構文があります:"%1$s" 行番号%2$dにおいて、整数型に対して無効な入力構文があります:"%1$s" 行番号%2$dにおいて、符号無し整数型に対して無効な入力構文があります:"%1$s" 行番号%2$dにおいて、文の名前"%1$s"が無効です 行番号%2$dにおいて、論理型に対して無効な入力構文があります:"%1$s" 行番号%dにおいてデータがありませんでした 行番号%2$dにおいて、接続"%1$s"に接続していません 行番号%dにおいて、指示子が無いヌル値です 行番号%dにおいてメモリ不足です サーバへの接続が切れました 行番号%dにおいて引数が少なすぎます 行番号%dにおいて引数が多すぎます 行番号%2$dにおいて、記述子項目"%1$s"が認識できません 行番号%2$dにおいて未サポートのデータ型"%1$s"があります 行番号%dにおいて、変数は文字型ではありません 行番号%dにおいて、変数は数値型ではありません 行番号%dにおいて、変数は配列型ではありません locale/ja/LC_MESSAGES/pgscripts-9.6.mo 0000644 00000072502 14751153420 0013057 0 ustar 00 �� � | � 0 K 1 }
� > � > � = - Z � � C A d � � # � � ( 9 I V E � � > f ; � = � : < Z 9 � 6 � 5 C > C � 9 � 4 E 5 = { . � ; � E $ : j ? � A � < ' 9 d 7 � 4 � L J X 3 � H � E B f A � 5 � 2 ! N T 7 � 2 � 2 J A : � 5 � G � 0 E < v 0 � ) � M J \ G � 4 � C $! H h! E �! D �! = <" v z" < �" � .# Q �# I $ @ N$ 5 �$ 4 �$ 1 �$ 0 ,% ; ]% 5 �% ' �% 6 �% 3 .& 4 b& @ �& ; �& ; ' ` P' 8 �' 2 �' 9 ( 6 W( > �( �( / �( < ) # F) # j) ? �) 8 �) % * # -* Q* 3 q* & �* �* E �* 6 + E P+ F �+ K �+ 7 ), K a, 7 �, J �, 6 0- < g- D �- 5 �- . * =. 8 h. 6 �. ( �. 4 / $ 6/ # [/ / �/ �/ 8 �/ 4 0 $ E0 j0 , �0 , �0 ( �0 /
1 ; =1 9 y1 ! �1 �1 �1 �1 * 2 8 F2 9 2 , �2 8 �2 # 3 4 C3 3 x3 �3 ) �3 7 �3 +4
@4 N4 C c4 A �4 ! �4 + 5 75 H5 d5 �5 . �5 3 �5 2 6 56 B6 G6
d6 o6 �6 �6 ' �6 " �6 2 7 7 87 p7 & y7 �7 �7 / �7 + �7 * 8 F8 H8 K8 W8 d8 s8 �8 �8 ( �8 �8 �8 � �8 b �: �: �: O ; U b; N �; J < � R< P := N �= �= 2 �= < > 2 \> ; �> ) �> e �> Z [? k �? P "@ M s@ Y �@ V A J rA J �A J B J SB q �B � C P �C J �C e ?D I �D ; �D M +E e yE \ �E b <F b �F n G _ qG B �G E H o ZH o �H E :I P �I P �I P "J P sJ S �J O K � hK L �K S 6L V �L q �L Y SM L �M R �M N MN d �N U O < WO Y �O M �O S <P A �P Y �P o ,Q n �Q p R l |R k �R D US � �S \ MT \ �T P U P XU R �U O �U O LV G �V D �V J )W J tW G �W Y X ` aX c �X s &Y u �Y M Z Y ^Z G �Z C [ P D[
�[ J �[ x �[ 8 d\ 5 �\ X �\ M ,] J z] 8 �] / �] @ .^ : o^ �^ q �^ _ #_ z �_ � �_ � ` k a � ra t �a � hb t �b @ ^c j �c a
d < ld E �d ` �d V Pe ? �e S �e V ;f 8 �f 9 �f 8 g # >g X bg U �g 8 h , Jh ; wh / �h ; �h 3 i O Si M �i 1 �i , #j Pj E ij N �j i �j r hk P �k r ,l 2 �l D �l B m 5 Zm > �m \ �m ,n @n + Vn t �n q �n : io 8 �o ' �o ' p ' -p / Up G �p > �p @ q Mq dq 4 kq �q + �q . �q
r , r < Jr Z �r W �r :s 3 Cs ws " �s B �s ; �s ; (t dt ft it " �t �t �t �t �t 6 u <u >u � � 9 � � t � � � I S � w & % � � � � G � � - . � � X � { � " � 7 � o � � < � � � L � 4 / K i u � J � ~ B m ( � � � � * �
n f H p � # D g @ ' > � � U � v � x [ � 3
N � � k ! � 8 , � Y F ; � z � � Z � T � � 6 r M � + a 2 W � � $ ] _ � � } = s � j � � ? � ` � c | � l \ V � � � � � E ) : q � � Q C b 1 0 h A y � d R ^ O � � � � � � 5 � � � e P
By default, a database with the same name as the current user is created.
Connection options:
Options:
Read the description of the SQL command CLUSTER for details.
Read the description of the SQL command REINDEX for details.
Read the description of the SQL command VACUUM for details.
Report bugs to <pgsql-bugs@postgresql.org>.
--analyze-in-stages only update optimizer statistics, in multiple
stages for faster results; no vacuum
--lc-collate=LOCALE LC_COLLATE setting for the database
--lc-ctype=LOCALE LC_CTYPE setting for the database
%s [OPTION]...
%s [OPTION]... DBNAME
%s [OPTION]... LANGNAME [DBNAME]
%s [OPTION]... [DBNAME]
%s [OPTION]... [DBNAME] [DESCRIPTION]
%s [OPTION]... [ROLENAME]
--if-exists don't report error if database doesn't exist
--if-exists don't report error if user doesn't exist
--interactive prompt for missing role name and attributes rather
than using defaults
--maintenance-db=DBNAME alternate maintenance database
--maintenance-db=DBNAME alternate maintenance database
--no-replication role cannot initiate replication
--replication role can initiate replication
-?, --help show this help, then exit
-?, --help show this help, then exit
-?, --help show this help, then exit
-?, --help show this help, then exit
-D, --no-createdb role cannot create databases (default)
-D, --tablespace=TABLESPACE default tablespace for the database
-E, --encoding=ENCODING encoding for the database
-E, --encrypted encrypt stored password
-F, --freeze freeze row transaction information
-I, --no-inherit role does not inherit privileges
-L, --no-login role cannot login
-N, --unencrypted do not encrypt stored password
-O, --owner=OWNER database user to own the new database
-P, --pwprompt assign a password to new role
-R, --no-createrole role cannot create roles (default)
-S, --no-superuser role will not be superuser (default)
-S, --schema=SCHEMA reindex specific schema(s) only
-T, --template=TEMPLATE template database to copy
-U, --username=USERNAME user name to connect as
-U, --username=USERNAME user name to connect as
-U, --username=USERNAME user name to connect as (not the one to create)
-U, --username=USERNAME user name to connect as (not the one to drop)
-U, --username=USERNAME user name to connect as
-V, --version output version information, then exit
-V, --version output version information, then exit
-V, --version output version information, then exit
-V, --version output version information, then exit
-W, --password force password prompt
-W, --password force password prompt
-Z, --analyze-only only update optimizer statistics; no vacuum
-a, --all vacuum all databases
-a, --all cluster all databases
-a, --all reindex all databases
-c, --connection-limit=N connection limit for role (default: no limit)
-d, --createdb role can create new databases
-d, --dbname=DBNAME database to vacuum
-d, --dbname=DBNAME database from which to remove the language
-d, --dbname=DBNAME database to cluster
-d, --dbname=DBNAME database to install language in
-d, --dbname=DBNAME database to reindex
-d, --dbname=DBNAME database name
-e, --echo show the commands being sent to the server
-e, --echo show the commands being sent to the server
-e, --echo show the commands being sent to the server
-f, --full do full vacuuming
-g, --role=ROLE new role will be a member of this role
-h, --host=HOSTNAME database server host or socket directory
-h, --host=HOSTNAME database server host or socket directory
-h, --host=HOSTNAME database server host or socket directory
-i, --index=INDEX recreate specific index(es) only
-i, --inherit role inherits privileges of roles it is a
member of (default)
-i, --interactive prompt before deleting anything
-i, --interactive prompt before deleting anything, and prompt for
role name if not specified
-j, --jobs=NUM use this many concurrent connections to vacuum
-l, --list show a list of currently installed languages
-l, --locale=LOCALE locale settings for the database
-l, --login role can login (default)
-p, --port=PORT database server port
-p, --port=PORT database server port
-p, --port=PORT database server port
-q, --quiet don't write any messages
-q, --quiet don't write any messages
-q, --quiet run quietly
-r, --createrole role can create new roles
-s, --superuser role will be superuser
-s, --system reindex system catalogs
-t, --table='TABLE[(COLUMNS)]' vacuum specific table(s) only
-t, --table=TABLE cluster specific table(s) only
-t, --table=TABLE reindex specific table(s) only
-t, --timeout=SECS seconds to wait when attempting connection, 0 disables (default: %s)
-v, --verbose write a lot of output
-v, --verbose write a lot of output
-w, --no-password never prompt for password
-w, --no-password never prompt for password
-z, --analyze update optimizer statistics
%s (%s/%s) %s cleans and analyzes a PostgreSQL database.
%s clusters all previously clustered tables in a database.
%s creates a PostgreSQL database.
%s creates a new PostgreSQL role.
%s installs a procedural language into a PostgreSQL database.
%s issues a connection check to a PostgreSQL database.
%s reindexes a PostgreSQL database.
%s removes a PostgreSQL database.
%s removes a PostgreSQL role.
%s removes a procedural language from a database.
%s: "%s" is not a valid encoding name
%s: %s %s: cannot cluster all databases and a specific one at the same time
%s: cannot cluster specific table(s) in all databases
%s: cannot reindex all databases and a specific one at the same time
%s: cannot reindex all databases and system catalogs at the same time
%s: cannot reindex specific index(es) and system catalogs at the same time
%s: cannot reindex specific index(es) in all databases
%s: cannot reindex specific schema(s) and system catalogs at the same time
%s: cannot reindex specific schema(s) in all databases
%s: cannot reindex specific table(s) and system catalogs at the same time
%s: cannot reindex specific table(s) in all databases
%s: cannot use the "%s" option when performing only analyze
%s: cannot vacuum all databases and a specific one at the same time
%s: cannot vacuum specific table(s) in all databases
%s: clustering database "%s"
%s: clustering of database "%s" failed: %s %s: clustering of table "%s" in database "%s" failed: %s %s: comment creation failed (database was created): %s %s: could not connect to database %s: %s %s: could not connect to database %s: out of memory
%s: could not fetch default options
%s: creation of new role failed: %s %s: database creation failed: %s %s: database removal failed: %s %s: invalid socket: %s %s: language "%s" is already installed in database "%s"
%s: language "%s" is not installed in database "%s"
%s: language installation failed: %s %s: language removal failed: %s %s: missing required argument database name
%s: missing required argument language name
%s: missing required argument role name
%s: number of parallel jobs must be at least 1
%s: only one of --locale and --lc-collate can be specified
%s: only one of --locale and --lc-ctype can be specified
%s: processing database "%s": %s
%s: query failed: %s %s: query was: %s
%s: reindexing database "%s"
%s: reindexing of database "%s" failed: %s %s: reindexing of index "%s" in database "%s" failed: %s %s: reindexing of schema "%s" in database "%s" failed: %s %s: reindexing of system catalogs failed: %s %s: reindexing of table "%s" in database "%s" failed: %s %s: removal of role "%s" failed: %s %s: too many command-line arguments (first is "%s")
%s: too many parallel jobs requested (maximum: %d)
%s: vacuuming database "%s"
%s: vacuuming of database "%s" failed: %s %s: vacuuming of table "%s" in database "%s" failed: %s (%lu row) (%lu rows) Are you sure? Cancel request sent
Cannot add cell to table content: total cell count of %d exceeded.
Cannot add header to table content: column count of %d exceeded.
Could not send cancel request: %s Database "%s" will be permanently removed.
Enter it again: Enter name of role to add: Enter name of role to drop: Enter password for new role: Generating default (full) optimizer statistics Generating medium optimizer statistics (10 targets) Generating minimal optimizer statistics (1 target) Interrupted
Name Password encryption failed.
Password: Passwords didn't match.
Please answer "%s" or "%s".
Procedural Languages Role "%s" will be permanently removed.
Shall the new role be a superuser? Shall the new role be allowed to create databases? Shall the new role be allowed to create more new roles? Trusted? Try "%s --help" for more information.
Usage:
accepting connections
cannot duplicate null pointer (internal error)
could not look up effective user ID %ld: %s invalid output format (internal error): %d n no no attempt
no response
out of memory
rejecting connections
unknown
user does not exist user name lookup failure: error code %lu y yes Project-Id-Version: PostgreSQL 9.6.3
Report-Msgid-Bugs-To: pgsql-bugs@postgresql.org
POT-Creation-Date: 2017-04-04 09:37+0900
PO-Revision-Date: 2013-08-18 17:27+0900
Last-Translator: Daisuke Higuchi <higuchi.daisuke@jp.fujitsu.com>
Language-Team: jpug-doc <jpug-doc@ml.postgresql.jp>
Language: ja
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Plural-Forms: nplurals=2; plural=(n!=1);
デフォルトでは、現在のユーザ名と同名のデータベースが生成されます
接続オプション:
オプション:
詳細は SQL コマンドの CLUSTER の説明を参照してください。
詳細は SQL コマンド REINDEX に関する説明を参照してください。
詳細は SQL コマンドの VACUUM の説明を参照してください。
不具合は<pgsql-bugs@postgresql.org>まで報告してください。
--analyze-in-stages オプティマイザの統計情報の更新のみを行います。高速に結果を得るために
複数回実行します; バキュームを行いません
--lc-collate=ロケール名 データベースの LC_COLLATE 設定
--lc-ctype==ロケール名 データベースの LC_CTYPE 設定
%s [OPTION]...
%s [オプション]... [データベース名]
%s [オプション]... 言語名 [データベース名]
%s [オプション]... [データベース名]
%s [オプション]... [データベース名] [説明]
%s [オプション]... [ロール名]
--if-exists データベースが存在しない場合にエラーを報告しない
--if-exists ユーザが存在しない場合にエラーを報告しない
--interactive デフォルトではなく未入力のロール名や属性の入力を促す
--maintenance-db=DBNAME 別の保守用データベースを指定する
--maintenance-db=DBNAME 別の保守用データベースを指定する
--no-replication ロールはレプリケーションを初期化できない
--replication ロールはレプリケーションを初期化できる
-?, --help このヘルプを表示し、終了します
-?, --help このヘルプを表示し、終了します
-?, --help このヘルプを表示し、終了します
-?, --help このヘルプを表示し、終了します
-D, --no-createdb ロールは新しいデータベースを作成できません（デフォルト）
-D, --tablespace=テーブルスペース名 データベースのデフォルトの テーブルスペース名
-E, --encoding=エンコーディング データベースの符号化方式
-E, --encrypted パスワードを暗号化して保存する
-F, --freeze 行トランザクション情報を更新せずに保持します
-I, --no-inherit 権限(grant/revoke)をダンプしません
-L, --no-login ロールはログイン不可
-N, --unencrypted パスワードを暗号化せずに保存する
-O, --owner=所有者 新しいデータベースを所有するデータベースユーザ
-P, --pwprompt 新しいロールに対してパスワードを割り当てる
-R, --no-createrole ロールは別のロールを作成できない（デフォルト）
-S, --no-superuser ロールはスーパーユーザになれない（デフォルト）
-S, --schema=SCHEMA 指定したスキーマ（複数化）のみを再インデックス化します
-T, --template=テンプレート名 コピーするテンプレートデータベース
-U, --username=ユーザ名 接続する際のユーザ名
-U, --username=ユーザ名 このユーザ名で接続する
-U, --username=ユーザ名 このユーザとして接続（作成対象ユーザではありません）
-U, --username=ユーザ名 このユーザとして接続（削除対象ユーザではありません）
-U, --username=ユーザ名 このユーザ名で接続する
-V, --version バージョン情報を表示し、終了します
-V, --version バージョン情報を表示し、終了します
-V, --version バージョン情報を表示し、終了します
-V, --version バージョン情報を表示し、終了します
-W, --password パスワードプロンプトを強制表示する
-W, --password パスワードプロンプトを強制表示する
-Z, --analyze-only 最適化のための情報だけを更新します; バキュームはありません
-a, --all 全データベースを vacuum します
-a, --all すべてのデータベースをクラスタ化する
-a, --all 全データベースを再インデックス化します
-c, --connection-limit=N このロールのコネクション数の制限（デフォルト：制限なし）
-d, --createdb ロールは新しいデータベースを作成できます
-d, --dbname=データベース名 vacuum するデータベース名
-d, --dbname=データベース名 言語を削除するデータベース名
-d, --dbname=データベース名 クラスタ化するデータベース
-d, --dbname=データベース名 言語をインストールするデータベース名
-d, --dbname=データベース名 再インデックス化データベース名
-d, --dbname=データベース名 データベース名
-e, --echo サーバに送られるコマンドを表示します
-e, --echo サーバに送られるコマンドを表示
-e, --echo サーバへ送信されているコマンドを表示
-f, --full full vacuum を行ないます
-g, --role=ROLE 新しいロールはこのロールのメンバーになる
-h, --host=ホスト名 データベースサーバホストまたはソケットディレクトリ
-h, --host=ホスト名 データベースサーバのホストまたはソケットディレクトリ
-h, --host=HOSTNAME データベースサーバのホストまたはソケットディレクトリです
-i, --index=インデックス名 指定したインデックス(複数可)のみを再作成します
-i, --inherit このロールのメンバーにも権限を継承する（デフォルト）
-i, --interactive 何かを削除する前に警告する
-i, --interactive 何かを削除する前に入力を促し、またロール名が指定
されていない場合はその入力を促す
-j, --jobs=NUM バキューム時に指定した同時接続数を使用
-l, --list 現在インストール済みの言語一覧を表示します
-l, --locale=ロケール名 データベースのロケール設定
-l, --login ロールはログイン可能（デフォルト）
-p, --port=ポート番号 データベースサーバのポート番号
-p, --port=ポート番号 データベースサーバのポート番号
-p, --port=ポート番号 データベースサーバのポート番号
-q, --quiet メッセージを出力しません
-q, --quiet メッセージを何も出力しない
-q, --quiet メッセージを出力せずに実行する
-r, --createrole ロールは別のロールを作成できる
-s, --superuser ロールはスーパーユーザになる
-s, --system システムカタログを再インデックス化します
-t, --table='TABLE[(COLUMNS)]' 指定したテーブル(複数可)のみを vacuum します
-t, --table=テーブル名 指定したテーブル(複数可)のみをクラスタ化する
-t, --table=テーブル名 指定したテーブル（複数可）のみを再インデックス化します
-t, --timeout=SECS 接続試行時に待機する秒数。ゼロは無効にします（デフォルト: %s）
-v, --verbose 多くのメッセージを出力します
-v, --verbose （多くのメッセージを出力する）冗長モード
-w, --no-password パスワード入力を要求しない
-w, --no-password パスワード入力を要求しない
-z, --analyze 最適化のための情報を更新します
%s (%s/%s) %sはPostgreSQLデータベースを clean および analyse します。
%sはデータベース内で事前にクラスタ化されているすべてのテーブルをクラスタ化します
%sはPostgreSQLデータベースを生成します。
%sは新しいPostgreSQLロールを作成します
"%s はPostgreSQLデータベースに手続き言語をインストールします。
%sはPostgreSQLデータベースに対して接続検査を発行します
%sはPostgreSQLデータベースを再インデックス化します。
%sはPostgreSQLデータベースを削除します。
%sはPostgreSQLのロールを削除します
%s はデータベースから手続き言語を削除します
%s: "%s" は無効なエンコーディング名です。
%s: %s %s: 全データベースと特定のデータベースを同時にクラスタ化することはできません
%s: すべてのデータベースでは特定のテーブルをクラスタ化できません
%s: 全データベースと特定のデータベースを同時に再インデックス化することはできません
%s: 全データベースとシステムカタログの両方を同時に再インデックス化することはできません
%s: 特定のインデックスとシステムカタログの両方を同時に再インデックス化することはできません
%s: 全データベースにおける特定のインデックスを再作成することはできません
%s: 特定のスキーマとシステムカタログの両方を同時に再インデックス化することはできません
%s: 全データベースにおける特定のスキーマを再インデックス化することはできません
%s: 特定のテーブルとシステムカタログの両方を同時に再インデックス化することはできません
%s: 全データベースにおける特定のテーブルを再インデックス化することはできません
%s: analyze のみを実行する場合 "%s" は使えません
%s: 全データベースと特定のデータベースを同時に vacuum することはできません
%s: 全データベースのうち特定のテーブルを vacuum することはできません
%s: データベース"%s"をクラスタ化しています
%s: データベース"%s"のクラスタ化に失敗しました: %s %1$s: データベース"%3$s"でテーブル"%2$s"のクラスタ化に失敗しました: %4$s %s: コメントの生成に失敗（データベースは生成されました）: %s %s: データベース %s に接続できませんでした: %s %s: データベース %s に接続できませんでした: メモリ不足です
%s: デフォルトのオプションを取り出すことができませんでした
%s: 新しいロールの作成に失敗しました: %s %s: データベースの生成に失敗しました：%s %s: データベースの削除に失敗しました: %s %s: 無効なソケットです: %s %s: 言語"%s"データベース"%s"内にすでにインストールされています
%s: 言語"%s"はデータベース"%s"にはインストールされていません
%s: 言語のインストールに失敗しました: %s %s: 言語の削除に失敗しました: %s %s: データベース名引数が不足しています。
%s: 言語名引数が不足しています。
%s: 必要な引数であるロール名がありません
%s: 並行ジョブの数は少なくとも1です
%s: --locale か --lc-collate のいずれかのみを指定してください
%s: --locale か --lc-ctype のいずれかのみを指定してください
%s: データベース"%s"の処理中です: %s
%s: 問い合わせが失敗しました: %s %s: 問い合わせ: %s
%s: データベース"%s"を再インデックス化しています
%s: データベース"%s"の再インデックス化に失敗しました: %s %1$s: データベース"%2$s"中にあるインデックス"%3$s"の再作成に失敗しました: %4$s %1$s: データベース"%2$s"中にあるスキーマ"%3$s"の再インデックス化に失敗しました: %4$s %s: システムカタログの再インデックス化に失敗しました: %s %1$s: データベース"%2$s"中にあるテーブル"%3$s"の再インデックス化に失敗しました: %4$s %s: ロール"%s"の削除に失敗しました:%s %s: コマンドライン引数が多すぎます。(始めは"%s")
%s: 要求された並列ジョブが多すぎます (最大: %d)
%s: データベース"%s"を vacuum しています
%s: データベース"%s"の vacuum に失敗しました: %s %1$s: データベース "%3$s" でテーブル"%2$sの vacuum に失敗しました：%4$ss (%lu 行) (%lu 行) 実行しますか？ キャンセル要求を送信しました
テーブルの内容にセルを追加できませんでした：全セル数 %d が制限を越えています。
テーブルの内容に見出しを追加できませんでした：列数 %d が制限を越えています。
キャンセル要求を送信できませんでした: %s データベース"%s"は永久に削除されます。
もう一度入力してください： 追加したいロール名を入力： 削除したいロール名を入力： 新しいロールのためのパスワード: 最適化のための情報をデフォルト数(全て)生成します 最適化のための情報を複数生成します (10対象) 最適化のための情報を最小限生成します (1対象) 中断されました
名前 パスワードの暗号化に失敗しました。
パスワード: パスワードがマッチしません。
"%s" または "%s" に答えてください
手続き言語 ロール"%s"は永久に削除されます
新しいロールをスーパーユーザにしますか？ 新しいロールに対してデータベースを作成する権限を与えますか？ 新しいロールに対して別のロールを作成する権限を与えますか？ Trusted? 詳細は"%s --help"を実行してください。
使用方法:
接続を受け付けています
null ポインタを複製できません（内部エラー）。
実行ユーザID %ld が見つかりませんでした: %s 出力フォーマットが無効（内部エラー）：%d n no 施行がありません
レスポンスがありません
メモリ不足です
接続を拒絶しています
unknown
ユーザが存在しません ユーザ名の検索に失敗: エラーコード %lu y yes locale/de/LC_MESSAGES/ecpg-9.6.mo 0000644 00000034405 14751153420 0011755 0 ustar 00 �� { � � � h
~ i
- �
0 + G g s � 4 � 7 0 s h . � G
4 S
) �
w �
4 * _ @ r = � , � ! @ , ^ 1 � * � - � 1 ' H & p + � " � # �
) = < z � & � < � ! & - 0 + ^ " � � , � � * 3 " ^ ' � � � ! � � ! 5 J 3 k / � ' � ) � * ! 5 L I � , � / � * ) T T ' � � � 1 - K , y , � 5 � ) % ? O 8 � � � _ 0 y 5 � � A � L 7 + �
� 6 � ' � # A ( N 4 w ) � � / � # < $ ] � " � , � � ' " J i $ � D � + � ? 0 Z � 8 � � & F � g � � 6 �! / �! 4 �! s " # �" 7 �" > �" q .# / �# F �# 6 $ , N$ � {$ 9 �$
8% H F% > �% 2 �% * & # ,& > P& 4 �& - �& 0 �& 4 #' * X' ) �' . �' ' �' ) ( .( ) 7( L a(
�( �( 8 �( N ) # b) �) 3 �) 6 �) + �) '* 3 E* # y* ! �* , �* 2 �* 0 + P+ ! d+ , �+ �+ ( �+ �+ , 2 6, 5 i, * �, 0 �, / �, B +- U n- 3 �- 9 �- 3 2. W f. " �. �. �. / 3/ J/ . d/ - �/ - �/ 8 �/ (0 1 D0 J v0 A �0 � 1 " �1 F �1 G 2 J2 P _2 b �2 - 3 A3 > W3 + �3 - �3 �3 ' �3 @ %4 2 f4 �4 3 �4 # �4 5 $ 25 W5 t5 F �5 �5 & �5 - #6 4 Q6 6 �6 3 �6 [ �6 9 M7 L �7 - �7 8 < "8 _8 $ ~8 0 �8 0 �8 j 4 f g ? ^ l x
T ( 9 u 8 _ L t I d \ % ) < i = ' Q N & : M v , 7 B . z ; S n # > P " H r ] [ ! * s Z 6 G A O - X 2 q 3 W w 1 k + U e Y o K p 0 a J 5 { h c m E C @ V F D y R / ` $
b
If no output file is specified, the name is formed by adding .c to the
input file name, after stripping off .pgc if present.
Report bugs to <pgsql-bugs@postgresql.org>.
--regression run in regression testing mode
-?, --help show this help, then exit
-C MODE set compatibility mode; MODE can be one of
"INFORMIX", "INFORMIX_SE"
-D SYMBOL define SYMBOL
-I DIRECTORY search DIRECTORY for include files
-V, --version output version information, then exit
-c automatically generate C code from embedded SQL code;
this affects EXEC SQL TYPE
-d generate parser debug output
-h parse a header file, this option includes option "-c"
-i parse system include files as well
-o OUTFILE write result to OUTFILE
-r OPTION specify run-time behavior; OPTION can be:
"no_indicator", "prepare", "questionmarks"
-t turn on autocommit of transactions
%s at or near "%s" %s is the PostgreSQL embedded SQL preprocessor for C programs.
%s, the PostgreSQL embedded C preprocessor, version %d.%d.%d
%s: could not locate my own executable path
%s: could not open file "%s": %s
%s: no input files specified
%s: parser debug support (-d) not available
AT option not allowed in CLOSE DATABASE statement AT option not allowed in CONNECT statement AT option not allowed in DISCONNECT statement AT option not allowed in SET CONNECTION statement AT option not allowed in TYPE statement AT option not allowed in VAR statement AT option not allowed in WHENEVER statement COPY FROM STDIN is not implemented CREATE TABLE AS cannot specify INTO ERROR: EXEC SQL INCLUDE ... search starts here:
Error: include path "%s/%s" is too long on line %d, skipping
Options:
SHOW ALL is not implemented Try "%s --help" for more information.
Unix-domain sockets only work on "localhost" but not on "%s" Usage:
%s [OPTION]... FILE...
WARNING: arrays of indicators are not allowed on input could not open include file "%s" on line %d could not remove output file "%s"
cursor "%s" does not exist cursor "%s" has been declared but not opened cursor "%s" is already defined descriptor "%s" does not exist descriptor header item "%d" does not exist descriptor item "%s" cannot be set descriptor item "%s" is not implemented end of search list
expected "://", found "%s" expected "@" or "://", found "%s" expected "@", found "%s" expected "postgresql", found "%s" incomplete statement incorrectly formed variable "%s" indicator for array/pointer has to be array/pointer indicator for simple data type has to be simple indicator for struct has to be a struct indicator struct "%s" has too few members indicator struct "%s" has too many members indicator variable "%s" is hidden by a local variable indicator variable "%s" is hidden by a local variable of a different type indicator variable must have an integer type initializer not allowed in EXEC SQL VAR command initializer not allowed in type definition internal error: unreachable state; please report this to <pgsql-bugs@postgresql.org> interval specification not allowed here invalid bit string literal invalid connection type: %s invalid data type key_member is always 0 missing "EXEC SQL ENDIF;" missing identifier in EXEC SQL DEFINE command missing identifier in EXEC SQL IFDEF command missing identifier in EXEC SQL UNDEF command missing matching "EXEC SQL IFDEF" / "EXEC SQL IFNDEF" more than one EXEC SQL ELSE multidimensional arrays are not supported multidimensional arrays for simple data types are not supported multidimensional arrays for structures are not supported multilevel pointers (more than 2 levels) are not supported; found %d level multilevel pointers (more than 2 levels) are not supported; found %d levels nested /* ... */ comments nested arrays are not supported (except strings) no longer supported LIMIT #,# syntax passed to server nullable is always 1 only data types numeric and decimal have precision/scale argument only protocols "tcp" and "unix" and database type "postgresql" are supported operator not allowed in variable definition out of memory pointer to pointer is not supported for this data type pointers to varchar are not implemented subquery in FROM must have an alias syntax error syntax error in EXEC SQL INCLUDE command too many levels in nested structure/union definition too many nested EXEC SQL IFDEF conditions type "%s" is already defined type name "string" is reserved in Informix mode unmatched EXEC SQL ENDIF unrecognized data type name "%s" unrecognized descriptor item code %d unrecognized token "%s" unrecognized variable type code %d unsupported feature will be passed to server unterminated /* comment unterminated bit string literal unterminated hexadecimal string literal unterminated quoted identifier unterminated quoted string using unsupported DESCRIBE statement using variable "%s" in different declare statements is not supported variable "%s" is hidden by a local variable variable "%s" is hidden by a local variable of a different type variable "%s" is neither a structure nor a union variable "%s" is not a pointer variable "%s" is not a pointer to a structure or a union variable "%s" is not an array variable "%s" is not declared variable "%s" must have a numeric type zero-length delimited identifier Project-Id-Version: PostgreSQL 9.6
Report-Msgid-Bugs-To: pgsql-bugs@postgresql.org
POT-Creation-Date: 2018-02-04 20:48+0000
PO-Revision-Date: 2016-09-20 11:48-0400
Last-Translator: Peter Eisentraut <peter_e@gmx.net>
Language-Team: German <peter_e@gmx.net>
Language: de
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Plural-Forms: nplurals=2; plural=n != 1;
Wenn keine Ausgabedatei angegeben ist, dann wird .c an den Namen der
Eingabedatei angehängt und vorher .pgc, falls vorhanden, entfernt.
Berichten Sie Fehler an <pgsql-bugs@postgresql.org>.
--regression Regressiontestmodus verwenden
-?, --help diese Hilfe anzeigen, dann beenden
-C MODUS Kompatibilitätsmodus setzen; MODUS kann sein:
»INFORMIX« oder »INFORMIX_SE«
-D SYMBOL SYMBOL definieren
-I VERZ VERZ nach Include-Dateien durchsuchen
-V, --version Versionsinformationen anzeigen, dann beenden
-c automatisch C-Code aus eingebettetem SQL-Code erzeugen;
betrifft EXEC SQL TYPE
-d Parser-Debug-Ausgabe erzeugen
-h eine Headerdatei parsen, schließt Option »-c« ein
-i Systemheaderdateien ebenfalls parsen
-o DATEI Ausgabe in DATEI schreiben
-r OPTION Laufzeitverhalten bestimmen; OPTION kann sein:
»no_indicator«, »prepare«, »questionmarks«
-t Autocommit von Transaktionen anschalten
%s bei »%s« %s ist der Embedded-SQL-Präprozessor von PostgreSQL für C-Programme.
%s, der PostgreSQL-Embedded-C-Präprozessor, Version %d.%d.%d
%s: konnte Pfad des eigenen Programs nicht finden
%s: konnte Datei »%s« nicht öffnen: %s
%s: keine Eingabedateien angegeben
%s: Unterstützung für Parserdebugging (-d) nicht verfügbar
AT-Option ist nicht erlaubt im Befehl CLOSE DATABASE AT-Option ist nicht erlaubt im Befehl CONNECT AT-Option ist nicht erlaubt im Befehl DISCONNECT AT-Option ist nicht erlaubt im Befehl SET CONNECTION AT-Option ist nicht erlaubt im TYPE-Befehl AT-Option ist nicht erlaubt im VAR-Befehl AT-Option ist nicht erlaubt im WHENEVER-Befehl COPY FROM STDIN ist nicht implementiert CREATE TABLE AS kann INTO nicht verwenden FEHLER: EXEC SQL INCLUDE ... Suche beginnt hier:
Fehler: Include-Pfad »%s/%s« ist zu lang auf Zeile %d, wird übersprungen
Optionen:
SHOW ALL ist nicht implementiert Versuchen Sie »%s --help« für weitere Informationen.
Unix-Domain-Sockets funktionieren nur mit »localhost«, aber nicht mit »%s« Aufruf:
%s [OPTION]... DATEI...
WARNUNG: Array aus Indikatoren bei der Eingabe nicht erlaubt konnte Include-Datei »%s« nicht öffnen auf Zeile %d konnte Ausgabedatei »%s« nicht entfernen
Cursor »%s« existiert nicht Cursor »%s« wurde deklariert aber nicht geöffnet Cursor »%s« ist bereits definiert Deskriptor »%s« existiert nicht Deskriptorkopfelement »%d« existiert nicht Deskriptorelement »%s« kann nicht gesetzt werden Deskriptorelement »%s« ist nicht implementiert Ende der Suchliste
»://« erwartet, »%s« gefunden »@« oder »://« erwartet, »%s« gefunden »@« erwartet, »%s« gefunden »postgresql« erwartet, »%s« gefunden unvollständige Anweisung falsch geformte Variable »%s« Indikator für Array/Zeiger muss Array/Zeiger sein Indikator für einfachen Typ muss einfachen Typ haben Indikator für struct muss ein struct sein Indikator-Struct »%s« hat zu wenige Mitglieder Indikator-Struct »%s« hat zu viele Mitglieder Indikatorvariable »%s« wird durch eine lokale Variable versteckt Indikatorvariable »%s« wird durch eine lokale Variable eines anderen Typs versteckt Indikatorvariable muss einen ganzzahligen Typ haben Initialisierungswert nicht erlaubt in Befehl EXEC SQL VAR Initialisierungswert nicht erlaubt in Typdefinition interner Fehler: unerreichbarer Zustand; bitte an <pgsql-bugs@postgresql.org> berichten Intervallangabe hier nicht erlaubt ungültige Bitkettenkonstante ungültiger Verbindungstyp: %s ungültiger Datentyp key_member ist immer 0 »EXEC SQL ENDIF;« fehlt fehlender Bezeichner im Befehl EXEC SQL DEFINE fehlender Bezeichner im Befehl EXEC SQL IFDEF fehlender Bezeichner im Befehl EXEC SQL UNDEF passendes »EXEC SQL IFDEF« / »EXEC SQL IFNDEF« fehlt mehr als ein EXEC SQL ENDIF mehrdimensionale Arrays werden nicht unterstützt mehrdimensionale Arrays für einfache Datentypen werden nicht unterstützt mehrdimensionale Arrays für Strukturen werden nicht unterstützt Zeiger mit mehr als 2 Ebenen werden nicht unterstützt; %d Ebene gefunden Zeiger mit mehr als 2 Ebenen werden nicht unterstützt; %d Ebenen gefunden geschachtelte /* ... */-Kommentare verschachtelte Arrays werden nicht unterstützt (außer Zeichenketten) nicht mehr unterstützte Syntax LIMIT x,y wird an Server weitergereicht nullable ist immer 1 nur die Datentypen NUMERIC und DECIMAL haben Argumente für Präzision und Skala er werden nur die Protokolle »tcp« und »unix« und der Datenbanktyp »postgresql« unterstützt Operator nicht erlaubt in Variablendefinition Speicher aufgebraucht Zeiger auf Zeiger wird für diesen Datentyp nicht unterstützt Zeiger auf varchar sind nicht implementiert Unteranfrage in FROM muss Aliasnamen erhalten Syntaxfehler Syntaxfehler im Befehl EXEC SQL INCLUDE zu viele Ebenen in verschachtelter Definition von Struktur/Union zu viele verschachtelte EXEC SQL IFDEF-Bedingungen Typ »%s« ist bereits definiert Typname »string« ist im Informix-Modus reserviert unzusammenhängendes EXEC SQL ENDIF unbekannter Datentypname »%s« unbekannter Deskriptorelementcode %d nicht erkanntes Token »%s« unbekannter Variablentypcode %d nicht mehr unterstütztes Feature wird an Server weitergereicht werden /*-Kommentar nicht abgeschlossen Bitkettenkonstante nicht abgeschlossen hexadezimale Zeichenkette nicht abgeschlossen Bezeichner in Anführungszeichen nicht abgeschlossen Zeichenkette in Anführungszeichen nicht abgeschlossen nicht unterstützter DESCRIBE-Befehl wird verwendet Verwendung der Variable »%s« in verschiedenen DECLARE-Anweisungen wird nicht unterstützt Variable »%s« wird durch eine lokale Variable versteckt Variable »%s« wird durch eine lokale Variable eines anderen Typs versteckt Variable »%s« ist keine Struktur oder Union Variable »%s« ist kein Zeiger Variable »%s« ist kein Zeiger auf eine Struktur oder Union Variable »%s« ist kein Array Variable »%s« ist nicht deklariert Variable »%s« muss einen numerischen Typ haben Bezeichner in Anführungszeichen hat Länge null locale/de/LC_MESSAGES/pg_rewind-9.6.mo 0000644 00000046664 14751153420 0013027 0 ustar 00 �� � $ � ,
�
- �
1 �
? K I C � ; � C 9 Y G � @ � O ( x � � � � � � J > L , � 6 � < � 1 , ? ^ = � = � 9 D T 4 � 9 � 4 2 = @ p R � > C J 1 k � � � � o � d ] - � 4 � & % L � f P � R : c � - � > / \ ; � � � � # B % a $ � + � � $ � L , h 0 � " � ) � , @ $ ^ $ � # � ' � " � " 5 & X $ � ( � � " ' 1 Y v � � 2 � � ' D / c - � � 6 � ; + ) g � + � % � ! ! ! 4! 3 V! 6 �! 1 �! �! ' " < :" _ w" �" �" ! �" F # c# z# �# 1 �# C �# " $$ . G$ # v$ > �$ 6 �$ 3 % 6 D% 0 {% �% + �% & �% & ;& ! Z& ( |& I �& $ �& ' ' <' - Y' J �' = �' A ( 6 R( 5 �( 5 �( ! �( 7 ) / O) 6 ) 1 �) - �) 9 * s P* 6 �+ 5 �+ @ 1, | r, Q �, D A- Q �- @ �- N . F h. �. y �. 5/ R/ * r/ �/ �/ �/ �/ L �/ S "0 / v0 > �0 G �0 7 -1 M e1 D �1 B �1 5 ;2 P q2 < �2 B �2 ? B3 E �3 H �3 Y 4 E k4 �4 / �4 : �4 & %5
L5 W5 u5 � �5 ~ 6 5 �6 H �6 8 7 T7 � o7 R 8 T W8 r �8 4 9 & T9 + {9 2 �9 C �9 : 4: , U: / �: ) �: - �: -
; ; 8; ! t; ) �; ] �; : < > Y< , �< 0 �< 2 �< & )= + P= * |= ) �= - �= * �= $ *> ( O> 7 x> - �> ' �> : ? 8 A? 6 z? < �? " �? ! @ " 3@ V@ > v@ 7 �@ - �@ ( A 8 DA < }A �A 9 �A B B 'B . jB �B 4 �B ) �B C " 3C & VC 5 }C 9 �C > �C & ,D + SD Q D f �D 8E QE & hE H �E �E �E F 9 F H WF ( �F 0 �F * �F J %G = pG 9 �G 8 �G ? !H aH 8 {H 6 �H 6 �H $ "I " GI 4 jI P �I �I - J ! >J 7 `J P �J A �J R +K 6 ~K : �K 9 �K ( *L @ SL 4 �L = �L 7 M 4 ?M ? tM � ' 6 � Y | � � � [ ? r " p � J } � � & = d � 2 { y ; � u / i F
f R 7 � b � 9 k I ) ! l _ q � � � B : � t $ � � 1 % 4 � � � ` U P h � x � ~ * � ]
C w L E @ g 3 a Q c s � 0 m A � < � S X v T , e M z ^ K � H N G 5 O j > � � Z ( o - W . � � D V \ # + � 8 n �
Report bugs to <pgsql-bugs@postgresql.org>.
creating backup label and updating control file
--debug write a lot of debug messages
--source-pgdata=DIRECTORY source data directory to synchronize with
--source-server=CONNSTR source server to synchronize with
-?, --help show this help, then exit
-D, --target-pgdata=DIRECTORY existing data directory to modify
-P, --progress write progress messages
-V, --version output version information, then exit
-n, --dry-run stop before modifying anything
block %u
"%s" is a symbolic link, but symbolic links are not supported on this platform
"%s" is not a directory
"%s" is not a regular file
"%s" is not a symbolic link
%*s/%s kB (%d%%) copied %d: %X/%X - %X/%X
%s %s (%s)
%s resynchronizes a PostgreSQL cluster with another copy of the cluster.
%s: WARNING: cannot create restricted tokens on this platform
%s: could not allocate SIDs: error code %lu
%s: could not create restricted token: error code %lu
%s: could not get exit code from subprocess: error code %lu
%s: could not open process token: error code %lu
%s: could not re-execute with restricted token: error code %lu
%s: could not start process for command "%s": error code %lu
%s: no source specified (--source-pgdata or --source-server)
%s: no target data directory specified (--target-pgdata)
%s: only one of --source-pgdata or --source-server can be specified
%s: too many command-line arguments (first is "%s")
BKPBLOCK_HAS_DATA not set, but data length is %u at %X/%X BKPBLOCK_HAS_DATA set, but no data included at %X/%X BKPBLOCK_SAME_REL set but no previous rel at %X/%X BKPIMAGE_HAS_HOLE not set, but hole offset %u length %u at %X/%X BKPIMAGE_HAS_HOLE set, but hole offset %u length %u block image length %u at %X/%X BKPIMAGE_IS_COMPRESSED set, but block image length %u at %X/%X Done!
Expected a numeric timeline ID.
Expected a transaction log switchpoint location.
Failure, exiting
Options:
Source timeline history:
Target timeline history:
The program "initdb" is needed by %s but was
not found in the same directory as "%s".
Check your installation.
The program "initdb" was found by "%s"
but was not the same version as %s.
Check your installation.
Timeline IDs must be in increasing sequence.
Timeline IDs must be less than child timeline's ID.
Try "%s --help" for more information.
Usage:
%s [OPTION]...
WAL file is from different database system: WAL file database system identifier is %s, pg_control database system identifier is %s WAL file is from different database system: incorrect XLOG_BLCKSZ in page header WAL file is from different database system: incorrect XLOG_SEG_SIZE in page header WAL record modifies a relation, but record type is not recognized
lsn: %X/%X, rmgr: %s, info: %02X
You must run %s as the PostgreSQL superuser.
backup label buffer too small
cannot be executed by "root"
cannot duplicate null pointer (internal error)
clusters are not compatible with this version of pg_rewind
connected to server
contrecord is requested by %X/%X could not clear search_path: %s could not close directory "%s": %s
could not close file "%s": %s
could not close target file "%s": %s
could not create directory "%s": %s
could not create symbolic link at "%s": %s
could not fetch file list: %s could not fetch remote file "%s": %s could not find common ancestor of the source and target cluster's timelines
could not find previous WAL record at %X/%X
could not find previous WAL record at %X/%X: %s
could not open directory "%s": %s
could not open file "%s" for reading: %s
could not open file "%s" for truncation: %s
could not open file "%s": %s
could not open source file "%s": %s
could not open target file "%s": %s
could not read WAL record at %X/%X
could not read WAL record at %X/%X: %s
could not read directory "%s": %s
could not read file "%s": %s
could not read from file "%s": %s
could not read symbolic link "%s": %s
could not remove directory "%s": %s
could not remove file "%s": %s
could not remove symbolic link "%s": %s
could not seek in file "%s": %s
could not seek in source file: %s
could not seek in target file "%s": %s
could not send COPY data: %s could not send end-of-COPY: %s could not send file list: %s could not send query: %s could not set libpq connection to single row mode
could not stat file "%s": %s
could not truncate file "%s" to %u: %s
could not write file "%s": %s
data file "%s" in source is not a regular file
error running query (%s) in source server: %s fetched file "%s", length %d
full_page_writes must be enabled in the source server
getting file chunks
incorrect resource manager data checksum in record at %X/%X invalid action (CREATE) for regular file
invalid block_id %u at %X/%X invalid compressed image at %X/%X, block %d invalid contrecord length %u at %X/%X invalid control file
invalid data in history file
invalid data in history file: %s
invalid info bits %04X in log segment %s, offset %u invalid magic number %04X in log segment %s, offset %u invalid record length at %X/%X: wanted %u, got %u invalid record offset at %X/%X invalid resource manager ID %u at %X/%X need to copy %lu MB (total source directory size is %lu MB)
neither BKPIMAGE_HAS_HOLE nor BKPIMAGE_IS_COMPRESSED set, but block image length is %u at %X/%X no rewind required
out of memory
out-of-order block_id %u at %X/%X out-of-sequence timeline ID %u (after %u) in log segment %s, offset %u reading WAL in target
reading source file list
reading target file list
received chunk for file "%s", offset %s, size %d
received null value for chunk for file "%s", file has been deleted
record length %u at %X/%X too long record with incorrect prev-link %X/%X at %X/%X record with invalid length at %X/%X rewinding from last common checkpoint at %X/%X on timeline %u
servers diverged at WAL position %X/%X on timeline %u
source and target cluster are on the same timeline
source and target clusters are from different systems
source data directory must be shut down cleanly
source file list is empty
source server must not be in recovery mode
symbolic link "%s" target is too long
sync of target directory failed
syncing target data directory
syntax error in history file: %s
target server must be shut down cleanly
target server needs to use either data checksums or "wal_log_hints = on"
there is no contrecord flag at %X/%X unexpected EOF while reading file "%s"
unexpected control file CRC
unexpected control file size %d, expected %d
unexpected data types in result set while fetching remote files: %u %u %u
unexpected null values in result while fetching remote files
unexpected page modification for directory or symbolic link "%s"
unexpected pageaddr %X/%X in log segment %s, offset %u unexpected result format while fetching remote files
unexpected result length while fetching remote files
unexpected result set from query
unexpected result set size while fetching remote files
unexpected result set while fetching file list
unexpected result set while fetching remote file "%s"
unexpected result while fetching remote files: %s unexpected result while sending file list: %s unrecognized result "%s" for current WAL insert location
Project-Id-Version: pg_rewind (PostgreSQL) 9.6
Report-Msgid-Bugs-To: pgsql-bugs@postgresql.org
POT-Creation-Date: 2020-11-08 11:51+0000
PO-Revision-Date: 2017-09-10 21:28-0400
Last-Translator: Peter Eisentraut <peter_e@gmx.net>
Language-Team: German <peter_e@gmx.net>
Language: de
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Berichten Sie Fehler an <pgsql-bugs@postgresql.org>.
erzeuge Backup-Label und aktualisiere Kontrolldatei
--debug viele Debug-Meldungen ausgeben
--source-pgdata=VERZ Quelldatenverzeichnis, mit dem synchronisiert
werden soll
--source-server=VERB Quellserver, mit dem synchronisiert werden soll
-?, --help diese Hilfe anzeigen, dann beenden
-D, --target-pgdata=VERZ bestehendes zu modifizierendes Datenverzeichnis
-P, --progress Fortschrittsmeldungen ausgeben
-V, --version Versionsinformationen anzeigen, dann beenden
-n, --dry-run anhalten, bevor etwas geändert wird
Block %u
»%s« ist eine symbolische Verknüpfung, aber symbolische Verknüpfungen werden auf dieser Plattform nicht unterstützt
»%s« ist kein Verzeichnis
»%s« ist keine normale Datei
»%s« ist keine symbolische Verknüpfung
%*s/%s kB (%d%%) kopiert %d: %X/%X - %X/%X
%s %s (%s)
%s resynchronisiert einen PostgreSQL-Cluster mit einer Kopie des Clusters.
%s: WARNUNG: auf dieser Plattform können keine beschränkten Token erzeugt werden
%s: konnte SIDs nicht erzeugen: Fehlercode %lu
%s: konnte beschränktes Token nicht erzeugen: Fehlercode %lu
%s: konnte Statuscode des Subprozesses nicht ermitteln: Fehlercode %lu
%s: konnte Prozess-Token nicht öffnen: Fehlercode %lu
%s: konnte Prozess nicht mit beschränktem Token neu starten: Fehlercode %lu
%s: konnte Prozess für Befehl »%s« nicht starten: Fehlercode %lu
%s: keine Quelle angegeben (--source-pgdata oder --source-server)
%s: kein Zielverzeichnis angegeben (--target-pgdata)
%s: --source-pgdata und --source-server können nicht zusammen angegeben werden
%s: zu viele Kommandozeilenargumente (das erste ist »%s«)
BKPBLOCK_HAS_DATA nicht gesetzt, aber Datenlänge ist %u bei %X/%X BKPBLOCK_HAS_DATA gesetzt, aber keine Daten enthalten bei %X/%X BKPBLOCK_SAME_REL gesetzt, aber keine vorangehende Relation bei %X/%X BKPIMAGE_HAS_HOLE nicht gesetzt, aber Loch Offset %u Länge %u bei %X/%X BKPIMAGE_HAS_HOLE gesetzt, aber Loch Offset %u Länge %u Block-Abbild-Länge %u bei %X/%X BKPIMAGE_IS_COMPRESSED gesetzt, aber Block-Abbild-Länge %u bei %X/%X Fertig!
Eine numerische Zeitleisten-ID wurde erwartet.
Eine Transaktionslog-Switchpoint-Position wurde erwartet.
Fehlgeschlagen, Programm wird beendet
Optionen:
Verlauf der Quellzeitleiste:
Verlauf der Zielzeitleiste:
Das Programm »initdb« wird von %s benötigt, aber wurde nicht im
selben Verzeichnis wie »%s« gefunden.
Prüfen Sie Ihre Installation.
Das Programm »initdb« wurde von %s gefunden,
aber es hatte nicht die gleiche Version wie %s.
Prüfen Sie Ihre Installation.
Zeitleisten-IDs müssen in aufsteigender Folge sein.
Zeitleisten-IDs müssen kleiner als die Zeitleisten-ID des Kindes sein.
Versuchen Sie »%s --help« für weitere Informationen.
Aufruf:
%s [OPTION]...
WAL-Datei ist von einem anderen Datenbanksystem: Datenbanksystemidentifikator in WAL-Datei ist %s, Datenbanksystemidentifikator in pg_control ist %s WAL-Datei ist von einem anderen Datenbanksystem: Falsche XLOG_BLCKSZ im Seitenkopf WAL-Datei ist von einem anderen Datenbanksystem: Falsche XLOG_SEG_SIZE im Seitenkopf WAL-Eintrag modifiziert eine Relation, aber Typ des Eintrags wurde nicht erkannt
lsn: %X/%X, rmgr: %s, info: %02X
Sie müssen %s als PostgreSQL-Superuser ausführen.
Puffer für Backup-Label ist zu klein
kann nicht von »root« ausgeführt werden
kann NULL-Zeiger nicht kopieren (interner Fehler)
die Cluster sind nicht mit dieser Version von pg_rewind kompatibel
mit Server verbunden
Contrecord angefordert von %X/%X konnte search_path nicht auf leer setzen: %s konnte Verzeichnis »%s« nicht schließen: %s
konnte Datei »%s« nicht schließen: %s
konnte Zieldatei »%s« nicht schließen: %s
konnte Verzeichnis »%s« nicht erzeugen: %s
konnte symbolische Verknüpfung »%s« nicht erstellen: %s
konnte Dateiliste nicht holen: %s konnte ferne Datei »%s« nicht holen: %s konnte keinen gemeinsamen Anfangspunkt in den Zeitleisten von Quell- und Ziel-Cluster finden
konnte vorangegangenen WAL-Eintrag bei %X/%X nicht finden
konnte vorangegangenen WAL-Eintrag bei %X/%X nicht finden: %s
konnte Verzeichnis »%s« nicht öffnen: %s
konnte Datei »%s« nicht zum Lesen öffnen: %s
konnte Datei »%s« nicht zum Kürzen öffnen: %s
konnte Datei »%s« nicht öffnen: %s
konnte Quelldatei »%s« nicht öffnen: %s
konnte Zieldatei »%s« nicht öffnen: %s
konnte WAL-Eintrag bei %X/%X nicht lesen
konnte WAL-Eintrag bei %X/%X nicht lesen: %s
konnte Verzeichnis »%s« nicht lesen: %s
konnte Datei »%s« nicht lesen: %s
konnte nicht aus Datei »%s« lesen: %s
konnte symbolische Verknüpfung »%s« nicht lesen: %s
konnte Verzeichnis »%s« nicht löschen: %s
konnte Datei »%s« nicht löschen: %s
konnte symbolische Verknüpfung »%s« nicht löschen: %s
konnte Positionszeiger in Datei »%s« nicht setzen: %s
konnte Positionszeiger in Quelldatei nicht setzen: %s
konnte Positionszeiger in Zieldatei »%s« nicht setzen: %s
konnte COPY-Daten nicht senden: %s konnte COPY-Ende nicht senden: %s konnte Dateiliste nicht senden: %s konnte Anfrage nicht senden: %s konnte libpq-Verbindung nicht in den Einzelzeilenmodus setzen
konnte »stat« für Datei »%s« nicht ausführen: %s
konnte Datei »%s« nicht auf %u kürzen: %s
konnte Datei »%s« nicht schreiben: %s
Datendatei »%s« in der Quelle ist keine normale Datei
Fehler beim Ausführen einer Anfrage (%s) im Quellserver: %s Datei »%s« geholt, Länge %d
full_page_writes muss im Quell-Server eingeschaltet sein
hole Dateistücke
ungültige Resource-Manager-Datenprüfsumme in Datensatz bei %X/%X ungültige Aktion (CREATE) für normale Datei
ungültige block_id %u bei %X/%X ungültiges komprimiertes Abbild bei %X/%X, Block %d ungültige Contrecord-Länge %u bei %X/%X ungültige Kontrolldatei
ungültige Daten in History-Datei
ungültige Daten in History-Datei: %s
ungültige Info-Bits %04X in Logsegment %s, Offset %u ungültige magische Zahl %04X in Logsegment %s, Offset %u ungültige Datensatzlänge bei %X/%X: %u erwartet, %u erhalten ungültiger Datensatz-Offset bei %X/%X ungültige Resource-Manager-ID %u bei %X/%X %lu MB müssen kopiert werden (Gesamtgröße des Quellverzeichnisses ist %lu MB)
weder BKPIMAGE_HAS_HOLE noch BKPIMAGE_IS_COMPRESSED gesetzt, aber Block-Abbild-Länge ist %u bei %X/%X kein Rückspulen nötig
Speicher aufgebraucht
block_id %u außer der Reihe bei %X/%X Zeitleisten-ID %u außer der Reihe (nach %u) in Logsegment %s, Offset %u lese WAL im Ziel-Cluster
lese Quelldateiliste
lese Zieldateiliste
Stück von Datei »%s« empfangen, Offset %s, Größe %d
NULL-Wert für Stück von Datei »%s« empfangen, Datei wurde gelöscht
Datensatzlänge %u bei %X/%X ist zu lang Datensatz mit falschem Prev-Link %X/%X bei %X/%X Datensatz mit ungültiger Länge bei %X/%X Rückspulen ab letztem gemeinsamen Checkpoint bei %X/%X auf Zeitleiste %u
Server divergierten bei WAL-Position %X/%X auf Zeitleiste %u
Quell- und Ziel-Cluster sind auf der gleichen Zeitleiste
Quell- und Ziel-Cluster sind von verschiedenen Systemen
Quelldatenverzeichnis muss sauber heruntergefahren worden sein
Quelldateiliste ist leer
Quell-Server darf nicht im Wiederherstellungsmodus sein
Ziel für symbolische Verknüpfung »%s« ist zu lang
Synchronisieren des Zielverzeichnisses fehlgeschlagen
synchronisiere Zieldatenverzeichnis
Syntaxfehler in History-Datei: %s
Zielserver muss sauber heruntergefahren worden sein
Zielserver muss entweder Datenprüfsummen oder »wal_log_hints = on« verwenden
keine Contrecord-Flag bei %X/%X unerwartetes EOF beim Lesen der Datei »%s«
unerwartete CRC in Kontrolldatei
unerwartete Kontrolldateigröße %d, erwartet wurde %d
unerwartete Datentypen in Ergebnismenge beim Holen von fernen Dateien: %u %u %u
unerwartete NULL-Werte im Ergebnis beim Holen von fernen Dateien
unerwartete Seitenänderung für Verzeichnis oder symbolische Verknüpfung »%s«
unerwartete Pageaddr %X/%X in Logsegment %s, Offset %u unerwartetes Ergebnisformat beim Holen von fernen Dateien
unerwartete Ergebnislänge beim Holen von fernen Dateien
Anfrage ergab unerwartete Ergebnismenge
unerwartete Ergebnismengengröße beim Holen von fernen Dateien
unerwartete Ergebnismenge beim Holen der Dateiliste
unerwartete Ergebnismenge beim Holen der fernen Datei »%s«
unerwartetes Ergebnis beim Holen von fernen Dateien: %s unerwartetes Ergebnis beim Senden der Dateiliste: %s unbekanntes Ergebnis »%s« für aktuelle WAL-Einfügeposition
locale/de/LC_MESSAGES/initdb-9.6.mo 0000644 00000056672 14751153420 0012322 0 ustar 00 �� � , � <
�
R �
* 5 - F g t ` � � = W W X � A � 5 � J / z 6 � P � C : b Q � 5 � ] % 4 � B � H � G D > � 4 � 9 3 : ? n / � - � > y K ( � # � , - ? 7 m ( � 6 � , ' 2 5 Z F � " � < � & 7 - ^ - � ! � 1 � ? & N / u = � ! � " 6 ( + _ � 0 � ; � $ / 4 & d � $ � ~ � 1 M < � G � 3 " 8 V ( � J � � � � C � - C! 8 q! ! �! , �! �! J " 0 \" 4 �" A �" @ # R E# K �# " �# ! $ � )$ d �$ % %% � D% [ �% R $& K w& % �& �& ' ' ; 8' ; t' � �' @ A( ; �( �( u �) q E* f �* s + & �+ �+ ) �+ t �+ / `, �, & �, 0 �, . �, - &- T- k- & }- # �- �- $ �- ( . + 7. " c. �. " �. ! �. , �. $ / * 8/ % c/ ! �/ �/ �/ 0 �/ 0 (0 ,0 ;0 - M0 {0 & �0 % �0 �0 3 1 :1 T1 ( h1 q �1 ] 3 & a3 �3 �3 6 �3 n �3 � N4 � �4 ~ �5 � <6 4 �6 G �7 2 >8 I q8 $ �8 ? �8 [ 9 J |9 A �9 } : A �: Z �: 4 $; I Y; E �; A �; > +< = j< : �< 8 �< J = 5 g= . �= S �= � > 6 �> 0 ? / 3? 7 c? > �? 1 �? > @ > K@ . �@ > �@ K �@ * DA G oA 0 �A 4 �A 8 B * VB 7 �B M �B . C 5 6C D lC ; �C , �C D D 5 _D �D : �D D �D , 1E 6 ^E 5 �E ! �E ) �E � F + �F I �F # G V ?G A �G B �G 2 H S NH � �H |I " �I M �I 3 J = <J % zJ / �J �J X �J N IK < �K N �K 9 $L d ^L N �L + M + >M � jM u N �N + �N � �N d oO c �O W 8P 5 �P % �P - �P Q : /Q F jQ � �Q F RR < �R @ �R � T � �T � 6U � �U 8 KV �V @ �V � �V 2 _W �W # �W 1 �W - �W + )X UX rX / �X / �X ( �X 0 Y 0 BY 7 sY , �Y ' �Y * Z 2 +Z 9 ^Z / �Z H �Z * [ " <[ _[ {[ @ �[ �[ �[ \ \ 0 1\ b\ , �\ + �\ % �\ 9 ] ( <] e] ; ~] � � 5 ( � ] � � J l 6 H X � � K z � � r I � � { � N d R V o | ~ � . y U } � m � ` G = * f / $ � > _ � # A � t C 8 Y 0 T , � % + v L 3 � 2 n � � h B j E ? 9 ) ! & � � � q � � D S Z g
e ; ' ^ " F x c � w P [ s � @ i �
1 - \ � u : k � 4 W Q 7 � O � < M p a b �
If the data directory is not specified, the environment variable PGDATA
is used.
Less commonly used options:
Options:
Other options:
Report bugs to <pgsql-bugs@postgresql.org>.
Success. You can now start the database server using:
%s%s%spg_ctl%s -D %s%s%s -l logfile start
Sync to disk skipped.
The data directory might become corrupt if the operating system crashes.
WARNING: enabling "trust" authentication for local connections
You can change this by editing pg_hba.conf or using the option -A, or
--auth-local and --auth-host, the next time you run initdb.
--auth-host=METHOD default authentication method for local TCP/IP connections
--auth-local=METHOD default authentication method for local-socket connections
--lc-collate=, --lc-ctype=, --lc-messages=LOCALE
--lc-monetary=, --lc-numeric=, --lc-time=LOCALE
set default locale in the respective category for
new databases (default taken from environment)
--locale=LOCALE set default locale for new databases
--no-locale equivalent to --locale=C
--pwfile=FILE read password for the new superuser from file
%s [OPTION]... [DATADIR]
-?, --help show this help, then exit
-A, --auth=METHOD default authentication method for local connections
-E, --encoding=ENCODING set default encoding for new databases
-L DIRECTORY where to find the input files
-N, --nosync do not wait for changes to be written safely to disk
-S, --sync-only only sync data directory
-T, --text-search-config=CFG
default text search configuration
-U, --username=NAME database superuser name
-V, --version output version information, then exit
-W, --pwprompt prompt for a password for the new superuser
-X, --xlogdir=XLOGDIR location for the transaction log directory
-d, --debug generate lots of debugging output
-k, --data-checksums use data page checksums
-n, --noclean do not clean up after errors
-s, --show show internal settings
[-D, --pgdata=]DATADIR location for this database cluster
%s initializes a PostgreSQL database cluster.
%s: "%s" is not a valid server encoding name
%s: WARNING: cannot create restricted tokens on this platform
%s: cannot be run as root
Please log in (using, e.g., "su") as the (unprivileged) user that will
own the server process.
%s: could not access directory "%s": %s
%s: could not access file "%s": %s
%s: could not allocate SIDs: error code %lu
%s: could not change permissions of "%s": %s
%s: could not change permissions of directory "%s": %s
%s: could not create directory "%s": %s
%s: could not create restricted token: error code %lu
%s: could not create symbolic link "%s": %s
%s: could not execute command "%s": %s
%s: could not find suitable encoding for locale "%s"
%s: could not find suitable text search configuration for locale "%s"
%s: could not fsync file "%s": %s
%s: could not get exit code from subprocess: error code %lu
%s: could not open directory "%s": %s
%s: could not open file "%s" for reading: %s
%s: could not open file "%s" for writing: %s
%s: could not open file "%s": %s
%s: could not open process token: error code %lu
%s: could not re-execute with restricted token: error code %lu
%s: could not read directory "%s": %s
%s: could not read password from file "%s": %s
%s: could not start process for command "%s": error code %lu
%s: could not stat file "%s": %s
%s: could not write file "%s": %s
%s: data directory "%s" not removed at user's request
%s: directory "%s" exists but is not empty
%s: encoding mismatch
%s: failed to remove contents of data directory
%s: failed to remove contents of transaction log directory
%s: failed to remove data directory
%s: failed to remove transaction log directory
%s: failed to restore old locale "%s"
%s: file "%s" does not exist
%s: file "%s" is not a regular file
%s: input file "%s" does not belong to PostgreSQL %s
Check your installation or specify the correct path using the option -L.
%s: input file location must be an absolute path
%s: invalid authentication method "%s" for "%s" connections
%s: invalid locale name "%s"
%s: invalid locale settings; check LANG and LC_* environment variables
%s: locale "%s" requires unsupported encoding "%s"
%s: locale name has non-ASCII characters, skipped: "%s"
%s: locale name too long, skipped: "%s"
%s: must specify a password for the superuser to enable %s authentication
%s: no data directory specified
You must identify the directory where the data for this database system
will reside. Do this with either the invocation option -D or the
environment variable PGDATA.
%s: out of memory
%s: password file "%s" is empty
%s: password prompt and password file cannot be specified together
%s: removing contents of data directory "%s"
%s: removing contents of transaction log directory "%s"
%s: removing data directory "%s"
%s: removing transaction log directory "%s"
%s: setlocale() failed
%s: superuser name "%s" is disallowed; role names cannot begin with "pg_"
%s: symlinks are not supported on this platform
%s: too many command-line arguments (first is "%s")
%s: transaction log directory "%s" not removed at user's request
%s: transaction log directory location must be an absolute path
%s: warning: specified text search configuration "%s" might not match locale "%s"
%s: warning: suitable text search configuration for locale "%s" is unknown
Data page checksums are disabled.
Data page checksums are enabled.
Encoding "%s" implied by locale is not allowed as a server-side encoding.
The default database encoding will be set to "%s" instead.
Encoding "%s" is not allowed as a server-side encoding.
Rerun %s with a different locale selection.
Enter it again: Enter new superuser password: If you want to create a new database system, either remove or empty
the directory "%s" or run %s
with an argument other than "%s".
If you want to store the transaction log there, either
remove or empty the directory "%s".
It contains a dot-prefixed/invisible file, perhaps due to it being a mount point.
It contains a lost+found directory, perhaps due to it being a mount point.
No usable system locales were found.
Passwords didn't match.
Rerun %s with the -E option.
Running in debug mode.
Running in noclean mode. Mistakes will not be cleaned up.
The database cluster will be initialized with locale "%s".
The database cluster will be initialized with locales
COLLATE: %s
CTYPE: %s
MESSAGES: %s
MONETARY: %s
NUMERIC: %s
TIME: %s
The default database encoding has accordingly been set to "%s".
The default text search configuration will be set to "%s".
The encoding you selected (%s) and the encoding that the
selected locale uses (%s) do not match. This would lead to
misbehavior in various character string processing functions.
Rerun %s and either do not specify an encoding explicitly,
or choose a matching combination.
The files belonging to this database system will be owned by user "%s".
This user must also own the server process.
The program "postgres" is needed by %s but was not found in the
same directory as "%s".
Check your installation.
The program "postgres" was found by "%s"
but was not the same version as %s.
Check your installation.
This might mean you have a corrupted installation or identified
the wrong directory with the invocation option -L.
Try "%s --help" for more information.
Usage:
Use the option "--debug" to see details.
Using a mount point directly as the data directory is not recommended.
Create a subdirectory under the mount point.
cannot duplicate null pointer (internal error)
caught signal
child process exited with exit code %d child process exited with unrecognized status %d child process was terminated by exception 0x%X child process was terminated by signal %d: %s command not executable command not found could not change directory to "%s": %s could not close directory "%s": %s
could not find a "%s" to execute could not get junction for "%s": %s
could not identify current directory: %s could not look up effective user ID %ld: %s could not open directory "%s": %s
could not read binary "%s" could not read directory "%s": %s
could not read symbolic link "%s" could not remove file or directory "%s": %s
could not set junction for "%s": %s
could not stat file or directory "%s": %s
could not write to child process: %s
creating configuration files ... creating directory %s ... creating subdirectories ... fixing permissions on existing directory %s ... invalid binary "%s" ok
out of memory
pclose failed: %s performing post-bootstrap initialization ... running bootstrap script ... selecting default max_connections ... selecting default shared_buffers ... selecting default timezone ... selecting dynamic shared memory implementation ... syncing data to disk ... user does not exist user name lookup failure: error code %lu Project-Id-Version: PostgreSQL 9.6
Report-Msgid-Bugs-To: pgsql-bugs@postgresql.org
POT-Creation-Date: 2020-08-09 00:42+0000
PO-Revision-Date: 2019-06-16 22:28+0200
Last-Translator: Peter Eisentraut <peter_e@gmx.net>
Language-Team: Peter Eisentraut <peter_e@gmx.net>
Language: de
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Wenn kein Datenverzeichnis angegeben ist, dann wird die Umgebungsvariable
PGDATA verwendet.
Weniger häufig verwendete Optionen:
Optionen:
Weitere Optionen:
Berichten Sie Fehler an <pgsql-bugs@postgresql.org>.
Erfolg. Sie können den Datenbankserver jetzt mit
%s%s%spg_ctl%s -D %s%s%s -l logdatei start
starten.
Synchronisation auf Festplatte übersprungen.
Das Datenverzeichnis könnte verfälscht werden, falls das Betriebssystem abstürzt.
WARNUNG: Authentifizierung für lokale Verbindungen auf »trust« gesetzt
Sie können dies ändern, indem Sie pg_hba.conf bearbeiten oder beim
nächsten Aufruf von initdb die Option -A, oder --auth-local und
--auth-host, verwenden.
--auth-host=METHODE vorgegebene Authentifizierungsmethode für lokale
TCP/IP-Verbindungen
--auth-local=METHODE vorgegebene Authentifizierungsmethode für Verbindungen
auf lokalen Sockets
--lc-collate=, --lc-ctype=, --lc-messages=LOCALE
--lc-monetary=, --lc-numeric=, --lc-time=LOCALE
setze Standardlocale in der jeweiligen Kategorie
für neue Datenbanken (Voreinstellung aus der
Umgebung entnommen)
--locale=LOCALE setze Standardlocale für neue Datenbanken
--no-locale entspricht --locale=C
--pwfile=DATEI lese Passwort des neuen Superusers aus Datei
%s [OPTION]... [DATENVERZEICHNIS]
-?, --help diese Hilfe anzeigen, dann beenden
-A, --auth=METHODE vorgegebene Authentifizierungsmethode für lokale Verbindungen
-E, --encoding=KODIERUNG setze Standardkodierung für neue Datenbanken
-L VERZEICHNIS wo sind die Eingabedateien zu finden
-N, --nosync nicht warten, bis Änderungen sicher auf Festplatte
geschrieben sind
-S, --sync-only nur Datenverzeichnis synchronisieren
-T, --text-search-config=KFG
Standardtextsuchekonfiguration
-U, --username=NAME Datenbank-Superusername
-V, --version Versionsinformationen anzeigen, dann beenden
-W, --pwprompt frage nach Passwort für neuen Superuser
-X, --xlogdir=XLOGVERZ Verzeichnis für das Transaktionslog
-d, --debug erzeuge eine Menge Debug-Ausgaben
-k, --data-checksums Datenseitenprüfsummen verwenden
-n, --noclean nach Fehlern nicht aufräumen
-s, --show zeige interne Einstellungen
[-D, --pgdata=]DATENVERZ Datenverzeichnis für diesen Datenbankcluster
%s initialisiert einen PostgreSQL-Datenbankcluster.
%s: »%s« ist keine gültige Serverkodierung
%s: WARNUNG: auf dieser Plattform können keine beschränkten Token erzeugt werden
%s: kann nicht als root ausgeführt werden
Bitte loggen Sie sich (z.B. mit »su«) als der (unprivilegierte) Benutzer
ein, der Eigentümer des Serverprozesses sein soll.
%s: konnte nicht auf Verzeichnis »%s« zugreifen: %s
%s: konnte nicht auf Datei »%s« zugreifen: %s
%s: konnte SIDs nicht erzeugen: Fehlercode %lu
%s: konnte Zugriffsrechte von »%s« nicht ändern: %s
%s: konnte Rechte des Verzeichnisses »%s« nicht ändern: %s
%s: konnte Verzeichnis »%s« nicht erzeugen: %s
%s: konnte beschränktes Token nicht erzeugen: Fehlercode %lu
%s: konnte symbolische Verknüpfung »%s« nicht erzeugen: %s
%s: konnte Befehl »%s« nicht ausführen: %s
%s: konnte keine passende Kodierung für Locale »%s« finden
%s: konnte keine passende Textsuchekonfiguration für Locale »%s« finden
%s: konnte Datei »%s« nicht fsyncen: %s
%s: konnte Statuscode des Subprozesses nicht ermitteln: Fehlercode %lu
%s: konnte Verzeichnis »%s« nicht öffnen: %s
%s: konnte Datei »%s« nicht zum Lesen öffnen: %s
%s: konnte Datei »%s« nicht zum Schreiben öffnen: %s
%s: konnte Datei »%s« nicht öffnen: %s
%s: konnte Prozess-Token nicht öffnen: Fehlercode %lu
%s: konnte Prozess nicht mit beschränktem Token neu starten: Fehlercode %lu
%s: konnte Verzeichnis »%s« nicht lesen: %s
%s: konnte Passwort nicht aus Datei »%s« lesen: %s
%s: konnte Prozess für Befehl »%s« nicht starten: Fehlercode %lu
%s: konnte »stat« für Datei »%s« nicht ausführen: %s
%s: konnte Datei »%s« nicht schreiben: %s
%s: Datenverzeichnis »%s« wurde auf Anwenderwunsch nicht entfernt
%s: Verzeichnis »%s« existiert aber ist nicht leer
%s: unpassende Kodierungen
%s: konnte Inhalt des Datenverzeichnisses nicht entfernen
%s: konnte Inhalt des Transaktionslogverzeichnisses nicht entfernen
%s: konnte Datenverzeichnis nicht entfernen
%s: konnte Transaktionslogverzeichnis nicht entfernen
%s: konnte alte Locale »%s« nicht wiederherstellen
%s: Datei »%s« existiert nicht
%s: Datei »%s« ist keine normale Datei
%s: Eingabedatei »%s« gehört nicht zu PostgreSQL %s
Prüfen Sie Ihre Installation oder geben Sie den korrekten Pfad mit der
Option -L an.
%s: Eingabedatei muss absoluten Pfad haben
%s: ungültige Authentifizierungsmethode »%s« für »%s«-Verbindungen
%s: ungültiger Locale-Name »%s«
%s: ungültige Locale-Einstellungen; prüfen Sie die Umgebungsvariablen LANG und LC_*
%s: Locale »%s« benötigt nicht unterstützte Kodierung »%s«
%s: Locale-Name hat Nicht-ASCII-Zeichen, wird ausgelassen: »%s«
%s: Locale-Name zu lang, wird ausgelassen: »%s«
%s: Superuser-Passwort muss angegeben werden um %s-Authentifizierung einzuschalten
%s: kein Datenverzeichnis angegeben
Sie müssen das Verzeichnis angeben, wo dieses Datenbanksystem abgelegt
werden soll. Machen Sie dies entweder mit der Kommandozeilenoption -D
oder mit der Umgebungsvariable PGDATA.
%s: Speicher aufgebraucht
%s: Passwortdatei »%s« ist leer
%s: Passwortprompt und Passwortdatei können nicht zusammen angegeben werden
%s: entferne Inhalt des Datenverzeichnisses »%s«
%s: entferne Inhalt des Transaktionslogverzeichnisses »%s«
%s: entferne Datenverzeichnis »%s«
%s: entferne Transaktionslogverzeichnis »%s«
%s: setlocale() fehlgeschlagen
%s: Superuser-Name »%s« nicht erlaubt; Rollennamen können nicht mit »pg_« anfangen
%s: symbolische Verknüpfungen werden auf dieser Plattform nicht unterstützt
%s: zu viele Kommandozeilenargumente (das erste ist »%s«)
%s: Transaktionslogverzeichnis »%s« wurde auf Anwenderwunsch nicht entfernt
%s: Transaktionslogverzeichnis muss absoluten Pfad haben
%s: Warnung: angegebene Textsuchekonfiguration »%s« passt möglicherweise nicht zur Locale »%s«
%s: Warnung: passende Textsuchekonfiguration für Locale »%s« ist unbekannt
Datenseitenprüfsummen sind ausgeschaltet.
Datenseitenprüfsummen sind eingeschaltet.
Die von der Locale gesetzte Kodierung »%s« ist nicht als serverseitige Kodierung erlaubt.
Die Standarddatenbankkodierung wird stattdessen auf »%s« gesetzt.
Kodierung »%s« ist nicht als serverseitige Kodierung erlaubt.
Starten Sie %s erneut mit einer anderen Locale-Wahl.
Geben Sie es noch einmal ein: Geben Sie das neue Superuser-Passwort ein: Wenn Sie ein neues Datenbanksystem erzeugen wollen, entfernen oder leeren
Sie das Verzeichnis »%s« or führen Sie %s
mit einem anderen Argument als »%s« aus.
Wenn Sie dort den Transaktionslog ablegen wollen, entfernen oder leeren
Sie das Verzeichnis »%s«.
Es enthält eine unsichtbare Datei (beginnt mit Punkt), vielleicht weil es ein Einhängepunkt ist.
Es enthält ein Verzeichnis »lost+found«, vielleicht weil es ein Einhängepunkt ist.
Es wurden keine brauchbaren System-Locales gefunden.
Passwörter stimmten nicht überein.
Führen Sie %s erneut mit der Option -E aus.
Debug-Modus ist an.
Noclean-Modus ist an. Bei Fehlern wird nicht aufgeräumt.
Der Datenbankcluster wird mit der Locale »%s« initialisiert werden.
Der Datenbankcluster wird mit folgenden Locales initialisiert werden:
COLLATE: %s
CTYPE: %s
MESSAGES: %s
MONETARY: %s
NUMERIC: %s
TIME: %s
Die Standarddatenbankkodierung wurde entsprechend auf »%s« gesetzt.
Die Standardtextsuchekonfiguration wird auf »%s« gesetzt.
Die von Ihnen gewählte Kodierung (%s) und die von der gewählten
Locale verwendete Kodierung (%s) passen nicht zu einander. Das
würde in verschiedenen Zeichenkettenfunktionen zu Fehlverhalten
führen. Starten Sie %s erneut und geben Sie entweder keine
Kodierung explizit an oder wählen Sie eine passende Kombination.
Die Dateien, die zu diesem Datenbanksystem gehören, werden dem Benutzer
»%s« gehören. Diesem Benutzer muss auch der Serverprozess gehören.
Das Programm »postgres« wird von %s benötigt, aber wurde nicht im
selben Verzeichnis wie »%s« gefunden.
Prüfen Sie Ihre Installation.
Das Programm »postgres« wurde von %s gefunden,
aber es hatte nicht die gleiche Version wie %s.
Prüfen Sie Ihre Installation.
Das könnte bedeuten, dass Ihre Installation fehlerhaft ist oder dass Sie das
falsche Verzeichnis mit der Kommandozeilenoption -L angegeben haben.
Versuchen Sie »%s --help« für weitere Informationen.
Aufruf:
Verwenden Sie die Option »--debug«, um Einzelheiten zu sehen.
Einen Einhängepunkt direkt als Datenverzeichnis zu verwenden wird nicht empfohlen.
Erzeugen Sie ein Unterverzeichnis unter dem Einhängepunkt.
kann NULL-Zeiger nicht kopieren (interner Fehler)
Signal abgefangen
Kindprozess hat mit Code %d beendet Kindprozess hat mit unbekanntem Status %d beendet Kindprozess wurde durch Ausnahme 0x%X beendet Kindprozess wurde von Signal %d beendet: %s Befehl ist nicht ausführbar Befehl nicht gefunden konnte nicht in Verzeichnis »%s« wechseln: %s konnte Verzeichnis »%s« nicht schließen: %s
konnte kein »%s« zum Ausführen finden konnte Junction für »%s« nicht ermitteln: %s
konnte aktuelles Verzeichnis nicht ermitteln: %s konnte effektive Benutzer-ID %ld nicht nachschlagen: %s konnte Verzeichnis »%s« nicht öffnen: %s
konnte Programmdatei »%s« nicht lesen konnte Verzeichnis »%s« nicht lesen: %s
konnte symbolische Verknüpfung »%s« nicht lesen konnte Datei oder Verzeichnis »%s« nicht entfernen: %s
konnte Junction für »%s« nicht erzeugen: %s
konnte »stat« für Datei oder Verzeichnis »%s« nicht ausführen: %s
konnte nicht an Kindprozess schreiben: %s
erzeuge Konfigurationsdateien ... erzeuge Verzeichnis %s ... erzeuge Unterverzeichnisse ... berichtige Zugriffsrechte des bestehenden Verzeichnisses %s ... ungültige Programmdatei »%s« ok
Speicher aufgebraucht
pclose fehlgeschlagen: %s führe Post-Bootstrap-Initialisierung durch ... führe Bootstrap-Skript aus ... wähle Vorgabewert für max_connections ... wähle Vorgabewert für shared_buffers ... wähle Vorgabewert für timezone ... wähle Implementierung von dynamischem Shared Memory ... synchronisiere Daten auf Festplatte ... Benutzer existiert nicht Fehler beim Nachschlagen des Benutzernamens: Fehlercode %lu locale/de/LC_MESSAGES/ecpglib6-9.6.mo 0000644 00000007167 14751153420 0012537 0 ustar 00 �� ! $ / , � � � � ) ' - Q : 0 � $ � ( 9 L * c ; � > � 3 < = & z 1 � � + � ' @ % Y � , � � 2 0 ; / l q � $ ? . O 8 ~ P � 6
- ?
> m
�
�
4 �
I A ] ; � D � . 8 O ! � 2 � % � "
( &
O
p
1 �
, �
+ �
0 * L
! <DEFAULT> <empty> NULL SQL error %d on line %d SQL error: %s
connection "%s" does not exist on line %d could not connect to database "%s" on line %d could not convert boolean value: size mismatch, on line %d data read from server is not an array on line %d descriptor "%s" not found on line %d descriptor index out of range on line %d empty message text empty query on line %d error in transaction processing on line %d inserting an array of variables is not supported on line %d invalid input syntax for floating-point type: "%s", on line %d invalid input syntax for type int: "%s", on line %d invalid input syntax for type unsigned int: "%s", on line %d invalid statement name "%s" on line %d invalid syntax for type boolean: "%s", on line %d no data found on line %d not connected to connection "%s" on line %d null value without indicator on line %d out of memory on line %d the connection to the server was lost too few arguments on line %d too many arguments on line %d unrecognized descriptor item "%s" on line %d unsupported type "%s" on line %d variable does not have a character type on line %d variable does not have a numeric type on line %d variable does not have an array type on line %d Project-Id-Version: PostgreSQL 9.3
Report-Msgid-Bugs-To: pgsql-bugs@postgresql.org
POT-Creation-Date: 2010-03-18 17:23+0000
PO-Revision-Date: 2013-09-04 20:30-0400
Last-Translator: Peter Eisentraut <peter_e@gmx.net>
Language-Team: Peter Eisentraut <peter_e@gmx.net>
Language: de
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
<DEFAULT> <leer> NULL SQL-Fehler %d auf Zeile %d SQL-Fehler: %s
Verbindung »%s« existiert nicht auf Zeile %d konnte nicht mit Datenbank »%s« verbinden auf Zeile %d konnte boolean-Wert nicht umwandeln: Größe stimmt nicht überein, auf Zeile %d vom Server gelesene Daten sind kein Array auf Zeile %d Deskriptor »%s« nicht gefunden auf Zeile %d Deskriptorindex außerhalb des gültigen Bereichs auf Zeile %d leerer Nachrichtentext leere Anfrage auf Zeile %d Fehler bei der Transaktionsverarbeitung auf Zeile %d Einfügen in ein Array aus Variablen wird nicht unterstützt auf Zeile %d ungültige Eingabesyntax für Gleitkommatyp: »%s«, auf Zeile %d ungültige Eingabesyntax für Typ int: »%s«, auf Zeile %d ungültige Eingabesyntax für Typ unsigned int: »%s«, auf Zeile %d ungültiger Anweisungsname »%s« auf Zeile %d ungültige Syntax für Typ boolean: »%s«, auf Zeile %d keine Daten gefunden auf Zeile %d nicht mit Verbindung »%s« verbunden auf Zeile %d NULL-Wert ohne Indikator auf Zeile %d Speicher aufgebraucht auf Zeile %d die Verbindung zum Server wurde verloren zu wenige Argumente auf Zeile %d zu viele Argumente auf Zeile %d unbekanntes Deskriptorelement »%s« auf Zeile %d nicht unterstützter Typ »%s« auf Zeile %d Variable hat keinen Zeichentyp auf Zeile %d Variable hat keinen numerischen Typ auf Zeile %d Variable hat keinen Array-Typ auf Zeile %d locale/de/LC_MESSAGES/pg_ctl-9.6.mo 0000644 00000044317 14751153420 0012312 0 ustar 00 �� � � � , 0 D 1 ? v � � & �
0
- O
}
�
= �
�
� ! � a � K 0 | A � ! � 3 � ? / H o D � C � E A ? � ? � > 9 F L � B � E � V 0 � F > S 8 � I � % 2 ; O n 7 � � � M - f ! � > � E � C ; y 9 � D 3 C x D � > A @ ( � , � 2 � 6 > B * � / � % � 1 0 4 # e � 4 � 2 � 1 0 A , r . � 3 � + " 1 N 6 � : � 1 � * $ " O 7 r " � $ � J � = Y 3 p 0 � � ! � $ ; - \ � 4 � % � $ ! " *! ! M! F o! u �! F ," s" 7 �" ) �" k �" ` U# % �# & �# $ d $ p$ / �$ & �$ 0 �$ . % - F% t% �% & �% �% , �% ( & ;& ! V& x& �& �& �& �& �& �& ' ' $' 4' " L' o' q �' N ) R O) % �) �) 0 �) $ * ' 9* 6 a* �* �* @ �* + ! + � A+ ! �+ d �+ N X, �, C �, - < )- . f- M �- S �- ? 7. I w. F �. E / C N/ 8 �/ o �/ x ;0 P �0 � 1 7 �1 G �1 : 2 ? A2 e �2 ' �2 4 3 g D3 F �3 �3 �3 4 q 4 ; �4 % �4 S �4 M >5 L �5 � �5 D �6 I �6 H 7 J \7 Y �7 G 8 6 I8 / �8 @ �8 > �8 B 09 - s9 3 �9 . �9 7 : = <: ( z: $ �: B �: A ; = M; ; �; 1 �; 4 �; < .< $ k< 0 �< = �< D �< ; D= A �= 8 �= ' �= < #> ) `> + �> S �>
? )? @ A? 4 �? ! �? �? 0 �? . (@ + W@ " �@ < �@ ' �@ & A " 2A UA _ vA s �A W JB �B M �B 1 C � 6C z �C 6 8D 8 oD �D ~ �D 0E 2 PE # �E 1 �E - �E + F 3F PF / fF ( �F 8 �F 0 �F ' )G 2 QG �G �G �G �G �G H H ;H MH ]H pH ' �H �H P W � , � ` n m $ p � ~ < A 9 T ! : M D a G 2 E I { c # d � K | � � Q & ) 8 B 4 _ > f � y ( v L [ h \ ^ Z � 5 X R C F O } + � r � ] u w Y
e � x
7 / k - 0 � q 1 � b j ; 6 t g � N " @ U z H J . � ? s V � % S = � l ' * o 3 i �
%s: -w option cannot use a relative socket directory specification
%s: -w option is not supported when starting a pre-9.1 server
Allowed signal names for kill:
Common options:
Options for register and unregister:
Options for start or restart:
Options for stop or restart:
Report bugs to <pgsql-bugs@postgresql.org>.
Shutdown modes are:
Start types are:
%s init[db] [-D DATADIR] [-s] [-o "OPTIONS"]
%s kill SIGNALNAME PID
%s promote [-D DATADIR] [-s]
%s register [-N SERVICENAME] [-U USERNAME] [-P PASSWORD] [-D DATADIR]
[-S START-TYPE] [-w] [-t SECS] [-o "OPTIONS"]
%s reload [-D DATADIR] [-s]
%s restart [-w] [-t SECS] [-D DATADIR] [-s] [-m SHUTDOWN-MODE]
[-o "OPTIONS"]
%s start [-w] [-t SECS] [-D DATADIR] [-s] [-l FILENAME] [-o "OPTIONS"]
%s status [-D DATADIR]
%s stop [-W] [-t SECS] [-D DATADIR] [-s] [-m SHUTDOWN-MODE]
%s unregister [-N SERVICENAME]
-?, --help show this help, then exit
-D, --pgdata=DATADIR location of the database storage area
-N SERVICENAME service name with which to register PostgreSQL server
-P PASSWORD password of account to register PostgreSQL server
-S START-TYPE service start type to register PostgreSQL server
-U USERNAME user name of account to register PostgreSQL server
-V, --version output version information, then exit
-W do not wait until operation completes
-c, --core-files allow postgres to produce core files
-c, --core-files not applicable on this platform
-e SOURCE event source for logging when running as a service
-l, --log=FILENAME write (or append) server log to FILENAME
-m, --mode=MODE MODE can be "smart", "fast", or "immediate"
-o OPTIONS command line options to pass to postgres
(PostgreSQL server executable) or initdb
-p PATH-TO-POSTGRES normally not necessary
-s, --silent only print errors, no informational messages
-t, --timeout=SECS seconds to wait when using -w option
-w wait until operation completes
auto start service automatically during system startup (default)
demand start service on demand
fast quit directly, with proper shutdown
immediate quit without complete shutdown; will lead to recovery on restart
smart quit after all clients have disconnected
done
failed
stopped waiting
%s is a utility to initialize, start, stop, or control a PostgreSQL server.
%s: -S option not supported on this platform
%s: PID file "%s" does not exist
%s: WARNING: cannot create restricted tokens on this platform
%s: WARNING: could not locate all job object functions in system API
%s: another server might be running; trying to start server anyway
%s: cannot be run as root
Please log in (using, e.g., "su") as the (unprivileged) user that will
own the server process.
%s: cannot promote server; server is not in standby mode
%s: cannot promote server; single-user server is running (PID: %ld)
%s: cannot reload server; single-user server is running (PID: %ld)
%s: cannot restart server; single-user server is running (PID: %ld)
%s: cannot set core file size limit; disallowed by hard limit
%s: cannot stop server; single-user server is running (PID: %ld)
%s: could not access directory "%s": %s
%s: could not allocate SIDs: error code %lu
%s: could not create promote signal file "%s": %s
%s: could not create restricted token: error code %lu
%s: could not determine the data directory using command "%s"
%s: could not find own program executable
%s: could not find postgres program executable
%s: could not open PID file "%s": %s
%s: could not open process token: error code %lu
%s: could not open service "%s": error code %lu
%s: could not open service manager
%s: could not read file "%s"
%s: could not register service "%s": error code %lu
%s: could not remove promote signal file "%s": %s
%s: could not send promote signal (PID: %ld): %s
%s: could not send reload signal (PID: %ld): %s
%s: could not send signal %d (PID: %ld): %s
%s: could not send stop signal (PID: %ld): %s
%s: could not start server
Examine the log output.
%s: could not start server: %s
%s: could not start server: error code %lu
%s: could not start service "%s": error code %lu
%s: could not unregister service "%s": error code %lu
%s: could not wait for server because of misconfiguration
%s: could not write promote signal file "%s": %s
%s: database system initialization failed
%s: directory "%s" does not exist
%s: directory "%s" is not a database cluster directory
%s: invalid data in PID file "%s"
%s: missing arguments for kill mode
%s: no database directory specified and environment variable PGDATA unset
%s: no operation specified
%s: no server running
%s: old server process (PID: %ld) seems to be gone
%s: option file "%s" must have exactly one line
%s: server does not shut down
%s: server is running (PID: %ld)
%s: service "%s" already registered
%s: service "%s" not registered
%s: single-user server is running (PID: %ld)
%s: the PID file "%s" is empty
%s: too many command-line arguments (first is "%s")
%s: unrecognized operation mode "%s"
%s: unrecognized shutdown mode "%s"
%s: unrecognized signal name "%s"
%s: unrecognized start type "%s"
(The default is to wait for shutdown, but not for start or restart.)
HINT: The "-m fast" option immediately disconnects sessions rather than
waiting for session-initiated disconnection.
If the -D option is omitted, the environment variable PGDATA is used.
Is server running?
Please terminate the single-user server and try again.
Server started and accepting connections
The program "%s" is needed by %s but was not found in the
same directory as "%s".
Check your installation.
The program "%s" was found by "%s"
but was not the same version as %s.
Check your installation.
Timed out waiting for server startup
Try "%s --help" for more information.
Usage:
WARNING: online backup mode is active
Shutdown will not complete until pg_stop_backup() is called.
Waiting for server startup...
cannot duplicate null pointer (internal error)
child process exited with exit code %d child process exited with unrecognized status %d child process was terminated by exception 0x%X child process was terminated by signal %d: %s command not executable command not found could not change directory to "%s": %s could not find a "%s" to execute could not get current working directory: %s
could not identify current directory: %s could not read binary "%s" could not read symbolic link "%s" invalid binary "%s" out of memory
pclose failed: %s server is still starting up
server promoting
server shutting down
server signaled
server started
server starting
server stopped
starting server anyway
waiting for server to shut down... waiting for server to start... Project-Id-Version: PostgreSQL 9.5
Report-Msgid-Bugs-To: pgsql-bugs@postgresql.org
POT-Creation-Date: 2020-08-09 00:41+0000
PO-Revision-Date: 2015-11-03 22:14-0500
Last-Translator: Peter Eisentraut <peter_e@gmx.net>
Language-Team: Peter Eisentraut <peter_e@gmx.net>
Language: de
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
%s: Option -w kann keine relative Angabe des Socket-Verzeichnisses verwenden
%s: Option -w wird beim Starten eines Servers vor Version 9.1 nicht unterstützt
Erlaubte Signalnamen für »kill«:
Optionen für alle Modi:
Optionen für »register« und »unregister«:
Optionen für Start oder Neustart:
Optionen für Anhalten oder Neustart:
Berichten Sie Fehler an <pgsql-bugs@postgresql.org>.
Shutdown-Modi sind:
Starttypen sind:
%s init[db] [-D DATENVERZ] [-s] [-o "OPTIONEN"]
%s kill SIGNALNAME PID
%s promote [-D DATENVERZ] [-s]
%s register [-N DIENSTNAME] [-U BENUTZERNAME] [-P PASSWORT] [-D DATENVERZ]
[-S STARTTYP] [-w] [-t SEK] [-o "OPTIONEN"]
%s reload [-D DATENVERZ] [-s]
%s restart [-w] [-t SEK] [-D DATENVERZ] [-s] [-m SHUTDOWN-MODUS]
[-o "OPTIONEN"]
%s start [-w] [-t SEK] [-D DATENVERZ] [-s] [-l DATEINAME] [-o "OPTIONEN"]
%s status [-D DATENVERZ]
%s stop [-W] [-t SEK] [-D DATENVERZ] [-s] [-m SHUTDOWN-MODUS]
%s unregister [-N DIENSTNAME]
-?, --help diese Hilfe anzeigen, dann beenden
-D, --pgdata=DATENVERZ Datenbankverzeichnis
-N DIENSTNAME Systemdienstname für Registrierung des PostgreSQL-Servers
-P PASSWORD Passwort des Benutzers für Registrierung des PostgreSQL-Servers
-S STARTTYP Systemdienst-Starttyp für PostgreSQL-Server
-U USERNAME Benutzername für Registrierung des PostgreSQL-Servers
-V, --version Versionsinformationen anzeigen, dann beenden
-W warte nicht bis Operation abgeschlossen ist
-c, --core-files erlaubt postgres Core-Dateien zu erzeugen
-c, --core-files betrifft diese Plattform nicht
-e QUELLE Ereignisquelle fürs Loggen, wenn als Systemdienst
gestartet
-l, --log=DATEINAME schreibe Serverlog in DATEINAME (wird an
bestehende Datei angehängt)
-m, --mode=MODUS MODUS kann »smart«, »fast« oder »immediate« sein
-o OPTIONEN Kommandozeilenoptionen für postgres (PostgreSQL-
Serverprogramm) oder initdb
-p PFAD-ZU-POSTGRES normalerweise nicht notwendig
-s, --silent zeige nur Fehler, keine Informationsmeldungen
-t, --timeout=SEK Sekunden zu warten bei Option -w
-w warte bis Operation abgeschlossen ist
auto Dienst automatisch starten beim Start des Betriebssystems
(Voreinstellung)
demand Dienst bei Bedarf starten
fast beende direkt, mit richtigem Shutdown
immediate beende ohne vollständigen Shutdown; führt zu Recovery-Lauf
beim Neustart
smart beende nachdem alle Clientverbindungen geschlossen sind
fertig
Fehler
Warten beendet
%s ist ein Hilfsprogramm, um einen PostgreSQL-Server zu initialisieren, zu
starten, anzuhalten oder zu steuern.
%s: Option -S wird auf dieser Plattform nicht unterstützt
%s: PID-Datei »%s« existiert nicht
%s: WARNUNG: auf dieser Plattform können keine beschränkten Token erzeugt werden
%s: WARNUNG: konnte nicht alle Job-Objekt-Funtionen in der System-API finden
%s: ein anderer Server läuft möglicherweise; versuche trotzdem zu starten
%s: kann nicht als root ausgeführt werden
Bitte loggen Sie sich (z.B. mit »su«) als der (unprivilegierte) Benutzer
ein, der Eigentümer des Serverprozesses sein soll.
%s: kann Server nicht befördern; Server ist nicht im Standby-Modus
%s: kann Server nicht befördern; Einzelbenutzerserver läuft (PID: %ld)
%s: kann Server nicht neu laden; Einzelbenutzerserver läuft (PID: %ld)
%s: kann Server nicht neu starten; Einzelbenutzerserver läuft (PID: %ld)
%s: kann Grenzwert für Core-Datei-Größe nicht setzen; durch harten Grenzwert verboten
%s: kann Server nicht anhalten; Einzelbenutzerserver läuft (PID: %ld)
%s: konnte nicht auf Verzeichnis »%s« zugreifen: %s
%s: konnte SIDs nicht erzeugen: Fehlercode %lu
%s: konnte Signaldatei zum Befördern »%s« nicht erzeugen: %s
%s: konnte beschränktes Token nicht erzeugen: Fehlercode %lu
%s: konnte das Datenverzeichnis mit Befehl »%s« nicht ermitteln
%s: konnte eigene Programmdatei nicht finden
%s: konnte »postgres« Programmdatei nicht finden
%s: konnte PID-Datei »%s« nicht öffnen: %s
%s: konnte Prozess-Token nicht öffnen: Fehlercode %lu
%s: konnte Systemdienst »%s« nicht öffnen: Fehlercode %lu
%s: konnte Servicemanager nicht öffnen
%s: konnte Datei »%s« nicht lesen
%s: konnte Systemdienst »%s« nicht registrieren: Fehlercode %lu
%s: konnte Signaldatei zum Befördern »%s« nicht entfernen: %s
%s: konnte Signal zum Befördern nicht senden (PID: %ld): %s
%s: konnte Signal zum Neuladen nicht senden (PID: %ld): %s
%s: konnte Signal %d nicht senden (PID: %ld): %s
%s: konnte Stopp-Signal nicht senden (PID: %ld): %s
%s: konnte Server nicht starten
Prüfen Sie die Logausgabe.
%s: konnte Server nicht starten: %s
%s: konnte Server nicht starten: Fehlercode %lu
%s: konnte Systemdienst »%s« nicht starten: Fehlercode %lu
%s: konnte Systemdienst »%s« nicht deregistrieren: Fehlercode %lu
%s: konnte wegen Fehlkonfiguration nicht auf Server warten
%s: konnte Signaldatei zum Befördern »%s« nicht schreiben: %s
%s: Initialisierung des Datenbanksystems fehlgeschlagen
%s: Verzeichnis »%s« existiert nicht
%s: Verzeichnis »%s« ist kein Datenbankclusterverzeichnis
%s: ungültige Daten in PID-Datei »%s«
%s: fehlende Argumente für »kill«-Modus
%s: kein Datenbankverzeichnis angegeben und Umgebungsvariable PGDATA nicht gesetzt
%s: keine Operation angegeben
%s: kein Server läuft
%s: alter Serverprozess (PID: %ld) scheint verschwunden zu sein
%s: Optionsdatei »%s« muss genau eine Zeile haben
%s: Server fährt nicht herunter
%s: Server läuft (PID: %ld)
%s: Systemdienst »%s« ist bereits registriert
%s: Systemdienst »%s« ist nicht registriert
%s: Einzelbenutzerserver läuft (PID: %ld)
%s: die PID-Datei »%s« ist leer
%s: zu viele Kommandozeilenargumente (das erste ist »%s«)
%s: unbekannter Operationsmodus »%s«
%s: unbekannter Shutdown-Modus »%s«
%s: unbekannter Signalname »%s«
%s: unbekannter Starttyp »%s«
(Die Voreinstellung ist, beim Herunterfahren zu warten, aber nicht beim
Start oder Neustart.)
TIPP: Die Option »-m fast« beendet Sitzungen sofort, statt auf das Beenden
durch die Sitzungen selbst zu warten.
Wenn die Option -D weggelassen wird, dann wird die Umgebungsvariable
PGDATA verwendet.
Läuft der Server?
Bitte beenden Sie den Einzelbenutzerserver und versuchen Sie es noch einmal.
Server wurde gestartet und nimmt Verbindungen an
Das Programm »%s« wird von %s benötigt, aber wurde nicht im
selben Verzeichnis wie »%s« gefunden.
Prüfen Sie Ihre Installation.
Das Programm »%s« wurde von %s gefunden,
aber es hatte nicht die gleiche Version wie %s.
Prüfen Sie Ihre Installation.
Zeitüberschreitung beim Warten auf Start des Servers
Versuchen Sie »%s --help« für weitere Informationen.
Aufruf:
WARNUNG: Online-Backup-Modus ist aktiv
Herunterfahren wird erst abgeschlossen werden, wenn pg_stop_backup() aufgerufen wird.
Warte auf Start des Servers...
kann NULL-Zeiger nicht kopieren (interner Fehler)
Kindprozess hat mit Code %d beendet Kindprozess hat mit unbekanntem Status %d beendet Kindprozess wurde durch Ausnahme 0x%X beendet Kindprozess wurde von Signal %d beendet: %s Befehl ist nicht ausführbar Befehl nicht gefunden konnte nicht in Verzeichnis »%s« wechseln: %s konnte kein »%s« zum Ausführen finden konnte aktuelles Arbeitsverzeichnis nicht ermitteln: %s
konnte aktuelles Verzeichnis nicht ermitteln: %s konnte Programmdatei »%s« nicht lesen konnte symbolische Verknüpfung »%s« nicht lesen ungültige Programmdatei »%s« Speicher aufgebraucht
pclose fehlgeschlagen: %s Server startet immer noch
Server wird befördert
Server fährt herunter
Signal an Server gesendet
Server gestartet
Server startet
Server angehalten
starte Server trotzdem
warte auf Herunterfahren des Servers... warte auf Start des Servers... locale/de/LC_MESSAGES/libpq5-9.6.mo 0000644 00000056507 14751153420 0012242 0 ustar 00 �� � l
� � �
"
8 ' F ( n � # � � � $ � 9
R 0 ] ( � ( � � � � 5 � 8 3 0 l � $ � # � - % 8 S � � . � ( � , I \ : k " � � � < � a / 0 � ) � ' � * . ? + n ' � ' � * � * + @ * l , � ) � ) � + - D / r + � ( � ) � & ! 5 H 3 ~ & � ! � � + " G v j w � r Y � ! � ' , - T � � # 9 : & t ) � * � # � 9 ) N ' x ) � � ) � " 9 5 . o ' � * � " � " ! . 7! / f! - �! @ �! 2 " ! 8" % Z" % �" & �" V �" = $# ; b# 4 �# 0 �# $ : !$ \$ |$ �$ �$ - �$ -
% ;% + W% 2 �% 7 �% = �% ! ,& . N& 8 }& " �& �& F �& C @' $ �' �' B �' ( ( ; 4( ( p( * �( & �( % �( ! ) 6 3) C j) ? �) 2 �) 1 !* = S* ) �* J �* + + 1+ N+ m+ 1 �+
�+ �+ + �+ , ) #, " M, [ p, �, ? �, 1 %- 8 W- > �- � �- # P. t. : �. � �. 2 N/ Q �/ J �/ K 0 j0 �0 �0 ? �0 ! �0 + 1 @1 Q1 L m1 D �1 % �1 . %2 C T2 �2 $ �2 5 �2 ) 3 g >3 �4 �4 �4 �4 �4 �4
�4 ) �4 * $5 O5 / m5 �5 �5 0 �5 �5 6 "6 5 ,6 4 b6 4 �6
�6 �6 �6 D �6 G +7 4 s7 ! �7 , �7 + �7
#8 18 6 B8 > y8 �8 ' �8 * �8 & #9 , J9 w9 �9 A �9 . �9 : #: > 6: x u: 6 �: 1 %; . W; > �; B �; ? < ( H< 0 q< / �< / �< 0 = / 3= 1 c= . �= . �= 0 �= 2 $> 4 W> 0 �> - �> . �> - ? ? H? @ �? > �? ( @ 1@ Q@ i@ & �@ � �@ � 7A � �A $ HB & mB ! �B ) �B 5 �B � C 7 �C F D / UD 2 �D 3 �D ) �D H E 6 _E 4 �E 0 �E & �E . #F ( RF H {F 4 �F , �F 2 &G , YG # �G = �G > �G @ 'H G hH 9 �H + �H - I * DI ( oI j �I M J P QJ 7 �J 3 �J K E .K " tK $ �K $ �K $ �K < L < CL �L 2 �L 5 �L : M = DM ( �M 5 �M ? �M ( !N $ JN G oN D �N , �N )O C HO �O ! �O < �O 3 �O 9 3P ( mP + �P ) �P C �P P 0Q L �Q 6 �Q E R L KR ( �R b �R $S ?S YS % zS �S 4 �S �S T : "T * ]T @ �T ( �T � �T uU J �U ; �U G V X ^V � �V = XW �W M �W � X 6 �X b �X Z 9Y [ �Y # �Y " Z 7Z Z LZ # �Z . �Z �Z [ V ,[ L �[ ' �[ , �[ F %\ l\ $ �\ X �\ <
] } ) � E � f * B 0 W > � H � 6 � T � a i h 2 � � + � P � ' w < � � u 7 �
� M � � ? o l X L � � � � � � � m � � { Z g n � @ � � . � � � � 3 � R S D � � c 9 N J � j G % � � z � � � & � 4 r 1 Q � | : � � I � � � b � Y # x ; ` 8
t e � � y ( � � � � � = ^ - � � � � U V ] $ " � ~ � d � � \ _ p , k � A C [ 5 K � ! � � q s O v � � / � � � F � � at character %s %s %s, %s:%s COLUMN NAME: %s
CONSTRAINT NAME: %s
CONTEXT: %s
COPY IN state must be terminated first
COPY OUT state must be terminated first
COPY terminated by new PQexec Crypt authentication not supported
DATATYPE NAME: %s
DETAIL: %s
GSSAPI authentication not supported
GSSAPI continuation error GSSAPI name import error HINT: %s
IPv6 host address may not be empty in URI: "%s"
Kerberos 4 authentication not supported
Kerberos 5 authentication not supported
LINE %d: LOCATION: NOTICE PGEventProc "%s" failed during PGEVT_CONNRESET event
PGEventProc "%s" failed during PGEVT_RESULTCREATE event
PGresult cannot support more than INT_MAX tuples PGresult is not an error result
PQexec not allowed during COPY BOTH
PQgetline: not doing text COPY OUT
QUERY: %s
SCHEMA NAME: %s
SCM_CRED authentication method not supported
SCRAM authentication requires libpq version 10 or above
SSL SYSCALL error: %s
SSL SYSCALL error: EOF detected
SSL certificate's name contains embedded null
SSL certificate's name entry is missing
SSL connection has been closed unexpectedly
SSL error code %lu SSL error: %s
SSL library does not support CRL certificates (file "%s")
SSPI authentication not supported
SSPI continuation error TABLE NAME: %s
Unix-domain socket path "%s" is too long (maximum %d bytes)
WARNING: password file "%s" has group or world access; permissions should be u=rw (0600) or less
WARNING: password file "%s" is not a plain file
WSAIoctl(SIO_KEEPALIVE_VALS) failed: %ui
another command is already in progress
argument of lo_read exceeds integer range
argument of lo_truncate exceeds integer range
argument of lo_write exceeds integer range
attribute has no values on LDAP lookup
authentication method %u not supported
cannot determine OID of function lo_close
cannot determine OID of function lo_creat
cannot determine OID of function lo_create
cannot determine OID of function lo_lseek
cannot determine OID of function lo_lseek64
cannot determine OID of function lo_open
cannot determine OID of function lo_tell
cannot determine OID of function lo_tell64
cannot determine OID of function lo_truncate
cannot determine OID of function lo_truncate64
cannot determine OID of function lo_unlink
cannot determine OID of function loread
cannot determine OID of function lowrite
certificate could not be obtained: %s
certificate does not match private key file "%s": %s
certificate present, but not private key file "%s"
column number %d is out of range 0..%d command string is a null pointer
connection in wrong state
connection not open
connection pointer is NULL
could not acquire SSPI credentials could not connect to server: %s
Is the server running locally and accepting
connections on Unix domain socket "%s"?
could not connect to server: %s
Is the server running on host "%s" (%s) and accepting
TCP/IP connections on port %s?
could not connect to server: %s
Is the server running on host "%s" and accepting
TCP/IP connections on port %s?
could not create LDAP structure
could not create SSL context: %s
could not create socket: %s
could not establish SSL connection: %s
could not get client address from socket: %s
could not get home directory to locate root certificate file
Either provide the file or change sslmode to disable server certificate verification.
could not get peer credentials: %s
could not get server's host name from server certificate
could not get socket error status: %s
could not initialize SSL engine "%s": %s
could not interpret result from server: %s could not load SSL engine "%s": %s
could not load private SSL key "%s" from engine "%s": %s
could not load private key file "%s": %s
could not look up local user ID %d: %s
could not open certificate file "%s": %s
could not open file "%s": %s
could not read certificate file "%s": %s
could not read from file "%s": %s
could not read private SSL key "%s" from engine "%s": %s
could not read root certificate file "%s": %s
could not receive data from server: %s
could not send SSL negotiation packet: %s
could not send data to server: %s
could not send startup packet: %s
could not set socket to TCP no delay mode: %s
could not set socket to close-on-exec mode: %s
could not set socket to nonblocking mode: %s
could not translate Unix-domain socket path "%s" to address: %s
could not translate host name "%s" to address: %s
could not write to file "%s": %s
definition of service "%s" not found
duplicate GSS authentication request
duplicate SSPI authentication request
end of string reached when looking for matching "]" in IPv6 host address in URI: "%s"
expected authentication request from server, but received %c
extra key/value separator "=" in URI query parameter: "%s"
forbidden value %%00 in percent-encoded value: "%s"
function requires at least protocol version 3.0
host name must be specified
host name must be specified for a verified SSL connection
incomplete multibyte character
insufficient data in "D" message insufficient data in "T" message insufficient data in "t" message integer of size %lu not supported by pqGetInt integer of size %lu not supported by pqPutInt invalid ExecStatusType code invalid LDAP URL "%s": invalid port number
invalid LDAP URL "%s": missing distinguished name
invalid LDAP URL "%s": must have exactly one attribute
invalid LDAP URL "%s": must have search scope (base/one/sub)
invalid LDAP URL "%s": no filter
invalid LDAP URL "%s": scheme must be ldap://
invalid URI propagated to internal parser routine: "%s"
invalid URI query parameter: "%s"
invalid connection option "%s"
invalid connection state %d, probably indicative of memory corruption
invalid connection state, probably indicative of memory corruption
invalid percent-encoded token: "%s"
invalid port number: "%s"
invalid setenv state %c, probably indicative of memory corruption
invalid socket
invalid sslmode value: "%s"
invalid state %c, probably indicative of memory corruption
keepalives parameter must be an integer
length must be given for binary parameter
line %d too long in service file "%s"
local user with ID %d does not exist
lookup on LDAP server failed: %s
lost synchronization with server, resetting connection lost synchronization with server: got message type "%c", length %d
message contents do not agree with length in message type "%c"
message type 0x%02x arrived from server while idle missing "=" after "%s" in connection info string
missing key/value separator "=" in URI query parameter: "%s"
more than one entry found on LDAP lookup
nested service specifications not supported in service file "%s", line %d
no COPY in progress
no SSL error reported no connection to the server
no entry found on LDAP lookup
no error message available
number of parameters must be between 0 and 65535
out of memory out of memory
out of memory allocating GSSAPI buffer (%d) out of memory for query result parameter number %d is out of range 0..%d password retrieved from file "%s"
private key file "%s" has group or world access; permissions should be u=rw (0600) or less
protocol error: id=0x%x
query to initialize large object functions did not return data
received invalid response to SSL negotiation: %c
requirepeer parameter is not supported on this platform
requirepeer specifies "%s", but actual peer user name is "%s"
root certificate file "%s" does not exist
Either provide the file or change sslmode to disable server certificate verification.
row number %d is out of range 0..%d select() failed: %s
server certificate for "%s" does not match host name "%s"
server closed the connection unexpectedly
This probably means the server terminated abnormally
before or while processing the request.
server does not support SSL, but SSL was required
server sent binary data ("B" message) without prior row description ("T" message) server sent data ("D" message) without prior row description ("T" message) server sent data ("D" message) without prior row description ("T" message)
service file "%s" not found
setsockopt(%s) failed: %s
size_t overflow sslmode value "%s" invalid when SSL support is not compiled in
statement name is a null pointer
syntax error in service file "%s", line %d
timeout expired
unexpected asyncStatus: %d
unexpected character "%c" at position %d in URI (expected ":" or "/"): "%s"
unexpected character %c following empty query response ("I" message) unexpected field count in "D" message unexpected message from server during startup
unexpected response from server; first received character was "%c"
unrecognized SSL error code: %d
unrecognized socket error: 0x%08X/%d unterminated quoted string in connection info string
user name lookup failure: error code %lu
Project-Id-Version: PostgreSQL 9.6
Report-Msgid-Bugs-To: pgsql-bugs@postgresql.org
POT-Creation-Date: 2021-05-06 22:04+0000
PO-Revision-Date: 2017-09-13 22:27-0400
Last-Translator: Peter Eisentraut <peter_e@gmx.net>
Language-Team: German <peter_e@gmx.net>
Language: de
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
bei Zeichen %s %s %s, %s:%s SPALTENNAME: %s
CONSTRAINT-NAME: %s
KONTEXT: %s
COPY-IN-Zustand muss erst beendet werden
COPY-OUT-Zustand muss erst beendet werden
COPY von neuem PQexec beendet Authentifizierung mit Crypt nicht unterstützt
DATENTYPNAME: %s
DETAIL: %s
Authentifizierung mit GSSAPI nicht unterstützt
GSSAPI-Fortsetzungsfehler GSSAPI-Namensimportfehler TIP: %s
IPv6-Hostadresse darf nicht leer sein in URI: »%s«
Authentifizierung mit Kerberos 4 nicht unterstützt
Authentifizierung mit Kerberos 5 nicht unterstützt
ZEILE %d: ORT: HINWEIS PGEventProc »%s« während PGEVT_CONNRESET-Ereignis fehlgeschlagen
PGEventProc »%s« während PGEVT_RESULTCREATE-Ereignis fehlgeschlagen
PGresult kann nicht mehr als INT_MAX Tupel enthalten PGresult ist kein Fehlerresultat
PQexec ist während COPY BOTH nicht erlaubt
PQgetline: Text COPY OUT nicht ausgeführt
ANFRAGE: %s
SCHEMANAME: %s
SCM_CRED-Authentifizierungsmethode nicht unterstützt
SCRAM-Authentifizierung benötigt libpq Version 10 oder neuer
SSL-SYSCALL-Fehler: %s
SSL-SYSCALL-Fehler: Dateiende entdeckt
Name im SSL-Zertifikat enthält Null-Byte
Namenseintrag fehlt im SSL-Zertifikat
SSL-Verbindung wurde unerwartet geschlossen
SSL-Fehlercode %lu SSL-Fehler: %s
SSL-Bibliothek unterstützt keine CRL-Zertifikate (Datei »%s«)
Authentifizierung mit SSPI nicht unterstützt
SSPI-Fortsetzungsfehler TABELLENNAME: %s
Unix-Domain-Socket-Pfad »%s« ist zu lang (maximal %d Bytes)
WARNUNG: Passwortdatei »%s« erlaubt Lesezugriff für Gruppe oder Andere; Rechte sollten u=rw (0600) oder weniger sein
WARNUNG: Passwortdatei »%s« ist keine normale Datei
WSAIoctl(SIO_KEEPALIVE_VALS) fehlgeschlagen: %ui
ein anderer Befehl ist bereits in Ausführung
Argument von lo_read überschreitet Bereich für ganze Zahlen
Argument von lo_truncate überschreitet Bereich für ganze Zahlen
Argument von lo_write überschreitet Bereich für ganze Zahlen
Attribut hat keine Werte bei LDAP-Suche
Authentifizierungsmethode %u nicht unterstützt
kann OID der Funktion lo_close nicht ermitteln
kann OID der Funktion lo_creat nicht ermitteln
kann OID der Funktion lo_create nicht ermitteln
kann OID der Funktion lo_lseek nicht ermitteln
kann OID der Funktion lo_lseek64 nicht ermitteln
kann OID der Funktion lo_open nicht ermitteln
kann OID der Funktion lo_tell nicht ermitteln
kann OID der Funktion lo_tell64 nicht ermitteln
kann OID der Funktion lo_truncate nicht ermitteln
kann OID der Funktion lo_truncate64 nicht ermitteln
kann OID der Funktion lo_unlink nicht ermitteln
kann OID der Funktion loread nicht ermitteln
kann OID der Funktion lowrite nicht ermitteln
Zertifikat konnte nicht ermittelt werden: %s
Zertifikat passt nicht zur privaten Schlüsseldatei »%s«: %s
Zertifikat vorhanden, aber keine private Schlüsseldatei »%s«
Spaltennummer %d ist außerhalb des zulässigen Bereichs 0..%d Befehlszeichenkette ist ein NULL-Zeiger
Verbindung im falschen Zustand
Verbindung nicht offen
Verbindung ist ein NULL-Zeiger
konnte SSPI-Credentials nicht erhalten konnte nicht mit dem Server verbinden: %s
Läuft der Server lokal und akzeptiert er Verbindungen
auf dem Unix-Domain-Socket »%s«?
konnte nicht mit dem Server verbinden: %s
Läuft der Server auf dem Host »%s« (%s) und akzeptiert er
TCP/IP-Verbindungen auf Port %s?
konnte nicht mit dem Server verbinden: %s
Läuft der Server auf dem Host »%s« und akzeptiert er
TCP/IP-Verbindungen auf Port %s?
konnte LDAP-Struktur nicht erzeugen
konnte SSL-Kontext nicht erzeugen: %s
konnte Socket nicht erzeugen: %s
konnte SSL-Verbindung nicht aufbauen: %s
konnte Client-Adresse vom Socket nicht ermitteln: %s
konnte Home-Verzeichnis nicht ermitteln, um Root-Zertifikat-Datei zu finden
Legen Sie entweder die Datei an oder ändern Sie sslmode, um die Überprüfung der Serverzertifikate abzuschalten.
konnte Credentials von Gegenstelle nicht ermitteln: %s
konnte Hostnamen des Servers nicht aus dem Serverzertifikat ermitteln
konnte Socket-Fehlerstatus nicht ermitteln: %s
konnte SSL-Engine »%s« nicht initialisieren: %s
konnte Ergebnis vom Server nicht interpretieren: %s konnte SSL-Engine »%s« nicht laden: %s
konnte privaten SSL-Schlüssel »%s« nicht von Engine »%s« laden: %s
konnte private Schlüsseldatei »%s« nicht laden: %s
konnte lokale Benutzer-ID %d nicht nachschlagen: %s
konnte Zertifikatdatei »%s« nicht öffnen: %s
konnte Datei »%s« nicht öffnen: %s
konnte Zertifikatdatei »%s« nicht lesen: %s
konnte nicht aus Datei »%s« lesen: %s
konnte privaten SSL-Schlüssel »%s« nicht von Engine »%s« lesen: %s
konnte Root-Zertifikat-Datei »%s« nicht lesen: %s
konnte keine Daten vom Server empfangen: %s
konnte Paket zur SSL-Verhandlung nicht senden: %s
konnte keine Daten an den Server senden: %s
konnte Startpaket nicht senden: %s
konnte Socket nicht auf TCP »No Delay«-Modus umstellen: %s
konnte Socket nicht auf »Close on exec«-Modus umstellen: %s
konnte Socket nicht auf nicht-blockierenden Modus umstellen: %s
konnte Unix-Domain-Socket-Pfad »%s« nicht in Adresse übersetzen: %s
konnte Hostnamen »%s« nicht in Adresse übersetzen: %s
konnte nicht in Datei »%s« schreiben: %s
Definition von Service »%s« nicht gefunden
doppelte GSSAPI-Authentifizierungsanfrage
doppelte SSPI-Authentifizierungsanfrage
Ende der Eingabezeichenkette gefunden beim Suchen nach passendem »]« in IPv6-Hostadresse in URI: »%s«
Authentifizierungsanfrage wurde vom Server erwartet, aber %c wurde empfangen
zusätzliches Schlüssel/Wert-Trennzeichen »=« in URI-Query-Parameter: »%s«
verbotener Wert %%00 in Prozent-kodiertem Wert: »%s«
Funktion erfordert mindestens Protokollversion 3.0
Hostname muss angegeben werden
Hostname muss angegeben werden für eine verifizierte SSL-Verbindung
unvollständiges Mehrbyte-Zeichen
nicht genug Daten in »D«-Nachricht nicht genug Daten in »T«-Nachricht nicht genug Daten in »t«-Nachricht Integer der Größe %lu wird von pqGetInt nicht unterstützt Integer der Größe %lu wird von pqPutInt nicht unterstützt ungültiger ExecStatusType-Kode ungültige LDAP-URL »%s«: ungültige Portnummer
ungültige LDAP-URL »%s«: Distinguished Name fehlt
ungültige LDAP-URL »%s«: muss genau ein Attribut haben
ungültige LDAP-URL »%s«: Suchbereich fehlt (base/one/sub)
ungültige LDAP-URL »%s«: kein Filter
ungültige LDAP-URL »%s«: Schema muss ldap:// sein
ungültige URI an interne Parserroutine weitergeleitet: »%s«
ungültiger URI-Query-Parameter: »%s«
ungültige Verbindungsoption »%s«
ungültiger Verbindungszustand %d, möglicherweise ein Speicherproblem
ungültiger Verbindungszustand, möglicherweise ein Speicherproblem
ungültiges Prozent-kodiertes Token: »%s«
ungültige Portnummer: »%s«
ungültiger Setenv-Zustand %c, möglicherweise ein Speicherproblem
ungültiges Socket
ungültiger sslmode-Wert: »%s«
ungültiger Zustand %c, möglicherweise ein Speicherproblem
Parameter »keepalives« muss eine ganze Zahl sein
für binäre Parameter muss eine Länge angegeben werden
Zeile %d zu lang in Servicedatei »%s«
lokaler Benutzer mit ID %d existiert nicht
Suche auf LDAP-Server fehlgeschlagen: %s
Synchronisation mit Server verloren, Verbindung wird zurückgesetzt Synchronisation mit Server verloren: Nachrichtentyp »%c« empfangen, Länge %d
Nachrichteninhalt stimmt nicht mit Länge in Nachrichtentyp »%c« überein
Nachricht vom Typ 0x%02x kam vom Server im Ruhezustand fehlendes »=« nach »%s« in der Zeichenkette der Verbindungsdaten
fehlendes Schlüssel/Wert-Trennzeichen »=« in URI-Query-Parameter: »%s«
LDAP-Suche ergab mehr als einen Eintrag
geschachtelte »service«-Definitionen werden nicht unterstützt in Servicedatei »%s«, Zeile %d
keine COPY in Ausführung
kein SSL-Fehler berichtet keine Verbindung mit dem Server
kein Eintrag gefunden bei LDAP-Suche
keine Fehlermeldung verfügbar
Anzahl der Parameter muss zwischen 0 und 65535 sein
Speicher aufgebraucht Speicher aufgebraucht
Speicher aufgebraucht beim Anlegen des GSSAPI-Puffers (%d) Speicher für Anfrageergebnis aufgebraucht Parameternummer %d ist außerhalb des zulässigen Bereichs 0..%d Passwort wurde aus Datei »%s« gelesen
WARNUNG: private Schlüsseldatei »%s« erlaubt Lesezugriff für Gruppe oder Andere; Rechte sollten u=rw (0600) oder weniger sein
Protokollfehler: id=0x%x
Abfrage zur Initialisierung der Large-Object-Funktionen ergab keine Daten
ungültige Antwort auf SSL-Verhandlungspaket empfangen: %c
Parameter »requirepeer« wird auf dieser Plattform nicht unterstützt
requirepeer gibt »%s« an, aber tatsächlicher Benutzername der Gegenstelle ist »%s«
Root-Zertifikat-Datei »%s« existiert nicht
Legen Sie entweder die Datei an oder ändern Sie sslmode, um die Überprüfung der Serverzertifikate abzuschalten.
Zeilennummer %d ist außerhalb des zulässigen Bereichs 0..%d select() fehlgeschlagen: %s
Server-Zertifikat für »%s« stimmt nicht mit dem Hostnamen »%s« überein
Server beendete die Verbindung unerwartet
Das heißt wahrscheinlich, dass der Server abnormal beendete
bevor oder während die Anweisung bearbeitet wurde.
Server unterstützt kein SSL, aber SSL wurde verlangt
Server sendete binäre Daten (»B«-Nachricht) ohne vorherige Zeilenbeschreibung (»T«-Nachricht) Server sendete Daten (»D«-Nachricht) ohne vorherige Zeilenbeschreibung (»T«-Nachricht) Server sendete Daten (»D«-Nachricht) ohne vorherige Zeilenbeschreibung (»T«-Nachricht)
Servicedatei »%s« nicht gefunden
setsockopt(%s) fehlgeschlagen: %s
Überlauf von size_t sslmode-Wert »%s« ist ungültig, wenn SSL-Unterstützung nicht einkompiliert worden ist
Anweisungsname ist ein NULL-Zeiger
Syntaxfehler in Servicedatei »%s«, Zeile %d
Timeout abgelaufen
unerwarteter asyncStatus: %d
unerwartetes Zeichen »%c« an Position %d in URI (»:« oder »/« erwartet): »%s«
unerwartetes Zeichen %c kam nach Antwort auf leere Anfrage (»I«-Nachricht) unerwartete Feldzahl in »D«-Nachricht unerwartete Nachricht vom Server beim Start
unerwartete Antwort vom Server; erstes empfangenes Zeichen war »%c«
unbekannter SSL-Fehlercode: %d
unbekannter Socket-Fehler: 0x%08X/%d fehlendes schließendes Anführungszeichen (") in der Zeichenkette der Verbindungsdaten
Fehler beim Nachschlagen des Benutzernamens: Fehlercode %lu
locale/de/LC_MESSAGES/pg_config-9.6.mo 0000644 00000014161 14751153420 0012767 0 ustar 00 �� * l ; � � E � 0 � : 3 E n I � L � s K K � = B I i � G � J > M � M � ? % G e > � 6 � < # > ` F � P � I 7
4 �
2 �
* �
. , 8 & e � & � � ( � ! B V c q u G �
@ / p M � G � K N e t � M ) I w N � { m � L � O G O � N � I 6 J � D � < R M m � { v � 1 ; 3 - o �
� 5 � 8 � 5 / > ( n 0 � ' � 2 � # C W % * ) $
" '
& ( ! #
%s provides information about the installed version of PostgreSQL.
With no arguments, all known items are shown.
%s [OPTION]...
--bindir show location of user executables
--cc show CC value used when PostgreSQL was built
--cflags show CFLAGS value used when PostgreSQL was built
--cflags_sl show CFLAGS_SL value used when PostgreSQL was built
--configure show options given to "configure" script when
PostgreSQL was built
--cppflags show CPPFLAGS value used when PostgreSQL was built
--docdir show location of documentation files
--htmldir show location of HTML documentation files
--includedir show location of C header files of the client
interfaces
--includedir-server show location of C header files for the server
--ldflags show LDFLAGS value used when PostgreSQL was built
--ldflags_ex show LDFLAGS_EX value used when PostgreSQL was built
--ldflags_sl show LDFLAGS_SL value used when PostgreSQL was built
--libdir show location of object code libraries
--libs show LIBS value used when PostgreSQL was built
--localedir show location of locale support files
--mandir show location of manual pages
--pgxs show location of extension makefile
--pkgincludedir show location of other C header files
--pkglibdir show location of dynamically loadable modules
--sharedir show location of architecture-independent support files
--sysconfdir show location of system-wide configuration files
--version show the PostgreSQL version
-?, --help show this help, then exit
%s: could not find own program executable
%s: invalid argument: %s
Options:
Report bugs to <pgsql-bugs@postgresql.org>.
Try "%s --help" for more information.
Usage:
could not change directory to "%s": %s could not find a "%s" to execute could not identify current directory: %s could not read binary "%s" could not read symbolic link "%s" invalid binary "%s" not recorded pclose failed: %s Project-Id-Version: PostgreSQL 9.6
Report-Msgid-Bugs-To: pgsql-bugs@postgresql.org
POT-Creation-Date: 2016-04-25 01:14+0000
PO-Revision-Date: 2016-04-24 22:47-0400
Last-Translator: Peter Eisentraut <peter_e@gmx.net>
Language-Team: Peter Eisentraut <peter_e@gmx.net>
Language: de
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
%s gibt Informationen über die installierte Version von PostgreSQL.
Ohne Argumente werden alle bekannten Informationen angezeigt.
%s [OPTION]...
--bindir zeige Installationsverzeichnis der Benutzerprogramme
--cc zeige CC-Wert, mit dem PostgreSQL gebaut wurde
--cflags zeige CFLAGS-Wert, mit dem PostgreSQL gebaut wurde
--cflags_sl zeige CFLAGS_SL-Wert, mit dem PostgreSQL gebaut wurde
--configure zeige Optionen des »configure«-Skriptes beim Bauen
von PostgreSQL
--cppflags zeige CPPFLAGS-Wert, mit dem PostgreSQL gebaut wurde
--docdir zeige Installationsverzeichnis der Dokumentation
--htmldir zeige Installationsverzeichnis der HTML-Dokumentation
--includedir zeige Installationsverzeichnis der Headerdateien der
Client-Schnittstellen
--includedir-server zeige Installationsverzeichnis der Headerdateien des
Servers
--ldflags zeige LDFLAGS-Wert, mit dem PostgreSQL gebaut wurde
--ldflags_ex zeige LDFLAGS_EX-Wert, mit dem PostgreSQL gebaut wurde
--ldflags_sl zeige LDFLAGS_SL-Wert, mit dem PostgreSQL gebaut wurde
--libdir zeige Installationsverzeichnis der Objektbibliotheken
--libs zeige LIBS-Wert, mit dem PostgreSQL gebaut wurde
--localedir zeige Installationsverzeichnis der Locale-Dateien
--mandir zeige Installationsverzeichnis der Manpages
--pgxs zeige Ort der Erweiterungs-Makefile
--pkgincludedir zeige Installationsverzeichnis von weiteren Headerdateien
--pkglibdir zeige Installationsverzeichnis der dynamisch
ladbaren Module
--sharedir zeige Installationsverzeichnis der architektur-
unabhängigen Datendateien
--sysconfdir zeige Installationsverzeichnis der systemweiten
Konfigurationsdateien
--version zeige PostgreSQL-Version
-?, --help diese Hilfe anzeigen, dann beenden
%s: konnte eigene Programmdatei nicht finden
%s: ungültiges Argument: %s
Optionen:
Berichten Sie Fehler an <pgsql-bugs@postgresql.org>.
Versuchen Sie »%s --help« für weitere Informationen.
Aufruf:
konnte nicht in Verzeichnis »%s« wechseln: %s konnte kein »%s« zum Ausführen finden konnte aktuelles Verzeichnis nicht ermitteln: %s konnte Programmdatei »%s« nicht lesen konnte symbolische Verknüpfung »%s« nicht lesen ungültige Programmdatei »%s« nicht aufgezeichnet pclose fehlgeschlagen: %s locale/de/LC_MESSAGES/pgscripts-9.6.mo 0000644 00000065336 14751153420 0013064 0 ustar 00 �� � � � @ K A �
� > � > � = , - j � � C 0 A t � � # � ( I I f E � � > v ; � = � : / < j 9 � 6 � 5 C N C � 9 � 4 E E = � . � ; � E 4 : z ? � A � < 7 9 t 7 � 4 � L J h 3 � H � E 0 B v A � 5 � 2 1 N d 7 � 2 � 2 J Q : � 5 � G
0 U < � 0 � ) � M J l G � 4 � C 4! H x! E �! D " = L" v �" < # � ># Q �# I $ @ ^$ 5 �$ 4 �$ 1
% 0 <% ; m% 5 �% ' �% 6 & 3 >& 9 r& @ �& ; �& ; )' ` e' 8 �' 2 �' 9 2( 6 l( > �( �( / �( < ) # [) # ) ? �) 8 �) % * # B* f* 3 �* & �* �* E �* 6 .+ E e+ F �+ K �+ 7 >, K v, 7 �, J �, 6 E- < |- D �- 5 �- 4. * R. 8 }. 6 �. ( �. 4 / $ K/ # p/ �/ �/ - �/ 8 0 4 <0 $ q0 �0 , �0 , �0 ( 1 / 91 ; i1 9 �1 ! �1 2 \ 2 s2 �2 * �2 8 �2 9 3 , B3 8 o3 # �3 4 �3 . 4 04 ) M4 7 w4 �4
�4 �4 C �4 A +5 ! m5 + �5 �5 �5 �5 6 . #6 3 R6 2 �6 �6 �6 �6
�6 �6 7 )7 ' >7 " f7 2 �7 7 �7 �7 & �7 $8 ,8 / C8 + s8 * �8 �8 �8 �8 �8 �8 �8 9 9 ( +9 T9 V9 � Z9 l �: Z; q; V }; V �; S +< 6 < � �< I �= G �= > .> " G> j> ) �> �> R �> Q !? � s? = �? : ;@ C v@ = �@ E �@ B >A ? �A > �A S B A TB < �B D �B M C 9 fC ; �C J �C @ 'D B hD N �D G �D D BE @ �E 5 �E 2 �E � 1F � �F 1 JG O |G L �G I H H cH 7 �H 4 �H � I I �I 6 �I : J XJ A �J H K m cK 4 �K n L 8 uL ) �L y �L s RM m �M = 4N B rN Q �N N O M VO ? �O � �O I mP � �P y PQ L �Q G R F _R 9 �R 6 �R 5 S A MS ; �S , �S < �S 1 5T < gT q �T > U B UU X �U : �U 4 ,V < aV 9 �V O �V (W 7 4W C lW ' �W ( �W H X I JX + �X ' �X # �X : Y - GY uY I |Y B �Y M Z M WZ M �Z B �Z N 6[ C �[ Q �[ F \ L b\ I �\ B �\ <] 4 [] F �] L �] / $^ C T^ , �^ / �^ 1 �^ - '_ 1 U_ ? �_ = �_ / ` + 5` % a` $ �` " �` 2 �` F a D Ia # �a �a \ �a .b ! Cb 8 eb H �b J �b 6 2c J ic 0 �c < �c ; "d * ^d 2 �d D �d e e 0e V Ne Y �e + �e 7 +f cf ) �f 2 �f , �f $ g 2 1g 0 dg
�g �g - �g
�g % �g ( h 0h 3 Eh ' yh 1 �h 9 �h
i 8 i Pi Yi 2 yi 7 �i / �i j j j 4j Cj Zj
yj �j ; �j �j �j � Z 9 � � t � � � I S � w & % � � � � G � � - . � � X � { � " � 7 � o � � < � � � L � 4 / K i u � J � ~ B m � ( � � * �
n f H p � # D g @ ' > � � U � v � x [ � 3
N � � k ! � 8 , � Y F ; � � z � � � T � � 6 r M � + a 2 W � � $ ] _ � � } = s � j � � ? � ` � c | � l \ V � � � � � E ) : q � � Q C b 1 0 h A y � d R � ^ O � � � � � � � 5 � � � e P
By default, a database with the same name as the current user is created.
Connection options:
Options:
Read the description of the SQL command CLUSTER for details.
Read the description of the SQL command REINDEX for details.
Read the description of the SQL command VACUUM for details.
Report bugs to <pgsql-bugs@postgresql.org>.
--analyze-in-stages only update optimizer statistics, in multiple
stages for faster results; no vacuum
--lc-collate=LOCALE LC_COLLATE setting for the database
--lc-ctype=LOCALE LC_CTYPE setting for the database
%s [OPTION]...
%s [OPTION]... DBNAME
%s [OPTION]... LANGNAME [DBNAME]
%s [OPTION]... [DBNAME]
%s [OPTION]... [DBNAME] [DESCRIPTION]
%s [OPTION]... [ROLENAME]
--if-exists don't report error if database doesn't exist
--if-exists don't report error if user doesn't exist
--interactive prompt for missing role name and attributes rather
than using defaults
--maintenance-db=DBNAME alternate maintenance database
--maintenance-db=DBNAME alternate maintenance database
--no-replication role cannot initiate replication
--replication role can initiate replication
-?, --help show this help, then exit
-?, --help show this help, then exit
-?, --help show this help, then exit
-?, --help show this help, then exit
-D, --no-createdb role cannot create databases (default)
-D, --tablespace=TABLESPACE default tablespace for the database
-E, --encoding=ENCODING encoding for the database
-E, --encrypted encrypt stored password
-F, --freeze freeze row transaction information
-I, --no-inherit role does not inherit privileges
-L, --no-login role cannot login
-N, --unencrypted do not encrypt stored password
-O, --owner=OWNER database user to own the new database
-P, --pwprompt assign a password to new role
-R, --no-createrole role cannot create roles (default)
-S, --no-superuser role will not be superuser (default)
-S, --schema=SCHEMA reindex specific schema(s) only
-T, --template=TEMPLATE template database to copy
-U, --username=USERNAME user name to connect as
-U, --username=USERNAME user name to connect as
-U, --username=USERNAME user name to connect as (not the one to create)
-U, --username=USERNAME user name to connect as (not the one to drop)
-U, --username=USERNAME user name to connect as
-V, --version output version information, then exit
-V, --version output version information, then exit
-V, --version output version information, then exit
-V, --version output version information, then exit
-W, --password force password prompt
-W, --password force password prompt
-Z, --analyze-only only update optimizer statistics; no vacuum
-a, --all vacuum all databases
-a, --all cluster all databases
-a, --all reindex all databases
-c, --connection-limit=N connection limit for role (default: no limit)
-d, --createdb role can create new databases
-d, --dbname=DBNAME database to vacuum
-d, --dbname=DBNAME database from which to remove the language
-d, --dbname=DBNAME database to cluster
-d, --dbname=DBNAME database to install language in
-d, --dbname=DBNAME database to reindex
-d, --dbname=DBNAME database name
-e, --echo show the commands being sent to the server
-e, --echo show the commands being sent to the server
-e, --echo show the commands being sent to the server
-f, --full do full vacuuming
-g, --role=ROLE new role will be a member of this role
-h, --host=HOSTNAME database server host or socket directory
-h, --host=HOSTNAME database server host or socket directory
-h, --host=HOSTNAME database server host or socket directory
-i, --index=INDEX recreate specific index(es) only
-i, --inherit role inherits privileges of roles it is a
member of (default)
-i, --interactive prompt before deleting anything
-i, --interactive prompt before deleting anything, and prompt for
role name if not specified
-j, --jobs=NUM use this many concurrent connections to vacuum
-l, --list show a list of currently installed languages
-l, --locale=LOCALE locale settings for the database
-l, --login role can login (default)
-p, --port=PORT database server port
-p, --port=PORT database server port
-p, --port=PORT database server port
-q, --quiet don't write any messages
-q, --quiet don't write any messages
-q, --quiet run quietly
-r, --createrole role can create new roles
-s, --superuser role will be superuser
-s, --system reindex system catalogs only
-t, --table='TABLE[(COLUMNS)]' vacuum specific table(s) only
-t, --table=TABLE cluster specific table(s) only
-t, --table=TABLE reindex specific table(s) only
-t, --timeout=SECS seconds to wait when attempting connection, 0 disables (default: %s)
-v, --verbose write a lot of output
-v, --verbose write a lot of output
-w, --no-password never prompt for password
-w, --no-password never prompt for password
-z, --analyze update optimizer statistics
%s (%s/%s) %s cleans and analyzes a PostgreSQL database.
%s clusters all previously clustered tables in a database.
%s creates a PostgreSQL database.
%s creates a new PostgreSQL role.
%s installs a procedural language into a PostgreSQL database.
%s issues a connection check to a PostgreSQL database.
%s reindexes a PostgreSQL database.
%s removes a PostgreSQL database.
%s removes a PostgreSQL role.
%s removes a procedural language from a database.
%s: "%s" is not a valid encoding name
%s: %s %s: cannot cluster all databases and a specific one at the same time
%s: cannot cluster specific table(s) in all databases
%s: cannot reindex all databases and a specific one at the same time
%s: cannot reindex all databases and system catalogs at the same time
%s: cannot reindex specific index(es) and system catalogs at the same time
%s: cannot reindex specific index(es) in all databases
%s: cannot reindex specific schema(s) and system catalogs at the same time
%s: cannot reindex specific schema(s) in all databases
%s: cannot reindex specific table(s) and system catalogs at the same time
%s: cannot reindex specific table(s) in all databases
%s: cannot use the "%s" option when performing only analyze
%s: cannot vacuum all databases and a specific one at the same time
%s: cannot vacuum specific table(s) in all databases
%s: clustering database "%s"
%s: clustering of database "%s" failed: %s %s: clustering of table "%s" in database "%s" failed: %s %s: comment creation failed (database was created): %s %s: could not connect to database %s: %s %s: could not connect to database %s: out of memory
%s: could not fetch default options
%s: creation of new role failed: %s %s: database creation failed: %s %s: database removal failed: %s %s: invalid value for --connection-limit: %s
%s: language "%s" is already installed in database "%s"
%s: language "%s" is not installed in database "%s"
%s: language installation failed: %s %s: language removal failed: %s %s: missing required argument database name
%s: missing required argument language name
%s: missing required argument role name
%s: number of parallel jobs must be at least 1
%s: only one of --locale and --lc-collate can be specified
%s: only one of --locale and --lc-ctype can be specified
%s: processing database "%s": %s
%s: query failed: %s %s: query returned %d row instead of one: %s
%s: query returned %d rows instead of one: %s
%s: query was: %s
%s: reindexing database "%s"
%s: reindexing of database "%s" failed: %s %s: reindexing of index "%s" in database "%s" failed: %s %s: reindexing of schema "%s" in database "%s" failed: %s %s: reindexing of system catalogs failed: %s %s: reindexing of table "%s" in database "%s" failed: %s %s: removal of role "%s" failed: %s %s: too many command-line arguments (first is "%s")
%s: too many jobs for this platform -- try %d
%s: vacuuming database "%s"
%s: vacuuming of database "%s" failed: %s %s: vacuuming of table "%s" in database "%s" failed: %s (%lu row) (%lu rows) Are you sure? Cancel request sent
Cannot add cell to table content: total cell count of %d exceeded.
Cannot add header to table content: column count of %d exceeded.
Could not send cancel request: %s Database "%s" will be permanently removed.
Enter it again: Enter name of role to add: Enter name of role to drop: Enter password for new role: Generating default (full) optimizer statistics Generating medium optimizer statistics (10 targets) Generating minimal optimizer statistics (1 target) Interrupted
Name Password encryption failed.
Password: Passwords didn't match.
Please answer "%s" or "%s".
Procedural Languages Role "%s" will be permanently removed.
Shall the new role be a superuser? Shall the new role be allowed to create databases? Shall the new role be allowed to create more new roles? Trusted? Try "%s --help" for more information.
Usage:
accepting connections
cannot duplicate null pointer (internal error)
could not look up effective user ID %ld: %s invalid output format (internal error): %d n no no attempt
no response
out of memory
rejecting connections
unknown
user does not exist user name lookup failure: error code %lu y yes Project-Id-Version: PostgreSQL 9.6
Report-Msgid-Bugs-To: pgsql-bugs@postgresql.org
POT-Creation-Date: 2021-11-06 17:05+0000
PO-Revision-Date: 2019-05-14 15:50+0200
Last-Translator: Peter Eisentraut <peter_e@gmx.net>
Language-Team: German <peter_e@gmx.net>
Language: de
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Plural-Forms: nplurals=2; plural=(n != 1);
Wenn nichts anderes angegeben ist, dann wird eine Datenbank mit dem Namen
des aktuellen Benutzers erzeugt.
Verbindungsoptionen:
Optionen:
Für weitere Informationen lesen Sie bitte die Beschreibung des
SQL-Befehls CLUSTER.
Für weitere Informationen lesen Sie bitte die Beschreibung des
SQL-Befehls REINDEX.
Für weitere Information lesen Sie bitte die Beschreibung des
SQL-Befehls VACUUM.
Berichten Sie Fehler an <pgsql-bugs@postgresql.org>.
--analyze-in-stages aktualisiere nur Statistiken für den Optimierer,
in mehreren Phasen für schnellere Ergebnisse;
kein Vacuum
--lc-collate=LOCALE LC_COLLATE-Einstellung für die Datenbank
--lc-ctype=LOCALE LC_CTYPE-Einstellung für die Datenbank
%s [OPTION]...
%s [OPTION]... DBNAME
%s [OPTION]... SPRACHE [DBNAME]
%s [OPTION]... [DBNAME]
%s [OPTION]... [DBNAME] [BESCHREIBUNG]
%s [OPTION]... [ROLLENNAME]
--if-exists keinen Fehler ausgeben, wenn Datenbank nicht existiert
--if-exists keinen Fehler ausgeben, wenn Benutzer nicht existiert
--interactive nach fehlenden Rollennamen und -attributen fragen
anstatt Vorgabewerte zu nehmen
--maintenance-db=DBNAME alternative Wartungsdatenbank
--maintenance-db=DBNAME alternative Wartungsdatenbank
--no-replication Rolle kann Replikation nicht einleiten
--replication Rolle kann Replikation einleiten
-?, --help diese Hilfe anzeigen, dann beenden
-?, --help diese Hilfe anzeigen, dann beenden
-?, --help diese Hilfe anzeigen, dann beenden
-?, --help diese Hilfe anzeigen, dann beenden
-D, --no-createdb Rolle kann keine Datenbanken erzeugen (Voreinstellung)
-D, --tablespace=TABLESPACE Standard-Tablespace der Datenbank
-E, --encoding=KODIERUNG Kodierung für die Datenbank
-E, --encrypted verschlüssle das gespeicherte Passwort
-F, --freeze Zeilentransaktionsinformationen einfrieren
-I, --no-inherit Rolle erbt keine Privilegien
-L, --no-login Rolle kann sich nicht anmelden
-N, --unencrypted verschlüssle das gespeicherte Passwort nicht
-O, --owner=EIGENTÜMER Eigentümer der neuen Datenbank
-P, --pwprompt weise der neuen Rolle ein Passwort zu
-R, --no-createrole Rolle kann keine Rollen erzeugen (Voreinstellung)
-S, --no-superuser Rolle wird kein Superuser (Voreinstellung)
-S, --schema=SCHEMA nur bestimmte(s) Schema(s) reindizieren
-T, --template=TEMPLATE zu kopierende Template-Datenbank
-U, --username=NAME Datenbankbenutzername
-U, --username=NAME Datenbankbenutzername
-U, --username=NAME Datenbankbenutzername für die Verbindung
(nicht der Name des neuen Benutzers)
-U, --username=NAME Datenbankbenutzername für die Verbindung
(nicht der Name des zu löschenden Benutzers)
-U, --username=NAME Datenbankbenutzername
-V, --version Versionsinformationen anzeigen, dann beenden
-V, --version Versionsinformationen anzeigen, dann beenden
-V, --version Versionsinformationen anzeigen, dann beenden
-V, --version Versionsinformationen anzeigen, dann beenden
-W, --password Passwortfrage erzwingen
-W, --password Passwortfrage erzwingen
-Z, --analyze-only aktualisiere nur Statistiken für den Optimierer;
kein Vacuum
-a, --all führe Vacuum in allen Datenbanken aus
-a, --all clustere alle Datenbanken
-a, --all alle Datenbanken reindizieren
-c, --connection-limit=N Hochzahl an Verbindungen für Rolle
(Voreinstellung: keine Begrenzung)
-d, --createdb Rolle kann neue Datenbanken erzeugen
-d, --dbname=DBNAME führe Vacuum in dieser Datenbank aus
-d, --dbname=DBNAME Datenbank, aus der die Sprache gelöscht
werden soll
-d, --dbname=DBNAME zu clusternde Datenbank
-d, --dbname=DBNAME Datenbank, in der die Sprache installiert
werden soll
-d, --dbname=DBNAME zu reindizierende Datenbank
-d, --dbname=DBNAME Datenbankname
-e, --echo zeige die Befehle, die an den Server
gesendet werden
-e, --echo zeige die Befehle, die an den Server
gesendet werden
-e, --echo zeige die Befehle, die an den Server
gesendet werden
-f, --full führe volles Vacuum durch
-g, --role=ROLLE neue Rolle wird Mitglied dieser Rolle
-h, --host=HOSTNAME Name des Datenbankservers oder Socket-Verzeichnis
-h, --host=HOSTNAME Name des Datenbankservers oder Socket-Verzeichnis
-h, --host=HOSTNAME Name des Datenbankservers oder Socket-Verzeichnis
-i, --index=INDEX nur bestimmte(n) Index(e) erneuern
-i, --inherit Rolle erbt alle Privilegien von Rollen, deren
Mitglied sie ist (Voreinstellung)
-i, --interactive frage nach, bevor irgendetwas gelöscht wird
-i, --interactive nachfragen, bevor irgendetwas gelöscht wird, und
nach Rollennamen fragen, wenn nicht angegeben
-j, --jobs=NUM so viele parallele Verbindungen zum Vacuum
verwenden
-l, --list zeige Liste gegenwärtig installierter Sprachen
-l, --locale=LOCALE Lokale-Einstellungen für die Datenbank
-l, --login Rolle kann sich anmelden (Voreinstellung)
-p, --port=PORT Port des Datenbankservers
-p, --port=PORT Port des Datenbankservers
-p, --port=PORT Port des Datenbankservers
-q, --quiet unterdrücke alle Mitteilungen
-q, --quiet unterdrücke alle Mitteilungen
-q, --quiet weniger ausgeben
-r, --createrole Rolle kann neue Rollen erzeugen
-s, --superuser Rolle wird Superuser
-s, --system nur Systemkataloge reindizieren
-t, --table='TABELLE[(SPALTEN)]'
führe Vacuum für bestimmte Tabelle(n) aus
-t, --table=TABELLE clustere nur bestimmte Tabelle(n)
-t, --table=TABELLE nur bestimmte Tabelle(n) reindizieren
-t, --timeout=SEK Sekunden auf Verbindung warten, 0 schaltet aus (Vorgabe: %s)
-v, --verbose erzeuge viele Meldungen
-v, --verbose erzeuge viele Meldungen
-w, --no-password niemals nach Passwort fragen
-w, --no-password niemals nach Passwort fragen
-z, --analyze aktualisiere Statistiken für den Optimierer
%s (%s/%s) %s säubert und analysiert eine PostgreSQL-Datenbank.
%s clustert alle vorher geclusterten Tabellen in einer Datenbank.
%s erzeugt eine PostgreSQL-Datenbank.
%s erzeugt eine neue PostgreSQL-Rolle.
%s installiert eine prozedurale Sprache in einer PostgreSQL-Datenbank.
%s führt eine Verbindungsprüfung gegen eine PostgreSQL-Datenbank aus.
%s reindiziert eine PostgreSQL-Datenbank.
%s löscht eine PostgreSQL-Datenbank.
%s löscht eine PostgreSQL-Rolle.
%s löscht eine prozedurale Sprache aus einer Datenbank.
%s: »%s« ist kein gültiger Kodierungsname
%s: %s %s: kann nicht alle Datenbanken und eine bestimmte gleichzeitig clustern
%s: kann nicht bestimmte Tabelle(n) in allen Datenbanken clustern
%s: kann nicht alle Datenbanken und eine bestimmte gleichzeitig reindizieren
%s: kann nicht alle Datenbanken und Systemkataloge gleichzeitig reindizieren
%s: kann nicht bestimmte Indexe und Systemkataloge gleichzeitig reindizieren
%s: kann nicht bestimmte Indexe in allen Datenbanken reindizieren
%s: kann nicht bestimmte Schemas und Systemkataloge gleichzeitig reindizieren
%s: kann nicht bestimmte Schemas in allen Datenbanken reindizieren
%s: kann nicht bestimmte Tabelle(n) und Systemkataloge gleichzeitig reindizieren
%s: kann nicht bestimmte Tabelle(n) in allen Datenbanken reindizieren
%s: kann Option »%s« nicht verwenden, wenn nur Analyze durchgeführt wird
%s: kann nicht alle Datenbanken und eine bestimmte gleichzeitig vacuumen
%s: kann nicht bestimmte Tabelle(n) in allen Datenbanken vacuumen
%s: clustere Datenbank »%s«
%s: Clustern der Datenbank »%s« fehlgeschlagen: %s %s: Clustern der Tabelle »%s« in Datenbank »%s« fehlgeschlagen: %s %s: Erzeugen des Kommentars ist fehlgeschlagen (Datenbank wurde erzeugt): %s %s: konnte nicht mit Datenbank %s verbinden: %s %s: konnte nicht mit Datenbank %s verbinden: Speicher aufgebraucht
%s: konnte Standardoptionen nicht ermitteln
%s: Erzeugen der neuen Rolle fehlgeschlagen: %s %s: Erzeugen der Datenbank ist fehlgeschlagen: %s %s: Löschen der Datenbank fehlgeschlagen: %s %s: ungültiger Wert für --connection-limit: %s
%s: Sprache »%s« ist bereits in Datenbank »%s« installiert
%s: Sprache »%s« ist nicht in Datenbank »%s« installiert
%s: Installation der Sprache fehlgeschlagen: %s %s: Löschen der Sprache fehlgeschlagen: %s %s: Datenbankname als Argument fehlt
%s: Sprachenname als Argument fehlt
%s: Rollenname als Argument fehlt
%s: Anzahl paralleler Jobs muss mindestens 1 sein
%s: --locale und --lc-collate können nicht zusammen angegeben werden
%s: --locale und --lc-ctype können nicht zusammen angegeben werden
%s: bearbeite Datenbank »%s«: %s
%s: Anfrage fehlgeschlagen: %s %s: Anfrage ergab %d Zeile anstatt einer: %s
%s: Anfrage ergab %d Zeilen anstatt einer: %s
%s: Anfrage war: %s
%s: reindiziere Datenbank »%s«
%s: Reindizieren der Datenbank »%s« fehlgeschlagen: %s %s: Reindizieren des Index »%s« in Datenbank »%s« fehlgeschlagen: %s %s: Reindizieren des Schemas »%s« in Datenbank »%s« fehlgeschlagen: %s %s: Reindizieren der Systemkataloge fehlgeschlagen: %s %s: Reindizieren der Tabelle »%s« in Datenbank »%s« fehlgeschlagen: %s %s: Löschen der Rolle »%s« fehlgeschlagen: %s %s: zu viele Kommandozeilenargumente (das erste ist »%s«)
%s: zu viele Jobs für diese Plattform -- versuchen Sie %d
%s: führe Vacuum in Datenbank »%s« aus
%s: Vacuum der Datenbank »%s« fehlgeschlagen: %s %s: Vacuum der Tabelle »%s« in Datenbank »%s« fehlgeschlagen: %s (%lu Zeile) (%lu Zeilen) Sind Sie sich sicher? Abbruchsanforderung gesendet
Cann keine weitere Zelle zur Tabelle hinzufügen: Zellengesamtzahl %d überschritten.
Kann keinen weiteren Spaltenkopf zur Tabelle hinzufügen: Spaltenzahl %d überschritten.
Konnte Abbruchsanforderung nicht senden: %s Datenbank »%s« wird unwiderruflich gelöscht werden.
Geben Sie es noch einmal ein: Geben Sie den Namen der neuen Rolle ein: Geben Sie den Namen der zu löschenden Rolle ein: Geben Sie das Passwort der neuen Rolle ein: Erzeuge volle Optimierer-Statistiken Erzeuge mittlere Optimierer-Statistiken (10 Ziele) Erzeuge minimale Optimierer-Statistiken (1 Ziel) Unterbrochen
Name Passwortverschlüsselung ist fehlgeschlagen.
Passwort: Passwörter stimmten nicht überein.
Bitte antworten Sie »%s« oder »%s«.
Prozedurale Sprachen Rolle »%s« wird unwiderruflich gelöscht werden.
Soll die neue Rolle ein Superuser sein? Soll die neue Rolle Datenbanken erzeugen dürfen? Soll die neue Rolle weitere neue Rollen erzeugen dürfen? Vertraut? Versuchen Sie »%s --help« für weitere Informationen.
Aufruf:
Verbindungen werden angenommen
kann NULL-Zeiger nicht kopieren (interner Fehler)
konnte effektive Benutzer-ID %ld nicht nachschlagen: %s ungültiges Ausgabeformat (interner Fehler): %d n nein kein Verbindungsversuch
keine Antwort
Speicher aufgebraucht
Verbindungen werden abgelehnt
unbekannt
Benutzer existiert nicht Fehler beim Nachschlagen des Benutzernamens: Fehlercode %lu j ja locale/de/LC_MESSAGES/pg_basebackup-9.6.mo 0000644 00000067773 14751153420 0013643 0 ustar 00 �� � �
` a { � � ! �
� - � X T l R � ` I u D � 3 K J < � j � > > N } @ � 3
Y A > � 1 � j < w ? � M � k B J � Y � + S 0 B � B � * 6 8 a � � 5 ) � _ r � o Z 1 � 3 � K 0 - | F � \ � P N 2 � 4 � 8 @ 1 G 4 y 1 � . � @ 1 P E � B � 7 ! C! ]! & }! ; �! ( �! # " - -" ' [" " �" �" 2 �" , �" + '# . S# ( �# # �# 5 �# f $ , l$ 9 �$ 4 �$ 7 % = @% d ~% A �% " %& & H& & o& # �& / �& > �& a )' & �' & �' % �' 2 �' 1 2( 0 d( 8 �( ( �( 2 �( *) & K) ' r) . �) + �) # �) A * 2 [* & �* & �* / �* + + 4 8+ / m+ ! �+ 1 �+ ) �+ ( , 2 D, 2 w, 3 �, 0 �, % - # 5- + Y- �- �- 2 �- # �- . , (. , U. # �. i �. i / ? z/ 9 �/ " �/ A 0 # Y0 }0 9 �0 �0 �0 !
1 D /1 & t1 # �1 A �1 - 2 D /2 ! t2 �2 �2 " �2 �2 9 3 1 C3 D u3 , �3 �3 ' �3 D "4 M g4 : �4 8 �4 6 )5 `5 E y5 G �5 z 6 c �6 % �6 . 7 2 ;7 6 n7 # �7 �7 % �7 0 8 R 98 , �8 4 �8 K �8 @ :9 > {9 - �9 , �9 ' : , =: o j: k �: 4 F; % {; ( �; ; �;
< & < 8< / @< p< / < � �< L> e> |> �> * �> �> 6 �> S ? M k? Y �? _ @ K s@ > �@ �@ < A P MA H �A i �A E QB Q �B H �B : 2C ^ mC ? �C ; D } HD / �D F �D M =E u �E I F k KF . �F B �F N )G K xG - �G G �G � :H 9 �H � I z �I u (J + �J 6 �J p K 2 rK F �K \ �K P IL > �L 5 �L D M TM 6 [M 5 �M ? �M 1 N \ :N E �N W �N T 5O G �O �O 2 �O * #P > NP 6 �P 0 �P : �P 3 0Q - dQ & �Q 7 �Q 1 �Q 1 #R 8 UR 1 �R + �R ; �R w (S > �S N �S ? .T ? nT D �T w �T H kU * �U - �U .
V 1 <V ; nV D �V u �V + eW 0 �W - �W > �W 9 /X < iX M �X - �X ? "Y % bY . �Y - �Y 3 �Y 7 Z - QZ Z Z 7 �Z + [ . >[ 5 m[ 4 �[ E �[ 4 \ ; S\ J �\ , �\ , ] < 4] ; q] @ �] < �] / +^ % [^ 5 �^ �^ �^ 8 �^ % %_ ( K_ 4 t_ 2 �_ " �_ h �_ i h` D �` K a / ca O �a , �a ' b G 8b ! �b �b ' �b V �b * <c ' gc U �c 0 �c H d * _d �d �d # �d �d ; e G Ae H �e < �e f & *f E Qf a �f F �f 7 @g C xg �g M �g T +h s �h v �h , ki - �i 3 �i : �i " 5j Xj - sj N �j _ �j 8 Pk < �k L �k 9 l D Ml A �l 0 �l > m - Dm x rm { �m 5 gn . �n ) �n ; �n
2o 8 =o vo 2 o �o 1 �o � * � � o C $ e 7 ] � j @ � � � � f � - R � � � � O = � s � F } 2 M � p c { < N 8 � � � ) B + Y � � � � � z & T k h � I H K ~ � t w X v � � � : � > � � . / � 5 � U � � � � � _ � � 6 [ E
Z � S J , � � d # x � � Q y A P � � i � � u ^ � ? � � V
� 0 n � ( � � \ ; � � r � � � � 4 � g � " � 3 1 � D m l 9 a � � b G q � % W � � � � ! � � | ` L � � � ' �
Action to be performed:
Connection options:
General options:
Optional actions:
Options controlling the output:
Options:
Report bugs to <pgsql-bugs@postgresql.org>.
--create-slot create a new replication slot (for the slot's name see --slot)
--drop-slot drop the replication slot (for the slot's name see --slot)
--if-not-exists do not error if slot already exists when creating a slot
--start start streaming in a replication slot (for the slot's name see --slot)
--synchronous flush transaction log immediately after writing
--xlogdir=XLOGDIR location for the transaction log directory
%s [OPTION]...
-?, --help show this help, then exit
-D, --directory=DIR receive transaction log files into this directory
-D, --pgdata=DIRECTORY receive base backup into directory
-F --fsync-interval=SECS
time between fsyncs to the output file (default: %d)
-F, --format=p|t output format (plain (default), tar)
-I, --startpos=LSN where in an existing slot should the streaming start
-P, --plugin=PLUGIN use output plugin PLUGIN (default: %s)
-P, --progress show progress information
-R, --write-recovery-conf
write recovery.conf for replication
-S, --slot=SLOTNAME name of the logical replication slot
-S, --slot=SLOTNAME replication slot to use
-T, --tablespace-mapping=OLDDIR=NEWDIR
relocate tablespace in OLDDIR to NEWDIR
-U, --username=NAME connect as specified database user
-V, --version output version information, then exit
-W, --password force password prompt (should happen automatically)
-X, --xlog-method=fetch|stream
include required WAL files with specified method
-Z, --compress=0-9 compress tar output with given compression level
-c, --checkpoint=fast|spread
set fast or spread checkpointing
-d, --dbname=CONNSTR connection string
-d, --dbname=DBNAME database to connect to
-f, --file=FILE receive log into this file, - for stdout
-h, --host=HOSTNAME database server host or socket directory
-l, --label=LABEL set backup label
-n, --no-loop do not loop on connection lost
-o, --option=NAME[=VALUE]
pass option NAME with optional value VALUE to the
output plugin
-p, --port=PORT database server port number
-r, --max-rate=RATE maximum transfer rate to transfer data directory
(in kB/s, or use suffix "k" or "M")
-s, --status-interval=INTERVAL
time between status packets sent to server (in seconds)
-s, --status-interval=SECS
time between status packets sent to server (default: %d)
-v, --verbose output verbose messages
-w, --no-password never prompt for password
-x, --xlog include required WAL files in backup (fetch mode)
-z, --gzip compress tar output
%*s/%s kB (%d%%), %d/%d tablespace %*s/%s kB (%d%%), %d/%d tablespaces %*s/%s kB (%d%%), %d/%d tablespace (%s%-*.*s) %*s/%s kB (%d%%), %d/%d tablespaces (%s%-*.*s) %*s/%s kB (100%%), %d/%d tablespace %*s %*s/%s kB (100%%), %d/%d tablespaces %*s %s controls PostgreSQL logical decoding streams.
%s receives PostgreSQL streaming transaction logs.
%s takes a base backup of a running PostgreSQL server.
%s: %s %s: %s needs a slot to be specified using --slot
%s: COPY stream ended before last file was finished
%s: WAL streaming can only be used in plain mode
%s: at least one action needs to be specified
%s: can only write single tablespace to stdout, database has %d
%s: cannot specify both --xlog and --xlog-method
%s: cannot use --create-slot or --drop-slot together with --startpos
%s: cannot use --create-slot or --start together with --drop-slot
%s: cannot use --create-slot together with --drop-slot
%s: checkpoint completed
%s: child %d died, expected %d
%s: child thread exited with error %u
%s: confirming write up to %X/%X, flush to %X/%X (slot %s)
%s: could not access directory "%s": %s
%s: could not clear search_path: %s %s: could not close compressed file "%s": %s
%s: could not close directory "%s": %s
%s: could not close file "%s": %s
%s: could not connect to server
%s: could not create archive status file "%s": %s
%s: could not create background process: %s
%s: could not create background thread: %s
%s: could not create compressed file "%s": %s
%s: could not create directory "%s": %s
%s: could not create file "%s": %s
%s: could not create pipe for background process: %s
%s: could not create replication slot "%s": got %d rows and %d fields, expected %d rows and %d fields
%s: could not create symbolic link "%s": %s
%s: could not create symbolic link from "%s" to "%s": %s
%s: could not create timeline history file "%s": %s
%s: could not determine seek position in file "%s": %s
%s: could not determine server setting for integer_datetimes
%s: could not drop replication slot "%s": got %d rows and %d fields, expected %d rows and %d fields
%s: could not establish database-specific replication connection
%s: could not fsync file "%s": %s
%s: could not fsync log file "%s": %s
%s: could not get COPY data stream: %s %s: could not get backup header: %s %s: could not get child thread exit status: %s
%s: could not get transaction log end position from server: %s %s: could not identify system: got %d rows and %d fields, expected %d rows and %d or more fields
%s: could not initiate base backup: %s %s: could not open directory "%s": %s
%s: could not open log file "%s": %s
%s: could not open timeline history file "%s": %s
%s: could not open transaction log file "%s": %s
%s: could not pad transaction log file "%s": %s
%s: could not parse next timeline's starting point "%s"
%s: could not parse start position "%s"
%s: could not parse transaction log location "%s"
%s: could not read COPY data: %s %s: could not read directory "%s": %s
%s: could not read from ready pipe: %s
%s: could not receive data from WAL stream: %s %s: could not rename file "%s" to "%s": %s
%s: could not rename file "%s": %s
%s: could not seek to beginning of transaction log file "%s": %s
%s: could not send command to background pipe: %s
%s: could not send copy-end packet: %s %s: could not send feedback packet: %s %s: could not send replication command "%s": %s %s: could not set compression level %d: %s
%s: could not set permissions on directory "%s": %s
%s: could not set permissions on file "%s": %s
%s: could not stat file "%s": %s
%s: could not stat transaction log file "%s": %s
%s: could not wait for child process: %s
%s: could not wait for child thread: %s
%s: could not write %u bytes to WAL file "%s": %s
%s: could not write %u bytes to log file "%s": %s
%s: could not write timeline history file "%s": %s
%s: could not write to compressed file "%s": %s
%s: could not write to file "%s": %s
%s: creating replication slot "%s"
%s: directory "%s" exists but is not empty
%s: directory name too long
%s: disconnected
%s: disconnected; waiting %d seconds to try again
%s: dropping replication slot "%s"
%s: final receive failed: %s %s: finished segment at %X/%X (timeline %u)
%s: got WAL data offset %08x, expected %08x
%s: incompatible server version %s
%s: incompatible server version %s; client does not support streaming from server versions newer than %s
%s: incompatible server version %s; client does not support streaming from server versions older than %s
%s: initiating base backup, waiting for checkpoint to complete
%s: integer_datetimes compile flag does not match server
%s: invalid --max-rate unit: "%s"
%s: invalid checkpoint argument "%s", must be "fast" or "spread"
%s: invalid compression level "%s"
%s: invalid fsync interval "%s"
%s: invalid output format "%s", must be "plain" or "tar"
%s: invalid port number "%s"
%s: invalid socket: %s %s: invalid status interval "%s"
%s: invalid tablespace mapping format "%s", must be "OLDDIR=NEWDIR"
%s: invalid tar block header size: %d
%s: invalid transfer rate "%s": %s
%s: invalid xlog-method option "%s", must be "fetch" or "stream"
%s: multiple "=" signs in tablespace mapping
%s: new directory is not an absolute path in tablespace mapping: %s
%s: no data returned from server
%s: no database specified
%s: no slot specified
%s: no target directory specified
%s: no target file specified
%s: no transaction log end position returned from server
%s: not renaming "%s%s", segment is not complete
%s: old directory is not an absolute path in tablespace mapping: %s
%s: only tar mode backups can be compressed
%s: out of memory
%s: received interrupt signal, exiting
%s: received transaction log record for offset %u with no file open
%s: replication connection using slot "%s" is unexpectedly database specific
%s: replication slots can only be used with WAL streaming
%s: replication stream was terminated before stop point
%s: segment file "%s" has incorrect size %d, skipping
%s: select() failed: %s
%s: server reported unexpected history file name for timeline %u: %s
%s: server reported unexpected next timeline %u, following timeline %u
%s: server returned unexpected response to BASE_BACKUP command; got %d rows and %d fields, expected %d rows and %d fields
%s: server stopped streaming timeline %u at %X/%X, but reported next timeline %u to begin at %X/%X
%s: starting background WAL receiver
%s: starting log streaming at %X/%X (slot %s)
%s: starting log streaming at %X/%X (timeline %u)
%s: starting timeline %u is not present in the server
%s: streaming header too small: %d
%s: streaming initiated
%s: switched to timeline %u at %X/%X
%s: symlinks are not supported on this platform
%s: system identifier does not match between base backup and streaming connection
%s: this build does not support compression
%s: too many command-line arguments (first is "%s")
%s: transaction log directory location can only be specified in plain mode
%s: transaction log directory location must be an absolute path
%s: transaction log file "%s" has %d bytes, should be 0 or %d
%s: transfer rate "%s" exceeds integer range
%s: transfer rate "%s" is not a valid value
%s: transfer rate "%s" is out of range
%s: transfer rate must be greater than zero
%s: unexpected response to TIMELINE_HISTORY command: got %d rows and %d fields, expected %d rows and %d fields
%s: unexpected result set after end-of-timeline: got %d rows and %d fields, expected %d rows and %d fields
%s: unexpected termination of replication stream: %s %s: unrecognized link indicator "%c"
%s: unrecognized streaming header: "%c"
%s: waiting for background process to finish streaming ...
Password: Try "%s --help" for more information.
Usage:
cannot duplicate null pointer (internal error)
out of memory
transaction log start point: %s on timeline %u
Project-Id-Version: PostgreSQL 9.6
Report-Msgid-Bugs-To: pgsql-bugs@postgresql.org
POT-Creation-Date: 2020-11-08 11:51+0000
PO-Revision-Date: 2017-05-08 08:27-0400
Last-Translator: Peter Eisentraut <peter_e@gmx.net>
Language-Team: Peter Eisentraut <peter_e@gmx.net>
Language: de
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Plural-Forms: nplurals=2; plural=(n != 1);
Auszuführende Aktion:
Verbindungsoptionen:
Allgemeine Optionen:
Optionale Aktionen:
Optionen, die die Ausgabe kontrollieren:
Optionen:
Berichten Sie Fehler an <pgsql-bugs@postgresql.org>.
--create-slot neuen Replikations-Slot erzeugen (Slot-Name siehe --slot)
--drop-slot Replikations-Slot löschen (Slot-Name siehe --slot)
--if-not-exists keinen Fehler ausgeben, wenn Slot beim Erzeugen schon existiert
--start Streaming in einem Replikations-Slot starten (Slot-Name siehe --slot)
--synchronous Transaktionslog sofort nach dem Schreiben flushen
--xlogdir=XLOGVERZ Verzeichnis für das Transaktionslog
%s [OPTION]...
-?, --help diese Hilfe anzeigen, dann beenden
-D, --directory=VERZ Transaktionslogdateien in dieses Verzeichnis empfangen
-D, --pgdata=VERZ Basissicherung in dieses Verzeichnis empfangen
-F --fsync-interval=SEK
Zeit zwischen Fsyncs der Ausgabedatei (Standard: %d)
-F, --format=p|t Ausgabeformat (plain (Voreinstellung), tar)
-I, --startpos=LSN wo in einem bestehenden Slot das Streaming starten soll
-P, --plugin=PLUGIN Ausgabe-Plugin PLUGIN verwenden (Standard: %s)
-P, --progress Fortschrittsinformationen zeigen
-R, --write-recovery-conf
recovery.conf für Replikation schreiben
-S, --slot=SLOTNAME Name des logischen Replikations-Slots
-S, --slot=SLOTNAME zu verwendender Replikations-Slot
-T, --tablespace-mapping=ALTES_VERZ=NEUES_VERZ
Tablespace in ALTES_VERZ nach NEUES_VERZ verlagern
-U, --username=NAME Datenbankbenutzername
-V, --version Versionsinformationen anzeigen, dann beenden
-W, --password nach Passwort fragen (sollte automatisch geschehen)
-X, --xlog-method=fetch|stream
benötigte WAL-Dateien mit angegebener Methode einbeziehen
-Z, --compress=0-9 Tar-Ausgabe mit angegebenem Niveau komprimieren
-c, --checkpoint=fast|spread
schnelles oder verteiltes Checkpointing einstellen
-d, --dbname=VERBDG Verbindungsparameter
-d, --dbname=DBNAME Datenbank, mit der verbunden werden soll
-f, --file=DATEI Log in diese Datei empfangen, - für Standardausgabe
-h, --host=HOSTNAME Name des Datenbankservers oder Socket-Verzeichnis
-l, --label=LABEL Backup-Label setzen
-n, --no-loop bei Verbindungsverlust nicht erneut probieren
-o, --option=NAME[=WERT]
Option NAME mit optionalem Wert WERT an den
Ausgabe-Plugin übergeben
-p, --port=PORT Portnummer des Datenbankservers
-r, --max-rate=RATE maximale Transferrate für Übertragung des Datenver-
zeichnisses (in kB/s, oder Suffix »k« oder »M« abgeben)
-s, --status-interval=INTERVALL
Zeit zwischen an Server gesendeten Statuspaketen (in Sekunden)
-s, --status-interval=SEK
Zeit zwischen an Server gesendeten Statuspaketen (Standard: %d)
-v, --verbose »Verbose«-Modus
-w, --no-password niemals nach Passwort fragen
-x, --xlog benötigte WAL-Dateien in Sicherung einbeziehen
(Fetch-Modus)
-z, --gzip Tar-Ausgabe komprimieren
%*s/%s kB (%d%%), %d/%d Tablespace %*s/%s kB (%d%%), %d/%d Tablespaces %*s/%s kB (%d%%), %d/%d Tablespace (%s%-*.*s) %*s/%s kB (%d%%), %d/%d Tablespaces (%s%-*.*s) %*s/%s kB (100%%), %d/%d Tablespace %*s %*s/%s kB (100%%), %d/%d Tablespaces %*s %s kontrolliert logische Dekodierungsströme von PostgreSQL.
%s empfängt PostgreSQL-Streaming-Transaktionslogs.
%s erzeugt eine Basissicherung eines laufenden PostgreSQL-Servers.
%s: %s %s: für %s muss ein Slot mit --slot angegeben werden
%s: COPY-Strom endete vor dem Ende der letzten Datei
%s: WAL-Streaming kann nur im »plain«-Modus verwendet werden
%s: mindestens eine Aktion muss angegeben werden
%s: kann nur einen einzelnen Tablespace auf die Standardausgabe schreiben, Datenbank hat %d
%s: --xlog und --xlog-method können nicht zusammen verwendet werden
%s: --create-slot oder --drop-slot kann nicht zusammen mit --startpos verwendet werden
%s: --create-slot oder --start kann nicht zusammen mit --drop-slot verwendet werden
%s: --create-slot kann nicht zusammen mit --drop-slot verwendet werden
%s: Checkpoint abgeschlossen
%s: Kindprozess %d endete, aber %d wurde erwartet
%s: Kind-Thread hat mit Fehler %u beendet
%s: bestätige Schreiben bis %X/%X, Flush bis %X/%X (Slot %s)
%s: konnte nicht auf Verzeichnis »%s« zugreifen: %s
%s: konnte search_path nicht auf leer setzen: %s %s: konnte komprimierte Datei »%s« nicht schließen: %s
%s: konnte Verzeichnis »%s« nicht schließen: %s
%s: konnte Datei »%s« nicht schließen: %s
%s: konnte nicht mit Server verbinden
%s: konnte Archivstatusdatei »%s« nicht erzeugen: %s
%s: konnte Hintergrundprozess nicht erzeugen: %s
%s: konnte Hintergrund-Thread nicht erzeugen: %s
%s: konnte komprimierte Datei »%s« nicht erzeugen: %s
%s: konnte Verzeichnis »%s« nicht erzeugen: %s
%s: konnte Datei »%s« nicht erzeugen: %s
%s: konnte Pipe für Hintergrundprozess nicht erzeugen: %s
%s: konnte Replikations-Slot »%s« nicht erzeugen: %d Zeilen und %d Felder erhalten, %d Zeilen und %d Felder erwartet
%s: konnte symbolische Verknüpfung »%s« nicht erzeugen: %s
%s: konnte symbolische Verknüpfung von »%s« nach »%s« nicht erzeugen: %s
%s: konnte Zeitleisten-History-Datei »%s« nicht erzeugen: %s
%s: konnte Positionszeiger in Datei »%s« nicht ermitteln: %s
%s: konnte Servereinstellung für integer_datetimes nicht ermitteln
%s: konnte Replikations-Slot »%s« nicht löschen: %d Zeilen und %d Felder erhalten, %d Zeilen und %d Felder erwartet
%s: konnte keine datenbankspezifische Replikationsverbindung herstellen
%s: konnte Datei »%s« nicht fsyncen: %s
%s: konnte Logdatei »%s« nicht fsyncen: %s
%s: konnte COPY-Datenstrom nicht empfangen: %s %s: konnte Kopf der Sicherung nicht empfangen: %s %s: konnte Statuscode des Kind-Threads nicht ermitteln: %s
%s: konnte Transaktionslogendposition nicht vom Server empfangen: %s %s: konnte System nicht identifizieren: %d Zeilen und %d Felder erhalten, %d Zeilen und %d oder mehr Felder erwartet
%s: konnte Basissicherung nicht starten: %s %s: konnte Verzeichnis »%s« nicht öffnen: %s
%s: konnte Logdatei »%s« nicht öffnen: %s
%s: konnte Zeitleisten-History-Datei »%s« nicht öffnen: %s
%s: konnte Transaktionslogdatei »%s« nicht öffnen: %s
%s: konnte Transaktionslogdatei »%s« nicht auffüllen: %s
%s: konnte Startpunkt der nächsten Zeitleiste (»%s«) nicht interpretieren
%s: konnte Startposition »%s« nicht parsen
%s: konnte Transaktionslogposition »%s« nicht interpretieren
%s: konnte COPY-Daten nicht lesen: %s %s: konnte Verzeichnis »%s« nicht lesen: %s
%s: konnte nicht aus bereiter Pipe lesen: %s
%s: konnte keine Daten vom WAL-Stream empfangen: %s %s: konnte Datei »%s« nicht in »%s« umbenennen: %s
%s: konnte Datei »%s« nicht umbenennen: %s
%s: konnte Positionszeiger nicht an den Anfang der Transaktionslogdatei »%s« setzen: %s
%s: konnte Befehl nicht an Hintergrund-Pipe senden: %s
%s: konnte COPY-Ende-Paket nicht senden: %s %s: konnte Rückmeldungspaket nicht senden: %s %s: konnte Replikationsbefehl »%s« nicht senden: %s %s: konnte Komprimierungsniveau %d nicht setzen: %s
%s: konnte Zugriffsrechte des Verzeichnisses »%s« nicht setzen: %s
%s: konnte Rechte der Datei »%s« nicht setzen: %s
%s: konnte »stat« für Datei »%s« nicht ausführen: %s
%s: konnte »stat« für Transaktionslogdatei »%s« nicht ausführen: %s
%s: konnte nicht auf Kindprozess warten: %s
%s: konnte nicht auf Kind-Thread warten: %s
%s: konnte %u Bytes nicht in WAL-Datei »%s« schreiben: %s
%s: konnte %u Bytes nicht in Logdatei »%s« schreiben: %s
%s: konnte Zeitleisten-History-Datei »%s« nicht schreiben: %s
%s: konnte nicht in komprimierte Datei »%s« schreiben: %s
%s: konnte nicht in Datei »%s« schreiben: %s
%s: erzeuge Replikations-Slot »%s«
%s: Verzeichnis »%s« existiert aber ist nicht leer
%s: Verzeichnisname zu lang
%s: Verbindung beendet
%s: Verbindung beendet; erneuter Versuch in %d Sekunden
%s: lösche Replikations-Slot »%s«
%s: letztes Empfangen fehlgeschlagen: %s %s: Segment bei %X/%X abgeschlossen (Zeitleiste %u)
%s: WAL-Daten-Offset %08x erhalten, %08x erwartet
%s: inkompatible Serverversion %s
%s: inkompatible Serverversion %s; Client unterstützt Streaming nicht mit Serverversionen neuer als %s
%s: inkompatible Serverversion %s; Client unterstützt Streaming nicht mit Serverversionen älter als %s
%s: Basissicherung eingeleitet, warte auf Abschluss des Checkpoints
%s: Kompilieroption »integer_datetimes« stimmt nicht mit Server überein
%s: ungültige Einheit für --max-rate: »%s«
%s: ungültiges Checkpoint-Argument »%s«, muss »fast« oder »spread« sein
%s: ungültiges Komprimierungsniveau »%s«
%s: ungültiges Fsync-Intervall »%s«
%s: ungültiges Ausgabeformat »%s«, muss »plain« oder »tar« sein
%s: ungültige Portnummer »%s«
%s: ungültiges Socket: %s %s: ungültiges Statusintervall »%s«
%s: ungültiges Tablespace-Mapping-Format »%s«, muss »ALTES_VERZ=NEUES_VERZ« sein
%s: ungültige Tar-Block-Kopf-Größe: %d
%s: ungültige Transferrate »%s«: %s
%s: ungültige Option »%s« für --xlog-method, muss »fetch« oder »stream« sein
%s: mehrere »=«-Zeichen im Tablespace-Mapping
%s: neues Verzeichnis im Tablespace-Mapping ist kein absoluter Pfad: %s
%s: keine Daten vom Server zurückgegeben
%s: keine Datenbank angegeben
%s: kein Slot angegeben
%s: kein Zielverzeichnis angegeben
%s: keine Zieldatei angegeben
%s: kein Transaktionslogendpunkt vom Server zurückgegeben
%s: »%s%s« wird nicht umbenannt, Segment ist noch nicht vollständig
%s: altes Verzeichnis im Tablespace-Mapping ist kein absoluter Pfad: %s
%s: nur Sicherungen im Tar-Modus können komprimiert werden
%s: Speicher aufgebraucht
%s: Interrupt-Signal erhalten, beende
%s: Transaktionslogeintrag für Offset %u erhalten ohne offene Datei
%s: Replikationsverbindung, die Slot »%s« verwendet, ist unerwarteterweise datenbankspezifisch
%s: Replikations-Slots können nur mit WAL-Streaming verwendet werden
%s: Replikationsstrom wurde vor Stopppunkt abgebrochen
%s: Segmentdatei »%s« hat falsche Größe %d, wird übersprungen
%s: select() fehlgeschlagen: %s
%s: Server berichtete unerwarteten History-Dateinamen für Zeitleiste %u: %s
%s: Server berichtete unerwartete nächste Zeitleiste %u, folgend auf Zeitleiste %u
%s: unerwartete Antwort auf Befehl BASE_BACKUP: %d Zeilen und %d Felder erhalten, %d Zeilen und %d Felder erwartet
%s: Server beendete Streaming von Zeitleiste %u bei %X/%X, aber gab an, dass nächste Zeitleiste %u bei %X/%X beginnt
%s: Hintergrund-WAL-Receiver wird gestartet
%s: starte Log-Streaming bei %X/%X (Slot %s)
%s: starte Log-Streaming bei %X/%X (Zeitleiste %u)
%s: Startzeitleiste %u ist auf dem Server nicht vorhanden
%s: Streaming-Header zu klein: %d
%s: Streaming eingeleitet
%s: auf Zeitleiste %u umgeschaltet bei %X/%X
%s: symbolische Verknüpfungen werden auf dieser Plattform nicht unterstützt
%s: Systemidentifikator stimmt nicht zwischen Basissicherung und Streaming-Verbindung überein
%s: diese Installation unterstützt keine Komprimierung
%s: zu viele Kommandozeilenargumente (das erste ist »%s«)
%s: Transaktionslogverzeichnis kann nur im »plain«-Modus angegeben werden
%s: Transaktionslogverzeichnis muss absoluten Pfad haben
%s: Transaktionslogdatei »%s« hat %d Bytes, sollte 0 oder %d sein
%s: Transferrate »%s« überschreitet Bereich für ganze Zahlen
%s: Transferrate »%s« ist kein gültiger Wert
%s: Transferrate »%s« ist außerhalb des gültigen Bereichs
%s: Transferrate muss größer als null sein
%s: unerwartete Antwort auf Befehl TIMELINE_HISTORY: %d Zeilen und %d Felder erhalten, %d Zeilen und %d Felder erwartet
%s: unerwartete Ergebnismenge nach Ende der Zeitleiste: %d Zeilen und %d Felder erhalten, %d Zeilen und %d Felder erwartet
%s: unerwarteter Abbruch des Replikations-Streams: %s %s: unbekannter Verknüpfungsindikator »%c«
%s: unbekannter Streaming-Header: »%c«
%s: warte bis Hintergrundprozess Streaming beendet hat ...
Passwort: Versuchen Sie »%s --help« für weitere Informationen.
Aufruf:
kann NULL-Zeiger nicht kopieren (interner Fehler)
Speicher aufgebraucht
Transaktionslog-Startpunkt: %s auf Zeitleiste %u
locale/de/LC_MESSAGES/pg_dump-9.6.mo 0000644 00000174471 14751153420 0012502 0 ustar 00 �� � L � | �( �( �( X �( [ 3) B �) ) �) " �) x * �* �* �* �* A �* N &+ P u+ I �+ 3 , y D, G �, C - N J- K �- v �- F \. > �. R �. B 5/ E x/ ? �/ L �/ 3 K0 6 0 Q �0 T 1 M ]1 ? �1 � �1 � y2 ? 23 9 r3 5 �3 : �3 K 4 B i4 D �4 � �4 3 r5 � �5 ? (6 D h6 x �6 6 &7 Q ]7 O �7 F �7 > F8 5 �8 > �8 E �8 A @9 O �9 H �9 B : @ ^: = �: O �: H -; ; v; , �; 4 �; E < 0 Z< = �< ; �< F = D L= C �= F �= 8 > ? U> C �> = �> 4 ? 7 L? L �? = �? @ @ J P@ < �@ L �@ , %A ( RA 5 {A E �A T �A LB 9 OB D �B G �B C 1C ? LC ' �C * �C e �C ! ED , gD 4 �D 6 �D ( E / )E YE wE $ �E * �E 2 �E B F > OF J �F P �F N *G H yG - �G �G H / H HH 4 ZH $ �H & �H * �H # I *I P II C �I A �I ( J IJ gJ �J �J = �J � �J
�K , �K � �K � SL , �L M p +M e �M & N )N ` 1N p �N 4 O X 8O _ �O E �O 1 7P 6 iP 4 �P * �P - Q D .Q . sQ + �Q + �Q ) �Q * $R > OR : �R ' �R = �R ) /S 1 YS �S @ �S 7 �S 6 T 6 VT < �T = �T 4 U 3 =U b qU 9 �U < V t KV # �V , �V 5 W GW hW �W
�W ' �W �W % �W �W / X X JX & �X 0 �X . �X - *Y XY oY �Y 3 �Y ( �Y �Y # �Y !Z & BZ K iZ & �Z �Z ! �Z ( [ ' E[ # m[ # �[ �[ / �[ \ &\ # B\ % f\ �\ , �\ $ �\ $ �\ $ ] 6 E] |] �] B �] � �] � �^ _ $ >_ < c_ 3 �_ * �_ ' �_ + '` ( S` ( |` # �` - �` � �` + �a , �a ! b & Bb ' ib # �b �b " �b 8 �b $ 0c Uc uc Q �c & �c a
d @ od 5 �d , �d e " .e # Qe , ue �e ! �e * �e # f % 2f 0 Xf & �f $ �f �f " �f = g # Ug 1 yg �g �g �g : �g ) h B Gh P �h �h �h
i (i " 8i [i ui & �i & �i % �i 2 j 9j Nj & jj ! �j ) �j # �j " k $k r 5k < �k D �k N *l F yl �l �l & �l , m - Mm {m " �m / �m �m n ( n @ Fn �n �n �n P �n +o > Ao 1 �o > �o / �o Y !p > {p �p �p " �p q & 3q < Zq �q ' �q ( �q ' �q $r Br Yr 1 lr + �r �r % �r 3 s Es ^s " ws ; �s �s �s 0 t 6t / Ut �t �t �t . �t I u > Su D �u �u �u v 7 v 9 Mv 6 �v H �v @ w Hw 3 Zw & �w 0 �w 6 �w / x ( Mx , vx �x " �x �x �x y h !y T �y � �y 6 bz L �z J �z 9 1{ k{ $ z{ + �{ �{ �{ �{ | -| 2 A| t| " �| �| �| �| �| $ } +} & <} c} w} # �} �} $ �} ) �} ~ ! 1~ % S~ + y~ �~ & �~ ' �~ 4 0 Q . � ) � + � � ( #� L� 4 j� � �� # "� * F� q� �� �� �� ( ҁ �� " � 5� E J� # �� �� ̂ � ; � '� =� J� ' f� �� ' �� % � � 0� B M� 0 �� ! �� 8 � : � W� s� 3 �� 1 ƅ 1 �� + *� $ V� $ {� h �� � � �� �� e Ȉ ` .� M �� 4 ݉ 3 � � F� Ɋ ϊ � �� I � u `� x u O� F Ō � � O �� R �� P L� K �� � � I v� F �� | � E �� M ʐ L � � e� ? � I +� } u� � � N y� L ȓ � � � �� N �� B ѕ > � 6 S� { �� E � N L� u �� @ � � R� N � v Q� � ș B X� M �� H � ; 2� K n� B �� 1 �� L /� H |� O Ŝ N � D d� M �� : �� R 2� M �� K Ӟ 2 � ? R� Q �� 5 � N � A i� O �� M �� O I� v �� 9 � J J� M �� L � 1 0� ; b� v �� I � Q _� x �� I *� v t� 1 � - � 8 K� Q �� S ֦ *� D -� H r� R �� � " /� R R� 4 �� 7 ڨ x � / �� 5 �� L � M >� 8 �� 9 Ū $ �� $� & 7� + ^� 3 �� S �� O � [ b� a �� _ � Y �� 9 ڭ � 3� : H� �� < �� ' / �� 6 /� % f� + �� g �� W � U x� 7 ΰ � #� @� _� I �� � ʱ
j� 5 u� � �� � [� ? � F� � ]� ~ � 8 h� �� l �� t � A �� t ζ q C� J �� 4 � 9 5� 7 o� . �� 1 ָ ] � : f� 7 �� 7 ٹ 5 � 6 G� R ~� = Ѻ 5 � R E� . �� < ǻ � K "� E n� C �� E �� I >� J �� B ӽ B � d Y� A �� N � � O� % � ( � P 7� �� & �� � � # � � 7 #� 0 [� 2 �� k �� # +� 1 O� - �� + �� �� �� � 3 � / N� ~� 1 �� $ �� 2 �� T � / s� 4 �� ( �� 5 � 0 7� . h� / �� ) �� H �� ) :� % d� - �� ) �� $ �� 0 � - 8� * f� ) �� : �� �� ( � R ?� � �� � 8� ' �� + � A ;� 9 }� 7 �� 8 �� 1 (� 0 Z� 0 �� . �� 9 �� � %� D � D N� 8 �� = �� =
� - H� & v� ( �� Q �� - � & F� & m� d �� 3 �� v -� J �� > �� ; .� ' j� * �� ( �� / �� $ � 2 ;� 5 n� ) �� . �� 7 �� 3 5� ) i� & �� 8 �� C �� + 7� 6 c� �� �� �� ? �� 2 � R K� W �� �� � /� L� & \� �� " �� ) �� ) �� ( � h @� �� �� 9 �� ) � B H� �� �� �� � �� Q U� V �� g �� \ f� $ �� �� & � / *� / Z� �� �� . �� �� � 3 0� M d� �� # �� , �� h #� �� O �� 3 �� > -� 5 l� k �� > � ! M� ! o� % �� # �� . �� M
� X� , x� . �� 1 �� # � *� G� D ]� : �� " �� + � = ,� j� �� ' �� > �� � ! � 4 ?� " t� 5 �� " �� % �� � / 2� Z b� O �� U
� c� " z� �� L �� b � L d� p �� Q "� t� 8 �� + �� 5 �� < )� 4 f� 6 �� 4 �� � ( � ?� ' \� �� � �� T %� � z� 4 �� b 0� Z �� M �� <� 7 M� , �� �� �� �� ��
� 7 !� Y� " f� �� �� �� �� - ��
� % � @�
W� # e� �� ) �� + �� & �� % � $ B� + g� # �� ( �� ) �� #
� ! .� 1 P� 0 �� ) �� , ��
� 8 )� " b� F �� � �� . j� 2 �� �� �� � � ) 2� \� " z� �� H �� , � $ 0� U� t� ] ~� �� �� ( � ( 4� ]� . |� % �� ' � �� � G 7� 0 � �� H � > � X� # y� 4 �� 2 � 2 � 1 8� 1 j� ' �� t � � � p � � � � m � _ � @ � 8 � �
= n k t ! � � � E � � � � . � & � ] � a � � � � � ! � ( � � ] � U � � j A 0 � � : � '
V ~ q Q � � F � � � - v � � � � Y � � i > � g � � � � � D a T � & + � � j D l � � � � � � � 3 � � � � � � � � f � � � { � � � � 7 � � � � � � r K � � 7 � � I � � I L v � � R � � / � � � � � 9 2 � < 4 $ � d ( � + � � � � � � o c � � 1 u � s � * b � � r � � � - i : � / � 3 ^ z K X X G � ) % � \ � � C � � � # � 2 � H � Q = � B J S ~ T � } � n E H 5 6 �
x � [ J � � y 6 � c o l w h s � � F ? m # p 9 � Z � � � � � ` � Y
� � 5 4 B @ � � z � � � g y { O � , " � � ? � � � � � S b > � N � � � P N . � ; � � � � � ` � q ) � � � � � � � � | � � t ^ � O ; h " � G w � � R V % � , � � � � � � � � � C � � M 0 � W � � _ � � � � f � ' < * � � � \ � L | [ Z } P � � � $ W � � � � � � � 8 � � x A e � d � U � � � � 1 � u e � M � k �
Connection options:
General options:
If -f/--file is not used, then the SQL script will be written to the standard
output.
If no database name is supplied, then the PGDATABASE environment
variable value is used.
If no input file name is supplied, then standard input is used.
Options controlling the output content:
Options controlling the restore:
The options -I, -n, -P, -t, -T, and --section can be combined and specified
multiple times to select multiple objects.
%s
%s [OPTION]...
%s [OPTION]... [DBNAME]
%s [OPTION]... [FILE]
--binary-upgrade for use by upgrade utilities only
--column-inserts dump data as INSERT commands with column names
--disable-dollar-quoting disable dollar quoting, use SQL standard quoting
--disable-triggers disable triggers during data-only restore
--enable-row-security enable row security
--enable-row-security enable row security (dump only content user has
access to)
--exclude-table-data=TABLE do NOT dump data for the named table(s)
--if-exists use IF EXISTS when dropping objects
--inserts dump data as INSERT commands, rather than COPY
--lock-wait-timeout=TIMEOUT fail after waiting TIMEOUT for a table lock
--no-data-for-failed-tables do not restore data of tables that could not be
created
--no-security-labels do not dump security label assignments
--no-security-labels do not restore security labels
--no-synchronized-snapshots do not use synchronized snapshots in parallel jobs
--no-tablespaces do not dump tablespace assignments
--no-tablespaces do not restore tablespace assignments
--no-unlogged-table-data do not dump unlogged table data
--quote-all-identifiers quote all identifiers, even if not key words
--role=ROLENAME do SET ROLE before dump
--role=ROLENAME do SET ROLE before restore
--section=SECTION dump named section (pre-data, data, or post-data)
--section=SECTION restore named section (pre-data, data, or post-data)
--serializable-deferrable wait until the dump can run without anomalies
--snapshot=SNAPSHOT use given snapshot for the dump
--strict-names require table and/or schema include patterns to
match at least one entity each
--use-set-session-authorization
use SET SESSION AUTHORIZATION commands instead of
ALTER OWNER commands to set ownership
-1, --single-transaction restore as a single transaction
-?, --help show this help, then exit
-?, --help show this help, then exit
-C, --create create the target database
-C, --create include commands to create database in dump
-E, --encoding=ENCODING dump the data in encoding ENCODING
-F, --format=c|d|t backup file format (should be automatic)
-F, --format=c|d|t|p output file format (custom, directory, tar,
plain text (default))
-I, --index=NAME restore named index
-L, --use-list=FILENAME use table of contents from this file for
selecting/ordering output
-N, --exclude-schema=SCHEMA do NOT dump the named schema(s)
-O, --no-owner skip restoration of object ownership
-O, --no-owner skip restoration of object ownership in
plain-text format
-P, --function=NAME(args) restore named function
-S, --superuser=NAME superuser user name to use for disabling triggers
-S, --superuser=NAME superuser user name to use in plain-text format
-S, --superuser=NAME superuser user name to use in the dump
-T, --exclude-table=TABLE do NOT dump the named table(s)
-T, --trigger=NAME restore named trigger
-U, --username=NAME connect as specified database user
-V, --version output version information, then exit
-V, --version output version information, then exit
-W, --password force password prompt (should happen automatically)
-Z, --compress=0-9 compression level for compressed formats
-a, --data-only dump only the data, not the schema
-a, --data-only restore only the data, no schema
-b, --blobs include large objects in dump
-c, --clean clean (drop) database objects before recreating
-c, --clean clean (drop) databases before recreating
-d, --dbname=CONNSTR connect using connection string
-d, --dbname=DBNAME database to dump
-d, --dbname=NAME connect to database name
-e, --exit-on-error exit on error, default is to continue
-f, --file=FILENAME output file name
-f, --file=FILENAME output file or directory name
-f, --file=FILENAME output file name (- for stdout)
-g, --globals-only dump only global objects, no databases
-h, --host=HOSTNAME database server host or socket directory
-j, --jobs=NUM use this many parallel jobs to dump
-j, --jobs=NUM use this many parallel jobs to restore
-l, --database=DBNAME alternative default database
-l, --list print summarized TOC of the archive
-n, --schema=NAME restore only objects in this schema
-n, --schema=SCHEMA dump the named schema(s) only
-o, --oids include OIDs in dump
-p, --port=PORT database server port number
-r, --roles-only dump only roles, no databases or tablespaces
-s, --schema-only dump only the schema, no data
-s, --schema-only restore only the schema, no data
-t, --table=NAME restore named relation (table, view, etc.)
-t, --table=TABLE dump the named table(s) only
-t, --tablespaces-only dump only tablespaces, no databases or roles
-v, --verbose verbose mode
-v, --verbose verbose mode
-w, --no-password never prompt for password
-x, --no-privileges do not dump privileges (grant/revoke)
-x, --no-privileges skip restoration of access privileges (grant/revoke)
%s %s dumps a database as a text file or to other formats.
%s extracts a PostgreSQL database cluster into an SQL script file.
%s restores a PostgreSQL database from an archive created by pg_dump.
%s: %s Command was: %s
%s: WSAStartup failed: %d
%s: cannot specify both --single-transaction and multiple jobs
%s: could not connect to database "%s"
%s: could not connect to database "%s": %s %s: could not connect to databases "postgres" or "template1"
Please specify an alternative database.
%s: could not get server version
%s: could not open the output file "%s": %s
%s: could not parse ACL list (%s) for database "%s"
%s: could not parse ACL list (%s) for tablespace "%s"
%s: could not parse server version "%s"
%s: could not re-open the output file "%s": %s
%s: dumping database "%s"...
%s: executing %s
%s: invalid number of parallel jobs
%s: maximum number of parallel jobs is %d
%s: option --if-exists requires option -c/--clean
%s: options -c/--clean and -a/--data-only cannot be used together
%s: options -d/--dbname and -f/--file cannot be used together
%s: options -g/--globals-only and -r/--roles-only cannot be used together
%s: options -g/--globals-only and -t/--tablespaces-only cannot be used together
%s: options -r/--roles-only and -t/--tablespaces-only cannot be used together
%s: options -s/--schema-only and -a/--data-only cannot be used together
%s: pg_dump failed on database "%s", exiting
%s: query failed: %s %s: query was: %s
%s: role name starting with "pg_" skipped (%s)
%s: running "%s"
%s: too many command-line arguments (first is "%s")
%s: unrecognized section name: "%s"
(The INSERT command cannot set OIDs.)
(The system catalogs might be corrupted.)
-C and -1 are incompatible options
COPY failed for table "%s": %s Consider using a full dump instead of a --data-only dump to avoid this problem.
Dumping the contents of table "%s" failed: PQgetCopyData() failed.
Dumping the contents of table "%s" failed: PQgetResult() failed.
Error from TOC entry %d; %u %u %s %s %s
Error message from server: %s Error while FINALIZING:
Error while INITIALIZING:
Error while PROCESSING TOC:
Exported snapshots are not supported by this server version.
NOTICE: there are circular foreign-key constraints on this table:
NOTICE: there are circular foreign-key constraints among these tables:
Password: Report bugs to <pgsql-bugs@postgresql.org>.
Synchronized snapshots are not supported by this server version.
Run with --no-synchronized-snapshots instead if you do not need
synchronized snapshots.
Synchronized snapshots are not supported on standby servers.
Run with --no-synchronized-snapshots instead if you do not need
synchronized snapshots.
TOC Entry %s at %s (length %s, checksum %d)
The command was: %s
The program "pg_dump" is needed by %s but was not found in the
same directory as "%s".
Check your installation.
The program "pg_dump" was found by "%s"
but was not the same version as %s.
Check your installation.
Try "%s --help" for more information.
Usage:
WARNING: aggregate function %s could not be dumped correctly for this database version; ignored
WARNING: archive is compressed, but this installation does not support compression -- no data will be available
WARNING: archive items not in correct section order
WARNING: archive was made on a machine with larger integers, some operations might fail
WARNING: bogus transform definition, at least one of trffromsql and trftosql should be nonzero
WARNING: bogus value in pg_cast.castfunc or pg_cast.castmethod field
WARNING: bogus value in pg_cast.castmethod field
WARNING: bogus value in pg_transform.trffromsql field
WARNING: bogus value in pg_transform.trftosql field
WARNING: bogus value in proargmodes array
WARNING: could not find operator with OID %s
WARNING: could not find where to insert IF EXISTS in statement "%s"
WARNING: could not parse proallargtypes array
WARNING: could not parse proargmodes array
WARNING: could not parse proargnames array
WARNING: could not parse proconfig array
WARNING: could not parse reloptions array
WARNING: could not resolve dependency loop among these items:
WARNING: don't know how to set owner for object type "%s"
WARNING: errors ignored on restore: %d
WARNING: ftell mismatch with expected position -- ftell used
WARNING: invalid creation date in header
WARNING: invalid type "%c" of access method "%s"
WARNING: line ignored: %s
WARNING: owner of aggregate function "%s" appears to be invalid
WARNING: owner of data type "%s" appears to be invalid
WARNING: owner of function "%s" appears to be invalid
WARNING: owner of operator "%s" appears to be invalid
WARNING: owner of operator class "%s" appears to be invalid
WARNING: owner of operator family "%s" appears to be invalid
WARNING: owner of schema "%s" appears to be invalid
WARNING: owner of table "%s" appears to be invalid
WARNING: requested compression not available in this installation -- archive will be uncompressed
WARNING: typtype of data type "%s" appears to be invalid
WARNING: unexpected extra results during COPY of table "%s"
You might not be able to restore the dump without using --disable-triggers or temporarily dropping the constraints.
a worker process died unexpectedly
aborting because of server version mismatch
actual file length (%s) does not match expected (%s)
allocating AH for %s, format %d
already connected to a database
archiver archiver (db) attempting to ascertain archive format
bad dumpId
bad table dumpId for TABLE DATA item
can only reopen input archives
cannot duplicate null pointer (internal error)
cannot restore from compressed archive (compression not supported in this installation)
child process exited with exit code %d child process exited with unrecognized status %d child process was terminated by exception 0x%X child process was terminated by signal %d: %s command not executable command not found compress_io compression is not supported by tar archive format
compression level must be in range 0..9
compressor active
connecting to database for restore
connecting to new database "%s"
connection to database "%s" failed: %s corrupt tar header found in %s (expected %d, computed %d) file position %s
could not change directory to "%s": %s could not close TOC file: %s
could not close archive file: %s
could not close compression library: %s
could not close compression stream: %s
could not close data file "%s": %s
could not close directory "%s": %s
could not close input file: %s
could not close large object TOC file "%s": %s
could not close output file: %s
could not close tar member
could not close temporary file: %s
could not commit database transaction could not compress data: %s
could not create communication channels: %s
could not create directory "%s": %s
could not create large object %u: %s could not create worker process: %s
could not determine seek position in archive file: %s
could not execute query could not find a "%s" to execute could not find block ID %d in archive -- possibly corrupt archive
could not find block ID %d in archive -- possibly due to out-of-order restore request, which cannot be handled due to lack of data offsets in archive
could not find block ID %d in archive -- possibly due to out-of-order restore request, which cannot be handled due to non-seekable input file
could not find entry for ID %d
could not find file "%s" in archive
could not find function definition for function with OID %u
could not find header for file "%s" in tar archive
could not find parent extension for %s %s
could not find slot of finished worker
could not generate temporary file name: %s
could not get server_version from libpq
could not identify current directory: %s could not identify dependency loop
could not initialize compression library: %s
could not obtain lock on relation "%s"
This usually means that someone requested an ACCESS EXCLUSIVE lock on the table after the pg_dump parent process had gotten the initial ACCESS SHARE lock on the table.
could not open TOC file "%s" for input: %s
could not open TOC file "%s" for output: %s
could not open TOC file "%s": %s
could not open TOC file for input: %s
could not open TOC file for output: %s
could not open input file "%s": %s
could not open input file: %s
could not open large object %u: %s could not open large object TOC file "%s" for input: %s
could not open output file "%s": %s
could not open output file: %s
could not open temporary file
could not parse GRANT ACL list (%s) or REVOKE ACL list (%s) for object "%s" (%s)
could not parse default ACL list (%s)
could not parse initial GRANT ACL list (%s) or initial REVOKE ACL list (%s) for object "%s" (%s)
could not parse numeric array "%s": invalid character in number
could not parse numeric array "%s": too many numbers
could not parse result of current_schemas()
could not read binary "%s" could not read directory "%s": %s
could not read from input file: %s
could not read from input file: end of file
could not read input file: %s
could not read symbolic link "%s" could not set default_tablespace to %s: %s could not set default_with_oids: %s could not set search_path to "%s": %s could not set seek position in archive file: %s
could not set session user to "%s": %s could not start database transaction could not uncompress data: %s
could not write to blobs TOC file
could not write to large object (result: %lu, expected: %lu)
could not write to output file: %s
could not write to the communication channel: %s
creating %s "%s"
creating %s "%s.%s"
custom archiver definition of view "%s" appears to be empty (length zero)
did not find magic string in file header
direct database connections are not supported in pre-1.3 archives
directory "%s" does not appear to be a valid archive ("toc.dat" does not exist)
directory archiver directory name too long: "%s"
disabling triggers for %s
dropping %s %s
dumping contents of table "%s.%s"
enabling triggers for %s
entering main parallel loop
entering restore_toc_entries_parallel
entering restore_toc_entries_postfork
entering restore_toc_entries_prefork
entry ID %d out of range -- perhaps a corrupt TOC
error during backup
error during file seek: %s
error processing a parallel work item
error reading large object %u: %s error reading large object TOC file "%s"
error returned by PQputCopyData: %s error returned by PQputCopyEnd: %s executing %s %s
expected %d check constraint on table "%s" but found %d
expected %d check constraints on table "%s" but found %d
expected format (%d) differs from format found in file (%d)
failed sanity check, parent OID %u of table "%s" (OID %u) not found
failed sanity check, parent table OID %u of pg_rewrite entry OID %u not found
failed sanity check, parent table OID %u of sequence OID %u not found
failed to connect to database
file name too long: "%s"
file offset in dump file is too large
finding check constraints for table "%s.%s"
finding default expressions of table "%s.%s"
finding extension tables
finding inheritance relationships
finding the columns and types of table "%s.%s"
finished item %d %s %s
finished main parallel loop
flagging inherited columns in subtables
found unexpected block ID (%d) when reading data -- expected %d
function "%s" not found
identifying extension members
implied data-only restore
incomplete tar header found (%lu byte)
incomplete tar header found (%lu bytes)
index "%s" not found
input file appears to be a text format dump. Please use psql.
input file does not appear to be a valid archive
input file does not appear to be a valid archive (too short?)
input file is too short (read %lu, expected 5)
internal error -- WriteData cannot be called outside the context of a DataDumper routine
internal error -- neither th nor fh specified in tarReadRaw()
invalid ENCODING item: %s
invalid OID for large object
invalid OID for large object (%u)
invalid STDSTRINGS item: %s
invalid adnum value %d for table "%s"
invalid argument string (%s) for trigger "%s" on table "%s"
invalid binary "%s" invalid client encoding "%s" specified
invalid column number %d for table "%s"
invalid column numbering in table "%s"
invalid compression code: %d
invalid dependency %d
invalid dumpId %d
invalid line in large object TOC file "%s": "%s"
invalid message received from worker: "%s"
invalid number of parallel jobs
invalid output format "%s" specified
large-object output not supported in chosen format
last built-in OID is %u
launching item %d %s %s
missing index for constraint "%s"
moving from position %s to next member at file position %s
no item ready
no matching schemas were found
no matching schemas were found for pattern "%s"
no matching tables were found
no matching tables were found for pattern "%s"
no output directory specified
not built with zlib support
now at file position %s
option --if-exists requires option -c/--clean
options --inserts/--column-inserts and -o/--oids cannot be used together
options -c/--clean and -a/--data-only cannot be used together
options -s/--schema-only and -a/--data-only cannot be used together
out of memory
out of on_exit_nicely slots
parallel archiver parallel backup only supported by the directory format
parallel restore from non-seekable file is not supported
parallel restore from standard input is not supported
parallel restore is not supported with archives made by pre-8.0 pg_dump
parallel restore is not supported with this archive file format
pclose failed: %s pgpipe: could not accept connection: error code %d
pgpipe: could not bind: error code %d
pgpipe: could not connect socket: error code %d
pgpipe: could not create second socket: error code %d
pgpipe: could not create socket: error code %d
pgpipe: could not listen: error code %d
pgpipe: getsockname() failed: error code %d
processing %s
processing data for table "%s.%s"
processing item %d %s %s
processing missed item %d %s %s
query failed: %s query produced null referenced table name for foreign key trigger "%s" on table "%s" (OID of table: %u)
query returned %d row instead of one: %s
query returned %d rows instead of one: %s
query to get data of sequence "%s" returned %d row (expected 1)
query to get data of sequence "%s" returned %d rows (expected 1)
query to get data of sequence "%s" returned name "%s"
query to get rule "%s" for table "%s" failed: wrong number of rows returned
query to obtain definition of view "%s" returned more than one definition
query to obtain definition of view "%s" returned no data
query was: %s
read TOC entry %d (ID %d) for %s %s
reading column info for interesting tables
reading constraints
reading default privileges
reading dependency data
reading event triggers
reading extensions
reading foreign key constraints for table "%s.%s"
reading indexes
reading indexes for table "%s.%s"
reading large objects
reading policies
reading procedural languages
reading rewrite rules
reading row-level security policies
reading schemas
reading table inheritance information
reading transforms
reading triggers
reading triggers for table "%s.%s"
reading type casts
reading user-defined access methods
reading user-defined aggregate functions
reading user-defined collations
reading user-defined conversions
reading user-defined foreign servers
reading user-defined foreign-data wrappers
reading user-defined functions
reading user-defined operator classes
reading user-defined operator families
reading user-defined operators
reading user-defined tables
reading user-defined text search configurations
reading user-defined text search dictionaries
reading user-defined text search parsers
reading user-defined text search templates
reading user-defined types
reconnection to database "%s" failed: %s reducing dependencies for %d
restored %d large object
restored %d large objects
restoring data out of order is not supported in this archive format: "%s" is required, but comes before "%s" in the archive file.
restoring large object with OID %u
sanity check on integer size (%lu) failed
saving database definition
saving encoding = %s
saving large objects
saving search_path = %s
saving standard_conforming_strings = %s
schema "%s" not found
schema with OID %u does not exist
select() failed: %s
server version must be at least 7.3 to use schema selection switches
server version: %s; %s version: %s
skipping item %d %s %s
skipping tar member %s
sorter table "%s" could not be created, will not restore its data
table "%s" not found
tar archiver this format cannot be read
transferring dependency %d -> %d to %d
trigger "%s" not found
unexpected COPY statement syntax: "%s"
unexpected data offset flag %d
unexpected policy command type: "%s"
unexpected section code %d
unexpected tgtype value: %d
unrecognized archive format "%s"; please specify "c", "d", or "t"
unrecognized command received from master: "%s"
unrecognized constraint type: %c
unrecognized data block type %d while restoring archive
unrecognized data block type (%d) while searching archive
unrecognized encoding "%s"
unrecognized file format "%d"
unrecognized object type in default privileges: %d
unrecognized proparallel value for function "%s"
unrecognized provolatile value for function "%s"
unsupported version (%d.%d) in file header
warning from original dump file: %s
worker process failed: exit code %d
wrote %lu byte of large object data (result = %lu)
wrote %lu bytes of large object data (result = %lu)
Project-Id-Version: PostgreSQL 9.6
Report-Msgid-Bugs-To: pgsql-bugs@postgresql.org
POT-Creation-Date: 2021-11-06 17:05+0000
PO-Revision-Date: 2020-05-11 09:08+0200
Last-Translator: Peter Eisentraut <peter_e@gmx.net>
Language-Team: German <peter_e@gmx.net>
Language: de
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Plural-Forms: nplurals=2; plural=n != 1;
Verbindungsoptionen:
Allgemeine Optionen:
Wenn -f/--file nicht verwendet wird, dann wird das SQL-Skript auf die
Standardausgabe geschrieben.
Wenn kein Datenbankname angegeben wird, dann wird die Umgebungsvariable
PGDATABASE verwendet.
Wenn keine Eingabedatei angegeben ist, wird die Standardeingabe verwendet.
Optionen die den Inhalt der Ausgabe kontrollieren:
Optionen die die Wiederherstellung kontrollieren:
Die Optionen -I, -n, -P, -t, -T und --section können kombiniert und mehrfach
angegeben werden, um mehrere Objekte auszuwählen.
%s
%s [OPTION]...
%s [OPTION]... [DBNAME]
%s [OPTION]... [DATEI]
--binary-upgrade wird nur von Upgrade-Programmen verwendet
--column-inserts Daten als INSERT-Anweisungen mit Spaltennamen
ausgeben
--disable-dollar-quoting Dollar-Quoting abschalten, normales SQL-Quoting
verwenden
--disable-triggers Trigger während der Datenwiederherstellung
abschalten
--enable-row-security Sicherheit auf Zeilenebene einschalten
--enable-row-security Sicherheit auf Zeilenebene einschalten (nur Daten
ausgeben, auf die der Benutzer Zugriff hat)
--exclude-table-data=TABELLE Daten der angegebenen Tabelle(n) NICHT ausgeben
--if-exists IF EXISTS verwenden, wenn Objekte gelöscht werden
--inserts Daten als INSERT-Anweisungen statt COPY ausgeben
--lock-wait-timeout=ZEIT Abbruch nach ZEIT Warten auf Tabellensperre
--no-data-for-failed-tables Daten für Tabellen, die nicht erzeugt werden
konnten, nicht wiederherstellen
--no-security-labels Security-Label-Zuweisungen nicht ausgeben
--no-security-labels Security-Labels nicht wiederherstellen
--no-synchronized-snapshots keine synchronisierten Snapshots in parallelen
Jobs verwenden
--no-tablespaces Tablespace-Zuordnungen nicht ausgeben
--no-tablespaces Tablespace-Zuordnungen nicht wiederherstellen
--no-unlogged-table-data Daten in ungeloggten Tabellen nicht ausgeben
--quote-all-identifiers alle Bezeichner in Anführungszeichen, selbst wenn
kein Schlüsselwort
--role=ROLLENNAME vor der Ausgabe SET ROLE ausführen
--role=ROLLENNAME vor der Wiederherstellung SET ROLE ausführen
--section=ABSCHNITT angegebenen Abschnitt ausgeben (pre-data, data
oder post-data)
--section=ABSCHNITT angegebenen Abschnitt wiederherstellen (pre-data,
data oder post-data)
--serializable-deferrable warten bis der Dump ohne Anomalien laufen kann
--snapshot=SNAPSHOT angegebenen Snapshot für den Dump verwenden
--strict-names Tabellen- oder Schemamuster müssen auf mindestens
je ein Objekt passen
--use-set-session-authorization
SET SESSION AUTHORIZATION Befehle statt ALTER
OWNER Befehle verwenden, um Eigentümerschaft zu
setzen
-1, --single-transaction Wiederherstellung als eine einzige Transaktion
-?, --help diese Hilfe anzeigen, dann beenden
-?, --help diese Hilfe anzeigen, dann beenden
-C, --create Zieldatenbank erzeugen
-C, --create Anweisungen zum Erstellen der Datenbank in
Ausgabe einfügen
-E, --encoding=KODIERUNG Daten in Kodierung KODIERUNG ausgeben
-F, --format=c|d|t Format der Backup-Datei (sollte automatisch gehen)
-F, --format=c|d|t|p Ausgabeformat (custom, d=Verzeichnis, tar,
plain text)
-I, --index=NAME benannten Index wiederherstellen
-L, --use-list=DATEINAME
Inhaltsverzeichnis aus dieser Datei zur Auswahl oder
Sortierung der Ausgabe verwenden
-N, --exclude-schema=SCHEMA das/die angegebene(n) Schema(s) NICHT ausgeben
-O, --no-owner Wiederherstellung der Objekteigentümerschaft
auslassen
-O, --no-owner Wiederherstellung der Objekteigentümerschaft im
»plain text«-Format auslassen
-P, --function=NAME(args) benannte Funktion wiederherstellen
-S, --superuser=NAME Name des Superusers, um Trigger auszuschalten
-S, --superuser=NAME Superusername für »plain text«-Format
-S, --superuser=NAME Superusername für den Dump
-T, --exclude-table=TABELLE die angegebene(n) Tabelle(n) NICHT ausgeben
-T, --trigger=NAME benannten Trigger wiederherstellen
-U, --username=NAME Datenbankbenutzername
-V, --version Versionsinformationen anzeigen, dann beenden
-V, --version Versionsinformationen anzeigen, dann beenden
-W, --password nach Passwort fragen (sollte automatisch geschehen)
-Z, --compress=0-9 Komprimierungsniveau für komprimierte Formate
-a, --data-only nur Daten ausgeben, nicht das Schema
-a, --data-only nur Daten, nicht das Schema, wiederherstellen
-b, --blobs Large Objects mit ausgeben
-c, --clean Datenbankobjekte vor der Wiedererstellung löschen
-c, --clean Datenbanken vor der Wiedererstellung löschen
-d, --dbname=VERBDG mit angegebenen Verbindungsparametern verbinden
-d, --dbname=DBNAME auszugebende Datenbank
-d, --dbname=NAME mit angegebener Datenbank verbinden
-e, --exit-on-error bei Fehler beenden, Voreinstellung ist fortsetzen
-f, --file=DATEINAME Name der Ausgabedatei
-f, --file=DATEINAME Name der Ausgabedatei oder des -verzeichnisses
-f, --file=DATEINAME Name der Ausgabedatei (- für stdout)
-g, --globals-only nur globale Objekte ausgeben, keine Datenbanken
-h, --host=HOSTNAME Name des Datenbankservers oder Socket-Verzeichnis
-j, --jobs=NUM so viele parallele Jobs zur Sicherung verwenden
-j, --jobs=NUM so viele parallele Jobs zur Wiederherstellung
verwenden
-l, --database=DBNAME alternative Standarddatenbank
-l, --list Inhaltsverzeichnis für dieses Archiv anzeigen
-n, --schema=NAME nur Objekte in diesem Schema wiederherstellen
-n, --schema=SCHEMA nur das/die angegebene(n) Schema(s) ausgeben
-o, --oids OIDs mit ausgeben
-p, --port=PORT Portnummer des Datenbankservers
-r, --roles-only nur Rollen ausgeben, keine Datenbanken oder
Tablespaces
-s, --schema-only nur das Schema, nicht die Daten, ausgeben
-s, --schema-only nur das Schema, nicht die Daten, wiederherstellen
-t, --table=NAME benannte Relation (Tabelle, Sicht, usw.)
wiederherstellen
-t, --table=TABELLE nur die angegebene(n) Tabelle(n) ausgeben
-t, --tablespaces-only nur Tablespaces ausgeben, keine Datenbanken oder
Rollen
-v, --verbose »Verbose«-Modus
-v, --verbose »Verbose«-Modus
-w, --no-password niemals nach Passwort fragen
-x, --no-privileges Zugriffsprivilegien (grant/revoke) nicht ausgeben
-x, --no-privileges Wiederherstellung der Zugriffsprivilegien auslassen
%s %s gibt eine Datenbank als Textdatei oder in anderen Formaten aus.
%s gibt einen PostgreSQL-Datenbankcluster in eine SQL-Skriptdatei aus.
%s stellt eine PostgreSQL-Datenbank wieder her, die mit pg_dump
gesichert wurde.
%s: %s Die Anweisung war: %s
%s: WSAStartup fehlgeschlagen: %d
%s: --single-transaction und mehrere Jobs können nicht zusammen verwendet werden
%s: konnte nicht mit der Datenbank »%s« verbinden
%s: konnte nicht mit der Datenbank »%s« verbinden: %s %s: konnte nicht mit Datenbank »postgres« oder »template1« verbinden
Bitte geben Sie eine alternative Datenbank an.
%s: konnte Version des Servers nicht ermitteln
%s: konnte die Ausgabedatei »%s« nicht öffnen: %s
%s: konnte ACL-Zeichenkette (%s) für Datenbank »%s« nicht interpretieren
%s: konnte ACL-Zeichenkette (%s) für Tablespace »%s« nicht interpretieren
%s: konnte Versionszeichenkette »%s« nicht entziffern
%s: konnte die Ausgabedatei »%s« nicht neu öffnen: %s
%s: Ausgabe der Datenbank »%s«...
%s: führe %s aus
%s: ungültige Anzahl paralleler Jobs
%s: maximale Anzahl paralleler Jobs ist %d
%s: Option --if-exists benötigt Option -c/--clean
%s: Optionen -c/--clean und -a/--data-only können nicht zusammen verwendet werden
%s: Optionen -d/--dbname und -f/--file können nicht zusammen verwendet werden
%s: Optionen -g/--globals-only und -r/--roles-only können nicht zusammen verwendet werden
%s: Optionen -g/--globals-only und -t/--tablespaces-only können nicht zusammen verwendet werden
%s: Optionen -r/--roles-only und -t/--tablespaces-only können nicht zusammen verwendet werden
%s: Optionen -s/--schema-only und -a/--data-only können nicht zusammen verwendet werden
%s: pg_dump für Datenbank »%s« fehlgeschlagen; beende
%s: Anfrage fehlgeschlagen: %s %s: Anfrage war: %s
%s: mit »pg_« anfangender Rollenname übersprungen (%s)
%s: führe »%s« aus
%s: zu viele Kommandozeilenargumente (das erste ist »%s«)
%s: unbekannter Abschnittsname: »%s«
(Die INSERT-Anweisung kann OIDs nicht setzen.)
(Die Systemkataloge sind wahrscheinlich verfälscht.)
-C und -1 sind inkompatible Optionen
COPY fehlgeschlagen für Tabelle »%s«: %s Führen Sie einen vollen Dump statt eines Dumps mit --data-only durch, um dieses Problem zu vermeiden.
Ausgabe des Inhalts der Tabelle »%s« fehlgeschlagen: PQgetCopyData() fehlgeschlagen.
Ausgabe des Inhalts der Tabelle »%s« fehlgeschlagen: PQgetResult() fehlgeschlagen.
Fehler in Inhaltsverzeichniseintrag %d; %u %u %s %s %s
Fehlermeldung vom Server: %s Fehler in Phase FINALIZING:
Fehler in Phase INITIALIZING:
Fehler in Phase PROCESSING TOC:
Exportierte Snapshots werden in dieser Serverversion nicht unterstützt.
HINWEIS: Es gibt zirkuläre Fremdschlüssel-Constraints für diese Tabelle:
HINWEIS: Es gibt zirkuläre Fremdschlüssel-Constraints zwischen diesen Tabellen:
Passwort: Berichten Sie Fehler an <pgsql-bugs@postgresql.org>.
Synchronisierte Snapshots werden von dieser Serverversion nicht unterstützt.
Verwenden Sie --no-synchronized-snapshots, wenn Sie keine synchronisierten
Snapshots benötigen.
Synchronisierte Snapshots werden auf Standby-Servern nicht unterstützt.
Verwenden Sie --no-synchronized-snapshots, wenn Sie keine synchronisierten
Snapshots benötigen.
Inhaltsverzeichniseintrag %s bei %s (Länge %s, Prüfsumme %d)
Die Anweisung war: %s
Das Programm »pg_dump« wird von %s benötigt, aber wurde nicht im
selben Verzeichnis wie »%s« gefunden.
Prüfen Sie Ihre Installation.
Das Programm »pg_dump« wurde von »%s« gefunden,
aber war nicht die gleiche Version wie %s.
Prüfen Sie Ihre Installation.
Versuchen Sie »%s --help« für weitere Informationen.
Aufruf:
WARNUNG: Aggregatfunktion %s konnte für diese Datenbankversion nicht korrekt ausgegeben werden - ignoriert
WARNUNG: Archiv ist komprimiert, aber diese Installation unterstützt keine Komprimierung -- keine Daten verfügbar
WARNUNG: Archivelemente nicht in richtiger Abschnittsreihenfolge
WARNUNG: Archiv wurde auf einer Maschine mit größeren Integers erstellt; einige Operationen könnten fehlschlagen
WARNUNG: unsinnige Transformationsdefinition, mindestens eins von trffromsql und trftosql sollte nicht null sein
WARNUNG: unsinniger Wert in Feld pg_cast.castfunc oder pg_cast.castmethod
WARNUNG: unsinniger Wert in Feld pg_cast.castmethod
WARNUNG: unsinniger Wert in Feld pg_transform.trffromsql
WARNUNG: unsinniger Wert in Feld pg_transform.trftosql
WARNUNG: unsinniger Wert in proargmodes-Array
WARNUNG: konnte Operator mit OID %s nicht finden
WARNUNG: konnte nicht bestimmen, wo IF EXISTS in die Anweisung »%s« eingefügt werden soll
WARNUNG: konnte proallargtypes-Array nicht interpretieren
WARNUNG: konnte proargmodes-Array nicht interpretieren
WARNUNG: konnte proargnames-Array nicht interpretieren
WARNUNG: konnte proconfig-Array nicht interpretieren
WARNUNG: konnte reloptions-Array nicht interpretieren
WARNUNG: konnte Abhängigkeitsschleife zwischen diesen Elementen nicht auflösen:
WARNUNG: kann Eigentümer für Objekttyp »%s« nicht setzen
WARNUNG: bei Wiederherstellung ignorierte Fehler: %d
WARNUNG: erwartete Dateiposition stimmt nicht mit ftell überein -- benutze ftell
WARNUNG: ungültiges Erstellungsdatum im Kopf
WARNUNG: ungültiger Typ »%c« für Zugriffsmethode »%s«
WARNUNG: Zeile ignoriert: %s
WARNUNG: Eigentümer der Aggregatfunktion »%s« scheint ungültig zu sein
WARNUNG: Eigentümer des Datentypen »%s« scheint ungültig zu sein
WARNUNG: Eigentümer der Funktion »%s« scheint ungültig zu sein
WARNUNG: Eigentümer des Operatoren »%s« scheint ungültig zu sein
WARNUNG: Eigentümer der Operatorklasse »%s« scheint ungültig zu sein
WARNUNG: Eigentümer der Operatorfamilie »%s« scheint ungültig zu sein
WARNUNG: Eigentümer des Schemas »%s« scheint ungültig zu sein
WARNUNG: Eigentümer der Tabelle »%s« scheint ungültig zu sein
WARNUNG: Komprimierung ist in dieser Installation nicht verfügbar -- Archiv wird nicht komprimiert
WARNUNG: typtype des Datentypen »%s« scheint ungültig zu sein
WARNUNG: unerwartete zusätzliche Ergebnisse während COPY von Tabelle »%s«
Möglicherweise kann der Dump nur wiederhergestellt werden, wenn --disable-triggers verwendet wird oder die Constraints vorübergehend entfernt werden.
ein Arbeitsprozess endete unerwartet
Abbruch wegen unpassender Serverversion
tatsächliche Dateilänge (%s) stimmt nicht mit erwarteter Länge (%s) überein
erstelle AH für %s, Format %d
bereits mit einer Datenbank verbunden
Archivierer Archivierer (DB) versuche Archivformat zu ermitteln
ungültige DumpId
ungültige Tabellen-DumpId für »TABLE DATA«-Eintrag
nur Eingabearchive können neu geöffnet werden
kann NULL-Zeiger nicht kopieren (interner Fehler)
kann komprimiertes Archiv nicht wiederherstellen (Komprimierung in dieser Installation nicht unterstützt)
Kindprozess hat mit Code %d beendet Kindprozess hat mit unbekanntem Status %d beendet Kindprozess wurde durch Ausnahme 0x%X beendet Kindprozess wurde von Signal %d beendet: %s Befehl ist nicht ausführbar Befehl nicht gefunden compress_io Komprimierung ist im Tar-Format nicht unterstützt
Komprimierungsniveau muss im Bereich 0..9 sein
Kompressor ist aktiv
verbinde mit der Datenbank zur Wiederherstellung
verbinde mit neuer Datenbank »%s«
Verbindung zur Datenbank »%s« fehlgeschlagen: %s beschädigter Tar-Kopf in %s gefunden (%d erwartet, %d berechnet), Dateiposition %s
konnte nicht in Verzeichnis »%s« wechseln: %s konnte Inhaltsverzeichnisdatei nicht schließen: %s
konnte Archivdatei nicht schließen: %s
konnte Komprimierungsbibliothek nicht schließen: %s
konnte Komprimierungsstrom nicht schließen: %s
konnte Datendatei »%s« nicht schließen: %s
konnte Verzeichnis »%s« nicht schließen: %s
konnte Eingabedatei nicht schließen: %s
konnte Large-Object-Inhaltsverzeichnisdatei »%s« nicht schließen: %s
konnte Ausgabedatei nicht schließen: %s
konnte Tar-Mitglied nicht schließen
konnte temporäre Datei nicht schließen: %s
konnte Datenbanktransaktion nicht beenden konnte Daten nicht komprimieren: %s
konnte Kommunikationskanäle nicht erzeugen: %s
konnte Verzeichnis »%s« nicht erzeugen: %s
konnte Large Object %u nicht erstellen: %s konnte Arbeitsprozess nicht erzeugen: %s
konnte Positionszeiger in Archivdatei nicht ermitteln: %s
konnte Anfrage nicht ausführen konnte kein »%s« zum Ausführen finden konnte Block-ID %d nicht im Archiv finden -- möglicherweise beschädigtes Archiv
konnte Block-ID %d nicht im Archiv finden -- möglicherweise wegen Wiederherstellung außer der Reihe, was wegen fehlender Datenoffsets im Archiv nicht möglich ist
konnte Block-ID %d nicht im Archiv finden -- möglicherweise wegen Wiederherstellung außer der Reihe, was nicht möglich ist, weil die Eingabedatei kein Suchen unterstützt
konnte Eintrag für ID %d nicht finden
konnte Datei »%s« nicht im Archiv finden
konnte Funktionsdefinition für Funktion mit OID %u nicht finden
konnte Kopf für Datei »%s« im Tar-Archiv nicht finden
konnte Erweiterung, zu der %s %s gehört, nicht finden
konnte Slot des beendeten Arbeitsprozesses nicht finden
konnte keine temporären Dateinamen erzeugen: %s
konnte server_version nicht von libpq ermitteln
konnte aktuelles Verzeichnis nicht ermitteln: %s konnte Abhängigkeitsschleife nicht bestimmen
konnte Komprimierungsbibliothek nicht initialisieren: %s
konnte Sperre für Relation »%s« nicht setzen
Das bedeutet meistens, dass jemand eine ACCESS-EXCLUSIVE-Sperre auf die Tabelle gesetzt hat, nachdem der pg-dump-Elternprozess die anfängliche ACCESS-SHARE-Sperre gesetzt hatte.
konnte Inhaltsverzeichnisdatei »%s« nicht zur Eingabe öffnen: %s
konnte Inhaltsverzeichnisdatei »%s« nicht zur Ausgabe öffnen: %s
konnte Inhaltsverzeichnisdatei »%s« nicht öffnen: %s
konnte Inhaltsverzeichnisdatei nicht zur Eingabe öffnen: %s
konnte Inhaltsverzeichnisdatei nicht zur Ausgabe öffnen: %s
konnte Eingabedatei »%s« nicht öffnen: %s
konnte Eingabedatei nicht öffnen: %s
konnte Large Object %u nicht öffnen: %s konnte Large-Object-Inhaltsverzeichnisdatei »%s« nicht zur Eingabe öffnen: %s
konnte Ausgabedatei »%s« nicht öffnen: %s
konnte Ausgabedatei nicht öffnen: %s
konnte temporäre Datei nicht öffnen
konnte GRANT-ACL-Liste (%s) oder REVOKE-ACL-Liste (%s) für Objekt »%s« (%s) nicht interpretieren
konnte Vorgabe-ACL-Liste (%s) nicht interpretieren
konnte initiale GRANT-ACL-Liste (%s) oder initiale REVOKE-ACL-Liste (%s) für Objekt »%s« (%s) nicht interpretieren
konnte numerisches Array »%s« nicht parsen: ungültiges Zeichen in Zahl
konnte numerisches Array »%s« nicht parsen: zu viele Zahlen
konnte Ergebnis von current_schemas() nicht interpretieren
konnte Programmdatei »%s« nicht lesen konnte Verzeichnis »%s« nicht lesen: %s
konnte nicht aus Eingabedatei lesen: %s
konnte nicht aus Eingabedatei lesen: Dateiende
konnte Eingabedatei nicht lesen: %s
konnte symbolische Verknüpfung »%s« nicht lesen konnte default_tablespace nicht auf »%s« setzen: %s konnte default_with_oids nicht setzen: %s konnte search_path nicht auf »%s« setzen: %s konnte Positionszeiger in Archivdatei nicht setzen: %s
konnte Sitzungsbenutzer nicht auf »%s« setzen: %s konnte Datenbanktransaktion nicht starten konnte Daten nicht dekomprimieren: %s
konnte nicht in Blobs-Inhaltsverzeichnisdatei schreiben
konnte Large Object nicht schreiben (Ergebnis: %lu, erwartet: %lu)
konnte nicht in Ausgabedatei schreiben: %s
konnte nicht in den Kommunikationskanal schreiben: %s
erstelle %s »%s«
erstelle %s »%s.%s«
Custom-Archivierer Definition der Sicht »%s« scheint leer zu sein (Länge null)
magische Zeichenkette im Dateikopf nicht gefunden
direkte Datenbankverbindungen sind in Archiven vor Version 1.3 nicht unterstützt
Verzeichnis »%s« scheint kein gültiges Archiv zu sein (»toc.dat« existiert nicht)
Verzeichnis-Archivierer Verzeichnisname zu lang: »%s«
schalte Trigger für %s aus
entferne %s %s
gebe Inhalt der Tabelle »%s.%s« aus
schalte Trigger für %s ein
Eintritt in Hauptparallelschleife
Eintritt in restore_toc_entries_parallel
Eintritt in restore_toc_entries_postfork
Eintritt in restore_toc_entries_prefork
ID %d des Eintrags außerhalb des gültigen Bereichs -- vielleicht ein verfälschtes Inhaltsverzeichnis
Fehler bei der Sicherung
Fehler beim Suchen in Datei: %s
Fehler beim Verarbeiten eines parallelen Arbeitselements
Fehler beim Lesen von Large Object %u: %s Fehler beim Lesen von Large-Object-Inhaltsverzeichnisdatei »%s«
Fehler in PQputCopyData: %s Fehler in PQputCopyEnd: %s führe %s %s aus
%d Check-Constraint für Tabelle %s erwartet, aber %d gefunden
%d Check-Constraints für Tabelle %s erwartet, aber %d gefunden
erwartetes Format (%d) ist nicht das gleiche wie das in der Datei gefundene (%d)
Sanity-Check fehlgeschlagen, Eltern-OID %u von Tabelle »%s« (OID %u) nicht gefunden
Sanity-Check fehlgeschlagen, Elterntabelle mit OID %u von pg_rewrite-Eintrag mit OID %u nicht gefunden
Sanity-Check fehlgeschlagen, Elterntabelle mit OID %u von Sequenz mit OID %u nicht gefunden
Verbinden zur Datenbank schlug fehl
Dateiname zu lang: »%s«
Dateioffset in Dumpdatei ist zu groß
finde Check-Constraints für Tabelle »%s.%s«
finde DEFAULT-Ausdrücke von Tabelle »%s.%s«
finde Erweiterungstabellen
lese Vererbungsbeziehungen
finde Spalten und Typen von Tabelle »%s.%s«
Element %d %s %s abgeschlossen
Hauptparallelschleife beendet
markiere vererbte Spalten in abgeleiteten Tabellen
unerwartete Block-ID (%d) beim Lesen der Daten gefunden -- erwartet wurde %d
Funktion »%s« nicht gefunden
identifiziere Erweiterungselemente
implizit werden nur Daten wiederhergestellt
unvollständiger Tar-Dateikopf gefunden (%lu Byte)
unvollständiger Tar-Dateikopf gefunden (%lu Bytes)
Index »%s« nicht gefunden
Eingabedatei ist anscheinend ein Dump im Textformat. Bitte verwenden Sie psql.
Eingabedatei scheint kein gültiges Archiv zu sein
Eingabedatei scheint kein gültiges Archiv zu sein (zu kurz?)
Eingabedatei ist zu kurz (gelesen: %lu, erwartet: 5)
interner Fehler -- WriteData kann nicht außerhalb des Kontexts einer DataDumper-Routine aufgerufen werden
interner Fehler -- weder th noch fh in tarReadRaw() angegeben
ungültiger ENCODING-Eintrag: %s
ungültige Oid für Large Object
Large Object hat ungültige Oid (%u)
ungültiger STDSTRINGS-Eintrag: %s
ungültiger adnum-Wert %d für Tabelle »%s«
fehlerhafte Argumentzeichenkette (%s) für Trigger »%s« von Tabelle »%s«
ungültige Programmdatei »%s« ungültige Clientkodierung »%s« angegeben
ungültige Spaltennummer %d in Tabelle »%s«
ungültige Spaltennummerierung in Tabelle »%s«
ungültiger Komprimierungscode: %d
ungültige Abhängigkeit %d
ungültige dumpId %d
ungültige Zeile in Large-Object-Inhaltsverzeichnisdatei »%s«: %s
ungültige Nachricht vom Arbeitsprozess empfangen: »%s«
ungültige Anzahl paralleler Jobs
ungültiges Ausgabeformat »%s« angegeben
Large-Object-Ausgabe im gewählten Format nicht unterstützt
letzte eingebaute OID ist %u
starte Element %d %s %s
fehlender Index für Constraint »%s«
bewege Position von %s auf nächstes Mitglied bei Position %s
kein Element bereit
keine passenden Schemas gefunden
keine passenden Schemas für Muster »%s« gefunden
keine passenden Tabellen gefunden
keine passenden Tabellen für Muster »%s« gefunden
kein Ausgabeverzeichnis angegeben
nicht mit zlib-Unterstützung gebaut
jetzt bei Dateiposition %s
Option --if-exists benötigt Option -c/--clean
Optionen --inserts/--column-inserts und -o/--oids können nicht zusammen verwendet werden
Optionen -c/--clean und -a/--data-only können nicht zusammen verwendet werden
Optionen -s/--schema-only und -a/--data-only können nicht zusammen verwendet werden
Speicher aufgebraucht
on_exit_nicely-Slots aufgebraucht
paralleler Archivierer parallele Sicherung wird nur vom Ausgabeformat »Verzeichnis« unterstützt
parallele Wiederherstellung aus einer Datei, die kein Suchen ermöglicht, wird nicht unterstützt
parallele Wiederherstellung aus der Standardeingabe wird nicht unterstützt
parallele Wiederherstellung wird mit Archiven, die mit pg_dump vor 8.0 erstellt worden sind, nicht unterstützt
parallele Wiederherstellung wird von diesem Archivdateiformat nicht unterstützt
pclose fehlgeschlagen: %s pgpipe: konnte Verbindung nicht annehmen: Fehlercode %d
pgpipe: konnte nicht binden: Fehlercode %d
pgpipe: konnte Socket nicht verbinden: Fehlercode %d
pgpipe: konnte zweites Socket nicht erzeugen: Fehlercode %d
pgpipe: konnte Socket nicht erzeugen: Fehlercode %d
pgpipe: konnte nicht auf Socket hören: Fehlercode %d
pgpipe: getsockname() fehlgeschlagen: Fehlercode %d
verarbeite %s
verarbeite Daten für Tabelle »%s.%s«
verarbeite Element %d %s %s
verarbeite verpasstes Element %d %s %s
Anfrage fehlgeschlagen: %s Anfrage ergab NULL als Name der Tabelle auf die sich Fremdschlüssel-Trigger »%s« von Tabelle »%s« bezieht (OID der Tabelle: %u)
Anfrage ergab %d Zeile anstatt einer: %s
Anfrage ergab %d Zeilen anstatt einer: %s
Anfrage nach Daten der Sequenz %s ergab %d Zeile (erwartete 1)
Anfrage nach Daten der Sequenz %s ergab %d Zeilen (erwartete 1)
Anfrage nach Daten der Sequenz %s ergab Name »%s«
Anfrage nach Regel »%s« der Tabelle »%s« fehlgeschlagen: falsche Anzahl Zeilen zurückgegeben
Anfrage um die Definition der Sicht »%s« zu ermitteln lieferte mehr als eine Definition
Anfrage um die Definition der Sicht »%s« zu ermitteln lieferte keine Daten
Anfrage war: %s
Inhaltsverzeichniseintrag %d (ID %d) von %s %s gelesen
lese Spalteninfo für interessante Tabellen
lese Constraints
lese Vorgabeprivilegien
lese Abhängigkeitsdaten
lese Ereignistrigger
lese Erweiterungen
lese Fremdschlüssel-Constraints von Tabelle »%s.%s«
lese Indexe
lese Indexe von Tabelle »%s.%s«
lese Large Objects
lese Policies
lese prozedurale Sprachen
lese Umschreiberegeln
lese Policys für Sicherheit auf Zeilenebene
lese Schemas
lese Tabellenvererbungsinformationen
lese Transformationen
lese Trigger
lese Trigger von Tabelle »%s.%s«
lese Typumwandlungen
lese benutzerdefinierte Zugriffsmethoden
lese benutzerdefinierte Aggregatfunktionen
lese benutzerdefinierte Sortierfolgen
lese benutzerdefinierte Konversionen
lese benutzerdefinierte Fremdserver
lese benutzerdefinierte Fremddaten-Wrapper
lese benutzerdefinierte Funktionen
lese benutzerdefinierte Operatorklassen
lese benutzerdefinierte Operatorfamilien
lese benutzerdefinierte Operatoren
lese benutzerdefinierte Tabellen
lese benutzerdefinierte Textsuchekonfigurationen
lese benutzerdefinierte Textsuchewörterbücher
lese benutzerdefinierte Textsuche-Parser
lese benutzerdefinierte Textsuche-Templates
lese benutzerdefinierte Typen
Wiederverbindung zur Datenbank »%s« fehlgeschlagen: %s reduziere Abhängigkeiten für %d
%d Large Object wiederhergestellt
%d Large Objects wiederhergestellt
Ausgabe der Daten in anderer Reihenfolge wird in diesem Archivformat nicht unterstützt: »%s« wird benötigt, aber es kommt vor »%s« in der Archivdatei.
Wiederherstellung von Large Object mit OID %u
Prüfung der Integer-Größe (%lu) fehlgeschlagen
sichere Datenbankdefinition
sichere Kodierung = %s
sichere Large Objects
sichere search_path = %s
sichere standard_conforming_strings = %s
Schema »%s« nicht gefunden
Schema mit OID %u existiert nicht
select() fehlgeschlagen: %s
Serverversion muss mindestens 7.3 sein um Schemas auswählen zu können
Version des Servers: %s; Version von %s: %s
Element %d %s %s wird übersprungen
Tar-Mitglied %s übersprungen
Sortierer Tabelle »%s« konnte nicht erzeugt werden, ihre Daten werden nicht wiederhergestellt werden
Tabelle »%s« nicht gefunden
Tar-Archivierer dieses Format kann nicht gelesen werden
übertrage Abhängigkeit %d -> %d an %d
Trigger »%s« nicht gefunden
unerwartete Syntax der COPY-Anweisung: »%s«
unerwartete Datenoffsetmarkierung %d
unerwarteter Policy-Befehlstyp: »%s«
unerwarteter Abschnittscode %d
unerwarteter tgtype-Wert: %d
unbekanntes Archivformat »%s«; bitte »c«, »d« oder »t« angeben
unbekannter Befehl vom Master empfangen: »%s«
unbekannter Constraint-Typ: %c
unerkannter Datenblocktyp %d beim Wiederherstellen des Archivs gefunden
unerkannter Datenblocktyp (%d) beim Suchen im Archiv gefunden
nicht erkannte Kodierung »%s«
nicht erkanntes Dateiformat »%d«
unbekannter Objekttyp in den Vorgabeprivilegien: %d
ungültiger proparallel-Wert für Funktion »%s«
ungültiger provolatile-Wert für Funktion »%s«
nicht unterstützte Version (%d.%d) im Dateikopf
Warnung aus der ursprünglichen Ausgabedatei: %s
Arbeitsprozess fehlgeschlagen: Code %d
%lu Byte Large-Object-Daten geschrieben (Ergebnis = %lu)
%lu Bytes Large-Object-Daten geschrieben (Ergebnis = %lu)
locale/de/LC_MESSAGES/psql-9.6.mo 0000644 00000302005 14751153420 0012010 0 ustar 00 �� : �! � �C XZ YZ oZ �Z � �Z D[ `[
y[ �[ > �[ = �[ < \ p R\ s �\ 5 7] 7 m] K �] o �] 2 a^ 4 �^ N �^ t _ Q �_ O �_ > /` A n` O �` @ a 6 Aa 0 xa N �a G �a 8 @b A yb T �b ? c L Pc A �c @ �c H d A id + �d � �d 5 me 9 �e n �e Q Lf : �f � �f ; fg y �g � h ; �h z �h T oi A �i L j B Sj \ �j 4 �j J (k \ sk 6 �k 4 l G <l = �l ; �l ( �l ; 'm ; cm ; �m ; �m 8 n _ Pn J �n F �n ` Bo h �o G p 5 Tp 2 �p X �p Q q : hq 3 �q ; �q S r M gr 9 �r @ �r 8 0s ; is @ �s K �s J 2t | }t � �t > �u F �u N v F Uv H �v - �v $ w & 8w - _w 9 �w 7 �w 2 �w 4 2x 3 gx ) �x ) �x ; �x B +y ) ny * �y * �y J �y 1 9z . kz - �z , �z 4 �z I *{ $ t{ & �{ > �{ 1 �{ & 1| ( X| J �| : �| ( } % 0} $ V} $ {} ) �} - �} N �} 9 G~ G �~ 5 �~ M �~ C M P � K � N .� K }� L ɀ 4 � K K� ( �� q �� A 2� ? t� A �� > �� � 5� # � F � 8 O� < �� M Ņ ; � 6 O� 2 �� 7 �� B � : 4� 4 o� 9 �� ? އ % � + D� 9 p� 5 �� I � K *� M v� Z ĉ S � K s� � �� N J� @ �� : ڋ ( � B >� L �� C Ό � � M �� = � � M� � � � "� 5� 9� M� ]� 0 e� $ �� # �� * ߏ %
� * 0� [� # |� < �� ݐ �� � 6 1� h� � }� : #� ^� p� |� �� �� �� �� ̒ ޒ Q � B� I V� [ ��
�� � �
-� 8� V� C c� A �� � �� �� � � $� +� , =� j� �� �� �� �� �� �� ̕ � ��
� � � '� ' 4� \� & z� ' �� 7 ɖ 0 � 2� N� ^� q� �� �� �� �� w �� %� 6� K� Q� k� ( �� �� �� ˘ Ԙ �
� #� 8� Q� ]� f� o� �� �� �� ��
�� Ù ə ̙ ֙
ܙ � � � � � �
,� :�
L� Z� & g� �� ��
��
�� ɚ ܚ �
� � 0� D� W� i� y� �� �� �� ݛ � � � 0�
B� P� `� % q� �� " �� Μ � � )� ' ?� & g� �� �� �� �� ˝ ՝
ڝ � L � A� P� n� > �� ʞ ߞ � 2
� =� D� W� k� �� �� �� �� ȟ ߟ �� X � m� v� �� ��
�� ˠ � ' � . � ! D� ' f� �� �� ��
�� ʡ � �� � :� Z� i� z� , �� �� Ģ Т ߢ � � � !� E (� n� ~� �� �� ��
�� �� �� �� ƣ ң ޣ �� � � � $� .� B�
H� V� r�
�� �� �� �� �� ͤ � � !
� /� G� 9 b� y �� 9 � F P� 5 �� B ͦ C � 5 T� : �� 9 ŧ @ �� ; @� K |� B Ȩ C � 6 O� 8 �� �� ۩ �
�� � � (�
.� 9� U� t� �� �� �� & �� � �� � � � ,� � # � # &� # J� n� " �� �� �� Ǭ ެ � �
�� � � �
)� c 4� � �� Y� K v� Q ® / � O D� U �� 5 � = � ^� , j� 4 �� " ̰ ! � � 1� >� Y� " u� + �� + ı 6 � X '� 7 �� 8 �� T � 5 F� I |� 6 Ƴ # �� = !� = _� = �� i ۴ 9 E� � �� * �� � � � @� S� Z� ^� m� �� �� �� �� �� �� ϶ # � � &� $ ?� d�
w� �� �� �� �� �� ��
�� Ʒ > з � � (� 9� C� K� Q� C ^� �� / �� ( � � � (� :� Q� ' m� �� $ �� % ٹ ! �� ) !� ( K� / t� # �� ' Ⱥ , � . � 4 L� �� ! �� - û � % � 4 8� 1 m� - �� / ͼ " �� � ' @� h� . �� ) �� % � ! � $ )� * N� + y� A �� � � & � 0 '� . X� - �� �� % Ŀ �
�
�� � # � 3� @� R� d� p� |� �� �� �� �� C �� � #� 9� C� [� k� {� ��
�� �� $ �� & � - � # 9� ]� 1 ~� ( �� ) �� + � ' /� ! W� y� # �� ! �� ( �� � � 9� V� t� �� �� �� �� ��
�� �� �
� !� .� >� Y� y� �� �� �� �� �� � $� @� ! [� }� �� 2 �� �� �� � *� G� h� 2 �� 5 �� �� �� � . 2� a� & y� # �� �� ! �� � � 2� D� ]� 6 ~� ) �� ��
�� �� �� � � .�
;� & I� p� �� �� �� �� �� �� �� �� ��
� �
� )� U 6� �� �� �� , �� �� �� � ,� ?�
S� ^� m� y� �� �� �� �� �� " ��
�� �� �� � � '�
B� 1 P� �� ��
�� �� �� �� . �� � . $�
S� a� k� q� �� ��
�� �� E �� �
� !� 3� B� Q� X� m� u� �� �� �� * �� ��
�� � � � )� 3� 9� C�
T� _� h� r� �� �� �� �� �� �� �� �� � � � "� '� 9�
B� P� W� ^� q� z� % �� �� �� �� �� �� �� �� � � $� 3� <� F�
O� Z� d� s� � �� �� �� �� �� �� �� �� �� �� �� � � � � $� 3�
C� Q� X�
j� x� �� �� �� �� �� �� �� �� �� �� � � #� ! -� 4 O�
�� �� . �� �� �� �� �� � � � 2�
;�
I�
W� e� x� �� �� �� �� " �� �� � 0� B� ]� z� / �� �� �� �� �� " � (� H� d� �� �� * ��
�� �� �� � -� E� Y� i� |� �� 0 �� + �� � � � > %�
d� o� ) {� " �� �� ��
�� �� ��
� #� (� 2� 7� G� V� e� q� v�
}� ��
��
�� �� �� �� 7 �� 2 � 6 ?� V v� �� & �� & �� . !� P� \� l�
}�
�� �� �� �� �� �� �� �� �� � � � ! *� L� T� f� s�
�� �� �� �� �� . �� � � � )�
F� Q� a� s� � �� �� �� �� ��
�� �� �� �� �� � � � <� Z� d� h� $ �� # �� �� �� 0 �� � � 5� <� S� ( g� �� �� �� �� �� �� �� �� �� �� � � , '� T� l� �� $ �� �� ' �� � #� B� \� t� �� �� ! �� �� �� �
� � (� � ,� �� �� �� � � �� �� �� � E � G d� H �� � �� � �� > 0� A o� M �� � �� 5 �� R �� o &� � �� P 6� T �� E �� H "� O k� > �� 5 �� C 0� E t� q �� G ,� O t� �� I D� O �� J �� H )� u r� I �� 4 2� � g� 8 �� B 7� � z� s � : �� � �� 2 �� � �� � U� ? *� z j� o � : U� Q �� @ � x #� ; �� P � � )� : �� 7 � C $� 9 h� 7 �� , � ; � 7 C� 7 {� 9 �� - � t � = �� H � W � n o� : � 8 � . R� � �� F � 8 J� 9 �� > �� � �� S � @ � J B a < � H � I * w t � � � s 5 J : L � F � p 4 � ; � , � 1 ( < Z ; � 3 � 5 8 = 1 v . � C � H 6 d / � 0 � o � 6 l / � 1 � 7
6 =
P t
* �
* �
? ; [ + � . � u � O h - � , � *
+ >
1 j
3 �
S �
< $ L a = � J � I 7 = � x � w 8 r � R # 6 v L � / � v * N � D � ^ 5 @ � � � & � t � 0 % L V E � @ � 4 * 0 _ B � B � 3 : J > � I � , ' ; < c 8 � p � s J F � ] I c q � � s � G + A s , � I � s , J � � � I � i � v ! ,! J! M! _! c! w! �! = �! . �! * �! - &" - T" 0 �" ( �" ) �" G # ( N# w# # �# E �# �# � $ : �$ �$ % % &% ;% G% X% m% �% [ �% �% K & \ P& �& �& �&
�& ) �& ' V !' Y x' �' �' �' (
( ( !( . 4( c( �( �( �(
�( �( �( �( �( )
) +) 8) =) + L) x) ( �) $ �) 4 �) , * F* e* {* �* �*
�* �* �* � �* �+ �+ �+ �+ �+ / , 3, @, S, d, $ �, �, �, �,
�, �,
- - &- =- S- h- p- }- �- �- �- �- �- �- �- �- �- �- �- .
.
#. 8 1. j. r.
�.
�. �. �. �. �. �. / / 6/ K/ a/ t/ �/ �/ �/ �/ % �/ 0 '0 <0 Q0 b0 t0 �0 �0 " �0 ! �0 1 1 :1 4 X1 3 �1 �1 �1 �1 �1 �1 2 2 2 %2 h 82 �2 % �2 ( �2 U 3 V3 r3 �3 0 �3 �3 �3 �3 4 )4 94 B4 ]4 m4 y4 * �4 �4 | �4 Y5 - b5 �5 �5
�5 % �5 �5 / �5 7 +6 3 c6 ; �6 �6 $ �6 7
7 7 17 P7 n7 $ �7 �7 �7 �7 5 �7 &8 78 C8 O8
U8 `8 ) �8 �8 Z �8
9 9
$9 /9 A9
H9 S9 _9 g9 n9 x9 �9 �9
�9 �9
�9 �9 �9 �9 �9 : & 1:
X: c: v: {: �: �: �: �: �: �: ; ; .; � j; = < J E< : �< T �< Q = : r= 8 �= : �= ? !> : a> T �> R �> O D? 8 �? @ �? & @ 5@ D@ Y@ m@ �@ �@ �@ �@ �@ �@ *
A 5A >A 8 GA �A �A �A $ �A �A �B % C & 'C # NC rC * �C �C �C * �C
D D !D
&D 1D 9D ID ZD } gD �D / �E a F f xF ; �F g G l �G G �G ? 8H xH 9 �H : �H % I / 'I WI xI �I �I " �I 0 �I 2 J N HJ e �J ; �J A 9K ^ {K @ �K \ L ; xL ) �L A �L A M > bM m �M = N MN , kN < �N �N " �N O 6O JO QO UO bO sO yO �O �O �O # �O ' �O 1 �O $P & CP 1 jP �P �P �P �P �P �P �P �P �P �P D Q JQ SQ `Q oQ xQ �Q �Q S �Q �Q 2 �Q < .R kR ~R �R �R % �R , �R # S ) 2S 2 \S $ �S ) �S ) �S 0 T % 9T ) _T 3 �T 1 �T C �T " 3U $ VU . {U $ �U ' �U 3 �U 2 +V - ^V - �V % �V ! �V . W " 1W - TW - �W ( �W " �W & �W + #X , OX B |X �X �X # �X 1 �X - *Y + XY �Y & �Y �Y
�Y �Y �Y ( �Y Z %Z 8Z JZ
VZ
aZ oZ �Z �Z �Z V �Z % [ 7[ R[ \[ t[ �[ % �[ �[
�[ �[ 4 �[ / \ 4 G\ * |\ ( �\ A �\ 0 ] 0 C] 7 t] 1 �] - �] ' ^ ( 4^ 2 ]^ 7 �^ $ �^ �^ # _ 7 /_ & g_ �_ �_ $ �_ �_ �_
�_ $ �_ ` *` 9` I` # `` $ �` ! �` �` �` " a .a ( Ja % sa ! �a �a ( �a b "b C >b ) �b �b " �b # �b ' c # :c L ^c B �c �c & d 0d = Ld �d * �d ( �d % �d $ %e " Je me �e �e ) �e 8 �e 3 &f Zf
bf mf tf �f �f �f
�f 1 �f g g g
*g 8g Ug ig }g �g �g
�g �g �g �g j �g Qh `h ih 0 yh % �h # �h �h i !i 9i Bi Si `i ii {i
�i �i �i , �i �i
�i �i j j (j
Fj & Tj {j �j �j �j �j �j B �j ,k 5 <k rk k �k �k
�k �k �k �k F �k l
*l 8l Dl Sl cl jl
�l �l �l �l �l / �l (m
0m
;m Im
Zm
hm sm
ym �m
�m �m
�m �m �m �m �m
�m �m & n ;n Jn Yn `n
tn n �n �n
�n �n �n �n �n �n . o =o Wo so �o
�o �o �o �o �o �o
�o p
p #p 0p =p Np [p `p ' tp �p �p �p �p
�p �p �p
�p �p q q q q q -q =q Jq Qq fq |q �q �q �q �q
�q �q �q �q �q r r 4r >r ) Hr ; rr �r �r / �r �r s
s "s 2s Cs Ms
fs
qs
s �s �s # �s �s t t 5t $ Kt pt ! �t �t # �t ! �t
u F (u ou �u �u �u $ �u ! �u v /v Nv kv 6 �v �v �v �v w 'w Fw `w uw �w �w > �w / x 7x ?x Lx B Tx �x �x / �x ) �x y y #y
/y :y ; Gy �y �y �y �y �y
�y
�y �y �y
�y �y z
z
%z 0z
:z K Hz 3 �z 7 �z U { V{ ( i{ - �{ : �{ �{ | | +| ;| G| V| c| l| u| || �|
�| �| �| �| , �|
} } +} 7}
G} R} [} r} �} F �} �} �} �} ~ /~ <~ L~ ^~ h~ p~ x~ }~ �~ �~ �~ �~ �~ �~ �~ % �~ 7 ? C ( d % � � � < � � 7 � G� ! N� p� ; �� ŀ Ҁ � � � � � � � 4� E� V� 9 ^� ! �� % �� ' � ' � 0� - P� , ~� ' �� % ӂ " �� * � ! G� ' i� , �� �� ƃ � � � n J � � � � � � � � ) B 5 � L ( ; $ � � � ] k e ( � � � % � � � k � 7 , � � � � � / v � � �
z � T q < � v � | � � z � � � 3 � g y � � M 2 Z � � e i
* � C � � < & � � � ) Q 6 � 9 � & � T � � s � � / t � � A Y u � 0 � � � � t � - , � � � � J s ~ r � F p R � � � � � � N 3 � D � S � � Q � y � c � � � E w ` m � � � � M � , � _ U � X b + 4 ` � � � � w � � � o < � � � � [ � - . � � � 7 � y j 5 � � & � = � U l � � � � g � � Y ( � � ] � f x � } � � � " � � � T � v 0 X \ � H � b 1 � � � # � k K � � : � � � 1 � 2 * ] W � � � $ � u C � I h V x S � � � � H f � 7 [ Q � 7 � � � j c � � � � � � � � / 4 � � � 2 � � � � P r � � � i a h �
� � � � � � � � � � N � � � � 9 p w � � � o > � � R . � � ) � � � � � g 8 > L ' � � c � z x � � � U x E � G � � � � � � Y � � B � � � � � ~ � � � � � v l 8 = C � 2 � � � o � [ � � 6 � r � � � � " � ? u t � u M a � � � � � p Z � ; � � � � g h � � 9 1 � � + � � j � � � G � � � � � � | � q K � � \ � � � � � _ � O E Z i B m � � � q � � 9 K � � 5 � . � � � � O } - $ � � � G � � ( � { X � M
� � � n � ! � � r � h # � � � � [ � � � J 1 I 4 � �
P � � � � � � k � � � � � 0 � � W 5 P � " ` N O V p � I � � : t � & m 0 � W f @ � b : 7 ; R B H � L ] � � T � � � � 8 � d F � � ~ @ � � � 0 4 � � > ! � � � Q % * � o & A y � L $ � � � { = � ~ ! ^ � ! @ � � : C F � � � � � 8 V ' � � n $ � � \ � � � � � � � = - n � � � X � A \ � � _ a R �
' W D ^ j w " � � � � � � N � � � � � � � A � � l # � � � � � _ � � { O F Y 2 d � � f ? � � � e } # { � � % E � � � � � � � # + ) H ? q | � , * � � � : � � � � � �
b � < � - � I 6 ( ^ � ; � % �
|
� � D . � s @ � � � � � � a 3 � � / ' � � ' 1 � s 9 � � � ! c � ? � � � / " J � d � � � � � � � � 3 � � > % � ) � � � 4 � l � � 3 � � � � � 8 � � � . � U � � � � * � � � � � � 6 � K ,
� � m � � � � i � S ^ � � ` � � V 6 P � G } � � S � D d + Z � � � � z � � � � � + � � � 5 e
Connection options:
Display settings:
Environment variables:
For more information, type "\?" (for internal commands) or "\help" (for SQL
commands) from within psql, or consult the psql section in the PostgreSQL
documentation.
Input and output options:
Output format options:
Parser: "%s"
Parser: "%s.%s" --help=commands list backslash commands, then exit
--help=variables list special variables, then exit
(options: S = show system objects, + = additional detail)
-0, --record-separator-zero
set record separator for unaligned output to zero byte
-1 ("one"), --single-transaction
execute as a single transaction (if non-interactive)
-?, --help[=options] show this help, then exit
-A, --no-align unaligned table output mode
-E, --echo-hidden display queries that internal commands generate
-F, --field-separator=STRING
field separator for unaligned output (default: "%s")
-H, --html HTML table output mode
-L, --log-file=FILENAME send session log to file
-P, --pset=VAR[=ARG] set printing option VAR to ARG (see \pset command)
-R, --record-separator=STRING
record separator for unaligned output (default: newline)
-S, --single-line single-line mode (end of line terminates SQL command)
-T, --table-attr=TEXT set HTML table tag attributes (e.g., width, border)
-U, --username=USERNAME database user name (default: "%s")
-V, --version output version information, then exit
-W, --password force password prompt (should happen automatically)
-X, --no-psqlrc do not read startup file (~/.psqlrc)
-a, --echo-all echo all input from script
-b, --echo-errors echo failed commands
-c, --command=COMMAND run only single command (SQL or internal) and exit
-d, --dbname=DBNAME database name to connect to (default: "%s")
-e, --echo-queries echo commands sent to server
-f, --file=FILENAME execute commands from file, then exit
-h, --host=HOSTNAME database server host or socket directory (default: "%s")
-l, --list list available databases, then exit
-n, --no-readline disable enhanced command line editing (readline)
-o, --output=FILENAME send query results to file (or |pipe)
-p, --port=PORT database server port (default: "%s")
-q, --quiet run quietly (no messages, only query output)
-s, --single-step single-step mode (confirm each query)
-t, --tuples-only print rows only
-v, --set=, --variable=NAME=VALUE
set psql variable NAME to VALUE
(e.g., -v ON_ERROR_STOP=1)
-w, --no-password never prompt for password
-x, --expanded turn on expanded table output
-z, --field-separator-zero
set field separator for unaligned output to zero byte
AUTOCOMMIT if set, successful SQL commands are automatically committed
COLUMNS number of columns for wrapped format
COMP_KEYWORD_CASE determines the case used to complete SQL key words
[lower, upper, preserve-lower, preserve-upper]
DBNAME the currently connected database name
ECHO controls what input is written to standard output
[all, errors, none, queries]
ECHO_HIDDEN if set, display internal queries executed by backslash commands;
if set to "noexec", just show without execution
ENCODING current client character set encoding
FETCH_COUNT the number of result rows to fetch and display at a time
(default: 0=unlimited)
HISTCONTROL controls command history [ignorespace, ignoredups, ignoreboth]
HISTFILE file name used to store the command history
HISTSIZE the number of commands to store in the command history
HOST the currently connected database server host
IGNOREEOF if unset, sending an EOF to interactive session terminates application
LASTOID value of the last affected OID
NAME=VALUE [NAME=VALUE] psql ...
or \setenv NAME [VALUE] inside psql
ON_ERROR_ROLLBACK if set, an error doesn't stop a transaction (uses implicit savepoints)
ON_ERROR_STOP stop batch execution after error
PAGER name of external pager program
PGAPPNAME same as the application_name connection parameter
PGDATABASE same as the dbname connection parameter
PGHOST same as the host connection parameter
PGPASSFILE password file name
PGPASSWORD connection password (not recommended)
PGPORT same as the port connection parameter
PGUSER same as the user connection parameter
PORT server port of the current connection
PROMPT1 specifies the standard psql prompt
PROMPT2 specifies the prompt used when a statement continues from a previous line
PROMPT3 specifies the prompt used during COPY ... FROM STDIN
PSQLRC alternative location for the user's .psqlrc file
PSQL_EDITOR, EDITOR, VISUAL
editor used by the \e, \ef, and \ev commands
PSQL_EDITOR_LINENUMBER_ARG
how to specify a line number when invoking the editor
PSQL_HISTORY alternative location for the command history file
QUIET run quietly (same as -q option)
SHELL shell used by the \! command
SHOW_CONTEXT controls display of message context fields [never, errors, always]
SINGLELINE end of line terminates SQL command mode (same as -S option)
SINGLESTEP single-step mode (same as -s option)
TMPDIR directory for temporary files
USER the currently connected database user
VERBOSITY controls verbosity of error reports [default, verbose, terse]
\! [COMMAND] execute command in shell or start interactive shell
\? [commands] show help on backslash commands
\? options show help on psql command-line options
\? variables show help on special variables
\C [STRING] set table title, or unset if none
\H toggle HTML output mode (currently %s)
\T [STRING] set HTML <table> tag attributes, or unset if none
\a toggle between unaligned and aligned output mode
\c[onnect] {[DBNAME|- USER|- HOST|- PORT|-] | conninfo}
connect to new database (currently "%s")
\c[onnect] {[DBNAME|- USER|- HOST|- PORT|-] | conninfo}
connect to new database (currently no connection)
\cd [DIR] change the current working directory
\conninfo display information about current connection
\copy ... perform SQL COPY with data stream to the client host
\copyright show PostgreSQL usage and distribution terms
\crosstabview [COLUMNS] execute query and display results in crosstab
\dA[+] [PATTERN] list access methods
\dC[+] [PATTERN] list casts
\dD[S+] [PATTERN] list domains
\dE[S+] [PATTERN] list foreign tables
\dF[+] [PATTERN] list text search configurations
\dFd[+] [PATTERN] list text search dictionaries
\dFp[+] [PATTERN] list text search parsers
\dFt[+] [PATTERN] list text search templates
\dL[S+] [PATTERN] list procedural languages
\dO[S+] [PATTERN] list collations
\dT[S+] [PATTERN] list data types
\d[S+] list tables, views, and sequences
\d[S+] NAME describe table, view, sequence, or index
\da[S] [PATTERN] list aggregates
\db[+] [PATTERN] list tablespaces
\dc[S+] [PATTERN] list conversions
\dd[S] [PATTERN] show object descriptions not displayed elsewhere
\ddp [PATTERN] list default privileges
\des[+] [PATTERN] list foreign servers
\det[+] [PATTERN] list foreign tables
\deu[+] [PATTERN] list user mappings
\dew[+] [PATTERN] list foreign-data wrappers
\df[antw][S+] [PATRN] list [only agg/normal/trigger/window] functions
\dg[S+] [PATTERN] list roles
\di[S+] [PATTERN] list indexes
\dl list large objects, same as \lo_list
\dm[S+] [PATTERN] list materialized views
\dn[S+] [PATTERN] list schemas
\do[S+] [PATTERN] list operators
\dp [PATTERN] list table, view, and sequence access privileges
\drds [PATRN1 [PATRN2]] list per-database role settings
\ds[S+] [PATTERN] list sequences
\dt[S+] [PATTERN] list tables
\du[S+] [PATTERN] list roles
\dv[S+] [PATTERN] list views
\dx[+] [PATTERN] list extensions
\dy[+] [PATTERN] list event triggers
\e [FILE] [LINE] edit the query buffer (or file) with external editor
\echo [STRING] write string to standard output
\ef [FUNCNAME [LINE]] edit function definition with external editor
\encoding [ENCODING] show or set client encoding
\errverbose show most recent error message at maximum verbosity
\ev [VIEWNAME [LINE]] edit view definition with external editor
\f [STRING] show or set field separator for unaligned query output
\g [FILE] or ; execute query (and send results to file or |pipe)
\gexec execute query, then execute each value in its result
\gset [PREFIX] execute query and store results in psql variables
\h [NAME] help on syntax of SQL commands, * for all commands
\i FILE execute commands from file
\ir FILE as \i, but relative to location of current script
\l[+] [PATTERN] list databases
\lo_export LOBOID FILE
\lo_import FILE [COMMENT]
\lo_list
\lo_unlink LOBOID large object operations
\o [FILE] send all query results to file or |pipe
\p show the contents of the query buffer
\password [USERNAME] securely change the password for a user
\prompt [TEXT] NAME prompt user to set internal variable
\pset [NAME [VALUE]] set table output option
(NAME := {border|columns|expanded|fieldsep|fieldsep_zero|
footer|format|linestyle|null|numericlocale|pager|
pager_min_lines|recordsep|recordsep_zero|tableattr|title|
tuples_only|unicode_border_linestyle|
unicode_column_linestyle|unicode_header_linestyle})
\q quit psql
\qecho [STRING] write string to query output stream (see \o)
\r reset (clear) the query buffer
\s [FILE] display history or save it to file
\set [NAME [VALUE]] set internal variable, or list all if no parameters
\setenv NAME [VALUE] set or unset environment variable
\sf[+] FUNCNAME show a function's definition
\sv[+] VIEWNAME show a view's definition
\t [on|off] show only rows (currently %s)
\timing [on|off] toggle timing of commands (currently %s)
\unset NAME unset (delete) internal variable
\w FILE write query buffer to file
\watch [SEC] execute query every SEC seconds
\x [on|off|auto] toggle expanded output (currently %s)
\z [PATTERN] same as \dp
border border style (number)
columns target width for the wrapped format
expanded (or x) expanded output [on, off, auto]
fieldsep field separator for unaligned output (default "%s")
fieldsep_zero set field separator for unaligned output to zero byte
footer enable or disable display of the table footer [on, off]
format set output format [unaligned, aligned, wrapped, html, asciidoc, ...]
linestyle set the border line drawing style [ascii, old-ascii, unicode]
null set the string to be printed in place of a null value
numericlocale enable or disable display of a locale-specific character to separate
groups of digits [on, off]
pager control when an external pager is used [yes, no, always]
psql --pset=NAME[=VALUE]
or \pset NAME [VALUE] inside psql
psql --set=NAME=VALUE
or \set NAME VALUE inside psql
psql [OPTION]... [DBNAME [USERNAME]]
recordsep record (line) separator for unaligned output
recordsep_zero set record separator for unaligned output to zero byte
set NAME=VALUE
psql ...
or \setenv NAME [VALUE] inside psql
tableattr (or T) specify attributes for table tag in html format or proportional
column widths for left-aligned data types in latex-longtable format
title set the table title for any subsequently printed tables
tuples_only if set, only actual table data is shown
unicode_border_linestyle
unicode_column_linestyle
unicode_header_linestyle
set the style of Unicode line drawing [single, double]
"%s.%s" is not a view
%d connection %d connections %s %s %s (every %gs)
%s
%s (%s, server %s)
%s (every %gs)
%s: %s
%s: -1 can only be used in non-interactive mode
%s: cannot copy from/to a directory
%s: could not delete variable "%s"
%s: could not find own program executable
%s: could not open log file "%s": %s
%s: could not set printing parameter "%s"
%s: could not set variable "%s"
%s: current transaction is aborted
%s: invalid encoding name or conversion procedure not found
%s: not connected to a database
%s: out of memory
%s: unknown transaction status
%s: warning: extra command-line argument "%s" ignored
(%lu row) (%lu rows) ***(Single step mode: verify command)*******************************************
%s
***(press return to proceed or enter x and return to cancel)********************
********* QUERY **********
%s
**************************
+ opt(%d) = |%s|
, clustered , deferrable , initially deferred , invalid , predicate (%s) , replica identity , tablespace "%s" Access privileges All connection parameters must be supplied because no database connection exists
Argument data types Asynchronous notification "%s" received from server process with PID %d.
Asynchronous notification "%s" with payload "%s" received from server process with PID %d.
Attributes Available help:
Border style is %d.
Bypass RLS COPY data transfer failed: %s Call Handler Cannot add cell to table content: total cell count of %d exceeded.
Cannot add header to table content: column count of %d exceeded.
Cannot login Check Check constraints: Child tables Collate Column Column privileges Command: %s
Description: %s
Syntax:
%s
Composite type "%s.%s" Connection
Create DB Create role Ctype Database Default access privileges Default footer is off.
Default footer is on.
Default? Definition Description Destination Dictionaries Did not find any extension named "%s".
Did not find any extensions.
Did not find any relation named "%s".
Did not find any relation with OID %s.
Did not find any text search configuration named "%s".
Did not find any text search parser named "%s".
Disabled internal triggers: Disabled rules: Disabled triggers: Disabled user triggers: Elements Enabled Encoding End parse Enter data to be copied followed by a newline.
End with a backslash and a period on a line by itself, or an EOF signal. Enter it again: Enter new password: Event Expanded display is off.
Expanded display is on.
Expanded display is used automatically.
FDW Options FDW Options: (%s) Failed.
Field separator is "%s".
Field separator is zero byte.
Foreign table "%s.%s" Foreign-data wrapper Foreign-key constraints: Formatting
Function General
General options:
Get headline Get next token Get token types Handler Has OIDs: yes Help
ID Implicit? Index Index "%s.%s" Indexes: Informational
Inherits Init Init options Inline Handler Input/Output
Internal Language Internal name Interrupted
Invalid command \%s. Try \? for help.
Language Large Objects
Large objects Left arg type Lexize Line style is %s.
List of access methods List of aggregate functions List of casts List of collations List of conversions List of data types List of databases List of domains List of event triggers List of foreign servers List of foreign tables List of foreign-data wrappers List of functions List of installed extensions List of languages List of operators List of relations List of roles List of schemas List of settings List of specially treated variables
List of tablespaces List of text search configurations List of text search dictionaries List of text search parsers List of text search templates List of user mappings Locale-adjusted numeric output is off.
Locale-adjusted numeric output is on.
Location Materialized view "%s.%s" Member of Method Modifier Modifiers Name No changes No connections No help available for "%s".
Try \h with no arguments to see available help.
No inheritance No matching relations found.
No matching settings found.
No per-database role settings support in this server version.
No relations found.
No settings found.
Null display is "%s".
Number of child tables: %d (Use \d+ to list them.) Object Object Description Object descriptions Objects in extension "%s" Operating System
Options Output format is %s.
Owned by: %s Owner Pager is always used.
Pager is used for long output.
Pager usage is off.
Pager won't be used for less than %d line.
Pager won't be used for less than %d lines.
Parallel Password encryption failed.
Password for user %s: Password valid until Password: Passwords didn't match.
Policies Policies (forced row security enabled): Policies (forced row security enabled): (none) Policies (row security disabled): Policies (row security enabled): (none) Policies: Previous connection kept
Procedure Query Buffer
Query buffer is empty. Query buffer reset (cleared). Record separator is "%s".
Record separator is <newline>.
Record separator is zero byte.
Referenced by: Replica Identity Replication Report bugs to <pgsql-bugs@postgresql.org>.
Result data type Result type Right arg type Role Role name Rules firing always: Rules firing on replica only: Rules: SSL connection (protocol: %s, cipher: %s, bits: %s, compression: %s)
STATEMENT: %s
Schema Security Sequence "%s.%s" Server Server: %s Settings Size Source Source code Source type Special relation "%s.%s" Start parse Stats target Storage Succeeded.
Superuser TOAST table "%s.%s" Table Table "%s.%s" Table attributes are "%s".
Table attributes unset.
Tablespace Tablespace: "%s" Tags Target type Target width is %d.
Target width is unset.
Template Text search configuration "%s" Text search configuration "%s.%s" Text search parser "%s" Text search parser "%s.%s" The connection to the server was lost. Attempting reset: The input is a PostgreSQL custom-format dump.
Use the pg_restore command-line client to restore this dump to a database.
The server (version %s) does not support access methods.
The server (version %s) does not support altering default privileges.
The server (version %s) does not support collations.
The server (version %s) does not support editing function source.
The server (version %s) does not support editing view definitions.
The server (version %s) does not support extensions.
The server (version %s) does not support foreign servers.
The server (version %s) does not support foreign tables.
The server (version %s) does not support foreign-data wrappers.
The server (version %s) does not support full text search.
The server (version %s) does not support savepoints for ON_ERROR_ROLLBACK.
The server (version %s) does not support showing function source.
The server (version %s) does not support showing view definitions.
The server (version %s) does not support tablespaces.
The server (version %s) does not support user mappings.
There is no previous error. Time: %.3f ms
Timing is off. Timing is on. Title is "%s".
Title is unset.
Token Token name Token types for parser "%s" Token types for parser "%s.%s" Triggers firing always: Triggers firing on replica only: Triggers: Trusted Try "%s --help" for more information.
Tuples only is off.
Tuples only is on.
Type Type "help" for help.
Type: \copyright for distribution terms
\h for help with SQL commands
\? for help with psql commands
\g or terminate with semicolon to execute query
\q to quit
Typed table of type: %s Unicode border line style is "%s".
Unicode column line style is "%s".
Unicode header line style is "%s".
Unlogged index "%s.%s" Unlogged materialized view "%s.%s" Unlogged table "%s.%s" Usage:
Use "\q" to leave %s.
User name Validator Value Variables
Version View "%s.%s" View definition: Volatility WARNING: %s major version %s, server major version %s.
Some psql features might not work.
WARNING: Console code page (%u) differs from Windows code page (%u)
8-bit characters might not work correctly. See psql reference
page "Notes for Windows users" for details.
Wrote history to file "%s".
You are connected to database "%s" as user "%s" on host "%s" at port "%s".
You are connected to database "%s" as user "%s" via socket in "%s" at port "%s".
You are currently not connected to a database.
You are now connected to database "%s" as user "%s" on host "%s" at port "%s".
You are now connected to database "%s" as user "%s" via socket in "%s" at port "%s".
You are now connected to database "%s" as user "%s".
You are using psql, the command-line interface to PostgreSQL. \!: failed
\%s: could not change directory to "%s": %s
\%s: environment variable name must not contain "="
\%s: error while setting variable
\%s: extra argument "%s" ignored
\%s: missing required argument
\connect: %s \copy: arguments required
\copy: parse error at "%s"
\copy: parse error at end of line
\crosstabview: ambiguous column name: "%s"
\crosstabview: column name not found: "%s"
\crosstabview: column number %d is out of range 1..%d
\crosstabview: data column must be specified when query returns more than three columns
\crosstabview: maximum number of columns (%d) exceeded
\crosstabview: query must return at least three columns
\crosstabview: query result contains multiple data values for row "%s", column "%s"
\crosstabview: statement did not return a result set
\crosstabview: vertical and horizontal headers must be different columns
\df does not take a "w" option with server version %s
\df only takes [antwS+] as options
\pset: allowed Unicode border line styles are single, double
\pset: allowed Unicode column line styles are single, double
\pset: allowed Unicode header line styles are single, double
\pset: allowed formats are unaligned, aligned, wrapped, html, asciidoc, latex, latex-longtable, troff-ms
\pset: allowed line styles are ascii, old-ascii, unicode
\pset: unknown option: %s
\watch cannot be used with COPY
\watch cannot be used with an empty query
abbreviated_grant_or_revoke abort the current transaction aborted because of read failure access_method_type action agg aggregate_name aggregate_signature alias alignment allowconn always analyze_function and aggregate_signature is: and conflict_action is one of: and grouping_element can be one of: and like_option is: and table_constraint is: and table_constraint_using_index is: and with_query is: arg_data_type arg_name arg_type argmode argname argtype argument argument_type arguments attempt to \gset into specially treated variable "%s" ignored
attribute attribute_name attribute_option base_type boolean cache call_handler cancel a transaction that was earlier prepared for two-phase commit canceled by user cannot duplicate null pointer (internal error)
cannot escape without active connection
canonical_function category change a database change a database role change a run-time parameter change a server configuration parameter change role name or membership change the definition of a collation change the definition of a conversion change the definition of a domain change the definition of a foreign server change the definition of a foreign table change the definition of a foreign-data wrapper change the definition of a function change the definition of a large object change the definition of a materialized view change the definition of a procedural language change the definition of a row level security policy change the definition of a rule change the definition of a schema change the definition of a sequence generator change the definition of a table change the definition of a tablespace change the definition of a text search configuration change the definition of a text search dictionary change the definition of a text search parser change the definition of a text search template change the definition of a trigger change the definition of a type change the definition of a user mapping change the definition of a view change the definition of an aggregate function change the definition of an event trigger change the definition of an extension change the definition of an index change the definition of an operator change the definition of an operator class change the definition of an operator family change the ownership of database objects owned by a database role channel check_expression child process exited with exit code %d child process exited with unrecognized status %d child process was terminated by exception 0x%X child process was terminated by signal %d: %s close a cursor cluster a table according to an index code collatable collate %s collation collect statistics about a database column_alias column_constraint column_definition column_name column_type com_op combinefunc command command not executable command not found commit a transaction that was earlier prepared for two-phase commit commit the current transaction compute a set of rows condition configuration_parameter conflict_action conflict_target connection to server was lost
connlimit constraint constraint_name copy data between a file and a table could not change directory to "%s": %s could not close pipe to external command: %s
could not execute command "%s": %s
could not find a "%s" to execute could not get home directory for user ID %ld: %s
could not identify current directory: %s could not locate temporary directory: %s
could not look up effective user ID %ld: %s could not open temporary file "%s": %s
could not parse reloptions array
could not read binary "%s" could not read from input file: %s
could not read symbolic link "%s" could not save history to file "%s": %s
could not set variable "%s"
could not start /bin/sh
could not start editor "%s"
could not stat file "%s": %s
could not write COPY data: %s
count create a new database create new rows in a table cursor_name data_type database_name deallocate a prepared statement default default %s default_expr define a cursor define a new access method define a new aggregate function define a new cast define a new collation define a new data type define a new database role define a new domain define a new encoding conversion define a new event trigger define a new foreign server define a new foreign table define a new foreign-data wrapper define a new function define a new index define a new mapping of a user to a foreign server define a new materialized view define a new operator define a new operator class define a new operator family define a new procedural language define a new rewrite rule define a new row level security policy for a table define a new savepoint within the current transaction define a new schema define a new sequence generator define a new table define a new table from the results of a query define a new tablespace define a new text search configuration define a new text search dictionary define a new text search parser define a new text search template define a new transform define a new trigger define a new view define access privileges define default access privileges define or change a security label applied to an object define or change the comment of an object definer definition delete delete rows of a table delimiter delimiter_character deserialfunc dest_encoding destroy a previously defined savepoint dictionary_name direction directory disabled discard session state domain constraint domain_constraint domain_name element empty a table or set of tables enabled encoding encoding_name end_function environment variable PSQL_EDITOR_LINENUMBER_ARG must be set to specify a line number
escape_character event exclude_element exclude_element in an EXCLUDE constraint is: execute a prepared statement execute an anonymous code block execution_cost existing_collation existing_enum_value expression extension_name family_name fdw_name ffunc filename filter_value filter_variable for table "%s.%s" force a transaction log checkpoint foreign table format_name from_item from_sql_function_name function function name is required
function_name garbage-collect and optionally analyze a database generate a notification gettoken_function group_name grouping_element handler_function headline_function history is not supported by this installation
immutable import table definitions from a foreign server in assignment increment index index_column_name index_expression index_method index_name index_parameters index_parameters in UNIQUE, PRIMARY KEY, and EXCLUDE constraints are: index_predicate init_function initial_condition inline_handler input_function insert install an extension integer internallength invalid binary "%s" invalid command \%s
invalid line number: %s
invalid output format (internal error): %d invoker istemplate join_column join_condition join_proc join_type label lang_name large_object_oid lc_collate lc_ctype left_type lexize_function lextypes_function like_option like_type link_symbol listen for a notification load a shared library file local socket local_schema locale lock a table lockmode loid materialized view maxvalue member_object method mffunc minitial_condition minvalue minvfunc more than one row returned for \gset
msfunc mstate_data_size mstate_data_type name neg_op new_attribute_name new_column_name new_constraint_name new_dictionary new_enum_value new_name new_owner new_role new_schema new_table new_tablespace new_version no no query buffer
no rows returned for \gset
normal not null null_string obj_file object_name off old_dictionary old_role old_version on op_type opclass operator operator class operator family operator_name option or the old syntax out of memory out of memory
output_expression output_function output_name parameter parent_table parser_name password payload pclose failed: %s policy_name position a cursor predicate preferred prepare a statement for execution prepare the current transaction for two-phase commit primary key, provider psql is the PostgreSQL interactive terminal.
psql variables:
query quote_character rebuild indexes receive_function refcolumn referenced_table_name reftable relation_name remote_schema remove a cast remove a collation remove a conversion remove a data type remove a database remove a database role remove a domain remove a foreign server descriptor remove a foreign table remove a foreign-data wrapper remove a function remove a materialized view remove a procedural language remove a rewrite rule remove a row level security policy from a table remove a schema remove a sequence remove a table remove a tablespace remove a text search configuration remove a text search dictionary remove a text search parser remove a text search template remove a transform remove a trigger remove a user mapping for a foreign server remove a view remove access privileges remove an access method remove an aggregate function remove an event trigger remove an extension remove an index remove an operator remove an operator class remove an operator family remove database objects owned by a database role replace the contents of a materialized view replica res_proc restart restore the value of a run-time parameter to the default value restricted result_rows retrieve rows from a query using a cursor retrieve rows from a table or view rettype rewrite_rule_name right_type role_name role_specification roll back to a savepoint rule rule_name safe sampling_method savepoint_name schema_element schema_name seed select send_function sequence sequence_name serialfunc server_name server_type server_version set constraint check timing for the current transaction set the characteristics of the current transaction set the current user identifier of the current session set the session user identifier and the current user identifier of the current session sfunc show the execution plan of a statement show the value of a run-time parameter skipping recursive expansion of variable "%s"
snapshot_id sort_expression sort_family_name sort_operator source_config source_encoding source_table source_type special stable start start a transaction block start_function state_data_size state_data_type statement stop listening for a notification storage storage_parameter storage_type strategy_number sub-SELECT subtype subtype_diff_function subtype_operator_class support_number tab completion query failed: %s
Query was:
%s
table table constraint table_constraint table_constraint_using_index table_name tablespace_name tablespace_option target_role target_type template text timestamp timezone to_sql_function_name token_type transaction_id transaction_mode trigger trigger_name trying to exit copy mode type type_modifier_input_function type_modifier_output_function type_name uid unexpected PQresultStatus: %d
unexpected result status for \watch
unexpected transaction status (%d)
unique, unknown unrecognized value "%s" for "%s"; assuming "%s"
unsafe unterminated quoted string
update update rows of a table user does not exist user name lookup failure: error code %lu user_name using_expression valfunction validator_function value values version view view name is required
view_option_name view_option_value volatile where abbreviated_grant_or_revoke is one of: where action is one of: where aggregate_signature is: where column_constraint is: where conflict_target can be one of: where constraint is: where direction can be empty or one of: where event can be one of: where from_item can be one of: where lockmode is one of: where member_object is: where option can be one of: where option can be: where role_specification can be: where transaction_mode is one of: window window_definition window_name with_query with_query_name yes Project-Id-Version: PostgreSQL 9.6
Report-Msgid-Bugs-To: pgsql-bugs@postgresql.org
POT-Creation-Date: 2021-11-06 17:04+0000
PO-Revision-Date: 2021-01-13 10:08+0100
Last-Translator: Peter Eisentraut <peter_e@gmx.net>
Language-Team: German <peter_e@gmx.net>
Language: de
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Plural-Forms: nplurals=2; plural=n != 1;
Verbindungsoptionen:
Anzeigeeinstellungen:
Umgebungsvariablen:
Für mehr Informationen, geben Sie »\?« (für interne Anweisungen) oder
»\help« (für SQL-Anweisungen) in psql ein oder schauen Sie in den psql-
Abschnitt der PostgreSQL-Dokumentation.
Eingabe- und Ausgabeoptionen:
Ausgabeformatoptionen:
Parser: »%s«
Parser: »%s.%s« --help=commands Backslash-Befehle auflisten, dann beenden
--help=variables besondere Variablen auflisten, dann beenden
(Optionen: S = Systemobjekte zeigen, + = zusätzliche Details zeigen)
-0, --record-separator-zero
Satztrennzeichen für unausgerichteten Ausgabemodus auf
Null-Byte setzen
-1 (»eins«), --single-transaction
als eine einzige Transaktion ausführen (wenn nicht
interaktiv)
-?, --help[=options] diese Hilfe anzeigen, dann beenden
-A, --no-align unausgerichteter Tabellenausgabemodus
-E, --echo-hidden von internen Anweisungen erzeugte Anfragen zeigen
-F, --field-separator=ZEICHEN
Feldtrennzeichen für unausgerichteten Ausgabemodus
(Standard: »%s«)
-H, --html HTML-Tabellenausgabemodus
-L, --log-file=DATEINAME
Sitzungslog in Datei senden
-P, --pset=VAR[=ARG] Ausgabeoption VAR auf ARG setzen (siehe
\pset-Anweisung)
-R, --record-separator=ZEICHEN
Satztrennzeichen für unausgerichteten Ausgabemodus
(Standard: Newline)
-S, --single-line Einzelzeilenmodus (Zeilenende beendet SQL-Anweisung)
-T, --table-attr=TEXT HTML »table«-Tag-Attribute setzen (z.B. width, border)
-U, --username=NAME Datenbank-Benutzername (Standard: »%s«)
-V, --version Versionsinformationen anzeigen, dann beenden
-W, --password nach Passwort fragen (sollte automatisch geschehen)
-X, --no-psqlrc Startdatei (~/.psqlrc) nicht lesen
-a, --echo-all Skript-Inhalt wiedergeben
-b, --echo-errors fehlgeschlagene Anweisungen wiedergeben
-c, --command=ANWEISUNG einzelne Anweisung ausführen und beenden
-d, --dbname=DBNAME Datenbank, zu der verbunden werden soll
(Standard: »%s«)
-e, --echo-queries an den Server geschickte Anweisungen zeigen
-f, --file=DATEINAME Anweisungen aus Datei ausführen und danach beenden
-h, --host=HOSTNAME Hostname des Datenbankservers oder
Socket-Verzeichnis (Standard: »%s«)
-l, --list verfügbare Datenbanken auflisten und beenden
-n, --no-readline erweiterte Zeilenbearbeitung (Readline) ausschalten
-o, --output=DATEINAME Anfrageergebnisse in Datei (oder |Pipe) senden
-p, --port=PORT Port des Datenbankservers (Standard: »%s«)
-q, --quiet stille Ausführung (keine Mitteilungen, nur
Anfrageergebnisse)
-s, --single-step Einzelschrittmodus (jede Anfrage bestätigen)
-t, --tuples-only nur Datenzeilen ausgeben
-v, --set=, --variable=NAME=WERT
psql-Variable NAME auf WERT setzen
(z.B. -v ON_ERROR_STOP=1)
-w, --no-password niemals nach Passwort fragen
-x, --expanded erweiterte Tabellenausgabe einschalten
-z, --field-separator-zero
Feldtrennzeichen für unausgerichteten Ausgabemodus auf
Null-Byte setzen
AUTOCOMMIT wenn gesetzt werden alle erfolgreichen SQL-Befehle
automatisch committet
COLUMNS Anzahl Spalten im Format »wrapped«
COMP_KEYWORD_CASE bestimmt, ob SQL-Schlüsselwörter in Groß- oder Klein-
schreibung vervollständigt werden
[lower, upper, preserve-lower, preserve-upper]
DBNAME Name der aktuellen Datenbank
ECHO kontrolliert, welche Eingaben auf die Standardausgabe
geschrieben werden [all, errors, none, queries]
ECHO_HIDDEN wenn gesetzt, interne Anfragen, die von Backslash-Befehlen
ausgeführt werden, anzeigen; wenn auf »noexec« gesetzt, nur
anzeigen, nicht ausführen
ENCODING aktuelle Zeichensatzkodierung des Clients
FETCH_COUNT Anzahl auf einmal zu holender und anzuzeigender Zeilen
(Standard: 0=unbegrenzt)
HISTCONTROL kontrolliert Befehlsgeschichte
[ignorespace, ignoredups, ignoreboth]
HISTFILE Dateiname für die Befehlsgeschichte
HISTSIZE Anzahl der in der Befehlsgeschichte zu speichernden Befehle
HOST der aktuell verbundene Datenbankserverhost
IGNOREEOF wenn nicht gesetzt beendet ein EOF in einer interaktiven
Sitzung das Programm
LASTOID Wert der zuletzt beinträchtigten OID
NAME=WERT [NAME=WERT] psql ...
oder \setenv NAME [WERT] innerhalb von psql
ON_ERROR_ROLLBACK wenn gesetzt beendet ein Fehler die Transaktion nicht
(verwendet implizite Sicherungspunkte)
ON_ERROR_STOP Skriptausführung bei Fehler beenden
PAGER Name des externen Pager-Programms
PGAPPNAME wie Verbindungsparameter »application_name«
PGDATABASE wie Verbindungsparameter »dbname«
PGHOST wie Verbindungsparameter »host«
PGPASSFILE Name der Passwortdatei
PGPASSWORD Verbindungspasswort (nicht empfohlen)
PGPORT wie Verbindungsparameter »port«
PGUSER wie Verbindungsparameter »user«
PORT Serverport der aktuellen Verbindung
PROMPT1 der normale psql-Prompt
PROMPT2 der Prompt, wenn eine Anweisung von der vorherigen Zeile
fortgesetzt wird
PROMPT3 der Prompt während COPY ... FROM STDIN
PSQLRC alternativer Pfad für .psqlrc-Datei des Benutzers
PSQL_EDITOR, EDITOR, VISUAL
Editor für Befehle \e, \ef und \ev
PSQL_EDITOR_LINENUMBER_ARG
wie die Zeilennummer beim Aufruf des Editors angegeben wird
PSQL_HISTORY alternativer Pfad für History-Datei
QUIET stille Ausführung (wie Option -q)
SHELL Shell für den Befehl \!
SHOW_CONTEXT kontrolliert die Anzeige von Kontextinformationen in
Meldungen [never, errors, always]
SINGLELINE Zeilenende beendet SQL-Anweisung (wie Option -S)
SINGLESTEP Einzelschrittmodus (wie Option -s)
TMPDIR Verzeichnis für temporäre Dateien
USER der aktuell verbundene Datenbankbenutzer
VERBOSITY kontrolliert wieviele Details in Fehlermeldungen enthalten
sind [default, verbose, terse]
\! [BEFEHL] Befehl in Shell ausführen oder interaktive Shell starten
\? [commands] Hilfe über Backslash-Befehle anzeigen
\? options Hilfe über psql-Kommandozeilenoptionen anzeigen
\? variables Hilfe über besondere Variablen anzeigen
\C [TEXT] Tabellentitel setzen oder löschen
\H HTML-Ausgabemodus umschalten (gegenwärtig %s)
\T [TEXT] HTML <table>-Tag-Attribute setzen oder löschen
\a zwischen unausgerichtetem und ausgerichtetem Ausgabemodus
umschalten
\c[onnect] {[DBNAME|- BENUTZER|- HOST|- PORT|-] | conninfo}
mit neuer Datenbank verbinden (aktuell »%s«)
\c[onnect] {[DBNAME|- BENUTZER|- HOST|- PORT|-] | conninfo}
mit neuer Datenbank verbinden (aktuell keine Verbindung)
\cd [VERZ] Arbeitsverzeichnis wechseln
\conninfo Informationen über aktuelle Verbindung anzeigen
\copy ... SQL COPY mit Datenstrom auf Client-Host ausführen
\copyright PostgreSQL-Urheberrechtsinformationen zeigen
\crosstabview [SPALTEN] Anfrage ausführen und Ergebnisse als Kreuztabelle
anzeigen
\dA[+] [MUSTER] Zugriffsmethoden auflisten
\dC[+] [MUSTER] Typumwandlungen (Casts) auflisten
\dD[S+] [MUSTER] Domänen auflisten
\dE[S+] [MUSTER] Fremdtabellen auflisten
\dF[+] [MUSTER] Textsuchekonfigurationen auflisten
\dFd[+] [MUSTER] Textsuchewörterbücher auflisten
\dFp[+] [MUSTER] Textsucheparser auflisten
\dFt[+] [MUSTER] Textsuchevorlagen auflisten
\dL[S+] [MUSTER] prozedurale Sprachen auflisten
\dO[S+] [MUSTER] Sortierfolgen auflisten
\dT[S+] [MUSTER] Datentypen auflisten
\d[S+] Tabellen, Sichten und Sequenzen auflisten
\d[S+] NAME Tabelle, Sicht, Sequenz oder Index beschreiben
\da[S] [MUSTER] Aggregatfunktionen auflisten
\db[+] [MUSTER] Tablespaces auflisten
\dc[S+] [MUSTER] Konversionen auflisten
\dd[S] [MUSTER] Objektbeschreibungen zeigen, die nirgendwo anders
erscheinen
\ddp [MUSTER] Vorgabeprivilegien auflisten
\des[+] [MUSTER] Fremdserver auflisten
\det[+] [MUSTER] Fremdtabellen auflisten
\deu[+] [MUSTER] Benutzerabbildungen auflisten
\dew[+] [MUSTER] Fremddaten-Wrapper auflisten
\df[antw][S+] [MUSTR] Funktionen [nur Agg/normale/Trigger/Fenster] auflisten
\dg[S+] [MUSTER] Rollen auflisten
\di[S+] [MUSTER] Indexe auflisten
\dl Large Objects auflisten, wie \lo_list
\dm[S+] [MUSTER] materialisierte Sichten auflisten
\dn[S+] [MUSTER] Schemas auflisten
\do[S+] [MUSTER] Operatoren auflisten
\dp [MUSTER] Zugriffsprivilegien für Tabellen, Sichten und
Sequenzen auflisten
\drds [MUSTER1 [MUSTER2]] datenbankspezifische Rolleneinstellungen auflisten
\ds[S+] [MUSTER] Sequenzen auflisten
\dt[S+] [MUSTER] Tabellen auflisten
\du[S+] [MUSTER] Rollen auflisten
\dv[S+] [MUSTER] Sichten auflisten
\dx[+] [MUSTER] Erweiterungen auflisten
\dy[+] [MUSTER] Ereignistrigger auflisten
\e [DATEI] [ZEILE] Anfragepuffer (oder Datei) mit externem Editor bearbeiten
\echo [TEXT] Text auf Standardausgabe schreiben
\ef [FUNKNAME [ZEILE]] Funktionsdefinition mit externem Editor bearbeiten
\encoding [KODIERUNG] Client-Kodierung zeigen oder setzen
\errverbose letzte Fehlermeldung mit vollen Details anzeigen
\ev [SICHTNAME [ZEILE]] Sichtdefinition mit externem Editor bearbeiten
\f [ZEICHEN] Feldtrennzeichen zeigen oder setzen
\g [DATEI] oder ; SQL-Anweisung ausführen (und Ergebnis in Datei oder
|Pipe schreiben)
\gexec Anfrage ausführen, dann jeden Ergebniswert als
Anweisung ausführen
\gset [PREFIX] SQL-Anweisung ausführen und Ergebnis in psql-Variablen
ablegen
\h [NAME] Syntaxhilfe über SQL-Anweisung, * für alle Anweisungen
\i DATEI Befehle aus Datei ausführen
\ir DATEI wie \i, aber relativ zum Ort des aktuellen Skripts
\l[+] [MUSTER] Datenbanken auflisten
\lo_export LOBOID DATEI
\lo_import DATEI [KOMMENTAR]
\lo_list
\lo_unlink LOBOID Large-Object-Operationen
\o [DATEI] alle Anfrageergebnisse in Datei oder |Pipe schreiben
\p aktuellen Inhalt der Anfragepuffers zeigen
\password [BENUTZERNAME]
sicheres Ändern eines Benutzerpasswortes
\prompt [TEXT] NAME interne Variable vom Benutzer abfragen
\pset [NAME [WERT]] Tabellenausgabeoption setzen
(NAME := {border|columns|expanded|fieldsep|fieldsep_zero|
footer|format|linestyle|null|numericlocale|pager|
pager_min_lines|recordsep|recordsep_zero|tableattr|title|
tuples_only|unicode_border_linestyle|
unicode_column_linestyle|unicode_header_linestyle})
\q psql beenden
\qecho [TEXT] Text auf Ausgabestrom für Anfrageergebnisse schreiben
(siehe \o)
\r Anfragepuffer löschen
\s [DATEI] Befehlsgeschichte ausgeben oder in Datei schreiben
\set [NAME [WERT]] interne Variable setzen, oder alle anzeigen
\setenv NAME [WERT] Umgebungsvariable setzen oder löschen
\sf[+] FUNKNAME Funktionsdefinition zeigen
\sv[+] SICHTNAME Sichtdefinition zeigen
\t [on|off] nur Datenzeilen zeigen (gegenwärtig %s)
\timing [on|off] Zeitmessung umschalten (gegenwärtig %s)
\unset NAME interne Variable löschen
\w DATEI Anfragepuffer in Datei schreiben
\watch [SEK] Anfrage alle SEK Sekunden ausführen
\x [on|off|auto] erweiterte Ausgabe umschalten (gegenwärtig %s)
\z [MUSTER] äquivalent zu \dp
border Rahmenstil (Zahl)
columns Zielbreite für das Format »wrapped«
expanded (oder x) erweiterte Ausgabe [on, off, auto]
fieldsep Feldtrennzeichen für unausgerichteten Ausgabemodus
(Standard »%s«)
fieldsep_zero Feldtrennzeichen für unausgerichteten Ausgabemodus auf
Null-Byte setzen
footer Tabellenfußzeile ein- oder auschalten [on, off]
format Ausgabeformat setzen [unaligned, aligned, wrapped, html, asciidoc, ...]
linestyle Rahmenlinienstil setzen [ascii, old-ascii, unicode]
null setzt die Zeichenkette, die anstelle eines NULL-Wertes
ausgegeben wird
numericlocale Verwendung eines Locale-spezifischen Zeichens zur Trennung
von Zifferngruppen ein- oder auschalten [on, off]
pager kontrolliert Verwendung eines externen Pager-Programms
[yes, no, always]
psql --pset=NAME[=WERT]
oder \pset NAME [WERT] innerhalb von psql
psql --set=NAME=WERT
oder \set NAME WERT innerhalb von psql
psql [OPTION]... [DBNAME [BENUTZERNAME]]
recordsep Satztrennzeichen für unausgerichteten Ausgabemodus
recordsep_zero Satztrennzeichen für unausgerichteten Ausgabemodus auf
Null-Byte setzen
set NAME=WERT
psql ...
oder \setenv NAME [WERT] innerhalb von psql
tableattr (or T) Attribute für das »table«-Tag im Format »html« oder
proportionale Spaltenbreite für links ausgerichtete Datentypen
im Format »latex-longtable«
title setzt den Titel darauffolgend ausgegebener Tabellen
tuples_only wenn gesetzt werden nur die eigentlichen Tabellendaten
gezeigt
unicode_border_linestyle
unicode_column_linestyle
unicode_header_linestyle
setzt den Stil für Unicode-Linien [single, double]
»%s.%s« ist keine Sicht
%d Verbindung %d Verbindungen %s %s %s (alle %gs)
%s
%s (%s, Server %s)
%s (alle %gs)
%s: %s
%s: -1 kann nur im nicht interaktiven Modus verwendet werden
%s: ein Verzeichnis kann nicht kopiert werden
%s: konnte Variable »%s« nicht löschen
%s: konnte eigene Programmdatei nicht finden
%s: konnte Logdatei »%s« nicht öffnen: %s
%s: konnte Ausgabeparameter »%s« nicht setzen
%s: konnte Variable »%s« nicht setzen
%s: aktuelle Transaktion ist abgebrochen
%s: ungültiger Kodierungsname oder Umwandlungsprozedur nicht gefunden
%s: nicht mit einer Datenbank verbunden
%s: Speicher aufgebraucht
%s: unbekannter Transaktionsstatus
%s: Warnung: überflüssiges Kommandozeilenargument »%s« ignoriert
(%lu Zeile) (%lu Zeilen) ***(Einzelschrittmodus: Anfrage bestätigen)*************************************
%s
***(Drücken Sie die Eingabetaste um fortzufahren oder »x« um abzubrechen)*******
******** ANFRAGE *********
%s
**************************
+ opt(%d) = |%s|
, geclustert , DEFERRABLE , INITIALLY DEFERRED , ungültig , Prädikat (%s) , Replika-Identität , Tablespace »%s« Zugriffsprivilegien Alle Verbindungsparameter müssen angegeben werden, weil keine Datenbankverbindung besteht
Argumentdatentypen Asynchrone Benachrichtigung »%s« vom Serverprozess mit PID %d empfangen.
Asynchrone Benachrichtigung »%s« mit Daten »%s« vom Serverprozess mit PID %d empfangen.
Attribute Verfügbare Hilfe:
Rahmenstil ist %d.
Bypass RLS Datentransfer mit COPY fehlgeschlagen: %s Call-Handler Cann keine weitere Zelle zur Tabelle hinzufügen: Zellengesamtzahl %d überschritten.
Kann keinen weiteren Spaltenkopf zur Tabelle hinzufügen: Spaltenzahl %d überschritten.
kann nicht einloggen Check Check-Constraints: Kindtabellen Sortierfolge Spalte Spaltenprivilegien Anweisung: %s
Beschreibung: %s
Syntax:
%s
Zusammengesetzter Typ »%s.%s« Verbindung
DB erzeugen Rolle erzeugen Zeichentyp Datenbank Vorgegebene Zugriffsprivilegien Standardfußzeile ist aus.
Standardfußzeile ist an.
Standard? Definition Beschreibung Ziel Wörterbücher Keine Erweiterungen namens »%s« gefunden
Keine Erweiterungen gefunden
Keine Relationen namens »%s« gefunden
Keine Relation mit OID %s gefunden.
Keine Textsuchekonfiguration namens »%s« gefunden
Kein Textsucheparser namens »%s« gefunden
Abgeschaltete interne Trigger: Abgeschaltete Regeln: Abgeschaltete Trigger: Abgeschaltete Benutzer-Trigger: Elemente Eingeschaltet Kodierung Parsen beenden Geben Sie die zu kopierenden Daten ein, gefolgt von einem Zeilenende.
Beenden Sie mit einem Backslash und einem Punkt alleine auf einer Zeile, oder einem EOF-Signal. Geben Sie es noch einmal ein: Neues Passwort eingeben: Ereignis Erweiterte Anzeige ist aus.
Erweiterte Anzeige ist an.
Erweiterte Anzeige wird automatisch verwendet.
FDW-Optionen FDW-Optionen: (%s) Fehlgeschlagen.
Feldtrennzeichen ist »%s«.
Feldtrennzeichen ist ein Null-Byte.
Fremdtabelle »%s.%s« Fremddaten-Wrapper Fremdschlüssel-Constraints: Formatierung
Funktion Allgemein
Allgemeine Optionen:
Überschrift ermitteln Nächstes Token lesen Tokentypen ermitteln Handler Hat OIDs: ja Hilfe
ID Implizit? Index Index »%s.%s« Indexe: Informationen
Erbt von Init Initialisierungsoptionen Inline-Handler Eingabe/Ausgabe
Interne Sprache Interner Name Unterbrochen
Ungültige Anweisung \%s. Versuchen Sie \? für Hilfe.
Sprache Large Objects
Large Objects Linker Typ Lexize Linienstil ist %s.
Liste der Zugriffsmethoden Liste der Aggregatfunktionen Liste der Typumwandlungen Liste der Sortierfolgen Liste der Konversionen Liste der Datentypen Liste der Datenbanken Liste der Domänen Liste der Ereignistrigger Liste der Fremdserver Liste der Fremdtabellen Liste der Fremddaten-Wrapper Liste der Funktionen Liste der installierten Erweiterungen Liste der Sprachen Liste der Operatoren Liste der Relationen Liste der Rollen Liste der Schemas Liste der Einstellungen Liste besonderer Variablen
Liste der Tablespaces Liste der Textsuchekonfigurationen Liste der Textsuchewörterbücher Liste der Textsucheparser Liste der Textsuchevorlagen Liste der Benutzerabbildungen Lokalisiertes Format für numerische Daten ist aus.
Lokalisiertes Format für numerische Daten ist an.
Pfad Materialisierte Sicht »%s.%s« Mitglied von Methode Attribut Attribute Name keine Änderungen keine Verbindungen Keine Hilfe verfügbar für »%s«.
Versuchen Sie \h ohne Argumente, um die verfügbare Hilfe zu sehen.
keine Vererbung Keine passenden Relationen gefunden.
Keine passenden Einstellungen gefunden.
Keine Unterstützung für Rolleneinstellungen pro Datenbank in dieser Serverversion.
Keine Relationen gefunden.
Keine Einstellungen gefunden.
Null-Anzeige ist »%s«.
Anzahl Kindtabellen: %d (Mit \d+ alle anzeigen.) Objekt Objektbeschreibung Objektbeschreibungen Objekte in Erweiterung »%s« Betriebssystem
Optionen Ausgabeformat ist »%s«.
Eigentümer: %s Eigentümer Pager wird immer verwendet.
Pager wird für lange Ausgaben verwendet.
Pager-Verwendung ist aus.
Pager wird nicht für weniger als %d Zeile verwendet werden.
Pager wird nicht für weniger als %d Zeilen verwendet werden.
Parallel Passwortverschlüsselung ist fehlgeschlagen.
Passwort für Benutzer %s: Passwort gültig bis Passwort: Passwörter stimmten nicht überein.
Policys Policys (Sicherheit auf Zeilenebene erzwungen): Policys (Sicherheit auf Zeilenebene erzwungen): (keine) Policys (Sicherheit auf Zeilenebene ausgeschaltet): Policys (Sicherheit auf Zeilenebene eingeschaltet): (keine) Policys: Vorherige Verbindung wurde behalten
Prozedur Anfragepuffer
Anfragepuffer ist leer. Anfragepuffer wurde gelöscht. Satztrennzeichen ist »%s«.
Satztrennzeichen ist <newline>.
Satztrennzeichen ist ein Null-Byte.
Fremdschlüsselverweise von: Replika-Identität Replikation Berichten Sie Fehler an <pgsql-bugs@postgresql.org>.
Ergebnisdatentyp Ergebnistyp Rechter Typ Rolle Rollenname Regeln, die immer aktiv werden: Regeln, die nur im Replikat aktiv werden: Regeln: SSL-Verbindung (Protokoll: %s, Verschlüsselungsmethode: %s, Bits: %s, Komprimierung: %s)
ANWEISUNG: %s
Schema Sicherheit Sequenz »%s.%s« Server Server: %s Einstellung Größe Quelle Quelltext Quelltyp Spezielle Relation »%s.%s« Parsen starten Statistikziel Speicherung Erfolgreich.
Superuser TOAST-Tabelle »%s.%s« Tabelle Tabelle »%s.%s« Tabellenattribute sind »%s«.
Tabellenattribute sind nicht gesetzt.
Tablespace Tablespace: »%s« Tags Zieltyp Zielbreite ist %d.
Zielbreite ist nicht gesetzt.
Vorlage Textsuchekonfiguration »%s« Textsuchekonfiguration »%s.%s« Textsucheparser »%s« Textsucheparser »%s.%s« Die Verbindung zum Server wurde verloren. Versuche Reset: Die Eingabe ist ein PostgreSQL-Dump im Custom-Format.
Verwenden Sie den Kommandozeilen-Client pg_restore, um diesen Dump in die
Datenbank zurückzuspielen.
Der Server (Version %s) unterstützt keine Zugriffsmethoden.
Der Server (Version %s) unterstützt kein Ändern der Vorgabeprivilegien.
Der Server (Version %s) unterstützt keine Sortierfolgen.
Der Server (Version %s) unterstützt das Bearbeiten des Funktionsquelltextes nicht.
Der Server (Version %s) unterstützt das Bearbeiten von Sichtdefinitionen nicht.
Der Server (Version %s) unterstützt keine Erweiterungen.
Der Server (Version %s) unterstützt keine Fremdserver.
Der Server (Version %s) unterstützt keine Fremdtabellen.
Der Server (Version %s) unterstützt keine Fremddaten-Wrapper.
Der Server (Version %s) unterstützt keine Volltextsuche.
Der Server (Version %s) unterstützt keine Sicherungspunkte für ON_ERROR_ROLLBACK.
Der Server (Version %s) unterstützt das Anzeigen des Funktionsquelltextes nicht.
Der Server (Version %s) unterstützt das Anzeigen von Sichtdefinitionen nicht.
Der Server (Version %s) unterstützt keine Tablespaces.
Der Server (Version %s) unterstützt keine Benutzerabbildungen.
Es gibt keinen vorangegangenen Fehler. Zeit: %.3f ms
Zeitmessung ist aus. Zeitmessung ist an. Titel ist »%s«.
Titel ist nicht gesetzt.
Token Tokenname Tokentypen für Parser »%s« Tokentypen für Parser »%s.%s« Trigger, die immer aktiv werden: Trigger, die nur im Replikat aktiv werden: Trigger: Vertraut Versuchen Sie »%s --help« für weitere Informationen.
Nur Datenzeilen ist aus.
Nur Datenzeilen ist an.
Typ Geben Sie »help« für Hilfe ein.
Geben Sie ein: \copyright für Urheberrechtsinformationen
\h für Hilfe über SQL-Anweisungen
\? für Hilfe über interne Anweisungen
\g oder Semikolon, um eine Anfrage auszuführen
\q um zu beenden
Getypte Tabelle vom Typ: %s Unicode-Rahmenlinienstil ist »%s«.
Unicode-Spaltenlinienstil ist »%s«.
Unicode-Kopflinienstil ist »%s«.
Ungeloggter Index »%s.%s« Ungeloggte materialisierte Sicht »%s.%s« Ungeloggte Tabelle »%s.%s« Aufruf:
Verwenden Sie »\q«, um %s zu verlassen.
Benutzername Validator Wert Variablen
Version Sicht »%s.%s« Sichtdefinition: Volatilität WARNUNG: %s-Hauptversion %s, Server-Hauptversion %s.
Einige Features von psql werden eventuell nicht funktionieren.
Warnung: Konsolencodeseite (%u) unterscheidet sich von der Windows-
Codeseite (%u). 8-Bit-Zeichen funktionieren möglicherweise nicht
richtig. Einzelheiten finden Sie auf der psql-Handbuchseite unter
»Notes for Windows users«.
Befehlsgeschichte in Datei »%s« geschrieben.
Sie sind verbunden mit der Datenbank »%s« als Benutzer »%s« auf Host »%s« auf Port »%s«.
Sie sind verbunden mit der Datenbank »%s« als Benutzer »%s« via Socket in »%s« auf Port »%s«.
Sie sind gegenwärtig nicht mit einer Datenbank verbunden.
Sie sind jetzt verbunden mit der Datenbank »%s« als Benutzer »%s« auf Host »%s« auf Port »%s«.
Sie sind jetzt verbunden mit der Datenbank »%s« als Benutzer »%s« via Socket in »%s« auf Port »%s«.
Sie sind jetzt verbunden mit der Datenbank »%s« als Benutzer »%s«.
Dies ist psql, die Kommandozeilenschnittstelle für PostgreSQL. \!: fehlgeschlagen
\%s: konnte nicht in das Verzeichnis »%s« wechseln: %s
\%s: Name der Umgebungsvariable darf kein »=« enthalten
\%s: Fehler beim Setzen der Variable
\%s: überflüssiges Argument »%s« ignoriert
\%s: notwendiges Argument fehlt
\connect: %s \copy: benötigt Argumente
\copy: Parse-Fehler bei »%s«
\copy: Parse-Fehler am Zeilenende
\crosstabview: zweideutiger Spaltenname: »%s«
\crosstabview: Spaltenname nicht gefunden: »%s«
\crosstabview: Spaltennummer %d ist außerhalb des zulässigen Bereichs 1..%d
\crosstabview: Datenspalte muss angegeben werden, wenn die Anfrage mehr als drei Spalten zurückgibt
\crosstabview: maximale Anzahl Spalten (%d) überschritten
\crosstabview: Anfrage muss mindestens drei Spalten zurückgeben
\crosstabview: Anfrageergebnis enthält mehrfache Datenwerte für Zeile »%s«, Spalte »%s«
\crosstabview: Anweisung hat keine Ergebnismenge zurückgegeben
\crosstabview: die vertikalen und horizontalen Kopffelder müssen verschiedene Spalten sein
\df akzeptiert die Option »w« nicht mit Serverversion %s
\df akzeptiert nur [antwS+] als Optionen
\pset: zulässige Unicode-Rahmnenlinienstile sind single, double
\pset: zulässige Unicode-Spaltenlinienstile sind single, double
\pset: zulässige Unicode-Kopflinienstile sind single, double
\pset: zulässige Formate sind unaligned, aligned, wrapped, html, asciidoc, latex, latex-longtable, troff-ms
\pset: zulässige Linienstile sind ascii, old-ascii, unicode
\pset: unbekannte Option: %s
\watch kann nicht mit COPY verwendet werden
\watch kann nicht mit einer leeren Anfrage verwendet werden
abgekürztes_Grant_oder_Revoke bricht die aktuelle Transaktion ab abgebrochen wegen Lesenfehlers Zugriffsmethodentyp Aktion Agg Aggregatname Aggregatsignatur Alias Ausrichtung allowconn immer Analyze-Funktion und Aggregatsignatur Folgendes ist: und Konfliktaktion Folgendes sein kann: und Gruppierelement eins der folgenden sein kann: und Like-Option Folgendes ist: und Tabellen-Constraint Folgendes ist: und Tabellen-Constraint-für-Index Folgendes ist: und With-Anfrage ist: Arg-Datentyp Argname Argtyp Argmodus Argname Argtyp Argument Argumenttyp Argumente Versuch von \gset in besonders behandelte Variable »%s« ignoriert
Attribut Attributname Attributoption Basistyp boolean Cache Handler storniert eine Transaktion, die vorher für Two-Phase-Commit vorbereitet worden war vom Benutzer abgebrochen kann NULL-Zeiger nicht kopieren (interner Fehler)
Escape kann nicht ohne aktive Verbindung ausgeführt werden
Canonical-Funktion Kategorie ändert eine Datenbank ändert eine Datenbankrolle ändert einen Konfigurationsparameter ändert einen Server-Konfigurationsparameter ändert Rollenname oder -mitglieder ändert die Definition einer Sortierfolge ändert die Definition einer Zeichensatzkonversion ändert die Definition einer Domäne ändert die Definition eines Fremdservers ändert die Definition einer Fremdtabelle ändert die Definition eines Fremddaten-Wrappers ändert die Definition einer Funktion ändert die Definition eines Large Object ändert die Definition einer materialisierten Sicht ändert die Definition einer prozeduralen Sprache ändert die Definition einer Policy für Sicherheit auf Zeilenebene ändert die Definition einer Regel ändert die Definition eines Schemas ändert die Definition eines Sequenzgenerators ändert die Definition einer Tabelle ändert die Definition eines Tablespace ändert die Definition einer Textsuchekonfiguration ändert die Definition eines Textsuchewörterbuchs ändert die Definition eines Textsucheparsers ändert die Definition einer Textsuchevorlage ändert die Definition eines Triggers ändert die Definition eines Typs ändert die Definition einer Benutzerabbildung ändert die Definition einer Sicht ändert die Definition einer Aggregatfunktion ändert die Definition eines Ereignistriggers ändert die Definition einer Erweiterung ändert die Definition eines Index ändert die Definition eines Operators ändert die Definition einer Operatorklasse ändert die Definition einer Operatorfamilie ändert den Eigentümer der der Rolle gehörenden Datenbankobjekte Kanal Check-Ausdruck Kindprozess hat mit Code %d beendet Kindprozess hat mit unbekanntem Status %d beendet Kindprozess wurde durch Ausnahme 0x%X beendet Kindprozess wurde von Signal %d beendet: %s schließt einen Cursor clustert eine Tabelle nach einem Index Code sortierbar Sortierfolge %s Sortierfolge sammelt Statistiken über eine Datenbank Spaltenalias Spalten-Constraint Spaltendefinition Spaltenname Spaltentyp Kommutator-Op Combine-Funktion Befehl Befehl ist nicht ausführbar Befehl nicht gefunden schließt eine Transaktion ab, die vorher für Two-Phase-Commit vorbereitet worden war schließt die aktuelle Transaktion ab berechnet eine Zeilenmenge Bedingung Konfigurationsparameter Konfliktaktion Konfliktziel Verbindung zum Server wurde verloren
Verbindungslimit Constraint Constraint-Name kopiert Daten zwischen einer Datei und einer Tabelle konnte nicht in Verzeichnis »%s« wechseln: %s konnte Pipe zu externem Befehl nicht schließen: %s
konnte Befehl »%s« nicht ausführen: %s
konnte kein »%s« zum Ausführen finden konnte Home-Verzeichnis für Benutzer-ID %ld nicht ermitteln: %s
konnte aktuelles Verzeichnis nicht ermitteln: %s konnte temporäres Verzeichnis nicht finden: %s
konnte effektive Benutzer-ID %ld nicht nachschlagen: %s konnte temporäre Datei »%s« nicht öffnen: %s
konnte reloptions-Array nicht interpretieren
konnte Programmdatei »%s« nicht lesen konnte nicht aus Eingabedatei lesen: %s
konnte symbolische Verknüpfung »%s« nicht lesen konnte Befehlsgeschichte nicht in »%s« speichern: %s
konnte Variable »%s« nicht setzen
konnte /bin/sh nicht starten
konnte Editor »%s« nicht starten
konnte »stat« für Datei »%s« nicht ausführen: %s
konnte COPY-Daten nicht schreiben: %s
Anzahl erzeugt eine neue Datenbank erzeugt neue Zeilen in einer Tabelle Cursor-Name Datentyp Datenbankname gibt einen vorbereiteten Befehl frei Vorgabewert Vorgabewert %s Vorgabeausdruck definiert einen Cursor definiert eine neue Zugriffsmethode definiert eine neue Aggregatfunktion definiert eine neue Typumwandlung definiert eine neue Sortierfolge definiert einen neuen Datentyp definiert eine neue Datenbankrolle definiert eine neue Domäne definiert eine neue Kodierungskonversion definiert einen neuen Ereignistrigger definiert einen neuen Fremdserver definiert eine neue Fremdtabelle definiert einen neuen Fremddaten-Wrapper definiert eine neue Funktion definiert einen neuen Index definiert eine neue Abbildung eines Benutzers auf einen Fremdserver definiert eine neue materialisierte Sicht definiert einen neuen Operator definiert eine neue Operatorklasse definiert eine neue Operatorfamilie definiert eine neue prozedurale Sprache definiert eine neue Umschreiberegel definiert eine neue Policy für Sicherheit auf Zeilenebene für eine Tabelle definiert einen neuen Sicherungspunkt in der aktuellen Transaktion definiert ein neues Schema definiert einen neuen Sequenzgenerator definiert eine neue Tabelle definiert eine neue Tabelle aus den Ergebnissen einer Anfrage definiert einen neuen Tablespace definiert eine neue Textsuchekonfiguration definiert ein neues Textsuchewörterbuch definiert einen neuen Textsucheparser definiert eine neue Textsuchevorlage definiert eine neue Transformation definiert einen neuen Trigger definiert eine neue Sicht definiert Zugriffsprivilegien definiert vorgegebene Zugriffsprivilegien definiert oder ändert ein Security-Label eines Objektes definiert oder ändert den Kommentar eines Objektes definer Definition delete löscht Zeilen einer Tabelle Trennzeichen Trennzeichen Deserialisierungsfunktion Zielkodierung gibt einen zuvor definierten Sicherungspunkt frei Wörterbuchname Richtung Verzeichnis ausgeschaltet verwirft den Sitzungszustand Domänen-Constraint Domänen-Constraint Domänenname Element leert eine oder mehrere Tabellen eingeschaltet Kodierung Kodierungsname Endfunktion Umgebungsvariable PSQL_EDITOR_LINENUMBER_ARG muss gesetzt werden, um eine Zeilennummer angeben zu können
Escape-Zeichen Ereignis Exclude-Element Exclude-Element in einem EXCLUDE-Constraint ist: führt einen vorbereiteten Befehl aus führt einen anonymen Codeblock aus Ausführungskosten existierende_Sortierfolge existierender_Enum-Wert Ausdruck Erweiterungsname Familienname FDW-Name Abschlussfunktion Dateiname Filterwert Filtervariable für Tabelle »%s.%s« erzwingt einen Checkpoint im Transaktionslog Fremdtabelle Formatname From-Element From-SQL-Funktionsname Funktion Funktionsname wird benötigt
Funktionsname säubert und analysiert eine Datenbank erzeugt eine Benachrichtigung Gettext-Funktion Gruppenname Gruppierelement Handler-Funktion Headline-Funktion Befehlsgeschichte wird von dieser Installation nicht unterstützt
unveränderlich importiert Tabellendefinitionen von einem Fremdserver in Zuweisung Inkrement Index Indexspaltenname Indexausdruck Indexmethode Indexname Indexparameter Indexparameter bei UNIQUE-, PRIMARY KEY- und EXCLUDE-Constraints sind: Indexprädikat Init-Funktion Anfangswert Inline-Handler Eingabefunktion insert installiert eine Erweiterung ganze_Zahl interne_Länge ungültige Programmdatei »%s« ungültige Anweisung \%s
ungültige Zeilennummer: %s
ungültiges Ausgabeformat (interner Fehler): %d invoker istemplate Verbundspalte Verbundbedingung Join-Funktion Verbundtyp Label Sprachname Large-Object-OID lc_collate lc_ctype linker_Typ Lexize-Funktion Lextypenfunktion Like-Option wie_Typ Linksymbol hört auf eine Benachrichtigung lädt eine dynamische Bibliotheksdatei lokales Socket lokales_Schema Locale sperrt eine Tabelle Sperrmodus Large-Object-OID materialisierte Sicht Maxwert Elementobjekt Methode Moving-Abschlussfunktion Moving-Anfangswert Minwert Moving-Inversfunktion mehr als eine Zeile für \gset zurückgegeben
Moving-Übergangsfunktion Moving-Zustandsdatengröße Moving-Zustandsdatentyp Name Umkehrungs-Op neuer_Attributname neuer_Spaltenname neuer_Constraint-Name neues_Wörterbuch neuer_Enum-Wert neuer_Name neuer_Eigentümer neue_Rolle neues_Schema neue_Tabelle neuer_Tablespace neue_Version nein kein Anfragepuffer
keine Zeilen für \gset zurückgegeben
normal not null Null-Zeichenkette Objektdatei Objektname aus altes_Wörterbuch alte_Rolle alte_Version an Optyp Opklasse Operator Operatorklasse Operatorfamilie Operatorname Option oder die alte Syntax Speicher aufgebraucht Speicher aufgebraucht
Ausgabeausdruck Ausgabefunktion Ausgabename Parameter Elterntabelle Parser-Name Passwort Payload pclose fehlgeschlagen: %s Policy-Name positioniert einen Cursor Prädikat bevorzugt bereitet einen Befehl zur Ausführung vor bereitet die aktuelle Transaktion für Two-Phase-Commit vor Primärschlüssel, Provider psql ist das interaktive PostgreSQL-Terminal.
psql-Variablen:
Anfrage Quote-Zeichen baut Indexe neu Empfangsfunktion Refspalte verwiesener_Tabellenname Reftabelle Relationsname fernes_Schema entfernt eine Typumwandlung entfernt eine Sortierfolge entfernt eine Zeichensatzkonversion entfernt einen Datentyp entfernt eine Datenbank entfernt eine Datenbankrolle entfernt eine Domäne entfernt einen Fremdserverdeskriptor entfernt eine Fremdtabelle entfernt einen Fremddaten-Wrapper entfernt eine Funktion entfernt eine materialisierte Sicht entfernt eine prozedurale Sprache entfernt eine Umschreiberegel entfernt eine Policy für Sicherheit auf Zeilenebene von einer Tabelle entfernt ein Schema entfernt eine Sequenz entfernt eine Tabelle entfernt einen Tablespace entfernt eine Textsuchekonfiguration entfernt ein Textsuchewörterbuch entfernt einen Textsucheparser entfernt eine Textsuchevorlage entfernt eine Transformation entfernt einen Trigger entfernt eine Benutzerabbildung für einen Fremdserver entfernt eine Sicht entfernt Zugriffsprivilegien entfernt eine Zugriffsmethode entfernt eine Aggregatfunktion entfernt einen Ereignistrigger entfernt eine Erweiterung entfernt einen Index entfernt einen Operator entfernt eine Operatorklasse entfernt eine Operatorfamilie entfernt die einer Datenbankrolle gehörenden Datenbankobjekte ersetzt den Inhalt einer materialisierten Sicht Replika Res-Funktion Restart setzt einen Konfigurationsparameter auf die Voreinstellung zurück beschränkt Ergebniszeilen liest Zeilen aus einer Anfrage mit einem Cursor liest Zeilen aus einer Tabelle oder Sicht Rückgabetyp Regelname rechter_Typ Rollenname Rollenangabe rollt eine Transaktion bis zu einem Sicherungspunkt zurück Rule Regelname sicher Stichprobenmethode Sicherungspunktsname Schemaelement Schemaname Startwert Select Sendefunktion Sequenz Sequenzname Serialisierungsfunktion Servername Servertyp Serverversion setzt die Zeitsteuerung für Check-Constraints in der aktuellen Transaktion setzt die Charakteristika der aktuellen Transaktion setzt den aktuellen Benutzernamen der aktuellen Sitzung setzt den Sitzungsbenutzernamen und den aktuellen Benutzernamen der aktuellen Sitzung Übergangsfunktion zeigt den Ausführungsplan eines Befehls zeigt den Wert eines Konfigurationsparameters rekursive Auswertung der Variable »%s« wird ausgelassen
Snapshot-ID Sortierausdruck Sortierfamilienname Sortieroperator Quellkonfig Quellkodierung Quelltabelle Quelltyp speziell stabil Start startet einen Transaktionsblock Startfunktion Zustandsdatengröße Zustandsdatentyp Anweisung beendet das Hören auf eine Benachrichtigung Speicherung Storage-Parameter Storage-Typ Strategienummer Sub-SELECT Untertyp Untertyp-Diff-Funktion Untertyp-Operatorklasse Unterst-Nummer Anfrage zur Tab-Vervollständigung fehlgeschlagen: %s
Anfrage war:
%s
Tabelle Tabellen-Constraint Tabellen-Constraint Tabellen-Constraint-für-Index Tabellenname Tablespace-Name Tablespace-Option Zielrolle Zieltyp Vorlage Text Zeit Zeitzone To-SQL-Funktionsname Tokentyp Transaktions-ID Transaktionsmodus Trigger Triggername versuche, den COPY-Modus zu verlassen Typ Typmod-Eingabefunktion Typmod-Ausgabefunktion Typname Uid unerwarteter PQresultStatus: %d
unerwarteter Ergebnisstatus für \watch
unerwarteter Transaktionsstatus (%d)
eindeutig, unbekannt unbekannter Wert »%s« für »%s«; »%s« wird angenommen
unsicher Zeichenkette in Anführungszeichen nicht abgeschlossen
update aktualisiert Zeilen einer Tabelle Benutzer existiert nicht Fehler beim Nachschlagen des Benutzernamens: Fehlercode %lu Benutzername Using-Ausdruck Valfunktion Validator-Funktion Wert values Version Sicht Sichtname wird benötigt
Sichtoptionsname Sichtoptionswert volatil wobei abgekürztes_Grant_oder_Revoke Folgendes sein kann: wobei Aktion Folgendes sein kann: wobei Aggregatsignatur Folgendes ist: wobei Spalten-Constraint Folgendes ist: wobei Konfliktziel Folgendes sein kann: wobei Constraint Folgendes ist: wobei Richtung leer sein kann oder Folgendes: wobei Ereignis eins der folgenden sein kann: wobei From-Element Folgendes sein kann: wobei Sperrmodus Folgendes sein kann: wobei Elementobjekt Folgendes ist: wobei Option eine der folgenden sein kann: wobei Option Folgendes sein kann: wobei Rollenangabe Folgendes sein kann: wobei Transaktionsmodus Folgendes sein kann: Fenster Fensterdefinition Fenstername With-Anfrage With-Anfragename ja locale/tr/LC_MESSAGES/pg_dump-9.6.mo 0000644 00000174274 14751153420 0012540 0 ustar 00 �� � t � � ) ) /) X B) [ �) B �) ) :* " d* x �* + + + 3+ A L+ N �+ P �+ I ., 3 x, y �, G &- C n- N �- K . v M. F �. > / R J/ B �/ E �/ ? &0 L f0 3 �0 6 �0 Q 1 T p1 M �1 ? 2 � S2 � �2 ? �3 9 �3 5 4 : J4 K �4 B �4 D 5 � Y5 3 �5 � 6 ? �6 D �6 x 7 6 �7 Q �7 O 8 F g8 > �8 5 �8 > #9 E b9 A �9 O �9 H :: B �: @ �: = ; O E; H �; ; �; , < 4 G< E |< 0 �< = �< , 1= F ^= D �= C �= F .> 8 u> ? �> C �> = 2? 4 p? 7 �? L �? = *@ @ h@ J �@ < �@ L 1A , ~A ( �A 5 �A E
B T PB �B 9 �B D �B G 'C oC �C ? �C ' �C *
D e 8D ! �D , �D 4 �D 6 "E ( YE / �E �E �E $ �E * F 2 2F B eF > �F J �F P 2G N �G H �G - H IH ^H / qH �H 4 �H $ �H &
I * 4I # _I �I P �I C �I A 7J ( yJ �J �J �J �J = K � OK
�K , �K � L � �L , BM oM p �M e �M & [N �N ` �N p �N 4 \O X �O _ �O E JP 1 �P 6 �P 4 �P * .Q - YQ D �Q . �Q + �Q + 'R ) SR * }R > �R : �R ' "S = JS ) �S 1 �S �S @ �S 7 @T 6 xT 6 �T < �T = #U 4 aU 3 �U b �U 9 -V < gV t �V # W , =W 5 jW �W �W �W
�W ' �W !X % -X SX / sX X �X & �X 0 #Y . TY ) �Y ) �Y �Y �Y Z 3 Z ( @Z iZ ) |Z # �Z �Z �Z & [ K -[ & y[ �[ ! �[ ( �[ ' \ 1\ # P\ t\ / �\ �\ �\ # ] % %] K] , h] $ �] $ �] $ �] 6 ^ ;^ S^ B t^ � �^ � N_ �_ $ �_ < "` 3 _` * �` ' �` + �` ( a ( ;a # da - �a � �a + �b , �b ! �b & c ' (c # Pc tc " �c 8 �c $ �c d 4d Q Sd & �d a �d @ .e 5 oe , �e �e " �e # f , 4f af ! �f # �f * �f # �f % g 0 ;g & lg $ �g �g " �g = �g # 8h 1 \h �h �h �h : �h ) i B *i P mi �i �i �i j " j >j Xj & uj & �j % �j 2 �j k 1k & Mk ! tk ) �k # �k " �k l r l < �l D �l N
m F \m �m �m �m & �m , $n - Qn n " �n / �n �n o ( !o @ Jo �o �o �o P �o /p > Ep 1 �p > �p / �p Y %q > q �q �q " �q r & 7r < ^r �r ' �r ( �r ' s (s Fs ]s 1 ps + �s �s % �s 3 t It bt " {t ; �t �t �t 0 u :u / Yu �u �u �u . �u I
v > Wv D �v �v �v w 7 w 9 Qw 6 �w H �w @ x Lx 3 ^x & �x 0 �x 6 �x / !y ( Qy , zy �y " �y �y �y z h %z T �z � �z 6 f{ L �{ J �{ 9 5| o| $ ~| + �| �| �| } } 1} 2 E} x} " �} �} �} # �} �} ~ / .~ ^~ & o~ �~ �~ # �~ �~ $ �~ ) C ! d % � + � � & � ' � G� g� 0 �� . �� ) � + � :� V� 4 t� � �� # ,� * P� {� �� ��  ( ܂ � " � ?� E T� # �� �� փ � ; �� 1� G� T� ' p� �� ' �� % �� � :� B W� 0 �� ! ˅ 8 � : &� a� }� 3 �� 1 І 1 � + 4� $ `� $ �� h �� | � �� �� R �� R � [ f� 0 + � � � �� �� % ƌ � R � Y [� _ �� j � A �� � B \� C �� X � h <� t �� I � D d� [ �� B � F H� D �� j Ԓ K ?� S �� ] ߓ ] =� Y �� Z �� � P� � �� F Ö G
� C R� = �� e ԗ S :� B �� � ј ? _� � �� A +� Q m� | �� B <� s � a � Q U� K �� D � A 8� F z� H �� @
� \ K� P �� L �� Q F� e �� e �� G d� B �� < � W ,� 0 �� D �� 0 �� [ +� N �� c ֢ b :� G �� : � F � N g� @ �� 9 �� h 1� M �� G � X 0� P �� f ڦ 9 A� ( {� D �� B � Z ,� �� F �� F Ѩ [ � t� �� C �� ( �� + � k K� ' �� , ߪ G � F T� . �� 4 ʫ & �� &� $ >� " c� > �� R Ŭ D � L ]� R �� Q �� X O� A �� �
� / !� Q� 9 k� ! �� % ǯ ' � ! � - 7� f e� S ̰ Q � % r� # �� �� ڱ ! �� g � � �� � 9 %� � _� � *� G �� ! D� r f� p ٵ 3 J�
~� a �� q � : `� } �� l � ? �� ? Ƹ A � ? H� 5 �� ) �� A � 2 *� / ]� / �� - �� 6 � G "� O j� 1 �� d � + Q� : }� �� 6 ؼ - � . =� . l� 7 �� 4 ӽ - � + 6� X b� : �� N �� � E� + ο : �� J 5� % �� �� �
� / � � 0 � , N� - {� b �� : � ; G� = �� 9 �� 9 �� " 5� X� j� A v� 3 �� �� @ � 2 C� # v� �� 3 �� W �� 3 G� ! {� $ �� 0 �� * �� ! � @� % `� 2 �� % �� �� " �� * � I� * i� ! �� $ �� " �� 5 �� 4� ' P� @ x� � �� � C� * �� # �� ; � 8 U� % �� $ �� ( �� 3 � # 6� + Z� 2 �� � �� / �� 2 �� # �� * � - H� & v� ! �� ! �� < �� ( � # G� k� g �� 4 �� o %� E �� ; �� / � ' G� o� " �� * �� " �� �� ) � 2 H� $ {� - �� 5 �� : � + ?� + k� ! �� 8 �� + �� + � J� b� }� , �� - �� \ �� M E� �� �� 7 �� �� * � 0 =� n� ) �� ) �� ( �� ;
� $ F� 1 k� 6 �� % �� - �� + (� ( T� }� � �� D <� \ �� e �� i D� + �� ( �� � 0 � 9 P� 5 �� �� ! �� 4 � 5� Q� 5 l� @ �� �� � � S @� �� ^ �� $
� 4 2� . g� S �� : �� %� ! E� ' g� ! �� 2 �� P �� 5� 1 S� 5 �� 4 �� " �� � 0� 7 E� 7 }� �� - �� @ � E� ! ]� 1 � J �� �� � : 3� n� ; �� * �� # �� � : /� ? j� A �� G �� 4� " E� h� = z� : �� 8 �� ` ,� 8 �� �� 1 �� + � * A� 4 l� . �� " �� ; �� /� & >� e� $ �� �� � �� S I� � �� < M� c �� C �� < 2� o� 2 �� + �� & �� � ! (� J� i� E ~� �� ' �� �� � 0 +� \� w� R �� �� 3 �� +� D� , ]� �� 3 �� 6 �� , � . 9� 1 h� 7 �� , �� 6 �� 2 6� , i� ( �� ? �� 8 �� A 8� 8 z� & �� * �� ? � � E� % �� : �� # 8� \� q� & �� - �� �� �� � a @� ' �� �� �� � ? � G� a� n� 3 �� �� + �� $ � - *� X� u� h �� 7 �� . 6� 8 e� 9 �� ! � �� 2 � 4 N� 5 �� 4 �� # � 1 � w D� � � � � � A r � � � � � < � � � � ^ � � B � Y N � � � ' � a p ) � B � - �
� � X H � u � � $ � n ? 6 � � K i � y � � � � � � $ � � { � � � q � � { � � � + ' � � I � � < � J ~ m � . m v Q t � � � � � � Q � � � + � x � � ? K P 2 f � � � � � � � � � � � � p # � j � � , z ; � S � 4 � � � � � � � � � k � � O = " 3 � � % � � [ o � � � � 6 � � � � y
g � ( � > � � � � x � � > # � � o W T ! � � 4 � � E : E D � � @ � Z � � � H e � _ / � Y �
h [ l v d ] � � 5 d � � � � � � � N G � r } � � 8 � V z � � J � ` & � � � � � � � , ! - � F � a � ; � U 3 � C " O � � C � * � � � 1 � I S � � / 9 c � \ � � � � 9 � ` * � 5 T � R � 0 � � | � � � � � � � e . �
� 0 \ M � � t b W | R � � b � � & � q � � ^ � � X l � � } s g � � s _ h � D 1 2 � � i � U � � � � � � � � : � L � w ] � ( � j � M � F G � k n � L = � � � u � � � 7 V � Z ~ f ) � w c % @ A � � 7 8 P � � � �
Connection options:
General options:
If -f/--file is not used, then the SQL script will be written to the standard
output.
If no database name is supplied, then the PGDATABASE environment
variable value is used.
If no input file name is supplied, then standard input is used.
Options controlling the output content:
Options controlling the restore:
The options -I, -n, -P, -t, -T, and --section can be combined and specified
multiple times to select multiple objects.
%s
%s [OPTION]...
%s [OPTION]... [DBNAME]
%s [OPTION]... [FILE]
--binary-upgrade for use by upgrade utilities only
--column-inserts dump data as INSERT commands with column names
--disable-dollar-quoting disable dollar quoting, use SQL standard quoting
--disable-triggers disable triggers during data-only restore
--enable-row-security enable row security
--enable-row-security enable row security (dump only content user has
access to)
--exclude-table-data=TABLE do NOT dump data for the named table(s)
--if-exists use IF EXISTS when dropping objects
--inserts dump data as INSERT commands, rather than COPY
--lock-wait-timeout=TIMEOUT fail after waiting TIMEOUT for a table lock
--no-data-for-failed-tables do not restore data of tables that could not be
created
--no-security-labels do not dump security label assignments
--no-security-labels do not restore security labels
--no-synchronized-snapshots do not use synchronized snapshots in parallel jobs
--no-tablespaces do not dump tablespace assignments
--no-tablespaces do not restore tablespace assignments
--no-unlogged-table-data do not dump unlogged table data
--quote-all-identifiers quote all identifiers, even if not key words
--role=ROLENAME do SET ROLE before dump
--role=ROLENAME do SET ROLE before restore
--section=SECTION dump named section (pre-data, data, or post-data)
--section=SECTION restore named section (pre-data, data, or post-data)
--serializable-deferrable wait until the dump can run without anomalies
--snapshot=SNAPSHOT use given snapshot for the dump
--strict-names require table and/or schema include patterns to
match at least one entity each
--use-set-session-authorization
use SET SESSION AUTHORIZATION commands instead of
ALTER OWNER commands to set ownership
-1, --single-transaction restore as a single transaction
-?, --help show this help, then exit
-?, --help show this help, then exit
-C, --create create the target database
-C, --create include commands to create database in dump
-E, --encoding=ENCODING dump the data in encoding ENCODING
-F, --format=c|d|t backup file format (should be automatic)
-F, --format=c|d|t|p output file format (custom, directory, tar,
plain text (default))
-I, --index=NAME restore named index
-L, --use-list=FILENAME use table of contents from this file for
selecting/ordering output
-N, --exclude-schema=SCHEMA do NOT dump the named schema(s)
-O, --no-owner skip restoration of object ownership
-O, --no-owner skip restoration of object ownership in
plain-text format
-P, --function=NAME(args) restore named function
-S, --superuser=NAME superuser user name to use for disabling triggers
-S, --superuser=NAME superuser user name to use in plain-text format
-S, --superuser=NAME superuser user name to use in the dump
-T, --exclude-table=TABLE do NOT dump the named table(s)
-T, --trigger=NAME restore named trigger
-U, --username=NAME connect as specified database user
-V, --version output version information, then exit
-V, --version output version information, then exit
-W, --password force password prompt (should happen automatically)
-Z, --compress=0-9 compression level for compressed formats
-a, --data-only dump only the data, not the schema
-a, --data-only restore only the data, no schema
-b, --blobs include large objects in dump
-c, --clean clean (drop) database objects before recreating
-c, --clean clean (drop) databases before recreating
-d, --dbname=CONNSTR connect using connection string
-d, --dbname=DBNAME database to dump
-d, --dbname=NAME connect to database name
-e, --exit-on-error exit on error, default is to continue
-f, --file=FILENAME output file name
-f, --file=FILENAME output file or directory name
-f, --file=FILENAME output file name
-g, --globals-only dump only global objects, no databases
-h, --host=HOSTNAME database server host or socket directory
-j, --jobs=NUM use this many parallel jobs to dump
-j, --jobs=NUM use this many parallel jobs to restore
-l, --database=DBNAME alternative default database
-l, --list print summarized TOC of the archive
-n, --schema=NAME restore only objects in this schema
-n, --schema=SCHEMA dump the named schema(s) only
-o, --oids include OIDs in dump
-p, --port=PORT database server port number
-r, --roles-only dump only roles, no databases or tablespaces
-s, --schema-only dump only the schema, no data
-s, --schema-only restore only the schema, no data
-t, --table=NAME restore named relation (table, view, etc.)
-t, --table=TABLE dump the named table(s) only
-t, --tablespaces-only dump only tablespaces, no databases or roles
-v, --verbose verbose mode
-v, --verbose verbose mode
-w, --no-password never prompt for password
-x, --no-privileges do not dump privileges (grant/revoke)
-x, --no-privileges skip restoration of access privileges (grant/revoke)
%s %s dumps a database as a text file or to other formats.
%s extracts a PostgreSQL database cluster into an SQL script file.
%s restores a PostgreSQL database from an archive created by pg_dump.
%s: %s Command was: %s
%s: WSAStartup failed: %d
%s: cannot specify both --single-transaction and multiple jobs
%s: could not connect to database "%s"
%s: could not connect to database "%s": %s %s: could not connect to databases "postgres" or "template1"
Please specify an alternative database.
%s: could not get server version
%s: could not open the output file "%s": %s
%s: could not parse ACL list (%s) for database "%s"
%s: could not parse ACL list (%s) for tablespace "%s"
%s: could not parse server version "%s"
%s: could not re-open the output file "%s": %s
%s: dumping database "%s"...
%s: executing %s
%s: invalid number of parallel jobs
%s: maximum number of parallel jobs is %d
%s: option --if-exists requires option -c/--clean
%s: options -c/--clean and -a/--data-only cannot be used together
%s: options -d/--dbname and -f/--file cannot be used together
%s: options -g/--globals-only and -r/--roles-only cannot be used together
%s: options -g/--globals-only and -t/--tablespaces-only cannot be used together
%s: options -r/--roles-only and -t/--tablespaces-only cannot be used together
%s: options -s/--schema-only and -a/--data-only cannot be used together
%s: pg_dump failed on database "%s", exiting
%s: query failed: %s %s: query was: %s
%s: role name starting with "pg_" skipped (%s)
%s: running "%s"
%s: too many command-line arguments (first is "%s")
%s: unrecognized section name: "%s"
(The INSERT command cannot set OIDs.)
(The system catalogs might be corrupted.)
-C and -1 are incompatible options
COPY failed for table "%s": %s Consider using a full dump instead of a --data-only dump to avoid this problem.
Dumping the contents of table "%s" failed: PQgetCopyData() failed.
Dumping the contents of table "%s" failed: PQgetResult() failed.
Error from TOC entry %d; %u %u %s %s %s
Error message from server: %s Error while FINALIZING:
Error while INITIALIZING:
Error while PROCESSING TOC:
Exported snapshots are not supported by this server version.
NOTICE: there are circular foreign-key constraints on this table:
NOTICE: there are circular foreign-key constraints among these tables:
Password: Report bugs to <pgsql-bugs@postgresql.org>.
Synchronized snapshots are not supported by this server version.
Run with --no-synchronized-snapshots instead if you do not need
synchronized snapshots.
Synchronized snapshots are not supported on standby servers.
Run with --no-synchronized-snapshots instead if you do not need
synchronized snapshots.
TOC Entry %s at %s (length %s, checksum %d)
The command was: %s
The program "pg_dump" is needed by %s but was not found in the
same directory as "%s".
Check your installation.
The program "pg_dump" was found by "%s"
but was not the same version as %s.
Check your installation.
Try "%s --help" for more information.
Usage:
WARNING: aggregate function %s could not be dumped correctly for this database version; ignored
WARNING: archive is compressed, but this installation does not support compression -- no data will be available
WARNING: archive items not in correct section order
WARNING: archive was made on a machine with larger integers, some operations might fail
WARNING: bogus transform definition, at least one of trffromsql and trftosql should be nonzero
WARNING: bogus value in pg_cast.castfunc or pg_cast.castmethod field
WARNING: bogus value in pg_cast.castmethod field
WARNING: bogus value in pg_transform.trffromsql field
WARNING: bogus value in pg_transform.trftosql field
WARNING: bogus value in proargmodes array
WARNING: could not find operator with OID %s
WARNING: could not find where to insert IF EXISTS in statement "%s"
WARNING: could not parse proallargtypes array
WARNING: could not parse proargmodes array
WARNING: could not parse proargnames array
WARNING: could not parse proconfig array
WARNING: could not parse reloptions array
WARNING: could not resolve dependency loop among these items:
WARNING: don't know how to set owner for object type "%s"
WARNING: errors ignored on restore: %d
WARNING: ftell mismatch with expected position -- ftell used
WARNING: invalid creation date in header
WARNING: invalid type "%c" of access method "%s"
WARNING: line ignored: %s
WARNING: owner of aggregate function "%s" appears to be invalid
WARNING: owner of data type "%s" appears to be invalid
WARNING: owner of function "%s" appears to be invalid
WARNING: owner of operator "%s" appears to be invalid
WARNING: owner of operator class "%s" appears to be invalid
WARNING: owner of operator family "%s" appears to be invalid
WARNING: owner of schema "%s" appears to be invalid
WARNING: owner of table "%s" appears to be invalid
WARNING: requested compression not available in this installation -- archive will be uncompressed
WARNING: typtype of data type "%s" appears to be invalid
WARNING: unexpected extra results during COPY of table "%s"
You might not be able to restore the dump without using --disable-triggers or temporarily dropping the constraints.
a worker process died unexpectedly
aborting because of server version mismatch
actual file length (%s) does not match expected (%s)
allocating AH for %s, format %d
already connected to a database
archiver archiver (db) attempting to ascertain archive format
bad dumpId
bad table dumpId for TABLE DATA item
can only reopen input archives
cannot duplicate null pointer (internal error)
cannot restore from compressed archive (compression not supported in this installation)
child process exited with exit code %d child process exited with unrecognized status %d child process was terminated by exception 0x%X child process was terminated by signal %d child process was terminated by signal %s command not executable command not found compress_io compression is not supported by tar archive format
compression level must be in range 0..9
compressor active
connecting to database "%s" as user "%s"
connecting to database for restore
connecting to new database "%s"
connection needs password
connection to database "%s" failed: %s corrupt tar header found in %s (expected %d, computed %d) file position %s
could not change directory to "%s": %s could not close TOC file: %s
could not close archive file: %s
could not close compression library: %s
could not close compression stream: %s
could not close data file: %s
could not close directory "%s": %s
could not close input file: %s
could not close large object TOC file "%s": %s
could not close output file: %s
could not close tar member
could not close temporary file: %s
could not commit database transaction could not compress data: %s
could not create communication channels: %s
could not create directory "%s": %s
could not create large object %u: %s could not create worker process: %s
could not determine seek position in archive file: %s
could not execute query could not find a "%s" to execute could not find block ID %d in archive -- possibly corrupt archive
could not find block ID %d in archive -- possibly due to out-of-order restore request, which cannot be handled due to lack of data offsets in archive
could not find block ID %d in archive -- possibly due to out-of-order restore request, which cannot be handled due to non-seekable input file
could not find entry for ID %d
could not find file "%s" in archive
could not find function definition for function with OID %u
could not find header for file "%s" in tar archive
could not find parent extension for %s %s
could not find slot of finished worker
could not generate temporary file name: %s
could not get server_version from libpq
could not identify current directory: %s could not identify dependency loop
could not initialize compression library: %s
could not obtain lock on relation "%s"
This usually means that someone requested an ACCESS EXCLUSIVE lock on the table after the pg_dump parent process had gotten the initial ACCESS SHARE lock on the table.
could not open TOC file "%s" for input: %s
could not open TOC file "%s" for output: %s
could not open TOC file "%s": %s
could not open TOC file for input: %s
could not open TOC file for output: %s
could not open input file "%s": %s
could not open input file: %s
could not open large object %u: %s could not open large object TOC file "%s" for input: %s
could not open output file "%s": %s
could not open output file: %s
could not open temporary file
could not parse GRANT ACL list (%s) or REVOKE ACL list (%s) for object "%s" (%s)
could not parse default ACL list (%s)
could not parse initial GRANT ACL list (%s) or initial REVOKE ACL list (%s) for object "%s" (%s)
could not parse numeric array "%s": invalid character in number
could not parse numeric array "%s": too many numbers
could not parse result of current_schemas()
could not read binary "%s" could not read directory "%s": %s
could not read from input file: %s
could not read from input file: end of file
could not read input file: %s
could not read symbolic link "%s" could not reconnect to database: %s could not set default_tablespace to %s: %s could not set default_with_oids: %s could not set search_path to "%s": %s could not set seek position in archive file: %s
could not set session user to "%s": %s could not start database transaction could not uncompress data: %s
could not write to blobs TOC file
could not write to large object (result: %lu, expected: %lu)
could not write to output file: %s
could not write to the communication channel: %s
creating %s "%s"
creating %s "%s.%s"
custom archiver definition of view "%s" appears to be empty (length zero)
did not find magic string in file header
direct database connections are not supported in pre-1.3 archives
directory "%s" does not appear to be a valid archive ("toc.dat" does not exist)
directory archiver directory name too long: "%s"
disabling triggers for %s
dropping %s %s
dumping contents of table "%s.%s"
enabling triggers for %s
entering main parallel loop
entering restore_toc_entries_parallel
entering restore_toc_entries_postfork
entering restore_toc_entries_prefork
entry ID %d out of range -- perhaps a corrupt TOC
error during backup
error during file seek: %s
error processing a parallel work item
error reading large object %u: %s error reading large object TOC file "%s"
error returned by PQputCopyData: %s error returned by PQputCopyEnd: %s executing %s %s
expected %d check constraint on table "%s" but found %d
expected %d check constraints on table "%s" but found %d
expected format (%d) differs from format found in file (%d)
failed sanity check, parent OID %u of table "%s" (OID %u) not found
failed sanity check, parent table OID %u of pg_rewrite entry OID %u not found
failed sanity check, parent table OID %u of sequence OID %u not found
failed to connect to database
failed to reconnect to database
file name too long: "%s"
file offset in dump file is too large
finding check constraints for table "%s.%s"
finding default expressions of table "%s.%s"
finding extension tables
finding inheritance relationships
finding the columns and types of table "%s.%s"
finished item %d %s %s
finished main parallel loop
flagging inherited columns in subtables
found unexpected block ID (%d) when reading data -- expected %d
function "%s" not found
identifying extension members
implied data-only restore
incomplete tar header found (%lu byte)
incomplete tar header found (%lu bytes)
index "%s" not found
input file appears to be a text format dump. Please use psql.
input file does not appear to be a valid archive
input file does not appear to be a valid archive (too short?)
input file is too short (read %lu, expected 5)
internal error -- WriteData cannot be called outside the context of a DataDumper routine
internal error -- neither th nor fh specified in tarReadRaw()
invalid ENCODING item: %s
invalid OID for large object
invalid OID for large object (%u)
invalid STDSTRINGS item: %s
invalid adnum value %d for table "%s"
invalid argument string (%s) for trigger "%s" on table "%s"
invalid binary "%s" invalid client encoding "%s" specified
invalid column number %d for table "%s"
invalid column numbering in table "%s"
invalid compression code: %d
invalid dependency %d
invalid dumpId %d
invalid line in large object TOC file "%s": "%s"
invalid message received from worker: "%s"
invalid number of parallel jobs
invalid output format "%s" specified
large-object output not supported in chosen format
last built-in OID is %u
launching item %d %s %s
missing index for constraint "%s"
moving from position %s to next member at file position %s
no item ready
no matching schemas were found
no matching schemas were found for pattern "%s"
no matching tables were found
no matching tables were found for pattern "%s"
no output directory specified
not built with zlib support
now at file position %s
option --if-exists requires option -c/--clean
options --inserts/--column-inserts and -o/--oids cannot be used together
options -c/--clean and -a/--data-only cannot be used together
options -s/--schema-only and -a/--data-only cannot be used together
out of memory
out of on_exit_nicely slots
parallel archiver parallel backup only supported by the directory format
parallel restore from non-seekable file is not supported
parallel restore from standard input is not supported
parallel restore is not supported with archives made by pre-8.0 pg_dump
parallel restore is not supported with this archive file format
pclose failed: %s pgpipe: could not accept connection: error code %d
pgpipe: could not bind: error code %d
pgpipe: could not connect socket: error code %d
pgpipe: could not create second socket: error code %d
pgpipe: could not create socket: error code %d
pgpipe: could not listen: error code %d
pgpipe: getsockname() failed: error code %d
processing %s
processing data for table "%s.%s"
processing item %d %s %s
processing missed item %d %s %s
query failed: %s query produced null referenced table name for foreign key trigger "%s" on table "%s" (OID of table: %u)
query returned %d row instead of one: %s
query returned %d rows instead of one: %s
query to get data of sequence "%s" returned %d row (expected 1)
query to get data of sequence "%s" returned %d rows (expected 1)
query to get data of sequence "%s" returned name "%s"
query to get rule "%s" for table "%s" failed: wrong number of rows returned
query to obtain definition of view "%s" returned more than one definition
query to obtain definition of view "%s" returned no data
query was: %s
read TOC entry %d (ID %d) for %s %s
reading column info for interesting tables
reading constraints
reading default privileges
reading dependency data
reading event triggers
reading extensions
reading foreign key constraints for table "%s.%s"
reading indexes
reading indexes for table "%s.%s"
reading large objects
reading policies
reading policies for table "%s.%s"
reading procedural languages
reading rewrite rules
reading row security enabled for table "%s.%s"
reading schemas
reading table inheritance information
reading transforms
reading triggers
reading triggers for table "%s.%s"
reading type casts
reading user-defined access methods
reading user-defined aggregate functions
reading user-defined collations
reading user-defined conversions
reading user-defined foreign servers
reading user-defined foreign-data wrappers
reading user-defined functions
reading user-defined operator classes
reading user-defined operator families
reading user-defined operators
reading user-defined tables
reading user-defined text search configurations
reading user-defined text search dictionaries
reading user-defined text search parsers
reading user-defined text search templates
reading user-defined types
reducing dependencies for %d
restored %d large object
restored %d large objects
restoring data out of order is not supported in this archive format: "%s" is required, but comes before "%s" in the archive file.
restoring large object with OID %u
sanity check on integer size (%lu) failed
saving database definition
saving encoding = %s
saving large objects
saving search_path = %s
saving standard_conforming_strings = %s
schema "%s" not found
schema with OID %u does not exist
select() failed: %s
server version must be at least 7.3 to use schema selection switches
server version: %s; %s version: %s
skipping item %d %s %s
skipping tar member %s
sorter table "%s" could not be created, will not restore its data
table "%s" not found
tar archiver this format cannot be read
transferring dependency %d -> %d to %d
trigger "%s" not found
unexpected COPY statement syntax: "%s"
unexpected data offset flag %d
unexpected policy command type: "%s"
unexpected section code %d
unexpected tgtype value: %d
unrecognized archive format "%s"; please specify "c", "d", or "t"
unrecognized command received from master: "%s"
unrecognized constraint type: %c
unrecognized data block type %d while restoring archive
unrecognized data block type (%d) while searching archive
unrecognized encoding "%s"
unrecognized file format "%d"
unrecognized object type in default privileges: %d
unrecognized proparallel value for function "%s"
unrecognized provolatile value for function "%s"
unsupported version (%d.%d) in file header
warning from original dump file: %s
worker process failed: exit code %d
wrote %lu byte of large object data (result = %lu)
wrote %lu bytes of large object data (result = %lu)
Project-Id-Version: pg_dump-tr
Report-Msgid-Bugs-To: pgsql-bugs@postgresql.org
POT-Creation-Date: 2019-04-11 19:22+0000
PO-Revision-Date: 2019-04-12 15:03+0300
Last-Translator: Devrim GÜNDÜZ <devrim@gunduz.org>
Language-Team: Turkish <devrim@gunduz.org>
Language: tr
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Plural-Forms: nplurals=2; plural=(n != 1);
X-Generator: Poedit 1.8.7.1
X-Poedit-Basepath: /home/ntufar/pg/pgsql/src/bin/pg_dump
X-Poedit-SearchPath-0: C:/pgsql/src/bin/pg_dump
X-Poedit-SearchPath-1: /home/ntufar/pg/pgsql/src/backend
X-Poedit-SearchPath-2: c:/pgsql/src/backend
Bağlantı Seçenekleri:
Genel seçenekler:
Eğer -f/--file kullanılmazsa, SQL betiği standart çıktıya
yazılacaktır.
Veritabanı adı verilmemişse PGDATABASE çevre değişkeni
kullanılacaktır.
Eğer giriş dosya adı verilmemişse, standart giriş akımı (stdin) kulanılacaktır.
Çıktı içeriğini kontrol eden seçenekler:
Geri güklemeyi kontrol eden seçenekler:
-I, -n, -P, -t, -T, ve --section seçenekleri, çoklu nesnelerin seçilmesi için
birden fazla kez birleştirilebilir ve belirtilebilir
%s
%s [SEÇENEK]...
%s [SEÇENEK]... [VERİTABANI_ADI]
%s [SEÇENEK]... [DOSYA]
--binary-upgrade sadece yükseltme araçlarının kullanımı için
--column-inserts veriyi kolon adları ile INSERT komutları olarak yedekle
--disable-dollar-quoting dollar quoting kullanmayı engelle, standart SQL quoting kullan
--disable-triggers salt-veri geri yüklemesi sırasında tetikleyicileri devre dışı bırak
--enable-row-security satır güvenliğini etkinleştir
--enable-row-security satır güvenliğini etkinleştir (sadece kullanıcının erişimi
olan içeriği yedekle)
--exclude-table-data=TABLO bu tablo veya tabloları yedekleme
--if-exists nesneleri silerken IF EXISTS kullan
--inserts veriyi COPY'den ziyade INSERT komutları olarak yedekle
--lock-wait-timeout=ZAMANAŞIMI tablo kilitlemesi için ZAMANAŞIMI kadar bekledikten sonra hata ver
--no-data-for-failed-tables oluşturulamayan tabloların verilerini geri
yükleme
--no-security-labels güvenlik etiketi atamalarını yedekleme
--no-security-labels güvenlik etiketlerini geri yükleme
--no-synchronized-snapshots paralel işlerde senkronize anlık görüntüleri yedekleme
--no-tablespaces tablespace atamalarını yedekleme
--no-tablespaces tablespace atamalarını geri yükleme
--no-unlogged-table-data loglanmayan tablo verisini yedekleme
--quote-all-identifiers anahtar sözcükler olmasa bile tüm belirteçleri çift tırnak içine al
--role=ROL ADI yedek işleminden önce SET ROLE çalıştır
--role=ROL ADI geri yüklemeden önce SET ROLE işlemini gerçekleştir
--section=BÖLÜM belirtilen bölümü yedekle (pre-data, data, veya post-data)
--section=BÖLÜM belirtilen bölümü yedekle (pre-data, data, veya post-data)
--serializable-deferrable yedeğin bir anormallik olmadan biteceği ana kadar bekle
--snapshot=SNAPSHOT yedek için verilen anlık görüntüyü (snapshot) kullan
--strict-names tablo ve/veya şema her biri en az bir varlıkla (entity)
eşleşecek desenler (pattern) bulundurmalıdır
--use-set-session-authorization
Sahipliği ayarlamak için ALTER OWNER komutları yerine
SET SESSION AUTHORIZATION komutlarını kullan
-1, --single-transaction tek bir transaction olarak geri yükle
-?, --help bu yardımı gösterir ve sonra çıkar
-?, --help bu yardımı gösterir ve sonra çıkar
-C, --create hedef veritabanını oluştur
-C, --create yedeğin (dump) içine veritabanını oluşturacak komutları da ekle
-E, --encoding=DİLKODLAMASI veriyi DİLKODLAMASI dil kodlamasıyla yedekle
-F, --format=c|d|t yedek dosya biçimi (otomatik olmalı)
-F, --format=c|d|t|p çıktı dosya biçimi (c:özel, d:dizin, t:tar,
p: düz metin (varsayılan))
-I, --index=NAME adı geçen indeksi geri yükle
-L, --use-list=DOSYA ADI çıktıyı seçmek/sıralamak için
bu dosyadaki içindekiler tablosunu kullan
-N, --exclude-schema=ŞEMA bu şema veya şemaları yedekleme
-O, --no-owner veri sahipliği ile ilgili bilgileri geri yükleme
-O, --no-owner düz metin biçiminde nesne
sahipliğinin yüklenmesini atla
-P, --function=NAME(args) adı geçen fonksiyonu geri yükle
-S, --superuser=NAME triggerları devre dışı bırakmak için kullanılacak superuser kullanıcı adı
-S, --superuser=İSİM düz metin formatında kullanılacak superuser kullanıcı adı
-S, --superuser=AD yedeklerde kullanılacak superuser kullanıcı adı
-T, --exclude-table=TABLO ismi geçen tablo veya tabloları yedekleme
-T, --trigger=NAME adı geçen tetikleyiciyi geri yükle
-U, --username=KULLANICI_ADI bağlanılacak kullanıcı adı
-V, --version sürüm bilgisini göster, sonra çık
-V, --version sürüm bilgisini gösterir ve sonra çıkar
-W şifre sor (otomatik olarak her zaman açık)
-Z, --compress=0-9 sıkıştırılmış biçimler için sıkıştırma seviyesi
-a, --data-only sadece veriyi yedekle (dump); şemayı yedekleme
-a, --data-only sadece veriyi geri yükle, şemaları değil
-b, --blobs yedeğin (dump) içine büyük nesneleri dahil et
-c, --clean veritabanı nesnelerini yeniden oluşturmadan önce temizle (kaldır)
-c, --clean veritabanı nesnelerini yeniden oluşturmadan önce temizle (kaldır)
-d, --dbname=CONNSTR bağlantı cümleciğini kullanarak bağlan
-d, --dbname=VERİTABANI_ADI yedeklenecek veritabanı adı
-d, --dbname=NAME bağlanacak veritabanının adı
-e, --exit-on-error hata durumunda çık, varsayılan seçenek ise devam et
-f, --file=DOSYA_ADI çıktı dosya adı
-f, --file=DOSYAADI çıktı dosya adı ya da dizin adı
-f, --file=DOSYA_ADI çıktı dosya adı
-g, --globals-only sadece global nesneleri yedekle, veritabanlarını yedekleme
-h, --host=HOSTNAME veritabanı sunucusu adresi ya da soket dizini
-j, --jobs=SAYI döküm (dump) için belirtilen sayı kadar paralel süreç kullan
-j, --jobs=SAYI geri yükleme için belirtilen sayı kadar paralel süreç kullan
-l, --database=VERİTABANI ADI varsayılan alternatif veritabanı
-l, --list arşivin kısa içeriğini yaz
-s, --schema=NAME sadece bu şemaya ait nesneleri yükle
-n, --schema=ŞEMA sadece belirtilen şema veya şemaları yedekle
-o, --oids yedeğin içine OID'leri de ekle
-p PORT veritabanı sunucusunun port numarası
-r, --roles-only sadece rolleri yedekle, veritabanlarını ya da tablespace'leri yedekleme
-s, --schema-only sadece şemayı yedekle (dump), veriyi değil
-s, --schema-only sadece şemayı yükle, veriyi yükleme
-t, --table=NAME adı geçen nesneyi (tablo, görünüm, vb.) geri yükle
-t, --table=TABLO sadece ismi geçen tablo veya tabloları yedekle
-t, --tablespaces-only sadece tablespace'leri yedekle, veritabanlarını ya da rolleri değil
-v, --verbose detaylı açıklamalı mod
-v, --verbose verbose modu
-w, --no-password bağlanmak için kesinlikle parola sorma
-x, --no-privileges yetkileri yedekleme (grant/revoke)
-x, --no-privileges erişim haklarının geri yüklemesini atla (grant/revoke)
%s %s veritabanını metin dosyası ya da diğer biçimlerde dump eder.
%s, PostgreSQL veritabanı clusteri SQL betik dosyasına aktarıyor.
%s, pg_dump tarafından oluşturulan PostgreSQL arşivinden veritabanı geri yükleniyor.
%s: %s Komut şuydu: %s
%s: WSAStartup başarısız: %d
%s: --single-transaction ve çoklu işi aynı anda belirtemezsiniz
%s: "%s" veritabanına bağlanılamadı
%s: "%s" veritabanına bağlanılamadı: %s %s: "postgres" veya "template1" veritabanına bağlanılamadı
Lütfen alternatif bir veritabanı belirtin
%s: sunucu sürüm bilgisi alınamadı
%s: "%s" çıktı dosyası açılamadı: %s
%1$s: "%3$s" veritabanı için ACL (%2$s) listesi ayrıştırılamadı
%1$s: "%3$s" tablespace için ACL (%2$s) listesi ayrıştırılamadı
%s: "%s" sürüm bilgisi ayrıştırılamadı
%s: "%s" çıktı dosyası yeniden açılamadı: %s
%s: "%s" veritabanı aktarılıyor...
%s: %s yürütülüyor
%s: parallel iş sayısı geçersiz
%s: azami paralel iş sayısı %d
%s: --if-exists seçeneği -c/--clean seçeneğini gerektirir
%s: options -c/--clean ve -a/--data-only seçenekleri aynı anda kullanılamazlar
%s: -d/--dbname ve -f/--file seçenekleri birarada kullanılamazlar
%s: -g/--globals-only ve -r/--roles-only seçenekleri beraber kullanılamaz
%s: -g/--globals-only ve -t/--tablespaces-only seçenejleri beraber kullanılamaz
%s: -r/--roles-only ve -t/--tablespaces-only seçenekleri birlikte kullanılamaz
%s: options -s/--schema-only ve -a/--data-only seçenekleri aynı anda kullanılamazlar
%s: pg_dump "%s" veritabanında başarısız oldu, çıkılıyor
%s: sorgu başarısız oldu: %s %s: sorgu şu idi: %s
%s: "pg_" ile başlayan rol adı atlandı (%s)
%s: "%s" yürütülüyor
%s: çok fazla komut satırı argümanı (ilki "%s" idi)
%s: bilinmeyen bölüm adı "%s"
(INSERT komutu OIDleri ayarlayamaz.)
(Sistem kataloğu bozulmuş olabilir.)
-C and -1 uyumsuz seçeneklerdir
COPY "%s" tablosu için başarısız oldu: %s Bu sorunla karşılaşmamak için --data-only yedek yerine tam yedek (full dump) almayı düşünün.
"%s" tablosunu içeriğinin aktarımı başarısız: PQgetCopyData() başarısız.
"%s" tablosunu içeriğinin aktarımı başarısız: PQgetResult() başarısız.
TOC girişte hata %d; %u %u %s %s %s
Sunucudan hata mesajı alındı: %s FINALIZING sırasında hata:
INITIALIZING sırasında hata:
PROCESSING TOC sırasında hata:
Bu sunucu sürümünde dışa aktarılmış anlık görüntü (exported snapshot) desteklenmemektedir.
DİKKAT: bu tabloda dairesel foreign-key kısıtlamaları bulunuyor:
DİKKAT: bu tablolar arasında dairesel foreign-key kısıtlamaları bulunuyor:
Şifre: Hataları <pgsql-bugs@postgresql.org> adresine bildirin.
Senkronize anlık görüntüler (snapshot) bu sunucu sürümü tarafından desteklenmiyor.
Senkronize anlık görüntülere ihtiyaç yoksa bunun yerine --no-synchronized-snapshots
ile çalıştırın.
Yedek (standby) sunucularda anlık görüntüler (snapshot) bu sunucu sürümünde desteklenmiyor.
Senkronize anlık görüntülere ihtiyaç yoksa bunun yerine --no-synchronized-snapshots
ile çalıştırın.
%2$s adresinde %1$s TOC Girişi (uzunluk %3$s, sağlama toplamı %4$d)
O sırada yürütülen komut: %s
"pg_dump" uygulaması %s için gerekmektedir ancak
"%s" ile aynı dizinde bulunamadı.
Kurulumunuzu kontrol edin.
"pg_dump" uygulaması "%s" tarafından bulundu
ancak %s ile aynı sürüm değildir.
Kurulumunuzu kontrol edin.
Daha fazla bilgi için "%s --help" yazabilirsiniz.
Kullanımı:
UYARI: %s aggregate fonksiyonu veritabanın bu sürümünde düzgün dump edilemiyor; atlanıyor
UYARI: arşiv sıkıştırılmıştır, ancak bu kurulum sıkıştırmayı desteklemiyor -- veri kaydedilmeyecek
UYARI: arşiv öğeleri doğru bölüm sırasında değil
UYARI: arşıv doyası daha büyük integer sayılarına sahip platformda yapılmış, bazı işlemler başarısız olabilir
UYARI: belirsiz dönüşüm tanımı, trffromsql ve trftosql'in en azından biri sıfırdan farklı olmalı
UYARI: pg_cast.castmethod field alanı içinde belirsiz değer
UYARI: pg_cast.castmethod field alanı içinde belirsiz değer
UYARI: pg_transform.trffromsql alanı içinde beklenmeyen değer
UYARI: pg_transform.trftosql alanı içinde beklenmeyen değer
UYARI: proargnames dizisi içinde beklenmeyen değer
UYARI: OID %s olan operatör bulunamadı
UYARI: "%s" ifadesinde nereye IF EXISTS ekleneceği bulunamadı
UYARI: proallargtypes dizisi ayrıştırılamadı
UYARI: proargmodes dizisi ayrıştırılamadı
UYARI: proargnames dizisi ayrıştırılamadı
UYARI: proconfig dizisi ayrıştırılamadı
UYARI: reloptions dizisi (array) ayrıştırılamadı
UYARI: bu öğeler arasındaki bağımlılık döngüsü çözülemedi
UAYRI: "%s" nesne tipi için sahip bilgisinin nasıl ayarlanacağı bilinmiyor
UYARI: yükleme sırasında hata es geçildi: %d
WARNING: ftell fonksiyonun bidirdiği pozisyonu ile beklenen pozisyon uyumsuz -- ftell kullanıldı
UTAYI: veri başlığında geçersiz tarih
UYARI: "%2$s" erişim yöntemi için geçersiz tip "%1$c"
UYARI: satır yoksayıldı: %s
UYARI: "%s" aggregate fonksiyonun sahibi geçersizdir
UYARI: "%s" veri tipinin sahibi geçersizdir
UYARI: "%s" fonksiyonunun sahibi geçersizdir
UYARI: "%s" operatörün sahibi geçersizdir
UYARI: "%s" operator sınıfının sahibi geçersizdir
UYARI: "%s" operatör ailesinin sahibi geçersizdir
UYARI: "%s" şemasının sahibi geçersizdir
UYARI: "%s" tablosunun sahibi geçersizdir
UYARI: bu kurulumda sıkıştırma desteklenmemektedir -- arşiv sıkıştırılmayacak
UYARI: "%s" veri tipinin typtype'i geçersiz görünüyor
WARNING: "%s" tablosunun COPY işlemi sırasında beklenmeyen ilave sonuçlar
--disable-triggers kullanmadan veya kısıtlamaları (constraint) geçici olarak kaldırmadan yedeği (dump) geri yükleyemebilirsiniz.
alt süreç beklenmeyen biçimde sonlandı
sunucu sürümü uyuşmazlığına rağmen devam ediliyor
gerçek dosya uzunluğu (%s) beklenen uzunluğu (%s) ile uyuşmamaktadır
%s için AH ayırılıyor, biçim %d
bir veritabanına zaten bağlı
archiver archiver (db) arşiv formatı doğrulanmaya çalışılıyor
kötü dumpId
TABLE DATA öğesi için kötü tablo dumpId'si
Sadece girdi arşivleri tekrar açılabilir
null pointer duplicate edilemiyor (iç hata)
sıkıştırılmış arşivden yükleme başarısız (bu kurulumda sıkıştırma desteklenmiyor)
alt süreç %d çıkış koduyla sonuçlandırılmıştır alt süreç %d bilinmeyen durumu ile sonlandırılmıştır alt süreç 0x%X exception tarafından sonlandırılmıştır alt süreç %d sinyali tarafından sonlandırılmıştır alt süreç %s sinyali tarafından sonlandırılmıştır komut çalıştırılabilir değil komut bulunamadı compress_io sıkıştırma, tar çıktı formatı tarafından desteklenmiyor
sıkıştırma seviyesi 0..9 aralığında olmalı
sıkıştırma etkin
"%2$s" kullanıcısı olarak "%1$s" veritabanına bağlanıldı
geri yükleme için veritabanına bağlanılıyor
"%s" veritabanına bağlanılıyor
bağlantı parola gerektiriyor
"%s" veritabanına bağlantı başarısız oldu: %s %s dosyasında bozuk tar başlığı (beklenen: %d, hesaplanan: %d) dosya pozisyonu %s
çalışma dizini "%s" olarak değiştirilemedi: %s TOC dosyası kapatılamıyor: %s
arşiv dosyası kapatma hatası: %s
sıkıştırma kütüphanesi kapatılamadı: %s
sıkıştırma akımı kapatılamadı: %s
veri dosyası kapatılamadı: %s
"%s" dizini kapatılamadı: %s
çıktı dosyası kapatılamadı: %s
"%s" large object TOC dosyası kapatılamadı: %s
çıktı dosyası kapatılamadı: %s
tar öğesi kapatılamadı
geçici dosya kapatma hatası: %s
Veritabanı transaction'u commit edilemedi veri sıkıştırılamadı: %s
iletişim kanalları oluşturulamadı: %s
"%s" dizini oluşturulamadı: %s
%u large object oluşturulamadı: %s işçi süreci yaratılamadı: %s
arşiv dosyasınde arama pozisyonu belirlenemedi: %s
sorgu çalıştırılamadı "%s" çalıştırmak için bulunamadı %d blok ID'si arşivde bulunamadı -- arşiv bozulmuş olabilir
arşivde %d block ID'si bulunamadı -- arşivdeki eksik veri konumu nedeniyle işlenemeyen geçersiz yükleme isteği nedeniyle olabilir
arşivde %d block ID'si bulunamadı -- aranamayan girdi dosyası nedeniyle işlenemeyen geçersiz yükleme isteği nedeniyle olabilir
ID %d için bir alan girdisi bulunamıyor
"%s" dosyası arşivde bulunamadı
OID %u olan fonksiyon için fonksiyon tanımı bulunamadı
tar arşivinde "%s" dosyası için başlık bulunamadı
%s için üst uzantı bulunamadı %s
bitmiş sürecin yuvasu bulunamadı
geçici dosya adı oluşturulamadı: %s
libpq kütüphanesinden server_version alınamadı
geçerli dizin tespit edilemedi: %s bağımlılık döngüsü tespit edilemedi
sıkıştırma kütüphanesi ilklendirilemedi: %s
"%s" nesnesi üzerinde kilit alınamadı
Bu genellikle pg_dump ana süreci tablo üzerinde başta ACCESS SHARE kilidi aldıktan sonra başka birinin tablo üzerinde ACCESS EXCLUSIVE kilidi talep ettiği anlamına gelir.
"%s" TOC dosyası girdi için açılamadı: %s
çıktı için "%s" TOC dosyası açılamadı: %s
"%s" TOC dosyası açılamadı: %s
girdi için TOC dosyası açılamadı: %s
çıktı için TOC dosyası açılamadı: %s
"%s" giriş dosyası açılamadı: %s
giriş dosyası açılamadı: %s
%u large object açılamadı: %s girdi için "%s" large object TOC dosyası açılamadı: %s
"%s" çıktı dosyası açılamadı: %s
çıktı dosyası açılamadı: %s
geçici dosya açılamadı
"%3$s" nesnesinin GRANT ACL listesi (%1$s) veya REVOKE ACL listesi (%2$s) ayrıştırılamıyor (%4$s)
öntanımlı ACL listesi ayrıştırılamıyor (%s)
"%3$s" nesnesinin ilk GRANT ACL listesi (%1$s) veya ilk REVOKE ACL listesi (%2$s) ayrıştırılamıyor (%4$s)
"%s" numerik dizisi ayrıştırılamadı: sayıda geçersiz karakter
"%s" numerik dizisi ayrıştırılamadı: çok fazla sayı
current_schemas() sonucu ayrıştırılamıyor
"%s" ikili (binary) dosyası okunamadı "%s" dizini okunamıyor: %s
giriş dosyası okuma hatası: %s
giriş dosyası okuma hatası: dosya sonu
giriş dosyası okuma hatası: %s
symbolic link "%s" okuma hatası %s veritabanına yeniden bağlanılamadı default_tablespace %s olarak değiştirilemedi: %s default_with_oids ayarlanamıyor: %s search_path "%s" olarak değiştirilemedi: %s arşiv dosyasında arama pozisyonu ayarlanamadı: %s
oturum kullanıcısını "%s" olarak değiştirilemedi: %s ;veritabanı transaction'u başlatılamadı sıkıştırılmış veri açılamadı: %s
blobs TOC dosyası yazma hatası
large-object yazılamıyor (sonuç: %lu, beklenen: %lu)
çıktı dosyasına yazma başarısız: %s
iletişim kanalına yazma başarısız: %s
%s oluşturuluyor "%s"
%s oluşturuluyor "%s.%s"
custom archiver "%s" vew tanımı boştur (uzunluk sıfır)
dosya başlığında kod satırı blunamadı
1.3 sürüm öncesi arşivlerinde doğrudan veritabanı bağlantıları desteklenmemektedir
"%s" dizini geçerli bir arşiv olarak görünmüyor ("toc.dat" bulunamadı)
directory archiver dizin adı çok uzun:: "%s"
%s nesnesinin tetikleyicileri etkisiz hale getiriliyor
%s %s kaldırılıyor
"%s.%s" tablosunun içeriği yedekleniyor
%s nesnesinin tetikleyicileri etkineştiriliyor
ana paralel döngüye giriyor
restore_toc_entries_parallel'e giriliyor
restore_toc_entries_postfork'a giriliyor
restore_toc_entries_prefork'a giriliyor
ID %d olan giriş kapsam dışıdır -- bozuk TOC olabilir
yedek alma sırasında hata oluştu
dosya içerisinde gösterge ilerleme hatası: %s
bir paralel iş öğesinin işlenmesinde hata oluştu
%u large object okurken hata oldu: %s "%s" large object TOC dosyası okuma hatası
PQputCopyData'nın döndürdüğü hata: %s PQputCopyEnd'in döndürdüğü hata: %s %s %s yürütülüyor
%d check kısıtlamasının "%s" tablosunda bulunması beklendi; ancak %d bulundu
%d check kısıtlamasının "%s" tablosunda bulunması beklendi; ancak %d bulundu
dosyada bulunan biçim (%2$d) beklenen biçimden (%1$d) farklıdır
tutarlılık kontrolü başarısız, "%2$s" tablosunun (OID %3$u) üst OID %1$u bulunamadı
tutarlılık kontrolü başarısız, üst tablo OID'inin %u, pg_rewrite girdisi OID'i %u bulunamadı
tutarlılık kontrolü başarısız, %2$u OID'li dizinin (sequence) %1$u OID'li üst tablosu bulunamadı
veritabanına bağlantı başarısız oldu
veritabanına yeniden bağlanma hatası
dosya adı çok uzun: "%s"
dump dosyasında dosya göstergesi çok büyük
"%s.%s" tablosu için kontrol kısıtlamaları bulunuyor
"%s.%s" tablosu için varsayılan ifadeler aranıyor
uzantı tabloları bulunuyor
inheritance ilişkiler bulunuyor
"%s.%s" tablosunun sütunları ve tipleri bulunuyor
%d %s %s öğesi bitirildi
ana paralel döngü bitti
alt tablolarında inherited sütunlar işaretleniyor
veriyi okurken beklenmeyen blok ID (%d) bulundu -- beklenen: %d
"%s" fonksiyonu bulunamadı
uzantı üyeleri belirleniyor
örtük salt veri geri yükleme
Eksik tar başlığı bulundu (%lu byte)
Eksik tar başlığı bulundu (%lu byte)
"%s" indeksi bulunamadı
girdi dosyası metin biçiminde bir döküm (dump) gibi görünüyor. Lütfen psql kullanın.
girdi geçerli bir arşiv değildir
giriş, geçerli bir arşiv değildir (çok kısa?)
giriş fazla kısa (okunan: %lu, beklenen: 5)
İç hata - WriteData cannot be called outside the context of a DataDumper routine
iç hata - th ya da fh, tarReadRaw() içinde belirtilmedi
geçersiz ENCODING öğesi: %s
large object için geçersiz OID
(%u) large objecti için geçersiz OID
geçersiz STDSTRINGS öğesi: %s
"%2$s" tablosu için geçersiz adnum değeri %1$d
"%3$s" tablosunun "%2$s" tetikleyicisi için geçersiz satır argümanı (%1$s)
geçersiz ikili (binary) "%s" belirtilen "%s" istemci dil kodlaması geçersiz
"%2$s" tablosu için geçersiz sütun numarası %1$d
"%s" tablosunda geçersiz sütun numaralandırması
geçersiz sıkıştırma kodu: %d
geçersiz bağımlılık %d
geçersiz dumpId %d
"%s" large object TOC dosyasında geçersiz satır: %s
alt süreçten (worker) geçersiz mesaj alındı: "%s"
parallel iş sayısı geçersiz
Geçersiz çıktı biçimi belirtildi: "%s"
seçilen biçimde large-object çıktısı desteklenememektedir
Son gömülü OID : %u
%d %s %s öğesi başlatılıyor
"%s" bütünlük kısıtlamasının indexi eksik
dosya içerisinde %s yerinden bir sonraki %s yerine geçiş yapılamıyor
hiç bir öğe hazır değil
uygun şema bulunamadı
"%s" şablonu (pattern) için eşleşen şema bulunamadı
uygun tablo bulunamadı
"%s" şablonu (pattern) için eşleşen tablo bulunamadı
herhangi bir çıktı dizini belirtilmedi
zlib desteği ile build edilmemiş
şu an dosyanın %s yerinde
--if-exists seçeneği -c/--clean seçeneğini gerektirir
--inserts/--column-inserts ve -o/--oids birlikte kullanılamaz
-c/--clean ve -a/--data-only seçenekleri birlikte kullanılamaz
-s/--schema-only ve -a/--data-only seçenekleri birlikte kullanılamaz
yetersiz bellek
on_exit_nicely slotları yetersiz
parallel archiver paralel yedek sadece dizin biçimi tarafından destekleniyor
taranamayan dosyadan paralel geri yükleme desteklenmiyor
standart girdiden paralel geri yükleme desteklenmiyor
paralel geri yükleme özelliği 8.0 öncesi pg_dump ile yapılan arşivleri desteklememektedir
paralel geri yükleme bu arşiv biçimini desteklemiyor
pclose başarısız oldu: %s pgpipe: bağlantı kabul edilemedi: hata kodu %d
pgpipe: bağlanamadı (bind): hata kodu %d
pgpipe: soket bağlanamadı: hata kodu %d
pgpipe: ikinci soket oluşturulamadı: hata kodu %d
pgpipe: socket oluşturulamadı: hata kodu %d
pgpipe: dinleyemedi: hata kodu %d
pgpipe: getsockname() başarısız oldu: çıkış kodu %d
%s işleniyor
"%s.%s" tablosu için veri işleniyor
%d %s %s öğesi işleniyor
atlanan %d %s %s öğesi işleniyor
sorgu başarısız oldu: %s "%2$s" tablosu üzerindeki "%1$s" foreign key tetikleyici için sorgu, null referans edilen tablo sayısı getirdi (tablo OID: %3$u)
sorgu 1 yerine %d satır döndürdü: %s
sorgu 1 yerine %d satır döndürdü: %s
"%s" sequence verisini getirecek sorgu %d satır döndürdü (bir satır bekleniyordu)
"%s" sequence verisini getirecek sorgu %d satır döndürdü (bir satır bekleniyordu)
"%s" sequence verisini getirecek sorgu "%s" adını getirdi
"%s" tablosundan "%s" rule'unu getiren sorgu başarısız: yanlış satır sayısı döndürüldü
"%s" vew tanımını getirecek sorgu birden çık tanımı getirdi
"%s" vew tanımını getirecek sorgu hiçbir veri getirmedi
sorgu şu idi: %s
%3$s %4$s için TOC öğe %1$d (ID %2$d) okunuyor
ilgili tabloların sütun bilgisi okunuyor
bütünlük kısıtlamaları okunuyor
öntanımlı yetkiler okunuyor
bağımlılık verileri okunuyor
olay tetikleyicileri okunuyor
uzantılar okunuyor
"%s.%s" tablosunun foreign key bütünlük kısıtlamaları okunuyor
indexler okunuyor
"%s.%s" tablosunun indeksleri okunuyor
large objectler okunuyor
ilkeler okunuyor
"%s.%s" tablosu için ilkeler (policy) okunuyor
yordamsal diller okunuyor
rewrite ruleler okunuyor
"%s.%s" tablosu için etkinleştirilen satır güvenliği (row security) okunuyor
şemalar okunuyor
kullanıcı tanımlı inheritance bilgisi okunuyor
dönüşümler okunuyor
tetikleyiciler okunuyor
"%s.%s" tablosunun tetikleyicileri okunuyor
type castlar okunuyor
kullanıcı tanımlı erişim yöntemleri okunuyor
kullanıcı-tanımlı aggregate fonksiyonlar okunuyor
kullanıcı tanımlı collationlar okunuyor
kullanıcı tanımlı dönüşümler okunuyor
kullanıcı tanımlı foreign sunucular okunuyor
kullanıcı tanımlı foreign-data wrapperlar okunuyor
kullanıcı tanımlı fonksiyonlar okunuyor
kullanıcı-tanımlı operatör sınıfları okunuyor
kullanıcı tanımlı operatör aileleri okunuyor
kullanıcı tanımlı operatörler okunuyor
kullanıcı tanımlı tablolar okunuyor
kullanıcı-tanımlı metin arama yapılandırmaları okunuyor
kullanıcı-tanımlı metin arama sözlükleri okunuyor
kullanıcı tanımlı metin arama ayrıştırıcıları okunuyor
kullanıcı tanımlı metin arama şablonları okunuyor
kullanıcı tanımlı tipler okunuyor
%d için bağımlılıklar azaltılıyor
%d large object geri yüklendi
%d large object geri yüklendi
bu arşiv biçinide sıra dışı veri geri yüklemesi desteklenmemektedir: "%s" bekleniyor ancak arşiv dosyasında %s ondan önce gelmektedir.
large-object OID %u geri yükleniyor
integer boyutu (%lu) turtarlılık kontrolü başarısız
veritabanın tanımı kaydediliyor
dil kodlaması = %s
large objectler kaydediliyor
search_path = %s olarak kaydediliyor
kaydedilen: standard_conforming_strings = %s
"%s" şeması bulunamadı
OID %u olan şema mevcut değil
select() başarısız oldu: %s
şema seçim anahtarlarını kullanmak için sunucu sürümü 7.3 ya da daha yüksek olmalıdır
sunucu sürümü: %s; %s sürümü: %s
%d %s %s öğesi atlanıyor
%s tar öğesi atlandı
sorter "%s" tablosu oluşturulamadı, onun verileri yüklenmeyecektir
"%s" tablosu bulunamadı
tar archiver bu biçim okunamıyor
%d -> %d bağımlılığı %d olarak aktarılıyor
"%s" tetikleyicisi bulunamadı
beklenmeyen COPY ifadesi söz dizimi: "%s"
beklenmeyen veri konum bayrağı %d
beklenmeyen ilke (policy) komut türü: "%s"
beklenmeyen bölüm kodu %d
beklenmeyen tgtype değeri: %d
tanımlanamayan arşiv formatı "%s"; lütfen "c", "d", ya da "t" seçeneklerinden birisini belirtiniz.
ana sunucudan (master) bilinmeyen komut alındı: "%s"
bilinmeyen bütünlük kısıtlama türü: %c
arşivi yüklerken bilinmeyen veri blok tipi %d bulundu
arşivde ararken tanınmayan veri tipine (%d) rastlandı
tanınmayan dil kodlaması: "%s"
tanınmayan dosya biçimi: "%d"
öntanımlı yetkilerde bilinmeyen nesne tipi: %d
"%s" fonksiyonu için bilinmeyen proparalel değeri
"%s" fonksiyonu için bilinmeyen provolatile değeri
dosya başlığında desteklenmeyen sürüm (%d.%d)
asıl dump dosyasından uyarı: %s
alt süreç başarısız oldu: çıkış kodu %d
large object verisinin %lu baytı yazıldı (sonuç = %lu)
large object verisinin %lu baytı yazıldı (sonuç = %lu)
locale/tr/LC_MESSAGES/ecpglib6-9.6.mo 0000644 00000007227 14751153420 0012571 0 ustar 00 �� ! $ / , � � � � ) ' - Q : 0 � $ � ( 9 L * c ; � > � 3 < = & z 1 � � + � ' @ % Y � , � � 2 0 ; / l f � : - K 4 y H � 2 � / *
= Z
�
�
1 �
F �
N : C � S � ( ! G J � 2 � . �
/
' K
$ s
D �
, �
-
- 8 0 f
! <DEFAULT> <empty> NULL SQL error %d on line %d SQL error: %s
connection "%s" does not exist on line %d could not connect to database "%s" on line %d could not convert boolean value: size mismatch, on line %d data read from server is not an array on line %d descriptor "%s" not found on line %d descriptor index out of range on line %d empty message text empty query on line %d error in transaction processing on line %d inserting an array of variables is not supported on line %d invalid input syntax for floating-point type: "%s", on line %d invalid input syntax for type int: "%s", on line %d invalid input syntax for type unsigned int: "%s", on line %d invalid statement name "%s" on line %d invalid syntax for type boolean: "%s", on line %d no data found on line %d not connected to connection "%s" on line %d null value without indicator on line %d out of memory on line %d the connection to the server was lost too few arguments on line %d too many arguments on line %d unrecognized descriptor item "%s" on line %d unsupported type "%s" on line %d variable does not have a character type on line %d variable does not have a numeric type on line %d variable does not have an array type on line %d Project-Id-Version: PostgreSQL 8.4
Report-Msgid-Bugs-To: pgsql-bugs@postgresql.org
POT-Creation-Date: 2010-08-31 20:08+0000
PO-Revision-Date: 2013-09-04 20:47-0400
Last-Translator: Devrim GÜNDÜZ <devrim@gunduz.org>
Language-Team: TR <devrim@gunduz.org>
Language: tr
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: 8bit
<ÖNTANIMLI> <boş> NULL %d SQL hatası (%d. satırda) SQL hatası: %s
"%s" bağlantısı %d numaralı satırda yok "%s" veritabanına bağlanılamadı (satır no: %d) boolean değer dönüştürülemedi: boyut uyuşmazlığı, %d. satırda %d. satırda sunucudan okunan veri bir dizi değil "%s" açıklayıcısı %d. satırda bulunamadı %d. satırdaki açıklayıcı indexi sınırların dışında Boş mesaj metni %d. satırda boş sorgu %d. satırda tranaction'ı işlerken hata oluştu %d. satırda değişkenlerden oluşan dizinin girilmesi desteklenmiyor kayan noktalı veri tipi için geçersiz girdi sözdizimi: "%s", %d. satırda int veri tipi için geçersiz girdi sözdizimi: "%s", %d. satırda işaretsiz tamsayı veri tipi için geçersiz girdi sözdizimi: "%s", %d. satırda "%s" ifade adı geçersiz (%d. satırda) boolean veri tipi için geçersiz girdi sözdizimi: "%s", %d. satırda %d. satırda veri bulunamadı "%s" bağlantısına %d. satırda bağlanılmıyor %d. satırda belirteç olmadan null değer var %d. satırda yetersiz bellek sunucuya bağlantı kesildi %d. satırda yetersiz argüman sayısı %d. satırda çok fazla argüman var "%s" tanımsız açıklayıcı nesnesi %d. satırda tanımlanamıyor "%s" veri tipi (%d. satırda) desteklenmiyor %d. satırdaki değişkenin karakter tipi yok %d. satırdaki değişkenin sayısal tipi yok %d. satırda değişkenin bir dizi veri tipi yok locale/tr/LC_MESSAGES/pg_rewind-9.6.mo 0000644 00000046435 14751153420 0013060 0 ustar 00 �� � 4 � L
�
- �
1 �
? ) K i C � ; � C 5 9 y G � @ � < O H � � � � J > i , � 6 � < 1 I ? { = � = � 9 7 D q 4 � 9 � 4 % 2 Z @ � R � > ! ` g 1 � � � � � o
d z - � 4
& B i � � P R W c � - < [ / y ; � � � # ; _ % ~ � $ � + � $ : $ X L } , � 0 � " ( ) K , u � $ � $ � #
' . " V y " � & � $ � ( & O " p ' � � � � 2 - ' ` � ' � � / � - K 6 i � ; � ) � ! + 8! % d! �! �! ! �! 3 �! 6 " 1 K" }" ' �" < �" _ # a# u# ! �# F �# �# $ $ 1 8$ C j$ " �$ . �$ # % > $% 6 c% 3 �% 6 �% 0 & 6& + Q& & }& �& �& ! �& ( ' I /' $ y' ' �' �' - �' J ( = \( A �( 6 �( 5 ) 5 I) ! ) 7 �) / �) 6 * 1 @* - r* 9 �* U �* C 0, A t, ? �, F �, C =- C �- C �- 8 . H B. H �.
�. L �. ,/ ' C/ k/ �/ �/ �/ V �/ < 0 ' W0 5 0 < �0 4 �0 R '1 G z1 A �1 6 2 H ;2 6 �2 B �2 5 �2 ; 43 K p3 a �3 L 4
k4 0 y4 K �4 �4
5 # !5 " E5 } h5 m �5 0 T6 N �6 * �6 �6 � 7 Y �7 [ 8 i c8 B �8 - 9 ' >9 - f9 4 �9 �9 . �9
: +: ! K: ' m: �: ! �: + �: " �: !; # @; J d; ( �; , �; < + $< > P< �< & �< % �< ! �< % = D= a= $ = # �= �= �= ) > ( ,> & U> . |> �> + �> �> ? 3 .? . b? 7 �? < �? ! @ @ (@ - i@ $ �@ < �@ �@ 9 A 7 QA & �A 5 �A 7 �A B $ :B ( _B : �B ? �B B C ( FC 6 oC 9 �C b �C CD cD * tD R �D �D
E )E @ GE Q �E 8 �E A F * UF X �F U �F 2 /G / bG 7 �G �G 4 �G $ H 0 ?H & pH , �H 1 �H \ �H / SI 5 �I $ �I 4 �I O J E cJ [ �J 6 K 6 <K 7 sK $ �K 5 �K 6 L ; =L 0 yL 2 �L ? �L � & 5 � Z ~ � � � \ > t ! r � K � � % < f V � 1 } { : � k . b G
h S 6 � d � 8 � m J ( n ` s � � � A 9 � v E # � � 0 $ w 3 � � � a Q j � z � � ) � ^
C y M F ? i 2 c R e u � / o @ � ; � T Y x U + g N | _ L � I O H 4 P l = � � [ ' q , X - � � D B W ] " * � 7 p �
Report bugs to <pgsql-bugs@postgresql.org>.
creating backup label and updating control file
--debug write a lot of debug messages
--source-pgdata=DIRECTORY source data directory to synchronize with
--source-server=CONNSTR source server to synchronize with
-?, --help show this help, then exit
-D, --target-pgdata=DIRECTORY existing data directory to modify
-P, --progress write progress messages
-V, --version output version information, then exit
-n, --dry-run stop before modifying anything
block %u
"%s" is a symbolic link, but symbolic links are not supported on this platform
"%s" is not a directory
"%s" is not a regular file
"%s" is not a symbolic link
%*s/%s kB (%d%%) copied %d: %X/%X - %X/%X
%s (%s)
%s resynchronizes a PostgreSQL cluster with another copy of the cluster.
%s: WARNING: cannot create restricted tokens on this platform
%s: could not allocate SIDs: error code %lu
%s: could not create restricted token: error code %lu
%s: could not get exit code from subprocess: error code %lu
%s: could not open process token: error code %lu
%s: could not re-execute with restricted token: error code %lu
%s: could not start process for command "%s": error code %lu
%s: no source specified (--source-pgdata or --source-server)
%s: no target data directory specified (--target-pgdata)
%s: only one of --source-pgdata or --source-server can be specified
%s: too many command-line arguments (first is "%s")
BKPBLOCK_HAS_DATA not set, but data length is %u at %X/%X BKPBLOCK_HAS_DATA set, but no data included at %X/%X BKPBLOCK_SAME_REL set but no previous rel at %X/%X BKPIMAGE_HAS_HOLE not set, but hole offset %u length %u at %X/%X BKPIMAGE_HAS_HOLE set, but hole offset %u length %u block image length %u at %X/%X BKPIMAGE_IS_COMPRESSED set, but block image length %u at %X/%X Done!
Expected a numeric timeline ID.
Expected a transaction log switchpoint location.
Failure, exiting
Options:
Source timeline history:
Target timeline history:
The program "initdb" is needed by %s but was
not found in the same directory as "%s".
Check your installation.
The program "initdb" was found by "%s"
but was not the same version as %s.
Check your installation.
Timeline IDs must be in increasing sequence.
Timeline IDs must be less than child timeline's ID.
Try "%s --help" for more information.
Usage:
%s [OPTION]...
WAL file is from different database system: WAL file database system identifier is %s, pg_control database system identifier is %s WAL file is from different database system: incorrect XLOG_BLCKSZ in page header WAL file is from different database system: incorrect XLOG_SEG_SIZE in page header WAL record modifies a relation, but record type is not recognized
lsn: %X/%X, rmgr: %s, info: %02X
You must run %s as the PostgreSQL superuser.
backup label buffer too small
cannot be executed by "root"
cannot duplicate null pointer (internal error)
clusters are not compatible with this version of pg_rewind
connected to server
contrecord is requested by %X/%X could not clear search_path: %s could not close directory "%s": %s
could not close file "%s": %s
could not close target file "%s": %s
could not connect to server: %s could not create directory "%s": %s
could not create symbolic link at "%s": %s
could not create temporary table: %s could not fetch file list: %s could not fetch remote file "%s": %s could not find common ancestor of the source and target cluster's timelines
could not find previous WAL record at %X/%X
could not find previous WAL record at %X/%X: %s
could not open directory "%s": %s
could not open file "%s" for reading: %s
could not open file "%s" for truncation: %s
could not open file "%s": %s
could not open source file "%s": %s
could not open target file "%s": %s
could not read WAL record at %X/%X
could not read WAL record at %X/%X: %s
could not read directory "%s": %s
could not read file "%s": %s
could not read from file "%s": %s
could not read symbolic link "%s": %s
could not remove directory "%s": %s
could not remove file "%s": %s
could not remove symbolic link "%s": %s
could not seek in file "%s": %s
could not seek in source file: %s
could not seek in target file "%s": %s
could not send COPY data: %s could not send end-of-COPY: %s could not send file list: %s could not send query: %s could not set libpq connection to single row mode
could not set up connection context: %s could not stat file "%s": %s
could not truncate file "%s" to %u: %s
could not write file "%s": %s
data file "%s" in source is not a regular file
error running query (%s) in source server: %s fetched file "%s", length %d
full_page_writes must be enabled in the source server
getting file chunks
incorrect resource manager data checksum in record at %X/%X invalid action (CREATE) for regular file
invalid block_id %u at %X/%X invalid compressed image at %X/%X, block %d invalid contrecord length %u at %X/%X invalid control file
invalid data in history file
invalid data in history file: %s
invalid info bits %04X in log segment %s, offset %u invalid magic number %04X in log segment %s, offset %u invalid record length at %X/%X: wanted %u, got %u invalid record offset at %X/%X invalid resource manager ID %u at %X/%X need to copy %lu MB (total source directory size is %lu MB)
neither BKPIMAGE_HAS_HOLE nor BKPIMAGE_IS_COMPRESSED set, but block image length is %u at %X/%X no rewind required
out of memory
out-of-order block_id %u at %X/%X out-of-sequence timeline ID %u (after %u) in log segment %s, offset %u reading WAL in target
reading source file list
reading target file list
received chunk for file "%s", offset %s, size %d
received null value for chunk for file "%s", file has been deleted
record length %u at %X/%X too long record with incorrect prev-link %X/%X at %X/%X record with invalid length at %X/%X rewinding from last common checkpoint at %X/%X on timeline %u
servers diverged at WAL position %X/%X on timeline %u
source and target cluster are on the same timeline
source and target clusters are from different systems
source data directory must be shut down cleanly
source file list is empty
source server must not be in recovery mode
symbolic link "%s" target is too long
sync of target directory failed
syncing target data directory
syntax error in history file: %s
target server must be shut down cleanly
target server needs to use either data checksums or "wal_log_hints = on"
there is no contrecord flag at %X/%X unexpected EOF while reading file "%s"
unexpected control file CRC
unexpected control file size %d, expected %d
unexpected data types in result set while fetching remote files: %u %u %u
unexpected null values in result while fetching remote files
unexpected page modification for directory or symbolic link "%s"
unexpected pageaddr %X/%X in log segment %s, offset %u unexpected result format while fetching remote files
unexpected result length while fetching remote files
unexpected result set from query
unexpected result set size while fetching remote files
unexpected result set while fetching file list
unexpected result set while fetching remote file "%s"
unexpected result while fetching remote files: %s unexpected result while sending file list: %s unrecognized result "%s" for current WAL insert location
Project-Id-Version: pg_rewind (PostgreSQL) 9.6
Report-Msgid-Bugs-To: pgsql-bugs@postgresql.org
POT-Creation-Date: 2019-04-11 19:22+0000
PO-Revision-Date: 2019-04-12 15:06+0300
Last-Translator:
Language-Team:
Language: tr
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
X-Generator: Poedit 1.8.7.1
Hataları <pgsql-bugs@postgresql.org> adresine bildirebilirsiniz.
yedek etiketi oluşturuluyor ve kontrol dosyası güncelleniyor
--debug hata ayıklama mesajları yaz
--source-pgdata=DİZİN senkronize edilecek kaynak veri dizini
--source-server=CONNSTR senkronize edilecek kaynak sunucu
-?, --help bu yardımı göster, sonra çık
-D, --target-pgdata=DİZİN değiştirilecek mevcut veri dizini
-P, --progress ilerleme mesajları yaz
-V, --version sürüm bilgisini göster, sonra çık
-n, --dry-run herhangi bir şeyi değiştirmeden dur
blok %u
"%s" bir sembolik link, fakat bu platformda sembolik linkler desteklenmiyor
"%s" bir dizin değil
"%s" normal (regular) bir dosya değil
"%s" bir sembolik link değil
%*s/%s kB (%d%%) kopyalandı %d: %X/%X - %X/%X
%s (%s)
%s bir PostgreSQL kümesini kümenin diğer bir kopyasıyla yeniden senkronize eder.
%s: UYARI: bu platformda restricted token oluşturulamıyor
%s: SIDler ayrılamadı: hata kodu %lu
%s: restricted token oluşturulamadı: hata kodu %lu
%s: alt-işlemden çıkış kodu alınamadı: hata kodu %lu
%s: process token açma başarısız: hata kodu %lu
%s: restricted token ile tekrar çalıştırılamadı (re-execute): hata kodu %lu
%s: "%s" komutu için işlem (process) başlatılamadı: hata kodu %lu
%s: kaynak belirtilmemiş (--source-pgdata veya --source-server)
%s: hedef veri dizini elirtilmemiş (--target-pgdata)
%s: --source-pgdata veya --source-server'dan sadece biri belirtilebilir
%s: Çok fazla komut satırı girdisi var (ilki "%s")
BKPBLOCK_HAS_DATA ayarlanmadı, fakat veri uzunluğu %u (%X/%X de) BKPBLOCK_HAS_DATA ayarlandı, fakat %X/%X de veri yok BKPBLOCK_SAME_REL ayarlandı fakat %X/%X de önceki rel yok BKPIMAGE_HAS_HOLE ayarlanmadı, fakat hole offset %u uzunluk %u (%X/%X de) BKPIMAGE_HAS_HOLE ayarlandı, fakat hole offset %u uzunluk %u blok image uzunluğu %u (%X/%X de) BKPIMAGE_IS_COMPRESSED ayarlandı, fakat block image uzunluğu %u (%X/%X de) Tamamlandı!
Sayısal bir zaman çizelgesi ID'si bekleniyor.
Bir write-ahead log geçiş noktası (switchpoint) lokasyonu bekleniyordu.
Başarısız, çıkılıyor
Seçenekler:
Kaynak zaman çizelgesi geçmişi:
Hedef zaman çizelgesi geçmişi:
"initdb" programına %s tarafından ihtiyaç duyuluyor fakat
"%s" ile aynı dizinde bulunmuyor.
Kurulumunuzu kontrol ediniz.
"initdb" programı "%s" tarafından bulundu
fakat %s ile aynı sürümde değil.
Kurulumunuzu kontrol ediniz
Zaman çizelgesi ID'leri artan sırada olmalı.
Zamançizelgesi ID'leri alt zaman çizelgesinin ID'lerinden küçük olmalı.
Daha fazla bilgi için "%s --help" yazın
kullanım:
%s [SEÇENEK]...
WAL dosyası farklı veritabanı sisteminden: WAL dosya veritabanı sistem tanımlayıcı %s, pg_control veritabanı sistem tanımlayıcı %s WAL dosyası farklı veritabanı sisteminden: page header'da yanlış XLOG_BLCKSZ değeri WAL dosyası farklı veritabanı sisteminden: page header'da yanlış XLOG_SEG_SIZE değeri WAL kaydı bir nesneyi değiştiriyor, fakat kayıt türü tanınmıyor
lsn: %X/%X, rmgr: %s, info: %02X
%s komutunu PostgreSQL superuser olarak çalıştırmalısınız.
yedek etiketi tamponu (buffer) çok küçük
"root" tarafından çalıştırılamaz
null pointer duplicate edilemiyor (iç hata)
kümeler pg_rewind'in bu sürümüyle uyumlu değil
sunucuya bağlandı
contrecord %X/%X tarafından talep edilmiştir search_path temizlenemedi: %s "%s" dizini kapatılamadı: %s
"%s" dosyası kapatılamadı: %s
"%s" hedef dosyası kapatılamadı: %s
sunucuya bağlanamadı: %s "%s" dizini oluşturulamadı: %s
"%s" de sembolik link oluşturulamadı: %s
geçici tablo oluşturulamadı: %s dosya listesi getirilemedi: %s "%s" uzak dosyası getirilemedi: %s kaynak ve hedef kümelerin zaman çizelgelerinin ortak atası bulunamadı
%X/%X de önceki WAL kaydı bulunamadı
%X/%X de önceki WAL kaydı bulunamadı: %s
"%s" dizini açılamıyor: %s
"%s" dosyası okuma için açılamadı: %s
"%s" dosyası küçültme (truncation) için açılamadı: %s
"%s" dosyası açılamadı: %s
"%s" kaynak dosyası açılamadı: %s
"%s" hedef dosyası açılamadı: %s
%X/%X deki WAL kaydı okunamadı
%X/%X deki WAL kaydı okunamadı: %s
"%s" dizini okunamıyor: %s
"%s" dosyası okunamadı: %s
"%s" dosyasından okuma hatası: %s
"%s" sembolik linki okunamadı: %s
"%s" dizini silinemedi: %s
"%s" dosyası silinemedi: %s
"%s" sembolik linki kaldırılamadı: %s
"%s" dosyasında arama yapılamadı: %s
kaynak dosyada arama yapılamadı: %s
"%s" hedef dosyasında arama yapılamadı: %s
COPY veri gönderilemedi: %s kopya sonu (end-of-COPY) gönderilemedi: %s dosya listesi gönderilemedi: %s sorgu gönderilemedi: %s libpq bağlantısı tek sıra moduna ayarlanamadı
bağlantı bağlamı (context) kurulamadı: %s "%s" dosyasının durumu görüntülenemedi (stat): %s
"%s" dosyası %u değerine küçültülemedi (truncate): %s
"%s" dosyasına yazılamadı: %s
kaynaktaki "%s" veri dosyası normal (regular) bir dosya değil
kaynak sunucuda (%s) sorgusu hata üretti: %s "%s" dosyası getirildi, uzunluk %d
kaynak sunucuda full_page_writes etkinleştirilmiş olmalı
dosya parçaları alınıyor
resoource manager data checksum %X/%X kaydında geçersiz normal (regular) dosya için geçersiz işlem (CREATE)
%X/%X adresinde %u block_id geçersiz %X/%X adresinde (blok %d), geçersiz compressed image %2$X/%3$X adresinde geçersiz %1$u contrecord uzunluğu geçersiz kontrol dosyası
geçmiş dosyasında geçersiz veri
geçmiş dosyasında geçersiz veri: %s
%04X geçersiz info bits; %s kayıt segmentinde, offset %u %04X geçersiz tanıtım kodu; %s kayıt segmentinde, offset %u %X/%X adresinde geçersiz kayıt uzunluğu: istenen %u, alınan %u %X/%X adresinde geçersiz kayıt offseti %2$X/%3$X adresinde geçersiz resource manager ID %1$u %lu MB kopyalanmalı (toplam kaynak dizin boyutu %lu MB)
BKPIMAGE_HAS_HOLE ve BKPIMAGE_IS_COMPRESSED ayarlanmadı, fakat blok image uzunluğu %u (%X/%X de) geri sarma (rewind) gerekmiyor
bellek yetersiz
%2$X/%3$X deki %1$u block_id değeri bozuk sıra dışı timeline ID %u (%u'dan sonra), bulunduğu log segmenti %s, offset %u hedefteki WAL okunuyor
kaynak dosya listesi okunuyor
hedef dosya listesi okunuyor
"%s" dosyası için parça (chunk) alındı, ofset %s, boyut %d
"%s" dosyası parçası (chunk) için boş (null) değer alındı, dosya silindi
%2$X/%3$X adresinde çok büyük kayıt uzunluğu: %1$u geçersiz incorrect prev-link olan kayıt: %3$X/%4$X de %1$X/%2$X %X/%X adresinde geçersiz uzunlukta kayıt %u zaman çizelgesinde %X/%X deki son ortak kontrol noktasından geri sarıyor (rewind)
sunucular %u zaman çizelgesinde %X/%X WAL konumunda birbirlerinden farklılaşıyor
kaynak ve hedef kümesi aynı zaman çizelgesinde
kaynak ve hedef kümeleri farklı sistemlerden
kaynak veri dizini düzgün bir şekilde kapatılmalı
kaynak dosya listesi boş
kaynak sunucu kurtarma (recovery) modunda olmamalı
"%s" sembolik link hedefi çok uzun
hedef dizinin senkronizasyonu başarısız oldu
hedef veri dizini senkronize ediliyor
geçmiş dosyasında sözdizimi hatası: %s
hedef sunucu düzgün bir şekilde kapatılmalı
hedef sunucu ya veri sağlama toplamları (checksum) ya da "wal_log_hints = on" kullanmalı
%X/%X de contrecord bayrağı (flag) bulunmuyor "%s" dosyası okunurken beklenmedik dosya sonu (EOF)
beklenmedik kontrol dosyası CRC'si
beklenmedik kontrol dosyası boyutu %d, beklenen %d
uzak dosyalar alınırken sonuç kümesinde beklenmedik veri tipleri: %u %u %u
uzak dosyalar alınırken sonuçta beklenmeyen boş (null) değerler
"%s" dizini veya sembolik linki için beklenmedik sayfa değişikliği (page modification)
beklenmeyen pageaddr %X/%X: log segmenti %s, offset %u uzak dosyalar alınırken beklenmedik sonuç formatı
uzak dosyalar alınırken beklenmedik sonuç uzunluğu
sorgudan beklenmedik sonuç kümesi
uzak dosyalar alınırken beklenmedik sonuç kümesi
dosya listesi getirilirken beklenmedik sonuç kümesi
"%s" uzak dosyası getirilirken beklenmedik sonuç kümesi
uzak dosyalar alınırken beklenmedik sonuç: %s dosya listesi gönderilirken beklenmeye sonuç: %s geçerli WAL ekleme (insert) yeri için bilinmeyen sonuç "%s"
locale/tr/LC_MESSAGES/ecpg-9.6.mo 0000644 00000034644 14751153420 0012017 0 ustar 00 �� { � � � h
~ i
- �
0 + G g s � 4 � 7 0 s h . � G
4 S
) �
w �
4 * _ @ r = � , � ! @ , ^ 1 � * � - � 1 ' H & p + � " � # �
) = < z � & � < � ! & - 0 + ^ " � � , � � * 3 " ^ ' � � � ! � � ! 5 J 3 k / � ' � ) � * ! 5 L I � , � / � * ) T T ' � � � 1 - K , y , � 5 � ) % ? O 8 � � � _ 0 y 5 � � A � L 7 + �
� 6 � ' � # A ( N 4 w ) � � / � # < $ ] � " � , � � ' " J i $ � D � + � ? 0 Z � 8 � � & F � g � ! C �! 3 �! 3 " { S" $ �" D �" 8 9# s r# H �# Y /$ > �$ 4 �$ � �$ K �% �% G �% = F& < �& # �& �& 6 ' > =' 7 |' : �' > �' 4 .( 3 c( 8 �( ! �( - �( ) 1 &) F X)
�) �) * �) f �) * Z* �* / �* 0 �* ( �* + , 0+ ]+ $ ~+ 2 �+ ' �+ - �+ ,, C, ' d, �, ' �, �, 2 �, 8 - , K- 7 x- 7 �- : �- J #. Y n. 8 �. : / 1 </ _ n/ * �/ �/ 0 40 H0 e0 . }0 ( �0 - �0 7 1 ;1 # V1 B z1 7 �1 N �1 * D2 9 o2 ? �2 �2 H 3 X K3 4 �3 �3 A �3 - +4 2 Y4 �4 - �4 = �4 . 5 ;5 2 Z5 �5 " �5 + �5 �5 " 6 2 36 " f6 * �6 2 �6 ? �6 ? '7 . g7 S �7 ? �7 O *8 - z8 # �8 7 �8 9 %9 . E9 / t9 j 4 f g ? ^ l x
T ( 9 u 8 _ L t I d \ % ) < i = ' Q N & : M v , 7 B . z ; S n # > P " H r ] [ ! * s Z 6 G A O - X 2 q 3 W w 1 k + U e Y o K p 0 a J 5 { h c m E C @ V F D y R / ` $
b
If no output file is specified, the name is formed by adding .c to the
input file name, after stripping off .pgc if present.
Report bugs to <pgsql-bugs@postgresql.org>.
--regression run in regression testing mode
-?, --help show this help, then exit
-C MODE set compatibility mode; MODE can be one of
"INFORMIX", "INFORMIX_SE"
-D SYMBOL define SYMBOL
-I DIRECTORY search DIRECTORY for include files
-V, --version output version information, then exit
-c automatically generate C code from embedded SQL code;
this affects EXEC SQL TYPE
-d generate parser debug output
-h parse a header file, this option includes option "-c"
-i parse system include files as well
-o OUTFILE write result to OUTFILE
-r OPTION specify run-time behavior; OPTION can be:
"no_indicator", "prepare", "questionmarks"
-t turn on autocommit of transactions
%s at or near "%s" %s is the PostgreSQL embedded SQL preprocessor for C programs.
%s, the PostgreSQL embedded C preprocessor, version %d.%d.%d
%s: could not locate my own executable path
%s: could not open file "%s": %s
%s: no input files specified
%s: parser debug support (-d) not available
AT option not allowed in CLOSE DATABASE statement AT option not allowed in CONNECT statement AT option not allowed in DISCONNECT statement AT option not allowed in SET CONNECTION statement AT option not allowed in TYPE statement AT option not allowed in VAR statement AT option not allowed in WHENEVER statement COPY FROM STDIN is not implemented CREATE TABLE AS cannot specify INTO ERROR: EXEC SQL INCLUDE ... search starts here:
Error: include path "%s/%s" is too long on line %d, skipping
Options:
SHOW ALL is not implemented Try "%s --help" for more information.
Unix-domain sockets only work on "localhost" but not on "%s" Usage:
%s [OPTION]... FILE...
WARNING: arrays of indicators are not allowed on input could not open include file "%s" on line %d could not remove output file "%s"
cursor "%s" does not exist cursor "%s" has been declared but not opened cursor "%s" is already defined descriptor "%s" does not exist descriptor header item "%d" does not exist descriptor item "%s" cannot be set descriptor item "%s" is not implemented end of search list
expected "://", found "%s" expected "@" or "://", found "%s" expected "@", found "%s" expected "postgresql", found "%s" incomplete statement incorrectly formed variable "%s" indicator for array/pointer has to be array/pointer indicator for simple data type has to be simple indicator for struct has to be a struct indicator struct "%s" has too few members indicator struct "%s" has too many members indicator variable "%s" is hidden by a local variable indicator variable "%s" is hidden by a local variable of a different type indicator variable must have an integer type initializer not allowed in EXEC SQL VAR command initializer not allowed in type definition internal error: unreachable state; please report this to <pgsql-bugs@postgresql.org> interval specification not allowed here invalid bit string literal invalid connection type: %s invalid data type key_member is always 0 missing "EXEC SQL ENDIF;" missing identifier in EXEC SQL DEFINE command missing identifier in EXEC SQL IFDEF command missing identifier in EXEC SQL UNDEF command missing matching "EXEC SQL IFDEF" / "EXEC SQL IFNDEF" more than one EXEC SQL ELSE multidimensional arrays are not supported multidimensional arrays for simple data types are not supported multidimensional arrays for structures are not supported multilevel pointers (more than 2 levels) are not supported; found %d level multilevel pointers (more than 2 levels) are not supported; found %d levels nested /* ... */ comments nested arrays are not supported (except strings) no longer supported LIMIT #,# syntax passed to server nullable is always 1 only data types numeric and decimal have precision/scale argument only protocols "tcp" and "unix" and database type "postgresql" are supported operator not allowed in variable definition out of memory pointer to pointer is not supported for this data type pointers to varchar are not implemented subquery in FROM must have an alias syntax error syntax error in EXEC SQL INCLUDE command too many levels in nested structure/union definition too many nested EXEC SQL IFDEF conditions type "%s" is already defined type name "string" is reserved in Informix mode unmatched EXEC SQL ENDIF unrecognized data type name "%s" unrecognized descriptor item code %d unrecognized token "%s" unrecognized variable type code %d unsupported feature will be passed to server unterminated /* comment unterminated bit string literal unterminated hexadecimal string literal unterminated quoted identifier unterminated quoted string using unsupported DESCRIBE statement using variable "%s" in different declare statements is not supported variable "%s" is hidden by a local variable variable "%s" is hidden by a local variable of a different type variable "%s" is neither a structure nor a union variable "%s" is not a pointer variable "%s" is not a pointer to a structure or a union variable "%s" is not an array variable "%s" is not declared variable "%s" must have a numeric type zero-length delimited identifier Project-Id-Version: PostgreSQL 8.4
Report-Msgid-Bugs-To: pgsql-bugs@postgresql.org
POT-Creation-Date: 2019-04-11 19:17+0000
PO-Revision-Date: 2019-04-12 11:23+0300
Last-Translator: Abdullah Gülner
Language-Team: Turkish <ceviri@postgresql.org.tr>
Language: tr
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Plural-Forms: nplurals=1; plural=0;
X-Generator: Poedit 1.8.7.1
Eğer çıktı dosyası belirtilmediyse, dosyanın adı eğer sonunda .pgc varsa
kaldırıldıktan sonra girdi dosyasının sonuna .c eklenerek oluşturulur.
Hataları <pgsql-bugs@postgresql.org> adresine bildirebilirsiniz.
--regression regression testi modunda çalış
-?, --help bu yardımı göster, sonra çık
-C MOD uyumluluk modunu ayarla; MOD aşağıdakilerden birisi olabilir
"INFORMIX", "INFORMIX_SE"
-D SEMBOL SEMBOLü tanımla
-I DİZİN dosyaları içermek için DİZİN dizinini araştır
-V, --version sürüm bilgisini göster, sonra çık
-c gömülü SQL kodundan otomatik olarak C kodu üret;
bu EXEC SQL TYPE'ı etkiler
-d ayrıştırıcı hata ayıklama çıktısını oluştur
-h başlık dosyasını ayrıştır; bu seçenek "-c" seçeneğini içerir
-i sistem include dosyalarını da ayrıştırl
-o ÇIKTI DOSYASI sonucu ÇIKTI DOSYASIna yaz
-r SEÇENEK çalışma zamanı davranışını belirt; SEÇENEK şunlardan birisi olabilir:
"no_indicator", "prepare", "questionmarks"
-t transactionların otomatik commit olması özelliğini aç
"%2$s" yerinde %1$s %s C programları için PostgreSQL'e gömüşü SQL önişlemcisidir.
%s, PostgreSQL gömülü C önişlemcisi, %d.%d.%d sürümü
%s: kendi çalıştırılabilir dosyamın yolunu bulamadım
%s: "%s" dosyası açılamadı: %s
%s: girdi dosyası belirtilmedi
%s: ayrıştırıcı hata ayıklama desteği (-d) yok
AT seçeneğine CLOSE DATABASE ifadesinde izin verilmemektedir AT seçeneğine CONNECT ifadesinde izin verilmemektedir AT seçeneğine DISCONNECT ifadesinde izin verilmemektedir AT seçeneğine SET CONNECTION ifadesinde izin verilmemektedir AT seçeneğine TYPE ifadesinde izin verilmemektedir AT seçeneğine VAR ifadesinde izin verilmemektedir AT seçeneğine WHENEVER ifadesinde izin verilmemektedir COPY FROM STDIN kodlanmamıştır CREATE TABLE AS işleminde INTO kullanılamaz HATA: EXEC SQL INCLUDE ... araması burada başlıyor:
Hata: "%s/%s" include yolu çok uzun, satır numarası %d; atlanıyor
Seçenekler:
SHOW ALL kodlanmamıştır Daha fazla bilgi için "%s --help" yazın
Unix-domain soketleri sadece "localhost" üzerinde çalışabilir; ancak "%s" üzerinde çalışamaz. Kullanımı:
%s [SEÇENEK]... DOSYA...
UYARI: belirticilerin dizilerine girdide izin verilmez "%s" include dosyası %d. satırda açılamadı "%s" çıktı dosyası kaldırılamadı
"%s" imleci mevcut değil "%s" imleci tanımlanmış ama açılmamış "%s" imleci zaten tanımlanmış "%s" açıklayıcısı mevcut değil "%d" açıklayıcı başlık maddesi mevcut değil "%s" açıklayıcı öğesi ayarlanamaz "%s" açıklayıcı öğesi kodlanmamıştır arama listesinin sonu
"://" bekleniyordu; "%s" bulundu "@" or "://" bekleniyordu; "%s" bulundu "@" bekleniyordu; "%s" bulundu "postgresql" bekleniyordu; "%s" bulundu eksik ifade doğru şekilde oluşturulmamış "%s" değişkeni array/pointer için gösterici array/pointer olmalıdır basit veri tipinin göstergesi basit olmalı struct için gösterici (indicator) yine struct olmalı "%s" gösterge yapısının (struct) çok az üyesi var "%s" gösterge yapısının (struct) çok fazla üyesi var "%s" gösterge değişkeni yerel bir değişken tarafından gizlenmektedir "%s" belirteç değişkeni farklı tipteki yerel bir değişken tarafından gizlenmiştir belirteç değişkeni tamsayı veri tipine sahip olmalı EXEC SQL VAR konutunda ilklendiriciye izin verilmemektedir tip tanımlamasında ilklendiriciye izin verilmez dahili hata: erişilemeyen durum: bunu lütfen <pgsql-bugs@postgresql.org> adresine bildiriniz. aralık belirtimine burada izin verilmiyor geçersiz bit dizini bilgisi Geçersiz bağlantı tipi: %s geçersiz veri tipi key_member her zaman 0'dır. eksik "EXEC SQL ENDIF;" EXEC SQL DEFINE komutunda eksik tanımlayıcı EXEC SQL IFDEF komutunda eksik belirteç EXEC SQL UNDEF komutunda eksik tanımlayıcı eksik "EXEC SQL IFDEF" / "EXEC SQL IFNDEF" eşleşmesi birden fazla EXEC SQL ELSE çok boyutlu diziler desteklenmiyor basit veri tipleri için çok boyutlu diziler desteklenmemektedir. yapılar için çok boyutlu diziler desteklenmemektedir çoklu seviye işaretçileri (İkiden fazla) desteklenmiyor: %d seviye bulundu iç içe /* ... */ açıklamalar (comment) içiçe geçmiş diziler, dizgiler haricinde desteklenmez artık desteklenmeyen LIMIT #,# sözdizimi sunucuya aktarıldı nullable her zaman 1'dir sadece sayısal ve ondalıklı verip tiplerinin ondalık bilgisi vardır sadece "tcp" ve "unix" protokolleri ile "postgresql" veritabanı tipi desteklenmektedir. değişken tanımlamasında operatöre izin verilmez yetersiz bellek Bu veri tipi için işaretçiden işaretçiye desteklenmemektedir varcharlara işaretçiler henüz uyarlanmadı FROM öğesindeki subquery bir aliası almalıdır söz dizim hatası EXEC SQL INCLUDE komutunda sözdizimi hatası içiçe gelmiş yapı/birleşme tanımında çok fazla seviye Çok fazla yuvalanmış EXEC SQL IFDEF koşulu "%s" tipi zaten tanımlanmış "string" tip adı Informix modunda ayrılmıştır eşlenmeyen EXEC SQL ENDIF tanımlanmayan veri tipi adı "%s" tanımlanmayan açıklayıcı madde kodu %d tanımlanmayan imge "%s" tanımsız değişken tipi kodu %d desteklenmeyen özellik sunucuya aktarılacaktır /* açıklama sonlandırılmamış sonuçlandırılmamış bit string literal sonuçlandırılmamış hexadecimal string literal sonuçlandırılmamış tırnakla sınırlandırılmış tanım sonuçlandırılmamış tırnakla sınırlandırılmış satır desteklenmeyen DESCRIBE ifadesi kullanılıyor "%s" değşkenini farklı declare ifadeleri arasında kullanmak desteklenmemektedir "%s" değişkeni yerel bir değişken tarafından gizlenmiştir "%s" değişkeni farklı tipteki yerel bir değişken tarafından gizlenmiştir "%s" değişkeni structure ya da union değil "%s" değişkeni bir pointer değil "%s" değişkeni structure ya da union'a pointer değil "%s" değişkeni bir dizi değil "%s" değişkeni bildirilmemiş "%s" değişkeninin sayısal veri tipi olmalı sınırlandırılmış tanım sıfır uzunluklu locale/tr/LC_MESSAGES/pg_config-9.6.mo 0000644 00000014214 14751153420 0013023 0 ustar 00 �� * l ; � � E � 0 � : 3 E n I � L � s K K � = B I i � G � J > M � M � ? % G e > � 6 � < # > ` F � P � I 7
4 �
2 �
* �
. , 8 & e � & � � ( � ! B V c y u 8 �
= ( f d { X � \ 9 _ � � � ^ � B � A , t n Q � ] 5 e � ` � D Z Z � G � O B G � K � S & H z K � A : Q , � �
� B � B &
i 3 w ' � # � ' � @ ^ o % * ) $
" '
& ( ! #
%s provides information about the installed version of PostgreSQL.
With no arguments, all known items are shown.
%s [OPTION]...
--bindir show location of user executables
--cc show CC value used when PostgreSQL was built
--cflags show CFLAGS value used when PostgreSQL was built
--cflags_sl show CFLAGS_SL value used when PostgreSQL was built
--configure show options given to "configure" script when
PostgreSQL was built
--cppflags show CPPFLAGS value used when PostgreSQL was built
--docdir show location of documentation files
--htmldir show location of HTML documentation files
--includedir show location of C header files of the client
interfaces
--includedir-server show location of C header files for the server
--ldflags show LDFLAGS value used when PostgreSQL was built
--ldflags_ex show LDFLAGS_EX value used when PostgreSQL was built
--ldflags_sl show LDFLAGS_SL value used when PostgreSQL was built
--libdir show location of object code libraries
--libs show LIBS value used when PostgreSQL was built
--localedir show location of locale support files
--mandir show location of manual pages
--pgxs show location of extension makefile
--pkgincludedir show location of other C header files
--pkglibdir show location of dynamically loadable modules
--sharedir show location of architecture-independent support files
--sysconfdir show location of system-wide configuration files
--version show the PostgreSQL version
-?, --help show this help, then exit
%s: could not find own program executable
%s: invalid argument: %s
Options:
Report bugs to <pgsql-bugs@postgresql.org>.
Try "%s --help" for more information.
Usage:
could not change directory to "%s": %s could not find a "%s" to execute could not identify current directory: %s could not read binary "%s" could not read symbolic link "%s" invalid binary "%s" not recorded pclose failed: %s Project-Id-Version: pg_config-tr
Report-Msgid-Bugs-To: pgsql-bugs@postgresql.org
POT-Creation-Date: 2019-04-11 19:21+0000
PO-Revision-Date: 2019-04-12 14:41+0300
Last-Translator: Abdullah GÜLNER
Language-Team: Turkish <ceviri@postgresql.org.tr>
Language: tr
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
X-Generator: Poedit 1.8.7.1
%s kurulu PostgreSQL sürümü hakkında bilgi verir.
Parametre verilmediyse, tüm değerleri gösterilmektedir.
%s [SEÇENEK]...
--bindir kullanıcı tarafından çalıştırılabilir dosyaların yerlerini göster
--ldflags PostgreSQL derleme sırasında kullanılan CC değerini göster
--ldflags PostgreSQL derleme sırasında kullanılan CFLAGS değerini göster
--ldflags PostgreSQL derleme sırasında kullanılan CFLAGS_SL değerini göster
--configure PostgreSQL yapılandırıldığında "configure" betiğine verilen
seçeneklerin listesini göster
--ldflags PostgreSQL derleme sırasında kullanılan CPPFLAGS değerini göster
--docdir dokümantasyon dosyaların yerini göster
--docdir HTML belge dosyalarının yerini göster
--includedir İstemci arabirimlerinin C başlık dosyalarının yerlerini
göster
--includedir-server Sunucu için C başlık dosyalarının yerlerini göster
--ldflags PostgreSQL derleme sırasında kullanılan LDFLAGS değerini göster
--ldflags_ex PostgreSQL derlemesi sırasında kullanılan LDFLAGS_EX değerini göster
--ldflags PostgreSQL derleme sırasında kullanılan LDFLAGS_SL değerini göster
--libdir nesne kod kütüphanelerinin yerini göster
--libs PostgreSQL derleme sırasında kullanılan LIBS değerini göster
--localedir yerel dil destek dosyalarının yerini göster
--mandir kullanıcı kılavuzu (man) dosyaların yerini göster
--pgxs extension makefile dosyasının yerini göster
--pkgincludedir diğer C başlık dosyalarının yerlerini göster
--pkglibdir Dinamik olarak yüklenebilen modüllerin yerlerini göster
--sharedir platform bağımsız dosyaların yerini göster
--sysconfdir sistem geneli parametre dosyaların yerini göster
--version PostgreSQL sürümünü göster ve çık
-?, --help bu yardımı göster, sonra çık
%s: çalıştırılabilir dosya bulunamadı
%s: geçersiz argüman: %s
Seçenekler:
Hataları <pgsql-bugs@postgresql.org> adresine bildirebilirsiniz.
Daha fazla bilgi için"%s --help" parametresini kullanabilirsiniz
Kullanımı:
çalışma dizini "%s" olarak değiştirilemedi: %s "%s" çalıştırmak için bulunamadı geçerli dizin tespit edilemedi: %s "%s" ikili (binary) dosyası okunamadı symbolic link "%s" okuma hatası geçersiz ikili (binary) "%s" kayıtlı değil pclose başarısız oldu: %s locale/tr/LC_MESSAGES/pg_basebackup-9.6.mo 0000644 00000070144 14751153420 0013662 0 ustar 00 �� � � ,
� � � � � ! �
- X C T � R � ` D I � D � 4 3 F K z < � j > n N � @ � 3 = Y q > � 1
j < < � ? � M $ k r J � Y ) + � 0 � B � B # * f 8 � � � 5 Y � � r o � 1 � 3 , K ` - � F � \ ! P ~ 2 � 4 8 7 1 p 4 � 1 � . @ 8 1 y E � B � 7 4! l! �! ( �! ' �! & �! ; " ( Z" # �" - �" ' �" " �" # # A# 2 e# , �# + �# . �# ( $ # I$ 5 m$ f �$ ,
% 9 7% 4 q% 7 �% = �% d & A �& " �& & �& &
' # 4' / X' > �' a �' & )( & P( % w( 2 �( 1 �( 0 ) 8 3) ( l) 2 �) �) & �) ' * . 8* + g* # �* A �* 2 �* & ,+ & S+ / z+ + �+ 4 �+ / , ! ;, 1 ], ) �, ( �, 2 �, 2 - 3 H- 0 |- % �- # �- + �- #. @. 2 R. # �. �. , �. , �. # / i D/ i �/ ? 0 9 X0 " �0 A �0 # �0 1 9 <1 v1 �1 ! �1 D �1 & 2 # 92 A ]2 - �2 D �2 ! 3 43 O3 " f3 �3 9 �3 1 �3 D 4 , X4 �4 ' �4 D �4 M 5 : S5 8 �5 6 �5 �5 E 6 G ]6 z �6 c 7 % �7 . �7 2 �7 6 8 # C8 g8 % �8 0 �8 R �8 , *9 4 W9 K �9 @ �9 > : - X: , �: ' �: , �: o ; k x; 4 �; % < ( ?< ; h<
�< & �< �< / �< = / = � M= �> ? 0? E? ( Z? �? C �? ^ �? S 5@ d �@ f �@ L UA 0 �A �A ; �A = #B 9 aB � �B O &C X vC O �C 4 D Z TD > �D 9 �D � (E T �E F F G OF r �F _
G l jG , �G A H B FH H �H 2 �H ; I � AI @ �I � J � �J | 8K & �K F �K Q #L 9 uL E �L [ �L O QM I �M : �M P &N D wN @ �N < �N ! :O G \O E �O H �O N 3P 9 �P �P * �P * Q + .Q > ZQ R �Q $ �Q ! R : 3R $ nR % �R �R ! �R 4 �R ) /S / YS : �S , �S % �S 4 T n LT . �T M �T ? 8U 7 xU 8 �U h �U > RV 1 �V + �V & �V $ W @ ;W > |W k �W $ 'X " LX , oX = �X 3 �X E Y E TY 1 �Y 2 �Y �Y Z # >Z ' bZ > �Z 2 �Z \ �Z / Y[ ( �[ 6 �[ . �[ 0 \ - I\ 1 w\ < �\ C �\ & *] 9 Q] 9 �] 9 �] ? �] : ?^ & z^ + �^ ) �^ �^ _ B )_ & l_ * �_ 5 �_ 8 �_ -` s N` s �` G 6a A ~a + �a H �a + 5b $ ab A �b # �b �b $ c S )c + }c ' �c L �c 0 d A Od �d & �d �d �d & e , :e @ ge A �e 3 �e f 6 3f H jf ^ �f C g C Vg = �g # �g U �g ` Rh | �h � 0i - �i > �i H %j 9 nj - �j �j ; �j D /k U tk / �k 6 �k = 1l 6 ol 9 �l 9 �l 4 m 2 Om / �m r �m � %n 4 �n 0 �n 7
o D Eo �o A �o
�o - �o p A "p 8 � � � t � v � 3 . F d M 7 � 1 j � � A � J ` � � O � r � � � � ^ N c " L - � + � u � � � x � � [ g � , p U T X � b $ h P Y e Z � � i � � � \ � < � � : � � K � a G � > ; ) ! � s � � 4 C � � � � � � ( k D w H � ' � � S ] � | f _ q = � � ? � � 9 6 � � 0 % 2
o � Q � � � � { �
R � m � z � � � E I ~ � / n � l � 5 @ V B � � � � � � y � � � � � } & # * W �
Action to be performed:
Connection options:
General options:
Optional actions:
Options controlling the output:
Options:
Report bugs to <pgsql-bugs@postgresql.org>.
--create-slot create a new replication slot (for the slot's name see --slot)
--drop-slot drop the replication slot (for the slot's name see --slot)
--if-not-exists do not error if slot already exists when creating a slot
--start start streaming in a replication slot (for the slot's name see --slot)
--synchronous flush transaction log immediately after writing
--xlogdir=XLOGDIR location for the transaction log directory
%s [OPTION]...
-?, --help show this help, then exit
-D, --directory=DIR receive transaction log files into this directory
-D, --pgdata=DIRECTORY receive base backup into directory
-F --fsync-interval=SECS
time between fsyncs to the output file (default: %d)
-F, --format=p|t output format (plain (default), tar)
-I, --startpos=LSN where in an existing slot should the streaming start
-P, --plugin=PLUGIN use output plugin PLUGIN (default: %s)
-P, --progress show progress information
-R, --write-recovery-conf
write recovery.conf for replication
-S, --slot=SLOTNAME name of the logical replication slot
-S, --slot=SLOTNAME replication slot to use
-T, --tablespace-mapping=OLDDIR=NEWDIR
relocate tablespace in OLDDIR to NEWDIR
-U, --username=NAME connect as specified database user
-V, --version output version information, then exit
-W, --password force password prompt (should happen automatically)
-X, --xlog-method=fetch|stream
include required WAL files with specified method
-Z, --compress=0-9 compress tar output with given compression level
-c, --checkpoint=fast|spread
set fast or spread checkpointing
-d, --dbname=CONNSTR connection string
-d, --dbname=DBNAME database to connect to
-f, --file=FILE receive log into this file, - for stdout
-h, --host=HOSTNAME database server host or socket directory
-l, --label=LABEL set backup label
-n, --no-loop do not loop on connection lost
-o, --option=NAME[=VALUE]
pass option NAME with optional value VALUE to the
output plugin
-p, --port=PORT database server port number
-r, --max-rate=RATE maximum transfer rate to transfer data directory
(in kB/s, or use suffix "k" or "M")
-s, --status-interval=INTERVAL
time between status packets sent to server (in seconds)
-s, --status-interval=SECS
time between status packets sent to server (default: %d)
-v, --verbose output verbose messages
-w, --no-password never prompt for password
-x, --xlog include required WAL files in backup (fetch mode)
-z, --gzip compress tar output
%*s/%s kB (%d%%), %d/%d tablespace %*s/%s kB (%d%%), %d/%d tablespaces %*s/%s kB (%d%%), %d/%d tablespace (%s%-*.*s) %*s/%s kB (%d%%), %d/%d tablespaces (%s%-*.*s) %*s/%s kB (100%%), %d/%d tablespace %*s %*s/%s kB (100%%), %d/%d tablespaces %*s %s controls PostgreSQL logical decoding streams.
%s receives PostgreSQL streaming transaction logs.
%s takes a base backup of a running PostgreSQL server.
%s: %s needs a slot to be specified using --slot
%s: COPY stream ended before last file was finished
%s: WAL streaming can only be used in plain mode
%s: at least one action needs to be specified
%s: can only write single tablespace to stdout, database has %d
%s: cannot specify both --xlog and --xlog-method
%s: cannot use --create-slot or --drop-slot together with --startpos
%s: cannot use --create-slot or --start together with --drop-slot
%s: cannot use --create-slot together with --drop-slot
%s: checkpoint completed
%s: child %d died, expected %d
%s: child process did not exit normally
%s: child process exited with error %d
%s: child thread exited with error %u
%s: confirming write up to %X/%X, flush to %X/%X (slot %s)
%s: could not access directory "%s": %s
%s: could not clear search_path: %s %s: could not close compressed file "%s": %s
%s: could not close directory "%s": %s
%s: could not close file "%s": %s
%s: could not connect to server
%s: could not connect to server: %s %s: could not create archive status file "%s": %s
%s: could not create background process: %s
%s: could not create background thread: %s
%s: could not create compressed file "%s": %s
%s: could not create directory "%s": %s
%s: could not create file "%s": %s
%s: could not create pipe for background process: %s
%s: could not create replication slot "%s": got %d rows and %d fields, expected %d rows and %d fields
%s: could not create symbolic link "%s": %s
%s: could not create symbolic link from "%s" to "%s": %s
%s: could not create timeline history file "%s": %s
%s: could not determine seek position in file "%s": %s
%s: could not determine server setting for integer_datetimes
%s: could not drop replication slot "%s": got %d rows and %d fields, expected %d rows and %d fields
%s: could not establish database-specific replication connection
%s: could not fsync file "%s": %s
%s: could not fsync log file "%s": %s
%s: could not get COPY data stream: %s %s: could not get backup header: %s %s: could not get child thread exit status: %s
%s: could not get transaction log end position from server: %s %s: could not identify system: got %d rows and %d fields, expected %d rows and %d or more fields
%s: could not initiate base backup: %s %s: could not open directory "%s": %s
%s: could not open log file "%s": %s
%s: could not open timeline history file "%s": %s
%s: could not open transaction log file "%s": %s
%s: could not pad transaction log file "%s": %s
%s: could not parse next timeline's starting point "%s"
%s: could not parse start position "%s"
%s: could not parse transaction log location "%s"
%s: could not read COPY data: %s %s: could not read directory "%s": %s
%s: could not read from ready pipe: %s
%s: could not receive data from WAL stream: %s %s: could not rename file "%s" to "%s": %s
%s: could not rename file "%s": %s
%s: could not seek to beginning of transaction log file "%s": %s
%s: could not send command to background pipe: %s
%s: could not send copy-end packet: %s %s: could not send feedback packet: %s %s: could not send replication command "%s": %s %s: could not set compression level %d: %s
%s: could not set permissions on directory "%s": %s
%s: could not set permissions on file "%s": %s
%s: could not stat file "%s": %s
%s: could not stat transaction log file "%s": %s
%s: could not wait for child process: %s
%s: could not wait for child thread: %s
%s: could not write %u bytes to WAL file "%s": %s
%s: could not write %u bytes to log file "%s": %s
%s: could not write timeline history file "%s": %s
%s: could not write to compressed file "%s": %s
%s: could not write to file "%s": %s
%s: creating replication slot "%s"
%s: directory "%s" exists but is not empty
%s: directory name too long
%s: disconnected
%s: disconnected; waiting %d seconds to try again
%s: dropping replication slot "%s"
%s: final receive failed: %s %s: finished segment at %X/%X (timeline %u)
%s: got WAL data offset %08x, expected %08x
%s: incompatible server version %s
%s: incompatible server version %s; client does not support streaming from server versions newer than %s
%s: incompatible server version %s; client does not support streaming from server versions older than %s
%s: initiating base backup, waiting for checkpoint to complete
%s: integer_datetimes compile flag does not match server
%s: invalid --max-rate unit: "%s"
%s: invalid checkpoint argument "%s", must be "fast" or "spread"
%s: invalid compression level "%s"
%s: invalid fsync interval "%s"
%s: invalid output format "%s", must be "plain" or "tar"
%s: invalid port number "%s"
%s: invalid socket: %s %s: invalid status interval "%s"
%s: invalid tablespace mapping format "%s", must be "OLDDIR=NEWDIR"
%s: invalid tar block header size: %d
%s: invalid transfer rate "%s": %s
%s: invalid xlog-method option "%s", must be "fetch" or "stream"
%s: multiple "=" signs in tablespace mapping
%s: new directory is not an absolute path in tablespace mapping: %s
%s: no data returned from server
%s: no database specified
%s: no slot specified
%s: no target directory specified
%s: no target file specified
%s: no transaction log end position returned from server
%s: not renaming "%s%s", segment is not complete
%s: old directory is not an absolute path in tablespace mapping: %s
%s: only tar mode backups can be compressed
%s: out of memory
%s: received interrupt signal, exiting
%s: received transaction log record for offset %u with no file open
%s: replication connection using slot "%s" is unexpectedly database specific
%s: replication slots can only be used with WAL streaming
%s: replication stream was terminated before stop point
%s: segment file "%s" has incorrect size %d, skipping
%s: select() failed: %s
%s: server reported unexpected history file name for timeline %u: %s
%s: server reported unexpected next timeline %u, following timeline %u
%s: server returned unexpected response to BASE_BACKUP command; got %d rows and %d fields, expected %d rows and %d fields
%s: server stopped streaming timeline %u at %X/%X, but reported next timeline %u to begin at %X/%X
%s: starting background WAL receiver
%s: starting log streaming at %X/%X (slot %s)
%s: starting log streaming at %X/%X (timeline %u)
%s: starting timeline %u is not present in the server
%s: streaming header too small: %d
%s: streaming initiated
%s: switched to timeline %u at %X/%X
%s: symlinks are not supported on this platform
%s: system identifier does not match between base backup and streaming connection
%s: this build does not support compression
%s: too many command-line arguments (first is "%s")
%s: transaction log directory location can only be specified in plain mode
%s: transaction log directory location must be an absolute path
%s: transaction log file "%s" has %d bytes, should be 0 or %d
%s: transfer rate "%s" exceeds integer range
%s: transfer rate "%s" is not a valid value
%s: transfer rate "%s" is out of range
%s: transfer rate must be greater than zero
%s: unexpected response to TIMELINE_HISTORY command: got %d rows and %d fields, expected %d rows and %d fields
%s: unexpected result set after end-of-timeline: got %d rows and %d fields, expected %d rows and %d fields
%s: unexpected termination of replication stream: %s %s: unrecognized link indicator "%c"
%s: unrecognized streaming header: "%c"
%s: waiting for background process to finish streaming ...
Password: Try "%s --help" for more information.
Usage:
cannot duplicate null pointer (internal error)
out of memory
transaction log start point: %s on timeline %u
Project-Id-Version: PostgreSQL 9.2
Report-Msgid-Bugs-To: pgsql-bugs@postgresql.org
POT-Creation-Date: 2019-04-11 19:22+0000
PO-Revision-Date: 2019-04-12 11:44+0300
Last-Translator: Abdullah G. Gülner
Language-Team: Turkish <ceviri@postgresql.org.tr>
Language: tr
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Plural-Forms: nplurals=2; plural=(n != 1);
X-Generator: Poedit 1.8.7.1
Gerçekleştirilecek eylem:
Bağlantı Seçenekleri:
Genel seçenekler:
Seçimli eylemler:
Çıktıyı kontrol eden seçenekler:
Seçenekler:
Hataları <pgsql-bugs@postgresql.org> adresine bildirebilirsiniz.
--create-slot yeni bir replikasyon slot'u oluştur (slot'u adı için bkz. --slot)
--drop-slot replikasyon slot'unu sil (slot'un adı için bkz. --slot)
--if-not-exists zaten mevcut olan bir slot oluşturulmaya çalışıldığında hata verme
--start bir replikasyon slotunda streaming'i başlat (slotun ismi için bkz. --slot)
--synchronous write-ahead logu yazıldıktan hemen sonra temizle
--xlogdir=XLOGDIR transaction log dizini
%s [SEÇENEK]...
-?, --help bu yardımı göster, sonra çık
-D, --directory=DIZIN write-ahead logları bu dizine al
-D, --pgdata=DİZİN temel yedeğin alınacağı dizin
-F --fsync-interval=SANIYE
çıktı dosyasına yapılan fsync işlemleri arasındaki, süre (varsayılan: %d)
-F, --format=p|t çıktı formatı(p: düz metin(varsayılan), t: tar)
-I, --startpos=LSN mevcut bir slot'ta streaming işşleminin başlayacağı konum
-P, --plugin=EKLENTI EKLENTI çıktı eklentisini kullan(varsayılan: %s)
-P, --progress ilerleme bilgisini göster
-R, --write-recovery-conf
replikasyon için recovery.conf yaz
-S, --slot=SLOTADI mantıksal replikasyon slot'unun adı
-S, --slot=SLOTADI kullanılacak replikasyon slot'u
-T, --tablespace-mapping=ESKİDİZİN=YENİDİZİN
ESKİDİZİN'de bulunan tablespace'i YENİDİZİN'e taşır
-U, --username=KULLANICI_ADI belirtilen veritabanı kullanıcısı ile bağlan
-V, --version sürüm bilgisini gösterir ve sonra çıkar
-W, --password parola sor (otomatik olarak her zaman açık)
-X, --xlog-method=fetch|stream
gerekli WAL dosyalarını belirtilen yöntemle dahil et
-Z, --compress=0-9 tar çıktısını belirtilen sıkıştırma seviyesinde sıkıştır
-c, --checkpoint=fast|spread
checkpoint işlemini fast veya spread olarak ayarla
-d, --dbname=CONNSTR bağlantı dizgesi
-d, --dbname=VERITABANI_ADI bağlanılacak veritabanı adı
-f, --file=DOSYAADI logu bu dosyaya al, stdout için -
-h, --host=HOSTNAME veritabanı sunucusu adresi ya da soket dizini
-l, --label=ETİKET yedek etiketini ayarla
-n, --no-loop bağlantı sunucusunda loop yapma
-o, --option=NAME[=VALUE]
çıktı eklentisine NAME seçeneğini VALUE opsiyonel
değeriyle geçir
-p, --port=PORT veritabanı sunucusunun port numarası
-r, --max-rate=RATE veri dizinini aktarmak için azami aktarım hızı
(kB/s olarak, veya "k" veya "M" son ekini kullanın)
-s, --status-interval=INTERVAL
sunucuya gönderilen durum paketleri arasındaki zaman (saniye olarak)
-s, --status-interval=SECS
sunucuya yollanan durum paketleri arasındaki süre (varsayılan: %d)
-v, --verbose verbose modu
-w, --no-password bağlanmak için hiç bir zaman parola sorma
-x, --xlog gerekli WAL dosyalarını yedeğe dahil et (fetch modu)
-z, --gzip tar çıktısını sıkıştır
%*s/%s kB (%d%%), %d/%d tablespace %*s/%s kB (%d%%), %d/%d tablespace %*s/%s kB (%d%%), %d/%d tablespace (%s%-*.*s) %*s/%s kB (%d%%), %d/%d tablespace (%s%-*.*s) %*s/%s kB (100%%), %d/%d tablespace %*s %*s/%s kB (100%%), %d/%d tablespace %*s %s PostgreSQL mantıksal kod çözme akımlarını (stream) kontrol eder
%s stream eden PostgreSQL write-ahead loglarını alır.
%s çalışan bir PostgreSQL sunucusunun temel yedeğini (base backup) alır.
%s: %s bir slotun --slot kullanılarak tanımlanmasını gerektirir
%s: COPY akışı son dosyanın tamamlanmasından önce kesildi
%s: WAL streaming sadece düz metin modunda kullanılabilir
%s: en az bir eylem belirtilmeli
%s: stdout'a sadece bir tablespace yazılabilir, veritabanında %d var
%s: --xlog ve --xlog-method değerlerinin ikisi birden belirtilemez
%s: --create slot veya --drop slot --startpos ile beraber kullanılamaz
%s: --create slot veya --start together --drop slot ile beraber kullanılamaz
%s: --create-slot ile --drop-slot birlikte kullanılamaz
%s: checkpoint tamamlandı
%s: %d alt süreç sonlandı, beklenen %d
%s: alt süreç normal olarak sonlanmadı
%s: alt süreç %d hata kodu ile sonlandı
%s: alt iş parçacığı (thread) %u hata kodu ile sonlandı
%s: %X/%X e kadar yazma, %X/%X'e kadar boşaltma (flush) için onaylama (slot %s)
%s: "%s" dizine erişim hatası: %s
%s: search_path temizlenemedi: %s %s: "%s" sıkıştırılmış dosyası kapatılamadı: %s
%s: "%s" dizini kapatılamadı: %s
%s: "%s" dosyası kapatılamadı: %s
%s: sunucuya bağlanılamadı
%s: sunucuya bağlanılamadı: %s %s: "%s" arşiv durum dosyası oluşturulamadı: %s
%s: artalan süreci oluşturulamadı: %s
%s: artalan iş parçası oluşturulamadı: %s
%s: "%s" sıkıştırılmış dosyası yaratılamadı: %s
%s: "%s" dizini oluşturma başarısız: %s
%s: "%s" dosyası yaratılamadı: %s
%s: artalan süreci için pipe oluşturulamadı: %s
%s: "%s" replikasyon slot'u oluşturulamadı: %d satır ve %d alan alındı,%d satır ve %d alan bekleniyordu
%s: symbolic link "%s" oluşturma hatası: %s
%s: "%s" dosyasından "%s" dosyasına sembolik bağlantı yaratılamadı: %s
%s: "%s" zaman çizelgesi geçmiş dosyası yaratılamadı: %s
%s: "%s" dosyasınde arama pozisyonu belirlenemedi: %s
%s: integer_datetimes için sunucu ayarı belirlenemedi
%s: "%s" replikasyon slot'u silinemedi: %d satır ve %d alan alındı,%d satır ve %d alan bekleniyordu
%s: veritabanına özel replikasyon bağlantısı kurulamadı
%s: "%s" dosyası fsync işlemi başarısız: %s
%s: "%s" kayıt dosyası fsync hatası: %s
%s: COPY very akışı alınamadı: %s %s: yedek başlığı alınamadı %s %s: alt iş parçacığı (thread) bitiş durumu alınamadı %s
%s: sunucudan transaction log bitiş pozisyonu alınamadı: %s %s: sistem belirlenemedi: %d satır ve %d alan alındı, %d satır ve %d veya daha fazla alan bekleniyordu
%s: temel yedek başlatılamadı: %s %s: "%s" dizini açılamadı: %s
%s: "%s" kayıti dosyası açılamıyor: %s
%s: "%s" zaman çizelgesi geçmiş dosyası açılamadı: %s
%s: "%s" write-ahead log dosyası açılamadı: %s
%s: "%s" işlem kayıt (transaction log) dosyası doldurulamadı: %s
%s: sonraki timeline'ın başlama noktası "%s" ayrıştırılamadı
%s: "%s" başlama pozisyonu ayrıştırılamadı
%s: "%s" transaction log konumu ayrıştıramadı
%s: COPY verisi okunamadı: %s %s: "%s" dizini okunamadı: %s
%s: ready pipe'dan okunamadı: %s
%s: WAL stream'den veri alınamadı: %s %s: "%s" dosyasının ismi "%s" olarak değiştirilemedi : %s
%s: "%s" dosyasının ismi değiştirilemedi : %s
%s: "%s" işlem kayıt (transaction log) dosyasının başlangıcına ilerleme hatası : %s
%s: artalan pipe'ına komut gönderilemedi: %s
%s: kopya-sonu paketi gönderilemedi: %s %s: geri bildirim (feedback) paketi gönderilemedi: %s %s: "%s" replikasyon komutu gönderilemedi: %s %s: %d:sıkıştırma seviyesi ayarlanamadı %s
%s: "%s" dizininde izinler ayarlanamadı: %s
%s: "%s" dosyasının izinleri ayarlanamadı: %s
%s: "%s" dosyasının durumu görüntülenemiyor (stat): %s
%s: "%s" wal log dosyasının durumu görüntülenemedi (stat): %s
%s: alt süreç için beklenemedi: %s
%s: alt iş parçacığı (thread) için beklenemedi: %s
%1$s: "%3$s" WAL dosyasına %2$u bayt yazılamadı: %4$s
%1$s: "%3$s" log dosyasına %2$u bayt yazılamadı: %4$s
%s: "%s" zaman çizelgesi geçmiş dosyasına yazılamadı: %s
%s: "%s" sıkıştırılmış dosyasına yazılamadı: %s
%s: "%s":dosyasına yazılamadı: %s
%s: "%s" replikasyon slot'u oluşturuluyor
%s: "%s" dizini mevcut, ama boş değil
%s: dizin adı çok uzun
%s: bağlantı kesildi
%s: bağlantı kesildi; tekrar denemek için %d saniye bekleniyor
%s: "%s" replikasyon slot'u siliniyor
%s: son alma işlemi başarısız oldu: %s %s: segment %X/%X de bitirildi (%u zaman çizelgesi)
%s: %08x WAL data offset'i alındı , %08x bekleniyordu
%s: sunucu sürümü %s uyumsuz
%s: uyumsuz sunucu sürümü %s; istemci %s den daha yeni sunucu sürümlerinden streaming işlemini desteklemiyor
%s: uyumsuz sunucu sürümü %s; istemci %s den daha eski sunucu sürümlerinden streaming işlemini desteklemiyor
%s: temel yedek başlatılıyor, checkpoin'in tamamlanması bekleniyor
%s: integer_datetimes derleme seçeneği sunucu ile eşleşmiyor
%s: --max-rate için geçersiz birim: "%s"
%s: geçersiz checkpoint argümanı "%s", "fast" ya da "spread" olmalı
%s: geçersiz sıkıştırma seviyesi "%s"
%s: geçersiz fsync aralığı "%s"
%s: geçersiz çıktı biçimi "%s", "plain" ya da "tar" olmalı
%s: geçersiz port numarası: "%s"
%s: geçersiz soket: %s %s: geçersiz durum aralığı "%s"
%s: geçersiz tablespace eşleme biçimi "%s", "ESKİDİZİN=YENİDİZİN" olmalı
%s: geçersiz tar blok başlık boyutu: %d
%s: geçersiz aktarım hızı "%s": %s
%s: geçersiz xlog-yöntemi seçeneği "%s", "fetch" ya da "stream" olmalı
%s: tablespace eşlemesinde çoklu "=" işareti
%s: yeni dizin tablespace eşlemesinde mutlak bir yol değil: %s
%s: sunucudan veri dönmedi
%s: hiçbir veri tabanı belirtilmedi
%s: hiç bir slot belirtilmedi
%s: hedef dizin belirtilmedi
%s: hiç bir hedef dosya belirtilmedi
%s: sunucudan WAL bitiş pozisyonu dönmedi
%s: "%s%s" isim değişikliği yapılmıyor, segment tam değil
%s: eski dizin tablespace eşlemesinde mutlak bir yol değil: %s
%s: sadece tar mod yedekleri sıkıştırılabilir
%s: yetersiz bellek
%s: kesme (interrupt) sinyali alındı, çıkılıyor
%s: açık dosya yokken %u offset için transaction log kaydı alındı
%s: "%s" slotunu kullanan replikasyon bağlantısı beklenmedik şekilde veritabanı spesifik
%s: replikasyon slotları sadece WAL streaming ile kullanılabilir
%s: durma noktasından önce replikasyon akışı sonlandırıldı
%s: "%s" segment dosyasının boyutu %d yanlış, atlanıyor
%s: select() başarısız oldu: %s
%s: sunucu %u zaman çizelgesi için beklenmeyen geçmiş dosyası adı bildirdi: %s
%1$s: sunucu %3$u zaman çizelgesini takiben beklenmedik sonraki zaman çizelgesi %2$u bildirdi
%s: sunucu BASE_BACKUP komutuna beklenmedik cevap döndü; %d satır ve %d alan alındı, %d satır ve %d alan bekleniyordu
%s: sunucu %u streaming zaman çizelgesini %X/%X de durdurdu, fakat sonraki %u zaman çizelgesinin %X/%X de başlayacağını bildirdi
%s: arka plan WAL alıcısı başlatılıyor
%s: log streaming %X/%X konumunda başlatılıyor (%s slot'u)
%s: log streaming %X/%X konumunda başlatılıyor (%u zaman çizelgesi)
%s: başlayan zaman çizelgesi %u sunucuda mevcut değil
%s: streaming üst bilgisi çok küçük: %d
%s: streaming başlatıldı
%1$s: %3$X/%4$X konumunda %2$u zaman çizelgesine geçildi
%s: bu platformda sembolik bağlantı (symlink) desteklenmemektedir
%s: system tanımlayıcısı temel yedek ve streaming bağlantısı ile eşleşmiyor
%s: bu kurulum sıkıştırmayı desteklemiyor
%s: Çok fazla komut satırı girdisi var (ilki "%s")
%s: WAL dizini lokasyonu sadece plain modunda belirtilebilir
%s: transaction log dizini mutlak bir yol olmalıdır
%s: "%s" wal log dosyası %d bayt, 0 veya %d olmalıydı
%s: "%s" aktarım hızı tamsayı aralığını aşıyor
%s: "%s" aktarım hızı geçerli bir değer değil
%s: "%s" aktarım hızı sonuç sıra dışıdır
%s: aktarım hızı sıfırdan büyük olmalı
%s: TIMELINE_HISTORY komutuna beklenmedik cevap; %d satır ve %d alan alındı, %d satır ve %d alan bekleniyordu
%s: zaman çizelgesi sonundan sonar beklenmedik sonuç kümesi: %d satır ve %d alan alındı, %d satır ve %d alan bekleniyordu
%s: replikasyon akışında beklenmeyen sonlanma: %s %s: tanımlanamayan bağlantı göstergesi "%c"
%s: tanınmayan streraming üst bilgisi (header): "%c"
%s: artalan sürecinin akımı (streaming) bitirmesi bekleniyor ...
Parola: Ayrıntılı bilgi için "%s --help" komutunu deneyebilirsiniz.
Kullanımı:
null pointer duplicate edilemiyor (iç hata)
bellek yetersiz
transaction log başlama noktası: %2$u zaman çizelgesinde %1$s
locale/tr/LC_MESSAGES/libpq5-9.6.mo 0000644 00000056010 14751153420 0012264 0 ustar 00 �� � | � 0 1 B E J P b
x ' � ( � � # � - $ : _ y
� 0 � ( � ( � * 6 5 = 8 s 0 � � $ � # # G S - e 8 � � � . ( 3 , \ � � : � " � ! < 2 a o 0 � ) ' , * T . + � ' � ' * * * U + � * � , � ) ) . + X - � / � + � ( ) 7 & a 5 � 3 � & � ! ; V k " � v � w ! r � ! - O ' l - � � � # V 9 z & � ) � * # 0 9 T ) � ' � ) �
) ( " R 9 u . � ' � * ! " 1! " T! . w! / �! - �! @ " 2 E" ! x" % �" % �" & �" V
# = d# ; �# �# �# $ 4 ;$ 0 p$ �$ : �$ �$ % :% - [% - �% �% + �% 2 �% 7 2& = j& ! �& . �& 8 �& " 2' U' F u' C �' $ ( %( B @( �( �( ; �( ( �( * ) & @) % g) ! �) 6 �) C �) ? ** 2 j* 1 �* = �* )
+ J 7+ �+ �+ �+ �+ �+ 1 ,
7, E, + T, �, ) �, " �, [ �, H- ? a- 1 �- 8 �- > . � K. # �. �. : / � @/ 2 �/ Q �/ J O0 K �0 �0 1 1 ? .1 ! n1 + �1 �1 �1 L �1 D 62 % {2 . �2 C �2 3 $ 53 5 Z3 ) �3 � �3 �5 �5 �5 �5 �5 �5
�5 1 6 2 56 . h6 % �6 �6
�6 & �6 7 7 87 1 E7 * w7 * �7
�7 �7 �7 O �7 R 78 D �8 # �8 - �8 & !9 H9 T9 0 d9 I �9 �9 ! �9 : : ) U: 8 : �: �: O �: $ ,; Q; d; 8 t; � �; < 4< 4 q< ' �< 3 �< 7 = 4 := D o= ( �= , �= -
> - 8> , f> . �> + �> + �> - ? / H? 1 x? - �? * �? + @ /@ : M@ 8 �@ 2 �@ �@ A 2A LA % kA � �A � B x �B ! C ! ;C ]C $ wC ( �C � �C 3 ]D : �D " �D % �D ) E ! ?E @ aE * �E . �E # �E F ! @F $ bF > �F + �F �F * G ! =G ' _G . �G - �G . �G 5 H . IH ! xH % �H �H �H Y I ; \I B �I �I �I J B /J 3 rJ �J < �J & K 'K DK F aK F �K �K 2
L 2 @L 8 sL D �L ' �L ; M @ UM & �M % �M K �M W /N . �N �N N �N %O 6O G WO , �O 0 �O 8 �O ) 6P % `P @ �P L �P E Q 9 ZQ F �Q B �Q 3 R R RR �R �R �R 2 �R (S 5 AS wS �S 8 �S " �S ! �S T � 7T �T E �T 1 U 6 QU F �U � �U 3 jV �V G �V � W . �W V �W P .X Q X ! �X �X Y 8 %Y ^Y 5 |Y ! �Y �Y ^ �Y D PZ ( �Z B �Z H [ " J[ # m[ B �[ 3 �[ � l � A � O � m . M f � d � H @ � t * � k U � 4 � � a � � / G � T % � 5 Y u �
, � � r � � R 7 6 � � � z � � S : ! ; 1 [ L � - � Z � x ` s n � " � K ' � � y
b � 8 3 � � � � = ^ # < � � � � c F ( � \ p v Q N � � � 9 � ~ q � � o � � J � B w $ V } W D � E � � 2 � h � & i � _ � � 0 � � � � X > � g e ? ) � � � � + � | I { � � C ] j � � � P � � � at character %s %s %s, %s:%s COLUMN NAME: %s
CONSTRAINT NAME: %s
CONTEXT: %s
COPY IN state must be terminated first
COPY OUT state must be terminated first
COPY terminated by new PQexec Crypt authentication not supported
DATATYPE NAME: %s
DETAIL: %s
GSSAPI authentication not supported
GSSAPI continuation error GSSAPI name import error HINT: %s
IPv6 host address may not be empty in URI: "%s"
Kerberos 4 authentication not supported
Kerberos 5 authentication not supported
LINE %d: LOCATION: NOTICE PGEventProc "%s" failed during PGEVT_CONNRESET event
PGEventProc "%s" failed during PGEVT_RESULTCREATE event
PGresult cannot support more than INT_MAX tuples PGresult is not an error result
PQexec not allowed during COPY BOTH
PQgetline: not doing text COPY OUT
QUERY: %s
SCHEMA NAME: %s
SCM_CRED authentication method not supported
SCRAM authentication requires libpq version 10 or above
SSL SYSCALL error: %s
SSL SYSCALL error: EOF detected
SSL certificate's name contains embedded null
SSL certificate's name entry is missing
SSL connection has been closed unexpectedly
SSL error code %lu SSL error: %s
SSL library does not support CRL certificates (file "%s")
SSPI authentication not supported
SSPI continuation error TABLE NAME: %s
Unix-domain socket path "%s" is too long (maximum %d bytes)
WARNING: password file "%s" has group or world access; permissions should be u=rw (0600) or less
WARNING: password file "%s" is not a plain file
WSAIoctl(SIO_KEEPALIVE_VALS) failed: %ui
another command is already in progress
argument of lo_read exceeds integer range
argument of lo_truncate exceeds integer range
argument of lo_write exceeds integer range
attribute has no values on LDAP lookup
authentication method %u not supported
cannot determine OID of function lo_close
cannot determine OID of function lo_creat
cannot determine OID of function lo_create
cannot determine OID of function lo_lseek
cannot determine OID of function lo_lseek64
cannot determine OID of function lo_open
cannot determine OID of function lo_tell
cannot determine OID of function lo_tell64
cannot determine OID of function lo_truncate
cannot determine OID of function lo_truncate64
cannot determine OID of function lo_unlink
cannot determine OID of function loread
cannot determine OID of function lowrite
certificate could not be obtained: %s
certificate does not match private key file "%s": %s
certificate present, but not private key file "%s"
column number %d is out of range 0..%d command string is a null pointer
connection in wrong state
connection not open
connection pointer is NULL
could not acquire SSPI credentials could not connect to server: %s
Is the server running locally and accepting
connections on Unix domain socket "%s"?
could not connect to server: %s
Is the server running on host "%s" (%s) and accepting
TCP/IP connections on port %s?
could not connect to server: %s
Is the server running on host "%s" and accepting
TCP/IP connections on port %s?
could not create LDAP structure
could not create SSL context: %s
could not create socket: %s
could not establish SSL connection: %s
could not get client address from socket: %s
could not get home directory to locate root certificate file
Either provide the file or change sslmode to disable server certificate verification.
could not get peer credentials: %s
could not get server's host name from server certificate
could not get socket error status: %s
could not initialize SSL engine "%s": %s
could not interpret result from server: %s could not load SSL engine "%s": %s
could not load private SSL key "%s" from engine "%s": %s
could not load private key file "%s": %s
could not look up local user ID %d: %s
could not open certificate file "%s": %s
could not open file "%s": %s
could not read certificate file "%s": %s
could not read from file "%s": %s
could not read private SSL key "%s" from engine "%s": %s
could not read root certificate file "%s": %s
could not receive data from server: %s
could not send SSL negotiation packet: %s
could not send data to server: %s
could not send startup packet: %s
could not set socket to TCP no delay mode: %s
could not set socket to close-on-exec mode: %s
could not set socket to nonblocking mode: %s
could not translate Unix-domain socket path "%s" to address: %s
could not translate host name "%s" to address: %s
could not write to file "%s": %s
definition of service "%s" not found
duplicate GSS authentication request
duplicate SSPI authentication request
end of string reached when looking for matching "]" in IPv6 host address in URI: "%s"
expected authentication request from server, but received %c
extra key/value separator "=" in URI query parameter: "%s"
extraneous data in "D" message extraneous data in "T" message extraneous data in "t" message forbidden value %%00 in percent-encoded value: "%s"
function requires at least protocol version 3.0
host name must be specified
host name must be specified for a verified SSL connection
incomplete multibyte character
insufficient data in "D" message insufficient data in "T" message integer of size %lu not supported by pqGetInt integer of size %lu not supported by pqPutInt invalid ExecStatusType code invalid LDAP URL "%s": invalid port number
invalid LDAP URL "%s": missing distinguished name
invalid LDAP URL "%s": must have exactly one attribute
invalid LDAP URL "%s": must have search scope (base/one/sub)
invalid LDAP URL "%s": no filter
invalid LDAP URL "%s": scheme must be ldap://
invalid URI propagated to internal parser routine: "%s"
invalid URI query parameter: "%s"
invalid connection option "%s"
invalid connection state %d, probably indicative of memory corruption
invalid connection state, probably indicative of memory corruption
invalid percent-encoded token: "%s"
invalid port number: "%s"
invalid setenv state %c, probably indicative of memory corruption
invalid socket
invalid sslmode value: "%s"
invalid state %c, probably indicative of memory corruption
keepalives parameter must be an integer
length must be given for binary parameter
line %d too long in service file "%s"
local user with ID %d does not exist
lookup on LDAP server failed: %s
lost synchronization with server, resetting connection lost synchronization with server: got message type "%c", length %d
message contents do not agree with length in message type "%c"
message type 0x%02x arrived from server while idle missing "=" after "%s" in connection info string
missing key/value separator "=" in URI query parameter: "%s"
more than one entry found on LDAP lookup
nested service specifications not supported in service file "%s", line %d
no COPY in progress
no SSL error reported no connection to the server
no entry found on LDAP lookup
no error message available
number of parameters must be between 0 and 65535
out of memory out of memory
out of memory allocating GSSAPI buffer (%d) out of memory for query result parameter number %d is out of range 0..%d password retrieved from file "%s"
private key file "%s" has group or world access; permissions should be u=rw (0600) or less
protocol error: id=0x%x
query to initialize large object functions did not return data
received invalid response to SSL negotiation: %c
requirepeer parameter is not supported on this platform
requirepeer specifies "%s", but actual peer user name is "%s"
root certificate file "%s" does not exist
Either provide the file or change sslmode to disable server certificate verification.
row number %d is out of range 0..%d select() failed: %s
server certificate for "%s" does not match host name "%s"
server closed the connection unexpectedly
This probably means the server terminated abnormally
before or while processing the request.
server does not support SSL, but SSL was required
server sent binary data ("B" message) without prior row description ("T" message) server sent data ("D" message) without prior row description ("T" message) server sent data ("D" message) without prior row description ("T" message)
service file "%s" not found
setsockopt(%s) failed: %s
size_t overflow sslmode value "%s" invalid when SSL support is not compiled in
statement name is a null pointer
syntax error in service file "%s", line %d
timeout expired
unexpected asyncStatus: %d
unexpected character "%c" at position %d in URI (expected ":" or "/"): "%s"
unexpected character %c following empty query response ("I" message) unexpected field count in "D" message unexpected message from server during startup
unexpected response from server; first received character was "%c"
unrecognized SSL error code: %d
unrecognized socket error: 0x%08X/%d unterminated quoted string in connection info string
user name lookup failure: error code %lu
Project-Id-Version: libpq-tr
Report-Msgid-Bugs-To: pgsql-bugs@postgresql.org
POT-Creation-Date: 2018-04-20 21:48+0000
PO-Revision-Date: 2018-04-30 15:24+0300
Last-Translator: Abdullah G. Gülner
Language-Team: Turkish <ceviri@postgresql.org.tr>
Language: tr
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
X-Generator: Poedit 1.8.7.1
X-Poedit-Basepath: /home/ntufar/pg/pgsql/src/interfaces/libpq
X-Poedit-SearchPath-0: /home/ntufar/pg/pgsql/src/interfaces/libpq
%s. karakterde %s %s, %s:%s SÜTUN ADI: %s
KISITLAMA ADI: %s
BAĞLAM: %s
Öncelikle COPY IN durumu sonlandırılmalıdır
Öncelikle COPY OUT durumu sonlandırılmalıdır
COPY, yeni PQexec tarafından sonlandırıldı Crypt yetkilendirmesi desteklenmiyor
VERİ TİPİ ADI: %s
AYRINTI: %s
GSSAPI yetkilendirmesi desteklenmiyor
GSSAPI devam hatası GSSAPI ad aktarma hatası İPUCU: %s
URI içinde IPv6 sunucu adresi boş olamaz: "%s"
Kerberos 4 yetkilendirmesi desteklenmiyor
Kerberos 5 yetkilendirmesi desteklenmiyor
SATIR %d: YER: BİLGİ PGEventProc "%s" işlemi PGEVT_CONNRESET işlemi sırasında başarısız oldu
PGEventProc "%s" işlemi PGEVT_RESULTCREATE işlemi sırasında başarısız oldu
PGresult INT_MAX değerinden daha fazla satır (Tuple) destekleyemez PGresult bir hata sonucu değildir
PQexec COPY BOTH sırasında izin verilmiyor
PQgetline: COPY OUT metnini yapmıyor
SORGU: %s
ŞEMA ADI: %s
SCM_CRED yetkilendirme yöntemi desteklenmiyor.
SCRAM yetkilendirmesi libpq'nun 10 ya da yukarı sürümünü gerektirir
SSL SYSCALL hatası: %s
SSL SYSCALL hatası: EOF bulundu
SSL sertifikasının ismi gömülü olarak null içeriyor
SSL sertifikasının isim girişi eksik
SSL bağlantısı beklenmeyen şekilde sonlandırıldı
SSL hata kodu: %lu SSL hatası: %s
Kurulu SSL kütüphanesi CRL sertifikalarını desteklemiyor (dosya adı "%s")
SSPI yetkilendirmesi desteklenmiyor
SSPI devam hatası TABLO ADI: %s
Unix-domain socket yolu "%s" fazla uzun (azami %d bayt)
UYARI: "%s" şifre dosyası herkes ya da grup tarafından erişilebilir durumda; dosyanın izinleri u=rw (0600) ya da daha az olmalı
UYARI: "%s" password dosyası düz metin dosyası değildir
WSAIoctl(SIO_KEEPALIVE_VALS) başarısız oldu: %ui
şu anda işlenen başka bir komut var
lo_read argümanı tamsayı aralığını aşıyor
lo_truncate argümanı tamsayı aralığını aşıyor
lo_write argümanı tamsayı aralığını aşıyor
LDAP sorgusu sonucunda bulunan attribute, hiçbir değer içermiyor
%u yetkilendirme sistemi desteklenmiyor
lo_close fonksiyonunun OID'i belirlenemiyor
lo_create fonksiyonunun OID'i belirlenemiyor
lo_create fonksiyonunun OID'i belirlenemiyor
lo_lseek fonksiyonunun OID'i belirlenemiyor
lo_lseek64 fonksiyonunun OID'i belirlenemiyor
lo_open fonksiyonunun OID'i belirlenemiyor
lo_tell fonksiyonunun OID'i belirlenemiyor
lo_tell64 fonksiyonunun OID'i belirlenemiyor
lo_truncate fonksiyonunun OID'i belirlenemiyor
lo_truncate64 fonksiyonunun OID'i belirlenemiyor
lo_unlink fonksiyonunun OID'i belirlenemiyor
loread fonksiyonunun OID'i belirlenemiyor
lowrite fonksiyonunun OID'i belirlenemiyor
sertifika elde edilemedi: %s
Sertifika, "%s" özel anahtar dosyası ile uyuşmuyor: %s
Sertifika mevcut ancak özel anahtar mevcut değil "%s"
%d kolon numarası, 0..%d sınırının dışında komut katarı null belirteçtir
bağlantı yanlış durumda
bağlantı açık değil
bağlantı belirteci NULL'dur
SSPI kimlik bilgileri alınamadı: %m sunucuya bağlanılamadı: %s
Sunucu yerelde çalışıyor ve Unix domain
soketleri üzerinden bağlantılara izin veriyor mu? "%s"?
sunucuya bağlanılamadı: %s
Sunucu "%s" (%s) sunucusunda çalışıyor ve
%s portundan TCP/IP bağlantılarına izin veriyor mu?
sunucuya bağlanılamadı: %s
ls Sunucu "%s" sunucunda çalışıyor ve
%s portundan bağlantılara izin veriyor mu?
LDAP yapısı oluşturma hatası
SSL içeriği yaratılamadı: %s
soket yaratılamadı: %s
SSL bağlantısı sağlanamadı: %s
soketten istemci adresi alınamadı: %s
kök sertifika dosyasının ev dizini bulunamadı
Ya bir dosya adı belirtin, ya da sunucu sertifika onaylamasını kapatmak için sslmode'u kapatın.
karşı tarafın kimlik bilgileri alınamadı: %s
sunucunun makina adı sunucu sertifikasından alınamadı
soket hata durumu alınamadı: %s
"%s" SSL motoru ilklendirilemedi: %s
sunucudan gelen yanıt yorumlanamadı: %s "%s" SSL motoru yüklenemedi: %s
"%2$s" motorundan "%1$s" SSL özel anahtarı yüklenemedi: %3$s
private key dosyası "%s" okunamıyor: %s
geçerli kullanıcı ID si bulunamadı %d: %s
"%s" sertifikası açılamadı: %s
"%s" dosyası açılamadı: %s
"%s" sertifikası okunamadı: %s
"%s" dosyasından okuma hatası: %s
"%2$s" motorundan "%1$s" SSL özel anahtarı okunamadı: %3$s
"%s"kök sertifika dosyası okunamadı: %s
Sunucudan veri alınamadı: %s
could not send SSL negotiation packet: %s
Sunucuya veri gönderilemedi: %s
başlangıç paketi gönderilemedi: %s
could not set socket to TCP no delay mode: %s
soket close-on-exec moduna ayarlanamadı: %s
socket, non-blocking mode'a ayarlanamadı: %s
"%s" Unix domain soket yolu adrese çevirilemedi: %s
"%s" makine adı bir adrese çevirilemedi: %s
"%s" dosyasına yazılamadı: %s
"%s" servisinin tanımı bulunamadı
çift GSS yetkilendirme isteği
çift GSS yetkilendirme isteği
URI içinde IPv6 sunucu adresinde eşleşen "]" aranırken dize sonuna ulaşıldı: "%s"
sunucudan yetkilendirme isteği beklendi ancak %c alındı
URI sorgu parametresinde fazla anahtar/değer ayıracı "=": "%s"
"D" mesajında ilgisiz veri "T" mesajında ilgisiz veri "t" mesajında ilgisiz veri percent-encoded değeri içinde izin verilmeyen değer %%00: "%s"
fonksiyon en az 3.0 prokolüne gereksinim duyuyor.
sunucu adı belirtilmelidir
onaylı SSL bağlantısı için sunucu adı belirtilmelidir
tamamlanmamış çoklu bayt karakteri
"D" mesajında yetersiz veri "T" mesajında yetersiz veri %lu büyüklüğündeki tamsayılar pqGetInt tarafından desteklenmez. %lu büyüklüğündeki tamsayılar pqPutInt tarafından desteklenmez. geçersiz ExecStatusType kodu geçersiz LDAP URL "%s": geçersiz port numarası
geçersiz LDAP URL "%s": distinguished name eksik
geçersiz LDAP URL "%s": tam bir attribute içermelidir
geçersiz LDAP URL "%s": arama kapsamı içermelidir (base/one/sub)
geçersiz LDAP URL "%s": filtere eksik
geçersiz LDAP URL "%s": şema, ldap:// ile başlamalıdir
dahili çözümleyici yordamına aktarılan geçersiz URI: "%s"
geçersiz URI sorgu parametresi: "%s"
geçersiz bağlantı seçeneği "%s"
%d - geçersiz bağlantı durumu, bellekteki veri zarar görmüş olabilir
Geçersiz bağlantı durumu, hafızanın zarar görmüş olmasının işareti olabilir
geçersiz percent-encoded andacı (token)"%s"
Geçersiz port numarası: "%s"
Geçersiz setenv durumu %c, belleğin zarar görmesinin bir işareti olabilir
geçersiz soket
geçersiz sslmode değeri: "%s"
Geçersiz %c durumu, belleğin zarar görmesinin bir işareti olabilir
keepalives parametresi tamsayı olmalıdır
binary parametresinin uzunluğu belirtilmelidir
"%2$s" servis dosyasında %1$d no'lu satır çok uzun
yerel kullanıcı ID %d mevcut değildir
LDAP sonucunda sorgulama hatası: %s
sunucu ile eşzamanlama kayboldu, bağlantı yeniden açılıyor sunucu ile eşzamanlılık kayboldu: "%c" ileti tipi alındı, uzunluğu %d
İleti içeriği,"%c" ileti tipinin içindeki uzunlukla aynı değil
Sunucu boş durumdayken sunucudan 0x%02x ileti tipi geldi bağlantı bilgi katarında "%s" bilgisinden sonra "=" işareti eksik
URI sorgu parametresinde eksik anahtar/değer ayıracı "=": "%s"
LDAP sorgusu sonucunda birden fazla giriş bulundu
"%s" servis dosyasında iç içe servis özellikleri desteklenmiyor, satır no %d
çalışan COPY süreci yok
SSL hatası raporlanmadı sunucuya bağlantı yok
LDAP sorgusu sonucunda hiçbir giriş bulunamadı
hata mesajı bulunmuyor
parametrelerin sayısı 0 ve 65535 arasında olmalı
yetersiz bellek yetersiz bellek
GSSAPI tamponu ayrılırken yetersiz bellek hatası (%d) sorgu sonucu için yetersiz bellek %d parametre sıra dışı: 0..%d "%s" dosyasından parola okundu
"%s" özel anahtar dosyası herkes ya da grup tarafından erişilebilir durumda; dosyanın izinleri u=rw (0600) ya da daha az olmalı
protokol hatası: id=0x%x
large object fonksiyonlarını ilklendirecek sorgu veri döndürmedi
ssl görüşmesine geçersiz yanıt alındı: %c
bu platformda requirepeer parametresi desteklenmiyor
requirepeer "%s" belirtiyor, ancak gerçek peer kullanıcı aıd "%s"
"%s" kök sertifika dosyası mevcut değil
Ya bu dosyayı oluşturun ya da sslmode ayarını sunucu sertifika onaylamasını kapatmak için değiştirin.
%d satır numarası, 0..%d sınırının dışında select() başarısız oldu: %s
"%s" için olan sunucu sertifikası makina adı "%s" ile eşleşmiyor
sunucu bağlantıyı beklenmedik şekilde kapattı
Bu ileti sunucunun isteği işlemeden hemen önce ya da
isteği işlerken kapatıldığı anlamına gelir.
sunucu SSL desteklemiyor, ama SSL gerekli idi
Sunucu öncelikli satır tanımı olmadan ikili veri ("D" ileti) gönderdi ("T" ileti) Sunucu öncelikli satır tanımı olmadan veri ("D" ileti) gönderdi ("T" ileti) Sunucu öncelikli satır tanımı olmadan veri ("D" ileti) gönderdi ("T" ileti)
"%s" servis dosyası bulunamadı
setsockopt(%s) başarısız: %s
size_t taşması "%s" ssl modu, SSL desteği derlenmeyince geçersizdir.
durum adı null belirteçtir
"%s" servis dosyasında yazım hatası, satır no %d
zamanaşımı süresi sona derdi
beklenmeyen asyncStatus: %d
URI içinde %2$d pozisyonunda beklenmeyen karakter "%1$c" (":" veya "/" bekleniyordu): "%3$s"
Boş sorgu yanıtını takip eden geçersiz karakter:%c ("I" ileti) "D" mesajında beklenmeyen alan sayısı başlangıç sırasında sunucudan beklenmeyen bir mesaj alındı
sunucudan beklenmeyen bir yanıt alındı; alınan ilk karakter"%c" idi
tanımlanamayan SSL hata kodu: %d
bilinmeyen soket hatası: 0x%08X/%d bağlantı bilgi katarında sonlandırılmamış tırnaklı katar
kullanıcı adı arama başarısız: hata kodu %lu
locale/tr/LC_MESSAGES/pgscripts-9.6.mo 0000644 00000064512 14751153420 0013114 0 ustar 00 �� � | � 0 K 1 }
� > � > � = - Z � � C A d � � # � � ( 9 I V E � � > f ; � = � : < Z 9 � 6 � 5 C > C � 9 � 4 E 5 = { . � ; � E $ : j ? � A � < ' 9 d 7 � 4 � L J X 3 � H � E B f A � 5 � 2 ! N T 7 � 2 � 2 J A : � 5 � G � 0 E < v 0 � ) � M J \ G � 4 � C $! H h! E �! D �! = <" v z" < �" � .# Q �# I $ @ N$ 5 �$ 4 �$ 1 �$ 0 ,% ; ]% 5 �% ' �% 6 �% 3 .& 4 b& @ �& ; �& ; ' ` P' 8 �' 2 �' 9 ( 6 W( > �( �( / �( < ) # F) # j) ? �) 8 �) % * # -* Q* 3 q* & �* �* E �* 6 + E P+ F �+ K �+ 7 ), K a, 7 �, J �, 6 0- < g- D �- 5 �- . * =. 8 h. 6 �. ( �. 4 / $ 6/ # [/ / �/ 8 �/ 4 �/ $ .0 S0 , s0 , �0 ( �0 / �0 ; &1 9 b1 ! �1 �1 \ �1 02 C2 * a2 8 �2 9 �2 , �2 8 ,3 # e3 4 �3 3 �3 �3 ) 4 7 94 q4
�4 �4 C �4 A �4 ! /5 + Q5 }5 �5 �5 �5 . �5 3 6 2 H6 {6 �6 �6
�6 �6 �6 �6 ' 7 " (7 2 K7 7 ~7 �7 & �7 �7 �7 / 8 + 58 * a8 �8 �8 �8 �8 �8 �8 �8 �8 ( �8 9 9 9 R :; �; �; U �; P
< J ^< C �< � �< B �= A �= #> # 7> . [> % �> - �> �> K �> K K? � �? < @ 9 Z@ 8 �@ : �@ D A A MA D �A = �A G B K ZB @ �B = �B H %C = nC 0 �C = �C ] D 6 yD J �D G �D S CE @ �E D �E A F W _F g �F @ G I `G F �G I �G B ;H 9 ~H 8 �H \ �H B NI @ �I C �I [ J B rJ D �J L �J G GK M �K J �K 5 (L F ^L G �L D �L ; 2M @ nM N �M K �M N JN H �N Y �N J <O � �O ] P A |P @ �P 3 �P 8 3Q : lQ 9 �Q 6 �Q 0 R / IR : yR 6 �R ? �R T +S U �S j �S s AT 5 �T 7 �T 1 #U ) UU G U �U ; �U [ V ) kV ( �V : �V ? �V 1 9W % kW # �W . �W , �W X M X A fX T �X P �X W NY F �Y S �Y E AZ V �Z E �Z F $[ H k[ F �[ & �[ > "\ P a\ I �\ ) �\ 7 &] ) ^] 5 �] - �] 3 �] > ^ 1 _^ & �^ + �^ - �^ - _ - @_ / n_ L �_ J �_ 6 6` m` _ �` �` + a D 0a Z ua ^ �a ? /b R ob / �b 7 �b 4 *c # _c < �c S �c d
.d <d O Xd E �d ! �d / e @e Pe " ne �e 9 �e A �e 9 +f ef nf sf �f �f ) �f �f ) �f g ) 1g : [g �g 7 �g
�g �g - h . 7h ) fh �h �h �h
�h �h �h �h �h 2 i Ci Ei � � 9 � � t � � � I S � w & % � � � � G � � - . � � X � { � " � 7 � o � � < � � � L � 4 / K i u � J � ~ B m ( � � � * �
n f H p � # D g @ ' > � � U � v � x [ � 3
N � � k ! � 8 , � Y F ; � � z � � Z � T � � 6 r M � + a 2 W � � $ ] _ � � } = s � j � � ? � ` � c | � l \ V � � � � � E ) : q � � Q C b 1 0 h A y � d R ^ O � � � � � � 5 � � � e P
By default, a database with the same name as the current user is created.
Connection options:
Options:
Read the description of the SQL command CLUSTER for details.
Read the description of the SQL command REINDEX for details.
Read the description of the SQL command VACUUM for details.
Report bugs to <pgsql-bugs@postgresql.org>.
--analyze-in-stages only update optimizer statistics, in multiple
stages for faster results; no vacuum
--lc-collate=LOCALE LC_COLLATE setting for the database
--lc-ctype=LOCALE LC_CTYPE setting for the database
%s [OPTION]...
%s [OPTION]... DBNAME
%s [OPTION]... LANGNAME [DBNAME]
%s [OPTION]... [DBNAME]
%s [OPTION]... [DBNAME] [DESCRIPTION]
%s [OPTION]... [ROLENAME]
--if-exists don't report error if database doesn't exist
--if-exists don't report error if user doesn't exist
--interactive prompt for missing role name and attributes rather
than using defaults
--maintenance-db=DBNAME alternate maintenance database
--maintenance-db=DBNAME alternate maintenance database
--no-replication role cannot initiate replication
--replication role can initiate replication
-?, --help show this help, then exit
-?, --help show this help, then exit
-?, --help show this help, then exit
-?, --help show this help, then exit
-D, --no-createdb role cannot create databases (default)
-D, --tablespace=TABLESPACE default tablespace for the database
-E, --encoding=ENCODING encoding for the database
-E, --encrypted encrypt stored password
-F, --freeze freeze row transaction information
-I, --no-inherit role does not inherit privileges
-L, --no-login role cannot login
-N, --unencrypted do not encrypt stored password
-O, --owner=OWNER database user to own the new database
-P, --pwprompt assign a password to new role
-R, --no-createrole role cannot create roles (default)
-S, --no-superuser role will not be superuser (default)
-S, --schema=SCHEMA reindex specific schema(s) only
-T, --template=TEMPLATE template database to copy
-U, --username=USERNAME user name to connect as
-U, --username=USERNAME user name to connect as
-U, --username=USERNAME user name to connect as (not the one to create)
-U, --username=USERNAME user name to connect as (not the one to drop)
-U, --username=USERNAME user name to connect as
-V, --version output version information, then exit
-V, --version output version information, then exit
-V, --version output version information, then exit
-V, --version output version information, then exit
-W, --password force password prompt
-W, --password force password prompt
-Z, --analyze-only only update optimizer statistics; no vacuum
-a, --all vacuum all databases
-a, --all cluster all databases
-a, --all reindex all databases
-c, --connection-limit=N connection limit for role (default: no limit)
-d, --createdb role can create new databases
-d, --dbname=DBNAME database to vacuum
-d, --dbname=DBNAME database from which to remove the language
-d, --dbname=DBNAME database to cluster
-d, --dbname=DBNAME database to install language in
-d, --dbname=DBNAME database to reindex
-d, --dbname=DBNAME database name
-e, --echo show the commands being sent to the server
-e, --echo show the commands being sent to the server
-e, --echo show the commands being sent to the server
-f, --full do full vacuuming
-g, --role=ROLE new role will be a member of this role
-h, --host=HOSTNAME database server host or socket directory
-h, --host=HOSTNAME database server host or socket directory
-h, --host=HOSTNAME database server host or socket directory
-i, --index=INDEX recreate specific index(es) only
-i, --inherit role inherits privileges of roles it is a
member of (default)
-i, --interactive prompt before deleting anything
-i, --interactive prompt before deleting anything, and prompt for
role name if not specified
-j, --jobs=NUM use this many concurrent connections to vacuum
-l, --list show a list of currently installed languages
-l, --locale=LOCALE locale settings for the database
-l, --login role can login (default)
-p, --port=PORT database server port
-p, --port=PORT database server port
-p, --port=PORT database server port
-q, --quiet don't write any messages
-q, --quiet don't write any messages
-q, --quiet run quietly
-r, --createrole role can create new roles
-s, --superuser role will be superuser
-s, --system reindex system catalogs
-t, --table='TABLE[(COLUMNS)]' vacuum specific table(s) only
-t, --table=TABLE cluster specific table(s) only
-t, --table=TABLE reindex specific table(s) only
-t, --timeout=SECS seconds to wait when attempting connection, 0 disables (default: %s)
-v, --verbose write a lot of output
-v, --verbose write a lot of output
-w, --no-password never prompt for password
-w, --no-password never prompt for password
-z, --analyze update optimizer statistics
%s (%s/%s) %s cleans and analyzes a PostgreSQL database.
%s clusters all previously clustered tables in a database.
%s creates a PostgreSQL database.
%s creates a new PostgreSQL role.
%s installs a procedural language into a PostgreSQL database.
%s issues a connection check to a PostgreSQL database.
%s reindexes a PostgreSQL database.
%s removes a PostgreSQL database.
%s removes a PostgreSQL role.
%s removes a procedural language from a database.
%s: "%s" is not a valid encoding name
%s: %s %s: cannot cluster all databases and a specific one at the same time
%s: cannot cluster specific table(s) in all databases
%s: cannot reindex all databases and a specific one at the same time
%s: cannot reindex all databases and system catalogs at the same time
%s: cannot reindex specific index(es) and system catalogs at the same time
%s: cannot reindex specific index(es) in all databases
%s: cannot reindex specific schema(s) and system catalogs at the same time
%s: cannot reindex specific schema(s) in all databases
%s: cannot reindex specific table(s) and system catalogs at the same time
%s: cannot reindex specific table(s) in all databases
%s: cannot use the "%s" option when performing only analyze
%s: cannot vacuum all databases and a specific one at the same time
%s: cannot vacuum specific table(s) in all databases
%s: clustering database "%s"
%s: clustering of database "%s" failed: %s %s: clustering of table "%s" in database "%s" failed: %s %s: comment creation failed (database was created): %s %s: could not connect to database %s: %s %s: could not connect to database %s: out of memory
%s: could not fetch default options
%s: creation of new role failed: %s %s: database creation failed: %s %s: database removal failed: %s %s: language "%s" is already installed in database "%s"
%s: language "%s" is not installed in database "%s"
%s: language installation failed: %s %s: language removal failed: %s %s: missing required argument database name
%s: missing required argument language name
%s: missing required argument role name
%s: number of parallel jobs must be at least 1
%s: only one of --locale and --lc-collate can be specified
%s: only one of --locale and --lc-ctype can be specified
%s: processing database "%s": %s
%s: query failed: %s %s: query returned %d row instead of one: %s
%s: query returned %d rows instead of one: %s
%s: query was: %s
%s: reindexing database "%s"
%s: reindexing of database "%s" failed: %s %s: reindexing of index "%s" in database "%s" failed: %s %s: reindexing of schema "%s" in database "%s" failed: %s %s: reindexing of system catalogs failed: %s %s: reindexing of table "%s" in database "%s" failed: %s %s: removal of role "%s" failed: %s %s: too many command-line arguments (first is "%s")
%s: too many parallel jobs requested (maximum: %d)
%s: vacuuming database "%s"
%s: vacuuming of database "%s" failed: %s %s: vacuuming of table "%s" in database "%s" failed: %s (%lu row) (%lu rows) Are you sure? Cancel request sent
Cannot add cell to table content: total cell count of %d exceeded.
Cannot add header to table content: column count of %d exceeded.
Could not send cancel request: %s Database "%s" will be permanently removed.
Enter it again: Enter name of role to add: Enter name of role to drop: Enter password for new role: Generating default (full) optimizer statistics Generating medium optimizer statistics (10 targets) Generating minimal optimizer statistics (1 target) Interrupted
Name Password encryption failed.
Password: Passwords didn't match.
Please answer "%s" or "%s".
Procedural Languages Role "%s" will be permanently removed.
Shall the new role be a superuser? Shall the new role be allowed to create databases? Shall the new role be allowed to create more new roles? Trusted? Try "%s --help" for more information.
Usage:
accepting connections
cannot duplicate null pointer (internal error)
could not look up effective user ID %ld: %s invalid output format (internal error): %d n no no attempt
no response
out of memory
rejecting connections
unknown
user does not exist user name lookup failure: error code %lu y yes Project-Id-Version: pgscripts-tr
Report-Msgid-Bugs-To: pgsql-bugs@postgresql.org
POT-Creation-Date: 2019-04-11 19:22+0000
PO-Revision-Date: 2019-04-12 15:44+0300
Last-Translator: Abdullah G. GÜLNER
Language-Team: Turkish <ceviri@postgresql.org.tr>
Language: tr
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
X-Generator: Poedit 1.8.7.1
Plural-Forms: nplurals=2; plural=(n != 1);
X-Poedit-Basepath: /home/ntufar/pg/pgsql/src/bin/scripts
X-Poedit-SearchPath-0: /home/ntufar/pg/pgsql/src/bin/scripts
Öntanımlı olarak , mevcut kullanıcı ile aynı adda veritabanı yaratılır.
Bağlantı seçenekleri:
Seçenekler:
Ayrıntılar için bir SQL komutu olan CLUSTER'in açıklamasını okuyabilirsiniz.
Ayrıntılar için bir REINDEX SQL komutunun açıklamasını okuyabilirsiniz.
Ayrıntılar için, bir SQL komutu olan VACUUM'un tanımlarını okuyun.
Hataları <pgsql-bugs@postgresql.org> adresine bildirebilirsiniz.
--analyze-in-stages daha hızlı sonuç için aşamalı olarak, sadece optimizer
istatistiklerini güncelle; vakum işlemi yok
--lc-collate=LOCALE Veritabanı için LC_COLLATE ayarı
--lc-ctype=LOCALE Veritabanı için LC_CTYPE ayarı
%s [SEÇENEK]...
%s [SEÇENEK]... VERİTABANI_ADI
%s [SEÇENEK]... DİL_ADI [VERİTABANI_ADI]
%s [SEÇENEK]... [VERİTABANI_ADI]
%s [SEÇENEK]... [VERİTABANI_ADI] [TANIM]
%s [SEÇENEKLER]... [ROL_ADI]
--if-exists veritabanı mevcut değilse hata mesajı verme
--if-exists kullanıcı mevcut değilse hata mesajı verme
--interactive varsayılanları kullanmaktansa eksik rol ve niteliklerin
girilmesini sağla
--maintenance-db=VTADI alternatif bakım veritabanı
--maintenance-db=VTADI alternatif bakım veritabanı
--no-replication rol replikasyon başlatamaz
--replication rol replikasyon başlatabilir
-?, --help bu yardımı göster, sonra çık
-?, --help bu yardımı göster, sonra çık
-?, --help bu yardımı gösterir ve sonra çıkar
-?, --help bu yardımı göster, sonra çık
-D, --no-createdb rol veritabanı oluşturamaz (varsayılan)
-D, --tablespace=TABLESPACE veritabanı için öntanımlı tablo uzayı
-E, --encoding=ENCODING veritabanı için dil kodlaması
-E, --encrypted saklanan şifreleri encrypt eder
-F, --freeze Dondurulan satır transaction bilgisi
-I, --no-inherit rol, hiçbir yetkiyi miras almaz
-L, --no-login role giriş yapamaz
-N, --unencrypted saklanmış şifreyi kriptolamaz
-O, --owner=OWNER Yeni veritabanının sahibi olacak veritabanı kullanıcısı
-P, --pwprompt yeni role bir şifre atar
-R, --no-createrole rol başka bir rol oluşturamaz (varsayılan)
-S, --no-superuser rol, superuser olmayacaktır (varsayılan)
-S, --schema=ŞEMA sadece belirtilen şema veya şemaları tekrar indeksle
-T, --template=TEMPLATE kopyalanacak şablon veritabanı
-U, --username=KULLANICI_ADI bağlanılacak kullanıcı adı
-U, --username=KULLANICI_ADI bağlanılacak kullanıcı adı
-U, --username=KULLANICI_ADI bağlanılacak kullanıcı adı (yaratılacak değil)
-U, --username=KULLANICI _ADI bağlanırken kullanılacak kullanıcı adı (silinecek olan değil)
-U, --username=KULLANICI_ADI bağlanılacak kullanıcı adı
-V, --version sürüm bilgisini göster, sonra çık
-V, --version sürüm bilgisini göster, sonra çık
-V, --version sürüm bilgisini gösterir ve sonra çıkar
-V, --version sürüm bilgisini göster, sonra çık
-W, --password parola sormasını sağla
-W, --password parola sorulmasını sağla
-Z, --analyze-only sadece optimizer bilgilerini güncelle; vakum işlemi yok
-a, --all tüm veritabanlarını vakumlar
-a, --all tüm veritabanlarını cluster eder
-a, --all tüm veritabanlarını yeniden indeksle
-c, --connection-limit=N rol için azami bağlantı sayısı (varsayılan: sınırsız)
-d, --createdb rol yeni veritabanı oluşturabiliyor
-d, --dbname=VERİTABANI_ADI vakumlanacak veritabanı
-d, --dbname=VERİTABANI_ADI dilin sileneceği veritabanının adı
-d, --dbname=VERİTABANI_ADI cluster edilecek veritabanı adı
-d, --dbname=VERİTABANI_ADI dilin kurulacağı veritabanının adı
-d, --dbname=VERİTABANI_ADI yeniden indexlenecek veritabanı adı
-d, --dbname=VERİTABANI_ADI veritabanı adı
-e, --echo sunucuya gönderilen komutları yaz
-e, --echo sunucuya gönderilen komutları göster
-e, --echo sunucuya gönderilen komutları göster
-f, --full tam (FULL) vakumlama yap
-g, --role=ROL yeni rol bu rolün üyesi olacaktır
-h, --host=HOSTNAME veritabanı sunucusu adresi ya da soket dizini
-h, --host=HOSTNAME veritabanı sunucusu adresi ya da soket dizini
-h, --host=HOSTNAME veritabanı sunucusu adresi ya da soket dizini
-i, --index=INDEX sadece belirli indeks(ler)i yeniden oluştur
-i, --inherit rol, üye olduğu rollerin (default) yetkilerini miras alır
-i, --interactive herhangi birşeyi silmeden önce uyarı verir
-i, --interactive herhangi birşeyi silmeden önce uyarı ver, ve
belirtilmemişse rol adının girilmesini iste
-j, --jobs=SAYI vakum için bu sayı kadar eşzamanlı bağlantı kullan
-l, --list Şu anda kurulu olan dilleri göster
-l, --locale=LOCALE veritabanı için yerel ayarları
-l, --login rol giriş yapabiliyor
-p, --port=PORT veritabanı sunucu portu
-p, --port=PORT veritabanı sunucusunun portu
-p, --port=PORT veritabanı sunucusunun portu
-q, --quiet hiçbir mesaj yazma
-q, --quiet hiçbir ileti yazma
-q, --quiet hiçbir ileti yazma
-r, --createrole rol yeni rol oluşturabiliyor
-s, --superuser rol, superuser olacaktır
-s, --system sistem kataloğunu yeniden indeksle
-t, --table='TABLO[(KOLONLAR)]' sadece belirli bir tabloyu / tabloları vakumlar
-t, --table=TABLO_ADI sadece belirli (bir) tabloyu/tabloları cluster eder
-t, --table=TABLO_ADI sadece belirli bir tablonun veya tabloların indekslerini yeniden oluştur
-t, --timeout=SANİYE bağlantı denenirken beklenecek saniye, 0 devre dışı bırakır (varsayılan: %s)
-v, --verbose bolca çıktı yaz
-v, --verbose çok miktarda çıktı yaz
-w, --no-password asla parola sorma
-w, --no-password parola sorma
-z, --analyze optimizer istatistiklerini güncelle
%s (%s/%s) %s bir PostgreSQL veritabanını temizler ve analiz eder.
%s Konutu bir veritabanında daha önceden cluster edilmiş tüm tabloları cluster eder.
%s bir PostgreSQL veritabanı yaratır.
%s yeni bir PostgreSQL rol oluşturur.
%s Bir PostgreSQL veritabanına yordamsal bir dil kurar.
%s bir PostgreSQL veritabanına bağlantı kontrolü sağlar.
%s PostgreSQL veritabanını yeniden indeksler.
%s PostgreSQL veritabanını siler.
%s bir PostgreSQL rolünü siler.
%s veritabanından yordamsal bir dili siler.
%s: "%s" geçerli bir dil kodlaması değil
%s: %s %s: Aynı anda tüm veritabanları ve de belirli bir tanesi cluster edilemez
%s: tüm veritabanlarındaki belirli tablo(lar) cluster edilemez
%s: aynı anda hem tüm veritabanları hem belirli bir veritabanı reindex edilemez
%s: aynı anda hem tüm veritabanları hem de sistem kataloğu reindex edilemez
%s: aynı anda hem belirli indeks(ler) hem de sistem katalogları tekrar indekslenemez
%s: tüm veritabanlarındaki belirli indeks(ler) tekrar indekslenemez
%s: aynı anda hem belirli şema(lar) hem de sistem kataloğu tekrar indekslenemez
%s: tüm veritabanlarındaki belirli şema(lar) tekrar indekslenemez
%s: aynı anda hem belirli tablo(lar) hem de sistem katalogları tekrar indekslenemez
%s: tüm veritabanlarındaki belirli tablo(lar) tekrar indekslenemez
%s: sadece analyze işlemi yapılırken "%s" seçeneği kullanılamaz
%s:Aynı anda tüm veritabanları ve de belirli bir tanesi vakumlanamaz
%s: tüm veritabanlarındaki belirli bir tablo/tablolar vakumlanamaz.
%s: "%s" veritabanı cluster ediliyor
%s: "%s" veritabanının cluster işlemi başarısız oldu: %s %s: "%s"tablosunun ("%s" veritabanındaki) cluster işlemi başarısız oldu: %s %s: yorum yaratma işlemi başarısız oldu (veritabanı yaratıldı): %s %s: %s veritabanına bağlanılamadı: %s %s: %s veritabanına bağlanılamadı: bellek yetersiz
%s: varsayılan seçenekler getirilemedi
%s: yeni rol oluşturma işlemi başarısız oldu: %s %s: veritabanı yaratma başarısız oldu: %s %s: veritabanı silme işlemi başarısız oldu: %s %s: "%s" dili daha önceden veritabanına yüklenmiştir "%s"
%s: "%s" dili "%s" veritabanında kurulu değil
%s: Dil kurulumu başarısız oldu: %s %s: dil silme işlemi başarısız oldu: %s %s: Gerekli argüman eksik: Veritabanı adı
%s: Gerekli bir argüman olan dil adı eksik
%s: Gerekli bir argüman olan rol adı eksik
%s: paralel iş sayısı en azından 1 olmalı
%s: --locale ve --lc-collate parametrelerinden sadece birisi belirtilebilir
%s: --locale ve --lc-ctype seçeneklerinden sadece birisi belirtilebilir
%s: "%s" veritabanı üzerinde işlem yapılıyor: %s
%s: sorgu başarısız oldu: %s %s: sorgu bir yerine %d satır döndürdü: %s
%s: sorgu bir yerine %d satır döndürdü: %s
%s: sorgu şu idi: %s
%s: "%s" veritabanı yeniden indeksleniyor
%s: "%s" veritabanının yeniden indekslenmesi başarısız oldu: %s %1$s: "%3$s" veritabanındaki "%2$s" indeksinin yeniden oluşturulması başarısız: %4$s %1$s: "%3$s" veritabanındaki "%2$s" şemasının tekrar indeksleme işlemi başarısız: %4$s %s: sistem kataloğların yeniden indekslemesi başarısız: %s %1$s: "%3$s" veritabanındaki "%2$s" tablosunun reindex işlemi başarısız: %4$s %s: "%s" rolün silinmesi başarısız oldu: %s %s: Çok sayıda komut satırı argümanı (ilki "%s")
%s: çok fazla paralel iş talep edildi (azami: %d)
%s: "%s" veritabanı vakumlanıyor
%s: "%s" veritabanının vakumlanması başarısız oldu: %s %s: "%s" tablosunun ("%s" veritabanındaki) vakumlama işlemi başarısız oldu: %s (%lu satır) (%lu satır) Emin misiniz? İptal isteği gönderildi
Hücre tablo içeriğine eklenemedi: %d olan toplan hücre sayısı açıldı.
B aşlık tablo içeriğine eklenemedi: %d kolon sayısı aşıldı.
İptal isteği gönderilemedi: %s "%s" veritabanı kalıcı olarak silinecektir.
Yeniden girin: Eklenecek rol adını girin: Silinecek rolün adını giriniz: Yeni rol için şifre girin: Varsayılan (tam) optimizer istatistikleri oluşturuluyor Orta ölçekte optimizer istatistikleri oluşturuluyor (10 hedef) Minimal optimizer istatistikleri oluşturuluyor (1 hedef) kesildi
Adı Parola şifreleme hatası.
Şifre: Şifreler uyuşmadı.
Lütfen yanıtlayınız: "%s" veya "%s".
Yordamsal Diller "%s" rolü kalıcı olarak silinecektir.
Yeni rol superuser olsun mu? Yeni rol, veritabanı oluşturabilsin mi? Yeni rol, yeni rolleri oluşturma hakkına sahip olsun mu? Güvenilir mi? Daha fazla bilgi için "%s --help" komutunu deneyiniz.
Kullanımı:
bağlantılar kabul ediliyor
null pointer duplicate edilemiyor (iç hata)
geçerli kullanıcı ID si bulunamadı %ld: %s geçersiz çıktı biçimi (iç hata): %d h hayır herhangi bir deneme yok
cevap yok
bellek yetersiz
bağlantılar reddediliyor
bilinmeyen
kullanıcı mevcut değil kullanıcı adı arama başarısız: hata kodu %lu e evet locale/tr/LC_MESSAGES/pg_ctl-9.6.mo 0000644 00000044337 14751153420 0012351 0 ustar 00 �� � � � < P D Q ? � � � &
0
P
- o
�
�
= �
! � A � a � K P � A � ! � 3 ? O H � D � C E a ? � ? � > ' 9 f L � B � E 0 � v 0 � F , > s 8 � I � % 5 2 [ O � 7 � & M 8 - � ! � > � E C [ y � 9 D S C � D � > ! A ` ( � , � 2 � 6 + > b * � / � % � 1 " 0 T # � � 4 � 2 � 1 / 0 a , � . � 3 � " + B 1 n 6 � : � 1 * D " o 7 � " � $ � J ] y 3 � 0 � � ! $ 6 [ - | � 4 � % � $ %! " J! ! m! F �! u �! F L" �" 7 �" ) �" k # ` u# % �# & �# #$ d +$ �$ / �$ & �$ 0 % . 7% ) f% ) �% �% �% & �%
& , +& ( X& �& ! �& �& �& �& �& ' "' 8' I' Y' j' z' " �' �' y �' @ N) X �) ) �) * 2 '* 6 Z* 8 �* < �* + + H 0+ * y+ ( �+ � �+ ' n, Y �, Z �, " K- F n- ! �- A �- : . D T. J �. M �. Q 2/ F �/ 5 �/ N 0 2 P0 [ �0 d �0 G D1 � �1 2 :2 O m2 K �2 3 3 K =3 . �3 5 �3 h �3 E W4 �4 �4 �4 k �4 0 95 " j5 < �5 U �5 T 6 � u6 K
7 Y Y7 T �7 P 8 G Y8 N �8 $ �8 ' 9 A =9 5 9 8 �9 + �9 9 : ' T: 4 |: - �: $ �: ; 1 "; < T; ? �; ; �; 4
< 5 B< ; x< �< + �< 1 = 5 3= 9 i= A �= . �= > 6 3> ( j> & �> S �> ? /? 1 J? 7 |? �? $ �? , �? " @ @ A@ �@ 7 �@ �@ �@ A ! :A b \A i �A X )B �B A �B , �B ~ C z �C & D ? ,D
lD m zD $ �D -
E : ;E ; vE = �E 9 �E 9 *F " dF �F 3 �F ' �F ! �F # G ' ;G cG �G �G �G �G �G H H <H RH eH xH " �H # �H ? L y ' { � V r � & $ o @ � � P b [ - C U � " ( _ . � ; X Y ! 6 � A B = / w � % 7 E K
v
J q c M , ~ # 3 ) 0 W � F s � ] 1 ` u } � � � h � f x m t d : z j � * g S O 9 Q D < G I 4 > 2 5 N Z � | l ^ p i + a H R n 8 � e � � T \ k
%s: -w option cannot use a relative socket directory specification
%s: -w option is not supported when starting a pre-9.1 server
Allowed signal names for kill:
Common options:
Options for register and unregister:
Options for start or restart:
Options for stop or restart:
Report bugs to <pgsql-bugs@postgresql.org>.
Shutdown modes are:
Start types are:
%s init[db] [-D DATADIR] [-s] [-o "OPTIONS"]
%s kill SIGNALNAME PID
%s promote [-D DATADIR] [-s]
%s register [-N SERVICENAME] [-U USERNAME] [-P PASSWORD] [-D DATADIR]
[-S START-TYPE] [-w] [-t SECS] [-o "OPTIONS"]
%s reload [-D DATADIR] [-s]
%s restart [-w] [-t SECS] [-D DATADIR] [-s] [-m SHUTDOWN-MODE]
[-o "OPTIONS"]
%s start [-w] [-t SECS] [-D DATADIR] [-s] [-l FILENAME] [-o "OPTIONS"]
%s status [-D DATADIR]
%s stop [-W] [-t SECS] [-D DATADIR] [-s] [-m SHUTDOWN-MODE]
%s unregister [-N SERVICENAME]
-?, --help show this help, then exit
-D, --pgdata=DATADIR location of the database storage area
-N SERVICENAME service name with which to register PostgreSQL server
-P PASSWORD password of account to register PostgreSQL server
-S START-TYPE service start type to register PostgreSQL server
-U USERNAME user name of account to register PostgreSQL server
-V, --version output version information, then exit
-W do not wait until operation completes
-c, --core-files allow postgres to produce core files
-c, --core-files not applicable on this platform
-e SOURCE event source for logging when running as a service
-l, --log=FILENAME write (or append) server log to FILENAME
-m, --mode=MODE MODE can be "smart", "fast", or "immediate"
-o OPTIONS command line options to pass to postgres
(PostgreSQL server executable) or initdb
-p PATH-TO-POSTGRES normally not necessary
-s, --silent only print errors, no informational messages
-t, --timeout=SECS seconds to wait when using -w option
-w wait until operation completes
auto start service automatically during system startup (default)
demand start service on demand
fast quit directly, with proper shutdown
immediate quit without complete shutdown; will lead to recovery on restart
smart quit after all clients have disconnected
done
failed
stopped waiting
%s is a utility to initialize, start, stop, or control a PostgreSQL server.
%s: -S option not supported on this platform
%s: PID file "%s" does not exist
%s: WARNING: cannot create restricted tokens on this platform
%s: WARNING: could not locate all job object functions in system API
%s: another server might be running; trying to start server anyway
%s: cannot be run as root
Please log in (using, e.g., "su") as the (unprivileged) user that will
own the server process.
%s: cannot promote server; server is not in standby mode
%s: cannot promote server; single-user server is running (PID: %ld)
%s: cannot reload server; single-user server is running (PID: %ld)
%s: cannot restart server; single-user server is running (PID: %ld)
%s: cannot set core file size limit; disallowed by hard limit
%s: cannot stop server; single-user server is running (PID: %ld)
%s: could not access directory "%s": %s
%s: could not allocate SIDs: error code %lu
%s: could not create promote signal file "%s": %s
%s: could not create restricted token: error code %lu
%s: could not determine the data directory using command "%s"
%s: could not find own program executable
%s: could not find postgres program executable
%s: could not open PID file "%s": %s
%s: could not open process token: error code %lu
%s: could not open service "%s": error code %lu
%s: could not open service manager
%s: could not read file "%s"
%s: could not register service "%s": error code %lu
%s: could not remove promote signal file "%s": %s
%s: could not send promote signal (PID: %ld): %s
%s: could not send reload signal (PID: %ld): %s
%s: could not send signal %d (PID: %ld): %s
%s: could not send stop signal (PID: %ld): %s
%s: could not start server
Examine the log output.
%s: could not start server: %s
%s: could not start server: error code %lu
%s: could not start service "%s": error code %lu
%s: could not unregister service "%s": error code %lu
%s: could not wait for server because of misconfiguration
%s: could not write promote signal file "%s": %s
%s: database system initialization failed
%s: directory "%s" does not exist
%s: directory "%s" is not a database cluster directory
%s: invalid data in PID file "%s"
%s: missing arguments for kill mode
%s: no database directory specified and environment variable PGDATA unset
%s: no operation specified
%s: no server running
%s: old server process (PID: %ld) seems to be gone
%s: option file "%s" must have exactly one line
%s: server does not shut down
%s: server is running (PID: %ld)
%s: service "%s" already registered
%s: service "%s" not registered
%s: single-user server is running (PID: %ld)
%s: the PID file "%s" is empty
%s: too many command-line arguments (first is "%s")
%s: unrecognized operation mode "%s"
%s: unrecognized shutdown mode "%s"
%s: unrecognized signal name "%s"
%s: unrecognized start type "%s"
(The default is to wait for shutdown, but not for start or restart.)
HINT: The "-m fast" option immediately disconnects sessions rather than
waiting for session-initiated disconnection.
If the -D option is omitted, the environment variable PGDATA is used.
Is server running?
Please terminate the single-user server and try again.
Server started and accepting connections
The program "%s" is needed by %s but was not found in the
same directory as "%s".
Check your installation.
The program "%s" was found by "%s"
but was not the same version as %s.
Check your installation.
Timed out waiting for server startup
Try "%s --help" for more information.
Usage:
WARNING: online backup mode is active
Shutdown will not complete until pg_stop_backup() is called.
Waiting for server startup...
cannot duplicate null pointer (internal error)
child process exited with exit code %d child process exited with unrecognized status %d child process was terminated by exception 0x%X child process was terminated by signal %d child process was terminated by signal %s command not executable command not found could not change directory to "%s": %s could not find a "%s" to execute could not get current working directory: %s
could not identify current directory: %s could not read binary "%s" could not read symbolic link "%s" invalid binary "%s" out of memory
pclose failed: %s server is still starting up
server promoting
server shutting down
server signaled
server started
server starting
server stopped
starting server anyway
waiting for server to shut down... waiting for server to start... Project-Id-Version: pg_ctl-tr
Report-Msgid-Bugs-To: pgsql-bugs@postgresql.org
POT-Creation-Date: 2018-04-20 21:53+0000
PO-Revision-Date: 2018-04-30 16:22+0300
Last-Translator: Abdullah G. Gülner
Language-Team: Turkish <ceviri@postgresql.org.tr>
Language: tr
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
X-Generator: Poedit 1.8.7.1
%s: -w seçeneği bir göreceli dizin tanımlaması kullanamaz
%s: -w 9.1 sürümü öncesi bir sunucu başlatırlırken -w seçeneği desteklenmiyor
kill için izin verilen sinyal adları:
Ortak seçenekler:
Kaydetmek ya da kaydı silmek için seçenekler:
Başlamak ya da yeniden başlamak için seçenekler:
Başlatmak ya da yeniden başlatmak için seçenekler:
Hataları <pgsql-bugs@postgresql.org> adresine bildiriniz.
Kapatma modları:
Başlama tipleri:
%s init[db] [-D VERİ_DİZİNİ] [-s] [-o "SEÇENEKLER"]
%s kill SİNYAL_ADI SÜREÇ_NUMARASI
%s promote [-D VERİ_DİZİNİ] [-s]
%s register [-N Servis_adı] [-U Kullanıcı_Adı] [-P Parola] [-D Veri_dizini]
[-S Başlatma_Tipi] [-w] [-t Saniye] [-o "Seçenekler"]
%s reload [-D VERİ_DİZİNİ] [-s]
%s restart [-w] [-t saniye] [-D veri dizini] [-s] [-m kapatma modu] [-o "seçenekler"]
%s start [-w] [-t saniye] [-D VERİ_DİZİNİ] [-s] [-l DOSYA_ADI] [-o "SEÇENEKLER"]
%s status [-D VERİ_DİZİNİ]
%s stop [-W] [-t saniye] [-D veri dizini] [-s] [-m kapatma modu]
%s unregister [-N SERVİS_ADI]
-?, --help bu yardımı gösterir ve sonra çıkar
-D, --pgdata=VERİDİZİNİ verinin tutulacağı alan
-N SERVICENAME PostgreSQL sunucusunu kaydedeceğiniz servis adı
-P PASSWORD PostgreSQL sunucusunu kaydetmek için hesabın şifresi
-S START-TYPE PostgreSQL sunucusunu kaydetmek için servis başlama tipi
-U USERNAME PostgreSQL sunucusunu kaydetmek için gerekli kullanıcı adı
-V, --version sürüm bilgisini gösterir ve sonra çıkar
-W işlem bitene kadar bekleme
-c, --core-files postgres'in core dosyaları oluşturmasına izin ver
-c, --core-files bu platformda uygulanmaz
-e SOURCE servis olarak çalışırken loglama için olay (event) kaynağı
-l, --log=DOSYA_ADI sunucu loglarını DOSYA_ADI dosyasına yaz (ya da dosyanın sonuna ekle)
-m, --mode=MOD MOD "smart", "fast", veya "immediate" olabilir
-o SEÇENEKLER postgres'e (PostgreSQL sunucusu çalıştırılabilir dosyası)
ya da initdb'ye geçilecek komut satırı seçenekleri
-p PATH-TO-POSTGRES normalde gerekli değildir
-s, --silent sadece hataları yazar, hiç bir bilgi mesajı yazmaz
-t, --timeout=SANİYE -w seçeneğini kullanırken beklenecek saniye
-w işlem bitene kadar bekle
auto sistem açılışında servisi otomatik başlat (varsayılan)
demand hizmeti talep üzerine başlat
fast düzgünce kapanmadan direk olarak dur
immediate tam bir kapanma gerçekleşmeden dur; yeniden başladığında kurtarma modunda açılır
smart tüm istemciler bağlantılarını kestikten sonra dur
tamam
başarısız oldu
bekleme durduruldu
%s bir PostgreSQL sunucusunu ilklendirmek, başlatmak, durdurmak ya da kontrol etmek için bir araçtır.
%s: -S seçeneği bu platformda desteklenmiyor.
%s: "%s" PID dosyası bulunamadı
%s: UYARI: bu platformda restricted token oluşturulamıyor
%s: UYARI: sistem API içinde tüm iş nesnesi fonksiyonlarının yeri belirlenemedi
%s: başka bir sunucu çalışıyor olabilir; yine de başlatmaya çalışılıyor.
%s: root olarak çalıştırılamaz
Lütfen (yani "su" kullanarak) sunucu sürecine sahip olacak (yetkisiz) kullanıcı
ile sisteme giriş yapınız.
%s: sunucu yükseltilemiyor (promote), sunucu yedek (standby) modda değil
%s: sunucu yükseltilemedi (promote), tek kullanıcılı sunucu çalışıyor (PID: %ld)
%s: sunucu yeniden yüklenemedi, tek kullanıcılı sunucu çalışıyor (PID: %ld)
%s: sunucu başlatılamadı; tek kullanıcılı sunucu çalışıyor (PID: %ld)
%s: core boyutu ayarlanamadı; hard limit tarafından sınırlanmış.
%s: sunucu durdurulamadı; tek kullanıcılı sunucu çalışıyor (PID: %ld)
%s: "%s" dizine erişim hatası: %s
%s: SIDler ayrılamadı: hata kodu %lu
%s: "%s" yükseltme (promote) sinyal dosyası yaratılamadı: %s
%s: restricted token oluşturulamadı: hata kodu %lu
%s: "%s" komutu kullanılarak veri dizini belirlenemedi
%s:Çalıştırılabilir dosya bulunamadı
%s: çalıştırılabilir postgres programı bulunamadı
%s: "%s" PID dosyası açılamadı: %s
%s: process token açma başarısız: hata kodu %lu
%s: "%s" servisi açılamadı: hata kodu %lu
%s: servis yöneticisi açılamadı
%s: "%s" dosyası okunamadı
%s: "%s" servisi kayıt edilemedi: hata kodu %lu
%s: "%s" yükseltme (promote) sinyal dosyası slinemedi: %s
%s: yükseltme (promote) sinyali gönderilemedi (PID: %ld): %s
%s: yeniden yükleme sinyali gönderilemedi (PID: %ld): %s
%s: %d reload sinyali gönderilemedi (PID: %ld): %s
%s:durdurma sinyali başarısız oldu (PID: %ld): %s
%s: sunucu başlatılamadı
Kayıt dosyasını inceleyiniz
%s: sunucu başlatılamadı: %s
%s: sunucu başlatılamadı: hata kodu %lu
%s: "%s" servisi başlatılamadı: hata kodu %lu
%s: "%s" servisinin kaydı silinemedi: hata kodu %lu
%s: yanlış yapılandırma nedeniyle sunucu beklenemedi
%s: "%s" yükseltme (promote) sinyal dosyasına yazılamadı: %s
%s: veritabanı ilklendirme başarısız oldu
%s: "%s" dizini mevcut değil
%s: "%s" dizini bir veritabanı kümesi dizini değil
%s: "%s" PID dosyasında geçersiz veri
%s: kill modu için eksik argümanlar
%s: Hiçbir veritabanı dizini belirtilmemiş ve PGDATA çevresel değişkeni boş
%s: hiçbir işlem belirtilmedi
%s: çalışan sunucu yok
%s: eski sunucu süreci (PID: %ld) kaybolmuştur
%s: "%s" seçenek dosyası sadece 1 satır olmalıdır
%s: sunucu kapanmıyor
%s: sunucu çalışıyor (PID: %ld)
%s: "%s" servisi daha önce kaydedilmiştir
%s: "%s" servisi kayıtlı değil
%s: sunucu, tek kullanıcı biçiminde çalışıyor (PID: %ld)
%s: "%s" PID dosyası boştur
%s: çok fazla komut satırı argümanı (ilki : "%s")
%s: geçersiz işlem modu "%s"
%s: geçersiz kapanma modu "%s"
%s: geçersiz sinyal adı "%s"
%s: geçersiz başlama tipi "%s"
(Ön tanımlı işlem kapanmak için beklemektir; başlamak ya da yeniden başlamak değildir.)
İPUCU: "-m fast" seçeneği oturumların kendilerinin bitmesini beklemektense
oturumları aniden keser.
Eğer -D seçeneği gözardı edilirse, PGDATA çevresel değişkeni kullanılacaktır.
sunucu çalışıyor mu?
Lütfen tek kullanıcılı sunucuyu durdurun ve yeniden deneyin.
Sunucu başladı ve bağlantı kabul ediyor
"%s" programına %s tarafından gereksinim duyuluyor, ancak
"%s" ile aynı dizinde bulunamadı.
Kurulumunuzu kontrol ediniz.
"%s" programı "%s" tarafından
bulundu ancak %s ile aynı sürüm numarasına sahip değil.
Kurulumunuzu kontrol ediniz.
Sunucu başlarken zaman aşımı oldu
Daha fazla bilgi için "%s --help" komutunu kullanabilirsiniz.
Kullanımı:
WARNING: çevrimiçi yedekleme modu etkin
pg_stop_backup() çalıştırılmadam sunucu kapatılmayacaktır.
Sunucunun başlaması bekleniyor...
null pointer duplicate edilemiyor (iç hata)
alt süreç %d çıkış koduyla sonuçlandırılmıştır alt süreç %d bilinmeyen durumu ile sonlandırılmıştır alt süreç 0x%X exception tarafından sonlandırılmıştır alt süreç %d sinyali tarafından sonlandırılmıştır alt süreç %s sinyali tarafından sonlandırılmıştır komut çalıştırılabilir değil komut bulunamadı çalışma dizini "%s" olarak değiştirilemedi: %s "%s" çalıştırmak için bulunamadı geçerli dizin belirlenemedi: %s
geçerli dizin tespit edilemedi: %s "%s" ikili (binary) dosyası okunamadı symbolic link "%s" okuma hatası geçersiz ikili (binary) "%s" bellek yetersiz
pclose başarısız oldu: %s sunucu hala başlıyor
sunucu yükseltiliyor (promote)
sunucu kapatılıyor
sunucuya sinyal gönderildi
sunucu başlatıldı
sunucu başlıyor
sunucu durduruldu
sunucu yine de başlatılıyor
sunucunun kapanması bekleniyor... sunucunun başlaması bekleniyor... locale/tr/LC_MESSAGES/initdb-9.6.mo 0000644 00000056450 14751153420 0012351 0 ustar 00 �� � 4 � L
�
R �
: E - V g � ` � � M W W h � A � 5 J ? � 6 � P � C . : r Q � 5 � ] 5 4 � B � H G T > � 4 � 9 3 J ? ~ / � - � > y [ ( � # � , " - O 7 } ( � 6 � , ' B 5 j F � " � <
& G - n - � ! � 1 � ? & ^ / � = � ! � " 6 8 + o � 0 � ; � $ / D & t � $ � ~ � 1 ] < � � G � 3 2 8 f ( � J � � � � C ! - S! 8 �! ! �! , �! " J !" 0 l" 4 �" A �" @ # R U# K �# " �# ! $ � 9$ d �$ $% 5% � T% [ �% R 4& K �& % �& �& ' 0' ; H' ; �' � �' @ Q( ; �( �( u �) q U* f �* s .+ & �+ �+ ) �+ t �+ / p, �, & �, 0 �, . - ) 6- ) `- �- �- & �- # �- �- $ . ( D. + m. " �. �. " �. ! �. , / $ I/ * n/ % �/ ! �/ �/ �/ 0 0 J0 ^0 b0 q0 - �0 �0 & �0 % �0 1 3 <1 p1 �1 ( �1 � �1 Q l3 " �3 �3 �3 C 4 o J4 U �4 5 d 6 d v6 �6 F �7 4 28 I g8 �8 D �8 [ 9 ] p9 Q �9 K : 9 l: f �: F
; I T; > �; 3 �; C < N U< < �< 7 �< < = 5 V= 1 �= < �= � �= $ �> ( �> ' �> 5 ? > J? , �? 5 �? . �? 0 @ A L@ F �@ 1 �@ < A " DA 3 gA 4 �A # �A 4 �A R )B |B , �B G �B ; C % MC @ sC ) �C # �C A D L DD # �D . �D M �D 2E ' SE } {E 7 �E J 1F |F N �F A �F Q ,G 7 ~G [ �G � H �H �H < I / VI ; �I �I * �I
J N +J D zJ 6 �J K �J 6 BK ] yK N �K Q &L F xL � �L � WM �M # N � $N h �N _ 8O U �O / �O P 7 5P mP 6 �P = �P � Q @ �Q D �Q \ R � {S � T � �T s 1U A �U
�U C �U � 9V - �V �V : W ; =W = yW 9 �W 9 �W " +X NX 3 `X �X ' �X & �X # Y . 'Y # VY ' zY # �Y �Y ' �Y # Z ( 3Z \Z , }Z �Z �Z / �Z [ 6[ =[ N[ 9 k[ 3 �[ - �[ 3 \ 4 ;\ D p\ % �\ �\ 2 �\ � � 5 ( � ] � � J l 6 H X � � K z � � � r I � � { � N d R V o | ~ � � . y U } � m � ` G = * f / $ � > _ � # A � t C 8 Y 0 T , � % + v L 3 � 2 n � � h B j E ? 9 ) ! & � � � q � � D S Z g
e ; ' ^ " F x c � w P [ s � @ i �
1 - \ � u : k � 4 W Q 7 O � < M p a b �
If the data directory is not specified, the environment variable PGDATA
is used.
Less commonly used options:
Options:
Other options:
Report bugs to <pgsql-bugs@postgresql.org>.
Success. You can now start the database server using:
%s%s%spg_ctl%s -D %s%s%s -l logfile start
Sync to disk skipped.
The data directory might become corrupt if the operating system crashes.
WARNING: enabling "trust" authentication for local connections
You can change this by editing pg_hba.conf or using the option -A, or
--auth-local and --auth-host, the next time you run initdb.
--auth-host=METHOD default authentication method for local TCP/IP connections
--auth-local=METHOD default authentication method for local-socket connections
--lc-collate=, --lc-ctype=, --lc-messages=LOCALE
--lc-monetary=, --lc-numeric=, --lc-time=LOCALE
set default locale in the respective category for
new databases (default taken from environment)
--locale=LOCALE set default locale for new databases
--no-locale equivalent to --locale=C
--pwfile=FILE read password for the new superuser from file
%s [OPTION]... [DATADIR]
-?, --help show this help, then exit
-A, --auth=METHOD default authentication method for local connections
-E, --encoding=ENCODING set default encoding for new databases
-L DIRECTORY where to find the input files
-N, --nosync do not wait for changes to be written safely to disk
-S, --sync-only only sync data directory
-T, --text-search-config=CFG
default text search configuration
-U, --username=NAME database superuser name
-V, --version output version information, then exit
-W, --pwprompt prompt for a password for the new superuser
-X, --xlogdir=XLOGDIR location for the transaction log directory
-d, --debug generate lots of debugging output
-k, --data-checksums use data page checksums
-n, --noclean do not clean up after errors
-s, --show show internal settings
[-D, --pgdata=]DATADIR location for this database cluster
%s initializes a PostgreSQL database cluster.
%s: "%s" is not a valid server encoding name
%s: WARNING: cannot create restricted tokens on this platform
%s: cannot be run as root
Please log in (using, e.g., "su") as the (unprivileged) user that will
own the server process.
%s: could not access directory "%s": %s
%s: could not access file "%s": %s
%s: could not allocate SIDs: error code %lu
%s: could not change permissions of "%s": %s
%s: could not change permissions of directory "%s": %s
%s: could not create directory "%s": %s
%s: could not create restricted token: error code %lu
%s: could not create symbolic link "%s": %s
%s: could not execute command "%s": %s
%s: could not find suitable encoding for locale "%s"
%s: could not find suitable text search configuration for locale "%s"
%s: could not fsync file "%s": %s
%s: could not get exit code from subprocess: error code %lu
%s: could not open directory "%s": %s
%s: could not open file "%s" for reading: %s
%s: could not open file "%s" for writing: %s
%s: could not open file "%s": %s
%s: could not open process token: error code %lu
%s: could not re-execute with restricted token: error code %lu
%s: could not read directory "%s": %s
%s: could not read password from file "%s": %s
%s: could not start process for command "%s": error code %lu
%s: could not stat file "%s": %s
%s: could not write file "%s": %s
%s: data directory "%s" not removed at user's request
%s: directory "%s" exists but is not empty
%s: encoding mismatch
%s: failed to remove contents of data directory
%s: failed to remove contents of transaction log directory
%s: failed to remove data directory
%s: failed to remove transaction log directory
%s: failed to restore old locale "%s"
%s: file "%s" does not exist
%s: file "%s" is not a regular file
%s: input file "%s" does not belong to PostgreSQL %s
Check your installation or specify the correct path using the option -L.
%s: input file location must be an absolute path
%s: invalid authentication method "%s" for "%s" connections
%s: invalid locale name "%s"
%s: invalid locale settings; check LANG and LC_* environment variables
%s: locale "%s" requires unsupported encoding "%s"
%s: locale name has non-ASCII characters, skipped: "%s"
%s: locale name too long, skipped: "%s"
%s: must specify a password for the superuser to enable %s authentication
%s: no data directory specified
You must identify the directory where the data for this database system
will reside. Do this with either the invocation option -D or the
environment variable PGDATA.
%s: out of memory
%s: password file "%s" is empty
%s: password prompt and password file cannot be specified together
%s: removing contents of data directory "%s"
%s: removing contents of transaction log directory "%s"
%s: removing data directory "%s"
%s: removing transaction log directory "%s"
%s: setlocale() failed
%s: superuser name "%s" is disallowed; role names cannot begin with "pg_"
%s: symlinks are not supported on this platform
%s: too many command-line arguments (first is "%s")
%s: transaction log directory "%s" not removed at user's request
%s: transaction log directory location must be an absolute path
%s: warning: specified text search configuration "%s" might not match locale "%s"
%s: warning: suitable text search configuration for locale "%s" is unknown
Data page checksums are disabled.
Data page checksums are enabled.
Encoding "%s" implied by locale is not allowed as a server-side encoding.
The default database encoding will be set to "%s" instead.
Encoding "%s" is not allowed as a server-side encoding.
Rerun %s with a different locale selection.
Enter it again: Enter new superuser password: If you want to create a new database system, either remove or empty
the directory "%s" or run %s
with an argument other than "%s".
If you want to store the transaction log there, either
remove or empty the directory "%s".
It contains a dot-prefixed/invisible file, perhaps due to it being a mount point.
It contains a lost+found directory, perhaps due to it being a mount point.
No usable system locales were found.
Passwords didn't match.
Rerun %s with the -E option.
Running in debug mode.
Running in noclean mode. Mistakes will not be cleaned up.
The database cluster will be initialized with locale "%s".
The database cluster will be initialized with locales
COLLATE: %s
CTYPE: %s
MESSAGES: %s
MONETARY: %s
NUMERIC: %s
TIME: %s
The default database encoding has accordingly been set to "%s".
The default text search configuration will be set to "%s".
The encoding you selected (%s) and the encoding that the
selected locale uses (%s) do not match. This would lead to
misbehavior in various character string processing functions.
Rerun %s and either do not specify an encoding explicitly,
or choose a matching combination.
The files belonging to this database system will be owned by user "%s".
This user must also own the server process.
The program "postgres" is needed by %s but was not found in the
same directory as "%s".
Check your installation.
The program "postgres" was found by "%s"
but was not the same version as %s.
Check your installation.
This might mean you have a corrupted installation or identified
the wrong directory with the invocation option -L.
Try "%s --help" for more information.
Usage:
Use the option "--debug" to see details.
Using a mount point directly as the data directory is not recommended.
Create a subdirectory under the mount point.
cannot duplicate null pointer (internal error)
caught signal
child process exited with exit code %d child process exited with unrecognized status %d child process was terminated by exception 0x%X child process was terminated by signal %d child process was terminated by signal %s command not executable command not found could not change directory to "%s": %s could not close directory "%s": %s
could not find a "%s" to execute could not get junction for "%s": %s
could not identify current directory: %s could not look up effective user ID %ld: %s could not open directory "%s": %s
could not read binary "%s" could not read directory "%s": %s
could not read symbolic link "%s" could not remove file or directory "%s": %s
could not set junction for "%s": %s
could not stat file or directory "%s": %s
could not write to child process: %s
creating configuration files ... creating directory %s ... creating subdirectories ... fixing permissions on existing directory %s ... invalid binary "%s" ok
out of memory
pclose failed: %s performing post-bootstrap initialization ... running bootstrap script ... selecting default max_connections ... selecting default shared_buffers ... selecting default timezone ... selecting dynamic shared memory implementation ... syncing data to disk ... user does not exist user name lookup failure: error code %lu Project-Id-Version: initdb-tr
Report-Msgid-Bugs-To: pgsql-bugs@postgresql.org
POT-Creation-Date: 2019-06-17 22:07+0000
PO-Revision-Date: 2019-06-18 10:05+0300
Last-Translator: Abdullah G. Gülner
Language-Team: Turkish <ceviri@postgresql.org.tr>
Language: tr
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
X-Generator: Poedit 1.8.7.1
X-Poedit-Basepath: ../postgresql-8.0.3/src
Eğer veri dizini belirtilmezse, PGDATA çevresel değişkeni kullanılacaktır
Daha az kullanılan seçenekler:
Seçenekler:
Diğer seçenekler:
Hataları <pgsql-bugs@postgresql.org> adresine bildirebilirsiniz.
İşlem başarılı. Veritabanı sunucusunu başlatmak için:
%s%s%spg_ctl%s -D %s%s%s -l logfile start
Diske senkronizasyon atlandı.
İşletim sistemi çökerse veri dizini bozulabilir.
UYARI: Yerel bağlantıları için "trust" yetkilendirmesi etkinleştiriliyor. Bunu,
pg_hba.conf dosyasını düzenleyerek ya da initdb'yi yeniden çalıştırdığınızda
-A parametresi ile veya --auth-local ve --auth-host ile değiştirebilirsiniz..
--auth-host=METHOD yerel TCP/IP bağlantıları için ön tanımlı yetkilendirme yöntemi
--auth-local=METHOD yerel soket bağlantıları için ön tanımlı yetkilendirme yöntemi
--lc-collate=, --lc-ctype=, --lc-messages=LOCALE
--lc-monetary=, --lc-numeric=, --lc-time=LOCALE
yeni veritabanları için ilgili kategorideki öntanımlı yerel bilgisini
çevrede değişkenlerinden al
--locale=LOCALE yeni veritabanı için öntanımlı yerel
--no-locale --locale=C'ye eşdeğer
--pwfile=DOSYA yeni superuser için parolayı dosyadan oku
%s [SEÇENEK]... [DATADIR]
-?, --help bu yardımı gösterir ve sonra çıkar
-A, --auth=METHOD yerel bağlantılar için ön tanımlı yetkilendirme yöntemi
-E, --encoding=ENCODING yeni veritabanları için öntanımlı dil kodlamasını ayarlar
-L DIRECTORY girdi dosyalarının nerede bulunacağını belirtir
-N, --no-sync değişikliklerin diske yazılmasını bekleme
-S, --sync-only sadece veri dizinini sync et
-T, --text-search-config=CFG
öntanımlı metin arama yapılandırması
-U, --username=NAME veritabanı superuser kullanıcısı adı
-V, --version sürüm bilgisini gösterir ve sonra çıkar
-W, --pwprompt yeni superuser için şifre sorar
-X, --xlogdir=XLOGDIR transaction log dizini
-d, --debug bol miktarda debug çıktısı üretir
-k, --data-checksums veri sayfası (data page) doğrulamasını kullan
-n, --noclean hatalardan sonra temizlik yapma
-s, --show dahili ayarları gösterir
[-D, --pgdata=]DATADIR bu veritabanı kümesi için yer
%sbir PostgreSQL Veritabanı kümesini ilklendirir.
%s: "%s" geçerli bir dil kodlaması adı değil
%s: UYARI: bu platformda restricted token oluşturulamıyor
%s: root olarak çalıştırılamaz.
(Örneğin "su" kullanarak ) sunucu sürecinin sahibi olacak şekilde sisteme yetkisiz bir kullanıcı olarak giriş yapın.
%s: "%s" dizine erişim hatası: %s
%s: "%s" dosyasına erişim hatası: %s
%s: SIDler ayrılamadı: hata kodu %lu
%s: "%s" nin erişim hakları değiştirilemiyor: %s
%s: "%s" dizininin erişim haklarını değiştirilemiyor: %s
%s: "%s" dizini oluşturma başarısız: %s
%s: restricted token oluşturulamadı: hata kodu %lu
%s: symbolic link "%s" oluşturma hatası: %s
%s: "%s" komutu yürütme başlatma hatası: %s
%s: "%s" yerel ayarları için uygun dil kodlaması bulunamadı.
%s: "%s" yereli için uygun metin arama yapılandırması bulunamadı
%s: "%s" dosyası fsync işlemi başarısız: %s
%s: alt-işlemden çıkış kodu alınamadı: hata kodu %lu
%s: "%s" dizini açılamadı: %s
%s: "%s" dosyası, okunmak için açılamadı: %s
%s: "%s" dosyası, yazılmak için açılamadı: %s
%s: "%s" dosyası açılamadı: %s
%s: process token açma başarısız: hata kodu %lu
%s: restricted token ile tekrar çalıştırılamadı (re-execute): hata kodu %lu
%s: "%s" dizini okunamadı: %s
%s: "%s" dosyasından şifre okunamadı: %s
%s: "%s" komutu için işlem (process) başlatılamadı: hata kodu %lu
%s: "%s" dosyasının durumu görüntülenemedi (stat): %s
%s: "%s" dosyasına yazılamadı: %s
%s: "%s" veri dizini kullanıcının isteği üzerine silinmedi
%s: "%s" dizini mevcut, ama boş değil
%s: dil kodlaması uyuşmazlığı
%s: veri dizininin içindekilerinin silme işlemini başarısız
%s: transaction log dizininin içindekilerinin silme işlemini başarısız
%s: veri dizini silme başarısız
%s: transaction log dizini silme başarısız
%s: "%s" eski yerel ayar (locale) dosyasının geri yüklenmesi başarısız
%s: "%s" dosyası mevcut değil
%s: "%s" düzgün bir dosya değildir.
%s: "%s" girdi dosyası PostgreSQL'e ait değil %s
Kurulumunuzu kontrol edin ya da -L seçeneği ile doğru dizini belirtin.
%s: girdi dosyasının yeri mutlak bir yol olmalıdır
%1$s: "%3$s"bağlantıları için geçersiz yetkilendirme yöntemi "%2$s"
%s: geçersiz yerel adı "%s"
%s: geçersiz yerel ayarlar; LANG ve LC_ * ortam değişkenlerini denetleyin.
%s: "%s" yereli desteklenmeyen "%s" dil kodlamasını gerektirir
%s: yerel ayar (locale) adı ASCII olmayan karakterler içeriyor, atlandı: "%s"
%s: yerel ayar (locale) adı çok uzun, atlandı: "%s"
%s: %s yetkilendirmesini etkinleştirmek için superuser'a şifre atamanız gerekmektedir.
%s: Hiçbir veri dizini belirtilmedi
Bu veritabanı sistemi için verinin hangi dizinde duracağını belirtmeniz gerekmektedir.
Bunu ya -D seçeneği ile ya da PGDATA çevresel değişkeni ile yapabilirsiniz.
%s: yetersiz bellek
%s: "%s" parola dosyası boş
%s: şifre promptu ve şifre dosyası birlikte belirtilemez
%s: veri dizininin içindekiler siliniyor "%s"
%s: transaction log dizininin içindekileri siliniyor "%s"
%s: veri dizini siliniyor "%s"
%s: transaction log dizini siliniyor "%s"
%s: setlocale() başarısız
%s: "%s" superuser adına izin verilmiyor; rol adları "pg_" ile başlayamaz
%s: bu platformda sembolik bağlantı (symlink) desteklenmemektedir
%s: Çok fazla komut satırı girdisi var (ilki "%s")
%s: "%s" transaction log dizini kullanıcının isteği üzerine silinmedi
%s: transaction log dizini mutlak bir yol olmalıdır
%s: uyarı: belirtilen metin arama yapılandırması "%s", "%s" yereli ile eşleşmeyebilir
%s: uyarı: "%s" yereli için uygun metin arama yapılandırması bilinmiyor.
Veri sayfası (data page) sağlama toplamları devre dışı bırakılmıştır.
Veri sayfası (data page) sağlama toplamları etkinleştirilmiştir.
"%s" dil kodlaması sunucu tarafında izin verilen bir dil kodlaması değildir
Bunun yerine, öntanımlı veritabanı dil kodlaması "%s" olacaktır.
"%s" dil kodlaması sunucu tarafında izin verilen bir dil kodlaması değildir
"%s"'i değişik bir yerel ayar (locale) ile tekrar çalıştırın.
Yeniden giriniz: Yeni superuser şifresini giriniz: Yeni bir veritabanı sistemi yaratmak istiyorsanız, ya "%s" dizinini
kaldırın, ya boşaltın ya da %s'i
"%s" argümanından başka bir argüman ile çalıştırın.
Eğer transaction kayıt dosyasını saklamak istiyorsanız,
"%s" dizinini kaldırın ya da boşaltın
noktayla başlayan/gizli dosya içeriyor, muhtemelen bu bir bağlanma noktası (mount point).
lost+found klasörü içeriyor, muhtemelen bu bir bağlanma noktası (mount point).
Kullanılabilir sistem yerelleri bulunamadı.
Şifreler uyuşmadı.
%s komutunu -E seçeneği ile yeniden çalıştırın.
Debug modunda çalışıyor.
noclean modunda çalışıyor. Hatalar silinmeyecek.
Veritabanı kümesi "%s" yerel ayarları ile oluşturulacak.
Veritabanı kümesi aşağıdaki yerellerle ilklendirilecek:
COLLATE: %s
CTYPE: %s
MESSAGES: %s
MONETARY: %s
NUMERIC: %s
TIME: %s
Öntanımlı veritabanı dil kodlaması "%s" olarak ayarlandı.
Öntanımlı metin arama yapılandırması "%s" olarak ayarlanacak.
Seçtiğiniz (%s) dil kodlaması ve seçilen yerelin kullandığı dil
kodlaması (%s) uyuşmamaktadır. Bu durum, çeşitli metin işleme
fonksiyonlarının yanlış çalışmasına neden olabilir. Bu durumu
düzeltebilmek için %s komutunu yeniden çalıştırın ve de ya kodlama
belirtmeyin ya da eşleştirilebilir bir kodlama seçin.
Bu veritabanı sistemine ait olan dosyaların sahibi "%s" kullanıcısı olacaktır.
Bu kullanıcı aynı zamanda sunucu sürecinin de sahibi olmalıdır.
"postgres" programına %s gereksinim duymaktadır, ancak bu program "%s"
ile aynı dizinde bulunamadı.
Kurulumunuzu kontrol ediniz.
"postgres" programı "%s" tarafından bulundu; ancak bu program %s
ile aynı sürüm numarasına sahip değil.
Kurulumunuzu kontrol ediniz.
Bu durum, bozulmus bir kurulumunuz olduğu ya da
-L parametresi ile yanlış dizin belirttiğiniz anlamına gelir.
Ayrıntılı bilgi için "%s --help" komutunu deneyebilirsiniz.
Kullanımı:
Ayrıntıları görmek için "--debug" seçeneğini kullanınız.
Bir bağlama noktasının doğrudan veri dizini olarak kullanılması önerilmez.
Bağlama noktası altında bir alt dizin oluşturun.
null pointer duplicate edilemiyor (iç hata)
sinyal yakalandı
alt süreç %d çıkış koduyla sonuçlandırılmıştır alt süreç %d bilinmeyen durumu ile sonlandırılmıştır alt süreç 0x%X exception tarafından sonlandırılmıştır alt süreç %d sinyali tarafından sonlandırılmıştır alt süreç %s sinyali tarafından sonlandırılmıştır komut çalıştırılabilir değil komut bulunamadı çalışma dizini "%s" olarak değiştirilemedi: %s "%s" dizini kapatılamadı: %s
"%s" çalıştırmak için bulunamadı "%s" için junction bulunamadıı: %s
geçerli dizin tespit edilemedi: %s geçerli kullanıcı ID si bulunamadı %ld: %s "%s" dizini açma başarısız: %s
"%s" ikili (binary) dosyası okunamadı "%s" dizini okuma başarısız: %s
symbolic link "%s" okuma hatası "%s" dizini kaldırma başarısız: %s
"%s" junction ayarlama hatası: %s
"%s" dosya ya da dizini bulunamadı: %s
çocuk sürece yazılamadı: %s
yapılandırma dosyaları yaratılıyor ... %s dizini yaratılıyor ... alt dizinler oluşturuluyor ... mevcut %s dizininin izinleri düzeltiliyor ... geçersiz ikili (binary) "%s" tamam
bellek yetersiz
pclose başarısız oldu: %s önyükleme sonrası başlatmayı gerçekleştiriyor ... önyükleme komut dosyası çalıştırılıyor ... ön tanımlı max_connections seçiliyor ... öntanımlı shared_buffers değeri seçiliyor ... ön tanımlı saat dilimi (timezone) seçiliyor ... dinamik paylaşılan bellek (shared memory) uygulaması seçimi ... veri diske yazılıyor (syncing) ... kullanıcı mevcut değil kullanıcı adı arama başarısız: hata kodu %lu locale/tr/LC_MESSAGES/psql-9.6.mo 0000644 00000276446 14751153420 0012070 0 ustar 00 �� ! � B X X 'X ;X � TX �X Y
1Y ?Y > PY = �Y < �Y p
Z s {Z 5 �Z 7 %[ K ][ o �[ 2 \ 4 L\ N �\ t �\ Q E] O �] > �] A &^ O h^ @ �^ 6 �^ 0 0_ N a_ G �_ 8 �_ A 1` T s` ? �` L a A Ua @ �a H �a A !b + cb � �b 5 %c 9 [c n �c Q d : Vd � �d ; e y Ze � �e ; pf z �f T 'g A |g L �g B h \ Nh 4 �h J �h \ +i 6 �i 4 �i G �i = <j ; zj ( �j ; �j ; k ; Wk ; �k 8 �k _ l J hl F �l ` �l h [m G �m 5 n 2 Bn X un Q �n : o 3 [o ; �o S �o M p 9 mp @ �p 8 �p ; !q @ ]q K �q J �q | 5r � �r > 8s F ws N �s F
t H Tt - �t $ �t & �t - u 9 Eu 7 u 2 �u 4 �u 3 v ) Sv ) }v ; �v B �v ) &w * Pw * {w J �w 1 �w . #x - Rx , �x 4 �x I �x $ ,y & Qy > xy 1 �y & �y ( z J 9z : �z ( �z % �z $ { $ 3{ ) X{ - �{ N �{ 9 �{ G 9| 5 �| M �| C } P I} K �} N �} K 5~ L �~ 4 �~ K ( O q x A � ? ,� A l� > �� � � # �� F �� 8 � < @� M }� ; ˃ 6 � 2 >� 7 q� B �� : � 4 '� 9 \� ? �� % օ + �� 9 (� 5 b� I �� K � M .� Z |� S ׇ K +� � w� N � @ Q� : �� ( ͉ B �� L 9� C �� M ʊ = � � V� � � (� +� >� B� V� f� 0 n� $ �� # Č * � % � * 9� d� # �� < �� � � � 6 :� q� � �� : ,� g� y� �� �� �� �� Տ � Q �� K� I _� [ ��
� � !�
6� A� _� C l� A �� � �� � � %� -� 4� , F� s� �� �� �� �� �� �� Ւ � �
� � $� 0� ' =� e� & �� ' �� 7 ғ 0
� ;� W� g� z� �� �� �� �� w �� .� ?� T� Z� t� ( �� �� ԕ ݕ �� � ,� A� Z� f� o� x� �� �� �� ��
�� ̖ Җ Ֆ ߖ
� � �� � � � &�
5� C�
U� c� & p� �� ��
��
�� ˗ җ � ��
� &� 9� M� `� r� �� �� �� Ș � �� � '� 9�
K� Y� i� % z� �� " �� י �� � 2� ' H� & p� �� �� �� Ě ˚ Ԛ ޚ
� � L �� J� Y� w� > �� ӛ � �� 2 � F� M� `� t� �� �� �� �� ˜ ќ � � X � v� � �� ��
ɝ ԝ � ' �� . � ! M� ' o� �� �� ��
Ş Ӟ � � #� C� c� r� �� , �� �� ͟ ٟ � � �� � *� E 1� w� �� �� �� ��
�� �� à Ƞ Ϡ ۠ � � � � !� -� 7� K�
Q� _� {�
�� �� �� �� ѡ � � ! � 3� K� 9 f� 9 �� F ڢ 5 !� B W� C �� 5 ޣ : � 9 O� @ �� ; ʤ K � B R� C �� 6 ٥ 8 � I� e� t�
�� �� �� ��
�� æ ߦ �� � 7� A� & I� p� �� �� �� � �� t� # �� # �� # Ԩ �� " � 2� I� Q� h� r� |�
�� �� �� ��
�� c �� � "� � K � Q L� / �� O Ϋ U � 5 t� = �� � , � 4 !� " V� ! y� �� �� ȭ � " �� + "� + N� 6 z� X �� 7
� 8 B� T {� 5 Я I � 6 P� # �� = �� = � = '� i e� 9 ϱ � $� * E� p� �� �� �� Ȳ ̲ ۲ � �� �� � � 3� # R� v� ��
�� �� �� �� ų
γ ܳ � � �� � � � C +� o� / �� ( �� ٴ � �� � � ' :� b� $ �� % �� ! ̵ ) � ( � / A� # q� ' �� , �� . � 4 � N� ! n� - �� �� % ߷ 4 � 1 :� - l� / �� " ʸ � '
� 5� . U� ) �� % �� ! Թ $ �� * � + F� A r� �� �� & ͺ 0 � . %� ) T� ) ~� �� % �� ݻ
�
� �� # � &� 3� E� W� c� o� v� ~� �� C �� �
� � *� B� R� b�
�� �� $ �� & �� - � # � :� 1 [� ( �� ) �� + � ' � ! 4� V� # q� ! �� ( �� � �� � 3� Q� p� v� �� �� ��
�� � �
� �� � � 6� V� h� � �� �� � � � � ! 8� Z� p� 2 �� �� �� �� � $� E� 2 _� 5 �� �� �� �� . � >� & V� # }� �� ! �� �� �� � !� :� 6 [� ) �� ��
�� �� �� �� ��
� & � @� P� Z� d� m� �� �� �� �� �� �� ��
�� �� U � \� m� s� �� �� �� �� ��
�� � � � %� +� 4� D� " V�
y� �� �� �� �� ��
�� 1 �� �
#� .� ?� . P� � . ��
�� �� �� �� �� ��
� � E "� h�
x� �� �� �� �� �� �� �� �� �� � * +� V� ^� j� y� �� �� �� ��
�� �� �� �� �� �� �� � � *� E� R� _� f� s� |� �� ��
�� �� �� �� �� % �� �� � � � � 1� A� U� d� s� |� ��
�� �� �� �� �� �� �� �� �� �� � � � $� 3� <� H� K� S� [� d� s�
�� �� ��
�� �� �� �� �� �� �� � � !� )� ;� G� Y� ! c� 4 ��
�� �� . �� � � � '� 7� H� R�
[�
i�
w� �� �� �� �� �� �� " �� � 2� P� b� }� �� / �� �� �� � � " %� H� h� �� �� �� * ��
�� �� � 0� M� e� y� �� �� �� 0 �� + � ,� 4� =� > E�
�� �� ) �� " �� �� ��
�
� � *� C� H� R� W� g� v� �� �� ��
�� ��
�� �� �� �� 7 �� 2 !� 6 T� V �� �� & �� & � . 6� e� q� ��
�� �� �� �� �� �� �� �� �� � � '� ! 1� S� [� m� z�
�� �� �� �� . �� �� �� �
� %� 5� G� S� _� h� m� w�
�� �� �� �� �� �� �� �� �� � #� '� $ F� # k� �� �� 0 �� �� �� �� �� � ( &� O� Y�
j� u� �� �� �� �� �� �� �� �� �� �� � '� $ C� h� ' }� �� �� �� �� � -� B� ! c� �� �� ��
�� �� �� 7 �� � � 8� � P� ! �� � <� T� A n� E �� E �� � <� � �� = R� ; �� L �� � � 6 �� < �� Y � � h� T �� X H� X �� I �� @ D� F �� B �� : � P J� T �� C �� E 4� ] z� > �� f � M ~� R �� ] � D }� 2 �� � �� E �� I � � _� ^ �� : A� � |� H 6� � � � � B �� � � Z �� O �� Q J� O �� u �� 3 b� M �� � �� G g� 9 �� I �� < 3� : p� ' �� < � : � A K� ; �� 0 � i �� Y d� K �� n
� z y� E � @ :� = {� m �� Y '� ? �� 2 �� F � e ;� V �� @ �� Q 9� G �� X � G ,� h t� R � � 0� � � A a� F �� ] � R H \ � 7 � * 0 + [ ; � D � < F E = � 3 � 1 � 0 0 ? a W � / � 0 ) 2 Z V � 7 � 5 4 R > � > � V * \ + � J � X � - W - � N � H / K , { ) � + � . � 8 - h f A � Z
; l
S �
b �
b _ [ � b Z � b � = ?
Q }
4 �
u P z > � X
Q c � � ( o X � = � B / n r N � 8 0 A i A � j � < X 5 � C � < ( L , u ? � @ � W # _ { m � b I Q � B � � A f � C S = � 8 � Q a ` F � R K \ � � ( G p � � � �
� � 7 � * ! 0 , R , / � ! � & � K % ! q � " � 1 � � � : � . K W f z � d � ! D ! W Z! �! �! �! �! % �!
" O ." E ~" �" �" �" �" �" # # 1 0# b# ~# �# �# �# �# �# & �# % $ ($ 5$
<$ G$ M$ . Y$ �$ �$ �$ 8 �$ : !% $ \% & �% , �% * �% &
& & & � 6& �& �& �& �& ' 1 )' [' l' �' �' % �' �' �' " ( &( 7( A( H( \( k( ( �( �( �( �( �( �( �( �(
�( ) ) ) % )) O)
a) l) x) 1 �) �) �) �) �) �) �) * ! (* J* & \* �* �* �* �* �* + " + % A+ g+ ( + �+ �+ �+ �+ �+ , $, D, + W, # �, * �, $ �, " �, 9 - 8 T- �- ; �- �- �- �- �- �- �- . a . }. �. �. M �. / $/ 7/ F N/ �/ �/ �/ �/ �/ �/ 0
0 $0 # +0 1 O0 �0 q �0 1 1 61 W1 q1 z1 �1 , �1 7 �1 , 2 / -2 ]2 % g2 �2 �2 �2 �2 �2 �2 '
3 53 E3 Z3 B f3 �3 �3 �3 �3 �3 % �3 * 4 A4 R J4 �4 �4 �4 �4 �4
�4 �4 �4 �4 �4 �4 5 5 65 C5
K5 Y5 c5 y5
5 �5 " �5
�5 �5
�5 �5 & 6 .6 " 66 % Y6 $ 6 ' �6 : �6 C 7 [ K7 Q �7 P �7 X J8 F �8 C �8 B .9 H q9 @ �9 Q �9 M M: W �: 8 �: H ,; u; �; �; �; �; �; �;
< , < / 8< + h< 0 �< �<
�< , �< & = % >= d= ! n= � �= �> " �> # �> , �> ? E ,? r?
�? & �? �? �? �? �? �? �? @ @ i !@ � �@ % �A _ �A c B 0 lB c �B j C B lC D �C �C 2 D * 9D 2 dD % �D �D �D �D - �D , -E * ZE - �E D �E W �E : PF 7 �F c �F 5 'G J ]G 2 �G ) �G C H E IH I �H m �H A GI �I ( �I ( �I �I J 9J OJ WJ `J oJ �J �J �J �J + �J 8 �J 9 K JK hK
zK �K �K �K �K �K �K L
L L 3L ;L EL G RL $ �L - �L 0 �L M 2M ;M UM + uM , �M % �M 4 �M ) )N SN % qN + �N + �N �N $ O H 5O ( ~O 7 �O �O �O + P EP ! eP 8 �P 2 �P : �P . .Q ]Q |Q - �Q �Q . �Q ' R 9R XR uR . �R * �R H �R 9S
?S : MS ; �S = �S 9 T 9 <T vT 3 �T �T �T �T �T ' �T U 0U EU TU
`U kU rU " yU �U H �U �U V .V 4V OV aV sV �V �V : �V 3 �V 1 W OW ' pW C �W # �W X . X % OX / uX ' �X " �X �X 5 Y GY eY 0 �Y 7 �Y �Y Z Z .Z OZ [Z eZ vZ �Z �Z �Z �Z �Z $ �Z [ + -[ Y[ q[ �[ # �[ �[ �[ " \ " *\ M\ f\ ? {\ ? �\ �\ ] /] P] l] > �] - �] �] ^ *^ ) >^ h^ + �^ % �^ - �^ " _ ) $_ N_ d_ v_ ( �_ C �_ ( ` )` 8` A` N` g` w` �` * �`
�` �` �` �` a ' a Ga ca oa % ua �a �a �a �a p �a ?b Pb Ub " eb " �b �b �b �b �b �b �b �b c
c c *c ' Ac ic �c �c �c �c �c �c P �c
-d ;d Ed Vd , jd �d 7 �d
�d �d �d �d e e
%e 0e X Ee �e �e �e �e �e
�e �e f f $f Bf Wf ) wf
�f �f �f �f �f �f �f �f
�f g g 'g 9g Mg ]g
gg ug �g �g �g
�g �g �g �g 0 h 9h Kh Xh `h gh ( zh ( �h �h �h �h �h �h
i i
4i Bi Ti ^i ji
si
~i �i �i �i �i % �i �i �i j
j
j !j
)j 7j @j Mj Tj cj kj uj �j �j �j �j �j �j �j �j k
k
%k 0k Fk Mk \k yk �k
�k & �k 6 �k
l l 1 *l \l rl xl �l �l �l �l
�l
�l �l % �l m 2m Dm [m xm " �m �m " �m �m 9 �m 5n Ln 1 an
�n �n
�n �n ( �n ' �n . $o " So vo �o = �o �o �o p *p Gp `p pp p �p �p 5 �p O �p Hq Pq Yq A iq
�q �q 7 �q ' r
)r 7r Jr br kr }r �r
�r �r �r �r �r
�r �r �r s s
"s 0s <s Hs L Ys 3 �s 5 �s 8 t It $ Ot 6 tt Q �t �t u u
,u :u Pu ]u iu ou xu �u �u �u �u �u �u �u v v !v
3v >v Ev `v @ qv �v ! �v �v
�v �v
w w
*w 5w =w Cw Mw
Yw dw {w �w �w % �w �w �w �w x !x 7x ' Wx - x �x
�x ; �x �x ? y Fy Yy yy 2 �y �y
�y
�y �y �y z z &z .z 3z Sz nz �z + �z ( �z 8 �z 5 ${ " Z{ ) }{ ( �{ % �{ ( �{ | , >| k| # �| 4 �| �| �| �| } } !} � � � � � J - � � ^ � � � _ O v � < 3 � { � � � � � B ^ 7 � � � � e � 3 � f � = L � � I � m � � � u � � 9 , � � � � u � - � i � l � m
% � � � � Z � � I � � � � � � � � e J b F � � � � o C S � 9 � � � � � � � r � E � � _ � " g t � � Y 4 q � � � f � � � 7 ~ t � � � � � � � � l � � � � 7 x : � � � P * � D . Q \ Q � � y � w & � X � ~ h : � Z ! v � � � � � � 2 � ) [ � " � � � , � o � � � A � + $ � A k � ( ! � � � 8 ? @ � w 6 N � � � � � W � T N � � � � H K � � M 1 J � � ) � � � � d � n f } � & � } � � \ � � � � q a 6 � [ � s Z � � > � � � � B U � 8 b � � I \ � � � = � s � � u � G � � � � X � � r � � v S J F � z + � � | � � � � � Y ` � � V g � �
& � u { � � � � � � � F � a # s � o � 0 4 � X P � �
| � � O s b K � � � * � , � � � � H w [ � � � T 1 c � $ � / � � � 9 � � 7 � � � � � � � ] 3 ] ' � � � � r � � � � � � � � Q Y � { � � 5 � a 4 H � � D � % � ! � � # C i � + � � p . � b � � � $ ? ` 0 � � j � � � � � � M � t � � � � z j � � � � � >
� > U � k V � � � Z � } � � x � W � L � � � � E ! G � � � � � � � F � � S � + / � \ p B * d � � ~
B � 8 � 2 � / � � ` | ( ^ � H � � ' * @ 5 � @ � � � � q � ' � � � ; h | m y � $ v � � � � n y T 2 ) p
� � � � � � � � [ C � � 1 � � ( R � A i t q � I � � i � � � V � f P z � � � � ? �
� � � O @ 9 = � % � e � 6 5 h . � � Q o k D � � 0 , � ( � ) � g � � h n x � � c R � � ^ � _ g � � { � � � � � � � � � = � � � U � < � � � � � � j � � l N / � � � � A Y 8 K > � � G � � M ] � � � G � � � � U � � � L � � � � � 2 � � � � � � � � 0 ' � X T m N ; � e � � E � � ` l � � � � � � � L � � C � � � � � � � R � � � - 3 5 � z � d � � 1 M � � D � x O � � � p W < E P � � -
k � � 4 c � % < ; � } � " � d ; S � � � _ � � r V w
� � ? � � . � � ] � # � 6 � � � � � � ~ � � � � � � y � � � � & � j � � � � � � R c � � � # � � " : K n � � a : � W � �
Connection options:
Display settings:
Environment variables:
For more information, type "\?" (for internal commands) or "\help" (for SQL
commands) from within psql, or consult the psql section in the PostgreSQL
documentation.
Input and output options:
Output format options:
Parser: "%s"
Parser: "%s.%s" --help=commands list backslash commands, then exit
--help=variables list special variables, then exit
(options: S = show system objects, + = additional detail)
-0, --record-separator-zero
set record separator for unaligned output to zero byte
-1 ("one"), --single-transaction
execute as a single transaction (if non-interactive)
-?, --help[=options] show this help, then exit
-A, --no-align unaligned table output mode
-E, --echo-hidden display queries that internal commands generate
-F, --field-separator=STRING
field separator for unaligned output (default: "%s")
-H, --html HTML table output mode
-L, --log-file=FILENAME send session log to file
-P, --pset=VAR[=ARG] set printing option VAR to ARG (see \pset command)
-R, --record-separator=STRING
record separator for unaligned output (default: newline)
-S, --single-line single-line mode (end of line terminates SQL command)
-T, --table-attr=TEXT set HTML table tag attributes (e.g., width, border)
-U, --username=USERNAME database user name (default: "%s")
-V, --version output version information, then exit
-W, --password force password prompt (should happen automatically)
-X, --no-psqlrc do not read startup file (~/.psqlrc)
-a, --echo-all echo all input from script
-b, --echo-errors echo failed commands
-c, --command=COMMAND run only single command (SQL or internal) and exit
-d, --dbname=DBNAME database name to connect to (default: "%s")
-e, --echo-queries echo commands sent to server
-f, --file=FILENAME execute commands from file, then exit
-h, --host=HOSTNAME database server host or socket directory (default: "%s")
-l, --list list available databases, then exit
-n, --no-readline disable enhanced command line editing (readline)
-o, --output=FILENAME send query results to file (or |pipe)
-p, --port=PORT database server port (default: "%s")
-q, --quiet run quietly (no messages, only query output)
-s, --single-step single-step mode (confirm each query)
-t, --tuples-only print rows only
-v, --set=, --variable=NAME=VALUE
set psql variable NAME to VALUE
(e.g., -v ON_ERROR_STOP=1)
-w, --no-password never prompt for password
-x, --expanded turn on expanded table output
-z, --field-separator-zero
set field separator for unaligned output to zero byte
AUTOCOMMIT if set, successful SQL commands are automatically committed
COLUMNS number of columns for wrapped format
COMP_KEYWORD_CASE determines the case used to complete SQL key words
[lower, upper, preserve-lower, preserve-upper]
DBNAME the currently connected database name
ECHO controls what input is written to standard output
[all, errors, none, queries]
ECHO_HIDDEN if set, display internal queries executed by backslash commands;
if set to "noexec", just show without execution
ENCODING current client character set encoding
FETCH_COUNT the number of result rows to fetch and display at a time
(default: 0=unlimited)
HISTCONTROL controls command history [ignorespace, ignoredups, ignoreboth]
HISTFILE file name used to store the command history
HISTSIZE the number of commands to store in the command history
HOST the currently connected database server host
IGNOREEOF if unset, sending an EOF to interactive session terminates application
LASTOID value of the last affected OID
NAME=VALUE [NAME=VALUE] psql ...
or \setenv NAME [VALUE] inside psql
ON_ERROR_ROLLBACK if set, an error doesn't stop a transaction (uses implicit savepoints)
ON_ERROR_STOP stop batch execution after error
PAGER name of external pager program
PGAPPNAME same as the application_name connection parameter
PGDATABASE same as the dbname connection parameter
PGHOST same as the host connection parameter
PGPASSFILE password file name
PGPASSWORD connection password (not recommended)
PGPORT same as the port connection parameter
PGUSER same as the user connection parameter
PORT server port of the current connection
PROMPT1 specifies the standard psql prompt
PROMPT2 specifies the prompt used when a statement continues from a previous line
PROMPT3 specifies the prompt used during COPY ... FROM STDIN
PSQLRC alternative location for the user's .psqlrc file
PSQL_EDITOR, EDITOR, VISUAL
editor used by the \e, \ef, and \ev commands
PSQL_EDITOR_LINENUMBER_ARG
how to specify a line number when invoking the editor
PSQL_HISTORY alternative location for the command history file
QUIET run quietly (same as -q option)
SHELL shell used by the \! command
SHOW_CONTEXT controls display of message context fields [never, errors, always]
SINGLELINE end of line terminates SQL command mode (same as -S option)
SINGLESTEP single-step mode (same as -s option)
TMPDIR directory for temporary files
USER the currently connected database user
VERBOSITY controls verbosity of error reports [default, verbose, terse]
\! [COMMAND] execute command in shell or start interactive shell
\? [commands] show help on backslash commands
\? options show help on psql command-line options
\? variables show help on special variables
\C [STRING] set table title, or unset if none
\H toggle HTML output mode (currently %s)
\T [STRING] set HTML <table> tag attributes, or unset if none
\a toggle between unaligned and aligned output mode
\c[onnect] {[DBNAME|- USER|- HOST|- PORT|-] | conninfo}
connect to new database (currently "%s")
\c[onnect] {[DBNAME|- USER|- HOST|- PORT|-] | conninfo}
connect to new database (currently no connection)
\cd [DIR] change the current working directory
\conninfo display information about current connection
\copy ... perform SQL COPY with data stream to the client host
\copyright show PostgreSQL usage and distribution terms
\crosstabview [COLUMNS] execute query and display results in crosstab
\dA[+] [PATTERN] list access methods
\dC[+] [PATTERN] list casts
\dD[S+] [PATTERN] list domains
\dE[S+] [PATTERN] list foreign tables
\dF[+] [PATTERN] list text search configurations
\dFd[+] [PATTERN] list text search dictionaries
\dFp[+] [PATTERN] list text search parsers
\dFt[+] [PATTERN] list text search templates
\dL[S+] [PATTERN] list procedural languages
\dO[S+] [PATTERN] list collations
\dT[S+] [PATTERN] list data types
\d[S+] list tables, views, and sequences
\d[S+] NAME describe table, view, sequence, or index
\da[S] [PATTERN] list aggregates
\db[+] [PATTERN] list tablespaces
\dc[S+] [PATTERN] list conversions
\dd[S] [PATTERN] show object descriptions not displayed elsewhere
\ddp [PATTERN] list default privileges
\des[+] [PATTERN] list foreign servers
\det[+] [PATTERN] list foreign tables
\deu[+] [PATTERN] list user mappings
\dew[+] [PATTERN] list foreign-data wrappers
\df[antw][S+] [PATRN] list [only agg/normal/trigger/window] functions
\dg[S+] [PATTERN] list roles
\di[S+] [PATTERN] list indexes
\dl list large objects, same as \lo_list
\dm[S+] [PATTERN] list materialized views
\dn[S+] [PATTERN] list schemas
\do[S] [PATTERN] list operators
\dp [PATTERN] list table, view, and sequence access privileges
\drds [PATRN1 [PATRN2]] list per-database role settings
\ds[S+] [PATTERN] list sequences
\dt[S+] [PATTERN] list tables
\du[S+] [PATTERN] list roles
\dv[S+] [PATTERN] list views
\dx[+] [PATTERN] list extensions
\dy [PATTERN] list event triggers
\e [FILE] [LINE] edit the query buffer (or file) with external editor
\echo [STRING] write string to standard output
\ef [FUNCNAME [LINE]] edit function definition with external editor
\encoding [ENCODING] show or set client encoding
\errverbose show most recent error message at maximum verbosity
\ev [VIEWNAME [LINE]] edit view definition with external editor
\f [STRING] show or set field separator for unaligned query output
\g [FILE] or ; execute query (and send results to file or |pipe)
\gexec execute query, then execute each value in its result
\gset [PREFIX] execute query and store results in psql variables
\h [NAME] help on syntax of SQL commands, * for all commands
\i FILE execute commands from file
\ir FILE as \i, but relative to location of current script
\l[+] [PATTERN] list databases
\lo_export LOBOID FILE
\lo_import FILE [COMMENT]
\lo_list
\lo_unlink LOBOID large object operations
\o [FILE] send all query results to file or |pipe
\p show the contents of the query buffer
\password [USERNAME] securely change the password for a user
\prompt [TEXT] NAME prompt user to set internal variable
\pset [NAME [VALUE]] set table output option
(NAME := {border|columns|expanded|fieldsep|fieldsep_zero|
footer|format|linestyle|null|numericlocale|pager|
pager_min_lines|recordsep|recordsep_zero|tableattr|title|
tuples_only|unicode_border_linestyle|
unicode_column_linestyle|unicode_header_linestyle})
\q quit psql
\qecho [STRING] write string to query output stream (see \o)
\r reset (clear) the query buffer
\s [FILE] display history or save it to file
\set [NAME [VALUE]] set internal variable, or list all if no parameters
\setenv NAME [VALUE] set or unset environment variable
\sf[+] FUNCNAME show a function's definition
\sv[+] VIEWNAME show a view's definition
\t [on|off] show only rows (currently %s)
\timing [on|off] toggle timing of commands (currently %s)
\unset NAME unset (delete) internal variable
\w FILE write query buffer to file
\watch [SEC] execute query every SEC seconds
\x [on|off|auto] toggle expanded output (currently %s)
\z [PATTERN] same as \dp
border border style (number)
columns target width for the wrapped format
expanded (or x) expanded output [on, off, auto]
fieldsep field separator for unaligned output (default "%s")
fieldsep_zero set field separator for unaligned output to zero byte
footer enable or disable display of the table footer [on, off]
format set output format [unaligned, aligned, wrapped, html, asciidoc, ...]
linestyle set the border line drawing style [ascii, old-ascii, unicode]
null set the string to be printed in place of a null value
numericlocale enable or disable display of a locale-specific character to separate
groups of digits [on, off]
pager control when an external pager is used [yes, no, always]
psql --pset=NAME[=VALUE]
or \pset NAME [VALUE] inside psql
psql --set=NAME=VALUE
or \set NAME VALUE inside psql
psql [OPTION]... [DBNAME [USERNAME]]
recordsep record (line) separator for unaligned output
recordsep_zero set record separator for unaligned output to zero byte
set NAME=VALUE
psql ...
or \setenv NAME [VALUE] inside psql
title set the table title for any subsequently printed tables
tuples_only if set, only actual table data is shown
unicode_border_linestyle
unicode_column_linestyle
unicode_header_linestyle
set the style of Unicode line drawing [single, double]
"%s.%s" is not a view
%d connection %d connections %s %s %s (every %gs)
%s
%s (%s, server %s)
%s (every %gs)
%s: %s
%s: -1 can only be used in non-interactive mode
%s: cannot copy from/to a directory
%s: could not delete variable "%s"
%s: could not find own program executable
%s: could not open log file "%s": %s
%s: could not set printing parameter "%s"
%s: could not set variable "%s"
%s: current transaction is aborted
%s: invalid encoding name or conversion procedure not found
%s: not connected to a database
%s: out of memory
%s: unknown transaction status
%s: warning: extra command-line argument "%s" ignored
(%lu row) (%lu rows) ***(Single step mode: verify command)*******************************************
%s
***(press return to proceed or enter x and return to cancel)********************
********* QUERY **********
%s
**************************
+ opt(%d) = |%s|
, clustered , deferrable , initially deferred , invalid , predicate (%s) , replica identity , tablespace "%s" Access privileges All connection parameters must be supplied because no database connection exists
Argument data types Asynchronous notification "%s" received from server process with PID %d.
Asynchronous notification "%s" with payload "%s" received from server process with PID %d.
Attributes Available help:
Border style is %d.
Bypass RLS COPY data transfer failed: %s Call Handler Cannot add cell to table content: total cell count of %d exceeded.
Cannot add header to table content: column count of %d exceeded.
Cannot login Check Check constraints: Child tables Collate Column Column privileges Command: %s
Description: %s
Syntax:
%s
Composite type "%s.%s" Connection
Create DB Create role Ctype Database Default access privileges Default footer is off.
Default footer is on.
Default? Definition Description Destination Dictionaries Did not find any extension named "%s".
Did not find any extensions.
Did not find any relation named "%s".
Did not find any relation with OID %s.
Did not find any text search configuration named "%s".
Did not find any text search parser named "%s".
Disabled internal triggers: Disabled rules: Disabled triggers: Disabled user triggers: Elements Enabled Encoding End parse Enter data to be copied followed by a newline.
End with a backslash and a period on a line by itself, or an EOF signal. Enter it again: Enter new password: Event Expanded display is off.
Expanded display is on.
Expanded display is used automatically.
FDW Options FDW Options: (%s) Failed.
Field separator is "%s".
Field separator is zero byte.
Foreign table "%s.%s" Foreign-data wrapper Foreign-key constraints: Formatting
Function General
General options:
Get headline Get next token Get token types Handler Has OIDs: yes Help
ID Implicit? Index Index "%s.%s" Indexes: Informational
Inherits Init Init options Inline Handler Input/Output
Internal Language Internal name Interrupted
Invalid command \%s. Try \? for help.
Language Large Objects
Large objects Left arg type Lexize Line style is %s.
List of access methods List of aggregate functions List of casts List of collations List of conversions List of data types List of databases List of domains List of event triggers List of foreign servers List of foreign tables List of foreign-data wrappers List of functions List of installed extensions List of languages List of operators List of relations List of roles List of schemas List of settings List of specially treated variables
List of tablespaces List of text search configurations List of text search dictionaries List of text search parsers List of text search templates List of user mappings Locale-adjusted numeric output is off.
Locale-adjusted numeric output is on.
Location Materialized view "%s.%s" Member of Method Modifier Modifiers Name No changes No connections No help available for "%s".
Try \h with no arguments to see available help.
No inheritance No matching relations found.
No matching settings found.
No per-database role settings support in this server version.
No relations found.
No settings found.
Null display is "%s".
Number of child tables: %d (Use \d+ to list them.) Object Object Description Object descriptions Objects in extension "%s" Operating System
Options Output format is %s.
Owned by: %s Owner Pager is always used.
Pager is used for long output.
Pager usage is off.
Pager won't be used for less than %d line.
Pager won't be used for less than %d lines.
Parallel Password encryption failed.
Password for user %s: Password valid until Password: Passwords didn't match.
Policies Policies (forced row security enabled): Policies (forced row security enabled): (none) Policies (row security disabled): Policies (row security enabled): (none) Policies: Previous connection kept
Procedure Query Buffer
Query buffer is empty. Query buffer reset (cleared). Record separator is "%s".
Record separator is <newline>.
Record separator is zero byte.
Referenced by: Replica Identity Replication Report bugs to <pgsql-bugs@postgresql.org>.
Result data type Result type Right arg type Role Role name Rules firing always: Rules firing on replica only: Rules: SSL connection (protocol: %s, cipher: %s, bits: %s, compression: %s)
STATEMENT: %s
Schema Security Sequence "%s.%s" Server Server: %s Settings Size Source Source code Source type Special relation "%s.%s" Start parse Stats target Storage Succeeded.
Superuser TOAST table "%s.%s" Table Table "%s.%s" Table attributes are "%s".
Table attributes unset.
Tablespace Tablespace: "%s" Target type Target width is %d.
Target width is unset.
Template Text search configuration "%s" Text search configuration "%s.%s" Text search parser "%s" Text search parser "%s.%s" The connection to the server was lost. Attempting reset: The server (version %s) does not support access methods.
The server (version %s) does not support altering default privileges.
The server (version %s) does not support collations.
The server (version %s) does not support editing function source.
The server (version %s) does not support editing view definitions.
The server (version %s) does not support extensions.
The server (version %s) does not support foreign servers.
The server (version %s) does not support foreign tables.
The server (version %s) does not support foreign-data wrappers.
The server (version %s) does not support full text search.
The server (version %s) does not support savepoints for ON_ERROR_ROLLBACK.
The server (version %s) does not support showing function source.
The server (version %s) does not support showing view definitions.
The server (version %s) does not support tablespaces.
The server (version %s) does not support user mappings.
There is no previous error. Time: %.3f ms
Timing is off. Timing is on. Title is "%s".
Title is unset.
Token Token name Token types for parser "%s" Token types for parser "%s.%s" Triggers firing always: Triggers firing on replica only: Triggers: Trusted Try "%s --help" for more information.
Tuples only is off.
Tuples only is on.
Type Type "help" for help.
Type: \copyright for distribution terms
\h for help with SQL commands
\? for help with psql commands
\g or terminate with semicolon to execute query
\q to quit
Typed table of type: %s Unicode border line style is "%s".
Unicode column line style is "%s".
Unicode header line style is "%s".
Unlogged index "%s.%s" Unlogged materialized view "%s.%s" Unlogged table "%s.%s" Usage:
Use "\q" to leave %s.
User name Validator Value Variables
Version View "%s.%s" View definition: Volatility WARNING: %s major version %s, server major version %s.
Some psql features might not work.
WARNING: Console code page (%u) differs from Windows code page (%u)
8-bit characters might not work correctly. See psql reference
page "Notes for Windows users" for details.
Wrote history to file "%s".
You are connected to database "%s" as user "%s" on host "%s" at port "%s".
You are connected to database "%s" as user "%s" via socket in "%s" at port "%s".
You are currently not connected to a database.
You are now connected to database "%s" as user "%s" on host "%s" at port "%s".
You are now connected to database "%s" as user "%s" via socket in "%s" at port "%s".
You are now connected to database "%s" as user "%s".
You are using psql, the command-line interface to PostgreSQL. \!: failed
\%s: could not change directory to "%s": %s
\%s: environment variable name must not contain "="
\%s: error while setting variable
\%s: extra argument "%s" ignored
\%s: missing required argument
\connect: %s \copy: arguments required
\copy: parse error at "%s"
\copy: parse error at end of line
\crosstabview: ambiguous column name: "%s"
\crosstabview: column name not found: "%s"
\crosstabview: column number %d is out of range 1..%d
\crosstabview: data column must be specified when query returns more than three columns
\crosstabview: maximum number of columns (%d) exceeded
\crosstabview: query must return at least three columns
\crosstabview: query result contains multiple data values for row "%s", column "%s"
\crosstabview: statement did not return a result set
\crosstabview: vertical and horizontal headers must be different columns
\df does not take a "w" option with server version %s
\df only takes [antwS+] as options
\pset: allowed Unicode border line styles are single, double
\pset: allowed Unicode column line styles are single, double
\pset: allowed Unicode header line styles are single, double
\pset: allowed formats are unaligned, aligned, wrapped, html, asciidoc, latex, latex-longtable, troff-ms
\pset: allowed line styles are ascii, old-ascii, unicode
\pset: unknown option: %s
\watch cannot be used with COPY
\watch cannot be used with an empty query
abort the current transaction aborted because of read failure access_method_type action agg aggregate_name aggregate_signature alias alignment always analyze_function and aggregate_signature is: and conflict_action is one of: and grouping_element can be one of: and like_option is: and with_query is: arg_data_type arg_name arg_type argname argument argument_type arguments attribute attribute_name attribute_option boolean cache call_handler cancel a transaction that was earlier prepared for two-phase commit canceled by user cannot duplicate null pointer (internal error)
cannot escape without active connection
canonical_function category change a database change a database role change a run-time parameter change a server configuration parameter change role name or membership change the definition of a collation change the definition of a conversion change the definition of a domain change the definition of a foreign server change the definition of a foreign table change the definition of a foreign-data wrapper change the definition of a function change the definition of a large object change the definition of a materialized view change the definition of a procedural language change the definition of a row level security policy change the definition of a rule change the definition of a schema change the definition of a sequence generator change the definition of a table change the definition of a tablespace change the definition of a text search configuration change the definition of a text search dictionary change the definition of a text search parser change the definition of a text search template change the definition of a trigger change the definition of a type change the definition of a user mapping change the definition of a view change the definition of an aggregate function change the definition of an event trigger change the definition of an extension change the definition of an index change the definition of an operator change the definition of an operator class change the definition of an operator family change the ownership of database objects owned by a database role channel check_expression child process exited with exit code %d child process exited with unrecognized status %d child process was terminated by exception 0x%X child process was terminated by signal %d child process was terminated by signal %s close a cursor cluster a table according to an index code collatable collate %s collation collect statistics about a database column_alias column_constraint column_definition column_name column_type com_op command command not executable command not found commit a transaction that was earlier prepared for two-phase commit commit the current transaction compute a set of rows condition configuration_parameter conflict_action conflict_target connection to server was lost
constraint constraint_name copy data between a file and a table could not change directory to "%s": %s could not close pipe to external command: %s
could not execute command "%s": %s
could not find a "%s" to execute could not get home directory for user ID %ld: %s
could not identify current directory: %s could not locate temporary directory: %s
could not look up effective user ID %ld: %s could not open temporary file "%s": %s
could not parse reloptions array
could not read binary "%s" could not read from input file: %s
could not read symbolic link "%s" could not save history to file "%s": %s
could not set variable "%s"
could not start /bin/sh
could not start editor "%s"
could not stat file "%s": %s
could not write COPY data: %s
count create a new database create new rows in a table cursor_name data_type database_name deallocate a prepared statement default default %s default_expr define a cursor define a new access method define a new aggregate function define a new cast define a new collation define a new data type define a new database role define a new domain define a new encoding conversion define a new event trigger define a new foreign server define a new foreign table define a new foreign-data wrapper define a new function define a new index define a new mapping of a user to a foreign server define a new materialized view define a new operator define a new operator class define a new operator family define a new procedural language define a new rewrite rule define a new row level security policy for a table define a new savepoint within the current transaction define a new schema define a new sequence generator define a new table define a new table from the results of a query define a new tablespace define a new text search configuration define a new text search dictionary define a new text search parser define a new text search template define a new transform define a new trigger define a new view define access privileges define default access privileges define or change a security label applied to an object define or change the comment of an object definer definition delete delete rows of a table delimiter delimiter_character dest_encoding destroy a previously defined savepoint dictionary_name direction directory disabled discard session state domain constraint domain_constraint domain_name element empty a table or set of tables enabled encoding encoding_name end_function environment variable PSQL_EDITOR_LINENUMBER_ARG must be set to specify a line number
escape_character event exclude_element execute a prepared statement execute an anonymous code block execution_cost existing_collation existing_enum_value expression extension_name family_name fdw_name ffunc filename filter_variable for table "%s.%s" force a transaction log checkpoint foreign table format_name from_item from_list function function name is required
function_name garbage-collect and optionally analyze a database generate a notification group_name grouping_element handler_function history is not supported by this installation
immutable import table definitions from a foreign server in assignment increment index index_column_name index_expression index_method index_name index_parameters index_parameters in UNIQUE, PRIMARY KEY, and EXCLUDE constraints are: index_predicate init_function initial_condition inline_handler input_function insert install an extension integer internallength invalid binary "%s" invalid command \%s
invalid line number: %s
invalid output format (internal error): %d invoker join_column join_condition join_proc join_type label lang_name large_object_oid lc_collate lc_ctype left_type lexize_function lextypes_function like_option like_type link_symbol listen for a notification load a shared library file local socket local_schema locale lock a table lockmode loid materialized view maxvalue member_object method mffunc minvalue minvfunc more than one row returned for \gset
mstate_data_size mstate_data_type name neg_op new_attribute_name new_column_name new_constraint_name new_dictionary new_enum_value new_name new_owner new_role new_schema new_table new_tablespace new_version no no query buffer
no rows returned for \gset
normal not null null_string obj_file object_name off old_dictionary old_role old_version on op_type opclass operator operator class operator family operator_name option or the old syntax out of memory out of memory
output_expression output_function output_name parameter parent_table parser_name password payload pclose failed: %s policy_name position a cursor preferred prepare a statement for execution prepare the current transaction for two-phase commit primary key, provider psql is the PostgreSQL interactive terminal.
psql variables:
query quote_character rebuild indexes receive_function refcolumn reftable relation_name remote_schema remove a cast remove a collation remove a conversion remove a data type remove a database remove a database role remove a domain remove a foreign server descriptor remove a foreign table remove a foreign-data wrapper remove a function remove a materialized view remove a procedural language remove a rewrite rule remove a row level security policy from a table remove a schema remove a sequence remove a table remove a tablespace remove a text search configuration remove a text search dictionary remove a text search parser remove a text search template remove a transform remove a trigger remove a user mapping for a foreign server remove a view remove access privileges remove an access method remove an aggregate function remove an event trigger remove an extension remove an index remove an operator remove an operator class remove an operator family remove database objects owned by a database role replace the contents of a materialized view replica res_proc restart restore the value of a run-time parameter to the default value restricted result_rows retrieve rows from a query using a cursor retrieve rows from a table or view rettype rewrite_rule_name right_type role_name role_specification roll back to a savepoint rule rule_name safe sampling_method savepoint_name schema_element schema_name seed select send_function sequence sequence_name server_name server_type server_version set constraint check timing for the current transaction set the characteristics of the current transaction set the current user identifier of the current session set the session user identifier and the current user identifier of the current session sfunc show the execution plan of a statement show the value of a run-time parameter skipping recursive expansion of variable "%s"
snapshot_id sort_expression sort_family_name source_config source_encoding source_table source_type special stable start start a transaction block start_function state_data_size state_data_type statement stop listening for a notification storage storage_parameter storage_type strategy_number sub-SELECT subtype subtype_operator_class support_number tab completion query failed: %s
Query was:
%s
table table constraint table_constraint table_name tablespace_name tablespace_option target_role target_type template text timestamp timezone token_type transaction_id transaction_mode trigger trigger_name trying to exit copy mode type type_modifier_input_function type_modifier_output_function type_name uid unexpected PQresultStatus: %d
unexpected result status for \watch
unexpected transaction status (%d)
unique, unknown unrecognized value "%s" for "%s"; assuming "%s"
unsafe unterminated quoted string
update update rows of a table user does not exist user name lookup failure: error code %lu user_name using_expression using_list valfunction validator_function value values version view view name is required
view_option_name view_option_value volatile where action is one of: where aggregate_signature is: where column_constraint is: where conflict_target can be one of: where constraint is: where direction can be empty or one of: where event can be one of: where from_item can be one of: where lockmode is one of: where member_object is: where option can be one of: where option can be: where role_specification can be: where transaction_mode is one of: window window_definition window_name with_query with_query_name yes Project-Id-Version: psql-tr
Report-Msgid-Bugs-To: pgsql-bugs@postgresql.org
POT-Creation-Date: 2018-04-20 21:52+0000
PO-Revision-Date: 2018-04-25 15:52+0300
Last-Translator: Devrim GÜNDÜZ <devrim@gunduz.org>
Language-Team: Turkish <ceviri@postgresql.org.tr>
Language: tr
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Plural-Forms: nplurals=2; plural=0;
X-Poedit-SourceCharset: utf-8
X-Generator: Poedit 1.8.7.1
X-Poedit-Basepath: /home/devrim/PostgreSQL/pgsql-cvs/pgsql
X-Poedit-Bookmarks: -1,-1,333,-1,-1,-1,-1,-1,-1,-1
Bağlantı seçenekleri:
Görüntüleme ayarları:
Ortam değişkenleri:
Daha fazla bilgi için yapsql içinde: "\?" (dahili komutlar için) ya "\help"
(SQL komutlar için) yazın, ya da PostgreSQL belgelerinin psql bölümüne
bakın.
Giriş ve çıkış tercihleri:
Çıktı biçimi seçenekleri:
Ayrıştırıcı: "%s"
Ayrıştırıcı "%s.%s" --help=commands "\"komutlarını listele, sonra çık
--help=variables özel değişkenleri listele, sonra çık
(seçenekler: S = sistem nesnelerini göster, + = ek ayrıntılar)
-0, --record-separator-zero
hizalanmamış çıktı için kayıt ayırıcısını sıfır bayt'a ayarla
-1 ("one"), --single-transaction
komut dosyasını tek bir transaction olarak çalıştır (interaktif değilse)
-?, --help[=options] bu yardımı göster, sonra çık
-A, --no-align dizilmemiş tablo çıktı modu
-E, --echo-hidden dahili komutların ürettiği sorguları göster
-F, --field-separator=DİZGİ
hizalanmamış çıktı için alan ayırıcısı (varsayılan: "%s")
-H, --html HTML tablosu çıktı modu
-L, --log-file=DOSYA ADI oturum kaydını dosyaya kaydet
-P, --pset=VAR[=ARG] VAR yazma ayarınına ARG değerini ata (\pset komutuna bak)
-R, --record-separator=DİZGİ
hizalanmamış çıktı için kayıt ayırıcısı (varsayılan: yeni satır)
-S, --single-line tek satır modu (satır sonu SQL komutunu sonlandırır)
-T, --table-attr=TEXT HTML tablo tag parametrelerini ayarla (genişlik, kenarlık)
-U, --username=KULLANICI ADI veritabanı kullanıcı adı (varsayılan: "%s")
-V, --version sürüm bilgisini gösterir ve sonra çıkar
-W şifre sor (otomatik olarak her zaman açık)
-X , --no-psqlrc başlangıç dosyasını (~/.psqlrc) okuma
-a, --echo-all betik dosyasının içeriğini yansıt
-e, --echo-errors başarısız komutları yansıt
-c, --command=KOMUT tek bir komut çalıştır (SQL ya da dahili) ve çık
-d, --dbname=DBNAME bağlanılacak veritabanının adı (öntanımlı: "%s")
-e, --echo-queries sunucuya gönderilen komutları yansıt
-f, --file=DOSYA ADI dosyadan komutları çalıştır ve çık
-h, --host= HOST ADI veritabanı sunucu adresi ya da soket dizini (varsayılan: "%s")
-l, --list veritabanlarını listele ve çık
-n, --no-readline gelişmiş komut satırı düzenleyicisini devre dışı bırak (readline)
-o, --output=DOSYA ADI sorgu sonuçlarını dosyaya aktar (ya da |pipe)
-p, --port=PORT veritabanı sunucusu port numarası (varsayılan: "%s")
-q, --quiet sessiz biçim (mesajlar kapalı, sadece sorgu sonuçları açık)
-s, --single-step tek adım biçimi (her sorguyu onaylama)
-t, --tuples-only sadece satırları yaz
-v, --set=, --variable=ADI=DEĞER
ADI kısmında belirtilen psql değişkeninin değerini DEĞER ile belirtilen değer olarak ata
(örnek, -v ON_ERROR_STOP=1)
-W, --no-password bağlanmak için kesinlikle parola sorma
-x, --expanded gelişmiş tablo çıktısını atkinleştir
-z, --field-separator-zero
hizalanmamış çıktı için alan ayırıcısını sıfır bayt'a ayarla
AUTOCOMMIT ayarlanırsa, başarılı SQL komutları otomatik olarak "commit" edilir
COLUMNS wrapped biçim için sütun sayısı
COMP_KEYWORD_CASE SQL anahtar kelimeleri tamamlanırken kullanılacak büyük/küçük harf seçeneğini belirler
[lower, upper, preserve-lower, preserve-upper]
DBNAME geçerli durumda bağlanılan veritabanının adı
ECHO hangi girdinin standart çıktıya yazılacağını kontrol eder
[all, errors, none, queries]
ECHO_HIDDEN ayarlanırsa ters-taksimli komutlar tarafından çalıştırılan dahili sorguları gösterir ;
"noexec" olarak ayarlanırsa, çalıştırmadan sadece gösterir
ENCODING geçerli istemci karakter kümesi kodlaması
FETCH_COUNT bir defada alınacak ve gösterilecek sonuç satırı sayısı
(varsayılan: 0=sınırsız)
HISTCONTROL komut geçmişini kontrol eder [ignorespace, ignoredups, ignoreboth]
HISTFILE komut geçmişini saklamak için kullanılacak dosya adı
HISTSIZE komut geçmişinde saklanacak komut sayısı üst sınırı
HOST geçerli durumda bağlanılan veritabanı sunucu makinesi
IGNOREEOF eğer ayarlanmazsa, interaktif oturuma dosya sonu (EOF) gönderilmesi uygulamayı sonlandırır
LASTOID etkilenen son OID'nin değeri
NAME=VALUE [NAME=VALUE] psql ...
veya psql içinde \setenv NAME [VALUE]
ON_ERROR_ROLLBACK ayarlanırsa, bir hata bir işlemi (transaction) durdurmaz (örtük kayıt noktaları (savepoint) kullanır)
ON_ERROR_STOP hata sonrası yığın çalıştırmayı durdurur
PAGER harici sayfalama programının ismi
PGAPPNAME application_name bağlantı parametresinin aynısı
PGDATABASE dbname bağlantı parametresinin aynı
PGHOST host bağlantı parametresinin aynı
PGPASSFILE parola dosya adı
PGPASSWORD bağlantı parolası (tavsiye edilmez)
PGPORT port bağlantı parametresiyle aynı
PGUSER kullanıcı bağlantı parametresiyle aynı
PORT geçerli bağlantının sunucu port'u
PROMPT1 standart psql komut istemi
PROMPT2 bir komut önceki satırdan beri devam ediyorsa kullanılan komut istemini belirtir
PROMPT3 COPY ... FROM STDIN sırasında kullanılan komut istemini belirtir
PSQLRC kulanıcının.psqlrc dosyası için alternatif konum
PSQL_EDITOR, EDITOR, VISUAL
\e, \ef, ve \ev komutları tarafından kullanılan editör
PSQL_EDITOR_LINENUMBER_ARG
editörü çağırırken bir satır numarasının nasıl belirtileceği
PSQL_HISTORY komut geçmişi dosyası için alternatif konum
QUIET sessizce çalış (-q seçeneğiyle aynı)
SHELL \! komutu tarafından kullanılan kabuk
SHOW_CONTEXT mesaj bağlam (context) alanlarının gösterimini kontrol eder [never, errors, always]
SINGLELINE satır sonu SQL komut modunu sonlandırır (-S seçeneğiyle aynı)
SINGLESTEP single-step modu (-s seçeneğiyle aynı)
TMPDIR geçici dosyalar için dizin
USER mevcut urumda bağlı veritabanı kullanıcısı
VERBOSITY hata raporlarının ayrıntı seviyesini kontrol eder [default, verbose, terse]
\! [KOMUT] komutu kabukta çalıştır ya da etkileşimli kabuğu başlat
\? [komutlar] "\" komutları için yardım gösterir
\? options psql komut satırı seçenekleri için yardım göster
\? variables özel değişkenler hakkında yardım göster
\C [DİZİ] tablo başlığını ayarla, ya da boş bırakılırsa kaldır
\H HTML çıktı modunu değiştir (şu anda %s)
\T [DİZGİ] HTML <table> parametrelerini tanımla, boş ise tüm parametrelerini kaldır
\a düzenli ve düzensiz çıktı modu arasında geçiş yap
\c[onnect] {[VTADI|- KULLANICIADI|- KARŞISUNUCU|- PORT|-] | conninfo}
yeni veritabanına bağlan (geçerli veritabanı "%s")
\c[onnect] {[VTADI|- KULLANICIADI|- KARŞISUNUCU|- PORT|-] | conninfo}
yeni veritabanına bağlan (geçerli bağlantı yok)
\cd [DIR] geçerli çalışma dizinini değiştir
\conninfo geçerli bağlantı ile ilgili bilgi göster
\copy ... istemci sisteminden veri akımı ile SQL COPY komutunu çalıştır
\copyright PostgreSQL kullanım ve dağıtım şartlarını göster
\crosstabview [COLUMNS] sorguyu çalıştır ve sonuçları çapraz tablo içinde göster
\dA[+] [PATTERN] erişim yöntemlerini listele
\dC[+] [PATTERN] castleri listele
\dD[S+] [PATTERN] domainleri listele
\dE[S+] [PATTERN] uzak (foreign) tabloları listele
\dF[+] [PATTERN] metin arama yapılandırmalarını listele
\dFd[+] [PATTERN] metin arama sözlüklerini listele
\dFp[+] [PATTERN] metin arama ayrıştırıcılarını listele
\dFt[+] [PATTERN] metin arama şablonlarını listele
\dL[S+] [PATTERN] yordamsal dilleri listele
\dO[S+] [PATTERN] collationları listele
\dT[S+] [PATTERN] veri tiplerini listele
\d[S+] tablo, views, ve sequenceleri listele
\d[S+} AD tablo, indeks, sequence, ya da view tanımlarını göster
\da[S] [PATTERN] aggregateleri listele
\db[+] [PATTERN] tablespaceleri listele
\dc[S+] [PATTERN] dönüşümleri listele
\dd[S] [PATTERN] başka yerde gösterilmeyen nesne açıklamalarını göster
\ddp [PATTERN] öntanımlı izinleri listele
\des[+] [PATTERN] foreign sunucuları listele
\det[+] [PATTERN] foreign tabloları listele
\deu[+] [PATTERN] kullanıcı haritalamasını listele
\dew[+] [PATTERN] foreign-data wrapperlarını listele
\df[antw][S+] [PATRN] [sadece agg/normal/trigger/window] fonksiyonlarını listele
\dg[S+] [PATTERN] rolleri listele
\di[S+] [PATTERN] indexleri göster
\dl large objectleri göster; \lo_list ile aynıdır
\dm[S+] [PATTERN] maddileştirilmiş görünümleri (materialized view) listele
\dn[S+] [PATTERN] şemaları listele
\do[S] [PATTERN] operatörleri listele
\dp [PATTERN] tablo, view, ve sequence erişim izinlerini listele
\drds [PATRN1 [PATRN2]] veritabanı başına rol ayarlarını listele
\ds[S+] [PATTERN] sequenceları listele
\dt[S+] [PATTERN] tabloları listele
\du[S+] [PATTERN] rolleri listele
\dv[S+] [PATTERN] viewları listele
\dx[+] [PATTERN] uzantıları listele
\dy [PATTERN] olay tetikleyicilerini listele
\e [FILE] [LINE] sorgu tamponunu (ya da dosyasını) harici bir metin düzenleyici ile düzenle
\echo [METIN] standart çıktıya bir satır gönder
\ef [FUNCNAME [LINE]] fonksiyon tanımını harici bir metin düzenleyici ile düzenle
\encoding [KODLAMA] istemci dil kodlamasını göster
\errverbose en son hata mesajını azami açıklamalı olarak göster
\ev [VIEWNAME [LINE]] görünüm (view) tanımını harici bir metin düzenleyici ile düzenle
\f [DİZİ] düzensiz sorgu çıktısı için alan ayracını göster ya da tanımla
\g [DOSYA] or ; sorguyu çalıştır (anve sonucu dosyaya ya da |pipe'a gönder)
\gexec sorguyu çalıştır, sonra her değeri onun sonucu içinde çalıştır
\gset [PREFIX] sorguyu çalıştır ve sonuçları psql değişkenlerinde sakla
\h [NAME] SQL komutları için sözdizimi yardımı, tüm komutlar için * ekleyin
\i DOSYA dosyadaki komutları çalıştıre
\ir DOSYA \i gibi, fakat geçerli betiğin bulunduğu yere göre
\l[+] [PATTERN] veritabanlarını listele
\lo_export LOBOID DOSYA
\lo_import DOSYA [YORUM]
\lo_list
\lo_unlink LOBOID large object operasyonları
\o [DOSYA] tüm sorgu sonuçlarını dosyaya ya da |pipe'e gönder
\p sorgu tamponunun içeriğini göster
\password [KULLANICI ADI] kullanıcının parolasını güvenli şekilde değiştir
\prompt [METİN] AD kullanıcıdan dahili değişkeni değiştirmesini iste
\pset [NAME [VALUE]] tablo çıktı seçeneğini ayarla
(NAME := {border|columns|expanded|fieldsep|fieldsep_zero|
footer|format|linestyle|null|numericlocale|pager|
pager_min_lines|recordsep|recordsep_zero|tableattr|title|
tuples_only|unicode_border_linestyle|
unicode_column_linestyle|unicode_header_linestyle})
\q psql'den çık
\qecho [STRING] sorgu çıktı akımına dizgi yaz (\o seçeneğine bakınız)
\r sorgu tamponunu sıfırla (temizle)
\s [DOSYA] geçmişi göster ya da dosyaya kaydet
\set [AD [DEĞER]] dahili değişkene değer ata, DEĞER boş ise tüm değişkenlerin listesini göster
\setenv NAME [VALUE] ortam değişkenini ayarla ya da ayarları sıfırla
\sf[+] FUNCNAME fonksiyonun tanımını göster
\sv[+] VIEWNAME görünümün (view) tanımını göster
\t [on|off] sadece satırları göster (şu an %s)
\timing [on|off] komutların çalışma zamanlamasının gösterilmesini değiştir (şu anda %s)
\unset AD dahili değişkenleri sıfırla(sil)
\w DOSYA sorgu tamponunu dosyaya kaydet
\watch [SNY] sorguyu her SNY saniyede bir çalıştır
\x [on|off|auto] geniş çıktı ayarla (şu an %s)
\z [PATTERN] \dp ile aynı
border kenar biçimi (number)
columns "wrapped" biçimi için hedef genişlik
expanded (veya x) genişletilmiş çıktı [on, off, auto]
fieldsep hizalanmamış çıktı için alan ayrıcısı (varsayılan "%s")
fieldsep_zero hizalanmamış çıktı için alan ayırıcısını sıfır bayt'a ayarla
footer tablo alt bilgi alanının etkinleştirilme veya devre dışı bırakılması [on, off]
format çıktı biçimini ayarla [unaligned, aligned, wrapped, html, asciidoc, ...]
linestyle kenar çizgisi biçimini ayarla [ascii, old-ascii, unicode]
null null değer yerine yazılacak dizgeyi ayarla
numericlocale basamak gruplarını ayırmak için yerel-özel bir karakterin gösterilmesini
etkinleştir veya devre dışı bırak [on, off]
pager harici sayfalamanın ne zaman kullanılacağını kontrol eder [yes, no, always]
psql --pset=NAME[=VALUE]
veya psql içinde \pset NAME [VALUE]
psql --set=NAME=VALUE
veya psql içinde \set NAME VALUE
psql [SEÇENEK]... [VERİTABANI ADI [KULLANICI ADI]]
recordsep hizalanmamış çıktı için kayıt (satır) ayırıcısı
recordsep_zero hizalanmamış çıktı için kayıt ayırıcısını sıfır bayt'a ayarla
set NAME=VALUE
psql ...
veya psql içinde \setenv NAME [VALUE]
title sonradan basılan tablolar için tablo başlığını ayarla
tuples_only ayarlanırsa, sadece gerçek tablo verisi gösterilir
unicode_border_linestyle
unicode_column_linestyle
unicode_header_linestyle
Unicode çizgi çizme içimini ayarlar [single, double]
"%s.%s" bir görünüm (view) değildir
%d bağlantı 1 bağlantı %s %s %s (her %gs)
%s
%s (%s, sunucu %s)
%s (her %gs)
%s: %s
%s: -1 sadece interaktif olmayan modda kullanılabilir
%s: dizinden ya da dizine kopyalanamıyor
%s: "%s" değişkeni silinemiyor
%s: çalıştırılabilir dosya bulunamadı
%s: "%s" kayıti dosyası açılamıyor: %s
%s: "%s" yazdırma parametrlesi ayarlanamıyor
%s: "%s" değişkeni atanamıyor
%s: geçerli transaction iptal edildi
%s: dil kodlama adı geçersiz ya da dönüştürme fonksiyonu bulunamadı
%s: veritabanına bağlı değil
%s: yetersiz bellek
%s: bilinmeyen transaction durumu
%s: uyarı: "%s" fazla argümanı atlanmıştır
(%lu satır) (%lu satır) ***(Tek adım modu: verify command)*******************************************
%s
***(devam etmek için return, durdurmak için x ve return'e basınız)********************
********* SORGU **********
%s
**************************
+ opt(%d) = |%s|
, clustered , ertelenebilir , başlangıçta ertelenmiş , geçersiz , belirli (%s) , replika kimliği , tablespace "%s" Erişim hakları Bütün bağlantı parametreleri sağlanmalı çünkü hiçbir veritabanı bağlantısı bulunmuyor
Argüman veri tipi PID %2$d olan sunucu sürecinden "%1$s" asenkon bildiri alınmış.
PID %3$d olan sunucu sürecinden "%2$s" payload'lı "%1$s" asenkon bildiri alınmış.
Özellikler Yardım:
Kenar stili: %d.
RLS'yi atlat COPY veri aktarımı başarısız: %s Çağrı işleyici(call handler) Hücre tablo içeriğine eklenemedi: %d olan toplan hücre sayısı açıldı.
B aşlık tablo içeriğine eklenemedi: %d kolon sayısı aşıldı.
Giriş yapılamıyor Check Check constraints: alt tablolar Sıralama(collate) Kolon Sütun erişim hakları Komut: %s
Açıklama: %s
Söz dizimi:
%s
Birleşik veri tipi "%s.%s" Bağlantı
Veritabanı Oluştur Rol oluştur Ctype Veritabanı Varsayılan erişim hakları Varsayılan sayfa altbilgisi kapalı.
Varsayılan sayfa altbilgisi açık.
Varsayılan? Tanım Açıklama Hedef Sözlükler "%s" adında uzantı (extension) bulunamadı.
Hiç bir uzantı bulunamadı.
"%s" adında nesne bulunamadı.
OID %s olan nesne bulunamadı.
"%s" adında metin arama yapılandırması bulunamadı.
"%s" adında metin arama ayrıştırıcısı bulunamadı.
Devre dışı dahili tetikleyiciler: Devre dışı bırakılmış rule'lar: Devre dışı bırakılmış tetikleyiciler: Devre dışı kullanıcı tetikleyicileri: Elemanlar Etkin Dil Kodlaması Ayrıştırmayı bitir Kopyalanacak veriyi girin ve ardından entera basın.
Sonuçlandırmak için yeni satırda ters taksim işareti ve nokta veya bir EOF işareti girin. Yıneden girin: Yeni şifre girin: Olay Geniş gösterme kapalı.
Geniş gösterme açık.
Geniş gösterme otomatik olarak kullanılıyor.
FDW Seçenekleri FDW Seçenekleri: (%s) Başarısız.
Alan ayracı: "%s".
Alan ayırıcısı sıfır bayttır.
"%s.%s" uzak (foreign) tablosu Foreign-data wrapper İkincil anahtar sınırlamaları: Biçimlendirme:
Fonksiyon Genel
Genel seçenekler:
Başlığı al Sıradaki tokeni al Token tiplerini al İşleyici (handler) OID'ler mevcut: evet Yardım
ID Örtülü mü? İndeks İndex "%s.%s" İndeksler: Bilgi edinme
Inherits Init İnit seçenekleri Satır içi işleyici(inline handler) Giriş/Çıkış
Dahili dil Dahili adı kesildi
Geçersiz komut \%s. Yardım için \? yazınız.
Dil Large Objectler
Large objectler Sol argüman veri tipi Lexize Satır stili: %s.
Erişim yöntemlerinin listesi Aggregate fonksiyonların listesi Castlerin listesi Karşılaştırma (collations) listesi Dönüşümlerin listesi Veri tiplerinin listesi Veritabanlarının listesi Domainlerin listesi Olay tetikleyicilerin listesi Foreign sunucuların listesi Uzak (foreign) tabloların listesi Foreign-data wrapperlarının listesi Fonksiyonların listesi Kurulu uzantıların (extension) listesi Dil listesi Operatörlerin listesi Nesnelerin listesi Veritabanı rolleri listesi Şemaların listesi Seçeneklerin lsitesi Özel değişkenlerin listesi
Tablespace listesi Metin arama yapılandırmalarının listesi Metin arama sözlüklerinin listesi Metin arama ayrıştıcılarının listesi Metin arama şablonlarının listesi Kullanıcı eşlemelerinin listesi Yerel duyarlı sayısal çıktı biçimlendirme kapalı.
Yerel duyarlı sayısal çıktı biçimlendirme açık.
Yer "%s.%s" maddileştirilmiş görünümü (materialized view) Üyesidir Yöntem Düzenleyici Modifiers Adı Değişiklik yok Bağlantı yok "%s" için yardım bulunmamaktadır.
\h yazarak yardım konularının listesini görüntüleyin.
Miras yok Eşleşen nesne bulunamadı.
Eşleşen ayar bulunamadı.
Bu sunucu sürümünde veritabanlarına özgü rol ayarları desteklenmiyor.
Nesne bulunamadı.
Ayar bulunamadı.
Null display is "%s".
alt tabloların sayısı: %d (Listelemek için \d+ kullanabilirsiniz.) Nesne Nesne Açıklaması Nesne açıklamaları "%s" uzantısındaki nesneler işletim Sistemi
Seçenekler Çıktı formatı: %s.
Sahibi: %s Sahibi Sayfalama her zaman kullanılacak.
Uzun çıktı için sayfalama kullanılacaktır.
Sayfalama kullanımı kapalı.
Sayfalama %d den daha az satır için kullanılmayacak.
Sayfalama %d den daha az satır için kullanılmayacak.
Paralel Parola şifrleme hatası.
%s kulalnıcısının şifresi: Parola geçerlilik tarihi Şifre: Şifreler uyuşmıyor.
İlkeler İlkeler (zorunlu satır güvenliği etkin): İlkeler (zorunlu satır güvenliği etkin): (hiçbiri) İlkeler (satır güvenliği devre dışı): İlkeler (satır güvenliği etkin): (hiçbiri) İlkeler: Önceki bağlantı kullanılacaktır
Yordam Sorgu tamponu
Sorgu tamponu boş. Sorgu tamponu sıfırlanmış. Kayıt ayracı "%s".
Kayıt ayırıcısı <newline>.
Kayıt ayırıcısı sıfır bayttır.
Referans veren: Replika özdeşliği Replikasyon Hataları <pgsql-bugs@postgresql.org> adresine bildirebilirsiniz.
Sonuç veri tipi Sonuç veri tipi Sağ argüman veri tipi Rol Rol adı Her zaman çalıştırılan rule'ler: Sadece kopyada çalıştırılan rule'ler: Rulelar: SSL bağlantısı (protokol:%s, cipher: %s, bit sayısı: %s, sıkıştırma: %s)
KOMUT: %s
Şema Güvenlik Sequence "%s.%s" Sunucu Sunucu: %s Ayarlar Boyut Kaynak Kaynak kodu Kaynak tipi Özel nesne "%s.%s" Ayrıştırmayı başlat Stats hedefi Saklama Başarılı.
Superuser TOAST tablosu "%s.%s" Tablo Tablo "%s.%s" Tablo özellikleri: "%s".
Tablo özellikleri kaldırıldı.
Tablespace Tablespace: "%s" Hedef tipi Hedef genişlik %d.
Hedef genişlik ayarı kaldırıldı.
Şablon Metin arama yapılandırması "%s" Metin arama yapılandırması "%s.%s" "%s" metin arama ayrıştırıcısı Metin arama ayrıştırıcısı "%s.%s" Sunucuya bağlantı kesildi. Yeniden bağlantı deneniyor: Bu sunucu (%s sürümü) erişim yöntemlerini desteklememektedir.
Bu sunucu (%s sürümü) varsayılan (default) hakların değiştirilmesini desteklemiyor.
Bu sunucu (%s sürümü) karşılaştırmaları (collations) desteklememektedir.
Sunucu (%s sürümü) fonksiyon kaynak kodunda düzenlemeyi desteklememektedir.
Sunucu (%s sürümü) görünüm tanımları üzerinde düzenlemeyi desteklememektedir.
Bu sunucu (%s sürümü) uzantıları (extension) desteklememektedir.
Bu sunucu (%s sürümü) uzak (foreign) sunucuları desteklemiyor.
Bu sunucu (%s sürümü) uzak (foreign) tabloları desteklemiyor.
Sunucu (%s sürümü) foreign-data wrapperlarını desteklememektedir.
Bu sunucu (%s sürümü) tam metin aramayı desteklememektedir.
Sunucu (%s sürümü) ON_ERROR_ROLLBACK için savepointleri desteklememektedir.
Sunucu (%s sürümü) fonksiyon kaynağını görüntülemeyi desteklemiyor.
Sunucu (%s sürümü) görünüm (view) tanımlarını göstermeyi desteklememektedir.
Bu sunucu (%s sürümü) tablespace desteklememektedir.
Sunucu (%s sürümü) kullanıcı haritalamasını desteklememektedir.
Önceden kalan hata bulunmuyor. Süre: %.3f milisaniye
Zamanlama kapalı. Zamanlama açık. Başlık "%s".
Başlık kaldırıldı
Token Token adı "%s" ayrıştırıcısı için token tipleri "%s.%s" ayrıştırıcısı için token tipleri Her zaman çalıştırılan tetikleyiciler: Sadece kopyada çalıştırılan tetikleyiciler: Tetikleyiciler(Triggers): Güvenilir Daha fazla bilgi için "%s --help" yazın.
Sadece kayıtları gösterme kapalı.
Sadece kayıtları gösterme açık.
Veri tipi Yardım için "help" yazınız.
Komutlar: \copyright dağıtım koşulları için
\h SQL komutları hakkında yardım için
\? psql dahili komutlarının yardımı için
\g ya da noktalı virgül: sorguyu çalıştırmak için
\q çıkmak için
%s tipi için tipli tablo Unicode kenar çizgi stili: "%s".
Unicode sütun çizgi stili: "%s".
Unicode sayfa üstbilgi çizgi stili: "%s".
Loglanmayan index "%s.%s" Loglanmayan maddileştirilmiş görünüm (materialized view) "%s.%s" Loglanmayan tablo "%s.%s" Kullanımı:
%s'den çıkmak için "\q" kullanın.
Kullanıcı adı Onaylayan Değer Değişkenler
Sürüm View "%s.%s" View tanımı: Oynaklık UYARI: %s ana sürümü %s, sunucu ana sürümü %s.
Bazı psql özellikleri çalışmayabilir.
UYARI: Uçbirimin kod sayfası (%u), Windows kod syafasından (%u) farklıdır
8-bitlik karakterler doğru çalışmayabilir. Ayrıntılar için psql referans
belgelerinde "Windows kullanıcılarına notlar" bölümüne bakın.
Geçmiş, "%s" dosyasına yazıldı.
"%s" veritabanına "%s" kullanıcısyla "%s" sunucusu üzrerinden "%s" porttan bağlandınız.
"%s" veritabanına "%s" kullanıcısıyla "%s" içindeki soket ile "%s" port'undan bağlandınız.
Şu anda bir veritabanına bağlı değilsiniz.
Şu anda "%s" veritabanına "%s" kullanıcısı ile "%s" sunucusunda "%s". porttan bağlısınız.
Şu an "%s" veritabanına "%s" kullanıcısıyla "%s" içindeki soket ile "%s" port'undan bağlısınız.
Şu an "%s" veritabanına "%s" kullanıcısı ile bağlısınız.
PostgreSQL'in komut satırı arabirimi olan psql'i kullanıyorsunuz. \!: başarısız
\%s: "%s" dizinine geçiş yapılamamıştır: %s
\%s: ortam değişkeni "=" içermemelidir
\%s: değişken ataması sırasında hata oluştu
\%s: "%s" fazla parametresi atlandı
\%s: zorunlu argüman eksik
\connect: %s \copy: parametre eksik
\copy: "%s" ifadesinde ayrıştırma hatası
\copy: satır sonunda ayrıştırma hatası
\crosstabview: belirsiz sütun adı: "%s"
\crosstabview: sütun adı bulunamadı: "%s"
\crosstabview: %d sütun numarası, 1..%d aralığının dışında
\crosstabview: sorgu üçten fazla sütun döndürüyorsa veri sütunu belirtilmelidir
\crosstabview: azami sütun sayısı (%d) aşılmıştır
\crosstabview: sorgu en az üç sütun döndürmelidir
\crosstabview: sorgu sonucu "%s" satırı, "%s" sütunu için çoklu veri değerleri içermektedir
\crosstabview: komut bir sonuç kümesi döndürmedi
\crostabview: dikey ve yatayda üstbilgiler farklı sütunlar olmalıdır
\df "w" seçeneğini %s sunucu sürümünde almaz
\df sadece [antwS+] seçeneklerini alır
\pset: izin verilen Unicode kenar çizgi biçimleri single, double
\pset: izin verilen Unicode sütun çizgi biçimleri: single, double
\pset: izin verilen Unicode üst bilgi çizgi biçimleri: single, double
\pset: izin verilen biçimler: unaligned, aligned, wrapped, html, asciidoc, latex, latex-longtable, troff-ms
\pset: izin verilen çizgi biçimleri: ascii, old-ascii, unicode
\pset: bilinmeyen seçenek: %s
\watch COPY ile birlikte kullanılamaz
\watch boş bir sorgu ile kullanılamaz
aktif transcation'ı iptal et okuma hatası nedeniyle kesildi erişim_yöntemi_tipi hareket top(agg) aggregate_adı aggregate_imzası takma ad hizalama daima analiz_fonksiyonu ve aggregate_imzası şu şekilde olabilir: ve çakışma_eylemi aşağıdakilerden birisi olabilir: ve grouplama-elemanı aşağıdakilerden birisi olabilir: like_seçeneği şu olabilir: ve with_sorgusu : arg_veri_tipi arg_adı bağımsız_değişken_tipi bağımsız değişken adı bağımsız değişken bağımsız_değişken_tipi argümanlar özellik özellik_adı özellik_seçeneği boolean önbellek call_handler daha önce two-phase commit için hazırlanmış transaction'u iptal et kullanıcı tarafından iptal edildi null pointer duplicate edilemiyor (iç hata)
aktif bağlantı olmadan vazgeçilemez (escape)
canonical_fonksiyon category veritabanını değiştir veritabanı dolünü değiştir çalışma zamanı parametresini değiştir sunucu yapılandırma parametresi değiştir üyeliği veya rol adını değiştir karşılaştırma (collation) tanımını değiştir bir dönüşümün tanımını değiştir domain tanımını değiştir foreign server tanımını değiştir uzak (foreign) tablo tanımını değiştir foreign-data wrapper tanımını değiştir fonksiyon tanımını değiştir büyük nesne tanımını değiştir maddileştirilmiş görünüm (materialized view) tanımını değiştir yordamsal dilinin tanımını değiştir satır seviyesi güvenlik ilkesi tanımını değiştir kural tanımını değiştir şema tanımını değiştir sequence üretecinin tanımını değiştir tablonun tanımını değiştir tablespace tanımını değiştir metin arama yapılandırmasının tanımını değiştir metin arama sözlüğünün tanımını değiştir metin arama ayrıştırıcısının tanımını değiştir metin arama şablonunun tanımını değiştir trigger tanımını değiştir type tanımını değiştir kullanıcı haritalama tanımını değiştir view tanımını değiştir aggregate fonksiyonunun tanımını değiştir olay tetikleyici tanımını değiştir uzantı tanımını değiştir index tanımını değiştir operatör tanımını değiştir operatör sınıfının tanımını değiştir operatör ailesinin tanımını değiştir veritabanı rolünün sahip olduğu nesnelerinin sahipliğini değiştir kanal check_ifadesi alt süreç %d çıkış koduyla sonuçlandırılmıştır alt süreç %d bilinmeyen durumu ile sonlandırılmıştır alt süreç 0x%X exception tarafından sonlandırılmıştır alt süreç %d sinyali tarafından sonlandırılmıştır alt süreç %s sinyali tarafından sonlandırılmıştır cursor'u kapat indexe dayanarak tabloyu cluster işlemine tabi tut kod sıralanabilir sırala (collate) %s sıralama (collation) database hakkında istatistikleri topla kolon_takma_adı kolon_kısıtlaması kolon_tanımı sütun_adı kolon_tipi com_op komıt komut çalıştırılabilir değil komut bulunamadı daha önce two-phase commit için hazırlanmış transaction'u commit et geçerli transaction'u commit et compute a set of rows şart yapılandırma_parametresi çakışma_eylemi çakışma_hedefi sunucuya bağlantı kesildi
kısıtlama %kısıtlama_adı dosya ile veritabanı tablosu arasında veriyi transfer et çalışma dizini "%s" olarak değiştirilemedi: %s dış komuta doğru olan pipe kapatılamadı: %s
"%s" komutu yürütülemedi: %s
"%s" çalıştırmak için bulunamadı %ld kullanıcı ID'si için home dizinine ulaşılamamıştır: %s
geçerli dizin tespit edilemedi: %s geçici dizin bulunamıyor: %s
geçerli kullanıcı ID si bulunamadı %ld: %s "%s" geçici dosya açılamıyor: %s
reloptions dizisi (array) ayrıştırılamadı
"%s" ikili (binary) dosyası okunamadı girdi dosyasından okunamadı: %s
symbolic link "%s" okuma hatası İşlem geçmişi "%s" dosyasına kaydedilemiyor: %s
"%s" değişkeni atanamıyor
/bin/sh başlatılamıyor
"%s" metin düzenleyicisi çalıştırılamadı
"%s" dosyasının durumu görüntülenemedi (stat): %s
COPY verisi yazılamadı: %s
toplam sayı yeni veritabanı oluştur tabloda yeni satırları ekliyor imleç_adı veri_tipi veritabanı_adı deallocate a prepared statement öntanımlı öntanımlı %s öntanımlı ifade cursor tanımla yeni erişim yöntemi tanımla yeni aggregate fonksiyonunu tanımla yeni cast tanımla yeni karşılaştırma (collation) tanımla yeni veri tipi tanımla yeni veritabanı rolü tanımla yeni domaın tanımla yeni kodlama dönüşümü tanımla yeni olay tetikleyici tanımla yeni foreign sunucu tanımla yeni uzak (foreign) tablo tanımla yeni foreign-data wrapper tanımla yeni fonksiyonu tanımla yeni indeks tanımla bir foreign sunucuya yeni kullanıcı haritalamasını tanımla yeni maddileştirilmiş görünüm (materialized view) tanımla yeni operator tanımla yeni operator class tanımla yeni operatör ailesini tanımla yeni yordamsal dil tanımla yeni rewriter rule tanımla bir tablo için yeni satır-seviyesi güvenlik ilkesi tanımla geerli transaction içinde savepoint tanımla yeni şema tanımla yeni sequence generator tanımla yeni tablo tanımla sorgu sonuçlarından yeni tablo tanımla yeni tablespace tanımla yeni metin arama yapılandırması tanımla yeni metin arama sözlüğü tanımla yeni metin arama ayrıştırıcısı tanımla yeni metin arama şablonu tanımla yeni bir dönüşüm (transform) tanımla yeni trigger tanımla yeni vew tanımla erişim haklarını tanımla varsayılan erişim haklarını tanımla bir nesneye uygulanan güvenlik etiketini tanımla ya da değiştir Nesne yorumunu tanımla ya da değiştir tanımlayıcı tanımı sil (delete) tablodan satırları sil sınırlayıcı ayrıştırıcı_karaktersi hedef_dil kodlaması önceki tanımlanmış savepoint'i kaldır sözlük_adı yön dizin devre dışı bırakılmış oturum bilgileri unut alan kısıtlaması (domain constraint) alan(domain)_kısıtlaması domain_adı öğe bir veya birden fazla tabloyu kısalt etkin dil kodlaması dil_kodlaması end_fonksiyonu bir satır numarası belirtmek için PSQL_EDITOR_LINENUMBER_ARG çevresel değişkenini ayarlamanız gereklidir
escape_karakteri olay exclude_element hazırlanmış komutu çalıştır bir anonim kod bloğu çalıştır execution_cost mevcut_sıralama mevcut_enum_değeri ifade uzantı_adı family_name fdw_adı ffunc dosyaadı filtre_değişkeni "%s.%s" tablosu için transaction checkpoint'i gerçekleştir uzak (foreign) tablosu biçim(format)_adı from_item from_listesi fonksiyon fonksiyon adı gerekli
fonksiyon_adı Veritabanındaki çöpleri-toparla ve veritabanını (tercihe başlı) analiz et bildiri üret grup_adı gruplama_öğesi işleyici_fonksiyon bu kurulum işlem geçmişini desteklemiyor
durağan uzak sunucudan (foreign server) tablo tanımlarını al in assignment artım indeks indeks_sütun_adı indeks_ifadesi index_yöntemi index_adı indeks_parametreleri UNIQUE, PRIMARY KEY ve EXCLUDE kısıtlamalarında index_parametreleri şunlar olabilir: index_yüklemi ilkendirme_fonksiyonu ilk_durum inline_handler giriş_fonksiyonu ekle (insert) bir uzantı kur tamsayı internallength geçersiz ikili (binary) "%s" geçersiz komut \%s
Geçersiz satır numarası: %s
geçersiz çıktı biçimi (iç hata): %d çağıran join_sütunu join_şartı join_proc join_tipi etiket dil_adı büyük_nesne_oid lc_collate lc_ctype sol_argüman_veri_tipi lexize_fonksiyonu lextypes_fonksiyonu like-seçeneği like_type link_sembolü bildiri bekleme durumuna geç shared library dosyası yükle yerel soket yerel_şema yerel ayar tabloyu kilitle kilitleme modu büyük nesne OID'i maddileştirilmiş görünüm(materialized view) en yüksek değer üye_nesnesi yöntem mffunc en düşük değer en düşük değer fonksiyonu (minvfunc) \gset için birden fazla satır döndü
mstate_veri_boyutu mstate_veri_tipi ad neg_op yeni_özellik_adı yeni_sütun_adı yeni_kısıtlama_adı yeni_sözlük yeni_enum_değeri yeni_adı yeni_sahibi yeni_rol yeni_şema yeni_tablo yeni_tablespace yeni_sürüm hayır sorgu tamponu mevcut değil
\gset için hiç bir satır dönmedi
normal Null değil null_dizi obj_file nesne_adı kapalı eski_sözlük eski_rol eski_sürüm açık operatör_tipi opclass operatör operatör sınıfı operatör ailesi operatör_adı seçenek ya da eski sözdizimi yetersiz bellek yetersiz bellek
çıktı_ifadesi çıktı_fonksiyonu output_name değişken üst_tablo ayrıştırıcı_adı parola yük (payload) pclose başarısız oldu: %s ilke(policy)_adı cursor'u yereştir tercih edilen çalıştırmak için sorguyu hazırla geçerli transaction'u two-phase commit için hazırla birincil anahtar, sağlayıcı psql PostgreSQL'in etkilişimli arayüzüdür.
psql değişkenleri:
sorgu quote_karakteri indeksleri yeniden oluştur alma_fonksiyonu referans kolonu referans tablosu nesne_adı uzak_şema cast kaldır karşılaştırma (collation) kaldır conversion kaldır veri tipi kaldır veritabanını kaldır veritabanı rolünü kaldır domain kaldır foreign sunucu tanımını kaldır uzak (foreign) tablo kaldır foreign-data wrapper'ını kaldır function kaldır maddileştirilmiş görünüm (materialized view) kaldır yordamsal dili kaldır rewrite rule kaldır tablodan satır seviyesi güvenlik ilkesi kaldır şema kaldır sequence kaldır tablo kaldır tablespace kaldır metin arama yapılandırmasını kaldır biri metin arama sözlüğünü kaldır bir metin arama ayrıştırıcısını kaldır bir metin arama şablonunu kaldır dönüşüm (transform) kaldır trigger kaldır bir foreign sunucu için kullanıcı haritalamasını kaldır view kaldır erişim hakkını kaldır bir erişim yöntemini kaldır aggregate function'u kaldır olay tetikleyici kaldır uzantı kaldır indeks kaldır opeartor kaldır operator class kaldır opeartör ailesini kaldır veritabanı rolüne ait veritabanı nesneleri kaldır bir maddileştirilmiş görünümün (materialized view) içeriğini değiştir replika res_proc yeniden başlat çalıştırma zamanı parametresini öntanımlı değerine getir kısıtlı sonuç_satırları cursor kullanarak sorgunun sonucundan satırları getir tablo ya da view'dan satırları getir dönüş tipi rewrite_kural_adı sağ_argüman_veri_tipi rol_adı rol_tanımlaması savepoint'a rollback rule kural_adı güvenli örnekleme_yöntemi savepoint_adı şema_elemanı şema_adı başlangıç değeri select gönderme_fonksiyonu sequence sequence_adı sunucu_adı sunucu_tipi sunucu_sürümü geçerli işlem (transaction) için kısıtlama doğrulama biçimini belirle geçerli transcation'ın karakteristiklerini ayarla geçerli oturumun geçerli kullanıcısını tanımla ilk oturum ve geçerli oturum için kullanıcı tanımla sfunc sorgunun execution planını göster çalıştırma zaman parametresinın değerini göster "%s" değişkeninin özyinelemeli genişlemesi (recursive expansion) atlanıyor
snapshot_id sort_ifadesi sıralama_family_adı source_config kaynak_dil kodlaması kaynak_tablo kaynak_tipi özel kararlı başlat transaction bloğunu başlat başlangıç_fonksiyonu state_veri_boyutu state_veri_tipi ifade bildiriyi beklemeyi durdur saklama saklama_parametresi saklama_tipi strateji_sayısı alt-SELECT alttip alttip_operatör_sınıfı destek_numarası sekme tamamlama sorgusu başarısız oldu: %s
Sorgu şudur:
%s
tablo tablo kısıtlaması (constraint) tablo_kısıtlaması tablo_adı tablespace_adı tablespace_seçeneği hedef_rol hedef_tipi şablon metin timestamp saat dilimi token_tipi işlem(transaction)_id transaction_modu tetikleyici (trigger) tetikleyici_adı copy modundan çıkmaya çalışıyor tip type_modifier_input_function type_modifier_output_function tip_adı kullanıcı numarası beklenmeyen PQresultStatus: %d
\watch için beklenmedik sonuç durumu
beklenmeyen işlem (transaction) durumu (%d)
tekil, bilinmeyen "%2$s" için tanınmayan değer "%1$s" :"%3$s" varsayılan
güvensiz sonuçlandırılmamış tırnakla sınırlandırılmış dizgi
güncelle (update) tablodaki satırları güncelle kullanıcı mevcut değil kullanıcı adı arama başarısız: hata kodu %lu kullanıcı_adı using_ifadesi using_list valfunction doğrulayıcı_fonksiyon değer değerler sürüm view görünüm (view) adı gerekli
seçenek_adı_görüntüle seçenek_değeri_görüntüle oynaklık hareket aşağıdakilerden birisi olabilir: aggregate_imzası şu şekilde olabilir: kolon_kısıtlaması aşağıdakilerden birisi olabilir: çakışma_hedefi aşağıdakilerden birisi olabilir: kısıtlama şu şekilde olabilir: yön boş ya da şunlardan biri olabilir: olay aşağıdakilerden birisi olabilir: from_öğesi şunlardan biri olabilir kilitleme modu şunlardan biri olabilir: üye_nesnesi şöyle olabilir: seçenek aşağıdakilerden birisi olabilir: seçenek şunlar olabilir: rol tanımlaması şunlar olabilir: transaction_modu aşağıdakilerden birisi olabilir: pencere window_tanımı pencere_adı with_sorgusu with_sorgu_adı evet locale/ta/LC_MESSAGES/pg_config-9.6.mo 0000644 00000023402 14751153420 0013001 0 ustar 00 �� , | ; � � E � 0 @ : V E � I � L ! s n K � = . 2 l i � G J Q M � ? � G * > r 6 � < � > % F d P � I � 4 F
* {
�
�
, �
& �
& & 0 M . ~ ) � ) � " $ ( E n ! � �
� � � � � � \ � } � " � � � � � � f � 2 � � � X � H � � � � � � D � � � { ? � � � b � � � d � � * = � � ~ ! j �! �! � " � �" � # j �# j $ Y s$ � �$ j [% U �% f & 9 �& D �& " , '
! *
$ & + ( # ) %
%s provides information about the installed version of PostgreSQL.
With no arguments, all known items are shown.
%s [ OPTION ... ]
--bindir show location of user executables
--cc show CC value used when PostgreSQL was built
--cflags show CFLAGS value used when PostgreSQL was built
--cflags_sl show CFLAGS_SL value used when PostgreSQL was built
--configure show options given to "configure" script when
PostgreSQL was built
--cppflags show CPPFLAGS value used when PostgreSQL was built
--docdir show location of documentation files
--help show this help, then exit
--includedir show location of C header files of the client
interfaces
--includedir-server show location of C header files for the server
--ldflags show LDFLAGS value used when PostgreSQL was built
--ldflags_sl show LDFLAGS_SL value used when PostgreSQL was built
--libdir show location of object code libraries
--libs show LIBS value used when PostgreSQL was built
--localedir show location of locale support files
--mandir show location of manual pages
--pgxs show location of extension makefile
--pkgincludedir show location of other C header files
--pkglibdir show location of dynamically loadable modules
--sharedir show location of architecture-independent support files
--sysconfdir show location of system-wide configuration files
--version show the PostgreSQL version
%s: could not find own program executable
%s: invalid argument: %s
Options:
Report bugs to <pgsql-bugs@postgresql.org>.
Try "%s --help" for more information.
Usage:
child process exited with exit code %d child process exited with unrecognized status %d child process was terminated by exception 0x%X child process was terminated by signal %d child process was terminated by signal %s could not change directory to "%s" could not find a "%s" to execute could not identify current directory: %s could not read binary "%s" could not read symbolic link "%s" invalid binary "%s" not recorded
Project-Id-Version: போஸ்ட்கிரெஸ் தமிழாக்கக் குழு
Report-Msgid-Bugs-To:
POT-Creation-Date: 2007-09-22 03:19-0300
PO-Revision-Date: 2013-09-04 22:09-0400
Last-Translator: ஆமாச்சு <amachu@ubuntu.com>
Language-Team: தமிழ் <ubuntu-l10n-tam@lists.ubuntu.com>
Language: ta
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: 8bit
X-Poedit-Language: Tamil
X-Poedit-Country: INDIA
X-Poedit-SourceCharset: utf-8
%s நிறுவப் பட்டுள்ள போஸ்ட்கிரெஸ் வெள்யீடு குறித்தத் தகவலைத் தருகிறது.
ஊட்டமேதுமில்லாத வாறே, அறியப் படும் அனைத்து பாகங்களும் திரையிடப்படுகினறன.
%s [ தேர்வு ... ]
--bindir பயனரால் இயக்க வல்வனவற்றின் இருப்பிடத்தைக் காட்டுக
--cc PostgreSQL கட்டமைக்கப்பட்ட போது பயன்படுத்தப் பட்ட CC மதிப்பைக் காட்டுக
--cflags PostgreSQL கட்டமைக்கப்பட்ட போது பயன்படுத்தப் பட்ட CFLAGS மதிப்பைக் காட்டுக
--cflags_sl PostgreSQL கட்டமைக்கப்பட்ட போது பயன்படுத்தப் பட்ட CFLAGS_SL மதிப்பைக் காட்டுக
--configure PostgreSQL கட்டமைக்கப்பட்ட போது
"configure" க்கு கொடுக்கப் பட்டத் தேர்வுகளைக் காட்டவும்
--cppflags PostgreSQL கட்டமைக்கப்பட்ட போது பயன்படுத்தப் பட்ட CPPFLAGS மதிப்பைக் காட்டுக
--docdir ஆவணமாக்கக் கோப்புக்களின் இருப்பிடத்தைக்காட்டுக
--help இவ்வுதவியினைக் காட்டிய பின் வெளிவரவும்
--includedir வாங்கிக்கான C முதற் கோப்புகளின் இருப்பிடத்தைக் காட்டுக
இடைமுகப்புகள்
--includedir-server வழங்கிக்கான C முதற் கோப்புக்களின் இருப்பிடத்தினைக் காட்டுக
--ldflags PostgreSQL கட்டமைக்கப்பட்ட போது பயன்படுத்தப் பட்ட LDFLAGS மதிப்பைக் காட்டுக
--ldflags_sl PostgreSQL கட்டமைக்கப்பட்ட போது பயன்படுத்தப் பட்ட LDFLAGS_SL மதிப்பினைக் காட்டுக
--libdir பொருள் நிரல் நிரலகங்களின் இருப்பிடத்தைக் காட்டுக
--libs PostgreSQL கட்டமைக்கப்பட்ட போது பயன்படுத்தப் பட்ட LIBS மதிப்பைக் காட்டுக
--localedir அக ஆதரவுக் கோப்புக்களின் இருப்பிடத்தினைக் காட்டுக
--mandir உதவிப் பக்கங்களின் இருப்பிடத்தைக் காட்டுக
--pgxs makefile விரிவின் இருப்பிடத்தைக் காட்டுக
--pkgincludedir ஏனைய C முதற் கோப்புக்களின் இருப்பிடத்தினைக் காட்டுக
--pkglibdir அவ்வப்பொழுது மாற வல்ல பாகங்களின் இருப்பிடத்தைக் காட்டுக
--sharedir வடிவமைப்பைச் சாராத ஆதரவுக் கோப்புகளின் இருப்பிடத்தினைக் காட்டுக
--sysconfdir மொத்த அமைப்பிற்கான வடிவமைப்புக் கோப்புக்களின் இருப்பிடத்தைக் காட்டவும்
--version PostgreSQL வெளியீட்டினைக் காட்டுக
%s: தானாக இயக்க வல்ல நிரலைக் கண்டுபிடிக்க இயலவில்லை
%s: செல்லத்தகாத ஊட்டம்: %s
தேர்வு:
<pgsql-bugs@postgresql.org> க்கு வழுக்களைத் தெரியப் படுத்தவும்.
மேலும் தகவல்களைப் பெற "%s --help" கொடுக்கவும்
பயனளவு:
துணைச் செயல் வெளியேற்றக் குறியீடு %d உடன் வெளி வந்தது இனம்புரியாத நிலை %d யால் துணைச் செயல் வெளிவந்தது துணைச் செயல் 0x%X விதிவிலக்கின் காரணமாக தடைப் பட்டது துணைச் செயல் %d சமிக்ஞையால் தடைப் பட்டது துணைச் செயல் %s சமிக்ஞையால் தடைப் பட்டது அடைவினை "%s" க்கு மாற்ற முடியவில்லை இயக்கும் பொருட்டு "%s" ஒன்றினைக் கண்டெடுக்க இயலவில்லை தற்போதைய அடைவினை இனங்கான முடியவில்லை: %s இருமத்தினை வாசிக்க இயலவில்லை "%s" அடையாள இணைப்பு "%s" னை வாசிக்க இயலவில்லை செல்லத்தகாத இருமம் "%s" பதிவுச் செய்யப்படவில்லை
locale/pt_BR/LC_MESSAGES/pg_dump-9.6.mo 0000644 00000173612 14751153421 0013115 0 ustar 00 �� � d � � �( �( �( X
) [ c) B �) ) * " ,* x O* �* �* �* �* A + N V+ P �+ I �+ 3 @, y t, G �, C 6- N z- K �- v . F �. > �. R / B e/ E �/ ? �/ L .0 3 {0 6 �0 Q �0 T 81 M �1 ? �1 � 2 � �2 ? b3 9 �3 5 �3 : 4 K M4 B �4 D �4 � !5 3 �5 � �5 ? X6 D �6 x �6 6 V7 Q �7 O �7 F /8 > v8 5 �8 > �8 E *9 A p9 O �9 H : B K: @ �: = �: O
; H ]; ; �; , �; 4 < E D< 0 �< = �< , �< F &= D m= C �= F �= 8 => ? v> C �> = �> 4 8? 7 m? L �? = �? @ 0@ J q@ < �@ L �@ , FA ( sA 5 �A E �A T B mB 9 pB D �B G �B 7C RC ? mC ' �C + �C e D ! gD , �D 4 �D 6 �D ( "E / KE {E �E $ �E * �E 2 �E B .F > qF J �F P �F N LG H �G - �G H 'H / :H jH 4 |H $ �H & �H * �H # (I LI P kI C �I A J ( BJ kJ �J �J �J = �J � K
�K , �K � �K � uL , M 8M p MM e �M & $N KN ` SN p �N 4 %O X ZO _ �O E P 1 YP 6 �P 4 �P * �P - "Q D PQ . �Q + �Q + �Q ) R * FR > qR : �R ' �R = S ) QS 1 {S �S @ �S 7 T 6 AT 6 xT < �T = �T 4 *U 3 _U b �U 9 �U < 0V t mV # �V , W 5 3W iW �W �W
�W ' �W �W % �W X / <X X lX & �X 0 �X . Y ) LY ) vY �Y �Y �Y 3 �Y ( Z 2Z ) EZ # oZ �Z �Z & �Z K �Z & B[ i[ ! �[ ( �[ ' �[ �[ # \ =\ / ]\ �\ �\ # �\ % �\ ] , 1] $ ^] $ �] $ �] 6 �] ^ ^ B =^ � �^ � _ �_ $ �_ < �_ 3 (` ' \` ' �` + �` ( �` ( a # *a - Na � |a + Lb , xb ! �b & �b ' �b # c :c " Yc 8 |c $ �c �c �c Q d & kd a �d @ �d 5 5e ke " �e # �e , �e �e ! f # ;f * _f # �f % �f 0 �f & g $ ,g Qg " pg = �g # �g 1 �g 'h 9h Nh : ^h ) �h B �h P i Wi ji �i �i " �i �i �i & j & 5j % \j 2 �j �j �j & �j !
k ) /k # Yk " }k �k r �k < $l D al N �l F �l <m [m |m & �m , �m - �m n " 2n / Un �n �n ( �n @ �n $o =o \o P wo �o > �o 1 p > Op / �p Y �p > q Wq rq " �q �q & �q < �q 4r ' Hr ( pr ' �r �r �r �r 1 s + ;s gs % �s 3 �s �s �s " t ; 7t st �t 0 �t �t / �t "u Au ^u . wu I �u > �u D /v tv �v �v 7 �v 9 �v 6 $w H [w @ �w �w 3 �w & +x 0 Rx 6 �x / �x ( �x , y @y " Oy ry �y �y h �y T 'z � |z 6 �z L 6{ J �{ 9 �{ | $ | + <| h| }| �| �| �| 2 �| } " "} E} \} # n} �} �} / �} �} & ~ /~ C~ # U~ y~ $ �~ ) �~ �~ ! �~ % + E q & � ' � � � 0 � . N� ) }� + �� Ӏ � 4
� � B� # Ł * � � 0� F� ( \� �� " �� �� E Ԃ # � >� V� n� ; u� �� ǃ ԃ ' � � ' 0� X� % x� �� �� B ׄ 0 � ! K� 8 m� : �� � �� 3 � 1 P� 1 �� + �� $ � $ � h *� � �� Q� i� Q |� b Ή M 1� / � ) �� � ي `� f� y� �� O �� \ � f _� a ƌ @ (� � i� S �� @ Q� b �� U �� z K� R Ə X � ] r� G А M � D f� i �� J � C `� Z �� ] �� U ]� M �� � � � �� D ]� ; �� 7 ޕ ? � j V� L �� ] � � l� ? �� � :� J �� J � x T� > ͙ Y � S f� g �� I "� = l� P �� M �� I I� I �� O ݜ F -� I t� N �� [
� \ i� < ƞ 8 � ? <� L |� 9 ɟ G � 5 K� U �� \ נ Q 4� T �� L ۡ : (� F c� M �� C �� J <� Z �� H � K +� R w� L ʤ Z � = r� + �� 0 ܥ I
� ^ W� �� G �� V � V X� �� ʧ S � / 9� 3 i� ~ �� + � 2 H� = {� 9 �� 2 � < &� $ c� �� + �� / Ǫ 2 �� J *� F u� R �� X � V h� Q �� 6 � H� `� 7 v� �� = í ' � + )� 0 U� % �� �� t ͮ C B� A �� + ȯ � � )� ?� L W� � �� 9� , A� � n� � � = Ų � | � m �� 7 � 9� t ?� q �� A &� _ h� m ȵ G 6� 3 ~� 8 �� 1 � - � 0 K� C |� 0 �� - � - � + M� , y� D �� A � 1 -� H _� 1 �� 5 ڹ � A +� 6 m� 2 �� 2 >
� @ I� 1 �� 0 �� f � 9 T� @ �� � ϼ ) \� < �� @ ý � & %�
L� W� & g� �� 0 �� ' Ѿ 0 �� Z *� 0 �� 2 �� 0 � * � * E� p� �� �� / �� 6 � � 5 )� 0 _� ' �� �� + � f �� ) f� " �� �� 0 �� ) � ' -� & U� ) |� : �� ( ��
� * (� 1 S� �� - �� % �� % �� $ � 8 D� }� , �� T �� � � � �� ) �� 6 �� A �� ? 6� + v� 9 �� ) �� 7 � + >� - j� 5 �� � �� 3 �� 2 �� & � . 6� - e� - �� ( �� % �� F � , W� ' �� % �� _ �� $ 2� o W� H �� : � K� # j� & �� 2 �� & �� # � + 3� 1 _� ( �� , �� 5 �� 4 � 0 R� " �� 6 �� A �� - � 2 M� �� �� �� = �� E �� ^ B� K �� �� ( � ,� L� % ]� �� $ �� ( �� ( �� ' � F @� " �� " �� / �� �� 0 � % O� $ u� �� � �� C A� Y �� d �� V D� % �� ' �� " �� @ � > M� 2 �� " �� % �� 1 � :� # S� ) w� P �� " �� $ � / :� b j� ! �� L �� 6 <� G s� ; �� Z �� A R� �� ! �� & �� �� < � : V� �� 8 �� 4 �� 1 � ( L� u� �� = �� 4 �� ' � 1 F� O x� �� �� ' �� H $� m� - �� ? �� - �� ? #� . c� ( �� ! �� . �� Q � F ^� M ��
�� * � ,� K @� G �� < �� [ � E m� �� 8 �� 0 �� > /� = n� 5 �� / �� 1 � D� $ T� y� �� �� } �� b F� � �� C D� e �� P �� C ?� �� * �� 9 �� �� � *� J� e� : w� �� ! �� �� �� 1 � M� k� @ �� �� + �� � � ! +� M� 1 h� 7 �� + �� * �� 2 )� < \� ( �� 4 �� 6 �� ) .� & X� ? � < �� < �� 7 9� $ q� �� ; �� �� % s� = �� ' �� �� � 8 6� ! o� �� �� X �� + � K� d�
}� B �� �� �� �� * � ! J� ) l� 2 �� < �� ! � (� L E� : �� ( �� H �� B ?� # �� ( �� 8 � 5 � 5 >� ; t� - �� , � ~ � � � t � � � � m � _ � � C � 8 � �
@ � n o x ! � � � � I � � � � 1 � & � a � a � � � � � � $ � ( � � ] � Y � � � j E 0 � � : � *
V � � q U � � J � � � - ! z � � � � Y � � � A � k � � � � � H e T � ) . � n D l � � � � � � 3 � � � � � � � � j � � � � � : � � � � � � r � � � 7 � I � � L v � � R � 2 � � � � < 2 � ? 4 ' � h � + � + � � � � � s g � � 1 y � w � - f � � v � � � 0
� m = � / � 6 ^ z O \ i X K � , ( � \ � � C � � � # � 5 � H � Q = � B J W ~ X � � � r E L 8 6 D x � [ N � � } 9 � c o p w h s � � F # ? q & p 9 � Z � � � � � d � ]
� � 5 7 F @ � � ~ � � � g y K { S � � , % � � B � � � � � S b > � R � � � P N . � ; � � � � � ` � u ) � � � � � � � | � � t b � O > l " � G { � � V Z % � / � � � � � � � � G � � Q 3 � [ � � " c � � � � f � ' < * � � � ` � P � _ ^ } T � � � $ W � � � � � M � � � ; � � | A e � d � U � � � 4 � u i � M � k �
Connection options:
General options:
If -f/--file is not used, then the SQL script will be written to the standard
output.
If no database name is supplied, then the PGDATABASE environment
variable value is used.
If no input file name is supplied, then standard input is used.
Options controlling the output content:
Options controlling the restore:
The options -I, -n, -P, -t, -T, and --section can be combined and specified
multiple times to select multiple objects.
%s
%s [OPTION]...
%s [OPTION]... [DBNAME]
%s [OPTION]... [FILE]
--binary-upgrade for use by upgrade utilities only
--column-inserts dump data as INSERT commands with column names
--disable-dollar-quoting disable dollar quoting, use SQL standard quoting
--disable-triggers disable triggers during data-only restore
--enable-row-security enable row security
--enable-row-security enable row security (dump only content user has
access to)
--exclude-table-data=TABLE do NOT dump data for the named table(s)
--if-exists use IF EXISTS when dropping objects
--inserts dump data as INSERT commands, rather than COPY
--lock-wait-timeout=TIMEOUT fail after waiting TIMEOUT for a table lock
--no-data-for-failed-tables do not restore data of tables that could not be
created
--no-security-labels do not dump security label assignments
--no-security-labels do not restore security labels
--no-synchronized-snapshots do not use synchronized snapshots in parallel jobs
--no-tablespaces do not dump tablespace assignments
--no-tablespaces do not restore tablespace assignments
--no-unlogged-table-data do not dump unlogged table data
--quote-all-identifiers quote all identifiers, even if not key words
--role=ROLENAME do SET ROLE before dump
--role=ROLENAME do SET ROLE before restore
--section=SECTION dump named section (pre-data, data, or post-data)
--section=SECTION restore named section (pre-data, data, or post-data)
--serializable-deferrable wait until the dump can run without anomalies
--snapshot=SNAPSHOT use given snapshot for the dump
--strict-names require table and/or schema include patterns to
match at least one entity each
--use-set-session-authorization
use SET SESSION AUTHORIZATION commands instead of
ALTER OWNER commands to set ownership
-1, --single-transaction restore as a single transaction
-?, --help show this help, then exit
-?, --help show this help, then exit
-C, --create create the target database
-C, --create include commands to create database in dump
-E, --encoding=ENCODING dump the data in encoding ENCODING
-F, --format=c|d|t backup file format (should be automatic)
-F, --format=c|d|t|p output file format (custom, directory, tar,
plain text (default))
-I, --index=NAME restore named index
-L, --use-list=FILENAME use table of contents from this file for
selecting/ordering output
-N, --exclude-schema=SCHEMA do NOT dump the named schema(s)
-O, --no-owner skip restoration of object ownership
-O, --no-owner skip restoration of object ownership in
plain-text format
-P, --function=NAME(args) restore named function
-S, --superuser=NAME superuser user name to use for disabling triggers
-S, --superuser=NAME superuser user name to use in plain-text format
-S, --superuser=NAME superuser user name to use in the dump
-T, --exclude-table=TABLE do NOT dump the named table(s)
-T, --trigger=NAME restore named trigger
-U, --username=NAME connect as specified database user
-V, --version output version information, then exit
-V, --version output version information, then exit
-W, --password force password prompt (should happen automatically)
-Z, --compress=0-9 compression level for compressed formats
-a, --data-only dump only the data, not the schema
-a, --data-only restore only the data, no schema
-b, --blobs include large objects in dump
-c, --clean clean (drop) database objects before recreating
-c, --clean clean (drop) databases before recreating
-d, --dbname=CONNSTR connect using connection string
-d, --dbname=DBNAME database to dump
-d, --dbname=NAME connect to database name
-e, --exit-on-error exit on error, default is to continue
-f, --file=FILENAME output file name
-f, --file=FILENAME output file or directory name
-f, --file=FILENAME output file name
-g, --globals-only dump only global objects, no databases
-h, --host=HOSTNAME database server host or socket directory
-j, --jobs=NUM use this many parallel jobs to dump
-j, --jobs=NUM use this many parallel jobs to restore
-l, --database=DBNAME alternative default database
-l, --list print summarized TOC of the archive
-n, --schema=NAME restore only objects in this schema
-n, --schema=SCHEMA dump the named schema(s) only
-o, --oids include OIDs in dump
-p, --port=PORT database server port number
-r, --roles-only dump only roles, no databases or tablespaces
-s, --schema-only dump only the schema, no data
-s, --schema-only restore only the schema, no data
-t, --table=NAME restore named relation (table, view, etc.)
-t, --table=TABLE dump the named table(s) only
-t, --tablespaces-only dump only tablespaces, no databases or roles
-v, --verbose verbose mode
-v, --verbose verbose mode
-w, --no-password never prompt for password
-x, --no-privileges do not dump privileges (grant/revoke)
-x, --no-privileges skip restoration of access privileges (grant/revoke)
%s %s dumps a database as a text file or to other formats.
%s extracts a PostgreSQL database cluster into an SQL script file.
%s restores a PostgreSQL database from an archive created by pg_dump.
%s: %s Command was: %s
%s: WSAStartup failed: %d
%s: cannot specify both --single-transaction and multiple jobs
%s: could not connect to database "%s"
%s: could not connect to database "%s": %s
%s: could not connect to databases "postgres" or "template1"
Please specify an alternative database.
%s: could not get server version
%s: could not open the output file "%s": %s
%s: could not parse ACL list (%s) for database "%s"
%s: could not parse ACL list (%s) for tablespace "%s"
%s: could not parse server version "%s"
%s: could not re-open the output file "%s": %s
%s: dumping database "%s"...
%s: executing %s
%s: invalid number of parallel jobs
%s: maximum number of parallel jobs is %d
%s: option --if-exists requires option -c/--clean
%s: options -c/--clean and -a/--data-only cannot be used together
%s: options -d/--dbname and -f/--file cannot be used together
%s: options -g/--globals-only and -r/--roles-only cannot be used together
%s: options -g/--globals-only and -t/--tablespaces-only cannot be used together
%s: options -r/--roles-only and -t/--tablespaces-only cannot be used together
%s: options -s/--schema-only and -a/--data-only cannot be used together
%s: pg_dump failed on database "%s", exiting
%s: query failed: %s %s: query was: %s
%s: role name starting with "pg_" skipped (%s)
%s: running "%s"
%s: too many command-line arguments (first is "%s")
%s: unrecognized section name: "%s"
(The INSERT command cannot set OIDs.)
(The system catalogs might be corrupted.)
-C and -1 are incompatible options
COPY failed for table "%s": %s Consider using a full dump instead of a --data-only dump to avoid this problem.
Dumping the contents of table "%s" failed: PQgetCopyData() failed.
Dumping the contents of table "%s" failed: PQgetResult() failed.
Error from TOC entry %d; %u %u %s %s %s
Error message from server: %s Error while FINALIZING:
Error while INITIALIZING:
Error while PROCESSING TOC:
Exported snapshots are not supported by this server version.
NOTICE: there are circular foreign-key constraints on this table:
NOTICE: there are circular foreign-key constraints among these tables:
Password: Report bugs to <pgsql-bugs@postgresql.org>.
Synchronized snapshots are not supported by this server version.
Run with --no-synchronized-snapshots instead if you do not need
synchronized snapshots.
Synchronized snapshots are not supported on standby servers.
Run with --no-synchronized-snapshots instead if you do not need
synchronized snapshots.
TOC Entry %s at %s (length %s, checksum %d)
The command was: %s
The program "pg_dump" is needed by %s but was not found in the
same directory as "%s".
Check your installation.
The program "pg_dump" was found by "%s"
but was not the same version as %s.
Check your installation.
Try "%s --help" for more information.
Usage:
WARNING: aggregate function %s could not be dumped correctly for this database version; ignored
WARNING: archive is compressed, but this installation does not support compression -- no data will be available
WARNING: archive items not in correct section order
WARNING: archive was made on a machine with larger integers, some operations might fail
WARNING: bogus transform definition, at least one of trffromsql and trftosql should be nonzero
WARNING: bogus value in pg_cast.castfunc or pg_cast.castmethod field
WARNING: bogus value in pg_cast.castmethod field
WARNING: bogus value in pg_transform.trffromsql field
WARNING: bogus value in pg_transform.trftosql field
WARNING: bogus value in proargmodes array
WARNING: could not find operator with OID %s
WARNING: could not find where to insert IF EXISTS in statement "%s"
WARNING: could not parse proallargtypes array
WARNING: could not parse proargmodes array
WARNING: could not parse proargnames array
WARNING: could not parse proconfig array
WARNING: could not parse reloptions array
WARNING: could not resolve dependency loop among these items:
WARNING: don't know how to set owner for object type "%s"
WARNING: errors ignored on restore: %d
WARNING: ftell mismatch with expected position -- ftell used
WARNING: invalid creation date in header
WARNING: invalid type "%c" of access method "%s"
WARNING: line ignored: %s
WARNING: owner of aggregate function "%s" appears to be invalid
WARNING: owner of data type "%s" appears to be invalid
WARNING: owner of function "%s" appears to be invalid
WARNING: owner of operator "%s" appears to be invalid
WARNING: owner of operator class "%s" appears to be invalid
WARNING: owner of operator family "%s" appears to be invalid
WARNING: owner of schema "%s" appears to be invalid
WARNING: owner of table "%s" appears to be invalid
WARNING: requested compression not available in this installation -- archive will be uncompressed
WARNING: typtype of data type "%s" appears to be invalid
WARNING: unexpected extra results during COPY of table "%s"
You might not be able to restore the dump without using --disable-triggers or temporarily dropping the constraints.
a worker process died unexpectedly
aborting because of server version mismatch
actual file length (%s) does not match expected (%s)
allocating AH for %s, format %d
already connected to a database
archiver archiver (db) attempting to ascertain archive format
bad dumpId
bad table dumpId for TABLE DATA item
can only reopen input archives
cannot duplicate null pointer (internal error)
cannot restore from compressed archive (compression not supported in this installation)
child process exited with exit code %d child process exited with unrecognized status %d child process was terminated by exception 0x%X child process was terminated by signal %d child process was terminated by signal %s command not executable command not found compress_io compression is not supported by tar archive format
compression level must be in range 0..9
compressor active
connecting to database "%s" as user "%s"
connecting to database for restore
connecting to new database "%s"
connection needs password
connection to database "%s" failed: %s corrupt tar header found in %s (expected %d, computed %d) file position %s
could not change directory to "%s": %s could not close TOC file: %s
could not close archive file: %s
could not close compression library: %s
could not close compression stream: %s
could not close data file: %s
could not close directory "%s": %s
could not close input file: %s
could not close large object TOC file "%s": %s
could not close output file: %s
could not close tar member
could not close temporary file: %s
could not commit database transaction could not compress data: %s
could not create communication channels: %s
could not create directory "%s": %s
could not create large object %u: %s could not create worker process: %s
could not determine seek position in archive file: %s
could not execute query could not find a "%s" to execute could not find block ID %d in archive -- possibly corrupt archive
could not find block ID %d in archive -- possibly due to out-of-order restore request, which cannot be handled due to lack of data offsets in archive
could not find block ID %d in archive -- possibly due to out-of-order restore request, which cannot be handled due to non-seekable input file
could not find entry for ID %d
could not find file "%s" in archive
could not find function definition for function with OID %u
could not find header for file "%s" in tar archive
could not find parent extension for %s
could not find slot of finished worker
could not generate temporary file name: %s
could not get server_version from libpq
could not identify current directory: %s could not identify dependency loop
could not initialize compression library: %s
could not obtain lock on relation "%s"
This usually means that someone requested an ACCESS EXCLUSIVE lock on the table after the pg_dump parent process had gotten the initial ACCESS SHARE lock on the table.
could not open TOC file "%s" for input: %s
could not open TOC file "%s" for output: %s
could not open TOC file "%s": %s
could not open TOC file for input: %s
could not open TOC file for output: %s
could not open input file "%s": %s
could not open input file: %s
could not open large object %u: %s could not open large object TOC file "%s" for input: %s
could not open output file "%s": %s
could not open output file: %s
could not open temporary file
could not parse GRANT ACL list (%s) or REVOKE ACL list (%s) for object "%s" (%s)
could not parse default ACL list (%s)
could not parse initial GRANT ACL list (%s) or initial REVOKE ACL list (%s) for object "%s" (%s)
could not parse numeric array "%s": invalid character in number
could not parse numeric array "%s": too many numbers
could not read binary "%s" could not read directory "%s": %s
could not read from input file: %s
could not read from input file: end of file
could not read input file: %s
could not read symbolic link "%s" could not reconnect to database: %s could not set default_tablespace to %s: %s could not set default_with_oids: %s could not set search_path to "%s": %s could not set seek position in archive file: %s
could not set session user to "%s": %s could not start database transaction could not uncompress data: %s
could not write to blobs TOC file
could not write to large object (result: %lu, expected: %lu)
could not write to output file: %s
could not write to the communication channel: %s
creating %s "%s"
creating %s "%s.%s"
custom archiver definition of view "%s" appears to be empty (length zero)
did not find magic string in file header
direct database connections are not supported in pre-1.3 archives
directory "%s" does not appear to be a valid archive ("toc.dat" does not exist)
directory archiver directory name too long: "%s"
disabling triggers for %s
dropping %s %s
dumping contents of table "%s.%s"
enabling triggers for %s
entering main parallel loop
entering restore_toc_entries_parallel
entering restore_toc_entries_postfork
entering restore_toc_entries_prefork
entry ID %d out of range -- perhaps a corrupt TOC
error during backup
error during file seek: %s
error processing a parallel work item
error reading large object %u: %s error reading large object TOC file "%s"
error returned by PQputCopyData: %s error returned by PQputCopyEnd: %s executing %s %s
expected %d check constraint on table "%s" but found %d
expected %d check constraints on table "%s" but found %d
expected format (%d) differs from format found in file (%d)
failed sanity check, parent OID %u of table "%s" (OID %u) not found
failed sanity check, parent table OID %u of pg_rewrite entry OID %u not found
failed sanity check, parent table OID %u of sequence OID %u not found
failed to connect to database
failed to reconnect to database
file name too long: "%s"
file offset in dump file is too large
finding check constraints for table "%s.%s"
finding default expressions of table "%s.%s"
finding extension tables
finding inheritance relationships
finding the columns and types of table "%s.%s"
finished item %d %s %s
finished main parallel loop
flagging inherited columns in subtables
found unexpected block ID (%d) when reading data -- expected %d
function "%s" not found
identifying extension members
implied data-only restore
incomplete tar header found (%lu byte)
incomplete tar header found (%lu bytes)
index "%s" not found
input file appears to be a text format dump. Please use psql.
input file does not appear to be a valid archive
input file does not appear to be a valid archive (too short?)
input file is too short (read %lu, expected 5)
internal error -- WriteData cannot be called outside the context of a DataDumper routine
internal error -- neither th nor fh specified in tarReadRaw()
invalid ENCODING item: %s
invalid OID for large object
invalid OID for large object (%u)
invalid STDSTRINGS item: %s
invalid adnum value %d for table "%s"
invalid argument string (%s) for trigger "%s" on table "%s"
invalid binary "%s" invalid client encoding "%s" specified
invalid column number %d for table "%s"
invalid column numbering in table "%s"
invalid compression code: %d
invalid dependency %d
invalid dumpId %d
invalid line in large object TOC file "%s": "%s"
invalid message received from worker: "%s"
invalid number of parallel jobs
invalid output format "%s" specified
large-object output not supported in chosen format
last built-in OID is %u
launching item %d %s %s
missing index for constraint "%s"
moving from position %s to next member at file position %s
no item ready
no matching schemas were found
no matching schemas were found for pattern "%s"
no matching tables were found
no matching tables were found for pattern "%s"
no output directory specified
not built with zlib support
now at file position %s
option --if-exists requires option -c/--clean
options --inserts/--column-inserts and -o/--oids cannot be used together
options -c/--clean and -a/--data-only cannot be used together
options -s/--schema-only and -a/--data-only cannot be used together
out of memory
out of on_exit_nicely slots
parallel archiver parallel backup only supported by the directory format
parallel restore from non-seekable file is not supported
parallel restore from standard input is not supported
parallel restore is not supported with archives made by pre-8.0 pg_dump
parallel restore is not supported with this archive file format
pclose failed: %s pgpipe: could not accept connection: error code %d
pgpipe: could not bind: error code %d
pgpipe: could not connect socket: error code %d
pgpipe: could not create second socket: error code %d
pgpipe: could not create socket: error code %d
pgpipe: could not listen: error code %d
pgpipe: getsockname() failed: error code %d
processing %s
processing data for table "%s.%s"
processing item %d %s %s
processing missed item %d %s %s
query failed: %s query produced null referenced table name for foreign key trigger "%s" on table "%s" (OID of table: %u)
query returned %d row instead of one: %s
query returned %d rows instead of one: %s
query to get data of sequence "%s" returned %d row (expected 1)
query to get data of sequence "%s" returned %d rows (expected 1)
query to get data of sequence "%s" returned name "%s"
query to get rule "%s" for table "%s" failed: wrong number of rows returned
query to obtain definition of view "%s" returned more than one definition
query to obtain definition of view "%s" returned no data
query was: %s
read TOC entry %d (ID %d) for %s %s
reading column info for interesting tables
reading constraints
reading default privileges
reading dependency data
reading event triggers
reading extensions
reading foreign key constraints for table "%s.%s"
reading indexes
reading indexes for table "%s.%s"
reading large objects
reading policies
reading policies for table "%s.%s"
reading procedural languages
reading rewrite rules
reading row security enabled for table "%s.%s"
reading schemas
reading table inheritance information
reading transforms
reading triggers
reading triggers for table "%s.%s"
reading type casts
reading user-defined access methods
reading user-defined aggregate functions
reading user-defined collations
reading user-defined conversions
reading user-defined foreign servers
reading user-defined foreign-data wrappers
reading user-defined functions
reading user-defined operator classes
reading user-defined operator families
reading user-defined operators
reading user-defined tables
reading user-defined text search configurations
reading user-defined text search dictionaries
reading user-defined text search parsers
reading user-defined text search templates
reading user-defined types
reducing dependencies for %d
restored %d large object
restored %d large objects
restoring data out of order is not supported in this archive format: "%s" is required, but comes before "%s" in the archive file.
restoring large object with OID %u
sanity check on integer size (%lu) failed
saving database definition
saving encoding = %s
saving large objects
saving standard_conforming_strings = %s
schema "%s" not found
schema with OID %u does not exist
select() failed: %s
server version must be at least 7.3 to use schema selection switches
server version: %s; %s version: %s
skipping item %d %s %s
skipping tar member %s
sorter table "%s" could not be created, will not restore its data
table "%s" not found
tar archiver this format cannot be read
transferring dependency %d -> %d to %d
trigger "%s" not found
unexpected COPY statement syntax: "%s"
unexpected data offset flag %d
unexpected policy command type: "%s"
unexpected section code %d
unexpected tgtype value: %d
unrecognized archive format "%s"; please specify "c", "d", or "t"
unrecognized command received from master: "%s"
unrecognized constraint type: %c
unrecognized data block type %d while restoring archive
unrecognized data block type (%d) while searching archive
unrecognized encoding "%s"
unrecognized file format "%d"
unrecognized object type in default privileges: %d
unrecognized proparallel value for function "%s"
unrecognized provolatile value for function "%s"
unsupported version (%d.%d) in file header
warning from original dump file: %s
worker process failed: exit code %d
wrote %lu byte of large object data (result = %lu)
wrote %lu bytes of large object data (result = %lu)
Project-Id-Version: PostgreSQL 9.6
Report-Msgid-Bugs-To: pgsql-bugs@postgresql.org
POT-Creation-Date: 2017-08-06 01:59-0300
PO-Revision-Date: 2005-10-04 23:16-0300
Last-Translator: Euler Taveira de Oliveira <euler@timbira.com>
Language-Team: Brazilian Portuguese <pgbr-dev@listas.postgresql.org.br>
Language: pt_BR
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Plural-Forms: nplurals=2; plural=(n>1);
Opções de conexão:
Opções gerais:
Se -f/--file não é utilizado, o script SQL será escrito na saída
padrão.
Se o nome da base de dados não for fornecido, a variável de ambiente
PGDATABASE é utilizada.
Se nenhum arquivo de entrada é fornecido, a entrada padrão é utilizada.
Opções que controlam a saída do conteúdo:
Opções que controlam a restauração:
As opções -I, -n, -P, -t, -T e --section podem ser combinadas e especificadas
múltiplas vezes para selecionar múltiplos objetos.
%s
%s [OPÇÃO]...
%s [OPÇÃO]... [NOMEBD]
%s [OPÇÃO]... [ARQUIVO]
--binary-upgrade usado somente por utilitários de atualização
--column-inserts copia dados utilizando comandos INSERT com nomes das colunas
--disable-dollar-quoting desabilita delimitação por cifrão, usa delimitadores do padrão SQL
--disable-triggers desabilita gatilhos durante a restauração do tipo somente dados
--enable-row-security habilita segurança de registros
--enable-row-security habilita segurança de registros (copia somente conteúdo
que usuário tenha acesso)
--exclude-table-data=TABELA NÃO copia os dados da(s) tabela(s) especificada(s)
--if-exists use IF EXISTS ao remover objetos
--inserts copia dados utilizando comandos INSERT, ao invés de comandos COPY
--lock-wait-timeout=TEMPO falha após esperar TEMPO por um travamento de tabela
--no-data-for-failed-tables não restaura dados de tabelas que não puderam ser
criadas
--no-security-labels não copia atribuições de rótulos de segurança
--no-security-labels não restaura as atribuições de rótulos de segurança
--no-synchronized-snapshots não utiliza instantâneos sincronizados em tarefas paralelas
--no-tablespaces não copia atribuições de tablespaces
--no-tablespaces não restaura as atribuições de tablespaces
--no-unlogged-table-data não copia dados de tabelas unlogged
--quote-all-identifiers todos os identificadores entre aspas, mesmo que não sejam palavras chave
--role=NOMEROLE executa SET ROLE antes da cópia de segurança
--role=NOMEROLE executa SET ROLE antes da restauração
--section=SEÇÃO copia seção especificada (pre-data, data ou post-data)
--section=SEÇÃO restaura seção especificada (pre-data, data ou post-data)
--serializable-deferrable espera até que a cópia seja executada sem anomalias
--snapshot=INSTANTÂNEO utiliza instantâneo informado para a cópia
--strict-names requer tabela e/ou esquema incluir padrões que
correspondem pelo menos a uma entidade de cada
--use-set-session-authorization
usa comandos SET SESSION AUTHORIZATION ao invés de
comandos ALTER OWNER para definir o dono
-1, --single-transaction restaura como uma transação única
-?, --help mostra essa ajuda e termina
-?, --help mostra essa ajuda e termina
-C, --create cria o banco de dados informado
-C, --create inclui comandos para criação dos bancos de dados na cópia de segurança
-E, --encoding=CODIFICAÇÃO copia dados na codificação CODIFICAÇÃO
-F, --format=c|d|t formato de arquivo de cópia de segurança (deve ser automático)
-F, --format=c|d|t|p formato do arquivo de saída (personalizado, diretório,
tar, texto (padrão))
-I, --index=NOME restaura o índice especificado
-L, --use-list=ARQUIVO usa tabela de conteúdo deste arquivo para
selecionar/ordenar saída
-N, --exclude-schema=ESQUEMA NÃO copia o(s) esquema(s) especificado(s)
-O, --no-owner ignora restauração dos donos dos objetos
-O, --no-owner ignora restauração do dono dos objetos
no formato texto
-P, --function=NOME(args) restaura função especificada
-S, --superuser=NOME nome do super-usuário usado para desabilitar os gatilhos
-S, --superuser=NOME nome de super-usuário a ser usado no formato texto
-S, --superuser=NOME especifica o nome do super-usuário a ser usado na cópia de segurança
-T, --exclude-table=TABELA NÃO copia a(s) tabela(s) especificada(s)
-T, --trigger=NOME restaura gatilho especificado
-U, --username=NOME conecta como usuário do banco de dados especificado
-V, --version mostra informação sobre a versão e termina
-V, --version mostra informação sobre a versão e termina
-W, --password pergunta senha (pode ocorrer automaticamente)
-Z, --compress=0-9 nível de compressão para formatos comprimidos
-a, --data-only copia somente os dados, não o esquema
-a, --data-only restaura somente os dados, não o esquema
-b, --blobs inclui objetos grandes na cópia de segurança
-c, --clean exclui (remove) bancos de dados antes de criá-lo novamente
-c, --clean exclui (remove) bancos de dados antes de criá-los novamente
-d, --dbname=TEXTO cadeia de caracteres de conexão
-d, --dbname=NOMEBD banco de dados a ser copiado
-d, --dbname=NOME conecta ao banco de dados informado
-e, --exit-on-error termina se houver erro, padrão é continuar
-f, --file=ARQUIVO nome do arquivo de saída
-f, --file=ARQUIVO nome do arquivo ou diretório de saída
-f, --file=ARQUIVO nome do arquivo de saída
-g, --globals-only copia somente objetos globais, e não bancos de dados
-h, --host=MÁQUINA máquina do servidor de banco de dados ou diretório do soquete
-j, --jobs=NUM use esse número de tarefas paralelas para copiar
-j, --jobs=NUM use esse número de tarefas paralelas para restaurar
-l, --database=NOMEBD especifica um banco de dados padrão alternativo
-l, --list mostra TOC resumido do arquivo
-n, --schema=NOME restaura somente objetos neste esquema
-n, --schema=ESQUEMA copia somente o(s) esquema(s) especificado(s)
-o, --oids inclui OIDs na cópia de segurança
-p, --port=PORTA número da porta do servidor de banco de dados
-r, --roles-only copia somente roles, e não bancos de dados ou tablespaces
-s, --schema-only copia somente o esquema, e não os dados
-s, --schema-only restaura somente o esquema, e não os dados
-t, --table=NOME restaura tabela especificada (tabela, visão, etc)
-t, --table=TABELA copia somente a(s) tabela(s) especificada(s)
-t, --tablespaces-only copia somente tablespaces, e não bancos de dados ou roles
-v, --verbose modo informações detalhadas
-v, --verbose modo de detalhe
-w, --no-password nunca pergunta senha
-x, --no-privileges não copia os privilégios (grant/revoke)
-x, --no-privileges ignora restauração dos privilégios de acesso (grant/revoke)
%s %s salva um banco de dados em um arquivo texto ou em outros formatos.
%s salva os bancos de dados de um agrupamento do PostgreSQL em um arquivo de script.
%s restaura um banco de dados PostgreSQL a partir de um arquivo criado pelo pg_dump.
%s: %s Comando foi: %s
%s: WSAStartup falhou: %d
%s: não pode especificar ambas opções --single-transaction e múltiplas tarefas
%s: não pôde conectar ao banco de dados "%s"
%s: não pôde conectar ao banco de dados "%s": %s
%s: não pôde se conectar aos bancos de dados "postgres" ou "template1"
Por favor especifique um banco de dados alternativo.
%s: não pôde obter a versão do servidor
%s: não pôde abrir o arquivo de saída "%s": %s
%s: não pôde validar lista ACL (%s) do banco de dados "%s"
%s: não pôde validar lista ACL (%s) da tablespace "%s"
%s: não pôde validar a versão do servidor "%s"
%s: não pôde abrir o arquivo de saída "%s" novamente: %s
%s: copiando banco de dados "%s"...
%s: executando %s
%s: número de tarefas paralelas inválido
%s: número máximo de tarefas paralelas é %d
%s: opção --if-exists requer opção -c/--clean
%s: opções -c/--clean e -a/--data-only não podem ser utilizadas juntas
%s: opções -d/--dbname e -f/--file não podem ser utilizadas juntas
%s: opções -g/--globals-only e -r/--roles-only não podem ser utilizadas juntas
%s: opções -g/--globals-only e -t/--tablespaces-only não podem ser utilizadas juntas
%s: opções -r/--roles-only e -t/--tablespaces-only não podem ser utilizadas juntas
%s: opções -s/--schema-only e -a/--data-only não podem ser utilizadas juntas
%s: pg_dump falhou no banco de dados "%s", terminando
%s: consulta falhou: %s %s: consulta foi: %s
%s: nome de role iniciando com "pg_" foi ignorada (%s)
%s: executando "%s"
%s: muitos argumentos de linha de comando (primeiro é "%s")
%s: nome de seção desconhecido: "%s"
(O comando INSERT não pode definir OIDs.)
(O catálogo do sistema pode estar corrompido).
-C e -1 são opções incompatíveis
COPY falhou para tabela "%s": %s Considere utilizar uma cópia de segurança completa ao invés de cópia com --data-only para evitar este problema.
Cópia do conteúdo da tabela "%s" falhou: PQgetCopyData() falhou.
Cópia do conteúdo da tabela "%s" falhou: PQgetResult() falhou.
Erro no registro do TOC %d; %u %u %s %s %s
Mensagem de erro do servidor: %s Erro ao FINALIZAR:
Erro ao INICIALIZAR:
Erro ao PROCESSAR TOC:
Instantâneos exportados não são suportados por esta versão do servidor.
NOTA: há restrições de chave estrangeiras circulares nessa tabela:
NOTA: há restrições de chave estrangeiras circulares entre essas tabelas:
Senha: Relate erros a <pgsql-bugs@postgresql.org>.
Instantâneos sincronizados não são suportados por esta versão do servidor.
Execute com --no-synchronized-snapshots se você não precisa de
instantâneos sincronizados.
Instantâneos sincronizados não são suportados em servidores em espera.
Execute com --no-synchronized-snapshots se você não precisa de
instantâneos sincronizados.
Registro TOC %s em %s (tamanho %s, soma de verificação %d)
O comando foi: %s
O programa "pg_dump" é requerido pelo %s mas não foi encontrado no
mesmo diretório que "%s".
Verifique sua instalação.
O programa "pg_dump" é requerido pelo "%s"
mas não tem a mesma versão que %s.
Verifique sua instalação.
Tente "%s --help" para obter informações adicionais.
Uso:
AVISO: função de agregação %s não pôde ser copiada corretamente para esta versão do banco de dados; ignorado
AVISO: arquivo está comprimido, mas esta instalação não suporta compressão -- nenhum dado está disponível
AVISO: itens do archive não estão na ordem correta de seções
AVISO: arquivo foi feito em uma máquina com inteiros longos, algumas operações podem falhar
AVISO: definição de transformação inválida, pelo menos um dos trffromsql e trftosql não devem ser zero
AVISO: valor inválido no campo pg_cast.castfunc ou pg_cast.castmethod
AVISO: valor inválido no campo pg_cast.castmethod
AVISO: valor inválido no campo pg_transform.trffromsql
AVISO: valor inválido no campo pg_cast.trftosql
AVISO: valor inválido na matriz proargmodes
AVISO: não pôde encontrar operador com OID %s
AVISO: não pôde encontrar onde inserir IF EXISTS no comando "%s"
AVISO: não pôde validar matriz proallargtypes
AVISO: não pôde validar matriz proargmodes
AVISO: não pôde validar matriz proargnames
AVISO: não pôde validar matriz proconfig
AVISO: não pôde validar matriz reloptions
AVISO: não pôde resolver dependência circular entre esses itens:
AVISO: não se sabe como definir o dono para tipo de objeto "%s"
AVISO: erros ignorados durante restauração: %d
AVISO: ftell não corresponde com posição esperada -- ftell utilizado
AVISO: data de criação inválida no cabeçalho
AVISO: tipo inválido "%c" do método de acesso "%s"
AVISO: linha ignorada: %s
AVISO: dono da função de agregação "%s" parece ser inválido
AVISO: dono do tipo de dado "%s" parece ser inválido
AVISO: dono da função "%s" parece ser inválido
AVISO: dono do operador "%s" parece ser inválido
AVISO: dono da classe de operadores "%s" parece ser inválido
AVISO: dono da família de operadores "%s" parece ser inválido
AVISO: dono do esquema "%s" parece ser inválido
AVISO: dono da tabela "%s" parece ser inválido
AVISO: compressão requerida não está disponível nesta instalação -- arquivo será descomprimido
AVISO: typtype do tipo de dado "%s" parece ser inválido
AVISO: resultados extra inesperados durante COPY da tabela "%s"
Você pode não ser capaz de restaurar a cópia de segurança sem utilizar --disable-triggers ou removendo temporariamente as restrições.
um processo filho morreu inesperadamente
interrompendo porque a versão do servidor não corresponde
tamanho do arquivo atual (%s) não corresponde ao esperado (%s)
alocando AH para %s, formato %d
já está conectado ao banco de dados
arquivador arquivador (bd) tentando verificar formato de arquivo
dumpId inválido
dumpId de tabela inválido para item TABLE DATA
não pôde reabrir arquivos de entrada
não pode duplicar ponteiro nulo (erro interno)
não pode recuperar arquivo comprimido (compressão não é suportada nesta instalação)
processo filho terminou com código de saída %d processo filho terminou com status desconhecido %d processo filho foi terminado pela exceção 0x%X processo filho foi terminado pelo sinal %d processo filho foi terminado pelo sinal %s comando não é executável comando não encontrado compress_io compressão não é suportada pelo formato tar
nível de compressão deve estar no intervalo de 0..9
compressor ativo
conectando ao banco de dados "%s" como usuário "%s"
conectando ao banco de dados para restauração
conectando ao novo banco de dados "%s"
conexão precisa de senha
conexão com banco de dados "%s" falhou: %s cabeçalho tar corrompido foi encontrado em %s (esperado %d, computado %d) na posição %s do arquivo
não pôde mudar diretório para "%s": %s não pôde fechar arquivo TOC: %s
não pôde fechar arquivo: %s
não pôde fechar biblioteca de compressão: %s
não pôde fechar arquivo comprimido: %s
não pôde fechar arquivo de dados: %s
não pôde fechar diretório "%s": %s
não pôde fechar arquivo de entrada: %s
não pôde fechar arquivo TOC de objetos grandes "%s": %s
não pôde fechar arquivo de saída: %s
não pôde fechar membro tar
não pôde fechar arquivo temporário: %s
não pôde efetivar transação do banco de dados não pôde comprimir dados: %s
não pôde criar canais de comunicação: %s
não pôde criar diretório "%s": %s
não pôde criar objeto grande %u: %s não pôde criar processo filho: %s
não pôde determinar posição de busca no arquivo: %s
não pôde executar consulta não pôde encontrar o "%s" para executá-lo não pôde encontrar bloco com ID %d em arquivo -- possivelmente arquivo corrompido
não pôde encontrar bloco com ID %d no arquivo -- possivelmente por causa de pedido de restauração fora de ordem, que não pode ser manipulado pela falta de deslocamentos no arquivo
não pôde encontrar bloco com ID %d no arquivo -- possivelmente por causa de pedido de restauração fora de ordem, que não pode ser manipulado por arquivo de entrada não posicionável
não pôde encontrar registro para ID %d
não pôde encontrar arquivo "%s" no arquivo de dados
não foi possível encontrar definição da função para OID %u
não pôde encontrar cabeçalho do arquivo "%s" no arquivo tar
não pôde encontrar extensão pai para %s
não pôde encontrar entrada do processo filho terminado
não pôde gerar arquivo temporário: %s
não pôde obter versão do servidor a partir da libpq
não pôde identificar diretório atual: %s não pôde identificar dependência circular
não pôde inicializar biblioteca de compressão: %s
não pôde obter bloqueio na relação "%s"
Isso geralmente significa que alguém solicitou um bloqueio ACCESS EXCLUSIVE na tabela após o processo pai do pg_dump ter obtido o bloqueio ACCESS SHARE inicial na tabela.
não pôde abrir arquivo TOC "%s" para entrada: %s
não pôde abrir arquivo TOC "%s" para saída: %s
não pôde abrir arquivo TOC "%s": %s
não pôde abrir arquivo TOC para entrada: %s
não pôde abrir arquivo TOC para saída: %s
não pôde abrir arquivo de entrada "%s": %s
não pôde abrir arquivo de entrada: %s
não pôde abrir objeto grande %u: %s não pôde abrir arquivo TOC de objetos grandes "%s" para entrada: %s
não pôde abrir arquivo de saída "%s": %s
não pôde abrir arquivo de saída: %s
não pôde abrir arquivo temporário
não pôde validar a lista ACL do GRANT (%s) ou lista ACL do REVOKE (%s) para objeto "%s" (%s)
não pôde validar a lista ACL (%s)
não pôde validar a lista inicial ACL do GRANT (%s) ou lista inicial ACL do REVOKE (%s) para objeto "%s" (%s)
não pôde validar matriz numérica "%s": caracter inválido no número
não pôde validar matriz numérica "%s": muitos números
não pôde ler o binário "%s" não pôde ler diretório "%s": %s
não pôde ler arquivo de entrada: %s
não pôde ler arquivo de entrada: fim do arquivo
não pôde ler arquivo de entrada: %s
não pôde ler link simbólico "%s" não pôde reconectar ao banco de dados: %s não pôde definir default_tablespace para %s: %s não pôde definir default_with_oids: %s não pôde definir search_path para "%s": %s não pôde definir posição de busca no arquivo: %s
não pôde definir "%s" como usuário da sessão: %s não pôde iniciar transação do banco de dados não pôde descomprimir dados: %s
não pôde escrever em arquivo TOC de objetos grandes
não pôde escrever objeto grande (resultado: %lu, esperado %lu)
não pôde escrever em arquivo de saída: %s
não pôde escrever no canal de comunicação: %s
criando %s "%s"
criando %s "%s.%s"
arquivador personalizado definição da visão "%s" parece estar vazia (tamanho zero)
não encontrou cadeia de caracteres mágica no cabeçalho do arquivo
conexões diretas ao banco de dados não são suportadas em arquivos anteriores a versão 1.3
diretório "%s" não parece ser um archive válido ("toc.dat" não existe)
arquivador diretório nome de diretório é muito longo: "%s"
desabilitando gatilhos para %s
removendo %s %s
copiando conteúdo da tabela "%s.%s"
habilitando gatilhos para %s
executando laço paralelo principal
executando restore_toc_entries_parallel
executando restore_toc_entries_postfork
executando restore_toc_entries_prefork
ID do registro %d fora do intervalo -- talvez o TOC esteja corrompido
erro durante cópia de segurança
erro durante busca no arquivo: %s
erro ao processar um item de trabalho paralelo
erro ao ler objeto grande %u: %s erro ao ler arquivo TOC de objetos grandes "%s"
erro retornado pelo PQputCopyData: %s erro retornado pelo PQputCopyEnd: %s executando %s %s
esperado %d restrição de verificação na tabela "%s" mas encontrou %d
esperado %d restrições de verificação na tabela "%s" mas encontrou %d
formato esperado (%d) difere do formato encontrado no arquivo (%d)
verificação de sanidade falhou, OID pai %u da tabela "%s" (OID %u) não foi encontrado
verificação de sanidade falhou, OID %u da tabela pai de pg_rewrite com OID %u não foi encontrado
verificação de sanidade falhou, OID %u da sequência com OID %u não foi encontrado
falhou ao conectar ao banco de dados
falhou ao reconectar ao banco de dados
nome de arquivo muito longo: "%s"
deslocamento no arquivo de cópia de segurança é muito grande
encontrando restrições de verificação para tabela "%s.%s"
encontrando expressões padrão da tabela "%s.%s"
encontrando tabelas de extensões
encontrando relacionamentos herdados
encontrando as colunas e tipos da tabela "%s.%s"
item terminado %d %s %s
laço paralelo principal terminado
marcando colunas herdadas nas subtabelas
encontrado bloco inesperado com ID (%d) durante leitura de dados -- esperado %d
função "%s" não foi encontrada
identificando membros de extensões
restauração do tipo somente dados implícita
cabeçalho tar incompleto encontrado (%lu byte)
cabeçalho tar incompleto encontrado (%lu bytes)
índice "%s" não foi encontrado
arquivo de entrada parece estar no formato texto. Por favor utilize o psql.
arquivo de entrada não parece ser um arquivo válido
arquivo de entrada não parece ser um arquivo válido (muito pequeno?)
arquivo de entrada é muito pequeno (lido %lu, esperado 5)
erro interno -- WriteData não pode ser chamada fora do contexto de uma rotina DataDumper
erro interno -- th e fh não foram especificados em tarReadRaw()
item ENCODING inválido: %s
OID inválido para objeto grande
OID inválido para objeto grande (%u)
item STDSTRINGS inválido: %s
valor %d do número da coluna é inválido para tabela "%s"
argumento inválido (%s) para gatilho "%s" na tabela "%s"
binário "%s" é inválido codificação de cliente "%s" especificada é inválida
número de colunas %d é inválido para tabela "%s"
numeração de coluna inválida para tabela "%s"
código de compressão é inválido: %d
dependência %d é inválida
dumpId %d é inválido
linha inválida em arquivo TOC de objetos grandes "%s": "%s"
mensagem inválida recebida do processo filho: "%s"
número de tarefas paralelas inválido
formato de saída especificado "%s" é inválido
cópia de segurança de objetos grandes não é suportada no formato escolhido
último OID interno é %u
iniciando item %d %s %s
faltando índice para restrição "%s"
movendo da posição %s para próximo membro na posição %s do arquivo
nenhum item está pronto
nenhum esquema correspondente foi encontrado
nenhum esquema correspondente foi encontrado para padrão "%s"
nenhuma tabela correspondente foi encontrada
nenhuma tabela correspondente foi encontrada para padrão "%s"
nenhum diretório de destino foi especificado
não foi construído com suporte a zlib
agora na posição %s do arquivo
opção --if-exists requer opção -c/--clean
opções --inserts/--column-inserts e -o/--oids não podem ser utilizadas juntas
opções -c/--clean e -a/--data-only não podem ser utilizadas juntas
opções -s/--schema-only e -a/--data-only não podem ser utilizadas juntas
sem memória
acabaram os elementos para on_exit_nicely
arquivador paralelo cópia de segurança paralela somente é suportada pelo formato diretório
restauração paralela de arquivo não posicionável não é suportada
restauração paralela da entrada padrão não é suportada
restauração paralela não é suportada por arquivos produzidos por pg_dum anterior a 8.0
restauração paralela não é suportada por este formato de arquivo
pclose falhou: %s pgpipe: não pôde aceitar conexão: código de erro %d
pgpipe: não pôde se ligar: código de erro %d
pgpipe: não pôde se conectar ao soquete: código de erro %d
pgpipe: não pôde criar segundo soquete: código de erro %d
pgpipe: não pôde criar soquete: código de erro %d
pgpipe: não pôde escutar: código de erro %d
pgpipe: getsockname() falhou: código de erro %d
processando %s
processando dados da tabela "%s.%s"
processando item %d %s %s
iniciando item adiado %d %s %s
consulta falhou: %s consulta produziu nome nulo da tabela referenciada pelo gatilho de chave estrangeira "%s" na tabela "%s" (OID da tabela: %u)
consulta retornou %d linha ao invés de uma: %s
consulta retornou %d linhas ao invés de uma: %s
consulta para obter dados da sequência "%s" retornou %d linha (esperado 1)
consulta para obter dados da sequência "%s" retornou %d linhas (esperado 1)
consulta para obter dados sobre sequência "%s" retornou nome "%s"
consulta para obter regra "%s" para tabela "%s" falhou: número incorreto de registros foi retornado
consulta para obter definição da visão "%s" retornou mais de uma definição
consulta para obter definição da visão "%s" não retornou dados
consulta foi: %s
lendo registro do TOC %d (ID %d) de %s %s
lendo informações das colunas em tabelas interessantes
lendo restrições
lendo privilégios padrão
lendo dados sobre dependência
lendo gatilhos de eventos
lendo extensões
lendo restrições de chave estrangeira da tabela "%s.%s"
lendo índices
lendo índices da tabela "%s.%s"
lendo objetos grandes
lendo políticas de segurança
lendo políticas de segurança da tabela "%s.%s"
lendo linguagens procedurais
lendo regras de reescrita
lendo informação de segurança de registros da tabela "%s.%s"
lendo esquemas
lendo informação de herança das tabelas
lendo transformações
lendo gatilhos
lendo gatilhos da tabela "%s.%s"
lendo conversões de tipo
lendo métodos de acesso definidos pelo usuário
lendo funções de agregação definidas pelo usuário
lendo ordenações definidas pelo usuário
lendo conversões definidas pelo usuário
lendo servidores externos definidos pelo usuário
lendo adaptadores de dados externos definidos pelo usuário
lendo funções definidas pelo usuário
lendo classes de operadores definidas pelo usuário
lendo famílias de operadores definidas pelo usuário
lendo operadores definidos pelo usuário
lendo tabelas definidas pelo usuário
lendo configurações de busca textual definidas pelo usuário
lendo dicionários de busca textual definidos pelo usuário
lendo analisadores de busca textual definidos pelo usuário
lendo modelos de busca textual definidos pelo usuário
lendo tipos definidos pelo usuário
reduzindo dependências para %d
restaurado %d objeto grande
restaurado %d objetos grandes
restaurar dados fora da ordem não é suportado neste formato de arquivo: "%s" é requerido, mas vem antes de "%s" no arquivo.
restaurando objeto grande com OID %u
verificação de sanidade no tamanho do inteiro (%lu) falhou
salvando definição do banco de dados
salvando codificação = %s
salvando objetos grandes
salvando padrão de escape de cadeia de caracteres = %s
esquema "%s" não foi encontrado
esquema com OID %u não existe
select() falhou: %s
versão do servidor deve ser pelo menos versão 7.3 para utilizar opções com esquemas
versão do servidor: %s; versão do %s: %s
ignorando item %d %s %s
ignorando membro tar %s
classificador tabela "%s" não pôde ser criada, não restaurará os seus dados
tabela "%s" não foi encontrada
arquivador tar este formato não pode ser lido
tranferindo dependência %d -> %d para %d
gatilho "%s" não foi encontrado
sintaxe do comando COPY inesperada: "%s"
Marcador de deslocamento de dado %d é inesperado
tipo de comando da política de segurança inesperado: "%s"
código de seção %d inesperado
valor tgtype inesperado: %d
formato de archive desconhecido "%s"; por favor especifique "c", "d" ou "t"
comando desconhecido recebido do processo principal: "%s"
tipo de restrição é desconhecido: %c
tipo de bloco de dados desconhecido %d durante restauração do arquivo
tipo de bloco de dados desconhecido (%d) durante busca no arquivo
codificação "%s" é desconhecida
formato de arquivo "%d" é desconhecido
tipo de objeto desconhecido em privilégios padrão: %d
valor de proparallel desconhecido para função "%s"
valor de provolatile desconhecido para função "%s"
versão não é suportada (%d.%d) no cabeçalho do arquivo
aviso do arquivo de cópia de segurança: %s
processo filho falhou: código de saída %d
escreveu %lu byte de dados de objeto grande (resultado = %lu)
escreveu %lu bytes de dados de objeto grande (resultado = %lu)
locale/pt_BR/LC_MESSAGES/pg_ctl-9.6.mo 0000644 00000044557 14751153421 0012737 0 ustar 00 �� � � � < P D Q ? � � � &
0
P
- o
�
�
= �
! � A � a � K P � A � ! � 3 ? O H � D � C E a ? � ? � > ' 9 f L � B � E 0 � v 0 � F , > s 8 � I � % 5 2 [ O � 7 � & M 8 - � ! � > � E C [ y � 9 D S C � D � > ! A ` ( � , � 2 � 6 + > b * � / � % � 1 " 0 T # � � 4 � 2 � 1 / 0 a , � . � 3 � " + B 1 n 6 � : � 1 * D " o 7 � " � $ � J ] y 3 � 0 � � ! $ 6 [ - | � 4 � % � $ %! " J! ! m! F �! u �! F L" �" 7 �" ) �" k # ` u# % �# & �# #$ d +$ �$ / �$ & �$ 0 % . 7% ) f% ) �% �% �% & �%
& , +& ( X& �& ! �& �& �& �& �& ' "' 8' I' Y' j' z' " �' �' � �' Y j) H �) '
* 5* . H* % w* $ �* - �* �* + ? '+ g+ ! �+ � �+ 6, g W, L �, - F (- # o- 5 �- M �- O . E g. T �. H / G K/ K �/ C �/ > #0 Z b0 M �0 F 1 � R1 9 �1 L &2 N s2 F �2 \ 3 ) f3 ? �3 d �3 A 54 w4 ~4 �4 [ �4 2 �4 $ '5 D L5 M �5 R �5 � 26 G �6 S 7 U e7 T �7 ] 8 P n8 + �8 0 �8 ? 9 @ \9 F �9 % �9 <
: - G: F u: 8 �: - �: #; < D; A �; 9 �; 6 �; . 4< 5 c< ; �< $ �< 5 �< : 0= F k= H �= E �= 8 A> z> H �> * �> & ? f 6? $ �? % �? ? �? ; (@ d@ ) �@ ' �@ ( �@ 6 �@ $ 2A = WA , �A + �A $ �A & B L :B z �B J C MC > kC 2 �C w �C j UD 2 �D 7 �D +E { 1E �E 0 �E 0 �E 2 0F 0 cF * �F * �F �F G ) "G , LG 2 yG + �G �G # �G H
6H DH VH vH �H �H �H �H �H I .I OI ? L y ' { � V r � & $ o @ � � P b [ - C U � " ( _ . � ; X Y ! 6 � A B = / w � % 7 E K
v
J q c M , ~ # 3 ) 0 W � F s � ] 1 ` u } � � � h � f x m t d : z j � * g S O 9 Q D < G I 4 > 2 5 N Z � | l ^ p i + a H R n 8 � e � � T \ k
%s: -w option cannot use a relative socket directory specification
%s: -w option is not supported when starting a pre-9.1 server
Allowed signal names for kill:
Common options:
Options for register and unregister:
Options for start or restart:
Options for stop or restart:
Report bugs to <pgsql-bugs@postgresql.org>.
Shutdown modes are:
Start types are:
%s init[db] [-D DATADIR] [-s] [-o "OPTIONS"]
%s kill SIGNALNAME PID
%s promote [-D DATADIR] [-s]
%s register [-N SERVICENAME] [-U USERNAME] [-P PASSWORD] [-D DATADIR]
[-S START-TYPE] [-w] [-t SECS] [-o "OPTIONS"]
%s reload [-D DATADIR] [-s]
%s restart [-w] [-t SECS] [-D DATADIR] [-s] [-m SHUTDOWN-MODE]
[-o "OPTIONS"]
%s start [-w] [-t SECS] [-D DATADIR] [-s] [-l FILENAME] [-o "OPTIONS"]
%s status [-D DATADIR]
%s stop [-W] [-t SECS] [-D DATADIR] [-s] [-m SHUTDOWN-MODE]
%s unregister [-N SERVICENAME]
-?, --help show this help, then exit
-D, --pgdata=DATADIR location of the database storage area
-N SERVICENAME service name with which to register PostgreSQL server
-P PASSWORD password of account to register PostgreSQL server
-S START-TYPE service start type to register PostgreSQL server
-U USERNAME user name of account to register PostgreSQL server
-V, --version output version information, then exit
-W do not wait until operation completes
-c, --core-files allow postgres to produce core files
-c, --core-files not applicable on this platform
-e SOURCE event source for logging when running as a service
-l, --log=FILENAME write (or append) server log to FILENAME
-m, --mode=MODE MODE can be "smart", "fast", or "immediate"
-o OPTIONS command line options to pass to postgres
(PostgreSQL server executable) or initdb
-p PATH-TO-POSTGRES normally not necessary
-s, --silent only print errors, no informational messages
-t, --timeout=SECS seconds to wait when using -w option
-w wait until operation completes
auto start service automatically during system startup (default)
demand start service on demand
fast quit directly, with proper shutdown
immediate quit without complete shutdown; will lead to recovery on restart
smart quit after all clients have disconnected
done
failed
stopped waiting
%s is a utility to initialize, start, stop, or control a PostgreSQL server.
%s: -S option not supported on this platform
%s: PID file "%s" does not exist
%s: WARNING: cannot create restricted tokens on this platform
%s: WARNING: could not locate all job object functions in system API
%s: another server might be running; trying to start server anyway
%s: cannot be run as root
Please log in (using, e.g., "su") as the (unprivileged) user that will
own the server process.
%s: cannot promote server; server is not in standby mode
%s: cannot promote server; single-user server is running (PID: %ld)
%s: cannot reload server; single-user server is running (PID: %ld)
%s: cannot restart server; single-user server is running (PID: %ld)
%s: cannot set core file size limit; disallowed by hard limit
%s: cannot stop server; single-user server is running (PID: %ld)
%s: could not access directory "%s": %s
%s: could not allocate SIDs: error code %lu
%s: could not create promote signal file "%s": %s
%s: could not create restricted token: error code %lu
%s: could not determine the data directory using command "%s"
%s: could not find own program executable
%s: could not find postgres program executable
%s: could not open PID file "%s": %s
%s: could not open process token: error code %lu
%s: could not open service "%s": error code %lu
%s: could not open service manager
%s: could not read file "%s"
%s: could not register service "%s": error code %lu
%s: could not remove promote signal file "%s": %s
%s: could not send promote signal (PID: %ld): %s
%s: could not send reload signal (PID: %ld): %s
%s: could not send signal %d (PID: %ld): %s
%s: could not send stop signal (PID: %ld): %s
%s: could not start server
Examine the log output.
%s: could not start server: %s
%s: could not start server: error code %lu
%s: could not start service "%s": error code %lu
%s: could not unregister service "%s": error code %lu
%s: could not wait for server because of misconfiguration
%s: could not write promote signal file "%s": %s
%s: database system initialization failed
%s: directory "%s" does not exist
%s: directory "%s" is not a database cluster directory
%s: invalid data in PID file "%s"
%s: missing arguments for kill mode
%s: no database directory specified and environment variable PGDATA unset
%s: no operation specified
%s: no server running
%s: old server process (PID: %ld) seems to be gone
%s: option file "%s" must have exactly one line
%s: server does not shut down
%s: server is running (PID: %ld)
%s: service "%s" already registered
%s: service "%s" not registered
%s: single-user server is running (PID: %ld)
%s: the PID file "%s" is empty
%s: too many command-line arguments (first is "%s")
%s: unrecognized operation mode "%s"
%s: unrecognized shutdown mode "%s"
%s: unrecognized signal name "%s"
%s: unrecognized start type "%s"
(The default is to wait for shutdown, but not for start or restart.)
HINT: The "-m fast" option immediately disconnects sessions rather than
waiting for session-initiated disconnection.
If the -D option is omitted, the environment variable PGDATA is used.
Is server running?
Please terminate the single-user server and try again.
Server started and accepting connections
The program "%s" is needed by %s but was not found in the
same directory as "%s".
Check your installation.
The program "%s" was found by "%s"
but was not the same version as %s.
Check your installation.
Timed out waiting for server startup
Try "%s --help" for more information.
Usage:
WARNING: online backup mode is active
Shutdown will not complete until pg_stop_backup() is called.
Waiting for server startup...
cannot duplicate null pointer (internal error)
child process exited with exit code %d child process exited with unrecognized status %d child process was terminated by exception 0x%X child process was terminated by signal %d child process was terminated by signal %s command not executable command not found could not change directory to "%s": %s could not find a "%s" to execute could not get current working directory: %s
could not identify current directory: %s could not read binary "%s" could not read symbolic link "%s" invalid binary "%s" out of memory
pclose failed: %s server is still starting up
server promoting
server shutting down
server signaled
server started
server starting
server stopped
starting server anyway
waiting for server to shut down... waiting for server to start... Project-Id-Version: PostgreSQL 9.5
Report-Msgid-Bugs-To: pgsql-bugs@postgresql.org
POT-Creation-Date: 2016-02-13 17:22-0300
PO-Revision-Date: 2005-10-04 22:15-0300
Last-Translator: Euler Taveira de Oliveira <euler@timbira.com>
Language-Team: Brazilian Portuguese <pgbr-dev@listas.postgresql.org.br>
Language: pt_BR
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
%s: opção -w não pode utilizar uma especificação de diretório de soquete relativa
%s: opção -w não é suportada ao iniciar um servidor anterior a 9.1
Sinais permitidos para sinalização:
Opções comuns:
Opções para registrar ou remover registro:
Opções para início ou reinício:
Opções para parada ou reinício:
Relate erros a <pgsql-bugs@postgresql.org>.
Modos de desligamento são:
Tipos de início são:
%s init[db] [-D DIRDADOS] [-s] [-o "OPÇÕES"]
%s kill NOME_SINAL PID
%s promote [-D DIRDADOS] [-s]
%s register [-N NOME_SERVIÇO] [-U USUÁRIO] [-P SENHA] [-D DIRDADOS]
[-S TIPO-INÍCIO] [-w] [-t SEGS] [-o "OPÇÕES"]
%s reload [-D DIRDADOS] [-s]
%s restart [-w] [-t SEGS] [-D DIRDADOS] [-s] [-m MODO-DESLIGAMENTO]
[-o "OPÇÕES"]
%s start [-w] [-t SEGS] [-D DIRDADOS] [-s] [-l ARQUIVO] [-o "OPÇÕES"]
%s status [-D DIRDADOS]
%s stop [-W] [-t SEGS] [-D DIRDADOS] [-s] [-m MODO-DESLIGAMENTO]
%s unregister [-N NOME_SERVIÇO]
-?, --help mostra essa ajuda e termina
-D, --pgdata=DIRDADOS local da área de armazenamento dos bancos de dados
-N NOME_SERVIÇO nome do serviço no qual se registrou o servidor PostgreSQL
-P SENHA senha da conta que registrou o servidor PostgreSQL
-S TIPO-INÍCIO tipo de início do serviço para registrar o servidor PostgreSQL
-U USUÁRIO nome do usuário que registrou o servidor PostgreSQL
-V, --version mostra informação sobre a versão e termina
-W não espera até que a operação seja completada
-c, --core-files permite o postgres produzir arquivos core
-c, --core-files não é aplicável a esta plataforma
-e ORIGEM origem de eventos para registro quando executar como um serviço
-l, --log=ARQUIVO escreve (ou concatena) log do servidor para ARQUIVO
-m, --mode=MODO MODO pode ser "smart", "fast" ou "immediate"
-o OPÇÕES opções de linha de comando passadas para o postgres
(executável do servidor PostgreSQL) ou initdb
-p CAMINHO-DO-POSTGRES normalmente não é necessário
-s, --silent mostra somente erros, nenhuma mensagem informativa
-t, --timeout= SEGS segundos a esperar quando a opção -w for utilizada
-w espera até que a operação seja completada
auto inicia serviço automaticamente durante a inicialização do sistema (padrão)
demand inicia serviço sob demanda
fast termina diretamente, com desligamento apropriado
immediate termina sem desligamento completo; conduzirá a uma recuperação durante o reinício
smart termina depois que todos os clientes desconectarem
feito
falhou
parou de esperar
%s é um utilitário para inicializar, iniciar, parar e controlar um servidor PostgreSQL.
%s: opção -S não é suportada nessa plataforma
%s: arquivo do PID "%s" não existe
%s: AVISO: não pode criar informações restritas nessa plataforma
%s: AVISO: não pôde localizar todas funções job object na API do sistema
%s: outro servidor pode estar executando; tentando iniciar o servidor assim mesmo
%s: não pode ser executado como root
Por favor entre (utilizando "su") como um usuário (sem privilégios) que
será o dono do processo do servidor.
%s: não pode promover servidor; servidor não está no modo em espera
%s: não pode promover servidor; servidor monousuário está executando (PID: %ld)
%s: não pode recarregar servidor; servidor monousuário está executando (PID: %ld)
%s: não pode reiniciar servidor; servidor monousuário está executando (PID: %ld)
%s: não pode definir tamanho limite do arquivo core; não é permitido pelo limite superior
%s: não pode parar servidor; servidor monousuário está executando (PID: %ld)
%s: não pôde acessar diretório "%s": %s
%s: não pôde alocar SIDs: código de erro %lu
%s: não pôde criar arquivo para sinal de promoção "%s": %s
%s: não pôde criar informação restrita: código de erro %lu
%s: não pôde determinar diretório de dados utilizando comando "%s"
%s: não pôde encontrar executável
%s: não pôde encontrar o programa executável do postgres
%s: não pôde abrir arquivo do PID "%s": %s
%s: não pôde abrir informação sobre processo: código de erro %lu
%s: não pôde abrir serviço "%s": código de erro %lu
%s: não pôde abrir gerenciador de serviço
%s: não pôde ler arquivo "%s"
%s: não pôde registrar serviço "%s": código de erro %lu
%s: não pôde remover arquivo para sinal de promoção "%s": %s
%s: não pôde enviar sinal de promoção (PID: %ld): %s
%s: não pôde enviar sinal de recarga (PID: %ld): %s
%s: não pôde enviar sinal %d (PID: %ld): %s
%s: não pôde enviar sinal de parada (PID: %ld): %s
%s: não pode iniciar o servidor
Examine o arquivo de log.
%s: não pôde iniciar servidor: %s
%s: não pôde iniciar servidor: código de erro %lu
%s: não pôde iniciar serviço "%s": código de erro %lu
%s: não pôde remover registro do serviço "%s": código de erro %lu
%s: não pôde esperar pelo servidor por causa de configuração errada
%s: não pôde escrever no arquivo para sinal de promoção "%s": %s
%s: inicialização do sistema de banco de dados falhou
%s: diretório "%s" não existe
%s: diretório "%s" não é um diretório de agrupamento de banco dados
%s: dado inválido no arquivo do PID "%s"
%s: faltando argumento para modo kill
%s: nenhum diretório de banco de dados especificado e variável de ambiente PGDATA não foi definida
%s: nenhuma operação especificada
%s: nenhum servidor está executando
%s: processo servidor antigo (PID: %ld) parece estar terminado
%s: arquivo de opções "%s" deve ter exatamente uma linha
%s: servidor não desligou
%s: servidor está executando (PID: %ld)
%s: serviço "%s" já está registrado
%s: serviço "%s" não está registrado
%s: servidor monousuário está executando (PID: %ld)
%s: arquivo do PID "%s" está vazio
%s: muitos argumentos de linha de comando (primeiro é "%s")
%s: modo de operação "%s" é desconhecido
%s: modo de desligamento "%s" desconhecido
%s: nome de sinal "%s" desconhecido
%s: tipo de início "%s" desconhecido
(O padrão é esperar o desligamento, mas não para início ou reinício).
DICA: A opção "-m fast" desconecta imediatamente sessões ao invés de esperar pela desconexão das sessões iniciadas.
Se a opção -D for omitida, a variável de ambiente PGDATA é utilizada.
O servidor está executando?
Por favor finalize o servidor monousuário e tente novamente.
Servidor foi iniciado e está aceitando conexões
O programa "%s" é requerido pelo %s mas não foi encontrado no
mesmo diretório que "%s".
Verifique sua instalação.
O programa "%s" foi encontrado pelo "%s"
mas não tem a mesma versão que %s.
Verifique sua instalação.
Tempo de espera esgotado para início do servidor
Tente "%s --help" para obter informações adicionais.
Uso:
AVISO: modo cópia de segurança online está ativo
Desligamento não completará até que pg_stop_backup() seja chamado.
Esperando o servidor iniciar...
não pode duplicar ponteiro nulo (erro interno)
processo filho terminou com código de saída %d processo filho terminou com status desconhecido %d processo filho foi terminado pela exceção 0x%X processo filho foi terminado pelo sinal %d processo filho foi terminado pelo sinal %s comando não é executável comando não foi encontrado não pôde mudar diretório para "%s": %s não pôde encontrar o "%s" para executá-lo não pôde obter diretório de trabalho atual: %s
não pôde identificar diretório atual: %s não pôde ler o binário "%s" não pôde ler link simbólico "%s" binário "%s" é inválido sem memória
pclose falhou: %s servidor ainda está iniciando
servidor está sendo promovido
servidor está desligando
servidor foi sinalizado
servidor iniciado
servidor está iniciando
servidor está parado
iniciando servidor mesmo assim
esperando o servidor desligar... esperando o servidor iniciar... locale/pt_BR/LC_MESSAGES/pgscripts-9.6.mo 0000644 00000063756 14751153421 0013507 0 ustar 00 �� � | � 0 K 1 }
� > � > � = - Z � � C A d � � # � � ( 9 I V E � � > f ; � = � : < Z 9 � 6 � 5 C > C � 9 � 4 E 5 = { . � ; � E $ : j ? � A � < ' 9 d 7 � 4 � L J X 3 � H � E B f A � 5 � 2 ! N T 7 � 2 � 2 J A : � 5 � G � 0 E < v 0 � ) � M J \ G � 4 � C $! H h! E �! D �! = <" v z" < �" � .# Q �# I $ @ N$ 5 �$ 4 �$ 1 �$ 0 ,% ; ]% 5 �% ' �% 6 �% 3 .& 4 b& @ �& ; �& ; ' ` P' 8 �' 2 �' 9 ( 6 W( > �( �( / �( < ) # F) # j) ? �) 8 �) % * # -* Q* 3 q* & �* �* E �* 6 + E P+ F �+ K �+ 7 ), K a, 7 �, J �, 6 0- < g- D �- 5 �- . * =. 8 h. 6 �. ( �. 4 / $ 6/ # [/ / �/ �/ 8 �/ 4 0 $ E0 j0 , �0 , �0 ( �0 /
1 ; =1 9 y1 ! �1 �1 �1 �1 * 2 8 F2 9 2 , �2 8 �2 # 3 4 C3 3 x3 �3 ) �3 7 �3 +4
@4 N4 C c4 A �4 ! �4 + 5 75 H5 d5 �5 . �5 3 �5 2 6 56 B6 G6
d6 o6 �6 �6 ' �6 " �6 2 7 7 87 p7 & y7 �7 �7 / �7 + �7 * 8 F8 H8 K8 W8 d8 s8 �8 �8 ( �8 �8 �8 � �8 H �: �: �: @ ; @ B; ? �; - �; � �; O �< M �< E= X= % s= �= ) �= �= L �= F K> � �> K "? K n? @ �? ; �? > 7@ ; v@ 8 �@ 7 �@ Q #A H uA E �A ; B V @B 9 �B 9 �B @ C W LC : �C G �C E 'D H mD D �D ? �D ? ;E a {E c �E > AF P �F M �F J G I jG + �G + �G \ H > iH < �H > �H M $I B rI = �I N �I : BJ C }J < �J 2 �J J 1K G |K D �K ; L A EL ] �L ] �L \ CM I �M ~ �M : iN � �N Y /O E �O O �O > P @ ^P @ �P ? �P > Q 8 _Q 3 �Q 8 �Q 6 R > <R I {R J �R G S ] XS : �S 4 �S 1 &T 1 XT G �T �T 2 �T G U ' YU & �U C �U K �U + 8V ) dV # �V 7 �V 2 �V W O $W K tW Q �W [ X \ nX N �X \ Y N wY [ �Y M "Z C pZ N �Z J [ " N[ 1 q[ @ �[ C �[ 0 (\ ; Y\ & �\ % �\ * �\ *
] 8] > R] ? �] ( �] % �] 5 ^ 0 V^ + �^ 7 �^ K �^ I 7_ ( �_ �_ �_ $ �_ 3 �_ C 1` C u` 6 �` B �` % 3a ? Ya 7 �a ! �a - �a < !b ^b }b % �b a �b ] c 2 vc 4 �c �c ( �c & d ! Cd 8 ed 9 �d 7 �d
e e #e Be Je ! ee �e * �e , �e * �e & !f Hf 7 Tf �f �f 0 �f 3 �f . g ;g =g Bg Ug
gg ug
�g �g 9 �g �g �g � � 9 � � t � � � I S � w & % � � � � G � � - . � � X � { � " � 7 � o � � < � � � L � 4 / K i u � J � ~ B m ( � � � � * �
n f H p � # D g @ ' > � � U � v � x [ � 3
N � � k ! � 8 , � Y F ; � z � � Z � T � � 6 r M � + a 2 W � � $ ] _ � � } = s � j � � ? � ` � c | � l \ V � � � � � E ) : q � � Q C b 1 0 h A y � d R ^ O � � � � � � 5 � � � e P
By default, a database with the same name as the current user is created.
Connection options:
Options:
Read the description of the SQL command CLUSTER for details.
Read the description of the SQL command REINDEX for details.
Read the description of the SQL command VACUUM for details.
Report bugs to <pgsql-bugs@postgresql.org>.
--analyze-in-stages only update optimizer statistics, in multiple
stages for faster results; no vacuum
--lc-collate=LOCALE LC_COLLATE setting for the database
--lc-ctype=LOCALE LC_CTYPE setting for the database
%s [OPTION]...
%s [OPTION]... DBNAME
%s [OPTION]... LANGNAME [DBNAME]
%s [OPTION]... [DBNAME]
%s [OPTION]... [DBNAME] [DESCRIPTION]
%s [OPTION]... [ROLENAME]
--if-exists don't report error if database doesn't exist
--if-exists don't report error if user doesn't exist
--interactive prompt for missing role name and attributes rather
than using defaults
--maintenance-db=DBNAME alternate maintenance database
--maintenance-db=DBNAME alternate maintenance database
--no-replication role cannot initiate replication
--replication role can initiate replication
-?, --help show this help, then exit
-?, --help show this help, then exit
-?, --help show this help, then exit
-?, --help show this help, then exit
-D, --no-createdb role cannot create databases (default)
-D, --tablespace=TABLESPACE default tablespace for the database
-E, --encoding=ENCODING encoding for the database
-E, --encrypted encrypt stored password
-F, --freeze freeze row transaction information
-I, --no-inherit role does not inherit privileges
-L, --no-login role cannot login
-N, --unencrypted do not encrypt stored password
-O, --owner=OWNER database user to own the new database
-P, --pwprompt assign a password to new role
-R, --no-createrole role cannot create roles (default)
-S, --no-superuser role will not be superuser (default)
-S, --schema=SCHEMA reindex specific schema(s) only
-T, --template=TEMPLATE template database to copy
-U, --username=USERNAME user name to connect as
-U, --username=USERNAME user name to connect as
-U, --username=USERNAME user name to connect as (not the one to create)
-U, --username=USERNAME user name to connect as (not the one to drop)
-U, --username=USERNAME user name to connect as
-V, --version output version information, then exit
-V, --version output version information, then exit
-V, --version output version information, then exit
-V, --version output version information, then exit
-W, --password force password prompt
-W, --password force password prompt
-Z, --analyze-only only update optimizer statistics; no vacuum
-a, --all vacuum all databases
-a, --all cluster all databases
-a, --all reindex all databases
-c, --connection-limit=N connection limit for role (default: no limit)
-d, --createdb role can create new databases
-d, --dbname=DBNAME database to vacuum
-d, --dbname=DBNAME database from which to remove the language
-d, --dbname=DBNAME database to cluster
-d, --dbname=DBNAME database to install language in
-d, --dbname=DBNAME database to reindex
-d, --dbname=DBNAME database name
-e, --echo show the commands being sent to the server
-e, --echo show the commands being sent to the server
-e, --echo show the commands being sent to the server
-f, --full do full vacuuming
-g, --role=ROLE new role will be a member of this role
-h, --host=HOSTNAME database server host or socket directory
-h, --host=HOSTNAME database server host or socket directory
-h, --host=HOSTNAME database server host or socket directory
-i, --index=INDEX recreate specific index(es) only
-i, --inherit role inherits privileges of roles it is a
member of (default)
-i, --interactive prompt before deleting anything
-i, --interactive prompt before deleting anything, and prompt for
role name if not specified
-j, --jobs=NUM use this many concurrent connections to vacuum
-l, --list show a list of currently installed languages
-l, --locale=LOCALE locale settings for the database
-l, --login role can login (default)
-p, --port=PORT database server port
-p, --port=PORT database server port
-p, --port=PORT database server port
-q, --quiet don't write any messages
-q, --quiet don't write any messages
-q, --quiet run quietly
-r, --createrole role can create new roles
-s, --superuser role will be superuser
-s, --system reindex system catalogs
-t, --table='TABLE[(COLUMNS)]' vacuum specific table(s) only
-t, --table=TABLE cluster specific table(s) only
-t, --table=TABLE reindex specific table(s) only
-t, --timeout=SECS seconds to wait when attempting connection, 0 disables (default: %s)
-v, --verbose write a lot of output
-v, --verbose write a lot of output
-w, --no-password never prompt for password
-w, --no-password never prompt for password
-z, --analyze update optimizer statistics
%s (%s/%s) %s cleans and analyzes a PostgreSQL database.
%s clusters all previously clustered tables in a database.
%s creates a PostgreSQL database.
%s creates a new PostgreSQL role.
%s installs a procedural language into a PostgreSQL database.
%s issues a connection check to a PostgreSQL database.
%s reindexes a PostgreSQL database.
%s removes a PostgreSQL database.
%s removes a PostgreSQL role.
%s removes a procedural language from a database.
%s: "%s" is not a valid encoding name
%s: %s %s: cannot cluster all databases and a specific one at the same time
%s: cannot cluster specific table(s) in all databases
%s: cannot reindex all databases and a specific one at the same time
%s: cannot reindex all databases and system catalogs at the same time
%s: cannot reindex specific index(es) and system catalogs at the same time
%s: cannot reindex specific index(es) in all databases
%s: cannot reindex specific schema(s) and system catalogs at the same time
%s: cannot reindex specific schema(s) in all databases
%s: cannot reindex specific table(s) and system catalogs at the same time
%s: cannot reindex specific table(s) in all databases
%s: cannot use the "%s" option when performing only analyze
%s: cannot vacuum all databases and a specific one at the same time
%s: cannot vacuum specific table(s) in all databases
%s: clustering database "%s"
%s: clustering of database "%s" failed: %s %s: clustering of table "%s" in database "%s" failed: %s %s: comment creation failed (database was created): %s %s: could not connect to database %s: %s %s: could not connect to database %s: out of memory
%s: could not fetch default options
%s: creation of new role failed: %s %s: database creation failed: %s %s: database removal failed: %s %s: invalid socket: %s %s: language "%s" is already installed in database "%s"
%s: language "%s" is not installed in database "%s"
%s: language installation failed: %s %s: language removal failed: %s %s: missing required argument database name
%s: missing required argument language name
%s: missing required argument role name
%s: number of parallel jobs must be at least 1
%s: only one of --locale and --lc-collate can be specified
%s: only one of --locale and --lc-ctype can be specified
%s: processing database "%s": %s
%s: query failed: %s %s: query was: %s
%s: reindexing database "%s"
%s: reindexing of database "%s" failed: %s %s: reindexing of index "%s" in database "%s" failed: %s %s: reindexing of schema "%s" in database "%s" failed: %s %s: reindexing of system catalogs failed: %s %s: reindexing of table "%s" in database "%s" failed: %s %s: removal of role "%s" failed: %s %s: too many command-line arguments (first is "%s")
%s: too many parallel jobs requested (maximum: %d)
%s: vacuuming database "%s"
%s: vacuuming of database "%s" failed: %s %s: vacuuming of table "%s" in database "%s" failed: %s (%lu row) (%lu rows) Are you sure? Cancel request sent
Cannot add cell to table content: total cell count of %d exceeded.
Cannot add header to table content: column count of %d exceeded.
Could not send cancel request: %s Database "%s" will be permanently removed.
Enter it again: Enter name of role to add: Enter name of role to drop: Enter password for new role: Generating default (full) optimizer statistics Generating medium optimizer statistics (10 targets) Generating minimal optimizer statistics (1 target) Interrupted
Name Password encryption failed.
Password: Passwords didn't match.
Please answer "%s" or "%s".
Procedural Languages Role "%s" will be permanently removed.
Shall the new role be a superuser? Shall the new role be allowed to create databases? Shall the new role be allowed to create more new roles? Trusted? Try "%s --help" for more information.
Usage:
accepting connections
cannot duplicate null pointer (internal error)
could not look up effective user ID %ld: %s invalid output format (internal error): %d n no no attempt
no response
out of memory
rejecting connections
unknown
user does not exist user name lookup failure: error code %lu y yes Project-Id-Version: PostgreSQL 9.6
Report-Msgid-Bugs-To: pgsql-bugs@postgresql.org
POT-Creation-Date: 2016-08-09 22:53-0300
PO-Revision-Date: 2016-06-07 06:54-0400
Last-Translator: Euler Taveira de Oliveira <euler@timbira.com>
Language-Team: Brazilian Portuguese <pgbr-dev@listas.postgresql.org.br>
Language: pt_BR
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Plural-Forms: nplurals=2; plural=(n>1);
Por padrão, um banco de dados com o mesmo nome do usuário é criado.
Opções de conexão:
Opções:
Leia a descrição do comando SQL CLUSTER para obter detalhes.
Leia a descrição do comando SQL REINDEX para obter detalhes.
Leia a descrição do comando SQL VACUUM para obter detalhes.
Relate erros a <pgsql-bugs@postgresql.org>.
--analyze-in-stages atualiza somente estatísticas do otimizador, em
múltiplos estágios para resultados mais rápidos; sem limpeza
--lc-collate=LOCALE configuração LC_COLLATE para o banco de dados
--lc-ctype=LOCALE configuração LC_CTYPE para o banco de dados
%s [OPÇÃO]...
%s [OPÇÃO]... NOMEBD]
%s [OPÇÃO]... LINGUAGEM [NOMEBD]
%s [OPÇÃO]... [NOMEBD]
%s [OPÇÃO]... [NOMEBD] [DESCRIÇÃO]
%s [OPÇÃO]... [NOME_ROLE]
--if-exists não relata erro se banco de dados não existir
--if-exists não relata erro se usuário não existir
--interactive pergunta pelo nome e atributos não informados da role
ao invés de utilizar o padrão
--maintenance-db=NOMEBD especifica um banco de dados para manutenção
--maintenance-db=NOMEBD especifica um banco de dados para manutenção
--no-replication role não pode iniciar replicação
--replication role pode iniciar replicação
-?, --help mostra essa ajuda e termina
-?, --help mostra essa ajuda e termina
-?, --help mostra essa ajuda e termina
-?, --help mostra essa ajuda e termina
-D, --no-createdb role não pode criar novos bancos de dados (padrão)
-D, --tablespace=TABLESPACE tablespace padrão para o banco de dados
-E, --encoding=CODIFICAÇÃO codificação para o banco de dados
-E, --encrypted criptografa a senha armazenada
-F, --freeze congela informação sobre transação de registros
-I, --no-inherit role não herda privilégios
-L, --no-login role não pode efetuar login
-N, --unencrypted não criptografa a senha armazenada
-O, --owner=DONO usuário do banco que será dono do novo banco de dados
-P, --pwprompt atribui uma senha a nova role
-R, --no-createrole role não pode criar novas roles (padrão)
-S, --no-superuser role não será super-usuário (padrão)
-S, --schema=ESQUEMA reindexa somente esquema(s) especificado(s)
-T, --template=MODELO modelo de banco de dados para copiar
-U, --username=USUÁRIO nome do usuário para se conectar
-U, --username=USUÁRIO nome do usuário para se conectar
-U, --username=USUÁRIO nome do usuário para se conectar (não é o usuário a ser criado)
-U, --username=USUÁRIO nome do usuário para se conectar (não é o usuário a ser removido)
-U, --username=USUÁRIO nome do usuário para se conectar
-V, --version mostra informação sobre a versão e termina
-V, --version mostra informação sobre a versão e termina
-V, --version mostra informação sobre a versão e termina
-V, --version mostra informação sobre a versão e termina
-W, --password pergunta senha
-W, --password pergunta senha
-Z, --analyze-only atualiza somente estatísticas do otimizador; sem limpeza
-a, --all limpa todos bancos de dados
-a, --all agrupa todos os bancos de dados
-a, --all reindexa todos os bancos de dados
-c, --connection-limit=N limite de conexão por role (padrão: ilimitado)
-d, --createdb role pode criar novos bancos de dados
-d, --dbname=NOMEBD banco de dados a ser limpo
-d, --dbname=NOMEBD banco de dados no qual será removido a linguagem
-d, --dbname=NOMEBD banco de dados a ser agrupado
-d, --dbname=NOMEBD banco de dados para instalar linguagem
-d, --dbname=NOMEBD banco de dados a ser reindexado
-d, --dbname=NOMEBD nome do banco de dados
-e, --echo mostra os comandos enviados ao servidor
-e, --echo mostra os comandos enviados ao servidor
-e, --echo mostra os comandos enviados ao servidor
-f, --full faz uma limpeza completa
-g, --role=ROLE nova role será um membro desta role
-h, --host=MÁQUINA máquina do servidor de banco de dados ou diretório do soquete
-h, --host=MÁQUINA máquina do servidor de banco de dados ou diretório do soquete
-h, --host=MÁQUINA máquina do servidor de banco de dados ou diretório do soquete
-i, --index=ÍNDICE reindexa somente índice(s) especificado(s)
-i, --inherit role herda privilégios de roles das quais ela
é um membro (padrão)
-i, --interactive pergunta antes de apagar algo
-i, --interactive pergunta antes de apagar algo, e pergunta o nome
da role se não for especificado
-j, --jobs=NUM use esse número de conexões concorrentes para limpar
-l, --list mostra a lista das linguagens instaladas
-l, --locale=LOCALE configurações regionais para o banco de dados
-l, --login role pode efetuar login (padrão)
-p, --port=PORTA porta do servidor de banco de dados
-p, --port=PORTA porta do servidor de banco de dados
-p, --port=PORTA porta do servidor de banco de dados
-q, --quiet não exibe nenhuma mensagem
-q, --quiet não exibe nenhuma mensagem
-q, --quiet executa silenciosamente
-r, --createrole role pode criar novas roles
-s, --superuser role será super-usuário
-s, --system reindexa os catálogos do sistema
-t, --table='TABELA[(COLUNAS)]' limpa somente tabela(s) específica(s)
-t, --table=TABELA agrupa somente a(s) tabela(s) especificada(s)
-t, --table=TABELA reindexa somente tabela(s) especificada(s)
-t, --timeout=SEGS segundos a esperar ao tentar conexão, 0 desabilita (padrão: %s)
-v, --verbose mostra muitas mensagens
-v, --verbose mostra muitas mensagens
-w, --no-password nunca pergunta senha
-w, --no-password nunca pergunta senha
-z, --analyze atualiza estatísticas do otimizador
%s (%s/%s) %s limpa e analisa um banco de dados PostgreSQL.
%s agrupa todas as tabelas agrupadas anteriormente no banco de dados.
%s cria um banco de dados PostgreSQL.
%s cria uma nova role do PostgreSQL.
%s instala uma linguagem procedural no banco de dados PostgreSQL.
%s envia uma verificação de conexão para um banco de dados PostgreSQL.
%s reindexa um banco de dados PostgreSQL.
%s remove um banco de dados PostgreSQL.
%s remove uma role do PostgreSQL.
%s remove uma linguagem procedural do banco de dados.
%s: "%s" não é um nome de codificação válido
%s: %s %s: não pode agrupar todos os bancos de dados e um específico ao mesmo tempo
%s: não pode agrupar tabela(s) específica(s) em todos os bancos de dados
%s: não pode reindexar todos os bancos de dados e um específico ao mesmo tempo
%s: não pode reindexar todos os bancos de dados e os catálogos do sistema ao mesmo tempo
%s: não pode reindexar índice(s) específico(s) e os catálogos do sistema ao mesmo tempo
%s: não pode reindexar índice(s) específico(s) em todos os bancos de dados
%s: não pode reindexar esquema(s) específico(s) e os catálogos do sistema ao mesmo tempo
%s: não pode reindexar esquema(s) específico(s) em todos os bancos de dados
%s: não pode reindexar tabela(s) específica(s) e os catálogos do sistema ao mesmo tempo
%s: não pode reindexar tabela(s) específica(s) em todos os bancos de dados
%s: não pode utilizar a opção "%s" ao executar somente análise
%s: não pode limpar todos os bancos de dados e um específico ao mesmo tempo
%s: não pode limpar tabela(s) específica(s) em todos os bancos de dados
%s: agrupando banco de dados "%s"
%s: agrupamento do banco de dados "%s" falhou: %s %s: agrupamento da tabela "%s" no banco de dados "%s" falhou: %s %s: criação de comentário falhou (banco de dados foi criado): %s %s: não pôde conectar ao banco de dados %s: %s %s: não pôde conectar ao banco de dados %s: sem memória
%s: não pôde obter opções padrão
%s: criação de nova role falhou: %s %s: criação do banco de dados falhou: %s %s: remoção do banco de dados falhou: %s %s: soquete inválido: %s %s: linguagem "%s" já está instalada no banco de dados "%s"
%s: linguagem "%s" não está instalada no banco de dados "%s"
%s: instalação de linguagem falhou: %s %s: remoção da linguagem falhou: %s %s: nome do banco de dados é um argumento requerido
%s: nome da linguagem é um argumento requerido
%s: nome da role é um argumento requerido
%s: número de tarefas paralelas deve ser pelo menos 1
%s: somente uma das opções --locale e --lc-collate pode ser especificada
%s: somente uma das opções --locale e --lc-ctype pode ser especificada
%s: processando banco de dados "%s": %s
%s: consulta falhou: %s %s: consulta foi: %s
%s: reindexando banco de dados "%s"
%s: reindexação do banco de dados "%s" falhou: %s %s: reindexação do índice "%s" no banco de dados "%s" falhou: %s %s: reindexação do esquema "%s" no banco de dados "%s" falhou: %s %s: reindexação dos catálogos do sistema falhou: %s %s: reindexação da tabela "%s" no banco de dados "%s" falhou: %s %s: remoção da role "%s" falhou: %s %s: muitos argumentos para linha de comando (primeiro é "%s")
%s: muitas tarefas paralelas solicitadas (máximo: %d)
%s: limpando banco de dados "%s"
%s: limpeza no banco de dados "%s" falhou: %s %s: limpeza na tabela "%s" no banco de dados "%s" falhou: %s (%lu registro) (%lu registros) Você tem certeza? Requisição de cancelamento enviada
Não pode adicionar célula a conteúdo de tabela: quantidade total de células %d foi excedida.
Não pode adicionar cabeçalho a conteúdo de tabela: quantidade de colunas %d foi excedida.
Não pôde enviar requisição de cancelamento: %s Banco de dados "%s" será permanentemente removido.
Digite-a novamente: Digite o nome da role a ser adicionada: Digite o nome da role a ser removida: Digite a senha para a nova role: Gerando estatísticas padrão (completa) para otimizador Gerando estatísticas parciais para otimizador (10 alvos) Gerando estatísticas mínimas para otimizador (1 alvo) Interrompido
Nome Criptografia de senha falhou.
Senha: Senhas não correspondem.
Por favor responda "%s" ou "%s".
Linguagens Procedurais Role "%s" será permanentemente removida.
A nova role poderá criar um super-usuário? A nova role poderá criar bancos de dados? A nova role poderá criar novas roles? Confiável? Tente "%s --help" para obter informações adicionais.
Uso:
aceitando conexões
não pode duplicar ponteiro nulo (erro interno)
não pôde encontrar ID de usuário efetivo %ld: %s formato de saída inválido (erro interno): %d n não nenhuma tentativa
nenhuma resposta
sem memória
rejeitando conexões
desconhecido
usuário não existe falhou ao pesquisar nome de usuário: código de erro %lu s sim locale/pt_BR/LC_MESSAGES/libpq5-9.6.mo 0000644 00000056503 14751153421 0012655 0 ustar 00 �� � t � " ( :
P ' ^ ( � � # � � $ 7 Q
j 0 u ( � ( � � 5 8 K � $ � # � � � - 8 : s � . � ( � , 0 C : R " � � � < � a 0 x ) � ' � * � . & + U ' � ' � * � * � + ' * S , ~ ) � ) � + � - + / Y + � ( � ) � & 5 / 3 e & � ! � � � " . v Q w � r @ � ! � � ' - ; � i > � # < 9 ` & � ) � * � # 9 : ) t ' � ) � � ) " 8 9 [ . � ' � * � " ! " :! . ]! / �! - �! @ �! 2 +" ! ^" % �" % �" & �" V �" = J# ; �# �# �# $ 4 !$ 0 V$ �$ : �$ �$ �$ % - A% - o% �% + �% 2 �% 7 & = P& ! �& . �& 8 �& " ' ;' F [' C �' $ �' ( B &( i( y( ; �( ( �( * �( & &) % M) ! s) 6 �) C �) ? * 2 P* 1 �* = �* ) �* J + h+ }+ �+ �+ �+ 1 �+
, +, + :, f, ) �, " �, [ �, .- ? G- 1 �- 8 �- > �- � 1. # �. �. : �. � &/ 2 �/ Q �/ J 50 K �0 �0 �0 ? 1 ! D1 + f1 �1 �1 L �1 D 2 % Q2 . w2 C �2 �2 $ 3 5 03 ) f3 � �3 &5 65 95 >5 D5 Y5 s5 . �5 / �5 �5 ' 6 (6
C6 ( Q6 ' z6 # �6
�6 0 �6 , 7 , /7
\7 g7 p7 7 u7 : �7 & �7 + 8 0 ;8 l8 {8 5 �8 = �8 9 # 9 . B9 1 q9 ) �9 �9 �9 < �9 & 3: % Z: �: N �: ~ �: B c; ) �; & �; 2 �; 6 *< 3 a< + �< / �< . �< . = / O= . = 0 �= - �= -
> / ;> 1 k> 3 �> / �> , ? - .? & \? 6 �? 4 �? / �? 4 @ T@ o@ �@ ! �@ � �@ � QA } �A RB " sB �B ( �B 7 �B � C ^ �C # +D R OD / �D . �D 0 E + 2E A ^E < �E 1 �E & F " 6F $ YF # ~F < �F ) �F ) G 1 3G ( eG 0 �G = �G F �G = DH P �H = �H ( I 1 :I ' lI ( �I ] �I C J > _J �J �J �J < �J 6 ;K ' rK H �K �K # L # &L 5 JL 5 �L & �L : �L 3 M < LM D �M * �M 5 �M @ /N % pN & �N X �N U O 5 lO ! �O V �O P % .P L TP * �P 7 �P 4 Q % 9Q " _Q 9 �Q O �Q R R A _R @ �R A �R 0 $S b US �S �S �S , T % 9T 0 _T �T
�T 0 �T ' �T 3 U 8U s VU �U I �U 6 0V : gV A �V � �V . jW �W L �W � �W 1 �X f �X \ 4Y ] �Y - �Y Z L 8Z $ �Z 6 �Z �Z �Z L [ O d[ - �[ 8 �[ E \ % a\ ' �\ X �\ : ] R - & � � � X j F ! � � ] u � p � � � A o � 4 � � Q � � � � � � # C � � +
} N � / � � 2 * � � z 1 � � 5 y � l � � � 3 � ) K � � � � � ` � ~ e � { a
k I W r � � < � � � U , � M O � " � d _ D ' � 9 P 7 � � m � � T � � � L � ; � t c E n ( . v � Z Y b = $ S x f � J � h g 0 q � ? s � � ^ � H � � B G > � � � [ % @ w � � 6 � 8 | : i \ � V � � � at character %s %s %s, %s:%s COLUMN NAME: %s
CONSTRAINT NAME: %s
CONTEXT: %s
COPY IN state must be terminated first
COPY OUT state must be terminated first
COPY terminated by new PQexec Crypt authentication not supported
DATATYPE NAME: %s
DETAIL: %s
GSSAPI authentication not supported
GSSAPI continuation error GSSAPI name import error HINT: %s
IPv6 host address may not be empty in URI: "%s"
Kerberos 4 authentication not supported
Kerberos 5 authentication not supported
LINE %d: LOCATION: NOTICE PGEventProc "%s" failed during PGEVT_CONNRESET event
PGEventProc "%s" failed during PGEVT_RESULTCREATE event
PGresult is not an error result
PQexec not allowed during COPY BOTH
PQgetline: not doing text COPY OUT
QUERY: %s
SCHEMA NAME: %s
SCM_CRED authentication method not supported
SCRAM authentication requires libpq version 10 or above
SSL SYSCALL error: %s
SSL SYSCALL error: EOF detected
SSL certificate's name contains embedded null
SSL certificate's name entry is missing
SSL connection has been closed unexpectedly
SSL error code %lu SSL error: %s
SSL library does not support CRL certificates (file "%s")
SSPI authentication not supported
SSPI continuation error TABLE NAME: %s
Unix-domain socket path "%s" is too long (maximum %d bytes)
WARNING: password file "%s" has group or world access; permissions should be u=rw (0600) or less
WARNING: password file "%s" is not a plain file
WSAIoctl(SIO_KEEPALIVE_VALS) failed: %ui
another command is already in progress
argument of lo_read exceeds integer range
argument of lo_truncate exceeds integer range
argument of lo_write exceeds integer range
attribute has no values on LDAP lookup
authentication method %u not supported
cannot determine OID of function lo_close
cannot determine OID of function lo_creat
cannot determine OID of function lo_create
cannot determine OID of function lo_lseek
cannot determine OID of function lo_lseek64
cannot determine OID of function lo_open
cannot determine OID of function lo_tell
cannot determine OID of function lo_tell64
cannot determine OID of function lo_truncate
cannot determine OID of function lo_truncate64
cannot determine OID of function lo_unlink
cannot determine OID of function loread
cannot determine OID of function lowrite
certificate could not be obtained: %s
certificate does not match private key file "%s": %s
certificate present, but not private key file "%s"
column number %d is out of range 0..%d command string is a null pointer
connection in wrong state
connection not open
connection pointer is NULL
could not acquire SSPI credentials could not connect to server: %s
Is the server running locally and accepting
connections on Unix domain socket "%s"?
could not connect to server: %s
Is the server running on host "%s" (%s) and accepting
TCP/IP connections on port %s?
could not connect to server: %s
Is the server running on host "%s" and accepting
TCP/IP connections on port %s?
could not create LDAP structure
could not create SSL context: %s
could not create socket: %s
could not establish SSL connection: %s
could not get client address from socket: %s
could not get home directory to locate root certificate file
Either provide the file or change sslmode to disable server certificate verification.
could not get home directory to locate service definition file could not get peer credentials: %s
could not get server's host name from server certificate
could not get socket error status: %s
could not initialize SSL engine "%s": %s
could not interpret result from server: %s could not load SSL engine "%s": %s
could not load private SSL key "%s" from engine "%s": %s
could not load private key file "%s": %s
could not look up local user ID %d: %s
could not open certificate file "%s": %s
could not open file "%s": %s
could not read certificate file "%s": %s
could not read from file "%s": %s
could not read private SSL key "%s" from engine "%s": %s
could not read root certificate file "%s": %s
could not receive data from server: %s
could not send SSL negotiation packet: %s
could not send data to server: %s
could not send startup packet: %s
could not set socket to TCP no delay mode: %s
could not set socket to close-on-exec mode: %s
could not set socket to nonblocking mode: %s
could not translate Unix-domain socket path "%s" to address: %s
could not translate host name "%s" to address: %s
could not write to file "%s": %s
definition of service "%s" not found
duplicate GSS authentication request
duplicate SSPI authentication request
end of string reached when looking for matching "]" in IPv6 host address in URI: "%s"
expected authentication request from server, but received %c
extra key/value separator "=" in URI query parameter: "%s"
extraneous data in "D" message extraneous data in "T" message extraneous data in "t" message forbidden value %%00 in percent-encoded value: "%s"
function requires at least protocol version 3.0
host name must be specified
host name must be specified for a verified SSL connection
incomplete multibyte character
insufficient data in "D" message insufficient data in "T" message integer of size %lu not supported by pqGetInt integer of size %lu not supported by pqPutInt invalid ExecStatusType code invalid LDAP URL "%s": invalid port number
invalid LDAP URL "%s": missing distinguished name
invalid LDAP URL "%s": must have exactly one attribute
invalid LDAP URL "%s": must have search scope (base/one/sub)
invalid LDAP URL "%s": no filter
invalid LDAP URL "%s": scheme must be ldap://
invalid URI propagated to internal parser routine: "%s"
invalid URI query parameter: "%s"
invalid connection option "%s"
invalid connection state %d, probably indicative of memory corruption
invalid connection state, probably indicative of memory corruption
invalid percent-encoded token: "%s"
invalid port number: "%s"
invalid setenv state %c, probably indicative of memory corruption
invalid socket
invalid sslmode value: "%s"
invalid state %c, probably indicative of memory corruption
keepalives parameter must be an integer
length must be given for binary parameter
line %d too long in service file "%s"
local user with ID %d does not exist
lookup on LDAP server failed: %s
lost synchronization with server, resetting connection lost synchronization with server: got message type "%c", length %d
message contents do not agree with length in message type "%c"
message type 0x%02x arrived from server while idle missing "=" after "%s" in connection info string
missing key/value separator "=" in URI query parameter: "%s"
more than one entry found on LDAP lookup
nested service specifications not supported in service file "%s", line %d
no COPY in progress
no SSL error reported no connection to the server
no entry found on LDAP lookup
no error message available
number of parameters must be between 0 and 65535
out of memory out of memory
out of memory allocating GSSAPI buffer (%d) out of memory for query result parameter number %d is out of range 0..%d password retrieved from file "%s"
private key file "%s" has group or world access; permissions should be u=rw (0600) or less
protocol error: id=0x%x
query to initialize large object functions did not return data
received invalid response to SSL negotiation: %c
requirepeer parameter is not supported on this platform
requirepeer specifies "%s", but actual peer user name is "%s"
root certificate file "%s" does not exist
Either provide the file or change sslmode to disable server certificate verification.
row number %d is out of range 0..%d select() failed: %s
server certificate for "%s" does not match host name "%s"
server closed the connection unexpectedly
This probably means the server terminated abnormally
before or while processing the request.
server does not support SSL, but SSL was required
server sent binary data ("B" message) without prior row description ("T" message) server sent data ("D" message) without prior row description ("T" message) server sent data ("D" message) without prior row description ("T" message)
service file "%s" not found
setsockopt(%s) failed: %s
sslmode value "%s" invalid when SSL support is not compiled in
statement name is a null pointer
syntax error in service file "%s", line %d
timeout expired
unexpected asyncStatus: %d
unexpected character "%c" at position %d in URI (expected ":" or "/"): "%s"
unexpected character %c following empty query response ("I" message) unexpected field count in "D" message unexpected message from server during startup
unexpected response from server; first received character was "%c"
unrecognized SSL error code: %d
unrecognized socket error: 0x%08X/%d unterminated quoted string in connection info string
user name lookup failure: error code %lu
Project-Id-Version: PostgreSQL 9.6
Report-Msgid-Bugs-To: pgsql-bugs@postgresql.org
POT-Creation-Date: 2017-08-06 01:59-0300
PO-Revision-Date: 2005-10-04 22:45-0300
Last-Translator: Euler Taveira de Oliveira <euler@timbira.com>
Language-Team: Brazilian Portuguese <pgbr-dev@listas.postgresql.org.br>
Language: pt_BR
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
no caracter %s %s %s, %s:%s NOME DA COLUNA: %s
NOME DA RESTRIÇÃO: %s
CONTEXTO: %s
estado de COPY IN deve ser terminado primeiro
estado de COPY OUT deve ser terminado primeiro
COPY terminado por novo PQexec Autenticação crypt não é suportada
NOME DO TIPO DE DADO: %s
DETALHE: %s
Autenticação GSSAPI não é suportada
erro ao continuar autenticação GSSAPI erro de importação de nome GSSAPI DICA: %s
endereço IPv6 não pode ser vazio na URI: "%s"
Autenticação Kerberos 4 não é suportada
Autenticação Kerberos 5 não é suportada
LINHA %d: LOCAL: NOTA PGEventProc "%s" falhou durante evento PGEVT_CONNRESET
PGEventProc "%s" falhou durante evento PGEVT_RESULTCREATE
PGresult não é um resultado de erro
PQexec não é permitido durante COPY BOTH
PQgetline: não está fazendo COPY OUT de texto
CONSULTA: %s
NOME DO ESQUEMA: %s
método de autenticação SCM_CRED não é suportado
autenticação SCRAM requer libpq com versão 10 ou superior
Erro de SYSCALL SSL: %s
Erro de SYSCALL SSL: EOF detectado
nome do certificado SSL contém nulo embutido
entrada do nome do certificado SSL está ausente
conexão SSL foi fechada inesperadamente
código de erro SSL %lu Erro de SSL: %s
biblioteca SSL não suporta certificados CRL (arquivo "%s")
Autenticação SSPI não é suportada
erro ao continuar autenticação SSPI NOME DA TABELA: %s
caminho do soquete de domínio Unix "%s" é muito longo (máximo de %d bytes)
AVISO: arquivo de senhas "%s" tem acesso de leitura para outros ou grupo; permissões devem ser u=rw (0600) ou menos que isso
AVISO: arquivo de senhas "%s" não é um arquivo no formato texto
WSAIoctl(SIO_KEEPALIVE_VALS) falhou: %ui
outro comando já está em execução
argumento do lo_read excede intervalo de inteiros
argumento do lo_truncate excede intervalo de inteiros
argumento de lo_write excede intervalo de inteiros
atributo não tem valores na busca no LDAP
método de autenticação %u não é suportado
não pode determinar OID da função lo_close
não pode determinar OID da função lo_creat
não pode determinar OID da função lo_create
não pode determinar OID da função lo_lseek
não pode determinar OID da função lo_lseek64
não pode determinar OID da função lo_open
não pode determinar OID da função lo_tell
não pode determinar OID da função lo_tell64
não pode determinar OID da função lo_truncate
não pode determinar OID da função lo_truncate64
não pode determinar OID da função lo_unlink
não pode determinar OID da função loread
não pode determinar OID da função lowrite
certificado não pôde ser obtido: %s
certificado não corresponde a chave privada "%s": %s
certificado presente, mas não a chave privada "%s"
coluna número %d está fora do intervalo 0..%d cadeia de caracteres do comando é um ponteiro nulo
conexão em estado errado
conexão não está aberta
ponteiro da conexão é NULO
não pôde obter credenciais SSPI não pôde conectar ao servidor: %s
O servidor está executando localmente e aceitando
conexões no soquete de domínio Unix "%s"?
não pôde conectar ao servidor: %s
O servidor está executando na máquina "%s" (%s) e aceitando
conexões TCP/IP na porta %s?
não pôde conectar ao servidor: %s
O servidor está executando na máquina "%s" e aceitando
conexões TCP/IP na porta %s?
não pôde criar estrutura LDAP
não pôde criar contexto SSL: %s
não pôde criar soquete: %s
não pôde estabelecer conexão SSL: %s
não pôde obter do soquete o endereço do cliente: %s
não pôde obter diretório base do usuário para localizar arquivo do certificado
Forneça um arquivo ou mude o sslmode para desabilitar a verificação de certificado do servidor.
não pôde obter diretório base do usuário para localizar arquivo de definição de serviço não pôde receber credenciais: %s
não pôde obter nome de máquina do servidor a partir do certificado do servidor
não pôde obter status de erro do soquete: %s
não pôde inicializar mecanismo SSL "%s": %s
não pôde interpretar resultado do servidor: %s não pôde carregar mecanismo SSL "%s": %s
não pôde carregar chave privada SSL "%s" do mecanismo "%s": %s
não pôde carregar arquivo contendo chave privada "%s": %s
não pôde encontrar ID de usuário local %d: %s
não pôde abrir certificado "%s": %s
não pôde abrir arquivo "%s": %s
não pôde ler certificado "%s": %s
não pôde ler do arquivo "%s": %s
não pôde ler chave privada SSL "%s" do mecanismo "%s": %s
não pôde ler certificado raiz "%s": %s
não pôde receber dados do servidor: %s
não pôde mandar pacote de negociação SSL: %s
não pôde enviar dados ao servidor: %s
não pôde enviar pacote de inicialização: %s
não pôde configurar o soquete para modo TCP sem atraso: %s
não pôde configurar o soquete para modo fechar-após-execução: %s
não pôde configurar o soquete para modo não bloqueado: %s
não pôde traduzir caminho do soquete de domínio Unix "%s" para endereço: %s
não pôde traduzir nome da máquina "%s" para endereço: %s
não pôde escrever no arquivo "%s": %s
definição de serviço "%s" não foi encontrado
pedido de autenticação GSS duplicado
pedido de autenticação SSPI duplicado
fim da cadeia de caracteres atingido quando procurava por "]" no endereço IPv6 na URI: "%s"
pedido de autenticação esperado do servidor, mas foi recebido %c
separador de chave/valor "=" extra no parâmetro da URI: "%s"
dados estranhos na mensagem "D" dados estranhos na mensagem "T" dados estranhos na mensagem "t" valor %%00 proibido em valor escapado com porcentagem: "%s"
função requer pelo menos a versão 3.0 do protocolo
nome da máquina deve ser especificado
nome da máquina deve ser especificado para uma conexão SSL verificada
caracter multibyte incompleto
dados insuficientes na mensagem "D" dados insuficientes na mensagem "T" inteiro de tamanho %lu não é suportado por pqGetInt inteiro de tamanho %lu não é suportado por pqPutInt código de ExecStatusType é inválido URL LDAP "%s" é inválida: número de porta é inválido
URL LDAP "%s" é inválida: faltando nome distinto
URL LDAP "%s" é inválida: deve ter exatamente um atributo
URL LDAP "%s" é inválida: deve ter escopo de busca (base/one/sub)
URL LDAP "%s" é inválida: nenhum filtro
URL LDAP "%s" é inválida: esquema deve ser ldap://
URI inválida propagada para rotina interna do analisador: "%s"
parâmetro da URI é inválido: "%s"
opção de conexão "%s" é inválida
estado de conexão %d é inválido, provavelmente indicativo de corrupção de memória
estado de conexão é inválido, provavelmente indicativo de corrupção de memória
elemento escapado com porcentagem é inválido: "%s"
número de porta inválido: "%s"
estado de setenv %c é inválido, provavelmente indicativo de corrupção de memória
soquete inválido
valor do modo ssl desconhecido: "%s"
estado %c é inválido, provavelmente indicativo de corrupção de memória
parâmetro keepalives deve ser um inteiro
tamanho deve ser informado para um parâmetro binário
linha %d é muito longa no arquivo de serviço "%s"
usuário local com ID %d não existe
busca em servidor LDAP falhou: %s
perda de sincronismo com o servidor, reiniciando conexão perda de sincronismo com o servidor: recebeu tipo de mensagem "%c", tamanho %d
conteúdo da mensagem não está de acordo com o tamanho no tipo de mensagem "%c"
tipo de mensagem 0x%02x chegou do servidor enquanto estava ocioso faltando "=" depois de "%s" na cadeia de caracteres de conexão
faltando separador de chave/valor "=" no parâmetro da URI: "%s"
mais de um registro encontrado na busca no LDAP
especificações de serviço aninhadas não são suportadas no arquivo de serviço "%s", linha %d
nenhum COPY está em execução
nenhum erro SSL relatado sem conexão ao servidor
nenhum registro encontrado na busca no LDAP
nenhuma mensagem de erro disponível
número de parâmetros deve ser entre 0 e 65535
sem memória sem memória
sem memória para alocar buffer para GSSAPI (%d) sem memória para resultado da consulta parâmetro número %d está fora do intervalo 0..%d senha obtida do arquivo "%s"
chave privada "%s" tem acesso de leitura para outros ou grupo; permissões devem ser u=rw (0600) ou menos que isso
erro de protocolo: id=0x%x
consulta para inicializar funções de objeto grande não retornou dados
a negociação SSL recebeu uma resposta inválida: %c
parâmetro requirepeer não é suportado nessa plataforma
requirepeer especificou "%s", mas nome de usuário atual é "%s"
certificado raiz "%s" não existe
Forneça um arquivo ou mude o sslmode para desabilitar a verificação de certificado do servidor.
linha número %d está fora do intervalo 0..%d select() falhou: %s
certificado do servidor para "%s" não corresponde ao nome da máquina "%s"
servidor fechou a conexão inesperadamente
Isto provavelmente significa que o servidor terminou de forma anormal
antes ou durante o processamento do pedido.
servidor não suporta SSL, mas SSL foi requerido
servidor enviou dados binários (mensagem "B") sem antes enviar descrição de registro (mensagem "T") servidor enviou dados (mensagem "D") sem antes enviar descrição de registro (mensagem "T") servidor enviou dados (mensagem "D") sem antes enviar descrição de registro (mensagem "T")
arquivo de serviço "%s" não foi encontrado
setsockopt(%s) falhou: %s
valor "%s" do modo ssl é inválido quando suporte a SSL não foi compilado
nome do comando é um ponteiro nulo
erro de sintaxe no arquivo de serviço "%s", linha %d
tempo de espera expirado
asyncStatus inesperado: %d
caracter "%c" inesperado na posição %d na URI (esperado ":" ou "/"): "%s"
caracter inesperado %c seguido de uma resposta de consulta vazia (mensagem "I") contagem de campos inesperada em mensagem "D" mensagem inesperada do servidor durante inicialização
resposta inesperada do servidor; primeiro caracter recebido foi "%c"
código de erro SSL desconhecido: %d
erro desconhecido de soquete: 0x%08X/%d cadeia de caracteres entre aspas não foi terminada na cadeia de caracteres de conexão
falhou ao pesquisar nome de usuário: código de erro %lu
locale/pt_BR/LC_MESSAGES/psql-9.6.mo 0000644 00000301743 14751153421 0012437 0 ustar 00 �� ; �! � �C hZ iZ Z �Z � �Z T[ p[
�[ �[ > �[ = �[ < %\ p b\ s �\ 5 G] 7 }] K �] o ^ 2 q^ 4 �^ N �^ t (_ Q �_ O �_ > ?` A ~` O �` @ a 6 Qa 0 �a N �a G b 8 Pb A �b T �b ? c L `c A �c @ �c H 0d A yd + �d � �d 5 }e 9 �e n �e Q \f : �f � �f ; vg y �g � ,h ; �h z i T i A �i L j B cj \ �j 4 k J 8k \ �k 6 �k 4 l G Ll = �l ; �l ( m ; 7m ; sm ; �m ; �m 8 'n _ `n J �n F o ` Ro h �o G p 5 dp 2 �p X �p Q &q : xq 3 �q ; �q S #r M wr 9 �r @ �r 8 @s ; ys @ �s K �s J Bt | �t �
u > �u F �u N v F ev H �v - �v $ #w & Hw - ow 9 �w 7 �w 2 x 4 Bx 3 wx ) �x ) �x ; �x B ;y ) ~y * �y * �y J �y 1 Iz . {z - �z , �z 4 { I :{ $ �{ & �{ > �{ 1 | & A| ( h| J �| : �| ( } % @} $ f} $ �} ) �} - �} N ~ 9 W~ G �~ 5 �~ M C ] P � K � N >� K �� L ـ 4 &� K [� ( �� q Ё A B� ? �� A Ă > � X E� # �� F 8 � < B� M � ; ͅ 6 � 2 @� 7 s� B �� : � 4 )� 9 ^� ? �� % ؇ + �� 9 *� 5 d� I �� K � M 0� Z ~� S ى K -� � y� N � @ S� : �� ( ϋ B �� L ;� C �� � ̌ M {� = ɍ � � �� �� َ � � � � 0 � $ P� # u� * �� % ď * � � # 6� < Z� �� �� ː 6 � "� � 7� : ݑ � *� 6� C� X� b� s� �� �� Q �� �� I � [ Z�
�� �� ғ
� � � C � A a� �� �� �� ɔ ֔ ޔ � , �� $� ;� G� Q� ]� c� l� �� �� ��
�� ɕ Օ � ' � � & 4� ' [� 7 �� 0 �� � � � +� C� L� T� ]� w g� ߗ � � � %� ( >� g� s� �� �� �� ǘ ݘ � � � � )� ;� H� W� g�
o� }� �� �� ��
�� �� �� �� ř ʙ י
� �
� � & !� H� Q�
`�
n� |� �� �� ��
ɚ ך � �� � #� 3� J� b� y� �� �� ƛ ؛ �
��
� � % +� Q� " e� �� �� Ŝ � ' �� & !� H� Q� k� u� |� �� ��
�� �� L �� ��
� (� > E� �� �� �� 2 Ğ �� �� � %� ?� Q� Y� o� |� �� �� �� X Ο '� 0� M� d�
z� �� �� ' �� . Ϡ ! �� ' � H� R� l�
v� �� �� �� ԡ � � #� 4� , @� m� ~� �� �� �� �� �� ۢ E � (� 8� ?� H� Y�
`� k� t� y� �� �� �� �� �� ʣ ң ޣ � ��
� � ,�
E� P� a� f� r� �� �� �� ! Ǥ � � 9 � y V� 9 Х F
� 5 Q� B �� C ʦ 5 � : D� 9 � @ �� ; �� K 6� B �� C Ũ 6 � 8 @� y� �� ��
�� �� ѩ �
� � � .� F� g� q� & y� �� �� ɪ Ϊ � � �� # �� # � # � (� " ?� b� y� �� �� �� ��
�� �� Ŭ Ҭ
� c � � R� � K 0� Q |� / ή O �� U N� 5 �� = گ � , $� 4 Q� " �� ! �� ˰ � �� � " /� + R� + ~� 6 �� X � 7 :� 8 r� T �� 5 � I 6� 6 �� # �� = ۳ = � = W� i �� 9 �� 9� T� * u� �� �� ڵ ��
� � � '� ;� A� K� U� \� m� �� # �� ̶ � $ �� �
1� ?� H� Q� Y� a� i�
r� �� �� �� �� �� �� Ʒ ̷ C ٷ � / .� ( ^� �� �� �� �� ̸ ' � � $ /� % T� ! z� ) �� ( ƹ / � # � ' C� , k� . �� 4 Ǻ �� ! � - >� l� % �� 4 �� 1 � - � / H� " x� �� ' �� � . � ) 2� % \� ! �� $ �� * ɽ + � A � b� j� & {� 0 �� . Ӿ ) � ) ,� V� % e� ��
��
�� �� # �� Կ � � � � � $� 0� 8� O� C a� �� � � � �� � � ;�
E� P� $ `� & �� - �� # � �� 1 � ( Q� ) z� + �� ' �� ! �� � # 5� ! Y� ( {� �� �� �� �� � 4� :� P� k� w�
�� �� ��
�� �� �� �� �� � ,� C� Z� u� �� �� �� �� ! �� � 4� 2 G� z� �� �� �� �� � 2 #� 5 V� �� �� �� . �� � & � # A� e� ! �� �� �� �� �� �� 6 � ) V� ��
�� �� �� �� �� ��
�� & �� � !� +� 5� >� T� f� x� �� �� �� ��
�� �� U �� -� >� D� , T� �� �� �� �� ��
�� �� � � #� )� 2� B� " T�
w� �� �� �� �� �� ��
�� 1 �� � 8�
J� U� f� w� . �� �� . ��
�� �� � � !� 2�
?� J� E [� ��
�� �� �� �� �� �� � � "� 6� K� * d� ��
�� �� �� �� �� �� �� ��
�� �� � � � 2� >� H� T� n� �� �� �� �� �� �� �� ��
�� �� �� �� � � % !� G� N� _� p� u� |� �� �� �� �� �� �� ��
�� �� � � � � 1� M� T� ]� i� r� ~� �� �� �� �� �� �� �� �� ��
�� �� ��
� � %� 7� G� S� ]� j� v� � �� �� �� �� �� ! �� 4 ��
"� 0� . 9� h� y� � �� �� �� �� ��
��
��
�� � � *� =� O� f� " v� �� �� �� �� �� � / .� ^� n� �� �� " �� �� �� � � 3� * D�
o� }� �� �� �� �� �� � � 3� 0 M� + ~� �� �� �� > ��
�
� ) � " C� f� n�
�� �� �� �� �� �� �� �� �� �� � � �
� )�
2�
@� K� W� c� 7 r� 2 �� 6 �� V � k� & q� & �� . �� �� ��
�
�
)� 7� G� T� `� h� o� u� �� �� �� �� ! �� �� �� � �
!� ,� 4� J� a� . p� �� �� �� ��
�� �� �� � � )� 2� 7� A� J�
_� j� y� �� �� �� �� �� �� �� � � $ %� # J� n� w� 0 � �� �� �� �� �� ( � .� 8�
I� T� `� s� y� �� �� �� �� �� �� , �� �� � 3� $ O� t� ' �� �� �� �� � � 9� N� ! o� �� �� ��
�� �� �� � �� �� �� �� � �� �� " �� �� �� H �� A E� : �� � �� v I� 7 �� @ �� K 9� � �� 9 � = H� Z �� � �� R t� [ �� O #� I s� I �� M � 9 U� 8 �� Q �� [ � @ v� D �� l �� K i� X �� S � O b� _ �� G � 3 Z� � �� 0 -� ? ^� � �� ] !� K � � �� C r� y �� � 0� N �� } 3� [ �� W
� T e� S �� g � 2 v� F �� l � = ]� = �� I � ? #� = c� / �� = � = � = M� 9 �� 9 � l �� O l� H �� a � k g� N � F "� 5 i� c �� Y � A ]� ; �� H � [ $� M �� H � Q A i Z � H h O M � � � � > 2 B q R � M ` U 2 � 4 � ) 0 H @ y = � = � 8 6 6 o , � . � > H A 8 � + � + � Y 4 u 3 � 0 � 7 = G Q � % � ( � C &
6 j
( �
* �
X �
K N + � ' � % � ' * < 3 g X � H � S =
F �
W �
O 0 b � X � [ < Y � S � 8 F H / � � � U | B � G N ] c � & X 7 ? � D � ] ? s ; � 8 � = ( Z f : � C � > @ B ' � / � B @ ] X � _ � X W a � S Y f � � Y m < � 6 ) ; L e b � 4 � J [ O t � � ] y � � � � � � 6 � * % : % ` - � 5 � & � ' ! Y 9! + �! �! * �! = �! :" � Y" : # K#
]# h# w# �# �# �# �# �# g �# X$ L s$ ^ �$ % )% =%
U% 2 `% �% a �% ] & j&
�& �& �& �& �& �& / �& ' 0' :' B' L' R' a' $ �' " �' �' �' �' �' �' / �' " .( / Q( - �( E �( @ �( 6) W) m) # �) �)
�)
�) �) � �) k* �* �* ) �* ' �* 3 �* !+ .+ A+ J+ " h+ �+ �+ " �+
�+ �+ �+ �+ , , 8, P, \, k, r, u, �, �, �, �, �,
�, �, �, - - &-
3- , A- n- x- �- �- �- �- �- " �- . 3. I. ^. u. �. �. �. �. & �. / 0/ O/ c/ w/ �/ �/ �/ - �/ �/ ) 0 & 30 & Z0 ! �0 ! �0 8 �0 6 �0 51 ;1 X1 b1 j1
v1 �1 �1 �1 [ �1
2 1 2 6 M2 X �2 " �2 ' 3 (3 B B3 �3 �3 �3 �3 �3 �3 �3
4 4 ! 4 ( =4 ' f4 | �4 5 5 65 O5 b5 j5
�5 ? �5 H �5 8 6 ? R6 �6 �6 �6 �6 �6 & �6 !7 ' B7 % j7 �7 �7 �7 , �7 �7
8 8 :8 ?8 L8 & f8 �8 C �8
�8 �8
�8 �8
9 9 #9 09 89
>9
L9 W9 r9
�9
�9
�9 �9 �9 �9 �9 �9 + :
0: ;:
L: W: a: q: �: $ �: ' �: �: # ; 9 (; � b; 9 #< J ]< @ �< F �< D 0= 1 u= : �= 7 �= D > 4 _> R �> H �> F 0? 2 w? ? �? �? @ ' @ % :@ `@ r@ �@ �@ & �@ ) �@ �@ ( A @A
JA 7 UA # �A ! �A �A �A � �A �B * �B + (C / TC �C % �C �C �C �C �C
D D D )D 1D @D WD j dD � �D & �E ` �E c LF . �F f �F i FG G �G L �G EH / QH 8 �H �H # �H " �H !I " .I QI ( rI - �I 8 �I ? J d BJ > �J ? �J i &K ? �K N �K < L $ \L H �L I �L M M n bM B �M N ( 5N 6 ^N �N " �N & �N �N O O O 'O >O EO QO bO iO {O �O * �O �O �O + P <P PP aP pP P �P �P �P �P
�P �P
�P �P �P Q Q Q W %Q }Q 0 �Q . �Q �Q R R (R ) HR 0 rR �R % �R $ �R !
S ) ,S ( VS 4 S " �S & �S . �S . -T G \T �T �T . �T U $ 5U 9 ZU 5 �U 4 �U 0 �U 0V QV 0 oV �V 1 �V + �V # W CW ! dW . �W 0 �W Q �W 8X >X 0 OX 2 �X 0 �X * �X * Y :Y * JY uY
}Y
�Y �Y + �Y
�Y �Y �Y �Y Z Z ,Z =Z EZ aZ W }Z �Z �Z
[ [ :[
J[ " X[ {[ �[ �[ ) �[ ) �[ 0 �[ % -\ , S\ = �\ + �\ 0 �\ 3 ] . O] % ~] �] & �] # �] 1 ^ " @^ c^ ! ^ - �^ . �^ �^ _ " #_ F_ R_ __ s_
�_ �_ �_ �_ �_ & �_ " ` @` \` & x` �` + �` ! �` a %a * Da oa �a A �a $ �a b $ b & Cb $ jb " �b M �b 7 c 8c $ Oc tc < �c �c / �c + d * ?d & jd �d �d �d �d % �d < #e * `e �e �e �e �e �e �e �e �e 6 f If Zf
df of |f �f �f
�f �f , �f
g
g !g 4g h Ag �g �g �g 1 �g h $ #h Hh Yh oh
�h �h
�h �h �h �h �h �h . �h i /i <i
Fi Qi fi oi
�i 5 �i �i �i
�i j j 2j 3 Dj xj 6 �j �j
�j �j �j �j k k k G 4k |k
�k �k �k �k
�k �k �k �k l )l @l . `l �l �l �l �l
�l
�l �l �l �l
m m
m .m >m Pm ]m gm zm . �m
�m
�m �m �m
n n !n
6n
Dn Rn Zn jn
~n
�n - �n �n �n �n o o o 1o Bo Xo io yo �o �o �o �o �o �o �o �o ) �o p p (p 4p Cp Op \p op {p
�p
�p �p �p �p �p
�p �p q q
!q /q Aq Qq
]q hq yq �q �q �q �q �q �q �q " �q ;
r Ir
[r . fr �r �r �r �r �r
�r �r
s s -s <s Zs qs �s �s ! �s �s ' �s t % .t Tt ht �t �t F �t
u u 5u Gu * ]u & �u % �u ! �u �u v : $v _v qv �v " �v �v �v w w %w ! Ew H gw 1 �w �w �w �w J x Qx Zx 7 ox * �x �x �x �x y y / y Py
Vy ay hy {y �y �y �y �y �y
�y �y �y
�y
z z E +z / qz 6 �z \ �z 5{ * K{ 6 v{ 0 �{ �{ �{ | | 0| F|
[| i| u| ~| �| �| �| �| �| �| ! �|
} "} ;} N}
b} m} u} �} �} @ �} �} �} ~ % &~ L~ X~ h~ {~ �~ �~ �~ �~
�~ �~
�~ �~ �~ 1 ! 6 X y � � + � & � � � 2 � E� 4 N�
�� �� �� 9 ǀ
� � � ,� A� V� \� d� l� s� �� �� �� ' � � "� # >� b� ( w� �� �� ݂ �� � 0� # G� k�
�� �� ��
�� ̃ ߃ n J � � � � � � � � ) B 5 � L ( $ � � \ j e ( � � � & � � � k � 7 , � � � � � 0 v � � �
z � S q < � v � | � � z � � � � f y � � M 3 Z � � d i
* � B � � ; & � � � * P 7 � : � ' � T � � 4 � � / t � � @ Y u � 0 � � � � t � - , � � � � J s ~ r � F p R � � � � � � N 3 � D � S � � Q � y � c � � � E w _ m � � � � M � , � ^ T � X b + 4 ` � � � � w � � � o < � � � � [ � - / � � � 7 � y j 5 � | & � = � U l � � � � g � � X ( � � ] � f x � } � ) � � # r � � � T � v 1 X [ � G � b 1 � � � # � k K � � : � � � 1 � 2 * ] W � s � % � u C � H g V x S � � � � H e � 8 [ Q � 7 � � � j c � � � � � � � � / 4 � � � 2 � � � � O q � � � i a h �
� � � � � � � � � � N � � � � 9 p w � � � o = � � R . � � ) � � � � � g � 9 > L ( � � b � z x � � � U x E � G � � � � � � Y � � A � � � � � ~ � � � � � v k 8 = C � 2 � � � n � Z � � 6 � r � � � � " � ? u t � u L a � � � � � p Y � ; � � � � g h � � 9 2 � � + � � i � � � G � � � � � � | � p K � \ � � � � � _ > N E Z h B m � � � q � � 9 J � � 5 � . � � � � O } . $ � � � F � � ( � { X � M
� � � n � ! � � r � h # � � � � [ � � � I 1 I 4 � �
P � � � � � � k � � � � � 0 � � V 6 P � " ` N O V o � I � � ; � t ! � & m 0 � W f @ � a : 7 ; R B H � K ] � � T � � � � 8 � � d E � � ~ ? � � 0 5 � � � > " � � � Q % * � o & A y � L $ � � � { < � ~ ! ^ � ! @ � � : C F � � � � � 8 U ' � � m $ � � \ � � � � � � � = - n � � � W � A � � � _ ` Q �
' W D ^ j w " � � � � � � M � � � � � � � A � � l # � � � � � _ � � { O F Y 2 c � � f ? � � � � e } $ { � � % D � � � � � � � # , ) H ? q ' � - + � � � : � � � � � �
b � < � - � I 6 \ ] � ; � % �
|
� � D . � s @ � � � � � � a 3 � � / ' � � � 1 � s 9 � � ! c � � � � � / " J � d � � � � � � � � 3 � � > % � ) � � � 4 � l � � 3 � � � � � 8 � � � . � U � � � � * � � � � � � 6 � K ,
� � l � � � � i � S ^ � � ` � � V 6 P � G } � � R � C d + Z � � � z � � � � � + � � � 5 e
Connection options:
Display settings:
Environment variables:
For more information, type "\?" (for internal commands) or "\help" (for SQL
commands) from within psql, or consult the psql section in the PostgreSQL
documentation.
Input and output options:
Output format options:
Parser: "%s"
Parser: "%s.%s" --help=commands list backslash commands, then exit
--help=variables list special variables, then exit
(options: S = show system objects, + = additional detail)
-0, --record-separator-zero
set record separator for unaligned output to zero byte
-1 ("one"), --single-transaction
execute as a single transaction (if non-interactive)
-?, --help[=options] show this help, then exit
-A, --no-align unaligned table output mode
-E, --echo-hidden display queries that internal commands generate
-F, --field-separator=STRING
field separator for unaligned output (default: "%s")
-H, --html HTML table output mode
-L, --log-file=FILENAME send session log to file
-P, --pset=VAR[=ARG] set printing option VAR to ARG (see \pset command)
-R, --record-separator=STRING
record separator for unaligned output (default: newline)
-S, --single-line single-line mode (end of line terminates SQL command)
-T, --table-attr=TEXT set HTML table tag attributes (e.g., width, border)
-U, --username=USERNAME database user name (default: "%s")
-V, --version output version information, then exit
-W, --password force password prompt (should happen automatically)
-X, --no-psqlrc do not read startup file (~/.psqlrc)
-a, --echo-all echo all input from script
-b, --echo-errors echo failed commands
-c, --command=COMMAND run only single command (SQL or internal) and exit
-d, --dbname=DBNAME database name to connect to (default: "%s")
-e, --echo-queries echo commands sent to server
-f, --file=FILENAME execute commands from file, then exit
-h, --host=HOSTNAME database server host or socket directory (default: "%s")
-l, --list list available databases, then exit
-n, --no-readline disable enhanced command line editing (readline)
-o, --output=FILENAME send query results to file (or |pipe)
-p, --port=PORT database server port (default: "%s")
-q, --quiet run quietly (no messages, only query output)
-s, --single-step single-step mode (confirm each query)
-t, --tuples-only print rows only
-v, --set=, --variable=NAME=VALUE
set psql variable NAME to VALUE
(e.g., -v ON_ERROR_STOP=1)
-w, --no-password never prompt for password
-x, --expanded turn on expanded table output
-z, --field-separator-zero
set field separator for unaligned output to zero byte
AUTOCOMMIT if set, successful SQL commands are automatically committed
COLUMNS number of columns for wrapped format
COMP_KEYWORD_CASE determines the case used to complete SQL key words
[lower, upper, preserve-lower, preserve-upper]
DBNAME the currently connected database name
ECHO controls what input is written to standard output
[all, errors, none, queries]
ECHO_HIDDEN if set, display internal queries executed by backslash commands;
if set to "noexec", just show without execution
ENCODING current client character set encoding
FETCH_COUNT the number of result rows to fetch and display at a time
(default: 0=unlimited)
HISTCONTROL controls command history [ignorespace, ignoredups, ignoreboth]
HISTFILE file name used to store the command history
HISTSIZE the number of commands to store in the command history
HOST the currently connected database server host
IGNOREEOF if unset, sending an EOF to interactive session terminates application
LASTOID value of the last affected OID
NAME=VALUE [NAME=VALUE] psql ...
or \setenv NAME [VALUE] inside psql
ON_ERROR_ROLLBACK if set, an error doesn't stop a transaction (uses implicit savepoints)
ON_ERROR_STOP stop batch execution after error
PAGER name of external pager program
PGAPPNAME same as the application_name connection parameter
PGDATABASE same as the dbname connection parameter
PGHOST same as the host connection parameter
PGPASSFILE password file name
PGPASSWORD connection password (not recommended)
PGPORT same as the port connection parameter
PGUSER same as the user connection parameter
PORT server port of the current connection
PROMPT1 specifies the standard psql prompt
PROMPT2 specifies the prompt used when a statement continues from a previous line
PROMPT3 specifies the prompt used during COPY ... FROM STDIN
PSQLRC alternative location for the user's .psqlrc file
PSQL_EDITOR, EDITOR, VISUAL
editor used by the \e, \ef, and \ev commands
PSQL_EDITOR_LINENUMBER_ARG
how to specify a line number when invoking the editor
PSQL_HISTORY alternative location for the command history file
QUIET run quietly (same as -q option)
SHELL shell used by the \! command
SHOW_CONTEXT controls display of message context fields [never, errors, always]
SINGLELINE end of line terminates SQL command mode (same as -S option)
SINGLESTEP single-step mode (same as -s option)
TMPDIR directory for temporary files
USER the currently connected database user
VERBOSITY controls verbosity of error reports [default, verbose, terse]
\! [COMMAND] execute command in shell or start interactive shell
\? [commands] show help on backslash commands
\? options show help on psql command-line options
\? variables show help on special variables
\C [STRING] set table title, or unset if none
\H toggle HTML output mode (currently %s)
\T [STRING] set HTML <table> tag attributes, or unset if none
\a toggle between unaligned and aligned output mode
\c[onnect] {[DBNAME|- USER|- HOST|- PORT|-] | conninfo}
connect to new database (currently "%s")
\c[onnect] {[DBNAME|- USER|- HOST|- PORT|-] | conninfo}
connect to new database (currently no connection)
\cd [DIR] change the current working directory
\conninfo display information about current connection
\copy ... perform SQL COPY with data stream to the client host
\copyright show PostgreSQL usage and distribution terms
\crosstabview [COLUMNS] execute query and display results in crosstab
\dA[+] [PATTERN] list access methods
\dC[+] [PATTERN] list casts
\dD[S+] [PATTERN] list domains
\dE[S+] [PATTERN] list foreign tables
\dF[+] [PATTERN] list text search configurations
\dFd[+] [PATTERN] list text search dictionaries
\dFp[+] [PATTERN] list text search parsers
\dFt[+] [PATTERN] list text search templates
\dL[S+] [PATTERN] list procedural languages
\dO[S+] [PATTERN] list collations
\dT[S+] [PATTERN] list data types
\d[S+] list tables, views, and sequences
\d[S+] NAME describe table, view, sequence, or index
\da[S] [PATTERN] list aggregates
\db[+] [PATTERN] list tablespaces
\dc[S+] [PATTERN] list conversions
\dd[S] [PATTERN] show object descriptions not displayed elsewhere
\ddp [PATTERN] list default privileges
\des[+] [PATTERN] list foreign servers
\det[+] [PATTERN] list foreign tables
\deu[+] [PATTERN] list user mappings
\dew[+] [PATTERN] list foreign-data wrappers
\df[antw][S+] [PATRN] list [only agg/normal/trigger/window] functions
\dg[S+] [PATTERN] list roles
\di[S+] [PATTERN] list indexes
\dl list large objects, same as \lo_list
\dm[S+] [PATTERN] list materialized views
\dn[S+] [PATTERN] list schemas
\do[S] [PATTERN] list operators
\dp [PATTERN] list table, view, and sequence access privileges
\drds [PATRN1 [PATRN2]] list per-database role settings
\ds[S+] [PATTERN] list sequences
\dt[S+] [PATTERN] list tables
\du[S+] [PATTERN] list roles
\dv[S+] [PATTERN] list views
\dx[+] [PATTERN] list extensions
\dy [PATTERN] list event triggers
\e [FILE] [LINE] edit the query buffer (or file) with external editor
\echo [STRING] write string to standard output
\ef [FUNCNAME [LINE]] edit function definition with external editor
\encoding [ENCODING] show or set client encoding
\errverbose show most recent error message at maximum verbosity
\ev [VIEWNAME [LINE]] edit view definition with external editor
\f [STRING] show or set field separator for unaligned query output
\g [FILE] or ; execute query (and send results to file or |pipe)
\gexec execute query, then execute each value in its result
\gset [PREFIX] execute query and store results in psql variables
\h [NAME] help on syntax of SQL commands, * for all commands
\i FILE execute commands from file
\ir FILE as \i, but relative to location of current script
\l[+] [PATTERN] list databases
\lo_export LOBOID FILE
\lo_import FILE [COMMENT]
\lo_list
\lo_unlink LOBOID large object operations
\o [FILE] send all query results to file or |pipe
\p show the contents of the query buffer
\password [USERNAME] securely change the password for a user
\prompt [TEXT] NAME prompt user to set internal variable
\pset [NAME [VALUE]] set table output option
(NAME := {format|border|expanded|fieldsep|fieldsep_zero|footer|null|
numericlocale|recordsep|recordsep_zero|tuples_only|title|tableattr|pager|
unicode_border_linestyle|unicode_column_linestyle|unicode_header_linestyle})
\q quit psql
\qecho [STRING] write string to query output stream (see \o)
\r reset (clear) the query buffer
\s [FILE] display history or save it to file
\set [NAME [VALUE]] set internal variable, or list all if no parameters
\setenv NAME [VALUE] set or unset environment variable
\sf[+] FUNCNAME show a function's definition
\sv[+] VIEWNAME show a view's definition
\t [on|off] show only rows (currently %s)
\timing [on|off] toggle timing of commands (currently %s)
\unset NAME unset (delete) internal variable
\w FILE write query buffer to file
\watch [SEC] execute query every SEC seconds
\x [on|off|auto] toggle expanded output (currently %s)
\z [PATTERN] same as \dp
border border style (number)
columns target width for the wrapped format
expanded (or x) expanded output [on, off, auto]
fieldsep field separator for unaligned output (default "%s")
fieldsep_zero set field separator for unaligned output to zero byte
footer enable or disable display of the table footer [on, off]
format set output format [unaligned, aligned, wrapped, html, asciidoc, ...]
linestyle set the border line drawing style [ascii, old-ascii, unicode]
null set the string to be printed in place of a null value
numericlocale enable or disable display of a locale-specific character to separate
groups of digits [on, off]
pager control when an external pager is used [yes, no, always]
psql --pset=NAME[=VALUE]
or \pset NAME [VALUE] inside psql
psql --set=NAME=VALUE
or \set NAME VALUE inside psql
psql [OPTION]... [DBNAME [USERNAME]]
recordsep record (line) separator for unaligned output
recordsep_zero set record separator for unaligned output to zero byte
set NAME=VALUE
psql ...
or \setenv NAME [VALUE] inside psql
tableattr (or T) specify attributes for table tag in html format or proportional
column widths for left-aligned data types in latex-longtable format
title set the table title for any subsequently printed tables
tuples_only if set, only actual table data is shown
unicode_border_linestyle
unicode_column_linestyle
unicode_header_linestyle
set the style of Unicode line drawing [single, double]
"%s.%s" is not a view
%d connection %d connections %s %s %s (every %gs)
%s
%s (%s, server %s)
%s (every %gs)
%s: %s
%s: -1 can only be used in non-interactive mode
%s: cannot copy from/to a directory
%s: could not delete variable "%s"
%s: could not find own program executable
%s: could not open log file "%s": %s
%s: could not set printing parameter "%s"
%s: could not set variable "%s"
%s: current transaction is aborted
%s: invalid encoding name or conversion procedure not found
%s: not connected to a database
%s: out of memory
%s: unknown transaction status
%s: warning: extra command-line argument "%s" ignored
(%lu row) (%lu rows) ***(Single step mode: verify command)*******************************************
%s
***(press return to proceed or enter x and return to cancel)********************
********* QUERY **********
%s
**************************
+ opt(%d) = |%s|
, clustered , deferrable , initially deferred , invalid , predicate (%s) , replica identity , tablespace "%s" Access privileges All connection parameters must be supplied because no database connection exists
Argument data types Asynchronous notification "%s" received from server process with PID %d.
Asynchronous notification "%s" with payload "%s" received from server process with PID %d.
Attributes Available help:
Border style is %d.
Bypass RLS COPY data transfer failed: %s Call Handler Cannot add cell to table content: total cell count of %d exceeded.
Cannot add header to table content: column count of %d exceeded.
Cannot login Check Check constraints: Child tables Collate Column Column privileges Command: %s
Description: %s
Syntax:
%s
Composite type "%s.%s" Connection
Create DB Create role Ctype Database Default access privileges Default footer is off.
Default footer is on.
Default? Definition Description Destination Dictionaries Did not find any extension named "%s".
Did not find any extensions.
Did not find any relation named "%s".
Did not find any relation with OID %s.
Did not find any text search configuration named "%s".
Did not find any text search parser named "%s".
Disabled internal triggers: Disabled rules: Disabled triggers: Disabled user triggers: Elements Enabled Encoding End parse Enter data to be copied followed by a newline.
End with a backslash and a period on a line by itself, or an EOF signal. Enter it again: Enter new password: Event Expanded display is off.
Expanded display is on.
Expanded display is used automatically.
FDW Options FDW Options: (%s) Failed.
Field separator is "%s".
Field separator is zero byte.
Foreign table "%s.%s" Foreign-data wrapper Foreign-key constraints: Formatting
Function General
General options:
Get headline Get next token Get token types Handler Has OIDs: yes Help
ID Implicit? Index Index "%s.%s" Indexes: Informational
Inherits Init Init options Inline Handler Input/Output
Internal Language Internal name Interrupted
Invalid command \%s. Try \? for help.
Language Large Objects
Large objects Left arg type Lexize Line style is %s.
List of access methods List of aggregate functions List of casts List of collations List of conversions List of data types List of databases List of domains List of event triggers List of foreign servers List of foreign tables List of foreign-data wrappers List of functions List of installed extensions List of languages List of operators List of relations List of roles List of schemas List of settings List of specially treated variables
List of tablespaces List of text search configurations List of text search dictionaries List of text search parsers List of text search templates List of user mappings Locale-adjusted numeric output is off.
Locale-adjusted numeric output is on.
Location Materialized view "%s.%s" Member of Method Modifier Modifiers Name No changes No connections No help available for "%s".
Try \h with no arguments to see available help.
No inheritance No matching relations found.
No matching settings found.
No per-database role settings support in this server version.
No relations found.
No settings found.
Null display is "%s".
Number of child tables: %d (Use \d+ to list them.) Object Object Description Object descriptions Objects in extension "%s" Operating System
Options Output format is %s.
Owned by: %s Owner Pager is always used.
Pager is used for long output.
Pager usage is off.
Pager won't be used for less than %d line.
Pager won't be used for less than %d lines.
Parallel Password encryption failed.
Password for user %s: Password valid until Password: Passwords didn't match.
Policies Policies (forced row security enabled): Policies (forced row security enabled): (none) Policies (row security disabled): Policies (row security enabled): (none) Policies: Previous connection kept
Procedure Query Buffer
Query buffer is empty. Query buffer reset (cleared). Record separator is "%s".
Record separator is <newline>.
Record separator is zero byte.
Referenced by: Replica Identity Replication Report bugs to <pgsql-bugs@postgresql.org>.
Result data type Result type Right arg type Role Role name Rules firing always: Rules firing on replica only: Rules: SSL connection (protocol: %s, cipher: %s, bits: %s, compression: %s)
STATEMENT: %s
Schema Security Sequence "%s.%s" Server Server: %s Settings Size Source Source code Source type Special relation "%s.%s" Start parse Stats target Storage Succeeded.
Superuser TOAST table "%s.%s" Table Table "%s.%s" Table attributes are "%s".
Table attributes unset.
Tablespace Tablespace: "%s" Tags Target type Target width is %d.
Target width is unset.
Template Text search configuration "%s" Text search configuration "%s.%s" Text search parser "%s" Text search parser "%s.%s" The connection to the server was lost. Attempting reset: The input is a PostgreSQL custom-format dump.
Use the pg_restore command-line client to restore this dump to a database.
The server (version %s) does not support access methods.
The server (version %s) does not support altering default privileges.
The server (version %s) does not support collations.
The server (version %s) does not support editing function source.
The server (version %s) does not support editing view definitions.
The server (version %s) does not support extensions.
The server (version %s) does not support foreign servers.
The server (version %s) does not support foreign tables.
The server (version %s) does not support foreign-data wrappers.
The server (version %s) does not support full text search.
The server (version %s) does not support savepoints for ON_ERROR_ROLLBACK.
The server (version %s) does not support showing function source.
The server (version %s) does not support showing view definitions.
The server (version %s) does not support tablespaces.
The server (version %s) does not support user mappings.
There is no previous error. Time: %.3f ms
Timing is off. Timing is on. Title is "%s".
Title is unset.
Token Token name Token types for parser "%s" Token types for parser "%s.%s" Triggers firing always: Triggers firing on replica only: Triggers: Trusted Try "%s --help" for more information.
Tuples only is off.
Tuples only is on.
Type Type "help" for help.
Type: \copyright for distribution terms
\h for help with SQL commands
\? for help with psql commands
\g or terminate with semicolon to execute query
\q to quit
Typed table of type: %s Unicode border line style is "%s".
Unicode column line style is "%s".
Unicode header line style is "%s".
Unlogged index "%s.%s" Unlogged materialized view "%s.%s" Unlogged table "%s.%s" Usage:
Use "\q" to leave %s.
User name Validator Value Variables
Version View "%s.%s" View definition: Volatility WARNING: %s major version %s, server major version %s.
Some psql features might not work.
WARNING: Console code page (%u) differs from Windows code page (%u)
8-bit characters might not work correctly. See psql reference
page "Notes for Windows users" for details.
Wrote history to file "%s".
You are connected to database "%s" as user "%s" on host "%s" at port "%s".
You are connected to database "%s" as user "%s" via socket in "%s" at port "%s".
You are currently not connected to a database.
You are now connected to database "%s" as user "%s" on host "%s" at port "%s".
You are now connected to database "%s" as user "%s" via socket in "%s" at port "%s".
You are now connected to database "%s" as user "%s".
You are using psql, the command-line interface to PostgreSQL. \!: failed
\%s: could not change directory to "%s": %s
\%s: environment variable name must not contain "="
\%s: error while setting variable
\%s: extra argument "%s" ignored
\%s: missing required argument
\connect: %s \copy: arguments required
\copy: parse error at "%s"
\copy: parse error at end of line
\crosstabview: ambiguous column name: "%s"
\crosstabview: column name not found: "%s"
\crosstabview: column number %d is out of range 1..%d
\crosstabview: data column must be specified when query returns more than three columns
\crosstabview: maximum number of columns (%d) exceeded
\crosstabview: query must return at least three columns
\crosstabview: query result contains multiple data values for row "%s", column "%s"
\crosstabview: statement did not return a result set
\crosstabview: vertical and horizontal headers must be different columns
\df does not take a "w" option with server version %s
\df only takes [antwS+] as options
\pset: allowed Unicode border line styles are single, double
\pset: allowed Unicode column line styles are single, double
\pset: allowed Unicode header line styles are single, double
\pset: allowed formats are unaligned, aligned, wrapped, html, asciidoc, latex, latex-longtable, troff-ms
\pset: allowed line styles are ascii, old-ascii, unicode
\pset: unknown option: %s
\watch cannot be used with COPY
\watch cannot be used with an empty query
abbreviated_grant_or_revoke abort the current transaction aborted because of read failure access_method_type action agg aggregate_name aggregate_signature alias alignment allowconn always analyze_function and aggregate_signature is: and conflict_action is one of: and grouping_element can be one of: and like_option is: and table_constraint is: and table_constraint_using_index is: and with_query is: arg_data_type arg_name arg_type argmode argname argtype argument argument_type arguments attribute attribute_name attribute_option base_type boolean cache call_handler cancel a transaction that was earlier prepared for two-phase commit canceled by user cannot duplicate null pointer (internal error)
cannot escape without active connection
canonical_function category change a database change a database role change a run-time parameter change a server configuration parameter change role name or membership change the definition of a collation change the definition of a conversion change the definition of a domain change the definition of a foreign server change the definition of a foreign table change the definition of a foreign-data wrapper change the definition of a function change the definition of a large object change the definition of a materialized view change the definition of a procedural language change the definition of a row level security policy change the definition of a rule change the definition of a schema change the definition of a sequence generator change the definition of a table change the definition of a tablespace change the definition of a text search configuration change the definition of a text search dictionary change the definition of a text search parser change the definition of a text search template change the definition of a trigger change the definition of a type change the definition of a user mapping change the definition of a view change the definition of an aggregate function change the definition of an event trigger change the definition of an extension change the definition of an index change the definition of an operator change the definition of an operator class change the definition of an operator family change the ownership of database objects owned by a database role channel check_expression child process exited with exit code %d child process exited with unrecognized status %d child process was terminated by exception 0x%X child process was terminated by signal %d child process was terminated by signal %s close a cursor cluster a table according to an index code collatable collate %s collation collect statistics about a database column_alias column_constraint column_definition column_name column_type com_op combinefunc command command not executable command not found commit a transaction that was earlier prepared for two-phase commit commit the current transaction compute a set of rows condition configuration_parameter conflict_action conflict_target connection to server was lost
connlimit constraint constraint_name copy data between a file and a table could not change directory to "%s": %s could not close pipe to external command: %s
could not execute command "%s": %s
could not find a "%s" to execute could not get home directory for user ID %ld: %s
could not identify current directory: %s could not locate temporary directory: %s
could not look up effective user ID %ld: %s could not open temporary file "%s": %s
could not parse reloptions array
could not read binary "%s" could not read from input file: %s
could not read symbolic link "%s" could not save history to file "%s": %s
could not set variable "%s"
could not start /bin/sh
could not start editor "%s"
could not stat file "%s": %s
could not write COPY data: %s
count create a new database create new rows in a table cursor_name data_type database_name deallocate a prepared statement default default %s default_expr define a cursor define a new access method define a new aggregate function define a new cast define a new collation define a new data type define a new database role define a new domain define a new encoding conversion define a new event trigger define a new foreign server define a new foreign table define a new foreign-data wrapper define a new function define a new index define a new mapping of a user to a foreign server define a new materialized view define a new operator define a new operator class define a new operator family define a new procedural language define a new rewrite rule define a new row level security policy for a table define a new savepoint within the current transaction define a new schema define a new sequence generator define a new table define a new table from the results of a query define a new tablespace define a new text search configuration define a new text search dictionary define a new text search parser define a new text search template define a new transform define a new trigger define a new view define access privileges define default access privileges define or change a security label applied to an object define or change the comment of an object definer definition delete delete rows of a table delimiter delimiter_character deserialfunc dest_encoding destroy a previously defined savepoint dictionary_name direction directory disabled discard session state domain constraint domain_constraint domain_name element empty a table or set of tables enabled encoding encoding_name end_function environment variable PSQL_EDITOR_LINENUMBER_ARG must be set to specify a line number
escape_character event exclude_element exclude_element in an EXCLUDE constraint is: execute a prepared statement execute an anonymous code block execution_cost existing_collation existing_enum_value expression extension_name family_name fdw_name ffunc filename filter_variable for table "%s.%s" force a transaction log checkpoint foreign table format_name from_item from_list from_sql_function_name function function name is required
function_name garbage-collect and optionally analyze a database generate a notification gettoken_function group_name grouping_element handler_function headline_function history is not supported by this installation
immutable import table definitions from a foreign server in assignment increment index index_column_name index_expression index_method index_name index_parameters index_parameters in UNIQUE, PRIMARY KEY, and EXCLUDE constraints are: index_predicate init_function initial_condition inline_handler input_function insert install an extension integer internallength invalid binary "%s" invalid command \%s
invalid line number: %s
invalid output format (internal error): %d invoker istemplate join_column join_condition join_proc join_type label lang_name large_object_oid lc_collate lc_ctype left_type lexize_function lextypes_function like_option like_type link_symbol listen for a notification load a shared library file local socket local_schema locale lock a table lockmode loid materialized view maxvalue member_object method mffunc minitial_condition minvalue minvfunc more than one row returned for \gset
msfunc mstate_data_size mstate_data_type name neg_op new_attribute_name new_column_name new_constraint_name new_dictionary new_enum_value new_name new_owner new_role new_schema new_table new_tablespace new_version no no query buffer
no rows returned for \gset
normal not null null_string obj_file object_name off old_dictionary old_role old_version on op_type opclass operator operator class operator family operator_name option or the old syntax out of memory out of memory
output_expression output_function output_name parameter parent_table parser_name password payload pclose failed: %s policy_name position a cursor predicate preferred prepare a statement for execution prepare the current transaction for two-phase commit primary key, provider psql is the PostgreSQL interactive terminal.
psql variables:
query quote_character rebuild indexes receive_function refcolumn referenced_table_name reftable relation_name remote_schema remove a cast remove a collation remove a conversion remove a data type remove a database remove a database role remove a domain remove a foreign server descriptor remove a foreign table remove a foreign-data wrapper remove a function remove a materialized view remove a procedural language remove a rewrite rule remove a row level security policy from a table remove a schema remove a sequence remove a table remove a tablespace remove a text search configuration remove a text search dictionary remove a text search parser remove a text search template remove a transform remove a trigger remove a user mapping for a foreign server remove a view remove access privileges remove an access method remove an aggregate function remove an event trigger remove an extension remove an index remove an operator remove an operator class remove an operator family remove database objects owned by a database role replace the contents of a materialized view replica res_proc restart restore the value of a run-time parameter to the default value restricted result_rows retrieve rows from a query using a cursor retrieve rows from a table or view rettype rewrite_rule_name right_type role_name role_specification roll back to a savepoint rule rule_name safe sampling_method savepoint_name schema_element schema_name seed select send_function sequence sequence_name serialfunc server_name server_type server_version set constraint check timing for the current transaction set the characteristics of the current transaction set the current user identifier of the current session set the session user identifier and the current user identifier of the current session sfunc show the execution plan of a statement show the value of a run-time parameter skipping recursive expansion of variable "%s"
snapshot_id sort_expression sort_family_name sort_operator source_config source_encoding source_table source_type special stable start start a transaction block start_function state_data_size state_data_type statement stop listening for a notification storage storage_parameter storage_type strategy_number sub-SELECT subtype subtype_diff_function subtype_operator_class support_number tab completion query failed: %s
Query was:
%s
table table constraint table_constraint table_constraint_using_index table_name tablespace_name tablespace_option target_role target_type template text timestamp timezone to_sql_function_name token_type transaction_id transaction_mode trigger trigger_name trying to exit copy mode type type_modifier_input_function type_modifier_output_function type_name uid unexpected PQresultStatus: %d
unexpected result status for \watch
unexpected transaction status (%d)
unique, unknown unrecognized value "%s" for "%s"; assuming "%s"
unsafe unterminated quoted string
update update rows of a table user does not exist user name lookup failure: error code %lu user_name using_expression using_list valfunction validator_function value values version view view name is required
view_option_name view_option_value volatile where abbreviated_grant_or_revoke is one of: where action is one of: where aggregate_signature is: where column_constraint is: where conflict_target can be one of: where constraint is: where direction can be empty or one of: where event can be one of: where from_item can be one of: where lockmode is one of: where member_object is: where option can be one of: where option can be: where role_specification can be: where transaction_mode is one of: window window_definition window_name with_query with_query_name yes Project-Id-Version: PostgreSQL 9.6
Report-Msgid-Bugs-To: pgsql-bugs@postgresql.org
POT-Creation-Date: 2017-08-06 01:59-0300
PO-Revision-Date: 2005-11-02 10:30-0300
Last-Translator: Euler Taveira de Oliveira <euler@timbira.com>
Language-Team: Brazilian Portuguese <pgbr-dev@listas.postgresql.org.br>
Language: pt_BR
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Plural-Forms: nplurals=2; plural=(n>1);
Opções de conexão:
Exibe configurações:
Variáveis de ambiente:
Para obter informações adicionais, digite "\?" (para comandos internos) ou "\help"
(para comandos SQL) no psql, ou consulte a seção do psql na
documentação do PostgreSQL.
Opções de entrada e saída:
Opções para formato de saída:
Analisador: "%s"
Analisador: "%s.%s" -?, --help=commands mostra comandos de barra invertida e termina
-?, --help=variables mostra variáveis especiais e termina
(opções: S = mostra objetos do sistema, + = detalhes)
-0, --record-separator-zero
define separador de registros para modo de saída desalinhado como byte zero
-1 ("um"), --single-transaction
executa como uma transação única (se não interativo)
-?, --help[=options] mostra essa ajuda e termina
-A, --no-align modo de saída em tabela desalinhada
-E, --echo-hidden mostra consultas que os comandos internos geram
-F, --field-separator=SEPARADOR
define separador de campos para modo de saída desalinhado (padrão: "%s")
-H, --html modo de saída em tabela HTML
-L, --log-file=ARQUIVO envia log da sessão para arquivo
-P, --pset=VAR[=ARG] define opção de exibição VAR para ARG (veja comando \pset)
-R, --record-separator=SEPARADOR
define separador de registros para modo de saída desalinhado (padrão: nova linha)
-S, --single-line modo linha única (fim da linha termina o comando SQL)
-T, --table-attr=TEXTO define atributos do marcador table do HTML (i.e. width, border)
-U, --username=USUÁRIO nome de usuário do banco de dados (padrão: "%s")
-V, --version mostra informação sobre a versão e termina
-W, --password pergunta senha (pode ocorrer automaticamente)
-X, --no-psqlrc não lê o arquivo de inicialização (~/.psqlrc)
-a, --echo-all mostra toda entrada do script
-b, --echo-errors mostra comandos que falharam
-c, --command=COMANDO executa somente um comando (SQL ou interno) e termina
-d, --dbname=NOMEBD nome do banco de dados ao qual quer se conectar (padrão: "%s")
-e, --echo-queries mostra comandos enviados ao servidor
-f, --file=ARQUIVO executa comandos de um arquivo e termina
-h, --host=MÁQUINA máquina do servidor de banco de dados ou diretório do soquete (padrão: "%s")
-l, --list lista os bancos de dados disponíveis e termina
-n, --no-readline desabilita edição de linha de comando melhorada (readline)
-o, --output=ARQUIVO envia resultados da consulta para um arquivo (ou |pipe)
-p, --port=PORTA porta do servidor de banco de dados (padrão: "%s")
-q, --quiet executa silenciosamente (sem mensagens, somente saída da consulta)
-s, --single-step modo passo-a-passo (confirma cada consulta)
-t, --tuples-only exibe somente registros
-v, --set=, --variable=NOME=VALOR
define variável do psql NOME como VALOR
(e.g., -v ON_ERROR_STOP=1)
-w, --no-password nunca pergunta senha
-x, --expanded habilita saída em tabela expandida
-z, --field-separator-zero
define separador de campos para modo de saída desalinhado como byte zero
AUTOCOMMIT se definido, comandos SQL bem sucedidos são automaticamente efetivados
COLUMNS número de colunas para formato de quebra automática
COMP_KEYWORD_CASE determina o uso de maiúsculas/minúsculas para completar palavras chave SQL
[lower, upper, preserve-lower, preserve-upper]
NOMEBD o nome do banco de dados atualmente conectado
ECHO controla que entrada é escrita na saída padrão
[all, errors, none, queries]
ECHO_HIDDEN se definido, mostra consultas internas executadas por comandos de barra invertida;
se definido para "noexec", apenas mostre sem executar
ENCODING codificação do conjunto de caracteres do cliente atual
FETCH_COUNT o número de registros a serem buscados e mostrados por vez
(padrão: 0=ilimitado)
HISTCONTROL controla histórico de comandos [ignorespace, ignoredups, ignoreboth]
HISTFILE nome do arquivo utilizado para armazenar o histórico de comandos
HISTSIZE o número de comandos para armazenar no histórico de comandos
HOST a máquina do servidor de banco de dados atualmente conectado
IGNOREEOF se não for definido, enviar um EOF para sessão interativa termina a aplicação
LASTOID valor do último OID afetado
NOME=VALOR [NOME=VALOR] psql ...
ou \setenv NOME [VALOR] no psql
ON_ERROR_ROLLBACK se definido, um erro não termina a transação (usa pontos de salvamento implícitos)
ON_ERROR_STOP termina a execução em lote após erro
PAGER nome do programa de paginação externo
PGAPPNAME mesmo que o parâmetro de conexão application_name
PGDATABASE mesmo que o parâmetro de conexão dbname
PGHOST mesmo que o parâmetro de conexão host
PGPASSFILE nome do arquivo de senhas
PGPASSWORD senha da conexão (não é recomendado)
PGPORT mesmo que o parâmetro de conexão port
PGUSER mesmo que o parâmetro de conexão user
PORT porta do servidor da conexão atual
PROMPT1 especifica o prompt padrão do psql
PROMPT2 especifica o prompt utilizado quando o comando continua a partir de uma linha anterior
PROMPT3 especifica o prompt utilizado durante COPY ... FROM STDIN
PSQLRC local alternativo para arquivo .psqlrc do usuário
PSQL_EDITOR, EDITOR, VISUAL
editor utilizado pelos comandos \e, \ef e \ev
PSQL_EDITOR_LINENUMBER_ARG
como especificar um número de linha ao invocar o editor
PSQL_HISTORY local alternativo para arquivo de histórico de comandos
QUIET executa silenciosamente (mesmo que a opção -q)
SHELL shell utilizada pelo comando \!
SHOW_CONTEXT controla exibição de campos de contexto da mensagem [never, errors, always]
SINGLELINE modo cujo fim da linha termina comando SQL (mesmo que a opção -S)
SINGLESTEP modo passo-a-passo (mesmo que a opção -s)
TMPDIR diretório para arquivos temporários
USER o usuário de banco de dados atualmente contectado
VERBOSITY controla detalhamento das mensagens de erro [default, verbose, terse]
\! [COMANDO] executa comando na shell ou inicia shell interativa
\? [commands] mostra ajuda sobre comandos de barra invertida
\? options mostra ajuda sobre opções de linha de comando do psql
\? variables mostra ajuda sobre variáveis especiais
\C [TEXTO] define o título da tabela, ou apaga caso nada seja especificado
\H alterna para modo de saída em HTML (atual %s)
\T [TEXTO] define atributos do marcador HTML <table> ou apaga caso nada seja especificado
\a alterna entre modo de saída desalinhado e alinhado
\c[onnect] {[NOMEBD|- USUÁRIO|- MÁQUINA|- PORTA|-] | conninfo}
conecta a um novo banco de dados (atualmente "%s")
\c[onnect] {[NOMEBD|- USUÁRIO|- MÁQUINA|- PORTA|-] | conninfo}
conecta a um novo banco de dados (atualmente nenhuma conexão)
\cd [DIRETÓRIO] muda o diretório de trabalho atual
\conninfo mostra informação sobre conexão atual
\copy ... realiza comando SQL COPY dos dados para máquina cliente
\copyright mostra termos de uso e distribuição do PostgreSQL
\crosstabview [COLUNAS] executa consulta e mostra resultados em tabela de referência cruzada
\dA[+] [MODELO] lista métodos de acesso
\dC[+] [MODELO] lista conversões de tipos
\dD[S+] [MODELO] lista domínios
\dE[S+] [MODELO] lista tabelas externas
\dF[+] [MODELO] lista configurações de busca textual
\dFd[+] [MODELO] lista dicionários de busca textual
\dFp[+] [MODELO] lista analisadores de busca textual
\dFt[+] [MODELO] lista modelos de busca textual
\dL[S+] [MODELO] lista linguagens procedurais
\dO[S+] [MODELO] lista ordenações
\dT[S+] [MODELO] lista tipos de dados
\d[S+] lista tabelas, visões e sequências
\d[S+] NOME descreve tabela, visão, sequência ou índice
\da[S] [MODELO] lista funções de agregação
\db[+] [MODELO] lista tablespaces
\dc[S+] [MODELO] lista conversões
\dd[S] [MODELO] mostra comentários de objetos que não aparecem em outro lugar
\ddp [MODELO] lista privilégios padrão
\des[+] [MODELO] lista servidores externos
\det[+] [MODELO] lista tabelas externas
\deu[+] [MODELO] lista mapeamento de usuários
\dew[+] [MODELO] lista adaptadores de dados externos
\df[antw][S+] [MODELO] lista funções [somente agr/normal/gatilho/deslizante]
\dg[S+] [MODELO] lista roles
\di[S+] [MODELO] lista índices
\dl lista objetos grandes, mesmo que \lo_list
\dm[S+] [MODELO] lista visões materializadas
\dn[S+] [MODELO] lista esquemas
\do[S] [MODELO] lista operadores
\dp [MODELO] lista privilégios de acesso de tabelas, visões e sequências
\drds [MOD1 [MOD2]] lista configurações de roles por banco de dados
\ds[S+] [MODELO] lista sequências
\dt[S+] [MODELO] lista tabelas
\du[S+] [MODELO] lista roles
\dv[S+] [MODELO] lista visões
\dx[+] [MODELO] lista extensões
\dy [MODELO] lista gatilhos de eventos
\e [ARQUIVO] [LINHA] edita o buffer de consulta (ou arquivo) com um editor externo
\echo [TEXTO] escreve cadeia de caracteres na saída padrão
\ef [NOMEFUNÇÃO [LINHA]] edita a definição de função com um editor externo
\encoding [CODIFICAÇÃO] mostra ou define codificação do cliente
\errverbose mostra mensagem de erro mais recente com detalhamento máximo
\ev [NOMEVISÃO [LINHA]] edita a definição de visão com um editor externo
\f [TEXTO] mostra ou define separador de campos para saída de consulta desalinhada
\g [ARQUIVO] ou ; executa consulta (e envia os resultados para arquivo ou |pipe)
\gexec executa consulta, em seguida, executa cada valor no seu resultado
\gset [PREFIXO] executa consulta e armazena os resultados em variáveis do psql
\h [NOME] mostra sintaxe dos comandos SQL, * para todos os comandos
\i ARQUIVO executa comandos de um arquivo
\ir ARQUIVO como \i, mas relativo ao local do script atual
\l[+] [MODELO] lista bancos de dados
\lo_export OIDLOB ARQUIVO
\lo_import ARQUIVO [COMENTÁRIO]
\lo_list
\lo_unlink OIDLOB operações com objetos grandes
\o [ARQUIVO] envia todos os resultados da consulta para arquivo ou |pipe
\p mostra o conteúdo do buffer de consulta
\password [USUÁRIO] altera a senha de um usuário com segurança
\prompt [TEXTO] NOME pergunta o usuário ao definir uma variável interna
\pset [NOME [VALOR]] define opção de saída da tabela
(NOME := {format|border|expanded|fieldsep|fieldsep_zero|footer|null|
numericlocale|recordsep|recordsep_zero|tuples_only|title|tableattr|pager|
unicode_border_linestyle|unicode_column_linestyle|unicode_header_linestyle})
\q sair do psql
\qecho [TEXTO] escreve cadeia de caracteres para saída da consulta (veja \o)
\r reinicia (apaga) o buffer de consulta
\s [ARQUIVO] mostra histórico ou grava-o em um arquivo
\set [NOME [VALOR]] define variável interna ou lista todos caso não tenha parâmetros
\setenv NOME [VALOR] define ou apaga variável de ambiente
\sf[+] NOMEFUNÇÃO edita a definição da função
\sv[+] NOMEVISÃO edita a definição da visão
\t [on|off] mostra somente registros (atual %s)
\timing [on|off] alterna para duração da execução de comandos (atualmente %s)
\unset NOME apaga (exclui) variável interna
\w [ARQUIVO] escreve o buffer de consulta para arquivo
\watch [SEG] executa consulta a cada SEG segundos
\x [on|off|auto] alterna para saída expandida (atual %s)
\z [MODELO] mesmo que \dp
border estilo de borda (número)
columns largura para o formato de quebra automática
expanded (ou x) saída em tabela expandida [on, off, auto]
fieldsep separador de campos para modo de saída desalinhado (padrão "%s")
fieldsep_zero define separador de campos para modo de saída desalinhado como byte zero
footer habilita ou desabilita a exibição do rodapé da tabela [on, off]
format define formato de saída [unaligned, aligned, wrapped, html, asciidoc, ...]
linestyle define o estilo de linha da borda [ascii, old-ascii, unicode]
null define a cadeia de caracteres a ser impressa no lugar do valor nulo
numericlocale habilita e desabilita a exibição de um caracter definido pela configuração regional
para separar grupos de dígitos [on, off]
pager controla quando um paginador externo é utilizado [yes, no, always]
psql --pset=NOME[=VALOR]
ou \pset NOME [VALOR] no psql
psql --set=NOME=VALOR
ou \set NOME VALOR no psql
psql [OPÇÃO]... [NOMEBD [USUÁRIO]]
recordsep separador de registros para modo de saída desalinhado
recordsep_zero define separador de registros para modo de saída desalinhado como byte zero
set=NOME=VALOR
ou \setenv NOME [VALOR] no psql
tableattr (ou T) especifica atributos para marcador table no formato html ou larguras de
colunas proporcionais para tipos de dados alinhados à esquerda no formato latex-longtable
title define o título da tabela para as próximas tabelas a serem exibidas
tuples_only se definido, somente dados da tabela atual são mostrados
unicode_border_linestyle
unicode_column_linestyle
unicode_header_linestyle
define o estilo de linha Unicode [single, double]
"%s.%s" não é uma visão
%d conexão %d conexões %s %s %s (cada %gs)
%s
%s (%s, servidor %s)
%s (cada %gs)
%s: %s
%s: -1 só pode ser utilizado em modo não interativo
%s: não pode copiar de/para o diretório
%s: não pôde apagar variável "%s"
%s: não pôde encontrar executável
%s: não pôde abrir arquivo de log "%s": %s
%s: não pôde definir parâmetro de exibição "%s"
%s: não pôde definir variável "%s"
%s: transação atual foi interrompida
%s: nome da codificação é inválido ou procedimento de conversão não foi encontrado
%s: não está conectado ao banco de dados
%s: sem memória
%s: status da transação é desconhecido
%s: aviso: argumento extra de linha de comando "%s" ignorado
(%lu registro) (%lu registros) ***(Modo passo-a-passo: verifique o comando)*******************************************
%s
***(pressione Enter para prosseguir ou digite x e Enter para cancelar)********************
******** CONSULTA ********
%s
**************************
+ opt(%d) = |%s|
, agrupada , postergável , inicialmente postergada , inválido , predicado (%s) , identidade da réplica , tablespace "%s" Privilégios de acesso Todos os parâmetros de conexão devem ser fornecidos porque nenhuma conexão de banco de dados existe
Tipos de dado do argumento Notificação assíncrona "%s" recebida do processo do servidor com PID %d.
Notificação assíncrona "%s" com mensagem "%s" recebida do processo do servidor com PID %d.
Atributos Ajuda disponível:
Estilo de borda é %d.
Ignora RLS transferência de dados utilizando COPY falhou: %s Manipulador de Chamada Não pode adicionar célula a conteúdo de tabela: quantidade total de células %d foi excedida.
Não pode adicionar cabeçalho a conteúdo de tabela: quantidade de colunas %d foi excedida.
Não pode efetuar login Verificação Restrições de verificação: Tabelas descendentes Collate Coluna Privilégios de coluna Comando: %s
Descrição: %s
Sintaxe:
%s
Tipo composto "%s.%s" Conexão
Cria BD Cria role Ctype Banco de Dados Privilégios de acesso padrão Rodapé padrão está desabilitado.
Rodapé padrão está habilitado.
Padrão? Definição Descrição Destino Dicionários Não encontrou nenhuma extensão chamada "%s".
Não encontrou nenhuma extensão.
Não encontrou nenhuma relação chamada "%s".
Não encontrou nenhuma relação com OID %s.
Não encontrou nenhuma configuração de busca textual chamada "%s".
Não encontrou nenhum analisador de busca textual chamado "%s".
Gatilhos internos desabilitados: Regras desabilitadas: Gatilhos desabilitados: Gatilhos de usuário desabilitados: Elementos Habilitado Codificação Terminar análise Informe os dados a serem copiados seguido pelo caracter de nova linha.
Finalize com uma barra invertida e um ponto na linha ou um sinal EOF. Digite-a novamente: Digite nova senha: Evento Exibição expandida está desabilitada.
Exibição expandida está habilitada.
Exibição expandida é utilizada automaticamente.
Opções FDW Opções FDW: (%s) Falhou.
Separador de campos é "%s".
Separador de campos é byte zero.
Tabela externa "%s.%s" Adaptador de dados externos Restrições de chave estrangeira: Formatação
Função Geral
Opções gerais:
Obter destaque Obter próximo elemento Obter tipos de elemento Manipulador Têm OIDs: sim Ajuda
ID Implícito? Índice Índice "%s.%s" Índices: Informativo
Heranças Inicializador Opções de inicialização Manipulador de Código Embutido Entrada/Saída
Linguagem Interna Nome interno Interrompido
Comando inválido \%s. Tente \? para ajuda.
Linguagem Objetos Grandes
Objetos grandes Tipo de argumento à esquerda Lexize Estilo de linha é %s.
Lista de métodos de acesso Lista das funções de agregação Lista de conversões de tipos Lista de ordenações Lista de conversões Lista de tipos de dado Lista dos bancos de dados Lista de domínios Lista de gatilhos de eventos Lista de servidores externos Lista de tabelas externas Lista de adaptadores de dados externos Lista de funções Lista de extensões instaladas Lista de linguagens Lista de operadores Lista de relações Lista de roles Lista de esquemas Lista de configurações Lista de variáveis com tratamento especial
Lista das tablespaces Lista de configurações de busca textual Lista de dicionários de busca textual Lista de analisadores de busca textual Lista de modelos de busca textual Lista de mapeamentos de usuários Formato numérico baseado no idioma está desabilitado.
Formato numérico baseado no idioma está habilitado.
Local Visão materializada "%s.%s" Membro de Método Modificador Modificadores Nome Nenhuma alteração Nenhuma conexão Nenhuma ajuda disponível para "%s".
Tente \h sem argumentos para ver a ajuda disponível.
Nenhuma herança Nenhuma relação correspondente foi encontrada.
Nenhuma configuração correspondente foi encontrada.
Nenhum suporte a configurações de roles por banco de dados nesta versão do servidor.
Nenhuma relação foi encontrada.
Nenhuma configuração foi encontrada.
Exibição nula é "%s".
Número de tabelas descendentes: %d (Utilize \d+ para listá-las.) Objeto Descrição do Objeto Descrições dos Objetos Objetos na extensão "%s" Sistema Operacional
Opções Formato de saída é %s.
Dono: %s Dono Paginação é sempre utilizada.
Paginação é usada para saída longa.
Uso de paginação está desabilitado.
Paginação não será utilizada para menos do que %d linha.
Paginação não será utilizada para menos do que %d linhas.
Paralelismo Criptografia de senha falhou.
Senha para usuário %s: Senha valida até Senha: Senhas não correspondem.
Políticas Políticas (segurança de registros forçada está habilitada): Políticas (segurança de registros forçada está habilitada): (nenhum) Políticas (segurança de registros está desabilitada): Políticas (segurança de registros está habilitada): (nenhum) Políticas: Conexão anterior mantida
Procedimento Buffer de consulta
Buffer de consulta está vazio. Buffer de consulta reiniciado (limpo). Separador de registros é "%s".
Separador de registros é <novalinha>.
Separador de registros é byte zero.
Referenciada por: Identidade da Réplica Replicação Relate erros a <pgsql-bugs@postgresql.org>.
Tipo de dado do resultado Tipo resultante Tipo de argumento à direita Role Nome da role Regras sempre disparadas: Regras somente disparadas na réplica: Regras: conexão SSL (protocolo: %s, cifra: %s, bits: %s, compressão: %s)
COMANDO: %s
Esquema Segurança Sequência "%s.%s" Servidor Servidor: %s Definições Tamanho Fonte Código fonte Tipo fonte Relação especial "%s.%s" Iniciar análise Estatísticas Armazenamento Sucedido.
Super-usuário tabela TOAST "%s.%s" Tabela Tabela "%s.%s" Atributos de tabela são "%s".
Atributos de tabela não estão definidos.
Tablespace Tablespace: "%s" Marcadores Tipo alvo Largura é %d.
Largura não está definida.
Modelo Configuração de busca textual "%s" Configuração de busca textual "%s.%s" Analisador de busca textual "%s" Analisador de busca textual "%s.%s" A conexão com servidor foi perdida. Tentando reiniciar: A entrada é uma cópia de segurança no formato personalizado do PostgreSQL.
Utilize o cliente de linha de comando pg_restore para restaurar essa cópia de segurança para um banco de dados.
O servidor (versão %s) não suporta métodos de acesso.
O servidor (versão %s) não suporta alteração de privilégios padrão.
O servidor (versão %s) não suporta ordenações (collations).
O servidor (versão %s) não suporta edição do código da função.
O servidor (versão %s) não suporta edição do código da visão.
O servidor (versão %s) não suporta extensões.
O servidor (versão %s) não suporta servidores externos.
O servidor (versão %s) não suporta tabelas externas.
O servidor (versão %s) não suporta adaptadores de dados externos.
O servidor (versão %s) não suporta busca textual.
O servidor (versão %s) não suporta pontos de salvamento para ON_ERROR_ROLLBACK.
O servidor (versão %s) não suporta exibição do código da função.
O servidor (versão %s) não suporta exibição do código da visão.
O servidor (versão %s) não suporta tablespaces.
O servidor (versão %s) não suporta mapeamentos de usuários.
Não há erro anterior. Tempo: %.3f ms
Tempo de execução está desabilitado. Tempo de execução está habilitado. Título é "%s".
Título não está definido.
Elemento Nome do elemento Tipos de elemento para analisador "%s" Tipos de elemento para analisador "%s.%s" Gatilhos sempre disparados: Gatilhos disparados somente na réplica: Gatilhos: Confiável Tente "%s --help" para obter informações adicionais.
Somente tuplas está desabilitado.
Somente tuplas está habilitado.
Tipo Digite "help" para ajuda.
Digite: \copyright para mostrar termos de distribuição
\h para ajuda com comandos SQL
\? para ajuda com comandos do psql
\g ou terminar com ponto-e-vírgula para executar a consulta
\q para sair
Tabela protótipo de tipo: %s Estilo de linha de borda Unicode é "%s".
Estilo de linha de coluna Unicode é "%s".
Estilo de linha de cabeçalho Unicode é "%s".
Índice unlogged "%s.%s" Visão materializada unlogged "%s.%s" Tabela unlogged "%s.%s" Uso:
Use "\q" para sair do %s.
Nome de usuário Validador Valor Variáveis
Versão Visão "%s.%s" Definição da visão: Volatilidade AVISO: %s versão %s, servidor versão %s.
Algumas funcionalidades do psql podem não funcionar.
AVISO: página de código do Console (%u) difere da página de código do Windows (%u)
caracteres de 8 bits podem não funcionar corretamente. Veja página de
referência do psql "Notes for Windows users" para obter detalhes.
Histórico escrito para arquivo "%s".
Você está conectado ao banco de dados "%s" como usuário "%s" na máquina "%s" na porta "%s".
Você está conectado ao banco de dados "%s" como usuário "%s" via soquete em "%s" na porta "%s".
Você não está conectado ao banco de dados.
Você está conectado agora ao banco de dados "%s" como usuário "%s" na máquina "%s" na porta "%s".
Você está conectado agora ao banco de dados "%s" como usuário "%s" via soquete em "%s" na porta "%s".
Você está conectado agora ao banco de dados "%s" como usuário "%s".
Você está utilizando o psql, um cliente de linha de comando do PostgreSQL. \!: falhou
\%s: não pôde mudar diretório para "%s": %s
\%s: nome de variável de ambiente não deve conter "="
\%s: erro ao definir variável
\%s: argumento extra "%s" ignorado
\%s: faltando argumento requerido
\connect: %s \copy: argumentos são requeridos
\copy: erro de análise em "%s"
\copy: erro de análise no fim da linha
\crosstabview: nome de coluna ambíguo: "%s"
\crosstabview: nome de coluna não foi encontrado: "%s"
\crosstabview: coluna número %d está fora do intervalo 1..%d
\crosstabview: coluna de dados deve ser especificada quando consulta retornar mais de três colunas
\crosstabview: número máximo de colunas (%d) foi alcançado
\crosstabview: consulta deve retornar pelo menos três colunas
\crosstabview: resultado da consulta contém múltiplos valores de dados para registro "%s", coluna "%s"
\crosstabview: comando não retornou um conjunto de resultados
\crosstabview: cabeçalhos vertical e horizontal devem ser colunas diferentes
\df não possui a opção "w" em um servidor na versão %s.
\df só possui as opções [antwS+]
\pset: estilos de linha de borda Unicode permitidos são single, double
\pset: estilos de linha de coluna Unicode permitidos são single, double
\pset: estilos de linha de cabeçalho Unicode permitidos são single, double
\pset: formatos permitidos são unaligned, aligned, wrapped, html, asciidoc, latex, latex-longtable, troff-ms
\pset: estilos de linha permitidos são ascii, old-ascii, unicode
\pset: opção desconhecida: %s
\watch não pode ser utilizado com COPY
\watch não pode ser utilizado com uma consulta vazia
comando_grant_ou_revoke transação atual foi interrompida interrompido devido a falha de leitura tipo_método_acesso ação agr nome_agregação assinatura_agregação aliás alinhamento permite_conexão sempre função_análise e assinatura_agregação é: onde ação_conflito é uma das: onde elemento_agrupamento pode ser um dos: e opção_like é: e restrição_tabela é: e restrição_tabela_utilizando_índice é: e consulta_with é: tipo_de_dado_arg nome_argumento tipo_argumento modo_argumento nome_argumento tipo_argumento argumento tipo_argumento argumentos atributo nome_atributo opção_atributo tipo_base booleano cache manipulador_chamada cancela uma transação que foi anteriormente preparada para efetivação em duas fases cancelado pelo usuário não pode duplicar ponteiro nulo (erro interno)
não pode fazer escape sem uma conexão ativa
função_canônica categoria muda o banco de dados muda uma role do banco de dados muda um parâmetro em tempo de execução muda um parâmetro de configuração do servidor muda nome da role ou membro muda a definição de uma ordenação muda a definição de uma conversão muda a definição de um domínio muda a definição de um servidor externo muda a definição de uma tabela externa muda a definição de um adaptador de dados externos muda a definição de uma função muda a definição de um objeto grande muda a definição de uma visão materializada muda a definição de uma linguagem procedural muda a definição de uma política de segurança a nível de registros muda a definição de uma regra muda a definição de um esquema muda a definição de um gerador de sequência muda a definição de uma tabela muda a definição de uma tablespace muda a definição de uma configuração de busca textual muda a definição de um dicionário de busca textual muda a definição de um analisador de busca textual muda a definição de um modelo de busca textual muda a definição de um gatilho muda a definição de um tipo muda a definição de um mapeamento de usuários muda a definição de uma visão muda a definição de uma função de agregação muda a definição de um gatilho de eventos muda a definição de uma extensão muda a definição de um índice muda a definição de um operador muda a definição de uma classe de operadores muda a definição de uma família de operadores muda o dono dos objetos do banco de dados cujo dono é uma role do banco de dados canal expressão_check processo filho terminou com código de saída %d processo filho terminou com status desconhecido %d processo filho foi terminado pela exceção 0x%X processo filho foi terminado pelo sinal %d processo filho foi terminado pelo sinal %s fecha um cursor agrupa uma tabela de acordo com um índice código collatable collate %s ordenação coleta estatísticas sobre o banco de dados aliás_coluna restrição_coluna definição_coluna nome_coluna tipo_coluna operador_comutação função_combine comando comando não é executável comando não foi encontrado efetiva uma transação que foi anteriormente preparada para efetivação em duas fases efetiva a transação atual computa um conjunto de registros condição parâmetro_de_configuração ação_conflito alvo_conflito conexão com servidor foi perdida
limite_conexão restrição nome_restrição copia dados de um arquivo para uma tabela não pôde mudar diretório para "%s": %s não pôde fechar pipe para comando externo: %s
não pôde executar comando "%s": %s
não pôde encontrar o "%s" para executá-lo não pôde obter diretório base para ID de usuário %ld: %s
não pôde identificar diretório atual: %s não pôde localizar diretório temporário: %s
não pôde encontrar ID de usuário efetivo %ld: %s não pôde abrir arquivo temporário "%s": %s
não pôde validar matriz reloptions
não pôde ler o binário "%s" não pôde ler arquivo de entrada: %s
não pôde ler link simbólico "%s" não pôde gravar histórico no arquivo "%s": %s
não pôde definir variável "%s"
não pôde iniciar /bin/sh
não pôde iniciar o editor "%s"
não pôde executar stat no arquivo "%s": %s
não pôde escrever dados utilizando COPY: %s
contador cria um novo banco de dados cria novos registros em uma tabela nome_cursor tipo_de_dado nome_banco_de_dados remove um comando preparado valor_padrão valor padrão de %s expressão_padrão define um cursor define um novo método de acesso define um nova função de agregação define uma nova conversão de tipo define uma nova ordenação define um novo tipo de dado define uma nova role do banco de dados define um novo domínio define uma nova conversão de codificação define um novo gatilho de eventos define um novo servidor externo define uma nova tabela externa define um novo adaptador de dados externos define uma nova função define um novo índice define um novo mapeamento de um usuário para um servidor externo define uma nova visão materializada define um novo operador define uma nova classe de operadores define uma nova família de operadores define uma nova linguagem procedural define uma nova regra de reescrita define uma nova política de segurança a nível de registros para uma tabela define um novo ponto de salvamento na transação atual define um novo esquema define um novo gerador de sequência define uma nova tabela cria uma nova tabela a partir dos resultados de uma consulta define uma nova tablespace define uma nova configuração de busca textual define um novo dicionário de busca textual define um novo analisador de busca textual define um novo modelo de busca textual define uma nova transformação define um novo gatilho define uma nova visão define privilégios de acesso define privilégios de acesso padrão define ou muda um rótulo de segurança aplicado a um objeto define ou muda um comentário de um objeto definidor definição exclusão apaga registros de uma tabela delimitador caracter_delimitador função_deserial codificação_destino destrói um ponto de salvamento definido anteriormente nome_dicionário direção diretório desabilitado descarta estado da sessão restrição de domínio restrição_domínio nome_domínio elemento esvazia uma tabela ou um conjunto de tabelas habilitado codificação nome_codificação função_fim variável de ambiente PSQL_EDITOR_LINENUMBER_ARG deve ser definida para especificar um número de linha
caracter_escape evento elemento_exclusão elemento_exclusão em uma restrição EXCLUDE é: executa um comando preparado executa um bloco de código anônimo custo_execução ordenação_existente valor_enum_existente expressão nome_extensão nome_família nome_fdw função_final arquivo variável_filtro para tabela "%s.%s" força ponto de controle no log de transação tabela externa nome_formato item_from lista_from nome_função_do_sql função nome de função é requerido
nome_função coleta lixo e opcionalmente analisa um banco de dados gera uma notificação função_gettoken nome_grupo elemento_agrupamento função_manipulação função_headline histórico não é suportado por esta instalação
imutável importa definições de tabelas de um servidor externo em atribuição incremento índice nome_coluna_índice expressão_índice método_índice nome_índice parâmetros_índice parâmetros_índice em restrições UNIQUE, PRIMARY KEY e EXCLUDE são: predicado_índice função_init condição_inicial manipulador_em_linha função_entrada inserção instala uma extensão inteiro tamanho_interno binário "%s" é inválido comando inválido \%s
número de linha inválido: %s
formato de saída inválido (erro interno): %d invocador é_modelo coluna_junção condição_junção proc_junção tipo_junção rótulo nome_linguagem oid_objeto_grande lc_collate lc_ctype tipo_esquerda função_lexize função_lextypes opção_like tipo_like símbolo_ligação espera por uma notificação carrega um arquivo de biblioteca compartilhada soquete local esquema_local configuração regional bloqueia uma tabela modo_bloqueio loid visão materializada valor_máximo objeto_membro método função_mfinal condição_minicial valor_mínimo função_minv mais de um registro foi retornado para \gset
função_mestado tamanho_de_dado_mestado tipo_de_dado_mestado nome operador_negação novo_nome_atributo novo_nome_coluna novo_nome_restrição novo_dicionário novo_valor_enum novo_nome novo_dono nova_role novo_esquema nova_tabela nova_tablespace nova_versão não nenhum buffer de consulta
nenhum registro foi retornado para \gset
normal não nulo cadeia_nula arquivo_objeto nome_objeto desabilitado dicionário_antigo role_antiga versão_antiga habilitado tipo_operador classe_operadores operador classe de operadores família de operadores nome_operador opção ou a sintaxe antiga sem memória sem memória
expressão_saída função_saída nome_saída parâmetro tabela_ancestral nome_analisador senha informação pclose falhou: %s nome_política posiciona um cursor predicado tipo_preferido prepara um comando para execução prepara a transação atual para efetivação em duas fases chave primária, fornecedor psql é o terminal interativo do PostgreSQL.
variáveis do psql:
consulta caracter_separador reconstrói índices função_recepção coluna_ref nome_tabela_referenciada tabela_ref nome_relação esquema_remoto remove uma conversão de tipo remove uma ordenação remove uma conversão remove um tipo de dado remove um banco de dados remove uma role do banco de dados remove um domínio remove um descritor de servidor externo remove uma tabela externa remove um adaptador de dados externos remove uma função remove uma visão materializada remove uma linguagem procedural remove uma regra de reescrita remove uma política de segurança a nível de registros de uma tabela remove um esquema remove uma sequência remove uma tabela remove uma tablespace remove uma configuração de busca textual remove um dicionário de busca textual remove um analisador de busca textual remove um modelo de busca textual remove uma transformação remove um gatilho remove um mapeamento de usuários para um servidor externo remove uma visão remove privilégios de acesso remove um método de acesso remove uma função de agregação remove um gatilho de eventos remove uma extensão remove um índice remove um operador remove uma classe de operadores remove uma família de operadores remove objetos do banco de dados cujo dono é uma role do banco de dados substitui o conteúdo de uma visão materializada réplica proc_restrição reinício restaura o valor do parâmetro em tempo de execução para o valor padrão restrito registros_retornados recupera registros de uma consulta utilizando um cursor recupera registros de uma tabela ou visão tipo_retorno nome_regra_reescrita tipo_direita nome_role especificação_role desfaz modificações de um ponto de salvamento regra nome_regra seguro método_amostragem nome_ponto_de_salvamento elemento_esquema nome_esquema semente seleção função_envio sequência nome_sequência função_serial nome_servidor tipo_servidor versão_servidor define o momento de verificação da restrição na transação atual define as características da transação atual define o identificador do usuário atual nesta sessão define o identificador da sessão do usuário e o identificador do usuário na sessão atual função_trans_estado mostra o plano de execução de um comando mostra o valor de um parâmetro em tempo de execução ignorando expansão recursiva da variável "%s"
id_snapshot expressão_ordenação nome_família_ordenação operador_ordenação configuração_origem codificação_origem tabela_origem tipo_origem especial estável início inicia um bloco de transação função_início tamanho_de_dado_estado tipo_de_dado_estado comando para de esperar por notificação armazenamento parâmetro_armazenamento tipo_armazenamento número_estratégia sub-SELECT subtipo função_diff_subtipo classe_operadores_subtipo número_suporte consulta para completação por tab falhou: %s
Consulta foi:
%s
tabela restrição de tabela restrição_tabela restrição_tabela_utilizando_índice nome_tabela nome_tablespace opção_tablespace role_alvo tipo_destino modelo texto tempo_absoluto zona_horária nome_função_para_sql tipo_elemento id_transação modo_transação gatilho nome_gatilho tentando sair do modo copy tipo função_entrada_modificador_tipo função_saída_modificador_tipo nome_tipo uid PQresultStatus inesperado: %d
status de resultado inesperado para \watch
status de transação inesperado (%d)
unicidade, desconhecido valor desconhecido "%s" para "%s"; definindo "%s"
inseguro cadeia de caracteres entre aspas não foi terminada
atualização atualiza registros de uma tabela usuário não existe falhou ao pesquisar nome de usuário: código de erro %lu nome_usuário expressão_using lista_using função_validação função_validação valor valores versão visão nome de visão é requerido
nome_opção_visão valor_opção_visão volátil onde comando_grant_ou_revoke é um dos: onde ação é uma das: onde assinatura_agregação é: onde restrição_coluna é: onde alvo_conflito pode ser um dos: onde restrição é: onde direção pode ser vazio ou um dos: onde evento pode ser um dos: onde item_from pode ser um dos: onde modo_bloqueio é um dos: onde objeto_membro é: onde opção pode ser um das: onde opção pode ser: onde especificação_role pode ser: onde modo_transação é um dos: deslizante definição_deslizante nome_deslizante consulta_with nome_consulta_with sim locale/pt_BR/LC_MESSAGES/initdb-9.6.mo 0000644 00000056756 14751153421 0012744 0 ustar 00 �� � , � <
�
R �
* 5 - F g t ` � � = W W X � A � 5 � J / z 6 � P � C : b Q � 5 � ] % 4 � B � H � G D > � 4 � 9 3 : ? n / � - � > y K ( � # � , - ? 7 m ( � 6 � , ' 2 5 Z F � " � < � & 7 - ^ - � ! � 1 � ? & N / u = � ! � " 6 ( + _ � 0 � ; � $ / 4 & d � $ � ~ � 1 M < � G � 3 " 8 V ( � J � � � � C � - C! 8 q! ! �! , �! �! J " / \" 4 �" A �" @ # R D# K �# " �# ! $ � ($ d �$ % $% � C% [ �% R #& K v& % �& �& ' ' ; 7' ; s' � �' @ @( ; �( �( u �) q D* f �* s + & �+ �+ ) �+ t �+ / _, �, & �, 0 �, . �, ) %- ) O- y- �- & �- # �- �- $ . ( 3. + \. " �. �. " �. ! �. , / $ 8/ * ]/ % �/ ! �/ �/ �/ 0 0 90 M0 Q0 `0 - r0 �0 & �0 % �0 3 1 ?1 Y1 ( m1 � �1 ^ ,3 , �3 �3 �3 - �3 v 4 � |4 � �4 _ �5 c >6 ' �6 a �7 8 ,8 T e8 �8 ; �8 X 9 [ m9 F �9 \ : H m: f �: H ; M f; E �; ; �; < 6< C s< 7 �< < �< F ,= < s= > �= D �= � 4> + �> ( �> 0 $? - U? 8 �? ) �? @ �? . '@ ) V@ O �@ a �@ 2 2A K eA ) �A 3 �A 3 B & CB F jB Q �B ' C - +C G YC 1 �C ) �C D �C 0 BD # sD 7 �D D �D * E 7 ?E < wE �E , �E � �E = �F D �F 6 G h JG Q �G N H @ TH a �H � �H �I ' �I ^ J 4 sJ A �J ' �J 4 K GK ` _K ; �K = �K Q :L B �L s �L c CM : �M 8 �M � N � �N gO % |O � �O ] 0P [ �P K �P G 6Q ~Q ' �Q # �Q = �Q U #R � yR B %S D hS b �S � U } �U p V } �V 7 W AW 1 GW � yW 0 �W /X 0 CX 2 tX 0 �X * �X * Y .Y JY ) fY & �Y , �Y ( �Y +
Z 3 9Z % mZ �Z # �Z # �Z 3 �Z * .[ < Y[ * �[ ' �[ �[ \ 5 \ V\ q\
u\ �\ $ �\ ) �\ ) �\ ( ] E 7] ! }] �] 9 �] � � 5 ( � Z � J l 6 H X � � K z � � � r I � � { � N d R V o | ~ � � . y U } � m � ` G = * f / $ � > _ � # A � t C 8 Y 0 T , � % + v L 3 � 2 n � � h B j E ? ] 9 ) ! & � � � q � � D S g
e ; ' ^ " F x c � w P [ s � @ i �
1 - \ � u : k � 4 W Q 7 O � < M p a b �
If the data directory is not specified, the environment variable PGDATA
is used.
Less commonly used options:
Options:
Other options:
Report bugs to <pgsql-bugs@postgresql.org>.
Success. You can now start the database server using:
%s%s%spg_ctl%s -D %s%s%s -l logfile start
Sync to disk skipped.
The data directory might become corrupt if the operating system crashes.
WARNING: enabling "trust" authentication for local connections
You can change this by editing pg_hba.conf or using the option -A, or
--auth-local and --auth-host, the next time you run initdb.
--auth-host=METHOD default authentication method for local TCP/IP connections
--auth-local=METHOD default authentication method for local-socket connections
--lc-collate=, --lc-ctype=, --lc-messages=LOCALE
--lc-monetary=, --lc-numeric=, --lc-time=LOCALE
set default locale in the respective category for
new databases (default taken from environment)
--locale=LOCALE set default locale for new databases
--no-locale equivalent to --locale=C
--pwfile=FILE read password for the new superuser from file
%s [OPTION]... [DATADIR]
-?, --help show this help, then exit
-A, --auth=METHOD default authentication method for local connections
-E, --encoding=ENCODING set default encoding for new databases
-L DIRECTORY where to find the input files
-N, --nosync do not wait for changes to be written safely to disk
-S, --sync-only only sync data directory
-T, --text-search-config=CFG
default text search configuration
-U, --username=NAME database superuser name
-V, --version output version information, then exit
-W, --pwprompt prompt for a password for the new superuser
-X, --xlogdir=XLOGDIR location for the transaction log directory
-d, --debug generate lots of debugging output
-k, --data-checksums use data page checksums
-n, --noclean do not clean up after errors
-s, --show show internal settings
[-D, --pgdata=]DATADIR location for this database cluster
%s initializes a PostgreSQL database cluster.
%s: "%s" is not a valid server encoding name
%s: WARNING: cannot create restricted tokens on this platform
%s: cannot be run as root
Please log in (using, e.g., "su") as the (unprivileged) user that will
own the server process.
%s: could not access directory "%s": %s
%s: could not access file "%s": %s
%s: could not allocate SIDs: error code %lu
%s: could not change permissions of "%s": %s
%s: could not change permissions of directory "%s": %s
%s: could not create directory "%s": %s
%s: could not create restricted token: error code %lu
%s: could not create symbolic link "%s": %s
%s: could not execute command "%s": %s
%s: could not find suitable encoding for locale "%s"
%s: could not find suitable text search configuration for locale "%s"
%s: could not fsync file "%s": %s
%s: could not get exit code from subprocess: error code %lu
%s: could not open directory "%s": %s
%s: could not open file "%s" for reading: %s
%s: could not open file "%s" for writing: %s
%s: could not open file "%s": %s
%s: could not open process token: error code %lu
%s: could not re-execute with restricted token: error code %lu
%s: could not read directory "%s": %s
%s: could not read password from file "%s": %s
%s: could not start process for command "%s": error code %lu
%s: could not stat file "%s": %s
%s: could not write file "%s": %s
%s: data directory "%s" not removed at user's request
%s: directory "%s" exists but is not empty
%s: encoding mismatch
%s: failed to remove contents of data directory
%s: failed to remove contents of transaction log directory
%s: failed to remove data directory
%s: failed to remove transaction log directory
%s: failed to restore old locale "%s"
%s: file "%s" does not exist
%s: file "%s" is not a regular file
%s: input file "%s" does not belong to PostgreSQL %s
Check your installation or specify the correct path using the option -L.
%s: input file location must be an absolute path
%s: invalid authentication method "%s" for "%s" connections
%s: invalid locale name "%s"
%s: invalid locale settings; check LANG and LC_* environment variables
%s: locale "%s" requires unsupported encoding "%s"
%s: locale name has non-ASCII characters, skipped: "%s"
%s: locale name too long, skipped: "%s"
%s: must specify a password for the superuser to enable %s authentication
%s: no data directory specified
You must identify the directory where the data for this database system
will reside. Do this with either the invocation option -D or the
environment variable PGDATA.
%s: out of memory
%s: password file "%s" is empty
%s: password prompt and password file cannot be specified together
%s: removing contents of data directory "%s"
%s: removing contents of transaction log directory "%s"
%s: removing data directory "%s"
%s: removing transaction log directory "%s"
%s: setlocale() failed
%s: superuser name "%s" is disallowed; role names cannot begin with "pg_"
%s: symlinks are not supported on this platform %s: too many command-line arguments (first is "%s")
%s: transaction log directory "%s" not removed at user's request
%s: transaction log directory location must be an absolute path
%s: warning: specified text search configuration "%s" might not match locale "%s"
%s: warning: suitable text search configuration for locale "%s" is unknown
Data page checksums are disabled.
Data page checksums are enabled.
Encoding "%s" implied by locale is not allowed as a server-side encoding.
The default database encoding will be set to "%s" instead.
Encoding "%s" is not allowed as a server-side encoding.
Rerun %s with a different locale selection.
Enter it again: Enter new superuser password: If you want to create a new database system, either remove or empty
the directory "%s" or run %s
with an argument other than "%s".
If you want to store the transaction log there, either
remove or empty the directory "%s".
It contains a dot-prefixed/invisible file, perhaps due to it being a mount point.
It contains a lost+found directory, perhaps due to it being a mount point.
No usable system locales were found.
Passwords didn't match.
Rerun %s with the -E option.
Running in debug mode.
Running in noclean mode. Mistakes will not be cleaned up.
The database cluster will be initialized with locale "%s".
The database cluster will be initialized with locales
COLLATE: %s
CTYPE: %s
MESSAGES: %s
MONETARY: %s
NUMERIC: %s
TIME: %s
The default database encoding has accordingly been set to "%s".
The default text search configuration will be set to "%s".
The encoding you selected (%s) and the encoding that the
selected locale uses (%s) do not match. This would lead to
misbehavior in various character string processing functions.
Rerun %s and either do not specify an encoding explicitly,
or choose a matching combination.
The files belonging to this database system will be owned by user "%s".
This user must also own the server process.
The program "postgres" is needed by %s but was not found in the
same directory as "%s".
Check your installation.
The program "postgres" was found by "%s"
but was not the same version as %s.
Check your installation.
This might mean you have a corrupted installation or identified
the wrong directory with the invocation option -L.
Try "%s --help" for more information.
Usage:
Use the option "--debug" to see details.
Using a mount point directly as the data directory is not recommended.
Create a subdirectory under the mount point.
cannot duplicate null pointer (internal error)
caught signal
child process exited with exit code %d child process exited with unrecognized status %d child process was terminated by exception 0x%X child process was terminated by signal %d child process was terminated by signal %s command not executable command not found could not change directory to "%s": %s could not close directory "%s": %s
could not find a "%s" to execute could not get junction for "%s": %s
could not identify current directory: %s could not look up effective user ID %ld: %s could not open directory "%s": %s
could not read binary "%s" could not read directory "%s": %s
could not read symbolic link "%s" could not remove file or directory "%s": %s
could not set junction for "%s": %s
could not stat file or directory "%s": %s
could not write to child process: %s
creating configuration files ... creating directory %s ... creating subdirectories ... fixing permissions on existing directory %s ... invalid binary "%s" ok
out of memory
pclose failed: %s performing post-bootstrap initialization ... running bootstrap script ... selecting default max_connections ... selecting default shared_buffers ... selecting dynamic shared memory implementation ... syncing data to disk ... user does not exist user name lookup failure: error code %lu Project-Id-Version: PostgreSQL 9.6
Report-Msgid-Bugs-To: pgsql-bugs@postgresql.org
POT-Creation-Date: 2016-08-29 16:48-0300
PO-Revision-Date: 2010-09-25 00:45+0300
Last-Translator: Euler Taveira de Oliveira <euler@timbira.com>
Language-Team: Brazilian Portuguese <pgbr-dev@listas.postgresql.org.br>
Language: pt_BR
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Se o diretório de dados não for especificado, a variável de ambiente PGDATA
é utilizada.
Opções utilizadas com menos frequência:
Opções:
Outras opções:
Relate erros a <pgsql-bugs@postgresql.org>.
Sucesso. Você pode iniciar o servidor de banco de dados utilizando:
%s%s%spg_ctl%s -D %s%s%s -l logfile start
Sincronização com o disco foi ignorada.
O diretório de dados pode ser danificado se houver uma queda do sistema operacional.
AVISO: habilitando método de autenticação "trust" para conexões locais
Você pode mudá-lo editando o pg_hba.conf ou utilizando a opção -A, ou
--auth-local e --auth-host, na próxima vez que você executar o initdb.
--auth-host=MÉTODO método de autenticação padrão para conexões TCP/IP locais
--auth-local=MÉTODO método de autenticação padrão para conexões de soquete locais
--lc-collate, --lc-ctype, --lc-messages=LOCALE
--lc-monetary, --lc-numeric, --lc-time=LOCALE
ajusta configuração regional padrão na respectiva categoria
para novos bancos de dados (o ambiente é assumido como padrão)
--locale=LOCALE ajusta configuração regional padrão para novos bancos de dados
--no-locale equivalente a --locale=C
--pwfile=ARQUIVO lê senha do novo super-usuário a partir do arquivo
%s [OPÇÃO]... [DIRDADOS]
-?, --help mostra essa ajuda e termina
-A, --auth=MÉTODO método de autenticação padrão para conexões locais
-E, --encoding=CODIFICAÇÃO ajusta a codificação padrão para novos bancos de dados
-L DIRETÓRIO onde encontrar os arquivos de entrada
-N, --nosync não espera mudanças serem escritas com segurança no disco
-S, --sync-only sincroniza somente o diretório de dados
-T, --text-search-config=CFG
configuração de busca textual padrão
-U, --username=NOME nome do super-usuário do banco de dados
-V, --version mostra informação sobre a versão e termina
-W, --pwprompt pergunta senha do novo super-usuário
-X, --xlogdir=DIRXLOG local do log de transação
-d, --debug mostra saída da depuração
-k, --data-checksums verificações de páginas de dados
-n, --noclean não remove após erros
-s, --show mostra definições internas
[-D, --pgdata=]DIRDADOS local do agrupamento de banco de dados
%s inicializa um agrupamento de banco de dados PostgreSQL.
%s: "%s" não é um nome de codificação do servidor válido
%s: AVISO: não pode criar informações restritas nessa plataforma
%s: não pode ser executado como root
Por favor entre (utilizando, i.e., "su") como usuário (sem privilégios) que será
o dono do processo do servidor.
%s: não pôde acessar diretório "%s": %s
%s: não pôde acessar arquivo "%s": %s
%s: não pôde alocar SIDs: código de erro %lu
%s: não pôde mudar permissões de "%s": %s
%s: não pôde mudar permissões do diretório "%s": %s
%s: não pôde criar diretório "%s": %s
%s: não pôde criar informação restrita: código de erro %lu
%s: não pôde criar link simbólico "%s": %s
%s: não pôde executar comando "%s": %s
%s: não pôde encontrar codificação ideal para configuração regional "%s"
%s: não pôde encontrar configuração de busca textual ideal para configuração regional "%s"
%s: não pôde executar fsync no arquivo "%s": %s
%s: não pôde obter código de saída de subprocesso: código de erro %lu
%s: não pôde abrir diretório "%s": %s
%s: não pôde abrir arquivo "%s" para leitura: %s
%s: não pôde abrir arquivo "%s" para escrita: %s
%s: não pôde abrir arquivo "%s": %s
%s: não pôde abrir informação sobre processo: código de erro %lu
%s: não pôde executar novamente com informação restrita: código de erro %lu
%s: não pôde ler diretório "%s": %s
%s: não pôde ler senha do arquivo "%s": %s
%s: não pôde iniciar processo para comando "%s": código de erro %lu
%s: não pôde executar stat no arquivo "%s": %s
%s: não pôde escrever arquivo "%s": %s
%s: diretório de dados "%s" não foi removido a pedido do usuário
%s: diretório "%s" existe mas não está vazio
%s: codificação não corresponde
%s: falhou ao remover conteúdo do diretório de dados
%s: falhou ao remover conteúdo do diretório do log de transação
%s: falhou ao remover diretório de dados
%s: falhou ao remover diretório do log de transação
%s: falhou ao restaurar configuração regional antiga "%s"
%s: arquivo "%s" não existe
%s: arquivo "%s" não é um arquivo regular
%s: arquivo de entrada "%s" não pertence ao PostgreSQL %s
Verifique sua instalação ou especifique o caminho correto utilizando a opção -L.
%s: local do arquivo de entrada deve ser um caminho absoluto
%s: método de autenticação "%s" é inválido para conexões "%s"
%s: nome de configuração regional "%s" é inválido
%s: definições de configuração regional inválidas; verifique as variáveis de ambiente LANG e LC_*
%s: configuração regional "%s" requer codificação "%s" que não é suportada
%s: nome de configuração regional tem caracteres não-ASCII, ignorado: "%s"
%s: nome de configuração regional muito longo, ignorado: "%s"
%s: você precisa especificar uma senha para o super-usuário para habilitar a autenticação %s
%s: nenhum diretório de dados foi especificado
Você deve identificar o diretório onde os dados para esse sistema de banco de dados
irá residir. Faça isso com o invocação da opção -D ou a
variável de ambiente PGDATA.
%s: sem memória
%s: arquivo de senhas "%s" está vazio
%s: opção para perguntar a senha e um arquivo de senhas não podem ser especificados juntos
%s: removendo conteúdo do diretório de dados "%s"
%s: removendo conteúdo do diretório do log de transação "%s"
%s: removendo diretório de dados "%s"
%s: removendo diretório do log de transação "%s"
%s: setlocale() falhou
%s: nome de super-usuário "%s" não é permitido; nomes de roles não podem começar com "pg_"
%s: links simbólicos não são suportados nessa plataforma %s: muitos argumentos de linha de comando (primeiro é "%s")
%s: diretório do log de transação "%s" não foi removido a pedido do usuário
%s: diretório do log de transação deve ter um caminho absoluto
%s: aviso: configuração de busca textual especificada "%s" pode não corresponder a configuração regional "%s"
%s: aviso: configuração de busca textual ideal para configuração regional "%s" é desconhecida
Verificações de páginas de dados estão desabilitadas.
Verificações de páginas de dados estão habilitadas.
Codificação "%s" sugerida pela configuração regional não é permitida como uma codificação do servidor.
A codificação do banco de dados padrão será definida como "%s".
Codificação "%s" não é permitida como uma codificação do servidor.
Execute %s novamente com uma seleção de configuração regional diferente.
Digite-a novamente: Digite nova senha de super-usuário: Se você quer criar um novo sistema de banco de dados, remova ou esvazie
o diretório "%s" ou execute %s
com um argumento ao invés de "%s".
Se você quer armazenar o log de transação no mesmo,
remova ou esvazie o diretório "%s".
Ele contém um arquivo iniciado por ponto/invisível, talvez por ser um ponto de montagem.
Ele contém um diretório lost+found, talvez por ser um ponto de montagem.
Nenhuma configuração regional do sistema utilizável foi encontrada.
Senhas não correspondem.
Execute novamente %s com a opção -E.
Executando no modo de depuração.
Executando no modo sem limpeza. Erros não serão removidos.
O agrupamento de banco de dados será inicializado com configuração regional "%s".
O agrupamento de banco de dados será inicializado com configurações regionais
COLLATE: %s
CTYPE: %s
MESSAGES: %s
MONETARY: %s
NUMERIC: %s
TIME: %s
A codificação padrão do banco de dados foi definida para "%s".
A configuração de busca textual padrão será definida como "%s".
A codificação que você escolheu (%s) e a codificação que a configuração regional
selecionada utiliza (%s) não tem correspondência. Isto pode conduzir
a um comportamento inesperado em funções de processamento de cadeia de caracteres.
Execute novamente o %s e não especifique uma codificação explicitamente
ou escolha uma outra combinação.
Os arquivos deste sistema de banco de dados pertencerão ao usuário "%s".
Esse usuário deve ser o dono do processo do servidor também.
O programa "postgres" é requerido pelo %s mas não foi encontrado no
mesmo diretório que "%s".
Verifique sua instalação.
O programa "postgres" foi encontrado pelo "%s"
mas não tem a mesma versão que %s.
Verifique sua instalação.
Isso significa que você tem uma instalação corrompida ou especificou
o diretório errado com a invocação da opção -L.
Tente "%s --help" para obter informações adicionais.
Uso:
Utilize a opção "--debug" para obter detalhes.
Utilizar um ponto de montagem diretamente como diretório de dados não é recomendado.
Crie um subdiretório no ponto de montagem.
não pode duplicar ponteiro nulo (erro interno)
sinal foi recebido
processo filho terminou com código de saída %d processo filho terminou com status desconhecido %d processo filho foi terminado pela exceção 0x%X processo filho foi terminado pelo sinal %d processo filho foi terminado pelo sinal %s comando não é executável comando não foi encontrado não pôde mudar diretório para "%s": %s não pôde fechar diretório "%s": %s
não pôde encontrar o "%s" para executá-lo não pôde obter junção para "%s": %s
não pôde identificar diretório atual: %s não pôde encontrar ID de usuário efetivo %ld: %s não pôde abrir diretório "%s": %s
não pôde ler o binário "%s" não pôde ler diretório "%s": %s
não pôde ler link simbólico "%s" não pôde remover arquivo ou diretório "%s": %s
não pôde definir junção para "%s": %s
não pôde executar stat no arquivo ou diretório "%s": %s
não pôde escrever em processo filho: %s
criando arquivos de configuração ... criando diretório %s ... criando subdiretórios ... alterando permissões no diretório existente %s ... binário "%s" é inválido ok
sem memória
pclose falhou: %s executando pós-inicialização ... executando script de inicialização ... selecionando max_connections padrão ... selecionando shared_buffers padrão ... selecionando implementação de memória compartilhada dinâmica ... sincronizando dados no disco ... usuário não existe falhou ao pesquisar nome de usuário: código de erro %lu locale/pt_BR/LC_MESSAGES/ecpg-9.6.mo 0000644 00000034334 14751153421 0012375 0 ustar 00 �� y � � � 8
~ 9
- �
0 �
+ g C � 4 � 7 s 8 . � G � 4 #
) X
w �
4 �
/ @ B = � , � ! � , . 1 [ * � - � 1 � ' & @ + g " � # � � ) � = J T & p < � ! � � - + . " Z } , � � � * " . ' Q y � ! � � ! � 3 ; / o ' � 5 � I � , G / t * � T � ' $ L g � � � - � , � , ! 5 N � ) � ? � 8
� C � 0 � 5 % [ A p L � + �
+ 6 9 ' p # � � ( � 4 � ) ' Q / n � � $ � � " , 8 e } ' � � � $ � D $ + i ? � 0 � 8 % ^ | & � � � � � � - 0! 8 ^! - �! p �! " 6" ; Y" ? �" ~ �" : T# V �# C �# , *$ � W$ > �$ )% J B% D �% : �% &
& / 4& D d& 6 �& / �& 2 ' 6 C' , z' + �' 0 �' ' ( * ,( W( + ^( I �(
�( �( 7 ) K 8) # �) �) 7 �) 6 �) * * J* - b* �* �* 0 �* - �* . )+ X+ r+ & �+ �+ & �+ �+ ' , 9 9, 8 s, ( �, C �, X - / r- 8 �- 6 �- V . 3 i. �. �. �. �. / 0 / 0 O/ 0 �/ < �/ �/ / 0 J 70 ? �0 � �0 �1 E �1 ? �1 32 Q H2 W �2 6 �2 )3 ? 63 . v3 & �3 �3 + �3 : 4 + C4 o4 3 �4 & �4 ' �4 / 5 ?5 / ^5 7 �5 ! �5 ! �5 3
6 , >6 3 k6 1 �6 P �6 6 "7 K Y7 7 �7 " �7 C 8 ! D8 ! f8 ) �8 ) �8 Y * - < ? " 9 M O = ^ 0 w y , P 2 l
t ) G v 5 x C : e F Z ] X % k J H ; [ U i d
E N $ a b T ! 6 D h ( & g f u A K W # 1 V n B I + o _ 8 s Q 4 / 7 S ` L c > \ m p ' 3 @ q R j r .
If no output file is specified, the name is formed by adding .c to the
input file name, after stripping off .pgc if present.
Report bugs to <pgsql-bugs@postgresql.org>.
--regression run in regression testing mode
-?, --help show this help, then exit
-C MODE set compatibility mode; MODE can be one of
"INFORMIX", "INFORMIX_SE"
-D SYMBOL define SYMBOL
-I DIRECTORY search DIRECTORY for include files
-V, --version output version information, then exit
-c automatically generate C code from embedded SQL code;
this affects EXEC SQL TYPE
-d generate parser debug output
-h parse a header file, this option includes option "-c"
-i parse system include files as well
-o OUTFILE write result to OUTFILE
-r OPTION specify run-time behavior; OPTION can be:
"no_indicator", "prepare", "questionmarks"
-t turn on autocommit of transactions
%s at or near "%s" %s is the PostgreSQL embedded SQL preprocessor for C programs.
%s, the PostgreSQL embedded C preprocessor, version %d.%d.%d
%s: could not locate my own executable path
%s: could not open file "%s": %s
%s: no input files specified
%s: parser debug support (-d) not available
AT option not allowed in CLOSE DATABASE statement AT option not allowed in CONNECT statement AT option not allowed in DISCONNECT statement AT option not allowed in SET CONNECTION statement AT option not allowed in TYPE statement AT option not allowed in VAR statement AT option not allowed in WHENEVER statement COPY FROM STDIN is not implemented CREATE TABLE AS cannot specify INTO ERROR: EXEC SQL INCLUDE ... search starts here:
Error: include path "%s/%s" is too long on line %d, skipping
Options:
SHOW ALL is not implemented Try "%s --help" for more information.
Unix-domain sockets only work on "localhost" but not on "%s" Usage:
%s [OPTION]... FILE...
WARNING: arrays of indicators are not allowed on input could not open include file "%s" on line %d could not remove output file "%s"
cursor "%s" does not exist cursor "%s" has been declared but not opened cursor "%s" is already defined descriptor "%s" does not exist descriptor header item "%d" does not exist descriptor item "%s" cannot be set descriptor item "%s" is not implemented end of search list
expected "://", found "%s" expected "@" or "://", found "%s" expected "@", found "%s" expected "postgresql", found "%s" incomplete statement incorrectly formed variable "%s" indicator for array/pointer has to be array/pointer indicator for simple data type has to be simple indicator for struct has to be a struct indicator variable "%s" is hidden by a local variable indicator variable "%s" is hidden by a local variable of a different type indicator variable must have an integer type initializer not allowed in EXEC SQL VAR command initializer not allowed in type definition internal error: unreachable state; please report this to <pgsql-bugs@postgresql.org> interval specification not allowed here invalid bit string literal invalid connection type: %s invalid data type key_member is always 0 missing "EXEC SQL ENDIF;" missing identifier in EXEC SQL DEFINE command missing identifier in EXEC SQL IFDEF command missing identifier in EXEC SQL UNDEF command missing matching "EXEC SQL IFDEF" / "EXEC SQL IFNDEF" more than one EXEC SQL ELSE multidimensional arrays are not supported multidimensional arrays for simple data types are not supported multidimensional arrays for structures are not supported multilevel pointers (more than 2 levels) are not supported; found %d level multilevel pointers (more than 2 levels) are not supported; found %d levels nested /* ... */ comments nested arrays are not supported (except strings) no longer supported LIMIT #,# syntax passed to server nullable is always 1 only data types numeric and decimal have precision/scale argument only protocols "tcp" and "unix" and database type "postgresql" are supported operator not allowed in variable definition out of memory pointer to pointer is not supported for this data type pointers to varchar are not implemented subquery in FROM must have an alias syntax error syntax error in EXEC SQL INCLUDE command too many levels in nested structure/union definition too many nested EXEC SQL IFDEF conditions type "%s" is already defined type name "string" is reserved in Informix mode unmatched EXEC SQL ENDIF unrecognized data type name "%s" unrecognized descriptor item code %d unrecognized token "%s" unrecognized variable type code %d unsupported feature will be passed to server unterminated /* comment unterminated bit string literal unterminated hexadecimal string literal unterminated quoted identifier unterminated quoted string using unsupported DESCRIBE statement using variable "%s" in different declare statements is not supported variable "%s" is hidden by a local variable variable "%s" is hidden by a local variable of a different type variable "%s" is neither a structure nor a union variable "%s" is not a pointer variable "%s" is not a pointer to a structure or a union variable "%s" is not an array variable "%s" is not declared variable "%s" must have a numeric type zero-length delimited identifier Project-Id-Version: PostgreSQL 9.6
Report-Msgid-Bugs-To: pgsql-bugs@postgresql.org
POT-Creation-Date: 2017-08-06 01:59-0300
PO-Revision-Date: 2009-02-09 12:59-0200
Last-Translator: Euler Taveira de Oliveira <euler@timbira.com>
Language-Team: Brazilian Portuguese <pgbr-dev@listas.postgresql.org.br>
Language: pt_BR
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Plural-Forms: nplurals=2; plural=(n>1);
Se nenhum arquivo de saída for especificado, o nome é formado adicionando .c ao
nome do arquivo de entrada, após remover .pgc se presente.
Relate erros a <pgsql-bugs@postgresql.org>.
--regression executa em modo de teste de regressão
-?, --help mostra essa ajuda e termina
-C mode define o modo de compatilidade; MODE pode ser um de
"INFORMIX", "INFORMIX_SE"
-D SÍMBOLO define SÍMBOLO
-I DIRETÓRIO procura DIRETÓRIO para incluir arquivos
-V, --version mostra informação sobre a versão e termina
-c gera automaticamente código C a partir do código SQL embutido;
isso afeta o EXEC SQL TYPE
-d gera saída de depuração do analisador
-h analisa um arquivo de cabeçalho, essa opção inclui a opção "-c"
-i analisa arquivos de cabeçalho do sistema também
-o ARQUIVO grava resultado no ARQUIVO
-r OPÇÃO especifica comportamento em tempo de execução; OPÇÃO pode ser:
"no_indicator", "prepare", "questionmarks"
-t habilita o auto efetivação de transações
%s em ou próximo a "%s" %s é o pré-processador SQL embutido do PostgreSQL para programas em C.
%s, the pré-processador C embutido do PostgreSQL, versão %d.%d.%d
%s: não pôde localizar meu próprio caminho executável
%s: não pôde abrir arquivo "%s": %s
%s: nenhum arquivo de entrada foi especificado
%s: suporte a depuração do analisador (-d) não está disponível
opção AT não é permitida no comando CLOSE DATABASE opção AT não é permitida no comando CONNECT opção AT não é permitida no comando DISCONNECT opção AT não é permitida no comando SET CONNECTION opção AT não é permitida no comando TYPE opção AT não é permitida no comando VAR opção AT não é permitida no comando WHENEVER COPY FROM STDIN não está implementado CREATE TABLE AS não pode especificar INTO ERRO: EXEC SQL INCLUDE ... pesquisa inicia aqui:
Erro: caminho de inclusão "%s/%s" é muito longo na linha %d, ignorando
Opções:
SHOW ALL não está implementado Tente "%s --help" para obter informações adicionais.
Soquetes de domínio Unix trabalham somente com "localhost" e não com "%s" Uso:
%s [OPÇÃO]... ARQUIVO...
AVISO: matrizes do indicadores não são permitidas na entrada não pôde abrir arquivo de inclusão "%s" na linha %d não pôde remover arquivo de saída "%s"
cursor "%s" não existe cursor "%s" foi declarado mas não foi aberto cursor "%s" já está definido descritor "%s" não existe item do cabeçalho do descritor "%d" não existe item do descritor "%s" não pode ser definido item do descritor "%s" não está implementado fim da lista de pesquisa
esperado "://", encontrado "%s" esperado "@" ou "://", encontrado "%s" esperado "@", encontrado "%s" esperado "postgresql", encontrado "%s" comando incompleto variável "%s" possui formato incorreto indicador para matriz/ponteiro tem de ser matriz/ponteiro indicador para tipo de dados simples tem que ser simples indicador para struct tem que ser struct variável de indicador "%s" está escondida por uma variável local variável de indicador "%s" está escondida por uma variável local de um tipo diferente variável de indicador deve ter um tipo inteiro inicilização não é permitido no comando EXEC SQL VAR inicializador não é permitido na definição do tipo erro interno: estado inacessível; por favor relato isso a <pgsql-bugs@postgresql.org> especificação de intervalo não é permitida aqui cadeia de bits inválida tipo de conexão inválido: %s tipo de dado inválido key_member é sempre 0 faltando "EXEC SQL ENDIF;" faltando identificador no comando EXEC SQL IFDEF faltando identificador no comando EXEC SQL IFDEF faltando identificador no comando EXEC SQL UNDEF faltando correspondente "EXEC SQL IFDEF" / "EXEC SQL IFNDEF" mais de um EXEC SQL ELSE matrizes multidimensionais não são suportadas matrizes multidimensionais para tipo de dados simples não são suportadas matrizes multidimensionais para estruturas não são suportadas ponteiros com múltiplos níveis (mais do que 2 níveis) não são suportados; %d nível encontrado ponteiros com múltiplos níveis (mais do que 2 níveis) não são suportados; %d níveis encontrados comentários /* ... */ aninhados matrizes aninhadas não são suportadas (exceto cadeia de caracteres) sintaxe LIMIT #,# que não é suportada foi enviada ao servidor nullable é sempre 1 somente os tipos de dados numeric e decimal possuem argumento de precisão/escala somente os protocolos "tcp" e "unix" e tipo banco de dados "postgressql" sãosuportados operador não é permitido na definição da variável sem memória ponteiro para ponteiro não é suportado para esse tipo de dado ponteiros para varchar não estão implentados subconsulta no FROM deve ter um aliás erro de sintaxe erro de sintaxe no comando EXEC SQL INCLUDE muitos níveis em definição aninhada de estrutura/união muitas condições EXEC SQL IFDEF aninhadas tipo "%s" já está definido nome de tipo "string" é reservado no modo Informix EXEC SQL ENDIF não tem correspondente nome do tipo dados "%s" é desconhecido código do item do descritor %d é desconhecido informação desconhecida "%s" tipo de código de variável %d é desconhecido funcionalidade não suportada será enviada ao servidor comentário /* não foi terminado cadeia de bits não foi terminada cadeia de caracteres hexadecimal não foi terminada identificador entre aspas não foi terminado cadeia de caracteres entre aspas não foi terminada utilizando comando DESCRIBE que não é suportado utilizar variável "%s" em comandos de declaração diferentes não é suportado variável "%s" está escondida por uma variável local variável "%s" está escondida por uma variável local de um tipo diferente variável "%s" não é nem uma estrutura nem uma união variável "%s" não é um ponteiro variável "%s" não é um ponteiro para uma estrutura ou uma união variável "%s" não é uma matriz variável "%s" não foi declarada variável "%s" deve ter um tipo númerico identificador delimitado tem tamanho zero locale/pt_BR/LC_MESSAGES/pg_rewind-9.6.mo 0000644 00000047531 14751153421 0013440 0 ustar 00 �� � , � <
�
- �
1 �
? K Y C � ; � C % 9 i G � @ � , O 8 � � � � � J > Y , � 6 � < � 1 9 ? k = � = � 9 ' D a 4 � 9 � 4 2 J @ } R � > P W 1 x � � � � o � d j - � 4 � & 2 Y � s P � R G c � - � , K / i ; � � � # / % N t $ � + � $ �
$ ( L M , � 0 � " � ) , E r $ � $ � # � ' � " & I " g & � $ � � ( � " @ ' c � � � � 2 � ' 0 X ' v � / � - � 6 9 p ; � ) � � + ! % 4! Z! o! ! �! 3 �! 6 �! 1 " L" ' k" < �" _ �" 0# D# ! S# F u# �# �# �# % $ C -$ " q$ . �$ # �$ > �$ 6 &% 3 ]% 6 �% 0 �% �% + & & @& g& �& ! �& ( �& I �& $ <' ' a' �' - �' J �' = ( A ]( 6 �( 5 �( 5 ) ! B) 7 d) / �) 6 �) 1 * - 5* 9 c* � �* - g, K �, > �, T - H u- = �- Q �- @ N. O �. E �. %/ W 1/ �/ �/ �/ �/ 0 0 L 0 D i0 0 �0 @ �0 K 1 F l1 Q �1 G 2 E M2 I �2 V �2 = 43 F r3 = �3 C �3 Y ;4 n �4 J 5 O5 , W5 8 �5 �5
�5 ( �5 ) 6 { .6 n �6 : 7 Q T7 7 �7 �7 � �7 k �8 m #9 m �9 = �9 ; =: $ y: 0 �: B �: ; " ); & L; # s; . �; # �; % �; - < ' >< & f< ( �< _ �< 7 = ; N= % �= / �= 3 �= " > , 7> - d> ( �> , �> # �> ? # -? ( Q? ' z? $ �? , �? * �? / @ 5 O@ # �@ ! �@ ' �@ �@ ? A . RA - �A , �A ( �A ; B 8 AB zB = �B �B R �B / GC ! wC 1 �C . �C �C + D / DD E tD A �D > �D + ;E 6 gE H �E k �E ' SF
{F " �F X �F G " G # >G , bG E �G . �G / H ' 4H [ \H C �H @ �H = =I > {I ( �I < �I , J * MJ - xJ - �J 4 �J \ K ' fK # �K & �K : �K X L A mL J �L H �L : CM : ~M . �M G �M = 0N ? nN 2 �N 4 �N B O � & 5 � Y } � � � [ � s ! q � J ~ � � % < e U � 1 | z : � j . a F
g R 6 � � c � 8 l I ( m _ r � � � @ 9 � u D # � � 0 $ v 3 � � � ` P i y � ) � ]
B x L E > h 2 b Q d t � / n ? � ; � S X w T + f M { ^ K � H N G 4 O k = � � Z ' p , W - � � C A V \ " * � 7 o �
Report bugs to <pgsql-bugs@postgresql.org>.
creating backup label and updating control file
--debug write a lot of debug messages
--source-pgdata=DIRECTORY source data directory to synchronize with
--source-server=CONNSTR source server to synchronize with
-?, --help show this help, then exit
-D, --target-pgdata=DIRECTORY existing data directory to modify
-P, --progress write progress messages
-V, --version output version information, then exit
-n, --dry-run stop before modifying anything
block %u
"%s" is a symbolic link, but symbolic links are not supported on this platform
"%s" is not a directory
"%s" is not a regular file
"%s" is not a symbolic link
%*s/%s kB (%d%%) copied %d: %X/%X - %X/%X
%s (%s)
%s resynchronizes a PostgreSQL cluster with another copy of the cluster.
%s: WARNING: cannot create restricted tokens on this platform
%s: could not allocate SIDs: error code %lu
%s: could not create restricted token: error code %lu
%s: could not get exit code from subprocess: error code %lu
%s: could not open process token: error code %lu
%s: could not re-execute with restricted token: error code %lu
%s: could not start process for command "%s": error code %lu
%s: no source specified (--source-pgdata or --source-server)
%s: no target data directory specified (--target-pgdata)
%s: only one of --source-pgdata or --source-server can be specified
%s: too many command-line arguments (first is "%s")
BKPBLOCK_HAS_DATA not set, but data length is %u at %X/%X BKPBLOCK_HAS_DATA set, but no data included at %X/%X BKPBLOCK_SAME_REL set but no previous rel at %X/%X BKPIMAGE_HAS_HOLE not set, but hole offset %u length %u at %X/%X BKPIMAGE_HAS_HOLE set, but hole offset %u length %u block image length %u at %X/%X BKPIMAGE_IS_COMPRESSED set, but block image length %u at %X/%X Done!
Expected a numeric timeline ID.
Expected a transaction log switchpoint location.
Failure, exiting
Options:
Source timeline history:
Target timeline history:
The program "initdb" is needed by %s but was
not found in the same directory as "%s".
Check your installation.
The program "initdb" was found by "%s"
but was not the same version as %s.
Check your installation.
Timeline IDs must be in increasing sequence.
Timeline IDs must be less than child timeline's ID.
Try "%s --help" for more information.
Usage:
%s [OPTION]...
WAL file is from different database system: WAL file database system identifier is %s, pg_control database system identifier is %s WAL file is from different database system: incorrect XLOG_BLCKSZ in page header WAL file is from different database system: incorrect XLOG_SEG_SIZE in page header WAL record modifies a relation, but record type is not recognized
lsn: %X/%X, rmgr: %s, info: %02X
You must run %s as the PostgreSQL superuser.
backup label buffer too small
cannot be executed by "root"
cannot duplicate null pointer (internal error)
clusters are not compatible with this version of pg_rewind
connected to server
contrecord is requested by %X/%X could not close directory "%s": %s
could not close file "%s": %s
could not close target file "%s": %s
could not connect to server: %s could not create directory "%s": %s
could not create symbolic link at "%s": %s
could not create temporary table: %s could not fetch file list: %s could not fetch remote file "%s": %s could not find common ancestor of the source and target cluster's timelines
could not find previous WAL record at %X/%X
could not find previous WAL record at %X/%X: %s
could not open directory "%s": %s
could not open file "%s" for reading: %s
could not open file "%s" for truncation: %s
could not open file "%s": %s
could not open source file "%s": %s
could not open target file "%s": %s
could not read WAL record at %X/%X
could not read WAL record at %X/%X: %s
could not read directory "%s": %s
could not read file "%s": %s
could not read from file "%s": %s
could not read symbolic link "%s": %s
could not remove directory "%s": %s
could not remove file "%s": %s
could not remove symbolic link "%s": %s
could not seek in file "%s": %s
could not seek in source file: %s
could not seek in target file "%s": %s
could not send COPY data: %s could not send end-of-COPY: %s could not send file list: %s could not send query: %s could not set libpq connection to single row mode
could not set up connection context: %s could not stat file "%s": %s
could not truncate file "%s" to %u: %s
could not write file "%s": %s
data file "%s" in source is not a regular file
error running query (%s) in source server: %s fetched file "%s", length %d
full_page_writes must be enabled in the source server
getting file chunks
incorrect resource manager data checksum in record at %X/%X invalid action (CREATE) for regular file
invalid block_id %u at %X/%X invalid compressed image at %X/%X, block %d invalid contrecord length %u at %X/%X invalid control file invalid data in history file
invalid data in history file: %s
invalid info bits %04X in log segment %s, offset %u invalid magic number %04X in log segment %s, offset %u invalid record length at %X/%X: wanted %u, got %u invalid record offset at %X/%X invalid resource manager ID %u at %X/%X need to copy %lu MB (total source directory size is %lu MB)
neither BKPIMAGE_HAS_HOLE nor BKPIMAGE_IS_COMPRESSED set, but block image length is %u at %X/%X no rewind required
out of memory
out-of-order block_id %u at %X/%X out-of-sequence timeline ID %u (after %u) in log segment %s, offset %u reading WAL in target
reading source file list
reading target file list
received chunk for file "%s", offset received null value for chunk for file "%s", file has been deleted
record length %u at %X/%X too long record with incorrect prev-link %X/%X at %X/%X record with invalid length at %X/%X rewinding from last common checkpoint at %X/%X on timeline %u
servers diverged at WAL position %X/%X on timeline %u
source and target cluster are on the same timeline
source and target clusters are from different systems
source data directory must be shut down cleanly
source file list is empty
source server must not be in recovery mode
symbolic link "%s" target is too long
sync of target directory failed
syncing target data directory
syntax error in history file: %s
target server must be shut down cleanly
target server needs to use either data checksums or "wal_log_hints = on"
there is no contrecord flag at %X/%X unexpected EOF while reading file "%s"
unexpected control file CRC
unexpected control file size %d, expected %d
unexpected data types in result set while fetching remote files: %u %u %u
unexpected null values in result while fetching remote files
unexpected page modification for directory or symbolic link "%s"
unexpected pageaddr %X/%X in log segment %s, offset %u unexpected result format while fetching remote files
unexpected result length while fetching remote files
unexpected result set from query
unexpected result set size while fetching remote files
unexpected result set while fetching file list
unexpected result set while fetching remote file "%s"
unexpected result while fetching remote files: %s unexpected result while sending file list: %s unrecognized result "%s" for current WAL insert location
Project-Id-Version: pg_rewind (PostgreSQL) 9.6
Report-Msgid-Bugs-To: pgsql-bugs@postgresql.org
POT-Creation-Date: 2017-08-06 01:59-0300
PO-Revision-Date: 2015-10-04 16:36-0300
Last-Translator: Euler Taveira de Oliveira <euler@timbira.com>
Language-Team: Brazilian Portuguese <pgbr-dev@listas.postgresql.org.br>
Language: pt_BR
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Plural-Forms: nplurals=2; plural=(n>1);
Relate erros a <pgsql-bugs@postgresql.org>.
criando rótulo de cópia de segurança e atualizando arquivo de controle
--debug mostra saída da depuração
--source-pgdata=DIRETÓRIO sincroniza com esse diretório de dados de origem
--source-server=TEXTO sincroniza com esse servidor de origem
-?, --help mostra essa ajuda e termina
-D, --target-pgdata=DIRETÓRIO diretório de dados existente a ser modificado
-P, --progress escreve mensagens de progresso
-V, --version mostra informação sobre a versão e termina
-n, --dry-run para antes de qualquer modifcação
bloco %u
"%s" é um link simbólico mas links simbólicos não são suportados nesta plataforma
"%s" não é um diretório
"%s" não é um arquivo regular
"%s" não é um link simbólico
%*s/%s kB (%d%%) copiado %d: %X/%X - %X/%X
%s (%s)
%s sincroniza um agrupamento do PostgreSQL com outra cópia do agrupamento.
%s: AVISO: não pode criar informações restritas nessa plataforma
%s: não pôde alocar SIDs: código de erro %lu
%s: não pôde criar informação restrita: código de erro %lu
%s: não pôde obter código de saída de subprocesso: código de erro %lu
%s: não pôde abrir informação sobre processo: código de erro %lu
%s: não pôde executar novamente com informação restrita: código de erro %lu
%s: não pôde iniciar processo para comando "%s": código de erro %lu
%s: nenhuma origem especificada (--source-pgdata ou --source-server)
%s: nenhum diretório de dados de destino especificado (--target-pgdata)
%s: somente uma das opções --source-pgdata ou --source-server pode ser especificada
%s: muitos argumentos de linha de comando (primeiro é "%s")
BKPBLOCK_HAS_DATA não foi definido mas tamanho do dado é %u em %X/%X BKPBLOCK_HAS_DATA definido mas nenhum dado incluído em %X/%X BKPBLOCK_SAME_REL definido mas não há relação anterior em %X/%X BKPIMAGE_HAS_HOLE não foi definido mas posição do espaço livre %u tamanho %u em %X/%X BKPIMAGE_HAS_HOLE definido mas posição do espaço livre %u tamanho %u tamanho da imagem do bloco %u em %X/%X BKPIMAGE_IS_COMPRESSED definido mas tamanho da imagem do bloco %u em %X/%X Feito!
Esperado um ID de linha do tempo numérico.
Esperado um local de transição do log de transação.
Falha, terminando
Opções:
Histórico da linha do tempo de origem:
Histórico da linha do tempo de destino:
O programa "initdb" é requerido pelo %s mas não
foi encontrado no mesmo diretório que "%s".
Verifique sua instalação.
O programa "initdb" foi encontrado pelo "%s"
mas não tem a mesma versão que %s.
Verifique sua instalação.
IDs de linha do tempo devem ser uma sequência crescente.
IDs de linha do tempo devem ser menores do que ID de linha do tempo descendente.
Tente "%s --help" para obter informações adicionais.
Uso:
%s [OPÇÃO]...
arquivo do WAL é de um sistema de banco de dados diferente: identificador do sistema de banco de dados do arquivo do WAL é %s, identificador do sistema de banco de dados do pg_control é %s arquivo do WAL é de um sistema de banco de dados diferente: XLOG_BLCKSZ incorreto no cabeçalho da página arquivo do WAL é de um sistema de banco de dados diferente: XLOG_SEG_SIZE incorreto no cabeçalho da página registro do WAL modifica uma relação mas tipo do registro é desconhecido
lsn: %X/%X, rmgr: %s, info: %02X
Você deve executar %s como um super-usuário do PostgreSQL.
buffer do rótulo da cópia de segurança é muito pequeno
não pode ser executado pelo "root"
não pode duplicar ponteiro nulo (erro interno)
agrupamentos não são compatíveis com esta versão do pg_rewind
conectado ao servidor
contrecord é solicitado por %X/%X não pôde fechar diretório "%s": %s
não pôde fechar arquivo "%s": %s
não pôde fechar arquivo de destino "%s": %s
não pôde conectar ao servidor: %s não pôde criar diretório "%s": %s
não pôde criar link simbólico em "%s": %s
não pôde criar tabela temporária: %s não pôde obter lista de arquivos: %s não pôde obter arquivo remoto "%s": %s não pôde encontrar antecessor comum das linhas do tempo dos agrupamentos de origem e destino
não pôde encontrar registro do WAL anterior em %X/%X
não pôde encontrar registro do WAL anterior em %X/%X: %s
não pôde abrir diretório "%s": %s
não pôde abrir arquivo "%s" para leitura: %s
não pôde abrir arquivo "%s" para truncamento: %s
não pôde abrir arquivo "%s": %s
não pôde abrir arquivo de origem "%s": %s
não pôde abrir arquivo de destino "%s": %s
não pôde ler registro do WAL em %X/%X
não pôde ler registro do WAL em %X/%X: %s
não pôde ler diretório "%s": %s
não pôde ler arquivo "%s": %s
não pôde ler do arquivo "%s": %s
não pôde ler link simbólico "%s": %s
não pôde remover diretório "%s": %s
não pôde remover arquivo "%s": %s
não pôde remover link simbólico "%s": %s
não pôde posicionar no arquivo "%s": %s
não pôde posicionar no arquivo de origem: %s
não pôde posicionar no arquivo de destino "%s": %s
não pôde enviar dados do COPY: %s não pôde enviar fim do COPY: %s não pôde enviar lista de arquivos: %s não pôde enviar consulta: %s não pôde definir conexão libpq para modo de registro único
não pôde configurar contexto de conexão: %s não pôde executar stat no arquivo "%s": %s
não pôde truncar arquivo "%s" para %u: %s
não pôde escrever no arquivo "%s": %s
arquivo de dados "%s" na origem não é um arquivo regular
erro ao executar consulta (%s) no servidor de origem: %s arquivo "%s" obtido, tamanho %d
full_page_writes deve estar habilitado no servidor de origem
obtendo blocos do arquivo
soma de verificação do gerenciador de recursos é incorreta no registro em %X/%X ação inválida (CREATE) para arquivo regular
block_id %u é inválido em %X/%X imagem compactada é inválida em %X/%X, bloco %d tamanho de contrecord %u é inválido em %X/%X arquivo de controle inválido dado é inválido no arquivo de histórico
dado é inválido no arquivo de histórico: %s
bits de marcação %04X inválidos no arquivo de log %s, posição %u número mágico %04X inválido no arquivo de log %s, posição %u tamanho do registro inválido em %X/%X: desejado %u, obtido %u posição do registro é inválida em %X/%X ID do gerenciador de recursos %u é inválido em %X/%X precisa copiar %lu MB (tamanho total do diretório de origem é %lu MB)
nem BKPIMAGE_HAS_HOLE nem BKPIMAGE_IS_COMPRESSED foi definido mas tamanho da imagem do bloco é %u em %X/%X nenhuma sincronização é necessária
sem memória
block_id %u fora de ordem em %X/%X ID de linha do tempo %u fora de sequência (após %u) no arquivo de log %s, posição %u lendo WAL no destino
lendo lista de arquivos da origem
lendo lista de arquivos do destino
bloco recebido para arquivo "%s", posição valor nulo recebido para bloco do arquivo "%s", arquivo foi removido
tamanho do registro %u em %X/%X é muito longo registro com prev-link %X/%X incorreto em %X/%X registro com tamanho inválido em %X/%X sincronizando a partir do último ponto de controle em comum em %X/%X na linha do tempo %u
servidores divergem na posição do WAL %X/%X na linha do tempo %u
agrupamentos de origem e destino estão na mesma linha do tempo
agrupamentos de origem e destino são de sistemas diferentes
diretório de dados de origem deve ser desligado corretamente
lista de arquivos da origem está vazia
servidor de origem não deve estar em modo de recuperação
alvo do link simbólico "%s" é muito longo
sincronia do diretório de destino falhou
sincronizando diretório de dados de destino
erro de sintaxe no arquivo de histórico: %s
servidor de destino deve ser desligado corretamente
servidor de destino precisa utilizar soma de verificação de dados ou "wal_log_hints = on"
não há marcação contrecord em %X/%X EOF inesperado ao ler arquivo "%s"
CRC do arquivo de controle inesperado
tamanho de arquivo de controle inesperado %d, esperado %d
tipos de daos inesperados no conjunto de resultados ao obter arquivos remotos: %u %u %u
valores nulos inesperados em resultado ao obter arquivos remotos
modificação de página inesperada em diretório ou link simbólico "%s"
endereço da página %X/%X inesperado no arquivo de log %s, posição %u formato de resultado inesperado ao obter arquivos remotos
tamanho de resultado inesperado ao obter arquivos remotos
conjunto de resultados inesperado da consulta
tamanho do conjunto de resultados inesperado ao obter arquivos remotos
conjunto de resultados inesperado ao obter lista de arquivos
conjunto de resultados inesperado ao obter arquivo remoto "%s"
resultado inesperado ao obter arquivos remotos: %s resultado inesperado ao enviar lista de arquivos: %s resultado desconhecido "%s" para local de inserção atual no WAL
locale/pt_BR/LC_MESSAGES/pg_basebackup-9.6.mo 0000644 00000070732 14751153421 0014247 0 ustar 00 �� � �
p q � � � ! �
� - � X # T | R � ` $ I � D � 3 & K Z < � j � > N N � @ � 3 Y Q > � 1 � j < � ? � M k R J � Y + c 0 � B � B * F 8 q � � 5 9 � o r � o j 1 � 3 K @ - � F � \ P ^ 2 � 4 � 8 1 P 4 � 1 � . � @ 1 Y E � B � 7 ! L! f! ( �! ' �! & �! ; �! ( :" - c" ' �" " �" �" # �" 2 !# , T# + �# . �# ( �# # $ 5 )$ f _$ , �$ 9 �$ 4 -% 7 b% = �% d �% A =& " & & �& & �& # �& / ' > D' a �' & �' & ( % 3( 2 Y( 1 �( 0 �( 8 �( ( () 2 Q) �) & �) ' �) . �) + #* # O* A s* 2 �* & �* & + / 6+ + f+ 4 �+ / �+ ! �+ 1 , ) K, ( u, 2 �, 2 �, 3 - 0 8- % i- # �- + �- �- �- 2 . # A. e. , �. , �. # �. i / i j/ ? �/ 9 0 " N0 A q0 # �0 �0 9 �0 21 P1 ! g1 D �1 & �1 # �1 A 2 - [2 D �2 ! �2 �2 3 " "3 E3 9 c3 1 �3 D �3 , 4 A4 ' T4 D |4 M �4 : 5 8 J5 6 �5 �5 E �5 G 6 z a6 c �6 % @7 . f7 2 �7 6 �7 # �7 #8 % <8 0 b8 R �8 , �8 4 9 K H9 @ �9 > �9 - : , B: ' o: , �: o �: k 4; 4 �; % �; ( �; ; $<
`< & k< �< / �< �< / �< � = �> �> �>
? " ? B? - N? b |? ] �? V =@ d �@ [ �@ 5 UA �A 5 �A P �A M %B k sB B �B H "C I kC : �C ] �C A ND A �D s �D N FE G �E G �E w %F V �F i �F : ^G A �G I �G Z %H A �H D �H � I H �I � �I | |J | �J 5 vK . �K c �K 0 ?L F pL \ �L P M ; eM 7 �M O �M C )N J mN 6 �N 3 �N P #O @ tO I �O F �O ; FP ! �P * �P - �P 5 �P & 3Q M ZQ + �Q 2 �Q * R ' 2R ' ZR * �R > �R 3 �R 1 S 1 RS ) �S & �S = �S w T . �T ; �T F �T A =U L U y �U T FV 2 �V 9 �V / W ; 8W : tW J �W p �W 8 kX ) �X - �X F �X < CY @ �Y H �Y .
Z 8 9Z $ rZ ' �Z �Z 0 �Z 3 [ ) D[ H n[ = �[ 8 �[ + .\ 6 Z\ 4 �\ : �\ 7 ] 1 9] G k] . �] , �] < ^ < L^ L �^ 7 �^ , _ ) ;_ 0 e_ & �_ �_ > �_ + ` :` 5 Z` : �` , �` u �` w na P �a Q 7b - �b R �b ,
c ) 7c C ac % �c �c * �c X d 8 id 1 �d K �d 6 e P We * �e ' �e ! �e 2 f / Pf L �f 9 �f R g E Zg �g / �g S �g h 6h G �h A �h A )i ki Y �i W �i � 6j t �j / 4k 1 dk 8 �k > �k * l 9l + Ml < yl [ �l 4 m = Gm M �m B �m I n = `n 9 �n 8 �n 6 o { Ho � �o 4 Lp ( �p + �p = �p q 7 q Tq 0 Zq
�q @ �q � * � � p D $ f \ ^ � k ? � � � � g � - S � � � � P < � t � ~ 2 C � q d � | ; O 7 � � � ) A + Z � � � � � { & U K i � I H L � u x Y w � � � 9 � = � � . / � l 5 B V � � � � � ` � � 6 � F
[ � T J , � � e # y � � R z @ Q � � j � � v _ � > � � W
� 0 o � ( � � ] : � � s � � � � 4 � h � N " � 3 1 � E n m 8 b � � c G r � % X � � � � ! � � } a M � � � ' �
Action to be performed:
Connection options:
General options:
Optional actions:
Options controlling the output:
Options:
Report bugs to <pgsql-bugs@postgresql.org>.
--create-slot create a new replication slot (for the slot's name see --slot)
--drop-slot drop the replication slot (for the slot's name see --slot)
--if-not-exists do not error if slot already exists when creating a slot
--start start streaming in a replication slot (for the slot's name see --slot)
--synchronous flush transaction log immediately after writing
--xlogdir=XLOGDIR location for the transaction log directory
%s [OPTION]...
-?, --help show this help, then exit
-D, --directory=DIR receive transaction log files into this directory
-D, --pgdata=DIRECTORY receive base backup into directory
-F --fsync-interval=SECS
time between fsyncs to the output file (default: %d)
-F, --format=p|t output format (plain (default), tar)
-I, --startpos=LSN where in an existing slot should the streaming start
-P, --plugin=PLUGIN use output plugin PLUGIN (default: %s)
-P, --progress show progress information
-R, --write-recovery-conf
write recovery.conf for replication
-S, --slot=SLOTNAME name of the logical replication slot
-S, --slot=SLOTNAME replication slot to use
-T, --tablespace-mapping=OLDDIR=NEWDIR
relocate tablespace in OLDDIR to NEWDIR
-U, --username=NAME connect as specified database user
-V, --version output version information, then exit
-W, --password force password prompt (should happen automatically)
-X, --xlog-method=fetch|stream
include required WAL files with specified method
-Z, --compress=0-9 compress tar output with given compression level
-c, --checkpoint=fast|spread
set fast or spread checkpointing
-d, --dbname=CONNSTR connection string
-d, --dbname=DBNAME database to connect to
-f, --file=FILE receive log into this file, - for stdout
-h, --host=HOSTNAME database server host or socket directory
-l, --label=LABEL set backup label
-n, --no-loop do not loop on connection lost
-o, --option=NAME[=VALUE]
pass option NAME with optional value VALUE to the
output plugin
-p, --port=PORT database server port number
-r, --max-rate=RATE maximum transfer rate to transfer data directory
(in kB/s, or use suffix "k" or "M")
-s, --status-interval=INTERVAL
time between status packets sent to server (in seconds)
-s, --status-interval=SECS
time between status packets sent to server (default: %d)
-v, --verbose output verbose messages
-w, --no-password never prompt for password
-x, --xlog include required WAL files in backup (fetch mode)
-z, --gzip compress tar output
%*s/%s kB (%d%%), %d/%d tablespace %*s/%s kB (%d%%), %d/%d tablespaces %*s/%s kB (%d%%), %d/%d tablespace (%s%-*.*s) %*s/%s kB (%d%%), %d/%d tablespaces (%s%-*.*s) %*s/%s kB (100%%), %d/%d tablespace %*s %*s/%s kB (100%%), %d/%d tablespaces %*s %s controls PostgreSQL logical decoding streams.
%s receives PostgreSQL streaming transaction logs.
%s takes a base backup of a running PostgreSQL server.
%s: %s needs a slot to be specified using --slot
%s: COPY stream ended before last file was finished
%s: WAL streaming can only be used in plain mode
%s: at least one action needs to be specified
%s: can only write single tablespace to stdout, database has %d
%s: cannot specify both --xlog and --xlog-method
%s: cannot use --create-slot or --drop-slot together with --startpos
%s: cannot use --create-slot or --start together with --drop-slot
%s: cannot use --create-slot together with --drop-slot
%s: checkpoint completed
%s: child %d died, expected %d
%s: child process did not exit normally
%s: child process exited with error %d
%s: child thread exited with error %u
%s: confirming write up to %X/%X, flush to %X/%X (slot %s)
%s: could not access directory "%s": %s
%s: could not close compressed file "%s": %s
%s: could not close directory "%s": %s
%s: could not close file "%s": %s
%s: could not connect to server
%s: could not connect to server: %s %s: could not create archive status file "%s": %s
%s: could not create background process: %s
%s: could not create background thread: %s
%s: could not create compressed file "%s": %s
%s: could not create directory "%s": %s
%s: could not create file "%s": %s
%s: could not create pipe for background process: %s
%s: could not create replication slot "%s": got %d rows and %d fields, expected %d rows and %d fields
%s: could not create symbolic link "%s": %s
%s: could not create symbolic link from "%s" to "%s": %s
%s: could not create timeline history file "%s": %s
%s: could not determine seek position in file "%s": %s
%s: could not determine server setting for integer_datetimes
%s: could not drop replication slot "%s": got %d rows and %d fields, expected %d rows and %d fields
%s: could not establish database-specific replication connection
%s: could not fsync file "%s": %s
%s: could not fsync log file "%s": %s
%s: could not get COPY data stream: %s %s: could not get backup header: %s %s: could not get child thread exit status: %s
%s: could not get transaction log end position from server: %s %s: could not identify system: got %d rows and %d fields, expected %d rows and %d or more fields
%s: could not initiate base backup: %s %s: could not open directory "%s": %s
%s: could not open log file "%s": %s
%s: could not open timeline history file "%s": %s
%s: could not open transaction log file "%s": %s
%s: could not pad transaction log file "%s": %s
%s: could not parse next timeline's starting point "%s"
%s: could not parse start position "%s"
%s: could not parse transaction log location "%s"
%s: could not read COPY data: %s %s: could not read directory "%s": %s
%s: could not read from ready pipe: %s
%s: could not receive data from WAL stream: %s %s: could not rename file "%s" to "%s": %s
%s: could not rename file "%s": %s
%s: could not seek to beginning of transaction log file "%s": %s
%s: could not send command to background pipe: %s
%s: could not send copy-end packet: %s %s: could not send feedback packet: %s %s: could not send replication command "%s": %s %s: could not set compression level %d: %s
%s: could not set permissions on directory "%s": %s
%s: could not set permissions on file "%s": %s
%s: could not stat file "%s": %s
%s: could not stat transaction log file "%s": %s
%s: could not wait for child process: %s
%s: could not wait for child thread: %s
%s: could not write %u bytes to WAL file "%s": %s
%s: could not write %u bytes to log file "%s": %s
%s: could not write timeline history file "%s": %s
%s: could not write to compressed file "%s": %s
%s: could not write to file "%s": %s
%s: creating replication slot "%s"
%s: directory "%s" exists but is not empty
%s: directory name too long
%s: disconnected
%s: disconnected; waiting %d seconds to try again
%s: dropping replication slot "%s"
%s: final receive failed: %s %s: finished segment at %X/%X (timeline %u)
%s: got WAL data offset %08x, expected %08x
%s: incompatible server version %s
%s: incompatible server version %s; client does not support streaming from server versions newer than %s
%s: incompatible server version %s; client does not support streaming from server versions older than %s
%s: initiating base backup, waiting for checkpoint to complete
%s: integer_datetimes compile flag does not match server
%s: invalid --max-rate unit: "%s"
%s: invalid checkpoint argument "%s", must be "fast" or "spread"
%s: invalid compression level "%s"
%s: invalid fsync interval "%s"
%s: invalid output format "%s", must be "plain" or "tar"
%s: invalid port number "%s"
%s: invalid socket: %s %s: invalid status interval "%s"
%s: invalid tablespace mapping format "%s", must be "OLDDIR=NEWDIR"
%s: invalid tar block header size: %d
%s: invalid transfer rate "%s": %s
%s: invalid xlog-method option "%s", must be "fetch" or "stream"
%s: multiple "=" signs in tablespace mapping
%s: new directory is not an absolute path in tablespace mapping: %s
%s: no data returned from server
%s: no database specified
%s: no slot specified
%s: no target directory specified
%s: no target file specified
%s: no transaction log end position returned from server
%s: not renaming "%s%s", segment is not complete
%s: old directory is not an absolute path in tablespace mapping: %s
%s: only tar mode backups can be compressed
%s: out of memory
%s: received interrupt signal, exiting
%s: received transaction log record for offset %u with no file open
%s: replication connection using slot "%s" is unexpectedly database specific
%s: replication slots can only be used with WAL streaming
%s: replication stream was terminated before stop point
%s: segment file "%s" has incorrect size %d, skipping
%s: select() failed: %s
%s: server reported unexpected history file name for timeline %u: %s
%s: server reported unexpected next timeline %u, following timeline %u
%s: server returned unexpected response to BASE_BACKUP command; got %d rows and %d fields, expected %d rows and %d fields
%s: server stopped streaming timeline %u at %X/%X, but reported next timeline %u to begin at %X/%X
%s: starting background WAL receiver
%s: starting log streaming at %X/%X (slot %s)
%s: starting log streaming at %X/%X (timeline %u)
%s: starting timeline %u is not present in the server
%s: streaming header too small: %d
%s: streaming initiated
%s: switched to timeline %u at %X/%X
%s: symlinks are not supported on this platform
%s: system identifier does not match between base backup and streaming connection
%s: this build does not support compression
%s: too many command-line arguments (first is "%s")
%s: transaction log directory location can only be specified in plain mode
%s: transaction log directory location must be an absolute path
%s: transaction log file "%s" has %d bytes, should be 0 or %d
%s: transfer rate "%s" exceeds integer range
%s: transfer rate "%s" is not a valid value
%s: transfer rate "%s" is out of range
%s: transfer rate must be greater than zero
%s: unexpected response to TIMELINE_HISTORY command: got %d rows and %d fields, expected %d rows and %d fields
%s: unexpected result set after end-of-timeline: got %d rows and %d fields, expected %d rows and %d fields
%s: unexpected termination of replication stream: %s %s: unrecognized link indicator "%c"
%s: unrecognized streaming header: "%c"
%s: waiting for background process to finish streaming ...
Password: Try "%s --help" for more information.
Usage:
cannot duplicate null pointer (internal error)
out of memory
transaction log start point: %s on timeline %u
Project-Id-Version: PostgreSQL 9.6
Report-Msgid-Bugs-To: pgsql-bugs@postgresql.org
POT-Creation-Date: 2017-05-10 12:10-0300
PO-Revision-Date: 2011-08-20 23:33-0300
Last-Translator: Euler Taveira de Oliveira <euler@timbira.com>
Language-Team: Brazilian Portuguese <pgbr-dev@listas.postgresql.org.br>
Language: pt_BR
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Plural-Forms: nplurals=2; plural=n>1;
Ação a ser executada:
Opções de conexão:
Opções gerais:
Ações opcionais:
Opções que controlam a saída:
Opções:
Relate erros a <pgsql-bugs@postgresql.org>.
--create-slot cria uma nova entrada de replicação (para nome da entrada veja --slot)
--drop-slot remove a entrada de replicação (para nome da entrada veja --slot)
--if-not-exists não emite erro se a entrada já existe ao criar uma entrada
--start inicia fluxo na entrada de replicação (para nome da entrada veja --slot)
--synchronous escreve log de transação no disco imediatamente após a escrita
--xlogdir=DIRXLOG local do log de transação
%s [OPÇÃO]...
-?, --help mostra essa ajuda e termina
-D, --directory=DIR recebe arquivos de log de transação neste diretório
-D, --pgdata=DIRETÓRIO armazena a cópia de segurança base no diretório
-F, --fsync-interval=SEGS
tempo entre fsyncs no arquivo de saída (padrão: %d)
-F, --format=p|t formato de saída (texto (padrão), tar)
-I, --startpos=LSN onde o fluxo deve iniciar na entrada existente
-P, --plugin=PLUGIN utiliza o plugin de saída PLUGIN (padrão: %s)
-P, --progress mostra informação de progresso
-R, --write-recovery-conf
escreve recovery.conf para replicação
-S, --slot=NOME nome da entrada de replicação lógica
-S, --slot=NOME entrada de replicação a ser utilizada
-T, --tablespace-mapping=DIRANTIGO=DIRNOVO
realoca tablespace de DIRANTIGO para DIRNOVO
-U, --username=NOME conecta como usuário do banco de dados especificado
-V, --version mostra informação sobre a versão e termina
-W, --password pergunta senha (pode ocorrer automaticamente)
-X, --xlog-method=fetch|stream
inclui os arquivos do WAL requeridos na cópia de segurança
-Z, --compress=0-9 comprime saída do tar com o nível de compressão informado
-c, --checkpoint=fast|spread
define ponto de controle rápido ou distribuído
-d, --dbname=TEXTO cadeia de caracteres de conexão
-d, --dbname=NOMEBD banco de dados ao qual quer se conectar
-f, --file=ARQUIVO recebe log neste arquivo, - para saída padrão
-h, --host=MÁQUINA máquina do servidor de banco de dados ou diretório do soquete
-l, --label=RÓTULO define rótulo da cópia de segurança
-n, --no-loop não tentar novamente ao perder a conexão
-o, --option=NOME[=VALOR]
passa opção NOME com valor opcional VALOR para o
plugin de saída
-p, --port=PORTA número da porta do servidor de banco de dados
-r, --max-rate=TAXA taxa de transferência máxima para enviar diretório de dados
(em kB/s ou utilize sufixo "k" ou "M")
-s, --status-interval=INTERVALO
tempo entre envio de pacotes de status ao servidor (em segundos)
-s, --status-interval=INTERVALO
tempo entre envio de pacotes de status ao servidor (padrâo: %d)
-v, --verbose mostra mensagens de detalhe
-w, --no-password nunca pergunta senha
-x, --xlog inclui os arquivos do WAL requeridos na cópia de segurança (modo busca)
-z, --gzip comprime saída do tar
%*s/%s kB (%d%%), %d/%d tablespace %*s/%s kB (%d%%), %d/%d tablespaces %*s/%s kB (%d%%), %d/%d tablespace (%s%-*.*s) %*s/%s kB (%d%%), %d/%d tablespaces (%s%-*.*s) %*s/%s kB (100%%), %d/%d tablespace %*s %*s/%s kB (100%%), %d/%d tablespaces %*s %s controla fluxos de replicação lógica do PostgreSQL.
%s recebe fluxo de logs de transação do PostgreSQL.
%s faz uma cópia de segurança base de um servidor PostgreSQL em execução.
%s: %s precisa que uma entrada seja especificada utilizando --slot
%s: fluxo do COPY terminou antes que o último arquivo estivesse completo
%s: envio do WAL só pode ser utilizado no modo plain
%s: pelo menos uma ação precisa ser especificada
%s: só pode escrever uma tablespace para saída padrão, banco de dados tem %d
%s: não pode especificar ambas opções --xlog e --xlog-method
%s: não pode utilizar --create-slot ou --drop-slot junto com --startpos
%s: não pode utilizar --create-slot ou --start junto com --drop-slot
%s: não pode utilizar --create-slot junto com --drop-slot
%s: ponto de controle concluído
%s: processo filho %d morreu, esperado %d
%s: processo filho não terminou normalmente
%s: processo filho terminou com código de saída %d
%s: thread filho terminou com erro %u
%s: confirmando escrita até %X/%X, escrita no disco até %X/%X (entrada %s)
%s: não pôde acessar diretório "%s": %s
%s: não pôde fechar arquivo comprimido "%s": %s
%s: não pôde fechar diretório "%s": %s
%s: não pôde fechar arquivo "%s": %s
%s: não pôde se conectar ao servidor
%s: não pôde se conectar ao servidor: %s %s: não pôde criar arquivo de status do arquivador "%s": %s
%s: não pôde criar processo em segundo plano: %s
%s: não pôde criar thread em segundo plano: %s
%s: não pôde criar arquivo comprimido "%s": %s
%s: não pôde criar diretório "%s": %s
%s: não pôde criar arquivo "%s": %s
%s: não pôde criar pipe para processo em segundo plano: %s
%s: não pôde criar entrada de replicação "%s": recebeu %d registros e %d campos, esperado %d registros e %d campos
%s: não pôde criar link simbólico "%s": %s
%s: não pôde criar link simbólico de "%s" para "%s": %s
%s: não pôde criar arquivo de histórico da linha do tempo "%s": %s
%s: não pôde determinar posição de busca no arquivo "%s": %s
%s: não pôde determinar valor do parâmetro integer_datetimes do servidor
%s: não pôde remover entrada de replicação "%s": recebeu %d registros e %d campos, esperado %d registros e %d campos
%s: não pôde estabelecer conexão de replicação a um banco de dados específico
%s: não pôde executar fsync no arquivo "%s": %s
%s: não pôde executar fsync no arquivo de log "%s": %s
%s: não pôde obter fluxo de dados do COPY: %s %s: não pôde obter cabeçalho da cópia de segurança: %s %s: não pôde obter status de saída de thread filho: %s
%s: não pôde obter posição final do log de transação do servidor: %s %s: não pôde identificar sistema: recebeu %d registros e %d campos, esperado %d registros e %d ou mais campos
%s: não pôde inicializar cópia de segurança base: %s %s: não pôde abrir diretório "%s": %s
%s: não pôde abrir arquivo de log "%s": %s
%s: não pôde abrir arquivo de histórico da linha do tempo "%s": %s
%s: não pôde abrir arquivo de log de transação "%s": %s
%s: não pôde preencher arquivo de log de transação "%s": %s
%s: não pôde validar ponto de partida da próxima linha do tempo "%s"
%s: não pôde validar posição inicial "%s"
%s: não pôde validar local do log de transação "%s"
%s: não pôde ler dados do COPY: %s %s: não pôde ler diretório "%s": %s
%s: não pôde ler do pipe: %s
%s: não pôde receber dados do fluxo do WAL: %s %s: não pôde renomear arquivo "%s" para "%s": %s
%s: não pôde renomear arquivo "%s": %s
%s: não pôde buscar início do arquivo de log de transação "%s": %s
%s: não pôde enviar comando para pipe em segundo plano: %s
%s: não pôde enviar pacote indicando fim de cópia: %s %s: não pôde enviar pacote de retorno: %s %s: não pôde enviar comando de replicação "%s": %s %s: não pôde definir nível de compressão %d: %s
%s: não pôde definir permissões no diretório "%s": %s
%s: não pôde definir permissões no arquivo "%s": %s
%s: não pôde executar stat no arquivo "%s": %s
%s: não pôde executar stat no arquivo de log de transação "%s": %s
%s: não pôde esperar por processo filho: %s
%s: não pôde esperar por thread filho: %s
%s: não pôde escrever %u bytes no arquivo do WAL "%s": %s
%s: não pôde escrever %u bytes no arquivo de log "%s": %s
%s: não pôde escrever no arquivo de histórico da linha do tempo "%s": %s
%s: não pôde escrever no arquivo comprimido "%s": %s
%s: não pôde escrever no arquivo "%s": %s
%s: criando entrada de replicação "%s"
%s: diretório "%s" existe mas não está vazio
%s: nome de diretório é muito longo
%s: desconectado
%s: desconectado; esperando %d segundos para tentar novamente
%s: removendo entrada de replicação "%s"
%s: recepção final falhou: %s %s: terminou o segmento em %X/%X (linha do tempo %u)
%s: recebeu dados do WAL da posição %08x, esperada %08x
%s: versão do servidor %s é incompatível
%s: versão do servidor %s é incompatível; cliente não suporta fluxo de versões do servidor mais novas do que %s
%s: versão do servidor %s é incompatível; cliente não suporta fluxo de versões do servidor mais antigas do que %s
%s: iniciando cópia de segurança base, esperando concluir o ponto de controle
%s: opção de compilação integer_datetimes não corresponde com a do servidor
%s: unidade de --max-rate é inválida: "%s"
%s: argumento de ponto de controle "%s" é inválido, deve ser "fast" ou "spread"
%s: nível de compressão "%s" é inválido
%s: intervalo de fsync "%s" é inválido
%s: formato de saída "%s" é inválido, deve ser "plain" ou "tar"
%s: número de porta inválido: "%s"
%s: soquete inválido: %s %s: intervalo do status "%s" é inválido
%s: formato de mapeamento de tablespace "%s" é inválido, deve ser "DIRANTIGO=DIRNOVO"
%s: tamanho do cabeçalho do bloco tar é inválido: %d
%s: taxa de transferência "%s" é inválida: %s
%s: opção de xlog-method "%s" é inválida, deve ser "fetch" ou "stream"
%s: múltiplos sinais "=" em mapeamento de tablespace
%s: diretório novo não é um caminho absoluto no mapeamento de tablespace: %s
%s: nenhum dado foi retornado do servidor
%s: nenhum banco de dados especificado
%s: nenhuma entrada especificada
%s: nenhum diretório de destino foi especificado
%s: nenhum arquivo de destino foi especificado
%s: nenhuma posição final do log de transação foi retornada do servidor
%s: não renomeará "%s%s", segmento não está completo
%s: diretório antigo não é um caminho absoluto no mapeamento de tablespace: %s
%s: somente cópias de segurança com modo tar podem ser comprimidas
%s: sem memória
%s: recebeu sinal de interrupção, terminando
%s: recebeu registro do log de transação para posição %u sem um arquivo aberto
%s: conexão de replicação utilizando entrada "%s" é inesperadamente específica a um banco de dados
%s: entradas de replicação só podem ser utilizadas com envio do WAL
%s: fluxo de replicação foi terminado antes do ponto de parada
%s: arquivo de segmento "%s" tem tamanho incorreto %d, ignorando
%s: select() falhou: %s
%s: servidor relatou nome de arquivo de histórico inesperado para linha do tempo %u: %s
%s: servidor relatou próxima linha do tempo %u inesperada, seguindo linha do tempo %u
%s: servidor retornou resposta inesperada para comando BASE_BACKUP; recebeu %d registros e %d campos, esperado %d registros e %d campos
%s: servidor parou de enviar linha do tempo %u em %X/%X, mas relatou próxima linha do tempo %u começando em %X/%X
%s: iniciando receptor do WAL em segundo plano
%s: iniciando fluxo de log em %X/%X (entrada %s)
%s: iniciando fluxo de log em %X/%X (linha do tempo %u)
%s: linha do tempo inicial %u não está presente no servidor
%s: cabeçalho de fluxo muito pequeno: %d
%s: fluxo iniciado
%s: passou para linha do tempo %u em %X/%X
%s: links simbólicos não são suportados nessa plataforma
%s: identificador do sistema não corresponde entre cópia base e conexão de envio do WAL
%s: esse programa binário não suporta compressão
%s: muitos argumentos de linha de comando (primeiro é "%s")
%s: diretório do log de transação só pode ser especificado no modo plain
%s: diretório do log de transação deve ter um caminho absoluto
%s: arquivo de log de transação "%s" tem %d bytes, deveria ser 0 ou %d
%s: taxa de transferência "%s" excede intervalo de inteiros
%s: taxa de transferência "%s" não é um valor válido
%s: taxa de transferência "%s" está fora do intervalo
%s: taxa de transferência deve ser maior do que zero
%s: resposta inesperada para comando TIMELINE_HISTORY: recebeu %d registros e %d campos, esperado %d registros e %d campos
%s: conjunto de resultados inesperado após fim da linha do tempo: recebeu %d registros e %d campos, esperado %d registros e %d campos
%s: término inesperado do fluxo de replicação: %s %s: indicador de link "%c" desconhecido
%s: cabeçalho de fluxo desconhecido: "%c"
%s: esperando processo em segundo plano terminar o envio ...
Senha: Tente "%s --help" para obter informações adicionais.
Uso:
não pode duplicar ponteiro nulo (erro interno)
sem memória
ponto de início do log de transação: %s na linha do tempo %u
locale/pt_BR/LC_MESSAGES/pg_config-9.6.mo 0000644 00000014007 14751153421 0013405 0 ustar 00 �� * l ; � � E � 0 � : 3 E n I � L � s K K � = B I i � G � J > M � M � ? % G e > � 6 � < # > ` F � P � I 7
4 �
2 �
* �
. , 8 & e � & � � ( � ! B V c � u C 3 O � 6 � W � [ & ^ � � � ] g D � I
s T L � \ _ r _ � < 2 Y o Y � < # = ` G � M � Z 4 O � 7 � 4 % L r
� , � 7 � � ) , / + \ � # � � � � % * ) $
" '
& ( ! #
%s provides information about the installed version of PostgreSQL.
With no arguments, all known items are shown.
%s [OPTION]...
--bindir show location of user executables
--cc show CC value used when PostgreSQL was built
--cflags show CFLAGS value used when PostgreSQL was built
--cflags_sl show CFLAGS_SL value used when PostgreSQL was built
--configure show options given to "configure" script when
PostgreSQL was built
--cppflags show CPPFLAGS value used when PostgreSQL was built
--docdir show location of documentation files
--htmldir show location of HTML documentation files
--includedir show location of C header files of the client
interfaces
--includedir-server show location of C header files for the server
--ldflags show LDFLAGS value used when PostgreSQL was built
--ldflags_ex show LDFLAGS_EX value used when PostgreSQL was built
--ldflags_sl show LDFLAGS_SL value used when PostgreSQL was built
--libdir show location of object code libraries
--libs show LIBS value used when PostgreSQL was built
--localedir show location of locale support files
--mandir show location of manual pages
--pgxs show location of extension makefile
--pkgincludedir show location of other C header files
--pkglibdir show location of dynamically loadable modules
--sharedir show location of architecture-independent support files
--sysconfdir show location of system-wide configuration files
--version show the PostgreSQL version
-?, --help show this help, then exit
%s: could not find own program executable
%s: invalid argument: %s
Options:
Report bugs to <pgsql-bugs@postgresql.org>.
Try "%s --help" for more information.
Usage:
could not change directory to "%s": %s could not find a "%s" to execute could not identify current directory: %s could not read binary "%s" could not read symbolic link "%s" invalid binary "%s" not recorded pclose failed: %s Project-Id-Version: PostgreSQL 9.6
Report-Msgid-Bugs-To: pgsql-bugs@postgresql.org
POT-Creation-Date: 2016-08-09 22:53-0300
PO-Revision-Date: 2005-10-04 22:15-0300
Last-Translator: Euler Taveira de Oliveira <euler@timbira.com>
Language-Team: Brazilian Portuguese <pgbr-dev@listas.postgresql.org.br>
Language: pt_BR
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
%s fornece informação sobre a versão do PostgreSQL instalada.
Sem argumentos, todos os itens serão mostrados.
%s [OPÇÃO]...
--bindir mostra local dos executáveis
--cc mostra valor de CC utilizado quando PostgreSQL foi construído
--cflags mostra valor de CFLAGS utilizado quando PostgreSQL foi construído
--cflags_sl mostra valor de CFLAGS_SL utilizado quando PostgreSQL foi construído
--configure mostra opções informadas ao script "configure" quando
o PostgreSQL foi construído
--cppflags mostra valor de CPPFLAGS utilizado quando PostgreSQL foi construído
--docdir mostra local dos arquivos da documentação
--htmldir mostra local dos arquivos HTML da documentação
--includedir mostra local dos arquivos de cabeçalho das interfaces
com cliente
--includedir-server mostra local dos arquivos de cabeçalho do servidor
--ldflags mostra valor de LDFLAGS utilizado quando PostgreSQL foi construído
--ldflags_ex mostra valor de LDFLAGS_EX utilizado quando PostgreSQL foi construído
--ldflags_sl mostra valor de LDFLAGS_SL utilizado quando PostgreSQL foi construído
--libdir mostra local das bibliotecas objeto
--libs mostra valor de LIBS utilizado quando PostgreSQL foi construído
--localedir mostra local dos arquivos de suporte a configurações regionais
--mandir mostra local das páginas de manual
--pgxs mostra local do makefile extensível
--pkgincludedir mostra local dos outros arquivos de cabeçalho
--pkglibdir mostra local dos módulos carregáveis dinamicamente
--sharedir mostra local dos arquivos de suporte independentes de arquitetura
--sysconfdir mostra local dos arquivos de configuração do sistema
--version mostra a versão do PostgreSQL
-?, --help mostra essa ajuda e termina
%s: não pôde encontrar executável
%s: argumento inválido: %s
Opções:
Relate erros a <pgsql-bugs@postgresql.org>.
Tente "%s --help" para obter informações adicionais.
Uso:
não pôde mudar diretório para "%s": %s não pôde encontrar o "%s" para executá-lo não pôde identificar diretório atual: %s não pôde ler o binário "%s" não pôde ler link simbólico "%s" binário "%s" é inválido não informado pclose falhou: %s locale/pt_BR/LC_MESSAGES/ecpglib6-9.6.mo 0000644 00000007176 14751153421 0013156 0 ustar 00 �� ! $ / , � � � � ) ' - Q : 0 � $ � ( 9 L * c ; � > � 3 < = & z 1 � � + � ' @ % Y � , � � 2 0 ; / l � � 1 ; C H
` % n 8 � J � 4
. M
8 |
�
�
) �
> L H D � T � - / D ] " � 0 � $ �
# 4
X
v
2 �
' �
/ �
0 - P
! <DEFAULT> <empty> NULL SQL error %d on line %d SQL error: %s
connection "%s" does not exist on line %d could not connect to database "%s" on line %d could not convert boolean value: size mismatch, on line %d data read from server is not an array on line %d descriptor "%s" not found on line %d descriptor index out of range on line %d empty message text empty query on line %d error in transaction processing on line %d inserting an array of variables is not supported on line %d invalid input syntax for floating-point type: "%s", on line %d invalid input syntax for type int: "%s", on line %d invalid input syntax for type unsigned int: "%s", on line %d invalid statement name "%s" on line %d invalid syntax for type boolean: "%s", on line %d no data found on line %d not connected to connection "%s" on line %d null value without indicator on line %d out of memory on line %d the connection to the server was lost too few arguments on line %d too many arguments on line %d unrecognized descriptor item "%s" on line %d unsupported type "%s" on line %d variable does not have a character type on line %d variable does not have a numeric type on line %d variable does not have an array type on line %d Project-Id-Version: PostgreSQL 9.5
Report-Msgid-Bugs-To: pgsql-bugs@postgresql.org
POT-Creation-Date: 2015-09-17 22:32-0300
PO-Revision-Date: 2009-02-09 13:00-0200
Last-Translator: Fernando Ike de Oliveira <fike@midstorm.org>
Language-Team: Brazilian Portuguese <pgbr-dev@listas.postgresql.org.br>
Language: pt_BR
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
<PADRÃO> <vazio> NULL Erro SQL %d na linha %d Erro SQL: %s
conexão "%s" não existe na linha %d não pôde connectar ao banco de dados "%s" na linha %d não pôde converter valor booleano: tamanho não corresponde, na linha %d dado lido do servidor não é uma matriz na linha %d descritor "%s" não foi encontrado na linha %d índice do descritor está fora do intervalo na linha %d mensagem vazia consulta vazia na linha %d erro ao processar transação na linha %d inserir uma matriz de variáveis não é suportado na linha %d sintaxe de entrada é inválida para tipo ponto flutuante: "%s", na linha %d sintaxe de entrada é inválida para tipo inteiro: "%s", na linha %d sintaxe de entrada é inválida para tipo inteiro não-sinalizado: "%s", na linha %d nome de comando "%s" é inválido na linha %d sintaxe de entrada é inválida par tipo booleano: "%s", na linha %d nenhum dado encontrado na linha %d não está conectado a conexão "%s" na linha %d valor nulo sem indicador na linha %d sem memória na linha %d a conexão com servidor foi perdida poucos argumentos na linha %d muitos argumentos na linha %d item do descritor "%s" é desconhecido na linha %d tipo "%s" não é suportado na linha %d variável não tem um tipo caracter na linha %d variável não tem um tipo numérico na linha %d variável não tem um tipo matriz na linha %d locale/ro/LC_MESSAGES/pg_config-9.6.mo 0000644 00000015044 14751153421 0013021 0 ustar 00 �� . � = � � E � 0 7 h : { E � I � L F s � K = S 2 � B � i G q J � M M R ? � G � > ( 6 g < � > � F
P a
I �
4 �
* 1 \ v , � & � � & � 0 . 4 ) c ) � " � � ( � $
! ?
a
u
� �
H 7 : � � D � R V h Y � � X � ; � < 8 @ u Z � O W a Z � Z H o T � T
@ b Q � I � L ? ^ � _ � 8 K 4 � �
� 3 � 6 J ! V 1 x . � + � + ) 1 ) [ . � � , � � # - . ( ,
)
! % $ & ' + " *
%s provides information about the installed version of PostgreSQL.
With no arguments, all known items are shown.
%s [OPTION]...
--bindir show location of user executables
--cc show CC value used when PostgreSQL was built
--cflags show CFLAGS value used when PostgreSQL was built
--cflags_sl show CFLAGS_SL value used when PostgreSQL was built
--configure show options given to "configure" script when
PostgreSQL was built
--cppflags show CPPFLAGS value used when PostgreSQL was built
--docdir show location of documentation files
--help show this help, then exit
--htmldir show location of HTML documentation files
--includedir show location of C header files of the client
interfaces
--includedir-server show location of C header files for the server
--ldflags show LDFLAGS value used when PostgreSQL was built
--ldflags_ex show LDFLAGS_EX value used when PostgreSQL was built
--ldflags_sl show LDFLAGS_SL value used when PostgreSQL was built
--libdir show location of object code libraries
--libs show LIBS value used when PostgreSQL was built
--localedir show location of locale support files
--mandir show location of manual pages
--pgxs show location of extension makefile
--pkgincludedir show location of other C header files
--pkglibdir show location of dynamically loadable modules
--sharedir show location of architecture-independent support files
--sysconfdir show location of system-wide configuration files
--version show the PostgreSQL version
%s: could not find own program executable
%s: invalid argument: %s
Options:
Report bugs to <pgsql-bugs@postgresql.org>.
Try "%s --help" for more information.
Usage:
child process exited with exit code %d child process exited with unrecognized status %d child process was terminated by exception 0x%X child process was terminated by signal %d child process was terminated by signal %s could not change directory to "%s" could not find a "%s" to execute could not identify current directory: %s could not read binary "%s" could not read symbolic link "%s" invalid binary "%s" not recorded
Project-Id-Version: pg_config-ro
Report-Msgid-Bugs-To: pgsql-bugs@postgresql.org
POT-Creation-Date: 2010-09-02 18:00+0000
PO-Revision-Date: 2013-09-05 23:01-0400
Last-Translator: Max <max@oceanline.co.uk>
Language-Team: Română <max@oceanline.co.uk>
Language: ro
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
X-Generator: KBabel 1.11.2
X-Poedit-Language: Romanian
X-Poedit-Country: ROMANIA
%s: furnizează informaţii despre versiunea de PostgreSQL instalată
Fără argumente, afişează toate elementele cunoscute
%s [OPȚIUNE]...
--bindir afişează locaţia fişierelor executabile
--cc afişează valoarea CC folosită la compilarea PostgreSQL
--cflags afişează valoarea CFLAGS folosită la compilarea PostgreSQL
--cflags_sl afişează valoarea CFLAGS_SL folosită la compilarea PostgreSQL
--configure afişează opţiunile cu care a fost rulat scriptul "configure"
la compilarea PostgreSQL
--cppflags afişează valoarea CPPFLAGS folosită la compilarea PostgreSQL
--docdir afişează locaţia documentaţiei
--help afişează acest ajutor, apoi iese
--docdir afişează locaţia documentaţiei HTML
--includedir afişează locaţia fişierelor header C ale interfeţelor client
--includedir-server afişează locaţia fişierelor header C pentru server
--ldflags afişează valoarea LDFLAGS folosită la compilarea PostgreSQL
--ldflags_sl afişează valoarea LDFLAGS_SL folosită la compilarea PostgreSQL
--ldflags_sl afişează valoarea LDFLAGS_SL folosită la compilarea PostgreSQL
--libdir afişează locaţia bibliotecilor de cod obiect
--libs afişează valoarea LIBS folosită la compilarea PostgreSQL
--localedir afişează locaţia fişierelor de suport pentru localizare
--mandir afişează locaţia paginilor de manual
--pgxs afişează locaţia fişierului makefile pentru extensii
--pkgincludedir afişează locaţia celorlalte fişiere header C
--pkglibdir afişează locaţia modulelor încărcabile dinamic
--sharedir afişează locaţia fişierelor de suport independent de arhitectură
--sysconfdir afişează locaţia fişierelor de configurare pentru întreg sistemul
--version afişează versiunea PostgreSQL
%s: imposibil de găsit propriul program executabil
%s: argument incorect: %s
Opţiuni:
Raportaţi erorile la <pgsql-bugs@postgresql.org>.
Încercaţi "%s --help" pentru mai multe informaţii.
Utilizare:
procesul fiu a ieşit cu codul %d procesul fiu a ieşit cu starea nerecunoscută %d procesul fiu a fost terminat cu excepția 0x%X procesul fiu a fost terminat cu semnalul %d procesul fiu a fost terminat cu semnalul %s imposibil de schimbat directorul în "%s" imposibil de găsit "%s" pentru executare imposibil de identificat directorul curent: %s imposibil de citit binar "%s" imposibil de citit legătura simbolică "%s" binar incorect "%s" ne-înregistrat
locale/it/LC_MESSAGES/pgscripts-9.6.mo 0000644 00000064643 14751153421 0013111 0 ustar 00 �� � | � 0 K 1 }
� > � > � = - Z � � C A d � � # � � ( 9 I V E � � > f ; � = � : < Z 9 � 6 � 5 C > C � 9 � 4 E 5 = { . � ; � E $ : j ? � A � < ' 9 d 7 � 4 � L J X 3 � H � E B f A � 5 � 2 ! N T 7 � 2 � 2 J A : � 5 � G � 0 E < v 0 � ) � M J \ G � 4 � C $! H h! E �! D �! = <" v z" < �" � .# Q �# I $ @ N$ 5 �$ 4 �$ 1 �$ 0 ,% ; ]% 5 �% ' �% 6 �% 3 .& 4 b& @ �& ; �& ; ' ` P' 8 �' 2 �' 9 ( 6 W( > �( �( / �( < ) # F) # j) ? �) 8 �) % * # -* Q* 3 q* & �* �* E �* 6 + E P+ F �+ K �+ 7 ), K a, 7 �, J �, 6 0- < g- D �- 5 �- . * =. 8 h. 6 �. ( �. 4 / $ 6/ # [/ / �/ 8 �/ 4 �/ $ .0 S0 , s0 , �0 ( �0 / �0 ; &1 9 b1 ! �1 �1 \ �1 02 C2 * a2 8 �2 9 �2 , �2 8 ,3 # e3 4 �3 3 �3 �3 ) 4 7 94 q4
�4 �4 C �4 A �4 ! /5 + Q5 }5 �5 �5 �5 . �5 3 6 2 H6 {6 �6 �6
�6 �6 �6 �6 ' 7 " (7 2 K7 7 ~7 �7 & �7 �7 �7 / 8 + 58 * a8 �8 �8 �8 �8 �8 �8 �8 �8 ( �8 9 9 � 9 b ; q;
�; L �; L �; K 0< = |< � �< G T= E �= �= �= + > ;> ) W> �> K �> H �> � 6? D �? A @ B K@ > �@ > �@ ; A 8 HA 7 �A L �A F B 5 MB 7 �B z �B ; 6C C rC = �C O �C @ DD I �D L �D D E ; aE D �E I �E n ,F q �F ;
G M IG J �G G �G F *H B qH ? �H N �H ; CI 7 I : �I \ �I @ OJ 5 �J G �J 4 K E CK 7 �K ) �K E �K N 1L ? �L > �L H �L K HM H �M G �M ? %N ~ eN O �N � 4O � �O Q XP K �P M �P 9 DQ 6 ~Q 5 �Q ? �Q 9 +R 2 eR = �R : �R @ S I RS B �S E �S f %T 8 �T 6 �T ? �T < <U N yU �U 0 �U K V ! QV $ sV B �V E �V ) !W $ KW ! pW 6 �W + �W �W X �W I UX [ �X c �X b _Y K �Y X Z C gZ c �Z L [ J \[ l �[ V \ k\ 0 �\ C �\ D ] * E] 9 p] 1 �] ) �] & ^ % -^ < S^ ; �^ , �^ + �^ 4 %_ 7 Z_ 1 �_ 7 �_ A �_ ? >` ' ~` �` m �` *a ( @a 9 ia J �a D �a @ 3b L tb + �b > �b 7 ,c dc / �c B �c �c
d " d e <d c �d 1 e 2 8e ke + e * �e * �e > f = @f = ~f �f �f �f
�f �f g 6g / Lg ) |g $ �g ' �g �g - �g
-h 8h : Wh ' �h 1 �h �h �h �h i i 'i Fi Si 5 gi �i �i � � 9 � � t � � � I S � w & % � � � � G � � - . � � X � { � " � 7 � o � � < � � � L � 4 / K i u � J � ~ B m ( � � � * �
n f H p � # D g @ ' > � � U � v � x [ � 3
N � � k ! � 8 , � Y F ; � � z � � Z � T � � 6 r M � + a 2 W � � $ ] _ � � } = s � j � � ? � ` � c | � l \ V � � � � � E ) : q � � Q C b 1 0 h A y � d R ^ O � � � � � � 5 � � � e P
By default, a database with the same name as the current user is created.
Connection options:
Options:
Read the description of the SQL command CLUSTER for details.
Read the description of the SQL command REINDEX for details.
Read the description of the SQL command VACUUM for details.
Report bugs to <pgsql-bugs@postgresql.org>.
--analyze-in-stages only update optimizer statistics, in multiple
stages for faster results; no vacuum
--lc-collate=LOCALE LC_COLLATE setting for the database
--lc-ctype=LOCALE LC_CTYPE setting for the database
%s [OPTION]...
%s [OPTION]... DBNAME
%s [OPTION]... LANGNAME [DBNAME]
%s [OPTION]... [DBNAME]
%s [OPTION]... [DBNAME] [DESCRIPTION]
%s [OPTION]... [ROLENAME]
--if-exists don't report error if database doesn't exist
--if-exists don't report error if user doesn't exist
--interactive prompt for missing role name and attributes rather
than using defaults
--maintenance-db=DBNAME alternate maintenance database
--maintenance-db=DBNAME alternate maintenance database
--no-replication role cannot initiate replication
--replication role can initiate replication
-?, --help show this help, then exit
-?, --help show this help, then exit
-?, --help show this help, then exit
-?, --help show this help, then exit
-D, --no-createdb role cannot create databases (default)
-D, --tablespace=TABLESPACE default tablespace for the database
-E, --encoding=ENCODING encoding for the database
-E, --encrypted encrypt stored password
-F, --freeze freeze row transaction information
-I, --no-inherit role does not inherit privileges
-L, --no-login role cannot login
-N, --unencrypted do not encrypt stored password
-O, --owner=OWNER database user to own the new database
-P, --pwprompt assign a password to new role
-R, --no-createrole role cannot create roles (default)
-S, --no-superuser role will not be superuser (default)
-S, --schema=SCHEMA reindex specific schema(s) only
-T, --template=TEMPLATE template database to copy
-U, --username=USERNAME user name to connect as
-U, --username=USERNAME user name to connect as
-U, --username=USERNAME user name to connect as (not the one to create)
-U, --username=USERNAME user name to connect as (not the one to drop)
-U, --username=USERNAME user name to connect as
-V, --version output version information, then exit
-V, --version output version information, then exit
-V, --version output version information, then exit
-V, --version output version information, then exit
-W, --password force password prompt
-W, --password force password prompt
-Z, --analyze-only only update optimizer statistics; no vacuum
-a, --all vacuum all databases
-a, --all cluster all databases
-a, --all reindex all databases
-c, --connection-limit=N connection limit for role (default: no limit)
-d, --createdb role can create new databases
-d, --dbname=DBNAME database to vacuum
-d, --dbname=DBNAME database from which to remove the language
-d, --dbname=DBNAME database to cluster
-d, --dbname=DBNAME database to install language in
-d, --dbname=DBNAME database to reindex
-d, --dbname=DBNAME database name
-e, --echo show the commands being sent to the server
-e, --echo show the commands being sent to the server
-e, --echo show the commands being sent to the server
-f, --full do full vacuuming
-g, --role=ROLE new role will be a member of this role
-h, --host=HOSTNAME database server host or socket directory
-h, --host=HOSTNAME database server host or socket directory
-h, --host=HOSTNAME database server host or socket directory
-i, --index=INDEX recreate specific index(es) only
-i, --inherit role inherits privileges of roles it is a
member of (default)
-i, --interactive prompt before deleting anything
-i, --interactive prompt before deleting anything, and prompt for
role name if not specified
-j, --jobs=NUM use this many concurrent connections to vacuum
-l, --list show a list of currently installed languages
-l, --locale=LOCALE locale settings for the database
-l, --login role can login (default)
-p, --port=PORT database server port
-p, --port=PORT database server port
-p, --port=PORT database server port
-q, --quiet don't write any messages
-q, --quiet don't write any messages
-q, --quiet run quietly
-r, --createrole role can create new roles
-s, --superuser role will be superuser
-s, --system reindex system catalogs
-t, --table='TABLE[(COLUMNS)]' vacuum specific table(s) only
-t, --table=TABLE cluster specific table(s) only
-t, --table=TABLE reindex specific table(s) only
-t, --timeout=SECS seconds to wait when attempting connection, 0 disables (default: %s)
-v, --verbose write a lot of output
-v, --verbose write a lot of output
-w, --no-password never prompt for password
-w, --no-password never prompt for password
-z, --analyze update optimizer statistics
%s (%s/%s) %s cleans and analyzes a PostgreSQL database.
%s clusters all previously clustered tables in a database.
%s creates a PostgreSQL database.
%s creates a new PostgreSQL role.
%s installs a procedural language into a PostgreSQL database.
%s issues a connection check to a PostgreSQL database.
%s reindexes a PostgreSQL database.
%s removes a PostgreSQL database.
%s removes a PostgreSQL role.
%s removes a procedural language from a database.
%s: "%s" is not a valid encoding name
%s: %s %s: cannot cluster all databases and a specific one at the same time
%s: cannot cluster specific table(s) in all databases
%s: cannot reindex all databases and a specific one at the same time
%s: cannot reindex all databases and system catalogs at the same time
%s: cannot reindex specific index(es) and system catalogs at the same time
%s: cannot reindex specific index(es) in all databases
%s: cannot reindex specific schema(s) and system catalogs at the same time
%s: cannot reindex specific schema(s) in all databases
%s: cannot reindex specific table(s) and system catalogs at the same time
%s: cannot reindex specific table(s) in all databases
%s: cannot use the "%s" option when performing only analyze
%s: cannot vacuum all databases and a specific one at the same time
%s: cannot vacuum specific table(s) in all databases
%s: clustering database "%s"
%s: clustering of database "%s" failed: %s %s: clustering of table "%s" in database "%s" failed: %s %s: comment creation failed (database was created): %s %s: could not connect to database %s: %s %s: could not connect to database %s: out of memory
%s: could not fetch default options
%s: creation of new role failed: %s %s: database creation failed: %s %s: database removal failed: %s %s: language "%s" is already installed in database "%s"
%s: language "%s" is not installed in database "%s"
%s: language installation failed: %s %s: language removal failed: %s %s: missing required argument database name
%s: missing required argument language name
%s: missing required argument role name
%s: number of parallel jobs must be at least 1
%s: only one of --locale and --lc-collate can be specified
%s: only one of --locale and --lc-ctype can be specified
%s: processing database "%s": %s
%s: query failed: %s %s: query returned %d row instead of one: %s
%s: query returned %d rows instead of one: %s
%s: query was: %s
%s: reindexing database "%s"
%s: reindexing of database "%s" failed: %s %s: reindexing of index "%s" in database "%s" failed: %s %s: reindexing of schema "%s" in database "%s" failed: %s %s: reindexing of system catalogs failed: %s %s: reindexing of table "%s" in database "%s" failed: %s %s: removal of role "%s" failed: %s %s: too many command-line arguments (first is "%s")
%s: too many parallel jobs requested (maximum: %d)
%s: vacuuming database "%s"
%s: vacuuming of database "%s" failed: %s %s: vacuuming of table "%s" in database "%s" failed: %s (%lu row) (%lu rows) Are you sure? Cancel request sent
Cannot add cell to table content: total cell count of %d exceeded.
Cannot add header to table content: column count of %d exceeded.
Could not send cancel request: %s Database "%s" will be permanently removed.
Enter it again: Enter name of role to add: Enter name of role to drop: Enter password for new role: Generating default (full) optimizer statistics Generating medium optimizer statistics (10 targets) Generating minimal optimizer statistics (1 target) Interrupted
Name Password encryption failed.
Password: Passwords didn't match.
Please answer "%s" or "%s".
Procedural Languages Role "%s" will be permanently removed.
Shall the new role be a superuser? Shall the new role be allowed to create databases? Shall the new role be allowed to create more new roles? Trusted? Try "%s --help" for more information.
Usage:
accepting connections
cannot duplicate null pointer (internal error)
could not look up effective user ID %ld: %s invalid output format (internal error): %d n no no attempt
no response
out of memory
rejecting connections
unknown
user does not exist user name lookup failure: error code %lu y yes Project-Id-Version: pgscripts (PostgreSQL) 9.6
Report-Msgid-Bugs-To: pgsql-bugs@postgresql.org
POT-Creation-Date: 2018-10-08 14:32+0000
PO-Revision-Date: 2018-10-08 21:19+0100
Last-Translator: Daniele Varrazzo <daniele.varrazzo@gmail.com>
Language-Team: https://github.com/dvarrazzo/postgresql-it
Language: it
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
X-Poedit-SourceCharset: utf-8
Plural-Forms: nplurals=2; plural=n != 1;
X-Generator: Poedit 2.0.6
Se il nome non è specificato verrà creato un database con lo stesso nome
dell'utente corrente.
Opzioni di connessione:
Opzioni:
Consulta la descrizione del comando SQL CLUSTER per maggiori informazioni.
Consulta la descrizione del comando SQL REINDEX per maggiori informazioni.
Consulta la descrizione del comando SQL VACUUM per maggiori informazioni.
Puoi segnalare eventuali bug a <pgsql-bugs@postgresql.org>.
--analyze-in-stages aggiorna solo le statistiche, in fasi multiple
per maggiore velocità, niente vacuum
--lc-collate=LOCALE impostazione LC_COLLATE per il database
--lc-ctype=LOCALE impostazione LC_CTYPE per il database
%s [OPZIONE]...
%s [OPZIONE]... NOMEDB
%s [OPZIONE]... NOME_LINGUAGGIO [NOMEDB]
%s [OPZIONE]... [NOMEDB]
%s [OPZIONE]... [NOMEDB] [DESCRIZIONE]
%s [OPZIONI]... [NOME_RUOLO]
--if-exists non riportare errori se il database non esiste
--if-exists non riportare errori se l'utente non esiste
--interactive richiedi i nomi ed attributi dei ruoli mancanti
invece di usare i valori predefiniti
--maintenance-db=NOMEDB database di manutenzione alternativo
--maintenance-db=NOMEDB database di manutenzione alternativo
--no-replication il ruolo non può avviare una replica
--replication il ruolo può avviare una replica
-?, --help mostra questo aiuto ed esci
-?, --help mostra questo aiuto ed esci
-?, --help mostra questo aiuto ed esci
-?, --help mostra questo aiuto ed esci
-D, --no-createdb il ruolo non può creare database (predefinito)
-D, --tablespace=TABLESPACE tablespace predefinito per il database
-E, --encoding=ENCODING codifica del database
-E, --encrypted cripta la password salvata
-F, --freeze congela le informazioni per la transazione
sulla riga
-I, --no-inherit il ruolo non eredita privilegi
-L, --no-login il ruolo non può accedere al database
-N, --unencrypted non criptare la password salvata
-O, --owner=OWNER utente database proprietario del nuovo database
-P, --pwprompt assegna una password al nuovo ruolo
-R, --no-createrole il ruolo non può creare ruoli (predefinito)
-S, --no-superuser il ruolo non sarà un superutente (predefinito)
-S, --schema=SCHEMA reindicizza solo gli schemi specificati
-T, --template=TEMPLATE modello database da copiare
-U, --username=USERNAME nome utente da usare per connettersi
-U, --username=UTENTE nome utente da utilizzare per la connessione
-U, --username=UTENTE nome utente con cui collegarsi
(non quello da creare)
-U, --username=UTENTE nome utente con cui collegarsi
(non quello da eliminare)
-U, --username=UTENTE nome utente con cui connettersi
-V, --version mostra informazioni sulla versione ed esci
-V, --version mostra informazioni sulla versione ed esci
-V, --version mostra informazioni sulla versione ed esci
-V, --version mostra informazioni sulla versione ed esci
-W, --password forza la richiesta di una password
-W, --password forza la richiesta di una password
-Z, --analyze-only aggiorna solo le statistiche; niente vacuum
-a, --all pulisci tutti i database
-a, --all raggruppa tutti i database
-a, --all re-indicizza tutti i database
-c, --connection-limit=N limite di connessione per un ruolo (predefinito: nessun limite)
-d, --createdb il ruolo può creare nuovi database
-d, --dbname=NOMEDB database da pulire
-d, --dbname=NOMEDB database dal quale eliminare il linguaggio
-d, --dbname=NOMEDB database da raggruppare
-d, --dbname=NOMEDB database in cui installare il linguaggio
-d, --dbname=NOMEDB database da re-indicizzare
-d, --dbname=NOMEDB nome database
-e, --echo mostra i comandi inviati al server
-e, --echo mostra i comandi che vengono inviati al server
-e, --echo mostra i comandi inviati al server
-f, --full esegui una pulizia completa
-g, --role=RUOLO il nuovo ruolo sarà membro di questo ruolo
-h, --host=HOSTNAME host del server database o directory socket
-h, --host=HOSTNAME host del server database o directory socket
-h, --host=NOMEHOST host server del database o directory socket
-i, --index=INDICE ricrea solo gli indici specificati
-i, --inherit il ruolo eredita i privilegi dei ruoli di cui
è membro (predefinito)
-i, --interactive chiedi conferma prima di cancellare qualunque cosa
-i, --interactive chiedi conferma prima cancellare qualunque cosa
e richiedi i nomi dei ruoli se non specificati
-j, --jobs=NUM usa questo numero di connessioni concorrenti
per effetturare il vacuum
-l, --list mostra la lista dei linguaggi attualmente installati
-l, --locale=LOCALE impostazioni di localizzazione del database
-l, --login il ruolo può accedere al database (predefinito)
-p, --port=PORT porta del server database
-p, --port=PORTA porta del server database
-p, --port=PORTA porta del server database
-q, --quiet non stampare alcun messaggio
-q, --quiet non stampare alcun messaggio
-q, --quiet esegui silenziosamente
-r, --createrole il ruolo può creare nuovi ruoli
-s, --superuser il ruolo sarà un superutente
-s, --system re-indicizza i cataloghi di sistema
-t, --table='TABELLA[(COLONNE)]' ripulisci solo le tabelle specificate
-t, --table=TABELLA raggruppa solo le tabelle specificate
-t, --table=TABELLA re-indicizza solo le tabelle specificate
-t, --timeout=SEC secondi di attesa tentando una connessione, 0 disabilita (predefinito: %s)
-v, --verbose mostra molti messaggi
-v, --verbose mostra un output completo
-w, --no-password non richiedere mai una password
-w, --no-password non richiedere mai una password
-z, --analyze aggiorna le statistiche per l'ottimizzatore
%s (%s/%s) %s pulisce ed analizza un database PostgreSQL.
%s raggruppa tutte le tabelle precedentemente raggruppate in un database.
%s crea un database PostgreSQL.
%s crea un nuovo ruolo PostgreSQL.
%s installa un linguaggio procedurale in un database PostgreSQL.
%s effettua una connessione di controllo ad un database PostgreSQL.
%s re-indicizza un database PostgreSQL.
%s elimina un database PostgreSQL.
%s elimina un ruolo PostgreSQL.
%s elimina un linguaggio procedurale da un database.
%s: "%s" non è un nome di codifica valido
%s: %s %s: non è possibile raggruppare tutti i database ed uno specifico nello stesso momento
%s: non è possibile raggruppare tabelle specificate in tutti i database
%s: non è possibile re-indicizzare tutti i database ed uno specifico nello stesso momento
%s: non è possibile re-indicizzare tutti i database e i cataloghi di sistema nello stesso momento
%s: non è possibile re-indicizzare indici specificati e cataloghi di sistema allo stesso momento
%s: non è possibile re-indicizzare indici specificati in tutti i database
%s: impossibile reindicizzare schemi specifici e cataloghi di sistema allo stesso tempo
%s: impossibile reindicizzare schemi specifici in tutti i database
%s: non è possibile re-indicizzare tabelle specificate e cataloghi di sistema allo stesso momento
%s: non è possibile re-indicizzare tabelle specificate in tutti i database
%s: non è possibile usare l'opzione "%s" quando si effettua solo analyze
%s: non è possibile effettuare la pulizia di tutti i database e di uno in particolare nello stesso momento
%s: non è possibile effettuare la pulizia di tabelle specificate in tutti i database
%s: riordino del database "%s"
%s: il riordino del database "%s" è fallito: %s %s: il riordino della tabella "%s" nel database "%s" è fallito: %s %s: creazione del commento fallita (il database è stato creato): %s %s: connessione al database %s fallita: %s %s: connessione al database %s fallita: memoria esaurita
%s: caricamento delle opzioni di default fallito
%s: creazione del nuovo ruolo fallita: %s %s: creazione del database fallita: %s %s: eliminazione database fallita: %s %s: il linguaggio "%s" è già installato nel database "%s"
%s: il linguaggio "%s" non è installato nel database "%s"
%s: installazione del linguaggio fallita: %s %s: eliminazione del linguaggio fallita: %s %s: parametro richiesto mancante: nome del database
%s: parametro mancante necessario: nome del linguaggio
%s: argomento richiesto mancante: nome del ruolo
%s: il numero dei lavori paralleli dev'essere almeno 1
%s: solo uno tra --locale e --lc-collate può essere specificato
%s: solo uno tra --locale e --lc-ctype può essere specificato
%s: elaborazione del database "%s": %s
%s: query fallita: %s %s: la query ha restituito %d righe invece di una: %s
%s: la query ha restituito %d righe invece di una: %s
%s: la query era: %s
%s: re-indicizzazione del database "%s"
%s: la re-indicizzazione del database "%s" è fallita: %s %s: la re-indicizzazione dell'indice "%s" nel database "%s" è fallita: %s %s: reindicizzamento dello schema "%s" nel database "%s" fallito: %s %s: la re-indicizzazione dei cataloghi di sistema è fallita: %s %s: la re-indicizzazione della tabella "%s" nel database "%s" è fallita: %s %s: eliminazione del ruolo "%s" fallita: %s %s: troppi argomenti nella riga di comando (il primo è "%s")
%s: troppi lavori in parallelo richiesti (massimo: %d)
%s: pulizia del database "%s"
%s: la pulizia del database "%s" è fallita: %s %s: la pulizia della tabella "%s" nel database "%s" è fallita: %s (%lu riga) (%lu righe) Sei sicuro? Richiesta di annullamento inviata
Impossibile aggiungere la cella al contenuto della tabella: il numero totale di celle è più di %d.
Impossibile aggiungere l'intestazione al contenuto della tabella: numero di colonne è più di %d.
Invio della richiesta di annullamento fallita: %s Il database "%s" sarà eliminato definitivamente.
Conferma password: Inserisci il nome del ruolo da aggiungere: Inserisci il nome del ruolo da eliminare: Inserisci la password per il nuovo ruolo: Generazione di statistiche ottimizzatore di default (completo) Generazione di statistiche ottimizzatore medie (10 obiettivi) Generazione di statistiche ottimizzatore minime (1 obiettivo) Interrotto
Nome Criptazione password fallita.
Password: Le password non corrispondono.
Prego rispondere "%s" o "%s".
Linguaggi Procedurali Il ruolo "%s" sarà eliminato definitivamente.
Il nuovo ruolo dev'essere un superutente? Il nuovo ruolo può creare database? Il nuovo ruolo può creare altri ruoli? Affidabile? Prova "%s --help" per maggiori informazioni.
Utilizzo:
le connessioni sono accettate
impossibile duplicare il puntatore nullo (errore interno)
ID utente effettivo %ld non trovato: %s formato di output non valido (errore interno): %d n no nessun tentativo
nessuna risposta
memoria esaurita
le connessioni sono rifiutate
sconosciuto
l'utente non esiste ricerca del nome utente fallita: codice di errore %lu s sì locale/it/LC_MESSAGES/initdb-9.6.mo 0000644 00000057160 14751153421 0012340 0 ustar 00 �� � , � <
�
R �
* 5 - F g t ` � � = W W X � A � 5 � J / z 6 � P � C : b Q � 5 � ] % 4 � B � H � G D > � 4 � 9 3 : ? n / � - � > y K ( � # � , - ? 7 m ( � 6 � , ' 2 5 Z F � " � < � & 7 - ^ - � ! � 1 � ? & N / u = � ! � " 6 ( + _ � 0 � ; � $ / 4 & d � $ � ~ � 1 M < � G � 3 " 8 V ( � J � � � � C � - C! 8 q! ! �! , �! �! J " / \" 4 �" A �" @ # R D# K �# " �# ! $ � ($ d �$ % $% � C% [ �% R #& K v& % �& �& ' ' ; 7' ; s' � �' @ @( ; �( �( u �) q D* f �* s + & �+ �+ ) �+ t �+ / _, �, & �, 0 �, . �, ) %- ) O- y- �- & �- # �- �- $ . ( 3. + \. " �. �. " �. ! �. , / $ 8/ * ]/ % �/ ! �/ �/ �/ 0 0 90 M0 Q0 `0 - r0 �0 & �0 % �0 3 1 ?1 Y1 ( m1 � �1 V �3 ) �3
4 4 = $4 d b4 s �4 � ;5 w :6 w �6 y *7 k �8 5 9 P F9 �9 8 �9 w �9 m e: 9 �: �
; C �; n �; > D< G �< J �< u = 9 �= = �= 9 > ; >> C z> 3 �> 9 �> N ,? � {? , @ % ?@ 3 e@ + �@ ; �@ / A = 1A 2 oA , �A 9 �A H B $ RB P wB . �B : �B < 2C ' oC > �C ? �C - D 5 DD J zD C �D - E = 7E - uE ' �E 9 �E N F + TF @ �F 2 �F �F ) G � ;G D �G B H aH R �H < �H < I , OI Z |I � �I �J ) �J q �J 6 EK K |K ( �K = �K /L e HL > �L > �L R ,M L M r �M _ ?N = �N : �N � O i �O P - .P � \P V �P \ 7Q K �Q " �Q R % #R IR C hR ? �R � �R @ S G �S * T s 3U � �U � 4V l �V - #W
QW / \W � �W : X NX . dX 4 �X + �X ' �X ' Y DY [Y , oY * �Y & �Y : �Y 4 )Z ' ^Z * �Z �Z ) �Z ' �Z 0 $[ ; U[ K �[ / �[ )
\ ! 7\ # Y\ 9 }\ �\ �\ �\ �\ = �\ ) 6] 8 `] , �] : �] $ ^ &^ 5 :^ � � 5 ( � Z � J l 6 H X � � K z � � � r I � � { � N d R V o | ~ � � . y U } � m � ` G = * f / $ � > _ � # A � t C 8 Y 0 T , � % + v L 3 � 2 n � � h B j E ? ] 9 ) ! & � � � q � � D S g
e ; ' ^ " F x c � w P [ s � @ i �
1 - \ � u : k � 4 W Q 7 O � < M p a b �
If the data directory is not specified, the environment variable PGDATA
is used.
Less commonly used options:
Options:
Other options:
Report bugs to <pgsql-bugs@postgresql.org>.
Success. You can now start the database server using:
%s%s%spg_ctl%s -D %s%s%s -l logfile start
Sync to disk skipped.
The data directory might become corrupt if the operating system crashes.
WARNING: enabling "trust" authentication for local connections
You can change this by editing pg_hba.conf or using the option -A, or
--auth-local and --auth-host, the next time you run initdb.
--auth-host=METHOD default authentication method for local TCP/IP connections
--auth-local=METHOD default authentication method for local-socket connections
--lc-collate=, --lc-ctype=, --lc-messages=LOCALE
--lc-monetary=, --lc-numeric=, --lc-time=LOCALE
set default locale in the respective category for
new databases (default taken from environment)
--locale=LOCALE set default locale for new databases
--no-locale equivalent to --locale=C
--pwfile=FILE read password for the new superuser from file
%s [OPTION]... [DATADIR]
-?, --help show this help, then exit
-A, --auth=METHOD default authentication method for local connections
-E, --encoding=ENCODING set default encoding for new databases
-L DIRECTORY where to find the input files
-N, --nosync do not wait for changes to be written safely to disk
-S, --sync-only only sync data directory
-T, --text-search-config=CFG
default text search configuration
-U, --username=NAME database superuser name
-V, --version output version information, then exit
-W, --pwprompt prompt for a password for the new superuser
-X, --xlogdir=XLOGDIR location for the transaction log directory
-d, --debug generate lots of debugging output
-k, --data-checksums use data page checksums
-n, --noclean do not clean up after errors
-s, --show show internal settings
[-D, --pgdata=]DATADIR location for this database cluster
%s initializes a PostgreSQL database cluster.
%s: "%s" is not a valid server encoding name
%s: WARNING: cannot create restricted tokens on this platform
%s: cannot be run as root
Please log in (using, e.g., "su") as the (unprivileged) user that will
own the server process.
%s: could not access directory "%s": %s
%s: could not access file "%s": %s
%s: could not allocate SIDs: error code %lu
%s: could not change permissions of "%s": %s
%s: could not change permissions of directory "%s": %s
%s: could not create directory "%s": %s
%s: could not create restricted token: error code %lu
%s: could not create symbolic link "%s": %s
%s: could not execute command "%s": %s
%s: could not find suitable encoding for locale "%s"
%s: could not find suitable text search configuration for locale "%s"
%s: could not fsync file "%s": %s
%s: could not get exit code from subprocess: error code %lu
%s: could not open directory "%s": %s
%s: could not open file "%s" for reading: %s
%s: could not open file "%s" for writing: %s
%s: could not open file "%s": %s
%s: could not open process token: error code %lu
%s: could not re-execute with restricted token: error code %lu
%s: could not read directory "%s": %s
%s: could not read password from file "%s": %s
%s: could not start process for command "%s": error code %lu
%s: could not stat file "%s": %s
%s: could not write file "%s": %s
%s: data directory "%s" not removed at user's request
%s: directory "%s" exists but is not empty
%s: encoding mismatch
%s: failed to remove contents of data directory
%s: failed to remove contents of transaction log directory
%s: failed to remove data directory
%s: failed to remove transaction log directory
%s: failed to restore old locale "%s"
%s: file "%s" does not exist
%s: file "%s" is not a regular file
%s: input file "%s" does not belong to PostgreSQL %s
Check your installation or specify the correct path using the option -L.
%s: input file location must be an absolute path
%s: invalid authentication method "%s" for "%s" connections
%s: invalid locale name "%s"
%s: invalid locale settings; check LANG and LC_* environment variables
%s: locale "%s" requires unsupported encoding "%s"
%s: locale name has non-ASCII characters, skipped: "%s"
%s: locale name too long, skipped: "%s"
%s: must specify a password for the superuser to enable %s authentication
%s: no data directory specified
You must identify the directory where the data for this database system
will reside. Do this with either the invocation option -D or the
environment variable PGDATA.
%s: out of memory
%s: password file "%s" is empty
%s: password prompt and password file cannot be specified together
%s: removing contents of data directory "%s"
%s: removing contents of transaction log directory "%s"
%s: removing data directory "%s"
%s: removing transaction log directory "%s"
%s: setlocale() failed
%s: superuser name "%s" is disallowed; role names cannot begin with "pg_"
%s: symlinks are not supported on this platform %s: too many command-line arguments (first is "%s")
%s: transaction log directory "%s" not removed at user's request
%s: transaction log directory location must be an absolute path
%s: warning: specified text search configuration "%s" might not match locale "%s"
%s: warning: suitable text search configuration for locale "%s" is unknown
Data page checksums are disabled.
Data page checksums are enabled.
Encoding "%s" implied by locale is not allowed as a server-side encoding.
The default database encoding will be set to "%s" instead.
Encoding "%s" is not allowed as a server-side encoding.
Rerun %s with a different locale selection.
Enter it again: Enter new superuser password: If you want to create a new database system, either remove or empty
the directory "%s" or run %s
with an argument other than "%s".
If you want to store the transaction log there, either
remove or empty the directory "%s".
It contains a dot-prefixed/invisible file, perhaps due to it being a mount point.
It contains a lost+found directory, perhaps due to it being a mount point.
No usable system locales were found.
Passwords didn't match.
Rerun %s with the -E option.
Running in debug mode.
Running in noclean mode. Mistakes will not be cleaned up.
The database cluster will be initialized with locale "%s".
The database cluster will be initialized with locales
COLLATE: %s
CTYPE: %s
MESSAGES: %s
MONETARY: %s
NUMERIC: %s
TIME: %s
The default database encoding has accordingly been set to "%s".
The default text search configuration will be set to "%s".
The encoding you selected (%s) and the encoding that the
selected locale uses (%s) do not match. This would lead to
misbehavior in various character string processing functions.
Rerun %s and either do not specify an encoding explicitly,
or choose a matching combination.
The files belonging to this database system will be owned by user "%s".
This user must also own the server process.
The program "postgres" is needed by %s but was not found in the
same directory as "%s".
Check your installation.
The program "postgres" was found by "%s"
but was not the same version as %s.
Check your installation.
This might mean you have a corrupted installation or identified
the wrong directory with the invocation option -L.
Try "%s --help" for more information.
Usage:
Use the option "--debug" to see details.
Using a mount point directly as the data directory is not recommended.
Create a subdirectory under the mount point.
cannot duplicate null pointer (internal error)
caught signal
child process exited with exit code %d child process exited with unrecognized status %d child process was terminated by exception 0x%X child process was terminated by signal %d child process was terminated by signal %s command not executable command not found could not change directory to "%s": %s could not close directory "%s": %s
could not find a "%s" to execute could not get junction for "%s": %s
could not identify current directory: %s could not look up effective user ID %ld: %s could not open directory "%s": %s
could not read binary "%s" could not read directory "%s": %s
could not read symbolic link "%s" could not remove file or directory "%s": %s
could not set junction for "%s": %s
could not stat file or directory "%s": %s
could not write to child process: %s
creating configuration files ... creating directory %s ... creating subdirectories ... fixing permissions on existing directory %s ... invalid binary "%s" ok
out of memory
pclose failed: %s performing post-bootstrap initialization ... running bootstrap script ... selecting default max_connections ... selecting default shared_buffers ... selecting dynamic shared memory implementation ... syncing data to disk ... user does not exist user name lookup failure: error code %lu Project-Id-Version: initdb (PostgreSQL) 9.6
Report-Msgid-Bugs-To: pgsql-bugs@postgresql.org
POT-Creation-Date: 2017-02-09 21:13+0000
PO-Revision-Date: 2017-04-23 03:06+0100
Last-Translator: Daniele Varrazzo <daniele.varrazzo@gmail.com>
Language-Team: https://github.com/dvarrazzo/postgresql-it
Language: it
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
X-Poedit-SourceCharset: utf-8
Plural-Forms: nplurals=2; plural=n != 1;
X-Generator: Poedit 1.8.7.1
Se la directory dati non è specificata, viene usata la variabile
d'ambiente PGDATA.
Opzioni utilizzate meno frequentemente:
Opzioni:
Altre opzioni:
Puoi segnalare eventuali bug a <pgsql-bugs@postgresql.org>.
Successo. Ora puoi avviare il server database con:
%s%s%spg_ctl%s -D %s%s%s -l logfile start
Sync sul disco saltato.
La directory dei dati potrebbe diventare corrotta in caso di crash del sistema operativo.
ATTENZIONE: abilitazione dell'autenticazione "trust" per le connessioni
locali. È possibile cambiare questa impostazione modificando il file
pg_hba.conf o utilizzando l'opzione -A oppure --auth-local and --auth-host
alla prossima esecuzione di initdb.
--auth-host=METODO metodo di autenticazione predefinito per le
connessioni TCP/IP
--auth-local=METODO metodo di autenticazione predefinito per le
connessioni locali
--lc-collate, --lc-ctype, --lc-messages=LOCALE
--lc-monetary, --lc-numeric, --lc-time=LOCALE
inizializza il nuovo cluster di database con il
locale specificato nella categoria corrispondente.
Il valore predefinito viene preso dalle variabili
d'ambiente
--locale=LOCALE imposta il locale predefinito per i nuovi
database
--no-locale equivalente a --locale=C
--pwfile=FILE leggi la password per il nuovo superutente dal file
%s [OPZIONE]... [DATADIR]
-?, --help mostra questo aiuto ed esci
-A, --auth=METODO metodo di autenticazione predefinito per le
connessioni locali
-E, --encoding=ENCODING imposta la codifica predefinita per i nuovi
database
-L DIRECTORY dove trovare i file di input
-N, --nosync non attendere che i cambiamenti siano stati
scritti in sicurezza sul disco
-S, --sync-only sincronizza solo la directory dei dati
-T, --text-search-config=CFG
configurazione predefinita per la ricerca di testo
-U, --username=NOME nome del superutente del database
-V, --version mostra informazioni sulla versione ed esci
-W, --pwprompt richiedi la password per il nuovo superutente
-X, --xlogdir=XLOGDIR posizione della directory contenente i log
delle transazioni
-d, --debug genera molto output di debug
-k, --data-checksums usa i checksum delle pagine dati
-n, --noclean non ripulire dopo gli errori
-s, --show mostra le impostazioni interne
[-D, --pgdata=]DATADIR dove creare questo cluster di database
%s inizializza un cluster di database PostgreSQL.
%s: "%s" non è un nome di codifica per il server valido
%s: ATTENZIONE: non è possibile creare token ristretti su questa piattaforma
%s: non può essere eseguito da root
Effettua il login (usando per esempio "su") con l'utente
(non privilegiato) che controllerà il processo server.
%s: accesso alla directory "%s" fallito: %s
%s: accesso al file "%s" fallito: %s
%s: allocazione dei SID fallita: codice errore %lu
%s: cambio di permesso di "%s" fallito: %s
%s: modifica dei permessi della directory "%s" fallita: %s
%s: creazione della directory "%s" fallita: %s
%s: creazione del token ristretto fallita: codice errore %lu
%s: creazione del link simbolico "%s" fallita: %s
%s: esecuzione del comando "%s" fallita: %s
%s: nessuna codifica adeguata trovata per il locale "%s"
%s: nessuna configurazione per la ricerca testo adeguata al locale "%s"
%s: fsync del file "%s" fallito: %s
%s: lettura del codice di uscita del processo figlio fallita: codice errore %lu
%s: apertura della directory "%s" fallita: %s
%s: errore nell'apertura del file "%s" per la lettura: %s
%s: errore nell'apertura del file "%s" per la scrittura: %s
%s: apertura del file "%s" fallita: %s
%s: apertura del token di processo fallita: codice errore %lu
%s: ri-eseguire con token ristretto fallita: codice errore %lu
%s: lettura della directory "%s" fallita: %s
%s: lettura del file delle password "%s" fallita: %s
%s: errore nell'avvio del processo per il comando "%s": codice errore %lu
%s: non è stato possibile ottenere informazioni sul file "%s": %s
%s: errore nella scrittura del file "%s": %s
%s: directory dati "%s" non rimossa su richiesta dell'utente
%s: la directory "%s" esiste ma non è vuota
%s: mancata corrispondenza di codifica
%s: rimozione dei contenuti dalla directory dati fallita
%s: rimozione dei contenuti della directory dei log delle transazioni fallita
%s: rimozione della directory dati fallita
%s: rimozione della directory dei log delle transazioni fallita
%s: ripristino del locale precedente "%s" fallito
%s: il file "%s" non esiste
%s: il file "%s" non è un file regolare
%s: il file di input "%s" non appartiene a PostgreSQL %s
Controlla la correttezza dell'installazione oppure specifica
il percorso corretto con l'opzione -L.
%s: la posizione del file di input deve essere un percorso assoluto
%s: metodo di autenticazione "%s" non valido per connessioni "%s"
%s: nome locale non valido "%s"
%s: impostazione locale non valida; controlla le variabili d'ambiente LANG e LC_*
%s: il locale "%s" richiede la codifica non supportata "%s"
%s: nome locale contiene caratteri non ASCII, saltato: "%s"
%s: nome locale troppo lungo, saltato: "%s"
%s: occorre specificare una password per il superutente per abilitare l'autenticazione %s
%s: nessuna directory dati specificati
È necessario indicare la directory dove risiederanno i dati di questo
database. Puoi farlo usando l'opzione -D oppure la variabile globale
PGDATA.
%s: memoria esaurita
%s: il file delle password "%s" è vuoto
%s: il prompt della password ed un file contenente la password non
possono essere specificati contemporaneamente
%s: rimozione dei contenuti della directory dati "%s"
%s: rimozione dei contenuti della directory dei log delle transazioni "%s"
%s: rimozione della directory dati "%s"
%s: rimozione della directory dei log delle transazioni "%s"
%s: setlocale() fallito
%s: il nome per il superutente "%s" non è permesso; i nomi dei ruoli non possono iniziare per "pg_"
%s: i link simbolici non sono supportati su questa piattaforma %s: troppi argomenti nella riga di comando (il primo è "%s")
%s: directory dei log delle transazioni "%s" non rimossa su richiesta dell'utente
%s: la directory dei log delle transazioni deve essere un percorso assoluto
%s: attenzione: la configurazione specificata per la ricerca testo "%s"
potrebbe non corrispondere al locale "%s"
%s: attenzione: non si conosce una configurazione per la ricerca testo adeguata al locale "%s"
La somma di controllo dei dati delle pagine è disabilitata.
La somma di controllo dei dati delle pagine è abilitata.
La codifica "%s" implicata dal locale non è consentita come codifica lato server.
La codifica predefinita dei database sarà impostata invece a "%s".
La codifica "%s" non è disponibile come codifica lato server.
Esegui di nuovo %s con un locale diverso.
Conferma password: Inserisci la nuova password del superutente: Se vuoi creare un nuovo sistema di database, elimina o svuota
la directory "%s" oppure esegui %s
con un argomento diverso da "%s".
Se vuoi salvare lì i log delle transazioni,
elimina oppure svuota la directory "%s".
Contiene un file prefissato con punto o invisibile, forse perché è un punto di montaggio.
Contiene una directory lost+found, forse perché è un punto di montaggio.
Nessun locale di sistema trovato.
Le password non corrispondono.
Esegui di nuovo %s con l'opzione -E.
Esecuzione in modalità debug
Esecuzione in modalità noclean. Gli errori non verranno ripuliti.
Il cluster di database sarà inizializzato con il locale "%s".
Il cluster di database sarà inizializzato con i locale
COLLATE: %s
CTYPE: %s
MESSAGES: %s
MONETARY: %s
NUMERIC: %s
TIME: %s
La codifica predefinita del database è stata impostata a "%s".
La configurazione predefinita di ricerca testo sarà impostata a "%s".
La codifica selezionata (%s) e la codifica usata dal locale
(%s) non corrispondono. Questo causerebbe un funzionamento errato
in molte funzioni di elaborazione delle stringhe di caratteri.
Esegui di nuovo %s senza specificare una codifica esplicitamente
oppure seleziona una combinazione corretta.
I file di questo database apparterranno all'utente "%s".
Questo utente deve inoltre possedere il processo server.
Il programma "postgres" è richiesto da %s ma non è stato trovato
nella stessa directory "%s".
Verifica la correttezza dell'installazione.
Il programma "postgres" è stato trovato da "%s"
ma non ha la stessa versione di %s.
Verifica la correttezza dell'installazione.
Questo potrebbe indica una installazione corrotta oppure
hai indicato la directory errata con l'opzione -L.
Prova "%s --help" per maggiori informazioni.
Utilizzo:
Usa l'opzione "--debug" per vedere i dettagli.
Usare un punto di montaggio direttamente come directory dati non è
consigliato. Crea una sottodirectory sotto il punto di montaggio.
impossibile duplicare il puntatore nullo (errore interno)
intercettato segnale
processo figlio uscito con codice di uscita %d processo figlio uscito con stato non riconosciuto %d processo figlio terminato da eccezione 0x%X processo figlio terminato da segnale %d processo figlio terminato da segnale %s comando non eseguibile comando non trovato spostamento nella directory "%s" fallito: %s chiusura della directory "%s" fallita: %s
programma "%s" da eseguire non trovato non è stato possibile ottenere la giunzione per "%s": %s
identificazione della directory corrente fallita: %s ID utente effettivo %ld non trovato: %s apertura della directory "%s" fallita: %s
lettura del binario "%s" fallita lettura della directory "%s" fallita: %s
lettura del link simbolico "%s" fallita rimozione del file o directory "%s" fallita: %s
non è stato possibile impostare la giunzione per "%s": %s
non è stato possibile ottenere informazioni sul file o directory "%s": %s
scrittura verso il processo figlio fallita: %s
creazione dei file di configurazione ... creazione della directory %s ... creazione delle sottodirectory ... correzione dei permessi sulla directory esistente %s ... binario non valido "%s" ok
memoria esaurita
pclose fallita: %s esecuzione dell'inizializzazione successiva al bootstrap ... esecuzione dello script di bootstrap ... selezione del parametro max_connections predefinito ... selezione di shared_buffers predefinito ... selezione dell'implementazione della memoria dinamica ... sincronizzazione dati sul disco ... l'utente non esiste ricerca del nome utente fallita: codice di errore %lu locale/it/LC_MESSAGES/pg_dump-9.6.mo 0000644 00000176206 14751153421 0012525 0 ustar 00 �� � t � � ) ) /) X B) [ �) B �) ) :* " d* x �* + + + 3+ A L+ N �+ P �+ I ., 3 x, y �, G &- C n- N �- K . v M. F �. > / R J/ B �/ E �/ ? &0 L f0 3 �0 6 �0 Q 1 T p1 M �1 ? 2 � S2 � �2 ? �3 9 �3 5 4 : J4 K �4 B �4 D 5 � Y5 3 �5 � 6 ? �6 D �6 x 7 6 �7 Q �7 O 8 F g8 > �8 5 �8 > #9 E b9 A �9 O �9 H :: B �: @ �: = ; O E; H �; ; �; , < 4 G< E |< 0 �< = �< , 1= F ^= D �= C �= F .> 8 u> ? �> C �> = 2? 4 p? 7 �? L �? = *@ @ h@ J �@ < �@ L 1A , ~A ( �A 5 �A E
B T PB �B 9 �B D �B G 'C oC �C ? �C ' �C *
D e 8D ! �D , �D 4 �D 6 "E ( YE / �E �E �E $ �E * F 2 2F B eF > �F J �F P 2G N �G H �G - H IH ^H / qH �H 4 �H $ �H &
I * 4I # _I �I P �I C �I A 7J ( yJ �J �J �J �J = K � OK
�K , �K � L � �L , BM oM p �M e �M & [N �N ` �N p �N 4 \O X �O _ �O E JP 1 �P 6 �P 4 �P * .Q - YQ D �Q . �Q + �Q + 'R ) SR * }R > �R : �R ' "S = JS ) �S 1 �S �S @ �S 7 @T 6 xT 6 �T < �T = #U 4 aU 3 �U b �U 9 -V < gV t �V # W , =W 5 jW �W �W �W
�W ' �W !X % -X SX / sX X �X & �X 0 #Y . TY ) �Y ) �Y �Y �Y Z 3 Z ( @Z iZ ) |Z # �Z �Z �Z & [ K -[ & y[ �[ ! �[ ( �[ ' \ 1\ # P\ t\ / �\ �\ �\ # ] % %] K] , h] $ �] $ �] $ �] 6 ^ ;^ S^ B t^ � �^ � N_ �_ $ �_ < "` 3 _` * �` ' �` + �` ( a ( ;a # da - �a � �a + �b , �b ! �b & c ' (c # Pc tc " �c 8 �c $ �c d 4d Q Sd & �d a �d @ .e 5 oe , �e �e " �e # f , 4f af ! �f # �f * �f # �f % g 0 ;g & lg $ �g �g " �g = �g # 8h 1 \h �h �h �h : �h ) i B *i P mi �i �i �i j " j >j Xj & uj & �j % �j 2 �j k 1k & Mk ! tk ) �k # �k " �k l r l < �l D �l N
m F \m �m �m �m & �m , $n - Qn n " �n / �n �n o ( !o @ Jo �o �o �o P �o /p > Ep 1 �p > �p / �p Y %q > q �q �q " �q r & 7r < ^r �r ' �r ( �r ' s (s Fs ]s 1 ps + �s �s % �s 3 t It bt " {t ; �t �t �t 0 u :u / Yu �u �u �u . �u I
v > Wv D �v �v �v w 7 w 9 Qw 6 �w H �w @ x Lx 3 ^x & �x 0 �x 6 �x / !y ( Qy , zy �y " �y �y �y z h %z T �z � �z 6 f{ L �{ J �{ 9 5| o| $ ~| + �| �| �| } } 1} 2 E} x} " �} �} �} # �} �} ~ / .~ ^~ & o~ �~ �~ # �~ �~ $ �~ ) C ! d % � + � � & � ' � G� g� 0 �� . �� ) � + � :� V� 4 t� � �� # ,� * P� {� �� ��  ( ܂ � " � ?� E T� # �� �� փ � ; �� 1� G� T� ' p� �� ' �� % �� � :� B W� 0 �� ! ˅ 8 � : &� a� }� 3 �� 1 І 1 � + 4� $ `� $ �� h �� � � � �� T � s h� P ܊ 5 -� * c� { ��
� � #� ?� Q Y� s �� � � w �� = � � Y� x � H ]� P �� � �� � z� J � J L� R �� I � M 4� N �� � ђ > _� @ �� ~ ߓ [ ^� � �� F @� � �� � � B ؖ ; � 7 W� ; �� t ˗ F @� S �� � ۘ < m� � �� M <� R �� � ݚ ? k� X �� x � F }� N Ĝ > � L R� J �� F � v 1� M �� G �� F >� D �� x ʟ L C� G �� 1 ؠ ?
� b J� 3 �� C � 3 %� Q Y� G �� A � T 5� < �� G ǣ L � L \� 8 �� ? � T "� B w� F �� W � M Y� T �� 8 �� 4 5� 8 j� H �� [ � H� = K� D �� L Ψ � 9� H U� ) �� , ȩ q �� ; g� 1 �� M ժ O #� B s� 3 �� & � � ' '� - O� 8 }� L �� H � T L� Z �� X �� R U� 4 �� ݮ � 8 � B� > \� & �� , ¯ 5 � # %� $ I� b n� Q Ѱ I #� ) m� " �� �� ! ڱ ! �� J � � i�
� < #� � `� � � - �� ʴ � y l� - �
� z � { �� N � o e� y շ P O� = �� B @ !� 0 b� - �� O �� D � A V� A �� @ ں 4 � M P� Q �� 6 � h '� A �� < Ҽ * � Y :� H �� I ݽ I '� Q q� V þ G � H b� s �� E � F e� ~ �� - +� 8 Y� D �� " � �� � %� 4 7� l� 1 {� 2 �� : �� j � . �� 4 �� + �� ' � ' >� f� }� �� 8 �� 0 �� � . � * K� # v� $ �� ( �� S �� , <� " i� * �� 4 �� 2 �� & � * F� ' q� 8 �� ( �� �� ) � ) F� " p� 2 �� + �� ( �� * � T F� �� & �� G �� � )� � �� ( |� $ �� 2 �� < �� ) :� 5 d� 5 �� 8 �� 4 � 0 >� < o� � �� 3 �� 4 �� ' � . .� / ]� , �� ' �� ( �� D � - P� ( ~� % �� c �� < 1� u n� [ �� I @� ( �� �� ) �� & �� 1 %� & W� ' ~� % �� 3 �� - � . .� - ]� 5 �� ( �� $ �� ( � C 8� ) |� 2 �� �� �� � F !� 4 h� M �� G �� 3� ( M� v� �� 0 �� �� % �� ( "� ' K� & s� T �� �� + � 6 5� ) l� 5 �� & �� % �� � � .� F �� V �� p R� g �� +� " L� ! o� - �� 7 �� ; �� ' 3� ) [� 7 �� �� $ �� / �� B /� r� , �� # �� a �� @� D Y� 6 �� I �� 9 � h Y� < �� ! �� !� ( B� # k� / �� O �� � , '� : T� 8 �� & �� �� � 9 � / Y� # �� . �� = �� � :� X� O x� �� 3 �� + � 4 @� , u� $ �� # �� �� 4
� S ?� H �� N �� +� =� \� A s� Q �� ? � e G� I �� �� >
� * I� < t� B �� ? �� , 4� 3 a� �� * �� �� , �� !� � 3� d �� � '� J �� j � \ �� M �� 3� $ E� ; j� �� " �� �� �� � < 3� p� + �� �� " �� 9 �� )� H� L g� �� 4 �� �� � * ,� # W� 3 {� 6 �� * �� / � 0 A� 9 r� & �� . �� 9 � ' <� + d� C �� < �� 9 � : K� " �� �� ; �� � � ' �� 5 �� % �� � 6� ! T� - v� �� �� � W � ) L� v� �� �� L � � ,� % =� * c� �� / �� $ � 8 �� " 6� Y� A u� . �� � G � D O� �� ! �� : � 9 � 4 F� ; {� . �� - � q � � � � � � A r � � � � � < � � � � ^ � � B � Y N � � � ' � a p ) � B � - �
� � X H � u � � $ � n ? 6 � � K i � y � � � � � � $ � � { � � � q � � { � � � + ' � � I � � < � J ~ m � . m v Q t � � � � � � Q � � � + � x � � ? K P 2 f � � � � � � � � � � � � p # � j � � , z ; � S � 4 � � � � � � � � � k � � O = " 3 � � % � � [ o � � � � 6 � � � � y
g � ( � > � � � � x � � > # � � o W T ! � � 4 � � E : E D � � @ � Z � � � H e � _ / � Y �
h [ l v d ] � � 5 d � � � � � � � N G � r } � � 8 � V z � � J � ` & � � � � � � � , ! - � F � a � ; � U 3 � C " O � � C � * � � � 1 � I S � � / 9 c � \ � � � � 9 � ` * � 5 T � R � 0 � � | � � � � � � � e . �
� 0 \ M � � t b W | R � � b � � & � q � � ^ � � X l � � } s g � � s _ h � D 1 2 � � i � U � � � � � � � � : � L � w ] � ( � j � M � F G � k n � L = � � � u � � � 7 V � Z ~ f ) � w c % @ A � � 7 8 P � � � �
Connection options:
General options:
If -f/--file is not used, then the SQL script will be written to the standard
output.
If no database name is supplied, then the PGDATABASE environment
variable value is used.
If no input file name is supplied, then standard input is used.
Options controlling the output content:
Options controlling the restore:
The options -I, -n, -P, -t, -T, and --section can be combined and specified
multiple times to select multiple objects.
%s
%s [OPTION]...
%s [OPTION]... [DBNAME]
%s [OPTION]... [FILE]
--binary-upgrade for use by upgrade utilities only
--column-inserts dump data as INSERT commands with column names
--disable-dollar-quoting disable dollar quoting, use SQL standard quoting
--disable-triggers disable triggers during data-only restore
--enable-row-security enable row security
--enable-row-security enable row security (dump only content user has
access to)
--exclude-table-data=TABLE do NOT dump data for the named table(s)
--if-exists use IF EXISTS when dropping objects
--inserts dump data as INSERT commands, rather than COPY
--lock-wait-timeout=TIMEOUT fail after waiting TIMEOUT for a table lock
--no-data-for-failed-tables do not restore data of tables that could not be
created
--no-security-labels do not dump security label assignments
--no-security-labels do not restore security labels
--no-synchronized-snapshots do not use synchronized snapshots in parallel jobs
--no-tablespaces do not dump tablespace assignments
--no-tablespaces do not restore tablespace assignments
--no-unlogged-table-data do not dump unlogged table data
--quote-all-identifiers quote all identifiers, even if not key words
--role=ROLENAME do SET ROLE before dump
--role=ROLENAME do SET ROLE before restore
--section=SECTION dump named section (pre-data, data, or post-data)
--section=SECTION restore named section (pre-data, data, or post-data)
--serializable-deferrable wait until the dump can run without anomalies
--snapshot=SNAPSHOT use given snapshot for the dump
--strict-names require table and/or schema include patterns to
match at least one entity each
--use-set-session-authorization
use SET SESSION AUTHORIZATION commands instead of
ALTER OWNER commands to set ownership
-1, --single-transaction restore as a single transaction
-?, --help show this help, then exit
-?, --help show this help, then exit
-C, --create create the target database
-C, --create include commands to create database in dump
-E, --encoding=ENCODING dump the data in encoding ENCODING
-F, --format=c|d|t backup file format (should be automatic)
-F, --format=c|d|t|p output file format (custom, directory, tar,
plain text (default))
-I, --index=NAME restore named index
-L, --use-list=FILENAME use table of contents from this file for
selecting/ordering output
-N, --exclude-schema=SCHEMA do NOT dump the named schema(s)
-O, --no-owner skip restoration of object ownership
-O, --no-owner skip restoration of object ownership in
plain-text format
-P, --function=NAME(args) restore named function
-S, --superuser=NAME superuser user name to use for disabling triggers
-S, --superuser=NAME superuser user name to use in plain-text format
-S, --superuser=NAME superuser user name to use in the dump
-T, --exclude-table=TABLE do NOT dump the named table(s)
-T, --trigger=NAME restore named trigger
-U, --username=NAME connect as specified database user
-V, --version output version information, then exit
-V, --version output version information, then exit
-W, --password force password prompt (should happen automatically)
-Z, --compress=0-9 compression level for compressed formats
-a, --data-only dump only the data, not the schema
-a, --data-only restore only the data, no schema
-b, --blobs include large objects in dump
-c, --clean clean (drop) database objects before recreating
-c, --clean clean (drop) databases before recreating
-d, --dbname=CONNSTR connect using connection string
-d, --dbname=DBNAME database to dump
-d, --dbname=NAME connect to database name
-e, --exit-on-error exit on error, default is to continue
-f, --file=FILENAME output file name
-f, --file=FILENAME output file or directory name
-f, --file=FILENAME output file name
-g, --globals-only dump only global objects, no databases
-h, --host=HOSTNAME database server host or socket directory
-j, --jobs=NUM use this many parallel jobs to dump
-j, --jobs=NUM use this many parallel jobs to restore
-l, --database=DBNAME alternative default database
-l, --list print summarized TOC of the archive
-n, --schema=NAME restore only objects in this schema
-n, --schema=SCHEMA dump the named schema(s) only
-o, --oids include OIDs in dump
-p, --port=PORT database server port number
-r, --roles-only dump only roles, no databases or tablespaces
-s, --schema-only dump only the schema, no data
-s, --schema-only restore only the schema, no data
-t, --table=NAME restore named relation (table, view, etc.)
-t, --table=TABLE dump the named table(s) only
-t, --tablespaces-only dump only tablespaces, no databases or roles
-v, --verbose verbose mode
-v, --verbose verbose mode
-w, --no-password never prompt for password
-x, --no-privileges do not dump privileges (grant/revoke)
-x, --no-privileges skip restoration of access privileges (grant/revoke)
%s %s dumps a database as a text file or to other formats.
%s extracts a PostgreSQL database cluster into an SQL script file.
%s restores a PostgreSQL database from an archive created by pg_dump.
%s: %s Command was: %s
%s: WSAStartup failed: %d
%s: cannot specify both --single-transaction and multiple jobs
%s: could not connect to database "%s"
%s: could not connect to database "%s": %s %s: could not connect to databases "postgres" or "template1"
Please specify an alternative database.
%s: could not get server version
%s: could not open the output file "%s": %s
%s: could not parse ACL list (%s) for database "%s"
%s: could not parse ACL list (%s) for tablespace "%s"
%s: could not parse server version "%s"
%s: could not re-open the output file "%s": %s
%s: dumping database "%s"...
%s: executing %s
%s: invalid number of parallel jobs
%s: maximum number of parallel jobs is %d
%s: option --if-exists requires option -c/--clean
%s: options -c/--clean and -a/--data-only cannot be used together
%s: options -d/--dbname and -f/--file cannot be used together
%s: options -g/--globals-only and -r/--roles-only cannot be used together
%s: options -g/--globals-only and -t/--tablespaces-only cannot be used together
%s: options -r/--roles-only and -t/--tablespaces-only cannot be used together
%s: options -s/--schema-only and -a/--data-only cannot be used together
%s: pg_dump failed on database "%s", exiting
%s: query failed: %s %s: query was: %s
%s: role name starting with "pg_" skipped (%s)
%s: running "%s"
%s: too many command-line arguments (first is "%s")
%s: unrecognized section name: "%s"
(The INSERT command cannot set OIDs.)
(The system catalogs might be corrupted.)
-C and -1 are incompatible options
COPY failed for table "%s": %s Consider using a full dump instead of a --data-only dump to avoid this problem.
Dumping the contents of table "%s" failed: PQgetCopyData() failed.
Dumping the contents of table "%s" failed: PQgetResult() failed.
Error from TOC entry %d; %u %u %s %s %s
Error message from server: %s Error while FINALIZING:
Error while INITIALIZING:
Error while PROCESSING TOC:
Exported snapshots are not supported by this server version.
NOTICE: there are circular foreign-key constraints on this table:
NOTICE: there are circular foreign-key constraints among these tables:
Password: Report bugs to <pgsql-bugs@postgresql.org>.
Synchronized snapshots are not supported by this server version.
Run with --no-synchronized-snapshots instead if you do not need
synchronized snapshots.
Synchronized snapshots are not supported on standby servers.
Run with --no-synchronized-snapshots instead if you do not need
synchronized snapshots.
TOC Entry %s at %s (length %s, checksum %d)
The command was: %s
The program "pg_dump" is needed by %s but was not found in the
same directory as "%s".
Check your installation.
The program "pg_dump" was found by "%s"
but was not the same version as %s.
Check your installation.
Try "%s --help" for more information.
Usage:
WARNING: aggregate function %s could not be dumped correctly for this database version; ignored
WARNING: archive is compressed, but this installation does not support compression -- no data will be available
WARNING: archive items not in correct section order
WARNING: archive was made on a machine with larger integers, some operations might fail
WARNING: bogus transform definition, at least one of trffromsql and trftosql should be nonzero
WARNING: bogus value in pg_cast.castfunc or pg_cast.castmethod field
WARNING: bogus value in pg_cast.castmethod field
WARNING: bogus value in pg_transform.trffromsql field
WARNING: bogus value in pg_transform.trftosql field
WARNING: bogus value in proargmodes array
WARNING: could not find operator with OID %s
WARNING: could not find where to insert IF EXISTS in statement "%s"
WARNING: could not parse proallargtypes array
WARNING: could not parse proargmodes array
WARNING: could not parse proargnames array
WARNING: could not parse proconfig array
WARNING: could not parse reloptions array
WARNING: could not resolve dependency loop among these items:
WARNING: don't know how to set owner for object type "%s"
WARNING: errors ignored on restore: %d
WARNING: ftell mismatch with expected position -- ftell used
WARNING: invalid creation date in header
WARNING: invalid type "%c" of access method "%s"
WARNING: line ignored: %s
WARNING: owner of aggregate function "%s" appears to be invalid
WARNING: owner of data type "%s" appears to be invalid
WARNING: owner of function "%s" appears to be invalid
WARNING: owner of operator "%s" appears to be invalid
WARNING: owner of operator class "%s" appears to be invalid
WARNING: owner of operator family "%s" appears to be invalid
WARNING: owner of schema "%s" appears to be invalid
WARNING: owner of table "%s" appears to be invalid
WARNING: requested compression not available in this installation -- archive will be uncompressed
WARNING: typtype of data type "%s" appears to be invalid
WARNING: unexpected extra results during COPY of table "%s"
You might not be able to restore the dump without using --disable-triggers or temporarily dropping the constraints.
a worker process died unexpectedly
aborting because of server version mismatch
actual file length (%s) does not match expected (%s)
allocating AH for %s, format %d
already connected to a database
archiver archiver (db) attempting to ascertain archive format
bad dumpId
bad table dumpId for TABLE DATA item
can only reopen input archives
cannot duplicate null pointer (internal error)
cannot restore from compressed archive (compression not supported in this installation)
child process exited with exit code %d child process exited with unrecognized status %d child process was terminated by exception 0x%X child process was terminated by signal %d child process was terminated by signal %s command not executable command not found compress_io compression is not supported by tar archive format
compression level must be in range 0..9
compressor active
connecting to database "%s" as user "%s"
connecting to database for restore
connecting to new database "%s"
connection needs password
connection to database "%s" failed: %s corrupt tar header found in %s (expected %d, computed %d) file position %s
could not change directory to "%s": %s could not close TOC file: %s
could not close archive file: %s
could not close compression library: %s
could not close compression stream: %s
could not close data file: %s
could not close directory "%s": %s
could not close input file: %s
could not close large object TOC file "%s": %s
could not close output file: %s
could not close tar member
could not close temporary file: %s
could not commit database transaction could not compress data: %s
could not create communication channels: %s
could not create directory "%s": %s
could not create large object %u: %s could not create worker process: %s
could not determine seek position in archive file: %s
could not execute query could not find a "%s" to execute could not find block ID %d in archive -- possibly corrupt archive
could not find block ID %d in archive -- possibly due to out-of-order restore request, which cannot be handled due to lack of data offsets in archive
could not find block ID %d in archive -- possibly due to out-of-order restore request, which cannot be handled due to non-seekable input file
could not find entry for ID %d
could not find file "%s" in archive
could not find function definition for function with OID %u
could not find header for file "%s" in tar archive
could not find parent extension for %s %s
could not find slot of finished worker
could not generate temporary file name: %s
could not get server_version from libpq
could not identify current directory: %s could not identify dependency loop
could not initialize compression library: %s
could not obtain lock on relation "%s"
This usually means that someone requested an ACCESS EXCLUSIVE lock on the table after the pg_dump parent process had gotten the initial ACCESS SHARE lock on the table.
could not open TOC file "%s" for input: %s
could not open TOC file "%s" for output: %s
could not open TOC file "%s": %s
could not open TOC file for input: %s
could not open TOC file for output: %s
could not open input file "%s": %s
could not open input file: %s
could not open large object %u: %s could not open large object TOC file "%s" for input: %s
could not open output file "%s": %s
could not open output file: %s
could not open temporary file
could not parse GRANT ACL list (%s) or REVOKE ACL list (%s) for object "%s" (%s)
could not parse default ACL list (%s)
could not parse initial GRANT ACL list (%s) or initial REVOKE ACL list (%s) for object "%s" (%s)
could not parse numeric array "%s": invalid character in number
could not parse numeric array "%s": too many numbers
could not parse result of current_schemas()
could not read binary "%s" could not read directory "%s": %s
could not read from input file: %s
could not read from input file: end of file
could not read input file: %s
could not read symbolic link "%s" could not reconnect to database: %s could not set default_tablespace to %s: %s could not set default_with_oids: %s could not set search_path to "%s": %s could not set seek position in archive file: %s
could not set session user to "%s": %s could not start database transaction could not uncompress data: %s
could not write to blobs TOC file
could not write to large object (result: %lu, expected: %lu)
could not write to output file: %s
could not write to the communication channel: %s
creating %s "%s"
creating %s "%s.%s"
custom archiver definition of view "%s" appears to be empty (length zero)
did not find magic string in file header
direct database connections are not supported in pre-1.3 archives
directory "%s" does not appear to be a valid archive ("toc.dat" does not exist)
directory archiver directory name too long: "%s"
disabling triggers for %s
dropping %s %s
dumping contents of table "%s.%s"
enabling triggers for %s
entering main parallel loop
entering restore_toc_entries_parallel
entering restore_toc_entries_postfork
entering restore_toc_entries_prefork
entry ID %d out of range -- perhaps a corrupt TOC
error during backup
error during file seek: %s
error processing a parallel work item
error reading large object %u: %s error reading large object TOC file "%s"
error returned by PQputCopyData: %s error returned by PQputCopyEnd: %s executing %s %s
expected %d check constraint on table "%s" but found %d
expected %d check constraints on table "%s" but found %d
expected format (%d) differs from format found in file (%d)
failed sanity check, parent OID %u of table "%s" (OID %u) not found
failed sanity check, parent table OID %u of pg_rewrite entry OID %u not found
failed sanity check, parent table OID %u of sequence OID %u not found
failed to connect to database
failed to reconnect to database
file name too long: "%s"
file offset in dump file is too large
finding check constraints for table "%s.%s"
finding default expressions of table "%s.%s"
finding extension tables
finding inheritance relationships
finding the columns and types of table "%s.%s"
finished item %d %s %s
finished main parallel loop
flagging inherited columns in subtables
found unexpected block ID (%d) when reading data -- expected %d
function "%s" not found
identifying extension members
implied data-only restore
incomplete tar header found (%lu byte)
incomplete tar header found (%lu bytes)
index "%s" not found
input file appears to be a text format dump. Please use psql.
input file does not appear to be a valid archive
input file does not appear to be a valid archive (too short?)
input file is too short (read %lu, expected 5)
internal error -- WriteData cannot be called outside the context of a DataDumper routine
internal error -- neither th nor fh specified in tarReadRaw()
invalid ENCODING item: %s
invalid OID for large object
invalid OID for large object (%u)
invalid STDSTRINGS item: %s
invalid adnum value %d for table "%s"
invalid argument string (%s) for trigger "%s" on table "%s"
invalid binary "%s" invalid client encoding "%s" specified
invalid column number %d for table "%s"
invalid column numbering in table "%s"
invalid compression code: %d
invalid dependency %d
invalid dumpId %d
invalid line in large object TOC file "%s": "%s"
invalid message received from worker: "%s"
invalid number of parallel jobs
invalid output format "%s" specified
large-object output not supported in chosen format
last built-in OID is %u
launching item %d %s %s
missing index for constraint "%s"
moving from position %s to next member at file position %s
no item ready
no matching schemas were found
no matching schemas were found for pattern "%s"
no matching tables were found
no matching tables were found for pattern "%s"
no output directory specified
not built with zlib support
now at file position %s
option --if-exists requires option -c/--clean
options --inserts/--column-inserts and -o/--oids cannot be used together
options -c/--clean and -a/--data-only cannot be used together
options -s/--schema-only and -a/--data-only cannot be used together
out of memory
out of on_exit_nicely slots
parallel archiver parallel backup only supported by the directory format
parallel restore from non-seekable file is not supported
parallel restore from standard input is not supported
parallel restore is not supported with archives made by pre-8.0 pg_dump
parallel restore is not supported with this archive file format
pclose failed: %s pgpipe: could not accept connection: error code %d
pgpipe: could not bind: error code %d
pgpipe: could not connect socket: error code %d
pgpipe: could not create second socket: error code %d
pgpipe: could not create socket: error code %d
pgpipe: could not listen: error code %d
pgpipe: getsockname() failed: error code %d
processing %s
processing data for table "%s.%s"
processing item %d %s %s
processing missed item %d %s %s
query failed: %s query produced null referenced table name for foreign key trigger "%s" on table "%s" (OID of table: %u)
query returned %d row instead of one: %s
query returned %d rows instead of one: %s
query to get data of sequence "%s" returned %d row (expected 1)
query to get data of sequence "%s" returned %d rows (expected 1)
query to get data of sequence "%s" returned name "%s"
query to get rule "%s" for table "%s" failed: wrong number of rows returned
query to obtain definition of view "%s" returned more than one definition
query to obtain definition of view "%s" returned no data
query was: %s
read TOC entry %d (ID %d) for %s %s
reading column info for interesting tables
reading constraints
reading default privileges
reading dependency data
reading event triggers
reading extensions
reading foreign key constraints for table "%s.%s"
reading indexes
reading indexes for table "%s.%s"
reading large objects
reading policies
reading policies for table "%s.%s"
reading procedural languages
reading rewrite rules
reading row security enabled for table "%s.%s"
reading schemas
reading table inheritance information
reading transforms
reading triggers
reading triggers for table "%s.%s"
reading type casts
reading user-defined access methods
reading user-defined aggregate functions
reading user-defined collations
reading user-defined conversions
reading user-defined foreign servers
reading user-defined foreign-data wrappers
reading user-defined functions
reading user-defined operator classes
reading user-defined operator families
reading user-defined operators
reading user-defined tables
reading user-defined text search configurations
reading user-defined text search dictionaries
reading user-defined text search parsers
reading user-defined text search templates
reading user-defined types
reducing dependencies for %d
restored %d large object
restored %d large objects
restoring data out of order is not supported in this archive format: "%s" is required, but comes before "%s" in the archive file.
restoring large object with OID %u
sanity check on integer size (%lu) failed
saving database definition
saving encoding = %s
saving large objects
saving search_path = %s
saving standard_conforming_strings = %s
schema "%s" not found
schema with OID %u does not exist
select() failed: %s
server version must be at least 7.3 to use schema selection switches
server version: %s; %s version: %s
skipping item %d %s %s
skipping tar member %s
sorter table "%s" could not be created, will not restore its data
table "%s" not found
tar archiver this format cannot be read
transferring dependency %d -> %d to %d
trigger "%s" not found
unexpected COPY statement syntax: "%s"
unexpected data offset flag %d
unexpected policy command type: "%s"
unexpected section code %d
unexpected tgtype value: %d
unrecognized archive format "%s"; please specify "c", "d", or "t"
unrecognized command received from master: "%s"
unrecognized constraint type: %c
unrecognized data block type %d while restoring archive
unrecognized data block type (%d) while searching archive
unrecognized encoding "%s"
unrecognized file format "%d"
unrecognized object type in default privileges: %d
unrecognized proparallel value for function "%s"
unrecognized provolatile value for function "%s"
unsupported version (%d.%d) in file header
warning from original dump file: %s
worker process failed: exit code %d
wrote %lu byte of large object data (result = %lu)
wrote %lu bytes of large object data (result = %lu)
Project-Id-Version: pg_dump (Postgresql) 9.6
Report-Msgid-Bugs-To: pgsql-bugs@postgresql.org
POT-Creation-Date: 2018-10-08 14:32+0000
PO-Revision-Date: 2018-10-08 21:17+0100
Last-Translator: Daniele Varrazzo <daniele.varrazzo@gmail.com>
Language-Team: https://github.com/dvarrazzo/postgresql-it
Language: it
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Plural-Forms: nplurals=2; plural=n != 1;
X-Generator: Poedit 2.0.6
Opzioni di connessione:
Opzioni generali:
Se -f/--file non viene usato, lo script SQL verrà scritto nello standard
output.
Se non è stato fornito il nome del database, viene utilizzato il valore
della variabile di ambiente PGDATABASE.
Se non è stato fornito un nome in input, viene utilizzato lo standard input.
Opzioni per il controllo del contenuto dell'output:
Opzioni per il controllo del ripristino:
Le opzioni -I, -n, -P, -t, -T e --section possono essere combinate e specificate
più volte per selezionare più oggetti.
%s
%s [OPZIONE]...
%s [OPZIONE]... [NOMEDB]
%s [OPZIONE]... [FILE]
--binary-upgrade da utilizzare solo dall'utilità di aggiornamento
--column-inserts scarica dati come comandi INSERT con nomi
di colonna
--disable-dollar-quoting disabilita la quotazione con dollari, usa la
quotazione standard SQL
--disable-triggers disabilita i trigger durante il ripristino
dei soli dati
--enable-row-security abilita la sicurezza per riga
--enable-row-security abilita la sicurezza per riga (salva solo i dati
a cui l'utente ha accesso)
--exclude-table-data=TABLE NON scaricare i dati per la tabella o le tabelle
indicate
--if-exists usa IF EXISTS nell'eliminare gli oggetti
--inserts scarica i dati come comandi INSERT anziché COPY
--lock-wait-timeout=TIMEOUT termina con errore dopo un'attesa di TIMEOUT
per un lock di tabella
--no-data-for-failed-tables non ripristinare i dati delle tabelle che non
è stato possibile creare
--no-security-labels non scaricare le assegnazioni di sicurezza
--no-security-labels non ripristinare le etichette di sicurezza
--no-synchronized-snapshots non usare snapshot sincronizzati nei job paralleli
--no-tablespaces non scarica le assegnazioni di tablespace
--no-tablespaces non ripristina le assegnazioni dei tablespace
--no-unlogged-table-data non scaricare i dati delle tabelle non loggate
--quote-all-identifiers metti tutti gli identificatori tra virgolette,
anche se non sono parole chiave
--role=NOMERUOLO esegui SET ROLE prima di scaricare
--role=NOMERUOLO esegui SET ROLE prima del ripristino
--section=SECTION scarica la sezione con questo nome (pre-data,
data o post-data)
--section=SEZIONE ripristina la sezione indicata (pre-data, data o post-data)
--serializable-deferrable attendi prima che lo scaricamento possa essere
eseguito senza anomalie
--snapshot=SNAPSHOT usa questo snapshot per il salvataggio
--strict-names richiede che le tabelle/schemi includano pattern
che combacino con almeno un'entità
--use-set-session-authorization
usa i comandi SET SESSION AUTHORIZATION invece
di ALTER OWNER per impostare il proprietario
-1, --single-transaction ripristina in un'unica transazione
-?, --help mostra questo aiuto ed esci
-?, --help mostra questo aiuto ed esci
-C, --create crea il database in oggetto
-C, --create include nell'archivio i comandi per creare
i database
-E, --encoding=CODIFICA scarica i dati nella CODIFICA indicata
-F, --format=c|d|t formato del file di backup (dovrebbe essere automatico)
-F, --format=c|d|t|p formato del file di output (custom, directory,
tar, testo in chiaro (predefinito))
-I, --index=NOME ripristina l'indice indicato
-L, --use-list=NOMEFILE utilizza la tabella dei contenuti di questo file per
selezionare/ordinare l'output
-N, --exclude-schema=SCHEMA non scaricare lo schema o gli schemi indicati
-O, --no-owner salta il ripristino del proprietario degli oggetti
-O, --no-owner salta il ripristino del proprietario degli
oggetti nel formato testo in chiaro
-P, --function=NOME(arg) ripristina la funzione indicata
-S, --superuser=NOME nome del superutente da usare per disabilitare i trigger
-S, --superuser=NOME nome del superutente da usare nel formato testo
in chiaro
-S, --superuser=NOME nome del superutente da usare nel dump
-T, --exclude-table=TABELLA NON scaricare la tabella o le tabelle indicate
-T, --trigger=NOME ripristina il trigger indicato
-U, --username=NOME connessione con l'utente di database specificato
-V, --version mostra informazioni sulla versione ed esci
-V, --version mostra informazioni sulla versione ed esci
-W, --password forza la richiesta di una password (dovrebbe essere
automatico)
-Z, --compress=0-9 livello di compressione per formati compressi
-a, --data-only scarica solamente i dati, non lo schema
-a, --data-only ripristina solo i dati, non gli schemi
-b, --blobs includi nell'archivio i large object
-c, --clean svuota (drop) gli oggetti del database prima di
ricrearli
-c, --clean pulisci (drop) i database prima di ricrearli
-d, --dbname=STRCONN connettiti usando la stringa di connessione
-d, --dbname=NOMEDB database da scaricare
-d, --dbname=NOME nome del database a cui connettersi
-e, --exit-on-error esci in caso di errore, il comportamento predefinito è continuare
-f, --file=NOMEFILE nome file di output
-f, --file=NOMEFILE nome del file o directory di output
-f, --file=NOMEFILE nome del file di output
-g, --globals-only scarica solo gli oggetti globali e non i database
-h, --host=NOMEHOST host server del database o directory socket
-j, --jobs=NUM usa NUM job paralleli per il dump
-j, --jobs=NUM per il ripristino usa questo numero di job paralleli
-l, --database=NOMEDB database predefinito alternativo
-l, --list stampa un riassunto della TOC dell'archivio
-n, --schema=NOME ripristina solo gli oggetti in questo schema
-n, --schema=SCHEMA scarica solo lo schema o gli schemi indicati
-o, --oids includi gli OID nel dump
-p, --port=PORTA numero porta del server di database
-r, --roles-only scarica solo i ruoli e non i database o i tablespace
-s, --schema-only scarica solo lo schema, non i dati
-s, --schema-only ripristina solo lo schema e non i dati
-t, --table=NOME ripristina la relazione indicata (tabella, vista, ecc.)
-t, --table=TABELLA scarica solo la tabella o le tabelle indicate
-t, --tablespaces-only scarica solo i tablespace e non i database o i ruoli
-v, --verbose stampa più informazioni
-v, --verbose stampa più informazioni
-w, --no-password non chiedere mai le password
-x, --no-privileges non scaricare i privilegi (grant/revoke)
-x, --no-privileges salta il ripristino dei privilegi di accesso (grant/revoke)
%s %s scarica un database in formato testo o in altri formati.
%s estrae un cluster di database PostgreSQL in un file script SQL.
%s ripristino di un database PostgreSQL da un archivio creato con pg_dump.
%s: %s Il comando era: %s
%s: WSAStartup fallita: %d
%s: non si può specificare insieme --single-transaction e job multipli
%s: connessione al database "%s" fallita
%s: connessione al database "%s" fallita: %s %s: non stato è possibile connettersi ai database "postgres" o "template1"
Specificare un database alternativo.
%s: non è stato possibile ottenere la versione del server
%s: apertura del file di output "%s" fallita: %s
%s: non è stato possibile analizzare la lista ACL (%s) per il database "%s"
%s: non è stato possibile analizzare la lista ACL (%s) per il tablespace "%s"
%s: non è stato possibile analizzare la versione del server "%s"
%s: riapertura del file di output "%s" fallita: %s
%s: scaricamento del database "%s"...
%s: esecuzione di %s
%s: numero di job paralleli non valido
%s: il numero massimo di job paralleli è %d
%s: l'opzione --if-exists richiede l'opzione -c/--clean
%s: le opzioni -c/--clean e -a/--data-only non possono essere usate insieme
%s: le opzioni -d/--dbname e -f/--file non possono essere usate insieme
%s: le opzioni -g/--globals-only e -r/--roles-only non possono essere usate insieme
%s: le opzioni -g/--globals-only e -t/--tablespaces-only non possono essere usate insieme
%s: la opzioni -r/--roles-only e -t/--tablespaces-only non possono essere usate insieme
%s: le opzioni -s/--schema-only e -a/--data-only non possono essere usate insieme
%s: pg_dump fallito per il database "%s", in uscita
%s: query fallita: %s %s: la query era: %s
%s: nome di ruolo (%s) saltato perché inizia con "pg_"
%s: in elaborazione "%s"
%s: troppi argomenti nella riga di comando (il primo è "%s")
%s: nome di sezione sconosciuto: "%s"
(Il comando INSERT non può impostare OID.)
(I cataloghi di sistema potrebbero essere corrotti.)
-C e -1 sono opzioni incompatibili
COPY fallito per la tabella "%s": %s Considera l'uso di un salvataggio completo invece di uno --data-only per evitare questo problema.
Lo scarico dei contenuti della tabella "%s" è fallito: PQgetCopyData() fallito.
Scarico dei contenuti della tabella "%s" fallito: PQgetResult() fallito.
Errore nella voce TOC %d; %u %u %s %s %s
Messaggio di errore dal server: %s Errore durante FINALIZZAZIONE:
Errore durante INIZIALIZZAZIONE:
Errore durante ELABORAZIONE TOC:
Gli snapshot esportati non sono supportati da questa versione del server.
AVVISO: ci sono vincoli di dipendenza circolari tra chiavi esterne in questa tabella:
AVVISO: ci sono vincoli di dipendenza circolari tra chiavi esterne tra queste tabelle:
Password: Puoi segnalare eventuali bug a <pgsql-bugs@postgresql.org>.
Gli snapshot sincronizzati non sono supportati da questa versione
del server. Puoi usare --no-synchronized-snapshots invece se non hai
bisogno di snapshot sincronizzati.
Gli snapshot sincronizzati non sono supportati sui server di standby.
Usa --no-synchronized-snapshots se non ti servono snapshot
sincronizzati.
Voce TOC %s a %s (lunghezza %s, checksum %d)
Il comando era: %s
Il programma "pg_dump" è richiesto da %s ma non è stato trovato nella
stessa directory di "%s".
Verifica che l'installazione sia corretta.
Il programma "pg_dump" è stato trovato da "%s"
ma non è la stessa versione di %s.
Controllate la vostra installazione.
Prova "%s --help" per maggiori informazioni.
Utilizzo:
ATTENZIONE: la funzione di aggregazione %s non può essere scaricata correttamente per questa versione database; ignorata
ATTENZIONE: l'archivio è compresso, ma questa installazione non supporta la compressione -- nessun dato sarà disponibile
ATTENZIONE: gli elementi dell'archivio non sono nell'ordine di sezione giusto
ATTENZIONE: L'archivio è stato creato su una macchina con interi lunghi, alcune operazioni potrebbero fallire
ATTENZIONE: definizione della trasformazione non corretta, almeno uno tra trffromsql e trftosql dovrebbe essere non-zero
ATTENZIONE: valore non corretto nei campi pg_cast.castfunc o pg_cast.castmethod
ATTENZIONE: valore non corretto nel campo pg_cast.castmethod
ATTENZIONE: valore non corretto nel campo pg_transform.trffromsql
ATTENZIONE: valore non corretto nel campo pg_transform.trftosql
ATTENZIONE: valore errato nell'array proargmode
ATTENZIONE: operatore con oid %s non trovato
ATTENZIONE: posizione dove inserire IF EXISTS nell'istruzione "%s" non trovata
ATTENZIONE: non è stato possibile analizzare l'array proallargtype
ATTENZIONE: non è stato possibile analizzare l'array proargmode
ATTENZIONE: non è stato possibile analizzare l'array proargname
ATTENZIONE: non è stato possibile analizzare l'array preconfig
ATTENZIONE: errore di lettura dell'array reloptions
ATTENZIONE: risoluzione del ciclo di dipendenze tra questi elementi fallito:
ATTENZIONE: non si sa come impostare il proprietario per il tipo di oggetto "%s"
ATTENZIONE: errore ignorato durante il ripristino: %d
ATTENZIONE: ftell non corrisponde alla posizione prevista -- verrà usato il valore restituito da ftell
ATTENZIONE: la data di creazione nell'intestazione non è valida
ATTENZIONE: tipo "%c" non valido del metodo di accesso "%s"
ATTENZIONE: la riga è stata ignorata: %s
ATTENZIONE: il proprietario della funzione di aggregazione "%s" non sembra essere valido
ATTENZIONE: il proprietario del tipo dato "%s" non sembra essere valido
ATTENZIONE: il proprietario della funzione "%s" non sembra essere valido
ATTENZIONE: il proprietario dell'operatore "%s" non sembra essere valido
ATTENZIONE: il proprietario della classe operatore "%s" non sembra essere valido
ATTENZIONE: il proprietario della famiglia di operatori "%s" non sembra essere valido
ATTENZIONE: il proprietario dello schema "%s" sembra non essere valido
ATTENZIONE: il proprietario della tabella "%s" non sembra essere valido
ATTENZIONE: la compressione richiesta non è disponibile in questa installazione -- l'archivio non sarà compresso
ATTENZIONE: il "typtype" del tipo dato "%s" sembra non essere valido
ATTENZIONE: risultati aggiuntivi inattesi nel COPY della tabella "%s"
Potreste non essere in grado di ripristinare l'archivio senza usare --disable-triggers o eliminare temporaneamente i vincoli.
un processo worker è morto inaspettatamente
abortito perché la versione del server non corrisponde
la lunghezza del file (%s) non corrisponde con quella prevista (%s)
allocazione AH per %s, formato %d
già connesso ad un database
archiviatore archiviatore (db) tentativo di accertamento del formato dell'archivio
dumpId errato
dumpId di tabella errato per elemento TABLE DATA
solo gli archivi in input possono essere riaperti
impossibile duplicare il puntatore nullo (errore interno)
non è possibile ripristinare da archivio compresso (compressione non supportata in questa installazione)
processo figlio uscito con codice di uscita %d processo figlio uscito con stato non riconosciuto %d processo figlio terminato da eccezione 0x%X processo figlio terminato da segnale %d processo figlio terminato da segnale %s comando non eseguibile comando non trovato compress_io compressione non supportata dal formato di archivio tar
il livello di compressione dev'essere tra 0 e 9
compressione attiva
connessione al database "%s" come utente "%s"
connessione al database per il ripristino
connessione al nuovo database "%s"
la connessione richiede la password
connessione al database "%s" fallita: %s intestazione tar corrotta in %s (previsti %d, calcolati %d) alla posizione file %s
spostamento nella directory "%s" fallito: %s chiusura del file TOC fallita: %s
chiusura del file di archivio fallita: %s
chiusura della libreria di compressione fallita: %s
chiusura dello stream di compressione fallita: %s
chiusura del file di dati fallita: %s
chiusura della directory "%s" fallita: %s
chiusura del file di input fallita: %s
chiusura del file TOC dei large object "%s" fallita: %s
chiusura del file di output fallita: %s
chiusura del membro tar fallita
chiusura del file temporaneo fallita: %s
commit della transazione database fallito compressione dei dati fallita: %s
creazione dei canali di comunicazione fallita: %s
creazione della directory "%s" fallita: %s
creazione il large object %u fallita: %s creazione del processo worker fallita: %s
non è stato possibile determinare la posizione per il seek nel file d'archivio: %s
esecuzione della query fallita programma "%s" da eseguire non trovato blocco ID %d non trovato nell'archivio -- forse l'archivio è corrotto
blocco ID %d non trovato nell'archivio -- forse per una richiesta di ripristino fuori ordine, che non può essere eseguita per la mancanza di offset dati nell'archivio
blocco ID %d non trovato nell'archivio -- forse per una richiesta di ripristino fuori ordine, che non può essere eseguita perché il file di input non supporta il seek
non sono state trovate voci per l'ID %d
file "%s" non trovato nell'archivio
definizione della funzione con OID %u non trovata
intestazione per il file "%s" nell'archivio tar non trovata
estensione genitore di %s %s non trovata
non è stato trovato alcuno slot di worker terminati
generazione del nome del file temporaneo fallita: %s
non è stato possibile ottenere server_version da libpq
identificazione della directory corrente fallita: %s identificazione del ciclo di dipendenze fallito
inizializzazione della libreria di compressione fallita: %s
errore nell'ottenere un lock sulla relazione "%s"
Questo di solito vuol dire che qualcuno ha richiesto un lock ACCESS EXCLUSIVE sulla tabella dopo che il processo padre di pg_dump aveva ottenuto il lock ACCESS SHARE iniziale sulla tabella.
apertura del file TOC "%s" per l'input fallita: %s
apertura del file TOC "%s" per l'output fallita: %s
apertura del file TOC "%s" fallita: %s
apertura del file TOC per l'input fallita: %s
apertura del file TOC per l'output fallita: %s
apertura del file di input "%s" fallita: %s
apertura del file di input fallita: %s
apertura del large object %u fallita: %s apertura del file TOC dei large object "%s" per l'input fallita: %s
apertura del file di output "%s" fallita: %s
apertura del file di output fallita: %s
apertura del file temporaneo fallita
non è stato possibile interpretare il GRANT ACL (%s) o il REVOKE ACL (%s) per l'oggetto "%s" (%s)
non è stato possibile interpretare la ACL predefinita (%s)
non è stato possibile interpretare il GRANT ACL iniziale (%s) o il REVOKE ACL iniziale (%s) per l'oggetto "%s" (%s)
non è stato possibile interpretare l'array numerico "%s": caratteri non validi nel numero
non è stato possibile interpretare l'array numerico "%s": troppi numeri
errore nel parsing di current_schemas()
lettura del binario "%s" fallita lettura della directory "%s" fallita: %s
lettura dal file di input fallita: %s
lettura dal file di input fallita: fine del file
lettura del file di input fallita: %s
lettura del link simbolico "%s" fallita riconnessione al database fallita: %s impostazione di default_tablespace a %s fallita: %s impostazione di default_with_oids fallita: %s impostazione di search_path a "%s" fallita: %s spostamento nel file di archivio fallita: %s
impostazione della sessione utente a "%s" fallita: %s avvio della transazione database fallito decompressione dei dati fallita: %s
scrittura nel file TOC dei blob fallita
scrittura del large object fallita (risultato: %lu, previsto: %lu)
scrittura nel file di output fallita: %s
scrittura nel canale di comunicazione fallita: %s
creazione di %s "%s"
creazione %s "%s.%s"
archiviatore personalizzato la definizione della vista "%s" sembra essere vuota (lunghezza zero)
magic string non trovata nell'intestazione del file
le connessioni dirette al database non sono supportate negli archivi pre-1.3
la directory "%s" non sembra un archivio valido ("toc.dat" non esiste)
archiviatore di directory nome della directory troppo lungo: "%s"
disabilitazione trigger per %s
cancellazione di %s %s
salvataggio del contenuto della tabella "%s.%s"
abilitazione trigger per %s
inizio del loop principale parallelo
immissione restore_toc_entries_parallel
inizio di restore_toc_entries_postfork
inizio di restore_toc_entries_prefork
la voce ID %d è fuori dall'intervallo consentito -- possibile corruzione della TOC
errore durante il backup
errore durante lo spostamento nel file: %s
errore nel processo di una unità di lavoro parallela
errore di lettura del large object %u: %s errore in lettura del file TOC dei large object "%s"
errore restituito da PQputCopyData: %s errore restituito da PQputCopyEnd: %s esecuzione di %s %s
previsto %d vincolo di controllo sulla tabella "%s" ma trovato %d
previsti %d vincoli di controllo sulla tabella "%s" ma trovati %d
il formato previsto (%d) differisce dal formato trovato nel file (%d)
controllo di integrità fallito, OID padre %u della tabella "%s" (OID %u) non trovato
controllo integrità fallito, l'OID %u della tabella padre della voce OID %u di pg_rewrite non è stato trovato
controllo di integrità fallito, tabella con OID %u proprietaria della sequenza con OID %u non trovata
connessione al database fallita
riconnessione al database fallita
nome del file troppo lungo: "%s"
l'offset del file scaricato è troppo grande
ricerca dei vincoli di controllo della tabella "%s.%s"
lettura delle espressioni di default della tabella "%s.%s"
ricerca delle tabelle delle estensioni
ricerca delle relazioni di ereditarietà
lettura delle colonne e dei tipi della tabella "%s.%s"
elemento %d %s %s terminato
loop principale parallelo terminato
marcatura colonne ereditate nelle sottotabelle
trovato il blocco ID (%d) inatteso leggendo i dati -- previsto %d
funzione "%s" non trovata
identificazione dei membri delle estensioni
ripristino implicito dei soli dati
intestazione del file tar incompleta (%lu byte)
intestazione del file tar incompleta (%lu byte)
indice "%s" non trovato
il file di input sembra un dump in formato testo. Prego usare psql.
il file di input non sembra essere un archivio valido
il file di input non sembra essere un archivio valido (è troppo corto?)
il file di input è troppo corto (letti %lu, previsti 5)
errore interno -- WriteData non può essere chiamata al di fuori del contesto di una routine DataDumper
errore interno -- né th né fh specificato in tarReadRaw()
elemento ENCODING non valido: %s
OID non valido per large object
OID non valida per il large object (%u)
elemento STDSTRINGS non valido: %s
valore adnum %d non valido per la tabella "%s"
la stringa argomento (%s) non è valida per il trigger "%s" sulla tabella "%s"
binario non valido "%s" codifica client specificata "%s" non valida
il numero di colonne %d non è valido per la tabella "%s"
numerazione delle colonne non valida nella tabella "%s"
codice di compressione non valido: %d
dipendenza non valida %d
dumpId non valido %d
riga non valida nel file TOC dei large object "%s": "%s"
messaggio non valido ricevuto dal worker: "%s"
numero di job paralleli non valido
formato di output specificato "%s" non valido
emissione dei large object non supportata nel formato scelto
l'ultimo OID predefinito è %u
avvio dell'elemento %d %s %s
omesso indice per vincolo "%s"
spostamento dalla posizione %s al membro successivo alla posizione nel file %s
nessun elemento pronto
non è stato trovato nessuno schema corrispondente
nessuno schema trovato per il pattern "%s"
non è stata trovata nessuna tabella corrispondente
nessuna tabella trovata per il pattern "%s"
directory di output non specificata
compilato senza il supporto a zlib
attuale posizione nel file %s
l'opzione --if-exists richiede l'opzione -c/--clean
le opzioni --inserts/--column-inserts e -o/--oids non possono essere usate insieme
le opzioni -c/--clean e -a/--data-only non possono essere usate insieme
le opzioni -s/--schema-only e -a/--data-only non possono essere usate insieme
memoria esaurita
slot on_exit_nicely terminati
archiviatore parallelo il backup parallelo è supportato solo con il formato directory.
il ripristino in parallelo da un file che non supporta il seek non è supportato
il ripristino in parallelo da standard input non è supportato
il ripristino parallelo non è supportato con archivi eseguiti da pg_dump precedenti la versione 8.0
il ripristino parallelo non è supportato con questo formato di archivio
pclose fallita: %s pgpipe: accept della connessione fallito: codice di errore %d
pgpipe: bind fallito: codice di errore %d
pgpipe: connessione del socket fallita: codice di errore %d
pgpipe: creazione del secondo socket fallita: codice di errore %d
pgpipe: errore nella creazione del socket: codice di errore %d
pgpipe: listen fallito: codice di errore %d
pgpipe: getsockname() fallito: codice di errore %d
elaborazione di %s
elaborazione dati per la tabella "%s.%s".
elaborazione elemento %d %s %s
elaborazione dell'elemento perduto %d %s %s
query fallita: %s la query non ha prodotto nessun nome di tabella referenziata per il trigger di chiave esterna "%s" sulla tabella "%s" (OID della tabella: %u)
la query ha restituito %d riga invece di una: %s
la query ha restituito %d righe invece di una: %s
la query per ottenere i dati della sequenza "%s" ha restituito %d riga (prevista 1)
la query per ottenere i dati della sequenza "%s" ha restituito %d righe (prevista 1)
la query per ottenere dati della sequenza "%s" ha restituito il nome "%s"
la query per ottenere regole "%s" per la tabella "%s" ha fallito: ha restituito un numero errato di righe
la query per ottenere la definizione della vista "%s" ha restituito più di una definizione
la query per ottenere la definizione della vista "%s" non ha restituito dati
la query era: %s
letta voce TOC %d (ID %d) per %s %s
lettura informazioni di colonna per le tabelle interessate
lettura dei vincoli
lettura dei privilegi predefiniti
lettura dati di dipendenza
lettura dei trigger di evento
lettura delle estensioni
lettura dei vincoli di chiave esterna della tabella "%s.%s"
lettura degli indici
lettura degli indici della tabella "%s.%s"
lettura dei large object
lettura delle regole di sicurezza
lettura delle regole di sicurezza per la tabella "%s.%s"
lettura linguaggi procedurali
lettura regole di riscrittura
letture delle regole di sicurezza per riga abilitata per la tabella "%s.%s"
lettura schemi
lettura informazioni di ereditarietà delle tabelle
lettura delle trasformazioni
lettura dei trigger
lettura dei trigger della tabella "%s.%s"
lettura delle conversioni dei tipi
lettura dei metodi di accesso definiti dall'utente
lettura funzioni di aggregazione definite dall'utente
lettura degli ordini definiti dall'utente
lettura delle conversioni definite dall'utente
lettura dei server esterni definiti dall'utente
lettura dei wrapper di dati esterni definiti dall'utente
lettura funzioni definite dall'utente
lettura classi operatore definite dall'utente
lettura delle famiglie di operatori definiti dall'utente
lettura operatori definiti dall'utente
lettura delle tabelle definite dall'utente
lettura delle configurazioni di ricerca testo definite dall'utente
lettura dei dizionari di ricerca testo definiti dall'utente
lettura dei parser di ricerca testo definiti dall'utente
lettura dei modelli di ricerca testo definiti dall'utente
lettura tipi definiti dall'utente
riduzione dipendenze per %d
ripristinato %d large object
ripristinati %d large object
il ripristino dei dati fuori ordine non è supportato in questo formato di archivio: è richiesto "%s", ma nel file d'archivio viene prima di "%s".
ripristino del large object con OID %u
verifica sulla dimensione degli interi (%lu) fallita
salvataggio definizione del database
salvataggio codifica = %s
salvataggio dei large object
salvataggio del search_path = %s
salvataggio standard_conforming_strings = %s
schema "%s" non trovato
lo schema con OID %u non esiste
select() fallita: %s
per usare le opzioni di selezione schema la versione del server deve essere almeno 7.3
versione del server: %s; %s versione: %s
saltato l'elemento %d %s %s
salto del membro tar %s
operatore_di_ordinamento creazione della tabella "%s" fallita, i suoi dati non verranno ripristinati
tabella "%s" non trovata
archiviatore tar questo formato non può essere letto
trasferimento di dipendenza %d -> %d a %d
trigger "%s" non trovato
sintassi dell'istruzione COPY imprevista: "%s"
flag di offset dati non previsto %d
tipo di comando di regola di sicurezza imprevisto: "%s"
codice di sezione non prevista %d
valore tgtype inatteso: %d
formato di archivio sconosciuto "%s"; specificare "c", "d" o "t"
comando sconosciuto ricevuto dal master: "%s"
tipo di vincolo sconosciuto: %c
tipo di blocco dati sconosciuto %d durante il ripristino dell'archivio
tipo di blocco dati sconosciuto (%d) durante la ricerca in archivio
codifica sconosciuta "%s"
formato di file "%d" sconosciuto
tipo di oggetto sconosciuto nei privilegi predefiniti: %d
valore proparallel non riconosciuto per la funzione "%s"
valore provolatile sconosciuto per la funzione "%s"
versione (%d.%d) non supportata nell'intestazione del file
avvertimento dal file originale scaricato: %s
processo worker fallito: codice di uscita %d
scritto %lu byte di dati large object (risultato = %lu)
scritti %lu byte di dati large object (risultato = %lu)
locale/it/LC_MESSAGES/pg_ctl-9.6.mo 0000644 00000045466 14751153421 0012345 0 ustar 00 �� � � � < P D Q ? � � � &
0
P
- o
�
�
= �
! � A � a � K P � A � ! � 3 ? O H � D � C E a ? � ? � > ' 9 f L � B � E 0 � v 0 � F , > s 8 � I � % 5 2 [ O � 7 � & M 8 - � ! � > � E C [ y � 9 D S C � D � > ! A ` ( � , � 2 � 6 + > b * � / � % � 1 " 0 T # � � 4 � 2 � 1 / 0 a , � . � 3 � " + B 1 n 6 � : � 1 * D " o 7 � " � $ � J ] y 3 � 0 � � ! $ 6 [ - | � 4 � % � $ %! " J! ! m! F �! u �! F L" �" 7 �" ) �" k # ` u# % �# & �# #$ d +$ �$ / �$ & �$ 0 % . 7% ) f% ) �% �% �% & �%
& , +& ( X& �& ! �& �& �& �& �& ' "' 8' I' Y' j' z' " �' �' � �' E �) B * $ N* s* $ �* # �* % �* = �* 2+ P+ = h+ �+ �+ � �+ p, a �, K �, >- A Y- �- 5 �- K �- L <. Q �. U �. S 1/ D �/ M �/ C 0 ? \0 R �0 I �0 H 91 � �1 4 2 P H2 I �2 O �2 Y 33 0 �3 J �3 p 4 B z4 �4 �4 �4 \ �4 9 @5 z5 N �5 c �5 c N6 � �6 Q I7 o �7 x 8 n �8 ` �8 l T9 , �9 3 �9 A ": = d: T �: 9 �: : 1; + l; > �; : �; ) < " << ? _< A �< ; �< 3 = 0 Q= 8 �= < �= # �= 7 > A T> O �> P �> A 7? 5 y? ! �? D �? & @ 3 =@ l q@ # �@ A L #A < pA " �A * �A ( �A ' $B H LB �B > �B - �B * !C & LC # sC ] �C } �C G sD �D L �D + %E � QE z �E 5 UF - �F
�F � �F $ FG : kG . �G 4 �G +
H ' 6H ' ^H �H �H , �H & �H 4 I 4 :I oI ' �I �I �I �I ! �I J 7J XJ sJ �J �J # �J % �J # K ? L y ' { � V r � & $ o @ � � P b [ - C U � " ( _ . � ; X Y ! 6 � A B = / w � % 7 E K
v
J q c M , ~ # 3 ) 0 W � F s � ] 1 ` u } � � � h � f x m t d : z j � * g S O 9 Q D < G I 4 > 2 5 N Z � | l ^ p i + a H R n 8 � e � � T \ k
%s: -w option cannot use a relative socket directory specification
%s: -w option is not supported when starting a pre-9.1 server
Allowed signal names for kill:
Common options:
Options for register and unregister:
Options for start or restart:
Options for stop or restart:
Report bugs to <pgsql-bugs@postgresql.org>.
Shutdown modes are:
Start types are:
%s init[db] [-D DATADIR] [-s] [-o "OPTIONS"]
%s kill SIGNALNAME PID
%s promote [-D DATADIR] [-s]
%s register [-N SERVICENAME] [-U USERNAME] [-P PASSWORD] [-D DATADIR]
[-S START-TYPE] [-w] [-t SECS] [-o "OPTIONS"]
%s reload [-D DATADIR] [-s]
%s restart [-w] [-t SECS] [-D DATADIR] [-s] [-m SHUTDOWN-MODE]
[-o "OPTIONS"]
%s start [-w] [-t SECS] [-D DATADIR] [-s] [-l FILENAME] [-o "OPTIONS"]
%s status [-D DATADIR]
%s stop [-W] [-t SECS] [-D DATADIR] [-s] [-m SHUTDOWN-MODE]
%s unregister [-N SERVICENAME]
-?, --help show this help, then exit
-D, --pgdata=DATADIR location of the database storage area
-N SERVICENAME service name with which to register PostgreSQL server
-P PASSWORD password of account to register PostgreSQL server
-S START-TYPE service start type to register PostgreSQL server
-U USERNAME user name of account to register PostgreSQL server
-V, --version output version information, then exit
-W do not wait until operation completes
-c, --core-files allow postgres to produce core files
-c, --core-files not applicable on this platform
-e SOURCE event source for logging when running as a service
-l, --log=FILENAME write (or append) server log to FILENAME
-m, --mode=MODE MODE can be "smart", "fast", or "immediate"
-o OPTIONS command line options to pass to postgres
(PostgreSQL server executable) or initdb
-p PATH-TO-POSTGRES normally not necessary
-s, --silent only print errors, no informational messages
-t, --timeout=SECS seconds to wait when using -w option
-w wait until operation completes
auto start service automatically during system startup (default)
demand start service on demand
fast quit directly, with proper shutdown
immediate quit without complete shutdown; will lead to recovery on restart
smart quit after all clients have disconnected
done
failed
stopped waiting
%s is a utility to initialize, start, stop, or control a PostgreSQL server.
%s: -S option not supported on this platform
%s: PID file "%s" does not exist
%s: WARNING: cannot create restricted tokens on this platform
%s: WARNING: could not locate all job object functions in system API
%s: another server might be running; trying to start server anyway
%s: cannot be run as root
Please log in (using, e.g., "su") as the (unprivileged) user that will
own the server process.
%s: cannot promote server; server is not in standby mode
%s: cannot promote server; single-user server is running (PID: %ld)
%s: cannot reload server; single-user server is running (PID: %ld)
%s: cannot restart server; single-user server is running (PID: %ld)
%s: cannot set core file size limit; disallowed by hard limit
%s: cannot stop server; single-user server is running (PID: %ld)
%s: could not access directory "%s": %s
%s: could not allocate SIDs: error code %lu
%s: could not create promote signal file "%s": %s
%s: could not create restricted token: error code %lu
%s: could not determine the data directory using command "%s"
%s: could not find own program executable
%s: could not find postgres program executable
%s: could not open PID file "%s": %s
%s: could not open process token: error code %lu
%s: could not open service "%s": error code %lu
%s: could not open service manager
%s: could not read file "%s"
%s: could not register service "%s": error code %lu
%s: could not remove promote signal file "%s": %s
%s: could not send promote signal (PID: %ld): %s
%s: could not send reload signal (PID: %ld): %s
%s: could not send signal %d (PID: %ld): %s
%s: could not send stop signal (PID: %ld): %s
%s: could not start server
Examine the log output.
%s: could not start server: %s
%s: could not start server: error code %lu
%s: could not start service "%s": error code %lu
%s: could not unregister service "%s": error code %lu
%s: could not wait for server because of misconfiguration
%s: could not write promote signal file "%s": %s
%s: database system initialization failed
%s: directory "%s" does not exist
%s: directory "%s" is not a database cluster directory
%s: invalid data in PID file "%s"
%s: missing arguments for kill mode
%s: no database directory specified and environment variable PGDATA unset
%s: no operation specified
%s: no server running
%s: old server process (PID: %ld) seems to be gone
%s: option file "%s" must have exactly one line
%s: server does not shut down
%s: server is running (PID: %ld)
%s: service "%s" already registered
%s: service "%s" not registered
%s: single-user server is running (PID: %ld)
%s: the PID file "%s" is empty
%s: too many command-line arguments (first is "%s")
%s: unrecognized operation mode "%s"
%s: unrecognized shutdown mode "%s"
%s: unrecognized signal name "%s"
%s: unrecognized start type "%s"
(The default is to wait for shutdown, but not for start or restart.)
HINT: The "-m fast" option immediately disconnects sessions rather than
waiting for session-initiated disconnection.
If the -D option is omitted, the environment variable PGDATA is used.
Is server running?
Please terminate the single-user server and try again.
Server started and accepting connections
The program "%s" is needed by %s but was not found in the
same directory as "%s".
Check your installation.
The program "%s" was found by "%s"
but was not the same version as %s.
Check your installation.
Timed out waiting for server startup
Try "%s --help" for more information.
Usage:
WARNING: online backup mode is active
Shutdown will not complete until pg_stop_backup() is called.
Waiting for server startup...
cannot duplicate null pointer (internal error)
child process exited with exit code %d child process exited with unrecognized status %d child process was terminated by exception 0x%X child process was terminated by signal %d child process was terminated by signal %s command not executable command not found could not change directory to "%s": %s could not find a "%s" to execute could not get current working directory: %s
could not identify current directory: %s could not read binary "%s" could not read symbolic link "%s" invalid binary "%s" out of memory
pclose failed: %s server is still starting up
server promoting
server shutting down
server signaled
server started
server starting
server stopped
starting server anyway
waiting for server to shut down... waiting for server to start... Project-Id-Version: pg_ctl (PostgreSQL) 9.6
Report-Msgid-Bugs-To: pgsql-bugs@postgresql.org
POT-Creation-Date: 2016-04-17 00:14+0000
PO-Revision-Date: 2017-05-29 17:04+0100
Last-Translator: Daniele Varrazzo <daniele.varrazzo@gmail.com>
Language-Team: https://github.com/dvarrazzo/postgresql-it
Language: it
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
X-Poedit-SourceCharset: utf-8
Plural-Forms: nplurals=2; plural=n != 1;
X-Generator: Poedit 1.8.7.1
%s: l'opzione -w non può specificare una directory socket relativa
%s: l'opzione -w non è supportata per avviare un server pre-9.1
Nomi di segnali permessi per kill:
Opzioni comuni:
Opzioni per register e unregister:
Opzioni per l'avvio o il riavvio:
Opzioni per l'arresto o il riavvio:
Puoi segnalare eventuali bug a <pgsql-bugs@postgresql.org>.
I modi di spegnimento sono:
I tipi di avvio sono:
%s init[db] [-D DATADIR] [-s] [-o "OPZIONI"]
%s kill SIGNALNAME PID
%s promote [-D DATADIR] [-s]
%s register [-N SERVICENAME] [-U USERNAME] [-P PASSWORD] [-D DATADIR]
[-S START-TYPE] [-w] [-t SECS] [-o "OPZIONI"]
%s reload [-D DATADIR] [-s]
%s restart [-w] [-t SECS] [-D DATADIR] [-s] [-m SHUTDOWN-MODE]
[-o "OPZIONI"]
%s start [-w] [-t SECS] [-D DATADIR] [-s] [-l NOMEFILE] [-o "OPZIONI"]
%s status [-D DATADIR]
%s stop [-W] [-t SECS] [-D DATADIR] [-s] [-m SHUTDOWN-MODE]
%s unregister [-N SERVIZIO]
-?, --help mostra questo aiuto ed esci
-D, --pgdata DATADIR posizione dell'area di archiviazione del database
-N SERVIZIO nome del servizio con cui registrare il server PostgreSQL
-P PASSWORD password per l'account con cui registrare il server PostgreSQL
-S TIPO-AVVIO tipo di avvio del servizio con cui registrare il server PostgreSQL
-U UTENTE nome utente dell'account con cui registrare il server PostgreSQL
-V, --version mostra informazioni sulla versione ed esci
-W non aspettare finché l'operazione non è terminata
-c, --core-files permette a postgres di produrre core file
-c, --core-files non disponibile su questa piattaforma
-e SORGENTE sorgente eventi per il log quando eseguito come servizio
-l, --log NOMEFILE scrivi (o accoda) il log del server in NOMEFILE
-m, --mode=MODE MODE può essere "smart", "fast" o "immediate"
-o OPZIONI opzioni da riga di comando da passare a postgres
(programma eseguibile del server PostgreSQL)
-p PATH-TO-POSTGRES normalmente non necessario
-s, --silent mostra solo gli errori, non i messaggi di informazione
-t, --timeout=SEC secondi da aspettare quando si usa l'opzione -w
-w aspetta finché l'operazione non sia stata completata
auto avvia il servizio automaticamente durante l'avvio del sistema (predefinito)
demand avvia il servizio quando richiesto
fast termina direttamente, con una corretta procedura di arresto
immediate termina senza un arresto completo: ciò porterà ad un recupero
dei dati al riavvio
smart termina dopo che tutti i client si sono disconnessi
fatto
fallito
attesa interrotta
%s è un programma per inizializzare, avviare, fermare o controllare un server PostgreSQL.
%s: l'opzione -S non è supportata su questa piattaforma
%s: il file PID "%s" non esiste
%s: ATTENZIONE: non è possibile creare token ristretti su questa piattaforma
%s: ATTENZIONE: non tutte le funzioni di controllo dei job nella API di sistema sono state trovate
%s: un altro server potrebbe essere in esecuzione; si sta provando ad avviare il server ugualmente
%s: non può essere eseguito da root
Effettua il login (usando per esempio "su") con l'utente
(non privilegiato) che controllerà il processo server.
%s: non è possibile promuovere il server: il server non è in modalità standby
%s: non è possibile promuovere il server: il server è in esecuzione in modalità a utente singolo (PID: %ld)
%s: non è possibile eseguire il reload del server; il server è in esecuzione in modalità a utente singolo (PID: %ld)
%s: non è possibile riavviare il server; il server è in esecuzione in modalità a utente singolo (PID: %ld)
%s: non è possibile configurare il limite di grandezza dei core file; impedito dall'hard limit
%s: non è possibile fermare il server; il server è in esecuzione in modalità a utente singolo (PID: %ld)
%s: accesso alla directory "%s" fallito: %s
%s: allocazione dei SID fallita: codice errore %lu
%s: creazione del file di segnale di promozione "%s" fallito: %s
%s: creazione del token ristretto fallita: codice errore %lu
%s: non è stato possibile determinare la directory dei dati usando il comando "%s"
%s: il proprio programma eseguibile non è stato trovato
%s: il programma eseguibile postgres non è stato trovato
%s: apertura del file PID "%s" fallita: %s
%s: apertura del token di processo fallita: codice errore %lu
%s: apertura del servizio "%s" fallita: codice errore %lu
%s: apertura del service manager fallita
%s: lettura del file "%s" fallita
%s: registrazione del servizio "%s" fallita: codice errore %lu
%s: rimozione del file di segnale di promozione "%s" fallita: %s
%s: invio del segnale di promozione fallito (PID: %ld): %s
%s: invio segnale di reload fallito (PID: %ld): %s
%s: invio del segnale %d fallito (PID: %ld): %s
%s: invio del segnale di arresto fallito (PID: %ld): %s
%s: l'avvio del server è fallito
Esamina il log di output.
%s: errore di avvio del server: %s
%s: errore di avvio del server: codice dell'errore %lu
%s: non è possibile avviare il servizio "%s": codice errore %lu
%s: rimozione della registrazione del servizio "%s" fallita: codice errore %lu
%s: non è stato possibile attendere il server a causa di configurazione errata
%s: scrittura del file di segnale di promozione "%s" fallita: %s
%s: inizializzazione del sistema di database fallita
%s: la directory "%s" non esiste
%s: la directory "%s" non è la directory di un cluster di database
%s: dati non validi nel file PID "%s"
%s: mancano gli argomenti per la modalità di kill
%s: nessuna directory del database è stata specificata e la variabile d'ambiente PGDATA non è configurata
%s: nessuna operazione specificata
%s: nessun server in esecuzione
%s: il vecchio processo del server (PID: %ld) sembra non essere più attivo
%s: il file di opzione "%s" deve avere esattamente una riga
%s: il server non si è arrestato
%s: il server è in esecuzione (PID: %ld)
%s: il servizio "%s" è già registrato
%s: il servizio "%s" non è registrato
%s: il server è in esecuzione in modalità a utente singolo (PID: %ld)
%s: il file PID "%s" è vuoto
%s: troppi argomenti nella riga di comando (il primo è "%s")
%s: modalità di operazione sconosciuta "%s"
%s: modalità di arresto sconosciuta "%s"
%s: nome del segnale sconosciuto "%s"
%s: tipo di avvio sconosciuto "%s"
(Il comportamento predefinito è di aspettare lo spegnimento, ma non
l'avvio o il riavvio.)
NOTA: L'opzione "-m fast" disconnette le sessioni immediatamente invece di
attendere che siano le sessioni a disconnettersi.
Se l'opzione -D è omessa, viene usata la variabile d'ambiente PGDATA.
Il server è in esecuzione?
Si prega di terminare il server in modalità utente singolo e di riprovare.
Il server è avviato e accetta connessioni
Il programma "%s" è richiesto da %s ma non è stato trovato
nella stessa directory di "%s".
Verifica che l'installazione sia corretta.
Il programma "%s" è stato trovato da "%s" ma non ha
la stessa versione di %s.
Verifica che l'installazione sia corretta.
Il tempo di attesa per l'avvio del server è scaduto
Prova "%s --help" per maggiori informazioni.
Utilizzo:
ATTENZIONE: è attiva la modalità di backup online
L'arresto non sarà completato finché non sarà chiamata pg_stop_backup().
In attesa che il server si avvii...
impossibile duplicare il puntatore nullo (errore interno)
processo figlio uscito con codice di uscita %d processo figlio uscito con stato non riconosciuto %d processo figlio terminato da eccezione 0x%X processo figlio terminato da segnale %d processo figlio terminato da segnale %s comando non eseguibile comando non trovato spostamento nella directory "%s" fallito: %s programma "%s" da eseguire non trovato determinazione della directory corrente fallita: %s
identificazione della directory corrente fallita: %s lettura del binario "%s" fallita lettura del link simbolico "%s" fallita binario non valido "%s" memoria esaurita
pclose fallita: %s il server si sta ancora avviando
il server sta venendo promosso
il server è in fase di arresto
segnale inviato al server
il server è stato avviato
il server si sta avviando
il server è stato arrestato
il server si sta avviando comunque
in attesa dell'arresto del server.... in attesa che il server si avvii... locale/it/LC_MESSAGES/psql-9.6.mo 0000644 00000302755 14751153421 0012051 0 ustar 00 �� ; �! � �C hZ iZ Z �Z � �Z T[ p[
�[ �[ > �[ = �[ < %\ p b\ s �\ 5 G] 7 }] K �] o ^ 2 q^ 4 �^ N �^ t (_ Q �_ O �_ > ?` A ~` O �` @ a 6 Qa 0 �a N �a G b 8 Pb A �b T �b ? c L `c A �c @ �c H 0d A yd + �d � �d 5 }e 9 �e n �e Q \f : �f � �f ; vg y �g � ,h ; �h z i T i A �i L j B cj \ �j 4 k J 8k \ �k 6 �k 4 l G Ll = �l ; �l ( m ; 7m ; sm ; �m ; �m 8 'n _ `n J �n F o ` Ro h �o G p 5 dp 2 �p X �p Q &q : xq 3 �q ; �q S #r M wr 9 �r @ �r 8 @s ; ys @ �s K �s J Bt | �t �
u > �u F �u N v F ev H �v - �v $ #w & Hw - ow 9 �w 7 �w 2 x 4 Bx 3 wx ) �x ) �x ; �x B ;y ) ~y * �y * �y J �y 1 Iz . {z - �z , �z 4 { I :{ $ �{ & �{ > �{ 1 | & A| ( h| J �| : �| ( } % @} $ f} $ �} ) �} - �} N ~ 9 W~ G �~ 5 �~ M C ] P � K � N >� K �� L ـ 4 &� K [� ( �� q Ё A B� ? �� A Ă > � � E� # � F � 8 _� < �� M Յ ; #� 6 _� 2 �� 7 Ɇ B � : D� 4 � 9 �� ? � % .� + T� 9 �� 5 �� I � K :� M �� Z ԉ S /� K �� � ϊ N Z� @ �� : � ( %� B N� L �� C ތ � "� M э = � � ]� �� � /� 2� E� I� ]� m� 0 u� $ �� # ˏ * � % � * @� k� # �� < �� � � !� 6 A� x� � �� : 3� n� �� �� �� �� �� ɒ ܒ � Q � R� I f� [ ��
� � (�
=� H� f� C s� A �� �� � � � ,� 4� ;� , M� z� �� �� �� �� �� ܕ � �
� � +� 7� ' D� l� & �� ' �� 7 ٖ 0 � B� ^� n� �� �� �� �� �� w �� 5� F� [� a� {� ( �� �� ɘ ۘ � �� � 3� H� a� m� v� � �� �� �� ��
ř ә ٙ ܙ �
� �� � � � � -�
<� J�
\� j� & w� �� ��
��
Ě Қ ٚ � �
� -� @� T� g� y� �� �� �� ϛ � �� � .� @�
R� `� p� % �� �� " �� ޜ �� � 9� ' O� & w� �� �� �� ˝ ҝ �
� �� L � Q� `� ~� > �� ڞ � � 2 � M� T� g� {� �� �� �� ş ҟ ؟ � � X $� }� �� �� ��
Р ۠ � ' �� . %� ! T� ' v� �� �� ¡
̡ ڡ � � *� J� j� y� �� , �� â Ԣ � � � �� � 1� E 8� ~� �� �� �� ��
�� �� ʣ ϣ ֣ � � � � � (� 4� >� R�
X� f� ��
�� �� �� �� Ȥ ݤ �� �� ! � ?� W� 9 r� y �� 9 &� F `� 5 �� B ݦ C � 5 d� : �� 9 է @ � ; P� K �� B ب C � 6 _� 8 �� ϩ � ��
� � '� 8�
>� I� e� �� �� �� Ǫ & Ϫ �� � � $� � <� �� # � # 6� # Z� ~� " �� �� Ϭ � �� �
� � � (�
9� c D� � �� i� K �� Q Ү / $� O T� U �� 5 �� = 0� n� , z� 4 �� " ܰ ! �� !� A� N� i� " �� + �� + Ա 6 � X 7� 7 �� 8 Ȳ T � 5 V� I �� 6 ֳ #
� = 1� = o� = �� i � 9 U� �� �� * ˵ �� � 0� P� c� j� n� }� �� �� �� �� �� ö ߶ # �� "� 6� $ O� t�
�� �� �� �� �� �� ��
ȷ ַ � � ��
� � � "� C /� s� / �� ( �� ݸ � �� � "� ' >� f� $ �� % �� ! й ) � ( � / E� # u� ' �� , �� . � 4 � R� ! r� - �� » % � 4 � 1 >� - p� / �� " μ � ' � 9� . Y� ) �� % �� ! ؽ $ �� * � + J� A v� �� �� & Ѿ 0 �� . )� ) X� ) �� �� % �� �
�
� �� # � *� 7� I� [� g� s� z� �� �� �� C �� �� � 0� :� R� b� r� ��
�� �� $ �� & � - � # 0� T� 1 u� ( �� ) �� + �� ' &� ! N� p� # �� ! �� ( �� �� � 0� M� k� �� �� �� �� ��
�� �� �
� � %� 5� P� p� �� �� �� �� �� � � 7� ! R� t� �� 2 �� �� �� � !� >� _� 2 y� 5 �� �� �� � . )� X� & p� # �� �� ! �� �� � )� ;� T� 6 u� ) �� ��
�� �� �� � � %�
2� & @� g� w� �� �� �� �� �� �� �� �� � �
� � U -� �� �� �� , �� �� �� � #� 6�
J� U� d� p� y� � �� �� " ��
�� �� �� �� �� � �
6� 1 D� v� ��
�� �� �� �� . �� � . �
G� U� _� e� w� ��
�� �� E �� ��
� � '� 6� E� L� a� i� x� �� �� * �� ��
�� �� � � � '� -� 7�
H� S� \� f� v� �� �� �� �� �� �� �� �� �
� � � -�
6� D� K� R� e� n� % w� �� �� �� �� �� �� �� �� � � '� 0� :�
C� N� X� g� s� v� �� �� �� �� �� �� �� �� �� �� �� �� � � � '�
7� E� L�
^� l� {� �� �� �� �� �� �� �� �� �� ��
� � ! !� 4 C�
x� �� . �� �� �� �� �� �� � � &�
/�
=�
K� Y� l� �� �� �� �� " �� �� � $� 6� Q� n� / �� �� �� �� �� " �� � <� X� v� �� * ��
�� �� �� � !� 9� M� ]� p� �� 0 �� + �� � � � > �
X� c� ) o� " �� �� ��
�� �� �� �� � � &� +� ;� J� Y� e� j�
q� �
��
�� �� �� �� 7 �� 2 � 6 3� V j� �� & �� & �� . � D� P� `�
q�
� �� �� �� �� �� �� �� �� �� � � ! � @� H� Z� g�
w� �� �� �� �� . �� �� �� � �
:� E� U� g� s� � �� �� �� ��
�� �� �� �� �� �� � � 0� N� X� \� $ {� # �� �� �� 0 �� �
� )� 0� G� ( [� �� ��
�� �� �� �� �� �� �� �� �� � � , &� S� k� �� $ �� �� ' �� � "� A� [� s� �� �� ! �� �� �� �
� � '� � +� � " 2� U� � m� � 5� O� c� I y� L �� I � � Z� r �� 6 h� < �� H �� � %� 7 �� 9 �� { +� � �� s A� v �� D ,� F q� v �� D /� ? t� 4 �� t �� w ^� > �� ? � r U� A �� w
� q �� I �� y >� I �� 0 � � 3� 8 �� 9
� � D� W �� > 5� � t� ?
� { J� � � G e� ~ �� [ ,� O �� R � I +� f u� 8 � Q � n g� ? � ? � G V� = �� ; � 2 � D K� ; �� ; � ; � 7 D� d |� F � H (� Y q� o � M ;� D �� 0 � m �� P m� E �� 5 < : j w t � < W L � @ � w " @ � } � R Y � � � 1 7 � K � K D O � L � 4 - 7 b ) � 3 � C � = < B z > � 8 � 0 5 / f C � G � < " - _ ; � O � 8
1 R
3 �
: �
: �
Q . ( � + � M � 8 # + \ . � n � G &
, n
+ �
( �
) �
. 4 I r ~ > � n 0 A � \ � S > z � s
S � T � x * 3 � l � + D u p l � = S G � P � � * & � q
> | A � � � D � ? � < ? I b � 8 � 8 % ; ^ c � & � * % C P 4 � S � \ Z z e � c ; Q � � � U ~ F � @ - \ L � \ � I 4 � ~ Y T! D �! � �! �" �" �" �" �" �" # # ; # 0 S# / �# 9 �# . �# 6 $ . T$ + �$ H �$ �$ % ( /% I X% �% � �% : `& �&
�& �& �& �& �& �& ' '' i <' �' A �' R ( S( ]( q( �( ' �( �( n �( r A) �) �) �) �) �) * * . * O* f* s*
{* �* �* �* - �* ( �* + + %+ 1+ >+ 7 H+ ) �+ 6 �+ 3 �+ L , I b, �, �, �, �, - - %- .- � ;- �- �- �- + �- & . 5 G. }. �. �. �. ( �. �. / " / C/ R/ [/ e/ x/ �/ �/ �/ �/ �/ �/
�/ �/ �/ �/ 0 0 0 0 10
@0 N0 a0 n0 + z0
�0
�0 �0 �0 �0 �0 1 1 >1 ^1 v1 �1 �1 �1 �1 �1 �1 ! 2 ;2 ! P2 r2 �2 �2 �2 �2 �2 �2 3 + $3 $ P3 ) u3 " �3 " �3 E �3 @ +4 l4 v4 �4 �4 �4 �4 �4 �4 �4 i �4 Q5 * g5 - �5 O �5 6 ,6 % K6 5 q6 �6 �6 �6 �6 �6 7 7 ,7 =7 J7 ) f7 �7 l �7 8 !8 ' @8 h8
�8 �8 �8 . �8 8 �8 ) '9 0 Q9 �9 ! �9 �9
�9 �9 " �9 ! : % 0: ) V: �: �: �: < �: �: ; ; &;
,; 7; ! P; r; J z;
�; �; �; �; �;
�; <
< < (< 8< I< d< s< <
�< �< �< �< �< $ �< / �<
(= 3= D= H= $ W= / |= �= $ �= ' �= " > $ $> 1 I> � {> 8 ? K >? 6 �? N �? P @ 4 a@ 5 �@ 6 �@ @ A ; DA F �A U �A Y B 3 wB = �B �B C C 5C NC bC C
�C " �C % �C �C " �C D D - &D 1 TD , �D �D # �D � �D �E ) �E - �E 2 *F ]F ( xF �F
�F �F �F
�F �F
G G
G &G 9G � EG �G �H O �H Z BI , �I V �I [ !J 5 }J E �J �J 4 K ? ;K 3 {K ( �K " �K �K L ! $L & FL - mL ) �L L �L k M 7 ~M ; �M c �M 3 VN Y �N < �N ' !O G IO K �O P �O o .P B �P �P & Q 1 (Q ZQ tQ * �Q �Q �Q �Q �Q �Q R R
R #R *R ;R UR + sR �R �R # �R �R S S S &S /S 8S AS KS ZS dS nS }S �S �S �S �S H �S T : T B ST �T �T �T �T # �T 0 U ) 6U ' `U ( �U # �U * �U , V 3 -V % aV ( �V 1 �V 2 �V 9 W # OW # sW 2 �W $ �W & �W < X 7 SX 9 �X 4 �X # �X ( Y , GY " tY 5 �Y - �Y ' �Y " #Z % FZ 0 lZ 2 �Z G �Z [ [ . 1[ 4 `[ + �[ ' �[ ' �[ \ * #\ N\
U\ `\ o\ ! {\
�\ �\ �\ �\ �\ �\ �\ ] ] ] T 3] ) �] �]
�] �] �] �]
^ *^ 6^ >^ ' K^ , s^ 9 �^ ( �^ & _ 3 *_ 4 ^_ % �_ ' �_ . �_ . ` ?` & `` ' �` 7 �` * �` a ,a 1 La $ ~a �a �a �a �a �a
�a ! b .b :b Jb Wb $ lb & �b ' �b �b �b ! c Ac + \c $ �c ! �c # �c * �c d ;d ? Pd ( �d �d ' �d & �d ) %e ) Oe @ ye C �e �e ) f =f 1 Tf �f 3 �f . �f 0 g + 3g " _g �g �g �g + �g E h . Jh
yh �h �h �h �h �h
�h �h : �h :i Ji Ti ^i ki �i �i �i �i ) �i �i �i
j
j W !j yj �j �j 0 �j �j " �j k 3k Ik _k kk
{k �k �k �k �k �k 5 �k l l
l
+l 6l Ml $ Vl
{l - �l �l �l �l �l �l m 2 "m
Um 5 `m �m
�m �m �m �m
�m �m �m C
n Qn
bn pn �n �n �n �n �n �n �n �n o 7 &o
^o io uo �o �o �o �o �o �o
�o �o �o �o �o p p )p 6p $ Tp yp
�p �p �p �p �p �p �p �p �p �p q q q & %q Lq Sq dq uq zq �q �q �q �q �q
�q �q �q r
r $r 5r Dr Gr " \r r �r
�r �r �r �r �r
�r �r �r �r s
s s (s ;s Js Rs hs ys �s �s �s �s
�s �s �s �s �s t t #t -t ' 7t 8 _t �t �t 2 �t �t �t �t u &u 7u Cu ]u iu
xu �u �u �u �u �u v v & 1v Xv " tv �v �v ! �v ! �v 7 w Iw \w qw �w + �w & �w ( �w # x ;x Vx 7 ix �x �x �x �x y +y By Ty iy �y B �y 4 �y z (z 1z B 9z |z �z 6 �z ' �z �z { {
%{ 0{ 3 @{ t{
{{ �{ �{ �{ �{ �{ �{ �{
�{ �{
�{ | | $| 3| H C| 5 �| 7 �| k �| f} / l} . �} 2 �} �}
~ "~ 5~ N~ ]~ n~
~~ �~ �~ �~ �~ �~ �~ �~
�~ " 1 M
a
o z � � � < � � � � /� M� Z� j� }� �� �� �� �� �� Ā
ـ � �� � � ( !� J� O� ! p� �� �� �� ( � � � > "�
a� % l� �� �� �� 5 � � "� .� =� R� Y� `� i� ! o� �� �� �� ) � � � ) <� f� * z� �� " ń � � � @� ! Z� % |� �� ��
��
΅ م � n J � � � � � � � � ) B 5 � L ( $ � � � \ j e ( � � � & � � � k � 7 , � � � � � 0 v � � �
z � S q < � v � | � � z � � � � f y � � M 3 Z � � d i
* � B � � ; & � � � * P 7 � : � ' � T � � 4 � � / t � � @ Y u � 0 � � � � t � - , � � � � J s ~ r � F p R � � � � � � N 3 � D � S � � Q � y � c � � � E w _ m � � � � M � , � ^ T � X b + 4 ` � � � � w � � � o < � � � � [ � - / � � � 7 � y j 5 � � & � = � U l � � � � g � � X ( � � ] � f x � } � ) � � # r � � � T � v 1 X [ � G � b 1 � � � # � k K � � : � � � 1 � 2 * ] W � s � % � u C � H g V x S � � � � H e � 8 [ Q � 7 � � � j c � � � � � � � � / 4 � � � 2 � � � � O q � � � i a h �
� � � � � � � � � � N � � � � 9 p w � � � o = � � R . � � ) � � � � � g � 9 > L ( � � b � z x � � � U x E � G � � � � � � Y � � A � � � � � ~ � � � � � v k 8 = C � 2 � � � n � Z � � 6 � r � � � � " � ? u t � u L a � � � � � p Y � ; � � � � g h � � 9 2 � � + � � i � � � G � � � � � � | � p K � \ � � � � � _ > N E Z h B m � � � q � � 9 J � � 5 � . � � � � O } . $ � � � F � � ( � { X � M
� � � n � ! � � r � h # � � � � [ � � � I 1 I 4 � �
P � � � � � � k � � � � � 0 � � V 6 P � " ` N O V o � I � � ; � t ! � & m 0 � W f @ � a : 7 ; R B H � K ] � � T � � � � 8 � � d E � � ~ ? � � 0 5 � � > " � � � Q % * � o & A y � L $ � � � { < � ~ ! ^ � ! @ � � : C F � � � � � 8 U ' � � m $ � � \ � � � � � � � = - n � � � W � A � � � _ ` Q �
' W D ^ j w " � � � � � � M � � � � � � � A � � l # � � � � � _ � � { O F Y 2 c � � f ? � � � � e } $ { � � % D � � � � � � � # , ) H ? q | � - + � � � : � � � � � �
b � < � - � I 6 \ ] � ; � % �
|
� � D . � s @ � � � � � � a 3 � � / ' � � ' 1 � s 9 � � ! c � � � � � / " J � d � � � � � � � � 3 � � > % � ) � � � 4 � l � � 3 � � � � � 8 � � � . � U � � � � * � � � � � � 6 � K ,
� � l � � � � i � S ^ � � ` � � V 6 P � G } � � R � C d + Z � � � z � � � � � + � � � 5 e
Connection options:
Display settings:
Environment variables:
For more information, type "\?" (for internal commands) or "\help" (for SQL
commands) from within psql, or consult the psql section in the PostgreSQL
documentation.
Input and output options:
Output format options:
Parser: "%s"
Parser: "%s.%s" --help=commands list backslash commands, then exit
--help=variables list special variables, then exit
(options: S = show system objects, + = additional detail)
-0, --record-separator-zero
set record separator for unaligned output to zero byte
-1 ("one"), --single-transaction
execute as a single transaction (if non-interactive)
-?, --help[=options] show this help, then exit
-A, --no-align unaligned table output mode
-E, --echo-hidden display queries that internal commands generate
-F, --field-separator=STRING
field separator for unaligned output (default: "%s")
-H, --html HTML table output mode
-L, --log-file=FILENAME send session log to file
-P, --pset=VAR[=ARG] set printing option VAR to ARG (see \pset command)
-R, --record-separator=STRING
record separator for unaligned output (default: newline)
-S, --single-line single-line mode (end of line terminates SQL command)
-T, --table-attr=TEXT set HTML table tag attributes (e.g., width, border)
-U, --username=USERNAME database user name (default: "%s")
-V, --version output version information, then exit
-W, --password force password prompt (should happen automatically)
-X, --no-psqlrc do not read startup file (~/.psqlrc)
-a, --echo-all echo all input from script
-b, --echo-errors echo failed commands
-c, --command=COMMAND run only single command (SQL or internal) and exit
-d, --dbname=DBNAME database name to connect to (default: "%s")
-e, --echo-queries echo commands sent to server
-f, --file=FILENAME execute commands from file, then exit
-h, --host=HOSTNAME database server host or socket directory (default: "%s")
-l, --list list available databases, then exit
-n, --no-readline disable enhanced command line editing (readline)
-o, --output=FILENAME send query results to file (or |pipe)
-p, --port=PORT database server port (default: "%s")
-q, --quiet run quietly (no messages, only query output)
-s, --single-step single-step mode (confirm each query)
-t, --tuples-only print rows only
-v, --set=, --variable=NAME=VALUE
set psql variable NAME to VALUE
(e.g., -v ON_ERROR_STOP=1)
-w, --no-password never prompt for password
-x, --expanded turn on expanded table output
-z, --field-separator-zero
set field separator for unaligned output to zero byte
AUTOCOMMIT if set, successful SQL commands are automatically committed
COLUMNS number of columns for wrapped format
COMP_KEYWORD_CASE determines the case used to complete SQL key words
[lower, upper, preserve-lower, preserve-upper]
DBNAME the currently connected database name
ECHO controls what input is written to standard output
[all, errors, none, queries]
ECHO_HIDDEN if set, display internal queries executed by backslash commands;
if set to "noexec", just show without execution
ENCODING current client character set encoding
FETCH_COUNT the number of result rows to fetch and display at a time
(default: 0=unlimited)
HISTCONTROL controls command history [ignorespace, ignoredups, ignoreboth]
HISTFILE file name used to store the command history
HISTSIZE the number of commands to store in the command history
HOST the currently connected database server host
IGNOREEOF if unset, sending an EOF to interactive session terminates application
LASTOID value of the last affected OID
NAME=VALUE [NAME=VALUE] psql ...
or \setenv NAME [VALUE] inside psql
ON_ERROR_ROLLBACK if set, an error doesn't stop a transaction (uses implicit savepoints)
ON_ERROR_STOP stop batch execution after error
PAGER name of external pager program
PGAPPNAME same as the application_name connection parameter
PGDATABASE same as the dbname connection parameter
PGHOST same as the host connection parameter
PGPASSFILE password file name
PGPASSWORD connection password (not recommended)
PGPORT same as the port connection parameter
PGUSER same as the user connection parameter
PORT server port of the current connection
PROMPT1 specifies the standard psql prompt
PROMPT2 specifies the prompt used when a statement continues from a previous line
PROMPT3 specifies the prompt used during COPY ... FROM STDIN
PSQLRC alternative location for the user's .psqlrc file
PSQL_EDITOR, EDITOR, VISUAL
editor used by the \e, \ef, and \ev commands
PSQL_EDITOR_LINENUMBER_ARG
how to specify a line number when invoking the editor
PSQL_HISTORY alternative location for the command history file
QUIET run quietly (same as -q option)
SHELL shell used by the \! command
SHOW_CONTEXT controls display of message context fields [never, errors, always]
SINGLELINE end of line terminates SQL command mode (same as -S option)
SINGLESTEP single-step mode (same as -s option)
TMPDIR directory for temporary files
USER the currently connected database user
VERBOSITY controls verbosity of error reports [default, verbose, terse]
\! [COMMAND] execute command in shell or start interactive shell
\? [commands] show help on backslash commands
\? options show help on psql command-line options
\? variables show help on special variables
\C [STRING] set table title, or unset if none
\H toggle HTML output mode (currently %s)
\T [STRING] set HTML <table> tag attributes, or unset if none
\a toggle between unaligned and aligned output mode
\c[onnect] {[DBNAME|- USER|- HOST|- PORT|-] | conninfo}
connect to new database (currently "%s")
\c[onnect] {[DBNAME|- USER|- HOST|- PORT|-] | conninfo}
connect to new database (currently no connection)
\cd [DIR] change the current working directory
\conninfo display information about current connection
\copy ... perform SQL COPY with data stream to the client host
\copyright show PostgreSQL usage and distribution terms
\crosstabview [COLUMNS] execute query and display results in crosstab
\dA[+] [PATTERN] list access methods
\dC[+] [PATTERN] list casts
\dD[S+] [PATTERN] list domains
\dE[S+] [PATTERN] list foreign tables
\dF[+] [PATTERN] list text search configurations
\dFd[+] [PATTERN] list text search dictionaries
\dFp[+] [PATTERN] list text search parsers
\dFt[+] [PATTERN] list text search templates
\dL[S+] [PATTERN] list procedural languages
\dO[S+] [PATTERN] list collations
\dT[S+] [PATTERN] list data types
\d[S+] list tables, views, and sequences
\d[S+] NAME describe table, view, sequence, or index
\da[S] [PATTERN] list aggregates
\db[+] [PATTERN] list tablespaces
\dc[S+] [PATTERN] list conversions
\dd[S] [PATTERN] show object descriptions not displayed elsewhere
\ddp [PATTERN] list default privileges
\des[+] [PATTERN] list foreign servers
\det[+] [PATTERN] list foreign tables
\deu[+] [PATTERN] list user mappings
\dew[+] [PATTERN] list foreign-data wrappers
\df[antw][S+] [PATRN] list [only agg/normal/trigger/window] functions
\dg[S+] [PATTERN] list roles
\di[S+] [PATTERN] list indexes
\dl list large objects, same as \lo_list
\dm[S+] [PATTERN] list materialized views
\dn[S+] [PATTERN] list schemas
\do[S] [PATTERN] list operators
\dp [PATTERN] list table, view, and sequence access privileges
\drds [PATRN1 [PATRN2]] list per-database role settings
\ds[S+] [PATTERN] list sequences
\dt[S+] [PATTERN] list tables
\du[S+] [PATTERN] list roles
\dv[S+] [PATTERN] list views
\dx[+] [PATTERN] list extensions
\dy [PATTERN] list event triggers
\e [FILE] [LINE] edit the query buffer (or file) with external editor
\echo [STRING] write string to standard output
\ef [FUNCNAME [LINE]] edit function definition with external editor
\encoding [ENCODING] show or set client encoding
\errverbose show most recent error message at maximum verbosity
\ev [VIEWNAME [LINE]] edit view definition with external editor
\f [STRING] show or set field separator for unaligned query output
\g [FILE] or ; execute query (and send results to file or |pipe)
\gexec execute query, then execute each value in its result
\gset [PREFIX] execute query and store results in psql variables
\h [NAME] help on syntax of SQL commands, * for all commands
\i FILE execute commands from file
\ir FILE as \i, but relative to location of current script
\l[+] [PATTERN] list databases
\lo_export LOBOID FILE
\lo_import FILE [COMMENT]
\lo_list
\lo_unlink LOBOID large object operations
\o [FILE] send all query results to file or |pipe
\p show the contents of the query buffer
\password [USERNAME] securely change the password for a user
\prompt [TEXT] NAME prompt user to set internal variable
\pset [NAME [VALUE]] set table output option
(NAME := {border|columns|expanded|fieldsep|fieldsep_zero|
footer|format|linestyle|null|numericlocale|pager|
pager_min_lines|recordsep|recordsep_zero|tableattr|title|
tuples_only|unicode_border_linestyle|
unicode_column_linestyle|unicode_header_linestyle})
\q quit psql
\qecho [STRING] write string to query output stream (see \o)
\r reset (clear) the query buffer
\s [FILE] display history or save it to file
\set [NAME [VALUE]] set internal variable, or list all if no parameters
\setenv NAME [VALUE] set or unset environment variable
\sf[+] FUNCNAME show a function's definition
\sv[+] VIEWNAME show a view's definition
\t [on|off] show only rows (currently %s)
\timing [on|off] toggle timing of commands (currently %s)
\unset NAME unset (delete) internal variable
\w FILE write query buffer to file
\watch [SEC] execute query every SEC seconds
\x [on|off|auto] toggle expanded output (currently %s)
\z [PATTERN] same as \dp
border border style (number)
columns target width for the wrapped format
expanded (or x) expanded output [on, off, auto]
fieldsep field separator for unaligned output (default "%s")
fieldsep_zero set field separator for unaligned output to zero byte
footer enable or disable display of the table footer [on, off]
format set output format [unaligned, aligned, wrapped, html, asciidoc, ...]
linestyle set the border line drawing style [ascii, old-ascii, unicode]
null set the string to be printed in place of a null value
numericlocale enable or disable display of a locale-specific character to separate
groups of digits [on, off]
pager control when an external pager is used [yes, no, always]
psql --pset=NAME[=VALUE]
or \pset NAME [VALUE] inside psql
psql --set=NAME=VALUE
or \set NAME VALUE inside psql
psql [OPTION]... [DBNAME [USERNAME]]
recordsep record (line) separator for unaligned output
recordsep_zero set record separator for unaligned output to zero byte
set NAME=VALUE
psql ...
or \setenv NAME [VALUE] inside psql
tableattr (or T) specify attributes for table tag in html format or proportional
column widths for left-aligned data types in latex-longtable format
title set the table title for any subsequently printed tables
tuples_only if set, only actual table data is shown
unicode_border_linestyle
unicode_column_linestyle
unicode_header_linestyle
set the style of Unicode line drawing [single, double]
"%s.%s" is not a view
%d connection %d connections %s %s %s (every %gs)
%s
%s (%s, server %s)
%s (every %gs)
%s: %s
%s: -1 can only be used in non-interactive mode
%s: cannot copy from/to a directory
%s: could not delete variable "%s"
%s: could not find own program executable
%s: could not open log file "%s": %s
%s: could not set printing parameter "%s"
%s: could not set variable "%s"
%s: current transaction is aborted
%s: invalid encoding name or conversion procedure not found
%s: not connected to a database
%s: out of memory
%s: unknown transaction status
%s: warning: extra command-line argument "%s" ignored
(%lu row) (%lu rows) ***(Single step mode: verify command)*******************************************
%s
***(press return to proceed or enter x and return to cancel)********************
********* QUERY **********
%s
**************************
+ opt(%d) = |%s|
, clustered , deferrable , initially deferred , invalid , predicate (%s) , replica identity , tablespace "%s" Access privileges All connection parameters must be supplied because no database connection exists
Argument data types Asynchronous notification "%s" received from server process with PID %d.
Asynchronous notification "%s" with payload "%s" received from server process with PID %d.
Attributes Available help:
Border style is %d.
Bypass RLS COPY data transfer failed: %s Call Handler Cannot add cell to table content: total cell count of %d exceeded.
Cannot add header to table content: column count of %d exceeded.
Cannot login Check Check constraints: Child tables Collate Column Column privileges Command: %s
Description: %s
Syntax:
%s
Composite type "%s.%s" Connection
Create DB Create role Ctype Database Default access privileges Default footer is off.
Default footer is on.
Default? Definition Description Destination Dictionaries Did not find any extension named "%s".
Did not find any extensions.
Did not find any relation named "%s".
Did not find any relation with OID %s.
Did not find any text search configuration named "%s".
Did not find any text search parser named "%s".
Disabled internal triggers: Disabled rules: Disabled triggers: Disabled user triggers: Elements Enabled Encoding End parse Enter data to be copied followed by a newline.
End with a backslash and a period on a line by itself, or an EOF signal. Enter it again: Enter new password: Event Expanded display is off.
Expanded display is on.
Expanded display is used automatically.
FDW Options FDW Options: (%s) Failed.
Field separator is "%s".
Field separator is zero byte.
Foreign table "%s.%s" Foreign-data wrapper Foreign-key constraints: Formatting
Function General
General options:
Get headline Get next token Get token types Handler Has OIDs: yes Help
ID Implicit? Index Index "%s.%s" Indexes: Informational
Inherits Init Init options Inline Handler Input/Output
Internal Language Internal name Interrupted
Invalid command \%s. Try \? for help.
Language Large Objects
Large objects Left arg type Lexize Line style is %s.
List of access methods List of aggregate functions List of casts List of collations List of conversions List of data types List of databases List of domains List of event triggers List of foreign servers List of foreign tables List of foreign-data wrappers List of functions List of installed extensions List of languages List of operators List of relations List of roles List of schemas List of settings List of specially treated variables
List of tablespaces List of text search configurations List of text search dictionaries List of text search parsers List of text search templates List of user mappings Locale-adjusted numeric output is off.
Locale-adjusted numeric output is on.
Location Materialized view "%s.%s" Member of Method Modifier Modifiers Name No changes No connections No help available for "%s".
Try \h with no arguments to see available help.
No inheritance No matching relations found.
No matching settings found.
No per-database role settings support in this server version.
No relations found.
No settings found.
Null display is "%s".
Number of child tables: %d (Use \d+ to list them.) Object Object Description Object descriptions Objects in extension "%s" Operating System
Options Output format is %s.
Owned by: %s Owner Pager is always used.
Pager is used for long output.
Pager usage is off.
Pager won't be used for less than %d line.
Pager won't be used for less than %d lines.
Parallel Password encryption failed.
Password for user %s: Password valid until Password: Passwords didn't match.
Policies Policies (forced row security enabled): Policies (forced row security enabled): (none) Policies (row security disabled): Policies (row security enabled): (none) Policies: Previous connection kept
Procedure Query Buffer
Query buffer is empty. Query buffer reset (cleared). Record separator is "%s".
Record separator is <newline>.
Record separator is zero byte.
Referenced by: Replica Identity Replication Report bugs to <pgsql-bugs@postgresql.org>.
Result data type Result type Right arg type Role Role name Rules firing always: Rules firing on replica only: Rules: SSL connection (protocol: %s, cipher: %s, bits: %s, compression: %s)
STATEMENT: %s
Schema Security Sequence "%s.%s" Server Server: %s Settings Size Source Source code Source type Special relation "%s.%s" Start parse Stats target Storage Succeeded.
Superuser TOAST table "%s.%s" Table Table "%s.%s" Table attributes are "%s".
Table attributes unset.
Tablespace Tablespace: "%s" Tags Target type Target width is %d.
Target width is unset.
Template Text search configuration "%s" Text search configuration "%s.%s" Text search parser "%s" Text search parser "%s.%s" The connection to the server was lost. Attempting reset: The input is a PostgreSQL custom-format dump.
Use the pg_restore command-line client to restore this dump to a database.
The server (version %s) does not support access methods.
The server (version %s) does not support altering default privileges.
The server (version %s) does not support collations.
The server (version %s) does not support editing function source.
The server (version %s) does not support editing view definitions.
The server (version %s) does not support extensions.
The server (version %s) does not support foreign servers.
The server (version %s) does not support foreign tables.
The server (version %s) does not support foreign-data wrappers.
The server (version %s) does not support full text search.
The server (version %s) does not support savepoints for ON_ERROR_ROLLBACK.
The server (version %s) does not support showing function source.
The server (version %s) does not support showing view definitions.
The server (version %s) does not support tablespaces.
The server (version %s) does not support user mappings.
There is no previous error. Time: %.3f ms
Timing is off. Timing is on. Title is "%s".
Title is unset.
Token Token name Token types for parser "%s" Token types for parser "%s.%s" Triggers firing always: Triggers firing on replica only: Triggers: Trusted Try "%s --help" for more information.
Tuples only is off.
Tuples only is on.
Type Type "help" for help.
Type: \copyright for distribution terms
\h for help with SQL commands
\? for help with psql commands
\g or terminate with semicolon to execute query
\q to quit
Typed table of type: %s Unicode border line style is "%s".
Unicode column line style is "%s".
Unicode header line style is "%s".
Unlogged index "%s.%s" Unlogged materialized view "%s.%s" Unlogged table "%s.%s" Usage:
Use "\q" to leave %s.
User name Validator Value Variables
Version View "%s.%s" View definition: Volatility WARNING: %s major version %s, server major version %s.
Some psql features might not work.
WARNING: Console code page (%u) differs from Windows code page (%u)
8-bit characters might not work correctly. See psql reference
page "Notes for Windows users" for details.
Wrote history to file "%s".
You are connected to database "%s" as user "%s" on host "%s" at port "%s".
You are connected to database "%s" as user "%s" via socket in "%s" at port "%s".
You are currently not connected to a database.
You are now connected to database "%s" as user "%s" on host "%s" at port "%s".
You are now connected to database "%s" as user "%s" via socket in "%s" at port "%s".
You are now connected to database "%s" as user "%s".
You are using psql, the command-line interface to PostgreSQL. \!: failed
\%s: could not change directory to "%s": %s
\%s: environment variable name must not contain "="
\%s: error while setting variable
\%s: extra argument "%s" ignored
\%s: missing required argument
\connect: %s \copy: arguments required
\copy: parse error at "%s"
\copy: parse error at end of line
\crosstabview: ambiguous column name: "%s"
\crosstabview: column name not found: "%s"
\crosstabview: column number %d is out of range 1..%d
\crosstabview: data column must be specified when query returns more than three columns
\crosstabview: maximum number of columns (%d) exceeded
\crosstabview: query must return at least three columns
\crosstabview: query result contains multiple data values for row "%s", column "%s"
\crosstabview: statement did not return a result set
\crosstabview: vertical and horizontal headers must be different columns
\df does not take a "w" option with server version %s
\df only takes [antwS+] as options
\pset: allowed Unicode border line styles are single, double
\pset: allowed Unicode column line styles are single, double
\pset: allowed Unicode header line styles are single, double
\pset: allowed formats are unaligned, aligned, wrapped, html, asciidoc, latex, latex-longtable, troff-ms
\pset: allowed line styles are ascii, old-ascii, unicode
\pset: unknown option: %s
\watch cannot be used with COPY
\watch cannot be used with an empty query
abbreviated_grant_or_revoke abort the current transaction aborted because of read failure access_method_type action agg aggregate_name aggregate_signature alias alignment allowconn always analyze_function and aggregate_signature is: and conflict_action is one of: and grouping_element can be one of: and like_option is: and table_constraint is: and table_constraint_using_index is: and with_query is: arg_data_type arg_name arg_type argmode argname argtype argument argument_type arguments attribute attribute_name attribute_option base_type boolean cache call_handler cancel a transaction that was earlier prepared for two-phase commit canceled by user cannot duplicate null pointer (internal error)
cannot escape without active connection
canonical_function category change a database change a database role change a run-time parameter change a server configuration parameter change role name or membership change the definition of a collation change the definition of a conversion change the definition of a domain change the definition of a foreign server change the definition of a foreign table change the definition of a foreign-data wrapper change the definition of a function change the definition of a large object change the definition of a materialized view change the definition of a procedural language change the definition of a row level security policy change the definition of a rule change the definition of a schema change the definition of a sequence generator change the definition of a table change the definition of a tablespace change the definition of a text search configuration change the definition of a text search dictionary change the definition of a text search parser change the definition of a text search template change the definition of a trigger change the definition of a type change the definition of a user mapping change the definition of a view change the definition of an aggregate function change the definition of an event trigger change the definition of an extension change the definition of an index change the definition of an operator change the definition of an operator class change the definition of an operator family change the ownership of database objects owned by a database role channel check_expression child process exited with exit code %d child process exited with unrecognized status %d child process was terminated by exception 0x%X child process was terminated by signal %d child process was terminated by signal %s close a cursor cluster a table according to an index code collatable collate %s collation collect statistics about a database column_alias column_constraint column_definition column_name column_type com_op combinefunc command command not executable command not found commit a transaction that was earlier prepared for two-phase commit commit the current transaction compute a set of rows condition configuration_parameter conflict_action conflict_target connection to server was lost
connlimit constraint constraint_name copy data between a file and a table could not change directory to "%s": %s could not close pipe to external command: %s
could not execute command "%s": %s
could not find a "%s" to execute could not get home directory for user ID %ld: %s
could not identify current directory: %s could not locate temporary directory: %s
could not look up effective user ID %ld: %s could not open temporary file "%s": %s
could not parse reloptions array
could not read binary "%s" could not read from input file: %s
could not read symbolic link "%s" could not save history to file "%s": %s
could not set variable "%s"
could not start /bin/sh
could not start editor "%s"
could not stat file "%s": %s
could not write COPY data: %s
count create a new database create new rows in a table cursor_name data_type database_name deallocate a prepared statement default default %s default_expr define a cursor define a new access method define a new aggregate function define a new cast define a new collation define a new data type define a new database role define a new domain define a new encoding conversion define a new event trigger define a new foreign server define a new foreign table define a new foreign-data wrapper define a new function define a new index define a new mapping of a user to a foreign server define a new materialized view define a new operator define a new operator class define a new operator family define a new procedural language define a new rewrite rule define a new row level security policy for a table define a new savepoint within the current transaction define a new schema define a new sequence generator define a new table define a new table from the results of a query define a new tablespace define a new text search configuration define a new text search dictionary define a new text search parser define a new text search template define a new transform define a new trigger define a new view define access privileges define default access privileges define or change a security label applied to an object define or change the comment of an object definer definition delete delete rows of a table delimiter delimiter_character deserialfunc dest_encoding destroy a previously defined savepoint dictionary_name direction directory disabled discard session state domain constraint domain_constraint domain_name element empty a table or set of tables enabled encoding encoding_name end_function environment variable PSQL_EDITOR_LINENUMBER_ARG must be set to specify a line number
escape_character event exclude_element exclude_element in an EXCLUDE constraint is: execute a prepared statement execute an anonymous code block execution_cost existing_collation existing_enum_value expression extension_name family_name fdw_name ffunc filename filter_variable for table "%s.%s" force a transaction log checkpoint foreign table format_name from_item from_list from_sql_function_name function function name is required
function_name garbage-collect and optionally analyze a database generate a notification gettoken_function group_name grouping_element handler_function headline_function history is not supported by this installation
immutable import table definitions from a foreign server in assignment increment index index_column_name index_expression index_method index_name index_parameters index_parameters in UNIQUE, PRIMARY KEY, and EXCLUDE constraints are: index_predicate init_function initial_condition inline_handler input_function insert install an extension integer internallength invalid binary "%s" invalid command \%s
invalid line number: %s
invalid output format (internal error): %d invoker istemplate join_column join_condition join_proc join_type label lang_name large_object_oid lc_collate lc_ctype left_type lexize_function lextypes_function like_option like_type link_symbol listen for a notification load a shared library file local socket local_schema locale lock a table lockmode loid materialized view maxvalue member_object method mffunc minitial_condition minvalue minvfunc more than one row returned for \gset
msfunc mstate_data_size mstate_data_type name neg_op new_attribute_name new_column_name new_constraint_name new_dictionary new_enum_value new_name new_owner new_role new_schema new_table new_tablespace new_version no no query buffer
no rows returned for \gset
normal not null null_string obj_file object_name off old_dictionary old_role old_version on op_type opclass operator operator class operator family operator_name option or the old syntax out of memory out of memory
output_expression output_function output_name parameter parent_table parser_name password payload pclose failed: %s policy_name position a cursor predicate preferred prepare a statement for execution prepare the current transaction for two-phase commit primary key, provider psql is the PostgreSQL interactive terminal.
psql variables:
query quote_character rebuild indexes receive_function refcolumn referenced_table_name reftable relation_name remote_schema remove a cast remove a collation remove a conversion remove a data type remove a database remove a database role remove a domain remove a foreign server descriptor remove a foreign table remove a foreign-data wrapper remove a function remove a materialized view remove a procedural language remove a rewrite rule remove a row level security policy from a table remove a schema remove a sequence remove a table remove a tablespace remove a text search configuration remove a text search dictionary remove a text search parser remove a text search template remove a transform remove a trigger remove a user mapping for a foreign server remove a view remove access privileges remove an access method remove an aggregate function remove an event trigger remove an extension remove an index remove an operator remove an operator class remove an operator family remove database objects owned by a database role replace the contents of a materialized view replica res_proc restart restore the value of a run-time parameter to the default value restricted result_rows retrieve rows from a query using a cursor retrieve rows from a table or view rettype rewrite_rule_name right_type role_name role_specification roll back to a savepoint rule rule_name safe sampling_method savepoint_name schema_element schema_name seed select send_function sequence sequence_name serialfunc server_name server_type server_version set constraint check timing for the current transaction set the characteristics of the current transaction set the current user identifier of the current session set the session user identifier and the current user identifier of the current session sfunc show the execution plan of a statement show the value of a run-time parameter skipping recursive expansion of variable "%s"
snapshot_id sort_expression sort_family_name sort_operator source_config source_encoding source_table source_type special stable start start a transaction block start_function state_data_size state_data_type statement stop listening for a notification storage storage_parameter storage_type strategy_number sub-SELECT subtype subtype_diff_function subtype_operator_class support_number tab completion query failed: %s
Query was:
%s
table table constraint table_constraint table_constraint_using_index table_name tablespace_name tablespace_option target_role target_type template text timestamp timezone to_sql_function_name token_type transaction_id transaction_mode trigger trigger_name trying to exit copy mode type type_modifier_input_function type_modifier_output_function type_name uid unexpected PQresultStatus: %d
unexpected result status for \watch
unexpected transaction status (%d)
unique, unknown unrecognized value "%s" for "%s"; assuming "%s"
unsafe unterminated quoted string
update update rows of a table user does not exist user name lookup failure: error code %lu user_name using_expression using_list valfunction validator_function value values version view view name is required
view_option_name view_option_value volatile where abbreviated_grant_or_revoke is one of: where action is one of: where aggregate_signature is: where column_constraint is: where conflict_target can be one of: where constraint is: where direction can be empty or one of: where event can be one of: where from_item can be one of: where lockmode is one of: where member_object is: where option can be one of: where option can be: where role_specification can be: where transaction_mode is one of: window window_definition window_name with_query with_query_name yes Project-Id-Version: psql (PostgreSQL) 9.6
Report-Msgid-Bugs-To: pgsql-bugs@postgresql.org
POT-Creation-Date: 2018-10-08 14:31+0000
PO-Revision-Date: 2017-10-24 08:36+0100
Last-Translator: Daniele Varrazzo <daniele.varrazzo@gmail.com>
Language-Team: https://github.com/dvarrazzo/postgresql-it
Language: it
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
X-Poedit-SourceCharset: utf-8
Plural-Forms: nplurals=2; plural=n != 1;
X-Generator: Poedit 1.5.4
Opzioni di connessione:
Impostazioni di visualizzazione:
Variabili d'ambiente:
Per maggiori informazioni digita "\?" (per comandi interni) oppure "\help"
per comandi SQL) da psql, oppure consultare la sezione psql nella
documentazione PostgreSQL.
Opzioni di input e output:
Opzioni formato output:
Analizzatore: "%s"
Analizzatore "%s.%s" --help=commands mostra la lista dei comandi backslash ed esci
--help=variables mostra la lista delle variabili speciali ed esci
(opzioni: S = mostra gli oggetti di sistema, + = dettagli addizionali)
-0, --record-separator-zero
usa il byte zero come separatore di record per l'output
non allineato
-1 ("uno"), --single-transaction
esegui in un'unica transazione (se non interattivo)
-?, --help[=opzioni] mostra quest'aiuto ed esci
-A, --no-align modo output tabelle disallineato
-E, --echo-hidden mostra le query generate dai comandi interni
-F, --field-separator=STRINGA
separatore di campo per output non allineato
(default: "%s")
-H, --html modo output tabelle in HTML
-L, --log-file=NOME_FILE invia log di sessione al file
-P, --pset=VAR[=ARG] imposta l'opzione di stampa VAR ad ARG (vedi anche
il comando \pset)
-R, --record-separator=STRINGa
separatore di record per output non allineato
(default: "a capo")
-S, --single-line modalità riga singola (la fine riga termina
il comando SQL)
-T, --table-attr=TESTO imposta gli attributi delle tabelle HTML
(es: larghezza, bordo)
-U, --username=UTENTE nome utente del database (default: "%s")
-V, --version mostra informazioni sulla versione ed esci
-W, --password forza la richiesta di una password (dovrebbe essere
automatico)
-X, --no-psqlrc non leggere il file di avvio (~/.psqlrc)
-a, --echo-all mostra tutti gli input dallo script
-b, --echo-errors mostra i comandi falliti
-c, --command=COMANDO esegue solamente un comando singolo (SQL o interno)
e termina
-d, --dbname=NOMEDB specifica il nome del database a cui connettersi
(default: "%s")
-e, --echo-queries mostra i comandi inviati al server
-f, --file=NOME FILE esegui i comandi da un file ed esci
-h, --host=HOSTNAME host server del database o directory socket
(default: "%s")
-l --list elenca i database disponibili ed esci
-n, --no-readline disabilita la modifica avanzata della riga
di comando (readline)
-o, --output=NOME_FILE reindirizza i risultati al file specificato
(oppure |pipe)
-p, --port=PORTA porta di ascolto del database (default: "%s")
-q, --quiet esegui in modo silenzioso (nessun messaggio, solo
risultati query)
-s, --single-step modalità passo singolo (conferma ogni query)
-t, --tuples-only mostra solo le righe
-v, --set=, --variable=NOME=VALORE
imposta la variabile psql NOME a VALORE
(es.: -v ON_ERROR_STOP=1)
-w, --no-password non chiedere mai le password
-x, --expanded attiva output tabelle espanso
-z, --field-separator-zero
usa il byte zero come separatore di campo per l'output
non allineato
AUTOCOMMIT se impostato, i comandi SQL riusciti sono salvati automaticamente
COLUMNS numero di colonne per il formato wrapped
COMP_KEYWORD_CASE determina il caso usato per completare le parole chiave SQL
[lower, upper, preserve-lower, preserve-upper]
DBNAME il nome del database attualmente connesso
ECHO controlla quale input è scritto su stardard output
[all, errors, none, queries]
ECHO_HIDDEN se impostato, mostra le query interne dei comandi backslash;
se impostato a "noexec", mostrale solo senza eseguirle
ENCODING codifica del set di caratteri del client corrente
FETCH_COUNT il numero di righe del risultato da leggere e mostrare per volta
(default: 0=tutte)
HISTCONTROL controlla la storia dei comandi [ignorespace, ignoredups, ignoreboth]
HISTFILE nome del file usato per memorizzare la storia dei comandi
HISTSIZE il numero di comandi da memorizzare nella storia dei comandi
HOST l'host del server del database attualmente connesso
IGNOREEOF se non impostato, invare un EOF alla sessione interattiva termina l'applicazione
LASTOID valore dell'ultimo OID interessato
NOME=VALORE [NOME=VALORE] psql ...
oppure \setenv NOME [VALORE] dentro psql
ON_ERROR_ROLLBACK se impostato, un errore non termina una transazione (usa punti di salvataggio impliciti)
ON_ERROR_STOP termina l'esecuzione batch dopo un errore
PAGER nome del programma di paginazione esterno
PGAPPNAME come il parametro di connessione application_name
PGDATABASE come il parametro di connessione dbname
PGHOST come il parametro di connessione host
PGPASSFILE nome del file delle password
PGPASSWORD password di connessione (uso non raccomandato)
PGPORT come il parametro di connessione port
PGUSER come il parametro di connessione user
PORT porta del server attualmente connesso
PROMPT1 specifica il prompt psql standard
PROMPT2 specifica il prompt usato quando un'istruzione continua da una riga precedente
PROMPT3 specifica il prompt usato in COPY ... FROM STDIN
PSQLRC posizione alternativa del file .psqlrc dell'utente
PSQL_EDITOR, EDITOR, VISUAL
editor usato dai comandi \e, \ef, \ev
PSQL_EDITOR_LINENUMBER_ARG
come specificare un numero di riga quando si invoca l'editor
PSQL_HISTORY posizione alternativa del file della storia dei comandi
QUIET esegui silenziosamente (come con l'opzione -q)
SHELL shell usata dal comando \!
SHOW_CONTEXT controlla la visualizzazione dei campi di contesto dei messaggi [never, errors, always]
SINGLELINE la fine riga termina i comandi SQL (come con l'opzione -S)
SINGLESTEP modalità passo singolo (come con l'opzione -s)
TMPDIR directory per i file temporanei
USER l'utente database attualmente connesso
VERBOSITY controlla la loquacità della visualizzazione degli errori [default, verbose, terse]
\! [COMANDO] esegui un comando in una shell oppure avvia una shell
interattiva
\? [commands] mostra aiuto sui comandi backslash
\? options mostra aiuto sulle opzioni di riga di comando psql
\? variables mostra aiusto sulle variabili speciali
\C [STRINGA] imposta nome tabella oppure elimina se la stringa
non è specificata
\H cambia modalità HTML (attualmente %s)
\T [STRINGA] imposta gli attributi HTML di <table>, se non
specificato allora annullali
\a alterna tra modalità di output allineata e disallineata
\c[onnect] {[DBNAME|- USER|- HOST|- PORT|-] | conninfo}
connetti ad un nuovo database (attualmente "%s")
\c[onnect] {[DBNAME|- USER|- HOST|- PORT|-] | conninfo}
connetti ad un nuovo database (nessuna connessione attiva)
\cd [DIRECTORY] cambia la directory di lavoro
\conninfo mostra le informazioni su la connessione corrente
\copy ... esegui una SQL COPY con flusso di dati dal client
\copyright mostra i termini di uso e distribuzione di PostgreSQL
\crosstabview [COLONNE] esegui la query e mostra il risultato in crosstab
\dA[+] [MODELLO] elenca i metodi di accesso
\dC[+] [MODELLO] elenca le conversioni di tipo
\dD[S+] [MODELLO] elenca i domini
\dE[S+] [MODELLO] elenca le tabelle esterne
\dF[+] [MODELLO] elenca le configurazioni di ricerca testo
\dFd[+] [MODELLO] elenca i dizionari di ricerca testo
\dFp[+] [MODELLO] elenca gli analizzatori di ricerca testo
\dFt[+] [MODELLO] elenca i modelli di ricerca di testo
\dL[S+] [MODELLO] elenca i linguaggi procedurali
\dO[S+] [MODELLO] elenca gli ordinamenti
\dT[S+] [MODELLO] elenca i tipi di dato
\d[S+] elenca le tabelle, le viste e le sequenze
\d[S+] NOME descrive la tabella, vista, sequenza o indice
\da[S] [MODELLO] elenca le funzioni di aggregazione
\db[+] [MODELLO] elenca i tablespace
\dc[S+] [MODELLO] elenca le conversioni di codifica
\dd[S] [MODELLO] mostra la descrizione di oggetti non elencati altrove
\ddp [MODELLO] elenca i privilegi predefiniti
\des[+] [MODELLO] elenca i server esterni
\det[+] [MODELLO] elenca le tabelle esterne
\deu[+] [MODELLO] elenca le mappature degli utenti
\dew[+] [MODELLO] elenca i wrapper di dati esterni
\df[antw][S+] [MOD] elenca le funzioni [solo aggr/normali/trigger/finestra]
\dg[S+] [MODELLO] elenca i ruoli
\di[S+] [MODELLO] elenca gli indici
\dl elenca i large object, stesso risultato di \lo_list
\dm[S+] [PATTERN] elenca le viste materializzate
\dn[S+] [MODELLO] elenca gli schemi
\do[S] [MODELLO] elenca gli operatori
\dp [MODELLO] elenca i permessi di accesso alla tabella, vista
o sequenza
\drds [MOD1 [MOD2]] elenca le impostazioni dei ruoli per database
\ds[S+] [MODELLO] elenca le sequenze
\dt[S+] [MODELLO] elenca le tabelle
\du[S+] [MODELLO] elenca i ruoli
\dv[S+] [MODELLO] elenca le viste
\dx[+] [MODELLO] elenca le estensioni
\dy [PATTERN] elenca i trigger di evento
\e [FILE] [RIGA] modifica il buffer della query (o il file) con
l'editor esterno
\echo [STRINGA] stampa la stringa su standard output
\ef [FUNZIONE [RIGA]] modifica la definizione della funzione con l'editor
esterno
\encoding [CODIFICA] mostra o imposta la codifica del client
\errverbose mostra il messaggio di errore più recente alla massima loquacità
\ev [VISTA [LINE]] modifica la definizione della vista con un editor esterno
\f [STRINGA] mostra o imposta il separatore di campo per l'output
query disallineato
\g [FILE] o ; esegui la query (ed invia i risultati ad un file o
ad una |pipe)
\gexec esegui la query, poi esegui ogni valore nel suo risultato
\gset [PREFIX] esegui la query e salva il risultato in una variabile psql
\h [NOME] mostra aiuto sulla sintassi dei comandi SQL, * mostra
tutti i comandi
\i FILE esegui i comandi dal file
\ir FILE come \i, ma relativo alla posizione nello script
corrente
\l[+] [PATTERN] elenca i database
\lo_export LOBOID FILE
\lo_import FILE [COMMENTO]
\lo_list
\lo_unlink LOBOID operazioni sui large object
\o [FILE] invia i risultati della query ad un file oppure
una |pipe
\p mostra i contenuti del buffer query
\password [UTENTE] cambia la password per un utente in sicurezza
\prompt [TESTO] NOME richiedi all'utente di impostare una variabile interna
\pset [NOME [VALORE]] imposta opzioni di output tabella
(NOME := {border|columns|expanded|fieldsep|fieldsep_zero|
footer|format|linestyle|null|numericlocale|pager|
pager_min_lines|recordsep|recordsep_zero|tableattr|title|
tuples_only|unicode_border_linestyle|
unicode_column_linestyle|unicode_header_linestyle})
\q esci da psql
\qecho [STRINGA] scrivi la stringa nello stream di output della query
(vedi \o)
\r reimposta (cancella) il buffer query
\s [FILE] mostra la cronologia salvala in un file
\set [NOME [VALORE]] imposta una variabile interna, oppure mostrale tutte
se non sono specificati parametri
\setenv NOME [VALORE] imposta o elimina una variabile d'ambiente
\sf[+] FUNZIONE mostra la definizione di una funzione
\sv[+] VISTA mostra la definizione di una vista
\t [on|off] mostra solo le righe (attualmente %s)
\timing [on|off] imposta cronometro dei comandi
(attualmente %s)
\unset NOME cancella una variabile interna
\w FILE scrivi il buffer query su file
\watch [SEC] esegui una query ogni SEC secondi
\x [on|off|auto] cambia modalità output espansa
(attualmente %s)
\z [MODELLO] uguale a \dp
border stile bordo (numero)
columns larghezza destinazione per il formato wrapped
expanded (o x) output espanso [on, off, auto]
fieldsep separatore di campo per l'output non allineato (default "%s")
fieldsep_zero imposta il separatore di campo per l'output non allineato al byte zero
footer abilita o disabilita la visualizzazione del piè di pagina [on, off]
format imposta il formato di output [unaligned, aligned, wrapped, html, asciidoc, ...]
linestyle imposta lo stile di disegno delle righe dei bordi [ascii, old-ascii, unicode]
null imposta la stringa da visualizzare al posto dei valori null
numericlocale abilita o disabilita i caratteri specifici per il locale per separare
i gruppi di cifre [on, off]
pager controlla quando usare la paginazione esterna [yes, no, always]
psql --pset=NOME[=VALORE]
oppure \pset NOME [VALORE] dentro psql
psql --set=NOME=VALORE
oppure \set NOME VALORE dentro psql
psql [OPZIONI]... [NOME DB [NOME UTENTE]]
recordsep separatore di record (riga) per l'output non allineato
recordsep_zero imposta il separatore di campo per l'output non allineato al byte zero
set NOME=VALORE
psql ...
oppure \setenv NOME [VALORE] dentro psql
tableattr (o T) specifica gli attributi per il tag table in formato html o la
larghezza colonna proporzionale dei dati allineati a sinistra
in formato latex-longtable
title imposta il titolo della tabella per ogni tabella stampata in seguto
tuples_only se impostato, mostra solo i dati della tabella
unicode_border_linestyle
unicode_column_linestyle
unicode_header_linestyle
imposta lo stile di disegno delle righe Unicode [single, double]
"%s.%s" non è una vista
%d connessione %d connessioni %s %s %s (ogni %gs)
%s
%s (%s, server %s)
%s (ogni %gs)
%s: %s
%s: -1 può essere usato solo in modalità non interattiva
%s: non è possibile copiare da/a una directory
%s: cancellazione della variabile "%s" fallita
%s: il proprio programma eseguibile non è stato trovato
%s: apertura del file di log "%s" fallita: %s
%s: impostazione del parametro di stampa "%s" fallito
%s: impostazione della variabile "%s" fallita
%s: questa transazione è stata interrotta
%s: nome codifica errato oppure non esiste una procedura di conversione
%s: non connesso ad un database
%s: memoria esaurita
%s: stato della transazione sconosciuto
%s: attenzione: parametro in eccesso "%s" nella riga di comando ignorato
(%lu riga) (%lu righe) ***(Modalità passo singolo: verifica comando)***********************************
%s
***(premi invio per procedere oppure digita x ed invio per annullare)***********
********* QUERY **********
%s
**************************
+ opt(%d) = |%s|
, raggruppato , deferibile , inizialmente deferito , non valido , predicato (%s) , identità di replica , tablespace "%s" Privilegi di accesso Tutti i parametri di connessione devono essere forniti perché non esiste alcuna connessione di database
Tipo dato dei parametri Notifica asincrona "%s" ricevuta dal processo server con PID %d.
Notifica asincrona "%s" con payload "%s" ricevuta dal processo server con PID %d.
Attributi Aiuti disponibili:
Lo stile del bordo è %d.
Scavalca RLS trasferimento dei dati COPY fallito: %s Gestore Chiamate Non è possibile aggiungere celle al contenuto della tabella: il numero totale di celle %d è stato superato.
Non è possibile aggiungere l'intestazione al contenuto della tabella: il numero di colonne %d è stato superato.
Login non possibile Controllo Vincoli di controllo: Tabelle figlio Ordinamento Colonna Privilegi di colonna Comando: %s
Descrizione: %s
Sintassi:
%s
Tipo composito "%s.%s" Connessione
Crea DB Crea ruoli Ctype Database Privilegi di accesso di default Il piè di pagina di default è disattivato.
Il piè di pagina di default è attivo.
Predefinito? Definizione Descrizione Destinazione Dizionari Non è stata trovata nessuna estensione chiamata "%s".
Non è stata trovata nessuna estensione.
Non è stata trovata nessuna relazione chiamata "%s".
Non è stata trovata nessuna relazione con OID %s.
Non è stata trovata nessuna configurazione di ricerca testo chiamata "%s".
Non è stato trovato nessun analizzatore di ricerca testo chiamato "%s".
Trigger interni disabilitati: Regole disabilitate: Trigger disabilitati: Trigger utente disabilitati: Elementi Abilitato Codifica Fine analisi Inserire i dati da copiare seguiti da un "a capo".
Terminare con un backslash ed un punto su una singola riga, o un segnale EOF. Conferma password: Inserire la nuova password: Evento La visualizzazione espansa è disattivata.
La visualizzazione espansa è attiva.
La visualizzazione espansa è usata automaticamente.
Opzioni FDW Opzioni FDW: (%s) Fallito.
Il separatore di campo è "%s".
Il separatore di campo è il byte zero.
Tabella esterna "%s.%s" Wrapper per dati esterni Vincoli di integrità referenziale Formattazione
Funzione Generali
Opzioni generali:
Ottiene intestazione Ottiene il token successivo Ottieni i tipi token Handler Ha OID: sì Aiuto
ID Implicito? Indice Indice "%s.%s" Indici: Informativi
Eredita Init Opzioni iniziali: Handler Inline Input/Output
Linguaggio interno Nome interno Interrotto
Comando errato \%s. Prova \? per la guida.
Linguaggio Large Object
Large object Argomento sinistro Lexize Lo stile della linea è %s.
Lista dei metodi di accesso Lista delle funzione aggregate Lista delle conversioni di tipo Lista degli ordinamenti Lista delle conversioni Lista dei tipi di dati Lista dei database Lista dei domini Lista di trigger di evento Lista dei server esterni Lista delle tabelle esterne Lista dei wrapper di dati esterni Lista delle funzioni Lista delle estensioni installate Lista dei linguaggi Lista degli operatori Lista delle relazioni Lista dei ruoli Lista degli schemi Lista delle impostazioni Lista delle variabili speciali
Lista dei tablespace Lista delle configurazioni di ricerca testo Lista dei dizionari di ricerca testo Lista degli analizzatori di ricerca resto Lista dei modelli di ricerca testo Lista delle mappature degli utenti La correzione dell'output numerico secondo il locale è disattivata.
La correzione dell'output numerico secondo il locale è attiva.
Posizione Vista materializzata "%s.%s" Membro di Metodo Modificatore Modificatori Nome Nessuna modifica Niente connessioni Nessun aiuto disponibile per "%s".
Prova a digitare \h senza parametri per vedere gli aiuti disponibili.
Nessuna ereditarietà Nessuna relazione corrispondente trovata.
Nessuna impostazione corrispondente trovata.
Questa versione del server non supporta l'impostazione dei ruoli per database.
Nessuna relazione trovata.
Nessuna impostazione trovata.
La visualizzazione dei null è "%s".
Numero di tabelle figlio: %d (Usa \d+ per elencarle.) Oggetto Descrizione Oggetto Descrizioni oggetti Oggetti nell'estensione "%s" Sistema operativo
Opzioni Il formato di output è %s.
Proprietario: %s Proprietario Paginazione sempre attiva.
Usa la paginazione per risultati estesi.
Paginazione disattivata.
La paginazione non verrà usata per meno di %d riga.
La paginazione non verrà usata per meno di %d righe.
Parallela Criptazione password fallita.
Inserisci la password per l'utente %s: Password valida fino a Password: Le password non corrispondono.
Regole di sicurezza Regole (sicurezza per riga forzata abilitata): Regole (sicurezza per riga forzata abilitata): (nessuna) Regole (sicurezza per riga disabilitata): Regole (sicurezza per riga abilitata): (nessuna) Regole di sicurezza: Connessione precedente mantenuta
Procedura Buffer Query
Il buffer query è vuoto. Buffer query resettato (svuotato). Il separatore di record è "%s".
Il separatore di record è <a capo>.
Il separatore di record è il byte zero.
Referenziato da: Identità di replica Replica Puoi segnalare eventuali bug a <pgsql-bugs@postgresql.org>.
Tipo dato del risultato Tipo di risultato Argomento destro Ruolo Nome ruolo Regole sempre abilitate: Regole abilitate solo su replica: Regole: connessione SSL (protocollo: %s, cifrario: %s, bit: %s, compressione: %s)
COMANDO: %s
Schema Sicurezza Sequenza "%s.%s" Server Server: %s Impostazioni Dimensione Sorgente Codice sorgente Tipo di partenza relazione speciale "%s.%s" Inizio analisi Dest. stat. Memorizzazione Riuscito.
Superutente Tabella TOAST "%s.%s" Tabella Tabella "%s.%s" Gli attributi di tabella sono "%s".
Gli attributi di tabella non sono specificati.
Tablespace Tablespace: "%s" Tag Tipo di arrivo La larghezza di destinazione è %d.
La lunghezza di destinazione non è impostata.
Modello Configurazione di ricerca testo "%s" Configurazione di ricerca testo "%s.%s" Analizzatore di ricerca testo "%s" Analizzatore di ricerca teso "%s.%s" Connessione al server persa. Tentativo di reset: L'input è un file di dump in formato PostgreSQL.
Usa il tool di riga di comando pg_restore per ripristinare questo dump in un database.
Il server (versione %s) non supporta metodi di accesso.
Il server (versione %s) non supporta la modifica dei privilegi di default.
Il server (versione %s) non supporta gli ordinamenti.
Il server (versione %s) non supporta la modifica dei sorgenti delle funzioni.
Il server (versione %s) non supporta la modifica della definizione delle viste.
Il server (versione %s) non supporta le estensioni.
Il server (versione %s) non supporta server esterni.
Il server (versione %s) non supporta tabelle esterne.
Il server (versione %s) non supporta i wrapper di dati esterni.
Il server (versione %s) non supporta la ricerca full text.
Il server (versione %s) non supporta savepoint per ON_ERROR_ROLLBACK.
Il server (versione %s) non supporta la visualizzazione dei sorgenti delle funzioni.
-"Il server (versione %s) non supporta la visualizzazione della definizione delle viste.
Il server (versione %s) non supporta i tablespace.
Il server (versione %s) non supporta la mappatura di utenti.
Non c'è un errore precedente. Tempo: %.3f ms
Controllo tempo disattivato. Controllo tempo attivato Il titolo è "%s".
Il titolo non è assegnato.
Token Nome token Tipi token per l'analizzatore "%s" Tipi token per l'analizzatore "%s.%s" Trigger sempre abilitati: Trigger abilitati solo su replica. Trigger: Fidato Prova "%s --help" per maggiori informazioni.
La visualizzazione dei soli dati è disattivata.
La visualizzazione dei soli dati è attiva.
Tipo Digita "help" per avere un aiuto.
Digita: \copyright per le condizioni di distribuzione
\h per la guida sui comandi SQL
\? per la guida sui comandi psql
\g o termina con punto e virgola per eseguire la query
\q per uscire
Tabella di tipo: %s Lo stile riga Unicode dei bordi è "%s".
Lo stile riga Unicode delle colonne è "%s".
Lo stile riga Unicode delle intestazioni è "%s".
Indice non loggato "%s.%s" Vista materializzata non loggata "%s.%s" Tabella non loggata "%s.%s" Utilizzo:
Utilizza "\q" per uscire %s.
Nome utente Validatore Valore Variabili
Versione Vista "%s.%s" Definizione vista: Volatilità ATTENZIONE: versione maggiore %s %s, versione maggiore server %s.
Alcune caratteristiche di psql potrebbero non funzionare.
ATTENZIONE: Il code page della console (%u) differisce dal code page
di Windows (%u). I caratteri a 8-bit potrebbero non
funzionare correttamente. Vedi le pagine di riferimento
psql "Note per utenti Windows" per i dettagli.
Storia scritta nel file "%s".
Sei collegato al database "%s" con nome utente "%s" sull'host "%s" porta "%s".
Sei collegato al database "%s" con nome utente "%s" tramite il socket in "%s" porta "%s".
Al momento non sei connesso ad un database.
Adesso sei collegato al database "%s" con nome utente "%s" sull'host "%s" porta "%s".
Adesso sei collegato al database "%s" con nome utente "%s" tramite socket "%s" porta "%s".
Sei collegato al database "%s" con nome utente "%s".
Stai utilizzando psql, l'interfaccia a riga di comando di PostgreSQL. \!: fallita
\%s: spostamento della directory a "%s" fallito: %s
\%s: il nome della variabile d'ambiente non deve contenere "="
\%s: errore durante l'assegnamento della variabile
\%s: parametro in eccesso "%s" ignorato
\%s: parametro richiesto mancante
\connect: %s \copy: parametri richiesti
\copy: errore di sintassi a "%s"
\copy: errore di sintassi a fine riga
\crosstabview: nome di colonna ambiguo: "%s"
\crosstabview: colonna non trovata: "%s"
\crosstabview: il numero di colonna %d è al di fuori dell'intervallo 1..%d
\crosstabview: la colonna dei dati deve essere specificata quando la query restituisce più di tre colonne
\crosstabview: numero massimo di colonne (%d) superato
\crosstabview: la query deve restituire almeno tre colonne
\crosstabview: i risultati della query contengono più di un valore per la riga "%s", colonna "%s"
\crosstabview: l'istruzione non ha restituito dati
\crosstabview: le intestazioni verticali ed orizzontali devono essere in colonne diverse
\df non accetta un'opzione "w" con il server in versione %s
\df accetta come opzioni solo [antwS+]
\pset: gli stili riga Unicode dei bordi consentiti sono single, double
\pset: gli stili riga Unicode delle colonne consentiti sono single, double
\pset: gli stili riga Unicode delle intestazioni consentiti sono single, double
\pset: i formati consentiti sono unaligned, aligned, wrapped, html, asciidoc, latex, latex-longtable, troff-ms
\pset: gli stili di linea permessi sono ascii, old-ascii, unicode
\pset: opzione sconosciuta: %s
\watch non può essere usato con COPY
\watch non può essere usato con una query vuota
grant_o_revoke_abbreviato annulla la transazione corrente interrotto a causa di lettura non riuscita tipo_metodo_accesso azione aggr nome_aggregato signature_aggregato alias allineamento permetti_conn sempre funzione_analyze e signature_aggregato è: e azione_conflitto è una di: e elemento_raggruppante può essere uno di: e opzione_like è: e vincolo_di_tabella è: e vincolo_di_tabella_con_indice è: e with_query è: topo_dato_argomento nome_arg tipo_arg modo_arg nome_arg tipo_arg argomento tipo_argomento argomenti attributo nome_attributo opzione_attributo tipo_base booleano cache handler_chiamata annulla una transazione che era stata preparata per un commit a due fasi annullata dall'utente impossibile duplicare il puntatore nullo (errore interno)
non è possibile effettuare l'escape senza una connessione attiva
funzione_canonica categoria cambia un database cambia un ruolo di database modifica un parametro di esecuzione cambia un parametro di configurazione del server cambia il nome del ruolo o l'appartenenza cambia la definizione di un ordinamento cambia la definizione di una conversione cambia la definizione di un dominio cambia la definizione di un server esterno cambia la definizione di una tabella esterna cambia la definizione di un wrapper di dati esterni cambia la definizione di una funzione cambia la definizione di un large object cambia la definizione di una vista materializzata cambia la definizione di un linguaggio procedurale cambia la definizione di una regola di sicurezza per riga cambia la definizione di una regola cambia la definizione di uno schema cambia la definizione di un generatore di sequenza cambia la definizione di una tabella cambia la definizione di un tablespace cambia la definizione di una configurazione di ricerca testo cambia la definizione di un dizionario di ricerca testo cambia la definizione di un analizzatore di ricerca testo cambia la definizione di un modello di ricerca testo cambia la definizione di un trigger cambia la definizione di un tipo di dato cambia la definizione di una mappatura degli cambia la definizione di una vista cambia la definizione di una funzione di aggregazione cambia la definizione di un trigger di evento cambia la definizione di una estensione cambia la definizione di un indice cambia la definizione di un operatore cambia la definizione di una classe di operatori cambia la definizione di una famiglia di operatori cambia il proprietario degli oggetti del database posseduti da un ruolo canale espressione_check processo figlio uscito con codice di uscita %d processo figlio uscito con stato non riconosciuto %d processo figlio terminato da eccezione 0x%X processo figlio terminato da segnale %d processo figlio terminato da segnale %s chiudi un cursore raggruppa una tabella in base ad un indice codice ordinabile ordinamento %s ordinamento raccogli statistiche sul database alias_colonna vincolo_di_colonna definizione_colonna nome_colonna tipo_colonna com_op funz_combine comando comando non eseguibile comando non trovato concludi transazione che è stata precedentemente preparata per un commit a due fasi rendi persistente la transazione corrente genera una sequenza di righe condizione parametro_config azione_conflitto target_conflitto connessione al server persa
limite_conn vincolo nome_vincolo copia i dati tra un file ed una tabella spostamento nella directory "%s" fallito: %s chiusura della pipe verso il comando esterno fallita: %s
esecuzione del comando "%s" fallito: %s
programma "%s" da eseguire non trovato directory home non trovata per l'ID utente %ld: %s
identificazione della directory corrente fallita: %s directory temporanea non trovata: %s
ID utente effettivo %ld non trovato: %s apertura del file temporaneo "%s" fallita: %s
interpretazione dell'array reloptions fallita
lettura del binario "%s" fallita lettura dal file di input fallita: %s
lettura del link simbolico "%s" fallita salvataggio della cronologia nel file "%s" fallita: %s
impostazione della variabile "%s" fallita
avvio di /bin/sh fallito
avvio dell'editor "%s" fallito
richiesta informazioni sul file "%s" fallita: %s
scrittura dei dati COPY fallita: %s
conteggio crea un nuovo database crea nuove righe in una tabella nome_cursore tipo_di_dato nome_database dealloca una istruzione preparata predefinito preimpostato %s expr_default definisci un cursore definisci un nuovo metodo di accesso definisci una nuova funzione aggregata definisci una nuova conversione di tipi definisci un nuovo ordinamento definisci un nuovo tipo di dato definisci un nuovo ruolo database definisci un nuovo dominio definisci una nuova conversione di codifica definisci un nuovo trigger di evento definisci un nuovo server esterno definisci una nuova tabella esterna definisci un nuovo wrapper di dati esterni definisci una nuova funzione crea un nuovo indice definisci una nuova mappatura di un utente ad un server esterno definisci una nuova vista materializzata definisci un nuovo operatore definisci una nuova classe di operatori definisci una nuova famiglia operatore definisci un nuovo linguaggio procedurale definisci una nuova regola di riscrittura definisci una nuova regola di sicurezza per riga per una tabella definisci un nuovo punto di salvataggio per la transazione corrente crea un nuovo schema definisci un nuovo generatore di sequenze crea una nuova tabella crea una nuova tabella dai risultati di una query crea un nuovo tablespace definisci una nuova configurazione di ricerca testo definisci un nuovo dizionario di ricerca testo definisci un nuovo analizzatore di ricerca testo definisci un nuovo modello di ricerca testo definisci una nuova trasformazione definisci un nuovo trigger definisci una nuova vista definisci i privilegi di accesso definisci i privilegi di accesso di default definisci o modifica un'etichetta di sicurezza applicata a un oggetto definisci o modifica il commento di un oggetto definitore definizione delete elimina le righe di una tabella delimitatore carattere_delimitatore funz_deserial codifica_destinazione distruggi un punto di salvataggio precedentemente definito nome_dizionario direzione directory disabilitato cancella lo stato della sessione vincolo di dominio vincolo_di_dominio nome_dominio elemento svuota una tabella o una lista di tabelle abilitato codifica nome_codifica funzione_fine la variabile di ambiente PSQL_EDITOR_LINENUMBER_ARG deve specificare un numero di riga
carattere_di_escape evento elemento_di_esclusione elemento_di_esclusione in un vincolo EXCLUDE è: esegui una istruzione preparata esegui un blocco di codice anonimo costo_di_esecuzione ordinamento_esistente valore_enum_esistente espressione nome_estensione nome_famiglia nome_fdw ffunz nome_file valiabile_filtro per la tabella "%s.%s" forza un punto di controllo nel log delle transazioni tabella esterna nome_formato elemento_from lista_from nome_funzione_from_sql funzione il nome della funzione è richiesto
nome_funzione pulisci ed eventualmente analizza il database genera una notifica funzione_gettoken nome_gruppo elemento_raggruppante funzione_handler funzione_headline history non è supportata da questa installazione
immutabile importa le definizioni di tabella da un server remoto in assegnazione incremento indice nome_colonna_indice espressione_indice metodo_indice nome_indice parametri_di_indice parametri_di_indice nei vincoli UNIQUE, PRIMARY KEY e EXCLUDE sono: indice_predicato funzione_init condizione_iniziale handler_inline funzione_input insert installa un'estensione intero lunghezza_interna binario non valido "%s" comando errato \%s
numero di riga non valido: "%s"
il formato di output non è valido (errore interno): %d invocatore è_template colonna_join condizione_join proc_join tipo_join etichetta nome_linguaggio oid_large_object lc_collate lc_ctype tipo_sx funzione_lexize funzione_lextypes opzioni_di_like tipo_like simbolo_link attendi l'arrivo di notifiche carica un file di libreria condivisa sockect locale schema_locale locale blocca una tabella modalità_lock loid vista materializzata valoremax oggetto_membro metodo mffunz condizione_minima valoremin minvfunz più di una riga restituita per \gset
msfunz tipo_dato_mstato tipo_dato_mstato nome neg_op nuovo_nome_attributo nuovo_nome_colonna nuovo_nome_vincolo nuovo_dizionario nuovo_valore_enum nuovo_nome nuovo_proprietario nuovo_ruolo nuovo_schema nuova_tabella nuovo_tablespace nuova_versione no Nessun buffer query
nessuna riga restituita per \gset
normale non null stringa_nulla file_obj nome_oggetto disattivato vecchio_dizionario vecchio_ruolo vecchia_versione attivato tipo_op classe_op operatore classe operatori famiglia operatori nome_operatore opzione o la vecchia sintassi memoria esaurita memoria esaurita
espressione_output funzione_output nome_output parametro tabella_padre nome_parser password payload pclose fallita: %s nome_regola posiziona un cursore predicato preferito prepara una istruzione per l'esecuzione prepara la transazione corrente per un commit a due fasi chiave primaria, provider psql è il terminale interattivo per PostgreSQL.
variabili psql:
query carattere_virgolette ricostruisci indici funzione_receive colonna_ref nome_tabella_referenziata tabella_ref nome_relazione schema_remoto elimina una conversione di tipi elimina un ordinamento elimina una conversione elimina un tipo di dato elimina un database elimina un ruolo di database elimina un dominio elimina una descrizione server esterno elimina una tabella esterna elimina un wrapper di dati esterni elimina una funzione elimina una vista materializzata elimina un linguaggio procedurale elimina una regola di riscrittura rimuovi una regola di sicurezza per riga da una tabella elimina uno schema elimina una sequenza elimina una tabella elimina un tablespace elimina una configurazione di ricerca testo elimina un dizionario di ricerca testo elimina un analizzatore di ricerca testo elimina un modello di ricerca testo elimina una trasformazione elimina un trigger elimina la mappatura degli utenti per un server esterno elimina una vista elimina i privilegi di accesso rimuovi un metodo di accesso elimina una funzione aggregata elimina un trigger di evento elimina una estensione elimina un indice elimina un operatore elimina una classe di operatori elimina una famiglia operatore elimina gli oggetti database di proprietà di un ruolo di database sostituisci il contenuto di una vista materializzata replica res_proc riavvio ripristina un parametro di esecuzione al suo valore di predefinito ristretta righe_risultato estrai delle righe da una query utilizzando un cursore estrai righe da una tabella o una vista tipo_ritorno nome_regola_di_riscrittura tipo_dx nome_ruolo specifica_ruolo annulla le modifiche fino a un punto di salvataggio regola nome_ruolo sicura metodo_di_campionamento nome_punto_salvataggio elemento_di_schema nome_schema seme select funzione_send sequenza nome_sequenza funz_serial nome_server tipo_di_server versione_server imposta il momento del controllo dei vincoli per la transazione corrente imposta le caratteristiche della transazione corrente imposta l'identificativo utente della sessione corrente imposta l'identificazione utente della sessione e l'identificazione utente corrente della sessione corrente sfunz mostra il piano di esecuzione di una istruzione mostra il valore di un parametro di esecuzione espansione ricorsiva della variabile "%s" evitata
id_snapshot espressione_ordinamento nome_famiglia_sort operatore_di_ordinamento config_origine codifica_origine tabella_origine tipo_sorgente speciale stabile inizio avvia un blocco di transazione funzione_inizio dimensione_dato_stato tipo_dato_stato istruzione termina l'attesa di notifiche memorizzazione parametro_di_memorizzazione tipo_memorizzazione strategia_num sub-SELECT sottotipo funzione_diff_sottotipo classe_operatore_sottotipo num_supporto query per il completamento tab fallita: %s
La query era:
%s
tabella vincolo di tabella vincoli_di_tabella vincoli_di_tabella_con_indice nome_tabella nome_tablespace opzione_tablespace ruolo_destinazione tipo_destinazione template testo timestamp timezone nome_funzione_to_sql tipo_di_token id_transazione modalità_transazione trigger nome_trigger tentativo di uscita dalla modalità copy tipo funzione_input_modificatore_tipo funzione_output_modificatore_tipo nome_di_tipo uid PQresultStatus imprevisto: %d
risultato imprevisto per \watch
stato della transazione imprevisto (%d)
univoco, sconosciuto valore "%s" non riconosciuto per "%s"; interpretato come "%s"
non sicura stringa tra virgolette non terminata
update modifica le righe di una tabella l'utente non esiste ricerca del nome utente fallita: codice di errore %lu nome_utente espressione_using lista_using funzione_valid funzione_validazione valore valori versione vista il nome della vista è richiesto
nome_opzione_vista valore_opzione_vista volatile dove grant_o_revoke_abbreviato è uno di: dove azione è una di: dove signature_aggregato è: dove vincolo_di_colonna è: dove target_conflitto può essere uno di: dove vincolo di è: dove direzione può essere vuota o una di: dove evento può essere uno di: dove from_item può essere uno di: dove modalità_lock è una di: dove oggetto_membro è: dove opzione può essere una di: dove opzione può essere: dove specifica_ruolo può essere: dove modalità_transazione è una di: finestra definizione_finestra nome_finestra query_with nome_query_with sì locale/it/LC_MESSAGES/libpq5-9.6.mo 0000644 00000060037 14751153421 0012260 0 ustar 00 �� � | � 0 1 B E J P b
x ' � ( � � # � - $ : _ y
� 0 � ( � ( � * 6 5 = 8 s 0 � � $ � # # G S - e 8 � � � . ( 3 , \ � � : � " � ! < 2 a o 0 � ) ' , * T . + � ' � ' * * * U + � * � , � ) ) . + X - � / � + � ( ) 7 & a 5 � 3 � & � ! ; V k " � v � w ! r � ! - O ' l - � � � # V 9 z & � ) � * # 0 9 T ) � ' � ) �
) ( " R 9 u . � ' � * ! " 1! " T! . w! / �! - �! @ " 2 E" ! x" % �" % �" & �" V
# = d# ; �# �# �# $ 4 ;$ 0 p$ �$ : �$ �$ % :% - [% - �% �% + �% 2 �% 7 2& = j& ! �& . �& 8 �& " 2' U' F u' C �' $ ( %( B @( �( �( ; �( ( �( * ) & @) % g) ! �) 6 �) C �) ? ** 2 j* 1 �* = �* )
+ J 7+ �+ �+ �+ �+ �+ 1 ,
7, E, + T, �, ) �, " �, [ �, H- ? a- 1 �- 8 �- > . � K. # �. �. : / � @/ 2 �/ Q �/ J O0 K �0 �0 1 1 ? .1 ! n1 + �1 �1 �1 L �1 D 62 % {2 . �2 C �2 3 $ 53 5 Z3 ) �3 � �3 �5 �5 �5 �5 �5 �5
�5 - �5 . )6 " X6 ) {6 �6
�6 * �6 �6 & 7 97 = C7 . �7 . �7 �7 �7 �7 : �7 = :8 2 x8 ' �8 ( �8 & �8
#9 .9 7 @9 ? x9 �9 ! �9 * �9 " : 4 @: u: �: C �: ( �: ; ); N <; � �; @ !< 3 b< " �< 8 �< < �< 9 /= - i= & �= ; �= < �= < 7> : t> < �> : �> : '? < b? > �? @ �? < @ 9 \@ : �@ = �@ I A 3 YA / �A + �A & �A B ' (B 3 PB � �B � C � �C , 4D ' aD ! �D 9 �D F �D � ,E < �E M "F 5 pF 1 �F 8 �F , G F >G ; �G 2 �G 2 �G # 'H 1 KH " }H K �H 8 �H & %I 4 LI ! �I ) �I > �I ? J ? LJ R �J 8 �J $ K = =K * {K + �K _ �K I 2L F |L ' �L ' �L ' M 9 ;M 7 uM * �M L �M %N , EN , rN 3 �N 3 �N O 7 $O ; \O @ �O \ �O 3 6P : jP = �P �P # Q L 'Q V tQ ( �Q ! �Q N R eR xR D �R - �R 8 S 5 AS % wS $ �S F �S \ T Z fT = �T 1 �T D 1U , vU S �U �U V 1V , PV ' }V 1 �V �V �V 9 �V - 4W 1 bW �W � �W GX N fX 3 �X A �X D +Y � pY , Z 8Z B NZ � �Z 6 @[ s w[ l �[ m X\ . �\ �\ ] G !] . i] ; �] �] �] T ^ V V^ 7 �^ 0 �^ C _ % Z_ $ �_ B �_ 6 �_ � l � A � O � m . M f � d � H @ � t * � k U � 4 � � a � � / G � T % � 5 Y u �
, � � r � � R 7 6 � � � z � � S : ! ; 1 [ L � - � Z � x ` s n � " � K ' � � y
b � 8 3 � � � � = ^ # < � � � � c F ( � \ p v Q N � � � 9 � ~ q � � o � � J � B w $ V } W D � E � � 2 � h � & i � _ � � 0 � � � � X > � g e ? ) � � � � + � | I { � � C ] j � � � P � � � at character %s %s %s, %s:%s COLUMN NAME: %s
CONSTRAINT NAME: %s
CONTEXT: %s
COPY IN state must be terminated first
COPY OUT state must be terminated first
COPY terminated by new PQexec Crypt authentication not supported
DATATYPE NAME: %s
DETAIL: %s
GSSAPI authentication not supported
GSSAPI continuation error GSSAPI name import error HINT: %s
IPv6 host address may not be empty in URI: "%s"
Kerberos 4 authentication not supported
Kerberos 5 authentication not supported
LINE %d: LOCATION: NOTICE PGEventProc "%s" failed during PGEVT_CONNRESET event
PGEventProc "%s" failed during PGEVT_RESULTCREATE event
PGresult cannot support more than INT_MAX tuples PGresult is not an error result
PQexec not allowed during COPY BOTH
PQgetline: not doing text COPY OUT
QUERY: %s
SCHEMA NAME: %s
SCM_CRED authentication method not supported
SCRAM authentication requires libpq version 10 or above
SSL SYSCALL error: %s
SSL SYSCALL error: EOF detected
SSL certificate's name contains embedded null
SSL certificate's name entry is missing
SSL connection has been closed unexpectedly
SSL error code %lu SSL error: %s
SSL library does not support CRL certificates (file "%s")
SSPI authentication not supported
SSPI continuation error TABLE NAME: %s
Unix-domain socket path "%s" is too long (maximum %d bytes)
WARNING: password file "%s" has group or world access; permissions should be u=rw (0600) or less
WARNING: password file "%s" is not a plain file
WSAIoctl(SIO_KEEPALIVE_VALS) failed: %ui
another command is already in progress
argument of lo_read exceeds integer range
argument of lo_truncate exceeds integer range
argument of lo_write exceeds integer range
attribute has no values on LDAP lookup
authentication method %u not supported
cannot determine OID of function lo_close
cannot determine OID of function lo_creat
cannot determine OID of function lo_create
cannot determine OID of function lo_lseek
cannot determine OID of function lo_lseek64
cannot determine OID of function lo_open
cannot determine OID of function lo_tell
cannot determine OID of function lo_tell64
cannot determine OID of function lo_truncate
cannot determine OID of function lo_truncate64
cannot determine OID of function lo_unlink
cannot determine OID of function loread
cannot determine OID of function lowrite
certificate could not be obtained: %s
certificate does not match private key file "%s": %s
certificate present, but not private key file "%s"
column number %d is out of range 0..%d command string is a null pointer
connection in wrong state
connection not open
connection pointer is NULL
could not acquire SSPI credentials could not connect to server: %s
Is the server running locally and accepting
connections on Unix domain socket "%s"?
could not connect to server: %s
Is the server running on host "%s" (%s) and accepting
TCP/IP connections on port %s?
could not connect to server: %s
Is the server running on host "%s" and accepting
TCP/IP connections on port %s?
could not create LDAP structure
could not create SSL context: %s
could not create socket: %s
could not establish SSL connection: %s
could not get client address from socket: %s
could not get home directory to locate root certificate file
Either provide the file or change sslmode to disable server certificate verification.
could not get peer credentials: %s
could not get server's host name from server certificate
could not get socket error status: %s
could not initialize SSL engine "%s": %s
could not interpret result from server: %s could not load SSL engine "%s": %s
could not load private SSL key "%s" from engine "%s": %s
could not load private key file "%s": %s
could not look up local user ID %d: %s
could not open certificate file "%s": %s
could not open file "%s": %s
could not read certificate file "%s": %s
could not read from file "%s": %s
could not read private SSL key "%s" from engine "%s": %s
could not read root certificate file "%s": %s
could not receive data from server: %s
could not send SSL negotiation packet: %s
could not send data to server: %s
could not send startup packet: %s
could not set socket to TCP no delay mode: %s
could not set socket to close-on-exec mode: %s
could not set socket to nonblocking mode: %s
could not translate Unix-domain socket path "%s" to address: %s
could not translate host name "%s" to address: %s
could not write to file "%s": %s
definition of service "%s" not found
duplicate GSS authentication request
duplicate SSPI authentication request
end of string reached when looking for matching "]" in IPv6 host address in URI: "%s"
expected authentication request from server, but received %c
extra key/value separator "=" in URI query parameter: "%s"
extraneous data in "D" message extraneous data in "T" message extraneous data in "t" message forbidden value %%00 in percent-encoded value: "%s"
function requires at least protocol version 3.0
host name must be specified
host name must be specified for a verified SSL connection
incomplete multibyte character
insufficient data in "D" message insufficient data in "T" message integer of size %lu not supported by pqGetInt integer of size %lu not supported by pqPutInt invalid ExecStatusType code invalid LDAP URL "%s": invalid port number
invalid LDAP URL "%s": missing distinguished name
invalid LDAP URL "%s": must have exactly one attribute
invalid LDAP URL "%s": must have search scope (base/one/sub)
invalid LDAP URL "%s": no filter
invalid LDAP URL "%s": scheme must be ldap://
invalid URI propagated to internal parser routine: "%s"
invalid URI query parameter: "%s"
invalid connection option "%s"
invalid connection state %d, probably indicative of memory corruption
invalid connection state, probably indicative of memory corruption
invalid percent-encoded token: "%s"
invalid port number: "%s"
invalid setenv state %c, probably indicative of memory corruption
invalid socket
invalid sslmode value: "%s"
invalid state %c, probably indicative of memory corruption
keepalives parameter must be an integer
length must be given for binary parameter
line %d too long in service file "%s"
local user with ID %d does not exist
lookup on LDAP server failed: %s
lost synchronization with server, resetting connection lost synchronization with server: got message type "%c", length %d
message contents do not agree with length in message type "%c"
message type 0x%02x arrived from server while idle missing "=" after "%s" in connection info string
missing key/value separator "=" in URI query parameter: "%s"
more than one entry found on LDAP lookup
nested service specifications not supported in service file "%s", line %d
no COPY in progress
no SSL error reported no connection to the server
no entry found on LDAP lookup
no error message available
number of parameters must be between 0 and 65535
out of memory out of memory
out of memory allocating GSSAPI buffer (%d) out of memory for query result parameter number %d is out of range 0..%d password retrieved from file "%s"
private key file "%s" has group or world access; permissions should be u=rw (0600) or less
protocol error: id=0x%x
query to initialize large object functions did not return data
received invalid response to SSL negotiation: %c
requirepeer parameter is not supported on this platform
requirepeer specifies "%s", but actual peer user name is "%s"
root certificate file "%s" does not exist
Either provide the file or change sslmode to disable server certificate verification.
row number %d is out of range 0..%d select() failed: %s
server certificate for "%s" does not match host name "%s"
server closed the connection unexpectedly
This probably means the server terminated abnormally
before or while processing the request.
server does not support SSL, but SSL was required
server sent binary data ("B" message) without prior row description ("T" message) server sent data ("D" message) without prior row description ("T" message) server sent data ("D" message) without prior row description ("T" message)
service file "%s" not found
setsockopt(%s) failed: %s
size_t overflow sslmode value "%s" invalid when SSL support is not compiled in
statement name is a null pointer
syntax error in service file "%s", line %d
timeout expired
unexpected asyncStatus: %d
unexpected character "%c" at position %d in URI (expected ":" or "/"): "%s"
unexpected character %c following empty query response ("I" message) unexpected field count in "D" message unexpected message from server during startup
unexpected response from server; first received character was "%c"
unrecognized SSL error code: %d
unrecognized socket error: 0x%08X/%d unterminated quoted string in connection info string
user name lookup failure: error code %lu
Project-Id-Version: libpq (PostgreSQL) 9.6
Report-Msgid-Bugs-To: pgsql-bugs@postgresql.org
POT-Creation-Date: 2017-11-07 19:17+0000
PO-Revision-Date: 2017-08-31 01:08+0100
Last-Translator: Daniele Varrazzo <daniele.varrazzo@gmail.com>
Language-Team: https://github.com/dvarrazzo/postgresql-it
Language: it
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Plural-Forms: nplurals=2; plural=n != 1;
X-Poedit-SourceCharset: UTF-8
X-Generator: Poedit 1.5.4
al carattere %s %s %s, %s:%s NOME COLONNA: %s
NOME VINCOLO: %s
CONTESTO: %s
lo stato COPY IN deve prima essere terminato
lo stato COPY OUT deve prima essere terminato
COPY terminato da una nuova PQexec l'autenticazione Crypt non è supportata
NOME TIPO DATI: %s
DETTAGLI: %s
l'autenticazione GSSAPI non è supportata
GSSAPI errore di continuazione errore di importazione del nome GSSAPI NOTA: %s
l'indirizzo host IPv6 non dev'essere assente nella URI: "%s"
l'autenticazione Kerberos 4 non è supportata
l'autenticazione Kerberos 5 non è supportata
RIGA %d: POSIZIONE: NOTIFICA PGEventProc "%s" fallito durante l'evento PGEVT_CONNRESET
PGEventProc "%s" fallito durante l'evento PGEVT_RESULTCREATE
PGresult non può supportare più di INT_MAX tuple PGresult non è un risultato di errore
PQexec not consentito durante COPY BOTH
PQgetline: COPY OUT testuale ignorato
QUERY: %s
NOME SCHEMA: %s
il metodo di autenticazione SCM_CRED non è supportato
l'autenticazione SCRAM richiede libpq versione 10 o successiva
errore SSL SYSCALL: %s
errore SSL SYSCALL: rilevato EOF
Il nome del certificato SSL contiene null
manca il nome del certificato SSL
la connessione SSL è stata chiusa inaspettatamente
codice di errore SSL: %lu errore SSL: %s
la libreria SSL non supporta i certificati di tipo CRL (file "%s")
l'autenticazione SSPI non è supportata
SSPI errore di continuazione NOME TABELLA: %s
Il percorso del socket di dominio unix "%s" è troppo lungo (massimo %d byte)
ATTENZIONE: Il file delle password %s ha privilegi di accesso in lettura e scrittura per tutti;
i permessi dovrebbero essere u=rw (0600) o inferiori
ATTENZIONE: il file delle password "%s" non è un file regolare
chiamata WSAIoctl(SIO_KEEPALIVE_VALS) fallito: %ui
un altro comando è in esecuzione
l'argomento di lo_read supera l'intervallo degli interi
l'argomento di lo_truncate supera l'intervallo degli interi
l'argomento di lo_write supera l'intervallo degli interi
l'attributo non ha valori nella ricerca LDAP
l'autenticazione %u non è supportata
non è possibile determinare l'OID della funzione lo_close
non è possibile determinare l'OID della funzione lo_create
non è possibile determinare l'OID della funzione lo_create
non è possibile determinare l'OID della funzione lo_seek
non è possibile determinare l'OID della funzione lo_seek64
non è possibile determinare l'OID della funzione lo_open
non è possibile determinare l'OID della funzione lo_tell
non è possibile determinare l'OID della funzione lo_tell64
non è possibile determinare l'OID della funzione lo_truncate
non è possibile determinare l'OID della funzione lo_truncate64
non è possibile determinare l'OID della funzione lo_unlink
non è possibile determinare l'OID della funzione loread
non è possibile determinare l'OID della funzione lowrite
non è stato possibile possibile ottenere il certificato: %s
il certificato non corrisponde con il file della chiave privata "%s": %s
certificato trovato, ma non la chiave privata "%s"
la colonna numero %d non è compreso tra 0 e %d il testo del comando è un puntatore nullo
la connessione è in uno stato errato
connessione non aperta
il puntatore della connessione è NULL
non è stato possibile ottenere le credenziali SSPI connessione al server fallita: %s
Verifica che il server locale sia in funzione e che
accetti connessioni sul socket di dominio Unix "%s"
connessione al server fallita: %s
Verifica che il server all'indirizzo "%s" (%s) sia in funzione
e che accetti connessioni TCP/IP sulla porta %s
connessione al server fallita: %s
Verifica che il server all'indirizzo "%s" sia in funzione
e che accetti connessioni TCP/IP sulla porta %s
creazione della struttura dati LDAP fallita
creazione del contesto SSL fallita: %s
creazione del socket fallita: %s
non è stato possibile stabilire una connessione SSL: %s
non è stato possibile ottenere l'indirizzo del client dal socket: %s
directory utente non trovata per la locazione del file di certificato radice
Per favore fornisci il file oppure cambia sslmode per disabilitare la verifica del certificato del server.
non è stato possibile ottenere le credenziali del peer: %s
impossibile ottenere il nome dell'host del server dal certificato del server
lettura dello stato di errore del socket fallita: %s
inizializzazione del motore SSL "%s" fallita: %s
errore nell'interpretazione del risultato dal server: %s caricamento del motore SSL "%s" fallito: %s
caricamento della chiave privata SSL "%s" dal motore "%s" fallito: %s
caricamento del file della chiave privata "%s" fallito: %s
ricerca dell'ID utente locale %d non riuscita: %s
apertura del file di certificato "%s" fallita: %s
apertura del file "%s" fallita: %s
lettura del file di certificato "%s" fallita: %s
lettura dal file "%s" fallita: %s
lettura del file della chiave privata SSL "%s" dal motore "%s" fallita: %s
lettura del file di certificato radice "%s" fallita: %s
ricezione dati dal server fallita: %s
invio del pacchetto di negoziazione SSL fallito: %s
invio dati al server fallito: %s
invio del pacchetto di avvio fallito: %s
impostazione del socket in modalità TCP no delay fallita: %s
impostazione del socket in modalità close-on-exec fallita: %s
impostazione del socket in modalità non bloccante fallita: %s
conversione del percorso del socket di dominio Unix "%s" in indirizzo fallita: %s
conversione del nome host "%s" in indirizzo fallita: %s
scrittura nel file "%s" fallita: %s
il file di definizione di servizio "%s" non è stato trovato
richiesta di autenticazione GSS duplicata
richiesta di autenticazione SSPI duplicata
fine stringa raggiunta cercando un "]" corrispondente nell'indirizzo host IPv6 nella URI: "%s"
prevista richiesta di autenticazione dal server, ma è stato ricevuto %c
separatore chiave/valore "=" in eccesso nei parametri della URI: "%s"
dati estranei nel messaggio di tipo "D" dati estranei nel messaggio di tipo "T" dati estranei nel messaggio di tipo "t" valore non ammesso %%00 nel valore percent-encoded: "%s"
la funzione richiede almeno il protocollo versione 3.0
il nome dell'host deve essere specificato
il nome dell'host dev'essere specificato per una connessione SSL verificata
carattere multibyte incompleto
dati insufficienti nel messaggio di tipo "D" dati insufficienti nel messaggio di tipo "T" intero di dimensione %lu non supportato da pqGetInt intero di dimensione %lu non supportato da pqPutInt codice ExecStatusType errato URL LDAP "%s" non corretta: numero di porta non valido
URL LDAP "%s" non corretta: distinguished name non trovato
URL LDAP "%s" non corretta: deve avere esattamente un attributo
URL LDAP "%s" non corretta: deve essere specificato la portata della ricerca (base/one/sub)
URL LDAP "%s" non corretta: filtro non specificato
URL LDAP "%s" non corretta: lo schema deve essere ldap://
URI invalida propagata alla routine di parsing interna: "%s"
parametro URI non valido: "%s"
opzione di connessione errata "%s"
stato connessione errato %d, probabilmente indica una corruzione di memoria
stato della connessione non valido, probabilmente indica una corruzione della memoria
simbolo percent-encoded non valido "%s"
numero di porta non valido: "%s"
stato %c di setenv non valido, probabilmente indica una corruzione di memoria
socket non valido
valore sslmode errato: "%s"
stato %c non valido, probabilmente indica una corruzione di memoria
il parametro keepalives dev'essere un intero
la lunghezza deve essere fornita per i parametri binari
la riga %d nel file di servizio "%s" è troppo lunga
l'utente locale con ID %d non esiste
ricerca del server LDAP fallita: %s
persa la sincronizzazione con il server, sto resettando la connessione persa la sincronizzazione con il server: ricevuto il tipo di messaggio "%c" di lunghezza %d
i contenuti del messaggio non sono in accordo con la lunghezza del tipo di messaggio "%c"
messaggio tipo 0x%02x arrivato dal server mentre era inattivo manca "=" dopo "%s" nella stringa di connessione
separatore chiave/valore "=" mancante nei parametri della URI: "%s"
trovata più di una voce nella ricerca LDAP
specifiche di servizio annidate non supportate nel file di servizio "%s", linea %d
nessun comando COPY in corso
nessun errore SSL riportato nessuna connessione al server
nessun elemento trovato per la ricerca LDAP
nessun messaggio di errore disponibile
il numero di parametri deve essere tra 0 e 65535
memoria esaurita memoria esaurita
errore di memoria nell'allocazione del buffer GSSAPI (%d) memoria esaurita per il risultato della query il parametro numero %d non è compreso tra 0 e %d password ottenuta dal file "%s"
Il file della chiave privata "%s" ha privilegi di accesso in lettura e scrittura per tutti; i permessi dovrebbero essere u=rw (0600) o inferiori
errore di protocollo: id=0x%x
la query per inizializzare le funzioni large object non hanno restituito dati
ricevuta risposta errata alla negoziazione SSL: %c
il parametro requirepeer non è supportato su questa piattaforma
requirepeer specifica "%s", ma il vero nome utente del peer è "%s"
il file "%s" del certificato radice non esiste
Per favore fornisci il file oppure cambia sslmode per disabilitare la verifica del certificato del server.
la riga numero %d non è compreso tra 0 e %d select() fallita: %s
il certificato per il server "%s" non combacia col nome host "%s"
il server ha chiuso la connessione inaspettatamente
Questo probabilmente indica che il server ha terminato in modo anormale
prima o durante l'elaborazione della richiesta.
il server non supporta SSL, ma SSL è stato richiesto
il server ha spedito dati binari (messaggio di tipo "B") senza prima il descrittore di riga (messaggio di tipo "T") il server ha spedito dati (messaggio di tipo "D") senza prima il descrittore di riga (messaggio di tipo "T") il server ha spedito dati (messaggio di tipo "D") senza prima il descrittore di riga (messaggio di tipo "T")
il file di servizio "%s" non è stato trovato
setsockopt(%s) fallita: %s
overflow size_t valore sslmode "%s" non valido quando il supporto SSL non è compilato
il nome dell'istruzione è un puntatore nullo
errore di sintassi del file di servizio "%s", alla riga %d
timeout scaduto
asyncStatus imprevisto: %d
carattere inatteso "%c" in posizione %d nella uri URI (atteso ":" oppure "/"): "%s"
carattere %c non previsto a seguito di una risposta vuota ad una query (messaggio "I") numero dei campi non previsto nel messaggio di tipo "D" messaggio imprevisto dal server durante l'avvio
risposta inattesa dal server; il primo carattere ricevuto era "%c"
codice di errore SSL sconosciuto: %d
errore socket sconosciuto: 0x%08X/%d stringa tra virgolette non terminata nella stringa di connessione
ricerca del nome utente fallita: codice di errore %lu
locale/it/LC_MESSAGES/pg_basebackup-9.6.mo 0000644 00000071337 14751153421 0013657 0 ustar 00 �� � � ,
� � � � � ! �
- X C T � R � ` D I � D � 4 3 F K z < � j > n N � @ � 3 = Y q > � 1
j < < � ? � M $ k r J � Y ) + � 0 � B � B # * f 8 � � � 5 Y � � r o � 1 � 3 , K ` - � F � \ ! P ~ 2 � 4 8 7 1 p 4 � 1 � . @ 8 1 y E � B � 7 4! l! �! ( �! ' �! & �! ; " ( Z" # �" - �" ' �" " �" # # A# 2 e# , �# + �# . �# ( $ # I$ 5 m$ f �$ ,
% 9 7% 4 q% 7 �% = �% d & A �& " �& & �& &
' # 4' / X' > �' a �' & )( & P( % w( 2 �( 1 �( 0 ) 8 3) ( l) 2 �) �) & �) ' * . 8* + g* # �* A �* 2 �* & ,+ & S+ / z+ + �+ 4 �+ / , ! ;, 1 ], ) �, ( �, 2 �, 2 - 3 H- 0 |- % �- # �- + �- #. @. 2 R. # �. �. , �. , �. # / i D/ i �/ ? 0 9 X0 " �0 A �0 # �0 1 9 <1 v1 �1 ! �1 D �1 & 2 # 92 A ]2 - �2 D �2 ! 3 43 O3 " f3 �3 9 �3 1 �3 D 4 , X4 �4 ' �4 D �4 M 5 : S5 8 �5 6 �5 �5 E 6 G ]6 z �6 c 7 % �7 . �7 2 �7 6 8 # C8 g8 % �8 0 �8 R �8 , *9 4 W9 K �9 @ �9 > : - X: , �: ' �: , �: o ; k x; 4 �; % < ( ?< ; h<
�< & �< �< / �< = / = � M= %? =? W? k? " ?
�? = �? Q �? N =@ W �@ ] �@ \ BA N �A �A 5 B T 7B E �B f �B B 9C N |C F �C = D Y PD ; �D 7 �D v E L �E D �E q 'F n �F P G k YG 0 �G 4 �G C +H I oH 8 �H D �H � 7I = �I �
J � �J u :K : �K 6 �K l "L / �L E �L [ M O aM ; �M > �M B ,N 7 oN E �N ? �N * -O U XO > �O H �O E 6P ? |P �P 0 �P 4 Q 2 =Q 0 pQ ? �Q , �Q ' R 1 6R . hR ' �R " �R % �R ? S 5 HS 3 ~S 2 �S / �S ( T C >T k �T 2 �T < !U A ^U K �U S �U n @V = �V $ �V + W > >W A }W N �W ` X i oX ( �X . Y . 1Y C `Y @ �Y R �Y I 8Z ; �Z K �Z %
[ - 0[ * ^[ / �[ X �[ 7 \ N J\ 9 �\ 1 �\ / ] 1 5] < g] ? �] 8 �] C ^ \ a^ / �^ - �^ 7 _ : T_ A �_ 2 �_ ( ` ) -` - W` �` �` : �` , �` a - @a / na ) �a u �a u >b I �b S �b ' Rc P zc , �c ( �c H !d $ jd �d ) �d [ �d F /e & ve M �e 8 �e V $f & {f �f �f 2 �f )
g M 7g 7 �g X �g < h Sh 0 ih S �h ` �h K Oi A �i G �i %j Z ?j ] �j � �j � ~k / l 5 1l 8 gl 8 �l 4 �l m % &m 5 Lm a �m : �m > n k ^n \ �n P 'o ; xo 2 �o > �o 2 &p l Yp o �p 8 6q ( oq 3 �q E �q
r - r
Kr : Vr �r ; �r 8 � � � t � v � 3 . F d M 7 � 1 j � � A � J ` � � O � r � � � � ^ N c " L - � + � u � � � x � � [ g � , p U T X � b $ h P Y e Z � � i � � � \ � < � � : � � K � a G � > ; ) ! � s � � 4 C � � � � � � ( k D w H � ' � � S ] � | f _ q = � � ? � � 9 6 � � 0 % 2
o � Q � � � � { �
R � m � z � � � E I ~ � / n � l � 5 @ V B � � � � � � y � � � � � } & # * W �
Action to be performed:
Connection options:
General options:
Optional actions:
Options controlling the output:
Options:
Report bugs to <pgsql-bugs@postgresql.org>.
--create-slot create a new replication slot (for the slot's name see --slot)
--drop-slot drop the replication slot (for the slot's name see --slot)
--if-not-exists do not error if slot already exists when creating a slot
--start start streaming in a replication slot (for the slot's name see --slot)
--synchronous flush transaction log immediately after writing
--xlogdir=XLOGDIR location for the transaction log directory
%s [OPTION]...
-?, --help show this help, then exit
-D, --directory=DIR receive transaction log files into this directory
-D, --pgdata=DIRECTORY receive base backup into directory
-F --fsync-interval=SECS
time between fsyncs to the output file (default: %d)
-F, --format=p|t output format (plain (default), tar)
-I, --startpos=LSN where in an existing slot should the streaming start
-P, --plugin=PLUGIN use output plugin PLUGIN (default: %s)
-P, --progress show progress information
-R, --write-recovery-conf
write recovery.conf for replication
-S, --slot=SLOTNAME name of the logical replication slot
-S, --slot=SLOTNAME replication slot to use
-T, --tablespace-mapping=OLDDIR=NEWDIR
relocate tablespace in OLDDIR to NEWDIR
-U, --username=NAME connect as specified database user
-V, --version output version information, then exit
-W, --password force password prompt (should happen automatically)
-X, --xlog-method=fetch|stream
include required WAL files with specified method
-Z, --compress=0-9 compress tar output with given compression level
-c, --checkpoint=fast|spread
set fast or spread checkpointing
-d, --dbname=CONNSTR connection string
-d, --dbname=DBNAME database to connect to
-f, --file=FILE receive log into this file, - for stdout
-h, --host=HOSTNAME database server host or socket directory
-l, --label=LABEL set backup label
-n, --no-loop do not loop on connection lost
-o, --option=NAME[=VALUE]
pass option NAME with optional value VALUE to the
output plugin
-p, --port=PORT database server port number
-r, --max-rate=RATE maximum transfer rate to transfer data directory
(in kB/s, or use suffix "k" or "M")
-s, --status-interval=INTERVAL
time between status packets sent to server (in seconds)
-s, --status-interval=SECS
time between status packets sent to server (default: %d)
-v, --verbose output verbose messages
-w, --no-password never prompt for password
-x, --xlog include required WAL files in backup (fetch mode)
-z, --gzip compress tar output
%*s/%s kB (%d%%), %d/%d tablespace %*s/%s kB (%d%%), %d/%d tablespaces %*s/%s kB (%d%%), %d/%d tablespace (%s%-*.*s) %*s/%s kB (%d%%), %d/%d tablespaces (%s%-*.*s) %*s/%s kB (100%%), %d/%d tablespace %*s %*s/%s kB (100%%), %d/%d tablespaces %*s %s controls PostgreSQL logical decoding streams.
%s receives PostgreSQL streaming transaction logs.
%s takes a base backup of a running PostgreSQL server.
%s: %s needs a slot to be specified using --slot
%s: COPY stream ended before last file was finished
%s: WAL streaming can only be used in plain mode
%s: at least one action needs to be specified
%s: can only write single tablespace to stdout, database has %d
%s: cannot specify both --xlog and --xlog-method
%s: cannot use --create-slot or --drop-slot together with --startpos
%s: cannot use --create-slot or --start together with --drop-slot
%s: cannot use --create-slot together with --drop-slot
%s: checkpoint completed
%s: child %d died, expected %d
%s: child process did not exit normally
%s: child process exited with error %d
%s: child thread exited with error %u
%s: confirming write up to %X/%X, flush to %X/%X (slot %s)
%s: could not access directory "%s": %s
%s: could not clear search_path: %s %s: could not close compressed file "%s": %s
%s: could not close directory "%s": %s
%s: could not close file "%s": %s
%s: could not connect to server
%s: could not connect to server: %s %s: could not create archive status file "%s": %s
%s: could not create background process: %s
%s: could not create background thread: %s
%s: could not create compressed file "%s": %s
%s: could not create directory "%s": %s
%s: could not create file "%s": %s
%s: could not create pipe for background process: %s
%s: could not create replication slot "%s": got %d rows and %d fields, expected %d rows and %d fields
%s: could not create symbolic link "%s": %s
%s: could not create symbolic link from "%s" to "%s": %s
%s: could not create timeline history file "%s": %s
%s: could not determine seek position in file "%s": %s
%s: could not determine server setting for integer_datetimes
%s: could not drop replication slot "%s": got %d rows and %d fields, expected %d rows and %d fields
%s: could not establish database-specific replication connection
%s: could not fsync file "%s": %s
%s: could not fsync log file "%s": %s
%s: could not get COPY data stream: %s %s: could not get backup header: %s %s: could not get child thread exit status: %s
%s: could not get transaction log end position from server: %s %s: could not identify system: got %d rows and %d fields, expected %d rows and %d or more fields
%s: could not initiate base backup: %s %s: could not open directory "%s": %s
%s: could not open log file "%s": %s
%s: could not open timeline history file "%s": %s
%s: could not open transaction log file "%s": %s
%s: could not pad transaction log file "%s": %s
%s: could not parse next timeline's starting point "%s"
%s: could not parse start position "%s"
%s: could not parse transaction log location "%s"
%s: could not read COPY data: %s %s: could not read directory "%s": %s
%s: could not read from ready pipe: %s
%s: could not receive data from WAL stream: %s %s: could not rename file "%s" to "%s": %s
%s: could not rename file "%s": %s
%s: could not seek to beginning of transaction log file "%s": %s
%s: could not send command to background pipe: %s
%s: could not send copy-end packet: %s %s: could not send feedback packet: %s %s: could not send replication command "%s": %s %s: could not set compression level %d: %s
%s: could not set permissions on directory "%s": %s
%s: could not set permissions on file "%s": %s
%s: could not stat file "%s": %s
%s: could not stat transaction log file "%s": %s
%s: could not wait for child process: %s
%s: could not wait for child thread: %s
%s: could not write %u bytes to WAL file "%s": %s
%s: could not write %u bytes to log file "%s": %s
%s: could not write timeline history file "%s": %s
%s: could not write to compressed file "%s": %s
%s: could not write to file "%s": %s
%s: creating replication slot "%s"
%s: directory "%s" exists but is not empty
%s: directory name too long
%s: disconnected
%s: disconnected; waiting %d seconds to try again
%s: dropping replication slot "%s"
%s: final receive failed: %s %s: finished segment at %X/%X (timeline %u)
%s: got WAL data offset %08x, expected %08x
%s: incompatible server version %s
%s: incompatible server version %s; client does not support streaming from server versions newer than %s
%s: incompatible server version %s; client does not support streaming from server versions older than %s
%s: initiating base backup, waiting for checkpoint to complete
%s: integer_datetimes compile flag does not match server
%s: invalid --max-rate unit: "%s"
%s: invalid checkpoint argument "%s", must be "fast" or "spread"
%s: invalid compression level "%s"
%s: invalid fsync interval "%s"
%s: invalid output format "%s", must be "plain" or "tar"
%s: invalid port number "%s"
%s: invalid socket: %s %s: invalid status interval "%s"
%s: invalid tablespace mapping format "%s", must be "OLDDIR=NEWDIR"
%s: invalid tar block header size: %d
%s: invalid transfer rate "%s": %s
%s: invalid xlog-method option "%s", must be "fetch" or "stream"
%s: multiple "=" signs in tablespace mapping
%s: new directory is not an absolute path in tablespace mapping: %s
%s: no data returned from server
%s: no database specified
%s: no slot specified
%s: no target directory specified
%s: no target file specified
%s: no transaction log end position returned from server
%s: not renaming "%s%s", segment is not complete
%s: old directory is not an absolute path in tablespace mapping: %s
%s: only tar mode backups can be compressed
%s: out of memory
%s: received interrupt signal, exiting
%s: received transaction log record for offset %u with no file open
%s: replication connection using slot "%s" is unexpectedly database specific
%s: replication slots can only be used with WAL streaming
%s: replication stream was terminated before stop point
%s: segment file "%s" has incorrect size %d, skipping
%s: select() failed: %s
%s: server reported unexpected history file name for timeline %u: %s
%s: server reported unexpected next timeline %u, following timeline %u
%s: server returned unexpected response to BASE_BACKUP command; got %d rows and %d fields, expected %d rows and %d fields
%s: server stopped streaming timeline %u at %X/%X, but reported next timeline %u to begin at %X/%X
%s: starting background WAL receiver
%s: starting log streaming at %X/%X (slot %s)
%s: starting log streaming at %X/%X (timeline %u)
%s: starting timeline %u is not present in the server
%s: streaming header too small: %d
%s: streaming initiated
%s: switched to timeline %u at %X/%X
%s: symlinks are not supported on this platform
%s: system identifier does not match between base backup and streaming connection
%s: this build does not support compression
%s: too many command-line arguments (first is "%s")
%s: transaction log directory location can only be specified in plain mode
%s: transaction log directory location must be an absolute path
%s: transaction log file "%s" has %d bytes, should be 0 or %d
%s: transfer rate "%s" exceeds integer range
%s: transfer rate "%s" is not a valid value
%s: transfer rate "%s" is out of range
%s: transfer rate must be greater than zero
%s: unexpected response to TIMELINE_HISTORY command: got %d rows and %d fields, expected %d rows and %d fields
%s: unexpected result set after end-of-timeline: got %d rows and %d fields, expected %d rows and %d fields
%s: unexpected termination of replication stream: %s %s: unrecognized link indicator "%c"
%s: unrecognized streaming header: "%c"
%s: waiting for background process to finish streaming ...
Password: Try "%s --help" for more information.
Usage:
cannot duplicate null pointer (internal error)
out of memory
transaction log start point: %s on timeline %u
Project-Id-Version: pg_basebackup (PostgreSQL) 9.6
Report-Msgid-Bugs-To: pgsql-bugs@postgresql.org
POT-Creation-Date: 2018-10-08 14:32+0000
PO-Revision-Date: 2018-10-08 22:16+0100
Last-Translator: Daniele Varrazzo <daniele.varrazzo@gmail.com>
Language-Team: https://github.com/dvarrazzo/postgresql-it
Language: it
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Plural-Forms: nplurals=2; plural=n != 1;
X-Generator: Poedit 2.0.6
Azioni da effettuare:
Opzioni di connessione:
Opzioni generali:
Azioni opzionali:
Opzioni di controllo del'output:
Opzioni:
Puoi segnalare eventuali bug a <pgsql-bugs@postgresql.org>.
--create-slot crea un nuovo slot di replica (per il nome vedi --slot)
--drop-slot elimina lo slot di replica (per il nome vedi --slot)
--if-not-exists non dare un errore se esiste già uno slot con lo stesso nome
--start avvia lo streaming in uno slot di replica (per il nome vedi --slot)
--synchronous esegui il flush del log delle transazioni subito dopo aver scritto
--xlogdir=XLOGDIR posizione per la directory del log delle transazioni
%s [OPZIONE]...
-?, --help mostra questo aiuto ed esci
-D, --directory=DIR ricevi i file di log delle transazioni in questa directory
-D, --pgdata=DIRECTORY directory in cui ricevere il backup di base
-F --fsync-interval=SEC
tempo tra i sync del file di output (default: %d)
-F, --format=p|t formato di output (plain (default), tar)
-I, --startpos=LSN dove deve partire lo streaming in uno slot esistente
-P, --plugin=PLUGIN usa il plugin di output PLUGIN (default: %s)
-P, --progress mostra informazioni sull'esecuzione
-R, --write-recovery-conf
scrivi recovery.conf per la replica
-S, --slot=NOMESLOT nome dello slot di replica logica
-S, --slot=NOMESLOT slot di replicazione da usare
-T, --tablespace-mapping=VECCHIADIR=NUOVADIR
sposta il tablespace da VECCHIADIR a NUOVADIR
-U, --username=NAME connettiti al database col nome utente specificato
-V, --version mostra informazioni sulla versione ed esci
-W, --password forza la richiesta della password
(dovrebbe essere automatico)
-X, --xlog-method=fetch|stream
includi i file WAL richiesti col metodo specificato
-Z, --compress=0-9 comprimi l'output tar a questo livello di compressione
-c, --checkpoint=fast|spread
imposta punti di controllo più veloci o più radi
-d, --dbname=CONNSTR stringa di connessione
-d, --dbname=NOMEDB database a cui connettersi
-f, --file=FILE riceve i log in questo file, - per stdout
-h, --host=HOSTNAME host del server database o directory del socket
-l, --label=LABEL imposta l'etichetta del backup
-n, --no-loop non ri-eseguire se la connessione è persa
-o, --option=NOME[=VALORE]
passa l'opzione NOME col valore opzionale VALORE
al plugin di output
-p, --port=PORT numero di porta del server database
-r, --max-rate=RATE transfer rate massimo per trasferire la directory dei dati
(in kB/s, oppure usa i suffissi "k" o "M")
-s, --status-interval=INTERVAL
intervallo tra i pacchetti di stato inviati al server
(in secondi)
-s, --status-interval=SEC
tempo tra i pacchetti di status inviati al server (default: %d)
-v, --verbose messaggi di output più numerosi
-w, --no-password non chiedere mai la password
-x, --xlog includi i file WAL necessari nel backup
(modalità fetch)
-z, --gzip comprimi l'output tar
%*s/%s kB (%d%%), %d/%d tablespace %*s/%s kB (%d%%), %d/%d tablespace %*s/%s kB (%d%%), %d/%d tablespace (%s%-*.*s) %*s/%s kB (%d%%), %d/%d tablespace (%s%-*.*s) %*s/%s kB (100%%), %d/%d tablespace %*s %*s/%s kB (100%%), %d/%d tablespace %*s %s controlla i flussi di decodifica logica di PostgreSQL.
%s riceve lo stream del log delle transazioni di PostgreSQL.
%s crea un backup di base di un server PostgreSQL in esecuzione.
%s: %s richiede la specifica di uno slot usando --slot
%s: lo stream COPY è terminato prima che l'ultimo file fosse finito
%s: lo streaming WAL può essere usato solo in modalità plain
%s: occorre specificare almeno una azione
%s: è possibile scrivere solo un singolo tablespace su stdout, il database ne ha %d
%s: non è possibile specificare sia --xlog che --xlog-method
%s: --create-slot o --drop-slot non possono essere usate con --startpos
%s: --create-slot o --start non possono essere usate con --drop-slot
%s: non è possibile usare --create-slot insieme a --drop-slot
%s: checkpoint completato
%s: il processo figlio %d interrotto, atteso %d
%s: il processo figlio non è terminato normalmente
%s: il processo figlio è terminato con errore %d
%s: il thread figlio è terminato con errore %u
%s: scritture confermate fino a %X/%X, flush a %X/%X (slot %s)
%s: accesso alla directory "%s" fallito: %s
%s: pulizia del search_path fallita: %s %s: chiusura del file compresso "%s" fallita: %s
%s: chiusura della directory "%s" fallita: %s
%s: chiusura del file "%s" fallita: %s
%s: connessione al server fallita
%s: connessione al server fallita: %s %s: creazione del file di stato dell'archivio "%s" fallita: %s
%s: creazione del processo in background fallita: %s
%s: creazione del thread in background fallita: %s
%s: creazione del file compresso "%s" fallita: %s
%s: creazione della directory "%s" fallita: %s
%s: creazione del file "%s" fallita: %s
%s: creazione della pipe per il processo in background fallita: %s
%s: creazione dello slot di replica "%s" fallita: ricevute %d righe e %d campi, attesi %d righe e %d campi
%s: creazione del link simbolico "%s" fallita: %s
%s: creazione del link simbolico da "%s" a "%s" fallita: %s
%s: creazione del file di storia della timeline "%s" fallita: %s
%s: determinazione della posizione dove muoversi nel file "%s" fallita: %s
%s: non è stato possibile determinare l'impostazione integer_datetimes del server
%s: eliminazione dello slot di replica "%s" fallita: ricevute %d righe e %d campi, attesi %d righe e %d campi
%s: connessione di replica specifica per il database fallita
%s: fsync del file "%s" fallito: %s
%s: fsync del file di log "%s" fallito: %s
%s: non è stato possibile ottenere lo stream di dati COPY: %s %s: non è stato possibile ottenere l'intestazione del backup: %s %s: non è stato possibile ottenere il codice di uscita del thread figlio: %s
%s: non è stato possibile ottenere la posizione finale del log delle transazioni dal server: %s %s: identificazione del sistema fallita: ricevute %d righe e %d campi, attese %d righe e %d o più campi
%s: avvio del backup di base fallito: %s %s: apertura della directory "%s" fallita: %s
%s: apertura del file di log "%s" fallita: %s
%s: apertura del file della storia della timeline "%s" fallita: %s
%s: apertura del file di log delle transazioni "%s" fallita: %s
%s: correzione della lunghezza del file di log delle transazioni "%s" fallita: %s
%s: interpretazione del punto d'inizio della nuova timeline "%s" fallita
%s: interpretazione della posizione di inizio "%s" fallita
%s: interpretazione della posizione del log delle transazioni "%s" fallita
%s: lettura dei dati COPY fallita: %s %s: lettura della directory "%s" fallita: %s
%s: lettura dalla pipe pronta fallita: %s
%s: ricezione dati dallo stream WAL fallita: %s %s: non è stato possibile rinominare il file di storia della timeline "%s" in "%s": %s
%s: non è stato possibile rinominare il file "%s": %s
%s: spostamento all'inizio del file di log delle transazioni "%s" fallito: %s
%s invio del comando alla pipe di background fallita: %s
%s: invio del pacchetto di fine copia fallito: %s %s: invio del pacchetto di feedback fallito: %s %s: invio del comando di replica "%s" fallito: %s %s: impostazione del livello di compressione %d fallito: %s
%s: impostazione dei permessi sulla directory "%s" fallita: %s
%s: impostazione dei permessi sul file "%s" fallita: %s
%s: non è stato possibile ottenere informazioni sul file "%s": %s
%s: non è stato possibile ottenere informazioni sul file di log delle transazioni "%s": %s
%s: errore nell'attesa del processo figlio: %s
%s: errore nell'attesa del thread figlio: %s
%s: scrittura di %u byte nel file WAL "%s" fallita: %s
%s: scrittura di %u byte nel file di log "%s" fallita: %s
%s: scrittura del file di storia della timeline "%s" fallita: %s
%s: scrittura nel file compresso "%s" fallita: %s
%s: scrittura nel file "%s" fallita: %s
%s: creazione dello slot di replica "%s"
%s: la directory "%s" esiste ma non è vuota
%s: nome directory troppo lungo
%s: disconnesso
%s: disconnesso; aspetterò %d secondi prima di riprovare
%s: eliminazione dello slot di replica "%s"
%s: ricezione finale fallita: %s %s: terminato segmento a %X/%X (timeline %u)
%s: ricevuto offset dati WAL %08x, atteso %08x
%s: versione del server incompatibile %s
%s: server di versione %s non compatibile; il client non supporta lo streaming da server di versione successiva a %s
%s: server di versione %s non compatibile; il client non supporta lo streaming da server di versione precedente a %s
%s: avvio del backup di base, in attesa del completamento del checkpoint
%s: l'opzione di compilazione integer_datetimes non combacia con quella del server
%s: unità --max-rate non valida: "%s"
%s: argomento di checkpoint "%s" non valido, deve essere "fast" oppure "spread"
%s: livello di compressione non valido "%s"
%s: intervallo di fsync "%s" non valido
%s: formato di output "%s" non valido, deve essere "plain" oppure "tar"
%s: numero di porta non valido "%s"
%s: socket non valido: %s %s: intervallo di status "%s" non valido
%s: formato di mappatura dei tablespace "%s" non valido, deve essere "VECCHIADIR=NUOVADIR"
%s: dimensione del blocco di intestazione del file tar non valida: %d
%s: transfer rate non valido "%s": %s
%s: opzione xlog-method "%s" non valida, deve essere "fetch" oppure "stream"
%s: più di un segno "=" nella mappatura dei tablespace
%s: la nuova directory non è un percorso assoluto nella mappatura dei tablespace: %s
%s: nessun dato restituito dal server
%s: database non specificato
%s: slot non specificato
%s: nessuna directory di destinazione specificata
%s: file di destinazione non specificato
%s: nessuna posizione finale del log delle transazioni restituita dal server
%s: "%s%s" non rinominato, il segmento non è completo
%s: la vecchia directory non è un percorso assoluto nella mappatura dei tablespace: %s
%s: solo i backup in modalità tar possono essere compressi
%s: memoria esaurita
%s: ricevuto segnale di interruzione, in uscita
%s: ricevuti record di log delle transazioni per offset %u senza alcun file aperto
%s: la replica di connessione usando lo slot "%s" è inaspettatamente specifica per il database
%s: gli slot di replica possono essere usati solo con lo streaming dei WAL
%s: lo stream di replica è terminato prima del punto di arresto
%s: il file di segmento "%s" ha la dimensione non corretta %d, saltato
%s: select() fallita: %s
%s: il server ha riportato un nome di file della storia imprevisto per la timeline %u: %s
%s: il server ha riportato la timeline successiva imprevista %u, a seguito della timeline %u
%s: il server ha restituito una risposta imprevista al comando BASE_BACKUP; ricevute %d righe e %d campi, attese %d righe e %d campi
%s: il server ha interrotto lo streaming della timeline %u a %X/%X, ma ha riportato l'inizio della timeline successiva %u a %X/%X
%s: avvio del ricevitore dei WAL in background
%s: inizio dello streaming dei log a %X/%X (slot %s)
%s: avvio dello streaming dei log a %X/%X (timeline %u)
%s: la timeline di inizio %u non è presente nel server
%s: intestazione dello streaming troppo piccola: %d
%s: streaming iniziato
%s: passato alla timeline %u a %X/%X
%s: questa piattaforma non supporta i link simbolici
%s: l'identificativo di sistema non combacia tra il backup di base e la connessione in streaming
%s: questo binario compilato non supporta la compressione
%s: troppi argomenti nella riga di comando (il primo è "%s")
%s: la posizione della directory del log delle transazioni può essere specificata solo in modalità plain
%s: la posizione della directory del log delle transazioni deve essere un percorso assoluto
%s: il file di log delle transazioni "%s" ha %d byte, dovrebbero essere 0 or %d
%s: il transfer rate "%s" eccede l'intervallo degli interi
%s: il transfer rate "%s" non è un valore valido
%s: il transfer rate "%s" è fuori dall'intervallo consentito
%s: il transfer rate deve essere maggiore di zero
%s: risposta inattesa al comando TIMELINE_HISTORY: ricevute %d righe e %d campi, attese %d righe e %d campi
%s: risultato imprevisto dopo la fine della timeline: ricevute %d righe e %d campi, attese %d righe e %d campi
%s: terminazione inaspettata dello stream di replica: %s %s: indicatore di link sconosciuto "%c"
%s: intestazione dello streaming sconosciuta: "%c"
%s: in attesa che il processo in background finisca lo streaming ...
Password: Prova "%s --help" per maggiori informazioni.
Utilizzo:
impossibile duplicare il puntatore nullo (errore interno)
memoria esaurita
punto di avvio log delle transazioni: %s sulla timeline %u
locale/it/LC_MESSAGES/pg_rewind-9.6.mo 0000644 00000047577 14751153421 0013060 0 ustar 00 �� � 4 � L
�
- �
1 �
? ) K i C � ; � C 5 9 y G � @ � < O H � � � � J > i , � 6 � < 1 I ? { = � = � 9 7 D q 4 � 9 � 4 % 2 Z @ � R � > ! ` g 1 � � � � � o
d z - � 4
& B i � � P R W c � - < [ / y ; � � � # ; _ % ~ � $ � + � $ : $ X L } , � 0 � " ( ) K , u � $ � $ � #
' . " V y " � & � $ � ( & O " p ' � � � � 2 - ' ` � ' � � / � - K 6 i � ; � ) � ! + 8! % d! �! �! ! �! 3 �! 6 " 1 J" |" ' �" < �" _ # `# t# ! �# F �# �# $ $ 1 7$ C i$ " �$ . �$ # �$ > #% 6 b% 3 �% 6 �% 0 & 5& + P& & |& �& �& ! �& ( ' I .' $ x' ' �' �' - �' J ( = [( A �( 6 �( 5 ) 5 H) ! ~) 7 �) / �) 6 * 1 ?* - q* 9 �* � �* = �, J - P T- R �- I �- = B. H �. @ �. L
/ L W/ �/ Y �/ 0 &0 D0 c0 |0 �0 H �0 N �0 7 01 @ h1 Q �1 A �1 D =2 I �2 D �2 L 3 L ^3 > �3 G �3 8 24 A k4 G �4 i �4 X _5 �5 # �5 ? �5 $6 46 " >6 ' a6 � �6 s 7 8 �7 L �7 - 8 48 � R8 U �8 W )9 n �9 < �9 / -: # ]: : �: @ �: �: ; # /; * S; # ~; 3 �; ! �; + �; 0 $< . U< * �< * �< _ �< 0 := 4 k= * �= . �= 3 �= # .> . R> 3 �> ' �> + �> ) ? " 3? " V? , y? + �? $ �? . �? & &@ , M@ 6 z@ " �@ �@ & �@ " A G >A 4 �A 1 �A + �A $ B 8 >B A wB $ �B < �B C H 7C - �C �C 0 �C - �C ,D # ID ' mD = �D ? �D ? E $ SE , xE \ �E r F uF �F " �F O �F # G ( 4G - ]G ; �G N �G ) H 5 @H ' vH G �H L �H I 3I ? }I I �I & J = .J 2 lJ 9 �J 6 �J * K A ;K S }K & �K ) �K % "L : HL H �L ? �L H M < UM 9 �M = �M !
N < ,N 1 iN 0 �N 0 �N 3 �N M 1O � & 5 � Z ~ � � � \ > t ! r � K � � % < f V � 1 } { : � k . b G
h S 6 � d � 8 � m J ( n ` s � � � A 9 � v E # � � 0 $ w 3 � � � a Q j � z � � ) � ^
C y M F ? i 2 c R e u � / o @ � ; � T Y x U + g N | _ L � I O H 4 P l = � � [ ' q , X - � � D B W ] " * � 7 p �
Report bugs to <pgsql-bugs@postgresql.org>.
creating backup label and updating control file
--debug write a lot of debug messages
--source-pgdata=DIRECTORY source data directory to synchronize with
--source-server=CONNSTR source server to synchronize with
-?, --help show this help, then exit
-D, --target-pgdata=DIRECTORY existing data directory to modify
-P, --progress write progress messages
-V, --version output version information, then exit
-n, --dry-run stop before modifying anything
block %u
"%s" is a symbolic link, but symbolic links are not supported on this platform
"%s" is not a directory
"%s" is not a regular file
"%s" is not a symbolic link
%*s/%s kB (%d%%) copied %d: %X/%X - %X/%X
%s (%s)
%s resynchronizes a PostgreSQL cluster with another copy of the cluster.
%s: WARNING: cannot create restricted tokens on this platform
%s: could not allocate SIDs: error code %lu
%s: could not create restricted token: error code %lu
%s: could not get exit code from subprocess: error code %lu
%s: could not open process token: error code %lu
%s: could not re-execute with restricted token: error code %lu
%s: could not start process for command "%s": error code %lu
%s: no source specified (--source-pgdata or --source-server)
%s: no target data directory specified (--target-pgdata)
%s: only one of --source-pgdata or --source-server can be specified
%s: too many command-line arguments (first is "%s")
BKPBLOCK_HAS_DATA not set, but data length is %u at %X/%X BKPBLOCK_HAS_DATA set, but no data included at %X/%X BKPBLOCK_SAME_REL set but no previous rel at %X/%X BKPIMAGE_HAS_HOLE not set, but hole offset %u length %u at %X/%X BKPIMAGE_HAS_HOLE set, but hole offset %u length %u block image length %u at %X/%X BKPIMAGE_IS_COMPRESSED set, but block image length %u at %X/%X Done!
Expected a numeric timeline ID.
Expected a transaction log switchpoint location.
Failure, exiting
Options:
Source timeline history:
Target timeline history:
The program "initdb" is needed by %s but was
not found in the same directory as "%s".
Check your installation.
The program "initdb" was found by "%s"
but was not the same version as %s.
Check your installation.
Timeline IDs must be in increasing sequence.
Timeline IDs must be less than child timeline's ID.
Try "%s --help" for more information.
Usage:
%s [OPTION]...
WAL file is from different database system: WAL file database system identifier is %s, pg_control database system identifier is %s WAL file is from different database system: incorrect XLOG_BLCKSZ in page header WAL file is from different database system: incorrect XLOG_SEG_SIZE in page header WAL record modifies a relation, but record type is not recognized
lsn: %X/%X, rmgr: %s, info: %02X
You must run %s as the PostgreSQL superuser.
backup label buffer too small
cannot be executed by "root"
cannot duplicate null pointer (internal error)
clusters are not compatible with this version of pg_rewind
connected to server
contrecord is requested by %X/%X could not clear search_path: %s could not close directory "%s": %s
could not close file "%s": %s
could not close target file "%s": %s
could not connect to server: %s could not create directory "%s": %s
could not create symbolic link at "%s": %s
could not create temporary table: %s could not fetch file list: %s could not fetch remote file "%s": %s could not find common ancestor of the source and target cluster's timelines
could not find previous WAL record at %X/%X
could not find previous WAL record at %X/%X: %s
could not open directory "%s": %s
could not open file "%s" for reading: %s
could not open file "%s" for truncation: %s
could not open file "%s": %s
could not open source file "%s": %s
could not open target file "%s": %s
could not read WAL record at %X/%X
could not read WAL record at %X/%X: %s
could not read directory "%s": %s
could not read file "%s": %s
could not read from file "%s": %s
could not read symbolic link "%s": %s
could not remove directory "%s": %s
could not remove file "%s": %s
could not remove symbolic link "%s": %s
could not seek in file "%s": %s
could not seek in source file: %s
could not seek in target file "%s": %s
could not send COPY data: %s could not send end-of-COPY: %s could not send file list: %s could not send query: %s could not set libpq connection to single row mode
could not set up connection context: %s could not stat file "%s": %s
could not truncate file "%s" to %u: %s
could not write file "%s": %s
data file "%s" in source is not a regular file
error running query (%s) in source server: %s fetched file "%s", length %d
full_page_writes must be enabled in the source server
getting file chunks
incorrect resource manager data checksum in record at %X/%X invalid action (CREATE) for regular file
invalid block_id %u at %X/%X invalid compressed image at %X/%X, block %d invalid contrecord length %u at %X/%X invalid control file invalid data in history file
invalid data in history file: %s
invalid info bits %04X in log segment %s, offset %u invalid magic number %04X in log segment %s, offset %u invalid record length at %X/%X: wanted %u, got %u invalid record offset at %X/%X invalid resource manager ID %u at %X/%X need to copy %lu MB (total source directory size is %lu MB)
neither BKPIMAGE_HAS_HOLE nor BKPIMAGE_IS_COMPRESSED set, but block image length is %u at %X/%X no rewind required
out of memory
out-of-order block_id %u at %X/%X out-of-sequence timeline ID %u (after %u) in log segment %s, offset %u reading WAL in target
reading source file list
reading target file list
received chunk for file "%s", offset %s, size %d
received null value for chunk for file "%s", file has been deleted
record length %u at %X/%X too long record with incorrect prev-link %X/%X at %X/%X record with invalid length at %X/%X rewinding from last common checkpoint at %X/%X on timeline %u
servers diverged at WAL position %X/%X on timeline %u
source and target cluster are on the same timeline
source and target clusters are from different systems
source data directory must be shut down cleanly
source file list is empty
source server must not be in recovery mode
symbolic link "%s" target is too long
sync of target directory failed
syncing target data directory
syntax error in history file: %s
target server must be shut down cleanly
target server needs to use either data checksums or "wal_log_hints = on"
there is no contrecord flag at %X/%X unexpected EOF while reading file "%s"
unexpected control file CRC
unexpected control file size %d, expected %d
unexpected data types in result set while fetching remote files: %u %u %u
unexpected null values in result while fetching remote files
unexpected page modification for directory or symbolic link "%s"
unexpected pageaddr %X/%X in log segment %s, offset %u unexpected result format while fetching remote files
unexpected result length while fetching remote files
unexpected result set from query
unexpected result set size while fetching remote files
unexpected result set while fetching file list
unexpected result set while fetching remote file "%s"
unexpected result while fetching remote files: %s unexpected result while sending file list: %s unrecognized result "%s" for current WAL insert location
Project-Id-Version: pg_rewind (PostgreSQL) 9.6
Report-Msgid-Bugs-To: pgsql-bugs@postgresql.org
POT-Creation-Date: 2018-10-08 14:33+0000
PO-Revision-Date: 2018-10-08 21:18+0100
Last-Translator: Daniele Varrazzo <daniele.varrazzo@gmail.com>
Language-Team: https://github.com/dvarrazzo/postgresql-it
Language: it
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Plural-Forms: nplurals=2; plural=n != 1;
X-Poedit-SourceCharset: utf-8
X-Generator: Poedit 2.0.6
Puoi segnalare eventuali bug a <pgsql-bugs@postgresql.org>.
creazione dell'etichetta di backup e aggiornamento del file di controllo
--debug stampa una gran quantità di messaggi di debug
--source-pgdata=DIRECTORY directory dati di partenza con cui sincronizzare
--source-server=CONNSTR server di origine con cui sincronizzare
-?, --help mostra questo aiuto ed esci
-D, --target-pgdata=DIRECTORY directory dati esistente da modificare
-P, --progress stampa messaggi di avanzamento
-V, --version stampa informazioni sulla versione ed esci
-n, --dry-run fermati prima di modificare qualunque cosa
blocco %u
"%s" è un link simbolico, ma i link simbolici non sono supportati su questa piattaforma
"%s" non è una directory
"%s" non è un file regolare
"%s" non è un link simbolico
%*s/%s kB (%d%%) copiati %d: %X/%X - %X/%X
%s (%s)
%s risincronizza un cluster PostgreSQL con un'altra copia del cluster.
%s: ATTENZIONE: non è possibile creare token ristretti su questa piattaforma
%s: allocazione dei SID fallita: codice di errore: %lu
%s: creazione del token ristretto fallita: codice di errore %lu
%s: lettura del codice di uscita del sottoprocesso fallita: codice di errore %lu
%s: apertura del token di processo fallita: codice di errore %lu
%s: ri-esecuzione con token ristretto fallita: codice di errore %lu
%s: avvio del processo fallito per il comando "%s": codice di errore %lu
%s: nessuna origine specificata (--source-pgdata o --source-server)
%s: nessuna directory di dati di destinazione specificata (--target-pgdata)
%s: è possibile specificare solo uno tra --source-pgdata e --source-server
%s: troppi argomenti nella riga di comando (il primo è "%s")
BKPBLOCK_HAS_DATA non impostato, ma la lunghezza dei dati è %u a %X/%X BKPBLOCK_HAS_DATA impostato, ma dati non inclusi a %X/%X BKPBLOCK_SAME_REL impostato ma non c'è un rel precedente a %X/%X BKPIMAGE_HAS_HOLE non impostato, ma offset buco %u lunghezza %u a %X/%X BKPIMAGE_HAS_HOLE impostato, ma offset buco %u lunghezza %u lunghezza dell'immagine del blocco %u a %X/%X BKPIMAGE_IS_COMPRESSED impostato, ma la lunghezza dell'immagine del blocco è %u a %X/%X Fatto!
Atteso un ID numerico di timeline.
Attesa una locazione di switchpoint del log delle transazioni.
Errore, uscita
Opzioni:
Storia della timeline di origine:
Storia della timeline di destinazione:
Il programma "initdb" è richiesto da %s ma non è
stato tro vato nella stessa directory di "%s".
Controlla la tua installazione.
Il programma "initdb" è stato trovato da "%s"
ma non è la stessa versione di %s.
Controlla la tua installazione.
Gli ID di timeline devono essere in sequenza crescente.
Gli ID della timeline devono essere meno dell'ID della timeline del figlio.
Prova "%s --help" per maggiori informazioni.
Utilizzo:
%s [OPZIONE]...
il file WAL è di un database diverso: l'identificativo del database del file WAL è %s, quello del database di pg_control è %s il file WAL è di un database diverso: XLOG_BLCKSZ non corretto nell'header di pagina il file WAL è di un database diverso: XLOG_SEG_SIZE non corretto nell'header di pagina il file WAL modifica una relazione, ma il tipo di record non è riconosciuto
lsn: %X/%X, rmgr: %s, info: %02X
È obbligatorio eseguire %s come superutente di PostgreSQL.
buffer dell'etichetta di backup troppo piccolo
non può essere eseguito da "root"
impossibile duplicare il puntatore nullo (errore interno)
i cluster non sono compatibili con questa versione di pg_rewind
connesso al server
contrecord richiesto da %X/%X pulizia del search_path fallita: %s chiusura della directory "%s" fallita: %s
chiusura del file "%s" fallita: %s
chiusura del file di destinazione "%s" fallita: %s
connessione al server fallita: %s creazione della directory "%s" fallita: %s
creazione del link simbolico a "%s" fallita: %s
creazione della tabella temporanea fallita: %s ricezione della lista dei file fallita: %s ricezione del file remoto "%s" fallita: %s impossibile trovare un antenato comune nelle timeline dei cluster di origine e di destinazione
ricerca del file WAL precedente a %X/%X fallita
ricerca del file WAL precedente a %X/%X fallita: %s
apertura della directory "%s" fallita: %s
apertura del file "%s" in lettura fallita: %s
apertura del file "%s" per troncamento fallita: %s
apertura del file "%s" fallita: %s
apertura del file di origine "%s" fallita: %s
apertura del file di destinazione "%s" fallita: %s
lettura del record WAL a %X/%X fallita
lettura del record WAL a %X/%X fallita: %s
lettura della directory "%s" fallita: %s
lettura del file "%s" fallita: %s
lettura dal file "%s" fallita: %s
lettura del link simbolico "%s" fallita: %s
rimozione della directory "%s" fallita: %s
rimozione del file "%s" fallita: %s
rimozione del link simbolico "%s" fallita: %s
spostamento nel file "%s" fallito: %s
spostamento nel file di origine fallito: %s
spostamento nel file di destinazione "%s" fallito: %s
invio dei dati di COPY fallito: %s invio del fine-COPY fallito: %s invio della lista dei file fallito: %s invio della query non riuscito: %s impostazione della connessione libpq in modalità riga singola fallita
preparazione del contesto di connessione fallita: %s richiesta informazioni sul file "%s" fallita: %s
troncamento del file "%s" a %u fallito: %s
scrittura nel file "%s" fallita: %s
il file di dati di origine "%s" non è un file regolare
errore nell'esecuzione della query (%s) nel server di origine: %s ricevuto il file "%s", lunghezza %d
full_page_writes dev'essere abilitato nel server di origine
ricezione blocchi del file
checksum dei dati del manager di risorse non corretto nel record a %X/%X azione non valida (CREATE) per file regolari
block_id %u non valido a %X/%X immagine compressa non valida a %X/%X, blocco %d lunghezza di contrecord %u non valida a %X/%X file di controllo non valido dati non validi nel file di storia
dati non validi nel file di storia: %s
bit di info %04X non validi nel segmento di log %s, offset %u numero magico %04X non valido nel segmento di log %s, offset %u lunghezza del record a %X/%X non valida: attesa %u, ricevuta %u offset del record non valido a %X/%X ID di gestione risorse %u non valido a %X/%X è necessario copiare %lu MB (la dimensione totale della directory di origine è di %lu MB)
né BKPIMAGE_HAS_HOLE né BKPIMAGE_IS_COMPRESSED impostati, ma la lunghezza dell'immagine del blocco è %u a %X/%X rewind non richiesto
memoria esaurita
block_id fuori sequenza %u a %X/%X ID della timeline %u (dopo %u) fuori sequenza nel segmento di log %s, offset %u lettura del WAL nella destinazione
lettura della lista dei file di origine
lettura della lista dei file di destinazione
ricevuto blocco per il file "%s", offset %s, dimensione %d
ricevuto valore null per il blocco del file "%s", il file è stato cancellato
lunghezza del record %u a %X/%X eccessiva record con link-precedente %X/%X non corretto a %X/%X record con lunghezza non valida a %X/%X riavvolgimento dall'ultimo checkpoint comune a %X/%X sulla timeline %u
i server sono andati a divergere alla posizione WAL %X/%X sulla timeline %u
i cluster di origine e di destinazione sono sulla stessa linea temporale
i cluster di origine e di destinazione sono di sistemi diversi
la directory dei dati di origine deve essere arrestata in maniera pulita
la lista dei file di origine è vuota
il server di origine non dev'essere in modalità di recupero
destinazione del link simbolico "%s" troppo lunga
sincronizzazione della directory di destinazione fallita
sincronizzazione della directory dati di destinazione
errore di sintassi nel file di storia: %s
il server di destinazione dev'essere arrestato in maniera pulita
il server di destinazione deve usare o il checksum dei dati o "wal_log_hints = on"
non c'è un flag di contrecord a %X/%X fine file inattesa leggendo il file "%s"
CRC del file di controllo imprevisto
dimensione del file di controllo %d imprevista, atteso %d
tipo di dati imprevisto nel risultato ricevendo i file remoti: %u %u %u
valori null non previsti nel risultato ricevendo i file remoti
modifica di pagina imprevista per la directory o il link simbolico "%s"
pageaddr inaspettato %X/%X nel segmento di log %s, offset %u formato del risultato imprevisto ricevendo i file remoti
lunghezza del risultato non prevista ricevendo i file remoti
risultato imprevisto dalla query
dimensione del risultato imprevisto ricevendo i file remoti
risultato imprevisto ricevendo la lista dei file
risultato inatteso leggendo il file remoto "%s"
risultato imprevisto ricevendo i file remoti: %s risultato imprevisto inviando la lista dei file: %s risultato "%s" non riconosciuto per la locazione di inserimento WAL corrente
locale/it/LC_MESSAGES/ecpg-9.6.mo 0000644 00000034774 14751153421 0012013 0 ustar 00 �� { � � � h
~ i
- �
0 + G g s � 4 � 7 0 s h . � G
4 S
) �
w �
4 * _ @ r = � , � ! @ , ^ 1 � * � - � 1 ' H & p + � " � # �
) = < z � & � < � ! & - 0 + ^ " � � , � � * 3 " ^ ' � � � ! � � ! 5 J 3 k / � ' � ) � * ! 5 L I � , � / � * ) T T ' � � � 1 - K , y , � 5 � ) % ? O 8 � � � _ 0 y 5 � � A � L 7 + �
� 6 � ' � # A ( N 4 w ) � � / � # < $ ] � " � , � � ' " J i $ � D � + � ? 0 Z � 8 � � & F � g � T! = �! 9 $" - ^" } �" #
# 5 .# < d# � �# 5 #$ F Y$ 2 �$ 0 �$ � % ? �% �% O �% ; /& 0 k& ' �& 2 �& < �& ; 4' 4 p' 7 �' ; �' 1 ( 0 K( 5 |( # �( ) �( ) / ) a 9) �) �) - �) H �) % 9* _* % l* 6 �* * �* �* 2 + B+ c+ 3 �+ 6 �+ 0 �+ , ;, % V, |, ! �, �, , �, C �, ? >- 9 ~- 4 �- , �- C . S ^. 8 �. 4 �. D / ] e/ - �/ & �/ " 0 ;0 P0 g0 3 0 2 �0 2 �0 ? 1 Y1 / r1 F �1 = �1 � '2 �2 ? �2 > 3 \3 F q3 U �3 5 4 D4 B U4 + �4 ) �4 �4 / 5 B 15 ) t5 �5 = �5 ! �5 ) 6 $ F6 k6 ' �6 = �6 �6 ) 7 . ,7 + [7 $ �7 9 �7 K �7 5 28 E h8 9 �8 % �8 F 9 ! U9 ) w9 . �9 + �9 j 4 f g ? ^ l x
T ( 9 u 8 _ L t I d \ % ) < i = ' Q N & : M v , 7 B . z ; S n # > P " H r ] [ ! * s Z 6 G A O - X 2 q 3 W w 1 k + U e Y o K p 0 a J 5 { h c m E C @ V F D y R / ` $
b
If no output file is specified, the name is formed by adding .c to the
input file name, after stripping off .pgc if present.
Report bugs to <pgsql-bugs@postgresql.org>.
--regression run in regression testing mode
-?, --help show this help, then exit
-C MODE set compatibility mode; MODE can be one of
"INFORMIX", "INFORMIX_SE"
-D SYMBOL define SYMBOL
-I DIRECTORY search DIRECTORY for include files
-V, --version output version information, then exit
-c automatically generate C code from embedded SQL code;
this affects EXEC SQL TYPE
-d generate parser debug output
-h parse a header file, this option includes option "-c"
-i parse system include files as well
-o OUTFILE write result to OUTFILE
-r OPTION specify run-time behavior; OPTION can be:
"no_indicator", "prepare", "questionmarks"
-t turn on autocommit of transactions
%s at or near "%s" %s is the PostgreSQL embedded SQL preprocessor for C programs.
%s, the PostgreSQL embedded C preprocessor, version %d.%d.%d
%s: could not locate my own executable path
%s: could not open file "%s": %s
%s: no input files specified
%s: parser debug support (-d) not available
AT option not allowed in CLOSE DATABASE statement AT option not allowed in CONNECT statement AT option not allowed in DISCONNECT statement AT option not allowed in SET CONNECTION statement AT option not allowed in TYPE statement AT option not allowed in VAR statement AT option not allowed in WHENEVER statement COPY FROM STDIN is not implemented CREATE TABLE AS cannot specify INTO ERROR: EXEC SQL INCLUDE ... search starts here:
Error: include path "%s/%s" is too long on line %d, skipping
Options:
SHOW ALL is not implemented Try "%s --help" for more information.
Unix-domain sockets only work on "localhost" but not on "%s" Usage:
%s [OPTION]... FILE...
WARNING: arrays of indicators are not allowed on input could not open include file "%s" on line %d could not remove output file "%s"
cursor "%s" does not exist cursor "%s" has been declared but not opened cursor "%s" is already defined descriptor "%s" does not exist descriptor header item "%d" does not exist descriptor item "%s" cannot be set descriptor item "%s" is not implemented end of search list
expected "://", found "%s" expected "@" or "://", found "%s" expected "@", found "%s" expected "postgresql", found "%s" incomplete statement incorrectly formed variable "%s" indicator for array/pointer has to be array/pointer indicator for simple data type has to be simple indicator for struct has to be a struct indicator struct "%s" has too few members indicator struct "%s" has too many members indicator variable "%s" is hidden by a local variable indicator variable "%s" is hidden by a local variable of a different type indicator variable must have an integer type initializer not allowed in EXEC SQL VAR command initializer not allowed in type definition internal error: unreachable state; please report this to <pgsql-bugs@postgresql.org> interval specification not allowed here invalid bit string literal invalid connection type: %s invalid data type key_member is always 0 missing "EXEC SQL ENDIF;" missing identifier in EXEC SQL DEFINE command missing identifier in EXEC SQL IFDEF command missing identifier in EXEC SQL UNDEF command missing matching "EXEC SQL IFDEF" / "EXEC SQL IFNDEF" more than one EXEC SQL ELSE multidimensional arrays are not supported multidimensional arrays for simple data types are not supported multidimensional arrays for structures are not supported multilevel pointers (more than 2 levels) are not supported; found %d level multilevel pointers (more than 2 levels) are not supported; found %d levels nested /* ... */ comments nested arrays are not supported (except strings) no longer supported LIMIT #,# syntax passed to server nullable is always 1 only data types numeric and decimal have precision/scale argument only protocols "tcp" and "unix" and database type "postgresql" are supported operator not allowed in variable definition out of memory pointer to pointer is not supported for this data type pointers to varchar are not implemented subquery in FROM must have an alias syntax error syntax error in EXEC SQL INCLUDE command too many levels in nested structure/union definition too many nested EXEC SQL IFDEF conditions type "%s" is already defined type name "string" is reserved in Informix mode unmatched EXEC SQL ENDIF unrecognized data type name "%s" unrecognized descriptor item code %d unrecognized token "%s" unrecognized variable type code %d unsupported feature will be passed to server unterminated /* comment unterminated bit string literal unterminated hexadecimal string literal unterminated quoted identifier unterminated quoted string using unsupported DESCRIBE statement using variable "%s" in different declare statements is not supported variable "%s" is hidden by a local variable variable "%s" is hidden by a local variable of a different type variable "%s" is neither a structure nor a union variable "%s" is not a pointer variable "%s" is not a pointer to a structure or a union variable "%s" is not an array variable "%s" is not declared variable "%s" must have a numeric type zero-length delimited identifier Project-Id-Version: ecpg (PostgreSQL) 9.6
Report-Msgid-Bugs-To: pgsql-bugs@postgresql.org
POT-Creation-Date: 2018-10-08 14:27+0000
PO-Revision-Date: 2018-10-08 20:43+0100
Last-Translator: Daniele Varrazzo <daniele.varrazzo@gmail.com>
Language-Team: https://github.com/dvarrazzo/postgresql-it
Language: it
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Plural-Forms: nplurals=2; plural=n != 1;
X-Poedit-SourceCharset: utf-8
X-Generator: Poedit 2.0.6
Se non viene specificato nessun file di output, il nome è composto aggiungendo
.c al nome del file di input, dopo aver tolto .pgc se presente.
Puoi segnalare eventuali bug a <pgsql-bugs@postgresql.org>.
--regression esegui in modalità test di regressione
-?, --help mostra questo aiuto ed esci
-C MODO imposta la modalità di compatibilità; MODO può essere uno
tra "INFORMIX", "INFORMIX_SE"
-D SIMBOLO definisci SIMBOLO
-I DIRECTORY cerca gli include file in DIRECTORY
-V --version mostra informazioni sulla versione ed esci
-c genera automaticamente il codice C dal codice SQL embedded;
questo ha effetto su EXEC SQL TYPE
-d genera l'output di debug del parser
-h analizza un file header, questa opzione include "-c"
-i analizza anche i file di sistema
-o FILEOUT scrive il risultato in FILEOUT
-r OPZIONE specifica il comportamento run-time; OPZIONE può essere:
"no_indicator", "prepare", "questionmarks"
-t attiva il commit automatico delle transazioni
%s a o presso "%s" %s è il preprocessore SQL embedded di PostgreSQL per programmi scritti in C.
%s, preprocessore embedded C PostgreSQL, versione %d.%d.%d
%s: percorso del proprio eseguibile non trovato
%s: apertura del file "%s" fallita: %s
%s: non è stato specificato nessun file di input
%s: il supporto al debug del parser (-d) non è disponibile
l'opzione AT non è permessa nell'istruzione CLOSE DATABASE l'opzione AT non è permessa nell'istruzione CONNECT l'opzione AT non è permessa nell'istruzione DISCONNECT l'opzione AT non è permessa nell'istruzione SET CONNECTION l'opzione AT non è permessa nell'istruzione TYPE l'opzione AT non è permessa nell'istruzione VAR l'opzione AT non è permessa nell'istruzione WHENEVER COPY FROM STDIN non è implementato CREATE TABLE AS non può specificare INTO ERRORE: EXEC SQL INCLUDE ... la ricerca inizia da qui:
Errore: il percorso delle inclusioni "%s/%s" è troppo lungo alla riga %d, perciò viene saltato
Opzioni:
SHOW ALL non è implementato Prova "%s --help" per maggiori informazioni.
i socket di dominio Unix funzionano solo con "localhost" ma non con "%s" Utilizzo:
%s [OPZIONE]... FILE...
ATTENZIONE: array di indicatori non sono permessi apertura del file di include "%s" alla riga %d fallita rimozione del file di output "%s" fallita
il cursore "%s" non esiste il cursore "%s" è stato dichiarato, ma non aperto il cursore "%s" è già definito il descrittore "%s" non esiste la voce "%d" dell'header del descrittore non esiste la voce "%s" del descrittore non può essere impostata la voce "%s" del descrittore non è implementata fine della lista di ricerca
atteso "://", trovato "%s" atteso "@" oppure "://", trovato "%s" atteso "@", trovato "%s" atteso "postgresql", trovato "%s" istruzione incompleta variabile "%s" composta in maniera scorretta un indicatore per un array/puntatore deve essere un array/puntatore un indicatore per un tipo di dato semplice deve essere semplice un indicatore per una struttura deve essere una struttura l'indicatore struttura "%s" non ha abbastanza membri l'indicatore struttura "%s" ha troppi membri la variabile di indicatore "%s" è nascosta da una variabile locale la variabile di indicatore "%s" è nascosta da una variabile locale di tipo diverso il tipo di variabile di un indicatore deve essere intero initializer non è permesso nel comando EXEC SQL VAR l'inizializzatore non è permesso nella definizione del tipo di dato errore interno: stato non raggiungibile, si prega di segnalarlo a <pgsql-bugs@postgresql.org> specificazione di intervallo non permessa qui bit nella stringa letterale non valido tipo di connessione non valido: %s tipo dato non valido key_member è sempre 0 manca "EXEC SQL ENDIF;" identificativo mancante nel comando EXEC SQL DEFINE identificativo mancante nel comando EXEC SQL IFDEF identificativo mancante nel comando EXEC SQL UNDEF mancata corrispondenza fra "EXEC SQL IFDEF" / "EXEC SQL IFNDEF" più di un EXEC SQL ELSE gli array multidimensionali non sono supportati gli array multidimensionali per tipi dato semplici non sono supportati gli array multidimensionali per strutture non sono supportati puntatori a più livelli (più di 2) non sono supportati; trovato %d livello puntatori a più livelli (più di 2) non sono supportati; trovati %d livelli commenti /* ... */ annidati array annidati non sono supportati (tranne che per le stringhe) la sintassi LIMIT #,# passata al server non è più supportata nullable è sempre 1 solo i dati di tipo numeric e decimal hanno argomento precisione/scala soltanto i protocolli "tcp" e "unix" ed il tipo database "postgresql" sono supportati operatore non permesso nella definizione di variabile memoria esaurita il puntatore a puntatore non è supportato per questo tipo di dato i puntatori a varchar non sono implementati la sottoquery in FROM deve avere un alias errore di sintassi errore di sintassi nel comando EXEC SQL INCLUDE troppi livelli nidificati nella definizione della struttura/unione troppe condizioni EXEC SQL IFDEF annidate il tipo "%s" è già definito il nome di tipo "string" è riservato alla modalità Informix EXEC SQL ENDIF non corrispondente tipo di dato chiamato "%s" è sconosciuto descrittore di codice %d sconosciuto token "%s" sconosciuto tipo di variabile sconosciuto codice %d al server è stata richiesta una funzionalità non supportata commento /* non terminato letterale di stringa di bit non terminato letterale di stringa esadecimale non terminato identificativo tra virgolette non terminato stringa tra virgolette non terminata si sta utilizzando una istruzione DESCRIBE non supportata usare la variabile "%s" in una diversa istruzione declare non è supportato la variabile "%s" è nascosta da una variabile locale la variabile "%s" è nascosta da una variabile locale di tipo diverso la variabile "%s" non è né una struttura né una unione la variabile "%s" non è un puntatore la variabile "%s" non è un puntatore ad una struttura o ad una unione la variabile "%s" non è un array la variabile "%s" non è stata dichiarata la variabile "%s" deve essere di tipo numerico identificativo delimitato di lunghezza zero locale/it/LC_MESSAGES/ecpglib6-9.6.mo 0000644 00000007430 14751153421 0012555 0 ustar 00 �� ! $ / , � � � � ) ' - Q : 0 � $ � ( 9 L * c ; � > � 3 < = & z 1 � � + � ' @ % Y � , � � 2 0 ; / l � � � � � � � + � 1 � R ,
;
+ �
9 �
! : 1 S = � K � @ I P / � D �
( -
6 V
�
, �
0 �
6 ' % ^ 2 � 1 � . �
! <DEFAULT> <empty> NULL SQL error %d on line %d SQL error: %s
connection "%s" does not exist on line %d could not connect to database "%s" on line %d could not convert boolean value: size mismatch, on line %d data read from server is not an array on line %d descriptor "%s" not found on line %d descriptor index out of range on line %d empty message text empty query on line %d error in transaction processing on line %d inserting an array of variables is not supported on line %d invalid input syntax for floating-point type: "%s", on line %d invalid input syntax for type int: "%s", on line %d invalid input syntax for type unsigned int: "%s", on line %d invalid statement name "%s" on line %d invalid syntax for type boolean: "%s", on line %d no data found on line %d not connected to connection "%s" on line %d null value without indicator on line %d out of memory on line %d the connection to the server was lost too few arguments on line %d too many arguments on line %d unrecognized descriptor item "%s" on line %d unsupported type "%s" on line %d variable does not have a character type on line %d variable does not have a numeric type on line %d variable does not have an array type on line %d Project-Id-Version: ecpglib (PostgreSQL) 9.6
Report-Msgid-Bugs-To: pgsql-bugs@postgresql.org
POT-Creation-Date: 2016-04-17 00:07+0000
PO-Revision-Date: 2012-10-30 13:08+0100
Last-Translator: Daniele Varrazzo <daniele.varrazzo@gmail.com>
Language-Team: https://github.com/dvarrazzo/postgresql-it
Language: it
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
X-Poedit-SourceCharset: utf-8
Plural-Forms: nplurals=2; plural=n != 1;
X-Generator: Poedit 1.5.4
<DEFAULT> <empty> NULL errore SQL %d alla riga %d errore SQL: %s
la connessione "%s" non esiste alla riga %d connessione fallita al database "%s" alla riga %d conversione fallita per il valore booleano: dimensione incompatibile, alla riga %d i dati letti dal server non sono di tipo array alla riga %d il descrittore "%s" non esiste alla riga %d l'indice del descrittore è fuori intervallo alla riga %d messaggio di testo vuoto query vuota alla riga %d errore nel processare la transazione alla riga %d inserire un array di variabili non è supportato alla riga %d sintassi in input non valida per il tipo floating-point: "%s", alla riga %d sintassi in input non valida per il tipo int: "%s", alla riga %d sintassi in input non valida per il tipo unsigned int: "%s", alla riga %d nome di istruzione non valido "%s" alla riga %d sintassi in input non valida per il tipo boolean: "%s", alla riga %d non ci sono dati alla riga %d connessione "%s" non attiva alla riga %d valore nullo senza variabile 'indicatore' alla riga %d memoria esaurita alla riga %d la connessione con il server è andata persa numero di argomenti non sufficiente alla riga %d troppi argomenti alla riga %d elemento del descrittore "%s" sconosciuto alla riga %d tipo "%s" non supportato alla riga %d la variabile non è di tipo carattere alla riga %d la variabile non è di tipo numerico alla riga %d la variabile non è di tipo array alla riga %d locale/it/LC_MESSAGES/pg_config-9.6.mo 0000644 00000014621 14751153421 0013015 0 ustar 00 �� * l ; � � E � 0 � : 3 E n I � L � s K K � = B I i � G � J > M � M � ? % G e > � 6 � < # > ` F � P � I 7
4 �
2 �
* �
. , 8 & e � & � � ( � ! B V c � u G i C � � D m N q � t . � � s & G � L � n / L � r � u ^ u � J J l � H E K F � F � P b p j � 9 > 4 x 9 � � < - L
z , � & � 4 � ' / W o ~ % * ) $
" '
& ( ! #
%s provides information about the installed version of PostgreSQL.
With no arguments, all known items are shown.
%s [OPTION]...
--bindir show location of user executables
--cc show CC value used when PostgreSQL was built
--cflags show CFLAGS value used when PostgreSQL was built
--cflags_sl show CFLAGS_SL value used when PostgreSQL was built
--configure show options given to "configure" script when
PostgreSQL was built
--cppflags show CPPFLAGS value used when PostgreSQL was built
--docdir show location of documentation files
--htmldir show location of HTML documentation files
--includedir show location of C header files of the client
interfaces
--includedir-server show location of C header files for the server
--ldflags show LDFLAGS value used when PostgreSQL was built
--ldflags_ex show LDFLAGS_EX value used when PostgreSQL was built
--ldflags_sl show LDFLAGS_SL value used when PostgreSQL was built
--libdir show location of object code libraries
--libs show LIBS value used when PostgreSQL was built
--localedir show location of locale support files
--mandir show location of manual pages
--pgxs show location of extension makefile
--pkgincludedir show location of other C header files
--pkglibdir show location of dynamically loadable modules
--sharedir show location of architecture-independent support files
--sysconfdir show location of system-wide configuration files
--version show the PostgreSQL version
-?, --help show this help, then exit
%s: could not find own program executable
%s: invalid argument: %s
Options:
Report bugs to <pgsql-bugs@postgresql.org>.
Try "%s --help" for more information.
Usage:
could not change directory to "%s": %s could not find a "%s" to execute could not identify current directory: %s could not read binary "%s" could not read symbolic link "%s" invalid binary "%s" not recorded pclose failed: %s Project-Id-Version: pg_config (PostgreSQL) 9.6
Report-Msgid-Bugs-To: pgsql-bugs@postgresql.org
POT-Creation-Date: 2017-05-22 15:43+0000
PO-Revision-Date: 2017-04-23 03:04+0100
Last-Translator: Daniele Varrazzo <daniele.varrazzo@gmail.com>
Language-Team: https://github.com/dvarrazzo/postgresql-it
Language: it
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Plural-Forms: nplurals=2; plural=n != 1;
X-Poedit-SourceCharset: utf-8
X-Generator: Poedit 1.8.7.1
%s fornisce informazioni circa la versione di PostgreSQL installata.
Senza argomenti, vengono mostrati tutti gli elementi conosciuti.
%s [OPZIONE]...
--bindir mostra la posizione degli eseguibili utente
--cc mostra il valore di CC usato alla compilazione di
PostgreSQL
--cflags mostra il valore di CFLAGS usato alla compilazione
di PostgreSQL
--cflags_sl mostra il valore di CFLAGS_SL usato alla compilazione
di PostgreSQL
--configure mostra le opzioni fornite allo script "configure"
alla compilazione di PostgreSQL
--cppflags mostra il valore di CPPFLAGS usato alla compilazione
di PostgreSQL
--docdir mostra la posizione dei file di documentazione
--htmldir mostra la posizione dei file di documentazione HTML
--includedir mostra la posizione dei file header C delle interfacce
client
--includedir-server mostra la posizione dei file header C per il server
--ldflags mostra il valore di LDFLAGS usato alla compilazione
di PostgreSQL
--ldflags_ex mostra il valore di LDFLAGS_EX usato alla compilazione
di PostgreSQL
--ldflags_sl mostra il valore di LDFLAGS_SL usato alla compilazione
di PostgreSQL
--libdir mostra la posizione delle librerie codice oggetto
--libs mostra il valore LIBS usato alla compilazione di
PostgreSQL
--localedir mostra la posizione dei file di supporto locale
--mandir mostra la posizione delle pagine del manuale
--pgxs mostra la posizione delle estensioni makefile
--pkgincludedir mostra la posizione degli altri file header C
--pkglibdir mostra la posizione dei moduli caricabili dinamicamente
--sharedir mostra la posizione dei file di supporto non dipendenti dall'architettura
--sysconfdir mostra la posizione dei file di configurazione
di sistema
--version mostra la versione di PostgreSQL
-?, --help mostra questo aiuto ed esci
%s: il proprio programma eseguibile non è stato trovato
%s: parametro non valido: %s
Opzioni:
Puoi segnalare eventuali bug a <pgsql-bugs@postgresql.org>.
Prova "%s --help" per maggiori informazioni.
Utilizzo:
spostamento nella directory "%s" fallito: %s programma "%s" da eseguire non trovato identificazione della directory corrente fallita: %s lettura del binario "%s" fallita lettura del link simbolico "%s" fallita binario non valido "%s" non registrato pclose fallita: %s locale/es/LC_MESSAGES/pg_ctl-9.6.mo 0000644 00000045607 14751153421 0012335 0 ustar 00 �� � � � < P D Q ? � � � &
0
P
- o
�
�
= �
! � A � a � K P � A � ! � 3 ? O H � D � C E a ? � ? � > ' 9 f L � B � E 0 � v 0 � F , > s 8 � I � % 5 2 [ O � 7 � & M 8 - � ! � > � E C [ y � 9 D S C � D � > ! A ` ( � , � 2 � 6 + > b * � / � % � 1 " 0 T # � � 4 � 2 � 1 / 0 a , � . � 3 � " + B 1 n 6 � : � 1 * D " o 7 � " � $ � J ] y 3 � 0 � � ! $ 6 [ - | � 4 � % � $ %! " J! ! m! F �! u �! F L" �" 7 �" ) �" k # ` u# % �# & �# #$ d +$ �$ / �$ & �$ 0 % . 7% ) f% ) �% �% �% & �%
& , +& ( X& �& ! �& �& �& �& �& ' "' 8' I' Y' j' z' " �' �' � �' L ~) R �) + * J* ( ^* " �* $ �* 0 �* + # + > ?+ ) ~+ �+ � �+ U, h u, K �, *- C E- �- 9 �- I �- r ,. y �. v / ~ �/ G 0 O W0 k �0 9 1 W M1 F �1 G �1 � 42 5 �2 L 3 H P3 L �3 K �3 , 24 8 _4 j �4 J 5 N5 V5 _5 Z w5 8 �5 ' 6 H 36 h |6 T �6 � :7 O �7 f -8 f �8 g �8 [ c9 e �9 0 %: 7 V: C �: @ �: H ; . \; 0 �; 2 �; ? �; > /< , n< & �< B �< F = = L= / �= 2 �= 2 �= F > ' g> 9 �> @ �> D
? G O? F �? , �? # @ > /@ / n@ / �@ Q �@ ! A " BA ; eA A �A �A / B + 2B - ^B D �B * �B G �B , DC ) qC * �C ( �C P �C � @D D �D #
E A 1E ) sE w �E u F 5 �F 2 �F �F � �F ' �G 5 �G 1 �G 5 H 5 KH / �H / �H �H �H - I , =I 7 jI / �I ! �I + �I J @J QJ cJ J �J % �J �J �J �J ' K ' 8K & `K ? L y ' { � V r � & $ o @ � � P b [ - C U � " ( _ . � ; X Y ! 6 � A B = / w � % 7 E K
v
J q c M , ~ # 3 ) 0 W � F s � ] 1 ` u } � � � h � f x m t d : z j � * g S O 9 Q D < G I 4 > 2 5 N Z � | l ^ p i + a H R n 8 � e � � T \ k
%s: -w option cannot use a relative socket directory specification
%s: -w option is not supported when starting a pre-9.1 server
Allowed signal names for kill:
Common options:
Options for register and unregister:
Options for start or restart:
Options for stop or restart:
Report bugs to <pgsql-bugs@postgresql.org>.
Shutdown modes are:
Start types are:
%s init[db] [-D DATADIR] [-s] [-o "OPTIONS"]
%s kill SIGNALNAME PID
%s promote [-D DATADIR] [-s]
%s register [-N SERVICENAME] [-U USERNAME] [-P PASSWORD] [-D DATADIR]
[-S START-TYPE] [-w] [-t SECS] [-o "OPTIONS"]
%s reload [-D DATADIR] [-s]
%s restart [-w] [-t SECS] [-D DATADIR] [-s] [-m SHUTDOWN-MODE]
[-o "OPTIONS"]
%s start [-w] [-t SECS] [-D DATADIR] [-s] [-l FILENAME] [-o "OPTIONS"]
%s status [-D DATADIR]
%s stop [-W] [-t SECS] [-D DATADIR] [-s] [-m SHUTDOWN-MODE]
%s unregister [-N SERVICENAME]
-?, --help show this help, then exit
-D, --pgdata=DATADIR location of the database storage area
-N SERVICENAME service name with which to register PostgreSQL server
-P PASSWORD password of account to register PostgreSQL server
-S START-TYPE service start type to register PostgreSQL server
-U USERNAME user name of account to register PostgreSQL server
-V, --version output version information, then exit
-W do not wait until operation completes
-c, --core-files allow postgres to produce core files
-c, --core-files not applicable on this platform
-e SOURCE event source for logging when running as a service
-l, --log=FILENAME write (or append) server log to FILENAME
-m, --mode=MODE MODE can be "smart", "fast", or "immediate"
-o OPTIONS command line options to pass to postgres
(PostgreSQL server executable) or initdb
-p PATH-TO-POSTGRES normally not necessary
-s, --silent only print errors, no informational messages
-t, --timeout=SECS seconds to wait when using -w option
-w wait until operation completes
auto start service automatically during system startup (default)
demand start service on demand
fast quit directly, with proper shutdown
immediate quit without complete shutdown; will lead to recovery on restart
smart quit after all clients have disconnected
done
failed
stopped waiting
%s is a utility to initialize, start, stop, or control a PostgreSQL server.
%s: -S option not supported on this platform
%s: PID file "%s" does not exist
%s: WARNING: cannot create restricted tokens on this platform
%s: WARNING: could not locate all job object functions in system API
%s: another server might be running; trying to start server anyway
%s: cannot be run as root
Please log in (using, e.g., "su") as the (unprivileged) user that will
own the server process.
%s: cannot promote server; server is not in standby mode
%s: cannot promote server; single-user server is running (PID: %ld)
%s: cannot reload server; single-user server is running (PID: %ld)
%s: cannot restart server; single-user server is running (PID: %ld)
%s: cannot set core file size limit; disallowed by hard limit
%s: cannot stop server; single-user server is running (PID: %ld)
%s: could not access directory "%s": %s
%s: could not allocate SIDs: error code %lu
%s: could not create promote signal file "%s": %s
%s: could not create restricted token: error code %lu
%s: could not determine the data directory using command "%s"
%s: could not find own program executable
%s: could not find postgres program executable
%s: could not open PID file "%s": %s
%s: could not open process token: error code %lu
%s: could not open service "%s": error code %lu
%s: could not open service manager
%s: could not read file "%s"
%s: could not register service "%s": error code %lu
%s: could not remove promote signal file "%s": %s
%s: could not send promote signal (PID: %ld): %s
%s: could not send reload signal (PID: %ld): %s
%s: could not send signal %d (PID: %ld): %s
%s: could not send stop signal (PID: %ld): %s
%s: could not start server
Examine the log output.
%s: could not start server: %s
%s: could not start server: error code %lu
%s: could not start service "%s": error code %lu
%s: could not unregister service "%s": error code %lu
%s: could not wait for server because of misconfiguration
%s: could not write promote signal file "%s": %s
%s: database system initialization failed
%s: directory "%s" does not exist
%s: directory "%s" is not a database cluster directory
%s: invalid data in PID file "%s"
%s: missing arguments for kill mode
%s: no database directory specified and environment variable PGDATA unset
%s: no operation specified
%s: no server running
%s: old server process (PID: %ld) seems to be gone
%s: option file "%s" must have exactly one line
%s: server does not shut down
%s: server is running (PID: %ld)
%s: service "%s" already registered
%s: service "%s" not registered
%s: single-user server is running (PID: %ld)
%s: the PID file "%s" is empty
%s: too many command-line arguments (first is "%s")
%s: unrecognized operation mode "%s"
%s: unrecognized shutdown mode "%s"
%s: unrecognized signal name "%s"
%s: unrecognized start type "%s"
(The default is to wait for shutdown, but not for start or restart.)
HINT: The "-m fast" option immediately disconnects sessions rather than
waiting for session-initiated disconnection.
If the -D option is omitted, the environment variable PGDATA is used.
Is server running?
Please terminate the single-user server and try again.
Server started and accepting connections
The program "%s" is needed by %s but was not found in the
same directory as "%s".
Check your installation.
The program "%s" was found by "%s"
but was not the same version as %s.
Check your installation.
Timed out waiting for server startup
Try "%s --help" for more information.
Usage:
WARNING: online backup mode is active
Shutdown will not complete until pg_stop_backup() is called.
Waiting for server startup...
cannot duplicate null pointer (internal error)
child process exited with exit code %d child process exited with unrecognized status %d child process was terminated by exception 0x%X child process was terminated by signal %d child process was terminated by signal %s command not executable command not found could not change directory to "%s": %s could not find a "%s" to execute could not get current working directory: %s
could not identify current directory: %s could not read binary "%s" could not read symbolic link "%s" invalid binary "%s" out of memory
pclose failed: %s server is still starting up
server promoting
server shutting down
server signaled
server started
server starting
server stopped
starting server anyway
waiting for server to shut down... waiting for server to start... Project-Id-Version: pg_ctl (PostgreSQL 9.6)
Report-Msgid-Bugs-To: pgsql-bugs@postgresql.org
POT-Creation-Date: 2020-05-15 23:53+0000
PO-Revision-Date: 2017-08-28 11:37+0200
Last-Translator: Carlos Chapi <carlos.chapi@2ndquadrant.com>
Language-Team: PgSQL Español <pgsql-es-ayuda@postgresql.org>
Language: es
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
X-Generator: Poedit 1.8.7
%s: la opción -w no puede usar una especificación relativa de directorio
%s: la opción -w no está soportada cuando se inicia un servidor anterior a 9.1
Nombres de señales permitidos para kill:
Opciones comunes:
Opciones para registrar y dar de baja:
Opciones para inicio y reinicio:
Opciones para detener o reiniciar:
Reporte errores a <pgsql-bugs@postgresql.org>.
Modos de detención son:
Tipos de inicio del servicio son:
%s init[db] [-D DATADIR] [-s] [-o "OPCIONES"]
%s kill NOMBRE-SEÑAL ID-DE-PROCESO
%s promote [-D DATADIR] [-s]
%s register [-N SERVICIO] [-U USUARIO] [-P PASSWORD] [-D DATADIR]
[-S TIPO-INICIO] [-w] [-t SEGS] [-o «OPCIONES»]
%s reload [-D DATADIR] [-s]
%s restart [-w] [-t SEGS] [-D DATADIR] [-s] [-m MODO-DETENCIÓN]
[-o «OPCIONES»]
%s start [-w] [-t SEGS] [-D DATADIR] [-s] [-l ARCHIVO] [-o "OPCIONES"]
%s status [-D DATADIR]
%s stop [-W] [-t SEGS] [-D DATADIR] [-s] [-m MODO-DETENCIÓN]
%s unregister [-N SERVICIO]
-?, --help mostrar esta ayuda, luego salir
-D, --pgdata DATADIR ubicación del área de almacenamiento de datos
-N SERVICIO nombre de servicio con el cual registrar
el servidor PostgreSQL
-P CONTRASEÑA contraseña de la cuenta con la cual registrar
el servidor PostgreSQL
-S TIPO-INICIO tipo de inicio de servicio con que registrar
el servidor PostgreSQL
-U USUARIO nombre de usuario de la cuenta con la cual
registrar el servidor PostgreSQL
-V, --version mostrar información de versión, luego salir
-W no esperar hasta que la operación se haya completado
-c, --core-files permite que postgres produzca archivos
de volcado (core)
-c, --core-files no aplicable en esta plataforma
-e ORIGEN origen para el log de eventos cuando se ejecuta como servicio
-l --log=ARCHIVO guardar el registro del servidor en ARCHIVO.
-m, --mode=MODO puede ser «smart», «fast» o «immediate»
-o OPCIONES parámetros de línea de órdenes a pasar a postgres
(ejecutable del servidor de PostgreSQL) o initdb
-p RUTA-A-POSTGRES normalmente no es necesario
-s, --silent mostrar sólo errores, no mensajes de información
-t, --timeout=SEGS segundos a esperar cuando se use la opción -w
-w esperar hasta que la operación se haya completado
auto iniciar automáticamente al inicio del sistema (por omisión)
demand iniciar el servicio en demanda
fast salir directamente, con apagado apropiado
immediate salir sin apagado completo; se ejecutará recuperación
en el próximo inicio
smart salir después que todos los clientes se hayan desconectado
listo
falló
abandonando la espera
%s es un programa para inicializar, iniciar, detener o controlar
un servidor PostgreSQL.
%s: la opción -S no está soportada en esta plataforma
%s: el archivo de PID «%s» no existe
%s: ATENCIÓN: no se pueden crear tokens restrigidos en esta plataforma
%s: ATENCIÓN: no fue posible encontrar todas las funciones de gestión de tareas en la API del sistema
%s: otro servidor puede estar en ejecución; tratando de iniciarlo de todas formas.
%s: no puede ser ejecutado como «root»
Por favor conéctese (usando, por ejemplo, «su») con un usuario no privilegiado,
quien ejecutará el proceso servidor.
%s: no se puede promover el servidor;
el servidor no está en modo «standby»
%s: no se puede promover el servidor;
un servidor en modo mono-usuario está en ejecución (PID: %ld)
%s: no se puede recargar el servidor;
un servidor en modo mono-usuario está en ejecución (PID: %ld)
%s: no se puede reiniciar el servidor;
un servidor en modo mono-usuario está en ejecución (PID: %ld)
%s: no se puede establecer el límite de archivos de volcado;
impedido por un límite duro
%s: no se puede detener el servidor;
un servidor en modo mono-usuario está en ejecución (PID: %ld)
%s: no se pudo acceder al directorio «%s»: %s
%s: no se pudo emplazar los SIDs: código de error %lu
%s: no se pudo crear el archivo de señal de promoción «%s»: %s
%s: no se pudo crear el token restringido: código de error %lu
%s: no se pudo determinar el directorio de datos usando la orden «%s»
%s: no se pudo encontrar el ejecutable propio
%s: no se pudo encontrar el ejecutable postgres
%s: no se pudo abrir el archivo de PID «%s»: %s
%s: no se pudo abrir el token de proceso: código de error %lu
%s: no se pudo abrir el servicio «%s»: código de error %lu
%s: no se pudo abrir el gestor de servicios
%s: no se pudo leer el archivo «%s»
%s: no se pudo registrar el servicio «%s»: código de error %lu
%s: no se pudo eliminar el archivo de señal de promoción «%s»: %s
%s: no se pudo enviar la señal de promoción (PID: %ld): %s
%s: la señal de recarga falló (PID: %ld): %s
%s: no se pudo enviar la señal %d (PID: %ld): %s
%s: falló la señal de detención (PID: %ld): %s
%s: no se pudo iniciar el servidor.
Examine el registro del servidor.
%s: no se pudo iniciar el servidor: %s
%s: no se pudo iniciar el servidor: código de error %lu
%s: no se pudo iniciar el servicio «%s»: código de error %lu
%s: no se pudo dar de baja el servicio «%s»: código de error %lu
%s: no se pudo esperar al servidor debido a un error de configuración
%s: no se pudo escribir al archivo de señal de promoción «%s»: %s
%s: falló la creación de la base de datos
%s: el directorio «%s» no existe
%s: el directorio «%s» no es un directorio de base de datos
%s: datos no válidos en archivo de PID «%s»
%s: argumentos faltantes para envío de señal
%s: no se especificó directorio de datos y la variable PGDATA no está definida
%s: no se especificó operación
%s: no hay servidor en ejecución
%s: el proceso servidor antiguo (PID: %ld) parece no estar
%s: archivo de opciones «%s» debe tener exactamente una línea
%s: el servidor no se detiene
%s: el servidor está en ejecución (PID: %ld)
%s: el servicio «%s» ya está registrado
%s: el servicio «%s» no ha sido registrado
%s: un servidor en modo mono-usuario está en ejecución (PID: %ld)
%s: el archivo de PID «%s» está vacío
%s: demasiados argumentos de línea de órdenes (el primero es «%s»)
%s: modo de operación «%s» no reconocido
%s: modo de apagado «%s» no reconocido
%s: nombre de señal «%s» no reconocido
%s: tipo de inicio «%s» no reconocido
(Por omisión se espera para las detenciones, pero no los inicios o reinicios)
SUGERENCIA: La opción «-m fast» desconecta las sesiones inmediatamente
en lugar de esperar que cada sesión finalice por sí misma.
Si la opción -D es omitida, se usa la variable de ambiente PGDATA.
¿Está el servidor en ejecución?
Por favor termine el servidor mono-usuario e intente nuevamente.
Servidor iniciado y aceptando conexiones
%s necesita el programa «%s», pero no pudo encontrarlo en el mismo
directorio que «%s».
Verifique su instalación.
El programa «%s» fue encontrado por «%s», pero no es
de la misma versión que «%s».
Verifique su instalación.
Se agotó el tiempo de espera al inicio del servidor
Use «%s --help» para obtener más información.
Empleo:
ATENCIÓN: el modo de respaldo en línea está activo
El apagado no se completará hasta que se invoque la función pg_stop_backup().
Esperando que el servidor se inicie...
no se puede duplicar un puntero nulo (error interno)
el proceso hijo terminó con código de salida %d el proceso hijo terminó con código no reconocido %d el proceso hijo fue terminado por una excepción 0x%X el proceso hijo fue terminado por una señal %d el proceso hijo fue terminado por una señal %s la orden no es ejecutable orden no encontrada no se pudo cambiar el directorio a «%s»: %s no se pudo encontrar un «%s» para ejecutar no se pudo obtener el directorio de trabajo actual: %s
no se pudo identificar el directorio actual: %s no se pudo leer el binario «%s» no se pudo leer el enlace simbólico «%s» el binario «%s» no es válido memoria agotada
pclose falló: %s servidor aún iniciándose
servidor promoviendo
servidor deteniéndose
se ha enviado una señal al servidor
servidor iniciado
servidor iniciándose
servidor detenido
iniciando el servidor de todas maneras
esperando que el servidor se detenga... esperando que el servidor se inicie... locale/es/LC_MESSAGES/pg_config-9.6.mo 0000644 00000015001 14751153421 0013001 0 ustar 00 �� * l ; � � E � 0 � : 3 E n I � L � s K K � = B I i � G � J > M � M � ? % G e > � 6 � < # > ` F � P � I 7
4 �
2 �
* �
. , 8 & e � & � � ( � ! B V c � u D L [ � H � P l V o � � 3 n � L ' Q t } � p D m � p # p � g j m x � D Q l � i O m | � w : : � 7 � . % # T
x / � + � � - � , / C ! s + � �
� � % * ) $
" '
& ( ! #
%s provides information about the installed version of PostgreSQL.
With no arguments, all known items are shown.
%s [OPTION]...
--bindir show location of user executables
--cc show CC value used when PostgreSQL was built
--cflags show CFLAGS value used when PostgreSQL was built
--cflags_sl show CFLAGS_SL value used when PostgreSQL was built
--configure show options given to "configure" script when
PostgreSQL was built
--cppflags show CPPFLAGS value used when PostgreSQL was built
--docdir show location of documentation files
--htmldir show location of HTML documentation files
--includedir show location of C header files of the client
interfaces
--includedir-server show location of C header files for the server
--ldflags show LDFLAGS value used when PostgreSQL was built
--ldflags_ex show LDFLAGS_EX value used when PostgreSQL was built
--ldflags_sl show LDFLAGS_SL value used when PostgreSQL was built
--libdir show location of object code libraries
--libs show LIBS value used when PostgreSQL was built
--localedir show location of locale support files
--mandir show location of manual pages
--pgxs show location of extension makefile
--pkgincludedir show location of other C header files
--pkglibdir show location of dynamically loadable modules
--sharedir show location of architecture-independent support files
--sysconfdir show location of system-wide configuration files
--version show the PostgreSQL version
-?, --help show this help, then exit
%s: could not find own program executable
%s: invalid argument: %s
Options:
Report bugs to <pgsql-bugs@postgresql.org>.
Try "%s --help" for more information.
Usage:
could not change directory to "%s": %s could not find a "%s" to execute could not identify current directory: %s could not read binary "%s" could not read symbolic link "%s" invalid binary "%s" not recorded pclose failed: %s Project-Id-Version: pg_config (PostgreSQL 9.6)
Report-Msgid-Bugs-To: pgsql-bugs@postgresql.org
POT-Creation-Date: 2020-05-15 23:52+0000
PO-Revision-Date: 2016-05-23 09:38-0500
Last-Translator: Carlos Chapi <carlos.chapi@2ndquadrant.com>
Language-Team: es <pgsql-es-ayuda@postgresql.org>
Language: es
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
X-Generator: Poedit 1.8.7
%s provee información sobre la versión instalada de PostgreSQL.
Si no se pasa ningún argumento, se muestra toda la información conocida
%s [OPCIÓN]...
--bindir muestra la ubicación de ejecutables de usuario
--cc muestra el valor de CC cuando PostgreSQL fue construido
--cflags muestra el valor de CFLAGS cuando PostgreSQL fue
construido
--cflags_sl muestra el valor de CFLAGS_SL cuando PostgreSQL fue
construido
--configure muestra las opciones que se dieron a «configure»
cuando PostgreSQL fue construido
--cppflags muestra el valor de CPPFLAGS cuando PostgreSQL fue
construido
--docdir muestra la ubicación de archivos de documentación
--htmldir muestra la ubicación de archivos de documentación HTML
--includedir muestra la ubicación de archivos de encabezados C
de las interfaces cliente
--includedir-server muestra la ubicación de archivos de encabezados C
del servidor
--ldflags muestra el valor de LDFLAGS cuando PostgreSQL fue
construido
--ldflags_ex muestra el valor de LDFLAGS_EX cuando PostgreSQL fue
construido
--ldflags_sl muestra el valor de LDFLAGS_SL cuando PostgreSQL fue
construido
--libdir muestra la ubicación de bibliotecas
de código objeto
--libs muestra el valor de LIBS cuando PostgreSQL fue
construido
--localedir muestra la ubicación de archivos de soporte de
configuraciones locales
--mandir muestra la ubicación de páginas de manual
--pgxs muestra la ubicación del archivo makefile
para extensiones
--pkgincludedir muestra la ubicación de otros archivos de
encabezados C
--pkglibdir muestra la ubicación de módulos para carga dinámica
--sharedir muestra la ubicación de archivos de soporte
independientes de arquitectura
--sysconfdir muestra la ubicación de archivos de configuración
global del sistema
--version muestra la versión de PostgreSQL
-?, --help muestra esta ayuda, luego sale
%s: no se pudo encontrar el ejecutable propio
%s: el argumento no es válido: %s
Opciones:
Reporte errores a <pgsql-bugs@postgresql.org>.
Use «%s --help» para mayor información.
Empleo:
no se pudo cambiar el directorio a «%s»: %s no se pudo encontrar un «%s» para ejecutar no se pudo identificar el directorio actual: %s no se pudo leer el binario «%s» no se pudo leer el enlace simbólico «%s» el binario «%s» no es válido no registrado pclose falló: %s locale/es/LC_MESSAGES/libpq5-9.6.mo 0000644 00000060475 14751153421 0012261 0 ustar 00 �� � | � 0 1 B E J P b
x ' � ( � � # � - $ : _ y
� 0 � ( � ( � * 6 5 = 8 s 0 � � $ � # # G S - e 8 � � � . ( 3 , \ � � : � " � ! < 2 a o 0 � ) ' , * T . + � ' � ' * * * U + � * � , � ) ) . + X - � / � + � ( ) 7 & a 5 � 3 � & � ! ; V k " � v � w ! r � ! - O ' l - � � � # V 9 z & � ) � * # 0 9 T ) � ' � ) �
) ( " R 9 u . � ' � * ! " 1! " T! . w! / �! - �! @ " 2 E" ! x" % �" % �" & �" V
# = d# ; �# �# �# $ 4 ;$ 0 p$ �$ : �$ �$ % :% - [% - �% �% + �% 2 �% 7 2& = j& ! �& . �& 8 �& " 2' U' F u' C �' $ ( %( B @( �( �( ; �( ( �( * ) & @) % g) ! �) 6 �) C �) ? ** 2 j* 1 �* = �* )
+ J 7+ �+ �+ �+ �+ �+ 1 ,
7, E, + T, �, ) �, " �, [ �, H- ? a- 1 �- 8 �- > . � K. # �. �. : / � @/ 2 �/ Q �/ J O0 K �0 �0 1 1 ? .1 ! n1 + �1 �1 �1 L �1 D 62 % {2 . �2 C �2 3 $ 53 5 Z3 ) �3 � �3 \5 p5 s5 x5 ~5 �5 �5 - �5 . �5 " 6 8 B6 {6
�6 9 �6 �6 % �6 $7 9 57 = o7 = �7 �7
�7 8 < 8 ? H8 A �8 % �8 , �8 2 9 P9 _9 ; w9 F �9 �9 / : G D: 2 �: / �: �: ; ? ; 7 Z; �; �; P �; � < @ �< ) �< = 3 *= 7 ^= 4 �= 0 �= 5 �= 6 2> 6 i> 7 �> 6 �> 8 ? 5 H? 5 ~? 7 �? 9 �? ; &@ 7 b@ 4 �@ 5 �@ ( A ; .A ? jA 4 �A & �A + B 2B QB ( rB � �B � /C � �C ! XD % zD �D ( �D A �D � +E 6 �E K 5F 8 �F / �F 4 �F * G F JG < �G 0 �G 6 �G ' 6H 5 ^H & �H T �H 9 I * JI 5 uI ( �I + �I < J 5 =J : sJ H �J : �J ) 2K 4 \K , �K - �K p �K X ]L B �L % �L % M % EM 9 kM . �M , �M N N PN ' pN ' �N 8 �N 8 �N * 2O 9 ]O 8 �O ? �O K P , \P 8 �P C �P % Q ' ,Q L TQ O �Q , �Q % R O DR �R ! �R E �R / S : ?S > zS % �S & �S A T Z HT N �T > �T L 1U E ~U 2 �U ] �U ! UV ! wV ! �V 2 �V # �V 5 W HW XW - iW : �W 7 �W -
X � 8X �X P �X C ,Y @ pY U �Y � Z 1 �Z �Z T �Z � Q[ 2 �[ m 0\ e �\ f ] 0 k] �] �] P �] * !^ ; L^ �^ �^ Z �^ T _ . o_ D �_ ^ �_ ' B` 3 j` [ �` B �` � l � A � O � m . M f � d � H @ � t * � k U � 4 � � a � � / G � T % � 5 Y u �
, � � r � � R 7 6 � � � z � � S : ! ; 1 [ L � - � Z � x ` s n � " � K ' � � y
b � 8 3 � � � � = ^ # < � � � � c F ( � \ p v Q N � � � 9 � ~ q � � o � � J � B w $ V } W D � E � � 2 � h � & i � _ � � 0 � � � � X > � g e ? ) � � � � + � | I { � � C ] j � � � P � � � at character %s %s %s, %s:%s COLUMN NAME: %s
CONSTRAINT NAME: %s
CONTEXT: %s
COPY IN state must be terminated first
COPY OUT state must be terminated first
COPY terminated by new PQexec Crypt authentication not supported
DATATYPE NAME: %s
DETAIL: %s
GSSAPI authentication not supported
GSSAPI continuation error GSSAPI name import error HINT: %s
IPv6 host address may not be empty in URI: "%s"
Kerberos 4 authentication not supported
Kerberos 5 authentication not supported
LINE %d: LOCATION: NOTICE PGEventProc "%s" failed during PGEVT_CONNRESET event
PGEventProc "%s" failed during PGEVT_RESULTCREATE event
PGresult cannot support more than INT_MAX tuples PGresult is not an error result
PQexec not allowed during COPY BOTH
PQgetline: not doing text COPY OUT
QUERY: %s
SCHEMA NAME: %s
SCM_CRED authentication method not supported
SCRAM authentication requires libpq version 10 or above
SSL SYSCALL error: %s
SSL SYSCALL error: EOF detected
SSL certificate's name contains embedded null
SSL certificate's name entry is missing
SSL connection has been closed unexpectedly
SSL error code %lu SSL error: %s
SSL library does not support CRL certificates (file "%s")
SSPI authentication not supported
SSPI continuation error TABLE NAME: %s
Unix-domain socket path "%s" is too long (maximum %d bytes)
WARNING: password file "%s" has group or world access; permissions should be u=rw (0600) or less
WARNING: password file "%s" is not a plain file
WSAIoctl(SIO_KEEPALIVE_VALS) failed: %ui
another command is already in progress
argument of lo_read exceeds integer range
argument of lo_truncate exceeds integer range
argument of lo_write exceeds integer range
attribute has no values on LDAP lookup
authentication method %u not supported
cannot determine OID of function lo_close
cannot determine OID of function lo_creat
cannot determine OID of function lo_create
cannot determine OID of function lo_lseek
cannot determine OID of function lo_lseek64
cannot determine OID of function lo_open
cannot determine OID of function lo_tell
cannot determine OID of function lo_tell64
cannot determine OID of function lo_truncate
cannot determine OID of function lo_truncate64
cannot determine OID of function lo_unlink
cannot determine OID of function loread
cannot determine OID of function lowrite
certificate could not be obtained: %s
certificate does not match private key file "%s": %s
certificate present, but not private key file "%s"
column number %d is out of range 0..%d command string is a null pointer
connection in wrong state
connection not open
connection pointer is NULL
could not acquire SSPI credentials could not connect to server: %s
Is the server running locally and accepting
connections on Unix domain socket "%s"?
could not connect to server: %s
Is the server running on host "%s" (%s) and accepting
TCP/IP connections on port %s?
could not connect to server: %s
Is the server running on host "%s" and accepting
TCP/IP connections on port %s?
could not create LDAP structure
could not create SSL context: %s
could not create socket: %s
could not establish SSL connection: %s
could not get client address from socket: %s
could not get home directory to locate root certificate file
Either provide the file or change sslmode to disable server certificate verification.
could not get peer credentials: %s
could not get server's host name from server certificate
could not get socket error status: %s
could not initialize SSL engine "%s": %s
could not interpret result from server: %s could not load SSL engine "%s": %s
could not load private SSL key "%s" from engine "%s": %s
could not load private key file "%s": %s
could not look up local user ID %d: %s
could not open certificate file "%s": %s
could not open file "%s": %s
could not read certificate file "%s": %s
could not read from file "%s": %s
could not read private SSL key "%s" from engine "%s": %s
could not read root certificate file "%s": %s
could not receive data from server: %s
could not send SSL negotiation packet: %s
could not send data to server: %s
could not send startup packet: %s
could not set socket to TCP no delay mode: %s
could not set socket to close-on-exec mode: %s
could not set socket to nonblocking mode: %s
could not translate Unix-domain socket path "%s" to address: %s
could not translate host name "%s" to address: %s
could not write to file "%s": %s
definition of service "%s" not found
duplicate GSS authentication request
duplicate SSPI authentication request
end of string reached when looking for matching "]" in IPv6 host address in URI: "%s"
expected authentication request from server, but received %c
extra key/value separator "=" in URI query parameter: "%s"
extraneous data in "D" message extraneous data in "T" message extraneous data in "t" message forbidden value %%00 in percent-encoded value: "%s"
function requires at least protocol version 3.0
host name must be specified
host name must be specified for a verified SSL connection
incomplete multibyte character
insufficient data in "D" message insufficient data in "T" message integer of size %lu not supported by pqGetInt integer of size %lu not supported by pqPutInt invalid ExecStatusType code invalid LDAP URL "%s": invalid port number
invalid LDAP URL "%s": missing distinguished name
invalid LDAP URL "%s": must have exactly one attribute
invalid LDAP URL "%s": must have search scope (base/one/sub)
invalid LDAP URL "%s": no filter
invalid LDAP URL "%s": scheme must be ldap://
invalid URI propagated to internal parser routine: "%s"
invalid URI query parameter: "%s"
invalid connection option "%s"
invalid connection state %d, probably indicative of memory corruption
invalid connection state, probably indicative of memory corruption
invalid percent-encoded token: "%s"
invalid port number: "%s"
invalid setenv state %c, probably indicative of memory corruption
invalid socket
invalid sslmode value: "%s"
invalid state %c, probably indicative of memory corruption
keepalives parameter must be an integer
length must be given for binary parameter
line %d too long in service file "%s"
local user with ID %d does not exist
lookup on LDAP server failed: %s
lost synchronization with server, resetting connection lost synchronization with server: got message type "%c", length %d
message contents do not agree with length in message type "%c"
message type 0x%02x arrived from server while idle missing "=" after "%s" in connection info string
missing key/value separator "=" in URI query parameter: "%s"
more than one entry found on LDAP lookup
nested service specifications not supported in service file "%s", line %d
no COPY in progress
no SSL error reported no connection to the server
no entry found on LDAP lookup
no error message available
number of parameters must be between 0 and 65535
out of memory out of memory
out of memory allocating GSSAPI buffer (%d) out of memory for query result parameter number %d is out of range 0..%d password retrieved from file "%s"
private key file "%s" has group or world access; permissions should be u=rw (0600) or less
protocol error: id=0x%x
query to initialize large object functions did not return data
received invalid response to SSL negotiation: %c
requirepeer parameter is not supported on this platform
requirepeer specifies "%s", but actual peer user name is "%s"
root certificate file "%s" does not exist
Either provide the file or change sslmode to disable server certificate verification.
row number %d is out of range 0..%d select() failed: %s
server certificate for "%s" does not match host name "%s"
server closed the connection unexpectedly
This probably means the server terminated abnormally
before or while processing the request.
server does not support SSL, but SSL was required
server sent binary data ("B" message) without prior row description ("T" message) server sent data ("D" message) without prior row description ("T" message) server sent data ("D" message) without prior row description ("T" message)
service file "%s" not found
setsockopt(%s) failed: %s
size_t overflow sslmode value "%s" invalid when SSL support is not compiled in
statement name is a null pointer
syntax error in service file "%s", line %d
timeout expired
unexpected asyncStatus: %d
unexpected character "%c" at position %d in URI (expected ":" or "/"): "%s"
unexpected character %c following empty query response ("I" message) unexpected field count in "D" message unexpected message from server during startup
unexpected response from server; first received character was "%c"
unrecognized SSL error code: %d
unrecognized socket error: 0x%08X/%d unterminated quoted string in connection info string
user name lookup failure: error code %lu
Project-Id-Version: libpq (PostgreSQL 9.6)
Report-Msgid-Bugs-To: pgsql-bugs@postgresql.org
POT-Creation-Date: 2020-05-15 23:49+0000
PO-Revision-Date: 2017-08-28 11:37+0200
Last-Translator: Carlos Chapi <waldosaurio@gmail.com>
Language-Team: PgSQL-es-Ayuda <pgsql-es-ayuda@postgresql.org>
Language: es
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
X-Generator: Poedit 1.5.4
en el carácter %s %s %s, %s:%s NOMBRE DE COLUMNA: %s
NOMBRE DE RESTRICCIÓN: %s
CONTEXTO: %s
el estado COPY IN debe ser terminado primero
el estado COPY OUT debe ser terminado primero
COPY terminado por un nuevo PQexec el método de autentificación Crypt no está soportado
NOMBRE TIPO DE DATO: %s
DETALLE: %s
el método de autentificación GSSAPI no está soportado
error en continuación de GSSAPI error en conversión de nombre GSSAPI SUGERENCIA: %s
la dirección IPv6 no puede ser vacía en la URI: «%s»
el método de autentificación Kerberos 4 no está soportado
el método de autentificación Kerberos 5 no está soportado
LÍNEA %d: UBICACIÓN: AVISO PGEventProc «%s» falló durante el evento PGEVT_CONNRESET
PGEventProc «%s» falló durante el evento PGEVT_RESULTCREATE
PGresult no puede soportar un número de tuplas mayor que INT_MAX PGresult no es un resultado de error
PQexec no está permitido durante COPY BOTH
PQgetline: no se está haciendo COPY OUT de texto
CONSULTA: %s
NOMBRE DE ESQUEMA: %s
el método de autentificación SCM_CRED no está soportado
la autentificación SCRAM requiere la versión de libpq 10 o superior
ERROR en llamada SSL: %s
ERROR en llamada SSL: detectado fin de archivo
el elemento de nombre en el certificado SSL contiene un carácter null
falta el elemento de nombre en el certificado SSL
la conexión SSL se ha cerrado inesperadamente
código de error SSL %lu error de SSL: %s
la biblioteca SSL no soporta certificados CRL (archivo «%s»)
el método de autentificación SSPI no está soportado
error en continuación de SSPI NOMBRE DE TABLA: %s
la ruta del socket de dominio Unix «%s» es demasiado larga (máximo %d bytes)
ADVERTENCIA: El archivo de claves «%s» tiene permiso de lectura para el grupo u otros; los permisos deberían ser u=rw (0600) o menos
ADVERTENCIA: El archivo de claves «%s» no es un archivo plano
WSAIoctl(SIO_KEEPALIVE_VALS) failed: %ui
hay otra orden en ejecución
el argumento de lo_read excede el rango de enteros
el argumento de lo_truncate excede el rango de enteros
el argumento de lo_write excede el rango de enteros
la búsqueda LDAP entregó atributo sin valores
el método de autentificación %u no está soportado
no se puede determinar el OID de la función lo_close
no se puede determinar el OID de la función lo_creat
no se puede determinar el OID de la función lo_create
no se puede determinar el OID de la función lo_lseek
no se puede determinar el OID de la función lo_lseek64
no se puede determinar el OID de la función lo_open
no se puede determinar el OID de la función lo_tell
no se puede determinar el OID de la función lo_tell64
no se puede determinar el OID de la función lo_truncate
no se puede determinar el OID de la función lo_truncate64
no se puede determinar el OID de la función lo_unlink
no se puede determinar el OID de la función loread
no se puede determinar el OID de la función lowrite
el certificado no pudo ser obtenido: %s
el certificado no coincide con la llave privada «%s»: %s
el certificado está presente, pero no la llave privada «%s»
el número de columna %d está fuera del rango 0..%d la cadena de orden es un puntero nulo
la conexión está en un estado incorrecto
la conexión no está abierta
el puntero de conexión es NULL
no se pudo obtener las credenciales SSPI no se pudo conectar con el servidor: %s
¿Está el servidor en ejecución localmente y aceptando
conexiones en el socket de dominio Unix «%s»?
no se pudo conectar con el servidor: %s
¿Está el servidor en ejecución en el servidor «%s» (%s) y aceptando
conexiones TCP/IP en el puerto %s?
no se pudo conectar con el servidor: %s
¿Está el servidor en ejecución en el servidor «%s» y aceptando
conexiones TCP/IP en el puerto %s?
no se pudo crear estructura LDAP
no se pudo crear un contexto SSL: %s
no se pudo crear el socket: %s
no se pudo establecer conexión SSL: %s
no se pudo obtener la dirección del cliente desde el socket: %s
no se pudo obtener el directorio «home» para ubicar el archivo del certificado raíz
Debe ya sea entregar este archivo, o bien cambiar sslmode para deshabilitar la verificación de certificados del servidor.
no se pudo obtener credenciales de la contraparte: %s
no se pudo obtener el nombre de servidor desde el certificado del servidor
no se pudo determinar el estado de error del socket: %s
no se pudo inicializar el motor SSL «%s»: %s
no se pudo interpretar el resultado del servidor: %s no se pudo cargar el motor SSL «%s»: %s
no se pudo leer la llave privada SSL «%s» desde el motor «%s»: %s
no se pudo cargar el archivo de la llave privada «%s»: %s
no se pudo buscar el usuario local de ID %d: %s
no se pudo abrir el archivo de certificado «%s»: %s
no se pudo abrir el archivo «%s»: %s
no se pudo leer el archivo de certificado «%s»: %s
no se pudo leer el archivo «%s»: %s
no se pudo leer el archivo de la llave privada SSL «%s» desde el motor «%s»: %s
no se pudo leer la lista de certificado raíz «%s»: %s
no se pudo recibir datos del servidor: %s
no se pudo enviar el paquete de negociación SSL: %s
no se pudo enviar datos al servidor: %s
no se pudo enviar el paquete de inicio: %s
no se pudo establecer el socket en modo TCP sin retardo: %s
no se pudo poner el socket en modo close-on-exec: %s
no se pudo establecer el socket en modo no bloqueante: %s
no se pudo traducir la ruta del socket Unix «%s» a una dirección: %s
no se pudo traducir el nombre «%s» a una dirección: %s
no se pudo escribir a archivo «%s»: %s
la definición de servicio «%s» no fue encontrada
petición de autentificación GSS duplicada
petición de autentificación SSPI duplicada
se encontró el fin de la cadena mientras se buscaba el «]» correspondiente en dirección IPv6 en URI: «%s»
se esperaba una petición de autentificación desde el servidor, pero se ha recibido %c
separador llave/valor «=» extra en parámetro de la URI: «%s»
datos ininteligibles en mensaje «D» datos ininteligibles en mensaje «T» datos ininteligibles en mensaje «t» valor no permitido %%00 en valor escapado con %%: «%s»
la función requiere protocolo 3.0 o superior
el nombre de servidor debe ser especificado
el nombre de servidor debe ser especificado para una conexión SSL verificada
carácter multibyte incompleto
datos insuficientes en el mensaje «D» datos insuficientes en el mensaje «T» el entero de tamaño %lu no está soportado por pqGetInt el entero de tamaño %lu no está soportado por pqPutInt el código de ExecStatusType no es válido URL LDAP no válida «%s»: número de puerto no válido
URL LDAP no válida «%s»: distinguished name faltante
URL LDAP no válida «%s»: debe tener exactamente un atributo
URL LDAP no válida «%s»: debe tener ámbito de búsqueda (base/one/sub)
URL LDAP no válida «%s»: no tiene filtro
URL LDAP no válida «%s»: el esquema debe ser ldap://
URI no válida propagada a rutina interna de procesamiento: «%s»
parámetro de URI no válido: «%s»
opción de conexión no válida «%s»
estado de conexión no válido %d, probablemente por corrupción de memoria
el estado de conexión no es válido, probablemente por corrupción de memoria
elemento escapado con %% no válido: «%s»
número de puerto no válido: «%s»
el estado de setenv %c no es válido, probablemente por corrupción de memoria
socket no válido
valor sslmode no válido: «%s»
el estado %c no es válido, probablemente por corrupción de memoria
el parámetro de keepalives debe ser un entero
el largo debe ser especificado para un parámetro binario
la línea %d es demasiado larga en archivo de servicio «%s»
no existe un usuario local con ID %d
búsqueda en servidor LDAP falló: %s
se perdió la sincronía con el servidor, reseteando la conexión se perdió la sincronía con el servidor: se recibió un mensaje de tipo «%c», largo %d
el contenido del mensaje no concuerda con el largo, en el mensaje tipo «%c»
un mensaje de tipo 0x%02x llegó del servidor estando inactivo falta «=» después de «%s» en la cadena de información de la conexión
separador llave/valor «=» faltante en parámetro de la URI: «%s»
se encontro más de una entrada en búsqueda LDAP
especificaciones de servicio anidadas no soportadas en archivo de servicio «%s», línea %d
no hay COPY alguno en ejecución
código de error SSL no reportado no hay conexión con el servidor
no se encontró ninguna entrada en búsqueda LDAP
no hay mensaje de error disponible
el número de parámetros debe estar entre 0 y 65535
memoria agotada memoria agotada
memoria agotada creando el búfer GSSAPI (%d) no hay suficiente memoria para el resultado de la consulta el número de parámetro %d está fuera del rango 0..%d contraseña obtenida desde el archivo «%s»
el archivo de la llave privada «%s» tiene permiso de lectura para el grupo u otros; los permisos deberían ser u=rw (0600) o menos
error de protocolo: id=0x%x
la consulta para inicializar las funciones de objetos grandes no devuelve datos
se ha recibido una respuesta no válida en la negociación SSL: %c
el parámetro requirepeer no está soportado en esta plataforma
requirepeer especifica «%s», pero el nombre de usuario de la contraparte es «%s»
el archivo de certificado raíz «%s» no existe
Debe ya sea entregar este archivo, o bien cambiar sslmode para deshabilitar la verificación de certificados del servidor.
el número de fila %d está fuera del rango 0..%d select() fallida: %s
el certificado de servidor para «%s» no coincide con el nombre de servidor «%s»
el servidor ha cerrado la conexión inesperadamente
Probablemente se debe a que el servidor terminó de manera anormal
antes o durante el procesamiento de la petición.
el servidor no soporta SSL, pero SSL es requerida
el servidor envió datos binarios (mensaje «B») sin precederlos con una description de fila (mensaje «T») el servidor envió datos (mensaje «D») sin precederlos con una descripción de fila (mensaje «T») el servidor envió datos (mensaje «D») sin precederlos con una descripción de fila (mensaje «T»)
el archivo de servicio «%s» no fue encontrado
setsockopt(%s) falló: %s
desbordamiento de size_t el valor sslmode «%s» no es válido cuando no se ha compilado con soporte SSL
el nombre de sentencia es un puntero nulo
error de sintaxis en archivo de servicio «%s», línea %d
tiempo de espera agotado
asyncStatus no esperado: %d
carácter «%c» inesperado en la posición %d en URI (se esperaba «:» o «/»): «%s»
carácter %c no esperado, siguiendo una respuesta de consulta vacía (mensaje «I») cantidad de campos inesperada en mensaje «D» se ha recibido un mensaje inesperado del servidor durante el inicio
se ha recibido una respuesta inesperada del servidor; el primer carácter recibido fue «%c»
código de error SSL no reconocido: %d
código de error de socket no reconocido: 0x%08X/%d cadena de caracteres entre comillas sin terminar en la cadena de información de conexión
fallo en la búsqueda del nombre de usuario: código de error %lu
locale/es/LC_MESSAGES/psql-9.6.mo 0000644 00000302655 14751153421 0012043 0 ustar 00 �� 9 �! � �C HZ IZ _Z sZ � �Z 4[ P[
i[ w[ > �[ = �[ < \ p B\ s �\ 5 '] 7 ]] K �] o �] 2 Q^ 4 �^ N �^ t _ Q }_ O �_ > ` A ^` O �` @ �` 6 1a 0 ha N �a G �a 8 0b A ib T �b ? c L @c A �c @ �c H d A Yd + �d � �d 5 ]e 9 �e n �e Q <f : �f � �f ; Vg y �g � h ; �h z �h T _i A �i L �i B Cj \ �j 4 �j J k \ ck 6 �k 4 �k G ,l = tl ; �l ( �l ; m ; Sm ; �m ; �m 8 n _ @n J �n F �n ` 2o h �o G �o 5 Dp 2 zp X �p Q q : Xq 3 �q ; �q S r M Wr 9 �r @ �r 8 s ; Ys @ �s K �s J "t | mt � �t > pu F �u N �u F Ev H �v - �v $ w & (w - Ow 9 }w 7 �w 2 �w 4 "x 3 Wx ) �x ) �x ; �x B y ) ^y * �y * �y J �y 1 )z . [z - �z , �z 4 �z I { $ d{ & �{ > �{ 1 �{ & !| ( H| J q| : �| ( �| % } $ F} $ k} ) �} - �} N �} 9 7~ G q~ 5 �~ M �~ C = P � K � N � K m� L �� 4 � K ;� ( �� q �� A "� ? d� A �� > � � %� # Ԅ F �� 8 ?� < x� M �� ; � 6 ?� 2 v� 7 �� B � : $� 4 _� 9 �� ? · % � + 4� 9 `� 5 �� I Ј K � M f� Z �� S � K c� � �� N :� @ �� : ʋ ( � B .� L q� C �� � � M �� = �� � =� ێ � � � %� )� =� M� 0 U� $ �� # �� * Ϗ % �� * � K� # l� < �� ͐ � � 6 !� X� � m� : � N� `� l� y� �� �� �� �� Β Q � 2� I F� [ ��
� �� �
� (� F� C S� A �� ٔ � � �� � � � , -� Z� q� }� �� �� �� �� �� ԕ �
� �� � � ' $� L� & j� ' �� 7 �� 0 � "� >� N� a� y� �� �� �� w �� � &� ;� A� [� ( t� �� �� �� Ę ޘ �� � (� A� M� V� _� q� ~� �� ��
�� �� �� �� ƙ
̙ ڙ � � �� �
�
� *�
<� J� & W� ~� ��
��
�� �� �� ̚ �
��
� � 4� G� Y� i� �� �� �� ͛ ߛ �� � �
2� @� P� % a� �� " �� �� ߜ �� � ' /� & W� ~� �� �� �� �� �� ŝ
ʝ ՝ L � 1� @� ^� > {� �� Ϟ � 2 �� -� 4� G� [� u� �� �� �� �� �� ϟ � X � ]� f� �� ��
�� �� Ԡ ' ݠ . � ! 4� ' V� ~� �� ��
�� �� ѡ �
� *� J� Y� j� , v� �� �� �� Ϣ Ԣ ޢ � � E � ^� n� u� ~� ��
�� �� �� �� �� £ Σ � � � � � � 2�
8� F� b�
{� �� �� �� �� �� դ ޤ ! �� � 7� 9 R� y �� 9 � F @� 5 �� B �� C � 5 D� : z� 9 �� @ � ; 0� K l� B �� C �� 6 ?� 8 v� �� ˩ ک
� �� � �
� )� E� d� |� �� �� & �� ֪ � �� � � � ګ # � # � # :� ^� " u� �� �� �� ά ج �
� � �� �
� c $� � �� I� K f� Q �� / � O 4� U �� 5 گ = � N� , Z� 4 �� " �� ! ߰ � !� .� I� " e� + �� + �� 6 � X � 7 p� 8 �� T � 5 6� I l� 6 �� # � = � = O� = �� i ˴ 9 5� o� �� * �� ֵ � � 0� C� J� N� ]� q� w� �� �� �� �� �� # � � $ /� T�
g� u� ~� �� �� �� ��
�� �� �� ʷ ٷ � � �� � C � S� / d� ( �� �� и ٸ � � ' � F� $ e� % �� ! �� ) ҹ ( �� / %� # U� ' y� , �� . κ 4 �� 2� ! R� - t� �� % û 4 � 1 � - P� / ~� " �� Ѽ ' � � . 9� ) h� % �� ! �� $ ڽ * �� + *� A V� �� �� & �� 0 ؾ . � ) 8� ) b� �� % �� ��
ƿ
ѿ ܿ # �
� � )� ;� G� S� Z� f� n� �� C �� � �� � � 2� B� R� q�
{� �� $ �� & �� - � # � 4� 1 U� ( �� ) �� + �� ' � ! .� P� # k� ! �� ( �� �� �� � -� K� j� p� �� �� ��
�� �� ��
�� �� � � 0� P� b� y� �� �� �� �� �� � ! 2� T� j� 2 }� �� �� �� � � ?� 2 Y� 5 �� �� �� �� . � 8� & P� # w� �� ! �� �� �� � � 4� 6 U� ) �� ��
�� �� �� �� �� �
� & � G� W� a� k� t� �� �� �� �� �� �� ��
�� � U
� c� t� z� , �� �� �� �� � �
*� 5� D� P� Y� _� h� x� " ��
�� �� �� �� �� ��
� 1 � L� d�
v� �� �� �� . �� �� . ��
� +� 5� ;� M� ^�
k� v� E �� ��
�� �� �� � � "� 7� ?� N� b� w� * �� ��
�� �� �� �� �� �� �
�
� )� 2� <� L� ^� j� t� �� �� �� �� �� �� �� �� �� �
� � !� (� ;� D� % M� s� z� �� �� �� �� �� �� �� �� �� � �
� $� .� =� I� L� ]� y� �� �� �� �� �� �� �� �� �� �� �� �� �� ��
� � "�
4� B� Q� c� s� � �� �� �� �� �� �� �� �� �� ! �� 4 �
N� \� . e� �� �� �� �� �� �� �� ��
�
�
!� /� B� V� i� {� �� " �� �� �� �� � '� D� / Z� �� �� �� �� " �� �� � .� L� _� * p�
�� �� �� �� �� � #� 3� F� _� 0 y� + �� �� �� �� > ��
.� 9� ) E� " o� �� ��
�� �� �� �� �� �� �� � � � /� ;� @�
G� U�
^�
l� w� �� �� 7 �� 2 �� 6 � V @� �� & �� & �� . �� � &� 6�
G�
U� c� s� �� �� �� �� �� �� �� �� �� ! �� � � 0� =�
M� X� `� v� �� . �� �� �� �� ��
� � +� =� I� U� ^� c� m� v�
�� �� �� �� �� �� �� �� � $� .� 2� $ Q� # v� �� �� 0 �� �� �� �� � � ( 1� Z� d� u� �� �� �� �� �� �� �� �� �� , �� � 6� T� $ p� �� ' �� �� �� � &� >� Z� o� ! �� �� �� ��
�� �� �� � �� �� �� �� � �� �� �� �� � > � @ [� K �� n �� h W� 7 �� 2 �� I +� z u� 5 �� E &� R l� � �� L G� g �� Y �� E V� i �� E � 7 L� 1 �� H �� j �� = j� D �� r �� : `� N �� K �� B 6� H y� B �� / � � 5� / �� B �� n @� s �� B #� � f� < �� ~ 5� � �� 6 G� � ~� z � K ~� N � 7 � { Q� 7 � Q � � W� F � : � K [� @ �� ? � 7 (� B `� ? �� ? � @ #� < d� { �� L � P j� \ �� l � P �� < � 7 � z K� O � 5 � 9 L� 6 �� Q �� { � ? �� G � = E Q ? � N � F & � m � � ; � F � H I d L � / � 9 + % e - � B � ? � F < = � 3 � 7 � * - 7 X @ � 5 � ( ) 0 Q Z 5 � 1 � - . B 9 q O � " � % B D 2 � % � ' � P
B Y
' �
# �
" �
# ( / 5 X f � 5 � Z + Z � D � c &
j �
l �
O b i � O 2 l K � + � D � > � _ G { � � \ A } < � G � v D U � < 8 N 7 � ` � @ 8 a 7 � ; � & / 5 > e 6 � p � G L B � y � Q Q E � � � O n F � ? 0 E Q v J � H � \ 1 5 P g � � T o � � � � � � 4 � 1 + 7 . c / � 7 � * � ) % T O + � � ' � G
! U! � l! : " N" `"
l" z" �" �" �" �" �" _ �" N# M k# ^ �# $ "$ 5$
P$ ) [$ �$ f �$ l % n% �% �% �% �% �% �% / �% & $& 0& 9& C&
I& " W& 2 z& " �&
�& �& �& �& �& + ' $ 8' * ]' & �' I �' I �' % C( i( �( ' �( �( �(
�( �( u �( g) ) �) + �) ( �) 1 �) ,* <* R* " [* ( ~* �* �* �* �* + + + .+ A+ \+ v+ �+ �+ �+ �+ �+ �+ �+ �+ �+
�+ �+ , , +, <,
K, 1 Y, �, �, �, �, �, �, �, # - ' 2- Z- s- �- �- �- # �- �- . ' 1. Y. ! n. �. �. �. �. �. �. - / 7/ 0 N/ - / - �/ + �/ 0 = $0 : b0
�0 �0
�0 �0 �0
�0 �0 �0 1 o 1 �1 + �1 , �1 D �1 12 P2 p2 5 �2 �2 �2 �2 �2 3 /3 83 U3 d3 k3 * �3 �3 h �3 <4 % H4 n4 �4
�4 �4
�4 , �4 2 5 ) B5 1 l5 �5 & �5
�5 �5 # �5 4 6 ! L6 , n6 ' �6 �6 �6 �6 / �6 ,7 C7 R7
_7
m7 {7 - �7 �7 F �7 8 '8 /8 98 M8 V8 c8 o8 w8 ~8 �8 �8 �8
�8 �8 �8 �8 �8 9 9 # )9 - M9
{9 �9 �9 �9 �9 �9 �9 + �9 . : ' C: * k: > �: � �: 9 V; Q �; 5 �; R < < k< 2 �< ; �< 7 = C O= 9 �= H �= T > N k> 2 �> 8 �> &? =? - Q? * ? �? �? �? �? + �? . )@ % X@ 4 ~@ �@ �@ 2 �@ ' �@ $ "A GA % LA � rA JB & cB 2 �B 5 �B �B & C 5C NC WC uC �C �C
�C �C �C �C �C � �C . _D / �E d �E m #F ( �F j �F s %G G �G C �G %H 0 1H > bH , �H % �H �H I !I ( ?I 4 hI 0 �I 6 �I D J j JJ > �J @ �J k 5K A �K V �K : :L ' uL H �L J �L M 1M m M B �M 0N ! PN 2 rN �N �N " �N O O #O 'O CO ^O dO qO {O �O �O $ �O * �O P P ' 7P _P sP
�P �P �P
�P �P �P �P
�P �P �P �P Q Q Q Q M 4Q �Q 5 �Q - �Q �Q
R R ! 6R & XR 3 R # �R ( �R ( S # )S - MS + {S 6 �S % �S ) T 0 .T / _T @ �T " �T # �T 0 U " HU & kU A �U = �U < V < OV & �V �V , �V " W 4 $W 1 YW ' �W # �W $ �W 0 �W 2 -X I `X �X �X 1 �X 5 �X 5 )Y / _Y / �Y �Y ' �Y �Y Z
Z Z / "Z RZ cZ {Z �Z �Z �Z �Z �Z �Z �Z A �Z # A[ e[
�[ �[ �[ �[ ' �[ �[ \ \ ( 2\ + [\ 6 �\ ( �\ , �\ A ] / V] - �] 3 �] - �] + ^ ! B^ * d^ + �^ 2 �^ & �^ _ $ 1_ - V_ # �_ �_ �_ �_ �_ �_ ` #` C` V` l` ~` ! �` ( �` $ �` a "a ' @a ha - �a % �a ! �a �a * b Ab [b 3 sb $ �b �b $ �b &
c # 1c % Uc C {c 5 �c �c $ d 1d : Hd �d 5 �d 1 �d 0 e 0 7e he �e �e �e ) �e 9 f - <f jf tf �f �f �f �f
�f �f * �f g
&g
1g <g Eg cg {g �g �g % �g �g
�g �g �g v h �h �h �h 6 �h �h & i 2i Fi ]i
ri }i �i
�i
�i �i �i �i 2 �i $j 3j Ej Rj jj & sj �j F �j �j
k k /k Bk Vk A hk �k 9 �k �k
�k l l -l Cl Vl el < |l �l
�l �l �l m m m 2m
9m Gm gm ! }m 0 �m �m �m �m �m n n n )n 9n
Nn Yn bn kn {n �n �n �n �n ) �n �n o o *o <o Io No do mo |o �o �o �o
�o # �o �o �o
p &p -p 4p Jp bp |p �p �p �p �p
�p �p �p �p �p q " q >q Eq Nq Zq fq wq �q �q �q �q �q �q �q �q �q r r r 3r Cr Tr ir yr
�r �r �r �r �r �r �r �r s
s % s 4 :s os �s 0 �s �s �s �s �s �s t t 6t @t
Qt _t t ( �t �t �t �t u * &u Qu % lu �u �u �u �u < v Dv Vv vv �v 0 �v , �v + �v + (w Tw pw 3 �w �w �w �w # x *x Kx bx ux �x ! �x : �x 3 y :y Cy Ly E Uy �y
�y / �y & �y z z 1z
:z Hz _z |z �z �z �z �z �z �z �z �z
�z {
{ { '{ :{ K{ P `{ 7 �{ > �{ k (| �| . �| 3 �| 4 } =} L} ]} y}
�} �} �} �} �} �} �} �} ~ ~ 1~ H~ " R~ u~ �~ �~ �~
�~ �~ �~ �~ L ) v | � ! � � � � � � � (�
.� 9� F�
\� j� }�
�� �� �� π ( Ԁ ' �� %� 4� 8� ) X� ' �� �� �� 9 �� �� � #� *� G� @ \� �� �� �� ͂ � � � �� # �� "� :� Q� ) Z� �� $ �� ! + � � + '� S� $ r� �� �� ΄ � ' � % /� U� ]� t�
�� �� �� n J � � � � � � � � ( B 5 � L ( # � � � \ j d
( � � � $ � � � k � 7 , � � � � � . v � � �
z � S q ; � v � | � � z � � � � f y � � L 1 Z � � d i ) � B � � ; & � � � ( P 5 � 8 � % � T � � 2 � � / t � � @ Y t � / � � � � s � - , � � � � I s ~ q � F o Q � � � � � � N 3 � D � R � � P � y � b � �
� E w _ l � � � � M � + � ^ T � X b + 4 _ � � � � w � � � n < � � � � [ � - - � � � 6 � y i 4 � � % � = � U l � � � � f � � X ( � � \ � f x � } � ' � � ! r � � � T � u / W [ � G � a 1 � � � # � k K � � : � � � 1 � 2 * ] W � s � # � u C � H g U w S � � � � H e � 6 Z Q � 7 � � � j c � � � � � � � � / 4 � � � 2 � � � O q � � � i a h � � � � � � � � � � � M � � � � 9 p v � � � o = � � R . � � ) � � � � � � g � 7 > L & � � b � z x � � � T x E � F � � � � � � Y � � A � � � � � ~ � � � � � v k 8 = C � 2 � � � n � Z � � 6 � r � � � � " � ? u t � u L ` � � � � � p Y � : � � � � g h � � 9 0 � � + � � i � � � G �
� � � � � | � p J � \ � � � � � _ > N D Y h B m � � � p � � 9 J � � 5 � . � � � � O | , $ � � � F � � ' � z X � M
� � � m � � � r � g " � � � � [ � � � I 0 H 3 � �
O
� � � � � � j � � � � � 0 � � V 4 P � " ` N N V o � I � � 9 t � & m 0 � W f @ � a : 7 ; R A G � K ] � � S � � � � 8 � � c E � � ~ ? � � 0 3 � � = � � � Q % * � o & A x � K $ � � � { < � } ! ^ � ! ? � � : B E � � � � � 7 U ' � � m $ � � \ � � � � � � � < - n � � � W � @ � � � ^ ` Q �
' V D ] j w ! � � � � � � M � � � � � � � A � � l # � � � � � _ � � { O F X 1 c � � ~ e > � � � � e } " { � � $ D � � � � � � � # * ) H ? q { � + ) � � � 9 � � � � � �
b � < � , � I 5 [ ] � ; � % � | � � C . � r @ � � � � � � a 2 � � . ' � � & 1 � s 8 � � � ! c � � � � � / " J � d � � � � � � � � 3 � � > % � ) � � � 4 � k � � 3 � � � � � 8 � � � - � U � � � � * � � � � � � 6 � K ,
� � l � � � � h � S ^ � � ` � � V 6 P � G } � � R � C d * Z � � � y � � � � � + � � � 5 e
Connection options:
Display settings:
Environment variables:
For more information, type "\?" (for internal commands) or "\help" (for SQL
commands) from within psql, or consult the psql section in the PostgreSQL
documentation.
Input and output options:
Output format options:
Parser: "%s"
Parser: "%s.%s" --help=commands list backslash commands, then exit
--help=variables list special variables, then exit
(options: S = show system objects, + = additional detail)
-0, --record-separator-zero
set record separator for unaligned output to zero byte
-1 ("one"), --single-transaction
execute as a single transaction (if non-interactive)
-?, --help[=options] show this help, then exit
-A, --no-align unaligned table output mode
-E, --echo-hidden display queries that internal commands generate
-F, --field-separator=STRING
field separator for unaligned output (default: "%s")
-H, --html HTML table output mode
-L, --log-file=FILENAME send session log to file
-P, --pset=VAR[=ARG] set printing option VAR to ARG (see \pset command)
-R, --record-separator=STRING
record separator for unaligned output (default: newline)
-S, --single-line single-line mode (end of line terminates SQL command)
-T, --table-attr=TEXT set HTML table tag attributes (e.g., width, border)
-U, --username=USERNAME database user name (default: "%s")
-V, --version output version information, then exit
-W, --password force password prompt (should happen automatically)
-X, --no-psqlrc do not read startup file (~/.psqlrc)
-a, --echo-all echo all input from script
-b, --echo-errors echo failed commands
-c, --command=COMMAND run only single command (SQL or internal) and exit
-d, --dbname=DBNAME database name to connect to (default: "%s")
-e, --echo-queries echo commands sent to server
-f, --file=FILENAME execute commands from file, then exit
-h, --host=HOSTNAME database server host or socket directory (default: "%s")
-l, --list list available databases, then exit
-n, --no-readline disable enhanced command line editing (readline)
-o, --output=FILENAME send query results to file (or |pipe)
-p, --port=PORT database server port (default: "%s")
-q, --quiet run quietly (no messages, only query output)
-s, --single-step single-step mode (confirm each query)
-t, --tuples-only print rows only
-v, --set=, --variable=NAME=VALUE
set psql variable NAME to VALUE
(e.g., -v ON_ERROR_STOP=1)
-w, --no-password never prompt for password
-x, --expanded turn on expanded table output
-z, --field-separator-zero
set field separator for unaligned output to zero byte
AUTOCOMMIT if set, successful SQL commands are automatically committed
COLUMNS number of columns for wrapped format
COMP_KEYWORD_CASE determines the case used to complete SQL key words
[lower, upper, preserve-lower, preserve-upper]
DBNAME the currently connected database name
ECHO controls what input is written to standard output
[all, errors, none, queries]
ECHO_HIDDEN if set, display internal queries executed by backslash commands;
if set to "noexec", just show without execution
ENCODING current client character set encoding
FETCH_COUNT the number of result rows to fetch and display at a time
(default: 0=unlimited)
HISTCONTROL controls command history [ignorespace, ignoredups, ignoreboth]
HISTFILE file name used to store the command history
HISTSIZE the number of commands to store in the command history
HOST the currently connected database server host
IGNOREEOF if unset, sending an EOF to interactive session terminates application
LASTOID value of the last affected OID
NAME=VALUE [NAME=VALUE] psql ...
or \setenv NAME [VALUE] inside psql
ON_ERROR_ROLLBACK if set, an error doesn't stop a transaction (uses implicit savepoints)
ON_ERROR_STOP stop batch execution after error
PAGER name of external pager program
PGAPPNAME same as the application_name connection parameter
PGDATABASE same as the dbname connection parameter
PGHOST same as the host connection parameter
PGPASSFILE password file name
PGPASSWORD connection password (not recommended)
PGPORT same as the port connection parameter
PGUSER same as the user connection parameter
PORT server port of the current connection
PROMPT1 specifies the standard psql prompt
PROMPT2 specifies the prompt used when a statement continues from a previous line
PROMPT3 specifies the prompt used during COPY ... FROM STDIN
PSQLRC alternative location for the user's .psqlrc file
PSQL_EDITOR, EDITOR, VISUAL
editor used by the \e, \ef, and \ev commands
PSQL_EDITOR_LINENUMBER_ARG
how to specify a line number when invoking the editor
PSQL_HISTORY alternative location for the command history file
QUIET run quietly (same as -q option)
SHELL shell used by the \! command
SHOW_CONTEXT controls display of message context fields [never, errors, always]
SINGLELINE end of line terminates SQL command mode (same as -S option)
SINGLESTEP single-step mode (same as -s option)
TMPDIR directory for temporary files
USER the currently connected database user
VERBOSITY controls verbosity of error reports [default, verbose, terse]
\! [COMMAND] execute command in shell or start interactive shell
\? [commands] show help on backslash commands
\? options show help on psql command-line options
\? variables show help on special variables
\C [STRING] set table title, or unset if none
\H toggle HTML output mode (currently %s)
\T [STRING] set HTML <table> tag attributes, or unset if none
\a toggle between unaligned and aligned output mode
\c[onnect] {[DBNAME|- USER|- HOST|- PORT|-] | conninfo}
connect to new database (currently "%s")
\c[onnect] {[DBNAME|- USER|- HOST|- PORT|-] | conninfo}
connect to new database (currently no connection)
\cd [DIR] change the current working directory
\conninfo display information about current connection
\copy ... perform SQL COPY with data stream to the client host
\copyright show PostgreSQL usage and distribution terms
\crosstabview [COLUMNS] execute query and display results in crosstab
\dA[+] [PATTERN] list access methods
\dC[+] [PATTERN] list casts
\dD[S+] [PATTERN] list domains
\dE[S+] [PATTERN] list foreign tables
\dF[+] [PATTERN] list text search configurations
\dFd[+] [PATTERN] list text search dictionaries
\dFp[+] [PATTERN] list text search parsers
\dFt[+] [PATTERN] list text search templates
\dL[S+] [PATTERN] list procedural languages
\dO[S+] [PATTERN] list collations
\dT[S+] [PATTERN] list data types
\d[S+] list tables, views, and sequences
\d[S+] NAME describe table, view, sequence, or index
\da[S] [PATTERN] list aggregates
\db[+] [PATTERN] list tablespaces
\dc[S+] [PATTERN] list conversions
\dd[S] [PATTERN] show object descriptions not displayed elsewhere
\ddp [PATTERN] list default privileges
\des[+] [PATTERN] list foreign servers
\det[+] [PATTERN] list foreign tables
\deu[+] [PATTERN] list user mappings
\dew[+] [PATTERN] list foreign-data wrappers
\df[antw][S+] [PATRN] list [only agg/normal/trigger/window] functions
\dg[S+] [PATTERN] list roles
\di[S+] [PATTERN] list indexes
\dl list large objects, same as \lo_list
\dm[S+] [PATTERN] list materialized views
\dn[S+] [PATTERN] list schemas
\do[S] [PATTERN] list operators
\dp [PATTERN] list table, view, and sequence access privileges
\drds [PATRN1 [PATRN2]] list per-database role settings
\ds[S+] [PATTERN] list sequences
\dt[S+] [PATTERN] list tables
\du[S+] [PATTERN] list roles
\dv[S+] [PATTERN] list views
\dx[+] [PATTERN] list extensions
\dy [PATTERN] list event triggers
\e [FILE] [LINE] edit the query buffer (or file) with external editor
\echo [STRING] write string to standard output
\ef [FUNCNAME [LINE]] edit function definition with external editor
\encoding [ENCODING] show or set client encoding
\errverbose show most recent error message at maximum verbosity
\ev [VIEWNAME [LINE]] edit view definition with external editor
\f [STRING] show or set field separator for unaligned query output
\g [FILE] or ; execute query (and send results to file or |pipe)
\gexec execute query, then execute each value in its result
\gset [PREFIX] execute query and store results in psql variables
\h [NAME] help on syntax of SQL commands, * for all commands
\i FILE execute commands from file
\ir FILE as \i, but relative to location of current script
\l[+] [PATTERN] list databases
\lo_export LOBOID FILE
\lo_import FILE [COMMENT]
\lo_list
\lo_unlink LOBOID large object operations
\o [FILE] send all query results to file or |pipe
\p show the contents of the query buffer
\password [USERNAME] securely change the password for a user
\prompt [TEXT] NAME prompt user to set internal variable
\pset [NAME [VALUE]] set table output option
(NAME := {border|columns|expanded|fieldsep|fieldsep_zero|
footer|format|linestyle|null|numericlocale|pager|
pager_min_lines|recordsep|recordsep_zero|tableattr|title|
tuples_only|unicode_border_linestyle|
unicode_column_linestyle|unicode_header_linestyle})
\q quit psql
\qecho [STRING] write string to query output stream (see \o)
\r reset (clear) the query buffer
\s [FILE] display history or save it to file
\set [NAME [VALUE]] set internal variable, or list all if no parameters
\setenv NAME [VALUE] set or unset environment variable
\sf[+] FUNCNAME show a function's definition
\sv[+] VIEWNAME show a view's definition
\t [on|off] show only rows (currently %s)
\timing [on|off] toggle timing of commands (currently %s)
\unset NAME unset (delete) internal variable
\w FILE write query buffer to file
\watch [SEC] execute query every SEC seconds
\x [on|off|auto] toggle expanded output (currently %s)
\z [PATTERN] same as \dp
border border style (number)
columns target width for the wrapped format
expanded (or x) expanded output [on, off, auto]
fieldsep field separator for unaligned output (default "%s")
fieldsep_zero set field separator for unaligned output to zero byte
footer enable or disable display of the table footer [on, off]
format set output format [unaligned, aligned, wrapped, html, asciidoc, ...]
linestyle set the border line drawing style [ascii, old-ascii, unicode]
null set the string to be printed in place of a null value
numericlocale enable or disable display of a locale-specific character to separate
groups of digits [on, off]
pager control when an external pager is used [yes, no, always]
psql --pset=NAME[=VALUE]
or \pset NAME [VALUE] inside psql
psql --set=NAME=VALUE
or \set NAME VALUE inside psql
psql [OPTION]... [DBNAME [USERNAME]]
recordsep record (line) separator for unaligned output
recordsep_zero set record separator for unaligned output to zero byte
set NAME=VALUE
psql ...
or \setenv NAME [VALUE] inside psql
tableattr (or T) specify attributes for table tag in html format or proportional
column widths for left-aligned data types in latex-longtable format
title set the table title for any subsequently printed tables
tuples_only if set, only actual table data is shown
unicode_border_linestyle
unicode_column_linestyle
unicode_header_linestyle
set the style of Unicode line drawing [single, double]
"%s.%s" is not a view
%d connection %d connections %s %s %s (every %gs)
%s
%s (%s, server %s)
%s (every %gs)
%s: %s
%s: -1 can only be used in non-interactive mode
%s: cannot copy from/to a directory
%s: could not delete variable "%s"
%s: could not find own program executable
%s: could not open log file "%s": %s
%s: could not set printing parameter "%s"
%s: could not set variable "%s"
%s: current transaction is aborted
%s: invalid encoding name or conversion procedure not found
%s: not connected to a database
%s: out of memory
%s: unknown transaction status
%s: warning: extra command-line argument "%s" ignored
(%lu row) (%lu rows) ***(Single step mode: verify command)*******************************************
%s
***(press return to proceed or enter x and return to cancel)********************
********* QUERY **********
%s
**************************
+ opt(%d) = |%s|
, clustered , deferrable , initially deferred , invalid , predicate (%s) , replica identity , tablespace "%s" Access privileges All connection parameters must be supplied because no database connection exists
Argument data types Asynchronous notification "%s" received from server process with PID %d.
Asynchronous notification "%s" with payload "%s" received from server process with PID %d.
Attributes Available help:
Border style is %d.
Bypass RLS COPY data transfer failed: %s Call Handler Cannot add cell to table content: total cell count of %d exceeded.
Cannot add header to table content: column count of %d exceeded.
Cannot login Check Check constraints: Child tables Collate Column Column privileges Command: %s
Description: %s
Syntax:
%s
Composite type "%s.%s" Connection
Create DB Create role Ctype Database Default access privileges Default footer is off.
Default footer is on.
Default? Definition Description Destination Dictionaries Did not find any extension named "%s".
Did not find any extensions.
Did not find any relation named "%s".
Did not find any relation with OID %s.
Did not find any text search configuration named "%s".
Did not find any text search parser named "%s".
Disabled internal triggers: Disabled rules: Disabled triggers: Disabled user triggers: Elements Enabled Encoding End parse Enter data to be copied followed by a newline.
End with a backslash and a period on a line by itself, or an EOF signal. Enter it again: Enter new password: Event Expanded display is off.
Expanded display is on.
Expanded display is used automatically.
FDW Options FDW Options: (%s) Failed.
Field separator is "%s".
Field separator is zero byte.
Foreign table "%s.%s" Foreign-data wrapper Foreign-key constraints: Formatting
Function General
General options:
Get headline Get next token Get token types Handler Has OIDs: yes Help
ID Implicit? Index Index "%s.%s" Indexes: Informational
Inherits Init Init options Inline Handler Input/Output
Internal Language Internal name Interrupted
Invalid command \%s. Try \? for help.
Language Large Objects
Large objects Left arg type Lexize Line style is %s.
List of access methods List of aggregate functions List of casts List of collations List of conversions List of data types List of databases List of domains List of event triggers List of foreign servers List of foreign tables List of foreign-data wrappers List of functions List of installed extensions List of languages List of operators List of relations List of roles List of schemas List of settings List of specially treated variables
List of tablespaces List of text search configurations List of text search dictionaries List of text search parsers List of text search templates List of user mappings Locale-adjusted numeric output is off.
Locale-adjusted numeric output is on.
Location Materialized view "%s.%s" Member of Method Modifier Modifiers Name No changes No connections No help available for "%s".
Try \h with no arguments to see available help.
No inheritance No matching relations found.
No matching settings found.
No per-database role settings support in this server version.
No relations found.
No settings found.
Null display is "%s".
Number of child tables: %d (Use \d+ to list them.) Object Object Description Object descriptions Objects in extension "%s" Operating System
Options Output format is %s.
Owned by: %s Owner Pager is always used.
Pager is used for long output.
Pager usage is off.
Pager won't be used for less than %d line.
Pager won't be used for less than %d lines.
Parallel Password encryption failed.
Password for user %s: Password valid until Password: Passwords didn't match.
Policies Policies (forced row security enabled): Policies (forced row security enabled): (none) Policies (row security disabled): Policies (row security enabled): (none) Policies: Previous connection kept
Procedure Query Buffer
Query buffer is empty. Query buffer reset (cleared). Record separator is "%s".
Record separator is <newline>.
Record separator is zero byte.
Referenced by: Replica Identity Replication Report bugs to <pgsql-bugs@postgresql.org>.
Result data type Result type Right arg type Role Role name Rules firing always: Rules firing on replica only: Rules: SSL connection (protocol: %s, cipher: %s, bits: %s, compression: %s)
STATEMENT: %s
Schema Security Sequence "%s.%s" Server Server: %s Settings Size Source Source code Source type Special relation "%s.%s" Start parse Stats target Storage Succeeded.
Superuser TOAST table "%s.%s" Table Table "%s.%s" Table attributes are "%s".
Table attributes unset.
Tablespace Tablespace: "%s" Tags Target type Target width is %d.
Target width is unset.
Template Text search configuration "%s" Text search configuration "%s.%s" Text search parser "%s" Text search parser "%s.%s" The connection to the server was lost. Attempting reset: The input is a PostgreSQL custom-format dump.
Use the pg_restore command-line client to restore this dump to a database.
The server (version %s) does not support access methods.
The server (version %s) does not support altering default privileges.
The server (version %s) does not support collations.
The server (version %s) does not support editing function source.
The server (version %s) does not support editing view definitions.
The server (version %s) does not support extensions.
The server (version %s) does not support foreign servers.
The server (version %s) does not support foreign tables.
The server (version %s) does not support foreign-data wrappers.
The server (version %s) does not support full text search.
The server (version %s) does not support savepoints for ON_ERROR_ROLLBACK.
The server (version %s) does not support showing function source.
The server (version %s) does not support showing view definitions.
The server (version %s) does not support tablespaces.
The server (version %s) does not support user mappings.
There is no previous error. Time: %.3f ms
Timing is off. Timing is on. Title is "%s".
Title is unset.
Token Token name Token types for parser "%s" Token types for parser "%s.%s" Triggers firing always: Triggers firing on replica only: Triggers: Trusted Try "%s --help" for more information.
Tuples only is off.
Tuples only is on.
Type Type "help" for help.
Type: \copyright for distribution terms
\h for help with SQL commands
\? for help with psql commands
\g or terminate with semicolon to execute query
\q to quit
Typed table of type: %s Unicode border line style is "%s".
Unicode column line style is "%s".
Unicode header line style is "%s".
Unlogged index "%s.%s" Unlogged materialized view "%s.%s" Unlogged table "%s.%s" Usage:
Use "\q" to leave %s.
User name Validator Value Variables
Version View "%s.%s" View definition: Volatility WARNING: %s major version %s, server major version %s.
Some psql features might not work.
WARNING: Console code page (%u) differs from Windows code page (%u)
8-bit characters might not work correctly. See psql reference
page "Notes for Windows users" for details.
Wrote history to file "%s".
You are connected to database "%s" as user "%s" on host "%s" at port "%s".
You are connected to database "%s" as user "%s" via socket in "%s" at port "%s".
You are currently not connected to a database.
You are now connected to database "%s" as user "%s" on host "%s" at port "%s".
You are now connected to database "%s" as user "%s" via socket in "%s" at port "%s".
You are now connected to database "%s" as user "%s".
You are using psql, the command-line interface to PostgreSQL. \!: failed
\%s: could not change directory to "%s": %s
\%s: environment variable name must not contain "="
\%s: error while setting variable
\%s: extra argument "%s" ignored
\%s: missing required argument
\connect: %s \copy: arguments required
\copy: parse error at "%s"
\copy: parse error at end of line
\crosstabview: ambiguous column name: "%s"
\crosstabview: column name not found: "%s"
\crosstabview: column number %d is out of range 1..%d
\crosstabview: data column must be specified when query returns more than three columns
\crosstabview: maximum number of columns (%d) exceeded
\crosstabview: query must return at least three columns
\crosstabview: query result contains multiple data values for row "%s", column "%s"
\crosstabview: statement did not return a result set
\crosstabview: vertical and horizontal headers must be different columns
\df does not take a "w" option with server version %s
\df only takes [antwS+] as options
\pset: allowed Unicode border line styles are single, double
\pset: allowed Unicode column line styles are single, double
\pset: allowed Unicode header line styles are single, double
\pset: allowed formats are unaligned, aligned, wrapped, html, asciidoc, latex, latex-longtable, troff-ms
\pset: allowed line styles are ascii, old-ascii, unicode
\pset: unknown option: %s
\watch cannot be used with COPY
\watch cannot be used with an empty query
abbreviated_grant_or_revoke abort the current transaction aborted because of read failure access_method_type action agg aggregate_name aggregate_signature alias alignment allowconn always analyze_function and aggregate_signature is: and conflict_action is one of: and grouping_element can be one of: and like_option is: and table_constraint is: and table_constraint_using_index is: and with_query is: arg_data_type arg_name arg_type argmode argname argtype argument argument_type arguments attribute attribute_name attribute_option base_type boolean cache call_handler cancel a transaction that was earlier prepared for two-phase commit canceled by user cannot duplicate null pointer (internal error)
cannot escape without active connection
canonical_function category change a database change a database role change a run-time parameter change a server configuration parameter change role name or membership change the definition of a collation change the definition of a conversion change the definition of a domain change the definition of a foreign server change the definition of a foreign table change the definition of a foreign-data wrapper change the definition of a function change the definition of a large object change the definition of a materialized view change the definition of a procedural language change the definition of a row level security policy change the definition of a rule change the definition of a schema change the definition of a sequence generator change the definition of a table change the definition of a tablespace change the definition of a text search configuration change the definition of a text search dictionary change the definition of a text search parser change the definition of a text search template change the definition of a trigger change the definition of a type change the definition of a user mapping change the definition of a view change the definition of an aggregate function change the definition of an event trigger change the definition of an extension change the definition of an index change the definition of an operator change the definition of an operator class change the definition of an operator family change the ownership of database objects owned by a database role channel check_expression child process exited with exit code %d child process exited with unrecognized status %d child process was terminated by exception 0x%X child process was terminated by signal %d child process was terminated by signal %s close a cursor cluster a table according to an index code collatable collate %s collation collect statistics about a database column_alias column_constraint column_definition column_name column_type com_op combinefunc command command not executable command not found commit a transaction that was earlier prepared for two-phase commit commit the current transaction compute a set of rows condition configuration_parameter conflict_action conflict_target connection to server was lost
connlimit constraint constraint_name copy data between a file and a table could not change directory to "%s": %s could not close pipe to external command: %s
could not execute command "%s": %s
could not find a "%s" to execute could not get home directory for user ID %ld: %s
could not identify current directory: %s could not locate temporary directory: %s
could not look up effective user ID %ld: %s could not open temporary file "%s": %s
could not parse reloptions array
could not read binary "%s" could not read from input file: %s
could not read symbolic link "%s" could not save history to file "%s": %s
could not set variable "%s"
could not start /bin/sh
could not start editor "%s"
could not stat file "%s": %s
could not write COPY data: %s
count create a new database create new rows in a table cursor_name data_type database_name deallocate a prepared statement default default %s default_expr define a cursor define a new access method define a new aggregate function define a new cast define a new collation define a new data type define a new database role define a new domain define a new encoding conversion define a new event trigger define a new foreign server define a new foreign table define a new foreign-data wrapper define a new function define a new index define a new mapping of a user to a foreign server define a new materialized view define a new operator define a new operator class define a new operator family define a new procedural language define a new rewrite rule define a new row level security policy for a table define a new savepoint within the current transaction define a new schema define a new sequence generator define a new table define a new table from the results of a query define a new tablespace define a new text search configuration define a new text search dictionary define a new text search parser define a new text search template define a new transform define a new trigger define a new view define access privileges define default access privileges define or change a security label applied to an object define or change the comment of an object definer definition delete delete rows of a table delimiter delimiter_character deserialfunc dest_encoding destroy a previously defined savepoint dictionary_name direction directory disabled discard session state domain constraint domain_constraint domain_name element empty a table or set of tables enabled encoding encoding_name end_function environment variable PSQL_EDITOR_LINENUMBER_ARG must be set to specify a line number
escape_character event exclude_element exclude_element in an EXCLUDE constraint is: execute a prepared statement execute an anonymous code block execution_cost existing_collation existing_enum_value expression extension_name family_name fdw_name ffunc filename filter_variable for table "%s.%s" force a transaction log checkpoint foreign table format_name from_item from_sql_function_name function function name is required
function_name garbage-collect and optionally analyze a database generate a notification gettoken_function group_name grouping_element handler_function headline_function history is not supported by this installation
immutable import table definitions from a foreign server in assignment increment index index_column_name index_expression index_method index_name index_parameters index_parameters in UNIQUE, PRIMARY KEY, and EXCLUDE constraints are: index_predicate init_function initial_condition inline_handler input_function insert install an extension integer internallength invalid binary "%s" invalid command \%s
invalid line number: %s
invalid output format (internal error): %d invoker istemplate join_column join_condition join_proc join_type label lang_name large_object_oid lc_collate lc_ctype left_type lexize_function lextypes_function like_option like_type link_symbol listen for a notification load a shared library file local socket local_schema locale lock a table lockmode loid materialized view maxvalue member_object method mffunc minitial_condition minvalue minvfunc more than one row returned for \gset
msfunc mstate_data_size mstate_data_type name neg_op new_attribute_name new_column_name new_constraint_name new_dictionary new_enum_value new_name new_owner new_role new_schema new_table new_tablespace new_version no no query buffer
no rows returned for \gset
normal not null null_string obj_file object_name off old_dictionary old_role old_version on op_type opclass operator operator class operator family operator_name option or the old syntax out of memory out of memory
output_expression output_function output_name parameter parent_table parser_name password payload pclose failed: %s policy_name position a cursor predicate preferred prepare a statement for execution prepare the current transaction for two-phase commit primary key, provider psql is the PostgreSQL interactive terminal.
psql variables:
query quote_character rebuild indexes receive_function refcolumn referenced_table_name reftable relation_name remote_schema remove a cast remove a collation remove a conversion remove a data type remove a database remove a database role remove a domain remove a foreign server descriptor remove a foreign table remove a foreign-data wrapper remove a function remove a materialized view remove a procedural language remove a rewrite rule remove a row level security policy from a table remove a schema remove a sequence remove a table remove a tablespace remove a text search configuration remove a text search dictionary remove a text search parser remove a text search template remove a transform remove a trigger remove a user mapping for a foreign server remove a view remove access privileges remove an access method remove an aggregate function remove an event trigger remove an extension remove an index remove an operator remove an operator class remove an operator family remove database objects owned by a database role replace the contents of a materialized view replica res_proc restart restore the value of a run-time parameter to the default value restricted result_rows retrieve rows from a query using a cursor retrieve rows from a table or view rettype rewrite_rule_name right_type role_name role_specification roll back to a savepoint rule rule_name safe sampling_method savepoint_name schema_element schema_name seed select send_function sequence sequence_name serialfunc server_name server_type server_version set constraint check timing for the current transaction set the characteristics of the current transaction set the current user identifier of the current session set the session user identifier and the current user identifier of the current session sfunc show the execution plan of a statement show the value of a run-time parameter skipping recursive expansion of variable "%s"
snapshot_id sort_expression sort_family_name sort_operator source_config source_encoding source_table source_type special stable start start a transaction block start_function state_data_size state_data_type statement stop listening for a notification storage storage_parameter storage_type strategy_number sub-SELECT subtype subtype_diff_function subtype_operator_class support_number tab completion query failed: %s
Query was:
%s
table table constraint table_constraint table_constraint_using_index table_name tablespace_name tablespace_option target_role target_type template text timestamp timezone to_sql_function_name token_type transaction_id transaction_mode trigger trigger_name trying to exit copy mode type type_modifier_input_function type_modifier_output_function type_name uid unexpected PQresultStatus: %d
unexpected result status for \watch
unexpected transaction status (%d)
unique, unknown unrecognized value "%s" for "%s"; assuming "%s"
unsafe unterminated quoted string
update update rows of a table user does not exist user name lookup failure: error code %lu user_name using_expression valfunction validator_function value values version view view name is required
view_option_name view_option_value volatile where abbreviated_grant_or_revoke is one of: where action is one of: where aggregate_signature is: where column_constraint is: where conflict_target can be one of: where constraint is: where direction can be empty or one of: where event can be one of: where from_item can be one of: where lockmode is one of: where member_object is: where option can be one of: where option can be: where role_specification can be: where transaction_mode is one of: window window_definition window_name with_query with_query_name yes Project-Id-Version: psql (PostgreSQL 9.6)
Report-Msgid-Bugs-To: pgsql-bugs@postgresql.org
POT-Creation-Date: 2020-05-15 23:52+0000
PO-Revision-Date: 2017-05-20 23:08-0400
Last-Translator: Álvaro Herrera <alvherre@alvh.no-ip.org>
Language-Team: PgSQL Español <pgsql-es-ayuda@postgresql.org>
Language: es
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Plural-Forms: nplurals=2; plural=n != 1;
Opciones de conexión:
Parámetros de despliegue:
Variables de ambiente:
Para obtener más ayuda, digite «\?» (para órdenes internas) o «\help»
(para órdenes SQL) dentro de psql, o consulte la sección de psql
en la documentación de PostgreSQL.
Opciones de entrada y salida:
Opciones de formato de salida:
Analizador: «%s»
Analizador: «%s.%s» --help=commands listar órdenes backslash, luego salir
--help=variables listar variables especiales, luego salir
(opciones: S = desplegar objectos de sistema, + = agregar más detalle)
-0, --record-separator-zero
separador de filas en formato «unaligned» es byte cero
-1 («uno»), --single-transaction
ejecuta órdenes en una única transacción
-?, --help[=opcs] mostrar esta ayuda, luego salir
-A, --no-align modo de salida desalineado
-E, --echo-hidden mostrar consultas generadas por órdenes internas
-F, --field-separator=CADENA separador de campos para salida desalineada
(por omisión: «%s»)
-H, --html modo de salida en tablas HTML
-L, --log-file=ARCH envía el registro de la sesión a un archivo
-P, --pset=VAR[=ARG] definir opción de impresión VAR en ARG (ver orden \pset)
-R, --record-separator=CADENA separador de registros para salida desalineada
(por omisión: salto de línea)
-S, --single-line modo de líneas (fin de línea termina la orden SQL)
-T, --table-attr=TEXTO
definir atributos de tag «table» en formato «html»
-U, --username=NOMBRE
nombre de usuario (por omisión: «%s»)
-V, --version mostrar información de versión, luego salir
-W, --password forzar petición de contraseña
(debería ser automático)
-X, --no-psqlrc no leer archivo de configuración (~/.psqlrc)
-a, --echo-all mostrar las órdenes del script
-b, --echo-errors mostrar órdenes fallidas
-c, --command=ORDEN ejecutar sólo una orden (SQL o interna) y salir
-d, --dbname=NOMBRE nombre de base de datos a conectarse
(por omisión: «%s»)
-e, --echo-queries mostrar órdenes enviadas al servidor
-f, --file=ARCHIVO ejecutar órdenes desde archivo, luego salir
-h, --host=NOMBRE nombre del anfitrión o directorio de socket
(por omisión: «%s»)
-l, --list listar bases de datos, luego salir
-n, --no-readline deshabilitar edición de línea de órdenes (readline)
-o, --output=ARCHIVO enviar resultados de consultas a archivo (u |orden)
-p, --port=PUERTO puerto del servidor (por omisión: «%s»)
-q, --quiet modo silencioso (sin mensajes, sólo resultados)
-s, --single-step modo paso a paso (confirmar cada consulta)
-t, --tuples-only sólo muestra registros
-v, --set=, --variable=NOMBRE=VALOR
definir variable de psql NOMBRE a VALOR
(p.ej. -v ON_ERROR_STOP=1)
-w, --no-password nunca pedir contraseña
-x, --expanded activar modo expandido de salida de tablas
-z, --field-separator-zero
separador de campos en formato «unaligned» es byte cero
AUTOCOMMIT si está definida, órdenes SQL exitosas se comprometen
automáticamente
COLUMNS número de columnas para formato «wrapped»
COMP_KEYWORD_CASE determina si usar mayúsculas al completar palabras SQL
[lower, upper, preserve-lower, preserve-upper]
DBNAME la base de datos actualmente conectada
ECHO controla qué entrada se escribe a la salida estándar
[all, errors, none, queries]
ECHO_HIDDEN muestra consultas internas usadas por órdenes backslash
con [noexec] sólo las muestra sin ejecutarlas
ENCODING codificación actual del cliente
FETCH_COUNT número de filas del resultado que traer y mostrar cada vez
(por omisión: 0=sin límite)
HISTCONTROL controla la lista de historia de órdenes
[ignorespace, ignoredups, ignoreboth]
HISTFILE nombre de archivo para almacenar historia de órdenes
HISTSIZE número de órdenes a guardar en la historia de órdenes
HOST el servidor actualmente conectado
IGNOREEOF si no está definida, enviar un EOF a sesión interactiva
termina la aplicación
LASTOID el valor del último OID afectado
NOMBRE=VALOR [NOMBRE=VALOR] psql ...
o \setenv NOMBRE [VALOR] dentro de psql
ON_ERROR_ROLLBACK si está definido, un error no aborta la transacción
(usa «savepoints» implícitos)
ON_ERROR_STOP detiene ejecución por lotes al ocurrir un error
PAGER nombre de programa paginador externo
PGAPPNAME igual que el parámetro de conexión application_name
PGDATABASE igual que el parámetro de conexión dbname
PGHOST igual que el parámetro de conexión host
PGPASSFILE nombre de archivo de contraseñas
PGPASSWORD contraseña de la conexión (no recomendado)
PGPORT igual que el parámetro de conexión port
PGUSER igual que el parámetro de conexión user
PORT puerto del servidor de la conexión actual
PROMPT1 especifica el prompt estándar de psql
PROMPT2 especifica el prompt usado cuando una sentencia continúa
de una línea anterior
PROMPT3 especifica el prompt usado durante COPY ... FROM STDIN
PSQLRC ubicación alternativa para el archivo .psqlrc del usuario
PSQL_EDITOR, EDITOR, VISUAL
editor usado por órdenes \e, \ef, y \ev
PSQL_EDITOR_LINENUMBER_ARGS
cómo especificar número de línea al invocar al editor
PSQL_HISTORY ubicación alternativa del archivo de historia de órdenes
QUIET ejecuta silenciosamente (igual que -q)
SHELL intérprete usado por la orden \!
SHOW_CONTEXT controla el despliegue de campos de contexto de mensaje
[never, errors, always]
SINGLELINE fin de línea termina modo de órdenes SQL (igual que -S)
SINGLESTEP modo paso a paso (igual que -s)
TMPDIR directorio para archivos temporales
USER el usuario actualmente conectado
VERBOSITY controla la verbosidad de errores [default, verbose, terse]
\! [ORDEN] ejecutar orden en intérprete de órdenes (shell),
o iniciar intérprete interactivo
\? [commands] desplegar ayuda sobre las órdenes backslash
\? options desplegar ayuda sobre opciones de línea de órdenes
\? variables desplegar ayuda sobre variables especiales
\C [CADENA] definir título de tabla, o indefinir si es vacío
\H cambiar modo de salida HTML (actualmente %s)
\T [CADENA] definir atributos HTML de <table>, o indefinir si es vacío
\a cambiar entre modo de salida alineado y sin alinear
\c[onnect] [BASE-DE-DATOS|- USUARIO|- ANFITRIÓN|- PUERTO|- | conninfo]
conectar a una nueva base de datos (actual: «%s»)
\c[onnect] [BASE-DE-DATOS|- USUARIO|- ANFITRIÓN|- PUERTO|- | conninfo]
conectar a una nueva base de datos (no hay conexión actual)
\cd [DIR] cambiar el directorio de trabajo actual
\conninfo despliega la información sobre la conexión actual
\copy ... ejecutar orden SQL COPY con flujo de datos al cliente
\copyright mostrar términos de uso y distribución de PostgreSQL
\crosstabview [COLUMNAS] ejecutar la consulta y desplegar en «crosstab»
\dA[+] [PATRÓN] listar métodos de acceso
\dC[+] [PATRÓN] listar conversiones de tipo (casts)
\dD[S+] [PATRÓN] listar dominios
\dE[S+] [PATRÓN] listar tablas foráneas
\dF[+] [PATRÓN] listar configuraciones de búsqueda en texto
\dFd[+] [PATRÓN] listar diccionarios de búsqueda en texto
\dFp[+] [PATRÓN] listar analizadores (parsers) de búsq. en texto
\dFt[+] [PATRÓN] listar plantillas de búsqueda en texto
\dL[S+] [PATRÓN] listar lenguajes procedurales
\dO[S] [PATRÓN] listar ordenamientos (collations)
\dT[S+] [PATRÓN] listar tipos de dato
\d[S+] listar tablas, vistas y secuencias
\d[S+] NOMBRE describir tabla, índice, secuencia o vista
\da[S] [PATRÓN] listar funciones de agregación
\db[+] [PATRÓN] listar tablespaces
\dc[S+] [PATRÓN] listar conversiones
\dd[S] [PATRÓN] listar comentarios de objetos que no aparecen en otra parte
\ddp [PATRÓN] listar privilegios por omisión
\des[+] [PATRÓN] listar servidores foráneos
\det[+] [PATRÓN] listar tablas foráneas
\deu[+] [PATRÓN] listar mapeos de usuario
\dew[+] [PATRÓN] listar conectores de datos externos
\df[antw][S+] [PATRÓN] listar funciones [sólo ag./normal/trigger/ventana]
\dg[S+] [PATRÓN] listar roles
\di[S+] [PATRÓN] listar índices
\dl listar objetos grandes, lo mismo que \lo_list
\dm[S+] [PATRÓN] listar vistas materializadas
\dn[S+] [PATRÓN] listar esquemas
\do[S] [PATRÓN] listar operadores
\dp [PATRÓN] listar privilegios de acceso a tablas, vistas y secuencias
\drds [PAT1 [PAT2]] listar parámetros de rol por base de datos
\ds[S+] [PATRÓN] listar secuencias
\dt[S+] [PATRÓN] listar tablas
\du[S+] [PATRÓN] listar roles
\dv[S+] [PATRÓN] listar vistas
\dx[+] [PATRÓN] listar extensiones
\dy [PATRÓN] listar disparadores por eventos
\e [ARCHIVO] [LÍNEA]
editar el búfer de consulta (o archivo) con editor externo
\echo [CADENA] escribir cadena a salida estándar
\ef [NOMBRE-FUNCIÓN [LÍNEA]]
editar una función con editor externo
\encoding [CODIFICACIÓN]
mostrar o definir codificación del cliente
\errverbose mostrar error más reciente en máxima verbosidad
\ev [NOMBRE-VISTA [LÍNEA]]
editar definición de una vista con editor externo
\f [CADENA] mostrar o definir separador de campos para
modo de salida sin alinear
\g [ARCH] o ; enviar búfer de consulta al servidor
(y resultados a archivo u |orden)
\gexec ejecutar la consulta, luego ejecuta cada valor del resultado
\gset [PREFIJO] ejecutar la consulta y almacenar los resultados en variables
de psql
\h [NOMBRE] desplegar sintaxis de órdenes SQL, use * para mostrar todas
\i ARCHIVO ejecutar órdenes desde archivo
\ir ARCHIVO como \i, pero relativo a la ubicación del script actual
\l[+] [PATRÓN] listar bases de datos
\lo_export LOBOID ARCHIVO
\lo_import ARCHIVO [COMENTARIO]
\lo_list
\lo_unlink LOBOID operaciones con objetos grandes
\o [ARCHIVO] enviar resultados de consultas a archivo u |orden
\p mostrar el contenido del búfer de consulta
\password [USUARIO]
cambiar la contraseña para un usuario en forma segura
\prompt [TEXTO] NOMBRE preguntar al usuario el valor de la variable
\pset [NOMBRE [VALOR]] define opción de tabla de salida
(NOMBRE := {border|columns|expanded|fieldsep|fieldsep_zero|
footer|format|linestyle|null|numericlocale|pager|
pager_min_lines|recordsep|recordsep_zero|tableattr|title|
tuples_only|unicode_border_linestyle|unicode_column_linestyle|
unicode_header_linestyle})
\q salir de psql
\qecho [CADENA] escribir cadena a salida de consultas (ver \o)
\r reiniciar (limpiar) el búfer de consulta
\s [ARCHIVO] mostrar historial de órdenes o guardarlo en archivo
\set [NOMBRE [VALOR]] definir variables internas,
listar todas si no se dan parámetros
\setenv NOMBRE [VALOR]
definir o indefinir variable de ambiente
\sf[+] FUNCIÓN mostrar la definición de una función
\sv[+] VISTA mostrar la definición de una vista
\t [on|off] mostrar sólo filas (actualmente %s)
\timing [on|off] mostrar tiempo de ejecución de órdenes
(actualmente %s)
\unset NOMBRE indefinir (eliminar) variable interna
\w ARCHIVO escribir búfer de consulta a archivo
\watch [SEGS] ejecutar consulta cada SEGS segundos
\x [on|off|auto] cambiar modo expandido (actualmente %s)
\z [PATRÓN] lo mismo que \dp
border estilo de borde (número)
columns define el ancho para formato «wrapped»
expanded (o x) salida expandida [on, off, auto]
fieldsep separador de campos para formato «unaligned»
(por omisión: «%s»)
fieldsep_zero separador de campos en «unaligned» es byte cero
footer activa o desactiva el pie de tabla [on, off]
format define el formato de salida
[unaligned, aligned, wrapped, html, asciidoc, ...]
linestyle define el estilo de dibujo de líneas [unicode, ascii, ...]
null define la cadena a imprimirse para valores null
numericlocale desplegar de carácter específico del lenguaje para
separar grupos de dígitos [on, off]
pager controla si se usará paginador externo [yes, no, always]
psql --pset=NOMBRE[=VALOR]
o \pset NOMBRE [VALOR] dentro de psql
psql --set=NOMBRE=VALOR
o \set NOMBRE VALOR dentro de psql
psql [OPCIONES]... [BASE-DE-DATOS [USUARIO]]
recordsep separador de registros (líneas) para formato «unaligned»
recordsep_zero separador de registros en «unaligned» es byte cero
set NOMBRE=VALOR
psql ...
o \setenv NOMBRE [VALOR] dentro de psql
tableattr (o T) especifica atributos para el tag «table» en formato «html»,
o ancho proporcional de columnas alineadas a la izquierda
en formato «latex-longtable»
title define el título de tablas
tuples_only si está definido, sólo los datos de la tabla se muestran
unicode_border_linestyle
unicode_column_linestyle
unicode_header_linestyle
define el estilo de líneas Unicode [single, double]
«%s.%s» no es una vista
%d conexión %d conexiones %s %s %s (cada %gs)
%s
%s (%s, servidor %s)
%s (cada %gs)
%s: %s
%s: -1 sólo puede ser usado en modo no interactivo
%s: no se puede copiar desde/hacia un directorio
%s: no se pudo eliminar la variable «%s»
%s: no se pudo encontrar el ejecutable propio
%s: no se pudo abrir archivo de log «%s»: %s
%s: no se pudo definir parámetro de impresión «%s»
%s: no se pudo definir la variable «%s»
%s: transacción en curso está abortada
%s: nombre de codificación no válido o procedimiento de conversión
no encontrado
%s: no está conectado a una base de datos
%s: memoria agotada
%s: estado de transacción desconocido
%s: atención: se ignoró argumento extra «%s» en línea de órdenes
(%lu fila) (%lu filas) ***(Modo paso a paso: verifique la orden)****************************************
%s
***(presione enter para continuar, o x y enter para cancelar)*******************
********* QUERY **********
%s
**************************
+ opt(%d) = |%s|
, clustered , postergable , inicialmente postergada , no válido , predicado (%s) , identidad de replicación , tablespace «%s» Privilegios Debe proveer todos los parámetros de conexión porque no existe conexión a una base de datos
Tipos de datos de argumentos Notificación asíncrona «%s» recibida del proceso de servidor con PID %d.
Notificación asíncrona «%s» con carga «%s» recibida del proceso de servidor con PID %d.
Atributos Ayuda disponible:
El estilo de borde es %d.
Ignora RLS falló la transferencia de datos COPY: %s Manejador de llamada No se puede agregar una celda al contenido de la tabla: la cantidad de celdas de %d ha sido excedida.
No se puede agregar un encabezado al contenido de la tabla: la cantidad de columnas de %d ha sido excedida.
No puede conectarse Check Restricciones CHECK: Tablas hijas Collate Columna Privilegios de acceso a columnas Orden: %s
Descripción: %s
Sintaxis:
%s
Tipo compuesto «%s.%s» Conexiones
Crear BD Crear rol Ctype Base de Datos Privilegios de acceso por omisión El pie de página por omisión está desactivado.
El pie por omisión está activo.
Por omisión? Definición Descripción Destino Diccionarios No se encontró extensión llamada «%s».
No se encontró ninguna extensión.
No se encontró relación llamada «%s».
No se encontró relación con OID %s.
No se encontró una configuración de búsqueda en texto llamada «%s».
No se encontró ningún analizador de búsqueda en texto llamado «%s».
Disparadores internos deshabilitados: Reglas deshabilitadas: Disparadores deshabilitados: Disparadores de usuario deshabilitados: Elementos Activo Codificación Fin de parse Ingrese los datos a ser copiados seguidos de un fin de línea.
Termine con un backslash y un punto, o una señal EOF. Ingrésela nuevamente: Ingrese la nueva contraseña: Evento Se ha desactivado el despliegue expandido.
Se ha activado el despliegue expandido.
El despliegue expandido se usa automáticamente.
Opciones de FDW Opciones de FDW: (%s) falló.
El separador de campos es «%s».
El separador de campos es el byte cero.
Tabla foránea «%s.%s» Conectores de datos externos Restricciones de llave foránea: Formato
Función General
Opciones generales:
Obtener encabezado Obtener siguiente elemento Obtener tipos de elemento Manejador Tiene OIDs: sí Ayuda
ID Implícito? Indice Índice «%s.%s» Índices: Informativo
Hereda Inicializador Opciones de inicialización Manejador en línea Entrada/Salida
Lenguaje interno Nombre interno Interrumpido
Orden \%s no válida. Use \? para obtener ayuda.
Lenguaje Objetos Grandes
Objetos grandes Tipo arg izq Fn. análisis léx. El estilo de línea es %s.
Lista de métodos de acceso Listado de funciones de agregación Listado de conversiones de tipo (casts) Listado de ordenamientos Listado de conversiones Listado de tipos de dato Listado de base de datos Listado de dominios Listado de disparadores por eventos Listado de servidores foráneos Listado de tablas foráneas Listado de conectores de datos externos Listado de funciones Listado de extensiones instaladas Lista de lenguajes Listado de operadores Listado de relaciones Lista de roles Listado de esquemas Listado de parámetros Lista de variables con tratamiento especial
Listado de tablespaces Listado de configuraciones de búsqueda en texto Listado de diccionarios de búsqueda en texto Listado de analizadores de búsqueda en texto Listado de plantillas de búsqueda en texto Listado de mapeos de usuario La salida numérica ajustada localmente está deshabilitada.
La salida numérica ajustada localmente está habilitada.
Ubicación Vista materializada "%s.%s" Miembro de Método Modificador Modificadores Nombre Sin cambios Ninguna conexión No hay ayuda disponible para «%s».
Pruebe \h sin argumentos para mostrar los elementos de ayuda disponibles.
Sin herencia No se encontraron relaciones coincidentes.
No se encontraron parámetros coincidentes.
Este servidor no permite parámetros por usuario por base de datos.
No se encontraron relaciones.
No se encontraron parámetros.
Despliegue de nulos es «%s».
Número de tablas hijas: %d (Use \d+ para listarlas.) Objeto Descripciones de objetos Descripciones de objetos Objetos en extensión «%s» Sistema Operativo
Opciones El formato de salida es %s.
Asociada a: %s Dueño El paginador se usará siempre.
El paginador se usará para salida larga.
El paginador no se usará.
El paginador no se usará para menos de %d línea.
El paginador no se usará para menos de %d líneas.
Paralelismo El cifrado de la contraseña falló.
Contraseña para usuario %s: Constraseña válida hasta Contraseña: Las constraseñas no coinciden.
Políticas Políticas (seguridad de registros forzada): Políticas (seguridad de filas forzada): (ninguna) Políticas (seguridad de filas inactiva): Políticas (seguridad de filas activa): (ninguna) Políticas: Se ha mantenido la conexión anterior
Procedimiento Búfer de consulta
El búfer de consulta está vacío. El búfer de consulta ha sido reiniciado (limpiado). El separador de filas es «%s».
El separador de filas es <salto de línea>.
El separador de filas es el byte cero.
Referenciada por: Identidad de replicación Replicación Reporte errores a <pgsql-bugs@postgresql.org>.
Tipo de dato de salida Tipo resultado Tipo arg der Nombre de rol Nombre de rol Reglas que se activan siempre: Reglas que se activan sólo en las réplicas: Reglas: conexión SSL (protocolo: %s, cifrado: %s, bits: %s, compresión: %s)
SENTENCIA: %s
Esquema Seguridad Secuencia «%s.%s» Servidor Servidor: %s Parámetros Tamaño Fuente Código fuente Tipo fuente Relación especial «%s.%s» Inicio de parse Estadísticas Almacenamiento con éxito.
Superusuario Tabla TOAST «%s.%s» Tabla Tabla «%s.%s» Los atributos de tabla son «%s».
Los atributos de tabla han sido indefinidos.
Tablespace Tablespace: «%s» Etiquetas Tipo destino El ancho es %d.
El ancho no está definido.
Plantilla Configuración de búsqueda en texto «%s» Configuración de búsqueda en texto «%s.%s» Analizador de búsqueda en texto «%s» Analizador de búsqueda en texto «%s.%s» La conexión al servidor se ha perdido. Intentando reiniciar: La entrada es un dump de PostgreSQL en formato custom.
Use el programa pg_restore para restaurar este dump a una base de datos.
El servidor (versión %s) no soporta métodos de acceso.
El servidor (versión %s) no soporta la alteración de privilegios por omisión.
El servidor (versión %s) no soporta «collations».
El servidor (versión %s) no soporta la edición del código fuente de funciones.
El servidor (versión %s) no soporta la edición de vistas.
El servidor (versión %s) no soporta extensiones.
El servidor (versión %s) no soporta servidores foráneos.
El servidor (versión %s) no soporta tablas foráneas.
El servidor (versión %s) no soporta conectores de datos externos.
El servidor (versión %s) no soporta búsqueda en texto.
El servidor (versión %s) no soporta savepoints para ON_ERROR_ROLLBACK.
El servidor (versión %s) no soporta el despliegue del código fuente de funciones.
El servidor (versión %s) no soporta el despliegue de definiciones de vistas.
El servidor (versión %s) no soporta tablespaces.
El servidor (versión %s) no soporta mapeos de usuario.
No hay error anterior. Duración: %.3f ms
El despliegue de duración está desactivado. El despliegue de duración está activado. El título es «%s».
El título ha sido indefinido.
Elemento Nombre de elemento Tipos de elemento para el analizador «%s» Tipos de elemento para el analizador «%s.%s» Disparadores que siempre se ejecutan: Disparadores que se ejecutan sólo en las réplicas: Triggers: Confiable Use «%s --help» para obtener más información.
Mostrar sólo filas está desactivado.
Mostrar sólo filas está activado.
Tipo Digite «help» para obtener ayuda.
Digite: \copyright para ver los términos de distribución
\h para ayuda de órdenes SQL
\? para ayuda de órdenes psql
\g o punto y coma («;») para ejecutar la consulta
\q para salir
Tabla tipada de tipo: %s El estilo Unicode de borde es «%s».
El estilo de línea Unicode de columna es «%s».
El estilo de línea Unicode de encabezado es «%s».
Índice unlogged «%s.%s» Vista materializada unlogged «%s.%s» Tabla unlogged «%s.%s» Empleo:
Use «\q» para salir de %s.
Nombre de usuario Validador Valor Variables
Versión Vista «%s.%s» Definición de vista: Volatilidad ADVERTENCIA: %s versión mayor %s, servidor versión mayor %s.
Algunas características de psql podrían no funcionar.
ADVERTENCIA: El código de página de la consola (%u) difiere del código
de página de Windows (%u).
Los caracteres de 8 bits pueden funcionar incorrectamente.
Vea la página de referencia de psql «Notes for Windows users»
para obtener más detalles.
Se escribió la historia en el archivo «%s».
Está conectado a la base de datos «%s» como el usuario «%s» en el servidor «%s» port «%s».
Está conectado a la base de datos «%s» como el usuario «%s» a través del socket en «%s» port «%s».
No está conectado a una base de datos.
Ahora está conectado a la base de datos «%s» como el usuario «%s» en el servidor «%s» port «%s».
Ahora está conectado a la base de datos «%s» como el usuario «%s» a través del socket en «%s» port «%s».
Ahora está conectado a la base de datos «%s» con el usuario «%s».
Está usando psql, la interfaz de línea de órdenes de PostgreSQL. \!: falló
\%s: no se pudo cambiar directorio a «%s»: %s
\%s: el nombre de variable de ambiente no debe contener «=»
\%s: error mientras se definía la variable
\%s: argumento extra «%s» ignorado
\%s: falta argumento requerido
\connect: %s \copy: argumentos requeridos
\copy: error de procesamiento en «%s»
\copy: error de procesamiento al final de la línea
\crosstabview: nombre de columna «%s» ambiguo
\crosstabview: nombre de columna «%s» no encontrado
\crosstabview: el número de columna %d está fuera del rango 1..%d
\crosstabview: la columna de datos debe ser especificada cuando la consulta retorna más de tres columnas
\crosstabview: se superó el número máximo de columnas (%d)
\crosstabview: la consulta debe retornar al menos tres columnas
\crosstabview: el resultado de la consulta contiene múltiples valores para la fila «%s», columna «%s»
\crosstabview: la sentencia no produjo un conjunto de resultados
\crosstabview: los encabezados verticales y horizontales deben ser columnas distintas
\df no acepta la opción «w» en un servidor versión %s
\df sólo acepta las opciones [antwS+]
\pset: estilos de línea Unicode de borde permitidos son single, double
\pset: estilos de línea Unicode de columna permitidos son single, double
\pset: estilos de línea Unicode de encabezado permitidos son single, double
\pset: formatos permitidos son unaligned, aligned, wrapped, html, asciidoc, latex, latex-longtable, troff-ms
\pset: estilos de línea permitidos son ascii, old-ascii, unicode
\pset: opción desconocida: %s
no se puede usar \watch con COPY
\watch no puede ser usado con una consulta vacía
grant_o_revoke_abreviado aborta la transacción en curso se abortó por un error de lectura tipo_de_método_de_acceso acción agg nombre_función_agregación signatura_func_agregación alias alineamiento allowconn siempre función_analyze y signatura_func_agregación es: donde acción_de_conflict es una de: donde elemento_agrupante puede ser una de: y opción_de_like es: y restricción_de_tabla es: y restricción_de_tabla_con_índice es: y consulta_with es: tipo_de_dato_arg nombre_arg tipo_arg modo_arg nombre_arg tipo_arg argumento tipo_argumento argumentos atributo nombre_atributo opción_de_atributo tipo_base booleano cache manejador_de_llamada cancela una transacción que fue previamente preparada para two-phase commit. cancelada por el usuario no se puede duplicar un puntero nulo (error interno)
no se puede escapar sin una conexión activa
función_canónica categoría cambia una base de datos cambia un rol de la base de datos cambia un parámetro de configuración cambia un parámetro de configuración del servidor cambiar nombre del rol o membresía cambia la definición de un ordenamiento cambia la definición de una conversión cambia la definición de un dominio cambia la definición de un servidor foráneo cambia la definición de una tabla foránea cambia la definición de un conector de datos externos cambia la definición de una función cambia la definición de un objeto grande cambia la definición de una vista materializada cambia la definición de un lenguaje procedural cambia la definición de una política de seguridad de registros cambia la definición de una regla cambia la definición de un esquema cambia la definición de un generador secuencial cambia la definición de una tabla cambia la definición de un tablespace cambia la definición de una configuración de búsqueda en texto cambia la definición de un diccionario de búsqueda en texto cambia la definición de un analizador de búsqueda en texto cambia la definición de una plantilla de búsqueda en texto cambia la definición de un disparador cambia la definición de un tipo cambia la definición de un mapeo de usuario cambia la definición de una vista cambia la definición de una función de agregación cambia la definición de un disparador por evento cambia la definición de una extensión cambia la definición de un índice cambia la definición de un operador cambia la definición de una clase de operadores cambia la definición de una familia de operadores cambia de dueño a los objetos de propiedad de un rol de la base de datos canal expresión_check el proceso hijo terminó con código de salida %d el proceso hijo terminó con código no reconocido %d el proceso hijo fue terminado por una excepción 0x%X el proceso hijo fue terminado por una señal %d el proceso hijo fue terminado por una señal %s cierra un cursor reordena una tabla siguiendo un índice código ordenable collate %s ordenamiento recolecta estadísticas sobre una base de datos alias_de_columna restricción_de_columna definición_de_columna nombre_de_columna tipo_columna op_conm func_combinación orden la orden no es ejecutable orden no encontrada confirma una transacción que fue preparada para two-phase commit compromete la transacción en curso calcula un conjunto de registros condición parámetro_de_configuración acción_de_conflict destino_de_conflict se ha perdido la conexión al servidor
límite_conexiones restricción nombre_restricción copia datos entre un archivo y una tabla no se pudo cambiar al directorio «%s»: %s no se pudo cerrar la tubería a una orden externa: %s
no se pudo ejecutar la orden «%s»: %s
no se pudo encontrar un «%s» para ejecutar no se pudo obtener directorio home para el usuario de ID %ld: %s
no se pudo identificar el directorio actual: %s no se pudo ubicar el directorio temporal: %s
no se pudo buscar el ID de usuario efectivo %ld: %s no se pudo abrir archivo temporal «%s»: %s
no se pudo interpretar el array reloptions
no se pudo leer el binario «%s» no se pudo leer el archivo de entrada: %s
no se pudo leer el enlace simbólico «%s» no se pudo guardar historial a archivo «%s»: %s
no se pudo definir la variable «%s»
no se pudo iniciar /bin/sh
no se pudo iniciar el editor «%s»
no se pudo hacer stat del archivo «%s»: %s
no se pudo escribir datos COPY: %s
cantidad crea una nueva base de datos crea nuevas filas en una tabla nombre_de_cursor tipo_de_dato nombre_de_base_de_datos elimina una sentencia preparada valor_por_omisión valor por omisión %s expr_por_omisión define un nuevo cursor define un nuevo método de acceso define una nueva función de agregación define una nueva conversión de tipo define un nuevo ordenamiento define un nuevo tipo de datos define un nuevo rol de la base de datos define un nuevo dominio define una nueva conversión de codificación define un nuevo disparador por evento define un nuevo servidor foráneo define una nueva tabla foránea define un nuevo conector de datos externos define una nueva función define un nuevo índice define un nuevo mapa de usuario a servidor foráneo define una nueva vista materializada define un nuevo operador define una nueva clase de operadores define una nueva familia de operadores define un nuevo lenguaje procedural define una nueva regla de reescritura define una nueva política de seguridad de registros para una tabla define un nuevo savepoint en la transacción en curso define un nuevo schema define un nuevo generador secuencial define una nueva tabla crea una nueva tabla usando los resultados de una consulta define un nuevo tablespace define una nueva configuración de búsqueda en texto define un nuevo diccionario de búsqueda en texto define un nuevo analizador de búsqueda en texto define una nueva plantilla de búsqueda en texto define una nueva transformación define un nuevo disparador define una nueva vista define privilegios de acceso define privilegios de acceso por omisión define o cambia una etiqueta de seguridad sobre un objeto define o cambia un comentario sobre un objeto definidor definición delete elimina filas de una tabla delimitador carácter_delimitador func_deserial codificación_destino destruye un savepoint previamente definido nombre_diccionario dirección directorio inactivo descartar datos de la sesión restricción de dominio restricción_de_dominio nombre_de_dominio elemento vacía una tabla o conjunto de tablas activo codificación nombre_codificación función_fin la variable de ambiente PSQL_EDITOR_LINENUMBER_SWITCH debe estar definida para poder especificar un número de línea
carácter_de_escape evento elemento_de_exclusión elemento_de_exclusión en una restricción EXCLUDE es: ejecuta una sentencia preparada ejecutar un bloque anónimo de código costo_de_ejecución ordenamiento_existente valor_enum_existente expresión nombre_de_extensión nombre_familia nombre_fdw func_final nombre_de_archivo variable_de_filtrado de tabla «%s.%s» fuerza un checkpoint del registro de transacciones tabla foránea nombre_de_formato item_de_from nombre_de_función_from función el nombre de la función es requerido
nombre_de_función recolecta basura y opcionalmente estadísticas sobre una base de datos genera una notificación función_gettoken nombre_de_grupo elemento_agrupante función_manejadora función_headline el historial de órdenes no está soportado en esta instalación
inmutable importa definiciones de tablas desde un servidor foráneo en asignación incremento índice nombre_de_columna_de_índice expresión_de_índice método_de_índice nombre_índice parámetros_de_índice parámetros_de_índice en UNIQUE, PRIMARY KEY y EXCLUDE son: predicado_de_índice función_init condición_inicial manejador_en_línea función_entrada insert instala una extensión entero largo_interno el binario «%s» no es válido orden \%s no válida
número de línea no válido: %s
formato de salida no válido (error interno): %d invocador esplantilla columna_de_join condición_de_join proc_join tipo_de_join etiqueta nombre_lenguaje oid_de_objeto_grande lc_collate lc_ctype tipo_izq función_lexize función_lextypes opción_de_like como_tipo símbolo_enlace escucha notificaciones carga un archivo de biblioteca compartida socket local schema_local configuración regional bloquea una tabla modo_bloqueo loid vistas materializadas valormax objeto_miembro método func_final_m condición_inicial_m valormin func_inv_m \gset retornó más de un renglón
func_transición_m tamaño_de_dato_de_estado_m tipo_de_dato_de_estado_m nombre op_neg nuevo_nombre_atributo nuevo_nombre_de_columna nuevo_nombre_restricción diccionario_nuevo nuevo_valor_enum nuevo_nombre nuevo_dueño rol_nuevo nuevo_esquema nueva_tabla nuevo_tablespace nueva_versión no no hay búfer de consulta
\gset no retornó renglón alguno
normal not null cadena_null archivo_obj nombre_de_objeto desactivado diccionario_antiguo rol_antiguo versión_antigua activado tipo_op clase_de_ops operador clase de operadores familia de operadores nombre_operador opción o la sintaxis antigua memoria agotada memoria agotada
expresión_de_salida función_salida nombre_de_salida parámetro tabla_padre nombre_de_parser contraseña carga pclose falló: %s nombre_de_política reposiciona un cursor predicado preferido prepara una sentencia para ejecución prepara la transacción actual para two-phase commit llave primaria, proveedor psql es el terminal interactivo de PostgreSQL.
Variables psql:
consulta carácter_de_comilla reconstruye índices función_receive columna_ref nombre_tabla_referenciada tabla_ref nombre_relación schema_remoto elimina una conversión de tipo elimina un ordenamiento elimina una conversión de codificación elimina un tipo de datos elimina una base de datos elimina un rol de base de datos elimina un dominio elimina un descriptor de servidor foráneo elimina una tabla foránea elimina un conector de datos externos elimina una función elimina una vista materializada elimina un lenguaje procedural elimina una regla de reescritura elimina una política de seguridad de registros de una tabla elimina un schema elimina un generador secuencial elimina una tabla elimina un tablespace elimina una configuración de búsqueda en texto elimina un diccionario de búsqueda en texto elimina un analizador de búsqueda en texto elimina una plantilla de búsqueda en texto elimina una transformación elimina un disparador elimina un mapeo de usuario para un servidor remoto elimina una vista revoca privilegios de acceso elimina un método de acceso elimina una función de agregación elimina un disparador por evento elimina una extensión elimina un índice elimina un operador elimina una clase de operadores elimina una familia de operadores elimina objetos de propiedad de un rol de la base de datos reemplaza los contenidos de una vista materializada réplica proc_res reinicio restaura el valor de un parámetro de configuración al valor inicial restringida núm_de_filas recupera filas de una consulta usando un cursor recupera filas desde una tabla o vista tipo_ret nombre_regla_de_reescritura tipo_der nombre_de_rol especificación_de_rol descartar hacia un savepoint regla nombre_regla segura método_de_sampleo nombre_de_savepoint elemento_de_esquema nombre_de_esquema semilla select función_send secuencia nombre_secuencia func_serial nombre_de_servidor tipo_de_servidor versión_de_servidor define el modo de verificación de las restricciones de la transacción en curso define las características de la transacción en curso define el identificador de usuario actual de la sesión actual define el identificador del usuario de sesión y el identificador
del usuario actual de la sesión en curso func_transición muestra el plan de ejecución de una sentencia muestra el valor de un parámetro de configuración saltando expansión recursiva de la variable «%s»
id_de_snapshot expresión_orden nombre_familia_ordenamiento operador_de_ordenamiento config_origen codificación_origen tabla_origen tipo_fuente especial estable inicio inicia un bloque de transacción función_inicio tamaño_de_dato_de_estado tipo_de_dato_de_estado sentencia deja de escuchar una notificación almacenamiento parámetro_de_almacenamiento tipo_almacenamiento número_de_estrategia sub-SELECT subtipo función_diff_del_subtipo clase_de_operador_del_subtipo número_de_soporte la consulta para completación por tabulador falló: %s
La consulta era:
%s
tabla restricción de tabla restricción_de_tabla restricción_de_tabla_con_índice nombre_de_tabla nombre_de_tablespace opción_de_tablespace rol_destino tipo_destino plantilla texto fecha_hora huso_horario nombre_de_función_to tipo_de_token id_de_transacción modo_de_transacción disparador nombre_disparador tratando de salir del modo copy tipo función_entrada_del_modificador_de_tipo función_salida_del_modificador_de_tipo nombre_de_tipo uid PQresultStatus no esperado: %d
Estado de resultado inesperado de \watch
estado de transacción inesperado (%d)
único, desconocido valor «%s» no reconocido para «%s»; asumiendo «%s»
insegura cadena en comillas sin terminar
update actualiza filas de una tabla el usuario no existe fallo en la búsqueda de nombre de usuario: código de error %lu nombre_de_usuario expresión_using función_val función_validadora valor valores versión vista el nombre de la vista es requerido
nombre_opción_de_vista valor_opción_de_vista volátil donde grant_o_revoke_abreviado es uno de: donde acción es una de: donde signatura_func_agregación es: donde restricción_de_columna es: donde destino_de_conflict puede ser uno de: donde restricción es: donde dirección puede ser vacío o uno de: donde evento puede ser una de: donde item_de_from puede ser uno de: donde modo_bloqueo es uno de: dondo objeto_miembro es: donde opción puede ser una de: donde opción puede ser: donde especificación_de_rol puede ser: donde modo_de_transacción es uno de: ventana definición_de_ventana nombre_de_ventana consulta_with nombre_consulta_with sí locale/es/LC_MESSAGES/pg_basebackup-9.6.mo 0000644 00000071635 14751153421 0013653 0 ustar 00 �� � � ,
� � � � � ! �
- X C T � R � ` D I � D � 4 3 F K z < � j > n N � @ � 3 = Y q > � 1
j < < � ? � M $ k r J � Y ) + � 0 � B � B # * f 8 � � � 5 Y � � r o � 1 � 3 , K ` - � F � \ ! P ~ 2 � 4 8 7 1 p 4 � 1 � . @ 8 1 y E � B � 7 4! l! �! ( �! ' �! & �! ; " ( Z" # �" - �" ' �" " �" # # A# 2 e# , �# + �# . �# ( $ # I$ 5 m$ f �$ ,
% 9 7% 4 q% 7 �% = �% d & A �& " �& & �& &
' # 4' / X' > �' a �' & )( & P( % w( 2 �( 1 �( 0 ) 8 3) ( l) 2 �) �) & �) ' * . 8* + g* # �* A �* 2 �* & ,+ & S+ / z+ + �+ 4 �+ / , ! ;, 1 ], ) �, ( �, 2 �, 2 - 3 H- 0 |- % �- # �- + �- #. @. 2 R. # �. �. , �. , �. # / i D/ i �/ ? 0 9 X0 " �0 A �0 # �0 1 9 <1 v1 �1 ! �1 D �1 & 2 # 92 A ]2 - �2 D �2 ! 3 43 O3 " f3 �3 9 �3 1 �3 D 4 , X4 �4 ' �4 D �4 M 5 : S5 8 �5 6 �5 �5 E 6 G ]6 z �6 c 7 % �7 . �7 2 �7 6 8 # C8 g8 % �8 0 �8 R �8 , *9 4 W9 K �9 @ �9 > : - X: , �: ' �: , �: o ; k x; 4 �; % < ( ?< ; h<
�< & �< �< / �< = / = � M= "? 9? R? h? # ~? �? 0 �? [ �? X ;@ L �@ ` �@ { BA S �A B ; %B O aB B �B n �B I cC J �C D �C < =D _ zD C �D 5 E | TE B �E I F v ^F � �F Q jG b �G / H ? OH H �H L �H < %I C bI � �I 8 9J � rJ K � �K 7 "L 3 ZL v �L 6 M F <M \ �M P �M > 1N < pN O �N @ �N K >O 7 �O / �O N �O 0 AP E rP B �P 8 �P # 4Q . XQ , �Q 6 �Q ' �Q C R 0 WR & �R 7 �R / �R , S $ DS ' iS 5 �S 6 �S 3 �S 6 2T . iT + �T F �T | U 5 �U D �U C V G GV D �V ~ �V X SW 9 �W E �W 1 ,X 2 ^X 3 �X U �X t Y + �Y . �Y / �Y C Z ; _Z D �Z L �Z 9 -[ K g[ & �[ - �[ * \ 6 3\ @ j\ 7 �\ R �\ C 6] - z] : �] ; �] 6 ^ @ V^ : �^ 1 �^ A _ + F_ ( r_ ; �_ C �_ F ` 9 b` . �` + �` 5 �` ) -a Wa A ia . �a " �a 0 �a A .b * pb f �b q c H tc M �c , d N 8d + �d ) �d F �d ( $e Me * me Q �e 8 �e 0 #f N Tf 3 �f H �f " g ( Cg lg . �g , �g J �g H /h J xh ; �h �h 6 i ` Ki j �i C j B [j I �j �j ] k ^ _k � �k } Ml 2 �l 1 �l 5 0m > fm - �m �m % �m D
n [ Rn - �n J �n Y 'o H �o I �o ? p 8 Tp 9 �p 2 �p | �p } wq 5 �q - +r , Yr C �r
�r 2 �r s 5 s Js A [s 8 � � � t � v � 3 . F d M 7 � 1 j � � A � J ` � � O � r � � � � ^ N c " L - � + � u � � � x � � [ g � , p U T X � b $ h P Y e Z � � i � � � \ � < � � : � � K � a G � > ; ) ! � s � � 4 C � � � � � � ( k D w H � ' � � S ] � | f _ q = � � ? � � 9 6 � � 0 % 2
o � Q � � � � { �
R � m � z � � � E I ~ � / n � l � 5 @ V B � � � � � � y � � � � � } & # * W �
Action to be performed:
Connection options:
General options:
Optional actions:
Options controlling the output:
Options:
Report bugs to <pgsql-bugs@postgresql.org>.
--create-slot create a new replication slot (for the slot's name see --slot)
--drop-slot drop the replication slot (for the slot's name see --slot)
--if-not-exists do not error if slot already exists when creating a slot
--start start streaming in a replication slot (for the slot's name see --slot)
--synchronous flush transaction log immediately after writing
--xlogdir=XLOGDIR location for the transaction log directory
%s [OPTION]...
-?, --help show this help, then exit
-D, --directory=DIR receive transaction log files into this directory
-D, --pgdata=DIRECTORY receive base backup into directory
-F --fsync-interval=SECS
time between fsyncs to the output file (default: %d)
-F, --format=p|t output format (plain (default), tar)
-I, --startpos=LSN where in an existing slot should the streaming start
-P, --plugin=PLUGIN use output plugin PLUGIN (default: %s)
-P, --progress show progress information
-R, --write-recovery-conf
write recovery.conf for replication
-S, --slot=SLOTNAME name of the logical replication slot
-S, --slot=SLOTNAME replication slot to use
-T, --tablespace-mapping=OLDDIR=NEWDIR
relocate tablespace in OLDDIR to NEWDIR
-U, --username=NAME connect as specified database user
-V, --version output version information, then exit
-W, --password force password prompt (should happen automatically)
-X, --xlog-method=fetch|stream
include required WAL files with specified method
-Z, --compress=0-9 compress tar output with given compression level
-c, --checkpoint=fast|spread
set fast or spread checkpointing
-d, --dbname=CONNSTR connection string
-d, --dbname=DBNAME database to connect to
-f, --file=FILE receive log into this file, - for stdout
-h, --host=HOSTNAME database server host or socket directory
-l, --label=LABEL set backup label
-n, --no-loop do not loop on connection lost
-o, --option=NAME[=VALUE]
pass option NAME with optional value VALUE to the
output plugin
-p, --port=PORT database server port number
-r, --max-rate=RATE maximum transfer rate to transfer data directory
(in kB/s, or use suffix "k" or "M")
-s, --status-interval=INTERVAL
time between status packets sent to server (in seconds)
-s, --status-interval=SECS
time between status packets sent to server (default: %d)
-v, --verbose output verbose messages
-w, --no-password never prompt for password
-x, --xlog include required WAL files in backup (fetch mode)
-z, --gzip compress tar output
%*s/%s kB (%d%%), %d/%d tablespace %*s/%s kB (%d%%), %d/%d tablespaces %*s/%s kB (%d%%), %d/%d tablespace (%s%-*.*s) %*s/%s kB (%d%%), %d/%d tablespaces (%s%-*.*s) %*s/%s kB (100%%), %d/%d tablespace %*s %*s/%s kB (100%%), %d/%d tablespaces %*s %s controls PostgreSQL logical decoding streams.
%s receives PostgreSQL streaming transaction logs.
%s takes a base backup of a running PostgreSQL server.
%s: %s needs a slot to be specified using --slot
%s: COPY stream ended before last file was finished
%s: WAL streaming can only be used in plain mode
%s: at least one action needs to be specified
%s: can only write single tablespace to stdout, database has %d
%s: cannot specify both --xlog and --xlog-method
%s: cannot use --create-slot or --drop-slot together with --startpos
%s: cannot use --create-slot or --start together with --drop-slot
%s: cannot use --create-slot together with --drop-slot
%s: checkpoint completed
%s: child %d died, expected %d
%s: child process did not exit normally
%s: child process exited with error %d
%s: child thread exited with error %u
%s: confirming write up to %X/%X, flush to %X/%X (slot %s)
%s: could not access directory "%s": %s
%s: could not clear search_path: %s %s: could not close compressed file "%s": %s
%s: could not close directory "%s": %s
%s: could not close file "%s": %s
%s: could not connect to server
%s: could not connect to server: %s %s: could not create archive status file "%s": %s
%s: could not create background process: %s
%s: could not create background thread: %s
%s: could not create compressed file "%s": %s
%s: could not create directory "%s": %s
%s: could not create file "%s": %s
%s: could not create pipe for background process: %s
%s: could not create replication slot "%s": got %d rows and %d fields, expected %d rows and %d fields
%s: could not create symbolic link "%s": %s
%s: could not create symbolic link from "%s" to "%s": %s
%s: could not create timeline history file "%s": %s
%s: could not determine seek position in file "%s": %s
%s: could not determine server setting for integer_datetimes
%s: could not drop replication slot "%s": got %d rows and %d fields, expected %d rows and %d fields
%s: could not establish database-specific replication connection
%s: could not fsync file "%s": %s
%s: could not fsync log file "%s": %s
%s: could not get COPY data stream: %s %s: could not get backup header: %s %s: could not get child thread exit status: %s
%s: could not get transaction log end position from server: %s %s: could not identify system: got %d rows and %d fields, expected %d rows and %d or more fields
%s: could not initiate base backup: %s %s: could not open directory "%s": %s
%s: could not open log file "%s": %s
%s: could not open timeline history file "%s": %s
%s: could not open transaction log file "%s": %s
%s: could not pad transaction log file "%s": %s
%s: could not parse next timeline's starting point "%s"
%s: could not parse start position "%s"
%s: could not parse transaction log location "%s"
%s: could not read COPY data: %s %s: could not read directory "%s": %s
%s: could not read from ready pipe: %s
%s: could not receive data from WAL stream: %s %s: could not rename file "%s" to "%s": %s
%s: could not rename file "%s": %s
%s: could not seek to beginning of transaction log file "%s": %s
%s: could not send command to background pipe: %s
%s: could not send copy-end packet: %s %s: could not send feedback packet: %s %s: could not send replication command "%s": %s %s: could not set compression level %d: %s
%s: could not set permissions on directory "%s": %s
%s: could not set permissions on file "%s": %s
%s: could not stat file "%s": %s
%s: could not stat transaction log file "%s": %s
%s: could not wait for child process: %s
%s: could not wait for child thread: %s
%s: could not write %u bytes to WAL file "%s": %s
%s: could not write %u bytes to log file "%s": %s
%s: could not write timeline history file "%s": %s
%s: could not write to compressed file "%s": %s
%s: could not write to file "%s": %s
%s: creating replication slot "%s"
%s: directory "%s" exists but is not empty
%s: directory name too long
%s: disconnected
%s: disconnected; waiting %d seconds to try again
%s: dropping replication slot "%s"
%s: final receive failed: %s %s: finished segment at %X/%X (timeline %u)
%s: got WAL data offset %08x, expected %08x
%s: incompatible server version %s
%s: incompatible server version %s; client does not support streaming from server versions newer than %s
%s: incompatible server version %s; client does not support streaming from server versions older than %s
%s: initiating base backup, waiting for checkpoint to complete
%s: integer_datetimes compile flag does not match server
%s: invalid --max-rate unit: "%s"
%s: invalid checkpoint argument "%s", must be "fast" or "spread"
%s: invalid compression level "%s"
%s: invalid fsync interval "%s"
%s: invalid output format "%s", must be "plain" or "tar"
%s: invalid port number "%s"
%s: invalid socket: %s %s: invalid status interval "%s"
%s: invalid tablespace mapping format "%s", must be "OLDDIR=NEWDIR"
%s: invalid tar block header size: %d
%s: invalid transfer rate "%s": %s
%s: invalid xlog-method option "%s", must be "fetch" or "stream"
%s: multiple "=" signs in tablespace mapping
%s: new directory is not an absolute path in tablespace mapping: %s
%s: no data returned from server
%s: no database specified
%s: no slot specified
%s: no target directory specified
%s: no target file specified
%s: no transaction log end position returned from server
%s: not renaming "%s%s", segment is not complete
%s: old directory is not an absolute path in tablespace mapping: %s
%s: only tar mode backups can be compressed
%s: out of memory
%s: received interrupt signal, exiting
%s: received transaction log record for offset %u with no file open
%s: replication connection using slot "%s" is unexpectedly database specific
%s: replication slots can only be used with WAL streaming
%s: replication stream was terminated before stop point
%s: segment file "%s" has incorrect size %d, skipping
%s: select() failed: %s
%s: server reported unexpected history file name for timeline %u: %s
%s: server reported unexpected next timeline %u, following timeline %u
%s: server returned unexpected response to BASE_BACKUP command; got %d rows and %d fields, expected %d rows and %d fields
%s: server stopped streaming timeline %u at %X/%X, but reported next timeline %u to begin at %X/%X
%s: starting background WAL receiver
%s: starting log streaming at %X/%X (slot %s)
%s: starting log streaming at %X/%X (timeline %u)
%s: starting timeline %u is not present in the server
%s: streaming header too small: %d
%s: streaming initiated
%s: switched to timeline %u at %X/%X
%s: symlinks are not supported on this platform
%s: system identifier does not match between base backup and streaming connection
%s: this build does not support compression
%s: too many command-line arguments (first is "%s")
%s: transaction log directory location can only be specified in plain mode
%s: transaction log directory location must be an absolute path
%s: transaction log file "%s" has %d bytes, should be 0 or %d
%s: transfer rate "%s" exceeds integer range
%s: transfer rate "%s" is not a valid value
%s: transfer rate "%s" is out of range
%s: transfer rate must be greater than zero
%s: unexpected response to TIMELINE_HISTORY command: got %d rows and %d fields, expected %d rows and %d fields
%s: unexpected result set after end-of-timeline: got %d rows and %d fields, expected %d rows and %d fields
%s: unexpected termination of replication stream: %s %s: unrecognized link indicator "%c"
%s: unrecognized streaming header: "%c"
%s: waiting for background process to finish streaming ...
Password: Try "%s --help" for more information.
Usage:
cannot duplicate null pointer (internal error)
out of memory
transaction log start point: %s on timeline %u
Project-Id-Version: pg_basebackup (PostgreSQL 9.6)
Report-Msgid-Bugs-To: pgsql-bugs@postgresql.org
POT-Creation-Date: 2020-05-15 23:53+0000
PO-Revision-Date: 2020-06-24 13:25-0400
Last-Translator: Carlos Chapi <carlos.chapi@2ndquadrant.com>
Language-Team: Spanish <pgsql-es-ayuda@postgresql.org>
Language: es
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Plural-Forms: nplurals=2; plural=(n != 1);
X-Generator: Poedit 1.8.7
Acciones a ejecutar:
Opciones de conexión:
Opciones generales:
Acciones optativas:
Opciones que controlan la salida:
Opciones:
Reporte errores a <pgsql-bugs@postgresql.org>.
--create-slot crea un nuevo slot de replicación (para el nombre, vea --slot)
--drop-slot elimina un slot de replicación (para el nombre, vea --slot)
--if-not-exists no abandonar si el slot ya existe al crear un slot
--start inicie flujo en un slot de replicación (para el nombre, vea --slot)
--synchronous sincroniza el registro transaccional inmediatamente
después de escribir
--xlogdir=DIR ubicación para los archivos del registro transaccional
%s [OPCIÓN]...
-?, --help mostrar esta ayuda, luego salir
-D, --directory=DIR recibe los archivos de transacción a este directorio
-D, --pgdata=DIRECTORIO recibir el respaldo base en directorio
-F, --fsync-interval=SEGS
tiempo entre fsyncs del archivo de salida (omisión: %d)
-F, --format=p|t formato de salida (plano (por omisión), tar)
-I, --startpos=LSN dónde en un slot existente debe empezar el flujo
-P, --plugin=PLUGIN use plugin de salida PLUGIN (omisión: %s)
-P, --progress mostrar información de progreso
-R, --write-recovery-conf
escribe recovery.conf para replicación
-S, --slot=NOMBRE-SLOT nombre del slot de replicación lógica
-S, --slot=NOMBRE slot de replicación a usar
-T, --tablespace-mapping=ANTIGUO=NUEVO
reubicar el directorio de tablespace de ANTIGUO a NUEVO
-U, --username=NOMBRE conectarse con el usuario especificado
-V, --version mostrar información de versión, luego salir
-W, --password forzar un prompt para la contraseña
(debería ser automático)
-X, --xlog-method=fetch|stream
incluye los archivos WAL necesarios,
en el modo especificado
-Z, --compress=0-9 comprimir salida tar con el nivel de compresión dado
-c, --checkpoint=fast|spread
utilizar checkpoint rápido o extendido
-d, --dbname=CONSTR cadena de conexión
-d, --dbname=BASE base de datos a la cual conectarse
-f, --file=ARCHIVO recibe el log en este archivo, - para stdout
-h, --host=ANFITRIÓN dirección del servidor o directorio del socket
-l, --label=ETIQUETA establecer etiqueta del respaldo
-n, --no-loop no entrar en bucle al perder la conexión
-o, --option=NOMBRE[=VALOR]
pasar opción NOMBRE con valor opcional VALOR al
plugin de salida
-p, --port=PORT número de port del servidor
-r, --max-rate=TASA máxima tasa a la que transferir el directorio de datos
(en kB/s, o use sufijos «k» o «M»)
-s, --status-interval=INTERVALO (segundos)
tiempo entre envíos de paquetes de estado al servidor
-s, --status-interval=SECS
tiempo entre envíos de paquetes de estado al servidor
(por omisión: %d)
-v, --verbose desplegar mensajes verbosos
-w, --no-password nunca pedir contraseña
-x, --xlog incluye los archivos WAL necesarios en el respaldo
(modo fetch)
-z, --gzip comprimir la salida de tar
%*s/%s kB (%d%%), %d/%d tablespace %*s/%s kB (%d%%), %d/%d tablespaces %*s/%s kB (%d%%), %d/%d tablespace (%s%-*.*s) %*s/%s kB (%d%%), %d/%d tablespaces (%s%-*.*s) %*s/%s kB (100%%), %d/%d tablespace %*s %*s/%s kB (100%%), %d/%d tablespaces %*s %s controla flujos de decodificación lógica de PostgreSQL.
%s recibe flujos del registro transaccional de PostgreSQL.
%s obtiene un respaldo base a partir de un servidor PostgreSQL en ejecución.
%s: la opcón %s necesita que se especifique un slot con --slot
%s: el flujo COPY terminó antes que el último archivo estuviera completo
%s: el flujo de WAL sólo puede usar en modo «plain»
%s: debe especificarse al menos una operación
%s: sólo se puede escribir un tablespace a stdout, la base de datos tiene %d
%s: no se puede tanto --xlog como --xlog-method
%s: no puede usarse --create-slot o --drop-slot junto con --startpos
%s: no puede usarse --create-slot o --start junto con --drop-slot
%s: no puede usarse --create-slot junto con --drop-slot
%s: el checkpoint se ha completado
%s: el hijo %d murió, pero se esperaba al %d
%s: el proceso hijo no terminó normalmente
%s: el proceso hijo terminó con código de salida %d
%s: el hilo hijo terminó con error %u
%s: confirmando escritura hasta %X/%X, fsync hasta %X/%X (slot %s)
%s: no se pudo acceder al directorio «%s»: %s
%s: no se pudo limpiar search_path: %s %s: no se pudo cerrar el archivo comprimido «%s»: %s
%s: no se pudo cerrar el directorio «%s»: %s
%s: no se pudo cerrar el archivo «%s»: %s
%s: no se pudo conectar al servidor
%s: no se pudo conectar al servidor: %s %s: no se pudo crear el archivo de estado «%s»: %s
%s: no se pudo lanzar el proceso en segundo plano: %s
%s: no se pudo lanzar el hilo en segundo plano: %s
%s: no se pudo crear el archivo comprimido «%s»: %s
%s: no se pudo crear el directorio «%s»: %s
%s: no se pudo crear el archivo «%s»: %s
%s: no se pudo crear la tubería para el proceso en segundo plano: %s
%s: no se pudo create el slot de replicación «%s»: se obtuvieron %d filas y %d campos, se esperaban %d filas y %d campos
%s: no se pudo crear el enlace simbólico «%s»: %s
%s: no se pudo crear un enlace simbólico desde «%s» a «%s»: %s
%s: no se pudo crear el archivo de historia de timeline «%s»: %s
%s: no se pudo determinar la posición (seek) en el archivo «%s»: %s
%s: no se pudo determinar la opción integer_datetimes del servidor
%s: no se pudo eliminar el slot de replicación «%s»: se obtuvieron %d filas y %d campos, se esperaban %d filas y %d campos
%s: no se pudo establecer una conexión de replicación específica a una base de datos
%s: no se pudo sincronizar (fsync) el archivo «%s»: %s
%s: no se pudo sincronizar (fsync) el archivo de registro «%s»: %s
%s: no se pudo obtener un flujo de datos COPY: %s %s: no se pudo obtener la cabecera de respaldo: %s %s: no se pudo obtener la cabecera de respaldo: %s
%s: no se pudo obtener la posición final del registro transaccional del servidor: %s %s: no se pudo identificar al sistema: se obtuvieron %d filas y %d campos, se esperaban %d filas y %d o más campos
%s: no se pudo iniciar el respaldo base: %s %s: no se pudo abrir el directorio «%s»: %s
%s: no se pudo abrir archivo de log «%s»: %s
%s: no se pudo abrir el archivo de historia de timeline «%s»: %s
%s: no se pudo abrir el archivo de transacción «%s»: %s
%s: no se pudo rellenar (pad) el archivo de transacción «%s»: %s
%s: no se pudo interpretar el punto de inicio del siguiente timeline «%s»
%s: no se pudo interpretar la posición de inicio «%s»
%s: no se pudo interpretar la ubicación del registro transaccional «%s»
%s: no fue posible leer datos COPY: %s %s: no se pudo leer el directorio «%s»: %s
%s: no se pudo leer desde la tubería: %s
%s: no se pudo recibir datos desde el flujo de WAL: %s %s: no se pudo cambiar el nombre al archivo «%s» a «%s»: %s
%s: no se pudo cambiar el nombre al archivo «%s»: %s
%s: no se pudo posicionar (seek) al inicio del archivo de transacción «%s»: %s
%s: no se pudo enviar una orden a la tubería de segundo plano: %s
%s: no se pudo enviar el paquete copy-end: %s %s: no se pudo enviar el paquete de retroalimentación: %s %s: no se pudo ejecutar la orden de replicación «%s»: %s %s: no se pudo definir el nivel de compresión %d: %s
%s: no se pudo definir los permisos en el directorio «%s»: %s
%s: no se pudo definir los permisos al archivo «%s»: %s
%s: no se pudo hacer stat del archivo «%s»: %s
%s: no se pudo hacer stat del archivo de transacción «%s»: %s
%s: no se pudo esperar al proceso hijo: %s
%s: no se pudo esperar el hilo hijo: %s
%s: no se pudo escribir %u bytes al archivo WAL «%s»: %s
%s: no se pudo escribir %u bytes al archivo de registro «%s»: %s
%s: no se pudo escribir al archivo de historia de timeline «%s»: %s
%s: no se pudo escribir al archivo comprimido «%s»: %s
%s: no se pudo escribir al archivo «%s»: %s
%s: creando el slot de replicación «%s»
%s: el directorio «%s» existe pero no está vacío
%s: nombre de directorio demasiado largo
%s: desconectado
%s: desconectado; esperando %d segundos para intentar nuevamente
%s: eliminando el slot de replicación «%s»
%s: la recepción final falló: %s %s: terminó el segmento en %X/%X (timeline %u)
%s: se obtuvo desplazamiento de datos WAL %08x, se esperaba %08x
%s: versión del servidor %s incompatible
%s: versión de servidor %s incompatible; el cliente no soporta flujos de servidores posteriores a %s
%s: versión de servidor %s incompatible; el cliente no soporta flujos de servidores anteriores a la versión %s
%s: iniciando el respaldo base, esperando que el checkpoint se complete
%s: la opción de compilación integer_datetimes no coincide con el servidor
%s: unidad de --max-rato no válida: «%s»
%s: argumento de checkpoint «%s» no válido, debe ser «fast» o «spread»
%s: valor de compresión «%s» no válido
%s: intervalo de fsync «%s» no válido
%s: formato de salida «%s» no válido, debe ser «plain» o «tar»
%s: número de puerto «%s» no válido
%s: el socket no es válido: %s %s: intervalo de estado «%s» no válido
%s: formato de mapeo de tablespace «%s» no válido, debe ser «ANTIGUO=NUEVO»
%s: tamaño de bloque de cabecera de tar no válido: %d
%s: tasa de transferencia «%s» no válida: %s
%s: opción de xlog-method «%s» no válida, debe ser «fetch» o «stream»
%s: múltiples signos «=» en mapeo de tablespace
%s: directorio nuevo no es una ruta absoluta en mapeo de tablespace: %s
%s: el servidor no retornó datos
%s: no se especificó una base de datos
%s: no se especificó slot
%s: no se especificó un directorio de salida
%s: no se especificó un archivo de destino
%s: el servidor no retornó la posición final del registro transaccional
%s: no se cambiará el nombre a «%s%s», el segmento no está completo
%s: directorio antiguo no es una ruta absoluta en mapeo de tablespace: %s
%s: sólo los respaldos de modo tar pueden ser comprimidos
%s: memoria agotada
%s: se recibió una señal de interrupción, saliendo
%s: se recibió un registro transaccional para el desplazamiento %u sin ningún archivo abierto
%s: la conexión de replicación usando el slot «%s» es inesperadamente específica a una base de datos
%s: los slots de replicación sólo pueden usarse con flujo de WAL
%s: el flujo de replicación terminó antes del punto de término
%s: el archivo de segmento «%s» tiene tamaño incorrecto %d, ignorando
%s: select() falló: %s
%s: el servidor reportó un nombre inesperado para el archivo de historia de timeline %u: %s
%s: el servidor reportó un timeline siguiente %u inesperado, a continuación del timeline %u
%s: el servidor envió una respuesta inesperada a la orden BASE_BACKUP; se obtuvieron %d filas y %d campos, se esperaban %d filas y %d campos
%s: el servidor paró la transmisión del timeline %u en %X/%X, pero reportó que el siguiente timeline %u comienza en %X/%X
%s: iniciando el receptor de WAL en segundo plano
%s: iniciando el flujo de log en %X/%X (slot %s)
%s: iniciando el flujo de log en %X/%X (timeline %u)
%s: el timeline de inicio %u no está presente en el servidor
%s: cabecera de flujo demasiado pequeña: %d
%s: flujo iniciado
%s: cambiado al timeline %u en %X/%X
%s: los enlaces simbólicos no están soportados en esta plataforma
%s: el identificador de sistema no coincide entre el respaldo base y la conexión de flujo
%s: esta instalación no soporta compresión
%s: demasiados argumentos en la línea de órdenes (el primero es «%s»)
%s: la ubicación del registro transaccional sólo puede especificarse en modo «plain»
%s: la ubicación del registro transaccional debe ser una ruta absoluta
%s: el archivo de transacción «%s» mide %d bytes, debería ser 0 o %d
%s: la tasa de transferencia «%s» excede el rango de enteros
%s: tasa de transferencia «%s» no es un valor válido
%s: la tasa de transferencia «%s» está fuera de rango
%s: tasa de transferencia debe ser mayor que cero
%s: respuesta inesperada a la orden TIMELINE_HISTORY: se obtuvieron %d filas y %d campos, se esperaban %d filas y %d campos
%s: respuesta inesperada después del fin-de-timeline: se obtuvieron %d filas y %d campos, se esperaban %d filas y %d campos
%s: término inesperado del flujo de replicación: %s %s: indicador de enlace «%c» no reconocido
%s: cabecera de flujo no reconocida: «%c»
%s: esperando que el proceso en segundo plano complete el flujo...
Contraseña: Use «%s --help» para obtener más información.
Empleo:
no se puede duplicar un puntero nulo (error interno)
memoria agotada
punto de inicio del registro transaccional: %s en el timeline %u
locale/es/LC_MESSAGES/ecpglib6-9.6.mo 0000644 00000007312 14751153421 0012547 0 ustar 00 �� ! $ / , � � � � ) ' - Q : 0 � $ � ( 9 L * c ; � > � 3 < = & z 1 � � + � ' @ % Y � , � � 2 0 ; / l � � / > G L f ' u : � I � 7 "
, Z
1 �
�
�
6 �
F % R l H � R / [ ? � ' � / � % #
I
& f
$ �
% �
8 �
% 1 7 3 i , �
! <DEFAULT> <empty> NULL SQL error %d on line %d SQL error: %s
connection "%s" does not exist on line %d could not connect to database "%s" on line %d could not convert boolean value: size mismatch, on line %d data read from server is not an array on line %d descriptor "%s" not found on line %d descriptor index out of range on line %d empty message text empty query on line %d error in transaction processing on line %d inserting an array of variables is not supported on line %d invalid input syntax for floating-point type: "%s", on line %d invalid input syntax for type int: "%s", on line %d invalid input syntax for type unsigned int: "%s", on line %d invalid statement name "%s" on line %d invalid syntax for type boolean: "%s", on line %d no data found on line %d not connected to connection "%s" on line %d null value without indicator on line %d out of memory on line %d the connection to the server was lost too few arguments on line %d too many arguments on line %d unrecognized descriptor item "%s" on line %d unsupported type "%s" on line %d variable does not have a character type on line %d variable does not have a numeric type on line %d variable does not have an array type on line %d Project-Id-Version: ecpglib (PostgreSQL 9.6)
Report-Msgid-Bugs-To: pgsql-bugs@postgresql.org
POT-Creation-Date: 2020-05-15 23:49+0000
PO-Revision-Date: 2016-05-03 12:17-0300
Last-Translator: Emanuel Calvo Franco <postgres-arg@gmail.com>
Language-Team: PgSQL-es-Ayuda <pgsql-es-ayuda@postgresql.org>
Language: es
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
<POR OMISIÓN> <vacío> NULL error SQL %d en línea %d error SQL: %s
conexión «%s» no existe en línea %d no se pudo conectar a la base de datos «%s» en línea %d no se puede convertir el valor booleano: tamaño incorrecto, en línea %d el dato leído del servidor no es un array en línea %d descriptor «%s» no encontrado en línea %d índice de descriptor fuera de rango en línea %d mensaje de texto vacío consulta vacía en línea %d error en el procesamiento de transacción en línea %d la inserción de un array de variables no está soportado en línea %d sintaxis de entrada no válida para el tipo de coma flotante: «%s», en línea %d sintaxis de entrada no válida para el tipo entero: «%s», en línea %d sintaxis de entrada no válida para el tipo entero sin signo: «%s», en línea %d nombre sentencia no válida «%s» en línea %d sintaxis no válida para el tipo booleano: «%s», en línea %d no se encontraron datos en la línea %d no conectada a la conexión «%s» en línea %d valor nulo sin indicador en línea %d memoria agotada en línea %d se ha perdido la conexión al servidor muy pocos argumentos en la línea %d demasiados argumentos en la línea %d elemento de descriptor no reconocido «%s» en línea %d tipo no soportado «%s» en línea %d la variable no tiene un tipo textual en línea %d la variable no tiene un tipo numérico en línea %d la variable no tiene tipo array en línea %d locale/es/LC_MESSAGES/pg_rewind-9.6.mo 0000644 00000047632 14751153421 0013043 0 ustar 00 �� � $ � ,
�
- �
1 �
? K I C � ; � C 9 Y G � @ � O ( x � � � � � J � > I , � 6 � < � 1 ) ? [ = � = � 9 D Q 4 � 9 � 4 2 : @ m R � > @ G 1 h � � � � o � d Z - � 4 � & " I � c P � R 7 c � - � ; / Y ; � � � � # ? % ^ � $ � + � � $ L 8 , � 0 � " � ) , 0 ] $ { $ � # � ' � " 4 " R & u $ � � ( �
" + ' N v � � � 2 � ' 9 a / � - � � 6 � 3 ; H ) � � + � % � ! 3! ! Q! 3 s! 6 �! 1 �! " ' /" < W" _ �" �" # ! # F 9# �# �# �# 1 �# C �# " A$ . d$ # �$ > �$ 6 �$ 3 -% 6 a% 0 �% �% + �% & & 7& X& ! w& ( �& I �& $ ' ' 1' Y' - v' J �' = �' A -( 6 o( 5 �( 5 �( ! ) 7 4) / l) 6 �) 1 �) - * 9 3* � m* 0 , @ K, I �, M �, B $- < g- K �- ? �- J 0. A {. �. a �. ,/ H/ i/ �/ �/ �/ C �/ H 0 7 M0 @ �0 S �0 ? 1 J Z1 M �1 A �1 G 52 J }2 G �2 N 3 < _3 H �3 W �3 g =4 N �4 �4 ) �4 M (5 v5
�5 �5 �5 ~ �5 u O6 3 �6 E �6 . ?7 n7 � �7 f 8 h z8 s �8 4 W9 1 �9 $ �9 5 �9 ? : Y: p: " �: + �: ( �: 3 ; # <; * `; 2 �; - �; / �; [ < 7 x< ; �< * �< 4 = 6 L= ' �= 1 �= 2 �= ) > - :> ) h> & �> & �> + �> - ? * :? 2 e? , �? / �? 7 �? -@ ! N@ , p@ ! �@ ? �@ - �@ . -A * \A A �A ; �A " B > (B gB \ �B 1 �B C 0 5C * fC �C ) �C - �C 6 D ; ?D C {D ) �D / �D M E l gE �E �E # �E Q #F uF ' �F ( �F C �F T "G - wG 0 �G & �G J �G D HH ; �H 8 �H 7 I . :I = iI 9 �I - �I - J - =J 8 kJ d �J % K 3 /K % cK = �K h �K Q 0L P �L 5 �L H M J RM 2 �M U �M N &N P uN A �N E O K NO � & 5 � Y | � � � [ > r ! p � J } � � % < d U � 1 { y : � u . i F
f R 6 � b � 8 k I ( l _ q � � � A 9 � t # � � 0 $ 3 � � � ` P h � x � ~ ) � ]
C w L E ? g 2 a Q c s � / m @ � ; � S X v T + e M z ^ K � H N G 4 O j = � � Z ' o , W - � � D B V \ " * � 7 n �
Report bugs to <pgsql-bugs@postgresql.org>.
creating backup label and updating control file
--debug write a lot of debug messages
--source-pgdata=DIRECTORY source data directory to synchronize with
--source-server=CONNSTR source server to synchronize with
-?, --help show this help, then exit
-D, --target-pgdata=DIRECTORY existing data directory to modify
-P, --progress write progress messages
-V, --version output version information, then exit
-n, --dry-run stop before modifying anything
block %u
"%s" is a symbolic link, but symbolic links are not supported on this platform
"%s" is not a directory
"%s" is not a regular file
"%s" is not a symbolic link
%*s/%s kB (%d%%) copied %d: %X/%X - %X/%X
%s (%s)
%s resynchronizes a PostgreSQL cluster with another copy of the cluster.
%s: WARNING: cannot create restricted tokens on this platform
%s: could not allocate SIDs: error code %lu
%s: could not create restricted token: error code %lu
%s: could not get exit code from subprocess: error code %lu
%s: could not open process token: error code %lu
%s: could not re-execute with restricted token: error code %lu
%s: could not start process for command "%s": error code %lu
%s: no source specified (--source-pgdata or --source-server)
%s: no target data directory specified (--target-pgdata)
%s: only one of --source-pgdata or --source-server can be specified
%s: too many command-line arguments (first is "%s")
BKPBLOCK_HAS_DATA not set, but data length is %u at %X/%X BKPBLOCK_HAS_DATA set, but no data included at %X/%X BKPBLOCK_SAME_REL set but no previous rel at %X/%X BKPIMAGE_HAS_HOLE not set, but hole offset %u length %u at %X/%X BKPIMAGE_HAS_HOLE set, but hole offset %u length %u block image length %u at %X/%X BKPIMAGE_IS_COMPRESSED set, but block image length %u at %X/%X Done!
Expected a numeric timeline ID.
Expected a transaction log switchpoint location.
Failure, exiting
Options:
Source timeline history:
Target timeline history:
The program "initdb" is needed by %s but was
not found in the same directory as "%s".
Check your installation.
The program "initdb" was found by "%s"
but was not the same version as %s.
Check your installation.
Timeline IDs must be in increasing sequence.
Timeline IDs must be less than child timeline's ID.
Try "%s --help" for more information.
Usage:
%s [OPTION]...
WAL file is from different database system: WAL file database system identifier is %s, pg_control database system identifier is %s WAL file is from different database system: incorrect XLOG_BLCKSZ in page header WAL file is from different database system: incorrect XLOG_SEG_SIZE in page header WAL record modifies a relation, but record type is not recognized
lsn: %X/%X, rmgr: %s, info: %02X
You must run %s as the PostgreSQL superuser.
backup label buffer too small
cannot be executed by "root"
cannot duplicate null pointer (internal error)
clusters are not compatible with this version of pg_rewind
connected to server
contrecord is requested by %X/%X could not clear search_path: %s could not close directory "%s": %s
could not close file "%s": %s
could not close target file "%s": %s
could not connect to server: %s could not create directory "%s": %s
could not create symbolic link at "%s": %s
could not fetch file list: %s could not fetch remote file "%s": %s could not find common ancestor of the source and target cluster's timelines
could not find previous WAL record at %X/%X
could not find previous WAL record at %X/%X: %s
could not open directory "%s": %s
could not open file "%s" for reading: %s
could not open file "%s" for truncation: %s
could not open file "%s": %s
could not open source file "%s": %s
could not open target file "%s": %s
could not read WAL record at %X/%X
could not read WAL record at %X/%X: %s
could not read directory "%s": %s
could not read file "%s": %s
could not read from file "%s": %s
could not read symbolic link "%s": %s
could not remove directory "%s": %s
could not remove file "%s": %s
could not remove symbolic link "%s": %s
could not seek in file "%s": %s
could not seek in source file: %s
could not seek in target file "%s": %s
could not send COPY data: %s could not send end-of-COPY: %s could not send file list: %s could not send query: %s could not set libpq connection to single row mode
could not stat file "%s": %s
could not truncate file "%s" to %u: %s
could not write file "%s": %s
data file "%s" in source is not a regular file
error running query (%s) in source server: %s fetched file "%s", length %d
full_page_writes must be enabled in the source server
getting file chunks
incorrect resource manager data checksum in record at %X/%X invalid action (CREATE) for regular file
invalid block_id %u at %X/%X invalid compressed image at %X/%X, block %d invalid contrecord length %u at %X/%X invalid control file
invalid data in history file
invalid data in history file: %s
invalid info bits %04X in log segment %s, offset %u invalid magic number %04X in log segment %s, offset %u invalid record length at %X/%X: wanted %u, got %u invalid record offset at %X/%X invalid resource manager ID %u at %X/%X need to copy %lu MB (total source directory size is %lu MB)
neither BKPIMAGE_HAS_HOLE nor BKPIMAGE_IS_COMPRESSED set, but block image length is %u at %X/%X no rewind required
out of memory
out-of-order block_id %u at %X/%X out-of-sequence timeline ID %u (after %u) in log segment %s, offset %u reading WAL in target
reading source file list
reading target file list
received chunk for file "%s", offset %s, size %d
received null value for chunk for file "%s", file has been deleted
record length %u at %X/%X too long record with incorrect prev-link %X/%X at %X/%X record with invalid length at %X/%X rewinding from last common checkpoint at %X/%X on timeline %u
servers diverged at WAL position %X/%X on timeline %u
source and target cluster are on the same timeline
source and target clusters are from different systems
source data directory must be shut down cleanly
source file list is empty
source server must not be in recovery mode
symbolic link "%s" target is too long
sync of target directory failed
syncing target data directory
syntax error in history file: %s
target server must be shut down cleanly
target server needs to use either data checksums or "wal_log_hints = on"
there is no contrecord flag at %X/%X unexpected EOF while reading file "%s"
unexpected control file CRC
unexpected control file size %d, expected %d
unexpected data types in result set while fetching remote files: %u %u %u
unexpected null values in result while fetching remote files
unexpected page modification for directory or symbolic link "%s"
unexpected pageaddr %X/%X in log segment %s, offset %u unexpected result format while fetching remote files
unexpected result length while fetching remote files
unexpected result set from query
unexpected result set size while fetching remote files
unexpected result set while fetching file list
unexpected result set while fetching remote file "%s"
unexpected result while fetching remote files: %s unexpected result while sending file list: %s unrecognized result "%s" for current WAL insert location
Project-Id-Version: pg_rewind (PostgreSQL) 9.6
Report-Msgid-Bugs-To: pgsql-bugs@postgresql.org
POT-Creation-Date: 2020-05-15 23:54+0000
PO-Revision-Date: 2017-05-20 21:25-0400
Last-Translator: Carlos Chapi <carlos.chapi@2ndquadrant.com>
Language-Team: PgSQL Español <pgsql-es-ayuda@postgresql.org>
Language: es
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
X-Generator: Poedit 1.8.7
Reporte errores a <pgsql-bugs@postgresql.org>.
creando etiqueta de respaldo y actualizando archivo de control
--debug escribir muchos mensajes de depuración
--source-pgdata=DIRECTORIO directorio de datos de origen a sincronizar
--source-server=CONN servidor de origen a sincronizar
-?, --help mostrar esta ayuda y salir
-D, --target-pgdata=DIRECTORIO directorio de datos existente a modificar
-P, --progress escribir mensajes de progreso
-V, --version mostrar información de versión y salir
-n, --dry-run detener antes de modificar nada
bloque %u
«%s» es un link simbólico, pero los links simbólicos no están soportados en esta plataforma
«%s» no es un directorio
«%s» no es un archivo regular
«%s» no es un link simbólico
%*s/%s kB (%d%%) copiados %d: %X/%X - %X/%X
%s (%s)
%s resincroniza un cluster PostgreSQL con otra copia del cluster.
%s: ATENCIÓN: no se pueden crear tokens restrigidos en esta plataforma
%s: no se pudo emplazar los SIDs: código de error %lu
%s: no se pudo crear el token restringido: código de error %lu
%s: no se pudo obtener el código de salida del subproceso»: código de error %lu
%s: no se pudo abrir el token de proceso: código de error %lu
%s: no se pudo re-ejecutar con el token restringido: código de error %lu
%s: no se pudo iniciar el proceso para la orden «%s»: código de error %lu
%s: no se especificó origen (--source-pgdata o --source-server)
%s: no se especificó directorio de datos de destino (--target-pgdata)
%s: sólo uno de --source-pgdata o --source-server puede ser especificado
%s: demasiados argumentos de línea de órdenes (el primero es «%s»)
BKPBLOCK_HAS_DATA no está definido, pero el largo de los datos es %u en %X/%X BKPBLOCK_HAS_DATA está definido, pero no hay datos en %X/%X BKPBLOCK_SAME_REL está definido, pero no hay «rel» anterior en %X/%X BKPIMAGE_HAS_HOLE no está definido, pero posición del agujero es %u largo %u en %X/%X BKPIMAGE_HAS_HOLE está definido, pero posición del agujero es %u largo %u largo de imagen %u en %X/%X BKPIMAGE_IS_COMPRESSED definido, pero largo de imagen de bloque es %u en %X/%X ¡Listo!
Se esperaba un ID de timeline numérico.
Se esperaba una ubicación de punto de cambio del registro de transacciones.
Falló, saliendo
Opciones:
Historia de timeline origen:
Historia de timeline destino:
%s necesita el programa «initdb», pero no pudo ser encontrado en el mismo
directorio que «%s».
Verifique su instalación.
El programa «initdb» fue encontrado por «%s», pero no es
de la misma versión que %s.
Verifique su instalación.
IDs de timeline debe estar en secuencia creciente.
IDs de timeline deben ser menores que los ID de timelines «hijos».
Pruebe «%s --help» para mayor información.
Empleo:
%s [OPCION]...
archivo WAL es de un sistema de bases de datos distinto: identificador de sistema en archivo WAL es %s, identificador en pg_control es %s archivo WAL es de un sistema de bases de datos distinto: XLOG_BLCKSZ incorrecto en cabecera de paǵina archivo WAL es de un sistema de bases de datos distinto: XLOG_SEG_SIZE incorrecto en cabecera de página el registro WAL modifica una relación, pero el tipo de registro no es reconocido
lsn: %X/%X, rmgr: %s, info: %02X
Debe ejecutar %s con el superusuario de PostgreSQL.
el búfer del backup label es demasiado pequeño
no puede ser ejecutado por «root»
no se puede duplicar un puntero nulo (error interno)
los clusters no son compatibles con esta versión de pg_rewind
conectado al servidor
contrecord solicitado por %X/%X no se pudo limpiar search_path: %s no se pudo cerrar el directorio «%s»: %s
no se pudo cerrar el archivo «%s»: %s
no se pudo cerrar el archivo de destino «%s»: %s
no se pudo conectar al servidor: %s no se pudo crear el directorio «%s»: %s
no se pudo crear el link simbólico en «%s»: %s
no se pudo obtener el listado de archivos: %s no se pudo obtener el archivo remoto «%s»: %s no se pudo encontrar un ancestro común en el timeline de los clusters de origen y destino
no se pudo encontrar el registro WAL anterior en %X/%X
no se pudo encontrar el registro WAL anterior en %X/%X: %s
no se pudo abrir el directorio «%s»: %s
no se pudo abrir el archivo «%s» para lectura: %s
no se pudo abrir el archivo «%s» para truncarlo: %s
no se pudo abrir el archivo «%s»: %s
no se pudo abrir el archivo de origen «%s»: %s
no se pudo abrir el archivo de destino «%s»: %s
no se pudo leer el registro WAL en %X/%X
no se pudo leer el registro WAL en %X/%X: %s
no se pudo leer el directorio «%s»: %s
no se pudo leer el archivo «%s»: %s
no se pudo leer el archivo «%s»: %s
no se pudo leer link simbólico «%s»: %s
no se pudo eliminar el directorio «%s»: %s
no se pudo eliminar el archivo «%s»: %s
no se pudo eliminar el link simbólico «%s»: %s
no se pudo posicionar en archivo «%s»: %s
no se pudo posicionar en archivo de origen: %s
no se pudo posicionar en archivo de destino «%s»: %s
no se pudo enviar datos COPY: %s no se pudo enviar fin-de-COPY: %s no se pudo enviar el listado de archivos: %s no se pudo enviar la consulta: %s no se pudo establecer la coneción libpq a modo «single row»
no se pudo hacer stat del archivo «%s»: %s
no se pudo truncar el archivo «%s» a %u: %s
no se pudo escribir el archivo «%s»: %s
el archivo de datos «%s» en el origen no es un archivo regular
error ejecutando consulta (%s) en el servidor de origen: %s obtenido archivo «%s», largo %d
full_page_writes debe estar activado en el servidor de origen
obteniendo trozos de archivos
suma de verificación de los datos del gestor de recursos incorrecta en el registro en %X/%X acción no válida (CREATE) para archivo regular
block_id %u no válido en %X/%X imagen comprimida no válida en %X/%X, bloque %d largo de contrecord %u no válido en %X/%X archivo de control no válido
datos no válidos en archivo de historia
datos no válidos en archivo de historia: %s
info bits %04X no válidos en archivo %s, posición %u número mágico %04X no válido en archivo %s, posición %u largo de registro no válido en %X/%X: se esperaba %u, se obtuvo %u posición de registro no válida en %X/%X ID de gestor de recursos %u no válido en %X/%X se necesitan copiar %lu MB (tamaño total de directorio de origen es %lu MB)
ni BKPIMAGE_HAS_HOLE ni BKPIMAGE_IS_COMPRESSED está definido, pero largo de imagen de bloque es %u en %X/%X no se requiere rebobinar
memoria agotada
block_id %u fuera de orden en %X/%X ID de timeline %u fuera de secuencia (después de %u) en archivo %s, posición %u leyendo WAL en destino
leyendo la lista de archivos de origen
leyendo la lista de archivos de destino
recibido un trozo para el archivo «%s», posición %s, tamaño %d
recibido un valor NULL para un trozo del archivo «%s», el archivo ha sido borrado
largo de registro %u en %X/%X demasiado largo registro con prev-link %X/%X incorrecto en %X/%X registro con largo no válido en %X/%X rebobinando desde el último checkpoint común en %X/%X en el timeline %u
servidores divergieron en la posición de WAL %X/%X del timeline %u
el cluster de origen y destino están en el mismo timeline
clusters de origen y destino son de sistemas diferentes
el directorio de origen debe estar apagado limpiamente
el listado de archivos de origen está vacío
el servidor de origen no debe estar en modo de recuperación
el destino del link simbólico «%s» es demasiado largo
falló sincronización de directorio destino
sincronizando directorio de datos de destino
error de sintaxis en archivo de historia: %s
el directorio de destino debe estar apagado limpiamente
el servidor de destino necesita tener sumas de verificación de datos o «wal_log_hints» activados
no hay bandera de contrecord en %X/%X EOF inesperado mientras se leía el archivo «%s»
CRC de archivo de control inesperado
tamaño del archivo de control %d inesperado, se esperaba %d
tipos de dato inesperados en el conjunto de resultados mientras se obtenían archivos remotos: %u %u %u
valores nulos inesperados en el resultado mientras se obtenían archivos remotos
modificación de página inesperada para el directorio o link simbólico «%s»
pageaddr %X/%X inesperado en archivo %s, posición %u formato de resultados inesperado mientras se obtenían archivos remotos
largo del resultado inesperado mientras se obtenían los archivos remotos
conjunto de resultados inesperados de la consulta
tamaño del conjunto de resultados inesperado mientras se obtenían archivos remotos
conjunto de resultados inesperado mientras se obtenía el listado de archivos
conjunto de resultados inesperado mientras se obtenía el archivo remoto «%s»
resultados inesperados mientras se obtenían archivos remotos: %s resultados inesperados mientras se enviaba el listado de archivos: %s resultado «%s» no reconocido para la ubicación de inserción WAL actual
locale/es/LC_MESSAGES/initdb-9.6.mo 0000644 00000060105 14751153421 0012324 0 ustar 00 �� � 4 � L
�
R �
: E - V g � ` � � M W W h � A � 5 J ? � 6 � P � C . : r Q � 5 � ] 5 4 � B � H G T > � 4 � 9 3 J ? ~ / � - � > y [ ( � # � , " - O 7 } ( � 6 � , ' B 5 j F � " � <
& G - n - � ! � 1 � ? & ^ / � = � ! � " 6 8 + o � 0 � ; � $ / D & t � $ � ~ � 1 ] < � � G � 3 2 8 f ( � J � � � � C ! - S! 8 �! ! �! , �! " J !" 0 l" 4 �" A �" @ # R U# K �# " �# ! $ � 9$ d �$ $% 5% � T% [ �% R 4& K �& % �& �& ' 0' ; H' ; �' � �' @ Q( ; �( �( u �) q U* f �* s .+ & �+ �+ ) �+ t �+ / p, �, & �, 0 �, . - ) 6- ) `- �- �- & �- # �- �- $ . ( D. + m. " �. �. " �. ! �. , / $ I/ * n/ % �/ ! �/ �/ �/ 0 0 J0 ^0 b0 q0 - �0 �0 & �0 % �0 1 3 <1 p1 �1 ( �1 � �1 V q3 �3 �3 �3 0 �3 ~ 04 � �4 � 05 � �5 � �6 H 7 y M8 5 �8 P �8 N9 7 k9 z �9 R : D q: N �: E ; n K; @ �; D �; M @< p �< ? �< P ?= ; �= 7 �= K > 7 P> 4 �> H �> � ? 0 �? - �? 7 @ 2 >@ > q@ . �@ @ �@ 5 A , VA \ �A u �A 9 VB S �B . �B 8 C : LC + �C ? �C J �C - >D ? lD M �D 1 �D . ,E D [E ) �E �E = �E Q )F / {F C �F D �F 4G / UG � �G D H I XH ; �H S �H T 2I R �I H �I V #J � zJ 5K 2 JK i }K 2 �K O L - jL A �L �L b �L D UM G �M ` �M I CN � �N w O G �O D �O � P � �P kQ / �Q � �Q l AR D �R H �R : <S wS �S # �S < �S B T � [T F �T C >U G �U � �V } SW w �W x IX 3 �X �X . �X � .Y 5 �Y �Y 1 Z 5 6Z 5 lZ / �Z / �Z [ [ - 0[ + ^[ , �[ , �[ / �[ 3 \ * H\ ! s\ ) �\ + �\ 8 �\ / $] 9 T] ( �] ' �] �] �] 7 ^ Q^ q^ x^ �^ . �^ , �^ 0 �^ / (_ / X_ A �_ $ �_ �_ @ ` � � 5 ( � ] � � J l 6 H X � � K z � � � r I � � { � N d R V o | ~ � � . y U } � m � ` G = * f / $ � > _ � # A � t C 8 Y 0 T , � % + v L 3 � 2 n � � h B j E ? 9 ) ! & � � � q � � D S Z g
e ; ' ^ " F x c � w P [ s � @ i �
1 - \ � u : k � 4 W Q 7 O � < M p a b �
If the data directory is not specified, the environment variable PGDATA
is used.
Less commonly used options:
Options:
Other options:
Report bugs to <pgsql-bugs@postgresql.org>.
Success. You can now start the database server using:
%s%s%spg_ctl%s -D %s%s%s -l logfile start
Sync to disk skipped.
The data directory might become corrupt if the operating system crashes.
WARNING: enabling "trust" authentication for local connections
You can change this by editing pg_hba.conf or using the option -A, or
--auth-local and --auth-host, the next time you run initdb.
--auth-host=METHOD default authentication method for local TCP/IP connections
--auth-local=METHOD default authentication method for local-socket connections
--lc-collate=, --lc-ctype=, --lc-messages=LOCALE
--lc-monetary=, --lc-numeric=, --lc-time=LOCALE
set default locale in the respective category for
new databases (default taken from environment)
--locale=LOCALE set default locale for new databases
--no-locale equivalent to --locale=C
--pwfile=FILE read password for the new superuser from file
%s [OPTION]... [DATADIR]
-?, --help show this help, then exit
-A, --auth=METHOD default authentication method for local connections
-E, --encoding=ENCODING set default encoding for new databases
-L DIRECTORY where to find the input files
-N, --nosync do not wait for changes to be written safely to disk
-S, --sync-only only sync data directory
-T, --text-search-config=CFG
default text search configuration
-U, --username=NAME database superuser name
-V, --version output version information, then exit
-W, --pwprompt prompt for a password for the new superuser
-X, --xlogdir=XLOGDIR location for the transaction log directory
-d, --debug generate lots of debugging output
-k, --data-checksums use data page checksums
-n, --noclean do not clean up after errors
-s, --show show internal settings
[-D, --pgdata=]DATADIR location for this database cluster
%s initializes a PostgreSQL database cluster.
%s: "%s" is not a valid server encoding name
%s: WARNING: cannot create restricted tokens on this platform
%s: cannot be run as root
Please log in (using, e.g., "su") as the (unprivileged) user that will
own the server process.
%s: could not access directory "%s": %s
%s: could not access file "%s": %s
%s: could not allocate SIDs: error code %lu
%s: could not change permissions of "%s": %s
%s: could not change permissions of directory "%s": %s
%s: could not create directory "%s": %s
%s: could not create restricted token: error code %lu
%s: could not create symbolic link "%s": %s
%s: could not execute command "%s": %s
%s: could not find suitable encoding for locale "%s"
%s: could not find suitable text search configuration for locale "%s"
%s: could not fsync file "%s": %s
%s: could not get exit code from subprocess: error code %lu
%s: could not open directory "%s": %s
%s: could not open file "%s" for reading: %s
%s: could not open file "%s" for writing: %s
%s: could not open file "%s": %s
%s: could not open process token: error code %lu
%s: could not re-execute with restricted token: error code %lu
%s: could not read directory "%s": %s
%s: could not read password from file "%s": %s
%s: could not start process for command "%s": error code %lu
%s: could not stat file "%s": %s
%s: could not write file "%s": %s
%s: data directory "%s" not removed at user's request
%s: directory "%s" exists but is not empty
%s: encoding mismatch
%s: failed to remove contents of data directory
%s: failed to remove contents of transaction log directory
%s: failed to remove data directory
%s: failed to remove transaction log directory
%s: failed to restore old locale "%s"
%s: file "%s" does not exist
%s: file "%s" is not a regular file
%s: input file "%s" does not belong to PostgreSQL %s
Check your installation or specify the correct path using the option -L.
%s: input file location must be an absolute path
%s: invalid authentication method "%s" for "%s" connections
%s: invalid locale name "%s"
%s: invalid locale settings; check LANG and LC_* environment variables
%s: locale "%s" requires unsupported encoding "%s"
%s: locale name has non-ASCII characters, skipped: "%s"
%s: locale name too long, skipped: "%s"
%s: must specify a password for the superuser to enable %s authentication
%s: no data directory specified
You must identify the directory where the data for this database system
will reside. Do this with either the invocation option -D or the
environment variable PGDATA.
%s: out of memory
%s: password file "%s" is empty
%s: password prompt and password file cannot be specified together
%s: removing contents of data directory "%s"
%s: removing contents of transaction log directory "%s"
%s: removing data directory "%s"
%s: removing transaction log directory "%s"
%s: setlocale() failed
%s: superuser name "%s" is disallowed; role names cannot begin with "pg_"
%s: symlinks are not supported on this platform
%s: too many command-line arguments (first is "%s")
%s: transaction log directory "%s" not removed at user's request
%s: transaction log directory location must be an absolute path
%s: warning: specified text search configuration "%s" might not match locale "%s"
%s: warning: suitable text search configuration for locale "%s" is unknown
Data page checksums are disabled.
Data page checksums are enabled.
Encoding "%s" implied by locale is not allowed as a server-side encoding.
The default database encoding will be set to "%s" instead.
Encoding "%s" is not allowed as a server-side encoding.
Rerun %s with a different locale selection.
Enter it again: Enter new superuser password: If you want to create a new database system, either remove or empty
the directory "%s" or run %s
with an argument other than "%s".
If you want to store the transaction log there, either
remove or empty the directory "%s".
It contains a dot-prefixed/invisible file, perhaps due to it being a mount point.
It contains a lost+found directory, perhaps due to it being a mount point.
No usable system locales were found.
Passwords didn't match.
Rerun %s with the -E option.
Running in debug mode.
Running in noclean mode. Mistakes will not be cleaned up.
The database cluster will be initialized with locale "%s".
The database cluster will be initialized with locales
COLLATE: %s
CTYPE: %s
MESSAGES: %s
MONETARY: %s
NUMERIC: %s
TIME: %s
The default database encoding has accordingly been set to "%s".
The default text search configuration will be set to "%s".
The encoding you selected (%s) and the encoding that the
selected locale uses (%s) do not match. This would lead to
misbehavior in various character string processing functions.
Rerun %s and either do not specify an encoding explicitly,
or choose a matching combination.
The files belonging to this database system will be owned by user "%s".
This user must also own the server process.
The program "postgres" is needed by %s but was not found in the
same directory as "%s".
Check your installation.
The program "postgres" was found by "%s"
but was not the same version as %s.
Check your installation.
This might mean you have a corrupted installation or identified
the wrong directory with the invocation option -L.
Try "%s --help" for more information.
Usage:
Use the option "--debug" to see details.
Using a mount point directly as the data directory is not recommended.
Create a subdirectory under the mount point.
cannot duplicate null pointer (internal error)
caught signal
child process exited with exit code %d child process exited with unrecognized status %d child process was terminated by exception 0x%X child process was terminated by signal %d child process was terminated by signal %s command not executable command not found could not change directory to "%s": %s could not close directory "%s": %s
could not find a "%s" to execute could not get junction for "%s": %s
could not identify current directory: %s could not look up effective user ID %ld: %s could not open directory "%s": %s
could not read binary "%s" could not read directory "%s": %s
could not read symbolic link "%s" could not remove file or directory "%s": %s
could not set junction for "%s": %s
could not stat file or directory "%s": %s
could not write to child process: %s
creating configuration files ... creating directory %s ... creating subdirectories ... fixing permissions on existing directory %s ... invalid binary "%s" ok
out of memory
pclose failed: %s performing post-bootstrap initialization ... running bootstrap script ... selecting default max_connections ... selecting default shared_buffers ... selecting default timezone ... selecting dynamic shared memory implementation ... syncing data to disk ... user does not exist user name lookup failure: error code %lu Project-Id-Version: initdb (PostgreSQL 9.6)
Report-Msgid-Bugs-To: pgsql-bugs@postgresql.org
POT-Creation-Date: 2020-05-15 23:53+0000
PO-Revision-Date: 2019-09-29 23:05-0300
Last-Translator: Carlos Chapi <carlos.chapi@2ndquadrant.com>
Language-Team: PgSQL-es-Ayuda <pgsql-es-ayuda@postgresql.org>
Language: es
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
X-Generator: Poedit 1.8.7
Si el directorio de datos no es especificado, se usa la variable de
ambiente PGDATA.
Opciones menos usadas:
Opciones:
Otras opciones:
Reporte errores a <pgsql-bugs@postgresql.org>.
Completado. Ahora puede iniciar el servidor de bases de datos usando:
%s%s%spg_ctl%s -D %s%s%s -l archivo_de_log start
La sincronización a disco se ha omitido.
El directorio de datos podría corromperse si el sistema operativo sufre
una caída.
ATENCIÓN: activando autentificación «trust» para conexiones locales.
Puede cambiar esto editando pg_hba.conf o usando el parámetro -A,
o --auth-local y --auth-host la próxima vez que ejecute initdb.
--auth-host=MÉTODO método de autentificación por omisión para
conexiones locales TCP/IP
--auth-local=MÉTODO método de autentificación por omisión para
conexiones de socket local
--lc-collate=, --lc-ctype=, --lc-messages=LOCALE
--lc-monetary=, --lc-numeric=, --lc-time=LOCALE
inicializar usando esta configuración regional
en la categoría respectiva (el valor por omisión
es tomado de variables de ambiente)
--locale=LOCALE configuración regional por omisión para
nuevas bases de datos
--no-locale equivalente a --locale=C
--pwfile=ARCHIVO leer contraseña del nuevo superusuario del archivo
%s [OPCIÓN]... [DATADIR]
-?, --help mostrar esta ayuda y salir
-A, --auth=MÉTODO método de autentificación por omisión para
conexiones locales
-E, --encoding=CODIF codificación por omisión para nuevas bases de datos
-L DIRECTORIO donde encontrar los archivos de entrada
-N, --nosync no esperar que los cambios se sincronicen a disco
-S, --sync-only sólo sincronizar el directorio de datos
-T, --text-search-config=CONF
configuración de búsqueda en texto por omisión
-U, --username=USUARIO nombre del superusuario del cluster
-V, --version mostrar información de version y salir
-W, --pwprompt pedir una contraseña para el nuevo superusuario
-X, --xlogdir=XLOGDIR ubicación del directorio del registro de
transacciones
-d, --debug genera mucha salida de depuración
-k, --data-checksums activar sumas de verificación en páginas de datos
-n, --noclean no limpiar después de errores
-s, --show muestra variables internas
[-D, --pgdata=]DATADIR ubicación para este cluster de bases de datos
%s inicializa un cluster de base de datos PostgreSQL.
%s: «%s» no es un nombre válido de codificación
%s: ATENCIÓN: no se pueden crear tokens restrigidos en esta plataforma
%s: no se puede ejecutar como «root»
Por favor conéctese (usando, por ejemplo, «su») con un usuario no privilegiado,
quien ejecutará el proceso servidor.
%s: no se pudo acceder al directorio «%s»: %s
%s: no se pudo acceder al archivo «%s»: %s
%s: no se pudo emplazar los SIDs: código de error %lu
%s: no se pudo cambiar los permisos de «%s»: %s
%s: no se pudo cambiar los permisos del directorio «%s»: %s
%s: no se pudo crear el directorio «%s»: %s
%s: no se pudo crear el token restringido: código de error %lu
%s: no se pudo crear el enlace simbólico «%s»: %s
%s: no se pudo ejecutar la orden «%s»: %s
%s: no se pudo encontrar una codificación apropiada para
la configuración regional «%s»
%s: no se pudo encontrar una configuración para búsqueda en texto apropiada
para la configuración regional «%s»
%s: no se pudo sincronizar (fsync) el archivo «%s»: %s
%s: no se pudo obtener el código de salida del subproceso»: código de error %lu
%s: no se pudo abrir el directorio «%s»: %s
%s: no se pudo abrir el archivo «%s» para lectura: %s
%s: no se pudo abrir el archivo «%s» para escritura: %s
%s: no se pudo abrir el archivo «%s»: %s
%s: no se pudo abrir el token de proceso: código de error %lu
%s: no se pudo re-ejecutar con el token restringido: código de error %lu
%s: no se pudo leer el directorio «%s»: %s
%s: no se pudo leer la contraseña desde el archivo «%s»: %s
%s: no se pudo iniciar el proceso para la orden «%s»: código de error %lu
%s: no se pudo hacer stat del archivo «%s»: %s
%s: no se pudo escribir el archivo «%s»: %s
%s: directorio de datos «%s» no eliminado a petición del usuario
%s: el directorio «%s» no está vacío
%s: codificaciones no coinciden
%s: no se pudo eliminar el contenido del directorio de datos
%s: no se pudo eliminar el contenido del directorio de registro de transacciones
%s: no se pudo eliminar el directorio de datos
%s: no se pudo eliminar el directorio de registro de transacciones
%s: no se pudo restaurar la configuración regional anterior «%s»
%s: el archivo «%s» no existe
%s: el archivo «%s» no es un archivo regular
%s: el archivo de entrada «%s» no pertenece a PostgreSQL %s
Verifique su instalación o especifique la ruta correcta usando la opción -L.
%s: la ubicación de archivos de entrada debe ser una ruta absoluta
%s: método de autentificación «%s» no válido para conexiones «%s»
%s: nombre de configuración regional «%s» no es válido
%s: configuración regional inválida; revise las variables de entorno LANG y LC_*
%s: la configuración regional «%s» requiere la codificación no soportada «%s»
%s: nombre de configuración regional tiene caracteres no ASCII, saltando: «%s»
%s: nombre de configuración regional demasiado largo, saltando: «%s»
%s: debe especificar una contraseña al superusuario para activar
autentificación %s
%s: no se especificó un directorio de datos.
Debe especificar el directorio donde residirán los datos para este cluster.
Hágalo usando la opción -D o la variable de ambiente PGDATA.
%s: memoria agotada
%s: el archivo de contraseña «%s» está vacío
%s: la petición de contraseña y el archivo de contraseña no pueden
ser especificados simultáneamente
%s: eliminando el contenido del directorio «%s»
%s: eliminando el contenido del directorio de registro de transacciones «%s»
%s: eliminando el directorio de datos «%s»
%s: eliminando el directorio de registro de transacciones «%s»
%s: setlocale() falló
%s: nombre de superusuario «%s» no permitido; los nombres de rol no pueden comenzar con «pg_»
%s: los enlaces simbólicos no están soportados en esta plataforma
%s: demasiados argumentos de línea de órdenes (el primero es «%s»)
%s: el directorio de registro de transacciones «%s» no fue eliminado
a petición del usuario
%s: la ubicación de archivos de transacción debe ser una ruta absoluta
%s: atención: la configuración de búsqueda en texto «%s» especificada
podría no coincidir con la configuración regional «%s»
%s: atención: la configuración de búsqueda en texto apropiada para
la configuración regional «%s» es desconocida
Las sumas de verificación en páginas de datos han sido desactivadas.
Las sumas de verificación en páginas de datos han sido activadas.
La codificación «%s», implícita en la configuración regional,
no puede ser usada como codificación del lado del servidor.
La codificación por omisión será «%s».
La codificación «%s» no puede ser usada como codificación del lado
del servidor.
Ejecute %s nuevamente con una selección de configuración regional diferente.
Ingrésela nuevamente: Ingrese la nueva contraseña del superusuario: Si quiere crear un nuevo cluster de bases de datos, elimine o vacíe
el directorio «%s», o ejecute %s
con un argumento distinto de «%s».
Si quiere almacenar el directorio de registro de transacciones ahí,
elimine o vacíe el directorio «%s».
Contiene un archivo invisible, quizás por ser un punto de montaje.
Contiene un directorio lost+found, quizás por ser un punto de montaje.
No se encontraron configuraciones regionales utilizables.
Las constraseñas no coinciden.
Ejecute %s con la opción -E.
Ejecutando en modo de depuración.
Ejecutando en modo sucio. Los errores no serán limpiados.
El cluster será inicializado con configuración regional «%s».
El cluster será inicializado con las configuraciones regionales
COLLATE: %s
CTYPE: %s
MESSAGES: %s
MONETARY: %s
NUMERIC: %s
TIME: %s
La codificación por omisión ha sido por lo tanto definida a «%s».
La configuración de búsqueda en texto ha sido definida a «%s».
La codificación que seleccionó (%s) y la codificación de la configuración
regional elegida (%s) no coinciden. Esto llevaría a comportamientos
erráticos en ciertas funciones de procesamiento de cadenas de caracteres.
Ejecute %s nuevamente y no especifique una codificación, o bien especifique
una combinación adecuada.
Los archivos de este cluster serán de propiedad del usuario «%s».
Este usuario también debe ser quien ejecute el proceso servidor.
%s necesita el programa «postgres», pero no pudo encontrarlo en el mismo
directorio que «%s».
Verifique su instalación.
El programa «postgres» fue encontrado por %s, pero no es
de la misma versión que «%s».
Verifique su instalación.
Esto puede significar que tiene una instalación corrupta o ha
identificado el directorio equivocado con la opción -L.
Use «%s --help» para obtener mayor información.
Empleo:
Use la opción «--debug» para ver detalles.
Usar un punto de montaje directamente como directorio de datos no es
recomendado. Cree un subdirectorio bajo el punto de montaje.
no se puede duplicar un puntero nulo (error interno)
se ha capturado una señal
el proceso hijo terminó con código de salida %d el proceso hijo terminó con código no reconocido %d el proceso hijo fue terminado por una excepción 0x%X el proceso hijo fue terminado por una señal %d el proceso hijo fue terminado por una señal %s la orden no es ejecutable orden no encontrada no se pudo cambiar el directorio a «%s»: %s no se pudo cerrar el directorio «%s»: %s
no se pudo encontrar un «%s» para ejecutar no se pudo obtener junction para «%s»: %s
no se pudo identificar el directorio actual: %s no se pudo buscar el ID de usuario efectivo %ld: %s no se pudo abrir el directorio «%s»: %s
no se pudo leer el binario «%s» no se pudo leer el directorio «%s»: %s
no se pudo leer el enlace simbólico «%s» no se pudo borrar el archivo o el directorio «%s»: %s
no se pudo definir un junction para «%s»: %s
no se pudo hacer stat al archivo o directorio «%s»: %s
no se pudo escribir al proceso hijo: %s
creando archivos de configuración ... creando el directorio %s ... creando subdirectorios ... corrigiendo permisos en el directorio existente %s ... el binario «%s» no es válido hecho
memoria agotada
pclose falló: %s realizando inicialización post-bootstrap ... ejecutando script de inicio (bootstrap) ... seleccionando el valor para max_connections ... seleccionando el valor para shared_buffers ... seleccionando el huso horario por omisión ... seleccionando implementación de memoria compartida dinámica ... sincronizando los datos a disco ... el usuario no existe fallo en la búsqueda de nombre de usuario: código de error %lu locale/es/LC_MESSAGES/ecpg-9.6.mo 0000644 00000035201 14751153421 0011770 0 ustar 00 �� { � � � h
~ i
- �
0 + G g s � 4 � 7 0 s h . � G
4 S
) �
w �
4 * _ @ r = � , � ! @ , ^ 1 � * � - � 1 ' H & p + � " � # �
) = < z � & � < � ! & - 0 + ^ " � � , � � * 3 " ^ ' � � � ! � � ! 5 J 3 k / � ' � ) � * ! 5 L I � , � / � * ) T T ' � � � 1 - K , y , � 5 � ) % ? O 8 � � � _ 0 y 5 � � A � L 7 + �
� 6 � ' � # A ( N 4 w ) � � / � # < $ ] � " � , � � ' " J i $ � D � + � ? 0 Z � 8 � � & F � g � ! 0 �! 9 �! 0 " p B" �" A �" A # W# 7 �# E $ G U$ . �$ � �$ L {% �% M �% F .& 9 u& + �& , �& D ' ? M' 8 �' ; �' ? ( 5 B( 4 x( 9 �( % �( )
) 7) 2 ?) R r)
�) �) 7 �) M '* & u* �* 6 �* < �* 0 + M+ . h+ " �+ �+ 7 �+ 8 , 4 J, , ( �, 0 �, & �, / - N- ' c- 3 �- 2 �- ( �- : . 6 V. C �. X �. D */ 3 o/ 1 �/ R �/ 8 (0 a0 {0 �0 �0 �0 2 �0 1 1 1 N1 1 �1 �1 2 �1 N 2 C Q2 � �2 ,3 > K3 J �3 �3 O �3 a ;4 0 �4 �4 B �4 . !5 - P5 ~5 + �5 A �5 . �5 -6 = N6 �6 , �6 2 �6 7 , *7 5 W7 �7 # �7 ' �7 - �7 ' 8 * H8 P s8 9 �8 K �8 5 J9 # �9 = �9 ! �9 % : , *: ) W: j 4 f g ? ^ l x
T ( 9 u 8 _ L t I d \ % ) < i = ' Q N & : M v , 7 B . z ; S n # > P " H r ] [ ! * s Z 6 G A O - X 2 q 3 W w 1 k + U e Y o K p 0 a J 5 { h c m E C @ V F D y R / ` $
b
If no output file is specified, the name is formed by adding .c to the
input file name, after stripping off .pgc if present.
Report bugs to <pgsql-bugs@postgresql.org>.
--regression run in regression testing mode
-?, --help show this help, then exit
-C MODE set compatibility mode; MODE can be one of
"INFORMIX", "INFORMIX_SE"
-D SYMBOL define SYMBOL
-I DIRECTORY search DIRECTORY for include files
-V, --version output version information, then exit
-c automatically generate C code from embedded SQL code;
this affects EXEC SQL TYPE
-d generate parser debug output
-h parse a header file, this option includes option "-c"
-i parse system include files as well
-o OUTFILE write result to OUTFILE
-r OPTION specify run-time behavior; OPTION can be:
"no_indicator", "prepare", "questionmarks"
-t turn on autocommit of transactions
%s at or near "%s" %s is the PostgreSQL embedded SQL preprocessor for C programs.
%s, the PostgreSQL embedded C preprocessor, version %d.%d.%d
%s: could not locate my own executable path
%s: could not open file "%s": %s
%s: no input files specified
%s: parser debug support (-d) not available
AT option not allowed in CLOSE DATABASE statement AT option not allowed in CONNECT statement AT option not allowed in DISCONNECT statement AT option not allowed in SET CONNECTION statement AT option not allowed in TYPE statement AT option not allowed in VAR statement AT option not allowed in WHENEVER statement COPY FROM STDIN is not implemented CREATE TABLE AS cannot specify INTO ERROR: EXEC SQL INCLUDE ... search starts here:
Error: include path "%s/%s" is too long on line %d, skipping
Options:
SHOW ALL is not implemented Try "%s --help" for more information.
Unix-domain sockets only work on "localhost" but not on "%s" Usage:
%s [OPTION]... FILE...
WARNING: arrays of indicators are not allowed on input could not open include file "%s" on line %d could not remove output file "%s"
cursor "%s" does not exist cursor "%s" has been declared but not opened cursor "%s" is already defined descriptor "%s" does not exist descriptor header item "%d" does not exist descriptor item "%s" cannot be set descriptor item "%s" is not implemented end of search list
expected "://", found "%s" expected "@" or "://", found "%s" expected "@", found "%s" expected "postgresql", found "%s" incomplete statement incorrectly formed variable "%s" indicator for array/pointer has to be array/pointer indicator for simple data type has to be simple indicator for struct has to be a struct indicator struct "%s" has too few members indicator struct "%s" has too many members indicator variable "%s" is hidden by a local variable indicator variable "%s" is hidden by a local variable of a different type indicator variable must have an integer type initializer not allowed in EXEC SQL VAR command initializer not allowed in type definition internal error: unreachable state; please report this to <pgsql-bugs@postgresql.org> interval specification not allowed here invalid bit string literal invalid connection type: %s invalid data type key_member is always 0 missing "EXEC SQL ENDIF;" missing identifier in EXEC SQL DEFINE command missing identifier in EXEC SQL IFDEF command missing identifier in EXEC SQL UNDEF command missing matching "EXEC SQL IFDEF" / "EXEC SQL IFNDEF" more than one EXEC SQL ELSE multidimensional arrays are not supported multidimensional arrays for simple data types are not supported multidimensional arrays for structures are not supported multilevel pointers (more than 2 levels) are not supported; found %d level multilevel pointers (more than 2 levels) are not supported; found %d levels nested /* ... */ comments nested arrays are not supported (except strings) no longer supported LIMIT #,# syntax passed to server nullable is always 1 only data types numeric and decimal have precision/scale argument only protocols "tcp" and "unix" and database type "postgresql" are supported operator not allowed in variable definition out of memory pointer to pointer is not supported for this data type pointers to varchar are not implemented subquery in FROM must have an alias syntax error syntax error in EXEC SQL INCLUDE command too many levels in nested structure/union definition too many nested EXEC SQL IFDEF conditions type "%s" is already defined type name "string" is reserved in Informix mode unmatched EXEC SQL ENDIF unrecognized data type name "%s" unrecognized descriptor item code %d unrecognized token "%s" unrecognized variable type code %d unsupported feature will be passed to server unterminated /* comment unterminated bit string literal unterminated hexadecimal string literal unterminated quoted identifier unterminated quoted string using unsupported DESCRIBE statement using variable "%s" in different declare statements is not supported variable "%s" is hidden by a local variable variable "%s" is hidden by a local variable of a different type variable "%s" is neither a structure nor a union variable "%s" is not a pointer variable "%s" is not a pointer to a structure or a union variable "%s" is not an array variable "%s" is not declared variable "%s" must have a numeric type zero-length delimited identifier Project-Id-Version: ecpg (PostgreSQL 9.6)
Report-Msgid-Bugs-To: pgsql-bugs@postgresql.org
POT-Creation-Date: 2020-05-15 23:49+0000
PO-Revision-Date: 2017-08-28 11:37+0200
Last-Translator: Álvaro Herrera <alvherre@alvh.no-ip.org
Language-Team: PgSQL-es-Ayuda <pgsql-es-ayuda@postgresql.org>
Language: es
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Plural-Forms: nplurals=2; plural=n != 1;
Si no se especifica un archivo de salida, el nombre se forma agregando .c al
archivo de entrada, luego de quitar .pgc si está presente.
Reporte errores a <pgsql-bugs@postgresql.org>.
--regression ejecuta en modo de prueba de regresión
-?, --help muestra esta ayuda, luego sale
-C MODO establece el modo de compatibilidad;
MODO puede ser "INFORMIX", "INFORMIX_SE"
-D SYMBOL define SYMBOL
-I DIRECTORIO busca los archivos de inclusión en DIRECTORIO
-V, --version muestra información de la versión, luego sale
-c genera automáticamente código en C desde código SQL
incrustado; esto afecta EXEC SQL TYPE
-d genera salida depurada del analizador
-h analiza un archivo de cabecera; esto incluye «-c»
-i analiza además los archivos de inclusión de sistema
-o ARCHIVO escribe la salida en ARCHIVO
-r OPCIÓN especifica el comportamiento en tiempo de ejecución;
OPCIÓN puede ser: «no_indicator», «prepare»,
«questionmarks»
-t activa el compromiso (commit) automático de transacciones
%s en o cerca de «%s» %s es el preprocesador de SQL incrustado para programas en C de PostgreSQL.
%s, el preprocesador de C incrustado de PostgreSQL, versión %d.%d.%d
%s: no se pudo localizar la ruta de mi propio ejecutable
%s: no se pudo abrir el archivo «%s»: %s
%s: no se especificaron archivos de entrada
%s: la depuración del analizador (parser, -d) no está disponible)
la opción AT no está permitida en la sentencia CLOSE DATABASE la opción AT no está permitida en la sentencia CONNECT la opción AT no está permitida en la sentencia DISCONNECT la opción AT no está permitida en la sentencia SET CONNECTION la opción AT no está permitida en la sentencia TYPE la opción AT no está permitida en la sentencia VAR la opción AT no está permitida en la sentencia WHENEVER COPY FROM STDIN no está implementado CREATE TABLE AS no puede especificar INTO ERROR: EXEC SQL INCLUDE ... la búsqueda comienza aquí:
Error: ruta de inclusión «%s/%s» es demasiada larga en la línea %d, omitiendo
Opciones:
SHOW ALL no está implementado Utilice «%s --help» para obtener mayor información.
los sockets de dominio unix sólo trabajan en «localhost» pero no en «%s» Empleo:
%s [OPCIÓN]... ARCHIVO...
ATENCIÓN: no se permiten los arrays de indicadores en la entrada no se pudo abrir el archivo a incluir «%s» en la línea %d no se pudo eliminar el archivo de salida «%s»
no existe el cursor «%s» el cursor «%s» fue declarado pero no abierto el cursor «%s» ya está definido no existe el descriptor «%s» no existe el descriptor del elemento de cabecera «%d» no se puede establecer el elemento del descriptor «%s» elemento del descriptor «%s» no está implementado fin de la lista de búsqueda
se esperaba «://», se encontró «%s» se esperaba «@» o «://», se encontró «%s» se esperaba «@», se encontró «%s» se esperaba «postgresql», se encontró «%s» sentencia incompleta variable formada incorrectamente «%s» indicador para array/puntero debe ser array/puntero el indicador para tipo dato simple debe ser simple el indicador para struct debe ser struct struct para indicador «%s» no tiene suficientes miembros struct para indicador «%s» tiene demasiados miembros variable de indicador «%s» está escondida por una variable local la variable de indicador «%s» está escondida por una variable local de tipo diferente la variable de un indicador debe ser de algún tipo numérico entero inicializador no permitido en la orden EXEC SQL VAR inicializador no permitido en definición de tipo Error Interno: estado no esperado; por favor reporte a <pgsql-bugs@postgresql.org> la especificación de intervalo no está permitida aquí cadena de bits no válida tipo de conexión no válido: %s tipo de dato no válido key_member es siempre 0 falta el «EXEC SQL ENDIF;» identificador faltante en la orden EXEC SQL DEFINE identificador faltante en la orden EXEC SQL IFDEF falta un identificador en la orden EXEC SQL UNDEF falta el «EXEC SQL IFDEF» / «EXEC SQL IFNDEF» hay más de un EXEC SQL ELSE los arrays multidimensionales no están soportados los arrays multidimensionales para tipos de datos simples no están soportados los arrays multidimensionales para estructuras no están soportados no se soportan los punteros multinivel (más de 2); se encontró 1 nivel no se soportan los punteros multinivel (más de 2); se encontraron %d niveles comentarios /* ... */ anidados no se permiten arrays anidados (excepto cadenas de caracteres) la sintaxis LIMIT #,# que ya no está soportada ha sido pasada al servidor nullable es siempre 1 sólo los tipos de dato numeric y decimal tienen argumento de precisión/escala sólo los protocolos «tcp» y «unix» y tipo de bases de datos «postgresql» están soportados operador no permitido en definición de variable memoria agotada los punteros a puntero no están soportados para este tipo de dato los punteros a varchar no están implementados las subconsultas en FROM deben tener un alias error de sintaxis error de sintaxis en orden EXEC SQL INCLUDE demasiados niveles en la definición anidada de estructura/unión demasiadas condiciones EXEC SQL IFDEF anidadas el tipo «%s» ya está definido el nombre de tipo «string» está reservado en modo Informix EXEC SQL ENDIF sin coincidencia nombre de tipo de datos «%s» no reconocido código de descriptor de elemento %d no reconocido elemento «%s» no reconocido código de tipo de variable %d no reconocido característica no soportada será pasada al servidor comentario /* no cerrado una cadena de bits está inconclusa una cadena hexadecimal está inconclusa un identificador en comillas está inconcluso una cadena en comillas está inconclusa utilizando sentencia DESCRIBE no soportada el uso de la variable «%s» en diferentes sentencias declare no está soportado la variable «%s» está escondida por una variable local la variable «%s» está escondida por una variable local de tipo diferente la variable «%s» no es una estructura ni una unión la variable «%s» no es un puntero la variable «%s» no es un puntero a una estructura o unión la variable «%s» no es un array la variable «%s» no está declarada la variable «%s» debe tener tipo numérico identificador delimitado de longitud cero locale/es/LC_MESSAGES/pg_dump-9.6.mo 0000644 00000200554 14751153421 0012512 0 ustar 00 �� � t � � ) ) /) X B) [ �) B �) ) :* " d* x �* + + + 3+ A L+ N �+ P �+ I ., 3 x, y �, G &- C n- N �- K . v M. F �. > / R J/ B �/ E �/ ? &0 L f0 3 �0 6 �0 Q 1 T p1 M �1 ? 2 � S2 � �2 ? �3 9 �3 5 4 : J4 K �4 B �4 D 5 � Y5 3 �5 � 6 ? �6 D �6 x 7 6 �7 Q �7 O 8 F g8 > �8 5 �8 > #9 E b9 A �9 O �9 H :: B �: @ �: = ; O E; H �; ; �; , < 4 G< E |< 0 �< = �< ; 1= F m= D �= C �= F => 8 �> ? �> C �> = A? 4 ? 7 �? L �? = 9@ @ w@ J �@ < A L @A , �A ( �A 5 �A E B T _B �B 9 �B D �B G 6C ~C �C ? �C ' �C * D e GD ! �D , �D 4 �D 6 1E ( hE / �E �E �E $ �E * F 2 AF B tF > �F J �F P AG N �G H �G - *H XH mH / �H �H 4 �H $ �H & I * CI # nI �I P �I C J A FJ ( �J �J �J �J K = K � ^K
�K , �K � !L � �L , QM ~M p �M e N & jN �N ` �N p �N 4 kO X �O _ �O E YP 1 �P 6 �P 4 Q * =Q - hQ D �Q . �Q +
R + 6R ) bR * �R > �R : �R ' 1S = YS ) �S 1 �S �S @ T 7 OT 6 �T 6 �T < �T = 2U 4 pU 3 �U b �U 9 <V < vV t �V # (W , LW 5 yW �W �W �W
�W ' X 0X % <X bX / �X X �X & Y 0 2Y . cY ) �Y ) �Y �Y �Y Z 3 Z ( OZ xZ ) �Z # �Z �Z �Z & [ K <[ & �[ �[ ! �[ ( �[ ' \ # @\ # d\ �\ / �\ �\ �\ # ] % 9] _] , |] $ �] $ �] $ �] 6 ^ O^ g^ B �^ � �^ � b_ �_ $ ` < 6` 3 s` * �` ' �` + �` ( &a ( Oa # xa - �a � �a + �b , �b ! �b & c ' <c # dc �c " �c 8 �c $ d (d Hd Q gd & �d a �d @ Be 5 �e , �e �e " f # $f , Hf uf ! �f # �f * �f # g % )g 0 Og & �g $ �g �g " �g = h # Lh 1 ph �h �h �h : �h ) i B >i P �i �i �i j j " /j Rj lj & �j & �j % �j 2 �j 0k Ek & ak ! �k ) �k # �k " �k l r ,l < �l D �l N !m F pm �m �m �m & n , 8n - en �n " �n / �n o o ( 5o @ ^o �o �o �o P �o Cp > Yp 1 �p > �p / q Y 9q > �q �q �q " r .r & Kr < rr �r ' �r ( �r ' s <s Zs qs 1 �s + �s �s % t 3 )t ]t vt " �t ; �t �t �t 0 u Nu / mu �u �u �u . �u I !v > kv D �v �v �v w 7 -w 9 ew 6 �w H �w @ x `x 3 rx & �x 0 �x 6 �x / 5y ( ey , �y �y " �y �y z (z h 9z T �z � �z 6 z{ L �{ J �{ 9 I| �| $ �| + �| �| �| } -} E} 2 Y} �} " �} �} �} # �}
~ +~ / B~ r~ & �~ �~ �~ # �~ �~ $ ) - W ! x % � + � � & � ' 3� [� {� 0 �� . ɀ ) �� + "� N� j� 4 �� � �� # @� * d� �� �� �� ׂ ( � � " 0� S� E h� # �� ҃ � � ; � E� [� h� ' �� �� ' Ą � % � 2� N� B k� 0 �� ! ߅ 8 � : :� u� �� 3 �� 1 � 1 � + H� $ t� $ �� h �� � '� �� � Q *� m |� J � 3 5� * i� � �� � � 0� N� C k� m �� � � � �� 5 K� � �� P � > f� J �� J � � ;� L ː > � r W� @ ʑ @ � > L� �� > � < J� o �� s �� v k� H � � +� � �� B q� 6 �� 6 � < "� u _� G J � � h� ; �� � 9� F �� E � { K� Z ǚ � "� J �� q � B u� H �� D � C F� D �� v ϝ J F� A �� F Ӟ E � I `� I �� B � A 7� J y� � Ġ 8 G� E �� H ơ P � x `� E ٢ H � L h� n �� I $� < n� : �� B � o )� A �� L ۥ R (� B {� o �� ( .� ( W� 7 �� D �� I �� G� F J� Y �� V � B� ^� M y� A ǩ 5 � � ?� 0 Ԫ 5 � Y ;� T �� ; � 7 &� ' ^� �� - �� 5 Ǭ : �� E 8� A ~� M �� S � Q b� K �� 8 � 9� T� 7 m� �� J �� , � 0 4� 6 e� # �� $ �� V � P <� N �� > ܱ ! � =� [� 4 {� L �� � ��
�� / �� � ۳ � i� 9 � (� z :� j �� - � N� � W� z ٶ O T� t �� x � R �� = � @ #� > d� 8 �� 9 ܹ S � > j� ; �� ; � 9 !� : [� Z �� Q � < C� J �� B ˼ K � ! Z� R |� = Ͻ C
� A Q� N �� P � @ 3� @ t� t �� > *� M i� t �� ' ,� < T� B �� " � ' �� �
(� / 6� f� 4 y� , �� 5 �� n � 1 �� 5 �� 5 �� / � / N� ~� �� �� ? �� 1 �� *� < <� 5 y� ( �� " �� 1 �� Y -� - �� % �� 0 �� 3 � * @� 1 k� + �� , �� X �� + O� * {� & �� 6 �� � 2 $� * W� ( �� % �� K �� � , =� ^ j� � �� � �� / �� 8 �� 9 �� L -� 4 z� @ �� 5 �� . &� / U� , �� 8 �� � �� G �� K � + c� 5 �� 9 �� 2 �� + 2� ( ^� d �� 1 �� * � " I� k l� , �� { � T �� H �� 6 � ! V� ) x� * �� < �� *
� + 5� 6 a� 1 �� ( �� . �� > "� 8 a� 6 �� " �� L �� F A� - �� 2 �� �� �� � E "� ? h� X �� Q � S� - f� / �� �� . �� , � ' 2� ( Z� ( �� ' �� Z �� /� : I� 4 �� % �� M �� # -� " Q� t� � �� K $� c p� o �� d D� ' �� ) �� * �� / &� D V� 8 �� �� �� 4 � I� % h� 1 �� Z �� � % :� + `� d �� �� J � : Z� O �� C �� \ )� = �� ! �� " �� , � # 6� 8 Z� [ �� �� > � < N� 6 �� & �� �� � [ � 5 v� ) �� 7 �� P � _� }� * �� G �� � ( '� ? P� & �� = �� * �� � % :� 6 `� L �� A �� G &� n� " � �� J �� Q �� P Q� d �� L � T� = f� 0 �� ; �� @ � 8 R� 1 �� 2 �� �� ' �� '� ( H� q� � �� d
� � o� T 6� z �� \ � M c� �� @ �� A � I� % d� ! �� % �� �� C �� /� 0 E� v� �� 2 �� # �� " �� C � a� 2 s� �� $ �� ? �� )� 8 G� > �� 3 �� 2 � : &� B a� / �� : � < � 0 L� , }� K �� H �� R ?� F �� + � $ � I *� � t� ) � > +� . j� �� �� � * � � 5� V� b l� . � �� $ � B� A I� �� �� �� + � �� . � # O� . s� " �� � T � 2 2� $ e� J �� D � ( � ( C� ; l� M �� M �� ; D * � - � � � � � � � � A r � � � � � < � � � � ^ � � B � Y N � � � ' � a p ) � B � - �
� � X H � u � � $ � n ? 6 � � K i � y � � � � � � $ � � { � � � q � � { � � � + ' � � I � � < � J ~ m � . m v Q t � � � � � � Q � � � + � x � � ? P 2 f � � � � � � � � � � � � � p # � j � � , z ; � S � 4 � � � � � � � � � k � O = " 3 � � % � � [ o � � � � 6 � � � � y
g � ( � > � � � � x � � > # � � o W T ! � � 4 � � E : E D � � @ � Z � � � H e � _ / � Y �
h [ l v d ] � � 5 d � � � � � � � N G � r } � � 8 � V z � � J � ` & � � � � � � � , ! - � F � a � ; � U 3 � C " O � � C � * � � � 1 � I S � � / 9 c � \ � � � � 9 � ` * � 5 T � R � 0 � � | � � � � � � � e . �
� 0 \ M � � t b W | K R � � b � � & � q � � ^ � � X l � � } s g � � s _ h � D 1 2 � � i � U � � � � � � � � : � L � w ] � ( � j � M � F G � k n � L = � � � u � � � 7 V � Z ~ f ) � w c % @ A � � 7 8 P � � � �
Connection options:
General options:
If -f/--file is not used, then the SQL script will be written to the standard
output.
If no database name is supplied, then the PGDATABASE environment
variable value is used.
If no input file name is supplied, then standard input is used.
Options controlling the output content:
Options controlling the restore:
The options -I, -n, -P, -t, -T, and --section can be combined and specified
multiple times to select multiple objects.
%s
%s [OPTION]...
%s [OPTION]... [DBNAME]
%s [OPTION]... [FILE]
--binary-upgrade for use by upgrade utilities only
--column-inserts dump data as INSERT commands with column names
--disable-dollar-quoting disable dollar quoting, use SQL standard quoting
--disable-triggers disable triggers during data-only restore
--enable-row-security enable row security
--enable-row-security enable row security (dump only content user has
access to)
--exclude-table-data=TABLE do NOT dump data for the named table(s)
--if-exists use IF EXISTS when dropping objects
--inserts dump data as INSERT commands, rather than COPY
--lock-wait-timeout=TIMEOUT fail after waiting TIMEOUT for a table lock
--no-data-for-failed-tables do not restore data of tables that could not be
created
--no-security-labels do not dump security label assignments
--no-security-labels do not restore security labels
--no-synchronized-snapshots do not use synchronized snapshots in parallel jobs
--no-tablespaces do not dump tablespace assignments
--no-tablespaces do not restore tablespace assignments
--no-unlogged-table-data do not dump unlogged table data
--quote-all-identifiers quote all identifiers, even if not key words
--role=ROLENAME do SET ROLE before dump
--role=ROLENAME do SET ROLE before restore
--section=SECTION dump named section (pre-data, data, or post-data)
--section=SECTION restore named section (pre-data, data, or post-data)
--serializable-deferrable wait until the dump can run without anomalies
--snapshot=SNAPSHOT use given snapshot for the dump
--strict-names require table and/or schema include patterns to
match at least one entity each
--use-set-session-authorization
use SET SESSION AUTHORIZATION commands instead of
ALTER OWNER commands to set ownership
-1, --single-transaction restore as a single transaction
-?, --help show this help, then exit
-?, --help show this help, then exit
-C, --create create the target database
-C, --create include commands to create database in dump
-E, --encoding=ENCODING dump the data in encoding ENCODING
-F, --format=c|d|t backup file format (should be automatic)
-F, --format=c|d|t|p output file format (custom, directory, tar,
plain text (default))
-I, --index=NAME restore named index
-L, --use-list=FILENAME use table of contents from this file for
selecting/ordering output
-N, --exclude-schema=SCHEMA do NOT dump the named schema(s)
-O, --no-owner skip restoration of object ownership
-O, --no-owner skip restoration of object ownership in
plain-text format
-P, --function=NAME(args) restore named function
-S, --superuser=NAME superuser user name to use for disabling triggers
-S, --superuser=NAME superuser user name to use in plain-text format
-S, --superuser=NAME superuser user name to use in the dump
-T, --exclude-table=TABLE do NOT dump the named table(s)
-T, --trigger=NAME restore named trigger
-U, --username=NAME connect as specified database user
-V, --version output version information, then exit
-V, --version output version information, then exit
-W, --password force password prompt (should happen automatically)
-Z, --compress=0-9 compression level for compressed formats
-a, --data-only dump only the data, not the schema
-a, --data-only restore only the data, no schema
-b, --blobs include large objects in dump
-c, --clean clean (drop) database objects before recreating
-c, --clean clean (drop) databases before recreating
-d, --dbname=CONNSTR connect using connection string
-d, --dbname=DBNAME database to dump
-d, --dbname=NAME connect to database name
-e, --exit-on-error exit on error, default is to continue
-f, --file=FILENAME output file name
-f, --file=FILENAME output file or directory name
-f, --file=FILENAME output file name (- for stdout)
-g, --globals-only dump only global objects, no databases
-h, --host=HOSTNAME database server host or socket directory
-j, --jobs=NUM use this many parallel jobs to dump
-j, --jobs=NUM use this many parallel jobs to restore
-l, --database=DBNAME alternative default database
-l, --list print summarized TOC of the archive
-n, --schema=NAME restore only objects in this schema
-n, --schema=SCHEMA dump the named schema(s) only
-o, --oids include OIDs in dump
-p, --port=PORT database server port number
-r, --roles-only dump only roles, no databases or tablespaces
-s, --schema-only dump only the schema, no data
-s, --schema-only restore only the schema, no data
-t, --table=NAME restore named relation (table, view, etc.)
-t, --table=TABLE dump the named table(s) only
-t, --tablespaces-only dump only tablespaces, no databases or roles
-v, --verbose verbose mode
-v, --verbose verbose mode
-w, --no-password never prompt for password
-x, --no-privileges do not dump privileges (grant/revoke)
-x, --no-privileges skip restoration of access privileges (grant/revoke)
%s %s dumps a database as a text file or to other formats.
%s extracts a PostgreSQL database cluster into an SQL script file.
%s restores a PostgreSQL database from an archive created by pg_dump.
%s: %s Command was: %s
%s: WSAStartup failed: %d
%s: cannot specify both --single-transaction and multiple jobs
%s: could not connect to database "%s"
%s: could not connect to database "%s": %s %s: could not connect to databases "postgres" or "template1"
Please specify an alternative database.
%s: could not get server version
%s: could not open the output file "%s": %s
%s: could not parse ACL list (%s) for database "%s"
%s: could not parse ACL list (%s) for tablespace "%s"
%s: could not parse server version "%s"
%s: could not re-open the output file "%s": %s
%s: dumping database "%s"...
%s: executing %s
%s: invalid number of parallel jobs
%s: maximum number of parallel jobs is %d
%s: option --if-exists requires option -c/--clean
%s: options -c/--clean and -a/--data-only cannot be used together
%s: options -d/--dbname and -f/--file cannot be used together
%s: options -g/--globals-only and -r/--roles-only cannot be used together
%s: options -g/--globals-only and -t/--tablespaces-only cannot be used together
%s: options -r/--roles-only and -t/--tablespaces-only cannot be used together
%s: options -s/--schema-only and -a/--data-only cannot be used together
%s: pg_dump failed on database "%s", exiting
%s: query failed: %s %s: query was: %s
%s: role name starting with "pg_" skipped (%s)
%s: running "%s"
%s: too many command-line arguments (first is "%s")
%s: unrecognized section name: "%s"
(The INSERT command cannot set OIDs.)
(The system catalogs might be corrupted.)
-C and -1 are incompatible options
COPY failed for table "%s": %s Consider using a full dump instead of a --data-only dump to avoid this problem.
Dumping the contents of table "%s" failed: PQgetCopyData() failed.
Dumping the contents of table "%s" failed: PQgetResult() failed.
Error from TOC entry %d; %u %u %s %s %s
Error message from server: %s Error while FINALIZING:
Error while INITIALIZING:
Error while PROCESSING TOC:
Exported snapshots are not supported by this server version.
NOTICE: there are circular foreign-key constraints on this table:
NOTICE: there are circular foreign-key constraints among these tables:
Password: Report bugs to <pgsql-bugs@postgresql.org>.
Synchronized snapshots are not supported by this server version.
Run with --no-synchronized-snapshots instead if you do not need
synchronized snapshots.
Synchronized snapshots are not supported on standby servers.
Run with --no-synchronized-snapshots instead if you do not need
synchronized snapshots.
TOC Entry %s at %s (length %s, checksum %d)
The command was: %s
The program "pg_dump" is needed by %s but was not found in the
same directory as "%s".
Check your installation.
The program "pg_dump" was found by "%s"
but was not the same version as %s.
Check your installation.
Try "%s --help" for more information.
Usage:
WARNING: aggregate function %s could not be dumped correctly for this database version; ignored
WARNING: archive is compressed, but this installation does not support compression -- no data will be available
WARNING: archive items not in correct section order
WARNING: archive was made on a machine with larger integers, some operations might fail
WARNING: bogus transform definition, at least one of trffromsql and trftosql should be nonzero
WARNING: bogus value in pg_cast.castfunc or pg_cast.castmethod field
WARNING: bogus value in pg_cast.castmethod field
WARNING: bogus value in pg_transform.trffromsql field
WARNING: bogus value in pg_transform.trftosql field
WARNING: bogus value in proargmodes array
WARNING: could not find operator with OID %s
WARNING: could not find where to insert IF EXISTS in statement "%s"
WARNING: could not parse proallargtypes array
WARNING: could not parse proargmodes array
WARNING: could not parse proargnames array
WARNING: could not parse proconfig array
WARNING: could not parse reloptions array
WARNING: could not resolve dependency loop among these items:
WARNING: don't know how to set owner for object type "%s"
WARNING: errors ignored on restore: %d
WARNING: ftell mismatch with expected position -- ftell used
WARNING: invalid creation date in header
WARNING: invalid type "%c" of access method "%s"
WARNING: line ignored: %s
WARNING: owner of aggregate function "%s" appears to be invalid
WARNING: owner of data type "%s" appears to be invalid
WARNING: owner of function "%s" appears to be invalid
WARNING: owner of operator "%s" appears to be invalid
WARNING: owner of operator class "%s" appears to be invalid
WARNING: owner of operator family "%s" appears to be invalid
WARNING: owner of schema "%s" appears to be invalid
WARNING: owner of table "%s" appears to be invalid
WARNING: requested compression not available in this installation -- archive will be uncompressed
WARNING: typtype of data type "%s" appears to be invalid
WARNING: unexpected extra results during COPY of table "%s"
You might not be able to restore the dump without using --disable-triggers or temporarily dropping the constraints.
a worker process died unexpectedly
aborting because of server version mismatch
actual file length (%s) does not match expected (%s)
allocating AH for %s, format %d
already connected to a database
archiver archiver (db) attempting to ascertain archive format
bad dumpId
bad table dumpId for TABLE DATA item
can only reopen input archives
cannot duplicate null pointer (internal error)
cannot restore from compressed archive (compression not supported in this installation)
child process exited with exit code %d child process exited with unrecognized status %d child process was terminated by exception 0x%X child process was terminated by signal %d child process was terminated by signal %s command not executable command not found compress_io compression is not supported by tar archive format
compression level must be in range 0..9
compressor active
connecting to database "%s" as user "%s"
connecting to database for restore
connecting to new database "%s"
connection needs password
connection to database "%s" failed: %s corrupt tar header found in %s (expected %d, computed %d) file position %s
could not change directory to "%s": %s could not close TOC file: %s
could not close archive file: %s
could not close compression library: %s
could not close compression stream: %s
could not close data file "%s": %s
could not close directory "%s": %s
could not close input file: %s
could not close large object TOC file "%s": %s
could not close output file: %s
could not close tar member
could not close temporary file: %s
could not commit database transaction could not compress data: %s
could not create communication channels: %s
could not create directory "%s": %s
could not create large object %u: %s could not create worker process: %s
could not determine seek position in archive file: %s
could not execute query could not find a "%s" to execute could not find block ID %d in archive -- possibly corrupt archive
could not find block ID %d in archive -- possibly due to out-of-order restore request, which cannot be handled due to lack of data offsets in archive
could not find block ID %d in archive -- possibly due to out-of-order restore request, which cannot be handled due to non-seekable input file
could not find entry for ID %d
could not find file "%s" in archive
could not find function definition for function with OID %u
could not find header for file "%s" in tar archive
could not find parent extension for %s %s
could not find slot of finished worker
could not generate temporary file name: %s
could not get server_version from libpq
could not identify current directory: %s could not identify dependency loop
could not initialize compression library: %s
could not obtain lock on relation "%s"
This usually means that someone requested an ACCESS EXCLUSIVE lock on the table after the pg_dump parent process had gotten the initial ACCESS SHARE lock on the table.
could not open TOC file "%s" for input: %s
could not open TOC file "%s" for output: %s
could not open TOC file "%s": %s
could not open TOC file for input: %s
could not open TOC file for output: %s
could not open input file "%s": %s
could not open input file: %s
could not open large object %u: %s could not open large object TOC file "%s" for input: %s
could not open output file "%s": %s
could not open output file: %s
could not open temporary file
could not parse GRANT ACL list (%s) or REVOKE ACL list (%s) for object "%s" (%s)
could not parse default ACL list (%s)
could not parse initial GRANT ACL list (%s) or initial REVOKE ACL list (%s) for object "%s" (%s)
could not parse numeric array "%s": invalid character in number
could not parse numeric array "%s": too many numbers
could not parse result of current_schemas()
could not read binary "%s" could not read directory "%s": %s
could not read from input file: %s
could not read from input file: end of file
could not read input file: %s
could not read symbolic link "%s" could not reconnect to database: %s could not set default_tablespace to %s: %s could not set default_with_oids: %s could not set search_path to "%s": %s could not set seek position in archive file: %s
could not set session user to "%s": %s could not start database transaction could not uncompress data: %s
could not write to blobs TOC file
could not write to large object (result: %lu, expected: %lu)
could not write to output file: %s
could not write to the communication channel: %s
creating %s "%s"
creating %s "%s.%s"
custom archiver definition of view "%s" appears to be empty (length zero)
did not find magic string in file header
direct database connections are not supported in pre-1.3 archives
directory "%s" does not appear to be a valid archive ("toc.dat" does not exist)
directory archiver directory name too long: "%s"
disabling triggers for %s
dropping %s %s
dumping contents of table "%s.%s"
enabling triggers for %s
entering main parallel loop
entering restore_toc_entries_parallel
entering restore_toc_entries_postfork
entering restore_toc_entries_prefork
entry ID %d out of range -- perhaps a corrupt TOC
error during backup
error during file seek: %s
error processing a parallel work item
error reading large object %u: %s error reading large object TOC file "%s"
error returned by PQputCopyData: %s error returned by PQputCopyEnd: %s executing %s %s
expected %d check constraint on table "%s" but found %d
expected %d check constraints on table "%s" but found %d
expected format (%d) differs from format found in file (%d)
failed sanity check, parent OID %u of table "%s" (OID %u) not found
failed sanity check, parent table OID %u of pg_rewrite entry OID %u not found
failed sanity check, parent table OID %u of sequence OID %u not found
failed to connect to database
failed to reconnect to database
file name too long: "%s"
file offset in dump file is too large
finding check constraints for table "%s.%s"
finding default expressions of table "%s.%s"
finding extension tables
finding inheritance relationships
finding the columns and types of table "%s.%s"
finished item %d %s %s
finished main parallel loop
flagging inherited columns in subtables
found unexpected block ID (%d) when reading data -- expected %d
function "%s" not found
identifying extension members
implied data-only restore
incomplete tar header found (%lu byte)
incomplete tar header found (%lu bytes)
index "%s" not found
input file appears to be a text format dump. Please use psql.
input file does not appear to be a valid archive
input file does not appear to be a valid archive (too short?)
input file is too short (read %lu, expected 5)
internal error -- WriteData cannot be called outside the context of a DataDumper routine
internal error -- neither th nor fh specified in tarReadRaw()
invalid ENCODING item: %s
invalid OID for large object
invalid OID for large object (%u)
invalid STDSTRINGS item: %s
invalid adnum value %d for table "%s"
invalid argument string (%s) for trigger "%s" on table "%s"
invalid binary "%s" invalid client encoding "%s" specified
invalid column number %d for table "%s"
invalid column numbering in table "%s"
invalid compression code: %d
invalid dependency %d
invalid dumpId %d
invalid line in large object TOC file "%s": "%s"
invalid message received from worker: "%s"
invalid number of parallel jobs
invalid output format "%s" specified
large-object output not supported in chosen format
last built-in OID is %u
launching item %d %s %s
missing index for constraint "%s"
moving from position %s to next member at file position %s
no item ready
no matching schemas were found
no matching schemas were found for pattern "%s"
no matching tables were found
no matching tables were found for pattern "%s"
no output directory specified
not built with zlib support
now at file position %s
option --if-exists requires option -c/--clean
options --inserts/--column-inserts and -o/--oids cannot be used together
options -c/--clean and -a/--data-only cannot be used together
options -s/--schema-only and -a/--data-only cannot be used together
out of memory
out of on_exit_nicely slots
parallel archiver parallel backup only supported by the directory format
parallel restore from non-seekable file is not supported
parallel restore from standard input is not supported
parallel restore is not supported with archives made by pre-8.0 pg_dump
parallel restore is not supported with this archive file format
pclose failed: %s pgpipe: could not accept connection: error code %d
pgpipe: could not bind: error code %d
pgpipe: could not connect socket: error code %d
pgpipe: could not create second socket: error code %d
pgpipe: could not create socket: error code %d
pgpipe: could not listen: error code %d
pgpipe: getsockname() failed: error code %d
processing %s
processing data for table "%s.%s"
processing item %d %s %s
processing missed item %d %s %s
query failed: %s query produced null referenced table name for foreign key trigger "%s" on table "%s" (OID of table: %u)
query returned %d row instead of one: %s
query returned %d rows instead of one: %s
query to get data of sequence "%s" returned %d row (expected 1)
query to get data of sequence "%s" returned %d rows (expected 1)
query to get data of sequence "%s" returned name "%s"
query to get rule "%s" for table "%s" failed: wrong number of rows returned
query to obtain definition of view "%s" returned more than one definition
query to obtain definition of view "%s" returned no data
query was: %s
read TOC entry %d (ID %d) for %s %s
reading column info for interesting tables
reading constraints
reading default privileges
reading dependency data
reading event triggers
reading extensions
reading foreign key constraints for table "%s.%s"
reading indexes
reading indexes for table "%s.%s"
reading large objects
reading policies
reading policies for table "%s.%s"
reading procedural languages
reading rewrite rules
reading row security enabled for table "%s.%s"
reading schemas
reading table inheritance information
reading transforms
reading triggers
reading triggers for table "%s.%s"
reading type casts
reading user-defined access methods
reading user-defined aggregate functions
reading user-defined collations
reading user-defined conversions
reading user-defined foreign servers
reading user-defined foreign-data wrappers
reading user-defined functions
reading user-defined operator classes
reading user-defined operator families
reading user-defined operators
reading user-defined tables
reading user-defined text search configurations
reading user-defined text search dictionaries
reading user-defined text search parsers
reading user-defined text search templates
reading user-defined types
reducing dependencies for %d
restored %d large object
restored %d large objects
restoring data out of order is not supported in this archive format: "%s" is required, but comes before "%s" in the archive file.
restoring large object with OID %u
sanity check on integer size (%lu) failed
saving database definition
saving encoding = %s
saving large objects
saving search_path = %s
saving standard_conforming_strings = %s
schema "%s" not found
schema with OID %u does not exist
select() failed: %s
server version must be at least 7.3 to use schema selection switches
server version: %s; %s version: %s
skipping item %d %s %s
skipping tar member %s
sorter table "%s" could not be created, will not restore its data
table "%s" not found
tar archiver this format cannot be read
transferring dependency %d -> %d to %d
trigger "%s" not found
unexpected COPY statement syntax: "%s"
unexpected data offset flag %d
unexpected policy command type: "%s"
unexpected section code %d
unexpected tgtype value: %d
unrecognized archive format "%s"; please specify "c", "d", or "t"
unrecognized command received from master: "%s"
unrecognized constraint type: %c
unrecognized data block type %d while restoring archive
unrecognized data block type (%d) while searching archive
unrecognized encoding "%s"
unrecognized file format "%d"
unrecognized object type in default privileges: %d
unrecognized proparallel value for function "%s"
unrecognized provolatile value for function "%s"
unsupported version (%d.%d) in file header
warning from original dump file: %s
worker process failed: exit code %d
wrote %lu byte of large object data (result = %lu)
wrote %lu bytes of large object data (result = %lu)
Project-Id-Version: pg_dump (PostgreSQL 9.6)
Report-Msgid-Bugs-To: pgsql-bugs@postgresql.org
POT-Creation-Date: 2020-05-15 23:53+0000
PO-Revision-Date: 2017-08-28 11:37+0200
Last-Translator: Carlos Chapi <carlos.chapi@2ndquadrant.com>
Language-Team: PgSQL Español <pgsql-es-ayuda@postgresql.org>
Language: es
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Plural-Forms: nplurals=2; plural=n != 1;
X-Generator: Poedit 1.8.7
Opciones de conexión:
Opciones generales:
Si no se usa -f/--file, el volcado de SQL será escrito a la salida estándar.
Si no se especifica un nombre de base de datos, se utiliza el valor
de la variable de ambiente PGDATABASE.
Si no se especifica un archivo de entrada, se usa la entrada estándar.
Opciones que controlan el contenido de la salida:
Opciones que controlan la recuperación:
Las opciones -I, -n, -P, -t, -T, y --section pueden ser combinadas y especificadas
varias veces para seleccionar varios objetos.
%s
%s [OPCIÓN]...
%s [OPCIÓN]... [NOMBREDB]
%s [OPCIÓN]... [ARCHIVO]
--binary-upgrade sólo para uso de utilidades de upgrade
--column-inserts extrae los datos usando INSERT con nombres
de columnas
--disable-dollar-quoting deshabilita el uso de «delimitadores de dólar»,
usa delimitadores de cadena estándares
--disable-triggers deshabilita los disparadores (triggers) durante el
restablecimiento de la extracción de sólo-datos
--enable-row-security activa seguridad de filas
--enable-row-security activa seguridad de filas (volcar sólo el
contenido al que el usuario tiene acceso)
--exclude-table-data=TABLA NO extrae los datos de la(s) tabla(s) nombrada(s)
--if-exists usa IF EXISTS al eliminar objetos
--inserts extrae los datos usando INSERT, en vez de COPY
--lock-wait-timeout=SEGS espera a lo más SEGS segundos obtener un lock
--no-data-for-failed-tables
no reestablece datos de tablas que no pudieron
ser creadas
--no-security-labels no volcar asignaciones de etiquetas de seguridad
--no-security-labels no restaura etiquetas de seguridad
--no-synchronized-snapshots no usar snapshots sincronizados en trabajos
en paralelo
--no-tablespaces no volcar asignaciones de tablespace
--no-tablespaces no vuelca asignaciones de tablespace
--no-unlogged-table-data no volcar datos de tablas unlogged
--quote-all-identifiers entrecomilla todos los identificadores, incluso
si no son palabras clave
--role=ROL ejecuta SET ROLE antes del volcado
--role=ROLENAME hace SET ROLE antes de restaurar
--section=SECCIÓN volcar la sección nombrada (pre-data, data,
post-data)
--section=SECCIÓN reestablece la sección nombrada (pre-data, data
post-data)
--serializable-deferrable espera hasta que el respaldo pueda completarse
sin anomalías
--snapshot=SNAPSHOT use el snapshot dado para la extracción
--strict-names requerir al menos una coincidencia para cada patrón
de nombre de tablas y esquemas
--use-set-session-authorization
usa órdenes SESSION AUTHORIZATION en lugar de
ALTER OWNER para cambiar los dueño de los objetos
-1, --single-transaction reestablece en una única transacción
-?, --help mostrar esta ayuda y salir
-?, --help mostrar esta ayuda y salir
-C, --create crea la base de datos de destino
-C, --create incluye órdenes para crear la base de datos
en la extracción
-E, --encoding=CODIF extrae los datos con la codificación CODIF
-F, --format=c|d|t formato del volcado (debería ser automático)
-F, --format=c|d|t|p Formato del archivo de salida (c=personalizado,
d=directorio, t=tar, p=texto (por omisión))
-I, --index=NOMBRE reestablece el índice nombrado
-L, --use-list=ARCHIVO usa la tabla de contenido especificada para ordenar
la salida de este archivo
-N, --exclude-schema=ESQUEMA NO extrae el o los esquemas nombrados
-O, --no-owner no reestablece los dueños de los objetos
-O, --no-owner en formato de sólo texto, no reestablece
los dueños de los objetos
-P, --function=NOMBRE(args)
reestablece la función nombrada
-S, --superuser=NOMBRE especifica el nombre del superusuario que se usa
para deshabilitar los disparadores (triggers)
-S, --superuser=NAME superusuario a utilizar en el volcado de texto
-S, --superuser=NAME especifica el nombre del superusuario a usar en
el volcado
-T, --exclude-table=TABLA NO extrae la(s) tabla(s) nombrada(s)
-T, --trigger=NOMBRE reestablece el disparador (trigger) nombrado
-U, --username=USUARIO nombre de usuario con el cual conectarse
-V, --version mostrar información de version y salir
-V, --version mostrar información de versión y salir
-W, --password fuerza un prompt para la contraseña
(debería ser automático)
-Z, --compress=0-9 nivel de compresión para formatos comprimidos
-a, --data-only extrae sólo los datos, no el esquema
-a, --data-only reestablece sólo los datos, no el esquema
-b, --blobs incluye objetos grandes en la extracción
-c, --clean tira (drop) la base de datos antes de crearla
-c, --clean tira (drop) la base de datos antes de crearla
-d, --dbname=CONNSTR conectar usando la cadena de conexión
-d, --dbname=NOMBRE nombre de la base de datos que volcar
-d, --dbname=NOMBRE nombre de la base de datos a la que conectarse
-e, --exit-on-error abandonar al encontrar un error
por omisión, se continúa la restauración
-f, --file=ARCHIVO nombre del archivo de salida
-f, --file=ARCHIVO nombre del archivo o directorio de salida
-f, --file=ARCHIVO nombre del archivo de salida (- para stdout)
-g, --globals-only extrae sólo los objetos globales, no bases de datos
-h, --host=ANFITRIÓN anfitrión de la base de datos o
directorio del enchufe (socket)
-j, --jobs=NUM máximo de procesos paralelos para volcar
-j, --jobs=NUM máximo de procesos paralelos para restaurar
-l, --database=NOMBRE especifica la base de datos a la cual conectarse
-l, --list imprime una tabla resumida de contenidos
del archivador
-n, --schema=NAME reestablece sólo los objetos en este esquema
-n, --schema=ESQUEMA extrae sólo el esquema nombrado
-o, --oids incluye OIDs en la extracción
-p, --port=PUERTO número del puerto de la base de datos
-r, --roles-only extrae sólo los roles, no bases de datos
ni tablespaces
-s, --schema-only extrae sólo el esquema, no los datos
-s, --schema-only reestablece el esquema únicamente, no los datos
-t, --table=NOMBRE reestablece la relación (tabla, vista, etc.) nombrada
-t, --table=TABLE extrae sólo la o las tablas nombradas
-t, --tablespaces-only extrae sólo los tablespaces, no bases de datos
ni roles
-v, --verbose modo verboso
-v, --verbose modo verboso
-w, --no-password nunca pedir una contraseña
-x, --no-privileges no extrae los privilegios (grant/revoke)
-x, --no-privileges no reestablece los privilegios (grant/revoke)
%s %s extrae una base de datos en formato de texto o en otros formatos.
%s extrae un cluster de bases de datos de PostgreSQL en un archivo
guión (script) SQL.
%s reestablece una base de datos de PostgreSQL usando un archivo
creado por pg_dump.
%s: %s La orden era: %s
%s: WSAStartup falló: %d
%s: no se puede especificar --single-transaction junto con múltiples tareas
%s: no se pudo establecer la conexión a la base de datos «%s»
%s: no se pudo conectar a la base de datos «%s»: %s %s: no se pudo establecer la conexión a las bases de datos «postgres» o
«template1». Por favor especifique una base de datos para conectarse.
%s: no se pudo obtener la versión del servidor
%s: no se pudo abrir el archivo de salida «%s»: %s
%s: no se pudo interpretar la lista de control de acceso (%s) de la base de datos «%s»
%s: no se pudo interpretar la lista de control de acceso (%s) del tablespace «%s»
%s: no se pudo interpretar la versión del servidor «%s»
%s: no se pudo reabrir el archivo de salida «%s»: %s
%s: extrayendo base de datos «%s»...
%s: ejecutando %s
%s: número de trabajos paralelos no válido
%s: el número máximo de trabajos en paralelo es %d
%s: la opción --if-exists requiere la opción -c/--clean
%s: las opciones -c/--clean y -a/--data-only no pueden usarse juntas
%s: las opciones -d/--dbname y -f/--file no pueden usarse juntas
%s: las opciones -g/--globals-only y -r/--roles-only no pueden usarse juntas
%s: las opciones -g/--globals-only y -t/--tablespaces-only no pueden usarse juntas
%s: las opciones -r/--roles-only y -t/--tablespaces-only no pueden usarse juntas
%s: las opciones -s/--schema-only y -a/--data-only no pueden usarse juntas
%s: pg_dump falló en la base de datos «%s», saliendo
%s: falló la consulta: %s %s: la consulta era: %s
%s: omitido nombre de rol que empieza con «pg_» (%s)
%s: ejecutando «%s»
%s: demasiados argumentos en la línea de órdenes (el primero es «%s»)
%s: nombre de sección «%s» no reconocido
(La orden INSERT no puede establecer los OIDs).
(Los catálogos del sistema podrían estar corruptos)
-C y -1 son opciones incompatibles
COPY falló para la tabla «%s»: %s Considere usar un volcado completo en lugar de --data-only para evitar este problema.
Falló la extracción del contenido de la tabla «%s»: PQgetCopyData() falló.
Falló la extracción del contenido de la tabla «%s»: PQgetResult() falló.
Error en entrada de la tabla de contenidos %d; %u %u %s %s %s
Mensaje de error del servidor: %s Error durante FINALIZACIÓN:
Error durante INICIALIZACIÓN:
Error durante PROCESAMIENTO DE TABLA DE CONTENIDOS:
Los snapshot exportados no están soportados por esta versión de servidor.
NOTA: hay restricciones de llave foránea circulares en la siguiente tabla:
NOTA: hay restricciones de llave foránea circulares entre las siguientes tablas:
Contraseña: Reporta errores a <pgsql-bugs@postgresql.org>.
Los snapshots sincronizados no están soportados por esta versión del servidor.
Ejecute con --no-synchronized-snapshots si no los necesita.
Los snapshots sincronizados no están soportados en servidores standby.
Ejecute con --no-synchronized-snapshots si no los necesita.
entrada TOC %s en %s (tamaño %s, suma de integridad %d)
La orden era: %s
%s necesita el programa «pg_dump», pero no fue encontrado en el mismo
directorio que «%s».
Verifique su instalación.
«pg_dump» fue encontrado por «%s»,
pero no es de la misma versión que %s.
Verifique su instalación.
Prueba «%s --help» para más información.
Empleo:
PRECAUCIÓN: la función de agregación «%s» no se pudo extraer correctamente
para esta versión de la base de datos; ignorada
PRECAUCIÓN: el archivador está comprimido, pero esta instalación no soporta
compresión -- no habrá datos disponibles
PRECAUCIÓN: elementos del archivo no están en el orden correcto de secciones
PRECAUCIÓN: el archivador fue hecho en una máquina con enteros más
grandes, algunas operaciones podrían fallar
PRECAUCIÓN: definición errónea de transformación; al menos uno de trffromsql and trftosql debe ser distinto de cero
PRECAUCIÓN: valor no válido en los campos pg_cast.castfunc o pg_cast.castmethod
PRECAUCIÓN: valor no válido en el campo pg_cast.castmethod
PRECAUCIÓN: valor erróneo en el campo pg_transform.trffromsql
PRECAUCIÓN: valor erróneo en el campo pg_transform.trftosql
PRECAUCIÓN: valor no válido en el arreglo proargmodes
PRECAUCIÓN: no se pudo encontrar el operador con OID %s
PRECAUCIÓN: no se pudo encontrar dónde insertar IF EXISTS en la sentencia «%s»
PRECAUCIÓN: no se pudo interpretar el arreglo proallargtypes
PRECAUCIÓN: no se pudo interpretar el arreglo proargmodes
PRECAUCIÓN: no se pudo interpretar el arreglo proargnames
PRECAUCIÓN: no se pudo interpretar el arreglo proconfig
PRECAUCIÓN: no se pudo interpretar el arreglo reloptions
PRECAUCIÓN: no se pudo resolver el bucle de dependencias entre los siguientes elementos:
PRECAUCIÓN: no se sabe cómo establecer el dueño para el objeto de tipo «%s»
PRECAUCIÓN: errores ignorados durante la recuperación: %d
PRECAUCIÓN: ftell no coincide con la posición esperada -- se usó ftell
PRECAUCIÓN: la fecha de creación en el encabezado no es válida
PRECAUCIÓN: el tipo «%c» para el método de acceso «%s» no es válido
PRECAUCIÓN: línea ignorada: %s
PRECAUCIÓN: el dueño de la función de agregación «%s» parece no ser válido
PRECAUCIÓN: el dueño del tipo «%s» parece no ser válido
PRECAUCIÓN: el dueño de la función «%s» parece no ser válido
PRECAUCIÓN: el dueño del operador «%s» parece no ser válido
PRECAUCIÓN: el dueño de la clase de operadores «%s» parece no ser válido
PRECAUCIÓN: el dueño de la familia de operadores «%s» parece no ser válido
PRECAUCIÓN: el dueño del esquema «%s» parece no ser válido
PRECAUCIÓN: el dueño de la tabla «%s» parece no ser válido
PRECAUCIÓN: la compresión solicitada no está soportada en esta
instalación -- el archivador no será comprimido
PRECAUCIÓN: el typtype del tipo «%s» parece no ser válido
PRECAUCIÓN: resultados extra inesperados durante el COPY de la tabla «%s»
Puede no ser capaz de restaurar el respaldo sin usar --disable-triggers o temporalmente eliminar las restricciones.
un proceso hijo murió inesperadamente
abortando debido a que no coincide la versión del servidor
el tamaño real del archivo (%s) no coincide con el esperado (%s)
reservando AH para %s, formato %d
ya está conectado a una base de datos
archiver archiver (bd) intentando comprobar el formato del archivador
dumpId incorrecto
dumpId de tabla incorrecto para elemento TABLE DATA
sólo se pueden reabrir archivos de entrada
no se puede duplicar un puntero nulo (error interno)
no se puede reestablecer desde un archivo comprimido (la compresión no está soportada en esta instalación)
el proceso hijo terminó con código de salida %d el proceso hijo terminó con código no reconocido %d el proceso hijo fue terminado por una excepción 0x%X el proceso hijo fue terminado por una señal %d el proceso hijo fue terminado por una señal %s la orden no es ejecutable orden no encontrada compress_io la compresión no está soportada por el formato de salida tar
nivel de compresión debe estar en el rango 0..9
compresor activo
conectandose a la base de datos "%s" como el usuario «%s»
conectando a la base de datos para reestablecimiento
conectando a nueva base de datos «%s»
la conexión necesita contraseña
falló la conexión a la base de datos «%s»: %s se encontró un encabezado corrupto en %s (esperado %d, calculado %d)
en la posición %s
no se pudo cambiar el directorio a «%s»: %s no se pudo cerrar el archivo TOC: %s
no se pudo cerrar el archivo del archivador: %s
no se pudo cerrar la biblioteca de compresión: %s
no se pudo cerrar el flujo comprimido: %s
no se pudo cerrar el archivo de datos «%s»: %s
no se pudo cerrar el directorio «%s»: %s
no se pudo cerrar el archivo de entrada: %s
no se pudo cerrar el archivo de la tabla de contenido de los objetos grandes «%s»: %s
no se pudo cerrar el archivo de salida: %s
no se pudo cerrar miembro del archivo tar
no se pudo abrir archivo temporal: %s
no se pudo terminar la transacción a la base de datos no se pudo comprimir datos: %s
no se pudo crear los canales de comunicación: %s
no se pudo crear el directorio «%s»: %s
no se pudo crear el objeto grande %u: %s no se pudo crear el proceso hijo: %s
no se pudo determinar la posición (seek) en el archivo del archivador: %s
no se pudo ejecutar la consulta no se pudo encontrar un «%s» para ejecutar no se pudo encontrar el bloque con ID %d en archivo -- posiblemente el archivo está corrupto
no se pudo encontrar el bloque con ID %d en archivo -- posiblemente debido a una petición de restauración fuera de orden, la que no puede ser satisfecha debido a la falta de información de posicionamiento en el archivo
no se pudo encontrar el bloque con ID %d en archivo -- posiblemente debido a una petición de restauración fuera de orden, la que no puede ser completada debido a que en el archivo de entrada no es reposicionable (seekable)
no se pudo encontrar una entrada para el ID %d
no se pudo encontrar el archivo «%s» en el archivador
no se encontró la definición de la función con OID %u
no se pudo encontrar el encabezado para el archivo «%s» en el archivo tar
no se pudo encontrar la extensión padre para %s %s
no se pudo localizar la entrada del proceso o hilo que terminó
no se pudo generar el nombre de archivo temporal: %s
no se pudo obtener server_version desde libpq
no se pudo identificar el directorio actual: %s no se pudo identificar bucle de dependencia
no se pudo inicializar la biblioteca de compresión: %s
no se pudo obtener un lock en la relación «%s»
Esto normalmente significa que alguien solicitó un lock ACCESS EXCLUSIVE en la tabla después de que el proceso pg_dump padre había obtenido el lock ACCESS SHARE en la tabla.
no se pudo abrir el archivo de tabla de contenido «%s» para leer: %s
no se pudo abrir el archivo de tabla de contenido «%s» para escribir: %s
no se pudo abrir el archivo TOC «%s»: %s
no se pudo abrir la tabla de contenido para leer: %s
no se pudo abrir la tabla de contenido para escribir: %s
no se pudo abrir el archivo de entrada «%s»: %s
no se pudo abrir el archivo de entrada: %s
no se pudo abrir el objeto grande %u: %s no se pudo abrir el archivo de la tabla de contenidos de objetos grandes «%s» para su lectura: %s
no se pudo abrir el archivo de salida «%s»: %s
no se pudo abrir el archivo de salida: %s
no se pudo abrir archivo temporal
no se pudo interpretar la lista de GRANT ACL (%s) o la lista de REVOKE ACL (%s) para el objeto «%s» (%s)
no se pudo interpretar la lista de ACL (%s)
no se pudo interpretar la lista inicial de GRANT ACL (%s) o la lista inicial de REVOKE ACL (%s) para el objeto «%s» (%s)
no se pudo interpretar el arreglo numérico «%s»: carácter no válido en número
no se pudo interpretar el arreglo numérico «%s»: demasiados números
no se pudo interpretar la salida de current_schemas()
no se pudo leer el binario «%s» no se pudo leer el directorio «%s»: %s
no se pudo leer el archivo de entrada: %s
no se pudo leer desde el archivo de entrada: fin de archivo
no se pudo leer el archivo de entrada: %s
no se pudo leer el enlace simbólico «%s» no se pudo hacer la reconexión a la base de datos: %s no se pudo establecer default_tablespace a %s: %s no se pudo definir default_with_oids: %s no se pudo establecer search_path a «%s»: %s no se pudo posicionar (seek) en el archivo del archivador: %s
no se pudo establecer el usuario de sesión a «%s»: %s no se pudo iniciar la transacción en la base de datos no se pudo descomprimir datos: %s
no se pudo escribir al archivo de la tabla de contenidos de objetos grandes
no se pudo escribir al objecto grande (resultado: %lu, esperado: %lu)
no se pudo escribir al archivo de salida: %s
no se pudo escribir al canal de comunicación: %s
creando %s «%s»
creando %s «%s.%s»
custom archiver la definición de la vista «%s» parece estar vacía (tamaño cero)
no se encontró la cadena mágica en el encabezado del archivo
las conexiones directas a la base de datos no están soportadas en
archivadores pre-1.3
el directorio «%s» no parece ser un archivador válido (no existe «toc.dat»)
directory archiver nombre de directorio demasiado largo: «%s»
deshabilitando disparadores (triggers) para %s
eliminando %s %s
extrayendo el contenido de la tabla «%s.%s»
habilitando disparadores (triggers) para %s
ingresando al bucle paralelo principal
ingresando restore_toc_entries_parallel
ingresando restore_toc_entries_postfork
ingresando restore_toc_entries_prefork
la entrada con ID %d está fuera de rango -- tal vez
la tabla de contenido está corrupta
error durante el volcado
error durante el posicionamiento (seek) en el archivo: %s
error procesando un elemento de trabajo en paralelo
error al leer el objeto grande %u: %s error al leer el archivo de la tabla de contenidos de objetos grandes «%s»
PQputCopyData regresó un error: %s PQputCopyEnd regresó un error: %s ejecutando %s %s
se esperaban %d restricciones CHECK en la tabla «%s» pero se encontraron %d
se esperaban %d restricciones CHECK en la tabla «%s» pero se encontraron %d
el formato esperado (%d) difiere del formato encontrado en el archivo (%d)
falló la revisión de integridad, el OID %u del padre de la tabla «%s»
(OID %u) no se encontró
falló la revisión de integridad: no se encontró la tabla padre OID %u del elemento con OID %u de pg_rewrite
falló la revisión de integridad: no se encontró la tabla padre OID %u de la secuencia con OID %u
falló la conexión a la base de datos
falló la reconexión a la base de datos
nombre de archivo demasiado largo: «%s»
el posición en el archivo es demasiado grande
buscando restricciones de revisión (check) para la tabla «%s.%s»
buscando expresiones por omisión de la tabla «%s.%s»
buscando tablas de extensión
buscando relaciones de herencia
buscando las columnas y tipos de la tabla «%s.%s»
terminó el elemento %d %s %s
terminó el bucle paralelo principal
marcando las columnas heredadas en las subtablas
se encontró un bloque no esperado ID (%d) mientras se leían los
datos -- se esperaba %d
función «%s» no encontrada
identificando miembros de extensión
asumiendo reestablecimiento de sólo datos
se encontró un encabezado incompleto (%lu byte)
se encontró un encabezado incompleto (%lu bytes)
índice «%s» no encontrado
el archivo de entrada parece ser un volcado de texto. Por favor use psql.
el archivo de entrada no parece ser un archivador válido
el archivo de entrada no parece ser un archivador válido (¿demasiado corto?)
el archivo de entrada es demasiado corto (leidos %lu, esperados 5)
error interno -- WriteData no puede ser llamada fuera del contexto
de una rutina DataDumper
error interno --- no se especificó th ni fh en tarReadRaw()
elemento ENCODING no válido: %s
OID no válido para objeto grande
el OID del objeto grande no es válido (%u)
elemento STDSTRINGS no válido: %s
el valor de adnum %d para la tabla «%s» no es válido
argumento de cadena (%s) no válido para el disparador (trigger) «%s» en la tabla «%s»
el binario «%s» no es válido la codificación de cliente especificada «%s» no es válida
el número de columna %d no es válido para la tabla «%s»
numeración de columnas no válida en la tabla «%s»
código de compresión no válido: %d
dependencia %d no válida
dumpId %d no válido
línea no válida en el archivo de la tabla de contenido de objetos grandes «%s»: «%s»
mensaje no válido recibido del proceso hijo: «%s»
número no válido de trabajos paralelos
el formato de salida especificado «%s» no es válido
la extracción de objetos grandes no está soportada en el formato
seleccionado
el último OID interno es %u
lanzando el elemento %d %s %s
falta un índice para restricción «%s»
moviendo desde la posición %s a la posición del siguiente miembro %s
ningún elemento listo
no se encontraron esquemas coincidentes
no se encontraron esquemas coincidentes para el patrón «%s»
no se encontraron tablas coincidentes
no se encontraron tablas coincidentes para el patrón «%s»
no se especificó un directorio de salida
no contiene soporte zlib
ahora en la posición del archivo %s
la opción --if-exists requiere la opción -c/--clean
las opciones --inserts/--column-inserts y -o/--oids no pueden usarse juntas
las opciones -c/--clean y -a/--data-only no pueden usarse juntas
las opciones -s/--schema-only y -a/--data-only no pueden usarse juntas
memoria agotada
elementos on_exit_nicely agotados
parallel archiver el volcado en paralelo sólo está soportado por el formato «directory»
la restauración en paralelo desde un archivo no posicionable no está soportada
la restauración en paralelo desde entrada estándar (stdin) no está soportada
la restauración en paralelo no está soportada con archivos construidos con pg_dump anterior a 8.0
la restauración en paralelo no está soportada con este formato de archivo
pclose falló: %s pgpipe: no se pudo aceptar la conexión: código de error %d
pgpipe: no se pudo enlazar: código de error %d
pgpipe: no se pudo conectar el socket: código de error %d
pgpipe: no se pudo crear el segundo socket: código de error %d
pgpipe: no se pudo crear el socket: código de error %d
pgpipe: no se pudo escuchar: código de error %d
pgpipe: getsockname() falló: código de error %d
procesando %s
procesando datos de la tabla «%s.%s»
procesando el elemento %d %s %s
procesando el elemento saltado %d %s %s
la consulta falló: %s la consulta produjo un nombre de tabla nulo para la llave foránea del
disparador "%s" en la tabla «%s» (OID de la tabla: %u)
la consulta regresó %d fila en lugar de una: %s
la consulta regresó %d filas en lugar de una: %s
la consulta para obtener los datos de la secuencia «%s» regresó %d entrada, pero se esperaba 1
la consulta para obtener los datos de la secuencia «%s» regresó %d entradas, pero se esperaba 1
la consulta para obtener los datos de la secuencia «%s» regresó el nombre «%s»
la consulta para obtener la regla «%s» asociada con la tabla «%s» falló: retornó un número incorrecto de renglones
la consulta para obtener la definición de la vista «%s» regresó más de una definición
la consulta para obtener la definición de la vista «%s» no regresó datos
la consulta era: %s
leyendo entrada de la tabla de contenidos %d (ID %d) para %s %s
leyendo la información de columnas para las tablas interesantes
leyendo las restricciones
leyendo los privilegios por omisión
obteniendo datos de dependencias
leyendo los disparadores por eventos
leyendo las extensiones
extrayendo restricciones de llave foránea para la tabla «%s.%s»
leyendo los índices
extrayendo los índices para la tabla «%s.%s»
leyendo objetos grandes
leyendo políticas
extrayendo las políticas para la tabla «%s.%s»
leyendo los lenguajes procedurales
leyendo las reglas de reescritura
leyendo si seguridad de filas está activa para la tabla «%s.%s»
leyendo esquemas
leyendo la información de herencia de las tablas
leyendo las transformaciones
leyendo los disparadores (triggers)
extrayendo los disparadores (triggers) para la tabla «%s.%s»
leyendo conversiones de tipo
leyendo los métodos de acceso definidos por el usuario
leyendo las funciones de agregación definidas por el usuario
leyendo los ordenamientos definidos por el usuario
leyendo las conversiones definidas por el usuario
leyendo los servidores foráneos definidas por el usuario
leyendo los conectores de datos externos definidos por el usuario
leyendo las funciones definidas por el usuario
leyendo las clases de operadores definidos por el usuario
leyendo las familias de operadores definidas por el usuario
leyendo los operadores definidos por el usuario
leyendo las tablas definidas por el usuario
leyendo las configuraciones de búsqueda en texto definidas por el usuario
leyendo los diccionarios de búsqueda en texto definidos por el usuario
leyendo los procesadores (parsers) de búsqueda en texto definidos
por el usuario
leyendo las plantillas de búsqueda en texto definidas por el usuario
leyendo los tipos definidos por el usuario
reduciendo las dependencias para %d
se reestableció %d objeto grande
se reestablecieron %d objetos grandes
la extracción de datos fuera de orden no está soportada en este formato:
se requiere «%s», pero viene antes de «%s» en el archivador.
reestableciendo objeto grande con OID %u
revisión de integridad en el tamaño del entero (%lu) falló
salvando las definiciones de la base de datos
salvando codificaciones = %s
salvando objetos grandes
salvando search_path = %s
salvando standard_conforming_strings = %s
esquema «%s» no encontrado
el esquema con OID %u no existe
select() fallida: %s
la versión del servidor debe ser al menos 7.3 para usar los parámetros de
selección de esquema
versión del servidor: %s; versión de %s: %s
saltando el elemento %d %s %s
saltando miembro del archivo tar %s
sorter la tabla «%s» no pudo ser creada, no se recuperarán sus datos
tabla «%s» no encontrada
tar archiver no se puede leer este formato
transferiendo la dependencia %d -> %d a %d
disparador «%s» no encontrado
sintaxis de sentencia COPY inesperada: «%s»
bandera de posición inesperada %d
tipo de orden inesperada en política: «%s»
código de sección %d inesperado
tgtype no esperado: %d
formato de archivo «%s» no reconocido; por favor especifique «c», «d» o «t»
orden no reconocida recibida del servidor: «%s»
tipo de restricción inesperado: %c
se encontró un bloque tipo %d no reconocido al restablecer el archivador
tipo de bloque de datos (%d) no conocido al buscar en el archivador
no se reconoce la codificación: «%s»
formato de archivo no reconocido «%d»
tipo de objeto desconocido en privilegios por omisión: %d
el valor del atributo «proparallel» para la función «%s» es desconocido
el valor del atributo «provolatile» para la función «%s» es desconocido
versión no soportada (%d.%d) en el encabezado del archivo
precaución desde el archivo original: %s
el proceso hijo falló: código de salida %d
se escribió %lu byte de los datos del objeto grande (resultado = %lu)
se escribieron %lu bytes de los datos del objeto grande (resultado = %lu)
locale/es/LC_MESSAGES/pgscripts-9.6.mo 0000644 00000065430 14751153421 0013077 0 ustar 00 �� � � � @ K A �
� > � > � = , - j � � C 0 A t � � # � ( I I f E � � > v ; � = � : / < j 9 � 6 � 5 C N C � 9 � 4 E E = � . � ; � E 4 : z ? � A � < 7 9 t 7 � 4 � L J h 3 � H � E 0 B v A � 5 � 2 1 N d 7 � 2 � 2 J Q : � 5 � G
0 U < � 0 � ) � M J l G � 4 � C 4! H x! E �! D " = L" v �" < # � ># Q �# I $ @ ^$ 5 �$ 4 �$ 1
% 0 <% ; m% 5 �% ' �% 6 & 3 >& 4 r& @ �& ; �& ; $' ` `' 8 �' 2 �' 9 -( 6 g( > �( �( / �( < ) # V) # z) ? �) 8 �) % * # =* a* 3 �* & �* �* E �* 6 )+ E `+ F �+ K �+ 7 9, K q, 7 �, J �, 6 @- < w- D �- 5 �- /. * M. 8 x. 6 �. ( �. 4 / $ F/ # k/ �/ �/ - �/ 8 �/ 4 70 $ l0 �0 , �0 , �0 ( 1 / 41 ; d1 9 �1 ! �1 �1 \ 2 n2 �2 * �2 8 �2 9 3 , =3 8 j3 # �3 4 �3 . �3 +4 ) H4 7 r4 �4
�4 �4 C �4 A &5 ! h5 + �5 �5 �5 �5 6 . 6 3 M6 2 �6 �6 �6 �6
�6 �6 7 $7 ' 97 " a7 2 �7 7 �7 �7 & �7 8 '8 / >8 + n8 * �8 �8 �8 �8 �8 �8 �8 9 9 ( &9 O9 Q9 � U9 ^ ); �; �; O �; O �; N M< 0 �< � �< L �= J �= 2> E> + f> " �> * �> �> L �> F F? � �? E %@ E k@ B �@ ? �@ 7 4A 7 lA 7 �A 6 �A O B H cB @ �B > �B 3 ,C 9 `C 8 �C @ �C J D A _D P �D M �D B @E < �E @ �E @ F y BF } �F ? :G E zG E �G E H D LH ? �H ? �H | I < �I ? �I ? J x KJ ? �J 4 K s 9K 6 �K F �K 6 +L 6 bL F �L F �L J 'M 1 rM F �M I �M I 5N H N B �N � O 8 �O � �O J kP H �P J �P F JQ 0 �Q 0 �Q / �Q 2 #R 8 VR 8 �R < �R 9 S @ ?S ] �S = �S = T � ZT C �T C #U 4 gU 4 �U I �U V < 'V L dV ' �V % �V D �V B DW + �W - �W " �W 9 X 4 >X sX b zX L �X b *Y b �Y ` �Y N QZ ` �Z N [ ^ P[ L �[ X �[ ` U\ J �\ ( ] ; *] N f] H �] 1 �] ? 0^ 1 p^ ) �^ / �^ 2 �^ 1 /_ E a_ E �_ + �_ + ` / E` * u` % �` 8 �` @ �` > @a + a �a l �a 3b ( Lb : ub M �b M �b = Lc M �c - �c 1 d ? 8d & xd 5 �d H �d e 5e " Ee f he l �e 0 <f 9 mf �f % �f & �f * g G 7g A g B �g
h h % h
?h Mh $ mh �h / �h % �h ; �h 8 ;i
ti + i �i �i 5 �i 3 j 0 4j ej gj
jj xj �j �j �j �j @ �j k k � � 9 � � t � � � I S � w & % � � � � G � � - . � � X � { � " � 7 � o � � < � � � L � 4 / K i u � J � ~ B m ( � � * �
n f H p � # D g @ ' > � � U � v � x [ � 3
N � � k ! � 8 , � Y F ; � � z � � Z � T � � 6 r M � + a 2 W � � $ ] _ � � } = s � j � � ? � ` � c | � l \ V � � � � � E ) : q � � Q C b 1 0 h A y � d R � ^ O � � � � � � � 5 � � � e P
By default, a database with the same name as the current user is created.
Connection options:
Options:
Read the description of the SQL command CLUSTER for details.
Read the description of the SQL command REINDEX for details.
Read the description of the SQL command VACUUM for details.
Report bugs to <pgsql-bugs@postgresql.org>.
--analyze-in-stages only update optimizer statistics, in multiple
stages for faster results; no vacuum
--lc-collate=LOCALE LC_COLLATE setting for the database
--lc-ctype=LOCALE LC_CTYPE setting for the database
%s [OPTION]...
%s [OPTION]... DBNAME
%s [OPTION]... LANGNAME [DBNAME]
%s [OPTION]... [DBNAME]
%s [OPTION]... [DBNAME] [DESCRIPTION]
%s [OPTION]... [ROLENAME]
--if-exists don't report error if database doesn't exist
--if-exists don't report error if user doesn't exist
--interactive prompt for missing role name and attributes rather
than using defaults
--maintenance-db=DBNAME alternate maintenance database
--maintenance-db=DBNAME alternate maintenance database
--no-replication role cannot initiate replication
--replication role can initiate replication
-?, --help show this help, then exit
-?, --help show this help, then exit
-?, --help show this help, then exit
-?, --help show this help, then exit
-D, --no-createdb role cannot create databases (default)
-D, --tablespace=TABLESPACE default tablespace for the database
-E, --encoding=ENCODING encoding for the database
-E, --encrypted encrypt stored password
-F, --freeze freeze row transaction information
-I, --no-inherit role does not inherit privileges
-L, --no-login role cannot login
-N, --unencrypted do not encrypt stored password
-O, --owner=OWNER database user to own the new database
-P, --pwprompt assign a password to new role
-R, --no-createrole role cannot create roles (default)
-S, --no-superuser role will not be superuser (default)
-S, --schema=SCHEMA reindex specific schema(s) only
-T, --template=TEMPLATE template database to copy
-U, --username=USERNAME user name to connect as
-U, --username=USERNAME user name to connect as
-U, --username=USERNAME user name to connect as (not the one to create)
-U, --username=USERNAME user name to connect as (not the one to drop)
-U, --username=USERNAME user name to connect as
-V, --version output version information, then exit
-V, --version output version information, then exit
-V, --version output version information, then exit
-V, --version output version information, then exit
-W, --password force password prompt
-W, --password force password prompt
-Z, --analyze-only only update optimizer statistics; no vacuum
-a, --all vacuum all databases
-a, --all cluster all databases
-a, --all reindex all databases
-c, --connection-limit=N connection limit for role (default: no limit)
-d, --createdb role can create new databases
-d, --dbname=DBNAME database to vacuum
-d, --dbname=DBNAME database from which to remove the language
-d, --dbname=DBNAME database to cluster
-d, --dbname=DBNAME database to install language in
-d, --dbname=DBNAME database to reindex
-d, --dbname=DBNAME database name
-e, --echo show the commands being sent to the server
-e, --echo show the commands being sent to the server
-e, --echo show the commands being sent to the server
-f, --full do full vacuuming
-g, --role=ROLE new role will be a member of this role
-h, --host=HOSTNAME database server host or socket directory
-h, --host=HOSTNAME database server host or socket directory
-h, --host=HOSTNAME database server host or socket directory
-i, --index=INDEX recreate specific index(es) only
-i, --inherit role inherits privileges of roles it is a
member of (default)
-i, --interactive prompt before deleting anything
-i, --interactive prompt before deleting anything, and prompt for
role name if not specified
-j, --jobs=NUM use this many concurrent connections to vacuum
-l, --list show a list of currently installed languages
-l, --locale=LOCALE locale settings for the database
-l, --login role can login (default)
-p, --port=PORT database server port
-p, --port=PORT database server port
-p, --port=PORT database server port
-q, --quiet don't write any messages
-q, --quiet don't write any messages
-q, --quiet run quietly
-r, --createrole role can create new roles
-s, --superuser role will be superuser
-s, --system reindex system catalogs
-t, --table='TABLE[(COLUMNS)]' vacuum specific table(s) only
-t, --table=TABLE cluster specific table(s) only
-t, --table=TABLE reindex specific table(s) only
-t, --timeout=SECS seconds to wait when attempting connection, 0 disables (default: %s)
-v, --verbose write a lot of output
-v, --verbose write a lot of output
-w, --no-password never prompt for password
-w, --no-password never prompt for password
-z, --analyze update optimizer statistics
%s (%s/%s) %s cleans and analyzes a PostgreSQL database.
%s clusters all previously clustered tables in a database.
%s creates a PostgreSQL database.
%s creates a new PostgreSQL role.
%s installs a procedural language into a PostgreSQL database.
%s issues a connection check to a PostgreSQL database.
%s reindexes a PostgreSQL database.
%s removes a PostgreSQL database.
%s removes a PostgreSQL role.
%s removes a procedural language from a database.
%s: "%s" is not a valid encoding name
%s: %s %s: cannot cluster all databases and a specific one at the same time
%s: cannot cluster specific table(s) in all databases
%s: cannot reindex all databases and a specific one at the same time
%s: cannot reindex all databases and system catalogs at the same time
%s: cannot reindex specific index(es) and system catalogs at the same time
%s: cannot reindex specific index(es) in all databases
%s: cannot reindex specific schema(s) and system catalogs at the same time
%s: cannot reindex specific schema(s) in all databases
%s: cannot reindex specific table(s) and system catalogs at the same time
%s: cannot reindex specific table(s) in all databases
%s: cannot use the "%s" option when performing only analyze
%s: cannot vacuum all databases and a specific one at the same time
%s: cannot vacuum specific table(s) in all databases
%s: clustering database "%s"
%s: clustering of database "%s" failed: %s %s: clustering of table "%s" in database "%s" failed: %s %s: comment creation failed (database was created): %s %s: could not connect to database %s: %s %s: could not connect to database %s: out of memory
%s: could not fetch default options
%s: creation of new role failed: %s %s: database creation failed: %s %s: database removal failed: %s %s: invalid value for --connection-limit: %s
%s: language "%s" is already installed in database "%s"
%s: language "%s" is not installed in database "%s"
%s: language installation failed: %s %s: language removal failed: %s %s: missing required argument database name
%s: missing required argument language name
%s: missing required argument role name
%s: number of parallel jobs must be at least 1
%s: only one of --locale and --lc-collate can be specified
%s: only one of --locale and --lc-ctype can be specified
%s: processing database "%s": %s
%s: query failed: %s %s: query returned %d row instead of one: %s
%s: query returned %d rows instead of one: %s
%s: query was: %s
%s: reindexing database "%s"
%s: reindexing of database "%s" failed: %s %s: reindexing of index "%s" in database "%s" failed: %s %s: reindexing of schema "%s" in database "%s" failed: %s %s: reindexing of system catalogs failed: %s %s: reindexing of table "%s" in database "%s" failed: %s %s: removal of role "%s" failed: %s %s: too many command-line arguments (first is "%s")
%s: too many jobs for this platform -- try %d
%s: vacuuming database "%s"
%s: vacuuming of database "%s" failed: %s %s: vacuuming of table "%s" in database "%s" failed: %s (%lu row) (%lu rows) Are you sure? Cancel request sent
Cannot add cell to table content: total cell count of %d exceeded.
Cannot add header to table content: column count of %d exceeded.
Could not send cancel request: %s Database "%s" will be permanently removed.
Enter it again: Enter name of role to add: Enter name of role to drop: Enter password for new role: Generating default (full) optimizer statistics Generating medium optimizer statistics (10 targets) Generating minimal optimizer statistics (1 target) Interrupted
Name Password encryption failed.
Password: Passwords didn't match.
Please answer "%s" or "%s".
Procedural Languages Role "%s" will be permanently removed.
Shall the new role be a superuser? Shall the new role be allowed to create databases? Shall the new role be allowed to create more new roles? Trusted? Try "%s --help" for more information.
Usage:
accepting connections
cannot duplicate null pointer (internal error)
could not look up effective user ID %ld: %s invalid output format (internal error): %d n no no attempt
no response
out of memory
rejecting connections
unknown
user does not exist user name lookup failure: error code %lu y yes Project-Id-Version: pgscripts (PostgreSQL 9.6)
Report-Msgid-Bugs-To: pgsql-bugs@postgresql.org
POT-Creation-Date: 2020-05-15 23:53+0000
PO-Revision-Date: 2019-09-29 23:05-0300
Last-Translator: Carlos Chapi <carlos.chapi@2ndquadrant.com>
Language-Team: Castellano <pgsql-es-ayuda@postgresql.org>
Language: es
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Plural-Forms: nplurals=2; plural=(n != 1);
X-Generator: Poedit 1.8.7
Si no se especifica, se creará una base de datos con el mismo nombre que
el usuario actual.
Opciones de conexión:
Opciones:
Lea la descripción de la orden CLUSTER de SQL para obtener mayores detalles.
Lea la descripción de la orden REINDEX de SQL para obtener mayores detalles.
Lea la descripción de la orden VACUUM de SQL para obtener mayores detalles.
Reporte errores a <pgsql-bugs@postgresql.org>.
--analyze-in-stages sólo actualizar las estadísticas del optimizador,
en múltiples etapas para resultados más rápidos;
no hacer vacuum
--lc-collate=LOCALE configuración LC_COLLATE para la base de datos
--lc-ctype=LOCALE configuración LC_CTYPE para la base de datos
%s [OPCIÓN]...
%s [OPCIÓN]... BASE-DE-DATOS
%s [OPCIÓN]... LENGUAJE [BASE-DE-DATOS]
%s [OPCIÓN]... [BASE-DE-DATOS]
%s [OPCIÓN]... [NOMBRE] [DESCRIPCIÓN]
%s [OPCIÓN]... [ROL]
--if-exists no reportar error si la base de datos no existe
--if-exists no reportar error si el usuario no existe
--interactive preguntar los nombres y atributos de rol faltantes
en lugar de asumir los valores por omisión
--maintenance-db=BASE base de datos de mantención alternativa
--maintenance-db=BASE base de datos de mantención alternativa
--no-replication el rol no podrá iniciar replicación
--replication el rol podrá iniciar replicación
-?, --help mostrar esta ayuda y salir
-?, --help mostrar esta ayuda y salir
-?, --help mostrar esta ayuda y salir
-?, --help mostrar esta ayuda y salir
-D, --no-createdb el rol no podrá crear bases de datos (predeterm.)
-D, --tablespace=TBLSPC tablespace por omisión de la base de datos
-E, --encoding=CODIF codificación para la base de datos
-E, --encrypted almacenar la constraseña cifrada
-F, --freeze usar «vacuum freeze»
-I, --no-inherit rol no heredará privilegios
-L, --no-login el rol no podrá conectarse
-N, --unencrypted almacenar la contraseña sin cifrar
-O, --owner=DUEÑO usuario que será dueño de la base de datos
-P, --pwprompt asignar una contraseña al nuevo rol
-R, --no-createrole el rol no podrá crear otros roles (predeterminado)
-S, --no-superuser el rol no será un superusuario (predeterminado)
-S, --schema=ESQUEMA reindexar sólo este o estos esquemas
-T, --template=PATRÓN base de datos patrón a copiar
-U, --username=USUARIO nombre de usuario para la conexión
-U, --username=USUARIO nombre de usuario para la conexión
-U, --username=NOMBRE nombre de usuario con el cual conectarse
(no el usuario a crear)
-U, --username=USUARIO nombre del usuario con el cual conectarse
(no el usuario a eliminar)
-U, --username=USUARIO nombre de usuario para la conexión
-V, --version mostrar información de versión y salir
-V, --version mostrar información de versión y salir
-V, --version mostrar información de versión y salir
-V, --version mostrar información de versión y salir
-W, --password forzar la petición de contraseña
-W, --password forzar la petición de contraseña
-Z, --analyze-only sólo actualizar las estadísticas del optimizador;
no hacer vacuum
-a, --all limpia todas las bases de datos
-a, --all reordenar todas las bases de datos
-a, --all reindexar todas las bases de datos
-c, --connection-limit=N límite de conexiones para el rol
(predeterminado: sin límite)
-d, --createdb el rol podrá crear bases de datos
-d, --dbname=BASE base de datos a limpiar
-d, --dbname=BASE nombre de la base de datos de la cual
eliminar el lenguaje
-d, --dbname=BASE base de datos a reordenar
-d, --dbname=BASE base de datos en que instalar el lenguaje
-d, --dbname=DBNAME base de datos a reindexar
-d, --dbname=DBNAME nombre de la base de datos
-e, --echo mostrar las órdenes enviadas al servidor
-e, --echo mostrar las órdenes enviadas al servidor
-e, --echo mostrar las órdenes a medida que se ejecutan
-f, --full usar «vacuum full»
-g, --role=ROL el nuevo rol será un miembro de este rol
-h, --host=ANFITRIÓN nombre del servidor o directorio del socket
-h, --host=ANFITRIÓN nombre del servidor o directorio del socket
-h, --host=ANFITRIÓN nombre del servidor o directorio del socket
-i, --index=INDEX recrear sólo este o estos índice(s)
-i, --inherit el rol heredará los privilegios de los roles de
los cuales es miembro (predeterminado)
-i, --interactive preguntar antes de eliminar
-i, --interactive preguntar antes de eliminar cualquier cosa, y
preguntar el nombre de rol si no se especifica
-j, --jobs=NUM usar esta cantidad de conexiones concurrentes
-l, --list listar los lenguajes instalados actualmente
-l, --locale=LOCALE configuración regional para la base de datos
-l, --login el rol podrá conectarse (predeterminado)
-p, --port=PUERTO puerto del servidor
-p, --port=PUERTO puerto del servidor
-p, --port=PUERTO puerto del servidor
-q, --quiet no desplegar mensajes
-q, --quiet no escribir ningún mensaje
-q, --quiet ejecutar de forma silenciosa
-r, --createrole el rol podrá crear otros roles
-s, --superuser el rol será un superusuario
-s, --system reindexa los catálogos del sistema
-t, --table='TABLA[(COLUMNAS)]'
limpiar sólo esta(s) tabla(s)
-t, --table=TABLA reordenar sólo esta(s) tabla(s)
-t, --table=TABLE reindexar sólo esta(s) tabla(s)
-t, --timeout=SEGUNDOS segundos a esperar al intentar conectarse
0 lo deshabilita (por omisión: %s)
-v, --verbose desplegar varios mensajes informativos
-v, --verbose desplegar varios mensajes informativos
-w, --no-password nunca pedir contraseña
-w, --no-password nunca pedir contraseña
-z, --analyze actualizar las estadísticas del optimizador
%s (%s/%s) %s limpia (VACUUM) y analiza una base de datos PostgreSQL.
%s reordena todas las tablas previamente reordenadas
en una base de datos.
%s crea una base de datos PostgreSQL.
%s crea un nuevo rol de PostgreSQL.
%s instala un lenguaje procedural en una base de datos PostgreSQL.
%s emite una prueba de conexión a una base de datos PostgreSQL.
%s reindexa una base de datos PostgreSQL.
%s elimina una base de datos de PostgreSQL.
%s elimina un rol de PostgreSQL.
%s elimina un lenguaje procedural de una base de datos.
%s: «%s» no es un nombre de codificación válido
%s: %s %s: no se pueden reordenar todas las bases de datos y una de ellas
en particular simultáneamente
%s: no es posible reordenar tablas específicas en todas las bases de datos
%s: no se pueden reindexar todas las bases de datos y una de ellas
en particular simultáneamente
%s: no se pueden reindexar todas las bases de datos y los catálogos
del sistema simultáneamente
%s: no es posible reindexar índices específicos y los catálogos
del sistema simultáneamente
%s: no es posible reindexar índices específicos en todas las bases de datos
%s: no es posible reindexar esquemas específicos y los catálogos
del sistema simultáneamente
%s: no es posible reindexar esquemas específicos en todas las bases de datos
%s: no es posible reindexar tablas específicas y los catálogos
del sistema simultáneamente
%s: no es posible reindexar tablas específicas en todas las bases de datos
%s: no se puede usar la opción «%s» cuando se está sólo
actualizando estadísticas
%s: no se pueden limpiar todas las bases de datos y una de ellas
en particular simultáneamente
%s: no es posible limpiar tablas específicas en todas
las bases de datos
%s: reordenando la base de datos «%s»
%s: falló el reordenamiento de la base de datos «%s»:
%s %s: falló el reordenamiento de la tabla «%s» en
la base de datos «%s»:
%s %s: falló la creación del comentario (la base de datos fue creada):
%s %s: no se pudo conectar a la base de datos %s: %s %s: no se pudo conectar a la base de datos %s: memoria agotada
%s: no se pudo extraer las opciones por omisión
%s: falló la creación del nuevo rol:
%s %s: falló la creación de la base de datos:
%s %s: falló la eliminación de la base de datos: %s %s: valor para --connection-limit no válido: %s
%s: el lenguaje «%s» ya está instalado en la base de datos «%s»
%s: el lenguaje «%s» no está instalado en la base de datos «%s»
%s: falló la instalación del lenguaje:
%s %s: falló la eliminación del lenguaje: %s %s: falta el nombre de base de datos requerido
%s: falta el nombre de lenguaje requerido
%s: falta el nombre de rol requerido
%s: número de trabajos en paralelo debe ser al menos 1
%s: sólo uno de --locale y --lc-collate puede ser especificado
%s: sólo uno de --locale y --lc-ctype puede ser especificado
%s: procesando la base de datos «%s»: %s
%s: la consulta falló: %s %s: la consulta retornó %d fila en lugar de una: %s
%s: la consulta retornó %d filas en lugar de una: %s
%s: la consulta era: %s
%s: reindexando la base de datos «%s»
%s: falló la reindexación de la base de datos «%s»: %s %s: falló la reindexación del índice «%s» en la base de datos «%s»: %s %s: falló la reindexación del esquema «%s» en la base de datos «%s»: %s %s: falló la reindexación de los catálogos del sistema: %s %s: falló la reindexación de la tabla «%s» en la base de datos «%s»: %s %s: falló la eliminación del rol «%s»:
%s %s: demasiados argumentos (el primero es «%s»)
%s: demasiados trabajos para esta plataforma -- intente con %d
%s: limpiando la base de datos «%s»
%s: falló la limpieza de la base de datos «%s»:
%s %s: falló la limpieza de la tabla «%s» en la base de datos «%s»:
%s (%lu fila) (%lu filas) ¿Está seguro? Petición de cancelación enviada
No se puede agregar una celda al contenido de la tabla: la cantidad de celdas de %d ha sido excedida.
No se puede agregar un encabezado al contenido de la tabla: la cantidad de columnas de %d ha sido excedida.
No se pudo enviar el paquete de cancelación: %s La base de datos «%s» será eliminada permanentemente.
Ingrésela nuevamente: Ingrese el nombre del rol a agregar: Ingrese el nombre del rol a eliminar: Ingrese la contraseña para el nuevo rol: Generando estadísticas predeterminadas (completas) para el optimizador Generando estadísticas medias para el optimizador (tamaño = 10) Generando estadísticas mínimas para el optimizador (tamaño = 1) Interrumpido
Nombre El cifrado de la contraseña falló.
Contraseña: Las contraseñas no coinciden.
Por favor conteste «%s» o «%s».
Lenguajes Procedurales El rol «%s» será eliminado permanentemente.
¿Será el nuevo rol un superusuario? ¿Debe permitírsele al rol la creación de bases de datos? ¿Debe permitírsele al rol la creación de otros roles? Confiable? Use «%s --help» para mayor información.
Empleo:
aceptando conexiones
no se puede duplicar un puntero nulo (error interno)
no se pudo buscar el ID de usuario efectivo %ld: %s formato de salida no válido (error interno): %d n no sin intentos
sin respuesta
memoria agotada
rechazando conexiones
desconocido
el usuario no existe fallo en la búsqueda de nombre de usuario: código de error %lu s sí locale/pl/LC_MESSAGES/pg_rewind-9.6.mo 0000644 00000047012 14751153421 0013037 0 ustar 00 �� � �
�
- �
1 �
? �
K 9 C � ; � C 9 I G � @ � O h � � � � � J � > 9 , x 6 � < � 1 ? K = � = � 9 4 A 9 v 4 � 2 � @ R Y > � � � 1 E W a { o � d - j 4 � & � � � P � R � c 5 - � � � / ; 4 p � # � � % � $ / + T $ � � $ � L � , 5 0 b " � ) � , �
$ + $ P # u ' � " � � " & % $ L q ( � � " � ' � & C b 2 � � ' � / 0 - ` � 6 � � ; � ) 4 ^ + { % � � � ! ! 3 "! 6 V! 1 �! �! ' �! < " _ C" �" �" ! �" F �" /# F# `# 1 z# C �# " �# . $ # B$ > f$ 6 �$ 3 �$ 6 % 0 G% x% + �% & �% �% & ! && ( H& I q& $ �& ' �& ' - %' J S' = �' A �' 6 ( 5 U( 5 �( ! �( 7 �( / ) 6 K) 1 �) - �) 9 �) � * C
, F Q, G �, P �, I 1- H {- E �- <
. G G. F �.
�. b �. D/ ^/ ( ~/ �/ �/ �/ D �/ N $0 9 s0 D �0 M �0 9 @1 @ z1 K �1 A 2 = I2 4 �2 F �2 E 3 B I3 Z �3 p �3 O X4
�4 ( �4 < �4 5 25 # :5 ^5 w 5 l �5 5 d6 C �6 3 �6 7 � -7 [ �7 ] %8 h �8 7 �8 - $9 ' R9 < z9 5 �9 �9 : ' !: $ I: / n: % �: & �: 5 �: + !; $ M; * r; S �; = �; A /< ' q< / �< 1 �< $ �< 2 = / S= / �= 3 �= % �= "
> $ 0> 2 U> % �> # �> 1 �> * ? - /? 3 ]? # �? # �? ' �? & @ D (@ + m@ ) �@ $ �@ 5 �@ < A ! [A ? }A �A I �A 7 $B \B 1 }B . �B �B " �B & C K CC J �C > �C ) D , CD O pD o �D ! 0E RE % aE R �E �E " �E F 6 2F @ iF & �F 1 �F ( G S ,G > �G ? �G < �G 7 <H % tH 8 �H , �H + I ' ,I % TI 0 zI N �I �I . J $ IJ = nJ Y �J ? K J FK H �K = �K A L * ZL L �L < �L C M 8 SM 8 �M D �M � % 4 � X { � � � Z � q o � L I | � � $ ; c T � 0 z x 9 � t - h E
e Q 5 � a � 7 j H ' k ^ p � � � ? 8 � s C " � � / # 2 � � � _ O g w � } ( � \
A v K D = f 1 ` P b r � . l > � : � R W u S * d y ] J � G M F 3 N i < � � Y & n + V , � � B @ ~ U [ ! ) 6 m �
Report bugs to <pgsql-bugs@postgresql.org>.
creating backup label and updating control file
--debug write a lot of debug messages
--source-pgdata=DIRECTORY source data directory to synchronize with
--source-server=CONNSTR source server to synchronize with
-?, --help show this help, then exit
-D, --target-pgdata=DIRECTORY existing data directory to modify
-P, --progress write progress messages
-V, --version output version information, then exit
-n, --dry-run stop before modifying anything
block %u
"%s" is a symbolic link, but symbolic links are not supported on this platform
"%s" is not a directory
"%s" is not a regular file
"%s" is not a symbolic link
%*s/%s kB (%d%%) copied %d: %X/%X - %X/%X
%s (%s)
%s resynchronizes a PostgreSQL cluster with another copy of the cluster.
%s: WARNING: cannot create restricted tokens on this platform
%s: could not allocate SIDs: error code %lu
%s: could not create restricted token: error code %lu
%s: could not get exit code from subprocess: error code %lu
%s: could not open process token: error code %lu
%s: could not re-execute with restricted token: error code %lu
%s: could not start process for command "%s": error code %lu
%s: no source specified (--source-pgdata or --source-server)
%s: no target data directory specified (--target-pgdata)
%s: too many command-line arguments (first is "%s")
BKPBLOCK_HAS_DATA not set, but data length is %u at %X/%X BKPBLOCK_HAS_DATA set, but no data included at %X/%X BKPBLOCK_SAME_REL set but no previous rel at %X/%X BKPIMAGE_HAS_HOLE not set, but hole offset %u length %u at %X/%X BKPIMAGE_HAS_HOLE set, but hole offset %u length %u block image length %u at %X/%X BKPIMAGE_IS_COMPRESSED set, but block image length %u at %X/%X Done!
Expected a numeric timeline ID.
Expected a transaction log switchpoint location.
Failure, exiting
Options:
Source timeline history:
Target timeline history:
The program "initdb" is needed by %s but was
not found in the same directory as "%s".
Check your installation.
The program "initdb" was found by "%s"
but was not the same version as %s.
Check your installation.
Timeline IDs must be in increasing sequence.
Timeline IDs must be less than child timeline's ID.
Try "%s --help" for more information.
Usage:
%s [OPTION]...
WAL file is from different database system: WAL file database system identifier is %s, pg_control database system identifier is %s WAL file is from different database system: incorrect XLOG_BLCKSZ in page header WAL file is from different database system: incorrect XLOG_SEG_SIZE in page header WAL record modifies a relation, but record type is not recognized
lsn: %X/%X, rmgr: %s, info: %02X
You must run %s as the PostgreSQL superuser.
backup label buffer too small
cannot be executed by "root"
cannot duplicate null pointer (internal error)
clusters are not compatible with this version of pg_rewind
connected to server
contrecord is requested by %X/%X could not close directory "%s": %s
could not close file "%s": %s
could not close target file "%s": %s
could not connect to server: %s could not create directory "%s": %s
could not create symbolic link at "%s": %s
could not create temporary table: %s could not fetch file list: %s could not fetch remote file "%s": %s could not find common ancestor of the source and target cluster's timelines
could not find previous WAL record at %X/%X
could not find previous WAL record at %X/%X: %s
could not open directory "%s": %s
could not open file "%s" for reading: %s
could not open file "%s" for truncation: %s
could not open file "%s": %s
could not open source file "%s": %s
could not open target file "%s": %s
could not read WAL record at %X/%X
could not read WAL record at %X/%X: %s
could not read directory "%s": %s
could not read file "%s": %s
could not read from file "%s": %s
could not read symbolic link "%s": %s
could not remove directory "%s": %s
could not remove file "%s": %s
could not remove symbolic link "%s": %s
could not seek in file "%s": %s
could not seek in source file: %s
could not seek in target file "%s": %s
could not send COPY data: %s could not send end-of-COPY: %s could not send file list: %s could not send query: %s could not set libpq connection to single row mode
could not stat file "%s": %s
could not truncate file "%s" to %u: %s
could not write file "%s": %s
data file "%s" in source is not a regular file
error running query (%s) in source server: %s fetched file "%s", length %d
full_page_writes must be enabled in the source server
getting file chunks
incorrect resource manager data checksum in record at %X/%X invalid action (CREATE) for regular file
invalid block_id %u at %X/%X invalid compressed image at %X/%X, block %d invalid contrecord length %u at %X/%X invalid control file invalid data in history file
invalid data in history file: %s
invalid info bits %04X in log segment %s, offset %u invalid magic number %04X in log segment %s, offset %u invalid record length at %X/%X: wanted %u, got %u invalid record offset at %X/%X invalid resource manager ID %u at %X/%X need to copy %lu MB (total source directory size is %lu MB)
neither BKPIMAGE_HAS_HOLE nor BKPIMAGE_IS_COMPRESSED set, but block image length is %u at %X/%X no rewind required
out of memory
out-of-order block_id %u at %X/%X out-of-sequence timeline ID %u (after %u) in log segment %s, offset %u reading WAL in target
reading source file list
reading target file list
received chunk for file "%s", offset %d, size %d
received null value for chunk for file "%s", file has been deleted
record length %u at %X/%X too long record with incorrect prev-link %X/%X at %X/%X record with invalid length at %X/%X rewinding from last common checkpoint at %X/%X on timeline %u
servers diverged at WAL position %X/%X on timeline %u
source and target cluster are on the same timeline
source and target clusters are from different systems
source data directory must be shut down cleanly
source file list is empty
source server must not be in recovery mode
symbolic link "%s" target is too long
sync of target directory failed
syncing target data directory
syntax error in history file: %s
target server must be shut down cleanly
target server needs to use either data checksums or "wal_log_hints = on"
there is no contrecord flag at %X/%X unexpected EOF while reading file "%s"
unexpected control file CRC
unexpected control file size %d, expected %d
unexpected data types in result set while fetching remote files: %u %u %u
unexpected null values in result while fetching remote files
unexpected page modification for directory or symbolic link "%s"
unexpected pageaddr %X/%X in log segment %s, offset %u unexpected result format while fetching remote files
unexpected result length while fetching remote files
unexpected result set from query
unexpected result set size while fetching remote files
unexpected result set while fetching file list
unexpected result set while fetching remote file "%s"
unexpected result while fetching remote files: %s unexpected result while sending file list: %s unrecognized result "%s" for current WAL insert location
Project-Id-Version: pg_rewind (PostgreSQL) 9.5
Report-Msgid-Bugs-To: pgsql-bugs@postgresql.org
POT-Creation-Date: 2016-07-03 03:14+0000
PO-Revision-Date: 2016-07-04 20:38+0200
Last-Translator: grzegorz <begina.felicysym@wp.eu>
Language-Team: begina.felicysym@wp.eu
Language: pl
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Plural-Forms: nplurals=3; plural=(n==1 ? 0 : n%10>=2 && n%10<=4 && (n%100<10 || n%100>=20) ? 1 : 2);
X-Generator: Virtaal 0.7.1
Błędy proszę przesyłać na adres <pgsql-bugs@postgresql.org>.
tworzenie etykiety kopii zapasowej i aktualizacja pliku sterującego
--debug wypisz masę komunikatów debugowania
--source-pgdata=FOLDER źródłowy folder danych do zsynchronizowania
--source-server=CONNSTR serwer źródłowy do zsynchronizowania
-?, --help pokaż tą pomoc i zakończ działanie
-D, --target-pgdata=FOLDER istniejący folder danych do zmiany
-P, --progress wypisz komunikaty postępu
-V, --version pokaż informacje o wersji i zakończ
-n, --dry-run zatrzymaj przed zmianą czegokolwiek
blok %u
"%s" jest dowiązaniem symbolicznym, ale linki symboliczne nie są obsługiwane na tej platformie
"%s" nie jest katalogiem
"%s" nie jest zwykłym plikiem
"%s" nie jest dowiązaniem symbolicznym
%*s/%s kB (%d%%) skopiowano %d: %X/%X - %X/%X
%s (%s)
%s resynchronizuje klaster PostgreSQL z inną kopią tego klastra.
%s: OSTRZEŻENIE nie można tworzyć ograniczonych tokenów na tej platformie
%s: nie udało się przydzielić SIDów: kod błędu %lu
%s: nie udało się utworzyć ograniczonego tokena: kod błędu %lu
%s: nie udało uzyskać kodu wyjścia z usługi podrzędnej: kod błędu %lu
%s: nie można otworzyć tokenu procesu: kod błędu %lu
%s: nie udało się ponownie wykonać ograniczonego tokena: %lu
%s: nie udało się uruchomić procesu dla polecenia "%s": kod błędu %lu
%s: nie wskazano źródła (--source-pgdata lub --source-server)
%s: nie wskazano docelowego folderu danych (--target-pgdata)
%s: za duża ilość parametrów (pierwszy to "%s")
BKPBLOCK_HAS_DATA nie jest ustawione, długość danych to %u na %X/%X BKPBLOCK_HAS_DATA jest ustawione, ale nie załączono danych na %X/%X BKPBLOCK_SAME_REL jest ustawione ale brak poprzedniej rel na %X/%X BKPIMAGE_HAS_HOLE nie jest ustawione, ale przesunięcie dziury %u o długości %u na %X/%X BKPIMAGE_HAS_HOLE jest ustawione, ale przesunięcie dziury %u długości %u blok obrazu o długości %u na %X/%X BKPIMAGE_IS_COMPRESSED jest ustawione, ale blok obrazu o długości %u na %X/%X Wykonano!
Oczekiwano numerycznego ID linii czasu.
Oczekiwano położenia przełączenia dziennika transakcji.
Niepowodzenie, wyjście
Opcje:
Historia źródłowej linii czasu:
Historia docelowej linii czasu:
Program "initdb" jest wymagany przez %s ale nie został
znaleziony w tym samym folderze co "%s".
Sprawdź instalację.
Program "initdb" został znaleziony przez "%s"
ale nie jest w tej samej wersji co %s.
Sprawdź instalację.
IDy linii czasu muszą być w kolejności rosnącej.
IDy linii czasu muszą być mniejsze niż ID potomnej linii czasu.
Użyj "%s --help" aby uzyskać więcej informacji.
Użycie:
%s [OPCJE]...
plik WAL pochodzi z innego systemu bazy danych: identyfikator systemu bazy danych z pliku WAL to %s, a identyfikator systemu bazy danych z pg_control to %s plik WAL pochodzi z innego systemu bazy danych: niepoprawny XLOG_BLCKSZ w nagłówku strony plik WAL pochodzi z innego systemu bazy danych: niepoprawny XLOG_SEG_SIZE w nagłówku strony rekord WAL zmienia relację, butale typ rekordu nie został rozpoznany
lsn: %X/%X, rmgr: %s, info: %02X
Musisz uruchomić %s jako superużytkownik PostgreSQL.
bufor etykiety kopii zapasowej jest za mały
nie może być wykonywane pod "rootem"
nie można powielić pustego wskazania (błąd wewnętrzny)
klastry nie są kompatybilne z tą wersją pg_rewind
połączono z serwerem
wymagany kontrekord w %X/%X nie można zamknąć katalogu "%s": %s
nie można zamknąć pliku "%s": %s
nie można zamknąć pliku docelowego "%s": %s
nie można połączyć z serwerem: %s nie można utworzyć folderu "%s": %s
nie można utworzyć linku symbolicznego na "%s": %s
nie można utworzyć tabeli tymczasowej: %s nie można pobrać listy plików: %s nie można pobrać pliku zdalnego "%s": %s nie można znaleźć wspólnego przodka źródłowej i docelowej osi czasu klastra
nie udało się odnaleźć poprzedniego rekordu WAL na %X/%X
nie udało się odnaleźć poprzedniego rekordu WAL na %X/%X: %s
nie można otworzyć katalogu "%s": %s
nie można otworzyć pliku "%s" do odczytu: %s
nie można otworzyć pliku "%s" do obcięcia: %s
nie można otworzyć pliku "%s": %s
nie można otworzyć pliku źródłowego "%s": %s
nie można otworzyć pliku docelowego "%s": %s
nie udało się odczytać rekordu WAL na %X/%X
nie udało się odczytać rekordu WAL na %X/%X: %s
nie można czytać katalogu "%s": %s
nie można czytać pliku "%s": %s
nie można czytać z pliku "%s": %s
nie można odczytać linku symbolicznego "%s": %s
nie można usunąć folderu "%s": %s
nie można usunąć pliku "%s": %s
nie można usunąć linku symbolicznego "%s": %s
nie można pozycjonować w pliku "%s": %s
nie można pozycjonować w pliku wyjścia %s
nie można przeszukiwać pliku docelowego "%s": %s
nie można wysłać danych COPY: %s nie można wysłać end-of-COPY: %s nie można przesłać listy plików: %s nie udało się wysłać zapytania: %s nie można ustalić połączenia libpq na tryb pojedynczego wiersza
nie można wykonać stat na pliku "%s": %s
nie można obciąć pliku "%s" do %u: %s
nie można pisać do pliku "%s": %s
plik danych źródła "%s" nie jest zwykłym plikiem
błąd wykonania zapytania (%s) na serwerze źródłowym: %s pobrano plik "%s", długość %d
full_page_writes musi być włączony na serwerze źródłowym
pobieranie kawałków pliku
niepoprawna suma kontrolna danych menadżera zasobów w rekordzie w %X/%X nieprawidłowe działanie (CREATE) dla zwykłego pliku
niepoprawny block_id %u na %X/%X niepoprawny skompresowany obraz na %X/%X, blok %d niepoprawna długość kontrekordu %u na %X/%X niepoprawny plik kontrolny niepoprawne dane w pliku historii
niepoprawne dane w pliku historii: %s
niepoprawny bity informacji %04X w segmencie dziennika %s, przesunięcie %u niepoprawny magiczny numer %04X w segmencie dziennika %s, przesunięcie %u niepoprawna długość rekordu w %X/%X: oczekiwana %u, jest %u niepoprawne przesunięcie rekordu w %X/%X niepoprawny ID menażera zasobów %u w %X/%X potrzeba skopiować %lu MB (pełna wielkość folderu źródłowego to %lu MB)
ani BKPIMAGE_HAS_HOLE ani BKPIMAGE_IS_COMPRESSED nie jest ustawione, ale długość bloku obrazu to %u na %X/%X przewinięcie nie jest konieczne
brak pamięci
poza porządkiem block_id %u na %X/%X nieoczekiwany ID linii czasu %u (po %u) w segmencie dziennika %s, przesunięcie %u odczyt WAL docelowy
odczyt źródłowej listy plików
odczyt docelowej listy plików
otrzymany kawałek pliku "%s", pozycja %d, rozmiar %d
otrzymano wartość null dla pliku "%s", plik został usunięty
za duża długość rekordu %u w %X/%X rekord z niepoprawnym poprz-linkiem %X/%X w %X/%X rekord o niepoprawnej długości w %X/%X przewinięcie do ostatniego zgodnego punktu kontrolnego na %X/%X linii czasowej %u
serwery rozeszły się na pozycji WAL %X/%X linii czasowej %u
klaster źródłowy i docelowy są na tej samej linii czasowej
klastry źródłowy i docelowy pochodzą z innych systemów
źródłowy folder danych musi być czysto wyłączony
źródłowa lista plików jest pusta
serwer źródłowy nie może być w trybie odzyskiwania
cel linku symbolicznego "%s" jest za długi
nie powiodło się sync folderu docelowego
docelowy katalog danych synchronizacji
błąd składni w pliku historii: %s
serwer docelowy musi zostać czysto wyłączony
serwer docelowy wymaga użycia albo sum kontrolnych albo "wal_log_hints = on"
brak flagi kontrekordu na %X/%X nieoczekiwany EOF podczas czytania pliku "%s"
nieoczekiwane CRC pliku kontrolnego
nieoczekiwana długość pliku kontrolnego %d, oczekiwano %d
nieoczekiwane typy danych w zbiorze wartości przy pobieraniu plików zdalnych: %u %u %u
nieoczekiwane wartości puste przy pobieraniu plików zdalnych
nieoczekiwana modyfikacja strony dla folderu lub linku symbolicznego "%s"
nieoczekiwany adrstrony %X/%X w segmencie dziennika %s, przesunięcie %u nieoczekiwany format wyniku przy pobieraniu plików zdalnych
nieoczekiwana długość wyniku przy pobieraniu plików zdalnych
nieoczekiwany zbiór wynikowy z zapytania
nieoczekiwana długość zbioru wynikowego przy pobieraniu plików zdalnych
nieoczekiwana zbiór wynikowy przy pobieraniu listy plików
nieoczekiwany zbiór wynikowy przy pobieraniu pliku zdalnego: "%s"
nieoczekiwany wynik przy pobieraniu plików zdalnych: %s nieoczekiwany wynik podczas wysyłania listy plików: %s nierozpoznany wynik "%s" dla bieżącego położenia wstawiania WAL
locale/pl/LC_MESSAGES/psql-9.6.mo 0000644 00000300130 14751153421 0012031 0 ustar 00 �� 9 �! � �C HZ IZ _Z sZ � �Z 4[ P[
i[ w[ > �[ = �[ < \ p B\ s �\ 5 '] 7 ]] K �] o �] 2 Q^ 4 �^ N �^ t _ Q }_ O �_ > ` A ^` O �` @ �` 6 1a 0 ha N �a G �a 8 0b A ib T �b ? c L @c A �c @ �c H d A Yd + �d � �d 5 ]e 9 �e n �e Q <f : �f � �f ; Vg y �g � h ; �h z �h T _i A �i L �i B Cj \ �j 4 �j J k \ ck 6 �k 4 �k G ,l = tl ; �l ( �l ; m ; Sm ; �m ; �m 8 n _ @n J �n F �n ` 2o h �o G �o 5 Dp 2 zp X �p Q q : Xq 3 �q ; �q S r M Wr 9 �r @ �r 8 s ; Ys @ �s K �s J "t | mt � �t > pu F �u N �u F Ev H �v - �v $ w & (w - Ow 9 }w 7 �w 2 �w 4 "x 3 Wx ) �x ) �x ; �x B y ) ^y * �y * �y J �y 1 )z . [z - �z , �z 4 �z I { $ d{ & �{ > �{ 1 �{ & !| ( H| J q| : �| ( �| % } $ F} $ k} ) �} - �} N �} 9 7~ G q~ 5 �~ M �~ C = P � K � N � K m� L �� 4 � K ;� ( �� q �� A "� ? d� A �� > � X %� # ~� F �� 8 � < "� M _� ; �� 6 � 2 � 7 S� B �� : Ά 4 � 9 >� ? x� % �� + އ 9
� 5 D� I z� K Ĉ M � Z ^� S �� K
� � Y� N � @ 3� : t� ( �� B ؋ L � C h� � �� M [� = �� � � �� �� �� �� ώ ӎ � �� 0 �� $ 0� # U� * y� % �� * ʏ �� # � < :� w� �� �� 6 ː � � � : �� ��
� � #� 8� B� S� f� x� Q �� ܒ I � [ :�
�� �� ��
Ǔ ғ � C �� A A� �� �� �� �� �� �� Ŕ , ה � � '� 1� =� C� L� f� ~� ��
�� �� �� �� ' Ε �� & � ' ;� 7 c� 0 �� ̖ � �� � #� ,� 4� =� e G� �� �� ӗ ٗ � ( � 5� A� J� d� �� �� �� ǘ Ә ܘ � �� � � #�
+� 9� ?� B� L�
R� `� i� x� �� �� ��
�� ��
Й & ݙ �
�
�
*� 8� ?� R� i�
�� �� �� �� ͚ ߚ � � � 5� S� e� �� �� ��
�� ƛ ֛ % �
� " !� D� e� �� �� ' �� & ݜ �
� '� 1� 8� A� K�
P� [� L j� �� Ɲ � > � @� U� i� 2 �� �� �� ͞ � ��
� � +� 8� >� U� u� X �� � � � �
6� A� Z� ' c� . �� ! �� ' ܠ � � (�
2� @� W� u� �� �� С ߡ � , �� )� :� F� U� Z� d� y� �� E �� � � �� � � � %� *� 1� =� I� b� n� {� �� �� �� ��
�� �� ݣ
�� � � � #� 8� P� Y� ! x� �� �� 9 ͤ y � 9 �� F �� 5 � B 8� C {� 5 �� : �� 9 0� @ j� ; �� K � B 3� C v� 6 �� 8 � *� F� U�
d� r� �� ��
�� �� �� ߩ �� � "� & *� Q� f� z� � � �� U� # m� # �� # �� ٫ " � � *� 2� I� S� ]�
c� n� v� ��
�� c �� � � ĭ K � Q -� / � O �� U �� 5 U� = �� ɯ , կ 4 � " 7� ! Z� |� �� �� İ " � + � + /� 6 [� X �� 7 � 8 #� T \� 5 �� I � 6 1� # h� = �� = ʳ = � i F� 9 �� � � * &� Q� m� �� �� �� ŵ ɵ ص � � �� �
� � :� # Y� }� �� $ �� ϶
� � �� �
� � �
#� 1� ;� E� T� e� o� w� }� C �� η / ߷ ( � 8� K� T� f� }� ' �� �� $ � % � ! +� ) M� ( w� / �� # й ' � , � . I� 4 x� �� ! ͺ - � � % >� 4 d� 1 �� - ˻ / �� " )� L� ' l� �� . �� ) � %
� ! 3� $ U� * z� + �� A ѽ � � & ,� 0 S� . �� ) �� ) ݾ � % � <�
A�
L� W� # a� �� �� �� �� ¿ ο տ � � � C � V� u� �� �� �� �� � �
�� � $ � & 6� - ]� # �� �� 1 � ( � ) +� + U� ' �� ! �� �� # �� !
� ( ,� U� r� �� �� �� �� �� � � (�
2� @� `�
h� s� �� �� �� �� �� �� � &� :� [� v� �� ! �� �� �� 2 �� +� J� `� |� �� �� 2 �� 5 � =� Q� q� . �� �� & �� # �� � ! 6� X� o� �� �� �� 6 �� ) � 1�
9� D� K� b� l� ��
�� & �� �� �� �� �� �� � � )� 5� =� \� d�
m� {� U �� �� �� �� , � 2� O� o� ~� ��
�� �� �� �� �� �� �� �� " �
(� 6� B� L� V� m� v�
�� 1 �� �� ��
�� � � (� . :� i� . s�
�� �� �� �� �� ��
�� �� E � R�
b� p� �� �� �� �� �� �� �� �� �� * � @�
H� S� _� n� x� �� �� ��
�� �� �� �� �� �� �� �� � � :� G� T� [� h� q� v� ��
�� �� �� �� �� �� % �� �� �� � !� &� -� @� P� d� s� �� �� ��
�� �� �� �� �� �� �� �� � � � #� /� 3� B� K� W� Z� b� j� s� ��
�� �� ��
�� �� �� �� �� � � � '� 0� 8� J� V� h� r� ! |� 4 ��
�� �� . �� � *� 0� @� P� a� k� ��
��
��
�� �� �� �� �� � � " '� J� a� � �� �� �� / �� � � 1� @� " T� w� �� �� �� �� * ��
� .� G� _� |� �� �� �� �� �� 0 �� + /� [� c� l� > t�
�� �� ) �� " �� � �
1� <� F� Y� r� w� �� �� �� �� �� �� ��
�� ��
��
�� �� � � 7 #� 2 [� 6 �� V �� � & "� & I� . p� �� �� ��
��
�� �� �� � � � � &� @� O� _� o� ! y� �� �� �� ��
�� �� �� �� � . !� P� V� g� x�
�� �� �� �� �� �� �� �� �� ��
� � *� ;� C� P� i� n� �� �� �� �� $ �� # �� � (� 0 0� a� h� �� �� �� ( �� �� ��
�� � � $� *� 1� 9� >� U� f� x� , �� �� �� �� $ � %� ' :� b� }� �� �� �� �� �� ! � B� I� [�
g� r� �� � �� r� �� �� � �� p� ��
�� �� D �� ? � C T� ~ �� v � ? �� E �� Y � n� 5 �� Y $� X ~� � �� R b� _ �� o � A �� V �� B � 4 a� D �� T �� P 0� > �� @ �� \ � C ^� S �� M �� K D� U �� P �� 1 7� � i� 4 � D I� x �� i � > q� � �� = M� � �� � "� ? �� � � Y �� F �� I A� G �� ^ � 9 2� X l� i � L /� @ |� G �� = � ; C� ( � 7 �� ; � ; � : X� 6 �� h � V 3� I �� g � f <� J �� < � : +� ^ f� M � = � 1 Q� C �� X � [ � O |� F � L Q ` E � [ � Z T � � � 2 : � J � M G P � U � 1 < , n ( � - � F � C 9 E } @ � 6 - ; - i < � G � * 4 G + | X � 7 . 9 4 h 8 � : � N & ` ) � E � 9 � * 1
+ \
p �
C �
+ = ( i & � ( � . � 5 R G J � d � @ J
^ �
e �
} P V � ^ % P � [ � 4 1 U f - � y � S d ? � J � O C a � ) � z I � G � � , \ � 5 4 A @ v H � K ; L : � J � ( ) 7 A a : � S � U 2 R � _ � Y ; P � � � X � L � G * 1 r N � Z � Q N � � L X N � � � � . � � � � � 7 ' & _ & � 0 � / � / ! & >! , e! J �! # �! " " H 4" ( }" � �" B P# �#
�# �# �#
�# �# �# $ *$ p ?$ �$ F �$ V % f% o% �%
�% + �% �% S �% S :& �& �& �& �& �& �& �& / ' 1'
G'
U'
`' n' t' �' # �' " �' �' �' �' ( ( 4 ( & D( . k( ) �( C �( > ) # G) k) �) $ �) �)
�) �) �) } �) k* �* �* , �* + �* 8 �* 8+
B+ M+ ! j+ �+ �+ �+
�+ �+ �+ �+ , ", :, P, W, i,
p,
~, �, �, �,
�,
�, �, �, �, �, - -
%- : 0- k- r-
�- �- �- �- �- �- �- �- . . 3. D. P. j. �. �.
�. ! �. �. �.
/
/ / ./ ) >/ h/ * �/ ) �/ ' �/ ( �/ &0 A B0 @ �0 �0 �0 �0 �0 �0
1 1 1 '1 \ 81 �1 $ �1 & �1 N �1 B2 [2 v2 < �2 �2 �2 �2 �2 3 %3 +3 C3 T3 a3 4 �3 " �3 � �3 �4 % �4 �4 �4 �4 �4 5 9 5 @ Y5 / �5 5 �5 6 "
6 -6 76 H6 & d6 ! �6 & �6 & �6 �6
7
$7 B /7 r7
�7 �7 �7
�7 �7 ' �7 �7 K �7 E8 V8 ^8 m8 8
�8 �8 �8 �8 �8 �8 �8
�8 9 9 9 (9 =9 D9 S9 # m9 �9 �9 �9 �9 �9 �9 : ) : , >: # k: & �: ; �: � �: 2 z; A �; . �; < < = [< / �< 4 �< 0 �< ; /= D k= I �= C �= D >> 5 �> E �> �> ? +? E? ^? o? �? �? �? % �? �? * �? *@ 6@ 6 >@ u@ �@ �@ ! �@ � �@ �A * �A % �A ) B HB + eB �B �B �B �B �B �B �B C
C C .C x :C � �C " �D b �D f !E 0 �E b �E g F G �F 6 �F G . G 1 EG ( wG * �G " �G �G �G H & ;H 0 bH 2 �H ; �H f I : iI @ �I \ �I : BJ L }J 0 �J # �J F K H fK K �K o �K : kL �L $ �L 1 �L * M CM & cM �M �M �M �M �M �M �M
�M �M �M �M ! N - 5N cN wN - �N �N �N �N �N �N �N O
O
O !O +O 3O BO
QO \O dO xO H �O �O < �O , -P ZP mP wP �P �P % �P ( �P Q 5Q RQ ! lQ �Q + �Q �Q " �Q , R * ER ? pR �R �R ' �R S $ )S 7 NS 4 �S 6 �S 3 �S &T DT ) \T �T ' �T ' �T �T U +U " HU $ kU W �U �U �U 0 V ; 1V 5 mV 3 �V 2 �V
W $ W =W
AW OW ^W & jW
�W �W �W
�W �W �W �W �W �W X M 0X # ~X �X �X �X �X �X ! �X Y 'Y 4Y & GY ( nY ; �Y ' �Y �Y @ Z 2 ]Z / �Z > �Z 1 �Z . 1[ # `[ ( �[ 3 �[ / �[ " \ 4\ # S\ + w\ $ �\ �\ �\ �\
]
] ] 1]
Q]
\] j] ] �] % �] �] �] ^ ! &^ H^ ) `^ " �^ �^ �^ ' �^ _ '_ 7 =_ % u_ �_ �_ " �_ " �_ $ ` H ?` . �` �` " �` �` , a ! 6a 5 Xa / �a 1 �a . �a b >b Wb lb ( �b C �b ' �b c -c 7c =c Tc `c rc c * �c �c �c �c �c �c �c d d -d # 5d
Yd dd nd ~d ] �d
�d �d e . e Je ke �e �e �e
�e �e
�e �e f f f %f - 8f ff
rf �f �f �f �f �f
�f 7 �f g +g <g Hg [g kg 5 �g
�g * �g �g �g h h h 1h
Eh Sh D eh �h �h �h �h �h i i 'i 9i Pi ii �i 4 �i �i
�i �i j j .j >j
Gj Rj
fj qj zj �j �j
�j �j �j �j - �j k ,k <k Hk Xk ek jk
�k �k �k �k �k �k �k , �k l l l 0l 6l =l Ql dl
|l �l
�l �l �l �l �l �l �l �l m ' m Am Im Rm fm
om }m �m
�m �m
�m �m �m �m �m �m �m n n
!n /n >n Rn cn rn {n �n �n �n �n �n �n
�n �n $ o ? +o ko |o 0 �o �o �o �o �o �o
p p (p
2p @p Op `p rp �p �p �p
�p �p �p q q /q Lq fq < �q
�q �q
�q �q + r & /r ( Vr % r �r �r / �r �r s !s 8s Xs rs �s �s �s �s G �s / t It Qt Zt 8 bt �t �t 0 �t % �t u u 6u
@u Ku ]u xu
�u
�u �u �u �u �u �u �u �u v v
v
*v 8v Dv J Sv - �v A �v d w sw " yw , �w 4 �w
�w x x 8x Lx cx wx �x �x �x �x �x �x �x �x
y & y 8y @y Xy ky
{y �y �y �y �y G �y z z 1z ' Ez mz zz �z
�z �z �z �z �z �z �z
{
{ { .{ 8{ " I{ l{ % p{ $ �{
�{ �{ ! �{ % �{ % | 8| I| 6 R|
�| # �| �| �| �| > �| 9} L}
]}
k} y} �} �} �} �} �} �} �} ~ < ~ F~ ^~ x~ ( �~ �~ - �~ $ $ * ! O q � � * � ! � � �
-�
8� C� T� m I � � � � � � � � ' A 5 � L & " � � Z h c ' � � � $ � � � k � 7 + � � � � � . t � � �
x � Q p : � v � { � � z � � � � d y � � K 1 Z � �
b h ( � @ � � 9 % � � � ( N 5 � 8 � % � S � � 2 � � / r � � > X s � . � � � r � - , � � � � H r | p � F n P � � � � � M 3 � C � Q � � O � w � a � � � D u ] k � � � � M � * � \ R � X a ) 3 ^ � � � � w � � � m ; � � � � Z � , - � �
� 5 � x h 3 � z $ � < � U k � � � � e � � V ( � [ � e w � } � ' � � ! p � � � T � t / V Y � E � ` 1 � � � # � j K � � 8 � � � / � 1 * ] W � q � # � s B � F e T v S � � � � H c � 6 Y Q � 6 � � � i c � � � � � � � � - 2 ~ � � � 0 � � � ~ M o � � � i a h � ~ � � � � � � � � � L � � � 9 o u � � � o ; � � Q , � � ' � � � � � � g � 7 > K & � � ` � y v � � � S x E � E � � � � � � Y � � � ? � � � � � } � � � � � u i 7 = C � 2 � � � l � X � � 5 � r � � � � ! � ? u t � t J _ � � � � � p W � 9 � � � � f g � � 8 0 � � * � � g � � � F � � � � � z � n I � [ � � � � � _ < L
C X f B l �
� � o � � 7 H � � 3 � . � � � � O { , " � � � D � � & � y W � L � � � l � � � q � f ! � � � � [ � � � � G / G 2 � �
N � � � � � � i � � � � � / � � T
4 P � � ` N M U m � I � � 9 � s � & m . � � V f @ � _ : 5 : R @ F � I } \ � � R � � � � 6 � � b C � � ~ = � � 0 3 � � � < � � � P % ) � n $ A w � J # � � � � z : � | ] � ! > � � 9 A D � � � � � 6 S % � � k $ � � \ � � � � � � � ; + n � � � U � ? � � � ] ^ O �
' U D \ j v � � � � � � K � � � � � � � @ � � l ! � � � � � ^ � � { N E W 0 a � � } d = � � � � e | " y � � # B � � � � � � � " * ) G > q % � + ) � � � 8 � � � � � �
b � < � + � H 4 Z [ � ; � $ � | � � B - � q ? � � � � � � ` 1 � � - & � � � 0 � s 7 � � b � � � � � . " J � d � � � � � � � � 2 � � = # � ( � � � 4 � j � � 1 � � � � � 8 � � � � , � T � � � � ( � � � � � � 6 � J * � � j � � � � g � R ^ � � _ � � V 4 O � G { � � P � A c ) Y � � � x � � � � � + � � � 4 d
Connection options:
Display settings:
Environment variables:
For more information, type "\?" (for internal commands) or "\help" (for SQL
commands) from within psql, or consult the psql section in the PostgreSQL
documentation.
Input and output options:
Output format options:
Parser: "%s"
Parser: "%s.%s" --help=commands list backslash commands, then exit
--help=variables list special variables, then exit
(options: S = show system objects, + = additional detail)
-0, --record-separator-zero
set record separator for unaligned output to zero byte
-1 ("one"), --single-transaction
execute as a single transaction (if non-interactive)
-?, --help[=options] show this help, then exit
-A, --no-align unaligned table output mode
-E, --echo-hidden display queries that internal commands generate
-F, --field-separator=STRING
field separator for unaligned output (default: "%s")
-H, --html HTML table output mode
-L, --log-file=FILENAME send session log to file
-P, --pset=VAR[=ARG] set printing option VAR to ARG (see \pset command)
-R, --record-separator=STRING
record separator for unaligned output (default: newline)
-S, --single-line single-line mode (end of line terminates SQL command)
-T, --table-attr=TEXT set HTML table tag attributes (e.g., width, border)
-U, --username=USERNAME database user name (default: "%s")
-V, --version output version information, then exit
-W, --password force password prompt (should happen automatically)
-X, --no-psqlrc do not read startup file (~/.psqlrc)
-a, --echo-all echo all input from script
-b, --echo-errors echo failed commands
-c, --command=COMMAND run only single command (SQL or internal) and exit
-d, --dbname=DBNAME database name to connect to (default: "%s")
-e, --echo-queries echo commands sent to server
-f, --file=FILENAME execute commands from file, then exit
-h, --host=HOSTNAME database server host or socket directory (default: "%s")
-l, --list list available databases, then exit
-n, --no-readline disable enhanced command line editing (readline)
-o, --output=FILENAME send query results to file (or |pipe)
-p, --port=PORT database server port (default: "%s")
-q, --quiet run quietly (no messages, only query output)
-s, --single-step single-step mode (confirm each query)
-t, --tuples-only print rows only
-v, --set=, --variable=NAME=VALUE
set psql variable NAME to VALUE
(e.g., -v ON_ERROR_STOP=1)
-w, --no-password never prompt for password
-x, --expanded turn on expanded table output
-z, --field-separator-zero
set field separator for unaligned output to zero byte
AUTOCOMMIT if set, successful SQL commands are automatically committed
COLUMNS number of columns for wrapped format
COMP_KEYWORD_CASE determines the case used to complete SQL key words
[lower, upper, preserve-lower, preserve-upper]
DBNAME the currently connected database name
ECHO controls what input is written to standard output
[all, errors, none, queries]
ECHO_HIDDEN if set, display internal queries executed by backslash commands;
if set to "noexec", just show without execution
ENCODING current client character set encoding
FETCH_COUNT the number of result rows to fetch and display at a time
(default: 0=unlimited)
HISTCONTROL controls command history [ignorespace, ignoredups, ignoreboth]
HISTFILE file name used to store the command history
HISTSIZE the number of commands to store in the command history
HOST the currently connected database server host
IGNOREEOF if unset, sending an EOF to interactive session terminates application
LASTOID value of the last affected OID
NAME=VALUE [NAME=VALUE] psql ...
or \setenv NAME [VALUE] inside psql
ON_ERROR_ROLLBACK if set, an error doesn't stop a transaction (uses implicit savepoints)
ON_ERROR_STOP stop batch execution after error
PAGER name of external pager program
PGAPPNAME same as the application_name connection parameter
PGDATABASE same as the dbname connection parameter
PGHOST same as the host connection parameter
PGPASSFILE password file name
PGPASSWORD connection password (not recommended)
PGPORT same as the port connection parameter
PGUSER same as the user connection parameter
PORT server port of the current connection
PROMPT1 specifies the standard psql prompt
PROMPT2 specifies the prompt used when a statement continues from a previous line
PROMPT3 specifies the prompt used during COPY ... FROM STDIN
PSQLRC alternative location for the user's .psqlrc file
PSQL_EDITOR, EDITOR, VISUAL
editor used by the \e, \ef, and \ev commands
PSQL_EDITOR_LINENUMBER_ARG
how to specify a line number when invoking the editor
PSQL_HISTORY alternative location for the command history file
QUIET run quietly (same as -q option)
SHELL shell used by the \! command
SHOW_CONTEXT controls display of message context fields [never, errors, always]
SINGLELINE end of line terminates SQL command mode (same as -S option)
SINGLESTEP single-step mode (same as -s option)
TMPDIR directory for temporary files
USER the currently connected database user
VERBOSITY controls verbosity of error reports [default, verbose, terse]
\! [COMMAND] execute command in shell or start interactive shell
\? [commands] show help on backslash commands
\? options show help on psql command-line options
\? variables show help on special variables
\C [STRING] set table title, or unset if none
\H toggle HTML output mode (currently %s)
\T [STRING] set HTML <table> tag attributes, or unset if none
\a toggle between unaligned and aligned output mode
\c[onnect] {[DBNAME|- USER|- HOST|- PORT|-] | conninfo}
connect to new database (currently "%s")
\c[onnect] {[DBNAME|- USER|- HOST|- PORT|-] | conninfo}
connect to new database (currently no connection)
\cd [DIR] change the current working directory
\conninfo display information about current connection
\copy ... perform SQL COPY with data stream to the client host
\copyright show PostgreSQL usage and distribution terms
\crosstabview [COLUMNS] execute query and display results in crosstab
\dA[+] [PATTERN] list access methods
\dC[+] [PATTERN] list casts
\dD[S+] [PATTERN] list domains
\dE[S+] [PATTERN] list foreign tables
\dF[+] [PATTERN] list text search configurations
\dFd[+] [PATTERN] list text search dictionaries
\dFp[+] [PATTERN] list text search parsers
\dFt[+] [PATTERN] list text search templates
\dL[S+] [PATTERN] list procedural languages
\dO[S+] [PATTERN] list collations
\dT[S+] [PATTERN] list data types
\d[S+] list tables, views, and sequences
\d[S+] NAME describe table, view, sequence, or index
\da[S] [PATTERN] list aggregates
\db[+] [PATTERN] list tablespaces
\dc[S+] [PATTERN] list conversions
\dd[S] [PATTERN] show object descriptions not displayed elsewhere
\ddp [PATTERN] list default privileges
\des[+] [PATTERN] list foreign servers
\det[+] [PATTERN] list foreign tables
\deu[+] [PATTERN] list user mappings
\dew[+] [PATTERN] list foreign-data wrappers
\df[antw][S+] [PATRN] list [only agg/normal/trigger/window] functions
\dg[S+] [PATTERN] list roles
\di[S+] [PATTERN] list indexes
\dl list large objects, same as \lo_list
\dm[S+] [PATTERN] list materialized views
\dn[S+] [PATTERN] list schemas
\do[S] [PATTERN] list operators
\dp [PATTERN] list table, view, and sequence access privileges
\drds [PATRN1 [PATRN2]] list per-database role settings
\ds[S+] [PATTERN] list sequences
\dt[S+] [PATTERN] list tables
\du[S+] [PATTERN] list roles
\dv[S+] [PATTERN] list views
\dx[+] [PATTERN] list extensions
\dy [PATTERN] list event triggers
\e [FILE] [LINE] edit the query buffer (or file) with external editor
\echo [STRING] write string to standard output
\ef [FUNCNAME [LINE]] edit function definition with external editor
\encoding [ENCODING] show or set client encoding
\errverbose show most recent error message at maximum verbosity
\ev [VIEWNAME [LINE]] edit view definition with external editor
\f [STRING] show or set field separator for unaligned query output
\g [FILE] or ; execute query (and send results to file or |pipe)
\gexec execute query, then execute each value in its result
\gset [PREFIX] execute query and store results in psql variables
\h [NAME] help on syntax of SQL commands, * for all commands
\i FILE execute commands from file
\ir FILE as \i, but relative to location of current script
\l[+] [PATTERN] list databases
\lo_export LOBOID FILE
\lo_import FILE [COMMENT]
\lo_list
\lo_unlink LOBOID large object operations
\o [FILE] send all query results to file or |pipe
\p show the contents of the query buffer
\password [USERNAME] securely change the password for a user
\prompt [TEXT] NAME prompt user to set internal variable
\pset [NAME [VALUE]] set table output option
(NAME := {format|border|expanded|fieldsep|fieldsep_zero|footer|null|
numericlocale|recordsep|recordsep_zero|tuples_only|title|tableattr|pager|
unicode_border_linestyle|unicode_column_linestyle|unicode_header_linestyle})
\q quit psql
\qecho [STRING] write string to query output stream (see \o)
\r reset (clear) the query buffer
\s [FILE] display history or save it to file
\set [NAME [VALUE]] set internal variable, or list all if no parameters
\setenv NAME [VALUE] set or unset environment variable
\sf[+] FUNCNAME show a function's definition
\sv[+] VIEWNAME show a view's definition
\t [on|off] show only rows (currently %s)
\timing [on|off] toggle timing of commands (currently %s)
\unset NAME unset (delete) internal variable
\w FILE write query buffer to file
\watch [SEC] execute query every SEC seconds
\x [on|off|auto] toggle expanded output (currently %s)
\z [PATTERN] same as \dp
border border style (number)
columns target width for the wrapped format
expanded (or x) expanded output [on, off, auto]
fieldsep field separator for unaligned output (default "%s")
fieldsep_zero set field separator for unaligned output to zero byte
footer enable or disable display of the table footer [on, off]
format set output format [unaligned, aligned, wrapped, html, asciidoc, ...]
linestyle set the border line drawing style [ascii, old-ascii, unicode]
null set the string to be printed in place of a null value
numericlocale enable or disable display of a locale-specific character to separate
groups of digits [on, off]
pager control when an external pager is used [yes, no, always]
psql --pset=NAME[=VALUE]
or \pset NAME [VALUE] inside psql
psql --set=NAME=VALUE
or \set NAME VALUE inside psql
psql [OPTION]... [DBNAME [USERNAME]]
recordsep record (line) separator for unaligned output
recordsep_zero set record separator for unaligned output to zero byte
set NAME=VALUE
psql ...
or \setenv NAME [VALUE] inside psql
tableattr (or T) specify attributes for table tag in html format or proportional
column widths for left-aligned data types in latex-longtable format
title set the table title for any subsequently printed tables
tuples_only if set, only actual table data is shown
unicode_border_linestyle
unicode_column_linestyle
unicode_header_linestyle
set the style of Unicode line drawing [single, double]
"%s.%s" is not a view
%d connection %d connections %s %s %s (every %gs)
%s
%s (%s, server %s)
%s (every %gs)
%s: %s
%s: -1 can only be used in non-interactive mode
%s: cannot copy from/to a directory
%s: could not delete variable "%s"
%s: could not find own program executable
%s: could not open log file "%s": %s
%s: could not set printing parameter "%s"
%s: could not set variable "%s"
%s: current transaction is aborted
%s: invalid encoding name or conversion procedure not found
%s: not connected to a database
%s: out of memory
%s: unknown transaction status
%s: warning: extra command-line argument "%s" ignored
(%lu row) (%lu rows) ***(Single step mode: verify command)*******************************************
%s
***(press return to proceed or enter x and return to cancel)********************
********* QUERY **********
%s
**************************
+ opt(%d) = |%s|
, clustered , deferrable , initially deferred , invalid , predicate (%s) , replica identity , tablespace "%s" Access privileges All connection parameters must be supplied because no database connection exists
Argument data types Asynchronous notification "%s" received from server process with PID %d.
Asynchronous notification "%s" with payload "%s" received from server process with PID %d.
Attributes Available help:
Border style is %d.
Bypass RLS COPY data transfer failed: %s Call Handler Cannot add cell to table content: total cell count of %d exceeded.
Cannot add header to table content: column count of %d exceeded.
Cannot login Check Check constraints: Child tables Collate Column Column privileges Command: %s
Description: %s
Syntax:
%s
Composite type "%s.%s" Connection
Create DB Create role Ctype Database Default access privileges Default footer is off.
Default footer is on.
Default? Definition Description Destination Dictionaries Did not find any extension named "%s".
Did not find any extensions.
Did not find any relation named "%s".
Did not find any relation with OID %s.
Did not find any text search configuration named "%s".
Did not find any text search parser named "%s".
Disabled internal triggers: Disabled rules: Disabled triggers: Disabled user triggers: Elements Enabled Encoding End parse Enter data to be copied followed by a newline.
End with a backslash and a period on a line by itself. Enter it again: Enter new password: Event Expanded display is off.
Expanded display is on.
Expanded display is used automatically.
FDW Options Failed.
Field separator is "%s".
Field separator is zero byte.
Foreign table "%s.%s" Foreign-data wrapper Foreign-key constraints: Formatting
Function General
General options:
Get headline Get next token Get token types Handler Has OIDs: yes Help
ID Implicit? Index Index "%s.%s" Indexes: Informational
Inherits Init Init options Inline Handler Input/Output
Internal Language Internal name Interrupted
Invalid command \%s. Try \? for help.
Language Large Objects
Large objects Left arg type Lexize Line style is %s.
List of access methods List of aggregate functions List of casts List of collations List of conversions List of data types List of databases List of domains List of event triggers List of foreign servers List of foreign tables List of foreign-data wrappers List of functions List of installed extensions List of languages List of operators List of relations List of roles List of schemas List of settings List of specially treated variables
List of tablespaces List of text search configurations List of text search dictionaries List of text search parsers List of text search templates List of user mappings Locale-adjusted numeric output is off.
Locale-adjusted numeric output is on.
Location Materialized view "%s.%s" Member of Method Modifier Modifiers Name No changes No connections No help available for "%s".
Try \h with no arguments to see available help.
No inheritance No matching relations found.
No matching settings found.
No per-database role settings support in this server version.
No relations found.
No settings found.
Null display is "%s".
Number of child tables: %d (Use \d+ to list them.) Object Object Description Object descriptions Objects in extension "%s" Operating System
Options Output format is %s.
Owned by: %s Owner Pager is always used.
Pager is used for long output.
Pager usage is off.
Pager won't be used for less than %d line.
Pager won't be used for less than %d lines.
Parallel Password encryption failed.
Password for user %s: Password valid until Password: Passwords didn't match.
Policies Policies (forced row security enabled): Policies (forced row security enabled): (none) Policies (row security disabled): Policies (row security enabled): (none) Policies: Previous connection kept
Procedure Query Buffer
Query buffer is empty. Query buffer reset (cleared). Record separator is "%s".
Record separator is <newline>.
Record separator is zero byte.
Referenced by: Replica Identity Replication Report bugs to <pgsql-bugs@postgresql.org>.
Result data type Result type Right arg type Role Role name Rules firing always: Rules firing on replica only: Rules: SSL connection (protocol: %s, cipher: %s, bits: %s, compression: %s)
STATEMENT: %s
Schema Security Sequence "%s.%s" Server Settings Size Source Source code Source type Special relation "%s.%s" Start parse Stats target Storage Succeeded.
Superuser TOAST table "%s.%s" Table Table "%s.%s" Table attributes are "%s".
Table attributes unset.
Tablespace Tablespace: "%s" Tags Target type Target width is %d.
Target width is unset.
Template Text search configuration "%s" Text search configuration "%s.%s" Text search parser "%s" Text search parser "%s.%s" The connection to the server was lost. Attempting reset: The input is a PostgreSQL custom-format dump.
Use the pg_restore command-line client to restore this dump to a database.
The server (version %s) does not support access methods.
The server (version %s) does not support altering default privileges.
The server (version %s) does not support collations.
The server (version %s) does not support editing function source.
The server (version %s) does not support editing view definitions.
The server (version %s) does not support extensions.
The server (version %s) does not support foreign servers.
The server (version %s) does not support foreign tables.
The server (version %s) does not support foreign-data wrappers.
The server (version %s) does not support full text search.
The server (version %s) does not support savepoints for ON_ERROR_ROLLBACK.
The server (version %s) does not support showing function source.
The server (version %s) does not support showing view definitions.
The server (version %s) does not support tablespaces.
The server (version %s) does not support user mappings.
There is no previous error. Time: %.3f ms
Timing is off. Timing is on. Title is "%s".
Title is unset.
Token Token name Token types for parser "%s" Token types for parser "%s.%s" Triggers firing always: Triggers firing on replica only: Triggers: Trusted Try "%s --help" for more information.
Tuples only is off.
Tuples only is on.
Type Type "help" for help.
Type: \copyright for distribution terms
\h for help with SQL commands
\? for help with psql commands
\g or terminate with semicolon to execute query
\q to quit
Typed table of type: %s Unicode border line style is "%s".
Unicode column line style is "%s".
Unicode header line style is "%s".
Unlogged index "%s.%s" Unlogged materialized view "%s.%s" Unlogged table "%s.%s" Usage:
Use "\q" to leave %s.
User name Validator Value Variables
Version View "%s.%s" View definition: Volatility WARNING: %s major version %s, server major version %s.
Some psql features might not work.
WARNING: Console code page (%u) differs from Windows code page (%u)
8-bit characters might not work correctly. See psql reference
page "Notes for Windows users" for details.
Wrote history to file "%s".
You are connected to database "%s" as user "%s" on host "%s" at port "%s".
You are connected to database "%s" as user "%s" via socket in "%s" at port "%s".
You are currently not connected to a database.
You are now connected to database "%s" as user "%s" on host "%s" at port "%s".
You are now connected to database "%s" as user "%s" via socket in "%s" at port "%s".
You are now connected to database "%s" as user "%s".
You are using psql, the command-line interface to PostgreSQL. \!: failed
\%s: could not change directory to "%s": %s
\%s: environment variable name must not contain "="
\%s: error while setting variable
\%s: extra argument "%s" ignored
\%s: missing required argument
\connect: %s \copy: arguments required
\copy: parse error at "%s"
\copy: parse error at end of line
\crosstabview: ambiguous column name: "%s"
\crosstabview: column name not found: "%s"
\crosstabview: column number %d is out of range 1..%d
\crosstabview: data column must be specified when query returns more than three columns
\crosstabview: maximum number of columns (%d) exceeded
\crosstabview: query must return at least three columns
\crosstabview: query result contains multiple data values for row "%s", column "%s"
\crosstabview: statement did not return a result set
\crosstabview: vertical and horizontal headers must be different columns
\df does not take a "w" option with server version %s
\df only takes [antwS+] as options
\pset: allowed Unicode border line styles are single, double
\pset: allowed Unicode column line styles are single, double
\pset: allowed Unicode header line styles are single, double
\pset: allowed formats are unaligned, aligned, wrapped, html, asciidoc, latex, latex-longtable, troff-ms
\pset: allowed line styles are ascii, old-ascii, unicode
\pset: unknown option: %s
\watch cannot be used with COPY
\watch cannot be used with an empty query
abbreviated_grant_or_revoke abort the current transaction aborted because of read failure access_method_type action agg aggregate_name aggregate_signature alias alignment allowconn always analyze_function and aggregate_signature is: and conflict_action is one of: and grouping_element can be one of: and like_option is: and table_constraint is: and table_constraint_using_index is: and with_query is: arg_data_type arg_name arg_type argmode argname argtype argument argument_type arguments attribute attribute_name attribute_option base_type boolean cache call_handler cancel a transaction that was earlier prepared for two-phase commit canceled by user cannot duplicate null pointer (internal error)
cannot escape without active connection
canonical_function category change a database change a database role change a run-time parameter change a server configuration parameter change role name or membership change the definition of a collation change the definition of a conversion change the definition of a domain change the definition of a foreign server change the definition of a foreign table change the definition of a foreign-data wrapper change the definition of a function change the definition of a large object change the definition of a materialized view change the definition of a procedural language change the definition of a row level security policy change the definition of a rule change the definition of a schema change the definition of a sequence generator change the definition of a table change the definition of a tablespace change the definition of a text search configuration change the definition of a text search dictionary change the definition of a text search parser change the definition of a text search template change the definition of a trigger change the definition of a type change the definition of a user mapping change the definition of a view change the definition of an aggregate function change the definition of an event trigger change the definition of an extension change the definition of an index change the definition of an operator change the definition of an operator class change the definition of an operator family change the ownership of database objects owned by a database role channel check_expression child process exited with exit code %d child process exited with unrecognized status %d child process was terminated by exception 0x%X child process was terminated by signal %d child process was terminated by signal %s close a cursor cluster a table according to an index code collatable collate %s collation collect statistics about a database column_alias column_constraint column_definition column_name column_type com_op combinefunc command command not executable command not found commit a transaction that was earlier prepared for two-phase commit commit the current transaction compute a set of rows condition configuration_parameter conflict_action conflict_target connection to server was lost
connlimit constraint constraint_name copy data between a file and a table could not change directory to "%s": %s could not close pipe to external command: %s
could not execute command "%s": %s
could not find a "%s" to execute could not get home directory for user ID %ld: %s
could not identify current directory: %s could not locate temporary directory: %s
could not look up effective user ID %ld: %s could not open temporary file "%s": %s
could not parse reloptions array
could not read binary "%s" could not read from input file: %s
could not read symbolic link "%s" could not save history to file "%s": %s
could not set variable "%s"
could not start /bin/sh
could not start editor "%s"
could not stat file "%s": %s
could not write COPY data: %s
count create a new database create new rows in a table cursor_name data_type database_name deallocate a prepared statement default default %s default_expr define a cursor define a new access method define a new aggregate function define a new cast define a new collation define a new data type define a new database role define a new domain define a new encoding conversion define a new event trigger define a new foreign server define a new foreign table define a new foreign-data wrapper define a new function define a new index define a new mapping of a user to a foreign server define a new materialized view define a new operator define a new operator class define a new operator family define a new procedural language define a new rewrite rule define a new row level security policy for a table define a new savepoint within the current transaction define a new schema define a new sequence generator define a new table define a new table from the results of a query define a new tablespace define a new text search configuration define a new text search dictionary define a new text search parser define a new text search template define a new transform define a new trigger define a new view define access privileges define default access privileges define or change a security label applied to an object define or change the comment of an object definer definition delete delete rows of a table delimiter delimiter_character deserialfunc dest_encoding destroy a previously defined savepoint dictionary_name direction directory disabled discard session state domain constraint domain_constraint domain_name element empty a table or set of tables enabled encoding encoding_name end_function environment variable PSQL_EDITOR_LINENUMBER_ARG must be set to specify a line number
escape_character event exclude_element exclude_element in an EXCLUDE constraint is: execute a prepared statement execute an anonymous code block execution_cost existing_collation existing_enum_value expression extension_name family_name fdw_name ffunc filename filter_variable for table "%s.%s" force a transaction log checkpoint foreign table format_name from_item from_list from_sql_function_name function function name is required
function_name garbage-collect and optionally analyze a database generate a notification gettoken_function group_name grouping_element handler_function headline_function history is not supported by this installation
immutable import table definitions from a foreign server in assignment increment index index_column_name index_expression index_method index_name index_parameters index_parameters in UNIQUE, PRIMARY KEY, and EXCLUDE constraints are: index_predicate init_function initial_condition inline_handler input_function insert install an extension integer internallength invalid binary "%s" invalid command \%s
invalid line number: %s
invalid output format (internal error): %d invoker istemplate join_column join_condition join_proc join_type label lang_name large_object_oid lc_collate lc_ctype left_type lexize_function lextypes_function like_option like_type link_symbol listen for a notification load a shared library file local socket local_schema locale lock a table lockmode loid materialized view maxvalue member_object method mffunc minitial_condition minvalue minvfunc more than one row returned for \gset
msfunc mstate_data_size mstate_data_type name neg_op new_attribute_name new_column_name new_constraint_name new_dictionary new_enum_value new_name new_owner new_role new_schema new_table new_tablespace new_version no no query buffer
no rows returned for \gset
normal not null null_string obj_file object_name off old_dictionary old_role old_version on op_type opclass operator operator class operator family operator_name option or the old syntax out of memory out of memory
output_expression output_function output_name parameter parent_table parser_name password payload pclose failed: %s policy_name position a cursor predicate preferred prepare a statement for execution prepare the current transaction for two-phase commit primary key, provider psql is the PostgreSQL interactive terminal.
psql variables:
query quote_character rebuild indexes receive_function refcolumn referenced_table_name reftable relation_name remote_schema remove a cast remove a collation remove a conversion remove a data type remove a database remove a database role remove a domain remove a foreign server descriptor remove a foreign table remove a foreign-data wrapper remove a function remove a materialized view remove a procedural language remove a rewrite rule remove a row level security policy from a table remove a schema remove a sequence remove a table remove a tablespace remove a text search configuration remove a text search dictionary remove a text search parser remove a text search template remove a transform remove a trigger remove a user mapping for a foreign server remove a view remove access privileges remove an access method remove an aggregate function remove an event trigger remove an extension remove an index remove an operator remove an operator class remove an operator family remove database objects owned by a database role replace the contents of a materialized view replica res_proc restart restore the value of a run-time parameter to the default value restricted result_rows retrieve rows from a query using a cursor retrieve rows from a table or view rettype rewrite_rule_name right_type role_name role_specification roll back to a savepoint rule rule_name safe sampling_method savepoint_name schema_element schema_name seed select send_function sequence sequence_name serialfunc server_name server_type server_version set constraint check timing for the current transaction set the characteristics of the current transaction set the current user identifier of the current session set the session user identifier and the current user identifier of the current session sfunc show the execution plan of a statement show the value of a run-time parameter skipping recursive expansion of variable "%s"
snapshot_id sort_expression sort_family_name sort_operator source_config source_encoding source_table source_type special stable start start a transaction block start_function state_data_size state_data_type statement stop listening for a notification storage storage_parameter storage_type strategy_number sub-SELECT subtype subtype_diff_function subtype_operator_class support_number tab completion query failed: %s
Query was:
%s
table table constraint table_constraint table_constraint_using_index table_name tablespace_name tablespace_option target_role target_type template text timestamp timezone to_sql_function_name token_type transaction_id transaction_mode trigger trigger_name trying to exit copy mode type type_modifier_input_function type_modifier_output_function type_name uid unexpected PQresultStatus: %d
unexpected result status for \watch
unexpected transaction status (%d)
unique, unknown unrecognized value "%s" for "%s"; assuming "%s"
unsafe unterminated quoted string
update update rows of a table user does not exist user name lookup failure: error code %lu user_name using_expression using_list valfunction validator_function value values version view view name is required
view_option_name view_option_value volatile where abbreviated_grant_or_revoke is one of: where action is one of: where aggregate_signature is: where column_constraint is: where conflict_target can be one of: where constraint is: where direction can be empty or one of: where event can be one of: where from_item can be one of: where lockmode is one of: where member_object is: where option can be one of: where option can be: where role_specification can be: where transaction_mode is one of: window window_definition window_name with_query with_query_name yes Project-Id-Version: psql (PostgreSQL 9.1)
Report-Msgid-Bugs-To: pgsql-bugs@postgresql.org
POT-Creation-Date: 2016-08-30 19:43+0000
PO-Revision-Date: 2016-08-30 22:19+0200
Last-Translator: grzegorz <begina.felicysym@wp.eu>
Language-Team: begina.felicysym@wp.eu
Language: pl
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Plural-Forms: nplurals=3; plural=(n==1 ? 0 : n%10>=2 && n%10<=4 && (n%100<10 || n%100>=20) ? 1 : 2);
X-Generator: Virtaal 0.7.1
Opcje połączenia:
Ustawienia wyświetlania:
Zmienne środowiska:
By uzyskać więcej informacji wpisz "\?" (dla poleceń wewnętrznych) lub "\help"
(dal poleceń SQL) w psql, lub sprawdź w rozdziale dotyczącym psql
dokumentacji PostgreSQL.
Opcje wejścia i wyjścia:
Opcje formatowania wyjścia:
Parser: "%s"
Analizator: "%s.%s" --help=commands listuje polecenia z bakslaszem i kończy
--help=variables listuje zmienne specjalne i kończy
(opcje: S = pokaż obiekty systemowe, + = dodatkowe szczegóły)
-0, --record-separator-zero
ustala separator rekordów dla niewyrównanego wyjścia na bajt zero
-1 ("one"), --single-transaction
wykonuje w jednej transakcji (jeśli nie interaktywnie)
-?, --help[=options] pokazuje ten ekran pomocy i kończy
-A, --no-align tryb braku wyrównania tabeli na wyjściu
-E, --echo-hidden wyświetlenie zapytań tworzonych przez polecenia wewnętrzne
-F, --field-separator=CIĄGZNAKÓW
separator pól dla niewyrównanego wyjścia (domyślnie: "%s")
-H, --html tryb wyjścia tabeli HTML
-L, --log-file=NAZWAPLIKU
wysyła komunikaty sesji do pliku
-P, --pset=ZMI[=ARG] ustawia opcję drukowania ZMI na ARG (patrz polecenie \pset)
-R, --record-separator=CIĄGZNAKÓW
separator rekordów dla niewyrównanego wyjścia(domyślnie: nowa linia)
-S, --single-line tryb jednoliniowy (koniec linii kończy polecenie SQL)
-T, --table-attr=TEKST ustawia atrybuty znaczników tabeli HTML (np., szerokość, ramkę)
-U, --username=NZAWAUZYTKOWNIKA
nazwa użytkownika bazy danych (domyślnie: "%s")
-V, --version pokaż informacje o wersji i zakończ
-W, --password wymuś pytanie o hasło (powinno nastąpić automatycznie)
-X, --no-psqlrc nie czyta pliku startowego (~/.psqlrc)
-a, --echo-all echo wejścia ze skryptu
-b, --echo-errors wypisuje niepoprawnie wykonane polecenia
-c, --command=POLECENIE wykonuje jedno polecenie (SQL lub wewnętrzne) i kończy
-d, --dbname=NAZWADB nazwa bazy danych do połączenia (domyślnie: "%s")
-e, --echo-queries polecenia echo wysyłane na serwer
-f, --file=NAZWAPLIKU wykonuje polecenia z pliku i kończy
-h, --host=NAZWAHOSTA nazwa serwera bazy danych lub katalog gniazda (domyślnie: "%s")
-l, --list listuje dostępne bazy danych i kończy
-n, --no-readline wyłącza rozszerzoną edycje linii poleceń (readline)
-o, --output=NAZWAPLIKU wysyła wyniki zapytania do pliku (lub |przewodu)
-p, --port=PORT port na serwerze bazy danych (domyślnie: "%s")
-q, --quiet ciche wykonanie (bez komunikatów, tylko wyniki zapytań)
-s, --single-step tryb jednokrokowy (potwierdzenie każdego zapytania)
-t, --tuples-only drukuje tylko wiersze
-v, --set=, --variable=NAZWA=WARTOŚĆ
ustala wartość zmiennej psql NAZWA na WARTOŚĆ
(np. -v ON_ERROR_STOP=1)
-w, --no-password nie pytaj nigdy o hasło
-x, --expanded włącza wyjście rozciągniętej tabeli
-z, --field-separator-zero
ustala separator pól dla niewyrównanego wyjścia na bajt zero
AUTOCOMMIT gdy ustawiony, polecenia SQL zakończone powodzeniem są automatycznie zatwierdzone
COLUMNS liczba kolumn w formacie zawijania linii
COMP_KEYWORD_CASE determinuje wielkość liter uzupełniających słowa kluczowe SQL
[lower, upper, preserve-lower, preserve-upper]
DBNAME nazwa obecnie podłączonej bazy danych
ECHO kontroluje jakie informacje z wejścia są wypisywane na standardowym wyjściu
[all, errors, none, queries]
ECHO_HIDDEN wyświetla wewnętrzne zapytania wykonywane przez polecenia bakslasz;
jeśli ustawiono na "noexec" tylko pokazuje je bez wykonywania
ENCODING aktualny zestaw znaków kodowania klienta
FETCH_COUNT liczba wierszy wynikowych do jednorazowego pobrania i wyświetlenia
(domyślnie: 0=nieograniczona)
HISTCONTROL kontroluje historię poleceń [ignorespace, ignoredups, ignoreboth]
HISTFILE nazwa pliku używana do zapisu historii poleceń
HISTSIZE liczba poleceń przechowywanych w historii poleceń
HOST komputer serwera obecnie połączonej bazy danych
IGNOREEOF gdy nieustawiony, wysłanie EOF do sesji interaktywnej zamyka aplikację
LASTOID wartość ostatnio dotkniętego OID
NAZWA=WARTOŚĆ [NAZWA=WARTOŚĆ] psql ...
lub \setenv NAME [VALUE] wewnątrz psql
ON_ERROR_ROLLBACK gdy ustawione, błąd nie zatrzymuje transakcji (używa niejawnych punktów zapisu)
ON_ERROR_STOP zatrzymuje wykonywanie wsadowe po wystąpieniu błędu
PAGER nazwa zewnętrznego programu stronicowania
PGAPPNAME to samo co parametr połączenia application_name
PGDATABASE to samo co parametr połączenia dbname
PGHOST to samo co parametr połączenia host
PGPASSFILE nazwa pliku hasła
PGPASSWORD hasło połączenia (niezalecane)
PGPORT to samo co parametr połączenia port
PGUSER to samo co parametr połączenia user
PORT port aktualnie połączonego serwera
PROMPT1 określa zwykłą zachętę psql
PROMPT2 określa zachętę używaną, gdy wyrażenie jest kontynuowane z poprzedniej linii
PROMPT3 określa zachętę używaną podczas trwania COPY ... FROM STDIN
PSQLRC alternatywne połażenie pliku użytkownika .psqlrc
PSQL_EDITOR, EDITOR, VISUAL
edytor do wykorzystania w poleceniach \e, \ef i \ev
PSQL_EDITOR_LINENUMBER_ARG
wskazanie numeru linii podczas wywoływania edytora
PSQL_HISTORY alternatywne położenie dla pliku historii poleceń
QUIET działaj cicho (tak samo jak opcja -q)
SHELL powłoka używana przez polecenie \!
SHOW_CONTEXT steruje wyświetlaniem pól kontekstu komunikatu [never, errors, always]
SINGLELINE tryb kończenia SQL końcem linii (to samo co opcja -S)
SINGLESTEP tryb jednokrokowy (to samo co opcja -s)
TMPDIR folder plików tymczasowych
USER aktualnie połączony użytkownik bazy danych
VERBOSITY kontroluje gadulstwo raportów błędów [default, verbose, terse]
\! [POLECENIE] wykonuje polecenie powłoki lub uruchamia interaktywną powłokę
\? [polecenia] pomoc do poleceń psql zaczynających się bakslaszem
\? opcje pokazuje pomoc dla opcji linii poleceń psql
\? zmienne pokazuje pomoc dla zmiennych konfiguracyjnych psql
\C [STRING] ustawia tytuł tabeli lub czyści jeśli brak parametru
\H przełącza tryb wyjścia HTML (obecnie %s)
\T [STRING] ustawia atrybuty znacznika HTML <table>, lub czyści jeśli pusty
\a przełącza między trybem wyjścia wyrównanym i niewyrównwnym
\c[onnect] {[NAZWADB|- UŻYTK|- HOST|- PORT|-] | conninfo}
łączy do nowej bazy danych (obecnie "%s")
\c[onnect] {[NAZWADB|- UŻYTK|- HOST|- PORT|-] | conninfo}
łączy do nowej bazy danych (obecnie bez połączenia)
\cd [FDR] zmienia bieżący folder roboczy
\conninfo wyświetla informację o bieżącym połączeniu
\copy ... wykonuje SQL COPY strumienia danych na host klienta
\copyright pokazuje warunku użytkowania i dystrybucji PostgreSQL
\crosstabview [KOLUMNY] wykonuje polecenie i wyświetla wynik w tabeli odwróconej
\dA[+] [WZORZEC] listuje metody dostępu
\dC[+] [WZORZEC] listuje rzutowania
\dD[S+] [WZORZEC] listuje domeny
\dE[S+] [WZORZEC] listuje tabele obce
\dF[+] [WZORZEC] listuje konfiguracje wyszukiwania tekstowego
\dFd[+] [WZORZEC] listuje słowniki wyszukiwania tekstowego
\dFp[+] [WZORZEC] listuje analizatory wyszukiwania tekstowego
\dFt[+] [WZORZEC] listuje wzorce wyszukiwania tekstowego
\dL[S+] [WZORZEC] listuje języki proceduralne
\dO[S+] [WZORZEC] listuje porównania
\dT[S+] [WZORZEC] listuje typy danych
\d[S+] listuje tabele, widoku i dekwencje
\d[S+] NAZWA opisuje tabelę, widok, sekwencję lub indeks
\da[S] [WZORZEC] listuje agregaty
\db[+] [WZORZEC] listuje przestrzenie tabel
\dc[S+] [WZORZEC] listuje konwersje
\dd[S] [WZORZEC] pokazuje komentarze obiektów nie wyświetlane nigdzie indziej
\ddp [WZORZEC] listuje domyślne uprawnienia
\des[+] [WZORZEC] listuje serwery obce
\det[+] [WZORZEC] listuje tabele zewnętrzne
\deu[+] [WZORZEC] listuje mapowania użytkownika
\dew[+] [WZORZEC] listuje opakowania obcych danych
\df[antw][S+] [WZORC] listuje funkcje [tylko agreg/zwykły/wyzwalacz/okno]
\dg[S+] [WZORZEC] listuje role
\di[S+] [WZORZEC] listuje indeksy
\dl listuje duże obiekty, to samo, co \lo_list
\dm[S+] [WZORZEC] listuje widoki zmaterializowane
\dn[S+] [WZORZEC] listuje schematy
\do[S] [WZORZEC] listuje operatory
\dp [WZORZEC] listuje uprawnienia dostępu do tabeli, widoku
lub sekwencji
\drds [WZORC1 [WZORC2]] listuje ustawienia ról wedle baz danych
\ds[S+] [WZORZEC] listuje sekwencje
\dt[S+] [WZORZEC] listuje tabele
\du[S+] [WZORZEC] listuje role
\dv[S+] [WZORZEC] listuje widoki
\dx[+] [WZORZEC] listuje rozszerzenia
\dy [WZORZEC] listuje wyzwalacze zdarzeń
\e [PLIK] [LINIA] edytuje bufor zapytania (lub plik) edytorem zewnętrznym
\echo [STRING] zapisuje ciąg znaków do standardowego wyjścia
\ef [NAZWAFUNK [LINIA]]
edytuje definicję funkcji edytorem zewnętrznym
\encoding [KODOWANIE] pokazuje lub ustawia kodowanie klienta
\errverbose pokazuje najpóźniejszy komunikat błędu show z najszerszym opisem
\ev [NAZWAWIDOKU [LINIA]]
edytuje definicję widoku edytorem zewnętrznym
\f [STRING] pokazuje lub ustawia separator pól dla niewyrównanego
wyjścia zapytania
\g [PLIK] or ; wykonuje zapytanie (i wysyła wyniki do pliku lub |przewodu)
\gexec wykonuje zapytanie, po czym wykonuje każdą wartość z jego wyniku
\gset [PREFIKS] wykonuje zapytanie i zapisuje wyniki do zmiennych psql
\h [NAZWA] pomoc odnośnie składni poleceń SQL, * dla wszystkich poleceń
\i PLIK wykonuje polecenia z pliku
\ir FILE jak \i, tylko względnie do położenia bieżącego skryptu
\l[+] [WZORZEC] listuje bazy danych
\lo_export LOBOID PLIK
\lo_import PLIK [KOMENTARZ]
\lo_list
\lo_unlink LOBOID operacje na dużych obiektach
\o [PLIK] lub ; wysyła wszystkie wyniki zapytania do pliku lub |przewodu
\p pokazuje zawartość bufora zapytania
\password [NAZWAUZYT] zmienia w sposób bezpieczny hasło użytkownika
\prompt [TEKST] NAZWA prosi użytkownika o ustawienie zmiennej wewnętrznej
\pset [NAZWA [WARTOSC]] ustawia opcje wyjścia tabeli
(NAZWA := {format|border|expanded|fieldsep|fieldsep_zero|footer|null|
numericlocale|recordsep|recordsep_zero|tuples_only|title|tableattr|pager|
unicode_border_linestyle|unicode_column_linestyle|unicode_header_linestyle})
\q wychodzi z psql
\qecho [STRING] zapisuje ciąg znaków do strumienia wyjściowego
zapytania (patrz \o)
\p resetuje (czyści) zawartość bufora zapytania
\s [PLIK] wyświetla historię lub zapisuje ja do pliku
\set [NAZWA [WARTOŚĆ]] ustawia zmienną wewnętrzną lub listuje wszystkie,
jeśli brak parametrów
\setenv NAZWA [WARTOŚĆ]
ustawia lub usuwa zmienną środowiska
\sf[+] NAZWAFUNK pokazuje definicję funkcji
\sv[+] NAZWAWIDOKU pokazuje definicję widoku
\t [on|off] pokazywanie tylko wierszy (obecnie %s)
\timing [on|off] przełącza pomiar czasu poleceń (obecnie %s)
\unset NAZWA ustawia jako pustą (usuwa) zmienną wewnętrzną
\w PLIK zapisuje bufor zapytania do pliku
\watch [SEC] wykonuje zapytanie co SEC sekund
\x [on|off|auto] przełącza rozciągnięte wyjście (obecnie %s)
\z [WZORZEC] to samo co \dp
border styl ramki (liczba)
columns szerokość celu w formacie zawijania linii
expanded (lub x) rozszerzone wyjście [on, off, auto]
fieldsep separator pól dla niewyrównanego wyjścia (domyślnie "%s")
fieldsep_zero ustala separator pól dla niewyrównanego wyjścia na bajt zero
footer włącza lub wyłącza wyświetlanie stopki tabeli [on, off]
format ustala format wyjścia [unaligned, aligned, wrapped, html, asciidoc, ...]
linestyle ustawia styl rysowania linii granicznej [ascii, old-ascii, unicode]
null ustawia ciąg znaków drukowany w miejsce wartości pustej
numericlocale włącza lub wyłącza wyświetlanie znaku zależnego od ustawień narodowych
oddzielającego grupy cyfr [on, off]
pager steruje kiedy użyć zewnętrznego stronicowania [yes, no, always]
psql --set=NAZWA[=WARTOŚĆ]
lub \set NAZWA [WARTOŚĆ] wewnątrz psql
psql --set=NAZWA=WARTOŚC
lub \set NAZWA WARTOŚĆ wewnątrz psql
psql [OPCJA]... [NAZWADB [NAZWAUŻYTKOWNIKA]]
recordsep separator rekordów (linii) dla niewyrównanego wyjścia
recordsep_zero ustala separator rekordów dla niewyrównanego wyjścia na bajt zero
set NAZWA=WARTOŚĆ
psql ...
lub \setenv NAZWA [WARTOŚĆ] wewnątrz psql
tableattr (lub T) określa atrybuty znacznika tabeli w formacie html lub formatu
latex-longtable w kolumnach proporcjonalnej szerokości wyrównanych do lewej
title ustawia tytuł tabeli dla następnie drukowanych tabel
tuples_only gdy ustawione, pokazywane są tylko aktualne dane tabeli
unicode_border_linestyle
unicode_column_linestyle
unicode_header_linestyle
ustawia styl Unikodowego rysowania linii [single, double]
"%s.%s" nie jest widokiem
%d połączenie %d połączenia %d połączeń %s %s %s (każdy %gs)
%s
%s (%s, serwer %s)
%s (każdy %gs)
%s: %s
%s: -1 może być użyty tylko trybie nieinteraktywnym
%s: nie można kopiować z/do folderu
%s: nie można usunąć zmiennej "%s"
%s: nie można znaleźć programu wykonywalnego
%s: nie można otworzyć pliku logów "%s": %s
%s: nie można ustawić parametru wydruku "%s"
%s: nie można ustawić zmiennej "%s"
%s: bieżąca transakcja została przerwana
%s: nieprawidłowa nazwa kodowania lub nie znaleziono procedury konwersji
%s: nie połączono z bazą danych
%s: brak pamięci
%s: nieznany status transakcji
%s: ostrzeżenie: nadmiarowy argument wiersza poleceń "%s" zignorowany
(%lu wiersz) (%lu wiersze) (%lu wierszy) ***(Tryb jednokrokowy: sprawdzenie polecenia)***********************************
%s
***(wciśnij enter by iść dalej lub x i enter by anulować)***********************
********* ZAPYTANIE **********
%s
******************************
+ opt(%d) = |%s|
, klastrowany , odraczalny , początkowo odroczony , niepoprawny , orzeczenie (%s) , identyczność repliki , przestrzeń tabel "%s" Uprawnienia dostępu Wszystkie parametry połączenia muszą być wskazane ponieważ nie istnieje żadne połączenie do bazy danych
Typy danych argumentów Asynchroniczne powiadomienie "%s" otrzymano z procesu serwera PID %d.
Asynchroniczne powiadomienie "%s" o ładunku "%s" otrzymano z procesu serwera PID %d.
Atrybuty Dostępna pomoc:
Styl obramowania to %d.
Obejście RLS transfer danych COPY nie powiódł się: %s Uchwyt Wywołania Nie można dodać komórki do zawartości tabeli: przekroczona liczba komórek %d.
Nie można dodać nagłówka do zawartości tabeli: przekroczona liczba kolumn %d.
Nie można zalogować Sprawdzenie Ograniczenie kontrolne: Tabele podrzędne Porównanie Kolumna Uprawnienia kolumn Polecenie: %s
Opis: %s
Składnia:
%s
Typ złożony "%s.%s" Połączenie
Utwórz DB Utwórz rolę Ctype Baza danych Domyślne uprawnienia dostępu Domyślna stopka jest wyłączona.
Domyślna stopka jest włączona.
Domyślnie? Definicja Opis Cel Słowniki Nie znaleziono żadnego rozszerzenia o nazwie "%s".
Nie znaleziono żadnego rozszerzenia.
Nie znaleziono żadnej relacji o nazwie "%s".
Nie znaleziono żadnej relacji o OID %s.
Nie znaleziono konfiguracji wyszukiwania tekstowego o nazwie "%s".
Nie znaleziono parsera wyszukiwania tekstowego o nazwie "%s".
Wyłączone wyzwalacze wewnętrzne: Wyłączone reguły: Wyłączone wyzwalacze: Wyłączone wyzwalacze użytkownika: Elementy Włączony Kodowanie Koniec parsowania Wprowadź dane do skopiowania poprzedzone nową linią.
Zakończ linią zawierająca tylko odwróconym ukośnikiem i spację. Powtórz podane hasło: Wprowadź nowe hasło: Zdarzenie Rozszerzone wyświetlanie jest wyłączone.
Rozszerzone wyświetlanie jest włączone.
Rozszerzone wyświetlanie jest stosowane automatycznie.
Opcje FDW Nieudane.
Separatorem pól jest "%s".
Separatorem pól jest bajt zero.
Tabela obca "%s.%s" Opakowanie obcych danych Ograniczenia kluczy obcych: Formatowanie
Funkcja Informacje ogólne
Opcje ogólne:
Pobierz nagłówek Pobierz następny token Pobierz typy tokenów Uchwyt Zawiera OIDy: tak Pomoc
Identyfikator Bezwarunkowy? Indeks Indeks "%s.%s" Indeksy: Informacyjne
Dziedziczenia Init Opcje inicjacji Uchwyt Wbudowany Wejście/Wyjście
Język wewnętrzny Nazwa wewnętrzna Przerwane
Niepoprawne polecenie \%s. Spróbuj \? by uzyskać pomoc.
Język Duże Obiekty
Duże obiekty Typ lewego arg Lexize Styl linii to %s.
Lista metod dostępu Lista funkcji agregujących Lista rzutowań Spis porównań Lista przekształceń Lista typów danych Lista baz danych Lista domen Lista wyzwalaczy zdarzeń Lista serwerów obcych Lista tabel obcych Lista opakowań danych obcych Lista funkcji Lista zainstalowanych rozszerzeń Lista języków Lista operatorów Lista relacji Lista ról Lista schematów Lista ustawień Lista specjalnie traktowanych zmiennych
Lista przestrzeni tabel Lista konfiguracji wyszukiwania tekstowego Lista słowników wyszukiwania tekstowego Lista parserów wyszukiwania tekstowego Lista szablonów wyszukiwania tekstowego Lista mapowań użytkownika Dostosowane do lokalizacji wyświetlanie liczb jest wyłączone.
Dostosowane do lokalizacji wyświetlanie liczb jest włączone.
Położenie Widok materializowany "%s.%s" Element Metoda Modyfikator Modyfikatory Nazwa Bez zmian Brak połączeń Brak dostępnej pomocy dla "%s".
Spróbuj \h bez argumentów by zobaczyć dostępną pomoc.
Bez dziedziczenia Nie znaleziono pasujących relacji.
Nie znaleziono pasujących ustawień.
Brak obsługi oddzielnych ustawień ról dla baz danych w tej wersji serwera.
Nie znaleziono relacji.
Nie znaleziono ustawień.
Wyświetlanie Null jako "%s".
Liczba tabel podrzędnych: %d (Użyj \d+ by je wylistować.) Obiekt Opis Obiektu Opisy obiektów Obiekty w rozszerzeniu "%s" System Operacyjny
Opcje Format wyjścia to %s.
Właściciel: %s Właściciel Stronicowanie zawsze używane.
Stronicowanie jest używane dla długiego wyjścia.
Stronicowanie nigdy nie używane.
Stronicowanie nie będzie używane dla mniej niż %d linii.
Stronicowanie nie będzie używane dla mniej niż %d linii.
Stronicowanie nie będzie używane dla mniej niż %d linii.
Równoległy Nie udało się zaszyfrować hasła.
Hasło użytkownika %s: Hasło ważne do Hasło: Podane hasła różnią się.
Polityki Polityki (włączone wymuszenie bezpieczeństwa wierszy): Polityki (włączono wymuszenie bezpieczeństwa wierszy): (brak) Polityki (wyłączone bezpieczeństwo wierszy): Polityki (włączono bezpieczeństwo wierszy): (brak) Polityki: Poprzednie połączenie zachowane
Procedura Bufor Zapytania
Bufor zapytania jest pusty. Reset bufora zapytania (wyczyszczony). Separatorem rekordów jest "%s".
Separatorem rekordów jest <newline>.
Separatorem rekordów jest bajt zero.
Wskazywany przez: Identyczność Repliki Replikacja Błędy proszę przesyłać na adres <pgsql-bugs@postgresql.org>.
Typ danych wyniku Typ wyniku Typ prawego arg Rola Nazwa roli Reguły odpalane zawsze: Reguły odpalane tylko przy replikacji: Reguły: Połączenie SSL (protokół: %s, szyfrowanie: %s, bity: %s, kompresja %s)
WYRAŻENIE: %s
Schemat Zabezpieczenia Sekwencja "%s.%s" Serwer Ustawienia Rozmiar Źródło Kod źródłowy Typ źródłowy Relacja specjalna "%s.%s" Początek parsowania Cel statystyk Przechowywanie Udane.
Superużytkownik Tabela TOAST "%s.%s" Tabela Tabela "%s.%s" Atrybuty tabeli to "%s".
Atrybuty tabeli nie są ustawione.
Przestrzeń Tabel Przestrzeń tabel: "%s" Znaczniki Typ docelowy Szerokość celu to %d.
Szerokość celu nieustawiona.
Szablon Konfiguracja wyszukiwania tekstowego "%s" Konfiguracja wyszukiwania tekstowego "%s.%s" Parser wyszukiwania tekstowego "%s" Parser wyszukiwania tekstowego "%s.%s" Połączenie z serwerem zostało przerwane. Próba resetu: Wyjście to zrzut w formacie niestandardowym PostgreSQL.
Użyj klienta linii poleceń pg_restore by odtworzyć bazę danych ze zrzutu.
Serwer (wersja %s) nie obsługuje metod dostępu.
Serwer (wersja %s) nie obsługuje zmiany domyślnych uprawnień.
Serwer (wersja %s) nie obsługuje porównań.
Serwer (wersja %s) nie obsługuje edycji źródła funkcji.
Serwer (wersja %s) nie obsługuje edycji definicji widoków.
Serwer (wersja %s) nie obsługuje rozszerzeń.
Serwer (wersja %s) nie obsługuje serwerów obcych.
Serwer (wersja %s) nie obsługuje tabel obcych.
Serwer (wersja %s) nie obsługuje opakowań danych obcych.
Serwer (wersja %s) nie obsługuje pełnego wyszukiwania tekstowego.
Serwer (wersja %s) nie obsługuje punktów zapisu dla ON_ERROR_ROLLBACK.
Serwer (wersja %s) nie obsługuje wyświetlania źródła funkcji.
Serwer (wersja %s) nie obsługuje wyświetlania definicji widoków.
Serwer (wersja %s) nie obsługuje przestrzeni tabel.
Serwer (wersja %s) nie obsługuje przestrzeni mapowań użytkownika.
Nie ma poprzedniego błędu. Czas: %.3f ms
Pomiar czasu wyłączony. Pomiar czasu włączony. Tytuł to "%s".
Tytuł nie jest ustawiony.
Token Nazwa tokenu Typy tokenów dla parsera "%s" Typy tokenów dla analizatora "%s.%s" Wyzwalacze odpalane zawsze: Wyzwalacze odpalane tylko przy replikacji: Wyzwalacze: Zaufany Spróbuj "%s --help" aby uzyskać więcej informacji.
Tylko krotki wyłączone.
Tylko krotki włączone.
Typ Wpisz "help" by uzyskać pomoc.
Wpisz: \copyright by poznać warunki rozpowszechniania
\h by uzyskać pomoc dla poleceń SQL
\? by uzyskać pomoc poleceń psql
\g lub zakończ średnikiem by wykonać zapytanie
\q by wyjść
Tabela typizowana typu: %s Unikodowy styl linii obramowania to "%s".
Unikodowy styl linii kolumn to "%s".
Unikodowy styl linii nagłówka to "%s".
Niezalogowany indeks "%s.%s" Niezalogowany widok materializowany "%s.%s" Niezalogowany indeks "%s.%s" Składnia:
Użyj "\q" by opuścić %s.
Nazwa użytkownika Walidator Wartość Zmienne
Wersja Widok "%s.%s" Definicja widoku: Zmienność OSTRZEŻENIE: %s wersja główna %s, wersja główna serwera %s.
Niektóre cechy psql mogą nie działać.
OSTRZEŻENIE: strona kodowa konsoli (%u) jest różna od kodowania Windows (%u)
8-bitowe znaki mogą nie wyglądać poprawnie. Przejrzyj odnośną
stronę "Notes for Windows users" by poznać szczegóły.
Zapisano historię do pliku "%s".
Jesteś obecnie połączony do bazy danych "%s" jako użytkownik "%s" na serwerze "%s" port "%s".
Jesteś obecnie połączony do bazy danych "%s" jako użytkownik "%s" przez gniazdo w "%s" port "%s".
Nie jesteś obecnie połączony do bazy danych.
Jesteś obecnie połączony do bazy danych "%s" jako użytkownik "%s" na serwerze "%s" port "%s".
Jesteś obecnie połączony do bazy danych "%s" jako użytkownik "%s" przez gniazdo na "%s" port "%s".
Jesteś obecnie połączony do bazy danych "%s" jako użytkownik "%s".
Używasz psql, interfejsu wiersza poleceń PostgreSQL. \!: niepowodzenie
\%s: nie można zmienić katalogu na "%s": %s
\%s: zmienna środowiska nie może zawierać "="
\%s: błąd podczas ustawiania zmiennej
\%s: nadmiarowy argument "%s" zignorowany
\%s: brakujący wymagany argument
\connect: %s \copy: wymagane są argumenty
\copy: błąd analizy przy "%s"
\copy: błąd analizy na końcu linii
\crosstabview: wieloznaczna nazwa kolumny: "%s"
\crosstabview: nie znaleziono nazwy kolumny: "%s"
\crosstabview: numer kolumny %d wykracza poza zakres 1..%d
\crosstabview: kolumna danych musi być wskazana gdy wynik zapytania zwraca więcej niż trzy kolumny
\crosstabview: przekroczona maksymalna liczba kolumn (%d)
\crosstabview: zapytanie musi zwracać co najmniej trzy kolumny
\crosstabview: wynik zapytania zawiera wiele wartości danych w wierszu "%s", kolumnie "%s"
\crosstabview: polecenie nie utworzyło zbioru wynikowego
\crosstabview: nagłówki pionowe i poziome muszą być różnymi kolumnami
\df nie przyjmuje opcji "w" w wersji serwera %s
\df przyjmuje tylko opcje [antwS+]
\pset: dostępne Unikodowe style linii ramki to pojedyncza, podwójna
\pset: dostępne Unikodowe style linii kolumny to pojedyncza, podwójna
\pset: dostępne Unikodowe style linii nagłówka to pojedyncza, podwójna
\pset: dostępnymi formatami są unaligned, aligned, wrapped, html, asciidoc, latex, latex-longtable, troff-ms
\pset: dostępne style linii to ascii, old-ascii, unicode
\pset: nieznana opcja: %s
\watch nie może być użyte z COPY
\watch nie może być użyte z pustym zapytaniem
skrót_przyznania_lub_odebrania_uprawnień przerywa bieżącą transakcję przerwane na skutek nieudanego odczytu typ_metody_dostępu akcja agreg nazwa_agregatu podpis_agregatu alias wyrównanie zezwnapoł zawsze funkcja_analizy a podpis_agregatu to: gdzie akcja_konfliktu to jedna z: gdzie element_grupowania może być jednym z: a opcja_podobne to: a ograniczenie_tabeli to: a ograniczenie_tabeli_używające_indeksu to: a z_kwerendą to: typ_arg_danych nazwa_arg typ_arg trybarg nazwaarg typarg argument typ_argumentu argumenty atrybut nazwa_atrybutu opcja_atrybutu typ_bazowy boolean pamięć_podręczna uchwyt_wywołania anuluje transakcję uprzednio przygotowaną do zatwierdzenia dwufazowego anulowane przez użytkownika nie można powielić pustego wskazania (błąd wewnętrzny)
nie można uciec bez aktywnego połączenia
funkcja_kanoniczna kategoria zmienia bazę danych zmienia rolę bazy danych zmienia parametr czasu wykonania zmienia parametr konfiguracji serwera zmienia nazwę roli lub przynależność zmienia definicję porównania zmienia definicję konwersji zmienia definicję domeny zmienia definicję serwera obcego zmienia definicję tabeli obcej zmienia definicję opakowania obcych danych zmienia definicję funkcji zmienia definicję dużego obiektu zmienia definicję widoku zmaterializowanego zmienia definicję języka proceduralnego` zmienia definicję polityki bezpieczeństwa na poziomie wierszy zmienia definicję reguły zmienia definicję schematu zmienia definicję generatora sekwencji zmienia definicję tabeli zmienia definicję przestrzeni tabel zmienia definicję konfiguracji wyszukiwania tekstowego zmienia definicję słownika wyszukiwania tekstowego zmienia definicję analizatora wyszukiwania tekstowego zmienia definicję szablonu wyszukiwania tekstowego zmienia definicję wyzwalacza zmienia definicję typu zmienia definicję mapowania użytkownika zmienia definicję widoku zmienia definicję funkcji agregującej zmienia definicję wyzwalacza zdarzenia zmienia definicję rozszerzenia zmienia definicję indeksu zmienia definicję operatora zmienia definicję klasy operatora zmienia definicję rodziny operatora zmienia posiadacza obiektów bazy danych, których właścicielem jest rola bazy danych kanał wyrażenie_check proces potomny zakończył działanie z kodem %d proces potomny zakończył działanie z nieznanym stanem %d proces potomny został zatrzymany przez wyjątek 0x%X proces potomny został zakończony przez sygnał %d proces potomny został zatrzymany przez sygnał %s zamyka kursor klaster lub tabela zgodna z indeksem kod porównywalne porównanie %s porównanie zbiera statystyki na temat bazy danych alias_kolumny ograniczenie_kolumny definicja_kolumny nazwa_kolumny typ_kolumny op_kom combinefunk polecenie polecenie nie wykonywalne polecenia nie znaleziono zatwierdzenie transakcji uprzednio przygotowanej do zatwierdzenia dwufazowego zatwierdzenie bieżącej transakcji oblicza zbiór wierszy warunek parametr_konfiguracji akcja_konfliktu cel_konflktu utracono połączenie z serwerem
limitpołączeń ograniczenie nazwa_ograniczenia kopiuje dane między plikiem i tabelą nie można zmienić katalogu na "%s": %s nie można zamknąć potoku do polecenia zewnętrznego: %s
nie można wykonać polecenia "%s": %s
nie znaleziono "%s" do wykonania nie można pobrać folderu domowego dla ID użytkownika %ld: %s
nie można zidentyfikować aktualnego katalogu: %s nie można utworzyć katalogu tymczasowego: %s
nie udało się odnaleźć efektywnego ID użytkownika %ld: %s nie można otworzyć pliku tymczasowego "%s": %s
nie można przeanalizować tablicy reloptions
nie można odczytać binarnego "%s" nie można czytać z pliku wejścia: %s
nie można odczytać odwołania symbolicznego "%s" nie można zapisać historii do pliku "%s": %s
nie można ustawić zmiennej "%s"
nie można uruchomić /bin/sh
nie można uruchomić edytora "%s"
nie można wykonać stat na pliku "%s": %s
nie można zapisać danych COPY: %s
ilość tworzy nową bazę danych tworzy nowe wiersze w tabeli nazwa_kursora typ_danych nazwa_bazydanych zwalnia przygotowane wyrażenie domyślnie domyślnie %s wyrażenie_domyślne definiuje kursor definiuje nową metodę dostępu definiuje nową funkcję agregującą definiuje nowe rzutowanie definiuje nowe porównanie definiuje nowy typ danych definiuje nową rolę bazy danych definiuje nową domenę definiuje nowe przekształcenie kodowania definiuje nowy wyzwalacz zdarzenia definiuje nowy serwer obcy definiuje nową tabelę obcą definiuje nowe opakowania obcych danych definiuje nową funkcję definiuje nowy indeks definiuje nowe mapowanie użytkownika do serwera obcego definiuje nowy widok zmaterializowany definiuje nowy operator definiuje nową klasę operatora definiuje nową rodzinę operatora definiuje nowy język proceduralny definiuje nową regułę przepisania definiuje nową politykę bezpieczeństwa na poziomie wierszy dla tabeli definiuje punkt zapisu w bieżącej transakcji definiuje nowy schemat definiuje nowy generator sekwencji definiuje nową tabelę definiuje nową tabelę z wyników zapytania definiuje nową przestrzeń tabel definiuje nową konfigurację wyszukiwania tekstowego definiuje nowy słownik wyszukiwania tekstowego definiuje nowy analizator wyszukiwania tekstowego definiuje nowy szablon wyszukiwania tekstowego definiuje nową transformację definiuje nowy wyzwalacz definiuje nowy widok definiuje uprawnienia dostępu definiuje domyślne uprawnienia dostępu definiuje zmianę etykiety bezpieczeństwa zastosowanych do obiektu definiuje lub zmienia komentarz obiektu definiujący definicja usuń usuwa wiersze z tabeli ogranicznik znak_ogranicznika deserialfunk kodowanie_celu usuwa zdefiniowany poprzednio punkt zapisu nazwa_słownika kierunek folder wyłączony odrzuca stan sesji ograniczenie domeny ograniczenie_domeny nazwa_domeny element opróżnia tabelę lub grupę tabel włączony kodowanie nazwa_kodowania funkcja_kończąca musi być ustawiona zmienna środowiskowa PSQL_EDITOR_LINENUMBER_ARG by wskazać numer linii
znak_ucieczki zdarzenie element_wyłączany element_wyłączany w ograniczeniu EXCLUDE to: wykonuje przygotowane wyrażenie wykonuje anonimowy blok kodu koszt_wykonania istniejące_porównanie istniejąca_wartość_wylicz wyrażenie nazwa_rozszerzenia nazwa_rodziny nazwa_fdw ffunk nazwa_pliku filter_variable dla tabeli "%s.%s" wymuszenie punkty kontrolne logów transakcji tabela obca nazwa_formatu element_z z_listy nazwa_funkcji_from_sql funkcja wymagana jest nazwa funkcji
nazwa_funkcji porządkuje śmieci i opcjonalnie analizuje bazy danych generuje powiadomienie funkcja_gettoken nazwa_grupy element_grupowania funkcja_uchwytu funkcja_nagłówkowa historia nie jest obsługiwana przez tą instalację
niezmienny importuje definicje tabel z obcego serwera przypisanie przyrost indeks nazwa_kolumny_indeksu wyrażenie_indeksu metoda_indeksowania nazwa_indeksu parametry_indeksu parametry_indeksu w ograniczeniach UNIQUE, PRIMARY KEY i EXCLUDE to: predykat_indeksu funkcja_inicjująca warunek_początkowy uchwyt_wbudowany funkcja_wejścia wstaw instaluje nowe rozszerzenie liczba_całkowita wewnętrzna_długość niepoprawny binarny "%s" niepoprawne polecenie \%s
nieprawidłowy numer linii: %s
niepoprawny format wyjścia (błąd wewnętrzny): %d wywołujący czyszablon kolumna_złączana warunek_złączenia procedura_złączenia typ_złączenia etykieta nazwa_jęz oid_dużego_obiektu lc_collate lc_ctype typ_lewy funkcja_lexize funkcja_lextypes opcja_podobne typ_podobne link_symbolicz nasłuchuje powiadomień wczytuje współdzieloną bibliotekę plików lokalne gniazdo sieciowe schemat_lokalny lokalizacja blokuje tabelę tryb_blokady loid widok zmaterializowany wartośćmaks obiekt_składowy metoda mffunk warunek_mpoczątkowy wartośćmin fnwmin więcej niż jeden wiersz zwrócony z \gset
msfunk rozm_danych_mstanu typ_danych_mstanu nazwa op_neg nowa_nazwa_atrybutu nowa_nazwa_kolumny nowa_nazwa_ograniczenia nowy_słownik nowa_nazwa_wylicz nowa_nazwa nowy_właściciel nowa_rola nowy_schemat nowa_tabela nowa_przestrzeńtabel nowa_wersja nie brak bufora zapytania
nie zwrócono żadnych wierszy z \gset
zwykły niepusty pusty_ciąg_znaków plik_obj nazwa_obiektu wyłączone stary_słownik stara_rola stara_wersja włączone typ_op klasa_op operator klasa operatora rodzina operatora nazwa_operatora opcja albo stara składnia brak pamięci brak pamięci
wyrażenie_wyjścia funkcja_wyjścia nazwa_wyjścia parametr tabela_nadrzędna nazwa_analizatora hasło ładunek pclose nie powiodło się: %s nazwa_polityki pozycjonuje kursor orzeczenie preferowane przygotowuje wyrażenie do wykonania przygotowane bieżącej transakcji do zatwierdzenia dwufazowego klucz główny, dostawca psql jest interaktywnym terminalem PostgreSQL.
zmienne psql:
zapytanie znak_cytatu przebudowuje indeksy funkcja_odbierająca kolumnaref nazwa_tabeli_odwołania tabelaref nazwa_relacji schemat_zdalny usuwa rzutowanie usuwa porównanie usuwa konwersję usuwa typ danych usuwa bazę danych usuwa rolę bazy danych usuwa domenę usuwa deskryptor serwera obcego usuwa tabelę obcą usuwa opakowanie obcych danych usuwa funkcję usuwa widok zmaterializowany usuwa język proceduralny usuwa regułę przepisania usuwa politykę bezpieczeństwa na poziomie wierszy z tabeli usuwa schemat usuwa sekwencję usuwa tabelę usuwa przestrzeń tabel usuwa konfigurację wyszukiwania tekstowego usuwa słownik wyszukiwania tekstowego usuwa analizator wyszukiwania tekstowego usuwa szablon wyszukiwania tekstowego usuwa transformację usuwa wyzwalacz usuwa mapowanie użytkownika dla serwera obcego usuwa widok usuwa uprawnienia dostępu usuwa metodę dostępu definiuje funkcję agregującą usuwa wyzwalacz zdarzenia usuwa rozszerzenie usuwa indeks usuwa operator usuwa klasę operatora usuwa rodzinę operatora usuwa obiekty bazy danych których właścicielem jest rola bazy danych zastępuje zawartość widoku materializowanego replika proc_res restart przywraca wartość domyślną parametru czasu wykonania ograniczony wiersze_wynikowe pobiera wiersze z zapytania przy użyciu kursora odczytuje wiersza z tabeli lub widoku typ_zwracany nazwa_reguły_przepisania typ_prawy nazwa_roli specyfikacja_roli wycofanie do punktu zapisu reguła nazwa_reguły bezpieczny metoda_próbkowania nazwa_punktu_zapisu element_schematu nazwa_schematu ziarno wybierz funkcja_wysyłająca sekwencja nazwa_sekwencji serialfunk nazwa_serwera typ_serwera wersja_serwera ustawia pomiar czasu ograniczeń sprawdzających dla bieżącej transakcji ustawia charakterystyki bieżącej transakcji ustawia identyfikator bieżącego użytkownika z bieżącej sesji ustawia identyfikator użytkownika sesji i identyfikator bieżącego użytkownika z bieżącej sesji sfunk pokazuje plan wykonania wyrażenia pokazuje wartość parametru czasu wykonania pomijanie rekurencyjnego rozszerzania zmiennej "%s"
id_migawki wyrażenie_sortowania nazwa_rodziny_sortowania operator_sortowania konfiguracja_źródła kodowanie_źródła tabela_źródłowa typ_źródłowy specjalny stabilny początek początek bloku transakcji funkcja_startowa rozm_danych_stanu typ_danych_stanu wyrażenie zatrzymuje nasłuchiwania powiadomień nośnik parametr_przechowywania typ_przechowywania numer_strategii pod-SELECT podtyp funkcja_różnicy_podtypu klasa_operatora_podtypu numer_obsługi nie udało się zakończyć zapytania tabulatorem: %s
Zapytanie to:
%s
tabela ograniczenie tabeli ograniczenie_tabeli ograniczenie_tabeli_używające_indeksu nazwa_tabeli nazwa_przestrzenitabel opcja_przestrzeni_tabel rola_docelowa typ_docelowy szablon tekst znacznik_czasu strefa_czasowa nazwa_funkcji_to_sql typ_tokenu id_transakcji tryb_transakcji wyzwalacz nazwa_wyzwalacza próba wyjścia z trybu kopiowanie typ funkcja_przyjmująca_modyfikator_typu funkcja_zwracająca_modyfikator_typu nazwa_typu uid nieoczekiwany PQresultStatus: %d
nieoczekiwany stan wyniku dla \watch
nieoczekiwany status transakcji (%d)
klucz unikalny, nieznany nierozpoznana wartość "%s" dla "%s"; przyjęto "%s"
niebezpieczny niezakończona stała łańcuchowa
modyfikuj modyfikuje wiersze w tabeli użytkownik nie istnieje niepowodzenie wyszukiwania nazwy użytkownika: kod błędu %lu nazwa_użytkownika wyrażenie_using lista_użycia funkcja_walid funkcja_walidatora wartość wartości wersja widok wymagana jest nazwa widoku
nazwa_opcji_przeglądania wartość_opcji_przeglądania zmienny gdzie skrót_przyznania_lub_odebrania_uprawnień to jedno z: gdzie akcja to jedna z: gdzie podpis_agregatu to: gdzie ograniczenie_kolumny to: gdzie cel_konfliktu może być jednym z: gdzie ograniczenie to: gdzie kierunek może być pusty lub jednym z: gdzie zdarzenie może być jednym z: gdzie element_z może być jednym z: gdzie tryb_blokady jest jednym z: gdzie obiekt_składowy to: gdzie opcja może być jedną z: gdzie opcja może przyjmować: gdzie specyfikacja_roli może przyjmować: gdzie tryb_transakcji to jeden z: okno definicja_okna nazwa_okna z_kwerendy nazwa_kwerendy_z tak locale/pl/LC_MESSAGES/initdb-9.6.mo 0000644 00000056437 14751153421 0012345 0 ustar 00 �� � , � <
�
R �
* 5 - F g t ` � � = W W X � A � 5 � J / z 6 � P � C : b Q � 5 � ] % 4 � B � H � G D > � 4 � 9 3 : ? n / � - � > y K ( � # � , - ? 7 m ( � 6 � , ' 2 5 Z F � " � < � & 7 - ^ - � ! � 1 � ? & N / u = � ! � " 6 ( + _ � 0 � ; � $ / 4 & d � $ � ~ � 1 M < � G � 3 " 8 V ( � J � � � � C � - C! 8 q! ! �! , �! �! J " / \" 4 �" A �" @ # R D# K �# " �# ! $ � ($ d �$ % $% � C% [ �% R #& K v& % �& �& ' ' ; 7' ; s' � �' @ @( ; �( �( u �) q D* f �* s + & �+ �+ ) �+ t �+ / _, �, & �, 0 �, . �, ) %- ) O- y- �- & �- # �- �- $ . ( 3. + \. " �. �. " �. ! �. , / $ 8/ * ]/ % �/ ! �/ �/ �/ 0 0 90 M0 Q0 `0 - r0 �0 & �0 % �0 3 1 ?1 Y1 ( m1 � �1 e �3 �3 4 4 C "4 w f4 u �4 � T5 [ 16 [ �6 �6 W 8 = \8 H �8 # �8 C 9 T K9 M �9 ? �9 Y .: A �: j �: 9 5; B o; H �; H �; @ D< A �< = �< ; = A A= - �= - �= O �= � /> ' �> 3 �> 9 -? / g? 5 �? + �? D �? 6 >@ ) u@ F �@ ` �@ 0 GA M xA + �A 3 �A 2 &B ( YB 9 �B @ �B + �B 1 )C K [C / �C ' �C A �C AD aD ; ~D I �D / E = 4E < rE �E ( �E � �E H �F = �F $ G U 6G ; �G A �G 4
H J ?H � �H HI [I G |I 0 �I < �I " 2J 0 UJ # �J _ �J 6
K 4 AK A vK P �K h L g rL - �L , M � 5M w �M NN gN � �N i O r �O S �O H QP �P + �P �P @ Q D BQ � �Q ? 'R K gR �R � �S z pT n �T e ZU 6 �U �U 0 V 4V < �V �V 0 W ; 5W 5 qW 2 �W 2 �W
X 'X ( @X ' iX �X , �X 2 �X > Y ' QY # yY % �Y 3 �Y 0 �Y / (Z B XZ - �Z ' �Z �Z [ % )[ O[ h[ l[ {[ 2 �[ . �[ 4 �[ 3 0\ ? d\ " �\ �\ > �\ � � 5 ( � Z � J l 6 H X � � K z � � � r I � � { � N d R V o | ~ � � . y U } � m � ` G = * f / $ � > _ � # A � t C 8 Y 0 T , � % + v L 3 � 2 n � � h B j E ? ] 9 ) ! & � � � q � � D S g
e ; ' ^ " F x c � w P [ s � @ i �
1 - \ � u : k � 4 W Q 7 O � < M p a b �
If the data directory is not specified, the environment variable PGDATA
is used.
Less commonly used options:
Options:
Other options:
Report bugs to <pgsql-bugs@postgresql.org>.
Success. You can now start the database server using:
%s%s%spg_ctl%s -D %s%s%s -l logfile start
Sync to disk skipped.
The data directory might become corrupt if the operating system crashes.
WARNING: enabling "trust" authentication for local connections
You can change this by editing pg_hba.conf or using the option -A, or
--auth-local and --auth-host, the next time you run initdb.
--auth-host=METHOD default authentication method for local TCP/IP connections
--auth-local=METHOD default authentication method for local-socket connections
--lc-collate=, --lc-ctype=, --lc-messages=LOCALE
--lc-monetary=, --lc-numeric=, --lc-time=LOCALE
set default locale in the respective category for
new databases (default taken from environment)
--locale=LOCALE set default locale for new databases
--no-locale equivalent to --locale=C
--pwfile=FILE read password for the new superuser from file
%s [OPTION]... [DATADIR]
-?, --help show this help, then exit
-A, --auth=METHOD default authentication method for local connections
-E, --encoding=ENCODING set default encoding for new databases
-L DIRECTORY where to find the input files
-N, --nosync do not wait for changes to be written safely to disk
-S, --sync-only only sync data directory
-T, --text-search-config=CFG
default text search configuration
-U, --username=NAME database superuser name
-V, --version output version information, then exit
-W, --pwprompt prompt for a password for the new superuser
-X, --xlogdir=XLOGDIR location for the transaction log directory
-d, --debug generate lots of debugging output
-k, --data-checksums use data page checksums
-n, --noclean do not clean up after errors
-s, --show show internal settings
[-D, --pgdata=]DATADIR location for this database cluster
%s initializes a PostgreSQL database cluster.
%s: "%s" is not a valid server encoding name
%s: WARNING: cannot create restricted tokens on this platform
%s: cannot be run as root
Please log in (using, e.g., "su") as the (unprivileged) user that will
own the server process.
%s: could not access directory "%s": %s
%s: could not access file "%s": %s
%s: could not allocate SIDs: error code %lu
%s: could not change permissions of "%s": %s
%s: could not change permissions of directory "%s": %s
%s: could not create directory "%s": %s
%s: could not create restricted token: error code %lu
%s: could not create symbolic link "%s": %s
%s: could not execute command "%s": %s
%s: could not find suitable encoding for locale "%s"
%s: could not find suitable text search configuration for locale "%s"
%s: could not fsync file "%s": %s
%s: could not get exit code from subprocess: error code %lu
%s: could not open directory "%s": %s
%s: could not open file "%s" for reading: %s
%s: could not open file "%s" for writing: %s
%s: could not open file "%s": %s
%s: could not open process token: error code %lu
%s: could not re-execute with restricted token: error code %lu
%s: could not read directory "%s": %s
%s: could not read password from file "%s": %s
%s: could not start process for command "%s": error code %lu
%s: could not stat file "%s": %s
%s: could not write file "%s": %s
%s: data directory "%s" not removed at user's request
%s: directory "%s" exists but is not empty
%s: encoding mismatch
%s: failed to remove contents of data directory
%s: failed to remove contents of transaction log directory
%s: failed to remove data directory
%s: failed to remove transaction log directory
%s: failed to restore old locale "%s"
%s: file "%s" does not exist
%s: file "%s" is not a regular file
%s: input file "%s" does not belong to PostgreSQL %s
Check your installation or specify the correct path using the option -L.
%s: input file location must be an absolute path
%s: invalid authentication method "%s" for "%s" connections
%s: invalid locale name "%s"
%s: invalid locale settings; check LANG and LC_* environment variables
%s: locale "%s" requires unsupported encoding "%s"
%s: locale name has non-ASCII characters, skipped: "%s"
%s: locale name too long, skipped: "%s"
%s: must specify a password for the superuser to enable %s authentication
%s: no data directory specified
You must identify the directory where the data for this database system
will reside. Do this with either the invocation option -D or the
environment variable PGDATA.
%s: out of memory
%s: password file "%s" is empty
%s: password prompt and password file cannot be specified together
%s: removing contents of data directory "%s"
%s: removing contents of transaction log directory "%s"
%s: removing data directory "%s"
%s: removing transaction log directory "%s"
%s: setlocale() failed
%s: superuser name "%s" is disallowed; role names cannot begin with "pg_"
%s: symlinks are not supported on this platform %s: too many command-line arguments (first is "%s")
%s: transaction log directory "%s" not removed at user's request
%s: transaction log directory location must be an absolute path
%s: warning: specified text search configuration "%s" might not match locale "%s"
%s: warning: suitable text search configuration for locale "%s" is unknown
Data page checksums are disabled.
Data page checksums are enabled.
Encoding "%s" implied by locale is not allowed as a server-side encoding.
The default database encoding will be set to "%s" instead.
Encoding "%s" is not allowed as a server-side encoding.
Rerun %s with a different locale selection.
Enter it again: Enter new superuser password: If you want to create a new database system, either remove or empty
the directory "%s" or run %s
with an argument other than "%s".
If you want to store the transaction log there, either
remove or empty the directory "%s".
It contains a dot-prefixed/invisible file, perhaps due to it being a mount point.
It contains a lost+found directory, perhaps due to it being a mount point.
No usable system locales were found.
Passwords didn't match.
Rerun %s with the -E option.
Running in debug mode.
Running in noclean mode. Mistakes will not be cleaned up.
The database cluster will be initialized with locale "%s".
The database cluster will be initialized with locales
COLLATE: %s
CTYPE: %s
MESSAGES: %s
MONETARY: %s
NUMERIC: %s
TIME: %s
The default database encoding has accordingly been set to "%s".
The default text search configuration will be set to "%s".
The encoding you selected (%s) and the encoding that the
selected locale uses (%s) do not match. This would lead to
misbehavior in various character string processing functions.
Rerun %s and either do not specify an encoding explicitly,
or choose a matching combination.
The files belonging to this database system will be owned by user "%s".
This user must also own the server process.
The program "postgres" is needed by %s but was not found in the
same directory as "%s".
Check your installation.
The program "postgres" was found by "%s"
but was not the same version as %s.
Check your installation.
This might mean you have a corrupted installation or identified
the wrong directory with the invocation option -L.
Try "%s --help" for more information.
Usage:
Use the option "--debug" to see details.
Using a mount point directly as the data directory is not recommended.
Create a subdirectory under the mount point.
cannot duplicate null pointer (internal error)
caught signal
child process exited with exit code %d child process exited with unrecognized status %d child process was terminated by exception 0x%X child process was terminated by signal %d child process was terminated by signal %s command not executable command not found could not change directory to "%s": %s could not close directory "%s": %s
could not find a "%s" to execute could not get junction for "%s": %s
could not identify current directory: %s could not look up effective user ID %ld: %s could not open directory "%s": %s
could not read binary "%s" could not read directory "%s": %s
could not read symbolic link "%s" could not remove file or directory "%s": %s
could not set junction for "%s": %s
could not stat file or directory "%s": %s
could not write to child process: %s
creating configuration files ... creating directory %s ... creating subdirectories ... fixing permissions on existing directory %s ... invalid binary "%s" ok
out of memory
pclose failed: %s performing post-bootstrap initialization ... running bootstrap script ... selecting default max_connections ... selecting default shared_buffers ... selecting dynamic shared memory implementation ... syncing data to disk ... user does not exist user name lookup failure: error code %lu Project-Id-Version: initdb (PostgreSQL 9.1)
Report-Msgid-Bugs-To: pgsql-bugs@postgresql.org
POT-Creation-Date: 2016-07-03 03:14+0000
PO-Revision-Date: 2016-07-03 17:28+0200
Last-Translator: grzegorz <begina.felicysym@wp.eu>
Language-Team: begina.felicysym@wp.eu
Language: pl
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Plural-Forms: nplurals=3; plural=(n==1 ? 0 : n%10>=2 && n%10<=4 && (n%100<10 || n%100>=20) ? 1 : 2);
X-Generator: Virtaal 0.7.1
Jeśli katalog nie jest wskazany wtedy używana jest zmienna PGDATA
do określenia tegoż katalogu.
Rzadziej używane opcje:
Opcje:
Pozostałe opcje:
Błędy proszę przesyłać na adres <pgsql-bugs@postgresql.org>.
Sukces. Teraz możesz uruchomić serwer bazy danych używając:
%s%s%s%spg_ctl -D %s%s%s -l plik_z_logami start
Pominięto synchronizację na dysk.
Folder danych może zostać uszkodzona jeśli system operacyjny ulegnie awarii.
OSTRZEŻENIE: metoda autoryzacji ustawiona jako "trust" dla połączeń lokalnych
Można to zmienić edytując plik pg_hba.conf, używając opcji -A, lub
--auth-local oraz --auth-host przy kolejnym uruchomieniu initdb.
--auth-host=METODA podstawowa metoda autoryzacji dla lokalnych połączeń TCP/IP
--auth-local=METODA podstawowa metoda autoryzacji dla lokalnych gniazd połączeń
--lc-collate=, --lc-ctype=, --lc-messages=LOCALE
--lc-monetary=, --lc-numeric=, --lc-time=LOCALE
ustawia domyślną lokalizację w odpowiedniej kategorii
dla nowych baz danych (domyślnie pobierana ze środowiska)
--locale=LOKALIZACJA ustawia domyślną lokalizację dla nowych baz danych
--no-locale równoważna z opcją --locale=C
--pwfile=PLIK czyta hasło dla właściciela bazy z pliku
%s [OPCJA]... [KATALOG-DOCELOWY]
-?, --help pokaż tą pomoc i zakończ działanie
-A, --auth=METODA podstawowa metoda autoryzacji dla lokalnych połączeń
-E, --encoding=KODOWANIE ustawia podstawowe kodowanie dla nowej bazy
-L KATALOG gdzie szukać plików wejściowych
-N, --nosync nie czekać aż zmiany zostaną bezpiecznie zapisane na dysk
-S, --sync-only synchronizować tylko katalog danych
-T, --text-search-config=CFG
domyślna konfiguracja wyszukiwania tekstowego
-U, --username=NAZWA superużytkownik bazy danych
-V, --version pokaż informacje o wersji i zakończ
-W, --pwprompt proś o hasło dla nowego superużytkownika
-X, --xlogdir=XLOGDIR umiejscowienie folderu dziennika transakcji
-d, --debug wyświetlanie informacji debugger'a
-k, --data-checksums użycie sum kontrolnych danych stron
-n, --noclean błędy nie będą porządkowane
-s, --show pokaż wewnętrzne ustawienia
[-D, --pgdata=]KATALOG-DOCELOWY lokalizacja klastra bazy danych
%s inicjuje klaster bazy danych PostgreSQL.
%s: "%s" nie jest poprawną nazwą kodowania
%s: OSTRZEŻENIE: nie można tworzyć ograniczonych tokenów na tej platformie
%s: nie można uruchomić jako root
Proszę zalogować się (używając np: "su") na (nieuprzywilejowanego) użytkownika, który
będzie właścicielem procesu.
%s: brak dostępu do katalogu "%s": %s
%s: nie można uzyskać dostępu do pliku "%s": %s
%s: nie udało się przydzielić SIDów: kod błędu %lu
%s: nie można zmienić uprawnień do "%s": %s
%s: nie można zmienić uprawnień katalogu "%s": %s
%s: nie można utworzyć katalogu "%s": %s
%s: nie udało się utworzyć ograniczonego tokena: kod błędu %lu
%s: nie można utworzyć linku symbolicznego "%s": %s
%s: nie można wykonać komendy "%s": %s
%s: nie można znaleźć odpowiedniego kodowania dla lokalizacji "%s"
%s: nie można znaleźć odpowiedniej konfiguracji wyszukiwania tekstowego dla lokalizacji "%s"
%s: nie można wykonać fsync na pliku "%s": %s
%s: nie udało uzyskać kodu wyjścia z usługi podrzędnej: kod błędu %lu
%s: nie można otworzyć katalogu "%s": %s
%s: nie można otworzyć pliku "%s" do odczytu: %s
%s: nie można otworzyć pliku "%s" do zapisu: %s
%s: nie można otworzyć pliku "%s": %s
%s: nie można otworzyć tokenu procesu: kod błędu %lu
%s: nie udało się ponownie wykonać ograniczonego tokena: %lu
%s: nie można odczytać katalogu "%s": %s
%s: nie można odczytać hasła z pliku "%s": %s
%s: nie udało się uruchomić procesu dla polecenia "%s": kod błędu %lu
%s: nie można wykonać stat na pliku "%s": %s
%s: nie można zapisać pliku "%s": %s
%s: katalog "%s" nie został usunięty na żądanie użytkownika
%s: folder "%s" nie jest pusty
%s: niezgodność kodowania
%s: nie udało się usunąć zawartości w katalogu danych
%s: nie udało się usunąć zawartości w katalogu dziennika transakcji
%s: nie udało się usunięcie katalogu danych
%s: nie udało się usunięcie katalogu dziennika transakcji
%s: nie udało się odtworzyć poprzedniej lokalizacji "%s"
%s: plik "%s" nie istnieje
%s: plik "%s" nie jest zwykłym plikiem
%s: plik wejściowy "%s" nie należy do bazy danych PostgreSQL %s
Sprawdź swoją instalację lub podaj poprawą ścieżkę przy pomocy zmiennej -L.
%s: położenie plików wejściowych musi być ścieżką bezwzględną
%s: niepoprawna metoda autoryzacji "%s" dla połączeń "%s"
%s: błędna nazwa lokalizacji "%s"
%s: nieprawidłowe ustawienia regionalne; sprawdź zmienne środowiskowe LANG i LC_*
%s: lokalizacja "%s" wymaga nie wspieranego kodowania "%s"
%s: nazwa lokalizacji zawiera znak spoza ASCII, pominięto: "%s"
%s: nazwa lokalizacji zbyt długa, pominięto: "%s"
%s: musisz podać hasło superużytkownika aby aktywować %s autoryzację
%s: nieustawiony katalog danych
Musisz podać katalog gdzie będą przechowywane dane bazy danych.
Możesz tego dokonać używając opcji -D lub przy pomocy
zmiennej środowiskowej PGDATA.
%s: brak pamięci
%s: plik hasła "%s" jest pusty
%s: prośba o hasło i plik hasła nie mogą być podane jednocześnie
%s: usuwanie zawartości w katalogu danych "%s"
%s: usuwanie zawartości katalogu dziennika transakcji "%s"
%s: usuwanie katalogu danych "%s"
%s: usuwanie katalogu dziennika transakcji "%s"
%s: setlocale() nie powiodła się
%s: nazwa superużytkownika "%s" jest zabroniona; nazwy ról nie mogą zaczynać się od "pg_"
%s: linki symb. nie są obsługiwane na tej platformie %s: za duża ilość parametrów (pierwszy to "%s")
%s: katalog "%s" nie został usunięty na żądanie użytkownika
%s: położenie folderu dziennika transakcji musi być ścieżką bezwzględną
%s: ostrzeżenie: wskazana konfiguracja wyszukiwania tekstu "%s" może nie pasować do lokalizacji "%s"
%s: ostrzeżenie: nie jest znana odpowiednia konfiguracja wyszukiwania tekstowego dla lokalizacji "%s"
Sumy kontrolne stron danych są zablokowane.
Sumy kontrolne stron danych są włączone.
Kodowanie "%s" określone przez lokalizację jest niedozwolone jako kodowanie po stronie serwera.
Kodowanie bazy danych będzie zamiast tego ustawiona na "%s".
Kodowanie "%s" jest niedozwolone jako kodowanie po stronie serwera.
Uruchom ponownie %s z wybraną inną lokalizacją.
Powtórz podane hasło: Podaj hasło superużytkownika: Jeśli chcesz utworzyć nową bazę danych, usuń lub wyczyść
katalog "%s" lub uruchom program %s
z argumentem wskazującym katalog innym niż "%s".
Jeśli chcesz tam przechowywać dziennik transakcji, albo
usuń albo wyczyść zawartość folderu "%s".
Zawiera on tylko zaczynający się kropką/niewidoczny plik, być może dlatego, że był to punkt podłączenia.
Zawiera on folder lost+found, być może dlatego, że był to punkt podłączenia.
Nie znaleziono lokalizacji systemowej nadającej się do wykorzystania.
Podane hasła różnią się.
Włącz polecenie %s ponownie z opcją -E.
Działanie w trybie debug.
Działanie w trybie nonclean. Błędy nie będą porządkowane.
Klaster bazy zostanie utworzony z zestawem reguł językowych "%s".
Klaster bazy danych zostanie utworzony z zestawem reguł językowych
COLLATE: %s
CTYPE: %s
MESSAGES: %s
MONETARY: %s
NUMERIC: %s
TIME: %s
Podstawowe kodowanie bazy danych zostało ustawione jako "%s".
Domyślna konfiguracja wyszukiwania tekstowego zostanie ustawiona na "%s".
Wybrane kodowanie (%s) i kodowanie używane przez
lokalizację (%s) nie zgadzają się. Może to prowadzić
do błędów w wielu funkcjach przetwarzających ciągi znaków.
Aby poprawić ten błąd uruchom ponownie %s i albo nie ustawiaj kodowania
albo wybierz pasującą kombinację.
Właścicielem plików należących do sytemu bazy danych będzie użytkownik "%s".
Ten użytkownik musi jednocześnie być właścicielem procesu serwera.
Program "postgres" jest wymagany przez %s ale nie został znaleziony
w tym samym folderze co "%s".
Sprawdź instalację.
Program "postgres" został znaleziony przez "%s"
ale nie jest w tej samej wersji co %s.
Sprawdź instalację.
Oznacza to iż posiadasz uszkodzoną instalację lub wskazałeś
zły katalog przy użyciu opcji -L.
Spróbuj "%s --help" aby uzyskać więcej informacji.
Składnia:
Użyj opcji "--debug" by zobaczyć szczegóły.
Użycie punktu zamontowania bezpośrednio jako folderu danych nie jest zalecane.
Lepiej utworzyć podfolder punktu montowania.
nie można powielić pustego wskazania (błąd wewnętrzny)
sygnał otrzymany
proces potomny zakończył działanie z kodem %d proces potomny zakończył działanie z nieznanym stanem %d proces potomny został zatrzymany przez wyjątek 0x%X proces potomny został zatrzymany przez sygnał %d proces potomny został zatrzymany przez sygnał %s polecenie nie wykonywalne polecenia nie znaleziono nie można zmienić katalogu na "%s": %s nie można zamknąć katalogu "%s": %s
nie znaleziono "%s" do wykonania nie można pobrać złączenia dla "%s": %s
nie można zidentyfikować aktualnego katalogu: %s nie udało się odnaleźć efektywnego ID użytkownika %ld: %s nie można otworzyć katalogu "%s": %s
nie można odczytać binarnego "%s" nie można czytać katalogu "%s": %s
nie można odczytać odwołania symbolicznego "%s" nie można usunąć pliku lub katalogu "%s": %s
nie można ustanowić złączenia dla "%s": %s
nie można wykonać polecenia stat na pliku lub katalogu "%s": %s
nie można zapisać do procesu potomnego: %s
tworzenie plików konfiguracyjnych ... tworzenie katalogu %s ... tworzenie podkatalogów ... ustalanie uprawnień katalogu %s ... niepoprawny binarny "%s" ok
brak pamięci
pclose nie powiodło się: %s wykonywanie inicjacji po ładowaniu wstępnym ... wykonywanie skryptu ładowania wstępnego ... wybieranie domyślnej wartości max_connections ... wybieranie domyślnej wartości shared_buffers ... wybór implementacji dynamicznej pamięci współdzielonej ... synchronizacja danych na dysk ... użytkownik nie istnieje niepowodzenie wyszukiwania nazwy użytkownika: kod błędu %lu locale/pl/LC_MESSAGES/libpq5-9.6.mo 0000644 00000057441 14751153421 0012264 0 ustar 00 �� � � � P Q b e j p �
� ' � ( � � # 9 M $ Z �
� 0 � ( � ( @ J V 5 ] 8 � � $ � # 6 B - T � � . � ( � , ? R : a " � � � < � a % 0 � ) � ' � *
. 5 + d ' � ' � * � * + 6 * b , � ) � ) � + - : / h + � ( � ) � & 5 > 3 t & � ! � � ! " = ` v } w � r l � ! " ' ? - g � � > ) # h 9 � & � ) � * # B 9 f ) � ' � ) � ) : " d 9 � . � ' � * ! " C! " f! . �! / �! - �! @ " 2 W" ! �" % �" % �" V �" = O# ; �# �# �# $ 4 &$ 0 [$ �$ : �$ �$ % %% - F% - t% �% + �% 2 �% 7 & = U& ! �& . �& 8 �& " ' @' F `' C �' $ �' ( B +( n( ~( ; �( ( �( * ) & +) % R) ! x) 6 �) C �) ? * 2 U* 1 �* = �* ) �* J "+ m+ �+ �+ �+ �+ 1 �+
", 0, + ?, k, ) �, " �, [ �, 3- ? L- 1 �- 8 �- > �- � 6. # �. �. : �. � +/ 2 �/ Q �/ J :0 K �0 �0 $ �0 % 1 # 91 $ ]1 % �1 ? �1 ! �1 +
2 62 G2 L c2 D �2 % �2 . 3 C J3 �3 $ �3 5 �3 )
4 � 44 !6 *6 -6 26 86 L6 e6 1 t6 2 �6 " �6 , �6 )7 A7 - S7 �7 �7 �7 2 �7 1 �7 1 08
b8 m8 |8 = �8 @ �8 " 9 & $9 4 K9 �9 �9 / �9 �9 �9 , : $ ;: 4 `: �: �: 9 �: + �: ; 9; ? L; � �; 9 < 5 P< ) �< 1 �< 5 �< 2 = / K= ) {= ) �= ) �= * �= ) $> + N> ( z> ( �> * �> , �> . $? * S? ' ~? ( �? + �? A �? H =@ + �@ + �@ # �@ A ) !A $ KA pA � �A � B � �B $ +C ' PC ! xC + �C 2 �C � �C M �D 0 �D 6 $E ) [E - �E 1 �E ) �E A F 6 QF < �F 0 �F $ �F 0 G $ LG C qG E �G * �G / &H * VH 2 �H ; �H G �H 5 8I L nI 9 �I $ �I & J $ AJ j fJ : �J T K ! aK ! �K ! �K < �K 4 L ! 9L E [L �L 2 �L 2 �L @ $M @ eM �M 9 �M B �M E ?N O �N - �N ; O G ?O , �O ! �O X �O N /P * ~P ! �P N �P Q ! 2Q G TQ 2 �Q 0 �Q * R ) +R + UR ; �R S �R M S I _S ? �S Q �S 8 ;T W tT �T �T �T 1 U $ IU 1 nU
�U �U 1 �U $ �U - V BV � aV �V B �V 5 AW = wW V �W � X + �X �X < �X � Y 2 �Y b �Y Z VZ [ �Z "
[ 0 0[ 1 a[ / �[ 0 �[ 1 �[ M &\ ( t\ / �\ ! �\ �\ K ] P Z] , �] 4 �] F
^ ! T^ ' v^ B �^ ? �^ � � ~ l � ? � N � m , K f � d � F > � s ( � k T � 2 � � a � � - E � S # � 3 Y t �
* � � � � Q 5 4 � � y � � R 8 9 / [ J � + � Z w ` r n � � � I L % � � x
b � 6 1 � � � � � ; ^ ! : � � � V c D & � \ p u P M � � � 7 � } q � � o � � H � @ v " U | W � B � C � 0 � h � $ i � _ � � . � � � � X < � g e = ' � � � � � ) � { G z � A ] j � � � O � � � � � at character %s %s %s, %s:%s COLUMN NAME: %s
CONSTRAINT NAME: %s
CONTEXT: %s
COPY IN state must be terminated first
COPY OUT state must be terminated first
COPY terminated by new PQexec Crypt authentication not supported
DATATYPE NAME: %s
DETAIL: %s
GSSAPI authentication not supported
GSSAPI continuation error GSSAPI name import error HINT: %s
IPv6 host address may not be empty in URI: "%s"
Kerberos 4 authentication not supported
Kerberos 5 authentication not supported
LINE %d: LOCATION: NOTICE PGEventProc "%s" failed during PGEVT_CONNRESET event
PGEventProc "%s" failed during PGEVT_RESULTCREATE event
PGresult is not an error result
PQexec not allowed during COPY BOTH
PQgetline: not doing text COPY OUT
QUERY: %s
SCHEMA NAME: %s
SCM_CRED authentication method not supported
SSL SYSCALL error: %s
SSL SYSCALL error: EOF detected
SSL certificate's name contains embedded null
SSL certificate's name entry is missing
SSL connection has been closed unexpectedly
SSL error code %lu SSL error: %s
SSL library does not support CRL certificates (file "%s")
SSPI authentication not supported
SSPI continuation error TABLE NAME: %s
Unix-domain socket path "%s" is too long (maximum %d bytes)
WARNING: password file "%s" has group or world access; permissions should be u=rw (0600) or less
WARNING: password file "%s" is not a plain file
WSAIoctl(SIO_KEEPALIVE_VALS) failed: %ui
another command is already in progress
argument of lo_read exceeds integer range
argument of lo_truncate exceeds integer range
argument of lo_write exceeds integer range
attribute has no values on LDAP lookup
authentication method %u not supported
cannot determine OID of function lo_close
cannot determine OID of function lo_creat
cannot determine OID of function lo_create
cannot determine OID of function lo_lseek
cannot determine OID of function lo_lseek64
cannot determine OID of function lo_open
cannot determine OID of function lo_tell
cannot determine OID of function lo_tell64
cannot determine OID of function lo_truncate
cannot determine OID of function lo_truncate64
cannot determine OID of function lo_unlink
cannot determine OID of function loread
cannot determine OID of function lowrite
certificate could not be obtained: %s
certificate does not match private key file "%s": %s
certificate present, but not private key file "%s"
column number %d is out of range 0..%d command string is a null pointer
connection in wrong state
connection not open
connection pointer is NULL
could not acquire SSPI credentials could not acquire mutex: %s
could not connect to server: %s
Is the server running locally and accepting
connections on Unix domain socket "%s"?
could not connect to server: %s
Is the server running on host "%s" (%s) and accepting
TCP/IP connections on port %s?
could not connect to server: %s
Is the server running on host "%s" and accepting
TCP/IP connections on port %s?
could not create LDAP structure
could not create SSL context: %s
could not create socket: %s
could not establish SSL connection: %s
could not get client address from socket: %s
could not get home directory to locate root certificate file
Either provide the file or change sslmode to disable server certificate verification.
could not get home directory to locate service definition file could not get peer credentials: %s
could not get server's host name from server certificate
could not get socket error status: %s
could not initialize SSL engine "%s": %s
could not interpret result from server: %s could not load SSL engine "%s": %s
could not load private SSL key "%s" from engine "%s": %s
could not load private key file "%s": %s
could not look up local user ID %d: %s
could not open certificate file "%s": %s
could not open file "%s": %s
could not read certificate file "%s": %s
could not read from file "%s": %s
could not read private SSL key "%s" from engine "%s": %s
could not read root certificate file "%s": %s
could not receive data from server: %s
could not send SSL negotiation packet: %s
could not send data to server: %s
could not send startup packet: %s
could not set socket to TCP no delay mode: %s
could not set socket to close-on-exec mode: %s
could not set socket to nonblocking mode: %s
could not translate Unix-domain socket path "%s" to address: %s
could not translate host name "%s" to address: %s
could not write to file "%s": %s
definition of service "%s" not found
duplicate GSS authentication request
end of string reached when looking for matching "]" in IPv6 host address in URI: "%s"
expected authentication request from server, but received %c
extra key/value separator "=" in URI query parameter: "%s"
extraneous data in "D" message extraneous data in "T" message extraneous data in "t" message forbidden value %%00 in percent-encoded value: "%s"
function requires at least protocol version 3.0
host name must be specified
host name must be specified for a verified SSL connection
incomplete multibyte character
insufficient data in "D" message insufficient data in "T" message integer of size %lu not supported by pqGetInt integer of size %lu not supported by pqPutInt invalid ExecStatusType code invalid LDAP URL "%s": invalid port number
invalid LDAP URL "%s": missing distinguished name
invalid LDAP URL "%s": must have exactly one attribute
invalid LDAP URL "%s": must have search scope (base/one/sub)
invalid LDAP URL "%s": no filter
invalid LDAP URL "%s": scheme must be ldap://
invalid URI propagated to internal parser routine: "%s"
invalid URI query parameter: "%s"
invalid connection option "%s"
invalid connection state %d, probably indicative of memory corruption
invalid connection state, probably indicative of memory corruption
invalid percent-encoded token: "%s"
invalid port number: "%s"
invalid setenv state %c, probably indicative of memory corruption
invalid socket
invalid sslmode value: "%s"
invalid state %c, probably indicative of memory corruption
keepalives parameter must be an integer
length must be given for binary parameter
line %d too long in service file "%s"
local user with ID %d does not exist
lookup on LDAP server failed: %s
lost synchronization with server, resetting connection lost synchronization with server: got message type "%c", length %d
message contents do not agree with length in message type "%c"
message type 0x%02x arrived from server while idle missing "=" after "%s" in connection info string
missing key/value separator "=" in URI query parameter: "%s"
more than one entry found on LDAP lookup
nested service specifications not supported in service file "%s", line %d
no COPY in progress
no SSL error reported no connection to the server
no entry found on LDAP lookup
no error message available
number of parameters must be between 0 and 65535
out of memory out of memory
out of memory allocating GSSAPI buffer (%d) out of memory for query result parameter number %d is out of range 0..%d password retrieved from file "%s"
private key file "%s" has group or world access; permissions should be u=rw (0600) or less
protocol error: id=0x%x
query to initialize large object functions did not return data
received invalid response to SSL negotiation: %c
requirepeer parameter is not supported on this platform
requirepeer specifies "%s", but actual peer user name is "%s"
root certificate file "%s" does not exist
Either provide the file or change sslmode to disable server certificate verification.
row number %d is out of range 0..%d select() failed: %s
server certificate for "%s" does not match host name "%s"
server closed the connection unexpectedly
This probably means the server terminated abnormally
before or while processing the request.
server does not support SSL, but SSL was required
server sent binary data ("B" message) without prior row description ("T" message) server sent data ("D" message) without prior row description ("T" message) server sent data ("D" message) without prior row description ("T" message)
service file "%s" not found
setsockopt(SO_KEEPALIVE) failed: %s
setsockopt(TCP_KEEPALIVE) failed: %s
setsockopt(TCP_KEEPCNT) failed: %s
setsockopt(TCP_KEEPIDLE) failed: %s
setsockopt(TCP_KEEPINTVL) failed: %s
sslmode value "%s" invalid when SSL support is not compiled in
statement name is a null pointer
syntax error in service file "%s", line %d
timeout expired
unexpected asyncStatus: %d
unexpected character "%c" at position %d in URI (expected ":" or "/"): "%s"
unexpected character %c following empty query response ("I" message) unexpected field count in "D" message unexpected message from server during startup
unexpected response from server; first received character was "%c"
unrecognized SSL error code: %d
unrecognized socket error: 0x%08X/%d unterminated quoted string in connection info string
user name lookup failure: error code %lu
Project-Id-Version: libpq (PostgreSQL 9.1)
Report-Msgid-Bugs-To: pgsql-bugs@postgresql.org
POT-Creation-Date: 2016-07-03 03:08+0000
PO-Revision-Date: 2016-07-03 17:29+0200
Last-Translator: grzegorz <begina.felicysym@wp.eu>
Language-Team: begina.felicysym@wp.eu
Language: pl
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Plural-Forms: nplurals=3; plural=(n==1 ? 0 : n%10>=2 && n%10<=4 && (n%100<10 || n%100>=20) ? 1 : 2);
X-Generator: Virtaal 0.7.1
znak %s %s %s, %s:%s NAZWA KOLUMNY: %s
NAZWA OGRANICZENIA: %s
KONTEKST: %s
stan COPY IN musi zostać wcześniej zakończony
stan COPY OUT musi zostać wcześniej zakończony
COPY zakończone przez nowe PQexec metoda autoryzacji Crypt nie jest dostępna
NAZWA TYPU DANYCH: %s
SZCZEGÓŁY: %s
Metoda autoryzacji GSSAPI nie jest dostępna
błąd kontynuowania GSSAPI błąd importu nazwy GSSAPI PODPOWIEDŹ: %s
adres IPv6 hosta nie może być pusty w URI: "%s"
metoda autoryzacji Kerberos 4 nie jest dostępna
metoda autoryzacji Kerberos 5 nie jest dostępna
LINIA %d: POŁOŻENIE: UWAGA PGEventProc "%s" zawiodła podczas zdarzenia PGEVT_CONNRESET
PGEventProc "%s" zawiodła podczas zdarzenia PGEVT_RESULTCREATE
PGresult nie jest wynikiem błedu
PQexec niedozwolone podczas COPY BOTH
PQgetline: nie działam aktualnie w stanie COPY OUT
ZAPYTANIE: %s
NAZWA SCHEMATU: %s
Metoda autoryzacji SCM_CRED nie jest dostępna
błąd SSL SYSCALL: %s
błąd SSL SYSCALL: wykryto EOF
nazwa certyfikatu SSL zawiera osadzony null
brak wejścia nazwy certyfikatu SSL
Połączenie SSL zostało nieoczekiwanie zamknięte
kod błędu SSL %lu błąd SSL: %s
biblioteka SSL nie wspiera certyfikatów CRL (plik "%s")
Metoda autoryzacji SSPI nie jest dostępna
błąd kontynuowania SSPI NAZWA TABELI: %s
Za długa ścieżka gniazda domeny Unix "%s" (maks %d bajtów)
UWAGA: plik hasła "%s" posiada globalne lub grupowe uprawnienia odczytu;
uprawniania powinny być ustawione na u=rw (0600) lub słabsze
OSTRZEŻENIE: plik hasła "%s" nie jest zwykłym plikiem
nie powiodło się WSAIoctl(SIO_KEEPALIVE_VALS): %ui
inne polecenie jest aktualnie wykonywane
argument lo_read jest spoza zakresu typu integer
argument lo_truncate jest spoza zakresu typu integer
argument lo_write jest spoza zakresu typu integer
atrybut nie ma wartości w przeszukiwaniu LDAP
metoda autoryzacji %u nie jest dostępna
nie można ustalić OID funkcji lo_close
nie można ustalić OID funkcji lo_creat
nie można ustalić OID funkcji lo_create
nie można ustalić OID funkcji lo_lseek
nie można ustalić OID funkcji lo_lseek64
nie można ustalić OID funkcji lo_open
nie można ustalić OID funkcji lo_tell
nie można ustalić OID funkcji lo_tell64
nie można ustalić OID funkcji lo_truncate
nie można ustalić OID funkcji lo_truncate64
nie można ustalić OID funkcji lo_unlink
nie można ustalić OID funkcji loread
nie można ustalić OID funkcji lowrite
certyfikat nie może zostać otrzymany: %s
certyfikat nie pokrywa się z prywatnym kluczem w pliku "%s": %s
znaleziono certyfikat ale nie znaleziono pliku z prywatnym kluczem "%s"
numer kolumny %d wykracza poza zakres 0..%d łańcuch polecenia jest wskaźnikiem null
połączenie posiada błędny stan
połączenie nie jest otwarte
wskaźnik połączenia ma wartość NULL
nie można nabyć poświadczeń SSPI nie można uzyskać muteksu: %s
nie można połączyć się z serwerem: %s
Czy serwer działa lokalnie i akceptuje
połączenia przy pomocy gniazd dziedziny Uniksa "%s"?
nie można połączyć się z serwerem: %s
Czy serwer działa na serwerze "%s" (%s) i akceptuje
połączenia TCP/IP na porcie %s?
nie można połączyć się z serwerem: %s
Czy serwer działa na stacji sieciowej "%s" i akceptuje
połączenia TCP/IP na porcie %s?
nie można utworzyć struktury LDAP
nie można utworzyć kontekstu SSL: %s
nie można utworzyć gniazda: %s
nie można ustanowić połączenia SSL: %s
nie można otrzymać adresu klienta z gniazda: %s
nie można pobrać folderu domowego aby zlokalizować plik certyfikatu głównego
Albo dostarcz plik albo zmień tryb ssl by zablokować weryfikację certyfikatu serwera.
nie można pobrać katalogu domowego aby zlokalizować plik definicji usługi nie można pobrać poświadczeń wzajemnych: %s
nie można odczytać nazwy serwera z jego certyfikatu
nie można otrzymać błędu gniazda: %s
nie można zainicjować silnika SSL "%s": %s
nie można zinterpretować wyników z serwera: %s nie można wczytać silnika SSL "%s": %s
nie można pobrać prywatnego klucza SSL "%s" z silnika "%s": %s
nie można pobrać pliku z kluczem prywatnym "%s": %s
nie udało się odnaleźć lokalnego ID użytkownika %d: %s
nie można otworzyć pliku certyfikatu "%s": %s
nie można otworzyć pliku "%s": %s
nie można odczytać pliku certyfikatu "%s": %s
nie można czytać z pliku "%s": %s
nie można odczytać prywatnego klucza SSL "%s" z silnika "%s": %s
nie można odczytać pliku z certyfikatem użytkownika root "%s": %s
nie można otrzymać danych z serwera: %s
nie można wysłać pakietu negocjacji SSL: %s
nie można wysłać danych do serwera: %s
nie można wysłać pakietu rozpoczynającego: %s
nie można ustawić gniazda TCP w tryb bez opóźnień: %s
nie można ustawić gniazda obsługi zamknięcia przy uruchomieniu: %s
nie można ustawić gniazda w tryb nieblokujący: %s
nie można przetłumaczyć ścieżki gniazda domeny Uniks "%s" na adres: %s
nie można przetłumaczyć nazwy hosta "%s" na adres: %s
nie można pisać do pliku "%s": %s
nie znaleziono definicji usługi "%s"
podwójne żądanie autoryzacji GSS
osiągnięto koniec ciągu znaków podczas wyszukiwania kończącego "]" w adresie IPv6 hosta w URI: "%s"
oczekiwano prośby autoryzacji z serwera ale otrzymano %c
nadmiarowy znak "=" rozdzielający klucz/wartość w parametrze zapytania URI: "%s"
nadmiarowe dane w wiadomości "D" nadmiarowe dane w wiadomości "T" nadmiarowe dane w wiadomości "t" zabroniona wartość %%00 w znaku kodowanym procentem: "%s"
funkcja wymaga przynajmniej protokołu w wersji 3.0
nazwa hosta musi być określona
nazwa hosta musi zostać podana dla zweryfikowanego połączenia SSL
niepełny znak wielobajtowy
niewystarczająca ilość danych w wiadomości "D" niewystarczająca ilość danych w wiadomości "T" typ integer o rozmiarze %lu nie jest obsługiwany przez pqGetInt typ integer o rozmiarze %lu nie jest obsługiwany przez pqPutInt błędny kod ExecStatusType niepoprawny adres URL LDAP "%s": niepoprawny numer portu
niepoprawny adres URL LDAP "%s": brakująca nazwa wyróżniająca
niepoprawny adres URL LDAP "%s": musi mieć dokładnie jeden atrybut
niepoprawny adres URL LDAP "%s": musi mieć zakres wyszukiwania (base/one/sub)
niepoprawny adres URL LDAP "%s": brak filtra
Niepoprawny adres URL LDAP "%s": schemat musi być ldap://
niepoprawny URI przekazany do wewnętrznej procedury parsującej: "%s"
nieprawidłowy parametr zapytania URI: "%s"
błędna opcja połączenia "%s"
nieprawidłowy stan połączenia %d, prawdopodobnie wskazujący na uszkodzenie pamięci
błędny stan połączenia, prawdopodobnie oznajmiający uszkodzenie pamięci
niepoprawny kodowany procentem znak: "%s"
nieprawidłowy numer portu: "%s"
niepoprawny stan setenv %c, prawdopodobnie oznajmiający uszkodzenie pamięci
nieprawidłowe gniazdo
błędna wartość sslmode: "%s"
niepoprawny stan %c, prawdopodobnie oznajmiający uszkodzenie pamięci
parametr keepalives musi być liczbą całkowitą
musi być podana długość parametru binarnego
zbyt długa linia %d w pliku usługi "%s"
lokalny użytkownik o ID %d nie istnieje
przeszukiwanie LDAP nie powiodło się: %s
utracono synchronizację z serwerem, resetuję połączenie utracono synchronizację z serwerem: otrzymano wiadomość typu"%c", długość %d
zawartość wiadomości nie zgadza się z długością wiadomości typu "%c"
otrzymano wiadomość typu 0x%02x z serwera podczas procesu bezczynności brakujące "=" po "%s" w łańcuchu informacyjnym połączenia
brak znaku "=" rozdzielającego klucz/wartość w parametrze zapytania URI: "%s"
ponad jeden wpis znaleziono podczas przeszukiwania LDAP
zagnieżdżone specyfikacje usług nie są obsługiwane w pliku usługi "%s", linia %d
brak COPY w toku
nie zgłoszono błędu SSL brak połączenia z serwerem
nie znaleziono wpisu podczas przeszukiwania LDAP
brak dostępnego komunikatu błędu
liczba parametrów musi być pomiędzy 0 i 65535
brak pamięci brak pamięci
brak pamięci podczas alokacji bufora GSSAPI (%d) brak pamięci dla wyników zapytania numer parametru %d wykracza poza zakres 0..%d hasło odczytane z pliku "%s"
plik hasła "%s" posiada globalne lub grupowe uprawnienia odczytu;
uprawniania powinny być ustawione na u=rw (0600) lub niżej
błąd protokołu: id=0x%x
zapytanie inicjujące duży obiekt nie zwróciło żadnych danych
otrzymano niepoprawną odpowiedź negocjacji SSL: %c
parametr requirepeer nie jest obsługiwany na tej platformie
requirepeer wskazuje "%s", ale nazwa bieżącego użytkownika równorzędnego to "%s"
plik certyfikatu głównego "%s" nie istnieje
Albo dostarcz plik albo zmień tryb ssl by zablokować weryfikację certyfikatu serwera.
numer wiersza %d wykracza poza zakres 0..%d select() nie udało się: %s
certyfikat dla serwera "%s" nie odpowiada nazwie hosta "%s"
serwer zamknął połączenie niespodziewanie
Oznacza to prawdopodobnie iż serwer zakończył działanie niepoprawnie
przed lub podczas przetwarzania zapytania.
serwer nie obsługuje SSL, ale SSL było wymagane
serwer wysłał dane binarne (wiadomość "B") bez wcześniejszego opisu wiersza (wiadomość "T") serwer wysłał dane (wiadomość "D") bez wcześniejszego opisu wiersza (wiadomość "T") serwer wysłał dane (wiadomość "D") bez wcześniejszego opisu wiersza (wiadomość "T")
nie znaleziono pliku usługi "%s"
nie powiodło się setsockopt(SO_KEEPALIVE): %s
nie powiodło się setsockopt(TCP_KEEPALIVE): %s
nie powiodło się setsockopt(TCP_KEEPCNT): %s
nie powiodło się setsockopt(TCP_KEEPIDLE): %s
nie powiodło się setsockopt(TCP_KEEPINTVL): %s
błędna wartość sslmode "%s" gdyż obsługa SSL nie została skompilowana
nazwa instrukcji jest wskaźnikiem null
błąd składni w pliku usługi "%s", linia %d
upłynął limit czasu rządania
nieoczekiwany asyncStatus: %d
nieoczekiwany znak "%c" w URI na pozycji %d (oczekiwano ":" lub "/"): "%s"
nieznany znak %c następujący po odpowiedzi pustego zapytania (wiadomość "I") nieoczekiwana liczba pól we wiadomości "D" niespodziewana wiadomość z serwera podczas startu
nieznana odpowiedź z serwera: pierwszym znakiem otrzymanym był "%c"
nieznany błąd SSL o kodzie: %d
nierozpoznany błąd gniazda: 0x%08X/%d niezamknięty cudzysłów w łańcuchu informacyjnym połączenia
niepowodzenie wyszukiwania nazwy użytkownika: kod błędu %lu
locale/pl/LC_MESSAGES/pg_ctl-9.6.mo 0000644 00000045107 14751153421 0012334 0 ustar 00 �� � � � < P D Q ? � � � &
0
P
- o
�
�
= �
! � A � a � K P � A � ! � 3 ? O H � D � C E a ? � ? � > ' 9 f L � B � E 0 � v 0 � F , > s 8 � I � % 5 2 [ O � 7 � & M 8 - � ! � > � E C [ y � 9 D S C � D � > ! A ` ( � , � 2 � 6 + > b * � / � % � 1 " 0 T # � � 4 � 2 � 1 / 0 a , � . � 3 � " + B 1 n 6 � : � 1 * D " o 7 � " � $ � J ] y 3 � 0 � � ! $ 6 [ - | � 4 � % � $ %! " J! ! m! F �! u �! F L" �" 7 �" ) �" k # ` u# % �# & �# #$ d +$ �$ / �$ & �$ 0 % . 7% ) f% ) �% �% �% & �%
& , +& ( X& �& ! �& �& �& �& �& ' "' 8' I' Y' j' z' " �' �' � �' G �) C
* , N* {* & �* " �* % �* C �* @+ X+ ; m+ �+ �+ � �+ w, d �, N �, K- F f- ! �- @ �- H . N Y. > �. D �. J ,/ ? w/ = �/ D �/ 8 :0 [ s0 P �0 I 1 � j1 2 �1 O .2 F ~2 9 �2 S �2 - S3 A �3 [ �3 B 4
b4 p4 �4 ^ �4 / �4 )5 N I5 _ �5 L �5 � E6 A �6 a (7 c �7 c �7 [ R8 ` �8 ' 9 9 79 ? q9 D �9 E �9 ? <: ? |: , �: 9 �: < #; 0 `; $ �; A �; > �; G 7< H < 8 �< E = ? G= & �= 8 �= = �= A %> A g> > �> 5 �> ? 6 <? & s? 6 �? S �? %@ >@ = ^@ 8 �@ �@ ' �@ * A # HA A lA �A 4 �A ( B ) *B & TB ) {B T �B q �B G lC �C \ �C , &D s SD h �D 1 0E 6 bE �E � �E ' .F < VF 0 �F ; �F 5 G 3 6G 2 jG �G �G ( �G �G < H 2 WH # �H - �H �H �H I "I AI aI xI �I �I �I # �I % �I & J ? L y ' { � V r � & $ o @ � � P b [ - C U � " ( _ . � ; X Y ! 6 � A B = / w � % 7 E K
v
J q c M , ~ # 3 ) 0 W � F s � ] 1 ` u } � � � h � f x m t d : z j � * g S O 9 Q D < G I 4 > 2 5 N Z � | l ^ p i + a H R n 8 � e � � T \ k
%s: -w option cannot use a relative socket directory specification
%s: -w option is not supported when starting a pre-9.1 server
Allowed signal names for kill:
Common options:
Options for register and unregister:
Options for start or restart:
Options for stop or restart:
Report bugs to <pgsql-bugs@postgresql.org>.
Shutdown modes are:
Start types are:
%s init[db] [-D DATADIR] [-s] [-o "OPTIONS"]
%s kill SIGNALNAME PID
%s promote [-D DATADIR] [-s]
%s register [-N SERVICENAME] [-U USERNAME] [-P PASSWORD] [-D DATADIR]
[-S START-TYPE] [-w] [-t SECS] [-o "OPTIONS"]
%s reload [-D DATADIR] [-s]
%s restart [-w] [-t SECS] [-D DATADIR] [-s] [-m SHUTDOWN-MODE]
[-o "OPTIONS"]
%s start [-w] [-t SECS] [-D DATADIR] [-s] [-l FILENAME] [-o "OPTIONS"]
%s status [-D DATADIR]
%s stop [-W] [-t SECS] [-D DATADIR] [-s] [-m SHUTDOWN-MODE]
%s unregister [-N SERVICENAME]
-?, --help show this help, then exit
-D, --pgdata=DATADIR location of the database storage area
-N SERVICENAME service name with which to register PostgreSQL server
-P PASSWORD password of account to register PostgreSQL server
-S START-TYPE service start type to register PostgreSQL server
-U USERNAME user name of account to register PostgreSQL server
-V, --version output version information, then exit
-W do not wait until operation completes
-c, --core-files allow postgres to produce core files
-c, --core-files not applicable on this platform
-e SOURCE event source for logging when running as a service
-l, --log=FILENAME write (or append) server log to FILENAME
-m, --mode=MODE MODE can be "smart", "fast", or "immediate"
-o OPTIONS command line options to pass to postgres
(PostgreSQL server executable) or initdb
-p PATH-TO-POSTGRES normally not necessary
-s, --silent only print errors, no informational messages
-t, --timeout=SECS seconds to wait when using -w option
-w wait until operation completes
auto start service automatically during system startup (default)
demand start service on demand
fast quit directly, with proper shutdown
immediate quit without complete shutdown; will lead to recovery on restart
smart quit after all clients have disconnected
done
failed
stopped waiting
%s is a utility to initialize, start, stop, or control a PostgreSQL server.
%s: -S option not supported on this platform
%s: PID file "%s" does not exist
%s: WARNING: cannot create restricted tokens on this platform
%s: WARNING: could not locate all job object functions in system API
%s: another server might be running; trying to start server anyway
%s: cannot be run as root
Please log in (using, e.g., "su") as the (unprivileged) user that will
own the server process.
%s: cannot promote server; server is not in standby mode
%s: cannot promote server; single-user server is running (PID: %ld)
%s: cannot reload server; single-user server is running (PID: %ld)
%s: cannot restart server; single-user server is running (PID: %ld)
%s: cannot set core file size limit; disallowed by hard limit
%s: cannot stop server; single-user server is running (PID: %ld)
%s: could not access directory "%s": %s
%s: could not allocate SIDs: error code %lu
%s: could not create promote signal file "%s": %s
%s: could not create restricted token: error code %lu
%s: could not determine the data directory using command "%s"
%s: could not find own program executable
%s: could not find postgres program executable
%s: could not open PID file "%s": %s
%s: could not open process token: error code %lu
%s: could not open service "%s": error code %lu
%s: could not open service manager
%s: could not read file "%s"
%s: could not register service "%s": error code %lu
%s: could not remove promote signal file "%s": %s
%s: could not send promote signal (PID: %ld): %s
%s: could not send reload signal (PID: %ld): %s
%s: could not send signal %d (PID: %ld): %s
%s: could not send stop signal (PID: %ld): %s
%s: could not start server
Examine the log output.
%s: could not start server: %s
%s: could not start server: error code %lu
%s: could not start service "%s": error code %lu
%s: could not unregister service "%s": error code %lu
%s: could not wait for server because of misconfiguration
%s: could not write promote signal file "%s": %s
%s: database system initialization failed
%s: directory "%s" does not exist
%s: directory "%s" is not a database cluster directory
%s: invalid data in PID file "%s"
%s: missing arguments for kill mode
%s: no database directory specified and environment variable PGDATA unset
%s: no operation specified
%s: no server running
%s: old server process (PID: %ld) seems to be gone
%s: option file "%s" must have exactly one line
%s: server does not shut down
%s: server is running (PID: %ld)
%s: service "%s" already registered
%s: service "%s" not registered
%s: single-user server is running (PID: %ld)
%s: the PID file "%s" is empty
%s: too many command-line arguments (first is "%s")
%s: unrecognized operation mode "%s"
%s: unrecognized shutdown mode "%s"
%s: unrecognized signal name "%s"
%s: unrecognized start type "%s"
(The default is to wait for shutdown, but not for start or restart.)
HINT: The "-m fast" option immediately disconnects sessions rather than
waiting for session-initiated disconnection.
If the -D option is omitted, the environment variable PGDATA is used.
Is server running?
Please terminate the single-user server and try again.
Server started and accepting connections
The program "%s" is needed by %s but was not found in the
same directory as "%s".
Check your installation.
The program "%s" was found by "%s"
but was not the same version as %s.
Check your installation.
Timed out waiting for server startup
Try "%s --help" for more information.
Usage:
WARNING: online backup mode is active
Shutdown will not complete until pg_stop_backup() is called.
Waiting for server startup...
cannot duplicate null pointer (internal error)
child process exited with exit code %d child process exited with unrecognized status %d child process was terminated by exception 0x%X child process was terminated by signal %d child process was terminated by signal %s command not executable command not found could not change directory to "%s": %s could not find a "%s" to execute could not get current working directory: %s
could not identify current directory: %s could not read binary "%s" could not read symbolic link "%s" invalid binary "%s" out of memory
pclose failed: %s server is still starting up
server promoting
server shutting down
server signaled
server started
server starting
server stopped
starting server anyway
waiting for server to shut down... waiting for server to start... Project-Id-Version: pg_ctl (PostgreSQL 9.5)
Report-Msgid-Bugs-To: pgsql-bugs@postgresql.org
POT-Creation-Date: 2015-10-29 01:43+0000
PO-Revision-Date: 2015-12-22 21:18-0500
Last-Translator: grzegorz <begina.felicysym@wp.eu>
Language-Team: begina.felicysym@wp.eu
Language: pl
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Plural-Forms: nplurals=3; plural=(n==1 ? 0 : n%10>=2 && n%10<=4 && (n%100<10 || n%100>=20) ? 1 : 2);
X-Generator: Virtaal 0.7.1
%s: opcja -w nie może używać względnego wskazania katalogu gniazd
%s: opcja -w nie jest wspierana przy uruchomieniu serwera pre-9.1
Dopuszczalne nazwy sygnałów dla zabicia:
Opcje ogólne:
Opcje rejestracji i wyrejestrowania:
Opcje uruchomienia lub restartu:
Opcje dla zatrzymania lub restartu:
Błędy proszę przesyłać na adres <pgsql-bugs@postgresql.org>.
Tryby zamknięcia to:
Rodzaje startu to:
%s init[db] [-D KATDANE] [-s] [-o "OPCJE"]
%s kill NAZWASYGNAŁU PID
%s promote [-D KATDANE] [-s]
%s register [-N NAZWAUSLUGI] [-U USERNAME] [-P PASSWORD] [-D KATDANE]
[-S TYP-STARTU] [-w] [-t SEKUNDY] [-o "OPCJE"]
%s reload [-D KATDANE] [-s]
%s restart [-w] [-t SEKUNDY] [-D KATDANE] [-s] [-m TRYB-ZAMKNIECIA]
[-o "OPCJE"]
%s start [-w] [-t SEKUNDY] [-D KATDANE] [-s] [-l NAZWAPLIKU] [-o "OPCJE"]
%s status [-D KATDANE]
%s stop [-W] [-t SEKUNDY] [-D KATDANE] [-s] [-m TRYB-ZAMKNIECIA]
%s unregister [-N NAZWAUSLUGI]
-?, --help pokaż tą pomoc i zakończ działanie
-D, --pgdata=KATDANE położenie miejsca przechowywania bazy danych
-N SERVICENAME nazwa usługi, na której rejestruje się serwer PostgreSQL
-P PASSWORD hasło konta rejestracji serwera PostgreSQL
-S TYP-STARTU typ startu usługi rejestracji serwera PostgreSQL
-U USERNAME nazwa użytkownika konta rejestracji serwera PostgreSQL
-V, --version pokaż informacje o wersji i zakończ
-W nie czekaj na zakończenie operacji
-c, --core-files zezwól postgresowi utworzyć pliki jądra
-c, --core-files niedostępne na tej platformie
-e ŹRÓDŁO źródło zdarzenia do logowania gdy uruchomiono jako usługę
-l, --log=NAZWAPLIKU zapisuje (lub dodaje) komunikaty serwera do NAZWAPLIKU
-m, --mode=TRYB TRYB może być "smart", "fast" lub "immediate"
-o OPCJE opcje wiersza poleceń przekazywanych postgresowi
(program wykonywalny PostgreSQL) lub initdb
-p ŚCIEŻKA-DO-POSTGRES zwykle niekonieczna
-s, --silent wypisz tylko błędy, bez komunikatów informacyjnych
-t, --timeout=SEKUNDY sekundy oczekiwania podczas użycia opcji -w
-w czekaj na zakończenie operacji
auto uruchamia usługę automatycznie w czasie startu systemu (domyślnie)
demand uruchamia usługę na żądanie
fast bezpośrednie wyjście, z właściwym zamknięciem
immediate wyjście bez pełnego zamknięcia; doprowadzi do odzyskiwania przy restarcie
smart wyjście po rozłączeniu się wszystkich klientów
zakończono
niepowodzenie
oczekiwanie zakończone
%s jest narzędziem do inicjacji, uruchamiania, zatrzymywania i kontroli serwera PostgreSQL.
%s: opcja -S nieobsługiwana na tej platformie
%s: plik PID "%s" nie istnieje
%s: OSTRZEŻENIE nie można tworzyć ograniczonych tokenów na tej platformie
%s: OSTRZEŻENIE: nie może zlokalizować wszystkich funkcji obiektów zadań w systemowym API
%s: inny serwer może być uruchomiony, próba uruchomienia serwera mimo to
%s: nie można uruchomić jako root
Proszę zalogować się (używając np: "su") na (nieuprzywilejowanego) użytkownika który
będzie właścicielem procesu.
%s: Nie można rozgłosić serwera; nie jest w trybie gotowości
%s: Nie można rozgłosić serwera; jest uruchomiony serwer pojedynczego użytkownika (PID: %ld)
%s: Nie można przeładować serwera; jest uruchomiony serwer pojedynczego użytkownika (PID: %ld)
%s: Nie można zrestartować serwera; jest uruchomiony serwer pojedynczego użytkownika (PID: %ld)
%s: nie można ustawić ograniczenia rozmiaru pliku jądra; zablokowane przez twardy limit
%s: Nie można zatrzymać serwera; jest uruchomiony serwer pojedynczego użytkownika (PID: %ld)
%s: brak dostępu do katalogu "%s": %s
%s: nie udało się przydzielić SIDów: kod błędu %lu
%s: nie można utworzyć pliku sygnału rozgłoszenia "%s": %s
%s: nie udało się utworzyć ograniczonego tokena: kod błędu %lu
%s: nie można określić folderu danych przy użyciu polecenia "%s"
%s: nie udało się znaleźć własnego programu wykonywalnego
%s: nie udało się znaleźć programu wykonywalnego postgresa
%s: nie można otworzyć pliku PID "%s": %s
%s: nie można otworzyć tokenu procesu: kod błędu %lu
%s: nie udało się otworzyć usługi "%s": kod błędu %lu
%s: nie udało się otworzyć menadżera usług
%s: nie można czytać z pliku "%s"
%s: nie udało się zarejestrować usługi "%s": kod błędu %lu
%s: nie można usunąć pliku sygnału rozgłoszenia "%s": %s
%s: nie udało się wysłać sygnału rozgłaszającego (PID: %ld): %s
%s: nie udało się wysłać sygnału przeładowującego (PID: %ld): %s
%s: nie udało się wysłać sygnału %d (PID: %ld): %s
%s: nie udało się wysłać sygnału zatrzymującego (PID: %ld): %s
%s: Nie udało się uruchomić serwera
Sprawdź logi wyjścia.
%s: nie można uruchomić serwera: %s
%s: nie udało się uruchomić serwera: kod błędu %lu
%s: nie udało się uruchomić usługi "%s": kod błędu %lu
%s: nie udało się wyrejestrować usługi "%s": kod błędu %lu
%s: nie można czekać na serwer z powodu błędnej konfiguracji
%s: nie można zapisać pliku sygnału rozgłoszenia "%s": %s
%s: inicjacja systemu bazy danych nie powiodła się
%s: folder "%s" nie istnieje
%s: folder "%s" nie jest folderem klastra bazy danych
%s: niepoprawne dane w pliku PID "%s"
%s: nie wskazano wszystkich argumentów trybu zabicia
%s: nie wskazano folderu bazy danych ani nie ustawiono zmiennej środowiska PGDATA
%s: nie podano operacji
%s: brak uruchomionego serwera
%s: poprzedni proces serwera (PID: %ld) wydaje się zginął
%s: plik opcji "%s" musi mieć dokładnie jedną linię
%s: serwer nie zatrzymał się
%s: jest uruchomiony serwer (PID: %ld)
%s: usługa "%s" jest już zarejestrowana
%s: usługa "%s" niezarejestrowana
%s: jest uruchomiony serwer pojedynczego użytkownika (PID: %ld)
%s: plik PID "%s" jest pusty
%s: za duża ilość parametrów (pierwszy to "%s")
%s: nierozpoznany tryb autoryzacji "%s"
%s: nierozpoznany tryb wyłączenia "%s"
%s: nierozpoznana nazwa sygnału "%s"
%s: nierozpoznany tryb uruchomienia "%s"
(Oczekiwanie jest domyślne dla zamknięcia, ale nie dla uruchomienia i restartu.)
PORADA: Opcja "-m fast" rozłącza natychmiast sesje zamiast
czekać na odłączenie sesji przez użytkowników.
Jeśli nie jest podana -D, używana jest zmienna środowiskowa PGDATA.
Czy serwer działa?
Proszę zakończyć działanie serwera pojedynczego użytkownika i spróbować raz jeszcze.
Serwer uruchomiony i akceptuje połączenia
Program "%s" jest wymagany przez %s ale nie został znaleziony
w tym samym folderze co "%s".
Sprawdź instalację.
Program "%s" został znaleziony przez "%s"
ale nie jest w tej samej wersji co %s.
Sprawdź instalację.
Minął czas oczekiwania na uruchomienie serwera
Spróbuj "%s --help" aby uzyskać więcej informacji.
Składnia:
OSTRZEŻENIE: jest aktywny tryb robienia kopii roboczej online
Zatrzymanie nie zakończy się póki wywoływana jest pg_stop_backup().
Oczekiwanie na uruchomienie serwera...
nie można powielić pustego wskazania (błąd wewnętrzny)
proces potomny zakończył działanie z kodem %d proces potomny zakończył działanie z nieznanym stanem %d proces potomny został zatrzymany przez wyjątek 0x%X proces potomny został zakończony przez sygnał %d proces potomny został zatrzymany przez sygnał %s polecenie nie wykonywalne polecenia nie znaleziono nie można zmienić katalogu na "%s": %s nie znaleziono "%s" do wykonania nie można zidentyfikować aktualnego folderu roboczego: %s
nie można zidentyfikować aktualnego katalogu: %s nie można odczytać binarnego "%s" nie można odczytać linku symbolicznego "%s" niepoprawny binarny "%s" brak pamięci
pclose nie powiodło się: %s serwer ciągle się uruchamia
serwer w trakcie rozgłaszania
zatrzymywanie serwera
serwer zasygnalizowany
uruchomiono serwer
serwer w trakcie uruchamiania
serwer zatrzymany
uruchomienie serwera mimo wszystko
oczekiwanie na zatrzymanie serwera... oczekiwanie na uruchomienie serwera... locale/pl/LC_MESSAGES/pg_config-9.6.mo 0000644 00000014202 14751153421 0013007 0 ustar 00 �� * l ; � � E � 0 � : 3 E n I � L � s K K � = B I i � G � J > M � M � ? % G e > � 6 � < # > ` F � P � I 7
4 �
2 �
* �
. , 8 & e � & � � ( � ! B V c � u E f 9 � � A � Q : U � X � | ; W � @ F Q l � G V M Y � Y � @ X S � H � @ 6 A w K � C r I W � 2 ? G 0 � � � B � 6 ! X ( d � 3 � # � 2 9 R d % * ) $
" '
& ( ! #
%s provides information about the installed version of PostgreSQL.
With no arguments, all known items are shown.
%s [OPTION]...
--bindir show location of user executables
--cc show CC value used when PostgreSQL was built
--cflags show CFLAGS value used when PostgreSQL was built
--cflags_sl show CFLAGS_SL value used when PostgreSQL was built
--configure show options given to "configure" script when
PostgreSQL was built
--cppflags show CPPFLAGS value used when PostgreSQL was built
--docdir show location of documentation files
--htmldir show location of HTML documentation files
--includedir show location of C header files of the client
interfaces
--includedir-server show location of C header files for the server
--ldflags show LDFLAGS value used when PostgreSQL was built
--ldflags_ex show LDFLAGS_EX value used when PostgreSQL was built
--ldflags_sl show LDFLAGS_SL value used when PostgreSQL was built
--libdir show location of object code libraries
--libs show LIBS value used when PostgreSQL was built
--localedir show location of locale support files
--mandir show location of manual pages
--pgxs show location of extension makefile
--pkgincludedir show location of other C header files
--pkglibdir show location of dynamically loadable modules
--sharedir show location of architecture-independent support files
--sysconfdir show location of system-wide configuration files
--version show the PostgreSQL version
-?, --help show this help, then exit
%s: could not find own program executable
%s: invalid argument: %s
Options:
Report bugs to <pgsql-bugs@postgresql.org>.
Try "%s --help" for more information.
Usage:
could not change directory to "%s": %s could not find a "%s" to execute could not identify current directory: %s could not read binary "%s" could not read symbolic link "%s" invalid binary "%s" not recorded pclose failed: %s Project-Id-Version: pg_config (PostgreSQL 9.1)
Report-Msgid-Bugs-To: pgsql-bugs@postgresql.org
POT-Creation-Date: 2016-07-03 03:13+0000
PO-Revision-Date: 2016-07-03 17:31+0200
Last-Translator: grzegorz <begina.felicysym@wp.eu>
Language-Team: begina.felicysym@wp.eu
Language: pl
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Plural-Forms: nplurals=3; plural=(n==1 ? 0 : n%10>=2 && n%10<=4 && (n%100<10 || n%100>=20) ? 1 : 2);
X-Generator: Virtaal 0.7.1
%s dostarcza informacji na temat zainstalowanej wersji PostgreSQL.
Bez argumentów są pokazane wszystkie znane elementy.
%s [OPCJA]...
--bindir pokaż lokalizację plików użytkownika
--cc pokaż wartość CC użytą podczas budowania PostgreSQL
--cflags pokaż wartość CFLAGS użytą podczas budowania PostgreSQL
--cflags_sl pokaż wartość CFLAGS_SL użytą podczas budowania PostgreSQL
--configure pokaż opcje użyte przy skrypcie "configure"
podczas budowania PostgreSQL
--cppflags pokaż wartość CPPFLAGS użytą podczas budowania PostgreSQL
--docdir pokaż położenie plików dokumentacji
--htmldir pokaż lokalizację plików HTML dokumentacji
--includedir pokaż lokalizację nagłówków C interfejsu
użytkownika
--includedir-server pokaż lokalizację nagłówków C dla serwera
--ldflags pokaż wartość LDFLAGS użytą podczas budowania PostgreSQL
--ldflags_ex pokaż wartość LDFLAGS_EX użytą podczas budowania PostgreSQL
--ldflags_sl pokaż wartość LDFLAGS_SL użytą podczas budowania PostgreSQL
--libdir pokaż lokalizację bibliotek obiektów
--libs pokaż wartość LIBS użytą podczas budowania PostgreSQL
--localedir pokaż położenie plików obsługi lokalizacji
--mandir pokaż położenie plików podręcznika
--pgxs pokaż lokalizację makefile rozszerzeń
--pkgincludedir pokaż położenie innych plików nagłówkowych C
--pkglibdir pokaż lokalizację dynamicznych modułów
--sharedir pokaż położenie niezależnych od architektury
plików obsługi
--sysconfdir pokaż położenie ogólnosystemowych plików konfiguracyjnych
--version pokaż wersję PostgreSQL
-?, --help pokaż tą pomoc i zakończ działanie
%s: nie można znaleźć programu wykonywalnego
%s: niepoprawny parametr: %s
Opcje:
Błędy proszę przesyłać na adres <pgsql-bugs@postgresql.org>.
Spróbuj "%s --help" aby uzyskać więcej informacji.
Składnia:
nie można zmienić katalogu na "%s": %s nie znaleziono "%s" do wykonania nie można zidentyfikować bieżącego katalogu: %s nie można odczytać binarnego "%s" nie można odczytać odwołania symbolicznego "%s" niepoprawny binarny "%s" niezarejestrowane pclose nie powiodło się: %s locale/pl/LC_MESSAGES/ecpglib6-9.6.mo 0000644 00000007247 14751153421 0012562 0 ustar 00 �� ! $ / , � � � � ) ' - Q : 0 � $ � ( 9 L * c ; � > � 3 < = & z 1 � � + � ' @ % Y � , � � 2 0 ; / l � � � � � � � ( � 9 � M 8
3 �
* �
* �
' + A < m F � ; � D - + r ? � � * � ' )
Q
* i
�
�
1 �
" , + * X # �
! <DEFAULT> <empty> NULL SQL error %d on line %d SQL error: %s
connection "%s" does not exist on line %d could not connect to database "%s" on line %d could not convert boolean value: size mismatch, on line %d data read from server is not an array on line %d descriptor "%s" not found on line %d descriptor index out of range on line %d empty message text empty query on line %d error in transaction processing on line %d inserting an array of variables is not supported on line %d invalid input syntax for floating-point type: "%s", on line %d invalid input syntax for type int: "%s", on line %d invalid input syntax for type unsigned int: "%s", on line %d invalid statement name "%s" on line %d invalid syntax for type boolean: "%s", on line %d no data found on line %d not connected to connection "%s" on line %d null value without indicator on line %d out of memory on line %d the connection to the server was lost too few arguments on line %d too many arguments on line %d unrecognized descriptor item "%s" on line %d unsupported type "%s" on line %d variable does not have a character type on line %d variable does not have a numeric type on line %d variable does not have an array type on line %d Project-Id-Version: ecpglib (PostgreSQL 9.1)
Report-Msgid-Bugs-To: pgsql-bugs@postgresql.org
POT-Creation-Date: 2013-01-29 13:40+0000
PO-Revision-Date: 2011-09-30 09:51-0300
Last-Translator: Begina Felicysym <begina.felicysym@wp.eu>
Language-Team: Begina Felicysym
Language: pl
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Plural-Forms: nplurals=3; plural=(n==1 ? 0 : n%10>=2 && n%10<=4 && (n%100<10 || n%100>=20) ? 1 : 2);
X-Generator: Virtaal 0.7.1-beta1
<DOMYŚLNIE> <pusty> NULL błąd SQL %d, linia %d błąd SQL: %s
połączenie "%s" nie istnieje, linia %d nie można połączyć się z bazą danych "%s", linia %d nie można przekształcić wartości logicznej: niepoprawny rozmiar, linia %d dane odczytane z serwera nie są tablicą, linia %d nie odnaleziono deskryptora "%s", linia %d indeks deskryptora poza zakresem, linia %d pusty tekst komunikatu puste zapytanie, linia %d błąd w przetwarzaniu transakcji, linia %d wstawienie tablicy zmiennych nie jest obsługiwane, linia %d niepoprawna składnia wejścia dla typu floating-point: "%s", linia %d niepoprawna składnia wejścia dla typu int: "%s", linia %d niepoprawna składnia wejścia dla typu unsigned int: "%s", linia %d niepoprawna nazwa wyrażenia "%s", linia %d niepoprawna składnia wejścia dla typu boolean: "%s", linia %d nie znaleziono danych, linia %d nie wykonano połączenia z "%s", linia %d wartość null bez wskaźnika, linia %d brak pamięci, linia %d połączenie z serwerem zostało przerwane zbyt mało argumentów, linia %d zbyt wiele argumentów, linia %d niezrozumiały element deskryptora "%s", linia %d nieobsługiwany typ "%s", linia %d zmienna nie ma typu typu character, linia %d zmienna nie ma typu typu numeric, linia %d zmienna nie ma typu array, linia %d locale/pl/LC_MESSAGES/pg_basebackup-9.6.mo 0000644 00000070604 14751153421 0013652 0 ustar 00 �� � � � P Q k � � ! �
� - � X T \ R � ` I e D � � 3 K : < � j � > . N m @ � 3 � V 1 > � 1 � j � < d ? � M � k / J � Y � + @ 0 l B � B � * # 8 N � � 5 � L r � o G 1 � 3 � K - i F � \ � P ; 2 � 4 � 8 � 1 - 4 _ 1 � . � @ � 1 6 E h B � 7 � )! ( I! ' r! & �! ; �! ( �! - &" ' T" " |" �" # �" 2 �" , # + D# . p# ( �# # �# 5 �# f "$ , �$ 9 �$ 4 �$ 7 %% = ]% d �% A & " B& & e& & �& # �& / �& > ' a F' & �' & �' % �' 2 ( 1 O( 0 �( 8 �( ( �( 2 ) G) & h) ' �) . �) + �) # * A 6* 2 x* & �* & �* / �* + )+ 4 U+ / �+ ! �+ 1 �+ ) , ( 8, 2 a, 2 �, 3 �, 0 �, % ,- # R- + v- �- �- 2 �- # . (. , E. , r. # �. i �. i -/ 9 �/ " �/ A �/ # 60 Z0 9 {0 �0 �0 ! �0 D 1 & Q1 # x1 A �1 - �1 D 2 ! Q2 s2 �2 " �2 �2 9 �2 1 3 D R3 , �3 �3 ' �3 D �3 M D4 : �4 8 �4 6 5 =5 E V5 G �5 z �5 c _6 % �6 . �6 2 7 6 K7 # �7 �7 % �7 0 �7 R 8 , i8 4 �8 K �8 @ 9 > X9 - �9 , �9 ' �9 , : o G: k �: 4 #; % X; ( ~; ; �;
�; & �; < / < M< / \< � �< �> �> �> �> �> �> C �> W :? O �? a �? i D@ N �@ G �@ EA B VA D �A G �A u &B D �B \ �B O >C < �C Z �C C &D 9 jD | �D G !E A iE V �E k F X nF f �F Q .G ; �G f �G H #H < lH I �H � �H > �I � �I � sJ � �J @ vK 4 �K ] �K 7 JL ~ �L � M � �M ; /N 8 kN K �N 4 �N B %O C hO 0 �O U �O @ 3P I tP D �P 8 Q ' <Q 8 dQ 8 �Q 8 �Q C R ' SR 4 {R + �R ( �R & S ) ,S 7 VS 1 �S 0 �S 4 �S + &T ( RT 8 {T m �T 6 "U B YU = �U A �U A V m ^V P �V 0 W : NW 1 �W 5 �W = �W H /X j xX 4 �X + Y / DY = tY = �Y C �Y @ 4Z 3 uZ @ �Z ( �Z + [ 2 ?[ 5 r[ 5 �[ 2 �[ J \ = \\ 0 �\ - �\ 3 �\ 1 -] 7 _] 5 �] / �] D �] - B^ - p^ 7 �^ = �^ = _ 4 R_ ( �_ & �_ �_ �_ ` 6 (` & _` 0 �` 0 �` = �` &a r Ga s �a B .b + qb H �b & �b %
c B 3c $ vc �c % �c X �c 4 6d + kd G �d : �d P e , ke �e �e $ �e " �e @ f K Yf U �f ; �f 7g * Jg S ug e �g G /h D wh = �h $ �h Q i K qi � �i s Bj & �j = �j ? k 1 [k . �k �k . �k 7 l h >l + �l 4 �l Z m P cm H �m > �m = <n 1 zn 6 �n w �n q [o 8 �o ' p . .p P ]p �p 6 �p �p < �p 7q = Fq � * � � o C $ e [ ] � j ? � � � � f � - R � � � � O < � s � } 2 B � p c { ; N 7 � � ) @ + Y � � � � � z & T J h � H G K ~ � t w X v � � � 9 � = � � . / � k 5 A U � � � q � � _ � � 6 � E
Z � S I , � � d # x � � Q y l P � � i � � u ^ � > � � V
� 0 n � ( � � \ : � � r � � � � 4 � g � M " 3 1 � D m � 8 a � � b F � % W � � � � ! � � | ` L � � � ' �
Action to be performed:
Connection options:
General options:
Optional actions:
Options controlling the output:
Options:
Report bugs to <pgsql-bugs@postgresql.org>.
--create-slot create a new replication slot (for the slot's name see --slot)
--drop-slot drop the replication slot (for the slot's name see --slot)
--if-not-exists do not error if slot already exists when creating a slot
--start start streaming in a replication slot (for the slot's name see --slot)
--synchronous flush transaction log immediately after writing
--xlogdir=XLOGDIR location for the transaction log directory
%s [OPTION]...
-?, --help show this help, then exit
-D, --directory=DIR receive transaction log files into this directory
-D, --pgdata=DIRECTORY receive base backup into directory
-F --fsync-interval=SECS
time between fsyncs to the output file (default: %d)
-F, --format=p|t output format (plain (default), tar)
-I, --startpos=LSN where in an existing slot should the streaming start
-P, --plugin=PLUGIN use output plugin PLUGIN (default: %s)
-P, --progress show progress information
-R, --write-recovery-conf
write recovery.conf after backup
-S, --slot=SLOTNAME name of the logical replication slot
-S, --slot=SLOTNAME replication slot to use
-T, --tablespace-mapping=OLDDIR=NEWDIR
relocate tablespace in OLDDIR to NEWDIR
-U, --username=NAME connect as specified database user
-V, --version output version information, then exit
-W, --password force password prompt (should happen automatically)
-X, --xlog-method=fetch|stream
include required WAL files with specified method
-Z, --compress=0-9 compress tar output with given compression level
-c, --checkpoint=fast|spread
set fast or spread checkpointing
-d, --dbname=CONNSTR connection string
-d, --dbname=DBNAME database to connect to
-f, --file=FILE receive log into this file, - for stdout
-h, --host=HOSTNAME database server host or socket directory
-l, --label=LABEL set backup label
-n, --no-loop do not loop on connection lost
-o, --option=NAME[=VALUE]
pass option NAME with optional value VALUE to the
output plugin
-p, --port=PORT database server port number
-r, --max-rate=RATE maximum transfer rate to transfer data directory
(in kB/s, or use suffix "k" or "M")
-s, --status-interval=INTERVAL
time between status packets sent to server (in seconds)
-s, --status-interval=SECS
time between status packets sent to server (default: %d)
-v, --verbose output verbose messages
-w, --no-password never prompt for password
-x, --xlog include required WAL files in backup (fetch mode)
-z, --gzip compress tar output
%*s/%s kB (%d%%), %d/%d tablespace %*s/%s kB (%d%%), %d/%d tablespaces %*s/%s kB (%d%%), %d/%d tablespace (%s%-*.*s) %*s/%s kB (%d%%), %d/%d tablespaces (%s%-*.*s) %*s/%s kB (100%%), %d/%d tablespace %*s %*s/%s kB (100%%), %d/%d tablespaces %*s %s controls PostgreSQL logical decoding streams.
%s receives PostgreSQL streaming transaction logs.
%s takes a base backup of a running PostgreSQL server.
%s: %s needs a slot to be specified using --slot
%s: COPY stream ended before last file was finished
%s: WAL streaming can only be used in plain mode
%s: at least one action needs to be specified
%s: can only write single tablespace to stdout, database has %d
%s: cannot specify both --xlog and --xlog-method
%s: cannot use --create-slot or --drop-slot together with --startpos
%s: cannot use --create-slot or --start together with --drop-slot
%s: cannot use --create-slot together with --drop-slot
%s: child %d died, expected %d
%s: child process did not exit normally
%s: child process exited with error %d
%s: child thread exited with error %u
%s: confirming write up to %X/%X, flush to %X/%X (slot %s)
%s: could not access directory "%s": %s
%s: could not close compressed file "%s": %s
%s: could not close directory "%s": %s
%s: could not close file "%s": %s
%s: could not connect to server
%s: could not connect to server: %s %s: could not create archive status file "%s": %s
%s: could not create background process: %s
%s: could not create background thread: %s
%s: could not create compressed file "%s": %s
%s: could not create directory "%s": %s
%s: could not create file "%s": %s
%s: could not create pipe for background process: %s
%s: could not create replication slot "%s": got %d rows and %d fields, expected %d rows and %d fields
%s: could not create symbolic link "%s": %s
%s: could not create symbolic link from "%s" to "%s": %s
%s: could not create timeline history file "%s": %s
%s: could not determine seek position in file "%s": %s
%s: could not determine server setting for integer_datetimes
%s: could not drop replication slot "%s": got %d rows and %d fields, expected %d rows and %d fields
%s: could not establish database-specific replication connection
%s: could not fsync file "%s": %s
%s: could not fsync log file "%s": %s
%s: could not get COPY data stream: %s %s: could not get backup header: %s %s: could not get child thread exit status: %s
%s: could not get transaction log end position from server: %s %s: could not identify system: got %d rows and %d fields, expected %d rows and %d or more fields
%s: could not initiate base backup: %s %s: could not open directory "%s": %s
%s: could not open log file "%s": %s
%s: could not open timeline history file "%s": %s
%s: could not open transaction log file "%s": %s
%s: could not pad transaction log file "%s": %s
%s: could not parse next timeline's starting point "%s"
%s: could not parse start position "%s"
%s: could not parse transaction log location "%s"
%s: could not read COPY data: %s %s: could not read directory "%s": %s
%s: could not read from ready pipe: %s
%s: could not receive data from WAL stream: %s %s: could not rename file "%s" to "%s": %s
%s: could not rename file "%s": %s
%s: could not seek to beginning of transaction log file "%s": %s
%s: could not send command to background pipe: %s
%s: could not send copy-end packet: %s %s: could not send feedback packet: %s %s: could not send replication command "%s": %s %s: could not set compression level %d: %s
%s: could not set permissions on directory "%s": %s
%s: could not set permissions on file "%s": %s
%s: could not stat file "%s": %s
%s: could not stat transaction log file "%s": %s
%s: could not wait for child process: %s
%s: could not wait for child thread: %s
%s: could not write %u bytes to WAL file "%s": %s
%s: could not write %u bytes to log file "%s": %s
%s: could not write timeline history file "%s": %s
%s: could not write to compressed file "%s": %s
%s: could not write to file "%s": %s
%s: creating replication slot "%s"
%s: directory "%s" exists but is not empty
%s: directory name too long
%s: disconnected
%s: disconnected; waiting %d seconds to try again
%s: dropping replication slot "%s"
%s: final receive failed: %s %s: finished segment at %X/%X (timeline %u)
%s: got WAL data offset %08x, expected %08x
%s: incompatible server version %s
%s: incompatible server version %s; client does not support streaming from server versions newer than %s
%s: incompatible server version %s; client does not support streaming from server versions older than %s
%s: integer_datetimes compile flag does not match server
%s: invalid --max-rate unit: "%s"
%s: invalid checkpoint argument "%s", must be "fast" or "spread"
%s: invalid compression level "%s"
%s: invalid fsync interval "%s"
%s: invalid output format "%s", must be "plain" or "tar"
%s: invalid port number "%s"
%s: invalid socket: %s %s: invalid status interval "%s"
%s: invalid tablespace mapping format "%s", must be "OLDDIR=NEWDIR"
%s: invalid tar block header size: %d
%s: invalid transfer rate "%s": %s
%s: invalid xlog-method option "%s", must be "fetch" or "stream"
%s: multiple "=" signs in tablespace mapping
%s: new directory is not an absolute path in tablespace mapping: %s
%s: no data returned from server
%s: no database specified
%s: no slot specified
%s: no target directory specified
%s: no target file specified
%s: no transaction log end position returned from server
%s: not renaming "%s%s", segment is not complete
%s: old directory is not an absolute path in tablespace mapping: %s
%s: only tar mode backups can be compressed
%s: out of memory
%s: received interrupt signal, exiting
%s: received transaction log record for offset %u with no file open
%s: replication connection using slot "%s" is unexpectedly database specific
%s: replication slots can only be used with WAL streaming
%s: replication stream was terminated before stop point
%s: segment file "%s" has incorrect size %d, skipping
%s: select() failed: %s
%s: server reported unexpected history file name for timeline %u: %s
%s: server reported unexpected next timeline %u, following timeline %u
%s: server returned unexpected response to BASE_BACKUP command; got %d rows and %d fields, expected %d rows and %d fields
%s: server stopped streaming timeline %u at %X/%X, but reported next timeline %u to begin at %X/%X
%s: starting background WAL receiver
%s: starting log streaming at %X/%X (slot %s)
%s: starting log streaming at %X/%X (timeline %u)
%s: starting timeline %u is not present in the server
%s: streaming header too small: %d
%s: streaming initiated
%s: switched to timeline %u at %X/%X
%s: symlinks are not supported on this platform
%s: system identifier does not match between base backup and streaming connection
%s: this build does not support compression
%s: too many command-line arguments (first is "%s")
%s: transaction log directory location can only be specified in plain mode
%s: transaction log directory location must be an absolute path
%s: transaction log file "%s" has %d bytes, should be 0 or %d
%s: transfer rate "%s" exceeds integer range
%s: transfer rate "%s" is not a valid value
%s: transfer rate "%s" is out of range
%s: transfer rate must be greater than zero
%s: unexpected response to TIMELINE_HISTORY command: got %d rows and %d fields, expected %d rows and %d fields
%s: unexpected result set after end-of-timeline: got %d rows and %d fields, expected %d rows and %d fields
%s: unexpected termination of replication stream: %s %s: unrecognized link indicator "%c"
%s: unrecognized streaming header: "%c"
%s: waiting for background process to finish streaming ...
Password: Try "%s --help" for more information.
Usage:
cannot duplicate null pointer (internal error)
out of memory
transaction log start point: %s on timeline %u
Project-Id-Version: pg_basebackup (PostgreSQL 9.5)
Report-Msgid-Bugs-To: pgsql-bugs@postgresql.org
POT-Creation-Date: 2016-07-03 03:14+0000
PO-Revision-Date: 2016-07-03 17:30+0200
Last-Translator: grzegorz <begina.felicysym@wp.eu>
Language-Team: begina.felicysym@wp.eu
Language: pl
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Plural-Forms: nplurals=3; plural=(n==1 ? 0 : n%10>=2 && n%10<=4 && (n%100<10 || n%100>=20) ? 1 : 2);
X-Generator: Virtaal 0.7.1
Akcja do wykonania:
Opcje połączenia:
Opcje ogólne:
Akcje opcjonalne:
Opcje kontroli wyjścia:
Opcje:
Błędy proszę przesyłać na adres <pgsql-bugs@postgresql.org>.
--create-slot tworzy nowe gniazdo replikacji (nazwa gniazda patrz --slot)
--drop-slot usuwa gniazdo replikacji (nazwa gniazda patrz --slot)
--if-not-exists nie pokazuj błędu gdy gniazdo już istnieje podczas tworzenia gniazda
--start rozpoczyna przesyłanie na gnieździe replikacji (nazwa gniazda patrz --slot)
--synchronous czyść dziennik transakcji bezpośrednio po zapisie
--xlogdir=XLOGFLDR umiejscowienie folderu dziennika transakcji
%s [OPCJA]...
-?, --help pokaż tą pomoc i zakończ działanie
-D, --directory=FOLDER odbiera pliki dziennika do tego katalogu
-D, --pgdata=FOLDER dostarcza kopię zapasową bazy do katalogu
-F, --fsync-interval=SEKUNDY
czas pomiędzy fsyncami do pliku wyjścia (domyślnie: %d)
-F, --format=p|t format wyjścia (plain (domyślny), tar)
-I, --startpos=LSN gdzie w istniejącym gnieździe strumień powinien się zacząć
-P, --plugin=WTYCZKA użyj wtyczki wyjścia WTYCZKA (domyślnie: %s)
-P, --progress pokazanie informacji o postępie
-R, --write-recovery-conf
zapisuje recovery.conf po backupie
-S, --slot=SLOTNAME nazwa logicznego gniazda replikacji
-S, --slot=SLOTNAME gniazdo replikacji do użycia
-T, --tablespace-mapping=POPRZFLDR=NOWYFLDR
przenosi przestrzeń tabel z POPRZFLDR do NOWYFLDR
-U, --username=NAZWA połączenie jako wskazany użytkownik bazy
-V, --version pokaż informacje o wersji i zakończ
-W, --password wymuś pytanie o hasło (powinno nastąpić automatycznie)
-X, --xlog-method=fetch|stream
dołącza wymagane pliki WAL wskazaną metodą
-Z, --compress=0-9 wyjście jako spakowany tar z określonym poziomem kompresji
-c, --checkpoint=fast|spread
ustawia szybkie lub rozszerzone sprawdzenia
-d, --dbname=CGPOLACZ połączenie do bazy danych o tym ciągu połączenia
-d, --dbname=NAZWADB baza danych do połączenia
-f, --file=NAZWAPLIKU nazwa pliku lub folderu wyjścia logów, - do standardowego strumienia
-h, --host=NAZWAHOSTA host serwera bazy danych lub katalog gniazda
-l, --label=ETYKIETA ustala etykietę kopii zapasowej
-n, --noloop nie wchodzi w pętlę po stracie połączenia
-o, --option=NAZWA[=WARTOŚĆ]
przekazuje opcję NAZWA o opcjonalnej wartości WARTOŚĆ,
do wtyczki wyjścia
-p, --port=PORT numer portu na serwera bazy dnaych
-r, --max-rate=RATE maksymalna prędkość transferu przenoszenia folderu danych
(w kB/s, albo użyj sufiksu "k" lub "M")
-s, --status-interval=INTERWAŁ
czas pomiędzy wysłaniami pakietów stanu na serwer (w sekundach)
-s, --status-interval=SEKUNDY
czas pomiędzy wysłaniami pakietów stanu na serwer (domyślnie %d)
-v, --verbose szczegółowe komunikaty na wyjściu
-w, --no-password nie pytaj nigdy o hasło
-x, --xlog dołącza wymagane pliki WAL do kopii zapasowej (tryb pobierania)
-z, --gzip wyjście jako spakowany tar
%*s/%s kB (%d%%), %d/%d przestrzeń tabel %*s/%s kB (%d%%), %d/%d przestrzenie tabel %*s/%s kB (%d%%), %d/%d przestrzeni tabel %*s/%s kB (%d%%), %d/%d przestrzeń tabel (%s%-*.*s) %*s/%s kB (%d%%), %d/%d przestrzenie tabel (%s%-*.*s) %*s/%s kB (%d%%), %d/%d przestrzeni tabel (%s%-*.*s) %*s/%s kB (100%%), %d/%d przestrzeń tabel %*s %*s/%s kB (100%%), %d/%d przestrzenie tabel %*s %*s/%s kB (100%%), %d/%d przestrzeni tabel %*s %s kontroluje dekodujące strumienie logiczne PostgreSQL.
%s odbiera logi strumieniowania transakcji PostgreSQL.
%s bierze podstawową kopię zapasową działającego serwera PostgreSQL.
%s: %s wymaga wskazania gniazda przy użyciu --slot
%s: strumień COPY zakończony zanim skończył się ostatni plik
%s: strumieniowanie WAL może być użyte tylko w trybie tekstowym
%s: wymagane wskazanie co najmniej jednej akcji
%s: można zapisać tylko pojedynczą przestrzeń tabel do stdout, baza danych ma %d
%s: nie można wskazać jednocześnie --xlog oraz --xlog-method
%s: nie można użyć --create-slot ani --drop-slot razem ze --startpost
%s: nie można użyć --create-slot ani --start razem z --drop-slot
%s: nie można użyć --create-slot razem z --drop-slot
%s: zginął potomek %d, oczekiwano %d
%s: proces potomny nie zakończył poprawnie działania
%s: proces potomny zakończył działanie z błędem %d
%s: wątek potomny zakończył działanie z błędem %u
%s: potwierdzenie zapisu aż do %X/%X, zrzut do %X/%X (gniazdo %s)
%s: brak dostępu do katalogu "%s": %s
%s: nie można zamknąć spakowanego pliku "%s": %s
%s: nie można zamknąć katalogu "%s": %s
%s: nie można zamknąć pliku "%s": %s
%s: nie można połączyć z serwerem
%s: nie można połączyć z serwerem: %s %s: nie można utworzyć pliku stanu archiwum "%s": %s
%s: nie udało się utworzenie procesu w tle: %s
%s: nie udało się utworzenie wątku w tle: %s
%s: nie można utworzyć spakowanego pliku "%s": %s
%s: nie można utworzyć katalogu "%s": %s
%s: nie można utworzyć pliku "%s": %s
%s: nie udało się utworzyć rury do procesu w tle: %s
%s: nie można utworzyć gniazda replikacji "%s": jest %d wierszy i %d pól, oczekiwano %d wierszy i %d pól
%s: nie można utworzyć linku symbolicznego "%s": %s
%s: nie można utworzyć linku symbolicznego dla "%s" na "%s": %s
%s: nie można utworzyć pliku historii linii czasu "%s": %s
%s: nie można określić pozycji przesunięcia w pliku "%s": %s
%s: nie można ustalić ustawienia serwera dla integer_datetimes
%s: nie można skasować gniazda replikacji "%s": jest %d wierszy i %d pól, oczekiwano %d wierszy i %d pól
%s: nie można ustanowić specyficznego dla bazy danych połączenia replikacji
%s: nie można wykonać fsync na pliku "%s": %s
%s: nie można wykonać fsync na pliku dziennika "%s": %s
%s: nie można pobrać strumienia danych COPY: %s %s: nie można pobrać nagłówka kopii zapasowej: %s %s: nie można pobrać statusu wyjścia wątku potomnego: %s
%s: nie można pobrać pozycji końca dziennika transakcji z serwera: %s %s: nie można określić systemu: jest %d wierszy i %d pól, oczekiwano %d wierszy i %d lub więcej pól
%s: nie można zainicjować kopii zapasowej bazy: %s %s: nie można otworzyć katalogu "%s": %s
%s: nie można otworzyć pliku logów "%s": %s
%s: nie można otworzyć pliku historii linii czasu "%s": %s
%s: nie można otworzyć pliku dziennika transakcji "%s": %s
%s: nie można wykonać pad na pliku dziennika transakcji "%s": %s
%s: nie można sparsować początku następnej linii czasu "%s"
%s: nie można odczytać pozycji początkowej "%s"
%s: nie można sparsować położenia dziennika transakcji "%s"
%s: nie można odczytać danych COPY: %s %s: nie można odczytać katalogu "%s": %s
%s: nie można odczytać z przygotowanej rury: %s
%s: nie można otrzymać danych ze strumienia WAL: %s %s: nie można zmienić nazwy pliku "%s" na "%s": %s
%s: nie udało się zmienić nazwy pliku "%s": %s
%s: nie można przejść do początku pliku dziennika transakcji "%s": %s
%s: nie udało się przesyłanie polecenia do rury w tle: %s
%s: nie można wysłać pakietu końca kopii: %s %s: nie można wysłać pakietu zwrotnego: %s %s: nie można wysłać komendy replikacji "%s": %s %s: nie można ustawić poziomu kompresji %d: %s
%s: nie można ustawić uprawnień do folderu "%s": %s
%s: nie można ustawić uprawnień do pliku "%s": %s
%s: nie można wykonać stat na pliku "%s": %s
%s: nie można wykonać stat na pliku dziennika transakcji "%s": %s
%s: nie można czekać na proces potomny: %s
%s: nie można czekać na wątek potomny: %s
%s: nie można pisać %u bajtów do pliku WAL "%s": %s
%s: nie można pisać %u bajtów do pliku dziennika "%s": %s
%s: nie można pisać do pliku historii linii czasu "%s": %s
%s: nie można pisać do spakowanego pliku "%s": %s
%s: nie można pisać do pliku "%s": %s
%s: tworzenie gniazda replikacji "%s"
%s: folder "%s" nie jest pusty
%s: zbyt długa nazwa folderu
%s: rozłączono
%s: rozłączono; czekam %d sekund i ponawiam próbę
%s: kasowanie gniazda replikacji "%s"
%s: ostateczne pobieranie nie powiodło się: %s %s: zakończono segment na %X/%X (oś czasu %u)
%s: otrzymano przesunięcie danych WAL %08x, oczekiwano %08x
%s: niezgodna wersja serwera %s
%s: niezgodna wersja serwera %s; klient nie obsługuje transmisji strumieniowej z wersji serwera nowszych niż %s
%s: niezgodna wersja serwera %s; klient nie obsługuje transmisji strumieniowej z wersji serwera starszych niż %s
%s: flaga kompilacji integer_datetimes nie jest zgodna z serwerem
%s: niepoprawna jednostka --max-rate: "%s"
%s: niepoprawny argument checkpoint "%s", musi być "fast" lub "spread"
%s: niepoprawny poziom kompresji "%s"
%s: niepoprawny interwał fsync "%s"
%s: niepoprawny format wyjścia "%s", musi być "plain" lub "tar"
%s: nieprawidłowy numer portu "%s"
%s: niepoprawne gniazdo: %s %s: niepoprawny interwał stanu "%s"
%s: niepoprawny format mapowania przestrzeni tabel "%s", musi być "POPRZFLDR=NOWYFLDR"
%s: nieprawidłowy rozmiar nagłówka bloku tar: %d
%s: błędna szybkość transferu "%s": %s
%s: niepoprawna opcja xlog-method "%s", musi być "fetch" lub "stream"
%s: wiele znaków "=" signs w mapowaniu przestrzeni tabel
%s: nowy folder to nie ścieżka bezwzględna w mapowaniu przestrzeni tabel: %s
%s: nie zwrócono żadnych danych z serwera
%s: nie wskazano bazy danych
%s: nie wskazano gniazda
%s: nie wskazano folderu docelowego
%s: nie wskazano pliku docelowego
%s: nie zwrócono pozycji końca dziennika transakcji z serwera
%s: nie będzie wykonana zmiana nazwy "%s%s", segment nie jest zakończony
%s: poprzedni folder to nie ścieżka bezwzględna w mapowaniu przestrzeni tabel: %s
%s: tylko kopie zapasowe w trybie tar mogą być spakowane
%s: brak pamięci
%s: odebrano sygnał przerwania, wyjście
%s: otrzymano rekord dziennika transakcji dla przesunięcia %u bez otwartego pliku
%s: połączenie replikacji używające gniazda "%s" jest nieoczekiwanie specyficzny dla bazy danych
%s: gniazda replikacji mogą być użyte tylko ze strumieniowaniem WAL
%s: strumień replikacji zakończył się przed punktem zatrzymania
%s: plik segmentu "%s" ma niepoprawny rozmiar %d, pominięto
%s: select() nie powiodła się: %s
%s: serwer zgłosił nieoczekiwaną nazwę pliku historii dla linii czasu %u: %s
%s: serwer zgłosił nieoczekiwaną kolejną linię czasu %u, za linią %u
%s: serwer zwrócił nieoczekiwaną odpowiedź na polecenie BASE_BACKUP; jest %d wierszy i %d pól, oczekiwano %d wierszy i %d pól
%s: serwer zakończył przepływ linii czasu %u na %X/%X, ale zgłosił kolejną linię czasu %u o początku %X/%X
%s: uruchamianie odbiornika WAL w tle
%s: rozpoczęto przesyłanie dziennika na %X/%X (gniazdo %s)
%s: rozpoczęto przesyłanie dziennika na %X/%X (oś czasu %u)
%s: brak początkowej linii czasu %u na serwerze
%s: nagłówek strumienia jest za krótki: %d
%s: uruchomiono przepływ
%s: przełączono na linię czasu %u na %X/%X
%s: linki symb. nie są obsługiwane na tej platformie
%s: identyfikator systemu różni się pomiędzy bazową kopią zapasową i połączeniem strumieniowym
%s: ta kompilacja nie obsługuje kompresji
%s: za duża ilość parametrów (pierwszy to "%s")
%s: położenie folderu dziennika transakcji może być wskazana tylko w trybie tekstowym
%s: położenie folderu dziennika transakcji musi być ścieżką bezwzględną
%s: plik dziennika transakcji "%s" ma %d bajtów, powinno być 0 lub %d
%s: szybkość transferu "%s" jest spoza zakresu typu integer
%s: szybkość transferu "%s" nie jest poprawną wartością
%s: szybkość transferu "%s" jest spoza zakresu
%s: szybkość transferu musi być większa niż zero
%s: nieoczekiwana odpowiedź na polecenie TIMELINE_HISTORY: jest %d wierszy i %d pól, oczekiwano %d wierszy i %d pól
%s: nieoczekiwany zestaw wyników po end-of-timeline: jest %d wierszy i %d pól, oczekiwano %d wierszy i %d pól
%s: nieoczekiwane zakończenie strumienia replikacji: %s %s: nierozpoznany wskaźnik linku "%c"
%s: nierozpoznany nagłówek strumienia: "%c"
%s: oczekiwanie na zakończenie transmisji strumieniowej przez proces w tle ...
Hasło: Spróbuj "%s --help" aby uzyskać więcej informacji.
Składnia:
nie można powielić pustego wskazania (błąd wewnętrzny)
brak pamięci
punkt początkowy dziennika transakcji: %s na linii czasu %u
locale/pl/LC_MESSAGES/pgscripts-9.6.mo 0000644 00000064255 14751153421 0013107 0 ustar 00 �� � | � 0 K 1 }
� > � > � = - Z � � C A d � � # � � ( 9 I V E � � > f ; � = � : < Z 9 � 6 � 5 C > C � 9 � 4 E 5 = { . � ; � E $ : j ? � A � < ' 9 d 7 � 4 � L J X 3 � H � E B f A � 5 � 2 ! N T 7 � 2 � 2 J A : � 5 � G � 0 E < v 0 � ) � M J \ G � 4 � C $! H h! E �! D �! = <" v z" < �" � .# Q �# I $ @ N$ 5 �$ 4 �$ 1 �$ 0 ,% ; ]% 5 �% ' �% 6 �% 3 .& 4 b& @ �& ; �& ; ' ` P' 8 �' 2 �' 9 ( 6 W( > �( �( / �( < ) # F) # j) ? �) 8 �) % * # -* Q* 3 q* & �* �* E �* 6 + E P+ F �+ K �+ 7 ), K a, 7 �, J �, 6 0- < g- D �- 5 �- . * =. 8 h. 6 �. ( �. 4 / $ 6/ # [/ / �/ �/ 8 �/ 4 0 $ E0 j0 , �0 , �0 ( �0 /
1 ; =1 9 y1 ! �1 �1 �1 �1 * 2 8 F2 9 2 , �2 8 �2 # 3 4 C3 3 x3 �3 ) �3 7 �3 +4
@4 N4 C c4 A �4 ! �4 + 5 75 H5 d5 �5 . �5 3 �5 2 6 56 B6 G6
d6 o6 �6 �6 ' �6 " �6 2 7 7 87 p7 & y7 �7 �7 / �7 + �7 * 8 F8 H8 K8 W8 d8 s8 �8 �8 ( �8 �8 �8 � �8 T �: ; 2; M ;; M �; L �; C $< � h< E = C \= �= �= ' �= �=
> -> Q J> Q �> y �> B h? ? �? C �? ? /@ I o@ F �@ C A B DA L �A K �A K B 5 lB J �B ; �B 9 )C ; cC \ �C < �C F 9D N �D F �D ; E B RE ? �E ` �E ` 6F ? �F H �F E G B fG A �G 7 �G 4 #H ^ XH @ �H < �H ? 5I P uI A �I < J E EJ 8 �J B �J < K . DK L sK I �K F
L = QL B �L L �L I M H iM < �M � �M A sN � �N T @O P �O E �O B ,P B oP ? �P : �P < -Q 5 jQ ( �Q : �Q = R < BR B R ; �R ? �R r >S E �S ? �S 8 7T 5 pT H �T �T % �T G !U $ iU # �U = �U A �U - 2V # `V �V - �V 5 �V W W W H dW [ �W a X ` kX P �X a Y P Y \ �Y S -Z K �Z U �Z F #[ " j[ 5 �[ D �[ J \ 5 S\ A �\ ) �\ 0 �\ - &] 1 T] �] < �] ; �] - ^ - I^ 0 w^ , �^ ) �^ ; �^ > ;_ < z_ ' �_ $ �_ ` & !` 9 H` I �` J �` ? a H Wa / �a E �a ? b Vb 3 wb B �b ( �b
c %c S Dc S �c 1 �c / d Nd gd ! �d �d : �d ; e 6 =e
te e % �e �e �e ( �e �e ( f * :f @ ef : �f �f 6 �f !g -g < Gg > �g 4 �g �g �g �g h h .h Eh Oh > hh �h �h � � 9 � � t � � � I S � w & % � � � � G � � - . � � X � { � " � 7 � o � � < � � � L � 4 / K i u � J � ~ B m ( � � � � * �
n f H p � # D g @ ' > � � U � v � x [ � 3
N � � k ! � 8 , � Y F ; � z � � Z � T � � 6 r M � + a 2 W � � $ ] _ � � } = s � j � � ? � ` � c | � l \ V � � � � � E ) : q � � Q C b 1 0 h A y � d R ^ O � � � � � � 5 � � � e P
By default, a database with the same name as the current user is created.
Connection options:
Options:
Read the description of the SQL command CLUSTER for details.
Read the description of the SQL command REINDEX for details.
Read the description of the SQL command VACUUM for details.
Report bugs to <pgsql-bugs@postgresql.org>.
--analyze-in-stages only update optimizer statistics, in multiple
stages for faster results; no vacuum
--lc-collate=LOCALE LC_COLLATE setting for the database
--lc-ctype=LOCALE LC_CTYPE setting for the database
%s [OPTION]...
%s [OPTION]... DBNAME
%s [OPTION]... LANGNAME [DBNAME]
%s [OPTION]... [DBNAME]
%s [OPTION]... [DBNAME] [DESCRIPTION]
%s [OPTION]... [ROLENAME]
--if-exists don't report error if database doesn't exist
--if-exists don't report error if user doesn't exist
--interactive prompt for missing role name and attributes rather
than using defaults
--maintenance-db=DBNAME alternate maintenance database
--maintenance-db=DBNAME alternate maintenance database
--no-replication role cannot initiate replication
--replication role can initiate replication
-?, --help show this help, then exit
-?, --help show this help, then exit
-?, --help show this help, then exit
-?, --help show this help, then exit
-D, --no-createdb role cannot create databases (default)
-D, --tablespace=TABLESPACE default tablespace for the database
-E, --encoding=ENCODING encoding for the database
-E, --encrypted encrypt stored password
-F, --freeze freeze row transaction information
-I, --no-inherit role does not inherit privileges
-L, --no-login role cannot login
-N, --unencrypted do not encrypt stored password
-O, --owner=OWNER database user to own the new database
-P, --pwprompt assign a password to new role
-R, --no-createrole role cannot create roles (default)
-S, --no-superuser role will not be superuser (default)
-S, --schema=SCHEMA reindex specific schema(s) only
-T, --template=TEMPLATE template database to copy
-U, --username=USERNAME user name to connect as
-U, --username=USERNAME user name to connect as
-U, --username=USERNAME user name to connect as (not the one to create)
-U, --username=USERNAME user name to connect as (not the one to drop)
-U, --username=USERNAME user name to connect as
-V, --version output version information, then exit
-V, --version output version information, then exit
-V, --version output version information, then exit
-V, --version output version information, then exit
-W, --password force password prompt
-W, --password force password prompt
-Z, --analyze-only only update optimizer statistics; no vacuum
-a, --all vacuum all databases
-a, --all cluster all databases
-a, --all reindex all databases
-c, --connection-limit=N connection limit for role (default: no limit)
-d, --createdb role can create new databases
-d, --dbname=DBNAME database to vacuum
-d, --dbname=DBNAME database from which to remove the language
-d, --dbname=DBNAME database to cluster
-d, --dbname=DBNAME database to install language in
-d, --dbname=DBNAME database to reindex
-d, --dbname=DBNAME database name
-e, --echo show the commands being sent to the server
-e, --echo show the commands being sent to the server
-e, --echo show the commands being sent to the server
-f, --full do full vacuuming
-g, --role=ROLE new role will be a member of this role
-h, --host=HOSTNAME database server host or socket directory
-h, --host=HOSTNAME database server host or socket directory
-h, --host=HOSTNAME database server host or socket directory
-i, --index=INDEX recreate specific index(es) only
-i, --inherit role inherits privileges of roles it is a
member of (default)
-i, --interactive prompt before deleting anything
-i, --interactive prompt before deleting anything, and prompt for
role name if not specified
-j, --jobs=NUM use this many concurrent connections to vacuum
-l, --list show a list of currently installed languages
-l, --locale=LOCALE locale settings for the database
-l, --login role can login (default)
-p, --port=PORT database server port
-p, --port=PORT database server port
-p, --port=PORT database server port
-q, --quiet don't write any messages
-q, --quiet don't write any messages
-q, --quiet run quietly
-r, --createrole role can create new roles
-s, --superuser role will be superuser
-s, --system reindex system catalogs
-t, --table='TABLE[(COLUMNS)]' vacuum specific table(s) only
-t, --table=TABLE cluster specific table(s) only
-t, --table=TABLE reindex specific table(s) only
-t, --timeout=SECS seconds to wait when attempting connection, 0 disables (default: %s)
-v, --verbose write a lot of output
-v, --verbose write a lot of output
-w, --no-password never prompt for password
-w, --no-password never prompt for password
-z, --analyze update optimizer statistics
%s (%s/%s) %s cleans and analyzes a PostgreSQL database.
%s clusters all previously clustered tables in a database.
%s creates a PostgreSQL database.
%s creates a new PostgreSQL role.
%s installs a procedural language into a PostgreSQL database.
%s issues a connection check to a PostgreSQL database.
%s reindexes a PostgreSQL database.
%s removes a PostgreSQL database.
%s removes a PostgreSQL role.
%s removes a procedural language from a database.
%s: "%s" is not a valid encoding name
%s: %s %s: cannot cluster all databases and a specific one at the same time
%s: cannot cluster specific table(s) in all databases
%s: cannot reindex all databases and a specific one at the same time
%s: cannot reindex all databases and system catalogs at the same time
%s: cannot reindex specific index(es) and system catalogs at the same time
%s: cannot reindex specific index(es) in all databases
%s: cannot reindex specific schema(s) and system catalogs at the same time
%s: cannot reindex specific schema(s) in all databases
%s: cannot reindex specific table(s) and system catalogs at the same time
%s: cannot reindex specific table(s) in all databases
%s: cannot use the "%s" option when performing only analyze
%s: cannot vacuum all databases and a specific one at the same time
%s: cannot vacuum specific table(s) in all databases
%s: clustering database "%s"
%s: clustering of database "%s" failed: %s %s: clustering of table "%s" in database "%s" failed: %s %s: comment creation failed (database was created): %s %s: could not connect to database %s: %s %s: could not connect to database %s: out of memory
%s: could not fetch default options
%s: creation of new role failed: %s %s: database creation failed: %s %s: database removal failed: %s %s: invalid socket: %s %s: language "%s" is already installed in database "%s"
%s: language "%s" is not installed in database "%s"
%s: language installation failed: %s %s: language removal failed: %s %s: missing required argument database name
%s: missing required argument language name
%s: missing required argument role name
%s: number of parallel jobs must be at least 1
%s: only one of --locale and --lc-collate can be specified
%s: only one of --locale and --lc-ctype can be specified
%s: processing database "%s": %s
%s: query failed: %s %s: query was: %s
%s: reindexing database "%s"
%s: reindexing of database "%s" failed: %s %s: reindexing of index "%s" in database "%s" failed: %s %s: reindexing of schema "%s" in database "%s" failed: %s %s: reindexing of system catalogs failed: %s %s: reindexing of table "%s" in database "%s" failed: %s %s: removal of role "%s" failed: %s %s: too many command-line arguments (first is "%s")
%s: too many parallel jobs requested (maximum: %d)
%s: vacuuming database "%s"
%s: vacuuming of database "%s" failed: %s %s: vacuuming of table "%s" in database "%s" failed: %s (%lu row) (%lu rows) Are you sure? Cancel request sent
Cannot add cell to table content: total cell count of %d exceeded.
Cannot add header to table content: column count of %d exceeded.
Could not send cancel request: %s Database "%s" will be permanently removed.
Enter it again: Enter name of role to add: Enter name of role to drop: Enter password for new role: Generating default (full) optimizer statistics Generating medium optimizer statistics (10 targets) Generating minimal optimizer statistics (1 target) Interrupted
Name Password encryption failed.
Password: Passwords didn't match.
Please answer "%s" or "%s".
Procedural Languages Role "%s" will be permanently removed.
Shall the new role be a superuser? Shall the new role be allowed to create databases? Shall the new role be allowed to create more new roles? Trusted? Try "%s --help" for more information.
Usage:
accepting connections
cannot duplicate null pointer (internal error)
could not look up effective user ID %ld: %s invalid output format (internal error): %d n no no attempt
no response
out of memory
rejecting connections
unknown
user does not exist user name lookup failure: error code %lu y yes Project-Id-Version: pgscripts (PostgreSQL 9.1)
Report-Msgid-Bugs-To: pgsql-bugs@postgresql.org
POT-Creation-Date: 2016-07-03 03:14+0000
PO-Revision-Date: 2016-07-03 18:03+0200
Last-Translator: grzegorz <begina.felicysym@wp.eu>
Language-Team: begina.felicysym@wp.eu
Language: pl
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Plural-Forms: nplurals=3; plural=(n==1 ? 0 : n%10>=2 && n%10<=4 && (n%100<10 || n%100>=20) ? 1 : 2);
X-Generator: Virtaal 0.7.1
Domyślnie, jest tworzona baza danych o tej samej nazwie co bieżący użytkownik.
Opcje połączenia:
Opcje:
Przeczytaj opis polecenia SQL CLUSTER by uzyskać informacje szczegółowe.
Przeczytaj opis polecenia SQL REINDEX by uzyskać informacje szczegółowe.
Przeczytaj opis polecenia SQL VACUUM by uzyskać informacje szczegółowe.
Błędy proszę przesyłać na adres <pgsql-bugs@postgresql.org>.
--analyze-in-stages tylko aktualizuj statystyki optymalizatora, przy
wielostopniowych dla szybszych wyników; bez odkurzania
--lc-collate=LOKALIZACJA ustawienie LC_COLLATE dla bazy danych
--lc-ctype=LOKALIZACJA ustawienie LC_CTYPE dla bazy danych
%s [OPCJA]...
%s [OPCJA]... NAZWADB
%s [OPCJA]... NAZWAJĘZYKA [NAZWADB]
%s [OPCJA]... [NAZWADB]
%s [OPCJA]... [NAZWA] [OPIS]
%s [OPCJA]... [NAZWAROLI]
--if-exists nie zgłasza błędu jeśli baza danych nie istnieje
--if-exists nie zgłasza błędu jeśli użytkownik nie istnieje
--interactive monituje o brakującą nazwę roli, zamiast
używać domyślnych
--maintenance-db=NAZWADB alternatywna serwisowa baza danych
--maintenance-db=NAZWADB alternatywna serwisowa baza danych
--no-replication rola nie może rozpoczynać replikacji
--replication rola może rozpoczynać replikacje
-?, --help pokaż tą pomoc i zakończ działanie
-?, --help pokaż tą pomoc i zakończ działanie
-?, --help pokaż tą pomoc i zakończ działanie
-?, --help pokaż tą pomoc i zakończ działanie
-D, --no-createdb rola nie może tworzyć baz danych (domyślnie)
-D, --tablespace=TABLESPACE domyślna przestrzeń tabel dla bazy danych
-E, --encoding=KODOWANIE ustawia domyślne kodowanie dla bazy danych
-E, --encrypted szyfruje zapisane hasło
-F, --freeze zamraża informację transakcji wiersza
-I, --no-inherit rola nie dziedziczy uprawnień
-L, --no-login rola nie może się logować
-N, --unencrypted nie szyfruje zapisanego hasła
-O, --owner=WŁAŚCICIEL użytkownik bazy danych będący właścicielem nowej bazy
-P, --pwprompt przypisuje hasło do nowej roli
-R, --no-createrole rola nie może tworzyć ról (domyślnie)
-S, --no-superuser rola nie będzie superużytkownikiem (domyślnie)
-S, --schema=SCHEMAT przeindeksuj tylko wskazany schemat(y)
-T, --template=SZABLON szablon bazy do skopiowania
-U, --username=NAZWAUZYTK nazwa użytkownika do połączenia
-U, --username=NAZWAUZYTK nazwa użytkownika do połączenia
-U, --username=USERNAME nazwa użytkownika do połączenia z bazą (nie tego do utworzenia)
-U, --username=USERNAME nazwa użytkownika do połączenia z bazą (nie tego do skasowania)
-U, --username=NAZWAUZYTK nazwa użytkownika do połączenia
-V, --version pokaż informacje o wersji i zakończ
-V, --version pokaż informacje o wersji i zakończ
-V, --version pokaż informacje o wersji i zakończ
-V, --version pokaż informacje o wersji i zakończ
-W, --password wymuś pytanie o hasło
-W, --password wymuś pytanie o hasło
-Z, --analyze-only aktualizuje tylko statystyki optymalizatora; bez odkurzania
-a, --all odkurza wszystkie bazy danych
-a, --all sklastruj wszystkie bazy danych
-a, --all przeindeksuj wszystkie bazy danych
-c, --connection-limit=N limit połączeń dla roli (domyślnie: bez limitu)
-d, --createdb rola może tworzyć nowe bazy danych
-d, --dbname=NAZWADB baza danych do odkurzenia
-d, --dbname=NAZWADB baza danych z której usunie się język
-d, --dbname=NAZWADB baza danych do klastrowania
-d, --dbname=NAZWADB baza danych do zainstalowania języka
-d, --dbname=NAZWADB baza danych do przeindeksowania
-d, --dbname=NAZWADB nazwa bazy danych
-e, --echo pokazuje polecenia przesyłane do serwera
-e, --echo pokazuje polecenia przesyłane do serwera
-e, --echo pokazuje polecenia przesyłane do serwera
-f, --full wykonuje pełne odkurzenie
-g, --role=ROLA nowa rola będzie członkiem tej roli
-h, --host=NAZWAHOSTA host serwera bazy danych lub katalog gniazda
-h, --host=NAZWAHOSTA host serwera bazy danych lub katalog gniazda
-h, --host=NAZWAHOSTA host serwera bazy danych lub katalog gniazda
-i, --index=INDEKS odtwórz tylko wskazane indeksy
-i, --inherit rola dziedziczy uprawnienia od ról, których
jest członkiem (domyślnie)
-i, --interactive monit przed usunięciem czegokolwiek
-i, --interactive monit przed usunięciem czegokolwiek oraz monit
o nazwę roli jeśli nie wskazano
-j, --jobs=NUM użycie tylu jednoczesnych połączeń do odkurzania
-l, --list pokazuje listę aktualnie zainstalowanych języków
-l, --locale=LOKALIZACJA ustawienia regionalne dla bazy danych
-l, --login rola może się logować (domyślnie)
-p, --port=PORT numer portu na serwera bazy dnaych
-p, --port=PORT numer portu na serwera bazy dnaych
-p, --port=PORT portu na serwerze bazy dnaych
-q, --quiet nie wypisuje komunikatów
-q, --quiet nie wypisuj komunikatów
-q, --quiet cicha praca
-r, --createrole rola może tworzyć nowe role
-s, --superuser rola będzie superużytkownikiem
-s, --system przeindeksuj katalogi systemowe
-t, --table='TABLE[(COLUMNS)]' odkurza tylko określone tabele
-t, --table=TABELA klastruj tylko wskazane tabele
-t, --table=TABELA przeindeksuj tylko wskazane tabele
-t, --timeout=SEKUNDY sekundy oczekiwania podczas podczas próby połączenia, 0 wyłącza (domyślnie: %s)
-v, --verbose wypisuje dużo danych wyjściowych
-v, --verbose wypisuje dużo danych wyjściowych
-w, --no-password nie pytaj nigdy o hasło
-w, --no-password nie pytaj nigdy o hasło
-z, --analyze aktualizuje statystyki optymalizatora
%s (%s/%s) %s czyści bazę danych PostgreSQL.
%s klastruje wszystkie poprzednio sklastrowane tabele w bazie danych.
%s tworzy bazę danych PostgreSQL.
%s tworzy nową rolę PostgreSQL.
%s instaluje język proceduralny w bazie danych PostgreSQL.
%s zgłasza sprawdzenie połączenia do bazy danych PostgreSQL.
%s przeindeksowuje bazę danych PostgreSQL.
%s usuwa bazę danych PostgreSQL.
%s usuwa rolę PostgreSQL.
%s usuwa język proceduralny z bazy danych.
%s: "%s" nie jest poprawną nazwą kodowania serwera
%s: %s %s: nie można klastrować wszystkich baz danych i jednej wskazanej w tym samym czasie
%s: nie można klastrować wskazanych tabel we wszystkich bazach danych
%s: nie można przeindeksować wszystkich baz danych i jednej wskazanej w tym samym czasie
%s: nie można przeindeksować wszystkich baz danych i katalogów systemowych w tym samym czasie
%s: nie można przeindeksować wskazanych indeksów i katalogów systemowych w tym samym czasie
%s: nie można przeindeksować wskazanych indeksów we wszystkich bazach danych
%s: nie można przeindeksować wskazanych schematów i katalogów systemowych w tym samym czasie
%s: nie można przeindeksować wskazanych indeksów we wszystkich bazach danych
%s: nie można przeindeksować wskazanych tabel i katalogów systemowych w tym samym czasie
%s: nie można przeindeksować wskazanych tabel/tabeli we wszystkich bazach danych
%s: nie można używać opcji "%s" podczas wykonywania wyłącznie analizy
%s: nie można odkurzyć wszystkich baz danych i jednej wskazanej w tym samym czasie
%s: nie można odkurzyć wskazanych tabel we wszystkich bazach danych
%s: klastrowanie bazy danych "%s"
%s: klastrowanie bazy danych "%s" nie udało się: %s %s: klastrowanie tabeli "%s" w bazie danych "%s" nie udało się: %s %s: nie udało się utworzyć notatki (baza danych została utworzona): %s %s: nie można połączyć się do bazy danych %s: %s %s: nie można połączyć się do bazy danych %s: brak pamięci
%s: nie można pobrać opcji domyślnych
%s: utworzenie nowej roli nie powiodło się: %s %s: nie udało się utworzyć bazy danych: %s %s: usunięcie bazy danych nie powiodło się: %s %s: niepoprawne gniazdo: %s %s: język "%s" jest już zainstalowany w bazie danych "%s"
%s: język "%s" nie jest zainstalowany w bazie danych "%s"
%s: instalacja języka nie powiodła się: %s %s: usunięcie języka nie powiodło się: %s %s: brak wymaganego argumentu nazwy bazy danych
%s: brak wymaganego argumentu nazwy języka
%s: brak wymaganego argumentu nazwy roli
%s: liczba zadań współbieżnych musi być co najmniej 1
%s: tylko jedna z --locale i --lc-collate może być wskazany
%s: tylko jedna z --locale i --lc-ctype może być wskazany
%s: przetwarzanie bazy danych "%s": %s
%s: zapytanie nie powiodło się: %s %s: zapytanie brzmiało: %s
%s: przeindeksowanie bazy danych "%s"
%s: przeindeksowanie bazy danych "%s" nie udało się: %s %s: przeindeksowanie indeksu "%s" w bazie danych "%s" nie udało się: %s %s: przeindeksowanie schematu "%s" w bazie danych "%s" nie udało się: %s %s: przeindeksowanie katalogów systemowych nie udało się: %s %s: przeindeksowanie tabeli "%s" w bazie danych "%s" nie udało się: %s %s: usunięcie roli "%s" nie powiodło się: %s %s: za duża ilość parametrów wiersza poleceń (pierwszy to "%s")
%s: za dużo żądanych zadań współbieżnych (maksimum: %d)
%s: odkurzenie bazy danych "%s"
%s: odkurzenie bazy danych "%s" nie udało się: %s %s: odkurzenie tabeli "%s" w bazie danych "%s" nie udało się: %s (%lu wiersz) (%lu wiersze) (%lu wierszy) Czy na pewno? Wysłano żądanie anulowania
Nie można dodać komórki do zawartości tabeli: przekroczona liczba komórek %d.
Nie można dodać nagłówka do zawartości tabeli: przekroczona liczba kolumn %d.
Nie udało się wysłać żądania anulowania: %s Baza danych "%s" zostanie usunięta na stałe.
Powtórz podane hasło: Wpisz nazwę roli do dodania: Wpisz nazwę roli do skasowania: Podaj hasło dla nowej roli: Generowanie domyślnej (pełnej) statystyki optymalizatora Generacja pośredniej statystyki optymalizatora (10 celów) Generacja minimalnej statystyki optymalizatora (1 cel) Przerwane
Nazwa Nie udało się zaszyfrować hasła.
Hasło: Podane hasła różnią się.
Wymagana jest odpowiedź "%s" lub "%s".
Języki Proceduralne Rola "%s" zostanie usunięta na stałe.
Czy nowa rola ma być superużytkownikiem? Czy nowa rola ma mieć możliwość tworzenia nowych baz danych? Czy nowa rola ma mieć możliwość tworzenia nowych ról? Zaufany? Spróbuj "%s --help" aby uzyskać więcej informacji.
Składnia:
akceptowanie połączeń
nie można powielić pustego wskazania (błąd wewnętrzny)
nie udało się odnaleźć efektywnego ID użytkownika %ld: %s niepoprawny format wyjścia (błąd wewnętrzny): %d n nie nie próbowano
brak odpowiedzi
brak pamięci
odrzucanie połaczeń
nieznany
użytkownik nie istnieje niepowodzenie wyszukiwania nazwy użytkownika: kod błędu %lu t tak locale/pl/LC_MESSAGES/ecpg-9.6.mo 0000644 00000034157 14751153421 0012005 0 ustar 00 �� y � � � 8
~ 9
- �
0 �
+ g C � 4 � 7 s 8 . � G � 4 #
) X
w �
4 �
/ @ B = � , � ! � , . 1 [ * � - � 1 � ' & @ + g " � # � � ) � = J T & p < � ! � � - + . " Z } , � � � * " . ' Q y � ! � � ! � 3 ; / o ' � 5 � I � , G / t * � T � ' $ L g � � � - � , � , ! 5 N � ) � ? � 8
� C � 0 � 5 % [ A p L � + �
+ 6 9 ' p # � � ( � 4 � ) ' Q / n � � $ � � " , 8 e } ' � � � $ � D $ + i ? � 0 � 8 % ^ | & � � � � � � C U! 9 �! 5 �! s " " }" G �" 8 �" q !# 7 �# I �# @ $ + V$ � �$ @ % F% D ]% 9 �% D �% ( !& $ J& 2 o& 1 �& * �& - �& 1 -' ' _' & �' + �' - �' ( ( 1( 6 :( N q( �( " �( 6 �( F ") * i) �) , �) 8 �) ( * 2* 2 K* ~* �* 0 �* 4 �* 2 + N+ ! i+ ) �+ �+ ( �+ �+ # , 2 7, 3 j, $ �, D �, P - + Y- 2 �- ' �- b �- * C. ' n. �. �. �. �. 4 �. 3 3/ 3 g/ 5 �/ �/ ( �/ C 0 5 _0 �0 # �1 ? �1 ; 2 J2 A a2 O �2 * �2
3 > ,3 - k3 $ �3 �3 , �3 @ �3 0 <4 m4 8 �4 �4 % �4 + 5 ,5 # F5 0 j5 �5 ' �5 / �5 ' 6 " 86 * [6 I �6 7 �6 C 7 - L7 " z7 7 �7 �7 ' �7 & 8 + C8 Y * - < ? " 9 M O = ^ 0 w y , P 2 l
t ) G v 5 x C : e F Z ] X % k J H ; [ U i d
E N $ a b T ! 6 D h ( & g f u A K W # 1 V n B I + o _ 8 s Q 4 / 7 S ` L c > \ m p ' 3 @ q R j r .
If no output file is specified, the name is formed by adding .c to the
input file name, after stripping off .pgc if present.
Report bugs to <pgsql-bugs@postgresql.org>.
--regression run in regression testing mode
-?, --help show this help, then exit
-C MODE set compatibility mode; MODE can be one of
"INFORMIX", "INFORMIX_SE"
-D SYMBOL define SYMBOL
-I DIRECTORY search DIRECTORY for include files
-V, --version output version information, then exit
-c automatically generate C code from embedded SQL code;
this affects EXEC SQL TYPE
-d generate parser debug output
-h parse a header file, this option includes option "-c"
-i parse system include files as well
-o OUTFILE write result to OUTFILE
-r OPTION specify run-time behavior; OPTION can be:
"no_indicator", "prepare", "questionmarks"
-t turn on autocommit of transactions
%s at or near "%s" %s is the PostgreSQL embedded SQL preprocessor for C programs.
%s, the PostgreSQL embedded C preprocessor, version %d.%d.%d
%s: could not locate my own executable path
%s: could not open file "%s": %s
%s: no input files specified
%s: parser debug support (-d) not available
AT option not allowed in CLOSE DATABASE statement AT option not allowed in CONNECT statement AT option not allowed in DISCONNECT statement AT option not allowed in SET CONNECTION statement AT option not allowed in TYPE statement AT option not allowed in VAR statement AT option not allowed in WHENEVER statement COPY FROM STDIN is not implemented CREATE TABLE AS cannot specify INTO ERROR: EXEC SQL INCLUDE ... search starts here:
Error: include path "%s/%s" is too long on line %d, skipping
Options:
SHOW ALL is not implemented Try "%s --help" for more information.
Unix-domain sockets only work on "localhost" but not on "%s" Usage:
%s [OPTION]... FILE...
WARNING: arrays of indicators are not allowed on input could not open include file "%s" on line %d could not remove output file "%s"
cursor "%s" does not exist cursor "%s" has been declared but not opened cursor "%s" is already defined descriptor "%s" does not exist descriptor header item "%d" does not exist descriptor item "%s" cannot be set descriptor item "%s" is not implemented end of search list
expected "://", found "%s" expected "@" or "://", found "%s" expected "@", found "%s" expected "postgresql", found "%s" incomplete statement incorrectly formed variable "%s" indicator for array/pointer has to be array/pointer indicator for simple data type has to be simple indicator for struct has to be a struct indicator variable "%s" is hidden by a local variable indicator variable "%s" is hidden by a local variable of a different type indicator variable must have an integer type initializer not allowed in EXEC SQL VAR command initializer not allowed in type definition internal error: unreachable state; please report this to <pgsql-bugs@postgresql.org> interval specification not allowed here invalid bit string literal invalid connection type: %s invalid data type key_member is always 0 missing "EXEC SQL ENDIF;" missing identifier in EXEC SQL DEFINE command missing identifier in EXEC SQL IFDEF command missing identifier in EXEC SQL UNDEF command missing matching "EXEC SQL IFDEF" / "EXEC SQL IFNDEF" more than one EXEC SQL ELSE multidimensional arrays are not supported multidimensional arrays for simple data types are not supported multidimensional arrays for structures are not supported multilevel pointers (more than 2 levels) are not supported; found %d level multilevel pointers (more than 2 levels) are not supported; found %d levels nested /* ... */ comments nested arrays are not supported (except strings) no longer supported LIMIT #,# syntax passed to server nullable is always 1 only data types numeric and decimal have precision/scale argument only protocols "tcp" and "unix" and database type "postgresql" are supported operator not allowed in variable definition out of memory pointer to pointer is not supported for this data type pointers to varchar are not implemented subquery in FROM must have an alias syntax error syntax error in EXEC SQL INCLUDE command too many levels in nested structure/union definition too many nested EXEC SQL IFDEF conditions type "%s" is already defined type name "string" is reserved in Informix mode unmatched EXEC SQL ENDIF unrecognized data type name "%s" unrecognized descriptor item code %d unrecognized token "%s" unrecognized variable type code %d unsupported feature will be passed to server unterminated /* comment unterminated bit string literal unterminated hexadecimal string literal unterminated quoted identifier unterminated quoted string using unsupported DESCRIBE statement using variable "%s" in different declare statements is not supported variable "%s" is hidden by a local variable variable "%s" is hidden by a local variable of a different type variable "%s" is neither a structure nor a union variable "%s" is not a pointer variable "%s" is not a pointer to a structure or a union variable "%s" is not an array variable "%s" is not declared variable "%s" must have a numeric type zero-length delimited identifier Project-Id-Version: ecpg (PostgreSQL 9.1)
Report-Msgid-Bugs-To: pgsql-bugs@postgresql.org
POT-Creation-Date: 2016-09-25 15:38+0000
PO-Revision-Date: 2016-09-26 10:30-0400
Last-Translator: grzegorz <begina.felicysym@wp.eu>
Language-Team: begina.felicysym@wp.eu
Language: pl
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Plural-Forms: nplurals=3; plural=(n==1 ? 0 : n%10>=2 && n%10<=4 && (n%100<10 || n%100>=20) ? 1 : 2);
X-Generator: Virtaal 0.7.1
Jeżeli nie wskazano pliku wyjścia, nazwa jest tworzona przez dodanie .c
do nazwy pliku wejścia, po usunięciu .pgc jeśli obecne.
Błędy proszę przesyłać na adres <pgsql-bugs@postgresql.org>.
--regression wykonanie w trybie testów regresyjnych
-?, --help pokazuje ten ekran pomocy i kończy
-C TRYB ustala tryb kompatybilności; TRYB może być jednym z
"INFORMIX", "INFORMIX_SE"
-D SYMBOL definiuje SYMBOL
-I FOLDER przeszukuje FOLDER w poszukiwaniu plików nagłówkowych
-V, --version wypisuje informacje o wersji i kończy
-c automatycznie generuje kod w C z osadzonego kodu SQL;
dotyczy to EXEC SQL TYPE
-d generuje wyjście debugowania parsera
-h parsuje plik nagłówkowy, opcja ta zawiera opcję "-c"
-i parsuje również systemowe pliki nagłówkowe
-o PLIKOUT zapisuje wynik do PLIKOUT
-r OPCJA określa zachowanie uruchomienia; OPTCJA może być:
"no_indicator", "prepare", "questionmarks"
-t włącza automatyczne zatwierdzanie transakcji
%s w lub pobliżu "%s" %s jest osadzonym w PostgreSQL preprocesorem SQL dla programów C.
%s, preprocesor C osadzony w PostgreSQL, wersja %d.%d.%d
%s: nie można odnaleźć własnej ścieżki programu wykonywalnego
%s: nie można otworzyć pliku "%s": %s
%s: nie wskazano pliku wejściowego
%s: wsparcie debugu analizatora (-d) niedostępne
opcja AT niedozwolona w wyrażeniu CLOSE DATABASE opcja AT niedozwolona w wyrażeniu CONNECT opcja AT niedozwolona w wyrażeniu DISCONNECT opcja AT niedozwolona w wyrażeniu SET CONNECTION opcja AT niedozwolona w wyrażeniu TYPE opcja AT niedozwolona w wyrażeniu VAR opcja AT niedozwolona w wyrażeniu WHENEVER COPY FROM STDIN nie zostało zaimplementowane CREATE TABLE AS nie może zawierać INTO BŁĄD: EXEC SQL INCLUDE ... wyszukiwanie zaczyna się tutaj:
Błąd: załączona ścieżka "%s/%s" jest zbyt długa w linii %d, pominięto
Opcje:
SHOW ALL nie jest zaimplementowane Spróbuj "%s --help" aby uzyskać więcej informacji.
Gniazda dziedziny Uniksa działają tylko na "localhost" a nie na "%s" Sposób użycia:
%s [OPCJE]... PLIK...
OSTRZEŻENIE: tabele wskazań nie są dozwolone w wejściu nie można otworzyć załączonego pliku "%s" w linii %d nie można usunąć pliku wyjścia "%s"
kursor "%s" nie istnieje kursor "%s" został zadeklarowany, ale nie otwarty kursor "%s" już istnieje deskryptor "%s" nie istnieje element nagłówka deskryptora "%d" nie istnieje element deskryptora "%s" nie może zostać ustawiony element deskryptora "%s" nie jest zaimplementowany koniec listy wyszukiwania
oczekiwano "://", znaleziono "%s" oczekiwano "@" lub "://", znaleziono "%s" oczekiwano "@", znaleziono "%s" oczekiwano "postgresql", znaleziono "%s" niepełne wyrażenie niepoprawnie utworzona zmienna "%s" wskaźnik do array/pointer musi być array/pointer wskaźnik do prostego typu danych musi być prosty wskaźnik do struct musi być struct zmienna wskaźnikowa "%s" została przykryta przez zmienną lokalną zmienna wskaźnikowa "%s" została przykryta przez zmienną lokalną innego typu zmienna wskaźnikowa musi mieć typ integer inicjator niedopuszczalny w poleceniu EXEC SQL VAR inicjator niedozwolony w definicji typu błąd wewnętrzny: nieosiągalny stan; proszę przesłać go na adres <pgsql-bugs@postgresql.org> specyfikacja interwału niedozwolona tutaj nieprawidłowa stała łańcucha bitów niepoprawny typ połączenia: %s niepoprawny typ danych key_member jest zawsze 0 brak "EXEC SQL ENDIF;" brakujący identyfikator w poleceniu EXEC SQL DEFINE brakujący identyfikator w poleceniu EXEC SQL IFDEF brakujący identyfikator w poleceniu EXEC SQL UNDEF brak pasującego "EXEC SQL IFDEF" / "EXEC SQL IFNDEF" więcej niż jeden EXEC SQL ELSE wielowymiarowe tablice nie są wspierane wielowymiarowe tablice dla prostych typów danych nie są wspierane wielowymiarowe tablice dla struktur nie są wspierane wielopoziomowe wskaźniki (więcej niż 2 poziomy) nie są wspierane; znaleziono %d poziom wielopoziomowe wskaźniki (więcej niż 2 poziomy) nie są wspierane; znaleziono %d poziomy wielopoziomowe wskaźniki (więcej niż 2 poziomy) nie są wspierane; znaleziono %d poziomów zagnieżdżone komentarze /* ... */ tabele zagnieżdżone nie są wspierane (poza ciągami znaków) już nie wspierana składnia LIMIT #,# przesłana na serwer nullable jest zawsze 1 tylko typy danych numeric i decimal mają argument precyzji/skali tylko protokoły "tcp" i "unix" oraz typ bazy danych "postgresql" są wspierane operator niedozwolony w definicji zmiennej brak pamięci wskazanie na wskaźnik nie jest wspierane dla tego typu danych wskazania na varchar nie są zaimplementowane podzapytanie z FROM musi mieć alias błąd składni błąd składni w poleceniu EXEC SQL INCLUDE zbyt wiele poziomów w zagnieżdżonej definicji structure/union zbyt wiele zagłębień warunków EXEC SQL IFDEF typ "%s" już istnieje nazwa typu "string" jest zarezerwowana w trybie Informix niedopasowany EXEC SQL ENDIF niezrozumiała nazwa typu danych "%s" niezrozumiały kod deskryptora elementu %d niezrozumiały token "%s" niezrozumiały kod typu zmiennej %d niewspierana cecha zostanie przekazana na serwer nie zakończony komentarz /* niezakończona stała łańcucha bitów niezakończona stała łańcucha szesnastkowego niezakończony łańcuch identyfikatora niezakończona stała łańcuchowa użycie niewspieranego wyrażenia DESCRIBE użycie zmiennej "%s" w innych wyrażeniach deklaracji nie jest wspierane zmienna "%s" została przykryta przez zmienną lokalną zmienna "%s" została przykryta przez zmienną lokalną innego typu zmienna "%s" nie jest ani structure ani union zmienna "%s" nie jest wskaźnikiem zmienna "%s" nie jest wskazaniem na structure ani union zmienna "%s" nie jest tablicą zmienna "%s" nie została zadeklarowana zmienna "%s" musi mieć typ numeryczny ograniczony identyfikator o długości zero locale/pl/LC_MESSAGES/pg_dump-9.6.mo 0000644 00000173522 14751153421 0012522 0 ustar 00 �� � D � l �( �( �( X �( [ ) B g) ) �) " �) x �) p* v* �* �* A �* N �* P M+ I �+ 3 �+ y , G �, C �, N "- K q- v �- F 4. > {. R �. B
/ E P/ ? �/ L �/ 3 #0 6 W0 Q �0 T �0 M 51 ? �1 � �1 � Q2 ?
3 9 J3 5 �3 : �3 K �3 B A4 D �4 � �4 3 J5 � ~5 ? 6 D @6 x �6 6 �6 Q 57 O �7 F �7 > 8 5 ]8 > �8 E �8 A 9 O Z9 H �9 B �9 @ 6: = w: O �: H ; ; N; , �; 4 �; E �; 0 2< = c< , �< F �< D = C Z= F �= 8 �= ? > C ^> = �> 4 �> 7 ? L M? = �? @ �? J @ < d@ L �@ , �@ ( A 5 DA E zA T �A B 9 B D RB G �B �B �B ? C ' UC + }C e �C ! D , 1D 4 ^D 6 �D ( �D / �D #E AE $ SE * xE 2 �E B �E > F J XF P �F N �F H CG - �G �G �G / �G H 4 $H $ YH & ~H * �H # �H �H P I C dI A �I ( �I J 1J JJ eJ = �J � �J
KK , VK � �K � L , �L �L p �L e fM & �M �M ` �M p \N 4 �N X O _ [O E �O 1 P 6 3P 4 jP * �P - �P . �P + 'Q + SQ ) Q * �Q > �Q 8 R ' LR = tR ) �R 1 �R S @ )S 7 jS 6 �S 6 �S < T = MT 4 �T 3 �T b �T 9 WU < �U t �U # CV , gV 5 �V �V �V W
W ' #W KW % WW }W / �W X �W & &X 0 MX . ~X ) �X ) �X Y Y *Y 3 6Y ( jY �Y ) �Y # �Y �Y Z & 0Z K WZ & �Z �Z ! �Z (
[ ' 3[ [[ # z[ �[ / �[ �[ \ # +\ % O\ u\ , �\ $ �\ $ �\ $ ] 6 .] e] }] B �] � �] � x^ _ $ '_ 3 L_ ' �_ ' �_ + �_ ( �_ ( %` # N` - r` � �` + pa , �a ! �a & �a ' b # :b ^b " }b 8 �b $ �b �b c Q =c & �c a �c @ d 5 Yd �d " �d # �d , �d e ! =e # _e * �e # �e % �e 0 �e & )f $ Pf uf " �f = �f 1 �f 'g 9g Ng : ^g ) �g B �g P h Wh jh �h �h " �h �h �h & i & 5i % \i 2 �i �i �i & �i !
j ) /j # Yj " }j �j r �j < $k D ak N �k �k l 5l & Ol , vl - �l �l " �l / m >m Vm ( sm @ �m �m �m n P 0n �n > �n 1 �n > o / Go Y wo > �o p +p " Ip lp & �p < �p �p ' q ( )q ' Rq zq �q �q 1 �q + �q % r 3 Fr zr �r " �r ; �r s s :s / Ys �s �s �s . �s I
t > Wt D �t �t �t u 7 u 9 Qu 6 �u H �u @ v Lv 3 ^v & �v 0 �v 6 �v / !w ( Qw , zw �w " �w �w �w x h %x T �x � �x 6 fy L �y J �y 9 5z oz $ ~z + �z �z �z { { 1{ 2 E{ x{ " �{ �{ �{ # �{ �{ | / .| ^| & o| �| �| # �| �| $ �| ) } C} ! d} % �} + �} �} & �} ' ~ G~ g~ 0 �~ . �~ ) �~ + : V 4 t � � # ,� * P� {� �� �� ( À � " � &� E ;� # �� ) �� , ρ �� � ,� ; 3� o� �� �� ' �� ւ ' � � % 6� \� x� B �� 0 ! � 8 +� : d� �� �� 3 ڄ 1 � 1 @� + r� $ �� $ Å h � � Q� @� V� W g� \ �� I � + f� �� o �� � &� 7� R� L j� R �� ]
� [ h� K ċ � � F �� L � N 6� n �� { � M p� D �� b � J f� L �� H �� � G� @ ϐ @ � W Q� Y �� w � B {� � �� � \� F � F e� B �� @ � P 0� A �� U Õ � � ; �� � � ^ k� B ʗ �
� = �� \ Ҙ U /� J �� > Й > � G N� E �� A ܚ V � N u� ? ě A � > F� _ �� U � Q ;� < �� D ʝ X � 4 h� @ �� 0 ޞ M � H ]� O �� S �� > J� C �� F ͠ ? � 5 T� > �� T ɡ @ � B _� R �� @ �� V 6� ? �� ; ͣ 4 � F >� ] �� � D � F +� K r� " �� & � J � 4 S� 8 �� x �� & :� 1 a� G �� M ۧ - )� 1 W� 2 �� �� 2 Ψ 4 � . 6� D e� > �� L � R 6� P �� J ڪ > %� $ d� �� < �� � 4 �� % .� / T� + �� & �� ( W � Q X� O �� & �� !� A� _� " z� E �� � � �� B �� � ٯ � �� 5 6� l� x �� m �� 6 j� �� o �� o � A �� � ϳ q U� d Ǵ 9 ,� > f� < �� 7 � < � @ W� = �� = ֶ ; � < P� M �� I ۷ 6 %� H \� 7 �� 8 ݸ % � R <� I �� E ٹ G � M g� O �� F � D L� f �� D �� F =� t �� 3 �� 0 -� > ^� " �� �� � � " � #� 2 7� 4 j� < �� a ܾ 0 >� ; o� 5 �� 2 � 2 � G� a� z� : �� * � � 5 � - 6� % d� �� 7 �� Y � ( 8� # a� ( �� 3 �� 3 �� & � ' =� ( e� : �� ( �� $ �� , � 2 D� % w� 3 �� & �� + �� + $� A P� �� �� U �� � '� � �� �� + �� > �� 7 '� = _� 2 �� * �� 2 �� - .� 6 \� � �� 3 r� 2 �� ( �� . � - 1� - _� ' �� + �� E �� - '� ' U� ( }� c �� 2
� } =� M �� C � # M� % q� ( �� 0 �� ' �� 2 � 7 L� 0 �� ) �� + �� @ � 2 L� 0 � ' �� ) �� G � 3 J� ~� �� �� : �� 4 �� S /� M �� �� �� � '� ! 8� Z� 0 z� * �� ) �� ( � 8 )� ) b� ' �� 7 �� % �� 0 � ( C� ' l� �� � �� I �� ] �� j 8� + �� 4 �� � 3 #� 6 W� 6 �� �� # �� 0 � :� / W� / �� P �� � ) %� , O� � |� � M -� 6 {� F �� > �� ^ 8� @ �� ! �� $ �� ) � # I� / m� A �� �� , �� - %� - S� �� �� �� ; �� 4 � * D� E o� �� �� # �� I � `� & x� ! �� 0 �� " �� � 2� * O� K z� @ �� F � N� ]� ~� W �� M �� K >� b �� I �� 7� : U� 3 �� ? �� > � 5 C� 5 y� 4 �� �� $ �� � - <� j� y �� � � � �� 5 \� _ �� P �� 9 C� }� & �� * �� �� �� $ � @� \� 4 p� �� $ �� �� �� " � )� J� = g� �� ( �� �� �� %
� 0� # I� * m� �� �� % �� , �� *� % G� ' m� �� �� 9 �� 8 � : D� 7 � �� �� Y �� � K� % �� E � W� t� �� ' �� �� �� � U &� $ |� 2 �� 5 ��
� )�
H� K S� �� �� ( �� ) �� � . ?� * n� * �� �� # �� G � 8 M� # �� ? �� D �� /� N� 5 o� 5 �� 5 � 2 � - D� 3 r� � �� f � � � � y � � � � E L � � � * � 9 } � ' � K G 3 W ) B � � � f � � C H V � � � Z a � } ( � F � c � � > � G � S C � � � � 0 ~ i ) A � � !
[ � � � � * � l � z o � � � � � � � ^ � . V � o � ` � � � � 1 � � � N P � � � M � � q � c � 2 t 5 � h � � � < � � E M � � { � � J > � � � � I Y � � � � � � � + b � � � � � � \ � O r u : - � � R � j ^ � 4 I � F � � " w N
� � � ' d B " � � � � � � � 3 q � 5 � � | � � � { w � r � & L � i � � � � / ` � D [ � n a � ; ~ g @ �
\ p X � T � � % p � � X � � � � P | . n � � � � � � � ? � � � � � � � = � � � � ] � � 7 D � � v � � � � ( @ s � � ! � O � g � � Q H � k R � y � & � = 8 ? $ � e 9 � � - : � � 7 � � l t � � � � � � # � � � j , # � b � � � _ � � S � � � 2 k h � � m J � e 6 Z � � K � 4 Q � < � � � 6 � � 1 � � � s � + / � $ � x � � % _ � ] u d , � � 0 � U � � A T Y � 8 � � � � m ; U � z W x v �
Connection options:
General options:
If -f/--file is not used, then the SQL script will be written to the standard
output.
If no database name is supplied, then the PGDATABASE environment
variable value is used.
If no input file name is supplied, then standard input is used.
Options controlling the output content:
Options controlling the restore:
The options -I, -n, -P, -t, -T, and --section can be combined and specified
multiple times to select multiple objects.
%s
%s [OPTION]...
%s [OPTION]... [DBNAME]
%s [OPTION]... [FILE]
--binary-upgrade for use by upgrade utilities only
--column-inserts dump data as INSERT commands with column names
--disable-dollar-quoting disable dollar quoting, use SQL standard quoting
--disable-triggers disable triggers during data-only restore
--enable-row-security enable row security
--enable-row-security enable row security (dump only content user has
access to)
--exclude-table-data=TABLE do NOT dump data for the named table(s)
--if-exists use IF EXISTS when dropping objects
--inserts dump data as INSERT commands, rather than COPY
--lock-wait-timeout=TIMEOUT fail after waiting TIMEOUT for a table lock
--no-data-for-failed-tables do not restore data of tables that could not be
created
--no-security-labels do not dump security label assignments
--no-security-labels do not restore security labels
--no-synchronized-snapshots do not use synchronized snapshots in parallel jobs
--no-tablespaces do not dump tablespace assignments
--no-tablespaces do not restore tablespace assignments
--no-unlogged-table-data do not dump unlogged table data
--quote-all-identifiers quote all identifiers, even if not key words
--role=ROLENAME do SET ROLE before dump
--role=ROLENAME do SET ROLE before restore
--section=SECTION dump named section (pre-data, data, or post-data)
--section=SECTION restore named section (pre-data, data, or post-data)
--serializable-deferrable wait until the dump can run without anomalies
--snapshot=SNAPSHOT use given snapshot for the dump
--strict-names require table and/or schema include patterns to
match at least one entity each
--use-set-session-authorization
use SET SESSION AUTHORIZATION commands instead of
ALTER OWNER commands to set ownership
-1, --single-transaction restore as a single transaction
-?, --help show this help, then exit
-?, --help show this help, then exit
-C, --create create the target database
-C, --create include commands to create database in dump
-E, --encoding=ENCODING dump the data in encoding ENCODING
-F, --format=c|d|t backup file format (should be automatic)
-F, --format=c|d|t|p output file format (custom, directory, tar,
plain text (default))
-I, --index=NAME restore named index
-L, --use-list=FILENAME use table of contents from this file for
selecting/ordering output
-N, --exclude-schema=SCHEMA do NOT dump the named schema(s)
-O, --no-owner skip restoration of object ownership
-O, --no-owner skip restoration of object ownership in
plain-text format
-P, --function=NAME(args) restore named function
-S, --superuser=NAME superuser user name to use for disabling triggers
-S, --superuser=NAME superuser user name to use in plain-text format
-S, --superuser=NAME superuser user name to use in the dump
-T, --exclude-table=TABLE do NOT dump the named table(s)
-T, --trigger=NAME restore named trigger
-U, --username=NAME connect as specified database user
-V, --version output version information, then exit
-V, --version output version information, then exit
-W, --password force password prompt (should happen automatically)
-Z, --compress=0-9 compression level for compressed formats
-a, --data-only dump only the data, not the schema
-a, --data-only restore only the data, no schema
-b, --blobs include large objects in dump
-c, --clean clean (drop) database objects before recreating
-c, --clean clean (drop) databases before recreating
-d, --dbname=CONNSTR connect using connection string
-d, --dbname=DBNAME database to dump
-d, --dbname=NAME connect to database name
-e, --exit-on-error exit on error, default is to continue
-f, --file=FILENAME output file name
-f, --file=FILENAME output file or directory name
-f, --file=FILENAME output file name
-g, --globals-only dump only global objects, no databases
-h, --host=HOSTNAME database server host or socket directory
-j, --jobs=NUM use this many parallel jobs to dump
-j, --jobs=NUM use this many parallel jobs to restore
-l, --database=DBNAME alternative default database
-l, --list print summarized TOC of the archive
-n, --schema=NAME restore only objects in this schema
-n, --schema=SCHEMA dump the named schema(s) only
-o, --oids include OIDs in dump
-p, --port=PORT database server port number
-r, --roles-only dump only roles, no databases or tablespaces
-s, --schema-only dump only the schema, no data
-s, --schema-only restore only the schema, no data
-t, --table=NAME restore named relation (table, view, etc.)
-t, --table=TABLE dump the named table(s) only
-t, --tablespaces-only dump only tablespaces, no databases or roles
-v, --verbose verbose mode
-v, --verbose verbose mode
-w, --no-password never prompt for password
-x, --no-privileges do not dump privileges (grant/revoke)
-x, --no-privileges skip restoration of access privileges (grant/revoke)
%s %s dumps a database as a text file or to other formats.
%s extracts a PostgreSQL database cluster into an SQL script file.
%s restores a PostgreSQL database from an archive created by pg_dump.
%s: %s Command was: %s
%s: WSAStartup failed: %d
%s: cannot specify both --single-transaction and multiple jobs
%s: could not connect to database "%s"
%s: could not connect to database "%s": %s
%s: could not connect to databases "postgres" or "template1"
Please specify an alternative database.
%s: could not get server version
%s: could not open the output file "%s": %s
%s: could not parse ACL list (%s) for database "%s"
%s: could not parse ACL list (%s) for tablespace "%s"
%s: could not parse server version "%s"
%s: could not re-open the output file "%s": %s
%s: dumping database "%s"...
%s: executing %s
%s: invalid number of parallel jobs
%s: maximum number of parallel jobs is %d
%s: option --if-exists requires option -c/--clean
%s: options -c/--clean and -a/--data-only cannot be used together
%s: options -d/--dbname and -f/--file cannot be used together
%s: options -g/--globals-only and -r/--roles-only cannot be used together
%s: options -g/--globals-only and -t/--tablespaces-only cannot be used together
%s: options -r/--roles-only and -t/--tablespaces-only cannot be used together
%s: options -s/--schema-only and -a/--data-only cannot be used together
%s: pg_dump failed on database "%s", exiting
%s: query failed: %s %s: query was: %s
%s: role name starting with "pg_" skipped (%s)
%s: running "%s"
%s: too many command-line arguments (first is "%s")
%s: unrecognized section name: "%s"
(The INSERT command cannot set OIDs.)
(The system catalogs might be corrupted.)
-C and -1 are incompatible options
COPY failed for table "%s": %s Consider using a full dump instead of a --data-only dump to avoid this problem.
Dumping the contents of table "%s" failed: PQgetCopyData() failed.
Dumping the contents of table "%s" failed: PQgetResult() failed.
Error from TOC entry %d; %u %u %s %s %s
Error message from server: %s Error while FINALIZING:
Error while INITIALIZING:
Error while PROCESSING TOC:
Exported snapshots are not supported by this server version.
NOTICE: there are circular foreign-key constraints on this table:
NOTICE: there are circular foreign-key constraints among these tables:
Password: Report bugs to <pgsql-bugs@postgresql.org>.
Synchronized snapshots are not supported by this server version.
Run with --no-synchronized-snapshots instead if you do not need
synchronized snapshots.
Synchronized snapshots are not supported on standby servers.
Run with --no-synchronized-snapshots instead if you do not need
synchronized snapshots.
TOC Entry %s at %s (length %s, checksum %d)
The command was: %s
The program "pg_dump" is needed by %s but was not found in the
same directory as "%s".
Check your installation.
The program "pg_dump" was found by "%s"
but was not the same version as %s.
Check your installation.
Try "%s --help" for more information.
Usage:
WARNING: aggregate function %s could not be dumped correctly for this database version; ignored
WARNING: archive is compressed, but this installation does not support compression -- no data will be available
WARNING: archive items not in correct section order
WARNING: archive was made on a machine with larger integers, some operations might fail
WARNING: bogus transform definition, at least one of trffromsql and trftosql should be nonzero
WARNING: bogus value in pg_cast.castfunc or pg_cast.castmethod field
WARNING: bogus value in pg_cast.castmethod field
WARNING: bogus value in pg_transform.trffromsql field
WARNING: bogus value in pg_transform.trftosql field
WARNING: bogus value in proargmodes array
WARNING: could not find operator with OID %s
WARNING: could not parse proallargtypes array
WARNING: could not parse proargmodes array
WARNING: could not parse proargnames array
WARNING: could not parse proconfig array
WARNING: could not parse reloptions array
WARNING: could not resolve dependency loop among these items:
WARNING: don't know how to set owner for object type %s
WARNING: errors ignored on restore: %d
WARNING: ftell mismatch with expected position -- ftell used
WARNING: invalid creation date in header
WARNING: invalid type "%c" of access method "%s"
WARNING: line ignored: %s
WARNING: owner of aggregate function "%s" appears to be invalid
WARNING: owner of data type "%s" appears to be invalid
WARNING: owner of function "%s" appears to be invalid
WARNING: owner of operator "%s" appears to be invalid
WARNING: owner of operator class "%s" appears to be invalid
WARNING: owner of operator family "%s" appears to be invalid
WARNING: owner of schema "%s" appears to be invalid
WARNING: owner of table "%s" appears to be invalid
WARNING: requested compression not available in this installation -- archive will be uncompressed
WARNING: typtype of data type "%s" appears to be invalid
WARNING: unexpected extra results during COPY of table "%s"
You might not be able to restore the dump without using --disable-triggers or temporarily dropping the constraints.
a worker process died unexpectedly
aborting because of server version mismatch
actual file length (%s) does not match expected (%s)
allocating AH for %s, format %d
already connected to a database
archiver archiver (db) attempting to ascertain archive format
bad dumpId
bad table dumpId for TABLE DATA item
can only reopen input archives
cannot duplicate null pointer (internal error)
cannot restore from compressed archive (compression not supported in this installation)
child process exited with exit code %d child process exited with unrecognized status %d child process was terminated by exception 0x%X child process was terminated by signal %d child process was terminated by signal %s command not executable command not found compress_io compression is not supported by tar archive format
compression level must be in range 0..9
compressor active
connecting to database "%s" as user "%s"
connecting to database for restore
connecting to new database "%s"
connection needs password
connection to database "%s" failed: %s corrupt tar header found in %s (expected %d, computed %d) file position %s
could not change directory to "%s": %s could not close TOC file: %s
could not close archive file: %s
could not close compression library: %s
could not close compression stream: %s
could not close data file: %s
could not close directory "%s": %s
could not close input file: %s
could not close large object TOC file "%s": %s
could not close output file: %s
could not close tar member
could not close temporary file: %s
could not commit database transaction could not compress data: %s
could not create communication channels: %s
could not create directory "%s": %s
could not create large object %u: %s could not create worker process: %s
could not determine seek position in archive file: %s
could not execute query could not find a "%s" to execute could not find block ID %d in archive -- possibly corrupt archive
could not find block ID %d in archive -- possibly due to out-of-order restore request, which cannot be handled due to lack of data offsets in archive
could not find block ID %d in archive -- possibly due to out-of-order restore request, which cannot be handled due to non-seekable input file
could not find entry for ID %d
could not find file "%s" in archive
could not find header for file "%s" in tar archive
could not find parent extension for %s
could not find slot of finished worker
could not generate temporary file name: %s
could not get server_version from libpq
could not identify current directory: %s could not identify dependency loop
could not initialize compression library: %s
could not obtain lock on relation "%s"
This usually means that someone requested an ACCESS EXCLUSIVE lock on the table after the pg_dump parent process had gotten the initial ACCESS SHARE lock on the table.
could not open TOC file "%s" for input: %s
could not open TOC file "%s" for output: %s
could not open TOC file "%s": %s
could not open TOC file for input: %s
could not open TOC file for output: %s
could not open input file "%s": %s
could not open input file: %s
could not open large object %u: %s could not open large object TOC file "%s" for input: %s
could not open output file "%s": %s
could not open output file: %s
could not open temporary file
could not parse GRANT ACL list (%s) or REVOKE ACL list (%s) for object "%s" (%s)
could not parse default ACL list (%s)
could not parse initial GRANT ACL list (%s) or initial REVOKE ACL list (%s) for object "%s" (%s)
could not parse numeric array "%s": invalid character in number
could not parse numeric array "%s": too many numbers
could not read binary "%s" could not read directory "%s": %s
could not read from input file: %s
could not read from input file: end of file
could not read input file: %s
could not read symbolic link "%s" could not reconnect to database: %s could not set default_tablespace to %s: %s could not set default_with_oids: %s could not set search_path to "%s": %s could not set seek position in archive file: %s
could not set session user to "%s": %s could not start database transaction could not uncompress data: %s
could not write to blobs TOC file
could not write to large object (result: %lu, expected: %lu)
could not write to the communication channel: %s
creating %s "%s"
creating %s "%s.%s"
custom archiver definition of view "%s" appears to be empty (length zero)
did not find magic string in file header
direct database connections are not supported in pre-1.3 archives
directory "%s" does not appear to be a valid archive ("toc.dat" does not exist)
directory archiver directory name too long: "%s"
disabling triggers for %s
dropping %s %s
dumping contents of table "%s.%s"
enabling triggers for %s
entering main parallel loop
entering restore_toc_entries_parallel
entering restore_toc_entries_postfork
entering restore_toc_entries_prefork
entry ID %d out of range -- perhaps a corrupt TOC
error during backup
error during file seek: %s
error processing a parallel work item
error reading large object %u: %s error reading large object TOC file "%s"
error returned by PQputCopyData: %s error returned by PQputCopyEnd: %s executing %s %s
expected %d check constraint on table "%s" but found %d
expected %d check constraints on table "%s" but found %d
expected format (%d) differs from format found in file (%d)
failed sanity check, parent OID %u of table "%s" (OID %u) not found
failed sanity check, parent table OID %u of pg_rewrite entry OID %u not found
failed to connect to database
failed to reconnect to database
file name too long: "%s"
file offset in dump file is too large
finding check constraints for table "%s.%s"
finding default expressions of table "%s.%s"
finding extension tables
finding inheritance relationships
finding the columns and types of table "%s.%s"
finished item %d %s %s
finished main parallel loop
flagging inherited columns in subtables
found unexpected block ID (%d) when reading data -- expected %d
function "%s" not found
identifying extension members
implied data-only restore
incomplete tar header found (%lu byte)
incomplete tar header found (%lu bytes)
index "%s" not found
input file appears to be a text format dump. Please use psql.
input file does not appear to be a valid archive
input file does not appear to be a valid archive (too short?)
input file is too short (read %lu, expected 5)
internal error -- WriteData cannot be called outside the context of a DataDumper routine
internal error -- neither th nor fh specified in tarReadRaw()
invalid ENCODING item: %s
invalid OID for large object
invalid OID for large object (%u)
invalid STDSTRINGS item: %s
invalid adnum value %d for table "%s"
invalid argument string (%s) for trigger "%s" on table "%s"
invalid binary "%s" invalid client encoding "%s" specified
invalid column number %d for table "%s"
invalid column numbering in table "%s"
invalid compression code: %d
invalid dependency %d
invalid dumpId %d
invalid line in large object TOC file "%s": "%s"
invalid message received from worker: "%s"
invalid output format "%s" specified
large-object output not supported in chosen format
last built-in OID is %u
launching item %d %s %s
missing index for constraint "%s"
moving from position %s to next member at file position %s
no item ready
no matching schemas were found
no matching tables were found
no matching tables were found for pattern "%s"
no output directory specified
not built with zlib support
now at file position %s
option --if-exists requires option -c/--clean
options --inserts/--column-inserts and -o/--oids cannot be used together
options -c/--clean and -a/--data-only cannot be used together
options -s/--schema-only and -a/--data-only cannot be used together
out of memory
out of on_exit_nicely slots
parallel archiver parallel backup only supported by the directory format
parallel restore from non-seekable file is not supported
parallel restore from standard input is not supported
parallel restore is not supported with archives made by pre-8.0 pg_dump
parallel restore is not supported with this archive file format
pclose failed: %s pgpipe: could not accept connection: error code %d
pgpipe: could not bind: error code %d
pgpipe: could not connect socket: error code %d
pgpipe: could not create second socket: error code %d
pgpipe: could not create socket: error code %d
pgpipe: could not listen: error code %d
pgpipe: getsockname() failed: error code %d
processing %s
processing data for table "%s.%s"
processing item %d %s %s
processing missed item %d %s %s
query failed: %s query produced null referenced table name for foreign key trigger "%s" on table "%s" (OID of table: %u)
query returned %d row instead of one: %s
query returned %d rows instead of one: %s
query to get data of sequence "%s" returned %d row (expected 1)
query to get data of sequence "%s" returned %d rows (expected 1)
query to get data of sequence "%s" returned name "%s"
query to get rule "%s" for table "%s" failed: wrong number of rows returned
query to obtain definition of view "%s" returned more than one definition
query to obtain definition of view "%s" returned no data
query was: %s
read TOC entry %d (ID %d) for %s %s
reading column info for interesting tables
reading constraints
reading default privileges
reading dependency data
reading event triggers
reading extensions
reading foreign key constraints for table "%s.%s"
reading indexes
reading indexes for table "%s.%s"
reading large objects
reading policies
reading policies for table "%s.%s"
reading procedural languages
reading rewrite rules
reading row security enabled for table "%s.%s"
reading schemas
reading table inheritance information
reading transforms
reading triggers
reading triggers for table "%s.%s"
reading type casts
reading user-defined access methods
reading user-defined aggregate functions
reading user-defined collations
reading user-defined conversions
reading user-defined foreign servers
reading user-defined foreign-data wrappers
reading user-defined functions
reading user-defined operator classes
reading user-defined operator families
reading user-defined operators
reading user-defined tables
reading user-defined text search configurations
reading user-defined text search dictionaries
reading user-defined text search parsers
reading user-defined text search templates
reading user-defined types
reducing dependencies for %d
restored %d large object
restored %d large objects
restoring data out of order is not supported in this archive format: "%s" is required, but comes before "%s" in the archive file.
restoring large object with OID %u
sanity check on integer size (%lu) failed
saving database definition
saving encoding = %s
saving large objects
saving standard_conforming_strings = %s
schema "%s" not found
schema with OID %u does not exist
select() failed: %s
server version must be at least 7.3 to use schema selection switches
server version: %s; %s version: %s
setting owner and privileges for %s "%s"
setting owner and privileges for %s "%s.%s"
skipping item %d %s %s
skipping tar member %s
sorter table "%s" could not be created, will not restore its data
table "%s" not found
tar archiver this format cannot be read
transferring dependency %d -> %d to %d
trigger "%s" not found
unexpected COPY statement syntax: "%s"
unexpected data offset flag %d
unexpected policy command type: "%s"
unexpected section code %d
unexpected tgtype value: %d
unrecognized archive format "%s"; please specify "c", "d", or "t"
unrecognized command received from master: "%s"
unrecognized constraint type: %c
unrecognized data block type %d while restoring archive
unrecognized data block type (%d) while searching archive
unrecognized encoding "%s"
unrecognized file format "%d"
unrecognized object type in default privileges: %d
unrecognized proparallel value for function "%s"
unrecognized provolatile value for function "%s"
unsupported version (%d.%d) in file header
warning from original dump file: %s
worker process failed: exit code %d
wrote %lu byte of large object data (result = %lu)
wrote %lu bytes of large object data (result = %lu)
Project-Id-Version: pg_dump (PostgreSQL 9.5)
Report-Msgid-Bugs-To: pgsql-bugs@postgresql.org
POT-Creation-Date: 2016-07-03 03:14+0000
PO-Revision-Date: 2016-07-03 17:53+0200
Last-Translator: grzegorz <begina.felicysym@wp.eu>
Language-Team: begina.felicysym@wp.eu
Language: pl
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Plural-Forms: nplurals=3; plural=(n==1 ? 0 : n%10>=2 && n%10<=4 && (n%100<10 || n%100>=20) ? 1 : 2);
X-Generator: Virtaal 0.7.1
Opcje połączenia:
Opcje ogólne:
Jeśli nie użyto -f/--file, skrypt SQL zostanie zapisany do standardowego
wyjścia.
Jeśli nie dostarczono nazwy bazy danych, używana jest zmienna
środowiskowa PGDATABASE.
Jeśli nie wskazano nazwy pliku, użyty zostanie wejście standardowe.
Opcje kontrolujące zawartość wyjścia:
Opcje kontroli odtworzenia:
Opcje -I, -n, -P, -t, -T i --section mogą być mieszane i używane wielokrotnie
by wskazać wiele obiektów.
%s
%s [OPCJA]...
%s [OPCJA]... [NAZWADB]
%s [OPCJA]... [PLIK]
--binary-upgrade używane tylko przez narzędzia aktualizacji
--column-inserts zrzuca dane jako polecenia INSERT z nazwami kolumn
--disable-dollar-quoting blokuje cytowanie dolarem, używa standardowego cytowania SQL
--disable-triggers wyłącza wyzwalacze podczas odtwarzania wyłącznie danych
--enable-row-security włącza zabezpieczenie na poziomie wierszy
--enable-row-security włącz bezpieczeństwo wierszy (zrzucaj tylko to
do czego użytkownik ma dostęp)
---exclude-table-data=TABELA NIE zrzuca danych tabeli o tej nazwie
--if-exists używa IF EXISTS podczas kasowania obiektów
--inserts zrzuca dane jako polecenia INSERT zamiast COPY
--lock-wait-timeout=LIMITCZASU
niepowodzenie blokowania tabeli po LIMITCZASU
--no-data-for-failed-tables
nie odtwarza danych z tabel, które nie mogły być odtworzone
--no-security-labels nie zrzuca przypisań etykiet bezpieczeństwa
--no-security-labels nie odtwarza etykiet bezpieczeństwa
--no-synchronized-snapshots nie używaj migawek synchronizowanych w zadaniach współbieżnych
--no-tablespaces nie zrzuca przypisań do przestrzeni tabel
--no-tablespaces nie odtwarza przypisań do przestrzeni tabel
--no-unlogged-table-data nie zrzuca niezalogowanych danych tabeli
--quote-all-identifiers cytuje wszystkie identyfikatory, jeśli tylko
nie są to słowa kluczowe
--role=NAZWAROLI wykonuje SET ROLE przed odtworzeniem
--role=NAZWAROLI wykonuje SET ROLE przed odtworzeniem
--section=SECTION zrzuca nazwaną sekcję (pre-dane, dane, lub post-dane)
--section=SECTION odtwarza nazwaną sekcję (pre-dane, dane, lub post-dane)
--serializable-deferrable czeka póki zrzut wykonuje się
bez nieprawidłowości
--snapshot=MIGAWKA używa wskazanej migawki do zrzutu
--strict-names wymaga by wzorce zawierania tabeli i/lub schematu
pasowały każda do co najmniej jednej encji
--use-set-session-authorization
używa poleceń SET SESSION AUTHORIZATION zamiast
poleceń ALTER OWNER by ustawić właściciela
-1, --single-transaction odtworzenie jako pojedyncza transakcja
-?, --help pokaż tą pomoc i zakończ działanie
-?, --help pokaż tą pomoc i zakończ działanie
-C, --create utworzenie docelowej bazy danych
-C, --create dodaje polecenia tworzenia bazy danych w zrzucie
-E, --encoding=KODOWANIE zrzuca dane w kodowaniu KODOWANIE
-F, --format=c|d|t format pliku kopii zapasowej (powinien być automatyczny)
-F, --format=c|d|t|p format pliku wyjścia (c-użytkownika, d-folder,
t-tar, p-tekstowy (domyślny))
-I, --index=NAZWA odtwarza indeks wedle nazwy
-L, --use-list=NAZWAPLIKU użycie spisu treści z tego pliku by
wskazać/uporządkować wyjście
-N, --exclude-schema=SCHEMAT
NIE zrzuca nazwanych schematów
-O, --no-owner bez odtwarzania posiadania obiektu
-O, --no-owner pomija odtworzenie wskazania właściciela obiektu
w formacie tekstowym
-P, --function=NAZWA(args) odtwarza funkcję wedle nazwy
-S, --superuser=NAZWA nazwa superużytkownika by użyć lub wyłączyć wyzwalacze
-S, --superuser=NAZWA nazwa superużytkownika używana w formacie tekstowym
-S, --superuser=NAZWA nazwa superużytkownika używana w zrzucie
-T, --exclude-table=TABELA NIE zrzuca tabeli o tej nazwie
-T, --trigger=NAZWA odtwarza wyzwalacz wedle nazwy
-U, --username=NAZWA połączenie jako wskazany użytkownik bazy
-V, --version pokaż informacje o wersji i zakończ
-V, --version pokaż informacje o wersji i zakończ
-W, --password wymuś pytanie o hasło (powinno nastąpić automatycznie)
-Z, --compress=0-9 poziom kompresji dla formatów kompresujących
-a, --data-only zrzuca tylko dane, bez schematu
-a, --data-only odtwarza tylko dane, bez schematu
-b, --blobs dodaje duże obiekty do zrzutu
-c, --clean czyszczenie (kasowanie) obiektów baz danych przed odtworzeniem
-c, --clean czyszczenie (kasowanie) baz danych przed odtworzeniem
-d, --dbname=POLACZENIE połączenie do bazy danych wedle ciągu połączenia
-d, --dbname=NAZWADB baza danych do utworzenia kopii
-d, --dbname=NAZWA połączenie do bazy danych o tej nazwie
-e, --exit-on-error wyjście w przypadku błędu, domyślna jest kontynuacja
-f, --file=NAZWAPLIKU nazwa pliku wyjścia
-f, --file=NAZWAPLIKU nazwa pliku lub folderu wyjścia
-f, --file=NAZWAPLIKU nazwa pliku wyjścia
-g, --globals-only zrzuca tylko obiekty globalne, bez baz danych
-h, --host=NAZWAHOSTA host serwera bazy danych lub katalog gniazda
-j, --jobs=NUM użycie tylu równoległych zadań przy zrzucie
-j, --jobs=NUM użycie tylu równoległych zadań przy odtwarzaniu
-l, --database=NAZWADB alternatywna domyślna baza danych
-l, --list drukuje skrótowy spis treści archiwum
-n, --schema=NAZWA odtwarza tylko obiekty z tego schematu
-n, --schema=SCHEMAT zrzuca tylko nazwany schemat(y)
-o, --oids dodaje OIDy do zrzutu
-p, --port=PORT numer portu na serwera bazy dnaych
-r, --roles-only zrzuca tylko role bez baz danych i przestrzeni tabel
-s, --schema-only zrzuca tylko schemat, bez danych
-s, --schema-only odtwarza tylko schemat, bez danych
-t, --table=NAZWA odtwarza relacje wedle nazwy (tabela, widok, itp.)
-t, --table=TABELA zrzuca tylko tabelę wedle nazwy
-t, --tablespaces-only zrzuca tylko przestrzenie tabel, bez baz danych i ról
-v, --verbose tryb informacji szczegółowych
-v, --verbose tryb informacji szczegółowych
-w, --no-password nie pytaj nigdy o hasło
-x, --no-privileges nie zrzuca przywilejów (grant/revoke)
-x, --no-privileges nie wykonuje odtwarzania przywilejów dostępu (grant/revoke)
%s %s zrzuca bazę danych jako plik tekstowy lub do innych formatów.
%s wyciąga klaster bazy danych PostgreSQL do pliku skryptowego SQL.
%s odtwarza bazę danych PostgreSQL z archiwum utworzonego przez pg_dump.
%s: %s Polecenie brzmiało: %s
%s: nie powiodło się WSAStartup: %d
%s: nie można wskazać jednocześnie --single-transaction i wielu zadań
%s: nie można połączyć się do bazy danych "%s"
%s: nie można połączyć się do bazy danych "%s": %s
%s: n ie udało się połączyć do bazy danych "postgres" ani "template1"
Proszę wskazać alternatywną bazę danych.
%s: nie można pobrać wersji serwera
%s: nie można otworzyć pliku wyjścia "%s": %s
%s: nie udało się przeanalizować listy AC (%s) dla bazy danych "%s"
%s: nie udało się przeanalizować listy AC (%s) dla przestrzeni tabel "%s"
%s: nie można odczytać wersji serwera "%s"
%s: nie można ponownie otworzyć pliku "%s": %s
%s: tworzenie kopii zapasowej bazy danych "%s"...
%s: wykonanie %s
%s: nieprawidłowa liczba zadań współbieżnych
%s: maksymalna liczba zadań współbieżnych to %d
%s: opcja --if-exists wymaga opcji -c/--clean
%s: opcje -c/--clean i -a/--data-only nie mogą być używane razem
%s: opcje -d/--dbname i -f/--file nie mogą być użyte razem
%s: opcje -g/--globals-only i -r/--roles-only nie mogą być używane razem
%s: opcje -g/--globals-only i -t/--tablespaces-only nie mogą być używane razem
%s: opcje -r/--roles-only i -t/--tablespaces-only nie mogą być używane razem
%s: opcje -s/--schema-only i -a/--data-only nie mogą być używane razem
%s: pg_dump nie powiódł się na bazie danych "%s", wyjście
%s: zapytanie nie powiodło się: %s %s: zapytanie brzmiało: %s
%s: pominięto nazwę roli zaczynającą się od "pg_" (%s)
%s: uruchomiony "%s"
%s: za duża ilość parametrów (pierwszy to "%s")
%s: nierozpoznana nazwa sekcji: "%s"
(Polecenie INSERT nie może ustawiać OIDów.)
(Foldery systemowe mogą być uszkodzone.)
-C i -1 są opcjami niekompatybilnymi
nie udało się COPY dla tabeli "%s": %s Rozważ wykonanie pełnego zrzutu zamiast kopii --data-only by uniknąć tegoproblemu.
Nie powiódł się zrzut zawartości tabeli "%s": niepowodzenie PQgetCopyData().
Nie powiódł się zrzut zawartości tabeli "%s": niepowodzenie PQgetResult().
Błąd z wpisu %d TOC; %u %u %s %s %s
Komunikat błędu z serwera: %s Błąd podczas ZAKAŃCZANIA:
Błąd podczas INICJACJI:
Błąd podczas PRZETWARZANIA TOC:
Eksportowane migawki nie są obsługiwane przez tą wersję serwera.
UWAGA: występuje pętla kluczy obcych w tabeli:
UWAGA: występuje pętla kluczy obcych pomiędzy tabelami:
UWAGA: występuje pętla kluczy obcych pomiędzy tabelami:
Hasło: Błędy proszę przesyłać na adres <pgsql-bugs@postgresql.org>.
Synchronizowane migawki nie są obsługiwane przez tą wersję serwera.
Można uruchomić z --no-synchronized-snapshots jeśli nie są potrzebne
migawki synchronizowane.
Synchronizowane migawki nie są obsługiwane na serwerach w trybie gotowości.
Można uruchomić z --no-synchronized-snapshots jeśli nie są potrzebne
migawki synchronizowane.
Wpis TOC %s na %s (długość %s, suma kontrolna %d)
Treść polecenia: %s
Program "pg_dump" jest wymagany przez %s ale nie został znaleziony
w tym samym folderze co "%s".
Sprawdź instalację.
Program "pg_dump" został znaleziony przez "%s"
ale nie jest w tej samej wersji co %s.
Sprawdź instalację.
Spróbuj "%s --help" aby uzyskać więcej informacji.
Składnia:
OSTRZEŻENIE: funkcja agregująca %s nie może być poprawnie zrzucona dla tej wersji bazy danych; zignorowano
OSTRZEŻENIE: archiwum jest spakowane, ale ta instalacja nie obsługuje kompresji -- dane nie będą dostępne
OSTRZEŻENIE: elementy archiwów w niepoprawnym porządku sekcji
OSTRZEŻENIE: archiwum zostało utworzone na komputerze o dłuższych liczbach całkowitych, niektóre operacje mogą się nie udać
OSTRZEŻENIE: błędna definicja transformacji, co najmniej jedna z trffromsql i trftosql powinna być niezerowa
OSTRZEŻENIE: błędna wartość w pg_cast.castfunc lub nie udało się wykonać pg_cast.castmethod
OSTRZEŻENIE: błędna wartość pola pg_cast.castmethod
OSTRZEŻENIE: błędna wartość pola pg_transform.trffromsql
OSTRZEŻENIE: błędna wartość pola pg_transform.trftosql
OSTRZEŻENIE: błędna wartość w tablicy proargmodes
OSTRZEŻENIE: nie udało się odnaleźć operatora o OID %s
OSTRZEŻENIE: nie można przeanalizować tablicy proallargtypes
OSTRZEŻENIE: nie można przeanalizować tablicy proargmodes
OSTRZEŻENIE: nie można przeanalizować tablicy proargnames
OSTRZEŻENIE: nie można przeanalizować tablicy proconfig
OSTRZEŻENIE: nie można przeanalizować tablicy reloptions
OSTRZEŻENIE: nie można rozwiązać pętli powiązań pomiędzy elementami:
OSTRZEŻENIE: nie wiadomo jak ustalić właściciela dla typu obiektu %s
OSTRZEŻENIE: błędy ignorowane przy odtworzeniu: %d
OSTRZEŻENIE: niezgodność ftell z oczekiwaną pozycją -- użyto ftel
OSTRZEŻENIE: niepoprawna data utworzenia w nagłówku
OSTRZEŻENIE: niepoprawny typ "%c" metody dostępu "%s"
OSTRZEŻENIE: zignorowano linię: %s
OSTRZEŻENIE: właściciel funkcji agregującej "%s" wydaje się być niepoprawny
OSTRZEŻENIE: właściciel typu danych "%s" wydaje się być niepoprawny
OSTRZEŻENIE: właściciel funkcji "%s" wydaje się być niepoprawny
OSTRZEŻENIE: właściciel operatora "%s" wydaje się być niepoprawny
OSTRZEŻENIE: właściciel klasy operatora "%s" wydaje się być niepoprawny
OSTRZEŻENIE: właściciel rodziny operatora "%s" wydaje się być niepoprawny
OSTRZEŻENIE: właściciel schematu "%s" wydaje się być niepoprawny
OSTRZEŻENIE: właściciel tabeli "%s" wydaje się być niepoprawny
OSTRZEŻENIE: żądana kompresja jest niedostępna w tej instalacji -- archiwum nie będzie spakowane
OSTRZEŻENIE: typtype typu danych "%s" wydaje się być niepoprawny
OSTRZEŻENIE: nieoczekiwane dodatkowe wyniki podczas COPY tabeli "%s"
Możesz nie być w stanie odtworzyć zrzutu bez użycia --disable-triggers lub tymczasowego usunięcia ograniczeń.
proces roboczy nie zakończył się nieoczekiwanie
przerwano z powodu niezgodności wersji serwera
faktyczna długość pliku (%s) nie zgadza z oczekiwaną (%s)
przydzielenie AH da %s, format %d
już połączono z bazą danych
archiwizator archiwizator (db) próba ustalenia formatu archiwum
niepoprawny dumpId
niepoprawna tabela dumpId dla elementu TABLE DATA
można tylko odtworzyć ponownie archiwa wejściowe
nie można powielić pustego wskazania (błąd wewnętrzny)
nie można odtworzyć ze spakowanego archiwum (kompresja nie jest obsługiwana w tej instalacji)
proces potomny zakończył działanie z kodem %d proces potomny zakończył działanie z nieznanym stanem %d proces potomny został zatrzymany przez wyjątek 0x%X proces potomny został zatrzymany przez sygnał %d proces potomny został zatrzymany przez sygnał %s polecenie nie wykonywalne polecenie nie znalezione kompresuj_io kompresja nie jest obsługiwana przez format archiwum tar
poziom kompresji musi być z zakresu 0..9
aktywny kompresor
łączenie z bazą danych "%s" jako użytkownik "%s"
łączenie z bazą danych w celu odtworzenia
łączenie do nowej bazy danych "%s"
połączenie wymaga hasła
połączenie z bazą danych "%s" nie powiodło się: %s znaleziono uszkodzony nagłówek tar w %s (oczekiwano %d, wyliczono %d) pozycja pliku %s
nie można zmienić katalogu na "%s": %s nie można zamknąć pliku TOC: %s
nie można zamknąć pliku archiwum: %s
nie udało się zamknąć biblioteki kompresji: %s
nie udało się zamknąć strumienia kompresji: %s
nie można zamknąć pliku danych: %s
nie można zamknąć katalogu "%s": %s
nie można zamknąć pliku wejścia: %s
nie można zamknąć pliku TOC dużych obiektów "%s": %s
nie można zamknąć pliku wyjścia: %s
nie można zamknąć składnika tar
nie można zamknąć pliku tymczasowego: %s
nie można zatwierdzić transakcji na bazie danych nie udało się spakować danych: %s
nie można utworzyć kanałów komunikacyjnych: %s
nie można utworzyć folderu "%s": %s
nie można utworzyć dużego obiektu %u: %s nie można utworzyć procesu roboczego: %s
nie można określić pozycji przesunięcia w pliku archiwum: %s
nie można wykonać zapytania nie znaleziono "%s" do wykonania nie można znaleźć bloku o ID %d w archiwum -- archiwum jest być może uszkodzone
nie można znaleźć bloku o ID %d w archiwum -- być może ze względu na żądanie nieuporządkowanego odtwarzania, które nie może być obsłużone przez brak offsetów danych w archiwum
nie można znaleźć bloku o ID %d w archiwum -- być może ze względu na uszkodzone żądanie odtwarzania, które nie może być obsłużone przez niepozycjonowany plik wejścia
nie znaleziono wpisu dla ID %d
nie można znaleźć pliku "%s" w archiwum
nie można znaleźć nagłówka dla pliku "%s" w archiwum tar
nie można odnaleźć rozszerzenia nadrzędnego dla %s
nie można znaleźć gniazda zakończonego procesu roboczego
nie można utworzyć nazwy pliku tymczasowego: %s
nie można pobrać server_version z libpq
nie można zidentyfikować aktualnego katalogu: %s nie można zidentyfikować pętli powiązań
nie udało się zainicjować biblioteki kompresji: %s
nie udało się uzyskać blokady na relacji "%s"
Oznacza to zazwyczaj że ktoś zażądał blokady ACCESS EXCLUSIVE na tabeli gdy wcześniej proces nadrzędny pg_dump uzyskał początkową blokadę ACCESS SHARE na tabeli.
nie można otworzyć pliku TOC "%s" do odczytu: %s
nie można otworzyć pliku TOC "%s" do zapisu: %s
nie można otworzyć pliku TOC "%s": %s
nie można otworzyć pliku TOC do odczytu: %s
nie można otworzyć pliku TOC do zapisu: %s
nie można otworzyć pliku wejścia "%s": %s
nie można otworzyć pliku wyjścia %s
nie można otworzyć dużego obiektu %u: %s nie można otworzyć pliku TOC dużych obiektów "%s" do odczytu: %s
nie można otworzyć pliku wyjścia "%s": %s
nie można otworzyć pliku wyjścia %s
nie można otworzyć pliku tymczasowego
nie udało się przetworzyć listy GRANT ACL (%s) albo listy REVOKE ACL (%s) dla obiektu "%s" (%s)
nie można przetworzyć domyślnej listy ACL (%s)
nie udało się przetworzyć początkowej listy GRANT ACL (%s) albo początkowej listy REVOKE ACL (%s) dla obiektu "%s" (%s)
nie można przetworzyć tablicy numerycznej "%s": niepoprawny znak w liczbie
nie można przetworzyć tablicy numerycznej "%s": zbyt wiele liczb
nie można odczytać binarnego "%s" nie można czytać katalogu "%s": %s
nie można czytać z pliku wejścia: %s
nie można czytać pliku wejścia: koniec pliku
nie można odczytać pliku wejścia %s
nie można odczytać odwołania symbolicznego "%s" nie można połączyć się ponownie z bazą danych: %s nie można ustawić default_tablespace na %s: %s nie można ustawić default_with_oids: %s nie można ustawić search_path na "%s": %s nie można ustawić pozycji przeszukiwania w pliku archiwum: %s
nie można ustalić użytkownika sesji na "%s": %s nie można uruchomić transakcji na bazie danych nie udało się rozpakować danych: %s
nie można zapisać do pliku TOC blobów
nie udało się zapisać dużego obiektu (wynik: %lu, oczekiwano: %lu)
nie można zapisać do kanału komunikacyjnego: %s
tworzenie %s "%s"
tworzenie %s "%s.%s"
archiwizer użytkownika definicja widoku "%s" wydaje się pusta (długość zero)
nie znaleziono magicznego zdania w nagłówku pliku
bezpośrednie połączenia bazy danych nie są obsługiwane w archiwach sprzed 1.3
folder "%s" nie wydaje się być poprawnym archiwum ("toc.dat" nie istnieje)
archiwizator folderów zbyt długa nazwa pliku: "%s"
wyłączanie wyzwalaczy dla %s
kasowanie %s %s
zrzut zawartości tabeli "%s.%s"
włączanie wyzwalaczy dla: %s
wejście w główną pętlę współbieżności
wprowadzanie restore_toc_entries_parallel
wejście do restore_toc_entries_postfork
wejście do restore_toc_entries_prefork
wpis ID %d poza zasięgiem -- być może uszkodzony TOC
błąd podczas tworzenia kopii zapasowej
błąd podczas przeglądania pliku: %s
błąd przetwarzania równoległego elementu roboczego
błąd odczytu dużego obiektu %u: %s błąd odczytu pliku TOC dużych obiektów "%s"
błąd zwrócony przez PQputCopyData: %s błąd zwrócony przez PQputCopyEnd: %s wykonywanie %s %s
oczekiwano %d-go ograniczenia sprawdzające na tabeli "%s" ale znaleziono %d
oczekiwano %d-ch ograniczeń sprawdzających na tabeli "%s" ale znaleziono %d
oczekiwano %d ograniczeń sprawdzających na tabeli "%s" ale znaleziono %d
oczekiwany format (%d) różni się od formatu znalezionego w pliku (%d)
sprawdzenia nie powiodły się, nie odnaleziono nadrzędnego OID %u dla tabeli "%s" (OID %u)
sprawdzenia nie powiodły się, nie odnaleziono tabeli nadrzędnej o OID %u dla wpisu pg_rewrite o OID %u
nie udało się połączyć z bazą danych
nie udało się połączyć ponownie z bazą danych
zbyt długa nazwa pliku: "%s"
przesunięcie pliku w pliku zrzutu jest zbyt duże
odczyt ograniczeń sprawdzających dla tabeli "%s.%s"
wyszukiwanie wyrażeń domyślnych dla tabeli "%s.%s"
odnajdywanie tabel rozszerzeń
odnajdywanie relacji dziedziczenia
wyszukiwanie kolumn i typów dla tabeli "%s.%s"
ukończono element %d %s %s
kończenie głównej pętli współbieżności
oznaczanie dziedziczonych kolumn w podtabelach
podczas odczytu danych znaleziono nieoczekiwany blok o ID (%d) -- oczekiwano %d
nie znaleziono funkcji "%s"
identyfikowanie składników rozszerzeń
domniemane przywrócenie wyłącznie danych
znaleziono niepełny nagłówek tar (%lu bajt)
znaleziono niepełny nagłówek tar (%lu bajty)
znaleziono niepełny nagłówek tar (%lu bajtów)
nie znaleziono indeksu "%s"
plik wejścia wydaje się zrzutem w formacie tekstowym. Należy użyć psql.
plik wejścia nie wydaje się być poprawnym archiwum
plik wejścia nie wydaje się być poprawnym archiwum (zbyt krótki?)
plik wejścia jest zbyt krótki (odczytano %lu, oczekiwano 5)
błąd wewnętrzny -- WriteData nie może być wywołana poza kontekstem procedury DataDumper
błąd wewnętrzny -- nie wskazano ani th ani fh w tarReadRaw()
niepoprawny element ENCODING: %s
niepoprawny OID dla dużego obiektu
niepoprawny OID dla dużego obiektu (%u)
niepoprawny element STDSTRINGS: %s
niepoprawna wartość adnum %d dla tabeli "%s"
niepoprawny ciąg argumentu (%s) dla wyzwalacza "%s" tabeli "%s"
niepoprawny binarny "%s" wskazano niepoprawne kodowanie klienta "%s"
niepoprawny numer kolumny %d dla tabeli "%s"
niepoprawna numeracja kolumn dla tabeli "%s"
niepoprawny kod kompresji: %d
niepoprawne powiązanie %d
niepoprawny dumpId %d
niepoprawna linia w pliku TOC dużych obiektów "%s": "%s"
niepoprawny komunikat otrzymany od pracownika: "%s"
wskazano niepoprawny format wyjścia "%s"
wyjście dużych obiektów nie jest obsługiwane w wybranym formacie
ostatni wbudowany OID to %u
uruchomienie elementu %d %s %s
brak indeksu dla ograniczenia "%s"
przeniesienie z pozycji %s do następnego składnika na pozycji pliku %s
brak gotowego elementu
nie znaleziono pasujących schematów
nie znaleziono pasujących tabel
nie znaleziono tabel pasujących do wzorca "%s"
nie wskazano folderu wyjściowego
nie wbudowano obsługi zlib
obecnie na pozycji pliku %s
opcja --if-exists wymaga opcji -c/--clean
opcje --inserts/--column-inserts i -o/--oids nie mogą być używane razem
opcje -c/--clean i -a/--data-only nie mogą być używane razem
opcje -s/--schema-only i -a/--data-only nie mogą być używane razem
brak pamięci
zabrakło gniazd on_exit_nicely
archiwizator równoległy współbieżne tworzenie kopii zapasowej nie jest obsługiwane w tym formacie archiwum
współbieżne odtwarzanie z nieprzeszukiwalnego pliku nie jest obsługiwane
współbieżne odtwarzanie ze standardowego wejścia nie jest obsługiwane
odtwarzanie współbieżne nie jest obsługiwane w archiwach utworzonych przez pg_dump sprzed 8.0
odtwarzanie współbieżne nie jest obsługiwane w tym formacie archiwum
pclose nie powiodło się: %s pgpipe: nie można przyjąć połączenia: kod błądu %d
pgpipe: nie udało się dowiązać: kod błędu %d
pgpipe: nie można połączyć się do gniazda: kod błędu %d
pgpipe: nie można utworzyć drugiego gniazda: kod błędu %d
pgpipe: nie można utworzyć gniazda: kod błędu %d
pgpipe: nie dało się nasłuchiwać: kod błędu %d
pgpipe: getsockname() nie powiodła: kod błędu %d
przetwarzanie %s
przetwarzanie danych tabeli "%s.%s"
przetwarzanie elementu %d %s %s
przetwarzanie brakującego elementu %d %s %s
zapytanie nie powiodło się: %s zapytanie dało w wyniku puste wskazanie nazwy tabeli dla wyzwalacza klucza obcego "%s" dla tabeli "%s" (UID tabeli: %u)
zapytanie zwróciło %d wiersz zamiast: %s
zapytanie zwróciło %d wiersze zamiast: %s
zapytanie zwróciło %d wierszy zamiast: %s
zapytanie o dane sekwencji "%s" zwróciło %d wiersz (oczekiwano 1)
zapytanie o dane sekwencji "%s" zwróciło %d wiersze (oczekiwano 1)
zapytanie o dane sekwencji "%s" zwróciło %d wierszy (oczekiwano 1)
pytanie o dane sekwencji "%s" zwróciło nazwę "%s"
zapytanie o regułę "%s" dla tabeli "%s" nie powiodło się: zwróciło złą liczbę wierszy
zapytanie o definicję widoku "%s" nie zwróciło więcej niż jedna definicję
zapytanie o definicję widoku "%s" nie zwróciło danych
zapytanie brzmiało: %s
odczyt wpisu TOC %d (ID %d) dla %s %s
odczyt notatek kolumn dla ciekawych tabel
odczyt ograniczeń
odczyt uprawnień domyślnych
odczyt informacji o zależnościach
odczyt wyzwalaczy zdarzeń
odczyt rozszerzeń
odczyt ograniczeń kluczy obcych dla tabeli "%s.%s"
odczyt indeksów
odczyt indeksów dla tabeli "%s.%s"
odczyt dużych obiektów
odczyt polityk
odczyt polityk dla tabeli "%s.%s"
odczyt języków proceduralnych
odczyt reguł przepisywania
odczyt włączonych zabezpieczeń wiersza dla tabeli "%s.%s"
odczyt schematów
odczyt informacji o dziedziczeniu tabel
odczyt transformacji
odczyt wyzwalaczy
odczyt wyzwalaczy dla tabeli "%s.%s"
odczyt rzutowań typów
odczyt metod dostępu użytkownika
odczyt funkcji agregujących użytkownika
odczyt porównań użytkownika
odczyt konwersji użytkownika
odczyt serwerów obcych użytkownika
odczyt opakowań obcych danych użytkownika
odczyt funkcji użytkownika
odczyt klas operatorów użytkownika
odczyt rodzin operatorów użytkownika
odczyt operatorów użytkownika
odczyt tabel użytkownika
odczyt konfiguracji wyszukiwania tekstowego użytkownika
odczyt słowników wyszukiwania tekstowego użytkownika
odczyt analizatorów wyszukiwania tekstowego użytkownika
odczyt szablonów wyszukiwania tekstowego użytkownika
odczyt typów użytkownika
redukcja zależności dla %d
odtworzono %d duży obiekt
odtworzono %d duże obiekty
odtworzono %d dużych obiektów
przywrócenie danych w niepoprawnej kolejności nie jest obsługiwane w tym formacie archiwum: wymagane jest "%s", ale występuje przed "%s" w pliku archiwum.
odtwarzanie dużego obiektu z OID %u
nie powiodło się sprawdzenie na rozmiarze liczby całkowitej (%lu)
zapis definicji bazy danych
zapis kodowania = %s
zapis dużych obiektów
zapis standard_conforming_strings = %s
nie znaleziono schematu "%s"
schemat z OID %u nie istnieje
select() nie udało się: %s
serwer musi być w wersji co najmniej 7.3 by użyć przełączników wyboru schematu
wersja serwera: %s; %s w wersji: %s
ustawienie właściciela i uprawnień dla %s "%s"
ustawienie właściciela i uprawnień dla %s "%s.%s"
pominięcie elementu %d %s %s
pominięcie składnika tar %s
sortujący tabela "%s" nie mogła zostać utworzona, jej dane nie zostaną odtworzone
nie znaleziono tabeli "%s"
archiwizator tar ten format nie mógł zostać odczytany
przenoszenie zależności %d -> %d do %d
nie znaleziono wyzwalacza "%s"
nieoczekiwana składnia deklaracji COPY: "%s"
nieoczekiwana dana flagi przesunięcia %d
nieoczekiwany typ polecenia polityki "%s"
nieoczekiwany kod sekcji %d
nieoczekiwana wartość tgtype: %d
nierozpoznany format archiwum "%s"; proszę wskazać "c", "d", lub "t"
nierozpoznane polecenie otrzymane od podstawowego: "%s"
nierozpoznany typ ograniczenia: %c
nierozpoznany typ bloku danych %d podczas odtwarzania archiwum
nierozpoznany typ bloku danych (%d) podczas przeszukiwania archiwum
niezrozumiały kodowanie "%s"
nierozpoznany format pliku "%d"
nieznany typ obiektu w uprawnieniach domyślnych: %d
nierozpoznana wartość proparallel dla funkcji "%s"
nierozpoznana wartość provolatile dla funkcji "%s"
nieobsługiwana wersja (%d.%d) w nagłówku pliku
ostrzeżenie z oryginalnego pliku zrzutu: %s
proces roboczy nie powiódł się: kod wyjścia %d
zapisano %lu bajt danych dużego obiektu (wynik = %lu)
zapisano %lu bajty danych dużego obiektu (wynik = %lu)
zapisano %lu bajtów danych dużego obiektu (wynik = %lu)
locale/nb/LC_MESSAGES/pg_config-9.6.mo 0000644 00000013263 14751153421 0013001 0 ustar 00 �� * l ; � � E � 0 � : 6 E q I � L s N K � = 2 L i G � J 1 M | ? � G
> R 6 � < � > F D P � I � 4 &
" [
~
�
, �
& �
�
& �
0 % ) V " � � ( � � ! *
> Q L A �
6 �
; + M g Q � T z \ S � B + 9 n Z � O R S U � > � O ; D � : � K H W C � R � M 7 1 � & � � � 0 � & 0 W " ^ + � ( � " � � - F ) e �
� " %
! (
# $ * ) & '
%s provides information about the installed version of PostgreSQL.
With no arguments, all known items are shown.
%s [ OPTION ... ]
--bindir show location of user executables
--cc show CC value used when PostgreSQL was built
--cflags show CFLAGS value used when PostgreSQL was built
--cflags_sl show CFLAGS_SL value used when PostgreSQL was built
--configure show options given to "configure" script when
PostgreSQL was built
--cppflags show CPPFLAGS value used when PostgreSQL was built
--docdir show location of documentation files
--help show this help, then exit
--includedir show location of C header files of the client
interfaces
--includedir-server show location of C header files for the server
--ldflags show LDFLAGS value used when PostgreSQL was built
--ldflags_sl show LDFLAGS_SL value used when PostgreSQL was built
--libdir show location of object code libraries
--libs show LIBS value used when PostgreSQL was built
--localedir show location of locale support files
--mandir show location of manual pages
--pgxs show location of extension makefile
--pkgincludedir show location of other C header files
--pkglibdir show location of dynamically loadable modules
--sharedir show location of architecture-independent support files
--sysconfdir show location of system-wide configuration files
--version show the PostgreSQL version
%s: could not find own executable
%s: invalid argument: %s
Options:
Report bugs to <pgsql-bugs@postgresql.org>.
Try "%s --help" for more information.
Usage:
child process exited with exit code %d child process exited with unrecognized status %d child process was terminated by signal %d could not change directory to "%s" could not find a "%s" to execute could not identify current directory: %s could not read binary "%s" could not read symbolic link "%s" invalid binary "%s" not recorded
Project-Id-Version: PostgreSQL 8.1
POT-Creation-Date:
PO-Revision-Date: 2013-09-05 22:56-0400
Last-Translator: Erik B. Ottesen <erikbagg@stud.ntnu.no>
Language-Team:
Language: nb
MIME-Version: 1.0
Content-Type: text/plain; charset=iso-8859-1
Content-Transfer-Encoding: 8bit
X-Poedit-Language: Norwegian Bokmal
X-Poedit-Country: NORWAY
%s gir informasjon om den installerte versjonen av PostgreSQL.
Uten noen argumenter er alle kjente elementer vist.
%s [ VALG ... ]
--bindir vis plasseringen til programfilene
--cc vis verdien til CC brukt under bygging av PostgreSQL
--cflags vis verdien til CFLAGS brukt under bygging av PostgreSQL
--cflags_sl vis verdien til CFLAGS_SL brukt under bygging av PostgreSQL
--configure vis alternativene gitt til �configure�-skriptet n�r
PostgreSQL ble bygget
--cppflags vis verdien til CPPFLAGS brukt under bygging av PostgreSQL
--docdir vis plasseringen til dokumentasjonsfilene
--help vis denne hjelpetekst og avslutt
--includedir vis plasseringen til C-deklarasjonsfilene for brukergrensesnittet
--includedir-server vis plasseringen til C-deklarasjonsfilene for tjeneren
--ldflags vis verdien til LDFLAGS brukt under bygging av PostgreSQL
--ldflags_sl vis verdien til LDFLAGS_SL brukt under bygging av PostgreSQL
--libdir vis plasseringen til kodebibliotekene
--libs vis verdien til LIBS brukt under bygging av PostgreSQL
--localedir vis plasseringen til de lokale hjelpefilene
--mandir vis plasseringen til manualfilene
--pgxs vis plasseringen til kompileringsfilen for tillegg
--pkgincludedir vis plasseringen til andre C-deklarasjonsfilene
--pkglibdir vis plasseringen til de dynamiske modulene
--sharedir vis plasseringen til de arkitekturuavhengige hjelpefilene
--sysconfdir vis plasseringen til de globale konfigurasjonsfilene
--version vis PostgreSQL-versjonen
%s: klarte ikke finne egen programfil
%s: ugyldig argument: %s
Valg:
Rapporter feil til <pgsql-bugs@postgresql.org>.
Pr�v �%s --help� for mer informasjon.
Bruk:
underprosess avsluttet med kode %d underprosess avsluttet med ukjent status %d underprosess ble avsluttet med signal %d klarte ikke endre katalog til �%s� fant ikke �%s� for eksekvering klarte ikke identifisere gjeldene katalog: %s klarte ikke lese bin�rfil �%s� klarte ikke lese den symbolsk lenken �%s� ugyldig bin�rfil �%s� ikke bokf�rt
locale/zh_TW/LC_MESSAGES/pg_config-9.6.mo 0000644 00000013631 14751153421 0013434 0 ustar 00 �� . � = � � E � 0 7 h : { E � I � L F s � K = S 2 � B � i G q J � M M R ? � G � > ( 6 g < � > � F
P a
I �
4 �
* 1 \ v , � & � � & � 0 . 4 ) c ) � " � � ( � $
! ?
a
u
� �
* 7 0 b � . � D � H K c u � J % . p 1 � 4 � @ : G I � L � L . f F � 4 � 1 ; C 7 : � @ � : 3 1 n � � � / � ) : ! I ' k � � � � > W u
� # - . ( ,
)
! % $ & ' + " *
%s provides information about the installed version of PostgreSQL.
With no arguments, all known items are shown.
%s [OPTION]...
--bindir show location of user executables
--cc show CC value used when PostgreSQL was built
--cflags show CFLAGS value used when PostgreSQL was built
--cflags_sl show CFLAGS_SL value used when PostgreSQL was built
--configure show options given to "configure" script when
PostgreSQL was built
--cppflags show CPPFLAGS value used when PostgreSQL was built
--docdir show location of documentation files
--help show this help, then exit
--htmldir show location of HTML documentation files
--includedir show location of C header files of the client
interfaces
--includedir-server show location of C header files for the server
--ldflags show LDFLAGS value used when PostgreSQL was built
--ldflags_ex show LDFLAGS_EX value used when PostgreSQL was built
--ldflags_sl show LDFLAGS_SL value used when PostgreSQL was built
--libdir show location of object code libraries
--libs show LIBS value used when PostgreSQL was built
--localedir show location of locale support files
--mandir show location of manual pages
--pgxs show location of extension makefile
--pkgincludedir show location of other C header files
--pkglibdir show location of dynamically loadable modules
--sharedir show location of architecture-independent support files
--sysconfdir show location of system-wide configuration files
--version show the PostgreSQL version
%s: could not find own program executable
%s: invalid argument: %s
Options:
Report bugs to <pgsql-bugs@postgresql.org>.
Try "%s --help" for more information.
Usage:
child process exited with exit code %d child process exited with unrecognized status %d child process was terminated by exception 0x%X child process was terminated by signal %d child process was terminated by signal %s could not change directory to "%s" could not find a "%s" to execute could not identify current directory: %s could not read binary "%s" could not read symbolic link "%s" invalid binary "%s" not recorded
Project-Id-Version: PostgreSQL 9.1
Report-Msgid-Bugs-To: pgsql-bugs@postgresql.org
POT-Creation-Date: 2011-05-11 20:40+0000
PO-Revision-Date: 2013-09-03 23:27-0400
Last-Translator: Zhenbang Wei <znbang@gmail.com>
Language-Team: EnterpriseDB translation team <dev-escalations@enterprisedb.com>
Language: zh_TW
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Plural-Forms: nplurals=1; plural=0;
%s 顯示已安裝 PostgreSQL 資訊。
沒有參數，已顯示所有已知項目。
%s [選項]...
--bindir 顯示執行檔位置
--cc 顯示建立 PostgreSQL 時使用的 CC 值
--cflags 顯示建立 PostgreSQL 時使用的 CFLAGS 值
--cflags_sl 顯示建立 PostgreSQL 時使用的 CFLAGS_SL 值
--configure 顯示建立 PostgreSQL 時 "configure" 命令搞
所使用的參數
--cppflags 顯示建立 PostgreSQL 時使用的 CPPFLAGS 值
--docdir 顯示文件檔位置
--help 顯示說明然後結束
--htmldir 顯示 HTML 文件檔位置
--includedir 顯使用戶端介面 C 標頭檔位置
--includedir-server 顯示伺服器 C 標頭檔位置
--ldflags 顯示建立 PostgreSQL 時使用的 LDFLAGS 值
--ldflags_ex 顯示建立 PostgreSQL 時使用的 LDFLAGS_EX 值
--ldflags_sl 顯示建立 PostgreSQL 時使用的 LDFLAGS_SL 值
--libdir 顯示程式庫位置
--libs 顯示建立 PostgreSQL 時使用的 LIBS 值
--localedir 顯示區域支援檔位置
--mandir 顯示使用說明位置
--pgxs 顯示外部程式 makefile 位置
--pkgincludedir 顯示其他 C 標頭檔位置
--pkglibdir 顯示可動態載入模組位置
--sharedir 顯示與架構無關的支援檔位置
--sysconfdir 顯示系統層級設定檔位置
--version 顯示 PostgreSQL 版本
%s: 找不到程式執行檔
%s: 無效的參數: %s
選項:
回報錯誤至 <pgsql-bugs@postgresql.org>。
執行 "%s --help" 顯示更多資訊。
使用方法:
子行程結束，結束代碼 %d 子行程結束，不明狀態代碼 %d 子行程被例外 0x%X 結束 子行程被信號 %d 結束 子行程被信號 %s 結束 無法切換目錄至 "%s" 找不到 "%s" 執行 無法識別目前的目錄: %s 無法讀取 binary "%s" 無法讀取符號連結 "%s" 無效的 binary "%s" 沒有紀錄
locale/zh_TW/LC_MESSAGES/ecpg-9.6.mo 0000644 00000031701 14751153421 0012415 0 ustar 00 �� z � � � H
~ I
- �
+ �
0 " 7 S g � � 4 s H . � G � 4 3
) h
w �
4
? @ R = � ! � � , 1 > * p - � - � 1 � ' ) & Q + x " � � � # * ) 2 = \ � � & � < � ! $ F - P 9 ~ + � " � , " O n * � " � ' � ! 2 T ! m � � 3 � / � ' ) 5 Q I � , � / � * . T Y ' � � �
6 - P , ~ , � 5 � ) * ? T 8 � � � 0 d 5 � � A � L "
o 6 } ' � # � (
4 6 ) k � / � � � $ A " Y , | � � ' � ( $ C D h + � ? � 0 J 8 i � � & � � & m � 0 H! - y! - �! 0 �! y " �" * �" s �" - ># > l# 0 �# , �# { $ 0 �$ �$ F �$ ; % P% p% , �% 4 �% - �% 0 & 0 I& 4 z& * �& ) �& . ' 3' M' h' ! �' �' , �' ? �'
( "( ' 5( = ]( ' �( �( $ �( 7 �( ) () R) n) $ �) �) �) $ �) �) * ;* O* " j* �* ! �* �* �* , �* ' '+ O+ ' n+ 6 �+ ! �+ 4 �+ - $, T R, ! �, �, �, �, - "- % ;- $ a- $ �- 4 �- �- �- - . ! <. 1 ^. $ �. 5 �. �. C / I D/ �/ ' �/ �/ �/ 0 & 0 + 50 " a0 �0 / �0 �0 ' �0 * 1 61 ( Q1 * z1 �1 �1 $ �1 2 2 % 52 9 [2 ! �2 0 �2 ! �2
3 * #3 N3 g3 $ }3 �3 , u 0 ? \ B $ < P R @ _ 3 z / - 5 m
+ J w 8 y F = f I [ ^ Z ' l M K > ! Y W j e
H Q & b c " V k # 9 G i * ( h q v D N S % X o E L . p ` ; t T 7 4 : 1 2 g a O d A ] n ) 6 C r U x s
If no output file is specified, the name is formed by adding .c to the
input file name, after stripping off .pgc if present.
Report bugs to <pgsql-bugs@postgresql.org>.
--help show this help, then exit
--regression run in regression testing mode
--version output version information, then exit
-C MODE set compatibility mode; MODE can be one of
"INFORMIX", "INFORMIX_SE"
-D SYMBOL define SYMBOL
-I DIRECTORY search DIRECTORY for include files
-c automatically generate C code from embedded SQL code;
this affects EXEC SQL TYPE
-d generate parser debug output
-h parse a header file, this option includes option "-c"
-i parse system include files as well
-o OUTFILE write result to OUTFILE
-r OPTION specify run-time behavior; OPTION can be:
"no_indicator", "prepare", "questionmarks"
-t turn on autocommit of transactions
%s at or near "%s" %s is the PostgreSQL embedded SQL preprocessor for C programs.
%s, the PostgreSQL embedded C preprocessor, version %d.%d.%d
%s: could not open file "%s": %s
%s: no input files specified
%s: parser debug support (-d) not available
AT option not allowed in CLOSE DATABASE statement AT option not allowed in CONNECT statement AT option not allowed in DEALLOCATE statement AT option not allowed in DISCONNECT statement AT option not allowed in SET CONNECTION statement AT option not allowed in TYPE statement AT option not allowed in VAR statement AT option not allowed in WHENEVER statement COPY FROM STDIN is not implemented COPY FROM STDOUT is not possible COPY TO STDIN is not possible CREATE TABLE AS cannot specify INTO ERROR: EXEC SQL INCLUDE ... search starts here:
Error: include path "%s/%s" is too long on line %d, skipping
Options:
SHOW ALL is not implemented Try "%s --help" for more information.
Unix-domain sockets only work on "localhost" but not on "%s" Usage:
%s [OPTION]... FILE...
WARNING: arrays of indicators are not allowed on input constraint declared INITIALLY DEFERRED must be DEFERRABLE could not open include file "%s" on line %d could not remove output file "%s"
cursor "%s" does not exist cursor "%s" has been declared but not opened cursor "%s" is already defined descriptor "%s" does not exist descriptor header item "%d" does not exist descriptor item "%s" cannot be set descriptor item "%s" is not implemented end of search list
expected "://", found "%s" expected "@" or "://", found "%s" expected "@", found "%s" expected "postgresql", found "%s" incomplete statement incorrectly formed variable "%s" indicator for array/pointer has to be array/pointer indicator for simple data type has to be simple indicator for struct has to be a struct indicator variable "%s" is hidden by a local variable indicator variable "%s" is hidden by a local variable of a different type indicator variable must have an integer type initializer not allowed in EXEC SQL VAR command initializer not allowed in type definition internal error: unreachable state; please report this to <pgsql-bugs@postgresql.org> interval specification not allowed here invalid bit string literal invalid connection type: %s invalid data type key_member is always 0 missing "EXEC SQL ENDIF;" missing identifier in EXEC SQL DEFINE command missing identifier in EXEC SQL IFDEF command missing identifier in EXEC SQL UNDEF command missing matching "EXEC SQL IFDEF" / "EXEC SQL IFNDEF" more than one EXEC SQL ELSE multidimensional arrays are not supported multidimensional arrays for simple data types are not supported multidimensional arrays for structures are not supported multilevel pointers (more than 2 levels) are not supported; found %d level multilevel pointers (more than 2 levels) are not supported; found %d levels nested arrays are not supported (except strings) no longer supported LIMIT #,# syntax passed to server nullable is always 1 only data types numeric and decimal have precision/scale argument only protocols "tcp" and "unix" and database type "postgresql" are supported out of memory pointer to pointer is not supported for this data type pointers to varchar are not implemented subquery in FROM must have an alias syntax error syntax error in EXEC SQL INCLUDE command too many levels in nested structure/union definition too many nested EXEC SQL IFDEF conditions type "%s" is already defined type name "string" is reserved in Informix mode unmatched EXEC SQL ENDIF unrecognized data type name "%s" unrecognized descriptor item code %d unrecognized token "%s" unrecognized variable type code %d unsupported feature will be passed to server unterminated /* comment unterminated bit string literal unterminated hexadecimal string literal unterminated quoted identifier unterminated quoted string using unsupported DESCRIBE statement using variable "%s" in different declare statements is not supported variable "%s" is hidden by a local variable variable "%s" is hidden by a local variable of a different type variable "%s" is neither a structure nor a union variable "%s" is not a pointer variable "%s" is not a pointer to a structure or a union variable "%s" is not an array variable "%s" is not declared variable "%s" must have a numeric type zero-length delimited identifier Project-Id-Version: PostgreSQL 9.1
Report-Msgid-Bugs-To: pgsql-bugs@postgresql.org
POT-Creation-Date: 2011-05-11 20:42+0000
PO-Revision-Date: 2013-09-03 23:28-0400
Last-Translator: Zhenbang Wei <znbang@gmail.com>
Language-Team: EnterpriseDB translation team <dev-escalations@enterprisedb.com>
Language: zh_TW
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Plural-Forms: nplurals=1; plural=0;
如果未指定輸出檔，檔名就是將輸入檔的檔名
去掉 .pgc (如果有的話) 再加上 .c。
回報錯誤給 <pgsql-bugs@postgresql.org>。
--help 顯示此說明然後結束
--regression 以迴歸測試模式執行
--version 輸出版本資訊然後結束
-C 模式 設定相容性模式，模式可以是下列其中一項
"INFORMIX"、"INFORMIX_SE"
-D 符號 定義符號
-I 目錄 搜尋引用檔案的目錄
-c 自動從內嵌 SQL 程式碼產生 C 程式碼，
EXEC SQL TYPE 會受到影響
-d 產生解譯器偵錯輸出
-h 解譯標頭檔，此選項包含選項 "-c"
-i 同時解譯系統引用檔案
-o 輸出檔 將結果寫入輸出檔
-r 選項 指定執行階段行為，選項可以是:
"no_indicator"、"prepare"、"questionmarks"
-t 開啟交易自動提交功能
在"%s"附近發生 %s %s 是 PostgreSQL 內嵌 SQL 前置處理器，適用於 C 程式。
%s，PostgreSQL 內嵌 C 前置處理器，版本 %d.%d.%d
%s: 無法開啟檔案"%s": %s
%s: 未指定輸入檔
%s: 解譯器偵錯支援 (-d) 無法使用
CLOSE DATABASE 陳述式中不允許使用 AT 選項 CONNECT 陳述式中不允許使用 AT 選項 DEALLOCATE 陳述式中不允許使用 AT 選項 DISCONNECT 陳述式中不允許使用 AT 選項 SET CONNECTION 陳述式中不允許使用 AT 選項 TYPE 陳述式中不允許使用 AT 選項 VAR 陳述式中不允許使用 AT 選項 WHENEVER 陳述式中不允許使用 AT 選項 未實作 COPY FROM STDIN COPY FROM STDOUT 不可行 COPY TO STDIN 不可行 CREATE TABLE AS 不能指定 INTO 錯誤: EXEC SQL INCLUDE ... 在此處開始搜尋:
錯誤: 引用檔路徑 "%s/%s" 太長 (位於行 %d)，略過
選項：
未實作 SHOW ALL 執行"%s --help"顯示更多資訊。
Unix-可用域通訊端僅適用 "localhost"，不適用 "%s" 使用方法:
%s [選項]...檔案...
警告: 輸入中不允許使用指標陣列 限制宣告的 INITIALLY DEFERRED 必須是 DEFERRABLE 無法開啟引用檔 "%s" (位於行 %d) 無法移除輸出檔 "%s"
指標 "%s"不存在 指標 "%s" 已宣告但尚未開啟 指標 "%s" 已定義 描述子 "%s" 不存在 描述子標頭項目 "%d" 不存在 不能設定描述子項目 "%s" 未實作描述子項目 "%s" 搜尋清單結尾
預期 "://"，找到 "%s" 預期 "@" 或 "://"，找到 "%s" 預期 "@"，找到 "%s" 預期 "postgresql"，找到 "%s" 陳述式不完整 變數 "%s" 的格式不正確 陣列/指標的指標必須是陣列/指標 簡單資料型別的指標必須簡單 建構的指標必須是建構 指標變數 "%s" 被區域變數遮蔽 指標變數 "%s" 被不同型別的區域變數遮蔽 指標變數必須是整數型別 EXEC SQL VAR 指令中不允許使用初始設定式 型別定義中不允許使用初始設定式 內部錯誤: 無法連線狀態，請將錯誤回報給 <pgsql-bugs@postgresql.org> 這裡不允許使用間隔規格 位元字串實量無效 連線類型無效:%s 資料型別無效 key_member 一律為 0 遺漏 "EXEC SQL ENDIF;" EXEC SQL DEFINE 指令遺漏識別字 EXEC SQL IFDEF 指令遺漏識別字 EXEC SQL UNDEF 指令遺漏識別字 遺漏相符的 "EXEC SQL IFDEF" / "EXEC SQL IFNDEF" 多個 EXEC SQL ELSE 不支援多維度陣列 不支援簡單資料型別的多維度陣列 不支援多維度的結構陣列 不支援多層指標(2層以上)，發現 %d 層 不支援巢狀陣列 (字串除外) 不再支援的 LIMIT #,# 語法已傳遞到伺服器 Nullable 一律為 1 只有數值和十進位資料型別有精確度/小數位數參數 只支援通訊協定 "tcp" 和 "unix" 以及資料庫類型 "postgresql" 記憶體用盡 此資料型別不支援指標的指標 Varchar 的指標未實作 FROM中的子查詢要有別名 語法錯誤 EXEC SQL INCLUDE 指令的語法錯誤 巢狀結構/聯集定義中的層級過多 過多巢狀 EXEC SQL IFDEF 條件 型別 "%s" 已定義 型別名稱 "string" 在 Informix 是保留字 EXEC SQL ENDIF 不相符 無法辨識的資料型別名稱 "%s" 無法辨識的描述子項目程式碼 %d 無法辨識的 token "%s" 無法辨識的變數型別程式碼 %d 不支援的功能將會傳遞到伺服器 未結束的 /* 註解 未結束的位元字串實量 未結束的十六進位字串實量 未結束的引號識別字 未結束的引號字串 使用不支援的 DESCRIBE 陳述式 在多個宣告陳述式中使用變數 "%s" 未被支援 變數 "%s" 被區域變數遮蔽 變數 "%s" 被不同型別的區域變數遮蔽 變數 "%s" 不是結構或聯集 變數 "%s" 不是指標 變數 "%s" 不是結構或聯集的指標 變數 "%s" 不是陣列 變數 "%s" 未宣告 變數 "%s" 必須具有數值型別 長度為零的分隔識別字 locale/zh_TW/LC_MESSAGES/libpq5-9.6.mo 0000644 00000043543 14751153421 0012702 0 ustar 00 �� � t � �
` a r u z
� ' � ( � � # � ! $ . S m
� ( � ( � ( � " 5 ) 8 _ $ � # � � - � 2 5 S � � : � " � a ! 0 � ) � ' � ' ' . * V * � + � * � ) ) - - W + � ( � ) � & 5 + 3 a & � ! � � � " * v M x � = ! ^ � ' � - � 6 � � * > � # � & ! ) H * r # � 9 � ) � ) % O ) m " � 9 � . � ' # 2 K * ~ " � " � . � * / I . y @ � 2 � ! % > % d = � 0 � � : Q - q - � � + � 2 7 H = � ! � . � F / C v � B � ! ; 5! ( q! * �! & �! % �! ! " 6 4" C k" ? �" 2 �" 1 "# ) T# ~# �# �# �# �# + �# $ ) @$ " j$ [ �$ �$ ? % 1 B% 8 t% > �% � �% # m& �& � �& 6 0' 2 g' Q �' J �' K 7( �( $ �( % �( # �( $ ) % 4) Z) ? k) ! �) + �) �)
* D &* & k* . �* C �* + 5 &+ � \+ - - - %- +- :- Z- {- �- �- �- �- �- . . 1. N. o. w. . 5 �. 8 �. �. $ / 9/ E/ `/ x/ . �/ �/ �/ 0 �/ 0 00 v B0 * �0 ) �0 " 1 + 11 ]1 $ r1 $ �1 % �1 $ �1 # 2 # +2 ' O2 % w2 " �2 # �2 �2 # �2 * 3 K3 k3 �3 �3 �3 �3 w �3 v `4 �4 �4 5 (5 + E5 * q5 z �5 3 6 K6 ( i6 $ �6 ( �6 ! �6 < 7 ?7 _7 7 �7 �7 8 �7 " 8 # 58 . Y8 " �8 # �8 �8 3 �8 ( !9 1 J9 . |9 = �9 / �9 : 6: R: 7 n: $ �: �: - �: ; * 0; ) [; �; # �; ) �; , �; ; < # \< . �< �< C �< @ = P= E j= �= = �= > % (> $ N> s> �> ' �> > �> 1 ? 8 M? 2 �? $ �? �? �? @ ! 3@ U@ . f@ �@ % �@ �@ n �@ dA 7 {A % �A ) �A @ B b DB �B �B } �B 7 YC 3 �C N �C H D I ]D �D $ �D % �D # E $ /E % TE zE ; �E �E ) �E
F F 9 >F # xF 7 �F ? �F " G + 7G B } w � J ! � � "
n ~ e N � � j I � � O o U � : ; u � [ Z � 2 � � � < 5 M � � q � � Q G � � 9 7 + � � 8 _ � � 1 p � ( L . � � h � f � � � = T d F ? s i g K > @ b � � ` A ^ Y ) k % 4 ' � { |
R H , & y � W � t 6 � l 3 E � ] D S X � * � � / z V P � - # c r x v a m $ � 0 � C \ � at character %s %s %s, %s:%s CONTEXT: %s
COPY IN state must be terminated first
COPY OUT state must be terminated first
COPY terminated by new PQexec Crypt authentication not supported
DETAIL: %s
GSSAPI authentication not supported
GSSAPI continuation error GSSAPI name import error HINT: %s
Kerberos 4 authentication not supported
Kerberos 5 authentication not supported
Kerberos 5 authentication rejected: %*s
LINE %d: LOCATION: NOTICE PGEventProc "%s" failed during PGEVT_CONNRESET event
PGEventProc "%s" failed during PGEVT_RESULTCREATE event
PQexec not allowed during COPY BOTH
PQgetline: not doing text COPY OUT
QUERY: %s
SCM_CRED authentication method not supported
SSL SYSCALL error: %s
SSL SYSCALL error: EOF detected
SSL certificate's common name contains embedded null
SSL error code %lu SSL error: %s
SSL library does not support CRL certificates (file "%s")
SSPI authentication not supported
SSPI continuation error WARNING: password file "%s" has group or world access; permissions should be u=rw (0600) or less
WARNING: password file "%s" is not a plain file
WSAIoctl(SIO_KEEPALIVE_VALS) failed: %ui
another command is already in progress
attribute has no values on LDAP lookup
authentication method %u not supported
cannot determine OID of function lo_close
cannot determine OID of function lo_creat
cannot determine OID of function lo_create
cannot determine OID of function lo_lseek
cannot determine OID of function lo_open
cannot determine OID of function lo_tell
cannot determine OID of function lo_truncate
cannot determine OID of function lo_unlink
cannot determine OID of function loread
cannot determine OID of function lowrite
certificate could not be obtained: %s
certificate does not match private key file "%s": %s
certificate present, but not private key file "%s"
column number %d is out of range 0..%d command string is a null pointer
connection in wrong state
connection not open
connection pointer is NULL
could not acquire SSPI credentials could not connect to server: %s
Is the server running locally and accepting
connections on Unix domain socket "%s"?
could not connect to server: %s
Is the server running on host "%s"%s%s%s and accepting
TCP/IP connections on port %s?
could not create LDAP structure
could not create SSL context: %s
could not create socket: %s
could not establish SSL connection: %s
could not get client address from socket: %s
could not get effective UID from peer credentials: %s
could not get home directory to locate root certificate file
Either provide the file or change sslmode to disable server certificate verification.
could not get home directory to locate service definition file could not get peer credentials: %s
could not get socket error status: %s
could not initialize SSL engine "%s": %s
could not interpret result from server: %s could not load SSL engine "%s": %s
could not load private SSL key "%s" from engine "%s": %s
could not load private key file "%s": %s
could not open certificate file "%s": %s
could not open file "%s": %s
could not read certificate file "%s": %s
could not read from file "%s": %s
could not read private SSL key "%s" from engine "%s": %s
could not read root certificate file "%s": %s
could not receive data from server: %s
could not restore non-blocking mode on socket: %s
could not send SSL negotiation packet: %s
could not send data to server: %s
could not send startup packet: %s
could not set socket to TCP no delay mode: %s
could not set socket to blocking mode: %s
could not set socket to close-on-exec mode: %s
could not set socket to non-blocking mode: %s
could not translate Unix-domain socket path "%s" to address: %s
could not translate host name "%s" to address: %s
could not write to file "%s": %s
definition of service "%s" not found
duplicate GSS authentication request
expected authentication request from server, but received %c
function requires at least protocol version 3.0
host name must be specified
host name must be specified for a verified SSL connection
incomplete multibyte character
integer of size %lu not supported by pqGetInt integer of size %lu not supported by pqPutInt invalid ExecStatusType code invalid LDAP URL "%s": invalid port number
invalid LDAP URL "%s": missing distinguished name
invalid LDAP URL "%s": must have exactly one attribute
invalid LDAP URL "%s": must have search scope (base/one/sub)
invalid LDAP URL "%s": no filter
invalid LDAP URL "%s": scheme must be ldap://
invalid connection option "%s"
invalid connection state %d, probably indicative of memory corruption
invalid connection state, probably indicative of memory corruption
invalid port number: "%s"
invalid setenv state %c, probably indicative of memory corruption
invalid sslmode value: "%s"
invalid state %c, probably indicative of memory corruption
keepalives parameter must be an integer
length must be given for binary parameter
line %d too long in service file "%s"
local user with ID %d does not exist
lookup on LDAP server failed: %s
lost synchronization with server, resetting connection lost synchronization with server: got message type "%c", length %d
message contents do not agree with length in message type "%c"
message type 0x%02x arrived from server while idle missing "=" after "%s" in connection info string
more than one entry found on LDAP lookup
no COPY in progress
no SSL error reported no connection to the server
no entry found on LDAP lookup
out of memory
out of memory allocating GSSAPI buffer (%i) out of memory for query result
parameter number %d is out of range 0..%d password retrieved from file "%s"
private key file "%s" has group or world access; permissions should be u=rw (0600) or less
protocol error: id=0x%x
query to initialize large object functions did not return data
received invalid response to SSL negotiation: %c
requirepeer parameter is not supported on this platform
requirepeer specifies "%s", but actual peer user name is "%s"
root certificate file "%s" does not exist
Either provide the file or change sslmode to disable server certificate verification.
row number %d is out of range 0..%d select() failed: %s
server closed the connection unexpectedly
This probably means the server terminated abnormally
before or while processing the request.
server common name "%s" does not match host name "%s"
server does not support SSL, but SSL was required
server sent binary data ("B" message) without prior row description ("T" message) server sent data ("D" message) without prior row description ("T" message) server sent data ("D" message) without prior row description ("T" message)
service file "%s" not found
setsockopt(SO_KEEPALIVE) failed: %s
setsockopt(TCP_KEEPALIVE) failed: %s
setsockopt(TCP_KEEPCNT) failed: %s
setsockopt(TCP_KEEPIDLE) failed: %s
setsockopt(TCP_KEEPINTVL) failed: %s
socket not open
sslmode value "%s" invalid when SSL support is not compiled in
statement name is a null pointer
syntax error in service file "%s", line %d
timeout expired
unexpected asyncStatus: %d
unexpected character %c following empty query response ("I" message) unexpected field count in "D" message
unexpected message from server during startup
unexpected response from server; first received character was "%c"
unrecognized SSL error code: %d
unterminated quoted string in connection info string
Project-Id-Version: PostgreSQL 9.1
Report-Msgid-Bugs-To: pgsql-bugs@postgresql.org
POT-Creation-Date: 2011-05-11 20:43+0000
PO-Revision-Date: 2013-09-03 23:27-0400
Last-Translator: Zhenbang Wei <znbang@gmail.com>
Language-Team: EnterpriseDB translation team <dev-escalations@enterprisedb.com>
Language: zh_TW
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Plural-Forms: nplurals=1; plural=0;
於字元 %s %s %s, %s:%s 上下文: %s
必須先結束 COPY IN 狀態
必須先結束 COPY OUT 狀態
COPY 被新的 PQexec 中斷 不支援加密驗證
詳細資料: %s
不支援 GSSAPI 驗證
GSSAPI 接續錯誤 GSSAPI 名稱匯入錯誤 提示: %s
不支援 Kerberos 4 驗證
不支援 Kerberos 5 驗證
kerberos 5 認證被拒絕: %*s
行 %d: 位置: 注意 PGEVT_CONNRESET 事件期間 PGEventProc "%s" 失敗
PGEVT_RESULTCREATE 事件期間 PGEventProc "%s" 失敗
COPY BOTH 時不允許 PQexec
PQgetline: 不進行文字 COPY OUT
查詢: %s
不支援 SCM_CRED 驗證
SSL SYSCALL 錯誤: %s
SSL SYSCALL 錯誤: 發現EOF
SSL 憑證的一般名稱包含內嵌的 Null
SSL 錯誤碼 %lu SSL 錯誤: %s
SSL 程式庫不支援 CRL 憑證 (檔案 "%s")
不支援 SSPI 驗證
SSPI 接續錯誤 警告: 密碼檔 "%s" 可以被群組或其他使用者存取，應該將權限設為 be u=rw (0600) 或更底權限
警告: 密碼檔 "%s" 不是純文字檔
WSAIoctl(SIO_KEEPALIVE_VALS) 失敗: %ui
另外一條命令正在執行中
用於 LDAP 查閱作業的屬性沒有值
不支援 %u 驗證
無法判斷函式 lo_close 的 OID
無法判斷函式 lo_creat 的 OID
無法判斷函式 lo_create 的 OID
無法判斷函式 lo_lseek 的 OID
無法判斷函式 lo_open 的 OID
無法判斷懽式 lo_tell 的 OID
無法判斷函式 lo_truncate 的 OID
無法判斷函式 lo_unlink 的 OID
無法判斷函式 loread 的 OID
無法判斷函式 lowrite 的 OID
無法取得憑證: %s
憑證與私鑰檔 "%s" 不符: %s
發現憑證，但是沒有私鑰檔 "%s"
列號 %d 超出了範圍 0..%d 命令字串是一個空指標
連線處於錯誤的狀態
連線未開啟
連線指標是 NULL
無法取得 SSPI 認證 無法連線到伺服器: %s
伺服器是否在本地執行並且在 Unix domain socket
"%s"上準備接受連線？
無法連線到伺服器: %s
伺服器是否在主機 "%s"%s%s%s 執行並且接受
連接埠 %s 的TCP/IP連線？
無法建立 LDAP 結構
無法建立 SSL context: %s
無法建立 socket: %s
無法建立 SSL 連線: %s
無法從 socket 取得客戶端位址: %s
無法從對點認證取得有效 UID: %s
無法取得用來尋找根憑證檔 "%s" 的家目錄
請提供檔案或變更 sslmode 以停用伺服器憑證驗證。
無法取得用來尋找服務定義檔的家目錄 無法取得對點認證: %s
無法取得 socket 的錯誤狀態: %s
無法初始化 SSL 引擎 "%s": %s
無法解讀來自伺服器的結果: %s 無法載入 SSL 引擎 "%s": %s
無法從引擎 "%2$s" 載入私密 SSL 金鑰 "%1$s": %3$s
無法載入私鑰檔 "%s": %s
無法開啟憑證檔 "%s": %s
無法開啟檔案 "%s": %s
無法讀取憑證檔 "%s": %s
無法讀取檔案 "%s": %s
無法讀取私密 SSL 金鑰 "%s" (從引擎 "%s"): %s
無法讀取根憑證檔 "%s": %s
無法從伺服器接收資料: %s
無法將 socket 還原為非阻擋模式: %s
無法傳送 SSL 交談封包: %s
無法向伺服器傳送資料: %s
無法傳送啟動封包: %s
無法將 socket 設定為 TCP 無延遲模式: %s
無法將 socket 設為阻擋模式: %s
無法將 socket 設為 close-on-exec 模式: %s
無法將 socket 設定為非阻擋模式: %s
無法將 Unix-domain socke t路徑 "%s" 轉換成位址: %s
無法將主機名稱 "%s" 轉換成位址: %s
無法寫入檔案 "%s": %s
找不到服務定義 "%s"
重複的 GSS 驗證要求
期待來自伺服器的認證請求，但是收到 %c
函式需要 3.0 版以上的協定
必須指定主機名稱
已驗證 SSL 連線必須指定主機名稱
多位元組字元不完整
pgGetInt 不支援大小為 %lu 的整數 pgPutInt 不支援大小為 %lu 的整數 無效的 ExecStatusType 代碼 LDAP URL "%s" 無效: 埠號無效
LDAP URL "%s" 無效: 遺漏識別名稱
LDAP URL "%s" 無效: 只能有一個屬性
LDAP URL "%s" 無效: 必須有搜尋範圍 (base/one/sub)
LDAP URL "%s" 無效: 無過濾器
LDAP URL "%s" 無效: 類型必須是 ldap://
無效的連線選項 "%s"
無效的連線狀態 %d，可能是記憶體中的資料被破壞
無效的連線狀態，可能是記憶體中的資料被破壞
無效的連接埠: "%s"
無效的 setenv 狀態 %c，可能是記憶體中的資料被破壞
無效的 sslmode: "%s"
無效的狀態 %c，可能是記憶體中的資料被破壞
keepalive 參數必須是整數
必須指定二進位參數的長度
服務檔 "%2$s" 第 %1$d 行太長
本機使用者 ID %d 不存在
查閱 LDAP 伺服器失敗:%s
無法與伺服器協調，重置連線 無法與伺服器協調: 收到訊息類型 "%c"，長度 %d
訊息類型 "%c" 的長度與訊息內容不符
閒置時收到伺服器送來類型為 0x%02x 的訊息 在連線資訊字串裡的 "%s" 後面缺少 "="
LDAP 查閱作業找到多個項目
沒有執行中的 COPY 命令
沒有 SSL 錯誤被回報 沒有連線到伺服器
LDAP 查閱作業找不到項目
記憶體用盡
配置 GSSAPI 緩衝區時記憶體不足 (%i) 查詢結果用盡記憶體
參數編號 %d 超出了範圍 0..%d 從檔案 "%s" 取得密碼
私鑰檔 "%s" 可以被群組或其他使用者存取，應該將權限設為 u=rw (0600) 或更低的權限
協定錯誤: id=0x%x
初始化大型物件函式的查詢沒有傳回資料
收到無效的 SSL 交談回應: %c
這個平臺不支援 requirepeer 參數
requirepeer 指定 "%s", 但實際對點使用者名稱是 "%s"
根憑證檔 "%s" 不存在
請提供檔案，或變更 sslmode 以停用伺服器憑證驗證。
行號 %d 超出了範圍 0..%d select()失敗: %s
伺服器意外地中斷了連線
可能是伺服器在處理請求之前
或者正在處理請求的時候不正常中止
伺服器公用名稱 "%s" 與主機名稱 "%s" 不同
伺服器不支援 SSL，但是被要求使用 SSL
伺服器傳送二元資料("B" 訊息)而未提供資料行描述("T" 訊息) 伺服器傳送資料("D" 訊息)而未提供資料行描述("T" 訊息) 伺服器傳送資料("D" 訊息)而未提供資料行描述("T" 訊息)
找不到服務檔 "%s"
setsockopt(SO_KEEPALIVE) 失敗: %s
setsockopt(TCP_KEEPALIVE) 失敗: %s
setsockopt(TCP_KEEPCNT) 失敗: %s
setsockopt(TCP_KEEPIDLE) 失敗: %s
setsockopt(TCP_KEEPINTVL) 失敗: %s
socket 未開啟
編譯時未加入 SSL 支援，無效的 sllmode 值 "%s"
敘述名稱是一個空指標
服務檔第 %2$d 行語法錯誤 "%1$s"
發生逾時
非預期的 asyncStatus: %d
空的查詢回應("I" 訊息)後跟隨非預期字元 %c "D" 訊息的欄位數不符預期
啟動過程中收到來自伺服器的非預期訊息
非預期的伺服器回應，收到的第一個字元是 "%c"
無法識別的 SSL 錯誤碼: %d
連線資訊字串中有未結束的引號
locale/zh_TW/LC_MESSAGES/psql-9.6.mo 0000644 00000175646 14751153421 0012477 0 ustar 00 �� @ U 4 pE qE � �E /F KF
dF rF < �F 5 �F A �F k 8G 7 �G K �G ^ (H 2 �H 4 �H N �H c >I Q �I O �I > DJ O �J @ �J 6 K N KK G �K 8 �K A L T ]L ? �L L �L A ?M @ �M H �M A N + MN _ yN 5 �N 9 O M IO ; �O @ �O K P J `P o �P > Q F ZQ N �Q F �Q $ 7R & \R - �R 9 �R 7 �R 2 #S 4 VS 3 �S ) �S ) �S ; T B OT ) �T * �T * �T 2 U 1 EU . wU - �U , �U 4 V I 6V $ �V & �V > �V & W ( 2W J [W : �W ( �W %
X $ 0X $ UX ) zX N �X 9 �X G -Y 5 uY P �Y K �Y L HZ 4 �Z , �Z q �Z A i[ ? �[ A �[ > -\ � l\ # C] F g] 8 �] < �] M $^ 6 r^ 7 �^ B �^ : $_ 4 __ ? �_ % �_ ( �_ #` @` C` W` $ _` # �` % �` * �` �` # a < >a {a > �a �a 6 �a 2b
Gb � Rb : �b 3c ?c Lc ac kc |c �c �c I �c [ �c
Zd ed vd �d �d C �d A �d <e Ie Oe be oe we ~e , �e �e �e �e �e �e f f 4f Jf
Sf ^f jf vf ' �f �f & �f ' �f 7 g 0 Pg �g �g G �g �g �g �g e h nh h �h �h �h �h �h i i .i :i Ci Li ^i ki zi �i �i �i �i
�i �i �i �i �i �i �i
�i j
j &j & 3j Zj cj
rj
�j �j �j �j
�j �j �j �j k k .k Fk ]k {k �k �k �k �k
�k �k �k l " #l Fl gl �l �l & �l �l �l �l �l m m
m m L *m wm �m �m > �m n n )n 2 @n sn zn �n �n �n �n �n �n �n o &o :o Wo
no yo �o
�o �o �o �o
p )p 8p , Dp qp �p �p �p �p �p �p & �p q )q 0q Aq ' Hq pq �q �q �q �q �q �q �q �q �q �q r
r r .r
Gr Rr cr ) or �r �r ! �r �r �r 9 s I Ps 8 �s = �s < t C Nt > �t N �t 9 u ; Zu �u �u
�u �u �u �u
�u �u v /v Gv hv rv & zv �v �v �v � �v �w �w �w �w �w �w �w
�w x
x x
(x ] 3x � �x Ry K ry Q �y / z @z O Xz U �z 5 �z = 4{ r{ , ~{ �{ ! �{ �{ �{ | | +| " G| j| 9 �| # �| N �| 9 8} r} �} �} �} �} �} �} �} ~ ~ ~ ~ /~ C~ $ \~ �~ �~ �~ �~ �~ �~ �~
�~ �~ �~ �~ �~ ! C . r % � � � � � � $ � % ;� ! a� ) �� ( �� / ր # � ' *� . R� ! �� - �� с % � 4 � 1 M� - � / �� " ݂ � ' � H� . h� % �� ! �� $ ߃ * � + /� A [� �� & �� 0 ̄ . �� ) ,� ) V� �� % �� ��
��
Ņ Ѕ # څ �� � � $� 6� B� N� U� C ]� �� �� ֆ � �� �
!� ,� ) <� $ f� " �� �� $ χ ! � ( � ' ?� g� # �� ! �� ( Ȉ �
� '� F� L� b� }� �� ��
�� �� ˉ
Ӊ މ � �� � -� D� [� v� �� �� NJ ! � � � 2 -� `� v� �� �� Ћ 5 � � 4� T� . g� �� & �� # Ռ �� ! � ;� P� b� {� 6 �� ) Ӎ
�� � � &� 0�
D� & R� y� �� �� �� �� Ŏ ͎ �
�� � � !� '� , 7� d� �� �� �� Ï
� � �� � � � " '�
J� X� d� n� x� ��
�� 1 �� ܐ �
� � "� . 4� c�
m� {� �� ��
�� �� E ��
�� � � )� 9� H� O� d� l� {� �� �� * �� � � �
� � � '�
8� C� L� V� f� x� �� �� �� �� ϓ ܓ � � �� ��
� � � %� *� 1�
D� O� ^� m� v� ��
�� �� �� �� �� �� ͔ Ԕ ݔ � � �� � � � &� )� 1� 9�
B� P� W�
i� w� �� �� �� �� �� ˕ ו � � �� � ! � 4 0�
e� s� . |� �� �� �� і � � �
� � ,� @� S� e� |� " �� �� Ɨ � �� � )� 9� K� Z� " n� �� �� ͘ � * ��
'� 5� N� k� � �� �� �� 0 ՙ � � > � V� ) b� " �� �� ��
ɚ Ԛ ޚ �� �� � � � +� 7�
>� L�
U� c� o� {� 7 �� 2 6 �� V ,� �� & �� & �� ל �
��
� � $� 0� 8� ?� E� _� n� ~� ! �� �� �� ĝ ѝ � � �� �
$�
/� :� J� \� h� t� }� �� ��
�� �� �� �� Ȟ ՞ � � � .� 8� <� E� L� c�
m� x� �� �� �� �� �� , �� � �� � ' )� Q� l� �� �� �� ٠ ! � � � )�
5� @� P� 6 T� �� � �� 5� N� d� u� < �� 4 Ƥ : �� ` 6� @ �� = إ b � 3 y� : �� S � j <� K �� R � C F� E �� = Ш @ � X O� L �� = �� C 3� T w� F ̪ H � I \� C �� U � = @� . ~� a �� . � 7 >� K v� J A
� U O� G �� m � 5 [� 2 �� Q į D � , [� ) �� 2 �� 2 � 2 � 5 K� 2 �� , �� & � , � ; 5� D q� & �� / ݲ &
� / 4� , d� / �� 2 �� / � 8 $� T ]� % �� & ش B �� ' B� ) j� J �� 6 ߵ & � ) =� % g� & �� * �� L ߶ 5 ,� > b� 8 �� S ڷ Q .� R �� 2 Ӹ / � o 6� J �� 8 � 8 *� ; c� � �� % z� J �� 9 � D %� V j� , �� ; � A *� < l� 8 �� A � ( $� ' M� u� � �� �� , �� Ͼ # � " � 3� P� 2 n� �� 5 �� �� 0
� >� Q� � a� ; �� ;� G� T� i�
u� �� �� �� < �� O �� H� O� ^� u� �� H �� E �� -� :� A� T� a� i� p� . �� �� �� �� �� �� �� � *� K� U� \� c� m� 2 t� �� . �� ) �� : !� 7 \� �� �� 2 �� �� �� �� j � v� �� �� ��
�� �� �� � (�
<� G�
N� Y� h� u� �� �� �� ��
�� �� ��
�� �� �� �� � � � -�
:� - E� s�
�� �� �� �� �� �� �� �� �� � �
.� <� R� j� �� �� �� �� �� ��
�� �
� � 6� O� k� �� * �� �� �� �� �� �� �� �� � T � j� t� �� : �� �� � � * 1� \� c� p� }�
�� �� �� �� �� ! �� � '� >� T� ]� n� �� �� �� �� " ��
� � . '� V� i� v� �� �� �� �� % �� ��
� � )� ' 3� [� o� v� }� �� �� �� ��
�� �� �� �� �� � (� E� O� e� ) r� �� �� �� �� �� / � 7 ?� / w� 5 �� 7 �� > � 2 T� E �� 5 �� 5 � 9� J� ^� r�
�� �� �� �� # �� �� �
)� 4� , >� k� �� �� � �� c� {� �� �� �� �� �� �� �� ��
� � [ � � u� B� Q b� \ �� " � 4� Q K� \ �� 2 �� 2 -� `� $ l� �� ! �� �� �� �� �� # � # )� M� 4 g� $ �� R �� 9 � N� g� �� �� �� �� �� �� �� �� �� �� � � ( 5� ^� u� ~� �� �� �� ��
�� �� �� �� �� �� �� �� �� - � :� J� d� m� }� �� �� �� �� �� � ! 1� ' S� {� �� �� �� ! �� � � ! =� ! _� $ �� ! �� �� �� �� � 5� Q� l� �� �� �� 0 ��
� ! � ' 4� ) \� �� ��
�� �� ��
��
�� � � +� 2� ?� Q� c� o� {� �� < �� �� �� �� � � ;�
E� P� `� $ |� �� �� # �� �� � 7� W� u� �� ( �� �� �� � -� 3� F� b� n� {�
�� ! �� �� �� ��
�� �� �� � !� 7� P� a� w� �� $ �� �� �� - �� � 2� K� d� z� ; �� �� �� �� ! � .� G� c� � �� �� �� �� �� ' � 4�
S� ^� e� �� ��
�� ) �� �� �� �� �� � &� ! .� P�
Y� g� t� �� �� , �� �� �� �� � �
.� 9� H� T� ]� c� l� ��
�� �� �� �� �� ��
�� . �� #� 0�
B� M� ^� " p� �� �� �� �� ��
�� �� F ��
+� 9� K� Z� j� y� �� �� �� �� �� �� ( �� � #� 2� <� F� L� V�
g� r� {� �� �� �� �� �� �� �� �� �� � � � $�
-� ;� B� K� R� Y�
l� w� �� �� �� ��
�� �� �� �� �� �� �� � � � !� -� 4� C� L� V� ]� e� m�
w� �� �� �� �� �� �� �� �� �� � � � � 0� :� D� * `� �� �� + �� �� �� �� �� �
� #� ,� ?� L� ^� q� ��
�� �� �� �� �� � �
/� =� M� ]� s� �� �� �� �� ' �� � "� 5� H� [� h� x� �� - �� �� �� ' �� � $ � $ <� a� i�
{� �� �� �� �� �� � � � �
� ��
� � � *� - 9� g� 3 �� L �� �
� ,� K� [�
l�
z� �� �� �� �� �� �� � � � � � � !� .� >� M� S� d�
��
�� �� �� �� � � � � �
� �� � � %� 2� Q� V� s� �� �� �� �� �� �
� � � � � � � ' � H� [� y� ' �� �� � � � � .� E� b� i� {�
�� �� �� � ; } X � � � � � �
� w x C y _ # { # � � � � � � � _ � � � q 9 � H ^ @ - �
� � A J + � � 8 � � . � ) [ / � � � @ � n � 4 n { � G � � e � Y + � � � � K R ] � B � � � � � � � 4 � c * S � � � ( � ) � ] � � + � f z ? � � � � � � \ i � ! � � A � � E � � � � X � 0 � � � � � o [ j | H � � U ' � z ~ � � , $ � 1 � % @ � � � �
� � . O � � b I � � � 2 7 � r C 6 � � � � D � � s 4 f � � � � � � � # W � ; � �
` � � 9 d ' � � � o � N � f 4 M � | 0 i b � � � � � � � ` � } V � � � $ � 5 Z � � � � � � w Z � � a � V G � � � � � � � � Y � � ! � � & = u O 5 5 � > � 3 � � � x T ' � X $ � < � � � � � Q H � 2 � � V � % � v �
P 6 � ; � Z - 0 ; � � � d � n � ! > � Q T � r ] - � k 1 J q � � * 6 � � A L U � r R � � � � > � � � � v < . � N � � � g ? � \ � J (
( � 8 ` � / � � 9 � s � � I � C " � = � k � � t � � � P � � � � � < ' 7 h � 9 : ? � � � � P � � � � L � W B � � � � � w p u Q � � � " � � � � L � $ q = F * � , K : F 8 8 � � � K z " � p l { : % e , � l ) � � a � � 1 " S � � � � m @ � � / � � � � � i � 3 � � � � u
j _ ^ � � U � � e � , � T � v 3 � h � � � s * � � � b � � � p � � � k � 7 M � � � � ~ � � � ) � � } � . � � � � � � � E 1 � � � o � I � � � � � � � � � � � R � � � � � c � 5 Y # l m � < ~ F � y 3 � � 6 h � � � � D � 2 W � � � g ( ? [ � - \ ^ � � � : � � � m 2 | � � � E B � � � � � M g / S y � � � O � � � t � = � � � � % � � �
� t � � � c & � x � & N > � & ! a + d � j � � � D � 7 � G 0 �
Connection options:
For more information, type "\?" (for internal commands) or "\help" (for SQL
commands) from within psql, or consult the psql section in the PostgreSQL
documentation.
Input and output options:
Output format options:
Parser: "%s"
Parser: "%s.%s" (options: S = show system objects, + = additional detail)
--help show this help, then exit
--version output version information, then exit
-1 ("one"), --single-transaction
execute command file as a single transaction
-A, --no-align unaligned table output mode
-E, --echo-hidden display queries that internal commands generate
-F, --field-separator=STRING
set field separator (default: "%s")
-H, --html HTML table output mode
-L, --log-file=FILENAME send session log to file
-P, --pset=VAR[=ARG] set printing option VAR to ARG (see \pset command)
-R, --record-separator=STRING
set record separator (default: newline)
-S, --single-line single-line mode (end of line terminates SQL command)
-T, --table-attr=TEXT set HTML table tag attributes (e.g., width, border)
-U, --username=USERNAME database user name (default: "%s")
-W, --password force password prompt (should happen automatically)
-X, --no-psqlrc do not read startup file (~/.psqlrc)
-a, --echo-all echo all input from script
-c, --command=COMMAND run only single command (SQL or internal) and exit
-d, --dbname=DBNAME database name to connect to (default: "%s")
-e, --echo-queries echo commands sent to server
-f, --file=FILENAME execute commands from file, then exit
-h, --host=HOSTNAME database server host or socket directory (default: "%s")
-l, --list list available databases, then exit
-n, --no-readline disable enhanced command line editing (readline)
-o, --output=FILENAME send query results to file (or |pipe)
-p, --port=PORT database server port (default: "%s")
-q, --quiet run quietly (no messages, only query output)
-s, --single-step single-step mode (confirm each query)
-t, --tuples-only print rows only
-v, --set=, --variable=NAME=VALUE
set psql variable NAME to VALUE
-w, --no-password never prompt for password
-x, --expanded turn on expanded table output
\! [COMMAND] execute command in shell or start interactive shell
\C [STRING] set table title, or unset if none
\H toggle HTML output mode (currently %s)
\T [STRING] set HTML <table> tag attributes, or unset if none
\a toggle between unaligned and aligned output mode
\c[onnect] [DBNAME|- USER|- HOST|- PORT|-]
connect to new database (currently "%s")
\cd [DIR] change the current working directory
\conninfo display information about current connection
\copy ... perform SQL COPY with data stream to the client host
\copyright show PostgreSQL usage and distribution terms
\dC [PATTERN] list casts
\dD[S] [PATTERN] list domains
\dE[S+] [PATTERN] list foreign tables
\dF[+] [PATTERN] list text search configurations
\dFd[+] [PATTERN] list text search dictionaries
\dFp[+] [PATTERN] list text search parsers
\dFt[+] [PATTERN] list text search templates
\dL[S+] [PATTERN] list procedural languages
\dO[S+] [PATTERN] list collations
\dT[S+] [PATTERN] list data types
\d[S+] list tables, views, and sequences
\d[S+] NAME describe table, view, sequence, or index
\da[S] [PATTERN] list aggregates
\db[+] [PATTERN] list tablespaces
\dc[S] [PATTERN] list conversions
\dd[S] [PATTERN] show comments on objects
\ddp [PATTERN] list default privileges
\des[+] [PATTERN] list foreign servers
\det[+] [PATTERN] list foreign tables
\deu[+] [PATTERN] list user mappings
\dew[+] [PATTERN] list foreign-data wrappers
\df[antw][S+] [PATRN] list [only agg/normal/trigger/window] functions
\dg[+] [PATTERN] list roles
\di[S+] [PATTERN] list indexes
\dl list large objects, same as \lo_list
\dn[S+] [PATTERN] list schemas
\do[S] [PATTERN] list operators
\dp [PATTERN] list table, view, and sequence access privileges
\drds [PATRN1 [PATRN2]] list per-database role settings
\ds[S+] [PATTERN] list sequences
\dt[S+] [PATTERN] list tables
\du[+] [PATTERN] list roles
\dv[S+] [PATTERN] list views
\dx[+] [PATTERN] list extensions
\e [FILE] [LINE] edit the query buffer (or file) with external editor
\echo [STRING] write string to standard output
\ef [FUNCNAME [LINE]] edit function definition with external editor
\encoding [ENCODING] show or set client encoding
\f [STRING] show or set field separator for unaligned query output
\g [FILE] or ; execute query (and send results to file or |pipe)
\h [NAME] help on syntax of SQL commands, * for all commands
\i FILE execute commands from file
\l[+] list all databases
\lo_export LOBOID FILE
\lo_import FILE [COMMENT]
\lo_list
\lo_unlink LOBOID large object operations
\o [FILE] send all query results to file or |pipe
\p show the contents of the query buffer
\password [USERNAME] securely change the password for a user
\prompt [TEXT] NAME prompt user to set internal variable
\pset NAME [VALUE] set table output option
(NAME := {format|border|expanded|fieldsep|footer|null|
numericlocale|recordsep|tuples_only|title|tableattr|pager})
\q quit psql
\qecho [STRING] write string to query output stream (see \o)
\r reset (clear) the query buffer
\s [FILE] display history or save it to file
\set [NAME [VALUE]] set internal variable, or list all if no parameters
\sf[+] FUNCNAME show a function's definition
\t [on|off] show only rows (currently %s)
\timing [on|off] toggle timing of commands (currently %s)
\unset NAME unset (delete) internal variable
\w FILE write query buffer to file
\x [on|off] toggle expanded output (currently %s)
\z [PATTERN] same as \dp
psql [OPTION]... [DBNAME [USERNAME]]
%d connection %d connections %s %s (%s, server %s)
%s: %s
%s: cannot copy from/to a directory
%s: could not delete variable "%s"
%s: could not open log file "%s": %s
%s: could not set printing parameter "%s"
%s: could not set variable "%s"
%s: current transaction is aborted
%s: invalid encoding name or conversion procedure not found
%s: not connected to a database
%s: pg_strdup: cannot duplicate null pointer (internal error)
%s: unknown transaction status
%s: warning: extra command-line argument "%s" ignored
(%lu row) (%lu rows) (No rows)
***(Single step mode: verify command)*******************************************
%s
***(press return to proceed or enter x and return to cancel)********************
********* QUERY **********
%s
**************************
, clustered , deferrable , initially deferred , invalid , predicate (%s) , tablespace "%s" Access privileges Argument data types Asynchronous notification "%s" received from server process with PID %d.
Asynchronous notification "%s" with payload "%s" received from server process with PID %d.
Attributes Available help:
Border style is %d.
COPY data transfer failed: %s Call Handler Cannot add cell to table content: total cell count of %d exceeded.
Cannot add header to table content: column count of %d exceeded.
Cannot login Check Check constraints: Child tables Collate Column Column access privileges Command: %s
Description: %s
Syntax:
%s
Composite type "%s.%s" Connection
Create DB Create role Ctype Default access privileges Default footer is off. Default footer is on. Default? Definition Description Destination Dictionaries Did not find any extension named "%s".
Did not find any extensions.
Did not find any relation named "%s".
Did not find any relation with OID %s.
Did not find any text search configuration named "%s".
Did not find any text search parser named "%s".
Disabled rules: Disabled triggers: EDITOR_LINENUMBER_SWITCH variable must be set to specify a line number
Elements Encoding End parse Enter data to be copied followed by a newline.
End with a backslash and a period on a line by itself. Enter it again: Enter new password: Expanded display is off.
Expanded display is on.
Failed.
Field separator is "%s".
Foreign table "%s.%s" Foreign-data wrapper Foreign-key constraints: Formatting
Function General
General options:
Get headline Get next token Get token types Handler Has OIDs ID Implicit? Index "%s.%s" Indexes: Informational
Inherits Init Init options Inline Handler Input/Output
Internal Language Internal name Interrupted
Invalid command \%s. Try \? for help.
Language Large Objects
Large objects Left arg type Lexize Line style is %s.
List of aggregate functions List of casts List of collations List of conversions List of data types List of databases List of domains List of foreign servers List of foreign tables List of foreign-data wrappers List of functions List of installed extensions List of languages List of operators List of relations List of roles List of schemas List of settings List of tablespaces List of text search configurations List of text search dictionaries List of text search parsers List of text search templates List of user mappings Locale-adjusted numeric output is off. Location Member of Method Modifier Modifiers Name No changes No connections No help available for "%s".
Try \h with no arguments to see available help.
No inheritance No matching relations found.
No matching settings found.
No per-database role settings support in this server version.
No relations found.
No settings found.
Null display is "%s".
Number of child tables: %d (Use \d+ to list them.) Object Object Description Object descriptions Objects in extension "%s" Operating System
Options Output format is %s.
Owner Pager is always used. Pager is used for long output. Pager usage is off. Password encryption failed.
Password for user %s: Password: Passwords didn't match.
Previous connection kept
Query Buffer
Query buffer is empty. Query buffer reset (cleared). Record separator is "%s".
Record separator is <newline>. Referenced by: Replication Report bugs to <pgsql-bugs@postgresql.org>.
Result data type Result type Right arg type Role name Rules firing always: Rules firing on replica only: Rules: SSL connection (cipher: %s, bits: %i)
SSL connection (unknown cipher)
Schema Sequence "%s.%s" Server Showing locale-adjusted numeric output. Showing only tuples. Size Source Source code Source type Special relation "%s.%s" Start parse Storage Succeeded.
Superuser TOAST table "%s.%s" Table Table "%s.%s" Table attribute is "%s".
Table attributes unset.
Tablespace Tablespace: "%s" Target type Target width for "wrapped" format is %d.
Template Text search configuration "%s" Text search configuration "%s.%s" Text search parser "%s" Text search parser "%s.%s" The connection to the server was lost. Attempting reset: The server (version %d.%d) does not support altering default privileges.
The server (version %d.%d) does not support extensions.
The server (version %d.%d) does not support foreign servers.
The server (version %d.%d) does not support foreign tables.
The server (version %d.%d) does not support foreign-data wrappers.
The server (version %d.%d) does not support full text search.
The server (version %d.%d) does not support savepoints for ON_ERROR_ROLLBACK.
The server (version %d.%d) does not support tablespaces.
The server (version %d.%d) does not support user mappings.
Time: %.3f ms
Timing is off. Timing is on. Title is "%s".
Title is unset.
Token Token name Token types for parser "%s" Token types for parser "%s.%s" Triggers firing always: Triggers firing on replica only: Triggers: Trusted Try "%s --help" for more information.
Tuples only is off. Type Type "help" for help.
Type: \copyright for distribution terms
\h for help with SQL commands
\? for help with psql commands
\g or terminate with semicolon to execute query
\q to quit
Unlogged index "%s.%s" Unlogged table "%s.%s" Usage:
Use "\q" to leave %s.
User name Validator Value Variables
Version View "%s.%s" View definition: Volatility WARNING: %s version %d.%d, server version %d.%d.
Some psql features might not work.
WARNING: Console code page (%u) differs from Windows code page (%u)
8-bit characters might not work correctly. See psql reference
page "Notes for Windows users" for details.
Wrote history to file "%s/%s".
You are connected to database "%s" as user "%s" on host "%s" at port "%s".
You are connected to database "%s" as user "%s" via socket in "%s" at port "%s".
You are currently not connected to a database.
You are not connected.
You are now connected to database "%s" as user "%s" on host "%s" at port "%s".
You are now connected to database "%s" as user "%s" via socket in "%s" at port "%s".
You are now connected to database "%s" as user "%s".
You are using psql, the command-line interface to PostgreSQL. \!: failed
\%s: could not change directory to "%s": %s
\%s: error
\%s: extra argument "%s" ignored
\%s: missing required argument
\connect: %s \copy: %s \copy: arguments required
\copy: parse error at "%s"
\copy: parse error at end of line
\copy: unexpected response (%d)
\df does not take a "w" option with server version %d.%d
\df only takes [antwS+] as options
\pset: allowed formats are unaligned, aligned, wrapped, html, latex, troff-ms
\pset: allowed line styles are ascii, old-ascii, unicode
\pset: unknown option: %s
abbreviated_grant_or_revoke abort the current transaction aborted because of read failure action agg agg_name agg_type aggregate alias alignment analyze_function and like_option is: and table_constraint is: and table_constraint_using_index is: and with_query is: arg_name arg_type argmode argname argtype argument argument_type arguments attribute attribute_name attribute_option base_type boolean cache call_handler cancel a transaction that was earlier prepared for two-phase commit canceled by user cannot locate temporary directory: %s category change a database change a database role change a run-time parameter change role name or membership change the definition of a collation change the definition of a conversion change the definition of a domain change the definition of a foreign server change the definition of a foreign table change the definition of a foreign-data wrapper change the definition of a function change the definition of a large object change the definition of a procedural language change the definition of a schema change the definition of a sequence generator change the definition of a table change the definition of a tablespace change the definition of a text search configuration change the definition of a text search dictionary change the definition of a text search parser change the definition of a text search template change the definition of a trigger change the definition of a type change the definition of a user mapping change the definition of a view change the definition of an aggregate function change the definition of an extension change the definition of an index change the definition of an operator change the definition of an operator class change the definition of an operator family change the ownership of database objects owned by a database role channel child process exited with exit code %d child process exited with unrecognized status %d child process was terminated by exception 0x%X child process was terminated by signal %d child process was terminated by signal %s close a cursor cluster a table according to an index code collatable collate %s collation collect statistics about a database column column_alias column_constraint column_definition column_name column_type com_op command commit a transaction that was earlier prepared for two-phase commit commit the current transaction compute a set of rows condition configuration_parameter connection to server was lost
connlimit constraint constraint_name contains support for command-line editing copy data between a file and a table could not change directory to "%s" could not find a "%s" to execute could not get current user name: %s
could not get home directory: %s
could not identify current directory: %s could not open temporary file "%s": %s
could not read binary "%s" could not read from input file: %s
could not read symbolic link "%s" could not save history to file "%s": %s
could not start /bin/sh
could not start editor "%s"
could not write COPY data: %s
count create a new database create new rows in a table cursor_name data type data_type database_name deallocate a prepared statement default default %s default_expr define a cursor define a new aggregate function define a new cast define a new collation define a new data type define a new database role define a new domain define a new encoding conversion define a new foreign server define a new foreign table define a new foreign-data wrapper define a new function define a new index define a new mapping of a user to a foreign server define a new operator define a new operator class define a new operator family define a new procedural language define a new rewrite rule define a new savepoint within the current transaction define a new schema define a new sequence generator define a new table define a new table from the results of a query define a new tablespace define a new text search configuration define a new text search dictionary define a new text search parser define a new text search template define a new trigger define a new view define access privileges define default access privileges define or change a security label applied to an object define or change the comment of an object definition delete delete rows of a table delimiter delimiter_character dest_encoding destroy a previously defined savepoint dictionary_name direction directory discard session state domain_constraint element empty a table or set of tables encoding encoding_name end_function escape_character event exclude_element exclude_element in an EXCLUDE constraint is: execute a prepared statement execute an anonymous code block execution_cost existing_collation existing_enum_value expression extension_name family_name fdw_name ffunc filename for table "%s.%s" force a transaction log checkpoint foreign table format_name from_item from_list function function name is required
function_name garbage-collect and optionally analyze a database generate a notification gettoken_function group_name handler_function headline_function history is not supported by this installation
immutable in assignment increment index index_method index_name index_parameters index_parameters in UNIQUE, PRIMARY KEY, and EXCLUDE constraints are: init_function initial_condition inline_handler input_data_type input_function insert install an extension integer internallength invalid binary "%s" invalid command \%s
invalid line number: %s
invalid output format (internal error): %d join_column join_condition join_proc join_type label lang_name large_object_oid lc_collate lc_ctype left_type lexize_function lextypes_function like_option like_type link_symbol listen for a notification load a shared library file local socket locale lock a table lockmode loid maxvalue member_object method minvalue name neg_op new_attribute_name new_column new_dictionary new_enum_value new_name new_owner new_role new_schema new_table new_tablespace new_version no no query buffer
normal not null null_string obj_file object_name off old_dictionary old_role old_version on op_type opclass operator operator_name option or the old syntax out of memory out of memory
output_expression output_function output_name parameter parent_table parser_name password payload position a cursor predicate preferred prepare a statement for execution prepare the current transaction for two-phase commit primary key, provider psql is the PostgreSQL interactive terminal.
query quote_character rebuild indexes receive_function refcolumn referenced_table_name reftable remove a cast remove a collation remove a conversion remove a data type remove a database remove a database role remove a domain remove a foreign server descriptor remove a foreign table remove a foreign-data wrapper remove a function remove a procedural language remove a rewrite rule remove a schema remove a sequence remove a table remove a tablespace remove a text search configuration remove a text search dictionary remove a text search parser remove a text search template remove a trigger remove a user mapping for a foreign server remove a view remove access privileges remove an aggregate function remove an extension remove an index remove an operator remove an operator class remove an operator family remove database objects owned by a database role res_proc restart restore the value of a run-time parameter to the default value result_rows retrieve rows from a query using a cursor retrieve rows from a table or view rettype rewrite_rule_name right_type role_name roll back to a savepoint rule rule_name savepoint_name schema schema_element schema_name select send_function sequence sequence_name server_name server_type server_version set constraint check timing for the current transaction set the characteristics of the current transaction set the current user identifier of the current session set the session user identifier and the current user identifier of the current session sfunc show the execution plan of a statement show the value of a run-time parameter sort_expression sort_family_name sort_operator source_config source_encoding source_type special stable start start a transaction block start_function state_data_type statement stop listening for a notification storage storage_parameter storage_type strategy_number support_number table table_constraint table_constraint_using_index table_name tablespace tablespace_name tablespace_option target_role target_type template text timestamp timezone token_type transaction_id transaction_mode trigger trigger_name trying to exit copy mode type type_modifier_input_function type_modifier_output_function type_name uid unique, update update rows of a table user_name using_list valfunction validator_function value version view volatile where abbreviated_grant_or_revoke is one of: where action is one of: where column_constraint is: where constraint is: where direction can be empty or one of: where event can be one of: where from_item can be one of: where lockmode is one of: where member_object is: where option can be one of: where option can be: where transaction_mode is one of: window window_definition window_name with_query with_query_name yes Project-Id-Version: PostgreSQL 9.1
Report-Msgid-Bugs-To: pgsql-bugs@postgresql.org
POT-Creation-Date: 2011-05-16 04:41+0000
PO-Revision-Date: 2013-09-03 23:23-0400
Last-Translator: Zhenbang Wei <znbang@gmail.com>
Language-Team: The PostgreSQL Global Development Group <Kuo.ChaoYi@gmail.com>
Language: zh_TW
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
X-Poedit-Language: Chinese
X-Poedit-Country: TAIWAN
X-Poedit-SourceCharset: utf-8
X-Poedit-Bookmarks: 175,-1,-1,-1,-1,-1,-1,-1,-1,-1
Plural-Forms: nplurals=1; plural=0;
連線選項:
如需詳細資訊，請從 psql 中輸入 "\?"(用於內部命令) 或 "\help" (用於 SQL
命令)，或請參閱 PostgreSQL
文件的 psql 章節。
輸入和輸出選項:
輸出格式選項:
剖析器: "%s"
剖析器: "%s.%s" (選項: S = 顯示系統物件，+ = 其他詳細資料)
--help 顯示說明然後結束
--version 顯示版本資訊然後結束
-1 ("一"), --single-transaction
執行指令檔做為單一交易
-A, --no-align 使用非對齊資料表輸出模式
-E, --echo-hidden 顯示內部指令產生的查詢
-F, --field-separator=STRING
設定欄位分隔符號 (預設: "%s")
-H, --html HTML 表格輸出模式
-L, --log-file=FILENAME 將階段記錄傳送至檔案
-P, --pset=VAR[=ARG] 將列印選項 VAR 設為 ARG (請參閱 \pset 指令)
-R, --record-separator=STRING
設定記錄分隔符號(預設: 換行符號)
-S, --single-line 單行模式 (一行就是一個 SQL 指令列)
-T, --table-attr=TEXT 設定 HTML 表格標記屬性 (例如 width、border)
-U, --username=USERNAME 資料庫使用者名稱 (預設: "%s")
-W, --password 強制詢問密碼(應該會自動詢問)
-X, --no-psqlrc 不要讀取啟動檔 (~/.psqlrc)
-a, --echo-all 回饋所有來自指令檔的輸入
-c, --command=COMMAND 只執行單一指令 (SQL 或內部指令) 然後 結束。
-d, --dbname=DBNAME 指定要連線的資料庫名稱 (預設: "%s")
-e, --echo-queries 回饋傳送給伺服器的指令
-f, --file=FILENAME 從檔案中執行指令，然後結束
-h, --host=HOSTNAME 資料庫伺服器主機或通訊端目錄 (預設:"%s")
-l, --list 列出所有可用資料庫，然後結束
-n, --no-readline 關閉指令列加強編輯模式 (readline)
-o, --output=FILENAME 將查詢結果傳送至檔案 (或 | 管線)
-p, --port=PORT 資料庫伺服器埠號 (預設: "%s")
-q, --quiet 以安靜模式執行 (沒有訊息，只有查詢結果)
-s, --single-step 單步模式 (確認每個查詢)
-t, --tuples-only 只列印資料列
-v, --set=, --variable=NAME=VALUE
將 psql 變數 NAME 設為 VALUE
-w, --no-password 絕不提示密碼
-x, --expanded 開啟擴展資料表輸出
\! [COMMAND] 執行 shell 中的指令或啟動互動式 shell
\C [STRING] 設定資料表標題，如果沒有則不設定
\H 切換 HTML 輸出模式 (目前是 %s)
\T [STRING] 設定 HTML <table> 標記屬性，如果沒有則不設定
\a 在非對齊和對齊輸出模式之間切換
\c[onnect] [DBNAME|- USER|- HOST|- PORT|-]
連線至新資料庫 (目前是 "%s")
\cd [DIR] 變更目前的工作目錄
\conninfo 顯示目前連線資訊
\copy ... 執行 SQL COPY，將資料流傳送至用戶端 主機
\copyright 顯示 PostgreSQL 的使用和發行條款
\dC [PATTERN] 列出型別轉換
\dD[S] [PATTERN] 列出可用域
\dE[S+] [PATTERN] 列出 foreign 資料表
\dF[+] [PATTERN] 列出文本搜尋組態
\dFd[+] [PATTERN] 列出文本搜尋字典
\dFp[+] [PATTERN] 列出文本搜尋解譯器
\dFt[+] [PATTERN] 列出文本搜尋樣板
\dL[S+] [PATTERN] 列出程序語言
\dO[S+] [PATTERN] 列出定序
\dT[S+] [PATTERN] 列出資料型別
\d[S+] 列出資料表、視圖和序列
\d[S+] NAME 描述資料表、視圖、序列或索引
\da[S] [PATTERN] 列出彙總
\db[+] [PATTERN] 列出資料表空間
\dc[S] [PATTERN] 列出轉換
\dd[S] [PATTERN] 顯示物件的註解
\ddp [PATTERN] 列出預設權限
\des[+] [PATTERN] 列出外部伺服器
\det[+] [PATTERN] 列出 foreign 資料表
\deu[+] [PATTERN] 列出使用者對應
\dew[+] [PATTERN] 列出外部資料包裝函式
\df[antw][S+] [PATRN] 列出 [只列出彙總/一般/觸發程序/視窗] 函式
\dg[+] [PATTERN] 列出 role
\di[S+] [PATTERN] 列出索引
\dl 列出大型物件，與 \lo_list 相同
\dn[S+] [PATTERN] 列出 schema
\do[S] [PATTERN] 列出運算子
\dp [PATTERN] 列出資料表、視圖和序列的存取權限
\drds [PATRN1 [PATRN2]] 列出資料庫 role 設定
\ds[S+] [PATTERN] 列出序列
\dt[S+] [PATTERN] 列出資料表
\du[+] [PATTERN] 列出 role
\dv[S+] [PATTERN] 列出視圖
\dx[+] [PATTERN] 列出 extension
\e [FILE] [LINE] 用外部編輯器編輯查詢緩衝區(或檔案)
\echo [STRING] 將字串寫至標準輸出
\ef [FUNCNAME [LINE]] 用外部編輯器編輯函式定義
\encoding [ENCODING] 顯示或設定用戶端編碼
\f [STRING] 顯示或設定非對齊查詢輸出的欄位分隔符號
\g [FILE] 或 ; 執行查詢 (並將結果傳送至檔案或 | 管線)
\h [NAME] SQL 指令語法說明，用 * 顯示全部 指令說明
\i FILE 從檔案中執行指令
\l[+] 列出所有資料庫
\lo_export LOBOID FILE
\lo_import FILE [COMMENT]
\lo_list
\lo_unlink LOBOID 大型物件運算子
\o [FILE] 將所有查詢結果傳送至檔案或 | 管線
\p 顯示查詢緩衝區的內容
\password [USERNAME] 安全地變更使用者密碼
\prompt [TEXT] NAME 提示使用者設定內部變數
\pset NAME [VALUE] 設定資料表輸出選項
(NAME := {format|border|expanded|fieldsep|footer|null|
numericlocale|recordsep|tuples_only|title|tableattr|pager})
\q 結束 psql
\qecho [STRING] 將字串寫至查詢輸出串流 (請參閱 \o)
\r 重置 (清空) 查詢緩衝區
\s [FILE] 顯示歷史記錄或將它儲存至檔案
\set [NAME [VALUE]] 設定內部變數，如果沒有參數則列出所有變數
\sf[+] FUNCNAME 顯示函式定義
\t [on|off] 只顯示資料列 (目前是 %s)
\timing [on|off] 切換指令計時開關 (目前是 %s)
\unset NAME 取消設定 (刪除) 內部變數
\w FILE 將查詢緩衝區寫至檔案
\x [on|off] 切換擴展輸出模式 (目前是 %s)
\z [PATTERN] 與 \dp 相同
psql [OPTION]...[DBNAME [USERNAME]]
%d 連線 %s %s (%s，伺服器 %s)
%s: %s
%s: 無法從目錄複製或複製到目錄
%s: 無法刪除變數 "%s"
%s: 無法開啟日誌檔 "%s": %s
%s: 無法設定列印參數 "%s"
%s: 無法設定變數 "%s"
%s: 目前的交易被中止
%s: 無效的編碼名稱或找不到轉換程序
%s: 尚未連線至資料庫
%s: pg_strdup : 無法複製空指標 (內部錯誤)
%s: 不明交易狀態
%s: 警告: 忽略多餘的命令列參數 "%s"
(%lu 筆資料列) (無資料列)
***(單步(Single step)模式: 驗證命令)*******************************************
%s
***(按 Enter 鍵繼續或鍵入 x 來取消)********************
********* 查詢 **********
%s
**************************
, 已叢集 , deferrable , initially deferred , 無效的 , 敘述 (%s) ，資料表空間 "%s" 存取權限 參數資料型別 收到來自伺服器 "%s" 進程 PID %d 非同步通知。
從伺服器行程 PID %3$d 收到非同步通知 "%1$s" 和 payload "%2$s"。
屬性 可用說明:
邊界風格為 %d。
COPY 資料轉換失敗: %s Call Handler 無法將資料格新增至資料表內容: 超過資料格總計 %d。
無法將標題新增至資料表內容: 超過資料行計數 %d。
無法登入 檢查 檢查條件約束 子資料表 Collate 欄位 資料行存取權限 命令: %s
說明: %s
語法:
%s
合成型別 "%s.%s" 連線
建立 DB 建立角色 轉換型別 預設存取權限 關閉預設步進器(Footer)。 打開預設步進器(Footer)。 預設？ 定義 描述 目的地 字典 沒有找到任何名稱為 "%s" 的 extension。
沒有找到任何 extension。
沒有找到任何名稱為 "%s" 的關聯。
沒有找到任何OID為 %s 的關聯。
沒有找到任何命名為 "%s" 的文本搜尋組態。
沒有找到任何命名為 "%s" 的文本剖析器。
已停用規則: 停用觸發器: EDITOR_LINENUMBER_SWITCH 變數必需設定行號
元素 字元編碼 結束剖析 輸入要複製的資料並且換行。
在獨立的一行上輸入一個反斜線和一個句點結束。 再次輸入: 輸入新密碼: 擴展顯示已關閉。
擴展顯示已打開。
失敗。
欄位分隔符號是 "%s"。
foreign 資料表 "%s.%s" 外部資料包裝函式 外鍵條件約束: 格式化
函數 一般性
一般選項:
取得首行 取得下一個標誌符 取得標誌符型別 Handler 有 OID ID 隱含的? 索引 "%s.%s" 索引: 資訊性
繼承 初始化 初始選項 Inline Handler 輸入/輸出
內部語言 內部名稱 已中斷
無效的命令 \%s，用 \? 顯示說明。
程序語言 大型物件
大型物件 左參數型別 Lexize 行風格為 %s。
聚集函數列表 型別轉換清單 定序清單 conversion 清單 資料型別清單 資料庫清單 domain 清單 外部伺服器清單 foreign 資料表清單 外部資料包裝函式清單 函式清單 已安裝擴充功能清單 程序語言清單 運算子清單 relation 清單 角色清單 schema 清單 設定清單 表空間列表 全文檢索組態清單 全文檢索字典清單 全文檢索剖析器清單 全文檢索模板清單 使用者對應列表 區域調整後的數字輸出已關閉。 所在地 成員屬於 方法 修飾詞 修飾詞 名稱 沒有變更 無連線 沒有 "%s" 的說明。
嘗試用沒有參數的 \h 顯示目前可用的說明。
無繼承 沒有找到符合的關聯。
沒有找到符合的設定。
此伺服器版本不支援獨立資料庫 role 設定。
找不到關聯。
找不到設定。
"%s" 是空值顯示。
子資料表數量: %d (用 \d+ 列出。) 物件 物件描述 物件描述 extension "%s" 中的物件 作業系統
選項 輸出格式為 %s。
擁有者 總是使用分頁顯示。 使用分頁顯示大量資料。 不使用分頁顯示。 密碼加密失敗。
用戶 %s 的密碼: 密碼: 密碼不符。
保留上一次連線
查詢緩存區
查詢緩存區是空的。 查詢緩存區重置(清空)。 記錄分隔符號是 "%s"。
記錄分隔符號是 <newline>。 參考者: 複製 回報錯誤至<pgsql-bugs@postgresql.org>。
結果資料型別 結果型別 右參數型別 角色名稱 永遠引發規則: 只在複本引發規則: 規則: SSL 連線 (密文: %s，位元: %i)
SSL 連線 (不明密文)
架構模式 序列數 "%s.%s" 伺服器 顯示區域調整後的數字輸出。 只顯示 Tuples。 大小 來源 原始程式 來源型別 特殊關聯 "%s.%s" 開始剖析 儲存 完成。
超級用戶 TOAST 資料表 "%s.%s" 資料表 資料表 "%s.%s" 資料表屬性是 "%s"。
未設置資料表屬性。
表空間 資料表空間: "%s" 目標型別 "wrapped" 格式的目標寬度是 %d。
模版 文本搜尋組態 "%s" 文本搜尋組態 "%s.%s" 文本搜尋剖析器 "%s" 文本搜尋剖析器 "%s.%s" 與伺服器的連線已遺失，嘗試重置: 伺服器(版本 %d.%d) 不支援修改預設權限。
伺服器(版本 %d.%d) 不支援 extension。
伺服器 (版本 %d.%d) 不支援外部伺服器。
伺服器(版本 %d.%d) 不支援 foreign 資料表。
伺服器 (版本 %d.%d) 不支援外部資料包裝函式。
伺服器 (版本 %d.%d) 不支援文本搜尋。
伺服器 (版本 %d.%d) 不支援 ON_ERROR_ROLLBACK 的儲存點。
伺服器 (版本 %d.%d) 不支援資料表空間。
伺服器 (版本 %d.%d) 不支援使用者對應。
時間: %.3f ms
停止計時功能. 啟用計時功能. 標題是 "%s"。
無標題。
標誌符 標誌名稱 標誌符型別給剖析器 "%s" 標誌符別型給剖析器 "%s.%s" 永遠引發觸發程序: 只在複本引發觸發程序: 觸發器: 信任的 嘗試 "%s --help" 以得到更多資訊。
關閉只顯示 Tuples。 型別 輸入 "help" 顯示說明。
輸入: \copyright 顯示發行條款
\h 顯示 SQL 指令的說明
\? 顯示 psql 指令的說明
\g 或者以分號 (;) 結尾以執行查詢
\q 結束
無日誌索引 "%s.%s" 無日誌資料表 "%s.%s" 使用方法:
使用 "\q" 離開 %s。
使用者名稱 驗證程式 值 變數
版本 視觀表 "%s.%s" 視圖定義: 揮發性 警告: %s 版本 %d.%d，伺服器版本 %d.%d。
某些 psql 功能可能無法運作。
警告: 主控台字碼頁 (%u) 不同於 Windows 字碼頁 (%u)
8 位元字元可能無法正常運作。請參閱 psql 參考
頁 "Windows 使用者注意事項" 取得更多資訊。
書寫歷程到檔案 "%s/%s".
已經連線到資料庫 "%s"，使用者 "%s"，主機 "%s"，連接埠 "%s"。
已經連線到資料庫 "%s"，使用者 "%s"，經由 "%s" 的 socket，連接埠 "%s"。
目前沒有連線至資料庫。
目前沒有連線。
已經連線到資料庫 "%s"，使用者 "%s"，主機 "%s"，連接埠 "%s"。
已經連線到資料庫 "%s"，使用者 "%s"，經由 "%s" 的 socket，連接埠 "%s"。
已經連線到資料庫 "%s"，使用者 "%s"。
您正在使用 PostgreSQL 指令列介面 psql。 \!: 失敗
\%s: 無法切換目錄至 "%s": %s
\%s: 錯誤
\%s: 忽略多餘的參數 "%s"
\%s: 缺少所需參數
\connect: %s \copy: %s \copy: 需要參數
\copy: 在 "%s" 發生解讀錯誤
\copy: 在行尾發生解讀錯誤
\copy: 意外回應 (%d)
\df 不接受 "w" 選項搭配伺服器版本 %d.%d
\df 只接受 [antwS+] 做為選項
\pset: 允許的格式為 unaligned、aligned、wrapped、html、latex、troff-ms
\pset: 允語的行風格為 ascii、old-ascii、unicode
\pset: 不明選項: %s
abbreviated_grant_or_revoke 中止目前的交易 因讀取失敗已被中止 action agg agg_name agg_type 聚集函數 alias alignment analyze_function 並且 like_option 是: 並且 table_constraint 是: 並且 table_constraint_using_index 是: 並且 with_query 是: arg_name arg_type argmode argname argtype argument argument_type arguments 屬性 attribute_name attribute_option base_type boolean cache call_handler 取消先前為兩階段認可準備的交易 被用戶取消 找不到暫存目錄: %s category 變更資料庫 變更資料庫角色 更改執行時期參數 變更角色名稱或成員 變更定序的定義 變更 conversion 的定義 變更 domain 的定義 變更外部伺服器的定義 變更 foreign 資料表的定義 變更外部資料包裝函式的定義 變更函式的定義 變更 large object 的定義 變更程序語言的定義 變更 schema 的定義 變更序列數產生器的定義 變更資料表的定義 變更資料表空間的定義 變更全文檢索組態的定義 變更全文檢索字典的定義 變更全文檢索剖析器的定義 變更全文檢索模板的定義 變更觸發器的定義 變更資料型別的定義 變更使用者對應的定義 變更檢視表的定義 變更彙總函式的定義 變更 extension 的定義 變更索引的定義 變更運算子的定義 變更運算子類別的定義 變更運算子家族的定義 變更資料庫角色的資料庫物件所有權 channel 子進程結束，結束代碼 %d 子進程結束，不明狀態代碼 %d 子進程被例外(exception) 0x%X 終止 子進程被信號 %d 終止 子進程被信號 %s 終止 關閉 cursor 根據索引將資料表叢集 code collatable collate %s 定序 收集資料庫統計資料 column column_alias column_constraint column_definition column_name column_type com_op command 提交一項事務交易這是兩階段提交的先前準備 確認目前的事物交易 計算資料列的集合 condition configuration_parameter 與資料庫的連線遺失
connlimit constraint constraint_name 包含命令列編輯支援 在檔案和資料表間複製資料 無法切換目錄至 "%s" 未能找到 "%s" 來執行 無法取得目前用戶名稱: %s
無法取得 home 目錄: %s
無法識別目前目錄: %s 無法開啟暫存檔 "%s": %s
無法讀取二進制碼 "%s" 無法從輸入檔案讀取: %s
無法讀取符號連結 "%s" 無法將歷史記錄儲存到 "%s": %s
無法啟動 /bin/sh
無法啟動編輯器 "%s"
無法寫入 COPY 資料: %s
count 建立新資料庫 在資料表中建立資料 cursor_name 資料型別 data_type database_name 釋放已預備好的敘述區塊 default 預設值 %s default_expr 建立 cursor 建立新彙總函數 建立新型別轉換 建立新定序 建立新資料型別 建立新資料庫角色 建立新 domain 建立新 conversioin 建立新外部伺服器 建立新 foreign 資料表 定義新的外部資料包裝函式 建立新函式 建立新索引 建立使用者至外部伺服器的新對應 建立新運算子 建立新運算子類別 建立新運算子家族 建立新程序語言 建立新重寫規則 在目前的事物交易中建立新的儲存點(Savepoint) 建立新 schema 建立新序列數產生器 建立新資料表 以查詢結果建立新資料表 建立新資料表空間 建立新全文檢索組態 建立新全文檢索字典 建立新全文檢索剖析器 建立新全文檢索模板 建立新觸發器 建立新檢視表 建立存取權限 定義預設存取權限 定義或變更物件的安全性標籤 建立或更改物件的註解 definition delete 刪除資料表中的資料列 delimiter delimiter_character dest_encoding 刪除先前建立的儲存點(Savepoint) dictionary_name direction directory 拋棄 session 狀態 domain_constraint element 空的資料表或資料表設置 encoding encoding_name end_function escape_character event exclude_element EXCLUDE 約束條件的 exclude_element 是: 執行 prepared 陳述式 執行匿名程式塊 execution_cost existing_collation existing_enum_value expression extension_name family_name fdw_name ffunc filename 給資料表 "%s.%s" 強制交易日誌檢查點 foreign table format_name from_item from_list 函數 需要函式名稱
function_name 垃圾收集(GC)並選擇性的分析資料庫 產生通告 gettoken_function group_name handler_function headline_function 這個安裝不支援命令記錄
不可變 在指派中 increment 索引 index_method index_name index_parameters UNIQUE, PRIMARY KEY, and EXCLUDE 條件約束的 index_parameters 是: init_function initial_condition inline_handler input_data_type input_function insert 安裝擴充功能 整數 internallength 無效的二進制碼 "%s" 無效的命令 \%s
無效的行號: %s
無效的輸出格式 (內部錯誤): %d join_column join_condition join_proc join_type label lang_name large_object_oid lc_collate lc_ctype left_type lexize_function lextypes_function like_option like_type link_symbol 等待通知 載入共用程式庫檔案 本地接口 locale 鎖住資料表 lockmode loid maxvalue member_object 方法 minvalue 名稱 neg_op new_attribute_name new_column new_dictionary new_enum_value new_name new_owner new_role new_schema new_table new_tablespace new_version 否 沒有查詢緩存區
normal 非 Null null_string obj_file object_name 關閉 old_dictionary old_role 舊版本 開啟 op_type opclass 運算子 operator_name 選項 或是舊語法 記憶體用盡 記憶體用盡
output_expression output_function output_name parameter parent_table parser_name 密碼 payload 移動游標位置 predicate preferred 預先編譯敘述以執行 預備當前事務交易的二段式提交 主鍵, provider psql 是 PostgreSQL 文字模式介面。
query quote_character 重新建構索引 receive_function refcolumn referenced_table_name reftable 除除型別轉換 刪除定序 刪除 conversion 刪除資料型別 刪除資料庫 刪除資料庫角色 刪除 domain 刪除外部伺服器描述子 刪除 foreign 資料表 刪除外部資料包裝函式 除除函式 刪除程序語言 刪除重寫規則 刪除 schema 刪除序列數 刪除資料表 刪除資料表空間 刪除全文檢索組態 刪除全文檢索字典 刪除全文檢索剖析器 刪除全文檢索模板 刪除觸發器 刪除外部伺服器的使用者對應 刪除檢視表 移除存取權限 刪除彙總函數 刪除擴充功能 刪除索引 刪除運算子 刪除運算子類別 刪除運算子家族 刪除資料庫角色擁有的資料庫物件 res_proc restart 將執行時期參數還原成預設值 result_rows 從使用游標的查詢讀取資料 從資料表或視觀表讀取資料 rettype rewrite_rule_name right_type role_name 還原至儲存點 規則 rule_name savepoint_name schema schema_element schema_name select send_function 序列數 sequence_name server_name server_type server_version 設定目前交易的條件約束檢查時機 設定目前事物交易屬性 設置當前 session 的當前用戶的身份標識 設定階段使用者識別字以及目前階段的目前使用者 識別字 sfunc 顯示陳述式的執行計劃 顯示執行時期的參數值 sort_expression sort_family_name sort_operator source_config source_encoding source_type 特殊 穩定 start 開始交易區塊 start_function state_data_type 陳述式 停止傾聽通告 storage storage_parameter storage_type strategy_number support_number table table_constraint table_constraint_using_index table_name tablespace tablespace_name tablespace_option target_role target_type template text timestamp timezone token_type transaction_id transaction_mode trigger trigger_name 正在嘗試結束複製模式 type type_modifier_input_function type_modifier_output_function type_name uid 唯一的, update 更新資料表中的資料列 user_name using_list valfunction validator_function value 版本 view volatile 其中 abbreviated_grant_or_revoke 是: 其中 action 是: 其中 column_constraint 是: 其中 constraint 是: 其中 direction 可以是空的或是: 其中 event 是: 其中 from_item 可以是: 其中 lockmode 可以是: 其中 member_object 是: 其中 option 是: 其中選項可以是: 其中 transaction_mode 是: window window_definition window_name with_query with_query_name 是 locale/fr/LC_MESSAGES/ecpg-9.6.mo 0000644 00000035731 14751153421 0012000 0 ustar 00 �� { � � � h
~ i
- �
0 + G g s � 4 � 7 0 s h . � G
4 S
) �
w �
4 * _ @ r = � , � ! @ , ^ 1 � * � - � 1 ' H & p + � " � # �
) = < z � & � < � ! & - 0 + ^ " � � , � � * 3 " ^ ' � � � ! � � ! 5 J 3 k / � ' � ) � * ! 5 L I � , � / � * ) T T ' � � � 1 - K , y , � 5 � ) % ? O 8 � � � _ 0 y 5 � � A � L 7 + �
� 6 � ' � # A ( N 4 w ) � � / � # < $ ] � " � , � � ' " J i $ � D � + � ? 0 Z � 8 � � & F � g � 2! 6 �! > " . ^" | �" "
# F -# . t# � �# ? %$ g e$ C �$ 2 % � D% C �% !& M =& B �& > �& 0
' ( >' = g' < �' 5 �' 8 ( < Q( 2 �( 1 �( 6 �( # *) ) N) x) 1 �) Q �)
* * 2 .* ] a* $ �* �* < �* @ .+ 3 o+ �+ 1 �+ & �+ $ , ; B, A ~, 7 �, �, # - . :- ! i- * �- �- �- A �- ; .. - j. 3 �. / �. C �. W @/ 3 �/ 8 �/ 6 0 g <0 , �0 �0 �0 1 )1 D1 5 c1 4 �1 4 �1 E 2 I2 6 a2 Z �2 J �2 � >3 ! �3 Q 4 9 `4 �4 \ �4 n 5 ; 5 �5 = �5 N 6 , [6 �6 3 �6 A �6 - 7 # >7 ? b7 �7 1 �7 1 �7 8 ' ;8 9 c8 �8 " �8 - �8 (
9 & 39 3 Z9 i �9 8 �9 M 1: 8 : * �: J �: ) .; ) X; / �; & �; j 4 f g ? ^ l x
T ( 9 u 8 _ L t I d \ % ) < i = ' Q N & : M v , 7 B . z ; S n # > P " H r ] [ ! * s Z 6 G A O - X 2 q 3 W w 1 k + U e Y o K p 0 a J 5 { h c m E C @ V F D y R / ` $
b
If no output file is specified, the name is formed by adding .c to the
input file name, after stripping off .pgc if present.
Report bugs to <pgsql-bugs@postgresql.org>.
--regression run in regression testing mode
-?, --help show this help, then exit
-C MODE set compatibility mode; MODE can be one of
"INFORMIX", "INFORMIX_SE"
-D SYMBOL define SYMBOL
-I DIRECTORY search DIRECTORY for include files
-V, --version output version information, then exit
-c automatically generate C code from embedded SQL code;
this affects EXEC SQL TYPE
-d generate parser debug output
-h parse a header file, this option includes option "-c"
-i parse system include files as well
-o OUTFILE write result to OUTFILE
-r OPTION specify run-time behavior; OPTION can be:
"no_indicator", "prepare", "questionmarks"
-t turn on autocommit of transactions
%s at or near "%s" %s is the PostgreSQL embedded SQL preprocessor for C programs.
%s, the PostgreSQL embedded C preprocessor, version %d.%d.%d
%s: could not locate my own executable path
%s: could not open file "%s": %s
%s: no input files specified
%s: parser debug support (-d) not available
AT option not allowed in CLOSE DATABASE statement AT option not allowed in CONNECT statement AT option not allowed in DISCONNECT statement AT option not allowed in SET CONNECTION statement AT option not allowed in TYPE statement AT option not allowed in VAR statement AT option not allowed in WHENEVER statement COPY FROM STDIN is not implemented CREATE TABLE AS cannot specify INTO ERROR: EXEC SQL INCLUDE ... search starts here:
Error: include path "%s/%s" is too long on line %d, skipping
Options:
SHOW ALL is not implemented Try "%s --help" for more information.
Unix-domain sockets only work on "localhost" but not on "%s" Usage:
%s [OPTION]... FILE...
WARNING: arrays of indicators are not allowed on input could not open include file "%s" on line %d could not remove output file "%s"
cursor "%s" does not exist cursor "%s" has been declared but not opened cursor "%s" is already defined descriptor "%s" does not exist descriptor header item "%d" does not exist descriptor item "%s" cannot be set descriptor item "%s" is not implemented end of search list
expected "://", found "%s" expected "@" or "://", found "%s" expected "@", found "%s" expected "postgresql", found "%s" incomplete statement incorrectly formed variable "%s" indicator for array/pointer has to be array/pointer indicator for simple data type has to be simple indicator for struct has to be a struct indicator struct "%s" has too few members indicator struct "%s" has too many members indicator variable "%s" is hidden by a local variable indicator variable "%s" is hidden by a local variable of a different type indicator variable must have an integer type initializer not allowed in EXEC SQL VAR command initializer not allowed in type definition internal error: unreachable state; please report this to <pgsql-bugs@postgresql.org> interval specification not allowed here invalid bit string literal invalid connection type: %s invalid data type key_member is always 0 missing "EXEC SQL ENDIF;" missing identifier in EXEC SQL DEFINE command missing identifier in EXEC SQL IFDEF command missing identifier in EXEC SQL UNDEF command missing matching "EXEC SQL IFDEF" / "EXEC SQL IFNDEF" more than one EXEC SQL ELSE multidimensional arrays are not supported multidimensional arrays for simple data types are not supported multidimensional arrays for structures are not supported multilevel pointers (more than 2 levels) are not supported; found %d level multilevel pointers (more than 2 levels) are not supported; found %d levels nested /* ... */ comments nested arrays are not supported (except strings) no longer supported LIMIT #,# syntax passed to server nullable is always 1 only data types numeric and decimal have precision/scale argument only protocols "tcp" and "unix" and database type "postgresql" are supported operator not allowed in variable definition out of memory pointer to pointer is not supported for this data type pointers to varchar are not implemented subquery in FROM must have an alias syntax error syntax error in EXEC SQL INCLUDE command too many levels in nested structure/union definition too many nested EXEC SQL IFDEF conditions type "%s" is already defined type name "string" is reserved in Informix mode unmatched EXEC SQL ENDIF unrecognized data type name "%s" unrecognized descriptor item code %d unrecognized token "%s" unrecognized variable type code %d unsupported feature will be passed to server unterminated /* comment unterminated bit string literal unterminated hexadecimal string literal unterminated quoted identifier unterminated quoted string using unsupported DESCRIBE statement using variable "%s" in different declare statements is not supported variable "%s" is hidden by a local variable variable "%s" is hidden by a local variable of a different type variable "%s" is neither a structure nor a union variable "%s" is not a pointer variable "%s" is not a pointer to a structure or a union variable "%s" is not an array variable "%s" is not declared variable "%s" must have a numeric type zero-length delimited identifier Project-Id-Version: PostgreSQL 9.6
Report-Msgid-Bugs-To: pgsql-bugs@postgresql.org
POT-Creation-Date: 2018-02-04 22:38+0000
PO-Revision-Date: 2018-02-10 17:46+0100
Last-Translator: Guillaume Lelarge <guillaume@lelarge.info>
Language-Team: PostgreSQLfr <pgsql-fr-generale@postgresql.org>
Language: fr
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Plural-Forms: nplurals=2; plural=(n > 1);
X-Generator: Poedit 2.0.3
Si aucun nom de fichier en sortie n'est fourni, le nom est formaté en
ajoutant le suffixe .c au nom du fichier en entrée après avoir supprimé le
suffixe .pgc s'il est présent
Rapporter les bogues à <pgsql-bugs@postgresql.org>.
--regression s'exécute en mode de tests des régressions
-?, --help affiche cette aide et quitte
-C MODE configure le mode de compatibilité ; MODE peut être
« INFORMIX » ou « INFORMIX_SE »
-D SYMBOLE définit SYMBOLE
-I RÉPERTOIRE recherche les fichiers d'en-têtes dans RÉPERTOIRE
-V, --version affiche la version et quitte
-c produit automatiquement le code C à partir du code SQL
embarqué ; ceci affecte EXEC SQL TYPE
-d produit la sortie de débogage de l'analyseur
-h analyse un fichier d'en-tête,
cette option inclut l'option « -c »
-i analyse en plus les fichiers d'en-tête systèmes
-o FICHIER écrit le résultat dans FICHIER
-r OPTION indique le comportement à l'exécution ; OPTION peut valoir :
« no_indicator », « prepare », « questionmarks »
-t active la validation automatique des transactions
%s sur ou près de « %s » %s est le préprocesseur SQL embarqué de PostgreSQL pour les programmes C.
%s, le préprocesseur C embarqué de PostgreSQL, version %d.%d.%d
%s : n'a pas pu localiser le chemin de mon propre exécutable
%s : n'a pas pu ouvrir le fichier « %s » : %s
%s : aucun fichier précisé en entrée
%s : support de débogage de l'analyseur (-d) non disponible
option AT non autorisée dans une instruction CLOSE DATABASE option AT non autorisée dans une instruction CONNECT option AT non autorisée dans une instruction DISCONNECT option AT non autorisée dans une instruction SET CONNECTION option AT non autorisée dans une instruction TYPE option AT non autorisée dans une instruction VAR option AT non autorisée dans une instruction WHENEVER COPY FROM STDIN n'est pas implanté CREATE TABLE AS ne peut pas indiquer INTO ERREUR : la recherche EXEC SQL INCLUDE ... commence ici :
Erreur : le chemin d'en-tête « %s/%s » est trop long sur la ligne %d,
ignoré
Options :
SHOW ALL n'est pas implanté Essayer « %s --help » pour plus d'informations.
les sockets de domaine Unix fonctionnent seulement sur « localhost », mais pas sur « %s » Usage:
%s [OPTION]... FICHIER...
ATTENTION : les tableaux d'indicateurs ne sont pas autorisés en entrée n'a pas pu ouvrir le fichier d'en-tête « %s » sur la ligne %d n'a pas pu supprimer le fichier « %s » en sortie
le curseur « %s » n'existe pas le curseur « %s » est déclaré mais non ouvert le curseur « %s » est déjà défini le descripteur « %s » n'existe pas l'élément d'en-tête du descripteur « %d » n'existe pas l'élément du descripteur « %s » ne peut pas être initialisé l'élément du descripteur « %s » n'est pas implanté fin de la liste de recherche
« :// » attendu, « %s » trouvé « @ » ou « :// » attendu, « %s » trouvé « @ » attendu, « %s » trouvé « postgresql » attendu, « %s » trouvé instruction incomplète variable « %s » mal formée l'indicateur pour le tableau/pointeur doit être tableau/pointeur l'indicateur d'un type de données simple doit être simple l'indicateur d'un struct doit être un struct le struct indicateur « %s » a trop peu de membres le struct indicateur « %s » a trop de membres la variable indicateur « %s » est cachée par une variable locale la variable indicateur « %s » est caché par une variable locale d'un type
différent la variable d'indicateur doit avoir un type integer initialiseur non autorisé dans la commande EXEC SQL VAR initialiseur non autorisé dans la définition du type erreur interne : l'état ne peut être atteint ; merci de rapporter ceci à
<pgsql-bugs@postgresql.org> interval de spécification non autorisé ici chaîne bit litéral invalide type de connexion invalide : %s type de données invalide key_member vaut toujours 0 « EXEC SQL ENDIF; » manquant identifiant manquant dans la commande EXEC SQL DEFINE identifiant manquant dans la commande EXEC SQL IFDEF identifiant manquant dans la commande EXEC SQL UNDEF correspondance manquante « EXEC SQL IFDEF » / « EXEC SQL IFNDEF » plusieurs EXEC SQL ELSE les tableaux multidimensionnels ne sont pas supportés les tableaux multi-dimensionnels pour les types de données simples ne sont
pas supportés les tableaux multidimensionnels ne sont pas supportés pour les structures les pointeurs multi-niveaux (plus de deux) ne sont pas supportés :
%d niveau trouvé les pointeurs multi-niveaux (plus de deux) ne sont pas supportés :
%d niveaux trouvés commentaires /* ... */ imbriqués les tableaux imbriqués ne sont pas supportés (sauf les chaînes de
caractères) la syntaxe obsolète LIMIT #,# a été passée au serveur nullable vaut toujours 1 seuls les types de données numeric et decimal ont des arguments de
précision et d'échelle seuls les protocoles « tcp » et « unix » et les types de base de données
« postgresql » sont supportés opérateur non autorisé dans la définition de la variable mémoire épuisée ce type de données ne supporte pas les pointeurs de pointeur les pointeurs sur des chaînes de caractères (varchar) ne sont pas implantés la sous-requête du FROM doit avoir un alias erreur de syntaxe erreur de syntaxe dans la commande EXEC SQL INCLUDE trop de niveaux dans la définition de structure/union imbriquée trop de conditions EXEC SQL IFDEF imbriquées le type « %s » est déjà défini le nom du type « string » est réservé dans le mode Informix EXEC SQL ENDIF différent nom « %s » non reconnu pour un type de données code %d de l'élément du descripteur non reconnu jeton « %s » non reconnu code %d du type de variable non reconnu la fonctionnalité non supportée sera passée au serveur commentaire /* non terminé chaîne bit litéral non terminée chaîne hexadécimale litérale non terminée identifiant entre guillemet non terminé chaîne entre guillemets non terminée utilisation de l'instruction DESCRIBE non supporté l'utilisation de la variable « %s » dans différentes instructions de déclaration
n'est pas supportée la variable « %s » est cachée par une variable locale la variable « %s » est cachée par une variable locale d'un type différent la variable « %s » n'est ni une structure ni une union la variable « %s » n'est pas un pointeur la variable « %s » n'est pas un pointeur vers une structure ou une union la variable « %s » n'est pas un tableau la variable « %s » n'est pas déclarée la variable « %s » doit avoir un type numeric identifiant délimité de taille zéro locale/fr/LC_MESSAGES/pgscripts-9.6.mo 0000644 00000071517 14751153421 0013102 0 ustar 00 �� � � � @ K A �
� > � > � = , - j � � C 0 A t � � # � ( I I f E � � > v ; � = � : / < j 9 � 6 � 5 C N C � 9 � 4 E E = � . � ; � E 4 : z ? � A � < 7 9 t 7 � 4 � L J h 3 � H � E 0 B v A � 5 � 2 1 N d 7 � 2 � 2 J Q : � 5 � G
0 U < � 0 � ) � M J l G � 4 � C 4! H x! E �! D " = L" v �" < # � ># Q �# I $ @ ^$ 5 �$ 4 �$ 1
% 0 <% ; m% 5 �% ' �% 6 & 3 >& 9 r& @ �& ; �& ; )' ` e' 8 �' 2 �' 9 2( 6 l( > �( �( / �( < ) # [) # ) ? �) 8 �) % * # B* f* 3 �* & �* �* E �* 6 .+ E e+ F �+ K �+ 7 >, K v, 7 �, J �, 6 E- < |- D �- 5 �- 4. * R. 8 }. 6 �. ( �. 4 / $ K/ # p/ �/ �/ - �/ 8 0 4 <0 $ q0 �0 , �0 , �0 ( 1 / 91 ; i1 9 �1 ! �1 2 \ 2 s2 �2 * �2 8 �2 9 3 , B3 8 o3 # �3 4 �3 . 4 04 ) M4 7 w4 �4
�4 �4 C �4 A +5 ! m5 + �5 �5 �5 �5 6 . #6 3 R6 2 �6 �6 �6 �6
�6 �6 7 )7 ' >7 " f7 2 �7 7 �7 �7 & �7 $8 ,8 / C8 + s8 * �8 �8 �8 �8 �8 �8 �8 9 9 ( +9 T9 V9 � Z9 P #; t; �; N �; J �; I 3< 6 }< � �< P �= N �= 5> G> a> �> & �> �> r �> x N? � �? D _@ D �@ | �@ v fA A �A @ B @ `B @ �B � �B O dC A �C A �C v 8D C �D C �D H 7E x �E J �E U DF w �F R G E eG E �G E �G 7H � �H E :I A �I @ �I @ J @ DJ D �J D �J � K u �K J L H \L � �L r -M M �M ~ �M B mN H �N @ �N 2 :O M mO L �O L P ? UP M �P � �P � gQ � �Q D pR � �R { @S � �S � �T Q U s `U J �U F V F fV F �V 9 �V 8 .W ; gW A �W @ �W M &X I tX D �X K Y � OY / Z . FZ G uZ G �Z O [ U[ 8 a[ x �[ + \ & ?\ M f\ D �\ / �\ . )] " X] < {] 1 �] �] p �] b c^ ` �^ c '_ d �_ \ �_ j M` a �` g a ` �a O �a n 3b j �b M
c _ [c u �c P 1d ; �d J �d 4 e 1 >e 8 pe 9 �e 8 �e O f O lf . �f . �f > g 2 Yg 0 �g F �g I h G Nh 3 �h �h ~ �h ii 3 �i E �i [ j [ ]j = �j \ �j 5 Tk H �k 6 �k ;
l L Fl c �l �l m "m h Bm ` �m 0 n > =n $ |n $ �n & �n / �n 9 o D Wo D �o �o �o ' �o p * )p ) Tp ~p 2 �p + �p C �p @ 7q xq 2 �q �q �q 7 �q @ !r / br �r �r �r �r �r �r �r �r ? s Is Ks � Z 9 � � t � � � I S � w & % � � � � G � � - . � � X � { � " � 7 � o � � < � � � L � 4 / K i u � J � ~ B m � ( � � * �
n f H p � # D g @ ' > � � U � v � x [ � 3
N � � k ! � 8 , � Y F ; � � z � � � T � � 6 r M � + a 2 W � � $ ] _ � � } = s � j � � ? � ` � c | � l \ V � � � � � E ) : q � � Q C b 1 0 h A y � d R � ^ O � � � � � � � 5 � � � e P
By default, a database with the same name as the current user is created.
Connection options:
Options:
Read the description of the SQL command CLUSTER for details.
Read the description of the SQL command REINDEX for details.
Read the description of the SQL command VACUUM for details.
Report bugs to <pgsql-bugs@postgresql.org>.
--analyze-in-stages only update optimizer statistics, in multiple
stages for faster results; no vacuum
--lc-collate=LOCALE LC_COLLATE setting for the database
--lc-ctype=LOCALE LC_CTYPE setting for the database
%s [OPTION]...
%s [OPTION]... DBNAME
%s [OPTION]... LANGNAME [DBNAME]
%s [OPTION]... [DBNAME]
%s [OPTION]... [DBNAME] [DESCRIPTION]
%s [OPTION]... [ROLENAME]
--if-exists don't report error if database doesn't exist
--if-exists don't report error if user doesn't exist
--interactive prompt for missing role name and attributes rather
than using defaults
--maintenance-db=DBNAME alternate maintenance database
--maintenance-db=DBNAME alternate maintenance database
--no-replication role cannot initiate replication
--replication role can initiate replication
-?, --help show this help, then exit
-?, --help show this help, then exit
-?, --help show this help, then exit
-?, --help show this help, then exit
-D, --no-createdb role cannot create databases (default)
-D, --tablespace=TABLESPACE default tablespace for the database
-E, --encoding=ENCODING encoding for the database
-E, --encrypted encrypt stored password
-F, --freeze freeze row transaction information
-I, --no-inherit role does not inherit privileges
-L, --no-login role cannot login
-N, --unencrypted do not encrypt stored password
-O, --owner=OWNER database user to own the new database
-P, --pwprompt assign a password to new role
-R, --no-createrole role cannot create roles (default)
-S, --no-superuser role will not be superuser (default)
-S, --schema=SCHEMA reindex specific schema(s) only
-T, --template=TEMPLATE template database to copy
-U, --username=USERNAME user name to connect as
-U, --username=USERNAME user name to connect as
-U, --username=USERNAME user name to connect as (not the one to create)
-U, --username=USERNAME user name to connect as (not the one to drop)
-U, --username=USERNAME user name to connect as
-V, --version output version information, then exit
-V, --version output version information, then exit
-V, --version output version information, then exit
-V, --version output version information, then exit
-W, --password force password prompt
-W, --password force password prompt
-Z, --analyze-only only update optimizer statistics; no vacuum
-a, --all vacuum all databases
-a, --all cluster all databases
-a, --all reindex all databases
-c, --connection-limit=N connection limit for role (default: no limit)
-d, --createdb role can create new databases
-d, --dbname=DBNAME database to vacuum
-d, --dbname=DBNAME database from which to remove the language
-d, --dbname=DBNAME database to cluster
-d, --dbname=DBNAME database to install language in
-d, --dbname=DBNAME database to reindex
-d, --dbname=DBNAME database name
-e, --echo show the commands being sent to the server
-e, --echo show the commands being sent to the server
-e, --echo show the commands being sent to the server
-f, --full do full vacuuming
-g, --role=ROLE new role will be a member of this role
-h, --host=HOSTNAME database server host or socket directory
-h, --host=HOSTNAME database server host or socket directory
-h, --host=HOSTNAME database server host or socket directory
-i, --index=INDEX recreate specific index(es) only
-i, --inherit role inherits privileges of roles it is a
member of (default)
-i, --interactive prompt before deleting anything
-i, --interactive prompt before deleting anything, and prompt for
role name if not specified
-j, --jobs=NUM use this many concurrent connections to vacuum
-l, --list show a list of currently installed languages
-l, --locale=LOCALE locale settings for the database
-l, --login role can login (default)
-p, --port=PORT database server port
-p, --port=PORT database server port
-p, --port=PORT database server port
-q, --quiet don't write any messages
-q, --quiet don't write any messages
-q, --quiet run quietly
-r, --createrole role can create new roles
-s, --superuser role will be superuser
-s, --system reindex system catalogs only
-t, --table='TABLE[(COLUMNS)]' vacuum specific table(s) only
-t, --table=TABLE cluster specific table(s) only
-t, --table=TABLE reindex specific table(s) only
-t, --timeout=SECS seconds to wait when attempting connection, 0 disables (default: %s)
-v, --verbose write a lot of output
-v, --verbose write a lot of output
-w, --no-password never prompt for password
-w, --no-password never prompt for password
-z, --analyze update optimizer statistics
%s (%s/%s) %s cleans and analyzes a PostgreSQL database.
%s clusters all previously clustered tables in a database.
%s creates a PostgreSQL database.
%s creates a new PostgreSQL role.
%s installs a procedural language into a PostgreSQL database.
%s issues a connection check to a PostgreSQL database.
%s reindexes a PostgreSQL database.
%s removes a PostgreSQL database.
%s removes a PostgreSQL role.
%s removes a procedural language from a database.
%s: "%s" is not a valid encoding name
%s: %s %s: cannot cluster all databases and a specific one at the same time
%s: cannot cluster specific table(s) in all databases
%s: cannot reindex all databases and a specific one at the same time
%s: cannot reindex all databases and system catalogs at the same time
%s: cannot reindex specific index(es) and system catalogs at the same time
%s: cannot reindex specific index(es) in all databases
%s: cannot reindex specific schema(s) and system catalogs at the same time
%s: cannot reindex specific schema(s) in all databases
%s: cannot reindex specific table(s) and system catalogs at the same time
%s: cannot reindex specific table(s) in all databases
%s: cannot use the "%s" option when performing only analyze
%s: cannot vacuum all databases and a specific one at the same time
%s: cannot vacuum specific table(s) in all databases
%s: clustering database "%s"
%s: clustering of database "%s" failed: %s %s: clustering of table "%s" in database "%s" failed: %s %s: comment creation failed (database was created): %s %s: could not connect to database %s: %s %s: could not connect to database %s: out of memory
%s: could not fetch default options
%s: creation of new role failed: %s %s: database creation failed: %s %s: database removal failed: %s %s: invalid value for --connection-limit: %s
%s: language "%s" is already installed in database "%s"
%s: language "%s" is not installed in database "%s"
%s: language installation failed: %s %s: language removal failed: %s %s: missing required argument database name
%s: missing required argument language name
%s: missing required argument role name
%s: number of parallel jobs must be at least 1
%s: only one of --locale and --lc-collate can be specified
%s: only one of --locale and --lc-ctype can be specified
%s: processing database "%s": %s
%s: query failed: %s %s: query returned %d row instead of one: %s
%s: query returned %d rows instead of one: %s
%s: query was: %s
%s: reindexing database "%s"
%s: reindexing of database "%s" failed: %s %s: reindexing of index "%s" in database "%s" failed: %s %s: reindexing of schema "%s" in database "%s" failed: %s %s: reindexing of system catalogs failed: %s %s: reindexing of table "%s" in database "%s" failed: %s %s: removal of role "%s" failed: %s %s: too many command-line arguments (first is "%s")
%s: too many jobs for this platform -- try %d
%s: vacuuming database "%s"
%s: vacuuming of database "%s" failed: %s %s: vacuuming of table "%s" in database "%s" failed: %s (%lu row) (%lu rows) Are you sure? Cancel request sent
Cannot add cell to table content: total cell count of %d exceeded.
Cannot add header to table content: column count of %d exceeded.
Could not send cancel request: %s Database "%s" will be permanently removed.
Enter it again: Enter name of role to add: Enter name of role to drop: Enter password for new role: Generating default (full) optimizer statistics Generating medium optimizer statistics (10 targets) Generating minimal optimizer statistics (1 target) Interrupted
Name Password encryption failed.
Password: Passwords didn't match.
Please answer "%s" or "%s".
Procedural Languages Role "%s" will be permanently removed.
Shall the new role be a superuser? Shall the new role be allowed to create databases? Shall the new role be allowed to create more new roles? Trusted? Try "%s --help" for more information.
Usage:
accepting connections
cannot duplicate null pointer (internal error)
could not look up effective user ID %ld: %s invalid output format (internal error): %d n no no attempt
no response
out of memory
rejecting connections
unknown
user does not exist user name lookup failure: error code %lu y yes Project-Id-Version: PostgreSQL 9.6
Report-Msgid-Bugs-To: pgsql-bugs@postgresql.org
POT-Creation-Date: 2021-10-29 12:43+0000
PO-Revision-Date: 2021-10-29 16:17+0200
Last-Translator: Guillaume Lelarge <guillaume@lelarge.info>
Language-Team: PostgreSQLfr <pgsql-fr-generale@postgresql.org>
Language: fr
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
X-Generator: Poedit 3.0
Plural-Forms: nplurals=2; plural=(n > 1);
Par défaut, la base de donnée créée porte le nom de l'utilisateur courant.
Options de connexion :
Options :
Lire la description de la commande SQL CLUSTER pour de plus amples détails.
Lire la description de la commande SQL REINDEX pour plus d'informations.
Lire la description de la commande SQL VACUUM pour plus d'informations.
Rapporter les bogues à <pgsql-bugs@postgresql.org>.
--analyze-in-stages met seulement à jour les statistiques de
l'optimiseur, en plusieurs étapes pour de
meilleurs résultats ; pas de VACUUM
--lc-collate=LOCALE paramètre LC_COLLATE pour la base de données
--lc-ctype=LOCALE paramètre LC_CTYPE pour la base de données
%s [OPTION]...
%s [OPTION]... BASE
%s [OPTION]... LANGAGE [BASE]
%s [OPTION]... [BASE]
%s [OPTION]... [BASE] [DESCRIPTION]
%s [OPTION]... [ROLE]
--if-exists ne renvoie pas d'erreur si la base
n'existe pas
--if-exists ne renvoie pas d'erreur si l'utilisateur
n'existe pas
--interactive demande le nom du rôle et les attributs
plutôt qu'utiliser des valeurs par défaut
--maintenance-db=BASE indique une autre base par défaut
--maintenance-db=BASE indique une autre base par défaut
--no-replication le rôle ne peut pas initier de connexion de
réplication
--replication le rôle peut initier une connexion de
réplication
-?, --help affiche cette aide puis quitte
-?, --help affiche cette aide puis quitte
-?, --help affiche cette aide puis quitte
-?, --help affiche cette aide puis quitte
-D, --no-createdb le rôle ne peut pas créer de bases de
données (par défaut)
-D, --tablespace=TABLESPACE tablespace par défaut de la base de données
-E, --encoding=ENCODAGE encodage de la base de données
-E, --encrypted chiffre le mot de passe stocké
-F, --freeze gèle les informations de transactions des
lignes
-I, --no-inherit le rôle n'hérite pas des droits
-L, --no-login le rôle ne peut pas se connecter
-N, --unencrypted ne chiffre pas le mot de passe stocké
-O, --owner=PROPRIÉTAIRE nom du propriétaire de la nouvelle base de
données
-P, --pwprompt affecte un mot de passe au nouveau rôle
-R, --no-createrole le rôle ne peut pas créer de rôles (par défaut)
-S, --no-superuser le rôle ne sera pas super-utilisateur (par
défaut)
-S, --schema=SCHEMA réindexe seulement le(s) schéma(s) indiqué(s)
-T, --template=MODÈLE base de données modèle à copier
-U, --username=UTILISATEUR nom d'utilisateur pour la connexion
-U, --username=UTILISATEUR nom d'utilisateur pour la connexion
-U, --username=UTILISATEUR nom de l'utilisateur pour la connexion (pas
celui à créer)
-U, --username=UTILISATEUR nom de l'utilisateur pour la connexion (pas
celui à supprimer)
-U, --username=UTILISATEUR nom d'utilisateur pour la connexion
-V, --version affiche la version puis quitte
-V, --version affiche la version puis quitte
-V, --version affiche la version puis quitte
-V, --version affiche la version puis quitte
-W, --password force la demande d'un mot de passe
-W, --password force la demande d'un mot de passe
-Z, --analyze-only met seulement à jour les statistiques de
l'optimiseur ; pas de VACUUM
-a, --all exécute VACUUM sur toutes les bases de
données
-a, --all réorganise toutes les bases de données
-a, --all réindexe toutes les bases de données
-c, --connection-limit=N nombre maximal de connexions pour le rôle
(par défaut sans limite)
-d, --createdb l'utilisateur peut créer des bases de
données
-d, --dbname=BASE exécute VACUUM sur cette base de données
-d, --dbname=BASE base de données à partir de laquelle supprimer
le langage
-d, --dbname=BASE base de données à réorganiser
-d, --dbname=BASE base sur laquelle installer le langage
-d, --dbname=BASE base de données à réindexer
-d, --dbname=BASE base de données
-e, --echo affiche les commandes envoyées au serveur
-e, --echo affiche les commandes envoyées au serveur
-e, --echo affiche les commandes envoyées au serveur
-f, --full exécute VACUUM en mode FULL
-g, --role=ROLE le nouveau rôle sera un membre de ce rôle
-h, --host=HOTE hôte du serveur de bases de données
ou répertoire des sockets
-h, --host=HOTE hôte du serveur de bases de données ou
répertoire des sockets
-h, --host=HÔTE hôte du serveur de bases de données ou
répertoire des sockets
-i, --index=INDEX recrée uniquement cet (ces) index
-i, --inherit le rôle hérite des droits des rôles dont il
est membre (par défaut)
-i, --interactive demande confirmation avant de supprimer quoi
que ce soit
-i, --interactive demande confirmation avant de supprimer quoi
que ce soit, et demande le nom du rôle s'il
n'est pas indiqué
-j, --jobs=NUMERO utilise ce nombre de connexions concurrentes pour
le VACUUM
-l, --list affiche la liste des langages déjà installés
-l, --locale=LOCALE paramètre de la locale pour la base de
données
-l, --login le rôle peut se connecter (par défaut)
-p, --port=PORT port du serveur de bases de données
-p, --port=PORT port du serveur de bases de données
-p, --port=PORT port du serveur de bases de données
-q, --quiet n'écrit aucun message
-q, --quiet n'écrit aucun message
-q, --quiet s'exécute sans affichage
-r, --createrole le rôle peut créer des rôles
-s, --superuser le rôle est super-utilisateur
-s, --system réindexe seulement les catalogues système
-t, --table='TABLE[(COLONNES)]' exécute VACUUM sur cette (ces) tables
-t, --table=TABLE réorganise uniquement cette table
-t, --table=TABLE réindexe uniquement cette (ces) table(s)
-t, --timeout=SECS durée en secondes à attendre lors d'une
tentative de connexion,
0 pour désactiver (défaut: %s)
-v, --verbose mode verbeux
-v, --verbose mode verbeux
-w, --no-password empêche la demande d'un mot de passe
-w, --no-password empêche la demande d'un mot de passe
-z, --analyze met à jour les statistiques de l'optimiseur
%s (%s/%s) %s nettoie et analyse une base de données PostgreSQL.
%s réorganise toutes les tables précédemment réorganisées au sein d'une
base de données via la commande CLUSTER.
%s crée une base de données PostgreSQL.
%s crée un nouvel rôle PostgreSQL.
%s installe un langage de procédures dans une base de données PostgreSQL.
%s produitun test de connexion à une base de données PostgreSQL.
%s réindexe une base de données PostgreSQL.
%s supprime une base de données PostgreSQL.
%s supprime un rôle PostgreSQL.
%s supprime un langage procédural d'une base de données.
%s : « %s » n'est pas un nom d'encodage valide
%s : %s %s : ne réorganise pas à la fois toutes les bases de données et une base
spécifique via la commande CLUSTER
%s : impossible de réorganiser la(les) table(s) spécifique(s) dans toutes les bases de données
%s : ne peut pas réindexer toutes les bases de données et une base
spécifique en même temps
%s : ne peut pas réindexer toutes les bases de données et les catalogues
système en même temps
%s : ne peut pas réindexer un (des) index spécifique(s) et
les catalogues système en même temps
%s : ne peut pas réindexer un (des) index spécifique(s) dans toutes les
bases de données
%s : ne peut pas réindexer une (des) schéma(s) spécifique(s) et les catalogues système en même temps
%s : ne peut pas réindexer un (des) schéma(s) spécifique(s) dans toutes
les bases de données
%s : ne peut pas réindexer une (des) table(s) spécifique(s) etles catalogues système en même temps
%s : ne peut pas réindexer une (des) table(s) spécifique(s) dans toutes
les bases de données
%s : ne peut utiliser l'option « %s » lors de l'exécution d'un ANALYZE seul
%s : ne peut pas exécuter VACUUM sur toutes les bases de données et sur une
base spécifique en même temps
%s : ne peut pas exécuter VACUUM sur une(des) table(s) spécifique(s)
dans toutes les bases de données
%s : réorganisation de la base de données « %s » via la commande CLUSTER
%s : la réorganisation de la base de données « %s » via la commande
CLUSTER a échoué : %s %s : la réorganisation de la table « %s » de la base de données « %s » avec
la commande CLUSTER a échoué : %s %s: l'ajout du commentaire a échoué (la base de données a été créée) : %s %s : n'a pas pu se connecter à la base de données %s : %s %s : n'a pas pu se connecter à la base de données %s : plus de mémoire
%s : n'a pas pu récupérer les options par défaut
%s : la création du nouvel rôle a échoué : %s %s : la création de la base de données a échoué : %s %s: la suppression de la base de données a échoué : %s %s : valeur invalide pour --connection-limit : « %s »
%s : le langage « %s » est déjà installé sur la base de données « %s »
%s : le langage « %s » n'est pas installé dans la base de données « %s »
%s : l'installation du langage a échoué : %s %s : la suppression du langage a échoué : %s %s : argument nom de la base de données requis mais manquant
%s : argument nom du langage requis mais manquant
%s : argument nom du rôle requis mais manquant
%s : le nombre maximum de jobs en parallèle doit être au moins de 1
%s : une seule des options --locale et --lc-collate peut être indiquée
%s : une seule des options --locale et --lc-ctype peut être indiquée
%s : traitement de la base de données « %s » %s
%s : échec de la requête : %s %s : la requête a renvoyé %d ligne au lieu d'une seule : %s
%s : la requête a renvoyé %d lignes au lieu d'une seule : %s
%s : la requête était : %s
%s : réindexation de la base de données « %s »
%s : la réindexation de la base de données « %s » a échoué : %s %s : la réindexation de l'index « %s » dans la base de données « %s » a
échoué : %s %s : la réindexation du schéma « %s » dans la base de données « %s » a
échoué : %s %s : la réindexation des catalogues système a échoué : %s %s : la réindexation de la table « %s » dans la base de données « %s » a
échoué : %s %s : la suppression du rôle « %s » a échoué : %s %s : trop d'arguments en ligne de commande (le premier étant « %s »)
%s : trop de jobs pour cette plateforme -- essayez %d
%s : exécution de VACUUM sur la base de données « %s »
%s : l'exécution de VACUUM sur la base de données « %s » a échoué : %s %s : l'exécution de VACUUM sur la table « %s » dans la base de données
« %s » a échoué : %s (%lu ligne) (%lu lignes) Êtes-vous sûr ? Requête d'annulation envoyée
Ne peut pas ajouter une cellule au contenu de la table : le nombre total des
cellules %d est dépassé.
Ne peut pas ajouter l'en-tête au contenu de la table : le nombre de colonnes
%d est dépassé.
N'a pas pu envoyer la requête d'annulation : %s La base de données « %s » sera définitivement supprimée.
Saisir le mot de passe à nouveau : Saisir le nom du rôle à ajouter : Saisir le nom du rôle à supprimer : Saisir le mot de passe pour le nouveau rôle : Génération de statistiques complètes pour l'optimiseur Génération de statistiques moyennes pour l'optimiseur (dix cibles) Génération de statistiques minimales pour l'optimiseur (une cible) Interrompu
Nom Échec du chiffrement du mot de passe.
Mot de passe : Les mots de passe ne sont pas identiques.
Merci de répondre « %s » ou « %s ».
Langages procéduraux Le rôle « %s » sera définitivement supprimé.
Le nouveau rôle est-il super-utilisateur ? Le nouveau rôle est-il autorisé à créer des bases de données ? Le nouveau rôle est-il autorisé à créer de nouveaux rôles ? De confiance (trusted) ? Essayer « %s --help » pour plus d'informations.
Usage :
acceptation des connexions
ne peut pas dupliquer un pointeur nul (erreur interne)
n'a pas pu trouver l'identifiant réel %ld de l'utilisateur : %s format de sortie invalide (erreur interne) : %d n non pas de tentative
pas de réponse
mémoire épuisée
rejet des connexions
inconnu
l'utilisateur n'existe pas échec de la recherche du nom d'utilisateur : code d'erreur %lu o oui locale/fr/LC_MESSAGES/pg_basebackup-9.6.mo 0000644 00000074456 14751153421 0013657 0 ustar 00 �� � �
` a { � � ! �
� - � X T l R � ` I u D � 3 K J < � j � > > N } @ � 3
Y A > � 1 � j < w ? � M � k B J � Y � + S 0 B � B � * 6 8 a � � 5 ) � _ r � o Z 1 � 3 � K 0 - | F � \ � P N 2 � 4 � 8 @ 1 G 4 y 1 � . � @ 1 P E � B � 7 ! C! ]! & }! ; �! ( �! # " - -" ' [" " �" �" 2 �" , �" + '# . S# ( �# # �# 5 �# f $ , l$ 9 �$ 4 �$ 7 % = @% d ~% A �% " %& & H& & o& # �& / �& > �& a )' & �' & �' % �' 2 �' 1 2( 0 d( 8 �( ( �( 2 �( *) & K) ' r) . �) + �) # �) A * 2 [* & �* & �* / �* + + 4 8+ / m+ ! �+ 1 �+ ) �+ ( , 2 D, 2 w, 3 �, 0 �, % - # 5- + Y- �- �- 2 �- # �- . , (. , U. # �. i �. i / ? z/ 9 �/ " �/ A 0 # Y0 }0 9 �0 �0 �0 !
1 D /1 & t1 # �1 A �1 - 2 D /2 ! t2 �2 �2 " �2 �2 9 3 1 C3 D u3 , �3 �3 ' �3 D "4 M g4 : �4 8 �4 6 )5 `5 E y5 G �5 z 6 c �6 % �6 . 7 2 ;7 6 n7 # �7 �7 % �7 0 8 R 98 , �8 4 �8 K �8 @ :9 > {9 - �9 , �9 ' : , =: o j: k �: 4 F; % {; ( �; ; �;
< & < 8< / @< p< / < � �< j> �> �> �> ! �> �> 6 �> � 1? � �? � N@ � �@ � kA { �A oB @ �B | �B u ?C � �C M ;D x �D v E I yE N �E E F B XF � �F B G @ aG � �G � /H � �H K <I 6 �I ? �I u �I � uJ B �J O =K � �K r L � �L � [M � �M > bN C �N � �N 9 yO F �O \ �O P WP @ �P = �P P 'Q xQ . �Q L �Q U �Q . RR R �R ? �R G S D \S 9 �S �S % �S 2 T \ NT 6 �T ( �T ; U 4 GU 0 |U ( �U F �U ; V 8 YV ; �V 4 �V 0 W H 4W � }W 8 �W I 8X J �X ] �X J +Y � vY N �Y A JZ A �Z 8 �Z 2 [ 9 :[ a t[ y �[ 2 P\ 4 �\ ; �\ J �\ A ?] K �] R �] 9 ^ L Z^ . �^ 2 �^ , _ 9 6_ > p_ 2 �_ M �_ > 0` 6 o` ? �` A �` < (a D ea C �a J �a Z 9b 0 �b ( �b P �b P ?c P �c A �c 6 #d 0 Zd 8 �d " �d �d G �d 2 Be - ue - �e M �e . f s Nf s �f M 6g L �g 0 �g a h - dh ( �h T �h ) i :i , Ti s �i ? �i 0 5j k fj B �j a k ) wk & �k ) �k & �k " l P <l B �l _ �l C 0m tm . �m b �m o n g �n R �n = Jo �o [ �o U p � Xp �p G |q 6 �q : �q 9 6r & pr �r , �r G �r o s 7 �s H �s q t i �t c �t C Ou J �u = �u 9 v � Vv � �v 0 ~w - �w , �w F
x Qx 2 ax �x 7 �x �x D �x � * � � o C $ e 7 ] � j @ � � � � f � - R � � � � O = � s � F } 2 M � p c { < N 8 � � � ) B + Y � � � � � z & T k h � I H K ~ � t w X v � � � : � > � � . / � 5 � U � � � � � _ � � 6 [ E
Z � S J , � � d # x � � Q y A P � � i � � u ^ � ? � � V
� 0 n � ( � � \ ; � � r � � � � 4 � g � " � 3 1 � D m l 9 a � � b G q � % W � � � � ! � � | ` L � � � ' �
Action to be performed:
Connection options:
General options:
Optional actions:
Options controlling the output:
Options:
Report bugs to <pgsql-bugs@postgresql.org>.
--create-slot create a new replication slot (for the slot's name see --slot)
--drop-slot drop the replication slot (for the slot's name see --slot)
--if-not-exists do not error if slot already exists when creating a slot
--start start streaming in a replication slot (for the slot's name see --slot)
--synchronous flush transaction log immediately after writing
--xlogdir=XLOGDIR location for the transaction log directory
%s [OPTION]...
-?, --help show this help, then exit
-D, --directory=DIR receive transaction log files into this directory
-D, --pgdata=DIRECTORY receive base backup into directory
-F --fsync-interval=SECS
time between fsyncs to the output file (default: %d)
-F, --format=p|t output format (plain (default), tar)
-I, --startpos=LSN where in an existing slot should the streaming start
-P, --plugin=PLUGIN use output plugin PLUGIN (default: %s)
-P, --progress show progress information
-R, --write-recovery-conf
write recovery.conf for replication
-S, --slot=SLOTNAME name of the logical replication slot
-S, --slot=SLOTNAME replication slot to use
-T, --tablespace-mapping=OLDDIR=NEWDIR
relocate tablespace in OLDDIR to NEWDIR
-U, --username=NAME connect as specified database user
-V, --version output version information, then exit
-W, --password force password prompt (should happen automatically)
-X, --xlog-method=fetch|stream
include required WAL files with specified method
-Z, --compress=0-9 compress tar output with given compression level
-c, --checkpoint=fast|spread
set fast or spread checkpointing
-d, --dbname=CONNSTR connection string
-d, --dbname=DBNAME database to connect to
-f, --file=FILE receive log into this file, - for stdout
-h, --host=HOSTNAME database server host or socket directory
-l, --label=LABEL set backup label
-n, --no-loop do not loop on connection lost
-o, --option=NAME[=VALUE]
pass option NAME with optional value VALUE to the
output plugin
-p, --port=PORT database server port number
-r, --max-rate=RATE maximum transfer rate to transfer data directory
(in kB/s, or use suffix "k" or "M")
-s, --status-interval=INTERVAL
time between status packets sent to server (in seconds)
-s, --status-interval=SECS
time between status packets sent to server (default: %d)
-v, --verbose output verbose messages
-w, --no-password never prompt for password
-x, --xlog include required WAL files in backup (fetch mode)
-z, --gzip compress tar output
%*s/%s kB (%d%%), %d/%d tablespace %*s/%s kB (%d%%), %d/%d tablespaces %*s/%s kB (%d%%), %d/%d tablespace (%s%-*.*s) %*s/%s kB (%d%%), %d/%d tablespaces (%s%-*.*s) %*s/%s kB (100%%), %d/%d tablespace %*s %*s/%s kB (100%%), %d/%d tablespaces %*s %s controls PostgreSQL logical decoding streams.
%s receives PostgreSQL streaming transaction logs.
%s takes a base backup of a running PostgreSQL server.
%s: %s %s: %s needs a slot to be specified using --slot
%s: COPY stream ended before last file was finished
%s: WAL streaming can only be used in plain mode
%s: at least one action needs to be specified
%s: can only write single tablespace to stdout, database has %d
%s: cannot specify both --xlog and --xlog-method
%s: cannot use --create-slot or --drop-slot together with --startpos
%s: cannot use --create-slot or --start together with --drop-slot
%s: cannot use --create-slot together with --drop-slot
%s: checkpoint completed
%s: child %d died, expected %d
%s: child thread exited with error %u
%s: confirming write up to %X/%X, flush to %X/%X (slot %s)
%s: could not access directory "%s": %s
%s: could not clear search_path: %s %s: could not close compressed file "%s": %s
%s: could not close directory "%s": %s
%s: could not close file "%s": %s
%s: could not connect to server
%s: could not create archive status file "%s": %s
%s: could not create background process: %s
%s: could not create background thread: %s
%s: could not create compressed file "%s": %s
%s: could not create directory "%s": %s
%s: could not create file "%s": %s
%s: could not create pipe for background process: %s
%s: could not create replication slot "%s": got %d rows and %d fields, expected %d rows and %d fields
%s: could not create symbolic link "%s": %s
%s: could not create symbolic link from "%s" to "%s": %s
%s: could not create timeline history file "%s": %s
%s: could not determine seek position in file "%s": %s
%s: could not determine server setting for integer_datetimes
%s: could not drop replication slot "%s": got %d rows and %d fields, expected %d rows and %d fields
%s: could not establish database-specific replication connection
%s: could not fsync file "%s": %s
%s: could not fsync log file "%s": %s
%s: could not get COPY data stream: %s %s: could not get backup header: %s %s: could not get child thread exit status: %s
%s: could not get transaction log end position from server: %s %s: could not identify system: got %d rows and %d fields, expected %d rows and %d or more fields
%s: could not initiate base backup: %s %s: could not open directory "%s": %s
%s: could not open log file "%s": %s
%s: could not open timeline history file "%s": %s
%s: could not open transaction log file "%s": %s
%s: could not pad transaction log file "%s": %s
%s: could not parse next timeline's starting point "%s"
%s: could not parse start position "%s"
%s: could not parse transaction log location "%s"
%s: could not read COPY data: %s %s: could not read directory "%s": %s
%s: could not read from ready pipe: %s
%s: could not receive data from WAL stream: %s %s: could not rename file "%s" to "%s": %s
%s: could not rename file "%s": %s
%s: could not seek to beginning of transaction log file "%s": %s
%s: could not send command to background pipe: %s
%s: could not send copy-end packet: %s %s: could not send feedback packet: %s %s: could not send replication command "%s": %s %s: could not set compression level %d: %s
%s: could not set permissions on directory "%s": %s
%s: could not set permissions on file "%s": %s
%s: could not stat file "%s": %s
%s: could not stat transaction log file "%s": %s
%s: could not wait for child process: %s
%s: could not wait for child thread: %s
%s: could not write %u bytes to WAL file "%s": %s
%s: could not write %u bytes to log file "%s": %s
%s: could not write timeline history file "%s": %s
%s: could not write to compressed file "%s": %s
%s: could not write to file "%s": %s
%s: creating replication slot "%s"
%s: directory "%s" exists but is not empty
%s: directory name too long
%s: disconnected
%s: disconnected; waiting %d seconds to try again
%s: dropping replication slot "%s"
%s: final receive failed: %s %s: finished segment at %X/%X (timeline %u)
%s: got WAL data offset %08x, expected %08x
%s: incompatible server version %s
%s: incompatible server version %s; client does not support streaming from server versions newer than %s
%s: incompatible server version %s; client does not support streaming from server versions older than %s
%s: initiating base backup, waiting for checkpoint to complete
%s: integer_datetimes compile flag does not match server
%s: invalid --max-rate unit: "%s"
%s: invalid checkpoint argument "%s", must be "fast" or "spread"
%s: invalid compression level "%s"
%s: invalid fsync interval "%s"
%s: invalid output format "%s", must be "plain" or "tar"
%s: invalid port number "%s"
%s: invalid socket: %s %s: invalid status interval "%s"
%s: invalid tablespace mapping format "%s", must be "OLDDIR=NEWDIR"
%s: invalid tar block header size: %d
%s: invalid transfer rate "%s": %s
%s: invalid xlog-method option "%s", must be "fetch" or "stream"
%s: multiple "=" signs in tablespace mapping
%s: new directory is not an absolute path in tablespace mapping: %s
%s: no data returned from server
%s: no database specified
%s: no slot specified
%s: no target directory specified
%s: no target file specified
%s: no transaction log end position returned from server
%s: not renaming "%s%s", segment is not complete
%s: old directory is not an absolute path in tablespace mapping: %s
%s: only tar mode backups can be compressed
%s: out of memory
%s: received interrupt signal, exiting
%s: received transaction log record for offset %u with no file open
%s: replication connection using slot "%s" is unexpectedly database specific
%s: replication slots can only be used with WAL streaming
%s: replication stream was terminated before stop point
%s: segment file "%s" has incorrect size %d, skipping
%s: select() failed: %s
%s: server reported unexpected history file name for timeline %u: %s
%s: server reported unexpected next timeline %u, following timeline %u
%s: server returned unexpected response to BASE_BACKUP command; got %d rows and %d fields, expected %d rows and %d fields
%s: server stopped streaming timeline %u at %X/%X, but reported next timeline %u to begin at %X/%X
%s: starting background WAL receiver
%s: starting log streaming at %X/%X (slot %s)
%s: starting log streaming at %X/%X (timeline %u)
%s: starting timeline %u is not present in the server
%s: streaming header too small: %d
%s: streaming initiated
%s: switched to timeline %u at %X/%X
%s: symlinks are not supported on this platform
%s: system identifier does not match between base backup and streaming connection
%s: this build does not support compression
%s: too many command-line arguments (first is "%s")
%s: transaction log directory location can only be specified in plain mode
%s: transaction log directory location must be an absolute path
%s: transaction log file "%s" has %d bytes, should be 0 or %d
%s: transfer rate "%s" exceeds integer range
%s: transfer rate "%s" is not a valid value
%s: transfer rate "%s" is out of range
%s: transfer rate must be greater than zero
%s: unexpected response to TIMELINE_HISTORY command: got %d rows and %d fields, expected %d rows and %d fields
%s: unexpected result set after end-of-timeline: got %d rows and %d fields, expected %d rows and %d fields
%s: unexpected termination of replication stream: %s %s: unrecognized link indicator "%c"
%s: unrecognized streaming header: "%c"
%s: waiting for background process to finish streaming ...
Password: Try "%s --help" for more information.
Usage:
cannot duplicate null pointer (internal error)
out of memory
transaction log start point: %s on timeline %u
Project-Id-Version: PostgreSQL 9.6
Report-Msgid-Bugs-To: pgsql-bugs@postgresql.org
POT-Creation-Date: 2020-11-07 22:51+0000
PO-Revision-Date: 2018-09-23 08:59+0200
Last-Translator: Guillaume Lelarge <guillaume@lelarge.info>
Language-Team: French <guillaume@lelarge.info>
Language: fr
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Plural-Forms: nplurals=2; plural=(n > 1);
X-Generator: Poedit 2.1.1
Action à réaliser :
Options de connexion :
Options générales :
Actions optionnelles :
Options contrôlant la sortie :
Options :
Rapporter les bogues à <pgsql-bugs@postgresql.org>.
--create-slot créer un nouveau slot de réplication (pour le
nom du slot, voir --slot)
--drop-slot supprimer un nouveau slot de réplication (pour
le nom du slot, voir --slot)
--if-not-exists ne pas renvoyer une erreur si le slot existe
déjà lors de sa création
--start lance le flux dans un slot de réplication (pour
le nom du slot, voir --slot)
--synchronous vider le journal de transactions immédiatement
après son écriture
-X, --xlogdir=RÉP_XLOG emplacement du répertoire des journaux de
transactions
%s [OPTION]...
-?, --help affiche cette aide puis quitte
-D, --directory=RÉP reçoit les journaux de transactions dans ce
répertoire
-D, --pgdata=RÉPERTOIRE reçoit la sauvegarde de base dans ce
répertoire
-F --fsync-interval=SECS durée entre les fsyncs vers le fichier de
sortie (par défaut %d)
-F, --format=p|t format en sortie (plain (par défaut), tar)
-I, --startpos=LSN position de début du streaming dans le slot
existant
-P, --plugin=PLUGIN utilise le plugin PLUGIN en sortie
(par défaut %s)
-P, --progress affiche la progression de la sauvegarde
-R, --write-recovery-conf écrit le recovery.conf pour la réplication
-S, --slot=NOMSLOT nom du slot de réplication logique
-S, --slot=NOMREP slot de réplication à utiliser
-T, --tablespace-mapping=ANCIENREP=NOUVEAUREP
déplacer le répertoire ANCIENREP en NOUVEAUREP
-U, --username=NOM se connecte avec cet utilisateur
-V, --version affiche la version puis quitte
-W, --password force la demande du mot de passe (devrait être
demandé automatiquement)
-X, --xlog-method=fetch|stream inclut les journaux de transactions requis
avec la méthode spécifiée
-Z, --compress=0-9 compresse la sortie tar avec le niveau de
compression indiqué
-c, --checkpoint=fast|spread exécute un CHECKPOINT rapide ou réparti
-d, --dbname=CONNSTR chaîne de connexion
-d, --dbname=BASE base de données de connexion
-f, --file=NOMFICHIER trace la réception dans ce fichier,
- pour stdout
-h, --host=NOMHÔTE hôte du serveur de bases de données ou
répertoire des sockets
-l, --label=LABEL configure le label de sauvegarde
-n, --no-loop ne boucle pas en cas de perte de la connexion
-o, --option=NOM[=VALEUR] passe l'option NAME avec la valeur optionnelle
VALEUR au plugin en sortie
-p, --port=PORT numéro de port du serveur de bases de
données
-r, --max-rate=TAUX taux maximum de transfert du répertoire de
données (en Ko/s, ou utiliser le suffixe « k »
ou « M »)
-s, --status-interval=INTERVAL durée entre l'envoi de paquets de statut au
serveur (en secondes)
-s, --status-interval=SECS durée entre l'envoi de paquets de statut au
(par défaut %d)
-v, --verbose affiche des messages verbeux
-w, --no-password ne demande jamais le mot de passe
-x, --xlog inclut les journaux de transactions
nécessaires dans la sauvegarde (mode fetch)
-z, --gzip compresse la sortie tar
%*s/%s Ko (%d%%), %d/%d tablespace %*s/%s Ko (%d%%), %d/%d tablespaces %*s/%s Ko (%d%%), %d/%d tablespace (%s%-*.*s) %*s/%s Ko (%d%%), %d/%d tablespaces (%s%-*.*s) %*s/%s Ko (100%%), %d/%d tablespace %*s %*s/%s Ko (100%%), %d/%d tablespaces %*s %s contrôle le flux des modifications logiques de PostgreSQL.
%s reçoit le flux des journaux de transactions PostgreSQL.
%s prend une sauvegarde binaire d'un serveur PostgreSQL en cours
d'exécution.
%s : %s %s : %s a besoin du slot avec l'option --slot
%s : le flux COPY s'est terminé avant que le dernier fichier soit terminé
%s : le flux de journaux de transactions peut seulement être utilisé en mode plain
%s : au moins une action doit être indiquée
%s : peut seulement écrire un tablespace sur la sortie standard, la base en a %d
%s : ne peut pas spécifier à la fois --xlog et --xlog-method
%s : ne peut pas utiliser --create-slot ou --drop-slot avec --startpos
%s : ne peut pas utiliser --create-slot ou --start avec --drop-slot
%s : ne peut pas utiliser --create-slot avec --drop-slot
%s : checkpoint terminé
%s : le fils %d est mort, %d attendu
%s : le thread a quitté avec le code d'erreur %u
%s : confirmation d'écriture jusqu'à %X/%X et de synchronisation jusqu'à %X/%X (slot %s)
%s : n'a pas pu accéder au répertoire « %s » : %s
%s : n'a pas pu effacer search_path : %s %s : n'a pas pu fermer le fichier compressé « %s » : %s
%s : n'a pas pu fermer le répertoire « %s » : %s
%s : n'a pas pu fermer le fichier « %s » : %s
%s : n'a pas pu se connecter au serveur
%s : n'a pas pu créer le fichier de statut d'archivage « %s » : %s
%s : n'a pas pu créer un processus en tâche de fond : %s
%s : n'a pas pu créer un thread en tâche de fond : %s
%s : n'a pas pu créer le fichier compressé « %s » : %s
%s : n'a pas pu créer le répertoire « %s » : %s
%s : n'a pas pu créer le fichier « %s » : %s
%s : n'a pas pu créer un tube pour le processus en tâche de fond : %s
%s : n'a pas pu créer le slot de réplication « %s » : a récupéré %d lignes et %d champs,
attendait %d lignes et %d champs
%s : n'a pas pu créer le lien symbolique « %s » : %s
%s : n'a pas pu créer le lien symbolique de « %s » vers « %s » : %s
%s : n'a pas pu créer le fichier historique de la timeline « %s » : %s
%s : n'a pas pu déterminer la position de recherche dans le fichier d'archive « %s » : %s
%s : n'a pas pu déterminer la configuration serveur de integer_datetimes
%s : n'a pas pu supprimer le slot de réplication « %s » : a récupéré %d lignes et %d champs,
attendait %d lignes et %d champs
%s : n'a pas pu établir une connexion de réplication spécifique à la base
%s : n'a pas pu synchroniser sur disque le fichier « %s » : %s
%s : n'a pas pu synchroniser sur disque le fichier « %s » : %s
%s : n'a pas pu obtenir le flux de données de COPY : %s %s : n'a pas pu obtenir l'en-tête du serveur : %s %s : n'a pas pu obtenir le code de sortie du thread : %s
%s : n'a pas pu obtenir la position finale des journaux de transactions à
partir du serveur : %s %s : n'a pas pu identifier le système, a récupéré %d lignes et %d champs,
attendait %d lignes et %d champs (ou plus)
%s : n'a pas pu initier la sauvegarde de base : %s %s : n'a pas pu ouvrir le répertoire « %s » : %s
%s : n'a pas pu ouvrir le journal applicatif « %s » : %s
%s : n'a pas pu ouvrir le journal historique de la timeline « %s » : %s
%s : n'a pas pu ouvrir le journal des transactions « %s » : %s
%s : n'a pas pu remplir de zéros le journal de transactions « %s » : %s
%s : n'a pas pu analyser la position de départ de la prochaine timeline « %s »
%s : n'a pas pu analyser la position de départ « %s »
%s : n'a pas pu analyser l'emplacement du journal des transactions « %s »
%s : n'a pas pu lire les données du COPY : %s %s : n'a pas pu lire le répertoire « %s » : %s
%s : n'a pas pu lire à partir du tube : %s
%s : n'a pas pu recevoir des données du flux de WAL : %s %s : n'a pas pu renommer le fichier « %s » en « %s » : %s
%s : n'a pas pu renommer le fichier « %s » : %s
%s : n'a pas pu rechercher le début du journal de transaction « %s » : %s
%s : n'a pas pu envoyer la commande au tube du processus : %s
%s : n'a pas pu envoyer le paquet de fin de copie : %s %s : n'a pas pu envoyer le paquet d'informations en retour : %s %s : n'a pas pu envoyer la commande de réplication « %s » : %s %s : n'a pas pu configurer le niveau de compression %d : %s
%s : n'a pas configurer les droits sur le répertoire « %s » : %s
%s : n'a pas pu configurer les droits sur le fichier « %s » : %s
%s : n'a pas pu récupérer les informations sur le fichier « %s » : %s
%s : n'a pas pu récupérer les informations sur le journal de transactions
« %s » : %s
%s : n'a pas pu attendre le processus fils : %s
%s : n'a pas pu attendre le thread : %s
%s : n'a pas pu écrire %u octets dans le journal de transactions « %s » : %s
%s : n'a pas pu écrire %u octets dans le journal de transactions « %s » : %s
%s : n'a pas pu écrire dans le fichier historique de la timeline « %s » : %s
%s : n'a pas pu écrire dans le fichier compressé « %s » : %s
%s : n'a pas pu écrire dans le fichier « %s » : %s
%s : création du slot de réplication « %s »
%s : le répertoire « %s » existe mais n'est pas vide
%s : nom du répertoire trop long
%s : déconnecté
%s : déconnecté, attente de %d secondes avant une nouvelle tentative
%s : suppression du slot de réplication « %s »
%s : échec lors de la réception finale : %s %s : segment terminé à %X/%X (timeline %u)
%s : a obtenu le décalage %08x pour les données du journal, attendait %08x
%s : version « %s » du serveur incompatible
%s : version %s du serveur incompatible ; le client ne supporte pas le streaming de versions plus récentes que %s
%s : version %s du serveur incompatible ; le client ne supporte pas le streaming de versions plus anciennes que %s
%s : initialise la sauvegarde de base, et en attente de la fin du checkpoint
%s : l'option de compilation integer_datetimes ne correspond pas au serveur
%s : unité invalide pour --max-rate : « %s »
%s : argument « %s » invalide pour le CHECKPOINT, doit être soit « fast »
soit « spread »
%s : niveau de compression « %s » invalide
%s : intervalle fsync « %s » invalide
%s : format de sortie « %s » invalide, doit être soit « plain » soit « tar »
%s : numéro de port invalide : « %s »
%s : socket invalide : %s %s : intervalle « %s » invalide du statut
%s : format de correspondance de tablespace « %s » invalide, doit être « ANCIENREPERTOIRE=NOUVEAUREPERTOIRE »
%s : taille invalide de l'en-tête de bloc du fichier tar : %d
%s : taux de transfert invalide (« %s ») : %s
%s : option xlog-method « %s » invalide, doit être soit « fetch » soit « stream »
soit « stream »
%s : multiple signes « = » dans la correspondance de tablespace
%s : le nouveau répertoire n'est pas un chemin absolu dans la correspondance de tablespace : %s
%s : aucune donnée renvoyée du serveur
%s : aucun base de données indiquée
%s : aucun slot de réplication indiqué
%s : aucun répertoire cible indiqué
%s : aucun fichier cible indiqué
%s : aucune position de fin du journal de transactions renvoyée par le serveur
%s : pas de renommage de « %s%s », le segment n'est pas complet
%s : l'ancien répertoire n'est pas un chemin absolu dans la correspondance de tablespace : %s
%s : seules les sauvegardes en mode tar peuvent être compressées
%s : mémoire épuisée
%s : a reçu un signal d'interruption, quitte
%s : a reçu l'enregistrement du journal de transactions pour le décalage %u
sans fichier ouvert
%s : la connexion de réplication utilisant le slot « %s » est spécifique à
une base, ce qui est inattendu
%s : les slots de réplications peuvent seulement être utilisés avec la réplication en flux des WAL
%s : le flux de réplication a été abandonné avant d'arriver au point d'arrêt
%s : le segment « %s » a une taille %d incorrecte, ignoré
%s : échec de select() : %s
%s : le serveur a renvoyé un nom de fichier historique inattendu pour la timeline %u : %s
%s: le serveur a renvoyé une timeline suivante %u inattendue, après la timeline %u
%s : le serveur a renvoyé une réponse inattendue à la commande BASE_BACKUP ; a récupéré %d lignes et %d champs, alors qu'il attendait %d lignes et %d champs
%s : le serveur a arrêté l'envoi de la timeline %u à %X/%X, mais a indiqué que la timeline suivante, %u, commence à %X/%X
%s : lance le récepteur de journaux de transactions en tâche de fond
%s : commence le flux des journaux à %X/%X (slot %s)
%s : commence le flux des journaux à %X/%X (timeline %u)
%s : la timeline %u de départ n'est pas dans le serveur
%s : en-tête de flux trop petit : %d
%s : flux lancé
%s : a basculé sur la timeline %u à %X/%X
%s : les liens symboliques ne sont pas supportés sur cette plateforme
%s : l'identifiant système ne correspond pas entre la sauvegarde des fichiers
et la connexion de réplication
%s : cette construction ne supporte pas la compression
%s : trop d'arguments en ligne de commande (le premier étant « %s »)
%s : l'emplacement du répertoire des journaux de transactions doit être
indiqué uniquement dans le mode plain
%s : l'emplacement du répertoire des journaux de transactions doit être
indiqué avec un chemin absolu
%s : le segment « %s » du journal de transactions comprend %d octets, cela
devrait être 0 ou %d
%s : le taux de transfert « %s » dépasse l'échelle des entiers
%s : le taux de transfert « %s » ne correspond pas à une valeur valide
%s : le taux de transfert « %s » est en dehors des limites
%s : le taux de transfert doit être supérieur à zéro
%s : réponse inattendue à la commande TIMELINE_HISTORY : a récupéré %d lignes et %d champs, alors qu'il attendait %d lignes et %d champs
%s : ensemble de résultats inattendu après la fin de la timeline : a récupéré %d lignes et %d champs, alors qu'il attendait %d lignes et %d champs
%s : fin inattendue du flux de réplication : %s %s : indicateur de lien « %c » non reconnu
%s : entête non reconnu du flux : « %c »
%s : en attente que le processus en tâche de fond termine le flux...
Mot de passe : Essayer « %s --help » pour plus d'informations.
Usage :
ne peut pas dupliquer un pointeur nul (erreur interne)
mémoire épuisée
point de départ du journal de transactions : %s sur la timeline %u
locale/fr/LC_MESSAGES/ecpglib6-9.6.mo 0000644 00000007410 14751153421 0012546 0 ustar 00 �� ! $ / , � � � � ) ' - Q : 0 � $ � ( 9 L * c ; � > � 3 < = & z 1 � � + � ' @ % Y � , � � 2 0 ; / l � � # - 4 9 S . d C � Q � > )
0 h
4 �
�
�
7 K : I � G � P 3 i L � ' � 2
+ E
! q
& �
$ �
�
: + ; 8 g 5 � 1 �
! <DEFAULT> <empty> NULL SQL error %d on line %d SQL error: %s
connection "%s" does not exist on line %d could not connect to database "%s" on line %d could not convert boolean value: size mismatch, on line %d data read from server is not an array on line %d descriptor "%s" not found on line %d descriptor index out of range on line %d empty message text empty query on line %d error in transaction processing on line %d inserting an array of variables is not supported on line %d invalid input syntax for floating-point type: "%s", on line %d invalid input syntax for type int: "%s", on line %d invalid input syntax for type unsigned int: "%s", on line %d invalid statement name "%s" on line %d invalid syntax for type boolean: "%s", on line %d no data found on line %d not connected to connection "%s" on line %d null value without indicator on line %d out of memory on line %d the connection to the server was lost too few arguments on line %d too many arguments on line %d unrecognized descriptor item "%s" on line %d unsupported type "%s" on line %d variable does not have a character type on line %d variable does not have a numeric type on line %d variable does not have an array type on line %d Project-Id-Version: PostgreSQL 9.6
Report-Msgid-Bugs-To: pgsql-bugs@postgresql.org
POT-Creation-Date: 2010-03-06 17:22+0000
PO-Revision-Date: 2013-09-04 20:31-0400
Last-Translator: Guillaume Lelarge <guillaume@lelarge.info>
Language-Team: PostgreSQLfr <pgsql-fr-generale@postgresql.org>
Language: fr
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
<DÉFAUT> <vide> NULL erreur SQL %d en ligne %d erreur SQL : %s
la connexion « %s » n'existe pas en ligne %d n'a pas pu se connecter à la base de données « %s » en ligne %d n'a pas pu convertir la valeur booléenne : différence de taille sur la
ligne %d la donnée lue du serveur n'est pas un tableau sur la ligne %d descripteur « %s » introuvable sur la ligne %d index de descripteur hors d'échelle sur la ligne %d texte du message vide requête vide sur la ligne %d erreur dans le traitement de la transaction en ligne %d l'insertion d'un tableau de variables n'est pas supportée, sur la ligne %d syntaxe invalide en entrée pour le type float : « %s » sur la ligne %d syntaxe invalide en entrée pour le type int : « %s » sur la ligne %d syntaxe invalide en entrée pour le type unisgned int : « %s » sur la ligne %d nom d'instruction « %s » invalide sur la ligne %d syntaxe invalide en entrée pour le type booléen : « %s » sur la ligne %d aucune donnée trouvée sur la ligne %d non connecté à la connexion « %s » en ligne %d valeur NULL sans indicateur sur la ligne %d mémoire épuisée à la ligne %d la connexion au serveur a été perdue trop peu d'arguments sur la ligne %d trop d'arguments sur la ligne %d élément descripteur « %s » non reconnu sur la ligne %d type « %s » non supporté sur la ligne %d la variable n'est pas de type caractère sur la ligne %d la variable n'est pas de type numeric sur la ligne %d la valeur n'a pas de type tableau sur la ligne %d locale/fr/LC_MESSAGES/libpq5-9.6.mo 0000644 00000060446 14751153421 0012257 0 ustar 00 �� � l
� � �
"
8 ' F ( n � # � � � $ � 9
R 0 ] ( � ( � � � � 5 � 8 3 0 l � $ � # � - % 8 S � � . � ( � , I \ : k " � � � < � a / 0 � ) � ' � * . ? + n ' � ' � * � * + @ * l , � ) � ) � + - D / r + � ( � ) � & ! 5 H 3 ~ & � ! � � + " G v j w � r Y � ! � ' , - T � � # 9 : & t ) � * � # � 9 ) N ' x ) � � ) � " 9 5 . o ' � * � " � " ! . 7! / f! - �! @ �! 2 " ! 8" % Z" % �" & �" V �" = $# ; b# 4 �# 0 �# $ : !$ \$ |$ �$ �$ - �$ -
% ;% + W% 2 �% 7 �% = �% ! ,& . N& 8 }& " �& �& F �& C @' $ �' �' B �' ( ( ; 4( ( p( * �( & �( % �( ! ) 6 3) C j) ? �) 2 �) 1 !* = S* ) �* J �* + + 1+ N+ m+ 1 �+
�+ �+ + �+ , ) #, " M, [ p, �, ? �, 1 %- 8 W- > �- � �- # P. t. : �. � �. 2 N/ Q �/ J �/ K 0 j0 �0 �0 ? �0 ! �0 + 1 @1 Q1 L m1 D �1 % �1 . %2 C T2 �2 $ �2 5 �2 ) 3 � >3 �4 �4 �4 �4 5 5 .5 , =5 - j5 # �5 & �5 �5
6 ' 6 76 N6 l6 G y6 + �6 + �6 7 %7 47 E ;7 H �7 / �7 ) �7 ' $8 < L8 �8 �8 ) �8 Y �8 19 # J9 + n9 1 �9 5 �9 : : L ): % v: �: �: L �: � ; L �; . < ' 3< 6 [< : �< 7 �< 6 = . <= 6 k= 6 �= 7 �= 6 > 8 H> 5 �> 5 �> 7 �> 9 %? ; _? 7 �? 4 �? 5 @ + >@ A j@ F �@ 8 �@ + ,A XA yA " �A / �A � �A � wB �
C $ �C ' �C ! �C * D = 3D � qD 6 5E Q lE < �E 3 �E 3 /F / cF R �F < �F C #G . gG + �G , �G ) �G O H 3 iH 8 �H : �H 4 I 4 FI ? {I < �I < �I T 5J < �J 1 �J , �J + &K , RK � K U L Y [L F �L 3 �L $ 0M F UM ! �M . �M . �M . N / KN / {N �N 6 �N @ �N ? @O Q �O * �O ; �O B 9P 2 |P & �P U �P M ,Q 1 zQ $ �Q O �Q !R # 2R H VR . �R ? �R 6 S ; ES 0 �S I �S Z �S U WT L �T N �T Z IU 7 �U b �U ?V TV pV 2 �V " �V = �V !W 4W = HW 3 �W ; �W : �W � 1X �X ` �X : MY C �Y M �Y � Z 6 �Z �Z N [ � [[ > �[ v :\ m �\ n ] ( �] �] �] S �] , @^ = m^ �^ �^ l �^ U M_ 2 �_ 0 �_ L ` T` ) t` F �` @ �` } ) � E � f * B 0 W > � H � 6 � T � a i h 2 � � + � P � ' w < � � u 7 �
� M � � ? o l X L � � � � � � � m � � { Z g n � @ � � . � � � � 3 � R S D � � c 9 N J � j G % � � z � � � & � 4 r 1 Q � | : � � I � � � b � Y # x ; ` 8
t e � � y ( � � � � � = ^ - � � � � U V ] $ " � ~ � d � � \ _ p , k � A C [ 5 K � ! � � q s O v � � / � � � F � � at character %s %s %s, %s:%s COLUMN NAME: %s
CONSTRAINT NAME: %s
CONTEXT: %s
COPY IN state must be terminated first
COPY OUT state must be terminated first
COPY terminated by new PQexec Crypt authentication not supported
DATATYPE NAME: %s
DETAIL: %s
GSSAPI authentication not supported
GSSAPI continuation error GSSAPI name import error HINT: %s
IPv6 host address may not be empty in URI: "%s"
Kerberos 4 authentication not supported
Kerberos 5 authentication not supported
LINE %d: LOCATION: NOTICE PGEventProc "%s" failed during PGEVT_CONNRESET event
PGEventProc "%s" failed during PGEVT_RESULTCREATE event
PGresult cannot support more than INT_MAX tuples PGresult is not an error result
PQexec not allowed during COPY BOTH
PQgetline: not doing text COPY OUT
QUERY: %s
SCHEMA NAME: %s
SCM_CRED authentication method not supported
SCRAM authentication requires libpq version 10 or above
SSL SYSCALL error: %s
SSL SYSCALL error: EOF detected
SSL certificate's name contains embedded null
SSL certificate's name entry is missing
SSL connection has been closed unexpectedly
SSL error code %lu SSL error: %s
SSL library does not support CRL certificates (file "%s")
SSPI authentication not supported
SSPI continuation error TABLE NAME: %s
Unix-domain socket path "%s" is too long (maximum %d bytes)
WARNING: password file "%s" has group or world access; permissions should be u=rw (0600) or less
WARNING: password file "%s" is not a plain file
WSAIoctl(SIO_KEEPALIVE_VALS) failed: %ui
another command is already in progress
argument of lo_read exceeds integer range
argument of lo_truncate exceeds integer range
argument of lo_write exceeds integer range
attribute has no values on LDAP lookup
authentication method %u not supported
cannot determine OID of function lo_close
cannot determine OID of function lo_creat
cannot determine OID of function lo_create
cannot determine OID of function lo_lseek
cannot determine OID of function lo_lseek64
cannot determine OID of function lo_open
cannot determine OID of function lo_tell
cannot determine OID of function lo_tell64
cannot determine OID of function lo_truncate
cannot determine OID of function lo_truncate64
cannot determine OID of function lo_unlink
cannot determine OID of function loread
cannot determine OID of function lowrite
certificate could not be obtained: %s
certificate does not match private key file "%s": %s
certificate present, but not private key file "%s"
column number %d is out of range 0..%d command string is a null pointer
connection in wrong state
connection not open
connection pointer is NULL
could not acquire SSPI credentials could not connect to server: %s
Is the server running locally and accepting
connections on Unix domain socket "%s"?
could not connect to server: %s
Is the server running on host "%s" (%s) and accepting
TCP/IP connections on port %s?
could not connect to server: %s
Is the server running on host "%s" and accepting
TCP/IP connections on port %s?
could not create LDAP structure
could not create SSL context: %s
could not create socket: %s
could not establish SSL connection: %s
could not get client address from socket: %s
could not get home directory to locate root certificate file
Either provide the file or change sslmode to disable server certificate verification.
could not get peer credentials: %s
could not get server's host name from server certificate
could not get socket error status: %s
could not initialize SSL engine "%s": %s
could not interpret result from server: %s could not load SSL engine "%s": %s
could not load private SSL key "%s" from engine "%s": %s
could not load private key file "%s": %s
could not look up local user ID %d: %s
could not open certificate file "%s": %s
could not open file "%s": %s
could not read certificate file "%s": %s
could not read from file "%s": %s
could not read private SSL key "%s" from engine "%s": %s
could not read root certificate file "%s": %s
could not receive data from server: %s
could not send SSL negotiation packet: %s
could not send data to server: %s
could not send startup packet: %s
could not set socket to TCP no delay mode: %s
could not set socket to close-on-exec mode: %s
could not set socket to nonblocking mode: %s
could not translate Unix-domain socket path "%s" to address: %s
could not translate host name "%s" to address: %s
could not write to file "%s": %s
definition of service "%s" not found
duplicate GSS authentication request
duplicate SSPI authentication request
end of string reached when looking for matching "]" in IPv6 host address in URI: "%s"
expected authentication request from server, but received %c
extra key/value separator "=" in URI query parameter: "%s"
forbidden value %%00 in percent-encoded value: "%s"
function requires at least protocol version 3.0
host name must be specified
host name must be specified for a verified SSL connection
incomplete multibyte character
insufficient data in "D" message insufficient data in "T" message insufficient data in "t" message integer of size %lu not supported by pqGetInt integer of size %lu not supported by pqPutInt invalid ExecStatusType code invalid LDAP URL "%s": invalid port number
invalid LDAP URL "%s": missing distinguished name
invalid LDAP URL "%s": must have exactly one attribute
invalid LDAP URL "%s": must have search scope (base/one/sub)
invalid LDAP URL "%s": no filter
invalid LDAP URL "%s": scheme must be ldap://
invalid URI propagated to internal parser routine: "%s"
invalid URI query parameter: "%s"
invalid connection option "%s"
invalid connection state %d, probably indicative of memory corruption
invalid connection state, probably indicative of memory corruption
invalid percent-encoded token: "%s"
invalid port number: "%s"
invalid setenv state %c, probably indicative of memory corruption
invalid socket
invalid sslmode value: "%s"
invalid state %c, probably indicative of memory corruption
keepalives parameter must be an integer
length must be given for binary parameter
line %d too long in service file "%s"
local user with ID %d does not exist
lookup on LDAP server failed: %s
lost synchronization with server, resetting connection lost synchronization with server: got message type "%c", length %d
message contents do not agree with length in message type "%c"
message type 0x%02x arrived from server while idle missing "=" after "%s" in connection info string
missing key/value separator "=" in URI query parameter: "%s"
more than one entry found on LDAP lookup
nested service specifications not supported in service file "%s", line %d
no COPY in progress
no SSL error reported no connection to the server
no entry found on LDAP lookup
no error message available
number of parameters must be between 0 and 65535
out of memory out of memory
out of memory allocating GSSAPI buffer (%d) out of memory for query result parameter number %d is out of range 0..%d password retrieved from file "%s"
private key file "%s" has group or world access; permissions should be u=rw (0600) or less
protocol error: id=0x%x
query to initialize large object functions did not return data
received invalid response to SSL negotiation: %c
requirepeer parameter is not supported on this platform
requirepeer specifies "%s", but actual peer user name is "%s"
root certificate file "%s" does not exist
Either provide the file or change sslmode to disable server certificate verification.
row number %d is out of range 0..%d select() failed: %s
server certificate for "%s" does not match host name "%s"
server closed the connection unexpectedly
This probably means the server terminated abnormally
before or while processing the request.
server does not support SSL, but SSL was required
server sent binary data ("B" message) without prior row description ("T" message) server sent data ("D" message) without prior row description ("T" message) server sent data ("D" message) without prior row description ("T" message)
service file "%s" not found
setsockopt(%s) failed: %s
size_t overflow sslmode value "%s" invalid when SSL support is not compiled in
statement name is a null pointer
syntax error in service file "%s", line %d
timeout expired
unexpected asyncStatus: %d
unexpected character "%c" at position %d in URI (expected ":" or "/"): "%s"
unexpected character %c following empty query response ("I" message) unexpected field count in "D" message unexpected message from server during startup
unexpected response from server; first received character was "%c"
unrecognized SSL error code: %d
unrecognized socket error: 0x%08X/%d unterminated quoted string in connection info string
user name lookup failure: error code %lu
Project-Id-Version: PostgreSQL 9.6
Report-Msgid-Bugs-To: pgsql-bugs@postgresql.org
POT-Creation-Date: 2021-04-09 11:49+0000
PO-Revision-Date: 2021-04-11 09:47+0200
Last-Translator: Guillaume Lelarge <guillaume@lelarge.info>
Language-Team: PostgreSQLfr <pgsql-fr-generale@postgresql.org>
Language: fr
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
X-Generator: Poedit 2.4.2
au caractère %s %s %s, %s : %s NOM DE COLONNE : %s
NOM DE CONTRAINTE : %s
CONTEXTE : %s
l'état COPY IN doit d'abord être terminé
l'état COPY OUT doit d'abord être terminé
COPY terminé par un nouveau PQexec authentification crypt non supportée
NOM DU TYPE DE DONNÉES : %s
DÉTAIL : %s
authentification GSSAPI non supportée
erreur de suite GSSAPI erreur d'import du nom GSSAPI ASTUCE : %s
l'adresse IPv6 de l'hôte ne peut pas être vide dans l'URI : « %s »
authentification Kerberos 4 non supportée
authentification Kerberos 5 non supportée
LIGNE %d : EMPLACEMENT : NOTICE échec de PGEventProc « %s » lors de l'événement PGEVT_CONNRESET
échec de PGEventProc « %s » lors de l'événement PGEVT_RESULTCREATE
PGresult ne supporte pas plus de INT_MAX lignes PGresult n'est pas un résultat d'erreur
PQexec non autorisé pendant COPY BOTH
PQgetline : ne va pas réaliser un COPY OUT au format texte
REQUÊTE : %s
NOM DE SCHÉMA : %s
authentification SCM_CRED non supportée
L'authentification SCRAM nécessite la bibliothèque libpq en version 10 ou ultérieure.
erreur SYSCALL SSL : %s
erreur SYSCALL SSL : EOF détecté
le nom du certificat SSL contient des NULL
l'entrée du nom du certificat SSL est manquante
la connexion SSL a été fermée de façon inattendu
code d'erreur SSL %lu erreur SSL : %s
la bibliothèque SSL ne supporte pas les certificats CRL (fichier « %s »)
authentification SSPI non supportée
erreur de suite SSPI NOM DE TABLE : %s
Le chemin du socket de domaine Unix, « %s », est trop (maximum %d octets)
ATTENTION : le fichier de mots de passe « %s » a des droits d'accès en
lecture pour le groupe ou universel ; les droits devraient être u=rw (0600)
ou inférieur
ATTENTION : le fichier de mots de passe « %s » n'est pas un fichier texte
WSAIoctl(SIO_KEEPALIVE_VALS) a échoué : %ui
une autre commande est déjà en cours
l'argument de lo_read dépasse l'échelle des entiers
l'argument de lo_truncate dépasse l'échelle des entiers
l'argument de lo_write dépasse l'échelle des entiers
l'attribut n'a pas de valeur après la recherche LDAP
méthode d'authentification %u non supportée
ne peut pas déterminer l'OID de la fonction lo_close
ne peut pas déterminer l'OID de la fonction lo_creat
ne peut pas déterminer l'OID de la fonction lo_create
ne peut pas déterminer l'OID de la fonction lo_lseek
ne peut pas déterminer l'OID de la fonction lo_lseek64
ne peut pas déterminer l'OID de la fonction lo_open
ne peut pas déterminer l'OID de la fonction lo_tell
ne peut pas déterminer l'OID de la fonction lo_tell64
ne peut pas déterminer l'OID de la fonction lo_truncate
ne peut pas déterminer l'OID de la fonction lo_truncate64
ne peut pas déterminer l'OID de la fonction lo_unlink
ne peut pas déterminer l'OID de la fonction loread
ne peut pas déterminer l'OID de la fonction lowrite
le certificat n'a pas pu être obtenu : %s
le certificat ne correspond pas à la clé privée « %s » : %s
le certificat est présent, mais la clé privée « %s » est absente
le numéro de colonne %d est en dehors des limites 0..%d la chaîne de commande est un pointeur nul
connexion dans un état erroné
la connexion n'est pas active
le pointeur de connexion est NULL
n'a pas pu obtenir les pièces d'identité SSPI n'a pas pu se connecter au serveur : %s
Le serveur est-il actif localement et accepte-t-il les connexions sur la
socket Unix « %s » ?
n'a pas pu se connecter au serveur : %s
Le serveur est-il actif sur l'hôte « %s » (%s)
et accepte-t-il les connexionsTCP/IP sur le port %s ?
n'a pas pu se connecter au serveur : %s
Le serveur est-il actif sur l'hôte « %s » et accepte-t-il les connexions
TCP/IP sur le port %s ?
n'a pas pu créer la structure LDAP
n'a pas pu créer le contexte SSL : %s
n'a pas pu créer la socket : %s
n'a pas pu établir la connexion SSL : %s
n'a pas pu obtenir l'adresse du client depuis la socket : %s
n'a pas pu obtenir le répertoire personnel pour situer le fichier de certificat racine.
Fournissez le fichier ou modifiez sslmode pour désactiver la vérification du
certificat par le serveur.
n'a pas pu obtenir l'authentification de l'autre : %s
n'a pas pu récupérer le nom d'hôte du serveur à partir du certificat serveur
n'a pas pu déterminer le statut d'erreur de la socket : %s
n'a pas pu initialiser le moteur SSL « %s » : %s
n'a pas pu interpréter la réponse du serveur : %s n'a pas pu charger le moteur SSL « %s » : %s
n'a pas pu charger la clé privée SSL « %s » à partir du moteur « %s » : %s
n'a pas pu charger le fichier de clé privée « %s » : %s
n'a pas pu rechercher l'identifiant de l'utilisateur local %d : %s
n'a pas pu ouvrir le certificat « %s » : %s
n'a pas pu ouvrir le fichier « %s » : %s
n'a pas pu lire le certificat « %s » : %s
n'a pas pu lire le fichier « %s » : %s
n'a pas pu lire la clé privée SSL « %s » à partir du moteur « %s » : %s
n'a pas pu lire le certificat racine « %s » : %s
n'a pas pu recevoir des données depuis le serveur : %s
n'a pas pu transmettre le paquet de négociation SSL : %s
n'a pas pu transmettre les données au serveur : %s
n'a pas pu transmettre le paquet de démarrage : %s
n'a pas pu activer le mode TCP sans délai pour la socket : %s
n'a pas pu paramétrer la socket en mode close-on-exec : %s
n'a pas pu activer le mode non-bloquant pour la socket : %s
n'a pas pu traduire le chemin de la socket du domaine Unix « %s » en adresse :
%s
n'a pas pu traduire le nom d'hôte « %s » en adresse : %s
n'a pas pu écrire dans le fichier « %s » : %s
définition du service « %s » introuvable
requête d'authentification GSS dupliquée
requête d'authentification SSPI dupliquée
fin de chaîne atteinte lors de la recherche du « ] » correspondant dans
l'adresse IPv6 de l'hôte indiquée dans l'URI : « %s »
attendait une requête d'authentification en provenance du serveur, mais a
reçu %c
séparateur « = » de clé/valeur en trop dans le paramètre de requête URI : « %s »
valeur %%00 interdite dans la valeur codée en pourcentage : « %s »
la fonction nécessite au minimum le protocole 3.0
le nom d'hôte doit être précisé
le nom d'hôte doit être précisé pour une connexion SSL vérifiée
caractère multi-octet incomplet
données insuffisantes dans le message « D » données insuffisantes dans le message « T » données insuffisantes dans le message « t » entier de taille %lu non supporté par pqGetInt entier de taille %lu non supporté par pqPutInt code ExecStatusType invalide URL LDAP « %s » invalide : numéro de port invalide
URL LDAP « %s » invalide : le « distinguished name » manque
URL LDAP « %s » invalide : doit avoir exactement un attribut
URL LDAP « %s » invalide : doit avoir une échelle de recherche (base/un/sous)
URL LDAP « %s » invalide : aucun filtre
URL LDAP « %s » invalide : le schéma doit être ldap://
URI invalide propagée à la routine d'analyse interne : « %s »
paramètre de la requête URI invalide : « %s »
option de connexion « %s » invalide
état de connexion invalide (%d), indiquant probablement une corruption de
mémoire
état de connexion invalide, indique probablement une corruption de mémoire
jeton encodé en pourcentage invalide : « %s »
numéro de port invalide : « %s »
état setenv %c invalide, indiquant probablement une corruption de la mémoire
socket invalide
valeur sslmode invalide : « %s »
état %c invalide, indiquant probablement une corruption de la mémoire
le paramètre keepalives doit être un entier
la longueur doit être indiquée pour les paramètres binaires
ligne %d trop longue dans le fichier service « %s »
l'utilisateur local dont l'identifiant est %d n'existe pas
échec de la recherche sur le serveur LDAP : %s
synchronisation perdue avec le serveur, réinitialisation de la connexion synchronisation perdue avec le serveur : a reçu le type de message « %c »,
longueur %d
le contenu du message ne correspond pas avec la longueur du type de message
« %c »
le message de type 0x%02x est arrivé alors que le serveur était en attente « = » manquant après « %s » dans la chaîne des paramètres de connexion
séparateur « = » de clé/valeur manquant dans le paramètre de requête URI : « %s »
plusieurs entrées trouvées pendant la recherche LDAP
spécifications imbriquées de service non supportées dans le fichier service « %s », ligne %d
aucun COPY en cours
aucune erreur SSL reportée aucune connexion au serveur
aucune entrée trouvée pendant la recherche LDAP
aucun message d'erreur disponible
le nombre de paramètres doit être compris entre 0 et 65535
mémoire épuisée mémoire épuisée
mémoire épuisée lors de l'allocation du tampon GSSAPI (%d) mémoire épuisée pour le résultat de la requête le numéro de paramètre %d est en dehors des limites 0..%d mot de passe récupéré dans le fichier fichier « %s »
le fichier de la clé privée « %s » a des droits d'accès en lecture
pour le groupe ou universel ; les droits devraient être u=rw (0600)
ou inférieur
erreur de protocole : id=0x%x
la requête d'initialisation des fonctions pour « Larges Objects » ne renvoie
pas de données
a reçu une réponse invalide à la négociation SSL : %c
le paramètre requirepeer n'est pas supporté sur cette plateforme
requirepeer indique « %s » mais le nom de l'utilisateur réel est « %s »
le fichier de certificat racine « %s » n'existe pas.
Fournissez le fichier ou modifiez sslmode pour désactiver la vérification du
certificat par le serveur.
le numéro de ligne %d est en dehors des limites 0..%d échec de select() : %s
le certificat serveur pour « %s » ne correspond pas au nom d'hôte « %s »
la connexion au serveur a été coupée de façon inattendue
Le serveur s'est peut-être arrêté anormalement avant ou durant le
traitement de la requête.
le serveur ne supporte pas SSL alors que SSL était réclamé
le serveur a envoyé des données binaires (message « B ») sans description
préalable de la ligne (message « T ») le serveur a envoyé des données (message « D ») sans description préalable
de la ligne (message « T ») le serveur a envoyé des données (message « D ») sans description préalable
de la ligne (message « T »)
fichier de service « %s » introuvable
setsockopt(%s) a échoué : %s
saturation de size_t valeur sslmode « %s » invalide si le support SSL n'est pas compilé initialement
le nom de l'instruction est un pointeur nul
erreur de syntaxe dans le fichier service « %s », ligne %d
le délai est dépassé
asyncStatus inattendu : %d
caractère « %c » inattendu à la position %d de l'URI (caractère « : » ou
« / » attendu) : « %s »
caractère %c inattendu à la suite d'une réponse de requête vide (message
« I ») nombre de champs inattendu dans le message « D » message inattendu du serveur lors du démarrage
réponse inattendue du serveur, le premier caractère reçu étant « %c »
code d'erreur SSL inconnu : %d
erreur de socket non reconnue : 0x%08X/%d guillemets non refermés dans la chaîne des paramètres de connexion
échec de la recherche du nom d'utilisateur : code d'erreur %lu
locale/fr/LC_MESSAGES/pg_config-9.6.mo 0000644 00000015016 14751153421 0013007 0 ustar 00 �� * l ; � � E � 0 � : 3 E n I � L � s K K � = B I i � G � J > M � M � ? % G e > � 6 � < # > ` F � P � I 7
4 �
2 �
* �
. , 8 & e � & � � ( � ! B V c � u G < ` � J � v � z r } � � k | � K t P � t R � ~ � X ~ � @ W x � i ; { H � N j O | � v 7 8 � 6 � 3 R
o 5 z 2 � � 3 � + 1 L # ~ + � � � � % * ) $
" '
& ( ! #
%s provides information about the installed version of PostgreSQL.
With no arguments, all known items are shown.
%s [OPTION]...
--bindir show location of user executables
--cc show CC value used when PostgreSQL was built
--cflags show CFLAGS value used when PostgreSQL was built
--cflags_sl show CFLAGS_SL value used when PostgreSQL was built
--configure show options given to "configure" script when
PostgreSQL was built
--cppflags show CPPFLAGS value used when PostgreSQL was built
--docdir show location of documentation files
--htmldir show location of HTML documentation files
--includedir show location of C header files of the client
interfaces
--includedir-server show location of C header files for the server
--ldflags show LDFLAGS value used when PostgreSQL was built
--ldflags_ex show LDFLAGS_EX value used when PostgreSQL was built
--ldflags_sl show LDFLAGS_SL value used when PostgreSQL was built
--libdir show location of object code libraries
--libs show LIBS value used when PostgreSQL was built
--localedir show location of locale support files
--mandir show location of manual pages
--pgxs show location of extension makefile
--pkgincludedir show location of other C header files
--pkglibdir show location of dynamically loadable modules
--sharedir show location of architecture-independent support files
--sysconfdir show location of system-wide configuration files
--version show the PostgreSQL version
-?, --help show this help, then exit
%s: could not find own program executable
%s: invalid argument: %s
Options:
Report bugs to <pgsql-bugs@postgresql.org>.
Try "%s --help" for more information.
Usage:
could not change directory to "%s": %s could not find a "%s" to execute could not identify current directory: %s could not read binary "%s" could not read symbolic link "%s" invalid binary "%s" not recorded pclose failed: %s Project-Id-Version: PostgreSQL 9.6
Report-Msgid-Bugs-To: pgsql-bugs@postgresql.org
POT-Creation-Date: 2016-05-08 21:13+0000
PO-Revision-Date: 2016-05-09 10:19+0200
Last-Translator: Guillaume Lelarge <guillaume@lelarge.info>
Language-Team: PostgreSQLfr <pgsql-fr-generale@postgresql.org>
Language: fr
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
X-Generator: Poedit 1.8.7.1
%s fournit des informations sur la version installée de PostgreSQL.
Sans argument, tous les éléments connus sont affichés.
%s [OPTION]...
--bindir affiche l'emplacement des exécutables utilisateur
--cc affiche la valeur de CC utilisée lors de la
construction de PostgreSQL
--cflags affiche la valeur de CFLAGS utilisée lors de la
construction de PostgreSQL
--cflags_sl affiche la valeur de CFLAGS_SL utilisée lors de la
construction de PostgreSQL
--configure affiche les options passées au script « configure »
lors de la construction de PostgreSQL
--cppflags affiche la valeur de CPPFLAGS utilisée lors de la
construction de PostgreSQL
--docdir affiche l'emplacement des fichiers de documentation
--htmldir affiche l'emplacement des fichiers de documentation HTML
--includedir affiche l'emplacement des fichiers d'en-tête C
des interfaces client
--includedir-server affiche l'emplacement des fichiers d'en-tête C du serveur
--ldflags affiche la valeur de LDFLAGS utilisée à lors de la
construction de PostgreSQL
--ldflags_ex affiche la valeur de LDFLAGS_EX utilisée lors de la
construction de PostgreSQL
--ldflags_sl affiche la valeur de LDFLAGS_SL utilisée lors de la
construction de PostgreSQL
--libdir affiche l'emplacement des bibliothèques
--libs affiche la valeur de LIBS utilisée lors de la
construction de PostgreSQL
--localedir affiche l'emplacement des fichiers de support de la
locale
--mandir affiche l'emplacement des pages man
--pgxs affiche l'emplacement du makefile des extensions
--pkgincludedir affiche l'emplacement des autres fichiers d'en-tête C
--pkglibdir affiche l'emplacement des modules chargeables
dynamiquement
--sharedir affiche l'emplacement des fichiers de support
indépendants de l'architecture
--sysconfdir affiche l'emplacement des fichiers de configuration
globaux du système
--version affiche la version de PostgreSQL
-?, --help affiche cette aide puis quitte
%s : n'a pas pu trouver l'exécutable du programme
%s : argument invalide : %s
Options :
Rapporter les bogues à <pgsql-bugs@postgresql.org>.
Essayer « %s --help » pour plus d'informations.
Usage :
n'a pas pu changer le répertoire par « %s » : %s n'a pas pu trouver un « %s » à exécuter n'a pas pu identifier le répertoire courant : %s n'a pas pu lire le binaire « %s » n'a pas pu lire le lien symbolique « %s » binaire « %s » invalide non enregistré échec de pclose : %s locale/fr/LC_MESSAGES/pg_ctl-9.6.mo 0000644 00000046661 14751153421 0012336 0 ustar 00 �� � � � , 0 D 1 ? v � � & �
0
- O
}
�
= �
�
� ! � a � K 0 | A � ! � 3 � ? / H o D � C � E A ? � ? � > 9 F L � B � E � V 0 � F > S 8 � I � % 2 ; O n 7 � � � M - f ! � > � E � C ; y 9 � D 3 C x D � > A @ ( � , � 2 � 6 > B * � / � % � 1 0 4 # e � 4 � 2 � 1 0 A , r . � 3 � + " 1 N 6 � : � 1 � * $ " O 7 r " � $ � J � = Y 3 p 0 � � ! � $ ; - \ � 4 � % � $ ! " *! ! M! F o! u �! F ," s" 7 �" ) �" k �" ` U# % �# & �# $ d $ p$ / �$ & �$ 0 �$ . % - F% t% �% & �% �% , �% ( & ;& ! V& x& �& �& �& �& �& �& ' ' $' 4' " L' o' � �' Z /) P �) �) �) 6 * 1 K* , }* 6 �* �* �* 7 + $ V+ ( {+ � �+ ( A, j j, g �, # =- G a- ! �- : �- @ . z G. � �. | E/ � �/ : M0 ? �0 K �0 > 1 � S1 Q �1 r +2 � �2 7 <3 s t3 z �3 9 c4 k �4 / 5 G 95 � �5 J 6 Q6 ]6 j6 \ ~6 3 �6 - 7 O =7 \ �7 h �7 � S8 I 9 k b9 j �9 i 9: _ �: i ; 6 m; 4 �; G �; > !< W `< 3 �< / �< 7 = A T= @ �= 3 �= ) > D 5> J z> @ �> C ? 6 J? < �? E �? * @ 9 /@ B i@ B �@ J �@ H :A - �A * �A A �A 8 B * WB i �B ! �B ) C ? 8C H xC & �C 6 �C 0 D / PD G �D & �D H �D , 8E ( eE ! �E / �E V �E � 7F L �F * G ? ?G + G � �G | <H 5 �H 2 �H "I � +I ' �I 7 �I 5 J 9 BJ 7 |J 8 �J �J K 4 K + PK 2 |K 1 �K # �K + L 1L KL _L / uL �L �L �L �L M 0M " BM $ eM & �M P W � , � ` n m $ p � ~ < A 9 T ! : M D a G 2 E I { c # d � K | � � Q & ) 8 B 4 _ > f � y ( v L [ h \ ^ Z � 5 X R C F O } + � r � ] u w Y
e � x
7 / k - 0 � q 1 � b j ; 6 t g � N " @ U z H J . � ? s V � % S = � l ' * o 3 i �
%s: -w option cannot use a relative socket directory specification
%s: -w option is not supported when starting a pre-9.1 server
Allowed signal names for kill:
Common options:
Options for register and unregister:
Options for start or restart:
Options for stop or restart:
Report bugs to <pgsql-bugs@postgresql.org>.
Shutdown modes are:
Start types are:
%s init[db] [-D DATADIR] [-s] [-o "OPTIONS"]
%s kill SIGNALNAME PID
%s promote [-D DATADIR] [-s]
%s register [-N SERVICENAME] [-U USERNAME] [-P PASSWORD] [-D DATADIR]
[-S START-TYPE] [-w] [-t SECS] [-o "OPTIONS"]
%s reload [-D DATADIR] [-s]
%s restart [-w] [-t SECS] [-D DATADIR] [-s] [-m SHUTDOWN-MODE]
[-o "OPTIONS"]
%s start [-w] [-t SECS] [-D DATADIR] [-s] [-l FILENAME] [-o "OPTIONS"]
%s status [-D DATADIR]
%s stop [-W] [-t SECS] [-D DATADIR] [-s] [-m SHUTDOWN-MODE]
%s unregister [-N SERVICENAME]
-?, --help show this help, then exit
-D, --pgdata=DATADIR location of the database storage area
-N SERVICENAME service name with which to register PostgreSQL server
-P PASSWORD password of account to register PostgreSQL server
-S START-TYPE service start type to register PostgreSQL server
-U USERNAME user name of account to register PostgreSQL server
-V, --version output version information, then exit
-W do not wait until operation completes
-c, --core-files allow postgres to produce core files
-c, --core-files not applicable on this platform
-e SOURCE event source for logging when running as a service
-l, --log=FILENAME write (or append) server log to FILENAME
-m, --mode=MODE MODE can be "smart", "fast", or "immediate"
-o OPTIONS command line options to pass to postgres
(PostgreSQL server executable) or initdb
-p PATH-TO-POSTGRES normally not necessary
-s, --silent only print errors, no informational messages
-t, --timeout=SECS seconds to wait when using -w option
-w wait until operation completes
auto start service automatically during system startup (default)
demand start service on demand
fast quit directly, with proper shutdown
immediate quit without complete shutdown; will lead to recovery on restart
smart quit after all clients have disconnected
done
failed
stopped waiting
%s is a utility to initialize, start, stop, or control a PostgreSQL server.
%s: -S option not supported on this platform
%s: PID file "%s" does not exist
%s: WARNING: cannot create restricted tokens on this platform
%s: WARNING: could not locate all job object functions in system API
%s: another server might be running; trying to start server anyway
%s: cannot be run as root
Please log in (using, e.g., "su") as the (unprivileged) user that will
own the server process.
%s: cannot promote server; server is not in standby mode
%s: cannot promote server; single-user server is running (PID: %ld)
%s: cannot reload server; single-user server is running (PID: %ld)
%s: cannot restart server; single-user server is running (PID: %ld)
%s: cannot set core file size limit; disallowed by hard limit
%s: cannot stop server; single-user server is running (PID: %ld)
%s: could not access directory "%s": %s
%s: could not allocate SIDs: error code %lu
%s: could not create promote signal file "%s": %s
%s: could not create restricted token: error code %lu
%s: could not determine the data directory using command "%s"
%s: could not find own program executable
%s: could not find postgres program executable
%s: could not open PID file "%s": %s
%s: could not open process token: error code %lu
%s: could not open service "%s": error code %lu
%s: could not open service manager
%s: could not read file "%s"
%s: could not register service "%s": error code %lu
%s: could not remove promote signal file "%s": %s
%s: could not send promote signal (PID: %ld): %s
%s: could not send reload signal (PID: %ld): %s
%s: could not send signal %d (PID: %ld): %s
%s: could not send stop signal (PID: %ld): %s
%s: could not start server
Examine the log output.
%s: could not start server: %s
%s: could not start server: error code %lu
%s: could not start service "%s": error code %lu
%s: could not unregister service "%s": error code %lu
%s: could not wait for server because of misconfiguration
%s: could not write promote signal file "%s": %s
%s: database system initialization failed
%s: directory "%s" does not exist
%s: directory "%s" is not a database cluster directory
%s: invalid data in PID file "%s"
%s: missing arguments for kill mode
%s: no database directory specified and environment variable PGDATA unset
%s: no operation specified
%s: no server running
%s: old server process (PID: %ld) seems to be gone
%s: option file "%s" must have exactly one line
%s: server does not shut down
%s: server is running (PID: %ld)
%s: service "%s" already registered
%s: service "%s" not registered
%s: single-user server is running (PID: %ld)
%s: the PID file "%s" is empty
%s: too many command-line arguments (first is "%s")
%s: unrecognized operation mode "%s"
%s: unrecognized shutdown mode "%s"
%s: unrecognized signal name "%s"
%s: unrecognized start type "%s"
(The default is to wait for shutdown, but not for start or restart.)
HINT: The "-m fast" option immediately disconnects sessions rather than
waiting for session-initiated disconnection.
If the -D option is omitted, the environment variable PGDATA is used.
Is server running?
Please terminate the single-user server and try again.
Server started and accepting connections
The program "%s" is needed by %s but was not found in the
same directory as "%s".
Check your installation.
The program "%s" was found by "%s"
but was not the same version as %s.
Check your installation.
Timed out waiting for server startup
Try "%s --help" for more information.
Usage:
WARNING: online backup mode is active
Shutdown will not complete until pg_stop_backup() is called.
Waiting for server startup...
cannot duplicate null pointer (internal error)
child process exited with exit code %d child process exited with unrecognized status %d child process was terminated by exception 0x%X child process was terminated by signal %d: %s command not executable command not found could not change directory to "%s": %s could not find a "%s" to execute could not get current working directory: %s
could not identify current directory: %s could not read binary "%s" could not read symbolic link "%s" invalid binary "%s" out of memory
pclose failed: %s server is still starting up
server promoting
server shutting down
server signaled
server started
server starting
server stopped
starting server anyway
waiting for server to shut down... waiting for server to start... Project-Id-Version: PostgreSQL 9.6
Report-Msgid-Bugs-To: pgsql-bugs@postgresql.org
POT-Creation-Date: 2020-08-25 14:52+0000
PO-Revision-Date: 2020-08-27 19:38+0200
Last-Translator: Guillaume Lelarge <guillaume@lelarge.info>
Language-Team: PostgreSQLfr <pgsql-fr-generale@postgresql.org>
Language: fr
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
X-Generator: Poedit 2.4.1
%s : l'option -w ne peut pas utiliser un chemin relatif vers le répertoire de
la socket
%s : l'option -w n'est pas supportée lors du démarrage d'un serveur pré-9.1
Signaux autorisés pour kill :
Options générales :
Options d'enregistrement ou de dés-enregistrement :
Options pour le démarrage ou le redémarrage :
Options pour l'arrêt ou le redémarrage :
Rapporter les bogues à <pgsql-bugs@postgresql.org>.
Les modes d'arrêt sont :
Les types de démarrage sont :
%s init[db] [-D RÉP_DONNÉES] [-s] [-o "OPTIONS"]
%s kill SIGNAL ID_PROCESSUS
%s promote [-D RÉP_DONNÉES] [-s]
%s register [-N NOM_SERVICE] [-U NOM_UTILISATEUR] [-P MOTDEPASSE]
[-D RÉP_DONNÉES] [-S TYPE_DÉMARRAGE] [-w] [-t SECS] [-o "OPTIONS"]
%s reload [-D RÉP_DONNÉES] [-s]
%s restart [-w] [-t SECS] [-D RÉP_DONNÉES] [-s] [-m MODE_ARRET]
[-o "OPTIONS"]
%s start [-w] [-t SECS] [-D RÉP_DONNÉES] [-s] [-l FICHIER]
[-o "OPTIONS"]
%s status [-D RÉP_DONNÉES]
%s stop [-W] [-t SECS] [-D RÉP_DONNÉES] [-s] [-m MODE_ARRET]
%s unregister [-N NOM_SERVICE]
-?, --help affiche cette aide puis quitte
-D, --pgdata=RÉP_DONNÉES emplacement de stockage du cluster
-N NOM_SERVICE nom du service utilisé pour l'enregistrement du
serveur PostgreSQL
-P MOT_DE_PASSE mot de passe du compte utilisé pour
l'enregistrement du serveur PostgreSQL
-S TYPE_DÉMARRAGE type de démarrage du service pour enregistrer le
serveur PostgreSQL
-U NOM_UTILISATEUR nom de l'utilisateur du compte utilisé pour
l'enregistrement du serveur PostgreSQL
-V, --version affiche la version puis quitte
-W n'attend pas la fin de l'opération
-c, --core-files autorise postgres à produire des fichiers core
-c, --core-files non applicable à cette plateforme
-e SOURCE source de l'événement pour la trace lors de
l'exécution en tant que service
-l, --log=FICHIER écrit (ou ajoute) le journal du serveur dans FICHIER
-m, --mode=MODE MODE peut valoir « smart », « fast » ou
« immediate »
-o OPTIONS options de la ligne de commande à passer à postgres
(exécutable du serveur PostgreSQL) ou à initdb
-p CHEMIN_POSTGRES normalement pas nécessaire
-s, --silent affiche uniquement les erreurs, aucun message
d'informations
-t, --timeout=SECS durée en secondes à attendre lors de l'utilisation
de l'option -w
-w attend la fin de l'opération
auto démarre le service automatiquement lors du démarrage du système
(par défaut)
demand démarre le service à la demande
fast quitte directement, et arrête correctement
immediate quitte sans arrêt complet ; entraîne une
restauration au démarrage suivant
smart quitte après déconnexion de tous les clients
effectué
a échoué
attente arrêtée
%s est un outil pour initialiser, démarrer, arrêter et contrôler un serveur
PostgreSQL.
%s : option -S non supportée sur cette plateforme
%s : le fichier de PID « %s » n'existe pas
%s : ATTENTION : ne peut pas créer les jetons restreints sur cette plateforme
%s : ATTENTION : n'a pas pu localiser toutes les fonctions objet de job dans l'API système
%s : un autre serveur semble en cours d'exécution ; le démarrage du serveur
va toutefois être tenté
%s : ne peut pas être exécuté en tant qu'utilisateur root
Connectez-vous (par exemple en utilisant « su ») sous l'utilisateur (non
privilégié) qui sera propriétaire du processus serveur.
%s : ne peut pas promouvoir le serveur ; le serveur n'est pas en standby
%s : ne peut pas promouvoir le serveur ; le serveur mono-utilisateur est en
cours d'exécution (PID : %ld)
%s : ne peut pas recharger le serveur ; le serveur mono-utilisateur est en
cours d'exécution (PID : %ld)
%s : ne peut pas relancer le serveur ; le serveur mono-utilisateur est en
cours d'exécution (PID : %ld)
%s : n'a pas pu initialiser la taille des fichiers core, ceci est interdit
par une limite dure
%s : ne peut pas arrêter le serveur ; le serveur mono-utilisateur est en
cours d'exécution (PID : %ld)
%s : n'a pas pu accéder au répertoire « %s » : %s
%s : n'a pas pu allouer les SID : code d'erreur %lu
%s : n'a pas pu créer le fichier « %s » signalant la promotion : %s
%s : n'a pas pu créer le jeton restreint : code d'erreur %lu
%s : n'a pas déterminer le répertoire des données en utilisant la commande « %s »
%s : n'a pas pu trouver l'exécutable du programme
%s : n'a pas pu trouver l'exécutable postgres
%s : n'a pas pu ouvrir le fichier de PID « %s » : %s
%s : n'a pas pu ouvrir le jeton du processus : code d'erreur %lu
%s : n'a pas pu ouvrir le service « %s » : code d'erreur %lu
%s : n'a pas pu ouvrir le gestionnaire de services
%s : n'a pas pu lire le fichier « %s »
%s : n'a pas pu enregistrer le service « %s » : code d'erreur %lu
%s : n'a pas pu supprimer le fichier « %s » signalant la promotion : %s
%s : n'a pas pu envoyer le signal de promotion (PID : %ld) : %s
%s : n'a pas pu envoyer le signal de rechargement (PID : %ld) : %s
%s : n'a pas pu envoyer le signal %d (PID : %ld) : %s
%s : n'a pas pu envoyer le signal d'arrêt (PID : %ld) : %s
%s : n'a pas pu démarrer le serveur
Examinez le journal applicatif.
%s : n'a pas pu démarrer le serveur : %s
%s : n'a pas pu démarrer le serveur : code d'erreur %lu
%s : n'a pas pu démarrer le service « %s » : code d'erreur %lu
%s : n'a pas pu supprimer le service « %s » : code d'erreur %lu
%s : n'a pas pu attendre le serveur à cause d'une mauvaise configuration
%s : n'a pas pu écrire le fichier « %s » signalant la promotion : %s
%s : l'initialisation du système a échoué
%s : le répertoire « %s » n'existe pas
%s : le répertoire « %s » n'est pas un répertoire d'instance
%s : données invalides dans le fichier de PID « %s »
%s : arguments manquant pour le mode kill
%s : aucun répertoire de bases de données indiqué et variable
d'environnement PGDATA non initialisée
%s : aucune opération indiquée
%s : aucun serveur en cours d'exécution
%s : l'ancien processus serveur (PID : %ld) semble être parti
%s : le fichier d'options « %s » ne doit comporter qu'une seule ligne
%s : le serveur ne s'est pas arrêté
%s : le serveur est en cours d'exécution (PID : %ld)
%s : le service « %s » est déjà enregistré
%s : le service « %s » n'est pas enregistré
%s : le serveur mono-utilisateur est en cours d'exécution (PID : %ld)
%s : le fichier PID « %s » est vide
%s : trop d'arguments en ligne de commande (le premier étant « %s »)
%s : mode d'opération « %s » non reconnu
%s : mode d'arrêt non reconnu « %s »
%s : signal non reconnu « %s »
%s : type de redémarrage « %s » non reconnu
(Le comportement par défaut attend l'arrêt, pas le démarrage ou le redémarrage.)
ASTUCE : l'option « -m fast » déconnecte immédiatement les sessions plutôt que
d'attendre la déconnexion des sessions déjà présentes.
Si l'option -D est omise, la variable d'environnement PGDATA est utilisée.
Le serveur est-il en cours d'exécution ?
Merci d'arrêter le serveur mono-utilisateur et de réessayer.
Serveur lancé et acceptant les connexions
Le programme « %s » est nécessaire pour %s, mais n'a pas été trouvé
dans le même répertoire que « %s ».
Vérifiez votre installation.
Le programme « %s » a été trouvé par « %s »
mais n'est pas de la même version que %s.
Vérifiez votre installation.
Dépassement du délai pour le démarrage du serveur
Essayer « %s --help » pour plus d'informations.
Usage :
ATTENTION : le mode de sauvegarde en ligne est activé.
L'arrêt ne surviendra qu'au moment où pg_stop_backup() sera appelé.
En attente du démarrage du serveur...
ne peut pas dupliquer un pointeur nul (erreur interne)
le processus fils a quitté avec le code de sortie %d le processus fils a quitté avec un statut %d non reconnu le processus fils a été terminé par l'exception 0x%X le processus fils a été terminé par le signal %d : %s commande non exécutable commande introuvable n'a pas pu modifier le répertoire par « %s » : %s n'a pas pu trouver un « %s » à exécuter n'a pas pu obtenir le répertoire de travail : %s
n'a pas pu identifier le répertoire courant : %s n'a pas pu lire le binaire « %s » n'a pas pu lire le lien symbolique « %s » binaire « %s » invalide mémoire épuisée
échec de pclose : %s le serveur est toujours en cours de démarrage
serveur en cours de promotion
serveur en cours d'arrêt
envoi d'un signal au serveur
serveur démarré
serveur en cours de démarrage
serveur arrêté
lancement du serveur malgré tout
en attente de l'arrêt du serveur... en attente du démarrage du serveur... locale/fr/LC_MESSAGES/initdb-9.6.mo 0000644 00000061754 14751153421 0012337 0 ustar 00 �� � , � <
�
R �
* 5 - F g t ` � � = W W X � A � 5 � J / z 6 � P � C : b Q � 5 � ] % 4 � B � H � G D > � 4 � 9 3 : ? n / � - � > y K ( � # � , - ? 7 m ( � 6 � , ' 2 5 Z F � " � < � & 7 - ^ - � ! � 1 � ? & N / u = � ! � " 6 ( + _ � 0 � ; � $ / 4 & d � $ � ~ � 1 M < � G � 3 " 8 V ( � J � � � � C � - C! 8 q! ! �! , �! �! J " 0 \" 4 �" A �" @ # R E# K �# " �# ! $ � )$ d �$ % %% � D% [ �% R $& K w& % �& �& ' ' ; 8' ; t' � �' @ A( ; �( �( u �) q E* f �* s + & �+ �+ ) �+ t �+ / `, �, & �, 0 �, . �, - &- T- k- & }- # �- �- $ �- ( . + 7. " c. �. " �. ! �. , �. $ / * 8/ % c/ ! �/ �/ �/ 0 �/ 0 (0 ,0 ;0 - M0 {0 & �0 % �0 �0 3 1 :1 T1 ( h1 � �1 f 23 �3 �3 �3 6 �3 � 4 � �4 � 15 � )6 � �6 � ?7 � �8 9 M9 � �9 ! : > 1: � p: � �: � z; � < R �< t �< O Q= > �= x �= w Y> O �> � !? > �? @ �? ; +@ ( g@ 9 �@ O �@ � A 6 �A 2 B 4 IB 5 ~B A �B 4 �B > +C 8 jC 4 �C E �C m D A �D T �D 4 #E ; XE = �E 0 �E A F E EF 2 �F H �F U G J ]G 1 �G T �G 8 /H hH E �H T �H : I I [I 5 �I & �I # J � &J R �J A �J ' @K ` hK E �K P L 1 `L f �L � �L �M 3 N y 5N A �N P �N 6 BO E yO �O x �O G RP H �P c �P i GQ � �Q a :R C �R ? �R � S s �S FT 9 aT � �T h LU W �U \
V 6 jV * �V �V �V L W 6 SW � �W _ X O rX 3 �X { �Y � rZ � [ ~ �[ 2 \ A\ 6 J\ � �\ 7
]
B] 5 P] 9 �] 7 �] 8 �] 1^ J^ 4 _^ / �^ + �^ 2 �^ 1 #_ @ U_ / �_ # �_ - �_ + ` = D` 5 �` T �` *
a + 8a da # �a 8 �a �a �a �a b 2 )b \b < }b ; �b , �b E #c ' ic �c ? �c � � 5 ( � ] � � J l 6 H X � � K z � � r I � � { � N d R V o | ~ � . y U } � m � ` G = * f / $ � > _ � # A � t C 8 Y 0 T , � % + v L 3 � 2 n � � h B j E ? 9 ) ! & � � � q � � D S Z g
e ; ' ^ " F x c � w P [ s � @ i �
1 - \ � u : k � 4 W Q 7 � O � < M p a b �
If the data directory is not specified, the environment variable PGDATA
is used.
Less commonly used options:
Options:
Other options:
Report bugs to <pgsql-bugs@postgresql.org>.
Success. You can now start the database server using:
%s%s%spg_ctl%s -D %s%s%s -l logfile start
Sync to disk skipped.
The data directory might become corrupt if the operating system crashes.
WARNING: enabling "trust" authentication for local connections
You can change this by editing pg_hba.conf or using the option -A, or
--auth-local and --auth-host, the next time you run initdb.
--auth-host=METHOD default authentication method for local TCP/IP connections
--auth-local=METHOD default authentication method for local-socket connections
--lc-collate=, --lc-ctype=, --lc-messages=LOCALE
--lc-monetary=, --lc-numeric=, --lc-time=LOCALE
set default locale in the respective category for
new databases (default taken from environment)
--locale=LOCALE set default locale for new databases
--no-locale equivalent to --locale=C
--pwfile=FILE read password for the new superuser from file
%s [OPTION]... [DATADIR]
-?, --help show this help, then exit
-A, --auth=METHOD default authentication method for local connections
-E, --encoding=ENCODING set default encoding for new databases
-L DIRECTORY where to find the input files
-N, --nosync do not wait for changes to be written safely to disk
-S, --sync-only only sync data directory
-T, --text-search-config=CFG
default text search configuration
-U, --username=NAME database superuser name
-V, --version output version information, then exit
-W, --pwprompt prompt for a password for the new superuser
-X, --xlogdir=XLOGDIR location for the transaction log directory
-d, --debug generate lots of debugging output
-k, --data-checksums use data page checksums
-n, --noclean do not clean up after errors
-s, --show show internal settings
[-D, --pgdata=]DATADIR location for this database cluster
%s initializes a PostgreSQL database cluster.
%s: "%s" is not a valid server encoding name
%s: WARNING: cannot create restricted tokens on this platform
%s: cannot be run as root
Please log in (using, e.g., "su") as the (unprivileged) user that will
own the server process.
%s: could not access directory "%s": %s
%s: could not access file "%s": %s
%s: could not allocate SIDs: error code %lu
%s: could not change permissions of "%s": %s
%s: could not change permissions of directory "%s": %s
%s: could not create directory "%s": %s
%s: could not create restricted token: error code %lu
%s: could not create symbolic link "%s": %s
%s: could not execute command "%s": %s
%s: could not find suitable encoding for locale "%s"
%s: could not find suitable text search configuration for locale "%s"
%s: could not fsync file "%s": %s
%s: could not get exit code from subprocess: error code %lu
%s: could not open directory "%s": %s
%s: could not open file "%s" for reading: %s
%s: could not open file "%s" for writing: %s
%s: could not open file "%s": %s
%s: could not open process token: error code %lu
%s: could not re-execute with restricted token: error code %lu
%s: could not read directory "%s": %s
%s: could not read password from file "%s": %s
%s: could not start process for command "%s": error code %lu
%s: could not stat file "%s": %s
%s: could not write file "%s": %s
%s: data directory "%s" not removed at user's request
%s: directory "%s" exists but is not empty
%s: encoding mismatch
%s: failed to remove contents of data directory
%s: failed to remove contents of transaction log directory
%s: failed to remove data directory
%s: failed to remove transaction log directory
%s: failed to restore old locale "%s"
%s: file "%s" does not exist
%s: file "%s" is not a regular file
%s: input file "%s" does not belong to PostgreSQL %s
Check your installation or specify the correct path using the option -L.
%s: input file location must be an absolute path
%s: invalid authentication method "%s" for "%s" connections
%s: invalid locale name "%s"
%s: invalid locale settings; check LANG and LC_* environment variables
%s: locale "%s" requires unsupported encoding "%s"
%s: locale name has non-ASCII characters, skipped: "%s"
%s: locale name too long, skipped: "%s"
%s: must specify a password for the superuser to enable %s authentication
%s: no data directory specified
You must identify the directory where the data for this database system
will reside. Do this with either the invocation option -D or the
environment variable PGDATA.
%s: out of memory
%s: password file "%s" is empty
%s: password prompt and password file cannot be specified together
%s: removing contents of data directory "%s"
%s: removing contents of transaction log directory "%s"
%s: removing data directory "%s"
%s: removing transaction log directory "%s"
%s: setlocale() failed
%s: superuser name "%s" is disallowed; role names cannot begin with "pg_"
%s: symlinks are not supported on this platform
%s: too many command-line arguments (first is "%s")
%s: transaction log directory "%s" not removed at user's request
%s: transaction log directory location must be an absolute path
%s: warning: specified text search configuration "%s" might not match locale "%s"
%s: warning: suitable text search configuration for locale "%s" is unknown
Data page checksums are disabled.
Data page checksums are enabled.
Encoding "%s" implied by locale is not allowed as a server-side encoding.
The default database encoding will be set to "%s" instead.
Encoding "%s" is not allowed as a server-side encoding.
Rerun %s with a different locale selection.
Enter it again: Enter new superuser password: If you want to create a new database system, either remove or empty
the directory "%s" or run %s
with an argument other than "%s".
If you want to store the transaction log there, either
remove or empty the directory "%s".
It contains a dot-prefixed/invisible file, perhaps due to it being a mount point.
It contains a lost+found directory, perhaps due to it being a mount point.
No usable system locales were found.
Passwords didn't match.
Rerun %s with the -E option.
Running in debug mode.
Running in noclean mode. Mistakes will not be cleaned up.
The database cluster will be initialized with locale "%s".
The database cluster will be initialized with locales
COLLATE: %s
CTYPE: %s
MESSAGES: %s
MONETARY: %s
NUMERIC: %s
TIME: %s
The default database encoding has accordingly been set to "%s".
The default text search configuration will be set to "%s".
The encoding you selected (%s) and the encoding that the
selected locale uses (%s) do not match. This would lead to
misbehavior in various character string processing functions.
Rerun %s and either do not specify an encoding explicitly,
or choose a matching combination.
The files belonging to this database system will be owned by user "%s".
This user must also own the server process.
The program "postgres" is needed by %s but was not found in the
same directory as "%s".
Check your installation.
The program "postgres" was found by "%s"
but was not the same version as %s.
Check your installation.
This might mean you have a corrupted installation or identified
the wrong directory with the invocation option -L.
Try "%s --help" for more information.
Usage:
Use the option "--debug" to see details.
Using a mount point directly as the data directory is not recommended.
Create a subdirectory under the mount point.
cannot duplicate null pointer (internal error)
caught signal
child process exited with exit code %d child process exited with unrecognized status %d child process was terminated by exception 0x%X child process was terminated by signal %d: %s command not executable command not found could not change directory to "%s": %s could not close directory "%s": %s
could not find a "%s" to execute could not get junction for "%s": %s
could not identify current directory: %s could not look up effective user ID %ld: %s could not open directory "%s": %s
could not read binary "%s" could not read directory "%s": %s
could not read symbolic link "%s" could not remove file or directory "%s": %s
could not set junction for "%s": %s
could not stat file or directory "%s": %s
could not write to child process: %s
creating configuration files ... creating directory %s ... creating subdirectories ... fixing permissions on existing directory %s ... invalid binary "%s" ok
out of memory
pclose failed: %s performing post-bootstrap initialization ... running bootstrap script ... selecting default max_connections ... selecting default shared_buffers ... selecting default timezone ... selecting dynamic shared memory implementation ... syncing data to disk ... user does not exist user name lookup failure: error code %lu Project-Id-Version: PostgreSQL 9.6
Report-Msgid-Bugs-To: pgsql-bugs@postgresql.org
POT-Creation-Date: 2020-08-25 14:53+0000
PO-Revision-Date: 2020-08-27 19:37+0200
Last-Translator: Guillaume Lelarge <guillaume@lelarge.info>
Language-Team: PostgreSQLfr <pgsql-fr-generale@postgresql.org>
Language: fr
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
X-Generator: Poedit 2.4.1
Si le répertoire des données n'est pas indiqué, la variable d'environnement
PGDATA est utilisée.
Options moins utilisées :
Options :
Autres options :
Rapporter les bogues à <pgsql-bugs@postgresql.org>.
Succès. Vous pouvez maintenant lancer le serveur de bases de données en utilisant :
%s%s%spg_ctl%s -D %s%s%s -l journal_applicatif start
Synchronisation sur disque ignorée.
Le répertoire des données pourrait être corrompu si le système d'exploitation s'arrêtait brutalement.
ATTENTION : active l'authentification « trust » pour les connexions
locales.
Vous pouvez changer cette configuration en éditant le fichier pg_hba.conf
ou en utilisant l'option -A, ou --auth-local et --auth-host au prochain
lancement d'initdb.
--auth-host=MÉTHODE méthode d'authentification par défaut pour
les connexions locales TCP/IP
--auth-local=MÉTHODE méthode d'authentification par défaut pour
les connexions locales socket
--lc-collate=, --lc-ctype=, --lc-messages=LOCALE
--lc-monetary=, --lc-numeric=, --lc-time=LOCALE
initialise la locale par défaut dans la
catégorie respective pour les nouvelles bases
de données (les valeurs par défaut sont prises
dans l'environnement)
--locale=LOCALE initialise la locale par défaut pour les
nouvelles bases de données
--no-locale équivalent à --locale=C
--pwfile=FICHIER lit le mot de passe du nouveau
super-utilisateur à partir de ce fichier
%s [OPTION]... [RÉP_DONNÉES]
-?, --help affiche cette aide puis quitte
-A, --auth=MÉTHODE méthode d'authentification par défaut pour
les connexions locales
-E, --encoding=ENCODAGE initialise l'encodage par défaut pour les
nouvelles bases de données
-L RÉPERTOIRE indique où trouver les fichiers servant à la
création de l'instance
-N, --nosync n'attend pas que les modifications soient
proprement écrites sur disque
-S, --sync-only synchronise uniquement le répertoire des données
-T, --text-search-config=CFG configuration par défaut de la recherche plein
texte
-U, --username=NOM nom du super-utilisateur de la base de données
-V, --version affiche la version puis quitte
-W, --pwprompt demande un mot de passe pour le nouveau
super-utilisateur
-X, --xlogdir=RÉP_XLOG emplacement du répertoire des journaux de
transactions
-d, --debug engendre un grand nombre de traces de débogage
-k, --data-checksums active l'utilisation des sommes de contrôle
pour les fichiers de données
-n, --noclean ne nettoie pas en cas d'erreur
-s, --show affiche la configuration interne
[-D, --pgdata=]RÉP_DONNÉES emplacement de l'instance
%s initialise une instance PostgreSQL.
%s : « %s » n'est pas un nom d'encodage serveur valide
%s : ATTENTION : ne peut pas créer les jetons restreints sur cette plateforme
%s : ne peut pas être exécuté en tant qu'utilisateur root
Connectez-vous (par exemple en utilisant « su ») sous l'utilisateur (non
privilégié) qui sera propriétaire du processus serveur.
%s : n'a pas pu accéder au répertoire « %s » : %s
%s : n'a pas pu accéder au fichier « %s » : %s
%s : n'a pas pu allouer les SID : code d'erreur %lu
%s : n'a pas pu modifier les droits de « %s » : %s
%s : n'a pas pu modifier les droits du répertoire « %s » : %s
%s : n'a pas pu créer le répertoire « %s » : %s
%s : n'a pas pu créer le jeton restreint : code d'erreur %lu
%s : n'a pas pu créer le lien symbolique « %s » : %s
%s : n'a pas pu exécuter la commande « %s » : %s
%s : n'a pas pu trouver un encodage adéquat pour la locale « %s »
%s : n'a pas pu trouver la configuration de la recherche plein texte en
adéquation avec la locale « %s »
%s : n'a pas pu synchroniser sur disque le fichier « %s » : %s
%s : n'a pas pu récupérer le code de statut du sous-processus : code d'erreur %lu
%s : n'a pas pu ouvrir le répertoire « %s » : %s
%s : n'a pas pu ouvrir le fichier « %s » en lecture : %s
%s : n'a pas pu ouvrir le fichier « %s » en écriture : %s
%s : n'a pas pu ouvrir le fichier « %s » : %s
%s : n'a pas pu ouvrir le jeton du processus : code d'erreur %lu
%s : n'a pas pu ré-exécuter le jeton restreint : code d'erreur %lu
%s : n'a pas pu lire le répertoire « %s » : %s
%s : n'a pas pu lire le mot de passe à partir du fichier « %s » : %s
%s : n'a pas pu démarrer le processus pour la commande « %s » : code d'erreur %lu
%s : n'a pas pu récupérer les informations sur le fichier « %s » : %s
%s : n'a pas pu écrire le fichier « %s » : %s
%s : répertoire des données « %s » non supprimé à la demande de l'utilisateur
%s : le répertoire « %s » existe mais n'est pas vide
%s : différence d'encodage
%s : échec de la suppression du contenu du répertoire des données
%s : échec de la suppression du contenu du répertoire des journaux de transaction
%s : échec de la suppression du répertoire des données
%s : échec de la suppression du répertoire des journaux de transaction
%s : n'a pas pu restaurer l'ancienne locale « %s »
%s : le fichier « %s » n'existe pas
%s : « %s » n'est pas un fichier
%s : le fichier « %s » n'appartient pas à PostgreSQL %s
Vérifiez votre installation ou indiquez le bon chemin avec l'option -L.
%s : l'emplacement du fichier d'entrée doit être indiqué avec un chemin
absolu
%s : méthode d'authentification « %s » invalide pour « %s »
%s : nom de locale invalide (« %s »)
%s : configuration invalide de la locale ; vérifiez les variables d'environnement LANG et LC_*
%s : la locale « %s » nécessite l'encodage « %s » non supporté
%s : le nom de la locale contient des caractères non ASCII, ignoré : « %s »
%s : nom de locale trop long, ignoré : « %s »
%s : vous devez indiquer un mot de passe pour le super-utilisateur pour
activer l'authentification %s
%s : aucun répertoire de données indiqué
Vous devez identifier le répertoire où résideront les données pour ce
système de bases de données. Faites-le soit avec l'option -D soit en
initialisant la variable d'environnement PGDATA.
%s : mémoire épuisée
%s : le fichier de mots de passe « %s » est vide
%s : les options d'invite du mot de passe et le fichier de mots de passe ne
peuvent pas être indiquées simultanément
%s : suppression du contenu du répertoire des données « %s »
%s : suppression du contenu du répertoire des journaux de transaction « %s »
%s : suppression du répertoire des données « %s »
%s : suppression du répertoire des journaux de transaction « %s »
%s : échec de setlocale
%s : le nom de superutilisateur « %s » n'est pas autorisé ; les noms de rôle ne peuvent pas commencer par « pg_ »
%s : les liens symboliques ne sont pas supportés sur cette plateforme
%s : trop d'arguments en ligne de commande (le premier étant « %s »)
%s : répertoire des journaux de transaction « %s » non supprimé à la demande
de l'utilisateur
%s : l'emplacement du répertoire des journaux de transactions doit être
indiqué avec un chemin absolu
%s : attention : la configuration indiquée pour la recherche plein texte,
« %s », pourrait ne pas correspondre à la locale « %s »
%s : attention : pas de configuration de la recherche plein texte connue
pour la locale « %s »
Les sommes de contrôles des pages de données sont désactivées.
Les sommes de contrôles des pages de données sont activées.
L'encodage « %s » a été déduit de la locale mais n'est pas autorisé en tant qu'encodage serveur.
L'encodage par défaut des bases de données sera configuré à « %s ».
L'encodage « %s » n'est pas autorisé en tant qu'encodage serveur.
Ré-exécuter %s avec une locale différente.
Saisissez-le à nouveau : Saisissez le nouveau mot de passe du super-utilisateur : Si vous voulez créer un nouveau système de bases de données, supprimez ou
videz le répertoire « %s ».
Vous pouvez aussi exécuter %s avec un argument autre que « %s ».
Si vous voulez enregistrer ici le journal des transactions, supprimez ou
videz le répertoire « %s ».
Il contient un fichier invisible, peut-être parce qu'il s'agit d'un point de montage.
Il contient un répertoire lost+found, peut-être parce qu'il s'agit d'un point de montage.
Aucune locale système utilisable n'a été trouvée.
Les mots de passe ne sont pas identiques.
Relancez %s avec l'option -E.
Lancé en mode débogage.
Lancé en mode « sans nettoyage ». Les erreurs ne seront pas supprimées.
L'instance sera initialisée avec la locale « %s ».
Le cluster sera initialisé avec les locales
COLLATE: %s
CTYPE: %s
MESSAGES: %s
MONETARY: %s
NUMERIC: %s
TIME: %s
L'encodage par défaut des bases de données a été configuré en conséquence
avec « %s ».
La configuration de la recherche plein texte a été initialisée à « %s ».
L'encodage que vous avez sélectionné (%s) et celui que la locale
sélectionnée utilise (%s) ne sont pas compatibles. Cela peut conduire à
des erreurs dans les fonctions de manipulation de chaînes de caractères.
Ré-exécutez %s sans préciser d'encodage, ou en choisissant une combinaison
compatible.
Les fichiers de ce cluster appartiendront à l'utilisateur « %s ».
Le processus serveur doit également lui appartenir.
Le programme « postgres » est nécessaire à %s mais n'a pas été trouvé dans
le même répertoire que « %s ».
Vérifiez votre installation.
Le programme « postgres » a été trouvé par « %s » mais n'est pas de la même
version que « %s ».
Vérifiez votre installation.
Cela peut signifier que votre installation est corrompue ou que vous avez
identifié le mauvais répertoire avec l'option -L.
Essayer « %s --help » pour plus d'informations.
Usage :
Utilisez l'option « --debug » pour voir le détail.
Utiliser un point de montage comme répertoire des données n'est pas recommandé.
Créez un sous-répertoire sous le point de montage.
ne peut pas dupliquer un pointeur nul (erreur interne)
signal reçu
le processus fils a quitté avec le code de sortie %d le processus fils a quitté avec un statut %d non reconnu le processus fils a été terminé par l'exception 0x%X le processus fils a été terminé par le signal %d : %s commande non exécutable commande introuvable n'a pas pu modifier le répertoire par « %s » : %s n'a pas pu fermer le répertoire « %s » : %s
n'a pas pu trouver un « %s » à exécuter n'a pas pu obtenir la jonction pour « %s » : %s
n'a pas pu identifier le répertoire courant : %s n'a pas pu trouver l'identifiant réel %ld de l'utilisateur : %s n'a pas pu ouvrir le répertoire « %s » : %s
n'a pas pu lire le binaire « %s » n'a pas pu lire le répertoire « %s » : %s
n'a pas pu lire le lien symbolique « %s » n'a pas pu supprimer le fichier ou répertoire « %s » : %s
n'a pas pu configurer la jonction pour « %s » : %s
n'a pas pu récupérer les informations sur le fichier ou répertoire
« %s » : %s
n'a pas pu écrire au processus fils : %s
création des fichiers de configuration... création du répertoire %s... création des sous-répertoires... correction des droits sur le répertoire existant %s... binaire « %s » invalide ok
mémoire épuisée
échec de pclose : %s exécution de l'initialisation après bootstrap... lancement du script bootstrap... sélection de la valeur par défaut pour max_connections... sélection de la valeur par défaut pour shared_buffers... sélection du fuseau horaire par défaut... sélection de l'implémentation de la mémoire partagée dynamique... synchronisation des données sur disque l'utilisateur n'existe pas échec de la recherche du nom d'utilisateur : code d'erreur %lu locale/fr/LC_MESSAGES/pg_rewind-9.6.mo 0000644 00000050750 14751153421 0013036 0 ustar 00 �� � $ � ,
�
- �
1 �
? K I C � ; � C 9 Y G � @ � O ( x � � � � � � J > L , � 6 � < � 1 , ? ^ = � = � 9 D T 4 � 9 � 4 2 = @ p R � > C J 1 k � � � � o � d ] - � 4 � & % L � f P � R : c � - � > / \ ; � � � � # B % a $ � + � � $ � L , h 0 � " � ) � , @ $ ^ $ � # � ' � " � " 5 & X $ � ( � � " ' 1 Y v � � 2 � � ' D / c - � � 6 � ; + ) g � + � % � ! ! ! 4! 3 V! 6 �! 1 �! �! ' " < :" _ w" �" �" ! �" F # c# z# �# 1 �# C �# " $$ . G$ # v$ > �$ 6 �$ 3 % 6 D% 0 {% �% + �% & �% & ;& ! Z& ( |& I �& $ �& ' ' <' - Y' J �' = �' A ( 6 R( 5 �( 5 �( ! �( 7 ) / O) 6 ) 1 �) - �) 9 * } P* 6 �+ H , J N, A �, H �, A $- O f- D �- A �- L =. �. g �. " �. ' / & F/ m/ �/ �/ �/ N �/ O �/ 4 E0 > z0 T �0 A 1 E P1 U �1 B �1 D /2 S t2 H �2 O 3 A a3 H �3 J �3 ] 74 V �4 �4 7 �4 @ 05 q5
�5 ) �5 ( �5 � �5 � t6 P �6 k G7 2 �7 �7 � 8 _ �8 a 9 ~ w9 B �9 ) 9: + c: 7 �: F �: ; % $; # J; / n; + �; 1 �; / �; 6 ,< 1 c< 7 �< W �< = %= B c= / �= < �= < > + P> 2 |> 1 �> : �> ? ? - \? ) �? ) �? 1 �? 2 @ . C@ 6 r@ 2 �@ 0 �@ 8
A ) FA # pA , �A # �A = �A + #B 3 OB , �B H �B K �B * EC : pC & �C b �C 6 5D lD , �D + �D �D . E 3 1E B eE > �E D �E , ,F > YF N �F n �F ! VG xG ! �G Y �G H ) &H ( PH @ yH Z �H 8 I 6 NI , �I Y �I J J ? WJ C �J A �J & K 9 DK 3 ~K 2 �K 2 �K 2 L 0 KL w |L . �L 5 #M + YM 9 �M v �M [ 6N S �N H �N N /O Q ~O 0 �O ^ P T `P W �P F
Q @ TQ R �Q � ' 6 � Y | � � � [ ? r " p � J } � � & = d � 2 { y ; � u / i F
f R 7 � b � 9 k I ) ! l _ q � � � B : � t $ � � 1 % 4 � � � ` U P h � x � ~ * � ]
C w L E @ g 3 a Q c s � 0 m A � < � S X v T , e M z ^ K � H N G 5 O j > � � Z ( o - W . � � D V \ # + � 8 n �
Report bugs to <pgsql-bugs@postgresql.org>.
creating backup label and updating control file
--debug write a lot of debug messages
--source-pgdata=DIRECTORY source data directory to synchronize with
--source-server=CONNSTR source server to synchronize with
-?, --help show this help, then exit
-D, --target-pgdata=DIRECTORY existing data directory to modify
-P, --progress write progress messages
-V, --version output version information, then exit
-n, --dry-run stop before modifying anything
block %u
"%s" is a symbolic link, but symbolic links are not supported on this platform
"%s" is not a directory
"%s" is not a regular file
"%s" is not a symbolic link
%*s/%s kB (%d%%) copied %d: %X/%X - %X/%X
%s %s (%s)
%s resynchronizes a PostgreSQL cluster with another copy of the cluster.
%s: WARNING: cannot create restricted tokens on this platform
%s: could not allocate SIDs: error code %lu
%s: could not create restricted token: error code %lu
%s: could not get exit code from subprocess: error code %lu
%s: could not open process token: error code %lu
%s: could not re-execute with restricted token: error code %lu
%s: could not start process for command "%s": error code %lu
%s: no source specified (--source-pgdata or --source-server)
%s: no target data directory specified (--target-pgdata)
%s: only one of --source-pgdata or --source-server can be specified
%s: too many command-line arguments (first is "%s")
BKPBLOCK_HAS_DATA not set, but data length is %u at %X/%X BKPBLOCK_HAS_DATA set, but no data included at %X/%X BKPBLOCK_SAME_REL set but no previous rel at %X/%X BKPIMAGE_HAS_HOLE not set, but hole offset %u length %u at %X/%X BKPIMAGE_HAS_HOLE set, but hole offset %u length %u block image length %u at %X/%X BKPIMAGE_IS_COMPRESSED set, but block image length %u at %X/%X Done!
Expected a numeric timeline ID.
Expected a transaction log switchpoint location.
Failure, exiting
Options:
Source timeline history:
Target timeline history:
The program "initdb" is needed by %s but was
not found in the same directory as "%s".
Check your installation.
The program "initdb" was found by "%s"
but was not the same version as %s.
Check your installation.
Timeline IDs must be in increasing sequence.
Timeline IDs must be less than child timeline's ID.
Try "%s --help" for more information.
Usage:
%s [OPTION]...
WAL file is from different database system: WAL file database system identifier is %s, pg_control database system identifier is %s WAL file is from different database system: incorrect XLOG_BLCKSZ in page header WAL file is from different database system: incorrect XLOG_SEG_SIZE in page header WAL record modifies a relation, but record type is not recognized
lsn: %X/%X, rmgr: %s, info: %02X
You must run %s as the PostgreSQL superuser.
backup label buffer too small
cannot be executed by "root"
cannot duplicate null pointer (internal error)
clusters are not compatible with this version of pg_rewind
connected to server
contrecord is requested by %X/%X could not clear search_path: %s could not close directory "%s": %s
could not close file "%s": %s
could not close target file "%s": %s
could not create directory "%s": %s
could not create symbolic link at "%s": %s
could not fetch file list: %s could not fetch remote file "%s": %s could not find common ancestor of the source and target cluster's timelines
could not find previous WAL record at %X/%X
could not find previous WAL record at %X/%X: %s
could not open directory "%s": %s
could not open file "%s" for reading: %s
could not open file "%s" for truncation: %s
could not open file "%s": %s
could not open source file "%s": %s
could not open target file "%s": %s
could not read WAL record at %X/%X
could not read WAL record at %X/%X: %s
could not read directory "%s": %s
could not read file "%s": %s
could not read from file "%s": %s
could not read symbolic link "%s": %s
could not remove directory "%s": %s
could not remove file "%s": %s
could not remove symbolic link "%s": %s
could not seek in file "%s": %s
could not seek in source file: %s
could not seek in target file "%s": %s
could not send COPY data: %s could not send end-of-COPY: %s could not send file list: %s could not send query: %s could not set libpq connection to single row mode
could not stat file "%s": %s
could not truncate file "%s" to %u: %s
could not write file "%s": %s
data file "%s" in source is not a regular file
error running query (%s) in source server: %s fetched file "%s", length %d
full_page_writes must be enabled in the source server
getting file chunks
incorrect resource manager data checksum in record at %X/%X invalid action (CREATE) for regular file
invalid block_id %u at %X/%X invalid compressed image at %X/%X, block %d invalid contrecord length %u at %X/%X invalid control file
invalid data in history file
invalid data in history file: %s
invalid info bits %04X in log segment %s, offset %u invalid magic number %04X in log segment %s, offset %u invalid record length at %X/%X: wanted %u, got %u invalid record offset at %X/%X invalid resource manager ID %u at %X/%X need to copy %lu MB (total source directory size is %lu MB)
neither BKPIMAGE_HAS_HOLE nor BKPIMAGE_IS_COMPRESSED set, but block image length is %u at %X/%X no rewind required
out of memory
out-of-order block_id %u at %X/%X out-of-sequence timeline ID %u (after %u) in log segment %s, offset %u reading WAL in target
reading source file list
reading target file list
received chunk for file "%s", offset %s, size %d
received null value for chunk for file "%s", file has been deleted
record length %u at %X/%X too long record with incorrect prev-link %X/%X at %X/%X record with invalid length at %X/%X rewinding from last common checkpoint at %X/%X on timeline %u
servers diverged at WAL position %X/%X on timeline %u
source and target cluster are on the same timeline
source and target clusters are from different systems
source data directory must be shut down cleanly
source file list is empty
source server must not be in recovery mode
symbolic link "%s" target is too long
sync of target directory failed
syncing target data directory
syntax error in history file: %s
target server must be shut down cleanly
target server needs to use either data checksums or "wal_log_hints = on"
there is no contrecord flag at %X/%X unexpected EOF while reading file "%s"
unexpected control file CRC
unexpected control file size %d, expected %d
unexpected data types in result set while fetching remote files: %u %u %u
unexpected null values in result while fetching remote files
unexpected page modification for directory or symbolic link "%s"
unexpected pageaddr %X/%X in log segment %s, offset %u unexpected result format while fetching remote files
unexpected result length while fetching remote files
unexpected result set from query
unexpected result set size while fetching remote files
unexpected result set while fetching file list
unexpected result set while fetching remote file "%s"
unexpected result while fetching remote files: %s unexpected result while sending file list: %s unrecognized result "%s" for current WAL insert location
Project-Id-Version: pg_rewind (PostgreSQL) 9.6
Report-Msgid-Bugs-To: pgsql-bugs@postgresql.org
POT-Creation-Date: 2020-11-07 22:52+0000
PO-Revision-Date: 2019-02-05 08:27+0100
Last-Translator: Guillaume Lelarge <guillaume@lelarge.info>
Language-Team:
Language: fr
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
X-Generator: Poedit 2.2.1
Rapporter les bogues à <pgsql-bugs@postgresql.org>.
création du fichier backup_label et mise à jour du fichier contrôle
--debug écrit beaucoup de messages de débogage
--source-pgdata=RÉPERTOIRE répertoire de données source
--source-server=CONNSTR serveur source pour la synchronisation
-?, --help affiche cette aide, puis quitte
-D, --target-pgdata=RÉPERTOIRE répertoire de données existant à modifier
-P, --progress écrit les messages de progression
-V, --version affiche la version, puis quitte
-n, --dry-run arrête avant de modifier quoi que ce soit
bloc %u
« %s » est un lien symbolique mais les liens symboliques ne sont pas supportés sur cette plateforme
« %s » n'est pas un répertoire
« %s » n'est pas un fichier standard
« %s » n'est pas un lien symbolique
%*s/%s Ko (%d%%) copiés %d : %X/%X - %X/%X
%s %s (%s)
%s resynchronise une instance PostgreSQL avec une autre copie de
l'instance.
%s : ATTENTION : ne peut pas créer les jetons restreints sur cette plateforme
%s : n'a pas pu allouer les SID : code d'erreur %lu
%s : n'a pas pu créer le jeton restreint : code d'erreur %lu
%s : n'a pas pu récupérer le code de statut du sous-processus : code d'erreur %lu
%s : n'a pas pu ouvrir le jeton du processus : code d'erreur %lu
%s : n'a pas pu ré-exécuter le jeton restreint : code d'erreur %lu
%s : n'a pas pu démarrer le processus pour la commande « %s » : code d'erreur %lu
%s : aucune source indiquée (--source-pgdata ou --source-server)
%s : aucun répertoire de données cible indiqué (--target-pgdata)
%s : une seule des options --source-pgdata et --source-server peut être indiquée
%s : trop d'arguments en ligne de commande (le premier étant « %s »)
BKPBLOCK_HAS_DATA non configuré, mais la longueur des données est %u à %X/%X BKPBLOCK_HAS_DATA configuré, mais aucune donnée inclus à %X/%X BKPBLOCK_SAME_REL configuré, mais pas de relation précédente à %X/%X BKPIMAGE_HAS_HOLE désactivé, mais décalage trou %u longueur %u à %X/%X BKPIMAGE_HAS_HOLE activé, mais décalage trou %u longueur %u longueur image bloc %u à %X/%X BKPIMAGE_IS_COMPRESSED configuré, mais la longueur de l'image du bloc est %u à %X/%X Terminé !
Attendait un identifiant numérique de ligne de temps.
Attendait un emplacement de bascule de journal de transactions.
Échec, sortie
Options :
Historique de la ligne de temps source :
Historique de la ligne de temps cible :
Le programme « initdb » est nécessaire pour %s, mais n'a pas été trouvé
dans le même répertoire que « %s ».
Vérifiez votre installation.
Le programme « initdb » a été trouvé par « %s », mais n'est pas de la même version
que %s.
Vérifiez votre installation.
Les identifiants de ligne de temps doivent être dans une séquence croissante.
Les identifiants de ligne de temps doivent être inférieurs à l'identifiant de la ligne de temps enfant.
Essayez « %s --help » pour plus d'informations.
Usage :
%s [OPTION]...
le fichier WAL provient d'un système différent : l'identifiant système de la base dans le fichier WAL est %s, alors que l'identifiant système de la base dans pg_control est %s le fichier WAL provient d'un système différent : XLOG_BLCKSZ invalide dans l'en-tête de page le fichier WAL provient d'un système différent : XLOG_SEG_SIZE invalide dans l'en-tête de page l'enregistrement WAL modifie une relation mais le type d'enregistrement n'est pas reconnu
lsn : %X/%X, rmgr : %s, info : %02X
Vous devez exécuter %s en tant que super-utilisateur PostgreSQL.
tampon du label de sauvegarde trop petit
ne peut pas être exécuté par « root »
ne peut pas dupliquer un pointeur nul (erreur interne)
les instances ne sont pas compatibles avec cette version de pg_rewind
connecté au serveur
« contrecord » est requis par %X/%X n'a pas pu effacer search_path : %s n'a pas pu fermer le répertoire « %s » : %s
n'a pas pu fermer le fichier « %s » : %s
n'a pas pu fermer le fichier cible « %s » : %s
n'a pas pu créer le répertoire « %s » : %s
n'a pas pu créer le lien symbolique à « %s » : %s
n'a pas pu récupérer la liste des fichiers : %s n'a pas pu récupérer le fichier distant « %s » : %s n'a pas pu trouver l'ancêtre commun des lignes de temps des instances source et cible
n'a pas pu trouver l'enregistrement WAL précédent à %X/%X
n'a pas pu trouver l'enregistrement WAL précédent à %X/%X : %s
n'a pas pu ouvrir le répertoire « %s » : %s
n'a pas pu ouvrir le fichier « %s » pour une lecture : %s
n'a pas pu ouvrir le fichier « %s » pour le troncage : %s
n'a pas pu ouvrir le fichier « %s » : %s
n'a pas pu ouvrir le fichier source « %s » : %s
n'a pas pu ouvrir le fichier cible « %s » : %s
n'a pas pu lire l'enregistrement WAL précédent à %X/%X
n'a pas pu lire l'enregistrement WAL précédent à %X/%X : %s
n'a pas pu lire le répertoire « %s » : %s
n'a pas pu lire le fichier « %s » : %s
n'a pas pu lire le fichier « %s » : %s
n'a pas pu lire le lien symbolique « %s » : %s
n'a pas pu supprimer le répertoire « %s » : %s
n'a pas pu supprimer le fichier « %s » : %s
n'a pas pu supprimer le lien symbolique « %s » : %s
n'a pas pu chercher dans le fichier « %s » : %s
n'a pas pu chercher dans le fichier source : %s
n'a pas pu chercher dans le fichier cible « %s » : %s
n'a pas pu envoyer les données COPY : %s n'a pas pu envoyer end-of-COPY : %s n'a pas pu envoyer la liste de fichiers : %s n'a pas pu envoyer la requête : %s n'a pas pu configurer la connexion libpq en mode ligne seule
n'a pas pu tester le fichier « %s » : %s
n'a pas pu tronquer le fichier « %s » à %u : %s
n'a pas pu écrire le fichier « %s » : %s
le fichier de données « %s » en source n'est pas un fichier standard
erreur lors de l'exécution de la requête (%s) dans le serveur source : %s fichier récupéré « %s », longueur %d
full_page_writes doit être activé sur le serveur source
récupération des parties de fichier
somme de contrôle des données du gestionnaire de ressources incorrecte à
l'enregistrement %X/%X action (CREATE) invalide pour les fichiers réguliers
block_id %u invalide à %X/%X image compressée invalide à %X/%X, bloc %d longueur %u invalide du contrecord à %X/%X Fichier de contrôle invalide
données invalides dans le fichier historique
données invalides dans le fichier historique : %s
bits d'information %04X invalides dans le segment %s, décalage %u numéro magique invalide %04X dans le segment %s, décalage %u longueur invalide de l'enregistrement à %X/%X : voulait %u, a eu %u décalage invalide de l'enregistrement %X/%X identifiant du gestionnaire de ressources invalide %u à %X/%X a besoin de copier %lu Mo (la taille totale du répertoire source est %lu Mo)
ni BKPIMAGE_HAS_HOLE ni BKPIMAGE_IS_COMPRESSED configuré, mais la longueur de l'image du bloc est %u à %X/%X pas de retour en arrière requis
mémoire épuisée
block_id %u désordonné à %X/%X identifiant timeline %u hors de la séquence (après %u) dans le segment %s, décalage %u lecture du WAL dans la cible
lecture de la liste des fichiers sources
lecture de la liste des fichiers cibles
a reçu une partie du fichier « %s », décalage %s, taille %d
a reçu une valeur NULL pour une partie du fichier « %s », le fichier a été supprimé
longueur trop importante de l'enregistrement %u à %X/%X enregistrement avec prev-link %X/%X incorrect à %X/%X enregistrement de longueur invalide à %X/%X retour en arrière depuis le dernier checkpoint commun à %X/%X sur la ligne de temps %u
les serveurs ont divergé à la position %X/%X des WAL sur la timeline %u
les instances source et cible sont sur la même ligne de temps
les instances source et cible proviennent de systèmes différents
le répertoire de données source doit être arrêté proprement
la liste de fichiers sources est vide
le serveur source ne doit pas être en mode restauration
la cible du lien symbolique « %s » est trop long
échec de la synchronisation du répertoire cible
synchronisation du répertoire des données cible
erreur de syntaxe dans le fichier historique : %s
le serveur cible doit être arrêté proprement
le serveur cible doit soit utiliser les sommes de contrôle sur les données soit avoir wal_log_hints configuré à on
il n'existe pas de drapeau contrecord à %X/%X EOF inattendu lors de la lecture du fichier « %s »
CRC inattendu pour le fichier de contrôle
taille %d inattendue du fichier de contrôle, %d attendu
types de données inattendus dans l'ensemble de résultats lors de la récupération des fichiers distants : %u %u %u
valeurs NULL inattendues dans le résultat lors de la récupération des fichiers distants
modification inattendue de page pour le répertoire ou le lien symbolique « %s »
pageaddr %X/%X inattendue dans le journal de transactions %s, segment %u format de résultat inattendu lors de la récupération des fichiers distants
longueur de résultats inattendu lors de la récupération des fichiers distants
ensemble de résultats inattendu de la requête
taille inattendue de l'ensemble de résultats lors de la récupération des fichiers distants
ensemble de résultats inattendu lors de la récupération de la liste des fichiers
ensemble de résultats inattendu lors de la récupération du fichier distant « %s »
résultat inattendu lors de la récupération des fichiers cibles : %s résultat inattendu lors de l'envoi de la liste de fichiers : %s résultat non reconnu « %s » pour l'emplacement d'insertion actuel dans les WAL
locale/fr/LC_MESSAGES/pg_dump-9.6.mo 0000644 00000204727 14751153421 0012520 0 ustar 00 �� � L � | �( �( �( X �( [ 3) B �) ) �) " �) x * �* �* �* �* A �* N &+ P u+ I �+ 3 , y D, G �, C - N J- K �- v �- F \. > �. R �. B 5/ E x/ ? �/ L �/ 3 K0 6 0 Q �0 T 1 M ]1 ? �1 � �1 � y2 ? 23 9 r3 5 �3 : �3 K 4 B i4 D �4 � �4 3 r5 � �5 ? (6 D h6 x �6 6 &7 Q ]7 O �7 F �7 > F8 5 �8 > �8 E �8 A @9 O �9 H �9 B : @ ^: = �: O �: H -; ; v; , �; 4 �; E < 0 Z< = �< ; �< F = D L= C �= F �= 8 > ? U> C �> = �> 4 ? 7 L? L �? = �? @ @ J P@ < �@ L �@ , %A ( RA 5 {A E �A T �A LB 9 OB D �B G �B C 1C ? LC ' �C * �C e �C ! ED , gD 4 �D 6 �D ( E / )E YE wE $ �E * �E 2 �E B F > OF J �F P �F N *G H yG - �G �G H / H HH 4 ZH $ �H & �H * �H # I *I P II C �I A �I ( J IJ gJ �J �J = �J � �J
�K , �K � �K � SL , �L M p +M e �M & N )N ` 1N p �N 4 O X 8O _ �O E �O 1 7P 6 iP 4 �P * �P - Q D .Q . sQ + �Q + �Q ) �Q * $R > OR : �R ' �R = �R ) /S 1 YS �S @ �S 7 �S 6 T 6 VT < �T = �T 4 U 3 =U b qU 9 �U < V t KV # �V , �V 5 W GW hW �W
�W ' �W �W % �W �W / X X JX & �X 0 �X . �X - *Y XY oY �Y 3 �Y ( �Y �Y # �Y !Z & BZ K iZ & �Z �Z ! �Z ( [ ' E[ # m[ # �[ �[ / �[ \ &\ # B\ % f\ �\ , �\ $ �\ $ �\ $ ] 6 E] |] �] B �] � �] � �^ _ $ >_ < c_ 3 �_ * �_ ' �_ + '` ( S` ( |` # �` - �` � �` + �a , �a ! b & Bb ' ib # �b �b " �b 8 �b $ 0c Uc uc Q �c & �c a
d @ od 5 �d , �d e " .e # Qe , ue �e ! �e * �e # f % 2f 0 Xf & �f $ �f �f " �f = g # Ug 1 yg �g �g �g : �g ) h B Gh P �h �h �h
i (i " 8i [i ui & �i & �i % �i 2 j 9j Nj & jj ! �j ) �j # �j " k $k r 5k < �k D �k N *l F yl �l �l & �l , m - Mm {m " �m / �m �m n ( n @ Fn �n �n �n P �n +o > Ao 1 �o > �o / �o Y !p > {p �p �p " �p q & 3q < Zq �q ' �q ( �q ' �q $r Br Yr 1 lr + �r �r % �r 3 s Es ^s " ws ; �s �s �s 0 t 6t / Ut �t �t �t . �t I u > Su D �u �u �u v 7 v 9 Mv 6 �v H �v @ w Hw 3 Zw & �w 0 �w 6 �w / x ( Mx , vx �x " �x �x �x y h !y T �y � �y 6 bz L �z J �z 9 1{ k{ $ z{ + �{ �{ �{ �{ | -| 2 A| t| " �| �| �| �| �| $ } +} & <} c} w} # �} �} $ �} ) �} ~ ! 1~ % S~ + y~ �~ & �~ ' �~ 4 0 Q . � ) � + � � ( #� L� 4 j� � �� # "� * F� q� �� �� �� ( ҁ �� " � 5� E J� # �� �� ̂ � ; � '� =� J� ' f� �� ' �� % � � 0� B M� 0 �� ! �� 8 � : � W� s� 3 �� 1 ƅ 1 �� + *� $ V� $ {� h �� � � ҈ � V � w Z� [ ҉ , .� ' [� � �� � � $� =� y Y� � Ӌ � h� � 8� A �� � �� s Ď r 8� � �� y 0� � �� y 1� H �� � � p x� n � z X� � ӓ E d� G �� | � z o� � � J p� � �� � [� C N� > �� > ј ? � ~ P� P ϙ z � � �� 9 -� � g� F � q f� � > m� � �� � 9� � �� D A� < �� A ß > � > D� m �� q � q c� q ա p G� � �� { >� N �� ? � u I� L �� 8 � J E� G �� � إ � g� y � { b� B ާ Q !� L s� J �� A � n M� � �� s J� q �� P 0� H �� � ʫ , X� , �� A �� K � | @� �� Q �� Y � Z l� " Ǯ � [ � = g� A �� y � . a� > �� O ϰ I � 8 i� ; �� 3 ޱ � + $� 3 P� 9 �� h �� d '� p �� v �� t t� n � @ X� �� �� ? � H /� + x� 6 �� 5 ۶ ( � ) :� � d� V � T <� 6 �� ȸ 4 � 7 � @ V� X �� � � �� 5 �� � � � �� : V� �� � �� | =� 2 �� � � �� � � W � ~ Z� o ٿ Q I� 4 �� 9 � 7
� 8 B� 5 {� R �� : � 7 ?� 7 w� 5 �� 6 �� R � V o� ; �� N � 7 Q� D �� �� W �� P G� K �� L �� V 1� W �� G �� H (� u q� R �� f :� � �� 6 7� 3 n� T �� # �� ) � E� O� 2 j� �� 4 �� , �� 7 � n G� 5 �� 9 �� 7 &� 8 ^� �� �� �� : �� 9 � I� 6 _� 3 �� < �� ^ � 3 f� & �� , �� 7 �� . &� 7 U� / �� - �� 7 �� , #� # P� - t� 8 �� ( �� 1 � / 6� / f� / �� O �� � + 7� ^ c� � �� � �� * �� 6 �� : � E ;� 1 �� A �� 7 �� + -� 1 Y� / �� < �� � �� : �� 9 � / P� 1 �� 0 �� 6 �� - � / H� O x� 9 �� 0 � ( 3� X \� 2 �� s �� X \� E �� 5 �� # 1� - U� 5 �� A �� + �� + '� 3 S� , �� 2 �� O �� = 7� : u� + �� = �� J � 6 e� 6 �� �� �� #
� E .� > t� a �� \ � r� ( �� ) �� �� . �� � - A� * o� ) �� ) �� G �� 6� ( T� 4 }� 7 �� B �� ' -� & U� |� � �� : 6� Q q� f �� [ *� / �� $ �� > �� E � > `� ! �� $ �� 8 �� � ' <� 6 d� H �� �� ' � 5 ,� ^ b� �� Z �� = 8� L v� ; �� e �� C e� ! �� ( �� - �� # "� 0 F� N w� �� - �� 6 � ; E� " �� �� �� G �� + � $ E� # j� Q �� �� �� + � T L� �� . �� E �� / -� F ]� ! �� & �� % �� 4 � n H� c �� i � �� # �� �� H �� a � G �� | �� T E� �� ; �� - �� ? � @ Z� 6 �� ; � 5 � D� 0 V� # �� , �� � � � t �� � �� b � � C� f � _ /� �� 5 �� ? � � 7� $ W� * |� �� H �� � * � F� g� " � $ �� 5 � �� 0 � D� a� / |� �� = � / � * 4� $ _� * �� 7 �� " � .
� / 9� $ i� �� E �� D � A 9 ? { � : � $ N : � � , - ; Z 4 � � # � 2 / b ! � � g � * # ! N p � S � �
- 1 _ 4 } . � 8 � 8 U W 3 � � M N P � ' � 6 � : : X : � ? � 3 � B � � p � � � � m � _ � @ � 8 � �
= n k t ! � � � E � � � � . � & � ] � a � � � � � ! � ( � � ] � U � � j A 0 � � : � '
V ~ q Q � � F � � � - v � � � � Y � � i > � g � � � � � D a T � & + � � j D l � � � � � � � 3 � � � � � � � � f � � � { � � � � 7 � � � � � � r K � � 7 � � I � � I L v � � R � � / � � � � � 9 2 � < 4 $ � d ( � + � � � � � � o c � � 1 u � s � * b � � r � � � - i : � / � 3 ^ z K X X G � ) % � \ � � C � � � # � 2 � H � Q = � B J S ~ T � } � n E H 5 6 �
x � [ J � � y 6 � c o l w h s � � F ? m # p 9 � Z � � � � � ` � Y
� � 5 4 B @ � � z � � � g y { O � , " � � ? � � � � � S b > � N � � � P N . � ; � � � � � ` � q ) � � � � � � � � | � � t ^ � O ; h " � G w � � R V % � , � � � � � � � � � C � � M 0 � W � � _ � � � � f � ' < * � � � \ � L | [ Z } P � � � $ W � � � � � � � 8 � � x A e � d � U � � � � 1 � u e � M � k �
Connection options:
General options:
If -f/--file is not used, then the SQL script will be written to the standard
output.
If no database name is supplied, then the PGDATABASE environment
variable value is used.
If no input file name is supplied, then standard input is used.
Options controlling the output content:
Options controlling the restore:
The options -I, -n, -P, -t, -T, and --section can be combined and specified
multiple times to select multiple objects.
%s
%s [OPTION]...
%s [OPTION]... [DBNAME]
%s [OPTION]... [FILE]
--binary-upgrade for use by upgrade utilities only
--column-inserts dump data as INSERT commands with column names
--disable-dollar-quoting disable dollar quoting, use SQL standard quoting
--disable-triggers disable triggers during data-only restore
--enable-row-security enable row security
--enable-row-security enable row security (dump only content user has
access to)
--exclude-table-data=TABLE do NOT dump data for the named table(s)
--if-exists use IF EXISTS when dropping objects
--inserts dump data as INSERT commands, rather than COPY
--lock-wait-timeout=TIMEOUT fail after waiting TIMEOUT for a table lock
--no-data-for-failed-tables do not restore data of tables that could not be
created
--no-security-labels do not dump security label assignments
--no-security-labels do not restore security labels
--no-synchronized-snapshots do not use synchronized snapshots in parallel jobs
--no-tablespaces do not dump tablespace assignments
--no-tablespaces do not restore tablespace assignments
--no-unlogged-table-data do not dump unlogged table data
--quote-all-identifiers quote all identifiers, even if not key words
--role=ROLENAME do SET ROLE before dump
--role=ROLENAME do SET ROLE before restore
--section=SECTION dump named section (pre-data, data, or post-data)
--section=SECTION restore named section (pre-data, data, or post-data)
--serializable-deferrable wait until the dump can run without anomalies
--snapshot=SNAPSHOT use given snapshot for the dump
--strict-names require table and/or schema include patterns to
match at least one entity each
--use-set-session-authorization
use SET SESSION AUTHORIZATION commands instead of
ALTER OWNER commands to set ownership
-1, --single-transaction restore as a single transaction
-?, --help show this help, then exit
-?, --help show this help, then exit
-C, --create create the target database
-C, --create include commands to create database in dump
-E, --encoding=ENCODING dump the data in encoding ENCODING
-F, --format=c|d|t backup file format (should be automatic)
-F, --format=c|d|t|p output file format (custom, directory, tar,
plain text (default))
-I, --index=NAME restore named index
-L, --use-list=FILENAME use table of contents from this file for
selecting/ordering output
-N, --exclude-schema=SCHEMA do NOT dump the named schema(s)
-O, --no-owner skip restoration of object ownership
-O, --no-owner skip restoration of object ownership in
plain-text format
-P, --function=NAME(args) restore named function
-S, --superuser=NAME superuser user name to use for disabling triggers
-S, --superuser=NAME superuser user name to use in plain-text format
-S, --superuser=NAME superuser user name to use in the dump
-T, --exclude-table=TABLE do NOT dump the named table(s)
-T, --trigger=NAME restore named trigger
-U, --username=NAME connect as specified database user
-V, --version output version information, then exit
-V, --version output version information, then exit
-W, --password force password prompt (should happen automatically)
-Z, --compress=0-9 compression level for compressed formats
-a, --data-only dump only the data, not the schema
-a, --data-only restore only the data, no schema
-b, --blobs include large objects in dump
-c, --clean clean (drop) database objects before recreating
-c, --clean clean (drop) databases before recreating
-d, --dbname=CONNSTR connect using connection string
-d, --dbname=DBNAME database to dump
-d, --dbname=NAME connect to database name
-e, --exit-on-error exit on error, default is to continue
-f, --file=FILENAME output file name
-f, --file=FILENAME output file or directory name
-f, --file=FILENAME output file name (- for stdout)
-g, --globals-only dump only global objects, no databases
-h, --host=HOSTNAME database server host or socket directory
-j, --jobs=NUM use this many parallel jobs to dump
-j, --jobs=NUM use this many parallel jobs to restore
-l, --database=DBNAME alternative default database
-l, --list print summarized TOC of the archive
-n, --schema=NAME restore only objects in this schema
-n, --schema=SCHEMA dump the named schema(s) only
-o, --oids include OIDs in dump
-p, --port=PORT database server port number
-r, --roles-only dump only roles, no databases or tablespaces
-s, --schema-only dump only the schema, no data
-s, --schema-only restore only the schema, no data
-t, --table=NAME restore named relation (table, view, etc.)
-t, --table=TABLE dump the named table(s) only
-t, --tablespaces-only dump only tablespaces, no databases or roles
-v, --verbose verbose mode
-v, --verbose verbose mode
-w, --no-password never prompt for password
-x, --no-privileges do not dump privileges (grant/revoke)
-x, --no-privileges skip restoration of access privileges (grant/revoke)
%s %s dumps a database as a text file or to other formats.
%s extracts a PostgreSQL database cluster into an SQL script file.
%s restores a PostgreSQL database from an archive created by pg_dump.
%s: %s Command was: %s
%s: WSAStartup failed: %d
%s: cannot specify both --single-transaction and multiple jobs
%s: could not connect to database "%s"
%s: could not connect to database "%s": %s %s: could not connect to databases "postgres" or "template1"
Please specify an alternative database.
%s: could not get server version
%s: could not open the output file "%s": %s
%s: could not parse ACL list (%s) for database "%s"
%s: could not parse ACL list (%s) for tablespace "%s"
%s: could not parse server version "%s"
%s: could not re-open the output file "%s": %s
%s: dumping database "%s"...
%s: executing %s
%s: invalid number of parallel jobs
%s: maximum number of parallel jobs is %d
%s: option --if-exists requires option -c/--clean
%s: options -c/--clean and -a/--data-only cannot be used together
%s: options -d/--dbname and -f/--file cannot be used together
%s: options -g/--globals-only and -r/--roles-only cannot be used together
%s: options -g/--globals-only and -t/--tablespaces-only cannot be used together
%s: options -r/--roles-only and -t/--tablespaces-only cannot be used together
%s: options -s/--schema-only and -a/--data-only cannot be used together
%s: pg_dump failed on database "%s", exiting
%s: query failed: %s %s: query was: %s
%s: role name starting with "pg_" skipped (%s)
%s: running "%s"
%s: too many command-line arguments (first is "%s")
%s: unrecognized section name: "%s"
(The INSERT command cannot set OIDs.)
(The system catalogs might be corrupted.)
-C and -1 are incompatible options
COPY failed for table "%s": %s Consider using a full dump instead of a --data-only dump to avoid this problem.
Dumping the contents of table "%s" failed: PQgetCopyData() failed.
Dumping the contents of table "%s" failed: PQgetResult() failed.
Error from TOC entry %d; %u %u %s %s %s
Error message from server: %s Error while FINALIZING:
Error while INITIALIZING:
Error while PROCESSING TOC:
Exported snapshots are not supported by this server version.
NOTICE: there are circular foreign-key constraints on this table:
NOTICE: there are circular foreign-key constraints among these tables:
Password: Report bugs to <pgsql-bugs@postgresql.org>.
Synchronized snapshots are not supported by this server version.
Run with --no-synchronized-snapshots instead if you do not need
synchronized snapshots.
Synchronized snapshots are not supported on standby servers.
Run with --no-synchronized-snapshots instead if you do not need
synchronized snapshots.
TOC Entry %s at %s (length %s, checksum %d)
The command was: %s
The program "pg_dump" is needed by %s but was not found in the
same directory as "%s".
Check your installation.
The program "pg_dump" was found by "%s"
but was not the same version as %s.
Check your installation.
Try "%s --help" for more information.
Usage:
WARNING: aggregate function %s could not be dumped correctly for this database version; ignored
WARNING: archive is compressed, but this installation does not support compression -- no data will be available
WARNING: archive items not in correct section order
WARNING: archive was made on a machine with larger integers, some operations might fail
WARNING: bogus transform definition, at least one of trffromsql and trftosql should be nonzero
WARNING: bogus value in pg_cast.castfunc or pg_cast.castmethod field
WARNING: bogus value in pg_cast.castmethod field
WARNING: bogus value in pg_transform.trffromsql field
WARNING: bogus value in pg_transform.trftosql field
WARNING: bogus value in proargmodes array
WARNING: could not find operator with OID %s
WARNING: could not find where to insert IF EXISTS in statement "%s"
WARNING: could not parse proallargtypes array
WARNING: could not parse proargmodes array
WARNING: could not parse proargnames array
WARNING: could not parse proconfig array
WARNING: could not parse reloptions array
WARNING: could not resolve dependency loop among these items:
WARNING: don't know how to set owner for object type "%s"
WARNING: errors ignored on restore: %d
WARNING: ftell mismatch with expected position -- ftell used
WARNING: invalid creation date in header
WARNING: invalid type "%c" of access method "%s"
WARNING: line ignored: %s
WARNING: owner of aggregate function "%s" appears to be invalid
WARNING: owner of data type "%s" appears to be invalid
WARNING: owner of function "%s" appears to be invalid
WARNING: owner of operator "%s" appears to be invalid
WARNING: owner of operator class "%s" appears to be invalid
WARNING: owner of operator family "%s" appears to be invalid
WARNING: owner of schema "%s" appears to be invalid
WARNING: owner of table "%s" appears to be invalid
WARNING: requested compression not available in this installation -- archive will be uncompressed
WARNING: typtype of data type "%s" appears to be invalid
WARNING: unexpected extra results during COPY of table "%s"
You might not be able to restore the dump without using --disable-triggers or temporarily dropping the constraints.
a worker process died unexpectedly
aborting because of server version mismatch
actual file length (%s) does not match expected (%s)
allocating AH for %s, format %d
already connected to a database
archiver archiver (db) attempting to ascertain archive format
bad dumpId
bad table dumpId for TABLE DATA item
can only reopen input archives
cannot duplicate null pointer (internal error)
cannot restore from compressed archive (compression not supported in this installation)
child process exited with exit code %d child process exited with unrecognized status %d child process was terminated by exception 0x%X child process was terminated by signal %d: %s command not executable command not found compress_io compression is not supported by tar archive format
compression level must be in range 0..9
compressor active
connecting to database for restore
connecting to new database "%s"
connection to database "%s" failed: %s corrupt tar header found in %s (expected %d, computed %d) file position %s
could not change directory to "%s": %s could not close TOC file: %s
could not close archive file: %s
could not close compression library: %s
could not close compression stream: %s
could not close data file "%s": %s
could not close directory "%s": %s
could not close input file: %s
could not close large object TOC file "%s": %s
could not close output file: %s
could not close tar member
could not close temporary file: %s
could not commit database transaction could not compress data: %s
could not create communication channels: %s
could not create directory "%s": %s
could not create large object %u: %s could not create worker process: %s
could not determine seek position in archive file: %s
could not execute query could not find a "%s" to execute could not find block ID %d in archive -- possibly corrupt archive
could not find block ID %d in archive -- possibly due to out-of-order restore request, which cannot be handled due to lack of data offsets in archive
could not find block ID %d in archive -- possibly due to out-of-order restore request, which cannot be handled due to non-seekable input file
could not find entry for ID %d
could not find file "%s" in archive
could not find function definition for function with OID %u
could not find header for file "%s" in tar archive
could not find parent extension for %s %s
could not find slot of finished worker
could not generate temporary file name: %s
could not get server_version from libpq
could not identify current directory: %s could not identify dependency loop
could not initialize compression library: %s
could not obtain lock on relation "%s"
This usually means that someone requested an ACCESS EXCLUSIVE lock on the table after the pg_dump parent process had gotten the initial ACCESS SHARE lock on the table.
could not open TOC file "%s" for input: %s
could not open TOC file "%s" for output: %s
could not open TOC file "%s": %s
could not open TOC file for input: %s
could not open TOC file for output: %s
could not open input file "%s": %s
could not open input file: %s
could not open large object %u: %s could not open large object TOC file "%s" for input: %s
could not open output file "%s": %s
could not open output file: %s
could not open temporary file
could not parse GRANT ACL list (%s) or REVOKE ACL list (%s) for object "%s" (%s)
could not parse default ACL list (%s)
could not parse initial GRANT ACL list (%s) or initial REVOKE ACL list (%s) for object "%s" (%s)
could not parse numeric array "%s": invalid character in number
could not parse numeric array "%s": too many numbers
could not parse result of current_schemas()
could not read binary "%s" could not read directory "%s": %s
could not read from input file: %s
could not read from input file: end of file
could not read input file: %s
could not read symbolic link "%s" could not set default_tablespace to %s: %s could not set default_with_oids: %s could not set search_path to "%s": %s could not set seek position in archive file: %s
could not set session user to "%s": %s could not start database transaction could not uncompress data: %s
could not write to blobs TOC file
could not write to large object (result: %lu, expected: %lu)
could not write to output file: %s
could not write to the communication channel: %s
creating %s "%s"
creating %s "%s.%s"
custom archiver definition of view "%s" appears to be empty (length zero)
did not find magic string in file header
direct database connections are not supported in pre-1.3 archives
directory "%s" does not appear to be a valid archive ("toc.dat" does not exist)
directory archiver directory name too long: "%s"
disabling triggers for %s
dropping %s %s
dumping contents of table "%s.%s"
enabling triggers for %s
entering main parallel loop
entering restore_toc_entries_parallel
entering restore_toc_entries_postfork
entering restore_toc_entries_prefork
entry ID %d out of range -- perhaps a corrupt TOC
error during backup
error during file seek: %s
error processing a parallel work item
error reading large object %u: %s error reading large object TOC file "%s"
error returned by PQputCopyData: %s error returned by PQputCopyEnd: %s executing %s %s
expected %d check constraint on table "%s" but found %d
expected %d check constraints on table "%s" but found %d
expected format (%d) differs from format found in file (%d)
failed sanity check, parent OID %u of table "%s" (OID %u) not found
failed sanity check, parent table OID %u of pg_rewrite entry OID %u not found
failed sanity check, parent table OID %u of sequence OID %u not found
failed to connect to database
file name too long: "%s"
file offset in dump file is too large
finding check constraints for table "%s.%s"
finding default expressions of table "%s.%s"
finding extension tables
finding inheritance relationships
finding the columns and types of table "%s.%s"
finished item %d %s %s
finished main parallel loop
flagging inherited columns in subtables
found unexpected block ID (%d) when reading data -- expected %d
function "%s" not found
identifying extension members
implied data-only restore
incomplete tar header found (%lu byte)
incomplete tar header found (%lu bytes)
index "%s" not found
input file appears to be a text format dump. Please use psql.
input file does not appear to be a valid archive
input file does not appear to be a valid archive (too short?)
input file is too short (read %lu, expected 5)
internal error -- WriteData cannot be called outside the context of a DataDumper routine
internal error -- neither th nor fh specified in tarReadRaw()
invalid ENCODING item: %s
invalid OID for large object
invalid OID for large object (%u)
invalid STDSTRINGS item: %s
invalid adnum value %d for table "%s"
invalid argument string (%s) for trigger "%s" on table "%s"
invalid binary "%s" invalid client encoding "%s" specified
invalid column number %d for table "%s"
invalid column numbering in table "%s"
invalid compression code: %d
invalid dependency %d
invalid dumpId %d
invalid line in large object TOC file "%s": "%s"
invalid message received from worker: "%s"
invalid number of parallel jobs
invalid output format "%s" specified
large-object output not supported in chosen format
last built-in OID is %u
launching item %d %s %s
missing index for constraint "%s"
moving from position %s to next member at file position %s
no item ready
no matching schemas were found
no matching schemas were found for pattern "%s"
no matching tables were found
no matching tables were found for pattern "%s"
no output directory specified
not built with zlib support
now at file position %s
option --if-exists requires option -c/--clean
options --inserts/--column-inserts and -o/--oids cannot be used together
options -c/--clean and -a/--data-only cannot be used together
options -s/--schema-only and -a/--data-only cannot be used together
out of memory
out of on_exit_nicely slots
parallel archiver parallel backup only supported by the directory format
parallel restore from non-seekable file is not supported
parallel restore from standard input is not supported
parallel restore is not supported with archives made by pre-8.0 pg_dump
parallel restore is not supported with this archive file format
pclose failed: %s pgpipe: could not accept connection: error code %d
pgpipe: could not bind: error code %d
pgpipe: could not connect socket: error code %d
pgpipe: could not create second socket: error code %d
pgpipe: could not create socket: error code %d
pgpipe: could not listen: error code %d
pgpipe: getsockname() failed: error code %d
processing %s
processing data for table "%s.%s"
processing item %d %s %s
processing missed item %d %s %s
query failed: %s query produced null referenced table name for foreign key trigger "%s" on table "%s" (OID of table: %u)
query returned %d row instead of one: %s
query returned %d rows instead of one: %s
query to get data of sequence "%s" returned %d row (expected 1)
query to get data of sequence "%s" returned %d rows (expected 1)
query to get data of sequence "%s" returned name "%s"
query to get rule "%s" for table "%s" failed: wrong number of rows returned
query to obtain definition of view "%s" returned more than one definition
query to obtain definition of view "%s" returned no data
query was: %s
read TOC entry %d (ID %d) for %s %s
reading column info for interesting tables
reading constraints
reading default privileges
reading dependency data
reading event triggers
reading extensions
reading foreign key constraints for table "%s.%s"
reading indexes
reading indexes for table "%s.%s"
reading large objects
reading policies
reading procedural languages
reading rewrite rules
reading row-level security policies
reading schemas
reading table inheritance information
reading transforms
reading triggers
reading triggers for table "%s.%s"
reading type casts
reading user-defined access methods
reading user-defined aggregate functions
reading user-defined collations
reading user-defined conversions
reading user-defined foreign servers
reading user-defined foreign-data wrappers
reading user-defined functions
reading user-defined operator classes
reading user-defined operator families
reading user-defined operators
reading user-defined tables
reading user-defined text search configurations
reading user-defined text search dictionaries
reading user-defined text search parsers
reading user-defined text search templates
reading user-defined types
reconnection to database "%s" failed: %s reducing dependencies for %d
restored %d large object
restored %d large objects
restoring data out of order is not supported in this archive format: "%s" is required, but comes before "%s" in the archive file.
restoring large object with OID %u
sanity check on integer size (%lu) failed
saving database definition
saving encoding = %s
saving large objects
saving search_path = %s
saving standard_conforming_strings = %s
schema "%s" not found
schema with OID %u does not exist
select() failed: %s
server version must be at least 7.3 to use schema selection switches
server version: %s; %s version: %s
skipping item %d %s %s
skipping tar member %s
sorter table "%s" could not be created, will not restore its data
table "%s" not found
tar archiver this format cannot be read
transferring dependency %d -> %d to %d
trigger "%s" not found
unexpected COPY statement syntax: "%s"
unexpected data offset flag %d
unexpected policy command type: "%s"
unexpected section code %d
unexpected tgtype value: %d
unrecognized archive format "%s"; please specify "c", "d", or "t"
unrecognized command received from master: "%s"
unrecognized constraint type: %c
unrecognized data block type %d while restoring archive
unrecognized data block type (%d) while searching archive
unrecognized encoding "%s"
unrecognized file format "%d"
unrecognized object type in default privileges: %d
unrecognized proparallel value for function "%s"
unrecognized provolatile value for function "%s"
unsupported version (%d.%d) in file header
warning from original dump file: %s
worker process failed: exit code %d
wrote %lu byte of large object data (result = %lu)
wrote %lu bytes of large object data (result = %lu)
Project-Id-Version: PostgreSQL 9.6
Report-Msgid-Bugs-To: pgsql-bugs@postgresql.org
POT-Creation-Date: 2021-08-31 20:08+0000
PO-Revision-Date: 2021-09-01 10:34+0200
Last-Translator: Guillaume Lelarge <guillaume@lelarge.info>
Language-Team: PostgreSQLfr <pgsql-fr-generale@postgresql.org>
Language: fr
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Plural-Forms: nplurals=2; plural=(n > 1);
X-Generator: Poedit 3.0
Options de connexion :
Options générales :
Si -f/--file n'est pas utilisé, le script SQL sera envoyé sur la sortie
standard.
Si aucune base de données n'est indiquée, la valeur de la variable
d'environnement PGDATABASE est alors utilisée.
Si aucun nom de fichier n'est fourni en entrée, alors l'entrée standard est
utilisée.
Options contrôlant le contenu en sortie :
Options contrôlant la restauration :
Les options -I, -n, -P, -t, -T et --section peuvent être combinées et indiquées
plusieurs fois pour sélectionner plusieurs objets.
%s
%s [OPTION]...
%s [OPTION]... [BASE]
%s [OPTION]... [FICHIER]
--binary-upgrade à n'utiliser que par les outils de mise à
jour seulement
--column-inserts sauvegarde les données avec des commandes
INSERT en précisant les noms des colonnes
--disable-dollar-quoting désactive l'utilisation des guillemets
dollar dans le but de respecter le standard
SQL en matière de guillemets
--disable-triggers désactive les triggers en mode de restauration
des données seules
--enable-row-security active la sécurité niveau ligne
--enable-row-security active la sécurité niveau ligne (et donc
sauvegarde uniquement le contenu visible par
cet utilisateur)
--exclude-table-data=TABLE ne sauvegarde pas les données de la table
indiquée
--if-exists utilise IF EXISTS lors de la suppression des
objets
--inserts sauvegarde les données avec des instructions
INSERT plutôt que COPY
--lock-wait-timeout=DÉLAI échec après l'attente du DÉLAI pour un verrou
de table
--no-data-for-failed-tables ne restaure pas les données des tables qui
n'ont pas pu être créées
--no-security-labels ne sauvegarde pas les affectations de labels de
sécurité
--no-security-labels ne restaure pas les labels de sécurité
--no-synchronized-snapshots n'utilise pas de snapshots synchronisés pour les
jobs en parallèle
--no-tablespaces ne sauvegarde pas les affectations de
tablespaces
--no-tablespaces ne restaure pas les affectations de
tablespaces
--no-unlogged-table-data ne sauvegarde pas les données des tables non
journalisées
--quote-all-identifiers met entre guillemets tous les identifiants
même s'il ne s'agit pas de mots clés
--role=ROLE exécute SET ROLE avant la sauvegarde
--role=ROLE exécute SET ROLE avant la restauration
--section=SECTION sauvegarde la section indiquée (pre-data, data
ou post-data)
--section=SECTION restaure la section indiquée (pre-data, data
ou post-data)
--serializable-deferrable attend jusqu'à ce que la sauvegarde puisse
s'exécuter sans anomalies
--snapshot=SNAPSHOT utilise l'image donnée pour la sauvegarde
--strict-names requiert que les motifs de tables et/ou schémas
correspondent à au moins une entité de chaque
--use-set-session-authorization
utilise les commandes SET SESSION AUTHORIZATION
au lieu des commandes ALTER OWNER pour
modifier les propriétaires
-1, --single-transaction restaure dans une seule transaction
-?, --help affiche cette aide puis quitte
-?, --help affiche cette aide puis quitte
-C, --create crée la base de données cible
-C, --create inclut les commandes de création de la base
dans la sauvegarde
-E, --encoding=ENCODAGE sauvegarde les données dans l'encodage ENCODAGE
-F, --format=c|d|t format du fichier de sauvegarde (devrait être
automatique)
-F, --format=c|d|t|p format du fichier de sortie (personnalisé,
répertoire, tar, texte (par défaut))
-I, --index=NOM restaure l'index indiqué
-L, --use-list=FICHIER utilise la table des matières à partir
de ce fichier pour sélectionner/trier
la sortie
-N, --exclude-schema=SCHÉMA ne sauvegarde pas le schéma indiqué
-O, --no-owner omet la restauration des propriétaires des
objets
-O, --no-owner ne sauvegarde pas les propriétaires des
objets lors de l'utilisation du format texte
-P, --function=NOM(args) restaure la fonction indiquée
-S, --superuser=NOM indique le nom du super-utilisateur à
utiliser pour désactiver les triggers
-S, --superuser=NOM indique le nom du super-utilisateur à
utiliser avec le format texte
-S, --superuser=NOM indique le nom du super-utilisateur à utiliser
avec le format texte
-T, --exclude-table=TABLE ne sauvegarde pas la table indiquée
-T, --trigger=NOM restaure le trigger indiqué
-U, --username=NOM se connecter avec cet utilisateur
-V, --version affiche la version puis quitte
-V, --version affiche la version puis quitte
-W, --password force la demande du mot de passe (par
défaut)
-Z, --compress=0-9 niveau de compression pour les formats
compressés
-a, --data-only sauvegarde uniquement les données, pas le
schéma
-a, --data-only restaure uniquement les données, pas la
structure
-b, --blobs inclut les « Large Objects » dans la
sauvegarde
-c, --clean nettoie/supprime les objets de la base de
données avant de les créer
-c, --clean nettoie (supprime) les bases de données avant de
les créer
-d, --dbname=CHAINE_CONNEX connexion à l'aide de la chaîne de connexion
-d, --dbname=BASE base de données à sauvegarder
-d, --dbname=NOM nom de la base de données utilisée pour la
connexion
-e, --exit-on-error quitte en cas d'erreur, continue par défaut
-f, --file=FICHIER nom du fichier de sortie
-f, --file=FICHIER nom du fichier ou du répertoire en sortie
-f, --file=FICHIER nom du fichier de sortie (- for stdout)
-g, --globals-only sauvegarde uniquement les objets système, pas
le contenu des bases de données
-h, --host=HÔTE hôte du serveur de bases de données ou
répertoire des sockets
-j, --jobs=NUMERO utilise ce nombre de jobs en parallèle pour
la sauvegarde
-j, --jobs=NUMERO utilise ce nombre de jobs en parallèle pour
la restauration
-l, --database=BASE indique une autre base par défaut
-l, --list affiche la table des matières de l'archive (TOC)
-n, --schema=NOM restaure uniquement les objets de ce schéma
-n, --schema=SCHÉMA sauvegarde uniquement le schéma indiqué
-o, --oids inclut les OID dans la sauvegarde
-p, --port=PORT numéro de port du serveur de bases de
données
-r, --roles-only sauvegarde uniquement les rôles, pas les bases
de données ni les tablespaces
-s, --schema-only sauvegarde uniquement la structure, pas les
données
-s, --schema-only restaure uniquement la structure, pas les
données
-t, --table=NOM restaure la relation indiquée (table, vue, etc)
-t, --table=TABLE sauvegarde uniquement la table indiquée
-t, --tablespaces-only sauvegarde uniquement les tablespaces, pas les
bases de données ni les rôles
-v, --verbose mode verbeux
-v, --verbose mode verbeux
-w, --no-password ne demande jamais le mot de passe
-x, --no-privileges ne sauvegarde pas les droits sur les objets
-x, --no-privileges omet la restauration des droits sur les objets
(grant/revoke)
%s %s exporte une base de données dans un fichier texte ou dans d'autres
formats.
%s extrait un cluster de bases de données PostgreSQL dans un fichier de
commandes SQL.
%s restaure une base de données PostgreSQL à partir d'une archive créée par
pg_dump.
%s: %s La commande était : %s
%s : WSAStartup a échoué : %d
%s : les options --single-transaction et -j ne peuvent pas être indiquées
simultanément
%s : n'a pas pu se connecter à la base de données « %s »
%s : n'a pas pu se connecter à la base de données « %s » : %s %s : n'a pas pu se connecter aux bases « postgres » et « template1 ».
Merci de préciser une autre base de données.
%s : n'a pas pu obtenir la version du serveur
%s : n'a pas pu ouvrir le fichier de sauvegarde « %s » : %s
%s : n'a pas pu analyser la liste d'ACL (%s) pour la base de données « %s »
%s : n'a pas pu analyser la liste d'ACL (%s) pour le tablespace « %s »
%s : n'a pas pu analyser la version du serveur « %s »
%s : n'a pas pu rouvrir le fichier de sortie « %s » : %s
%s : sauvegarde de la base de données « %s »...
%s : exécute %s
%s : nombre de jobs en parallèle invalide
%s: le nombre maximum de jobs en parallèle est %d
%s : l'option --if-exists nécessite l'option -c/--clean
%s : les options « -c/--clean » et « -a/--data-only » ne peuvent pas être
utilisées conjointement
%s : les options « -d/--dbname » et « -f/--file » ne peuvent pas être
utilisées conjointement
%s : les options « -g/--globals-only » et « -r/--roles-only » ne peuvent pas
être utilisées conjointement
%s : les options « -g/--globals-only » et « -t/--tablespaces-only » ne
peuvent pas être utilisées conjointement
%s : les options « -r/--roles-only » et « -t/--tablespaces-only » ne peuvent
pas être utilisées conjointement
%s : les options « -s/--schema-only » et « -a/--data-only » ne peuvent pas être
utilisées conjointement
%s : échec de pg_dump sur la base de données « %s », quitte
%s : échec de la requête : %s %s : la requête était : %s
%s : nom de rôle commençant par « pg_ » ignoré (« %s »)
%s : exécute « %s »
%s : trop d'arguments en ligne de commande (le premier étant « %s »)
%s : nom de section non reconnu : « %s »
(La commande INSERT ne peut pas positionner les OID.)
(Les catalogues système sont peut-être corrompus.)
-C et -1 sont des options incompatibles
COPY échoué pour la table « %s » : %s Considérez l'utilisation d'une sauvegarde complète au lieu d'une sauvegarde
des données seulement pour éviter ce problème.
La sauvegarde du contenu de la table « %s » a échoué : échec de
PQgetCopyData().
La sauvegarde du contenu de la table « %s » a échoué : échec de
PQgetResult().
Erreur à partir de l'entrée TOC %d ; %u %u %s %s %s
Message d'erreur du serveur : %s Erreur pendant la finalisation (« FINALIZING ») :
Erreur pendant l'initialisation (« INITIALIZING ») :
Erreur pendant le traitement de la TOC (« PROCESSING TOC ») :
Les images exportées de la base ne sont pas supportées par cette version du serveur.
NOTE : il existe des constraintes de clés étrangères circulaires sur cette table :
NOTE : il existe des constraintes de clés étrangères circulaires sur ces tables :
Mot de passe : Rapporter les bogues à <pgsql-bugs@postgresql.org>.
Les snapshots synchronisés ne sont pas supportés par cette version serveur.
Lancez avec --no-synchronized-snapshots à la place si vous n'avez pas besoin
de snapshots synchronisés.
Les snapshots synchronisés ne sont pas supportés sur les serveurs de stadby.
Lancez avec --no-synchronized-snapshots à la place si vous n'avez pas besoin
de snapshots synchronisés.
entrée TOC %s à %s (longueur %s, somme de contrôle %d)
La commande était : %s
Le programme « pg_dump » est nécessaire à %s mais n'a pas été trouvé dans le
même répertoire que « %s ».
Vérifiez votre installation.
Le programme « pg_dump » a été trouvé par « %s » mais n'a pas la même
version que %s.
Vérifiez votre installation.
Essayer « %s --help » pour plus d'informations.
Usage :
ATTENTION : la fonction d'aggrégat %s n'a pas pu être sauvegardée
correctement avec cette version de la base de données ; ignorée
ATTENTION : l'archive est compressée mais cette installation ne supporte
pas la compression -- aucune donnée ne sera disponible
ATTENTION : les éléments de l'archive ne sont pas dans l'ordre correct de la section
ATTENTION : l'archive a été créée sur une machine disposant d'entiers plus
larges, certaines opérations peuvent échouer
ATTENTION : définition de transformation invalide, au moins un de trffromsql et trftosql ne doit pas valoir 0
ATTENTION : valeur erronée dans le champ pg_cast.castfunc ou pg_cast.castmethod
ATTENTION : valeur erronée dans pg_cast.castmethod
ATTENTION : valeur erronée dans pg_transform.trffromsql
ATTENTION : valeur erronée dans pg_transform.trftosql
ATTENTION : valeur erronée dans le tableau proargmodes
ATTENTION : n'a pas pu trouver l'opérateur d'OID %s
ATTENTION : n'a pas pu trouver où insérer IF EXISTS dans l'instruction « %s »
ATTENTION : n'a pas pu analyser le tableau proallargtypes
ATTENTION : n'a pas pu analyser le tableau proargmodes
ATTENTION : n'a pas pu analyser le tableau proargnames
ATTENTION : n'a pas pu analyser le tableau proconfig
ATTENTION : n'a pas pu analyser le tableau reloptions
ATTENTION : n'a pas pu résoudre la boucle de dépendances parmi ces éléments :
ATTENTION : ne sait pas comment initialiser le propriétaire du type d'objet « %s »
ATTENTION : erreurs ignorées lors de la restauration : %d
ATTENTION : ftell ne correspond pas à la position attendue -- ftell utilisé
ATTENTION : date de création invalide dans l'en-tête
ATTENTION : type « %c » invalide de la méthode d'accès « %s »
ATTENTION : ligne ignorée : %s
ATTENTION : le propriétaire de la fonction d'aggrégat « %s » semble être
invalide
ATTENTION : le propriétaire du type de données « %s » semble être invalide
ATTENTION : le propriétaire de la fonction « %s » semble être invalide
ATTENTION : le propriétaire de l'opérateur « %s » semble être invalide
ATTENTION : le propriétaire de la classe d'opérateur « %s » semble être
invalide
ATTENTION : le propriétaire de la famille d'opérateur « %s » semble être
invalide
ATTENTION : le propriétaire du schéma « %s » semble être invalide
ATTENTION : le propriétaire de la table « %s » semble être invalide
ATTENTION : la compression requise n'est pas disponible avec cette
installation -- l'archive ne sera pas compressée
ATTENTION : la colonne typtype du type de données « %s » semble être invalide
ATTENTION: résultats supplémentaires non attendus durant l'exécution de COPY sur la table « %s »
Il est possible que vous ne puissiez pas restaurer la sauvegarde sans
utiliser --disable-triggers ou sans supprimer temporairement les
constraintes.
un processus worker a subi un arrêt brutal inattendu
annulation à cause de la différence des versions
la longueur réelle du fichier (%s) ne correspond pas à ce qui était attendu
(%s)
allocation d'AH pour %s, format %d
déjà connecté à une base de données
archiveur programme d'archivage (db) tentative d'identification du format de l'archive
mauvais dumpId
mauvais dumpId de table pour l'élément TABLE DATA
peut seulement rouvrir l'archive en entrée
ne peut pas dupliquer un pointeur nul (erreur interne)
ne peut pas restaurer à partir de l'archive compressée (compression non
disponible dans cette installation)
le processus fils a quitté avec le code de sortie %d le processus fils a quitté avec un statut %d non reconnu le processus fils a été terminé par l'exception 0x%X le processus fils a été terminé par le signal %d : %s commande non exécutable commande introuvable compression_io compression non supportée par le format des archives tar
le niveau de compression doit être compris entre 0 et 9
compression activée
connexion à la base de données pour la restauration
connexion à la nouvelle base de données « %s »
la connexion à la base de données « %s » a échoué : %s en-tête tar corrompu trouvé dans %s (%d attendu, %d calculé ) à la
position %s du fichier
n'a pas pu changer le répertoire par « %s » : %s n'a pas pu fermer le fichier TOC : %s
n'a pas pu fermer le fichier d'archive : %s
n'a pas pu fermer la bibliothèque de compression : %s
n'a pas pu fermer le flux de compression : %s
n'a pas pu fermer le fichier de données « %s » : %s
n'a pas pu fermer le répertoire « %s » : %s
n'a pas pu fermer le fichier en entrée : %s
n'a pas pu fermer le TOC du Large Object « %s » : %s
n'a pas pu fermer le fichier de sortie : %s
n'a pas pu fermer le membre de tar
n'a pas pu ouvrir le fichier temporaire : %s
n'a pas pu valider la transaction de la base de données n'a pas pu compresser les données : %s
n'a pas pu créer le canal de communication : %s
n'a pas pu créer le répertoire « %s » : %s
n'a pas pu créer le « Large Object » %u : %s n'a pas pu créer le processus de travail : %s
n'a pas pu déterminer la position de recherche dans le fichier d'archive : %s
n'a pas pu exécuter la requête n'a pas pu trouver un « %s » à exécuter n'a pas pu trouver l'identifiant de bloc %d dans l'archive -
possible corruption de l'archive
n'a pas pu trouver l'identifiant de bloc %d dans l'archive -
il est possible que cela soit dû à une demande de restauration dans un ordre
différent, qui n'a pas pu être géré à cause d'un manque d'information de
position dans l'archive
n'a pas pu trouver l'identifiant de bloc %d dans l'archive -
il est possible que cela soit dû à une demande de restauration dans un ordre
différent, ce qui ne peut pas être géré à cause d'un fichier non gérable en
recherche
n'a pas pu trouver l'entrée pour l'ID %d
n'a pas pu trouver le fichier « %s » dans l'archive
n'a pas pu trouver la définition de la fonction d'OID %u
n'a pas pu trouver l'en-tête du fichier « %s » dans l'archive tar
n'a pas pu trouver l'extension parent pour %s %s
n'a pas pu trouver l'emplacement du worker qui vient de terminer
impossible de créer le nom du fichier temporaire : %s
n'a pas pu obtenir server_version de libpq
n'a pas pu identifier le répertoire courant : %s n'a pas pu identifier la boucle de dépendance
n'a pas pu initialiser la bibliothèque de compression : %s
impossible d'obtenir un verrou sur la relationn « %s »
Cela signifie en général que quelqu'un à demandé un verrou ACCESS EXCLUSIVE sur la table après que pg_dump ait obtenu son verrou ACCESS SHARE initial sur la table.
n'a pas pu ouvrir le fichier TOC « %s » en entrée : %s
n'a pas pu ouvrir le fichier TOC « %s » en sortie : %s
n'a pas pu ouvrir le fichier TOC « %s » : %s
n'a pas pu ouvrir le fichier TOC en entrée : %s
n'a pas pu ouvrir le fichier TOC en sortie : %s
n'a pas pu ouvrir le fichier en entrée « %s » : %s
n'a pas pu ouvrir le fichier en entrée : %s
n'a pas pu ouvrir le « Large Object » %u : %s n'a pas pu ouvrir le fichier sommaire « %s » du Large Object en entrée : %s
n'a pas pu ouvrir le fichier de sauvegarde « %s » : %s
n'a pas pu ouvrir le fichier de sauvegarde : %s
n'a pas pu ouvrir le fichier temporaire
n'a pas pu analyser la liste GRANT ACL (%s) ou REVOKE ACL (%s) de l'objet « %s » (%s)
n'a pas pu analyser la liste ACL par défaut (%s)
n'a pas pu analyser la liste GRANT ACL initiale (%s) ou la liste REVOKE ACL initiale (%s) de l'objet « %s » (%s)
n'a pas pu analyser le tableau numérique « %s » : caractère invalide dans
le nombre
n'a pas pu analyser le tableau numérique « %s » : trop de nombres
n'a pas pu analyser le résultat de current_schema()
n'a pas pu lire le binaire « %s » n'a pas pu lire le répertoire « %s » : %s
n'a pas pu lire à partir du fichier en entrée : %s
n'a pas pu lire à partir du fichier en entrée : fin du fichier
n'a pas pu lire le fichier en entrée : %s
n'a pas pu lire le lien symbolique « %s » n'a pas pu configurer default_tablespace à %s : %s n'a pas pu configurer default_with_oids : %s n'a pas pu configurer search_path à « %s » : %s n'a pas pu initialiser la recherche de position dans le fichier d'archive : %s
n'a pas pu initialiser la session utilisateur à « %s »: %s n'a pas pu démarrer la transaction de la base de données n'a pas pu décompresser les données : %s
n'a pas pu écrire dans le fichier toc des données binaires
n'a pas pu écrire le « Large Object » (résultat : %lu, attendu : %lu)
n'a pas pu écrire dans le fichier de sauvegarde : %s
n'a pas pu écrire dans le canal de communication: %s
création de %s « %s »
création de %s « %s.%s »
programme d'archivage personnalisé la définition de la vue « %s » semble être vide (longueur nulle)
n'a pas trouver la chaîne magique dans le fichier d'en-tête
les connexions directes à la base de données ne sont pas supportées dans
les archives pre-1.3
le répertoire « %s » ne semble pas être une archive valide (« toc.dat » n'existe pas)
archiveur répertoire nom du répertoire trop long : « %s »
désactivation des déclencheurs pour %s
suppression de %s %s
sauvegarde du contenu de la table « %s.%s »
activation des triggers pour %s
entrée dans la boucle parallèle principale
entrée dans restore_toc_entries_parallel
entrée dans restore_toc_entries_prefork
entrée dans restore_toc_entries_prefork
ID %d de l'entrée en dehors de la plage -- peut-être un TOC corrompu
erreur lors de la sauvegarde
erreur lors du parcours du fichier : %s
erreur durant le traitement en parallèle d'un item
erreur lors de la lecture du « Large Object » %u : %s erreur lors de la lecture du TOC du fichier Large Object « %s »
erreur renvoyée par PQputCopyData : %s erreur renvoyée par PQputCopyEnd : %s exécution de %s %s
%d contrainte de vérification attendue pour la table « %s » mais %d
trouvée
%d contraintes de vérification attendues pour la table « %s » mais %d
trouvées
le format attendu (%d) diffère du format du fichier (%d)
vérification échouée, OID %u parent de la table « %s » (OID %u) introuvable
vérification échouée, OID %u de la table parent de l'OID %u de l'entrée de
pg_rewrite introuvable
vérification échouée, OID %u de la table parent de l'OID %u de la séquence introuvable
n'a pas pu se connecter à la base de données
nom du fichier trop long : « %s »
le décalage dans le fichier de sauvegarde est trop important
recherche des contraintes de vérification pour la table « %s.%s »
recherche des expressions par défaut de la table « %s.%s »
recherche des tables d'extension
recherche des relations d'héritage
recherche des colonnes et types de la table « %s.%s »
élément terminé %d %s %s
fin de la boucle parallèle principale
marquage des colonnes héritées dans les sous-tables
ID de bloc inattendu (%d) lors de la lecture des données -- %d attendu
fonction « %s » non trouvée
identification des membres d'extension
a impliqué une restauration des données uniquement
en-tête incomplet du fichier tar (%lu octet)
en-tête incomplet du fichier tar (%lu octets)
index « %s » non trouvé
Le fichier en entrée semble être une sauvegarde au format texte. Merci d'utiliser psql.
le fichier en entrée ne semble pas être une archive valide
le fichier en entrée ne semble pas être une archive valide (trop petit ?)
le fichier en entrée est trop petit (%lu lus, 5 attendus)
erreur interne -- WriteData ne peut pas être appelé en dehors du contexte
de la routine DataDumper
erreur interne -- ni th ni fh ne sont précisés dans tarReadRaw()
élément ENCODING invalide : %s
OID invalide pour le « Large Object »
OID invalide pour le « Large Object » (%u)
élément STDSTRINGS invalide : %s
valeur adnum %d invalide pour la table « %s »
chaîne argument invalide (%s) pour le trigger « %s » sur la table « %s »
binaire « %s » invalide encodage client indiqué (« %s ») invalide
numéro de colonne %d invalide pour la table « %s »
numérotation des colonnes invalide pour la table « %s »
code de compression invalide : %d
dépendance invalide %d
dumpId %d invalide
ligne invalide dans le fichier TOC du Large Object « %s » : « %s »
message invalide reçu du worker: « %s »
nombre de jobs parallèles invalide
format de sortie « %s » invalide
la sauvegarde des « Large Objects » n'est pas supportée dans le format choisi
le dernier OID interne est %u
élément de lancement %d %s %s
index manquant pour la contrainte « %s »
déplacement de la position %s vers le prochain membre à la position %s du fichier
aucun élément prêt
aucun schéma correspondant n'a été trouvé
aucun schéma correspondant n'a été trouvé avec le motif « %s »
aucune table correspondante n'a été trouvée
aucune table correspondante n'a été trouvée avec le motif « %s »
aucun répertoire cible indiqué
pas construit avec le support de zlib
maintenant en position %s du fichier
l'option --if-exists nécessite l'option -c/--clean
les options « --inserts/--column-inserts » et « -o/--oids » ne
peuvent pas être utilisées conjointement
les options « -c/--clean » et « -a/--data-only » ne peuvent pas être
utilisées conjointement
les options « -s/--schema-only » et « -a/--data-only » ne peuvent pas être
utilisées conjointement
mémoire épuisée
plus d'emplacements on_exit_nicely
archiveur en parallèle la sauvegarde parallèle n'est supportée qu'avec le format répertoire
la restauration parallélisée n'est pas supportée à partir de fichiers sans table de matière
la restauration parallélisée n'est pas supportée à partir de stdin
la restauration parallèle n'est pas supportée avec les archives réalisées
par un pg_dump antérieur à la 8.0 d'archive
la restauration parallèle n'est pas supportée avec ce format de fichier
d'archive
échec de pclose : %s pgpipe: n'a pas pu accepter de connexion: code d'erreur %d
pgpipe: n'a pas pu se lier: code d'erreur %d
pgpipe: n'a pas pu de se connecter au socket: code d'erreur %d
pgpipe: n'a pas pu créer un deuxième socket: code d'erreur %d
pgpipe: n'a pas pu créer le socket: code d'erreur %d
pgpipe : n'a pas pu se mettre en écoute: code d'erreur %d
pgpipe: getsocketname() a échoué: code d'erreur %d
traitement de %s
traitement des données de la table « %s.%s »
traitement de l'élément %d %s %s
traitement de l'élément manquant %d %s %s
échec de la requête : %s la requête a produit une réference de nom de table null pour le trigger de
clé étrangère « %s » sur la table « %s » (OID de la table : %u)
la requête a renvoyé %d ligne au lieu d'une seule : %s
la requête a renvoyé %d lignes au lieu d'une seule : %s
la requête permettant d'obtenir les données de la séquence « %s » a renvoyé
%d ligne (une seule attendue)
la requête permettant d'obtenir les données de la séquence « %s » a renvoyé
%d lignes (une seule attendue)
la requête permettant d'obtenir les données de la séquence « %s » a renvoyé
le nom « %s »
la requête permettant d'obtenir la règle « %s » associée à la table « %s »
a échoué : mauvais nombre de lignes renvoyées
la requête permettant d'obtenir la définition de la vue « %s » a renvoyé
plusieurs définitions
la requête permettant d'obtenir la définition de la vue « %s » n'a renvoyé
aucune donnée
la requête était : %s
lecture de l'entrée %d de la TOC (ID %d) pour %s %s
lecture des informations de colonnes des tables intéressantes
lecture des contraintes
lecture des droits par défaut
lecture des données de dépendance
lecture des déclencheurs sur évènement
lecture des extensions
lecture des contraintes de clés étrangères pour la table « %s.%s »
lecture des index
lecture des index de la table « %s.%s »
lecture des « Large Objects »
lecture des politiques
lecture des langages procéduraux
lecture des règles de réécriture
lecture des politiques de sécurité au niveau ligne
lecture des schémas
lecture des informations d'héritage des tables
lecture des transformations
lecture des déclencheurs
lecture des triggers pour la table « %s.%s »
lecture des transtypages
lecture des méthodes d'accès définis par les utilisateurs
lecture des fonctions d'aggrégats utilisateur
lecture des collationnements utilisateurs
lecture des conversions utilisateur
lecture des serveurs distants utilisateur
lecture des wrappers de données distantes utilisateur
lecture des fonctions utilisateur
lecture des classes d'opérateurs utilisateur
lecture des familles d'opérateurs utilisateur
lecture des opérateurs utilisateur
lecture des tables utilisateur
lecture des configurations utilisateur pour la recherche plein texte
lecture des dictionnaires utilisateur pour la recherche plein texte
lecture des analyseurs utilisateur pour la recherche plein texte
lecture des modèles utilisateur pour la recherche plein texte
lecture des types utilisateur
reconnexion à la base de données « %s » échouée : %s réduction des dépendances pour %d
restauration de %d « Large Object »
restauration de %d « Large Objects »
la restauration désordonnée de données n'est pas supportée avec ce format
d'archive : « %s » est requis mais vient avant « %s » dans le fichier
d'archive.
restauration du « Large Object » d'OID %u
échec de la vérification sur la taille de l'entier (%lu)
sauvegarde de la définition de la base de données
encodage de la sauvegarde = %s
sauvegarde des « Large Objects »
sauvegarde de search_path = %s
standard_conforming_strings de la sauvegarde = %s
schéma « %s » non trouvé
le schéma d'OID %u n'existe pas
échec de select() : %s
le serveur doit être de version 7.3 ou supérieure pour utiliser les options
de sélection du schéma
version du serveur : %s ; %s version : %s
omission de l'élément %d %s %s
omission du membre %s du tar
tri la table « %s » n'a pas pu être créée, ses données ne seront pas restaurées
table « %s » non trouvée
archiveur tar ce format ne peut pas être lu
transfert de la dépendance %d -> %d vers %d
trigger « %s » non trouvé
syntaxe inattendue de l'instruction COPY : « %s »
drapeau de décalage de données inattendu %d
type de commande inattendu pour la politique : « %s »
code de section inattendu %d
valeur tgtype inattendue : %d
format d'archive « %s » non reconnu ; merci d'indiquer « c », « d » ou « t »
commande non reconnue reçue du maître : « %s »
type de contrainte inconnu : %c
type de bloc de données %d non reconnu lors de la restauration de l'archive
type de bloc de données non reconnu (%d) lors de la recherche dans
l'archive
encodage « %s » non reconnu
format de fichier « %d » non reconnu
type d'objet inconnu dans les droits par défaut : %d
valeur proparallel non reconnue pour la fonction « %s »
valeur provolatile non reconnue pour la fonction « %s »
version non supportée (%d.%d) dans le fichier d'en-tête
message d'avertissement du fichier de sauvegarde original : %s
échec du processus de travail : code de sortie %d
a écrit %lu octet de données d'un « Large Object » (résultat = %lu)
a écrit %lu octets de données d'un « Large Object » (résultat = %lu)
locale/fr/LC_MESSAGES/psql-9.6.mo 0000644 00000313261 14751153421 0012036 0 ustar 00 �� : �! � �C XZ YZ oZ �Z � �Z D[ `[
y[ �[ > �[ = �[ < \ p R\ s �\ 5 7] 7 m] K �] o �] 2 a^ 4 �^ N �^ t _ Q �_ O �_ > /` A n` O �` @ a 6 Aa 0 xa N �a G �a 8 @b A yb T �b ? c L Pc A �c @ �c H d A id + �d � �d 5 me 9 �e n �e Q Lf : �f � �f ; fg y �g � h ; �h z �h T oi A �i L j B Sj \ �j 4 �j J (k \ sk 6 �k 4 l G <l = �l ; �l ( �l ; 'm ; cm ; �m ; �m 8 n _ Pn J �n F �n ` Bo h �o G p 5 Tp 2 �p X �p Q q : hq 3 �q ; �q S r M gr 9 �r @ �r 8 0s ; is @ �s K �s J 2t | }t � �t > �u F �u N v F Uv H �v - �v $ w & 8w - _w 9 �w 7 �w 2 �w 4 2x 3 gx ) �x ) �x ; �x B +y ) ny * �y * �y J �y 1 9z . kz - �z , �z 4 �z I *{ $ t{ & �{ > �{ 1 �{ & 1| ( X| J �| : �| ( } % 0} $ V} $ {} ) �} - �} N �} 9 G~ G �~ 5 �~ M �~ C M P � K � N .� K }� L ɀ 4 � K K� ( �� q �� A 2� ? t� A �� > �� � 5� # � F � 8 O� < �� M Ņ ; � 6 O� 2 �� 7 �� B � : 4� 4 o� 9 �� ? އ % � + D� 9 p� 5 �� I � K *� M v� Z ĉ S � K s� � �� N J� @ �� : ڋ ( � B >� L �� C Ό � � M �� = � � M� � � � "� 5� 9� M� ]� 0 e� $ �� # �� * ߏ %
� * 0� [� # |� < �� ݐ �� � 6 1� h� � }� : #� ^� p� |� �� �� �� �� ̒ ޒ Q � B� I V� [ ��
�� � �
-� 8� V� C c� A �� � �� �� � � $� +� , =� j� �� �� �� �� �� �� ̕ � ��
� � � '� ' 4� \� & z� ' �� 7 ɖ 0 � 2� N� ^� q� �� �� �� �� w �� %� 6� K� Q� k� ( �� �� �� ˘ Ԙ �
� #� 8� Q� ]� f� o� �� �� �� ��
�� Ù ə ̙ ֙
ܙ � � � � � �
,� :�
L� Z� & g� �� ��
��
�� ɚ ܚ �
� � 0� D� W� i� y� �� �� �� ݛ � � � 0�
B� P� `� % q� �� " �� Μ � � )� ' ?� & g� �� �� �� �� ˝ ՝
ڝ � L � A� P� n� > �� ʞ ߞ � 2
� =� D� W� k� �� �� �� �� ȟ ߟ �� X � m� v� �� ��
�� ˠ � ' � . � ! D� ' f� �� �� ��
�� ʡ � �� � :� Z� i� z� , �� �� Ģ Т ߢ � � � !� E (� n� ~� �� �� ��
�� �� �� �� ƣ ң ޣ �� � � � $� .� B�
H� V� r�
�� �� �� �� �� ͤ � � !
� /� G� 9 b� y �� 9 � F P� 5 �� B ͦ C � 5 T� : �� 9 ŧ @ �� ; @� K |� B Ȩ C � 6 O� 8 �� �� ۩ �
�� � � (�
.� 9� U� t� �� �� �� & �� � �� � � � ,� � # � # &� # J� n� " �� �� �� Ǭ ެ � �
�� � � �
)� c 4� � �� Y� K v� Q ® / � O D� U �� 5 � = � ^� , j� 4 �� " ̰ ! � � 1� >� Y� " u� + �� + ı 6 � X '� 7 �� 8 �� T � 5 F� I |� 6 Ƴ # �� = !� = _� = �� i ۴ 9 E� � �� * �� � � � @� S� Z� ^� m� �� �� �� �� �� �� ϶ # � � &� $ ?� d�
w� �� �� �� �� �� ��
�� Ʒ > з � � (� 9� C� K� Q� C ^� �� / �� ( � � � (� :� Q� ' m� �� $ �� % ٹ ! �� ) !� ( K� / t� # �� ' Ⱥ , � . � 4 L� �� ! �� - û � % � 4 8� 1 m� - �� / ͼ " �� � ' @� h� . �� ) �� % � ! � $ )� * N� + y� A �� � � & � 0 '� . X� - �� �� % Ŀ �
�
�� � # � 3� @� R� d� p� |� �� �� �� �� C �� � #� 9� C� [� k� {� ��
�� �� $ �� & � - � # 9� ]� 1 ~� ( �� ) �� + � ' /� ! W� y� # �� ! �� ( �� � � 9� V� t� �� �� �� �� ��
�� �� �
� !� .� >� Y� y� �� �� �� �� �� � $� @� ! [� }� �� 2 �� �� �� � *� G� h� 2 �� 5 �� �� �� � . 2� a� & y� # �� �� ! �� � � 2� D� ]� 6 ~� ) �� ��
�� �� �� � � .�
;� & I� p� �� �� �� �� �� �� �� �� ��
� �
� )� U 6� �� �� �� , �� �� �� � ,� ?�
S� ^� m� y� �� �� �� �� �� " ��
�� �� �� � � '�
B� 1 P� �� ��
�� �� �� �� . �� � . $�
S� a� k� q� �� ��
�� �� E �� �
� !� 3� B� Q� X� m� u� �� �� �� * �� ��
�� � � � )� 3� 9� C�
T� _� h� r� �� �� �� �� �� �� �� �� � � � "� '� 9�
B� P� W� ^� q� z� % �� �� �� �� �� �� �� �� � � $� 3� <� F�
O� Z� d� s� � �� �� �� �� �� �� �� �� �� �� �� � � � � $� 3�
C� Q� X�
j� x� �� �� �� �� �� �� �� �� �� �� � � #� ! -� 4 O�
�� �� . �� �� �� �� �� � � � 2�
;�
I�
W� e� x� �� �� �� �� " �� �� � 0� B� ]� z� / �� �� �� �� �� " � (� H� d� �� �� * ��
�� �� �� � -� E� Y� i� |� �� 0 �� + �� � � � > %�
d� o� ) {� " �� �� ��
�� �� ��
� #� (� 2� 7� G� V� e� q� v�
}� ��
��
�� �� �� �� 7 �� 2 � 6 ?� V v� �� & �� & �� . !� P� \� l�
}�
�� �� �� �� �� �� �� �� �� � � � ! *� L� T� f� s�
�� �� �� �� �� . �� � � � )�
F� Q� a� s� � �� �� �� �� ��
�� �� �� �� �� � � � <� Z� d� h� $ �� # �� �� �� 0 �� � � 5� <� S� ( g� �� �� �� �� �� �� �� �� �� �� � � , '� T� l� �� $ �� �� ' �� � #� B� \� t� �� �� ! �� �� �� �
� � (� � ,� �� �� � � 8� �� & � =� S� @ l� E �� R �� � F� x �� 6 k� z �� o � � �� n -� ; �� w �� � P� o �� � n� t �� 8 n� v �� I � 6 h� : �� m �� � H� D �� H � � a� P �� t B� q �� r )� � �� w #� G �� � �� ; ~� M �� � � \ �� @ � � I� 7 � { � � �� ; b� � �� ` 0� U �� V � 4 >� m s� 4 � H � n _� G � / � K F� A �� ? � 4 � A I� ? �� ? � ? � 9 K� f �� P � P =� f �� w �� R m F � 7 e ? a � @ ? H : � ^ � r " ? � U � E + z q H � � 5 j � � ) � � 9 � J � u t � _ @ h : � 6 � >
p Z
l �
k 8 g � C > P ? � G � {
/ �
9 �
9 �
� 7 7 � ? � > 9 J x L � u C � 3 � o � B n 6 � 9 � r " l � 8 4 ; C p 2 � 8 � < s ] > � l B } b � g # � � Q � \ � p D 9 � r � = b � � o ? @ � � � j y � � # � s � 5 1 d g � � E M < � 7 � G v P A � g ! F q! E �! ) �! / (" ; X" 5 �" [ �" | &# P �# c �# ] X$ T �$ � % Z �% > & 8 J& . �& Y �& � ' A �' � �' O �( Q ) � ^) * %* @* C* W* [* p* �* C �* 9 �* - + / 6+ ; f+ ? �+ 1 �+ - , E B, + �, �, % �, : �, .- � G- ; �- -. ?.
L. Z.
s. ~. �. �. �. z �. E/ V f/ o �/ -0 70 S0 p0 ) �0 �0 h �0 ` *1 �1
�1 �1 �1 �1 �1 �1 0 2 H2 b2 n2 ~2 �2 �2 �2 , �2 ( �2
3 ,3 83 D3
P3 / ^3 �3 5 �3 8 �3 S 4 L p4 �4 �4 �4 $ 5
35 >5 F5 O5 � `5 �5 $ 6 +6 76 W6 2 s6 �6 �6 �6 ' �6 , �6 #7 >7 # ]7
�7 �7
�7 �7 �7 �7 �7 �7 8 #8 )8 ,8 88 >8 P8
X8
f8 q8 �8 �8 �8 �8 �8 �8 8 �8 "9 *9 ?9 S9 i9 p9 �9 ! �9 �9 �9 : : 8: T: " g: �: �: ( �: �: �: ; 2; H; \; m; �; - �; �; 1 �; 0 < - =< + k< & �< K �< G
= R= ^= }= �= �=
�= �= �= �= v �= G> ) W> ( �> Y �> ? ? " :? < ]? �? �? �? �? �? @ @ .@
A@ % O@ 6 u@ - �@ z �@
UA ' `A % �A �A �A * �A
B 9 B B LB 3 �B 8 �B �B " C
,C 7C KC & kC / �C 5 �C 4 �C -D @D WD 5 dD �D �D �D �D �D �D . E =E N GE �E �E
�E �E �E �E �E �E �E �E F F 6F JF `F iF sF �F �F �F ) �F 0 �F
G G 0G
5G @G ' ZG �G / �G 2 �G + �G . H I HH � �H @ QI P �I > �I K "J L nJ 8 �J ? �J > 4K L sK B �K Y L L ]L N �L 9 �L L 3M # �M �M �M �M �M N N $N ( 1N + ZN �N . �N
�N �N 2 �N . O * LO wO # |O � �O �P * �P ( �P * �P &Q / CQ sQ �Q $ �Q �Q
�Q �Q
�Q �Q �Q R
!R � /R �R 1 �S � T � �T 4 U � EU � �U a dV C �V
W 7 W I OW 5 �W 0 �W X
X .X & HX / oX 2 �X 6 �X I Y p SY : �Y B �Y | BZ G �Z ` [ A h[ , �[ N �[ S &\ S z\ r �\ F A] �] , �] 9 �]
^ " '^ ' J^ r^ �^ �^ �^ �^ �^
�^ �^ �^ �^ �^ # _ ) %_ O_ d_ ) ~_ �_ �_ �_ �_
�_ �_
` `
` '` \ 1` �` �` �` �` �` �` �` T �` 6a 7 Pa 6 �a �a
�a �a �a #
b 1 1b 7 cb , �b ( �b $ �b , c , Cc : pc & �c / �c 0 d 0 3d E dd $ �d $ �d 6 �d # +e ' Oe D we B �e ? �e = ?f $ }f ! �f : �f ! �f 4 !g 4 Vg ' �g " �g ' �g 2 �g 2 1h . dh �h �h 5 �h 9 �h 7 i 8 Ri �i 7 �i �i �i �i �i 9 j
Fj Tj gj {j �j �j �j �j �j �j T �j 3k Sk rk |k �k
�k ' �k �k
�k �k 1 l 3 :l @ nl / �l + �l V m 1 bm 4 �m @ �m 6
n * An # ln 5 �n + �n B �n , 5o bo ) �o + �o - �o p $ p ) 0p Zp
fp tp & �p �p �p �p �p ' �p , q Kq # kq $ �q �q �q + �q + r # Br $ fr 1 �r �r �r M �r ( Cs ls ) �s * �s * �s ,
t L 7t F �t �t - �t u C 1u uu < �u 9 �u 5 v 4 Av $ vv �v �v ! �v ( �v 7 w 0 Tw �w �w �w �w �w �w �w �w 9 x @x Qx [x gx sx �x �x �x �x ( �x �x y
y y p $y �y �y �y 5 �y $ z 'z Hz Yz rz
�z
�z �z �z �z �z
�z �z �z < �z <{
K{ V{ e{ {{ ! �{ �{ : �{ �{ |
| &| ;| Q| 9 c| �| B �| �|
�| �| } } '} 9} C} Q U} �}
�} �} �} �} ~ ~ ~ '~ 8~ R~ i~ / �~ �~
�~ �~ �~ �~ #
4 ? H ] m � � ) � - �
�
� � � 3� B� G�
Z� e� r� {� ��
�� �� ' �� Ӏ ڀ �� � � � 0� E� ]� r� �� ��
�� �� ǁ ց � �� �� # � <� C� L�
Y� g� q� }� �� �� �� �� ��
ӂ ނ � � � � 3� F� Z� o�
��
�� ��
�� �� à ˃
� � �
� ) � D E� �� �� 1 �� � � � � 0� D� \� n� {� �� �� �� م �� ) � @� + U� �� * �� Ɇ � � $ "� M G� �� �� և 4 � 2 #� / V� - �� �� ш ? � &� " 8� [� $ {� $ �� ʼn ݉ � ! � " *� , M� - z� �� �� �� B ʊ
� � ? ,� , l� �� �� �� ԋ ދ & � �
� *� /�
H� V� h� t�
{�
�� ��
��
�� �� Ì Ќ S � 9 4� E n� r �� '� / -� / ]� 6 �� Ď Ў � � � � )� 6� B� K� R� Y� y� �� �� �� % Ə � ��
� � -� 9� C� [� w� F �� ѐ א � �� � '� 6� H�
T� _� g�
m� x� ��
�� �� �� Ƒ Α ڑ �� % �� $ "� G� P� T� ' s� ' �� Ò ̒ > Ԓ � ' � B� ! I� k� ? �� Ɠ ֓ � � � � � � #� @� O� a� 0 j� �� �� Ԕ " � � 2 ,� _� # �� # �� ! ȕ � � # � % B� h� o�
��
�� �� �� n J � � � � � � � � ) B 5 � L ( ; $ � � � ] k e ( � � � % � � � k � 7 , � � � � � / v � � �
z � T q < � v � | � � z � � � 3 � g y � � M 2 Z � � e i
* � C � � < & � � � ) Q 6 � 9 � & � T � � s � � / t � � A Y u � 0 � � � � t � - , � � � � J s ~ r � F p R � � � � � � N 3 � D � S � � Q � y � c � � � E w ` m � � � � M � , � _ U � X b + 4 ` � � � � w � � � o < � � � � [ � - . � � � 7 � y j 5 � � & � = � U l � � � � g � � Y ( � � ] � f x � } � � � " � � � T � v 0 X \ � H � b 1 � � � # � k K � � : � � � 1 � 2 * ] W � � � $ � u C � I h V x S � � � � H f � 7 [ Q � 7 � � � j c � � � � � � � � / 4 � � � 2 � � � � P r � � � i a h �
� � � � � � � � � � N � � � � 9 p w � � � o > � � R . � � ) � � � � � g 8 > L ' � � c � z x � � � U x E � G � � � � � � Y � � B � � � � � ~ � � � � � v l 8 = C � 2 � � � o � [ � � 6 � r � � � � " � ? u t � u M a � � � � � p Z � ; � � � � g h � � 9 1 � � + � � j � � � G � � � � � � | � q K � � \ � � � � � _ � O E Z i B m � � � q � � 9 K � � 5 � . � � � � O } - $ � � � G � � ( � { X � M
� � � n � ! � � r � h # � � � � [ � � � J 1 I 4 � �
P � � � � � � k � � � � � 0 � � W 5 P � " ` N O V p � I � � : t � & m 0 � W f @ � b : 7 ; R B H � L ] � � T � � � � 8 � d F � � ~ @ � � � 0 4 � � > ! � � � Q % * � o & A y � L $ � � � { = � ~ ! ^ � ! @ � � : C F � � � � � 8 V ' � � n $ � � \ � � � � � � � = - n � � � X � A \ � � _ a R �
' W D ^ j w " � � � � � � N � � � � � � � A � � l # � � � � � _ � � { O F Y 2 d � � f ? � � � e } # { � � % E � � � � � � � # + ) H ? q | � , * � � � : � � � � � �
b � < � - � I 6 ( ^ � ; � % �
|
� � D . � s @ � � � � � � a 3 � � / ' � � ' 1 � s 9 � � � ! c � ? � � � / " J � d � � � � � � � � 3 � � > % � ) � � � 4 � l � � 3 � � � � � 8 � � � . � U � � � � * � � � � � � 6 � K ,
� � m � � � � i � S ^ � � ` � � V 6 P � G } � � S � D d + Z � � � � z � � � � � + � � � 5 e
Connection options:
Display settings:
Environment variables:
For more information, type "\?" (for internal commands) or "\help" (for SQL
commands) from within psql, or consult the psql section in the PostgreSQL
documentation.
Input and output options:
Output format options:
Parser: "%s"
Parser: "%s.%s" --help=commands list backslash commands, then exit
--help=variables list special variables, then exit
(options: S = show system objects, + = additional detail)
-0, --record-separator-zero
set record separator for unaligned output to zero byte
-1 ("one"), --single-transaction
execute as a single transaction (if non-interactive)
-?, --help[=options] show this help, then exit
-A, --no-align unaligned table output mode
-E, --echo-hidden display queries that internal commands generate
-F, --field-separator=STRING
field separator for unaligned output (default: "%s")
-H, --html HTML table output mode
-L, --log-file=FILENAME send session log to file
-P, --pset=VAR[=ARG] set printing option VAR to ARG (see \pset command)
-R, --record-separator=STRING
record separator for unaligned output (default: newline)
-S, --single-line single-line mode (end of line terminates SQL command)
-T, --table-attr=TEXT set HTML table tag attributes (e.g., width, border)
-U, --username=USERNAME database user name (default: "%s")
-V, --version output version information, then exit
-W, --password force password prompt (should happen automatically)
-X, --no-psqlrc do not read startup file (~/.psqlrc)
-a, --echo-all echo all input from script
-b, --echo-errors echo failed commands
-c, --command=COMMAND run only single command (SQL or internal) and exit
-d, --dbname=DBNAME database name to connect to (default: "%s")
-e, --echo-queries echo commands sent to server
-f, --file=FILENAME execute commands from file, then exit
-h, --host=HOSTNAME database server host or socket directory (default: "%s")
-l, --list list available databases, then exit
-n, --no-readline disable enhanced command line editing (readline)
-o, --output=FILENAME send query results to file (or |pipe)
-p, --port=PORT database server port (default: "%s")
-q, --quiet run quietly (no messages, only query output)
-s, --single-step single-step mode (confirm each query)
-t, --tuples-only print rows only
-v, --set=, --variable=NAME=VALUE
set psql variable NAME to VALUE
(e.g., -v ON_ERROR_STOP=1)
-w, --no-password never prompt for password
-x, --expanded turn on expanded table output
-z, --field-separator-zero
set field separator for unaligned output to zero byte
AUTOCOMMIT if set, successful SQL commands are automatically committed
COLUMNS number of columns for wrapped format
COMP_KEYWORD_CASE determines the case used to complete SQL key words
[lower, upper, preserve-lower, preserve-upper]
DBNAME the currently connected database name
ECHO controls what input is written to standard output
[all, errors, none, queries]
ECHO_HIDDEN if set, display internal queries executed by backslash commands;
if set to "noexec", just show without execution
ENCODING current client character set encoding
FETCH_COUNT the number of result rows to fetch and display at a time
(default: 0=unlimited)
HISTCONTROL controls command history [ignorespace, ignoredups, ignoreboth]
HISTFILE file name used to store the command history
HISTSIZE the number of commands to store in the command history
HOST the currently connected database server host
IGNOREEOF if unset, sending an EOF to interactive session terminates application
LASTOID value of the last affected OID
NAME=VALUE [NAME=VALUE] psql ...
or \setenv NAME [VALUE] inside psql
ON_ERROR_ROLLBACK if set, an error doesn't stop a transaction (uses implicit savepoints)
ON_ERROR_STOP stop batch execution after error
PAGER name of external pager program
PGAPPNAME same as the application_name connection parameter
PGDATABASE same as the dbname connection parameter
PGHOST same as the host connection parameter
PGPASSFILE password file name
PGPASSWORD connection password (not recommended)
PGPORT same as the port connection parameter
PGUSER same as the user connection parameter
PORT server port of the current connection
PROMPT1 specifies the standard psql prompt
PROMPT2 specifies the prompt used when a statement continues from a previous line
PROMPT3 specifies the prompt used during COPY ... FROM STDIN
PSQLRC alternative location for the user's .psqlrc file
PSQL_EDITOR, EDITOR, VISUAL
editor used by the \e, \ef, and \ev commands
PSQL_EDITOR_LINENUMBER_ARG
how to specify a line number when invoking the editor
PSQL_HISTORY alternative location for the command history file
QUIET run quietly (same as -q option)
SHELL shell used by the \! command
SHOW_CONTEXT controls display of message context fields [never, errors, always]
SINGLELINE end of line terminates SQL command mode (same as -S option)
SINGLESTEP single-step mode (same as -s option)
TMPDIR directory for temporary files
USER the currently connected database user
VERBOSITY controls verbosity of error reports [default, verbose, terse]
\! [COMMAND] execute command in shell or start interactive shell
\? [commands] show help on backslash commands
\? options show help on psql command-line options
\? variables show help on special variables
\C [STRING] set table title, or unset if none
\H toggle HTML output mode (currently %s)
\T [STRING] set HTML <table> tag attributes, or unset if none
\a toggle between unaligned and aligned output mode
\c[onnect] {[DBNAME|- USER|- HOST|- PORT|-] | conninfo}
connect to new database (currently "%s")
\c[onnect] {[DBNAME|- USER|- HOST|- PORT|-] | conninfo}
connect to new database (currently no connection)
\cd [DIR] change the current working directory
\conninfo display information about current connection
\copy ... perform SQL COPY with data stream to the client host
\copyright show PostgreSQL usage and distribution terms
\crosstabview [COLUMNS] execute query and display results in crosstab
\dA[+] [PATTERN] list access methods
\dC[+] [PATTERN] list casts
\dD[S+] [PATTERN] list domains
\dE[S+] [PATTERN] list foreign tables
\dF[+] [PATTERN] list text search configurations
\dFd[+] [PATTERN] list text search dictionaries
\dFp[+] [PATTERN] list text search parsers
\dFt[+] [PATTERN] list text search templates
\dL[S+] [PATTERN] list procedural languages
\dO[S+] [PATTERN] list collations
\dT[S+] [PATTERN] list data types
\d[S+] list tables, views, and sequences
\d[S+] NAME describe table, view, sequence, or index
\da[S] [PATTERN] list aggregates
\db[+] [PATTERN] list tablespaces
\dc[S+] [PATTERN] list conversions
\dd[S] [PATTERN] show object descriptions not displayed elsewhere
\ddp [PATTERN] list default privileges
\des[+] [PATTERN] list foreign servers
\det[+] [PATTERN] list foreign tables
\deu[+] [PATTERN] list user mappings
\dew[+] [PATTERN] list foreign-data wrappers
\df[antw][S+] [PATRN] list [only agg/normal/trigger/window] functions
\dg[S+] [PATTERN] list roles
\di[S+] [PATTERN] list indexes
\dl list large objects, same as \lo_list
\dm[S+] [PATTERN] list materialized views
\dn[S+] [PATTERN] list schemas
\do[S+] [PATTERN] list operators
\dp [PATTERN] list table, view, and sequence access privileges
\drds [PATRN1 [PATRN2]] list per-database role settings
\ds[S+] [PATTERN] list sequences
\dt[S+] [PATTERN] list tables
\du[S+] [PATTERN] list roles
\dv[S+] [PATTERN] list views
\dx[+] [PATTERN] list extensions
\dy[+] [PATTERN] list event triggers
\e [FILE] [LINE] edit the query buffer (or file) with external editor
\echo [STRING] write string to standard output
\ef [FUNCNAME [LINE]] edit function definition with external editor
\encoding [ENCODING] show or set client encoding
\errverbose show most recent error message at maximum verbosity
\ev [VIEWNAME [LINE]] edit view definition with external editor
\f [STRING] show or set field separator for unaligned query output
\g [FILE] or ; execute query (and send results to file or |pipe)
\gexec execute query, then execute each value in its result
\gset [PREFIX] execute query and store results in psql variables
\h [NAME] help on syntax of SQL commands, * for all commands
\i FILE execute commands from file
\ir FILE as \i, but relative to location of current script
\l[+] [PATTERN] list databases
\lo_export LOBOID FILE
\lo_import FILE [COMMENT]
\lo_list
\lo_unlink LOBOID large object operations
\o [FILE] send all query results to file or |pipe
\p show the contents of the query buffer
\password [USERNAME] securely change the password for a user
\prompt [TEXT] NAME prompt user to set internal variable
\pset [NAME [VALUE]] set table output option
(NAME := {border|columns|expanded|fieldsep|fieldsep_zero|
footer|format|linestyle|null|numericlocale|pager|
pager_min_lines|recordsep|recordsep_zero|tableattr|title|
tuples_only|unicode_border_linestyle|
unicode_column_linestyle|unicode_header_linestyle})
\q quit psql
\qecho [STRING] write string to query output stream (see \o)
\r reset (clear) the query buffer
\s [FILE] display history or save it to file
\set [NAME [VALUE]] set internal variable, or list all if no parameters
\setenv NAME [VALUE] set or unset environment variable
\sf[+] FUNCNAME show a function's definition
\sv[+] VIEWNAME show a view's definition
\t [on|off] show only rows (currently %s)
\timing [on|off] toggle timing of commands (currently %s)
\unset NAME unset (delete) internal variable
\w FILE write query buffer to file
\watch [SEC] execute query every SEC seconds
\x [on|off|auto] toggle expanded output (currently %s)
\z [PATTERN] same as \dp
border border style (number)
columns target width for the wrapped format
expanded (or x) expanded output [on, off, auto]
fieldsep field separator for unaligned output (default "%s")
fieldsep_zero set field separator for unaligned output to zero byte
footer enable or disable display of the table footer [on, off]
format set output format [unaligned, aligned, wrapped, html, asciidoc, ...]
linestyle set the border line drawing style [ascii, old-ascii, unicode]
null set the string to be printed in place of a null value
numericlocale enable or disable display of a locale-specific character to separate
groups of digits [on, off]
pager control when an external pager is used [yes, no, always]
psql --pset=NAME[=VALUE]
or \pset NAME [VALUE] inside psql
psql --set=NAME=VALUE
or \set NAME VALUE inside psql
psql [OPTION]... [DBNAME [USERNAME]]
recordsep record (line) separator for unaligned output
recordsep_zero set record separator for unaligned output to zero byte
set NAME=VALUE
psql ...
or \setenv NAME [VALUE] inside psql
tableattr (or T) specify attributes for table tag in html format or proportional
column widths for left-aligned data types in latex-longtable format
title set the table title for any subsequently printed tables
tuples_only if set, only actual table data is shown
unicode_border_linestyle
unicode_column_linestyle
unicode_header_linestyle
set the style of Unicode line drawing [single, double]
"%s.%s" is not a view
%d connection %d connections %s %s %s (every %gs)
%s
%s (%s, server %s)
%s (every %gs)
%s: %s
%s: -1 can only be used in non-interactive mode
%s: cannot copy from/to a directory
%s: could not delete variable "%s"
%s: could not find own program executable
%s: could not open log file "%s": %s
%s: could not set printing parameter "%s"
%s: could not set variable "%s"
%s: current transaction is aborted
%s: invalid encoding name or conversion procedure not found
%s: not connected to a database
%s: out of memory
%s: unknown transaction status
%s: warning: extra command-line argument "%s" ignored
(%lu row) (%lu rows) ***(Single step mode: verify command)*******************************************
%s
***(press return to proceed or enter x and return to cancel)********************
********* QUERY **********
%s
**************************
+ opt(%d) = |%s|
, clustered , deferrable , initially deferred , invalid , predicate (%s) , replica identity , tablespace "%s" Access privileges All connection parameters must be supplied because no database connection exists
Argument data types Asynchronous notification "%s" received from server process with PID %d.
Asynchronous notification "%s" with payload "%s" received from server process with PID %d.
Attributes Available help:
Border style is %d.
Bypass RLS COPY data transfer failed: %s Call Handler Cannot add cell to table content: total cell count of %d exceeded.
Cannot add header to table content: column count of %d exceeded.
Cannot login Check Check constraints: Child tables Collate Column Column privileges Command: %s
Description: %s
Syntax:
%s
Composite type "%s.%s" Connection
Create DB Create role Ctype Database Default access privileges Default footer is off.
Default footer is on.
Default? Definition Description Destination Dictionaries Did not find any extension named "%s".
Did not find any extensions.
Did not find any relation named "%s".
Did not find any relation with OID %s.
Did not find any text search configuration named "%s".
Did not find any text search parser named "%s".
Disabled internal triggers: Disabled rules: Disabled triggers: Disabled user triggers: Elements Enabled Encoding End parse Enter data to be copied followed by a newline.
End with a backslash and a period on a line by itself, or an EOF signal. Enter it again: Enter new password: Event Expanded display is off.
Expanded display is on.
Expanded display is used automatically.
FDW Options FDW Options: (%s) Failed.
Field separator is "%s".
Field separator is zero byte.
Foreign table "%s.%s" Foreign-data wrapper Foreign-key constraints: Formatting
Function General
General options:
Get headline Get next token Get token types Handler Has OIDs: yes Help
ID Implicit? Index Index "%s.%s" Indexes: Informational
Inherits Init Init options Inline Handler Input/Output
Internal Language Internal name Interrupted
Invalid command \%s. Try \? for help.
Language Large Objects
Large objects Left arg type Lexize Line style is %s.
List of access methods List of aggregate functions List of casts List of collations List of conversions List of data types List of databases List of domains List of event triggers List of foreign servers List of foreign tables List of foreign-data wrappers List of functions List of installed extensions List of languages List of operators List of relations List of roles List of schemas List of settings List of specially treated variables
List of tablespaces List of text search configurations List of text search dictionaries List of text search parsers List of text search templates List of user mappings Locale-adjusted numeric output is off.
Locale-adjusted numeric output is on.
Location Materialized view "%s.%s" Member of Method Modifier Modifiers Name No changes No connections No help available for "%s".
Try \h with no arguments to see available help.
No inheritance No matching relations found.
No matching settings found.
No per-database role settings support in this server version.
No relations found.
No settings found.
Null display is "%s".
Number of child tables: %d (Use \d+ to list them.) Object Object Description Object descriptions Objects in extension "%s" Operating System
Options Output format is %s.
Owned by: %s Owner Pager is always used.
Pager is used for long output.
Pager usage is off.
Pager won't be used for less than %d line.
Pager won't be used for less than %d lines.
Parallel Password encryption failed.
Password for user %s: Password valid until Password: Passwords didn't match.
Policies Policies (forced row security enabled): Policies (forced row security enabled): (none) Policies (row security disabled): Policies (row security enabled): (none) Policies: Previous connection kept
Procedure Query Buffer
Query buffer is empty. Query buffer reset (cleared). Record separator is "%s".
Record separator is <newline>.
Record separator is zero byte.
Referenced by: Replica Identity Replication Report bugs to <pgsql-bugs@postgresql.org>.
Result data type Result type Right arg type Role Role name Rules firing always: Rules firing on replica only: Rules: SSL connection (protocol: %s, cipher: %s, bits: %s, compression: %s)
STATEMENT: %s
Schema Security Sequence "%s.%s" Server Server: %s Settings Size Source Source code Source type Special relation "%s.%s" Start parse Stats target Storage Succeeded.
Superuser TOAST table "%s.%s" Table Table "%s.%s" Table attributes are "%s".
Table attributes unset.
Tablespace Tablespace: "%s" Tags Target type Target width is %d.
Target width is unset.
Template Text search configuration "%s" Text search configuration "%s.%s" Text search parser "%s" Text search parser "%s.%s" The connection to the server was lost. Attempting reset: The input is a PostgreSQL custom-format dump.
Use the pg_restore command-line client to restore this dump to a database.
The server (version %s) does not support access methods.
The server (version %s) does not support altering default privileges.
The server (version %s) does not support collations.
The server (version %s) does not support editing function source.
The server (version %s) does not support editing view definitions.
The server (version %s) does not support extensions.
The server (version %s) does not support foreign servers.
The server (version %s) does not support foreign tables.
The server (version %s) does not support foreign-data wrappers.
The server (version %s) does not support full text search.
The server (version %s) does not support savepoints for ON_ERROR_ROLLBACK.
The server (version %s) does not support showing function source.
The server (version %s) does not support showing view definitions.
The server (version %s) does not support tablespaces.
The server (version %s) does not support user mappings.
There is no previous error. Time: %.3f ms
Timing is off. Timing is on. Title is "%s".
Title is unset.
Token Token name Token types for parser "%s" Token types for parser "%s.%s" Triggers firing always: Triggers firing on replica only: Triggers: Trusted Try "%s --help" for more information.
Tuples only is off.
Tuples only is on.
Type Type "help" for help.
Type: \copyright for distribution terms
\h for help with SQL commands
\? for help with psql commands
\g or terminate with semicolon to execute query
\q to quit
Typed table of type: %s Unicode border line style is "%s".
Unicode column line style is "%s".
Unicode header line style is "%s".
Unlogged index "%s.%s" Unlogged materialized view "%s.%s" Unlogged table "%s.%s" Usage:
Use "\q" to leave %s.
User name Validator Value Variables
Version View "%s.%s" View definition: Volatility WARNING: %s major version %s, server major version %s.
Some psql features might not work.
WARNING: Console code page (%u) differs from Windows code page (%u)
8-bit characters might not work correctly. See psql reference
page "Notes for Windows users" for details.
Wrote history to file "%s".
You are connected to database "%s" as user "%s" on host "%s" at port "%s".
You are connected to database "%s" as user "%s" via socket in "%s" at port "%s".
You are currently not connected to a database.
You are now connected to database "%s" as user "%s" on host "%s" at port "%s".
You are now connected to database "%s" as user "%s" via socket in "%s" at port "%s".
You are now connected to database "%s" as user "%s".
You are using psql, the command-line interface to PostgreSQL. \!: failed
\%s: could not change directory to "%s": %s
\%s: environment variable name must not contain "="
\%s: error while setting variable
\%s: extra argument "%s" ignored
\%s: missing required argument
\connect: %s \copy: arguments required
\copy: parse error at "%s"
\copy: parse error at end of line
\crosstabview: ambiguous column name: "%s"
\crosstabview: column name not found: "%s"
\crosstabview: column number %d is out of range 1..%d
\crosstabview: data column must be specified when query returns more than three columns
\crosstabview: maximum number of columns (%d) exceeded
\crosstabview: query must return at least three columns
\crosstabview: query result contains multiple data values for row "%s", column "%s"
\crosstabview: statement did not return a result set
\crosstabview: vertical and horizontal headers must be different columns
\df does not take a "w" option with server version %s
\df only takes [antwS+] as options
\pset: allowed Unicode border line styles are single, double
\pset: allowed Unicode column line styles are single, double
\pset: allowed Unicode header line styles are single, double
\pset: allowed formats are unaligned, aligned, wrapped, html, asciidoc, latex, latex-longtable, troff-ms
\pset: allowed line styles are ascii, old-ascii, unicode
\pset: unknown option: %s
\watch cannot be used with COPY
\watch cannot be used with an empty query
abbreviated_grant_or_revoke abort the current transaction aborted because of read failure access_method_type action agg aggregate_name aggregate_signature alias alignment allowconn always analyze_function and aggregate_signature is: and conflict_action is one of: and grouping_element can be one of: and like_option is: and table_constraint is: and table_constraint_using_index is: and with_query is: arg_data_type arg_name arg_type argmode argname argtype argument argument_type arguments attempt to \gset into specially treated variable "%s" ignored
attribute attribute_name attribute_option base_type boolean cache call_handler cancel a transaction that was earlier prepared for two-phase commit canceled by user cannot duplicate null pointer (internal error)
cannot escape without active connection
canonical_function category change a database change a database role change a run-time parameter change a server configuration parameter change role name or membership change the definition of a collation change the definition of a conversion change the definition of a domain change the definition of a foreign server change the definition of a foreign table change the definition of a foreign-data wrapper change the definition of a function change the definition of a large object change the definition of a materialized view change the definition of a procedural language change the definition of a row level security policy change the definition of a rule change the definition of a schema change the definition of a sequence generator change the definition of a table change the definition of a tablespace change the definition of a text search configuration change the definition of a text search dictionary change the definition of a text search parser change the definition of a text search template change the definition of a trigger change the definition of a type change the definition of a user mapping change the definition of a view change the definition of an aggregate function change the definition of an event trigger change the definition of an extension change the definition of an index change the definition of an operator change the definition of an operator class change the definition of an operator family change the ownership of database objects owned by a database role channel check_expression child process exited with exit code %d child process exited with unrecognized status %d child process was terminated by exception 0x%X child process was terminated by signal %d: %s close a cursor cluster a table according to an index code collatable collate %s collation collect statistics about a database column_alias column_constraint column_definition column_name column_type com_op combinefunc command command not executable command not found commit a transaction that was earlier prepared for two-phase commit commit the current transaction compute a set of rows condition configuration_parameter conflict_action conflict_target connection to server was lost
connlimit constraint constraint_name copy data between a file and a table could not change directory to "%s": %s could not close pipe to external command: %s
could not execute command "%s": %s
could not find a "%s" to execute could not get home directory for user ID %ld: %s
could not identify current directory: %s could not locate temporary directory: %s
could not look up effective user ID %ld: %s could not open temporary file "%s": %s
could not parse reloptions array
could not read binary "%s" could not read from input file: %s
could not read symbolic link "%s" could not save history to file "%s": %s
could not set variable "%s"
could not start /bin/sh
could not start editor "%s"
could not stat file "%s": %s
could not write COPY data: %s
count create a new database create new rows in a table cursor_name data_type database_name deallocate a prepared statement default default %s default_expr define a cursor define a new access method define a new aggregate function define a new cast define a new collation define a new data type define a new database role define a new domain define a new encoding conversion define a new event trigger define a new foreign server define a new foreign table define a new foreign-data wrapper define a new function define a new index define a new mapping of a user to a foreign server define a new materialized view define a new operator define a new operator class define a new operator family define a new procedural language define a new rewrite rule define a new row level security policy for a table define a new savepoint within the current transaction define a new schema define a new sequence generator define a new table define a new table from the results of a query define a new tablespace define a new text search configuration define a new text search dictionary define a new text search parser define a new text search template define a new transform define a new trigger define a new view define access privileges define default access privileges define or change a security label applied to an object define or change the comment of an object definer definition delete delete rows of a table delimiter delimiter_character deserialfunc dest_encoding destroy a previously defined savepoint dictionary_name direction directory disabled discard session state domain constraint domain_constraint domain_name element empty a table or set of tables enabled encoding encoding_name end_function environment variable PSQL_EDITOR_LINENUMBER_ARG must be set to specify a line number
escape_character event exclude_element exclude_element in an EXCLUDE constraint is: execute a prepared statement execute an anonymous code block execution_cost existing_collation existing_enum_value expression extension_name family_name fdw_name ffunc filename filter_value filter_variable for table "%s.%s" force a transaction log checkpoint foreign table format_name from_item from_sql_function_name function function name is required
function_name garbage-collect and optionally analyze a database generate a notification gettoken_function group_name grouping_element handler_function headline_function history is not supported by this installation
immutable import table definitions from a foreign server in assignment increment index index_column_name index_expression index_method index_name index_parameters index_parameters in UNIQUE, PRIMARY KEY, and EXCLUDE constraints are: index_predicate init_function initial_condition inline_handler input_function insert install an extension integer internallength invalid binary "%s" invalid command \%s
invalid line number: %s
invalid output format (internal error): %d invoker istemplate join_column join_condition join_proc join_type label lang_name large_object_oid lc_collate lc_ctype left_type lexize_function lextypes_function like_option like_type link_symbol listen for a notification load a shared library file local socket local_schema locale lock a table lockmode loid materialized view maxvalue member_object method mffunc minitial_condition minvalue minvfunc more than one row returned for \gset
msfunc mstate_data_size mstate_data_type name neg_op new_attribute_name new_column_name new_constraint_name new_dictionary new_enum_value new_name new_owner new_role new_schema new_table new_tablespace new_version no no query buffer
no rows returned for \gset
normal not null null_string obj_file object_name off old_dictionary old_role old_version on op_type opclass operator operator class operator family operator_name option or the old syntax out of memory out of memory
output_expression output_function output_name parameter parent_table parser_name password payload pclose failed: %s policy_name position a cursor predicate preferred prepare a statement for execution prepare the current transaction for two-phase commit primary key, provider psql is the PostgreSQL interactive terminal.
psql variables:
query quote_character rebuild indexes receive_function refcolumn referenced_table_name reftable relation_name remote_schema remove a cast remove a collation remove a conversion remove a data type remove a database remove a database role remove a domain remove a foreign server descriptor remove a foreign table remove a foreign-data wrapper remove a function remove a materialized view remove a procedural language remove a rewrite rule remove a row level security policy from a table remove a schema remove a sequence remove a table remove a tablespace remove a text search configuration remove a text search dictionary remove a text search parser remove a text search template remove a transform remove a trigger remove a user mapping for a foreign server remove a view remove access privileges remove an access method remove an aggregate function remove an event trigger remove an extension remove an index remove an operator remove an operator class remove an operator family remove database objects owned by a database role replace the contents of a materialized view replica res_proc restart restore the value of a run-time parameter to the default value restricted result_rows retrieve rows from a query using a cursor retrieve rows from a table or view rettype rewrite_rule_name right_type role_name role_specification roll back to a savepoint rule rule_name safe sampling_method savepoint_name schema_element schema_name seed select send_function sequence sequence_name serialfunc server_name server_type server_version set constraint check timing for the current transaction set the characteristics of the current transaction set the current user identifier of the current session set the session user identifier and the current user identifier of the current session sfunc show the execution plan of a statement show the value of a run-time parameter skipping recursive expansion of variable "%s"
snapshot_id sort_expression sort_family_name sort_operator source_config source_encoding source_table source_type special stable start start a transaction block start_function state_data_size state_data_type statement stop listening for a notification storage storage_parameter storage_type strategy_number sub-SELECT subtype subtype_diff_function subtype_operator_class support_number tab completion query failed: %s
Query was:
%s
table table constraint table_constraint table_constraint_using_index table_name tablespace_name tablespace_option target_role target_type template text timestamp timezone to_sql_function_name token_type transaction_id transaction_mode trigger trigger_name trying to exit copy mode type type_modifier_input_function type_modifier_output_function type_name uid unexpected PQresultStatus: %d
unexpected result status for \watch
unexpected transaction status (%d)
unique, unknown unrecognized value "%s" for "%s"; assuming "%s"
unsafe unterminated quoted string
update update rows of a table user does not exist user name lookup failure: error code %lu user_name using_expression valfunction validator_function value values version view view name is required
view_option_name view_option_value volatile where abbreviated_grant_or_revoke is one of: where action is one of: where aggregate_signature is: where column_constraint is: where conflict_target can be one of: where constraint is: where direction can be empty or one of: where event can be one of: where from_item can be one of: where lockmode is one of: where member_object is: where option can be one of: where option can be: where role_specification can be: where transaction_mode is one of: window window_definition window_name with_query with_query_name yes Project-Id-Version: PostgreSQL 9.6
Report-Msgid-Bugs-To: pgsql-bugs@postgresql.org
POT-Creation-Date: 2021-10-05 15:37+0000
PO-Revision-Date: 2021-10-06 11:31+0200
Last-Translator: Guillaume Lelarge <guillaume@lelarge.info>
Language-Team: French <guillaume@lelarge.info>
Language: fr
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Plural-Forms: nplurals=2; plural=(n > 1);
X-Generator: Poedit 3.0
Options de connexion :
Paramètres d'affichage :
Variables d'environnement :
Pour en savoir davantage, saisissez « \? » (pour les commandes internes) ou
« \help » (pour les commandes SQL) dans psql, ou consultez la section psql
de la documentation de PostgreSQL.
Options d'entrée/sortie :
Options de formattage de la sortie :
Analyseur : « %s »
Analyseur : « %s.%s » --help=commands liste les méta-commandes, puis quitte
--help=variables liste les variables spéciales, puis quitte
(options : S = affiche les objets systèmes, + = informations supplémentaires)
-0, --record-separator-zero
initialise le séparateur d'enregistrements pour un
affichage non aligné à l'octet zéro
-1 (« un »), --single-transaction
exécute dans une transaction unique (si non interactif)
-?, --help[=options] affiche cette aide et quitte
-A, --no-align active le mode d'affichage non aligné des tables (-P
format=unaligned)
-E, --echo-hidden affiche les requêtes engendrées par les commandes
internes
-F, --field-separator=CHAÎNE
séparateur de champs pour un affichage non aligné
(par défaut : « %s »)
-H, --html active le mode d'affichage HTML des tables
(-P format=html)
-L, --log-file=FICHIER envoie les traces dans le fichier
-P, --pset=VAR[=ARG] initialise l'option d'impression VAR à ARG (voir la
commande \pset)
-R, --record-separator=CHAÎNE
séparateur d'enregistrements pour un affichage non
aligné (par défaut : saut de ligne)
-S, --single-line active le mode ligne par ligne (EOL termine la commande
SQL)
-T, --table-attr=TEXTE initialise les attributs des balises HTML de tableau
(largeur, bordure) (-P tableattr=)
-U, --username=NOM nom d'utilisateur de la base de données (par défaut :
« %s »)
-V, --version affiche la version puis quitte
-W, --password force la demande du mot de passe (devrait survenir
automatiquement)
-X, --no-psqlrc ne lit pas le fichier de démarrage (~/.psqlrc)
-a, --echo-all affiche les lignes du script
-b, --echo-errors affiche les commandes échouées
-c, --command=COMMANDE exécute une commande unique (SQL ou interne),
puis quitte
-d, --dbname=BASE indique le nom de la base de données à laquelle se
connecter (par défaut : « %s »)
-e, --echo-queries affiche les commandes envoyées au serveur
-f, --file=FICHIER exécute les commandes du fichier, puis quitte
-h, --host=HOTE nom d'hôte du serveur de la base de données ou
répertoire de la socket (par défaut : %s)
-l, --list affiche les bases de données disponibles, puis quitte
-n, --no-readline désactive l'édition avancée de la ligne de commande
(readline)
-o, --output=FICHIER écrit les résultats des requêtes dans un fichier (ou
|tube)
-p, --port=PORT port du serveur de la base de données (par défaut :
« %s »)
-q, --quiet s'exécute silencieusement (pas de messages, uniquement
le résultat des requêtes)
-s, --single-step active le mode étape par étape (confirmation pour
chaque requête)
-t, --tuples-only affiche seulement les lignes (-P tuples_only)
-v, --set=, --variable=NOM=VALEUR
configure la variable psql NOM en VALEUR
(e.g., -v ON_ERROR_STOP=1)
-w, --no-password ne demande jamais un mot de passe
-x, --expanded active l'affichage étendu des tables (-P expanded)
-z, --field-separator-zero
initialise le séparateur de champs pour un affichage
non aligné à l'octet zéro
AUTOCOMMIT si activé, les commandes SQL réussies sont automatiquement validées
COLUMNS nombre de colonnes pour le format encadré
COMP_KEYWORD_CASE détermine la casse utilisée pour compléter les mots clés SQL
[lower, upper, preserve-lower, preserve-upper]
DBNAME le nom de base de données actuel
ECHO contrôle ce qui est envoyé sur la sortie standard
[all, errors, none, queries]
ECHO_HIDDEN si activé, affiche les requêtes internes exécutées par les méta-commandes ;
si configuré à « noexec », affiche les requêtes mais ne les exécute pas
ENCODING encodage du jeu de caractères client
FETCH_COUNT le nombre de lignes résultats à récupérer et à afficher à la fois
(par défaut 0 pour illimité)
HISTCONTROL contrôle l'historique des commandes [ignorespace, ignoredups, ignoreboth]
HISTFILE nom du fichier utilisé pour stocker l'historique des commandes
HISTSIZE le nombre de commandes à stocker dans l'historique de commandes
HOST l'hôte de la base de données
IGNOREEOF si non configuré, envoyer un EOF à une session interactive fait quitter l'application
LASTOID valeur du dernier OID affecté
NOM=VALEUR [NOM=VALEUR] psql ...
ou \setenv NOM [VALEUR] dans psql
ON_ERROR_ROLLBACK si activé, une erreur n'arrête pas une transaction (utilise des savepoints implicites)
ON_ERROR_STOP arrête l'exécution d'un batch après une erreur
PAGER nom du paginateur externe
PGAPPNAME identique au paramètre de connexion application_name
PGDATABASE identique au paramètre de connexion dbname
PGHOST identique au paramètre de connexion host
PGPASSFILE nom du fichier de mot de passe
PGPASSWORD mot de passe de connexion (non recommendé)
PGPORT identique au paramètre de connexion port
PGUSER identique au paramètre de connexion user
PORT port du server pour la connexion actuelle
PROMPT1 spécifie l'invite standard de psql
PROMPT2 spécifie l'invite utilisé quand une requête continue après la ligne courante
PROMPT3 spécifie l'invite utilisée lors d'un COPY ... FROM STDIN
PSQLRC autre emplacement pour le fichier .psqlrc de l'utilisateur
PSQL_EDITOR, EDITOR, VISUAL
éditeur utilisé par les commandes \e, \ef et \ev
PSQL_EDITOR_LINENUMBER_ARG
comment spécifier un numéro de ligne lors de l'appel de l'éditeur
PSQL_HISTORY autre emplacement pour le fichier d'historique des commandes
QUIET s'exécute en silence (identique à l'option -q)
SHELL shell utilisé par la commande \!
SHOW_CONTEXT contrôle l'affichage des champs de contexte du message [never, errors, always]
SINGLELINE une fin de ligne termine le mode de commande SQL (identique à l'option -S)
SINGLESTEP mode pas à pas (identique à l'option -s)
TMPDIR répertoire pour les fichiers temporaires
USER l'utilisateur actuellement connecté
VERBOSITY contrôle la verbosité des rapports d'erreurs [default, verbose, terse]
\! [COMMANDE] exécute la commande dans un shell ou exécute un
shell interactif
\? [commandes] affiche l'aide sur les métacommandes
\? options affiche l'aide sur les options en ligne de commande de psql
\? variables affiche l'aide sur les variables spéciales
\C [CHAÎNE] initialise le titre d'une table, ou le désactive en
l'absence d'argument
\H bascule le mode de sortie HTML (actuellement %s)
\T [CHAÎNE] initialise les attributs HTML de la balise <table>,
ou l'annule en l'absence d'argument
\a bascule entre les modes de sortie alignée et non
alignée
\c[onnect] {[BASE|- UTILISATEUR|- HOTE|- PORT|-] | conninfo}
se connecte à une autre base de données
(actuellement « %s »)
\c[onnect] {[BASE|- UTILISATEUR|- HOTE|- PORT|-] | conninfo}
se connecte à une nouvelle base de données
(aucune connexion actuellement)
\cd [RÉPERTOIRE] change de répertoire de travail
\conninfo affiche des informations sur la connexion en cours
\copy ... exécute SQL COPY avec le flux de données dirigé vers
l'hôte client
\copyright affiche les conditions d'utilisation et de
distribution de PostgreSQL
\crosstabview [COLUMNS] exécute la requête et affiche le résultat dans un tableau croisé
\dA[+] [MODÈLE] affiche la liste des méthodes d'accès
\dC[+] [MODÈLE] affiche la liste des transtypages
\dD[S+] [MODÈLE] affiche la liste des domaines
\dE[S+] [MODÈLE] affiche la liste des tables distantes
\dF[+] [MODÈLE] affiche la liste des configurations de la recherche
plein texte
\dFd[+] [MODÈLE] affiche la liste des dictionnaires de la recherche de
texte
\dFp[+] [MODÈLE] affiche la liste des analyseurs de la recherche de
texte
\dFt[+] [MODÈLE] affiche la liste des modèles de la recherche de
texte
\dL[S+] [MODÈLE] affiche la liste des langages procéduraux
\dO[S+] [MODÈLE] affiche la liste des collationnements
\dT[S+] [MODÈLE] affiche la liste des types de données
\d[S+] affiche la liste des tables, vues et séquences
\d[S+] NOM affiche la description de la table, de la vue,
de la séquence ou de l'index
\da[S] [MODÈLE] affiche les aggrégats
\db[+] [MODÈLE] affiche la liste des tablespaces
\dc[S+] [MODÈLE] affiche la liste des conversions
\dd[S] [MODÈLE] affiche les commentaires des objets dont le commentaire
n'est affiché nul part ailleurs
\ddp [MODÈLE] affiche les droits par défaut
\des[+] [MODÈLE] affiche la liste des serveurs distants
\det[+] [MODÈLE] affiche la liste des tables distantes
\deu[+] [MODÈLE] affiche la liste des correspondances utilisateurs
\dew[+] [MODÈLE] affiche la liste des wrappers de données distantes
\df[antw][S+] [PATRN] affiche la liste des fonctions
[seulement agg/normal/trigger/window]
\dg[S+] [MODÈLE] affiche la liste des rôles (utilisateurs)
\di[S+] [MODÈLE] affiche la liste des index
\dl affiche la liste des « Large Objects », identique à
\lo_list
\dm[S+] [MODÈLE] affiche la liste des vues matérialisées
\dn[S+] [MODÈLE] affiche la liste des schémas
\do[S+] [MODÈLE] affiche la liste des opérateurs
\dp [MODÈLE] affiche la liste des droits d'accès aux tables,
vues, séquences
\drds [MODEL1 [MODEL2]] liste la configuration utilisateur par base de données
\ds[S+] [MODÈLE] affiche la liste des séquences
\dt[S+] [MODÈLE] affiche la liste des tables
\du[S+] [MODÈLE] affiche la liste des rôles (utilisateurs)
\dv[S+] [MODÈLE] affiche la liste des vues
\dx[+] [MODÈLE] affiche la liste des extensions
\dy[+] [MODÈLE] affiche les triggers sur évènement
\e [FICHIER] [LIGNE] édite le tampon de requête ou le fichier avec un
éditeur externe
\echo [TEXTE] écrit un texte sur la sortie standard
\ef [FONCTION [LIGNE]] édite la définition de fonction avec un éditeur
externe
\encoding [ENCODAGE] affiche ou initialise l'encodage du client
\errverbose affiche le message d'erreur le plus récent avec une verbosité maximale
\ev [VUE [LIGNE]] édite la définition de vue avec un éditeur
externe
\f [CHAÎNE] affiche ou initialise le séparateur de champ pour
une sortie non alignée des requêtes
\g [FICHIER] ou ; envoie le tampon de requêtes au serveur (et les
résultats au fichier ou |tube)
\gexec exécute la requête et exécute chaque valeur du résultat
\gset [PRÉFIXE] exécute la requête et stocke les résultats dans des variables psql
\h [NOM] aide-mémoire pour les commandes SQL, * pour toutes
les commandes
\i FICHIER exécute les commandes du fichier
\ir FICHIER identique à \i, mais relatif à l'emplacement du script
ou un |tube
\l[+] [MODÈLE] affiche la liste des bases de données
\lo_export OIDLOB FICHIER
\lo_import FICHIER [COMMENTAIRE]
\lo_list
\lo_unlink OIDLOB
opérations sur les « Large Objects »
\o [FICHIER] envoie les résultats de la requête vers un fichier
ou un |tube
\p affiche le contenu du tampon de requête
\password [UTILISATEUR]
modifie de façon sécurisé le mot de passe d'un
utilisateur
\prompt [TEXTE] NOM demande à l'utilisateur de configurer la variable
interne
\pset [NOM [VALEUR]] règle l'affichage de la table
(NOM := {border|columns|expanded|fieldsep|fieldsep_zero|
footer|format|linestyle|null|numericlocale|pager|
pager_min_lines|recordsep|recordsep_zero|tableattr|title|
tuples_only|unicode_border_linestyle|
unicode_column_linestyle|unicode_header_linestyle})
\q quitte psql
\qecho [TEXTE] écrit un texte sur la sortie des résultats des
requêtes (voir \o)
\r efface le tampon de requêtes
\s [FICHIER] affiche l'historique ou le sauvegarde dans un
fichier
\set [NOM [VALEUR]] initialise une variable interne ou les affiche
toutes en l'absence de paramètre
\setenv NOM [VALEUR] (dés)initialise une variable d'environnement
\sf[+] [FONCTION] édite la définition d'une fonction
\sv [FONCTION] édite la définition d'une vue
\t affiche uniquement les lignes (actuellement %s)
\timing [on|off] bascule l'activation du chronométrage des commandes
(actuellement %s)
\unset NOM désactive (supprime) la variable interne
\w [FICHIER] écrit le contenu du tampon de requêtes dans un
fichier
\watch [SEC] exécute la requête toutes les SEC secondes
\x [on|off|auto] bascule l'affichage étendu (actuellement %s)
\z [MODÈLE] identique à \dp
border style de bordure (nombre)
columns largeur cible pour le format encadré
expanded (or x) sortie étendue [on, off, auto]
fieldsep champ séparateur pour l'affichage non aligné (par défaut « %s »)
fieldsep_zero configure le séparateur de champ pour l'affichage non\n
aligné à l'octet zéro
footer active ou désactive l'affiche du bas de tableau [on, off]
format active le format de sortie [unaligned, aligned, wrapped, html, asciidoc, ...]
linestyle configure l'affichage des lignes de bordure [ascii, old-ascii, unicode]
null configure la chaîne à afficher à la place d'une valeur NULL
numericlocale active ou désactive l'affichage d'un caractère spécigique à la locale pour séparer
des groupes de chiffres [on, off]
pager contrôle quand un paginateur externe est utilisé [yes, no, always]
psql --pset=NOM[=VALEUR]
ou \pset NOM [VALEUR] dans psql
psql --set=NOM=VALEUR
ou \set NOM VALEUR dans psql
psql [OPTIONS]... [BASE [NOM_UTILISATEUR]]
recordsep enregistre le séparateur de ligne pour les affichages non alignés
recordsep_zero initialise le séparateur d'enregistrements pour un affichage
non aligné à l'octet zéro
set NOM=VALEUR
psql ...
ou \setenv NOM [VALEUR] dans psql
tableattr (or T) indique les attributs pour la balise de table dans le format html ou les largeurs
proportionnelles de colonnes pour les types de données alignés à gauche dans le format latex-longtable
title configure le titre de la table pour toute table affichée
tuples_only si activé, seules les données de la table sont affichées
unicode_border_linestyle
unicode_column_linestyle
unicode_header_linestyle
configure le style d'affichage de ligne Unicode [single, double]
« %s.%s » n'est pas une vue
%d connexion %d connexions %s %s %s (chaque %gs)
%s
%s (%s, serveur %s)
%s (chaque %gs)
%s : %s
%s p: -1 peut seulement être utilisé dans un mode non interactif
%s : ne peut pas copier à partir de/vers un répertoire
%s : n'a pas pu effacer la variable « %s »
%s : n'a pas pu trouver son propre exécutable
%s : n'a pas pu ouvrir le journal applicatif « %s » : %s
%s : n'a pas pu configurer le paramètre d'impression « %s »
%s : n'a pas pu initialiser la variable « %s »
%s : la transaction en cours est abandonnée
%s : nom d'encodage invalide ou procédure de conversion introuvable
%s : non connecté à une base de données
%s : mémoire épuisée
%s : état de la transaction inconnu
%s : attention : option supplémentaire « %s » ignorée
(%lu ligne) (%lu lignes) ***(Mode étape par étape: vérifiez la commande)*********************************
%s
***(appuyez sur entrée pour l'exécuter ou tapez x puis entrée pour annuler)***
******** REQUÊTE *********
%s
**************************
+ opt(%d) = |%s|
, en cluster , déferrable , initialement déferré , invalide , prédicat (%s) , identité réplica , tablespace « %s » Droits d'accès Tous les paramètres de connexions doivent être fournis car il n'y a pas de connexion
à une base de données existante.
Type de données des paramètres Notification asynchrone « %s » reçue en provenance du processus serveur de
PID %d.
Notification asynchrone « %s » reçue avec le contenu « %s » en provenance du
processus serveur de PID %d.
Attributs Aide-mémoire disponible :
Le style de bordure est %d.
Contournement RLS Échec du transfert de données COPY : %s Gestionnaire d'appel Ne peut pas ajouter une cellule au contenu de la table : le nombre total des
cellules %d est dépassé.
Ne peut pas ajouter l'en-tête au contenu de la table : le nombre de colonnes
%d est dépassé.
Ne peut pas se connecter Vérification Contraintes de vérification : Tables enfant : Collationnement Colonne Droits d'accès à la colonne Commande : %s
Description : %s
Syntaxe :
%s
Type composé « %s.%s » Connexions
Créer une base Créer un rôle Type caract. Base de données Droits d'accès par défaut Le bas de page par défaut est désactivé.
Le bas de page pas défaut est activé.
Par défaut ? Définition Description Destination Dictionnaires N'a trouvé aucune extension nommée « %s ».
N'a trouvé aucune extension.
Aucune relation nommée « %s » n'a été trouvée.
Aucune relation avec l'OID « %s » n'a été trouvée.
Aucune configuration de la recherche de texte nommée « %s » n'a été trouvée.
Aucun analyseur de la recherche de texte nommé « %s » n'a été trouvé.
Triggers internes désactivés : Règles désactivées : Triggers désactivés : Triggers utilisateurs désactivés : Éléments Activé Encodage Fin de l'analyse Saisissez les données à copier suivies d'un saut de ligne.
Terminez avec un antislash et un point seuls sur une ligne, ou un signal EOF. Saisissez-le à nouveau : Saisissez le nouveau mot de passe : Événement Affichage étendu désactivé.
Affichage étendu activé.
L'affichage étendu est utilisé automatiquement.
Options FDW Options FDW : (%s) Échec.
Le séparateur de champs est « %s ».
Le séparateur de champs est l'octet zéro.
Table distante « %s.%s » Wrapper des données distantes Contraintes de clés étrangères : Formatage
Fonction Général
Options générales :
Obtenir l'en-tête Obtenir le prochain jeton Obtenir les types de jeton Gestionnaire Contient des OID : oui Aide
ID Implicite ? Index Index « %s.%s » Index : Informations
Hérite de Initialisation Options d'initialisation : Gestionnaire en ligne Entrée/Sortie
Langage interne Nom interne Interrompu
Commande \%s invalide. Essayez \? pour l'aide-mémoire.
Langage « Large objects »
« Large objects » Type de l'arg. gauche Lexize Le style de ligne est %s.
Liste des méthodes d'accès Liste des fonctions d'agrégation Liste des conversions explicites Liste des collationnements Liste des conversions Liste des types de données Liste des bases de données Liste des domaines Liste des triggers sur évènement Liste des serveurs distants Liste des tables distantes Liste des wrappers de données distantes Liste des fonctions Liste des extensions installées Liste des langages Liste des opérateurs Liste des relations Liste des rôles Liste des schémas Liste des paramètres Liste des variables traitées spécialement
Liste des tablespaces Liste des configurations de la recherche de texte Liste des dictionnaires de la recherche de texte Liste des analyseurs de la recherche de texte Liste des modèles de la recherche de texte Liste des correspondances utilisateurs L'affichage de la sortie numérique adaptée à la locale est désactivé.
L'affichage de la sortie numérique adaptée à la locale est activé.
Emplacement Vue matérialisée « %s.%s » Membre de Méthode Modificateur Modificateurs Nom Aucun changement Sans connexions Aucun aide-mémoire disponible pour « %s ».
Essayez \h sans arguments pour afficher les aide-mémoires disponibles.
Pas d'héritage Aucune relation correspondante trouvée.
Aucun paramètre correspondant trouvé.
Pas de supprot des paramètres rôle par base de données pour la version de ce serveur.
Aucune relation trouvée.
Aucun paramètre trouvé.
L'affichage de null est « %s ».
Nombre de tables enfants : %d (utilisez \d+ pour les lister) Objet Description d'un objet Descriptions des objets Objets dans l'extension « %s » Système d'exploitation
Options Le format de sortie est %s.
Propriétaire : %s Propriétaire Le paginateur est toujours utilisé.
Le paginateur est utilisé pour les affichages longs.
L'utilisation du paginateur est désactivé.
Le paginateur ne sera pas utilisé pour moins que %d ligne.
Le paginateur ne sera pas utilisé pour moins que %d lignes.
Parallèle Échec du chiffrement du mot de passe.
Mot de passe pour l'utilisateur %s : Mot de passe valide jusqu'à Mot de passe : Les mots de passe ne sont pas identiques.
Politiques Politiques (mode sécurité de ligne activé en forcé) : Politiques (mode sécurité de ligne activé en forcé) : (aucune) Politiques (mode sécurité de ligne désactivé) : Politiques (mode sécurité de ligne activé) : (aucune) Politiques : Connexion précédente conservée
Procédure Tampon de requête
Le tampon de requête est vide. Le tampon de requête a été effacé. Le séparateur d'enregistrements est « %s ».
Le séparateur d'enregistrement est <saut de ligne>.
Le séparateur d'enregistrements est l'octet zéro.
Référencé par : Identité de réplicat Réplication Rapportez les bogues à <pgsql-bugs@postgresql.org>.
Type de données du résultat Type du résultat Type de l'arg. droit Rôle Nom du rôle Règles toujous activées : Règles activées uniquement sur le réplica : Règles : Connexion SSL (protocole : %s, chiffrement : %s, bits : %s, compression : %s)
INSTRUCTION : %s
Schéma Sécurité Séquence « %s.%s » Serveur Serveur : %s Réglages Taille Source Code source Type source Relation spéciale « %s.%s » Début de l'analyse Cible de statistiques Stockage Succès.
Superutilisateur Table TOAST « %s.%s » Table Table « %s.%s » Les attributs de la table sont « %s ».
Les attributs de la table ne sont pas définis.
Tablespace Tablespace : « %s » Tags Type cible La largeur cible est %d.
La largeur cible n'est pas configuré.
Modèle Configuration « %s » de la recherche de texte Configuration « %s.%s » de la recherche de texte Analyseur « %s » de la recherche de texte Analyseur « %s.%s » de la recherche de texte La connexion au serveur a été perdue. Tentative de réinitialisation : Les données en entrée proviennent d'une sauvegarde PostgreSQL au format custom.
Utilisez l'outil en ligne de commande pg_restore pour restaurer cette sauvegarde dans une base de données.
Le serveur (version %s) ne supporte pas les méthodes d'accès.
Le serveur (version %s) ne supporte pas la modification des droits par défaut.
Le serveur (version %s) ne supporte pas les collationnements.
Le serveur (version %s) ne supporte pas l'édition du code de la fonction.
Le serveur (version %s) ne supporte pas l'édition des définitions de vue.
Le serveur (version %s) ne supporte pas les extensions.
Le serveur (version %s) ne supporte pas les serveurs distants.
Le serveur (version %s) ne supporte pas les tables distantes.
Le serveur (version %s) ne supporte pas les wrappers de données distantes.
Le serveur (version %s) ne supporte pas la recherche plein texte.
Le serveur (version %s) ne supporte pas les points de sauvegarde pour
ON_ERROR_ROLLBACK.
Le serveur (version %s) ne supporte pas l'affichage du code de la fonction.
Le serveur (version %s) ne supporte pas l'affichage des définitions de vues.
Le serveur (version %s) ne supporte pas les tablespaces.
Le serveur (version %s) ne supporte pas les correspondances d'utilisateurs.
Il n'y a pas d'erreur précédente. Temps : %.3f ms
Chronométrage désactivé. Chronométrage activé. Le titre est « %s ».
Le titre n'est pas défini.
Jeton Nom du jeton Types de jeton pour l'analyseur « %s » Types de jeton pour l'analyseur « %s.%s » Triggers toujours activés : Triggers activés uniquement sur le réplica : Triggers : De confiance Essayez « %s --help » pour plus d'informations.
L'affichage des tuples seuls est désactivé.
L'affichage des tuples seuls est activé.
Type Saisissez « help » pour l'aide.
Saisissez:
\copyright pour les termes de distribution
\h pour l'aide-mémoire des commandes SQL
\? pour l'aide-mémoire des commandes psql
\g ou point-virgule en fin d'instruction pour exécuter la requête
\q pour quitter
Table de type : %s Le style de bordure Unicode est « %s ».
Le style de ligne Unicode est « %s ».
Le style d'en-tête Unicode est « %s ».
Index non tracé « %s.%s » Vue matérialisée non journalisée « %s.%s » Table non tracée « %s.%s » Usage :
Saisissez « \q » pour quitter %s.
Nom de l'utilisateur Validateur Valeur Variables
Version Vue « %s.%s » Définition de la vue : Volatibilité ATTENTION : %s version majeure %s, version majeure du serveur %s.
Certaines fonctionnalités de psql pourraient ne pas fonctionner.
Attention : l'encodage console (%u) diffère de l'encodage Windows (%u).
Les caractères 8 bits peuvent ne pas fonctionner correctement.
Voir la section « Notes aux utilisateurs de Windows » de la page
référence de psql pour les détails.
Historique sauvegardé dans le fichier « %s ».
Vous êtes connecté à la base de données « %s » en tant qu'utilisateur « %s » sur l'hôte « %s » via le port « %s ».
Vous êtes connecté à la base de données « %s » en tant qu'utilisateur « %s » via le socket dans « %s » via le port « %s ».
Vous n'êtes pas connecté à une base de données.
Vous êtes maintenant connecté à la base de données « %s » en tant qu'utilisateur « %s » sur l'hôte « %s » via le port « %s ».
Vous êtes maintenant connecté à la base de données « %s » en tant qu'utilisateur « %s » via le socket dans « %s » via le port « %s ».
Vous êtes maintenant connecté à la base de données « %s » en tant qu'utilisateur « %s ».
Vous utilisez psql, l'interface en ligne de commande de PostgreSQL. \! : échec
\%s : n'a pas pu accéder au répertoire « %s » : %s
\%s : le nom de la variable d'environnement ne doit pas contenir « = »
\%s : erreur lors de l'initialisation de la variable
\%s : argument « %s » supplémentaire ignoré
\%s : argument requis manquant
\connect : %s \copy : arguments requis
\copy : erreur d'analyse sur « %s »
\copy : erreur d'analyse à la fin de la ligne
\crosstabview : nom de colonne ambigu : « %s »
\crosstabview : nom de colonne non trouvé : « %s »
\crosstabview : le numéro de colonne %d est en dehors des limites 1..%d
\crosstabview : la colonne de données doit être spécifiée quand la requête retourne plus de trois colonnes
\crosstabview : nombre maximum de colonnes (%d) dépassé
\crosstabview : la requête doit renvoyer au moins trois colonnes
\crosstabview : le résultat de la requête contient plusieurs valeurs de données pour la ligne « %s », colonne « %s »
\crosstabview : la commande n'a pas retourné d'ensemble de résultats
\crosstabview : les entêtes horizontales et verticales doivent être des colonnes différentes
\df ne prend pas l'option « w » pour un serveur en version %s.
\df prends seulement [antwS+] comme options
\pset : les styles autorisés de ligne de bordure Unicode sont single, double
\pset : les styles autorisés pour la ligne de colonne Unicode sont single, double
\pset : les styles autorisés pour la ligne d'en-tête Unicode sont single, double
\pset : les formats autorisés sont unaligned, aligned, wrapped, html, asciidoc, latex,
latex-longtable, troff-ms
\pset: les styles de lignes autorisés sont ascii, old-ascii, unicode
\pset : option inconnue : %s
\watch ne peut pas être utilisé avec COPY
\watch ne peut pas être utilisé avec une requête vide
grant_ou_revoke_raccourci abandonner la transaction en cours annulé du fait d'une erreur de lecture access_method_type action agg nom_agrégat signature_agrégat alias alignement allowconn toujours fonction_analyze et signature_agrégat est : où action_conflit fait partie de : où element_regroupement fait partie de : et option_like est : et contrainte_table est : et contrainte_table_utilisant_index est : et requête_with est : type_données_arg nom_argument type_arg mode_argument nom_agrégat type_argument argument type_argument arguments tentative ignorée d'utilisation de \gset dans une variable traitée spécialement « %s »
attribut nom_attribut option_attribut type_base boolean cache gestionnaire_d_appel annuler une transaction précédemment préparée pour une validation en deux
phases annulé par l'utilisateur ne peut pas dupliquer un pointeur nul (erreur interne)
ne peut mettre entre guillemets sans connexion active
fonction_canonique catégorie modifier une base de données modifier un rôle modifier un paramètre d'exécution modifie un paramètre de configuration du serveur modifier le nom d'un groupe ou la liste des ses membres modifier la définition d'un collationnement modifier la définition d'une conversion modifier la définition d'un domaine modifier la définition d'un serveur distant modifier la définition d'une table distante modifier la définition d'un wrapper de données distantes modifier la définition d'une fonction modifier la définition d'un « Large Object » modifier la définition d'une vue matérialisée modifier la définition d'un langage procédural modifier la définition d'une politique de sécurité au niveau ligne modifier la définition d'une règle modifier la définition d'un schéma modifier la définition d'un générateur de séquence modifier la définition d'une table modifier la définition d'un tablespace modifier la définition d'une configuration de la recherche de texte modifier la définition d'un dictionnaire de la recherche de texte modifier la définition d'un analyseur de la recherche de texte modifier la définition d'un modèle de la recherche de texte modifier la définition d'un trigger modifier la définition d'un type modifier la définition d'une correspondance d'utilisateur modifier la définition d'une vue modifier la définition d'une fonction d'agrégation modifier la définition d'un trigger sur évènement modifier la définition d'une extension modifier la définition d'un index modifier la définition d'un opérateur modifier la définition d'une classe d'opérateurs modifier la définition d'une famille d'opérateur changer le propriétaire des objets d'un rôle canal expression_check le processus fils a quitté avec le code de sortie %d le processus fils a quitté avec un statut %d non reconnu le processus fils a été terminé par l'exception 0x%X le processus fils a été terminé par le signal %d : %s fermer un curseur réorganiser (cluster) une table en fonction d'un index code collationnable collationnement %s collationnement acquérir des statistiques concernant la base de données alias_colonne contrainte_colonne définition_colonne nom_colonne type_colonne com_op combinefunc commande commande non exécutable commande introuvable valider une transaction précédemment préparée pour une validation en deux
phases valider la transaction en cours calculer un ensemble de lignes condition paramètre_configuration action_conflit cible_conflit la connexion au serveur a été perdue
limite_de_connexion contrainte nom_contrainte copier des données entre un fichier et une table n'a pas pu changer le répertoire par « %s » : %s n'a pas pu fermer le fichier pipe vers la commande externe : %s
n'a pas pu exécuter la commande « %s » : %s
n'a pas pu trouver un « %s » à exécuter n'a pas pu obtenir le répertoire principal pour l'identifiant d'utilisateur %ld : %s
n'a pas pu identifier le répertoire courant : %s n'a pas pu localiser le répertoire temporaire : %s
n'a pas pu trouver l'identifiant réel %ld de l'utilisateur : %s n'a pas pu ouvrir le fichier temporaire « %s » : %s
n'a pas pu analyser le tableau reloptions
n'a pas pu lire le binaire « %s » n'a pas pu lire à partir du fichier en entrée : %s
n'a pas pu lire le lien symbolique « %s » n'a pas pu sauvegarder l'historique dans le fichier « %s » : %s
n'a pas pu initialiser la variable « %s »
n'a pas pu exécuter /bin/sh
n'a pas pu exécuter l'éditeur « %s »
n'a pas pu tester le fichier « %s » : %s
n'a pas pu écrire les données du COPY : %s
nombre créer une nouvelle base de données créer de nouvelles lignes dans une table nom_curseur type_données nom_base_de_donnée désallouer une instruction préparée par défaut Par défaut, %s expression_par_défaut définir un curseur définir une nouvelle méthode d'accès définir une nouvelle fonction d'agrégation définir un nouveau transtypage définir un nouveau collationnement définir un nouveau type de données définir un nouveau rôle définir un nouveau domaine définir une nouvelle conversion d'encodage définir un nouveau trigger sur évènement définir un nouveau serveur distant définir une nouvelle table distante définir un nouveau wrapper de données distantes définir une nouvelle fonction définir un nouvel index définit une nouvelle correspondance d'un utilisateur vers un serveur distant définir une nouvelle vue matérialisée définir un nouvel opérateur définir une nouvelle classe d'opérateur définir une nouvelle famille d'opérateur définir un nouveau langage de procédures définir une nouvelle règle de réécriture définir une nouvelle politique de sécurité au niveau ligne pour une table définir un nouveau point de retournement pour la transaction en cours définir un nouveau schéma définir un nouveau générateur de séquence définir une nouvelle table définir une nouvelle table à partir des résultats d'une requête définir un nouveau tablespace définir une nouvelle configuration de la recherche de texte définir un nouveau dictionnaire de la recherche de texte définir un nouvel analyseur de la recherche de texte définir un nouveau modèle de la recherche de texte définir une nouvelle transformation définir un nouveau trigger définir une nouvelle vue définir des privilèges d'accès définir les droits d'accès par défaut définir ou modifier un label de sécurité à un objet définir ou modifier les commentaires d'un objet definer définition delete supprimer des lignes d'une table délimiteur caractère_délimiteur deserialfunc encodage_destination détruire un point de retournement précédemment défini nom_dictionnaire direction répertoire désactivé annuler l'état de la session contrainte de domaine contrainte_domaine nom_domaine élément vider une table ou un ensemble de tables activé encodage nom_encodage fonction_end la variable d'environnement EDITOR_LINENUMBER_SWITCH doit être configurée
pour spécifier un numéro de ligne
chaîne_d_échappement événement élément_exclusion élément_exclusion dans une contrainte EXCLUDE est : exécuter une instruction préparée exécute un bloc de code anonyme coût_exécution collationnement_existant valeur_enum_existante expression nom_extension nom_famille nom_fdw ffunc nom_fichier filtre_valeur filter_variable pour la table « %s.%s » forcer un point de vérification des journaux de transaction table distante nom_format élément_from nom_fonction_from_sql fonction le nom de la fonction est requis
nom_fonction compacter et optionnellement analyser une base de données engendrer une notification fonction_gettoken nom_groupe element_regroupement fonction_gestionnaire fonction_headline l'historique n'est pas supportée par cette installation
immutable importer la définition d'une table à partir d'un serveur distant assigné incrément index index_nom_colonne index_expression méthode_indexage nom_index paramètres_index dans les contraintes UNIQUE, PRIMARY KEY et EXCLUDE, les paramètres_index sont : index_prédicat fonction_init condition_initiale gestionnaire_en_ligne fonction_en_sortie insert installer une extension entier longueur_interne binaire « %s » invalide commande \%s invalide
numéro de ligne invalide : %s
format de sortie invalide (erreur interne) : %d invoker istemplate colonne_de_jointure condition_de_jointure join_proc type_de_jointure label nom_langage oid_large_object lc_collate lc_ctype type_argument_gauche fonction_lexize fonction_lextypes option_like type_like symbole_link se mettre à l'écoute d'une notification charger un fichier de bibliothèque partagée socket locale schéma_local locale verrouiller une table mode_de_verrou loid vue matérialisée valeur_max objet_membre méthode mffunc m_condition_initiale valeur_min minvfunc plus d'une ligne retournée pour \gset
msfunc m_taille_de_données_statut m_type_de_données_statut nom neg_op nouveau_nom_attribut nouvelle_nom_colonne nouvelle_nom_contrainte nouveau_dictionnaire nouvelle_valeur_enum nouveau_nom nouveau_propriétaire nouveau_rôle nouveau_schéma nouvelle_table nouveau_tablespace nouvelle_version non aucun tampon de requête
aucune ligne retournée pour \gset
normal non NULL chaîne_null fichier_objet nom_objet désactivé ancien_dictionnaire ancien_rôle ancienne_version activé type_op classe_d_opérateur opérateur classe d'opérateur famille d'opérateur nom_opérateur option ou l'ancienne syntaxe mémoire épuisée mémoire épuisée
expression_en_sortie fonction_en_sortie nom_en_sortie paramètre table_parent nom_analyseur mot_de_passe contenu échec de pclose : %s nom_politique positionner un curseur prédicat préféré préparer une instruction pour exécution préparer la transaction en cours pour une validation en deux phases clé primaire, fournisseur psql est l'interface interactive de PostgreSQL.
variables psql :
requête caractère_guillemet reconstruire des index fonction_receive colonne_référence nom_table_référencée table_référence nom_relation schema_distant supprimer un transtypage supprimer un collationnement supprimer une conversion supprimer un type de données supprimer une base de données supprimer un rôle de la base de données supprimer un domaine supprimer un descripteur de serveur distant supprimer une table distante supprimer un wrapper de données distantes supprimer une fonction supprimer une vue matérialisée supprimer un langage procédural supprimer une règle de réécriture supprimer une nouvelle politique de sécurité au niveau ligne pour une table supprimer un schéma supprimer une séquence supprimer une table supprimer un tablespace supprimer une configuration de la recherche de texte supprimer un dictionnaire de la recherche de texte supprimer un analyseur de la recherche de texte supprimer un modèle de la recherche de texte supprimer une transformation supprimer un trigger supprime une correspondance utilisateur pour un serveur distant supprimer une vue supprimer des privilèges d'accès supprimer une méthode d'accès supprimer une fonction d'agrégation supprimer un trigger sur évènement supprimer une extension supprimer un index supprimer un opérateur supprimer une classe d'opérateur supprimer une famille d'opérateur supprimer les objets appartenant à un rôle remplacer le contenu d'une vue matérialisée réplicat res_proc nouveau_début réinitialiser un paramètre d'exécution à sa valeur par défaut restricted lignes_de_résultat extraire certaines lignes d'une requête à l'aide d'un curseur extraire des lignes d'une table ou d'une vue type_en_retour nom_règle_réécriture type_argument_droit nom_rôle specification_role annuler jusqu'au point de retournement règle nom_règle safe méthode_echantillonnage nom_savepoint élément_schéma nom_schéma graine sélection fonction_send séquence nom_séquence serialfunc nom_serveur type_serveur version_serveur définir le moment de la vérification des contraintes pour la transaction en cours définir les caractéristiques de la transaction en cours définir l'identifiant actuel de l'utilisateur de la session courante définir l'identifiant de l'utilisateur de session et l'identifiant actuel de
l'utilisateur de la session courante sfunc afficher le plan d'exécution d'une instruction afficher la valeur d'un paramètre d'exécution ignore l'expansion récursive de la variable « %s »
id_snapshot expression_de_tri nom_famille_tri opérateur_de_tri configuration_source encodage_source table_source type_source spécial stable début débuter un bloc de transaction fonction_start taille_de_données_statut type_de_données_statut instruction arrêter l'écoute d'une notification stockage paramètre_stockage type_stockage numéro_de_stratégie sous-SELECT sous_type fonction_diff_sous_type classe_opérateur_sous_type numéro_de_support la complétion de la requête a échoué : %s
La requête était :
%s
table contrainte de table contrainte_table contrainte_table_utilisant_index nom_table nom_tablespace option_tablespace rôle_cible type_cible modèle texte horodatage fuseau_horaire nom_fonction_to_sql type_jeton id_transaction mode_transaction trigger nom_trigger tente de sortir du mode copy type fonction_en_entrée_modificateur_type fonction_en_sortie_modificateur_type nom_type uid PQresultStatus inattendu : %d
statut résultat inattendu pour \watch
état de la transaction inattendu (%d)
unique, inconnu valeur « %s » non reconnue pour « %s » ; suppose « %s »
unsafe chaîne entre guillemets non terminée
update actualiser les lignes d'une table l'utilisateur n'existe pas échec de la recherche du nom d'utilisateur : code d'erreur %lu nom_utilisateur expression_using fonction_val fonction_validateur valeur valeurs version vue le nom de la vue est requis
nom_option_vue valeur_option_vue volatile où abbreviated_grant_or_revoke fait partie de : où action fait partie de : où signature_agrégat est : où contrainte_colonne est : où cible_conflit fait partie de : où la contrainte est : où direction peut être vide ou faire partie de : où événement fait partie de : où élément_from fait partie de : où mode_de_verrou fait partie de : où objet_membre fait partie de : où option fait partie de : où option peut être : où specification_role peut être : où mode_transaction fait partie de : window définition_window nom_window requête_with nom_requête_with oui locale/zh_CN/LC_MESSAGES/pg_rewind-9.6.mo 0000644 00000044175 14751153421 0013434 0 ustar 00 �� � �
�
- �
1 �
? �
K 9 C � ; � C 9 I G � @ � O h � � � � � J � > 9 , x 6 � < � 1 ? K = � = � 9 4 A 9 v 4 � 2 � @ R Y > � � � 1 E W l v � p � d - � 4 � & �
� $ P � R � c K - � � � / ; J � � # � � % � % $ E + j $ � � $ � L � , K 0 x " � ) � , � # $ A $ f # � ' � " � � " & ; $ b � ( � � " � ' < Y x � 2 � � ' � ' / F - v � 6 � � ; ) J t + � % � � ! ! 3 #! 6 W! 1 �! �! ' �! < " _ D" �" �" ! �" F �" 0# G# a# 1 {# C �# " �# . $ # C$ > g$ 6 �$ 3 �$ 6 % 0 H% y% + �% & �% �% & ! '& ( I& I r& $ �& ' �& ' - &' J T' = �' A �' 6 ( 5 V( 5 �( ! �( 7 �( / ) 6 L) 1 �) - �) 9 �) � * - �+ 2 �+ : , C V, @ �, @ �, C - 4 `- C �- C �- . G '. o. �. �. �. �. �. J �. 8 D/ # }/ / �/ 5 �/ 3 0 8 ;0 4 t0 > �0 6 �0 . 1 N N1 C �1 C �1 a %2 w �2 V �2
V3 + a3 + �3 �3 �3 �3 �3 �3 ] 4 Y t4 / �4 / �4 * .5 Y5 } t5 S �5 U F6 a �6 / �6 .7 H7 % _7 + �7 �7 ' �7 �7
8 ! &8 H8 f8 $ �8 �8 �8 �8 @ 9 ' C9 , k9 �9 ' �9 ( �9 : #: ! B: ! d: & �: �: �: �: ! ; %; A; ! ^; , �; + �; 1 �; < ! '< I< g< ' < % �< �< �< 2 = 4 := " o= 2 �= �= A �= + > " D> % g> . �> �> $ �> < ? = >? : |? # �? / �? < @ p H@ �@
�@ ( �@ S
A aA xA �A 6 �A > �A ( B 7 HB �B D �B D �B . +C . ZC ( �C �C % �C �C D *D $ JD ( oD H �D �D , E /E 2 OE N �E : �E 8 F G EF : �F : �F ( G = ,G 7 jG ; �G 8 �G 8 H , PH � % 5 � - { � � � [ � q o � M J | � � $ < d U � 1 z x : � 6 . i F
f R ) � b � 8 k I ' l _ p � � � @ 9 � s D " � � 0 # t 3 � � � ` P h w � } ( � ]
B v L E > g 2 a Q c r � / m ? � ; � S X u Y T + e y K � H N G 4 O j = � � Z & n , W ^ � � C A ~ V \ ! * 7 �
Report bugs to <pgsql-bugs@postgresql.org>.
creating backup label and updating control file
--debug write a lot of debug messages
--source-pgdata=DIRECTORY source data directory to synchronize with
--source-server=CONNSTR source server to synchronize with
-?, --help show this help, then exit
-D, --target-pgdata=DIRECTORY existing data directory to modify
-P, --progress write progress messages
-V, --version output version information, then exit
-n, --dry-run stop before modifying anything
block %u
"%s" is a symbolic link, but symbolic links are not supported on this platform
"%s" is not a directory
"%s" is not a regular file
"%s" is not a symbolic link
%*s/%s kB (%d%%) copied %d: %X/%X - %X/%X
%s (%s)
%s resynchronizes a PostgreSQL cluster with another copy of the cluster.
%s: WARNING: cannot create restricted tokens on this platform
%s: could not allocate SIDs: error code %lu
%s: could not create restricted token: error code %lu
%s: could not get exit code from subprocess: error code %lu
%s: could not open process token: error code %lu
%s: could not re-execute with restricted token: error code %lu
%s: could not start process for command "%s": error code %lu
%s: no source specified (--source-pgdata or --source-server)
%s: no target data directory specified (--target-pgdata)
%s: too many command-line arguments (first is "%s")
BKPBLOCK_HAS_DATA not set, but data length is %u at %X/%X BKPBLOCK_HAS_DATA set, but no data included at %X/%X BKPBLOCK_SAME_REL set but no previous rel at %X/%X BKPIMAGE_HAS_HOLE not set, but hole offset %u length %u at %X/%X BKPIMAGE_HAS_HOLE set, but hole offset %u length %u block image length %u at %X/%X BKPIMAGE_IS_COMPRESSED set, but block image length %u at %X/%X Done!
Expected a numeric timeline ID.
Expected a transaction log switchpoint location.
Failure, exiting
Invalid control file Options:
Source timeline history:
Target timeline history:
The program "initdb" is needed by %s but was
not found in the same directory as "%s".
Check your installation.
The program "initdb" was found by "%s"
but was not the same version as %s.
Check your installation.
Timeline IDs must be in increasing sequence.
Timeline IDs must be less than child timeline's ID.
Try "%s --help" for more information.
Usage:
%s [OPTION]...
WAL file is from different database system: WAL file database system identifier is %s, pg_control database system identifier is %s WAL file is from different database system: incorrect XLOG_BLCKSZ in page header WAL file is from different database system: incorrect XLOG_SEG_SIZE in page header WAL record modifies a relation, but record type is not recognized
lsn: %X/%X, rmgr: %s, info: %02X
You must run %s as the PostgreSQL superuser.
backup label buffer too small
cannot be executed by "root"
cannot duplicate null pointer (internal error)
clusters are not compatible with this version of pg_rewind
connected to server
contrecord is requested by %X/%X could not close directory "%s": %s
could not close file "%s": %s
could not close target file "%s": %s
could not connect to server: %s could not create directory "%s": %s
could not create symbolic link at "%s": %s
could not create temporary table: %s could not fetch file list: %s could not fetch remote file "%s": %s could not find common ancestor of the source and target cluster's timelines
could not find previous WAL record at %X/%X
could not find previous WAL record at %X/%X: %s
could not open directory "%s": %s
could not open file "%s" for reading: %s
could not open file "%s" for truncation: %s
could not open file "%s": %s
could not open source file "%s": %s
could not open target file "%s": %s
could not read WAL record at %X/%X
could not read WAL record at %X/%X: %s
could not read directory "%s": %s
could not read file "%s": %s
could not read from file "%s": %s
could not read symbolic link "%s": %s
could not remove directory "%s": %s
could not remove file "%s": %s
could not remove symbolic link "%s": %s
could not seek in file "%s": %s
could not seek in source file: %s
could not seek in target file "%s": %s
could not send COPY data: %s could not send end-of-COPY: %s could not send file list: %s could not send query: %s could not set libpq connection to single row mode
could not stat file "%s": %s
could not truncate file "%s" to %u: %s
could not write file "%s": %s
data file "%s" in source is not a regular file
error running query (%s) in source server: %s fetched file "%s", length %d
full_page_writes must be enabled in the source server
getting file chunks
incorrect resource manager data checksum in record at %X/%X invalid action (CREATE) for regular file
invalid block_id %u at %X/%X invalid compressed image at %X/%X, block %d invalid contrecord length %u at %X/%X invalid data in history file
invalid data in history file: %s
invalid info bits %04X in log segment %s, offset %u invalid magic number %04X in log segment %s, offset %u invalid record length at %X/%X: wanted %u, got %u invalid record offset at %X/%X invalid resource manager ID %u at %X/%X need to copy %lu MB (total source directory size is %lu MB)
neither BKPIMAGE_HAS_HOLE nor BKPIMAGE_IS_COMPRESSED set, but block image length is %u at %X/%X no rewind required
out of memory
out-of-order block_id %u at %X/%X out-of-sequence timeline ID %u (after %u) in log segment %s, offset %u reading WAL in target
reading source file list
reading target file list
received chunk for file "%s", offset %d, size %d
received null value for chunk for file "%s", file has been deleted
record length %u at %X/%X too long record with incorrect prev-link %X/%X at %X/%X record with invalid length at %X/%X rewinding from last common checkpoint at %X/%X on timeline %u
servers diverged at WAL position %X/%X on timeline %u
source and target cluster are on the same timeline
source and target clusters are from different systems
source data directory must be shut down cleanly
source file list is empty
source server must not be in recovery mode
symbolic link "%s" target is too long
sync of target directory failed
syncing target data directory
syntax error in history file: %s
target server must be shut down cleanly
target server needs to use either data checksums or "wal_log_hints = on"
there is no contrecord flag at %X/%X unexpected EOF while reading file "%s"
unexpected control file CRC
unexpected control file size %d, expected %d
unexpected data types in result set while fetching remote files: %u %u %u
unexpected null values in result while fetching remote files
unexpected page modification for directory or symbolic link "%s"
unexpected pageaddr %X/%X in log segment %s, offset %u unexpected result format while fetching remote files
unexpected result length while fetching remote files
unexpected result set from query
unexpected result set size while fetching remote files
unexpected result set while fetching file list
unexpected result set while fetching remote file "%s"
unexpected result while fetching remote files: %s unexpected result while sending file list: %s unrecognized result "%s" for current WAL insert location
Project-Id-Version: pg_rewind (PostgreSQL) 9.5
Report-Msgid-Bugs-To: pgsql-bugs@postgresql.org
POT-Creation-Date: 2016-04-18 04:45+0000
PO-Revision-Date: 2016-05-19 20:41+0800
Last-Translator: Yuwei Peng <ywpeng@whu.edu.cn>
Language-Team: Chinese (Simplified) <ywpeng@whu.edu.cn>
Language: zh_CN
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
X-Generator: Poedit 1.5.7
报告错误至 <pgql-bugs@postgresql.org>.
正在创建备份标签并且更新控制文件
--debug 写出很多调试消息
--source-pgdata=DIRECTORY 要与之同步的源数据目录
--source-server=CONNSTR 要与之同步的源服务器
-?, --help 显示本帮助，然后退出
-D, --target-pgdata=DIRECTORY 已有的要修改的数据目录
-P, --progress 写出进度消息
-V, --version 输出版本信息，然后退出
-n, --dry-run 在修改任何东西之前停止
块 %u
"%s"是一个符号链接，但是这个平台上不支持平台链接
"%s"不是一个目录
"%s"不是一个常规文件
"%s"不是一个符号链接
已复制%*s/%s kB (%d%%) %d: %X/%X - %X/%X
%s (%s)
%s用一个PostgreSQL集簇的另一个拷贝重新同步了该集簇。
%s: WARNING: 无法为该平台创建受限制的令牌
%s: 无法分配SID: 错误码 %lu
%s: 无法创建受限令牌: 错误码为 %lu
%s: 无法从子进程得到退出码: 错误码 %lu
%s:无法打开进程令牌 (token): 错误码 %lu
%s: 无法使用受限令牌再次执行: 错误码 %lu
%s: 无法为命令 "%s"创建进程: 错误码 %lu
%s：没有指定源 (--source-pgdata 或者 --source-server)
%s：没有指定目标数据目录 (--target-pgdata)
%s: 命令行参数太多 (第一个是 "%s")
BKPBLOCK_HAS_DATA没有被设置，但是在%2$X/%3$X处的数据长度为%1$u BKPBLOCK_HAS_DATA已被设置，但是在%X/%X处没有包括数据 BKPBLOCK_SAME_REL已被设置，但是在%X/%X没有前一个关系 BKPIMAGE_HAS_HOLE没有被设置，但是%3$X/%4$X处记录了洞偏移量为%1$u、长度为%2$u BKPIMAGE_HAS_HOLE已被设置，但是%4$X/%5$X处记录了洞偏移量为%1$u、长度为%2$u、块映像长度为%3$u BKPIMAGE_IS_COMPRESSED已被设置，但是%2$X/%3$X处记录的块映像长度为%1$u 完成！
需要一个数字形式的时间线 ID。
需要一个事务日志切换点位置。
故障，退出
无效的控制文件 选项:
源时间线历史:
目标时间线历史:
%1$s需要程序"initdb", 但是在同一个目录"%2$s"中没找到.
请检查您的安装.
"%1$s"找到了程序"initdb", 但是和"%2$s"的版本不一致.
请检查您的安装.
时间线 ID 必须处于一个增序列中。
时间线 ID 必须小于子时间线的 ID。
请用 "%s --help" 获取更多的信息.
用法:
%s [选项]...
WAL文件来自于不同的数据库系统：WAL文件数据库系统标识符是%s，pg_control数据库系统标识符是%s WAL文件来自于不同的数据库系统：页头部中有不正确的XLOG_BLCKSZ WAL文件来自于不同的数据库系统：页头部中有不正确的XLOG_SEG_SIZE WAL记录修改了一个关系，但是记录类型无法识别
lsn: %X/%X, rmgr: %s, info: %02X
您现在作为PostgreSQL超级用户运行%s.
备份标签缓冲太小
不能由"root"执行
无法复制空指针 (内部错误)
集簇与这个pg_rewind的版本不兼容
已连接服务器
%X/%X请求继续记录（contrecord） 无法关闭目录 "%s": %s
无法关闭文件"%s": %s
无法关闭目标文件"%s": %s
无法连接到服务器：%s 无法创建目录 "%s": %s
无法在"%s"创建符号链接: %s
无法创建临时表：%s 无法取得文件列表：%s 无法取得远程文件"%s": %s 无法找到源集簇和目标集簇的时间线的共同祖先
无法在%X/%X找到前一个WAL记录
无法在%X/%X找到前一个WAL记录：%s
无法打开目录 "%s": %s
无法打开文件"%s"用于读取: %s
无法打开文件"%s"用于截断：%s
无法打开文件 "%s": %s
无法打开源文件"%s": %s
无法打开目标文件"%s": %s
无法读取%X/%X处的WAL记录
无法读取%X/%X处的WAL记录：%s
无法读取目录 "%s": %s
无法读取文件"%s": %s
无法读取文件 "%s": %s
无法读取符号链接"%s": %s
无法移除目录"%s": %s
无法删除文件 "%s": %s
无法移除符号链接"%s": %s
无法在文件"%s"中定位（seek）：%s
无法在源文件中定位（seek）：%s
无法在目标文件"%s"中定位（seek）: %s
无法发送COPY数据：%s 无法发送COPY结束标记：%s 无法发送文件列表：%s 无法发送查询：%s 无法设置libpq连接为单行模式
无法获取文件 "%s":%s 的状态
无法截断文件"%s"到%u: %s
无法写文件"%s": %s
源头的数据文件"%s"不是一个常规文件
源服务器中有错误运行的查询（%s）：%s 获取到文件"%s"，长度为%d
源服务器中的full_page_writes必须被启用
获取文件块
%X/%X处的记录中有不正确的资源管理器数据校验和 对常规文件无效的动作（CREATE）
%2$X/%3$X处有无效block_id %1$u %X/%X处是块%d的无效压缩映像 %2$X/%3$X处有无效的继续记录长度%1$u 历史文件中有无效数据
历史文件中有无效数据：%s
在日志段%2$s的偏移量%3$u处有无效的info位%1$04X 在日志段%2$s的偏移量%3$u处有无效的magic号%1$04X %X/%X处有无效记录长度: 应该是%u, 但实际是%u %X/%X处有无效的记录偏移量 %2$X/%3$X处有无效的资源管理器 ID %1$u 需要复制 %lu MB（整个源目录的大小是 %lu MB）
BKPIMAGE_HAS_HOLE和BKPIMAGE_IS_COMPRESSED都没有被设置，但是%2$X/%3$X处记录的块映像长度为%1$u 不需要倒带（rewind）
内存溢出
在%2$X/%3$X处有无序的block_id %1$u 在日志段%3$s的偏移量%4$u处有失序的时间线 ID %1$u（在%2$u之后） 读取目标中的WAL
读取源文件列表
读取目标文件列表
收到文件"%s"的块，偏移量为%d，大小为%d
收到的文件"%s"的块中有空值，文件已经被删除
%2$X/%3$X处有的记录长度%1$u过长 %3$X/%4$X处的记录有不正确的prev-link %1$X/%2$X %X/%X处的记录的长度无效 从时间线%3$u上%1$X/%2$X处的最后一个普通检查点倒带
服务器在时间线%3$u上的WAL位置%1$X/%2$X处发生了分歧
源集簇和目标集簇处于同一时间线
源集簇和目标集簇来自不同的系统
源数据目录必须被干净地关闭
源文件列表为空
源服务器不能处于恢复模式
符号链接"%s"的目标过长
目标目录同步失败
正在同步目标数据目录
历史文件中有语法错误：%s
目标服务器必须被干净地关闭
目标服务器需要使用数据校验和或者让"wal_log_hints = on"
%X/%X处没有继续记录标志 读取文件"%s"时遇到意料之外的EOF
意料之外的控制文件CRC
意料之外的控制文件大小%d，应该是%d
在取得远程文件时结果集中有意料之外的数据类型：%u %u %u
在取得远程文件时结果中有意料之外的空值
对目录或符号链接"%s"的意料之外的页修改
在日志段%3$s的偏移量%4$u处有意料之外的pageaddr %1$X/%2$X 在取得远程文件时得到意料之外的结果格式
在取得远程文件时得到意料之外的结果长度
从查询得到意料之外的结果集
在取得远程文件时得到意料之外的结果集大小
在取得文件列表时得到意料之外的结果集
在取得远程文件"%s"时得到意料之外的结果集
在取得远程文件时得到意料之外的结果：%s 在发送文件列表时得到意料之外的结果：%s 当前WAL插入位置的未识别结果"%s"
locale/zh_CN/LC_MESSAGES/initdb-9.6.mo 0000644 00000051534 14751153421 0012724 0 ustar 00 �� � $ � ,
�
R �
�
% - 6 g d ` � � - W � W H � A � 5 � J j 6 � P � C : R Q � 5 � ] 4 s B � H � G 4 > | 4 � 9 � 3 * ? ^ / � - � > � y ; ( � # � , - / 7 ] ( � 6 � , � ' " 5 J F � " � < � & ' - N - | ! � 1 � ? � & > / e = � ! � " � 6 + O { 0 � ; � $ � / $ & T { $ � ~ � 1 = < o � G � 3 8 F ( J � � � � � C � - 3! 8 a! ! �! , �! �! / " 4 1" A f" @ �" R �" K <# " �# ! �# � �# d S$ �$ �$ � �$ [ l% R �% K & % g& �& �& �& ; �& ; ' � T' @ �' ; &( b( u s) q �) f [* s �* & 6+ ]+ ) e+ t �+ / , 4, & C, 0 j, . �, ) �, ) �, - 5- & G- # n- �- $ �- ( �- + . " -. P. " k. ! �. , �. $ �. * / % -/ ! S/ u/ �/ 0 �/ �/ �/ �/ 0 - 0 E0 & c0 % �0 3 �0 �0 �0 ( 1 � ;1 > �2 3 -3 73 - G3 w u3 V �3 � D4 F �4 D 15
v5 C �6 1 �6 M �6 E7 : a7 > �7 > �7 2 8 @ M8 1 �8 N �8 5 9 = E9 G �9 C �9 8 : 8 H: / �: / �: 8 �: - ; 4 H; 8 }; x �; /< P< # q< ! �< * �< �< / = & 3= Z= > {= H �= . > 5 2> h> . �> + �> �> 3 ? 8 9? r? * �? 4 �? ! �? @ ; 3@ * o@ �@ # �@ , �@ A &A + DA pA # �A j �A , B / GB ! wB D �B A �B 6 C ( WC G �C � �C QD cD 5 �D & �D , �D
E . 'E VE 1 rE . �E : �E 5 F W DF M �F # �F G y /G j �G H &H z GH E �H X I H aI , �I �I �I J 4 $J : YJ � �J 7 K 2 UK �K f �L ] �L Q QM U �M * �M $N % 3N X YN % �N
�N # �N #
O ) .O XO uO �O �O " �O �O ! �O P 9P % VP |P �P �P �P % �P Q . 8Q gQ �Q �Q �Q ' �Q �Q
R
R #R " :R ]R 2 zR 7 �R % �R S $S ' 4S � � 5 ( � Y � J k 6 H X � � K y � � � q I � z � N c R V n { } � � . x U | � l � _ G = * e / $ � > ^ � # A � s C 8 \ 0 T , � % + u L 3 � 2 m � � g B i E ? 9 ) ! & � � � p � � D S f
d ; ' ] " F w b � v P Z r � @ h �
1 - [ � t : j � 4 W Q 7 O ~ � < M o ` a �
If the data directory is not specified, the environment variable PGDATA
is used.
Less commonly used options:
Options:
Other options:
Report bugs to <pgsql-bugs@postgresql.org>.
Success. You can now start the database server using:
%s%s%spg_ctl%s -D %s%s%s -l logfile start
Sync to disk skipped.
The data directory might become corrupt if the operating system crashes.
WARNING: enabling "trust" authentication for local connections
You can change this by editing pg_hba.conf or using the option -A, or
--auth-local and --auth-host, the next time you run initdb.
--auth-host=METHOD default authentication method for local TCP/IP connections
--auth-local=METHOD default authentication method for local-socket connections
--lc-collate=, --lc-ctype=, --lc-messages=LOCALE
--lc-monetary=, --lc-numeric=, --lc-time=LOCALE
set default locale in the respective category for
new databases (default taken from environment)
--locale=LOCALE set default locale for new databases
--no-locale equivalent to --locale=C
--pwfile=FILE read password for the new superuser from file
%s [OPTION]... [DATADIR]
-?, --help show this help, then exit
-A, --auth=METHOD default authentication method for local connections
-E, --encoding=ENCODING set default encoding for new databases
-L DIRECTORY where to find the input files
-N, --nosync do not wait for changes to be written safely to disk
-S, --sync-only only sync data directory
-T, --text-search-config=CFG
default text search configuration
-U, --username=NAME database superuser name
-V, --version output version information, then exit
-W, --pwprompt prompt for a password for the new superuser
-X, --xlogdir=XLOGDIR location for the transaction log directory
-d, --debug generate lots of debugging output
-k, --data-checksums use data page checksums
-n, --noclean do not clean up after errors
-s, --show show internal settings
[-D, --pgdata=]DATADIR location for this database cluster
%s initializes a PostgreSQL database cluster.
%s: "%s" is not a valid server encoding name
%s: WARNING: cannot create restricted tokens on this platform
%s: cannot be run as root
Please log in (using, e.g., "su") as the (unprivileged) user that will
own the server process.
%s: could not access directory "%s": %s
%s: could not access file "%s": %s
%s: could not allocate SIDs: error code %lu
%s: could not change permissions of "%s": %s
%s: could not change permissions of directory "%s": %s
%s: could not create directory "%s": %s
%s: could not create restricted token: error code %lu
%s: could not create symbolic link "%s": %s
%s: could not execute command "%s": %s
%s: could not find suitable encoding for locale "%s"
%s: could not find suitable text search configuration for locale "%s"
%s: could not fsync file "%s": %s
%s: could not get exit code from subprocess: error code %lu
%s: could not open directory "%s": %s
%s: could not open file "%s" for reading: %s
%s: could not open file "%s" for writing: %s
%s: could not open file "%s": %s
%s: could not open process token: error code %lu
%s: could not re-execute with restricted token: error code %lu
%s: could not read directory "%s": %s
%s: could not read password from file "%s": %s
%s: could not start process for command "%s": error code %lu
%s: could not stat file "%s": %s
%s: could not write file "%s": %s
%s: data directory "%s" not removed at user's request
%s: directory "%s" exists but is not empty
%s: encoding mismatch
%s: failed to remove contents of data directory
%s: failed to remove contents of transaction log directory
%s: failed to remove data directory
%s: failed to remove transaction log directory
%s: failed to restore old locale "%s"
%s: file "%s" does not exist
%s: file "%s" is not a regular file
%s: input file "%s" does not belong to PostgreSQL %s
Check your installation or specify the correct path using the option -L.
%s: input file location must be an absolute path
%s: invalid authentication method "%s" for "%s" connections
%s: invalid locale name "%s"
%s: invalid locale settings; check LANG and LC_* environment variables
%s: locale "%s" requires unsupported encoding "%s"
%s: locale name has non-ASCII characters, skipped: "%s"
%s: locale name too long, skipped: "%s"
%s: must specify a password for the superuser to enable %s authentication
%s: no data directory specified
You must identify the directory where the data for this database system
will reside. Do this with either the invocation option -D or the
environment variable PGDATA.
%s: out of memory
%s: password file "%s" is empty
%s: password prompt and password file cannot be specified together
%s: removing contents of data directory "%s"
%s: removing contents of transaction log directory "%s"
%s: removing data directory "%s"
%s: removing transaction log directory "%s"
%s: setlocale() failed
%s: symlinks are not supported on this platform %s: too many command-line arguments (first is "%s")
%s: transaction log directory "%s" not removed at user's request
%s: transaction log directory location must be an absolute path
%s: warning: specified text search configuration "%s" might not match locale "%s"
%s: warning: suitable text search configuration for locale "%s" is unknown
Data page checksums are disabled.
Data page checksums are enabled.
Encoding "%s" implied by locale is not allowed as a server-side encoding.
The default database encoding will be set to "%s" instead.
Encoding "%s" is not allowed as a server-side encoding.
Rerun %s with a different locale selection.
Enter it again: Enter new superuser password: If you want to create a new database system, either remove or empty
the directory "%s" or run %s
with an argument other than "%s".
If you want to store the transaction log there, either
remove or empty the directory "%s".
It contains a dot-prefixed/invisible file, perhaps due to it being a mount point.
It contains a lost+found directory, perhaps due to it being a mount point.
No usable system locales were found.
Passwords didn't match.
Rerun %s with the -E option.
Running in debug mode.
Running in noclean mode. Mistakes will not be cleaned up.
The database cluster will be initialized with locale "%s".
The database cluster will be initialized with locales
COLLATE: %s
CTYPE: %s
MESSAGES: %s
MONETARY: %s
NUMERIC: %s
TIME: %s
The default database encoding has accordingly been set to "%s".
The default text search configuration will be set to "%s".
The encoding you selected (%s) and the encoding that the
selected locale uses (%s) do not match. This would lead to
misbehavior in various character string processing functions.
Rerun %s and either do not specify an encoding explicitly,
or choose a matching combination.
The files belonging to this database system will be owned by user "%s".
This user must also own the server process.
The program "postgres" is needed by %s but was not found in the
same directory as "%s".
Check your installation.
The program "postgres" was found by "%s"
but was not the same version as %s.
Check your installation.
This might mean you have a corrupted installation or identified
the wrong directory with the invocation option -L.
Try "%s --help" for more information.
Usage:
Use the option "--debug" to see details.
Using a mount point directly as the data directory is not recommended.
Create a subdirectory under the mount point.
cannot duplicate null pointer (internal error)
caught signal
child process exited with exit code %d child process exited with unrecognized status %d child process was terminated by exception 0x%X child process was terminated by signal %d child process was terminated by signal %s command not executable command not found could not change directory to "%s": %s could not close directory "%s": %s
could not find a "%s" to execute could not get junction for "%s": %s
could not identify current directory: %s could not look up effective user ID %ld: %s could not open directory "%s": %s
could not read binary "%s" could not read directory "%s": %s
could not read symbolic link "%s" could not remove file or directory "%s": %s
could not set junction for "%s": %s
could not stat file or directory "%s": %s
could not write to child process: %s
creating configuration files ... creating directory %s ... creating subdirectories ... fixing permissions on existing directory %s ... invalid binary "%s" ok
out of memory
pclose failed: %s performing post-bootstrap initialization ... running bootstrap script ... selecting default max_connections ... selecting default shared_buffers ... selecting dynamic shared memory implementation ... syncing data to disk ... user does not exist user name lookup failure: error code %lu Project-Id-Version: initdb (PostgreSQL 9.0)
Report-Msgid-Bugs-To: pgsql-bugs@postgresql.org
POT-Creation-Date: 2016-04-18 04:44+0000
PO-Revision-Date: 2016-05-19 20:39+0800
Last-Translator: Yuwei Peng <ywpeng@whu.edu.cn>
Language-Team: Chinese (Simplified) <ywpeng@whu.edu.cn>
Language: zh_CN
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
X-Generator: Poedit 1.5.7
如果没有指定数据目录, 将使用环境变量 PGDATA
非普通使用选项:
选项:
其它选项:
报告错误至 <pgql-bugs@postgresql.org>.
成功。您现在可以用下面的命令开启数据库服务器：
%s%s%spg_ctl%s -D %s%s%s -l logfile start
跳过同步到磁盘操作.
如果操作系统宕机，数据目录可能会毁坏.
警告:为本地连接启动了 "trust" 认证.
你可以通过编辑 pg_hba.conf 更改或你下次
行 initdb 时使用 -A或者--auth-local和--auth-host选项.
--auth-host=METHOD 本地的TCP/IP连接的默认认证方法
--auth-local=METHOD 本地socket连接的默认认证方法
--lc-collate, --lc-ctype, --lc-messages=LOCALE
--lc-monetary, --lc-numeric, --lc-time=LOCALE
为新的数据库簇在各自的目录中分别
设定缺省语言环境（默认使用环境变
量)
--locale=LOCALE 为新数据库设置默认语言环境
--no-locale 等同于 --locale=C
--pwfile=文件名 对于新的超级用户从文件读取口令
%s [选项]... [DATADIR]
-?, --help 显示此帮助, 然后退出
-A, --auth=METHOD 本地连接的默认认证方法
-E, --encoding=ENCODING 为新数据库设置默认编码
-L DIRECTORY 输入文件的位置
-N, --nosync 不用等待变化安全写入磁盘
-S, --sync-only 只同步数据目录
-T, --text-search-config=CFG
缺省的文本搜索配置
-U, --username=NAME 数据库超级用户名
-V, --version 输出版本信息, 然后退出
-W, --pwprompt 对于新的超级用户提示输入口令
-X, --xlogdir=XLOGDIR 当前事务日志目录的位置
-d, --debug 产生大量的除错信息
-k, --data-checksums 使用数据页产生效验和
-n, --noclean 出错后不清理
-s, --show 显示内部设置
-D, --pgdata=DATADIR 当前数据库簇的位置
%s 初始化一个 PostgreSQL 数据库簇.
%s: "%s" 不是一个有效的服务器编码名字
%s: WARNING: 无法为该平台创建受限制的令牌
%s: 无法以 root 用户运行
请以服务器进程所有者的用户 (无特权) 身份
登陆 (使用, e.g., "su").
%s: 无法访问目录 "%s": %s
%s: 无法访问文件 "%s": %s
%s: 无法分配SID: 错误码 %lu
%s: 无法改变"%s"的权限:%s
%s: 无法改变目录 "%s" 的权限: %s
%s: 无法创建目录 "%s": %s
%s: 无法创建受限令牌: 错误码为 %lu
%s: 无法创建符号链接 "%s": %s
%s: 无法执行命令 "%s": %s
%s: 无法为locale(本地化语言)"%s"找到合适的编码
%s: 无法为本地化语言环境"%s"找到合适的文本搜索配置
%s: 无法对文件 "%s"进行fsync同步: %s
%s: 无法从子进程得到退出码: 错误码 %lu
%s: 无法打开目录 "%s": %s
%s: 为了读取, 无法打开文件 "%s": %s
%s: 为了写, 无法打开文件 "%s": %s
%s: 无法打开文件 "%s": %s
%s:无法打开进程令牌 (token): 错误码 %lu
%s: 无法使用受限令牌再次执行: 错误码 %lu
%s: 无法读取目录 "%s": %s
%s: 无法从文件 "%s" 读取口令: %s
%s: 无法为命令 "%s"创建进程: 错误码 %lu
%s: 无法统计文件: "%s": %s
%s: 无法写文件 "%s": %s
%s: 在用户的要求下数据库目录 "%s" 不被删除
%s: 目录"%s"已存在，但不是空的
%s: 警告: 编码不匹配
%s: 删除数据目录内容失败
%s: 删除事务日志目录的内容失败
%s: 删除数据目录失败
%s: 删除数据目录失败
%s: 无法恢复旧的本地化文件 "%s"
%s: 文件 "%s" 不存在
%s: 文件 "%s" 不是常规文件
%s: 输入文件 "%s" 不属于 PostgreSQL %s
检查你的安装或使用 -L 选项指定正确的路径.
%s: 输入文件位置必须为绝对路径
%s: 无效认证方法 "%s" 用于 "%s" 连接
%s: 无效的 locale 名字 "%s"
%s:无效的本地化设置; 请检查环境变量LANG和LC_*的值
%s: 本地化语言环境 "%s"要求使用不支持的编码"%s"
%s: 本地化名称带有非ASCII字符, 跳过: "%s"
%s: 本地化名称太长, 跳过: "%s"
%s: 为了启动 %s 认证, 你需要为超级用户指定一个口令
%s: 没有指定数据目录
您必须确认此数据库系统的数据所在目录
存在. 使用 -D 选项或者
环境变量 PGDATA.
%s: 内存溢出
%s：口令文件"%s"为空
%s: 口令提示和口令文件不能同时都指定
%s: 删除数据目录 "%s" 的内容
%s: 删除事务日志目录 "%s" 的内容
%s: 删除数据目录 "%s"
%s: 正在删除事务日志文件目录 "%s"
%s:setlocale()调用失败
%s: 在这个平台上不支持使用符号链接 %s: 命令行参数太多 (第一个是 "%s")
%s: 在用户的要求下不删除事务日志目录 "%s"
%s: 事务日志目录的位置必须为绝对路径
%s: 警告: 所指定的文本搜索配置"%s"可能与本地语言环境"%s"不匹配
%s: 警告: 对于本地化语言环境"%s"合适的文本搜索配置未知
禁止为数据页生成校验和.
允许生成数据页校验和.
本地化隐含的编码 "%s" 不允许作为服务器端的编码.
默认的数据库编码将采用 "%s" 作为代替.
不允许将编码"%s"作为服务器端编码.
使用一个不同的本地化语言环境重新运行%s.
再输入一遍: 输入新的超级用户口令: 如果您想创建一个新的数据库系统, 请删除或清空
目录 "%s" 或者运行带参数的 %s
而不是 "%s".
如果您要存储事务日志，需要删除或者清空目录"%s".
它包含一个不可见的带固定点的文件，可能因为它是一个装载点。
它包含名为lost+found的目录，可能因为它是一个加载点.
没有找到可用的系统本地化名称.
口令不匹配.
带 -E 选项重新运行 %s.
运行在除错模式中.
运行在 noclean 模式中. 错误将不被清理.
数据库簇将使用本地化语言 "%s"进行初始化.
数据库簇将带有一下 locales 初始化
COLLATE: %s
CTYPE: %s
MESSAGES: %s
MONETARY: %s
NUMERIC: %s
TIME: %s
默认的数据库编码已经相应的设置为 "%s".
缺省的文本搜索配置将会被设置到"%s"
您选择的编码 (%s) 和所选择的语言环境使用的编码 (%s) 不匹配的.
这样将导致处理不同字符串的函数时产生错误.
要修复此问题, 重新运行 %s 并且不要明确指定编码, 或者先选择一个匹配
组合类型.
属于此数据库系统的文件宿主为用户 "%s".
此用户也必须为服务器进程的宿主.
%s 需要程序 "postgres", 但是在同一个目录 "%s" 中没找到.
检查您的安装.
%s 找到程序 "postgres", 但是和版本 "%s" 不一致.
检查您的安装.
这意味着您的安装发生了错误或
使用 -L 选项指定了错误的路径.
请用 "%s --help" 获取更多的信息.
使用方法:
使用选项 "--debug" 获取细节.
不推荐将加载点作为数据目录.
通常在加载点下边创建一个子目录.
无法复制空指针 (内部错误)
捕获信号
子进程已退出, 退出码为 %d 子进程已退出, 未知状态 %d 子进程被例外(exception) 0x%X 终止 子进程被信号 %d 终止 子进程被信号 %s 终止 命令无法执行 命令没有找到 无法跳转到目录 "%s" 中: %s 无法关闭目录 "%s": %s
未能找到一个 "%s" 来执行 无法为"%s"得到连接: %s
无法确认当前目录: %s 无法找到有效的用户ID %ld: %s 无法打开目录 "%s": %s
无法读取二进制码 "%s" 无法读取目录 "%s": %s
无法读取符号链结 "%s" 无法删除文件或目录 "%s": %s
无法为 "%s"设置连接: %s
无法获取文件或目录 "%s"的状态: %s
无法写到子进程: %s
创建配置文件 ... 创建目录 %s ... 正在创建子目录 ... 修复已存在目录 %s 的权限 ... 无效的二进制码 "%s" 成功
内存溢出
pclose调用失败: %s 正在执行自举后初始化 ... 正在运行自举脚本 ... 选择默认最大联接数 (max_connections) ... 选择默认共享缓冲区大小 (shared_buffers) ... 选择动态共享内存实现 ...... 同步数据到磁盘... 用户不存在 用户名查找失败：错误代码%lu locale/zh_CN/LC_MESSAGES/pg_dump-9.6.mo 0000644 00000156652 14751153421 0013115 0 ustar 00 �� � L � | �( �( �( X �( [ 3) B �) ) �) " �) x * �* �* �* �* A �* N &+ P u+ I �+ 3 , y D, G �, C - N J- K �- v �- F \. > �. R �. B 5/ E x/ ? �/ L �/ 3 K0 6 0 Q �0 T 1 M ]1 ? �1 � �1 � y2 ? 23 9 r3 5 �3 : �3 K 4 B i4 D �4 � �4 3 r5 � �5 ? (6 D h6 x �6 6 &7 Q ]7 O �7 F �7 > F8 5 �8 > �8 E �8 A @9 O �9 H �9 B : @ ^: = �: O �: H -; ; v; , �; 4 �; E < 0 Z< = �< , �< F �< D == C �= F �= 8
> ? F> C �> = �> 4 ? 7 =? L u? = �? @ @ I A@ < �@ L �@ , A ( BA 5 kA E �A T �A <B 9 ?B D yB G �B C !C ? <C ' |C + �C e �C ! 6D , XD 4 �D 6 �D ( �D / E JE hE $ zE * �E 2 �E B �E > @F J F P �F N G H jG - �G �G �G / H 9H 4 KH $ �H & �H * �H # �H I P :I C �I A �I ( J :J XJ qJ �J = �J �J K � K �K 1 �K �K
L , L LL � dL , �L +M BM p WM e �M .N & GN nN ` vN p �N 4 HO X }O _ �O E 6P 1 |P 6 �P 4 �P * Q - EQ . sQ + �Q + �Q ) �Q * $R > OR 8 �R ' �R = �R ) -S - WS �S @ �S 7 �S 6 T 6 PT < �T = �T 4 U 3 7U b kU 9 �U t V # }V , �V 5 �V W %W FW
OW ' ]W �W % �W �W / �W X X & `X 0 �X . �X ) �X ) Y ;Y RY dY 3 pY ( �Y �Y ) �Y #
Z .Z OZ & jZ K �Z & �Z [ ! "[ ( D[ ' m[ �[ # �[ �[ / �[ (\ I\ # e\ % �\ �\ , �\ $ �\ $ ] $ C] 6 h] �] �] B �] � ^ � �^ A_ $ a_ 3 �_ ' �_ ' �_ +
` + 6` ( b` ( �` # �` - �` � a + �a , b ! /b & Qb ' xb # �b �b " �b 8 c $ ?c dc �c Q �c & �c a d @ ~d 5 �d �d " e # 3e , We �e ! �e # �e * �e # f % 8f 0 ^f & �f $ �f �f " �f = g 1 [g �g �g �g : �g ) �g B )h P lh �h �h �h
i " i =i Wi & ti & �i % �i 2 �i j 0j Lj & lj ! �j ) �j # �j " k &k r 7k < �k D �k N ,l {l �l �l & �l , �l - )m Wm " qm / �m �m �m ( �m @ "n cn �n P �n > �n 1 -o > _o / �o Y �o > (p gp �p " �p �p & �p < q Dq ' Xq ( �q ' �q �q �q r 1 r ) Kr % ur 3 �r �r �r " s ; $s `s os �s �s . �s I �s > =t D |t �t �t �t 7 �t 9 7u 6 qu H �u @ �u 2v 3 Dv & xv 0 �v 6 �v / w ( 7w , `w �w " �w �w �w �w h x T tx � �x 6 Ly L �y J �y 9 z Uz $ dz + �z �z �z �z �z { 2 +{ ^{ " o{ �{ �{ # �{ �{ �{ / | D| & U| || �| # �| �| $ �| ) �| )} ! J} % l} + �} �} & �} ' ~ -~ M~ 0 j~ . �~ ) �~ + �~ < 4 Z � � # � * 6� a� }� �� ( �� " Ҁ E �� # ;� ) _� , �� �� � ; � )� 6� J� ' f� ' �� �� % ւ �� � B 5� 2 x� ! �� 8 ̓ : � A� ]� 3 |� 1 �� 1 � + � $ @� e� $ |� h �� �
� ɇ ه K � U 5� < �� Ȉ � i �� d� j� # |� �� ; �� P �� U K� M �� 2 � \ "� G � = Nj Z � D `� p �� > � ; U� J �� > ܍ A � A ]� P �� 6 � < '� U d� P �� @ � > L� c �� � � 8 �� = ɑ 9 � 5 A� N w� F ƒ B
� { P� ; ̓ v � ; � 8 �� P � ; E� M �� P ϕ F � ; g� = �� ? � A !� < c� 7 �� > ؗ ? � ? W� ; �� \ Ә U 0� @ �� 6 Ǚ 3 �� C 2� / v� 8 �� . ߚ I � O X� P �� J �� 4 D� < y� A �� > �� 6 7� = n� P �� @ �� ? >� G ~� ; ƞ S � , V� ( �� 7 �� A � J &� q� E t� D �� N �� N� g� @ �� # á ' � V � # f� ( �� 9 �� 9 � " '� . J� " y� �� �� / ɣ 1 �� ; +� 6 g� A �� I � H *� @ s� 2 �� � �� 3 � C� . Z� # �� . �� ܦ # �� � P 6� B �� 6 ʧ + � " -� P� g� �� : �� ֨ � + � 4� & T� {� �� - �� ҩ � � 3 p� �� �� \ ɪ P &� w� * �� �� L ǫ Y � $ n� _ �� R � I F� 3 �� 8 ĭ 6 �� ( 4� * ]� + �� ( �� ( ݮ & � ' -� / U� 5 �� " �� 7 ޯ ' � , >� k� - �� - �� ' � * � ! 4� * V� ' �� * �� Q Ա 6 &� b ]� �� ( � 6 � @� ]� }� �� �� �� ! �� � % � : &� # a� # �� ) �� Ӵ �
� � 3� " <� ) _� �� 4 �� % յ �� � " 7� \ Z� " �� ڶ �� � 0� K� i� �� ) �� η � � #� ?� W� u� �� �� / ̸ �� ! � R 1� � �� � 4� غ # �� 2 � M� . f� �� ' �� & � "� <� � Z� ' � ' � D� % d� % �� " �� ӽ � -
� ! ;� ]� {� W �� � d � 1 s� + �� ѿ � ! � 1 .� `� ~� " �� ( �� " � % � / 1� $ a� �� �� & �� 1 � � 4� C� U� ' b� ( �� 5 �� G �� 1� A� [�
q� � �� �� ) �� ) �� ( '� 6 P� �� �� % �� " �� ' � , 3� `� ~�
�� C �� @ �� N .� E }� �� �� �� + � & @� ) g� �� �� & �� �� �� � 6 9� p� �� - �� ? �� + � 5 8� * n� K �� D �� *� F� " ^� �� $ �� < �� � $ � 0 A� + r� �� �� �� , �� 2 � $ >� ( c� �� �� �� 9 �� � 5� , O� |� - �� @ �� 7 � = @�
~� �� �� % �� 7 �� + � V <� 7 �� �� , �� % � / 5� 5 e� / �� & �� 3 �� &� 7� R� $ n� �� l �� 7 � H I� 9 �� I �� : � 4 Q� �� / �� % ��
�� �� � '�
>� I�
j� x� ��
�� �� �� �� , ��
(� 6�
M� [� l� �� " �� �� " �� % � % *� ( P� y� �� �� �� �� ( � ( -� + V� ( �� �� �� �� q �� f� ) �� �� �� �� - �� "� @ =� # ~� �� # �� �� �� � 5 �
S� ^� r� $ �� �� �� # �� � *� = B� % �� �� 4 �� 6 �� -� ! A� , c� ( �� % �� - �� &
� 4� $ Q� 3 v� � � � � � � m � _ � � G � 8 � � E � n p u ! � � � � M � � � � 5 � & � c � a � � � � � ( � ( � � ] � [ � � � j I 0 � � : # � �
V � q W � � N � � � � - & w � � � � � � � F � l � � � � L g T � - 2 � � o D l �
� � � � � 3 � � � � � � � � � | � % � � ? � � � k � r � � � 7 � � I � $ L v � � � � R � 6 � � � A 2 � � 4 � + � j � / � + � � q Y � � i � � 1 v � t � 1 h � � � ! s � � � 4 � n B . � / � : ^ z S ^ i X O a � 0 , � \ � C � � � # � 9 � H � Q = B J Y ~ Z � ~ � � E P = 6 H x � [ R � � z > � c o b w h s � � F ' ? r � * p 9 Z � � � � � f � _
� 5 ; J @ � { � � � g y K { D V � � , ) � � � � � � � S b > � U � � � P N . � ; � � � � � ` � ) � � � � � � | � � t d � O C " m " � G x � � X � \ % � 3 � � � � � � � �
� K � T 7 � ] � � y e � � � f � ' < * � � � � � } � ` } � < � $ W � � � � � Q � � � @ � � A e � d � � U � � � � 8 � u � M � k �
Connection options:
General options:
If -f/--file is not used, then the SQL script will be written to the standard
output.
If no database name is supplied, then the PGDATABASE environment
variable value is used.
If no input file name is supplied, then standard input is used.
Options controlling the output content:
Options controlling the restore:
The options -I, -n, -P, -t, -T, and --section can be combined and specified
multiple times to select multiple objects.
%s
%s [OPTION]...
%s [OPTION]... [DBNAME]
%s [OPTION]... [FILE]
--binary-upgrade for use by upgrade utilities only
--column-inserts dump data as INSERT commands with column names
--disable-dollar-quoting disable dollar quoting, use SQL standard quoting
--disable-triggers disable triggers during data-only restore
--enable-row-security enable row security
--enable-row-security enable row security (dump only content user has
access to)
--exclude-table-data=TABLE do NOT dump data for the named table(s)
--if-exists use IF EXISTS when dropping objects
--inserts dump data as INSERT commands, rather than COPY
--lock-wait-timeout=TIMEOUT fail after waiting TIMEOUT for a table lock
--no-data-for-failed-tables do not restore data of tables that could not be
created
--no-security-labels do not dump security label assignments
--no-security-labels do not restore security labels
--no-synchronized-snapshots do not use synchronized snapshots in parallel jobs
--no-tablespaces do not dump tablespace assignments
--no-tablespaces do not restore tablespace assignments
--no-unlogged-table-data do not dump unlogged table data
--quote-all-identifiers quote all identifiers, even if not key words
--role=ROLENAME do SET ROLE before dump
--role=ROLENAME do SET ROLE before restore
--section=SECTION dump named section (pre-data, data, or post-data)
--section=SECTION restore named section (pre-data, data, or post-data)
--serializable-deferrable wait until the dump can run without anomalies
--snapshot=SNAPSHOT use given snapshot for the dump
--strict-names require table and/or schema include patterns to
match at least one entity each
--use-set-session-authorization
use SET SESSION AUTHORIZATION commands instead of
ALTER OWNER commands to set ownership
-1, --single-transaction restore as a single transaction
-?, --help show this help, then exit
-?, --help show this help, then exit
-C, --create create the target database
-C, --create include commands to create database in dump
-E, --encoding=ENCODING dump the data in encoding ENCODING
-F, --format=c|d|t backup file format (should be automatic)
-F, --format=c|d|t|p output file format (custom, directory, tar,
plain text (default))
-I, --index=NAME restore named index
-L, --use-list=FILENAME use table of contents from this file for
selecting/ordering output
-N, --exclude-schema=SCHEMA do NOT dump the named schema(s)
-O, --no-owner skip restoration of object ownership
-O, --no-owner skip restoration of object ownership in
plain-text format
-P, --function=NAME(args) restore named function
-S, --superuser=NAME superuser user name to use for disabling triggers
-S, --superuser=NAME superuser user name to use in plain-text format
-S, --superuser=NAME superuser user name to use in the dump
-T, --exclude-table=TABLE do NOT dump the named table(s)
-T, --trigger=NAME restore named trigger
-U, --username=NAME connect as specified database user
-V, --version output version information, then exit
-V, --version output version information, then exit
-W, --password force password prompt (should happen automatically)
-Z, --compress=0-9 compression level for compressed formats
-a, --data-only dump only the data, not the schema
-a, --data-only restore only the data, no schema
-b, --blobs include large objects in dump
-c, --clean clean (drop) database objects before recreating
-c, --clean clean (drop) databases before recreating
-d, --dbname=CONNSTR connect using connection string
-d, --dbname=DBNAME database to dump
-d, --dbname=NAME connect to database name
-e, --exit-on-error exit on error, default is to continue
-f, --file=FILENAME output file name
-f, --file=FILENAME output file or directory name
-f, --file=FILENAME output file name
-g, --globals-only dump only global objects, no databases
-h, --host=HOSTNAME database server host or socket directory
-j, --jobs=NUM use this many parallel jobs to dump
-j, --jobs=NUM use this many parallel jobs to restore
-l, --database=DBNAME alternative default database
-l, --list print summarized TOC of the archive
-n, --schema=NAME restore only objects in this schema
-n, --schema=SCHEMA dump the named schema(s) only
-o, --oids include OIDs in dump
-p, --port=PORT database server port number
-r, --roles-only dump only roles, no databases or tablespaces
-s, --schema-only dump only the schema, no data
-s, --schema-only restore only the schema, no data
-t, --table=NAME restore named relation (table, view, etc)
-t, --table=TABLE dump the named table(s) only
-t, --tablespaces-only dump only tablespaces, no databases or roles
-v, --verbose verbose mode
-v, --verbose verbose mode
-w, --no-password never prompt for password
-x, --no-privileges do not dump privileges (grant/revoke)
-x, --no-privileges skip restoration of access privileges (grant/revoke)
%s %s dumps a database as a text file or to other formats.
%s extracts a PostgreSQL database cluster into an SQL script file.
%s restores a PostgreSQL database from an archive created by pg_dump.
%s: %s Command was: %s
%s: WSAStartup failed: %d
%s: cannot specify both --single-transaction and multiple jobs
%s: could not connect to database "%s"
%s: could not connect to database "%s": %s
%s: could not connect to databases "postgres" or "template1"
Please specify an alternative database.
%s: could not get server version
%s: could not open the output file "%s": %s
%s: could not parse ACL list (%s) for database "%s"
%s: could not parse ACL list (%s) for tablespace "%s"
%s: could not parse server version "%s"
%s: could not re-open the output file "%s": %s
%s: dumping database "%s"...
%s: executing %s
%s: invalid number of parallel jobs
%s: maximum number of parallel jobs is %d
%s: option --if-exists requires option -c/--clean
%s: options -c/--clean and -a/--data-only cannot be used together
%s: options -d/--dbname and -f/--file cannot be used together
%s: options -g/--globals-only and -r/--roles-only cannot be used together
%s: options -g/--globals-only and -t/--tablespaces-only cannot be used together
%s: options -r/--roles-only and -t/--tablespaces-only cannot be used together
%s: options -s/--schema-only and -a/--data-only cannot be used together
%s: pg_dump failed on database "%s", exiting
%s: query failed: %s %s: query was: %s
%s: role name starting with 'pg_' skipped (%s)
%s: running "%s"
%s: too many command-line arguments (first is "%s")
%s: unrecognized section name: "%s"
(The INSERT command cannot set OIDs.)
(The system catalogs might be corrupted.)
-C and -1 are incompatible options
COPY failed for table "%s": %s Consider using a full dump instead of a --data-only dump to avoid this problem.
Dumping the contents of table "%s" failed: PQgetCopyData() failed.
Dumping the contents of table "%s" failed: PQgetResult() failed.
Error from TOC entry %d; %u %u %s %s %s
Error message from server: %s Error while FINALIZING:
Error while INITIALIZING:
Error while PROCESSING TOC:
Exported snapshots are not supported by this server version.
Function "%s" not found.
Index "%s" not found.
NOTICE: there are circular foreign-key constraints on this table:
NOTICE: there are circular foreign-key constraints among these tables:
No matching schemas were found
No matching table(s) were found for pattern "%s"
No matching tables were found
Password: Report bugs to <pgsql-bugs@postgresql.org>.
Schema "%s" not found.
Synchronized snapshots are not supported by this server version.
Run with --no-synchronized-snapshots instead if you do not need
synchronized snapshots.
TOC Entry %s at %s (length %s, checksum %d)
Table "%s" not found.
The command was: %s
The program "pg_dump" is needed by %s but was not found in the
same directory as "%s".
Check your installation.
The program "pg_dump" was found by "%s"
but was not the same version as %s.
Check your installation.
Trigger "%s" not found.
Try "%s --help" for more information.
Usage:
WARNING: aggregate function %s could not be dumped correctly for this database version; ignored
WARNING: archive is compressed, but this installation does not support compression -- no data will be available
WARNING: archive items not in correct section order
WARNING: archive was made on a machine with larger integers, some operations might fail
WARNING: bogus transform definition, at least one of trffromsql and trftosql should be nonzero
WARNING: bogus value in pg_cast.castfunc or pg_cast.castmethod field
WARNING: bogus value in pg_cast.castmethod field
WARNING: bogus value in pg_transform.trffromsql field
WARNING: bogus value in pg_transform.trftosql field
WARNING: bogus value in proargmodes array
WARNING: could not find operator with OID %s
WARNING: could not parse proallargtypes array
WARNING: could not parse proargmodes array
WARNING: could not parse proargnames array
WARNING: could not parse proconfig array
WARNING: could not parse reloptions array
WARNING: could not resolve dependency loop among these items:
WARNING: don't know how to set owner for object type %s
WARNING: errors ignored on restore: %d
WARNING: ftell mismatch with expected position -- ftell used
WARNING: invalid creation date in header
WARNING: invalid type %c of access method %s
WARNING: line ignored: %s
WARNING: owner of aggregate function "%s" appears to be invalid
WARNING: owner of data type "%s" appears to be invalid
WARNING: owner of function "%s" appears to be invalid
WARNING: owner of operator "%s" appears to be invalid
WARNING: owner of operator class "%s" appears to be invalid
WARNING: owner of operator family "%s" appears to be invalid
WARNING: owner of schema "%s" appears to be invalid
WARNING: owner of table "%s" appears to be invalid
WARNING: requested compression not available in this installation -- archive will be uncompressed
WARNING: typtype of data type "%s" appears to be invalid
You might not be able to restore the dump without using --disable-triggers or temporarily dropping the constraints.
a worker process died unexpectedly
aborting because of server version mismatch
actual file length (%s) does not match expected (%s)
allocating AH for %s, format %d
already connected to a database
archiver archiver (db) attempting to ascertain archive format
bad dumpId
bad table dumpId for TABLE DATA item
can only reopen input archives
cannot duplicate null pointer (internal error)
cannot restore from compressed archive (compression not supported in this installation)
child process exited with exit code %d child process exited with unrecognized status %d child process was terminated by exception 0x%X child process was terminated by signal %d child process was terminated by signal %s command not executable command not found compress_io compression is not supported by tar archive format
compression level must be in range 0..9
compressor active
connecting to database "%s" as user "%s"
connecting to database for restore
connecting to new database "%s"
connection needs password
connection to database "%s" failed: %s corrupt tar header found in %s (expected %d, computed %d) file position %s
could not change directory to "%s": %s could not close TOC file: %s
could not close archive file: %s
could not close compression library: %s
could not close compression stream: %s
could not close data file: %s
could not close directory "%s": %s
could not close input file: %s
could not close large object TOC file "%s": %s
could not close output file: %s
could not close tar member
could not close temporary file: %s
could not commit database transaction could not compress data: %s
could not create communication channels: %s
could not create directory "%s": %s
could not create large object %u: %s could not create worker process: %s
could not determine seek position in archive file: %s
could not execute query could not find a "%s" to execute could not find block ID %d in archive -- possibly corrupt archive
could not find block ID %d in archive -- possibly due to out-of-order restore request, which cannot be handled due to lack of data offsets in archive
could not find block ID %d in archive -- possibly due to out-of-order restore request, which cannot be handled due to non-seekable input file
could not find entry for ID %d
could not find file "%s" in archive
could not find header for file "%s" in tar archive
could not find parent extension for %s
could not find slot of finished worker
could not generate temporary file name: %s
could not get relation name for OID %u: %s
could not get server_version from libpq
could not identify current directory: %s could not identify dependency loop
could not initialize compression library: %s
could not obtain lock on relation "%s"
This usually means that someone requested an ACCESS EXCLUSIVE lock on the table after the pg_dump parent process had gotten the initial ACCESS SHARE lock on the table.
could not open TOC file "%s" for input: %s
could not open TOC file "%s" for output: %s
could not open TOC file "%s": %s
could not open TOC file for input: %s
could not open TOC file for output: %s
could not open input file "%s": %s
could not open input file: %s
could not open large object %u: %s could not open large object TOC file "%s" for input: %s
could not open output file "%s": %s
could not open output file: %s
could not open temporary file
could not parse GRANT ACL list (%s) or REVOKE ACL list (%s) for object "%s" (%s)
could not parse default ACL list (%s)
could not parse initial GRANT ACL list (%s) or initial REVOKE ACL list (%s) for object "%s" (%s)
could not parse numeric array "%s": invalid character in number
could not parse numeric array "%s": too many numbers
could not read binary "%s" could not read directory "%s": %s
could not read from input file: %s
could not read from input file: end of file
could not read input file: %s
could not read symbolic link "%s" could not reconnect to database: %s could not set default_tablespace to %s: %s could not set default_with_oids: %s could not set search_path to "%s": %s could not set seek position in archive file: %s
could not set session user to "%s": %s could not start database transaction could not uncompress data: %s
could not write to blobs TOC file
could not write to large object (result: %lu, expected: %lu)
could not write to the communication channel: %s
creating %s "%s"
creating %s "%s.%s"
custom archiver definition of view "%s" appears to be empty (length zero)
did not find magic string in file header
direct database connections are not supported in pre-1.3 archives
directory "%s" does not appear to be a valid archive ("toc.dat" does not exist)
directory archiver directory name too long: "%s"
disabling triggers for %s
dropping %s %s
dumping contents of table "%s.%s"
enabling triggers for %s
entering main parallel loop
entering restore_toc_entries_parallel
entering restore_toc_entries_postfork
entering restore_toc_entries_prefork
entry ID %d out of range -- perhaps a corrupt TOC
error during backup
error during file seek: %s
error in ListenToWorkers(): %s
error processing a parallel work item
error reading large object %u: %s error reading large object TOC file "%s"
error returned by PQputCopyData: %s error returned by PQputCopyEnd: %s executing %s %s
expected %d check constraint on table "%s" but found %d
expected %d check constraints on table "%s" but found %d
expected format (%d) differs from format found in file (%d)
failed sanity check, parent OID %u of table "%s" (OID %u) not found
failed sanity check, parent table OID %u of pg_rewrite entry OID %u not found
failed to connect to database
failed to reconnect to database
file name too long: "%s"
file offset in dump file is too large
finding check constraints for table "%s.%s"
finding default expressions of table "%s.%s"
finding extension tables
finding inheritance relationships
finding the columns and types of table "%s.%s"
finished item %d %s %s
finished main parallel loop
flagging inherited columns in subtables
found unexpected block ID (%d) when reading data -- expected %d
identifying extension members
implied data-only restore
incomplete tar header found (%lu byte)
incomplete tar header found (%lu bytes)
input file appears to be a text format dump. Please use psql.
input file does not appear to be a valid archive
input file does not appear to be a valid archive (too short?)
input file is too short (read %lu, expected 5)
internal error -- WriteData cannot be called outside the context of a DataDumper routine
internal error -- neither th nor fh specified in tarReadRaw()
invalid ENCODING item: %s
invalid OID for large object
invalid OID for large object (%u)
invalid STDSTRINGS item: %s
invalid adnum value %d for table "%s"
invalid argument string (%s) for trigger "%s" on table "%s"
invalid binary "%s" invalid client encoding "%s" specified
invalid column number %d for table "%s"
invalid column numbering in table "%s"
invalid compression code: %d
invalid dependency %d
invalid dumpId %d
invalid line in large object TOC file "%s": "%s"
invalid message received from worker: %s
invalid output format "%s" specified
large-object output not supported in chosen format
last built-in OID is %u
launching item %d %s %s
missing index for constraint "%s"
moving from position %s to next member at file position %s
no item ready
no output directory specified
not built with zlib support
now at file position %s
option --if-exists requires option -c/--clean
options --inserts/--column-inserts and -o/--oids cannot be used together
options -c/--clean and -a/--data-only cannot be used together
options -s/--schema-only and -a/--data-only cannot be used together
out of memory
out of on_exit_nicely slots
parallel archiver parallel backup only supported by the directory format
parallel restore from non-seekable file is not supported
parallel restore from standard input is not supported
parallel restore is not supported with archives made by pre-8.0 pg_dump
parallel restore is not supported with this archive file format
pclose failed: %s pgpipe: could not accept connection: error code %d
pgpipe: could not bind: error code %d
pgpipe: could not connect socket: error code %d
pgpipe: could not create second socket: error code %d
pgpipe: could not create socket: error code %d
pgpipe: could not listen: error code %d
pgpipe: getsockname() failed: error code %d
processing %s
processing data for table "%s.%s"
processing item %d %s %s
processing missed item %d %s %s
query failed: %s query produced null referenced table name for foreign key trigger "%s" on table "%s" (OID of table: %u)
query returned %d row instead of one: %s
query returned %d rows instead of one: %s
query to get data of sequence "%s" returned %d row (expected 1)
query to get data of sequence "%s" returned %d rows (expected 1)
query to get data of sequence "%s" returned name "%s"
query to get rule "%s" for table "%s" failed: wrong number of rows returned
query to obtain definition of view "%s" returned more than one definition
query to obtain definition of view "%s" returned no data
query was: %s
read TOC entry %d (ID %d) for %s %s
reading column info for interesting tables
reading constraints
reading default privileges
reading dependency data
reading event triggers
reading extensions
reading foreign key constraints for table "%s.%s"
reading indexes
reading indexes for table "%s.%s"
reading large objects
reading policies
reading policies for table "%s.%s"
reading procedural languages
reading rewrite rules
reading row security enabled for table "%s.%s"
reading schemas
reading table inheritance information
reading transforms
reading triggers
reading triggers for table "%s.%s"
reading type casts
reading user-defined access methods
reading user-defined aggregate functions
reading user-defined collations
reading user-defined conversions
reading user-defined foreign servers
reading user-defined foreign-data wrappers
reading user-defined functions
reading user-defined operator classes
reading user-defined operator families
reading user-defined operators
reading user-defined tables
reading user-defined text search configurations
reading user-defined text search dictionaries
reading user-defined text search parsers
reading user-defined text search templates
reading user-defined types
reducing dependencies for %d
restored %d large object
restored %d large objects
restoring data out of order is not supported in this archive format: "%s" is required, but comes before "%s" in the archive file.
restoring large object with OID %u
sanity check on integer size (%lu) failed
saving database definition
saving encoding = %s
saving large objects
saving standard_conforming_strings = %s
schema with OID %u does not exist
server version must be at least 7.3 to use schema selection switches
server version: %s; %s version: %s
setting owner and privileges for %s "%s"
setting owner and privileges for %s "%s.%s"
skipping item %d %s %s
skipping tar member %s
sorter table "%s" could not be created, will not restore its data
tar archiver terminated by user
this format cannot be read
transferring dependency %d -> %d to %d
unexpected COPY statement syntax: "%s"
unexpected data offset flag %d
unexpected policy command type: "%s"
unexpected section code %d
unexpected tgtype value: %d
unrecognized archive format "%s"; please specify "c", "d", or "t"
unrecognized command on communication channel: %s
unrecognized constraint type: %c
unrecognized data block type %d while restoring archive
unrecognized data block type (%d) while searching archive
unrecognized encoding "%s"
unrecognized file format "%d"
unrecognized object type in default privileges: %d
unrecognized proparallel value for function "%s"
unrecognized provolatile value for function "%s"
unsupported version (%d.%d) in file header
warning from original dump file: %s
worker is terminating
worker process failed: exit code %d
wrote %lu byte of large object data (result = %lu)
wrote %lu bytes of large object data (result = %lu)
Project-Id-Version: pg_dump (PostgreSQL 9.0)
Report-Msgid-Bugs-To: pgsql-bugs@postgresql.org
POT-Creation-Date: 2016-04-18 04:44+0000
PO-Revision-Date: 2016-05-19 20:40+0800
Last-Translator: Yuwei Peng <ywpeng@whu.edu.cn>
Language-Team: Chinese (Simplified) <ywpeng@whu.edu.cn>
Language: zh_CN
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Plural-Forms: nplurals=1; plural=0;
X-Generator: Poedit 1.5.7
联接选项:
一般选项:
如果没有使用 -f/--file，那么将把SQL脚本写到标准输出
.
如果没有提供数据库名字, 那么使用 PGDATABASE 环境变量
的数值.
如果没有提供输入文件名, 则使用标准输入.
控制输出内容选项:
恢复控制选项:
选项 -I, -n, -P, -t, -T, 以及 --section 可以组合使用和指定
多次用于选择多个对象.
%s
%s [选项]...
%s [选项]... [数据库名字]
%s [选项]... [文件名]
--binary-upgrade 只能由升级工具使用
--column-inserts 以带有列名的INSERT命令形式转储数据
--disable-dollar-quoting 取消美元 (符号) 引号, 使用 SQL 标准引号
--disable-triggers 在只恢复数据的过程中禁用触发器
--enable-row-security 启用行安全性
--enable-row-security 启用行安全性（只转储用户能够访问的内容）
--exclude-table-data=TABLE 不转储指定名称的表中的数据
--if-exists 当删除对象时使用IF EXISTS
--inserts 以INSERT命令，而不是COPY命令的形式转储数据
--lock-wait-timeout=TIMEOUT 在等待表锁超时后操作失败
--no-data-for-failed-tables 对那些无法创建的表不进行
数据恢复
--no-security-labels 不转储安全标签的分配
--no-security-labels 不恢复安全标签信息
--no-synchronized-snapshots 在并行工作集中不使用同步快照
--no-tablespaces 不转储表空间分配信息
--no-tablespaces 不恢复表空间的分配信息
--no-unlogged-table-data 不转储没有日志的表数据
--quote-all-identifiers 所有标识符加引号，即使不是关键字
--role=ROLENAME 在转储前运行SET ROLE
--role=ROLENAME 在恢复前执行SET ROLE操作
--section=SECTION 备份命名的节 (数据前, 数据, 及 数据后)
--section=SECTION 恢复命名节 (数据前、数据及数据后)
--serializable-deferrable 等到备份可以无异常运行
--snapshot=SNAPSHOT 为转储使用给定的快照
--strict-names 要求每个表和/或schema包括模式以匹配至少一个实体
--use-set-session-authorization
使用 SESSION AUTHORIZATION 命令代替
ALTER OWNER 命令来设置所有权
-1, --single-transaction 作为单个事务恢复
-?, --help 显示此帮助, 然后退出
-?, --help 显示此帮助, 然后退出
-C, --create 创建目标数据库
-C, --create 在转储中包括命令,以便创建数据库
-E, --encoding=ENCODING 转储以ENCODING形式编码的数据
-F, --format=c|d|t 备份文件格式(应该自动进行)
-F, --format=c|d|t|p 输出文件格式 (定制, 目录, tar)
明文 (默认值))
-I, --index=NAME 恢复指定名称的索引
-L, --use-list=FILENAME 从这个文件中使用指定的内容表排序
输出
-N, --exclude-schema=SCHEMA 不转储已命名的模式
-O, --no-owner 不恢复对象所属者
-O, --no-owner 在明文格式中, 忽略恢复对象所属者
-P, --function=NAME(args) 恢复指定名字的函数
-S, --superuser=NAME 使用指定的超级用户来禁用触发器
-S, --superuser=NAME 在明文格式中使用指定的超级用户名
-S, --superuser=NAME 在转储中, 指定的超级用户名
-T, --exclude-table=TABLE 不转储指定名称的表
-T, --trigger=NAME 恢复指定名字的触发器
-U, --username=名字 以指定的数据库用户联接
-V, --version 输出版本信息，然后退出
-V, --version 输出版本信息, 然后退出
-W, --password 强制口令提示 (自动)
-Z, --compress=0-9 被压缩格式的压缩级别
-a, --data-only 只转储数据,不包括模式
-a, --data-only 只恢复数据, 不包括模式
-b, --blobs 在转储中包括大对象
-c, --clean 在重新创建之前，先清除（删除）数据库对象
-c, --clean 在重新创建数据库前先清除(删除)数据库
-d, --dbname=CONNSTR 连接数据库使用的连接串
-d, --dbname=DBNAME 对数据库 DBNAME备份
-d, --dbname=名字 连接数据库名字
-e, --exit-on-error 发生错误退出, 默认为继续
-f, --file=FILENAME 输出文件名
-f, --file=FILENAME 输出文件或目录名
-f, --file=文件名 输出文件名
-g, --globals-only 只转储全局对象, 不包括数据库
-h, --host=主机名 数据库服务器的主机名或套接字目录
-j, --jobs=NUM 执行多个并行任务进行备份转储工作
-j, --jobs=NUM 执行多个并行任务进行恢复工作
-l, --database=DBNAME 另一个缺省数据库
-l, --list 打印归档文件的 TOC 概述
-n, --schema=NAME 在这个模式中只恢复对象
-n, --schema=SCHEMA 只转储指定名称的模式
-o, --oids 在转储中包括 OID
-p, --port=端口号 数据库服务器的端口号
-r, --roles-only 只转储角色，不包括数据库或表空间
-s, --schema-only 只转储模式, 不包括数据
-s, --schema-only 只恢复模式, 不包括数据
-t, --table=NAME 恢复命名关系（表、视图等）
-t, --table=TABLE 只转储指定名称的表
-t, --tablespaces-only 只转储表空间，而不转储数据库或角色
-v, --verbose 详细模式
-v, --verbose 详细模式
-w, --no-password 永远不提示输入口令
-x, --no-privileges 不要转储权限 (grant/revoke)
-x, --no-privileges 跳过处理权限的恢复 (grant/revoke)
%s %s 把一个数据库转储为纯文本文件或者是其它格式.
%s 抽取一个 PostgreSQL 数据库簇进一个 SQL 脚本文件.
%s 从一个归档中恢复一个由 pg_dump 创建的 PostgreSQL 数据库.
%s: %s 命令是: %s
%s: WSAStartup 失败: %d
%s: 不能同时指定选项--single-transaction和多个任务
%s: 无法与数据库 "%s" 联接
%s: 无法与数据库 "%s" 联接: %s
%s: 无法连接到数据库 "postgres"或"template1"
请指定另外一个数据库.
%s: 无法从服务器获取版本
%s：无法打开输出文件 "%s"：%s
%1$s: 无法为数据库 "%3$s" 分析 ACL 列表 (%2$s)
%1$s: 无法为表空间 "%3$s" 分析 ACL 列表 (%2$s)
%s: 无法分析版本字串 "%s"
%s：无法重新打开输出文件 "%s"：%s
%s: 正在转储数据库 "%s"...
%s: 执行 %s
%s: 无效的并行工作数
%s: 已经达到并行工作集的最大数 %d
%s: 选项 --if-exists 需要选项 -c/ --clean
%s: 选项 -c/--clean和 -a/--data-only不能同时使用.
%s: 选项 -d/--dbname和-f/--file不能同时使用.
%s: 选项-g/--globals-only和-r/--roles-only不能同时使用.
%s: 选项 -g/--globals-only和-t/--tablespaces-only不能同时使用.
%s: 选项 -r/--roles-only和 -t/--tablespaces-only不能同时使用.
%s: 选项 -s/--schema-only和-a/--data-only 不能同时使用
%s: pg_dump 失败在数据库 "%s", 正在退出
%s: 查询失败: %s %s: 查询是: %s
%s: 以'pg_'开始的角色名称已被跳过 (%s)
%s: 正在运行 "%s"
%s: 命令行参数太多 (第一个是 "%s")
%s: 无法识别的节名称: "%s"
(INSERT 命令无法设置对象标识(oid).)
(系统表可能损坏了.)
-C 和 -c 是互不兼容的选项
复制表 "%s"失败: %s 考虑使用完全备份代替 --data-only选项进行备份以避免此问题.
转储表 "%s" 的内容的 SQL 命令失败: PQendcopy() 失败.
转储表 "%s" 的内容失败: PQgetResult() 失败.
错误来自 TOC 记录 %d; %u %u %s %s %s
来自服务器的错误信息: %s FINALIZING 时错误:
INITIALIZING 时错误:
PROCESSING TOC 时错误:
在这个版本的服务器中不支持导出的快照。
函数"%s"没有找到.
索引"%s"没有找到.
注意：表上存在循环外键约束：
没有找到符合的关联。
没有为"%s"模式找到匹配的表
没有找到符合的关联。
口令: 报告错误至 <pgsql-bugs@postgresql.org>.
模式"%s"没有找到.
当前服务器版本不支持同步快照.
如果不需要同步快照功能，
可以带参数 --no-synchronized-snapshots运行.
TOC项%s位于%s（长度为%s，校验和为%d）
表"%s"没有找到.
命令是: %s
%s 需要程序 "pg_dump", 但是在同一个目录 "%s" 没有找到.
检查您的安装.
%s 找到程序 "pg_dump", 但是和版本 "%s" 不一致.
检查您的安装.
触发器"%s"没有找到.
输入 "%s --help" 获取更多的信息.
用法:
警告: 无法为此版本的数据库正确转储聚集函数 "%s"; 忽略
警告: 归档是压缩过的, 但是当前安装不支持压缩 - 数据将不可使用
警告: 归档项的序号不正确
警告: 归档不是在支持更大范围整数的主机上产生的, 有些操作可能失败
警告：臆造的转换定义，至少trffromsql和trftosql之一应该为非零
警告: 在pg_cast.castfunc或者pg_cast.castmethod字段中的是假值
警告: 在pg_cast.castmethod字段中的是假值
警告: 在pg_transform.trffromsql域中的是臆造值
警告: 在pg_transform.trftosql域中的是臆造值
警告: 无法分析 proargmodes 数组
警告: 未找到 OID 为 %s 的操作符
警告: 无法分析 proallargtypes 数组
警告: 无法分析 proargmodes 数组
警告: 无法分析 proargnames 数组
警告: 无法解析 proconfig 数组
警告: 无法解析 reloptions 数组
WARNING: 无法解析这些项的循环依赖:
警告: 不知道如何为对象类型%s设置属主
警告: 恢复中忽略错误: %d
警告: ftell 和预期位置不匹配 -- 使用 ftell
警告: 在头中的创建日期无效
警告: 访问方法%2$s的类型%1$c无效
警告: 忽略的行: %s
警告: 聚集函数 "%s" 的所有者非法
警告: 数据类型 "%s" 的所有者非法
警告: 函数 "%s" 的所有者非法
警告: 操作符 "%s" 的所有者非法
警告: 操作符表 "%s" 无效
警告: 操作符 "%s" 的所有者无效
警告: 模式 "%s" 的所有者非法
警告: 数据表 "%s" 的所有者非法
警告: 所要求的压缩无法在本次安装中获取 - 归档将不被压缩
警告: 数据类型 "%s" 的所有者看起来无效
不使用 --disable-triggers 选项或者临时删除约束，你将不能对备份进行恢复 .
一工作者进程意外退出
因为服务器版本不匹配而终止
实际文件长度 (%s) 不匹配预期的长度 (%s)
为 %s 分配 AH, 格式 %d
已经与一个数据库联接
归档 归档 (db) 试图确认归档格式
错误的dumpId号
TABLE DATA 项的表dumpId错误
只能重新打开输入归档
无法复制空指针 (内部错误)
无法从压缩的归档中恢复 (未配置压缩支持)
子进程已退出, 退出码为 %d 子进程已退出, 未知状态 %d 子进程被例外(exception) 0x%X 终止 子进程被信号 %d 终止 子进程被信号 %s 终止 命令无法执行 命令没有找到 压缩IO 不支持tar归档格式的压缩
压缩级别必须位于0..9的范围内
压缩程序已激活
以用户 "%2$s" 的身份联接到数据库 "%1$s"
为恢复数据库与数据库联接
联接到新数据库 "%s"
在连接时需要输入口令
与数据库 "%s" 联接失败: %s 在文件 %1$s 的位置 %4$s 发现崩溃的 tar 头(预计在 %2$d, 计算出来在 %3$d)
无法跳转到目录 "%s" 中: %s 无法关闭 TOC 文件: %s
无法关闭归档文件: %s
无法关闭压缩库: %s
无法关闭压缩流: %s
无法关闭数据文件: %s
无法关闭目录 "%s": %s
无法关闭输入文件: %s
无法关闭大对象 TOC 文件"%s": %s
无法关闭输出文件: %s
无法关闭 tar 成员
无法关闭临时文件: %s
无法提交数据库事务 无法压缩数据: %s
无法创建通信通道: %s
无法创建目录 "%s": %s
无法创建大对象%u: %s 无法创建工作进程: %s
无法在归档文件中确定查找位置: %s
无法执行查询 未能找到一个 "%s" 来执行 无法在归档中找到ID为%d的数据块--这可能是因为归档文件损坏
在归档中无法找到数据块ID %d -- 这可能是由于不正常的恢复引起的，这种不正常的恢复通常因为在归档中缺少数据偏移量而无法处理
在归档中无法找到数据块ID %d -- 这可能是由于不正常的恢复引起的，这种不正常的恢复通常因为缺少的输入文件而无法处理
无法为 ID %d 找到记录
无法在归档中找到文件"%s"
无法在tar归档中为文件"%s"找到标题头
无法找到父扩展%s
无法找到已完成的工作进程的位置
无法生成临时文件名: %s
无法获取OID值为%u:%s的关系名
无法从 libpq 获取服务器版本
无法确认当前目录: %s 无法标识循环依赖
无法初始化压缩库: %s
无法获取关系 "%s"上的锁
这通常意味着在父进程pg_dump已经得到表的共享访问锁之后，仍有人请求该表的排它访问锁.
无法为输入打开TOC文件"%s": %s
无法为输出打开TOC文件"%s": %s
无法打开TOC文件 "%s": %s
无法为输入打开 TOC 文件: %s
无法为输出打开 TOC 文件: %s
无法打开输入文件 "%s": %s
无法打开输入文件: %s
无法打开大对象%u: %s 无法为输入: %s打开大对象文件"%s"
无法打开输出文件"%s": %s
无法打开输出文件: %s
无法打开临时文件
无法为对象"%3$s" (%4$s)解析GRANT ACL列表 (%1$s) 或者REVOKE ACL列表 (%2$s)
无法解析缺省ACL列表(%s)
无法为对象"%3$s" (%4$s)解析初始GRANT ACL列表 (%1$s) 或者初始REVOKE ACL列表 (%2$s)
无法分析数值数组"%s": 出现无效字符
无法分析数值数组"%s": 数字太多
无法读取二进制码 "%s" 无法读取目录 "%s": %s
无法从输入档案读取：%s
无法从输入文件中读取：文件的结尾
无法读取输入文件: %s
无法读取符号链结 "%s" 无法与数据库重新联接: %s 无法设置default_tablespace为 %s: %s 无法设置 default_with_oids: %s 无法设置search_path值为"%s": %s 无法在归档文件中设置查找位置: %s
无法设置会话用户为 "%s": %s 无法开始数据库事务 无法解压缩数据: %s
无法写入BLOB到大对象TOC文件
无法写入大对象 (结果: %lu, 预期: %lu)
无法写入通信通道: %s
创建%s "%s"
创建%s "%s.%s"
客户归档 视图 "%s" 的定义是空的(零长)
在文件头中没有找到魔术字串
1.3 以前的归档里不支持直接数据库联接
目录 "%s" 看上去不像一个有效的归档 ("toc.dat" 不存在)
目录归档器 字典名字太长: "%s"
为%s禁用触发器
删除 %s %s
正在转储表"%s.%s"的内容
为%s启用触发器
正在进入主并行循环
正在进入restore_toc_entries_parallel
正在进入restore_toc_entries_postfork
正在进入restore_toc_entries_prefork
记录 ID %d 超出范围 - 可能是损坏了的 TOC
在备份过程中出错
在文件内定位时出错: %s
调用ListenToWorkers()时出错: %s
错误处理一个并行工作项
在读取大对象时发生错误%u: %s 在读取大对象文件"%s"时发生错误
PQputCopyData返回错误: %s PQputCopyEnd返回错误: %s 执行 %s %s
在表"%2$s"上期望有%1$d个检查约束,但是找到了%3$d个
预期的格式 (%d) 和在文件里找到的格式 (%d) 不同
健全检查失败, 未找到表 "%2$s" (OID %3$u) 的 OID 为 %1$u 的父辈
健全检查失败,pg_rewrite项OID %2$u 的源表 OID%1$u 未找到
与数据库联接失败
与数据库重新联接失败
文件名超长: "%s"
在转储文件中的文件偏移量太大
正在查找表"%s.%s"的检查约束
正在查找表"%s.%s"的默认表达式
查找扩展表
正在查找关系继承
正在查找表"%s.%s"的列和类型
已完成的成员%d %s %s
已完成主并行循环
在子表里标记继承字段
读取数据时发现意外块 ID (%d) - 预期是 %d
识别扩展成员
隐含的只恢复数据
找到未完成的tar文件头(%lu个字节)
输入文件看起来像是文本格式的dump. 请使用psql.
输入文件看上去不象有效的归档
输入文件看上去不象有效的归档 (太短?)
输入文件太短 (读了 %lu, 预期 5)
内部错误 -- WriteData 不能在 DataDumper 过程的环境之外调用
内部错误 -- 在 tarReadRaw() 里既未声明 th 也未声明 fh
无效的ENCODING成员:%s
大对象的无效 OID
用于大对象的非法 OID (%u)
无效的STDSTRINGS成员:%s
表 "%2$s" 的无效 adnum 值 %1$d
给表 "%3$s" 上的触发器 "%2$s" 的错误参数 (%1$s)
无效的二进制码 "%s" 声明了无效的输出格式 "%s"
对于表 "%2$s" 字段个数 %1$d 是无效的
在表 "%s" 中的字段个数是无效的
无效的压缩码: %d
无效的依赖 %d
无效的dumpId %d
无效行存在于大对象文件"%s": "%s"
接收到来自工作者进程的无效消息: %s
声明了非法的输出格式 "%s"
选定的格式不支持大对象输出
最后的内置 OID 是 %u
正在启动成员%d %s %s
对于约束 "%s" 缺少索引
从位置 %s 移动到文件位置 %s 的下一个成员
没有成员准备好
没有指定输出目录
没有编译成带有zlib库支持的版本
现在在文件的位置 %s
选项 --if-exists 需要选项 -c/ --clean
选项--inserts/--column-inserts和-o/--oids不能同时使用.
选项 -c/--clean和 -a/--data-only不能同时使用.
选项 -s/--schema-only和-a/--data-only 不能同时使用.
内存用尽
超出on_exit_nicely槽
并行归档 并行备份只被目录格式支持
不支持从不可随机寻址的文件里并行恢复
不支持从标准输入进行并行恢复
不支持使用8.0版本以前的pg_dump命令产生的存档文件进行并行恢复
不支持以这种归档文件格式进行并行恢复
pclose调用失败: %s pgpipe: 无法接受连接: 错误码为 %d
pgpipe: 无法绑定: 错误码为%d
pgpipe: 无法连接套接字: 错误码为 %d
pgpipe: 无法创建继承套接字: 错误码为 %d
pgpipe: 无法创建套接字: 错误码为 %d
pgpipe: 无法监听: 错误码为 %d
pgpipe: getsockname()调用失败: 错误码为 %d
正在处理 %s
为表"%s.%s"处理数据
正在处理成员%d %s %s
正在处理丢失的成员%d %s %s
查询失败: %s 对在表 "%2$s" 上的外键触发器 "%1$s" 上的查询生成了 NULL 个引用表(表的 OID 是: %3$u)
查询返回了%d条记录，而不是一条记录: %s
查询得到了序列"%s"的数据，返回了%d条记录(期望一条)
获取序列 "%s" 的数据的查询返回了名字 "%s"
获取表 "%2$s" 的规则 "%1$s" 查询失败: 返回了错误的行数
获取视图 "%s" 定义的查询返回超过一个定义
获取视图 "%s" 定义的查询没有返回数据
查询是: %s
为 %3$s %4$s 读取 TOC 记录 %1$d (ID %2$d)
正在读取感兴趣表的列信息
读取约束
正在读取缺省权限
读取从属数据
读取事件触发器
读扩展
为表"%s.%s"读取外键约束
读取索引
为表"%s.%s"读取索引
正在读取大对象
读取策略
为表"%s.%s"读取策略
读取过程语言
读取重写规则
为表"%s.%s"读取行安全性启用状态
读取模式
读取表继承信息
读取转换
读取触发器
为表"%s.%s"读取触发器
读取类型转换
读取用户定义的访问方法
读取用户定义聚集函数
读取用户定义的校对函数
读取用户定义的字符集转换
读取用户定义的外部服务器
读取用户定义外部数据封装器
读取用户定义函数
读取用户定义操作符集
读取用户定义操作符
读取用户定义操作符
读取用户定义表
读取用户定义的文本搜索配置
读取用户定义的文本搜索字典
读取用户定义的文本搜索解析器
读取用户定义的文本搜索模板
读取用户定义类型
为%d减少依赖关系
恢复%d个大对象
这个归档格式里不支持不按照顺序转储数据: 要求"%s" ,但它在归档文件里位于"%s"前面.
恢复带有OID %u 的大对象
整数尺寸 (%lu) 的健全检查失败
保存数据库定义
正在保存encoding = %s
保存大对象
正在保存standard_conforming_strings = %s
OID %u 的模式不存在
服务器版本必须至少是7.3才能使用模式选择转换
服务器版本: %s; %s 版本: %s
为%s "%s"设置属主和权限
为%s "%s.%s"设置属主和权限
忽略成员%d %s %s
忽略 tar 成员 %s
排序器 无法创建表"%s" , 这样无法恢复它的数据
tar 归档 已被用户终止
无法读取这个格式
传输依赖关系从%d -> %d 到%d
意外的COPY语句语法: "%s"
意外的数据偏移标志 %d
意外的策略命令类型："%s"
意外的节码 %d
意外的tgtype值: %d
不可识别的归档格式"%s"; 请指定 "c", "d", 或 "t"
无法识别通信通上的命令:%s
未知的约束类型: %c
恢复归档时碰到不识别的数据块类型 %d
搜索归档是碰到不识别的数据块类型 (%d)
未知编码: "%s"
不可识别的文件格式 "%d"
缺省权限中存在未知对象类型: %d
函数"%s"的proparallel值无法识别
函数 "%s" 的意外正向易失值
在文件头中有不支持的版本 (%d.%d)
来自原始转储文件的警告: %s
工作者进程正在终止
子进程已退出, 退出码为 %d
已经写入了大对象的%lu字节(结果 = %lu)
locale/zh_CN/LC_MESSAGES/pg_config-9.6.mo 0000644 00000013075 14751153421 0013404 0 ustar 00 �� * l ; � � E � 0 � : 3 E n I � L � s K K � = B I i � G � J > M � M � ? % G e > � 6 � < # > ` F � P � I 7
4 �
2 �
* �
. , 8 & e � & � � ( � ! B
V d � v ( �
/ " R 7 d G � H � D - b r C � 0 ; J _ � @ � J ' E r F � @ � G @ C � 5 � ; C > : � E � I 8 M 3 � � � � - � * % P " _ ! � � � � �
& % * $
" '
& ) ( ! #
%s provides information about the installed version of PostgreSQL.
With no arguments, all known items are shown.
%s [OPTION]...
--bindir show location of user executables
--cc show CC value used when PostgreSQL was built
--cflags show CFLAGS value used when PostgreSQL was built
--cflags_sl show CFLAGS_SL value used when PostgreSQL was built
--configure show options given to "configure" script when
PostgreSQL was built
--cppflags show CPPFLAGS value used when PostgreSQL was built
--docdir show location of documentation files
--htmldir show location of HTML documentation files
--includedir show location of C header files of the client
interfaces
--includedir-server show location of C header files for the server
--ldflags show LDFLAGS value used when PostgreSQL was built
--ldflags_ex show LDFLAGS_EX value used when PostgreSQL was built
--ldflags_sl show LDFLAGS_SL value used when PostgreSQL was built
--libdir show location of object code libraries
--libs show LIBS value used when PostgreSQL was built
--localedir show location of locale support files
--mandir show location of manual pages
--pgxs show location of extension makefile
--pkgincludedir show location of other C header files
--pkglibdir show location of dynamically loadable modules
--sharedir show location of architecture-independent support files
--sysconfdir show location of system-wide configuration files
--version show the PostgreSQL version
-?, --help show this help, then exit
%s: could not find own program executable
%s: invalid argument: %s
Options:
Report bugs to <pgsql-bugs@postgresql.org>.
Try "%s --help" for more information.
Usage:
could not change directory to "%s": %s could not find a "%s" to execute could not identify current directory: %s could not read binary "%s" could not read symbolic link "%s" invalid binary "%s" not recorded
pclose failed: %s Project-Id-Version: pg_config (PostgreSQL 9.0)
Report-Msgid-Bugs-To: pgsql-bugs@postgresql.org
POT-Creation-Date: 2013-09-02 00:26+0000
PO-Revision-Date: 2013-09-02 13:17+0800
Last-Translator: Xiong He <iihero@qq.com>
Language-Team: Chinese (Simplified)
Language: zh_CN
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
X-Generator: Poedit 1.5.4
%s 提供 PostgreSQL 的安装信息.
没有参数,将显示所有已知的成员.
%s [选项]...
--bindir 显示执行文件所在位置
--cc 显示在创建PostgreSQL时所使用的CC值
--cflags 显示在创建PostgreSQL时所使用的CFLAG值
--cflags_sl 当创建PostgreSQL时显示CFLAGS_SL的值
--configure 显示编译 PostgreSQL 时 "configure"
的选项
--cppflags 当创建PostgreSQL时显示CPPFLAGS的值
--docdir 显示文档所在位置
--htmldir 显示HTML文档文件所在位置
--includedir 显示客户端接口 C 头文件所在
位置
--includedir-server 显示服务端 C 头文件所在位置
--ldflags 显示在创建PostgreSQL时所使用的LDFLAG值
--ldflags_ex 当创建PostgreSQL时显示LDFLAGS_EX的值
--ldflags_sl 当创建PostgreSQL时显示LDFLAGS_SL的值
--libdir 显示目标代码库文件所在位置
--libs 显示在创建PostgreSQL时所使用的LIBS值
--localedir 显示语言环境支持文件所在位置
--mandir 显示参考手册所在位置
--pgxs 显示扩展 makefile 所在位置
--pkgincludedir 显示其它C语言头文件所在的位置
--pkglibdir 显示动态加载库所在位置
--sharedir 显示独立架构支持文件所在位置
--sysconfdir 显示系统范围的配置文件的所在位置
--version 显示PostgreSQL的版本信息
-?, --help 显示帮助, 然后退出
%s: 无法找到执行文件
%s: 无效参数: %s
选项:
臭虫报告至 <pgsql-bugs@postgresql.org>.
请用 "%s --help" 获取更多的信息.
使用方法:
无法跳转到目录 "%s" 中: %s 未能找到一个 "%s" 来执行 无法确认当前目录: %s 无法读取二进制码 "%s" 无法读取符号链结 "%s" 无效的二进制码 "%s" 没有记录
pclose调用失败: %s locale/zh_CN/LC_MESSAGES/pg_ctl-9.6.mo 0000644 00000042123 14751153421 0012715 0 ustar 00 �� � � � < P D Q ? � � � &
0
P
- o
�
�
= �
! � A � a � K P � A � ! � 3 ? O H � D � C E a ? � ? � > ' 9 f L � B � E 0 � v 0 � F , > s 8 � I � % 5 2 [ O � 7 � & M 8 - � ! � > � E C [ y � 9 D S C � D � > ! A ` ( � , � 2 � 6 + > b * � / � % � 1 " 0 T # � � 4 � 2 � 1 / 0 a , � . � 3 � " + B 1 n 6 � : � 1 * D " o 7 � " � $ � J ] y 3 � 0 � � ! $ 6 [ - | � 4 � % � $ %! " J! ! m! F �! u �! F L" �" 7 �" ) �" k # ` u# % �# & �# #$ d +$ �$ / �$ & �$ 0 % . 7% ) f% ) �% �% �% & �%
& , +& ( X& �& ! �& �& �& �& �& ' "' 8' I' Y' j' z' " �' �' � �' 0 Z) < �) �) �) �) * /* . K* z* �* A �* $ �* % + � 9+ $ �+ e �+ S O, �, G �, " - 7 .- < f- D �- B �- D +. F p. ; �. 2 �. @ &/ 5 g/ S �/ L �/ G >0 �0 / 1 C 61 C z1 2 �1 @ �1 22 , S2 8 �2 3 �2 �2 �2 �2 U 3 & g3 �3 1 �3 = �3 I 4 m g4 Q �4 a '5 a �5 W �5 B C6 W �6 �6 # �6 2 #7 2 V7 . �7 �7 . �7 % 8 4 +8 + `8 �8 �8 + �8 2 �8 + )9 , U9 ) �9 , �9 4 �9 : - .: + \: + �: 2 �: , �: # ; 8; 1 S; ) �; �; E �; < % +< 6 Q< & �< �< * �< �< = : 7= r= . �= �= �= �= % > 4 @> Y u> : �> #
? ; .? + j? \ �? R �? " F@ * i@ �@ l �@ A % 1A # WA # {A ) �A �A �A B B " )B ! LB # nB �B �B �B �B
C C +C KC eC �C �C �C �C �C D 3D ? L y ' { � V r � & $ o @ � � P b [ - C U � " ( _ . � ; X Y ! 6 � A B = / w � % 7 E K
v
J q c M , ~ # 3 ) 0 W � F s � ] 1 ` u } � � � h � f x m t d : z j � * g S O 9 Q D < G I 4 > 2 5 N Z � | l ^ p i + a H R n 8 � e � � T \ k
%s: -w option cannot use a relative socket directory specification
%s: -w option is not supported when starting a pre-9.1 server
Allowed signal names for kill:
Common options:
Options for register and unregister:
Options for start or restart:
Options for stop or restart:
Report bugs to <pgsql-bugs@postgresql.org>.
Shutdown modes are:
Start types are:
%s init[db] [-D DATADIR] [-s] [-o "OPTIONS"]
%s kill SIGNALNAME PID
%s promote [-D DATADIR] [-s]
%s register [-N SERVICENAME] [-U USERNAME] [-P PASSWORD] [-D DATADIR]
[-S START-TYPE] [-w] [-t SECS] [-o "OPTIONS"]
%s reload [-D DATADIR] [-s]
%s restart [-w] [-t SECS] [-D DATADIR] [-s] [-m SHUTDOWN-MODE]
[-o "OPTIONS"]
%s start [-w] [-t SECS] [-D DATADIR] [-s] [-l FILENAME] [-o "OPTIONS"]
%s status [-D DATADIR]
%s stop [-W] [-t SECS] [-D DATADIR] [-s] [-m SHUTDOWN-MODE]
%s unregister [-N SERVICENAME]
-?, --help show this help, then exit
-D, --pgdata=DATADIR location of the database storage area
-N SERVICENAME service name with which to register PostgreSQL server
-P PASSWORD password of account to register PostgreSQL server
-S START-TYPE service start type to register PostgreSQL server
-U USERNAME user name of account to register PostgreSQL server
-V, --version output version information, then exit
-W do not wait until operation completes
-c, --core-files allow postgres to produce core files
-c, --core-files not applicable on this platform
-e SOURCE event source for logging when running as a service
-l, --log=FILENAME write (or append) server log to FILENAME
-m, --mode=MODE MODE can be "smart", "fast", or "immediate"
-o OPTIONS command line options to pass to postgres
(PostgreSQL server executable) or initdb
-p PATH-TO-POSTGRES normally not necessary
-s, --silent only print errors, no informational messages
-t, --timeout=SECS seconds to wait when using -w option
-w wait until operation completes
auto start service automatically during system startup (default)
demand start service on demand
fast quit directly, with proper shutdown
immediate quit without complete shutdown; will lead to recovery on restart
smart quit after all clients have disconnected
done
failed
stopped waiting
%s is a utility to initialize, start, stop, or control a PostgreSQL server.
%s: -S option not supported on this platform
%s: PID file "%s" does not exist
%s: WARNING: cannot create restricted tokens on this platform
%s: WARNING: could not locate all job object functions in system API
%s: another server might be running; trying to start server anyway
%s: cannot be run as root
Please log in (using, e.g., "su") as the (unprivileged) user that will
own the server process.
%s: cannot promote server; server is not in standby mode
%s: cannot promote server; single-user server is running (PID: %ld)
%s: cannot reload server; single-user server is running (PID: %ld)
%s: cannot restart server; single-user server is running (PID: %ld)
%s: cannot set core file size limit; disallowed by hard limit
%s: cannot stop server; single-user server is running (PID: %ld)
%s: could not access directory "%s": %s
%s: could not allocate SIDs: error code %lu
%s: could not create promote signal file "%s": %s
%s: could not create restricted token: error code %lu
%s: could not determine the data directory using command "%s"
%s: could not find own program executable
%s: could not find postgres program executable
%s: could not open PID file "%s": %s
%s: could not open process token: error code %lu
%s: could not open service "%s": error code %lu
%s: could not open service manager
%s: could not read file "%s"
%s: could not register service "%s": error code %lu
%s: could not remove promote signal file "%s": %s
%s: could not send promote signal (PID: %ld): %s
%s: could not send reload signal (PID: %ld): %s
%s: could not send signal %d (PID: %ld): %s
%s: could not send stop signal (PID: %ld): %s
%s: could not start server
Examine the log output.
%s: could not start server: %s
%s: could not start server: error code %lu
%s: could not start service "%s": error code %lu
%s: could not unregister service "%s": error code %lu
%s: could not wait for server because of misconfiguration
%s: could not write promote signal file "%s": %s
%s: database system initialization failed
%s: directory "%s" does not exist
%s: directory "%s" is not a database cluster directory
%s: invalid data in PID file "%s"
%s: missing arguments for kill mode
%s: no database directory specified and environment variable PGDATA unset
%s: no operation specified
%s: no server running
%s: old server process (PID: %ld) seems to be gone
%s: option file "%s" must have exactly one line
%s: server does not shut down
%s: server is running (PID: %ld)
%s: service "%s" already registered
%s: service "%s" not registered
%s: single-user server is running (PID: %ld)
%s: the PID file "%s" is empty
%s: too many command-line arguments (first is "%s")
%s: unrecognized operation mode "%s"
%s: unrecognized shutdown mode "%s"
%s: unrecognized signal name "%s"
%s: unrecognized start type "%s"
(The default is to wait for shutdown, but not for start or restart.)
HINT: The "-m fast" option immediately disconnects sessions rather than
waiting for session-initiated disconnection.
If the -D option is omitted, the environment variable PGDATA is used.
Is server running?
Please terminate the single-user server and try again.
Server started and accepting connections
The program "%s" is needed by %s but was not found in the
same directory as "%s".
Check your installation.
The program "%s" was found by "%s"
but was not the same version as %s.
Check your installation.
Timed out waiting for server startup
Try "%s --help" for more information.
Usage:
WARNING: online backup mode is active
Shutdown will not complete until pg_stop_backup() is called.
Waiting for server startup...
cannot duplicate null pointer (internal error)
child process exited with exit code %d child process exited with unrecognized status %d child process was terminated by exception 0x%X child process was terminated by signal %d child process was terminated by signal %s command not executable command not found could not change directory to "%s": %s could not find a "%s" to execute could not get current working directory: %s
could not identify current directory: %s could not read binary "%s" could not read symbolic link "%s" invalid binary "%s" out of memory
pclose failed: %s server is still starting up
server promoting
server shutting down
server signaled
server started
server starting
server stopped
starting server anyway
waiting for server to shut down... waiting for server to start... Project-Id-Version: pg_ctl (PostgreSQL 9.0)
Report-Msgid-Bugs-To: pgsql-bugs@postgresql.org
POT-Creation-Date: 2015-11-26 18:43+0000
PO-Revision-Date: 2015-12-01 19:30+0800
Last-Translator: Yuwei Peng <ywpeng@whu.edu.cn>
Language-Team: Chinese (Simplified)
Language: zh_CN
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
X-Generator: Poedit 1.5.7
%s: -w 选项不能用于相对套接字目录
%s: -w 选项不能用于9.1以前版本的服务器启动
允许关闭的信号名称:
普通选项:
注册或注销的选项:
启动或重启的选项:
停止或重启的选项:
臭虫报告至 <pgsql-bugs@postgresql.org>.
关闭模式有如下几种:
启动类型有:
%s init[db] [-D 数据目录] [-s] [-o "选项"]
%s kill 信号名称 进程号
%s promote [-D 数据目录] [-s]
%s register [-N 服务名称] [-U 用户名] [-P 口令] [-D 数据目录]
[-S 启动类型] [-w] [-t 秒数] [-o "选项"]
%s reload [-D 数据目录] [-s]
%s restart [-w] [-t 秒数] [-D 数据目录] [-s] [-m 关闭模式]
[-o "选项"]
%s start [-w] [-t 秒数] [-D 数据目录] [-s] [-l 文件名] [-o "选项"]
%s status [-D 数据目录]
%s stop [-W] [-t 秒数] [-D 数据目录] [-s] [-m 关闭模式]
%s unregister [-N 服务名称]
-?, --help 显示此帮助, 然后退出
-D, --pgdata=数据目录 数据库存储区域的位置
-N 服务名称 注册到 PostgreSQL 服务器的服务名称
-P 口令 注册到 PostgreSQL 服务器帐户的口令
-S START-TYPE 注册到PostgreSQL服务器的服务启动类型
-U 用户名 注册到 PostgreSQL 服务器帐户的用户名
-V, --version 输出版本信息, 然后退出
-W 不用等待操作完成
-c, --core-files 允许postgres进程产生核心文件
-c, --core-files 在这种平台上不可用
-e SOURCE 当作为一个服务运行时要记录的事件的来源
-l, --log=FILENAME 写入 (或追加) 服务器日志到文件FILENAME
-m, --mode=MODE 可以是 "smart", "fast", 或者 "immediate"
-o OPTIONS 传递给postgres的命令行选项
(PostgreSQL 服务器执行文件)或initdb
-p PATH-TO-POSTMASTER 正常情况不必要
-s, --silent 只打印错误信息, 没有其他信息
-t, --timeout=SECS 当使用-w 选项时需要等待的秒数
-w 等待直到操作完成
auto 在系统启动时自动启动服务(默认选项)
demand 按需启动服务
fast 直接退出, 正确的关闭
immediate 不完全的关闭退出; 重启后恢复
smart 所有客户端断开连接后退出
完成
失败
已停止等待
%s 是一个用于初始化、启动、停止或控制PostgreSQL服务器的工具.
%s: -S 选项在该平台上不支持
%s: PID 文件 "%s" 不存在
%s: 警告: 该平台上无法创建受限令牌
%s: 警告: 系统API中无法定位所有工作对象函数
%s: 其他服务器进程可能正在运行; 尝试启动服务器进程
%s: 无法以 root 用户运行
请以服务器进程所属用户 (非特权用户) 登录 (或使用 "su")
%s: 无法重新加载服务器进程；服务器没有运行在standby模式下
%s: 无法重新加载服务器进程；正在运行单用户模式的服务器进程 (PID: %ld)
%s: 无法重新加载服务器进程；正在运行单用户模式的服务器进程 (PID: %ld)
%s: 无法重启服务器进程; 单用户模式服务器进程正在运行 (PID: %ld)
%s: 不能设置核心文件大小的限制;磁盘限额不允许
%s: 无法停止服务器进程; 正在运行 单用户模式服务器进程(PID: %ld)
%s: 无法访问目录 "%s": %s
%s: 无法分配SID: 错误码 %lu
%s: 无法创建重新加载信号文件 "%s": %s
%s: 无法创建继承套接字: 错误码为 %lu
%s: 使用命令 "%s"无法确定数据目录
%s: 无法找到执行文件
%s: 无法找到postgres程序的执行文件
%s: 无法打开 PID 文件 "%s": %s
%s: 无法打开进程令牌 (token): 错误码 %lu
%s: 无法打开服务 "%s": 错误码 %lu
%s: 无法打开服务管理器
%s: 无法读取文件 "%s"
%s: 无法注册服务 "%s": 错误码 %lu
%s: 无法移动重新加载信号文件 "%s": %s
%s: 无法发送重载信号(PID: %ld): %s
%s: 无法发送重载信号 (PID: %ld): %s
%s: 无法发送信号 %d (PID: %ld): %s
%s: 无法发送停止信号 (PID: %ld): %s
%s: 无法启动服务器进程
检查日志输出.
%s: 无法启动服务器：%s
%s：无法启动服务器：错误代码%lu
%s: 无法启动服务 "%s": 错误码 %lu
%s: 无法注销服务 "%s": 错误码 %lu
%s: 因为配制错误，而无法等待服务器
%s: 无法写入重新加载文件 "%s": %s
%s: 数据库系统初始化失败
%s: 目录 "%s" 不存在
%s: 目录 "%s"不是一个数据库集群目录
%s: PID文件 "%s" 中存在无效数据
%s: 缺少 kill 模式参数
%s: 没有指定数据目录, 并且没有设置 PGDATA 环境变量
%s: 没有指定操作
%s:没有服务器进程正在运行
%s: 原有的进程(PID: %ld)可能已经不存在了
%s: 选项文件 "%s" 只能有一行
%s: server进程没有关闭
%s: 正在运行服务器进程(PID: %ld)
%s: 服务 "%s" 已经注册了
%s: 服务 "%s" 没有注册
%s: 正在运行单用户模式服务器进程 (PID: %ld)
%s: PID 文件 "%s" 为空
%s: 命令行参数太多 (第一个是 "%s")
%s: 无效的操作模式 "%s"
%s: 无效的关闭模式 "%s"
%s: 无效信号名称 "%s"
%s: 无法识别的启动类型 "%s"
(默认为关闭等待, 但不是启动或重启.)
提示: "-m fast" 选项可以立即断开会话, 而不用
等待会话发起的断连.
如果省略了 -D 选项, 将使用 PGDATA 环境变量.
服务器进程是否正在运行?
请终止单用户模式服务器进程，然后再重试.
服务器进程已启动并且接受连接
%2$s需要程序"%1$s", 但是在同一个目录"%3$s"中没找到.
请检查您的安装.
"%2$s"找到程序 "%1$s", 但是和版本 "%3$s" 不一致.
检查您的安装.
在等待服务器启动时超时
试用 "%s --help" 获取更多的信息.
使用方法:
警告: 在线备份模式处于激活状态
关闭命令将不会完成，直到调用了pg_stop_backup().
等待服务器进程启动 ...
无法复制空指针 (内部错误)
子进程已退出, 退出码为 %d 子进程已退出, 未知状态 %d 子进程被例外(exception) 0x%X 终止 子进程被信号 %d 终止 子进程被信号 %s 终止 无法执行命令 没有找到命令 无法跳转到目录 "%s" 中: %s 未能找到一个 "%s" 来执行 无法得到当前工作目录: %s
无法确认当前目录: %s 无法读取二进制码 "%s" 无法读取符号链结 "%s" 无效的二进制码 "%s" 内存溢出
pclose调用失败: %s 服务器仍在启动过程中
服务器重新加载中
正在关闭服务器进程
服务器进程发出信号
服务器进程已经启动
正在启动服务器进程
服务器进程已经关闭
正在启动服务器进程
等待服务器进程关闭 ... 等待服务器进程启动 ... locale/zh_CN/LC_MESSAGES/ecpg-9.6.mo 0000644 00000032147 14751153421 0012370 0 ustar 00 �� y � � � 8
~ 9
- �
0 �
7 + O g { � 4 s 8 . � G � 4 #
) X
w �
4 �
/ @ B = � , � ! � , . 1 [ * � - � 1 � ' & @ + g " � # � � ) � = J T & p < � ! � � - + . " Z } , � � � * " . ' Q y � ! � � ! � 3 ; / o ' � 5 � I � , G / t * � T � ' $ L g � � � - � , � , ! 5 N � ) � ? � 8
� C � 0 � 5 % [ A p L � + �
+ 6 9 ' p # � � ( � 4 � ) ' Q / n � � $ � � " , 8 e } ' � � � $ � D $ + i ? � 0 � 8 % ^ | & � � � � � � . ! 0 C! 3 t! 1 �! q �! L" 4 k" h �" . # B 8# ( {# ) �# x �# 3 G$ {$ @ �$ ; �$ ) % ;% \% * z% 1 �% * �% - & 1 0& ' b& & �& + �& $ �& 1 ' 4' , <' > i' �' �' * �' K �' ! =( _( ' g( + �( �( �( , �( ) 7) " N) q) �) �) ( �) * �) $* * D* o* �* 2 �* ( �* �* E + W a+ ' �+ * �+ * , T 7, $ �, �, �, �, �, - * '- ) R- ) |- 1 �- �- �- 0 . $ 3. = X. �. - �. 0 �. / 9 &/ @ `/ - �/ �/ 6 �/ + 0 ) ?0 i0 . v0 4 �0 �0 �0 8 1 I1 & a1 ' �1 �1 # �1 0 �1 2 52 # T2 x2 �2 �2 4 �2 + 3 : 23 4 m3 �3 5 �3 �3 4 )4 J4 Y * - < w ? " 9 M O = ^ 0 f y , P 2 l
t ) G v 5 x C : e F Z ] X % k J H ; [ U i d
E N $ a b T ! 6 D h ( & g p u A K W # 1 V n B I + o _ 8 s Q 4 / 7 S ` L c > \ m ' 3 @ q R j r .
If no output file is specified, the name is formed by adding .c to the
input file name, after stripping off .pgc if present.
Report bugs to <pgsql-bugs@postgresql.org>.
--regression run in regression testing mode
--version output version information, then exit
-?, --help show this help, then exit
-C MODE set compatibility mode; MODE can be one of
"INFORMIX", "INFORMIX_SE"
-D SYMBOL define SYMBOL
-I DIRECTORY search DIRECTORY for include files
-c automatically generate C code from embedded SQL code;
this affects EXEC SQL TYPE
-d generate parser debug output
-h parse a header file, this option includes option "-c"
-i parse system include files as well
-o OUTFILE write result to OUTFILE
-r OPTION specify run-time behavior; OPTION can be:
"no_indicator", "prepare", "questionmarks"
-t turn on autocommit of transactions
%s at or near "%s" %s is the PostgreSQL embedded SQL preprocessor for C programs.
%s, the PostgreSQL embedded C preprocessor, version %d.%d.%d
%s: could not locate my own executable path
%s: could not open file "%s": %s
%s: no input files specified
%s: parser debug support (-d) not available
AT option not allowed in CLOSE DATABASE statement AT option not allowed in CONNECT statement AT option not allowed in DISCONNECT statement AT option not allowed in SET CONNECTION statement AT option not allowed in TYPE statement AT option not allowed in VAR statement AT option not allowed in WHENEVER statement COPY FROM STDIN is not implemented CREATE TABLE AS cannot specify INTO ERROR: EXEC SQL INCLUDE ... search starts here:
Error: include path "%s/%s" is too long on line %d, skipping
Options:
SHOW ALL is not implemented Try "%s --help" for more information.
Unix-domain sockets only work on "localhost" but not on "%s" Usage:
%s [OPTION]... FILE...
WARNING: arrays of indicators are not allowed on input could not open include file "%s" on line %d could not remove output file "%s"
cursor "%s" does not exist cursor "%s" has been declared but not opened cursor "%s" is already defined descriptor "%s" does not exist descriptor header item "%d" does not exist descriptor item "%s" cannot be set descriptor item "%s" is not implemented end of search list
expected "://", found "%s" expected "@" or "://", found "%s" expected "@", found "%s" expected "postgresql", found "%s" incomplete statement incorrectly formed variable "%s" indicator for array/pointer has to be array/pointer indicator for simple data type has to be simple indicator for struct has to be a struct indicator variable "%s" is hidden by a local variable indicator variable "%s" is hidden by a local variable of a different type indicator variable must have an integer type initializer not allowed in EXEC SQL VAR command initializer not allowed in type definition internal error: unreachable state; please report this to <pgsql-bugs@postgresql.org> interval specification not allowed here invalid bit string literal invalid connection type: %s invalid data type key_member is always 0 missing "EXEC SQL ENDIF;" missing identifier in EXEC SQL DEFINE command missing identifier in EXEC SQL IFDEF command missing identifier in EXEC SQL UNDEF command missing matching "EXEC SQL IFDEF" / "EXEC SQL IFNDEF" more than one EXEC SQL ELSE multidimensional arrays are not supported multidimensional arrays for simple data types are not supported multidimensional arrays for structures are not supported multilevel pointers (more than 2 levels) are not supported; found %d level multilevel pointers (more than 2 levels) are not supported; found %d levels nested /* ... */ comments nested arrays are not supported (except strings) no longer supported LIMIT #,# syntax passed to server nullable is always 1 only data types numeric and decimal have precision/scale argument only protocols "tcp" and "unix" and database type "postgresql" are supported operator not allowed in variable definition out of memory pointer to pointer is not supported for this data type pointers to varchar are not implemented subquery in FROM must have an alias syntax error syntax error in EXEC SQL INCLUDE command too many levels in nested structure/union definition too many nested EXEC SQL IFDEF conditions type "%s" is already defined type name "string" is reserved in Informix mode unmatched EXEC SQL ENDIF unrecognized data type name "%s" unrecognized descriptor item code %d unrecognized token "%s" unrecognized variable type code %d unsupported feature will be passed to server unterminated /* comment unterminated bit string literal unterminated hexadecimal string literal unterminated quoted identifier unterminated quoted string using unsupported DESCRIBE statement using variable "%s" in different declare statements is not supported variable "%s" is hidden by a local variable variable "%s" is hidden by a local variable of a different type variable "%s" is neither a structure nor a union variable "%s" is not a pointer variable "%s" is not a pointer to a structure or a union variable "%s" is not an array variable "%s" is not declared variable "%s" must have a numeric type zero-length delimited identifier Project-Id-Version: ecpg (PostgreSQL 9.0)
Report-Msgid-Bugs-To: pgsql-bugs@postgresql.org
POT-Creation-Date: 2014-11-22 21:07+0000
PO-Revision-Date: 2014-11-24 15:21+0800
Last-Translator: Xiong He <iihero@qq.com>
Language-Team: Chinese (Simplified)
Language: zh_CN
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Plural-Forms: nplurals=1; plural=0;
X-Generator: Poedit 1.5.4
如果没有指定输出文件，那么输出文件名将由输入文件名（如果有后缀，那么去掉.pgc)
加上.c的后缀名组成.
错误报告至 <pgsql-bugs@postgresql.org>.
--regression 在回归测试模式下运行
--version 输出版本信息，然后退出
-?, --help 显示帮助信息,然后退出
-C MODE 设置兼容模式；MODE可以是下列模式之一
"INFORMIX", "INFORMIX_SE"
-D SYMBOL 定义SYMBOL
-I DIRECTORY 为引用文件搜索变量DIRECTORY
-c 从嵌入式SQL代码中自动产生C代码;
这将影响EXEC SQL TYPE
-d 产生解析器的调试输出
-h 分析一个头文件,这个选项包含选项"-c"
-i 分析系统引用文件
-o OUTFILE 将结果写入到OUTFILE
-r OPTION 指定运行时的系统行为; OPTION可以是:
"no_indicator", "prepare", "questionmarks"
-t 打开事务的自动提交功能
%s 在 "%s" 或附近的 %s是用于C语言程序的PostgreSQL嵌入式SQL预处理器.
%s, PostgreSQL嵌入式C语言预处理器, 版本%d.%d.%d
%s: 找不到我的可执行文件路径
%s: 无法打开文件 "%s": %s
%s: 没有指定输入文件
%s: 解析器跟踪调试支持(-d)无效
在CLOSE DATABASE语句中不允许使用AT选项 在CONNECT语句中不允许使用AT选项 在DISCONNECT语句中不允许使用AT选项 在SET CONNECTION语句中不允许使用AT选项 在TYPE语句中不允许使用AT选项 在VAR语句中不允许使用AT选项 在WHENEVER语句中不允许使用AT选项 不能进行COPY FROM STDIN的操作 在CREATE TABLE AS语句中不能指定INTO子句 错误: EXEC SQL INCLUDE ... 从这里开始搜索:
错误:在第%3$d行上包含路径"%1$s/%2$s"太长，跳过
选项:
没有使用SHOW ALL 请用 "%s --help" 获取更多的信息.
Unix-域的sockets只能在"localhost"上运行，而不能在"%s"上运行 Usage:
%s [OPTION]... FILE...
警告: 在输入上不允许使用标识数组 在第%2$d行无法打开应用文件"%1$s" 无法删除输出文件 "%s"
游标 "%s" 不存在 已经声明了游标"%s",但是没有打开 已经定义了游标"%s" 描述符"%s"不存在 描述符标题成员"%d"不存在 无法设置描述符成员 "%s" 没有使用描述符成员"%s". 搜索列表的结束部分
期望得到 "://"，但是找到了"%s" 期望"@"或"://"，但是只找到了"%s" 期望 "@", 但是找到了"%s" 期望"postgresql", 但是只找到了"%s" 未结束的语句 不正确形成的变量 "%s" 对于数组/指针的记号必须是array/pointer 对简单数据类型的指标要简单 结构的记号必须是struct 标记变量(indicator variable)"%s"是由一个局部变量隐藏的 标记变量(indicator variable)"%s"是由一个不同类型的局部变量隐藏的。 标记变量必须有一个整数类型 在EXEC SQL VAR命令中不允许初始化 在类型定义中不允许进行初始化 内部错误：不可到达的状态；请向<pgsql-bugs@postgresql.org>发送报告 在这里不允许使用间隔定义 无效的bit字符串常量 无效的连接类型: %s 无效数据类型 key_member永远是0 "EXEC SQL ENDIF;"丢失 在EXEC SQL DEFINE命令中丢失标识符 在EXEC SQL IFDEF命令中丢失标识符 在EXEC SQL UNDEF命令中丢失标识符 丢失匹配 "EXEC SQL IFDEF" / "EXEC SQL IFNDEF" 多个EXEC SQL ELSE 不支持多维数组 不支持针对简单数据类型的多维数组 不支持结构类型的多维数组 不支持多级指针（超过2级）；找到了%d级指针. 有嵌套注释/*...*/ 不支持嵌套数组（除了字符串外） 不再支持将LIMIT #,#语法传递给服务器 可为空永远用1表示 只有数据类型numeric和decimal有精度/范围参数 只支持协议"tcp"和 "unix"以及数据库类型 "postgresql" 操作符不允许出现在变量定义当中 内存用尽 对于这种数据类型不支持指向指针的指针 没有实现指向varchar类型值的指针 FROM 中的子查询必须有一个别名 语法错误 在EXEC SQL INCLUDE命令中出现语法错误 在嵌套结构/联合定义中存在太多的层次 嵌套EXEC SQL IFDEF条件太多 已定义类型"%s" 在Informix模式中类型名称"string" 是被保留的 EXEC SQL ENDIF不匹配 无法识别的数据类型名称 "%s" 无法识别的描述符成员代码 %d 无法识别的符号"%s" 无法识别的变量类型代码%d 不支持的功能特性将会传递给服务器 /* 注释没有结束 未结束的bit字符串常量 未结束的16进制字符串常量 未结束的引用标识符 未结束的引用字符串 使用不支持的DESCRIBE语句 不支持在不同的声明语句中使用变量"%s" 变量"%s"是由一个局部变量隐藏的 变量"%s"是由一个不同类型的局部变量隐藏的 变量"%s"既不是一个结构也不是一个联合 变量"%s"不是一个指针 变量"%s" 不是一个指向结构或联合的指针 变量"%s"不是一个数组 没有声明变量"%s" 变量 "%s"必须是数值类型 长度为0的分隔标识符 locale/zh_CN/LC_MESSAGES/libpq5-9.6.mo 0000644 00000053067 14751153421 0012652 0 ustar 00 �� � � � P Q b e j p �
� ' � ( � � # 9 M $ Z �
� 0 � ( � ( @ J V 5 ] 8 � � $ � # 6 B - T � � . � ( � , ? R : a " � � � < � a % 0 � ) � ' � *
. 5 + d ' � ' � * � * + 6 * b , � ) � ) � + - : / h + � ( � ) � & 5 > 3 t & � ! � � ! " = ` v } w � r l � ! " ' ? - g � � > ) # h 9 � & � ) � * # B 9 f ) � ' � ) � ) : " d 9 � . � ' � * ! " C! " f! . �! / �! - �! @ " 2 W" ! �" % �" % �" V �" = O# ; �# �# �# $ 4 &$ 0 [$ �$ : �$ �$ % %% - F% - t% �% + �% 2 �% 7 & = U& ! �& . �& 8 �& " ' @' F `' C �' $ �' ( B +( n( ~( ; �( ( �( * ) & +) % R) ! x) 6 �) C �) ? * 2 U* 1 �* = �* ) �* J "+ m+ �+ �+ �+ �+ 1 �+
", 0, + ?, k, ) �, " �, [ �, 3- ? L- 1 �- 8 �- > �- � 6. # �. �. : �. � +/ 2 �/ Q �/ J :0 K �0 �0 $ �0 % 1 # 91 $ ]1 % �1 ? �1 ! �1 +
2 62 G2 L c2 D �2 % �2 . 3 C J3 �3 $ �3 5 �3 )
4 � 44
�5 �5 �5 �5 �5 �5 6 6 06 " P6 s6 �6 �6 �6 �6 �6 �6 . 7 07 M7 j7 s7 }7 A �7 A �7 8 & '8 # N8 r8 8 �8 �8 $ �8 ( �8 9 39 J9 _9 & o9 �9 �9 �9 7 �9 X : 1 _: , �: % �: ) �: ' ; * 6; # a; �; $ �; $ �; $ �; $ < & 4< # [< # < % �< $ �< ) �< % = " >= # a= �= % �= & �= " �=
> -> G> X> n> ! �> t �> ~ ? z �? @ .@ K@ f@ , �@ w �@ 1 (A " ZA 4 }A & �A ! �A ( �A $B 4 DB " yB " �B " �B �B " �B "C 4 ?C % tC # �C �C # �C D 4 D F RD , �D < �D ) E -E ) JE tE W �E 3 �E > F ! YF {F �F 3 �F ' �F G 4 ,G aG ! {G ! �G ) �G ) �G H % 0H . VH + �H 9 �H ) �H + I 4 AI vI �I < �I B �I % /J UJ 5 lJ �J �J * �J & �J & "K 5 IK # K ' �K & �K @ �K 9 3L = mL 2 �L > �L # M C AM �M �M �M # �M �M + N AN
NN + \N �N �N �N Y �N =O 4 TO ( �O * �O J �O h (P " �P �P 0 �P � �P / �Q Q �Q J R K SR & �R * �R * �R ) S ) FS * pS B �S �S 1 �S
0T ( ;T K dT D �T ( �T 7 U A VU �U ) �U . �U ( V � � ~ l � ? � N � m , K f � d � F > � s ( � k T � 2 � � a � � - E � S # � 3 Y t �
* � � � � Q 5 4 � � y � � R 8 9 / [ J � + � Z w ` r n � � � I L % � � x
b � 6 1 � � � � � ; ^ ! : � � � V c D & � \ p u P M � � � 7 � } q � � o � � H � @ v " U | W � B � C � 0 � h � $ i � _ � � . � � � � X < � g e = ' � � � � � ) � { G z � A ] j � � � O � � � � � at character %s %s %s, %s:%s COLUMN NAME: %s
CONSTRAINT NAME: %s
CONTEXT: %s
COPY IN state must be terminated first
COPY OUT state must be terminated first
COPY terminated by new PQexec Crypt authentication not supported
DATATYPE NAME: %s
DETAIL: %s
GSSAPI authentication not supported
GSSAPI continuation error GSSAPI name import error HINT: %s
IPv6 host address may not be empty in URI: "%s"
Kerberos 4 authentication not supported
Kerberos 5 authentication not supported
LINE %d: LOCATION: NOTICE PGEventProc "%s" failed during PGEVT_CONNRESET event
PGEventProc "%s" failed during PGEVT_RESULTCREATE event
PGresult is not an error result
PQexec not allowed during COPY BOTH
PQgetline: not doing text COPY OUT
QUERY: %s
SCHEMA NAME: %s
SCM_CRED authentication method not supported
SSL SYSCALL error: %s
SSL SYSCALL error: EOF detected
SSL certificate's name contains embedded null
SSL certificate's name entry is missing
SSL connection has been closed unexpectedly
SSL error code %lu SSL error: %s
SSL library does not support CRL certificates (file "%s")
SSPI authentication not supported
SSPI continuation error TABLE NAME: %s
Unix-domain socket path "%s" is too long (maximum %d bytes)
WARNING: password file "%s" has group or world access; permissions should be u=rw (0600) or less
WARNING: password file "%s" is not a plain file
WSAIoctl(SIO_KEEPALIVE_VALS) failed: %ui
another command is already in progress
argument of lo_read exceeds integer range
argument of lo_truncate exceeds integer range
argument of lo_write exceeds integer range
attribute has no values on LDAP lookup
authentication method %u not supported
cannot determine OID of function lo_close
cannot determine OID of function lo_creat
cannot determine OID of function lo_create
cannot determine OID of function lo_lseek
cannot determine OID of function lo_lseek64
cannot determine OID of function lo_open
cannot determine OID of function lo_tell
cannot determine OID of function lo_tell64
cannot determine OID of function lo_truncate
cannot determine OID of function lo_truncate64
cannot determine OID of function lo_unlink
cannot determine OID of function loread
cannot determine OID of function lowrite
certificate could not be obtained: %s
certificate does not match private key file "%s": %s
certificate present, but not private key file "%s"
column number %d is out of range 0..%d command string is a null pointer
connection in wrong state
connection not open
connection pointer is NULL
could not acquire SSPI credentials could not acquire mutex: %s
could not connect to server: %s
Is the server running locally and accepting
connections on Unix domain socket "%s"?
could not connect to server: %s
Is the server running on host "%s" (%s) and accepting
TCP/IP connections on port %s?
could not connect to server: %s
Is the server running on host "%s" and accepting
TCP/IP connections on port %s?
could not create LDAP structure
could not create SSL context: %s
could not create socket: %s
could not establish SSL connection: %s
could not get client address from socket: %s
could not get home directory to locate root certificate file
Either provide the file or change sslmode to disable server certificate verification.
could not get home directory to locate service definition file could not get peer credentials: %s
could not get server's host name from server certificate
could not get socket error status: %s
could not initialize SSL engine "%s": %s
could not interpret result from server: %s could not load SSL engine "%s": %s
could not load private SSL key "%s" from engine "%s": %s
could not load private key file "%s": %s
could not look up local user ID %d: %s
could not open certificate file "%s": %s
could not open file "%s": %s
could not read certificate file "%s": %s
could not read from file "%s": %s
could not read private SSL key "%s" from engine "%s": %s
could not read root certificate file "%s": %s
could not receive data from server: %s
could not send SSL negotiation packet: %s
could not send data to server: %s
could not send startup packet: %s
could not set socket to TCP no delay mode: %s
could not set socket to close-on-exec mode: %s
could not set socket to nonblocking mode: %s
could not translate Unix-domain socket path "%s" to address: %s
could not translate host name "%s" to address: %s
could not write to file "%s": %s
definition of service "%s" not found
duplicate GSS authentication request
end of string reached when looking for matching "]" in IPv6 host address in URI: "%s"
expected authentication request from server, but received %c
extra key/value separator "=" in URI query parameter: "%s"
extraneous data in "D" message extraneous data in "T" message extraneous data in "t" message forbidden value %%00 in percent-encoded value: "%s"
function requires at least protocol version 3.0
host name must be specified
host name must be specified for a verified SSL connection
incomplete multibyte character
insufficient data in "D" message insufficient data in "T" message integer of size %lu not supported by pqGetInt integer of size %lu not supported by pqPutInt invalid ExecStatusType code invalid LDAP URL "%s": invalid port number
invalid LDAP URL "%s": missing distinguished name
invalid LDAP URL "%s": must have exactly one attribute
invalid LDAP URL "%s": must have search scope (base/one/sub)
invalid LDAP URL "%s": no filter
invalid LDAP URL "%s": scheme must be ldap://
invalid URI propagated to internal parser routine: "%s"
invalid URI query parameter: "%s"
invalid connection option "%s"
invalid connection state %d, probably indicative of memory corruption
invalid connection state, probably indicative of memory corruption
invalid percent-encoded token: "%s"
invalid port number: "%s"
invalid setenv state %c, probably indicative of memory corruption
invalid socket
invalid sslmode value: "%s"
invalid state %c, probably indicative of memory corruption
keepalives parameter must be an integer
length must be given for binary parameter
line %d too long in service file "%s"
local user with ID %d does not exist
lookup on LDAP server failed: %s
lost synchronization with server, resetting connection lost synchronization with server: got message type "%c", length %d
message contents do not agree with length in message type "%c"
message type 0x%02x arrived from server while idle missing "=" after "%s" in connection info string
missing key/value separator "=" in URI query parameter: "%s"
more than one entry found on LDAP lookup
nested service specifications not supported in service file "%s", line %d
no COPY in progress
no SSL error reported no connection to the server
no entry found on LDAP lookup
no error message available
number of parameters must be between 0 and 65535
out of memory out of memory
out of memory allocating GSSAPI buffer (%d) out of memory for query result parameter number %d is out of range 0..%d password retrieved from file "%s"
private key file "%s" has group or world access; permissions should be u=rw (0600) or less
protocol error: id=0x%x
query to initialize large object functions did not return data
received invalid response to SSL negotiation: %c
requirepeer parameter is not supported on this platform
requirepeer specifies "%s", but actual peer user name is "%s"
root certificate file "%s" does not exist
Either provide the file or change sslmode to disable server certificate verification.
row number %d is out of range 0..%d select() failed: %s
server certificate for "%s" does not match host name "%s"
server closed the connection unexpectedly
This probably means the server terminated abnormally
before or while processing the request.
server does not support SSL, but SSL was required
server sent binary data ("B" message) without prior row description ("T" message) server sent data ("D" message) without prior row description ("T" message) server sent data ("D" message) without prior row description ("T" message)
service file "%s" not found
setsockopt(SO_KEEPALIVE) failed: %s
setsockopt(TCP_KEEPALIVE) failed: %s
setsockopt(TCP_KEEPCNT) failed: %s
setsockopt(TCP_KEEPIDLE) failed: %s
setsockopt(TCP_KEEPINTVL) failed: %s
sslmode value "%s" invalid when SSL support is not compiled in
statement name is a null pointer
syntax error in service file "%s", line %d
timeout expired
unexpected asyncStatus: %d
unexpected character "%c" at position %d in URI (expected ":" or "/"): "%s"
unexpected character %c following empty query response ("I" message) unexpected field count in "D" message unexpected message from server during startup
unexpected response from server; first received character was "%c"
unrecognized SSL error code: %d
unrecognized socket error: 0x%08X/%d unterminated quoted string in connection info string
user name lookup failure: error code %lu
Project-Id-Version: libpq (PostgreSQL 9.0)
Report-Msgid-Bugs-To: pgsql-bugs@postgresql.org
POT-Creation-Date: 2016-04-18 04:38+0000
PO-Revision-Date: 2016-09-26 10:11-0400
Last-Translator: Yuwei Peng <ywpeng@whu.edu.cn>
Language-Team: Chinese (Simplified) <ywpeng@whu.edu.cn>
Language: zh_CN
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
X-Generator: Poedit 1.5.7
在字符 %s %s %s, %s:%s 列名: %s
约束名: %s
背景: %s
COPY IN 状态必须先结束
COPY OUT 状态必须先结束
COPY 被一个新的 PQexec 终止 不支持Crypt认证
数据类型名: %s
描述: %s
不支持GSSAPI认证
GSSAPI连续出现错误 GSSAPI名称导入错误 提示: %s
URI:"%s"中的IPv6主机地址可能不为空
不支持 Kerberos 4 认证
不支持 Kerberos 5 认证
第%d行 位置: 注意 在PGEVT_CONNRESET事件触发期间执行PGEventProc "%s"错误
在PGEVT_CONNRESET事件触发期间执行PGEventProc "%s"错误
PGresult不是错误的结果
在 COPY BOTH时不允许调用PQexec
PQgetline: not doing text COPY OUT
查询: %s
方案名: %s
不支持 SCM_CRED 认证方式
SSL SYSCALL 错误: %s
SSL SYSCALL 错误: 发现结束符
SSL证书的名称包含嵌入的空值
SSL证书的名称项缺失
SSL连接异常关闭
SSL 错误代码 %lu SSL 错误: %s
SSL库不支持CRL认证(文件 "%s")
不支持SSPI认证
SSPI连续出现错误 表名: %s
Unix域的套接字路径"%s"超长(最大为%d字节)
警告: 口令文件"%s"的访问权限过大; 权限应设置 为 u=rw (0600)或更少
警告: 口令文件"%s"不是普通文本文件
执行WSAIoctl(SIO_KEEPALIVE_VALS)失败:%u
已经有另外一条命令在处理
lo_read的参数值已超出整数范围
lo_truncate的参数超出整数范围
lo_write的参数值已超出整数范围
在LDAP查找上的属性没有值
不支持 %u 认证方式
无法判断函数 lo_close 的 OID
无法判断函数 lo_creat 的 OID
无法确定函数 lo_creat 的 OID
无法判断函数 lo_lseek 的 OID
无法确定函数lo_lseek64的OID值
无法判断函数 lo_open 的 OID
无法判断函数 lo_tell 的 OID
无法确定函数lo_tell64的OID值
无法确定函数 lo_creat 的 OID
无法确定函数lo_truncate64的OID值
无法判断函数 lo_unlink 的 OID
无法判断函数 loread 的 OID
无法判断函数 lowrite 的 OID
无法获得证书: %s
证书不匹配私钥文件 "%s": %s
有证书, 但不是私钥文件 "%s"
列号码 %d 超出了范围 0..%d 命令字串是一个空指针
联接处于错误状态
联接未打开
联接指针是 NULL
无法获得SSPI证书 无法获取互斥锁(mutex): %s
无法联接到服务器: %s
服务器是否在本地运行并且在 Unix 域套接字
"%s"上准备接受联接?
无法联接到服务器: %s
服务器是否在主机 "%s"(%s) 上运行并且准备接受在端口
%s 上的 TCP/IP 联接?
无法联接到服务器: %s
服务器是否在主机 "%s" 上运行并且准备接受在端口
%s 上的 TCP/IP 联接?
无法创建LDAP结构
无法创建 SSL 环境: %s
无法创建套接字: %s
无法建立 SSL 联接: %s
无法从套接字获取客户端地址: %s
无法获取home目录以定位根认证文件
可以提供该文件或者将sslmode改为禁用服务器证书认证.
无法进入home目录来定位服务定义文件 无法获得对等(peer)证书:%s
无法从服务器证书得到服务器的主机名
无法获取套接字错误状态: %s
无法初始化SSL引擎"%s": %s
无法解释来自服务器的结果: %s 无法加载SSL引擎 "%s": %s
无法从引擎"%2$s"读取私有SSL钥"%1$s": %3$s
无法装载私钥文件 "%s": %s
无法查找本地用户ID %d: %s
无法打开证书文件 "%s": %s
无法打开文件 "%s": %s
无法读取证书文件 "%s": %s
无法读取文件 "%s": %s
无法从引擎"%2$s"读取私有SSL钥"%1$s": %3$s
无法读取根证书文件 "%s": %s
无法从服务器接收数据: %s
无法发送 SSL 握手包: %s
无法向服务器发送数据: %s
无法发送启动包: %s
无法将套接字设置为 TCP 无延迟模式: %s
无法将套接字设置为执行时关闭 (close-on-exec) 模式: %s
无法设置套接字为非阻塞模式: %s
无法解释 Unix-domian 套接字路径 "%s" 到地址: %s
无法解释主机名 "%s" 到地址: %s
无法写入文件 "%s": %s
错误：没有找到服务"%s"的定义
重复的GSS认证请求
在 URI: "%s"中的IPv6主机地址里查找匹配符"]"时遇到了字符串结束符
期待来自服务器的认证请求, 却收到 %c
遇到多余的键/值分隔符"="在URI查询参数里: "%s"
"D"消息中已经没有数据了 "T"消息中有无关的数据 "t"消息中有无关的数据 在百分值编码的值: "%s"里禁止使用 %%00
函数至少需要 3.0 版本的协议
必须指定主机名
必须为一个已验证的SSL连接指定主机名
无效的多字节字符
"D"消息中剩下的数据不够 "T"消息中剩下的数据不够 pqGetInt 不支持大小为 %lu 的整数 pqPutInt 不支持大小为 %lu 的整数 非法 ExecStatusType 代码 无效LDAP URL "%s": 无效端口号
无效LDAP URL "%s": 丢失可区分的名称
无效LDAP URL "%s": 只能有一个属性
无效LDAP URL "%s": 必须有搜索范围(base/one/sub)
无效的 LDAP URL "%s": 没有过滤器
无效LDAP URL"%s": 模式必须是ldap://
无效的URI传入内部解析器处理程序: "%s"
无效的URI查询参数: "%s"
非法联接选项 "%s"
无效的连接状态 %d, 这可能表示内存出现问题
无效的联接状态, 可能是存储器数据被破坏的标志
无效的百分号编码令牌: "%s"
无效端口号: "%s"
无效的 setenv 状态 %c, 可能是内存被破坏
无效套接字
无效的 sslmode 值: "%s"
无效状态 %c, 可能是内存被破坏
参数keepalives必须是一个整数
对于2进制参数必须指定长度
在服务文件"%2$s"中的第%1$d行的长度太长
ID 为 %d 的本地用户不存在
在LDAP服务器上的查找失败: %s
失去与服务器同步, 重置连接 失去与服务器同步: 获取到消息类型 "%c", 长度 %d
在消息类型 "%c" 中, 消息内容与长度不匹配
当空闲时收到服务起发送过来的消息类型 0x%02x 在联接信息字串里的 "%s" 后面缺少 "="
缺少相应的键/值分隔符"="在URI查询参数里: "%s"
在LDAP搜索上找到多个入口
在服务文件"%s"的第%d行出现不支持的嵌套服务说明
没有正在处理的 COPY
没有报告SSL错误 没有到服务器的联接
在LDAP查找上没有发现入口
没有可用的错误消息
参数的个数必须介于0到65535之间
内存用尽 内存用尽
在分配GSSAPI缓冲区(%d)时内存用尽 查询结果时内存耗尽 参数号%d超出了范围 0..%d 从文件"%s"中获取口令
警告: 私钥文件 "%s"的访问权限过大; 权限应设置 为 u=rw (0600)或更小
协议错误: id=0x%x
初始化大对象函数的查询没有返回数据
收到对 SSL 握手的无效响应: %c
在此平台上不支持requirepeer参数
期望对方用户指定值为 "%s", 但实际的对方用户名为 "%s"
根认证文件"%s"不存在
可以提供这个文件或者将sslmode改为禁用服务器认证检验.
行号码 %d 超出了范围 0..%d select() 失败: %s
"%s"的服务器证书与主机名不匹配"%s"
服务器意外地关闭了联接
这种现象通常意味着服务器在处理请求之前
或者正在处理请求的时候意外中止
服务器不支持 SSL, 但是要求使用 SSL
server sent binary data ("B" message) without prior row description ("T" message) server sent data ("D" message) without prior row description ("T" message) server sent data ("D" message) without prior row description ("T" message)
错误：没有找到服务文件"%s"
执行setsockopt(SO_KEEPALIVE) 失败: %s
执行setsockopt(TCP_KEEPALIVE)失败: %s
执行setsockopt(TCP_KEEPCNT) 失败: %s
执行setsockopt(TCP_KEEPIDLE)失败: %s
执行setsockopt(TCP_KEEPINTVL)失败: %s
无效的 sslmode 值 "%s" 当没有把 SSL 支持编译进来时
声明名字是一个空指针
在服务文件"%s"的第%d行出现语法错误
超时满
意外的 asyncStatus(异步状态): %d
非预期的字符"%c"出现在在位置%d, URI (expected ":" or "/"):"%s"
unexpected character %c following empty query response ("I" message) 在 "D" 消息中, 意外的字段个数 启动过程中收到来自服务器的非预期信息
来自服务器意外的回执, 第一个收到的字符是 "%c"
未知的 SSL 错误码: %d
不可识别的套接字错误: 0x%08X/%d 联接信息字串中未结束的引号字串
用户名查找失败：错误代码%lu
locale/zh_CN/LC_MESSAGES/pg_basebackup-9.6.mo 0000644 00000063407 14751153421 0014243 0 ustar 00 �� � � � P Q k � � ! �
� - � X T \ R � ` I e D � � 3 K : < � j � > . N m @ � 3 � V 1 > � 1 � j � < d ? � M � k / J � Y � + @ 0 l B � B � * # 8 N � � 5 � L r � o G 1 � 3 � K - i F � \ � P ; 2 � 4 � 8 � 1 - 4 _ 1 � . � @ � 1 6 E h B � 7 � )! ( I! ' r! & �! ; �! ( �! - &" ' T" " |" �" # �" 2 �" , # + D# . p# ( �# # �# 5 �# f "$ , �$ 9 �$ 4 �$ 7 %% = ]% d �% A & " B& & e& & �& # �& / �& > ' a F' & �' & �' % �' 2 ( 1 O( 0 �( 8 �( ( �( 2 ) G) & h) ' �) . �) + �) # * A 6* 2 x* & �* & �* / �* + )+ 4 U+ / �+ ! �+ 1 �+ ) , ( 8, 2 a, 2 �, 3 �, 0 �, % ,- # R- + v- �- �- 2 �- # . (. , E. , r. # �. i �. i -/ 9 �/ " �/ A �/ # 60 Z0 9 {0 �0 �0 ! �0 D 1 & Q1 # x1 A �1 - �1 D 2 ! Q2 s2 �2 " �2 �2 9 �2 1 3 D R3 , �3 �3 ' �3 D �3 M D4 : �4 8 �4 6 5 =5 E V5 G �5 z �5 c _6 % �6 . �6 2 7 6 K7 # �7 �7 % �7 0 �7 R 8 , i8 4 �8 K �8 @ 9 > X9 - �9 , �9 ' �9 , : o G: k �: 4 #; % X; ( ~; ; �;
�; & �; < / < M< / \< � �< Q> j> z> �> �> �> . �> L �> H ;? V �? S �? > /@ ; n@ �@ 4 �@ > �@ : 0A y kA O �A G 5B B }B , �B f �B 1 TC / �C m �C A $D : fD G �D k �D P UE ` �E ( F 5 0F H fF G �F , �F > $G } cG 5 �G � H q �H q I / �I 5 �I L �I 8 9J ! rJ , �J & �J ' �J ( K : 9K ) tK 2 �K / �K L J "L = mL Z �L W M 5 ^M , �M �M & �M & N 9 0N jN & �N �N �N �N " O - 5O ! cO ! �O & �O �O �O * P L ;P & �P 5 �P / �P / Q 7 EQ L }Q 0 �Q . �Q * *R # UR yR * �R > �R U S WS xS % �S 0 �S , �S , T 0 JT ! {T + �T �T �T * U ) 6U . `U # �U ; �U * �U # V >V % \V $ �V & �V / �V ! �V , W MW lW 2 �W 3 �W , �W ( X HX fX * �X �X �X 2 �X
Y #Y , >Y 2 kY & �Y ` �Y ` &Z : �Z & �Z C �Z # -[ . Q[ A �[ �[ �[ # �[ Q \ ' j\ ! �\ J �\ 1 �\ G 1] y] �] �] �] �] 8 ^ ) ?^ G i^ , �^ �^ ( �^ H _ C b_ / �_ , �_ 2 ` 6` D O` I �` p �` w Oa " �a * �a B b ) Xb �b �b $ �b - �b 8
c & Cc . jc > �c 5 �c S d + bd * �d # �d �d i �d _ fe �e ( �e
f ) .f Xf * af �f % �f
�f 7 �f � * � � o C $ e [ ] � j ? � � � � f � - R � � � � O < � s � } 2 B � p c { ; N 7 � � ) @ + Y � � � � � z & T J h � H G K ~ � t w X v � � � 9 � = � � . / � k 5 A U � � � q � � _ � � 6 � E
Z � S I , � � d # x � � Q y l P � � i � � u ^ � > � � V
� 0 n � ( � � \ : � � r � � � � 4 � g � M " 3 1 � D m � 8 a � � b F � % W � � � � ! � � | ` L � � � ' �
Action to be performed:
Connection options:
General options:
Optional actions:
Options controlling the output:
Options:
Report bugs to <pgsql-bugs@postgresql.org>.
--create-slot create a new replication slot (for the slot's name see --slot)
--drop-slot drop the replication slot (for the slot's name see --slot)
--if-not-exists do not error if slot already exists when creating a slot
--start start streaming in a replication slot (for the slot's name see --slot)
--synchronous flush transaction log immediately after writing
--xlogdir=XLOGDIR location for the transaction log directory
%s [OPTION]...
-?, --help show this help, then exit
-D, --directory=DIR receive transaction log files into this directory
-D, --pgdata=DIRECTORY receive base backup into directory
-F --fsync-interval=SECS
time between fsyncs to the output file (default: %d)
-F, --format=p|t output format (plain (default), tar)
-I, --startpos=LSN where in an existing slot should the streaming start
-P, --plugin=PLUGIN use output plugin PLUGIN (default: %s)
-P, --progress show progress information
-R, --write-recovery-conf
write recovery.conf after backup
-S, --slot=SLOTNAME name of the logical replication slot
-S, --slot=SLOTNAME replication slot to use
-T, --tablespace-mapping=OLDDIR=NEWDIR
relocate tablespace in OLDDIR to NEWDIR
-U, --username=NAME connect as specified database user
-V, --version output version information, then exit
-W, --password force password prompt (should happen automatically)
-X, --xlog-method=fetch|stream
include required WAL files with specified method
-Z, --compress=0-9 compress tar output with given compression level
-c, --checkpoint=fast|spread
set fast or spread checkpointing
-d, --dbname=CONNSTR connection string
-d, --dbname=DBNAME database to connect to
-f, --file=FILE receive log into this file, - for stdout
-h, --host=HOSTNAME database server host or socket directory
-l, --label=LABEL set backup label
-n, --no-loop do not loop on connection lost
-o, --option=NAME[=VALUE]
pass option NAME with optional value VALUE to the
output plugin
-p, --port=PORT database server port number
-r, --max-rate=RATE maximum transfer rate to transfer data directory
(in kB/s, or use suffix "k" or "M")
-s, --status-interval=INTERVAL
time between status packets sent to server (in seconds)
-s, --status-interval=SECS
time between status packets sent to server (default: %d)
-v, --verbose output verbose messages
-w, --no-password never prompt for password
-x, --xlog include required WAL files in backup (fetch mode)
-z, --gzip compress tar output
%*s/%s kB (%d%%), %d/%d tablespace %*s/%s kB (%d%%), %d/%d tablespaces %*s/%s kB (%d%%), %d/%d tablespace (%s%-*.*s) %*s/%s kB (%d%%), %d/%d tablespaces (%s%-*.*s) %*s/%s kB (100%%), %d/%d tablespace %*s %*s/%s kB (100%%), %d/%d tablespaces %*s %s controls PostgreSQL logical decoding streams.
%s receives PostgreSQL streaming transaction logs.
%s takes a base backup of a running PostgreSQL server.
%s: %s needs a slot to be specified using --slot
%s: COPY stream ended before last file was finished
%s: WAL streaming can only be used in plain mode
%s: at least one action needs to be specified
%s: can only write single tablespace to stdout, database has %d
%s: cannot specify both --xlog and --xlog-method
%s: cannot use --create-slot or --drop-slot together with --startpos
%s: cannot use --create-slot or --start together with --drop-slot
%s: cannot use --create-slot together with --drop-slot
%s: child %d died, expected %d
%s: child process did not exit normally
%s: child process exited with error %d
%s: child thread exited with error %u
%s: confirming write up to %X/%X, flush to %X/%X (slot %s)
%s: could not access directory "%s": %s
%s: could not close compressed file "%s": %s
%s: could not close directory "%s": %s
%s: could not close file "%s": %s
%s: could not connect to server
%s: could not connect to server: %s %s: could not create archive status file "%s": %s
%s: could not create background process: %s
%s: could not create background thread: %s
%s: could not create compressed file "%s": %s
%s: could not create directory "%s": %s
%s: could not create file "%s": %s
%s: could not create pipe for background process: %s
%s: could not create replication slot "%s": got %d rows and %d fields, expected %d rows and %d fields
%s: could not create symbolic link "%s": %s
%s: could not create symbolic link from "%s" to "%s": %s
%s: could not create timeline history file "%s": %s
%s: could not determine seek position in file "%s": %s
%s: could not determine server setting for integer_datetimes
%s: could not drop replication slot "%s": got %d rows and %d fields, expected %d rows and %d fields
%s: could not establish database-specific replication connection
%s: could not fsync file "%s": %s
%s: could not fsync log file "%s": %s
%s: could not get COPY data stream: %s %s: could not get backup header: %s %s: could not get child thread exit status: %s
%s: could not get transaction log end position from server: %s %s: could not identify system: got %d rows and %d fields, expected %d rows and %d or more fields
%s: could not initiate base backup: %s %s: could not open directory "%s": %s
%s: could not open log file "%s": %s
%s: could not open timeline history file "%s": %s
%s: could not open transaction log file "%s": %s
%s: could not pad transaction log file "%s": %s
%s: could not parse next timeline's starting point "%s"
%s: could not parse start position "%s"
%s: could not parse transaction log location "%s"
%s: could not read COPY data: %s %s: could not read directory "%s": %s
%s: could not read from ready pipe: %s
%s: could not receive data from WAL stream: %s %s: could not rename file "%s" to "%s": %s
%s: could not rename file "%s": %s
%s: could not seek to beginning of transaction log file "%s": %s
%s: could not send command to background pipe: %s
%s: could not send copy-end packet: %s %s: could not send feedback packet: %s %s: could not send replication command "%s": %s %s: could not set compression level %d: %s
%s: could not set permissions on directory "%s": %s
%s: could not set permissions on file "%s": %s
%s: could not stat file "%s": %s
%s: could not stat transaction log file "%s": %s
%s: could not wait for child process: %s
%s: could not wait for child thread: %s
%s: could not write %u bytes to WAL file "%s": %s
%s: could not write %u bytes to log file "%s": %s
%s: could not write timeline history file "%s": %s
%s: could not write to compressed file "%s": %s
%s: could not write to file "%s": %s
%s: creating replication slot "%s"
%s: directory "%s" exists but is not empty
%s: directory name too long
%s: disconnected
%s: disconnected; waiting %d seconds to try again
%s: dropping replication slot "%s"
%s: final receive failed: %s %s: finished segment at %X/%X (timeline %u)
%s: got WAL data offset %08x, expected %08x
%s: incompatible server version %s
%s: incompatible server version %s; client does not support streaming from server versions newer than %s
%s: incompatible server version %s; client does not support streaming from server versions older than %s
%s: integer_datetimes compile flag does not match server
%s: invalid --max-rate unit: "%s"
%s: invalid checkpoint argument "%s", must be "fast" or "spread"
%s: invalid compression level "%s"
%s: invalid fsync interval "%s"
%s: invalid output format "%s", must be "plain" or "tar"
%s: invalid port number "%s"
%s: invalid socket: %s %s: invalid status interval "%s"
%s: invalid tablespace mapping format "%s", must be "OLDDIR=NEWDIR"
%s: invalid tar block header size: %d
%s: invalid transfer rate "%s": %s
%s: invalid xlog-method option "%s", must be "fetch" or "stream"
%s: multiple "=" signs in tablespace mapping
%s: new directory is not an absolute path in tablespace mapping: %s
%s: no data returned from server
%s: no database specified
%s: no slot specified
%s: no target directory specified
%s: no target file specified
%s: no transaction log end position returned from server
%s: not renaming "%s%s", segment is not complete
%s: old directory is not an absolute path in tablespace mapping: %s
%s: only tar mode backups can be compressed
%s: out of memory
%s: received interrupt signal, exiting
%s: received transaction log record for offset %u with no file open
%s: replication connection using slot "%s" is unexpectedly database specific
%s: replication slots can only be used with WAL streaming
%s: replication stream was terminated before stop point
%s: segment file "%s" has incorrect size %d, skipping
%s: select() failed: %s
%s: server reported unexpected history file name for timeline %u: %s
%s: server reported unexpected next timeline %u, following timeline %u
%s: server returned unexpected response to BASE_BACKUP command; got %d rows and %d fields, expected %d rows and %d fields
%s: server stopped streaming timeline %u at %X/%X, but reported next timeline %u to begin at %X/%X
%s: starting background WAL receiver
%s: starting log streaming at %X/%X (slot %s)
%s: starting log streaming at %X/%X (timeline %u)
%s: starting timeline %u is not present in the server
%s: streaming header too small: %d
%s: streaming initiated
%s: switched to timeline %u at %X/%X
%s: symlinks are not supported on this platform
%s: system identifier does not match between base backup and streaming connection
%s: this build does not support compression
%s: too many command-line arguments (first is "%s")
%s: transaction log directory location can only be specified in plain mode
%s: transaction log directory location must be an absolute path
%s: transaction log file "%s" has %d bytes, should be 0 or %d
%s: transfer rate "%s" exceeds integer range
%s: transfer rate "%s" is not a valid value
%s: transfer rate "%s" is out of range
%s: transfer rate must be greater than zero
%s: unexpected response to TIMELINE_HISTORY command: got %d rows and %d fields, expected %d rows and %d fields
%s: unexpected result set after end-of-timeline: got %d rows and %d fields, expected %d rows and %d fields
%s: unexpected termination of replication stream: %s %s: unrecognized link indicator "%c"
%s: unrecognized streaming header: "%c"
%s: waiting for background process to finish streaming ...
Password: Try "%s --help" for more information.
Usage:
cannot duplicate null pointer (internal error)
out of memory
transaction log start point: %s on timeline %u
Project-Id-Version: pg_basebackup (PostgreSQL) 9.2
Report-Msgid-Bugs-To: pgsql-bugs@postgresql.org
POT-Creation-Date: 2016-04-18 04:44+0000
PO-Revision-Date: 2016-05-19 20:40+0800
Last-Translator: Yuwei Peng <ywpeng@whu.edu.cn>
Language-Team: Chinese (Simplified) <ywpeng@whu.edu.cn>
Language: zh_CN
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Plural-Forms: nplurals=1; plural=0;
X-Generator: Poedit 1.5.7
即将执行的动作:
联接选项:
一般选项:
可选动作：
控制输出的选项:
选项:
错误报告至 <pgsql-bugs@postgresql.org>.
--create-slot 创建新的复制槽(槽名请参考选项 --slot)
--drop-slot 删除复制槽 (槽名请参考选项 --slot)
--if-not-exists 在创建一个槽时如果槽已经存在则不产生错误
--start 复制槽中启动流复制(槽名请参考选项 --slot)
--synchronous 在写入后立即刷写事务日志
--xlogdir=XLOGDIR 当前事务日志目录的位置
%s [选项]...
-?, --help 显示帮助, 然后退出
-D, --directory=DIR 接收事务日志到指定的目录
-D, --pgdata=DIRECTORY 接收基础备份到指定目录
-F --fsync-interval=SECS
写往输出文件的文件同步的时间间隔 (默认值为: %d)
-F, --format=p|t 输出格式 (纯文本 (缺省值), tar压缩格式)
-I, --startpos=LSN 在当前槽中流复制启动的起始位置
-P, --plugin=PLUGIN 使用输出插件PLUGIN (默认为: %s)
-P, --progress 显示进度信息
-R, --write-recovery-conf
备份后对文件recovery.conf进行写操作
-S, --slot=SLOTNAME 逻辑复制槽的名字
-S, --slot=SLOTNAME 用于复制的槽名
-T, --tablespace-mapping=OLDDIR=NEWDIR
将表空间由 OLDDIR 重定位到 NEWDIR
-U, --username=NAME 指定连接所需的数据库用户名
-V, --version 输出版本信息, 然后退出
-W, --password 强制提示输入密码 (应该自动发生)
-X, --xlog-method=fetch|stream
按指定的模式包含必需的WAL日志文件
-Z, --compress=0-9 按给定的压缩级别对tar文件进行压缩输出
-c, --checkpoint=fast|spread
设置检查点方式(fast或者spread)
-d, --dbname=CONNSTR 连接串
-d, --dbname=DBNAME 要连接的目标数据库
-f, --file=FILE 接收日志到这个文件, - 为标准输出
-h, --host=HOSTNAME 数据库服务器主机或者是socket目录
-l, --label=LABEL 设置备份标签
-n, --no-loop 连接丢失时不进行循环处理
-o, --option=NAME[=VALUE]
选项NAME附带可选值VALUE给
输出插件
-p, --port=PORT 数据库服务器端口号
-r, --max-rate=RATE 传输数据目录的最大传输速率
(单位 kB/s, 也可以使用后缀"k" 或 "M")
-s, --status-interval=INTERVAL
发往服务器的状态包的时间间隔 (以秒计)
-s, --status-interval=SECS
发往服务器的状态包的时间间隔 (默认为: %d)
-v, --verbose 输出详细的消息
-w, --no-password 禁用输入密码的提示
-x, --xlog 在备份中包含必需的WAL文件(fetch 模式)
-z, --gzip 对tar文件进行压缩输出
%*s/%s kB (%d%%), %d/%d 表空间 %*s/%s kB (%d%%), %d/%d 表空间 (%s%-*.*s) %*s/%s kB (100%%), %d/%d 表空间 %*s %s 控制PostgreSQL逻辑解码流。
%s 接收PostgreSQL的流事务日志.
%s 在运行的PostgreSQL服务器上执行基础备份.
%s：%s需要使用--slot指定一个槽
%s: 复制流在最后一个文件结束前终止
%s: WAL 流操作只能在plain模式下使用
%s: 至少要指定一个操作
%s: 只能把表空间写往标准输出, 数据库拥有标准输出: %d
%s: 不能同时指定两个选项: --xlog and --xlog-method
%s: 不能使用 --create-slot 选项或 同时使用--drop-slot和--startpos两个选项
%s: 不能使用 --create-slot 选项或 同时使用--start和--drop-slot两个选项
%s: 不能把--create-slot和--drop-slot一起使用
%s: 子进程 %d 已终止, 期望值为 %d
%s: 子进程没有正常退出
%s: 子进程退出, 错误码为: %d
%s: 子线程退出, 错误码为: %u
%s: 确认上写至%X/%X, 并刷写回至 %X/%X (槽 %s)
%s: 无法访问目录 "%s": %s
%s: 无法关闭压缩文件 "%s": %s
%s: 无法关闭目录 "%s": %s
%s: 无法关闭文件 "%s": %s
%s: 无法连接到服务器
%s：无法连接到服务器：%s %s：无法创建归档状态文件"%s"：%s
%s: 无法创建后台进程: %s
%s: 无法创建后台线程: %s
%s: 无法创建压缩文件 "%s": %s
%s: 无法创建目录 "%s": %s
%s: 无法创建文件 "%s": %s
%s: 无法为后台进程: %s创建管道
%s: 无法创建复制槽 "%s": 得到%d行%d列, 但期望值为%d行%d列
%s: 无法创建符号链接 "%s": %s
%s: 无法创建从 "%s" 到 "%s"的符号链接: %s
%s: 无法创建时间表历史文件 "%s": %s
%s: 无法确定文件 "%s"的当前位置: %s
%s: 无法确定服务器上integer_datetimes的配置
%s: 无法删除复制槽 "%s": 得到%d行%d列, 但期望值为%d行%d列
%s：无法建立数据库相关的复制连接
%s: 无法对文件 "%s"进行fsync同步: %s
%s: 无法fsync同步日志文件"%s": %s
%s: 无法得到复制数据流: %s %s: 无法得到备份头: %s %s: 无法得到子线程退出状态: %s
%s: 无法得到来自服务器的事务日志终止位置: %s %s: 无法识别系统: 得到%d行和%d列, 期望值为: %d行和%d列或更多列
%s: 无法发起基础备份: %s %s: 无法打开目录 "%s": %s
%s：无法开启日志档 "%s"：%s
%s：无法打开时间表历史文件"%s"：%s
%s: 无法打开事务日志文件 "%s": %s
%s: 无法填充事务日志文件 "%s": %s
%s: 无法解析下次时间表的起始点"%s"
%s: 无法解析起始位置"%s"
%s: 无法解析来自 "%s"的事务日志
%s: 无法读取复制数据: %s %s: 无法读取目录 "%s": %s
%s: 无法从准备就绪的管道: %s读
%s: 无法接收来自WAL流的数据: %s %s: 无法将文件 "%s" 重命名为 "%s":%s
%s: 无法重命名文件 "%s": %s
%s: 无法定位事务日志文件 "%s"的开始位置: %s
%s: 无法发送命令到后台管道: %s
%s: 无法发送副本结束包: %s %s: 无法发送回馈包: %s %s: 无法发送复制命令 "%s": %s %s: 无法设置压缩级别 %d: %s
%s: 无法设置目录权限 "%s": %s
%s: 无法设置文件 "%s"的访问权限: %s
%s: 无法统计文件: "%s": %s
%s: 无法统计事务日志文件 "%s": %s
%s: 无法等待子进程: %s
%s: 无法等待子线程: %s
%s: 无法写入 %u 字节到 WAL 文件 "%s": %s
%s: 无法写入 %u 字节到日志文件 "%s": %s
%s: 无法写时间表历史文件 "%s": %s
%s: 无法往压缩文件里写"%s": %s
%s: 无法写文件 "%s": %s
%s: 创建复制槽 "%s"
%s: 目录"%s"已存在，但不是空的
字典名: "%s"太长
%s: 连接已断开
%s: 连接已断开, 将于%d 秒后尝试重连.
%s: 删除复制槽"%s"
%s: 最终接收失败: %s %s: finished segment at %X/%X (timeline %u)
%s: 得到WAL数据偏移 %08x, 期望值为 %08x
%s: 不兼容的服务器版本号 %s
%s: 不兼容的服务器版本号 %s; 当服务器版本高于%s时客户端不支持流复制
%s: 不兼容的服务器版本号 %s; 当服务器版本低于%s时客户端不支持流复制
%s: integer_datetimes编译开关与服务器端不匹配
%s: 无效的 --max-rate 单位: "%s"
%s: 无效的检查点参数: "%s", 必须是: "fast" 或 "spread"
%s: 无效的压缩级别值: "%s"
%s: 无效的fsync同步时间间隔值: "%s"
%s: 无效输出格式: "%s", 有效值为: "plain" 或者 "tar"
%s: 无效端口号 "%s"
%s: 无效套接字: %s %s: 无效的状态间隔值: "%s"
%s: 无效表空间映射表格式: "%s", 有效格式必须为: "OLDDIR=NEWDIR"
%s: 无效的tar压缩块头大小: %d
%s:无效的传输速率"%s": %s
%s: 无效的xlog-method 选项: "%s", 必须是: "fetch" 或者 "stream"
%s: 多个 "=" 号出现在表空间的映射中
%s:: 在表空间映射表：%s中的新目录不是一个绝对路径
%s: 服务器没有数据返回
%s: 没有指定数据库
%s: 没有指定槽
%s: 没有指定目标目录
%s: 没有指定目标文件
%s: 服务器端没有返回事务日志的终止位置
%s: 没有重命名 "%s%s", 段不完整
%s:: 在表空间映射表：%s中的旧目录不是一个绝对路径
%s: 只有tar模式备份才能进行压缩
%s: 内存溢出
%s: 接收到终断信号, 正在退出
%s: 偏移位置 %u 处接收到的事务日志记录没有打开文件
%s：使用槽"%s"的复制连接意外地不是指定的数据库
%s: 复制槽只能和WAL流复制一起使用
%s: 流复制在停止点之前异常终止
%s: 段文件 "%s" 大小值: %d不正确, 跳过
%s: select() 失败: %s
%s: 服务器为时间表报告生成的意外历史文件名 %u:%s
%s: 服务器报出的下次意外时间表 %u, 紧跟时间表 %u之后
%s: 服务器对BASE_BACKUP命令返回意外的响应; 得到 %d 行和 %d 列, 期望值为: %d 行和 %d 列
%1$s: 服务器在%3$X/%4$X时停止流操作时间表%2$u, 但是报出将在%6$X/%7$X时开始下一个时间表%5$u
%s: 启动后台 WAL 接收进程
%s:在%X/%X (槽 %s)位置启动日志流
%s: 在时间点: %X/%X (时间安排%u)启动日志的流操作
%s: 服务器上没有起始时间表 %u
%s: 流头大小: %d 值太小
%s: 流已初始化
%s: 切换到时间表 %u 在 %X/%X
%s：在这个平台上不支持符号链接
%s: 基础备份和流连接的系统标识符不匹配
%s: 这个编译版本不支持压缩
%s: 命令行参数太多 (第一个是 "%s")
%s: 事务日志目录的位置只能在简单模式里指定
%s: 事务日志目录的位置必须为绝对路径
%s: 事务日志文件 "%s" 大小为 %d 字节, 正确值应该是 0 或 %d字节
%s:传输速率 "%s" 超出了整数范围
%s: 传输速率"%s"不是一个有效值
%s: 传输速率 "%s" 超出范围
%s: 传输速率必须大于0
%s: 获得命令TIMELINE_HISTORY的意外响应: 得到 %d 行和 %d 列, 期望值为: %d 行和 %d 列
%s: 终点时间表的意外结果集: 得到 %d 行和 %d 列, 期望值为: %d 行和 %d 列
%s: 流复制异常终止: %s %s: 无法识别的链接标识符 "%c"
%s: 无法识别的流头: "%c"
%s: 等待后台进程结束流操作...
口令: 请用 "%s --help" 获取更多的信息.
使用方法:
无法复制空指针 (内部错误)
内存溢出
事务日志起始于时间点: %s, 基于时间表%u
locale/zh_CN/LC_MESSAGES/pgscripts-9.6.mo 0000644 00000061056 14751153421 0013471 0 ustar 00 �� � | � 0 K 1 }
� > � > � = - Z � � C A d � � # � � ( 9 I V E � � > f ; � = � : < Z 9 � 6 � 5 C > C � 9 � 4 E 5 = { . � ; � E $ : j ? � A � < ' 9 d 7 � 4 � L J X 3 � H � E B f A � 5 � 2 ! N T 7 � 2 � 2 J A : � 5 � G � 0 E < v 0 � ) � M J \ G � 4 � C $! H h! E �! D �! = <" v z" < �" � .# Q �# I $ @ N$ 5 �$ 4 �$ 1 �$ 0 ,% ; ]% 5 �% ' �% 6 �% 3 .& 4 b& @ �& ; �& ; ' ` P' 8 �' 2 �' 9 ( 6 W( > �( �( / �( < ) # F) # j) ? �) 8 �) % * # -* Q* 3 q* & �* �* E �* 6 + E P+ F �+ K �+ 7 ), K a, 7 �, J �, 6 0- < g- D �- 5 �- . * =. 8 h. 6 �. ( �. 4 / $ 6/ # [/ / �/ �/ 8 �/ 4 0 $ E0 j0 , �0 , �0 ( �0 /
1 ; =1 9 y1 ! �1 �1 �1 �1 * 2 8 F2 9 2 , �2 8 �2 # 3 4 C3 3 x3 �3 ) �3 7 �3 +4
@4 N4 C c4 A �4 ! �4 + 5 75 H5 d5 �5 . �5 3 �5 2 6 56 B6 G6
d6 o6 �6 �6 ' �6 " �6 2 7 7 87 p7 & y7 �7 �7 / �7 + �7 * 8 F8 H8 K8 W8 d8 s8 �8 �8 ( �8 �8 �8 � �8 > �: �: �: L �: H =; K �; . �; � < < �< : �< = (= - G= u= , �= �= G �= C )> s m> 5 �> 2 ? 5 J? 2 �? F �? = �? : 8@ 9 s@ I �@ 8 �@ / 0A / `A > �A 2 �A / B 2 2B ; eB 5 �B R �B ? *C ; jC ; �C 2 �C / D G ED G �D / �D C E @ IE = �E < �E 7 F 5 =F T sF ; �F 5 G G :G H �G > �G 9
H 8 DH 7 }H 8 �H J �H $ 9I D ^I A �I > �I / $J G TJ \ �J Y �J O SK 9 �K p �K A NL � �L J M G fM ; �M B �M ; -N 8 iN 5 �N 5 �N / O ) >O ? hO 4 �O > �O 8 P 5 UP A �P ` �P 5 .Q 5 dQ : �Q 8 �Q 8 R GR 3 SR B �R ' �R * �R 6 S > TS 6 �S ' �S $ �S - T + ET qT D xT 8 �T S �T J JU G �U > �U E V G bV G �V D �V : 7W D rW ; �W # �W # X = ;X / yX # �X 0 �X �X Y :Y XY vY 7 �Y 6 �Y �Y Z & 3Z & ZZ # �Z + �Z = �Z ; [ K[ j[ [ ) �[ 3 �[ B �[ F 3\ / z\ K �\ �\ 1 ] 2 I] |] # �] = �] �] ^ ^ ? 4^ > t^ �^ & �^ �^ _ *_ H_ # f_ ( �_ ) �_
�_ �_ �_ `
` ` 6` C` " d` % �` , �`
�` * �` a
"a % 0a + Va ( �a �a �a
�a
�a
�a
�a �a �a ' b (b *b � � 9 � � t � � � I S � w & % � � � � G � � - . � � X � { � " � 7 � o � � < � � � L � 4 / K i u � J � ~ B m ( � � � � * �
n f H p � # D g @ ' > � � U � v � x [ � 3
N � � k ! � 8 , � Y F ; � z � � Z � T � � 6 r M � + a 2 W � � $ ] _ � � } = s � j � � ? � ` � c | � l \ V � � � � � E ) : q � � Q C b 1 0 h A y � d R ^ O � � � � � � 5 � � � e P
By default, a database with the same name as the current user is created.
Connection options:
Options:
Read the description of the SQL command CLUSTER for details.
Read the description of the SQL command REINDEX for details.
Read the description of the SQL command VACUUM for details.
Report bugs to <pgsql-bugs@postgresql.org>.
--analyze-in-stages only update optimizer statistics, in multiple
stages for faster results; no vacuum
--lc-collate=LOCALE LC_COLLATE setting for the database
--lc-ctype=LOCALE LC_CTYPE setting for the database
%s [OPTION]...
%s [OPTION]... DBNAME
%s [OPTION]... LANGNAME [DBNAME]
%s [OPTION]... [DBNAME]
%s [OPTION]... [DBNAME] [DESCRIPTION]
%s [OPTION]... [ROLENAME]
--if-exists don't report error if database doesn't exist
--if-exists don't report error if user doesn't exist
--interactive prompt for missing role name and attributes rather
than using defaults
--maintenance-db=DBNAME alternate maintenance database
--maintenance-db=DBNAME alternate maintenance database
--no-replication role cannot initiate replication
--replication role can initiate replication
-?, --help show this help, then exit
-?, --help show this help, then exit
-?, --help show this help, then exit
-?, --help show this help, then exit
-D, --no-createdb role cannot create databases (default)
-D, --tablespace=TABLESPACE default tablespace for the database
-E, --encoding=ENCODING encoding for the database
-E, --encrypted encrypt stored password
-F, --freeze freeze row transaction information
-I, --no-inherit role does not inherit privileges
-L, --no-login role cannot login
-N, --unencrypted do not encrypt stored password
-O, --owner=OWNER database user to own the new database
-P, --pwprompt assign a password to new role
-R, --no-createrole role cannot create roles (default)
-S, --no-superuser role will not be superuser (default)
-S, --schema=SCHEMA reindex specific schema(s) only
-T, --template=TEMPLATE template database to copy
-U, --username=USERNAME user name to connect as
-U, --username=USERNAME user name to connect as
-U, --username=USERNAME user name to connect as (not the one to create)
-U, --username=USERNAME user name to connect as (not the one to drop)
-U, --username=USERNAME user name to connect as
-V, --version output version information, then exit
-V, --version output version information, then exit
-V, --version output version information, then exit
-V, --version output version information, then exit
-W, --password force password prompt
-W, --password force password prompt
-Z, --analyze-only only update optimizer statistics; no vacuum
-a, --all vacuum all databases
-a, --all cluster all databases
-a, --all reindex all databases
-c, --connection-limit=N connection limit for role (default: no limit)
-d, --createdb role can create new databases
-d, --dbname=DBNAME database to vacuum
-d, --dbname=DBNAME database from which to remove the language
-d, --dbname=DBNAME database to cluster
-d, --dbname=DBNAME database to install language in
-d, --dbname=DBNAME database to reindex
-d, --dbname=DBNAME database name
-e, --echo show the commands being sent to the server
-e, --echo show the commands being sent to the server
-e, --echo show the commands being sent to the server
-f, --full do full vacuuming
-g, --role=ROLE new role will be a member of this role
-h, --host=HOSTNAME database server host or socket directory
-h, --host=HOSTNAME database server host or socket directory
-h, --host=HOSTNAME database server host or socket directory
-i, --index=INDEX recreate specific index(es) only
-i, --inherit role inherits privileges of roles it is a
member of (default)
-i, --interactive prompt before deleting anything
-i, --interactive prompt before deleting anything, and prompt for
role name if not specified
-j, --jobs=NUM use this many concurrent connections to vacuum
-l, --list show a list of currently installed languages
-l, --locale=LOCALE locale settings for the database
-l, --login role can login (default)
-p, --port=PORT database server port
-p, --port=PORT database server port
-p, --port=PORT database server port
-q, --quiet don't write any messages
-q, --quiet don't write any messages
-q, --quiet run quietly
-r, --createrole role can create new roles
-s, --superuser role will be superuser
-s, --system reindex system catalogs
-t, --table='TABLE[(COLUMNS)]' vacuum specific table(s) only
-t, --table=TABLE cluster specific table(s) only
-t, --table=TABLE reindex specific table(s) only
-t, --timeout=SECS seconds to wait when attempting connection, 0 disables (default: %s)
-v, --verbose write a lot of output
-v, --verbose write a lot of output
-w, --no-password never prompt for password
-w, --no-password never prompt for password
-z, --analyze update optimizer statistics
%s (%s/%s) %s cleans and analyzes a PostgreSQL database.
%s clusters all previously clustered tables in a database.
%s creates a PostgreSQL database.
%s creates a new PostgreSQL role.
%s installs a procedural language into a PostgreSQL database.
%s issues a connection check to a PostgreSQL database.
%s reindexes a PostgreSQL database.
%s removes a PostgreSQL database.
%s removes a PostgreSQL role.
%s removes a procedural language from a database.
%s: "%s" is not a valid encoding name
%s: %s %s: cannot cluster all databases and a specific one at the same time
%s: cannot cluster specific table(s) in all databases
%s: cannot reindex all databases and a specific one at the same time
%s: cannot reindex all databases and system catalogs at the same time
%s: cannot reindex specific index(es) and system catalogs at the same time
%s: cannot reindex specific index(es) in all databases
%s: cannot reindex specific schema(s) and system catalogs at the same time
%s: cannot reindex specific schema(s) in all databases
%s: cannot reindex specific table(s) and system catalogs at the same time
%s: cannot reindex specific table(s) in all databases
%s: cannot use the "%s" option when performing only analyze
%s: cannot vacuum all databases and a specific one at the same time
%s: cannot vacuum specific table(s) in all databases
%s: clustering database "%s"
%s: clustering of database "%s" failed: %s %s: clustering of table "%s" in database "%s" failed: %s %s: comment creation failed (database was created): %s %s: could not connect to database %s: %s %s: could not connect to database %s: out of memory
%s: could not fetch default options
%s: creation of new role failed: %s %s: database creation failed: %s %s: database removal failed: %s %s: invalid socket: %s %s: language "%s" is already installed in database "%s"
%s: language "%s" is not installed in database "%s"
%s: language installation failed: %s %s: language removal failed: %s %s: missing required argument database name
%s: missing required argument language name
%s: missing required argument role name
%s: number of parallel jobs must be at least 1
%s: only one of --locale and --lc-collate can be specified
%s: only one of --locale and --lc-ctype can be specified
%s: processing database "%s": %s
%s: query failed: %s %s: query was: %s
%s: reindexing database "%s"
%s: reindexing of database "%s" failed: %s %s: reindexing of index "%s" in database "%s" failed: %s %s: reindexing of schema "%s" in database "%s" failed: %s %s: reindexing of system catalogs failed: %s %s: reindexing of table "%s" in database "%s" failed: %s %s: removal of role "%s" failed: %s %s: too many command-line arguments (first is "%s")
%s: too many parallel jobs requested (maximum: %d)
%s: vacuuming database "%s"
%s: vacuuming of database "%s" failed: %s %s: vacuuming of table "%s" in database "%s" failed: %s (%lu row) (%lu rows) Are you sure? Cancel request sent
Cannot add cell to table content: total cell count of %d exceeded.
Cannot add header to table content: column count of %d exceeded.
Could not send cancel request: %s Database "%s" will be permanently removed.
Enter it again: Enter name of role to add: Enter name of role to drop: Enter password for new role: Generating default (full) optimizer statistics Generating medium optimizer statistics (10 targets) Generating minimal optimizer statistics (1 target) Interrupted
Name Password encryption failed.
Password: Passwords didn't match.
Please answer "%s" or "%s".
Procedural Languages Role "%s" will be permanently removed.
Shall the new role be a superuser? Shall the new role be allowed to create databases? Shall the new role be allowed to create more new roles? Trusted? Try "%s --help" for more information.
Usage:
accepting connections
cannot duplicate null pointer (internal error)
could not look up effective user ID %ld: %s invalid output format (internal error): %d n no no attempt
no response
out of memory
rejecting connections
unknown
user does not exist user name lookup failure: error code %lu y yes Project-Id-Version: pgscripts (PostgreSQL 9.0)
Report-Msgid-Bugs-To: pgsql-bugs@postgresql.org
POT-Creation-Date: 2016-04-18 04:44+0000
PO-Revision-Date: 2016-05-19 20:42+0800
Last-Translator: Yuwei Peng <ywpeng@whu.edu.cn>
Language-Team: Chinese (Simplified) <ywpeng@whu.edu.cn>
Language: zh_CN
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
X-Generator: Poedit 1.5.7
Plural-Forms: nplurals=1; plural=0;
默认情况下, 以当前用户的用户名创建数据库.
联接选项:
选项:
阅读 SQL 命令 CLUSTER 的描述信息, 以便获得更详细的信息.
阅读SQL命令REINDEX的描述信息, 以便获得更详细的信息.
阅读 SQL 命令 VACUUM 的描述信息, 以便获得更详细的信息.
臭虫报告至 <pgsql-bugs@postgresql.org>.
--analyze-in-stages 只更新优化器统计, 为了更快得到结果分多阶段；
不做清理
--lc-collate=LOCALE 数据库的LC_COLLATE设置
--lc-ctype=LOCALE 数据库的LC_CTYPE设置
%s [选项]...
%s [选项]... 数据库名
%s [选项]... 语言名称 [数据库名]
%s [选项]... [数据库名]
%s [选项]... [数据库名称] [描述]
%s [选项]... [用户名]
--if-exists 如果数据库不存在则不报告错误
--if-exists 用户名不存在时则不报告错误
--interactive 提示缺少角色名及其属性
而不是使用默认值
--maintenance-db=DBNAME 更改维护数据库
--maintenance-db=DBNAME 更改维护数据库
--no-replication 角色不能启动复制
--replication 角色能启动复制
-?, --help 显示此帮助信息, 然后退出
-?, --help 显示此帮助, 然后退出
-?, --help 显示此帮助, 然后退出
-?, --help 显示此帮助, 然后退出
-D, --no-createdb 此角色不可以创建新数据库(默认)
-D, --tablespace=TABLESPACE 数据库默认表空间
-E, --encoding=ENCODING 数据库编码
-E, --encrypted 口令加密存储
-F, --freeze 冻结记录的事务信息
-I, --no-inherit 角色不继承权限
-L, --no-login 角色不能登录
-N, --unencrypted 口令不加密存储
-O, --owner=OWNER 新数据库的所属用户
-P, --pwprompt 给新角色指定口令
-R, --no-createrole 这个角色没有创建其它角色的权限(默认)
-S, --no-superuser 角色不能是超级用户(默认)
-S, --schema=SCHEMA 只对指定模式重建索引
-T, --template=TEMPLATE 要拷贝的数据库模板
-U, --username=USERNAME 联接的用户名
-U, --username=USERNAME 联接的用户名
-U, --username=USERNAME 联接用户 (不是要创建的用户名)
-U, --username=USERNAME 联接用户 (不是要删除的用户名)
-U, --username=USERNAME 连接的用户名
-V, --version 输出版本信息, 然后退出
-V, --version 输出版本信息, 然后退出
-V, --version 输出版本信息, 然后退出
-V, --version 输出版本信息, 然后退出
-W, --password 强制提示输入口令
-W, --password 强制提示输入口令
-Z, --analyze-only 只更新优化器统计信息，但不做清理
-a, --all 清理所有的数据库
-a, --all 对所有数据库建簇
-a, --all 对所有数据库进行重建索引操作
-c, --connection-limit=N 角色的连接限制(缺省: 没有限制)
-d, --createdb 此角色可以创建新数据库
-d, --dbname=DBNAME 清理数据库 DBNAME
-d, --dbname=DBNAME 要删除语言的数据库
-d, --dbname=DBNAME 对数据库 DBNAME 建簇
-d, --dbname=DBNAME 要安装语言的数据库
-d, --dbname=数据库名称 对数据库中的索引进行重建
-d, --dbname=DBNAME 数据库名
-e, --echo 显示发送到服务端的命令
-e, --echo 显示发送到服务端的命令
-e, --echo 显示发送到服务端的命令
-f, --full 完全清理
-g, --role=ROLE 新的角色必须是这个角色的成员
-h, --host=HOSTNAME 数据库服务器所在机器的主机名或套接字目录
-h, --host=HOSTNAM 数据库服务器所在机器的主机名或套接字目录
-h, --host=主机名 数据库服务器的主机名或套接字目录
-i, --index=INDEX 仅重新创建指定的索引
-i, --inherit 角色能够继承它所属角色的权限
（这是缺省情况)
-i, --interactive 删除任何东西之前给予提示
-i, --interactive 删除任何东西之前给予提示, 如果没有指定
角色名也给予提示
-j, --jobs=NUM 使用这么多个并发连接进行清理
-l, --list 显示当前已经安装了的语言列表
-l, --locale=LOCALE 数据库的本地化设置
-l, --login 角色能够登录(这是缺省情况)
-p, --port=PORT 数据库服务器端口号
-p, --port=PORT 数据库服务器端口号
-p, --port=PORT 数据库服务器端口
-q, --quiet 不写任何信息
-q, --quiet 不写任何信息
-q, --quiet 静默运行
-r, --createrole 这个角色可以创建新的角色
-s, --superuser 角色将是超级用户
-s, --system 对系统视图重新创建索引
-t, --table='TABLE[(COLUMNS)]' 只清理指定的表
-t, --table=TABLE 只对指定的表建簇
-t, --table=表名 只对指定的表重新创建索引
-t, --timeout=SECS 尝试连接时要等待的秒数, 值为０表示禁用(缺省值: %s)
-v, --verbose 写大量的输出
-v, --verbose 写大量的输出
-w, --no-password 永远不提示输入口令
-w, --no-password 永远不提示输入口令
-z, --analyze 更新优化器统计
%s (%s/%s) %s 清理并且优化一个 PostgreSQL 数据库.
%s 对一个数据库中先前已经建过簇的表进行建簇.
%s 创建一个 PostgreSQL 数据库.
%s 创建一个新的 PostgreSQL 用户.
%s 安装一个过程语言进 PostgreSQL 数据库.
%s 发起一个到指定 PostgreSQL数据库的连接检查.
%s 对一个PostgreSQL 数据库重新创建索引.
%s 删除一个 PostgreSQL 数据库.
%s 删除一个 PostgreSQL 用户.
%s 从数据库中删除一个过程语言.
%s: "%s" 不是一个有效的编码名称
%s: %s %s: 无法对所有数据库和一个指定的数据库同时建簇
%s: 无法在所有数据库中对指定表进行建簇
%s: 无法对所有数据库和一个指定的索引同时进行索引重建操作
%s: 无法对所有数据库和系统目录同时进行索引重建操作
%s: 无法对指定索引和系统视图同时进行索引重建操作
%s: 无法在所有数据库中对指定的索引进行重建
%s：无法对指定的模式和系统目录同时进行索引重建
%s: 无法在所有数据库中对指定模式上的索引进行重建
%s: 无法对指定的表和系统视图同时进行索引重建操作
%s: 无法在所有数据库中对指定表上的索引进行重建
%s：在只执行分析的时候，无法使用"%s"选项
%s: 无法对所有数据库和一个指定的数据库同时清理
%s: 无法在所有数据库中对指定的表进行清理
%s: 对数据库 "%s" 进行建簇
%s: 数据库 "%s" 建簇失败: %s %1$s: 在数据库 "%3$s" 中的表 "%2$s" 建簇失败: %4$s %s: 创建注释失败 (数据库已创建): %s %s: 无法联接到数据库 %s: %s %s：无法连接到数据库 %s：内存不足
%s: 无法取得缺省选项
%s: 创建新用户失败: %s %s: 创建数据库失败: %s %s: 数据库删除失败: %s %s: 无效套接字: %s %1$s: 数据库 "%3$s" 中已经安装了语言 "%2$s"
%1$s: 数据库 "%3$s" 中, 没有安装语言 "%2$s"
%s: 语言安装失败: %s %s: 语言删除失败: %s %s: 缺少需要的数据库名参数
%s: 缺少要求的语言名称参数
%s: 缺少需要的参数角色名
%s：并行工作的数量必须至少为1
%s: 只能指定--locale和--lc-collate这两个选项之一
%s: 只能指定--locale和--lc-ctype这两个选项之一
%s：处理数据库"%s"：%s
%s: 查询失败: %s %s: 查询是: %s
%s: 对数据库 "%s" 重新创建索引
%s: 在数据库"%s"上重新创建索引失败: %s %1$s: 在数据库"%3$s"中对索引"%2$s"重新创建失败: %4$s %1$s: 在数据库"%3$s"中对模式"%2$s"的索引重建失败：%4$s %s: 对目录视图重新创建索引失败: %s %1$s: 在数据库"%3$s"中对表"%2$s"上的索引重新创建失败: %4$s %s: 删除用户 "%s" 失败: %s %s: 太多的命令行参数 (第一个是 "%s")
%s：请求了太多并行任务（最大：%d）
%s: 清理数据库 "%s"
%s: 数据库 "%s" 清理失败: %s %1$s: 在数据库 "%3$s" 中的表 "%2$s" 清理失败: %4$s (%lu 行记录) 您确定吗? (y/n) 取消发送的请求
无法对表的内容添加单元: 总共有%d个单元超过.
无法对表的内容增加标题:已经超过%d列的数量.
无法发送取消请求: %s 数据库 "%s" 将被永久的删除.
再输入一遍: 输入要增加的角色名称: 输入要删除的用户名: 为新角色输入的口令: 产生缺省(完全)优化器统计 产生中等优化器统计(10个目标) 产生最小优化器统计(一个目标) 已中断
名字 密码加密失败.
口令: 口令不匹配.
请回答"%s"或"%s".
过程语言 用户 "%s" 将被永久删除.
新的角色是否是超级用户? 新的角色允许创建数据库吗? 新角色允许创建其它新的角色吗? 是否信任? 请用 "%s --help" 获取更多的信息.
使用方法:
接受连接
无法复制空指针 (内部错误)
无法查找得到有效的用户ID %ld: %s 无效的输出格式 (内部错误): %d n no 没有尝试
没有响应
内存溢出
拒绝连接
未知
用户不存在 用户名查找失败：错误代码%lu y yes locale/zh_CN/LC_MESSAGES/ecpglib6-9.6.mo 0000644 00000007031 14751153421 0013137 0 ustar 00 �� ! $ / , � � � � ) ' - Q : 0 � $ � ( 9 L * c ; � > � 3 < = & z 1 � � + � ' @ % Y � , � � 2 0 ; / l k � 3 Q % f + � : � 5 � + )
, U
�
�
, �
8 �
; : U B � + � 5 � 5 + V # � � � , � ,
: 7
+ r
) �
& �
) �
! <DEFAULT> <empty> NULL SQL error %d on line %d SQL error: %s
connection "%s" does not exist on line %d could not connect to database "%s" on line %d could not convert boolean value: size mismatch, on line %d data read from server is not an array on line %d descriptor "%s" not found on line %d descriptor index out of range on line %d empty message text empty query on line %d error in transaction processing on line %d inserting an array of variables is not supported on line %d invalid input syntax for floating-point type: "%s", on line %d invalid input syntax for type int: "%s", on line %d invalid input syntax for type unsigned int: "%s", on line %d invalid statement name "%s" on line %d invalid syntax for type boolean: "%s", on line %d no data found on line %d not connected to connection "%s" on line %d null value without indicator on line %d out of memory on line %d the connection to the server was lost too few arguments on line %d too many arguments on line %d unrecognized descriptor item "%s" on line %d unsupported type "%s" on line %d variable does not have a character type on line %d variable does not have a numeric type on line %d variable does not have an array type on line %d Project-Id-Version: ecpglib (PostgreSQL 9.0)
Report-Msgid-Bugs-To: pgsql-bugs@postgresql.org
POT-Creation-Date: 2013-01-29 13:40+0000
PO-Revision-Date: 2013-09-03 23:28-0400
Last-Translator: Weibin <ssmei_2000@yahoo.com>
Language-Team: Chinese (Simplified)
Language: zh_CN
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
<DEFAULT> <空> NULL 在第%2$d行上的SQL命令发生错误 代码%1$d SQL语句错误: %s
在第%2$d行上连接"%1$s"不存在 在第%2$d行上无法连接数据库"%1$s" 在第%d行上无法转换布尔类型值: 大小不匹配 在第%d行上从服务器读取的数据不是数组 在第%2$d行上没有找到描述符"%1$s" 在第%d行上的描述符索引超出范围 消息文本为空 在第%d行上查询是空的 在第%d行上的事务处理中发生错误 在第%d行上不支持正在插入一个的变量数组 对于浮点类型的输入语法无效: "%s"，在第%d行 对于整数类型的输入语法无效: "%s" ,在第%d行 对于无符号整数类型的输入语法无效: "%s" 在第%d行 在第%2$d行上的语句名称"%1$s"无效 对于布尔类型语法无效: "%s"，在第%d行上 在第%d行上没有找到数据 在第%2$d行上没有连接到"%1$s"连接 在第%d行上的空值没有标志 在第%d行上内存用尽 与服务器的连接丢失 在第%d行上的参数少于指定的数量 在第%d行上的参数多于指定的数量 在第%2$d行上出现无法识别的描述符成员"%1$s" 在第%2$d上出现不支持的类型"%1$s" 在第%d行上的变量没有字符类型 在第%d上的变量没有数值类型 在第%d行上的变量没有数组类型 locale/zh_CN/LC_MESSAGES/psql-9.6.mo 0000644 00000262333 14751153421 0012433 0 ustar 00 �� ( \! � �B �X �X �X Y � Y �Y �Y
�Y Z > Z = WZ < �Z p �Z s C[ 5 �[ 7 �[ K %\ o q\ 2 �\ 4 ] N I] t �] Q
^ O _^ > �^ A �^ O 0_ @ �_ 6 �_ 0 �_ N )` G x` 8 �` A �` T ;a ? �a L �a A b @ _b H �b A �b + +c � Wc 5 �c 9 #d n ]d Q �d : e � Ye ; �e y "f � �f ; 8g z tg T �g A Dh L �h B �h \ i 4 si J �i \ �i 6 Pj 4 �j G �j = k ; Bk ( ~k ; �k ; �k ; l ; [l 8 �l _ �l J 0m F {m ` �m h #n G �n 5 �n 2
o X =o Q �o : �o 3 #p ; Wp S �p M �p 9 5q @ oq 8 �q ; �q @ %r K fr J �r | �r � zs > t F ?t N �t F �t H u $ eu & �u - �u 9 �u 7 v 2 Qv 4 �v 3 �v ) �v ) w ; Aw B }w ) �w * �w * x J @x 1 �x . �x - �x , y 4 Gy I |y $ �y & �y > z 1 Qz & �z ( �z J �z : { ( Y{ % �{ $ �{ $ �{ ) �{ - | N J| 9 �| G �| 5 } M Q} C �} P �} K 4~ N �~ K �~ L 4 h K � ( � q � A �� ? ƀ A � > H� X �� # � F � 8 K� < �� M �� ; � 6 K� 2 �� 7 �� B � : 0� 4 k� 9 �� ? څ % � + @� 9 l� 5 �� I ܆ K &� M r� Z �� S � K o� � �� N F� @ �� : ։ ( � B :� L }� C ʊ � � M �� = � � I� � � � � � 2� B� W� 0 _� $ �� # �� * ٍ % � * *� U� # v� < �� �� � 6 +� b� � w� : � X� j� v� �� �� �� �� Ɛ ؐ Q � <� I P� [ ��
�� � �
'� 2� P� C ]� A �� � � �� � � � %� , 7� d� {� �� �� �� �� �� Ɠ ޓ ��
�� � � !� ' .� V� & t� ' �� 7 Ô 0 �� ,� H� X� k� �� �� �� �� e ��
� � 3� 9� S� ( l� �� �� �� Ė � �� � '� 3� <� E� W� d� s� ��
�� �� �� ��
�� �� × җ ۗ � �
��
�
� *� & 7� ^� g�
v�
�� �� �� ��
Ș ֘ � �� � "� 2� I� a� x� �� �� ř י �
�� � � % *� P� " d� �� �� Ě � ' �� & � G� P� j� t� {� �� ��
�� �� L �� �� � '� > D� �� �� �� 2 Ü �� �� � $� >� P� X� n� {� �� �� �� X ͝ &� C� Z�
p� {� �� ' �� . Ş ! � ' � >� H� b�
l� z� �� �� ʟ �
� � *� , 6� c� t� �� �� �� �� �� Ѡ E ؠ � .� 5� >� O� V� _� d� k� w� �� �� �� �� �� ɡ ӡ �
� �� �
0� ;� L� Q� ]� r� �� �� ! �� Ԣ � 9 � y A� I �� 8 � E >� F �� 8 ˤ = � < B� C � > å N � E Q� F �� 9 ަ ; � T� q� ��
�� �� �� ��
ħ ϧ �
� "� C� M� & U� |� �� �� �� � ¨ �� # �� # �� # � � " � >� U� ]� t� ~� ��
�� �� �� ��
�� i ʪ � 4� �� K � Q ^� / �� O � U 0� 5 �� = �� �� , � 4 3� " h� ! �� �� ͮ ڮ �� " � 9 4� # n� = �� = Я = � i L� 9 �� � � * ,� W� s� �� �� ı ˱ ϱ ޱ � �� � � � $� @� # _� �� �� $ �� ղ
� �� �� � � � �
)� 7� A� K� Z� k� u� }� �� ' �� C �� �� /
� =� P� Y� k� �� ' �� ƴ $ � %
� ! 0� ) R� ( |� / �� # յ ' �� , !� . N� 4 }� �� ! Ҷ - � "� % C� 4 i� 1 �� - з / �� " .� Q� ' q� �� . �� ) � % � ! 8� $ Z� * � + �� A ֹ � � & 1� 0 X� . �� ) �� ) � � % � A�
F�
Q� \� # f� �� �� �� �� ǻ ӻ ڻ � � � C � [� z� �� �� �� ¼ Ҽ �
�� � $ � & ;� - b� # �� �� 1 ս ( � ) 0� + Z� ' �� �� # ɾ ! � ( � 8� U� n� �� �� ȿ ο � �� �
� #� C�
K� V� c� s� �� �� �� � � � � >� Y� u� ! �� �� � 2 � � -� C� _� |� �� 2 �� 5 �� � 4� T� . g� �� & �� # �� �� ! � ;� R� g� y� �� 6 �� ) �� �
� '� .� E� O� c�
p� & ~� �� �� �� �� �� �� �� � � � ?� G�
P� ^� U k� �� �� �� , �� � 2� R� a� t�
�� �� �� �� �� �� �� �� " ��
� � %� /� 9� P� Y�
t� 1 �� �� ��
�� �� �� � . � L� . V�
�� �� �� �� �� ��
�� �� E �� 5�
E� S� e� t� �� �� �� �� �� �� �� * �� #�
+� 6� B� Q� [� e� k� u�
�� �� �� �� �� �� �� �� �� � � *� 7� >� K� T� Y� k�
t� �� �� �� �� �� % �� �� �� �� � � � #� 3� G� V� e� n� x�
�� �� �� �� �� �� �� �� �� �� �� � � � %� .� :� =� E� M� V� e�
u� �� ��
�� �� �� �� �� �� �� ��
� � � -� 9� K� U� ! _� 4 ��
�� �� . �� ��
� � #� 3� D� N� d�
m�
{�
�� �� �� �� �� �� �� "
� -� D� b� t� �� �� / �� �� � � #� " 7� Z� z� �� �� �� * ��
� � *� B� _� w� �� �� �� �� 0 �� + � >� F� O� > W� �� ) �� " �� �� ��
� � � 1� J� O� Y� i� x� �� �� ��
�� ��
��
��
�� �� �� �� 7 � 2 9� 6 l� V �� �� & � & '� . N� }� �� ��
��
�� �� �� �� �� �� �� � � -� =� M� ! W� y� �� �� ��
�� �� �� �� �� . �� .� 4� E� V�
s� ~� �� �� �� �� �� �� �� ��
�� �� � � !� .� G� L� i� �� �� �� $ �� # �� �� � 0 � ?� [� b� y� ( �� �� ��
�� �� �� �� � � � � ,� =� O� , X� �� �� �� $ �� �� ' � 9� T� s� �� �� �� �� ! �� � � 2�
>� I� Y� � ]� V� f� x� � �� � 3� J� \� @ q� = �� > �� n /� � �� : $� < _� < �� m �� 1 G� 8 y� ] �� r � H �� S �� F � < g� 7 �� ; �� ? � 1 X� P �� L �� < (� A e� U �� E �� F C� A �� F �� V � < j� * �� � �� 6 h� 4 �� m �� O B� + �� � �� 4 E� r z� � �� 7 �� i �� N .� : }� = �� = �� [ 4� 9 �� N �� d � 7 ~� 1 �� ; �� 1 $� 1 V� % �� 1 �� 1 �� 1 � 4 D� 4 y� @ �� I �� ; 9� ] u� ] �� 7 1� < i� - �� O � K $� 9 p� + �� 7 � Q � I `� 8 �� > � 5 "� O X� > �� _ � D G� | �� ~ � / �� ; �� O � G D� E �� 2 � , � ) 2� . \� 0 �� 2 �� . � 2 � 2 Q� ' �� , �� > � ) � ' B� & j� D �� * � , � ) .� * X� 4 �� U �� & 5 C V 2 � + � % � B A b # � ! � & � " & 4 5 [ P � 9 � B : _ J � > � V $ I { M � A [ U . � L � / - i ] B � 7
7 B 9 z V � J ) 6 t L � P � 5 I
5
5 �
4 �
A . b = � 7 � @ , H . u 7 � 6 � N
R b
D �
[ �
M V = � b � O E D � A � 4 I Q U � G � � 9 C � L � m ' +
B P j & r - � � � ( & , S q 3 � � � � 2 A � Q ; � 1
= H [
g
u � � I � � < � ] ; � � � � � � ? � > ? ~ � � � � � � 4 � � & 3 9 C Y s � � � � � . � � . ) / : Y 7 � � � � " ) 0 = j J � � � � � 5
? J i � � �
� �
� � � ! 7 D Q Y
\ g v
� � � � � � � �
� - �
% 0 = M T l � � � � � � * F S i v � � � � � � �
& < U . h . � � � � � � !
! ! '! k 4! �! �! �! P �! ?" S" h" 6 �" �" �" �" �"
�" # #
# )# 3# ( M# v# ' �# �# �# �# �# $ $ ' !$ 0 I$ ! z$ * �$ �$ �$ �$ �$ % # % @% # _% ! �% �% �% �% - �% �% & & $& +& 8& K& k& G u& �& �& �& �& �& �& ' ' ' ' )' >' K' X'
_' j' w' �' �' �' �' �' �' �' �' ( ( 8( ?( W( r( �( 5 �( � �( 3 g) / �) 3 �) 9 �) . 9* 6 h* 0 �* > �* 3 + I C+ 3 �+ 9 �+ 1 �+ 5 -, c, |, �, �, �,
�, �, �, �, # - 3- ! I- k- x- , - �- �- �- & �- � . + �. �. / 1/ R/ & s/ �/ �/ �/ �/ �/ �/ �/ 0 0
0 $0 h .0 � �0 " g1 S �1 [ �1 % :2 P `2 Y �2 4 3 I @3 �3 $ �3 " �3 �3 " �3 !4 ;4 H4 $ ^4 $ �4 6 �4 # �4 < 5 9 @5 < z5 h �5 B 6 c6 |6 " �6 * �6 �6 7 7 07 77 ;7 J7 ^7 e7 }7 �7
�7 �7 ' �7 . �7 8
8 ! .8 P8
g8 u8 �8 �8 �8 �8 �8 �8 �8 �8
�8 �8
�8 9 9 9 % 9 9 B9 |9 % �9
�9 �9 �9 �9 �9 : ! .: P: ' l: �: �: �: $ �:
; #; <; X; * t; �; �; ! �; �; < ' %< ' M< * u< ' �< �< �< �< = /= K= j= �= �= �= $ �= H �= <> C> ! T> ' v> ) �> �> �> ? ? .? 5? B? K? X? w? �? �? �? �? �? �? �? �? �? 6 �? /@ E@ d@ k@ x@ �@ " �@ �@ �@ �@ $ �@ " A & $A KA ! hA 1 �A �A �A % �A " B ?B ! ]B B ) �B �B �B �B % C 8C ' WC C �C �C
�C �C ' �C D D D &D :D SD rD �D �D �D �D $ �D E 6E LE ' bE �E �E 3 �E �E �E F ! /F QF jF 3 �F 2 �F �F G "G $ 8G ]G ! sG ! �G $ �G ! �G �G H -H @H SH * oH $ �H �H �H �H �H �H I
I
I ) (I RI _I fI mI tI �I
�I
�I �I ! �I �I �I �I
J I J ^J kJ rJ % |J $ �J �J �J , �J &K :K DK ^K tK $ �K �K �K �K ! �K L
L *L ;L QL hL oL �L + �L �L $ �L �L �L M
&M " 4M WM ' dM �M �M �M �M �M �M �M �M 8 �M 3N CN TN aN
qN N �N �N �N �N �N �N ( �N O
"O -O FO _O {O �O �O �O �O �O ! �O �O �O
P P
3P AP NP jP wP �P �P �P �P �P �P
�P �P �P �P �P Q ! Q .Q 5Q FQ WQ ^Q nQ �Q ! �Q �Q �Q �Q R R R *R 4R DR NR RR iR �R �R �R �R
�R �R �R �R �R �R �R �R S S -S =S MS TS jS
wS �S
�S �S �S �S �S �S �S �S T T +T 2T 9T * UT �T �T 1 �T �T �T �T �T
U U &U <U LU
eU sU �U �U �U �U �U V $ V AV ! WV yV �V �V �V - �V �V W W /W EW dW ! �W �W �W �W $ �W X X 2X KX dX zX �X �X �X �X < �X %Y AY IY eY ' �Y �Y $ �Y $ �Y Z Z ! )Z KZ XZ # kZ �Z
�Z �Z �Z �Z �Z �Z �Z
�Z �Z [
[
[ *[ :[ J[ 6 Z[ �[ 3 �[ B �[ !\ $ :\ _\ ! {\ �\ �\ ! �\ �\ $ �\
] ] ! ] B] I] P] Z]
s] �] �] �] �] �] �] �] ! �]
^ ^ . ^ / K^ $ {^ + �^ �^ �^ �^ 3 �^ _ %_ 8_ I_ $ V_ {_ �_ �_ �_ �_ �_ �_ �_ �_ �_ �_ ` '
` ! 5` W` d` h` " �` �`
�` �` 4 �` a ,a 3a Ra ' ba �a �a �a �a ! �a �a �a �a b b ! b " >b ab < nb ! �b �b �b - �b
,c 0 7c hc / �c % �c �c " �c d $ #d ( Hd qd xd �d �d ' �d �d U _ S } � � P � | � � H � � k � @ � � s � 4 � � � � [ � � � � u � � � . � � � � � ~ � 1 � X [ r � h � � � $ J � & � � � m 3 � g � � � & � � � � $ 2 � � � � � f ] � � _ D i � � / _ V . � � A � e � + � � � � w � � # � � � d � � � @ u g ( � � T & f = � � � n � � $ � 4 \ O u �
� � � ? � U � k ] � f � � � � > . � - � � M t Q
� � 2 0 C 8 � � S H � ` � � � 2 � � x � � Q '
& � � � � 0 � " P % � � O � , N � � Y G � P ] � � f d 4 � p j � U � q � Y � � � � n � c � � � � � S h ^ 0 ; � 9 � b - a � = ! ) ] � � ! � � � � � A K � � y � B � < � B ` � � � � g � R d � N a > t � � � l � � % � l < > A 3 V � � � � \ � � 7 � o F � � � / � X � � � � � " � y � ! � � � � � � � + z W L | # d j � � � K � � * � I � � � � ` D a � � < � ' $ � �
� � � C � R � � ) T � s � p � � � � � � J � 5 � � � � s � o x V - � � � w " �
� H q ' � �
� � � � K � I � ; � L 4 m M � � R � � � o v � � � b } Q � � p : � F c � � � R � ( � � } � � , � � � u � � � | � � T � \ 8 & � � � ( � � � x 5 � � w � � ^ y � � � � @ � / � A � � � 5 � � � � ~ � � ' e � m � � 8 J � � [ [ � � + � � '
� I q � �
� % z � � � M � # E � � � 8 ! � e � ( � X ; � � � � � � G � � h � � � I K E � � � / z G � � 0 2 � � � � 3 � � � N � � � � � 5 � � E � \ � � } � * � � � � ! Y � � b
� � Z � � 6 w � h � � � t � � . � O � � � � � v C � � � � � � � � � 7 � � � � : D G � y W � � N V , � : � � � � B c � W � � � � � � - � � $ � � b Y � � ^ � % � � � � � �
� � � � � ? 1 � Z ) � 7 r P � � O � � 9 * � � � � = � 6 � � U r � � L ~ � � ^ i � j c n 6 D � F � ; � � � ` � � q ( 9 � 3 � � � � X L � � � � � v F � � � � � � t � � � l 9 = � � � % l � � � H " � v g � Q � � � � � � � T < r � W � * s � + E � � @ S p � 6 n Z ? k � { � � : e � > i � � 7 { � � � # C ? j o � { J � z i k � � � � 1 a � m � � � B ~ � � M ) � " � � | � � � � � � � # � � � _ � � x 1 Z { , �
Connection options:
Display settings:
Environment variables:
For more information, type "\?" (for internal commands) or "\help" (for SQL
commands) from within psql, or consult the psql section in the PostgreSQL
documentation.
Input and output options:
Output format options:
Parser: "%s"
Parser: "%s.%s" --help=commands list backslash commands, then exit
--help=variables list special variables, then exit
(options: S = show system objects, + = additional detail)
-0, --record-separator-zero
set record separator for unaligned output to zero byte
-1 ("one"), --single-transaction
execute as a single transaction (if non-interactive)
-?, --help[=options] show this help, then exit
-A, --no-align unaligned table output mode
-E, --echo-hidden display queries that internal commands generate
-F, --field-separator=STRING
field separator for unaligned output (default: "%s")
-H, --html HTML table output mode
-L, --log-file=FILENAME send session log to file
-P, --pset=VAR[=ARG] set printing option VAR to ARG (see \pset command)
-R, --record-separator=STRING
record separator for unaligned output (default: newline)
-S, --single-line single-line mode (end of line terminates SQL command)
-T, --table-attr=TEXT set HTML table tag attributes (e.g., width, border)
-U, --username=USERNAME database user name (default: "%s")
-V, --version output version information, then exit
-W, --password force password prompt (should happen automatically)
-X, --no-psqlrc do not read startup file (~/.psqlrc)
-a, --echo-all echo all input from script
-b, --echo-errors echo failed commands
-c, --command=COMMAND run only single command (SQL or internal) and exit
-d, --dbname=DBNAME database name to connect to (default: "%s")
-e, --echo-queries echo commands sent to server
-f, --file=FILENAME execute commands from file, then exit
-h, --host=HOSTNAME database server host or socket directory (default: "%s")
-l, --list list available databases, then exit
-n, --no-readline disable enhanced command line editing (readline)
-o, --output=FILENAME send query results to file (or |pipe)
-p, --port=PORT database server port (default: "%s")
-q, --quiet run quietly (no messages, only query output)
-s, --single-step single-step mode (confirm each query)
-t, --tuples-only print rows only
-v, --set=, --variable=NAME=VALUE
set psql variable NAME to VALUE
(e.g., -v ON_ERROR_STOP=1)
-w, --no-password never prompt for password
-x, --expanded turn on expanded table output
-z, --field-separator-zero
set field separator for unaligned output to zero byte
AUTOCOMMIT if set, successful SQL commands are automatically committed
COLUMNS number of columns for wrapped format
COMP_KEYWORD_CASE determines the case used to complete SQL key words
[lower, upper, preserve-lower, preserve-upper]
DBNAME the currently connected database name
ECHO controls what input is written to standard output
[all, errors, none, queries]
ECHO_HIDDEN if set, display internal queries executed by backslash commands;
if set to "noexec", just show without execution
ENCODING current client character set encoding
FETCH_COUNT the number of result rows to fetch and display at a time
(default: 0=unlimited)
HISTCONTROL controls command history [ignorespace, ignoredups, ignoreboth]
HISTFILE file name used to store the command history
HISTSIZE the number of commands to store in the command history
HOST the currently connected database server host
IGNOREEOF if unset, sending an EOF to interactive session terminates application
LASTOID value of the last affected OID
NAME=VALUE [NAME=VALUE] psql ...
or \setenv NAME [VALUE] inside psql
ON_ERROR_ROLLBACK if set, an error doesn't stop a transaction (uses implicit savepoints)
ON_ERROR_STOP stop batch execution after error
PAGER name of external pager program
PGAPPNAME same as the application_name connection parameter
PGDATABASE same as the dbname connection parameter
PGHOST same as the host connection parameter
PGPASSFILE password file name
PGPASSWORD connection password (not recommended)
PGPORT same as the port connection parameter
PGUSER same as the user connection parameter
PORT server port of the current connection
PROMPT1 specifies the standard psql prompt
PROMPT2 specifies the prompt used when a statement continues from a previous line
PROMPT3 specifies the prompt used during COPY ... FROM STDIN
PSQLRC alternative location for the user's .psqlrc file
PSQL_EDITOR, EDITOR, VISUAL
editor used by the \e, \ef, and \ev commands
PSQL_EDITOR_LINENUMBER_ARG
how to specify a line number when invoking the editor
PSQL_HISTORY alternative location for the command history file
QUIET run quietly (same as -q option)
SHELL shell used by the \! command
SHOW_CONTEXT controls display of message context fields [never, errors, always]
SINGLELINE end of line terminates SQL command mode (same as -S option)
SINGLESTEP single-step mode (same as -s option)
TMPDIR directory for temporary files
USER the currently connected database user
VERBOSITY controls verbosity of error reports [default, verbose, terse]
\! [COMMAND] execute command in shell or start interactive shell
\? [commands] show help on backslash commands
\? options show help on psql command-line options
\? variables show help on special variables
\C [STRING] set table title, or unset if none
\H toggle HTML output mode (currently %s)
\T [STRING] set HTML <table> tag attributes, or unset if none
\a toggle between unaligned and aligned output mode
\c[onnect] {[DBNAME|- USER|- HOST|- PORT|-] | conninfo}
connect to new database (currently "%s")
\c[onnect] {[DBNAME|- USER|- HOST|- PORT|-] | conninfo}
connect to new database (currently no connection)
\cd [DIR] change the current working directory
\conninfo display information about current connection
\copy ... perform SQL COPY with data stream to the client host
\copyright show PostgreSQL usage and distribution terms
\crosstabview [COLUMNS] execute query and display results in crosstab
\dC[+] [PATTERN] list casts
\dD[S+] [PATTERN] list domains
\dE[S+] [PATTERN] list foreign tables
\dF[+] [PATTERN] list text search configurations
\dFd[+] [PATTERN] list text search dictionaries
\dFp[+] [PATTERN] list text search parsers
\dFt[+] [PATTERN] list text search templates
\dL[S+] [PATTERN] list procedural languages
\dO[S+] [PATTERN] list collations
\dT[S+] [PATTERN] list data types
\d[S+] list tables, views, and sequences
\d[S+] NAME describe table, view, sequence, or index
\da[S] [PATTERN] list aggregates
\db[+] [PATTERN] list tablespaces
\dc[S+] [PATTERN] list conversions
\dd[S] [PATTERN] show object descriptions not displayed elsewhere
\ddp [PATTERN] list default privileges
\des[+] [PATTERN] list foreign servers
\det[+] [PATTERN] list foreign tables
\deu[+] [PATTERN] list user mappings
\dew[+] [PATTERN] list foreign-data wrappers
\df[antw][S+] [PATRN] list [only agg/normal/trigger/window] functions
\dg[S+] [PATTERN] list roles
\di[S+] [PATTERN] list indexes
\dl list large objects, same as \lo_list
\dm[S+] [PATTERN] list materialized views
\dn[S+] [PATTERN] list schemas
\do[S] [PATTERN] list operators
\dp [PATTERN] list table, view, and sequence access privileges
\drds [PATRN1 [PATRN2]] list per-database role settings
\ds[S+] [PATTERN] list sequences
\dt[S+] [PATTERN] list tables
\du[S+] [PATTERN] list roles
\dv[S+] [PATTERN] list views
\dx[+] [PATTERN] list extensions
\dy [PATTERN] list event triggers
\e [FILE] [LINE] edit the query buffer (or file) with external editor
\echo [STRING] write string to standard output
\ef [FUNCNAME [LINE]] edit function definition with external editor
\encoding [ENCODING] show or set client encoding
\errverbose show most recent error message at maximum verbosity
\ev [VIEWNAME [LINE]] edit view definition with external editor
\f [STRING] show or set field separator for unaligned query output
\g [FILE] or ; execute query (and send results to file or |pipe)
\gexec execute query, then execute each value in its result
\gset [PREFIX] execute query and store results in psql variables
\h [NAME] help on syntax of SQL commands, * for all commands
\i FILE execute commands from file
\ir FILE as \i, but relative to location of current script
\l[+] [PATTERN] list databases
\lo_export LOBOID FILE
\lo_import FILE [COMMENT]
\lo_list
\lo_unlink LOBOID large object operations
\o [FILE] send all query results to file or |pipe
\p show the contents of the query buffer
\password [USERNAME] securely change the password for a user
\prompt [TEXT] NAME prompt user to set internal variable
\pset [NAME [VALUE]] set table output option
(NAME := {format|border|expanded|fieldsep|fieldsep_zero|footer|null|
numericlocale|recordsep|recordsep_zero|tuples_only|title|tableattr|pager|
unicode_border_linestyle|unicode_column_linestyle|unicode_header_linestyle})
\q quit psql
\qecho [STRING] write string to query output stream (see \o)
\r reset (clear) the query buffer
\s [FILE] display history or save it to file
\set [NAME [VALUE]] set internal variable, or list all if no parameters
\setenv NAME [VALUE] set or unset environment variable
\sf[+] FUNCNAME show a function's definition
\sv[+] VIEWNAME show a view's definition
\t [on|off] show only rows (currently %s)
\timing [on|off] toggle timing of commands (currently %s)
\unset NAME unset (delete) internal variable
\w FILE write query buffer to file
\watch [SEC] execute query every SEC seconds
\x [on|off|auto] toggle expanded output (currently %s)
\z [PATTERN] same as \dp
border border style (number)
columns target width for the wrapped format
expanded (or x) expanded output [on, off, auto]
fieldsep field separator for unaligned output (default "%s")
fieldsep_zero set field separator for unaligned output to zero byte
footer enable or disable display of the table footer [on, off]
format set output format [unaligned, aligned, wrapped, html, asciidoc, ...]
linestyle set the border line drawing style [ascii, old-ascii, unicode]
null set the string to be printed in place of a null value
numericlocale enable or disable display of a locale-specific character to separate
groups of digits [on, off]
pager control when an external pager is used [yes, no, always]
psql --pset=NAME[=VALUE]
or \pset NAME [VALUE] inside psql
psql --set=NAME=VALUE
or \set NAME VALUE inside psql
psql [OPTION]... [DBNAME [USERNAME]]
recordsep record (line) separator for unaligned output
recordsep_zero set record separator for unaligned output to zero byte
set NAME=VALUE
psql ...
or \setenv NAME [VALUE] inside psql
tableattr (or T) specify attributes for table tag in html format or proportional
column widths for left-aligned data types in latex-longtable format
title set the table title for any subsequently printed tables
tuples_only if set, only actual table data is shown
unicode_border_linestyle
unicode_column_linestyle
unicode_header_linestyle
set the style of Unicode line drawing [single, double]
%d connection %d connections %s %s %s (every %gs)
%s
%s (%s, server %s)
%s (every %gs)
%s.%s is not a view
%s: %s
%s: -1 can only be used in non-interactive mode
%s: cannot copy from/to a directory
%s: could not delete variable "%s"
%s: could not find own program executable
%s: could not open log file "%s": %s
%s: could not set printing parameter "%s"
%s: could not set variable "%s"
%s: current transaction is aborted
%s: invalid encoding name or conversion procedure not found
%s: not connected to a database
%s: out of memory
%s: unknown transaction status
%s: warning: extra command-line argument "%s" ignored
(%lu row) (%lu rows) ***(Single step mode: verify command)*******************************************
%s
***(press return to proceed or enter x and return to cancel)********************
********* QUERY **********
%s
**************************
+ opt(%d) = |%s|
, clustered , deferrable , initially deferred , invalid , predicate (%s) , replica identity , tablespace "%s" Access privileges All connection parameters must be supplied because no database connection exists
Argument data types Asynchronous notification "%s" received from server process with PID %d.
Asynchronous notification "%s" with payload "%s" received from server process with PID %d.
Attributes Available help:
Border style is %d.
Bypass RLS COPY data transfer failed: %s Call Handler Cannot add cell to table content: total cell count of %d exceeded.
Cannot add header to table content: column count of %d exceeded.
Cannot login Check Check constraints: Child tables Collate Column Column privileges Command: %s
Description: %s
Syntax:
%s
Composite type "%s.%s" Connection
Create DB Create role Ctype Database Default access privileges Default footer is off.
Default footer is on.
Default? Definition Description Destination Dictionaries Did not find any extension named "%s".
Did not find any extensions.
Did not find any relation named "%s".
Did not find any relation with OID %s.
Did not find any text search configuration named "%s".
Did not find any text search parser named "%s".
Disabled internal triggers: Disabled rules: Disabled triggers: Disabled user triggers: Elements Enabled Encoding End parse Enter data to be copied followed by a newline.
End with a backslash and a period on a line by itself. Enter it again: Enter new password: Event Expanded display is off.
Expanded display is on.
Expanded display is used automatically.
FDW Options Failed.
Field separator is "%s".
Field separator is zero byte.
Foreign table "%s.%s" Foreign-data wrapper Foreign-key constraints: Formatting
Function General
General options:
Get headline Get next token Get token types Handler Has OIDs: yes Help
ID Implicit? Index "%s.%s" Indexes: Informational
Inherits Init Init options Inline Handler Input/Output
Internal Language Internal name Interrupted
Invalid command \%s. Try \? for help.
Language Large Objects
Large objects Left arg type Lexize Line style is %s.
List of aggregate functions List of casts List of collations List of conversions List of data types List of databases List of domains List of event triggers List of foreign servers List of foreign tables List of foreign-data wrappers List of functions List of installed extensions List of languages List of operators List of relations List of roles List of schemas List of settings List of specially treated variables
List of tablespaces List of text search configurations List of text search dictionaries List of text search parsers List of text search templates List of user mappings Locale-adjusted numeric output is off.
Locale-adjusted numeric output is on.
Location Materialized view "%s.%s" Member of Method Modifier Modifiers Name No changes No connections No help available for "%s".
Try \h with no arguments to see available help.
No inheritance No matching relations found.
No matching settings found.
No per-database role settings support in this server version.
No relations found.
No settings found.
Null display is "%s".
Number of child tables: %d (Use \d+ to list them.) Object Object Description Object descriptions Objects in extension "%s" Operating System
Options Output format is %s.
Owned by: %s Owner Pager is always used.
Pager is used for long output.
Pager usage is off.
Pager won't be used for less than %d line.
Pager won't be used for less than %d lines.
Password encryption failed.
Password for user %s: Password valid until Password: Passwords didn't match.
Policies Policies (forced row security enabled): Policies (forced row security enabled): (none) Policies (row security disabled): Policies (row security enabled): (none) Policies: Previous connection kept
Procedure Query Buffer
Query buffer is empty. Query buffer reset (cleared). Record separator is "%s".
Record separator is <newline>.
Record separator is zero byte.
Referenced by: Replica Identity Replication Report bugs to <pgsql-bugs@postgresql.org>.
Result data type Result type Right arg type Role Role name Rules firing always: Rules firing on replica only: Rules: SSL connection (protocol: %s, cipher: %s, bits: %s, compression: %s)
STATEMENT: %s
Schema Security Sequence "%s.%s" Server Settings Size Source Source code Source type Special relation "%s.%s" Start parse Stats target Storage Succeeded.
Superuser TOAST table "%s.%s" Table Table "%s.%s" Table attributes are "%s".
Table attributes unset.
Tablespace Tablespace: "%s" Tags Target type Target width is %d.
Target width is unset.
Template Text search configuration "%s" Text search configuration "%s.%s" Text search parser "%s" Text search parser "%s.%s" The connection to the server was lost. Attempting reset: The input is a PostgreSQL custom-format dump.
Use the pg_restore command-line client to restore this dump to a database.
The server (version %d.%d) does not support altering default privileges.
The server (version %d.%d) does not support collations.
The server (version %d.%d) does not support editing function source.
The server (version %d.%d) does not support editing view definitions.
The server (version %d.%d) does not support extensions.
The server (version %d.%d) does not support foreign servers.
The server (version %d.%d) does not support foreign tables.
The server (version %d.%d) does not support foreign-data wrappers.
The server (version %d.%d) does not support full text search.
The server (version %d.%d) does not support savepoints for ON_ERROR_ROLLBACK.
The server (version %d.%d) does not support showing function source.
The server (version %d.%d) does not support showing view definitions.
The server (version %d.%d) does not support tablespaces.
The server (version %d.%d) does not support user mappings.
There was no previous error. Time: %.3f ms
Timing is off. Timing is on. Title is "%s".
Title is unset.
Token Token name Token types for parser "%s" Token types for parser "%s.%s" Triggers firing always: Triggers firing on replica only: Triggers: Trusted Try "%s --help" for more information.
Tuples only is off.
Tuples only is on.
Type Type "help" for help.
Type: \copyright for distribution terms
\h for help with SQL commands
\? for help with psql commands
\g or terminate with semicolon to execute query
\q to quit
Typed table of type: %s Unicode border line style is "%s".
Unicode column line style is "%s".
Unicode header line style is "%s".
Unlogged index "%s.%s" Unlogged materialized view "%s.%s" Unlogged table "%s.%s" Usage:
Use "\q" to leave %s.
User name Validator Value Variables
Version View "%s.%s" View definition: Volatility WARNING: %s major version %d.%d, server major version %d.%d.
Some psql features might not work.
WARNING: Console code page (%u) differs from Windows code page (%u)
8-bit characters might not work correctly. See psql reference
page "Notes for Windows users" for details.
Wrote history to file "%s".
You are connected to database "%s" as user "%s" on host "%s" at port "%s".
You are connected to database "%s" as user "%s" via socket in "%s" at port "%s".
You are currently not connected to a database.
You are now connected to database "%s" as user "%s" on host "%s" at port "%s".
You are now connected to database "%s" as user "%s" via socket in "%s" at port "%s".
You are now connected to database "%s" as user "%s".
You are using psql, the command-line interface to PostgreSQL. \!: failed
\%s: could not change directory to "%s": %s
\%s: environment variable name must not contain "="
\%s: error while setting variable
\%s: extra argument "%s" ignored
\%s: missing required argument
\connect: %s \copy: arguments required
\copy: parse error at "%s"
\copy: parse error at end of line
\df does not take a "w" option with server version %d.%d
\df only takes [antwS+] as options
\pset: allowed Unicode border line styles are single, double
\pset: allowed Unicode column line styles are single, double
\pset: allowed Unicode header line styles are single, double
\pset: allowed formats are unaligned, aligned, wrapped, html, asciidoc, latex, latex-longtable, troff-ms
\pset: allowed line styles are ascii, old-ascii, unicode
\pset: unknown option: %s
\watch cannot be used with COPY
\watch cannot be used with an empty query
abbreviated_grant_or_revoke abort the current transaction aborted because of read failure access_method_type action agg aggregate_name aggregate_signature alias alignment allowconn always analyze_function and aggregate_signature is: and conflict_action is one of: and grouping_element can be one of: and like_option is: and table_constraint is: and table_constraint_using_index is: and with_query is: arg_data_type arg_name arg_type argmode argname argtype argument argument_type arguments attribute attribute_name attribute_option base_type boolean cache call_handler can't escape without active connection
cancel a transaction that was earlier prepared for two-phase commit canceled by user cannot duplicate null pointer (internal error)
canonical_function category change a database change a database role change a run-time parameter change a server configuration parameter change role name or membership change the definition of a collation change the definition of a conversion change the definition of a domain change the definition of a foreign server change the definition of a foreign table change the definition of a foreign-data wrapper change the definition of a function change the definition of a large object change the definition of a materialized view change the definition of a procedural language change the definition of a row level security policy change the definition of a rule change the definition of a schema change the definition of a sequence generator change the definition of a table change the definition of a tablespace change the definition of a text search configuration change the definition of a text search dictionary change the definition of a text search parser change the definition of a text search template change the definition of a trigger change the definition of a type change the definition of a user mapping change the definition of a view change the definition of an aggregate function change the definition of an event trigger change the definition of an extension change the definition of an index change the definition of an operator change the definition of an operator class change the definition of an operator family change the ownership of database objects owned by a database role channel check_expression child process exited with exit code %d child process exited with unrecognized status %d child process was terminated by exception 0x%X child process was terminated by signal %d child process was terminated by signal %s close a cursor cluster a table according to an index code collatable collate %s collation collect statistics about a database column_alias column_constraint column_definition column_name column_type com_op combinefunc command command not executable command not found commit a transaction that was earlier prepared for two-phase commit commit the current transaction compute a set of rows condition configuration_parameter conflict_action conflict_target connection to server was lost
connlimit constraint constraint_name copy data between a file and a table could not change directory to "%s": %s could not close pipe to external command: %s
could not execute command "%s": %s
could not find a "%s" to execute could not get home directory for user ID %ld: %s
could not identify current directory: %s could not locate temporary directory: %s
could not look up effective user ID %ld: %s could not open temporary file "%s": %s
could not read binary "%s" could not read from input file: %s
could not read symbolic link "%s" could not save history to file "%s": %s
could not set variable "%s"
could not start /bin/sh
could not start editor "%s"
could not stat file "%s": %s
could not write COPY data: %s
count create a new database create new rows in a table cursor_name data_type database_name deallocate a prepared statement default default %s default_expr define a cursor define a new access method define a new aggregate function define a new cast define a new collation define a new data type define a new database role define a new domain define a new encoding conversion define a new event trigger define a new foreign server define a new foreign table define a new foreign-data wrapper define a new function define a new index define a new mapping of a user to a foreign server define a new materialized view define a new operator define a new operator class define a new operator family define a new procedural language define a new rewrite rule define a new row level security policy for a table define a new savepoint within the current transaction define a new schema define a new sequence generator define a new table define a new table from the results of a query define a new tablespace define a new text search configuration define a new text search dictionary define a new text search parser define a new text search template define a new transform define a new trigger define a new view define access privileges define default access privileges define or change a security label applied to an object define or change the comment of an object definer definition delete delete rows of a table delimiter delimiter_character deserialfunc dest_encoding destroy a previously defined savepoint dictionary_name direction directory disabled discard session state domain constraint domain_constraint domain_name element empty a table or set of tables enabled encoding encoding_name end_function environment variable PSQL_EDITOR_LINENUMBER_ARG must be set to specify a line number
escape_character event exclude_element exclude_element in an EXCLUDE constraint is: execute a prepared statement execute an anonymous code block execution_cost existing_collation existing_enum_value expression extension_name family_name fdw_name ffunc filename filter_variable for table "%s.%s" force a transaction log checkpoint foreign table format_name from_item from_list from_sql_function_name function function name is required
function_name garbage-collect and optionally analyze a database generate a notification gettoken_function group_name grouping_element handler_function headline_function history is not supported by this installation
immutable import table definitions from a foreign server in assignment increment index index_column_name index_expression index_method index_name index_parameters index_parameters in UNIQUE, PRIMARY KEY, and EXCLUDE constraints are: index_predicate init_function initial_condition inline_handler input_function insert install an extension integer internallength invalid binary "%s" invalid command \%s
invalid line number: %s
invalid output format (internal error): %d invoker istemplate join_column join_condition join_proc join_type label lang_name large_object_oid lc_collate lc_ctype left_type lexize_function lextypes_function like_option like_type link_symbol listen for a notification load a shared library file local socket local_schema locale lock a table lockmode loid materialized view maxvalue member_object method mffunc minitial_condition minvalue minvfunc more than one row returned for \gset
msfunc mstate_data_size mstate_data_type name neg_op new_attribute_name new_column_name new_constraint_name new_dictionary new_enum_value new_name new_owner new_role new_schema new_table new_tablespace new_version no no query buffer
no rows returned for \gset
normal not null null_string obj_file object_name off old_dictionary old_role old_version on op_type opclass operator operator class operator family operator_name option or the old syntax out of memory out of memory
output_expression output_function output_name parameter parent_table parser_name password payload pclose failed: %s policy_name position a cursor predicate preferred prepare a statement for execution prepare the current transaction for two-phase commit primary key, provider psql is the PostgreSQL interactive terminal.
psql variables:
query quote_character rebuild indexes receive_function refcolumn referenced_table_name reftable relation_name remote_schema remove a cast remove a collation remove a conversion remove a data type remove a database remove a database role remove a domain remove a foreign server descriptor remove a foreign table remove a foreign-data wrapper remove a function remove a materialized view remove a procedural language remove a rewrite rule remove a row level security policy from a table remove a schema remove a sequence remove a table remove a tablespace remove a text search configuration remove a text search dictionary remove a text search parser remove a text search template remove a transform remove a trigger remove a user mapping for a foreign server remove a view remove access privileges remove an access method remove an aggregate function remove an event trigger remove an extension remove an index remove an operator remove an operator class remove an operator family remove database objects owned by a database role replace the contents of a materialized view replica res_proc restart restore the value of a run-time parameter to the default value result_rows retrieve rows from a query using a cursor retrieve rows from a table or view rettype rewrite_rule_name right_type role_name role_specification roll back to a savepoint rule rule_name sampling_method savepoint_name schema_element schema_name seed select send_function sequence sequence_name serialfunc serialtype server_name server_type server_version set constraint check timing for the current transaction set the characteristics of the current transaction set the current user identifier of the current session set the session user identifier and the current user identifier of the current session sfunc show the execution plan of a statement show the value of a run-time parameter skipping recursive expansion of variable "%s"
snapshot_id sort_expression sort_family_name sort_operator source_config source_encoding source_table source_type special stable start start a transaction block start_function state_data_size state_data_type statement stop listening for a notification storage storage_parameter storage_type strategy_number sub-SELECT subtype subtype_diff_function subtype_operator_class support_number tab completion query failed: %s
Query was:
%s
table table constraint table_constraint table_constraint_using_index table_name tablespace_name tablespace_option target_role target_type template text timestamp timezone to_sql_function_name token_type transaction_id transaction_mode trigger trigger_name trying to exit copy mode type type_modifier_input_function type_modifier_output_function type_name uid unexpected PQresultStatus: %d
unexpected result status for \watch
unexpected transaction status (%d)
unique, unknown unrecognized value "%s" for "%s"; assuming "%s"
unterminated quoted string
update update rows of a table user does not exist user name lookup failure: error code %lu user_name using_expression using_list valfunction validator_function value values version view view name is required
view_option_name view_option_value volatile where abbreviated_grant_or_revoke is one of: where action is one of: where aggregate_signature is: where column_constraint is: where conflict_target can be one of: where constraint is: where direction can be empty or one of: where event can be one of: where from_item can be one of: where lockmode is one of: where member_object is: where option can be one of: where option can be: where role_specification can be: where transaction_mode is one of: window window_definition window_name with_query with_query_name yes Project-Id-Version: psql (PostgreSQL 9.0)
Report-Msgid-Bugs-To: pgsql-bugs@postgresql.org
POT-Creation-Date: 2016-04-18 04:44+0000
PO-Revision-Date: 2016-06-12 15:59+0800
Last-Translator: Yuwei Peng <ywpeng@whu.edu.cn>
Language-Team: Chinese (Simplified)
Language: zh_CN
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
X-Poedit-SourceCharset: utf-8
X-Poedit-Bookmarks: 175,-1,-1,-1,-1,-1,-1,-1,-1,-1
Plural-Forms: nplurals=1; plural=0;
X-Generator: Poedit 1.5.7
联接选项:
显示设置：
环境变量：
更多信息，请在psql中输入"\?"(用于内部指令)或者 "\help"(用于SQL命令)，
或者参考PostgreSQL文档中的psql章节.
输入和输出选项：
输出格式选项 :
剖析器："%s"
剖析器："%s.%s" --help=commands 列出反斜线命令，然后退出
--help=variables 列出特殊变量，然后退出
(选项: S = 显示系统对象, + = 其余的详细信息)
-0, --record-separator-zero
为不整齐的输出设置记录分隔符为字节0
-1 ("one"), --single-transaction
作为一个单一事务来执行命令文件(如果是非交互型的)
-?, --help[=options] 显示此帮助，然后退出
-A, --no-align 使用非对齐表格输出模式
-E, --echo-hidden 显示内部命令产生的查询
-F, --field-separator=STRING
为字段设置分隔符,用于不整齐的输出(默认："%s")
-H, --html HTML 表格输出模式
-L, --log-file=文件名 将会话日志写入文件
-P, --pset=变量[=参数] 设置将变量打印到参数的选项(查阅 \pset 命令)
-R, --record-separator=STRING
为不整齐的输出设置字录的分隔符(默认：换行符号)
-S, --single-line 单行模式 (一行就是一条 SQL 命令)
-T, --table-attr=文本 设定 HTML 表格标记属性（例如,宽度,边界)
-U, --username=用户名 指定数据库用户名(默认："%s")
-V, --version 输出版本信息, 然后退出
-W, --password 强制口令提示 (自动)
-X, --no-psqlrc 不读取启动文档(~/.psqlrc)
-a, --echo-all 显示所有来自于脚本的输入
-b, --echo-errors 回显失败的命令
-c,--command=命令 执行单一命令(SQL或内部指令)然后结束
-d, --dbname=数据库名称 指定要连接的数据库 (默认："%s")
-e, --echo-queries 显示发送给服务器的命令
-f, --file=文件名 从文件中执行命令然后退出
-h, --host=主机名 数据库服务器主机或socket目录(默认："%s")
-l, --list 列出所有可用的数据库,然后退出
-n, --no-readline 禁用增强命令行编辑功能(readline)
-o, --output=FILENAME 将查询结果写入文件(或 |管道)
-p, --port=端口 数据库服务器的端口(默认："%s")
-q, --quiet 以沉默模式运行(不显示消息，只有查询结果)
-s, --single-step 单步模式 (确认每个查询)
-t, --tuples-only 只打印记录i
-v, --set=, --variable=NAME=VALUE
设置psql变量NAME为VALUE
(例如，-v ON_ERROR_STOP=1)
-w, --no-password 永远不提示输入口令
-x, --expanded 打开扩展表格输出
-z, --field-separator-zero
为不整齐的输出设置字段分隔符为字节0
AUTOCOMMIT 如果被设置，成功的SQL命令将会被自动提交
COLUMNS 回卷格式的列数
COMP_KEYWORD_CASE 决定用于完成 SQL 关键词的大小写
[lower, upper, preserve-lower, preserve-upper]
DBNAME 当前已连接的数据库名
ECHO 控制哪些输入被写入到标准输出
[all, errors, none, queries]
ECHO_HIDDEN 如果被设置，显示反斜线命令执行的内部命令；
如果被设置为 "noexec"，只显示但不执行
ENCODING 当前的客户端字符集编码
FETCH_COUNT 一次取得并显示的结果行的数量
(默认：0=无限)
HISTCONTROL 控制命令历史 [ignorespace, ignoredups, ignoreboth]
HISTFILE 用来存储命令历史的文件名
HISTSIZE 保存在命令历史中的命令数量
HOST 当前连接的数据库服务器主机
IGNOREEOF 如果取消设置，发送一个EOF给交互的会话将中断应用
LASTOID 最后一个受影响的 OID 的值
NAME=VALUE [NAME=VALUE] psql ...
或者 psql 中的 \setenv NAME [VALUE]
ON_ERROR_ROLLBACK 如果被设置，则错误不会停止一个事务（使用隐式保存点）
ON_ERROR_STOP 发生错误后停止批量执行
PAGER 外部分页程序的名称
PGAPPNAME 和application_name连接参数相同
PGDATABASE 和dbname连接参数相同
PGHOST 与主机连接参数相同
PGPASSFILE 口令文件名
PGPASSWORD 连接口令（不推荐）
PGPORT 与端口连接参数相同
PGUSER 与用户连接参数相同
PORT 当前连接的服务器端口
PROMPT1 指定标准的 psql 提示符
PROMPT2 指定在语句跨行时使用的提示符
PROMPT3 指定 COPY ... FROM STDIN 期间使用的提示符
PSQLRC 用户的.psqlrc文件的可选位置
PSQL_EDITOR, EDITOR, VISUAL
\e, \ef, 和 \ev 命令使用的编辑器
PSQL_EDITOR_LINENUMBER_ARG
调用编辑器时如何指定一个行号
PSQL_HISTORY 命令历史文件的可选位置
QUIET 静默地运行（和-q选项相同）
SHELL \! 命令使用的shell
SHOW_CONTEXT 控制消息上下文域的显示 [never, errors, always]
SINGLELINE 行尾会终止SQL命令模式（与-S选项相同）
SINGLESTEP 单步模式（与-s选项相同）
TMPDIR 临时文件的目录
USER 当前连接上的数据库用户
VERBOSITY 控制错误报告的冗长程度 [default, verbose, terse]
\! [命令] 在 shell中执行命令或启动一个交互式shell
\? [commands] 显示反斜线命令的帮助
\? options 显示 psql 命令行选项的帮助
\? variables 显示特殊变量的帮助
\C [字符串] 设置表的标题，或如果没有的标题就取消
\H 切换HTML输出模式 (目前是 %s)
\T [字符串] 设置HTML <表格>标签属性, 或者如果没有的话取消设置
\a 在非对齐模式和对齐模式之间切换
\c[onnect] {[DBNAME|- USER|- HOST|- PORT|-] | conninfo}
连接到新数据库（当前是"%s"）
\c[onnect] {[DBNAME|- USER|- HOST|- PORT|-] | conninfo}
连接到新数据库（当前无连接）
\cd [目录] 更改目前的工作目录
\conninfo 显示当前连接的相关信息
\copy ... 执行 SQL COPY，将数据流发送到客户端主机
\copyright 显示PostgreSQL的使用和发行许可条款
\crosstabview [COLUMNS] 执行查询并且以交叉表显示结果
\dC[+] [PATTERN] 列出类型强制转换
\dD[S+] [PATTERN] 列出共同值域
\dE[S+] [PATTERN] 列出引用表
\dF[+] [模式] 列出文本搜索配置
\dFd[+] [模式] 列出文本搜索字典
\dFp[+] [模式] 列出文本搜索解析器
\dFt[+] [模式] 列出文本搜索模版
\dL[S+] [PATTERN] 列出所有过程语言
\dO[S+] [PATTERN] 列出所有校对规则
\dT[S+] [模式] 列出数据类型
\d[S+] 列出表,视图和序列
\d[S+] 名称 描述表，视图，序列，或索引
\da[S] [模式] 列出聚合函数
\db[+] [模式] 列出表空间
\dc[S+] [PATTERN] 列表转换
\dd[S] [PATTERN] 显示没有在别处显示的对象描述
\ddp [模式] 列出默认权限
\des[+] [模式] 列出外部服务器
\det[+] [PATTERN] 列出引用表
\deu[+] [模式] 列出用户映射
\dew[+] [模式] 列出外部数据封装器
\df[antw][S+] [模式] 列出[只包括 聚合/常规/触发器/窗口]函数
\dg[S+] [PATTERN] 列出角色
\di[S+] [模式] 列出索引
\dl 列出大对象， 功能与\lo_list相同
\dm[S+] [PATTERN] 列出所有物化视图
\dn[S+] [PATTERN] 列出所有模式
\do[S] [模式] 列出运算符
\dp [模式] 列出表，视图和序列的访问权限
\drds [模式1 [模式2]] 列出每个数据库的角色设置
\ds[S+] [模式] 列出序列
\dt[S+] [模式] 列出表
\du[S+] [PATTERN] 列出角色
\dv[S+] [模式] 列出视图
\dx[+] [PATTERN] 列出扩展
\dy [PATTERN] 列出所有事件触发器
\e [FILE] [LINE] 使用外部编辑器编辑查询缓存区(或文件)
\echo [字符串] 将字符串写到标准输出
\ef [FUNCNAME [LINE]] 使用外部编辑器编辑函数定义
\encoding [编码名称] 显示或设定客户端编码
\errverbose 以最冗长的形式显示最近的错误消息
\ev [VIEWNAME [LINE]] 用外部编辑器编辑视图定义
\f [字符串] 显示或设定非对齐模式查询输出的字段分隔符
\g [文件] or; 执行查询 (并把结果写入文件或 |管道)
\gexec 执行策略，然后执行其结果中的每个值
\gset [PREFIX] 执行查询并把结果存到psql变量中
\h [名称] SQL命令语法上的说明，用*显示全部命令的语法说明
\i 文件 从文件中执行命令
\ir FILE 与 \i类似, 但是相对于当前脚本的位置
\l[+] [PATTERN] 列出所有数据库
\lo_export LOBOID 文件
\lo_import 文件 [注释]
\lo_list
\lo_unlink LOBOID 大对象运算
\o [文件] 将全部查询结果写入文件或 |管道
\p 显示查询缓存区的内容
\password [USERNAME] 安全地为用户更改口令
\prompt [文本] 名称 提示用户设定内部变量
\pset [NAME [VALUE]] 设置表输出选项
(NAME := {format|border|expanded|fieldsep|fieldsep_zero|footer|null|
numericlocale|recordsep|recordsep_zero|tuples_only|title|tableattr|pager|
unicode_border_linestyle|unicode_column_linestyle|unicode_header_linestyle})
\q 退出 psql
\qecho [字符串] 将字符串写到查询输出串流(参考 \o)
\r 重置(清除)查询缓存区
\s [文件] 显示历史记录或将历史记录保存在文件中
\set [名称 [值数]] 设定内部变量，若无参数则列出全部变量
\setenv NAME [VALUE] 设置或清空环境变量
\sf[+] FUNCNAME 显示一个函数的定义
\sv[+] VIEWNAME 显示一个视图的定义
\t [开|关] 只显示记录 (目前是 %s)
\timing [开|关] 切换命令计时开关 (目前是 %s)
\unset 名称 清空(删除)内部变量
\w 文件 将查询缓存区的内容写入文件
\watch [SEC] 每隔SEC秒执行一次查询
\x [on|off|auto] 切换扩展输出模式(目前是 %s)
\z [模式] 和\dp的功能相同
border 边界样式（数字）
columns 用于回卷格式的目标宽度
expanded (或者 x) 扩展输出 [on, off, auto]
fieldsep 用于非对齐输出的域分隔符（默认是 "%s"）
fieldsep_zero 将用于非对齐模式中的域分隔符设置为零字节
footer 启用或禁用表格页脚的显示 [on, off]
format 设置输出格式 [unaligned, aligned, wrapped, html, asciidoc, ...]
linestyle 设置边界线绘制风格 [ascii, old-ascii, unicode]
null 设置代替空值被打印的字符串
numericlocale 启用或者禁用分隔数字分组的区域相关字符的显示 [on, off]
pager 控制何时使用一个外部分页器 [yes, no, always]
psql --pset=NAME[=VALUE]
或者 psql 中的 \pset NAME [VALUE]
psql --set=NAME=VALUE
或者在 psql 中的 \set NAME VALUE
psql [选项]... [数据库名称 [用户名称]]
recordsep 用于非对齐输出中的记录（行）分隔符
recordsep_zero 将用于非对齐输出中的记录分隔符设置为零字节
set NAME=VALUE
psql ...
或者 psql 中的 \setenv NAME [VALUE]
tableattr (或者 T) 指定 html 格式中表标签的属性
或者 latex-longtable 格式中左对齐数据类型的比例列宽
title 为任何后续被打印的表设置表标题
tuples_only 如果被设置，只有真实的表数据会被显示
unicode_border_linestyle
unicode_column_linestyle
unicode_header_linestyle
设置 Unicode 线绘制的风格 [single, double]
%d个连接 %s %s %s (每 %gs)
%s
%s (%s, 服务器 %s)
%s (每 %gs)
%s.%s 不是一个视图
%s: %s
%s: -1 只能用于非交互模式下
%s：无法从目录复制或复制到目录
%s：无法删除变量 "%s"
%s: 找不到可执行文件
%s：无法开启日志文件 "%s"：%s
%s：无法设定列打印参数 "%s"
%s：无法设定变量 "%s"
%s：目前的事务被中止
%s：无效的编码名称或找不到转换程序
%s：尚未与数据库连接
%s: 内存溢出
%s：不明事务状态
%s：警告：忽略多余的命令行参数 "%s"
(%lu 行记录) ***(单步模式：验证命令)*******************************************
%s
***(按 Enter 键继续或键入 x 来取消)********************
********* 查询 **********
%s
**************************
+ opt(%d) = |%s|
, 已丛集 ,可延迟 ，开始被延迟 , 无效的 , 叙述 (%s) ,复制标识 , 表空间 "%s" 存取权限 没有可用的数据库连接，所以必须提供所有的连接参数
参数数据类型 收到来自服务器 "%s" 进程 PID %d 非同步通知。
从PID为%3$d的服务器进程接收到带有字节流量"%2$s"的异步通知消息"%1$s".
属性 可用的说明：
边缘风格是 %d。
绕过RLS COPY 数据转换失败：%s 调用函数 无法对表的内容添加单元: 总共有%d个单元超过.
无法对表的内容增加标题:已经超过%d列的数量.
无法登录 检查 检查约束限制 子表 校对规则 栏位 列特权 命令： %s
描述： %s
语法：
%s
合成类型 "%s.%s" 连接
建立 DB 建立角色 Ctype 数据库 默认的访问权限 关闭默认步进器。
打开默认步进器。
预设？ 定义 描述 目的地 字典 没有找到任何名称为 "%s" 的扩展。
没有找到任何扩展.
没有找到任何名称为 "%s" 的关联。
没有找到任何OID为 %s 的关联。
没有找到任何命名为 "%s" 的文本搜索组态。
没有找到任何命名为 "%s" 的文本剖析器。
禁用内部触发器： 已停用规则： 停用触发器： 禁用用户触发器: 成员 使能 字元编码 结束剖析 输入要复制的数据并且换行。
在独立的一行上输入一个反斜线和一个句点结束。 再次输入： 输入新的密码： Event 扩展显示已关闭。
扩展显示已打开。
扩展显示已自动打开。
FDW选项 失败。
栏位分隔符号是 "%s"。
栏位分隔符号是0字节
引用的外部表 "%s.%s" 外部数据封装器 外部键(FK)限制： 格式化
函数 一般性
通用选项:
取得首行 取得下一个标志符 取得标志符类型 处理函数 有 OIDs:yes 帮助
ID 隐含的? 索引 "%s.%s" 索引： 资讯性
继承 初始化 初始选项 内联函数 输入/输出
内部语言 内部名称 已中断
无效的命令 \%s，用 \? 查看帮助。
程序语言 大对象
大型对象 左参数类型 词汇 文本的风格是%s.
聚集函数列表 类型转换列表 校对列表 字元编码转换列表 数据类型列表 数据库列表 共同值域列表 事件触发器列表 外部服务器列表 引用表列表 外部数据封装器列表 函数列表 已安装扩展列表 语言列表 运算子列表 关联列表 角色列表 架构模式列表 设置的列表 特殊对待的变量的列表
表空间列表 文本搜索组态列表 文本搜索字典列表 文本剖析器列表 文本搜索样式列表 列出用户映射 关闭语言环境调整后的数值输出。
启动语言环境调整后的数值输出。
所在地 物化视图 "%s.%s" 成员属于 方法 修饰词 修饰词 名称 没有发生更改 没有连接 没有 "%s" 的帮助说明.
请尝试用不带参数的 \h 来看一下是否有可使用的帮助信息.
没有继承 没有找到符合的关联。
没有找到所匹配的设置.
在这个版本的服务器中不支持对每个数据库的角色进行设定.
找不到关联。
没有找到设置.
"%s" 是空值显示。
子表的数量：%d(可以使用 \d+ 来列出它们) 对象 对象描述 对象描述 对象用于扩展 "%s" 操作系统
选项 输出格式是 %s。
属于: %s 拥有者 总是使用分页器。
显示大量数据时使用分页器。
不使用分页器。
分页器不能被用于少于%d行。
密码加密失败。
用户 %s 的口令： 密码有效直至 口令： 两次密码不匹配。
策略 策略（强制行安全性启用）： 策略（强制行安全性启用）：（无） 策略（行安全性禁用）： 策略（行安全性启用）：（无） 策略： 保留上一次连接
过程 查询缓存区
查询缓存区是空的。 查询缓存区重置(已清空)。 记录分隔符号是 "%s"。
记录分隔符号是 <newline>。
记录分隔符号是 0字节。
由引用： 复制标识 复制 臭虫报告至 <pgsql-bugs@postgresql.org>.
结果数据类型 结果类型 右参数类型 角色 角色名称 永远触发规则 只有在复制时触发规则: 规则： SSL 连接（协议：%s，密码：%s，密钥位：%s，压缩：%s)
语句：%s
架构模式 安全 序列数 "%s.%s" 服务器 设置 大小 来源 原始程式 来源类型 特殊关联 "%s.%s" 开始剖析 统计目标 存储 完成。
超级用户 TOAST 数据表 "%s.%s" 数据表 数据表 "%s.%s" 表属性是 "%s".
未设置数据表属性。
表空间 表空间："%s" 标签 目标类型 目标宽度为 %d.
目标宽度未设置.
模版 文本搜索组态 "%s" 文本搜索组态 "%s.%s" 文本搜索剖析器 "%s" 文本搜索剖析器 "%s.%s" 与服务器的连接已断开，正在试图重置: 该输入是一个PostgreSQL自定义格式的转储。
请使用pg_restore命令行客户端来将这个转储恢复到数据库。
服务器(版本%d.%d)不支持修改默认权限.
服务器(版本%d.%d)不支持排序校对。
服务器(版本%d.%d)不支持编辑函数源码.
服务器（版本%d.%d）不支持编辑视图定义。
服务器(版本%d.%d) 不支持使用扩展.
服务器(版本%d.%d)不支持使用外部服务器.
服务器(版本%d.%d)不支持使用引用表.
服务器(版本%d.%d)不支持使用外部数据封装器。
服务器(版本%d.%d)不支持使用全文搜索.
服务器(版本 %d.%d)不支持保存点(Savepoint)ON_ERROR_ROLLBACK。
服务器(版本%d.%d)不支持显示函数源码.
服务器（版本%d.%d）不支持显示视图定义。
服务器(版本%d.%d) 不支持使用表空间.
服务器(版本%d.%d)不支持使用用户映射。
没有之前的错误。 时间：%.3f ms
停止计时功能. 启用计时功能. 标题是 "%s"。
无标题。
标志符 标志名称 标志符类型给剖析器 "%s" 标志符别型给剖析器 "%s.%s" 永远激活触发器 只有在复制时激活触发器 触发器： 信任 尝试 "%s --help" 以得到更多信息。
关闭只显示元组。
开启只显示元组。
类型 输入 "help" 来获取帮助信息.
键入： \copyright 显示发行条款
\h 显示 SQL 命令的说明
\? 显示 pgsql 命令的说明
\g 或者以分号(;)结尾以执行查询
\q 退出
类型的已确定类型表(typed table):%s Unicode 边界线型是 "%s"。
Unicode 列线型是 "%s"。
Unicode 页眉线型是 "%s"。
不记录日志的索引 "%s.%s" 不记录日志的物化视图 "%s.%s" 不记录日志的表 "%s.%s" 使用方法:
使用 "\q" 离开 %s。
用户名: 验证 值 变量
版本 视图 "%s.%s" 视图定义: 挥发性 警告：%s 主版本%d.%d,服务器主版本为%d.%d.
一些psql功能可能无法正常使用。
警告：来自 Windows 代码页 (%u) 的控制台代码页 (%u) 的差异
8-bit 字符可能无法正常工作。请查阅 psql 参考
页 "Windows 用户注意事项" 的详细说明。
写入历史记录到文件 "%s".
以用户 "%2$s" 的身份, 在主机"%3$s", 端口"%4$s"连接到数据库 "%1$s"
以用户 "%2$s" 的身份，通过套接字"%3$s"在端口"%4$s"连接到数据库 "%1$s"
你目前没有连接到数据库。
您现在已经连接到数据库 "%s", 用户 "%s",主机 "%s",端口号 "%s".
您现在已经连接到数据库 "%s", 用户名 "%s" , 套接字 "%s", 端口号 "%s".
您现在已经连接到数据库 "%s",用户 "%s".
您正在使用psql, 这是一种用于访问PostgreSQL的命令行界面 \!：失败
\%s: 无法切换目录至 "%s": %s
\%s: 环境变量不能包含 "="
\%s: 设定变量值时出错
\%s：忽略多余的参数 "%s"
\%s：缺少所需参数
\连接：%s \copy：需要参数
\copy：在 "%s" 发生解读错误
\copy：在行尾发生解读错误
\df 不能有带着服务器版本%d.%d 的选项"w"
\df 只能将 [antwS+]作为选项
\pset：允许的 Unicode 边界线型是 single 和 double
\pset：允许的 Unicode 列线型是 single 和 double
\pset：允许的 Unicode 页眉线型是 single 和 double
\pset: 允许的格式是 unaligned, aligned, wrapped, html, asciidoc, latex, latex-longtable, troff-ms
\pset: 所允许使用的文本风格是ASCII, OLD-ASCII, UNICODE
\pset: 不明选项: %s
\watch不能用于COPY命令中
\watch命令不能用于空查询
简写形式的可授予或回收的权限 中止目前的事务 因读取失败已被中止 access_method_type 操作 agg aggregate_name aggregate_signature 别名 顺序排列(alignment) allowconn 经常 分析_函数 aggregate_signature指的是: 并且conflict_action是下列之一： 并且grouping_element可以是下列之一： like_选项是 表约束是: table_constraint_using_index 是: with查询语句是： arg_data_type 参数名称 参数类型 参数模式 参数名称 参数类型 参数 参数类型 参数 属性 属性_名称 属性选项 基础_类型 布尔 缓存 调用函数 没有数据库连接时无法escape
取消一个可以为两阶段提交容易配置的事务 依用户取消 无法复制空指针 (内部错误)
标准_函数 类型 更改一个数据库 更改数据库角色 更改一个运行期参数 更改服务器的配置参数 更改角色名称或成员状态 更改校对规则的定义 更改一个字符编码转换的定义 更改共同值域的定义 更改外部服务器的定义 更改外部表的定义 更改外部数据封装器的定义 更改函数的定义 更改大对象的定义 更改物化视图的定义 更改程序语言的定义 更改一条行级安全性策略的定义 更改规则的定义 更改架构模式的定义 更改序列数产生器的定义 更改数据表的定义 更改表空间的定义 更改一个文本搜索组态的定义 更改一个文本搜索字典的定义 更改一个文本搜索剖析器的定义 更改一个文本搜索模版的定义 更改触发器的定义 更改数据类型的定义 更改用户映射的定义 更改视图的定义 更改聚集函数的定义 更改事件触发器的定义 更改扩展的定义 更改索引的定义 更改运算子的定义 更改运算子类别的定义 更改一个运算子家族的识别 依照一个数据库角色拥有的的数据库对象来更变所有权 通道 check_expression 子进程结束，结束代码 %d 子进程结束，不明状态代码 %d 子进程被异常(exception) 0x%X 终止 子进程被信号 %d 终止 子进程被信号 %s 终止 关闭游标 按照索引进行表的聚集 编码 要校对的 校对%s 校对规则 收集数据库的统计信息 列的别名 列约束 列定义 列名称 列的类型 交换操作符 combinefunc 命令 无法执行命令 没有找到命令 提交一项事务这是两阶段提交的先前准备 确认目前的事务 计算一个数据列的集合 条件 配置参数 conflict_action conflict_target 与数据库的连接已经断开
连接限制 约束 约束名称 在档案和数据表间复制数据 无法跳转到目录 "%s" 中: %s 无法为外部命令: %s关闭管道
无法执行命令 "%s": %s
未能找到一个 "%s" 来执行 无法获取用户ID %ld: %s对应的home 目录
无法识别目前目录：%s 找不到临时目录：%s
无法找到有效的用户ID %ld: %s 无法打开临时文件 "%s": %s
无法读取二进制码 "%s" 无法从输入档案读取：%s
无法读取符号链接 "%s" 无法将历史记录储存到 "%s"：%s
无法设置变量 "%s"
无法启动 /bin/sh
无法启动编辑器 "%s"
无法获取文件 "%s":%s 的状态
无法写入 COPY 数据：%s
查询所用返回记录的最大数量 建立新的数据库 在表中创建新数据行 游标名称 数据_类型 数据库名称 释放一个已预备好的叙述区块 默认 默认 %s 默认_表达式 建立一个 cursor 定义新的访问方法 定义一个新的聚集函数 建立新的类型转换 建立新的校对规则 建立新的数据类型 定义一个新数据库角色 建立新的共同值域 定义一个新的字元编码转换 定义新的事件触发器 建立新的触发器 建立新的外部表 定义一个新的外部数据封装器 建立新的函数 建立新的索引 将用户的新映射定义到一个外部服务器 建立新的物化视图 建立新的运算子 建立新的运算子类别 定义一个新的运算子家族 建立新的程序语言 建立新的重写规则 为一个表定义一条新的行级安全性策略 在当前事务中建立新的储存点(Savepoint) 建立新的架构模式 建立新的序列数产生器 建立新的数据表 以查询结果建立新的数据表 建立新的表空间 定义一个新文本搜索组态 定义一个新文本搜索字典 定义一个新文本搜索剖析器 定义一个新文本搜索模版 定义一个新的转换 建立新的触发器 建立新的视图 定义存取权限 定义默认的访问权限 定义或更改一个对象的安全标签 定义或更改一个对象的注解 定义者 定义 delete 删除数据表中的数据列 分隔符 分隔字符 deserialfunc 目的_编码 删除先前建立的储存点(Savepoint) 字典名称 方向 目录 禁用 抛弃 session 状态 域约束 域_约束 域_名称 成员项 空的数据表或数据表集合 启用 字符集编码 encoding_name(编码名) 结束_函数 必须设置环境变量 PSQL_EDITOR_LINENUMBER_ARG，用于指定行号
转义字符 事件 排除项 在EXCLUDE约束中的排除项是： 执行一个已准备好的语句块 执行一个匿名代码块 执行函数的开销 existing_collation(当前的本地化语言) existing_enum_value 表达式 extension_name(扩展名) 操作符群的名称 外部数据封装器的名称 计算最终结果集的函数名称 文件名 过滤器变量 给数据表 "%s.%s" 强制一个事务触发检查点 所引用的外表 格式_名称 from列表中项 from列表(from_list) from_sql_function_name 函数 需要函数名
函数名称 垃圾收集(GC)并选择地分析数据库 产生通知 获取下一个符号函数的名称 组名称 grouping_element handler_function(处理_函数) 标题_函数 这个安装不支援命令记录
不可更改 从一个外部服务器导入表定义 在指派中 增量 索引 index_column_name index_expression 访问索引的方法 索引名称 索引参数 在UNIQUE, PRIMARY KEY和EXCLUDE中的索引参数是： index_predicate 初始化_函数 初始条件 匿名代码块 输入_函数 insert 安装一个扩展 整数 内部长度 无效的二进制码 "%s" 无效的命令 \%s
行号无效: %s
无效的输出格式 (内部错误): %d 调用者 istemplate 用于连接操作的列 用连接操作的条件 连接选择性估算函数 连接操作的类型 标签 语言名称 大对象的OID 排序规则 字符分类 操作符左边操作数的类型 LEXIZE函数 语义类型_函数 like选项 LIKE类型(like_type) 链接_符号 等待通知 加载一个共享库文件 本地接口 local_schema 本地化语言 锁定数据表 锁模式 loid 物化视图 最大值 member_object 方法 mffunc minitial_condition 最小值 minvfunc \gset返回超过１个记录行
msfunc mstate_data_size mstate_data_type 名称 取负操作符 new_attribute_name(新属性名) new_column_name(新列名) new_constraint_name(新约束名) 新的字典 new_enum_value(新枚举名) 新的名称 新的属主 新的角色 新的模式 新的表 新的表空间 新版本 否 没有查询缓存区
\gset没有记录行返回
常规 非空 空字符串 目标文件 对象_名称 关闭 旧的字典 旧的角色 老版本 开启 操作数类型 操作符类型的名称 运算子 操作符类 操作符家族 操作符名称 选项 或者是旧的语法 内存用尽 内存耗尽
输出表达式 输出_函数 输出名称 参数 父表 解析器名称 口令 消息中负载流量(payload) pclose调用失败: %s policy_name 移动游标位置 述词 优先 预先编译语句以执行 准备将当前事务进行二段式提交 主键(PK), provider(提供者) psql是PostgreSQL 的交互式客户端工具。
psql变量：
查询 引用字符 重新建构索引 接收_函数 所引用的列 被引用表的名称 所引用的表 relation_name(关系名) remote_schema 移除一个类型转换 移除一个校对规则 移除一个字元编码转换 移除数据类型 移除数据库 移除一个数据库成员 移除一个共同值域 删除一个外部服务器描述符 移除外部引用表 删除一个外部数据封装器 移除函数 移除一个物化视图 移除一个程序语言 移除一个重写规则 从一个表移除一条行级安全性策略 移除一个模式 移除序列 移除数据表 移除一个表空间 移除一个文本搜索配置 移除一个文本搜索字典 移除一个文本搜索剖析器 移除一个文本搜索模版 移除一个转换 移除触发器 为外部服务器删除用户映射 移除一个视图 移除存取权限 移除一种访问方法 移除一个聚集函数 移除事件触发器 移除一个扩展 移除一个索引 移除运算子 移除一个运算子类别 移除一个运算子家族 依照一个数据库角色拥有的数据库对象来移除 替换物化视图的内容 replica 限制选择性估算函数 重新启动后的序列值 将执行时期参数还原成预设值 返回记录的数量 从使用游标的查询读取数据 从数据表或视图中读取数据 返回类型 重写规则名称 操作符右边操作数的类型 角色名称 role_specification 还原至一个储存点(Savepoint) 规则 规则_名称 sampling_method 保存点名称 模式中对象 模式名称 种子 查询 发送_函数 序列数 序列名称 serialfunc serialtype 服务器名称 服务器类型 服务器版本 为当前事务设定约束限制检查的时间模式 设定当前事务属性 为当前会话的当前用户的设置身份标识 为当前会话设置会话用户标识符和当前用户标识符 状态转换函数名称 显示一个语句块的执行计划 显示运行期的参数值 跳过变量 "%s"的递归扩展
快照id 排序表达式 sort_family_name(排序家族名) 排序_操作符 已存在的文本搜索配置名称 源_编码 源表 类型指派中的源数据类型 特殊 稳定 起始值 开始一个事务区块 启动_函数 state_data_size 状态值的数据类型 语句 停止监听通知 存储 存储参数 存储类型 访问索引所用方法的编号 sub-SELECT 子类型 subtype_diff_function(子类型_区分_函数) subtype_operator_class(子类型_操作符_类) 访问索引所使用函数的编号 自动补全查询失败: %s
查询是:
%s
数据表 表约束 表约束 table_constraint_using_index(表约束使用索引) 表名 表空间的名称 表空间_选项 目标角色 类型指派中的目标数据类型 模版 文本 时间戳 时区 to_sql_function_name 符号类型 事务_ID 事务模式 触发器 触发器_名称 正在尝试退出 类型Ctype 类型修改器数组输入函数名称 类型修改器输出函数名称 类型名称 uid 意外的 PQresultStatus: %d
\Watch出现意外的结果状态
意外的事务状态值 (%d)
唯一的, 未知 "%2$s"的不能识别的值"%1$s"；假定为"%3$s"
未结束的引用字符串
update 更新数据表中的数据列 用户不存在 用户名查找失败：错误代码%lu 用户名 using_expression USING列表(using_list) 验证函数 validator_function(验证_函数) 值 值 version(版本) 视图 需要视图名
view_option_name(视图选项名) view_option_value(视图选项值) 不稳定性 简写形式的可授予或回收权限是下列内容之一 操作可以是下列选项之一 其中 aggregate_signature 是: 列的约束是: 这里conflict_target可以是下列之一： 约束是: 方向可以为空或者是下列选项之一： 事件可以下述之一: from 列表中的项可以是下列内容之一 锁模式可以是下列选项之一: member_object的位置: 选项可以是下列内容之一: 选项可以是 这里role_specification可以是： 事务模式可以是下列选项之一: 窗口 窗口定义 窗口名称 with查询语句(with_query) WITH查询语句名称(with_query_name) 是 locale/cs/LC_MESSAGES/libpq5-9.6.mo 0000644 00000055532 14751153421 0012255 0 ustar 00 �� � | � 0 1 B E J P b
x ' � ( � � # � - $ : _ y
� 0 � ( � ( � * 6 5 = 8 s 0 � � $ � # # G S - e 8 � � � . ( 3 , \ � � : � " � ! < 2 a o 0 � ) ' , * T . + � ' � ' * * * U + � * � , � ) ) . + X - � / � + � ( ) 7 & a 5 � 3 � & � ! ; V k " � v � w ! r � ! - O ' l - � � � # V 9 z & � ) � * # 0 9 T ) � ' � ) �
) ( " R 9 u . � ' � * ! " 1! " T! . w! / �! - �! @ " 2 E" ! x" % �" % �" & �" V
# = d# ; �# �# �# $ 4 ;$ 0 p$ �$ : �$ �$ % :% - [% - �% �% + �% 2 �% 7 2& = j& ! �& . �& 8 �& " 2' U' F u' C �' $ ( %( B @( �( �( ; �( ( �( * ) & @) % g) ! �) 6 �) C �) ? ** 2 j* 1 �* = �* )
+ J 7+ �+ �+ �+ �+ �+ 1 ,
7, E, + T, �, ) �, " �, [ �, H- ? a- 1 �- 8 �- > . � K. # �. �. : / � @/ 2 �/ Q �/ J O0 K �0 �0 1 1 ? .1 ! n1 + �1 �1 �1 L �1 D 62 % {2 . �2 C �2 3 $ 53 5 Z3 ) �3 � �3 �5 �5 �5 �5 �5 �5
�5 . �5 / 6 ! 56 % W6 }6 �6 & �6 �6 �6 7 8 7 * T7 * 7 �7 �7 �7 : �7 = 8 7 I8 " �8 ' �8 # �8 �8 �8 / 9 9 C9 }9 " �9 8 �9 & �9 + : C: Y: 8 h: $ �: �: �: @ �: � 9; = �; * < $ 1< 4 V< 8 �< 5 �< 8 �< , 3= ! `= " �= " �= ! �= # �= > /> " P> $ s> & �> " �> �> ? #? B B? C �? ' �? * �? @ <@ V@ p@ w �@ t A o |A �A B -B ! HB + jB � �B 6 BC = yC * �C ( �C , D " 8D B [D 4 �D 0 �D 0 E 5E - VE ! �E @ �E 9 �E $ !F ) FF pF % �F . �F 0 �F 2 G > JG 6 �G ! �G ! �G + H + 0H j \H D �H K I ! XI ! zI ! �I > �I 2 �I 0J : OJ �J �J �J * �J * K 9K 1 WK 6 �K : �K H �K & DL 4 kL ? �L & �L ! M M )M J wM ) �M �M O N [N kN G �N - �N 7 O C :O ' ~O + �O 4 �O K P 8 SP : �P 7 �P J �P 9 JQ U �Q �Q + �Q R 8 7R # pR , �R �R �R / �R ' S ) @S jS � �S ,T < FT 4 �T ; �T ? �T � 4U ' �U �U O �U � KV 1 �V Z W V mW Q �W . X EX aX I uX % �X A �X 'Y HY N hY F �Y - �Y 0 ,Z < ]Z �Z " �Z H �Z 2 '[ � l � A � O � m . M f � d � H @ � t * � k U � 4 � � a � � / G � T % � 5 Y u �
, � � r � � R 7 6 � � � z � � S : ! ; 1 [ L � - � Z � x ` s n � " � K ' � � y
b � 8 3 � � � � = ^ # < � � � � c F ( � \ p v Q N � � � 9 � ~ q � � o � � J � B w $ V } W D � E � � 2 � h � & i � _ � � 0 � � � � X > � g e ? ) � � � � + � | I { � � C ] j � � � P � � � at character %s %s %s, %s:%s COLUMN NAME: %s
CONSTRAINT NAME: %s
CONTEXT: %s
COPY IN state must be terminated first
COPY OUT state must be terminated first
COPY terminated by new PQexec Crypt authentication not supported
DATATYPE NAME: %s
DETAIL: %s
GSSAPI authentication not supported
GSSAPI continuation error GSSAPI name import error HINT: %s
IPv6 host address may not be empty in URI: "%s"
Kerberos 4 authentication not supported
Kerberos 5 authentication not supported
LINE %d: LOCATION: NOTICE PGEventProc "%s" failed during PGEVT_CONNRESET event
PGEventProc "%s" failed during PGEVT_RESULTCREATE event
PGresult cannot support more than INT_MAX tuples PGresult is not an error result
PQexec not allowed during COPY BOTH
PQgetline: not doing text COPY OUT
QUERY: %s
SCHEMA NAME: %s
SCM_CRED authentication method not supported
SCRAM authentication requires libpq version 10 or above
SSL SYSCALL error: %s
SSL SYSCALL error: EOF detected
SSL certificate's name contains embedded null
SSL certificate's name entry is missing
SSL connection has been closed unexpectedly
SSL error code %lu SSL error: %s
SSL library does not support CRL certificates (file "%s")
SSPI authentication not supported
SSPI continuation error TABLE NAME: %s
Unix-domain socket path "%s" is too long (maximum %d bytes)
WARNING: password file "%s" has group or world access; permissions should be u=rw (0600) or less
WARNING: password file "%s" is not a plain file
WSAIoctl(SIO_KEEPALIVE_VALS) failed: %ui
another command is already in progress
argument of lo_read exceeds integer range
argument of lo_truncate exceeds integer range
argument of lo_write exceeds integer range
attribute has no values on LDAP lookup
authentication method %u not supported
cannot determine OID of function lo_close
cannot determine OID of function lo_creat
cannot determine OID of function lo_create
cannot determine OID of function lo_lseek
cannot determine OID of function lo_lseek64
cannot determine OID of function lo_open
cannot determine OID of function lo_tell
cannot determine OID of function lo_tell64
cannot determine OID of function lo_truncate
cannot determine OID of function lo_truncate64
cannot determine OID of function lo_unlink
cannot determine OID of function loread
cannot determine OID of function lowrite
certificate could not be obtained: %s
certificate does not match private key file "%s": %s
certificate present, but not private key file "%s"
column number %d is out of range 0..%d command string is a null pointer
connection in wrong state
connection not open
connection pointer is NULL
could not acquire SSPI credentials could not connect to server: %s
Is the server running locally and accepting
connections on Unix domain socket "%s"?
could not connect to server: %s
Is the server running on host "%s" (%s) and accepting
TCP/IP connections on port %s?
could not connect to server: %s
Is the server running on host "%s" and accepting
TCP/IP connections on port %s?
could not create LDAP structure
could not create SSL context: %s
could not create socket: %s
could not establish SSL connection: %s
could not get client address from socket: %s
could not get home directory to locate root certificate file
Either provide the file or change sslmode to disable server certificate verification.
could not get peer credentials: %s
could not get server's host name from server certificate
could not get socket error status: %s
could not initialize SSL engine "%s": %s
could not interpret result from server: %s could not load SSL engine "%s": %s
could not load private SSL key "%s" from engine "%s": %s
could not load private key file "%s": %s
could not look up local user ID %d: %s
could not open certificate file "%s": %s
could not open file "%s": %s
could not read certificate file "%s": %s
could not read from file "%s": %s
could not read private SSL key "%s" from engine "%s": %s
could not read root certificate file "%s": %s
could not receive data from server: %s
could not send SSL negotiation packet: %s
could not send data to server: %s
could not send startup packet: %s
could not set socket to TCP no delay mode: %s
could not set socket to close-on-exec mode: %s
could not set socket to nonblocking mode: %s
could not translate Unix-domain socket path "%s" to address: %s
could not translate host name "%s" to address: %s
could not write to file "%s": %s
definition of service "%s" not found
duplicate GSS authentication request
duplicate SSPI authentication request
end of string reached when looking for matching "]" in IPv6 host address in URI: "%s"
expected authentication request from server, but received %c
extra key/value separator "=" in URI query parameter: "%s"
extraneous data in "D" message extraneous data in "T" message extraneous data in "t" message forbidden value %%00 in percent-encoded value: "%s"
function requires at least protocol version 3.0
host name must be specified
host name must be specified for a verified SSL connection
incomplete multibyte character
insufficient data in "D" message insufficient data in "T" message integer of size %lu not supported by pqGetInt integer of size %lu not supported by pqPutInt invalid ExecStatusType code invalid LDAP URL "%s": invalid port number
invalid LDAP URL "%s": missing distinguished name
invalid LDAP URL "%s": must have exactly one attribute
invalid LDAP URL "%s": must have search scope (base/one/sub)
invalid LDAP URL "%s": no filter
invalid LDAP URL "%s": scheme must be ldap://
invalid URI propagated to internal parser routine: "%s"
invalid URI query parameter: "%s"
invalid connection option "%s"
invalid connection state %d, probably indicative of memory corruption
invalid connection state, probably indicative of memory corruption
invalid percent-encoded token: "%s"
invalid port number: "%s"
invalid setenv state %c, probably indicative of memory corruption
invalid socket
invalid sslmode value: "%s"
invalid state %c, probably indicative of memory corruption
keepalives parameter must be an integer
length must be given for binary parameter
line %d too long in service file "%s"
local user with ID %d does not exist
lookup on LDAP server failed: %s
lost synchronization with server, resetting connection lost synchronization with server: got message type "%c", length %d
message contents do not agree with length in message type "%c"
message type 0x%02x arrived from server while idle missing "=" after "%s" in connection info string
missing key/value separator "=" in URI query parameter: "%s"
more than one entry found on LDAP lookup
nested service specifications not supported in service file "%s", line %d
no COPY in progress
no SSL error reported no connection to the server
no entry found on LDAP lookup
no error message available
number of parameters must be between 0 and 65535
out of memory out of memory
out of memory allocating GSSAPI buffer (%d) out of memory for query result parameter number %d is out of range 0..%d password retrieved from file "%s"
private key file "%s" has group or world access; permissions should be u=rw (0600) or less
protocol error: id=0x%x
query to initialize large object functions did not return data
received invalid response to SSL negotiation: %c
requirepeer parameter is not supported on this platform
requirepeer specifies "%s", but actual peer user name is "%s"
root certificate file "%s" does not exist
Either provide the file or change sslmode to disable server certificate verification.
row number %d is out of range 0..%d select() failed: %s
server certificate for "%s" does not match host name "%s"
server closed the connection unexpectedly
This probably means the server terminated abnormally
before or while processing the request.
server does not support SSL, but SSL was required
server sent binary data ("B" message) without prior row description ("T" message) server sent data ("D" message) without prior row description ("T" message) server sent data ("D" message) without prior row description ("T" message)
service file "%s" not found
setsockopt(%s) failed: %s
size_t overflow sslmode value "%s" invalid when SSL support is not compiled in
statement name is a null pointer
syntax error in service file "%s", line %d
timeout expired
unexpected asyncStatus: %d
unexpected character "%c" at position %d in URI (expected ":" or "/"): "%s"
unexpected character %c following empty query response ("I" message) unexpected field count in "D" message unexpected message from server during startup
unexpected response from server; first received character was "%c"
unrecognized SSL error code: %d
unrecognized socket error: 0x%08X/%d unterminated quoted string in connection info string
user name lookup failure: error code %lu
Project-Id-Version: libpq-cs (PostgreSQL 9.3)
Report-Msgid-Bugs-To: pgsql-bugs@postgresql.org
POT-Creation-Date: 2018-07-13 15:58+0000
PO-Revision-Date: 2018-08-06 19:43+0200
Last-Translator: Tomas Vondra <tv@fuzzy.cz>
Language-Team: Czech <info@cspug.cx>
Language: cs
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Plural-Forms: nplurals=3; plural=(n==1) ? 0 : (n>=2 && n<=4) ? 1 : 2;
X-Generator: Poedit 2.0.7
na znaku %s %s %s, %s:%s NÁZEV SLOUPCE: %s
NÁZEV OMEZENÍ: %s
KONTEXT: %s
COPY IN status musí být nejdříve ukončen
COPY OUT status musí být nejdříve ukončen
COPY bylo ukončeno novým PQexec Crypt autentizace není podporována
NÁZEV DATOVÉHO TYPU: %s
DETAIL: %s
GSSAPI autentizace není podporována
Přetrvávající chyba GSSAPI chyba importu GSSAPI jména DOPORUČENÍ: %s
IPv6 adresa hostitele v URI nesmí být prázdná: "%s"
Kerberos 4 autentizace není podporována
Kerberos 5 autentizace není podporována
ŘÁDKA %d: UMÍSTĚNÍ: POZNÁMKA PGEventProc "%s" selhalo během události PGEVT_CONNRESET
PGEventProc "%s" selhala během události PGEVT_RESULTCREATE
PGresult nemůže podporovat více než INT_MAX řádek PGresult není chybový výsledek
PQexec není povoleno během COPY BOTH
PQgetline: not doing text COPY OUT
DOTAZ: %s
NÁZEV SCHÉMATU: %s
SCM_CRED metoda autentizace není podporována
SCRAM autentizace vyžaduje libpq verze 10 nebo vyšší
SSL SYSCALL chyba: %s
SSL SYSCALL chyba: detekován EOF
jméno SSL certifikátu obsahuje vloženou null hodnotu
SSL certifikátu chybí položka name
SSL spojení bylo neočekávaně ukončeno
SSL chybový kód %lu SSL chyba: %s
knihovna SSL nepodporuje CRL certifikáty (soubor "%s")
SSPI autentizace není podporována
Přetrvávající chyba SSPI NÁZEV TABULKY: %s
Cesta k unixovému "%s" je příliš dlouhá (maximum %d bytů)
UPOZORNĚNÍ: Soubor s hesly "%s" má přístupová práva pro čtení pro skupinu nebo všechny uživatele; práva by měla být u=rw (0600)
VAROVÁNÍ: soubor s hesly "%s" není prostý (plain) soubor
WSAIoctl(SIO_KEEPALIVE_VALS) selhalo: %ui
zpracovává se již jiný příkaz
agrument pro lo_read přesahuje rozsah typu integer
argument pro lo_truncate přesahuje rozsah typu integer
agrument pro lo_write přesahuje rozsah typu integer
atribut nemá žádnou hodnotu při LDAP vyhledávání
autentizační metoda %u není podporována
nelze určit OID funkce lo_close
nelze určit OID funkce lo_create
nelze určit OID funkce lo_create
nelze určit OID funkce lo_lseek
nelze určit OID funkce lo_lseek64
nelze určit OID funkce lo_open
nelze určit OID funkce lo_tell
nelze určit OID funkce lo_tell64
nelze určit OID funkce lo_truncare
nelze určit OID funkce lo_truncare64
nelze určit OID funkce lo_unlink
nelze určit OID funkce loread
nelze určit OID funkce lowrite
certifikát nelze získat: %s
certifikát nesouhlasí se souborem privátního klíče "%s": %s
certifikát je přítomen, ale soubor privátního klíče ne "%s"
číslo sloupce %d je mimo rozsah 0..%d řetězec příkazu je prázdný ukazatel
spojení je ve špatném stavu
spojení není otevřeno
pointer spojení je NULL
nelze získat SSPI credentials nelze navázat spojení se serverem: %s
Je spuštěn server lokálně a akceptuje
spojení pomocí Unix soketu "%s"?
nelze navázat spojení se serverem: %s
Je server na "%s" (%s) spuštěn a akceptuje
TCP/IP spojení na portu %s?
nelze navázat spojení se serverem: %s
Je server na "%s" spuštěn a akceptuje
TCP/IP spojení na portu %s?
nelze vytvořit LDAP strukturu
nelze vytvořit SSL kontext: %s
nelze vytvořit soket: %s
nelze vytvořit SSL spojení: %s
nelze získat adresu klienta ze soketu: %s
nelze určit domácí adresář pro nalezení souboru s kořenovým certifikátem
Buď poskytněte soubor nebo změňte ssl mód tak, aby neověřoval certifkát serveru.
nelze získat informace (credentials) protistrany: %s
ze serverového certifikátu nelze získat host name serveru
nelze obdržet chybový status soketu: %s
nelze inicializovat SSL engine "%s": %s
nelze interpretovat výsledek ze serveru: %s nelze nahrát SSL engine "%s": %s
nelze načíst soubor privátního klíče "%s" z enginu "%s": %s
nelze načíst soubor privátního klíče "%s": %s
nelze vyhledat lokálního uživatele ID %d: %s
nelze otevřít soubor s certifikátem "%s": %s
nelze otevřít soubor "%s": %s
nelze číst soubor s certifikátem "%s": %s
nelze číst ze souboru "%s": %s
nelze číst soubor privátního klíče "%s" z enginu "%s": %s
nelze číst soubor s kořenovým certifikátem "%s": %s
nelze přijmout data ze serveru: %s
nelze poslat SSL "negotiation paket": %s
nelze poslat data na server: %s
nelze poslat počáteční paket: %s
nelze nastavit "no delay" mód TCP soketu: %s
nelze nastavit soket do close-on-exec módu: %s
soket nelze nastavit do neblokujícího módu: %s
nemohu přeložit cestu Unix-domain soketu "%s" na adresu: %s
nemohu přeložit jméno hostitele "%s" na adresu: %s
nelze zapsat do souboru "%s": %s
definice služby "%s" nenalezena
duplikátní GSS autentizační požadavek
duplicitní SSPI autentizační požadavek
při hledání odpovídajícího znaku "]" v IPv6 adrese hostitele byl dosažen konec řetězce URI: "%s"
očekáván byl autentizační dotaz ze serveru, ale přijat byl %c
přebytečný oddělovač klíče/hodnoty "=" v URI parametru dotazu: "%s"
přebytečná data v "D" zprávě přebytečná data v "T" zprávě přebytečná data v "t" zprávě zakázaná hodnota %%00 v procenty-k´odované hodnotě: "%s"
funkce vyžaduje protokol alespoň 3.0 a vyšší
host musí být specifikován
host musí být specifikován pro ověřené SSL spojení
nekompletní multibyte znak
nedostatek dat v "D" zprávě nedostatek dat v "T" zprávě pqGetInt nepodporuje integer velikosti %lu pqPutInt nepodporuje integer velikosti %lu neplatný ExecStatusType kód naplatné LDAP URL "%s": neplatný číslo portu
neplatné LDAP URL "%s": chybí rozlišující jméno
neplatné LDAP URL "%s": musí mít právě jeden atribut
naplatné LDAP URL "%s": musí mít vyhledávací rozsah (base/one/sub)
naplatné LDAP URL "%s": není filter
naplatné LDAP URL "%s": schéma musí být ldap://
neplatné URI propagované do interní procedury parseru: "%s"
neplatný parametr v URI dotazu: "%s"
neplatný parametr spojení "%s"
neplatný stav spojení %d, pravděpodobně způsobený poškozením paměti
neplatný stav spojení, pravděpodobně způsobený poškozením paměti
neplatný procenty-kódovaný token "%s"
neplatné číslo portu: "%s"
neplatný status spojení %c, pravděpodobně způsobený poškozením paměti
chybný socket
neplatná hodnota sslmode: "%s"
neplatný status %c, pravděpodobně způsobený poškozením paměti
parametr keepalives musí být celé číslo
délka musí být specifikována pro binarní parametr
řádek %d v souboru se seznamem služeb "%s" je příliš dlouhý
lokální uživatel s ID %d neexistuje
vyhledávání na LDAP serveru selhalo: %s
ztráta synchronizace se serverem, resetuji spojení ztracena synchronizace se serverem: obdržena zpráva typu "%c", délky %d
obsah zprávy nesouhlasí s délkou v typu zprávy "%c"
zpráva typu 0x%02x přišla ze serveru během nečinnosti chybné "=" po "%s" v informačním řetězci spojení
chybějící oddělovač klíče/hodnoty "=" v URI parametru dotazu: "%s"
nalezen více jak jeden záznam při LDAP vyhledávání
vnořené specifikace služeb nejsou podporovány v service souboru "%s", řádek %d
COPY se neprovádí
žádný chybový kód SSL nebyl hlášený není spojení se serverem
nebyl nalezen žádný záznam při LDAP vyhledávání
chybová zpráva není k dispozici
počet parametrů musí být mezi 0 a 65535
nedostatek paměti nedostatek paměti
při alokaci GSSAPI bufferu došla paměť (%d) nedostatek paměti pro výsledek dotazu číslo parametru %d je mimo rozsah 0..%d heslo načteno ze souboru "%s"
soubor s privátním klíčem "%s" má povolená přístupová práva pro skupinu nebo všechny uživatele; práva by měla být u=rw (0600) nebo přísnější
chyba protokolu: id=0x%x
dotaz inicializující "large object" funkce nevrátil data
přijata neplatná odpověď na SSL negotiation: %c
parametr requirepeer není na této platformě podporován
requirepeer obsahuje "%s", ale skutečné jméno peera je "%s"
soubor s kořenovým certifikátem "%s" neexistuje
poskytněnte soubor nebo změntě ssl mód tak, aby neověřoval certifkát serveru.
číslo řádky %d je mimo rozsah 0..%d select() selhal: %s
serverový certifikát pro "%s" nesouhlasí s jménem serveru (host name) "%s"
server neočekávaně ukončil spojení
Toto pravděpodobně znamená, že byl ukončen nestandardně
před nebo během vykonávání požadavku.
server nepodporuje SSL, leč SSL je vyžadováno
server odeslal binární data ("B" zpráva) bez předchozího popisu řádky ("T" zpráva) server odeslal data ("D" zpráva) bez předcházejícího popisu řádky ("T" zpráva) server odeslal data ("D" zpráva) bez předchozího popisu řádky ("T" zpráva)
soubor se seznamem služeb "%s" nebyl nalezen
setsockopt(%s) selhalo: %s
size_t přetečení hodnota sslmode "%s" je neplatná pokud není zakompilována podpora SSL
název výrazu je prázdný ukazatel
syntaktická chyba v souboru se seznamu služeb "%s", řádek %d
časový limit (timeout) uběhl
neočekávaný asyncStatus: %d
neočekávaný znak "%c" na pozici %d v URI (očekáváno ":" nebo "/"): "%s"
neočekávaný znak %c následuje prázdnou odezvu dotazu("I" zpráva) neočekávaný počet položek v "D" zprávě neočekávaná zpráva ze serveru během startu
neočekávaná odpověď serveru; předchozí znak byl "%c"
neznámý chybový kód SSL: %d
neznámá chyba socketu: 0x%08X/%d neukončený řetězec v uvozovkách v informačním řetězci spojení
vyhledání uživatele selhalo: chybový kód %lu
locale/cs/LC_MESSAGES/pg_ctl-9.6.mo 0000644 00000043650 14751153421 0012327 0 ustar 00 �� � � � , 0 D 1 ? v � � & �
0
- O
}
�
= �
�
� ! � a � K 0 | A � ! � 3 � ? / H o D � C � E A ? � ? � > 9 F L � B � E � V 0 � F > S 8 � I � % 2 ; O n 7 � � � M - f ! � > � E � C ; y 9 � D 3 C x D � > A @ ( � , � 2 � 6 > B * � / � % � 1 0 4 # e � 4 � 2 � 1 0 A , r . � 3 � + " 1 N 6 � : � 1 � * $ " O 7 r " � $ � J � = Y 3 p 0 � � ! � $ ; - \ � 4 � % � $ ! " *! ! M! F o! u �! F ," s" 7 �" ) �" k �" ` U# % �# & �# $ d $ p$ / �$ & �$ 0 �$ . % - F% t% �% & �% �% , �% ( & ;& ! V& x& �& �& �& �& �& �& ' ' $' 4' " L' o' � �' G W) = �) �) �) , * & F* & m* 5 �* �* �* B �* @+ ! a+ � �+ ! , b 8, P �, �, D - ! N- @ p- > �- L �- C =. L �. H �. B / 9 Z/ C �/ ; �/ N 0 Q c0 E �0 � �0 C �1 K �1 N 2 C k2 M �2 , �2 C *3 y n3 < �3 %4 .4 84 ` N4 ) �4 �4 B �4 M <5 : �5 � �5 D |6 T �6 O 7 O f7 B �7 L �7 ' F8 + n8 I �8 8 �8 : 9 . X9 / �9 ( �9 5 �9 4 : & K: r: 8 �: I �: A ; 3 U; 6 �; - �; 6 �; ! %< 0 G< 6 x< 8 �< 6 �< L = # l= �= C �= & �= + > W F> ! �> �> 7 �> < ? T? o? ' �? % �? 2 �? ! @ G 1@ y@ ( �@ # �@ # �@ T A p `A K �A B : .B ) iB | �B i C 7 zC ) �C �C m �C VD / tD ) �D * �D # �D % E CE _E $ rE ' �E 1 �E , �E " F " AF dF �F �F �F �F �F G G ,G =G NG ! iG �G P W � , � ` n m $ p � ~ < A 9 T ! : M D a G 2 E I { c # d � K | � � Q & ) 8 B 4 _ > f � y ( v L [ h \ ^ Z � 5 X R C F O } + � r � ] u w Y
e � x
7 / k - 0 � q 1 � b j ; 6 t g � N " @ U z H J . � ? s V � % S = � l ' * o 3 i �
%s: -w option cannot use a relative socket directory specification
%s: -w option is not supported when starting a pre-9.1 server
Allowed signal names for kill:
Common options:
Options for register and unregister:
Options for start or restart:
Options for stop or restart:
Report bugs to <pgsql-bugs@postgresql.org>.
Shutdown modes are:
Start types are:
%s init[db] [-D DATADIR] [-s] [-o "OPTIONS"]
%s kill SIGNALNAME PID
%s promote [-D DATADIR] [-s]
%s register [-N SERVICENAME] [-U USERNAME] [-P PASSWORD] [-D DATADIR]
[-S START-TYPE] [-w] [-t SECS] [-o "OPTIONS"]
%s reload [-D DATADIR] [-s]
%s restart [-w] [-t SECS] [-D DATADIR] [-s] [-m SHUTDOWN-MODE]
[-o "OPTIONS"]
%s start [-w] [-t SECS] [-D DATADIR] [-s] [-l FILENAME] [-o "OPTIONS"]
%s status [-D DATADIR]
%s stop [-W] [-t SECS] [-D DATADIR] [-s] [-m SHUTDOWN-MODE]
%s unregister [-N SERVICENAME]
-?, --help show this help, then exit
-D, --pgdata=DATADIR location of the database storage area
-N SERVICENAME service name with which to register PostgreSQL server
-P PASSWORD password of account to register PostgreSQL server
-S START-TYPE service start type to register PostgreSQL server
-U USERNAME user name of account to register PostgreSQL server
-V, --version output version information, then exit
-W do not wait until operation completes
-c, --core-files allow postgres to produce core files
-c, --core-files not applicable on this platform
-e SOURCE event source for logging when running as a service
-l, --log=FILENAME write (or append) server log to FILENAME
-m, --mode=MODE MODE can be "smart", "fast", or "immediate"
-o OPTIONS command line options to pass to postgres
(PostgreSQL server executable) or initdb
-p PATH-TO-POSTGRES normally not necessary
-s, --silent only print errors, no informational messages
-t, --timeout=SECS seconds to wait when using -w option
-w wait until operation completes
auto start service automatically during system startup (default)
demand start service on demand
fast quit directly, with proper shutdown
immediate quit without complete shutdown; will lead to recovery on restart
smart quit after all clients have disconnected
done
failed
stopped waiting
%s is a utility to initialize, start, stop, or control a PostgreSQL server.
%s: -S option not supported on this platform
%s: PID file "%s" does not exist
%s: WARNING: cannot create restricted tokens on this platform
%s: WARNING: could not locate all job object functions in system API
%s: another server might be running; trying to start server anyway
%s: cannot be run as root
Please log in (using, e.g., "su") as the (unprivileged) user that will
own the server process.
%s: cannot promote server; server is not in standby mode
%s: cannot promote server; single-user server is running (PID: %ld)
%s: cannot reload server; single-user server is running (PID: %ld)
%s: cannot restart server; single-user server is running (PID: %ld)
%s: cannot set core file size limit; disallowed by hard limit
%s: cannot stop server; single-user server is running (PID: %ld)
%s: could not access directory "%s": %s
%s: could not allocate SIDs: error code %lu
%s: could not create promote signal file "%s": %s
%s: could not create restricted token: error code %lu
%s: could not determine the data directory using command "%s"
%s: could not find own program executable
%s: could not find postgres program executable
%s: could not open PID file "%s": %s
%s: could not open process token: error code %lu
%s: could not open service "%s": error code %lu
%s: could not open service manager
%s: could not read file "%s"
%s: could not register service "%s": error code %lu
%s: could not remove promote signal file "%s": %s
%s: could not send promote signal (PID: %ld): %s
%s: could not send reload signal (PID: %ld): %s
%s: could not send signal %d (PID: %ld): %s
%s: could not send stop signal (PID: %ld): %s
%s: could not start server
Examine the log output.
%s: could not start server: %s
%s: could not start server: error code %lu
%s: could not start service "%s": error code %lu
%s: could not unregister service "%s": error code %lu
%s: could not wait for server because of misconfiguration
%s: could not write promote signal file "%s": %s
%s: database system initialization failed
%s: directory "%s" does not exist
%s: directory "%s" is not a database cluster directory
%s: invalid data in PID file "%s"
%s: missing arguments for kill mode
%s: no database directory specified and environment variable PGDATA unset
%s: no operation specified
%s: no server running
%s: old server process (PID: %ld) seems to be gone
%s: option file "%s" must have exactly one line
%s: server does not shut down
%s: server is running (PID: %ld)
%s: service "%s" already registered
%s: service "%s" not registered
%s: single-user server is running (PID: %ld)
%s: the PID file "%s" is empty
%s: too many command-line arguments (first is "%s")
%s: unrecognized operation mode "%s"
%s: unrecognized shutdown mode "%s"
%s: unrecognized signal name "%s"
%s: unrecognized start type "%s"
(The default is to wait for shutdown, but not for start or restart.)
HINT: The "-m fast" option immediately disconnects sessions rather than
waiting for session-initiated disconnection.
If the -D option is omitted, the environment variable PGDATA is used.
Is server running?
Please terminate the single-user server and try again.
Server started and accepting connections
The program "%s" is needed by %s but was not found in the
same directory as "%s".
Check your installation.
The program "%s" was found by "%s"
but was not the same version as %s.
Check your installation.
Timed out waiting for server startup
Try "%s --help" for more information.
Usage:
WARNING: online backup mode is active
Shutdown will not complete until pg_stop_backup() is called.
Waiting for server startup...
cannot duplicate null pointer (internal error)
child process exited with exit code %d child process exited with unrecognized status %d child process was terminated by exception 0x%X child process was terminated by signal %d: %s command not executable command not found could not change directory to "%s": %s could not find a "%s" to execute could not get current working directory: %s
could not identify current directory: %s could not read binary "%s" could not read symbolic link "%s" invalid binary "%s" out of memory
pclose failed: %s server is still starting up
server promoting
server shutting down
server signaled
server started
server starting
server stopped
starting server anyway
waiting for server to shut down... waiting for server to start... Project-Id-Version: pg_ctl-cs (PostgreSQL 9.3)
Report-Msgid-Bugs-To: pgsql-bugs@postgresql.org
POT-Creation-Date: 2020-10-28 19:20+0000
PO-Revision-Date: 2020-11-01 00:30+0100
Last-Translator: Tomas Vondra <tv@fuzzy.cz>
Language-Team: Czech <info@cspug.cx>
Language: cs
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Plural-Forms: nplurals=3; plural=(n==1) ? 0 : (n>=2 && n<=4) ? 1 : 2;
X-Generator: Poedit 2.4.1
%s: -w volba nemůže používat relativně zadaný adresář socketu
%s: -w volba není podporována při startu pre-9.1 serveru
Povolené signály pro "kill":
Společné přepínače:
Přepínače pro register nebo unregister:
Přepínače pro start nebo restart:
Přepínače pro start nebo restart:
Chyby hlaste na adresu <pgsql-bugs@postgresql.org>.
Módy ukončení jsou:
Módy spuštění jsou:
%s init[db] [-D ADRESÁŘ] [-s] [-o PŘEPÍNAČE]
%s kill SIGNÁL IDPROCESU
%s promote [-D ADRESÁŘ] [-s]
%s register [-N NÁZEVSLUŽBY] [-U UŽIVATEL] [-P HESLO] [-D ADRESÁŘ]
[-S MÓD-STARTU] [-w] [-t SECS] [-s] [-o "VOLBY"]
%s reload [-D ADRESÁŘ] [-s]
%s restart [-w] [-t SECS] [-D DATADIR] [-s] [-m MÓD-VYPNUTÍ]
[-o "OPTIONS"]
%s start [-w] [-t SECS] [-D ADRESÁŘ] [-s] [-l SOUBOR] [-o "PŘEPÍNAČE"]
%s status [-D ADRESÁŘ]
%s stop [-W] [-t SECS] [-D DATADIR] [-s] [-m MÓD-ZASTAVENÍ]
%s unregister [-N SERVICENAME]
-?, --help vypsat tuto nápovědu, potom skončit
-D, --pgdata=ADRESÁŘ umístění úložiště databáze
-N SERVICENAME jméno služby, pod kterým registrovat PostgreSQL server
-P PASSWORD heslo k účtu pro registraci PostgreSQL serveru
-S TYP-STARTU typ spuštění služby pro registraci PostgreSQL serveru
-U USERNAME uživatelské jméno pro registraci PostgreSQL server
-V, --version vypsat informace o verzi, potom skončit
-W nečekat na dokončení operace
-c, --core-files povolit postgresu vytvářet core soubory
-c, --core-files nepoužitelné pro tuto platformu
-e SOURCE název zdroje pro logování při běhu jako služba
-l, --log=SOUBOR zapisuj (nebo připoj na konec) log serveru do SOUBORU.
-m, --mode=MODE může být "smart", "fast", or "immediate"
-o OPTIONS přepínače, které budou předány postgresu
(spustitelnému souboru PostgreSQL) či initdb
-p CESTA-K-POSTGRESU za normálních okolností není potřeba
-s, --silent vypisuj jen chyby, žádné informativní zprávy
-t, --timeout=SECS počet vteřin pro čekání při využití volby -w
-w čekat na dokončení operace (výchozí)
auto spusť službu automaticky během startu systému (implicitní)
demand spusť službu na vyžádání
fast skonči okamžitě, s korektním zastavením serveru
immediate skonči bez kompletního zastavení; po restartu se provede
obnova po pádu (crash recovery)
smart skonči potom, co se odpojí všichni klienti
hotovo
selhalo
přestávám čekat
%s je nástroj pro inicializaci, spuštění, zastavení, nebo ovládání PostgreSQL serveru.
%s: -S nepoužitelné pro tuto platformu
%s: PID soubor "%s" neexistuje
%s: VAROVÁNÍ: na této platformě nelze vytvořit tajné tokeny
%s: VAROVÁNÍ: v systémovém API nelze najít všechny "job object" funkce
%s: další server možná běží; i tak zkouším start
%s: nemůže běžet pod uživatelem root
Prosím přihlaste se jako (neprivilegovaný) uživatel, který bude vlastníkem
serverového procesu (například pomocí příkazu "su").
%s: nelze povýšit (promote) server; server není ve standby módu
%s: nelze povýšit (promote) server; server běží v single-user módu (PID: %ld)
%s: nemohu znovunačíst server; server běží v single-user módu (PID: %ld)
%s: nemohu restartovat server; postgres běží v single-user módu (PID: %ld)
%s: nelze nastavit limit pro core soubor; zakázáno hard limitem
%s: nemohu zastavit server; postgres běží v single-user módu (PID: %ld)
%s: nelze otevřít adresář "%s": %s
%s: nelze alokovat SIDs: chybový kód %lu
%s: nelze vytvořit signální soubor pro povýšení (promote) "%s": %s
%s: nelze vytvořit vyhrazený token: chybový kód %lu
%s: nelze najít datový adresář pomocí příkazu "%s"
%s: nelze najít vlastní spustitelný soubor
%s: nelze najít spustitelný program postgres
%s: nelze otevřít PID soubor "%s": %s
%s: nelze otevřít token procesu: chybový kód %lu
%s: nelze otevřít službu "%s": chybový kód %lu
%s: nelze otevřít manažera služeb
%s: nelze číst soubor "%s"
%s: nelze zaregistrovat službu "%s": chybový kód %lu
%s: nelze odstranit signální soubor pro povýšení (promote) "%s": %s
%s: nelze poslat signál pro povýšení (promote, PID: %ld): %s
%s: nelze poslat signál pro reload (PID: %ld): %s
%s: nelze poslat signál pro reload %d (PID: %ld): %s
%s: nelze poslat stop signál (PID: %ld): %s
%s: nelze spustit server
Zkontrolujte záznam v logu.
%s: nelze nastartovat server: %s
%s: nelze nastartovat server: chybový kód %lu
%s: nelze nastartovat službu "%s": chybový kód %lu
%s: nelze odregistrovat službu "%s": chybový kód %lu
%s: nelze čekat na server kvůli chybné konfiguraci
%s: nelze zapsat do signálního souboru pro povýšení (promote) "%s": %s
%s: inicializace databáze selhala
%s: adresář "%s" neexistuje
%s: adresář "%s" není datový adresář databázového clusteru
%s: neplatná data v PID souboru "%s"
%s: chýbějící parametr pro "kill" mód
%s: není zadán datový adresář a ani není nastavena proměnná prostředí PGDATA
%s: není specifikována operace
%s: žádný server neběží
%s: starý proces serveru (PID: %ld) zřejmě skončil
%s: soubor s volbami "%s" musí mít přesně jednu řádku
%s: server se neukončuje
%s: server běží (PID: %ld)
%s: služba "%s" je již registrována
%s: služba "%s" není registrována
%s: server běží v single-user módu (PID: %ld)
%s: PID soubor "%s" je prázdný
%s: příliš mnoho argumentů v příkazové řádce (první je "%s")
%s: neplatný mód operace "%s"
%s: neplatný mód ukončení mode "%s"
%s: neplatné jméno signálu "%s"
%s: neplatný typ spuštění "%s"
(Implicitní chování je čekat na ukončení, ale ne při startu nebo restartu.)
TIP: Volba "-m fast" okamžitě ukončí sezení namísto aby čekala
na odpojení iniciované přímo session.
Pokud je vynechán parametr -D, použije se proměnná prostředí PGDATA.
Běží server?
Prosím ukončete single-user postgres a zkuste to znovu.
Server nastartoval a přijímá spojení
Program "%s" je vyžadován aplikací %s, ale nebyl nalezen ve stejném
adresáři jako "%s".
Zkontrolujte vaši instalaci.
Program "%s" byl nalezen pomocí "%s",
ale nebyl ve stejné verzi jako %s.
Zkontrolujte vaši instalaci.
Časový limit pro čekání na start serveru vypršel
Zkuste "%s --help" pro více informací.
Použití:
VAROVÁNÍ: online backup mód je aktivní
Shutdown nebude ukončen dokud nebude zavolán pg_stop_backup().
Čekám na start serveru ...
nelze duplikovat null pointer (interní chyba)
potomek skončil s návratovým kódem %d potomek skončil s nerozponaným stavem %d potomek byl ukončen vyjímkou 0x%X potomek byl ukončen signálem %d: %s příkaz není spustitelný příkaz nenalezen nelze změnit adresář na "%s" : %s nelze najít soubor "%s" ke spuštění nelze získat aktuální pracovní adresář: %s
nelze identifikovat aktuální adresář: %s nelze číst binární soubor "%s" nelze číst symbolický link "%s" neplatný binární soubor"%s" nedostatek paměti
volání pclose selhalo: %s server stále startuje
server je povyšován (promote)
server se ukončuje
server obdržel signál
server spuštěn
server startuje
server zastaven
přesto server spouštím
čekám na ukončení serveru ... čekám na start serveru ... locale/cs/LC_MESSAGES/initdb-9.6.mo 0000644 00000055701 14751153421 0012330 0 ustar 00 �� � , � <
�
R �
* 5 - F g t ` � � = W W X � A � 5 � J / z 6 � P � C : b Q � 5 � ] % 4 � B � H � G D > � 4 � 9 3 : ? n / � - � > y K ( � # � , - ? 7 m ( � 6 � , ' 2 5 Z F � " � < � & 7 - ^ - � ! � 1 � ? & N / u = � ! � " 6 ( + _ � 0 � ; � $ / 4 & d � $ � ~ � 1 M < � G � 3 " 8 V ( � J � � � � C � - C! 8 q! ! �! , �! �! J " 0 \" 4 �" A �" @ # R E# K �# " �# ! $ � )$ d �$ % %% � D% [ �% R $& K w& % �& �& ' ' ; 8' ; t' � �' @ A( ; �( �( u �) q E* f �* s + & �+ �+ ) �+ t �+ / `, �, & �, 0 �, . �, - &- T- k- & }- # �- �- $ �- ( . + 7. " c. �. " �. ! �. , �. $ / * 8/ % c/ ! �/ �/ �/ 0 �/ 0 (0 ,0 ;0 - M0 {0 & �0 % �0 �0 3 1 :1 T1 ( h1 � �1 Y Z3 * �3 �3 �3 5 4 { >4 q �4 � ,5 Z �5 ^ P6 7 �6 ` �7 2 H8 P {8 �8 A �8 S /9 V �9 ? �9 K : E f: q �: C ; D b; K �; I �; A =< J < 3 �< 6 �< F 5= # |= 1 �= D �= � > - �> ( �> + %? & Q? - x? ( �? 8 �? . @ $ 7@ 4 \@ G �@ * �@ C A ( HA 0 qA / �A $ �A 5 �A A -B & oB 0 �B B �B )
C % 4C C ZC 1 �C # �C 5 �C A *D . lD : �D ) �D E & E � CE A �E ; F : DF Q F E �F ; G 8 SG K �G � �G �H % �H H �H 0 &I < WI ' �I 5 �I �I X J 5 dJ G �J Q �J = 4K f rK ] �K 4 7L 4 lL � �L i -M �M ) �M � �M i kN p �N J FO S �O �O & �O P ? >P 5 ~P � �P U PQ N �Q d �Q � ZS � �S o jT s �T ) NU xU . �U r �U / &V VV ) hV * �V # �V % �V W #W $ 6W " [W ~W ! �W & �W ( �W # X " 5X # XX " |X , �X # �X ; �X ,Y ' JY rY �Y 8 �Y �Y Z Z Z + 8Z dZ 5 �Z 4 �Z ) �Z 8 [ S[ n[ = �[ � � 5 ( � ] � � J l 6 H X � � K z � � r I � � { � N d R V o | ~ � . y U } � m � ` G = * f / $ � > _ � # A � t C 8 Y 0 T , � % + v L 3 � 2 n � � h B j E ? 9 ) ! & � � � q � � D S Z g
e ; ' ^ " F x c � w P [ s � @ i �
1 - \ � u : k � 4 W Q 7 � O � < M p a b �
If the data directory is not specified, the environment variable PGDATA
is used.
Less commonly used options:
Options:
Other options:
Report bugs to <pgsql-bugs@postgresql.org>.
Success. You can now start the database server using:
%s%s%spg_ctl%s -D %s%s%s -l logfile start
Sync to disk skipped.
The data directory might become corrupt if the operating system crashes.
WARNING: enabling "trust" authentication for local connections
You can change this by editing pg_hba.conf or using the option -A, or
--auth-local and --auth-host, the next time you run initdb.
--auth-host=METHOD default authentication method for local TCP/IP connections
--auth-local=METHOD default authentication method for local-socket connections
--lc-collate=, --lc-ctype=, --lc-messages=LOCALE
--lc-monetary=, --lc-numeric=, --lc-time=LOCALE
set default locale in the respective category for
new databases (default taken from environment)
--locale=LOCALE set default locale for new databases
--no-locale equivalent to --locale=C
--pwfile=FILE read password for the new superuser from file
%s [OPTION]... [DATADIR]
-?, --help show this help, then exit
-A, --auth=METHOD default authentication method for local connections
-E, --encoding=ENCODING set default encoding for new databases
-L DIRECTORY where to find the input files
-N, --nosync do not wait for changes to be written safely to disk
-S, --sync-only only sync data directory
-T, --text-search-config=CFG
default text search configuration
-U, --username=NAME database superuser name
-V, --version output version information, then exit
-W, --pwprompt prompt for a password for the new superuser
-X, --xlogdir=XLOGDIR location for the transaction log directory
-d, --debug generate lots of debugging output
-k, --data-checksums use data page checksums
-n, --noclean do not clean up after errors
-s, --show show internal settings
[-D, --pgdata=]DATADIR location for this database cluster
%s initializes a PostgreSQL database cluster.
%s: "%s" is not a valid server encoding name
%s: WARNING: cannot create restricted tokens on this platform
%s: cannot be run as root
Please log in (using, e.g., "su") as the (unprivileged) user that will
own the server process.
%s: could not access directory "%s": %s
%s: could not access file "%s": %s
%s: could not allocate SIDs: error code %lu
%s: could not change permissions of "%s": %s
%s: could not change permissions of directory "%s": %s
%s: could not create directory "%s": %s
%s: could not create restricted token: error code %lu
%s: could not create symbolic link "%s": %s
%s: could not execute command "%s": %s
%s: could not find suitable encoding for locale "%s"
%s: could not find suitable text search configuration for locale "%s"
%s: could not fsync file "%s": %s
%s: could not get exit code from subprocess: error code %lu
%s: could not open directory "%s": %s
%s: could not open file "%s" for reading: %s
%s: could not open file "%s" for writing: %s
%s: could not open file "%s": %s
%s: could not open process token: error code %lu
%s: could not re-execute with restricted token: error code %lu
%s: could not read directory "%s": %s
%s: could not read password from file "%s": %s
%s: could not start process for command "%s": error code %lu
%s: could not stat file "%s": %s
%s: could not write file "%s": %s
%s: data directory "%s" not removed at user's request
%s: directory "%s" exists but is not empty
%s: encoding mismatch
%s: failed to remove contents of data directory
%s: failed to remove contents of transaction log directory
%s: failed to remove data directory
%s: failed to remove transaction log directory
%s: failed to restore old locale "%s"
%s: file "%s" does not exist
%s: file "%s" is not a regular file
%s: input file "%s" does not belong to PostgreSQL %s
Check your installation or specify the correct path using the option -L.
%s: input file location must be an absolute path
%s: invalid authentication method "%s" for "%s" connections
%s: invalid locale name "%s"
%s: invalid locale settings; check LANG and LC_* environment variables
%s: locale "%s" requires unsupported encoding "%s"
%s: locale name has non-ASCII characters, skipped: "%s"
%s: locale name too long, skipped: "%s"
%s: must specify a password for the superuser to enable %s authentication
%s: no data directory specified
You must identify the directory where the data for this database system
will reside. Do this with either the invocation option -D or the
environment variable PGDATA.
%s: out of memory
%s: password file "%s" is empty
%s: password prompt and password file cannot be specified together
%s: removing contents of data directory "%s"
%s: removing contents of transaction log directory "%s"
%s: removing data directory "%s"
%s: removing transaction log directory "%s"
%s: setlocale() failed
%s: superuser name "%s" is disallowed; role names cannot begin with "pg_"
%s: symlinks are not supported on this platform
%s: too many command-line arguments (first is "%s")
%s: transaction log directory "%s" not removed at user's request
%s: transaction log directory location must be an absolute path
%s: warning: specified text search configuration "%s" might not match locale "%s"
%s: warning: suitable text search configuration for locale "%s" is unknown
Data page checksums are disabled.
Data page checksums are enabled.
Encoding "%s" implied by locale is not allowed as a server-side encoding.
The default database encoding will be set to "%s" instead.
Encoding "%s" is not allowed as a server-side encoding.
Rerun %s with a different locale selection.
Enter it again: Enter new superuser password: If you want to create a new database system, either remove or empty
the directory "%s" or run %s
with an argument other than "%s".
If you want to store the transaction log there, either
remove or empty the directory "%s".
It contains a dot-prefixed/invisible file, perhaps due to it being a mount point.
It contains a lost+found directory, perhaps due to it being a mount point.
No usable system locales were found.
Passwords didn't match.
Rerun %s with the -E option.
Running in debug mode.
Running in noclean mode. Mistakes will not be cleaned up.
The database cluster will be initialized with locale "%s".
The database cluster will be initialized with locales
COLLATE: %s
CTYPE: %s
MESSAGES: %s
MONETARY: %s
NUMERIC: %s
TIME: %s
The default database encoding has accordingly been set to "%s".
The default text search configuration will be set to "%s".
The encoding you selected (%s) and the encoding that the
selected locale uses (%s) do not match. This would lead to
misbehavior in various character string processing functions.
Rerun %s and either do not specify an encoding explicitly,
or choose a matching combination.
The files belonging to this database system will be owned by user "%s".
This user must also own the server process.
The program "postgres" is needed by %s but was not found in the
same directory as "%s".
Check your installation.
The program "postgres" was found by "%s"
but was not the same version as %s.
Check your installation.
This might mean you have a corrupted installation or identified
the wrong directory with the invocation option -L.
Try "%s --help" for more information.
Usage:
Use the option "--debug" to see details.
Using a mount point directly as the data directory is not recommended.
Create a subdirectory under the mount point.
cannot duplicate null pointer (internal error)
caught signal
child process exited with exit code %d child process exited with unrecognized status %d child process was terminated by exception 0x%X child process was terminated by signal %d: %s command not executable command not found could not change directory to "%s": %s could not close directory "%s": %s
could not find a "%s" to execute could not get junction for "%s": %s
could not identify current directory: %s could not look up effective user ID %ld: %s could not open directory "%s": %s
could not read binary "%s" could not read directory "%s": %s
could not read symbolic link "%s" could not remove file or directory "%s": %s
could not set junction for "%s": %s
could not stat file or directory "%s": %s
could not write to child process: %s
creating configuration files ... creating directory %s ... creating subdirectories ... fixing permissions on existing directory %s ... invalid binary "%s" ok
out of memory
pclose failed: %s performing post-bootstrap initialization ... running bootstrap script ... selecting default max_connections ... selecting default shared_buffers ... selecting default timezone ... selecting dynamic shared memory implementation ... syncing data to disk ... user does not exist user name lookup failure: error code %lu Project-Id-Version: initdb-cs (PostgreSQL 9.3)
Report-Msgid-Bugs-To: pgsql-bugs@postgresql.org
POT-Creation-Date: 2020-10-28 19:21+0000
PO-Revision-Date: 2020-11-01 00:30+0100
Last-Translator: Tomas Vondra <tv@fuzzy.cz>
Language-Team: Czech <info@cspug.cx>
Language: cs
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Plural-Forms: nplurals=3; plural=(n==1) ? 0 : (n>=2 && n<=4) ? 1 : 2;
X-Generator: Poedit 2.4.1
Pokud není specifikován datový adresář, použije se proměnná
prostředí PGDATA.
Méně často používané přepínače:
Přepínače:
Ostatní přepínače:
Chyby hlaste na adresu <pgsql-bugs@postgresql.org>.
Povedlo se. Můžete začít používat databázový server spuštěním:
%s%s%spg_ctl%s -D %s%s%s -l logfile start
Zápis na disk přeskočen.
Datový adresář může být v případě pádu operačního systému poškozený.
WARNING: povoluji "trust" autentikace pro lokální spojení
Toto můžete změnit upravením pg_hba.conf nebo použitím volby -A,
nebo --auth-local a --auth-host, při dalším spuštění initdb.
--auth-host=METHOD výchozí autentikační metoda pro lokální TCP/IP spojení
--auth-local=METHOD výchozí autentikační metoda pro spojení pro lokální socket
--lc-collate, --lc-ctype, --lc-messages=LOCALE
--lc-monetary, --lc-numeric, --lc-time=LOCALE
nastaví implicitní národním nastavení
v příslušných kategoriích (výchozí hodnoty se
vezmou z nastavení prostředí)
--locale=LOCALE nastavení implicitního národního nastavení pro novou databázi
--no-locale ekvivalent --locale=C
--pwfile=SOUBOR načti heslo pro nového superuživatele ze souboru
%s [PŘEPÍNAČ]... [DATAADR]
-?, --help ukaž tuto nápovědu, potom skonči
-A, --auth=METODA výchozí autentizační metoda pro lokální spojení
-E, --encoding=KÓDOVÁNÍ nastavení výchozího kódování pro nové databáze
-L DIRECTORY kde se nalézají vstupní soubory
-N, --nosync nečekat na bezpečné zapsání změn na disk
-S, --sync-only pouze provést sync datového adresáře
-T, --text-search-config=CFG
implicitní configurace fulltextového vyhledávání
-U, --username=JMÉNO jméno databázového superuživatele
-V, --version vypiš informace o verzi, potom skonči
-W, --pwprompt zeptej se na heslo pro nového superuživatele
-X, --xlogdir=XLOGDIR umístění adresáře s transakčním logem
-d, --debug generuj spoustu ladicích informací
-k, --data-checksums použij kontrolní součty datových stránek
-n, --noclean neuklízet po chybách
-s, --show ukaž interní nastavení
[-D, --pgdata=]DATAADR umístění tohoto databázového klastru
%s inicializuji PostgreSQL klastr
%s: "%s" není platný název kódování znaků
%s: WARNING: na této platformě nelze vytvářet vyhrazené tokeny
%s: nemůže běžet pod uživatelem root
Prosím přihlaste se jako (neprivilegovaný) uživatel, který bude vlastníkem
serverového procesu (například pomocí příkazu "su").
%s: nelze přístoupit k adresáři "%s": %s
%s: nelze přistupit k souboru "%s": %s
%s: nelze alokovat SIDs: chybový kód %lu
%s: nelze změnit práva pro "%s": %s
%s: nelze změnit práva adresáře "%s": %s
%s: nelze vytvořít adresář "%s": %s
%s: nelze vytvořit vyhrazený token: chybový kód %lu
%s: nelze vytvořit symbolický link "%s": %s
%s: nelze vykonat příkaz "%s": %s
%s: nemohu najít vhodné kódování pro locale %s
%s: nemohu najít vhodnou konfiguraci fulltextového vyhledávání %s
%s: nelze provést fsync souboru "%s": %s
%s: nelze získat návratový kód z podprovesu: chybový kód %lu
%s : nelze otevřít adresář "%s": %s
%s: nelze otevřít soubor "%s" pro čtení: %s
%s: nelze otevřít soubor "%s" pro zápis: %s
%s: nelze otevřít soubor "%s": %s
%s: nelze otevřít token procesu: chybový kód %lu
%s: nelze znovu spustit s vyhrazeným tokenem: chybový kód %lu
%s: nelze načíst adresář "%s": %s
%s: nemohu přečíst heslo ze souboru "%s": %s
%s: nelze nastartovat proces pro příkaz "%s": chybový kód %lu
%s: nelze provést stat souboru "%s": %s
%s: nelze zapsat do souboru "%s": %s
%s: datový adresář "%s" nebyl na žádost uživatele odstraněn
%s: adresář "%s" existuje, ale není prázdný
%s: nesouhlasí kódování znaků
%s: selhalo odstranění obsahu datového adresáře
%s: selhalo odstranění obsahu adresáře s transakčním logem
%s: selhalo odstranění datového adresáře
%s: selhalo odstraňení adresáře s transakčním logem
%s: selhala obnova původní locale "%s"
%s: soubor "%s" neexistuje
%s: soubor "%s" není běžný soubor
%s: vstupní soubor "%s" nepatří PostgreSQL %s
Zkontrolujte si vaši instalaci nebo zadejte platnou cestu pomocí
parametru -L.
%s: cesta k umístění vstupního souboru musí být absolutní
%s: neplatná autentikační metoda "%s" pro "%s" spojení
%s: neplatný název národního nastavení (locale) "%s"
%s: neplatné nastavení locale; zkontrolujte LANG a LC_* proměnné prostředí
%s: národní prostředí %s vyžaduje nepodporované kódování %s
%s: jméno locale obsahuje ne-ASCII znaky, přeskakuji: %s
%s: jméno locale je příliš dlouhé, přeskakuji: %s
%s: musíte zadat heslo superuživatele pro použití autentizace typu %s.
%s: není zadán datový adresář
Musíte zadat adresář, ve kterém se bude nacházet tato databáze.
Učiňte tak buď použitím přepínače -D nebo nastavením proměnné
prostředí PGDATA.
%s: nedostatek paměti
%s: soubor s hesly "%s" je prázdný
%s: dotaz na heslo a soubor s heslem nemohou být vyžadovány najednou
%s: odstraňuji obsah datového adresáře "%s"
%s: odstraňuji obsah adresáře s transakčním logem "%s"
%s: odstraňuji datový adresář "%s"
%s: odstraňuji adresář s transakčním logem "%s"
%s: setlocale() selhalo
%s: superuživatelské jméno "%s" není povoleno; názvy rolí nemohou začínat "pg_"
%s: symlinks nejsou na této platformě podporovány
%s: příliš mnoho argumentů v příkazové řádce (první je "%s")
%s: adresář s transakčním logem "%s" nebyl na žádost uživatele odstraněn
%s: cesta k umístění WAL adresáře musí být absolutní
%s: varování: zvolená konfigurace fulltextového vyhledávání "%s" nemusí souhlasit s locale %s
%s: varování: vhodná konfigurace fulltextového vyhledávání pro locale %s není známa
Kontrolní součty datových stránek jsou vypnuty.
Kontrolní součty datových stránek jsou zapnuty.
Kódování %s vyplývající z locale není povoleno jako kódování na serveru.
Implicitní kódování databáze bude nastaveno na %s.
Kódování %s není povoleno jako kódování na serveru.
Pusťte znovu %s s jiným nastavením locale.
Zadejte ho znovu: Zadejte nové heslo pro superuživatele: Pokud chcete v tomto adresáři inicializovat databázi, odstraňte nebo
vyprázdněte adresář "%s" nebo spusťte %s
s argumentem jiným než "%s".
Pokud v tomto adresáři chcete ukládat transakční log, odstraňte nebo
vyprázdněte adresář "%s".
Obsahuje neviditelný soubor / soubor s tečkou na začátku názvu, možná proto že se jedná o mount point.
Obsahuje lost+found adresář, možná proto že se jedná o mount point.
Nebylo nalezené žádné použitelné systémové nárovní nastavení (locales).
Hesla nesouhlasí.
Spusťte znovu %s s přepínačem -E.
Běžím v ladicím režimu.
Běžím v režimu "noclean". Chybné kroky nebudou uklizeny.
Databázový klastr bude inicializován s locale %s.
Databázový klastr bude inicializován s národním nastavením
COLLATE: %s
CTYPE: %s
MESSAGES: %s
MONETARY: %s
NUMERIC: %s
TIME: %s
Výchozí kódování pro databáze bylo odpovídajícím způsobem nastaveno na %s.
Implicitní konfigurace fulltextového vyhledávání bude nastavena na "%s".
Vybrané kódování znaků (%s) a kódování použité vybraným
národním nastavením (%s) si neodpovídají. To může vést k neočekávanému
chování různých funkcí pro manipulaci s řetězci. Pro opravu této situace
spusťte znovu %s a buď nespecifikujte kódování znaků explicitně, nebo
vyberte takovou kombinaci, která si odpovídá.
Soubory patřící k této databázi budou vlastněny uživatelem "%s".
Tento uživatel musí být také vlastníkem serverového procesu.
Program "postgres" je vyžadován aplikací %s, ale nebyl nalezen ve stejném
adresáři jako "%s".
Zkontrolujte vaši instalaci.
Program "postgres" byl nalezen pomocí "%s",
ale nebyl ve stejné verzi jako %s.
Zkontrolujte vaši instalaci.
To znamená, že vaše instalace je poškozena, nebo jste
zadal chybný adresář v parametru -L při spuštění.
Zkuste "%s --help" pro více informací.
Použití:
Pro více detailů použijte volbu "--debug".
Použití mount pointu přímo jako datového adresáře se nedoporučuje.
Vytvořte v mount pointu podadresář.
nelze duplikovat null pointer (interní chyba)
signál obdržen
potomek skončil s návratovým kódem %d potomek skončil s nerozponaným stavem %d potomek byl ukončen vyjímkou 0x%X potomek byl ukončen signálem %d: %s příkaz není spustitelný příkaz nenalezen nelze změnit adresář na "%s" : %s nelze zavřít adresář "%s": %s
nelze najít "%s" ke spuštění nelze najít funkci pro "%s": %s
nelze získat aktuální adresář: %s nelze určit efektivní user ID: %ld: %s nelze otevřít adresář "%s": %s
nelze číst binární soubor "%s" nelze číst z adresáře "%s": %s
nelze číst symbolický link "%s" nelze smazat soubor nebo adresář "%s": %s
nelze nastavit propojení "%s": %s
nelze získat informace o souboru nebo adresáři "%s": %s
nemohu zapsat do potomka: %s
vytvářím konfigurační soubory ... vytvářím adresář %s ... vytvářím adresáře ... opravuji oprávnění pro existující adresář %s ... neplatný binární soubor"%s" ok
nedostatek paměti
volání pclose selhalo: %s provádím post-bootstrap inicializaci ... spouštím bootstrap script ... vybírám implicitní nastavení max_connections ... vybírám implicitní nastavení shared_buffers ... vybírám implicitní časovou zónu ... vybírám implementaci dynamické sdílené paměti ... zapisuji data na disk ... uživatel neexistuje vyhledání uživatelského jména selhalo: chybový kód %lu locale/cs/LC_MESSAGES/ecpg-9.6.mo 0000644 00000034537 14751153421 0012001 0 ustar 00 �� { � � � h
~ i
- �
0 + G g s � 4 � 7 0 s h . � G
4 S
) �
w �
4 * _ @ r = � , � ! @ , ^ 1 � * � - � 1 ' H & p + � " � # �
) = < z � & � < � ! & - 0 + ^ " � � , � � * 3 " ^ ' � � � ! � � ! 5 J 3 k / � ' � ) � * ! 5 L I � , � / � * ) T T ' � � � 1 - K , y , � 5 � ) % ? O 8 � � � _ 0 y 5 � � A � L 7 + �
� 6 � ' � # A ( N 4 w ) � � / � # < $ ] � " � , � � ' " J i $ � D � + � ? 0 Z � 8 � � & F � g � .! 5 �! 1 " : A" t |" ! �" 9 # @ M# y �# A $ O J$ B �$ . �$ { % - �% �% > �% 7
& < E& $ �& * �& ? �& 2 ' + E' . q' 2 �' ( �' ' �' , $( - Q( * ( �( . �( L �( .) & 6) ) ]) = �) & �) �) / �) ) )* ' S* {* . �* �* �* & �* # "+ ) F+ p+ ! �+ * �+ �+ ( �+ %, . 8, < g, > �, - �, : - : L- 9 �- Q �- 0 . 9 D. : ~. Y �. ( / </ Z/ s/ �/ �/ 7 �/ 6 �/ 6 +0 A b0 % �0 ( �0 E �0 6 91 p1 �2 6 �2 7 �2 3 G *3 M r3 - �3 �3 < 4 + ?4 ! k4 �4 / �4 = �4 5 5 D5 2 `5 �5 ( �5 * �5 6 % !6 / G6 w6 ) �6 1 �6 ) �6 $ 7 - =7 E k7 1 �7 I �7 3 -8 a8 < �8 �8 " �8 ) �8 9 %9 j 4 f g ? ^ l x
T ( 9 u 8 _ L t I d \ % ) < i = ' Q N & : M v , 7 B . z ; S n # > P " H r ] [ ! * s Z 6 G A O - X 2 q 3 W w 1 k + U e Y o K p 0 a J 5 { h c m E C @ V F D y R / ` $
b
If no output file is specified, the name is formed by adding .c to the
input file name, after stripping off .pgc if present.
Report bugs to <pgsql-bugs@postgresql.org>.
--regression run in regression testing mode
-?, --help show this help, then exit
-C MODE set compatibility mode; MODE can be one of
"INFORMIX", "INFORMIX_SE"
-D SYMBOL define SYMBOL
-I DIRECTORY search DIRECTORY for include files
-V, --version output version information, then exit
-c automatically generate C code from embedded SQL code;
this affects EXEC SQL TYPE
-d generate parser debug output
-h parse a header file, this option includes option "-c"
-i parse system include files as well
-o OUTFILE write result to OUTFILE
-r OPTION specify run-time behavior; OPTION can be:
"no_indicator", "prepare", "questionmarks"
-t turn on autocommit of transactions
%s at or near "%s" %s is the PostgreSQL embedded SQL preprocessor for C programs.
%s, the PostgreSQL embedded C preprocessor, version %d.%d.%d
%s: could not locate my own executable path
%s: could not open file "%s": %s
%s: no input files specified
%s: parser debug support (-d) not available
AT option not allowed in CLOSE DATABASE statement AT option not allowed in CONNECT statement AT option not allowed in DISCONNECT statement AT option not allowed in SET CONNECTION statement AT option not allowed in TYPE statement AT option not allowed in VAR statement AT option not allowed in WHENEVER statement COPY FROM STDIN is not implemented CREATE TABLE AS cannot specify INTO ERROR: EXEC SQL INCLUDE ... search starts here:
Error: include path "%s/%s" is too long on line %d, skipping
Options:
SHOW ALL is not implemented Try "%s --help" for more information.
Unix-domain sockets only work on "localhost" but not on "%s" Usage:
%s [OPTION]... FILE...
WARNING: arrays of indicators are not allowed on input could not open include file "%s" on line %d could not remove output file "%s"
cursor "%s" does not exist cursor "%s" has been declared but not opened cursor "%s" is already defined descriptor "%s" does not exist descriptor header item "%d" does not exist descriptor item "%s" cannot be set descriptor item "%s" is not implemented end of search list
expected "://", found "%s" expected "@" or "://", found "%s" expected "@", found "%s" expected "postgresql", found "%s" incomplete statement incorrectly formed variable "%s" indicator for array/pointer has to be array/pointer indicator for simple data type has to be simple indicator for struct has to be a struct indicator struct "%s" has too few members indicator struct "%s" has too many members indicator variable "%s" is hidden by a local variable indicator variable "%s" is hidden by a local variable of a different type indicator variable must have an integer type initializer not allowed in EXEC SQL VAR command initializer not allowed in type definition internal error: unreachable state; please report this to <pgsql-bugs@postgresql.org> interval specification not allowed here invalid bit string literal invalid connection type: %s invalid data type key_member is always 0 missing "EXEC SQL ENDIF;" missing identifier in EXEC SQL DEFINE command missing identifier in EXEC SQL IFDEF command missing identifier in EXEC SQL UNDEF command missing matching "EXEC SQL IFDEF" / "EXEC SQL IFNDEF" more than one EXEC SQL ELSE multidimensional arrays are not supported multidimensional arrays for simple data types are not supported multidimensional arrays for structures are not supported multilevel pointers (more than 2 levels) are not supported; found %d level multilevel pointers (more than 2 levels) are not supported; found %d levels nested /* ... */ comments nested arrays are not supported (except strings) no longer supported LIMIT #,# syntax passed to server nullable is always 1 only data types numeric and decimal have precision/scale argument only protocols "tcp" and "unix" and database type "postgresql" are supported operator not allowed in variable definition out of memory pointer to pointer is not supported for this data type pointers to varchar are not implemented subquery in FROM must have an alias syntax error syntax error in EXEC SQL INCLUDE command too many levels in nested structure/union definition too many nested EXEC SQL IFDEF conditions type "%s" is already defined type name "string" is reserved in Informix mode unmatched EXEC SQL ENDIF unrecognized data type name "%s" unrecognized descriptor item code %d unrecognized token "%s" unrecognized variable type code %d unsupported feature will be passed to server unterminated /* comment unterminated bit string literal unterminated hexadecimal string literal unterminated quoted identifier unterminated quoted string using unsupported DESCRIBE statement using variable "%s" in different declare statements is not supported variable "%s" is hidden by a local variable variable "%s" is hidden by a local variable of a different type variable "%s" is neither a structure nor a union variable "%s" is not a pointer variable "%s" is not a pointer to a structure or a union variable "%s" is not an array variable "%s" is not declared variable "%s" must have a numeric type zero-length delimited identifier Project-Id-Version: ecpg-cs (PostgreSQL 9.3)
Report-Msgid-Bugs-To: pgsql-bugs@postgresql.org
POT-Creation-Date: 2018-07-13 15:58+0000
PO-Revision-Date: 2018-07-14 01:03+0200
Last-Translator: Tomas Vondra <tv@fuzzy.cz>
Language-Team: Czech <info@cspug.cx>
Language: cs
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Plural-Forms: nplurals=3; plural=(n==1) ? 0 : (n>=2 && n<=4) ? 1 : 2;
X-Generator: Poedit 2.0.7
Pokud není zadán žádný výstupní soubor, je jméno získáno přidáním .c
na konec jména vstupního souboru, po odstranění koncovky .pgc pokud
je přítomna.
Chyby hlaste na adresu <pgsql-bugs@postgresql.org>.
--regression běh v módu regresních testů
-?, --help zobrazí tuto nápovědu; poté skončí
-C MÓD nastaví mód kompatibility; MÓD může být jedno z
"INFORMIX", "INFORMIX_SE"
-D SYMBOL definuje SYMBOL
-I ADRESÁŘ vyhledá include soubory v ADRESÁŘi
-V, --version vypíše informaci o verzi, poté skončí
-c automaticky generuje C kód z vložných SQL příkazů;
toto ovlivňuje EXEC SQL TYPE
-d zapne generování ladicích informací parseru
-h naparsuje hlavičkový soubor, tato volba zahrnuje volbu "-c"
-i naparsuje také systémové hlavičkové soubory
-o SOUBOR zapíše výsledek do SOUBORu
-r VOLBA určuje run-time chování; VOLBA může být:
"no_indicator", "prepare", "questionmarks"
-t zapne autocommit transakcí
%s na nebo blízko "%s" %s je PostgreSQL preprocesor vloženého SQL pro C programy.
%s, PostgreSQL embedded C preprocessor, verze %d.%d.%d
%s: nelze nalézt cestu k vlastnímu spustitelnému souboru
%s: nelze otevřít soubor "%s": %s
%s: nebyl zadán žádný vstupní soubor
%s: podpora pro ladicí informace parseru (-d) není dostupná
AT volba není v příkazu CLOSE DATABASE povolena AT volba není v příkazu CONNECT povolena AT volba není v příkazu DISCONNECT povolena AT volba není v příkazu SET CONNECTION povolena AT volba není v příkazu TYPE povolena AT volba není v příkazu VAR povolena AT volba není v příkazu WHENEVER povolena příkaz COPY FROM STDIN není implementován CREATE TABLE AS nemůže specifikovat INTO CHYBA: EXEC SQL INCLUDE ... hledání začíná zde:
Chyba: include path "%s/%s" na řádku %d je příliš dlouhá, přeskakuji
Volby:
příkaz SHOW ALL není implementován Zkuste "%s --help" pro více informací.
Unixové sockety fungují pouze na "localhost" ale ne na "%s" Použití:
%s [VOLBA]... SOUBOR...
VAROVÁNÍ: pole identifikátorů nejsou na vstupu povolena nelze otevřít soubor "%s" na řádku %d nelze odstranit výstupní soubor "%s"
kurzor "%s" neexistuje kurzor "%s" byl deklarován ale nebyl otevřen kurzor "%s" je již definován descriptor "%s" neexistuje descriptor header item "%d" neexistuje descriptor item "%s" nelze nastavit descriptor item "%s" není implementován konec vyhledávacího seznamu
očekáváno "://", nalezeno "%s" očekáváno "@" nebo "://", nalezeno "%s" očekáváno "@", nalezeno "%s" očekáváno "postgresql", nalezeno "%s" neúplný příkaz nesprávně vytvořený název proměnné "%s" indicator variable pro pole/ukaztel musí být pole/ukazatel indikátor pro jednoduché datové typy musí být jednoduchý indikátor pro strukturu musí být struktura indikátor pro strukturu "%s" má příliš málo položek indikátor pro strukturu "%s" má příliš mnoho položek indicator variable "%s" je překryta lokální proměnnou indicator variable "%s" je překryta lokální proměnnou s jiným datovým typem indicator variable musí mít celočíselný typ inicializátor není v příkazu EXEC SQL VAR podporován inicializátor (initializer) není v definici typu povolen interní chyba: nedosažitelný stav; oznamte toto prosím na <pgsql-bugs@postgresql.org> specifikace intervalu zde není povolena neplatný bit string literál chybný typ spojení: %s chybný datový typ key_member je vždy 0 chybějící "EXEC SQL ENDIF;" chybějící identifikátor v příkazu EXEC SQL DEFINE chybějící identifikátor v příkazu EXEC SQL IFDEF chybějící identifikátor v příkazu EXEC SQL UNDEF chybějící odpovídající "EXEC SQL IFDEF" / "EXEC SQL IFNDEF" více než jedna větev EXEC SQL ELSE vícerozměrná pole nejsou podporována vícerozměrná pole pro jednoduché datové typy nejsou podporována vícerozměrná pole pro struktury nejsou podporována víceúrovňové ukazatele (více než 2 úrovně) nejsou podporovány; nalezena %d úroveň víceúrovňové ukazatele (více než 2 úrovně) nejsou podporovány; nalezeny %d úrovně víceúrovňové ukazatele (více než 2 úrovně) nejsou podporovány; nalezeny %d úrovně vnořené /* ... */ komentáře vnořená pole nejsou podporována (kromě řetězců) již neopdporovaná syntaxe LIMIT #,# předána serveru nullable je vždy 1 pouze datové typy numeric a decimal mají argumenty přesnost/velikost podporovány jsou pouze protokoly "tcp" a "unix" a typ databáze "postgresql" operátor není povolen v definici proměnné paměť vyčerpána ukazatel na ukazatel není pro tento datový typ podporován ukazatele na varchar nejsou implementovány poddotaz ve FROM musí mít alias syntaktická chyba syntaktická chyba v příkazu EXEC SQL INCLUDE příliš mnoho úrovní v definici vnořené struktury/union příliš mnoho zanořených EXEC SQL IFDEF podmínek typ "%s" je již definován název typu "string" je vyhrazen pro mód Informix neodpovídající EXEC SQL ENDIF nerozpoznaný název datového typu "%s" nerozpoznaný kód deskriptoru položky %d nerozpoznaný token "%s" nerozpoznaný kód typu proměnné %d nepodporovaná vlastnost bude předána serveru neukončený /* komentář neukončený literál - bitový řetězec neukončený literál - hexadecimální řetězec neukončený identifikátor v uvozovkách neukončený řetězec v uvozovkách použití nepodporovaného příkazu DESCRIBE použití proměnné "%s" v dalších deklaracích není podporováno proměnná "%s" je překryta lokální proměnnou proměnná "%s" je překryta lokální proměnnou s jiným datovým typem proměnná "%s" není ani struktura ani sjednocení proměnná "%s" není ukazatel proměnná "%s" není ukazatel na strukturu nebo sjednocení proměnná "%s" není pole proměnná "%s" není deklarována proměnná "%s" musí mít číselný typ ohraničený (delimited) identifikátor s nulovou délkou locale/cs/LC_MESSAGES/pgscripts-9.6.mo 0000644 00000063522 14751153421 0013075 0 ustar 00 �� � � � @ K A �
� > � > � = , - j � � C 0 A t � � # � ( I I f E � � > v ; � = � : / < j 9 � 6 � 5 C N C � 9 � 4 E E = � . � ; � E 4 : z ? � A � < 7 9 t 7 � 4 � L J h 3 � H � E 0 B v A � 5 � 2 1 N d 7 � 2 � 2 J Q : � 5 � G
0 U < � 0 � ) � M J l G � 4 � C 4! H x! E �! D " = L" v �" < # � ># Q �# I $ @ ^$ 5 �$ 4 �$ 1
% 0 <% ; m% 5 �% ' �% 6 & 3 >& 4 r& @ �& ; �& ; $' ` `' 8 �' 2 �' 9 -( 6 g( > �( �( / �( < ) # V) # z) ? �) 8 �) % * # =* a* 3 �* & �* �* E �* 6 )+ E `+ F �+ K �+ 7 9, K q, 7 �, J �, 6 @- < w- D �- 5 �- /. * M. 8 x. 6 �. ( �. 4 / $ F/ # k/ �/ �/ - �/ 8 �/ 4 70 $ l0 �0 , �0 , �0 ( 1 / 41 ; d1 9 �1 ! �1 �1 \ 2 n2 �2 * �2 8 �2 9 3 , =3 8 j3 # �3 4 �3 . �3 +4 ) H4 7 r4 �4
�4 �4 C �4 A &5 ! h5 + �5 �5 �5 �5 6 . 6 3 M6 2 �6 �6 �6 �6
�6 �6 7 $7 ' 97 " a7 2 �7 7 �7 �7 & �7 8 '8 / >8 + n8 * �8 �8 �8 �8 �8 �8 �8 9 9 ( &9 O9 Q9 � U9 ^ !; �; �; 2 �; 2 �; 1 < 5 >< � t< C = A b= �= �= ( �= " > * (> $ S> G x> G �> � ? C �? @ �? C @ @ a@ @ �@ B �@ ? &A ? fA Q �A G �A ? @B B �B K �B 1 C 9 AC > {C W �C : D L MD C �D ? �D D E K cE H �E L �E R EF ? �F G �F D G A eG A �G 6 �G 3 H X TH D �H ; �H ; .I T jI C �I R J H VJ 3 �J I �J 4 K 4 RK I �K F �K D L ? ]L ? �L X �L U 6M U �M : �M t N A �N � �N R _O I �O ? �O E <P ; �P 7 �P 7 �P . .Q 9 ]Q 9 �Q > �Q 5 R > FR S �R ? �R = S r WS = �S 7 T 2 @T / sT F �T �T 4 �T P +U $ |U % �U < �U 6 V $ ;V & `V ! �V 2 �V 1 �V W V W F lW I �W I �W E GX < �X I �X = Y H RY > �Y < �Y S Z E kZ ( �Z 5 �Z C [ > T[ / �[ ? �[ # \ ! '\ % I\ ) o\ 2 �\ 4 �\ 2 ] 4] & U] 2 |] + �] ) �] 4 ^ 4 :^ 2 o^ & �^ �^ � �^ t_ �_ ) �_ 7 �_ 9 ` 1 B` 8 t` ) �` E �` : a ' Xa 2 �a A �a ) �a b $ )b O Nb J �b ( �b ( c ;c + Kc & wc �c 1 �c 6 �c 4 "d Wd dd kd �d �d # �d �d # �d # e 5 *e > `e �e ) �e �e �e 3 f ' 5f = ]f �f �f �f �f �f �f �f �f 9 g Lg Ng � � 9 � � t � � � I S � w & % � � � � G � � - . � � X � { � " � 7 � o � � < � � � L � 4 / K i u � J � ~ B m ( � � * �
n f H p � # D g @ ' > � � U � v � x [ � 3
N � � k ! � 8 , � Y F ; � � z � � Z � T � � 6 r M � + a 2 W � � $ ] _ � � } = s � j � � ? � ` � c | � l \ V � � � � � E ) : q � � Q C b 1 0 h A y � d R � ^ O � � � � � � � 5 � � � e P
By default, a database with the same name as the current user is created.
Connection options:
Options:
Read the description of the SQL command CLUSTER for details.
Read the description of the SQL command REINDEX for details.
Read the description of the SQL command VACUUM for details.
Report bugs to <pgsql-bugs@postgresql.org>.
--analyze-in-stages only update optimizer statistics, in multiple
stages for faster results; no vacuum
--lc-collate=LOCALE LC_COLLATE setting for the database
--lc-ctype=LOCALE LC_CTYPE setting for the database
%s [OPTION]...
%s [OPTION]... DBNAME
%s [OPTION]... LANGNAME [DBNAME]
%s [OPTION]... [DBNAME]
%s [OPTION]... [DBNAME] [DESCRIPTION]
%s [OPTION]... [ROLENAME]
--if-exists don't report error if database doesn't exist
--if-exists don't report error if user doesn't exist
--interactive prompt for missing role name and attributes rather
than using defaults
--maintenance-db=DBNAME alternate maintenance database
--maintenance-db=DBNAME alternate maintenance database
--no-replication role cannot initiate replication
--replication role can initiate replication
-?, --help show this help, then exit
-?, --help show this help, then exit
-?, --help show this help, then exit
-?, --help show this help, then exit
-D, --no-createdb role cannot create databases (default)
-D, --tablespace=TABLESPACE default tablespace for the database
-E, --encoding=ENCODING encoding for the database
-E, --encrypted encrypt stored password
-F, --freeze freeze row transaction information
-I, --no-inherit role does not inherit privileges
-L, --no-login role cannot login
-N, --unencrypted do not encrypt stored password
-O, --owner=OWNER database user to own the new database
-P, --pwprompt assign a password to new role
-R, --no-createrole role cannot create roles (default)
-S, --no-superuser role will not be superuser (default)
-S, --schema=SCHEMA reindex specific schema(s) only
-T, --template=TEMPLATE template database to copy
-U, --username=USERNAME user name to connect as
-U, --username=USERNAME user name to connect as
-U, --username=USERNAME user name to connect as (not the one to create)
-U, --username=USERNAME user name to connect as (not the one to drop)
-U, --username=USERNAME user name to connect as
-V, --version output version information, then exit
-V, --version output version information, then exit
-V, --version output version information, then exit
-V, --version output version information, then exit
-W, --password force password prompt
-W, --password force password prompt
-Z, --analyze-only only update optimizer statistics; no vacuum
-a, --all vacuum all databases
-a, --all cluster all databases
-a, --all reindex all databases
-c, --connection-limit=N connection limit for role (default: no limit)
-d, --createdb role can create new databases
-d, --dbname=DBNAME database to vacuum
-d, --dbname=DBNAME database from which to remove the language
-d, --dbname=DBNAME database to cluster
-d, --dbname=DBNAME database to install language in
-d, --dbname=DBNAME database to reindex
-d, --dbname=DBNAME database name
-e, --echo show the commands being sent to the server
-e, --echo show the commands being sent to the server
-e, --echo show the commands being sent to the server
-f, --full do full vacuuming
-g, --role=ROLE new role will be a member of this role
-h, --host=HOSTNAME database server host or socket directory
-h, --host=HOSTNAME database server host or socket directory
-h, --host=HOSTNAME database server host or socket directory
-i, --index=INDEX recreate specific index(es) only
-i, --inherit role inherits privileges of roles it is a
member of (default)
-i, --interactive prompt before deleting anything
-i, --interactive prompt before deleting anything, and prompt for
role name if not specified
-j, --jobs=NUM use this many concurrent connections to vacuum
-l, --list show a list of currently installed languages
-l, --locale=LOCALE locale settings for the database
-l, --login role can login (default)
-p, --port=PORT database server port
-p, --port=PORT database server port
-p, --port=PORT database server port
-q, --quiet don't write any messages
-q, --quiet don't write any messages
-q, --quiet run quietly
-r, --createrole role can create new roles
-s, --superuser role will be superuser
-s, --system reindex system catalogs
-t, --table='TABLE[(COLUMNS)]' vacuum specific table(s) only
-t, --table=TABLE cluster specific table(s) only
-t, --table=TABLE reindex specific table(s) only
-t, --timeout=SECS seconds to wait when attempting connection, 0 disables (default: %s)
-v, --verbose write a lot of output
-v, --verbose write a lot of output
-w, --no-password never prompt for password
-w, --no-password never prompt for password
-z, --analyze update optimizer statistics
%s (%s/%s) %s cleans and analyzes a PostgreSQL database.
%s clusters all previously clustered tables in a database.
%s creates a PostgreSQL database.
%s creates a new PostgreSQL role.
%s installs a procedural language into a PostgreSQL database.
%s issues a connection check to a PostgreSQL database.
%s reindexes a PostgreSQL database.
%s removes a PostgreSQL database.
%s removes a PostgreSQL role.
%s removes a procedural language from a database.
%s: "%s" is not a valid encoding name
%s: %s %s: cannot cluster all databases and a specific one at the same time
%s: cannot cluster specific table(s) in all databases
%s: cannot reindex all databases and a specific one at the same time
%s: cannot reindex all databases and system catalogs at the same time
%s: cannot reindex specific index(es) and system catalogs at the same time
%s: cannot reindex specific index(es) in all databases
%s: cannot reindex specific schema(s) and system catalogs at the same time
%s: cannot reindex specific schema(s) in all databases
%s: cannot reindex specific table(s) and system catalogs at the same time
%s: cannot reindex specific table(s) in all databases
%s: cannot use the "%s" option when performing only analyze
%s: cannot vacuum all databases and a specific one at the same time
%s: cannot vacuum specific table(s) in all databases
%s: clustering database "%s"
%s: clustering of database "%s" failed: %s %s: clustering of table "%s" in database "%s" failed: %s %s: comment creation failed (database was created): %s %s: could not connect to database %s: %s %s: could not connect to database %s: out of memory
%s: could not fetch default options
%s: creation of new role failed: %s %s: database creation failed: %s %s: database removal failed: %s %s: invalid value for --connection-limit: %s
%s: language "%s" is already installed in database "%s"
%s: language "%s" is not installed in database "%s"
%s: language installation failed: %s %s: language removal failed: %s %s: missing required argument database name
%s: missing required argument language name
%s: missing required argument role name
%s: number of parallel jobs must be at least 1
%s: only one of --locale and --lc-collate can be specified
%s: only one of --locale and --lc-ctype can be specified
%s: processing database "%s": %s
%s: query failed: %s %s: query returned %d row instead of one: %s
%s: query returned %d rows instead of one: %s
%s: query was: %s
%s: reindexing database "%s"
%s: reindexing of database "%s" failed: %s %s: reindexing of index "%s" in database "%s" failed: %s %s: reindexing of schema "%s" in database "%s" failed: %s %s: reindexing of system catalogs failed: %s %s: reindexing of table "%s" in database "%s" failed: %s %s: removal of role "%s" failed: %s %s: too many command-line arguments (first is "%s")
%s: too many jobs for this platform -- try %d
%s: vacuuming database "%s"
%s: vacuuming of database "%s" failed: %s %s: vacuuming of table "%s" in database "%s" failed: %s (%lu row) (%lu rows) Are you sure? Cancel request sent
Cannot add cell to table content: total cell count of %d exceeded.
Cannot add header to table content: column count of %d exceeded.
Could not send cancel request: %s Database "%s" will be permanently removed.
Enter it again: Enter name of role to add: Enter name of role to drop: Enter password for new role: Generating default (full) optimizer statistics Generating medium optimizer statistics (10 targets) Generating minimal optimizer statistics (1 target) Interrupted
Name Password encryption failed.
Password: Passwords didn't match.
Please answer "%s" or "%s".
Procedural Languages Role "%s" will be permanently removed.
Shall the new role be a superuser? Shall the new role be allowed to create databases? Shall the new role be allowed to create more new roles? Trusted? Try "%s --help" for more information.
Usage:
accepting connections
cannot duplicate null pointer (internal error)
could not look up effective user ID %ld: %s invalid output format (internal error): %d n no no attempt
no response
out of memory
rejecting connections
unknown
user does not exist user name lookup failure: error code %lu y yes Project-Id-Version: pgscripts-cs (PostgreSQL 9.3)
Report-Msgid-Bugs-To: pgsql-bugs@postgresql.org
POT-Creation-Date: 2020-10-28 19:21+0000
PO-Revision-Date: 2020-11-01 00:28+0100
Last-Translator: Tomas Vondra <tv@fuzzy.cz>
Language-Team: Czech <info@cspug.cx>
Language: cs
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
X-Generator: Poedit 2.4.1
Plural-Forms: nplurals=3; plural=(n==1) ? 0 : (n>=2 && n<=4) ? 1 : 2;
Implicitně je vytvořena databáze stejného jména jako je jméno aktuálního uživatele.
Parametry spojení:
Přepínače:
Pro detaily čtěte popis SQL příkazu CLUSTER.
Pro detaily čtěte popis SQL příkazu REINDEX.
Pro detaily čtěte popis SQL příkazu VACUUM.
Chyby hlaste na adresu <pgsql-bugs@postgresql.org>.
--analyze-in-stages pouze aktualizuje statistiky optimizéru, v několika
fázích pro rychlejší výsledky; bez vacuum
--lc-collate=LOCALE nastavení LC_COLLATE pro databázi
--lc-ctype=LOCALE nastavení LC_CTYPE pro databázi
%s [PŘEPÍNAČ]...
%s [PŘEPÍNAČ]... DATABÁZE
%s [PŘEPÍNAČ]... JAZYK [DATABÁZE]
%s [PŘEPÍNAČ]... [DATABÁZE]
%s [PŘEPÍNAČ]... [DATABÁZE] [POPIS]
%s [PŘEPÍNAČ]... [JMÉNO ROLE]
--if-exists nevypisuj chybu pokud databáze neexistuje
--if-exists nevypisuj chybu pokud uživatel neexistuje
--interactive zeptej se na chybějící jméno role a atributy namísto
použití výchozích hodnot
--maintenance-db=DBNAME alternativní maintenance databáze
--maintenance-db=DBNAME alternativní maintenance databáze
--no-replication role nemůže inicializovat replikaci
--replication role může inicializovat replikaci
-?, --help ukáže tento text a skončí
-?, --help ukáže tuto nápovědu a skončí
-?, --help ukáže tuto nápovědu a skončí
-?, --help ukáže tuto nápovědu a skončí
-D, --no-createdb role nemůže vytvářet nové databáze (výchozí)
-D, --tablespace=PROSTOR výchozí prostor tabulek pro databázi
-E, --encoding=KÓDOVÁNÍ kódování znaků databáze
-E, --encrypted uložit heslo v zašifrované podobě
-F, --freeze zmrazí transakční informace záznamů
-I, --no-inherit role nedědí práva
-L, --no-login role se nemůže přihlásit
-N, --unencrypted uložit heslo v otevřeném tvaru
-O, --owner=VLASTNÍK uživatel, který má být vlastníkem nové databáze
-P, --pwprompt nastavit heslo pro novou roli
-R, --no-createrole role nemůže vytvářet nové role (výchozí)
-S, --no-superuser role nebude superuživatel (výchozí)
-S, --schema=SCHEMA reindexace pouze zadaných schemat
-T, --template=ŠABLONA šablona databáze ke kopírování
-U, --username=UŽIVATEL jméno uživatele pro spojení se serverem
-U, --username=UŽIVATEL jméno uživatele pro spojení se serverem
-U, --username=UŽIVATEL jméno uživatele pro spojení (ne pro tvorbu)
-U, --username=UŽIVATEL jméno uživatele pro spojení (ne pro odstranění)
-U, --username=UŽIVATEL jméno uživatele pro připojení
-V, --version ukáže informace o verzi a skončí
-V, --version ukáže informaci o verzi a skončí
-V, --version ukáže informaci o verzi a skončí
-V, --version ukáže informaci o verzi a skončí
-W, --password vynutí dotaz na heslo
-W, --password vynutí dotaz na heslo
-Z, --analyze-only pouze aktualizaze statistik optimalizéru; bez vacuum
-a, --all provést VACUUM všech databází
-a, --all clusterovat všechny databáze
-a, --all reindexovat všechny databáze
-c, --connection-limit=N limit počtu konexí pro role (implicitně: bez limitu)
-d, --createdb role může vytvářet nové databáze
-d, --dbname=DATABÁZE jméno databáze k provedení příkazu VACUUM
-d, --dbname=DATABÁZE databáze, ze které bude jazyk odstraněn
-d, --dbname=DATABÁZE databáze pro cluster
-d, --dbname=DATABÁZE databáze do které bude jazyk instalován
-d, --dbname=DATABÁZE databáze k reindexaci
-d, --dbname=DATABÁZE databáze k reindexaci
-e, --echo ukázat příkazy posílané na server
-e, --echo ukázat příkazy posílané na server
-e, --echo ukazovat příkazy posílané na server
-f, --full provést plné (FULL) VACUUM
-g, --role=ROLE nová role bude členem této role
-h, --host=HOSTNAME jméno databázového serveru nebo adresáře se soketem
-h, --host=HOSTNAME jméno databázového serveru nebo adresáře se soketem
-h, --host=HOSTNAME jméno databázového serveru nebo adresáře se soketem
-i, --index=JMÉNO obnovit pouze vybraný index
-i, --inherit role dědí práva rolí, kterých je členem
(implicitně)
-i, --interactive zeptej se před smazáním čehokoli
-i, --interactive před smazáním čehokoliv se zeptá, a také na jméno
role pokud není zadáno
-j, --jobs=NUM použij tento počet paralelních jobů pro vacuum
-l, --list ukáže seznam již nainstalovaných jazyků
-l, --locale=LOCALE nastavení locale pro databázi
-l, --login role se může přihlásit (implicitně)
-p, --port=PORT port databázového serveru
-p, --port=PORT port databázového serveru
-p, --port=PORT port databázového serveru
-q, --quiet tichý mód
-q, --quiet nevypisovat žádné zprávy
-q, --quiet nevypisovat žádné zprávy
-r, --createrole role může vytvářet nové role
-s, --superuser role bude superuživatel
-s, --system reindexace systémového katalogu
-t, --table='TABULKA[(SLOUPCE)]' provést VACUUM pouze u specifikované tabulky
-t, --table=TABULKA provést cluster pro danou tabulku
-t, --table=TABULKA reidexace pouze vybranou tabulku
-t, --timeout=SECS počet vteřin čekání při pokusu o spojení, 0 toto omezení vypne (výchozí: %s)
-v, --verbose vypisovat více informací
-v, --verbose vypisovat více informací
-w, --no-password neptá se na heslo
-w, --no-password neptá se na heslo
-z, --analyze aktualizace statistik optimalizéru
%s (%s/%s) %s pročišťuje a analyzuje PostgreSQL databázi.
%s vytváří cluster všech již dříve clusterovaných tabulek v databázi.
%s vytvoří PostgreSQL databázi.
%s vytvoří novou PostgreSQL roli.
%s instaluje procedurální jazyk do PostgreSQL databáze.
%s provede kontrolu spojení k PostgreSQL databázi.
%s vytvoří PostgreSQL databázi.
%s odstraňuje PostgreSQL databázi.
%s odstraňuje PostgreSQL roli.
%s odstraňuje procedurální jazyk z databáze.
%s: "%s" není platné jméno kódování znaků
%s: %s %s: nelze vytvořit cluster ve všech databázích a zároveň specifikovat jen jednu
%s: nelze provést cluster specifické tabulky ve všech databázích
%s: nelze reindexovat všechny databáze a současně zvolenou databázi
%s: nelze reindexovat všechny databáze a současně systemový katalog
%s: nelze reindexovat vybraný index a současně sytémový katalog
%s: nelze reindexovat vybraný index ve všech databázích
%s: nelze reindexovat vybraná schemata a současně sytémové katalogy
%s: nelze reindexovat vybrané schema ve všech databázích
%s: nelze reindexovat vybranou tabulku a současně sytémové katalogy
%s: nelze reindexovat vybranou tabulku ve všech databázích
%s: při provádění jen analyze nelze použít volbu "%s"
%s: nelze provádět VACUUM u všech databází a zároveň specifikovat jen jednu
%s: nelze provést VACUUM specifické tabulky ve všech databázích
%s: provádí se cluster databáze "%s"
%s: vytváření clusterů databáze "%s" selhalo: %s %s: vytváření clusteru tabulky "%s" v databázi "%s" selhalo: %s %s: tvorba komentáře selhala (databáze byla vytvořena): %s %s: nelze navázat spojení s databází %s: %s %s: nelze navázat spojení s databází %s: nedotatek paměti
%s: nelze načíst výchozí volby
%s: tvorba nové role selhala: %s %s: vytvoření databáze selhalo: %s %s: odstraňování databáze selhalo: %s %s: neplatný argument pro --connection-limit: %s
%s: jazyk "%s" je již v databázi "%s" instalován
%s: jazyk "%s" není v databázi "%s" instalován
%s: instalace jazyka selhala: %s %s: odstraňování jazyka selhalo: %s %s: chybí vyžadovaný parametr jméno databáze
%s: chybí povinný parametr jméno jazyka
%s: chybí povinný parametr jméno role
%s: počet paralelních jobů musí být alespoň 1
%s: --locale a --lc-collate nelze zvolit současně
%s: --locale a --lc-ctype nelze zvolit současně
%s: zpracovávám databázi "%s" : %s
%s: dotaz selhal: %s %s: dotaz vrátil %d řádek namísto jedné: %s
%s: dotaz vrátil %d řádky namísto jedné: %s
%s: dotaz vrátil %d řádek namísto jedné: %s
%s: dotaz byl: %s
%s: reindexace databáze "%s"
%s: reindexace databáze "%s" selhala: %s %s: reindexace indexu "%s" v databázi "%s" selhala: %s %s: reindexace schematu "%s" v databázi "%s" selhala: %s %s: reindexace systémového katalogu selhala: %s %s: reindexace tabulky "%s" v databázi "%s" selhala: %s %s: odstraňování role "%s" selhalo: %s %s: příliš mnoho parametrů příkazové řádky (první je "%s")
%s: příliš mnoho jobů pro tuto platformu -- zkuste %d
%s: provádí se VACUUM databáze "%s"
%s: provádění VACUUM databáze "%s" selhalo: %s %s: provádění VACUUM tabulky "%s" v databázi "%s" selhalo: %s (%lu řádka) (%lu řádky) (%lu řádek) Určitě? Požadavek na zrušení byl poslán
Nelze přidat buňku do obsahu tabulky: překročen celkový počet buněk %d.
Nelze přidat hlavičku k obsahu tabulky: překročen počet sloupců %d.
Nelze poslat požadavek na zrušení: %s Databáze "%s" bude trvale odstraněna.
Zadejte znova: Vložte jméno role, kterou chete přidat: Vložte jméno role pro odstranění: Vložte heslo nové role: Generuji výchozí (plné) statistiky optimizéru Generuji minimální statistiky optimizéru (1 cílů) Generuji minimální statistiky optimizéru (1 cíl) Přerušeno
Jméno Zašifrování hesla selhalo.
Heslo: Hesla se neshodují.
Prosím odpovězte "%s" nebo "%s".
Procedurální jazyky Role "%s" bude trvale odstraněna.
Má být nová role superuživatel? Měla by mít nová role právo vytvářet databáze? Měla by mít nová role právo vytvářet další nové role? Důvěryhodný? Zkuste "%s --help" pro více informací.
Použití:
server přijímá spojení
nelze duplikovat nulový ukazatel (interní chyba)
nelze nalézt effective user ID %ld: %s specifikován neplatný formát výstupu (interní chyba): %d n ne žádný pokus
žádná odpověď
paměť vyčerpána
server odmítá spojení
neznámo
uživatel neexistuje chyba vyhledávání jména uživatele: chybový kód %lu a ano locale/cs/LC_MESSAGES/ecpglib6-9.6.mo 0000644 00000007150 14751153421 0012545 0 ustar 00 �� ! $ / , � � � � ) ' - Q : 0 � $ � ( 9 L * c ; � > � 3 < = & z 1 � � + � ' @ % Y � , � � 2 0 ; / l � � , 8 = X & g / � G � 3
' :
+ b
�
�
0 �
> �
D 3 9 x B � - � = # & a ( � * � � " � (
( I
5 r
% �
3 �
5 / 8
! <DEFAULT> <empty> NULL SQL error %d on line %d SQL error: %s
connection "%s" does not exist on line %d could not connect to database "%s" on line %d could not convert boolean value: size mismatch, on line %d data read from server is not an array on line %d descriptor "%s" not found on line %d descriptor index out of range on line %d empty message text empty query on line %d error in transaction processing on line %d inserting an array of variables is not supported on line %d invalid input syntax for floating-point type: "%s", on line %d invalid input syntax for type int: "%s", on line %d invalid input syntax for type unsigned int: "%s", on line %d invalid statement name "%s" on line %d invalid syntax for type boolean: "%s", on line %d no data found on line %d not connected to connection "%s" on line %d null value without indicator on line %d out of memory on line %d the connection to the server was lost too few arguments on line %d too many arguments on line %d unrecognized descriptor item "%s" on line %d unsupported type "%s" on line %d variable does not have a character type on line %d variable does not have a numeric type on line %d variable does not have an array type on line %d Project-Id-Version: ecpglib-cs (PostgreSQL 9.3)
Report-Msgid-Bugs-To: pgsql-bugs@postgresql.org
POT-Creation-Date: 2018-07-13 15:58+0000
PO-Revision-Date: 2018-07-14 01:03+0200
Last-Translator: Tomas Vondra <tv@fuzzy.cz>
Language-Team: Czech <info@cspug.cx>
Language: cs
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
X-Generator: Poedit 2.0.7
<VÝCHOZÍ> <prázdný> NULL SQL chyba %d na řádce %d SQL chyba: %s
spojení "%s" neexistuje na řádce %d nelze se spojit s databází "%s" na řádce %d nelze zkonvertovat boolean hodnotu: nesprávná velikost, na řádce %d data načtená ze serveru nejsou pole na řádce %d deskriptor "%s" nenalezen na řádce %d index deskriptoru mimo rozsah na řádce %d prázdný text zprávy prázdný dotaz na řádce %d chyba v transakčním zpracování na řádce %d vkládání pole proměnných není podporováno na řádce %d chybná vstupní syntaxe pro typ floating-point: "%s", na řádce %d chybná vstupní syntaxe pro typ int: "%s", na řádce %d chybná vstupní syntaxe pro typ unsigned int: "%s", na řádce %d neplatný název příkazu "%s" na řádce %d chybná vstupní syntaxe pro typ boolean: "%s", na řádce %d na řádce %d nenalezena žádná data neotevřené spojení "%s" na řádce %d null hodnota bez indikátoru na řádce %d nedostatek paměti na řádce %d spojení se serverem bylo ztraceno příliš málo argumentů na řádce %d příliš mnoho argumentů na řádce %d nerozpoznaná položka deskriptoru "%s" na řádce %d nepodporovaný typ "%s" na řádce %d proměnná nemá znakový datový typ na řádce %d proměnná nemá číselný datový typ na řádce %d proměnná nemá datový typ pole na řádce %d locale/cs/LC_MESSAGES/pg_dump-9.6.mo 0000644 00000171351 14751153421 0012512 0 ustar 00 �� � \ � � �( �( �( X �( [ S) B �) ) �) " * x ?* �* �* �* �* A + N F+ P �+ I �+ 3 0, y d, G �, C &- N j- K �- v . F |. > �. R / B U/ E �/ ? �/ L 0 3 k0 6 �0 Q �0 T (1 M }1 ? �1 � 2 � �2 ? R3 9 �3 5 �3 : 4 K =4 B �4 D �4 � 5 3 �5 � �5 ? H6 D �6 x �6 6 F7 Q }7 O �7 F 8 > f8 5 �8 > �8 E 9 A `9 O �9 H �9 B ;: @ ~: = �: O �: H M; ; �; , �; 4 �; E 4< 0 z< = �< ; �< F %= D l= C �= F �= 8 <> ? u> C �> = �> 4 7? 7 l? L �? = �? @ /@ J p@ < �@ L �@ , EA ( rA 5 �A E �A T B lB 9 oB D �B G �B 6C QC ? lC ' �C * �C e �C ! eD , �D 4 �D 6 �D ( E / IE yE �E $ �E * �E 2 �E B ,F > oF J �F P �F N JG H �G - �G H %H / 8H hH 4 zH $ �H & �H * �H # &I JI P iI C �I A �I ( @J iJ �J �J �J = �J K � 5K
�K , �K � �K � �L , (M UM p jM e �M & AN hN ` pN p �N 4 BO X wO _ �O E 0P 1 vP 6 �P 4 �P * Q - ?Q D mQ . �Q + �Q +
R ) 9R * cR > �R : �R ' S = 0S ) nS 1 �S �S @ �S 7 &T 6 ^T 6 �T < �T = U 4 GU 3 |U b �U 9 V < MV t �V # �V , #W 5 PW �W �W �W
�W ' �W X % X 9X / YX X �X & �X 0 Y . :Y - iY �Y �Y �Y 3 �Y ( Z )Z # <Z `Z & �Z K �Z & �Z [ ! 9[ ( [[ ' �[ # �[ # �[ �[ / \ D\ e\ # �\ % �\ �\ , �\ $ ] $ :] $ _] 6 �] �] �] B �] � 7^ � �^ ]_ $ }_ < �_ 3 �_ * ` ' >` + f` ( �` ( �` # �` - a � 6a + b , 2b ! _b & �b ' �b # �b �b " c 8 6c $ oc �c �c Q �c & %d a Ld @ �d 5 �d , %e Re " me # �e , �e �e ! f * "f # Mf % qf 0 �f & �f $ �f g " 3g = Vg # �g 1 �g �g �g h : !h ) \h B �h P �h i -i Li gi " wi �i �i & �i & �i % j 2 Ej xj �j & �j ! �j ) �j # k " @k ck r tk < �k D $l N il F �l �l m & 8m , _m - �m �m " �m / �m 'n ?n ( \n @ �n �n �n �n P o jo > �o 1 �o > �o / 0p Y `p > �p �p q " 2q Uq & rq < �q �q ' �q ( r ' ;r cr �r �r 1 �r + �r s % *s 3 Ps �s �s " �s ; �s t $t 0 Dt ut / �t �t �t u . u I Hu > �u D �u v %v Bv 7 Tv 9 �v 6 �v H �v @ Fw �w 3 �w & �w 0 �w 6 %x / \x ( �x , �x �x " �x y .y Oy h `y T �y � z 6 �z L �z J %{ 9 p{ �{ $ �{ + �{
| | ;| T| l| 2 �| �| " �| �| �| # } 4} R} / i} �} & �} �} �} # �} ~ $ /~ ) T~ ~~ ! �~ % �~ + �~ & 3 ' Z � � 0 � . � ) � + I� u� ( �� �� 4 �
� # �� * �� ߁ �� � '� ( @� i� " �� �� E �� # �� "� :� R� ; Y� �� �� �� ' ԃ �� ' � <� % \� �� �� B �� 0 �� ! /� 8 Q� : �� Ņ � 3 � 1 4� 1 f� + �� $ Ć $ � h � � w� A� S� ` d� [ ʼn E !� & g� % �� r �� '� -� " >� a� L �� X � '� M �� 4 � � :� F Ǎ I � R X� X �� o � L t� A �� ] � J a� > �� > � t *� 9 �� : ّ X � U m� V Ò B � � ]� � � _ ʔ E *� A p� H �� U �� ? Q� V �� � � 5 t� � �� = ,� Q j� � �� W P� q �� Z � V u� D ̚ = � ? O� G �� C כ M � Y i� R Ü S � A j� T �� P � @ R� 7 �� 7 ˞ H � - L� @ z� : �� J �� Q A� S �� N � = 6� F t� C �� O �� 5 O� 7 �� O �� �
� D �� T ԣ D )� O n� : �� 6 �� 4 0� V e� S �� � J � > ^� K �� � � 6 � . W� 1 �� n �� '� / H� 7 x� = �� ' � . � E� d� ( x� 0 �� 1 ҩ B � > G� J �� P Ѫ N "� D q� E �� �� � 8 $� ]� G o� �� + ج . � * 3� ^� j � A � : ,� ( g� �� �� ʮ � A � H� � g� '� A /� � q� � � 9 DZ � z � e �� ) � � a *� f �� > � r 2� g �� M
� ? [� B �� @ 4 � , T� > �� 3 �� 0 � 0 %� . V� - �� G �� = �� 1 9� D k� 7 �� / � $ � E =� A �� 9 Ź = �� F =� E �� < ʺ : � c B� < �� C � { '� ' �� - ˼ D �� >� $ _�
�� �� & �� ƽ 0 ؽ + � / 5� K e� ) �� * ۾ # � % *� P� l� � 9 �� , ſ � - � % 5� & [� _ �� $ � � % &� ( L� & u� ( �� " � % � 6 � % E� k� % �� �� �� * �� # � % 9� " _� 2 �� �� ' �� ? �� � 2� � �� q� # �� ' �� 3 �� 2
� ' @� 1 h� % �� & �� ) �� , � � >� . � 0 @� $ q� ) �� + �� ) �� $ � $ ;� @ `� + �� & �� ! �� W � - n� k �� @ � ? I� , �� " �� " �� ! �� * � ! I� " k� + �� $ �� & �� 4 � - ;� $ i� �� & �� A �� ) � , ?� l� �� �� ; �� ; �� P %� G v� �� - �� �� � -� L� ' g� ) �� ) �� ( �� ; � H� " d� 0 �� ' �� 6 �� + � * C� n� � �� N =� I �� X �� O /� � * �� + �� + �� , !� " N� ! q� + �� �� % �� . � I 2� |� ) �� " �� � �� r� P �� 3 �� I
� C W� N �� ? �� *� ! I� & k� �� . �� B �� %� 5 D� . z� 0 �� �� �� � > '� 7 f� $ �� . �� ? �� 2� S� q� K �� $ �� 2 � > 5� 1 t� < �� ' �� � ,� - H� I v� > �� D �� D� " X� {� = �� A �� > � H P� ? �� �� 3 �� . )� 6 X� 7 �� 0 �� + �� / $� T� ' f� �� ) �� �� z �� � e� � �� : �� a �� H a� ? �� �� 0 �� % *� P� & _� �� �� �� ' �� �� �� � 6� ! S� u� �� . �� �� $ �� � %� " 4� W� 2 l� 0 �� ( �� & �� - � 3 N� $ �� 1 �� 0 �� (
� % 3� . Y� 4 �� 2 �� 3 �� " $� ( G� p� O �� l �� # J� * n� �� " �� �� �� + � =� V� s� Y �� �� � #� ?� : F� �� �� �� ' �� �� , � . 2� + a� �� " �� B �� / � A� ? b� G �� �� � 8 &� 3 _� 4 �� 1 �� - �� # (� � L� � � q � � � � m � _ � � A � 8 � � > n l u ! � � � � F � � � � / � & � ^ � a � � � � � � " � ( � � ] � V � � j B 0 � � : � (
V q R � � G � � � - w � � � � Y � � i ? � h � � � � � E b T � ' , � � k D l � � � � � � � 3 � � � � � � � � g � � � | � � � � 8 � � � � � � r K � � 7 �
� I � � J L v � � R � � 0 � � � � : 2 � = 4 % � e ) � + � � � � � p d � � 1 v � t � + c � � s � � � . j ; � / � 4 ^ z L Y X H � � & � \ � � C � � � # � 3 � H � Q = � B J T ~ U � ~ � o E I 6 6 � x � [ K � � z 7 � c o m w h s � � F ! ? n $ p 9 � Z � � � � � a � Z
� � 5 5 C @ � � { � � � g y { P � * , # � � @ � � � � � S b > � O � � � P N . � ; � � � � � ` � r ) � � � � � � � � |
� � t _ � O < i " � G x � � S W % � - � � � � � � � � � D � � N 1 � X � � ` � � � � f � ' < * � � � ] � M } \ [ } Q � � � $ W � � � � � � � 9 � � y A e � d � U � � � � 2 � u f � M � k �
Connection options:
General options:
If -f/--file is not used, then the SQL script will be written to the standard
output.
If no database name is supplied, then the PGDATABASE environment
variable value is used.
If no input file name is supplied, then standard input is used.
Options controlling the output content:
Options controlling the restore:
The options -I, -n, -P, -t, -T, and --section can be combined and specified
multiple times to select multiple objects.
%s
%s [OPTION]...
%s [OPTION]... [DBNAME]
%s [OPTION]... [FILE]
--binary-upgrade for use by upgrade utilities only
--column-inserts dump data as INSERT commands with column names
--disable-dollar-quoting disable dollar quoting, use SQL standard quoting
--disable-triggers disable triggers during data-only restore
--enable-row-security enable row security
--enable-row-security enable row security (dump only content user has
access to)
--exclude-table-data=TABLE do NOT dump data for the named table(s)
--if-exists use IF EXISTS when dropping objects
--inserts dump data as INSERT commands, rather than COPY
--lock-wait-timeout=TIMEOUT fail after waiting TIMEOUT for a table lock
--no-data-for-failed-tables do not restore data of tables that could not be
created
--no-security-labels do not dump security label assignments
--no-security-labels do not restore security labels
--no-synchronized-snapshots do not use synchronized snapshots in parallel jobs
--no-tablespaces do not dump tablespace assignments
--no-tablespaces do not restore tablespace assignments
--no-unlogged-table-data do not dump unlogged table data
--quote-all-identifiers quote all identifiers, even if not key words
--role=ROLENAME do SET ROLE before dump
--role=ROLENAME do SET ROLE before restore
--section=SECTION dump named section (pre-data, data, or post-data)
--section=SECTION restore named section (pre-data, data, or post-data)
--serializable-deferrable wait until the dump can run without anomalies
--snapshot=SNAPSHOT use given snapshot for the dump
--strict-names require table and/or schema include patterns to
match at least one entity each
--use-set-session-authorization
use SET SESSION AUTHORIZATION commands instead of
ALTER OWNER commands to set ownership
-1, --single-transaction restore as a single transaction
-?, --help show this help, then exit
-?, --help show this help, then exit
-C, --create create the target database
-C, --create include commands to create database in dump
-E, --encoding=ENCODING dump the data in encoding ENCODING
-F, --format=c|d|t backup file format (should be automatic)
-F, --format=c|d|t|p output file format (custom, directory, tar,
plain text (default))
-I, --index=NAME restore named index
-L, --use-list=FILENAME use table of contents from this file for
selecting/ordering output
-N, --exclude-schema=SCHEMA do NOT dump the named schema(s)
-O, --no-owner skip restoration of object ownership
-O, --no-owner skip restoration of object ownership in
plain-text format
-P, --function=NAME(args) restore named function
-S, --superuser=NAME superuser user name to use for disabling triggers
-S, --superuser=NAME superuser user name to use in plain-text format
-S, --superuser=NAME superuser user name to use in the dump
-T, --exclude-table=TABLE do NOT dump the named table(s)
-T, --trigger=NAME restore named trigger
-U, --username=NAME connect as specified database user
-V, --version output version information, then exit
-V, --version output version information, then exit
-W, --password force password prompt (should happen automatically)
-Z, --compress=0-9 compression level for compressed formats
-a, --data-only dump only the data, not the schema
-a, --data-only restore only the data, no schema
-b, --blobs include large objects in dump
-c, --clean clean (drop) database objects before recreating
-c, --clean clean (drop) databases before recreating
-d, --dbname=CONNSTR connect using connection string
-d, --dbname=DBNAME database to dump
-d, --dbname=NAME connect to database name
-e, --exit-on-error exit on error, default is to continue
-f, --file=FILENAME output file name
-f, --file=FILENAME output file or directory name
-f, --file=FILENAME output file name (- for stdout)
-g, --globals-only dump only global objects, no databases
-h, --host=HOSTNAME database server host or socket directory
-j, --jobs=NUM use this many parallel jobs to dump
-j, --jobs=NUM use this many parallel jobs to restore
-l, --database=DBNAME alternative default database
-l, --list print summarized TOC of the archive
-n, --schema=NAME restore only objects in this schema
-n, --schema=SCHEMA dump the named schema(s) only
-o, --oids include OIDs in dump
-p, --port=PORT database server port number
-r, --roles-only dump only roles, no databases or tablespaces
-s, --schema-only dump only the schema, no data
-s, --schema-only restore only the schema, no data
-t, --table=NAME restore named relation (table, view, etc.)
-t, --table=TABLE dump the named table(s) only
-t, --tablespaces-only dump only tablespaces, no databases or roles
-v, --verbose verbose mode
-v, --verbose verbose mode
-w, --no-password never prompt for password
-x, --no-privileges do not dump privileges (grant/revoke)
-x, --no-privileges skip restoration of access privileges (grant/revoke)
%s %s dumps a database as a text file or to other formats.
%s extracts a PostgreSQL database cluster into an SQL script file.
%s restores a PostgreSQL database from an archive created by pg_dump.
%s: %s Command was: %s
%s: WSAStartup failed: %d
%s: cannot specify both --single-transaction and multiple jobs
%s: could not connect to database "%s"
%s: could not connect to database "%s": %s %s: could not connect to databases "postgres" or "template1"
Please specify an alternative database.
%s: could not get server version
%s: could not open the output file "%s": %s
%s: could not parse ACL list (%s) for database "%s"
%s: could not parse ACL list (%s) for tablespace "%s"
%s: could not parse server version "%s"
%s: could not re-open the output file "%s": %s
%s: dumping database "%s"...
%s: executing %s
%s: invalid number of parallel jobs
%s: maximum number of parallel jobs is %d
%s: option --if-exists requires option -c/--clean
%s: options -c/--clean and -a/--data-only cannot be used together
%s: options -d/--dbname and -f/--file cannot be used together
%s: options -g/--globals-only and -r/--roles-only cannot be used together
%s: options -g/--globals-only and -t/--tablespaces-only cannot be used together
%s: options -r/--roles-only and -t/--tablespaces-only cannot be used together
%s: options -s/--schema-only and -a/--data-only cannot be used together
%s: pg_dump failed on database "%s", exiting
%s: query failed: %s %s: query was: %s
%s: role name starting with "pg_" skipped (%s)
%s: running "%s"
%s: too many command-line arguments (first is "%s")
%s: unrecognized section name: "%s"
(The INSERT command cannot set OIDs.)
(The system catalogs might be corrupted.)
-C and -1 are incompatible options
COPY failed for table "%s": %s Consider using a full dump instead of a --data-only dump to avoid this problem.
Dumping the contents of table "%s" failed: PQgetCopyData() failed.
Dumping the contents of table "%s" failed: PQgetResult() failed.
Error from TOC entry %d; %u %u %s %s %s
Error message from server: %s Error while FINALIZING:
Error while INITIALIZING:
Error while PROCESSING TOC:
Exported snapshots are not supported by this server version.
LOCK TABLE failed for "%s": %s NOTICE: there are circular foreign-key constraints on this table:
NOTICE: there are circular foreign-key constraints among these tables:
Password: Report bugs to <pgsql-bugs@postgresql.org>.
Synchronized snapshots are not supported by this server version.
Run with --no-synchronized-snapshots instead if you do not need
synchronized snapshots.
Synchronized snapshots are not supported on standby servers.
Run with --no-synchronized-snapshots instead if you do not need
synchronized snapshots.
TOC Entry %s at %s (length %s, checksum %d)
The command was: %s
The program "pg_dump" is needed by %s but was not found in the
same directory as "%s".
Check your installation.
The program "pg_dump" was found by "%s"
but was not the same version as %s.
Check your installation.
Try "%s --help" for more information.
Usage:
WARNING: aggregate function %s could not be dumped correctly for this database version; ignored
WARNING: archive is compressed, but this installation does not support compression -- no data will be available
WARNING: archive items not in correct section order
WARNING: archive was made on a machine with larger integers, some operations might fail
WARNING: bogus transform definition, at least one of trffromsql and trftosql should be nonzero
WARNING: bogus value in pg_cast.castfunc or pg_cast.castmethod field
WARNING: bogus value in pg_cast.castmethod field
WARNING: bogus value in pg_transform.trffromsql field
WARNING: bogus value in pg_transform.trftosql field
WARNING: bogus value in proargmodes array
WARNING: could not find operator with OID %s
WARNING: could not find where to insert IF EXISTS in statement "%s"
WARNING: could not parse proallargtypes array
WARNING: could not parse proargmodes array
WARNING: could not parse proargnames array
WARNING: could not parse proconfig array
WARNING: could not parse reloptions array
WARNING: could not resolve dependency loop among these items:
WARNING: don't know how to set owner for object type "%s"
WARNING: errors ignored on restore: %d
WARNING: ftell mismatch with expected position -- ftell used
WARNING: invalid creation date in header
WARNING: invalid type "%c" of access method "%s"
WARNING: line ignored: %s
WARNING: owner of aggregate function "%s" appears to be invalid
WARNING: owner of data type "%s" appears to be invalid
WARNING: owner of function "%s" appears to be invalid
WARNING: owner of operator "%s" appears to be invalid
WARNING: owner of operator class "%s" appears to be invalid
WARNING: owner of operator family "%s" appears to be invalid
WARNING: owner of schema "%s" appears to be invalid
WARNING: owner of table "%s" appears to be invalid
WARNING: requested compression not available in this installation -- archive will be uncompressed
WARNING: typtype of data type "%s" appears to be invalid
WARNING: unexpected extra results during COPY of table "%s"
You might not be able to restore the dump without using --disable-triggers or temporarily dropping the constraints.
a worker process died unexpectedly
aborting because of server version mismatch
actual file length (%s) does not match expected (%s)
allocating AH for %s, format %d
already connected to a database
archiver archiver (db) attempting to ascertain archive format
bad dumpId
bad table dumpId for TABLE DATA item
can only reopen input archives
cannot duplicate null pointer (internal error)
cannot restore from compressed archive (compression not supported in this installation)
child process exited with exit code %d child process exited with unrecognized status %d child process was terminated by exception 0x%X child process was terminated by signal %d: %s command not executable command not found compress_io compression is not supported by tar archive format
compression level must be in range 0..9
compressor active
connecting to database for restore
connecting to new database "%s"
connection to database "%s" failed: %s corrupt tar header found in %s (expected %d, computed %d) file position %s
could not change directory to "%s": %s could not close TOC file: %s
could not close archive file: %s
could not close compression library: %s
could not close compression stream: %s
could not close data file "%s": %s
could not close directory "%s": %s
could not close input file: %s
could not close large object TOC file "%s": %s
could not close output file: %s
could not close tar member
could not close temporary file: %s
could not commit database transaction could not compress data: %s
could not create communication channels: %s
could not create directory "%s": %s
could not create large object %u: %s could not create worker process: %s
could not determine seek position in archive file: %s
could not execute query could not find a "%s" to execute could not find block ID %d in archive -- possibly corrupt archive
could not find block ID %d in archive -- possibly due to out-of-order restore request, which cannot be handled due to lack of data offsets in archive
could not find block ID %d in archive -- possibly due to out-of-order restore request, which cannot be handled due to non-seekable input file
could not find entry for ID %d
could not find file "%s" in archive
could not find function definition for function with OID %u
could not find header for file "%s" in tar archive
could not find parent extension for %s %s
could not find slot of finished worker
could not generate temporary file name: %s
could not get server_version from libpq
could not identify current directory: %s could not identify dependency loop
could not initialize compression library: %s
could not obtain lock on relation "%s"
This usually means that someone requested an ACCESS EXCLUSIVE lock on the table after the pg_dump parent process had gotten the initial ACCESS SHARE lock on the table.
could not open TOC file "%s" for input: %s
could not open TOC file "%s" for output: %s
could not open TOC file "%s": %s
could not open TOC file for input: %s
could not open TOC file for output: %s
could not open input file "%s": %s
could not open input file: %s
could not open large object %u: %s could not open large object TOC file "%s" for input: %s
could not open output file "%s": %s
could not open output file: %s
could not open temporary file
could not parse GRANT ACL list (%s) or REVOKE ACL list (%s) for object "%s" (%s)
could not parse default ACL list (%s)
could not parse initial GRANT ACL list (%s) or initial REVOKE ACL list (%s) for object "%s" (%s)
could not parse numeric array "%s": invalid character in number
could not parse numeric array "%s": too many numbers
could not parse result of current_schemas()
could not read binary "%s" could not read directory "%s": %s
could not read from input file: %s
could not read from input file: end of file
could not read input file: %s
could not read symbolic link "%s" could not set default_tablespace to %s: %s could not set default_with_oids: %s could not set search_path to "%s": %s could not set seek position in archive file: %s
could not set session user to "%s": %s could not start database transaction could not uncompress data: %s
could not write to blobs TOC file
could not write to large object (result: %lu, expected: %lu)
could not write to output file: %s
could not write to the communication channel: %s
creating %s "%s"
creating %s "%s.%s"
custom archiver definition of view "%s" appears to be empty (length zero)
did not find magic string in file header
direct database connections are not supported in pre-1.3 archives
directory "%s" does not appear to be a valid archive ("toc.dat" does not exist)
directory archiver directory name too long: "%s"
disabling triggers for %s
dropping %s %s
dumping contents of table "%s.%s"
enabling triggers for %s
entering main parallel loop
entering restore_toc_entries_parallel
entering restore_toc_entries_postfork
entering restore_toc_entries_prefork
entry ID %d out of range -- perhaps a corrupt TOC
error during backup
error during file seek: %s
error processing a parallel work item
error reading large object %u: %s error reading large object TOC file "%s"
error returned by PQputCopyData: %s error returned by PQputCopyEnd: %s executing %s %s
expected %d check constraint on table "%s" but found %d
expected %d check constraints on table "%s" but found %d
expected format (%d) differs from format found in file (%d)
failed sanity check, parent OID %u of table "%s" (OID %u) not found
failed sanity check, parent table OID %u of pg_rewrite entry OID %u not found
failed sanity check, parent table OID %u of sequence OID %u not found
failed to connect to database
file name too long: "%s"
file offset in dump file is too large
finding check constraints for table "%s.%s"
finding default expressions of table "%s.%s"
finding extension tables
finding inheritance relationships
finding the columns and types of table "%s.%s"
finished item %d %s %s
finished main parallel loop
flagging inherited columns in subtables
found unexpected block ID (%d) when reading data -- expected %d
function "%s" not found
identifying extension members
implied data-only restore
incomplete tar header found (%lu byte)
incomplete tar header found (%lu bytes)
index "%s" not found
input file appears to be a text format dump. Please use psql.
input file does not appear to be a valid archive
input file does not appear to be a valid archive (too short?)
input file is too short (read %lu, expected 5)
internal error -- WriteData cannot be called outside the context of a DataDumper routine
internal error -- neither th nor fh specified in tarReadRaw()
invalid ENCODING item: %s
invalid OID for large object
invalid OID for large object (%u)
invalid STDSTRINGS item: %s
invalid adnum value %d for table "%s"
invalid argument string (%s) for trigger "%s" on table "%s"
invalid binary "%s" invalid client encoding "%s" specified
invalid column number %d for table "%s"
invalid column numbering in table "%s"
invalid compression code: %d
invalid dependency %d
invalid dumpId %d
invalid line in large object TOC file "%s": "%s"
invalid message received from worker: "%s"
invalid number of parallel jobs
invalid output format "%s" specified
large-object output not supported in chosen format
last built-in OID is %u
launching item %d %s %s
missing index for constraint "%s"
moving from position %s to next member at file position %s
no item ready
no matching schemas were found
no matching schemas were found for pattern "%s"
no matching tables were found
no matching tables were found for pattern "%s"
no output directory specified
not built with zlib support
now at file position %s
option --if-exists requires option -c/--clean
options --inserts/--column-inserts and -o/--oids cannot be used together
options -c/--clean and -a/--data-only cannot be used together
options -s/--schema-only and -a/--data-only cannot be used together
out of memory
out of on_exit_nicely slots
parallel archiver parallel backup only supported by the directory format
parallel restore from non-seekable file is not supported
parallel restore from standard input is not supported
parallel restore is not supported with archives made by pre-8.0 pg_dump
parallel restore is not supported with this archive file format
pclose failed: %s pgpipe: could not accept connection: error code %d
pgpipe: could not bind: error code %d
pgpipe: could not connect socket: error code %d
pgpipe: could not create second socket: error code %d
pgpipe: could not create socket: error code %d
pgpipe: could not listen: error code %d
pgpipe: getsockname() failed: error code %d
processing %s
processing data for table "%s.%s"
processing item %d %s %s
processing missed item %d %s %s
query failed: %s query produced null referenced table name for foreign key trigger "%s" on table "%s" (OID of table: %u)
query returned %d row instead of one: %s
query returned %d rows instead of one: %s
query to get data of sequence "%s" returned %d row (expected 1)
query to get data of sequence "%s" returned %d rows (expected 1)
query to get data of sequence "%s" returned name "%s"
query to get rule "%s" for table "%s" failed: wrong number of rows returned
query to obtain definition of view "%s" returned more than one definition
query to obtain definition of view "%s" returned no data
query was: %s
read TOC entry %d (ID %d) for %s %s
reading column info for interesting tables
reading constraints
reading default privileges
reading dependency data
reading event triggers
reading extensions
reading foreign key constraints for table "%s.%s"
reading indexes
reading indexes for table "%s.%s"
reading large objects
reading policies
reading policies for table "%s.%s"
reading procedural languages
reading rewrite rules
reading row security enabled for table "%s.%s"
reading schemas
reading table inheritance information
reading transforms
reading triggers
reading triggers for table "%s.%s"
reading type casts
reading user-defined access methods
reading user-defined aggregate functions
reading user-defined collations
reading user-defined conversions
reading user-defined foreign servers
reading user-defined foreign-data wrappers
reading user-defined functions
reading user-defined operator classes
reading user-defined operator families
reading user-defined operators
reading user-defined tables
reading user-defined text search configurations
reading user-defined text search dictionaries
reading user-defined text search parsers
reading user-defined text search templates
reading user-defined types
reconnection to database "%s" failed: %s reducing dependencies for %d
restored %d large object
restored %d large objects
restoring data out of order is not supported in this archive format: "%s" is required, but comes before "%s" in the archive file.
restoring large object with OID %u
sanity check on integer size (%lu) failed
saving database definition
saving encoding = %s
saving large objects
saving search_path = %s
saving standard_conforming_strings = %s
schema "%s" not found
schema with OID %u does not exist
select() failed: %s
server version must be at least 7.3 to use schema selection switches
server version: %s; %s version: %s
skipping item %d %s %s
skipping tar member %s
sorter table "%s" could not be created, will not restore its data
table "%s" not found
tar archiver this format cannot be read
transferring dependency %d -> %d to %d
trigger "%s" not found
unexpected COPY statement syntax: "%s"
unexpected data offset flag %d
unexpected policy command type: "%s"
unexpected section code %d
unexpected tgtype value: %d
unrecognized archive format "%s"; please specify "c", "d", or "t"
unrecognized command received from master: "%s"
unrecognized constraint type: %c
unrecognized data block type %d while restoring archive
unrecognized data block type (%d) while searching archive
unrecognized encoding "%s"
unrecognized file format "%d"
unrecognized object type in default privileges: %d
unrecognized proparallel value for function "%s"
unrecognized provolatile value for function "%s"
unsupported version (%d.%d) in file header
warning from original dump file: %s
worker process failed: exit code %d
wrote %lu byte of large object data (result = %lu)
wrote %lu bytes of large object data (result = %lu)
Project-Id-Version: pg_dump-cs (PostgreSQL 9.3)
Report-Msgid-Bugs-To: pgsql-bugs@postgresql.org
POT-Creation-Date: 2020-10-28 19:21+0000
PO-Revision-Date: 2020-11-01 00:32+0100
Last-Translator: Tomas Vondra <tv@fuzzy.cz>
Language-Team: Czech <info@cspug.cx>
Language: cs
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Plural-Forms: nplurals=3; plural=(n==1) ? 0 : (n>=2 && n<=4) ? 1 : 2;
X-Generator: Poedit 2.4.1
Volby spojení:
Obecné volby:
Pokud není použito -f/--file, potom SQL skript bude vypsán přímo na standardní
výstup.
Není-li specifikováno jméno databáze, použije se proměnná prostředí
PGDATABASE.
Není-li definován vstupní soubor, je použit standardní vstup.
Přepínače ovlivňující výstup:
Přepínače ovlivňující obnovu:
Volby -I, -n, -P, -t, -T, a --section mohou být kombinovány a zadány několikrát
pro výběr více objektů.
%s
%s [VOLBA]...
%s [PŘEPÍNAČ]... [DATABÁZE]
%s [PŘEPÍNAČ]... [SOUBOR]
--binary-upgrade pouze pro použití upgradovacími nástroji
--column-inserts použije pro dump dat příkaz INSERT se jmény sloupců
--disable-dollar-quoting nepoužívat znak dolaru místo uvozovek, používat
standardní SQL uvozování
--disable-triggers zakázat volání triggerů během obnovy dat
--enable-row-security povolit row security
--enable-row-security povolit row security (vypíše pouze data ke kterým má
uživatel přístup)
--exclude-table-data=TABLE NEdumpuj data pro vyjmenované tabulky
--if-exists použít IF EXISTS při mazání objektů
--inserts použít pro dump dat příkazy INSERT místo COPY
--lock-wait-timeout=TIMEOUT selže po uplynutí TIMEOUT čekáním na zámek tabulky
--no-data-for-failed-tables
neobnovuj data tabulek které nemohly být vytvořeny
--no-security-labels neprovádět dump bezpečnostních štítků
--no-security-labels neobnovuj bezpečnostní štítky
--no-synchronized-snapshots nepoužívat synchronizované snapshoty v paralelních jobech
--no-tablespaces neprovádět dump přiřazení tablespaces
--no-tablespaces neobnovuj přiřazení tablespaces
--no-unlogged-table-data nedumpuj data unlogged tabulek
--quote-all-identifiers všechny identifikátory uveď v uvozovkách, i když se nejedná o klíčová slova
--role=ROLENAME před dumpem proveď SET ROLE
--role=ROLENAME před obnovou proveď SET ROLE
--section=SECTION dump pojmenované sekce (pre-data, data, nebo post-data)
--section=SECTION obnov pojmenovanou sekci (pre-data, data, nebo post-data)
--serializable-deferrable počkej než bude možné provést dump bez anomálií
--snapshot=SNAPSHOT pro dump použít zadaný snapshot
--strict-names vyžadovat aby každý vzor pro zahrnutí tabulek a/nebo schémat
odpovídal alespoň jednomu objektu
--use-set-session-authorization
používat příkaz SET SESSION AUTHORIZATION namísto
příkazu ALTER OWNER pro nastavení vlastníka
-1, --single-transaction
zpracuj soubor v rámci jedné transakce
-?, --help zobraz tuto nápovědu, poté skonči
-?, --help zobraz tuto nápovědu, poté skonči
-C, --create vypíše příkazy pro vytvoření databáze
-C, --create zahrnout příkazy pro vytvoření databáze do dumpu
-E, --encoding=KÓDOVÁNÍ kódování znaků databáze
-F, --format=c|d|t formát záložního souboru (měl by být automatický)
-F, --format=c|d|t|p formát výstupního soubor (custom, directory, tar,
plain text (výchozí))
-I, --index=JMÉNO obnovit jmenovaný index
-L, --use-list=SOUBOR použít specifikovaný obsah (TOC) pro řazení
výstupu z tohoto souboru
-N, --exclude-schema=SCHEMA nedumpuj uvedené schéma(ta)
-O, --no-owner nevypisuje příkazy k nastavení vlastníka objektů
-O, --no-owner nevypisovat příkazy pro nastavení vlastníka objektu
v čistě textovém formátu
-P, --function=JMÉNO(args)
obnovit funkci daného jména
-S, --superuser=JMÉNO jméno superuživatele použité pro
zakázaní triggerů
-S, --superuser=JMÉNO uživatelské jméno superuživatele použité při dumpu
-S, --superuser=JMÉNO uživatelské jméno superuživatele použité při dumpu
-T, --exclude-table=TABLE neprováděj dump uvedených tabulek
-T, --trigger=JMÉNO obnovit pouze jmenovaný trigger
-U, --username=JMÉNO připoj se jako uvedený uživatel
-V, --version zobraz informaci o verzi, poté skonči
-V, --version zobraz informaci o verzi, poté skonči
-W, --password zeptej se na heslo (mělo by se dít automaticky)
-Z, --compress=0-9 úroveň komprese při použití komprimovaného formátu
-a, --data-only dump pouze dat bez definic databázových objektů
-a, --data-only obnovit pouze data, ne definice databázových objektů
-b, --blobs zahrnout "large objects" do dumpu
-c, --clean odstranit (drop) databázi před jejím vytvořením
-c, --clean odstranit (drop) databázi před jejím vytvořením
-d, --dbname=CONNSTR specifikace připojení do databáze
-d, --dbname=JMÉNO jméno zdrojové databáze
-d, --dbname=JMÉNO jméno cílové databáze
-e, --exit-on-error ukončit při chybě, implicitně pokračuje
-f, --file=SOUBOR výstupní soubor
-f, --file=SOUBOR výstupní soubor nebo adresář
-f, --file=SOUBOR výstupní soubor (- pro stdout)
-g, --globals-only dump pouze globálních objektů, ne databáze
-h, --host=HOSTNAME host databázového serveru nebo adresář se sockety
-j, --jobs=NUM použij tento počet paralelních jobů pro zálohu
-j, --jobs=NUM použij pro obnovu daný počet paralelních jobů
-l, --database=DBNAME alternativní výchozí databáze
-l, --list zobrazit sumarizovaný obsah (TOC) archivu
-n, --schema=NAME obnovit pouze objekty v tomto schématu
-n, --schema=SCHEMA vytvořit dump pouze specifikovaného schématu
-o, --oids zahrnout OID do dumpu
-p, --port=PORT port databázového serveru
-r, --roles-only dump pouze rolí, ne databází nebo tablespaců
-s, --schema-only dump pouze definic databázových objektů
(tabulek apod.) bez dat
-s, --schema-only obnovit pouze definice objektů, bez dat
-t, --table=JMÉNO obnovit pouze jmenovanou relaci (tabulka, pohled, etc.)
-t, --table=TABULKA provést dump pouze uvedené tabulky
-t, --tablespaces-only dump pouze tablespaců, ne databází nebo rolí
-v, --verbose vypisovat více informací
-v, --verbose vypisovat více informací
-w, --no-password nikdy se neptej na heslo
-x, --no-privileges neprovádět dump přístupových práv (grant/revoke)
-x, --no-privileges přeskočit obnovu přístupových práv (grant/revoke)
%s %s vytvoří dump databáze jako textový soubor nebo v jiném formátu.
%s extrahuje PostgreSQL databázi do souboru s SQL skriptem.
%s obnovuje PostgreSQL databázi z archivu vytvořeného pomocí pg_dump.
%s: %s Příkaz byl: %s
%s: WSAStartup selhal: %d
%s: nelze zadat --single-transaction a několik úloh
%s: nelze navázat spojení s databází "%s"
%s: nelze navázat spojení s databází "%s": %s %s: nelze navázat spojení s databází "postgres" nebo "template1"
Zadejte prosím alternativní databázi.
%s: nelze získat verzi serveru
%s: nelze otevřít výstupní soubor "%s": %s
%s: nelze zpracovat ACL seznam (%s) pro databázi "%s"
%s: nelze zpracovat ACL seznam (%s) pro prostor tabulek "%s"
%s: nelze zpracovat verzi serveru "%s"
%s: nelze otevřít logovací soubor "%s": %s
%s: dumpuji databázi "%s"...
%s: vykonávám %s
%s: neplatný počet paralelních jobů
%s: maximální počet paralelních jobů je %d
%s: volba --if-exists vyžaduje volbu -c/--clean
%s: volby -c/--clean a -a/--data-only nelze používat společně
%s: volby -d/--dbname a -f/--file nelze používat společně
%s: volby -g/--globals-only a -r/--roles-only nelze používat společně
%s: volby -g/--globals-only a -t/--tablespaces-only nelze používat společně
%s: volby -r/--roles-only a -t/--tablespaces-only nelze používat společně
%s: volby -s/--schema-only a -a/--data-only nelze použít najednou
%s: pg_dump selhal při zpracovávání databáze "%s", ukončuji se
%s: dotaz selhal: %s %s: dotaz byl: %s
%s: název role začínající s "pg_" přeskočen (%s)
%s: běží "%s"
%s: příliš mnoho argumentů v příkazové řádce (první je "%s")
%s: neznámý název sekce "%s"
(Příkaz INSERT nemůže nastavovat OID.)
(Systémové katalogy mohou být poškozeny.)
-C a -1 jsou nekompatibilní přepínače
COPY selhal pro tabulku "%s": %s Zvažte použití kompletního (full) dumpu namísto --data-only dumpu pro odstranění tohoto problému.
Dumpování obsahu tabulky "%s" selhalo: PQgetCopyData() selhal.
Dumpuji obsahu tabulky "%s" selhal: PQgetResult() selhal.
Chyba v TOC záznamu %d; %u %u %s %s %s
Chybová zpráva ze serveru: %s Chyba během FINALIZACE:
Chyba během INICIALIZACE:
Chyba během ZPRACOVÁNÍ TOC:
Exportované snapshoty nejsou touto verzí serveru podporovány.
LOCK TABLE selhal pro "%s": %s NOTICE: na této tabulce existuje cyklus cizích klíčů:
NOTICE: mezi těmito tabulkami existuje cyklus cizích klíčů:
NOTICE: mezi těmito tabulkami existuje cyklus cizích klíčů:
Heslo: Oznámení o chybách zasílejte na <pgsql-bugs@postgresql.org>.
Synchronizované snapshoty nejsou na této verzi serveru podporovány.
Pokud nepotřebujete synchronizované snapshoty, použijte přepínač
--no-synchronized-snapshots.
Synchronizované snapshoty nejsou na standby serverech podporovány.
Pokud nepotřebujete synchronizované snapshoty, použijte přepínač
--no-synchronized-snapshots.
TOC položka %s na %s (délka %s, kontrolní součet %d)
Příkaz byl: %s
Program "pg_dump" je potřebný pro %s, ale nebyl nalezen ve stejném
adresáři jako "%s".
Zkontrolujte vaši instalaci.
"%s" našel program "pg_dump",
který ale není stejné verze jako %s.
Zkontrolujte vaši instalaci.
Zkuste "%s --help" pro více informací.
Použití:
VAROVÁNÍ: agregační funkce %s nelze dumpovat korektně pro tuto verzi databáze; ignorováno
VAROVÁNÍ: archiv je komprimován, ale tato instalace nepodporuje kompresi -- data nebudou dostupná
WARNING: archivované položky v nesprávném pořadí sekcí
VAROVÁNÍ: archiv byl vytvořen na stroji s většími celými čísly (integer), některé operace mohou selhat
WARNING: chybná definice transformace, alespoň jedno z trffromsql a trftosql by mělo být nenulové
WARNING: chybná hodnota v položce pg_cast.castfunc nebo pg_cast.castmethod
VAROVÁNÍ: nesmyslná hodnota v položce "pg_cast.castmethod"
VAROVÁNÍ: nesmyslná hodnota v položce pg_transform.trffromsql
VAROVÁNÍ: nesmyslná hodnota v položce pg_transform.trftosql
VAROVÁNÍ: nesmyslná hodnota v "proargmodes" poli
VAROVÁNÍ: nelze najít operátor s OID %s
WARNING: nelze zjistit kam přidat IF EXISTS v příkazu "%s"
VAROVÁNÍ: nelze naparsovat pole "proallargtypes"
VAROVÁNÍ: nelze naparsovat pole "proargmodes"
VAROVÁNÍ: nelze naparsovat pole "proargnames"
VAROVÁNÍ: nelze naparsovat pole "proconfig"
VAROVÁNÍ: nelze naparsovat pole reloptions
WARNING: nelze vyřešit smyčku závislostí mezi těmito položkami:
WARNING: nevím jak nastavit vlastníka pro typ objektu "%s"
VAROVÁNÍ: chyby ignorovány při obnovení: %d
VAROVÁNÍ: ftell neodpovídá očekávané pozici -- použit ftell
VAROVÁNÍ: v hlavičce je neplatné datum vytvoření
WARNING: neplatný typ "%c" access metody "%s"
VAROVÁNÍ: řádka ignorována: %s
VAROVÁNÍ: vlastník agregační funkce "%s" se zdá být neplatný
VAROVÁNÍ: vlastník datového typu "%s" se zdá být neplatný
VAROVÁNÍ: vlastník funkce "%s" se zdá být neplatný
VAROVÁNÍ: vlastník operátoru "%s" se zdá být neplatný
VAROVÁNÍ: vlastník třídy operátorů "%s" se zdá být neplatný
VAROVÁNÍ: vlastník rodiny operátorů "%s" se zdá být neplatný
VAROVÁNÍ: vlastník schématu "%s" se zdá být neplatný
VAROVÁNÍ: vlastník tabulky "%s" se zdá být neplatný
VAROVÁNÍ: požadovaná komprese není v této instalaci dostupná -- archiv bude nekomprimovaný
WARNING: typtype datového typu "%s" se zdá být neplatný
WARNING: neočekávané další výsledky během COPY tabulky "%s"
Bez zadání volby --disable-triggers nebo dočasného vypnutí constraintů zřejmě nebudete schopni tento dump obnovit.
pracovní proces neočekávaně selhal
končím kvůli rozdílnosti verzí serverů
skutečná délka souboru (%s) není stejná jako očekávaná (%s)
alokován AH pro %s, formát %d
spojení s databází již existuje
archivář archivář (db) pokouším se zjistit formát archivu
neplatné dumpId
špatné dumpId tabulky pro TABLE DATA položku
vstupní archivy lze pouze znovu otevřít
nelze duplikovat null pointer (interní chyba)
nelze obnovit z komprimovaného archivu (není nastavena podpora komprese)
potomek skončil s návratovým kódem %d potomek skončil s nerozponaným stavem %d potomek byl ukončen vyjímkou 0x%X potomek byl ukončen signálem %d: %s příkaz není spustitelný příkaz nenalezen compress_io komprese není podporována v "tar" výstupním formátu
úroveň komprese musí být v rozsahu 0..9
compressor aktivní
navazováno spojení s databází pro obnovu
připojuji se k nové databázi "%s"
spojení s databází "%s" selhalo: %s nalezena poškozená tar hlavička v %s (předpokládáno %d, vypočteno %d) pozice souboru %s
nelze změnit adresář na "%s" : %s nelze zavřít TOC soubor: %s
nelze uzavřít archivní soubor: %s
nelze uzavřít kompresní knihovnu: %s
nelze uzavřít kompresní stream: %s
nelze uzavřít datový soubor "%s": %s
nelze zavřít adresář "%s": %s
nelze zavřít výstupní soubor: %s
nelze uzavřít TOC soubor pro large objekty "%s": %s
nelze zavřít výstupní soubor: %s
nelze zavřít tar položku
nelze otevřít dočasný soubor: %s
nelze provést commit transakce nelze komprimovat data: %s
nelze vytvořit komunikační kanály: %s
nelze vytvořit adresář "%s": %s
nelze vytvořit "large object" %u: %s nelze vytvořit worker proces: %s
nelze určit seek pozici v archivním souboru: %s
nelze provést dotaz nelze najít soubor "%s" ke spuštění v archivu nelze najít blok %d -- archiv může být poškozen
v archivu nelze najít blok ID %d -- možná kvůli out-of-order restore požadavku, který nemohl být vyřízen kvůli chybějícím datovým offsetům v archivu
v archivu nelze najít blok ID %d -- možná kvůli out-of-order restore požadavku, který nemohl být vyřízen kvůli non-seekable vstupnímu souboru
nelze najít záznam ID %d
v archivu nelze najít soubor "%s"
nelze najít definici pro funkci ID %u
nelze najít hlavičku pro soubor %s v tar archivu
nelze najít nadřízené rozšíření pro %s %s
nelze najít slot ukončeného workera
nelze vygenerovat jméno dočasného souboru: %s
nelze získat server_version z libpq
nelze získat aktuální adresář: %s nelze identifikovat smyčku závislostí
nelze inicializovat kompresní knihovnu: %s
nelze získat zámek na relaci "%s"
Toto obvykle znamená že někdo si vyžádal ACCESS EXCLUSIVE zámek na tabulce poté co rodičovský pg_dump proces získal výchozí ACCESS SHARE zámek na dané tabulce.
nelze otevřít TOC soubor "%s" pro vstup: %s
nelze otevřít TOC soubor "%s" pro výstup: %s
nelze otevřít TOC soubor "%s": %s
nelze otevřít TOC soubor pro vstup: %s
nelze otevřít TOC soubor pro výstup: %s
nelze otevřít vstupní soubor "%s": %s
nelze otevřít vstupní soubor: %s
nelze otevřít "large object" %u:%s nelze otevřít TOC soubor pro large objekty "%s" pro vstup: %s
nelze otevřít výstupní soubor "%s": %s
nelze otevřít výstupní soubor: %s
nelze otevřít dočasný soubor
nelze zpracovat GRANT ACL seznam (%s) nebo REVOKE ACL seznam (%s) pro objekt "%s" (%s)
nelze zpracovat seznam oprávnění ACL (%s)
nelze zpracovat výchozí GRANT ACL seznam (%s) nebo výchozí REVOKE ACL seznam (%s) pro objekt "%s" (%s)
nemohu zpracovat numerické pole "%s": neplatný znak v čísle
nemohu zpracovat numerické pole "%s": příliš mnoho čísel
nelze zpracovat výsledek current_schemas()
nelze číst binární soubor "%s" nelze načíst adresář "%s": %s
nelze číst vstupní soubor: %s
nelze číst vstupní soubor: end of file
nelze číst vstupní soubor: %s
nelze číst symbolický link "%s" nelze nastavit default_tablespace na %s: %s nelze nastavit default_with_oids: %s nelze nastavit search_path na "%s": %s nelze nastavit seek pozici v archivním souboru: %s
nelze nastavit uživatele session na "%s": %s nelze spustit databázovou transakci nelze dekomprimovat data: %s
nelze zapsat do TOC souboru pro bloby
nelze zapsat "large object" (výsledek = %lu, očekáváno: %lu)
nelze zapsat do výstupního souboru: %s
nelze zapsat do komunikačního kanálu: %s
vytvářím %s "%s"
vytvářím %s "%s.%s"
vlastní archivář definice view "%s" se zdá být prázdná (nulová délka)
nelze najít identifikační řetězec v hlavičce souboru
přímé spojení s databází nejsou podporovány v archivech před verzí 1.3
adresář "%s" zřejmě není platným archivem ("toc.dat" neexistuje)
directory archiver jméno adresáře je příliš dlouhé: "%s"
vypínám triggery pro %s
odstraňuji %s %s
dumpuji obsah tabulky "%s.%s"
zapínám triggery pro %s
vstupuji do hlavní paralelní smyčky
vstupuji do restore_toc_entries_parallel
vstupuji do restore_toc_entries_postfork
vstupuji do restore_toc_entries_prefork
ID záznamu %d je mimo rozsah -- možná je poškozena TOC
chyba během zálohování
chyba během posunu v souboru: %s
chyba při paralelním zpracovávání položky
chyba při čtení large objektu %u: %s chyba při čtení TOC souboru pro large objekty "%s"
chyba vrácená voláním PQputCopyData: %s chyba vrícená voláním PQputCopyEnd: %s vykonávám %s %s
očekáván %d check constraint na tabulce "%s" nalezeno %d
očekávány %d check constrainty na tabulce "%s" nalezeno %d
očekáváno %d check constraintů na tabulce "%s" nalezeno %d
očekávaný formát (%d) se liší se od formátu nalezeného v souboru (%d)
selhala kontrola, rodičovské OID %u tabulky "%s" (OID %u) nelze najít
selhala kontrola, OID %u rodičovské tabulky u pg_rewrite položky OID %u nelze najít
selhala kontrola, OID %u rodičovské tabulky u sekvence s OID %u nelze najít
selhalo spojení s databází
jméno souboru je příliš dlouhé: "%s"
offset souboru v dumpu je příliš velký
hledám CHECK omezení pro tabulku "%s.%s"
hledám DEFAULT výrazy pro tabulku "%s.%s"
hledám tabulky pro rozšíření
hledám informace o dědičnosti
hledám sloupce a typy pro tabulku "%s.%s"
dokončena položka %d %s %s
ukončuji hlavní paralelní smyčku
označuji zděděné sloupce v pod-tabulkách
nalezeno neočekávané ID bloku (%d) při čtení dat - očekáváno %d
funkce "%s" nenalezena
hledám položky rozšíření (extenze)
předpokládána pouze obnova dat
nalezena nekompletní tar hlavička (%lu byte)
nalezena nekompletní tar hlavička (%lu byty)
nalezena nekompletní tar hlavička (%lu bytů)
index "%s" nenalezen
vstupní soubor se zdá být dump v textovém formátu. Použijte prosím psql.
vstupní soubor se nezdá být korektním archivem
vstupní soubor se nezdá být korektním archivem (příliš krátký?)
vstupní soubor je příliš krátký (čteno %lu, očekáváno 5)
interní chyba -- WriteData není možno volat mimo kontext rutiny DataDumper
interní chyba -- ani th ani fh nespecifikován v tarReadRaw()
chybná položka ENCODING: %s
neplatné OID pro "large object"
neplatné OID pro "large object" (%u)
chybná položka STDSTRINGS: %s
neplatná "adnum" hodnota %d pro tabulku "%s"
neplatný řetězec argumentů (%s) pro trigger "%s" tabulky "%s"
neplatný binární soubor"%s" specifikováno neplatné klientské kódování "%s"
neplatné číslo sloupce %d pro tabulku "%s"
neplatné číslování sloupců v tabulce "%s"
neplatný kompresní kód: %d
neplatná závislost %d
neplatné dumpId %d
neplatný řádek v TOC souboru pro large objekty "%s" : "%s"
z pracovního procesu dorazila neplatná zpráva: "%s"
neplatný počet paralelních jobů
specifikován neplatný formát "%s" výstupu
"large object" výstup není podporován ve vybraném formátu
poslední vestavěné OID je %u
spouštím položku %d %s %s
chybí index pro omezení "%s"
přecházím z pozice %s na následujícího položky na pozici souboru %s
žádná položka není připravena
nebyla nalezena žádná odovídající schémata
nebyla nalezena žádná schémata odpovídající vzoru "%s"
nebyla nalezena žádná odpovídající tabulka
nebyla nalezena žádná tabulka odpovídající vzoru "%s"
nezadán žádný výstupní adresář
nezkompilováno s podporou zlib
nyní na pozici souboru %s
volba --if-exists vyžaduje volbu -c/--clean
volby --inserts/--column-inserts a -o/--oids nelze používat společně
volby -c/--clean a -a/--data-only nelze používat společně
volby -s/--schema-only a -a/--data-only nelze používat společně
nedostatek paměti
vyčerpáno on_exit_nicely slotů
paralelní archivář paralelní záloha je podporována pouze directory formátem
paralelní obnova z neseekovatelného souboru není podporována
paralelní obnova ze standardního vstupnu není podporována
paralelní obnova není podporována s archivy z pre-8.0 verzí pg_dump
paralelní obnova není pro tento formát archivu podporována
volání pclose selhalo: %s pgpipe: nelze přijmout spojení: chybový kód %d
pgpipe: nelze provést bind: chybový kód %d
pgpipe: nelze se připojit k soketu: chybový kód %d
pgpipe: nelze vytvořit druhý soket: chybový kód %d
pgpipe: nelze vytvořit soket: chybový kód %d
pgpipe: nelze poslouchat: chybový kód %d
pgpipe: getsockname() selhal: chybový kód %d
zpracovávám %s
zpracovávám data pro tabulku "%s.%s"
zpracovávám položku %d %s %s
zpracování vynechalo položku %d %s %s
dotaz selhal: %s dotaz vrátil prázdné jméno referencované tabulky pro trigger "%s" cizího klíče pro tabulku "%s" (OID tabulky: %u)
dotaz vrátil %d řádku namísto jedné: %s
dotaz vrátil %d řádky namísto jedné: %s
dotaz vrátil %d řádek namísto jedné: %s
dotaz pro načtení dat sekvence "%s" vrátil %d řádek (expected 1)
dotaz pro načtení dat sekvence "%s" vrátil %d řádky (expected 1)
dotaz pro načtení dat sekvence "%s" vrátil %d řádek (expected 1)
dotaz na získání dat sekvence "%s" vrátil jméno "%s"
dotaz k získání pravidla (RULE) "%s" pro tabulku "%s" selhal: vrácen chybný počet řádků
dotaz na získání definice view "%s" vrátil více jak jednu definici
dotaz na získání definice view "%s" nevrátil žádná data
dotaz byl: %s
přečetl jsem TOC záznam %d (ID %d) pro %s %s
čtu informace o sloupci pro tabulky
čtu omezení
čtu implicitní přístupová práva
čtu data o závislostech
čtu event triggery
čtu rozšíření
čtu cizí klíče pro tabulku "%s.%s"
čtu indexy
čtu indexy pro tabulku "%s.%s"
čtu "large objects"
čtu přístupové politiky
čtu policies pro tablku "%s.%s"
čtu procedurální jazyky
čtu přepisovací pravidla
čtu row security enabled pro tabulku "%s.%s"
čtu schémata
čtu informace dědičnosti tabulky
čtu transformace
čtu triggery
čtu triggery pro tabulku "%s.%s"
čtu přetypování
čtu uživatelem definované přístupové metody
čtu uživatelem definované agregátní funkce
čtu uživatelem definované collations
čtu uživatelem definované konverze
čtu uživatelem definované foreign servery
čtu uživatelem definované foreign-data wrappery
čtu uživatelem definované funkce
čtu uživatelem definované třídy operátorů
čtu uživatelem definované rodiny operátorů
čtu uživatelem definované operátory
čtu uživatelem definované tabulky
čtu uživatelské fulltextového konfigurace
čtu uživatelem definované fulltextové slovníky
čtu uživatelem definované fulltextové parsery
čtu uživatelem definované fulltextové šablony
čtu uživatelem definované typy
připojení k databázi "%s" selhalo: %s redukuji závislosti pro %d
obnoven %d large objekt
obnoveny %d large objekty
obnoveny %d large objektů
dump dat mimo pořadí není podporováno v tomto formátu archivu: %s je vyžadován, ale předchází %s.
obnovován "large object" s OID %u
selhala kontrola velikosti integeru (%lu)
ukládám definice databáze
ukládám kódování znaků = %s
ukládám "large objects"
ukládám search_path = %s
ukládám standard_conforming_strings = %s
schéma "%s" nenalezeno
schéma s OID %u neexistuje
select() selhalo: %s
verze serveru musí být alespoň 7.3 pro použití přepínačů prů výběr schématu
verze serveru: %s; %s verze: %s
přeskakuji položku %d %s %s
přeskakován tar člen %s
sorter tabulku "%s" nelze vytvořit, její data nebudou obnovena
tabulka "%s" nenalezena
tar archivář tento formát nelze číst
přenáším závislost %d -> %d to %d
trigger "%s" nenalezen
neočekávaná syntaxe příkazu COPY: "%s"
neočekávaný příznak datového offsetu %d
neočekáváný typ policy příkazu: "%s"
neočekávaný kód sekce %d
neočekávaná hodnota tgtype: %d
neznámý formát archivu "%s"; zadejte prosím "c", "d" nebo "t"
nerozpoznaný příkaz obdržen od mastera: %s
neočekávaný typ omezení: %c
nepřípustný typ datového bloku %d během obnovení archivu
nepřípustný typ datového bloku (%d) během prohledávání archivu
neplatné kódování "%s"
neznámý formát souboru "%d"
neznámý typ objektu (%d) ve výchozích privilegiích
nerozpoznaná proparallel" hodnota pro funkci "%s"
nerozpoznaná "provolatile" hodnota pro funkci "%s"
nepodporovaná verze (%d.%d) v hlavičce souboru
varování z originálního dump souboru: %s
worker proces selhal: exit kód %d
zapsán %lu byte dat large objektů (result = %lu)
zapsán %lu byty dat large objektů (result = %lu)
zapsán %lu bytů dat large objektů (result = %lu)
locale/cs/LC_MESSAGES/pg_config-9.6.mo 0000644 00000014103 14751153421 0013001 0 ustar 00 �� * l ; � � E � 0 � : 3 E n I � L � s K K � = B I i � G � J > M � M � ? % G e > � 6 � < # > ` F � P � I 7
4 �
2 �
* �
. , 8 & e � & � � ( � ! B V c � u < A : ~ � D � L P c S � ~ R � D � H u h Q � Q 0 T � T � 5 , N b H � P � O K P � L � a 9 b � 1 � < 0 . m � � A � ) 3 $ ? ' d & � " � " � � ' % * ) $
" '
& ( ! #
%s provides information about the installed version of PostgreSQL.
With no arguments, all known items are shown.
%s [OPTION]...
--bindir show location of user executables
--cc show CC value used when PostgreSQL was built
--cflags show CFLAGS value used when PostgreSQL was built
--cflags_sl show CFLAGS_SL value used when PostgreSQL was built
--configure show options given to "configure" script when
PostgreSQL was built
--cppflags show CPPFLAGS value used when PostgreSQL was built
--docdir show location of documentation files
--htmldir show location of HTML documentation files
--includedir show location of C header files of the client
interfaces
--includedir-server show location of C header files for the server
--ldflags show LDFLAGS value used when PostgreSQL was built
--ldflags_ex show LDFLAGS_EX value used when PostgreSQL was built
--ldflags_sl show LDFLAGS_SL value used when PostgreSQL was built
--libdir show location of object code libraries
--libs show LIBS value used when PostgreSQL was built
--localedir show location of locale support files
--mandir show location of manual pages
--pgxs show location of extension makefile
--pkgincludedir show location of other C header files
--pkglibdir show location of dynamically loadable modules
--sharedir show location of architecture-independent support files
--sysconfdir show location of system-wide configuration files
--version show the PostgreSQL version
-?, --help show this help, then exit
%s: could not find own program executable
%s: invalid argument: %s
Options:
Report bugs to <pgsql-bugs@postgresql.org>.
Try "%s --help" for more information.
Usage:
could not change directory to "%s": %s could not find a "%s" to execute could not identify current directory: %s could not read binary "%s" could not read symbolic link "%s" invalid binary "%s" not recorded pclose failed: %s Project-Id-Version: pg_config-cs (PostgreSQL 9.3)
Report-Msgid-Bugs-To: pgsql-bugs@postgresql.org
POT-Creation-Date: 2018-07-13 16:03+0000
PO-Revision-Date: 2018-07-14 01:09+0200
Last-Translator: Tomas Vondra <tv@fuzzy.cz>
Language-Team: Czech <info@cspug.cx>
Language: cs
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Plural-Forms: nplurals=3; plural=(n==1) ? 0 : (n>=2 && n<=4) ? 1 : 2;
X-Generator: Poedit 2.0.7
%s poskytuje informace o nainstalované verzi PostgreSQL.
Bez argumentů jsou vypsány všechny známé položky.
%s [PŘEPÍNAČ]...
--bindir ukáže umístění spustitelných souborů
--cc ukáže hodnotu CC použitou při buildu PostgreSQL
--cflags ukáže hodnotu CFLAGS použitou při buildu PostgreSQL
--cflags_sl ukáže hodnotu CFLAGS_SL použitou při buildu PostgreSQL
--configure ukáže přepínače použité pro "configure" skript ke
kompilaci PostgreSQL
--cppflags ukáže hodnotu CPPFLAGS použitou při buildu PostgreSQL
--docdir ukáže umístění souborů s dokumentací
--htmldir ukáže umístění souborl s HTML dokumentací
--includedir ukáže umístění C hlavičkových souborů klientských
rozhraní
--includedir-server ukáže umístění C hlavičkových souborů pro server
--ldflags ukáže hodnotu LDFLAGS použitou při buildu PostgreSQL
--ldflags_ex ukáže hodnotu LDFLAGS_EX použitou při buildu PostgreSQL
--ldflags_sl ukáže hodnotu LDFLAGS_SL použitou při buildu PostgreSQL
--libdir ukáže umístění knihoven
--libs ukáže hodnotu LIBS použitou při buildu PostgreSQL
--localedir ukáže umístění souborů pro podporu locale
--mandir ukáže umístění souborů s manuálovými stránkami
--pgxs ukáže umístění makefile souboru pro rozšíření
--pkgincludedir ukáže umístění dalších C hlavičkových souborů
--pkglibdir ukáže umístění dynamicky zaváděných modulů
--sharedir ukáže umístění podpůrných souborů nezávislých na architektuře
--sysconfdir ukáže umístění konfiguračních souborů platných pro celý systém
--version ukáže verzi PostgreSQL
-?, --help ukáže tuto nápovědu, a skončí
%s: nelze najít vlastní spustitelný soubor
%s: neplatný parametr: %s
Přepínače:
Oznámení o chybách zasílejte na <pgsql-bugs@postgresql.org>.
Zkuste "%s --help" pro více informací.
Použití:
nelze změnit adresář na "%s" : %s nelze najít soubor "%s" ke spuštění nelze získat aktuální adresář: %s nelze číst binární soubor "%s" nelze číst symbolický link "%s" neplatný binární soubor"%s" nezaznamenáno volání pclose selhalo: %s locale/cs/LC_MESSAGES/pg_basebackup-9.6.mo 0000644 00000067671 14751153421 0013656 0 ustar 00 �� � � ,
� � � � � ! �
- X C T � R � ` D I � D � 4 3 F K z < � j > n N � @ � 3 = Y q > � 1
j < < � ? � M $ k r J � Y ) + � 0 � B � B # * f 8 � � � 5 Y � � r o � 1 � 3 , K ` - � F � \ ! P ~ 2 � 4 8 7 1 p 4 � 1 � . @ 8 1 y E � B � 7 4! l! �! ( �! ' �! & �! ; " ( Z" # �" - �" ' �" " �" # # A# 2 e# , �# + �# . �# ( $ # I$ 5 m$ f �$ ,
% 9 7% 4 q% 7 �% = �% d & A �& " �& & �& &
' # 4' / X' > �' a �' & )( & P( % w( 2 �( 1 �( 0 ) 8 3) ( l) 2 �) �) & �) ' * . 8* + g* # �* A �* 2 �* & ,+ & S+ / z+ + �+ 4 �+ / , ! ;, 1 ], ) �, ( �, 2 �, 2 - 3 H- 0 |- % �- # �- + �- #. @. 2 R. # �. �. , �. , �. # / i D/ i �/ ? 0 9 X0 " �0 A �0 # �0 1 9 <1 v1 �1 ! �1 D �1 & 2 # 92 A ]2 - �2 D �2 ! 3 43 O3 " f3 �3 9 �3 1 �3 D 4 , X4 �4 ' �4 D �4 M 5 : S5 8 �5 6 �5 �5 E 6 G ]6 z �6 c 7 % �7 . �7 2 �7 6 8 # C8 g8 % �8 0 �8 R �8 , *9 4 W9 K �9 @ �9 > : - X: , �: ' �: , �: o ; k x; 4 �; % < ( ?< ; h<
�< & �< �< / �< = / = � M= ? ;? M? ^? r? �? 5 �? Y �? S 3@ W �@ ` �@ P @A F �A �A > �A S (B ; |B | �B E 5C M {C M �C 8 D Z PD @ �D : �D l 'E J �E A �E N !F i pF K �F ^ &G + �G : �G E �G O 2H 2 �H L �H � I 5 �I � �I lJ | �J 9 iK 2 �K O �K 0 &L j WL � �L w LM : �M 9 �M ; 9N 4 uN @ �N = �N + )O @ UO 8 �O J �O B P : ]P �P ( �P / �P -
Q / 8Q < hQ - �Q # �Q 2 �Q ' *R $ RR ! wR $ �R 8 �R + �R + #S 2 OS ( �S $ �S 5 �S u T . |T 9 �T 9 �T 4 U @ TU u �U < V * HV . sV & �V ' �V > �V E 0W u vW ' �W ' X . <X 9 kX 6 �X 6 �X = Y . QY B �Y �Y & �Y # Z ( -Z / VZ ' �Z J �Z 5 �Z ( /[ . X[ / �[ , �[ ? �[ < $\ ) a\ < �\ 5 �\ 6 �\ 0 5] 2 f] : �] 5 �] %
^ ' 0^ 1 X^ , �^ �^ 3 �^ ' �^ $ "_ - G_ 4 u_ % �_ p �_ m A` A �` A �` ( 3a F \a # �a " �a A �a ! ,b Nb . gb K �b / �b * c A =c - c S �c - d # /d Sd $ qd ! �d M �d 9 e T @e / �e �e / �e Q
f ` _f ? �f I g ? Jg �g R �g S �g � Jh h �h % Ai 5 gi 9 �i 9 �i - j " ?j % bj 5 �j V �j % k G ;k = �k A �k I l A Ml 4 �l - �l 7 �l � *m z �m 8 *n ) cn * �n A �n �n ) o ,o / 8o ho < |o 8 � � � t � v � 3 . F d M 7 � 1 j � � A � J ` � � O � r � � � � ^ N c " L - � + � u � � � x � � [ g � , p U T X � b $ h P Y e Z � � i � � � \ � < � � : � � K � a G � > ; ) ! � s � � 4 C � � � � � � ( k D w H � ' � � S ] � | f _ q = � � ? � � 9 6 � � 0 % 2
o � Q � � � � { �
R � m � z � � � E I ~ � / n � l � 5 @ V B � � � � � � y � � � � � } & # * W �
Action to be performed:
Connection options:
General options:
Optional actions:
Options controlling the output:
Options:
Report bugs to <pgsql-bugs@postgresql.org>.
--create-slot create a new replication slot (for the slot's name see --slot)
--drop-slot drop the replication slot (for the slot's name see --slot)
--if-not-exists do not error if slot already exists when creating a slot
--start start streaming in a replication slot (for the slot's name see --slot)
--synchronous flush transaction log immediately after writing
--xlogdir=XLOGDIR location for the transaction log directory
%s [OPTION]...
-?, --help show this help, then exit
-D, --directory=DIR receive transaction log files into this directory
-D, --pgdata=DIRECTORY receive base backup into directory
-F --fsync-interval=SECS
time between fsyncs to the output file (default: %d)
-F, --format=p|t output format (plain (default), tar)
-I, --startpos=LSN where in an existing slot should the streaming start
-P, --plugin=PLUGIN use output plugin PLUGIN (default: %s)
-P, --progress show progress information
-R, --write-recovery-conf
write recovery.conf for replication
-S, --slot=SLOTNAME name of the logical replication slot
-S, --slot=SLOTNAME replication slot to use
-T, --tablespace-mapping=OLDDIR=NEWDIR
relocate tablespace in OLDDIR to NEWDIR
-U, --username=NAME connect as specified database user
-V, --version output version information, then exit
-W, --password force password prompt (should happen automatically)
-X, --xlog-method=fetch|stream
include required WAL files with specified method
-Z, --compress=0-9 compress tar output with given compression level
-c, --checkpoint=fast|spread
set fast or spread checkpointing
-d, --dbname=CONNSTR connection string
-d, --dbname=DBNAME database to connect to
-f, --file=FILE receive log into this file, - for stdout
-h, --host=HOSTNAME database server host or socket directory
-l, --label=LABEL set backup label
-n, --no-loop do not loop on connection lost
-o, --option=NAME[=VALUE]
pass option NAME with optional value VALUE to the
output plugin
-p, --port=PORT database server port number
-r, --max-rate=RATE maximum transfer rate to transfer data directory
(in kB/s, or use suffix "k" or "M")
-s, --status-interval=INTERVAL
time between status packets sent to server (in seconds)
-s, --status-interval=SECS
time between status packets sent to server (default: %d)
-v, --verbose output verbose messages
-w, --no-password never prompt for password
-x, --xlog include required WAL files in backup (fetch mode)
-z, --gzip compress tar output
%*s/%s kB (%d%%), %d/%d tablespace %*s/%s kB (%d%%), %d/%d tablespaces %*s/%s kB (%d%%), %d/%d tablespace (%s%-*.*s) %*s/%s kB (%d%%), %d/%d tablespaces (%s%-*.*s) %*s/%s kB (100%%), %d/%d tablespace %*s %*s/%s kB (100%%), %d/%d tablespaces %*s %s controls PostgreSQL logical decoding streams.
%s receives PostgreSQL streaming transaction logs.
%s takes a base backup of a running PostgreSQL server.
%s: %s needs a slot to be specified using --slot
%s: COPY stream ended before last file was finished
%s: WAL streaming can only be used in plain mode
%s: at least one action needs to be specified
%s: can only write single tablespace to stdout, database has %d
%s: cannot specify both --xlog and --xlog-method
%s: cannot use --create-slot or --drop-slot together with --startpos
%s: cannot use --create-slot or --start together with --drop-slot
%s: cannot use --create-slot together with --drop-slot
%s: checkpoint completed
%s: child %d died, expected %d
%s: child process did not exit normally
%s: child process exited with error %d
%s: child thread exited with error %u
%s: confirming write up to %X/%X, flush to %X/%X (slot %s)
%s: could not access directory "%s": %s
%s: could not clear search_path: %s %s: could not close compressed file "%s": %s
%s: could not close directory "%s": %s
%s: could not close file "%s": %s
%s: could not connect to server
%s: could not connect to server: %s %s: could not create archive status file "%s": %s
%s: could not create background process: %s
%s: could not create background thread: %s
%s: could not create compressed file "%s": %s
%s: could not create directory "%s": %s
%s: could not create file "%s": %s
%s: could not create pipe for background process: %s
%s: could not create replication slot "%s": got %d rows and %d fields, expected %d rows and %d fields
%s: could not create symbolic link "%s": %s
%s: could not create symbolic link from "%s" to "%s": %s
%s: could not create timeline history file "%s": %s
%s: could not determine seek position in file "%s": %s
%s: could not determine server setting for integer_datetimes
%s: could not drop replication slot "%s": got %d rows and %d fields, expected %d rows and %d fields
%s: could not establish database-specific replication connection
%s: could not fsync file "%s": %s
%s: could not fsync log file "%s": %s
%s: could not get COPY data stream: %s %s: could not get backup header: %s %s: could not get child thread exit status: %s
%s: could not get transaction log end position from server: %s %s: could not identify system: got %d rows and %d fields, expected %d rows and %d or more fields
%s: could not initiate base backup: %s %s: could not open directory "%s": %s
%s: could not open log file "%s": %s
%s: could not open timeline history file "%s": %s
%s: could not open transaction log file "%s": %s
%s: could not pad transaction log file "%s": %s
%s: could not parse next timeline's starting point "%s"
%s: could not parse start position "%s"
%s: could not parse transaction log location "%s"
%s: could not read COPY data: %s %s: could not read directory "%s": %s
%s: could not read from ready pipe: %s
%s: could not receive data from WAL stream: %s %s: could not rename file "%s" to "%s": %s
%s: could not rename file "%s": %s
%s: could not seek to beginning of transaction log file "%s": %s
%s: could not send command to background pipe: %s
%s: could not send copy-end packet: %s %s: could not send feedback packet: %s %s: could not send replication command "%s": %s %s: could not set compression level %d: %s
%s: could not set permissions on directory "%s": %s
%s: could not set permissions on file "%s": %s
%s: could not stat file "%s": %s
%s: could not stat transaction log file "%s": %s
%s: could not wait for child process: %s
%s: could not wait for child thread: %s
%s: could not write %u bytes to WAL file "%s": %s
%s: could not write %u bytes to log file "%s": %s
%s: could not write timeline history file "%s": %s
%s: could not write to compressed file "%s": %s
%s: could not write to file "%s": %s
%s: creating replication slot "%s"
%s: directory "%s" exists but is not empty
%s: directory name too long
%s: disconnected
%s: disconnected; waiting %d seconds to try again
%s: dropping replication slot "%s"
%s: final receive failed: %s %s: finished segment at %X/%X (timeline %u)
%s: got WAL data offset %08x, expected %08x
%s: incompatible server version %s
%s: incompatible server version %s; client does not support streaming from server versions newer than %s
%s: incompatible server version %s; client does not support streaming from server versions older than %s
%s: initiating base backup, waiting for checkpoint to complete
%s: integer_datetimes compile flag does not match server
%s: invalid --max-rate unit: "%s"
%s: invalid checkpoint argument "%s", must be "fast" or "spread"
%s: invalid compression level "%s"
%s: invalid fsync interval "%s"
%s: invalid output format "%s", must be "plain" or "tar"
%s: invalid port number "%s"
%s: invalid socket: %s %s: invalid status interval "%s"
%s: invalid tablespace mapping format "%s", must be "OLDDIR=NEWDIR"
%s: invalid tar block header size: %d
%s: invalid transfer rate "%s": %s
%s: invalid xlog-method option "%s", must be "fetch" or "stream"
%s: multiple "=" signs in tablespace mapping
%s: new directory is not an absolute path in tablespace mapping: %s
%s: no data returned from server
%s: no database specified
%s: no slot specified
%s: no target directory specified
%s: no target file specified
%s: no transaction log end position returned from server
%s: not renaming "%s%s", segment is not complete
%s: old directory is not an absolute path in tablespace mapping: %s
%s: only tar mode backups can be compressed
%s: out of memory
%s: received interrupt signal, exiting
%s: received transaction log record for offset %u with no file open
%s: replication connection using slot "%s" is unexpectedly database specific
%s: replication slots can only be used with WAL streaming
%s: replication stream was terminated before stop point
%s: segment file "%s" has incorrect size %d, skipping
%s: select() failed: %s
%s: server reported unexpected history file name for timeline %u: %s
%s: server reported unexpected next timeline %u, following timeline %u
%s: server returned unexpected response to BASE_BACKUP command; got %d rows and %d fields, expected %d rows and %d fields
%s: server stopped streaming timeline %u at %X/%X, but reported next timeline %u to begin at %X/%X
%s: starting background WAL receiver
%s: starting log streaming at %X/%X (slot %s)
%s: starting log streaming at %X/%X (timeline %u)
%s: starting timeline %u is not present in the server
%s: streaming header too small: %d
%s: streaming initiated
%s: switched to timeline %u at %X/%X
%s: symlinks are not supported on this platform
%s: system identifier does not match between base backup and streaming connection
%s: this build does not support compression
%s: too many command-line arguments (first is "%s")
%s: transaction log directory location can only be specified in plain mode
%s: transaction log directory location must be an absolute path
%s: transaction log file "%s" has %d bytes, should be 0 or %d
%s: transfer rate "%s" exceeds integer range
%s: transfer rate "%s" is not a valid value
%s: transfer rate "%s" is out of range
%s: transfer rate must be greater than zero
%s: unexpected response to TIMELINE_HISTORY command: got %d rows and %d fields, expected %d rows and %d fields
%s: unexpected result set after end-of-timeline: got %d rows and %d fields, expected %d rows and %d fields
%s: unexpected termination of replication stream: %s %s: unrecognized link indicator "%c"
%s: unrecognized streaming header: "%c"
%s: waiting for background process to finish streaming ...
Password: Try "%s --help" for more information.
Usage:
cannot duplicate null pointer (internal error)
out of memory
transaction log start point: %s on timeline %u
Project-Id-Version: pg_basebackup-cs (PostgreSQL 9.3)
Report-Msgid-Bugs-To: pgsql-bugs@postgresql.org
POT-Creation-Date: 2018-07-13 16:03+0000
PO-Revision-Date: 2018-07-14 01:09+0200
Last-Translator: Tomas Vondra <tv@fuzzy.cz>
Language-Team: Czech <info@cspug.cx>
Language: cs
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Plural-Forms: nplurals=3; plural=(n==1) ? 0 : (n>=2 && n<=4) ? 1 : 2;
X-Generator: Poedit 2.0.7
Akce která se má vykonat:
Volby spojení:
Obecné volby:
Nepovinné volby:
Volby ovlivňující výstup:
Obecné volby:
Chyby hlaste na adresu <pgsql-bugs@postgresql.org>.
--create-slot vytvoří nový replikační slot (pro jméno slotu viz --slot)
--drop-slot odstraní replikační slot (pro jméno slotu viz --slot)
--if-not-exists vytváření slotu neskončí chybou pokud slot již existuje
--start start streaming in a replication slot (for the slot's name see --slot)
--synchronous vynutí flush write-ahead logu okamžitě po zapsání
--xlogdir=XLOGDIR umístění adresáře s transakčním logem
%s [VOLBA]...
-?, --help ukaž tuto nápovědu, potom skonči
-D, --directory=DIR soubory transakčního logu ukládej do tohoto adresáře
-D, --pgdata=ADRESÁŘ ulož base backup do adresáře
-F --fsync-interval=SECS
interval mezi voláním fsync na výstupním souboru (implicitně: %d)
-F, --format=p|t výstupní formát (plain (výchozí), tar)
-I, --startpos=LSN kde v existujícím slotu má začít streamování
-P, --plugin=PLUGIN použije výstupní plugin PLUGIN (implicitně: %s)
-P, --progress zobrazuj informace o průběhu
-R, --write-recovery-conf
zapíše recovery.conf pro replikaci
-S, --slot=SLOTNAME jméno logického replikačního slotu
-S, --slot=SLOTNAME použít tento replikační slot
-T, --tablespace-mapping=OLDDIR=NEWDIR
přemístit tablespace z OLDDIR do NEWDIR
-U, --username=JMÉNO připoj se jako uvedený databázový uživatel
-V, --version vypiš informace o verzi, potom skonči
-W, --password vynuť dotaz na heslo (mělo by se dít automaticky)
-X, --xlog-method=fetch|stream
zahrne potřebné WAL soubory zvolenou metodou
-Z, --compress=0-9 komprimuj výstup taru zvolenou úrovní komprese
-c, --checkpoint=fast|spread
nastav fast nebo spread checkpointing
-d, --dbname=CONNSTR connection string
-d, --dbname=DBNAME databáze ke které se připojit
-f, --file=FILE log zapisuj do tohoto souboru, - pro stdout
-h, --host=HOSTNAME host databázového serveru nebo adresář se sockety
-l, --label=NÁZEV nastav jmenovku zálohy
-n, --no-loop neopakovat pokus o spojení v případě selhání
-o, --option=JMÉNO[=HODNOTA]
předá volbu JMÉNO s nepovinnou hodnotou HODNOTA
výstupnímu pluginu
-p, --port=PORT port databázového serveru
-r, --max-rate=RATE maximální rychlost pro přenos datového adresáře
(v kB/s, nebo použijte příponu "k" nebo "M")
-s, --status-interval=INTERVAL
čas mezi zasíláním packetů se stavem na server (ve vteřinách)
-s, --status-interval=SECS
čas mezi zasíláním packetů se stavem na server (implicitně: %d)
-v, --verbose zobrazuj podrobnější zprávy
-w, --no-password nikdy se neptej na heslo
-x, --xlog zahrne potřebné WAL soubory do zálohy (fetch mód)
-z, --gzip komprimuj výstup taru
%*s/%s kB (%d%%), %d/%d tablespace %*s/%s kB (%d%%), %d/%d tablespaces %*s/%s kB (%d%%), %d/%d tablespaces %*s/%s kB (%d%%), %d/%d tablespace (%s%-*.*s) %*s/%s kB (%d%%), %d/%d tablespace (%s%-*.*s) %*s/%s kB (%d%%), %d/%d tablespace (%s%-*.*s) %*s/%s kB (100%%), %d/%d tablespace %*s %*s/%s kB (100%%), %d/%d tablespacy %*s %*s/%s kB (100%%), %d/%d tablespacy %*s %s ovládá streamy PostgreSQL logického dekódování.
%s přijímá PostgreSQL streamované transakční logy
%s vytvoří base backup běžícího PostgreSQL serveru.
%s: %s vyžaduje aby byl zadán slot pomocí --slot
%s: COPY stream skončil před dokončením posledního souboru
%s: umístění WAL adresáře lze zadat pouze v plain módu
%s: alespoň jedna akce musí být zadána
%s: na stdout lze zapsat jen jeden tablespace, databáze má %d
%s: volby --xlog a --xlog-method nelze zadat společně
%s: nelze použít --create-slot nebo --drop-slot společně s --startpos
%s: nelze použít use-slot nebo --start společně s --drop-slot
%s: nelze použít --create-slot společně s --drop-slot
%s: checkpoint dokonče
%s: potomek %d zemřel, očekáváno %d
%s: podřízený proces neskončil standardně
%s: podřízený proces skončil s chybou %d
%s: podřízené vlákno skončilo s chybou %u
%s: potvrzuji zápis až do %X/%X, flush do %X/%X (slot %s)
%s: nelze přístoupit k adresáři "%s": %s
%s: nelze vyčistit search_path: %s %s: nelze uzavřít komprimovaný soubor "%s": %s
%s: nelze uzavřít adresář "%s": %s
%s: nelze uzavřít soubor "%s": %s
%s: nelze se připojit k serveru
%s: nelze se připojit k serveru: %s %s: nelze vytvořit soubor se stavem archivace "%s": %s
%s: nelze vytvořit background procesy: %s
%s: nelze vytvořit background vlákno: %s
%s: nelze vytvořit komprimovaný soubor "%s": %s
%s: nelze vytvořít adresář "%s": %s
%s: nelze vytvořit soubor "%s": %s
%s: nelze vytvořit roury pro background procesy: %s
%s: nelze vytvořit replikační slot "%s": načteno %d řádek a %d položek, očekáváno %d řádek a %d položek
%s: nelze vytvořit symbolický link "%s": %s
%s: nelze vytvořit symbolický odkaz z "%s" na "%s": %s
%s: nelze vytvořit soubor s timeline historií "%s": %s
%s: nelze určit pozici pro seek v souboru "%s": %s
%s: nelze zjistit nastavení volby integer_datetimes na serveru
%s: nelze odstranit replikační slot "%s": načteno %d řádek a %d položek, očekáváno %d řádek a %d položek
%s: nelze otevřít database-specific replikační spojení
%s: nelze provést fsync souboru "%s": %s
%s: nelze provést fsync log souboru "%s": %s
%s: nelze získat COPY data stream: %s %s: nelze získat hlavičku zálohy: %s %s: nelze získat návratový kód podřízeného vlákna: %s
%s: ze serveru nelze získat koncovou pozici v transakčním logu: %s %s: nelze identifikovat systém, načteno %d řádek a %d položek, očekáváno %d řádek a %d nebo více položek
%s: nelze inicializovat base backup: %s %s: nelze otevřít adresář "%s": %s
%s: nelze otevřít logovací soubor "%s": %s
%s: nelze otevřít soubor s historií timeline "%s": %s
%s: nelze doplnit soubor transakčního logu "%s": %s
%s: nelze doplnit soubor transakčního logu "%s": %s
%s: nelze naparsovat počáteční bod další timeline "%s"
%s: nelze zpracovat počáteční pozici "%s"
%s: nelze naparsovat umístění souboru transakčního logu "%s"
%s: nelze číst COPY data: %s %s: nelze načíst adresář "%s": %s
%s: nelze číst z ready roury: %s
%s: nelze získat data z WAL streamu: %s %s: nelze přejmenovat soubor "%s" na "%s": %s
%s: nelze přejmenovat soubor "%s": %s
%s: nelze skočit zpět na začátek souboru transakčního logu "%s": %s
%s: nelze zaslat příkaz přes background rouru: %s
%s: nelze zaslat ukončovací packet: %s %s: nelze zaslat packet se zpětnou vazbou: %s %s: nelze zaslat replikační příkaz "%s": %s %s: nelze nastavit úroveň komprese %d: %s
%s: nelze nastavit přístupová práva na adresáři "%s": %s
%s: nelze nastavit přístupová práva na souboru "%s": %s
%s: nelze načíst stav souboru "%s": %s
%s: nelze udělat stat souboru transakčního logu "%s": %s
%s: nelze počkat na podřízený (child) proces: %s
%s: nelze počkat na podřízené (child) vlákno: %s
%s: nelze zapsat %u bytů do WAL souboru %s: %s
%s: nelze zapsat %u bytů do log souboru "%s": %s
%s: nelze zapsat do souboru s timeline historií "%s": %s
%s: nelze zapsat do komprimovaného souboru "%s": %s
%s: nelze zapsat do souboru "%s": %s
%s: vytvářím replikační slot "%s"
%s: adresář "%s" existuje, ale není prázdný
%s: jméno adresáře je příliš dlouhé
%s: odpojeno.
%s: odpojeno; čekám %d vteřin pro další pokus
%s: odstraňuji replikační slot "%s"
%s: závěrečný receive selhal: %s %s: dokončen segment na %X/%X (timeline %u)
%s: získán WAL data offset %08x, očekáván %08x
%s: nekompatibilní verze serveru %s
%s: nekompatibilní verze serveru %s; klient nepodporuje streamování ze serverů s verzí novější než %s
%s: nekompatibilní verze serveru %s; klient nepodporuje streamování ze serverů s verzí starší než %s
%s: inicializuji base backup, čekám na dokončení checkpointu
%s: integer_datetimes přepínač kompilace neodpovídá serveru
%s: neplatná --max-rate jednotka: "%s"
%s: chybný checkpoint argument "%s", musí být "fast" nebo "spread"
%s: chybná úroveň komprese "%s"
%s: neplatný fsync interval "%s"
%s: chybný formát výstupu "%s", musí být "plain" nebo "tar"
%s: neplatné číslo portu "%s"
%s: neplatný socket: %s %s: neplatný interval zasílání stavu "%s"
%s: chybný formát tablespace mapování "%s", musí být "OLDDIR=NEWDIR"
%s: neplatná velikost hlavičky tar bloku: %d
%s: chybná přenosová rychlost "%s": %s
%s: neplatná xlog-metoda "%s", musí být "fetch" nebo "stream"
%s: více "=" znaků v tablespace mapování
%s: nový adresář v tablespace mapování není zadán jako absolutní cesta: %s
%s: ze serveru nebyla vrácena žádná data
%s: není specifikována databáze
%s: slot není specifikován
%s: nebyl zadán cílový adresář
%s: nebyl zadán cílový soubor
%s: ze serveru nebyla vrácena žádná koncová pozice v transakčním logu
%s: nepřejmenovávám "%s%s", segment není kompletní.
%s: starý adresář v tablespace mapování není zadán jako absolutní cesta: %s
%s: pouze tar zálohy mohou být komprimované
%s: nedostatek paměti
%s: přijat signál k přerušení, ukončuji.
%s: přijat záznam z transakčního logu pro offset %u bez otevřeného souboru
%s: replikační spojení používající slot "%s" je neočekávaně specifické pro databázi
%s: replikační sloty lze použít pouze s WAL streamováním
%s: replikační stream byl ukončen před bodem zastavení (stop point)
%s: segment soubor "%s" má neplatnou velikost %d, přeskakuji
%s: select() selhal: %s
%s: server ohlásil neočekávané jméno souboru s historií pro timeline %u: %s
%s: server ohlásil neočekávanou další timeline %u, následující timeline %u
%s: server vrátil neočekávanou odpověď na BASE_BACKUP příkaz; přišlo %d řádeka %d položek, ořekáváno %d řádek a %d položek
%s: server přestal streamovat timeline %u at %X/%X, ale začátek další timelineoznámil %u na %X/%X
%s: starting background WAL receiver
%s: začínám streamování logu na %X/%X (slot %s)
%s: začínám streamování logu na %X/%X (timeline %u)
%s: počáteční timeline %u není přitomna na serveru
%s: hlavička streamu je příliš malá: %d
%s: streamování inicializováno
%s: přepnuto na timeline %u v %X/%X
%s: symlinks nejsou na této platformě podporovány
%s: identifikátor systému mezi base backupem a streamovacím spojením neodpovídá
%s: tento build nepodporuje kompresi
%s: příliš mnoho argumentů v příkazové řádce (první je "%s")
%s: umístění WAL adresáře lze zadat pouze v plain módu
%s: cesta k adresáři transakčního logu musí být absolutní
%s: soubor transakčního logu "%s" má %d bytů, měl by mít 0 nebo %d
%s: přenosová rychlost "%s" přečkračuje rozsah typu integer
%s: přenosová rychlost "%s" není platná hodnota
%s: přenosová rychlost "%s" je mimo rozsah
%s: přenosová rychlost musí být větší než nula
%s: neočekávaná odpověď na TIMELINE_HISTORY příkaz: načteno %d řádek a %d položek, očekáváno %d řádek a %d položek
%s: neočekávaný výsledek po konci timeline: získáno %d řádek a %d položek, očekáváno %d řádek a %d položek
%s: neočekávané ukončení replikačního streamu: %s %s: nerozpoznaný indikátor odkazu "%c"
%s: nerozpoznaná hlavička streamu: "%c"
%s: čekám na background proces pro ukočení streamování ...
Heslo: Zkuste "%s --help" pro více informací.
Použití:
nelze duplikovat null pointer (interní chyba)
nedostatek paměti
počáteční pozice we write-ahead logu: %s na timeline %u
locale/cs/LC_MESSAGES/psql-9.6.mo 0000644 00000275761 14751153421 0012050 0 ustar 00 �� 8 �! � �C 8Z 9Z OZ cZ � |Z $[ @[
Y[ g[ > x[ = �[ < �[ p 2\ s �\ 5 ] 7 M] K �] o �] 2 A^ 4 t^ N �^ t �^ Q m_ O �_ > ` A N` O �` @ �` 6 !a 0 Xa N �a G �a 8 b A Yb T �b ? �b L 0c A }c @ �c H d A Id + �d � �d 5 Me 9 �e n �e Q ,f : ~f � �f ; Fg y �g � �g ; �h z �h T Oi A �i L �i B 3j \ vj 4 �j J k \ Sk 6 �k 4 �k G l = dl ; �l ( �l ; m ; Cm ; m ; �m 8 �m _ 0n J �n F �n ` "o h �o G �o 5 4p 2 jp X �p Q �p : Hq 3 �q ; �q S �q M Gr 9 �r @ �r 8 s ; Is @ �s K �s J t | ]t � �t > `u F �u N �u F 5v H |v - �v $ �v & w - ?w 9 mw 7 �w 2 �w 4 x 3 Gx ) {x ) �x ; �x B y ) Ny * xy * �y J �y 1 z . Kz - zz , �z 4 �z I
{ $ T{ & y{ > �{ 1 �{ & | ( 8| J a| : �| ( �| % } $ 6} $ [} ) �} - �} N �} 9 '~ G a~ 5 �~ M �~ C - P q K � N � K ]� L �� 4 �� K +� ( w� q �� A � ? T� A �� > ւ � � # Ą F � 8 /� < h� M �� ; � 6 /� 2 f� 7 �� B ц : � 4 O� 9 �� ? �� % �� + $� 9 P� 5 �� I �� K
� M V� Z �� S �� K S� � �� N *� @ y� : �� ( �� B � L a� C �� � � M �� = � � -� ˎ � �� � � � -� =� 0 E� $ v� # �� * �� % � * � ;� # \� < �� �� ސ � 6 � H� � ]� : � >� P� \� i� ~� �� �� �� �� Q В "� I 6� [ ��
ܓ � ��
� � 6� C C� A �� ɔ ֔ ܔ � �� � � , � J� a� m� w� �� �� �� �� ĕ ە
� � �� � ' � <� & Z� ' �� 7 �� 0 � � .� >� Q� i� r� z� �� w �� � � +� 1� K� ( d� �� �� �� �� Θ � � � 1� =� F� O� a� n� }� ��
�� �� �� �� ��
�� ʙ ә � � � ��
� �
,� :� & G� n� w�
��
�� �� �� �� Ӛ
� �� � $� 7� I� Y� p� �� �� �� ϛ � �� �
"� 0� @� % Q� w� " �� �� Ϝ � � ' � & G� n� w� �� �� �� �� ��
�� ŝ L ԝ !� 0� N� > k� �� �� Ӟ 2 � � $� 7� K� e� w� � �� �� �� �� ߟ X � M� V� s� ��
�� �� Ġ ' ͠ . �� ! $� ' F� n� x� ��
�� �� �� ߡ �� � :� I� Z� , f� �� �� �� �� Ģ � � E � N� ^� e� n� �
�� �� �� �� �� �� �� ף � � �� � � "�
(� 6� R�
k� v� �� �� �� �� Ť Τ ! � � '� 9 B� y |� 9 �� F 0� 5 w� B �� C � 5 4� : j� 9 �� @ ߧ ; � K \� B �� C � 6 /� 8 f� �� �� ʩ
٩ � �� �
� � 5� T� l� �� �� & �� ƪ ۪ � � � � ʫ # � # � # *� N� " e� �� �� �� �� Ȭ Ҭ
ج � � ��
� c � � x� 9� K V� Q �� / � O $� U t� 5 ʯ = � >� , J� 4 w� " �� ! ϰ � � � 9� " U� + x� + �� 6 б X � 7 `� 8 �� T Ѳ 5 &� I \� 6 �� # ݳ = � = ?� = }� i �� 9 %� _� z� * �� Ƶ � � � 3� :� >� M� a� g� q� {� �� �� �� # ζ � � $ � D�
W� e� n� w� � �� ��
�� �� �� �� ɷ ڷ � � � C �� C� / T� ( �� �� �� ɸ ۸ � ' � 6� $ U� % z� ! �� ) ¹ ( � / � # E� ' i� , �� . �� 4 � "� ! B� - d� �� % �� 4 ٻ 1 � - @� / n� " �� �� ' � � . )� ) X� % �� ! �� $ ʽ * � + � A F� �� �� & �� 0 Ⱦ . �� - (� V� % e� ��
��
�� �� # �� Կ � � � � � $� 0� 8� O� C a� �� � � � �� � � ;�
E� P� $ `� & �� - �� # � �� 1 � ( Q� ) z� + �� ' �� ! �� � # 5� ! Y� ( {� �� �� �� �� � 4� :� P� k� w�
�� �� ��
�� �� �� �� �� � ,� C� Z� u� �� �� �� �� ! �� � 4� 2 G� z� �� �� �� �� � 2 #� 5 V� �� �� �� . �� � & � # A� e� ! �� �� �� �� �� �� 6 � ) V� ��
�� �� �� �� �� ��
�� & �� � !� +� 5� >� T� f� x� �� �� �� ��
�� �� U �� -� >� D� , T� �� �� �� �� ��
�� �� � � #� )� 2� B� " T�
w� �� �� �� �� ��
�� 1 �� � .�
@� K� \� m� . � �� . ��
�� �� �� � � (�
5� @� E Q� ��
�� �� �� �� �� �� � � � ,� A� * Z� ��
�� �� �� �� �� �� �� ��
�� �� �� � � (� 4� >� J� d� � �� �� " �� �� �� �� ��
�� �� � � � $� % -� S� Z� k� |� �� �� �� �� �� �� �� �� ��
�� � � � )� ,� =� Y� `� i� u� ~� �� �� �� �� �� �� �� �� �� ��
�� �� �
� "� 1� C� S� _� i� v� �� �� �� �� �� �� �� ! �� 4 ��
.� <� . E� t� �� �� �� �� �� �� ��
��
��
� � "� 6� I� [� r� " �� �� �� �� �� � $� / :� j� z� �� �� " �� �� �� � ,� ?� * P�
{� �� �� �� �� �� � � &� ?� 0 Y� + �� �� �� �� > ��
� � ) %� " O� r� z�
�� �� �� �� �� �� �� �� �� � � � �
'� 5�
>�
L� W� c� o� 7 ~� 2 �� 6 �� V � w� & }� & �� . �� �� � �
'�
5� C� S� `� l� t� {� �� �� �� �� �� ! �� �� �� � �
-� 8� @� V� m� . |� �� �� �� ��
�� �� � � )� 5� >� C� M� V�
k� v� �� �� �� �� �� �� �� � � � $ 1� # V� z� �� 0 �� �� �� �� �� �� ( � :� D� U� a� t� z� �� �� �� �� �� �� , �� �� � 4� $ P� u� ' �� �� �� �� � � :� O� ! p� �� �� ��
�� �� �� � �� �� �� �� � �� % �� ��
�� �� G �� K 6� ? �� � �� j D� ? �� @ �� K 0� | |� 6 �� > 0� c o� � �� W X� Q �� Q � @ T� X �� G �� > 6� = u� Y �� N
� I \� C �� g �� M R� j �� N � K Z� N �� P �� 0 F� � w� . � B L� | �� j � = w� � �� = Q� � �� � � C �� � � c �� F �� Q >� P �� ` � : B� N }� g � Q 4� I �� J � @ � > \� , �� ; � > � > C� H �� 9 � e � P k� L �� ` � m j� Q � 9 *� 6 d� ] �� d �� > ^� 5 �� Q � X %� ] ~� E � ^ " I � e � = 1 B o P � � � � E ( C n A � N � L C 6 � / � ' � 0 K P I � G � F . 9 u , � 0 � >
H L 6 � , � * � F $ ; k 1 � 0 � 7
7 B J z & � ( � E
< [
) �
, �
T �
J D * � ( � & � )
. 4 0 c a � @ � O 7
K �
T �
G ( f p b � W : O � V � : 9 P t + � z � S l D � = J C � � ) B H l 9 � F � � 6 F � 2 $ 3 W ; � L � 8 @ M < � F � * / = = m : � T � Y ; L � b � Y E H � z � N c = � 7 � 2 ( N [ ] � G � P R I l � � O # e � � � � � � < � % ! 6 . X . � , � # � < ! C D! �! �! �! K �! ) -" � W" : # D# V# e# u# �# �# �# �# �# [ �# B$ E X$ Z �$ �$ % % 1% % =% c% O p% J �% & !& *& ?& T& ^& ! f& - �& �& �&
�& �& �& �& �& ! ' ! A' c' p' y' ' �' ) �' " �' & �' " ( 8 %( 3 ^( �( �( �( �( �( ) ) ) ~ ,) �) �) �) " �) " �) 1 * R* \* l* }* # �* �* �* �* + + + '+ :+ L+ b+ v+ ~+ �+ �+ �+ �+
�+ �+
�+ �+ �+ �+ �+ �+ , , ', 5 4, j, p, �, �, �, �, �, �, - - *- ;- R-
d- r- �- �- �- �- �- . . (. 7. D. T. / f. �. " �. �. �. / */ H H/ H �/ �/ �/
0 0 0
%0 30 :0 J0 h Y0 �0 ( �0 ( �0 ? %1 e1 �1 ! �1 D �1
2
2
2 -2 J2 ^2 d2
2 �2 " �2 0 �2 �2 � 3 �3 �3 �3 �3 �3 �3 4 & 4 2 54 h4 + �4 �4 �4 �4 �4 �4 5 ! 45 $ V5 ' {5 �5 �5 �5 8 �5 6
6 (6 ?6 D6 P6 % m6 �6 A �6 �6 �6 �6 �6 7
7
"7 -7 67 <7
K7 Y7 t7 �7 �7 �7 �7 �7 �7 �7 �7 # 8
/8 :8 K8 P8 ]8 # w8 �8 �8 �8 �8 �8 4 9 � M9 + �9 > �9 * >: @ i: 8 �: * �: / ; / >; 5 n; ; �; @ �; F !< > h< + �< 6 �<
= &= 5= S= q= �= �=
�= �= �= �= % > -> 7> ) F> * p> * �> �> , �> � �> �? ! �? @ + 2@ ^@ ( u@ �@ �@ �@ �@
�@ A A A A -A
?A m JA � �A $ �B Y �B W 6C * �C Y �C U D < iD D �D �D ) �D 8 !E ) ZE + �E " �E �E �E F F 4 5F & jF 7 �F ` �F < *G 8 gG X �G 5 �G R /H 6 �H 6 �H > �H < /I C lI n �I > J ^J zJ * �J �J 5 �J # K :K MK RK VK eK yK K �K �K �K �K �K ' �K
L L * 2L ]L
nL |L
�L �L �L
�L �L
�L �L �L �L M M M (M .M B ;M ~M / �M ( �M �M N N %N ?N * WN # �N �N �N �N �N O & 5O \O tO + �O ( �O , �O P /P & JP qP �P : �P : �P 8 Q 9 UQ �Q �Q ' �Q �Q "
R -R MR gR R $ �R # �R K �R 0S 7S ) HS * rS # �S % �S �S # �S T
T
*T 5T / ?T
oT }T �T �T �T �T �T �T �T �T ] U cU �U �U �U �U �U ! �U V
V V ' &V $ NV 6 sV �V ) �V ; �V & 1W % XW + ~W * �W ! �W " �W ! X " <X + _X �X �X �X % �X % Y )Y 0Y JY kY zY �Y 1 �Y �Y �Y �Y �Y # Z +Z EZ cZ |Z �Z " �Z # �Z �Z [ :[ # Y[ }[ �[ 9 �[ & �[ \ " "\ ! E\ # g\ , �\ 6 �\ 5 �\ %] # <] `] + w] �] 8 �] 7 �] 5 .^ 7 d^ �^ �^ �^ �^ ' _ C +_ ( o_ �_ �_ �_ �_ �_ �_ �_ �_ ' ` .` ?` E` O` X` m` ~` �` �` * �` �` �` �` �` c a ha ya �a & �a / �a �a b b ,b @b Gb Xb
db ob ub �b �b & �b �b �b
�b �b c c
7c / Ec uc �c
�c �c �c �c / �c d , d ?d Nd Xd ^d pd �d
�d �d B �d �d e e 'e 6e Fe Me ee me }e �e �e = �e f
f $f 7f Lf Vf `f
hf vf
�f �f �f
�f �f
�f �f �f �f �f g 'g 4g % ;g ag mg rg �g �g �g �g �g �g �g , �g
h h "h 3h :h Ah Wh lh �h �h �h �h
�h
�h
�h �h �h i
i & +i Ri Yi bi ni wi �i �i �i �i �i �i �i �i �i �i j $j *j >j Qj ej wj �j �j �j �j �j �j �j �j �j k k ) (k 8 Rk �k �k - �k �k �k �k �k l #l 7l Rl
fl
tl ! �l �l �l �l �l �l m $ #m Hm bm �m ! �m �m ' �m / �m +n =n Pn bn 3 wn 2 �n 0 �n 0 o @o Wo 1 io �o �o ' �o �o p )p =p Mp ap p 0 �p ( �p �p �p q 2 q
Bq Mq 1 `q & �q �q �q
�q �q �q
r "r 'r 7r <r Lr ^r nr r �r �r �r �r
�r �r �r
�r F �r / $s 8 Ts l �s �s ! t $ "t 0 Gt xt �t �t �t
�t �t �t
�t �t u u " u 8u Eu Uu gu % pu �u �u
�u �u
�u �u �u �u v . $v Sv [v lv $ }v �v �v �v
�v �v �v �v �v w w
+w 6w Cw Uw ]w mw �w �w �w �w �w " �w ) �w $ )x Nx [x : ex �x % �x �x �x �x 4 y :y Dy Uy ay ty |y �y �y �y �y �y �y , �y z 'z Cz $ \z �z - �z ! �z # �z { "{ ;{ Q{ # h{ ! �{ �{
�{ �{
�{ �{ �{ n J � � � � � � � ' B 5 � L ( " � � � \ j c ( � � � # � � � k � 7 , � � � � � - u � � �
y � S q : � v � | � � z � � � 1 � f y � � K 0 Z � �
d i ( < � B � � ; & � � � ' P 4 � 7 � $ � T � � r � � / s � � @ Y s � . � � � � r � - , � � � � H s } p � F n P � � � � � N 3 � D � Q � � O � x � a � � � E v _ k � � � � M � * � ^ T � X b + 4 ^ � � � � w � � � m < � � � � [ � - , � � � 5 � y h 3 � � $ � = � U l � � � � e � � X ( � � [ � f x � } � � � � � � T � t . V [ � G � ` 1 � � � # � k K � � : � � � 1 � 2 * ] W � � � " � t C � H g T v S � � � � H e � 5 Y Q � 7 � � � j c � � � � � � � � / 4 � � � 2 � � � ~ O q � � � i a h � � � � � � � � � � L � � � � 9 p u � � � o = � � R . � � ) � � � � � � g � 6 > L % � � b � z w � � � S x E � E � � � � � � Y � � � A � � � � � ~ � � � � � v k 8 = C � 2 � � � n � Z � � 6 � r � � � � " � ? u t � u L _ � � � � � p Y � 9 � � � � g h � � 9 / � � + � � i � � � G � � � � � � { � p I � \ � � � � � _ > N
C X h B m �
� � o � � 9 J � � 5 � . � � � � O { + $ � � � F � � & � y X � M
� � � l � � � r � f ! � � � � [ � � � I / G 2 � �
N � � � � � � i � � � � � 0 � � V 3 P � � " ` N M V o � I � � 8 t � & m 0 � W f @ � a : 7 ; R @ F � K ~ ] � � R � � � � 8 � � b E � � ~ ? � � 0 2 � � � � � � Q % * � o & A w � J $ � � � { < � | ! ^ � ! > � � : A D � � � � � 6 U ' � � m $ � � \ � � � � � � � ; - n � � � W � ? Z � � ] ` Q �
' U D \ j w � � � � � � M � � � � � � � A � � l # � � � � � _ � � { O F W 0 c � � } d = � � � e } ! z � � # D � � � � � � � # ) ) H ? q z � * ( � � � 8 � � � � � �
b � < � + � I 4 & ] � ; � % � | � � B . � q @ � � � � � � a 1 � � - ' � � % 1 � s 7 � � � ! c � � � � � / " J � d � � � � � � � � 3 � � > % � ) � � � 4 � j � � 3 � � � � � 8 � � � , � U � � � � * � � � � � � 6 � K ,
� � l � � � � g � S ^ � � ` � � V 6 P � G | � � R � C d ) Z � � � � x � � � � � + � � � 5 e
Connection options:
Display settings:
Environment variables:
For more information, type "\?" (for internal commands) or "\help" (for SQL
commands) from within psql, or consult the psql section in the PostgreSQL
documentation.
Input and output options:
Output format options:
Parser: "%s"
Parser: "%s.%s" --help=commands list backslash commands, then exit
--help=variables list special variables, then exit
(options: S = show system objects, + = additional detail)
-0, --record-separator-zero
set record separator for unaligned output to zero byte
-1 ("one"), --single-transaction
execute as a single transaction (if non-interactive)
-?, --help[=options] show this help, then exit
-A, --no-align unaligned table output mode
-E, --echo-hidden display queries that internal commands generate
-F, --field-separator=STRING
field separator for unaligned output (default: "%s")
-H, --html HTML table output mode
-L, --log-file=FILENAME send session log to file
-P, --pset=VAR[=ARG] set printing option VAR to ARG (see \pset command)
-R, --record-separator=STRING
record separator for unaligned output (default: newline)
-S, --single-line single-line mode (end of line terminates SQL command)
-T, --table-attr=TEXT set HTML table tag attributes (e.g., width, border)
-U, --username=USERNAME database user name (default: "%s")
-V, --version output version information, then exit
-W, --password force password prompt (should happen automatically)
-X, --no-psqlrc do not read startup file (~/.psqlrc)
-a, --echo-all echo all input from script
-b, --echo-errors echo failed commands
-c, --command=COMMAND run only single command (SQL or internal) and exit
-d, --dbname=DBNAME database name to connect to (default: "%s")
-e, --echo-queries echo commands sent to server
-f, --file=FILENAME execute commands from file, then exit
-h, --host=HOSTNAME database server host or socket directory (default: "%s")
-l, --list list available databases, then exit
-n, --no-readline disable enhanced command line editing (readline)
-o, --output=FILENAME send query results to file (or |pipe)
-p, --port=PORT database server port (default: "%s")
-q, --quiet run quietly (no messages, only query output)
-s, --single-step single-step mode (confirm each query)
-t, --tuples-only print rows only
-v, --set=, --variable=NAME=VALUE
set psql variable NAME to VALUE
(e.g., -v ON_ERROR_STOP=1)
-w, --no-password never prompt for password
-x, --expanded turn on expanded table output
-z, --field-separator-zero
set field separator for unaligned output to zero byte
AUTOCOMMIT if set, successful SQL commands are automatically committed
COLUMNS number of columns for wrapped format
COMP_KEYWORD_CASE determines the case used to complete SQL key words
[lower, upper, preserve-lower, preserve-upper]
DBNAME the currently connected database name
ECHO controls what input is written to standard output
[all, errors, none, queries]
ECHO_HIDDEN if set, display internal queries executed by backslash commands;
if set to "noexec", just show without execution
ENCODING current client character set encoding
FETCH_COUNT the number of result rows to fetch and display at a time
(default: 0=unlimited)
HISTCONTROL controls command history [ignorespace, ignoredups, ignoreboth]
HISTFILE file name used to store the command history
HISTSIZE the number of commands to store in the command history
HOST the currently connected database server host
IGNOREEOF if unset, sending an EOF to interactive session terminates application
LASTOID value of the last affected OID
NAME=VALUE [NAME=VALUE] psql ...
or \setenv NAME [VALUE] inside psql
ON_ERROR_ROLLBACK if set, an error doesn't stop a transaction (uses implicit savepoints)
ON_ERROR_STOP stop batch execution after error
PAGER name of external pager program
PGAPPNAME same as the application_name connection parameter
PGDATABASE same as the dbname connection parameter
PGHOST same as the host connection parameter
PGPASSFILE password file name
PGPASSWORD connection password (not recommended)
PGPORT same as the port connection parameter
PGUSER same as the user connection parameter
PORT server port of the current connection
PROMPT1 specifies the standard psql prompt
PROMPT2 specifies the prompt used when a statement continues from a previous line
PROMPT3 specifies the prompt used during COPY ... FROM STDIN
PSQLRC alternative location for the user's .psqlrc file
PSQL_EDITOR, EDITOR, VISUAL
editor used by the \e, \ef, and \ev commands
PSQL_EDITOR_LINENUMBER_ARG
how to specify a line number when invoking the editor
PSQL_HISTORY alternative location for the command history file
QUIET run quietly (same as -q option)
SHELL shell used by the \! command
SHOW_CONTEXT controls display of message context fields [never, errors, always]
SINGLELINE end of line terminates SQL command mode (same as -S option)
SINGLESTEP single-step mode (same as -s option)
TMPDIR directory for temporary files
USER the currently connected database user
VERBOSITY controls verbosity of error reports [default, verbose, terse]
\! [COMMAND] execute command in shell or start interactive shell
\? [commands] show help on backslash commands
\? options show help on psql command-line options
\? variables show help on special variables
\C [STRING] set table title, or unset if none
\H toggle HTML output mode (currently %s)
\T [STRING] set HTML <table> tag attributes, or unset if none
\a toggle between unaligned and aligned output mode
\c[onnect] {[DBNAME|- USER|- HOST|- PORT|-] | conninfo}
connect to new database (currently "%s")
\c[onnect] {[DBNAME|- USER|- HOST|- PORT|-] | conninfo}
connect to new database (currently no connection)
\cd [DIR] change the current working directory
\conninfo display information about current connection
\copy ... perform SQL COPY with data stream to the client host
\copyright show PostgreSQL usage and distribution terms
\crosstabview [COLUMNS] execute query and display results in crosstab
\dA[+] [PATTERN] list access methods
\dC[+] [PATTERN] list casts
\dD[S+] [PATTERN] list domains
\dE[S+] [PATTERN] list foreign tables
\dF[+] [PATTERN] list text search configurations
\dFd[+] [PATTERN] list text search dictionaries
\dFp[+] [PATTERN] list text search parsers
\dFt[+] [PATTERN] list text search templates
\dL[S+] [PATTERN] list procedural languages
\dO[S+] [PATTERN] list collations
\dT[S+] [PATTERN] list data types
\d[S+] list tables, views, and sequences
\d[S+] NAME describe table, view, sequence, or index
\da[S] [PATTERN] list aggregates
\db[+] [PATTERN] list tablespaces
\dc[S+] [PATTERN] list conversions
\dd[S] [PATTERN] show object descriptions not displayed elsewhere
\ddp [PATTERN] list default privileges
\des[+] [PATTERN] list foreign servers
\det[+] [PATTERN] list foreign tables
\deu[+] [PATTERN] list user mappings
\dew[+] [PATTERN] list foreign-data wrappers
\df[antw][S+] [PATRN] list [only agg/normal/trigger/window] functions
\dg[S+] [PATTERN] list roles
\di[S+] [PATTERN] list indexes
\dl list large objects, same as \lo_list
\dm[S+] [PATTERN] list materialized views
\dn[S+] [PATTERN] list schemas
\do[S] [PATTERN] list operators
\dp [PATTERN] list table, view, and sequence access privileges
\drds [PATRN1 [PATRN2]] list per-database role settings
\ds[S+] [PATTERN] list sequences
\dt[S+] [PATTERN] list tables
\du[S+] [PATTERN] list roles
\dv[S+] [PATTERN] list views
\dx[+] [PATTERN] list extensions
\dy [PATTERN] list event triggers
\e [FILE] [LINE] edit the query buffer (or file) with external editor
\echo [STRING] write string to standard output
\ef [FUNCNAME [LINE]] edit function definition with external editor
\encoding [ENCODING] show or set client encoding
\errverbose show most recent error message at maximum verbosity
\ev [VIEWNAME [LINE]] edit view definition with external editor
\f [STRING] show or set field separator for unaligned query output
\g [FILE] or ; execute query (and send results to file or |pipe)
\gexec execute query, then execute each value in its result
\gset [PREFIX] execute query and store results in psql variables
\h [NAME] help on syntax of SQL commands, * for all commands
\i FILE execute commands from file
\ir FILE as \i, but relative to location of current script
\l[+] [PATTERN] list databases
\lo_export LOBOID FILE
\lo_import FILE [COMMENT]
\lo_list
\lo_unlink LOBOID large object operations
\o [FILE] send all query results to file or |pipe
\p show the contents of the query buffer
\password [USERNAME] securely change the password for a user
\prompt [TEXT] NAME prompt user to set internal variable
\pset [NAME [VALUE]] set table output option
(NAME := {border|columns|expanded|fieldsep|fieldsep_zero|
footer|format|linestyle|null|numericlocale|pager|
pager_min_lines|recordsep|recordsep_zero|tableattr|title|
tuples_only|unicode_border_linestyle|
unicode_column_linestyle|unicode_header_linestyle})
\q quit psql
\qecho [STRING] write string to query output stream (see \o)
\r reset (clear) the query buffer
\s [FILE] display history or save it to file
\set [NAME [VALUE]] set internal variable, or list all if no parameters
\setenv NAME [VALUE] set or unset environment variable
\sf[+] FUNCNAME show a function's definition
\sv[+] VIEWNAME show a view's definition
\t [on|off] show only rows (currently %s)
\timing [on|off] toggle timing of commands (currently %s)
\unset NAME unset (delete) internal variable
\w FILE write query buffer to file
\watch [SEC] execute query every SEC seconds
\x [on|off|auto] toggle expanded output (currently %s)
\z [PATTERN] same as \dp
border border style (number)
columns target width for the wrapped format
expanded (or x) expanded output [on, off, auto]
fieldsep field separator for unaligned output (default "%s")
fieldsep_zero set field separator for unaligned output to zero byte
footer enable or disable display of the table footer [on, off]
format set output format [unaligned, aligned, wrapped, html, asciidoc, ...]
linestyle set the border line drawing style [ascii, old-ascii, unicode]
null set the string to be printed in place of a null value
numericlocale enable or disable display of a locale-specific character to separate
groups of digits [on, off]
pager control when an external pager is used [yes, no, always]
psql --pset=NAME[=VALUE]
or \pset NAME [VALUE] inside psql
psql --set=NAME=VALUE
or \set NAME VALUE inside psql
psql [OPTION]... [DBNAME [USERNAME]]
recordsep record (line) separator for unaligned output
recordsep_zero set record separator for unaligned output to zero byte
set NAME=VALUE
psql ...
or \setenv NAME [VALUE] inside psql
tableattr (or T) specify attributes for table tag in html format or proportional
column widths for left-aligned data types in latex-longtable format
title set the table title for any subsequently printed tables
tuples_only if set, only actual table data is shown
unicode_border_linestyle
unicode_column_linestyle
unicode_header_linestyle
set the style of Unicode line drawing [single, double]
"%s.%s" is not a view
%d connection %d connections %s %s %s (every %gs)
%s
%s (%s, server %s)
%s (every %gs)
%s: %s
%s: -1 can only be used in non-interactive mode
%s: cannot copy from/to a directory
%s: could not delete variable "%s"
%s: could not find own program executable
%s: could not open log file "%s": %s
%s: could not set printing parameter "%s"
%s: could not set variable "%s"
%s: current transaction is aborted
%s: invalid encoding name or conversion procedure not found
%s: not connected to a database
%s: out of memory
%s: unknown transaction status
%s: warning: extra command-line argument "%s" ignored
(%lu row) (%lu rows) ***(Single step mode: verify command)*******************************************
%s
***(press return to proceed or enter x and return to cancel)********************
********* QUERY **********
%s
**************************
+ opt(%d) = |%s|
, clustered , deferrable , initially deferred , invalid , predicate (%s) , replica identity , tablespace "%s" Access privileges All connection parameters must be supplied because no database connection exists
Argument data types Asynchronous notification "%s" received from server process with PID %d.
Asynchronous notification "%s" with payload "%s" received from server process with PID %d.
Attributes Available help:
Border style is %d.
Bypass RLS COPY data transfer failed: %s Call Handler Cannot add cell to table content: total cell count of %d exceeded.
Cannot add header to table content: column count of %d exceeded.
Cannot login Check Check constraints: Child tables Collate Column Column privileges Command: %s
Description: %s
Syntax:
%s
Composite type "%s.%s" Connection
Create DB Create role Ctype Database Default access privileges Default footer is off.
Default footer is on.
Default? Definition Description Destination Dictionaries Did not find any extension named "%s".
Did not find any extensions.
Did not find any relation named "%s".
Did not find any relation with OID %s.
Did not find any text search configuration named "%s".
Did not find any text search parser named "%s".
Disabled internal triggers: Disabled rules: Disabled triggers: Disabled user triggers: Elements Enabled Encoding End parse Enter data to be copied followed by a newline.
End with a backslash and a period on a line by itself, or an EOF signal. Enter it again: Enter new password: Event Expanded display is off.
Expanded display is on.
Expanded display is used automatically.
FDW Options FDW Options: (%s) Failed.
Field separator is "%s".
Field separator is zero byte.
Foreign table "%s.%s" Foreign-data wrapper Foreign-key constraints: Formatting
Function General
General options:
Get headline Get next token Get token types Handler Has OIDs: yes Help
ID Implicit? Index Index "%s.%s" Indexes: Informational
Inherits Init Init options Inline Handler Input/Output
Internal Language Internal name Interrupted
Invalid command \%s. Try \? for help.
Language Large Objects
Large objects Left arg type Lexize Line style is %s.
List of access methods List of aggregate functions List of casts List of collations List of conversions List of data types List of databases List of domains List of event triggers List of foreign servers List of foreign tables List of foreign-data wrappers List of functions List of installed extensions List of languages List of operators List of relations List of roles List of schemas List of settings List of specially treated variables
List of tablespaces List of text search configurations List of text search dictionaries List of text search parsers List of text search templates List of user mappings Locale-adjusted numeric output is off.
Locale-adjusted numeric output is on.
Location Materialized view "%s.%s" Member of Method Modifier Modifiers Name No changes No connections No help available for "%s".
Try \h with no arguments to see available help.
No inheritance No matching relations found.
No matching settings found.
No per-database role settings support in this server version.
No relations found.
No settings found.
Null display is "%s".
Number of child tables: %d (Use \d+ to list them.) Object Object Description Object descriptions Objects in extension "%s" Operating System
Options Output format is %s.
Owned by: %s Owner Pager is always used.
Pager is used for long output.
Pager usage is off.
Pager won't be used for less than %d line.
Pager won't be used for less than %d lines.
Parallel Password encryption failed.
Password for user %s: Password valid until Password: Passwords didn't match.
Policies Policies (forced row security enabled): Policies (forced row security enabled): (none) Policies (row security disabled): Policies (row security enabled): (none) Policies: Previous connection kept
Procedure Query Buffer
Query buffer is empty. Query buffer reset (cleared). Record separator is "%s".
Record separator is <newline>.
Record separator is zero byte.
Referenced by: Replica Identity Replication Report bugs to <pgsql-bugs@postgresql.org>.
Result data type Result type Right arg type Role Role name Rules firing always: Rules firing on replica only: Rules: SSL connection (protocol: %s, cipher: %s, bits: %s, compression: %s)
STATEMENT: %s
Schema Security Sequence "%s.%s" Server Server: %s Settings Size Source Source code Source type Special relation "%s.%s" Start parse Stats target Storage Succeeded.
Superuser TOAST table "%s.%s" Table Table "%s.%s" Table attributes are "%s".
Table attributes unset.
Tablespace Tablespace: "%s" Tags Target type Target width is %d.
Target width is unset.
Template Text search configuration "%s" Text search configuration "%s.%s" Text search parser "%s" Text search parser "%s.%s" The connection to the server was lost. Attempting reset: The input is a PostgreSQL custom-format dump.
Use the pg_restore command-line client to restore this dump to a database.
The server (version %s) does not support access methods.
The server (version %s) does not support altering default privileges.
The server (version %s) does not support collations.
The server (version %s) does not support editing function source.
The server (version %s) does not support editing view definitions.
The server (version %s) does not support extensions.
The server (version %s) does not support foreign servers.
The server (version %s) does not support foreign tables.
The server (version %s) does not support foreign-data wrappers.
The server (version %s) does not support full text search.
The server (version %s) does not support savepoints for ON_ERROR_ROLLBACK.
The server (version %s) does not support showing function source.
The server (version %s) does not support showing view definitions.
The server (version %s) does not support tablespaces.
The server (version %s) does not support user mappings.
There is no previous error. Time: %.3f ms
Timing is off. Timing is on. Title is "%s".
Title is unset.
Token Token name Token types for parser "%s" Token types for parser "%s.%s" Triggers firing always: Triggers firing on replica only: Triggers: Trusted Try "%s --help" for more information.
Tuples only is off.
Tuples only is on.
Type Type "help" for help.
Type: \copyright for distribution terms
\h for help with SQL commands
\? for help with psql commands
\g or terminate with semicolon to execute query
\q to quit
Typed table of type: %s Unicode border line style is "%s".
Unicode column line style is "%s".
Unicode header line style is "%s".
Unlogged index "%s.%s" Unlogged materialized view "%s.%s" Unlogged table "%s.%s" Usage:
Use "\q" to leave %s.
User name Validator Value Variables
Version View "%s.%s" View definition: Volatility WARNING: %s major version %s, server major version %s.
Some psql features might not work.
WARNING: Console code page (%u) differs from Windows code page (%u)
8-bit characters might not work correctly. See psql reference
page "Notes for Windows users" for details.
Wrote history to file "%s".
You are connected to database "%s" as user "%s" on host "%s" at port "%s".
You are connected to database "%s" as user "%s" via socket in "%s" at port "%s".
You are currently not connected to a database.
You are now connected to database "%s" as user "%s" on host "%s" at port "%s".
You are now connected to database "%s" as user "%s" via socket in "%s" at port "%s".
You are now connected to database "%s" as user "%s".
You are using psql, the command-line interface to PostgreSQL. \!: failed
\%s: could not change directory to "%s": %s
\%s: environment variable name must not contain "="
\%s: error while setting variable
\%s: extra argument "%s" ignored
\%s: missing required argument
\connect: %s \copy: arguments required
\copy: parse error at "%s"
\copy: parse error at end of line
\crosstabview: ambiguous column name: "%s"
\crosstabview: column name not found: "%s"
\crosstabview: column number %d is out of range 1..%d
\crosstabview: data column must be specified when query returns more than three columns
\crosstabview: maximum number of columns (%d) exceeded
\crosstabview: query must return at least three columns
\crosstabview: query result contains multiple data values for row "%s", column "%s"
\crosstabview: statement did not return a result set
\crosstabview: vertical and horizontal headers must be different columns
\df does not take a "w" option with server version %s
\df only takes [antwS+] as options
\pset: allowed Unicode border line styles are single, double
\pset: allowed Unicode column line styles are single, double
\pset: allowed Unicode header line styles are single, double
\pset: allowed formats are unaligned, aligned, wrapped, html, asciidoc, latex, latex-longtable, troff-ms
\pset: allowed line styles are ascii, old-ascii, unicode
\pset: unknown option: %s
\watch cannot be used with COPY
\watch cannot be used with an empty query
abbreviated_grant_or_revoke abort the current transaction aborted because of read failure access_method_type action agg aggregate_name aggregate_signature alias alignment allowconn always analyze_function and aggregate_signature is: and conflict_action is one of: and grouping_element can be one of: and like_option is: and table_constraint is: and table_constraint_using_index is: and with_query is: arg_data_type arg_name arg_type argmode argname argtype argument argument_type arguments attribute attribute_name attribute_option base_type boolean cache call_handler cancel a transaction that was earlier prepared for two-phase commit canceled by user cannot duplicate null pointer (internal error)
cannot escape without active connection
canonical_function category change a database change a database role change a run-time parameter change a server configuration parameter change role name or membership change the definition of a collation change the definition of a conversion change the definition of a domain change the definition of a foreign server change the definition of a foreign table change the definition of a foreign-data wrapper change the definition of a function change the definition of a large object change the definition of a materialized view change the definition of a procedural language change the definition of a row level security policy change the definition of a rule change the definition of a schema change the definition of a sequence generator change the definition of a table change the definition of a tablespace change the definition of a text search configuration change the definition of a text search dictionary change the definition of a text search parser change the definition of a text search template change the definition of a trigger change the definition of a type change the definition of a user mapping change the definition of a view change the definition of an aggregate function change the definition of an event trigger change the definition of an extension change the definition of an index change the definition of an operator change the definition of an operator class change the definition of an operator family change the ownership of database objects owned by a database role channel check_expression child process exited with exit code %d child process exited with unrecognized status %d child process was terminated by exception 0x%X child process was terminated by signal %d: %s close a cursor cluster a table according to an index code collatable collate %s collation collect statistics about a database column_alias column_constraint column_definition column_name column_type com_op combinefunc command command not executable command not found commit a transaction that was earlier prepared for two-phase commit commit the current transaction compute a set of rows condition configuration_parameter conflict_action conflict_target connection to server was lost
connlimit constraint constraint_name copy data between a file and a table could not change directory to "%s": %s could not close pipe to external command: %s
could not execute command "%s": %s
could not find a "%s" to execute could not get home directory for user ID %ld: %s
could not identify current directory: %s could not locate temporary directory: %s
could not look up effective user ID %ld: %s could not open temporary file "%s": %s
could not parse reloptions array
could not read binary "%s" could not read from input file: %s
could not read symbolic link "%s" could not save history to file "%s": %s
could not set variable "%s"
could not start /bin/sh
could not start editor "%s"
could not stat file "%s": %s
could not write COPY data: %s
count create a new database create new rows in a table cursor_name data_type database_name deallocate a prepared statement default default %s default_expr define a cursor define a new access method define a new aggregate function define a new cast define a new collation define a new data type define a new database role define a new domain define a new encoding conversion define a new event trigger define a new foreign server define a new foreign table define a new foreign-data wrapper define a new function define a new index define a new mapping of a user to a foreign server define a new materialized view define a new operator define a new operator class define a new operator family define a new procedural language define a new rewrite rule define a new row level security policy for a table define a new savepoint within the current transaction define a new schema define a new sequence generator define a new table define a new table from the results of a query define a new tablespace define a new text search configuration define a new text search dictionary define a new text search parser define a new text search template define a new transform define a new trigger define a new view define access privileges define default access privileges define or change a security label applied to an object define or change the comment of an object definer definition delete delete rows of a table delimiter delimiter_character deserialfunc dest_encoding destroy a previously defined savepoint dictionary_name direction directory disabled discard session state domain constraint domain_constraint domain_name element empty a table or set of tables enabled encoding encoding_name end_function environment variable PSQL_EDITOR_LINENUMBER_ARG must be set to specify a line number
escape_character event exclude_element exclude_element in an EXCLUDE constraint is: execute a prepared statement execute an anonymous code block execution_cost existing_collation existing_enum_value expression extension_name family_name fdw_name ffunc filename filter_variable for table "%s.%s" force a transaction log checkpoint foreign table format_name from_item from_sql_function_name function function name is required
function_name garbage-collect and optionally analyze a database generate a notification gettoken_function group_name grouping_element handler_function headline_function history is not supported by this installation
immutable import table definitions from a foreign server in assignment increment index index_column_name index_expression index_method index_name index_parameters index_parameters in UNIQUE, PRIMARY KEY, and EXCLUDE constraints are: index_predicate init_function initial_condition inline_handler input_function insert install an extension integer internallength invalid binary "%s" invalid command \%s
invalid line number: %s
invalid output format (internal error): %d invoker istemplate join_column join_condition join_proc join_type label lang_name large_object_oid lc_collate lc_ctype left_type lexize_function lextypes_function like_option like_type link_symbol listen for a notification load a shared library file local socket local_schema locale lock a named relation (table, etc) lockmode loid materialized view maxvalue member_object method mffunc minitial_condition minvalue minvfunc more than one row returned for \gset
msfunc mstate_data_size mstate_data_type name neg_op new_attribute_name new_column_name new_constraint_name new_dictionary new_enum_value new_name new_owner new_role new_schema new_table new_tablespace new_version no no query buffer
no rows returned for \gset
normal not null null_string obj_file object_name off old_dictionary old_role old_version on op_type opclass operator operator class operator family operator_name option or the old syntax out of memory out of memory
output_expression output_function output_name parameter parent_table parser_name password payload pclose failed: %s policy_name position a cursor predicate preferred prepare a statement for execution prepare the current transaction for two-phase commit primary key, provider psql is the PostgreSQL interactive terminal.
psql variables:
query quote_character rebuild indexes receive_function refcolumn referenced_table_name reftable relation_name remote_schema remove a cast remove a collation remove a conversion remove a data type remove a database remove a database role remove a domain remove a foreign server descriptor remove a foreign table remove a foreign-data wrapper remove a function remove a materialized view remove a procedural language remove a rewrite rule remove a row level security policy from a table remove a schema remove a sequence remove a table remove a tablespace remove a text search configuration remove a text search dictionary remove a text search parser remove a text search template remove a transform remove a trigger remove a user mapping for a foreign server remove a view remove access privileges remove an access method remove an aggregate function remove an event trigger remove an extension remove an index remove an operator remove an operator class remove an operator family remove database objects owned by a database role replace the contents of a materialized view replica res_proc restart restore the value of a run-time parameter to the default value restricted result_rows retrieve rows from a query using a cursor retrieve rows from a table or view rettype rewrite_rule_name right_type role_name role_specification roll back to a savepoint rule rule_name safe sampling_method savepoint_name schema_element schema_name seed select send_function sequence sequence_name serialfunc server_name server_type server_version set constraint check timing for the current transaction set the characteristics of the current transaction set the current user identifier of the current session set the session user identifier and the current user identifier of the current session sfunc show the execution plan of a statement show the value of a run-time parameter skipping recursive expansion of variable "%s"
snapshot_id sort_expression sort_family_name sort_operator source_config source_encoding source_table source_type special stable start start a transaction block start_function state_data_size state_data_type statement stop listening for a notification storage storage_parameter storage_type strategy_number sub-SELECT subtype subtype_diff_function subtype_operator_class support_number tab completion query failed: %s
Query was:
%s
table table constraint table_constraint table_constraint_using_index table_name tablespace_name tablespace_option target_role target_type template text timestamp timezone to_sql_function_name token_type transaction_id transaction_mode trigger trigger_name trying to exit copy mode type type_modifier_input_function type_modifier_output_function type_name uid unexpected PQresultStatus: %d
unexpected result status for \watch
unexpected transaction status (%d)
unique, unknown unrecognized value "%s" for "%s"; assuming "%s"
unsafe unterminated quoted string
update update rows of a table user does not exist user name lookup failure: error code %lu user_name using_expression valfunction validator_function value values version view view name is required
view_option_name view_option_value volatile where abbreviated_grant_or_revoke is one of: where action is one of: where aggregate_signature is: where column_constraint is: where conflict_target can be one of: where constraint is: where direction can be empty or one of: where event can be one of: where from_item can be one of: where lockmode is one of: where member_object is: where option can be one of: where option can be: where role_specification can be: where transaction_mode is one of: window window_definition window_name with_query with_query_name yes Project-Id-Version: psql-cs (PostgreSQL 9.3)
Report-Msgid-Bugs-To: pgsql-bugs@postgresql.org
POT-Creation-Date: 2020-10-28 19:20+0000
PO-Revision-Date: 2020-11-01 00:27+0100
Last-Translator: Tomas Vondra <tv@fuzzy.cz>
Language-Team: Czech <info@cspug.cx>
Language: cs
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Plural-Forms: nplurals=3; plural=(n==1) ? 0 : (n>=2 && n<=4) ? 1 : 2;
X-Generator: Poedit 2.4.1
Parametry spojení:
Nastavení zobrazení:
Proměnné prostředí:
Pro více informací použijte "\?" (pro interní příkazy) nebo "\help"
(pro SQL příkazy), nebo se podívejte do dokumentace PostgreSQL a
části věnované psql.
Vstupní a výstupní přepínače:
Výstupní formát je:
Parser: "%s"
Parser: "%s.%s" --help=commands vypíše interní příkazy, poté skončí
--help=variables vypíše speciální proměnné, poté skončí
(volby: S = zobraz systémové objekty, + = další detaily)
-0, --record-separator-zero
nastaví oddělovač záznamů pro nezarovnaný výstup na nulový byte
-1 ("jedna"), --single-transaction
proveď operaci v rámci jedné transakce
-?, --help[=options] ukáže tuto nápovědu, a skončí
-A, --no-align mód nezarovnaného formátu tabulky
-E, --echo-hidden ukáže dotazy generované interními příkazy
-F, --field-separator=ŘETĚZEC
oddělovač polí pro nezarovnaný výstup (implicitně: "%s")
-H, --html mód HTML formátu tabulky
-L, --log-file=FILENAME uloží záznam sezení do souboru
-P, --pset=VAR[=ARG] nastaví zobrazovací parametr VAR na hodnotu ARG (viz. příkaz \pset)
-R, --record-separator=ŘETĚZEC
oddělovač záznamů pro nezarovnaný výstup (implicitně: newline)
-S, --single-line jednořádkový mód (konec řádky ukončuje SQL příkaz)
-T, --table-attr=TEXT nastaví atributy HTML tabulky (např. width, border)
-U, --username=JMÉNO jméno databázového uživatele (implicitně: "%s")
-V, --version ukáže informace o verzi a skončí
-W, --password vynucený dotaz na heslo (měl by být proveden automaticky)
-X, --no-psqlrc nečíst inicializační soubor (~/.psqlrc)
-a, --echo-all ukáže všechny vstupy ze skriptu
-b, --echo-errors vypíše příkazy které selhaly
-c, --command=PŘÍKAZ provede pouze jeden příkaz (SQL nebo interní) a skončí
-d, --dbname=DATABÁZE jméno databáze pro spojení (implicitně: "%s")
-e --echo-queries ukáže všechny příkazy poslané na server
-f, --file=SOUBOR provede příkazy ze souboru a skončí
-h, --host=HOSTNAME jméno databázového serveru nebo adresář se soketem (implicitně: "%s")
-l, --list vypíše seznam dostupných databází a skončí
-n, --no-readline vypne pokročilé editační možnosti příkazové řádky (podpora readline)
-o, --output=SOUBOR zapíše výsledek dotazu do souboru (nebo |roury)
-p, --port=PORT port databázového serveru (implicitně: "%s")
-q, --quiet tichý chod (bez hlášek, pouze výstupy dotazů)
-s, --single-step krokovací mód (nutné potvrzení každého dotazu)
-t, --tuples-only tiskni pouze řádky
-v, --set=, --variable=JMÉNO=HODNOTA
nastaví psql proměnnou JMÉNO na HODNOTA
(e.g., -v ON_ERROR_STOP=1)
-w, --no-password neptá se na heslo
-x, --expanded zapne rozšířený tabulkový výstup
-z, --field-separator-zero
nastaví oddělovač polí pro nezarovnaný výstup na nulový byte
AUTOCOMMIT pokud nastaveno, úspěšně dokončené SQL příkazy jsou automaticky commitovány
COLUMNS počet sloupců pro zalamovaný formát
COMP_KEYWORD_CASE určuje velikost písmen pro dokončování SQL klíčových slov
[lower, upper, preserve-lower, preserve-upper]
DBNAME název aktuálně připojené databáze
ECHO určuje jaký vstup je zapisován na standardní výstup
[all, errors, none, queries]
ECHO_HIDDEN pokud je nastaveno, zobrazuje dotazy spouštěné interními (backslash) příkazy;
při nastavení na "noexec", pouze zobrazí bez spuštění
ENCODING aktuální kódování znakové sady klienta
FETCH_COUNT počet řádek výsledku pro načtení a zobrazení nanjednou
(výchozí: 0 = unlimited)
HISTCONTROL nastavuje chování historie příkazů [ignorespace, ignoredups, ignoreboth]
HISTFILE název souboru pro uložení historie příkazů
HISTSIZE maximální počet položek uložených v historii přkazů
HOST databázový server ke kterému jste aktuálně připojeni
IGNOREEOF pokud nenastaveno, zaslání EOF v interaktivní session ukončí aplikaci
LASTOID hodnota posledního změněného OID
NAME=VALUE [NAME=VALUE] psql ...
nebo \setenv NAME [VALUE] v rámci psql
ON_ERROR_ROLLBACK pokud nastaveno, chyba nepřeruší transakci (používá implicitní savepointy)
ON_ERROR_STOP zastaví dávkové spouštění v případě výskytu chyby
PAGER jméno externího stránkovacího programu (pageru)
PGAPPNAME stejné jako application_name v parametrech spojení
PGDATABASE stejné jako dbname v parametrech spojení
PGHOST stejné jako host v parametrech spojení
PGPASSFILE jméno souboru s hesly
PGPASSWORD heslo pro spojení (nedoporučuje se)
PGPORT stejné jako port v parametrech spojení
PGUSER stejné jako user v parametrech spojení
PORT port na serveru používaný aktuálním spojením
PROMPT1 specifikuje standardní psql prompt
PROMPT2 specifikuje prompt používaný pokud příkaz pokračuje z předchozí řádky
PROMPT3 specifikuje prompt používaný během COPY ... FROM STDIN
PSQLRC alternativní umístění uživatelova .psqlrc souboru
PSQL_EDITOR, EDITOR, VISUAL
editor používaný příkazy \e, \ef, a \ev
PSQL_EDITOR_LINENUMBER_ARG
jak specifikovat číslo řádky při spouštění editoru
PSQL_HISTORY alternativní umístění pro soubor s historií příkazů
QUIET tichý běh (stejné jako volba -q)
SHELL shell používaný \! příkazem
SHOW_CONTEXT určuje zobrazení informací o kontextu zpráv [never, errors, always]
SINGLELINE pokud nastaveno, konec řádky ukončuje SQL příkazy (stejné jako volba -S)
SINGLESTEP single-step mód (stejné jako volba -s)
TMPDIR adresář pro dočasné soubory
USER uživatelský účet ke kterému jste aktuálně připojeni
VERBOSITY určuje podrobnost chybových hlášení [default, verbose, terse]
\! [PŘÍKAZ] provedení příkazu v shellu nebo nastartuje interaktivní shell
\? [commands] zobrazí nápovědu k interním příkazům
\? options zobrazí nápovědu k psql parametrům psql pro příkazovou řádku
\? variables zobrazí nápovědu ke speciálním proměnným
\C [ŘETĚZEC] nastaví titulek tabulky nebo odnastaví pokud není definován řetězec
\H zapne HTML mód výstupu (nyní %s)
\T [ŘETĚZEC] nastavení atributů HTML tagu <table>
\a přepíná mezi 'unaligned' a 'aligned' modem výstupu
\c[onnect] [DATABÁZE|- UŽIVATEL|- HOST|- PORT|-] | conninfo]
připojí se do nové databáze (současná "%s")
\c[onnect] [DATABÁZE|- UŽIVATEL|- HOST|- PORT|-] | conninfo]
připojí se do nové databáze (současně žádné spojení)
\cd [ADRESÁŘ] změna aktuálního pracovního adresář
\conninfo zobrazí informace o aktuálním spojení
\copy ... provede SQL COPY s tokem dat na klienta
\copyright zobrazí podmínky použití a distribuce PostgreSQL
\crosstabview [SLOUPCE] spustí dotaz a zobrazí výsledek přes crosstab
\dA[+] [PATTERN] seznam přístupových metod
\dC[+] [PATTERN] seznam přetypování
\dD[S+] [PATTERN] seznam domén
\dE[S+] [VZOR] seznam foreign tabulek
\dF[+] [VZOR] seznam konfigurací fulltextového vyhledávání
\dFd[+] [VZOR] seznam slovníků fulltextového vyhledávání
\dFp[+] [VZOR] seznam parserů fulltextového vyhledávání
\dFt[+] [VZOR] seznam šablon fulltextového vyhledávání
\dL[S+] [VZOR] seznam procedurálních jazyků
\dO[S+] [VZOR] seznam collations
\dT[S+] [VZOR] seznam datových typů
\d[S+] seznam tabulek, pohledů a sekvencí
\d[S+] JMÉNO popis tabulky, pohledů, sekvence nebo indexu
\da[S] [VZOR] seznam agregačních funkcí
\db[+] [VZOR] seznam tablespaces
\dc[S+] [PATTERN] seznam konverzí
\dd[S] [PATTERN] zobrazí popis objektů nezobrazených jinde
\ddp [VZOR] seznam implicitních privilegií
\des[+] [VZOR] seznam foreign serverů
\det[+] [VZOR] seznam foreign tabulek
\deu[+] [VZOR] seznam mapování uživatelů
\dew[+] [VZOR] seznam foreign-data wrapperů
\df[antw][S+] [VZOR] seznam [pouze agg/normal/trigger/window] funkcí
\dg[S+] [PATTERN] seznam rolí
\di[S+] [VZOR] seznam indexů
\dl seznam "large object" stejné jako \lo_list
\dm[S+] [PATTERN] seznam materializovaných pohledů
\dn[S+] [VZOR] seznam schémat
\do[S] [VZOR] seznam operátorů
\dp [VZOR] seznam přístupových práv tabulek, pohledů a sekvencí
\drds [VZOR1 [VZOR2]] seznam nastavení rolí pro jednotlivé databáze
\ds[S+] [VZOR] seznam sekvencí
\dt[S+] [VZOR] seznam tabulek
\du[S+] [PATTERN] seznam rolí
\dv[S+] [VZOR] seznam pohledů
\dx[+] [VZOR] seznam rozšíření
\dy [PATTERN] seznam event triggerů
\e [SOUBOR] [ŘÁDEK] editace aktuálního dotazu (nebo souboru) v externím editoru
\echo [TEXT] vypsání textu na standardní výstup
\ef [JMENOFUNKCE [ŘÁDEK]] editace definice funkce v externím editoru
\encoding [KÓDOVÁNÍ] zobrazení nebo nastavení kódování klienta
\errverbose zobrazí polední chybovou hlášku s maximem podrobností
\ev [VIEWNAME [LINE]] editace definice pohledu v externím editoru
\f [ŘETĚZEC] nastaví nebo zobrazí oddělovače polí pro nezarovnaný výstup dotazů
\g [SOUBOR] nebo ; pošle SQL dotaz na server (a zapíše výsledek do souboru nebo |roury)
\gexec spustí dotaz, poté spustí každou hodnotu z jeho výsledku
\gset [PREFIX] spustí dotaz a uloží výsledky v psql proměnných
\h [JMÉNO] nápověda syntaxe SQL příkazů, * pro všechny příkazy
\i SOUBOR provedení příkazů ze souboru
\ir FILE jako \i, ale relativně k pozici v aktuálním skriptu
\l[+] [PATTERN] seznam databází
\lo_export LOBOID SOUBOR
\lo_import SOUBOR [KOMENTÁŘ]
\lo_list
\lo_unlink LOBOID operace s "large" objekty
\o [SOUBOR] přesměrování výsledků dotazu do souboru nebo |roury
\p ukázat současný obsah paměti s dotazem
\password [UŽIVATEL] bezpečná změna hesla uživatele
\prompt [TEXT] PROMĚNÁ vyzve uživatele, aby zadal hodnotu proměnné
\pset [NAME [VALUE]] nastaví typ výpisu tabulek
(NAME := {border|columns|expanded|fieldsep|fieldsep_zero|
footer|format|linestyle|null|numericlocale|pager|
pager_min_lines|recordsep|recordsep_zero|tableattr|title|
tuples_only|unicode_border_linestyle|
unicode_column_linestyle|unicode_header_linestyle})
\q ukončení psql
\qecho [ŘETĚZEC] vypsání textu na výstup dotazů (viz. \o)
\r vyprázdnění paměti s dotazy
\s [SOUBOR] vytiskne historii nebo ji uloží do souboru
\set [PROMĚNÁ [HODNOTA]]
nastavení interní proměnné nebo bez parametrů zobrazí
seznam všech proměnných
\setenv NAME [VALUE] nastaví nebo zruší proměnnou prostředí
\sf[+] FUNCNAME zobrazí definici funkce
\sv[+] VIEWNAME zobrazí definici pohledu
\t [on|off] ukazovat pouze řádky (nyní %s)
\timing [on|off] použít sledování času u příkazů (nyní %s)
\unset JMÉNO zrušení interní proměnné
\w SOUBOR zapsání paměti s dotazem do souboru
\watch [SEC] každých SEC vteřin spusť dotaz
\x [on|off|auto] zapne rozšířený mód výstupu (nyní %s)
\z [VZOR] stejné jako \dp
border styl rámečků (číslo)
columns cílová šířka pro zalomený formát
expanded (nebo x) rozšířený výstup [on, off, auto]
fieldsep oddělovač položek pro nezarovnaný výstup (výchozí "%s")
fieldsep_zero nastaví oddělovač polí pro nezarovnaný výstup na nulový byte
footer zapne nebo vypne zobrazení zápatí tabulky [on, off]
format nastaví formát výstupu [unaligned, aligned, wrapped, html, asciidoc, ...]
linestyle nastaví styl vykreslování rámečků [ascii, old-ascii, unicode]
null nastaví řetězec vypisovaný místo null hodnoty
numericlocale zapne zobrazení lokalizovaného znaku pro oddělení
skupin číslic [on, off]
pager určuje kdy se použije externí pager [yes, no, always]
psql --pset=NAME[=VALUE]
nebo \pset NAME [VALUE] v psql
psql --set=NAME=VALUE
nebo \set NAME VALUE v psql
psql [PŘEPÍNAČE]... [DATABÁZE [UŽIVATEL]]
recordsep oddělovač záznamů (řádek) pro nezarovnaný výstup
recordsep_zero nastaví oddělovač záznamů pro nezarovnaný výstup na nulový byte
set NAME=VALUE
psql ...
nebo \setenv NAME [VALUE] v rámci psql
tableattr (or T) specifikuje attributy pro table tag v html formátu, nebo proporcionální
šířky sloupců pro datové typy zarovnávané doleva v latex-longtable formátu
title nastavuje titulek tabulky pro následně vypisované tabulky
tuples_only pokud nastaveno, jsou vypsána pouze data z tabulky
unicode_border_linestyle
unicode_column_linestyle
unicode_header_linestyle
nastaví styl Unicode rámečků [single, double]
"%s.%s" není pohled
%d spojení %d spojení %d spojení %s %s %s (každé %gs)
%s
%s (%s, server %s)
%s (každé %gs)
%s: %s
%s: -1 může být použito pouze pro neinteraktivní módy
%s: nelze kopírovat z/do adresáře
%s: nelze smazat proměnnou "%s"
%s: nelze najít vlastní spustitelný soubor
%s: nelze otevřít logovací soubor "%s": %s
%s: nelze nastavit parametr zobrazení "%s"
%s: nelze nastavit proměnnou "%s"
%s: současná transakce je nestandardně ukončena (abort)
%s: neplatné jméno kódování nebo nenalezena konverzní funkce
%s: není spojení s databází
%s: nedostatek paměti
%s: neznámý status transakce
%s: varování: nadbytečný parametr příkazové řádky "%s" ignorován
(%lu řádka) (%lu řádky) (%lu řádek) ***(Krokovací mód: potvrďte příkaz)*******************************************
%s
***(stiskněte return pro zpracování nebo x a return pro zrušení)********************
********* DOTAZ **********
%s
**************************
+ opt(%d) = |%s|
, clusterován , odložitelný , iniciálně odložený , neplatný , predikát (%s) , replica identity , tablespace: "%s" Přístupová práva Všechny parametry musí být zadány protože žádné připojení k databázi neexistuje
Datový typ parametru Asynchronní upozornění "%s" obdrženo z procesu serveru s PID %d.
Asynchronní upozornění "%s" s obsahem "%s" obdrženo ze serverového procesu s PID %d.
Atributy Dostupná nápověda:
Styl rámečků je %d.
Obejít RLS přenos dat příkazu COPY selhal: %s Call handler Nelze přidat buňku do obsahu tabulky: překročen celkový počet buněk %d.
Nelze přidat hlavičku k obsahu tabulky: překročen počet sloupců %d.
Nemohu se přihlásit Kontrola Kontrolní pravidla: Podřízené tabulky Collation Sloupec Přístupová práva k atributům Příkaz: %s
Popis: %s
Syntaxe:
%s
Složený typ "%s.%s" Spojení
Vytvoř DB Vytvoř roli CType Databáze Implicitní přístupová práva Implicitní zápatí je vypnuto.
Implicitní zápatí je zapnuto.
Implicitně? Definice Popis Cíl Slovníky Nelze nalézt extension se jménem "%s".
Nelze nalézt žádnou extension.
Nelze nalézt relaci se jménem "%s".
Nelze nalézt relaci se OID "%s".
Nelze nalézt fulltextovou konfiguraci se jménem "%s".
Nelze nalézt fulltextový parser se jménem "%s".
Vypnuté interní triggery: Vypnutá pravidla (rules): Vypnuté triggery: Vypnuté uživatelské triggery: Složky Povoleno Kódování Konec parsování Zadejte data pro kopírování následovaná novým řádkem.
Ukončete zpětným lomítkem a tečkou na samostatném řádku. Zadejte znova: Zadejte nové heslo: Událost Rozšířené zobrazení vypnuto.
Rozšířené zobrazení zapnuto.
Rozšířené zobrazení je zapnuto automaticky.
FDW volby FDW volby: (%s) Nepodařilo se.
Oddělovač polí je '"%s"'.
Oddělovač polí je nulový byte.
Foreign tabulka "%s.%s" Foreign-data wrapper Podmínky cizího klíče: Formátování
Funkce Hlavní
Základní volby:
Získej záhlaví Získej další token Získej typy tokenu Handler Má OID: ano Nápověda
ID Implicitně? Index Index "%s.%s" Indexy: Informační
Dědí Init Init options Inline handler Vstup/Výstup
Interní jazyk Interní jméno Přerušeno
Neplatný příkaz \%s. Použijte \? pro nápovědu.
Jazyk Velké objekty (LO)
Velké objekty (LO) Typ levého argumentu Lexize Styl čar je %s.
Seznam přístupových metod Seznam agregačních funkcí Seznam přetypování Seznam collations Seznam konverzí Seznam datových typů Seznam databází Seznam domén Seznam event triggerů Seznam foreign serverů Seznam foreign tabulek Seznam foreign-data wrapperů Seznam funkcí Seznam instalovaných extensions Seznam jazyků Seznam operátorů Seznam relací Seznam rolí Seznam schémat Seznam nastavení Seznam proměnných se zvláštním významem
Seznam tablespaces Seznam fulltextových konfigurací Seznam fulltextových slovníků Seznam fulltextových parserů Seznam fulltextových šablon Seznam mapování uživatelů Zobrazení číselného výstupu dle národního nastavení je vypnuto.
Zobrazení číselného výstupu dle národního nastavení je vypnuto.
Umístění Materializovaný pohled "%s.%s" Je členem Metoda Modifikátor Modifikátory Jméno Žádné změny Není spojení Nápověda pro "%s" je nedostupná.
Pomocí \h bez parametrů lze získat seznam dostupných nápověd.
Bez dědičnosti Odpovídající relace nebyla nalezena.
Odpovídající relace nebyla nalezena.
Tato verze serveru nepodporuje nastavení rolí dle databáze.
Žádné relace nenalezeny.
Žádné nastavení nenalezeno.
Null je zobrazován jako '"%s"'.
Počet podřízených tabulek: %d (Použijte \d+ pro jejich seznam.) Objekt Popis objektu Popis objektu Objekty v rozšíření "%s" Operační systém
Volby Výstupní formát je %s.
Vlastník: %s Vlastník Stránkování je vždy použito.
Stránkování je zapnuto pro dlouhé výstupy.
Stránkování je vypnuto.
Pager nebude použit pro méně než %d řáden.
Pager won't be used for less than %d lines.
Pager won't be used for less than %d lines.
Parallel Zašifrování hesla selhalo.
Heslo pro uživatele %s: Heslo platné do Heslo: Hesla se neshodují.
Politiky Poitiky (forced row security zapnuta): Politiky (forced row security zapnuta): (žádné) Politiky (row security vypnuta): Politiky (row security zapnuta): (žádné) Politiky: Předchozí spojení zachováno
Procedura Paměť dotazu
Buffer dotazů je prázdný. Buffer dotazů vyprázdněn. Oddělovač záznamů je '"%s"'.
Oddělovač záznamů je <newline>.
Oddělovač záznamů je nulový byte.
Odkazovaný: Replica Identity Replikace Chyby posílejte na adresu <pgsql-bugs@postgresql.org>.
Datový typ výsledku Typ výsledku Typ pravého argumentu Role Jméno role Vždy spouštěná pravidla: Pravidla spouštěná jen na replice: Rules: SSL spojení (protokol: %s, šifra: %s, bitů: %s, komprese: %s)
PŘÍKAZ: %s
Schéma Bezpečnost Sekvence "%s.%s" Server Server: %s Nastavení Velikost Zdroj Zdrojový kód Zdrojový typ Speciální relace "%s.%s" Začátek parsování Stats target Uložení Podařilo se.
Super-uživatel TOAST tabulka "%s.%s" Tabulka Tabulka "%s.%s" Atributy tabulky jsou "%s".
Atributy tabulky nejsou nastaveny.
Tablespace Tablespace: "%s" Tagy Cílový typ Cílová šířka je %d.
Cílová šířka není nastavena.
Šablona Fulltextová konfigurace "%s" Fulltextová konfigurace "%s.%s" Fulltextový parser "%s" Fulltextový parser "%s.%s" Spojení na server bylo ztraceno. Zkoušen restart: Na vstupu je dump v PostgreSQL "custom" formátu.
Pro obnovení této zálohy použijte klienta pg_restore pro příkazovou řádku.
Server (verze %s) nepodporuje tablespaces.
Server (verze %s) nepodporuje změny výchozích privilegií.
Server (verze %s) nepodporuje collations.
Server (verze %s) nepodporuje editaci zdrojového kódu funkce.
Server (verze %s) nepodporuje editaci definice pohledu.
Server (verze %s) nepodporuje extensions.
Server (verze %s) nepodporuje foreign servery.
Server (verze %s) nepodporuje foreign tabulky.
Server (verze %s) nepodporuje foreign-data wrappery.
Server (verze %s) nepodporuje fulltextové vyhledávání.
Server (verze %s) nepodporuje savepoints pro ON_ERROR_ROLLBACK.
Server (verze %s) nepodporuje zobrazování zdrojového kódu funkce.
Server (verze %s) nepodporuje zobrazování definice pohledu.
Server (verze %s) nepodporuje tablespaces.
Server (verze %s) nepodporuje mapování uživatelů.
Žádná předchozí chyba. Čas: %.3f ms
Sledování času je vypnuto. Sledování času je zapnuto. Nadpis je "%s".
Nadpis není nastaven.
Token Jméno tokenu Typ tokenu pro parser "%s" Jméno tokenu pro parser "%s.%s" Vždy spouštěné triggery: Triggery spouštěné jen na replice: Triggery: Důvěryhodný Zkuste "%s --help" pro více informací.
Zobrazování pouze záznamů je vypnuto.
Zobrazování pouze záznamů je vypnuto.
Typ Pro získání nápovědy napište "help".
Pište: \copyright pro podmínky distribuce
\h pro nápovědu k SQL příkazům
\? pro nápovědu k psql příkazům
\g nebo středník pro ukončení SQL příkazů
\q pro ukončení programu
Typovaná tabulka typu: %s Styl Unicode rámečků je "%s".
Styl Unicode sloupců je "%s".
Styl Unicode rámečků záhlaví je "%s".
Unlogged index "%s.%s" Unlogged materializovaný pohled "%s.%s" Unlogged tabulka "%s.%s" Použití:
Použijte "\q" pro odchod z %s.
Uživatelské jméno Validátor Hodnota Proměnné
Verze Pohled "%s.%s" Definice pohledu: Volatilita VAROVÁNÍ: %s major verze %s, major verze serveru %s.
Některé vlastnosti psql nemusí fungovat.
VAROVÁNÍ: Kódová stránka konzole (%u) není shodná s kódovou stránkou
Windows (%u) 8-bitové znaky nemusí fungovat správně. Další
informace najdete v manuálu k psql na stránce "Poznámky pro
uživatele Windows."
Historie zapsána do souboru: "%s".
Nyní jste připojeni k databázi "%s" jako uživatel "%s" na serveru "%s" na portu"%s".
Jste připojeni k databázi "%s" jako uživatel "%s" přes socket v "%s" naportu "%s".
Aktuálně nejste připojeni k databázi.
Nyní jste připojeni k databázi "%s" jako uživatel "%s" na serveru "%s" na portu"%s".
You are now connected to database "%s" as user "%s" via socket in "%s" at port "%s".
Nyní jste připojeni k databázi "%s" jako uživatel "%s".
Používáte psql, řádkový nástroj pro připojení k PostgreSQL. \!: selhal
\%s: nelze změnit adresář na "%s": %s
\%s: název proměnné prostředí nesmí obsahovat '='
\%s: chyba při nastavování proměnné
\%s: nadbytečný argument "%s" ignorován
\%s: chybí požadovaný argument
\connect: %s \copy: argumenty jsou povinné
\copy: chyba na "%s"
\copy: chyba na konci řádku
\crosstabview: nejednoznačný název sloupce: "%s"
\crosstabview: sloupec nenaleze: "%s"
\crosstabview: číslo sloupce %d je mimo rozsah 0..%d
\crosstabview: datový sloupec musí být specifikován pokud má dotaz více než tři sloupce
\crosstabview: maximální počet sloupců (%d) překročen
\crosstabview: dotaz musí vracet alespoň tři sloupce
\crosstabview: výsledek dotazu obsahuje několik hodnot pro řádek "%s", sloupec "%s"
\crosstabview: příkaz nevrátil žádný výsledek
\crosstabview: vertikální a horozintální záklaví musí být různé sloupce
pro \df nelze použít volbu "w" ve verzi serveru %s.
pro \df můžete použít pouze přepínače [antwS+]
\pset: povolené styly Unicode rámečků jsou single, double
\pset: povolené styly Unicode sloupců jsou single, double
\pset: povolené styly Unicode rámečků záhlaví single, double
\pset: dovolené formáty jsou: unaligned, aligned, wrapped, html, asciidoc, latex, latex-longtable, troff-ms
\pset: povolené styly řádek jsou ascii, old-ascii, unicode
\pset: neznámá volba: %s
\watch nelze použít s COPY
\watch neze použít s prázdným dotazem
zkrácený_grant_nebo_revoke nestandardní ukončení (abort) současné transakce přerušeno z důvodu chyby čtení access_method_type akce agg aggregate_name aggregate_signature alias zarovnání allowconn vždy analyze_funkce a aggregate_signature je: a conflict_action je jedno z: a grouping_element může být jedno z: a like_volba je: a omezení_tabulky je: a omezení_tabulky_s_využitím_indexu je: a with_dotaz je: arg_data_type jméno_argumentu typ_argumentu mód_argumentu jméno_argumentu typ_argumentu argument typ_argumentu argumenty atribut jméno_atributu volba_atributu základní_typ boolean cache call_handler zruší transakci, která byla připravena pro dvoufázový commit zrušeno na žádost uživatele nelze duplikovat null pointer (interní chyba)
nelze escapovat bez aktivního spojení
kanonická_funkce kategorie změní databázi změní databázovou roli změní parametry běhu změní serverový konfigurační parametr změní jméno role nebo členství změní definici collation změna definice konverze změní definici domény změní definici foreign serveru změní definici foreign tabulky změní definici foreign-data wrapperu změní definici funkce změní definici large objektu změní definici materializovaného pohledu změní definici procedurálního jazyka změní definici row level security politiky změní definici pravidla změní definici schématu změní definici generátoru sekvencí změní definici tabulky změní definici tablespace změní definici konfigurace fulltextového vyhledávání změní definici slovníku pro fulltextové vyhledávání změní definici parseru pro fulltextové vyhledávání změní definici šablony pro fulltextové vyhledávání změní definici triggeru změní definici datového typu změní definici mapování uživatelů změní definici pohledu změna definice agregátní funkce změní definici event triggeru změna definice extension změní definici indexu změní definici operátoru změní definici třídy operátorů změní definici rodiny operátorů změní vlastníka databázových objektů vlastněných databázovou rolí kanál check_expression potomek skončil s návratovým kódem %d potomek skončil s nerozponaným stavem %d potomek byl ukončen výjimkou 0x%X potomek byl ukončen signálem %d: %s uzavře kursor přerovná obsah tabulky dle indexu kód collatable collate %s collation shromáždí statistické informace o databázi alias_sloupce omezení_sloupce definice_sloupce jméno_sloupce typ_sloupce com_op combinefunc příkaz příkaz není spustitelný příkaz nenalezen potvrzení aktuální transakce, která byla již dříve připravena pro dvoufázový commit potvrzení aktuální transakce spočítá množinu řádek podmínka konfigurační_parametr conflict_action conflict_target spojení na server bylo ztraceno
connlimit omezení jméno_omezení kopíruje data mezi souborem a tabulkou nelze změnit adresář na "%s" : %s nelze zavřít rouru (pipe) pro externí příkaz: %s
nelze spustit příkaz "%s": %s
nelze najít příkaz "%s" ke spuštění nelze získat domácí adresář pro uživatele ID %ld: %s
nelze získat aktuální adresář: %s nelze najít dočasný adresář: %s
nelze načíst efektivní user ID "%ld": %s nelze otevřít dočasný soubor "%s": %s
nelze naparsovat pole reloptions
nelze číst binární soubor "%s" nelze číst vstupní soubor: %s
nelze číst symbolický link "%s" nelze uložit historii do souboru "%s": %s
nelze nastavit proměnnou "%s"
nelze spustit /bin/sh
nelze spustit editor "%s"
nelze provést stat souboru "%s": %s
nelze zapsat data příkazu COPY: %s
počet vytvoří novou databázi přidá nové řádky do tabulky jméno_kurzoru datový_typ jméno_databáze dealokuje připravený dotaz (prepared statement) implicitní implicitně %s implicitní_výraz definuje kursor definuje novou přístupovou metodu definuje novou agrefunkci definuje nové přetypování definuje novou collation definuje nový datový typ definuje novou databázovou roli definuje novou atributovou doménu definuje novou konverzi kódování definuje nový event trigger definuje nový foreign server definuje nový foreign tabulku definuje nový foreign-data wrapper definuje novou funkci definuje nový index definuje nové mapování uživatele na vzdálený server definuje nový materializovaný pohled definuje nový operátor definuje novou třídu operátorů definuje novou rodinu operátorů definuje nový procedurální jazyk definuje nové přepisovací pravidlo (rule) definute novou row level security politiku pro tabulku definuje nový savepoint uvnitř aktuální transakce definuje nové schéma definuje nový generátor sekvencí definuje novou tabulku definuje novou tabulku dle výsledku dotazu definuje nový tablespace definuje novou konfiguraci fulltextového vyhledávání definuje nový slovník pro fulltextové vyhledávání definuje nový parser pro fulltextové vyhledávání definuje novou šablonu pro fulltextové vyhledávání definuje novou transformaci definuje nový trigger definuje nový pohled definuje přístupová práva definuje výchozí přístupová práva definuje nebo změní bezpečnostní štítek aplikovaný na objekt definuje nebo změní komentář objektu definer definice delete smaže řádky z takulky oddělovač oddělovací_znak deserialfunc kódování_cíle odstraní dříve vytvořený savepoint jméno_slovníku směr adresář disabled zahodí stav session omezení domény omezení_domény jméno_domény prvek zruší obsah tabulky nebo skupiny tabulek povoleno kódování název_kódování end_function proměnná prostředí PSQL_EDITOR_LINENUMBER_ARG musí být nastavena pro zadáníčísla řádky
escape_character událost exclude_element exclude_element v EXCLUDE omezení je: provede připravený dotaz (prepared statement) spustí anonymní blok kódu execution_cost existující_collation existing_enum_value výraz název_extension family_name fdw_jméno ffunc jméno_souboru filter_variable pro tabulku "%s.%s" vynutí checkpoint transakčního logu foreign_tabulka jméno_formátu z_položky from_sql_function_name funkce je vyžadováno jméno funkce
jméno_funkce provede úklid a případně analýzu databáze generuje upozornění gettoken_funkce group_name grouping_element handler_function headline_funkce historie není podporována pro tuto instalaci
immutable importuje definice tabulek z foreign serveru v přiřazení inkrement index index_column_name index_expression metoda_indexování jméno_indexu parametry_indexu parametry_indexu v UNIQUE, PRIMARY KEY, a EXCLUDE omezeních jsou: index_predicate init_funkce výchozí_podmínka inline_handler vstupní_funkce insert instaluje rozšíření integer interní_délka neplatný binární soubor"%s" neplatný příkaz \%s
neplatné číslo řádky: %s
specifikován neplatný formát výstupu (interní chyba): %d invoker istemplate joinovací_sloupec joinovací_podmínka join_proc typ_joinu popisek jméno_jazyka oid_large_objektu lc_collate lc_ctype levý_typ lexize_funkce lextypes_funkce like_volba like_typ link_symbol naslouchá upozorněním načte sdílenou knihovnu lokální soket local_schema locale zamkne uvedenou relaci (tabulku, etc) mód_zámku loid materializovaný pohled max_hodnota členský_objekt metoda mffunc minitial_condition min_hodnota minvfunc více než jedna řádka vrácena pro \gset
msfunc mstate_data_size mstate_data_type jméno neg_op nové_jméno_atributu nové_jméno_sloupce jméno_nového_omezení nový_slovník nová_enum_hodnota nové_jméno nový_vlastník nová_role nové_schéma nová_tabulka nový_tablespace nová_verze ne v historii není žádný dotaz
žádné řádky nevráceny pro \gset
normal not null null_string obj_file jméno_objektu vypnuto starý_slovník stará_role stará_verze zapnuto typ_operátoru třída_operátoru operátor třída operátorů rodina operátorů jméno_operátoru volba nebo stará syntaxe nedostatek paměti nedostatek paměti
výstupní_výraz výstupní_funkce výstupní_jméno parametr nadřízená_tabulka jméno_parseru heslo náklad volání pclose selhalo: %s policy_name přemístí kursor predikát preferovaný připraví a uloží dotaz pro provedení přípraví aktuální transakci pro dvoufázoví commit primární klíč, provider psql je PostgreSQL interaktivní terminál.
psql proměnné:
dotaz quote_character znovuvytvoří indexy receive_funkce odkazovaný_sloupec jméno_odkazované_tabulky odkazovaná_tabulka název_relace remote_schema odstraní definici přetypování odstraní collation odstraní konverzi odstraní datový typ odstraní databázi odstraní databázovou roli odstraní doménu odstraní deskriptor foreign serveru odstraní foreign tabulku odstraní foreign-data wrapper odstraní funkci odstraní materializovaný pohled odstraní procedurální jazyk odstraní přepisovací pravidlo (rule) odstraní row level security politiku z tabulky odstraní schéma odstraní sekvenci odstraní tabulku odstraní tablespace odstraní konfiguraci fulltextového vyhledávání odstraní slovn?ik pro fulltextové vyhledávání odstraní parser pro fulltextové vyhledávání odstraní Šablonu fulltextového vyhledávání odstraní transformaci odstraní trigger odstraní mapování uživatele z foreign serveru odstraní náhled odstraní přístupová práva odstraní definici přístupové metody odstraní agregační funkci odstraní event trigger odstraní extension odstraní index odstraní operátor odstraní třídu operátorů odstraní rodinu operátorů odstraní objekty vlastněné databázovou rolí nahraď obsah materializovaného pohledu replica res_proc restart přenastaví parametr běhu na implicitní hodnotu restricted výsledné_řádky načte řádky z výsledku dotazu pomocí kursoru vybere řádky z tabulky nebo náhledu návratový_typ přepisovací_pravidlo pravý_typ jméno_role role_specification vrátí se na savepoint rule jméno_pravidla safe sampling_method jméno_savepointu prvek_schématu jméno_schématu seed select send_funkce sekvence sekvence serialfunc jméno_serveru typ_serveru verze_serveru nastaví mód kontroly omezení (constraints) pro aktuální transakci nastaví charakteristiku pro aktualní trasakci nastaví uživatelský identifikátor aktuální session nastaví uživatelský identifikátor session a identifikátor aktuálníhouživatele pro aktuální session sfunc ukáže prováděcí plán dotazu zobrazí hodnoty run-time parametrů přeskakuji rekursivní expanzi proměnné "%s"
snapshot_id sort_expression sort_family_name operátor_třídění source_config kódování_zdroje zdrojová_tabulka zdrojový_typ speciální stable start nastartuje nový transakční blok start_funkce state_data_size datový_typ_stavu příkaz ukončí naslouchání připomínkám uložení parametr_uložení typ_uložení číslo_strategie sub-SELECT subtyp diff_funkce_subtypu třída_operátorů_subtypu support_number tab completion dotaz selhal: %s
Dotaz byl:
%s
tabulka omezení tabulky omezení_tabulky omezení_tabulky_s_využitím_indexu jméno_tabulky jméno_tablespace volba_tablespace cílová_role cílový_typ šablona text timestamp časová_zóna to_sql_function_name typ_tokenu id_transakce transakční_mód trigger jméno_triggeru pokouším se opustit copy mód typ type_modifier_input_function type_modifier_output_function jméno_typu uid neočekávaný PQresultStatus: %d
neočekávaný stav výsledku pro \watch
neočekávaný stav transakce: (%d)
unikátní, neznámé nerozpoznaná hodnota "%s" pro "%s": předpokládám "%s"
unsafe neukončený řetězec v uvozovkách
update aktualizuje řádky tabulky uživatel neexistuje vyhledávání uživatele selhalo: chybový kód %lu uživatel using_expression valfunction validator_function hodnota hodnoty verze pohled je vyžadováno jméno pohledu
název_volby_pohledu hodnota_volby_pohledu volatile kde zkrácený_grant_nebo_revoke je jedno z: kde akce je jedno z: kde aggregate_signature je: kde omezení_sloupce je: where conflict_target can be one of: kde omezení je: kde směr může být prázdný nebo jedno z: kde událost může být jedno z: kde z_položky může být jedno z: kde mód_zámku je jedno z: kde členský_objekt je: kde volba je jedno z: kde volba může být: kde role_specification může být: kde transakční_mód je jedno z: window definice_okna jméno_okna with_dotaz jméno_with_dotazu ano locale/cs/LC_MESSAGES/pg_rewind-9.6.mo 0000644 00000046437 14751153421 0013043 0 ustar 00 �� � $ � ,
�
- �
1 �
? K I C � ; � C 9 Y G � @ � O ( x � � � � � J � > I , � 6 � < � 1 ) ? [ = � = � 9 D Q 4 � 9 � 4 2 : @ m R � > @ G 1 h � � � � o � d Z - � 4 � & " I � c P � R 7 c � - � ; / Y ; � � � � # ? % ^ � $ � + � � $ L 8 , � 0 � " � ) , 0 ] $ { $ � # � ' � " 4 " R & u $ � � ( �
" + ' N v � � � 2 � ' 9 a / � - � � 6 � 3 ; H ) � � + � % � ! 3! ! Q! 3 s! 6 �! 1 �! " ' /" < W" _ �" �" # ! # F 9# �# �# �# 1 �# C �# " A$ . d$ # �$ > �$ 6 �$ 3 -% 6 a% 0 �% �% + �% & & 7& X& ! w& ( �& I �& $ ' ' 1' Y' - v' J �' = �' A -( 6 o( 5 �( 5 �( ! ) 7 4) / l) 6 �) 1 �) - * 9 3* � m* 5 8, 5 n, L �, ` �, O R- J �- Q �- J ?. L �. G �.
/ Z */ �/ �/ �/ �/ �/ 0 H 0 D [0 + �0 8 �0 C 1 5 I1 A 1 B �1 J 2 A O2 Q �2 G �2 @ +3 N l3 N �3 H
4 \ S4 H �4 �4 - 5 6 05 g5 x5 �5 �5 t �5 b 56 / �6 ; �6 ) 7 .7 � L7 c �7 e ?8 b �8 3 9 ' <9 d9 / �9 7 �9 �9 �9 : # ?: c: ) �: �: # �: . �: " "; ) E; T o; 0 �; 3 �; # )< , M< : z< �< * �< ) = $ += ( P= # y= �= ! �= , �= #
> .> + O> 0 {> 6 �> 9 �> ? 8? U? v? 1 �? % �? 0 �? @ 6 4@ < k@ �@ : �@ A = A . ^A �A 0 �A % �A B # B ' AB 5 iB < �B = �B " C ( =C R fC c �C D 4D " HD A kD �D ' �D & �D 1 E A NE 0 �E 5 �E $ �E Q F 7 nF 6 �F 8 �F 8 G ) OG - yG 4 �G $ �G 0 H - 2H , `H O �H ( �H 2 I ( 9I 9 bI Z �I Q �I M IJ B �J I �J H $K mK J �K < �K E L D \L > �L > �L � & 5 � Y | � � � [ > r ! p � J } � � % < d U � 1 { y : � u . i F
f R 6 � b � 8 k I ( l _ q � � � A 9 � t # � � 0 $ 3 � � � ` P h � x � ~ ) � ]
C w L E ? g 2 a Q c s � / m @ � ; � S X v T + e M z ^ K � H N G 4 O j = � � Z ' o , W - � � D B V \ " * � 7 n �
Report bugs to <pgsql-bugs@postgresql.org>.
creating backup label and updating control file
--debug write a lot of debug messages
--source-pgdata=DIRECTORY source data directory to synchronize with
--source-server=CONNSTR source server to synchronize with
-?, --help show this help, then exit
-D, --target-pgdata=DIRECTORY existing data directory to modify
-P, --progress write progress messages
-V, --version output version information, then exit
-n, --dry-run stop before modifying anything
block %u
"%s" is a symbolic link, but symbolic links are not supported on this platform
"%s" is not a directory
"%s" is not a regular file
"%s" is not a symbolic link
%*s/%s kB (%d%%) copied %d: %X/%X - %X/%X
%s (%s)
%s resynchronizes a PostgreSQL cluster with another copy of the cluster.
%s: WARNING: cannot create restricted tokens on this platform
%s: could not allocate SIDs: error code %lu
%s: could not create restricted token: error code %lu
%s: could not get exit code from subprocess: error code %lu
%s: could not open process token: error code %lu
%s: could not re-execute with restricted token: error code %lu
%s: could not start process for command "%s": error code %lu
%s: no source specified (--source-pgdata or --source-server)
%s: no target data directory specified (--target-pgdata)
%s: only one of --source-pgdata or --source-server can be specified
%s: too many command-line arguments (first is "%s")
BKPBLOCK_HAS_DATA not set, but data length is %u at %X/%X BKPBLOCK_HAS_DATA set, but no data included at %X/%X BKPBLOCK_SAME_REL set but no previous rel at %X/%X BKPIMAGE_HAS_HOLE not set, but hole offset %u length %u at %X/%X BKPIMAGE_HAS_HOLE set, but hole offset %u length %u block image length %u at %X/%X BKPIMAGE_IS_COMPRESSED set, but block image length %u at %X/%X Done!
Expected a numeric timeline ID.
Expected a transaction log switchpoint location.
Failure, exiting
Options:
Source timeline history:
Target timeline history:
The program "initdb" is needed by %s but was
not found in the same directory as "%s".
Check your installation.
The program "initdb" was found by "%s"
but was not the same version as %s.
Check your installation.
Timeline IDs must be in increasing sequence.
Timeline IDs must be less than child timeline's ID.
Try "%s --help" for more information.
Usage:
%s [OPTION]...
WAL file is from different database system: WAL file database system identifier is %s, pg_control database system identifier is %s WAL file is from different database system: incorrect XLOG_BLCKSZ in page header WAL file is from different database system: incorrect XLOG_SEG_SIZE in page header WAL record modifies a relation, but record type is not recognized
lsn: %X/%X, rmgr: %s, info: %02X
You must run %s as the PostgreSQL superuser.
backup label buffer too small
cannot be executed by "root"
cannot duplicate null pointer (internal error)
clusters are not compatible with this version of pg_rewind
connected to server
contrecord is requested by %X/%X could not clear search_path: %s could not close directory "%s": %s
could not close file "%s": %s
could not close target file "%s": %s
could not connect to server: %s could not create directory "%s": %s
could not create symbolic link at "%s": %s
could not fetch file list: %s could not fetch remote file "%s": %s could not find common ancestor of the source and target cluster's timelines
could not find previous WAL record at %X/%X
could not find previous WAL record at %X/%X: %s
could not open directory "%s": %s
could not open file "%s" for reading: %s
could not open file "%s" for truncation: %s
could not open file "%s": %s
could not open source file "%s": %s
could not open target file "%s": %s
could not read WAL record at %X/%X
could not read WAL record at %X/%X: %s
could not read directory "%s": %s
could not read file "%s": %s
could not read from file "%s": %s
could not read symbolic link "%s": %s
could not remove directory "%s": %s
could not remove file "%s": %s
could not remove symbolic link "%s": %s
could not seek in file "%s": %s
could not seek in source file: %s
could not seek in target file "%s": %s
could not send COPY data: %s could not send end-of-COPY: %s could not send file list: %s could not send query: %s could not set libpq connection to single row mode
could not stat file "%s": %s
could not truncate file "%s" to %u: %s
could not write file "%s": %s
data file "%s" in source is not a regular file
error running query (%s) in source server: %s fetched file "%s", length %d
full_page_writes must be enabled in the source server
getting file chunks
incorrect resource manager data checksum in record at %X/%X invalid action (CREATE) for regular file
invalid block_id %u at %X/%X invalid compressed image at %X/%X, block %d invalid contrecord length %u at %X/%X invalid control file
invalid data in history file
invalid data in history file: %s
invalid info bits %04X in log segment %s, offset %u invalid magic number %04X in log segment %s, offset %u invalid record length at %X/%X: wanted %u, got %u invalid record offset at %X/%X invalid resource manager ID %u at %X/%X need to copy %lu MB (total source directory size is %lu MB)
neither BKPIMAGE_HAS_HOLE nor BKPIMAGE_IS_COMPRESSED set, but block image length is %u at %X/%X no rewind required
out of memory
out-of-order block_id %u at %X/%X out-of-sequence timeline ID %u (after %u) in log segment %s, offset %u reading WAL in target
reading source file list
reading target file list
received chunk for file "%s", offset %s, size %d
received null value for chunk for file "%s", file has been deleted
record length %u at %X/%X too long record with incorrect prev-link %X/%X at %X/%X record with invalid length at %X/%X rewinding from last common checkpoint at %X/%X on timeline %u
servers diverged at WAL position %X/%X on timeline %u
source and target cluster are on the same timeline
source and target clusters are from different systems
source data directory must be shut down cleanly
source file list is empty
source server must not be in recovery mode
symbolic link "%s" target is too long
sync of target directory failed
syncing target data directory
syntax error in history file: %s
target server must be shut down cleanly
target server needs to use either data checksums or "wal_log_hints = on"
there is no contrecord flag at %X/%X unexpected EOF while reading file "%s"
unexpected control file CRC
unexpected control file size %d, expected %d
unexpected data types in result set while fetching remote files: %u %u %u
unexpected null values in result while fetching remote files
unexpected page modification for directory or symbolic link "%s"
unexpected pageaddr %X/%X in log segment %s, offset %u unexpected result format while fetching remote files
unexpected result length while fetching remote files
unexpected result set from query
unexpected result set size while fetching remote files
unexpected result set while fetching file list
unexpected result set while fetching remote file "%s"
unexpected result while fetching remote files: %s unexpected result while sending file list: %s unrecognized result "%s" for current WAL insert location
Project-Id-Version: pg_rewind (PostgreSQL) 11
Report-Msgid-Bugs-To: pgsql-bugs@postgresql.org
POT-Creation-Date: 2019-09-27 15:38+0000
PO-Revision-Date: 2019-09-27 22:52+0200
Last-Translator:
Language-Team:
Language: cs
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Plural-Forms: nplurals=3; plural=(n==1) ? 0 : (n>=2 && n<=4) ? 1 : 2;
X-Generator: Poedit 2.2.3
X-Poedit-Bookmarks: -1,-1,-1,-1,-1,-1,-1,-1,-1,17
Chyby hlaste na adresu <pgsql-bugs@postgresql.org>.
vytvářím backup label a aktualizuji control file
--debug vypisovat mnoho zpráv s debug informacemi
--source-pgdata=ADRESÁŘ zdrojový datový adresář proti kterému se synchronizovat
--source-server=CONNSTR zdrojový server se kterým se synchronizovat
-?, --help vypíše tuto nápovědu, poté skončí
-D, --target-pgdata=ADRESÁŘ existující datový adresář pro modifikaci
-P, --progress průběžně vypisovat zprávy o postupu
-V, --version vypíše informaci o verzi, poté skončí
-n, --dry-run zastavit před modifikací čehokoliv
blok %u
"%s" je symbolický odkaz, ale symbolické odkazy nejsou na této platformě podporovány
"%s" není adresář
"%s" není obyčejný soubor
"%s" není symbolický odkaz
%*s/%s kB (%d%%) zkopírováno %d: %X/%X - %X/%X
%s (%s)
%s resynchronizuje PostgreSQL cluster s jinou kopií daného clusteru.
%s: WARNING: na této platformě nelze vytvářet vyhrazené tokeny
%s: nelze alokovat SIDs: chybový kód %lu
%s: nelze vytvořit vyhrazený token: chybový kód %lu
%s: nelze získat návratový kód z podprovesu: chybový kód %lu
%s: nelze otevřít token procesu: chybový kód %lu
%s: nelze znovu spustit s vyhrazeným tokenem: chybový kód %lu
%s: nelze nastartovat proces pro příkaz "%s": chybový kód %lu
%s: nespecifikován žádný zdroj (--source-pgdata nebo --source-server)
%s: cílový datový adresář nespecifikován (--target-pgdata)
%s: pouze jedna z voleb --source-pgdata nebo --source-server může být zadána
%s: příliš mnoho argumentů v příkazové řádce (první je "%s")
BKPBLOCK_HAS_DATA flag nenastaven, ale délka dat je %u na %X/%X BKPBLOCK_HAS_DATA flag nastaven, ale žádná data nejsou přiložena na %X/%X BKPBLOCK_SAME_REL flag nastaven, ale žádná předchozí rel hodnota na %X/%X BKPIMAGE_HAS_HOLE flag nenastaven, ale hole offset %u length %u na %X/%X BKPIMAGE_HAS_HOLE flag nastaven, ale hole offset %u length %u block image length %u na %X/%X BKPIMAGE_IS_COMPRESSED flag nastaven, ale block image length %u na %X/%X Hotovo!
Očekávána číselná hodnota timeline ID.
Očekávána pozice pro switchpoint write-ahead logu.
Chyba, končím
Přepínače:
Zdrojová timeline history:
Cílová timeline history:
Program "initdb" je vyžadován %s ale nebyl
nalezen ve stejném adresáři jako "%s".
Zkontrolujte svou instalaci.
Program "initdb" byl nalezen "%s"
ale nemá stejnou verzi jako "%s".
Zkontrolujte svou instalaci.
Timeline IDs musí být rostoucí posloupnost.
Timeline IDs musí být nižší než timeline ID potomka.
Zkuste "%s --help" pro více informací.
Použití:
%s [OPTION]...
WAL soubor je z jiného databázového systému: systémový identifikátor z WAL souboru je %s, systémový identifikátor z pg_control je %s WAL soubor je z jiného databázového systému: neplatná hodnota XLOG_BLCKSZ v hlavičce stránky WAL soubor je z jiného databázového systému: neplatná hodnota XLOG_SEG_SIZE v hlavičce stránky WAL záznam modifikuje relaci, ale typ záznamu není rozpoznán
lsn: %X/%X, rmgr: %s, info: %02X
Musíte spustit %s jako PostgreSQL superuživatel.
backup label buffer je příliš malý
nelze spouštět jako "root"
nelze duplikovat null pointer (interní chyba)
clustery nejsou kompatibilní s touto verzí pg_rewind
připojen k serveru
contrecord je vyžadován %X/%X nelze vyčistit search_path: %s nelze uzavřít adresář "%s": %s
nelze uzavřít soubor "%s": %s
nelze uzavřít cílový soubor "%s": %s
nelze se připojit k serveru: %s nelze vytvořit adresář "%s": %s
nelze vytvořit symbolický odkaz na "%s": %s
nelze načíst seznam souborů: %s nelze načíst vzdálený soubor "%s": %s nelze najít společného předka pro timeline ze zdrojového a cílového clusteru
nelze načíst předchozí WAL záznam na %X/%X
nelze nalézt předchozí WAL záznam na %X/%X: %s
nelze otevřít adresář "%s": %s
nelze otevřít soubor "%s" pro čtení: %s
nelze otevřít soubor "%s" pro zkrácení (truncate): %s
nelze otevřít soubor "%s": %s
nelze otevřít zdrojový soubor "%s": %s
nelze otevřít cílový soubor "%s": %s
nelze načíst WAL záznam na %X/%X
nelze načíst WAL záznam na %X/%X: %s
nelze číst z adresáře "%s": %s
nelze číst soubor "%s": %s
nelze číst ze souboru "%s": %s
nelze přečíst symbolický odkaz "%s": %s
nelze odstranit adresář "%s": %s
nelze odstranit soubor "%s": %s
nelze odstranit symbolický odkaz "%s": %s
nelze nastavit pozici (seek) v souboru "%s": %s
nelze změnit pozici (seek) ve zdrojovém souboru: %s
nelze změnit pozici (seek) v cílovém souboru "%s": %s
nelze poslat COPY data: %s nelze poslat end-of-COPY: %s nelze poslat seznam souborů: %s nelze zaslat dotaz: %s nelze nastavit libpq spojení na single row mód
nelze přistoupit k souboru "%s": %s
nelze zkrátit (truncate) soubor "%s" na %u: %s
nelze zapsat soubor "%s": %s
datový soubor "%s" ve zdroji není obyčejný soubor
chyba při spuštění dotazu (%s) na zdrojovém serveru: %s načten soubor "%s", délka %d
full_page_writes musí být zapnuty na zdrojovém serveru
načítám části souborů
neplatný data checksum resource managera v záznamu na %X/%X neplatná akce (CREATE) pro obyčejný soubor
neplatné block_id %u na %X/%X neplatný komprimovaný image na %X/%X, block %d chybná contrecord délka %u na %X/%X neplatný control soubor
chybná data v souboru s historií
chybná data v souboru s historií: %s
neplatné info bity %04X v log segmentu %s, offset %u neplatné magické číslo %04X v log segmentu %s, offset %u neplatná délka záznamu na %X/%X: potřeba %u, získáno %u neplatný offset záznamu na %X/%X chybný ID resource managera %u na %X/%X je třeba zkopírovat %lu MB (celková velikost zdrojového adresáře je %lu MB)
BKPIMAGE_HAS_HOLE ani BKPIMAGE_IS_COMPRESSED flag nenastaven, ale block image length je %u na %X/%X rewind není potřeba
nedostatek paměti
block_id %u mimo pořadí na %X/%X timeline ID %u mimo pořadí (po %u) v log segmentu %s, offset %u čtu WAL na cílovém clusteru
načítám seznam zdrojových souborů
načítám seznam cílových souborů
přijat chunk souboru "%s", offset %s, délka %d
přijata null hodnota pro chunk souboru "%s", soubor byl smazán
délka záznamu %u na %X/%X je příliš vysoká záznam s neplatnou hodnotou prev-link %X/%X na %X/%X záznam s neplatnou délkou na %X/%X provádím rewind z posledního společného checkpointu na %X/%X na timeline %u
servery se rozešly na WAL pozici %X/%X na timeline %u
zdrojový a cílový cluster jsou na stejné timeline
zdrojový a cílový cluster jsou z různých systémů
zdrojový datový adresář musí být zastaven čistě
seznam zdrojových souborů je prázdný
zdrojový server musí být v recovery módu
cíl symbolického odkazu "%s" je příliš dlouhý
sync na cílovém adresáři selhal
provádím sync cílového datového adresáře
syntaktická chyba v souboru s historií: %s
cílový server musí být zastaven čistě
cílový server musí používat buď data checksums nebo "wal_log_hints = on"
na %X/%X není nastaven contrecord flag neočekávaný znak EOF při čtení souboru "%s"
neočekávaná CRC hodnota control file
neočekávaná velikost control file %d, očekáváno %d
neočekávané datové typy ve vysledku při načítání vzdálených souborů: %u %u %u
neočekávané null hodnoty ve výsledku při načítání vzdálených souborů
neočekávaná modifikace stránky pro adresář nebo symbolický odkaz "%s"
neočekávaná pageaddr hodnota %X/%X v log segmentu %s, offset %u neočekávaný formát výsledku při načítání vzdálených souborů
neočekávaná délka výsledku při načítání vzdálených souborů
neočekávaný výsledek dotazu
neočekávaná velikost výsledku při načítání vzdálených souborů
neočekávaný výsledek při načítání seznamu souborů
neočekávaný výsledek při načítání vzdáleného souboru "%s"
neočekávaný výsledek při načítání vzdálených souborů: %s neočekávaný výsledek při posílání seznamu souborů: %s nerozpoznaný výsledek "%s" pro aktuální WAL insert pozici
man/man1/pg_upgrade.1 0000644 00000056036 14751153421 0010367 0 ustar 00 '\" t
.\" Title: pg_upgrade
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "PG_UPGRADE" "1" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
pg_upgrade \- upgrade a PostgreSQL server instance
.SH "SYNOPSIS"
.HP \w'\fBpg_upgrade\fR\ 'u
\fBpg_upgrade\fR \fB\-b\fR \fIoldbindir\fR \fB\-B\fR \fInewbindir\fR \fB\-d\fR \fIolddatadir\fR \fB\-D\fR \fInewdatadir\fR [\fIoption\fR...]
.SH "DESCRIPTION"
.PP
pg_upgrade
(formerly called
pg_migrator) allows data stored in
PostgreSQL
data files to be upgraded to a later
PostgreSQL
major version without the data dump/reload typically required for major version upgrades, e\&.g\&., from 8\&.4\&.7 to the current major release of
PostgreSQL\&. It is not required for minor version upgrades, e\&.g\&., from 9\&.0\&.1 to 9\&.0\&.4\&.
.PP
Major PostgreSQL releases regularly add new features that often change the layout of the system tables, but the internal data storage format rarely changes\&.
pg_upgrade
uses this fact to perform rapid upgrades by creating new system tables and simply reusing the old user data files\&. If a future major release ever changes the data storage format in a way that makes the old data format unreadable,
pg_upgrade
will not be usable for such upgrades\&. (The community will attempt to avoid such situations\&.)
.PP
pg_upgrade
does its best to make sure the old and new clusters are binary\-compatible, e\&.g\&., by checking for compatible compile\-time settings, including 32/64\-bit binaries\&. It is important that any external modules are also binary compatible, though this cannot be checked by
pg_upgrade\&.
.PP
pg_upgrade supports upgrades from 8\&.4\&.X and later to the current major release of
PostgreSQL, including snapshot and alpha releases\&.
.SH "OPTIONS"
.PP
pg_upgrade
accepts the following command\-line arguments:
.PP
\fB\-b\fR \fIbindir\fR
.br
\fB\-\-old\-bindir=\fR\fIbindir\fR
.RS 4
the old PostgreSQL executable directory; environment variable
\fBPGBINOLD\fR
.RE
.PP
\fB\-B\fR \fIbindir\fR
.br
\fB\-\-new\-bindir=\fR\fIbindir\fR
.RS 4
the new PostgreSQL executable directory; environment variable
\fBPGBINNEW\fR
.RE
.PP
\fB\-c\fR
.br
\fB\-\-check\fR
.RS 4
check clusters only, don\*(Aqt change any data
.RE
.PP
\fB\-d\fR \fIdatadir\fR
.br
\fB\-\-old\-datadir=\fR\fIdatadir\fR
.RS 4
the old cluster data directory; environment variable
\fBPGDATAOLD\fR
.RE
.PP
\fB\-D\fR \fIdatadir\fR
.br
\fB\-\-new\-datadir=\fR\fIdatadir\fR
.RS 4
the new cluster data directory; environment variable
\fBPGDATANEW\fR
.RE
.PP
\fB\-j \fR\fB\fInjobs\fR\fR
.br
\fB\-\-jobs=\fR\fB\fInjobs\fR\fR
.RS 4
number of simultaneous processes or threads to use
.RE
.PP
\fB\-k\fR
.br
\fB\-\-link\fR
.RS 4
use hard links instead of copying files to the new cluster
.RE
.PP
\fB\-o\fR \fIoptions\fR
.br
\fB\-\-old\-options\fR \fIoptions\fR
.RS 4
options to be passed directly to the old
\fBpostgres\fR
command; multiple option invocations are appended
.RE
.PP
\fB\-O\fR \fIoptions\fR
.br
\fB\-\-new\-options\fR \fIoptions\fR
.RS 4
options to be passed directly to the new
\fBpostgres\fR
command; multiple option invocations are appended
.RE
.PP
\fB\-p\fR \fIport\fR
.br
\fB\-\-old\-port=\fR\fIport\fR
.RS 4
the old cluster port number; environment variable
\fBPGPORTOLD\fR
.RE
.PP
\fB\-P\fR \fIport\fR
.br
\fB\-\-new\-port=\fR\fIport\fR
.RS 4
the new cluster port number; environment variable
\fBPGPORTNEW\fR
.RE
.PP
\fB\-r\fR
.br
\fB\-\-retain\fR
.RS 4
retain SQL and log files even after successful completion
.RE
.PP
\fB\-U\fR \fIusername\fR
.br
\fB\-\-username=\fR\fIusername\fR
.RS 4
cluster\*(Aqs install user name; environment variable
\fBPGUSER\fR
.RE
.PP
\fB\-v\fR
.br
\fB\-\-verbose\fR
.RS 4
enable verbose internal logging
.RE
.PP
\fB\-V\fR
.br
\fB\-\-version\fR
.RS 4
display version information, then exit
.RE
.PP
\fB\-?\fR
.br
\fB\-\-help\fR
.RS 4
show help, then exit
.RE
.SH "USAGE"
.PP
These are the steps to perform an upgrade with
pg_upgrade:
.sp
.RS 4
.ie n \{\
\h'-04' 1.\h'+01'\c
.\}
.el \{\
.sp -1
.IP " 1." 4.2
.\}
Optionally move the old cluster: If you are using a version\-specific installation directory, e\&.g\&.,
/opt/PostgreSQL/9\&.1, you do not need to move the old cluster\&. The graphical installers all use version\-specific installation directories\&.
.sp
If your installation directory is not version\-specific, e\&.g\&.,
/usr/local/pgsql, it is necessary to move the current PostgreSQL install directory so it does not interfere with the new
PostgreSQL
installation\&. Once the current
PostgreSQL
server is shut down, it is safe to rename the PostgreSQL installation directory; assuming the old directory is
/usr/local/pgsql, you can do:
.sp
.if n \{\
.RS 4
.\}
.nf
mv /usr/local/pgsql /usr/local/pgsql\&.old
.fi
.if n \{\
.RE
.\}
.sp
to rename the directory\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 2.\h'+01'\c
.\}
.el \{\
.sp -1
.IP " 2." 4.2
.\}
For source installs, build the new version: Build the new PostgreSQL source with
\fBconfigure\fR
flags that are compatible with the old cluster\&.
pg_upgrade
will check
\fBpg_controldata\fR
to make sure all settings are compatible before starting the upgrade\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 3.\h'+01'\c
.\}
.el \{\
.sp -1
.IP " 3." 4.2
.\}
Install the new PostgreSQL binaries: Install the new server\*(Aqs binaries and support files\&.
pg_upgrade
is included in a default installation\&.
.sp
For source installs, if you wish to install the new server in a custom location, use the
prefix
variable:
.sp
.if n \{\
.RS 4
.\}
.nf
make prefix=/usr/local/pgsql\&.new install
.fi
.if n \{\
.RE
.\}
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 4.\h'+01'\c
.\}
.el \{\
.sp -1
.IP " 4." 4.2
.\}
Initialize the new PostgreSQL cluster: Initialize the new cluster using
\fBinitdb\fR\&. Again, use compatible
\fBinitdb\fR
flags that match the old cluster\&. Many prebuilt installers do this step automatically\&. There is no need to start the new cluster\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 5.\h'+01'\c
.\}
.el \{\
.sp -1
.IP " 5." 4.2
.\}
Install extension shared object files: Many extensions and custom modules, whether from
contrib
or another source, use shared object files (or DLLs), e\&.g\&.,
pgcrypto\&.so\&. If the old cluster used these, shared object files matching the new server binary must be installed in the new cluster, usually via operating system commands\&. Do not load the schema definitions, e\&.g\&.,
\fBCREATE EXTENSION pgcrypto\fR, because these will be duplicated from the old cluster\&. If extension updates are available,
pg_upgrade
will report this and create a script that can be run later to update them\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 6.\h'+01'\c
.\}
.el \{\
.sp -1
.IP " 6." 4.2
.\}
Copy custom full\-text search files: Copy any custom full text search files (dictionary, synonym, thesaurus, stop words) from the old to the new cluster\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 7.\h'+01'\c
.\}
.el \{\
.sp -1
.IP " 7." 4.2
.\}
Adjust authentication: \fBpg_upgrade\fR
will connect to the old and new servers several times, so you might want to set authentication to
peer
in
pg_hba\&.conf
or use a
~/\&.pgpass
file (see
Section 32.15, \(lqThe Password File\(rq, in the documentation)\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 8.\h'+01'\c
.\}
.el \{\
.sp -1
.IP " 8." 4.2
.\}
Stop both servers: Make sure both database servers are stopped using, on Unix, e\&.g\&.:
.sp
.if n \{\
.RS 4
.\}
.nf
pg_ctl \-D /opt/PostgreSQL/8\&.4 stop
pg_ctl \-D /opt/PostgreSQL/9\&.0 stop
.fi
.if n \{\
.RE
.\}
.sp
or on Windows, using the proper service names:
.sp
.if n \{\
.RS 4
.\}
.nf
NET STOP postgresql\-8\&.4
NET STOP postgresql\-9\&.0
.fi
.if n \{\
.RE
.\}
.sp
Streaming replication and log\-shipping standby servers can remain running until a later step\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 9.\h'+01'\c
.\}
.el \{\
.sp -1
.IP " 9." 4.2
.\}
Prepare for standby server upgrades: If you are upgrading standby servers using methods outlined in section
Step 11, verify that the old standby servers are caught up by running
pg_controldata
against the old primary and standby clusters\&. Verify that the
\(lqLatest checkpoint location\(rq
values match in all clusters\&. (There will be a mismatch if old standby servers were shut down before the old primary or if the old standby servers are still running\&.) Also, make sure
\fIwal_level\fR
is not set to
minimal
in the
postgresql\&.conf
file on the new primary cluster\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 10.\h'+01'\c
.\}
.el \{\
.sp -1
.IP " 10." 4.2
.\}
Run pg_upgrade: Always run the
pg_upgrade
binary of the new server, not the old one\&.
pg_upgrade
requires the specification of the old and new cluster\*(Aqs data and executable (bin) directories\&. You can also specify user and port values, and whether you want the data linked instead of copied (the default)\&.
.sp
If you use link mode, the upgrade will be much faster (no file copying) and use less disk space, but you will not be able to access your old cluster once you start the new cluster after the upgrade\&. Link mode also requires that the old and new cluster data directories be in the same file system\&. (Tablespaces and
pg_xlog
can be on different file systems\&.) See
pg_upgrade \-\-help
for a full list of options\&.
.sp
The
\fB\-\-jobs\fR
option allows multiple CPU cores to be used for copying/linking of files and to dump and reload database schemas in parallel; a good place to start is the maximum of the number of CPU cores and tablespaces\&. This option can dramatically reduce the time to upgrade a multi\-database server running on a multiprocessor machine\&.
.sp
For Windows users, you must be logged into an administrative account, and then start a shell as the
postgres
user and set the proper path:
.sp
.if n \{\
.RS 4
.\}
.nf
RUNAS /USER:postgres "CMD\&.EXE"
SET PATH=%PATH%;C:\eProgram Files\ePostgreSQL\e9\&.0\ebin;
.fi
.if n \{\
.RE
.\}
.sp
and then run
pg_upgrade
with quoted directories, e\&.g\&.:
.sp
.if n \{\
.RS 4
.\}
.nf
pg_upgrade\&.exe
\-\-old\-datadir "C:/Program Files/PostgreSQL/8\&.4/data"
\-\-new\-datadir "C:/Program Files/PostgreSQL/9\&.0/data"
\-\-old\-bindir "C:/Program Files/PostgreSQL/8\&.4/bin"
\-\-new\-bindir "C:/Program Files/PostgreSQL/9\&.0/bin"
.fi
.if n \{\
.RE
.\}
.sp
Once started,
\fBpg_upgrade\fR
will verify the two clusters are compatible and then do the upgrade\&. You can use
\fBpg_upgrade \-\-check\fR
to perform only the checks, even if the old server is still running\&.
\fBpg_upgrade \-\-check\fR
will also outline any manual adjustments you will need to make after the upgrade\&. If you are going to be using link mode, you should use the
\fB\-\-link\fR
option with
\fB\-\-check\fR
to enable link\-mode\-specific checks\&.
\fBpg_upgrade\fR
requires write permission in the current directory\&.
.sp
Obviously, no one should be accessing the clusters during the upgrade\&.
pg_upgrade
defaults to running servers on port 50432 to avoid unintended client connections\&. You can use the same port number for both clusters when doing an upgrade because the old and new clusters will not be running at the same time\&. However, when checking an old running server, the old and new port numbers must be different\&.
.sp
If an error occurs while restoring the database schema,
\fBpg_upgrade\fR
will exit and you will have to revert to the old cluster as outlined in
Step 17
below\&. To try
\fBpg_upgrade\fR
again, you will need to modify the old cluster so the pg_upgrade schema restore succeeds\&. If the problem is a
contrib
module, you might need to uninstall the
contrib
module from the old cluster and install it in the new cluster after the upgrade, assuming the module is not being used to store user data\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 11.\h'+01'\c
.\}
.el \{\
.sp -1
.IP " 11." 4.2
.\}
Upgrade Streaming Replication and Log\-Shipping standby servers: If you used link mode and have Streaming Replication (see
Section 26.2.5, \(lqStreaming Replication\(rq, in the documentation) or Log\-Shipping (see
Section 26.2, \(lqLog-Shipping Standby Servers\(rq, in the documentation) standby servers, you can follow these steps to quickly upgrade them\&. You will not be running
pg_upgrade
on the standby servers, but rather
rsync
on the primary\&. Do not start any servers yet\&.
.sp
If you did
\fInot\fR
use link mode, do not have or do not want to use
rsync, or want an easier solution, skip the instructions in this section and simply recreate the standby servers once
pg_upgrade
completes and the new primary is running\&.
Install the new PostgreSQL binaries on standby servers: Make sure the new binaries and support files are installed on all standby servers\&.
Make sure the new standby data directories do \fInot\fR exist: Make sure the new standby data directories do
\fInot\fR
exist or are empty\&. If
initdb
was run, delete the standby servers\*(Aq new data directories\&.
Install extension shared object files: Install the same extension shared object files on the new standbys that you installed in the new primary cluster\&.
Stop standby servers: If the standby servers are still running, stop them now using the above instructions\&.
Save configuration files: Save any configuration files from the old standbys\*(Aq configuration directories you need to keep, e\&.g\&.,
postgresql\&.conf
(and any files included by it),
postgresql\&.auto\&.conf,
recovery\&.conf,
pg_hba\&.conf, because these will be overwritten or removed in the next step\&.
Run rsync: When using link mode, standby servers can be quickly upgraded using
rsync\&. To accomplish this, from a directory on the primary server that is above the old and new database cluster directories, run this on the
\fIprimary\fR
for each standby server:
.sp
.if n \{\
.RS 4
.\}
.nf
rsync \-\-archive \-\-delete \-\-hard\-links \-\-size\-only \-\-no\-inc\-recursive old_cluster new_cluster remote_dir
.fi
.if n \{\
.RE
.\}
.sp
where
\fBold_cluster\fR
and
\fBnew_cluster\fR
are relative to the current directory on the primary, and
\fBremote_dir\fR
is
\fIabove\fR
the old and new cluster directories on the standby\&. The directory structure under the specified directories on the primary and standbys must match\&. Consult the
rsync
manual page for details on specifying the remote directory, e\&.g\&.,
.sp
.if n \{\
.RS 4
.\}
.nf
rsync \-\-archive \-\-delete \-\-hard\-links \-\-size\-only \-\-no\-inc\-recursive /opt/PostgreSQL/9\&.5 \e
/opt/PostgreSQL/9\&.6 standby\&.example\&.com:/opt/PostgreSQL
.fi
.if n \{\
.RE
.\}
.sp
You can verify what the command will do using
rsync\*(Aqs
\fB\-\-dry\-run\fR
option\&. While
rsync
must be run on the primary for at least one standby, it is possible to run
rsync
on an upgraded standby to upgrade other standbys, as long as the upgraded standby has not been started\&.
.sp
What this does is to record the links created by
pg_upgrade\*(Aqs link mode that connect files in the old and new clusters on the primary server\&. It then finds matching files in the standby\*(Aqs old cluster and creates links for them in the standby\*(Aqs new cluster\&. Files that were not linked on the primary are copied from the primary to the standby\&. (They are usually small\&.) This provides rapid standby upgrades\&. Unfortunately,
rsync
needlessly copies files associated with temporary and unlogged tables because these files don\*(Aqt normally exist on standby servers\&.
.sp
If you have tablespaces, you will need to run a similar
rsync
command for each tablespace directory, e\&.g\&.:
.sp
.if n \{\
.RS 4
.\}
.nf
rsync \-\-archive \-\-delete \-\-hard\-links \-\-size\-only \-\-no\-inc\-recursive /vol1/pg_tblsp/PG_9\&.5_201510051 \e
/vol1/pg_tblsp/PG_9\&.6_201608131 standby\&.example\&.com:/vol1/pg_tblsp
.fi
.if n \{\
.RE
.\}
.sp
If you have relocated
pg_xlog
outside the data directories,
rsync
must be run on those directories too\&.
Configure streaming replication and log\-shipping standby servers: Configure the servers for log shipping\&. (You do not need to run
\fBpg_start_backup()\fR
and
\fBpg_stop_backup()\fR
or take a file system backup as the standbys are still synchronized with the primary\&.)
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 12.\h'+01'\c
.\}
.el \{\
.sp -1
.IP " 12." 4.2
.\}
Restore pg_hba\&.conf: If you modified
pg_hba\&.conf, restore its original settings\&. It might also be necessary to adjust other configuration files in the new cluster to match the old cluster, e\&.g\&.,
postgresql\&.conf
(and any files included by it),
postgresql\&.auto\&.conf\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 13.\h'+01'\c
.\}
.el \{\
.sp -1
.IP " 13." 4.2
.\}
Start the new server: The new server can now be safely started, and then any
rsync\*(Aqed standby servers\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 14.\h'+01'\c
.\}
.el \{\
.sp -1
.IP " 14." 4.2
.\}
Post\-Upgrade processing: If any post\-upgrade processing is required, pg_upgrade will issue warnings as it completes\&. It will also generate script files that must be run by the administrator\&. The script files will connect to each database that needs post\-upgrade processing\&. Each script should be run using:
.sp
.if n \{\
.RS 4
.\}
.nf
psql \-\-username postgres \-\-file script\&.sql postgres
.fi
.if n \{\
.RE
.\}
.sp
The scripts can be run in any order and can be deleted once they have been run\&.
.if n \{\
.sp
.\}
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBCaution\fR
.ps -1
.br
In general it is unsafe to access tables referenced in rebuild scripts until the rebuild scripts have run to completion; doing so could yield incorrect results or poor performance\&. Tables not referenced in rebuild scripts can be accessed immediately\&.
.sp .5v
.RE
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 15.\h'+01'\c
.\}
.el \{\
.sp -1
.IP " 15." 4.2
.\}
Statistics: Because optimizer statistics are not transferred by
\fBpg_upgrade\fR, you will be instructed to run a command to regenerate that information at the end of the upgrade\&. You might need to set connection parameters to match your new cluster\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 16.\h'+01'\c
.\}
.el \{\
.sp -1
.IP " 16." 4.2
.\}
Delete old cluster: Once you are satisfied with the upgrade, you can delete the old cluster\*(Aqs data directories by running the script mentioned when
\fBpg_upgrade\fR
completes\&. (Automatic deletion is not possible if you have user\-defined tablespaces inside the old data directory\&.) You can also delete the old installation directories (e\&.g\&.,
bin,
share)\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 17.\h'+01'\c
.\}
.el \{\
.sp -1
.IP " 17." 4.2
.\}
Reverting to old cluster: If, after running
\fBpg_upgrade\fR, you wish to revert to the old cluster, there are several options:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
If the
\fB\-\-check\fR
option was used, the old cluster was unmodified; it can be restarted\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
If the
\fB\-\-link\fR
option was
\fInot\fR
used, the old cluster was unmodified; it can be restarted\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
If the
\fB\-\-link\fR
option was used, the data files might be shared between the old and new cluster:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
If
\fBpg_upgrade\fR
aborted before linking started, the old cluster was unmodified; it can be restarted\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
If you did
\fInot\fR
start the new cluster, the old cluster was unmodified except that, when linking started, a
\&.old
suffix was appended to
$PGDATA/global/pg_control\&. To reuse the old cluster, remove the
\&.old
suffix from
$PGDATA/global/pg_control; you can then restart the old cluster\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
If you did start the new cluster, it has written to shared files and it is unsafe to use the old cluster\&. The old cluster will need to be restored from backup in this case\&.
.RE
.sp
.RE
.sp
.RE
.SH "NOTES"
.PP
pg_upgrade
does not support upgrading of databases containing these
reg*
OID\-referencing system data types:
regproc,
regprocedure,
regoper,
regoperator,
regconfig, and
regdictionary\&. (regtype
can be upgraded\&.)
.PP
All failure, rebuild, and reindex cases will be reported by
pg_upgrade
if they affect your installation; post\-upgrade scripts to rebuild tables and indexes will be generated automatically\&. If you are trying to automate the upgrade of many clusters, you should find that clusters with identical database schemas require the same post\-upgrade steps for all cluster upgrades; this is because the post\-upgrade steps are based on the database schemas, and not user data\&.
.PP
For deployment testing, create a schema\-only copy of the old cluster, insert dummy data, and upgrade that\&.
.PP
If you are upgrading a pre\-PostgreSQL
9\&.2 cluster that uses a configuration\-file\-only directory, you must pass the real data directory location to
pg_upgrade, and pass the configuration directory location to the server, e\&.g\&.,
\-d /real\-data\-directory \-o \*(Aq\-D /configuration\-directory\*(Aq\&.
.PP
If using a pre\-9\&.1 old server that is using a non\-default Unix\-domain socket directory or a default that differs from the default of the new cluster, set
\fBPGHOST\fR
to point to the old server\*(Aqs socket location\&. (This is not relevant on Windows\&.)
.PP
If you want to use link mode and you do not want your old cluster to be modified when the new cluster is started, make a copy of the old cluster and upgrade that in link mode\&. To make a valid copy of the old cluster, use
\fBrsync\fR
to create a dirty copy of the old cluster while the server is running, then shut down the old server and run
\fBrsync \-\-checksum\fR
again to update the copy with any changes to make it consistent\&. (\fB\-\-checksum\fR
is necessary because
\fBrsync\fR
only has file modification\-time granularity of one second\&.) You might want to exclude some files, e\&.g\&.,
postmaster\&.pid, as documented in
Section 25.3.3, \(lqMaking a Base Backup Using the Low Level API\(rq, in the documentation\&. If your file system supports file system snapshots or copy\-on\-write file copies, you can use that to make a backup of the old cluster and tablespaces, though the snapshot and copies must be created simultaneously or while the database server is down\&.
.SH "SEE ALSO"
\fBinitdb\fR(1), \fBpg_ctl\fR(1), \fBpg_dump\fR(1), \fBpostgres\fR(1)
man/man1/droplang.1 0000644 00000012150 14751153421 0010045 0 ustar 00 '\" t
.\" Title: droplang
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "DROPLANG" "1" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
droplang \- remove a PostgreSQL procedural language
.SH "SYNOPSIS"
.HP \w'\fBdroplang\fR\ 'u
\fBdroplang\fR [\fIconnection\-option\fR...] \fIlangname\fR [\fIdbname\fR]
.HP \w'\fBdroplang\fR\ 'u
\fBdroplang\fR [\fIconnection\-option\fR...] \fB\-\-list\fR | \fB\-l\fR [\fIdbname\fR]
.SH "DESCRIPTION"
.PP
droplang
is a utility for removing an existing procedural language from a
PostgreSQL
database\&.
.PP
droplang
is just a wrapper around the
DROP EXTENSION (\fBDROP_EXTENSION\fR(7))
SQL command\&.
.if n \{\
.sp
.\}
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBCaution\fR
.ps -1
.br
.PP
droplang
is deprecated and may be removed in a future
PostgreSQL
release\&. Direct use of the
\fBDROP EXTENSION\fR
command is recommended instead\&.
.sp .5v
.RE
.SH "OPTIONS"
.PP
droplang
accepts the following command line arguments:
.PP
\fIlangname\fR
.RS 4
Specifies the name of the procedural language to be removed\&. (This name is lower\-cased\&.)
.RE
.PP
\fB[\-d]\fR\fB \fR\fB\fIdbname\fR\fR
.br
\fB[\-\-dbname=]\fR\fB\fIdbname\fR\fR
.RS 4
Specifies from which database the language should be removed\&. The default is to use the database with the same name as the current system user\&.
.RE
.PP
\fB\-e\fR
.br
\fB\-\-echo\fR
.RS 4
Display SQL commands as they are executed\&.
.RE
.PP
\fB\-l\fR
.br
\fB\-\-list\fR
.RS 4
Show a list of already installed languages in the target database\&.
.RE
.PP
\fB\-V\fR
.br
\fB\-\-version\fR
.RS 4
Print the
droplang
version and exit\&.
.RE
.PP
\fB\-?\fR
.br
\fB\-\-help\fR
.RS 4
Show help about
droplang
command line arguments, and exit\&.
.RE
.PP
droplang
also accepts the following command line arguments for connection parameters:
.PP
\fB\-h \fR\fB\fIhost\fR\fR
.br
\fB\-\-host=\fR\fB\fIhost\fR\fR
.RS 4
Specifies the host name of the machine on which the server is running\&. If host begins with a slash, it is used as the directory for the Unix domain socket\&.
.RE
.PP
\fB\-p \fR\fB\fIport\fR\fR
.br
\fB\-\-port=\fR\fB\fIport\fR\fR
.RS 4
Specifies the Internet TCP/IP port or local Unix domain socket file extension on which the server is listening for connections\&.
.RE
.PP
\fB\-U \fR\fB\fIusername\fR\fR
.br
\fB\-\-username=\fR\fB\fIusername\fR\fR
.RS 4
User name to connect as\&.
.RE
.PP
\fB\-w\fR
.br
\fB\-\-no\-password\fR
.RS 4
Never issue a password prompt\&. If the server requires password authentication and a password is not available by other means such as a
\&.pgpass
file, the connection attempt will fail\&. This option can be useful in batch jobs and scripts where no user is present to enter a password\&.
.RE
.PP
\fB\-W\fR
.br
\fB\-\-password\fR
.RS 4
Force
droplang
to prompt for a password before connecting to a database\&.
.sp
This option is never essential, since
droplang
will automatically prompt for a password if the server demands password authentication\&. However,
droplang
will waste a connection attempt finding out that the server wants a password\&. In some cases it is worth typing
\fB\-W\fR
to avoid the extra connection attempt\&.
.RE
.SH "ENVIRONMENT"
.PP
\fBPGDATABASE\fR
.br
\fBPGHOST\fR
.br
\fBPGPORT\fR
.br
\fBPGUSER\fR
.RS 4
Default connection parameters
.RE
.PP
This utility, like most other
PostgreSQL
utilities, also uses the environment variables supported by
libpq
(see
Section 32.14, \(lqEnvironment Variables\(rq, in the documentation)\&.
.SH "DIAGNOSTICS"
.PP
Most error messages are self\-explanatory\&. If not, run
droplang
with the
\fB\-\-echo\fR
option and see under the respective
SQL
command for details\&. Also, any default connection settings and environment variables used by the
libpq
front\-end library will apply\&.
.SH "NOTES"
.PP
Use
\fBcreatelang\fR(1)
to add a language\&.
.SH "EXAMPLES"
.PP
To remove the language
pltcl:
.sp
.if n \{\
.RS 4
.\}
.nf
$ \fBdroplang pltcl dbname\fR
.fi
.if n \{\
.RE
.\}
.SH "SEE ALSO"
\fBcreatelang\fR(1), DROP EXTENSION (\fBDROP_EXTENSION\fR(7)), DROP LANGUAGE (\fBDROP_LANGUAGE\fR(7))
man/man1/pg_archivecleanup.1 0000644 00000012700 14751153421 0011717 0 ustar 00 '\" t
.\" Title: pg_archivecleanup
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "PG_ARCHIVECLEANUP" "1" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
pg_archivecleanup \- clean up PostgreSQL WAL archive files
.SH "SYNOPSIS"
.HP \w'\fBpg_archivecleanup\fR\ 'u
\fBpg_archivecleanup\fR [\fIoption\fR...] \fIarchivelocation\fR \fIoldestkeptwalfile\fR
.SH "DESCRIPTION"
.PP
pg_archivecleanup
is designed to be used as an
archive_cleanup_command
to clean up WAL file archives when running as a standby server (see
Section 26.2, \(lqLog-Shipping Standby Servers\(rq, in the documentation)\&.
pg_archivecleanup
can also be used as a standalone program to clean WAL file archives\&.
.PP
To configure a standby server to use
pg_archivecleanup, put this into its
recovery\&.conf
configuration file:
.sp
.if n \{\
.RS 4
.\}
.nf
archive_cleanup_command = \*(Aqpg_archivecleanup \fIarchivelocation\fR %r\*(Aq
.fi
.if n \{\
.RE
.\}
.sp
where
\fIarchivelocation\fR
is the directory from which WAL segment files should be removed\&.
.PP
When used within
archive_cleanup_command, all WAL files logically preceding the value of the
%r
argument will be removed from
\fIarchivelocation\fR\&. This minimizes the number of files that need to be retained, while preserving crash\-restart capability\&. Use of this parameter is appropriate if the
\fIarchivelocation\fR
is a transient staging area for this particular standby server, but
\fInot\fR
when the
\fIarchivelocation\fR
is intended as a long\-term WAL archive area, or when multiple standby servers are recovering from the same archive location\&.
.PP
When used as a standalone program all WAL files logically preceding the
\fIoldestkeptwalfile\fR
will be removed from
\fIarchivelocation\fR\&. In this mode, if you specify a
\&.partial
or
\&.backup
file name, then only the file prefix will be used as the
\fIoldestkeptwalfile\fR\&. This treatment of
\&.backup
file name allows you to remove all WAL files archived prior to a specific base backup without error\&. For example, the following example will remove all files older than WAL file name
000000010000003700000010:
.sp
.if n \{\
.RS 4
.\}
.nf
pg_archivecleanup \-d archive 000000010000003700000010\&.00000020\&.backup
pg_archivecleanup: keep WAL file "archive/000000010000003700000010" and later
pg_archivecleanup: removing file "archive/00000001000000370000000F"
pg_archivecleanup: removing file "archive/00000001000000370000000E"
.fi
.if n \{\
.RE
.\}
.PP
pg_archivecleanup
assumes that
\fIarchivelocation\fR
is a directory readable and writable by the server\-owning user\&.
.SH "OPTIONS"
.PP
pg_archivecleanup
accepts the following command\-line arguments:
.PP
\fB\-d\fR
.RS 4
Print lots of debug logging output on
stderr\&.
.RE
.PP
\fB\-n\fR
.RS 4
Print the names of the files that would have been removed on
stdout
(performs a dry run)\&.
.RE
.PP
\fB\-V\fR
.br
\fB\-\-version\fR
.RS 4
Print the
pg_archivecleanup
version and exit\&.
.RE
.PP
\fB\-x\fR \fIextension\fR
.RS 4
Provide an extension that will be stripped from all file names before deciding if they should be deleted\&. This is typically useful for cleaning up archives that have been compressed during storage, and therefore have had an extension added by the compression program\&. For example:
\-x \&.gz\&.
.RE
.PP
\fB\-?\fR
.br
\fB\-\-help\fR
.RS 4
Show help about
pg_archivecleanup
command line arguments, and exit\&.
.RE
.SH "NOTES"
.PP
pg_archivecleanup
is designed to work with
PostgreSQL
8\&.0 and later when used as a standalone utility, or with
PostgreSQL
9\&.0 and later when used as an archive cleanup command\&.
.PP
pg_archivecleanup
is written in C and has an easy\-to\-modify source code, with specifically designated sections to modify for your own needs
.SH "EXAMPLES"
.PP
On Linux or Unix systems, you might use:
.sp
.if n \{\
.RS 4
.\}
.nf
archive_cleanup_command = \*(Aqpg_archivecleanup \-d /mnt/standby/archive %r 2>>cleanup\&.log\*(Aq
.fi
.if n \{\
.RE
.\}
.sp
where the archive directory is physically located on the standby server, so that the
\fIarchive_command\fR
is accessing it across NFS, but the files are local to the standby\&. This will:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
produce debugging output in
cleanup\&.log
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
remove no\-longer\-needed files from the archive directory
.RE
.SH "SEE ALSO"
\fBpg_standby\fR(1)
man/man1/pgbench.1 0000644 00000111547 14751153421 0007657 0 ustar 00 '\" t
.\" Title: pgbench
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "PGBENCH" "1" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
pgbench \- run a benchmark test on PostgreSQL
.SH "SYNOPSIS"
.HP \w'\fBpgbench\fR\ 'u
\fBpgbench\fR \fB\-i\fR [\fIoption\fR...] [\fIdbname\fR]
.HP \w'\fBpgbench\fR\ 'u
\fBpgbench\fR [\fIoption\fR...] [\fIdbname\fR]
.SH "DESCRIPTION"
.PP
pgbench
is a simple program for running benchmark tests on
PostgreSQL\&. It runs the same sequence of SQL commands over and over, possibly in multiple concurrent database sessions, and then calculates the average transaction rate (transactions per second)\&. By default,
pgbench
tests a scenario that is loosely based on TPC\-B, involving five
\fBSELECT\fR,
\fBUPDATE\fR, and
\fBINSERT\fR
commands per transaction\&. However, it is easy to test other cases by writing your own transaction script files\&.
.PP
Typical output from
pgbench
looks like:
.sp
.if n \{\
.RS 4
.\}
.nf
transaction type: <builtin: TPC\-B (sort of)>
scaling factor: 10
query mode: simple
number of clients: 10
number of threads: 1
number of transactions per client: 1000
number of transactions actually processed: 10000/10000
tps = 85\&.184871 (including connections establishing)
tps = 85\&.296346 (excluding connections establishing)
.fi
.if n \{\
.RE
.\}
.sp
The first six lines report some of the most important parameter settings\&. The next line reports the number of transactions completed and intended (the latter being just the product of number of clients and number of transactions per client); these will be equal unless the run failed before completion\&. (In
\fB\-T\fR
mode, only the actual number of transactions is printed\&.) The last two lines report the number of transactions per second, figured with and without counting the time to start database sessions\&.
.PP
The default TPC\-B\-like transaction test requires specific tables to be set up beforehand\&.
pgbench
should be invoked with the
\fB\-i\fR
(initialize) option to create and populate these tables\&. (When you are testing a custom script, you don\*(Aqt need this step, but will instead need to do whatever setup your test needs\&.) Initialization looks like:
.sp
.if n \{\
.RS 4
.\}
.nf
pgbench \-i [ \fIother\-options\fR ] \fIdbname\fR
.fi
.if n \{\
.RE
.\}
.sp
where
\fIdbname\fR
is the name of the already\-created database to test in\&. (You may also need
\fB\-h\fR,
\fB\-p\fR, and/or
\fB\-U\fR
options to specify how to connect to the database server\&.)
.if n \{\
.sp
.\}
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBCaution\fR
.ps -1
.br
.PP
pgbench \-i
creates four tables
pgbench_accounts,
pgbench_branches,
pgbench_history, and
pgbench_tellers, destroying any existing tables of these names\&. Be very careful to use another database if you have tables having these names!
.sp .5v
.RE
.PP
At the default
\(lqscale factor\(rq
of 1, the tables initially contain this many rows:
.sp
.if n \{\
.RS 4
.\}
.nf
table # of rows
\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
pgbench_branches 1
pgbench_tellers 10
pgbench_accounts 100000
pgbench_history 0
.fi
.if n \{\
.RE
.\}
.sp
You can (and, for most purposes, probably should) increase the number of rows by using the
\fB\-s\fR
(scale factor) option\&. The
\fB\-F\fR
(fillfactor) option might also be used at this point\&.
.PP
Once you have done the necessary setup, you can run your benchmark with a command that doesn\*(Aqt include
\fB\-i\fR, that is
.sp
.if n \{\
.RS 4
.\}
.nf
pgbench [ \fIoptions\fR ] \fIdbname\fR
.fi
.if n \{\
.RE
.\}
.sp
In nearly all cases, you\*(Aqll need some options to make a useful test\&. The most important options are
\fB\-c\fR
(number of clients),
\fB\-t\fR
(number of transactions),
\fB\-T\fR
(time limit), and
\fB\-f\fR
(specify a custom script file)\&. See below for a full list\&.
.SH "OPTIONS"
.PP
The following is divided into three subsections: Different options are used during database initialization and while running benchmarks, some options are useful in both cases\&.
.SS "Initialization Options"
.PP
pgbench
accepts the following command\-line initialization arguments:
.PP
\fB\-i\fR
.br
\fB\-\-initialize\fR
.RS 4
Required to invoke initialization mode\&.
.RE
.PP
\fB\-F\fR \fIfillfactor\fR
.br
\fB\-\-fillfactor=\fR\fIfillfactor\fR
.RS 4
Create the
pgbench_accounts,
pgbench_tellers
and
pgbench_branches
tables with the given fillfactor\&. Default is 100\&.
.RE
.PP
\fB\-n\fR
.br
\fB\-\-no\-vacuum\fR
.RS 4
Perform no vacuuming after initialization\&.
.RE
.PP
\fB\-q\fR
.br
\fB\-\-quiet\fR
.RS 4
Switch logging to quiet mode, producing only one progress message per 5 seconds\&. The default logging prints one message each 100000 rows, which often outputs many lines per second (especially on good hardware)\&.
.RE
.PP
\fB\-s\fR \fIscale_factor\fR
.br
\fB\-\-scale=\fR\fIscale_factor\fR
.RS 4
Multiply the number of rows generated by the scale factor\&. For example,
\-s 100
will create 10,000,000 rows in the
pgbench_accounts
table\&. Default is 1\&. When the scale is 20,000 or larger, the columns used to hold account identifiers (aid
columns) will switch to using larger integers (bigint), in order to be big enough to hold the range of account identifiers\&.
.RE
.PP
\fB\-\-foreign\-keys\fR
.RS 4
Create foreign key constraints between the standard tables\&.
.RE
.PP
\fB\-\-index\-tablespace=\fR\fB\fIindex_tablespace\fR\fR
.RS 4
Create indexes in the specified tablespace, rather than the default tablespace\&.
.RE
.PP
\fB\-\-tablespace=\fR\fB\fItablespace\fR\fR
.RS 4
Create tables in the specified tablespace, rather than the default tablespace\&.
.RE
.PP
\fB\-\-unlogged\-tables\fR
.RS 4
Create all tables as unlogged tables, rather than permanent tables\&.
.RE
.SS "Benchmarking Options"
.PP
pgbench
accepts the following command\-line benchmarking arguments:
.PP
\fB\-b\fR \fIscriptname[@weight]\fR
.br
\fB\-\-builtin\fR=\fIscriptname[@weight]\fR
.RS 4
Add the specified built\-in script to the list of scripts to be executed\&. Available built\-in scripts are:
tpcb\-like,
simple\-update
and
select\-only\&. Unambiguous prefixes of built\-in names are accepted\&. With the special name
list, show the list of built\-in scripts and exit immediately\&.
.sp
Optionally, write an integer weight after
@
to adjust the probability of selecting this script versus other ones\&. The default weight is 1\&. See below for details\&.
.RE
.PP
\fB\-c\fR \fIclients\fR
.br
\fB\-\-client=\fR\fIclients\fR
.RS 4
Number of clients simulated, that is, number of concurrent database sessions\&. Default is 1\&.
.RE
.PP
\fB\-C\fR
.br
\fB\-\-connect\fR
.RS 4
Establish a new connection for each transaction, rather than doing it just once per client session\&. This is useful to measure the connection overhead\&.
.RE
.PP
\fB\-d\fR
.br
\fB\-\-debug\fR
.RS 4
Print debugging output\&.
.RE
.PP
\fB\-D\fR \fIvarname\fR=\fIvalue\fR
.br
\fB\-\-define=\fR\fIvarname\fR=\fIvalue\fR
.RS 4
Define a variable for use by a custom script (see below)\&. Multiple
\fB\-D\fR
options are allowed\&.
.RE
.PP
\fB\-f\fR \fIfilename[@weight]\fR
.br
\fB\-\-file=\fR\fIfilename[@weight]\fR
.RS 4
Add a transaction script read from
\fIfilename\fR
to the list of scripts to be executed\&.
.sp
Optionally, write an integer weight after
@
to adjust the probability of selecting this script versus other ones\&. The default weight is 1\&. (To use a script file name that includes an
@
character, append a weight so that there is no ambiguity, for example
filen@me@1\&.) See below for details\&.
.RE
.PP
\fB\-j\fR \fIthreads\fR
.br
\fB\-\-jobs=\fR\fIthreads\fR
.RS 4
Number of worker threads within
pgbench\&. Using more than one thread can be helpful on multi\-CPU machines\&. Clients are distributed as evenly as possible among available threads\&. Default is 1\&.
.RE
.PP
\fB\-l\fR
.br
\fB\-\-log\fR
.RS 4
Write the time taken by each transaction to a log file\&. See below for details\&.
.RE
.PP
\fB\-L\fR \fIlimit\fR
.br
\fB\-\-latency\-limit=\fR\fIlimit\fR
.RS 4
Transactions that last more than
\fIlimit\fR
milliseconds are counted and reported separately, as
late\&.
.sp
When throttling is used (\fB\-\-rate=\&.\&.\&.\fR), transactions that lag behind schedule by more than
\fIlimit\fR
ms, and thus have no hope of meeting the latency limit, are not sent to the server at all\&. They are counted and reported separately as
skipped\&.
.RE
.PP
\fB\-M\fR \fIquerymode\fR
.br
\fB\-\-protocol=\fR\fIquerymode\fR
.RS 4
Protocol to use for submitting queries to the server:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
simple: use simple query protocol\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
extended: use extended query protocol\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
prepared: use extended query protocol with prepared statements\&.
.RE
.sp
The default is simple query protocol\&. (See
Chapter 51, Frontend/Backend Protocol, in the documentation
for more information\&.)
.RE
.PP
\fB\-n\fR
.br
\fB\-\-no\-vacuum\fR
.RS 4
Perform no vacuuming before running the test\&. This option is
\fInecessary\fR
if you are running a custom test scenario that does not include the standard tables
pgbench_accounts,
pgbench_branches,
pgbench_history, and
pgbench_tellers\&.
.RE
.PP
\fB\-N\fR
.br
\fB\-\-skip\-some\-updates\fR
.RS 4
Run built\-in simple\-update script\&. Shorthand for
\fB\-b simple\-update\fR\&.
.RE
.PP
\fB\-P\fR \fIsec\fR
.br
\fB\-\-progress=\fR\fIsec\fR
.RS 4
Show progress report every
\fIsec\fR
seconds\&. The report includes the time since the beginning of the run, the tps since the last report, and the transaction latency average and standard deviation since the last report\&. Under throttling (\fB\-R\fR), the latency is computed with respect to the transaction scheduled start time, not the actual transaction beginning time, thus it also includes the average schedule lag time\&.
.RE
.PP
\fB\-r\fR
.br
\fB\-\-report\-latencies\fR
.RS 4
Report the average per\-statement latency (execution time from the perspective of the client) of each command after the benchmark finishes\&. See below for details\&.
.RE
.PP
\fB\-R\fR \fIrate\fR
.br
\fB\-\-rate=\fR\fIrate\fR
.RS 4
Execute transactions targeting the specified rate instead of running as fast as possible (the default)\&. The rate is given in transactions per second\&. If the targeted rate is above the maximum possible rate, the rate limit won\*(Aqt impact the results\&.
.sp
The rate is targeted by starting transactions along a Poisson\-distributed schedule time line\&. The expected start time schedule moves forward based on when the client first started, not when the previous transaction ended\&. That approach means that when transactions go past their original scheduled end time, it is possible for later ones to catch up again\&.
.sp
When throttling is active, the transaction latency reported at the end of the run is calculated from the scheduled start times, so it includes the time each transaction had to wait for the previous transaction to finish\&. The wait time is called the schedule lag time, and its average and maximum are also reported separately\&. The transaction latency with respect to the actual transaction start time, i\&.e\&., the time spent executing the transaction in the database, can be computed by subtracting the schedule lag time from the reported latency\&.
.sp
If
\fB\-\-latency\-limit\fR
is used together with
\fB\-\-rate\fR, a transaction can lag behind so much that it is already over the latency limit when the previous transaction ends, because the latency is calculated from the scheduled start time\&. Such transactions are not sent to the server, but are skipped altogether and counted separately\&.
.sp
A high schedule lag time is an indication that the system cannot process transactions at the specified rate, with the chosen number of clients and threads\&. When the average transaction execution time is longer than the scheduled interval between each transaction, each successive transaction will fall further behind, and the schedule lag time will keep increasing the longer the test run is\&. When that happens, you will have to reduce the specified transaction rate\&.
.RE
.PP
\fB\-s\fR \fIscale_factor\fR
.br
\fB\-\-scale=\fR\fIscale_factor\fR
.RS 4
Report the specified scale factor in
pgbench\*(Aqs output\&. With the built\-in tests, this is not necessary; the correct scale factor will be detected by counting the number of rows in the
pgbench_branches
table\&. However, when testing only custom benchmarks (\fB\-f\fR
option), the scale factor will be reported as 1 unless this option is used\&.
.RE
.PP
\fB\-S\fR
.br
\fB\-\-select\-only\fR
.RS 4
Run built\-in select\-only script\&. Shorthand for
\fB\-b select\-only\fR\&.
.RE
.PP
\fB\-t\fR \fItransactions\fR
.br
\fB\-\-transactions=\fR\fItransactions\fR
.RS 4
Number of transactions each client runs\&. Default is 10\&.
.RE
.PP
\fB\-T\fR \fIseconds\fR
.br
\fB\-\-time=\fR\fIseconds\fR
.RS 4
Run the test for this many seconds, rather than a fixed number of transactions per client\&.
\fB\-t\fR
and
\fB\-T\fR
are mutually exclusive\&.
.RE
.PP
\fB\-v\fR
.br
\fB\-\-vacuum\-all\fR
.RS 4
Vacuum all four standard tables before running the test\&. With neither
\fB\-n\fR
nor
\fB\-v\fR,
pgbench
will vacuum the
pgbench_tellers
and
pgbench_branches
tables, and will truncate
pgbench_history\&.
.RE
.PP
\fB\-\-aggregate\-interval=\fR\fB\fIseconds\fR\fR
.RS 4
Length of aggregation interval (in seconds)\&. May be used only together with
\-l
\- with this option, the log contains per\-interval summary (number of transactions, min/max latency and two additional fields useful for variance estimation)\&.
.sp
This option is not currently supported on Windows\&.
.RE
.PP
\fB\-\-progress\-timestamp\fR
.RS 4
When showing progress (option
\fB\-P\fR), use a timestamp (Unix epoch) instead of the number of seconds since the beginning of the run\&. The unit is in seconds, with millisecond precision after the dot\&. This helps compare logs generated by various tools\&.
.RE
.PP
\fB\-\-sampling\-rate=\fR\fB\fIrate\fR\fR
.RS 4
Sampling rate, used when writing data into the log, to reduce the amount of log generated\&. If this option is given, only the specified fraction of transactions are logged\&. 1\&.0 means all transactions will be logged, 0\&.05 means only 5% of the transactions will be logged\&.
.sp
Remember to take the sampling rate into account when processing the log file\&. For example, when computing tps values, you need to multiply the numbers accordingly (e\&.g\&., with 0\&.01 sample rate, you\*(Aqll only get 1/100 of the actual tps)\&.
.RE
.SS "Common Options"
.PP
pgbench
accepts the following command\-line common arguments:
.PP
\fB\-h\fR \fIhostname\fR
.br
\fB\-\-host=\fR\fIhostname\fR
.RS 4
The database server\*(Aqs host name
.RE
.PP
\fB\-p\fR \fIport\fR
.br
\fB\-\-port=\fR\fIport\fR
.RS 4
The database server\*(Aqs port number
.RE
.PP
\fB\-U\fR \fIlogin\fR
.br
\fB\-\-username=\fR\fIlogin\fR
.RS 4
The user name to connect as
.RE
.PP
\fB\-V\fR
.br
\fB\-\-version\fR
.RS 4
Print the
pgbench
version and exit\&.
.RE
.PP
\fB\-?\fR
.br
\fB\-\-help\fR
.RS 4
Show help about
pgbench
command line arguments, and exit\&.
.RE
.SH "NOTES"
.SS "What is the \(lqTransaction\(rq Actually Performed in pgbench?"
.PP
pgbench
executes test scripts chosen randomly from a specified list\&. The scripts may include built\-in scripts specified with
\fB\-b\fR
and user\-provided scripts specified with
\fB\-f\fR\&. Each script may be given a relative weight specified after an
@
so as to change its selection probability\&. The default weight is
1\&. Scripts with a weight of
0
are ignored\&.
.PP
The default built\-in transaction script (also invoked with
\fB\-b tpcb\-like\fR) issues seven commands per transaction over randomly chosen
aid,
tid,
bid
and
delta\&. The scenario is inspired by the TPC\-B benchmark, but is not actually TPC\-B, hence the name\&.
.sp
.RS 4
.ie n \{\
\h'-04' 1.\h'+01'\c
.\}
.el \{\
.sp -1
.IP " 1." 4.2
.\}
BEGIN;
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 2.\h'+01'\c
.\}
.el \{\
.sp -1
.IP " 2." 4.2
.\}
UPDATE pgbench_accounts SET abalance = abalance + :delta WHERE aid = :aid;
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 3.\h'+01'\c
.\}
.el \{\
.sp -1
.IP " 3." 4.2
.\}
SELECT abalance FROM pgbench_accounts WHERE aid = :aid;
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 4.\h'+01'\c
.\}
.el \{\
.sp -1
.IP " 4." 4.2
.\}
UPDATE pgbench_tellers SET tbalance = tbalance + :delta WHERE tid = :tid;
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 5.\h'+01'\c
.\}
.el \{\
.sp -1
.IP " 5." 4.2
.\}
UPDATE pgbench_branches SET bbalance = bbalance + :delta WHERE bid = :bid;
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 6.\h'+01'\c
.\}
.el \{\
.sp -1
.IP " 6." 4.2
.\}
INSERT INTO pgbench_history (tid, bid, aid, delta, mtime) VALUES (:tid, :bid, :aid, :delta, CURRENT_TIMESTAMP);
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 7.\h'+01'\c
.\}
.el \{\
.sp -1
.IP " 7." 4.2
.\}
END;
.RE
.PP
If you select the
simple\-update
built\-in (also
\fB\-N\fR), steps 4 and 5 aren\*(Aqt included in the transaction\&. This will avoid update contention on these tables, but it makes the test case even less like TPC\-B\&.
.PP
If you select the
select\-only
built\-in (also
\fB\-S\fR), only the
\fBSELECT\fR
is issued\&.
.SS "Custom Scripts"
.PP
pgbench
has support for running custom benchmark scenarios by replacing the default transaction script (described above) with a transaction script read from a file (\fB\-f\fR
option)\&. In this case a
\(lqtransaction\(rq
counts as one execution of a script file\&.
.PP
A script file contains one or more SQL commands terminated by semicolons\&. Empty lines and lines beginning with
\-\-
are ignored\&. Script files can also contain
\(lqmeta commands\(rq, which are interpreted by
pgbench
itself, as described below\&.
.if n \{\
.sp
.\}
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBNote\fR
.ps -1
.br
.PP
Before
PostgreSQL
9\&.6, SQL commands in script files were terminated by newlines, and so they could not be continued across lines\&. Now a semicolon is
\fIrequired\fR
to separate consecutive SQL commands (though a SQL command does not need one if it is followed by a meta command)\&. If you need to create a script file that works with both old and new versions of
pgbench, be sure to write each SQL command on a single line ending with a semicolon\&.
.sp .5v
.RE
.PP
There is a simple variable\-substitution facility for script files\&. Variables can be set by the command\-line
\fB\-D\fR
option, explained above, or by the meta commands explained below\&. In addition to any variables preset by
\fB\-D\fR
command\-line options, there are a few variables that are preset automatically, listed in
Table\ \&239, \(lqAutomatic Variables\(rq\&. A value specified for these variables using
\fB\-D\fR
takes precedence over the automatic presets\&. Once set, a variable\*(Aqs value can be inserted into a SQL command by writing
:\fIvariablename\fR\&. When running more than one client session, each session has its own set of variables\&.
.sp
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.B Table\ \&239.\ \&Automatic Variables
.TS
allbox tab(:);
lB lB.
T{
Variable
T}:T{
Description
T}
.T&
l l
l l.
T{
scale
T}:T{
current scale factor
T}
T{
client_id
T}:T{
unique number identifying the client session (starts from zero)
T}
.TE
.sp 1
.PP
Script file meta commands begin with a backslash (\e) and extend to the end of the line\&. Arguments to a meta command are separated by white space\&. These meta commands are supported:
.PP
\eset \fIvarname\fR \fIexpression\fR
.RS 4
Sets variable
\fIvarname\fR
to a value calculated from
\fIexpression\fR\&. The expression may contain integer constants such as
5432, double constants such as
3\&.14159, references to variables
:\fIvariablename\fR, unary operators (+,
\-) and binary operators (+,
\-,
*,
/,
%) with their usual precedence and associativity,
function calls, and parentheses\&.
.sp
Examples:
.sp
.if n \{\
.RS 4
.\}
.nf
\eset ntellers 10 * :scale
\eset aid (1021 * random(1, 100000 * :scale)) % (100000 * :scale) + 1
.fi
.if n \{\
.RE
.\}
.RE
.PP
\esleep \fInumber\fR [ us | ms | s ]
.RS 4
Causes script execution to sleep for the specified duration in microseconds (us), milliseconds (ms) or seconds (s)\&. If the unit is omitted then seconds are the default\&.
\fInumber\fR
can be either an integer constant or a
:\fIvariablename\fR
reference to a variable having an integer value\&.
.sp
Example:
.sp
.if n \{\
.RS 4
.\}
.nf
\esleep 10 ms
.fi
.if n \{\
.RE
.\}
.RE
.PP
\esetshell \fIvarname\fR \fIcommand\fR [ \fIargument\fR \&.\&.\&. ]
.RS 4
Sets variable
\fIvarname\fR
to the result of the shell command
\fIcommand\fR
with the given
\fIargument\fR(s)\&. The command must return an integer value through its standard output\&.
.sp
\fIcommand\fR
and each
\fIargument\fR
can be either a text constant or a
:\fIvariablename\fR
reference to a variable\&. If you want to use an
\fIargument\fR
starting with a colon, write an additional colon at the beginning of
\fIargument\fR\&.
.sp
Example:
.sp
.if n \{\
.RS 4
.\}
.nf
\esetshell variable_to_be_assigned command literal_argument :variable ::literal_starting_with_colon
.fi
.if n \{\
.RE
.\}
.RE
.PP
\eshell \fIcommand\fR [ \fIargument\fR \&.\&.\&. ]
.RS 4
Same as
\esetshell, but the result of the command is discarded\&.
.sp
Example:
.sp
.if n \{\
.RS 4
.\}
.nf
\eshell command literal_argument :variable ::literal_starting_with_colon
.fi
.if n \{\
.RE
.\}
.RE
.SS "Built\-In Functions"
.PP
The functions listed in
Table\ \&240, \(lqpgbench Functions\(rq
are built into
pgbench
and may be used in expressions appearing in
\eset\&.
.sp
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.B Table\ \&240.\ \&pgbench Functions
.TS
allbox tab(:);
lB lB lB lB lB.
T{
Function
T}:T{
Return Type
T}:T{
Description
T}:T{
Example
T}:T{
Result
T}
.T&
l l l l l
l l l l l
l l l l l
l l l l l
l l l l l
l l l l l
l l l l l
l l l l l
l l l l l
l l l l l
l l l l l.
T{
\fBabs(\fR\fB\fIa\fR\fR\fB)\fR
T}:T{
same as \fIa\fR
T}:T{
absolute value
T}:T{
abs(\-17)
T}:T{
17
T}
T{
\fBdebug(\fR\fB\fIa\fR\fR\fB)\fR
T}:T{
same as \fIa\fR
T}:T{
print \fIa\fR to stderr,
and return \fIa\fR
T}:T{
debug(5432\&.1)
T}:T{
5432\&.1
T}
T{
\fBdouble(\fR\fB\fIi\fR\fR\fB)\fR
T}:T{
double
T}:T{
cast to double
T}:T{
double(5432)
T}:T{
5432\&.0
T}
T{
\fBgreatest(\fR\fB\fIa\fR\fR\fB [, \fR\fB\fI\&.\&.\&.\fR\fR\fB ] )\fR
T}:T{
double if any \fIa\fR is double, else integer
T}:T{
largest value among arguments
T}:T{
greatest(5, 4, 3, 2)
T}:T{
5
T}
T{
\fBint(\fR\fB\fIx\fR\fR\fB)\fR
T}:T{
integer
T}:T{
cast to int
T}:T{
int(5\&.4 + 3\&.8)
T}:T{
9
T}
T{
\fBleast(\fR\fB\fIa\fR\fR\fB [, \fR\fB\fI\&.\&.\&.\fR\fR\fB ] )\fR
T}:T{
double if any \fIa\fR is double, else integer
T}:T{
smallest value among arguments
T}:T{
least(5, 4, 3, 2\&.1)
T}:T{
2\&.1
T}
T{
\fBpi()\fR
T}:T{
double
T}:T{
value of the constant PI
T}:T{
pi()
T}:T{
3\&.14159265358979323846
T}
T{
\fBrandom(\fR\fB\fIlb\fR\fR\fB, \fR\fB\fIub\fR\fR\fB)\fR
T}:T{
integer
T}:T{
uniformly\-distributed random integer in [lb, ub]
T}:T{
random(1, 10)
T}:T{
an integer between 1 and 10
T}
T{
\fBrandom_exponential(\fR\fB\fIlb\fR\fR\fB, \fR\fB\fIub\fR\fR\fB, \fR\fB\fIparameter\fR\fR\fB)\fR
T}:T{
integer
T}:T{
exponentially\-distributed random integer in [lb, ub],
see below
T}:T{
random_exponential(1, 10, 3\&.0)
T}:T{
an integer between 1 and 10
T}
T{
\fBrandom_gaussian(\fR\fB\fIlb\fR\fR\fB, \fR\fB\fIub\fR\fR\fB, \fR\fB\fIparameter\fR\fR\fB)\fR
T}:T{
integer
T}:T{
Gaussian\-distributed random integer in [lb, ub],
see below
T}:T{
random_gaussian(1, 10, 2\&.5)
T}:T{
an integer between 1 and 10
T}
T{
\fBsqrt(\fR\fB\fIx\fR\fR\fB)\fR
T}:T{
double
T}:T{
square root
T}:T{
sqrt(2\&.0)
T}:T{
1\&.414213562
T}
.TE
.sp 1
.PP
The
random
function generates values using a uniform distribution, that is all the values are drawn within the specified range with equal probability\&. The
random_exponential
and
random_gaussian
functions require an additional double parameter which determines the precise shape of the distribution\&.
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
For an exponential distribution,
\fIparameter\fR
controls the distribution by truncating a quickly\-decreasing exponential distribution at
\fIparameter\fR, and then projecting onto integers between the bounds\&. To be precise, with
.sp
.if n \{\
.RS 4
.\}
.nf
f(x) = exp(\-parameter * (x \- min) / (max \- min + 1)) / (1 \- exp(\-parameter))
.fi
.if n \{\
.RE
.\}
.sp
Then value
\fIi\fR
between
\fImin\fR
and
\fImax\fR
inclusive is drawn with probability:
f(i) \- f(i + 1)\&.
.sp
Intuitively, the larger the
\fIparameter\fR, the more frequently values close to
\fImin\fR
are accessed, and the less frequently values close to
\fImax\fR
are accessed\&. The closer to 0
\fIparameter\fR
is, the flatter (more uniform) the access distribution\&. A crude approximation of the distribution is that the most frequent 1% values in the range, close to
\fImin\fR, are drawn
\fIparameter\fR% of the time\&. The
\fIparameter\fR
value must be strictly positive\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
For a Gaussian distribution, the interval is mapped onto a standard normal distribution (the classical bell\-shaped Gaussian curve) truncated at
\-parameter
on the left and
+parameter
on the right\&. Values in the middle of the interval are more likely to be drawn\&. To be precise, if
PHI(x)
is the cumulative distribution function of the standard normal distribution, with mean
mu
defined as
(max + min) / 2\&.0, with
.sp
.if n \{\
.RS 4
.\}
.nf
f(x) = PHI(2\&.0 * parameter * (x \- mu) / (max \- min + 1)) /
(2\&.0 * PHI(parameter) \- 1)
.fi
.if n \{\
.RE
.\}
.sp
then value
\fIi\fR
between
\fImin\fR
and
\fImax\fR
inclusive is drawn with probability:
f(i + 0\&.5) \- f(i \- 0\&.5)\&. Intuitively, the larger the
\fIparameter\fR, the more frequently values close to the middle of the interval are drawn, and the less frequently values close to the
\fImin\fR
and
\fImax\fR
bounds\&. About 67% of values are drawn from the middle
1\&.0 / parameter, that is a relative
0\&.5 / parameter
around the mean, and 95% in the middle
2\&.0 / parameter, that is a relative
1\&.0 / parameter
around the mean; for instance, if
\fIparameter\fR
is 4\&.0, 67% of values are drawn from the middle quarter (1\&.0 / 4\&.0) of the interval (i\&.e\&., from
3\&.0 / 8\&.0
to
5\&.0 / 8\&.0) and 95% from the middle half (2\&.0 / 4\&.0) of the interval (second and third quartiles)\&. The minimum
\fIparameter\fR
is 2\&.0 for performance of the Box\-Muller transform\&.
.RE
.PP
As an example, the full definition of the built\-in TPC\-B\-like transaction is:
.sp
.if n \{\
.RS 4
.\}
.nf
\eset aid random(1, 100000 * :scale)
\eset bid random(1, 1 * :scale)
\eset tid random(1, 10 * :scale)
\eset delta random(\-5000, 5000)
BEGIN;
UPDATE pgbench_accounts SET abalance = abalance + :delta WHERE aid = :aid;
SELECT abalance FROM pgbench_accounts WHERE aid = :aid;
UPDATE pgbench_tellers SET tbalance = tbalance + :delta WHERE tid = :tid;
UPDATE pgbench_branches SET bbalance = bbalance + :delta WHERE bid = :bid;
INSERT INTO pgbench_history (tid, bid, aid, delta, mtime) VALUES (:tid, :bid, :aid, :delta, CURRENT_TIMESTAMP);
END;
.fi
.if n \{\
.RE
.\}
.sp
This script allows each iteration of the transaction to reference different, randomly\-chosen rows\&. (This example also shows why it\*(Aqs important for each client session to have its own variables \(em otherwise they\*(Aqd not be independently touching different rows\&.)
.SS "Per\-Transaction Logging"
.PP
With the
\fB\-l\fR
option but without the
\fB\-\-aggregate\-interval\fR,
pgbench
writes the time taken by each transaction to a log file\&. The log file will be named
pgbench_log\&.\fInnn\fR, where
\fInnn\fR
is the PID of the
pgbench
process\&. If the
\fB\-j\fR
option is 2 or higher, creating multiple worker threads, each will have its own log file\&. The first worker will use the same name for its log file as in the standard single worker case\&. The additional log files for the other workers will be named
pgbench_log\&.\fInnn\fR\&.\fImmm\fR, where
\fImmm\fR
is a sequential number for each worker starting with 1\&.
.PP
The format of the log is:
.sp
.if n \{\
.RS 4
.\}
.nf
\fIclient_id\fR \fItransaction_no\fR \fItime\fR \fIscript_no\fR \fItime_epoch\fR \fItime_us\fR [\fIschedule_lag\fR]
.fi
.if n \{\
.RE
.\}
.sp
where
\fItime\fR
is the total elapsed transaction time in microseconds,
\fIscript_no\fR
identifies which script file was used (useful when multiple scripts were specified with
\fB\-f\fR
or
\fB\-b\fR), and
\fItime_epoch\fR/\fItime_us\fR
are a Unix epoch format time stamp and an offset in microseconds (suitable for creating an ISO 8601 time stamp with fractional seconds) showing when the transaction completed\&. Field
\fIschedule_lag\fR
is the difference between the transaction\*(Aqs scheduled start time, and the time it actually started, in microseconds\&. It is only present when the
\fB\-\-rate\fR
option is used\&. When both
\fB\-\-rate\fR
and
\fB\-\-latency\-limit\fR
are used, the
\fItime\fR
for a skipped transaction will be reported as
skipped\&.
.PP
Here is a snippet of the log file generated:
.sp
.if n \{\
.RS 4
.\}
.nf
0 199 2241 0 1175850568 995598
0 200 2465 0 1175850568 998079
0 201 2513 0 1175850569 608
0 202 2038 0 1175850569 2663
.fi
.if n \{\
.RE
.\}
.sp
Another example with \-\-rate=100 and \-\-latency\-limit=5 (note the additional
\fIschedule_lag\fR
column):
.sp
.if n \{\
.RS 4
.\}
.nf
0 81 4621 0 1412881037 912698 3005
0 82 6173 0 1412881037 914578 4304
0 83 skipped 0 1412881037 914578 5217
0 83 skipped 0 1412881037 914578 5099
0 83 4722 0 1412881037 916203 3108
0 84 4142 0 1412881037 918023 2333
0 85 2465 0 1412881037 919759 740
.fi
.if n \{\
.RE
.\}
.sp
In this example, transaction 82 was late, because its latency (6\&.173 ms) was over the 5 ms limit\&. The next two transactions were skipped, because they were already late before they were even started\&.
.PP
When running a long test on hardware that can handle a lot of transactions, the log files can become very large\&. The
\fB\-\-sampling\-rate\fR
option can be used to log only a random sample of transactions\&.
.SS "Aggregated Logging"
.PP
With the
\fB\-\-aggregate\-interval\fR
option, the logs use a bit different format:
.sp
.if n \{\
.RS 4
.\}
.nf
\fIinterval_start\fR \fInum_of_transactions\fR \fIlatency_sum\fR \fIlatency_2_sum\fR \fImin_latency\fR \fImax_latency\fR [\fIlag_sum\fR \fIlag_2_sum\fR \fImin_lag\fR \fImax_lag\fR [\fIskipped_transactions\fR]]
.fi
.if n \{\
.RE
.\}
.sp
where
\fIinterval_start\fR
is the start of the interval (Unix epoch format time stamp),
\fInum_of_transactions\fR
is the number of transactions within the interval,
\fIlatency_sum\fR
is a sum of latencies (so you can compute average latency easily)\&. The following two fields are useful for variance estimation \-
\fIlatency_sum\fR
is a sum of latencies and
\fIlatency_2_sum\fR
is a sum of 2nd powers of latencies\&. The next two fields are
\fImin_latency\fR
\- a minimum latency within the interval, and
\fImax_latency\fR
\- maximum latency within the interval\&. A transaction is counted into the interval when it was committed\&. The fields in the end,
\fIlag_sum\fR,
\fIlag_2_sum\fR,
\fImin_lag\fR, and
\fImax_lag\fR, are only present if the
\fB\-\-rate\fR
option is used\&. The very last one,
\fIskipped_transactions\fR, is only present if the option
\fB\-\-latency\-limit\fR
is present, too\&. They are calculated from the time each transaction had to wait for the previous one to finish, i\&.e\&., the difference between each transaction\*(Aqs scheduled start time and the time it actually started\&.
.PP
Here is example output:
.sp
.if n \{\
.RS 4
.\}
.nf
1345828501 5601 1542744 483552416 61 2573
1345828503 7884 1979812 565806736 60 1479
1345828505 7208 1979422 567277552 59 1391
1345828507 7685 1980268 569784714 60 1398
1345828509 7073 1979779 573489941 236 1411
.fi
.if n \{\
.RE
.\}
.PP
Notice that while the plain (unaggregated) log file contains a reference to the custom script files, the aggregated log does not\&. Therefore if you need per script data, you need to aggregate the data on your own\&.
.SS "Per\-Statement Latencies"
.PP
With the
\fB\-r\fR
option,
pgbench
collects the elapsed transaction time of each statement executed by every client\&. It then reports an average of those values, referred to as the latency for each statement, after the benchmark has finished\&.
.PP
For the default script, the output will look similar to this:
.sp
.if n \{\
.RS 4
.\}
.nf
starting vacuum\&.\&.\&.end\&.
transaction type: <builtin: TPC\-B (sort of)>
scaling factor: 1
query mode: simple
number of clients: 10
number of threads: 1
number of transactions per client: 1000
number of transactions actually processed: 10000/10000
latency average = 15\&.844 ms
latency stddev = 2\&.715 ms
tps = 618\&.764555 (including connections establishing)
tps = 622\&.977698 (excluding connections establishing)
script statistics:
\- statement latencies in milliseconds:
0\&.002 \eset aid random(1, 100000 * :scale)
0\&.005 \eset bid random(1, 1 * :scale)
0\&.002 \eset tid random(1, 10 * :scale)
0\&.001 \eset delta random(\-5000, 5000)
0\&.326 BEGIN;
0\&.603 UPDATE pgbench_accounts SET abalance = abalance + :delta WHERE aid = :aid;
0\&.454 SELECT abalance FROM pgbench_accounts WHERE aid = :aid;
5\&.528 UPDATE pgbench_tellers SET tbalance = tbalance + :delta WHERE tid = :tid;
7\&.335 UPDATE pgbench_branches SET bbalance = bbalance + :delta WHERE bid = :bid;
0\&.371 INSERT INTO pgbench_history (tid, bid, aid, delta, mtime) VALUES (:tid, :bid, :aid, :delta, CURRENT_TIMESTAMP);
1\&.212 END;
.fi
.if n \{\
.RE
.\}
.PP
If multiple script files are specified, the averages are reported separately for each script file\&.
.PP
Note that collecting the additional timing information needed for per\-statement latency computation adds some overhead\&. This will slow average execution speed and lower the computed TPS\&. The amount of slowdown varies significantly depending on platform and hardware\&. Comparing average TPS values with and without latency reporting enabled is a good way to measure if the timing overhead is significant\&.
.SS "Good Practices"
.PP
It is very easy to use
pgbench
to produce completely meaningless numbers\&. Here are some guidelines to help you get useful results\&.
.PP
In the first place,
\fInever\fR
believe any test that runs for only a few seconds\&. Use the
\fB\-t\fR
or
\fB\-T\fR
option to make the run last at least a few minutes, so as to average out noise\&. In some cases you could need hours to get numbers that are reproducible\&. It\*(Aqs a good idea to try the test run a few times, to find out if your numbers are reproducible or not\&.
.PP
For the default TPC\-B\-like test scenario, the initialization scale factor (\fB\-s\fR) should be at least as large as the largest number of clients you intend to test (\fB\-c\fR); else you\*(Aqll mostly be measuring update contention\&. There are only
\fB\-s\fR
rows in the
pgbench_branches
table, and every transaction wants to update one of them, so
\fB\-c\fR
values in excess of
\fB\-s\fR
will undoubtedly result in lots of transactions blocked waiting for other transactions\&.
.PP
The default test scenario is also quite sensitive to how long it\*(Aqs been since the tables were initialized: accumulation of dead rows and dead space in the tables changes the results\&. To understand the results you must keep track of the total number of updates and when vacuuming happens\&. If autovacuum is enabled it can result in unpredictable changes in measured performance\&.
.PP
A limitation of
pgbench
is that it can itself become the bottleneck when trying to test a large number of client sessions\&. This can be alleviated by running
pgbench
on a different machine from the database server, although low network latency will be essential\&. It might even be useful to run several
pgbench
instances concurrently, on several client machines, against the same database server\&.
.SS "Security"
.PP
If untrusted users have access to a database that has not adopted a
secure schema usage pattern, do not run
pgbench
in that database\&.
pgbench
uses unqualified names and does not manipulate the search path\&.
man/man1/pg_test_timing.1 0000644 00000023370 14751153421 0011261 0 ustar 00 '\" t
.\" Title: pg_test_timing
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "PG_TEST_TIMING" "1" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
pg_test_timing \- measure timing overhead
.SH "SYNOPSIS"
.HP \w'\fBpg_test_timing\fR\ 'u
\fBpg_test_timing\fR [\fIoption\fR...]
.SH "DESCRIPTION"
.PP
pg_test_timing
is a tool to measure the timing overhead on your system and confirm that the system time never moves backwards\&. Systems that are slow to collect timing data can give less accurate
\fBEXPLAIN ANALYZE\fR
results\&.
.SH "OPTIONS"
.PP
pg_test_timing
accepts the following command\-line options:
.PP
\fB\-d \fR\fB\fIduration\fR\fR
.br
\fB\-\-duration=\fR\fB\fIduration\fR\fR
.RS 4
Specifies the test duration, in seconds\&. Longer durations give slightly better accuracy, and are more likely to discover problems with the system clock moving backwards\&. The default test duration is 3 seconds\&.
.RE
.PP
\fB\-V\fR
.br
\fB\-\-version\fR
.RS 4
Print the
pg_test_timing
version and exit\&.
.RE
.PP
\fB\-?\fR
.br
\fB\-\-help\fR
.RS 4
Show help about
pg_test_timing
command line arguments, and exit\&.
.RE
.SH "USAGE"
.SS "Interpreting results"
.PP
Good results will show most (>90%) individual timing calls take less than one microsecond\&. Average per loop overhead will be even lower, below 100 nanoseconds\&. This example from an Intel i7\-860 system using a TSC clock source shows excellent performance:
.sp
.if n \{\
.RS 4
.\}
.nf
Testing timing overhead for 3 seconds\&.
Per loop time including overhead: 35\&.96 nsec
Histogram of timing durations:
< usec % of total count
1 96\&.40465 80435604
2 3\&.59518 2999652
4 0\&.00015 126
8 0\&.00002 13
16 0\&.00000 2
.fi
.if n \{\
.RE
.\}
.PP
Note that different units are used for the per loop time than the histogram\&. The loop can have resolution within a few nanoseconds (nsec), while the individual timing calls can only resolve down to one microsecond (usec)\&.
.SS "Measuring executor timing overhead"
.PP
When the query executor is running a statement using
\fBEXPLAIN ANALYZE\fR, individual operations are timed as well as showing a summary\&. The overhead of your system can be checked by counting rows with the
psql
program:
.sp
.if n \{\
.RS 4
.\}
.nf
CREATE TABLE t AS SELECT * FROM generate_series(1,100000);
\etiming
SELECT COUNT(*) FROM t;
EXPLAIN ANALYZE SELECT COUNT(*) FROM t;
.fi
.if n \{\
.RE
.\}
.PP
The i7\-860 system measured runs the count query in 9\&.8 ms while the
\fBEXPLAIN ANALYZE\fR
version takes 16\&.6 ms, each processing just over 100,000 rows\&. That 6\&.8 ms difference means the timing overhead per row is 68 ns, about twice what pg_test_timing estimated it would be\&. Even that relatively small amount of overhead is making the fully timed count statement take almost 70% longer\&. On more substantial queries, the timing overhead would be less problematic\&.
.SS "Changing time sources"
.PP
On some newer Linux systems, it\*(Aqs possible to change the clock source used to collect timing data at any time\&. A second example shows the slowdown possible from switching to the slower acpi_pm time source, on the same system used for the fast results above:
.sp
.if n \{\
.RS 4
.\}
.nf
# cat /sys/devices/system/clocksource/clocksource0/available_clocksource
tsc hpet acpi_pm
# echo acpi_pm > /sys/devices/system/clocksource/clocksource0/current_clocksource
# pg_test_timing
Per loop time including overhead: 722\&.92 nsec
Histogram of timing durations:
< usec % of total count
1 27\&.84870 1155682
2 72\&.05956 2990371
4 0\&.07810 3241
8 0\&.01357 563
16 0\&.00007 3
.fi
.if n \{\
.RE
.\}
.PP
In this configuration, the sample
\fBEXPLAIN ANALYZE\fR
above takes 115\&.9 ms\&. That\*(Aqs 1061 nsec of timing overhead, again a small multiple of what\*(Aqs measured directly by this utility\&. That much timing overhead means the actual query itself is only taking a tiny fraction of the accounted for time, most of it is being consumed in overhead instead\&. In this configuration, any
\fBEXPLAIN ANALYZE\fR
totals involving many timed operations would be inflated significantly by timing overhead\&.
.PP
FreeBSD also allows changing the time source on the fly, and it logs information about the timer selected during boot:
.sp
.if n \{\
.RS 4
.\}
.nf
# dmesg | grep "Timecounter"
Timecounter "ACPI\-fast" frequency 3579545 Hz quality 900
Timecounter "i8254" frequency 1193182 Hz quality 0
Timecounters tick every 10\&.000 msec
Timecounter "TSC" frequency 2531787134 Hz quality 800
# sysctl kern\&.timecounter\&.hardware=TSC
kern\&.timecounter\&.hardware: ACPI\-fast \-> TSC
.fi
.if n \{\
.RE
.\}
.PP
Other systems may only allow setting the time source on boot\&. On older Linux systems the "clock" kernel setting is the only way to make this sort of change\&. And even on some more recent ones, the only option you\*(Aqll see for a clock source is "jiffies"\&. Jiffies are the older Linux software clock implementation, which can have good resolution when it\*(Aqs backed by fast enough timing hardware, as in this example:
.sp
.if n \{\
.RS 4
.\}
.nf
$ cat /sys/devices/system/clocksource/clocksource0/available_clocksource
jiffies
$ dmesg | grep time\&.c
time\&.c: Using 3\&.579545 MHz WALL PM GTOD PIT/TSC timer\&.
time\&.c: Detected 2400\&.153 MHz processor\&.
$ pg_test_timing
Testing timing overhead for 3 seconds\&.
Per timing duration including loop overhead: 97\&.75 ns
Histogram of timing durations:
< usec % of total count
1 90\&.23734 27694571
2 9\&.75277 2993204
4 0\&.00981 3010
8 0\&.00007 22
16 0\&.00000 1
32 0\&.00000 1
.fi
.if n \{\
.RE
.\}
.SS "Clock hardware and timing accuracy"
.PP
Collecting accurate timing information is normally done on computers using hardware clocks with various levels of accuracy\&. With some hardware the operating systems can pass the system clock time almost directly to programs\&. A system clock can also be derived from a chip that simply provides timing interrupts, periodic ticks at some known time interval\&. In either case, operating system kernels provide a clock source that hides these details\&. But the accuracy of that clock source and how quickly it can return results varies based on the underlying hardware\&.
.PP
Inaccurate time keeping can result in system instability\&. Test any change to the clock source very carefully\&. Operating system defaults are sometimes made to favor reliability over best accuracy\&. And if you are using a virtual machine, look into the recommended time sources compatible with it\&. Virtual hardware faces additional difficulties when emulating timers, and there are often per operating system settings suggested by vendors\&.
.PP
The Time Stamp Counter (TSC) clock source is the most accurate one available on current generation CPUs\&. It\*(Aqs the preferred way to track the system time when it\*(Aqs supported by the operating system and the TSC clock is reliable\&. There are several ways that TSC can fail to provide an accurate timing source, making it unreliable\&. Older systems can have a TSC clock that varies based on the CPU temperature, making it unusable for timing\&. Trying to use TSC on some older multicore CPUs can give a reported time that\*(Aqs inconsistent among multiple cores\&. This can result in the time going backwards, a problem this program checks for\&. And even the newest systems can fail to provide accurate TSC timing with very aggressive power saving configurations\&.
.PP
Newer operating systems may check for the known TSC problems and switch to a slower, more stable clock source when they are seen\&. If your system supports TSC time but doesn\*(Aqt default to that, it may be disabled for a good reason\&. And some operating systems may not detect all the possible problems correctly, or will allow using TSC even in situations where it\*(Aqs known to be inaccurate\&.
.PP
The High Precision Event Timer (HPET) is the preferred timer on systems where it\*(Aqs available and TSC is not accurate\&. The timer chip itself is programmable to allow up to 100 nanosecond resolution, but you may not see that much accuracy in your system clock\&.
.PP
Advanced Configuration and Power Interface (ACPI) provides a Power Management (PM) Timer, which Linux refers to as the acpi_pm\&. The clock derived from acpi_pm will at best provide 300 nanosecond resolution\&.
.PP
Timers used on older PC hardware include the 8254 Programmable Interval Timer (PIT), the real\-time clock (RTC), the Advanced Programmable Interrupt Controller (APIC) timer, and the Cyclone timer\&. These timers aim for millisecond resolution\&.
.SH "SEE ALSO"
\fBEXPLAIN\fR(7)
man/man1/pg_dumpall.1 0000644 00000033376 14751153421 0010400 0 ustar 00 '\" t
.\" Title: pg_dumpall
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "PG_DUMPALL" "1" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
pg_dumpall \- extract a PostgreSQL database cluster into a script file
.SH "SYNOPSIS"
.HP \w'\fBpg_dumpall\fR\ 'u
\fBpg_dumpall\fR [\fIconnection\-option\fR...] [\fIoption\fR...]
.SH "DESCRIPTION"
.PP
pg_dumpall
is a utility for writing out (\(lqdumping\(rq) all
PostgreSQL
databases of a cluster into one script file\&. The script file contains
SQL
commands that can be used as input to
\fBpsql\fR(1)
to restore the databases\&. It does this by calling
\fBpg_dump\fR(1)
for each database in a cluster\&.
pg_dumpall
also dumps global objects that are common to all databases\&. (pg_dump
does not save these objects\&.) This currently includes information about database users and groups, tablespaces, and properties such as access permissions that apply to databases as a whole\&.
.PP
Since
pg_dumpall
reads tables from all databases you will most likely have to connect as a database superuser in order to produce a complete dump\&. Also you will need superuser privileges to execute the saved script in order to be allowed to add users and groups, and to create databases\&.
.PP
The SQL script will be written to the standard output\&. Use the
\fB\-f\fR/\fB\-\-file\fR
option or shell operators to redirect it into a file\&.
.PP
pg_dumpall
needs to connect several times to the
PostgreSQL
server (once per database)\&. If you use password authentication it will ask for a password each time\&. It is convenient to have a
~/\&.pgpass
file in such cases\&. See
Section 32.15, \(lqThe Password File\(rq, in the documentation
for more information\&.
.SH "OPTIONS"
.PP
The following command\-line options control the content and format of the output\&.
.PP
\fB\-a\fR
.br
\fB\-\-data\-only\fR
.RS 4
Dump only the data, not the schema (data definitions)\&.
.RE
.PP
\fB\-c\fR
.br
\fB\-\-clean\fR
.RS 4
Include SQL commands to clean (drop) databases before recreating them\&.
\fBDROP\fR
commands for roles and tablespaces are added as well\&.
.RE
.PP
\fB\-f \fR\fB\fIfilename\fR\fR
.br
\fB\-\-file=\fR\fB\fIfilename\fR\fR
.RS 4
Send output to the specified file\&. If this is omitted, the standard output is used\&.
.RE
.PP
\fB\-g\fR
.br
\fB\-\-globals\-only\fR
.RS 4
Dump only global objects (roles and tablespaces), no databases\&.
.RE
.PP
\fB\-o\fR
.br
\fB\-\-oids\fR
.RS 4
Dump object identifiers (OIDs) as part of the data for every table\&. Use this option if your application references the
OID
columns in some way (e\&.g\&., in a foreign key constraint)\&. Otherwise, this option should not be used\&.
.RE
.PP
\fB\-O\fR
.br
\fB\-\-no\-owner\fR
.RS 4
Do not output commands to set ownership of objects to match the original database\&. By default,
pg_dumpall
issues
\fBALTER OWNER\fR
or
\fBSET SESSION AUTHORIZATION\fR
statements to set ownership of created schema elements\&. These statements will fail when the script is run unless it is started by a superuser (or the same user that owns all of the objects in the script)\&. To make a script that can be restored by any user, but will give that user ownership of all the objects, specify
\fB\-O\fR\&.
.RE
.PP
\fB\-r\fR
.br
\fB\-\-roles\-only\fR
.RS 4
Dump only roles, no databases or tablespaces\&.
.RE
.PP
\fB\-s\fR
.br
\fB\-\-schema\-only\fR
.RS 4
Dump only the object definitions (schema), not data\&.
.RE
.PP
\fB\-S \fR\fB\fIusername\fR\fR
.br
\fB\-\-superuser=\fR\fB\fIusername\fR\fR
.RS 4
Specify the superuser user name to use when disabling triggers\&. This is relevant only if
\fB\-\-disable\-triggers\fR
is used\&. (Usually, it\*(Aqs better to leave this out, and instead start the resulting script as superuser\&.)
.RE
.PP
\fB\-t\fR
.br
\fB\-\-tablespaces\-only\fR
.RS 4
Dump only tablespaces, no databases or roles\&.
.RE
.PP
\fB\-v\fR
.br
\fB\-\-verbose\fR
.RS 4
Specifies verbose mode\&. This will cause
pg_dumpall
to output start/stop times to the dump file, and progress messages to standard error\&. It will also enable verbose output in
pg_dump\&.
.RE
.PP
\fB\-V\fR
.br
\fB\-\-version\fR
.RS 4
Print the
pg_dumpall
version and exit\&.
.RE
.PP
\fB\-x\fR
.br
\fB\-\-no\-privileges\fR
.br
\fB\-\-no\-acl\fR
.RS 4
Prevent dumping of access privileges (grant/revoke commands)\&.
.RE
.PP
\fB\-\-binary\-upgrade\fR
.RS 4
This option is for use by in\-place upgrade utilities\&. Its use for other purposes is not recommended or supported\&. The behavior of the option may change in future releases without notice\&.
.RE
.PP
\fB\-\-column\-inserts\fR
.br
\fB\-\-attribute\-inserts\fR
.RS 4
Dump data as
\fBINSERT\fR
commands with explicit column names (INSERT INTO \fItable\fR (\fIcolumn\fR, \&.\&.\&.) VALUES \&.\&.\&.)\&. This will make restoration very slow; it is mainly useful for making dumps that can be loaded into non\-PostgreSQL
databases\&.
.RE
.PP
\fB\-\-disable\-dollar\-quoting\fR
.RS 4
This option disables the use of dollar quoting for function bodies, and forces them to be quoted using SQL standard string syntax\&.
.RE
.PP
\fB\-\-disable\-triggers\fR
.RS 4
This option is relevant only when creating a data\-only dump\&. It instructs
pg_dumpall
to include commands to temporarily disable triggers on the target tables while the data is reloaded\&. Use this if you have referential integrity checks or other triggers on the tables that you do not want to invoke during data reload\&.
.sp
Presently, the commands emitted for
\fB\-\-disable\-triggers\fR
must be done as superuser\&. So, you should also specify a superuser name with
\fB\-S\fR, or preferably be careful to start the resulting script as a superuser\&.
.RE
.PP
\fB\-\-if\-exists\fR
.RS 4
Use conditional commands (i\&.e\&., add an
IF EXISTS
clause) to clean databases and other objects\&. This option is not valid unless
\fB\-\-clean\fR
is also specified\&.
.RE
.PP
\fB\-\-inserts\fR
.RS 4
Dump data as
\fBINSERT\fR
commands (rather than
\fBCOPY\fR)\&. This will make restoration very slow; it is mainly useful for making dumps that can be loaded into non\-PostgreSQL
databases\&. Note that the restore might fail altogether if you have rearranged column order\&. The
\fB\-\-column\-inserts\fR
option is safer, though even slower\&.
.RE
.PP
\fB\-\-lock\-wait\-timeout=\fR\fB\fItimeout\fR\fR
.RS 4
Do not wait forever to acquire shared table locks at the beginning of the dump\&. Instead, fail if unable to lock a table within the specified
\fItimeout\fR\&. The timeout may be specified in any of the formats accepted by
\fBSET statement_timeout\fR\&. Allowed values vary depending on the server version you are dumping from, but an integer number of milliseconds is accepted by all versions since 7\&.3\&. This option is ignored when dumping from a pre\-7\&.3 server\&.
.RE
.PP
\fB\-\-no\-security\-labels\fR
.RS 4
Do not dump security labels\&.
.RE
.PP
\fB\-\-no\-tablespaces\fR
.RS 4
Do not output commands to create tablespaces nor select tablespaces for objects\&. With this option, all objects will be created in whichever tablespace is the default during restore\&.
.RE
.PP
\fB\-\-no\-unlogged\-table\-data\fR
.RS 4
Do not dump the contents of unlogged tables\&. This option has no effect on whether or not the table definitions (schema) are dumped; it only suppresses dumping the table data\&.
.RE
.PP
\fB\-\-quote\-all\-identifiers\fR
.RS 4
Force quoting of all identifiers\&. This option is recommended when dumping a database from a server whose
PostgreSQL
major version is different from
pg_dumpall\*(Aqs, or when the output is intended to be loaded into a server of a different major version\&. By default,
pg_dumpall
quotes only identifiers that are reserved words in its own major version\&. This sometimes results in compatibility issues when dealing with servers of other versions that may have slightly different sets of reserved words\&. Using
\fB\-\-quote\-all\-identifiers\fR
prevents such issues, at the price of a harder\-to\-read dump script\&.
.RE
.PP
\fB\-\-use\-set\-session\-authorization\fR
.RS 4
Output SQL\-standard
\fBSET SESSION AUTHORIZATION\fR
commands instead of
\fBALTER OWNER\fR
commands to determine object ownership\&. This makes the dump more standards compatible, but depending on the history of the objects in the dump, might not restore properly\&.
.RE
.PP
\fB\-?\fR
.br
\fB\-\-help\fR
.RS 4
Show help about
pg_dumpall
command line arguments, and exit\&.
.RE
.PP
The following command\-line options control the database connection parameters\&.
.PP
\fB\-d \fR\fB\fIconnstr\fR\fR
.br
\fB\-\-dbname=\fR\fB\fIconnstr\fR\fR
.RS 4
Specifies parameters used to connect to the server, as a
connection string; these will override any conflicting command line options\&.
.sp
The option is called
\-\-dbname
for consistency with other client applications, but because
pg_dumpall
needs to connect to many databases, database name in the connection string will be ignored\&. Use
\-l
option to specify the name of the database used to dump global objects and to discover what other databases should be dumped\&.
.RE
.PP
\fB\-h \fR\fB\fIhost\fR\fR
.br
\fB\-\-host=\fR\fB\fIhost\fR\fR
.RS 4
Specifies the host name of the machine on which the database server is running\&. If the value begins with a slash, it is used as the directory for the Unix domain socket\&. The default is taken from the
\fBPGHOST\fR
environment variable, if set, else a Unix domain socket connection is attempted\&.
.RE
.PP
\fB\-l \fR\fB\fIdbname\fR\fR
.br
\fB\-\-database=\fR\fB\fIdbname\fR\fR
.RS 4
Specifies the name of the database to connect to for dumping global objects and discovering what other databases should be dumped\&. If not specified, the
postgres
database will be used, and if that does not exist,
template1
will be used\&.
.RE
.PP
\fB\-p \fR\fB\fIport\fR\fR
.br
\fB\-\-port=\fR\fB\fIport\fR\fR
.RS 4
Specifies the TCP port or local Unix domain socket file extension on which the server is listening for connections\&. Defaults to the
\fBPGPORT\fR
environment variable, if set, or a compiled\-in default\&.
.RE
.PP
\fB\-U \fR\fB\fIusername\fR\fR
.br
\fB\-\-username=\fR\fB\fIusername\fR\fR
.RS 4
User name to connect as\&.
.RE
.PP
\fB\-w\fR
.br
\fB\-\-no\-password\fR
.RS 4
Never issue a password prompt\&. If the server requires password authentication and a password is not available by other means such as a
\&.pgpass
file, the connection attempt will fail\&. This option can be useful in batch jobs and scripts where no user is present to enter a password\&.
.RE
.PP
\fB\-W\fR
.br
\fB\-\-password\fR
.RS 4
Force
pg_dumpall
to prompt for a password before connecting to a database\&.
.sp
This option is never essential, since
pg_dumpall
will automatically prompt for a password if the server demands password authentication\&. However,
pg_dumpall
will waste a connection attempt finding out that the server wants a password\&. In some cases it is worth typing
\fB\-W\fR
to avoid the extra connection attempt\&.
.sp
Note that the password prompt will occur again for each database to be dumped\&. Usually, it\*(Aqs better to set up a
~/\&.pgpass
file than to rely on manual password entry\&.
.RE
.PP
\fB\-\-role=\fR\fB\fIrolename\fR\fR
.RS 4
Specifies a role name to be used to create the dump\&. This option causes
pg_dumpall
to issue a
\fBSET ROLE\fR
\fIrolename\fR
command after connecting to the database\&. It is useful when the authenticated user (specified by
\fB\-U\fR) lacks privileges needed by
pg_dumpall, but can switch to a role with the required rights\&. Some installations have a policy against logging in directly as a superuser, and use of this option allows dumps to be made without violating the policy\&.
.RE
.SH "ENVIRONMENT"
.PP
\fBPGHOST\fR
.br
\fBPGOPTIONS\fR
.br
\fBPGPORT\fR
.br
\fBPGUSER\fR
.RS 4
Default connection parameters
.RE
.PP
This utility, like most other
PostgreSQL
utilities, also uses the environment variables supported by
libpq
(see
Section 32.14, \(lqEnvironment Variables\(rq, in the documentation)\&.
.SH "NOTES"
.PP
Since
pg_dumpall
calls
pg_dump
internally, some diagnostic messages will refer to
pg_dump\&.
.PP
Once restored, it is wise to run
\fBANALYZE\fR
on each database so the optimizer has useful statistics\&. You can also run
\fBvacuumdb \-a \-z\fR
to analyze all databases\&.
.PP
pg_dumpall
requires all needed tablespace directories to exist before the restore; otherwise, database creation will fail for databases in non\-default locations\&.
.SH "EXAMPLES"
.PP
To dump all databases:
.sp
.if n \{\
.RS 4
.\}
.nf
$ \fBpg_dumpall > db\&.out\fR
.fi
.if n \{\
.RE
.\}
.PP
To reload database(s) from this file, you can use:
.sp
.if n \{\
.RS 4
.\}
.nf
$ \fBpsql \-f db\&.out postgres\fR
.fi
.if n \{\
.RE
.\}
.sp
(It is not important to which database you connect here since the script file created by
pg_dumpall
will contain the appropriate commands to create and connect to the saved databases\&.)
.SH "SEE ALSO"
.PP
Check
\fBpg_dump\fR(1)
for details on possible error conditions\&.
man/man1/pg_restore.1 0000644 00000054252 14751153421 0010421 0 ustar 00 '\" t
.\" Title: pg_restore
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "PG_RESTORE" "1" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
pg_restore \- restore a PostgreSQL database from an archive file created by pg_dump
.SH "SYNOPSIS"
.HP \w'\fBpg_restore\fR\ 'u
\fBpg_restore\fR [\fIconnection\-option\fR...] [\fIoption\fR...] [\fIfilename\fR]
.SH "DESCRIPTION"
.PP
pg_restore
is a utility for restoring a
PostgreSQL
database from an archive created by
\fBpg_dump\fR(1)
in one of the non\-plain\-text formats\&. It will issue the commands necessary to reconstruct the database to the state it was in at the time it was saved\&. The archive files also allow
pg_restore
to be selective about what is restored, or even to reorder the items prior to being restored\&. The archive files are designed to be portable across architectures\&.
.PP
pg_restore
can operate in two modes\&. If a database name is specified,
pg_restore
connects to that database and restores archive contents directly into the database\&. Otherwise, a script containing the SQL commands necessary to rebuild the database is created and written to a file or standard output\&. This script output is equivalent to the plain text output format of
pg_dump\&. Some of the options controlling the output are therefore analogous to
pg_dump
options\&.
.PP
Obviously,
pg_restore
cannot restore information that is not present in the archive file\&. For instance, if the archive was made using the
\(lqdump data as \fBINSERT\fR commands\(rq
option,
pg_restore
will not be able to load the data using
\fBCOPY\fR
statements\&.
.SH "OPTIONS"
.PP
pg_restore
accepts the following command line arguments\&.
.PP
\fIfilename\fR
.RS 4
Specifies the location of the archive file (or directory, for a directory\-format archive) to be restored\&. If not specified, the standard input is used\&.
.RE
.PP
\fB\-a\fR
.br
\fB\-\-data\-only\fR
.RS 4
Restore only the data, not the schema (data definitions)\&. Table data, large objects, and sequence values are restored, if present in the archive\&.
.sp
This option is similar to, but for historical reasons not identical to, specifying
\fB\-\-section=data\fR\&.
.RE
.PP
\fB\-c\fR
.br
\fB\-\-clean\fR
.RS 4
Clean (drop) database objects before recreating them\&. (Unless
\fB\-\-if\-exists\fR
is used, this might generate some harmless error messages, if any objects were not present in the destination database\&.)
.RE
.PP
\fB\-C\fR
.br
\fB\-\-create\fR
.RS 4
Create the database before restoring into it\&. If
\fB\-\-clean\fR
is also specified, drop and recreate the target database before connecting to it\&.
.sp
When this option is used, the database named with
\fB\-d\fR
is used only to issue the initial
\fBDROP DATABASE\fR
and
\fBCREATE DATABASE\fR
commands\&. All data is restored into the database name that appears in the archive\&.
.RE
.PP
\fB\-d \fR\fB\fIdbname\fR\fR
.br
\fB\-\-dbname=\fR\fB\fIdbname\fR\fR
.RS 4
Connect to database
\fIdbname\fR
and restore directly into the database\&. The
\fIdbname\fR
can be a
connection string\&. If so, connection string parameters will override any conflicting command line options\&.
.RE
.PP
\fB\-e\fR
.br
\fB\-\-exit\-on\-error\fR
.RS 4
Exit if an error is encountered while sending SQL commands to the database\&. The default is to continue and to display a count of errors at the end of the restoration\&.
.RE
.PP
\fB\-f \fR\fB\fIfilename\fR\fR
.br
\fB\-\-file=\fR\fB\fIfilename\fR\fR
.RS 4
Specify output file for generated script, or for the listing when used with
\fB\-l\fR\&. Use
\-
for the standard output, which is also the default\&.
.RE
.PP
\fB\-F \fR\fB\fIformat\fR\fR
.br
\fB\-\-format=\fR\fB\fIformat\fR\fR
.RS 4
Specify format of the archive\&. It is not necessary to specify the format, since
pg_restore
will determine the format automatically\&. If specified, it can be one of the following:
.PP
c
.br
custom
.RS 4
The archive is in the custom format of
pg_dump\&.
.RE
.PP
d
.br
directory
.RS 4
The archive is a directory archive\&.
.RE
.PP
t
.br
tar
.RS 4
The archive is a
\fBtar\fR
archive\&.
.RE
.RE
.PP
\fB\-I \fR\fB\fIindex\fR\fR
.br
\fB\-\-index=\fR\fB\fIindex\fR\fR
.RS 4
Restore definition of named index only\&. Multiple indexes may be specified with multiple
\fB\-I\fR
switches\&.
.RE
.PP
\fB\-j \fR\fB\fInumber\-of\-jobs\fR\fR
.br
\fB\-\-jobs=\fR\fB\fInumber\-of\-jobs\fR\fR
.RS 4
Run the most time\-consuming parts of
pg_restore
\(em those which load data, create indexes, or create constraints \(em using multiple concurrent jobs\&. This option can dramatically reduce the time to restore a large database to a server running on a multiprocessor machine\&.
.sp
Each job is one process or one thread, depending on the operating system, and uses a separate connection to the server\&.
.sp
The optimal value for this option depends on the hardware setup of the server, of the client, and of the network\&. Factors include the number of CPU cores and the disk setup\&. A good place to start is the number of CPU cores on the server, but values larger than that can also lead to faster restore times in many cases\&. Of course, values that are too high will lead to decreased performance because of thrashing\&.
.sp
Only the custom and directory archive formats are supported with this option\&. The input must be a regular file or directory (not, for example, a pipe)\&. This option is ignored when emitting a script rather than connecting directly to a database server\&. Also, multiple jobs cannot be used together with the option
\fB\-\-single\-transaction\fR\&.
.RE
.PP
\fB\-l\fR
.br
\fB\-\-list\fR
.RS 4
List the contents of the archive\&. The output of this operation can be used as input to the
\fB\-L\fR
option\&. Note that if filtering switches such as
\fB\-n\fR
or
\fB\-t\fR
are used with
\fB\-l\fR, they will restrict the items listed\&.
.RE
.PP
\fB\-L \fR\fB\fIlist\-file\fR\fR
.br
\fB\-\-use\-list=\fR\fB\fIlist\-file\fR\fR
.RS 4
Restore only those archive elements that are listed in
\fIlist\-file\fR, and restore them in the order they appear in the file\&. Note that if filtering switches such as
\fB\-n\fR
or
\fB\-t\fR
are used with
\fB\-L\fR, they will further restrict the items restored\&.
.sp
\fIlist\-file\fR
is normally created by editing the output of a previous
\fB\-l\fR
operation\&. Lines can be moved or removed, and can also be commented out by placing a semicolon (;) at the start of the line\&. See below for examples\&.
.RE
.PP
\fB\-n \fR\fB\fInamespace\fR\fR
.br
\fB\-\-schema=\fR\fB\fIschema\fR\fR
.RS 4
Restore only objects that are in the named schema\&. Multiple schemas may be specified with multiple
\fB\-n\fR
switches\&. This can be combined with the
\fB\-t\fR
option to restore just a specific table\&.
.RE
.PP
\fB\-O\fR
.br
\fB\-\-no\-owner\fR
.RS 4
Do not output commands to set ownership of objects to match the original database\&. By default,
pg_restore
issues
\fBALTER OWNER\fR
or
\fBSET SESSION AUTHORIZATION\fR
statements to set ownership of created schema elements\&. These statements will fail unless the initial connection to the database is made by a superuser (or the same user that owns all of the objects in the script)\&. With
\fB\-O\fR, any user name can be used for the initial connection, and this user will own all the created objects\&.
.RE
.PP
\fB\-P \fR\fB\fIfunction\-name(argtype [, \&.\&.\&.])\fR\fR
.br
\fB\-\-function=\fR\fB\fIfunction\-name(argtype [, \&.\&.\&.])\fR\fR
.RS 4
Restore the named function only\&. Be careful to spell the function name and arguments exactly as they appear in the dump file\*(Aqs table of contents\&. Multiple functions may be specified with multiple
\fB\-P\fR
switches\&.
.RE
.PP
\fB\-R\fR
.br
\fB\-\-no\-reconnect\fR
.RS 4
This option is obsolete but still accepted for backwards compatibility\&.
.RE
.PP
\fB\-s\fR
.br
\fB\-\-schema\-only\fR
.RS 4
Restore only the schema (data definitions), not data, to the extent that schema entries are present in the archive\&.
.sp
This option is the inverse of
\fB\-\-data\-only\fR\&. It is similar to, but for historical reasons not identical to, specifying
\fB\-\-section=pre\-data \-\-section=post\-data\fR\&.
.sp
(Do not confuse this with the
\fB\-\-schema\fR
option, which uses the word
\(lqschema\(rq
in a different meaning\&.)
.RE
.PP
\fB\-S \fR\fB\fIusername\fR\fR
.br
\fB\-\-superuser=\fR\fB\fIusername\fR\fR
.RS 4
Specify the superuser user name to use when disabling triggers\&. This is relevant only if
\fB\-\-disable\-triggers\fR
is used\&.
.RE
.PP
\fB\-t \fR\fB\fItable\fR\fR
.br
\fB\-\-table=\fR\fB\fItable\fR\fR
.RS 4
Restore definition and/or data of only the named table\&. For this purpose,
\(lqtable\(rq
includes views, materialized views, sequences, and foreign tables\&. Multiple tables can be selected by writing multiple
\fB\-t\fR
switches\&. This option can be combined with the
\fB\-n\fR
option to specify table(s) in a particular schema\&.
.if n \{\
.sp
.\}
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBNote\fR
.ps -1
.br
When
\fB\-t\fR
is specified,
pg_restore
makes no attempt to restore any other database objects that the selected table(s) might depend upon\&. Therefore, there is no guarantee that a specific\-table restore into a clean database will succeed\&.
.sp .5v
.RE
.if n \{\
.sp
.\}
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBNote\fR
.ps -1
.br
This flag does not behave identically to the
\fB\-t\fR
flag of
pg_dump\&. There is not currently any provision for wild\-card matching in
pg_restore, nor can you include a schema name within its
\fB\-t\fR\&.
.sp .5v
.RE
.if n \{\
.sp
.\}
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBNote\fR
.ps -1
.br
In versions prior to
PostgreSQL
9\&.6, this flag matched only tables, not any other type of relation\&.
.sp .5v
.RE
.RE
.PP
\fB\-T \fR\fB\fItrigger\fR\fR
.br
\fB\-\-trigger=\fR\fB\fItrigger\fR\fR
.RS 4
Restore named trigger only\&. Multiple triggers may be specified with multiple
\fB\-T\fR
switches\&.
.RE
.PP
\fB\-v\fR
.br
\fB\-\-verbose\fR
.RS 4
Specifies verbose mode\&.
.RE
.PP
\fB\-V\fR
.br
\fB\-\-version\fR
.RS 4
Print the
pg_restore
version and exit\&.
.RE
.PP
\fB\-x\fR
.br
\fB\-\-no\-privileges\fR
.br
\fB\-\-no\-acl\fR
.RS 4
Prevent restoration of access privileges (grant/revoke commands)\&.
.RE
.PP
\fB\-1\fR
.br
\fB\-\-single\-transaction\fR
.RS 4
Execute the restore as a single transaction (that is, wrap the emitted commands in
\fBBEGIN\fR/\fBCOMMIT\fR)\&. This ensures that either all the commands complete successfully, or no changes are applied\&. This option implies
\fB\-\-exit\-on\-error\fR\&.
.RE
.PP
\fB\-\-disable\-triggers\fR
.RS 4
This option is relevant only when performing a data\-only restore\&. It instructs
pg_restore
to execute commands to temporarily disable triggers on the target tables while the data is reloaded\&. Use this if you have referential integrity checks or other triggers on the tables that you do not want to invoke during data reload\&.
.sp
Presently, the commands emitted for
\fB\-\-disable\-triggers\fR
must be done as superuser\&. So you should also specify a superuser name with
\fB\-S\fR
or, preferably, run
pg_restore
as a
PostgreSQL
superuser\&.
.RE
.PP
\fB\-\-enable\-row\-security\fR
.RS 4
This option is relevant only when restoring the contents of a table which has row security\&. By default,
pg_restore
will set
row_security
to off, to ensure that all data is restored in to the table\&. If the user does not have sufficient privileges to bypass row security, then an error is thrown\&. This parameter instructs
pg_restore
to set
row_security
to on instead, allowing the user to attempt to restore the contents of the table with row security enabled\&. This might still fail if the user does not have the right to insert the rows from the dump into the table\&.
.sp
Note that this option currently also requires the dump be in
\fBINSERT\fR
format, as
\fBCOPY FROM\fR
does not support row security\&.
.RE
.PP
\fB\-\-if\-exists\fR
.RS 4
Use conditional commands (i\&.e\&., add an
IF EXISTS
clause) when cleaning database objects\&. This option is not valid unless
\fB\-\-clean\fR
is also specified\&.
.RE
.PP
\fB\-\-no\-data\-for\-failed\-tables\fR
.RS 4
By default, table data is restored even if the creation command for the table failed (e\&.g\&., because it already exists)\&. With this option, data for such a table is skipped\&. This behavior is useful if the target database already contains the desired table contents\&. For example, auxiliary tables for
PostgreSQL
extensions such as
PostGIS
might already be loaded in the target database; specifying this option prevents duplicate or obsolete data from being loaded into them\&.
.sp
This option is effective only when restoring directly into a database, not when producing SQL script output\&.
.RE
.PP
\fB\-\-no\-security\-labels\fR
.RS 4
Do not output commands to restore security labels, even if the archive contains them\&.
.RE
.PP
\fB\-\-no\-tablespaces\fR
.RS 4
Do not output commands to select tablespaces\&. With this option, all objects will be created in whichever tablespace is the default during restore\&.
.RE
.PP
\fB\-\-section=\fR\fB\fIsectionname\fR\fR
.RS 4
Only restore the named section\&. The section name can be
\fBpre\-data\fR,
\fBdata\fR, or
\fBpost\-data\fR\&. This option can be specified more than once to select multiple sections\&. The default is to restore all sections\&.
.sp
The data section contains actual table data as well as large\-object definitions\&. Post\-data items consist of definitions of indexes, triggers, rules and constraints other than validated check constraints\&. Pre\-data items consist of all other data definition items\&.
.RE
.PP
\fB\-\-strict\-names\fR
.RS 4
Require that each schema (\fB\-n\fR/\fB\-\-schema\fR) and table (\fB\-t\fR/\fB\-\-table\fR) qualifier match at least one schema/table in the backup file\&.
.RE
.PP
\fB\-\-use\-set\-session\-authorization\fR
.RS 4
Output SQL\-standard
\fBSET SESSION AUTHORIZATION\fR
commands instead of
\fBALTER OWNER\fR
commands to determine object ownership\&. This makes the dump more standards\-compatible, but depending on the history of the objects in the dump, might not restore properly\&.
.RE
.PP
\fB\-?\fR
.br
\fB\-\-help\fR
.RS 4
Show help about
pg_restore
command line arguments, and exit\&.
.RE
.PP
pg_restore
also accepts the following command line arguments for connection parameters:
.PP
\fB\-h \fR\fB\fIhost\fR\fR
.br
\fB\-\-host=\fR\fB\fIhost\fR\fR
.RS 4
Specifies the host name of the machine on which the server is running\&. If the value begins with a slash, it is used as the directory for the Unix domain socket\&. The default is taken from the
\fBPGHOST\fR
environment variable, if set, else a Unix domain socket connection is attempted\&.
.RE
.PP
\fB\-p \fR\fB\fIport\fR\fR
.br
\fB\-\-port=\fR\fB\fIport\fR\fR
.RS 4
Specifies the TCP port or local Unix domain socket file extension on which the server is listening for connections\&. Defaults to the
\fBPGPORT\fR
environment variable, if set, or a compiled\-in default\&.
.RE
.PP
\fB\-U \fR\fB\fIusername\fR\fR
.br
\fB\-\-username=\fR\fB\fIusername\fR\fR
.RS 4
User name to connect as\&.
.RE
.PP
\fB\-w\fR
.br
\fB\-\-no\-password\fR
.RS 4
Never issue a password prompt\&. If the server requires password authentication and a password is not available by other means such as a
\&.pgpass
file, the connection attempt will fail\&. This option can be useful in batch jobs and scripts where no user is present to enter a password\&.
.RE
.PP
\fB\-W\fR
.br
\fB\-\-password\fR
.RS 4
Force
pg_restore
to prompt for a password before connecting to a database\&.
.sp
This option is never essential, since
pg_restore
will automatically prompt for a password if the server demands password authentication\&. However,
pg_restore
will waste a connection attempt finding out that the server wants a password\&. In some cases it is worth typing
\fB\-W\fR
to avoid the extra connection attempt\&.
.RE
.PP
\fB\-\-role=\fR\fB\fIrolename\fR\fR
.RS 4
Specifies a role name to be used to perform the restore\&. This option causes
pg_restore
to issue a
\fBSET ROLE\fR
\fIrolename\fR
command after connecting to the database\&. It is useful when the authenticated user (specified by
\fB\-U\fR) lacks privileges needed by
pg_restore, but can switch to a role with the required rights\&. Some installations have a policy against logging in directly as a superuser, and use of this option allows restores to be performed without violating the policy\&.
.RE
.SH "ENVIRONMENT"
.PP
\fBPGHOST\fR
.br
\fBPGOPTIONS\fR
.br
\fBPGPORT\fR
.br
\fBPGUSER\fR
.RS 4
Default connection parameters
.RE
.PP
This utility, like most other
PostgreSQL
utilities, also uses the environment variables supported by
libpq
(see
Section 32.14, \(lqEnvironment Variables\(rq, in the documentation)\&. However, it does not read
\fBPGDATABASE\fR
when a database name is not supplied\&.
.SH "DIAGNOSTICS"
.PP
When a direct database connection is specified using the
\fB\-d\fR
option,
pg_restore
internally executes
SQL
statements\&. If you have problems running
pg_restore, make sure you are able to select information from the database using, for example,
\fBpsql\fR(1)\&. Also, any default connection settings and environment variables used by the
libpq
front\-end library will apply\&.
.SH "NOTES"
.PP
If your installation has any local additions to the
template1
database, be careful to load the output of
pg_restore
into a truly empty database; otherwise you are likely to get errors due to duplicate definitions of the added objects\&. To make an empty database without any local additions, copy from
template0
not
template1, for example:
.sp
.if n \{\
.RS 4
.\}
.nf
CREATE DATABASE foo WITH TEMPLATE template0;
.fi
.if n \{\
.RE
.\}
.PP
The limitations of
pg_restore
are detailed below\&.
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
When restoring data to a pre\-existing table and the option
\fB\-\-disable\-triggers\fR
is used,
pg_restore
emits commands to disable triggers on user tables before inserting the data, then emits commands to re\-enable them after the data has been inserted\&. If the restore is stopped in the middle, the system catalogs might be left in the wrong state\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
pg_restore
cannot restore large objects selectively; for instance, only those for a specific table\&. If an archive contains large objects, then all large objects will be restored, or none of them if they are excluded via
\fB\-L\fR,
\fB\-t\fR, or other options\&.
.RE
.PP
See also the
\fBpg_dump\fR(1)
documentation for details on limitations of
pg_dump\&.
.PP
Once restored, it is wise to run
\fBANALYZE\fR
on each restored table so the optimizer has useful statistics; see
Section 24.1.3, \(lqUpdating Planner Statistics\(rq, in the documentation
and
Section 24.1.6, \(lqThe Autovacuum Daemon\(rq, in the documentation
for more information\&.
.SH "EXAMPLES"
.PP
Assume we have dumped a database called
mydb
into a custom\-format dump file:
.sp
.if n \{\
.RS 4
.\}
.nf
$ \fBpg_dump \-Fc mydb > db\&.dump\fR
.fi
.if n \{\
.RE
.\}
.PP
To drop the database and recreate it from the dump:
.sp
.if n \{\
.RS 4
.\}
.nf
$ \fBdropdb mydb\fR
$ \fBpg_restore \-C \-d postgres db\&.dump\fR
.fi
.if n \{\
.RE
.\}
.sp
The database named in the
\fB\-d\fR
switch can be any database existing in the cluster;
pg_restore
only uses it to issue the
\fBCREATE DATABASE\fR
command for
mydb\&. With
\fB\-C\fR, data is always restored into the database name that appears in the dump file\&.
.PP
To reload the dump into a new database called
newdb:
.sp
.if n \{\
.RS 4
.\}
.nf
$ \fBcreatedb \-T template0 newdb\fR
$ \fBpg_restore \-d newdb db\&.dump\fR
.fi
.if n \{\
.RE
.\}
.sp
Notice we don\*(Aqt use
\fB\-C\fR, and instead connect directly to the database to be restored into\&. Also note that we clone the new database from
template0
not
template1, to ensure it is initially empty\&.
.PP
To reorder database items, it is first necessary to dump the table of contents of the archive:
.sp
.if n \{\
.RS 4
.\}
.nf
$ \fBpg_restore \-l db\&.dump > db\&.list\fR
.fi
.if n \{\
.RE
.\}
.sp
The listing file consists of a header and one line for each item, e\&.g\&.:
.sp
.if n \{\
.RS 4
.\}
.nf
;
; Archive created at Mon Sep 14 13:55:39 2009
; dbname: DBDEMOS
; TOC Entries: 81
; Compression: 9
; Dump Version: 1\&.10\-0
; Format: CUSTOM
; Integer: 4 bytes
; Offset: 8 bytes
; Dumped from database version: 8\&.3\&.5
; Dumped by pg_dump version: 8\&.3\&.8
;
;
; Selected TOC Entries:
;
3; 2615 2200 SCHEMA \- public pasha
1861; 0 0 COMMENT \- SCHEMA public pasha
1862; 0 0 ACL \- public pasha
317; 1247 17715 TYPE public composite pasha
319; 1247 25899 DOMAIN public domain0 pasha
.fi
.if n \{\
.RE
.\}
.sp
Semicolons start a comment, and the numbers at the start of lines refer to the internal archive ID assigned to each item\&.
.PP
Lines in the file can be commented out, deleted, and reordered\&. For example:
.sp
.if n \{\
.RS 4
.\}
.nf
10; 145433 TABLE map_resolutions postgres
;2; 145344 TABLE species postgres
;4; 145359 TABLE nt_header postgres
6; 145402 TABLE species_records postgres
;8; 145416 TABLE ss_old postgres
.fi
.if n \{\
.RE
.\}
.sp
could be used as input to
pg_restore
and would only restore items 10 and 6, in that order:
.sp
.if n \{\
.RS 4
.\}
.nf
$ \fBpg_restore \-L db\&.list db\&.dump\fR
.fi
.if n \{\
.RE
.\}
.SH "SEE ALSO"
\fBpg_dump\fR(1), \fBpg_dumpall\fR(1), \fBpsql\fR(1)
man/man1/createuser.1 0000644 00000022665 14751153421 0010415 0 ustar 00 '\" t
.\" Title: createuser
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "CREATEUSER" "1" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
createuser \- define a new PostgreSQL user account
.SH "SYNOPSIS"
.HP \w'\fBcreateuser\fR\ 'u
\fBcreateuser\fR [\fIconnection\-option\fR...] [\fIoption\fR...] [\fIusername\fR]
.SH "DESCRIPTION"
.PP
createuser
creates a new
PostgreSQL
user (or more precisely, a role)\&. Only superusers and users with
CREATEROLE
privilege can create new users, so
createuser
must be invoked by someone who can connect as a superuser or a user with
CREATEROLE
privilege\&.
.PP
If you wish to create a new superuser, you must connect as a superuser, not merely with
CREATEROLE
privilege\&. Being a superuser implies the ability to bypass all access permission checks within the database, so superuser access should not be granted lightly\&.
.PP
createuser
is a wrapper around the
SQL
command
CREATE ROLE (\fBCREATE_ROLE\fR(7))\&. There is no effective difference between creating users via this utility and via other methods for accessing the server\&.
.SH "OPTIONS"
.PP
createuser
accepts the following command\-line arguments:
.PP
\fIusername\fR
.RS 4
Specifies the name of the
PostgreSQL
user to be created\&. This name must be different from all existing roles in this
PostgreSQL
installation\&.
.RE
.PP
\fB\-c \fR\fB\fInumber\fR\fR
.br
\fB\-\-connection\-limit=\fR\fB\fInumber\fR\fR
.RS 4
Set a maximum number of connections for the new user\&. The default is to set no limit\&.
.RE
.PP
\fB\-d\fR
.br
\fB\-\-createdb\fR
.RS 4
The new user will be allowed to create databases\&.
.RE
.PP
\fB\-D\fR
.br
\fB\-\-no\-createdb\fR
.RS 4
The new user will not be allowed to create databases\&. This is the default\&.
.RE
.PP
\fB\-e\fR
.br
\fB\-\-echo\fR
.RS 4
Echo the commands that
createuser
generates and sends to the server\&.
.RE
.PP
\fB\-E\fR
.br
\fB\-\-encrypted\fR
.RS 4
Encrypts the user\*(Aqs password stored in the database\&. If not specified, the default password behavior is used\&.
.RE
.PP
\fB\-g \fR\fB\fIrole\fR\fR
.br
\fB\-\-role=\fR\fB\fIrole\fR\fR
.RS 4
Indicates role to which this role will be added immediately as a new member\&. Multiple roles to which this role will be added as a member can be specified by writing multiple
\fB\-g\fR
switches\&.
.RE
.PP
\fB\-i\fR
.br
\fB\-\-inherit\fR
.RS 4
The new role will automatically inherit privileges of roles it is a member of\&. This is the default\&.
.RE
.PP
\fB\-I\fR
.br
\fB\-\-no\-inherit\fR
.RS 4
The new role will not automatically inherit privileges of roles it is a member of\&.
.RE
.PP
\fB\-\-interactive\fR
.RS 4
Prompt for the user name if none is specified on the command line, and also prompt for whichever of the options
\fB\-d\fR/\fB\-D\fR,
\fB\-r\fR/\fB\-R\fR,
\fB\-s\fR/\fB\-S\fR
is not specified on the command line\&. (This was the default behavior up to PostgreSQL 9\&.1\&.)
.RE
.PP
\fB\-l\fR
.br
\fB\-\-login\fR
.RS 4
The new user will be allowed to log in (that is, the user name can be used as the initial session user identifier)\&. This is the default\&.
.RE
.PP
\fB\-L\fR
.br
\fB\-\-no\-login\fR
.RS 4
The new user will not be allowed to log in\&. (A role without login privilege is still useful as a means of managing database permissions\&.)
.RE
.PP
\fB\-N\fR
.br
\fB\-\-unencrypted\fR
.RS 4
Does not encrypt the user\*(Aqs password stored in the database\&. If not specified, the default password behavior is used\&.
.RE
.PP
\fB\-P\fR
.br
\fB\-\-pwprompt\fR
.RS 4
If given,
createuser
will issue a prompt for the password of the new user\&. This is not necessary if you do not plan on using password authentication\&.
.RE
.PP
\fB\-r\fR
.br
\fB\-\-createrole\fR
.RS 4
The new user will be allowed to create new roles (that is, this user will have
CREATEROLE
privilege)\&.
.RE
.PP
\fB\-R\fR
.br
\fB\-\-no\-createrole\fR
.RS 4
The new user will not be allowed to create new roles\&. This is the default\&.
.RE
.PP
\fB\-s\fR
.br
\fB\-\-superuser\fR
.RS 4
The new user will be a superuser\&.
.RE
.PP
\fB\-S\fR
.br
\fB\-\-no\-superuser\fR
.RS 4
The new user will not be a superuser\&. This is the default\&.
.RE
.PP
\fB\-V\fR
.br
\fB\-\-version\fR
.RS 4
Print the
createuser
version and exit\&.
.RE
.PP
\fB\-\-replication\fR
.RS 4
The new user will have the
REPLICATION
privilege, which is described more fully in the documentation for
CREATE ROLE (\fBCREATE_ROLE\fR(7))\&.
.RE
.PP
\fB\-\-no\-replication\fR
.RS 4
The new user will not have the
REPLICATION
privilege, which is described more fully in the documentation for
CREATE ROLE (\fBCREATE_ROLE\fR(7))\&.
.RE
.PP
\fB\-?\fR
.br
\fB\-\-help\fR
.RS 4
Show help about
createuser
command line arguments, and exit\&.
.RE
.PP
createuser
also accepts the following command\-line arguments for connection parameters:
.PP
\fB\-h \fR\fB\fIhost\fR\fR
.br
\fB\-\-host=\fR\fB\fIhost\fR\fR
.RS 4
Specifies the host name of the machine on which the server is running\&. If the value begins with a slash, it is used as the directory for the Unix domain socket\&.
.RE
.PP
\fB\-p \fR\fB\fIport\fR\fR
.br
\fB\-\-port=\fR\fB\fIport\fR\fR
.RS 4
Specifies the TCP port or local Unix domain socket file extension on which the server is listening for connections\&.
.RE
.PP
\fB\-U \fR\fB\fIusername\fR\fR
.br
\fB\-\-username=\fR\fB\fIusername\fR\fR
.RS 4
User name to connect as (not the user name to create)\&.
.RE
.PP
\fB\-w\fR
.br
\fB\-\-no\-password\fR
.RS 4
Never issue a password prompt\&. If the server requires password authentication and a password is not available by other means such as a
\&.pgpass
file, the connection attempt will fail\&. This option can be useful in batch jobs and scripts where no user is present to enter a password\&.
.RE
.PP
\fB\-W\fR
.br
\fB\-\-password\fR
.RS 4
Force
createuser
to prompt for a password (for connecting to the server, not for the password of the new user)\&.
.sp
This option is never essential, since
createuser
will automatically prompt for a password if the server demands password authentication\&. However,
createuser
will waste a connection attempt finding out that the server wants a password\&. In some cases it is worth typing
\fB\-W\fR
to avoid the extra connection attempt\&.
.RE
.SH "ENVIRONMENT"
.PP
\fBPGHOST\fR
.br
\fBPGPORT\fR
.br
\fBPGUSER\fR
.RS 4
Default connection parameters
.RE
.PP
This utility, like most other
PostgreSQL
utilities, also uses the environment variables supported by
libpq
(see
Section 32.14, \(lqEnvironment Variables\(rq, in the documentation)\&.
.SH "DIAGNOSTICS"
.PP
In case of difficulty, see
CREATE ROLE (\fBCREATE_ROLE\fR(7))
and
\fBpsql\fR(1)
for discussions of potential problems and error messages\&. The database server must be running at the targeted host\&. Also, any default connection settings and environment variables used by the
libpq
front\-end library will apply\&.
.SH "EXAMPLES"
.PP
To create a user
joe
on the default database server:
.sp
.if n \{\
.RS 4
.\}
.nf
$ \fBcreateuser joe\fR
.fi
.if n \{\
.RE
.\}
.PP
To create a user
joe
on the default database server with prompting for some additional attributes:
.sp
.if n \{\
.RS 4
.\}
.nf
$ \fBcreateuser \-\-interactive joe\fR
Shall the new role be a superuser? (y/n) \fBn\fR
Shall the new role be allowed to create databases? (y/n) \fBn\fR
Shall the new role be allowed to create more new roles? (y/n) \fBn\fR
.fi
.if n \{\
.RE
.\}
.PP
To create the same user
joe
using the server on host
eden, port 5000, with attributes explicitly specified, taking a look at the underlying command:
.sp
.if n \{\
.RS 4
.\}
.nf
$ \fBcreateuser \-h eden \-p 5000 \-S \-D \-R \-e joe\fR
CREATE ROLE joe NOSUPERUSER NOCREATEDB NOCREATEROLE INHERIT LOGIN;
.fi
.if n \{\
.RE
.\}
.PP
To create the user
joe
as a superuser, and assign a password immediately:
.sp
.if n \{\
.RS 4
.\}
.nf
$ \fBcreateuser \-P \-s \-e joe\fR
Enter password for new role: \fBxyzzy\fR
Enter it again: \fBxyzzy\fR
CREATE ROLE joe PASSWORD \*(Aqmd5b5f5ba1a423792b526f799ae4eb3d59e\*(Aq SUPERUSER CREATEDB CREATEROLE INHERIT LOGIN;
.fi
.if n \{\
.RE
.\}
.sp
In the above example, the new password isn\*(Aqt actually echoed when typed, but we show what was typed for clarity\&. As you see, the password is encrypted before it is sent to the client\&. If the option
\fB\-\-unencrypted\fR
is used, the password
\fIwill\fR
appear in the echoed command (and possibly also in the server log and elsewhere), so you don\*(Aqt want to use
\fB\-e\fR
in that case, if anyone else can see your screen\&.
.SH "SEE ALSO"
\fBdropuser\fR(1), CREATE ROLE (\fBCREATE_ROLE\fR(7))
man/man1/pg_dump.1 0000644 00000105737 14751153421 0007710 0 ustar 00 '\" t
.\" Title: pg_dump
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "PG_DUMP" "1" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
pg_dump \- extract a PostgreSQL database into a script file or other archive file
.SH "SYNOPSIS"
.HP \w'\fBpg_dump\fR\ 'u
\fBpg_dump\fR [\fIconnection\-option\fR...] [\fIoption\fR...] [\fIdbname\fR]
.SH "DESCRIPTION"
.PP
pg_dump
is a utility for backing up a
PostgreSQL
database\&. It makes consistent backups even if the database is being used concurrently\&.
pg_dump
does not block other users accessing the database (readers or writers)\&.
.PP
pg_dump
only dumps a single database\&. To backup global objects that are common to all databases in a cluster, such as roles and tablespaces, use
\fBpg_dumpall\fR(1)\&.
.PP
Dumps can be output in script or archive file formats\&. Script dumps are plain\-text files containing the SQL commands required to reconstruct the database to the state it was in at the time it was saved\&. To restore from such a script, feed it to
\fBpsql\fR(1)\&. Script files can be used to reconstruct the database even on other machines and other architectures; with some modifications, even on other SQL database products\&.
.PP
The alternative archive file formats must be used with
\fBpg_restore\fR(1)
to rebuild the database\&. They allow
pg_restore
to be selective about what is restored, or even to reorder the items prior to being restored\&. The archive file formats are designed to be portable across architectures\&.
.PP
When used with one of the archive file formats and combined with
pg_restore,
pg_dump
provides a flexible archival and transfer mechanism\&.
pg_dump
can be used to backup an entire database, then
pg_restore
can be used to examine the archive and/or select which parts of the database are to be restored\&. The most flexible output file formats are the
\(lqcustom\(rq
format (\fB\-Fc\fR) and the
\(lqdirectory\(rq
format (\fB\-Fd\fR)\&. They allow for selection and reordering of all archived items, support parallel restoration, and are compressed by default\&. The
\(lqdirectory\(rq
format is the only format that supports parallel dumps\&.
.PP
While running
pg_dump, one should examine the output for any warnings (printed on standard error), especially in light of the limitations listed below\&.
.SH "OPTIONS"
.PP
The following command\-line options control the content and format of the output\&.
.PP
\fIdbname\fR
.RS 4
Specifies the name of the database to be dumped\&. If this is not specified, the environment variable
\fBPGDATABASE\fR
is used\&. If that is not set, the user name specified for the connection is used\&.
.RE
.PP
\fB\-a\fR
.br
\fB\-\-data\-only\fR
.RS 4
Dump only the data, not the schema (data definitions)\&. Table data, large objects, and sequence values are dumped\&.
.sp
This option is similar to, but for historical reasons not identical to, specifying
\fB\-\-section=data\fR\&.
.RE
.PP
\fB\-b\fR
.br
\fB\-\-blobs\fR
.RS 4
Include large objects in the dump\&. This is the default behavior except when
\fB\-\-schema\fR,
\fB\-\-table\fR, or
\fB\-\-schema\-only\fR
is specified\&. The
\fB\-b\fR
switch is therefore only useful to add large objects to dumps where a specific schema or table has been requested\&. Note that blobs are considered data and therefore will be included when \-\-data\-only is used, but not when \-\-schema\-only is\&.
.RE
.PP
\fB\-c\fR
.br
\fB\-\-clean\fR
.RS 4
Output commands to clean (drop) database objects prior to outputting the commands for creating them\&. (Unless
\fB\-\-if\-exists\fR
is also specified, restore might generate some harmless error messages, if any objects were not present in the destination database\&.)
.sp
This option is ignored when emitting an archive (non\-text) output file\&. For the archive formats, you can specify the option when you call
\fBpg_restore\fR\&.
.RE
.PP
\fB\-C\fR
.br
\fB\-\-create\fR
.RS 4
Begin the output with a command to create the database itself and reconnect to the created database\&. (With a script of this form, it doesn\*(Aqt matter which database in the destination installation you connect to before running the script\&.) If
\fB\-\-clean\fR
is also specified, the script drops and recreates the target database before reconnecting to it\&.
.sp
This option is ignored when emitting an archive (non\-text) output file\&. For the archive formats, you can specify the option when you call
\fBpg_restore\fR\&.
.RE
.PP
\fB\-E \fR\fB\fIencoding\fR\fR
.br
\fB\-\-encoding=\fR\fB\fIencoding\fR\fR
.RS 4
Create the dump in the specified character set encoding\&. By default, the dump is created in the database encoding\&. (Another way to get the same result is to set the
\fBPGCLIENTENCODING\fR
environment variable to the desired dump encoding\&.)
.RE
.PP
\fB\-f \fR\fB\fIfile\fR\fR
.br
\fB\-\-file=\fR\fB\fIfile\fR\fR
.RS 4
Send output to the specified file\&. This parameter can be omitted for file based output formats, in which case the standard output is used\&. It must be given for the directory output format however, where it specifies the target directory instead of a file\&. In this case the directory is created by
\fBpg_dump\fR
and must not exist before\&.
.RE
.PP
\fB\-F \fR\fB\fIformat\fR\fR
.br
\fB\-\-format=\fR\fB\fIformat\fR\fR
.RS 4
Selects the format of the output\&.
\fIformat\fR
can be one of the following:
.PP
p
.br
plain
.RS 4
Output a plain\-text
SQL
script file (the default)\&.
.RE
.PP
c
.br
custom
.RS 4
Output a custom\-format archive suitable for input into
pg_restore\&. Together with the directory output format, this is the most flexible output format in that it allows manual selection and reordering of archived items during restore\&. This format is also compressed by default\&.
.RE
.PP
d
.br
directory
.RS 4
Output a directory\-format archive suitable for input into
pg_restore\&. This will create a directory with one file for each table and blob being dumped, plus a so\-called Table of Contents file describing the dumped objects in a machine\-readable format that
pg_restore
can read\&. A directory format archive can be manipulated with standard Unix tools; for example, files in an uncompressed archive can be compressed with the
gzip
tool\&. This format is compressed by default and also supports parallel dumps\&.
.RE
.PP
t
.br
tar
.RS 4
Output a
\fBtar\fR\-format archive suitable for input into
pg_restore\&. The tar format is compatible with the directory format: extracting a tar\-format archive produces a valid directory\-format archive\&. However, the tar format does not support compression\&. Also, when using tar format the relative order of table data items cannot be changed during restore\&.
.RE
.RE
.PP
\fB\-j \fR\fB\fInjobs\fR\fR
.br
\fB\-\-jobs=\fR\fB\fInjobs\fR\fR
.RS 4
Run the dump in parallel by dumping
\fInjobs\fR
tables simultaneously\&. This option reduces the time of the dump but it also increases the load on the database server\&. You can only use this option with the directory output format because this is the only output format where multiple processes can write their data at the same time\&.
.sp
pg_dump
will open
\fInjobs\fR
+ 1 connections to the database, so make sure your
max_connections
setting is high enough to accommodate all connections\&.
.sp
Requesting exclusive locks on database objects while running a parallel dump could cause the dump to fail\&. The reason is that the
pg_dump
master process requests shared locks on the objects that the worker processes are going to dump later in order to make sure that nobody deletes them and makes them go away while the dump is running\&. If another client then requests an exclusive lock on a table, that lock will not be granted but will be queued waiting for the shared lock of the master process to be released\&. Consequently any other access to the table will not be granted either and will queue after the exclusive lock request\&. This includes the worker process trying to dump the table\&. Without any precautions this would be a classic deadlock situation\&. To detect this conflict, the
pg_dump
worker process requests another shared lock using the
NOWAIT
option\&. If the worker process is not granted this shared lock, somebody else must have requested an exclusive lock in the meantime and there is no way to continue with the dump, so
pg_dump
has no choice but to abort the dump\&.
.sp
For a consistent backup, the database server needs to support synchronized snapshots, a feature that was introduced in
PostgreSQL
9\&.2\&. With this feature, database clients can ensure they see the same data set even though they use different connections\&.
\fBpg_dump \-j\fR
uses multiple database connections; it connects to the database once with the master process and once again for each worker job\&. Without the synchronized snapshot feature, the different worker jobs wouldn\*(Aqt be guaranteed to see the same data in each connection, which could lead to an inconsistent backup\&.
.sp
If you want to run a parallel dump of a pre\-9\&.2 server, you need to make sure that the database content doesn\*(Aqt change from between the time the master connects to the database until the last worker job has connected to the database\&. The easiest way to do this is to halt any data modifying processes (DDL and DML) accessing the database before starting the backup\&. You also need to specify the
\fB\-\-no\-synchronized\-snapshots\fR
parameter when running
\fBpg_dump \-j\fR
against a pre\-9\&.2
PostgreSQL
server\&.
.RE
.PP
\fB\-n \fR\fB\fIschema\fR\fR
.br
\fB\-\-schema=\fR\fB\fIschema\fR\fR
.RS 4
Dump only schemas matching
\fIschema\fR; this selects both the schema itself, and all its contained objects\&. When this option is not specified, all non\-system schemas in the target database will be dumped\&. Multiple schemas can be selected by writing multiple
\fB\-n\fR
switches\&. Also, the
\fIschema\fR
parameter is interpreted as a pattern according to the same rules used by
psql\*(Aqs
\ed
commands (see
Patterns), so multiple schemas can also be selected by writing wildcard characters in the pattern\&. When using wildcards, be careful to quote the pattern if needed to prevent the shell from expanding the wildcards; see
EXAMPLES\&.
.if n \{\
.sp
.\}
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBNote\fR
.ps -1
.br
When
\fB\-n\fR
is specified,
pg_dump
makes no attempt to dump any other database objects that the selected schema(s) might depend upon\&. Therefore, there is no guarantee that the results of a specific\-schema dump can be successfully restored by themselves into a clean database\&.
.sp .5v
.RE
.if n \{\
.sp
.\}
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBNote\fR
.ps -1
.br
Non\-schema objects such as blobs are not dumped when
\fB\-n\fR
is specified\&. You can add blobs back to the dump with the
\fB\-\-blobs\fR
switch\&.
.sp .5v
.RE
.RE
.PP
\fB\-N \fR\fB\fIschema\fR\fR
.br
\fB\-\-exclude\-schema=\fR\fB\fIschema\fR\fR
.RS 4
Do not dump any schemas matching the
\fIschema\fR
pattern\&. The pattern is interpreted according to the same rules as for
\fB\-n\fR\&.
\fB\-N\fR
can be given more than once to exclude schemas matching any of several patterns\&.
.sp
When both
\fB\-n\fR
and
\fB\-N\fR
are given, the behavior is to dump just the schemas that match at least one
\fB\-n\fR
switch but no
\fB\-N\fR
switches\&. If
\fB\-N\fR
appears without
\fB\-n\fR, then schemas matching
\fB\-N\fR
are excluded from what is otherwise a normal dump\&.
.RE
.PP
\fB\-o\fR
.br
\fB\-\-oids\fR
.RS 4
Dump object identifiers (OIDs) as part of the data for every table\&. Use this option if your application references the
OID
columns in some way (e\&.g\&., in a foreign key constraint)\&. Otherwise, this option should not be used\&.
.RE
.PP
\fB\-O\fR
.br
\fB\-\-no\-owner\fR
.RS 4
Do not output commands to set ownership of objects to match the original database\&. By default,
pg_dump
issues
\fBALTER OWNER\fR
or
\fBSET SESSION AUTHORIZATION\fR
statements to set ownership of created database objects\&. These statements will fail when the script is run unless it is started by a superuser (or the same user that owns all of the objects in the script)\&. To make a script that can be restored by any user, but will give that user ownership of all the objects, specify
\fB\-O\fR\&.
.sp
This option is ignored when emitting an archive (non\-text) output file\&. For the archive formats, you can specify the option when you call
\fBpg_restore\fR\&.
.RE
.PP
\fB\-R\fR
.br
\fB\-\-no\-reconnect\fR
.RS 4
This option is obsolete but still accepted for backwards compatibility\&.
.RE
.PP
\fB\-s\fR
.br
\fB\-\-schema\-only\fR
.RS 4
Dump only the object definitions (schema), not data\&.
.sp
This option is the inverse of
\fB\-\-data\-only\fR\&. It is similar to, but for historical reasons not identical to, specifying
\fB\-\-section=pre\-data \-\-section=post\-data\fR\&.
.sp
(Do not confuse this with the
\fB\-\-schema\fR
option, which uses the word
\(lqschema\(rq
in a different meaning\&.)
.sp
To exclude table data for only a subset of tables in the database, see
\fB\-\-exclude\-table\-data\fR\&.
.RE
.PP
\fB\-S \fR\fB\fIusername\fR\fR
.br
\fB\-\-superuser=\fR\fB\fIusername\fR\fR
.RS 4
Specify the superuser user name to use when disabling triggers\&. This is relevant only if
\fB\-\-disable\-triggers\fR
is used\&. (Usually, it\*(Aqs better to leave this out, and instead start the resulting script as superuser\&.)
.RE
.PP
\fB\-t \fR\fB\fItable\fR\fR
.br
\fB\-\-table=\fR\fB\fItable\fR\fR
.RS 4
Dump only tables with names matching
\fItable\fR\&. For this purpose,
\(lqtable\(rq
includes views, materialized views, sequences, and foreign tables\&. Multiple tables can be selected by writing multiple
\fB\-t\fR
switches\&. Also, the
\fItable\fR
parameter is interpreted as a pattern according to the same rules used by
psql\*(Aqs
\ed
commands (see
Patterns), so multiple tables can also be selected by writing wildcard characters in the pattern\&. When using wildcards, be careful to quote the pattern if needed to prevent the shell from expanding the wildcards; see
EXAMPLES\&.
.sp
The
\fB\-n\fR
and
\fB\-N\fR
switches have no effect when
\fB\-t\fR
is used, because tables selected by
\fB\-t\fR
will be dumped regardless of those switches, and non\-table objects will not be dumped\&.
.if n \{\
.sp
.\}
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBNote\fR
.ps -1
.br
When
\fB\-t\fR
is specified,
pg_dump
makes no attempt to dump any other database objects that the selected table(s) might depend upon\&. Therefore, there is no guarantee that the results of a specific\-table dump can be successfully restored by themselves into a clean database\&.
.sp .5v
.RE
.if n \{\
.sp
.\}
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBNote\fR
.ps -1
.br
The behavior of the
\fB\-t\fR
switch is not entirely upward compatible with pre\-8\&.2
PostgreSQL
versions\&. Formerly, writing
\-t tab
would dump all tables named
tab, but now it just dumps whichever one is visible in your default search path\&. To get the old behavior you can write
\-t \*(Aq*\&.tab\*(Aq\&. Also, you must write something like
\-t sch\&.tab
to select a table in a particular schema, rather than the old locution of
\-n sch \-t tab\&.
.sp .5v
.RE
.RE
.PP
\fB\-T \fR\fB\fItable\fR\fR
.br
\fB\-\-exclude\-table=\fR\fB\fItable\fR\fR
.RS 4
Do not dump any tables matching the
\fItable\fR
pattern\&. The pattern is interpreted according to the same rules as for
\fB\-t\fR\&.
\fB\-T\fR
can be given more than once to exclude tables matching any of several patterns\&.
.sp
When both
\fB\-t\fR
and
\fB\-T\fR
are given, the behavior is to dump just the tables that match at least one
\fB\-t\fR
switch but no
\fB\-T\fR
switches\&. If
\fB\-T\fR
appears without
\fB\-t\fR, then tables matching
\fB\-T\fR
are excluded from what is otherwise a normal dump\&.
.RE
.PP
\fB\-v\fR
.br
\fB\-\-verbose\fR
.RS 4
Specifies verbose mode\&. This will cause
pg_dump
to output detailed object comments and start/stop times to the dump file, and progress messages to standard error\&.
.RE
.PP
\fB\-V\fR
.br
\fB\-\-version\fR
.RS 4
Print the
pg_dump
version and exit\&.
.RE
.PP
\fB\-x\fR
.br
\fB\-\-no\-privileges\fR
.br
\fB\-\-no\-acl\fR
.RS 4
Prevent dumping of access privileges (grant/revoke commands)\&.
.RE
.PP
\fB\-Z \fR\fB\fI0\&.\&.9\fR\fR
.br
\fB\-\-compress=\fR\fB\fI0\&.\&.9\fR\fR
.RS 4
Specify the compression level to use\&. Zero means no compression\&. For the custom and directory archive formats, this specifies compression of individual table\-data segments, and the default is to compress at a moderate level\&. For plain text output, setting a nonzero compression level causes the entire output file to be compressed, as though it had been fed through
gzip; but the default is not to compress\&. The tar archive format currently does not support compression at all\&.
.RE
.PP
\fB\-\-binary\-upgrade\fR
.RS 4
This option is for use by in\-place upgrade utilities\&. Its use for other purposes is not recommended or supported\&. The behavior of the option may change in future releases without notice\&.
.RE
.PP
\fB\-\-column\-inserts\fR
.br
\fB\-\-attribute\-inserts\fR
.RS 4
Dump data as
\fBINSERT\fR
commands with explicit column names (INSERT INTO \fItable\fR (\fIcolumn\fR, \&.\&.\&.) VALUES \&.\&.\&.)\&. This will make restoration very slow; it is mainly useful for making dumps that can be loaded into non\-PostgreSQL
databases\&. However, since this option generates a separate command for each row, an error in reloading a row causes only that row to be lost rather than the entire table contents\&.
.RE
.PP
\fB\-\-disable\-dollar\-quoting\fR
.RS 4
This option disables the use of dollar quoting for function bodies, and forces them to be quoted using SQL standard string syntax\&.
.RE
.PP
\fB\-\-disable\-triggers\fR
.RS 4
This option is relevant only when creating a data\-only dump\&. It instructs
pg_dump
to include commands to temporarily disable triggers on the target tables while the data is reloaded\&. Use this if you have referential integrity checks or other triggers on the tables that you do not want to invoke during data reload\&.
.sp
Presently, the commands emitted for
\fB\-\-disable\-triggers\fR
must be done as superuser\&. So, you should also specify a superuser name with
\fB\-S\fR, or preferably be careful to start the resulting script as a superuser\&.
.sp
This option is ignored when emitting an archive (non\-text) output file\&. For the archive formats, you can specify the option when you call
\fBpg_restore\fR\&.
.RE
.PP
\fB\-\-enable\-row\-security\fR
.RS 4
This option is relevant only when dumping the contents of a table which has row security\&. By default,
pg_dump
will set
row_security
to off, to ensure that all data is dumped from the table\&. If the user does not have sufficient privileges to bypass row security, then an error is thrown\&. This parameter instructs
pg_dump
to set
row_security
to on instead, allowing the user to dump the parts of the contents of the table that they have access to\&.
.sp
Note that if you use this option currently, you probably also want the dump be in
\fBINSERT\fR
format, as the
\fBCOPY FROM\fR
during restore does not support row security\&.
.RE
.PP
\fB\-\-exclude\-table\-data=\fR\fB\fItable\fR\fR
.RS 4
Do not dump data for any tables matching the
\fItable\fR
pattern\&. The pattern is interpreted according to the same rules as for
\fB\-t\fR\&.
\fB\-\-exclude\-table\-data\fR
can be given more than once to exclude tables matching any of several patterns\&. This option is useful when you need the definition of a particular table even though you do not need the data in it\&.
.sp
To exclude data for all tables in the database, see
\fB\-\-schema\-only\fR\&.
.RE
.PP
\fB\-\-if\-exists\fR
.RS 4
Use conditional commands (i\&.e\&., add an
IF EXISTS
clause) when cleaning database objects\&. This option is not valid unless
\fB\-\-clean\fR
is also specified\&.
.RE
.PP
\fB\-\-inserts\fR
.RS 4
Dump data as
\fBINSERT\fR
commands (rather than
\fBCOPY\fR)\&. This will make restoration very slow; it is mainly useful for making dumps that can be loaded into non\-PostgreSQL
databases\&. However, since this option generates a separate command for each row, an error in reloading a row causes only that row to be lost rather than the entire table contents\&. Note that the restore might fail altogether if you have rearranged column order\&. The
\fB\-\-column\-inserts\fR
option is safe against column order changes, though even slower\&.
.RE
.PP
\fB\-\-lock\-wait\-timeout=\fR\fB\fItimeout\fR\fR
.RS 4
Do not wait forever to acquire shared table locks at the beginning of the dump\&. Instead fail if unable to lock a table within the specified
\fItimeout\fR\&. The timeout may be specified in any of the formats accepted by
\fBSET statement_timeout\fR\&. (Allowed values vary depending on the server version you are dumping from, but an integer number of milliseconds is accepted by all versions since 7\&.3\&. This option is ignored when dumping from a pre\-7\&.3 server\&.)
.RE
.PP
\fB\-\-no\-security\-labels\fR
.RS 4
Do not dump security labels\&.
.RE
.PP
\fB\-\-no\-synchronized\-snapshots\fR
.RS 4
This option allows running
\fBpg_dump \-j\fR
against a pre\-9\&.2 server, see the documentation of the
\fB\-j\fR
parameter for more details\&.
.RE
.PP
\fB\-\-no\-tablespaces\fR
.RS 4
Do not output commands to select tablespaces\&. With this option, all objects will be created in whichever tablespace is the default during restore\&.
.sp
This option is ignored when emitting an archive (non\-text) output file\&. For the archive formats, you can specify the option when you call
\fBpg_restore\fR\&.
.RE
.PP
\fB\-\-no\-unlogged\-table\-data\fR
.RS 4
Do not dump the contents of unlogged tables\&. This option has no effect on whether or not the table definitions (schema) are dumped; it only suppresses dumping the table data\&. Data in unlogged tables is always excluded when dumping from a standby server\&.
.RE
.PP
\fB\-\-quote\-all\-identifiers\fR
.RS 4
Force quoting of all identifiers\&. This option is recommended when dumping a database from a server whose
PostgreSQL
major version is different from
pg_dump\*(Aqs, or when the output is intended to be loaded into a server of a different major version\&. By default,
pg_dump
quotes only identifiers that are reserved words in its own major version\&. This sometimes results in compatibility issues when dealing with servers of other versions that may have slightly different sets of reserved words\&. Using
\fB\-\-quote\-all\-identifiers\fR
prevents such issues, at the price of a harder\-to\-read dump script\&.
.RE
.PP
\fB\-\-section=\fR\fB\fIsectionname\fR\fR
.RS 4
Only dump the named section\&. The section name can be
\fBpre\-data\fR,
\fBdata\fR, or
\fBpost\-data\fR\&. This option can be specified more than once to select multiple sections\&. The default is to dump all sections\&.
.sp
The data section contains actual table data, large\-object contents, and sequence values\&. Post\-data items include definitions of indexes, triggers, rules, and constraints other than validated check constraints\&. Pre\-data items include all other data definition items\&.
.RE
.PP
\fB\-\-serializable\-deferrable\fR
.RS 4
Use a
serializable
transaction for the dump, to ensure that the snapshot used is consistent with later database states; but do this by waiting for a point in the transaction stream at which no anomalies can be present, so that there isn\*(Aqt a risk of the dump failing or causing other transactions to roll back with a
serialization_failure\&. See
Chapter 13, Concurrency Control, in the documentation
for more information about transaction isolation and concurrency control\&.
.sp
This option is not beneficial for a dump which is intended only for disaster recovery\&. It could be useful for a dump used to load a copy of the database for reporting or other read\-only load sharing while the original database continues to be updated\&. Without it the dump may reflect a state which is not consistent with any serial execution of the transactions eventually committed\&. For example, if batch processing techniques are used, a batch may show as closed in the dump without all of the items which are in the batch appearing\&.
.sp
This option will make no difference if there are no read\-write transactions active when pg_dump is started\&. If read\-write transactions are active, the start of the dump may be delayed for an indeterminate length of time\&. Once running, performance with or without the switch is the same\&.
.RE
.PP
\fB\-\-snapshot=\fR\fB\fIsnapshotname\fR\fR
.RS 4
Use the specified synchronized snapshot when making a dump of the database (see
Table\ \&9.81, \(lqSnapshot Synchronization Functions\(rq
for more details)\&.
.sp
This option is useful when needing to synchronize the dump with a logical replication slot (see
Chapter 47, Logical Decoding, in the documentation) or with a concurrent session\&.
.sp
In the case of a parallel dump, the snapshot name defined by this option is used rather than taking a new snapshot\&.
.RE
.PP
\fB\-\-strict\-names\fR
.RS 4
Require that each schema (\fB\-n\fR/\fB\-\-schema\fR) and table (\fB\-t\fR/\fB\-\-table\fR) qualifier match at least one schema/table in the database to be dumped\&. Note that if none of the schema/table qualifiers find matches,
pg_dump
will generate an error even without
\fB\-\-strict\-names\fR\&.
.sp
This option has no effect on
\fB\-N\fR/\fB\-\-exclude\-schema\fR,
\fB\-T\fR/\fB\-\-exclude\-table\fR, or
\fB\-\-exclude\-table\-data\fR\&. An exclude pattern failing to match any objects is not considered an error\&.
.RE
.PP
\fB\-\-use\-set\-session\-authorization\fR
.RS 4
Output SQL\-standard
\fBSET SESSION AUTHORIZATION\fR
commands instead of
\fBALTER OWNER\fR
commands to determine object ownership\&. This makes the dump more standards\-compatible, but depending on the history of the objects in the dump, might not restore properly\&. Also, a dump using
\fBSET SESSION AUTHORIZATION\fR
will certainly require superuser privileges to restore correctly, whereas
\fBALTER OWNER\fR
requires lesser privileges\&.
.RE
.PP
\fB\-?\fR
.br
\fB\-\-help\fR
.RS 4
Show help about
pg_dump
command line arguments, and exit\&.
.RE
.PP
The following command\-line options control the database connection parameters\&.
.PP
\fB\-d \fR\fB\fIdbname\fR\fR
.br
\fB\-\-dbname=\fR\fB\fIdbname\fR\fR
.RS 4
Specifies the name of the database to connect to\&. This is equivalent to specifying
\fIdbname\fR
as the first non\-option argument on the command line\&. The
\fIdbname\fR
can be a
connection string\&. If so, connection string parameters will override any conflicting command line options\&.
.RE
.PP
\fB\-h \fR\fB\fIhost\fR\fR
.br
\fB\-\-host=\fR\fB\fIhost\fR\fR
.RS 4
Specifies the host name of the machine on which the server is running\&. If the value begins with a slash, it is used as the directory for the Unix domain socket\&. The default is taken from the
\fBPGHOST\fR
environment variable, if set, else a Unix domain socket connection is attempted\&.
.RE
.PP
\fB\-p \fR\fB\fIport\fR\fR
.br
\fB\-\-port=\fR\fB\fIport\fR\fR
.RS 4
Specifies the TCP port or local Unix domain socket file extension on which the server is listening for connections\&. Defaults to the
\fBPGPORT\fR
environment variable, if set, or a compiled\-in default\&.
.RE
.PP
\fB\-U \fR\fB\fIusername\fR\fR
.br
\fB\-\-username=\fR\fB\fIusername\fR\fR
.RS 4
User name to connect as\&.
.RE
.PP
\fB\-w\fR
.br
\fB\-\-no\-password\fR
.RS 4
Never issue a password prompt\&. If the server requires password authentication and a password is not available by other means such as a
\&.pgpass
file, the connection attempt will fail\&. This option can be useful in batch jobs and scripts where no user is present to enter a password\&.
.RE
.PP
\fB\-W\fR
.br
\fB\-\-password\fR
.RS 4
Force
pg_dump
to prompt for a password before connecting to a database\&.
.sp
This option is never essential, since
pg_dump
will automatically prompt for a password if the server demands password authentication\&. However,
pg_dump
will waste a connection attempt finding out that the server wants a password\&. In some cases it is worth typing
\fB\-W\fR
to avoid the extra connection attempt\&.
.RE
.PP
\fB\-\-role=\fR\fB\fIrolename\fR\fR
.RS 4
Specifies a role name to be used to create the dump\&. This option causes
pg_dump
to issue a
\fBSET ROLE\fR
\fIrolename\fR
command after connecting to the database\&. It is useful when the authenticated user (specified by
\fB\-U\fR) lacks privileges needed by
pg_dump, but can switch to a role with the required rights\&. Some installations have a policy against logging in directly as a superuser, and use of this option allows dumps to be made without violating the policy\&.
.RE
.SH "ENVIRONMENT"
.PP
\fBPGDATABASE\fR
.br
\fBPGHOST\fR
.br
\fBPGOPTIONS\fR
.br
\fBPGPORT\fR
.br
\fBPGUSER\fR
.RS 4
Default connection parameters\&.
.RE
.PP
This utility, like most other
PostgreSQL
utilities, also uses the environment variables supported by
libpq
(see
Section 32.14, \(lqEnvironment Variables\(rq, in the documentation)\&.
.SH "DIAGNOSTICS"
.PP
pg_dump
internally executes
\fBSELECT\fR
statements\&. If you have problems running
pg_dump, make sure you are able to select information from the database using, for example,
\fBpsql\fR(1)\&. Also, any default connection settings and environment variables used by the
libpq
front\-end library will apply\&.
.PP
The database activity of
pg_dump
is normally collected by the statistics collector\&. If this is undesirable, you can set parameter
\fItrack_counts\fR
to false via
\fBPGOPTIONS\fR
or the
ALTER USER
command\&.
.SH "NOTES"
.PP
If your database cluster has any local additions to the
template1
database, be careful to restore the output of
pg_dump
into a truly empty database; otherwise you are likely to get errors due to duplicate definitions of the added objects\&. To make an empty database without any local additions, copy from
template0
not
template1, for example:
.sp
.if n \{\
.RS 4
.\}
.nf
CREATE DATABASE foo WITH TEMPLATE template0;
.fi
.if n \{\
.RE
.\}
.PP
When a data\-only dump is chosen and the option
\fB\-\-disable\-triggers\fR
is used,
pg_dump
emits commands to disable triggers on user tables before inserting the data, and then commands to re\-enable them after the data has been inserted\&. If the restore is stopped in the middle, the system catalogs might be left in the wrong state\&.
.PP
The dump file produced by
pg_dump
does not contain the statistics used by the optimizer to make query planning decisions\&. Therefore, it is wise to run
\fBANALYZE\fR
after restoring from a dump file to ensure optimal performance; see
Section 24.1.3, \(lqUpdating Planner Statistics\(rq, in the documentation
and
Section 24.1.6, \(lqThe Autovacuum Daemon\(rq, in the documentation
for more information\&. The dump file also does not contain any
\fBALTER DATABASE \&.\&.\&. SET\fR
commands; these settings are dumped by
\fBpg_dumpall\fR(1), along with database users and other installation\-wide settings\&.
.PP
Because
pg_dump
is used to transfer data to newer versions of
PostgreSQL, the output of
pg_dump
can be expected to load into
PostgreSQL
server versions newer than
pg_dump\*(Aqs version\&.
pg_dump
can also dump from
PostgreSQL
servers older than its own version\&. (Currently, servers back to version 7\&.0 are supported\&.) However,
pg_dump
cannot dump from
PostgreSQL
servers newer than its own major version; it will refuse to even try, rather than risk making an invalid dump\&. Also, it is not guaranteed that
pg_dump\*(Aqs output can be loaded into a server of an older major version \(em not even if the dump was taken from a server of that version\&. Loading a dump file into an older server may require manual editing of the dump file to remove syntax not understood by the older server\&. Use of the
\fB\-\-quote\-all\-identifiers\fR
option is recommended in cross\-version cases, as it can prevent problems arising from varying reserved\-word lists in different
PostgreSQL
versions\&.
.SH "EXAMPLES"
.PP
To dump a database called
mydb
into a SQL\-script file:
.sp
.if n \{\
.RS 4
.\}
.nf
$ \fBpg_dump mydb > db\&.sql\fR
.fi
.if n \{\
.RE
.\}
.PP
To reload such a script into a (freshly created) database named
newdb:
.sp
.if n \{\
.RS 4
.\}
.nf
$ \fBpsql \-d newdb \-f db\&.sql\fR
.fi
.if n \{\
.RE
.\}
.PP
To dump a database into a custom\-format archive file:
.sp
.if n \{\
.RS 4
.\}
.nf
$ \fBpg_dump \-Fc mydb > db\&.dump\fR
.fi
.if n \{\
.RE
.\}
.PP
To dump a database into a directory\-format archive:
.sp
.if n \{\
.RS 4
.\}
.nf
$ \fBpg_dump \-Fd mydb \-f dumpdir\fR
.fi
.if n \{\
.RE
.\}
.PP
To dump a database into a directory\-format archive in parallel with 5 worker jobs:
.sp
.if n \{\
.RS 4
.\}
.nf
$ \fBpg_dump \-Fd mydb \-j 5 \-f dumpdir\fR
.fi
.if n \{\
.RE
.\}
.PP
To reload an archive file into a (freshly created) database named
newdb:
.sp
.if n \{\
.RS 4
.\}
.nf
$ \fBpg_restore \-d newdb db\&.dump\fR
.fi
.if n \{\
.RE
.\}
.PP
To dump a single table named
mytab:
.sp
.if n \{\
.RS 4
.\}
.nf
$ \fBpg_dump \-t mytab mydb > db\&.sql\fR
.fi
.if n \{\
.RE
.\}
.PP
To dump all tables whose names start with
emp
in the
detroit
schema, except for the table named
employee_log:
.sp
.if n \{\
.RS 4
.\}
.nf
$ \fBpg_dump \-t \*(Aqdetroit\&.emp*\*(Aq \-T detroit\&.employee_log mydb > db\&.sql\fR
.fi
.if n \{\
.RE
.\}
.PP
To dump all schemas whose names start with
east
or
west
and end in
gsm, excluding any schemas whose names contain the word
test:
.sp
.if n \{\
.RS 4
.\}
.nf
$ \fBpg_dump \-n \*(Aqeast*gsm\*(Aq \-n \*(Aqwest*gsm\*(Aq \-N \*(Aq*test*\*(Aq mydb > db\&.sql\fR
.fi
.if n \{\
.RE
.\}
.PP
The same, using regular expression notation to consolidate the switches:
.sp
.if n \{\
.RS 4
.\}
.nf
$ \fBpg_dump \-n \*(Aq(east|west)*gsm\*(Aq \-N \*(Aq*test*\*(Aq mydb > db\&.sql\fR
.fi
.if n \{\
.RE
.\}
.PP
To dump all database objects except for tables whose names begin with
ts_:
.sp
.if n \{\
.RS 4
.\}
.nf
$ \fBpg_dump \-T \*(Aqts_*\*(Aq mydb > db\&.sql\fR
.fi
.if n \{\
.RE
.\}
.PP
To specify an upper\-case or mixed\-case name in
\fB\-t\fR
and related switches, you need to double\-quote the name; else it will be folded to lower case (see
Patterns)\&. But double quotes are special to the shell, so in turn they must be quoted\&. Thus, to dump a single table with a mixed\-case name, you need something like
.sp
.if n \{\
.RS 4
.\}
.nf
$ \fBpg_dump \-t "\e"MixedCaseName\e"" mydb > mytab\&.sql\fR
.fi
.if n \{\
.RE
.\}
.SH "SEE ALSO"
\fBpg_dumpall\fR(1), \fBpg_restore\fR(1), \fBpsql\fR(1)
man/man1/pg_isready.1 0000644 00000010724 14751153421 0010372 0 ustar 00 '\" t
.\" Title: pg_isready
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "PG_ISREADY" "1" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
pg_isready \- check the connection status of a PostgreSQL server
.SH "SYNOPSIS"
.HP \w'\fBpg_isready\fR\ 'u
\fBpg_isready\fR [\fIconnection\-option\fR...] [\fIoption\fR...]
.SH "DESCRIPTION"
.PP
pg_isready
is a utility for checking the connection status of a
PostgreSQL
database server\&. The exit status specifies the result of the connection check\&.
.SH "OPTIONS"
.PP
\fB\-d \fR\fB\fIdbname\fR\fR
.br
\fB\-\-dbname=\fR\fB\fIdbname\fR\fR
.RS 4
Specifies the name of the database to connect to\&. The
\fIdbname\fR
can be a
connection string\&. If so, connection string parameters will override any conflicting command line options\&.
.RE
.PP
\fB\-h \fR\fB\fIhostname\fR\fR
.br
\fB\-\-host=\fR\fB\fIhostname\fR\fR
.RS 4
Specifies the host name of the machine on which the server is running\&. If the value begins with a slash, it is used as the directory for the Unix\-domain socket\&.
.RE
.PP
\fB\-p \fR\fB\fIport\fR\fR
.br
\fB\-\-port=\fR\fB\fIport\fR\fR
.RS 4
Specifies the TCP port or the local Unix\-domain socket file extension on which the server is listening for connections\&. Defaults to the value of the
\fBPGPORT\fR
environment variable or, if not set, to the port specified at compile time, usually 5432\&.
.RE
.PP
\fB\-q\fR
.br
\fB\-\-quiet\fR
.RS 4
Do not display status message\&. This is useful when scripting\&.
.RE
.PP
\fB\-t \fR\fB\fIseconds\fR\fR
.br
\fB\-\-timeout=\fR\fB\fIseconds\fR\fR
.RS 4
The maximum number of seconds to wait when attempting connection before returning that the server is not responding\&. Setting to 0 disables\&. The default is 3 seconds\&.
.RE
.PP
\fB\-U \fR\fB\fIusername\fR\fR
.br
\fB\-\-username=\fR\fB\fIusername\fR\fR
.RS 4
Connect to the database as the user
\fIusername\fR
instead of the default\&.
.RE
.PP
\fB\-V\fR
.br
\fB\-\-version\fR
.RS 4
Print the
pg_isready
version and exit\&.
.RE
.PP
\fB\-?\fR
.br
\fB\-\-help\fR
.RS 4
Show help about
pg_isready
command line arguments, and exit\&.
.RE
.SH "EXIT STATUS"
.PP
pg_isready
returns
0
to the shell if the server is accepting connections normally,
1
if the server is rejecting connections (for example during startup),
2
if there was no response to the connection attempt, and
3
if no attempt was made (for example due to invalid parameters)\&.
.SH "ENVIRONMENT"
.PP
\fBpg_isready\fR, like most other
PostgreSQL
utilities, also uses the environment variables supported by
libpq
(see
Section 32.14, \(lqEnvironment Variables\(rq, in the documentation)\&.
.SH "NOTES"
.PP
It is not necessary to supply correct user name, password, or database name values to obtain the server status; however, if incorrect values are provided, the server will log a failed connection attempt\&.
.SH "EXAMPLES"
.PP
Standard Usage:
.sp
.if n \{\
.RS 4
.\}
.nf
$ \fBpg_isready\fR
/tmp:5432 \- accepting connections
$ \fBecho $?\fR
0
.fi
.if n \{\
.RE
.\}
.PP
Running with connection parameters to a
PostgreSQL
cluster in startup:
.sp
.if n \{\
.RS 4
.\}
.nf
$ \fBpg_isready \-h localhost \-p 5433\fR
localhost:5433 \- rejecting connections
$ \fBecho $?\fR
1
.fi
.if n \{\
.RE
.\}
.PP
Running with connection parameters to a non\-responsive
PostgreSQL
cluster:
.sp
.if n \{\
.RS 4
.\}
.nf
$ \fBpg_isready \-h someremotehost\fR
someremotehost:5432 \- no response
$ \fBecho $?\fR
2
.fi
.if n \{\
.RE
.\}
.sp
man/man1/pg_basebackup.1 0000644 00000043502 14751153421 0011032 0 ustar 00 '\" t
.\" Title: pg_basebackup
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "PG_BASEBACKUP" "1" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
pg_basebackup \- take a base backup of a PostgreSQL cluster
.SH "SYNOPSIS"
.HP \w'\fBpg_basebackup\fR\ 'u
\fBpg_basebackup\fR [\fIoption\fR...]
.SH "DESCRIPTION"
.PP
pg_basebackup
is used to take base backups of a running
PostgreSQL
database cluster\&. These are taken without affecting other clients to the database, and can be used both for point\-in\-time recovery (see
Section 25.3, \(lqContinuous Archiving and Point-in-Time Recovery (PITR)\(rq, in the documentation) and as the starting point for a log shipping or streaming replication standby servers (see
Section 26.2, \(lqLog-Shipping Standby Servers\(rq, in the documentation)\&.
.PP
pg_basebackup
makes a binary copy of the database cluster files, while making sure the system is put in and out of backup mode automatically\&. Backups are always taken of the entire database cluster; it is not possible to back up individual databases or database objects\&. For individual database backups, a tool such as
\fBpg_dump\fR(1)
must be used\&.
.PP
The backup is made over a regular
PostgreSQL
connection, and uses the replication protocol\&. The connection must be made with a superuser or a user having
REPLICATION
permissions (see
Section 21.2, \(lqRole Attributes\(rq, in the documentation), and
pg_hba\&.conf
must explicitly permit the replication connection\&. The server must also be configured with
max_wal_senders
set high enough to leave at least one session available for the backup\&.
.PP
There can be multiple
\fBpg_basebackup\fRs running at the same time, but it is better from a performance point of view to take only one backup, and copy the result\&.
.PP
pg_basebackup
can make a base backup from not only the master but also the standby\&. To take a backup from the standby, set up the standby so that it can accept replication connections (that is, set
\fImax_wal_senders\fR
and
hot_standby, and configure
host\-based authentication)\&. You will also need to enable
full_page_writes
on the master\&.
.PP
Note that there are some limitations in an online backup from the standby:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
The backup history file is not created in the database cluster backed up\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
There is no guarantee that all WAL files required for the backup are archived at the end of backup\&. If you are planning to use the backup for an archive recovery and want to ensure that all required files are available at that moment, you need to include them into the backup by using the
\-x
option\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
If the standby is promoted to the master during online backup, the backup fails\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
All WAL records required for the backup must contain sufficient full\-page writes, which requires you to enable
\fIfull_page_writes\fR
on the master and not to use a tool like
pg_compresslog
as
\fIarchive_command\fR
to remove full\-page writes from WAL files\&.
.RE
.sp
.SH "OPTIONS"
.PP
The following command\-line options control the location and format of the output\&.
.PP
\fB\-D \fR\fB\fIdirectory\fR\fR
.br
\fB\-\-pgdata=\fR\fB\fIdirectory\fR\fR
.RS 4
Directory to write the output to\&.
pg_basebackup
will create the directory and any parent directories if necessary\&. The directory may already exist, but it is an error if the directory already exists and is not empty\&.
.sp
When the backup is in tar mode, and the directory is specified as
\-
(dash), the tar file will be written to
stdout\&.
.sp
This option is required\&.
.RE
.PP
\fB\-F \fR\fB\fIformat\fR\fR
.br
\fB\-\-format=\fR\fB\fIformat\fR\fR
.RS 4
Selects the format for the output\&.
\fIformat\fR
can be one of the following:
.PP
p
.br
plain
.RS 4
Write the output as plain files, with the same layout as the current data directory and tablespaces\&. When the cluster has no additional tablespaces, the whole database will be placed in the target directory\&. If the cluster contains additional tablespaces, the main data directory will be placed in the target directory, but all other tablespaces will be placed in the same absolute path as they have on the source server\&. (See
\fB\-\-tablespace\-mapping\fR
to change that\&.)
.sp
This is the default format\&.
.RE
.PP
t
.br
tar
.RS 4
Write the output as tar files in the target directory\&. The main data directory will be written to a file named
base\&.tar, and all other tablespaces will be named after the tablespace OID\&.
.sp
If the value
\-
(dash) is specified as target directory, the tar contents will be written to standard output, suitable for piping to for example
gzip\&. This is only possible if the cluster has no additional tablespaces\&.
.RE
.RE
.PP
\fB\-r \fR\fB\fIrate\fR\fR
.br
\fB\-\-max\-rate=\fR\fB\fIrate\fR\fR
.RS 4
The maximum transfer rate of data transferred from the server\&. Values are in kilobytes per second\&. Use a suffix of
M
to indicate megabytes per second\&. A suffix of
k
is also accepted, and has no effect\&. Valid values are between 32 kilobytes per second and 1024 megabytes per second\&.
.sp
The purpose is to limit the impact of
pg_basebackup
on the running server\&.
.sp
This option always affects transfer of the data directory\&. Transfer of WAL files is only affected if the collection method is
fetch\&.
.RE
.PP
\fB\-R\fR
.br
\fB\-\-write\-recovery\-conf\fR
.RS 4
Write a minimal
recovery\&.conf
in the output directory (or into the base archive file when using tar format) to ease setting up a standby server\&. The
recovery\&.conf
file will record the connection settings and, if specified, the replication slot that
pg_basebackup
is using, so that the streaming replication will use the same settings later on\&.
.RE
.PP
\fB\-S \fR\fB\fIslotname\fR\fR
.br
\fB\-\-slot=\fR\fB\fIslotname\fR\fR
.RS 4
This option can only be used together with
\-X stream\&. It causes the WAL streaming to use the specified replication slot\&. If the base backup is intended to be used as a streaming replication standby using replication slots, it should then use the same replication slot name in
recovery\&.conf\&. That way, it is ensured that the server does not remove any necessary WAL data in the time between the end of the base backup and the start of streaming replication\&.
.RE
.PP
\fB\-T \fR\fB\fIolddir\fR\fR\fB=\fR\fB\fInewdir\fR\fR
.br
\fB\-\-tablespace\-mapping=\fR\fB\fIolddir\fR\fR\fB=\fR\fB\fInewdir\fR\fR
.RS 4
Relocate the tablespace in directory
\fIolddir\fR
to
\fInewdir\fR
during the backup\&. To be effective,
\fIolddir\fR
must exactly match the path specification of the tablespace as it is currently defined\&. (But it is not an error if there is no tablespace in
\fIolddir\fR
contained in the backup\&.) Both
\fIolddir\fR
and
\fInewdir\fR
must be absolute paths\&. If a path happens to contain a
=
sign, escape it with a backslash\&. This option can be specified multiple times for multiple tablespaces\&. See examples below\&.
.sp
If a tablespace is relocated in this way, the symbolic links inside the main data directory are updated to point to the new location\&. So the new data directory is ready to be used for a new server instance with all tablespaces in the updated locations\&.
.sp
Currently, this option only works with plain output format; it is ignored if tar format is selected\&.
.RE
.PP
\fB\-\-xlogdir=\fR\fB\fIxlogdir\fR\fR
.RS 4
Specifies the location for the transaction log directory\&.
\fIxlogdir\fR
must be an absolute path\&. The transaction log directory can only be specified when the backup is in plain mode\&.
.RE
.PP
\fB\-x\fR
.br
\fB\-\-xlog\fR
.RS 4
Using this option is equivalent of using
\-X
with method
fetch\&.
.RE
.PP
\fB\-X \fR\fB\fImethod\fR\fR
.br
\fB\-\-xlog\-method=\fR\fB\fImethod\fR\fR
.RS 4
Includes the required transaction log files (WAL files) in the backup\&. This will include all transaction logs generated during the backup\&. If this option is specified, it is possible to start a postmaster directly in the extracted directory without the need to consult the log archive, thus making this a completely standalone backup\&.
.sp
The following methods for collecting the transaction logs are supported:
.PP
f
.br
fetch
.RS 4
The transaction log files are collected at the end of the backup\&. Therefore, it is necessary for the
wal_keep_segments
parameter to be set high enough that the log is not removed before the end of the backup\&. If the log has been rotated when it\*(Aqs time to transfer it, the backup will fail and be unusable\&.
.RE
.PP
s
.br
stream
.RS 4
Stream the transaction log while the backup is created\&. This will open a second connection to the server and start streaming the transaction log in parallel while running the backup\&. Therefore, it will use up two connections configured by the
max_wal_senders
parameter\&. As long as the client can keep up with transaction log received, using this mode requires no extra transaction logs to be saved on the master\&.
.RE
.sp
.RE
.PP
\fB\-z\fR
.br
\fB\-\-gzip\fR
.RS 4
Enables gzip compression of tar file output, with the default compression level\&. Compression is only available when using the tar format\&.
.RE
.PP
\fB\-Z \fR\fB\fIlevel\fR\fR
.br
\fB\-\-compress=\fR\fB\fIlevel\fR\fR
.RS 4
Enables gzip compression of tar file output, and specifies the compression level (0 through 9, 0 being no compression and 9 being best compression)\&. Compression is only available when using the tar format\&.
.RE
.PP
The following command\-line options control the generation of the backup and the running of the program\&.
.PP
\fB\-c \fR\fB\fIfast|spread\fR\fR
.br
\fB\-\-checkpoint=\fR\fB\fIfast|spread\fR\fR
.RS 4
Sets checkpoint mode to fast (immediate) or spread (default) (see
Section 25.3.3, \(lqMaking a Base Backup Using the Low Level API\(rq, in the documentation)\&.
.RE
.PP
\fB\-l \fR\fB\fIlabel\fR\fR
.br
\fB\-\-label=\fR\fB\fIlabel\fR\fR
.RS 4
Sets the label for the backup\&. If none is specified, a default value of
\(lqpg_basebackup base backup\(rq
will be used\&.
.RE
.PP
\fB\-P\fR
.br
\fB\-\-progress\fR
.RS 4
Enables progress reporting\&. Turning this on will deliver an approximate progress report during the backup\&. Since the database may change during the backup, this is only an approximation and may not end at exactly
100%\&. In particular, when WAL log is included in the backup, the total amount of data cannot be estimated in advance, and in this case the estimated target size will increase once it passes the total estimate without WAL\&.
.sp
When this is enabled, the backup will start by enumerating the size of the entire database, and then go back and send the actual contents\&. This may make the backup take slightly longer, and in particular it will take longer before the first data is sent\&.
.RE
.PP
\fB\-v\fR
.br
\fB\-\-verbose\fR
.RS 4
Enables verbose mode\&. Will output some extra steps during startup and shutdown, as well as show the exact file name that is currently being processed if progress reporting is also enabled\&.
.RE
.PP
The following command\-line options control the database connection parameters\&.
.PP
\fB\-d \fR\fB\fIconnstr\fR\fR
.br
\fB\-\-dbname=\fR\fB\fIconnstr\fR\fR
.RS 4
Specifies parameters used to connect to the server, as a
connection string; these will override any conflicting command line options\&.
.sp
The option is called
\-\-dbname
for consistency with other client applications, but because
pg_basebackup
doesn\*(Aqt connect to any particular database in the cluster, database name in the connection string will be ignored\&.
.RE
.PP
\fB\-h \fR\fB\fIhost\fR\fR
.br
\fB\-\-host=\fR\fB\fIhost\fR\fR
.RS 4
Specifies the host name of the machine on which the server is running\&. If the value begins with a slash, it is used as the directory for the Unix domain socket\&. The default is taken from the
\fBPGHOST\fR
environment variable, if set, else a Unix domain socket connection is attempted\&.
.RE
.PP
\fB\-p \fR\fB\fIport\fR\fR
.br
\fB\-\-port=\fR\fB\fIport\fR\fR
.RS 4
Specifies the TCP port or local Unix domain socket file extension on which the server is listening for connections\&. Defaults to the
\fBPGPORT\fR
environment variable, if set, or a compiled\-in default\&.
.RE
.PP
\fB\-s \fR\fB\fIinterval\fR\fR
.br
\fB\-\-status\-interval=\fR\fB\fIinterval\fR\fR
.RS 4
Specifies the number of seconds between status packets sent back to the server\&. This allows for easier monitoring of the progress from server\&. A value of zero disables the periodic status updates completely, although an update will still be sent when requested by the server, to avoid timeout disconnect\&. The default value is 10 seconds\&.
.RE
.PP
\fB\-U \fR\fB\fIusername\fR\fR
.br
\fB\-\-username=\fR\fB\fIusername\fR\fR
.RS 4
User name to connect as\&.
.RE
.PP
\fB\-w\fR
.br
\fB\-\-no\-password\fR
.RS 4
Never issue a password prompt\&. If the server requires password authentication and a password is not available by other means such as a
\&.pgpass
file, the connection attempt will fail\&. This option can be useful in batch jobs and scripts where no user is present to enter a password\&.
.RE
.PP
\fB\-W\fR
.br
\fB\-\-password\fR
.RS 4
Force
pg_basebackup
to prompt for a password before connecting to a database\&.
.sp
This option is never essential, since
pg_basebackup
will automatically prompt for a password if the server demands password authentication\&. However,
pg_basebackup
will waste a connection attempt finding out that the server wants a password\&. In some cases it is worth typing
\fB\-W\fR
to avoid the extra connection attempt\&.
.RE
.PP
Other options are also available:
.PP
\fB\-V\fR
.br
\fB\-\-version\fR
.RS 4
Print the
pg_basebackup
version and exit\&.
.RE
.PP
\fB\-?\fR
.br
\fB\-\-help\fR
.RS 4
Show help about
pg_basebackup
command line arguments, and exit\&.
.RE
.SH "ENVIRONMENT"
.PP
This utility, like most other
PostgreSQL
utilities, uses the environment variables supported by
libpq
(see
Section 32.14, \(lqEnvironment Variables\(rq, in the documentation)\&.
.SH "NOTES"
.PP
At the beginning of the backup, a checkpoint needs to be written on the server the backup is taken from\&. Especially if the option
\-\-checkpoint=fast
is not used, this can take some time during which
pg_basebackup
will be appear to be idle\&.
.PP
The backup will include all files in the data directory and tablespaces, including the configuration files and any additional files placed in the directory by third parties\&. But only regular files and directories are copied\&. Symbolic links (other than those used for tablespaces) and special device files are skipped\&. (See
Section 51.3, \(lqStreaming Replication Protocol\(rq, in the documentation
for the precise details\&.)
.PP
Tablespaces will in plain format by default be backed up to the same path they have on the server, unless the option
\-\-tablespace\-mapping
is used\&. Without this option, running a plain format base backup on the same host as the server will not work if tablespaces are in use, because the backup would have to be written to the same directory locations as the original tablespaces\&.
.PP
When tar format mode is used, it is the user\*(Aqs responsibility to unpack each tar file before starting the PostgreSQL server\&. If there are additional tablespaces, the tar files for them need to be unpacked in the correct locations\&. In this case the symbolic links for those tablespaces will be created by the server according to the contents of the
tablespace_map
file that is included in the
base\&.tar
file\&.
.PP
pg_basebackup
works with servers of the same or an older major version, down to 9\&.1\&. However, WAL streaming mode (\-X stream) only works with server version 9\&.3 and later, and tar format mode (\-\-format=tar) of the current version only works with server version 9\&.5 or later\&.
.SH "EXAMPLES"
.PP
To create a base backup of the server at
mydbserver
and store it in the local directory
/usr/local/pgsql/data:
.sp
.if n \{\
.RS 4
.\}
.nf
$ \fBpg_basebackup \-h mydbserver \-D /usr/local/pgsql/data\fR
.fi
.if n \{\
.RE
.\}
.PP
To create a backup of the local server with one compressed tar file for each tablespace, and store it in the directory
backup, showing a progress report while running:
.sp
.if n \{\
.RS 4
.\}
.nf
$ \fBpg_basebackup \-D backup \-Ft \-z \-P\fR
.fi
.if n \{\
.RE
.\}
.PP
To create a backup of a single\-tablespace local database and compress this with
bzip2:
.sp
.if n \{\
.RS 4
.\}
.nf
$ \fBpg_basebackup \-D \- \-Ft | bzip2 > backup\&.tar\&.bz2\fR
.fi
.if n \{\
.RE
.\}
.sp
(This command will fail if there are multiple tablespaces in the database\&.)
.PP
To create a backup of a local database where the tablespace in
/opt/ts
is relocated to
\&./backup/ts:
.sp
.if n \{\
.RS 4
.\}
.nf
$ \fBpg_basebackup \-D backup/data \-T /opt/ts=$(pwd)/backup/ts\fR
.fi
.if n \{\
.RE
.\}
.sp
.SH "SEE ALSO"
\fBpg_dump\fR(1)
man/man1/ecpg.1 0000644 00000013016 14751153421 0007157 0 ustar 00 '\" t
.\" Title: ecpg
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "ECPG" "1" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
ecpg \- embedded SQL C preprocessor
.SH "SYNOPSIS"
.HP \w'\fBecpg\fR\ 'u
\fBecpg\fR [\fIoption\fR...] \fIfile\fR...
.SH "DESCRIPTION"
.PP
\fBecpg\fR
is the embedded SQL preprocessor for C programs\&. It converts C programs with embedded SQL statements to normal C code by replacing the SQL invocations with special function calls\&. The output files can then be processed with any C compiler tool chain\&.
.PP
\fBecpg\fR
will convert each input file given on the command line to the corresponding C output file\&. If an input file name does not have any extension,
\&.pgc
is assumed\&. The file\*(Aqs extension will be replaced by
\&.c
to construct the output file name\&. But the output file name can be overridden using the
\fB\-o\fR
option\&.
.PP
If an input file name is just
\-,
\fBecpg\fR
reads the program from standard input (and writes to standard output, unless that is overridden with
\fB\-o\fR)\&.
.PP
This reference page does not describe the embedded SQL language\&. See
Chapter 34, ECPG - Embedded SQL in C, in the documentation
for more information on that topic\&.
.SH "OPTIONS"
.PP
\fBecpg\fR
accepts the following command\-line arguments:
.PP
\fB\-c\fR
.RS 4
Automatically generate certain C code from SQL code\&. Currently, this works for
EXEC SQL TYPE\&.
.RE
.PP
\fB\-C \fR\fB\fImode\fR\fR
.RS 4
Set a compatibility mode\&.
\fImode\fR
can be
INFORMIX
or
INFORMIX_SE\&.
.RE
.PP
\fB\-D \fR\fB\fIsymbol\fR\fR
.RS 4
Define a C preprocessor symbol\&.
.RE
.PP
\fB\-h\fR
.RS 4
Process header files\&. When this option is specified, the output file extension becomes
\&.h
not
\&.c, and the default input file extension is
\&.pgh
not
\&.pgc\&. Also, the
\fB\-c\fR
option is forced on\&.
.RE
.PP
\fB\-i\fR
.RS 4
Parse system include files as well\&.
.RE
.PP
\fB\-I \fR\fB\fIdirectory\fR\fR
.RS 4
Specify an additional include path, used to find files included via
EXEC SQL INCLUDE\&. Defaults are
\&.
(current directory),
/usr/local/include, the
PostgreSQL
include directory which is defined at compile time (default:
/usr/local/pgsql/include), and
/usr/include, in that order\&.
.RE
.PP
\fB\-o \fR\fB\fIfilename\fR\fR
.RS 4
Specifies that
\fBecpg\fR
should write all its output to the given
\fIfilename\fR\&. Write
\-o \-
to send all output to standard output\&.
.RE
.PP
\fB\-r \fR\fB\fIoption\fR\fR
.RS 4
Selects run\-time behavior\&.
\fIOption\fR
can be one of the following:
.PP
\fBno_indicator\fR
.RS 4
Do not use indicators but instead use special values to represent null values\&. Historically there have been databases using this approach\&.
.RE
.PP
\fBprepare\fR
.RS 4
Prepare all statements before using them\&. Libecpg will keep a cache of prepared statements and reuse a statement if it gets executed again\&. If the cache runs full, libecpg will free the least used statement\&.
.RE
.PP
\fBquestionmarks\fR
.RS 4
Allow question mark as placeholder for compatibility reasons\&. This used to be the default long ago\&.
.RE
.RE
.PP
\fB\-t\fR
.RS 4
Turn on autocommit of transactions\&. In this mode, each SQL command is automatically committed unless it is inside an explicit transaction block\&. In the default mode, commands are committed only when
\fBEXEC SQL COMMIT\fR
is issued\&.
.RE
.PP
\fB\-v\fR
.RS 4
Print additional information including the version and the "include" path\&.
.RE
.PP
\fB\-\-version\fR
.RS 4
Print the
ecpg
version and exit\&.
.RE
.PP
\fB\-?\fR
.br
\fB\-\-help\fR
.RS 4
Show help about
ecpg
command line arguments, and exit\&.
.RE
.SH "NOTES"
.PP
When compiling the preprocessed C code files, the compiler needs to be able to find the
ECPG
header files in the
PostgreSQL
include directory\&. Therefore, you might have to use the
\fB\-I\fR
option when invoking the compiler (e\&.g\&.,
\-I/usr/local/pgsql/include)\&.
.PP
Programs using C code with embedded SQL have to be linked against the
libecpg
library, for example using the linker options
\-L/usr/local/pgsql/lib \-lecpg\&.
.PP
The value of either of these directories that is appropriate for the installation can be found out using
\fBpg_config\fR(1)\&.
.SH "EXAMPLES"
.PP
If you have an embedded SQL C source file named
prog1\&.pgc, you can create an executable program using the following sequence of commands:
.sp
.if n \{\
.RS 4
.\}
.nf
ecpg prog1\&.pgc
cc \-I/usr/local/pgsql/include \-c prog1\&.c
cc \-o prog1 prog1\&.o \-L/usr/local/pgsql/lib \-lecpg
.fi
.if n \{\
.RE
.\}
man/man1/pg_config.1 0000644 00000014162 14751153421 0010177 0 ustar 00 '\" t
.\" Title: pg_config
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "PG_CONFIG" "1" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
pg_config \- retrieve information about the installed version of PostgreSQL
.SH "SYNOPSIS"
.HP \w'\fBpg_config\fR\ 'u
\fBpg_config\fR [\fIoption\fR...]
.SH "DESCRIPTION"
.PP
The
pg_config
utility prints configuration parameters of the currently installed version of
PostgreSQL\&. It is intended, for example, to be used by software packages that want to interface to
PostgreSQL
to facilitate finding the required header files and libraries\&.
.SH "OPTIONS"
.PP
To use
pg_config, supply one or more of the following options:
.PP
\fB\-\-bindir\fR
.RS 4
Print the location of user executables\&. Use this, for example, to find the
\fBpsql\fR
program\&. This is normally also the location where the
pg_config
program resides\&.
.RE
.PP
\fB\-\-docdir\fR
.RS 4
Print the location of documentation files\&.
.RE
.PP
\fB\-\-htmldir\fR
.RS 4
Print the location of HTML documentation files\&.
.RE
.PP
\fB\-\-includedir\fR
.RS 4
Print the location of C header files of the client interfaces\&.
.RE
.PP
\fB\-\-pkgincludedir\fR
.RS 4
Print the location of other C header files\&.
.RE
.PP
\fB\-\-includedir\-server\fR
.RS 4
Print the location of C header files for server programming\&.
.RE
.PP
\fB\-\-libdir\fR
.RS 4
Print the location of object code libraries\&.
.RE
.PP
\fB\-\-pkglibdir\fR
.RS 4
Print the location of dynamically loadable modules, or where the server would search for them\&. (Other architecture\-dependent data files might also be installed in this directory\&.)
.RE
.PP
\fB\-\-localedir\fR
.RS 4
Print the location of locale support files\&. (This will be an empty string if locale support was not configured when
PostgreSQL
was built\&.)
.RE
.PP
\fB\-\-mandir\fR
.RS 4
Print the location of manual pages\&.
.RE
.PP
\fB\-\-sharedir\fR
.RS 4
Print the location of architecture\-independent support files\&.
.RE
.PP
\fB\-\-sysconfdir\fR
.RS 4
Print the location of system\-wide configuration files\&.
.RE
.PP
\fB\-\-pgxs\fR
.RS 4
Print the location of extension makefiles\&.
.RE
.PP
\fB\-\-configure\fR
.RS 4
Print the options that were given to the
configure
script when
PostgreSQL
was configured for building\&. This can be used to reproduce the identical configuration, or to find out with what options a binary package was built\&. (Note however that binary packages often contain vendor\-specific custom patches\&.) See also the examples below\&.
.RE
.PP
\fB\-\-cc\fR
.RS 4
Print the value of the
\fICC\fR
variable that was used for building
PostgreSQL\&. This shows the C compiler used\&.
.RE
.PP
\fB\-\-cppflags\fR
.RS 4
Print the value of the
\fICPPFLAGS\fR
variable that was used for building
PostgreSQL\&. This shows C compiler switches needed at preprocessing time (typically,
\-I
switches)\&.
.RE
.PP
\fB\-\-cflags\fR
.RS 4
Print the value of the
\fICFLAGS\fR
variable that was used for building
PostgreSQL\&. This shows C compiler switches\&.
.RE
.PP
\fB\-\-cflags_sl\fR
.RS 4
Print the value of the
\fICFLAGS_SL\fR
variable that was used for building
PostgreSQL\&. This shows extra C compiler switches used for building shared libraries\&.
.RE
.PP
\fB\-\-ldflags\fR
.RS 4
Print the value of the
\fILDFLAGS\fR
variable that was used for building
PostgreSQL\&. This shows linker switches\&.
.RE
.PP
\fB\-\-ldflags_ex\fR
.RS 4
Print the value of the
\fILDFLAGS_EX\fR
variable that was used for building
PostgreSQL\&. This shows linker switches used for building executables only\&.
.RE
.PP
\fB\-\-ldflags_sl\fR
.RS 4
Print the value of the
\fILDFLAGS_SL\fR
variable that was used for building
PostgreSQL\&. This shows linker switches used for building shared libraries only\&.
.RE
.PP
\fB\-\-libs\fR
.RS 4
Print the value of the
\fILIBS\fR
variable that was used for building
PostgreSQL\&. This normally contains
\-l
switches for external libraries linked into
PostgreSQL\&.
.RE
.PP
\fB\-\-version\fR
.RS 4
Print the version of
PostgreSQL\&.
.RE
.PP
\fB\-?\fR
.br
\fB\-\-help\fR
.RS 4
Show help about
pg_config
command line arguments, and exit\&.
.RE
If more than one option is given, the information is printed in that order, one item per line\&. If no options are given, all available information is printed, with labels\&.
.SH "NOTES"
.PP
The options
\fB\-\-docdir\fR,
\fB\-\-pkgincludedir\fR,
\fB\-\-localedir\fR,
\fB\-\-mandir\fR,
\fB\-\-sharedir\fR,
\fB\-\-sysconfdir\fR,
\fB\-\-cc\fR,
\fB\-\-cppflags\fR,
\fB\-\-cflags\fR,
\fB\-\-cflags_sl\fR,
\fB\-\-ldflags\fR,
\fB\-\-ldflags_sl\fR, and
\fB\-\-libs\fR
were added in
PostgreSQL
8\&.1\&. The option
\fB\-\-htmldir\fR
was added in
PostgreSQL
8\&.4\&. The option
\fB\-\-ldflags_ex\fR
was added in
PostgreSQL
9\&.0\&.
.SH "EXAMPLE"
.PP
To reproduce the build configuration of the current PostgreSQL installation, run the following command:
.sp
.if n \{\
.RS 4
.\}
.nf
eval \&./configure `pg_config \-\-configure`
.fi
.if n \{\
.RE
.\}
.sp
The output of
pg_config \-\-configure
contains shell quotation marks so arguments with spaces are represented correctly\&. Therefore, using
eval
is required for proper results\&.
man/man1/pg_xlogdump.1 0000644 00000011124 14751153421 0010564 0 ustar 00 '\" t
.\" Title: pg_xlogdump
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "PG_XLOGDUMP" "1" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
pg_xlogdump \- display a human\-readable rendering of the write\-ahead log of a PostgreSQL database cluster
.SH "SYNOPSIS"
.HP \w'\fBpg_xlogdump\fR\ 'u
\fBpg_xlogdump\fR [\fBoption\fR...] [\fBstartseg\fR\ [\fBendseg\fR]]
.SH "DESCRIPTION"
.PP
\fBpg_xlogdump\fR
displays the write\-ahead log (WAL) and is mainly useful for debugging or educational purposes\&.
.PP
This utility can only be run by the user who installed the server, because it requires read\-only access to the data directory\&.
.SH "OPTIONS"
.PP
The following command\-line options control the location and format of the output:
.PP
\fIstartseg\fR
.RS 4
Start reading at the specified log segment file\&. This implicitly determines the path in which files will be searched for, and the timeline to use\&.
.RE
.PP
\fIendseg\fR
.RS 4
Stop after reading the specified log segment file\&.
.RE
.PP
\fB\-b\fR
.br
\fB\-\-bkp\-details\fR
.RS 4
Output detailed information about backup blocks\&.
.RE
.PP
\fB\-e \fR\fB\fIend\fR\fR
.br
\fB\-\-end=\fR\fB\fIend\fR\fR
.RS 4
Stop reading at the specified log position, instead of reading to the end of the log stream\&.
.RE
.PP
\fB\-f\fR
.br
\fB\-\-follow\fR
.RS 4
After reaching the end of valid WAL, keep polling once per second for new WAL to appear\&.
.RE
.PP
\fB\-n \fR\fB\fIlimit\fR\fR
.br
\fB\-\-limit=\fR\fB\fIlimit\fR\fR
.RS 4
Display the specified number of records, then stop\&.
.RE
.PP
\fB\-p \fR\fB\fIpath\fR\fR
.br
\fB\-\-path=\fR\fB\fIpath\fR\fR
.RS 4
Specifies a directory to search for log segment files or a directory with a
pg_xlog
subdirectory that contains such files\&. The default is to search in the current directory, the
pg_xlog
subdirectory of the current directory, and the
pg_xlog
subdirectory of
\fBPGDATA\fR\&.
.RE
.PP
\fB\-r \fR\fB\fIrmgr\fR\fR
.br
\fB\-\-rmgr=\fR\fB\fIrmgr\fR\fR
.RS 4
Only display records generated by the specified resource manager\&. If
list
is passed as name, print a list of valid resource manager names, and exit\&.
.RE
.PP
\fB\-s \fR\fB\fIstart\fR\fR
.br
\fB\-\-start=\fR\fB\fIstart\fR\fR
.RS 4
Log position at which to start reading\&. The default is to start reading the first valid log record found in the earliest file found\&.
.RE
.PP
\fB\-t \fR\fB\fItimeline\fR\fR
.br
\fB\-\-timeline=\fR\fB\fItimeline\fR\fR
.RS 4
Timeline from which to read log records\&. The default is to use the value in
\fIstartseg\fR, if that is specified; otherwise, the default is 1\&.
.RE
.PP
\fB\-V\fR
.br
\fB\-\-version\fR
.RS 4
Print the
pg_xlogdump
version and exit\&.
.RE
.PP
\fB\-x \fR\fB\fIxid\fR\fR
.br
\fB\-\-xid=\fR\fB\fIxid\fR\fR
.RS 4
Only display records marked with the given transaction ID\&.
.RE
.PP
\fB\-z\fR
.br
\fB\-\-stats[=record]\fR
.RS 4
Display summary statistics (number and size of records and full\-page images) instead of individual records\&. Optionally generate statistics per\-record instead of per\-rmgr\&.
.RE
.PP
\fB\-?\fR
.br
\fB\-\-help\fR
.RS 4
Show help about
pg_xlogdump
command line arguments, and exit\&.
.RE
.SH "NOTES"
.PP
Can give wrong results when the server is running\&.
.PP
Only the specified timeline is displayed (or the default, if none is specified)\&. Records in other timelines are ignored\&.
.PP
pg_xlogdump
cannot read WAL files with suffix
\&.partial\&. If those files need to be read,
\&.partial
suffix needs to be removed from the file name\&.
.SH "SEE ALSO"
Section 30.5, \(lqWAL Internals\(rq, in the documentation
man/man1/createlang.1 0000644 00000012466 14751153421 0010356 0 ustar 00 '\" t
.\" Title: createlang
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "CREATELANG" "1" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
createlang \- install a PostgreSQL procedural language
.SH "SYNOPSIS"
.HP \w'\fBcreatelang\fR\ 'u
\fBcreatelang\fR [\fIconnection\-option\fR...] \fIlangname\fR [\fIdbname\fR]
.HP \w'\fBcreatelang\fR\ 'u
\fBcreatelang\fR [\fIconnection\-option\fR...] \fB\-\-list\fR | \fB\-l\fR [\fIdbname\fR]
.SH "DESCRIPTION"
.PP
createlang
is a utility for adding a procedural language to a
PostgreSQL
database\&.
.PP
createlang
is just a wrapper around the
CREATE EXTENSION (\fBCREATE_EXTENSION\fR(7))
SQL command\&.
.if n \{\
.sp
.\}
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBCaution\fR
.ps -1
.br
.PP
createlang
is deprecated and may be removed in a future
PostgreSQL
release\&. Direct use of the
\fBCREATE EXTENSION\fR
command is recommended instead\&.
.sp .5v
.RE
.SH "OPTIONS"
.PP
createlang
accepts the following command\-line arguments:
.PP
\fIlangname\fR
.RS 4
Specifies the name of the procedural language to be installed\&. (This name is lower\-cased\&.)
.RE
.PP
\fB[\-d]\fR\fB \fR\fB\fIdbname\fR\fR
.br
\fB[\-\-dbname=]\fR\fB\fIdbname\fR\fR
.RS 4
Specifies the database to which the language should be added\&. The default is to use the database with the same name as the current system user\&.
.RE
.PP
\fB\-e\fR
.br
\fB\-\-echo\fR
.RS 4
Display SQL commands as they are executed\&.
.RE
.PP
\fB\-l\fR
.br
\fB\-\-list\fR
.RS 4
Show a list of already installed languages in the target database\&.
.RE
.PP
\fB\-V\fR
.br
\fB\-\-version\fR
.RS 4
Print the
createlang
version and exit\&.
.RE
.PP
\fB\-?\fR
.br
\fB\-\-help\fR
.RS 4
Show help about
createlang
command line arguments, and exit\&.
.RE
.PP
createlang
also accepts the following command\-line arguments for connection parameters:
.PP
\fB\-h \fR\fB\fIhost\fR\fR
.br
\fB\-\-host=\fR\fB\fIhost\fR\fR
.RS 4
Specifies the host name of the machine on which the server is running\&. If the value begins with a slash, it is used as the directory for the Unix domain socket\&.
.RE
.PP
\fB\-p \fR\fB\fIport\fR\fR
.br
\fB\-\-port=\fR\fB\fIport\fR\fR
.RS 4
Specifies the TCP port or local Unix domain socket file extension on which the server is listening for connections\&.
.RE
.PP
\fB\-U \fR\fB\fIusername\fR\fR
.br
\fB\-\-username=\fR\fB\fIusername\fR\fR
.RS 4
User name to connect as\&.
.RE
.PP
\fB\-w\fR
.br
\fB\-\-no\-password\fR
.RS 4
Never issue a password prompt\&. If the server requires password authentication and a password is not available by other means such as a
\&.pgpass
file, the connection attempt will fail\&. This option can be useful in batch jobs and scripts where no user is present to enter a password\&.
.RE
.PP
\fB\-W\fR
.br
\fB\-\-password\fR
.RS 4
Force
createlang
to prompt for a password before connecting to a database\&.
.sp
This option is never essential, since
createlang
will automatically prompt for a password if the server demands password authentication\&. However,
createlang
will waste a connection attempt finding out that the server wants a password\&. In some cases it is worth typing
\fB\-W\fR
to avoid the extra connection attempt\&.
.RE
.SH "ENVIRONMENT"
.PP
\fBPGDATABASE\fR
.br
\fBPGHOST\fR
.br
\fBPGPORT\fR
.br
\fBPGUSER\fR
.RS 4
Default connection parameters
.RE
.PP
This utility, like most other
PostgreSQL
utilities, also uses the environment variables supported by
libpq
(see
Section 32.14, \(lqEnvironment Variables\(rq, in the documentation)\&.
.SH "DIAGNOSTICS"
.PP
Most error messages are self\-explanatory\&. If not, run
createlang
with the
\fB\-\-echo\fR
option and see the respective
SQL
command for details\&. Also, any default connection settings and environment variables used by the
libpq
front\-end library will apply\&.
.SH "NOTES"
.PP
Use
\fBdroplang\fR(1)
to remove a language\&.
.SH "EXAMPLES"
.PP
To install the language
pltcl
into the database
template1:
.sp
.if n \{\
.RS 4
.\}
.nf
$ \fBcreatelang pltcl template1\fR
.fi
.if n \{\
.RE
.\}
.sp
Note that installing the language into
template1
will cause it to be automatically installed into subsequently\-created databases as well\&.
.SH "SEE ALSO"
\fBdroplang\fR(1), CREATE EXTENSION (\fBCREATE_EXTENSION\fR(7)), CREATE LANGUAGE (\fBCREATE_LANGUAGE\fR(7))
man/man1/vacuumdb.1 0000644 00000021077 14751153421 0010055 0 ustar 00 '\" t
.\" Title: vacuumdb
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "VACUUMDB" "1" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
vacuumdb \- garbage\-collect and analyze a PostgreSQL database
.SH "SYNOPSIS"
.HP \w'\fBvacuumdb\fR\ 'u
\fBvacuumdb\fR [\fIconnection\-option\fR...] [\fIoption\fR...] [\ \fB\-t\fR\ |\ \fB\-\-table\fR\ \fItable\fR\ [(\ \fIcolumn\fR\ [,\&.\&.\&.]\ )]\ ]... [\fIdbname\fR]
.HP \w'\fBvacuumdb\fR\ 'u
\fBvacuumdb\fR [\fIconnection\-option\fR...] [\fIoption\fR...] \fB\-a\fR | \fB\-\-all\fR
.SH "DESCRIPTION"
.PP
vacuumdb
is a utility for cleaning a
PostgreSQL
database\&.
vacuumdb
will also generate internal statistics used by the
PostgreSQL
query optimizer\&.
.PP
vacuumdb
is a wrapper around the SQL command
\fBVACUUM\fR(7)\&. There is no effective difference between vacuuming and analyzing databases via this utility and via other methods for accessing the server\&.
.SH "OPTIONS"
.PP
vacuumdb
accepts the following command\-line arguments:
.PP
\fB\-a\fR
.br
\fB\-\-all\fR
.RS 4
Vacuum all databases\&.
.RE
.PP
\fB[\-d]\fR\fB \fR\fB\fIdbname\fR\fR
.br
\fB[\-\-dbname=]\fR\fB\fIdbname\fR\fR
.RS 4
Specifies the name of the database to be cleaned or analyzed, when
\fB\-a\fR/\fB\-\-all\fR
is not used\&. If this is not specified, the database name is read from the environment variable
\fBPGDATABASE\fR\&. If that is not set, the user name specified for the connection is used\&. The
\fIdbname\fR
can be a
connection string\&. If so, connection string parameters will override any conflicting command line options\&.
.RE
.PP
\fB\-e\fR
.br
\fB\-\-echo\fR
.RS 4
Echo the commands that
vacuumdb
generates and sends to the server\&.
.RE
.PP
\fB\-f\fR
.br
\fB\-\-full\fR
.RS 4
Perform
\(lqfull\(rq
vacuuming\&.
.RE
.PP
\fB\-F\fR
.br
\fB\-\-freeze\fR
.RS 4
Aggressively
\(lqfreeze\(rq
tuples\&.
.RE
.PP
\fB\-j \fR\fB\fInjobs\fR\fR
.br
\fB\-\-jobs=\fR\fB\fInjobs\fR\fR
.RS 4
Execute the vacuum or analyze commands in parallel by running
\fInjobs\fR
commands simultaneously\&. This option reduces the time of the processing but it also increases the load on the database server\&.
.sp
vacuumdb
will open
\fInjobs\fR
connections to the database, so make sure your
max_connections
setting is high enough to accommodate all connections\&.
.sp
Note that using this mode together with the
\fB\-f\fR
(FULL) option might cause deadlock failures if certain system catalogs are processed in parallel\&.
.RE
.PP
\fB\-q\fR
.br
\fB\-\-quiet\fR
.RS 4
Do not display progress messages\&.
.RE
.PP
\fB\-t \fR\fB\fItable\fR\fR\fB [ (\fR\fB\fIcolumn\fR\fR\fB [,\&.\&.\&.]) ]\fR
.br
\fB\-\-table=\fR\fB\fItable\fR\fR\fB [ (\fR\fB\fIcolumn\fR\fR\fB [,\&.\&.\&.]) ]\fR
.RS 4
Clean or analyze
\fItable\fR
only\&. Column names can be specified only in conjunction with the
\fB\-\-analyze\fR
or
\fB\-\-analyze\-only\fR
options\&. Multiple tables can be vacuumed by writing multiple
\fB\-t\fR
switches\&.
.if n \{\
.sp
.\}
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBTip\fR
.ps -1
.br
If you specify columns, you probably have to escape the parentheses from the shell\&. (See examples below\&.)
.sp .5v
.RE
.RE
.PP
\fB\-v\fR
.br
\fB\-\-verbose\fR
.RS 4
Print detailed information during processing\&.
.RE
.PP
\fB\-V\fR
.br
\fB\-\-version\fR
.RS 4
Print the
vacuumdb
version and exit\&.
.RE
.PP
\fB\-z\fR
.br
\fB\-\-analyze\fR
.RS 4
Also calculate statistics for use by the optimizer\&.
.RE
.PP
\fB\-Z\fR
.br
\fB\-\-analyze\-only\fR
.RS 4
Only calculate statistics for use by the optimizer (no vacuum)\&.
.RE
.PP
\fB\-\-analyze\-in\-stages\fR
.RS 4
Only calculate statistics for use by the optimizer (no vacuum), like
\fB\-\-analyze\-only\fR\&. Run several (currently three) stages of analyze with different configuration settings, to produce usable statistics faster\&.
.sp
This option is useful to analyze a database that was newly populated from a restored dump or by
\fBpg_upgrade\fR\&. This option will try to create some statistics as fast as possible, to make the database usable, and then produce full statistics in the subsequent stages\&.
.RE
.PP
\fB\-?\fR
.br
\fB\-\-help\fR
.RS 4
Show help about
vacuumdb
command line arguments, and exit\&.
.RE
.PP
vacuumdb
also accepts the following command\-line arguments for connection parameters:
.PP
\fB\-h \fR\fB\fIhost\fR\fR
.br
\fB\-\-host=\fR\fB\fIhost\fR\fR
.RS 4
Specifies the host name of the machine on which the server is running\&. If the value begins with a slash, it is used as the directory for the Unix domain socket\&.
.RE
.PP
\fB\-p \fR\fB\fIport\fR\fR
.br
\fB\-\-port=\fR\fB\fIport\fR\fR
.RS 4
Specifies the TCP port or local Unix domain socket file extension on which the server is listening for connections\&.
.RE
.PP
\fB\-U \fR\fB\fIusername\fR\fR
.br
\fB\-\-username=\fR\fB\fIusername\fR\fR
.RS 4
User name to connect as\&.
.RE
.PP
\fB\-w\fR
.br
\fB\-\-no\-password\fR
.RS 4
Never issue a password prompt\&. If the server requires password authentication and a password is not available by other means such as a
\&.pgpass
file, the connection attempt will fail\&. This option can be useful in batch jobs and scripts where no user is present to enter a password\&.
.RE
.PP
\fB\-W\fR
.br
\fB\-\-password\fR
.RS 4
Force
vacuumdb
to prompt for a password before connecting to a database\&.
.sp
This option is never essential, since
vacuumdb
will automatically prompt for a password if the server demands password authentication\&. However,
vacuumdb
will waste a connection attempt finding out that the server wants a password\&. In some cases it is worth typing
\fB\-W\fR
to avoid the extra connection attempt\&.
.RE
.PP
\fB\-\-maintenance\-db=\fR\fB\fIdbname\fR\fR
.RS 4
Specifies the name of the database to connect to to discover which databases should be vacuumed, when
\fB\-a\fR/\fB\-\-all\fR
is used\&. If not specified, the
postgres
database will be used, or if that does not exist,
template1
will be used\&. This can be a
connection string\&. If so, connection string parameters will override any conflicting command line options\&. Also, connection string parameters other than the database name itself will be re\-used when connecting to other databases\&.
.RE
.SH "ENVIRONMENT"
.PP
\fBPGDATABASE\fR
.br
\fBPGHOST\fR
.br
\fBPGPORT\fR
.br
\fBPGUSER\fR
.RS 4
Default connection parameters
.RE
.PP
This utility, like most other
PostgreSQL
utilities, also uses the environment variables supported by
libpq
(see
Section 32.14, \(lqEnvironment Variables\(rq, in the documentation)\&.
.SH "DIAGNOSTICS"
.PP
In case of difficulty, see
\fBVACUUM\fR(7)
and
\fBpsql\fR(1)
for discussions of potential problems and error messages\&. The database server must be running at the targeted host\&. Also, any default connection settings and environment variables used by the
libpq
front\-end library will apply\&.
.SH "NOTES"
.PP
vacuumdb
might need to connect several times to the
PostgreSQL
server, asking for a password each time\&. It is convenient to have a
~/\&.pgpass
file in such cases\&. See
Section 32.15, \(lqThe Password File\(rq, in the documentation
for more information\&.
.SH "EXAMPLES"
.PP
To clean the database
test:
.sp
.if n \{\
.RS 4
.\}
.nf
$ \fBvacuumdb test\fR
.fi
.if n \{\
.RE
.\}
.PP
To clean and analyze for the optimizer a database named
bigdb:
.sp
.if n \{\
.RS 4
.\}
.nf
$ \fBvacuumdb \-\-analyze bigdb\fR
.fi
.if n \{\
.RE
.\}
.PP
To clean a single table
foo
in a database named
xyzzy, and analyze a single column
bar
of the table for the optimizer:
.sp
.if n \{\
.RS 4
.\}
.nf
$ \fBvacuumdb \-\-analyze \-\-verbose \-\-table \*(Aqfoo(bar)\*(Aq xyzzy\fR
.fi
.if n \{\
.RE
.\}
.SH "SEE ALSO"
\fBVACUUM\fR(7)
man/man1/reindexdb.1 0000644 00000015745 14751153421 0010220 0 ustar 00 '\" t
.\" Title: reindexdb
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "REINDEXDB" "1" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
reindexdb \- reindex a PostgreSQL database
.SH "SYNOPSIS"
.HP \w'\fBreindexdb\fR\ 'u
\fBreindexdb\fR [\fIconnection\-option\fR...] [\fIoption\fR...] [\ \fB\-S\fR\ |\ \fB\-\-schema\fR\ \fIschema\fR\ ]... [\ \fB\-t\fR\ |\ \fB\-\-table\fR\ \fItable\fR\ ]... [\ \fB\-i\fR\ |\ \fB\-\-index\fR\ \fIindex\fR\ ]... [\fIdbname\fR]
.HP \w'\fBreindexdb\fR\ 'u
\fBreindexdb\fR [\fIconnection\-option\fR...] [\fIoption\fR...] \fB\-a\fR | \fB\-\-all\fR
.HP \w'\fBreindexdb\fR\ 'u
\fBreindexdb\fR [\fIconnection\-option\fR...] [\fIoption\fR...] \fB\-s\fR | \fB\-\-system\fR [\fIdbname\fR]
.SH "DESCRIPTION"
.PP
reindexdb
is a utility for rebuilding indexes in a
PostgreSQL
database\&.
.PP
reindexdb
is a wrapper around the SQL command
\fBREINDEX\fR(7)\&. There is no effective difference between reindexing databases via this utility and via other methods for accessing the server\&.
.SH "OPTIONS"
.PP
reindexdb
accepts the following command\-line arguments:
.PP
\fB\-a\fR
.br
\fB\-\-all\fR
.RS 4
Reindex all databases\&.
.RE
.PP
\fB[\-d]\fR\fB \fR\fB\fIdbname\fR\fR
.br
\fB[\-\-dbname=]\fR\fB\fIdbname\fR\fR
.RS 4
Specifies the name of the database to be reindexed, when
\fB\-a\fR/\fB\-\-all\fR
is not used\&. If this is not specified, the database name is read from the environment variable
\fBPGDATABASE\fR\&. If that is not set, the user name specified for the connection is used\&. The
\fIdbname\fR
can be a
connection string\&. If so, connection string parameters will override any conflicting command line options\&.
.RE
.PP
\fB\-e\fR
.br
\fB\-\-echo\fR
.RS 4
Echo the commands that
reindexdb
generates and sends to the server\&.
.RE
.PP
\fB\-i \fR\fB\fIindex\fR\fR
.br
\fB\-\-index=\fR\fB\fIindex\fR\fR
.RS 4
Recreate
\fIindex\fR
only\&. Multiple indexes can be recreated by writing multiple
\fB\-i\fR
switches\&.
.RE
.PP
\fB\-q\fR
.br
\fB\-\-quiet\fR
.RS 4
Do not display progress messages\&.
.RE
.PP
\fB\-s\fR
.br
\fB\-\-system\fR
.RS 4
Reindex database\*(Aqs system catalogs only\&.
.RE
.PP
\fB\-S \fR\fB\fIschema\fR\fR
.br
\fB\-\-schema=\fR\fB\fIschema\fR\fR
.RS 4
Reindex
\fIschema\fR
only\&. Multiple schemas can be reindexed by writing multiple
\fB\-S\fR
switches\&.
.RE
.PP
\fB\-t \fR\fB\fItable\fR\fR
.br
\fB\-\-table=\fR\fB\fItable\fR\fR
.RS 4
Reindex
\fItable\fR
only\&. Multiple tables can be reindexed by writing multiple
\fB\-t\fR
switches\&.
.RE
.PP
\fB\-v\fR
.br
\fB\-\-verbose\fR
.RS 4
Print detailed information during processing\&.
.RE
.PP
\fB\-V\fR
.br
\fB\-\-version\fR
.RS 4
Print the
reindexdb
version and exit\&.
.RE
.PP
\fB\-?\fR
.br
\fB\-\-help\fR
.RS 4
Show help about
reindexdb
command line arguments, and exit\&.
.RE
.PP
reindexdb
also accepts the following command\-line arguments for connection parameters:
.PP
\fB\-h \fR\fB\fIhost\fR\fR
.br
\fB\-\-host=\fR\fB\fIhost\fR\fR
.RS 4
Specifies the host name of the machine on which the server is running\&. If the value begins with a slash, it is used as the directory for the Unix domain socket\&.
.RE
.PP
\fB\-p \fR\fB\fIport\fR\fR
.br
\fB\-\-port=\fR\fB\fIport\fR\fR
.RS 4
Specifies the TCP port or local Unix domain socket file extension on which the server is listening for connections\&.
.RE
.PP
\fB\-U \fR\fB\fIusername\fR\fR
.br
\fB\-\-username=\fR\fB\fIusername\fR\fR
.RS 4
User name to connect as\&.
.RE
.PP
\fB\-w\fR
.br
\fB\-\-no\-password\fR
.RS 4
Never issue a password prompt\&. If the server requires password authentication and a password is not available by other means such as a
\&.pgpass
file, the connection attempt will fail\&. This option can be useful in batch jobs and scripts where no user is present to enter a password\&.
.RE
.PP
\fB\-W\fR
.br
\fB\-\-password\fR
.RS 4
Force
reindexdb
to prompt for a password before connecting to a database\&.
.sp
This option is never essential, since
reindexdb
will automatically prompt for a password if the server demands password authentication\&. However,
reindexdb
will waste a connection attempt finding out that the server wants a password\&. In some cases it is worth typing
\fB\-W\fR
to avoid the extra connection attempt\&.
.RE
.PP
\fB\-\-maintenance\-db=\fR\fB\fIdbname\fR\fR
.RS 4
Specifies the name of the database to connect to to discover which databases should be reindexed, when
\fB\-a\fR/\fB\-\-all\fR
is used\&. If not specified, the
postgres
database will be used, or if that does not exist,
template1
will be used\&. This can be a
connection string\&. If so, connection string parameters will override any conflicting command line options\&. Also, connection string parameters other than the database name itself will be re\-used when connecting to other databases\&.
.RE
.SH "ENVIRONMENT"
.PP
\fBPGDATABASE\fR
.br
\fBPGHOST\fR
.br
\fBPGPORT\fR
.br
\fBPGUSER\fR
.RS 4
Default connection parameters
.RE
.PP
This utility, like most other
PostgreSQL
utilities, also uses the environment variables supported by
libpq
(see
Section 32.14, \(lqEnvironment Variables\(rq, in the documentation)\&.
.SH "DIAGNOSTICS"
.PP
In case of difficulty, see
\fBREINDEX\fR(7)
and
\fBpsql\fR(1)
for discussions of potential problems and error messages\&. The database server must be running at the targeted host\&. Also, any default connection settings and environment variables used by the
libpq
front\-end library will apply\&.
.SH "NOTES"
.PP
reindexdb
might need to connect several times to the
PostgreSQL
server, asking for a password each time\&. It is convenient to have a
~/\&.pgpass
file in such cases\&. See
Section 32.15, \(lqThe Password File\(rq, in the documentation
for more information\&.
.SH "EXAMPLES"
.PP
To reindex the database
test:
.sp
.if n \{\
.RS 4
.\}
.nf
$ \fBreindexdb test\fR
.fi
.if n \{\
.RE
.\}
.PP
To reindex the table
foo
and the index
bar
in a database named
abcd:
.sp
.if n \{\
.RS 4
.\}
.nf
$ \fBreindexdb \-\-table foo \-\-index bar abcd\fR
.fi
.if n \{\
.RE
.\}
.SH "SEE ALSO"
\fBREINDEX\fR(7)
man/man1/pg_rewind.1 0000644 00000020277 14751153421 0010226 0 ustar 00 '\" t
.\" Title: pg_rewind
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "PG_REWIND" "1" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
pg_rewind \- synchronize a PostgreSQL data directory with another data directory that was forked from it
.SH "SYNOPSIS"
.HP \w'\fBpg_rewind\fR\ 'u
\fBpg_rewind\fR [\fIoption\fR...] {\fB\-D\ \fR | \fB\-\-target\-pgdata\fR}\fI directory\fR {\fB\-\-source\-pgdata=\fR\fB\fIdirectory\fR\fR | \fB\-\-source\-server=\fR\fB\fIconnstr\fR\fR}
.SH "DESCRIPTION"
.PP
pg_rewind
is a tool for synchronizing a PostgreSQL cluster with another copy of the same cluster, after the clusters\*(Aq timelines have diverged\&. A typical scenario is to bring an old master server back online after failover as a standby that follows the new master\&.
.PP
The result is equivalent to replacing the target data directory with the source one\&. Only changed blocks from relation files are copied; all other files are copied in full, including configuration files\&. The advantage of
pg_rewind
over taking a new base backup, or tools like
rsync, is that
pg_rewind
does not require reading through unchanged blocks in the cluster\&. This makes it a lot faster when the database is large and only a small fraction of blocks differ between the clusters\&.
.PP
pg_rewind
examines the timeline histories of the source and target clusters to determine the point where they diverged, and expects to find WAL in the target cluster\*(Aqs
pg_xlog
directory reaching all the way back to the point of divergence\&. The point of divergence can be found either on the target timeline, the source timeline, or their common ancestor\&. In the typical failover scenario where the target cluster was shut down soon after the divergence, this is not a problem, but if the target cluster ran for a long time after the divergence, the old WAL files might no longer be present\&. In that case, they can be manually copied from the WAL archive to the
pg_xlog
directory\&. The use of
pg_rewind
is not limited to failover, e\&.g\&., a standby server can be promoted, run some write transactions, and then rewound to become a standby again\&.
.PP
When the target server is started for the first time after running
pg_rewind, it will go into recovery mode and replay all WAL generated in the source server after the point of divergence\&. If some of the WAL was no longer available in the source server when
pg_rewind
was run, and therefore could not be copied by the
pg_rewind
session, it must be made available when the target server is started\&. This can be done by creating a
recovery\&.conf
file in the target data directory with a suitable
\fIrestore_command\fR\&.
.PP
pg_rewind
requires that the target server either has the
wal_log_hints
option enabled in
postgresql\&.conf
or data checksums enabled when the cluster was initialized with
initdb\&. Neither of these are currently on by default\&.
full_page_writes
must also be set to
on, but is enabled by default\&.
.if n \{\
.sp
.\}
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBWarning\fR
.ps -1
.br
.PP
If
pg_rewind
fails while processing, then the data folder of the target is likely not in a state that can be recovered\&. In such a case, taking a new fresh backup is recommended\&.
.PP
pg_rewind
will fail immediately if it finds files it cannot write directly to\&. This can happen for example when the source and the target server use the same file mapping for read\-only SSL keys and certificates\&. If such files are present on the target server it is recommended to remove them before running
pg_rewind\&. After doing the rewind, some of those files may have been copied from the source, in which case it may be necessary to remove the data copied and restore back the set of links used before the rewind\&.
.sp .5v
.RE
.SH "OPTIONS"
.PP
pg_rewind
accepts the following command\-line arguments:
.PP
\fB\-D \fR\fB\fIdirectory\fR\fR
.br
\fB\-\-target\-pgdata=\fR\fB\fIdirectory\fR\fR
.RS 4
This option specifies the target data directory that is synchronized with the source\&. The target server must be shut down cleanly before running
pg_rewind
.RE
.PP
\fB\-\-source\-pgdata=\fR\fB\fIdirectory\fR\fR
.RS 4
Specifies the file system path to the data directory of the source server to synchronize the target with\&. This option requires the source server to be cleanly shut down\&.
.RE
.PP
\fB\-\-source\-server=\fR\fB\fIconnstr\fR\fR
.RS 4
Specifies a libpq connection string to connect to the source
PostgreSQL
server to synchronize the target with\&. The connection must be a normal (non\-replication) connection with superuser access\&. This option requires the source server to be running and not in recovery mode\&.
.RE
.PP
\fB\-n\fR
.br
\fB\-\-dry\-run\fR
.RS 4
Do everything except actually modifying the target directory\&.
.RE
.PP
\fB\-P\fR
.br
\fB\-\-progress\fR
.RS 4
Enables progress reporting\&. Turning this on will deliver an approximate progress report while copying data from the source cluster\&.
.RE
.PP
\fB\-\-debug\fR
.RS 4
Print verbose debugging output that is mostly useful for developers debugging
pg_rewind\&.
.RE
.PP
\fB\-V\fR
.br
\fB\-\-version\fR
.RS 4
Display version information, then exit\&.
.RE
.PP
\fB\-?\fR
.br
\fB\-\-help\fR
.RS 4
Show help, then exit\&.
.RE
.SH "ENVIRONMENT"
.PP
When
\fB\-\-source\-server\fR
option is used,
pg_rewind
also uses the environment variables supported by
libpq
(see
Section 32.14, \(lqEnvironment Variables\(rq, in the documentation)\&.
.SH "NOTES"
.PP
When executing
pg_rewind
using an online cluster as source which has been recently promoted, it is necessary to execute a
\fBCHECKPOINT\fR
after promotion so as its control file reflects up\-to\-date timeline information, which is used by
pg_rewind
to check if the target cluster can be rewound using the designated source cluster\&.
.SS "How it works"
.PP
The basic idea is to copy all file system\-level changes from the source cluster to the target cluster:
.sp
.RS 4
.ie n \{\
\h'-04' 1.\h'+01'\c
.\}
.el \{\
.sp -1
.IP " 1." 4.2
.\}
Scan the WAL log of the target cluster, starting from the last checkpoint before the point where the source cluster\*(Aqs timeline history forked off from the target cluster\&. For each WAL record, record each data block that was touched\&. This yields a list of all the data blocks that were changed in the target cluster, after the source cluster forked off\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 2.\h'+01'\c
.\}
.el \{\
.sp -1
.IP " 2." 4.2
.\}
Copy all those changed blocks from the source cluster to the target cluster, either using direct file system access (\fB\-\-source\-pgdata\fR) or SQL (\fB\-\-source\-server\fR)\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 3.\h'+01'\c
.\}
.el \{\
.sp -1
.IP " 3." 4.2
.\}
Copy all other files such as
pg_clog
and configuration files from the source cluster to the target cluster (everything except the relation files)\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 4.\h'+01'\c
.\}
.el \{\
.sp -1
.IP " 4." 4.2
.\}
Apply the WAL from the source cluster, starting from the checkpoint created at failover\&. (Strictly speaking,
pg_rewind
doesn\*(Aqt apply the WAL, it just creates a backup label file that makes
PostgreSQL
start by replaying all WAL from that checkpoint forward\&.)
.RE
man/man1/clusterdb.1 0000644 00000014300 14751153421 0010225 0 ustar 00 '\" t
.\" Title: clusterdb
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "CLUSTERDB" "1" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
clusterdb \- cluster a PostgreSQL database
.SH "SYNOPSIS"
.HP \w'\fBclusterdb\fR\ 'u
\fBclusterdb\fR [\fIconnection\-option\fR...] [\fB\-\-verbose\fR | \fB\-v\fR] [\ \fB\-\-table\fR\ |\ \fB\-t\fR\ \fItable\fR\ ]... [\fIdbname\fR]
.HP \w'\fBclusterdb\fR\ 'u
\fBclusterdb\fR [\fIconnection\-option\fR...] [\fB\-\-verbose\fR | \fB\-v\fR] \fB\-\-all\fR | \fB\-a\fR
.SH "DESCRIPTION"
.PP
clusterdb
is a utility for reclustering tables in a
PostgreSQL
database\&. It finds tables that have previously been clustered, and clusters them again on the same index that was last used\&. Tables that have never been clustered are not affected\&.
.PP
clusterdb
is a wrapper around the SQL command
\fBCLUSTER\fR(7)\&. There is no effective difference between clustering databases via this utility and via other methods for accessing the server\&.
.SH "OPTIONS"
.PP
clusterdb
accepts the following command\-line arguments:
.PP
\fB\-a\fR
.br
\fB\-\-all\fR
.RS 4
Cluster all databases\&.
.RE
.PP
\fB[\-d]\fR\fB \fR\fB\fIdbname\fR\fR
.br
\fB[\-\-dbname=]\fR\fB\fIdbname\fR\fR
.RS 4
Specifies the name of the database to be clustered, when
\fB\-a\fR/\fB\-\-all\fR
is not used\&. If this is not specified, the database name is read from the environment variable
\fBPGDATABASE\fR\&. If that is not set, the user name specified for the connection is used\&. The
\fIdbname\fR
can be a
connection string\&. If so, connection string parameters will override any conflicting command line options\&.
.RE
.PP
\fB\-e\fR
.br
\fB\-\-echo\fR
.RS 4
Echo the commands that
clusterdb
generates and sends to the server\&.
.RE
.PP
\fB\-q\fR
.br
\fB\-\-quiet\fR
.RS 4
Do not display progress messages\&.
.RE
.PP
\fB\-t \fR\fB\fItable\fR\fR
.br
\fB\-\-table=\fR\fB\fItable\fR\fR
.RS 4
Cluster
\fItable\fR
only\&. Multiple tables can be clustered by writing multiple
\fB\-t\fR
switches\&.
.RE
.PP
\fB\-v\fR
.br
\fB\-\-verbose\fR
.RS 4
Print detailed information during processing\&.
.RE
.PP
\fB\-V\fR
.br
\fB\-\-version\fR
.RS 4
Print the
clusterdb
version and exit\&.
.RE
.PP
\fB\-?\fR
.br
\fB\-\-help\fR
.RS 4
Show help about
clusterdb
command line arguments, and exit\&.
.RE
.PP
clusterdb
also accepts the following command\-line arguments for connection parameters:
.PP
\fB\-h \fR\fB\fIhost\fR\fR
.br
\fB\-\-host=\fR\fB\fIhost\fR\fR
.RS 4
Specifies the host name of the machine on which the server is running\&. If the value begins with a slash, it is used as the directory for the Unix domain socket\&.
.RE
.PP
\fB\-p \fR\fB\fIport\fR\fR
.br
\fB\-\-port=\fR\fB\fIport\fR\fR
.RS 4
Specifies the TCP port or local Unix domain socket file extension on which the server is listening for connections\&.
.RE
.PP
\fB\-U \fR\fB\fIusername\fR\fR
.br
\fB\-\-username=\fR\fB\fIusername\fR\fR
.RS 4
User name to connect as\&.
.RE
.PP
\fB\-w\fR
.br
\fB\-\-no\-password\fR
.RS 4
Never issue a password prompt\&. If the server requires password authentication and a password is not available by other means such as a
\&.pgpass
file, the connection attempt will fail\&. This option can be useful in batch jobs and scripts where no user is present to enter a password\&.
.RE
.PP
\fB\-W\fR
.br
\fB\-\-password\fR
.RS 4
Force
clusterdb
to prompt for a password before connecting to a database\&.
.sp
This option is never essential, since
clusterdb
will automatically prompt for a password if the server demands password authentication\&. However,
clusterdb
will waste a connection attempt finding out that the server wants a password\&. In some cases it is worth typing
\fB\-W\fR
to avoid the extra connection attempt\&.
.RE
.PP
\fB\-\-maintenance\-db=\fR\fB\fIdbname\fR\fR
.RS 4
Specifies the name of the database to connect to to discover which databases should be clustered, when
\fB\-a\fR/\fB\-\-all\fR
is used\&. If not specified, the
postgres
database will be used, or if that does not exist,
template1
will be used\&. This can be a
connection string\&. If so, connection string parameters will override any conflicting command line options\&. Also, connection string parameters other than the database name itself will be re\-used when connecting to other databases\&.
.RE
.SH "ENVIRONMENT"
.PP
\fBPGDATABASE\fR
.br
\fBPGHOST\fR
.br
\fBPGPORT\fR
.br
\fBPGUSER\fR
.RS 4
Default connection parameters
.RE
.PP
This utility, like most other
PostgreSQL
utilities, also uses the environment variables supported by
libpq
(see
Section 32.14, \(lqEnvironment Variables\(rq, in the documentation)\&.
.SH "DIAGNOSTICS"
.PP
In case of difficulty, see
\fBCLUSTER\fR(7)
and
\fBpsql\fR(1)
for discussions of potential problems and error messages\&. The database server must be running at the targeted host\&. Also, any default connection settings and environment variables used by the
libpq
front\-end library will apply\&.
.SH "EXAMPLES"
.PP
To cluster the database
test:
.sp
.if n \{\
.RS 4
.\}
.nf
$ \fBclusterdb test\fR
.fi
.if n \{\
.RE
.\}
.PP
To cluster a single table
foo
in a database named
xyzzy:
.sp
.if n \{\
.RS 4
.\}
.nf
$ \fBclusterdb \-\-table foo xyzzy\fR
.fi
.if n \{\
.RE
.\}
.SH "SEE ALSO"
\fBCLUSTER\fR(7)
man/man1/createdb.1 0000644 00000016614 14751153421 0010021 0 ustar 00 '\" t
.\" Title: createdb
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "CREATEDB" "1" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
createdb \- create a new PostgreSQL database
.SH "SYNOPSIS"
.HP \w'\fBcreatedb\fR\ 'u
\fBcreatedb\fR [\fIconnection\-option\fR...] [\fIoption\fR...] [\fIdbname\fR\ [\fIdescription\fR]]
.SH "DESCRIPTION"
.PP
createdb
creates a new
PostgreSQL
database\&.
.PP
Normally, the database user who executes this command becomes the owner of the new database\&. However, a different owner can be specified via the
\fB\-O\fR
option, if the executing user has appropriate privileges\&.
.PP
createdb
is a wrapper around the
SQL
command
CREATE DATABASE (\fBCREATE_DATABASE\fR(7))\&. There is no effective difference between creating databases via this utility and via other methods for accessing the server\&.
.SH "OPTIONS"
.PP
createdb
accepts the following command\-line arguments:
.PP
\fIdbname\fR
.RS 4
Specifies the name of the database to be created\&. The name must be unique among all
PostgreSQL
databases in this cluster\&. The default is to create a database with the same name as the current system user\&.
.RE
.PP
\fIdescription\fR
.RS 4
Specifies a comment to be associated with the newly created database\&.
.RE
.PP
\fB\-D \fR\fB\fItablespace\fR\fR
.br
\fB\-\-tablespace=\fR\fB\fItablespace\fR\fR
.RS 4
Specifies the default tablespace for the database\&. (This name is processed as a double\-quoted identifier\&.)
.RE
.PP
\fB\-e\fR
.br
\fB\-\-echo\fR
.RS 4
Echo the commands that
createdb
generates and sends to the server\&.
.RE
.PP
\fB\-E \fR\fB\fIencoding\fR\fR
.br
\fB\-\-encoding=\fR\fB\fIencoding\fR\fR
.RS 4
Specifies the character encoding scheme to be used in this database\&. The character sets supported by the
PostgreSQL
server are described in
Section 23.3.1, \(lqSupported Character Sets\(rq, in the documentation\&.
.RE
.PP
\fB\-l \fR\fB\fIlocale\fR\fR
.br
\fB\-\-locale=\fR\fB\fIlocale\fR\fR
.RS 4
Specifies the locale to be used in this database\&. This is equivalent to specifying both
\fB\-\-lc\-collate\fR
and
\fB\-\-lc\-ctype\fR\&.
.RE
.PP
\fB\-\-lc\-collate=\fR\fB\fIlocale\fR\fR
.RS 4
Specifies the LC_COLLATE setting to be used in this database\&.
.RE
.PP
\fB\-\-lc\-ctype=\fR\fB\fIlocale\fR\fR
.RS 4
Specifies the LC_CTYPE setting to be used in this database\&.
.RE
.PP
\fB\-O \fR\fB\fIowner\fR\fR
.br
\fB\-\-owner=\fR\fB\fIowner\fR\fR
.RS 4
Specifies the database user who will own the new database\&. (This name is processed as a double\-quoted identifier\&.)
.RE
.PP
\fB\-T \fR\fB\fItemplate\fR\fR
.br
\fB\-\-template=\fR\fB\fItemplate\fR\fR
.RS 4
Specifies the template database from which to build this database\&. (This name is processed as a double\-quoted identifier\&.)
.RE
.PP
\fB\-V\fR
.br
\fB\-\-version\fR
.RS 4
Print the
createdb
version and exit\&.
.RE
.PP
\fB\-?\fR
.br
\fB\-\-help\fR
.RS 4
Show help about
createdb
command line arguments, and exit\&.
.RE
.PP
The options
\fB\-D\fR,
\fB\-l\fR,
\fB\-E\fR,
\fB\-O\fR, and
\fB\-T\fR
correspond to options of the underlying SQL command
CREATE DATABASE (\fBCREATE_DATABASE\fR(7)); see there for more information about them\&.
.PP
createdb
also accepts the following command\-line arguments for connection parameters:
.PP
\fB\-h \fR\fB\fIhost\fR\fR
.br
\fB\-\-host=\fR\fB\fIhost\fR\fR
.RS 4
Specifies the host name of the machine on which the server is running\&. If the value begins with a slash, it is used as the directory for the Unix domain socket\&.
.RE
.PP
\fB\-p \fR\fB\fIport\fR\fR
.br
\fB\-\-port=\fR\fB\fIport\fR\fR
.RS 4
Specifies the TCP port or the local Unix domain socket file extension on which the server is listening for connections\&.
.RE
.PP
\fB\-U \fR\fB\fIusername\fR\fR
.br
\fB\-\-username=\fR\fB\fIusername\fR\fR
.RS 4
User name to connect as\&.
.RE
.PP
\fB\-w\fR
.br
\fB\-\-no\-password\fR
.RS 4
Never issue a password prompt\&. If the server requires password authentication and a password is not available by other means such as a
\&.pgpass
file, the connection attempt will fail\&. This option can be useful in batch jobs and scripts where no user is present to enter a password\&.
.RE
.PP
\fB\-W\fR
.br
\fB\-\-password\fR
.RS 4
Force
createdb
to prompt for a password before connecting to a database\&.
.sp
This option is never essential, since
createdb
will automatically prompt for a password if the server demands password authentication\&. However,
createdb
will waste a connection attempt finding out that the server wants a password\&. In some cases it is worth typing
\fB\-W\fR
to avoid the extra connection attempt\&.
.RE
.PP
\fB\-\-maintenance\-db=\fR\fB\fIdbname\fR\fR
.RS 4
Specifies the name of the database to connect to when creating the new database\&. If not specified, the
postgres
database will be used; if that does not exist (or if it is the name of the new database being created),
template1
will be used\&. This can be a
connection string\&. If so, connection string parameters will override any conflicting command line options\&.
.RE
.SH "ENVIRONMENT"
.PP
\fBPGDATABASE\fR
.RS 4
If set, the name of the database to create, unless overridden on the command line\&.
.RE
.PP
\fBPGHOST\fR
.br
\fBPGPORT\fR
.br
\fBPGUSER\fR
.RS 4
Default connection parameters\&.
\fBPGUSER\fR
also determines the name of the database to create, if it is not specified on the command line or by
\fBPGDATABASE\fR\&.
.RE
.PP
This utility, like most other
PostgreSQL
utilities, also uses the environment variables supported by
libpq
(see
Section 32.14, \(lqEnvironment Variables\(rq, in the documentation)\&.
.SH "DIAGNOSTICS"
.PP
In case of difficulty, see
CREATE DATABASE (\fBCREATE_DATABASE\fR(7))
and
\fBpsql\fR(1)
for discussions of potential problems and error messages\&. The database server must be running at the targeted host\&. Also, any default connection settings and environment variables used by the
libpq
front\-end library will apply\&.
.SH "EXAMPLES"
.PP
To create the database
demo
using the default database server:
.sp
.if n \{\
.RS 4
.\}
.nf
$ \fBcreatedb demo\fR
.fi
.if n \{\
.RE
.\}
.PP
To create the database
demo
using the server on host
eden, port 5000, using the
LATIN1
encoding scheme with a look at the underlying command:
.sp
.if n \{\
.RS 4
.\}
.nf
$ \fBcreatedb \-p 5000 \-h eden \-E LATIN1 \-e demo\fR
CREATE DATABASE demo ENCODING \*(AqLATIN1\*(Aq;
.fi
.if n \{\
.RE
.\}
.SH "SEE ALSO"
\fBdropdb\fR(1), CREATE DATABASE (\fBCREATE_DATABASE\fR(7))
man/man1/pg_receivexlog.1 0000644 00000022641 14751153421 0011247 0 ustar 00 '\" t
.\" Title: pg_receivexlog
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "PG_RECEIVEXLOG" "1" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
pg_receivexlog \- stream transaction logs from a PostgreSQL server
.SH "SYNOPSIS"
.HP \w'\fBpg_receivexlog\fR\ 'u
\fBpg_receivexlog\fR [\fIoption\fR...]
.SH "DESCRIPTION"
.PP
pg_receivexlog
is used to stream the transaction log from a running
PostgreSQL
cluster\&. The transaction log is streamed using the streaming replication protocol, and is written to a local directory of files\&. This directory can be used as the archive location for doing a restore using point\-in\-time recovery (see
Section 25.3, \(lqContinuous Archiving and Point-in-Time Recovery (PITR)\(rq, in the documentation)\&.
.PP
pg_receivexlog
streams the transaction log in real time as it\*(Aqs being generated on the server, and does not wait for segments to complete like
archive_command
does\&. For this reason, it is not necessary to set
archive_timeout
when using
pg_receivexlog\&.
.PP
Unlike the WAL receiver of a PostgreSQL standby server,
pg_receivexlog
by default flushes WAL data only when a WAL file is closed\&. The option
\fB\-\-synchronous\fR
must be specified to flush WAL data in real time\&. Since
pg_receivexlog
does not apply WAL, you should not allow it to become a synchronous standby when
synchronous_commit
equals
remote_apply\&. If it does, it will appear to be a standby that never catches up, and will cause transaction commits to block\&. To avoid this, you should either configure an appropriate value for
synchronous_standby_names, or specify
\fIapplication_name\fR
for
pg_receivexlog
that does not match it, or change the value of
\fIsynchronous_commit\fR
to something other than
remote_apply\&.
.PP
The transaction log is streamed over a regular
PostgreSQL
connection and uses the replication protocol\&. The connection must be made with a superuser or a user having
REPLICATION
permissions (see
Section 21.2, \(lqRole Attributes\(rq, in the documentation), and
pg_hba\&.conf
must permit the replication connection\&. The server must also be configured with
max_wal_senders
set high enough to leave at least one session available for the stream\&.
.PP
If the connection is lost, or if it cannot be initially established, with a non\-fatal error,
pg_receivexlog
will retry the connection indefinitely, and reestablish streaming as soon as possible\&. To avoid this behavior, use the
\-n
parameter\&.
.SH "OPTIONS"
.PP
\fB\-D \fR\fB\fIdirectory\fR\fR
.br
\fB\-\-directory=\fR\fB\fIdirectory\fR\fR
.RS 4
Directory to write the output to\&.
.sp
This parameter is required\&.
.RE
.PP
\fB\-\-if\-not\-exists\fR
.RS 4
Do not error out when
\fB\-\-create\-slot\fR
is specified and a slot with the specified name already exists\&.
.RE
.PP
\fB\-n\fR
.br
\fB\-\-no\-loop\fR
.RS 4
Don\*(Aqt loop on connection errors\&. Instead, exit right away with an error\&.
.RE
.PP
\fB\-s \fR\fB\fIinterval\fR\fR
.br
\fB\-\-status\-interval=\fR\fB\fIinterval\fR\fR
.RS 4
Specifies the number of seconds between status packets sent back to the server\&. This allows for easier monitoring of the progress from server\&. A value of zero disables the periodic status updates completely, although an update will still be sent when requested by the server, to avoid timeout disconnect\&. The default value is 10 seconds\&.
.RE
.PP
\fB\-S \fR\fB\fIslotname\fR\fR
.br
\fB\-\-slot=\fR\fB\fIslotname\fR\fR
.RS 4
Require
pg_receivexlog
to use an existing replication slot (see
Section 26.2.6, \(lqReplication Slots\(rq, in the documentation)\&. When this option is used,
pg_receivexlog
will report a flush position to the server, indicating when each segment has been synchronized to disk so that the server can remove that segment if it is not otherwise needed\&.
.sp
When the replication client of
pg_receivexlog
is configured on the server as a synchronous standby, then using a replication slot will report the flush position to the server, but only when a WAL file is closed\&. Therefore, that configuration will cause transactions on the primary to wait for a long time and effectively not work satisfactorily\&. The option
\-\-synchronous
(see below) must be specified in addition to make this work correctly\&.
.RE
.PP
\fB\-\-synchronous\fR
.RS 4
Flush the WAL data to disk immediately after it has been received\&. Also send a status packet back to the server immediately after flushing, regardless of
\-\-status\-interval\&.
.sp
This option should be specified if the replication client of
pg_receivexlog
is configured on the server as a synchronous standby, to ensure that timely feedback is sent to the server\&.
.RE
.PP
\fB\-v\fR
.br
\fB\-\-verbose\fR
.RS 4
Enables verbose mode\&.
.RE
.PP
The following command\-line options control the database connection parameters\&.
.PP
\fB\-d \fR\fB\fIconnstr\fR\fR
.br
\fB\-\-dbname=\fR\fB\fIconnstr\fR\fR
.RS 4
Specifies parameters used to connect to the server, as a connection string\&. See
Section 32.1.1, \(lqConnection Strings\(rq, in the documentation
for more information\&.
.sp
The option is called
\-\-dbname
for consistency with other client applications, but because
pg_receivexlog
doesn\*(Aqt connect to any particular database in the cluster, database name in the connection string will be ignored\&.
.RE
.PP
\fB\-h \fR\fB\fIhost\fR\fR
.br
\fB\-\-host=\fR\fB\fIhost\fR\fR
.RS 4
Specifies the host name of the machine on which the server is running\&. If the value begins with a slash, it is used as the directory for the Unix domain socket\&. The default is taken from the
\fBPGHOST\fR
environment variable, if set, else a Unix domain socket connection is attempted\&.
.RE
.PP
\fB\-p \fR\fB\fIport\fR\fR
.br
\fB\-\-port=\fR\fB\fIport\fR\fR
.RS 4
Specifies the TCP port or local Unix domain socket file extension on which the server is listening for connections\&. Defaults to the
\fBPGPORT\fR
environment variable, if set, or a compiled\-in default\&.
.RE
.PP
\fB\-U \fR\fB\fIusername\fR\fR
.br
\fB\-\-username=\fR\fB\fIusername\fR\fR
.RS 4
User name to connect as\&.
.RE
.PP
\fB\-w\fR
.br
\fB\-\-no\-password\fR
.RS 4
Never issue a password prompt\&. If the server requires password authentication and a password is not available by other means such as a
\&.pgpass
file, the connection attempt will fail\&. This option can be useful in batch jobs and scripts where no user is present to enter a password\&.
.RE
.PP
\fB\-W\fR
.br
\fB\-\-password\fR
.RS 4
Force
pg_receivexlog
to prompt for a password before connecting to a database\&.
.sp
This option is never essential, since
pg_receivexlog
will automatically prompt for a password if the server demands password authentication\&. However,
pg_receivexlog
will waste a connection attempt finding out that the server wants a password\&. In some cases it is worth typing
\fB\-W\fR
to avoid the extra connection attempt\&.
.RE
.PP
pg_receivexlog
can perform one of the two following actions in order to control physical replication slots:
.PP
\fB\-\-create\-slot\fR
.RS 4
Create a new physical replication slot with the name specified in
\fB\-\-slot\fR, then exit\&.
.RE
.PP
\fB\-\-drop\-slot\fR
.RS 4
Drop the replication slot with the name specified in
\fB\-\-slot\fR, then exit\&.
.RE
.PP
Other options are also available:
.PP
\fB\-V\fR
.br
\fB\-\-version\fR
.RS 4
Print the
pg_receivexlog
version and exit\&.
.RE
.PP
\fB\-?\fR
.br
\fB\-\-help\fR
.RS 4
Show help about
pg_receivexlog
command line arguments, and exit\&.
.RE
.SH "ENVIRONMENT"
.PP
This utility, like most other
PostgreSQL
utilities, uses the environment variables supported by
libpq
(see
Section 32.14, \(lqEnvironment Variables\(rq, in the documentation)\&.
.SH "NOTES"
.PP
When using
pg_receivexlog
instead of
archive_command
as the main WAL backup method, it is strongly recommended to use replication slots\&. Otherwise, the server is free to recycle or remove transaction log files before they are backed up, because it does not have any information, either from
archive_command
or the replication slots, about how far the WAL stream has been archived\&. Note, however, that a replication slot will fill up the server\*(Aqs disk space if the receiver does not keep up with fetching the WAL data\&.
.SH "EXAMPLES"
.PP
To stream the transaction log from the server at
mydbserver
and store it in the local directory
/usr/local/pgsql/archive:
.sp
.if n \{\
.RS 4
.\}
.nf
$ \fBpg_receivexlog \-h mydbserver \-D /usr/local/pgsql/archive\fR
.fi
.if n \{\
.RE
.\}
.SH "SEE ALSO"
\fBpg_basebackup\fR(1)
man/man1/pg_test_fsync.1 0000644 00000005567 14751153421 0011124 0 ustar 00 '\" t
.\" Title: pg_test_fsync
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "PG_TEST_FSYNC" "1" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
pg_test_fsync \- determine fastest \fIwal_sync_method\fR for PostgreSQL
.SH "SYNOPSIS"
.HP \w'\fBpg_test_fsync\fR\ 'u
\fBpg_test_fsync\fR [\fIoption\fR...]
.SH "DESCRIPTION"
.PP
pg_test_fsync
is intended to give you a reasonable idea of what the fastest
wal_sync_method
is on your specific system, as well as supplying diagnostic information in the event of an identified I/O problem\&. However, differences shown by
pg_test_fsync
might not make any significant difference in real database throughput, especially since many database servers are not speed\-limited by their transaction logs\&.
pg_test_fsync
reports average file sync operation time in microseconds for each
wal_sync_method, which can also be used to inform efforts to optimize the value of
commit_delay\&.
.SH "OPTIONS"
.PP
pg_test_fsync
accepts the following command\-line options:
.PP
\fB\-f\fR
.br
\fB\-\-filename\fR
.RS 4
Specifies the file name to write test data in\&. This file should be in the same file system that the
pg_xlog
directory is or will be placed in\&. (pg_xlog
contains the
WAL
files\&.) The default is
pg_test_fsync\&.out
in the current directory\&.
.RE
.PP
\fB\-s\fR
.br
\fB\-\-secs\-per\-test\fR
.RS 4
Specifies the number of seconds for each test\&. The more time per test, the greater the test\*(Aqs accuracy, but the longer it takes to run\&. The default is 5 seconds, which allows the program to complete in under 2 minutes\&.
.RE
.PP
\fB\-V\fR
.br
\fB\-\-version\fR
.RS 4
Print the
pg_test_fsync
version and exit\&.
.RE
.PP
\fB\-?\fR
.br
\fB\-\-help\fR
.RS 4
Show help about
pg_test_fsync
command line arguments, and exit\&.
.RE
.SH "SEE ALSO"
\fBpostgres\fR(1)
man/man1/dropdb.1 0000644 00000012600 14751153421 0007511 0 ustar 00 '\" t
.\" Title: dropdb
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "DROPDB" "1" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
dropdb \- remove a PostgreSQL database
.SH "SYNOPSIS"
.HP \w'\fBdropdb\fR\ 'u
\fBdropdb\fR [\fIconnection\-option\fR...] [\fIoption\fR...] \fIdbname\fR
.SH "DESCRIPTION"
.PP
dropdb
destroys an existing
PostgreSQL
database\&. The user who executes this command must be a database superuser or the owner of the database\&.
.PP
dropdb
is a wrapper around the
SQL
command
DROP DATABASE (\fBDROP_DATABASE\fR(7))\&. There is no effective difference between dropping databases via this utility and via other methods for accessing the server\&.
.SH "OPTIONS"
.PP
dropdb
accepts the following command\-line arguments:
.PP
\fIdbname\fR
.RS 4
Specifies the name of the database to be removed\&.
.RE
.PP
\fB\-e\fR
.br
\fB\-\-echo\fR
.RS 4
Echo the commands that
dropdb
generates and sends to the server\&.
.RE
.PP
\fB\-i\fR
.br
\fB\-\-interactive\fR
.RS 4
Issues a verification prompt before doing anything destructive\&.
.RE
.PP
\fB\-V\fR
.br
\fB\-\-version\fR
.RS 4
Print the
dropdb
version and exit\&.
.RE
.PP
\fB\-\-if\-exists\fR
.RS 4
Do not throw an error if the database does not exist\&. A notice is issued in this case\&.
.RE
.PP
\fB\-?\fR
.br
\fB\-\-help\fR
.RS 4
Show help about
dropdb
command line arguments, and exit\&.
.RE
.PP
dropdb
also accepts the following command\-line arguments for connection parameters:
.PP
\fB\-h \fR\fB\fIhost\fR\fR
.br
\fB\-\-host=\fR\fB\fIhost\fR\fR
.RS 4
Specifies the host name of the machine on which the server is running\&. If the value begins with a slash, it is used as the directory for the Unix domain socket\&.
.RE
.PP
\fB\-p \fR\fB\fIport\fR\fR
.br
\fB\-\-port=\fR\fB\fIport\fR\fR
.RS 4
Specifies the TCP port or local Unix domain socket file extension on which the server is listening for connections\&.
.RE
.PP
\fB\-U \fR\fB\fIusername\fR\fR
.br
\fB\-\-username=\fR\fB\fIusername\fR\fR
.RS 4
User name to connect as\&.
.RE
.PP
\fB\-w\fR
.br
\fB\-\-no\-password\fR
.RS 4
Never issue a password prompt\&. If the server requires password authentication and a password is not available by other means such as a
\&.pgpass
file, the connection attempt will fail\&. This option can be useful in batch jobs and scripts where no user is present to enter a password\&.
.RE
.PP
\fB\-W\fR
.br
\fB\-\-password\fR
.RS 4
Force
dropdb
to prompt for a password before connecting to a database\&.
.sp
This option is never essential, since
dropdb
will automatically prompt for a password if the server demands password authentication\&. However,
dropdb
will waste a connection attempt finding out that the server wants a password\&. In some cases it is worth typing
\fB\-W\fR
to avoid the extra connection attempt\&.
.RE
.PP
\fB\-\-maintenance\-db=\fR\fB\fIdbname\fR\fR
.RS 4
Specifies the name of the database to connect to in order to drop the target database\&. If not specified, the
postgres
database will be used; if that does not exist (or is the database being dropped),
template1
will be used\&. This can be a
connection string\&. If so, connection string parameters will override any conflicting command line options\&.
.RE
.SH "ENVIRONMENT"
.PP
\fBPGHOST\fR
.br
\fBPGPORT\fR
.br
\fBPGUSER\fR
.RS 4
Default connection parameters
.RE
.PP
This utility, like most other
PostgreSQL
utilities, also uses the environment variables supported by
libpq
(see
Section 32.14, \(lqEnvironment Variables\(rq, in the documentation)\&.
.SH "DIAGNOSTICS"
.PP
In case of difficulty, see
DROP DATABASE (\fBDROP_DATABASE\fR(7))
and
\fBpsql\fR(1)
for discussions of potential problems and error messages\&. The database server must be running at the targeted host\&. Also, any default connection settings and environment variables used by the
libpq
front\-end library will apply\&.
.SH "EXAMPLES"
.PP
To destroy the database
demo
on the default database server:
.sp
.if n \{\
.RS 4
.\}
.nf
$ \fBdropdb demo\fR
.fi
.if n \{\
.RE
.\}
.PP
To destroy the database
demo
using the server on host
eden, port 5000, with verification and a peek at the underlying command:
.sp
.if n \{\
.RS 4
.\}
.nf
$ \fBdropdb \-p 5000 \-h eden \-i \-e demo\fR
Database "demo" will be permanently deleted\&.
Are you sure? (y/n) \fBy\fR
DROP DATABASE demo;
.fi
.if n \{\
.RE
.\}
.SH "SEE ALSO"
\fBcreatedb\fR(1), DROP DATABASE (\fBDROP_DATABASE\fR(7))
man/man1/dropuser.1 0000644 00000012353 14751153421 0010107 0 ustar 00 '\" t
.\" Title: dropuser
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "DROPUSER" "1" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
dropuser \- remove a PostgreSQL user account
.SH "SYNOPSIS"
.HP \w'\fBdropuser\fR\ 'u
\fBdropuser\fR [\fIconnection\-option\fR...] [\fIoption\fR...] [\fIusername\fR]
.SH "DESCRIPTION"
.PP
dropuser
removes an existing
PostgreSQL
user\&. Only superusers and users with the
CREATEROLE
privilege can remove
PostgreSQL
users\&. (To remove a superuser, you must yourself be a superuser\&.)
.PP
dropuser
is a wrapper around the
SQL
command
DROP ROLE (\fBDROP_ROLE\fR(7))\&. There is no effective difference between dropping users via this utility and via other methods for accessing the server\&.
.SH "OPTIONS"
.PP
dropuser
accepts the following command\-line arguments:
.PP
\fIusername\fR
.RS 4
Specifies the name of the
PostgreSQL
user to be removed\&. You will be prompted for a name if none is specified on the command line and the
\fB\-i\fR/\fB\-\-interactive\fR
option is used\&.
.RE
.PP
\fB\-e\fR
.br
\fB\-\-echo\fR
.RS 4
Echo the commands that
dropuser
generates and sends to the server\&.
.RE
.PP
\fB\-i\fR
.br
\fB\-\-interactive\fR
.RS 4
Prompt for confirmation before actually removing the user, and prompt for the user name if none is specified on the command line\&.
.RE
.PP
\fB\-V\fR
.br
\fB\-\-version\fR
.RS 4
Print the
dropuser
version and exit\&.
.RE
.PP
\fB\-\-if\-exists\fR
.RS 4
Do not throw an error if the user does not exist\&. A notice is issued in this case\&.
.RE
.PP
\fB\-?\fR
.br
\fB\-\-help\fR
.RS 4
Show help about
dropuser
command line arguments, and exit\&.
.RE
.PP
dropuser
also accepts the following command\-line arguments for connection parameters:
.PP
\fB\-h \fR\fB\fIhost\fR\fR
.br
\fB\-\-host=\fR\fB\fIhost\fR\fR
.RS 4
Specifies the host name of the machine on which the server is running\&. If the value begins with a slash, it is used as the directory for the Unix domain socket\&.
.RE
.PP
\fB\-p \fR\fB\fIport\fR\fR
.br
\fB\-\-port=\fR\fB\fIport\fR\fR
.RS 4
Specifies the TCP port or local Unix domain socket file extension on which the server is listening for connections\&.
.RE
.PP
\fB\-U \fR\fB\fIusername\fR\fR
.br
\fB\-\-username=\fR\fB\fIusername\fR\fR
.RS 4
User name to connect as (not the user name to drop)\&.
.RE
.PP
\fB\-w\fR
.br
\fB\-\-no\-password\fR
.RS 4
Never issue a password prompt\&. If the server requires password authentication and a password is not available by other means such as a
\&.pgpass
file, the connection attempt will fail\&. This option can be useful in batch jobs and scripts where no user is present to enter a password\&.
.RE
.PP
\fB\-W\fR
.br
\fB\-\-password\fR
.RS 4
Force
dropuser
to prompt for a password before connecting to a database\&.
.sp
This option is never essential, since
dropuser
will automatically prompt for a password if the server demands password authentication\&. However,
dropuser
will waste a connection attempt finding out that the server wants a password\&. In some cases it is worth typing
\fB\-W\fR
to avoid the extra connection attempt\&.
.RE
.SH "ENVIRONMENT"
.PP
\fBPGHOST\fR
.br
\fBPGPORT\fR
.br
\fBPGUSER\fR
.RS 4
Default connection parameters
.RE
.PP
This utility, like most other
PostgreSQL
utilities, also uses the environment variables supported by
libpq
(see
Section 32.14, \(lqEnvironment Variables\(rq, in the documentation)\&.
.SH "DIAGNOSTICS"
.PP
In case of difficulty, see
DROP ROLE (\fBDROP_ROLE\fR(7))
and
\fBpsql\fR(1)
for discussions of potential problems and error messages\&. The database server must be running at the targeted host\&. Also, any default connection settings and environment variables used by the
libpq
front\-end library will apply\&.
.SH "EXAMPLES"
.PP
To remove user
joe
from the default database server:
.sp
.if n \{\
.RS 4
.\}
.nf
$ \fBdropuser joe\fR
.fi
.if n \{\
.RE
.\}
.PP
To remove user
joe
using the server on host
eden, port 5000, with verification and a peek at the underlying command:
.sp
.if n \{\
.RS 4
.\}
.nf
$ \fBdropuser \-p 5000 \-h eden \-i \-e joe\fR
Role "joe" will be permanently removed\&.
Are you sure? (y/n) \fBy\fR
DROP ROLE joe;
.fi
.if n \{\
.RE
.\}
.SH "SEE ALSO"
\fBcreateuser\fR(1), DROP ROLE (\fBDROP_ROLE\fR(7))
man/man1/psql.1 0000644 00000314411 14751153421 0007223 0 ustar 00 '\" t
.\" Title: psql
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "PSQL" "1" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
psql \- PostgreSQL interactive terminal
.SH "SYNOPSIS"
.HP \w'\fBpsql\fR\ 'u
\fBpsql\fR [\fIoption\fR...] [\fIdbname\fR\ [\fIusername\fR]]
.SH "DESCRIPTION"
.PP
psql
is a terminal\-based front\-end to
PostgreSQL\&. It enables you to type in queries interactively, issue them to
PostgreSQL, and see the query results\&. Alternatively, input can be from a file or from command line arguments\&. In addition,
psql
provides a number of meta\-commands and various shell\-like features to facilitate writing scripts and automating a wide variety of tasks\&.
.SH "OPTIONS"
.PP
\fB\-a\fR
.br
\fB\-\-echo\-all\fR
.RS 4
Print all nonempty input lines to standard output as they are read\&. (This does not apply to lines read interactively\&.) This is equivalent to setting the variable
\fIECHO\fR
to
all\&.
.RE
.PP
\fB\-A\fR
.br
\fB\-\-no\-align\fR
.RS 4
Switches to unaligned output mode\&. (The default output mode is otherwise aligned\&.)
.RE
.PP
\fB\-b\fR
.br
\fB\-\-echo\-errors\fR
.RS 4
Print failed SQL commands to standard error output\&. This is equivalent to setting the variable
\fIECHO\fR
to
errors\&.
.RE
.PP
\fB\-c \fR\fB\fIcommand\fR\fR
.br
\fB\-\-command=\fR\fB\fIcommand\fR\fR
.RS 4
Specifies that
psql
is to execute the given command string,
\fIcommand\fR\&. This option can be repeated and combined in any order with the
\fB\-f\fR
option\&. When either
\fB\-c\fR
or
\fB\-f\fR
is specified,
psql
does not read commands from standard input; instead it terminates after processing all the
\fB\-c\fR
and
\fB\-f\fR
options in sequence\&.
.sp
\fIcommand\fR
must be either a command string that is completely parsable by the server (i\&.e\&., it contains no
psql\-specific features), or a single backslash command\&. Thus you cannot mix
SQL
and
psql
meta\-commands within a
\fB\-c\fR
option\&. To achieve that, you could use repeated
\fB\-c\fR
options or pipe the string into
psql, for example:
.sp
.if n \{\
.RS 4
.\}
.nf
psql \-c \*(Aq\ex\*(Aq \-c \*(AqSELECT * FROM foo;\*(Aq
.fi
.if n \{\
.RE
.\}
.sp
or
.sp
.if n \{\
.RS 4
.\}
.nf
echo \*(Aq\ex \e\e SELECT * FROM foo;\*(Aq | psql
.fi
.if n \{\
.RE
.\}
.sp
(\e\e
is the separator meta\-command\&.)
.sp
Each
SQL
command string passed to
\fB\-c\fR
is sent to the server as a single query\&. Because of this, the server executes it as a single transaction even if the string contains multiple
SQL
commands, unless there are explicit
\fBBEGIN\fR/\fBCOMMIT\fR
commands included in the string to divide it into multiple transactions\&. Also,
psql
only prints the result of the last
SQL
command in the string\&. This is different from the behavior when the same string is read from a file or fed to
psql\*(Aqs standard input, because then
psql
sends each
SQL
command separately\&.
.sp
Because of this behavior, putting more than one command in a single
\fB\-c\fR
string often has unexpected results\&. It\*(Aqs better to use repeated
\fB\-c\fR
commands or feed multiple commands to
psql\*(Aqs standard input, either using
echo
as illustrated above, or via a shell here\-document, for example:
.sp
.if n \{\
.RS 4
.\}
.nf
psql <<EOF
\ex
SELECT * FROM foo;
EOF
.fi
.if n \{\
.RE
.\}
.sp
.RE
.PP
\fB\-d \fR\fB\fIdbname\fR\fR
.br
\fB\-\-dbname=\fR\fB\fIdbname\fR\fR
.RS 4
Specifies the name of the database to connect to\&. This is equivalent to specifying
\fIdbname\fR
as the first non\-option argument on the command line\&. The
\fIdbname\fR
can be a
connection string\&. If so, connection string parameters will override any conflicting command line options\&.
.RE
.PP
\fB\-e\fR
.br
\fB\-\-echo\-queries\fR
.RS 4
Copy all SQL commands sent to the server to standard output as well\&. This is equivalent to setting the variable
\fIECHO\fR
to
queries\&.
.RE
.PP
\fB\-E\fR
.br
\fB\-\-echo\-hidden\fR
.RS 4
Echo the actual queries generated by
\fB\ed\fR
and other backslash commands\&. You can use this to study
psql\*(Aqs internal operations\&. This is equivalent to setting the variable
\fIECHO_HIDDEN\fR
to
on\&.
.RE
.PP
\fB\-f \fR\fB\fIfilename\fR\fR
.br
\fB\-\-file=\fR\fB\fIfilename\fR\fR
.RS 4
Read commands from the file
\fIfilename\fR, rather than standard input\&. This option can be repeated and combined in any order with the
\fB\-c\fR
option\&. When either
\fB\-c\fR
or
\fB\-f\fR
is specified,
psql
does not read commands from standard input; instead it terminates after processing all the
\fB\-c\fR
and
\fB\-f\fR
options in sequence\&. Except for that, this option is largely equivalent to the meta\-command
\fB\ei\fR\&.
.sp
If
\fIfilename\fR
is
\-
(hyphen), then standard input is read until an EOF indication or
\fB\eq\fR
meta\-command\&. This can be used to intersperse interactive input with input from files\&. Note however that Readline is not used in this case (much as if
\fB\-n\fR
had been specified)\&.
.sp
Using this option is subtly different from writing
psql < \fIfilename\fR\&. In general, both will do what you expect, but using
\-f
enables some nice features such as error messages with line numbers\&. There is also a slight chance that using this option will reduce the start\-up overhead\&. On the other hand, the variant using the shell\*(Aqs input redirection is (in theory) guaranteed to yield exactly the same output you would have received had you entered everything by hand\&.
.RE
.PP
\fB\-F \fR\fB\fIseparator\fR\fR
.br
\fB\-\-field\-separator=\fR\fB\fIseparator\fR\fR
.RS 4
Use
\fIseparator\fR
as the field separator for unaligned output\&. This is equivalent to
\fB\epset fieldsep\fR
or
\fB\ef\fR\&.
.RE
.PP
\fB\-h \fR\fB\fIhostname\fR\fR
.br
\fB\-\-host=\fR\fB\fIhostname\fR\fR
.RS 4
Specifies the host name of the machine on which the server is running\&. If the value begins with a slash, it is used as the directory for the Unix\-domain socket\&.
.RE
.PP
\fB\-H\fR
.br
\fB\-\-html\fR
.RS 4
Turn on
HTML
tabular output\&. This is equivalent to
\epset format html
or the
\fB\eH\fR
command\&.
.RE
.PP
\fB\-l\fR
.br
\fB\-\-list\fR
.RS 4
List all available databases, then exit\&. Other non\-connection options are ignored\&. This is similar to the meta\-command
\fB\elist\fR\&.
.RE
.PP
\fB\-L \fR\fB\fIfilename\fR\fR
.br
\fB\-\-log\-file=\fR\fB\fIfilename\fR\fR
.RS 4
Write all query output into file
\fIfilename\fR, in addition to the normal output destination\&.
.RE
.PP
\fB\-n\fR
.br
\fB\-\-no\-readline\fR
.RS 4
Do not use
Readline
for line editing and do not use the command history\&. This can be useful to turn off tab expansion when cutting and pasting\&.
.RE
.PP
\fB\-o \fR\fB\fIfilename\fR\fR
.br
\fB\-\-output=\fR\fB\fIfilename\fR\fR
.RS 4
Put all query output into file
\fIfilename\fR\&. This is equivalent to the command
\fB\eo\fR\&.
.RE
.PP
\fB\-p \fR\fB\fIport\fR\fR
.br
\fB\-\-port=\fR\fB\fIport\fR\fR
.RS 4
Specifies the TCP port or the local Unix\-domain socket file extension on which the server is listening for connections\&. Defaults to the value of the
\fBPGPORT\fR
environment variable or, if not set, to the port specified at compile time, usually 5432\&.
.RE
.PP
\fB\-P \fR\fB\fIassignment\fR\fR
.br
\fB\-\-pset=\fR\fB\fIassignment\fR\fR
.RS 4
Specifies printing options, in the style of
\fB\epset\fR\&. Note that here you have to separate name and value with an equal sign instead of a space\&. For example, to set the output format to
LaTeX, you could write
\-P format=latex\&.
.RE
.PP
\fB\-q\fR
.br
\fB\-\-quiet\fR
.RS 4
Specifies that
psql
should do its work quietly\&. By default, it prints welcome messages and various informational output\&. If this option is used, none of this happens\&. This is useful with the
\fB\-c\fR
option\&. This is equivalent to setting the variable
\fIQUIET\fR
to
on\&.
.RE
.PP
\fB\-R \fR\fB\fIseparator\fR\fR
.br
\fB\-\-record\-separator=\fR\fB\fIseparator\fR\fR
.RS 4
Use
\fIseparator\fR
as the record separator for unaligned output\&. This is equivalent to the
\fB\epset recordsep\fR
command\&.
.RE
.PP
\fB\-s\fR
.br
\fB\-\-single\-step\fR
.RS 4
Run in single\-step mode\&. That means the user is prompted before each command is sent to the server, with the option to cancel execution as well\&. Use this to debug scripts\&.
.RE
.PP
\fB\-S\fR
.br
\fB\-\-single\-line\fR
.RS 4
Runs in single\-line mode where a newline terminates an SQL command, as a semicolon does\&.
.if n \{\
.sp
.\}
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBNote\fR
.ps -1
.br
This mode is provided for those who insist on it, but you are not necessarily encouraged to use it\&. In particular, if you mix
SQL
and meta\-commands on a line the order of execution might not always be clear to the inexperienced user\&.
.sp .5v
.RE
.RE
.PP
\fB\-t\fR
.br
\fB\-\-tuples\-only\fR
.RS 4
Turn off printing of column names and result row count footers, etc\&. This is equivalent to the
\fB\et\fR
command\&.
.RE
.PP
\fB\-T \fR\fB\fItable_options\fR\fR
.br
\fB\-\-table\-attr=\fR\fB\fItable_options\fR\fR
.RS 4
Specifies options to be placed within the
HTML
table
tag\&. See
\fB\epset\fR
for details\&.
.RE
.PP
\fB\-U \fR\fB\fIusername\fR\fR
.br
\fB\-\-username=\fR\fB\fIusername\fR\fR
.RS 4
Connect to the database as the user
\fIusername\fR
instead of the default\&. (You must have permission to do so, of course\&.)
.RE
.PP
\fB\-v \fR\fB\fIassignment\fR\fR
.br
\fB\-\-set=\fR\fB\fIassignment\fR\fR
.br
\fB\-\-variable=\fR\fB\fIassignment\fR\fR
.RS 4
Perform a variable assignment, like the
\fB\eset\fR
meta\-command\&. Note that you must separate name and value, if any, by an equal sign on the command line\&. To unset a variable, leave off the equal sign\&. To set a variable with an empty value, use the equal sign but leave off the value\&. These assignments are done during a very early stage of start\-up, so variables reserved for internal purposes might get overwritten later\&.
.RE
.PP
\fB\-V\fR
.br
\fB\-\-version\fR
.RS 4
Print the
psql
version and exit\&.
.RE
.PP
\fB\-w\fR
.br
\fB\-\-no\-password\fR
.RS 4
Never issue a password prompt\&. If the server requires password authentication and a password is not available from other sources such as a
\&.pgpass
file, the connection attempt will fail\&. This option can be useful in batch jobs and scripts where no user is present to enter a password\&.
.sp
Note that this option will remain set for the entire session, and so it affects uses of the meta\-command
\fB\econnect\fR
as well as the initial connection attempt\&.
.RE
.PP
\fB\-W\fR
.br
\fB\-\-password\fR
.RS 4
Force
psql
to prompt for a password before connecting to a database, even if the password will not be used\&.
.sp
If the server requires password authentication and a password is not available from other sources such as a
\&.pgpass
file,
psql
will prompt for a password in any case\&. However,
psql
will waste a connection attempt finding out that the server wants a password\&. In some cases it is worth typing
\fB\-W\fR
to avoid the extra connection attempt\&.
.sp
Note that this option will remain set for the entire session, and so it affects uses of the meta\-command
\fB\econnect\fR
as well as the initial connection attempt\&.
.RE
.PP
\fB\-x\fR
.br
\fB\-\-expanded\fR
.RS 4
Turn on the expanded table formatting mode\&. This is equivalent to the
\fB\ex\fR
command\&.
.RE
.PP
\fB\-X,\fR
.br
\fB\-\-no\-psqlrc\fR
.RS 4
Do not read the start\-up file (neither the system\-wide
psqlrc
file nor the user\*(Aqs
~/\&.psqlrc
file)\&.
.RE
.PP
\fB\-z\fR
.br
\fB\-\-field\-separator\-zero\fR
.RS 4
Set the field separator for unaligned output to a zero byte\&.
.RE
.PP
\fB\-0\fR
.br
\fB\-\-record\-separator\-zero\fR
.RS 4
Set the record separator for unaligned output to a zero byte\&. This is useful for interfacing, for example, with
xargs \-0\&.
.RE
.PP
\fB\-1\fR
.br
\fB\-\-single\-transaction\fR
.RS 4
This option can only be used in combination with one or more
\fB\-c\fR
and/or
\fB\-f\fR
options\&. It causes
psql
to issue a
\fBBEGIN\fR
command before the first such option and a
\fBCOMMIT\fR
command after the last one, thereby wrapping all the commands into a single transaction\&. This ensures that either all the commands complete successfully, or no changes are applied\&.
.sp
If the commands themselves contain
\fBBEGIN\fR,
\fBCOMMIT\fR, or
\fBROLLBACK\fR, this option will not have the desired effects\&. Also, if an individual command cannot be executed inside a transaction block, specifying this option will cause the whole transaction to fail\&.
.RE
.PP
\fB\-?\fR
.br
\fB\-\-help[=\fR\fB\fItopic\fR\fR\fB]\fR
.RS 4
Show help about
psql
and exit\&. The optional
\fItopic\fR
parameter (defaulting to
options) selects which part of
psql
is explained:
commands
describes
psql\*(Aqs backslash commands;
options
describes the command\-line options that can be passed to
psql; and
variables
shows help about
psql
configuration variables\&.
.RE
.SH "EXIT STATUS"
.PP
psql
returns 0 to the shell if it finished normally, 1 if a fatal error of its own occurs (e\&.g\&., out of memory, file not found), 2 if the connection to the server went bad and the session was not interactive, and 3 if an error occurred in a script and the variable
\fION_ERROR_STOP\fR
was set\&.
.SH "USAGE"
.SS "Connecting to a Database"
.PP
psql
is a regular
PostgreSQL
client application\&. In order to connect to a database you need to know the name of your target database, the host name and port number of the server, and what user name you want to connect as\&.
psql
can be told about those parameters via command line options, namely
\fB\-d\fR,
\fB\-h\fR,
\fB\-p\fR, and
\fB\-U\fR
respectively\&. If an argument is found that does not belong to any option it will be interpreted as the database name (or the user name, if the database name is already given)\&. Not all of these options are required; there are useful defaults\&. If you omit the host name,
psql
will connect via a Unix\-domain socket to a server on the local host, or via TCP/IP to
localhost
on machines that don\*(Aqt have Unix\-domain sockets\&. The default port number is determined at compile time\&. Since the database server uses the same default, you will not have to specify the port in most cases\&. The default user name is your operating\-system user name, as is the default database name\&. Note that you cannot just connect to any database under any user name\&. Your database administrator should have informed you about your access rights\&.
.PP
When the defaults aren\*(Aqt quite right, you can save yourself some typing by setting the environment variables
\fBPGDATABASE\fR,
\fBPGHOST\fR,
\fBPGPORT\fR
and/or
\fBPGUSER\fR
to appropriate values\&. (For additional environment variables, see
Section 32.14, \(lqEnvironment Variables\(rq, in the documentation\&.) It is also convenient to have a
~/\&.pgpass
file to avoid regularly having to type in passwords\&. See
Section 32.15, \(lqThe Password File\(rq, in the documentation
for more information\&.
.PP
An alternative way to specify connection parameters is in a
\fIconninfo\fR
string or a
URI, which is used instead of a database name\&. This mechanism give you very wide control over the connection\&. For example:
.sp
.if n \{\
.RS 4
.\}
.nf
$ \fBpsql "service=myservice sslmode=require"\fR
$ \fBpsql postgresql://dbmaster:5433/mydb?sslmode=require\fR
.fi
.if n \{\
.RE
.\}
.sp
This way you can also use
LDAP
for connection parameter lookup as described in
Section 32.17, \(lqLDAP Lookup of Connection Parameters\(rq, in the documentation\&. See
Section 32.1.2, \(lqParameter Key Words\(rq, in the documentation
for more information on all the available connection options\&.
.PP
If the connection could not be made for any reason (e\&.g\&., insufficient privileges, server is not running on the targeted host, etc\&.),
psql
will return an error and terminate\&.
.PP
If both standard input and standard output are a terminal, then
psql
sets the client encoding to
\(lqauto\(rq, which will detect the appropriate client encoding from the locale settings (\fBLC_CTYPE\fR
environment variable on Unix systems)\&. If this doesn\*(Aqt work out as expected, the client encoding can be overridden using the environment variable
\fBPGCLIENTENCODING\fR\&.
.SS "Entering SQL Commands"
.PP
In normal operation,
psql
provides a prompt with the name of the database to which
psql
is currently connected, followed by the string
=>\&. For example:
.sp
.if n \{\
.RS 4
.\}
.nf
$ \fBpsql testdb\fR
psql (9\&.6\&.24)
Type "help" for help\&.
testdb=>
.fi
.if n \{\
.RE
.\}
.PP
At the prompt, the user can type in
SQL
commands\&. Ordinarily, input lines are sent to the server when a command\-terminating semicolon is reached\&. An end of line does not terminate a command\&. Thus commands can be spread over several lines for clarity\&. If the command was sent and executed without error, the results of the command are displayed on the screen\&.
.PP
If untrusted users have access to a database that has not adopted a
secure schema usage pattern, begin your session by removing publicly\-writable schemas from
\fIsearch_path\fR\&. One can add
options=\-csearch_path=
to the connection string or issue
SELECT pg_catalog\&.set_config(\*(Aqsearch_path\*(Aq, \*(Aq\*(Aq, false)
before other SQL commands\&. This consideration is not specific to
psql; it applies to every interface for executing arbitrary SQL commands\&.
.PP
Whenever a command is executed,
psql
also polls for asynchronous notification events generated by
\fBLISTEN\fR(7)
and
\fBNOTIFY\fR(7)\&.
.PP
While C\-style block comments are passed to the server for processing and removal, SQL\-standard comments are removed by
psql\&.
.SS "Meta\-Commands"
.PP
Anything you enter in
psql
that begins with an unquoted backslash is a
psql
meta\-command that is processed by
psql
itself\&. These commands make
psql
more useful for administration or scripting\&. Meta\-commands are often called slash or backslash commands\&.
.PP
The format of a
psql
command is the backslash, followed immediately by a command verb, then any arguments\&. The arguments are separated from the command verb and each other by any number of whitespace characters\&.
.PP
To include whitespace in an argument you can quote it with single quotes\&. To include a single quote in an argument, write two single quotes within single\-quoted text\&. Anything contained in single quotes is furthermore subject to C\-like substitutions for
\en
(new line),
\et
(tab),
\eb
(backspace),
\er
(carriage return),
\ef
(form feed),
\e\fIdigits\fR
(octal), and
\ex\fIdigits\fR
(hexadecimal)\&. A backslash preceding any other character within single\-quoted text quotes that single character, whatever it is\&.
.PP
Within an argument, text that is enclosed in backquotes (`) is taken as a command line that is passed to the shell\&. The output of the command (with any trailing newline removed) replaces the backquoted text\&.
.PP
If an unquoted colon (:) followed by a
psql
variable name appears within an argument, it is replaced by the variable\*(Aqs value, as described in
SQL Interpolation\&.
.PP
Some commands take an
SQL
identifier (such as a table name) as argument\&. These arguments follow the syntax rules of
SQL: Unquoted letters are forced to lowercase, while double quotes (") protect letters from case conversion and allow incorporation of whitespace into the identifier\&. Within double quotes, paired double quotes reduce to a single double quote in the resulting name\&. For example,
FOO"BAR"BAZ
is interpreted as
fooBARbaz, and
"A weird"" name"
becomes
A weird" name\&.
.PP
Parsing for arguments stops at the end of the line, or when another unquoted backslash is found\&. An unquoted backslash is taken as the beginning of a new meta\-command\&. The special sequence
\e\e
(two backslashes) marks the end of arguments and continues parsing
SQL
commands, if any\&. That way
SQL
and
psql
commands can be freely mixed on a line\&. But in any case, the arguments of a meta\-command cannot continue beyond the end of the line\&.
.PP
The following meta\-commands are defined:
.PP
\ea
.RS 4
If the current table output format is unaligned, it is switched to aligned\&. If it is not unaligned, it is set to unaligned\&. This command is kept for backwards compatibility\&. See
\fB\epset\fR
for a more general solution\&.
.RE
.PP
\ec or \econnect [ \-reuse\-previous=\fIon|off\fR ] [ \fIdbname\fR [ \fIusername\fR ] [ \fIhost\fR ] [ \fIport\fR ] | \fIconninfo\fR ]
.RS 4
Establishes a new connection to a
PostgreSQL
server\&. The connection parameters to use can be specified either using a positional syntax (one or more of database name, user, host, and port), or using a
\fIconninfo\fR
connection string as detailed in
Section 32.1.1, \(lqConnection Strings\(rq, in the documentation\&. If no arguments are given, a new connection is made using the same parameters as before\&.
.sp
Specifying any of
\fIdbname\fR,
\fIusername\fR,
\fIhost\fR
or
\fIport\fR
as
\-
is equivalent to omitting that parameter\&.
.sp
The new connection can re\-use connection parameters from the previous connection; not only database name, user, host, and port, but other settings such as
\fIsslmode\fR\&. By default, parameters are re\-used in the positional syntax, but not when a
\fIconninfo\fR
string is given\&. Passing a first argument of
\-reuse\-previous=on
or
\-reuse\-previous=off
overrides that default\&. If parameters are re\-used, then any parameter not explicitly specified as a positional parameter or in the
\fIconninfo\fR
string is taken from the existing connection\*(Aqs parameters\&. An exception is that if the
\fIhost\fR
setting is changed from its previous value using the positional syntax, any
\fIhostaddr\fR
setting present in the existing connection\*(Aqs parameters is dropped\&. Also, any password used for the existing connection will be re\-used only if the user, host, and port settings are not changed\&. When the command neither specifies nor reuses a particular parameter, the
libpq
default is used\&.
.sp
If the new connection is successfully made, the previous connection is closed\&. If the connection attempt fails (wrong user name, access denied, etc\&.), the previous connection will be kept if
psql
is in interactive mode\&. But when executing a non\-interactive script, processing will immediately stop with an error\&. This distinction was chosen as a user convenience against typos on the one hand, and a safety mechanism that scripts are not accidentally acting on the wrong database on the other hand\&.
.sp
Examples:
.sp
.if n \{\
.RS 4
.\}
.nf
=> \ec mydb myuser host\&.dom 6432
=> \ec service=foo
=> \ec "host=localhost port=5432 dbname=mydb connect_timeout=10 sslmode=disable"
=> \ec \-reuse\-previous=on sslmode=require \-\- changes only sslmode
=> \ec postgresql://tom@localhost/mydb?application_name=myapp
.fi
.if n \{\
.RE
.\}
.RE
.PP
\eC [ \fItitle\fR ]
.RS 4
Sets the title of any tables being printed as the result of a query or unset any such title\&. This command is equivalent to
\epset title \fItitle\fR\&. (The name of this command derives from
\(lqcaption\(rq, as it was previously only used to set the caption in an
HTML
table\&.)
.RE
.PP
\ecd [ \fIdirectory\fR ]
.RS 4
Changes the current working directory to
\fIdirectory\fR\&. Without argument, changes to the current user\*(Aqs home directory\&.
.if n \{\
.sp
.\}
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBTip\fR
.ps -1
.br
To print your current working directory, use
\e! pwd\&.
.sp .5v
.RE
.RE
.PP
\econninfo
.RS 4
Outputs information about the current database connection\&.
.RE
.PP
\ecopy { \fItable\fR [ ( \fIcolumn_list\fR ) ] | ( \fIquery\fR ) } { from | to } { \fI\*(Aqfilename\*(Aq\fR | program \fI\*(Aqcommand\*(Aq\fR | stdin | stdout | pstdin | pstdout } [ [ with ] ( \fIoption\fR [, \&.\&.\&.] ) ]
.RS 4
Performs a frontend (client) copy\&. This is an operation that runs an
SQL
\fBCOPY\fR(7)
command, but instead of the server reading or writing the specified file,
psql
reads or writes the file and routes the data between the server and the local file system\&. This means that file accessibility and privileges are those of the local user, not the server, and no SQL superuser privileges are required\&.
.sp
When
program
is specified,
\fIcommand\fR
is executed by
psql
and the data passed from or to
\fIcommand\fR
is routed between the server and the client\&. Again, the execution privileges are those of the local user, not the server, and no SQL superuser privileges are required\&.
.sp
For
\ecopy \&.\&.\&. from stdin, data rows are read from the same source that issued the command, continuing until
\e\&.
is read or the stream reaches
EOF\&. This option is useful for populating tables in\-line within a SQL script file\&. For
\ecopy \&.\&.\&. to stdout, output is sent to the same place as
psql
command output, and the
COPY \fIcount\fR
command status is not printed (since it might be confused with a data row)\&. To read/write
psql\*(Aqs standard input or output regardless of the current command source or
\eo
option, write
from pstdin
or
to pstdout\&.
.sp
The syntax of this command is similar to that of the
SQL
\fBCOPY\fR(7)
command\&. All options other than the data source/destination are as specified for
\fBCOPY\fR(7)\&. Because of this, special parsing rules apply to the
\fB\ecopy\fR
command\&. In particular,
psql\*(Aqs variable substitution rules and backslash escapes do not apply\&.
.if n \{\
.sp
.\}
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBTip\fR
.ps -1
.br
Another way to obtain the same result as
\ecopy \&.\&.\&. to
is to use the
SQL
COPY \&.\&.\&. TO STDOUT
command and terminate it with
\eg \fIfilename\fR
or
\eg |\fIprogram\fR\&. Unlike
\ecopy, this method allows the command to span multiple lines; also, variable interpolation and backquote expansion can be used\&.
.sp .5v
.RE
.if n \{\
.sp
.\}
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBTip\fR
.ps -1
.br
These operations are not as efficient as the
SQL
\fBCOPY\fR
command with a file or program data source or destination, because all data must pass through the client/server connection\&. For large amounts of data the
SQL
command might be preferable\&.
.sp .5v
.RE
.RE
.PP
\ecopyright
.RS 4
Shows the copyright and distribution terms of
PostgreSQL\&.
.RE
.PP
\ecrosstabview [ \fIcolV\fR [ \fIcolH\fR [ \fIcolD\fR [ \fIsortcolH\fR ] ] ] ]
.RS 4
Executes the current query buffer (like
\eg) and shows the results in a crosstab grid\&. The query must return at least three columns\&. The output column identified by
\fIcolV\fR
becomes a vertical header and the output column identified by
\fIcolH\fR
becomes a horizontal header\&.
\fIcolD\fR
identifies the output column to display within the grid\&.
\fIsortcolH\fR
identifies an optional sort column for the horizontal header\&.
.sp
Each column specification can be a column number (starting at 1) or a column name\&. The usual SQL case folding and quoting rules apply to column names\&. If omitted,
\fIcolV\fR
is taken as column 1 and
\fIcolH\fR
as column 2\&.
\fIcolH\fR
must differ from
\fIcolV\fR\&. If
\fIcolD\fR
is not specified, then there must be exactly three columns in the query result, and the column that is neither
\fIcolV\fR
nor
\fIcolH\fR
is taken to be
\fIcolD\fR\&.
.sp
The vertical header, displayed as the leftmost column, contains the values found in column
\fIcolV\fR, in the same order as in the query results, but with duplicates removed\&.
.sp
The horizontal header, displayed as the first row, contains the values found in column
\fIcolH\fR, with duplicates removed\&. By default, these appear in the same order as in the query results\&. But if the optional
\fIsortcolH\fR
argument is given, it identifies a column whose values must be integer numbers, and the values from
\fIcolH\fR
will appear in the horizontal header sorted according to the corresponding
\fIsortcolH\fR
values\&.
.sp
Inside the crosstab grid, for each distinct value
x
of
\fIcolH\fR
and each distinct value
y
of
\fIcolV\fR, the cell located at the intersection
(x,y)
contains the value of the
colD
column in the query result row for which the value of
\fIcolH\fR
is
x
and the value of
\fIcolV\fR
is
y\&. If there is no such row, the cell is empty\&. If there are multiple such rows, an error is reported\&.
.RE
.PP
\ed[S+] [ \fIpattern\fR ]
.RS 4
For each relation (table, view, materialized view, index, sequence, or foreign table) or composite type matching the
\fIpattern\fR, show all columns, their types, the tablespace (if not the default) and any special attributes such as
NOT NULL
or defaults\&. Associated indexes, constraints, rules, and triggers are also shown\&. For foreign tables, the associated foreign server is shown as well\&. (\(lqMatching the pattern\(rq
is defined in
Patterns
below\&.)
.sp
For some types of relation,
\ed
shows additional information for each column: column values for sequences, indexed expressions for indexes, and foreign data wrapper options for foreign tables\&.
.sp
The command form
\ed+
is identical, except that more information is displayed: any comments associated with the columns of the table are shown, as is the presence of OIDs in the table, the view definition if the relation is a view, a non\-default
replica identity
setting\&.
.sp
By default, only user\-created objects are shown; supply a pattern or the
S
modifier to include system objects\&.
.if n \{\
.sp
.\}
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBNote\fR
.ps -1
.br
If
\fB\ed\fR
is used without a
\fIpattern\fR
argument, it is equivalent to
\fB\edtvmsE\fR
which will show a list of all visible tables, views, materialized views, sequences and foreign tables\&. This is purely a convenience measure\&.
.sp .5v
.RE
.RE
.PP
\eda[S] [ \fIpattern\fR ]
.RS 4
Lists aggregate functions, together with their return type and the data types they operate on\&. If
\fIpattern\fR
is specified, only aggregates whose names match the pattern are shown\&. By default, only user\-created objects are shown; supply a pattern or the
S
modifier to include system objects\&.
.RE
.PP
\edA[+] [ \fIpattern\fR ]
.RS 4
Lists access methods\&. If
\fIpattern\fR
is specified, only access methods whose names match the pattern are shown\&. If
+
is appended to the command name, each access method is listed with its associated handler function and description\&.
.RE
.PP
\edb[+] [ \fIpattern\fR ]
.RS 4
Lists tablespaces\&. If
\fIpattern\fR
is specified, only tablespaces whose names match the pattern are shown\&. If
+
is appended to the command name, each tablespace is listed with its associated options, on\-disk size, permissions and description\&.
.RE
.PP
\edc[S+] [ \fIpattern\fR ]
.RS 4
Lists conversions between character\-set encodings\&. If
\fIpattern\fR
is specified, only conversions whose names match the pattern are listed\&. By default, only user\-created objects are shown; supply a pattern or the
S
modifier to include system objects\&. If
+
is appended to the command name, each object is listed with its associated description\&.
.RE
.PP
\edC[+] [ \fIpattern\fR ]
.RS 4
Lists type casts\&. If
\fIpattern\fR
is specified, only casts whose source or target types match the pattern are listed\&. If
+
is appended to the command name, each object is listed with its associated description\&.
.RE
.PP
\edd[S] [ \fIpattern\fR ]
.RS 4
Shows the descriptions of objects of type
constraint,
operator class,
operator family,
rule, and
trigger\&. All other comments may be viewed by the respective backslash commands for those object types\&.
.sp
\edd
displays descriptions for objects matching the
\fIpattern\fR, or of visible objects of the appropriate type if no argument is given\&. But in either case, only objects that have a description are listed\&. By default, only user\-created objects are shown; supply a pattern or the
S
modifier to include system objects\&.
.sp
Descriptions for objects can be created with the
\fBCOMMENT\fR(7)
SQL
command\&.
.RE
.PP
\eddp [ \fIpattern\fR ]
.RS 4
Lists default access privilege settings\&. An entry is shown for each role (and schema, if applicable) for which the default privilege settings have been changed from the built\-in defaults\&. If
\fIpattern\fR
is specified, only entries whose role name or schema name matches the pattern are listed\&.
.sp
The
ALTER DEFAULT PRIVILEGES (\fBALTER_DEFAULT_PRIVILEGES\fR(7))
command is used to set default access privileges\&. The meaning of the privilege display is explained under
\fBGRANT\fR(7)\&.
.RE
.PP
\edD[S+] [ \fIpattern\fR ]
.RS 4
Lists domains\&. If
\fIpattern\fR
is specified, only domains whose names match the pattern are shown\&. By default, only user\-created objects are shown; supply a pattern or the
S
modifier to include system objects\&. If
+
is appended to the command name, each object is listed with its associated permissions and description\&.
.RE
.PP
\edE[S+] [ \fIpattern\fR ]
.br
\edi[S+] [ \fIpattern\fR ]
.br
\edm[S+] [ \fIpattern\fR ]
.br
\eds[S+] [ \fIpattern\fR ]
.br
\edt[S+] [ \fIpattern\fR ]
.br
\edv[S+] [ \fIpattern\fR ]
.RS 4
In this group of commands, the letters
E,
i,
m,
s,
t, and
v
stand for foreign table, index, materialized view, sequence, table, and view, respectively\&. You can specify any or all of these letters, in any order, to obtain a listing of objects of these types\&. For example,
\edit
lists indexes and tables\&. If
+
is appended to the command name, each object is listed with its physical size on disk and its associated description, if any\&. If
\fIpattern\fR
is specified, only objects whose names match the pattern are listed\&. By default, only user\-created objects are shown; supply a pattern or the
S
modifier to include system objects\&.
.RE
.PP
\edes[+] [ \fIpattern\fR ]
.RS 4
Lists foreign servers (mnemonic:
\(lqexternal servers\(rq)\&. If
\fIpattern\fR
is specified, only those servers whose name matches the pattern are listed\&. If the form
\edes+
is used, a full description of each server is shown, including the server\*(Aqs ACL, type, version, options, and description\&.
.RE
.PP
\edet[+] [ \fIpattern\fR ]
.RS 4
Lists foreign tables (mnemonic:
\(lqexternal tables\(rq)\&. If
\fIpattern\fR
is specified, only entries whose table name or schema name matches the pattern are listed\&. If the form
\edet+
is used, generic options and the foreign table description are also displayed\&.
.RE
.PP
\edeu[+] [ \fIpattern\fR ]
.RS 4
Lists user mappings (mnemonic:
\(lqexternal users\(rq)\&. If
\fIpattern\fR
is specified, only those mappings whose user names match the pattern are listed\&. If the form
\edeu+
is used, additional information about each mapping is shown\&.
.if n \{\
.sp
.\}
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBCaution\fR
.ps -1
.br
\edeu+
might also display the user name and password of the remote user, so care should be taken not to disclose them\&.
.sp .5v
.RE
.RE
.PP
\edew[+] [ \fIpattern\fR ]
.RS 4
Lists foreign\-data wrappers (mnemonic:
\(lqexternal wrappers\(rq)\&. If
\fIpattern\fR
is specified, only those foreign\-data wrappers whose name matches the pattern are listed\&. If the form
\edew+
is used, the ACL, options, and description of the foreign\-data wrapper are also shown\&.
.RE
.PP
\edf[antwS+] [ \fIpattern\fR ]
.RS 4
Lists functions, together with their result data types, argument data types, and function types, which are classified as
\(lqagg\(rq
(aggregate),
\(lqnormal\(rq,
\(lqtrigger\(rq, or
\(lqwindow\(rq\&. To display only functions of specific type(s), add the corresponding letters
a,
n,
t, or
w
to the command\&. If
\fIpattern\fR
is specified, only functions whose names match the pattern are shown\&. By default, only user\-created objects are shown; supply a pattern or the
S
modifier to include system objects\&. If the form
\edf+
is used, additional information about each function is shown, including volatility, parallel safety, owner, security classification, access privileges, language, source code and description\&.
.if n \{\
.sp
.\}
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBTip\fR
.ps -1
.br
To look up functions taking arguments or returning values of a specific data type, use your pager\*(Aqs search capability to scroll through the
\edf
output\&.
.sp .5v
.RE
.RE
.PP
\edF[+] [ \fIpattern\fR ]
.RS 4
Lists text search configurations\&. If
\fIpattern\fR
is specified, only configurations whose names match the pattern are shown\&. If the form
\edF+
is used, a full description of each configuration is shown, including the underlying text search parser and the dictionary list for each parser token type\&.
.RE
.PP
\edFd[+] [ \fIpattern\fR ]
.RS 4
Lists text search dictionaries\&. If
\fIpattern\fR
is specified, only dictionaries whose names match the pattern are shown\&. If the form
\edFd+
is used, additional information is shown about each selected dictionary, including the underlying text search template and the option values\&.
.RE
.PP
\edFp[+] [ \fIpattern\fR ]
.RS 4
Lists text search parsers\&. If
\fIpattern\fR
is specified, only parsers whose names match the pattern are shown\&. If the form
\edFp+
is used, a full description of each parser is shown, including the underlying functions and the list of recognized token types\&.
.RE
.PP
\edFt[+] [ \fIpattern\fR ]
.RS 4
Lists text search templates\&. If
\fIpattern\fR
is specified, only templates whose names match the pattern are shown\&. If the form
\edFt+
is used, additional information is shown about each template, including the underlying function names\&.
.RE
.PP
\edg[S+] [ \fIpattern\fR ]
.RS 4
Lists database roles\&. (Since the concepts of
\(lqusers\(rq
and
\(lqgroups\(rq
have been unified into
\(lqroles\(rq, this command is now equivalent to
\edu\&.) By default, only user\-created roles are shown; supply the
S
modifier to include system roles\&. If
\fIpattern\fR
is specified, only those roles whose names match the pattern are listed\&. If the form
\edg+
is used, additional information is shown about each role; currently this adds the comment for each role\&.
.RE
.PP
\edl
.RS 4
This is an alias for
\fB\elo_list\fR, which shows a list of large objects\&.
.RE
.PP
\edL[S+] [ \fIpattern\fR ]
.RS 4
Lists procedural languages\&. If
\fIpattern\fR
is specified, only languages whose names match the pattern are listed\&. By default, only user\-created languages are shown; supply the
S
modifier to include system objects\&. If
+
is appended to the command name, each language is listed with its call handler, validator, access privileges, and whether it is a system object\&.
.RE
.PP
\edn[S+] [ \fIpattern\fR ]
.RS 4
Lists schemas (namespaces)\&. If
\fIpattern\fR
is specified, only schemas whose names match the pattern are listed\&. By default, only user\-created objects are shown; supply a pattern or the
S
modifier to include system objects\&. If
+
is appended to the command name, each object is listed with its associated permissions and description, if any\&.
.RE
.PP
\edo[S+] [ \fIpattern\fR ]
.RS 4
Lists operators with their operand and result types\&. If
\fIpattern\fR
is specified, only operators whose names match the pattern are listed\&. By default, only user\-created objects are shown; supply a pattern or the
S
modifier to include system objects\&. If
+
is appended to the command name, additional information about each operator is shown, currently just the name of the underlying function\&.
.RE
.PP
\edO[S+] [ \fIpattern\fR ]
.RS 4
Lists collations\&. If
\fIpattern\fR
is specified, only collations whose names match the pattern are listed\&. By default, only user\-created objects are shown; supply a pattern or the
S
modifier to include system objects\&. If
+
is appended to the command name, each collation is listed with its associated description, if any\&. Note that only collations usable with the current database\*(Aqs encoding are shown, so the results may vary in different databases of the same installation\&.
.RE
.PP
\edp [ \fIpattern\fR ]
.RS 4
Lists tables, views and sequences with their associated access privileges\&. If
\fIpattern\fR
is specified, only tables, views and sequences whose names match the pattern are listed\&.
.sp
The
\fBGRANT\fR(7)
and
\fBREVOKE\fR(7)
commands are used to set access privileges\&. The meaning of the privilege display is explained under
\fBGRANT\fR(7)\&.
.RE
.PP
\edrds [ \fIrole\-pattern\fR [ \fIdatabase\-pattern\fR ] ]
.RS 4
Lists defined configuration settings\&. These settings can be role\-specific, database\-specific, or both\&.
\fIrole\-pattern\fR
and
\fIdatabase\-pattern\fR
are used to select specific roles and databases to list, respectively\&. If omitted, or if
*
is specified, all settings are listed, including those not role\-specific or database\-specific, respectively\&.
.sp
The
ALTER ROLE (\fBALTER_ROLE\fR(7))
and
ALTER DATABASE (\fBALTER_DATABASE\fR(7))
commands are used to define per\-role and per\-database configuration settings\&.
.RE
.PP
\edT[S+] [ \fIpattern\fR ]
.RS 4
Lists data types\&. If
\fIpattern\fR
is specified, only types whose names match the pattern are listed\&. If
+
is appended to the command name, each type is listed with its internal name and size, its allowed values if it is an
enum
type, and its associated permissions\&. By default, only user\-created objects are shown; supply a pattern or the
S
modifier to include system objects\&.
.RE
.PP
\edu[S+] [ \fIpattern\fR ]
.RS 4
Lists database roles\&. (Since the concepts of
\(lqusers\(rq
and
\(lqgroups\(rq
have been unified into
\(lqroles\(rq, this command is now equivalent to
\edg\&.) By default, only user\-created roles are shown; supply the
S
modifier to include system roles\&. If
\fIpattern\fR
is specified, only those roles whose names match the pattern are listed\&. If the form
\edu+
is used, additional information is shown about each role; currently this adds the comment for each role\&.
.RE
.PP
\edx[+] [ \fIpattern\fR ]
.RS 4
Lists installed extensions\&. If
\fIpattern\fR
is specified, only those extensions whose names match the pattern are listed\&. If the form
\edx+
is used, all the objects belonging to each matching extension are listed\&.
.RE
.PP
\edy[+] [ \fIpattern\fR ]
.RS 4
Lists event triggers\&. If
\fIpattern\fR
is specified, only those event triggers whose names match the pattern are listed\&. If
+
is appended to the command name, each object is listed with its associated description\&.
.RE
.PP
\ee or \eedit [ \fIfilename\fR ] [ \fIline_number\fR ]
.RS 4
If
\fIfilename\fR
is specified, the file is edited; after the editor exits, its content is copied back to the query buffer\&. If no
\fIfilename\fR
is given, the current query buffer is copied to a temporary file which is then edited in the same fashion\&.
.sp
The new query buffer is then re\-parsed according to the normal rules of
psql, where the whole buffer is treated as a single line\&. (Thus you cannot make scripts this way\&. Use
\fB\ei\fR
for that\&.) This means that if the query ends with (or contains) a semicolon, it is immediately executed\&. Otherwise it will merely wait in the query buffer; type semicolon or
\eg
to send it, or
\er
to cancel\&.
.sp
If a line number is specified,
psql
will position the cursor on the specified line of the file or query buffer\&. Note that if a single all\-digits argument is given,
psql
assumes it is a line number, not a file name\&.
.if n \{\
.sp
.\}
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBTip\fR
.ps -1
.br
See under
ENVIRONMENT
for how to configure and customize your editor\&.
.sp .5v
.RE
.RE
.PP
\eecho \fItext\fR [ \&.\&.\&. ]
.RS 4
Prints the arguments to the standard output, separated by one space and followed by a newline\&. This can be useful to intersperse information in the output of scripts\&. For example:
.sp
.if n \{\
.RS 4
.\}
.nf
=> \fB\eecho `date`\fR
Tue Oct 26 21:40:57 CEST 1999
.fi
.if n \{\
.RE
.\}
.sp
If the first argument is an unquoted
\-n
the trailing newline is not written\&.
.if n \{\
.sp
.\}
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBTip\fR
.ps -1
.br
If you use the
\fB\eo\fR
command to redirect your query output you might wish to use
\fB\eqecho\fR
instead of this command\&.
.sp .5v
.RE
.RE
.PP
\eef [ \fIfunction_description\fR [ \fIline_number\fR ] ]
.RS 4
This command fetches and edits the definition of the named function, in the form of a
\fBCREATE OR REPLACE FUNCTION\fR
command\&. Editing is done in the same way as for
\eedit\&. After the editor exits, the updated command waits in the query buffer; type semicolon or
\eg
to send it, or
\er
to cancel\&.
.sp
The target function can be specified by name alone, or by name and arguments, for example
foo(integer, text)\&. The argument types must be given if there is more than one function of the same name\&.
.sp
If no function is specified, a blank
\fBCREATE FUNCTION\fR
template is presented for editing\&.
.sp
If a line number is specified,
psql
will position the cursor on the specified line of the function body\&. (Note that the function body typically does not begin on the first line of the file\&.)
.if n \{\
.sp
.\}
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBTip\fR
.ps -1
.br
See under
ENVIRONMENT
for how to configure and customize your editor\&.
.sp .5v
.RE
.RE
.PP
\eencoding [ \fIencoding\fR ]
.RS 4
Sets the client character set encoding\&. Without an argument, this command shows the current encoding\&.
.RE
.PP
\eerrverbose
.RS 4
Repeats the most recent server error message at maximum verbosity, as though
\fIVERBOSITY\fR
were set to
verbose
and
\fISHOW_CONTEXT\fR
were set to
always\&.
.RE
.PP
\eev [ \fIview_name\fR [ \fIline_number\fR ] ]
.RS 4
This command fetches and edits the definition of the named view, in the form of a
\fBCREATE OR REPLACE VIEW\fR
command\&. Editing is done in the same way as for
\eedit\&. After the editor exits, the updated command waits in the query buffer; type semicolon or
\eg
to send it, or
\er
to cancel\&.
.sp
If no view is specified, a blank
\fBCREATE VIEW\fR
template is presented for editing\&.
.sp
If a line number is specified,
psql
will position the cursor on the specified line of the view definition\&.
.RE
.PP
\ef [ \fIstring\fR ]
.RS 4
Sets the field separator for unaligned query output\&. The default is the vertical bar (|)\&. See also
\fB\epset\fR
for a generic way of setting output options\&.
.RE
.PP
\eg [ \fIfilename\fR ]
.br
\eg [ |\fIcommand\fR ]
.RS 4
Sends the current query input buffer to the server, and optionally stores the query\*(Aqs output in
\fIfilename\fR
or pipes the output to the shell command
\fIcommand\fR\&. The file or command is written to only if the query successfully returns zero or more tuples, not if the query fails or is a non\-data\-returning SQL command\&.
.sp
A bare
\eg
is essentially equivalent to a semicolon\&. A
\eg
with argument is a
\(lqone\-shot\(rq
alternative to the
\fB\eo\fR
command\&.
.RE
.PP
\egexec
.RS 4
Sends the current query input buffer to the server, then treats each column of each row of the query\*(Aqs output (if any) as a SQL statement to be executed\&. For example, to create an index on each column of
my_table:
.sp
.if n \{\
.RS 4
.\}
.nf
=> \fBSELECT format(\*(Aqcreate index on my_table(%I)\*(Aq, attname)\fR
\-> \fBFROM pg_attribute\fR
\-> \fBWHERE attrelid = \*(Aqmy_table\*(Aq::regclass AND attnum > 0\fR
\-> \fBORDER BY attnum\fR
\-> \fB\egexec\fR
CREATE INDEX
CREATE INDEX
CREATE INDEX
CREATE INDEX
.fi
.if n \{\
.RE
.\}
.sp
The generated queries are executed in the order in which the rows are returned, and left\-to\-right within each row if there is more than one column\&. NULL fields are ignored\&. The generated queries are sent literally to the server for processing, so they cannot be
psql
meta\-commands nor contain
psql
variable references\&. If any individual query fails, execution of the remaining queries continues unless
\fION_ERROR_STOP\fR
is set\&. Execution of each query is subject to
\fIECHO\fR
processing\&. (Setting
\fIECHO\fR
to
all
or
queries
is often advisable when using
\fB\egexec\fR\&.) Query logging, single\-step mode, timing, and other query execution features apply to each generated query as well\&.
.RE
.PP
\egset [ \fIprefix\fR ]
.RS 4
Sends the current query input buffer to the server and stores the query\*(Aqs output into
psql
variables (see
Variables)\&. The query to be executed must return exactly one row\&. Each column of the row is stored into a separate variable, named the same as the column\&. For example:
.sp
.if n \{\
.RS 4
.\}
.nf
=> \fBSELECT \*(Aqhello\*(Aq AS var1, 10 AS var2\fR
\-> \fB\egset\fR
=> \fB\eecho :var1 :var2\fR
hello 10
.fi
.if n \{\
.RE
.\}
.sp
If you specify a
\fIprefix\fR, that string is prepended to the query\*(Aqs column names to create the variable names to use:
.sp
.if n \{\
.RS 4
.\}
.nf
=> \fBSELECT \*(Aqhello\*(Aq AS var1, 10 AS var2\fR
\-> \fB\egset result_\fR
=> \fB\eecho :result_var1 :result_var2\fR
hello 10
.fi
.if n \{\
.RE
.\}
.sp
If a column result is NULL, the corresponding variable is unset rather than being set\&.
.sp
If the query fails or does not return one row, no variables are changed\&.
.RE
.PP
\eh or \ehelp [ \fIcommand\fR ]
.RS 4
Gives syntax help on the specified
SQL
command\&. If
\fIcommand\fR
is not specified, then
psql
will list all the commands for which syntax help is available\&. If
\fIcommand\fR
is an asterisk (*), then syntax help on all
SQL
commands is shown\&.
.if n \{\
.sp
.\}
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBNote\fR
.ps -1
.br
To simplify typing, commands that consists of several words do not have to be quoted\&. Thus it is fine to type
\fB\ehelp alter table\fR\&.
.sp .5v
.RE
.RE
.PP
\eH or \ehtml
.RS 4
Turns on
HTML
query output format\&. If the
HTML
format is already on, it is switched back to the default aligned text format\&. This command is for compatibility and convenience, but see
\fB\epset\fR
about setting other output options\&.
.RE
.PP
\ei or \einclude \fIfilename\fR
.RS 4
Reads input from the file
\fIfilename\fR
and executes it as though it had been typed on the keyboard\&.
.sp
If
\fIfilename\fR
is
\-
(hyphen), then standard input is read until an EOF indication or
\fB\eq\fR
meta\-command\&. This can be used to intersperse interactive input with input from files\&. Note that Readline behavior will be used only if it is active at the outermost level\&.
.if n \{\
.sp
.\}
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBNote\fR
.ps -1
.br
If you want to see the lines on the screen as they are read you must set the variable
\fIECHO\fR
to
all\&.
.sp .5v
.RE
.RE
.PP
\eir or \einclude_relative \fIfilename\fR
.RS 4
The
\eir
command is similar to
\ei, but resolves relative file names differently\&. When executing in interactive mode, the two commands behave identically\&. However, when invoked from a script,
\eir
interprets file names relative to the directory in which the script is located, rather than the current working directory\&.
.RE
.PP
\el[+] or \elist[+] [ \fIpattern\fR ]
.RS 4
List the databases in the server and show their names, owners, character set encodings, and access privileges\&. If
\fIpattern\fR
is specified, only databases whose names match the pattern are listed\&. If
+
is appended to the command name, database sizes, default tablespaces, and descriptions are also displayed\&. (Size information is only available for databases that the current user can connect to\&.)
.RE
.PP
\elo_export \fIloid\fR \fIfilename\fR
.RS 4
Reads the large object with
OID
\fIloid\fR
from the database and writes it to
\fIfilename\fR\&. Note that this is subtly different from the server function
\fBlo_export\fR, which acts with the permissions of the user that the database server runs as and on the server\*(Aqs file system\&.
.if n \{\
.sp
.\}
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBTip\fR
.ps -1
.br
Use
\fB\elo_list\fR
to find out the large object\*(Aqs
OID\&.
.sp .5v
.RE
.RE
.PP
\elo_import \fIfilename\fR [ \fIcomment\fR ]
.RS 4
Stores the file into a
PostgreSQL
large object\&. Optionally, it associates the given comment with the object\&. Example:
.sp
.if n \{\
.RS 4
.\}
.nf
foo=> \fB\elo_import \*(Aq/home/peter/pictures/photo\&.xcf\*(Aq \*(Aqa picture of me\*(Aq\fR
lo_import 152801
.fi
.if n \{\
.RE
.\}
.sp
The response indicates that the large object received object ID 152801, which can be used to access the newly\-created large object in the future\&. For the sake of readability, it is recommended to always associate a human\-readable comment with every object\&. Both OIDs and comments can be viewed with the
\fB\elo_list\fR
command\&.
.sp
Note that this command is subtly different from the server\-side
\fBlo_import\fR
because it acts as the local user on the local file system, rather than the server\*(Aqs user and file system\&.
.RE
.PP
\elo_list
.RS 4
Shows a list of all
PostgreSQL
large objects currently stored in the database, along with any comments provided for them\&.
.RE
.PP
\elo_unlink \fIloid\fR
.RS 4
Deletes the large object with
OID
\fIloid\fR
from the database\&.
.if n \{\
.sp
.\}
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBTip\fR
.ps -1
.br
Use
\fB\elo_list\fR
to find out the large object\*(Aqs
OID\&.
.sp .5v
.RE
.RE
.PP
\eo or \eout [ \fIfilename\fR ]
.br
\eo or \eout [ |\fIcommand\fR ]
.RS 4
Arranges to save future query results to the file
\fIfilename\fR
or pipe future results to the shell command
\fIcommand\fR\&. If no argument is specified, the query output is reset to the standard output\&.
.sp
\(lqQuery results\(rq
includes all tables, command responses, and notices obtained from the database server, as well as output of various backslash commands that query the database (such as
\fB\ed\fR), but not error messages\&.
.if n \{\
.sp
.\}
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBTip\fR
.ps -1
.br
To intersperse text output in between query results, use
\fB\eqecho\fR\&.
.sp .5v
.RE
.RE
.PP
\ep or \eprint
.RS 4
Print the current query buffer to the standard output\&.
.RE
.PP
\epassword [ \fIusername\fR ]
.RS 4
Changes the password of the specified user (by default, the current user)\&. This command prompts for the new password, encrypts it, and sends it to the server as an
\fBALTER ROLE\fR
command\&. This makes sure that the new password does not appear in cleartext in the command history, the server log, or elsewhere\&.
.RE
.PP
\eprompt [ \fItext\fR ] \fIname\fR
.RS 4
Prompts the user to supply text, which is assigned to the variable
\fIname\fR\&. An optional prompt string,
\fItext\fR, can be specified\&. (For multiword prompts, surround the text with single quotes\&.)
.sp
By default,
\eprompt
uses the terminal for input and output\&. However, if the
\fB\-f\fR
command line switch was used,
\eprompt
uses standard input and standard output\&.
.RE
.PP
\epset [ \fIoption\fR [ \fIvalue\fR ] ]
.RS 4
This command sets options affecting the output of query result tables\&.
\fIoption\fR
indicates which option is to be set\&. The semantics of
\fIvalue\fR
vary depending on the selected option\&. For some options, omitting
\fIvalue\fR
causes the option to be toggled or unset, as described under the particular option\&. If no such behavior is mentioned, then omitting
\fIvalue\fR
just results in the current setting being displayed\&.
.sp
\fB\epset\fR
without any arguments displays the current status of all printing options\&.
.sp
Adjustable printing options are:
.PP
border
.RS 4
The
\fIvalue\fR
must be a number\&. In general, the higher the number the more borders and lines the tables will have, but details depend on the particular format\&. In
HTML
format, this will translate directly into the
border=\&.\&.\&.
attribute\&. In most other formats only values 0 (no border), 1 (internal dividing lines), and 2 (table frame) make sense, and values above 2 will be treated the same as
border = 2\&. The
latex
and
latex\-longtable
formats additionally allow a value of 3 to add dividing lines between data rows\&.
.RE
.PP
columns
.RS 4
Sets the target width for the
wrapped
format, and also the width limit for determining whether output is wide enough to require the pager or switch to the vertical display in expanded auto mode\&. Zero (the default) causes the target width to be controlled by the environment variable
\fBCOLUMNS\fR, or the detected screen width if
\fBCOLUMNS\fR
is not set\&. In addition, if
columns
is zero then the
wrapped
format only affects screen output\&. If
columns
is nonzero then file and pipe output is wrapped to that width as well\&.
.RE
.PP
expanded (or x)
.RS 4
If
\fIvalue\fR
is specified it must be either
on
or
off, which will enable or disable expanded mode, or
auto\&. If
\fIvalue\fR
is omitted the command toggles between the on and off settings\&. When expanded mode is enabled, query results are displayed in two columns, with the column name on the left and the data on the right\&. This mode is useful if the data wouldn\*(Aqt fit on the screen in the normal
\(lqhorizontal\(rq
mode\&. In the auto setting, the expanded mode is used whenever the query output has more than one column and is wider than the screen; otherwise, the regular mode is used\&. The auto setting is only effective in the aligned and wrapped formats\&. In other formats, it always behaves as if the expanded mode is off\&.
.RE
.PP
fieldsep
.RS 4
Specifies the field separator to be used in unaligned output format\&. That way one can create, for example, tab\- or comma\-separated output, which other programs might prefer\&. To set a tab as field separator, type
\epset fieldsep \*(Aq\et\*(Aq\&. The default field separator is
\*(Aq|\*(Aq
(a vertical bar)\&.
.RE
.PP
fieldsep_zero
.RS 4
Sets the field separator to use in unaligned output format to a zero byte\&.
.RE
.PP
footer
.RS 4
If
\fIvalue\fR
is specified it must be either
on
or
off
which will enable or disable display of the table footer (the
(\fIn\fR rows)
count)\&. If
\fIvalue\fR
is omitted the command toggles footer display on or off\&.
.RE
.PP
format
.RS 4
Sets the output format to one of
unaligned,
aligned,
wrapped,
html,
asciidoc,
latex
(uses
tabular),
latex\-longtable, or
troff\-ms\&. Unique abbreviations are allowed\&.
.sp
unaligned
format writes all columns of a row on one line, separated by the currently active field separator\&. This is useful for creating output that might be intended to be read in by other programs (for example, tab\-separated or comma\-separated format)\&.
.sp
aligned
format is the standard, human\-readable, nicely formatted text output; this is the default\&.
.sp
wrapped
format is like
aligned
but wraps wide data values across lines to make the output fit in the target column width\&. The target width is determined as described under the
columns
option\&. Note that
psql
will not attempt to wrap column header titles; therefore,
wrapped
format behaves the same as
aligned
if the total width needed for column headers exceeds the target\&.
.sp
The
html,
asciidoc,
latex,
latex\-longtable, and
troff\-ms
formats put out tables that are intended to be included in documents using the respective mark\-up language\&. They are not complete documents! This might not be necessary in
HTML, but in
LaTeX
you must have a complete document wrapper\&.
latex\-longtable
also requires the
LaTeX
longtable
and
booktabs
packages\&.
.RE
.PP
linestyle
.RS 4
Sets the border line drawing style to one of
ascii,
old\-ascii, or
unicode\&. Unique abbreviations are allowed\&. (That would mean one letter is enough\&.) The default setting is
ascii\&. This option only affects the
aligned
and
wrapped
output formats\&.
.sp
ascii
style uses plain
ASCII
characters\&. Newlines in data are shown using a
+
symbol in the right\-hand margin\&. When the
wrapped
format wraps data from one line to the next without a newline character, a dot (\&.) is shown in the right\-hand margin of the first line, and again in the left\-hand margin of the following line\&.
.sp
old\-ascii
style uses plain
ASCII
characters, using the formatting style used in
PostgreSQL
8\&.4 and earlier\&. Newlines in data are shown using a
:
symbol in place of the left\-hand column separator\&. When the data is wrapped from one line to the next without a newline character, a
;
symbol is used in place of the left\-hand column separator\&.
.sp
unicode
style uses Unicode box\-drawing characters\&. Newlines in data are shown using a carriage return symbol in the right\-hand margin\&. When the data is wrapped from one line to the next without a newline character, an ellipsis symbol is shown in the right\-hand margin of the first line, and again in the left\-hand margin of the following line\&.
.sp
When the
border
setting is greater than zero, the
linestyle
option also determines the characters with which the border lines are drawn\&. Plain
ASCII
characters work everywhere, but Unicode characters look nicer on displays that recognize them\&.
.RE
.PP
null
.RS 4
Sets the string to be printed in place of a null value\&. The default is to print nothing, which can easily be mistaken for an empty string\&. For example, one might prefer
\epset null \*(Aq(null)\*(Aq\&.
.RE
.PP
numericlocale
.RS 4
If
\fIvalue\fR
is specified it must be either
on
or
off
which will enable or disable display of a locale\-specific character to separate groups of digits to the left of the decimal marker\&. If
\fIvalue\fR
is omitted the command toggles between regular and locale\-specific numeric output\&.
.RE
.PP
pager
.RS 4
Controls use of a pager program for query and
psql
help output\&. If the environment variable
\fBPAGER\fR
is set, the output is piped to the specified program\&. Otherwise a platform\-dependent default (such as
more) is used\&.
.sp
When the
pager
option is
off, the pager program is not used\&. When the
pager
option is
on, the pager is used when appropriate, i\&.e\&., when the output is to a terminal and will not fit on the screen\&. The
pager
option can also be set to
always, which causes the pager to be used for all terminal output regardless of whether it fits on the screen\&.
\epset pager
without a
\fIvalue\fR
toggles pager use on and off\&.
.RE
.PP
pager_min_lines
.RS 4
If
pager_min_lines
is set to a number greater than the page height, the pager program will not be called unless there are at least this many lines of output to show\&. The default setting is 0\&.
.RE
.PP
recordsep
.RS 4
Specifies the record (line) separator to use in unaligned output format\&. The default is a newline character\&.
.RE
.PP
recordsep_zero
.RS 4
Sets the record separator to use in unaligned output format to a zero byte\&.
.RE
.PP
tableattr (or T)
.RS 4
In
HTML
format, this specifies attributes to be placed inside the
table
tag\&. This could for example be
cellpadding
or
bgcolor\&. Note that you probably don\*(Aqt want to specify
border
here, as that is already taken care of by
\epset border\&. If no
\fIvalue\fR
is given, the table attributes are unset\&.
.sp
In
latex\-longtable
format, this controls the proportional width of each column containing a left\-aligned data type\&. It is specified as a whitespace\-separated list of values, e\&.g\&.,
\*(Aq0\&.2 0\&.2 0\&.6\*(Aq\&. Unspecified output columns use the last specified value\&.
.RE
.PP
title (or C)
.RS 4
Sets the table title for any subsequently printed tables\&. This can be used to give your output descriptive tags\&. If no
\fIvalue\fR
is given, the title is unset\&.
.RE
.PP
tuples_only (or t)
.RS 4
If
\fIvalue\fR
is specified it must be either
on
or
off
which will enable or disable tuples\-only mode\&. If
\fIvalue\fR
is omitted the command toggles between regular and tuples\-only output\&. Regular output includes extra information such as column headers, titles, and various footers\&. In tuples\-only mode, only actual table data is shown\&.
.RE
.PP
unicode_border_linestyle
.RS 4
Sets the border drawing style for the
unicode
line style to one of
single
or
double\&.
.RE
.PP
unicode_column_linestyle
.RS 4
Sets the column drawing style for the
unicode
line style to one of
single
or
double\&.
.RE
.PP
unicode_header_linestyle
.RS 4
Sets the header drawing style for the
unicode
line style to one of
single
or
double\&.
.RE
.sp
Illustrations of how these different formats look can be seen in the
EXAMPLES
section\&.
.if n \{\
.sp
.\}
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBTip\fR
.ps -1
.br
There are various shortcut commands for
\fB\epset\fR\&. See
\fB\ea\fR,
\fB\eC\fR,
\fB\ef\fR,
\fB\eH\fR,
\fB\et\fR,
\fB\eT\fR, and
\fB\ex\fR\&.
.sp .5v
.RE
.RE
.PP
\eq or \equit
.RS 4
Quits the
psql
program\&. In a script file, only execution of that script is terminated\&.
.RE
.PP
\eqecho \fItext\fR [ \&.\&.\&. ]
.RS 4
This command is identical to
\fB\eecho\fR
except that the output will be written to the query output channel, as set by
\fB\eo\fR\&.
.RE
.PP
\er or \ereset
.RS 4
Resets (clears) the query buffer\&.
.RE
.PP
\es [ \fIfilename\fR ]
.RS 4
Print
psql\*(Aqs command line history to
\fIfilename\fR\&. If
\fIfilename\fR
is omitted, the history is written to the standard output (using the pager if appropriate)\&. This command is not available if
psql
was built without
Readline
support\&.
.RE
.PP
\eset [ \fIname\fR [ \fIvalue\fR [ \&.\&.\&. ] ] ]
.RS 4
Sets the
psql
variable
\fIname\fR
to
\fIvalue\fR, or if more than one value is given, to the concatenation of all of them\&. If only one argument is given, the variable is set with an empty value\&. To unset a variable, use the
\fB\eunset\fR
command\&.
.sp
\fB\eset\fR
without any arguments displays the names and values of all currently\-set
psql
variables\&.
.sp
Valid variable names can contain letters, digits, and underscores\&. See the section
Variables
below for details\&. Variable names are case\-sensitive\&.
.sp
Although you are welcome to set any variable to anything you want,
psql
treats several variables as special\&. They are documented in the section about variables\&.
.if n \{\
.sp
.\}
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBNote\fR
.ps -1
.br
This command is unrelated to the
SQL
command
\fBSET\fR(7)\&.
.sp .5v
.RE
.RE
.PP
\esetenv \fIname\fR [ \fIvalue\fR ]
.RS 4
Sets the environment variable
\fIname\fR
to
\fIvalue\fR, or if the
\fIvalue\fR
is not supplied, unsets the environment variable\&. Example:
.sp
.if n \{\
.RS 4
.\}
.nf
testdb=> \fB\esetenv PAGER less\fR
testdb=> \fB\esetenv LESS \-imx4F\fR
.fi
.if n \{\
.RE
.\}
.RE
.PP
\esf[+] \fIfunction_description\fR
.RS 4
This command fetches and shows the definition of the named function, in the form of a
\fBCREATE OR REPLACE FUNCTION\fR
command\&. The definition is printed to the current query output channel, as set by
\fB\eo\fR\&.
.sp
The target function can be specified by name alone, or by name and arguments, for example
foo(integer, text)\&. The argument types must be given if there is more than one function of the same name\&.
.sp
If
+
is appended to the command name, then the output lines are numbered, with the first line of the function body being line 1\&.
.RE
.PP
\esv[+] \fIview_name\fR
.RS 4
This command fetches and shows the definition of the named view, in the form of a
\fBCREATE OR REPLACE VIEW\fR
command\&. The definition is printed to the current query output channel, as set by
\fB\eo\fR\&.
.sp
If
+
is appended to the command name, then the output lines are numbered from 1\&.
.RE
.PP
\et
.RS 4
Toggles the display of output column name headings and row count footer\&. This command is equivalent to
\epset tuples_only
and is provided for convenience\&.
.RE
.PP
\eT \fItable_options\fR
.RS 4
Specifies attributes to be placed within the
table
tag in
HTML
output format\&. This command is equivalent to
\epset tableattr \fItable_options\fR\&.
.RE
.PP
\etiming [ \fIon\fR | \fIoff\fR ]
.RS 4
Without parameter, toggles a display of how long each SQL statement takes, in milliseconds\&. With parameter, sets same\&.
.RE
.PP
\eunset \fIname\fR
.RS 4
Unsets (deletes) the
psql
variable
\fIname\fR\&.
.RE
.PP
\ew or \ewrite \fIfilename\fR
.br
\ew or \ewrite |\fIcommand\fR
.RS 4
Outputs the current query buffer to the file
\fIfilename\fR
or pipes it to the shell command
\fIcommand\fR\&.
.RE
.PP
\ewatch [ \fIseconds\fR ]
.RS 4
Repeatedly execute the current query buffer (as
\eg
does) until interrupted or the query fails\&. Wait the specified number of seconds (default 2) between executions\&. Each query result is displayed with a header that includes the
\epset title
string (if any), the time as of query start, and the delay interval\&.
.RE
.PP
\ex [ \fIon\fR | \fIoff\fR | \fIauto\fR ]
.RS 4
Sets or toggles expanded table formatting mode\&. As such it is equivalent to
\epset expanded\&.
.RE
.PP
\ez [ \fIpattern\fR ]
.RS 4
Lists tables, views and sequences with their associated access privileges\&. If a
\fIpattern\fR
is specified, only tables, views and sequences whose names match the pattern are listed\&.
.sp
This is an alias for
\fB\edp\fR
(\(lqdisplay privileges\(rq)\&.
.RE
.PP
\e! [ \fIcommand\fR ]
.RS 4
Escapes to a separate shell or executes the shell command
\fIcommand\fR\&. The arguments are not further interpreted; the shell will see them as\-is\&. In particular, the variable substitution rules and backslash escapes do not apply\&.
.RE
.PP
\e? [ \fItopic\fR ]
.RS 4
Shows help information\&. The optional
\fItopic\fR
parameter (defaulting to
commands) selects which part of
psql
is explained:
commands
describes
psql\*(Aqs backslash commands;
options
describes the command\-line options that can be passed to
psql; and
variables
shows help about
psql
configuration variables\&.
.RE
.sp
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBPatterns\fR
.RS 4
.PP
The various
\ed
commands accept a
\fIpattern\fR
parameter to specify the object name(s) to be displayed\&. In the simplest case, a pattern is just the exact name of the object\&. The characters within a pattern are normally folded to lower case, just as in SQL names; for example,
\edt FOO
will display the table named
foo\&. As in SQL names, placing double quotes around a pattern stops folding to lower case\&. Should you need to include an actual double quote character in a pattern, write it as a pair of double quotes within a double\-quote sequence; again this is in accord with the rules for SQL quoted identifiers\&. For example,
\edt "FOO""BAR"
will display the table named
FOO"BAR
(not
foo"bar)\&. Unlike the normal rules for SQL names, you can put double quotes around just part of a pattern, for instance
\edt FOO"FOO"BAR
will display the table named
fooFOObar\&.
.PP
Whenever the
\fIpattern\fR
parameter is omitted completely, the
\ed
commands display all objects that are visible in the current schema search path \(em this is equivalent to using
*
as the pattern\&. (An object is said to be
visible
if its containing schema is in the search path and no object of the same kind and name appears earlier in the search path\&. This is equivalent to the statement that the object can be referenced by name without explicit schema qualification\&.) To see all objects in the database regardless of visibility, use
*\&.*
as the pattern\&.
.PP
Within a pattern,
*
matches any sequence of characters (including no characters) and
?
matches any single character\&. (This notation is comparable to Unix shell file name patterns\&.) For example,
\edt int*
displays tables whose names begin with
int\&. But within double quotes,
*
and
?
lose these special meanings and are just matched literally\&.
.PP
A pattern that contains a dot (\&.) is interpreted as a schema name pattern followed by an object name pattern\&. For example,
\edt foo*\&.*bar*
displays all tables whose table name includes
bar
that are in schemas whose schema name starts with
foo\&. When no dot appears, then the pattern matches only objects that are visible in the current schema search path\&. Again, a dot within double quotes loses its special meaning and is matched literally\&.
.PP
Advanced users can use regular\-expression notations such as character classes, for example
[0\-9]
to match any digit\&. All regular expression special characters work as specified in
Section 9.7.3, \(lqPOSIX Regular Expressions\(rq, in the documentation, except for
\&.
which is taken as a separator as mentioned above,
*
which is translated to the regular\-expression notation
\&.*,
?
which is translated to
\&., and
$
which is matched literally\&. You can emulate these pattern characters at need by writing
?
for
\&.,
(\fIR\fR+|)
for
\fIR\fR*, or
(\fIR\fR|)
for
\fIR\fR?\&.
$
is not needed as a regular\-expression character since the pattern must match the whole name, unlike the usual interpretation of regular expressions (in other words,
$
is automatically appended to your pattern)\&. Write
*
at the beginning and/or end if you don\*(Aqt wish the pattern to be anchored\&. Note that within double quotes, all regular expression special characters lose their special meanings and are matched literally\&. Also, the regular expression special characters are matched literally in operator name patterns (i\&.e\&., the argument of
\edo)\&.
.RE
.SS "Advanced Features"
.sp
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBVariables\fR
.RS 4
.PP
psql
provides variable substitution features similar to common Unix command shells\&. Variables are simply name/value pairs, where the value can be any string of any length\&. The name must consist of letters (including non\-Latin letters), digits, and underscores\&.
.PP
To set a variable, use the
psql
meta\-command
\fB\eset\fR\&. For example,
.sp
.if n \{\
.RS 4
.\}
.nf
testdb=> \fB\eset foo bar\fR
.fi
.if n \{\
.RE
.\}
.sp
sets the variable
foo
to the value
bar\&. To retrieve the content of the variable, precede the name with a colon, for example:
.sp
.if n \{\
.RS 4
.\}
.nf
testdb=> \fB\eecho :foo\fR
bar
.fi
.if n \{\
.RE
.\}
.sp
This works in both regular SQL commands and meta\-commands; there is more detail in
SQL Interpolation, below\&.
.PP
If you call
\fB\eset\fR
without a second argument, the variable is set, with an empty string as value\&. To unset (i\&.e\&., delete) a variable, use the command
\fB\eunset\fR\&. To show the values of all variables, call
\fB\eset\fR
without any argument\&.
.if n \{\
.sp
.\}
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBNote\fR
.ps -1
.br
.PP
The arguments of
\fB\eset\fR
are subject to the same substitution rules as with other commands\&. Thus you can construct interesting references such as
\eset :foo \*(Aqsomething\*(Aq
and get
\(lqsoft links\(rq
or
\(lqvariable variables\(rq
of
Perl
or
PHP
fame, respectively\&. Unfortunately (or fortunately?), there is no way to do anything useful with these constructs\&. On the other hand,
\eset bar :foo
is a perfectly valid way to copy a variable\&.
.sp .5v
.RE
.PP
A number of these variables are treated specially by
psql\&. They represent certain option settings that can be changed at run time by altering the value of the variable, or in some cases represent changeable state of
psql\&. Although you can use these variables for other purposes, this is not recommended, as the program behavior might grow really strange really quickly\&. By convention, all specially treated variables\*(Aq names consist of all upper\-case ASCII letters (and possibly digits and underscores)\&. To ensure maximum compatibility in the future, avoid using such variable names for your own purposes\&. A list of all specially treated variables follows\&.
.PP
\fIAUTOCOMMIT\fR
.RS 4
When
on
(the default), each SQL command is automatically committed upon successful completion\&. To postpone commit in this mode, you must enter a
\fBBEGIN\fR
or
\fBSTART TRANSACTION\fR
SQL command\&. When
off
or unset, SQL commands are not committed until you explicitly issue
\fBCOMMIT\fR
or
\fBEND\fR\&. The autocommit\-off mode works by issuing an implicit
\fBBEGIN\fR
for you, just before any command that is not already in a transaction block and is not itself a
\fBBEGIN\fR
or other transaction\-control command, nor a command that cannot be executed inside a transaction block (such as
\fBVACUUM\fR)\&.
.if n \{\
.sp
.\}
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBNote\fR
.ps -1
.br
In autocommit\-off mode, you must explicitly abandon any failed transaction by entering
\fBABORT\fR
or
\fBROLLBACK\fR\&. Also keep in mind that if you exit the session without committing, your work will be lost\&.
.sp .5v
.RE
.if n \{\
.sp
.\}
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBNote\fR
.ps -1
.br
The autocommit\-on mode is
PostgreSQL\*(Aqs traditional behavior, but autocommit\-off is closer to the SQL spec\&. If you prefer autocommit\-off, you might wish to set it in the system\-wide
psqlrc
file or your
~/\&.psqlrc
file\&.
.sp .5v
.RE
.RE
.PP
\fICOMP_KEYWORD_CASE\fR
.RS 4
Determines which letter case to use when completing an SQL key word\&. If set to
lower
or
upper, the completed word will be in lower or upper case, respectively\&. If set to
preserve\-lower
or
preserve\-upper
(the default), the completed word will be in the case of the word already entered, but words being completed without anything entered will be in lower or upper case, respectively\&.
.RE
.PP
\fIDBNAME\fR
.RS 4
The name of the database you are currently connected to\&. This is set every time you connect to a database (including program start\-up), but can be unset\&.
.RE
.PP
\fIECHO\fR
.RS 4
If set to
all, all nonempty input lines are printed to standard output as they are read\&. (This does not apply to lines read interactively\&.) To select this behavior on program start\-up, use the switch
\fB\-a\fR\&. If set to
queries,
psql
prints each query to standard output as it is sent to the server\&. The switch for this is
\fB\-e\fR\&. If set to
errors, then only failed queries are displayed on standard error output\&. The switch for this is
\fB\-b\fR\&. If unset, or if set to
none
(or any other value than those above) then no queries are displayed\&.
.RE
.PP
\fIECHO_HIDDEN\fR
.RS 4
When this variable is set to
on
and a backslash command queries the database, the query is first shown\&. This feature helps you to study
PostgreSQL
internals and provide similar functionality in your own programs\&. (To select this behavior on program start\-up, use the switch
\fB\-E\fR\&.) If you set the variable to the value
noexec, the queries are just shown but are not actually sent to the server and executed\&.
.RE
.PP
\fIENCODING\fR
.RS 4
The current client character set encoding\&.
.RE
.PP
\fIFETCH_COUNT\fR
.RS 4
If this variable is set to an integer value > 0, the results of
\fBSELECT\fR
queries are fetched and displayed in groups of that many rows, rather than the default behavior of collecting the entire result set before display\&. Therefore only a limited amount of memory is used, regardless of the size of the result set\&. Settings of 100 to 1000 are commonly used when enabling this feature\&. Keep in mind that when using this feature, a query might fail after having already displayed some rows\&.
.if n \{\
.sp
.\}
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBTip\fR
.ps -1
.br
Although you can use any output format with this feature, the default
aligned
format tends to look bad because each group of
\fIFETCH_COUNT\fR
rows will be formatted separately, leading to varying column widths across the row groups\&. The other output formats work better\&.
.sp .5v
.RE
.RE
.PP
\fIHISTCONTROL\fR
.RS 4
If this variable is set to
ignorespace, lines which begin with a space are not entered into the history list\&. If set to a value of
ignoredups, lines matching the previous history line are not entered\&. A value of
ignoreboth
combines the two options\&. If unset, or if set to
none
(or any other value than those above), all lines read in interactive mode are saved on the history list\&.
.if n \{\
.sp
.\}
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBNote\fR
.ps -1
.br
This feature was shamelessly plagiarized from
Bash\&.
.sp .5v
.RE
.RE
.PP
\fIHISTFILE\fR
.RS 4
The file name that will be used to store the history list\&. The default value is
~/\&.psql_history\&. For example, putting:
.sp
.if n \{\
.RS 4
.\}
.nf
\eset HISTFILE ~/\&.psql_history\- :DBNAME
.fi
.if n \{\
.RE
.\}
.sp
in
~/\&.psqlrc
will cause
psql
to maintain a separate history for each database\&.
.if n \{\
.sp
.\}
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBNote\fR
.ps -1
.br
This feature was shamelessly plagiarized from
Bash\&.
.sp .5v
.RE
.RE
.PP
\fIHISTSIZE\fR
.RS 4
The number of commands to store in the command history\&. The default value is 500\&.
.if n \{\
.sp
.\}
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBNote\fR
.ps -1
.br
This feature was shamelessly plagiarized from
Bash\&.
.sp .5v
.RE
.RE
.PP
\fIHOST\fR
.RS 4
The database server host you are currently connected to\&. This is set every time you connect to a database (including program start\-up), but can be unset\&.
.RE
.PP
\fIIGNOREEOF\fR
.RS 4
If unset, sending an
EOF
character (usually
Control+D) to an interactive session of
psql
will terminate the application\&. If set to a numeric value, that many
EOF
characters are ignored before the application terminates\&. If the variable is set but has no numeric value, the default is 10\&.
.if n \{\
.sp
.\}
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBNote\fR
.ps -1
.br
This feature was shamelessly plagiarized from
Bash\&.
.sp .5v
.RE
.RE
.PP
\fILASTOID\fR
.RS 4
The value of the last affected OID, as returned from an
\fBINSERT\fR
or
\fB\elo_import\fR
command\&. This variable is only guaranteed to be valid until after the result of the next
SQL
command has been displayed\&.
.RE
.PP
\fION_ERROR_ROLLBACK\fR
.RS 4
When set to
on, if a statement in a transaction block generates an error, the error is ignored and the transaction continues\&. When set to
interactive, such errors are only ignored in interactive sessions, and not when reading script files\&. When unset or set to
off, a statement in a transaction block that generates an error aborts the entire transaction\&. The error rollback mode works by issuing an implicit
\fBSAVEPOINT\fR
for you, just before each command that is in a transaction block, and then rolling back to the savepoint if the command fails\&.
.RE
.PP
\fION_ERROR_STOP\fR
.RS 4
By default, command processing continues after an error\&. When this variable is set to
on, processing will instead stop immediately\&. In interactive mode,
psql
will return to the command prompt; otherwise,
psql
will exit, returning error code 3 to distinguish this case from fatal error conditions, which are reported using error code 1\&. In either case, any currently running scripts (the top\-level script, if any, and any other scripts which it may have in invoked) will be terminated immediately\&. If the top\-level command string contained multiple SQL commands, processing will stop with the current command\&.
.RE
.PP
\fIPORT\fR
.RS 4
The database server port to which you are currently connected\&. This is set every time you connect to a database (including program start\-up), but can be unset\&.
.RE
.PP
\fIPROMPT1\fR
.br
\fIPROMPT2\fR
.br
\fIPROMPT3\fR
.RS 4
These specify what the prompts
psql
issues should look like\&. See
Prompting
below\&.
.RE
.PP
\fIQUIET\fR
.RS 4
Setting this variable to
on
is equivalent to the command line option
\fB\-q\fR\&. It is probably not too useful in interactive mode\&.
.RE
.PP
\fISHOW_CONTEXT\fR
.RS 4
This variable can be set to the values
never,
errors, or
always
to control whether
CONTEXT
fields are displayed in messages from the server\&. The default is
errors
(meaning that context will be shown in error messages, but not in notice or warning messages)\&. This setting has no effect when
\fIVERBOSITY\fR
is set to
terse\&. (See also
\fB\eerrverbose\fR, for use when you want a verbose version of the error you just got\&.)
.RE
.PP
\fISINGLELINE\fR
.RS 4
Setting this variable to
on
is equivalent to the command line option
\fB\-S\fR\&.
.RE
.PP
\fISINGLESTEP\fR
.RS 4
Setting this variable to
on
is equivalent to the command line option
\fB\-s\fR\&.
.RE
.PP
\fIUSER\fR
.RS 4
The database user you are currently connected as\&. This is set every time you connect to a database (including program start\-up), but can be unset\&.
.RE
.PP
\fIVERBOSITY\fR
.RS 4
This variable can be set to the values
default,
verbose, or
terse
to control the verbosity of error reports\&. (See also
\fB\eerrverbose\fR, for use when you want a verbose version of the error you just got\&.)
.RE
.RE
.sp
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBSQL Interpolation\fR
.RS 4
.PP
A key feature of
psql
variables is that you can substitute (\(lqinterpolate\(rq) them into regular
SQL
statements, as well as the arguments of meta\-commands\&. Furthermore,
psql
provides facilities for ensuring that variable values used as SQL literals and identifiers are properly quoted\&. The syntax for interpolating a value without any quoting is to prepend the variable name with a colon (:)\&. For example,
.sp
.if n \{\
.RS 4
.\}
.nf
testdb=> \fB\eset foo \*(Aqmy_table\*(Aq\fR
testdb=> \fBSELECT * FROM :foo;\fR
.fi
.if n \{\
.RE
.\}
.sp
would query the table
my_table\&. Note that this may be unsafe: the value of the variable is copied literally, so it can contain unbalanced quotes, or even backslash commands\&. You must make sure that it makes sense where you put it\&.
.PP
When a value is to be used as an SQL literal or identifier, it is safest to arrange for it to be quoted\&. To quote the value of a variable as an SQL literal, write a colon followed by the variable name in single quotes\&. To quote the value as an SQL identifier, write a colon followed by the variable name in double quotes\&. These constructs deal correctly with quotes and other special characters embedded within the variable value\&. The previous example would be more safely written this way:
.sp
.if n \{\
.RS 4
.\}
.nf
testdb=> \fB\eset foo \*(Aqmy_table\*(Aq\fR
testdb=> \fBSELECT * FROM :"foo";\fR
.fi
.if n \{\
.RE
.\}
.PP
Variable interpolation will not be performed within quoted
SQL
literals and identifiers\&. Therefore, a construction such as
\*(Aq:foo\*(Aq
doesn\*(Aqt work to produce a quoted literal from a variable\*(Aqs value (and it would be unsafe if it did work, since it wouldn\*(Aqt correctly handle quotes embedded in the value)\&.
.PP
One example use of this mechanism is to copy the contents of a file into a table column\&. First load the file into a variable and then interpolate the variable\*(Aqs value as a quoted string:
.sp
.if n \{\
.RS 4
.\}
.nf
testdb=> \fB\eset content `cat my_file\&.txt`\fR
testdb=> \fBINSERT INTO my_table VALUES (:\*(Aqcontent\*(Aq);\fR
.fi
.if n \{\
.RE
.\}
.sp
(Note that this still won\*(Aqt work if
my_file\&.txt
contains NUL bytes\&.
psql
does not support embedded NUL bytes in variable values\&.)
.PP
Since colons can legally appear in SQL commands, an apparent attempt at interpolation (that is,
:name,
:\*(Aqname\*(Aq, or
:"name") is not replaced unless the named variable is currently set\&. In any case, you can escape a colon with a backslash to protect it from substitution\&.
.PP
The colon syntax for variables is standard
SQL
for embedded query languages, such as
ECPG\&. The colon syntaxes for array slices and type casts are
PostgreSQL
extensions, which can sometimes conflict with the standard usage\&. The colon\-quote syntax for escaping a variable\*(Aqs value as an SQL literal or identifier is a
psql
extension\&.
.RE
.sp
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBPrompting\fR
.RS 4
.PP
The prompts
psql
issues can be customized to your preference\&. The three variables
\fIPROMPT1\fR,
\fIPROMPT2\fR, and
\fIPROMPT3\fR
contain strings and special escape sequences that describe the appearance of the prompt\&. Prompt 1 is the normal prompt that is issued when
psql
requests a new command\&. Prompt 2 is issued when more input is expected during command entry, for example because the command was not terminated with a semicolon or a quote was not closed\&. Prompt 3 is issued when you are running an
SQL
\fBCOPY FROM STDIN\fR
command and you need to type in a row value on the terminal\&.
.PP
The value of the selected prompt variable is printed literally, except where a percent sign (%) is encountered\&. Depending on the next character, certain other text is substituted instead\&. Defined substitutions are:
.PP
%M
.RS 4
The full host name (with domain name) of the database server, or
[local]
if the connection is over a Unix domain socket, or
[local:\fI/dir/name\fR], if the Unix domain socket is not at the compiled in default location\&.
.RE
.PP
%m
.RS 4
The host name of the database server, truncated at the first dot, or
[local]
if the connection is over a Unix domain socket\&.
.RE
.PP
%>
.RS 4
The port number at which the database server is listening\&.
.RE
.PP
%n
.RS 4
The database session user name\&. (The expansion of this value might change during a database session as the result of the command
\fBSET SESSION AUTHORIZATION\fR\&.)
.RE
.PP
%/
.RS 4
The name of the current database\&.
.RE
.PP
%~
.RS 4
Like
%/, but the output is
~
(tilde) if the database is your default database\&.
.RE
.PP
%#
.RS 4
If the session user is a database superuser, then a
#, otherwise a
>\&. (The expansion of this value might change during a database session as the result of the command
\fBSET SESSION AUTHORIZATION\fR\&.)
.RE
.PP
%p
.RS 4
The process ID of the backend currently connected to\&.
.RE
.PP
%R
.RS 4
In prompt 1 normally
=, but
^
if in single\-line mode, or
!
if the session is disconnected from the database (which can happen if
\fB\econnect\fR
fails)\&. In prompt 2
%R
is replaced by a character that depends on why
psql
expects more input:
\-
if the command simply wasn\*(Aqt terminated yet, but
*
if there is an unfinished
/* \&.\&.\&. */
comment, a single quote if there is an unfinished quoted string, a double quote if there is an unfinished quoted identifier, a dollar sign if there is an unfinished dollar\-quoted string, or
(
if there is an unmatched left parenthesis\&. In prompt 3
%R
doesn\*(Aqt produce anything\&.
.RE
.PP
%x
.RS 4
Transaction status: an empty string when not in a transaction block, or
*
when in a transaction block, or
!
when in a failed transaction block, or
?
when the transaction state is indeterminate (for example, because there is no connection)\&.
.RE
.PP
%l
.RS 4
The line number inside the current statement, starting from
1\&.
.RE
.PP
%\fIdigits\fR
.RS 4
The character with the indicated octal code is substituted\&.
.RE
.PP
%:\fIname\fR:
.RS 4
The value of the
psql
variable
\fIname\fR\&. See the section
Variables
for details\&.
.RE
.PP
%`\fIcommand\fR`
.RS 4
The output of
\fIcommand\fR, similar to ordinary
\(lqback\-tick\(rq
substitution\&.
.RE
.PP
%[ \&.\&.\&. %]
.RS 4
Prompts can contain terminal control characters which, for example, change the color, background, or style of the prompt text, or change the title of the terminal window\&. In order for the line editing features of
Readline
to work properly, these non\-printing control characters must be designated as invisible by surrounding them with
%[
and
%]\&. Multiple pairs of these can occur within the prompt\&. For example:
.sp
.if n \{\
.RS 4
.\}
.nf
testdb=> \eset PROMPT1 \*(Aq%[%033[1;33;40m%]%n@%/%R%[%033[0m%]%# \*(Aq
.fi
.if n \{\
.RE
.\}
.sp
results in a boldfaced (1;) yellow\-on\-black (33;40) prompt on VT100\-compatible, color\-capable terminals\&.
.RE
To insert a percent sign into your prompt, write
%%\&. The default prompts are
\*(Aq%/%R%# \*(Aq
for prompts 1 and 2, and
\*(Aq>> \*(Aq
for prompt 3\&.
.if n \{\
.sp
.\}
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBNote\fR
.ps -1
.br
.PP
This feature was shamelessly plagiarized from
tcsh\&.
.sp .5v
.RE
.RE
.sp
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBCommand-Line Editing\fR
.RS 4
.PP
psql
supports the
Readline
library for convenient line editing and retrieval\&. The command history is automatically saved when
psql
exits and is reloaded when
psql
starts up\&. Tab\-completion is also supported, although the completion logic makes no claim to be an
SQL
parser\&. The queries generated by tab\-completion can also interfere with other SQL commands, e\&.g\&.,
SET TRANSACTION ISOLATION LEVEL\&. If for some reason you do not like the tab completion, you can turn it off by putting this in a file named
\&.inputrc
in your home directory:
.sp
.if n \{\
.RS 4
.\}
.nf
$if psql
set disable\-completion on
$endif
.fi
.if n \{\
.RE
.\}
.sp
(This is not a
psql
but a
Readline
feature\&. Read its documentation for further details\&.)
.RE
.SH "ENVIRONMENT"
.PP
\fBCOLUMNS\fR
.RS 4
If
\epset columns
is zero, controls the width for the
wrapped
format and width for determining if wide output requires the pager or should be switched to the vertical format in expanded auto mode\&.
.RE
.PP
\fBPAGER\fR
.RS 4
If the query results do not fit on the screen, they are piped through this command\&. Typical values are
more
or
less\&. The default is platform\-dependent\&. Use of the pager can be disabled by setting
\fBPAGER\fR
to empty, or by using pager\-related options of the
\fB\epset\fR
command\&.
.RE
.PP
\fBPGDATABASE\fR
.br
\fBPGHOST\fR
.br
\fBPGPORT\fR
.br
\fBPGUSER\fR
.RS 4
Default connection parameters (see
Section 32.14, \(lqEnvironment Variables\(rq, in the documentation)\&.
.RE
.PP
\fBPSQL_EDITOR\fR
.br
\fBEDITOR\fR
.br
\fBVISUAL\fR
.RS 4
Editor used by the
\fB\ee\fR,
\fB\eef\fR, and
\fB\eev\fR
commands\&. These variables are examined in the order listed; the first that is set is used\&.
.sp
The built\-in default editors are
vi
on Unix systems and
notepad\&.exe
on Windows systems\&.
.RE
.PP
\fBPSQL_EDITOR_LINENUMBER_ARG\fR
.RS 4
When
\fB\ee\fR,
\fB\eef\fR, or
\fB\eev\fR
is used with a line number argument, this variable specifies the command\-line argument used to pass the starting line number to the user\*(Aqs editor\&. For editors such as
Emacs
or
vi, this is a plus sign\&. Include a trailing space in the value of the variable if there needs to be space between the option name and the line number\&. Examples:
.sp
.if n \{\
.RS 4
.\}
.nf
PSQL_EDITOR_LINENUMBER_ARG=\*(Aq+\*(Aq
PSQL_EDITOR_LINENUMBER_ARG=\*(Aq\-\-line \*(Aq
.fi
.if n \{\
.RE
.\}
.sp
The default is
+
on Unix systems (corresponding to the default editor
vi, and useful for many other common editors); but there is no default on Windows systems\&.
.RE
.PP
\fBPSQL_HISTORY\fR
.RS 4
Alternative location for the command history file\&. Tilde (~) expansion is performed\&.
.RE
.PP
\fBPSQLRC\fR
.RS 4
Alternative location of the user\*(Aqs
\&.psqlrc
file\&. Tilde (~) expansion is performed\&.
.RE
.PP
\fBSHELL\fR
.RS 4
Command executed by the
\fB\e!\fR
command\&.
.RE
.PP
\fBTMPDIR\fR
.RS 4
Directory for storing temporary files\&. The default is
/tmp\&.
.RE
.PP
This utility, like most other
PostgreSQL
utilities, also uses the environment variables supported by
libpq
(see
Section 32.14, \(lqEnvironment Variables\(rq, in the documentation)\&.
.SH "FILES"
.PP
psqlrc and ~/\&.psqlrc
.RS 4
Unless it is passed an
\fB\-X\fR
option,
psql
attempts to read and execute commands from the system\-wide startup file (psqlrc) and then the user\*(Aqs personal startup file (~/\&.psqlrc), after connecting to the database but before accepting normal commands\&. These files can be used to set up the client and/or the server to taste, typically with
\fB\eset\fR
and
\fBSET\fR
commands\&.
.sp
The system\-wide startup file is named
psqlrc
and is sought in the installation\*(Aqs
\(lqsystem configuration\(rq
directory, which is most reliably identified by running
pg_config \-\-sysconfdir\&. By default this directory will be
\&.\&./etc/
relative to the directory containing the
PostgreSQL
executables\&. The name of this directory can be set explicitly via the
\fBPGSYSCONFDIR\fR
environment variable\&.
.sp
The user\*(Aqs personal startup file is named
\&.psqlrc
and is sought in the invoking user\*(Aqs home directory\&. On Windows, which lacks such a concept, the personal startup file is named
%APPDATA%\epostgresql\epsqlrc\&.conf\&. The location of the user\*(Aqs startup file can be set explicitly via the
\fBPSQLRC\fR
environment variable\&.
.sp
Both the system\-wide startup file and the user\*(Aqs personal startup file can be made
psql\-version\-specific by appending a dash and the
PostgreSQL
major or minor release number to the file name, for example
~/\&.psqlrc\-9\&.2
or
~/\&.psqlrc\-9\&.2\&.5\&. The most specific version\-matching file will be read in preference to a non\-version\-specific file\&.
.RE
.PP
\&.psql_history
.RS 4
The command\-line history is stored in the file
~/\&.psql_history, or
%APPDATA%\epostgresql\epsql_history
on Windows\&.
.sp
The location of the history file can be set explicitly via the
\fBPSQL_HISTORY\fR
environment variable\&.
.RE
.SH "NOTES"
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
psql
works best with servers of the same or an older major version\&. Backslash commands are particularly likely to fail if the server is of a newer version than
psql
itself\&. However, backslash commands of the
\ed
family should work with servers of versions back to 7\&.4, though not necessarily with servers newer than
psql
itself\&. The general functionality of running SQL commands and displaying query results should also work with servers of a newer major version, but this cannot be guaranteed in all cases\&.
.sp
If you want to use
psql
to connect to several servers of different major versions, it is recommended that you use the newest version of
psql\&. Alternatively, you can keep around a copy of
psql
from each major version and be sure to use the version that matches the respective server\&. But in practice, this additional complication should not be necessary\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Before
PostgreSQL
9\&.6, the
\fB\-c\fR
option implied
\fB\-X\fR
(\fB\-\-no\-psqlrc\fR); this is no longer the case\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Before
PostgreSQL
8\&.4,
psql
allowed the first argument of a single\-letter backslash command to start directly after the command, without intervening whitespace\&. Now, some whitespace is required\&.
.RE
.SH "NOTES FOR WINDOWS USERS"
.PP
psql
is built as a
\(lqconsole application\(rq\&. Since the Windows console windows use a different encoding than the rest of the system, you must take special care when using 8\-bit characters within
psql\&. If
psql
detects a problematic console code page, it will warn you at startup\&. To change the console code page, two things are necessary:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Set the code page by entering
\fBcmd\&.exe /c chcp 1252\fR\&. (1252 is a code page that is appropriate for German; replace it with your value\&.) If you are using Cygwin, you can put this command in
/etc/profile\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Set the console font to
Lucida Console, because the raster font does not work with the ANSI code page\&.
.RE
.SH "EXAMPLES"
.PP
The first example shows how to spread a command over several lines of input\&. Notice the changing prompt:
.sp
.if n \{\
.RS 4
.\}
.nf
testdb=> \fBCREATE TABLE my_table (\fR
testdb(> \fB first integer not null default 0,\fR
testdb(> \fB second text)\fR
testdb\-> \fB;\fR
CREATE TABLE
.fi
.if n \{\
.RE
.\}
.sp
Now look at the table definition again:
.sp
.if n \{\
.RS 4
.\}
.nf
testdb=> \fB\ed my_table\fR
Table "my_table"
Attribute | Type | Modifier
\-\-\-\-\-\-\-\-\-\-\-+\-\-\-\-\-\-\-\-\-+\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
first | integer | not null default 0
second | text |
.fi
.if n \{\
.RE
.\}
.sp
Now we change the prompt to something more interesting:
.sp
.if n \{\
.RS 4
.\}
.nf
testdb=> \fB\eset PROMPT1 \*(Aq%n@%m %~%R%# \*(Aq\fR
peter@localhost testdb=>
.fi
.if n \{\
.RE
.\}
.sp
Let\*(Aqs assume you have filled the table with data and want to take a look at it:
.sp
.if n \{\
.RS 4
.\}
.nf
peter@localhost testdb=> SELECT * FROM my_table;
first | second
\-\-\-\-\-\-\-+\-\-\-\-\-\-\-\-
1 | one
2 | two
3 | three
4 | four
(4 rows)
.fi
.if n \{\
.RE
.\}
.sp
You can display tables in different ways by using the
\fB\epset\fR
command:
.sp
.if n \{\
.RS 4
.\}
.nf
peter@localhost testdb=> \fB\epset border 2\fR
Border style is 2\&.
peter@localhost testdb=> \fBSELECT * FROM my_table;\fR
+\-\-\-\-\-\-\-+\-\-\-\-\-\-\-\-+
| first | second |
+\-\-\-\-\-\-\-+\-\-\-\-\-\-\-\-+
| 1 | one |
| 2 | two |
| 3 | three |
| 4 | four |
+\-\-\-\-\-\-\-+\-\-\-\-\-\-\-\-+
(4 rows)
peter@localhost testdb=> \fB\epset border 0\fR
Border style is 0\&.
peter@localhost testdb=> \fBSELECT * FROM my_table;\fR
first second
\-\-\-\-\- \-\-\-\-\-\-
1 one
2 two
3 three
4 four
(4 rows)
peter@localhost testdb=> \fB\epset border 1\fR
Border style is 1\&.
peter@localhost testdb=> \fB\epset format unaligned\fR
Output format is unaligned\&.
peter@localhost testdb=> \fB\epset fieldsep ","\fR
Field separator is ","\&.
peter@localhost testdb=> \fB\epset tuples_only\fR
Showing only tuples\&.
peter@localhost testdb=> \fBSELECT second, first FROM my_table;\fR
one,1
two,2
three,3
four,4
.fi
.if n \{\
.RE
.\}
.sp
Alternatively, use the short commands:
.sp
.if n \{\
.RS 4
.\}
.nf
peter@localhost testdb=> \fB\ea \et \ex\fR
Output format is aligned\&.
Tuples only is off\&.
Expanded display is on\&.
peter@localhost testdb=> \fBSELECT * FROM my_table;\fR
\-[ RECORD 1 ]\-
first | 1
second | one
\-[ RECORD 2 ]\-
first | 2
second | two
\-[ RECORD 3 ]\-
first | 3
second | three
\-[ RECORD 4 ]\-
first | 4
second | four
.fi
.if n \{\
.RE
.\}
.PP
When suitable, query results can be shown in a crosstab representation with the
\fB\ecrosstabview\fR
command:
.sp
.if n \{\
.RS 4
.\}
.nf
testdb=> \fBSELECT first, second, first > 2 AS gt2 FROM my_table;\fR
first | second | gt2
\-\-\-\-\-\-\-+\-\-\-\-\-\-\-\-+\-\-\-\-\-
1 | one | f
2 | two | f
3 | three | t
4 | four | t
(4 rows)
testdb=> \fB\ecrosstabview first second\fR
first | one | two | three | four
\-\-\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-\-\-+\-\-\-\-\-\-
1 | f | | |
2 | | f | |
3 | | | t |
4 | | | | t
(4 rows)
.fi
.if n \{\
.RE
.\}
.sp
This second example shows a multiplication table with rows sorted in reverse numerical order and columns with an independent, ascending numerical order\&.
.sp
.if n \{\
.RS 4
.\}
.nf
testdb=> \fBSELECT t1\&.first as "A", t2\&.first+100 AS "B", t1\&.first*(t2\&.first+100) as "AxB",\fR
testdb(> \fBrow_number() over(order by t2\&.first) AS ord\fR
testdb(> \fBFROM my_table t1 CROSS JOIN my_table t2 ORDER BY 1 DESC\fR
testdb(> \fB\ecrosstabview "A" "B" "AxB" ord\fR
A | 101 | 102 | 103 | 104
\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-
4 | 404 | 408 | 412 | 416
3 | 303 | 306 | 309 | 312
2 | 202 | 204 | 206 | 208
1 | 101 | 102 | 103 | 104
(4 rows)
.fi
.if n \{\
.RE
.\}
.sp
man/man3/SPI_fnumber.3 0000644 00000004147 14751153421 0010423 0 ustar 00 '\" t
.\" Title: SPI_fnumber
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "SPI_FNUMBER" "3" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
SPI_fnumber \- determine the column number for the specified column name
.SH "SYNOPSIS"
.sp
.nf
int SPI_fnumber(TupleDesc \fIrowdesc\fR, const char * \fIcolname\fR)
.fi
.SH "DESCRIPTION"
.PP
\fBSPI_fnumber\fR
returns the column number for the column with the specified name\&.
.PP
If
\fIcolname\fR
refers to a system column (e\&.g\&.,
oid) then the appropriate negative column number will be returned\&. The caller should be careful to test the return value for exact equality to
SPI_ERROR_NOATTRIBUTE
to detect an error; testing the result for less than or equal to 0 is not correct unless system columns should be rejected\&.
.SH "ARGUMENTS"
.PP
TupleDesc \fIrowdesc\fR
.RS 4
input row description
.RE
.PP
const char * \fIcolname\fR
.RS 4
column name
.RE
.SH "RETURN VALUE"
.PP
Column number (count starts at 1), or
SPI_ERROR_NOATTRIBUTE
if the named column was not found\&.
man/man3/dblink_get_pkey.3 0000644 00000005216 14751153421 0011402 0 ustar 00 '\" t
.\" Title: dblink_get_pkey
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "DBLINK_GET_PKEY" "3" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
dblink_get_pkey \- returns the positions and field names of a relation\*(Aqs primary key fields
.SH "SYNOPSIS"
.sp
.nf
dblink_get_pkey(text relname) returns setof dblink_pkey_results
.fi
.SH "DESCRIPTION"
.PP
\fBdblink_get_pkey\fR
provides information about the primary key of a relation in the local database\&. This is sometimes useful in generating queries to be sent to remote databases\&.
.SH "ARGUMENTS"
.PP
\fIrelname\fR
.RS 4
Name of a local relation, for example
foo
or
myschema\&.mytab\&. Include double quotes if the name is mixed\-case or contains special characters, for example
"FooBar"; without quotes, the string will be folded to lower case\&.
.RE
.SH "RETURN VALUE"
.PP
Returns one row for each primary key field, or no rows if the relation has no primary key\&. The result row type is defined as
.sp
.if n \{\
.RS 4
.\}
.nf
CREATE TYPE dblink_pkey_results AS (position int, colname text);
.fi
.if n \{\
.RE
.\}
.sp
The
position
column simply runs from 1 to
\fIN\fR; it is the number of the field within the primary key, not the number within the table\*(Aqs columns\&.
.SH "EXAMPLES"
.sp
.if n \{\
.RS 4
.\}
.nf
CREATE TABLE foobar (
f1 int,
f2 int,
f3 int,
PRIMARY KEY (f1, f2, f3)
);
CREATE TABLE
SELECT * FROM dblink_get_pkey(\*(Aqfoobar\*(Aq);
position | colname
\-\-\-\-\-\-\-\-\-\-+\-\-\-\-\-\-\-\-\-
1 | f1
2 | f2
3 | f3
(3 rows)
.fi
.if n \{\
.RE
.\}
man/man3/SPI_pop.3 0000644 00000002717 14751153421 0007564 0 ustar 00 '\" t
.\" Title: SPI_pop
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "SPI_POP" "3" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
SPI_pop \- pop SPI stack to return from recursive SPI usage
.SH "SYNOPSIS"
.sp
.nf
void SPI_pop(void)
.fi
.SH "DESCRIPTION"
.PP
\fBSPI_pop\fR
pops the previous environment from the SPI call stack\&. See
\fBSPI_push\fR\&.
man/man3/SPI_repalloc.3 0000644 00000003651 14751153421 0010565 0 ustar 00 '\" t
.\" Title: SPI_repalloc
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "SPI_REPALLOC" "3" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
SPI_repalloc \- reallocate memory in the upper executor context
.SH "SYNOPSIS"
.sp
.nf
void * SPI_repalloc(void * \fIpointer\fR, Size \fIsize\fR)
.fi
.SH "DESCRIPTION"
.PP
\fBSPI_repalloc\fR
changes the size of a memory segment previously allocated using
\fBSPI_palloc\fR\&.
.PP
This function is no longer different from plain
\fBrepalloc\fR\&. It\*(Aqs kept just for backward compatibility of existing code\&.
.SH "ARGUMENTS"
.PP
void * \fIpointer\fR
.RS 4
pointer to existing storage to change
.RE
.PP
Size \fIsize\fR
.RS 4
size in bytes of storage to allocate
.RE
.SH "RETURN VALUE"
.PP
pointer to new storage space of specified size with the contents copied from the existing area
man/man3/SPI_exec.3 0000644 00000003344 14751153421 0007707 0 ustar 00 '\" t
.\" Title: SPI_exec
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "SPI_EXEC" "3" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
SPI_exec \- execute a read/write command
.SH "SYNOPSIS"
.sp
.nf
int SPI_exec(const char * \fIcommand\fR, long \fIcount\fR)
.fi
.SH "DESCRIPTION"
.PP
\fBSPI_exec\fR
is the same as
\fBSPI_execute\fR, with the latter\*(Aqs
\fIread_only\fR
parameter always taken as
false\&.
.SH "ARGUMENTS"
.PP
const char * \fIcommand\fR
.RS 4
string containing command to execute
.RE
.PP
long \fIcount\fR
.RS 4
maximum number of rows to return, or
0
for no limit
.RE
.SH "RETURN VALUE"
.PP
See
\fBSPI_execute\fR\&.
man/man3/dblink_cancel_query.3 0000644 00000004152 14751153421 0012243 0 ustar 00 '\" t
.\" Title: dblink_cancel_query
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "DBLINK_CANCEL_QUERY" "3" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
dblink_cancel_query \- cancels any active query on the named connection
.SH "SYNOPSIS"
.sp
.nf
dblink_cancel_query(text connname) returns text
.fi
.SH "DESCRIPTION"
.PP
\fBdblink_cancel_query\fR
attempts to cancel any query that is in progress on the named connection\&. Note that this is not certain to succeed (since, for example, the remote query might already have finished)\&. A cancel request simply improves the odds that the query will fail soon\&. You must still complete the normal query protocol, for example by calling
\fBdblink_get_result\fR\&.
.SH "ARGUMENTS"
.PP
\fIconnname\fR
.RS 4
Name of the connection to use\&.
.RE
.SH "RETURN VALUE"
.PP
Returns
OK
if the cancel request has been sent, or the text of an error message on failure\&.
.SH "EXAMPLES"
.sp
.if n \{\
.RS 4
.\}
.nf
SELECT dblink_cancel_query(\*(Aqdtest1\*(Aq);
.fi
.if n \{\
.RE
.\}
man/man3/SPI_pfree.3 0000644 00000003301 14751153421 0010055 0 ustar 00 '\" t
.\" Title: SPI_pfree
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "SPI_PFREE" "3" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
SPI_pfree \- free memory in the upper executor context
.SH "SYNOPSIS"
.sp
.nf
void SPI_pfree(void * \fIpointer\fR)
.fi
.SH "DESCRIPTION"
.PP
\fBSPI_pfree\fR
frees memory previously allocated using
\fBSPI_palloc\fR
or
\fBSPI_repalloc\fR\&.
.PP
This function is no longer different from plain
\fBpfree\fR\&. It\*(Aqs kept just for backward compatibility of existing code\&.
.SH "ARGUMENTS"
.PP
void * \fIpointer\fR
.RS 4
pointer to existing storage to free
.RE
man/man3/dblink_build_sql_insert.3 0000644 00000007552 14751153421 0013142 0 ustar 00 '\" t
.\" Title: dblink_build_sql_insert
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "DBLINK_BUILD_SQL_INSERT" "3" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
dblink_build_sql_insert \- builds an INSERT statement using a local tuple, replacing the primary key field values with alternative supplied values
.SH "SYNOPSIS"
.sp
.nf
dblink_build_sql_insert(text relname,
int2vector primary_key_attnums,
integer num_primary_key_atts,
text[] src_pk_att_vals_array,
text[] tgt_pk_att_vals_array) returns text
.fi
.SH "DESCRIPTION"
.PP
\fBdblink_build_sql_insert\fR
can be useful in doing selective replication of a local table to a remote database\&. It selects a row from the local table based on primary key, and then builds a SQL
\fBINSERT\fR
command that will duplicate that row, but with the primary key values replaced by the values in the last argument\&. (To make an exact copy of the row, just specify the same values for the last two arguments\&.)
.SH "ARGUMENTS"
.PP
\fIrelname\fR
.RS 4
Name of a local relation, for example
foo
or
myschema\&.mytab\&. Include double quotes if the name is mixed\-case or contains special characters, for example
"FooBar"; without quotes, the string will be folded to lower case\&.
.RE
.PP
\fIprimary_key_attnums\fR
.RS 4
Attribute numbers (1\-based) of the primary key fields, for example
1 2\&.
.RE
.PP
\fInum_primary_key_atts\fR
.RS 4
The number of primary key fields\&.
.RE
.PP
\fIsrc_pk_att_vals_array\fR
.RS 4
Values of the primary key fields to be used to look up the local tuple\&. Each field is represented in text form\&. An error is thrown if there is no local row with these primary key values\&.
.RE
.PP
\fItgt_pk_att_vals_array\fR
.RS 4
Values of the primary key fields to be placed in the resulting
\fBINSERT\fR
command\&. Each field is represented in text form\&.
.RE
.SH "RETURN VALUE"
.PP
Returns the requested SQL statement as text\&.
.SH "NOTES"
.PP
As of
PostgreSQL
9\&.0, the attribute numbers in
\fIprimary_key_attnums\fR
are interpreted as logical column numbers, corresponding to the column\*(Aqs position in
SELECT * FROM relname\&. Previous versions interpreted the numbers as physical column positions\&. There is a difference if any column(s) to the left of the indicated column have been dropped during the lifetime of the table\&.
.SH "EXAMPLES"
.sp
.if n \{\
.RS 4
.\}
.nf
SELECT dblink_build_sql_insert(\*(Aqfoo\*(Aq, \*(Aq1 2\*(Aq, 2, \*(Aq{"1", "a"}\*(Aq, \*(Aq{"1", "b\*(Aq\*(Aqa"}\*(Aq);
dblink_build_sql_insert
\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
INSERT INTO foo(f1,f2,f3) VALUES(\*(Aq1\*(Aq,\*(Aqb\*(Aq\*(Aqa\*(Aq,\*(Aq1\*(Aq)
(1 row)
.fi
.if n \{\
.RE
.\}
man/man3/dblink_connect.3 0000644 00000013255 14751153421 0011226 0 ustar 00 '\" t
.\" Title: dblink_connect
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "DBLINK_CONNECT" "3" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
dblink_connect \- opens a persistent connection to a remote database
.SH "SYNOPSIS"
.sp
.nf
dblink_connect(text connstr) returns text
dblink_connect(text connname, text connstr) returns text
.fi
.SH "DESCRIPTION"
.PP
\fBdblink_connect()\fR
establishes a connection to a remote
PostgreSQL
database\&. The server and database to be contacted are identified through a standard
libpq
connection string\&. Optionally, a name can be assigned to the connection\&. Multiple named connections can be open at once, but only one unnamed connection is permitted at a time\&. The connection will persist until closed or until the database session is ended\&.
.PP
The connection string may also be the name of an existing foreign server\&. It is recommended to use the foreign\-data wrapper
dblink_fdw
when defining the foreign server\&. See the example below, as well as
CREATE SERVER (\fBCREATE_SERVER\fR(7))
and
CREATE USER MAPPING (\fBCREATE_USER_MAPPING\fR(7))\&.
.SH "ARGUMENTS"
.PP
\fIconnname\fR
.RS 4
The name to use for this connection; if omitted, an unnamed connection is opened, replacing any existing unnamed connection\&.
.RE
.PP
\fIconnstr\fR
.RS 4
libpq\-style connection info string, for example
hostaddr=127\&.0\&.0\&.1 port=5432 dbname=mydb user=postgres password=mypasswd options=\-csearch_path=\&. For details see
Section 32.1.1, \(lqConnection Strings\(rq, in the documentation\&. Alternatively, the name of a foreign server\&.
.RE
.SH "RETURN VALUE"
.PP
Returns status, which is always
OK
(since any error causes the function to throw an error instead of returning)\&.
.SH "NOTES"
.PP
If untrusted users have access to a database that has not adopted a
secure schema usage pattern, begin each session by removing publicly\-writable schemas from
\fIsearch_path\fR\&. One could, for example, add
options=\-csearch_path=
to
\fIconnstr\fR\&. This consideration is not specific to
dblink; it applies to every interface for executing arbitrary SQL commands\&.
.PP
Only superusers may use
\fBdblink_connect\fR
to create non\-password\-authenticated connections\&. If non\-superusers need this capability, use
\fBdblink_connect_u\fR
instead\&.
.PP
It is unwise to choose connection names that contain equal signs, as this opens a risk of confusion with connection info strings in other
dblink
functions\&.
.SH "EXAMPLES"
.sp
.if n \{\
.RS 4
.\}
.nf
SELECT dblink_connect(\*(Aqdbname=postgres options=\-csearch_path=\*(Aq);
dblink_connect
\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
OK
(1 row)
SELECT dblink_connect(\*(Aqmyconn\*(Aq, \*(Aqdbname=postgres options=\-csearch_path=\*(Aq);
dblink_connect
\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
OK
(1 row)
\-\- FOREIGN DATA WRAPPER functionality
\-\- Note: local connection must require password authentication for this to work properly
\-\- Otherwise, you will receive the following error from dblink_connect():
\-\- \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
\-\- ERROR: password is required
\-\- DETAIL: Non\-superuser cannot connect if the server does not request a password\&.
\-\- HINT: Target server\*(Aqs authentication method must be changed\&.
CREATE SERVER fdtest FOREIGN DATA WRAPPER dblink_fdw OPTIONS (hostaddr \*(Aq127\&.0\&.0\&.1\*(Aq, dbname \*(Aqcontrib_regression\*(Aq);
CREATE USER regress_dblink_user WITH PASSWORD \*(Aqsecret\*(Aq;
CREATE USER MAPPING FOR regress_dblink_user SERVER fdtest OPTIONS (user \*(Aqregress_dblink_user\*(Aq, password \*(Aqsecret\*(Aq);
GRANT USAGE ON FOREIGN SERVER fdtest TO regress_dblink_user;
GRANT SELECT ON TABLE foo TO regress_dblink_user;
\eset ORIGINAL_USER :USER
\ec \- regress_dblink_user
SELECT dblink_connect(\*(Aqmyconn\*(Aq, \*(Aqfdtest\*(Aq);
dblink_connect
\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
OK
(1 row)
SELECT * FROM dblink(\*(Aqmyconn\*(Aq, \*(AqSELECT * FROM foo\*(Aq) AS t(a int, b text, c text[]);
a | b | c
\-\-\-\-+\-\-\-+\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
0 | a | {a0,b0,c0}
1 | b | {a1,b1,c1}
2 | c | {a2,b2,c2}
3 | d | {a3,b3,c3}
4 | e | {a4,b4,c4}
5 | f | {a5,b5,c5}
6 | g | {a6,b6,c6}
7 | h | {a7,b7,c7}
8 | i | {a8,b8,c8}
9 | j | {a9,b9,c9}
10 | k | {a10,b10,c10}
(11 rows)
\ec \- :ORIGINAL_USER
REVOKE USAGE ON FOREIGN SERVER fdtest FROM regress_dblink_user;
REVOKE SELECT ON TABLE foo FROM regress_dblink_user;
DROP USER MAPPING FOR regress_dblink_user SERVER fdtest;
DROP USER regress_dblink_user;
DROP SERVER fdtest;
.fi
.if n \{\
.RE
.\}
man/man3/SPI_returntuple.3 0000644 00000004203 14751153421 0011347 0 ustar 00 '\" t
.\" Title: SPI_returntuple
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "SPI_RETURNTUPLE" "3" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
SPI_returntuple \- prepare to return a tuple as a Datum
.SH "SYNOPSIS"
.sp
.nf
HeapTupleHeader SPI_returntuple(HeapTuple \fIrow\fR, TupleDesc \fIrowdesc\fR)
.fi
.SH "DESCRIPTION"
.PP
\fBSPI_returntuple\fR
makes a copy of a row in the upper executor context, returning it in the form of a row type
Datum\&. The returned pointer need only be converted to
Datum
via
\fBPointerGetDatum\fR
before returning\&.
.PP
Note that this should be used for functions that are declared to return composite types\&. It is not used for triggers; use
\fBSPI_copytuple\fR
for returning a modified row in a trigger\&.
.SH "ARGUMENTS"
.PP
HeapTuple \fIrow\fR
.RS 4
row to be copied
.RE
.PP
TupleDesc \fIrowdesc\fR
.RS 4
descriptor for row (pass the same descriptor each time for most effective caching)
.RE
.SH "RETURN VALUE"
.PP
HeapTupleHeader
pointing to copied row;
NULL
only if
\fIrow\fR
or
\fIrowdesc\fR
is
NULL
man/man3/SPI_modifytuple.3 0000644 00000006554 14751153421 0011332 0 ustar 00 '\" t
.\" Title: SPI_modifytuple
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "SPI_MODIFYTUPLE" "3" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
SPI_modifytuple \- create a row by replacing selected fields of a given row
.SH "SYNOPSIS"
.sp
.nf
HeapTuple SPI_modifytuple(Relation \fIrel\fR, HeapTuple \fIrow\fR, int \fIncols\fR,
int * \fIcolnum\fR, Datum * \fIvalues\fR, const char * \fInulls\fR)
.fi
.SH "DESCRIPTION"
.PP
\fBSPI_modifytuple\fR
creates a new row by substituting new values for selected columns, copying the original row\*(Aqs columns at other positions\&. The input row is not modified\&.
.SH "ARGUMENTS"
.PP
Relation \fIrel\fR
.RS 4
Used only as the source of the row descriptor for the row\&. (Passing a relation rather than a row descriptor is a misfeature\&.)
.RE
.PP
HeapTuple \fIrow\fR
.RS 4
row to be modified
.RE
.PP
int \fIncols\fR
.RS 4
number of columns to be changed
.RE
.PP
int * \fIcolnum\fR
.RS 4
an array of length
\fIncols\fR, containing the numbers of the columns that are to be changed (column numbers start at 1)
.RE
.PP
Datum * \fIvalues\fR
.RS 4
an array of length
\fIncols\fR, containing the new values for the specified columns
.RE
.PP
const char * \fInulls\fR
.RS 4
an array of length
\fIncols\fR, describing which new values are null
.sp
If
\fInulls\fR
is
NULL
then
\fBSPI_modifytuple\fR
assumes that no new values are null\&. Otherwise, each entry of the
\fInulls\fR
array should be
\*(Aq\ \&\*(Aq
if the corresponding new value is non\-null, or
\*(Aqn\*(Aq
if the corresponding new value is null\&. (In the latter case, the actual value in the corresponding
\fIvalues\fR
entry doesn\*(Aqt matter\&.) Note that
\fInulls\fR
is not a text string, just an array: it does not need a
\*(Aq\e0\*(Aq
terminator\&.
.RE
.SH "RETURN VALUE"
.PP
new row with modifications, allocated in the upper executor context;
NULL
only if
\fIrow\fR
is
NULL
.PP
On error,
\fISPI_result\fR
is set as follows:
.PP
SPI_ERROR_ARGUMENT
.RS 4
if
\fIrel\fR
is
NULL, or if
\fIrow\fR
is
NULL, or if
\fIncols\fR
is less than or equal to 0, or if
\fIcolnum\fR
is
NULL, or if
\fIvalues\fR
is
NULL\&.
.RE
.PP
SPI_ERROR_NOATTRIBUTE
.RS 4
if
\fIcolnum\fR
contains an invalid column number (less than or equal to 0 or greater than the number of column in
\fIrow\fR)
.RE
man/man3/SPI_freetuple.3 0000644 00000003275 14751153421 0010761 0 ustar 00 '\" t
.\" Title: SPI_freetuple
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "SPI_FREETUPLE" "3" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
SPI_freetuple \- free a row allocated in the upper executor context
.SH "SYNOPSIS"
.sp
.nf
void SPI_freetuple(HeapTuple \fIrow\fR)
.fi
.SH "DESCRIPTION"
.PP
\fBSPI_freetuple\fR
frees a row previously allocated in the upper executor context\&.
.PP
This function is no longer different from plain
\fBheap_freetuple\fR\&. It\*(Aqs kept just for backward compatibility of existing code\&.
.SH "ARGUMENTS"
.PP
HeapTuple \fIrow\fR
.RS 4
row to free
.RE
man/man3/dblink_build_sql_update.3 0000644 00000010147 14751153421 0013112 0 ustar 00 '\" t
.\" Title: dblink_build_sql_update
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "DBLINK_BUILD_SQL_UPDATE" "3" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
dblink_build_sql_update \- builds an UPDATE statement using a local tuple, replacing the primary key field values with alternative supplied values
.SH "SYNOPSIS"
.sp
.nf
dblink_build_sql_update(text relname,
int2vector primary_key_attnums,
integer num_primary_key_atts,
text[] src_pk_att_vals_array,
text[] tgt_pk_att_vals_array) returns text
.fi
.SH "DESCRIPTION"
.PP
\fBdblink_build_sql_update\fR
can be useful in doing selective replication of a local table to a remote database\&. It selects a row from the local table based on primary key, and then builds a SQL
\fBUPDATE\fR
command that will duplicate that row, but with the primary key values replaced by the values in the last argument\&. (To make an exact copy of the row, just specify the same values for the last two arguments\&.) The
\fBUPDATE\fR
command always assigns all fields of the row \(em the main difference between this and
\fBdblink_build_sql_insert\fR
is that it\*(Aqs assumed that the target row already exists in the remote table\&.
.SH "ARGUMENTS"
.PP
\fIrelname\fR
.RS 4
Name of a local relation, for example
foo
or
myschema\&.mytab\&. Include double quotes if the name is mixed\-case or contains special characters, for example
"FooBar"; without quotes, the string will be folded to lower case\&.
.RE
.PP
\fIprimary_key_attnums\fR
.RS 4
Attribute numbers (1\-based) of the primary key fields, for example
1 2\&.
.RE
.PP
\fInum_primary_key_atts\fR
.RS 4
The number of primary key fields\&.
.RE
.PP
\fIsrc_pk_att_vals_array\fR
.RS 4
Values of the primary key fields to be used to look up the local tuple\&. Each field is represented in text form\&. An error is thrown if there is no local row with these primary key values\&.
.RE
.PP
\fItgt_pk_att_vals_array\fR
.RS 4
Values of the primary key fields to be placed in the resulting
\fBUPDATE\fR
command\&. Each field is represented in text form\&.
.RE
.SH "RETURN VALUE"
.PP
Returns the requested SQL statement as text\&.
.SH "NOTES"
.PP
As of
PostgreSQL
9\&.0, the attribute numbers in
\fIprimary_key_attnums\fR
are interpreted as logical column numbers, corresponding to the column\*(Aqs position in
SELECT * FROM relname\&. Previous versions interpreted the numbers as physical column positions\&. There is a difference if any column(s) to the left of the indicated column have been dropped during the lifetime of the table\&.
.SH "EXAMPLES"
.sp
.if n \{\
.RS 4
.\}
.nf
SELECT dblink_build_sql_update(\*(Aqfoo\*(Aq, \*(Aq1 2\*(Aq, 2, \*(Aq{"1", "a"}\*(Aq, \*(Aq{"1", "b"}\*(Aq);
dblink_build_sql_update
\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
UPDATE foo SET f1=\*(Aq1\*(Aq,f2=\*(Aqb\*(Aq,f3=\*(Aq1\*(Aq WHERE f1=\*(Aq1\*(Aq AND f2=\*(Aqb\*(Aq
(1 row)
.fi
.if n \{\
.RE
.\}
man/man3/SPI_execute_plan_with_paramlist.3 0000644 00000005207 14751153421 0014546 0 ustar 00 '\" t
.\" Title: SPI_execute_plan_with_paramlist
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "SPI_EXECUTE_PLAN_WITH_PARAMLIST" "3" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
SPI_execute_plan_with_paramlist \- execute a statement prepared by \fBSPI_prepare\fR
.SH "SYNOPSIS"
.sp
.nf
int SPI_execute_plan_with_paramlist(SPIPlanPtr \fIplan\fR,
ParamListInfo \fIparams\fR,
bool \fIread_only\fR,
long \fIcount\fR)
.fi
.SH "DESCRIPTION"
.PP
\fBSPI_execute_plan_with_paramlist\fR
executes a statement prepared by
\fBSPI_prepare\fR\&. This function is equivalent to
\fBSPI_execute_plan\fR
except that information about the parameter values to be passed to the query is presented differently\&. The
ParamListInfo
representation can be convenient for passing down values that are already available in that format\&. It also supports use of dynamic parameter sets via hook functions specified in
ParamListInfo\&.
.SH "ARGUMENTS"
.PP
SPIPlanPtr \fIplan\fR
.RS 4
prepared statement (returned by
\fBSPI_prepare\fR)
.RE
.PP
ParamListInfo \fIparams\fR
.RS 4
data structure containing parameter types and values; NULL if none
.RE
.PP
bool \fIread_only\fR
.RS 4
true
for read\-only execution
.RE
.PP
long \fIcount\fR
.RS 4
maximum number of rows to return, or
0
for no limit
.RE
.SH "RETURN VALUE"
.PP
The return value is the same as for
\fBSPI_execute_plan\fR\&.
.PP
\fISPI_processed\fR
and
\fISPI_tuptable\fR
are set as in
\fBSPI_execute_plan\fR
if successful\&.
man/man3/SPI_getargcount.3 0000644 00000003530 14751153421 0011302 0 ustar 00 '\" t
.\" Title: SPI_getargcount
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "SPI_GETARGCOUNT" "3" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
SPI_getargcount \- return the number of arguments needed by a statement prepared by \fBSPI_prepare\fR
.SH "SYNOPSIS"
.sp
.nf
int SPI_getargcount(SPIPlanPtr \fIplan\fR)
.fi
.SH "DESCRIPTION"
.PP
\fBSPI_getargcount\fR
returns the number of arguments needed to execute a statement prepared by
\fBSPI_prepare\fR\&.
.SH "ARGUMENTS"
.PP
SPIPlanPtr \fIplan\fR
.RS 4
prepared statement (returned by
\fBSPI_prepare\fR)
.RE
.SH "RETURN VALUE"
.PP
The count of expected arguments for the
\fIplan\fR\&. If the
\fIplan\fR
is
NULL
or invalid,
\fISPI_result\fR
is set to
SPI_ERROR_ARGUMENT
and \-1 is returned\&.
man/man3/dblink_disconnect.3 0000644 00000004143 14751153421 0011722 0 ustar 00 '\" t
.\" Title: dblink_disconnect
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "DBLINK_DISCONNECT" "3" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
dblink_disconnect \- closes a persistent connection to a remote database
.SH "SYNOPSIS"
.sp
.nf
dblink_disconnect() returns text
dblink_disconnect(text connname) returns text
.fi
.SH "DESCRIPTION"
.PP
\fBdblink_disconnect()\fR
closes a connection previously opened by
\fBdblink_connect()\fR\&. The form with no arguments closes an unnamed connection\&.
.SH "ARGUMENTS"
.PP
\fIconnname\fR
.RS 4
The name of a named connection to be closed\&.
.RE
.SH "RETURN VALUE"
.PP
Returns status, which is always
OK
(since any error causes the function to throw an error instead of returning)\&.
.SH "EXAMPLES"
.sp
.if n \{\
.RS 4
.\}
.nf
SELECT dblink_disconnect();
dblink_disconnect
\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
OK
(1 row)
SELECT dblink_disconnect(\*(Aqmyconn\*(Aq);
dblink_disconnect
\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
OK
(1 row)
.fi
.if n \{\
.RE
.\}
man/man3/SPI_execute_plan.3 0000644 00000006223 14751153421 0011436 0 ustar 00 '\" t
.\" Title: SPI_execute_plan
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "SPI_EXECUTE_PLAN" "3" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
SPI_execute_plan \- execute a statement prepared by \fBSPI_prepare\fR
.SH "SYNOPSIS"
.sp
.nf
int SPI_execute_plan(SPIPlanPtr \fIplan\fR, Datum * \fIvalues\fR, const char * \fInulls\fR,
bool \fIread_only\fR, long \fIcount\fR)
.fi
.SH "DESCRIPTION"
.PP
\fBSPI_execute_plan\fR
executes a statement prepared by
\fBSPI_prepare\fR
or one of its siblings\&.
\fIread_only\fR
and
\fIcount\fR
have the same interpretation as in
\fBSPI_execute\fR\&.
.SH "ARGUMENTS"
.PP
SPIPlanPtr \fIplan\fR
.RS 4
prepared statement (returned by
\fBSPI_prepare\fR)
.RE
.PP
Datum * \fIvalues\fR
.RS 4
An array of actual parameter values\&. Must have same length as the statement\*(Aqs number of arguments\&.
.RE
.PP
const char * \fInulls\fR
.RS 4
An array describing which parameters are null\&. Must have same length as the statement\*(Aqs number of arguments\&.
.sp
If
\fInulls\fR
is
NULL
then
\fBSPI_execute_plan\fR
assumes that no parameters are null\&. Otherwise, each entry of the
\fInulls\fR
array should be
\*(Aq\ \&\*(Aq
if the corresponding parameter value is non\-null, or
\*(Aqn\*(Aq
if the corresponding parameter value is null\&. (In the latter case, the actual value in the corresponding
\fIvalues\fR
entry doesn\*(Aqt matter\&.) Note that
\fInulls\fR
is not a text string, just an array: it does not need a
\*(Aq\e0\*(Aq
terminator\&.
.RE
.PP
bool \fIread_only\fR
.RS 4
true
for read\-only execution
.RE
.PP
long \fIcount\fR
.RS 4
maximum number of rows to return, or
0
for no limit
.RE
.SH "RETURN VALUE"
.PP
The return value is the same as for
\fBSPI_execute\fR, with the following additional possible error (negative) results:
.PP
SPI_ERROR_ARGUMENT
.RS 4
if
\fIplan\fR
is
NULL
or invalid, or
\fIcount\fR
is less than 0
.RE
.PP
SPI_ERROR_PARAM
.RS 4
if
\fIvalues\fR
is
NULL
and
\fIplan\fR
was prepared with some parameters
.RE
.PP
\fISPI_processed\fR
and
\fISPI_tuptable\fR
are set as in
\fBSPI_execute\fR
if successful\&.
man/man3/SPI_prepare_params.3 0000644 00000004541 14751153421 0011764 0 ustar 00 '\" t
.\" Title: SPI_prepare_params
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "SPI_PREPARE_PARAMS" "3" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
SPI_prepare_params \- prepare a statement, without executing it yet
.SH "SYNOPSIS"
.sp
.nf
SPIPlanPtr SPI_prepare_params(const char * \fIcommand\fR,
ParserSetupHook \fIparserSetup\fR,
void * \fIparserSetupArg\fR,
int \fIcursorOptions\fR)
.fi
.SH "DESCRIPTION"
.PP
\fBSPI_prepare_params\fR
creates and returns a prepared statement for the specified command, but doesn\*(Aqt execute the command\&. This function is equivalent to
\fBSPI_prepare_cursor\fR, with the addition that the caller can specify parser hook functions to control the parsing of external parameter references\&.
.SH "ARGUMENTS"
.PP
const char * \fIcommand\fR
.RS 4
command string
.RE
.PP
ParserSetupHook \fIparserSetup\fR
.RS 4
Parser hook setup function
.RE
.PP
void * \fIparserSetupArg\fR
.RS 4
pass\-through argument for
\fIparserSetup\fR
.RE
.PP
int \fIcursorOptions\fR
.RS 4
integer bit mask of cursor options; zero produces default behavior
.RE
.SH "RETURN VALUE"
.PP
\fBSPI_prepare_params\fR
has the same return conventions as
\fBSPI_prepare\fR\&.
man/man3/SPI_finish.3 0000644 00000004070 14751153421 0010240 0 ustar 00 '\" t
.\" Title: SPI_finish
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "SPI_FINISH" "3" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
SPI_finish \- disconnect a procedure from the SPI manager
.SH "SYNOPSIS"
.sp
.nf
int SPI_finish(void)
.fi
.SH "DESCRIPTION"
.PP
\fBSPI_finish\fR
closes an existing connection to the SPI manager\&. You must call this function after completing the SPI operations needed during your procedure\*(Aqs current invocation\&. You do not need to worry about making this happen, however, if you abort the transaction via
elog(ERROR)\&. In that case SPI will clean itself up automatically\&.
.PP
If
\fBSPI_finish\fR
is called without having a valid connection, it will return
SPI_ERROR_UNCONNECTED\&. There is no fundamental problem with this; it means that the SPI manager has nothing to do\&.
.SH "RETURN VALUE"
.PP
SPI_OK_FINISH
.RS 4
if properly disconnected
.RE
.PP
SPI_ERROR_UNCONNECTED
.RS 4
if called from an unconnected procedure
.RE
man/man3/SPI_freetuptable.3 0000644 00000004603 14751153421 0011444 0 ustar 00 '\" t
.\" Title: SPI_freetuptable
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "SPI_FREETUPTABLE" "3" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
SPI_freetuptable \- free a row set created by \fBSPI_execute\fR or a similar function
.SH "SYNOPSIS"
.sp
.nf
void SPI_freetuptable(SPITupleTable * \fItuptable\fR)
.fi
.SH "DESCRIPTION"
.PP
\fBSPI_freetuptable\fR
frees a row set created by a prior SPI command execution function, such as
\fBSPI_execute\fR\&. Therefore, this function is often called with the global variable
\fISPI_tuptable\fR
as argument\&.
.PP
This function is useful if a SPI procedure needs to execute multiple commands and does not want to keep the results of earlier commands around until it ends\&. Note that any unfreed row sets will be freed anyway at
\fBSPI_finish\fR\&. Also, if a subtransaction is started and then aborted within execution of a SPI procedure, SPI automatically frees any row sets created while the subtransaction was running\&.
.PP
Beginning in
PostgreSQL
9\&.3,
\fBSPI_freetuptable\fR
contains guard logic to protect against duplicate deletion requests for the same row set\&. In previous releases, duplicate deletions would lead to crashes\&.
.SH "ARGUMENTS"
.PP
SPITupleTable * \fItuptable\fR
.RS 4
pointer to row set to free, or NULL to do nothing
.RE
man/man3/dblink_fetch.3 0000644 00000010236 14751153421 0010662 0 ustar 00 '\" t
.\" Title: dblink_fetch
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "DBLINK_FETCH" "3" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
dblink_fetch \- returns rows from an open cursor in a remote database
.SH "SYNOPSIS"
.sp
.nf
dblink_fetch(text cursorname, int howmany [, bool fail_on_error]) returns setof record
dblink_fetch(text connname, text cursorname, int howmany [, bool fail_on_error]) returns setof record
.fi
.SH "DESCRIPTION"
.PP
\fBdblink_fetch\fR
fetches rows from a cursor previously established by
\fBdblink_open\fR\&.
.SH "ARGUMENTS"
.PP
\fIconnname\fR
.RS 4
Name of the connection to use; omit this parameter to use the unnamed connection\&.
.RE
.PP
\fIcursorname\fR
.RS 4
The name of the cursor to fetch from\&.
.RE
.PP
\fIhowmany\fR
.RS 4
The maximum number of rows to retrieve\&. The next
\fIhowmany\fR
rows are fetched, starting at the current cursor position, moving forward\&. Once the cursor has reached its end, no more rows are produced\&.
.RE
.PP
\fIfail_on_error\fR
.RS 4
If true (the default when omitted) then an error thrown on the remote side of the connection causes an error to also be thrown locally\&. If false, the remote error is locally reported as a NOTICE, and the function returns no rows\&.
.RE
.SH "RETURN VALUE"
.PP
The function returns the row(s) fetched from the cursor\&. To use this function, you will need to specify the expected set of columns, as previously discussed for
\fBdblink\fR\&.
.SH "NOTES"
.PP
On a mismatch between the number of return columns specified in the
FROM
clause, and the actual number of columns returned by the remote cursor, an error will be thrown\&. In this event, the remote cursor is still advanced by as many rows as it would have been if the error had not occurred\&. The same is true for any other error occurring in the local query after the remote
\fBFETCH\fR
has been done\&.
.SH "EXAMPLES"
.sp
.if n \{\
.RS 4
.\}
.nf
SELECT dblink_connect(\*(Aqdbname=postgres options=\-csearch_path=\*(Aq);
dblink_connect
\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
OK
(1 row)
SELECT dblink_open(\*(Aqfoo\*(Aq, \*(Aqselect proname, prosrc from pg_proc where proname like \*(Aq\*(Aqbytea%\*(Aq\*(Aq\*(Aq);
dblink_open
\-\-\-\-\-\-\-\-\-\-\-\-\-
OK
(1 row)
SELECT * FROM dblink_fetch(\*(Aqfoo\*(Aq, 5) AS (funcname name, source text);
funcname | source
\-\-\-\-\-\-\-\-\-\-+\-\-\-\-\-\-\-\-\-\-
byteacat | byteacat
byteacmp | byteacmp
byteaeq | byteaeq
byteage | byteage
byteagt | byteagt
(5 rows)
SELECT * FROM dblink_fetch(\*(Aqfoo\*(Aq, 5) AS (funcname name, source text);
funcname | source
\-\-\-\-\-\-\-\-\-\-\-+\-\-\-\-\-\-\-\-\-\-\-
byteain | byteain
byteale | byteale
bytealike | bytealike
bytealt | bytealt
byteane | byteane
(5 rows)
SELECT * FROM dblink_fetch(\*(Aqfoo\*(Aq, 5) AS (funcname name, source text);
funcname | source
\-\-\-\-\-\-\-\-\-\-\-\-+\-\-\-\-\-\-\-\-\-\-\-\-
byteanlike | byteanlike
byteaout | byteaout
(2 rows)
SELECT * FROM dblink_fetch(\*(Aqfoo\*(Aq, 5) AS (funcname name, source text);
funcname | source
\-\-\-\-\-\-\-\-\-\-+\-\-\-\-\-\-\-\-
(0 rows)
.fi
.if n \{\
.RE
.\}
man/man3/SPI_scroll_cursor_move.3 0000644 00000004651 14751153421 0012706 0 ustar 00 '\" t
.\" Title: SPI_scroll_cursor_move
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "SPI_SCROLL_CURSOR_MOVE" "3" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
SPI_scroll_cursor_move \- move a cursor
.SH "SYNOPSIS"
.sp
.nf
void SPI_scroll_cursor_move(Portal \fIportal\fR, FetchDirection \fIdirection\fR,
long \fIcount\fR)
.fi
.SH "DESCRIPTION"
.PP
\fBSPI_scroll_cursor_move\fR
skips over some number of rows in a cursor\&. This is equivalent to the SQL command
\fBMOVE\fR\&.
.SH "ARGUMENTS"
.PP
Portal \fIportal\fR
.RS 4
portal containing the cursor
.RE
.PP
FetchDirection \fIdirection\fR
.RS 4
one of
FETCH_FORWARD,
FETCH_BACKWARD,
FETCH_ABSOLUTE
or
FETCH_RELATIVE
.RE
.PP
long \fIcount\fR
.RS 4
number of rows to move for
FETCH_FORWARD
or
FETCH_BACKWARD; absolute row number to move to for
FETCH_ABSOLUTE; or relative row number to move to for
FETCH_RELATIVE
.RE
.SH "RETURN VALUE"
.PP
\fISPI_processed\fR
is set as in
\fBSPI_execute\fR
if successful\&.
\fISPI_tuptable\fR
is set to
NULL, since no rows are returned by this function\&.
.SH "NOTES"
.PP
See the SQL
\fBFETCH\fR(7)
command for details of the interpretation of the
\fIdirection\fR
and
\fIcount\fR
parameters\&.
.PP
Direction values other than
FETCH_FORWARD
may fail if the cursor\*(Aqs plan was not created with the
CURSOR_OPT_SCROLL
option\&.
man/man3/SPI_cursor_fetch.3 0000644 00000004072 14751153421 0011450 0 ustar 00 '\" t
.\" Title: SPI_cursor_fetch
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "SPI_CURSOR_FETCH" "3" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
SPI_cursor_fetch \- fetch some rows from a cursor
.SH "SYNOPSIS"
.sp
.nf
void SPI_cursor_fetch(Portal \fIportal\fR, bool \fIforward\fR, long \fIcount\fR)
.fi
.SH "DESCRIPTION"
.PP
\fBSPI_cursor_fetch\fR
fetches some rows from a cursor\&. This is equivalent to a subset of the SQL command
\fBFETCH\fR
(see
\fBSPI_scroll_cursor_fetch\fR
for more functionality)\&.
.SH "ARGUMENTS"
.PP
Portal \fIportal\fR
.RS 4
portal containing the cursor
.RE
.PP
bool \fIforward\fR
.RS 4
true for fetch forward, false for fetch backward
.RE
.PP
long \fIcount\fR
.RS 4
maximum number of rows to fetch
.RE
.SH "RETURN VALUE"
.PP
\fISPI_processed\fR
and
\fISPI_tuptable\fR
are set as in
\fBSPI_execute\fR
if successful\&.
.SH "NOTES"
.PP
Fetching backward may fail if the cursor\*(Aqs plan was not created with the
CURSOR_OPT_SCROLL
option\&.
man/man3/dblink_close.3 0000644 00000005324 14751153421 0010700 0 ustar 00 '\" t
.\" Title: dblink_close
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "DBLINK_CLOSE" "3" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
dblink_close \- closes a cursor in a remote database
.SH "SYNOPSIS"
.sp
.nf
dblink_close(text cursorname [, bool fail_on_error]) returns text
dblink_close(text connname, text cursorname [, bool fail_on_error]) returns text
.fi
.SH "DESCRIPTION"
.PP
\fBdblink_close\fR
closes a cursor previously opened with
\fBdblink_open\fR\&.
.SH "ARGUMENTS"
.PP
\fIconnname\fR
.RS 4
Name of the connection to use; omit this parameter to use the unnamed connection\&.
.RE
.PP
\fIcursorname\fR
.RS 4
The name of the cursor to close\&.
.RE
.PP
\fIfail_on_error\fR
.RS 4
If true (the default when omitted) then an error thrown on the remote side of the connection causes an error to also be thrown locally\&. If false, the remote error is locally reported as a NOTICE, and the function\*(Aqs return value is set to
ERROR\&.
.RE
.SH "RETURN VALUE"
.PP
Returns status, either
OK
or
ERROR\&.
.SH "NOTES"
.PP
If
\fBdblink_open\fR
started an explicit transaction block, and this is the last remaining open cursor in this connection,
\fBdblink_close\fR
will issue the matching
\fBCOMMIT\fR\&.
.SH "EXAMPLES"
.sp
.if n \{\
.RS 4
.\}
.nf
SELECT dblink_connect(\*(Aqdbname=postgres options=\-csearch_path=\*(Aq);
dblink_connect
\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
OK
(1 row)
SELECT dblink_open(\*(Aqfoo\*(Aq, \*(Aqselect proname, prosrc from pg_proc\*(Aq);
dblink_open
\-\-\-\-\-\-\-\-\-\-\-\-\-
OK
(1 row)
SELECT dblink_close(\*(Aqfoo\*(Aq);
dblink_close
\-\-\-\-\-\-\-\-\-\-\-\-\-\-
OK
(1 row)
.fi
.if n \{\
.RE
.\}
man/man3/SPI_cursor_close.3 0000644 00000003332 14751153421 0011462 0 ustar 00 '\" t
.\" Title: SPI_cursor_close
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "SPI_CURSOR_CLOSE" "3" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
SPI_cursor_close \- close a cursor
.SH "SYNOPSIS"
.sp
.nf
void SPI_cursor_close(Portal \fIportal\fR)
.fi
.SH "DESCRIPTION"
.PP
\fBSPI_cursor_close\fR
closes a previously created cursor and releases its portal storage\&.
.PP
All open cursors are closed automatically at the end of a transaction\&.
\fBSPI_cursor_close\fR
need only be invoked if it is desirable to release resources sooner\&.
.SH "ARGUMENTS"
.PP
Portal \fIportal\fR
.RS 4
portal containing the cursor
.RE
man/man3/SPI_getbinval.3 0000644 00000004365 14751153421 0010742 0 ustar 00 '\" t
.\" Title: SPI_getbinval
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "SPI_GETBINVAL" "3" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
SPI_getbinval \- return the binary value of the specified column
.SH "SYNOPSIS"
.sp
.nf
Datum SPI_getbinval(HeapTuple \fIrow\fR, TupleDesc \fIrowdesc\fR, int \fIcolnumber\fR,
bool * \fIisnull\fR)
.fi
.SH "DESCRIPTION"
.PP
\fBSPI_getbinval\fR
returns the value of the specified column in the internal form (as type
Datum)\&.
.PP
This function does not allocate new space for the datum\&. In the case of a pass\-by\-reference data type, the return value will be a pointer into the passed row\&.
.SH "ARGUMENTS"
.PP
HeapTuple \fIrow\fR
.RS 4
input row to be examined
.RE
.PP
TupleDesc \fIrowdesc\fR
.RS 4
input row description
.RE
.PP
int \fIcolnumber\fR
.RS 4
column number (count starts at 1)
.RE
.PP
bool * \fIisnull\fR
.RS 4
flag for a null value in the column
.RE
.SH "RETURN VALUE"
.PP
The binary value of the column is returned\&. The variable pointed to by
\fIisnull\fR
is set to true if the column is null, else to false\&.
.PP
\fISPI_result\fR
is set to
SPI_ERROR_NOATTRIBUTE
on error\&.
man/man3/SPI_scroll_cursor_fetch.3 0000644 00000004570 14751153421 0013031 0 ustar 00 '\" t
.\" Title: SPI_scroll_cursor_fetch
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "SPI_SCROLL_CURSOR_FETCH" "3" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
SPI_scroll_cursor_fetch \- fetch some rows from a cursor
.SH "SYNOPSIS"
.sp
.nf
void SPI_scroll_cursor_fetch(Portal \fIportal\fR, FetchDirection \fIdirection\fR,
long \fIcount\fR)
.fi
.SH "DESCRIPTION"
.PP
\fBSPI_scroll_cursor_fetch\fR
fetches some rows from a cursor\&. This is equivalent to the SQL command
\fBFETCH\fR\&.
.SH "ARGUMENTS"
.PP
Portal \fIportal\fR
.RS 4
portal containing the cursor
.RE
.PP
FetchDirection \fIdirection\fR
.RS 4
one of
FETCH_FORWARD,
FETCH_BACKWARD,
FETCH_ABSOLUTE
or
FETCH_RELATIVE
.RE
.PP
long \fIcount\fR
.RS 4
number of rows to fetch for
FETCH_FORWARD
or
FETCH_BACKWARD; absolute row number to fetch for
FETCH_ABSOLUTE; or relative row number to fetch for
FETCH_RELATIVE
.RE
.SH "RETURN VALUE"
.PP
\fISPI_processed\fR
and
\fISPI_tuptable\fR
are set as in
\fBSPI_execute\fR
if successful\&.
.SH "NOTES"
.PP
See the SQL
\fBFETCH\fR(7)
command for details of the interpretation of the
\fIdirection\fR
and
\fIcount\fR
parameters\&.
.PP
Direction values other than
FETCH_FORWARD
may fail if the cursor\*(Aqs plan was not created with the
CURSOR_OPT_SCROLL
option\&.
man/man3/SPI_execp.3 0000644 00000005233 14751153421 0010066 0 ustar 00 '\" t
.\" Title: SPI_execp
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "SPI_EXECP" "3" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
SPI_execp \- execute a statement in read/write mode
.SH "SYNOPSIS"
.sp
.nf
int SPI_execp(SPIPlanPtr \fIplan\fR, Datum * \fIvalues\fR, const char * \fInulls\fR, long \fIcount\fR)
.fi
.SH "DESCRIPTION"
.PP
\fBSPI_execp\fR
is the same as
\fBSPI_execute_plan\fR, with the latter\*(Aqs
\fIread_only\fR
parameter always taken as
false\&.
.SH "ARGUMENTS"
.PP
SPIPlanPtr \fIplan\fR
.RS 4
prepared statement (returned by
\fBSPI_prepare\fR)
.RE
.PP
Datum * \fIvalues\fR
.RS 4
An array of actual parameter values\&. Must have same length as the statement\*(Aqs number of arguments\&.
.RE
.PP
const char * \fInulls\fR
.RS 4
An array describing which parameters are null\&. Must have same length as the statement\*(Aqs number of arguments\&.
.sp
If
\fInulls\fR
is
NULL
then
\fBSPI_execp\fR
assumes that no parameters are null\&. Otherwise, each entry of the
\fInulls\fR
array should be
\*(Aq\ \&\*(Aq
if the corresponding parameter value is non\-null, or
\*(Aqn\*(Aq
if the corresponding parameter value is null\&. (In the latter case, the actual value in the corresponding
\fIvalues\fR
entry doesn\*(Aqt matter\&.) Note that
\fInulls\fR
is not a text string, just an array: it does not need a
\*(Aq\e0\*(Aq
terminator\&.
.RE
.PP
long \fIcount\fR
.RS 4
maximum number of rows to return, or
0
for no limit
.RE
.SH "RETURN VALUE"
.PP
See
\fBSPI_execute_plan\fR\&.
.PP
\fISPI_processed\fR
and
\fISPI_tuptable\fR
are set as in
\fBSPI_execute\fR
if successful\&.
man/man3/dblink_send_query.3 0000644 00000004515 14751153421 0011752 0 ustar 00 '\" t
.\" Title: dblink_send_query
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "DBLINK_SEND_QUERY" "3" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
dblink_send_query \- sends an async query to a remote database
.SH "SYNOPSIS"
.sp
.nf
dblink_send_query(text connname, text sql) returns int
.fi
.SH "DESCRIPTION"
.PP
\fBdblink_send_query\fR
sends a query to be executed asynchronously, that is, without immediately waiting for the result\&. There must not be an async query already in progress on the connection\&.
.PP
After successfully dispatching an async query, completion status can be checked with
\fBdblink_is_busy\fR, and the results are ultimately collected with
\fBdblink_get_result\fR\&. It is also possible to attempt to cancel an active async query using
\fBdblink_cancel_query\fR\&.
.SH "ARGUMENTS"
.PP
\fIconnname\fR
.RS 4
Name of the connection to use\&.
.RE
.PP
\fIsql\fR
.RS 4
The SQL statement that you wish to execute in the remote database, for example
select * from pg_class\&.
.RE
.SH "RETURN VALUE"
.PP
Returns 1 if the query was successfully dispatched, 0 otherwise\&.
.SH "EXAMPLES"
.sp
.if n \{\
.RS 4
.\}
.nf
SELECT dblink_send_query(\*(Aqdtest1\*(Aq, \*(AqSELECT * FROM foo WHERE f1 < 3\*(Aq);
.fi
.if n \{\
.RE
.\}
man/man3/SPI_prepare_cursor.3 0000644 00000005041 14751153421 0012012 0 ustar 00 '\" t
.\" Title: SPI_prepare_cursor
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "SPI_PREPARE_CURSOR" "3" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
SPI_prepare_cursor \- prepare a statement, without executing it yet
.SH "SYNOPSIS"
.sp
.nf
SPIPlanPtr SPI_prepare_cursor(const char * \fIcommand\fR, int \fInargs\fR,
Oid * \fIargtypes\fR, int \fIcursorOptions\fR)
.fi
.SH "DESCRIPTION"
.PP
\fBSPI_prepare_cursor\fR
is identical to
\fBSPI_prepare\fR, except that it also allows specification of the planner\*(Aqs
\(lqcursor options\(rq
parameter\&. This is a bit mask having the values shown in
nodes/parsenodes\&.h
for the
options
field of
DeclareCursorStmt\&.
\fBSPI_prepare\fR
always takes the cursor options as zero\&.
.SH "ARGUMENTS"
.PP
const char * \fIcommand\fR
.RS 4
command string
.RE
.PP
int \fInargs\fR
.RS 4
number of input parameters ($1,
$2, etc\&.)
.RE
.PP
Oid * \fIargtypes\fR
.RS 4
pointer to an array containing the
OIDs of the data types of the parameters
.RE
.PP
int \fIcursorOptions\fR
.RS 4
integer bit mask of cursor options; zero produces default behavior
.RE
.SH "RETURN VALUE"
.PP
\fBSPI_prepare_cursor\fR
has the same return conventions as
\fBSPI_prepare\fR\&.
.SH "NOTES"
.PP
Useful bits to set in
\fIcursorOptions\fR
include
CURSOR_OPT_SCROLL,
CURSOR_OPT_NO_SCROLL,
CURSOR_OPT_FAST_PLAN,
CURSOR_OPT_GENERIC_PLAN, and
CURSOR_OPT_CUSTOM_PLAN\&. Note in particular that
CURSOR_OPT_HOLD
is ignored\&.
man/man3/SPI_gettypeid.3 0000644 00000003461 14751153421 0010761 0 ustar 00 '\" t
.\" Title: SPI_gettypeid
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "SPI_GETTYPEID" "3" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
SPI_gettypeid \- return the data type OID of the specified column
.SH "SYNOPSIS"
.sp
.nf
Oid SPI_gettypeid(TupleDesc \fIrowdesc\fR, int \fIcolnumber\fR)
.fi
.SH "DESCRIPTION"
.PP
\fBSPI_gettypeid\fR
returns the
OID
of the data type of the specified column\&.
.SH "ARGUMENTS"
.PP
TupleDesc \fIrowdesc\fR
.RS 4
input row description
.RE
.PP
int \fIcolnumber\fR
.RS 4
column number (count starts at 1)
.RE
.SH "RETURN VALUE"
.PP
The
OID
of the data type of the specified column or
InvalidOid
on error\&. On error,
\fISPI_result\fR
is set to
SPI_ERROR_NOATTRIBUTE\&.
man/man3/dblink.3 0000644 00000014772 14751153421 0007522 0 ustar 00 '\" t
.\" Title: dblink
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "DBLINK" "3" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
dblink \- executes a query in a remote database
.SH "SYNOPSIS"
.sp
.nf
dblink(text connname, text sql [, bool fail_on_error]) returns setof record
dblink(text connstr, text sql [, bool fail_on_error]) returns setof record
dblink(text sql [, bool fail_on_error]) returns setof record
.fi
.SH "DESCRIPTION"
.PP
\fBdblink\fR
executes a query (usually a
\fBSELECT\fR, but it can be any SQL statement that returns rows) in a remote database\&.
.PP
When two
text
arguments are given, the first one is first looked up as a persistent connection\*(Aqs name; if found, the command is executed on that connection\&. If not found, the first argument is treated as a connection info string as for
\fBdblink_connect\fR, and the indicated connection is made just for the duration of this command\&.
.SH "ARGUMENTS"
.PP
\fIconnname\fR
.RS 4
Name of the connection to use; omit this parameter to use the unnamed connection\&.
.RE
.PP
\fIconnstr\fR
.RS 4
A connection info string, as previously described for
\fBdblink_connect\fR\&.
.RE
.PP
\fIsql\fR
.RS 4
The SQL query that you wish to execute in the remote database, for example
select * from foo\&.
.RE
.PP
\fIfail_on_error\fR
.RS 4
If true (the default when omitted) then an error thrown on the remote side of the connection causes an error to also be thrown locally\&. If false, the remote error is locally reported as a NOTICE, and the function returns no rows\&.
.RE
.SH "RETURN VALUE"
.PP
The function returns the row(s) produced by the query\&. Since
\fBdblink\fR
can be used with any query, it is declared to return
record, rather than specifying any particular set of columns\&. This means that you must specify the expected set of columns in the calling query \(em otherwise
PostgreSQL
would not know what to expect\&. Here is an example:
.sp
.if n \{\
.RS 4
.\}
.nf
SELECT *
FROM dblink(\*(Aqdbname=mydb options=\-csearch_path=\*(Aq,
\*(Aqselect proname, prosrc from pg_proc\*(Aq)
AS t1(proname name, prosrc text)
WHERE proname LIKE \*(Aqbytea%\*(Aq;
.fi
.if n \{\
.RE
.\}
.sp
The
\(lqalias\(rq
part of the
FROM
clause must specify the column names and types that the function will return\&. (Specifying column names in an alias is actually standard SQL syntax, but specifying column types is a
PostgreSQL
extension\&.) This allows the system to understand what
*
should expand to, and what
proname
in the
WHERE
clause refers to, in advance of trying to execute the function\&. At run time, an error will be thrown if the actual query result from the remote database does not have the same number of columns shown in the
FROM
clause\&. The column names need not match, however, and
\fBdblink\fR
does not insist on exact type matches either\&. It will succeed so long as the returned data strings are valid input for the column type declared in the
FROM
clause\&.
.SH "NOTES"
.PP
A convenient way to use
\fBdblink\fR
with predetermined queries is to create a view\&. This allows the column type information to be buried in the view, instead of having to spell it out in every query\&. For example,
.sp
.if n \{\
.RS 4
.\}
.nf
CREATE VIEW myremote_pg_proc AS
SELECT *
FROM dblink(\*(Aqdbname=postgres options=\-csearch_path=\*(Aq,
\*(Aqselect proname, prosrc from pg_proc\*(Aq)
AS t1(proname name, prosrc text);
SELECT * FROM myremote_pg_proc WHERE proname LIKE \*(Aqbytea%\*(Aq;
.fi
.if n \{\
.RE
.\}
.SH "EXAMPLES"
.sp
.if n \{\
.RS 4
.\}
.nf
SELECT * FROM dblink(\*(Aqdbname=postgres options=\-csearch_path=\*(Aq,
\*(Aqselect proname, prosrc from pg_proc\*(Aq)
AS t1(proname name, prosrc text) WHERE proname LIKE \*(Aqbytea%\*(Aq;
proname | prosrc
\-\-\-\-\-\-\-\-\-\-\-\-+\-\-\-\-\-\-\-\-\-\-\-\-
byteacat | byteacat
byteaeq | byteaeq
bytealt | bytealt
byteale | byteale
byteagt | byteagt
byteage | byteage
byteane | byteane
byteacmp | byteacmp
bytealike | bytealike
byteanlike | byteanlike
byteain | byteain
byteaout | byteaout
(12 rows)
SELECT dblink_connect(\*(Aqdbname=postgres options=\-csearch_path=\*(Aq);
dblink_connect
\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
OK
(1 row)
SELECT * FROM dblink(\*(Aqselect proname, prosrc from pg_proc\*(Aq)
AS t1(proname name, prosrc text) WHERE proname LIKE \*(Aqbytea%\*(Aq;
proname | prosrc
\-\-\-\-\-\-\-\-\-\-\-\-+\-\-\-\-\-\-\-\-\-\-\-\-
byteacat | byteacat
byteaeq | byteaeq
bytealt | bytealt
byteale | byteale
byteagt | byteagt
byteage | byteage
byteane | byteane
byteacmp | byteacmp
bytealike | bytealike
byteanlike | byteanlike
byteain | byteain
byteaout | byteaout
(12 rows)
SELECT dblink_connect(\*(Aqmyconn\*(Aq, \*(Aqdbname=regression options=\-csearch_path=\*(Aq);
dblink_connect
\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
OK
(1 row)
SELECT * FROM dblink(\*(Aqmyconn\*(Aq, \*(Aqselect proname, prosrc from pg_proc\*(Aq)
AS t1(proname name, prosrc text) WHERE proname LIKE \*(Aqbytea%\*(Aq;
proname | prosrc
\-\-\-\-\-\-\-\-\-\-\-\-+\-\-\-\-\-\-\-\-\-\-\-\-
bytearecv | bytearecv
byteasend | byteasend
byteale | byteale
byteagt | byteagt
byteage | byteage
byteane | byteane
byteacmp | byteacmp
bytealike | bytealike
byteanlike | byteanlike
byteacat | byteacat
byteaeq | byteaeq
bytealt | bytealt
byteain | byteain
byteaout | byteaout
(14 rows)
.fi
.if n \{\
.RE
.\}
man/man3/SPI_gettype.3 0000644 00000003603 14751153421 0010442 0 ustar 00 '\" t
.\" Title: SPI_gettype
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "SPI_GETTYPE" "3" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
SPI_gettype \- return the data type name of the specified column
.SH "SYNOPSIS"
.sp
.nf
char * SPI_gettype(TupleDesc \fIrowdesc\fR, int \fIcolnumber\fR)
.fi
.SH "DESCRIPTION"
.PP
\fBSPI_gettype\fR
returns a copy of the data type name of the specified column\&. (You can use
\fBpfree\fR
to release the copy of the name when you don\*(Aqt need it anymore\&.)
.SH "ARGUMENTS"
.PP
TupleDesc \fIrowdesc\fR
.RS 4
input row description
.RE
.PP
int \fIcolnumber\fR
.RS 4
column number (count starts at 1)
.RE
.SH "RETURN VALUE"
.PP
The data type name of the specified column, or
NULL
on error\&.
\fISPI_result\fR
is set to
SPI_ERROR_NOATTRIBUTE
on error\&.
man/man3/SPI_palloc.3 0000644 00000003150 14751153421 0010230 0 ustar 00 '\" t
.\" Title: SPI_palloc
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "SPI_PALLOC" "3" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
SPI_palloc \- allocate memory in the upper executor context
.SH "SYNOPSIS"
.sp
.nf
void * SPI_palloc(Size \fIsize\fR)
.fi
.SH "DESCRIPTION"
.PP
\fBSPI_palloc\fR
allocates memory in the upper executor context\&.
.SH "ARGUMENTS"
.PP
Size \fIsize\fR
.RS 4
size in bytes of storage to allocate
.RE
.SH "RETURN VALUE"
.PP
pointer to new storage space of the specified size
man/man3/SPI_cursor_open.3 0000644 00000006775 14751153421 0011334 0 ustar 00 '\" t
.\" Title: SPI_cursor_open
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "SPI_CURSOR_OPEN" "3" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
SPI_cursor_open \- set up a cursor using a statement created with \fBSPI_prepare\fR
.SH "SYNOPSIS"
.sp
.nf
Portal SPI_cursor_open(const char * \fIname\fR, SPIPlanPtr \fIplan\fR,
Datum * \fIvalues\fR, const char * \fInulls\fR,
bool \fIread_only\fR)
.fi
.SH "DESCRIPTION"
.PP
\fBSPI_cursor_open\fR
sets up a cursor (internally, a portal) that will execute a statement prepared by
\fBSPI_prepare\fR\&. The parameters have the same meanings as the corresponding parameters to
\fBSPI_execute_plan\fR\&.
.PP
Using a cursor instead of executing the statement directly has two benefits\&. First, the result rows can be retrieved a few at a time, avoiding memory overrun for queries that return many rows\&. Second, a portal can outlive the current procedure (it can, in fact, live to the end of the current transaction)\&. Returning the portal name to the procedure\*(Aqs caller provides a way of returning a row set as result\&.
.PP
The passed\-in parameter data will be copied into the cursor\*(Aqs portal, so it can be freed while the cursor still exists\&.
.SH "ARGUMENTS"
.PP
const char * \fIname\fR
.RS 4
name for portal, or
NULL
to let the system select a name
.RE
.PP
SPIPlanPtr \fIplan\fR
.RS 4
prepared statement (returned by
\fBSPI_prepare\fR)
.RE
.PP
Datum * \fIvalues\fR
.RS 4
An array of actual parameter values\&. Must have same length as the statement\*(Aqs number of arguments\&.
.RE
.PP
const char * \fInulls\fR
.RS 4
An array describing which parameters are null\&. Must have same length as the statement\*(Aqs number of arguments\&.
.sp
If
\fInulls\fR
is
NULL
then
\fBSPI_cursor_open\fR
assumes that no parameters are null\&. Otherwise, each entry of the
\fInulls\fR
array should be
\*(Aq\ \&\*(Aq
if the corresponding parameter value is non\-null, or
\*(Aqn\*(Aq
if the corresponding parameter value is null\&. (In the latter case, the actual value in the corresponding
\fIvalues\fR
entry doesn\*(Aqt matter\&.) Note that
\fInulls\fR
is not a text string, just an array: it does not need a
\*(Aq\e0\*(Aq
terminator\&.
.RE
.PP
bool \fIread_only\fR
.RS 4
true
for read\-only execution
.RE
.SH "RETURN VALUE"
.PP
Pointer to portal containing the cursor\&. Note there is no error return convention; any error will be reported via
\fBelog\fR\&.
man/man3/dblink_get_connections.3 0000644 00000003323 14751153421 0012751 0 ustar 00 '\" t
.\" Title: dblink_get_connections
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "DBLINK_GET_CONNECTIONS" "3" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
dblink_get_connections \- returns the names of all open named dblink connections
.SH "SYNOPSIS"
.sp
.nf
dblink_get_connections() returns text[]
.fi
.SH "DESCRIPTION"
.PP
\fBdblink_get_connections\fR
returns an array of the names of all open named
dblink
connections\&.
.SH "RETURN VALUE"
.PP
Returns a text array of connection names, or NULL if none\&.
.SH "EXAMPLES"
.sp
.if n \{\
.RS 4
.\}
.nf
SELECT dblink_get_connections();
.fi
.if n \{\
.RE
.\}
man/man3/dblink_build_sql_delete.3 0000644 00000006416 14751153421 0013076 0 ustar 00 '\" t
.\" Title: dblink_build_sql_delete
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "DBLINK_BUILD_SQL_DELETE" "3" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
dblink_build_sql_delete \- builds a DELETE statement using supplied values for primary key field values
.SH "SYNOPSIS"
.sp
.nf
dblink_build_sql_delete(text relname,
int2vector primary_key_attnums,
integer num_primary_key_atts,
text[] tgt_pk_att_vals_array) returns text
.fi
.SH "DESCRIPTION"
.PP
\fBdblink_build_sql_delete\fR
can be useful in doing selective replication of a local table to a remote database\&. It builds a SQL
\fBDELETE\fR
command that will delete the row with the given primary key values\&.
.SH "ARGUMENTS"
.PP
\fIrelname\fR
.RS 4
Name of a local relation, for example
foo
or
myschema\&.mytab\&. Include double quotes if the name is mixed\-case or contains special characters, for example
"FooBar"; without quotes, the string will be folded to lower case\&.
.RE
.PP
\fIprimary_key_attnums\fR
.RS 4
Attribute numbers (1\-based) of the primary key fields, for example
1 2\&.
.RE
.PP
\fInum_primary_key_atts\fR
.RS 4
The number of primary key fields\&.
.RE
.PP
\fItgt_pk_att_vals_array\fR
.RS 4
Values of the primary key fields to be used in the resulting
\fBDELETE\fR
command\&. Each field is represented in text form\&.
.RE
.SH "RETURN VALUE"
.PP
Returns the requested SQL statement as text\&.
.SH "NOTES"
.PP
As of
PostgreSQL
9\&.0, the attribute numbers in
\fIprimary_key_attnums\fR
are interpreted as logical column numbers, corresponding to the column\*(Aqs position in
SELECT * FROM relname\&. Previous versions interpreted the numbers as physical column positions\&. There is a difference if any column(s) to the left of the indicated column have been dropped during the lifetime of the table\&.
.SH "EXAMPLES"
.sp
.if n \{\
.RS 4
.\}
.nf
SELECT dblink_build_sql_delete(\*(Aq"MyFoo"\*(Aq, \*(Aq1 2\*(Aq, 2, \*(Aq{"1", "b"}\*(Aq);
dblink_build_sql_delete
\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
DELETE FROM "MyFoo" WHERE f1=\*(Aq1\*(Aq AND f2=\*(Aqb\*(Aq
(1 row)
.fi
.if n \{\
.RE
.\}
man/man3/SPI_execute.3 0000644 00000017562 14751153421 0010434 0 ustar 00 '\" t
.\" Title: SPI_execute
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "SPI_EXECUTE" "3" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
SPI_execute \- execute a command
.SH "SYNOPSIS"
.sp
.nf
int SPI_execute(const char * \fIcommand\fR, bool \fIread_only\fR, long \fIcount\fR)
.fi
.SH "DESCRIPTION"
.PP
\fBSPI_execute\fR
executes the specified SQL command for
\fIcount\fR
rows\&. If
\fIread_only\fR
is
true, the command must be read\-only, and execution overhead is somewhat reduced\&.
.PP
This function can only be called from a connected procedure\&.
.PP
If
\fIcount\fR
is zero then the command is executed for all rows that it applies to\&. If
\fIcount\fR
is greater than zero, then no more than
\fIcount\fR
rows will be retrieved; execution stops when the count is reached, much like adding a
LIMIT
clause to the query\&. For example,
.sp
.if n \{\
.RS 4
.\}
.nf
SPI_execute("SELECT * FROM foo", true, 5);
.fi
.if n \{\
.RE
.\}
.sp
will retrieve at most 5 rows from the table\&. Note that such a limit is only effective when the command actually returns rows\&. For example,
.sp
.if n \{\
.RS 4
.\}
.nf
SPI_execute("INSERT INTO foo SELECT * FROM bar", false, 5);
.fi
.if n \{\
.RE
.\}
.sp
inserts all rows from
bar, ignoring the
\fIcount\fR
parameter\&. However, with
.sp
.if n \{\
.RS 4
.\}
.nf
SPI_execute("INSERT INTO foo SELECT * FROM bar RETURNING *", false, 5);
.fi
.if n \{\
.RE
.\}
.sp
at most 5 rows would be inserted, since execution would stop after the fifth
RETURNING
result row is retrieved\&.
.PP
You can pass multiple commands in one string;
\fBSPI_execute\fR
returns the result for the command executed last\&. The
\fIcount\fR
limit applies to each command separately (even though only the last result will actually be returned)\&. The limit is not applied to any hidden commands generated by rules\&.
.PP
When
\fIread_only\fR
is
false,
\fBSPI_execute\fR
increments the command counter and computes a new
snapshot
before executing each command in the string\&. The snapshot does not actually change if the current transaction isolation level is
SERIALIZABLE
or
REPEATABLE READ, but in
READ COMMITTED
mode the snapshot update allows each command to see the results of newly committed transactions from other sessions\&. This is essential for consistent behavior when the commands are modifying the database\&.
.PP
When
\fIread_only\fR
is
true,
\fBSPI_execute\fR
does not update either the snapshot or the command counter, and it allows only plain
\fBSELECT\fR
commands to appear in the command string\&. The commands are executed using the snapshot previously established for the surrounding query\&. This execution mode is somewhat faster than the read/write mode due to eliminating per\-command overhead\&. It also allows genuinely
stable
functions to be built: since successive executions will all use the same snapshot, there will be no change in the results\&.
.PP
It is generally unwise to mix read\-only and read\-write commands within a single function using SPI; that could result in very confusing behavior, since the read\-only queries would not see the results of any database updates done by the read\-write queries\&.
.PP
The actual number of rows for which the (last) command was executed is returned in the global variable
\fISPI_processed\fR\&. If the return value of the function is
SPI_OK_SELECT,
SPI_OK_INSERT_RETURNING,
SPI_OK_DELETE_RETURNING, or
SPI_OK_UPDATE_RETURNING, then you can use the global pointer
SPITupleTable *SPI_tuptable
to access the result rows\&. Some utility commands (such as
\fBEXPLAIN\fR) also return row sets, and
SPI_tuptable
will contain the result in these cases too\&. Some utility commands (\fBCOPY\fR,
\fBCREATE TABLE AS\fR) don\*(Aqt return a row set, so
SPI_tuptable
is NULL, but they still return the number of rows processed in
\fISPI_processed\fR\&.
.PP
The structure
SPITupleTable
is defined thus:
.sp
.if n \{\
.RS 4
.\}
.nf
typedef struct
{
MemoryContext tuptabcxt; /* memory context of result table */
uint64 alloced; /* number of alloced vals */
uint64 free; /* number of free vals */
TupleDesc tupdesc; /* row descriptor */
HeapTuple *vals; /* rows */
} SPITupleTable;
.fi
.if n \{\
.RE
.\}
.sp
vals
is an array of pointers to rows\&. (The number of valid entries is given by
\fISPI_processed\fR\&.)
tupdesc
is a row descriptor which you can pass to SPI functions dealing with rows\&.
tuptabcxt,
alloced, and
free
are internal fields not intended for use by SPI callers\&.
.PP
\fBSPI_finish\fR
frees all
SPITupleTables allocated during the current procedure\&. You can free a particular result table earlier, if you are done with it, by calling
\fBSPI_freetuptable\fR\&.
.SH "ARGUMENTS"
.PP
const char * \fIcommand\fR
.RS 4
string containing command to execute
.RE
.PP
bool \fIread_only\fR
.RS 4
true
for read\-only execution
.RE
.PP
long \fIcount\fR
.RS 4
maximum number of rows to return, or
0
for no limit
.RE
.SH "RETURN VALUE"
.PP
If the execution of the command was successful then one of the following (nonnegative) values will be returned:
.PP
SPI_OK_SELECT
.RS 4
if a
\fBSELECT\fR
(but not
\fBSELECT INTO\fR) was executed
.RE
.PP
SPI_OK_SELINTO
.RS 4
if a
\fBSELECT INTO\fR
was executed
.RE
.PP
SPI_OK_INSERT
.RS 4
if an
\fBINSERT\fR
was executed
.RE
.PP
SPI_OK_DELETE
.RS 4
if a
\fBDELETE\fR
was executed
.RE
.PP
SPI_OK_UPDATE
.RS 4
if an
\fBUPDATE\fR
was executed
.RE
.PP
SPI_OK_INSERT_RETURNING
.RS 4
if an
\fBINSERT RETURNING\fR
was executed
.RE
.PP
SPI_OK_DELETE_RETURNING
.RS 4
if a
\fBDELETE RETURNING\fR
was executed
.RE
.PP
SPI_OK_UPDATE_RETURNING
.RS 4
if an
\fBUPDATE RETURNING\fR
was executed
.RE
.PP
SPI_OK_UTILITY
.RS 4
if a utility command (e\&.g\&.,
\fBCREATE TABLE\fR) was executed
.RE
.PP
SPI_OK_REWRITTEN
.RS 4
if the command was rewritten into another kind of command (e\&.g\&.,
\fBUPDATE\fR
became an
\fBINSERT\fR) by a
rule\&.
.RE
.PP
On error, one of the following negative values is returned:
.PP
SPI_ERROR_ARGUMENT
.RS 4
if
\fIcommand\fR
is
NULL
or
\fIcount\fR
is less than 0
.RE
.PP
SPI_ERROR_COPY
.RS 4
if
\fBCOPY TO stdout\fR
or
\fBCOPY FROM stdin\fR
was attempted
.RE
.PP
SPI_ERROR_TRANSACTION
.RS 4
if a transaction manipulation command was attempted (\fBBEGIN\fR,
\fBCOMMIT\fR,
\fBROLLBACK\fR,
\fBSAVEPOINT\fR,
\fBPREPARE TRANSACTION\fR,
\fBCOMMIT PREPARED\fR,
\fBROLLBACK PREPARED\fR, or any variant thereof)
.RE
.PP
SPI_ERROR_OPUNKNOWN
.RS 4
if the command type is unknown (shouldn\*(Aqt happen)
.RE
.PP
SPI_ERROR_UNCONNECTED
.RS 4
if called from an unconnected procedure
.RE
.SH "NOTES"
.PP
All SPI query\-execution functions set both
\fISPI_processed\fR
and
\fISPI_tuptable\fR
(just the pointer, not the contents of the structure)\&. Save these two global variables into local procedure variables if you need to access the result table of
\fBSPI_execute\fR
or another query\-execution function across later calls\&.
man/man3/dblink_get_result.3 0000644 00000011571 14751153421 0011751 0 ustar 00 '\" t
.\" Title: dblink_get_result
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "DBLINK_GET_RESULT" "3" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
dblink_get_result \- gets an async query result
.SH "SYNOPSIS"
.sp
.nf
dblink_get_result(text connname [, bool fail_on_error]) returns setof record
.fi
.SH "DESCRIPTION"
.PP
\fBdblink_get_result\fR
collects the results of an asynchronous query previously sent with
\fBdblink_send_query\fR\&. If the query is not already completed,
\fBdblink_get_result\fR
will wait until it is\&.
.SH "ARGUMENTS"
.PP
\fIconnname\fR
.RS 4
Name of the connection to use\&.
.RE
.PP
\fIfail_on_error\fR
.RS 4
If true (the default when omitted) then an error thrown on the remote side of the connection causes an error to also be thrown locally\&. If false, the remote error is locally reported as a NOTICE, and the function returns no rows\&.
.RE
.SH "RETURN VALUE"
.PP
For an async query (that is, a SQL statement returning rows), the function returns the row(s) produced by the query\&. To use this function, you will need to specify the expected set of columns, as previously discussed for
\fBdblink\fR\&.
.PP
For an async command (that is, a SQL statement not returning rows), the function returns a single row with a single text column containing the command\*(Aqs status string\&. It is still necessary to specify that the result will have a single text column in the calling
FROM
clause\&.
.SH "NOTES"
.PP
This function
\fImust\fR
be called if
\fBdblink_send_query\fR
returned 1\&. It must be called once for each query sent, and one additional time to obtain an empty set result, before the connection can be used again\&.
.PP
When using
\fBdblink_send_query\fR
and
\fBdblink_get_result\fR,
dblink
fetches the entire remote query result before returning any of it to the local query processor\&. If the query returns a large number of rows, this can result in transient memory bloat in the local session\&. It may be better to open such a query as a cursor with
\fBdblink_open\fR
and then fetch a manageable number of rows at a time\&. Alternatively, use plain
\fBdblink()\fR, which avoids memory bloat by spooling large result sets to disk\&.
.SH "EXAMPLES"
.sp
.if n \{\
.RS 4
.\}
.nf
contrib_regression=# SELECT dblink_connect(\*(Aqdtest1\*(Aq, \*(Aqdbname=contrib_regression\*(Aq);
dblink_connect
\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
OK
(1 row)
contrib_regression=# SELECT * FROM
contrib_regression\-# dblink_send_query(\*(Aqdtest1\*(Aq, \*(Aqselect * from foo where f1 < 3\*(Aq) AS t1;
t1
\-\-\-\-
1
(1 row)
contrib_regression=# SELECT * FROM dblink_get_result(\*(Aqdtest1\*(Aq) AS t1(f1 int, f2 text, f3 text[]);
f1 | f2 | f3
\-\-\-\-+\-\-\-\-+\-\-\-\-\-\-\-\-\-\-\-\-
0 | a | {a0,b0,c0}
1 | b | {a1,b1,c1}
2 | c | {a2,b2,c2}
(3 rows)
contrib_regression=# SELECT * FROM dblink_get_result(\*(Aqdtest1\*(Aq) AS t1(f1 int, f2 text, f3 text[]);
f1 | f2 | f3
\-\-\-\-+\-\-\-\-+\-\-\-\-
(0 rows)
contrib_regression=# SELECT * FROM
contrib_regression\-# dblink_send_query(\*(Aqdtest1\*(Aq, \*(Aqselect * from foo where f1 < 3; select * from foo where f1 > 6\*(Aq) AS t1;
t1
\-\-\-\-
1
(1 row)
contrib_regression=# SELECT * FROM dblink_get_result(\*(Aqdtest1\*(Aq) AS t1(f1 int, f2 text, f3 text[]);
f1 | f2 | f3
\-\-\-\-+\-\-\-\-+\-\-\-\-\-\-\-\-\-\-\-\-
0 | a | {a0,b0,c0}
1 | b | {a1,b1,c1}
2 | c | {a2,b2,c2}
(3 rows)
contrib_regression=# SELECT * FROM dblink_get_result(\*(Aqdtest1\*(Aq) AS t1(f1 int, f2 text, f3 text[]);
f1 | f2 | f3
\-\-\-\-+\-\-\-\-+\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
7 | h | {a7,b7,c7}
8 | i | {a8,b8,c8}
9 | j | {a9,b9,c9}
10 | k | {a10,b10,c10}
(4 rows)
contrib_regression=# SELECT * FROM dblink_get_result(\*(Aqdtest1\*(Aq) AS t1(f1 int, f2 text, f3 text[]);
f1 | f2 | f3
\-\-\-\-+\-\-\-\-+\-\-\-\-
(0 rows)
.fi
.if n \{\
.RE
.\}
man/man3/SPI_getrelname.3 0000644 00000003301 14751153421 0011077 0 ustar 00 '\" t
.\" Title: SPI_getrelname
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "SPI_GETRELNAME" "3" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
SPI_getrelname \- return the name of the specified relation
.SH "SYNOPSIS"
.sp
.nf
char * SPI_getrelname(Relation \fIrel\fR)
.fi
.SH "DESCRIPTION"
.PP
\fBSPI_getrelname\fR
returns a copy of the name of the specified relation\&. (You can use
\fBpfree\fR
to release the copy of the name when you don\*(Aqt need it anymore\&.)
.SH "ARGUMENTS"
.PP
Relation \fIrel\fR
.RS 4
input relation
.RE
.SH "RETURN VALUE"
.PP
The name of the specified relation\&.
man/man3/SPI_is_cursor_plan.3 0000644 00000004527 14751153421 0012011 0 ustar 00 '\" t
.\" Title: SPI_is_cursor_plan
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "SPI_IS_CURSOR_PLAN" "3" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
SPI_is_cursor_plan \- return true if a statement prepared by \fBSPI_prepare\fR can be used with \fBSPI_cursor_open\fR
.SH "SYNOPSIS"
.sp
.nf
bool SPI_is_cursor_plan(SPIPlanPtr \fIplan\fR)
.fi
.SH "DESCRIPTION"
.PP
\fBSPI_is_cursor_plan\fR
returns
true
if a statement prepared by
\fBSPI_prepare\fR
can be passed as an argument to
\fBSPI_cursor_open\fR, or
false
if that is not the case\&. The criteria are that the
\fIplan\fR
represents one single command and that this command returns tuples to the caller; for example,
\fBSELECT\fR
is allowed unless it contains an
INTO
clause, and
\fBUPDATE\fR
is allowed only if it contains a
RETURNING
clause\&.
.SH "ARGUMENTS"
.PP
SPIPlanPtr \fIplan\fR
.RS 4
prepared statement (returned by
\fBSPI_prepare\fR)
.RE
.SH "RETURN VALUE"
.PP
true
or
false
to indicate if the
\fIplan\fR
can produce a cursor or not, with
\fISPI_result\fR
set to zero\&. If it is not possible to determine the answer (for example, if the
\fIplan\fR
is
NULL
or invalid, or if called when not connected to SPI), then
\fISPI_result\fR
is set to a suitable error code and
false
is returned\&.
man/man3/SPI_getargtypeid.3 0000644 00000004142 14751153421 0011450 0 ustar 00 '\" t
.\" Title: SPI_getargtypeid
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "SPI_GETARGTYPEID" "3" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
SPI_getargtypeid \- return the data type OID for an argument of a statement prepared by \fBSPI_prepare\fR
.SH "SYNOPSIS"
.sp
.nf
Oid SPI_getargtypeid(SPIPlanPtr \fIplan\fR, int \fIargIndex\fR)
.fi
.SH "DESCRIPTION"
.PP
\fBSPI_getargtypeid\fR
returns the OID representing the type for the
\fIargIndex\fR\*(Aqth argument of a statement prepared by
\fBSPI_prepare\fR\&. First argument is at index zero\&.
.SH "ARGUMENTS"
.PP
SPIPlanPtr \fIplan\fR
.RS 4
prepared statement (returned by
\fBSPI_prepare\fR)
.RE
.PP
int \fIargIndex\fR
.RS 4
zero based index of the argument
.RE
.SH "RETURN VALUE"
.PP
The type OID of the argument at the given index\&. If the
\fIplan\fR
is
NULL
or invalid, or
\fIargIndex\fR
is less than 0 or not less than the number of arguments declared for the
\fIplan\fR,
\fISPI_result\fR
is set to
SPI_ERROR_ARGUMENT
and
InvalidOid
is returned\&.
man/man3/SPI_getvalue.3 0000644 00000004166 14751153421 0010602 0 ustar 00 '\" t
.\" Title: SPI_getvalue
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "SPI_GETVALUE" "3" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
SPI_getvalue \- return the string value of the specified column
.SH "SYNOPSIS"
.sp
.nf
char * SPI_getvalue(HeapTuple \fIrow\fR, TupleDesc \fIrowdesc\fR, int \fIcolnumber\fR)
.fi
.SH "DESCRIPTION"
.PP
\fBSPI_getvalue\fR
returns the string representation of the value of the specified column\&.
.PP
The result is returned in memory allocated using
\fBpalloc\fR\&. (You can use
\fBpfree\fR
to release the memory when you don\*(Aqt need it anymore\&.)
.SH "ARGUMENTS"
.PP
HeapTuple \fIrow\fR
.RS 4
input row to be examined
.RE
.PP
TupleDesc \fIrowdesc\fR
.RS 4
input row description
.RE
.PP
int \fIcolnumber\fR
.RS 4
column number (count starts at 1)
.RE
.SH "RETURN VALUE"
.PP
Column value, or
NULL
if the column is null,
\fIcolnumber\fR
is out of range (\fISPI_result\fR
is set to
SPI_ERROR_NOATTRIBUTE), or no output function is available (\fISPI_result\fR
is set to
SPI_ERROR_NOOUTFUNC)\&.
man/man3/SPI_connect.3 0000644 00000004274 14751153421 0010417 0 ustar 00 '\" t
.\" Title: SPI_connect
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "SPI_CONNECT" "3" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
SPI_connect \- connect a procedure to the SPI manager
.SH "SYNOPSIS"
.sp
.nf
int SPI_connect(void)
.fi
.SH "DESCRIPTION"
.PP
\fBSPI_connect\fR
opens a connection from a procedure invocation to the SPI manager\&. You must call this function if you want to execute commands through SPI\&. Some utility SPI functions can be called from unconnected procedures\&.
.PP
If your procedure is already connected,
\fBSPI_connect\fR
will return the error code
SPI_ERROR_CONNECT\&. This could happen if a procedure that has called
\fBSPI_connect\fR
directly calls another procedure that calls
\fBSPI_connect\fR\&. While recursive calls to the
SPI
manager are permitted when an SQL command called through SPI invokes another function that uses
SPI, directly nested calls to
\fBSPI_connect\fR
and
\fBSPI_finish\fR
are forbidden\&. (But see
\fBSPI_push\fR
and
\fBSPI_pop\fR\&.)
.SH "RETURN VALUE"
.PP
SPI_OK_CONNECT
.RS 4
on success
.RE
.PP
SPI_ERROR_CONNECT
.RS 4
on error
.RE
man/man3/SPI_cursor_open_with_args.3 0000644 00000007425 14751153421 0013374 0 ustar 00 '\" t
.\" Title: SPI_cursor_open_with_args
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "SPI_CURSOR_OPEN_WITH_ARGS" "3" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
SPI_cursor_open_with_args \- set up a cursor using a query and parameters
.SH "SYNOPSIS"
.sp
.nf
Portal SPI_cursor_open_with_args(const char *\fIname\fR,
const char *\fIcommand\fR,
int \fInargs\fR, Oid *\fIargtypes\fR,
Datum *\fIvalues\fR, const char *\fInulls\fR,
bool \fIread_only\fR, int \fIcursorOptions\fR)
.fi
.SH "DESCRIPTION"
.PP
\fBSPI_cursor_open_with_args\fR
sets up a cursor (internally, a portal) that will execute the specified query\&. Most of the parameters have the same meanings as the corresponding parameters to
\fBSPI_prepare_cursor\fR
and
\fBSPI_cursor_open\fR\&.
.PP
For one\-time query execution, this function should be preferred over
\fBSPI_prepare_cursor\fR
followed by
\fBSPI_cursor_open\fR\&. If the same command is to be executed with many different parameters, either method might be faster, depending on the cost of re\-planning versus the benefit of custom plans\&.
.PP
The passed\-in parameter data will be copied into the cursor\*(Aqs portal, so it can be freed while the cursor still exists\&.
.SH "ARGUMENTS"
.PP
const char * \fIname\fR
.RS 4
name for portal, or
NULL
to let the system select a name
.RE
.PP
const char * \fIcommand\fR
.RS 4
command string
.RE
.PP
int \fInargs\fR
.RS 4
number of input parameters ($1,
$2, etc\&.)
.RE
.PP
Oid * \fIargtypes\fR
.RS 4
an array of length
\fInargs\fR, containing the
OIDs of the data types of the parameters
.RE
.PP
Datum * \fIvalues\fR
.RS 4
an array of length
\fInargs\fR, containing the actual parameter values
.RE
.PP
const char * \fInulls\fR
.RS 4
an array of length
\fInargs\fR, describing which parameters are null
.sp
If
\fInulls\fR
is
NULL
then
\fBSPI_cursor_open_with_args\fR
assumes that no parameters are null\&. Otherwise, each entry of the
\fInulls\fR
array should be
\*(Aq\ \&\*(Aq
if the corresponding parameter value is non\-null, or
\*(Aqn\*(Aq
if the corresponding parameter value is null\&. (In the latter case, the actual value in the corresponding
\fIvalues\fR
entry doesn\*(Aqt matter\&.) Note that
\fInulls\fR
is not a text string, just an array: it does not need a
\*(Aq\e0\*(Aq
terminator\&.
.RE
.PP
bool \fIread_only\fR
.RS 4
true
for read\-only execution
.RE
.PP
int \fIcursorOptions\fR
.RS 4
integer bit mask of cursor options; zero produces default behavior
.RE
.SH "RETURN VALUE"
.PP
Pointer to portal containing the cursor\&. Note there is no error return convention; any error will be reported via
\fBelog\fR\&.
man/man3/dblink_connect_u.3 0000644 00000005361 14751153421 0011551 0 ustar 00 '\" t
.\" Title: dblink_connect_u
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "DBLINK_CONNECT_U" "3" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
dblink_connect_u \- opens a persistent connection to a remote database, insecurely
.SH "SYNOPSIS"
.sp
.nf
dblink_connect_u(text connstr) returns text
dblink_connect_u(text connname, text connstr) returns text
.fi
.SH "DESCRIPTION"
.PP
\fBdblink_connect_u()\fR
is identical to
\fBdblink_connect()\fR, except that it will allow non\-superusers to connect using any authentication method\&.
.PP
If the remote server selects an authentication method that does not involve a password, then impersonation and subsequent escalation of privileges can occur, because the session will appear to have originated from the user as which the local
PostgreSQL
server runs\&. Also, even if the remote server does demand a password, it is possible for the password to be supplied from the server environment, such as a
~/\&.pgpass
file belonging to the server\*(Aqs user\&. This opens not only a risk of impersonation, but the possibility of exposing a password to an untrustworthy remote server\&. Therefore,
\fBdblink_connect_u()\fR
is initially installed with all privileges revoked from
PUBLIC, making it un\-callable except by superusers\&. In some situations it may be appropriate to grant
EXECUTE
permission for
\fBdblink_connect_u()\fR
to specific users who are considered trustworthy, but this should be done with care\&. It is also recommended that any
~/\&.pgpass
file belonging to the server\*(Aqs user
\fInot\fR
contain any records specifying a wildcard host name\&.
.PP
For further details see
\fBdblink_connect()\fR\&.
man/man3/SPI_cursor_find.3 0000644 00000003326 14751153421 0011300 0 ustar 00 '\" t
.\" Title: SPI_cursor_find
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "SPI_CURSOR_FIND" "3" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
SPI_cursor_find \- find an existing cursor by name
.SH "SYNOPSIS"
.sp
.nf
Portal SPI_cursor_find(const char * \fIname\fR)
.fi
.SH "DESCRIPTION"
.PP
\fBSPI_cursor_find\fR
finds an existing portal by name\&. This is primarily useful to resolve a cursor name returned as text by some other function\&.
.SH "ARGUMENTS"
.PP
const char * \fIname\fR
.RS 4
name of the portal
.RE
.SH "RETURN VALUE"
.PP
pointer to the portal with the specified name, or
NULL
if none was found
man/man3/SPI_prepare.3 0000644 00000012334 14751153421 0010420 0 ustar 00 '\" t
.\" Title: SPI_prepare
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "SPI_PREPARE" "3" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
SPI_prepare \- prepare a statement, without executing it yet
.SH "SYNOPSIS"
.sp
.nf
SPIPlanPtr SPI_prepare(const char * \fIcommand\fR, int \fInargs\fR, Oid * \fIargtypes\fR)
.fi
.SH "DESCRIPTION"
.PP
\fBSPI_prepare\fR
creates and returns a prepared statement for the specified command, but doesn\*(Aqt execute the command\&. The prepared statement can later be executed repeatedly using
\fBSPI_execute_plan\fR\&.
.PP
When the same or a similar command is to be executed repeatedly, it is generally advantageous to perform parse analysis only once, and might furthermore be advantageous to re\-use an execution plan for the command\&.
\fBSPI_prepare\fR
converts a command string into a prepared statement that encapsulates the results of parse analysis\&. The prepared statement also provides a place for caching an execution plan if it is found that generating a custom plan for each execution is not helpful\&.
.PP
A prepared command can be generalized by writing parameters ($1,
$2, etc\&.) in place of what would be constants in a normal command\&. The actual values of the parameters are then specified when
\fBSPI_execute_plan\fR
is called\&. This allows the prepared command to be used over a wider range of situations than would be possible without parameters\&.
.PP
The statement returned by
\fBSPI_prepare\fR
can be used only in the current invocation of the procedure, since
\fBSPI_finish\fR
frees memory allocated for such a statement\&. But the statement can be saved for longer using the functions
\fBSPI_keepplan\fR
or
\fBSPI_saveplan\fR\&.
.SH "ARGUMENTS"
.PP
const char * \fIcommand\fR
.RS 4
command string
.RE
.PP
int \fInargs\fR
.RS 4
number of input parameters ($1,
$2, etc\&.)
.RE
.PP
Oid * \fIargtypes\fR
.RS 4
pointer to an array containing the
OIDs of the data types of the parameters
.RE
.SH "RETURN VALUE"
.PP
\fBSPI_prepare\fR
returns a non\-null pointer to an
SPIPlan, which is an opaque struct representing a prepared statement\&. On error,
NULL
will be returned, and
\fISPI_result\fR
will be set to one of the same error codes used by
\fBSPI_execute\fR, except that it is set to
SPI_ERROR_ARGUMENT
if
\fIcommand\fR
is
NULL, or if
\fInargs\fR
is less than 0, or if
\fInargs\fR
is greater than 0 and
\fIargtypes\fR
is
NULL\&.
.SH "NOTES"
.PP
If no parameters are defined, a generic plan will be created at the first use of
\fBSPI_execute_plan\fR, and used for all subsequent executions as well\&. If there are parameters, the first few uses of
\fBSPI_execute_plan\fR
will generate custom plans that are specific to the supplied parameter values\&. After enough uses of the same prepared statement,
\fBSPI_execute_plan\fR
will build a generic plan, and if that is not too much more expensive than the custom plans, it will start using the generic plan instead of re\-planning each time\&. If this default behavior is unsuitable, you can alter it by passing the
CURSOR_OPT_GENERIC_PLAN
or
CURSOR_OPT_CUSTOM_PLAN
flag to
\fBSPI_prepare_cursor\fR, to force use of generic or custom plans respectively\&.
.PP
Although the main point of a prepared statement is to avoid repeated parse analysis and planning of the statement,
PostgreSQL
will force re\-analysis and re\-planning of the statement before using it whenever database objects used in the statement have undergone definitional (DDL) changes since the previous use of the prepared statement\&. Also, if the value of
search_path
changes from one use to the next, the statement will be re\-parsed using the new
\fIsearch_path\fR\&. (This latter behavior is new as of
PostgreSQL
9\&.3\&.) See
\fBPREPARE\fR(7)
for more information about the behavior of prepared statements\&.
.PP
This function should only be called from a connected procedure\&.
.PP
SPIPlanPtr
is declared as a pointer to an opaque struct type in
spi\&.h\&. It is unwise to try to access its contents directly, as that makes your code much more likely to break in future revisions of
PostgreSQL\&.
.PP
The name
SPIPlanPtr
is somewhat historical, since the data structure no longer necessarily contains an execution plan\&.
man/man3/SPI_cursor_open_with_paramlist.3 0000644 00000005436 14751153421 0014434 0 ustar 00 '\" t
.\" Title: SPI_cursor_open_with_paramlist
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "SPI_CURSOR_OPEN_WITH_PARAMLIST" "3" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
SPI_cursor_open_with_paramlist \- set up a cursor using parameters
.SH "SYNOPSIS"
.sp
.nf
Portal SPI_cursor_open_with_paramlist(const char *\fIname\fR,
SPIPlanPtr \fIplan\fR,
ParamListInfo \fIparams\fR,
bool \fIread_only\fR)
.fi
.SH "DESCRIPTION"
.PP
\fBSPI_cursor_open_with_paramlist\fR
sets up a cursor (internally, a portal) that will execute a statement prepared by
\fBSPI_prepare\fR\&. This function is equivalent to
\fBSPI_cursor_open\fR
except that information about the parameter values to be passed to the query is presented differently\&. The
ParamListInfo
representation can be convenient for passing down values that are already available in that format\&. It also supports use of dynamic parameter sets via hook functions specified in
ParamListInfo\&.
.PP
The passed\-in parameter data will be copied into the cursor\*(Aqs portal, so it can be freed while the cursor still exists\&.
.SH "ARGUMENTS"
.PP
const char * \fIname\fR
.RS 4
name for portal, or
NULL
to let the system select a name
.RE
.PP
SPIPlanPtr \fIplan\fR
.RS 4
prepared statement (returned by
\fBSPI_prepare\fR)
.RE
.PP
ParamListInfo \fIparams\fR
.RS 4
data structure containing parameter types and values; NULL if none
.RE
.PP
bool \fIread_only\fR
.RS 4
true
for read\-only execution
.RE
.SH "RETURN VALUE"
.PP
Pointer to portal containing the cursor\&. Note there is no error return convention; any error will be reported via
\fBelog\fR\&.
man/man3/SPI_execute_with_args.3 0000644 00000007572 14751153421 0012503 0 ustar 00 '\" t
.\" Title: SPI_execute_with_args
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "SPI_EXECUTE_WITH_ARGS" "3" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
SPI_execute_with_args \- execute a command with out\-of\-line parameters
.SH "SYNOPSIS"
.sp
.nf
int SPI_execute_with_args(const char *\fIcommand\fR,
int \fInargs\fR, Oid *\fIargtypes\fR,
Datum *\fIvalues\fR, const char *\fInulls\fR,
bool \fIread_only\fR, long \fIcount\fR)
.fi
.SH "DESCRIPTION"
.PP
\fBSPI_execute_with_args\fR
executes a command that might include references to externally supplied parameters\&. The command text refers to a parameter as
$\fIn\fR, and the call specifies data types and values for each such symbol\&.
\fIread_only\fR
and
\fIcount\fR
have the same interpretation as in
\fBSPI_execute\fR\&.
.PP
The main advantage of this routine compared to
\fBSPI_execute\fR
is that data values can be inserted into the command without tedious quoting/escaping, and thus with much less risk of SQL\-injection attacks\&.
.PP
Similar results can be achieved with
\fBSPI_prepare\fR
followed by
\fBSPI_execute_plan\fR; however, when using this function the query plan is always customized to the specific parameter values provided\&. For one\-time query execution, this function should be preferred\&. If the same command is to be executed with many different parameters, either method might be faster, depending on the cost of re\-planning versus the benefit of custom plans\&.
.SH "ARGUMENTS"
.PP
const char * \fIcommand\fR
.RS 4
command string
.RE
.PP
int \fInargs\fR
.RS 4
number of input parameters ($1,
$2, etc\&.)
.RE
.PP
Oid * \fIargtypes\fR
.RS 4
an array of length
\fInargs\fR, containing the
OIDs of the data types of the parameters
.RE
.PP
Datum * \fIvalues\fR
.RS 4
an array of length
\fInargs\fR, containing the actual parameter values
.RE
.PP
const char * \fInulls\fR
.RS 4
an array of length
\fInargs\fR, describing which parameters are null
.sp
If
\fInulls\fR
is
NULL
then
\fBSPI_execute_with_args\fR
assumes that no parameters are null\&. Otherwise, each entry of the
\fInulls\fR
array should be
\*(Aq\ \&\*(Aq
if the corresponding parameter value is non\-null, or
\*(Aqn\*(Aq
if the corresponding parameter value is null\&. (In the latter case, the actual value in the corresponding
\fIvalues\fR
entry doesn\*(Aqt matter\&.) Note that
\fInulls\fR
is not a text string, just an array: it does not need a
\*(Aq\e0\*(Aq
terminator\&.
.RE
.PP
bool \fIread_only\fR
.RS 4
true
for read\-only execution
.RE
.PP
long \fIcount\fR
.RS 4
maximum number of rows to return, or
0
for no limit
.RE
.SH "RETURN VALUE"
.PP
The return value is the same as for
\fBSPI_execute\fR\&.
.PP
\fISPI_processed\fR
and
\fISPI_tuptable\fR
are set as in
\fBSPI_execute\fR
if successful\&.
man/man3/SPI_keepplan.3 0000644 00000004033 14751153421 0010556 0 ustar 00 '\" t
.\" Title: SPI_keepplan
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "SPI_KEEPPLAN" "3" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
SPI_keepplan \- save a prepared statement
.SH "SYNOPSIS"
.sp
.nf
int SPI_keepplan(SPIPlanPtr \fIplan\fR)
.fi
.SH "DESCRIPTION"
.PP
\fBSPI_keepplan\fR
saves a passed statement (prepared by
\fBSPI_prepare\fR) so that it will not be freed by
\fBSPI_finish\fR
nor by the transaction manager\&. This gives you the ability to reuse prepared statements in the subsequent invocations of your procedure in the current session\&.
.SH "ARGUMENTS"
.PP
SPIPlanPtr \fIplan\fR
.RS 4
the prepared statement to be saved
.RE
.SH "RETURN VALUE"
.PP
0 on success;
SPI_ERROR_ARGUMENT
if
\fIplan\fR
is
NULL
or invalid
.SH "NOTES"
.PP
The passed\-in statement is relocated to permanent storage by means of pointer adjustment (no data copying is required)\&. If you later wish to delete it, use
\fBSPI_freeplan\fR
on it\&.
man/man3/dblink_open.3 0000644 00000006326 14751153421 0010537 0 ustar 00 '\" t
.\" Title: dblink_open
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "DBLINK_OPEN" "3" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
dblink_open \- opens a cursor in a remote database
.SH "SYNOPSIS"
.sp
.nf
dblink_open(text cursorname, text sql [, bool fail_on_error]) returns text
dblink_open(text connname, text cursorname, text sql [, bool fail_on_error]) returns text
.fi
.SH "DESCRIPTION"
.PP
\fBdblink_open()\fR
opens a cursor in a remote database\&. The cursor can subsequently be manipulated with
\fBdblink_fetch()\fR
and
\fBdblink_close()\fR\&.
.SH "ARGUMENTS"
.PP
\fIconnname\fR
.RS 4
Name of the connection to use; omit this parameter to use the unnamed connection\&.
.RE
.PP
\fIcursorname\fR
.RS 4
The name to assign to this cursor\&.
.RE
.PP
\fIsql\fR
.RS 4
The
\fBSELECT\fR
statement that you wish to execute in the remote database, for example
select * from pg_class\&.
.RE
.PP
\fIfail_on_error\fR
.RS 4
If true (the default when omitted) then an error thrown on the remote side of the connection causes an error to also be thrown locally\&. If false, the remote error is locally reported as a NOTICE, and the function\*(Aqs return value is set to
ERROR\&.
.RE
.SH "RETURN VALUE"
.PP
Returns status, either
OK
or
ERROR\&.
.SH "NOTES"
.PP
Since a cursor can only persist within a transaction,
\fBdblink_open\fR
starts an explicit transaction block (\fBBEGIN\fR) on the remote side, if the remote side was not already within a transaction\&. This transaction will be closed again when the matching
\fBdblink_close\fR
is executed\&. Note that if you use
\fBdblink_exec\fR
to change data between
\fBdblink_open\fR
and
\fBdblink_close\fR, and then an error occurs or you use
\fBdblink_disconnect\fR
before
\fBdblink_close\fR, your change
\fIwill be lost\fR
because the transaction will be aborted\&.
.SH "EXAMPLES"
.sp
.if n \{\
.RS 4
.\}
.nf
SELECT dblink_connect(\*(Aqdbname=postgres options=\-csearch_path=\*(Aq);
dblink_connect
\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
OK
(1 row)
SELECT dblink_open(\*(Aqfoo\*(Aq, \*(Aqselect proname, prosrc from pg_proc\*(Aq);
dblink_open
\-\-\-\-\-\-\-\-\-\-\-\-\-
OK
(1 row)
.fi
.if n \{\
.RE
.\}
man/man3/dblink_is_busy.3 0000644 00000003507 14751153421 0011251 0 ustar 00 '\" t
.\" Title: dblink_is_busy
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "DBLINK_IS_BUSY" "3" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
dblink_is_busy \- checks if connection is busy with an async query
.SH "SYNOPSIS"
.sp
.nf
dblink_is_busy(text connname) returns int
.fi
.SH "DESCRIPTION"
.PP
\fBdblink_is_busy\fR
tests whether an async query is in progress\&.
.SH "ARGUMENTS"
.PP
\fIconnname\fR
.RS 4
Name of the connection to check\&.
.RE
.SH "RETURN VALUE"
.PP
Returns 1 if connection is busy, 0 if it is not busy\&. If this function returns 0, it is guaranteed that
\fBdblink_get_result\fR
will not block\&.
.SH "EXAMPLES"
.sp
.if n \{\
.RS 4
.\}
.nf
SELECT dblink_is_busy(\*(Aqdtest1\*(Aq);
.fi
.if n \{\
.RE
.\}
man/man3/SPI_saveplan.3 0000644 00000004650 14751153421 0010575 0 ustar 00 '\" t
.\" Title: SPI_saveplan
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "SPI_SAVEPLAN" "3" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
SPI_saveplan \- save a prepared statement
.SH "SYNOPSIS"
.sp
.nf
SPIPlanPtr SPI_saveplan(SPIPlanPtr \fIplan\fR)
.fi
.SH "DESCRIPTION"
.PP
\fBSPI_saveplan\fR
copies a passed statement (prepared by
\fBSPI_prepare\fR) into memory that will not be freed by
\fBSPI_finish\fR
nor by the transaction manager, and returns a pointer to the copied statement\&. This gives you the ability to reuse prepared statements in the subsequent invocations of your procedure in the current session\&.
.SH "ARGUMENTS"
.PP
SPIPlanPtr \fIplan\fR
.RS 4
the prepared statement to be saved
.RE
.SH "RETURN VALUE"
.PP
Pointer to the copied statement; or
NULL
if unsuccessful\&. On error,
\fISPI_result\fR
is set thus:
.PP
SPI_ERROR_ARGUMENT
.RS 4
if
\fIplan\fR
is
NULL
or invalid
.RE
.PP
SPI_ERROR_UNCONNECTED
.RS 4
if called from an unconnected procedure
.RE
.SH "NOTES"
.PP
The originally passed\-in statement is not freed, so you might wish to do
\fBSPI_freeplan\fR
on it to avoid leaking memory until
\fBSPI_finish\fR\&.
.PP
In most cases,
\fBSPI_keepplan\fR
is preferred to this function, since it accomplishes largely the same result without needing to physically copy the prepared statement\*(Aqs data structures\&.
man/man3/SPI_fname.3 0000644 00000003567 14751153421 0010060 0 ustar 00 '\" t
.\" Title: SPI_fname
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "SPI_FNAME" "3" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
SPI_fname \- determine the column name for the specified column number
.SH "SYNOPSIS"
.sp
.nf
char * SPI_fname(TupleDesc \fIrowdesc\fR, int \fIcolnumber\fR)
.fi
.SH "DESCRIPTION"
.PP
\fBSPI_fname\fR
returns a copy of the column name of the specified column\&. (You can use
\fBpfree\fR
to release the copy of the name when you don\*(Aqt need it anymore\&.)
.SH "ARGUMENTS"
.PP
TupleDesc \fIrowdesc\fR
.RS 4
input row description
.RE
.PP
int \fIcolnumber\fR
.RS 4
column number (count starts at 1)
.RE
.SH "RETURN VALUE"
.PP
The column name;
NULL
if
\fIcolnumber\fR
is out of range\&.
\fISPI_result\fR
set to
SPI_ERROR_NOATTRIBUTE
on error\&.
man/man3/SPI_copytuple.3 0000644 00000003417 14751153421 0011010 0 ustar 00 '\" t
.\" Title: SPI_copytuple
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "SPI_COPYTUPLE" "3" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
SPI_copytuple \- make a copy of a row in the upper executor context
.SH "SYNOPSIS"
.sp
.nf
HeapTuple SPI_copytuple(HeapTuple \fIrow\fR)
.fi
.SH "DESCRIPTION"
.PP
\fBSPI_copytuple\fR
makes a copy of a row in the upper executor context\&. This is normally used to return a modified row from a trigger\&. In a function declared to return a composite type, use
\fBSPI_returntuple\fR
instead\&.
.SH "ARGUMENTS"
.PP
HeapTuple \fIrow\fR
.RS 4
row to be copied
.RE
.SH "RETURN VALUE"
.PP
the copied row;
NULL
only if
\fItuple\fR
is
NULL
man/man3/dblink_exec.3 0000644 00000007365 14751153421 0010526 0 ustar 00 '\" t
.\" Title: dblink_exec
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "DBLINK_EXEC" "3" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
dblink_exec \- executes a command in a remote database
.SH "SYNOPSIS"
.sp
.nf
dblink_exec(text connname, text sql [, bool fail_on_error]) returns text
dblink_exec(text connstr, text sql [, bool fail_on_error]) returns text
dblink_exec(text sql [, bool fail_on_error]) returns text
.fi
.SH "DESCRIPTION"
.PP
\fBdblink_exec\fR
executes a command (that is, any SQL statement that doesn\*(Aqt return rows) in a remote database\&.
.PP
When two
text
arguments are given, the first one is first looked up as a persistent connection\*(Aqs name; if found, the command is executed on that connection\&. If not found, the first argument is treated as a connection info string as for
\fBdblink_connect\fR, and the indicated connection is made just for the duration of this command\&.
.SH "ARGUMENTS"
.PP
\fIconnname\fR
.RS 4
Name of the connection to use; omit this parameter to use the unnamed connection\&.
.RE
.PP
\fIconnstr\fR
.RS 4
A connection info string, as previously described for
\fBdblink_connect\fR\&.
.RE
.PP
\fIsql\fR
.RS 4
The SQL command that you wish to execute in the remote database, for example
insert into foo values(0, \*(Aqa\*(Aq, \*(Aq{"a0","b0","c0"}\*(Aq)\&.
.RE
.PP
\fIfail_on_error\fR
.RS 4
If true (the default when omitted) then an error thrown on the remote side of the connection causes an error to also be thrown locally\&. If false, the remote error is locally reported as a NOTICE, and the function\*(Aqs return value is set to
ERROR\&.
.RE
.SH "RETURN VALUE"
.PP
Returns status, either the command\*(Aqs status string or
ERROR\&.
.SH "EXAMPLES"
.sp
.if n \{\
.RS 4
.\}
.nf
SELECT dblink_connect(\*(Aqdbname=dblink_test_standby\*(Aq);
dblink_connect
\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
OK
(1 row)
SELECT dblink_exec(\*(Aqinsert into foo values(21, \*(Aq\*(Aqz\*(Aq\*(Aq, \*(Aq\*(Aq{"a0","b0","c0"}\*(Aq\*(Aq);\*(Aq);
dblink_exec
\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
INSERT 943366 1
(1 row)
SELECT dblink_connect(\*(Aqmyconn\*(Aq, \*(Aqdbname=regression\*(Aq);
dblink_connect
\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
OK
(1 row)
SELECT dblink_exec(\*(Aqmyconn\*(Aq, \*(Aqinsert into foo values(21, \*(Aq\*(Aqz\*(Aq\*(Aq, \*(Aq\*(Aq{"a0","b0","c0"}\*(Aq\*(Aq);\*(Aq);
dblink_exec
\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
INSERT 6432584 1
(1 row)
SELECT dblink_exec(\*(Aqmyconn\*(Aq, \*(Aqinsert into pg_class values (\*(Aq\*(Aqfoo\*(Aq\*(Aq)\*(Aq,false);
NOTICE: sql error
DETAIL: ERROR: null value in column "relnamespace" violates not\-null constraint
dblink_exec
\-\-\-\-\-\-\-\-\-\-\-\-\-
ERROR
(1 row)
.fi
.if n \{\
.RE
.\}
man/man3/dblink_error_message.3 0000644 00000004333 14751153421 0012427 0 ustar 00 '\" t
.\" Title: dblink_error_message
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "DBLINK_ERROR_MESSAGE" "3" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
dblink_error_message \- gets last error message on the named connection
.SH "SYNOPSIS"
.sp
.nf
dblink_error_message(text connname) returns text
.fi
.SH "DESCRIPTION"
.PP
\fBdblink_error_message\fR
fetches the most recent remote error message for a given connection\&.
.SH "ARGUMENTS"
.PP
\fIconnname\fR
.RS 4
Name of the connection to use\&.
.RE
.SH "RETURN VALUE"
.PP
Returns last error message, or
OK
if there has been no error in this connection\&.
.SH "NOTES"
.PP
When asynchronous queries are initiated by
\fBdblink_send_query\fR, the error message associated with the connection might not get updated until the server\*(Aqs response message is consumed\&. This typically means that
\fBdblink_is_busy\fR
or
\fBdblink_get_result\fR
should be called prior to
\fBdblink_error_message\fR, so that any error generated by the asynchronous query will be visible\&.
.SH "EXAMPLES"
.sp
.if n \{\
.RS 4
.\}
.nf
SELECT dblink_error_message(\*(Aqdtest1\*(Aq);
.fi
.if n \{\
.RE
.\}
man/man3/SPI_push.3 0000644 00000004314 14751153421 0007740 0 ustar 00 '\" t
.\" Title: SPI_push
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "SPI_PUSH" "3" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
SPI_push \- push SPI stack to allow recursive SPI usage
.SH "SYNOPSIS"
.sp
.nf
void SPI_push(void)
.fi
.SH "DESCRIPTION"
.PP
\fBSPI_push\fR
should be called before executing another procedure that might itself wish to use SPI\&. After
\fBSPI_push\fR, SPI is no longer in a
\(lqconnected\(rq
state, and SPI function calls will be rejected unless a fresh
\fBSPI_connect\fR
is done\&. This ensures a clean separation between your procedure\*(Aqs SPI state and that of another procedure you call\&. After the other procedure returns, call
\fBSPI_pop\fR
to restore access to your own SPI state\&.
.PP
Note that
\fBSPI_execute\fR
and related functions automatically do the equivalent of
\fBSPI_push\fR
before passing control back to the SQL execution engine, so it is not necessary for you to worry about this when using those functions\&. Only when you are directly calling arbitrary code that might contain
\fBSPI_connect\fR
calls do you need to issue
\fBSPI_push\fR
and
\fBSPI_pop\fR\&.
man/man3/dblink_get_notify.3 0000644 00000004753 14751153421 0011747 0 ustar 00 '\" t
.\" Title: dblink_get_notify
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "DBLINK_GET_NOTIFY" "3" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
dblink_get_notify \- retrieve async notifications on a connection
.SH "SYNOPSIS"
.sp
.nf
dblink_get_notify() returns setof (notify_name text, be_pid int, extra text)
dblink_get_notify(text connname) returns setof (notify_name text, be_pid int, extra text)
.fi
.SH "DESCRIPTION"
.PP
\fBdblink_get_notify\fR
retrieves notifications on either the unnamed connection, or on a named connection if specified\&. To receive notifications via dblink,
\fBLISTEN\fR
must first be issued, using
\fBdblink_exec\fR\&. For details see
\fBLISTEN\fR(7)
and
\fBNOTIFY\fR(7)\&.
.SH "ARGUMENTS"
.PP
\fIconnname\fR
.RS 4
The name of a named connection to get notifications on\&.
.RE
.SH "RETURN VALUE"
.PP
Returns
setof (notify_name text, be_pid int, extra text), or an empty set if none\&.
.SH "EXAMPLES"
.sp
.if n \{\
.RS 4
.\}
.nf
SELECT dblink_exec(\*(AqLISTEN virtual\*(Aq);
dblink_exec
\-\-\-\-\-\-\-\-\-\-\-\-\-
LISTEN
(1 row)
SELECT * FROM dblink_get_notify();
notify_name | be_pid | extra
\-\-\-\-\-\-\-\-\-\-\-\-\-+\-\-\-\-\-\-\-\-+\-\-\-\-\-\-\-
(0 rows)
NOTIFY virtual;
NOTIFY
SELECT * FROM dblink_get_notify();
notify_name | be_pid | extra
\-\-\-\-\-\-\-\-\-\-\-\-\-+\-\-\-\-\-\-\-\-+\-\-\-\-\-\-\-
virtual | 1229 |
(1 row)
.fi
.if n \{\
.RE
.\}
man/man3/SPI_cursor_move.3 0000644 00000003666 14751153421 0011335 0 ustar 00 '\" t
.\" Title: SPI_cursor_move
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "SPI_CURSOR_MOVE" "3" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
SPI_cursor_move \- move a cursor
.SH "SYNOPSIS"
.sp
.nf
void SPI_cursor_move(Portal \fIportal\fR, bool \fIforward\fR, long \fIcount\fR)
.fi
.SH "DESCRIPTION"
.PP
\fBSPI_cursor_move\fR
skips over some number of rows in a cursor\&. This is equivalent to a subset of the SQL command
\fBMOVE\fR
(see
\fBSPI_scroll_cursor_move\fR
for more functionality)\&.
.SH "ARGUMENTS"
.PP
Portal \fIportal\fR
.RS 4
portal containing the cursor
.RE
.PP
bool \fIforward\fR
.RS 4
true for move forward, false for move backward
.RE
.PP
long \fIcount\fR
.RS 4
maximum number of rows to move
.RE
.SH "NOTES"
.PP
Moving backward may fail if the cursor\*(Aqs plan was not created with the
CURSOR_OPT_SCROLL
option\&.
man/man3/SPI_getnspname.3 0000644 00000003441 14751153421 0011122 0 ustar 00 '\" t
.\" Title: SPI_getnspname
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "SPI_GETNSPNAME" "3" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
SPI_getnspname \- return the namespace of the specified relation
.SH "SYNOPSIS"
.sp
.nf
char * SPI_getnspname(Relation \fIrel\fR)
.fi
.SH "DESCRIPTION"
.PP
\fBSPI_getnspname\fR
returns a copy of the name of the namespace that the specified
Relation
belongs to\&. This is equivalent to the relation\*(Aqs schema\&. You should
\fBpfree\fR
the return value of this function when you are finished with it\&.
.SH "ARGUMENTS"
.PP
Relation \fIrel\fR
.RS 4
input relation
.RE
.SH "RETURN VALUE"
.PP
The name of the specified relation\*(Aqs namespace\&.
man/man3/SPI_freeplan.3 0000644 00000003314 14751153421 0010554 0 ustar 00 '\" t
.\" Title: SPI_freeplan
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "SPI_FREEPLAN" "3" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
SPI_freeplan \- free a previously saved prepared statement
.SH "SYNOPSIS"
.sp
.nf
int SPI_freeplan(SPIPlanPtr \fIplan\fR)
.fi
.SH "DESCRIPTION"
.PP
\fBSPI_freeplan\fR
releases a prepared statement previously returned by
\fBSPI_prepare\fR
or saved by
\fBSPI_keepplan\fR
or
\fBSPI_saveplan\fR\&.
.SH "ARGUMENTS"
.PP
SPIPlanPtr \fIplan\fR
.RS 4
pointer to statement to free
.RE
.SH "RETURN VALUE"
.PP
0 on success;
SPI_ERROR_ARGUMENT
if
\fIplan\fR
is
NULL
or invalid
man/man7/DROP_ROLE.7 0000644 00000006071 14751153421 0007645 0 ustar 00 '\" t
.\" Title: DROP ROLE
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "DROP ROLE" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
DROP_ROLE \- remove a database role
.SH "SYNOPSIS"
.sp
.nf
DROP ROLE [ IF EXISTS ] \fIname\fR [, \&.\&.\&.]
.fi
.SH "DESCRIPTION"
.PP
\fBDROP ROLE\fR
removes the specified role(s)\&. To drop a superuser role, you must be a superuser yourself; to drop non\-superuser roles, you must have
CREATEROLE
privilege\&.
.PP
A role cannot be removed if it is still referenced in any database of the cluster; an error will be raised if so\&. Before dropping the role, you must drop all the objects it owns (or reassign their ownership) and revoke any privileges the role has been granted on other objects\&. The
REASSIGN OWNED (\fBREASSIGN_OWNED\fR(7))
and
DROP OWNED (\fBDROP_OWNED\fR(7))
commands can be useful for this purpose; see
Section 21.4, \(lqDropping Roles\(rq, in the documentation
for more discussion\&.
.PP
However, it is not necessary to remove role memberships involving the role;
\fBDROP ROLE\fR
automatically revokes any memberships of the target role in other roles, and of other roles in the target role\&. The other roles are not dropped nor otherwise affected\&.
.SH "PARAMETERS"
.PP
IF EXISTS
.RS 4
Do not throw an error if the role does not exist\&. A notice is issued in this case\&.
.RE
.PP
\fIname\fR
.RS 4
The name of the role to remove\&.
.RE
.SH "NOTES"
.PP
PostgreSQL
includes a program
\fBdropuser\fR(1)
that has the same functionality as this command (in fact, it calls this command) but can be run from the command shell\&.
.SH "EXAMPLES"
.PP
To drop a role:
.sp
.if n \{\
.RS 4
.\}
.nf
DROP ROLE jonathan;
.fi
.if n \{\
.RE
.\}
.SH "COMPATIBILITY"
.PP
The SQL standard defines
\fBDROP ROLE\fR, but it allows only one role to be dropped at a time, and it specifies different privilege requirements than
PostgreSQL
uses\&.
.SH "SEE ALSO"
CREATE ROLE (\fBCREATE_ROLE\fR(7)), ALTER ROLE (\fBALTER_ROLE\fR(7)), SET ROLE (\fBSET_ROLE\fR(7))
man/man7/DROP_FOREIGN_TABLE.7 0000644 00000005135 14751153421 0011104 0 ustar 00 '\" t
.\" Title: DROP FOREIGN TABLE
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "DROP FOREIGN TABLE" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
DROP_FOREIGN_TABLE \- remove a foreign table
.SH "SYNOPSIS"
.sp
.nf
DROP FOREIGN TABLE [ IF EXISTS ] \fIname\fR [, \&.\&.\&.] [ CASCADE | RESTRICT ]
.fi
.SH "DESCRIPTION"
.PP
\fBDROP FOREIGN TABLE\fR
removes a foreign table\&. Only the owner of a foreign table can remove it\&.
.SH "PARAMETERS"
.PP
IF EXISTS
.RS 4
Do not throw an error if the foreign table does not exist\&. A notice is issued in this case\&.
.RE
.PP
\fIname\fR
.RS 4
The name (optionally schema\-qualified) of the foreign table to drop\&.
.RE
.PP
CASCADE
.RS 4
Automatically drop objects that depend on the foreign table (such as views), and in turn all objects that depend on those objects (see
Section 5.13, \(lqDependency Tracking\(rq, in the documentation)\&.
.RE
.PP
RESTRICT
.RS 4
Refuse to drop the foreign table if any objects depend on it\&. This is the default\&.
.RE
.SH "EXAMPLES"
.PP
To destroy two foreign tables,
films
and
distributors:
.sp
.if n \{\
.RS 4
.\}
.nf
DROP FOREIGN TABLE films, distributors;
.fi
.if n \{\
.RE
.\}
.SH "COMPATIBILITY"
.PP
This command conforms to the ISO/IEC 9075\-9 (SQL/MED), except that the standard only allows one foreign table to be dropped per command, and apart from the
IF EXISTS
option, which is a
PostgreSQL
extension\&.
.SH "SEE ALSO"
ALTER FOREIGN TABLE (\fBALTER_FOREIGN_TABLE\fR(7)), CREATE FOREIGN TABLE (\fBCREATE_FOREIGN_TABLE\fR(7))
man/man7/CREATE_TABLE_AS.7 0000644 00000017465 14751153421 0010526 0 ustar 00 '\" t
.\" Title: CREATE TABLE AS
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "CREATE TABLE AS" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
CREATE_TABLE_AS \- define a new table from the results of a query
.SH "SYNOPSIS"
.sp
.nf
CREATE [ [ GLOBAL | LOCAL ] { TEMPORARY | TEMP } | UNLOGGED ] TABLE [ IF NOT EXISTS ] \fItable_name\fR
[ (\fIcolumn_name\fR [, \&.\&.\&.] ) ]
[ WITH ( \fIstorage_parameter\fR [= \fIvalue\fR] [, \&.\&.\&. ] ) | WITH OIDS | WITHOUT OIDS ]
[ ON COMMIT { PRESERVE ROWS | DELETE ROWS | DROP } ]
[ TABLESPACE \fItablespace_name\fR ]
AS \fIquery\fR
[ WITH [ NO ] DATA ]
.fi
.SH "DESCRIPTION"
.PP
\fBCREATE TABLE AS\fR
creates a table and fills it with data computed by a
\fBSELECT\fR
command\&. The table columns have the names and data types associated with the output columns of the
\fBSELECT\fR
(except that you can override the column names by giving an explicit list of new column names)\&.
.PP
\fBCREATE TABLE AS\fR
bears some resemblance to creating a view, but it is really quite different: it creates a new table and evaluates the query just once to fill the new table initially\&. The new table will not track subsequent changes to the source tables of the query\&. In contrast, a view re\-evaluates its defining
\fBSELECT\fR
statement whenever it is queried\&.
.SH "PARAMETERS"
.PP
GLOBAL or LOCAL
.RS 4
Ignored for compatibility\&. Use of these keywords is deprecated; refer to
CREATE TABLE (\fBCREATE_TABLE\fR(7))
for details\&.
.RE
.PP
TEMPORARY or TEMP
.RS 4
If specified, the table is created as a temporary table\&. Refer to
CREATE TABLE (\fBCREATE_TABLE\fR(7))
for details\&.
.RE
.PP
UNLOGGED
.RS 4
If specified, the table is created as an unlogged table\&. Refer to
CREATE TABLE (\fBCREATE_TABLE\fR(7))
for details\&.
.RE
.PP
IF NOT EXISTS
.RS 4
Do not throw an error if a relation with the same name already exists\&. A notice is issued in this case\&. Refer to
CREATE TABLE (\fBCREATE_TABLE\fR(7))
for details\&.
.RE
.PP
\fItable_name\fR
.RS 4
The name (optionally schema\-qualified) of the table to be created\&.
.RE
.PP
\fIcolumn_name\fR
.RS 4
The name of a column in the new table\&. If column names are not provided, they are taken from the output column names of the query\&.
.RE
.PP
WITH ( \fIstorage_parameter\fR [= \fIvalue\fR] [, \&.\&.\&. ] )
.RS 4
This clause specifies optional storage parameters for the new table; see
Storage Parameters
for more information\&. The
WITH
clause can also include
OIDS=TRUE
(or just
OIDS) to specify that rows of the new table should have OIDs (object identifiers) assigned to them, or
OIDS=FALSE
to specify that the rows should not have OIDs\&. See
CREATE TABLE (\fBCREATE_TABLE\fR(7))
for more information\&.
.RE
.PP
WITH OIDS
.br
WITHOUT OIDS
.RS 4
These are obsolescent syntaxes equivalent to
WITH (OIDS)
and
WITH (OIDS=FALSE), respectively\&. If you wish to give both an
OIDS
setting and storage parameters, you must use the
WITH ( \&.\&.\&. )
syntax; see above\&.
.RE
.PP
ON COMMIT
.RS 4
The behavior of temporary tables at the end of a transaction block can be controlled using
ON COMMIT\&. The three options are:
.PP
PRESERVE ROWS
.RS 4
No special action is taken at the ends of transactions\&. This is the default behavior\&.
.RE
.PP
DELETE ROWS
.RS 4
All rows in the temporary table will be deleted at the end of each transaction block\&. Essentially, an automatic
\fBTRUNCATE\fR(7)
is done at each commit\&.
.RE
.PP
DROP
.RS 4
The temporary table will be dropped at the end of the current transaction block\&.
.RE
.RE
.PP
TABLESPACE \fItablespace_name\fR
.RS 4
The
\fItablespace_name\fR
is the name of the tablespace in which the new table is to be created\&. If not specified,
default_tablespace
is consulted, or
temp_tablespaces
if the table is temporary\&.
.RE
.PP
\fIquery\fR
.RS 4
A
\fBSELECT\fR(7),
TABLE, or
\fBVALUES\fR(7)
command, or an
\fBEXECUTE\fR(7)
command that runs a prepared
\fBSELECT\fR,
\fBTABLE\fR, or
\fBVALUES\fR
query\&.
.RE
.PP
WITH [ NO ] DATA
.RS 4
This clause specifies whether or not the data produced by the query should be copied into the new table\&. If not, only the table structure is copied\&. The default is to copy the data\&.
.RE
.SH "NOTES"
.PP
This command is functionally similar to
SELECT INTO (\fBSELECT_INTO\fR(7)), but it is preferred since it is less likely to be confused with other uses of the
\fBSELECT INTO\fR
syntax\&. Furthermore,
\fBCREATE TABLE AS\fR
offers a superset of the functionality offered by
\fBSELECT INTO\fR\&.
.PP
The
\fBCREATE TABLE AS\fR
command allows the user to explicitly specify whether OIDs should be included\&. If the presence of OIDs is not explicitly specified, the
default_with_oids
configuration variable is used\&.
.SH "EXAMPLES"
.PP
Create a new table
films_recent
consisting of only recent entries from the table
films:
.sp
.if n \{\
.RS 4
.\}
.nf
CREATE TABLE films_recent AS
SELECT * FROM films WHERE date_prod >= \*(Aq2002\-01\-01\*(Aq;
.fi
.if n \{\
.RE
.\}
.PP
To copy a table completely, the short form using the
TABLE
command can also be used:
.sp
.if n \{\
.RS 4
.\}
.nf
CREATE TABLE films2 AS
TABLE films;
.fi
.if n \{\
.RE
.\}
.PP
Create a new temporary table
films_recent, consisting of only recent entries from the table
films, using a prepared statement\&. The new table has OIDs and will be dropped at commit:
.sp
.if n \{\
.RS 4
.\}
.nf
PREPARE recentfilms(date) AS
SELECT * FROM films WHERE date_prod > $1;
CREATE TEMP TABLE films_recent WITH (OIDS) ON COMMIT DROP AS
EXECUTE recentfilms(\*(Aq2002\-01\-01\*(Aq);
.fi
.if n \{\
.RE
.\}
.SH "COMPATIBILITY"
.PP
\fBCREATE TABLE AS\fR
conforms to the
SQL
standard\&. The following are nonstandard extensions:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
The standard requires parentheses around the subquery clause; in
PostgreSQL, these parentheses are optional\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
In the standard, the
WITH [ NO ] DATA
clause is required; in PostgreSQL it is optional\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
PostgreSQL
handles temporary tables in a way rather different from the standard; see
CREATE TABLE (\fBCREATE_TABLE\fR(7))
for details\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
The
WITH
clause is a
PostgreSQL
extension; neither storage parameters nor OIDs are in the standard\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
The
PostgreSQL
concept of tablespaces is not part of the standard\&. Hence, the clause
TABLESPACE
is an extension\&.
.RE
.SH "SEE ALSO"
CREATE MATERIALIZED VIEW (\fBCREATE_MATERIALIZED_VIEW\fR(7)), CREATE TABLE (\fBCREATE_TABLE\fR(7)), \fBEXECUTE\fR(7), \fBSELECT\fR(7), SELECT INTO (\fBSELECT_INTO\fR(7)), \fBVALUES\fR(7)
man/man7/SELECT.7 0000644 00000177316 14751153421 0007252 0 ustar 00 '\" t
.\" Title: SELECT
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "SELECT" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
SELECT, TABLE, WITH \- retrieve rows from a table or view
.SH "SYNOPSIS"
.sp
.nf
[ WITH [ RECURSIVE ] \fIwith_query\fR [, \&.\&.\&.] ]
SELECT [ ALL | DISTINCT [ ON ( \fIexpression\fR [, \&.\&.\&.] ) ] ]
[ * | \fIexpression\fR [ [ AS ] \fIoutput_name\fR ] [, \&.\&.\&.] ]
[ FROM \fIfrom_item\fR [, \&.\&.\&.] ]
[ WHERE \fIcondition\fR ]
[ GROUP BY \fIgrouping_element\fR [, \&.\&.\&.] ]
[ HAVING \fIcondition\fR ]
[ WINDOW \fIwindow_name\fR AS ( \fIwindow_definition\fR ) [, \&.\&.\&.] ]
[ { UNION | INTERSECT | EXCEPT } [ ALL | DISTINCT ] \fIselect\fR ]
[ ORDER BY \fIexpression\fR [ ASC | DESC | USING \fIoperator\fR ] [ NULLS { FIRST | LAST } ] [, \&.\&.\&.] ]
[ LIMIT { \fIcount\fR | ALL } ]
[ OFFSET \fIstart\fR [ ROW | ROWS ] ]
[ FETCH { FIRST | NEXT } [ \fIcount\fR ] { ROW | ROWS } ONLY ]
[ FOR { UPDATE | NO KEY UPDATE | SHARE | KEY SHARE } [ OF \fItable_name\fR [, \&.\&.\&.] ] [ NOWAIT | SKIP LOCKED ] [\&.\&.\&.] ]
where \fIfrom_item\fR can be one of:
[ ONLY ] \fItable_name\fR [ * ] [ [ AS ] \fIalias\fR [ ( \fIcolumn_alias\fR [, \&.\&.\&.] ) ] ]
[ TABLESAMPLE \fIsampling_method\fR ( \fIargument\fR [, \&.\&.\&.] ) [ REPEATABLE ( \fIseed\fR ) ] ]
[ LATERAL ] ( \fIselect\fR ) [ AS ] \fIalias\fR [ ( \fIcolumn_alias\fR [, \&.\&.\&.] ) ]
\fIwith_query_name\fR [ [ AS ] \fIalias\fR [ ( \fIcolumn_alias\fR [, \&.\&.\&.] ) ] ]
[ LATERAL ] \fIfunction_name\fR ( [ \fIargument\fR [, \&.\&.\&.] ] )
[ WITH ORDINALITY ] [ [ AS ] \fIalias\fR [ ( \fIcolumn_alias\fR [, \&.\&.\&.] ) ] ]
[ LATERAL ] \fIfunction_name\fR ( [ \fIargument\fR [, \&.\&.\&.] ] ) [ AS ] \fIalias\fR ( \fIcolumn_definition\fR [, \&.\&.\&.] )
[ LATERAL ] \fIfunction_name\fR ( [ \fIargument\fR [, \&.\&.\&.] ] ) AS ( \fIcolumn_definition\fR [, \&.\&.\&.] )
[ LATERAL ] ROWS FROM( \fIfunction_name\fR ( [ \fIargument\fR [, \&.\&.\&.] ] ) [ AS ( \fIcolumn_definition\fR [, \&.\&.\&.] ) ] [, \&.\&.\&.] )
[ WITH ORDINALITY ] [ [ AS ] \fIalias\fR [ ( \fIcolumn_alias\fR [, \&.\&.\&.] ) ] ]
\fIfrom_item\fR [ NATURAL ] \fIjoin_type\fR \fIfrom_item\fR [ ON \fIjoin_condition\fR | USING ( \fIjoin_column\fR [, \&.\&.\&.] ) ]
and \fIgrouping_element\fR can be one of:
( )
\fIexpression\fR
( \fIexpression\fR [, \&.\&.\&.] )
ROLLUP ( { \fIexpression\fR | ( \fIexpression\fR [, \&.\&.\&.] ) } [, \&.\&.\&.] )
CUBE ( { \fIexpression\fR | ( \fIexpression\fR [, \&.\&.\&.] ) } [, \&.\&.\&.] )
GROUPING SETS ( \fIgrouping_element\fR [, \&.\&.\&.] )
and \fIwith_query\fR is:
\fIwith_query_name\fR [ ( \fIcolumn_name\fR [, \&.\&.\&.] ) ] AS ( \fIselect\fR | \fIvalues\fR | \fIinsert\fR | \fIupdate\fR | \fIdelete\fR )
TABLE [ ONLY ] \fItable_name\fR [ * ]
.fi
.SH "DESCRIPTION"
.PP
\fBSELECT\fR
retrieves rows from zero or more tables\&. The general processing of
\fBSELECT\fR
is as follows:
.sp
.RS 4
.ie n \{\
\h'-04' 1.\h'+01'\c
.\}
.el \{\
.sp -1
.IP " 1." 4.2
.\}
All queries in the
WITH
list are computed\&. These effectively serve as temporary tables that can be referenced in the
FROM
list\&. A
WITH
query that is referenced more than once in
FROM
is computed only once\&. (See
WITH Clause
below\&.)
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 2.\h'+01'\c
.\}
.el \{\
.sp -1
.IP " 2." 4.2
.\}
All elements in the
FROM
list are computed\&. (Each element in the
FROM
list is a real or virtual table\&.) If more than one element is specified in the
FROM
list, they are cross\-joined together\&. (See
FROM Clause
below\&.)
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 3.\h'+01'\c
.\}
.el \{\
.sp -1
.IP " 3." 4.2
.\}
If the
WHERE
clause is specified, all rows that do not satisfy the condition are eliminated from the output\&. (See
WHERE Clause
below\&.)
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 4.\h'+01'\c
.\}
.el \{\
.sp -1
.IP " 4." 4.2
.\}
If the
GROUP BY
clause is specified, or if there are aggregate function calls, the output is combined into groups of rows that match on one or more values, and the results of aggregate functions are computed\&. If the
HAVING
clause is present, it eliminates groups that do not satisfy the given condition\&. (See
GROUP BY Clause
and
HAVING Clause
below\&.)
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 5.\h'+01'\c
.\}
.el \{\
.sp -1
.IP " 5." 4.2
.\}
The actual output rows are computed using the
\fBSELECT\fR
output expressions for each selected row or row group\&. (See
SELECT List
below\&.)
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 6.\h'+01'\c
.\}
.el \{\
.sp -1
.IP " 6." 4.2
.\}
SELECT DISTINCT
eliminates duplicate rows from the result\&.
SELECT DISTINCT ON
eliminates rows that match on all the specified expressions\&.
SELECT ALL
(the default) will return all candidate rows, including duplicates\&. (See
DISTINCT Clause
below\&.)
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 7.\h'+01'\c
.\}
.el \{\
.sp -1
.IP " 7." 4.2
.\}
Using the operators
UNION,
INTERSECT, and
EXCEPT, the output of more than one
\fBSELECT\fR
statement can be combined to form a single result set\&. The
UNION
operator returns all rows that are in one or both of the result sets\&. The
INTERSECT
operator returns all rows that are strictly in both result sets\&. The
EXCEPT
operator returns the rows that are in the first result set but not in the second\&. In all three cases, duplicate rows are eliminated unless
ALL
is specified\&. The noise word
DISTINCT
can be added to explicitly specify eliminating duplicate rows\&. Notice that
DISTINCT
is the default behavior here, even though
ALL
is the default for
\fBSELECT\fR
itself\&. (See
UNION Clause,
INTERSECT Clause, and
EXCEPT Clause
below\&.)
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 8.\h'+01'\c
.\}
.el \{\
.sp -1
.IP " 8." 4.2
.\}
If the
ORDER BY
clause is specified, the returned rows are sorted in the specified order\&. If
ORDER BY
is not given, the rows are returned in whatever order the system finds fastest to produce\&. (See
ORDER BY Clause
below\&.)
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 9.\h'+01'\c
.\}
.el \{\
.sp -1
.IP " 9." 4.2
.\}
If the
LIMIT
(or
FETCH FIRST) or
OFFSET
clause is specified, the
\fBSELECT\fR
statement only returns a subset of the result rows\&. (See
LIMIT Clause
below\&.)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'10.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "10." 4.2
.\}
If
FOR UPDATE,
FOR NO KEY UPDATE,
FOR SHARE
or
FOR KEY SHARE
is specified, the
\fBSELECT\fR
statement locks the selected rows against concurrent updates\&. (See
The Locking Clause
below\&.)
.RE
.PP
You must have
SELECT
privilege on each column used in a
\fBSELECT\fR
command\&. The use of
FOR NO KEY UPDATE,
FOR UPDATE,
FOR SHARE
or
FOR KEY SHARE
requires
UPDATE
privilege as well (for at least one column of each table so selected)\&.
.SH "PARAMETERS"
.SS "WITH Clause"
.PP
The
WITH
clause allows you to specify one or more subqueries that can be referenced by name in the primary query\&. The subqueries effectively act as temporary tables or views for the duration of the primary query\&. Each subquery can be a
\fBSELECT\fR,
\fBTABLE\fR,
\fBVALUES\fR,
\fBINSERT\fR,
\fBUPDATE\fR
or
\fBDELETE\fR
statement\&. When writing a data\-modifying statement (\fBINSERT\fR,
\fBUPDATE\fR
or
\fBDELETE\fR) in
WITH, it is usual to include a
RETURNING
clause\&. It is the output of
RETURNING,
\fInot\fR
the underlying table that the statement modifies, that forms the temporary table that is read by the primary query\&. If
RETURNING
is omitted, the statement is still executed, but it produces no output so it cannot be referenced as a table by the primary query\&.
.PP
A name (without schema qualification) must be specified for each
WITH
query\&. Optionally, a list of column names can be specified; if this is omitted, the column names are inferred from the subquery\&.
.PP
If
RECURSIVE
is specified, it allows a
\fBSELECT\fR
subquery to reference itself by name\&. Such a subquery must have the form
.sp
.if n \{\
.RS 4
.\}
.nf
\fInon_recursive_term\fR UNION [ ALL | DISTINCT ] \fIrecursive_term\fR
.fi
.if n \{\
.RE
.\}
.sp
where the recursive self\-reference must appear on the right\-hand side of the
UNION\&. Only one recursive self\-reference is permitted per query\&. Recursive data\-modifying statements are not supported, but you can use the results of a recursive
\fBSELECT\fR
query in a data\-modifying statement\&. See
Section 7.8, \(lqWITH Queries (Common Table Expressions)\(rq, in the documentation
for an example\&.
.PP
Another effect of
RECURSIVE
is that
WITH
queries need not be ordered: a query can reference another one that is later in the list\&. (However, circular references, or mutual recursion, are not implemented\&.) Without
RECURSIVE,
WITH
queries can only reference sibling
WITH
queries that are earlier in the
WITH
list\&.
.PP
A key property of
WITH
queries is that they are evaluated only once per execution of the primary query, even if the primary query refers to them more than once\&. In particular, data\-modifying statements are guaranteed to be executed once and only once, regardless of whether the primary query reads all or any of their output\&.
.PP
When there are multiple queries in the
WITH
clause,
RECURSIVE
should be written only once, immediately after
WITH\&. It applies to all queries in the
WITH
clause, though it has no effect on queries that do not use recursion or forward references\&.
.PP
The primary query and the
WITH
queries are all (notionally) executed at the same time\&. This implies that the effects of a data\-modifying statement in
WITH
cannot be seen from other parts of the query, other than by reading its
RETURNING
output\&. If two such data\-modifying statements attempt to modify the same row, the results are unspecified\&.
.PP
See
Section 7.8, \(lqWITH Queries (Common Table Expressions)\(rq, in the documentation
for additional information\&.
.SS "FROM Clause"
.PP
The
FROM
clause specifies one or more source tables for the
\fBSELECT\fR\&. If multiple sources are specified, the result is the Cartesian product (cross join) of all the sources\&. But usually qualification conditions are added (via
WHERE) to restrict the returned rows to a small subset of the Cartesian product\&.
.PP
The
FROM
clause can contain the following elements:
.PP
\fItable_name\fR
.RS 4
The name (optionally schema\-qualified) of an existing table or view\&. If
ONLY
is specified before the table name, only that table is scanned\&. If
ONLY
is not specified, the table and all its descendant tables (if any) are scanned\&. Optionally,
*
can be specified after the table name to explicitly indicate that descendant tables are included\&.
.RE
.PP
\fIalias\fR
.RS 4
A substitute name for the
FROM
item containing the alias\&. An alias is used for brevity or to eliminate ambiguity for self\-joins (where the same table is scanned multiple times)\&. When an alias is provided, it completely hides the actual name of the table or function; for example given
FROM foo AS f, the remainder of the
\fBSELECT\fR
must refer to this
FROM
item as
f
not
foo\&. If an alias is written, a column alias list can also be written to provide substitute names for one or more columns of the table\&.
.RE
.PP
TABLESAMPLE \fIsampling_method\fR ( \fIargument\fR [, \&.\&.\&.] ) [ REPEATABLE ( \fIseed\fR ) ]
.RS 4
A
TABLESAMPLE
clause after a
\fItable_name\fR
indicates that the specified
\fIsampling_method\fR
should be used to retrieve a subset of the rows in that table\&. This sampling precedes the application of any other filters such as
WHERE
clauses\&. The standard
PostgreSQL
distribution includes two sampling methods,
BERNOULLI
and
SYSTEM, and other sampling methods can be installed in the database via extensions\&.
.sp
The
BERNOULLI
and
SYSTEM
sampling methods each accept a single
\fIargument\fR
which is the fraction of the table to sample, expressed as a percentage between 0 and 100\&. This argument can be any
real\-valued expression\&. (Other sampling methods might accept more or different arguments\&.) These two methods each return a randomly\-chosen sample of the table that will contain approximately the specified percentage of the table\*(Aqs rows\&. The
BERNOULLI
method scans the whole table and selects or ignores individual rows independently with the specified probability\&. The
SYSTEM
method does block\-level sampling with each block having the specified chance of being selected; all rows in each selected block are returned\&. The
SYSTEM
method is significantly faster than the
BERNOULLI
method when small sampling percentages are specified, but it may return a less\-random sample of the table as a result of clustering effects\&.
.sp
The optional
REPEATABLE
clause specifies a
\fIseed\fR
number or expression to use for generating random numbers within the sampling method\&. The seed value can be any non\-null floating\-point value\&. Two queries that specify the same seed and
\fIargument\fR
values will select the same sample of the table, if the table has not been changed meanwhile\&. But different seed values will usually produce different samples\&. If
REPEATABLE
is not given then a new random sample is selected for each query, based upon a system\-generated seed\&. Note that some add\-on sampling methods do not accept
REPEATABLE, and will always produce new samples on each use\&.
.RE
.PP
\fIselect\fR
.RS 4
A sub\-\fBSELECT\fR
can appear in the
FROM
clause\&. This acts as though its output were created as a temporary table for the duration of this single
\fBSELECT\fR
command\&. Note that the sub\-\fBSELECT\fR
must be surrounded by parentheses, and an alias
\fImust\fR
be provided for it\&. A
\fBVALUES\fR(7)
command can also be used here\&.
.RE
.PP
\fIwith_query_name\fR
.RS 4
A
WITH
query is referenced by writing its name, just as though the query\*(Aqs name were a table name\&. (In fact, the
WITH
query hides any real table of the same name for the purposes of the primary query\&. If necessary, you can refer to a real table of the same name by schema\-qualifying the table\*(Aqs name\&.) An alias can be provided in the same way as for a table\&.
.RE
.PP
\fIfunction_name\fR
.RS 4
Function calls can appear in the
FROM
clause\&. (This is especially useful for functions that return result sets, but any function can be used\&.) This acts as though the function\*(Aqs output were created as a temporary table for the duration of this single
\fBSELECT\fR
command\&. When the optional
\fBWITH ORDINALITY\fR
clause is added to the function call, a new column is appended after all the function\*(Aqs output columns with numbering for each row\&.
.sp
An alias can be provided in the same way as for a table\&. If an alias is written, a column alias list can also be written to provide substitute names for one or more attributes of the function\*(Aqs composite return type, including the column added by
ORDINALITY
if present\&.
.sp
Multiple function calls can be combined into a single
FROM\-clause item by surrounding them with
ROWS FROM( \&.\&.\&. )\&. The output of such an item is the concatenation of the first row from each function, then the second row from each function, etc\&. If some of the functions produce fewer rows than others, null values are substituted for the missing data, so that the total number of rows returned is always the same as for the function that produced the most rows\&.
.sp
If the function has been defined as returning the
record
data type, then an alias or the key word
AS
must be present, followed by a column definition list in the form
( \fIcolumn_name\fR \fIdata_type\fR [, \&.\&.\&. ])\&. The column definition list must match the actual number and types of columns returned by the function\&.
.sp
When using the
ROWS FROM( \&.\&.\&. )
syntax, if one of the functions requires a column definition list, it\*(Aqs preferred to put the column definition list after the function call inside
ROWS FROM( \&.\&.\&. )\&. A column definition list can be placed after the
ROWS FROM( \&.\&.\&. )
construct only if there\*(Aqs just a single function and no
WITH ORDINALITY
clause\&.
.sp
To use
ORDINALITY
together with a column definition list, you must use the
ROWS FROM( \&.\&.\&. )
syntax and put the column definition list inside
ROWS FROM( \&.\&.\&. )\&.
.RE
.PP
\fIjoin_type\fR
.RS 4
One of
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
[ INNER ] JOIN
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
LEFT [ OUTER ] JOIN
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
RIGHT [ OUTER ] JOIN
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
FULL [ OUTER ] JOIN
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
CROSS JOIN
.RE
.sp
For the
INNER
and
OUTER
join types, a join condition must be specified, namely exactly one of
NATURAL,
ON \fIjoin_condition\fR, or
USING (\fIjoin_column\fR [, \&.\&.\&.])\&. See below for the meaning\&. For
CROSS JOIN, none of these clauses can appear\&.
.sp
A
JOIN
clause combines two
FROM
items, which for convenience we will refer to as
\(lqtables\(rq, though in reality they can be any type of
FROM
item\&. Use parentheses if necessary to determine the order of nesting\&. In the absence of parentheses,
JOINs nest left\-to\-right\&. In any case
JOIN
binds more tightly than the commas separating
FROM\-list items\&.
.sp
CROSS JOIN
and
INNER JOIN
produce a simple Cartesian product, the same result as you get from listing the two tables at the top level of
FROM, but restricted by the join condition (if any)\&.
CROSS JOIN
is equivalent to
INNER JOIN ON (TRUE), that is, no rows are removed by qualification\&. These join types are just a notational convenience, since they do nothing you couldn\*(Aqt do with plain
FROM
and
WHERE\&.
.sp
LEFT OUTER JOIN
returns all rows in the qualified Cartesian product (i\&.e\&., all combined rows that pass its join condition), plus one copy of each row in the left\-hand table for which there was no right\-hand row that passed the join condition\&. This left\-hand row is extended to the full width of the joined table by inserting null values for the right\-hand columns\&. Note that only the
JOIN
clause\*(Aqs own condition is considered while deciding which rows have matches\&. Outer conditions are applied afterwards\&.
.sp
Conversely,
RIGHT OUTER JOIN
returns all the joined rows, plus one row for each unmatched right\-hand row (extended with nulls on the left)\&. This is just a notational convenience, since you could convert it to a
LEFT OUTER JOIN
by switching the left and right tables\&.
.sp
FULL OUTER JOIN
returns all the joined rows, plus one row for each unmatched left\-hand row (extended with nulls on the right), plus one row for each unmatched right\-hand row (extended with nulls on the left)\&.
.RE
.PP
ON \fIjoin_condition\fR
.RS 4
\fIjoin_condition\fR
is an expression resulting in a value of type
boolean
(similar to a
WHERE
clause) that specifies which rows in a join are considered to match\&.
.RE
.PP
USING ( \fIjoin_column\fR [, \&.\&.\&.] )
.RS 4
A clause of the form
USING ( a, b, \&.\&.\&. )
is shorthand for
ON left_table\&.a = right_table\&.a AND left_table\&.b = right_table\&.b \&.\&.\&.\&. Also,
USING
implies that only one of each pair of equivalent columns will be included in the join output, not both\&.
.RE
.PP
NATURAL
.RS 4
NATURAL
is shorthand for a
USING
list that mentions all columns in the two tables that have matching names\&. If there are no common column names,
NATURAL
is equivalent to
ON TRUE\&.
.RE
.PP
LATERAL
.RS 4
The
LATERAL
key word can precede a sub\-\fBSELECT\fR
FROM
item\&. This allows the sub\-\fBSELECT\fR
to refer to columns of
FROM
items that appear before it in the
FROM
list\&. (Without
LATERAL, each sub\-\fBSELECT\fR
is evaluated independently and so cannot cross\-reference any other
FROM
item\&.)
.sp
LATERAL
can also precede a function\-call
FROM
item, but in this case it is a noise word, because the function expression can refer to earlier
FROM
items in any case\&.
.sp
A
LATERAL
item can appear at top level in the
FROM
list, or within a
JOIN
tree\&. In the latter case it can also refer to any items that are on the left\-hand side of a
JOIN
that it is on the right\-hand side of\&.
.sp
When a
FROM
item contains
LATERAL
cross\-references, evaluation proceeds as follows: for each row of the
FROM
item providing the cross\-referenced column(s), or set of rows of multiple
FROM
items providing the columns, the
LATERAL
item is evaluated using that row or row set\*(Aqs values of the columns\&. The resulting row(s) are joined as usual with the rows they were computed from\&. This is repeated for each row or set of rows from the column source table(s)\&.
.sp
The column source table(s) must be
INNER
or
LEFT
joined to the
LATERAL
item, else there would not be a well\-defined set of rows from which to compute each set of rows for the
LATERAL
item\&. Thus, although a construct such as
\fIX\fR RIGHT JOIN LATERAL \fIY\fR
is syntactically valid, it is not actually allowed for
\fIY\fR
to reference
\fIX\fR\&.
.RE
.SS "WHERE Clause"
.PP
The optional
WHERE
clause has the general form
.sp
.if n \{\
.RS 4
.\}
.nf
WHERE \fIcondition\fR
.fi
.if n \{\
.RE
.\}
.sp
where
\fIcondition\fR
is any expression that evaluates to a result of type
boolean\&. Any row that does not satisfy this condition will be eliminated from the output\&. A row satisfies the condition if it returns true when the actual row values are substituted for any variable references\&.
.SS "GROUP BY Clause"
.PP
The optional
GROUP BY
clause has the general form
.sp
.if n \{\
.RS 4
.\}
.nf
GROUP BY \fIgrouping_element\fR [, \&.\&.\&.]
.fi
.if n \{\
.RE
.\}
.PP
GROUP BY
will condense into a single row all selected rows that share the same values for the grouped expressions\&. An
\fIexpression\fR
used inside a
\fIgrouping_element\fR
can be an input column name, or the name or ordinal number of an output column (\fBSELECT\fR
list item), or an arbitrary expression formed from input\-column values\&. In case of ambiguity, a
GROUP BY
name will be interpreted as an input\-column name rather than an output column name\&.
.PP
If any of
GROUPING SETS,
ROLLUP
or
CUBE
are present as grouping elements, then the
GROUP BY
clause as a whole defines some number of independent
\fIgrouping sets\fR\&. The effect of this is equivalent to constructing a
UNION ALL
between subqueries with the individual grouping sets as their
GROUP BY
clauses\&. For further details on the handling of grouping sets see
Section 7.2.4, \(lqGROUPING SETS, CUBE, and ROLLUP\(rq, in the documentation\&.
.PP
Aggregate functions, if any are used, are computed across all rows making up each group, producing a separate value for each group\&. (If there are aggregate functions but no
GROUP BY
clause, the query is treated as having a single group comprising all the selected rows\&.) The set of rows fed to each aggregate function can be further filtered by attaching a
FILTER
clause to the aggregate function call; see
Section 4.2.7, \(lqAggregate Expressions\(rq, in the documentation
for more information\&. When a
FILTER
clause is present, only those rows matching it are included in the input to that aggregate function\&.
.PP
When
GROUP BY
is present, or any aggregate functions are present, it is not valid for the
\fBSELECT\fR
list expressions to refer to ungrouped columns except within aggregate functions or when the ungrouped column is functionally dependent on the grouped columns, since there would otherwise be more than one possible value to return for an ungrouped column\&. A functional dependency exists if the grouped columns (or a subset thereof) are the primary key of the table containing the ungrouped column\&.
.PP
Keep in mind that all aggregate functions are evaluated before evaluating any
\(lqscalar\(rq
expressions in the
HAVING
clause or
SELECT
list\&. This means that, for example, a
CASE
expression cannot be used to skip evaluation of an aggregate function; see
Section 4.2.14, \(lqExpression Evaluation Rules\(rq, in the documentation\&.
.PP
Currently,
FOR NO KEY UPDATE,
FOR UPDATE,
FOR SHARE
and
FOR KEY SHARE
cannot be specified with
GROUP BY\&.
.SS "HAVING Clause"
.PP
The optional
HAVING
clause has the general form
.sp
.if n \{\
.RS 4
.\}
.nf
HAVING \fIcondition\fR
.fi
.if n \{\
.RE
.\}
.sp
where
\fIcondition\fR
is the same as specified for the
WHERE
clause\&.
.PP
HAVING
eliminates group rows that do not satisfy the condition\&.
HAVING
is different from
WHERE:
WHERE
filters individual rows before the application of
GROUP BY, while
HAVING
filters group rows created by
GROUP BY\&. Each column referenced in
\fIcondition\fR
must unambiguously reference a grouping column, unless the reference appears within an aggregate function or the ungrouped column is functionally dependent on the grouping columns\&.
.PP
The presence of
HAVING
turns a query into a grouped query even if there is no
GROUP BY
clause\&. This is the same as what happens when the query contains aggregate functions but no
GROUP BY
clause\&. All the selected rows are considered to form a single group, and the
\fBSELECT\fR
list and
HAVING
clause can only reference table columns from within aggregate functions\&. Such a query will emit a single row if the
HAVING
condition is true, zero rows if it is not true\&.
.PP
Currently,
FOR NO KEY UPDATE,
FOR UPDATE,
FOR SHARE
and
FOR KEY SHARE
cannot be specified with
HAVING\&.
.SS "WINDOW Clause"
.PP
The optional
WINDOW
clause has the general form
.sp
.if n \{\
.RS 4
.\}
.nf
WINDOW \fIwindow_name\fR AS ( \fIwindow_definition\fR ) [, \&.\&.\&.]
.fi
.if n \{\
.RE
.\}
.sp
where
\fIwindow_name\fR
is a name that can be referenced from
OVER
clauses or subsequent window definitions, and
\fIwindow_definition\fR
is
.sp
.if n \{\
.RS 4
.\}
.nf
[ \fIexisting_window_name\fR ]
[ PARTITION BY \fIexpression\fR [, \&.\&.\&.] ]
[ ORDER BY \fIexpression\fR [ ASC | DESC | USING \fIoperator\fR ] [ NULLS { FIRST | LAST } ] [, \&.\&.\&.] ]
[ \fIframe_clause\fR ]
.fi
.if n \{\
.RE
.\}
.PP
If an
\fIexisting_window_name\fR
is specified it must refer to an earlier entry in the
WINDOW
list; the new window copies its partitioning clause from that entry, as well as its ordering clause if any\&. In this case the new window cannot specify its own
PARTITION BY
clause, and it can specify
ORDER BY
only if the copied window does not have one\&. The new window always uses its own frame clause; the copied window must not specify a frame clause\&.
.PP
The elements of the
PARTITION BY
list are interpreted in much the same fashion as elements of a
GROUP BY Clause, except that they are always simple expressions and never the name or number of an output column\&. Another difference is that these expressions can contain aggregate function calls, which are not allowed in a regular
GROUP BY
clause\&. They are allowed here because windowing occurs after grouping and aggregation\&.
.PP
Similarly, the elements of the
ORDER BY
list are interpreted in much the same fashion as elements of an
ORDER BY Clause, except that the expressions are always taken as simple expressions and never the name or number of an output column\&.
.PP
The optional
\fIframe_clause\fR
defines the
window frame
for window functions that depend on the frame (not all do)\&. The window frame is a set of related rows for each row of the query (called the
current row)\&. The
\fIframe_clause\fR
can be one of
.sp
.if n \{\
.RS 4
.\}
.nf
{ RANGE | ROWS } \fIframe_start\fR
{ RANGE | ROWS } BETWEEN \fIframe_start\fR AND \fIframe_end\fR
.fi
.if n \{\
.RE
.\}
.sp
where
\fIframe_start\fR
and
\fIframe_end\fR
can be one of
.sp
.if n \{\
.RS 4
.\}
.nf
UNBOUNDED PRECEDING
\fIvalue\fR PRECEDING
CURRENT ROW
\fIvalue\fR FOLLOWING
UNBOUNDED FOLLOWING
.fi
.if n \{\
.RE
.\}
.sp
If
\fIframe_end\fR
is omitted it defaults to
CURRENT ROW\&. Restrictions are that
\fIframe_start\fR
cannot be
UNBOUNDED FOLLOWING,
\fIframe_end\fR
cannot be
UNBOUNDED PRECEDING, and the
\fIframe_end\fR
choice cannot appear earlier in the above list than the
\fIframe_start\fR
choice \(em for example
RANGE BETWEEN CURRENT ROW AND \fIvalue\fR PRECEDING
is not allowed\&.
.PP
The default framing option is
RANGE UNBOUNDED PRECEDING, which is the same as
RANGE BETWEEN UNBOUNDED PRECEDING AND CURRENT ROW; it sets the frame to be all rows from the partition start up through the current row\*(Aqs last peer (a row that
ORDER BY
considers equivalent to the current row, or all rows if there is no
ORDER BY)\&. In general,
UNBOUNDED PRECEDING
means that the frame starts with the first row of the partition, and similarly
UNBOUNDED FOLLOWING
means that the frame ends with the last row of the partition (regardless of
RANGE
or
ROWS
mode)\&. In
ROWS
mode,
CURRENT ROW
means that the frame starts or ends with the current row; but in
RANGE
mode it means that the frame starts or ends with the current row\*(Aqs first or last peer in the
ORDER BY
ordering\&. The
\fIvalue\fR
PRECEDING
and
\fIvalue\fR
FOLLOWING
cases are currently only allowed in
ROWS
mode\&. They indicate that the frame starts or ends with the row that many rows before or after the current row\&.
\fIvalue\fR
must be an integer expression not containing any variables, aggregate functions, or window functions\&. The value must not be null or negative; but it can be zero, which selects the current row itself\&.
.PP
Beware that the
ROWS
options can produce unpredictable results if the
ORDER BY
ordering does not order the rows uniquely\&. The
RANGE
options are designed to ensure that rows that are peers in the
ORDER BY
ordering are treated alike; all peer rows will be in the same frame\&.
.PP
The purpose of a
WINDOW
clause is to specify the behavior of
window functions
appearing in the query\*(Aqs
SELECT List
or
ORDER BY Clause\&. These functions can reference the
WINDOW
clause entries by name in their
OVER
clauses\&. A
WINDOW
clause entry does not have to be referenced anywhere, however; if it is not used in the query it is simply ignored\&. It is possible to use window functions without any
WINDOW
clause at all, since a window function call can specify its window definition directly in its
OVER
clause\&. However, the
WINDOW
clause saves typing when the same window definition is needed for more than one window function\&.
.PP
Currently,
FOR NO KEY UPDATE,
FOR UPDATE,
FOR SHARE
and
FOR KEY SHARE
cannot be specified with
WINDOW\&.
.PP
Window functions are described in detail in
Section 3.5, \(lqWindow Functions\(rq, in the documentation,
Section 4.2.8, \(lqWindow Function Calls\(rq, in the documentation, and
Section 7.2.5, \(lqWindow Function Processing\(rq, in the documentation\&.
.SS "SELECT List"
.PP
The
\fBSELECT\fR
list (between the key words
SELECT
and
FROM) specifies expressions that form the output rows of the
\fBSELECT\fR
statement\&. The expressions can (and usually do) refer to columns computed in the
FROM
clause\&.
.PP
Just as in a table, every output column of a
\fBSELECT\fR
has a name\&. In a simple
\fBSELECT\fR
this name is just used to label the column for display, but when the
\fBSELECT\fR
is a sub\-query of a larger query, the name is seen by the larger query as the column name of the virtual table produced by the sub\-query\&. To specify the name to use for an output column, write
AS
\fIoutput_name\fR
after the column\*(Aqs expression\&. (You can omit
AS, but only if the desired output name does not match any
PostgreSQL
keyword (see
Appendix\ \&C, SQL Key Words)\&. For protection against possible future keyword additions, it is recommended that you always either write
AS
or double\-quote the output name\&.) If you do not specify a column name, a name is chosen automatically by
PostgreSQL\&. If the column\*(Aqs expression is a simple column reference then the chosen name is the same as that column\*(Aqs name\&. In more complex cases a function or type name may be used, or the system may fall back on a generated name such as
?column?\&.
.PP
An output column\*(Aqs name can be used to refer to the column\*(Aqs value in
ORDER BY
and
GROUP BY
clauses, but not in the
WHERE
or
HAVING
clauses; there you must write out the expression instead\&.
.PP
Instead of an expression,
*
can be written in the output list as a shorthand for all the columns of the selected rows\&. Also, you can write
\fItable_name\fR\&.*
as a shorthand for the columns coming from just that table\&. In these cases it is not possible to specify new names with
AS; the output column names will be the same as the table columns\*(Aq names\&.
.PP
According to the SQL standard, the expressions in the output list should be computed before applying
DISTINCT,
ORDER BY, or
LIMIT\&. This is obviously necessary when using
DISTINCT, since otherwise it\*(Aqs not clear what values are being made distinct\&. However, in many cases it is convenient if output expressions are computed after
ORDER BY
and
LIMIT; particularly if the output list contains any volatile or expensive functions\&. With that behavior, the order of function evaluations is more intuitive and there will not be evaluations corresponding to rows that never appear in the output\&.
PostgreSQL
will effectively evaluate output expressions after sorting and limiting, so long as those expressions are not referenced in
DISTINCT,
ORDER BY
or
GROUP BY\&. (As a counterexample,
SELECT f(x) FROM tab ORDER BY 1
clearly must evaluate
\fBf(x)\fR
before sorting\&.) Output expressions that contain set\-returning functions are effectively evaluated after sorting and before limiting, so that
LIMIT
will act to cut off the output from a set\-returning function\&.
.if n \{\
.sp
.\}
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBNote\fR
.ps -1
.br
.PP
PostgreSQL
versions before 9\&.6 did not provide any guarantees about the timing of evaluation of output expressions versus sorting and limiting; it depended on the form of the chosen query plan\&.
.sp .5v
.RE
.SS "DISTINCT Clause"
.PP
If
SELECT DISTINCT
is specified, all duplicate rows are removed from the result set (one row is kept from each group of duplicates)\&.
SELECT ALL
specifies the opposite: all rows are kept; that is the default\&.
.PP
SELECT DISTINCT ON ( \fIexpression\fR [, \&.\&.\&.] )
keeps only the first row of each set of rows where the given expressions evaluate to equal\&. The
DISTINCT ON
expressions are interpreted using the same rules as for
ORDER BY
(see above)\&. Note that the
\(lqfirst row\(rq
of each set is unpredictable unless
ORDER BY
is used to ensure that the desired row appears first\&. For example:
.sp
.if n \{\
.RS 4
.\}
.nf
SELECT DISTINCT ON (location) location, time, report
FROM weather_reports
ORDER BY location, time DESC;
.fi
.if n \{\
.RE
.\}
.sp
retrieves the most recent weather report for each location\&. But if we had not used
ORDER BY
to force descending order of time values for each location, we\*(Aqd have gotten a report from an unpredictable time for each location\&.
.PP
The
DISTINCT ON
expression(s) must match the leftmost
ORDER BY
expression(s)\&. The
ORDER BY
clause will normally contain additional expression(s) that determine the desired precedence of rows within each
DISTINCT ON
group\&.
.PP
Currently,
FOR NO KEY UPDATE,
FOR UPDATE,
FOR SHARE
and
FOR KEY SHARE
cannot be specified with
DISTINCT\&.
.SS "UNION Clause"
.PP
The
UNION
clause has this general form:
.sp
.if n \{\
.RS 4
.\}
.nf
\fIselect_statement\fR UNION [ ALL | DISTINCT ] \fIselect_statement\fR
.fi
.if n \{\
.RE
.\}
.sp
\fIselect_statement\fR
is any
\fBSELECT\fR
statement without an
ORDER BY,
LIMIT,
FOR NO KEY UPDATE,
FOR UPDATE,
FOR SHARE, or
FOR KEY SHARE
clause\&. (ORDER BY
and
LIMIT
can be attached to a subexpression if it is enclosed in parentheses\&. Without parentheses, these clauses will be taken to apply to the result of the
UNION, not to its right\-hand input expression\&.)
.PP
The
UNION
operator computes the set union of the rows returned by the involved
\fBSELECT\fR
statements\&. A row is in the set union of two result sets if it appears in at least one of the result sets\&. The two
\fBSELECT\fR
statements that represent the direct operands of the
UNION
must produce the same number of columns, and corresponding columns must be of compatible data types\&.
.PP
The result of
UNION
does not contain any duplicate rows unless the
ALL
option is specified\&.
ALL
prevents elimination of duplicates\&. (Therefore,
UNION ALL
is usually significantly quicker than
UNION; use
ALL
when you can\&.)
DISTINCT
can be written to explicitly specify the default behavior of eliminating duplicate rows\&.
.PP
Multiple
UNION
operators in the same
\fBSELECT\fR
statement are evaluated left to right, unless otherwise indicated by parentheses\&.
.PP
Currently,
FOR NO KEY UPDATE,
FOR UPDATE,
FOR SHARE
and
FOR KEY SHARE
cannot be specified either for a
UNION
result or for any input of a
UNION\&.
.SS "INTERSECT Clause"
.PP
The
INTERSECT
clause has this general form:
.sp
.if n \{\
.RS 4
.\}
.nf
\fIselect_statement\fR INTERSECT [ ALL | DISTINCT ] \fIselect_statement\fR
.fi
.if n \{\
.RE
.\}
.sp
\fIselect_statement\fR
is any
\fBSELECT\fR
statement without an
ORDER BY,
LIMIT,
FOR NO KEY UPDATE,
FOR UPDATE,
FOR SHARE, or
FOR KEY SHARE
clause\&.
.PP
The
INTERSECT
operator computes the set intersection of the rows returned by the involved
\fBSELECT\fR
statements\&. A row is in the intersection of two result sets if it appears in both result sets\&.
.PP
The result of
INTERSECT
does not contain any duplicate rows unless the
ALL
option is specified\&. With
ALL, a row that has
\fIm\fR
duplicates in the left table and
\fIn\fR
duplicates in the right table will appear min(\fIm\fR,\fIn\fR) times in the result set\&.
DISTINCT
can be written to explicitly specify the default behavior of eliminating duplicate rows\&.
.PP
Multiple
INTERSECT
operators in the same
\fBSELECT\fR
statement are evaluated left to right, unless parentheses dictate otherwise\&.
INTERSECT
binds more tightly than
UNION\&. That is,
A UNION B INTERSECT C
will be read as
A UNION (B INTERSECT C)\&.
.PP
Currently,
FOR NO KEY UPDATE,
FOR UPDATE,
FOR SHARE
and
FOR KEY SHARE
cannot be specified either for an
INTERSECT
result or for any input of an
INTERSECT\&.
.SS "EXCEPT Clause"
.PP
The
EXCEPT
clause has this general form:
.sp
.if n \{\
.RS 4
.\}
.nf
\fIselect_statement\fR EXCEPT [ ALL | DISTINCT ] \fIselect_statement\fR
.fi
.if n \{\
.RE
.\}
.sp
\fIselect_statement\fR
is any
\fBSELECT\fR
statement without an
ORDER BY,
LIMIT,
FOR NO KEY UPDATE,
FOR UPDATE,
FOR SHARE, or
FOR KEY SHARE
clause\&.
.PP
The
EXCEPT
operator computes the set of rows that are in the result of the left
\fBSELECT\fR
statement but not in the result of the right one\&.
.PP
The result of
EXCEPT
does not contain any duplicate rows unless the
ALL
option is specified\&. With
ALL, a row that has
\fIm\fR
duplicates in the left table and
\fIn\fR
duplicates in the right table will appear max(\fIm\fR\-\fIn\fR,0) times in the result set\&.
DISTINCT
can be written to explicitly specify the default behavior of eliminating duplicate rows\&.
.PP
Multiple
EXCEPT
operators in the same
\fBSELECT\fR
statement are evaluated left to right, unless parentheses dictate otherwise\&.
EXCEPT
binds at the same level as
UNION\&.
.PP
Currently,
FOR NO KEY UPDATE,
FOR UPDATE,
FOR SHARE
and
FOR KEY SHARE
cannot be specified either for an
EXCEPT
result or for any input of an
EXCEPT\&.
.SS "ORDER BY Clause"
.PP
The optional
ORDER BY
clause has this general form:
.sp
.if n \{\
.RS 4
.\}
.nf
ORDER BY \fIexpression\fR [ ASC | DESC | USING \fIoperator\fR ] [ NULLS { FIRST | LAST } ] [, \&.\&.\&.]
.fi
.if n \{\
.RE
.\}
.sp
The
ORDER BY
clause causes the result rows to be sorted according to the specified expression(s)\&. If two rows are equal according to the leftmost expression, they are compared according to the next expression and so on\&. If they are equal according to all specified expressions, they are returned in an implementation\-dependent order\&.
.PP
Each
\fIexpression\fR
can be the name or ordinal number of an output column (\fBSELECT\fR
list item), or it can be an arbitrary expression formed from input\-column values\&.
.PP
The ordinal number refers to the ordinal (left\-to\-right) position of the output column\&. This feature makes it possible to define an ordering on the basis of a column that does not have a unique name\&. This is never absolutely necessary because it is always possible to assign a name to an output column using the
AS
clause\&.
.PP
It is also possible to use arbitrary expressions in the
ORDER BY
clause, including columns that do not appear in the
\fBSELECT\fR
output list\&. Thus the following statement is valid:
.sp
.if n \{\
.RS 4
.\}
.nf
SELECT name FROM distributors ORDER BY code;
.fi
.if n \{\
.RE
.\}
.sp
A limitation of this feature is that an
ORDER BY
clause applying to the result of a
UNION,
INTERSECT, or
EXCEPT
clause can only specify an output column name or number, not an expression\&.
.PP
If an
ORDER BY
expression is a simple name that matches both an output column name and an input column name,
ORDER BY
will interpret it as the output column name\&. This is the opposite of the choice that
GROUP BY
will make in the same situation\&. This inconsistency is made to be compatible with the SQL standard\&.
.PP
Optionally one can add the key word
ASC
(ascending) or
DESC
(descending) after any expression in the
ORDER BY
clause\&. If not specified,
ASC
is assumed by default\&. Alternatively, a specific ordering operator name can be specified in the
USING
clause\&. An ordering operator must be a less\-than or greater\-than member of some B\-tree operator family\&.
ASC
is usually equivalent to
USING <
and
DESC
is usually equivalent to
USING >\&. (But the creator of a user\-defined data type can define exactly what the default sort ordering is, and it might correspond to operators with other names\&.)
.PP
If
NULLS LAST
is specified, null values sort after all non\-null values; if
NULLS FIRST
is specified, null values sort before all non\-null values\&. If neither is specified, the default behavior is
NULLS LAST
when
ASC
is specified or implied, and
NULLS FIRST
when
DESC
is specified (thus, the default is to act as though nulls are larger than non\-nulls)\&. When
USING
is specified, the default nulls ordering depends on whether the operator is a less\-than or greater\-than operator\&.
.PP
Note that ordering options apply only to the expression they follow; for example
ORDER BY x, y DESC
does not mean the same thing as
ORDER BY x DESC, y DESC\&.
.PP
Character\-string data is sorted according to the collation that applies to the column being sorted\&. That can be overridden at need by including a
COLLATE
clause in the
\fIexpression\fR, for example
ORDER BY mycolumn COLLATE "en_US"\&. For more information see
Section 4.2.10, \(lqCollation Expressions\(rq, in the documentation
and
Section 23.2, \(lqCollation Support\(rq, in the documentation\&.
.SS "LIMIT Clause"
.PP
The
LIMIT
clause consists of two independent sub\-clauses:
.sp
.if n \{\
.RS 4
.\}
.nf
LIMIT { \fIcount\fR | ALL }
OFFSET \fIstart\fR
.fi
.if n \{\
.RE
.\}
.sp
\fIcount\fR
specifies the maximum number of rows to return, while
\fIstart\fR
specifies the number of rows to skip before starting to return rows\&. When both are specified,
\fIstart\fR
rows are skipped before starting to count the
\fIcount\fR
rows to be returned\&.
.PP
If the
\fIcount\fR
expression evaluates to NULL, it is treated as
LIMIT ALL, i\&.e\&., no limit\&. If
\fIstart\fR
evaluates to NULL, it is treated the same as
OFFSET 0\&.
.PP
SQL:2008 introduced a different syntax to achieve the same result, which
PostgreSQL
also supports\&. It is:
.sp
.if n \{\
.RS 4
.\}
.nf
OFFSET \fIstart\fR { ROW | ROWS }
FETCH { FIRST | NEXT } [ \fIcount\fR ] { ROW | ROWS } ONLY
.fi
.if n \{\
.RE
.\}
.sp
In this syntax, the
\fIstart\fR
or
\fIcount\fR
value is required by the standard to be a literal constant, a parameter, or a variable name; as a
PostgreSQL
extension, other expressions are allowed, but will generally need to be enclosed in parentheses to avoid ambiguity\&. If
\fIcount\fR
is omitted in a
FETCH
clause, it defaults to 1\&.
ROW
and
ROWS
as well as
FIRST
and
NEXT
are noise words that don\*(Aqt influence the effects of these clauses\&. According to the standard, the
OFFSET
clause must come before the
FETCH
clause if both are present; but
PostgreSQL
is laxer and allows either order\&.
.PP
When using
LIMIT, it is a good idea to use an
ORDER BY
clause that constrains the result rows into a unique order\&. Otherwise you will get an unpredictable subset of the query\*(Aqs rows \(em you might be asking for the tenth through twentieth rows, but tenth through twentieth in what ordering? You don\*(Aqt know what ordering unless you specify
ORDER BY\&.
.PP
The query planner takes
LIMIT
into account when generating a query plan, so you are very likely to get different plans (yielding different row orders) depending on what you use for
LIMIT
and
OFFSET\&. Thus, using different
LIMIT/OFFSET
values to select different subsets of a query result
\fIwill give inconsistent results\fR
unless you enforce a predictable result ordering with
ORDER BY\&. This is not a bug; it is an inherent consequence of the fact that SQL does not promise to deliver the results of a query in any particular order unless
ORDER BY
is used to constrain the order\&.
.PP
It is even possible for repeated executions of the same
LIMIT
query to return different subsets of the rows of a table, if there is not an
ORDER BY
to enforce selection of a deterministic subset\&. Again, this is not a bug; determinism of the results is simply not guaranteed in such a case\&.
.SS "The Locking Clause"
.PP
FOR UPDATE,
FOR NO KEY UPDATE,
FOR SHARE
and
FOR KEY SHARE
are
locking clauses; they affect how
SELECT
locks rows as they are obtained from the table\&.
.PP
The locking clause has the general form
.sp
.if n \{\
.RS 4
.\}
.nf
FOR \fIlock_strength\fR [ OF \fItable_name\fR [, \&.\&.\&.] ] [ NOWAIT | SKIP LOCKED ]
.fi
.if n \{\
.RE
.\}
.sp
where
\fIlock_strength\fR
can be one of
.sp
.if n \{\
.RS 4
.\}
.nf
UPDATE
NO KEY UPDATE
SHARE
KEY SHARE
.fi
.if n \{\
.RE
.\}
.PP
For more information on each row\-level lock mode, refer to
Section 13.3.2, \(lqRow-level Locks\(rq, in the documentation\&.
.PP
To prevent the operation from waiting for other transactions to commit, use either the
NOWAIT
or
SKIP LOCKED
option\&. With
NOWAIT, the statement reports an error, rather than waiting, if a selected row cannot be locked immediately\&. With
SKIP LOCKED, any selected rows that cannot be immediately locked are skipped\&. Skipping locked rows provides an inconsistent view of the data, so this is not suitable for general purpose work, but can be used to avoid lock contention with multiple consumers accessing a queue\-like table\&. Note that
NOWAIT
and
SKIP LOCKED
apply only to the row\-level lock(s) \(em the required
ROW SHARE
table\-level lock is still taken in the ordinary way (see
Chapter 13, Concurrency Control, in the documentation)\&. You can use
\fBLOCK\fR(7)
with the
NOWAIT
option first, if you need to acquire the table\-level lock without waiting\&.
.PP
If specific tables are named in a locking clause, then only rows coming from those tables are locked; any other tables used in the
\fBSELECT\fR
are simply read as usual\&. A locking clause without a table list affects all tables used in the statement\&. If a locking clause is applied to a view or sub\-query, it affects all tables used in the view or sub\-query\&. However, these clauses do not apply to
WITH
queries referenced by the primary query\&. If you want row locking to occur within a
WITH
query, specify a locking clause within the
WITH
query\&.
.PP
Multiple locking clauses can be written if it is necessary to specify different locking behavior for different tables\&. If the same table is mentioned (or implicitly affected) by more than one locking clause, then it is processed as if it was only specified by the strongest one\&. Similarly, a table is processed as
NOWAIT
if that is specified in any of the clauses affecting it\&. Otherwise, it is processed as
SKIP LOCKED
if that is specified in any of the clauses affecting it\&.
.PP
The locking clauses cannot be used in contexts where returned rows cannot be clearly identified with individual table rows; for example they cannot be used with aggregation\&.
.PP
When a locking clause appears at the top level of a
\fBSELECT\fR
query, the rows that are locked are exactly those that are returned by the query; in the case of a join query, the rows locked are those that contribute to returned join rows\&. In addition, rows that satisfied the query conditions as of the query snapshot will be locked, although they will not be returned if they were updated after the snapshot and no longer satisfy the query conditions\&. If a
LIMIT
is used, locking stops once enough rows have been returned to satisfy the limit (but note that rows skipped over by
OFFSET
will get locked)\&. Similarly, if a locking clause is used in a cursor\*(Aqs query, only rows actually fetched or stepped past by the cursor will be locked\&.
.PP
When a locking clause appears in a sub\-\fBSELECT\fR, the rows locked are those returned to the outer query by the sub\-query\&. This might involve fewer rows than inspection of the sub\-query alone would suggest, since conditions from the outer query might be used to optimize execution of the sub\-query\&. For example,
.sp
.if n \{\
.RS 4
.\}
.nf
SELECT * FROM (SELECT * FROM mytable FOR UPDATE) ss WHERE col1 = 5;
.fi
.if n \{\
.RE
.\}
.sp
will lock only rows having
col1 = 5, even though that condition is not textually within the sub\-query\&.
.PP
Previous releases failed to preserve a lock which is upgraded by a later savepoint\&. For example, this code:
.sp
.if n \{\
.RS 4
.\}
.nf
BEGIN;
SELECT * FROM mytable WHERE key = 1 FOR UPDATE;
SAVEPOINT s;
UPDATE mytable SET \&.\&.\&. WHERE key = 1;
ROLLBACK TO s;
.fi
.if n \{\
.RE
.\}
.sp
would fail to preserve the
FOR UPDATE
lock after the
\fBROLLBACK TO\fR\&. This has been fixed in release 9\&.3\&.
.if n \{\
.sp
.\}
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBCaution\fR
.ps -1
.br
.PP
It is possible for a
\fBSELECT\fR
command running at the
READ COMMITTED
transaction isolation level and using
ORDER BY
and a locking clause to return rows out of order\&. This is because
ORDER BY
is applied first\&. The command sorts the result, but might then block trying to obtain a lock on one or more of the rows\&. Once the
SELECT
unblocks, some of the ordering column values might have been modified, leading to those rows appearing to be out of order (though they are in order in terms of the original column values)\&. This can be worked around at need by placing the
FOR UPDATE/SHARE
clause in a sub\-query, for example
.sp
.if n \{\
.RS 4
.\}
.nf
SELECT * FROM (SELECT * FROM mytable FOR UPDATE) ss ORDER BY column1;
.fi
.if n \{\
.RE
.\}
.sp
Note that this will result in locking all rows of
mytable, whereas
FOR UPDATE
at the top level would lock only the actually returned rows\&. This can make for a significant performance difference, particularly if the
ORDER BY
is combined with
LIMIT
or other restrictions\&. So this technique is recommended only if concurrent updates of the ordering columns are expected and a strictly sorted result is required\&.
.PP
At the
REPEATABLE READ
or
SERIALIZABLE
transaction isolation level this would cause a serialization failure (with a
SQLSTATE
of
\*(Aq40001\*(Aq), so there is no possibility of receiving rows out of order under these isolation levels\&.
.sp .5v
.RE
.SS "TABLE Command"
.PP
The command
.sp
.if n \{\
.RS 4
.\}
.nf
TABLE \fIname\fR
.fi
.if n \{\
.RE
.\}
.sp
is equivalent to
.sp
.if n \{\
.RS 4
.\}
.nf
SELECT * FROM \fIname\fR
.fi
.if n \{\
.RE
.\}
.sp
It can be used as a top\-level command or as a space\-saving syntax variant in parts of complex queries\&. Only the
WITH,
UNION,
INTERSECT,
EXCEPT,
ORDER BY,
LIMIT,
OFFSET,
FETCH
and
FOR
locking clauses can be used with
\fBTABLE\fR; the
WHERE
clause and any form of aggregation cannot be used\&.
.SH "EXAMPLES"
.PP
To join the table
films
with the table
distributors:
.sp
.if n \{\
.RS 4
.\}
.nf
SELECT f\&.title, f\&.did, d\&.name, f\&.date_prod, f\&.kind
FROM distributors d, films f
WHERE f\&.did = d\&.did
title | did | name | date_prod | kind
\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-\-\-\-\-\-\-\-\-\-+\-\-\-\-\-\-\-\-\-\-\-\-+\-\-\-\-\-\-\-\-\-\-
The Third Man | 101 | British Lion | 1949\-12\-23 | Drama
The African Queen | 101 | British Lion | 1951\-08\-11 | Romantic
\&.\&.\&.
.fi
.if n \{\
.RE
.\}
.PP
To sum the column
len
of all films and group the results by
kind:
.sp
.if n \{\
.RS 4
.\}
.nf
SELECT kind, sum(len) AS total FROM films GROUP BY kind;
kind | total
\-\-\-\-\-\-\-\-\-\-+\-\-\-\-\-\-\-
Action | 07:34
Comedy | 02:58
Drama | 14:28
Musical | 06:42
Romantic | 04:38
.fi
.if n \{\
.RE
.\}
.PP
To sum the column
len
of all films, group the results by
kind
and show those group totals that are less than 5 hours:
.sp
.if n \{\
.RS 4
.\}
.nf
SELECT kind, sum(len) AS total
FROM films
GROUP BY kind
HAVING sum(len) < interval \*(Aq5 hours\*(Aq;
kind | total
\-\-\-\-\-\-\-\-\-\-+\-\-\-\-\-\-\-
Comedy | 02:58
Romantic | 04:38
.fi
.if n \{\
.RE
.\}
.PP
The following two examples are identical ways of sorting the individual results according to the contents of the second column (name):
.sp
.if n \{\
.RS 4
.\}
.nf
SELECT * FROM distributors ORDER BY name;
SELECT * FROM distributors ORDER BY 2;
did | name
\-\-\-\-\-+\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
109 | 20th Century Fox
110 | Bavaria Atelier
101 | British Lion
107 | Columbia
102 | Jean Luc Godard
113 | Luso films
104 | Mosfilm
103 | Paramount
106 | Toho
105 | United Artists
111 | Walt Disney
112 | Warner Bros\&.
108 | Westward
.fi
.if n \{\
.RE
.\}
.PP
The next example shows how to obtain the union of the tables
distributors
and
actors, restricting the results to those that begin with the letter W in each table\&. Only distinct rows are wanted, so the key word
ALL
is omitted\&.
.sp
.if n \{\
.RS 4
.\}
.nf
distributors: actors:
did | name id | name
\-\-\-\-\-+\-\-\-\-\-\-\-\-\-\-\-\-\-\- \-\-\-\-+\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
108 | Westward 1 | Woody Allen
111 | Walt Disney 2 | Warren Beatty
112 | Warner Bros\&. 3 | Walter Matthau
\&.\&.\&. \&.\&.\&.
SELECT distributors\&.name
FROM distributors
WHERE distributors\&.name LIKE \*(AqW%\*(Aq
UNION
SELECT actors\&.name
FROM actors
WHERE actors\&.name LIKE \*(AqW%\*(Aq;
name
\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
Walt Disney
Walter Matthau
Warner Bros\&.
Warren Beatty
Westward
Woody Allen
.fi
.if n \{\
.RE
.\}
.PP
This example shows how to use a function in the
FROM
clause, both with and without a column definition list:
.sp
.if n \{\
.RS 4
.\}
.nf
CREATE FUNCTION distributors(int) RETURNS SETOF distributors AS $$
SELECT * FROM distributors WHERE did = $1;
$$ LANGUAGE SQL;
SELECT * FROM distributors(111);
did | name
\-\-\-\-\-+\-\-\-\-\-\-\-\-\-\-\-\-\-
111 | Walt Disney
CREATE FUNCTION distributors_2(int) RETURNS SETOF record AS $$
SELECT * FROM distributors WHERE did = $1;
$$ LANGUAGE SQL;
SELECT * FROM distributors_2(111) AS (f1 int, f2 text);
f1 | f2
\-\-\-\-\-+\-\-\-\-\-\-\-\-\-\-\-\-\-
111 | Walt Disney
.fi
.if n \{\
.RE
.\}
.PP
Here is an example of a function with an ordinality column added:
.sp
.if n \{\
.RS 4
.\}
.nf
SELECT * FROM unnest(ARRAY[\*(Aqa\*(Aq,\*(Aqb\*(Aq,\*(Aqc\*(Aq,\*(Aqd\*(Aq,\*(Aqe\*(Aq,\*(Aqf\*(Aq]) WITH ORDINALITY;
unnest | ordinality
\-\-\-\-\-\-\-\-+\-\-\-\-\-\-\-\-\-\-
a | 1
b | 2
c | 3
d | 4
e | 5
f | 6
(6 rows)
.fi
.if n \{\
.RE
.\}
.PP
This example shows how to use a simple
WITH
clause:
.sp
.if n \{\
.RS 4
.\}
.nf
WITH t AS (
SELECT random() as x FROM generate_series(1, 3)
)
SELECT * FROM t
UNION ALL
SELECT * FROM t
x
\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
0\&.534150459803641
0\&.520092216785997
0\&.0735620250925422
0\&.534150459803641
0\&.520092216785997
0\&.0735620250925422
.fi
.if n \{\
.RE
.\}
.sp
Notice that the
WITH
query was evaluated only once, so that we got two sets of the same three random values\&.
.PP
This example uses
WITH RECURSIVE
to find all subordinates (direct or indirect) of the employee Mary, and their level of indirectness, from a table that shows only direct subordinates:
.sp
.if n \{\
.RS 4
.\}
.nf
WITH RECURSIVE employee_recursive(distance, employee_name, manager_name) AS (
SELECT 1, employee_name, manager_name
FROM employee
WHERE manager_name = \*(AqMary\*(Aq
UNION ALL
SELECT er\&.distance + 1, e\&.employee_name, e\&.manager_name
FROM employee_recursive er, employee e
WHERE er\&.employee_name = e\&.manager_name
)
SELECT distance, employee_name FROM employee_recursive;
.fi
.if n \{\
.RE
.\}
.sp
Notice the typical form of recursive queries: an initial condition, followed by
UNION, followed by the recursive part of the query\&. Be sure that the recursive part of the query will eventually return no tuples, or else the query will loop indefinitely\&. (See
Section 7.8, \(lqWITH Queries (Common Table Expressions)\(rq, in the documentation
for more examples\&.)
.PP
This example uses
LATERAL
to apply a set\-returning function
\fBget_product_names()\fR
for each row of the
manufacturers
table:
.sp
.if n \{\
.RS 4
.\}
.nf
SELECT m\&.name AS mname, pname
FROM manufacturers m, LATERAL get_product_names(m\&.id) pname;
.fi
.if n \{\
.RE
.\}
.sp
Manufacturers not currently having any products would not appear in the result, since it is an inner join\&. If we wished to include the names of such manufacturers in the result, we could do:
.sp
.if n \{\
.RS 4
.\}
.nf
SELECT m\&.name AS mname, pname
FROM manufacturers m LEFT JOIN LATERAL get_product_names(m\&.id) pname ON true;
.fi
.if n \{\
.RE
.\}
.SH "COMPATIBILITY"
.PP
Of course, the
\fBSELECT\fR
statement is compatible with the SQL standard\&. But there are some extensions and some missing features\&.
.SS "Omitted FROM Clauses"
.PP
PostgreSQL
allows one to omit the
FROM
clause\&. It has a straightforward use to compute the results of simple expressions:
.sp
.if n \{\
.RS 4
.\}
.nf
SELECT 2+2;
?column?
\-\-\-\-\-\-\-\-\-\-
4
.fi
.if n \{\
.RE
.\}
.sp
Some other
SQL
databases cannot do this except by introducing a dummy one\-row table from which to do the
\fBSELECT\fR\&.
.PP
Note that if a
FROM
clause is not specified, the query cannot reference any database tables\&. For example, the following query is invalid:
.sp
.if n \{\
.RS 4
.\}
.nf
SELECT distributors\&.* WHERE distributors\&.name = \*(AqWestward\*(Aq;
.fi
.if n \{\
.RE
.\}
.sp
PostgreSQL
releases prior to 8\&.1 would accept queries of this form, and add an implicit entry to the query\*(Aqs
FROM
clause for each table referenced by the query\&. This is no longer allowed\&.
.SS "Empty SELECT Lists"
.PP
The list of output expressions after
SELECT
can be empty, producing a zero\-column result table\&. This is not valid syntax according to the SQL standard\&.
PostgreSQL
allows it to be consistent with allowing zero\-column tables\&. However, an empty list is not allowed when
DISTINCT
is used\&.
.SS "Omitting the AS Key Word"
.PP
In the SQL standard, the optional key word
AS
can be omitted before an output column name whenever the new column name is a valid column name (that is, not the same as any reserved keyword)\&.
PostgreSQL
is slightly more restrictive:
AS
is required if the new column name matches any keyword at all, reserved or not\&. Recommended practice is to use
AS
or double\-quote output column names, to prevent any possible conflict against future keyword additions\&.
.PP
In
FROM
items, both the standard and
PostgreSQL
allow
AS
to be omitted before an alias that is an unreserved keyword\&. But this is impractical for output column names, because of syntactic ambiguities\&.
.SS "ONLY and Inheritance"
.PP
The SQL standard requires parentheses around the table name when writing
ONLY, for example
SELECT * FROM ONLY (tab1), ONLY (tab2) WHERE \&.\&.\&.\&.
PostgreSQL
considers these parentheses to be optional\&.
.PP
PostgreSQL
allows a trailing
*
to be written to explicitly specify the non\-ONLY
behavior of including child tables\&. The standard does not allow this\&.
.PP
(These points apply equally to all SQL commands supporting the
ONLY
option\&.)
.SS "TABLESAMPLE Clause Restrictions"
.PP
The
TABLESAMPLE
clause is currently accepted only on regular tables and materialized views\&. According to the SQL standard it should be possible to apply it to any
FROM
item\&.
.SS "Function Calls in FROM"
.PP
PostgreSQL
allows a function call to be written directly as a member of the
FROM
list\&. In the SQL standard it would be necessary to wrap such a function call in a sub\-\fBSELECT\fR; that is, the syntax
FROM \fIfunc\fR(\&.\&.\&.) \fIalias\fR
is approximately equivalent to
FROM LATERAL (SELECT \fIfunc\fR(\&.\&.\&.)) \fIalias\fR\&. Note that
LATERAL
is considered to be implicit; this is because the standard requires
LATERAL
semantics for an
UNNEST()
item in
FROM\&.
PostgreSQL
treats
UNNEST()
the same as other set\-returning functions\&.
.SS "Namespace Available to GROUP BY and ORDER BY"
.PP
In the SQL\-92 standard, an
ORDER BY
clause can only use output column names or numbers, while a
GROUP BY
clause can only use expressions based on input column names\&.
PostgreSQL
extends each of these clauses to allow the other choice as well (but it uses the standard\*(Aqs interpretation if there is ambiguity)\&.
PostgreSQL
also allows both clauses to specify arbitrary expressions\&. Note that names appearing in an expression will always be taken as input\-column names, not as output\-column names\&.
.PP
SQL:1999 and later use a slightly different definition which is not entirely upward compatible with SQL\-92\&. In most cases, however,
PostgreSQL
will interpret an
ORDER BY
or
GROUP BY
expression the same way SQL:1999 does\&.
.SS "Functional Dependencies"
.PP
PostgreSQL
recognizes functional dependency (allowing columns to be omitted from
GROUP BY) only when a table\*(Aqs primary key is included in the
GROUP BY
list\&. The SQL standard specifies additional conditions that should be recognized\&.
.SS "WINDOW Clause Restrictions"
.PP
The SQL standard provides additional options for the window
\fIframe_clause\fR\&.
PostgreSQL
currently supports only the options listed above\&.
.SS "LIMIT and OFFSET"
.PP
The clauses
LIMIT
and
OFFSET
are
PostgreSQL\-specific syntax, also used by
MySQL\&. The SQL:2008 standard has introduced the clauses
OFFSET \&.\&.\&. FETCH {FIRST|NEXT} \&.\&.\&.
for the same functionality, as shown above in
LIMIT Clause\&. This syntax is also used by
IBM DB2\&. (Applications written for
Oracle
frequently use a workaround involving the automatically generated
rownum
column, which is not available in PostgreSQL, to implement the effects of these clauses\&.)
.SS "FOR NO KEY UPDATE, FOR UPDATE, FOR SHARE, FOR KEY SHARE"
.PP
Although
FOR UPDATE
appears in the SQL standard, the standard allows it only as an option of
\fBDECLARE CURSOR\fR\&.
PostgreSQL
allows it in any
\fBSELECT\fR
query as well as in sub\-\fBSELECT\fRs, but this is an extension\&. The
FOR NO KEY UPDATE,
FOR SHARE
and
FOR KEY SHARE
variants, as well as the
NOWAIT
and
SKIP LOCKED
options, do not appear in the standard\&.
.SS "Data\-Modifying Statements in WITH"
.PP
PostgreSQL
allows
\fBINSERT\fR,
\fBUPDATE\fR, and
\fBDELETE\fR
to be used as
WITH
queries\&. This is not found in the SQL standard\&.
.SS "Nonstandard Clauses"
.PP
DISTINCT ON ( \&.\&.\&. )
is an extension of the SQL standard\&.
.PP
ROWS FROM( \&.\&.\&. )
is an extension of the SQL standard\&.
man/man7/CREATE_SCHEMA.7 0000644 00000014240 14751153421 0010240 0 ustar 00 '\" t
.\" Title: CREATE SCHEMA
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "CREATE SCHEMA" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
CREATE_SCHEMA \- define a new schema
.SH "SYNOPSIS"
.sp
.nf
CREATE SCHEMA \fIschema_name\fR [ AUTHORIZATION \fIrole_specification\fR ] [ \fIschema_element\fR [ \&.\&.\&. ] ]
CREATE SCHEMA AUTHORIZATION \fIrole_specification\fR [ \fIschema_element\fR [ \&.\&.\&. ] ]
CREATE SCHEMA IF NOT EXISTS \fIschema_name\fR [ AUTHORIZATION \fIrole_specification\fR ]
CREATE SCHEMA IF NOT EXISTS AUTHORIZATION \fIrole_specification\fR
where \fIrole_specification\fR can be:
\fIuser_name\fR
| CURRENT_USER
| SESSION_USER
.fi
.SH "DESCRIPTION"
.PP
\fBCREATE SCHEMA\fR
enters a new schema into the current database\&. The schema name must be distinct from the name of any existing schema in the current database\&.
.PP
A schema is essentially a namespace: it contains named objects (tables, data types, functions, and operators) whose names can duplicate those of other objects existing in other schemas\&. Named objects are accessed either by
\(lqqualifying\(rq
their names with the schema name as a prefix, or by setting a search path that includes the desired schema(s)\&. A
CREATE
command specifying an unqualified object name creates the object in the current schema (the one at the front of the search path, which can be determined with the function
\fBcurrent_schema\fR)\&.
.PP
Optionally,
\fBCREATE SCHEMA\fR
can include subcommands to create objects within the new schema\&. The subcommands are treated essentially the same as separate commands issued after creating the schema, except that if the
AUTHORIZATION
clause is used, all the created objects will be owned by that user\&.
.SH "PARAMETERS"
.PP
\fIschema_name\fR
.RS 4
The name of a schema to be created\&. If this is omitted, the
\fIuser_name\fR
is used as the schema name\&. The name cannot begin with
pg_, as such names are reserved for system schemas\&.
.RE
.PP
\fIuser_name\fR
.RS 4
The role name of the user who will own the new schema\&. If omitted, defaults to the user executing the command\&. To create a schema owned by another role, you must be a direct or indirect member of that role, or be a superuser\&.
.RE
.PP
\fIschema_element\fR
.RS 4
An SQL statement defining an object to be created within the schema\&. Currently, only
\fBCREATE TABLE\fR,
\fBCREATE VIEW\fR,
\fBCREATE INDEX\fR,
\fBCREATE SEQUENCE\fR,
\fBCREATE TRIGGER\fR
and
\fBGRANT\fR
are accepted as clauses within
\fBCREATE SCHEMA\fR\&. Other kinds of objects may be created in separate commands after the schema is created\&.
.RE
.PP
IF NOT EXISTS
.RS 4
Do nothing (except issuing a notice) if a schema with the same name already exists\&.
\fIschema_element\fR
subcommands cannot be included when this option is used\&.
.RE
.SH "NOTES"
.PP
To create a schema, the invoking user must have the
CREATE
privilege for the current database\&. (Of course, superusers bypass this check\&.)
.SH "EXAMPLES"
.PP
Create a schema:
.sp
.if n \{\
.RS 4
.\}
.nf
CREATE SCHEMA myschema;
.fi
.if n \{\
.RE
.\}
.PP
Create a schema for user
joe; the schema will also be named
joe:
.sp
.if n \{\
.RS 4
.\}
.nf
CREATE SCHEMA AUTHORIZATION joe;
.fi
.if n \{\
.RE
.\}
.PP
Create a schema named
test
that will be owned by user
joe, unless there already is a schema named
test\&. (It does not matter whether
joe
owns the pre\-existing schema\&.)
.sp
.if n \{\
.RS 4
.\}
.nf
CREATE SCHEMA IF NOT EXISTS test AUTHORIZATION joe;
.fi
.if n \{\
.RE
.\}
.PP
Create a schema and create a table and view within it:
.sp
.if n \{\
.RS 4
.\}
.nf
CREATE SCHEMA hollywood
CREATE TABLE films (title text, release date, awards text[])
CREATE VIEW winners AS
SELECT title, release FROM films WHERE awards IS NOT NULL;
.fi
.if n \{\
.RE
.\}
.sp
Notice that the individual subcommands do not end with semicolons\&.
.PP
The following is an equivalent way of accomplishing the same result:
.sp
.if n \{\
.RS 4
.\}
.nf
CREATE SCHEMA hollywood;
CREATE TABLE hollywood\&.films (title text, release date, awards text[]);
CREATE VIEW hollywood\&.winners AS
SELECT title, release FROM hollywood\&.films WHERE awards IS NOT NULL;
.fi
.if n \{\
.RE
.\}
.SH "COMPATIBILITY"
.PP
The SQL standard allows a
DEFAULT CHARACTER SET
clause in
\fBCREATE SCHEMA\fR, as well as more subcommand types than are presently accepted by
PostgreSQL\&.
.PP
The SQL standard specifies that the subcommands in
\fBCREATE SCHEMA\fR
can appear in any order\&. The present
PostgreSQL
implementation does not handle all cases of forward references in subcommands; it might sometimes be necessary to reorder the subcommands in order to avoid forward references\&.
.PP
According to the SQL standard, the owner of a schema always owns all objects within it\&.
PostgreSQL
allows schemas to contain objects owned by users other than the schema owner\&. This can happen only if the schema owner grants the
CREATE
privilege on their schema to someone else, or a superuser chooses to create objects in it\&.
.PP
The
IF NOT EXISTS
option is a
PostgreSQL
extension\&.
.SH "SEE ALSO"
ALTER SCHEMA (\fBALTER_SCHEMA\fR(7)), DROP SCHEMA (\fBDROP_SCHEMA\fR(7))
man/man7/TABLE.7 0000644 00000000022 14751153421 0007075 0 ustar 00 .so man7/SELECT.7
man/man7/COPY.7 0000644 00000074276 14751153421 0007046 0 ustar 00 '\" t
.\" Title: COPY
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "COPY" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
COPY \- copy data between a file and a table
.SH "SYNOPSIS"
.sp
.nf
COPY \fItable_name\fR [ ( \fIcolumn_name\fR [, \&.\&.\&.] ) ]
FROM { \*(Aq\fIfilename\fR\*(Aq | PROGRAM \*(Aq\fIcommand\fR\*(Aq | STDIN }
[ [ WITH ] ( \fIoption\fR [, \&.\&.\&.] ) ]
COPY { \fItable_name\fR [ ( \fIcolumn_name\fR [, \&.\&.\&.] ) ] | ( \fIquery\fR ) }
TO { \*(Aq\fIfilename\fR\*(Aq | PROGRAM \*(Aq\fIcommand\fR\*(Aq | STDOUT }
[ [ WITH ] ( \fIoption\fR [, \&.\&.\&.] ) ]
where \fIoption\fR can be one of:
FORMAT \fIformat_name\fR
OIDS [ \fIboolean\fR ]
FREEZE [ \fIboolean\fR ]
DELIMITER \*(Aq\fIdelimiter_character\fR\*(Aq
NULL \*(Aq\fInull_string\fR\*(Aq
HEADER [ \fIboolean\fR ]
QUOTE \*(Aq\fIquote_character\fR\*(Aq
ESCAPE \*(Aq\fIescape_character\fR\*(Aq
FORCE_QUOTE { ( \fIcolumn_name\fR [, \&.\&.\&.] ) | * }
FORCE_NOT_NULL ( \fIcolumn_name\fR [, \&.\&.\&.] )
FORCE_NULL ( \fIcolumn_name\fR [, \&.\&.\&.] )
ENCODING \*(Aq\fIencoding_name\fR\*(Aq
.fi
.SH "DESCRIPTION"
.PP
\fBCOPY\fR
moves data between
PostgreSQL
tables and standard file\-system files\&.
\fBCOPY TO\fR
copies the contents of a table
\fIto\fR
a file, while
\fBCOPY FROM\fR
copies data
\fIfrom\fR
a file to a table (appending the data to whatever is in the table already)\&.
\fBCOPY TO\fR
can also copy the results of a
\fBSELECT\fR
query\&.
.PP
If a column list is specified,
\fBCOPY TO\fR
copies only the data in the specified columns to the file\&. For
\fBCOPY FROM\fR, each field in the file is inserted, in order, into the specified column\&. Table columns not specified in the
\fBCOPY FROM\fR
column list will receive their default values\&.
.PP
\fBCOPY\fR
with a file name instructs the
PostgreSQL
server to directly read from or write to a file\&. The file must be accessible by the
PostgreSQL
user (the user ID the server runs as) and the name must be specified from the viewpoint of the server\&. When
PROGRAM
is specified, the server executes the given command and reads from the standard output of the program, or writes to the standard input of the program\&. The command must be specified from the viewpoint of the server, and be executable by the
PostgreSQL
user\&. When
STDIN
or
STDOUT
is specified, data is transmitted via the connection between the client and the server\&.
.SH "PARAMETERS"
.PP
\fItable_name\fR
.RS 4
The name (optionally schema\-qualified) of an existing table\&.
.RE
.PP
\fIcolumn_name\fR
.RS 4
An optional list of columns to be copied\&. If no column list is specified, all columns of the table will be copied\&.
.RE
.PP
\fIquery\fR
.RS 4
A
\fBSELECT\fR(7),
\fBVALUES\fR(7),
\fBINSERT\fR(7),
\fBUPDATE\fR(7)
or
\fBDELETE\fR(7)
command whose results are to be copied\&. Note that parentheses are required around the query\&.
.sp
For
\fBINSERT\fR,
\fBUPDATE\fR
and
\fBDELETE\fR
queries a RETURNING clause must be provided, and the target relation must not have a conditional rule, nor an
ALSO
rule, nor an
INSTEAD
rule that expands to multiple statements\&.
.RE
.PP
\fIfilename\fR
.RS 4
The path name of the input or output file\&. An input file name can be an absolute or relative path, but an output file name must be an absolute path\&. Windows users might need to use an
E\*(Aq\*(Aq
string and double any backslashes used in the path name\&.
.RE
.PP
PROGRAM
.RS 4
A command to execute\&. In
\fBCOPY FROM\fR, the input is read from standard output of the command, and in
\fBCOPY TO\fR, the output is written to the standard input of the command\&.
.sp
Note that the command is invoked by the shell, so if you need to pass any arguments to shell command that come from an untrusted source, you must be careful to strip or escape any special characters that might have a special meaning for the shell\&. For security reasons, it is best to use a fixed command string, or at least avoid passing any user input in it\&.
.RE
.PP
STDIN
.RS 4
Specifies that input comes from the client application\&.
.RE
.PP
STDOUT
.RS 4
Specifies that output goes to the client application\&.
.RE
.PP
\fIboolean\fR
.RS 4
Specifies whether the selected option should be turned on or off\&. You can write
TRUE,
ON, or
1
to enable the option, and
FALSE,
OFF, or
0
to disable it\&. The
\fIboolean\fR
value can also be omitted, in which case
TRUE
is assumed\&.
.RE
.PP
FORMAT
.RS 4
Selects the data format to be read or written:
text,
csv
(Comma Separated Values), or
binary\&. The default is
text\&.
.RE
.PP
OIDS
.RS 4
Specifies copying the OID for each row\&. (An error is raised if
OIDS
is specified for a table that does not have OIDs, or in the case of copying a
\fIquery\fR\&.)
.RE
.PP
FREEZE
.RS 4
Requests copying the data with rows already frozen, just as they would be after running the
\fBVACUUM FREEZE\fR
command\&. This is intended as a performance option for initial data loading\&. Rows will be frozen only if the table being loaded has been created or truncated in the current subtransaction, there are no cursors open and there are no older snapshots held by this transaction\&.
.sp
Note that all other sessions will immediately be able to see the data once it has been successfully loaded\&. This violates the normal rules of MVCC visibility and users specifying should be aware of the potential problems this might cause\&.
.RE
.PP
DELIMITER
.RS 4
Specifies the character that separates columns within each row (line) of the file\&. The default is a tab character in text format, a comma in
CSV
format\&. This must be a single one\-byte character\&. This option is not allowed when using
binary
format\&.
.RE
.PP
NULL
.RS 4
Specifies the string that represents a null value\&. The default is
\eN
(backslash\-N) in text format, and an unquoted empty string in
CSV
format\&. You might prefer an empty string even in text format for cases where you don\*(Aqt want to distinguish nulls from empty strings\&. This option is not allowed when using
binary
format\&.
.if n \{\
.sp
.\}
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBNote\fR
.ps -1
.br
When using
\fBCOPY FROM\fR, any data item that matches this string will be stored as a null value, so you should make sure that you use the same string as you used with
\fBCOPY TO\fR\&.
.sp .5v
.RE
.RE
.PP
HEADER
.RS 4
Specifies that the file contains a header line with the names of each column in the file\&. On output, the first line contains the column names from the table, and on input, the first line is ignored\&. This option is allowed only when using
CSV
format\&.
.RE
.PP
QUOTE
.RS 4
Specifies the quoting character to be used when a data value is quoted\&. The default is double\-quote\&. This must be a single one\-byte character\&. This option is allowed only when using
CSV
format\&.
.RE
.PP
ESCAPE
.RS 4
Specifies the character that should appear before a data character that matches the
QUOTE
value\&. The default is the same as the
QUOTE
value (so that the quoting character is doubled if it appears in the data)\&. This must be a single one\-byte character\&. This option is allowed only when using
CSV
format\&.
.RE
.PP
FORCE_QUOTE
.RS 4
Forces quoting to be used for all non\-NULL
values in each specified column\&.
NULL
output is never quoted\&. If
*
is specified, non\-NULL
values will be quoted in all columns\&. This option is allowed only in
\fBCOPY TO\fR, and only when using
CSV
format\&.
.RE
.PP
FORCE_NOT_NULL
.RS 4
Do not match the specified columns\*(Aq values against the null string\&. In the default case where the null string is empty, this means that empty values will be read as zero\-length strings rather than nulls, even when they are not quoted\&. This option is allowed only in
\fBCOPY FROM\fR, and only when using
CSV
format\&.
.RE
.PP
FORCE_NULL
.RS 4
Match the specified columns\*(Aq values against the null string, even if it has been quoted, and if a match is found set the value to
NULL\&. In the default case where the null string is empty, this converts a quoted empty string into NULL\&. This option is allowed only in
\fBCOPY FROM\fR, and only when using
CSV
format\&.
.RE
.PP
ENCODING
.RS 4
Specifies that the file is encoded in the
\fIencoding_name\fR\&. If this option is omitted, the current client encoding is used\&. See the Notes below for more details\&.
.RE
.SH "OUTPUTS"
.PP
On successful completion, a
\fBCOPY\fR
command returns a command tag of the form
.sp
.if n \{\
.RS 4
.\}
.nf
COPY \fIcount\fR
.fi
.if n \{\
.RE
.\}
.sp
The
\fIcount\fR
is the number of rows copied\&.
.if n \{\
.sp
.\}
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBNote\fR
.ps -1
.br
.PP
psql
will print this command tag only if the command was not
COPY \&.\&.\&. TO STDOUT, or the equivalent
psql
meta\-command
\ecopy \&.\&.\&. to stdout\&. This is to prevent confusing the command tag with the data that was just printed\&.
.sp .5v
.RE
.SH "NOTES"
.PP
\fBCOPY\fR
can only be used with plain tables, not with views\&. However, you can write
COPY (SELECT * FROM \fIviewname\fR) TO \&.\&.\&.\&.
.PP
\fBCOPY\fR
only deals with the specific table named; it does not copy data to or from child tables\&. Thus for example
COPY \fItable\fR TO
shows the same data as
SELECT * FROM ONLY \fItable\fR\&. But
COPY (SELECT * FROM \fItable\fR) TO \&.\&.\&.
can be used to dump all of the data in an inheritance hierarchy\&.
.PP
You must have select privilege on the table whose values are read by
\fBCOPY TO\fR, and insert privilege on the table into which values are inserted by
\fBCOPY FROM\fR\&. It is sufficient to have column privileges on the column(s) listed in the command\&.
.PP
If row\-level security is enabled for the table, the relevant
\fBSELECT\fR
policies will apply to
COPY \fItable\fR TO
statements\&. Currently,
\fBCOPY FROM\fR
is not supported for tables with row\-level security\&. Use equivalent
\fBINSERT\fR
statements instead\&.
.PP
Files named in a
\fBCOPY\fR
command are read or written directly by the server, not by the client application\&. Therefore, they must reside on or be accessible to the database server machine, not the client\&. They must be accessible to and readable or writable by the
PostgreSQL
user (the user ID the server runs as), not the client\&. Similarly, the command specified with
PROGRAM
is executed directly by the server, not by the client application, must be executable by the
PostgreSQL
user\&.
\fBCOPY\fR
naming a file or command is only allowed to database superusers, since it allows reading or writing any file that the server has privileges to access\&.
.PP
Do not confuse
\fBCOPY\fR
with the
psql
instruction
\fB\ecopy\fR\&.
\fB\ecopy\fR
invokes
\fBCOPY FROM STDIN\fR
or
\fBCOPY TO STDOUT\fR, and then fetches/stores the data in a file accessible to the
psql
client\&. Thus, file accessibility and access rights depend on the client rather than the server when
\fB\ecopy\fR
is used\&.
.PP
It is recommended that the file name used in
\fBCOPY\fR
always be specified as an absolute path\&. This is enforced by the server in the case of
\fBCOPY TO\fR, but for
\fBCOPY FROM\fR
you do have the option of reading from a file specified by a relative path\&. The path will be interpreted relative to the working directory of the server process (normally the cluster\*(Aqs data directory), not the client\*(Aqs working directory\&.
.PP
Executing a command with
PROGRAM
might be restricted by the operating system\*(Aqs access control mechanisms, such as SELinux\&.
.PP
\fBCOPY FROM\fR
will invoke any triggers and check constraints on the destination table\&. However, it will not invoke rules\&.
.PP
\fBCOPY\fR
input and output is affected by
\fIDateStyle\fR\&. To ensure portability to other
PostgreSQL
installations that might use non\-default
\fIDateStyle\fR
settings,
\fIDateStyle\fR
should be set to
ISO
before using
\fBCOPY TO\fR\&. It is also a good idea to avoid dumping data with
\fIIntervalStyle\fR
set to
sql_standard, because negative interval values might be misinterpreted by a server that has a different setting for
\fIIntervalStyle\fR\&.
.PP
Input data is interpreted according to
ENCODING
option or the current client encoding, and output data is encoded in
ENCODING
or the current client encoding, even if the data does not pass through the client but is read from or written to a file directly by the server\&.
.PP
\fBCOPY\fR
stops operation at the first error\&. This should not lead to problems in the event of a
\fBCOPY TO\fR, but the target table will already have received earlier rows in a
\fBCOPY FROM\fR\&. These rows will not be visible or accessible, but they still occupy disk space\&. This might amount to a considerable amount of wasted disk space if the failure happened well into a large copy operation\&. You might wish to invoke
\fBVACUUM\fR
to recover the wasted space\&.
.PP
FORCE_NULL
and
FORCE_NOT_NULL
can be used simultaneously on the same column\&. This results in converting quoted null strings to null values and unquoted null strings to empty strings\&.
.SH "FILE FORMATS"
.SS "Text Format"
.PP
When the
text
format is used, the data read or written is a text file with one line per table row\&. Columns in a row are separated by the delimiter character\&. The column values themselves are strings generated by the output function, or acceptable to the input function, of each attribute\*(Aqs data type\&. The specified null string is used in place of columns that are null\&.
\fBCOPY FROM\fR
will raise an error if any line of the input file contains more or fewer columns than are expected\&. If
OIDS
is specified, the OID is read or written as the first column, preceding the user data columns\&.
.PP
End of data can be represented by a single line containing just backslash\-period (\e\&.)\&. An end\-of\-data marker is not necessary when reading from a file, since the end of file serves perfectly well; it is needed only when copying data to or from client applications using pre\-3\&.0 client protocol\&.
.PP
Backslash characters (\e) can be used in the
\fBCOPY\fR
data to quote data characters that might otherwise be taken as row or column delimiters\&. In particular, the following characters
\fImust\fR
be preceded by a backslash if they appear as part of a column value: backslash itself, newline, carriage return, and the current delimiter character\&.
.PP
The specified null string is sent by
\fBCOPY TO\fR
without adding any backslashes; conversely,
\fBCOPY FROM\fR
matches the input against the null string before removing backslashes\&. Therefore, a null string such as
\eN
cannot be confused with the actual data value
\eN
(which would be represented as
\e\eN)\&.
.PP
The following special backslash sequences are recognized by
\fBCOPY FROM\fR:
.TS
allbox tab(:);
lB lB.
T{
Sequence
T}:T{
Represents
T}
.T&
l l
l l
l l
l l
l l
l l
l l
l l.
T{
\eb
T}:T{
Backspace (ASCII 8)
T}
T{
\ef
T}:T{
Form feed (ASCII 12)
T}
T{
\en
T}:T{
Newline (ASCII 10)
T}
T{
\er
T}:T{
Carriage return (ASCII 13)
T}
T{
\et
T}:T{
Tab (ASCII 9)
T}
T{
\ev
T}:T{
Vertical tab (ASCII 11)
T}
T{
\e\fIdigits\fR
T}:T{
Backslash followed by one to three octal digits specifies
the byte with that numeric code
T}
T{
\ex\fIdigits\fR
T}:T{
Backslash x followed by one or two hex digits specifies
the byte with that numeric code
T}
.TE
.sp 1
Presently,
\fBCOPY TO\fR
will never emit an octal or hex\-digits backslash sequence, but it does use the other sequences listed above for those control characters\&.
.PP
Any other backslashed character that is not mentioned in the above table will be taken to represent itself\&. However, beware of adding backslashes unnecessarily, since that might accidentally produce a string matching the end\-of\-data marker (\e\&.) or the null string (\eN
by default)\&. These strings will be recognized before any other backslash processing is done\&.
.PP
It is strongly recommended that applications generating
\fBCOPY\fR
data convert data newlines and carriage returns to the
\en
and
\er
sequences respectively\&. At present it is possible to represent a data carriage return by a backslash and carriage return, and to represent a data newline by a backslash and newline\&. However, these representations might not be accepted in future releases\&. They are also highly vulnerable to corruption if the
\fBCOPY\fR
file is transferred across different machines (for example, from Unix to Windows or vice versa)\&.
.PP
All backslash sequences are interpreted after encoding conversion\&. The bytes specified with the octal and hex\-digit backslash sequences must form valid characters in the database encoding\&.
.PP
\fBCOPY TO\fR
will terminate each row with a Unix\-style newline (\(lq\en\(rq)\&. Servers running on Microsoft Windows instead output carriage return/newline (\(lq\er\en\(rq), but only for
\fBCOPY\fR
to a server file; for consistency across platforms,
\fBCOPY TO STDOUT\fR
always sends
\(lq\en\(rq
regardless of server platform\&.
\fBCOPY FROM\fR
can handle lines ending with newlines, carriage returns, or carriage return/newlines\&. To reduce the risk of error due to un\-backslashed newlines or carriage returns that were meant as data,
\fBCOPY FROM\fR
will complain if the line endings in the input are not all alike\&.
.SS "CSV Format"
.PP
This format option is used for importing and exporting the Comma Separated Value (CSV) file format used by many other programs, such as spreadsheets\&. Instead of the escaping rules used by
PostgreSQL\*(Aqs standard text format, it produces and recognizes the common CSV escaping mechanism\&.
.PP
The values in each record are separated by the
DELIMITER
character\&. If the value contains the delimiter character, the
QUOTE
character, the
NULL
string, a carriage return, or line feed character, then the whole value is prefixed and suffixed by the
QUOTE
character, and any occurrence within the value of a
QUOTE
character or the
ESCAPE
character is preceded by the escape character\&. You can also use
FORCE_QUOTE
to force quotes when outputting non\-NULL
values in specific columns\&.
.PP
The
CSV
format has no standard way to distinguish a
NULL
value from an empty string\&.
PostgreSQL\*(Aqs
\fBCOPY\fR
handles this by quoting\&. A
NULL
is output as the
NULL
parameter string and is not quoted, while a non\-NULL
value matching the
NULL
parameter string is quoted\&. For example, with the default settings, a
NULL
is written as an unquoted empty string, while an empty string data value is written with double quotes ("")\&. Reading values follows similar rules\&. You can use
FORCE_NOT_NULL
to prevent
NULL
input comparisons for specific columns\&. You can also use
FORCE_NULL
to convert quoted null string data values to
NULL\&.
.PP
Because backslash is not a special character in the
CSV
format,
\e\&., the end\-of\-data marker, could also appear as a data value\&. To avoid any misinterpretation, a
\e\&.
data value appearing as a lone entry on a line is automatically quoted on output, and on input, if quoted, is not interpreted as the end\-of\-data marker\&. If you are loading a file created by another application that has a single unquoted column and might have a value of
\e\&., you might need to quote that value in the input file\&.
.if n \{\
.sp
.\}
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBNote\fR
.ps -1
.br
.PP
In
CSV
format, all characters are significant\&. A quoted value surrounded by white space, or any characters other than
DELIMITER, will include those characters\&. This can cause errors if you import data from a system that pads
CSV
lines with white space out to some fixed width\&. If such a situation arises you might need to preprocess the
CSV
file to remove the trailing white space, before importing the data into
PostgreSQL\&.
.sp .5v
.RE
.if n \{\
.sp
.\}
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBNote\fR
.ps -1
.br
.PP
CSV format will both recognize and produce CSV files with quoted values containing embedded carriage returns and line feeds\&. Thus the files are not strictly one line per table row like text\-format files\&.
.sp .5v
.RE
.if n \{\
.sp
.\}
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBNote\fR
.ps -1
.br
.PP
Many programs produce strange and occasionally perverse CSV files, so the file format is more a convention than a standard\&. Thus you might encounter some files that cannot be imported using this mechanism, and
\fBCOPY\fR
might produce files that other programs cannot process\&.
.sp .5v
.RE
.SS "Binary Format"
.PP
The
binary
format option causes all data to be stored/read as binary format rather than as text\&. It is somewhat faster than the text and
CSV
formats, but a binary\-format file is less portable across machine architectures and
PostgreSQL
versions\&. Also, the binary format is very data type specific; for example it will not work to output binary data from a
smallint
column and read it into an
integer
column, even though that would work fine in text format\&.
.PP
The
binary
file format consists of a file header, zero or more tuples containing the row data, and a file trailer\&. Headers and data are in network byte order\&.
.if n \{\
.sp
.\}
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBNote\fR
.ps -1
.br
.PP
PostgreSQL
releases before 7\&.4 used a different binary file format\&.
.sp .5v
.RE
.sp
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBFile Header\fR
.RS 4
.PP
The file header consists of 15 bytes of fixed fields, followed by a variable\-length header extension area\&. The fixed fields are:
.PP
Signature
.RS 4
11\-byte sequence
PGCOPY\en\e377\er\en\e0
\(em note that the zero byte is a required part of the signature\&. (The signature is designed to allow easy identification of files that have been munged by a non\-8\-bit\-clean transfer\&. This signature will be changed by end\-of\-line\-translation filters, dropped zero bytes, dropped high bits, or parity changes\&.)
.RE
.PP
Flags field
.RS 4
32\-bit integer bit mask to denote important aspects of the file format\&. Bits are numbered from 0 (LSB) to 31 (MSB)\&. Note that this field is stored in network byte order (most significant byte first), as are all the integer fields used in the file format\&. Bits 16\-31 are reserved to denote critical file format issues; a reader should abort if it finds an unexpected bit set in this range\&. Bits 0\-15 are reserved to signal backwards\-compatible format issues; a reader should simply ignore any unexpected bits set in this range\&. Currently only one flag bit is defined, and the rest must be zero:
.PP
Bit 16
.RS 4
if 1, OIDs are included in the data; if 0, not
.RE
.RE
.PP
Header extension area length
.RS 4
32\-bit integer, length in bytes of remainder of header, not including self\&. Currently, this is zero, and the first tuple follows immediately\&. Future changes to the format might allow additional data to be present in the header\&. A reader should silently skip over any header extension data it does not know what to do with\&.
.RE
.PP
The header extension area is envisioned to contain a sequence of self\-identifying chunks\&. The flags field is not intended to tell readers what is in the extension area\&. Specific design of header extension contents is left for a later release\&.
.PP
This design allows for both backwards\-compatible header additions (add header extension chunks, or set low\-order flag bits) and non\-backwards\-compatible changes (set high\-order flag bits to signal such changes, and add supporting data to the extension area if needed)\&.
.RE
.sp
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBTuples\fR
.RS 4
.PP
Each tuple begins with a 16\-bit integer count of the number of fields in the tuple\&. (Presently, all tuples in a table will have the same count, but that might not always be true\&.) Then, repeated for each field in the tuple, there is a 32\-bit length word followed by that many bytes of field data\&. (The length word does not include itself, and can be zero\&.) As a special case, \-1 indicates a NULL field value\&. No value bytes follow in the NULL case\&.
.PP
There is no alignment padding or any other extra data between fields\&.
.PP
Presently, all data values in a binary\-format file are assumed to be in binary format (format code one)\&. It is anticipated that a future extension might add a header field that allows per\-column format codes to be specified\&.
.PP
To determine the appropriate binary format for the actual tuple data you should consult the
PostgreSQL
source, in particular the
\fB*send\fR
and
\fB*recv\fR
functions for each column\*(Aqs data type (typically these functions are found in the
src/backend/utils/adt/
directory of the source distribution)\&.
.PP
If OIDs are included in the file, the OID field immediately follows the field\-count word\&. It is a normal field except that it\*(Aqs not included in the field\-count\&. In particular it has a length word \(em this will allow handling of 4\-byte vs\&. 8\-byte OIDs without too much pain, and will allow OIDs to be shown as null if that ever proves desirable\&.
.RE
.sp
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBFile Trailer\fR
.RS 4
.PP
The file trailer consists of a 16\-bit integer word containing \-1\&. This is easily distinguished from a tuple\*(Aqs field\-count word\&.
.PP
A reader should report an error if a field\-count word is neither \-1 nor the expected number of columns\&. This provides an extra check against somehow getting out of sync with the data\&.
.RE
.SH "EXAMPLES"
.PP
The following example copies a table to the client using the vertical bar (|) as the field delimiter:
.sp
.if n \{\
.RS 4
.\}
.nf
COPY country TO STDOUT (DELIMITER \*(Aq|\*(Aq);
.fi
.if n \{\
.RE
.\}
.PP
To copy data from a file into the
country
table:
.sp
.if n \{\
.RS 4
.\}
.nf
COPY country FROM \*(Aq/usr1/proj/bray/sql/country_data\*(Aq;
.fi
.if n \{\
.RE
.\}
.PP
To copy into a file just the countries whose names start with \*(AqA\*(Aq:
.sp
.if n \{\
.RS 4
.\}
.nf
COPY (SELECT * FROM country WHERE country_name LIKE \*(AqA%\*(Aq) TO \*(Aq/usr1/proj/bray/sql/a_list_countries\&.copy\*(Aq;
.fi
.if n \{\
.RE
.\}
.PP
To copy into a compressed file, you can pipe the output through an external compression program:
.sp
.if n \{\
.RS 4
.\}
.nf
COPY country TO PROGRAM \*(Aqgzip > /usr1/proj/bray/sql/country_data\&.gz\*(Aq;
.fi
.if n \{\
.RE
.\}
.PP
Here is a sample of data suitable for copying into a table from
STDIN:
.sp
.if n \{\
.RS 4
.\}
.nf
AF AFGHANISTAN
AL ALBANIA
DZ ALGERIA
ZM ZAMBIA
ZW ZIMBABWE
.fi
.if n \{\
.RE
.\}
.sp
Note that the white space on each line is actually a tab character\&.
.PP
The following is the same data, output in binary format\&. The data is shown after filtering through the Unix utility
\fBod \-c\fR\&. The table has three columns; the first has type
char(2), the second has type
text, and the third has type
integer\&. All the rows have a null value in the third column\&.
.sp
.if n \{\
.RS 4
.\}
.nf
0000000 P G C O P Y \en 377 \er \en \e0 \e0 \e0 \e0 \e0 \e0
0000020 \e0 \e0 \e0 \e0 003 \e0 \e0 \e0 002 A F \e0 \e0 \e0 013 A
0000040 F G H A N I S T A N 377 377 377 377 \e0 003
0000060 \e0 \e0 \e0 002 A L \e0 \e0 \e0 007 A L B A N I
0000100 A 377 377 377 377 \e0 003 \e0 \e0 \e0 002 D Z \e0 \e0 \e0
0000120 007 A L G E R I A 377 377 377 377 \e0 003 \e0 \e0
0000140 \e0 002 Z M \e0 \e0 \e0 006 Z A M B I A 377 377
0000160 377 377 \e0 003 \e0 \e0 \e0 002 Z W \e0 \e0 \e0 \eb Z I
0000200 M B A B W E 377 377 377 377 377 377
.fi
.if n \{\
.RE
.\}
.SH "COMPATIBILITY"
.PP
There is no
\fBCOPY\fR
statement in the SQL standard\&.
.PP
The following syntax was used before
PostgreSQL
version 9\&.0 and is still supported:
.sp
.if n \{\
.RS 4
.\}
.nf
COPY \fItable_name\fR [ ( \fIcolumn_name\fR [, \&.\&.\&.] ) ]
FROM { \*(Aq\fIfilename\fR\*(Aq | STDIN }
[ [ WITH ]
[ BINARY ]
[ OIDS ]
[ DELIMITER [ AS ] \*(Aq\fIdelimiter_character\fR\*(Aq ]
[ NULL [ AS ] \*(Aq\fInull string\fR\*(Aq ]
[ CSV [ HEADER ]
[ QUOTE [ AS ] \*(Aq\fIquote_character\fR\*(Aq ]
[ ESCAPE [ AS ] \*(Aq\fIescape_character\fR\*(Aq ]
[ FORCE NOT NULL \fIcolumn_name\fR [, \&.\&.\&.] ] ] ]
COPY { \fItable_name\fR [ ( \fIcolumn_name\fR [, \&.\&.\&.] ) ] | ( \fIquery\fR ) }
TO { \*(Aq\fIfilename\fR\*(Aq | STDOUT }
[ [ WITH ]
[ BINARY ]
[ OIDS ]
[ DELIMITER [ AS ] \*(Aq\fIdelimiter_character\fR\*(Aq ]
[ NULL [ AS ] \*(Aq\fInull string\fR\*(Aq ]
[ CSV [ HEADER ]
[ QUOTE [ AS ] \*(Aq\fIquote_character\fR\*(Aq ]
[ ESCAPE [ AS ] \*(Aq\fIescape_character\fR\*(Aq ]
[ FORCE QUOTE { \fIcolumn_name\fR [, \&.\&.\&.] | * } ] ] ]
.fi
.if n \{\
.RE
.\}
.sp
Note that in this syntax,
BINARY
and
CSV
are treated as independent keywords, not as arguments of a
FORMAT
option\&.
.PP
The following syntax was used before
PostgreSQL
version 7\&.3 and is still supported:
.sp
.if n \{\
.RS 4
.\}
.nf
COPY [ BINARY ] \fItable_name\fR [ WITH OIDS ]
FROM { \*(Aq\fIfilename\fR\*(Aq | STDIN }
[ [USING] DELIMITERS \*(Aq\fIdelimiter_character\fR\*(Aq ]
[ WITH NULL AS \*(Aq\fInull_string\fR\*(Aq ]
COPY [ BINARY ] \fItable_name\fR [ WITH OIDS ]
TO { \*(Aq\fIfilename\fR\*(Aq | STDOUT }
[ [USING] DELIMITERS \*(Aq\fIdelimiter_character\fR\*(Aq ]
[ WITH NULL AS \*(Aq\fInull_string\fR\*(Aq ]
.fi
.if n \{\
.RE
.\}
man/man7/ALTER_TEXT_SEARCH_CONFIGURATION.7 0000644 00000011451 14751153421 0013105 0 ustar 00 '\" t
.\" Title: ALTER TEXT SEARCH CONFIGURATION
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "ALTER TEXT SEARCH CONFIGURATION" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
ALTER_TEXT_SEARCH_CONFIGURATION \- change the definition of a text search configuration
.SH "SYNOPSIS"
.sp
.nf
ALTER TEXT SEARCH CONFIGURATION \fIname\fR
ADD MAPPING FOR \fItoken_type\fR [, \&.\&.\&. ] WITH \fIdictionary_name\fR [, \&.\&.\&. ]
ALTER TEXT SEARCH CONFIGURATION \fIname\fR
ALTER MAPPING FOR \fItoken_type\fR [, \&.\&.\&. ] WITH \fIdictionary_name\fR [, \&.\&.\&. ]
ALTER TEXT SEARCH CONFIGURATION \fIname\fR
ALTER MAPPING REPLACE \fIold_dictionary\fR WITH \fInew_dictionary\fR
ALTER TEXT SEARCH CONFIGURATION \fIname\fR
ALTER MAPPING FOR \fItoken_type\fR [, \&.\&.\&. ] REPLACE \fIold_dictionary\fR WITH \fInew_dictionary\fR
ALTER TEXT SEARCH CONFIGURATION \fIname\fR
DROP MAPPING [ IF EXISTS ] FOR \fItoken_type\fR [, \&.\&.\&. ]
ALTER TEXT SEARCH CONFIGURATION \fIname\fR RENAME TO \fInew_name\fR
ALTER TEXT SEARCH CONFIGURATION \fIname\fR OWNER TO { \fInew_owner\fR | CURRENT_USER | SESSION_USER }
ALTER TEXT SEARCH CONFIGURATION \fIname\fR SET SCHEMA \fInew_schema\fR
.fi
.SH "DESCRIPTION"
.PP
\fBALTER TEXT SEARCH CONFIGURATION\fR
changes the definition of a text search configuration\&. You can modify its mappings from token types to dictionaries, or change the configuration\*(Aqs name or owner\&.
.PP
You must be the owner of the configuration to use
\fBALTER TEXT SEARCH CONFIGURATION\fR\&.
.SH "PARAMETERS"
.PP
\fIname\fR
.RS 4
The name (optionally schema\-qualified) of an existing text search configuration\&.
.RE
.PP
\fItoken_type\fR
.RS 4
The name of a token type that is emitted by the configuration\*(Aqs parser\&.
.RE
.PP
\fIdictionary_name\fR
.RS 4
The name of a text search dictionary to be consulted for the specified token type(s)\&. If multiple dictionaries are listed, they are consulted in the specified order\&.
.RE
.PP
\fIold_dictionary\fR
.RS 4
The name of a text search dictionary to be replaced in the mapping\&.
.RE
.PP
\fInew_dictionary\fR
.RS 4
The name of a text search dictionary to be substituted for
\fIold_dictionary\fR\&.
.RE
.PP
\fInew_name\fR
.RS 4
The new name of the text search configuration\&.
.RE
.PP
\fInew_owner\fR
.RS 4
The new owner of the text search configuration\&.
.RE
.PP
\fInew_schema\fR
.RS 4
The new schema for the text search configuration\&.
.RE
.PP
The
ADD MAPPING FOR
form installs a list of dictionaries to be consulted for the specified token type(s); it is an error if there is already a mapping for any of the token types\&. The
ALTER MAPPING FOR
form does the same, but first removing any existing mapping for those token types\&. The
ALTER MAPPING REPLACE
forms substitute
\fInew_dictionary\fR
for
\fIold_dictionary\fR
anywhere the latter appears\&. This is done for only the specified token types when
FOR
appears, or for all mappings of the configuration when it doesn\*(Aqt\&. The
DROP MAPPING
form removes all dictionaries for the specified token type(s), causing tokens of those types to be ignored by the text search configuration\&. It is an error if there is no mapping for the token types, unless
IF EXISTS
appears\&.
.SH "EXAMPLES"
.PP
The following example replaces the
english
dictionary with the
swedish
dictionary anywhere that
english
is used within
my_config\&.
.sp
.if n \{\
.RS 4
.\}
.nf
ALTER TEXT SEARCH CONFIGURATION my_config
ALTER MAPPING REPLACE english WITH swedish;
.fi
.if n \{\
.RE
.\}
.SH "COMPATIBILITY"
.PP
There is no
\fBALTER TEXT SEARCH CONFIGURATION\fR
statement in the SQL standard\&.
.SH "SEE ALSO"
CREATE TEXT SEARCH CONFIGURATION (\fBCREATE_TEXT_SEARCH_CONFIGURATION\fR(7)), DROP TEXT SEARCH CONFIGURATION (\fBDROP_TEXT_SEARCH_CONFIGURATION\fR(7))
man/man7/CHECKPOINT.7 0000644 00000004452 14751153421 0007710 0 ustar 00 '\" t
.\" Title: CHECKPOINT
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "CHECKPOINT" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
CHECKPOINT \- force a transaction log checkpoint
.SH "SYNOPSIS"
.sp
.nf
CHECKPOINT
.fi
.SH "DESCRIPTION"
.PP
A checkpoint is a point in the transaction log sequence at which all data files have been updated to reflect the information in the log\&. All data files will be flushed to disk\&. Refer to
Section 30.4, \(lqWAL Configuration\(rq, in the documentation
for more details about what happens during a checkpoint\&.
.PP
The
\fBCHECKPOINT\fR
command forces an immediate checkpoint when the command is issued, without waiting for a regular checkpoint scheduled by the system (controlled by the settings in
Section 19.5.2, \(lqCheckpoints\(rq, in the documentation)\&.
\fBCHECKPOINT\fR
is not intended for use during normal operation\&.
.PP
If executed during recovery, the
\fBCHECKPOINT\fR
command will force a restartpoint (see
Section 30.4, \(lqWAL Configuration\(rq, in the documentation) rather than writing a new checkpoint\&.
.PP
Only superusers can call
\fBCHECKPOINT\fR\&.
.SH "COMPATIBILITY"
.PP
The
\fBCHECKPOINT\fR
command is a
PostgreSQL
language extension\&.
man/man7/CREATE_TEXT_SEARCH_CONFIGURATION.7 0000644 00000006312 14751153421 0013201 0 ustar 00 '\" t
.\" Title: CREATE TEXT SEARCH CONFIGURATION
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "CREATE TEXT SEARCH CONFIGURATION" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
CREATE_TEXT_SEARCH_CONFIGURATION \- define a new text search configuration
.SH "SYNOPSIS"
.sp
.nf
CREATE TEXT SEARCH CONFIGURATION \fIname\fR (
PARSER = \fIparser_name\fR |
COPY = \fIsource_config\fR
)
.fi
.SH "DESCRIPTION"
.PP
\fBCREATE TEXT SEARCH CONFIGURATION\fR
creates a new text search configuration\&. A text search configuration specifies a text search parser that can divide a string into tokens, plus dictionaries that can be used to determine which tokens are of interest for searching\&.
.PP
If only the parser is specified, then the new text search configuration initially has no mappings from token types to dictionaries, and therefore will ignore all words\&. Subsequent
\fBALTER TEXT SEARCH CONFIGURATION\fR
commands must be used to create mappings to make the configuration useful\&. Alternatively, an existing text search configuration can be copied\&.
.PP
If a schema name is given then the text search configuration is created in the specified schema\&. Otherwise it is created in the current schema\&.
.PP
The user who defines a text search configuration becomes its owner\&.
.PP
Refer to
Chapter 12, Full Text Search, in the documentation
for further information\&.
.SH "PARAMETERS"
.PP
\fIname\fR
.RS 4
The name of the text search configuration to be created\&. The name can be schema\-qualified\&.
.RE
.PP
\fIparser_name\fR
.RS 4
The name of the text search parser to use for this configuration\&.
.RE
.PP
\fIsource_config\fR
.RS 4
The name of an existing text search configuration to copy\&.
.RE
.SH "NOTES"
.PP
The
PARSER
and
COPY
options are mutually exclusive, because when an existing configuration is copied, its parser selection is copied too\&.
.SH "COMPATIBILITY"
.PP
There is no
\fBCREATE TEXT SEARCH CONFIGURATION\fR
statement in the SQL standard\&.
.SH "SEE ALSO"
ALTER TEXT SEARCH CONFIGURATION (\fBALTER_TEXT_SEARCH_CONFIGURATION\fR(7)), DROP TEXT SEARCH CONFIGURATION (\fBDROP_TEXT_SEARCH_CONFIGURATION\fR(7))
man/man7/REFRESH_MATERIALIZED_VIEW.7 0000644 00000007765 14751153421 0012155 0 ustar 00 '\" t
.\" Title: REFRESH MATERIALIZED VIEW
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "REFRESH MATERIALIZED VIEW" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
REFRESH_MATERIALIZED_VIEW \- replace the contents of a materialized view
.SH "SYNOPSIS"
.sp
.nf
REFRESH MATERIALIZED VIEW [ CONCURRENTLY ] \fIname\fR
[ WITH [ NO ] DATA ]
.fi
.SH "DESCRIPTION"
.PP
\fBREFRESH MATERIALIZED VIEW\fR
completely replaces the contents of a materialized view\&. To execute this command you must be the owner of the materialized view\&. The old contents are discarded\&. If
WITH DATA
is specified (or defaults) the backing query is executed to provide the new data, and the materialized view is left in a scannable state\&. If
WITH NO DATA
is specified no new data is generated and the materialized view is left in an unscannable state\&.
.PP
CONCURRENTLY
and
WITH NO DATA
may not be specified together\&.
.SH "PARAMETERS"
.PP
CONCURRENTLY
.RS 4
Refresh the materialized view without locking out concurrent selects on the materialized view\&. Without this option a refresh which affects a lot of rows will tend to use fewer resources and complete more quickly, but could block other connections which are trying to read from the materialized view\&. This option may be faster in cases where a small number of rows are affected\&.
.sp
This option is only allowed if there is at least one
UNIQUE
index on the materialized view which uses only column names and includes all rows; that is, it must not be an expression index or include a
WHERE
clause\&.
.sp
This option may not be used when the materialized view is not already populated\&.
.sp
Even with this option only one
REFRESH
at a time may run against any one materialized view\&.
.RE
.PP
\fIname\fR
.RS 4
The name (optionally schema\-qualified) of the materialized view to refresh\&.
.RE
.SH "NOTES"
.PP
While the default index for future
\fBCLUSTER\fR(7)
operations is retained,
\fBREFRESH MATERIALIZED VIEW\fR
does not order the generated rows based on this property\&. If you want the data to be ordered upon generation, you must use an
ORDER BY
clause in the backing query\&.
.SH "EXAMPLES"
.PP
This command will replace the contents of the materialized view called
order_summary
using the query from the materialized view\*(Aqs definition, and leave it in a scannable state:
.sp
.if n \{\
.RS 4
.\}
.nf
REFRESH MATERIALIZED VIEW order_summary;
.fi
.if n \{\
.RE
.\}
.PP
This command will free storage associated with the materialized view
annual_statistics_basis
and leave it in an unscannable state:
.sp
.if n \{\
.RS 4
.\}
.nf
REFRESH MATERIALIZED VIEW annual_statistics_basis WITH NO DATA;
.fi
.if n \{\
.RE
.\}
.SH "COMPATIBILITY"
.PP
\fBREFRESH MATERIALIZED VIEW\fR
is a
PostgreSQL
extension\&.
.SH "SEE ALSO"
CREATE MATERIALIZED VIEW (\fBCREATE_MATERIALIZED_VIEW\fR(7)), ALTER MATERIALIZED VIEW (\fBALTER_MATERIALIZED_VIEW\fR(7)), DROP MATERIALIZED VIEW (\fBDROP_MATERIALIZED_VIEW\fR(7))
man/man7/DROP_FUNCTION.7 0000644 00000006556 14751153421 0010341 0 ustar 00 '\" t
.\" Title: DROP FUNCTION
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "DROP FUNCTION" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
DROP_FUNCTION \- remove a function
.SH "SYNOPSIS"
.sp
.nf
DROP FUNCTION [ IF EXISTS ] \fIname\fR ( [ [ \fIargmode\fR ] [ \fIargname\fR ] \fIargtype\fR [, \&.\&.\&.] ] )
[ CASCADE | RESTRICT ]
.fi
.SH "DESCRIPTION"
.PP
\fBDROP FUNCTION\fR
removes the definition of an existing function\&. To execute this command the user must be the owner of the function\&. The argument types to the function must be specified, since several different functions can exist with the same name and different argument lists\&.
.SH "PARAMETERS"
.PP
IF EXISTS
.RS 4
Do not throw an error if the function does not exist\&. A notice is issued in this case\&.
.RE
.PP
\fIname\fR
.RS 4
The name (optionally schema\-qualified) of an existing function\&.
.RE
.PP
\fIargmode\fR
.RS 4
The mode of an argument:
IN,
OUT,
INOUT, or
VARIADIC\&. If omitted, the default is
IN\&. Note that
\fBDROP FUNCTION\fR
does not actually pay any attention to
OUT
arguments, since only the input arguments are needed to determine the function\*(Aqs identity\&. So it is sufficient to list the
IN,
INOUT, and
VARIADIC
arguments\&.
.RE
.PP
\fIargname\fR
.RS 4
The name of an argument\&. Note that
\fBDROP FUNCTION\fR
does not actually pay any attention to argument names, since only the argument data types are needed to determine the function\*(Aqs identity\&.
.RE
.PP
\fIargtype\fR
.RS 4
The data type(s) of the function\*(Aqs arguments (optionally schema\-qualified), if any\&.
.RE
.PP
CASCADE
.RS 4
Automatically drop objects that depend on the function (such as operators or triggers), and in turn all objects that depend on those objects (see
Section 5.13, \(lqDependency Tracking\(rq, in the documentation)\&.
.RE
.PP
RESTRICT
.RS 4
Refuse to drop the function if any objects depend on it\&. This is the default\&.
.RE
.SH "EXAMPLES"
.PP
This command removes the square root function:
.sp
.if n \{\
.RS 4
.\}
.nf
DROP FUNCTION sqrt(integer);
.fi
.if n \{\
.RE
.\}
.SH "COMPATIBILITY"
.PP
A
\fBDROP FUNCTION\fR
statement is defined in the SQL standard, but it is not compatible with this command\&.
.SH "SEE ALSO"
CREATE FUNCTION (\fBCREATE_FUNCTION\fR(7)), ALTER FUNCTION (\fBALTER_FUNCTION\fR(7))
man/man7/DROP_VIEW.7 0000644 00000004674 14751153421 0007665 0 ustar 00 '\" t
.\" Title: DROP VIEW
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "DROP VIEW" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
DROP_VIEW \- remove a view
.SH "SYNOPSIS"
.sp
.nf
DROP VIEW [ IF EXISTS ] \fIname\fR [, \&.\&.\&.] [ CASCADE | RESTRICT ]
.fi
.SH "DESCRIPTION"
.PP
\fBDROP VIEW\fR
drops an existing view\&. To execute this command you must be the owner of the view\&.
.SH "PARAMETERS"
.PP
IF EXISTS
.RS 4
Do not throw an error if the view does not exist\&. A notice is issued in this case\&.
.RE
.PP
\fIname\fR
.RS 4
The name (optionally schema\-qualified) of the view to remove\&.
.RE
.PP
CASCADE
.RS 4
Automatically drop objects that depend on the view (such as other views), and in turn all objects that depend on those objects (see
Section 5.13, \(lqDependency Tracking\(rq, in the documentation)\&.
.RE
.PP
RESTRICT
.RS 4
Refuse to drop the view if any objects depend on it\&. This is the default\&.
.RE
.SH "EXAMPLES"
.PP
This command will remove the view called
kinds:
.sp
.if n \{\
.RS 4
.\}
.nf
DROP VIEW kinds;
.fi
.if n \{\
.RE
.\}
.SH "COMPATIBILITY"
.PP
This command conforms to the SQL standard, except that the standard only allows one view to be dropped per command, and apart from the
IF EXISTS
option, which is a
PostgreSQL
extension\&.
.SH "SEE ALSO"
ALTER VIEW (\fBALTER_VIEW\fR(7)), CREATE VIEW (\fBCREATE_VIEW\fR(7))
man/man7/CREATE_INDEX.7 0000644 00000050241 14751153421 0010150 0 ustar 00 '\" t
.\" Title: CREATE INDEX
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "CREATE INDEX" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
CREATE_INDEX \- define a new index
.SH "SYNOPSIS"
.sp
.nf
CREATE [ UNIQUE ] INDEX [ CONCURRENTLY ] [ [ IF NOT EXISTS ] \fIname\fR ] ON \fItable_name\fR [ USING \fImethod\fR ]
( { \fIcolumn_name\fR | ( \fIexpression\fR ) } [ COLLATE \fIcollation\fR ] [ \fIopclass\fR ] [ ASC | DESC ] [ NULLS { FIRST | LAST } ] [, \&.\&.\&.] )
[ WITH ( \fIstorage_parameter\fR [= \fIvalue\fR] [, \&.\&.\&. ] ) ]
[ TABLESPACE \fItablespace_name\fR ]
[ WHERE \fIpredicate\fR ]
.fi
.SH "DESCRIPTION"
.PP
\fBCREATE INDEX\fR
constructs an index on the specified column(s) of the specified relation, which can be a table or a materialized view\&. Indexes are primarily used to enhance database performance (though inappropriate use can result in slower performance)\&.
.PP
The key field(s) for the index are specified as column names, or alternatively as expressions written in parentheses\&. Multiple fields can be specified if the index method supports multicolumn indexes\&.
.PP
An index field can be an expression computed from the values of one or more columns of the table row\&. This feature can be used to obtain fast access to data based on some transformation of the basic data\&. For example, an index computed on
upper(col)
would allow the clause
WHERE upper(col) = \*(AqJIM\*(Aq
to use an index\&.
.PP
PostgreSQL
provides the index methods B\-tree, hash, GiST, SP\-GiST, GIN, and BRIN\&. Users can also define their own index methods, but that is fairly complicated\&.
.PP
When the
WHERE
clause is present, a
partial index
is created\&. A partial index is an index that contains entries for only a portion of a table, usually a portion that is more useful for indexing than the rest of the table\&. For example, if you have a table that contains both billed and unbilled orders where the unbilled orders take up a small fraction of the total table and yet that is an often used section, you can improve performance by creating an index on just that portion\&. Another possible application is to use
WHERE
with
UNIQUE
to enforce uniqueness over a subset of a table\&. See
Section 11.8, \(lqPartial Indexes\(rq, in the documentation
for more discussion\&.
.PP
The expression used in the
WHERE
clause can refer only to columns of the underlying table, but it can use all columns, not just the ones being indexed\&. Presently, subqueries and aggregate expressions are also forbidden in
WHERE\&. The same restrictions apply to index fields that are expressions\&.
.PP
All functions and operators used in an index definition must be
\(lqimmutable\(rq, that is, their results must depend only on their arguments and never on any outside influence (such as the contents of another table or the current time)\&. This restriction ensures that the behavior of the index is well\-defined\&. To use a user\-defined function in an index expression or
WHERE
clause, remember to mark the function immutable when you create it\&.
.SH "PARAMETERS"
.PP
UNIQUE
.RS 4
Causes the system to check for duplicate values in the table when the index is created (if data already exist) and each time data is added\&. Attempts to insert or update data which would result in duplicate entries will generate an error\&.
.RE
.PP
CONCURRENTLY
.RS 4
When this option is used,
PostgreSQL
will build the index without taking any locks that prevent concurrent inserts, updates, or deletes on the table; whereas a standard index build locks out writes (but not reads) on the table until it\*(Aqs done\&. There are several caveats to be aware of when using this option \(em see
Building Indexes Concurrently\&.
.sp
For temporary tables,
\fBCREATE INDEX\fR
is always non\-concurrent, as no other session can access them, and non\-concurrent index creation is cheaper\&.
.RE
.PP
IF NOT EXISTS
.RS 4
Do not throw an error if a relation with the same name already exists\&. A notice is issued in this case\&. Note that there is no guarantee that the existing index is anything like the one that would have been created\&. Index name is required when
IF NOT EXISTS
is specified\&.
.RE
.PP
\fIname\fR
.RS 4
The name of the index to be created\&. No schema name can be included here; the index is always created in the same schema as its parent table\&. If the name is omitted,
PostgreSQL
chooses a suitable name based on the parent table\*(Aqs name and the indexed column name(s)\&.
.RE
.PP
\fItable_name\fR
.RS 4
The name (possibly schema\-qualified) of the table to be indexed\&.
.RE
.PP
\fImethod\fR
.RS 4
The name of the index method to be used\&. Choices are
btree,
hash,
gist,
spgist,
gin, and
brin\&. The default method is
btree\&.
.RE
.PP
\fIcolumn_name\fR
.RS 4
The name of a column of the table\&.
.RE
.PP
\fIexpression\fR
.RS 4
An expression based on one or more columns of the table\&. The expression usually must be written with surrounding parentheses, as shown in the syntax\&. However, the parentheses can be omitted if the expression has the form of a function call\&.
.RE
.PP
\fIcollation\fR
.RS 4
The name of the collation to use for the index\&. By default, the index uses the collation declared for the column to be indexed or the result collation of the expression to be indexed\&. Indexes with non\-default collations can be useful for queries that involve expressions using non\-default collations\&.
.RE
.PP
\fIopclass\fR
.RS 4
The name of an operator class\&. See below for details\&.
.RE
.PP
ASC
.RS 4
Specifies ascending sort order (which is the default)\&.
.RE
.PP
DESC
.RS 4
Specifies descending sort order\&.
.RE
.PP
NULLS FIRST
.RS 4
Specifies that nulls sort before non\-nulls\&. This is the default when
DESC
is specified\&.
.RE
.PP
NULLS LAST
.RS 4
Specifies that nulls sort after non\-nulls\&. This is the default when
DESC
is not specified\&.
.RE
.PP
\fIstorage_parameter\fR
.RS 4
The name of an index\-method\-specific storage parameter\&. See
Index Storage Parameters
for details\&.
.RE
.PP
\fItablespace_name\fR
.RS 4
The tablespace in which to create the index\&. If not specified,
default_tablespace
is consulted, or
temp_tablespaces
for indexes on temporary tables\&.
.RE
.PP
\fIpredicate\fR
.RS 4
The constraint expression for a partial index\&.
.RE
.SS "Index Storage Parameters"
.PP
The optional
WITH
clause specifies
storage parameters
for the index\&. Each index method has its own set of allowed storage parameters\&. The B\-tree, hash, GiST and SP\-GiST index methods all accept this parameter:
.PP
fillfactor
.RS 4
The fillfactor for an index is a percentage that determines how full the index method will try to pack index pages\&. For B\-trees, leaf pages are filled to this percentage during initial index build, and also when extending the index at the right (adding new largest key values)\&. If pages subsequently become completely full, they will be split, leading to gradual degradation in the index\*(Aqs efficiency\&. B\-trees use a default fillfactor of 90, but any integer value from 10 to 100 can be selected\&. If the table is static then fillfactor 100 is best to minimize the index\*(Aqs physical size, but for heavily updated tables a smaller fillfactor is better to minimize the need for page splits\&. The other index methods use fillfactor in different but roughly analogous ways; the default fillfactor varies between methods\&.
.RE
.PP
GiST indexes additionally accept this parameter:
.PP
buffering
.RS 4
Determines whether the buffering build technique described in
Section 61.4.1, \(lqGiST buffering build\(rq, in the documentation
is used to build the index\&. With
OFF
it is disabled, with
ON
it is enabled, and with
AUTO
it is initially disabled, but turned on on\-the\-fly once the index size reaches
effective_cache_size\&. The default is
AUTO\&.
.RE
.PP
GIN indexes accept different parameters:
.PP
fastupdate
.RS 4
This setting controls usage of the fast update technique described in
Section 63.4.1, \(lqGIN Fast Update Technique\(rq, in the documentation\&. It is a Boolean parameter:
ON
enables fast update,
OFF
disables it\&. (Alternative spellings of
ON
and
OFF
are allowed as described in
Section 19.1, \(lqSetting Parameters\(rq, in the documentation\&.) The default is
ON\&.
.if n \{\
.sp
.\}
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBNote\fR
.ps -1
.br
Turning
fastupdate
off via
\fBALTER INDEX\fR
prevents future insertions from going into the list of pending index entries, but does not in itself flush previous entries\&. You might want to
\fBVACUUM\fR
the table or call
\fBgin_clean_pending_list\fR
function afterward to ensure the pending list is emptied\&.
.sp .5v
.RE
.RE
.PP
gin_pending_list_limit
.RS 4
Custom
gin_pending_list_limit
parameter\&. This value is specified in kilobytes\&.
.RE
.PP
BRIN
indexes accept a different parameter:
.PP
pages_per_range
.RS 4
Defines the number of table blocks that make up one block range for each entry of a
BRIN
index (see
Section 64.1, \(lqIntroduction\(rq, in the documentation
for more details)\&. The default is
128\&.
.RE
.SS "Building Indexes Concurrently"
.PP
Creating an index can interfere with regular operation of a database\&. Normally
PostgreSQL
locks the table to be indexed against writes and performs the entire index build with a single scan of the table\&. Other transactions can still read the table, but if they try to insert, update, or delete rows in the table they will block until the index build is finished\&. This could have a severe effect if the system is a live production database\&. Very large tables can take many hours to be indexed, and even for smaller tables, an index build can lock out writers for periods that are unacceptably long for a production system\&.
.PP
PostgreSQL
supports building indexes without locking out writes\&. This method is invoked by specifying the
CONCURRENTLY
option of
\fBCREATE INDEX\fR\&. When this option is used,
PostgreSQL
must perform two scans of the table, and in addition it must wait for all existing transactions that could potentially modify or use the index to terminate\&. Thus this method requires more total work than a standard index build and takes significantly longer to complete\&. However, since it allows normal operations to continue while the index is built, this method is useful for adding new indexes in a production environment\&. Of course, the extra CPU and I/O load imposed by the index creation might slow other operations\&.
.PP
In a concurrent index build, the index is actually entered into the system catalogs in one transaction, then two table scans occur in two more transactions\&. Before each table scan, the index build must wait for existing transactions that have modified the table to terminate\&. After the second scan, the index build must wait for any transactions that have a snapshot (see
Chapter 13, Concurrency Control, in the documentation) predating the second scan to terminate, including transactions used by any phase of concurrent index builds on other tables\&. Then finally the index can be marked ready for use, and the
\fBCREATE INDEX\fR
command terminates\&. Even then, however, the index may not be immediately usable for queries: in the worst case, it cannot be used as long as transactions exist that predate the start of the index build\&.
.PP
If a problem arises while scanning the table, such as a deadlock or a uniqueness violation in a unique index, the
\fBCREATE INDEX\fR
command will fail but leave behind an
\(lqinvalid\(rq
index\&. This index will be ignored for querying purposes because it might be incomplete; however it will still consume update overhead\&. The
psql
\fB\ed\fR
command will report such an index as
INVALID:
.sp
.if n \{\
.RS 4
.\}
.nf
postgres=# \ed tab
Table "public\&.tab"
Column | Type | Modifiers
\-\-\-\-\-\-\-\-+\-\-\-\-\-\-\-\-\-+\-\-\-\-\-\-\-\-\-\-\-
col | integer |
Indexes:
"idx" btree (col) INVALID
.fi
.if n \{\
.RE
.\}
.sp
The recommended recovery method in such cases is to drop the index and try again to perform
\fBCREATE INDEX CONCURRENTLY\fR\&. (Another possibility is to rebuild the index with
\fBREINDEX\fR\&. However, since
\fBREINDEX\fR
does not support concurrent builds, this option is unlikely to seem attractive\&.)
.PP
Another caveat when building a unique index concurrently is that the uniqueness constraint is already being enforced against other transactions when the second table scan begins\&. This means that constraint violations could be reported in other queries prior to the index becoming available for use, or even in cases where the index build eventually fails\&. Also, if a failure does occur in the second scan, the
\(lqinvalid\(rq
index continues to enforce its uniqueness constraint afterwards\&.
.PP
Concurrent builds of expression indexes and partial indexes are supported\&. Errors occurring in the evaluation of these expressions could cause behavior similar to that described above for unique constraint violations\&.
.PP
Regular index builds permit other regular index builds on the same table to occur in parallel, but only one concurrent index build can occur on a table at a time\&. In both cases, no other types of schema modification on the table are allowed meanwhile\&. Another difference is that a regular
\fBCREATE INDEX\fR
command can be performed within a transaction block, but
\fBCREATE INDEX CONCURRENTLY\fR
cannot\&.
.SH "NOTES"
.PP
See
Chapter 11, Indexes, in the documentation
for information about when indexes can be used, when they are not used, and in which particular situations they can be useful\&.
.if n \{\
.sp
.\}
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBCaution\fR
.ps -1
.br
.PP
Hash index operations are not presently WAL\-logged, so hash indexes might need to be rebuilt with
\fBREINDEX\fR
after a database crash if there were unwritten changes\&. Also, changes to hash indexes are not replicated over streaming or file\-based replication after the initial base backup, so they give wrong answers to queries that subsequently use them\&. Hash indexes are also not properly restored during point\-in\-time recovery\&. For these reasons, hash index use is presently discouraged\&.
.sp .5v
.RE
.PP
Currently, only the B\-tree, GiST, GIN, and BRIN index methods support multicolumn indexes\&. Up to 32 fields can be specified by default\&. (This limit can be altered when building
PostgreSQL\&.) Only B\-tree currently supports unique indexes\&.
.PP
An
operator class
can be specified for each column of an index\&. The operator class identifies the operators to be used by the index for that column\&. For example, a B\-tree index on four\-byte integers would use the
int4_ops
class; this operator class includes comparison functions for four\-byte integers\&. In practice the default operator class for the column\*(Aqs data type is usually sufficient\&. The main point of having operator classes is that for some data types, there could be more than one meaningful ordering\&. For example, we might want to sort a complex\-number data type either by absolute value or by real part\&. We could do this by defining two operator classes for the data type and then selecting the proper class when making an index\&. More information about operator classes is in
Section 11.9, \(lqOperator Classes and Operator Families\(rq, in the documentation
and in
Section 36.14, \(lqInterfacing Extensions To Indexes\(rq, in the documentation\&.
.PP
For index methods that support ordered scans (currently, only B\-tree), the optional clauses
ASC,
DESC,
NULLS FIRST, and/or
NULLS LAST
can be specified to modify the sort ordering of the index\&. Since an ordered index can be scanned either forward or backward, it is not normally useful to create a single\-column
DESC
index \(em that sort ordering is already available with a regular index\&. The value of these options is that multicolumn indexes can be created that match the sort ordering requested by a mixed\-ordering query, such as
SELECT \&.\&.\&. ORDER BY x ASC, y DESC\&. The
NULLS
options are useful if you need to support
\(lqnulls sort low\(rq
behavior, rather than the default
\(lqnulls sort high\(rq, in queries that depend on indexes to avoid sorting steps\&.
.PP
The system regularly collects statistics on all of a table\*(Aqs columns\&. Newly\-created non\-expression indexes can immediately use these statistics to determine an index\*(Aqs usefulness\&. For new expression indexes, it is necessary to run
\fBANALYZE\fR
or wait for the
autovacuum daemon
to analyze the table to generate statistics for these indexes\&.
.PP
For most index methods, the speed of creating an index is dependent on the setting of
maintenance_work_mem\&. Larger values will reduce the time needed for index creation, so long as you don\*(Aqt make it larger than the amount of memory really available, which would drive the machine into swapping\&.
.PP
Use
DROP INDEX (\fBDROP_INDEX\fR(7))
to remove an index\&.
.PP
Prior releases of
PostgreSQL
also had an R\-tree index method\&. This method has been removed because it had no significant advantages over the GiST method\&. If
USING rtree
is specified,
\fBCREATE INDEX\fR
will interpret it as
USING gist, to simplify conversion of old databases to GiST\&.
.SH "EXAMPLES"
.PP
To create a B\-tree index on the column
title
in the table
films:
.sp
.if n \{\
.RS 4
.\}
.nf
CREATE UNIQUE INDEX title_idx ON films (title);
.fi
.if n \{\
.RE
.\}
.PP
To create an index on the expression
lower(title), allowing efficient case\-insensitive searches:
.sp
.if n \{\
.RS 4
.\}
.nf
CREATE INDEX ON films ((lower(title)));
.fi
.if n \{\
.RE
.\}
.sp
(In this example we have chosen to omit the index name, so the system will choose a name, typically
films_lower_idx\&.)
.PP
To create an index with non\-default collation:
.sp
.if n \{\
.RS 4
.\}
.nf
CREATE INDEX title_idx_german ON films (title COLLATE "de_DE");
.fi
.if n \{\
.RE
.\}
.PP
To create an index with non\-default sort ordering of nulls:
.sp
.if n \{\
.RS 4
.\}
.nf
CREATE INDEX title_idx_nulls_low ON films (title NULLS FIRST);
.fi
.if n \{\
.RE
.\}
.PP
To create an index with non\-default fill factor:
.sp
.if n \{\
.RS 4
.\}
.nf
CREATE UNIQUE INDEX title_idx ON films (title) WITH (fillfactor = 70);
.fi
.if n \{\
.RE
.\}
.PP
To create a
GIN
index with fast updates disabled:
.sp
.if n \{\
.RS 4
.\}
.nf
CREATE INDEX gin_idx ON documents_table USING GIN (locations) WITH (fastupdate = off);
.fi
.if n \{\
.RE
.\}
.PP
To create an index on the column
code
in the table
films
and have the index reside in the tablespace
indexspace:
.sp
.if n \{\
.RS 4
.\}
.nf
CREATE INDEX code_idx ON films (code) TABLESPACE indexspace;
.fi
.if n \{\
.RE
.\}
.PP
To create a GiST index on a point attribute so that we can efficiently use box operators on the result of the conversion function:
.sp
.if n \{\
.RS 4
.\}
.nf
CREATE INDEX pointloc
ON points USING gist (box(location,location));
SELECT * FROM points
WHERE box(location,location) && \*(Aq(0,0),(1,1)\*(Aq::box;
.fi
.if n \{\
.RE
.\}
.PP
To create an index without locking out writes to the table:
.sp
.if n \{\
.RS 4
.\}
.nf
CREATE INDEX CONCURRENTLY sales_quantity_index ON sales_table (quantity);
.fi
.if n \{\
.RE
.\}
.SH "COMPATIBILITY"
.PP
\fBCREATE INDEX\fR
is a
PostgreSQL
language extension\&. There are no provisions for indexes in the SQL standard\&.
.SH "SEE ALSO"
ALTER INDEX (\fBALTER_INDEX\fR(7)), DROP INDEX (\fBDROP_INDEX\fR(7))
man/man7/CREATE_EVENT_TRIGGER.7 0000644 00000007375 14751153421 0011357 0 ustar 00 '\" t
.\" Title: CREATE EVENT TRIGGER
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "CREATE EVENT TRIGGER" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
CREATE_EVENT_TRIGGER \- define a new event trigger
.SH "SYNOPSIS"
.sp
.nf
CREATE EVENT TRIGGER \fIname\fR
ON \fIevent\fR
[ WHEN \fIfilter_variable\fR IN (\fIfilter_value\fR [, \&.\&.\&. ]) [ AND \&.\&.\&. ] ]
EXECUTE PROCEDURE \fIfunction_name\fR()
.fi
.SH "DESCRIPTION"
.PP
\fBCREATE EVENT TRIGGER\fR
creates a new event trigger\&. Whenever the designated event occurs and the
WHEN
condition associated with the trigger, if any, is satisfied, the trigger function will be executed\&. For a general introduction to event triggers, see
Chapter 38, Event Triggers, in the documentation\&. The user who creates an event trigger becomes its owner\&.
.SH "PARAMETERS"
.PP
\fIname\fR
.RS 4
The name to give the new trigger\&. This name must be unique within the database\&.
.RE
.PP
\fIevent\fR
.RS 4
The name of the event that triggers a call to the given function\&. See
Section 38.1, \(lqOverview of Event Trigger Behavior\(rq, in the documentation
for more information on event names\&.
.RE
.PP
\fIfilter_variable\fR
.RS 4
The name of a variable used to filter events\&. This makes it possible to restrict the firing of the trigger to a subset of the cases in which it is supported\&. Currently the only supported
\fIfilter_variable\fR
is
TAG\&.
.RE
.PP
\fIfilter_value\fR
.RS 4
A list of values for the associated
\fIfilter_variable\fR
for which the trigger should fire\&. For
TAG, this means a list of command tags (e\&.g\&.,
\*(AqDROP FUNCTION\*(Aq)\&.
.RE
.PP
\fIfunction_name\fR
.RS 4
A user\-supplied function that is declared as taking no argument and returning type
event_trigger\&.
.RE
.SH "NOTES"
.PP
Only superusers can create event triggers\&.
.PP
Event triggers are disabled in single\-user mode (see
\fBpostgres\fR(1))\&. If an erroneous event trigger disables the database so much that you can\*(Aqt even drop the trigger, restart in single\-user mode and you\*(Aqll be able to do that\&.
.SH "EXAMPLES"
.PP
Forbid the execution of any
DDL
command:
.sp
.if n \{\
.RS 4
.\}
.nf
CREATE OR REPLACE FUNCTION abort_any_command()
RETURNS event_trigger
LANGUAGE plpgsql
AS $$
BEGIN
RAISE EXCEPTION \*(Aqcommand % is disabled\*(Aq, tg_tag;
END;
$$;
CREATE EVENT TRIGGER abort_ddl ON ddl_command_start
EXECUTE PROCEDURE abort_any_command();
.fi
.if n \{\
.RE
.\}
.SH "COMPATIBILITY"
.PP
There is no
\fBCREATE EVENT TRIGGER\fR
statement in the SQL standard\&.
.SH "SEE ALSO"
ALTER EVENT TRIGGER (\fBALTER_EVENT_TRIGGER\fR(7)), DROP EVENT TRIGGER (\fBDROP_EVENT_TRIGGER\fR(7)), CREATE FUNCTION (\fBCREATE_FUNCTION\fR(7))
man/man7/RELEASE_SAVEPOINT.7 0000644 00000006006 14751153421 0010766 0 ustar 00 '\" t
.\" Title: RELEASE SAVEPOINT
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "RELEASE SAVEPOINT" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
RELEASE_SAVEPOINT \- destroy a previously defined savepoint
.SH "SYNOPSIS"
.sp
.nf
RELEASE [ SAVEPOINT ] \fIsavepoint_name\fR
.fi
.SH "DESCRIPTION"
.PP
\fBRELEASE SAVEPOINT\fR
destroys a savepoint previously defined in the current transaction\&.
.PP
Destroying a savepoint makes it unavailable as a rollback point, but it has no other user visible behavior\&. It does not undo the effects of commands executed after the savepoint was established\&. (To do that, see
ROLLBACK TO SAVEPOINT (\fBROLLBACK_TO_SAVEPOINT\fR(7))\&.) Destroying a savepoint when it is no longer needed allows the system to reclaim some resources earlier than transaction end\&.
.PP
\fBRELEASE SAVEPOINT\fR
also destroys all savepoints that were established after the named savepoint was established\&.
.SH "PARAMETERS"
.PP
\fIsavepoint_name\fR
.RS 4
The name of the savepoint to destroy\&.
.RE
.SH "NOTES"
.PP
Specifying a savepoint name that was not previously defined is an error\&.
.PP
It is not possible to release a savepoint when the transaction is in an aborted state\&.
.PP
If multiple savepoints have the same name, only the one that was most recently defined is released\&.
.SH "EXAMPLES"
.PP
To establish and later destroy a savepoint:
.sp
.if n \{\
.RS 4
.\}
.nf
BEGIN;
INSERT INTO table1 VALUES (3);
SAVEPOINT my_savepoint;
INSERT INTO table1 VALUES (4);
RELEASE SAVEPOINT my_savepoint;
COMMIT;
.fi
.if n \{\
.RE
.\}
.sp
The above transaction will insert both 3 and 4\&.
.SH "COMPATIBILITY"
.PP
This command conforms to the
SQL
standard\&. The standard specifies that the key word
SAVEPOINT
is mandatory, but
PostgreSQL
allows it to be omitted\&.
.SH "SEE ALSO"
\fBBEGIN\fR(7), \fBCOMMIT\fR(7), \fBROLLBACK\fR(7), ROLLBACK TO SAVEPOINT (\fBROLLBACK_TO_SAVEPOINT\fR(7)), \fBSAVEPOINT\fR(7)
man/man7/ALTER_OPERATOR_CLASS.7 0000644 00000005560 14751153421 0011371 0 ustar 00 '\" t
.\" Title: ALTER OPERATOR CLASS
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "ALTER OPERATOR CLASS" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
ALTER_OPERATOR_CLASS \- change the definition of an operator class
.SH "SYNOPSIS"
.sp
.nf
ALTER OPERATOR CLASS \fIname\fR USING \fIindex_method\fR
RENAME TO \fInew_name\fR
ALTER OPERATOR CLASS \fIname\fR USING \fIindex_method\fR
OWNER TO { \fInew_owner\fR | CURRENT_USER | SESSION_USER }
ALTER OPERATOR CLASS \fIname\fR USING \fIindex_method\fR
SET SCHEMA \fInew_schema\fR
.fi
.SH "DESCRIPTION"
.PP
\fBALTER OPERATOR CLASS\fR
changes the definition of an operator class\&.
.PP
You must own the operator class to use
\fBALTER OPERATOR CLASS\fR\&. To alter the owner, you must also be a direct or indirect member of the new owning role, and that role must have
CREATE
privilege on the operator class\*(Aqs schema\&. (These restrictions enforce that altering the owner doesn\*(Aqt do anything you couldn\*(Aqt do by dropping and recreating the operator class\&. However, a superuser can alter ownership of any operator class anyway\&.)
.SH "PARAMETERS"
.PP
\fIname\fR
.RS 4
The name (optionally schema\-qualified) of an existing operator class\&.
.RE
.PP
\fIindex_method\fR
.RS 4
The name of the index method this operator class is for\&.
.RE
.PP
\fInew_name\fR
.RS 4
The new name of the operator class\&.
.RE
.PP
\fInew_owner\fR
.RS 4
The new owner of the operator class\&.
.RE
.PP
\fInew_schema\fR
.RS 4
The new schema for the operator class\&.
.RE
.SH "COMPATIBILITY"
.PP
There is no
\fBALTER OPERATOR CLASS\fR
statement in the SQL standard\&.
.SH "SEE ALSO"
CREATE OPERATOR CLASS (\fBCREATE_OPERATOR_CLASS\fR(7)), DROP OPERATOR CLASS (\fBDROP_OPERATOR_CLASS\fR(7)), ALTER OPERATOR FAMILY (\fBALTER_OPERATOR_FAMILY\fR(7))
man/man7/IMPORT_FOREIGN_SCHEMA.7 0000644 00000007763 14751153421 0011474 0 ustar 00 '\" t
.\" Title: IMPORT FOREIGN SCHEMA
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "IMPORT FOREIGN SCHEMA" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
IMPORT_FOREIGN_SCHEMA \- import table definitions from a foreign server
.SH "SYNOPSIS"
.sp
.nf
IMPORT FOREIGN SCHEMA \fIremote_schema\fR
[ { LIMIT TO | EXCEPT } ( \fItable_name\fR [, \&.\&.\&.] ) ]
FROM SERVER \fIserver_name\fR
INTO \fIlocal_schema\fR
[ OPTIONS ( \fIoption\fR \*(Aq\fIvalue\fR\*(Aq [, \&.\&.\&. ] ) ]
.fi
.SH "DESCRIPTION"
.PP
\fBIMPORT FOREIGN SCHEMA\fR
creates foreign tables that represent tables existing on a foreign server\&. The new foreign tables will be owned by the user issuing the command and are created with the correct column definitions and options to match the remote tables\&.
.PP
By default, all tables and views existing in a particular schema on the foreign server are imported\&. Optionally, the list of tables can be limited to a specified subset, or specific tables can be excluded\&. The new foreign tables are all created in the target schema, which must already exist\&.
.PP
To use
\fBIMPORT FOREIGN SCHEMA\fR, the user must have
USAGE
privilege on the foreign server, as well as
CREATE
privilege on the target schema\&.
.SH "PARAMETERS"
.PP
\fIremote_schema\fR
.RS 4
The remote schema to import from\&. The specific meaning of a remote schema depends on the foreign data wrapper in use\&.
.RE
.PP
LIMIT TO ( \fItable_name\fR [, \&.\&.\&.] )
.RS 4
Import only foreign tables matching one of the given table names\&. Other tables existing in the foreign schema will be ignored\&.
.RE
.PP
EXCEPT ( \fItable_name\fR [, \&.\&.\&.] )
.RS 4
Exclude specified foreign tables from the import\&. All tables existing in the foreign schema will be imported except the ones listed here\&.
.RE
.PP
\fIserver_name\fR
.RS 4
The foreign server to import from\&.
.RE
.PP
\fIlocal_schema\fR
.RS 4
The schema in which the imported foreign tables will be created\&.
.RE
.PP
OPTIONS ( \fIoption\fR \*(Aq\fIvalue\fR\*(Aq [, \&.\&.\&.] )
.RS 4
Options to be used during the import\&. The allowed option names and values are specific to each foreign data wrapper\&.
.RE
.SH "EXAMPLES"
.PP
Import table definitions from a remote schema
foreign_films
on server
film_server, creating the foreign tables in local schema
films:
.sp
.if n \{\
.RS 4
.\}
.nf
IMPORT FOREIGN SCHEMA foreign_films
FROM SERVER film_server INTO films;
.fi
.if n \{\
.RE
.\}
.PP
As above, but import only the two tables
actors
and
directors
(if they exist):
.sp
.if n \{\
.RS 4
.\}
.nf
IMPORT FOREIGN SCHEMA foreign_films LIMIT TO (actors, directors)
FROM SERVER film_server INTO films;
.fi
.if n \{\
.RE
.\}
.sp
.SH "COMPATIBILITY"
.PP
The
\fBIMPORT FOREIGN SCHEMA\fR
command conforms to the
SQL
standard, except that the
OPTIONS
clause is a
PostgreSQL
extension\&.
.SH "SEE ALSO"
CREATE FOREIGN TABLE (\fBCREATE_FOREIGN_TABLE\fR(7)), CREATE SERVER (\fBCREATE_SERVER\fR(7))
man/man7/DROP_SCHEMA.7 0000644 00000005417 14751153421 0010047 0 ustar 00 '\" t
.\" Title: DROP SCHEMA
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "DROP SCHEMA" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
DROP_SCHEMA \- remove a schema
.SH "SYNOPSIS"
.sp
.nf
DROP SCHEMA [ IF EXISTS ] \fIname\fR [, \&.\&.\&.] [ CASCADE | RESTRICT ]
.fi
.SH "DESCRIPTION"
.PP
\fBDROP SCHEMA\fR
removes schemas from the database\&.
.PP
A schema can only be dropped by its owner or a superuser\&. Note that the owner can drop the schema (and thereby all contained objects) even if they do not own some of the objects within the schema\&.
.SH "PARAMETERS"
.PP
IF EXISTS
.RS 4
Do not throw an error if the schema does not exist\&. A notice is issued in this case\&.
.RE
.PP
\fIname\fR
.RS 4
The name of a schema\&.
.RE
.PP
CASCADE
.RS 4
Automatically drop objects (tables, functions, etc\&.) that are contained in the schema, and in turn all objects that depend on those objects (see
Section 5.13, \(lqDependency Tracking\(rq, in the documentation)\&.
.RE
.PP
RESTRICT
.RS 4
Refuse to drop the schema if it contains any objects\&. This is the default\&.
.RE
.SH "NOTES"
.PP
Using the
CASCADE
option might make the command remove objects in other schemas besides the one(s) named\&.
.SH "EXAMPLES"
.PP
To remove schema
mystuff
from the database, along with everything it contains:
.sp
.if n \{\
.RS 4
.\}
.nf
DROP SCHEMA mystuff CASCADE;
.fi
.if n \{\
.RE
.\}
.SH "COMPATIBILITY"
.PP
\fBDROP SCHEMA\fR
is fully conforming with the SQL standard, except that the standard only allows one schema to be dropped per command, and apart from the
IF EXISTS
option, which is a
PostgreSQL
extension\&.
.SH "SEE ALSO"
ALTER SCHEMA (\fBALTER_SCHEMA\fR(7)), CREATE SCHEMA (\fBCREATE_SCHEMA\fR(7))
man/man7/PREPARE_TRANSACTION.7 0000644 00000013365 14751153421 0011227 0 ustar 00 '\" t
.\" Title: PREPARE TRANSACTION
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "PREPARE TRANSACTION" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
PREPARE_TRANSACTION \- prepare the current transaction for two\-phase commit
.SH "SYNOPSIS"
.sp
.nf
PREPARE TRANSACTION \fItransaction_id\fR
.fi
.SH "DESCRIPTION"
.PP
\fBPREPARE TRANSACTION\fR
prepares the current transaction for two\-phase commit\&. After this command, the transaction is no longer associated with the current session; instead, its state is fully stored on disk, and there is a very high probability that it can be committed successfully, even if a database crash occurs before the commit is requested\&.
.PP
Once prepared, a transaction can later be committed or rolled back with
COMMIT PREPARED (\fBCOMMIT_PREPARED\fR(7))
or
ROLLBACK PREPARED (\fBROLLBACK_PREPARED\fR(7)), respectively\&. Those commands can be issued from any session, not only the one that executed the original transaction\&.
.PP
From the point of view of the issuing session,
\fBPREPARE TRANSACTION\fR
is not unlike a
\fBROLLBACK\fR
command: after executing it, there is no active current transaction, and the effects of the prepared transaction are no longer visible\&. (The effects will become visible again if the transaction is committed\&.)
.PP
If the
\fBPREPARE TRANSACTION\fR
command fails for any reason, it becomes a
\fBROLLBACK\fR: the current transaction is canceled\&.
.SH "PARAMETERS"
.PP
\fItransaction_id\fR
.RS 4
An arbitrary identifier that later identifies this transaction for
\fBCOMMIT PREPARED\fR
or
\fBROLLBACK PREPARED\fR\&. The identifier must be written as a string literal, and must be less than 200 bytes long\&. It must not be the same as the identifier used for any currently prepared transaction\&.
.RE
.SH "NOTES"
.PP
\fBPREPARE TRANSACTION\fR
is not intended for use in applications or interactive sessions\&. Its purpose is to allow an external transaction manager to perform atomic global transactions across multiple databases or other transactional resources\&. Unless you\*(Aqre writing a transaction manager, you probably shouldn\*(Aqt be using
\fBPREPARE TRANSACTION\fR\&.
.PP
This command must be used inside a transaction block\&. Use
\fBBEGIN\fR(7)
to start one\&.
.PP
It is not currently allowed to
\fBPREPARE\fR
a transaction that has executed any operations involving temporary tables, created any cursors
WITH HOLD, or executed
\fBLISTEN\fR,
\fBUNLISTEN\fR, or
\fBNOTIFY\fR\&. Those features are too tightly tied to the current session to be useful in a transaction to be prepared\&.
.PP
If the transaction modified any run\-time parameters with
\fBSET\fR
(without the
LOCAL
option), those effects persist after
\fBPREPARE TRANSACTION\fR, and will not be affected by any later
\fBCOMMIT PREPARED\fR
or
\fBROLLBACK PREPARED\fR\&. Thus, in this one respect
\fBPREPARE TRANSACTION\fR
acts more like
\fBCOMMIT\fR
than
\fBROLLBACK\fR\&.
.PP
All currently available prepared transactions are listed in the
pg_prepared_xacts
system view\&.
.if n \{\
.sp
.\}
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBCaution\fR
.ps -1
.br
.PP
It is unwise to leave transactions in the prepared state for a long time\&. This will interfere with the ability of
\fBVACUUM\fR
to reclaim storage, and in extreme cases could cause the database to shut down to prevent transaction ID wraparound (see
Section 24.1.5, \(lqPreventing Transaction ID Wraparound Failures\(rq, in the documentation)\&. Keep in mind also that the transaction continues to hold whatever locks it held\&. The intended usage of the feature is that a prepared transaction will normally be committed or rolled back as soon as an external transaction manager has verified that other databases are also prepared to commit\&.
.PP
If you have not set up an external transaction manager to track prepared transactions and ensure they get closed out promptly, it is best to keep the prepared\-transaction feature disabled by setting
max_prepared_transactions
to zero\&. This will prevent accidental creation of prepared transactions that might then be forgotten and eventually cause problems\&.
.sp .5v
.RE
.SH "EXAMPLES"
.PP
Prepare the current transaction for two\-phase commit, using
foobar
as the transaction identifier:
.sp
.if n \{\
.RS 4
.\}
.nf
PREPARE TRANSACTION \*(Aqfoobar\*(Aq;
.fi
.if n \{\
.RE
.\}
.SH "COMPATIBILITY"
.PP
\fBPREPARE TRANSACTION\fR
is a
PostgreSQL
extension\&. It is intended for use by external transaction management systems, some of which are covered by standards (such as X/Open XA), but the SQL side of those systems is not standardized\&.
.SH "SEE ALSO"
COMMIT PREPARED (\fBCOMMIT_PREPARED\fR(7)), ROLLBACK PREPARED (\fBROLLBACK_PREPARED\fR(7))
man/man7/DROP_FOREIGN_DATA_WRAPPER.7 0000644 00000005164 14751153421 0012170 0 ustar 00 '\" t
.\" Title: DROP FOREIGN DATA WRAPPER
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "DROP FOREIGN DATA WRAPPER" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
DROP_FOREIGN_DATA_WRAPPER \- remove a foreign\-data wrapper
.SH "SYNOPSIS"
.sp
.nf
DROP FOREIGN DATA WRAPPER [ IF EXISTS ] \fIname\fR [ CASCADE | RESTRICT ]
.fi
.SH "DESCRIPTION"
.PP
\fBDROP FOREIGN DATA WRAPPER\fR
removes an existing foreign\-data wrapper\&. To execute this command, the current user must be the owner of the foreign\-data wrapper\&.
.SH "PARAMETERS"
.PP
IF EXISTS
.RS 4
Do not throw an error if the foreign\-data wrapper does not exist\&. A notice is issued in this case\&.
.RE
.PP
\fIname\fR
.RS 4
The name of an existing foreign\-data wrapper\&.
.RE
.PP
CASCADE
.RS 4
Automatically drop objects that depend on the foreign\-data wrapper (such as foreign tables and servers), and in turn all objects that depend on those objects (see
Section 5.13, \(lqDependency Tracking\(rq, in the documentation)\&.
.RE
.PP
RESTRICT
.RS 4
Refuse to drop the foreign\-data wrapper if any objects depend on it\&. This is the default\&.
.RE
.SH "EXAMPLES"
.PP
Drop the foreign\-data wrapper
dbi:
.sp
.if n \{\
.RS 4
.\}
.nf
DROP FOREIGN DATA WRAPPER dbi;
.fi
.if n \{\
.RE
.\}
.SH "COMPATIBILITY"
.PP
\fBDROP FOREIGN DATA WRAPPER\fR
conforms to ISO/IEC 9075\-9 (SQL/MED)\&. The
IF EXISTS
clause is a
PostgreSQL
extension\&.
.SH "SEE ALSO"
CREATE FOREIGN DATA WRAPPER (\fBCREATE_FOREIGN_DATA_WRAPPER\fR(7)), ALTER FOREIGN DATA WRAPPER (\fBALTER_FOREIGN_DATA_WRAPPER\fR(7))
man/man7/ROLLBACK_TO_SAVEPOINT.7 0000644 00000007703 14751153421 0011506 0 ustar 00 '\" t
.\" Title: ROLLBACK TO SAVEPOINT
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "ROLLBACK TO SAVEPOINT" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
ROLLBACK_TO_SAVEPOINT \- roll back to a savepoint
.SH "SYNOPSIS"
.sp
.nf
ROLLBACK [ WORK | TRANSACTION ] TO [ SAVEPOINT ] \fIsavepoint_name\fR
.fi
.SH "DESCRIPTION"
.PP
Roll back all commands that were executed after the savepoint was established\&. The savepoint remains valid and can be rolled back to again later, if needed\&.
.PP
\fBROLLBACK TO SAVEPOINT\fR
implicitly destroys all savepoints that were established after the named savepoint\&.
.SH "PARAMETERS"
.PP
\fIsavepoint_name\fR
.RS 4
The savepoint to roll back to\&.
.RE
.SH "NOTES"
.PP
Use
RELEASE SAVEPOINT (\fBRELEASE_SAVEPOINT\fR(7))
to destroy a savepoint without discarding the effects of commands executed after it was established\&.
.PP
Specifying a savepoint name that has not been established is an error\&.
.PP
Cursors have somewhat non\-transactional behavior with respect to savepoints\&. Any cursor that is opened inside a savepoint will be closed when the savepoint is rolled back\&. If a previously opened cursor is affected by a
\fBFETCH\fR
or
\fBMOVE\fR
command inside a savepoint that is later rolled back, the cursor remains at the position that
\fBFETCH\fR
left it pointing to (that is, the cursor motion caused by
\fBFETCH\fR
is not rolled back)\&. Closing a cursor is not undone by rolling back, either\&. However, other side\-effects caused by the cursor\*(Aqs query (such as side\-effects of volatile functions called by the query)
\fIare\fR
rolled back if they occur during a savepoint that is later rolled back\&. A cursor whose execution causes a transaction to abort is put in a cannot\-execute state, so while the transaction can be restored using
\fBROLLBACK TO SAVEPOINT\fR, the cursor can no longer be used\&.
.SH "EXAMPLES"
.PP
To undo the effects of the commands executed after
my_savepoint
was established:
.sp
.if n \{\
.RS 4
.\}
.nf
ROLLBACK TO SAVEPOINT my_savepoint;
.fi
.if n \{\
.RE
.\}
.PP
Cursor positions are not affected by savepoint rollback:
.sp
.if n \{\
.RS 4
.\}
.nf
BEGIN;
DECLARE foo CURSOR FOR SELECT 1 UNION SELECT 2;
SAVEPOINT foo;
FETCH 1 FROM foo;
?column?
\-\-\-\-\-\-\-\-\-\-
1
ROLLBACK TO SAVEPOINT foo;
FETCH 1 FROM foo;
?column?
\-\-\-\-\-\-\-\-\-\-
2
COMMIT;
.fi
.if n \{\
.RE
.\}
.SH "COMPATIBILITY"
.PP
The
SQL
standard specifies that the key word
SAVEPOINT
is mandatory, but
PostgreSQL
and
Oracle
allow it to be omitted\&. SQL allows only
WORK, not
TRANSACTION, as a noise word after
ROLLBACK\&. Also, SQL has an optional clause
AND [ NO ] CHAIN
which is not currently supported by
PostgreSQL\&. Otherwise, this command conforms to the SQL standard\&.
.SH "SEE ALSO"
\fBBEGIN\fR(7), \fBCOMMIT\fR(7), RELEASE SAVEPOINT (\fBRELEASE_SAVEPOINT\fR(7)), \fBROLLBACK\fR(7), \fBSAVEPOINT\fR(7)
man/man7/ALTER_GROUP.7 0000644 00000006130 14751153421 0010077 0 ustar 00 '\" t
.\" Title: ALTER GROUP
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "ALTER GROUP" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
ALTER_GROUP \- change role name or membership
.SH "SYNOPSIS"
.sp
.nf
ALTER GROUP \fIrole_specification\fR ADD USER \fIuser_name\fR [, \&.\&.\&. ]
ALTER GROUP \fIrole_specification\fR DROP USER \fIuser_name\fR [, \&.\&.\&. ]
where \fIrole_specification\fR can be:
\fIrole_name\fR
| CURRENT_USER
| SESSION_USER
ALTER GROUP \fIgroup_name\fR RENAME TO \fInew_name\fR
.fi
.SH "DESCRIPTION"
.PP
\fBALTER GROUP\fR
changes the attributes of a user group\&. This is an obsolete command, though still accepted for backwards compatibility, because groups (and users too) have been superseded by the more general concept of roles\&.
.PP
The first two variants add users to a group or remove them from a group\&. (Any role can play the part of either a
\(lquser\(rq
or a
\(lqgroup\(rq
for this purpose\&.) These variants are effectively equivalent to granting or revoking membership in the role named as the
\(lqgroup\(rq; so the preferred way to do this is to use
\fBGRANT\fR(7)
or
\fBREVOKE\fR(7)\&.
.PP
The third variant changes the name of the group\&. This is exactly equivalent to renaming the role with
ALTER ROLE (\fBALTER_ROLE\fR(7))\&.
.SH "PARAMETERS"
.PP
\fIgroup_name\fR
.RS 4
The name of the group (role) to modify\&.
.RE
.PP
\fIuser_name\fR
.RS 4
Users (roles) that are to be added to or removed from the group\&. The users must already exist;
\fBALTER GROUP\fR
does not create or drop users\&.
.RE
.PP
\fInew_name\fR
.RS 4
The new name of the group\&.
.RE
.SH "EXAMPLES"
.PP
Add users to a group:
.sp
.if n \{\
.RS 4
.\}
.nf
ALTER GROUP staff ADD USER karl, john;
.fi
.if n \{\
.RE
.\}
.sp
Remove a user from a group:
.sp
.if n \{\
.RS 4
.\}
.nf
ALTER GROUP workers DROP USER beth;
.fi
.if n \{\
.RE
.\}
.SH "COMPATIBILITY"
.PP
There is no
\fBALTER GROUP\fR
statement in the SQL standard\&.
.SH "SEE ALSO"
\fBGRANT\fR(7), \fBREVOKE\fR(7), ALTER ROLE (\fBALTER_ROLE\fR(7))
man/man7/FETCH.7 0000644 00000020764 14751153421 0007116 0 ustar 00 '\" t
.\" Title: FETCH
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "FETCH" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
FETCH \- retrieve rows from a query using a cursor
.SH "SYNOPSIS"
.sp
.nf
FETCH [ \fIdirection\fR [ FROM | IN ] ] \fIcursor_name\fR
where \fIdirection\fR can be empty or one of:
NEXT
PRIOR
FIRST
LAST
ABSOLUTE \fIcount\fR
RELATIVE \fIcount\fR
\fIcount\fR
ALL
FORWARD
FORWARD \fIcount\fR
FORWARD ALL
BACKWARD
BACKWARD \fIcount\fR
BACKWARD ALL
.fi
.SH "DESCRIPTION"
.PP
\fBFETCH\fR
retrieves rows using a previously\-created cursor\&.
.PP
A cursor has an associated position, which is used by
\fBFETCH\fR\&. The cursor position can be before the first row of the query result, on any particular row of the result, or after the last row of the result\&. When created, a cursor is positioned before the first row\&. After fetching some rows, the cursor is positioned on the row most recently retrieved\&. If
\fBFETCH\fR
runs off the end of the available rows then the cursor is left positioned after the last row, or before the first row if fetching backward\&.
\fBFETCH ALL\fR
or
\fBFETCH BACKWARD ALL\fR
will always leave the cursor positioned after the last row or before the first row\&.
.PP
The forms
NEXT,
PRIOR,
FIRST,
LAST,
ABSOLUTE,
RELATIVE
fetch a single row after moving the cursor appropriately\&. If there is no such row, an empty result is returned, and the cursor is left positioned before the first row or after the last row as appropriate\&.
.PP
The forms using
FORWARD
and
BACKWARD
retrieve the indicated number of rows moving in the forward or backward direction, leaving the cursor positioned on the last\-returned row (or after/before all rows, if the
\fIcount\fR
exceeds the number of rows available)\&.
.PP
RELATIVE 0,
FORWARD 0, and
BACKWARD 0
all request fetching the current row without moving the cursor, that is, re\-fetching the most recently fetched row\&. This will succeed unless the cursor is positioned before the first row or after the last row; in which case, no row is returned\&.
.if n \{\
.sp
.\}
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBNote\fR
.ps -1
.br
.PP
This page describes usage of cursors at the SQL command level\&. If you are trying to use cursors inside a
PL/pgSQL
function, the rules are different \(em see
Section 41.7.3, \(lqUsing Cursors\(rq, in the documentation\&.
.sp .5v
.RE
.SH "PARAMETERS"
.PP
\fIdirection\fR
.RS 4
\fIdirection\fR
defines the fetch direction and number of rows to fetch\&. It can be one of the following:
.PP
NEXT
.RS 4
Fetch the next row\&. This is the default if
\fIdirection\fR
is omitted\&.
.RE
.PP
PRIOR
.RS 4
Fetch the prior row\&.
.RE
.PP
FIRST
.RS 4
Fetch the first row of the query (same as
ABSOLUTE 1)\&.
.RE
.PP
LAST
.RS 4
Fetch the last row of the query (same as
ABSOLUTE \-1)\&.
.RE
.PP
ABSOLUTE \fIcount\fR
.RS 4
Fetch the
\fIcount\fR\*(Aqth row of the query, or the
abs(\fIcount\fR)\*(Aqth row from the end if
\fIcount\fR
is negative\&. Position before first row or after last row if
\fIcount\fR
is out of range; in particular,
ABSOLUTE 0
positions before the first row\&.
.RE
.PP
RELATIVE \fIcount\fR
.RS 4
Fetch the
\fIcount\fR\*(Aqth succeeding row, or the
abs(\fIcount\fR)\*(Aqth prior row if
\fIcount\fR
is negative\&.
RELATIVE 0
re\-fetches the current row, if any\&.
.RE
.PP
\fIcount\fR
.RS 4
Fetch the next
\fIcount\fR
rows (same as
FORWARD \fIcount\fR)\&.
.RE
.PP
ALL
.RS 4
Fetch all remaining rows (same as
FORWARD ALL)\&.
.RE
.PP
FORWARD
.RS 4
Fetch the next row (same as
NEXT)\&.
.RE
.PP
FORWARD \fIcount\fR
.RS 4
Fetch the next
\fIcount\fR
rows\&.
FORWARD 0
re\-fetches the current row\&.
.RE
.PP
FORWARD ALL
.RS 4
Fetch all remaining rows\&.
.RE
.PP
BACKWARD
.RS 4
Fetch the prior row (same as
PRIOR)\&.
.RE
.PP
BACKWARD \fIcount\fR
.RS 4
Fetch the prior
\fIcount\fR
rows (scanning backwards)\&.
BACKWARD 0
re\-fetches the current row\&.
.RE
.PP
BACKWARD ALL
.RS 4
Fetch all prior rows (scanning backwards)\&.
.RE
.RE
.PP
\fIcount\fR
.RS 4
\fIcount\fR
is a possibly\-signed integer constant, determining the location or number of rows to fetch\&. For
FORWARD
and
BACKWARD
cases, specifying a negative
\fIcount\fR
is equivalent to changing the sense of
FORWARD
and
BACKWARD\&.
.RE
.PP
\fIcursor_name\fR
.RS 4
An open cursor\*(Aqs name\&.
.RE
.SH "OUTPUTS"
.PP
On successful completion, a
\fBFETCH\fR
command returns a command tag of the form
.sp
.if n \{\
.RS 4
.\}
.nf
FETCH \fIcount\fR
.fi
.if n \{\
.RE
.\}
.sp
The
\fIcount\fR
is the number of rows fetched (possibly zero)\&. Note that in
psql, the command tag will not actually be displayed, since
psql
displays the fetched rows instead\&.
.SH "NOTES"
.PP
The cursor should be declared with the
SCROLL
option if one intends to use any variants of
\fBFETCH\fR
other than
\fBFETCH NEXT\fR
or
\fBFETCH FORWARD\fR
with a positive count\&. For simple queries
PostgreSQL
will allow backwards fetch from cursors not declared with
SCROLL, but this behavior is best not relied on\&. If the cursor is declared with
NO SCROLL, no backward fetches are allowed\&.
.PP
ABSOLUTE
fetches are not any faster than navigating to the desired row with a relative move: the underlying implementation must traverse all the intermediate rows anyway\&. Negative absolute fetches are even worse: the query must be read to the end to find the last row, and then traversed backward from there\&. However, rewinding to the start of the query (as with
FETCH ABSOLUTE 0) is fast\&.
.PP
\fBDECLARE\fR(7)
is used to define a cursor\&. Use
\fBMOVE\fR(7)
to change cursor position without retrieving data\&.
.SH "EXAMPLES"
.PP
The following example traverses a table using a cursor:
.sp
.if n \{\
.RS 4
.\}
.nf
BEGIN WORK;
\-\- Set up a cursor:
DECLARE liahona SCROLL CURSOR FOR SELECT * FROM films;
\-\- Fetch the first 5 rows in the cursor liahona:
FETCH FORWARD 5 FROM liahona;
code | title | did | date_prod | kind | len
\-\-\-\-\-\-\-+\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-\-\-\-\-\-\-\-+\-\-\-\-\-\-\-\-\-\-+\-\-\-\-\-\-\-
BL101 | The Third Man | 101 | 1949\-12\-23 | Drama | 01:44
BL102 | The African Queen | 101 | 1951\-08\-11 | Romantic | 01:43
JL201 | Une Femme est une Femme | 102 | 1961\-03\-12 | Romantic | 01:25
P_301 | Vertigo | 103 | 1958\-11\-14 | Action | 02:08
P_302 | Becket | 103 | 1964\-02\-03 | Drama | 02:28
\-\- Fetch the previous row:
FETCH PRIOR FROM liahona;
code | title | did | date_prod | kind | len
\-\-\-\-\-\-\-+\-\-\-\-\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-\-\-\-\-\-\-\-+\-\-\-\-\-\-\-\-+\-\-\-\-\-\-\-
P_301 | Vertigo | 103 | 1958\-11\-14 | Action | 02:08
\-\- Close the cursor and end the transaction:
CLOSE liahona;
COMMIT WORK;
.fi
.if n \{\
.RE
.\}
.SH "COMPATIBILITY"
.PP
The SQL standard defines
\fBFETCH\fR
for use in embedded SQL only\&. The variant of
\fBFETCH\fR
described here returns the data as if it were a
\fBSELECT\fR
result rather than placing it in host variables\&. Other than this point,
\fBFETCH\fR
is fully upward\-compatible with the SQL standard\&.
.PP
The
\fBFETCH\fR
forms involving
FORWARD
and
BACKWARD, as well as the forms
FETCH \fIcount\fR
and
FETCH ALL, in which
FORWARD
is implicit, are
PostgreSQL
extensions\&.
.PP
The SQL standard allows only
FROM
preceding the cursor name; the option to use
IN, or to leave them out altogether, is an extension\&.
.SH "SEE ALSO"
\fBCLOSE\fR(7), \fBDECLARE\fR(7), \fBMOVE\fR(7)
man/man7/ALTER_POLICY.7 0000644 00000005611 14751153421 0010205 0 ustar 00 '\" t
.\" Title: ALTER POLICY
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "ALTER POLICY" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
ALTER_POLICY \- change the definition of a row level security policy
.SH "SYNOPSIS"
.sp
.nf
ALTER POLICY \fIname\fR ON \fItable_name\fR RENAME TO \fInew_name\fR
ALTER POLICY \fIname\fR ON \fItable_name\fR
[ TO { \fIrole_name\fR | PUBLIC | CURRENT_USER | SESSION_USER } [, \&.\&.\&.] ]
[ USING ( \fIusing_expression\fR ) ]
[ WITH CHECK ( \fIcheck_expression\fR ) ]
.fi
.SH "DESCRIPTION"
.PP
\fBALTER POLICY\fR
changes the definition of an existing row\-level security policy\&.
.PP
To use
\fBALTER POLICY\fR, you must own the table that the policy applies to\&.
.PP
In the second form of
\fBALTER POLICY\fR, the role list,
\fIusing_expression\fR, and
\fIcheck_expression\fR
are replaced independently if specified\&. When one of those clauses is omitted, the corresponding part of the policy is unchanged\&.
.SH "PARAMETERS"
.PP
\fIname\fR
.RS 4
The name of an existing policy to alter\&.
.RE
.PP
\fItable_name\fR
.RS 4
The name (optionally schema\-qualified) of the table that the policy is on\&.
.RE
.PP
\fInew_name\fR
.RS 4
The new name for the policy\&.
.RE
.PP
\fIrole_name\fR
.RS 4
The role(s) to which the policy applies\&. Multiple roles can be specified at one time\&. To apply the policy to all roles, use
PUBLIC\&.
.RE
.PP
\fIusing_expression\fR
.RS 4
The
USING
expression for the policy\&. See
CREATE POLICY (\fBCREATE_POLICY\fR(7))
for details\&.
.RE
.PP
\fIcheck_expression\fR
.RS 4
The
WITH CHECK
expression for the policy\&. See
CREATE POLICY (\fBCREATE_POLICY\fR(7))
for details\&.
.RE
.SH "COMPATIBILITY"
.PP
\fBALTER POLICY\fR
is a
PostgreSQL
extension\&.
.SH "SEE ALSO"
CREATE POLICY (\fBCREATE_POLICY\fR(7)), DROP POLICY (\fBDROP_POLICY\fR(7))
man/man7/DROP_EXTENSION.7 0000644 00000005355 14751153421 0010464 0 ustar 00 '\" t
.\" Title: DROP EXTENSION
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "DROP EXTENSION" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
DROP_EXTENSION \- remove an extension
.SH "SYNOPSIS"
.sp
.nf
DROP EXTENSION [ IF EXISTS ] \fIname\fR [, \&.\&.\&.] [ CASCADE | RESTRICT ]
.fi
.SH "DESCRIPTION"
.PP
\fBDROP EXTENSION\fR
removes extensions from the database\&. Dropping an extension causes its component objects to be dropped as well\&.
.PP
You must own the extension to use
\fBDROP EXTENSION\fR\&.
.SH "PARAMETERS"
.PP
IF EXISTS
.RS 4
Do not throw an error if the extension does not exist\&. A notice is issued in this case\&.
.RE
.PP
\fIname\fR
.RS 4
The name of an installed extension\&.
.RE
.PP
CASCADE
.RS 4
Automatically drop objects that depend on the extension, and in turn all objects that depend on those objects (see
Section 5.13, \(lqDependency Tracking\(rq, in the documentation)\&.
.RE
.PP
RESTRICT
.RS 4
Refuse to drop the extension if any objects depend on it (other than its own member objects and other extensions listed in the same
\fBDROP\fR
command)\&. This is the default\&.
.RE
.SH "EXAMPLES"
.PP
To remove the extension
hstore
from the current database:
.sp
.if n \{\
.RS 4
.\}
.nf
DROP EXTENSION hstore;
.fi
.if n \{\
.RE
.\}
.sp
This command will fail if any of
hstore\*(Aqs objects are in use in the database, for example if any tables have columns of the
hstore
type\&. Add the
CASCADE
option to forcibly remove those dependent objects as well\&.
.SH "COMPATIBILITY"
.PP
\fBDROP EXTENSION\fR
is a
PostgreSQL
extension\&.
.SH "SEE ALSO"
CREATE EXTENSION (\fBCREATE_EXTENSION\fR(7)), ALTER EXTENSION (\fBALTER_EXTENSION\fR(7))
man/man7/SET_TRANSACTION.7 0000644 00000021326 14751153421 0010560 0 ustar 00 '\" t
.\" Title: SET TRANSACTION
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "SET TRANSACTION" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
SET_TRANSACTION \- set the characteristics of the current transaction
.SH "SYNOPSIS"
.sp
.nf
SET TRANSACTION \fItransaction_mode\fR [, \&.\&.\&.]
SET TRANSACTION SNAPSHOT \fIsnapshot_id\fR
SET SESSION CHARACTERISTICS AS TRANSACTION \fItransaction_mode\fR [, \&.\&.\&.]
where \fItransaction_mode\fR is one of:
ISOLATION LEVEL { SERIALIZABLE | REPEATABLE READ | READ COMMITTED | READ UNCOMMITTED }
READ WRITE | READ ONLY
[ NOT ] DEFERRABLE
.fi
.SH "DESCRIPTION"
.PP
The
\fBSET TRANSACTION\fR
command sets the characteristics of the current transaction\&. It has no effect on any subsequent transactions\&.
\fBSET SESSION CHARACTERISTICS\fR
sets the default transaction characteristics for subsequent transactions of a session\&. These defaults can be overridden by
\fBSET TRANSACTION\fR
for an individual transaction\&.
.PP
The available transaction characteristics are the transaction isolation level, the transaction access mode (read/write or read\-only), and the deferrable mode\&. In addition, a snapshot can be selected, though only for the current transaction, not as a session default\&.
.PP
The isolation level of a transaction determines what data the transaction can see when other transactions are running concurrently:
.PP
READ COMMITTED
.RS 4
A statement can only see rows committed before it began\&. This is the default\&.
.RE
.PP
REPEATABLE READ
.RS 4
All statements of the current transaction can only see rows committed before the first query or data\-modification statement was executed in this transaction\&.
.RE
.PP
SERIALIZABLE
.RS 4
All statements of the current transaction can only see rows committed before the first query or data\-modification statement was executed in this transaction\&. If a pattern of reads and writes among concurrent serializable transactions would create a situation which could not have occurred for any serial (one\-at\-a\-time) execution of those transactions, one of them will be rolled back with a
serialization_failure
error\&.
.RE
The SQL standard defines one additional level,
READ UNCOMMITTED\&. In
PostgreSQL
READ UNCOMMITTED
is treated as
READ COMMITTED\&.
.PP
The transaction isolation level cannot be changed after the first query or data\-modification statement (\fBSELECT\fR,
\fBINSERT\fR,
\fBDELETE\fR,
\fBUPDATE\fR,
\fBFETCH\fR, or
\fBCOPY\fR) of a transaction has been executed\&. See
Chapter 13, Concurrency Control, in the documentation
for more information about transaction isolation and concurrency control\&.
.PP
The transaction access mode determines whether the transaction is read/write or read\-only\&. Read/write is the default\&. When a transaction is read\-only, the following SQL commands are disallowed:
INSERT,
UPDATE,
DELETE, and
COPY FROM
if the table they would write to is not a temporary table; all
CREATE,
ALTER, and
DROP
commands;
COMMENT,
GRANT,
REVOKE,
TRUNCATE; and
EXPLAIN ANALYZE
and
EXECUTE
if the command they would execute is among those listed\&. This is a high\-level notion of read\-only that does not prevent all writes to disk\&.
.PP
The
DEFERRABLE
transaction property has no effect unless the transaction is also
SERIALIZABLE
and
READ ONLY\&. When all three of these properties are selected for a transaction, the transaction may block when first acquiring its snapshot, after which it is able to run without the normal overhead of a
SERIALIZABLE
transaction and without any risk of contributing to or being canceled by a serialization failure\&. This mode is well suited for long\-running reports or backups\&.
.PP
The
SET TRANSACTION SNAPSHOT
command allows a new transaction to run with the same
snapshot
as an existing transaction\&. The pre\-existing transaction must have exported its snapshot with the
pg_export_snapshot
function (see
Section 9.26.5, \(lqSnapshot Synchronization Functions\(rq, in the documentation)\&. That function returns a snapshot identifier, which must be given to
SET TRANSACTION SNAPSHOT
to specify which snapshot is to be imported\&. The identifier must be written as a string literal in this command, for example
\*(Aq000003A1\-1\*(Aq\&.
SET TRANSACTION SNAPSHOT
can only be executed at the start of a transaction, before the first query or data\-modification statement (\fBSELECT\fR,
\fBINSERT\fR,
\fBDELETE\fR,
\fBUPDATE\fR,
\fBFETCH\fR, or
\fBCOPY\fR) of the transaction\&. Furthermore, the transaction must already be set to
SERIALIZABLE
or
REPEATABLE READ
isolation level (otherwise, the snapshot would be discarded immediately, since
READ COMMITTED
mode takes a new snapshot for each command)\&. If the importing transaction uses
SERIALIZABLE
isolation level, then the transaction that exported the snapshot must also use that isolation level\&. Also, a non\-read\-only serializable transaction cannot import a snapshot from a read\-only transaction\&.
.SH "NOTES"
.PP
If
\fBSET TRANSACTION\fR
is executed without a prior
\fBSTART TRANSACTION\fR
or
\fBBEGIN\fR, it emits a warning and otherwise has no effect\&.
.PP
It is possible to dispense with
\fBSET TRANSACTION\fR
by instead specifying the desired
\fItransaction_modes\fR
in
\fBBEGIN\fR
or
\fBSTART TRANSACTION\fR\&. But that option is not available for
\fBSET TRANSACTION SNAPSHOT\fR\&.
.PP
The session default transaction modes can also be set or examined via the configuration parameters
default_transaction_isolation,
default_transaction_read_only, and
default_transaction_deferrable\&. (In fact
\fBSET SESSION CHARACTERISTICS\fR
is just a verbose equivalent for setting these variables with
\fBSET\fR\&.) This means the defaults can be set in the configuration file, via
\fBALTER DATABASE\fR, etc\&. Consult
Chapter 19, Server Configuration, in the documentation
for more information\&.
.PP
The current transaction\*(Aqs modes can similarly be set or examined via the configuration parameters
transaction_isolation,
transaction_read_only, and
transaction_deferrable\&. Setting one of these parameters acts the same as the corresponding
\fBSET TRANSACTION\fR
option, with the same restrictions on when it can be done\&. However, these parameters cannot be set in the configuration file, or from any source other than live SQL\&.
.SH "EXAMPLES"
.PP
To begin a new transaction with the same snapshot as an already existing transaction, first export the snapshot from the existing transaction\&. That will return the snapshot identifier, for example:
.sp
.if n \{\
.RS 4
.\}
.nf
BEGIN TRANSACTION ISOLATION LEVEL REPEATABLE READ;
SELECT pg_export_snapshot();
pg_export_snapshot
\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
000003A1\-1
(1 row)
.fi
.if n \{\
.RE
.\}
.sp
Then give the snapshot identifier in a
\fBSET TRANSACTION SNAPSHOT\fR
command at the beginning of the newly opened transaction:
.sp
.if n \{\
.RS 4
.\}
.nf
BEGIN TRANSACTION ISOLATION LEVEL REPEATABLE READ;
SET TRANSACTION SNAPSHOT \*(Aq000003A1\-1\*(Aq;
.fi
.if n \{\
.RE
.\}
.SH "COMPATIBILITY"
.PP
These commands are defined in the
SQL
standard, except for the
DEFERRABLE
transaction mode and the
\fBSET TRANSACTION SNAPSHOT\fR
form, which are
PostgreSQL
extensions\&.
.PP
SERIALIZABLE
is the default transaction isolation level in the standard\&. In
PostgreSQL
the default is ordinarily
READ COMMITTED, but you can change it as mentioned above\&.
.PP
In the SQL standard, there is one other transaction characteristic that can be set with these commands: the size of the diagnostics area\&. This concept is specific to embedded SQL, and therefore is not implemented in the
PostgreSQL
server\&.
.PP
The SQL standard requires commas between successive
\fItransaction_modes\fR, but for historical reasons
PostgreSQL
allows the commas to be omitted\&.
man/man7/DROP_CAST.7 0000644 00000004415 14751153421 0007636 0 ustar 00 '\" t
.\" Title: DROP CAST
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "DROP CAST" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
DROP_CAST \- remove a cast
.SH "SYNOPSIS"
.sp
.nf
DROP CAST [ IF EXISTS ] (\fIsource_type\fR AS \fItarget_type\fR) [ CASCADE | RESTRICT ]
.fi
.SH "DESCRIPTION"
.PP
\fBDROP CAST\fR
removes a previously defined cast\&.
.PP
To be able to drop a cast, you must own the source or the target data type\&. These are the same privileges that are required to create a cast\&.
.SH "PARAMETERS"
.PP
IF EXISTS
.RS 4
Do not throw an error if the cast does not exist\&. A notice is issued in this case\&.
.RE
.PP
\fIsource_type\fR
.RS 4
The name of the source data type of the cast\&.
.RE
.PP
\fItarget_type\fR
.RS 4
The name of the target data type of the cast\&.
.RE
.PP
CASCADE
.br
RESTRICT
.RS 4
These key words do not have any effect, since there are no dependencies on casts\&.
.RE
.SH "EXAMPLES"
.PP
To drop the cast from type
text
to type
int:
.sp
.if n \{\
.RS 4
.\}
.nf
DROP CAST (text AS int);
.fi
.if n \{\
.RE
.\}
.SH "COMPATIBILITY"
.PP
The
\fBDROP CAST\fR
command conforms to the SQL standard\&.
.SH "SEE ALSO"
CREATE CAST (\fBCREATE_CAST\fR(7))
man/man7/CREATE_DOMAIN.7 0000644 00000017051 14751153421 0010252 0 ustar 00 '\" t
.\" Title: CREATE DOMAIN
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "CREATE DOMAIN" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
CREATE_DOMAIN \- define a new domain
.SH "SYNOPSIS"
.sp
.nf
CREATE DOMAIN \fIname\fR [ AS ] \fIdata_type\fR
[ COLLATE \fIcollation\fR ]
[ DEFAULT \fIexpression\fR ]
[ \fIconstraint\fR [ \&.\&.\&. ] ]
where \fIconstraint\fR is:
[ CONSTRAINT \fIconstraint_name\fR ]
{ NOT NULL | NULL | CHECK (\fIexpression\fR) }
.fi
.SH "DESCRIPTION"
.PP
\fBCREATE DOMAIN\fR
creates a new domain\&. A domain is essentially a data type with optional constraints (restrictions on the allowed set of values)\&. The user who defines a domain becomes its owner\&.
.PP
If a schema name is given (for example,
CREATE DOMAIN myschema\&.mydomain \&.\&.\&.) then the domain is created in the specified schema\&. Otherwise it is created in the current schema\&. The domain name must be unique among the types and domains existing in its schema\&.
.PP
Domains are useful for abstracting common constraints on fields into a single location for maintenance\&. For example, several tables might contain email address columns, all requiring the same CHECK constraint to verify the address syntax\&. Define a domain rather than setting up each table\*(Aqs constraint individually\&.
.PP
To be able to create a domain, you must have
USAGE
privilege on the underlying type\&.
.SH "PARAMETERS"
.PP
\fIname\fR
.RS 4
The name (optionally schema\-qualified) of a domain to be created\&.
.RE
.PP
\fIdata_type\fR
.RS 4
The underlying data type of the domain\&. This can include array specifiers\&.
.RE
.PP
\fIcollation\fR
.RS 4
An optional collation for the domain\&. If no collation is specified, the underlying data type\*(Aqs default collation is used\&. The underlying type must be collatable if
COLLATE
is specified\&.
.RE
.PP
DEFAULT \fIexpression\fR
.RS 4
The
DEFAULT
clause specifies a default value for columns of the domain data type\&. The value is any variable\-free expression (but subqueries are not allowed)\&. The data type of the default expression must match the data type of the domain\&. If no default value is specified, then the default value is the null value\&.
.sp
The default expression will be used in any insert operation that does not specify a value for the column\&. If a default value is defined for a particular column, it overrides any default associated with the domain\&. In turn, the domain default overrides any default value associated with the underlying data type\&.
.RE
.PP
CONSTRAINT \fIconstraint_name\fR
.RS 4
An optional name for a constraint\&. If not specified, the system generates a name\&.
.RE
.PP
NOT NULL
.RS 4
Values of this domain are prevented from being null (but see notes below)\&.
.RE
.PP
NULL
.RS 4
Values of this domain are allowed to be null\&. This is the default\&.
.sp
This clause is only intended for compatibility with nonstandard SQL databases\&. Its use is discouraged in new applications\&.
.RE
.PP
CHECK (\fIexpression\fR)
.RS 4
CHECK
clauses specify integrity constraints or tests which values of the domain must satisfy\&. Each constraint must be an expression producing a Boolean result\&. It should use the key word
VALUE
to refer to the value being tested\&. Expressions evaluating to TRUE or UNKNOWN succeed\&. If the expression produces a FALSE result, an error is reported and the value is not allowed to be converted to the domain type\&.
.sp
Currently,
CHECK
expressions cannot contain subqueries nor refer to variables other than
VALUE\&.
.sp
When a domain has multiple
CHECK
constraints, they will be tested in alphabetical order by name\&. (PostgreSQL
versions before 9\&.5 did not honor any particular firing order for
CHECK
constraints\&.)
.RE
.SH "NOTES"
.PP
Domain constraints, particularly
NOT NULL, are checked when converting a value to the domain type\&. It is possible for a column that is nominally of the domain type to read as null despite there being such a constraint\&. For example, this can happen in an outer\-join query, if the domain column is on the nullable side of the outer join\&. A more subtle example is
.sp
.if n \{\
.RS 4
.\}
.nf
INSERT INTO tab (domcol) VALUES ((SELECT domcol FROM tab WHERE false));
.fi
.if n \{\
.RE
.\}
.sp
The empty scalar sub\-SELECT will produce a null value that is considered to be of the domain type, so no further constraint checking is applied to it, and the insertion will succeed\&.
.PP
It is very difficult to avoid such problems, because of SQL\*(Aqs general assumption that a null value is a valid value of every data type\&. Best practice therefore is to design a domain\*(Aqs constraints so that a null value is allowed, and then to apply column
NOT NULL
constraints to columns of the domain type as needed, rather than directly to the domain type\&.
.PP
PostgreSQL
assumes that
CHECK
constraints\*(Aq conditions are immutable, that is, they will always give the same result for the same input value\&. This assumption is what justifies examining
CHECK
constraints only when a value is first converted to be of a domain type, and not at other times\&. (This is essentially the same as the treatment of table
CHECK
constraints, as described in
Section 5.3.1, \(lqCheck Constraints\(rq, in the documentation\&.)
.PP
An example of a common way to break this assumption is to reference a user\-defined function in a
CHECK
expression, and then change the behavior of that function\&.
PostgreSQL
does not disallow that, but it will not notice if there are stored values of the domain type that now violate the
CHECK
constraint\&. That would cause a subsequent database dump and reload to fail\&. The recommended way to handle such a change is to drop the constraint (using
\fBALTER DOMAIN\fR), adjust the function definition, and re\-add the constraint, thereby rechecking it against stored data\&.
.SH "EXAMPLES"
.PP
This example creates the
us_postal_code
data type and then uses the type in a table definition\&. A regular expression test is used to verify that the value looks like a valid US postal code:
.sp
.if n \{\
.RS 4
.\}
.nf
CREATE DOMAIN us_postal_code AS TEXT
CHECK(
VALUE ~ \*(Aq^\ed{5}$\*(Aq
OR VALUE ~ \*(Aq^\ed{5}\-\ed{4}$\*(Aq
);
CREATE TABLE us_snail_addy (
address_id SERIAL PRIMARY KEY,
street1 TEXT NOT NULL,
street2 TEXT,
street3 TEXT,
city TEXT NOT NULL,
postal us_postal_code NOT NULL
);
.fi
.if n \{\
.RE
.\}
.SH "COMPATIBILITY"
.PP
The command
\fBCREATE DOMAIN\fR
conforms to the SQL standard\&.
.SH "SEE ALSO"
ALTER DOMAIN (\fBALTER_DOMAIN\fR(7)), DROP DOMAIN (\fBDROP_DOMAIN\fR(7))
man/man7/ALTER_TEXT_SEARCH_TEMPLATE.7 0000644 00000004420 14751153421 0012307 0 ustar 00 '\" t
.\" Title: ALTER TEXT SEARCH TEMPLATE
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "ALTER TEXT SEARCH TEMPLATE" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
ALTER_TEXT_SEARCH_TEMPLATE \- change the definition of a text search template
.SH "SYNOPSIS"
.sp
.nf
ALTER TEXT SEARCH TEMPLATE \fIname\fR RENAME TO \fInew_name\fR
ALTER TEXT SEARCH TEMPLATE \fIname\fR SET SCHEMA \fInew_schema\fR
.fi
.SH "DESCRIPTION"
.PP
\fBALTER TEXT SEARCH TEMPLATE\fR
changes the definition of a text search template\&. Currently, the only supported functionality is to change the template\*(Aqs name\&.
.PP
You must be a superuser to use
\fBALTER TEXT SEARCH TEMPLATE\fR\&.
.SH "PARAMETERS"
.PP
\fIname\fR
.RS 4
The name (optionally schema\-qualified) of an existing text search template\&.
.RE
.PP
\fInew_name\fR
.RS 4
The new name of the text search template\&.
.RE
.PP
\fInew_schema\fR
.RS 4
The new schema for the text search template\&.
.RE
.SH "COMPATIBILITY"
.PP
There is no
\fBALTER TEXT SEARCH TEMPLATE\fR
statement in the SQL standard\&.
.SH "SEE ALSO"
CREATE TEXT SEARCH TEMPLATE (\fBCREATE_TEXT_SEARCH_TEMPLATE\fR(7)), DROP TEXT SEARCH TEMPLATE (\fBDROP_TEXT_SEARCH_TEMPLATE\fR(7))
man/man7/ALTER_SERVER.7 0000644 00000006643 14751153421 0010222 0 ustar 00 '\" t
.\" Title: ALTER SERVER
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "ALTER SERVER" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
ALTER_SERVER \- change the definition of a foreign server
.SH "SYNOPSIS"
.sp
.nf
ALTER SERVER \fIname\fR [ VERSION \*(Aq\fInew_version\fR\*(Aq ]
[ OPTIONS ( [ ADD | SET | DROP ] \fIoption\fR [\*(Aq\fIvalue\fR\*(Aq] [, \&.\&.\&. ] ) ]
ALTER SERVER \fIname\fR OWNER TO { \fInew_owner\fR | CURRENT_USER | SESSION_USER }
ALTER SERVER \fIname\fR RENAME TO \fInew_name\fR
.fi
.SH "DESCRIPTION"
.PP
\fBALTER SERVER\fR
changes the definition of a foreign server\&. The first form changes the server version string or the generic options of the server (at least one clause is required)\&. The second form changes the owner of the server\&.
.PP
To alter the server you must be the owner of the server\&. Additionally to alter the owner, you must own the server and also be a direct or indirect member of the new owning role, and you must have
USAGE
privilege on the server\*(Aqs foreign\-data wrapper\&. (Note that superusers satisfy all these criteria automatically\&.)
.SH "PARAMETERS"
.PP
\fIname\fR
.RS 4
The name of an existing server\&.
.RE
.PP
\fInew_version\fR
.RS 4
New server version\&.
.RE
.PP
OPTIONS ( [ ADD | SET | DROP ] \fIoption\fR [\*(Aq\fIvalue\fR\*(Aq] [, \&.\&.\&. ] )
.RS 4
Change options for the server\&.
ADD,
SET, and
DROP
specify the action to be performed\&.
ADD
is assumed if no operation is explicitly specified\&. Option names must be unique; names and values are also validated using the server\*(Aqs foreign\-data wrapper library\&.
.RE
.PP
\fInew_owner\fR
.RS 4
The user name of the new owner of the foreign server\&.
.RE
.PP
\fInew_name\fR
.RS 4
The new name for the foreign server\&.
.RE
.SH "EXAMPLES"
.PP
Alter server
foo, add connection options:
.sp
.if n \{\
.RS 4
.\}
.nf
ALTER SERVER foo OPTIONS (host \*(Aqfoo\*(Aq, dbname \*(Aqfoodb\*(Aq);
.fi
.if n \{\
.RE
.\}
.PP
Alter server
foo, change version, change
host
option:
.sp
.if n \{\
.RS 4
.\}
.nf
ALTER SERVER foo VERSION \*(Aq8\&.4\*(Aq OPTIONS (SET host \*(Aqbaz\*(Aq);
.fi
.if n \{\
.RE
.\}
.SH "COMPATIBILITY"
.PP
\fBALTER SERVER\fR
conforms to ISO/IEC 9075\-9 (SQL/MED)\&. The
OWNER TO
and
RENAME
forms are PostgreSQL extensions\&.
.SH "SEE ALSO"
CREATE SERVER (\fBCREATE_SERVER\fR(7)), DROP SERVER (\fBDROP_SERVER\fR(7))
man/man7/CREATE_AGGREGATE.7 0000644 00000056555 14751153421 0010605 0 ustar 00 '\" t
.\" Title: CREATE AGGREGATE
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "CREATE AGGREGATE" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
CREATE_AGGREGATE \- define a new aggregate function
.SH "SYNOPSIS"
.sp
.nf
CREATE AGGREGATE \fIname\fR ( [ \fIargmode\fR ] [ \fIargname\fR ] \fIarg_data_type\fR [ , \&.\&.\&. ] ) (
SFUNC = \fIsfunc\fR,
STYPE = \fIstate_data_type\fR
[ , SSPACE = \fIstate_data_size\fR ]
[ , FINALFUNC = \fIffunc\fR ]
[ , FINALFUNC_EXTRA ]
[ , COMBINEFUNC = \fIcombinefunc\fR ]
[ , SERIALFUNC = \fIserialfunc\fR ]
[ , DESERIALFUNC = \fIdeserialfunc\fR ]
[ , INITCOND = \fIinitial_condition\fR ]
[ , MSFUNC = \fImsfunc\fR ]
[ , MINVFUNC = \fIminvfunc\fR ]
[ , MSTYPE = \fImstate_data_type\fR ]
[ , MSSPACE = \fImstate_data_size\fR ]
[ , MFINALFUNC = \fImffunc\fR ]
[ , MFINALFUNC_EXTRA ]
[ , MINITCOND = \fIminitial_condition\fR ]
[ , SORTOP = \fIsort_operator\fR ]
[ , PARALLEL = { SAFE | RESTRICTED | UNSAFE } ]
)
CREATE AGGREGATE \fIname\fR ( [ [ \fIargmode\fR ] [ \fIargname\fR ] \fIarg_data_type\fR [ , \&.\&.\&. ] ]
ORDER BY [ \fIargmode\fR ] [ \fIargname\fR ] \fIarg_data_type\fR [ , \&.\&.\&. ] ) (
SFUNC = \fIsfunc\fR,
STYPE = \fIstate_data_type\fR
[ , SSPACE = \fIstate_data_size\fR ]
[ , FINALFUNC = \fIffunc\fR ]
[ , FINALFUNC_EXTRA ]
[ , INITCOND = \fIinitial_condition\fR ]
[ , PARALLEL = { SAFE | RESTRICTED | UNSAFE } ]
[ , HYPOTHETICAL ]
)
or the old syntax
CREATE AGGREGATE \fIname\fR (
BASETYPE = \fIbase_type\fR,
SFUNC = \fIsfunc\fR,
STYPE = \fIstate_data_type\fR
[ , SSPACE = \fIstate_data_size\fR ]
[ , FINALFUNC = \fIffunc\fR ]
[ , FINALFUNC_EXTRA ]
[ , COMBINEFUNC = \fIcombinefunc\fR ]
[ , SERIALFUNC = \fIserialfunc\fR ]
[ , DESERIALFUNC = \fIdeserialfunc\fR ]
[ , INITCOND = \fIinitial_condition\fR ]
[ , MSFUNC = \fImsfunc\fR ]
[ , MINVFUNC = \fIminvfunc\fR ]
[ , MSTYPE = \fImstate_data_type\fR ]
[ , MSSPACE = \fImstate_data_size\fR ]
[ , MFINALFUNC = \fImffunc\fR ]
[ , MFINALFUNC_EXTRA ]
[ , MINITCOND = \fIminitial_condition\fR ]
[ , SORTOP = \fIsort_operator\fR ]
)
.fi
.SH "DESCRIPTION"
.PP
\fBCREATE AGGREGATE\fR
defines a new aggregate function\&. Some basic and commonly\-used aggregate functions are included with the distribution; they are documented in
Section 9.20, \(lqAggregate Functions\(rq, in the documentation\&. If one defines new types or needs an aggregate function not already provided, then
\fBCREATE AGGREGATE\fR
can be used to provide the desired features\&.
.PP
If a schema name is given (for example,
CREATE AGGREGATE myschema\&.myagg \&.\&.\&.) then the aggregate function is created in the specified schema\&. Otherwise it is created in the current schema\&.
.PP
An aggregate function is identified by its name and input data type(s)\&. Two aggregates in the same schema can have the same name if they operate on different input types\&. The name and input data type(s) of an aggregate must also be distinct from the name and input data type(s) of every ordinary function in the same schema\&. This behavior is identical to overloading of ordinary function names (see
CREATE FUNCTION (\fBCREATE_FUNCTION\fR(7)))\&.
.PP
A simple aggregate function is made from one or two ordinary functions: a state transition function
\fIsfunc\fR, and an optional final calculation function
\fIffunc\fR\&. These are used as follows:
.sp
.if n \{\
.RS 4
.\}
.nf
\fIsfunc\fR( internal\-state, next\-data\-values ) \-\-\-> next\-internal\-state
\fIffunc\fR( internal\-state ) \-\-\-> aggregate\-value
.fi
.if n \{\
.RE
.\}
.PP
PostgreSQL
creates a temporary variable of data type
\fIstype\fR
to hold the current internal state of the aggregate\&. At each input row, the aggregate argument value(s) are calculated and the state transition function is invoked with the current state value and the new argument value(s) to calculate a new internal state value\&. After all the rows have been processed, the final function is invoked once to calculate the aggregate\*(Aqs return value\&. If there is no final function then the ending state value is returned as\-is\&.
.PP
An aggregate function can provide an initial condition, that is, an initial value for the internal state value\&. This is specified and stored in the database as a value of type
text, but it must be a valid external representation of a constant of the state value data type\&. If it is not supplied then the state value starts out null\&.
.PP
If the state transition function is declared
\(lqstrict\(rq, then it cannot be called with null inputs\&. With such a transition function, aggregate execution behaves as follows\&. Rows with any null input values are ignored (the function is not called and the previous state value is retained)\&. If the initial state value is null, then at the first row with all\-nonnull input values, the first argument value replaces the state value, and the transition function is invoked at each subsequent row with all\-nonnull input values\&. This is handy for implementing aggregates like
\fBmax\fR\&. Note that this behavior is only available when
\fIstate_data_type\fR
is the same as the first
\fIarg_data_type\fR\&. When these types are different, you must supply a nonnull initial condition or use a nonstrict transition function\&.
.PP
If the state transition function is not strict, then it will be called unconditionally at each input row, and must deal with null inputs and null state values for itself\&. This allows the aggregate author to have full control over the aggregate\*(Aqs handling of null values\&.
.PP
If the final function is declared
\(lqstrict\(rq, then it will not be called when the ending state value is null; instead a null result will be returned automatically\&. (Of course this is just the normal behavior of strict functions\&.) In any case the final function has the option of returning a null value\&. For example, the final function for
\fBavg\fR
returns null when it sees there were zero input rows\&.
.PP
Sometimes it is useful to declare the final function as taking not just the state value, but extra parameters corresponding to the aggregate\*(Aqs input values\&. The main reason for doing this is if the final function is polymorphic and the state value\*(Aqs data type would be inadequate to pin down the result type\&. These extra parameters are always passed as NULL (and so the final function must not be strict when the
FINALFUNC_EXTRA
option is used), but nonetheless they are valid parameters\&. The final function could for example make use of
\fBget_fn_expr_argtype\fR
to identify the actual argument type in the current call\&.
.PP
An aggregate can optionally support
moving\-aggregate mode, as described in
Section 36.10.1, \(lqMoving-Aggregate Mode\(rq, in the documentation\&. This requires specifying the
MSFUNC,
MINVFUNC, and
MSTYPE
parameters, and optionally the
MSSPACE,
MFINALFUNC,
MFINALFUNC_EXTRA, and
MINITCOND
parameters\&. Except for
MINVFUNC, these parameters work like the corresponding simple\-aggregate parameters without
M; they define a separate implementation of the aggregate that includes an inverse transition function\&.
.PP
The syntax with
ORDER BY
in the parameter list creates a special type of aggregate called an
ordered\-set aggregate; or if
HYPOTHETICAL
is specified, then a
hypothetical\-set aggregate
is created\&. These aggregates operate over groups of sorted values in order\-dependent ways, so that specification of an input sort order is an essential part of a call\&. Also, they can have
direct
arguments, which are arguments that are evaluated only once per aggregation rather than once per input row\&. Hypothetical\-set aggregates are a subclass of ordered\-set aggregates in which some of the direct arguments are required to match, in number and data types, the aggregated argument columns\&. This allows the values of those direct arguments to be added to the collection of aggregate\-input rows as an additional
\(lqhypothetical\(rq
row\&.
.PP
An aggregate can optionally support
partial aggregation, as described in
Section 36.10.4, \(lqPartial Aggregation\(rq, in the documentation\&. This requires specifying the
COMBINEFUNC
parameter\&. If the
\fIstate_data_type\fR
is
internal, it\*(Aqs usually also appropriate to provide the
SERIALFUNC
and
DESERIALFUNC
parameters so that parallel aggregation is possible\&. Note that the aggregate must also be marked
PARALLEL SAFE
to enable parallel aggregation\&.
.PP
Aggregates that behave like
\fBMIN\fR
or
\fBMAX\fR
can sometimes be optimized by looking into an index instead of scanning every input row\&. If this aggregate can be so optimized, indicate it by specifying a
sort operator\&. The basic requirement is that the aggregate must yield the first element in the sort ordering induced by the operator; in other words:
.sp
.if n \{\
.RS 4
.\}
.nf
SELECT agg(col) FROM tab;
.fi
.if n \{\
.RE
.\}
.sp
must be equivalent to:
.sp
.if n \{\
.RS 4
.\}
.nf
SELECT col FROM tab ORDER BY col USING sortop LIMIT 1;
.fi
.if n \{\
.RE
.\}
.sp
Further assumptions are that the aggregate ignores null inputs, and that it delivers a null result if and only if there were no non\-null inputs\&. Ordinarily, a data type\*(Aqs
<
operator is the proper sort operator for
\fBMIN\fR, and
>
is the proper sort operator for
\fBMAX\fR\&. Note that the optimization will never actually take effect unless the specified operator is the
\(lqless than\(rq
or
\(lqgreater than\(rq
strategy member of a B\-tree index operator class\&.
.PP
To be able to create an aggregate function, you must have
USAGE
privilege on the argument types, the state type(s), and the return type, as well as
EXECUTE
privilege on the supporting functions\&.
.SH "PARAMETERS"
.PP
\fIname\fR
.RS 4
The name (optionally schema\-qualified) of the aggregate function to create\&.
.RE
.PP
\fIargmode\fR
.RS 4
The mode of an argument:
IN
or
VARIADIC\&. (Aggregate functions do not support
OUT
arguments\&.) If omitted, the default is
IN\&. Only the last argument can be marked
VARIADIC\&.
.RE
.PP
\fIargname\fR
.RS 4
The name of an argument\&. This is currently only useful for documentation purposes\&. If omitted, the argument has no name\&.
.RE
.PP
\fIarg_data_type\fR
.RS 4
An input data type on which this aggregate function operates\&. To create a zero\-argument aggregate function, write
*
in place of the list of argument specifications\&. (An example of such an aggregate is
\fBcount(*)\fR\&.)
.RE
.PP
\fIbase_type\fR
.RS 4
In the old syntax for
\fBCREATE AGGREGATE\fR, the input data type is specified by a
basetype
parameter rather than being written next to the aggregate name\&. Note that this syntax allows only one input parameter\&. To define a zero\-argument aggregate function with this syntax, specify the
basetype
as
"ANY"
(not
*)\&. Ordered\-set aggregates cannot be defined with the old syntax\&.
.RE
.PP
\fIsfunc\fR
.RS 4
The name of the state transition function to be called for each input row\&. For a normal
\fIN\fR\-argument aggregate function, the
\fIsfunc\fR
must take
\fIN\fR+1 arguments, the first being of type
\fIstate_data_type\fR
and the rest matching the declared input data type(s) of the aggregate\&. The function must return a value of type
\fIstate_data_type\fR\&. This function takes the current state value and the current input data value(s), and returns the next state value\&.
.sp
For ordered\-set (including hypothetical\-set) aggregates, the state transition function receives only the current state value and the aggregated arguments, not the direct arguments\&. Otherwise it is the same\&.
.RE
.PP
\fIstate_data_type\fR
.RS 4
The data type for the aggregate\*(Aqs state value\&.
.RE
.PP
\fIstate_data_size\fR
.RS 4
The approximate average size (in bytes) of the aggregate\*(Aqs state value\&. If this parameter is omitted or is zero, a default estimate is used based on the
\fIstate_data_type\fR\&. The planner uses this value to estimate the memory required for a grouped aggregate query\&. The planner will consider using hash aggregation for such a query only if the hash table is estimated to fit in
work_mem; therefore, large values of this parameter discourage use of hash aggregation\&.
.RE
.PP
\fIffunc\fR
.RS 4
The name of the final function called to compute the aggregate\*(Aqs result after all input rows have been traversed\&. For a normal aggregate, this function must take a single argument of type
\fIstate_data_type\fR\&. The return data type of the aggregate is defined as the return type of this function\&. If
\fIffunc\fR
is not specified, then the ending state value is used as the aggregate\*(Aqs result, and the return type is
\fIstate_data_type\fR\&.
.sp
For ordered\-set (including hypothetical\-set) aggregates, the final function receives not only the final state value, but also the values of all the direct arguments\&.
.sp
If
FINALFUNC_EXTRA
is specified, then in addition to the final state value and any direct arguments, the final function receives extra NULL values corresponding to the aggregate\*(Aqs regular (aggregated) arguments\&. This is mainly useful to allow correct resolution of the aggregate result type when a polymorphic aggregate is being defined\&.
.RE
.PP
\fIcombinefunc\fR
.RS 4
The
\fIcombinefunc\fR
function may optionally be specified to allow the aggregate function to support partial aggregation\&. If provided, the
\fIcombinefunc\fR
must combine two
\fIstate_data_type\fR
values, each containing the result of aggregation over some subset of the input values, to produce a new
\fIstate_data_type\fR
that represents the result of aggregating over both sets of inputs\&. This function can be thought of as an
\fIsfunc\fR, where instead of acting upon an individual input row and adding it to the running aggregate state, it adds another aggregate state to the running state\&.
.sp
The
\fIcombinefunc\fR
must be declared as taking two arguments of the
\fIstate_data_type\fR
and returning a value of the
\fIstate_data_type\fR\&. Optionally this function may be
\(lqstrict\(rq\&. In this case the function will not be called when either of the input states are null; the other state will be taken as the correct result\&.
.sp
For aggregate functions whose
\fIstate_data_type\fR
is
internal, the
\fIcombinefunc\fR
must not be strict\&. In this case the
\fIcombinefunc\fR
must ensure that null states are handled correctly and that the state being returned is properly stored in the aggregate memory context\&.
.RE
.PP
\fIserialfunc\fR
.RS 4
An aggregate function whose
\fIstate_data_type\fR
is
internal
can participate in parallel aggregation only if it has a
\fIserialfunc\fR
function, which must serialize the aggregate state into a
bytea
value for transmission to another process\&. This function must take a single argument of type
internal
and return type
bytea\&. A corresponding
\fIdeserialfunc\fR
is also required\&.
.RE
.PP
\fIdeserialfunc\fR
.RS 4
Deserialize a previously serialized aggregate state back into
\fIstate_data_type\fR\&. This function must take two arguments of types
bytea
and
internal, and produce a result of type
internal\&. (Note: the second,
internal
argument is unused, but is required for type safety reasons\&.)
.RE
.PP
\fIinitial_condition\fR
.RS 4
The initial setting for the state value\&. This must be a string constant in the form accepted for the data type
\fIstate_data_type\fR\&. If not specified, the state value starts out null\&.
.RE
.PP
\fImsfunc\fR
.RS 4
The name of the forward state transition function to be called for each input row in moving\-aggregate mode\&. This is exactly like the regular transition function, except that its first argument and result are of type
\fImstate_data_type\fR, which might be different from
\fIstate_data_type\fR\&.
.RE
.PP
\fIminvfunc\fR
.RS 4
The name of the inverse state transition function to be used in moving\-aggregate mode\&. This function has the same argument and result types as
\fImsfunc\fR, but it is used to remove a value from the current aggregate state, rather than add a value to it\&. The inverse transition function must have the same strictness attribute as the forward state transition function\&.
.RE
.PP
\fImstate_data_type\fR
.RS 4
The data type for the aggregate\*(Aqs state value, when using moving\-aggregate mode\&.
.RE
.PP
\fImstate_data_size\fR
.RS 4
The approximate average size (in bytes) of the aggregate\*(Aqs state value, when using moving\-aggregate mode\&. This works the same as
\fIstate_data_size\fR\&.
.RE
.PP
\fImffunc\fR
.RS 4
The name of the final function called to compute the aggregate\*(Aqs result after all input rows have been traversed, when using moving\-aggregate mode\&. This works the same as
\fIffunc\fR, except that its first argument\*(Aqs type is
\fImstate_data_type\fR
and extra dummy arguments are specified by writing
MFINALFUNC_EXTRA\&. The aggregate result type determined by
\fImffunc\fR
or
\fImstate_data_type\fR
must match that determined by the aggregate\*(Aqs regular implementation\&.
.RE
.PP
\fIminitial_condition\fR
.RS 4
The initial setting for the state value, when using moving\-aggregate mode\&. This works the same as
\fIinitial_condition\fR\&.
.RE
.PP
\fIsort_operator\fR
.RS 4
The associated sort operator for a
\fBMIN\fR\- or
\fBMAX\fR\-like aggregate\&. This is just an operator name (possibly schema\-qualified)\&. The operator is assumed to have the same input data types as the aggregate (which must be a single\-argument normal aggregate)\&.
.RE
.PP
PARALLEL
.RS 4
The meanings of
PARALLEL SAFE,
PARALLEL RESTRICTED, and
PARALLEL UNSAFE
are the same as for
CREATE FUNCTION (\fBCREATE_FUNCTION\fR(7))\&. An aggregate will not be considered for parallelization if it is marked
PARALLEL UNSAFE
(which is the default!) or
PARALLEL RESTRICTED\&. Note that the parallel\-safety markings of the aggregate\*(Aqs support functions are not consulted by the planner, only the marking of the aggregate itself\&.
.RE
.PP
HYPOTHETICAL
.RS 4
For ordered\-set aggregates only, this flag specifies that the aggregate arguments are to be processed according to the requirements for hypothetical\-set aggregates: that is, the last few direct arguments must match the data types of the aggregated (WITHIN GROUP) arguments\&. The
HYPOTHETICAL
flag has no effect on run\-time behavior, only on parse\-time resolution of the data types and collations of the aggregate\*(Aqs arguments\&.
.RE
.PP
The parameters of
\fBCREATE AGGREGATE\fR
can be written in any order, not just the order illustrated above\&.
.SH "NOTES"
.PP
In parameters that specify support function names, you can write a schema name if needed, for example
SFUNC = public\&.sum\&. Do not write argument types there, however \(em the argument types of the support functions are determined from other parameters\&.
.PP
If an aggregate supports moving\-aggregate mode, it will improve calculation efficiency when the aggregate is used as a window function for a window with moving frame start (that is, a frame start mode other than
UNBOUNDED PRECEDING)\&. Conceptually, the forward transition function adds input values to the aggregate\*(Aqs state when they enter the window frame from the bottom, and the inverse transition function removes them again when they leave the frame at the top\&. So, when values are removed, they are always removed in the same order they were added\&. Whenever the inverse transition function is invoked, it will thus receive the earliest added but not yet removed argument value(s)\&. The inverse transition function can assume that at least one row will remain in the current state after it removes the oldest row\&. (When this would not be the case, the window function mechanism simply starts a fresh aggregation, rather than using the inverse transition function\&.)
.PP
The forward transition function for moving\-aggregate mode is not allowed to return NULL as the new state value\&. If the inverse transition function returns NULL, this is taken as an indication that the inverse function cannot reverse the state calculation for this particular input, and so the aggregate calculation will be redone from scratch for the current frame starting position\&. This convention allows moving\-aggregate mode to be used in situations where there are some infrequent cases that are impractical to reverse out of the running state value\&.
.PP
If no moving\-aggregate implementation is supplied, the aggregate can still be used with moving frames, but
PostgreSQL
will recompute the whole aggregation whenever the start of the frame moves\&. Note that whether or not the aggregate supports moving\-aggregate mode,
PostgreSQL
can handle a moving frame end without recalculation; this is done by continuing to add new values to the aggregate\*(Aqs state\&. It is assumed that the final function does not damage the aggregate\*(Aqs state value, so that the aggregation can be continued even after an aggregate result value has been obtained for one set of frame boundaries\&.
.PP
The syntax for ordered\-set aggregates allows
VARIADIC
to be specified for both the last direct parameter and the last aggregated (WITHIN GROUP) parameter\&. However, the current implementation restricts use of
VARIADIC
in two ways\&. First, ordered\-set aggregates can only use
VARIADIC "any", not other variadic array types\&. Second, if the last direct parameter is
VARIADIC "any", then there can be only one aggregated parameter and it must also be
VARIADIC "any"\&. (In the representation used in the system catalogs, these two parameters are merged into a single
VARIADIC "any"
item, since
pg_proc
cannot represent functions with more than one
VARIADIC
parameter\&.) If the aggregate is a hypothetical\-set aggregate, the direct arguments that match the
VARIADIC "any"
parameter are the hypothetical ones; any preceding parameters represent additional direct arguments that are not constrained to match the aggregated arguments\&.
.PP
Currently, ordered\-set aggregates do not need to support moving\-aggregate mode, since they cannot be used as window functions\&.
.PP
Partial (including parallel) aggregation is currently not supported for ordered\-set aggregates\&. Also, it will never be used for aggregate calls that include
DISTINCT
or
ORDER BY
clauses, since those semantics cannot be supported during partial aggregation\&.
.SH "EXAMPLES"
.PP
See
Section 36.10, \(lqUser-defined Aggregates\(rq, in the documentation\&.
.SH "COMPATIBILITY"
.PP
\fBCREATE AGGREGATE\fR
is a
PostgreSQL
language extension\&. The SQL standard does not provide for user\-defined aggregate functions\&.
.SH "SEE ALSO"
ALTER AGGREGATE (\fBALTER_AGGREGATE\fR(7)), DROP AGGREGATE (\fBDROP_AGGREGATE\fR(7))
man/man7/CREATE_MATERIALIZED_VIEW.7 0000644 00000010326 14751153421 0012005 0 ustar 00 '\" t
.\" Title: CREATE MATERIALIZED VIEW
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "CREATE MATERIALIZED VIEW" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
CREATE_MATERIALIZED_VIEW \- define a new materialized view
.SH "SYNOPSIS"
.sp
.nf
CREATE MATERIALIZED VIEW [ IF NOT EXISTS ] \fItable_name\fR
[ (\fIcolumn_name\fR [, \&.\&.\&.] ) ]
[ WITH ( \fIstorage_parameter\fR [= \fIvalue\fR] [, \&.\&.\&. ] ) ]
[ TABLESPACE \fItablespace_name\fR ]
AS \fIquery\fR
[ WITH [ NO ] DATA ]
.fi
.SH "DESCRIPTION"
.PP
\fBCREATE MATERIALIZED VIEW\fR
defines a materialized view of a query\&. The query is executed and used to populate the view at the time the command is issued (unless
\fBWITH NO DATA\fR
is used) and may be refreshed later using
\fBREFRESH MATERIALIZED VIEW\fR\&.
.PP
\fBCREATE MATERIALIZED VIEW\fR
is similar to
\fBCREATE TABLE AS\fR, except that it also remembers the query used to initialize the view, so that it can be refreshed later upon demand\&. A materialized view has many of the same properties as a table, but there is no support for temporary materialized views or automatic generation of OIDs\&.
.SH "PARAMETERS"
.PP
IF NOT EXISTS
.RS 4
Do not throw an error if a materialized view with the same name already exists\&. A notice is issued in this case\&. Note that there is no guarantee that the existing materialized view is anything like the one that would have been created\&.
.RE
.PP
\fItable_name\fR
.RS 4
The name (optionally schema\-qualified) of the materialized view to be created\&.
.RE
.PP
\fIcolumn_name\fR
.RS 4
The name of a column in the new materialized view\&. If column names are not provided, they are taken from the output column names of the query\&.
.RE
.PP
WITH ( \fIstorage_parameter\fR [= \fIvalue\fR] [, \&.\&.\&. ] )
.RS 4
This clause specifies optional storage parameters for the new materialized view; see
Storage Parameters
for more information\&. All parameters supported for
CREATE TABLE
are also supported for
CREATE MATERIALIZED VIEW
with the exception of
OIDS\&. See
CREATE TABLE (\fBCREATE_TABLE\fR(7))
for more information\&.
.RE
.PP
TABLESPACE \fItablespace_name\fR
.RS 4
The
\fItablespace_name\fR
is the name of the tablespace in which the new materialized view is to be created\&. If not specified,
default_tablespace
is consulted\&.
.RE
.PP
\fIquery\fR
.RS 4
A
\fBSELECT\fR(7),
TABLE, or
\fBVALUES\fR(7)
command\&. This query will run within a security\-restricted operation; in particular, calls to functions that themselves create temporary tables will fail\&.
.RE
.PP
WITH [ NO ] DATA
.RS 4
This clause specifies whether or not the materialized view should be populated at creation time\&. If not, the materialized view will be flagged as unscannable and cannot be queried until
\fBREFRESH MATERIALIZED VIEW\fR
is used\&.
.RE
.SH "COMPATIBILITY"
.PP
\fBCREATE MATERIALIZED VIEW\fR
is a
PostgreSQL
extension\&.
.SH "SEE ALSO"
ALTER MATERIALIZED VIEW (\fBALTER_MATERIALIZED_VIEW\fR(7)), CREATE TABLE AS (\fBCREATE_TABLE_AS\fR(7)), CREATE VIEW (\fBCREATE_VIEW\fR(7)), DROP MATERIALIZED VIEW (\fBDROP_MATERIALIZED_VIEW\fR(7)), REFRESH MATERIALIZED VIEW (\fBREFRESH_MATERIALIZED_VIEW\fR(7))
man/man7/DROP_USER.7 0000644 00000003233 14751153421 0007657 0 ustar 00 '\" t
.\" Title: DROP USER
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "DROP USER" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
DROP_USER \- remove a database role
.SH "SYNOPSIS"
.sp
.nf
DROP USER [ IF EXISTS ] \fIname\fR [, \&.\&.\&.]
.fi
.SH "DESCRIPTION"
.PP
\fBDROP USER\fR
is simply an alternate spelling of
DROP ROLE (\fBDROP_ROLE\fR(7))\&.
.SH "COMPATIBILITY"
.PP
The
\fBDROP USER\fR
statement is a
PostgreSQL
extension\&. The SQL standard leaves the definition of users to the implementation\&.
.SH "SEE ALSO"
DROP ROLE (\fBDROP_ROLE\fR(7))
man/man7/GRANT.7 0000644 00000053452 14751153421 0007140 0 ustar 00 '\" t
.\" Title: GRANT
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "GRANT" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
GRANT \- define access privileges
.SH "SYNOPSIS"
.sp
.nf
GRANT { { SELECT | INSERT | UPDATE | DELETE | TRUNCATE | REFERENCES | TRIGGER }
[, \&.\&.\&.] | ALL [ PRIVILEGES ] }
ON { [ TABLE ] \fItable_name\fR [, \&.\&.\&.]
| ALL TABLES IN SCHEMA \fIschema_name\fR [, \&.\&.\&.] }
TO \fIrole_specification\fR [, \&.\&.\&.] [ WITH GRANT OPTION ]
GRANT { { SELECT | INSERT | UPDATE | REFERENCES } ( \fIcolumn_name\fR [, \&.\&.\&.] )
[, \&.\&.\&.] | ALL [ PRIVILEGES ] ( \fIcolumn_name\fR [, \&.\&.\&.] ) }
ON [ TABLE ] \fItable_name\fR [, \&.\&.\&.]
TO \fIrole_specification\fR [, \&.\&.\&.] [ WITH GRANT OPTION ]
GRANT { { USAGE | SELECT | UPDATE }
[, \&.\&.\&.] | ALL [ PRIVILEGES ] }
ON { SEQUENCE \fIsequence_name\fR [, \&.\&.\&.]
| ALL SEQUENCES IN SCHEMA \fIschema_name\fR [, \&.\&.\&.] }
TO \fIrole_specification\fR [, \&.\&.\&.] [ WITH GRANT OPTION ]
GRANT { { CREATE | CONNECT | TEMPORARY | TEMP } [, \&.\&.\&.] | ALL [ PRIVILEGES ] }
ON DATABASE \fIdatabase_name\fR [, \&.\&.\&.]
TO \fIrole_specification\fR [, \&.\&.\&.] [ WITH GRANT OPTION ]
GRANT { USAGE | ALL [ PRIVILEGES ] }
ON DOMAIN \fIdomain_name\fR [, \&.\&.\&.]
TO \fIrole_specification\fR [, \&.\&.\&.] [ WITH GRANT OPTION ]
GRANT { USAGE | ALL [ PRIVILEGES ] }
ON FOREIGN DATA WRAPPER \fIfdw_name\fR [, \&.\&.\&.]
TO \fIrole_specification\fR [, \&.\&.\&.] [ WITH GRANT OPTION ]
GRANT { USAGE | ALL [ PRIVILEGES ] }
ON FOREIGN SERVER \fIserver_name\fR [, \&.\&.\&.]
TO \fIrole_specification\fR [, \&.\&.\&.] [ WITH GRANT OPTION ]
GRANT { EXECUTE | ALL [ PRIVILEGES ] }
ON { FUNCTION \fIfunction_name\fR ( [ [ \fIargmode\fR ] [ \fIarg_name\fR ] \fIarg_type\fR [, \&.\&.\&.] ] ) [, \&.\&.\&.]
| ALL FUNCTIONS IN SCHEMA \fIschema_name\fR [, \&.\&.\&.] }
TO \fIrole_specification\fR [, \&.\&.\&.] [ WITH GRANT OPTION ]
GRANT { USAGE | ALL [ PRIVILEGES ] }
ON LANGUAGE \fIlang_name\fR [, \&.\&.\&.]
TO \fIrole_specification\fR [, \&.\&.\&.] [ WITH GRANT OPTION ]
GRANT { { SELECT | UPDATE } [, \&.\&.\&.] | ALL [ PRIVILEGES ] }
ON LARGE OBJECT \fIloid\fR [, \&.\&.\&.]
TO \fIrole_specification\fR [, \&.\&.\&.] [ WITH GRANT OPTION ]
GRANT { { CREATE | USAGE } [, \&.\&.\&.] | ALL [ PRIVILEGES ] }
ON SCHEMA \fIschema_name\fR [, \&.\&.\&.]
TO \fIrole_specification\fR [, \&.\&.\&.] [ WITH GRANT OPTION ]
GRANT { CREATE | ALL [ PRIVILEGES ] }
ON TABLESPACE \fItablespace_name\fR [, \&.\&.\&.]
TO \fIrole_specification\fR [, \&.\&.\&.] [ WITH GRANT OPTION ]
GRANT { USAGE | ALL [ PRIVILEGES ] }
ON TYPE \fItype_name\fR [, \&.\&.\&.]
TO \fIrole_specification\fR [, \&.\&.\&.] [ WITH GRANT OPTION ]
GRANT \fIrole_name\fR [, \&.\&.\&.] TO \fIrole_specification\fR [, \&.\&.\&.]
[ WITH ADMIN OPTION ]
[ GRANTED BY \fIrole_specification\fR ]
where \fIrole_specification\fR can be:
[ GROUP ] \fIrole_name\fR
| PUBLIC
| CURRENT_USER
| SESSION_USER
.fi
.SH "DESCRIPTION"
.PP
The
\fBGRANT\fR
command has two basic variants: one that grants privileges on a database object (table, column, view, foreign table, sequence, database, foreign\-data wrapper, foreign server, function, procedural language, schema, or tablespace), and one that grants membership in a role\&. These variants are similar in many ways, but they are different enough to be described separately\&.
.SS "GRANT on Database Objects"
.PP
This variant of the
\fBGRANT\fR
command gives specific privileges on a database object to one or more roles\&. These privileges are added to those already granted, if any\&.
.PP
There is also an option to grant privileges on all objects of the same type within one or more schemas\&. This functionality is currently supported only for tables, sequences, and functions (but note that
ALL TABLES
is considered to include views and foreign tables)\&.
.PP
The key word
PUBLIC
indicates that the privileges are to be granted to all roles, including those that might be created later\&.
PUBLIC
can be thought of as an implicitly defined group that always includes all roles\&. Any particular role will have the sum of privileges granted directly to it, privileges granted to any role it is presently a member of, and privileges granted to
PUBLIC\&.
.PP
If
WITH GRANT OPTION
is specified, the recipient of the privilege can in turn grant it to others\&. Without a grant option, the recipient cannot do that\&. Grant options cannot be granted to
PUBLIC\&.
.PP
There is no need to grant privileges to the owner of an object (usually the user that created it), as the owner has all privileges by default\&. (The owner could, however, choose to revoke some of their own privileges for safety\&.)
.PP
The right to drop an object, or to alter its definition in any way, is not treated as a grantable privilege; it is inherent in the owner, and cannot be granted or revoked\&. (However, a similar effect can be obtained by granting or revoking membership in the role that owns the object; see below\&.) The owner implicitly has all grant options for the object, too\&.
.PP
PostgreSQL grants default privileges on some types of objects to
PUBLIC\&. No privileges are granted to
PUBLIC
by default on tables, table columns, sequences, foreign data wrappers, foreign servers, large objects, schemas, or tablespaces\&. For other types of objects, the default privileges granted to
PUBLIC
are as follows:
CONNECT
and
TEMPORARY
(create temporary tables) privileges for databases;
EXECUTE
privilege for functions; and
USAGE
privilege for languages and data types (including domains)\&. The object owner can, of course,
\fBREVOKE\fR
both default and expressly granted privileges\&. (For maximum security, issue the
\fBREVOKE\fR
in the same transaction that creates the object; then there is no window in which another user can use the object\&.) Also, these initial default privilege settings can be changed using the
ALTER DEFAULT PRIVILEGES (\fBALTER_DEFAULT_PRIVILEGES\fR(7))
command\&.
.PP
The possible privileges are:
.PP
SELECT
.RS 4
Allows
\fBSELECT\fR(7)
from any column, or the specific columns listed, of the specified table, view, or sequence\&. Also allows the use of
\fBCOPY\fR(7)
TO\&. This privilege is also needed to reference existing column values in
\fBUPDATE\fR(7)
or
\fBDELETE\fR(7)\&. For sequences, this privilege also allows the use of the
\fBcurrval\fR
function\&. For large objects, this privilege allows the object to be read\&.
.RE
.PP
INSERT
.RS 4
Allows
\fBINSERT\fR(7)
of a new row into the specified table\&. If specific columns are listed, only those columns may be assigned to in the
\fBINSERT\fR
command (other columns will therefore receive default values)\&. Also allows
\fBCOPY\fR(7)
FROM\&.
.RE
.PP
UPDATE
.RS 4
Allows
\fBUPDATE\fR(7)
of any column, or the specific columns listed, of the specified table\&. (In practice, any nontrivial
\fBUPDATE\fR
command will require
SELECT
privilege as well, since it must reference table columns to determine which rows to update, and/or to compute new values for columns\&.)
SELECT \&.\&.\&. FOR UPDATE
and
SELECT \&.\&.\&. FOR SHARE
also require this privilege on at least one column, in addition to the
SELECT
privilege\&. For sequences, this privilege allows the use of the
\fBnextval\fR
and
\fBsetval\fR
functions\&. For large objects, this privilege allows writing or truncating the object\&.
.RE
.PP
DELETE
.RS 4
Allows
\fBDELETE\fR(7)
of a row from the specified table\&. (In practice, any nontrivial
\fBDELETE\fR
command will require
SELECT
privilege as well, since it must reference table columns to determine which rows to delete\&.)
.RE
.PP
TRUNCATE
.RS 4
Allows
\fBTRUNCATE\fR(7)
on the specified table\&.
.RE
.PP
REFERENCES
.RS 4
To create a foreign key constraint, it is necessary to have this privilege on both the referencing and referenced columns\&. The privilege may be granted for all columns of a table, or just specific columns\&.
.RE
.PP
TRIGGER
.RS 4
Allows the creation of a trigger on the specified table\&. (See the
CREATE TRIGGER (\fBCREATE_TRIGGER\fR(7))
statement\&.)
.RE
.PP
CREATE
.RS 4
For databases, allows new schemas to be created within the database\&.
.sp
For schemas, allows new objects to be created within the schema\&. To rename an existing object, you must own the object
\fIand\fR
have this privilege for the containing schema\&.
.sp
For tablespaces, allows tables, indexes, and temporary files to be created within the tablespace, and allows databases to be created that have the tablespace as their default tablespace\&. (Note that revoking this privilege will not alter the placement of existing objects\&.)
.RE
.PP
CONNECT
.RS 4
Allows the user to connect to the specified database\&. This privilege is checked at connection startup (in addition to checking any restrictions imposed by
pg_hba\&.conf)\&.
.RE
.PP
TEMPORARY
.br
TEMP
.RS 4
Allows temporary tables to be created while using the specified database\&.
.RE
.PP
EXECUTE
.RS 4
Allows the use of the specified function and the use of any operators that are implemented on top of the function\&. This is the only type of privilege that is applicable to functions\&. (This syntax works for aggregate functions, as well\&.)
.RE
.PP
USAGE
.RS 4
For procedural languages, allows the use of the specified language for the creation of functions in that language\&. This is the only type of privilege that is applicable to procedural languages\&.
.sp
For schemas, allows access to objects contained in the specified schema (assuming that the objects\*(Aq own privilege requirements are also met)\&. Essentially this allows the grantee to
\(lqlook up\(rq
objects within the schema\&. Without this permission, it is still possible to see the object names, e\&.g\&., by querying the system tables\&. Also, after revoking this permission, existing backends might have statements that have previously performed this lookup, so this is not a completely secure way to prevent object access\&.
.sp
For sequences, this privilege allows the use of the
\fBcurrval\fR
and
\fBnextval\fR
functions\&.
.sp
For types and domains, this privilege allow the use of the type or domain in the creation of tables, functions, and other schema objects\&. (Note that it does not control general
\(lqusage\(rq
of the type, such as values of the type appearing in queries\&. It only prevents objects from being created that depend on the type\&. The main purpose of the privilege is controlling which users create dependencies on a type, which could prevent the owner from changing the type later\&.)
.sp
For foreign\-data wrappers, this privilege enables the grantee to create new servers using that foreign\-data wrapper\&.
.sp
For servers, this privilege enables the grantee to create foreign tables using the server, and also to create, alter, or drop their own user\*(Aqs user mappings associated with that server\&.
.RE
.PP
ALL PRIVILEGES
.RS 4
Grant all of the available privileges at once\&. The
PRIVILEGES
key word is optional in
PostgreSQL, though it is required by strict SQL\&.
.RE
The privileges required by other commands are listed on the reference page of the respective command\&.
.SS "GRANT on Roles"
.PP
This variant of the
\fBGRANT\fR
command grants membership in a role to one or more other roles\&. Membership in a role is significant because it conveys the privileges granted to a role to each of its members\&.
.PP
If
WITH ADMIN OPTION
is specified, the member can in turn grant membership in the role to others, and revoke membership in the role as well\&. Without the admin option, ordinary users cannot do that\&. A role is not considered to hold
WITH ADMIN OPTION
on itself, but it may grant or revoke membership in itself from a database session where the session user matches the role\&. Database superusers can grant or revoke membership in any role to anyone\&. Roles having
CREATEROLE
privilege can grant or revoke membership in any role that is not a superuser\&.
.PP
If
GRANTED BY
is specified, the grant is recorded as having been done by the specified role\&. Only database superusers may use this option, except when it names the same role executing the command\&.
.PP
Unlike the case with privileges, membership in a role cannot be granted to
PUBLIC\&. Note also that this form of the command does not allow the noise word
GROUP
in
\fIrole_specification\fR\&.
.SH "NOTES"
.PP
The
\fBREVOKE\fR(7)
command is used to revoke access privileges\&.
.PP
Since
PostgreSQL
8\&.1, the concepts of users and groups have been unified into a single kind of entity called a role\&. It is therefore no longer necessary to use the keyword
GROUP
to identify whether a grantee is a user or a group\&.
GROUP
is still allowed in the command, but it is a noise word\&.
.PP
A user may perform
\fBSELECT\fR,
\fBINSERT\fR, etc\&. on a column if they hold that privilege for either the specific column or its whole table\&. Granting the privilege at the table level and then revoking it for one column will not do what one might wish: the table\-level grant is unaffected by a column\-level operation\&.
.PP
When a non\-owner of an object attempts to
\fBGRANT\fR
privileges on the object, the command will fail outright if the user has no privileges whatsoever on the object\&. As long as some privilege is available, the command will proceed, but it will grant only those privileges for which the user has grant options\&. The
\fBGRANT ALL PRIVILEGES\fR
forms will issue a warning message if no grant options are held, while the other forms will issue a warning if grant options for any of the privileges specifically named in the command are not held\&. (In principle these statements apply to the object owner as well, but since the owner is always treated as holding all grant options, the cases can never occur\&.)
.PP
It should be noted that database superusers can access all objects regardless of object privilege settings\&. This is comparable to the rights of
root
in a Unix system\&. As with
root, it\*(Aqs unwise to operate as a superuser except when absolutely necessary\&.
.PP
If a superuser chooses to issue a
\fBGRANT\fR
or
\fBREVOKE\fR
command, the command is performed as though it were issued by the owner of the affected object\&. In particular, privileges granted via such a command will appear to have been granted by the object owner\&. (For role membership, the membership appears to have been granted by the containing role itself\&.)
.PP
\fBGRANT\fR
and
\fBREVOKE\fR
can also be done by a role that is not the owner of the affected object, but is a member of the role that owns the object, or is a member of a role that holds privileges
WITH GRANT OPTION
on the object\&. In this case the privileges will be recorded as having been granted by the role that actually owns the object or holds the privileges
WITH GRANT OPTION\&. For example, if table
t1
is owned by role
g1, of which role
u1
is a member, then
u1
can grant privileges on
t1
to
u2, but those privileges will appear to have been granted directly by
g1\&. Any other member of role
g1
could revoke them later\&.
.PP
If the role executing
\fBGRANT\fR
holds the required privileges indirectly via more than one role membership path, it is unspecified which containing role will be recorded as having done the grant\&. In such cases it is best practice to use
\fBSET ROLE\fR
to become the specific role you want to do the
\fBGRANT\fR
as\&.
.PP
Granting permission on a table does not automatically extend permissions to any sequences used by the table, including sequences tied to
SERIAL
columns\&. Permissions on sequences must be set separately\&.
.PP
Use
\fBpsql\fR(1)\*(Aqs
\fB\edp\fR
command to obtain information about existing privileges for tables and columns\&. For example:
.sp
.if n \{\
.RS 4
.\}
.nf
=> \edp mytable
Access privileges
Schema | Name | Type | Access privileges | Column access privileges
\-\-\-\-\-\-\-\-+\-\-\-\-\-\-\-\-\-+\-\-\-\-\-\-\-+\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
public | mytable | table | miriam=arwdDxt/miriam | col1:
: =r/miriam : miriam_rw=rw/miriam
: admin=arw/miriam
(1 row)
.fi
.if n \{\
.RE
.\}
.sp
The entries shown by
\fB\edp\fR
are interpreted thus:
.sp
.if n \{\
.RS 4
.\}
.nf
rolename=xxxx \-\- privileges granted to a role
=xxxx \-\- privileges granted to PUBLIC
r \-\- SELECT ("read")
w \-\- UPDATE ("write")
a \-\- INSERT ("append")
d \-\- DELETE
D \-\- TRUNCATE
x \-\- REFERENCES
t \-\- TRIGGER
X \-\- EXECUTE
U \-\- USAGE
C \-\- CREATE
c \-\- CONNECT
T \-\- TEMPORARY
arwdDxt \-\- ALL PRIVILEGES (for tables, varies for other objects)
* \-\- grant option for preceding privilege
/yyyy \-\- role that granted this privilege
.fi
.if n \{\
.RE
.\}
.sp
The above example display would be seen by user
miriam
after creating table
mytable
and doing:
.sp
.if n \{\
.RS 4
.\}
.nf
GRANT SELECT ON mytable TO PUBLIC;
GRANT SELECT, UPDATE, INSERT ON mytable TO admin;
GRANT SELECT (col1), UPDATE (col1) ON mytable TO miriam_rw;
.fi
.if n \{\
.RE
.\}
.PP
For non\-table objects there are other
\fB\ed\fR
commands that can display their privileges\&.
.PP
If the
\(lqAccess privileges\(rq
column is empty for a given object, it means the object has default privileges (that is, its privileges column is null)\&. Default privileges always include all privileges for the owner, and can include some privileges for
PUBLIC
depending on the object type, as explained above\&. The first
\fBGRANT\fR
or
\fBREVOKE\fR
on an object will instantiate the default privileges (producing, for example,
{miriam=arwdDxt/miriam}) and then modify them per the specified request\&. Similarly, entries are shown in
\(lqColumn access privileges\(rq
only for columns with nondefault privileges\&. (Note: for this purpose,
\(lqdefault privileges\(rq
always means the built\-in default privileges for the object\*(Aqs type\&. An object whose privileges have been affected by an
\fBALTER DEFAULT PRIVILEGES\fR
command will always be shown with an explicit privilege entry that includes the effects of the
\fBALTER\fR\&.)
.PP
Notice that the owner\*(Aqs implicit grant options are not marked in the access privileges display\&. A
*
will appear only when grant options have been explicitly granted to someone\&.
.SH "EXAMPLES"
.PP
Grant insert privilege to all users on table
films:
.sp
.if n \{\
.RS 4
.\}
.nf
GRANT INSERT ON films TO PUBLIC;
.fi
.if n \{\
.RE
.\}
.PP
Grant all available privileges to user
manuel
on view
kinds:
.sp
.if n \{\
.RS 4
.\}
.nf
GRANT ALL PRIVILEGES ON kinds TO manuel;
.fi
.if n \{\
.RE
.\}
.sp
Note that while the above will indeed grant all privileges if executed by a superuser or the owner of
kinds, when executed by someone else it will only grant those permissions for which the someone else has grant options\&.
.PP
Grant membership in role
admins
to user
joe:
.sp
.if n \{\
.RS 4
.\}
.nf
GRANT admins TO joe;
.fi
.if n \{\
.RE
.\}
.SH "COMPATIBILITY"
.PP
According to the SQL standard, the
PRIVILEGES
key word in
ALL PRIVILEGES
is required\&. The SQL standard does not support setting the privileges on more than one object per command\&.
.PP
PostgreSQL
allows an object owner to revoke their own ordinary privileges: for example, a table owner can make the table read\-only to themselves by revoking their own
INSERT,
UPDATE,
DELETE, and
TRUNCATE
privileges\&. This is not possible according to the SQL standard\&. The reason is that
PostgreSQL
treats the owner\*(Aqs privileges as having been granted by the owner to themselves; therefore they can revoke them too\&. In the SQL standard, the owner\*(Aqs privileges are granted by an assumed entity
\(lq_SYSTEM\(rq\&. Not being
\(lq_SYSTEM\(rq, the owner cannot revoke these rights\&.
.PP
According to the SQL standard, grant options can be granted to
PUBLIC; PostgreSQL only supports granting grant options to roles\&.
.PP
The SQL standard allows the
GRANTED BY
option to be used in all forms of
\fBGRANT\fR\&. PostgreSQL only supports it when granting role membership, and even then only superusers may use it in nontrivial ways\&.
.PP
The SQL standard provides for a
USAGE
privilege on other kinds of objects: character sets, collations, translations\&.
.PP
In the SQL standard, sequences only have a
USAGE
privilege, which controls the use of the
NEXT VALUE FOR
expression, which is equivalent to the function
\fBnextval\fR
in PostgreSQL\&. The sequence privileges
SELECT
and
UPDATE
are PostgreSQL extensions\&. The application of the sequence
USAGE
privilege to the
currval
function is also a PostgreSQL extension (as is the function itself)\&.
.PP
Privileges on databases, tablespaces, schemas, and languages are
PostgreSQL
extensions\&.
.SH "SEE ALSO"
\fBREVOKE\fR(7), ALTER DEFAULT PRIVILEGES (\fBALTER_DEFAULT_PRIVILEGES\fR(7))
man/man7/DROP_DOMAIN.7 0000644 00000004536 14751153421 0010057 0 ustar 00 '\" t
.\" Title: DROP DOMAIN
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "DROP DOMAIN" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
DROP_DOMAIN \- remove a domain
.SH "SYNOPSIS"
.sp
.nf
DROP DOMAIN [ IF EXISTS ] \fIname\fR [, \&.\&.\&.] [ CASCADE | RESTRICT ]
.fi
.SH "DESCRIPTION"
.PP
\fBDROP DOMAIN\fR
removes a domain\&. Only the owner of a domain can remove it\&.
.SH "PARAMETERS"
.PP
IF EXISTS
.RS 4
Do not throw an error if the domain does not exist\&. A notice is issued in this case\&.
.RE
.PP
\fIname\fR
.RS 4
The name (optionally schema\-qualified) of an existing domain\&.
.RE
.PP
CASCADE
.RS 4
Automatically drop objects that depend on the domain (such as table columns), and in turn all objects that depend on those objects (see
Section 5.13, \(lqDependency Tracking\(rq, in the documentation)\&.
.RE
.PP
RESTRICT
.RS 4
Refuse to drop the domain if any objects depend on it\&. This is the default\&.
.RE
.SH "EXAMPLES"
.PP
To remove the domain
box:
.sp
.if n \{\
.RS 4
.\}
.nf
DROP DOMAIN box;
.fi
.if n \{\
.RE
.\}
.SH "COMPATIBILITY"
.PP
This command conforms to the SQL standard, except for the
IF EXISTS
option, which is a
PostgreSQL
extension\&.
.SH "SEE ALSO"
CREATE DOMAIN (\fBCREATE_DOMAIN\fR(7)), ALTER DOMAIN (\fBALTER_DOMAIN\fR(7))
man/man7/LISTEN.7 0000644 00000007014 14751153421 0007254 0 ustar 00 '\" t
.\" Title: LISTEN
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "LISTEN" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
LISTEN \- listen for a notification
.SH "SYNOPSIS"
.sp
.nf
LISTEN \fIchannel\fR
.fi
.SH "DESCRIPTION"
.PP
\fBLISTEN\fR
registers the current session as a listener on the notification channel named
\fIchannel\fR\&. If the current session is already registered as a listener for this notification channel, nothing is done\&.
.PP
Whenever the command
\fBNOTIFY \fR\fB\fIchannel\fR\fR
is invoked, either by this session or another one connected to the same database, all the sessions currently listening on that notification channel are notified, and each will in turn notify its connected client application\&.
.PP
A session can be unregistered for a given notification channel with the
\fBUNLISTEN\fR
command\&. A session\*(Aqs listen registrations are automatically cleared when the session ends\&.
.PP
The method a client application must use to detect notification events depends on which
PostgreSQL
application programming interface it uses\&. With the
libpq
library, the application issues
\fBLISTEN\fR
as an ordinary SQL command, and then must periodically call the function
\fBPQnotifies\fR
to find out whether any notification events have been received\&. Other interfaces such as
libpgtcl
provide higher\-level methods for handling notify events; indeed, with
libpgtcl
the application programmer should not even issue
\fBLISTEN\fR
or
\fBUNLISTEN\fR
directly\&. See the documentation for the interface you are using for more details\&.
.PP
\fBNOTIFY\fR(7)
contains a more extensive discussion of the use of
\fBLISTEN\fR
and
\fBNOTIFY\fR\&.
.SH "PARAMETERS"
.PP
\fIchannel\fR
.RS 4
Name of a notification channel (any identifier)\&.
.RE
.SH "NOTES"
.PP
\fBLISTEN\fR
takes effect at transaction commit\&. If
\fBLISTEN\fR
or
\fBUNLISTEN\fR
is executed within a transaction that later rolls back, the set of notification channels being listened to is unchanged\&.
.PP
A transaction that has executed
\fBLISTEN\fR
cannot be prepared for two\-phase commit\&.
.SH "EXAMPLES"
.PP
Configure and execute a listen/notify sequence from
psql:
.sp
.if n \{\
.RS 4
.\}
.nf
LISTEN virtual;
NOTIFY virtual;
Asynchronous notification "virtual" received from server process with PID 8448\&.
.fi
.if n \{\
.RE
.\}
.SH "COMPATIBILITY"
.PP
There is no
\fBLISTEN\fR
statement in the SQL standard\&.
.SH "SEE ALSO"
\fBNOTIFY\fR(7), \fBUNLISTEN\fR(7)
man/man7/ANALYZE.7 0000644 00000020122 14751153421 0007354 0 ustar 00 '\" t
.\" Title: ANALYZE
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "ANALYZE" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
ANALYZE \- collect statistics about a database
.SH "SYNOPSIS"
.sp
.nf
ANALYZE [ VERBOSE ] [ \fItable_name\fR [ ( \fIcolumn_name\fR [, \&.\&.\&.] ) ] ]
.fi
.SH "DESCRIPTION"
.PP
\fBANALYZE\fR
collects statistics about the contents of tables in the database, and stores the results in the
pg_statistic
system catalog\&. Subsequently, the query planner uses these statistics to help determine the most efficient execution plans for queries\&.
.PP
With no parameter,
\fBANALYZE\fR
examines every table in the current database\&. With a parameter,
\fBANALYZE\fR
examines only that table\&. It is further possible to give a list of column names, in which case only the statistics for those columns are collected\&.
.SH "PARAMETERS"
.PP
VERBOSE
.RS 4
Enables display of progress messages\&.
.RE
.PP
\fItable_name\fR
.RS 4
The name (possibly schema\-qualified) of a specific table to analyze\&. If omitted, all regular tables (but not foreign tables) in the current database are analyzed\&.
.RE
.PP
\fIcolumn_name\fR
.RS 4
The name of a specific column to analyze\&. Defaults to all columns\&.
.RE
.SH "OUTPUTS"
.PP
When
VERBOSE
is specified,
\fBANALYZE\fR
emits progress messages to indicate which table is currently being processed\&. Various statistics about the tables are printed as well\&.
.SH "NOTES"
.PP
To analyze a table, one must ordinarily be the table\*(Aqs owner or a superuser\&. However, database owners are allowed to analyze all tables in their databases, except shared catalogs\&. (The restriction for shared catalogs means that a true database\-wide
\fBANALYZE\fR
can only be performed by a superuser\&.)
\fBANALYZE\fR
will skip over any tables that the calling user does not have permission to analyze\&.
.PP
Foreign tables are analyzed only when explicitly selected\&. Not all foreign data wrappers support
\fBANALYZE\fR\&. If the table\*(Aqs wrapper does not support
\fBANALYZE\fR, the command prints a warning and does nothing\&.
.PP
In the default
PostgreSQL
configuration, the autovacuum daemon (see
Section 24.1.6, \(lqThe Autovacuum Daemon\(rq, in the documentation) takes care of automatic analyzing of tables when they are first loaded with data, and as they change throughout regular operation\&. When autovacuum is disabled, it is a good idea to run
\fBANALYZE\fR
periodically, or just after making major changes in the contents of a table\&. Accurate statistics will help the planner to choose the most appropriate query plan, and thereby improve the speed of query processing\&. A common strategy for read\-mostly databases is to run
\fBVACUUM\fR(7)
and
\fBANALYZE\fR
once a day during a low\-usage time of day\&. (This will not be sufficient if there is heavy update activity\&.)
.PP
\fBANALYZE\fR
requires only a read lock on the target table, so it can run in parallel with other activity on the table\&.
.PP
The statistics collected by
\fBANALYZE\fR
usually include a list of some of the most common values in each column and a histogram showing the approximate data distribution in each column\&. One or both of these can be omitted if
\fBANALYZE\fR
deems them uninteresting (for example, in a unique\-key column, there are no common values) or if the column data type does not support the appropriate operators\&. There is more information about the statistics in
Chapter 24, Routine Database Maintenance Tasks, in the documentation\&.
.PP
For large tables,
\fBANALYZE\fR
takes a random sample of the table contents, rather than examining every row\&. This allows even very large tables to be analyzed in a small amount of time\&. Note, however, that the statistics are only approximate, and will change slightly each time
\fBANALYZE\fR
is run, even if the actual table contents did not change\&. This might result in small changes in the planner\*(Aqs estimated costs shown by
\fBEXPLAIN\fR(7)\&. In rare situations, this non\-determinism will cause the planner\*(Aqs choices of query plans to change after
\fBANALYZE\fR
is run\&. To avoid this, raise the amount of statistics collected by
\fBANALYZE\fR, as described below\&.
.PP
The extent of analysis can be controlled by adjusting the
default_statistics_target
configuration variable, or on a column\-by\-column basis by setting the per\-column statistics target with
\fBALTER TABLE \&.\&.\&. ALTER COLUMN \&.\&.\&. SET STATISTICS\fR
(see
ALTER TABLE (\fBALTER_TABLE\fR(7)))\&. The target value sets the maximum number of entries in the most\-common\-value list and the maximum number of bins in the histogram\&. The default target value is 100, but this can be adjusted up or down to trade off accuracy of planner estimates against the time taken for
\fBANALYZE\fR
and the amount of space occupied in
pg_statistic\&. In particular, setting the statistics target to zero disables collection of statistics for that column\&. It might be useful to do that for columns that are never used as part of the
WHERE,
GROUP BY, or
ORDER BY
clauses of queries, since the planner will have no use for statistics on such columns\&.
.PP
The largest statistics target among the columns being analyzed determines the number of table rows sampled to prepare the statistics\&. Increasing the target causes a proportional increase in the time and space needed to do
\fBANALYZE\fR\&.
.PP
One of the values estimated by
\fBANALYZE\fR
is the number of distinct values that appear in each column\&. Because only a subset of the rows are examined, this estimate can sometimes be quite inaccurate, even with the largest possible statistics target\&. If this inaccuracy leads to bad query plans, a more accurate value can be determined manually and then installed with
\fBALTER TABLE \&.\&.\&. ALTER COLUMN \&.\&.\&. SET (n_distinct = \&.\&.\&.)\fR
(see
ALTER TABLE (\fBALTER_TABLE\fR(7)))\&.
.PP
If the table being analyzed has one or more children,
\fBANALYZE\fR
will gather statistics twice: once on the rows of the parent table only, and a second time on the rows of the parent table with all of its children\&. This second set of statistics is needed when planning queries that traverse the entire inheritance tree\&. The autovacuum daemon, however, will only consider inserts or updates on the parent table itself when deciding whether to trigger an automatic analyze for that table\&. If that table is rarely inserted into or updated, the inheritance statistics will not be up to date unless you run
\fBANALYZE\fR
manually\&.
.PP
If any of the child tables are foreign tables whose foreign data wrappers do not support
\fBANALYZE\fR, those child tables are ignored while gathering inheritance statistics\&.
.PP
If the table being analyzed is completely empty,
\fBANALYZE\fR
will not record new statistics for that table\&. Any existing statistics will be retained\&.
.SH "COMPATIBILITY"
.PP
There is no
\fBANALYZE\fR
statement in the SQL standard\&.
.SH "SEE ALSO"
\fBVACUUM\fR(7), \fBvacuumdb\fR(1), Section 19.4.4, \(lqCost-based Vacuum Delay\(rq, in the documentation, Section 24.1.6, \(lqThe Autovacuum Daemon\(rq, in the documentation
man/man7/CLOSE.7 0000644 00000005341 14751153421 0007124 0 ustar 00 '\" t
.\" Title: CLOSE
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "CLOSE" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
CLOSE \- close a cursor
.SH "SYNOPSIS"
.sp
.nf
CLOSE { \fIname\fR | ALL }
.fi
.SH "DESCRIPTION"
.PP
\fBCLOSE\fR
frees the resources associated with an open cursor\&. After the cursor is closed, no subsequent operations are allowed on it\&. A cursor should be closed when it is no longer needed\&.
.PP
Every non\-holdable open cursor is implicitly closed when a transaction is terminated by
\fBCOMMIT\fR
or
\fBROLLBACK\fR\&. A holdable cursor is implicitly closed if the transaction that created it aborts via
\fBROLLBACK\fR\&. If the creating transaction successfully commits, the holdable cursor remains open until an explicit
\fBCLOSE\fR
is executed, or the client disconnects\&.
.SH "PARAMETERS"
.PP
\fIname\fR
.RS 4
The name of an open cursor to close\&.
.RE
.PP
ALL
.RS 4
Close all open cursors\&.
.RE
.SH "NOTES"
.PP
PostgreSQL
does not have an explicit
\fBOPEN\fR
cursor statement; a cursor is considered open when it is declared\&. Use the
\fBDECLARE\fR(7)
statement to declare a cursor\&.
.PP
You can see all available cursors by querying the
pg_cursors
system view\&.
.PP
If a cursor is closed after a savepoint which is later rolled back, the
\fBCLOSE\fR
is not rolled back; that is, the cursor remains closed\&.
.SH "EXAMPLES"
.PP
Close the cursor
liahona:
.sp
.if n \{\
.RS 4
.\}
.nf
CLOSE liahona;
.fi
.if n \{\
.RE
.\}
.SH "COMPATIBILITY"
.PP
\fBCLOSE\fR
is fully conforming with the SQL standard\&.
\fBCLOSE ALL\fR
is a
PostgreSQL
extension\&.
.SH "SEE ALSO"
\fBDECLARE\fR(7), \fBFETCH\fR(7), \fBMOVE\fR(7)
man/man7/DROP_TABLE.7 0000644 00000005741 14751153421 0007736 0 ustar 00 '\" t
.\" Title: DROP TABLE
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "DROP TABLE" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
DROP_TABLE \- remove a table
.SH "SYNOPSIS"
.sp
.nf
DROP TABLE [ IF EXISTS ] \fIname\fR [, \&.\&.\&.] [ CASCADE | RESTRICT ]
.fi
.SH "DESCRIPTION"
.PP
\fBDROP TABLE\fR
removes tables from the database\&. Only the table owner, the schema owner, and superuser can drop a table\&. To empty a table of rows without destroying the table, use
\fBDELETE\fR(7)
or
\fBTRUNCATE\fR(7)\&.
.PP
\fBDROP TABLE\fR
always removes any indexes, rules, triggers, and constraints that exist for the target table\&. However, to drop a table that is referenced by a view or a foreign\-key constraint of another table,
CASCADE
must be specified\&. (CASCADE
will remove a dependent view entirely, but in the foreign\-key case it will only remove the foreign\-key constraint, not the other table entirely\&.)
.SH "PARAMETERS"
.PP
IF EXISTS
.RS 4
Do not throw an error if the table does not exist\&. A notice is issued in this case\&.
.RE
.PP
\fIname\fR
.RS 4
The name (optionally schema\-qualified) of the table to drop\&.
.RE
.PP
CASCADE
.RS 4
Automatically drop objects that depend on the table (such as views), and in turn all objects that depend on those objects (see
Section 5.13, \(lqDependency Tracking\(rq, in the documentation)\&.
.RE
.PP
RESTRICT
.RS 4
Refuse to drop the table if any objects depend on it\&. This is the default\&.
.RE
.SH "EXAMPLES"
.PP
To destroy two tables,
films
and
distributors:
.sp
.if n \{\
.RS 4
.\}
.nf
DROP TABLE films, distributors;
.fi
.if n \{\
.RE
.\}
.SH "COMPATIBILITY"
.PP
This command conforms to the SQL standard, except that the standard only allows one table to be dropped per command, and apart from the
IF EXISTS
option, which is a
PostgreSQL
extension\&.
.SH "SEE ALSO"
ALTER TABLE (\fBALTER_TABLE\fR(7)), CREATE TABLE (\fBCREATE_TABLE\fR(7))
man/man7/RESET.7 0000644 00000005675 14751153421 0007153 0 ustar 00 '\" t
.\" Title: RESET
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "RESET" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
RESET \- restore the value of a run\-time parameter to the default value
.SH "SYNOPSIS"
.sp
.nf
RESET \fIconfiguration_parameter\fR
RESET ALL
.fi
.SH "DESCRIPTION"
.PP
\fBRESET\fR
restores run\-time parameters to their default values\&.
\fBRESET\fR
is an alternative spelling for
.sp
.if n \{\
.RS 4
.\}
.nf
SET \fIconfiguration_parameter\fR TO DEFAULT
.fi
.if n \{\
.RE
.\}
.sp
Refer to
\fBSET\fR(7)
for details\&.
.PP
The default value is defined as the value that the parameter would have had, if no
\fBSET\fR
had ever been issued for it in the current session\&. The actual source of this value might be a compiled\-in default, the configuration file, command\-line options, or per\-database or per\-user default settings\&. This is subtly different from defining it as
\(lqthe value that the parameter had at session start\(rq, because if the value came from the configuration file, it will be reset to whatever is specified by the configuration file now\&. See
Chapter 19, Server Configuration, in the documentation
for details\&.
.PP
The transactional behavior of
\fBRESET\fR
is the same as
\fBSET\fR: its effects will be undone by transaction rollback\&.
.SH "PARAMETERS"
.PP
\fIconfiguration_parameter\fR
.RS 4
Name of a settable run\-time parameter\&. Available parameters are documented in
Chapter 19, Server Configuration, in the documentation
and on the
\fBSET\fR(7)
reference page\&.
.RE
.PP
ALL
.RS 4
Resets all settable run\-time parameters to default values\&.
.RE
.SH "EXAMPLES"
.PP
Set the
\fItimezone\fR
configuration variable to its default value:
.sp
.if n \{\
.RS 4
.\}
.nf
RESET timezone;
.fi
.if n \{\
.RE
.\}
.SH "COMPATIBILITY"
.PP
\fBRESET\fR
is a
PostgreSQL
extension\&.
.SH "SEE ALSO"
\fBSET\fR(7), \fBSHOW\fR(7)
man/man7/SHOW.7 0000644 00000010346 14751153421 0007040 0 ustar 00 '\" t
.\" Title: SHOW
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "SHOW" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
SHOW \- show the value of a run\-time parameter
.SH "SYNOPSIS"
.sp
.nf
SHOW \fIname\fR
SHOW ALL
.fi
.SH "DESCRIPTION"
.PP
\fBSHOW\fR
will display the current setting of run\-time parameters\&. These variables can be set using the
\fBSET\fR
statement, by editing the
postgresql\&.conf
configuration file, through the
\fBPGOPTIONS\fR
environmental variable (when using
libpq
or a
libpq\-based application), or through command\-line flags when starting the
\fBpostgres\fR
server\&. See
Chapter 19, Server Configuration, in the documentation
for details\&.
.SH "PARAMETERS"
.PP
\fIname\fR
.RS 4
The name of a run\-time parameter\&. Available parameters are documented in
Chapter 19, Server Configuration, in the documentation
and on the
\fBSET\fR(7)
reference page\&. In addition, there are a few parameters that can be shown but not set:
.PP
SERVER_VERSION
.RS 4
Shows the server\*(Aqs version number\&.
.RE
.PP
SERVER_ENCODING
.RS 4
Shows the server\-side character set encoding\&. At present, this parameter can be shown but not set, because the encoding is determined at database creation time\&.
.RE
.PP
LC_COLLATE
.RS 4
Shows the database\*(Aqs locale setting for collation (text ordering)\&. At present, this parameter can be shown but not set, because the setting is determined at database creation time\&.
.RE
.PP
LC_CTYPE
.RS 4
Shows the database\*(Aqs locale setting for character classification\&. At present, this parameter can be shown but not set, because the setting is determined at database creation time\&.
.RE
.PP
IS_SUPERUSER
.RS 4
True if the current role has superuser privileges\&.
.RE
.RE
.PP
ALL
.RS 4
Show the values of all configuration parameters, with descriptions\&.
.RE
.SH "NOTES"
.PP
The function
\fBcurrent_setting\fR
produces equivalent output; see
Section 9.26, \(lqSystem Administration Functions\(rq, in the documentation\&. Also, the
pg_settings
system view produces the same information\&.
.SH "EXAMPLES"
.PP
Show the current setting of the parameter
\fIDateStyle\fR:
.sp
.if n \{\
.RS 4
.\}
.nf
SHOW DateStyle;
DateStyle
\-\-\-\-\-\-\-\-\-\-\-
ISO, MDY
(1 row)
.fi
.if n \{\
.RE
.\}
.PP
Show the current setting of the parameter
\fIgeqo\fR:
.sp
.if n \{\
.RS 4
.\}
.nf
SHOW geqo;
geqo
\-\-\-\-\-\-
on
(1 row)
.fi
.if n \{\
.RE
.\}
.PP
Show all settings:
.sp
.if n \{\
.RS 4
.\}
.nf
SHOW ALL;
name | setting | description
\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+\-\-\-\-\-\-\-\-\-+\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
allow_system_table_mods | off | Allows modifications of the structure of \&.\&.\&.
\&.
\&.
\&.
xmloption | content | Sets whether XML data in implicit parsing \&.\&.\&.
zero_damaged_pages | off | Continues processing past damaged page headers\&.
(196 rows)
.fi
.if n \{\
.RE
.\}
.SH "COMPATIBILITY"
.PP
The
\fBSHOW\fR
command is a
PostgreSQL
extension\&.
.SH "SEE ALSO"
\fBSET\fR(7), \fBRESET\fR(7)
man/man7/CREATE_POLICY.7 0000644 00000037656 14751153421 0010317 0 ustar 00 '\" t
.\" Title: CREATE POLICY
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "CREATE POLICY" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
CREATE_POLICY \- define a new row level security policy for a table
.SH "SYNOPSIS"
.sp
.nf
CREATE POLICY \fIname\fR ON \fItable_name\fR
[ FOR { ALL | SELECT | INSERT | UPDATE | DELETE } ]
[ TO { \fIrole_name\fR | PUBLIC | CURRENT_USER | SESSION_USER } [, \&.\&.\&.] ]
[ USING ( \fIusing_expression\fR ) ]
[ WITH CHECK ( \fIcheck_expression\fR ) ]
.fi
.SH "DESCRIPTION"
.PP
The
\fBCREATE POLICY\fR
command defines a new row\-level security policy for a table\&. Note that row\-level security must be enabled on the table (using
\fBALTER TABLE \&.\&.\&. ENABLE ROW LEVEL SECURITY\fR) in order for created policies to be applied\&.
.PP
A policy grants the permission to select, insert, update, or delete rows that match the relevant policy expression\&. Existing table rows are checked against the expression specified in
USING, while new rows that would be created via
INSERT
or
UPDATE
are checked against the expression specified in
WITH CHECK\&. When a
USING
expression returns true for a given row then that row is visible to the user, while if false or null is returned then the row is not visible\&. When a
WITH CHECK
expression returns true for a row then that row is inserted or updated, while if false or null is returned then an error occurs\&.
.PP
For
\fBINSERT\fR
and
\fBUPDATE\fR
statements,
WITH CHECK
expressions are enforced after
BEFORE
triggers are fired, and before any actual data modifications are made\&. Thus a
BEFORE ROW
trigger may modify the data to be inserted, affecting the result of the security policy check\&.
WITH CHECK
expressions are enforced before any other constraints\&.
.PP
Policy names are per\-table\&. Therefore, one policy name can be used for many different tables and have a definition for each table which is appropriate to that table\&.
.PP
Policies can be applied for specific commands or for specific roles\&. The default for newly created policies is that they apply for all commands and roles, unless otherwise specified\&. Multiple policies may apply to a single command; see below for more details\&.
Table\ \&238, \(lqPolicies Applied by Command Type\(rq
summarizes how the different types of policy apply to specific commands\&.
.PP
For policies that can have both
USING
and
WITH CHECK
expressions (ALL
and
UPDATE), if no
WITH CHECK
expression is defined, then the
USING
expression will be used both to determine which rows are visible (normal
USING
case) and which new rows will be allowed to be added (WITH CHECK
case)\&.
.PP
If row\-level security is enabled for a table, but no applicable policies exist, a
\(lqdefault deny\(rq
policy is assumed, so that no rows will be visible or updatable\&.
.SH "PARAMETERS"
.PP
\fIname\fR
.RS 4
The name of the policy to be created\&. This must be distinct from the name of any other policy for the table\&.
.RE
.PP
\fItable_name\fR
.RS 4
The name (optionally schema\-qualified) of the table the policy applies to\&.
.RE
.PP
\fIcommand\fR
.RS 4
The command to which the policy applies\&. Valid options are
\fBALL\fR,
\fBSELECT\fR,
\fBINSERT\fR,
\fBUPDATE\fR, and
\fBDELETE\fR\&.
\fBALL\fR
is the default\&. See below for specifics regarding how these are applied\&.
.RE
.PP
\fIrole_name\fR
.RS 4
The role(s) to which the policy is to be applied\&. The default is
PUBLIC, which will apply the policy to all roles\&.
.RE
.PP
\fIusing_expression\fR
.RS 4
Any
SQL
conditional expression (returning
boolean)\&. The conditional expression cannot contain any aggregate or window functions\&. This expression will be added to queries that refer to the table if row level security is enabled\&. Rows for which the expression returns true will be visible\&. Any rows for which the expression returns false or null will not be visible to the user (in a
\fBSELECT\fR), and will not be available for modification (in an
\fBUPDATE\fR
or
\fBDELETE\fR)\&. Such rows are silently suppressed; no error is reported\&.
.RE
.PP
\fIcheck_expression\fR
.RS 4
Any
SQL
conditional expression (returning
boolean)\&. The conditional expression cannot contain any aggregate or window functions\&. This expression will be used in
\fBINSERT\fR
and
\fBUPDATE\fR
queries against the table if row level security is enabled\&. Only rows for which the expression evaluates to true will be allowed\&. An error will be thrown if the expression evaluates to false or null for any of the records inserted or any of the records that result from the update\&. Note that the
\fIcheck_expression\fR
is evaluated against the proposed new contents of the row, not the original contents\&.
.RE
.SS "Per\-Command Policies"
.PP
ALL
.RS 4
Using
ALL
for a policy means that it will apply to all commands, regardless of the type of command\&. If an
ALL
policy exists and more specific policies exist, then both the
ALL
policy and the more specific policy (or policies) will be applied\&. Additionally,
ALL
policies will be applied to both the selection side of a query and the modification side, using the
USING
expression for both cases if only a
USING
expression has been defined\&.
.sp
As an example, if an
UPDATE
is issued, then the
ALL
policy will be applicable both to what the
UPDATE
will be able to select as rows to be updated (applying the
USING
expression), and to the resulting updated rows, to check if they are permitted to be added to the table (applying the
WITH CHECK
expression, if defined, and the
USING
expression otherwise)\&. If an
\fBINSERT\fR
or
\fBUPDATE\fR
command attempts to add rows to the table that do not pass the
ALL
policy\*(Aqs
WITH CHECK
expression, the entire command will be aborted\&.
.RE
.PP
SELECT
.RS 4
Using
SELECT
for a policy means that it will apply to
SELECT
queries and whenever
SELECT
permissions are required on the relation the policy is defined for\&. The result is that only those records from the relation that pass the
SELECT
policy will be returned during a
SELECT
query, and that queries that require
SELECT
permissions, such as
UPDATE, will also only see those records that are allowed by the
SELECT
policy\&. A
SELECT
policy cannot have a
WITH CHECK
expression, as it only applies in cases where records are being retrieved from the relation\&.
.RE
.PP
INSERT
.RS 4
Using
INSERT
for a policy means that it will apply to
INSERT
commands\&. Rows being inserted that do not pass this policy will result in a policy violation error, and the entire
INSERT
command will be aborted\&. An
INSERT
policy cannot have a
USING
expression, as it only applies in cases where records are being added to the relation\&.
.sp
Note that
INSERT
with
ON CONFLICT DO UPDATE
checks
INSERT
policies\*(Aq
WITH CHECK
expressions only for rows appended to the relation by the
INSERT
path\&.
.RE
.PP
UPDATE
.RS 4
Using
UPDATE
for a policy means that it will apply to
UPDATE,
SELECT FOR UPDATE
and
SELECT FOR SHARE
commands, as well as auxiliary
ON CONFLICT DO UPDATE
clauses of
INSERT
commands\&. Since
UPDATE
involves pulling an existing record and replacing it with a new modified record,
UPDATE
policies accept both a
USING
expression and a
WITH CHECK
expression\&. The
USING
expression determines which records the
UPDATE
command will see to operate against, while the
WITH CHECK
expression defines which modified rows are allowed to be stored back into the relation\&.
.sp
Any rows whose updated values do not pass the
WITH CHECK
expression will cause an error, and the entire command will be aborted\&. If only a
USING
clause is specified, then that clause will be used for both
USING
and
WITH CHECK
cases\&.
.sp
Typically an
UPDATE
command also needs to read data from columns in the relation being updated (e\&.g\&., in a
WHERE
clause or a
RETURNING
clause, or in an expression on the right hand side of the
SET
clause)\&. In this case,
SELECT
rights are also required on the relation being updated, and the appropriate
SELECT
or
ALL
policies will be applied in addition to the
UPDATE
policies\&. Thus the user must have access to the row(s) being updated through a
SELECT
or
ALL
policy in addition to being granted permission to update the row(s) via an
UPDATE
or
ALL
policy\&.
.sp
When an
INSERT
command has an auxiliary
ON CONFLICT DO UPDATE
clause, if the
UPDATE
path is taken, the row to be updated is first checked against the
USING
expressions of any
UPDATE
policies, and then the new updated row is checked against the
WITH CHECK
expressions\&. Note, however, that unlike a standalone
UPDATE
command, if the existing row does not pass the
USING
expressions, an error will be thrown (the
UPDATE
path will
\fInever\fR
be silently avoided)\&.
.RE
.PP
DELETE
.RS 4
Using
DELETE
for a policy means that it will apply to
DELETE
commands\&. Only rows that pass this policy will be seen by a
DELETE
command\&. There can be rows that are visible through a
SELECT
that are not available for deletion, if they do not pass the
USING
expression for the
DELETE
policy\&.
.sp
In most cases a
DELETE
command also needs to read data from columns in the relation that it is deleting from (e\&.g\&., in a
WHERE
clause or a
RETURNING
clause)\&. In this case,
SELECT
rights are also required on the relation, and the appropriate
SELECT
or
ALL
policies will be applied in addition to the
DELETE
policies\&. Thus the user must have access to the row(s) being deleted through a
SELECT
or
ALL
policy in addition to being granted permission to delete the row(s) via a
DELETE
or
ALL
policy\&.
.sp
A
DELETE
policy cannot have a
WITH CHECK
expression, as it only applies in cases where records are being deleted from the relation, so that there is no new row to check\&.
.RE
.sp
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.B Table\ \&238.\ \&Policies Applied by Command Type
.TS
allbox tab(:);
lB lB lB lB s lB
^ lB lB lB lB lB.
T{
Command
T}:T{
SELECT/ALL policy
T}:T{
INSERT/ALL policy
T}:T{
UPDATE/ALL policy
T}:T{
DELETE/ALL policy
T}
:T{
USING expression
T}:T{
WITH CHECK expression
T}:T{
USING expression
T}:T{
WITH CHECK expression
T}:T{
USING expression
T}
.T&
l l l l l l
l l l l l l
l l l l l l
l l l l l l
l l l l l l
l l l l l l
l l l l l l
l s s s s s.
T{
\fBSELECT\fR
T}:T{
Existing row
T}:T{
\(em
T}:T{
\(em
T}:T{
\(em
T}:T{
\(em
T}
T{
\fBSELECT FOR UPDATE/SHARE\fR
T}:T{
Existing row
T}:T{
\(em
T}:T{
Existing row
T}:T{
\(em
T}:T{
\(em
T}
T{
\fBINSERT\fR
T}:T{
\(em
T}:T{
New row
T}:T{
\(em
T}:T{
\(em
T}:T{
\(em
T}
T{
\fBINSERT \&.\&.\&. RETURNING\fR
T}:T{
New row [a]
T}:T{
New row
T}:T{
\(em
T}:T{
\(em
T}:T{
\(em
T}
T{
\fBUPDATE\fR
T}:T{
Existing & new rows [a]
T}:T{
\(em
T}:T{
Existing row
T}:T{
New row
T}:T{
\(em
T}
T{
\fBDELETE\fR
T}:T{
Existing row [a]
T}:T{
\(em
T}:T{
\(em
T}:T{
\(em
T}:T{
Existing row
T}
T{
\fBON CONFLICT DO UPDATE\fR
T}:T{
Existing & new rows
T}:T{
\(em
T}:T{
Existing row
T}:T{
New row
T}:T{
\(em
T}
T{
----
.br
[a]
If read access is required to the existing or new row (for example, a
WHERE
or
RETURNING
clause that refers to columns from the relation)\&.
T}
.TE
.sp 1
.SS "Application of Multiple Policies"
.PP
When multiple policies of different command types apply to the same command (for example,
SELECT
and
UPDATE
policies applied to an
UPDATE
command), then the user must have both types of permissions (for example, permission to select rows from the relation as well as permission to update them)\&. Thus the expressions for one type of policy are combined with the expressions for the other type of policy using the
AND
operator\&.
.PP
When multiple policies of the same command type apply to the same command, then at least one of the policies must grant access to the relation\&. Thus the expressions from all the policies of that type are combined using the
OR
operator\&. If there are no applicable policies, then access is denied\&.
.PP
Note that, for the purposes of combining multiple policies,
ALL
policies are treated as having the same type as whichever other type of policy is being applied\&.
.PP
For example, in an
UPDATE
command requiring both
SELECT
and
UPDATE
permissions, if there are multiple applicable policies of each type, they will be combined as follows:
.sp
.if n \{\
.RS 4
.\}
.nf
(
\fIexpression\fR from SELECT/ALL policy 1
OR
\fIexpression\fR from SELECT/ALL policy 2
OR
\&.\&.\&.
)
AND
(
\fIexpression\fR from UPDATE/ALL policy 1
OR
\fIexpression\fR from UPDATE/ALL policy 2
OR
\&.\&.\&.
)
.fi
.if n \{\
.RE
.\}
.sp
.SH "NOTES"
.PP
You must be the owner of a table to create or change policies for it\&.
.PP
While policies will be applied for explicit queries against tables in the database, they are not applied when the system is performing internal referential integrity checks or validating constraints\&. This means there are indirect ways to determine that a given value exists\&. An example of this is attempting to insert a duplicate value into a column that is a primary key or has a unique constraint\&. If the insert fails then the user can infer that the value already exists\&. (This example assumes that the user is permitted by policy to insert records which they are not allowed to see\&.) Another example is where a user is allowed to insert into a table which references another, otherwise hidden table\&. Existence can be determined by the user inserting values into the referencing table, where success would indicate that the value exists in the referenced table\&. These issues can be addressed by carefully crafting policies to prevent users from being able to insert, delete, or update records at all which might possibly indicate a value they are not otherwise able to see, or by using generated values (e\&.g\&., surrogate keys) instead of keys with external meanings\&.
.PP
Generally, the system will enforce filter conditions imposed using security policies prior to qualifications that appear in user queries, in order to prevent inadvertent exposure of the protected data to user\-defined functions which might not be trustworthy\&. However, functions and operators marked by the system (or the system administrator) as
LEAKPROOF
may be evaluated before policy expressions, as they are assumed to be trustworthy\&.
.PP
Since policy expressions are added to the user\*(Aqs query directly, they will be run with the rights of the user running the overall query\&. Therefore, users who are using a given policy must be able to access any tables or functions referenced in the expression or they will simply receive a permission denied error when attempting to query the table that has row\-level security enabled\&. This does not change how views work, however\&. As with normal queries and views, permission checks and policies for the tables which are referenced by a view will use the view owner\*(Aqs rights and any policies which apply to the view owner\&.
.PP
Additional discussion and practical examples can be found in
Section 5.7, \(lqRow Security Policies\(rq, in the documentation\&.
.SH "COMPATIBILITY"
.PP
\fBCREATE POLICY\fR
is a
PostgreSQL
extension\&.
.SH "SEE ALSO"
ALTER POLICY (\fBALTER_POLICY\fR(7)), DROP POLICY (\fBDROP_POLICY\fR(7)), ALTER TABLE (\fBALTER_TABLE\fR(7))
man/man7/DROP_RULE.7 0000644 00000004554 14751153421 0007657 0 ustar 00 '\" t
.\" Title: DROP RULE
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "DROP RULE" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
DROP_RULE \- remove a rewrite rule
.SH "SYNOPSIS"
.sp
.nf
DROP RULE [ IF EXISTS ] \fIname\fR ON \fItable_name\fR [ CASCADE | RESTRICT ]
.fi
.SH "DESCRIPTION"
.PP
\fBDROP RULE\fR
drops a rewrite rule\&.
.SH "PARAMETERS"
.PP
IF EXISTS
.RS 4
Do not throw an error if the rule does not exist\&. A notice is issued in this case\&.
.RE
.PP
\fIname\fR
.RS 4
The name of the rule to drop\&.
.RE
.PP
\fItable_name\fR
.RS 4
The name (optionally schema\-qualified) of the table or view that the rule applies to\&.
.RE
.PP
CASCADE
.RS 4
Automatically drop objects that depend on the rule, and in turn all objects that depend on those objects (see
Section 5.13, \(lqDependency Tracking\(rq, in the documentation)\&.
.RE
.PP
RESTRICT
.RS 4
Refuse to drop the rule if any objects depend on it\&. This is the default\&.
.RE
.SH "EXAMPLES"
.PP
To drop the rewrite rule
newrule:
.sp
.if n \{\
.RS 4
.\}
.nf
DROP RULE newrule ON mytable;
.fi
.if n \{\
.RE
.\}
.SH "COMPATIBILITY"
.PP
\fBDROP RULE\fR
is a
PostgreSQL
language extension, as is the entire query rewrite system\&.
.SH "SEE ALSO"
CREATE RULE (\fBCREATE_RULE\fR(7)), ALTER RULE (\fBALTER_RULE\fR(7))
man/man7/VALUES.7 0000644 00000015713 14751153421 0007262 0 ustar 00 '\" t
.\" Title: VALUES
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "VALUES" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
VALUES \- compute a set of rows
.SH "SYNOPSIS"
.sp
.nf
VALUES ( \fIexpression\fR [, \&.\&.\&.] ) [, \&.\&.\&.]
[ ORDER BY \fIsort_expression\fR [ ASC | DESC | USING \fIoperator\fR ] [, \&.\&.\&.] ]
[ LIMIT { \fIcount\fR | ALL } ]
[ OFFSET \fIstart\fR [ ROW | ROWS ] ]
[ FETCH { FIRST | NEXT } [ \fIcount\fR ] { ROW | ROWS } ONLY ]
.fi
.SH "DESCRIPTION"
.PP
\fBVALUES\fR
computes a row value or set of row values specified by value expressions\&. It is most commonly used to generate a
\(lqconstant table\(rq
within a larger command, but it can be used on its own\&.
.PP
When more than one row is specified, all the rows must have the same number of elements\&. The data types of the resulting table\*(Aqs columns are determined by combining the explicit or inferred types of the expressions appearing in that column, using the same rules as for
UNION
(see
Section 10.5, \(lqUNION, CASE, and Related Constructs\(rq, in the documentation)\&.
.PP
Within larger commands,
\fBVALUES\fR
is syntactically allowed anywhere that
\fBSELECT\fR
is\&. Because it is treated like a
\fBSELECT\fR
by the grammar, it is possible to use the
ORDER BY,
LIMIT
(or equivalently
FETCH FIRST), and
OFFSET
clauses with a
\fBVALUES\fR
command\&.
.SH "PARAMETERS"
.PP
\fIexpression\fR
.RS 4
A constant or expression to compute and insert at the indicated place in the resulting table (set of rows)\&. In a
\fBVALUES\fR
list appearing at the top level of an
\fBINSERT\fR, an
\fIexpression\fR
can be replaced by
DEFAULT
to indicate that the destination column\*(Aqs default value should be inserted\&.
DEFAULT
cannot be used when
\fBVALUES\fR
appears in other contexts\&.
.RE
.PP
\fIsort_expression\fR
.RS 4
An expression or integer constant indicating how to sort the result rows\&. This expression can refer to the columns of the
\fBVALUES\fR
result as
column1,
column2, etc\&. For more details see
ORDER BY Clause\&.
.RE
.PP
\fIoperator\fR
.RS 4
A sorting operator\&. For details see
ORDER BY Clause\&.
.RE
.PP
\fIcount\fR
.RS 4
The maximum number of rows to return\&. For details see
LIMIT Clause\&.
.RE
.PP
\fIstart\fR
.RS 4
The number of rows to skip before starting to return rows\&. For details see
LIMIT Clause\&.
.RE
.SH "NOTES"
.PP
\fBVALUES\fR
lists with very large numbers of rows should be avoided, as you might encounter out\-of\-memory failures or poor performance\&.
\fBVALUES\fR
appearing within
\fBINSERT\fR
is a special case (because the desired column types are known from the
\fBINSERT\fR\*(Aqs target table, and need not be inferred by scanning the
\fBVALUES\fR
list), so it can handle larger lists than are practical in other contexts\&.
.SH "EXAMPLES"
.PP
A bare
\fBVALUES\fR
command:
.sp
.if n \{\
.RS 4
.\}
.nf
VALUES (1, \*(Aqone\*(Aq), (2, \*(Aqtwo\*(Aq), (3, \*(Aqthree\*(Aq);
.fi
.if n \{\
.RE
.\}
.sp
This will return a table of two columns and three rows\&. It\*(Aqs effectively equivalent to:
.sp
.if n \{\
.RS 4
.\}
.nf
SELECT 1 AS column1, \*(Aqone\*(Aq AS column2
UNION ALL
SELECT 2, \*(Aqtwo\*(Aq
UNION ALL
SELECT 3, \*(Aqthree\*(Aq;
.fi
.if n \{\
.RE
.\}
.PP
More usually,
\fBVALUES\fR
is used within a larger SQL command\&. The most common use is in
\fBINSERT\fR:
.sp
.if n \{\
.RS 4
.\}
.nf
INSERT INTO films (code, title, did, date_prod, kind)
VALUES (\*(AqT_601\*(Aq, \*(AqYojimbo\*(Aq, 106, \*(Aq1961\-06\-16\*(Aq, \*(AqDrama\*(Aq);
.fi
.if n \{\
.RE
.\}
.PP
In the context of
\fBINSERT\fR, entries of a
\fBVALUES\fR
list can be
DEFAULT
to indicate that the column default should be used here instead of specifying a value:
.sp
.if n \{\
.RS 4
.\}
.nf
INSERT INTO films VALUES
(\*(AqUA502\*(Aq, \*(AqBananas\*(Aq, 105, DEFAULT, \*(AqComedy\*(Aq, \*(Aq82 minutes\*(Aq),
(\*(AqT_601\*(Aq, \*(AqYojimbo\*(Aq, 106, DEFAULT, \*(AqDrama\*(Aq, DEFAULT);
.fi
.if n \{\
.RE
.\}
.PP
\fBVALUES\fR
can also be used where a sub\-\fBSELECT\fR
might be written, for example in a
FROM
clause:
.sp
.if n \{\
.RS 4
.\}
.nf
SELECT f\&.*
FROM films f, (VALUES(\*(AqMGM\*(Aq, \*(AqHorror\*(Aq), (\*(AqUA\*(Aq, \*(AqSci\-Fi\*(Aq)) AS t (studio, kind)
WHERE f\&.studio = t\&.studio AND f\&.kind = t\&.kind;
UPDATE employees SET salary = salary * v\&.increase
FROM (VALUES(1, 200000, 1\&.2), (2, 400000, 1\&.4)) AS v (depno, target, increase)
WHERE employees\&.depno = v\&.depno AND employees\&.sales >= v\&.target;
.fi
.if n \{\
.RE
.\}
.sp
Note that an
AS
clause is required when
\fBVALUES\fR
is used in a
FROM
clause, just as is true for
\fBSELECT\fR\&. It is not required that the
AS
clause specify names for all the columns, but it\*(Aqs good practice to do so\&. (The default column names for
\fBVALUES\fR
are
column1,
column2, etc in
PostgreSQL, but these names might be different in other database systems\&.)
.PP
When
\fBVALUES\fR
is used in
\fBINSERT\fR, the values are all automatically coerced to the data type of the corresponding destination column\&. When it\*(Aqs used in other contexts, it might be necessary to specify the correct data type\&. If the entries are all quoted literal constants, coercing the first is sufficient to determine the assumed type for all:
.sp
.if n \{\
.RS 4
.\}
.nf
SELECT * FROM machines
WHERE ip_address IN (VALUES(\*(Aq192\&.168\&.0\&.1\*(Aq::inet), (\*(Aq192\&.168\&.0\&.10\*(Aq), (\*(Aq192\&.168\&.1\&.43\*(Aq));
.fi
.if n \{\
.RE
.\}
.if n \{\
.sp
.\}
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBTip\fR
.ps -1
.br
.PP
For simple
IN
tests, it\*(Aqs better to rely on the
list\-of\-scalars
form of
IN
than to write a
\fBVALUES\fR
query as shown above\&. The list of scalars method requires less writing and is often more efficient\&.
.sp .5v
.RE
.SH "COMPATIBILITY"
.PP
\fBVALUES\fR
conforms to the SQL standard\&.
LIMIT
and
OFFSET
are
PostgreSQL
extensions; see also under
\fBSELECT\fR(7)\&.
.SH "SEE ALSO"
\fBINSERT\fR(7), \fBSELECT\fR(7)
man/man7/ALTER_TYPE.7 0000644 00000016242 14751153421 0007771 0 ustar 00 '\" t
.\" Title: ALTER TYPE
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "ALTER TYPE" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
ALTER_TYPE \- change the definition of a type
.SH "SYNOPSIS"
.sp
.nf
ALTER TYPE \fIname\fR \fIaction\fR [, \&.\&.\&. ]
ALTER TYPE \fIname\fR OWNER TO { \fInew_owner\fR | CURRENT_USER | SESSION_USER }
ALTER TYPE \fIname\fR RENAME ATTRIBUTE \fIattribute_name\fR TO \fInew_attribute_name\fR [ CASCADE | RESTRICT ]
ALTER TYPE \fIname\fR RENAME TO \fInew_name\fR
ALTER TYPE \fIname\fR SET SCHEMA \fInew_schema\fR
ALTER TYPE \fIname\fR ADD VALUE [ IF NOT EXISTS ] \fInew_enum_value\fR [ { BEFORE | AFTER } \fIexisting_enum_value\fR ]
where \fIaction\fR is one of:
ADD ATTRIBUTE \fIattribute_name\fR \fIdata_type\fR [ COLLATE \fIcollation\fR ] [ CASCADE | RESTRICT ]
DROP ATTRIBUTE [ IF EXISTS ] \fIattribute_name\fR [ CASCADE | RESTRICT ]
ALTER ATTRIBUTE \fIattribute_name\fR [ SET DATA ] TYPE \fIdata_type\fR [ COLLATE \fIcollation\fR ] [ CASCADE | RESTRICT ]
.fi
.SH "DESCRIPTION"
.PP
\fBALTER TYPE\fR
changes the definition of an existing type\&. There are several subforms:
.PP
ADD ATTRIBUTE
.RS 4
This form adds a new attribute to a composite type, using the same syntax as
CREATE TYPE (\fBCREATE_TYPE\fR(7))\&.
.RE
.PP
DROP ATTRIBUTE [ IF EXISTS ]
.RS 4
This form drops an attribute from a composite type\&. If
IF EXISTS
is specified and the attribute does not exist, no error is thrown\&. In this case a notice is issued instead\&.
.RE
.PP
SET DATA TYPE
.RS 4
This form changes the type of an attribute of a composite type\&.
.RE
.PP
OWNER
.RS 4
This form changes the owner of the type\&.
.RE
.PP
RENAME
.RS 4
This form changes the name of the type or the name of an individual attribute of a composite type\&.
.RE
.PP
SET SCHEMA
.RS 4
This form moves the type into another schema\&.
.RE
.PP
ADD VALUE [ IF NOT EXISTS ] [ BEFORE | AFTER ]
.RS 4
This form adds a new value to an enum type\&. The new value\*(Aqs place in the enum\*(Aqs ordering can be specified as being
BEFORE
or
AFTER
one of the existing values\&. Otherwise, the new item is added at the end of the list of values\&.
.sp
If
IF NOT EXISTS
is specified, it is not an error if the type already contains the new value: a notice is issued but no other action is taken\&. Otherwise, an error will occur if the new value is already present\&.
.RE
.PP
CASCADE
.RS 4
Automatically propagate the operation to typed tables of the type being altered, and their descendants\&.
.RE
.PP
RESTRICT
.RS 4
Refuse the operation if the type being altered is the type of a typed table\&. This is the default\&.
.RE
.PP
The
ADD ATTRIBUTE,
DROP ATTRIBUTE, and
ALTER ATTRIBUTE
actions can be combined into a list of multiple alterations to apply in parallel\&. For example, it is possible to add several attributes and/or alter the type of several attributes in a single command\&.
.PP
You must own the type to use
\fBALTER TYPE\fR\&. To change the schema of a type, you must also have
CREATE
privilege on the new schema\&. To alter the owner, you must also be a direct or indirect member of the new owning role, and that role must have
CREATE
privilege on the type\*(Aqs schema\&. (These restrictions enforce that altering the owner doesn\*(Aqt do anything you couldn\*(Aqt do by dropping and recreating the type\&. However, a superuser can alter ownership of any type anyway\&.) To add an attribute or alter an attribute type, you must also have
USAGE
privilege on the data type\&.
.SH "PARAMETERS"
.PP
.PP
\fIname\fR
.RS 4
The name (possibly schema\-qualified) of an existing type to alter\&.
.RE
.PP
\fInew_name\fR
.RS 4
The new name for the type\&.
.RE
.PP
\fInew_owner\fR
.RS 4
The user name of the new owner of the type\&.
.RE
.PP
\fInew_schema\fR
.RS 4
The new schema for the type\&.
.RE
.PP
\fIattribute_name\fR
.RS 4
The name of the attribute to add, alter, or drop\&.
.RE
.PP
\fInew_attribute_name\fR
.RS 4
The new name of the attribute to be renamed\&.
.RE
.PP
\fIdata_type\fR
.RS 4
The data type of the attribute to add, or the new type of the attribute to alter\&.
.RE
.PP
\fInew_enum_value\fR
.RS 4
The new value to be added to an enum type\*(Aqs list of values\&. Like all enum literals, it needs to be quoted\&.
.RE
.PP
\fIexisting_enum_value\fR
.RS 4
The existing enum value that the new value should be added immediately before or after in the enum type\*(Aqs sort ordering\&. Like all enum literals, it needs to be quoted\&.
.RE
.SH "NOTES"
.PP
\fBALTER TYPE \&.\&.\&. ADD VALUE\fR
(the form that adds a new value to an enum type) cannot be executed inside a transaction block\&.
.PP
Comparisons involving an added enum value will sometimes be slower than comparisons involving only original members of the enum type\&. This will usually only occur if
BEFORE
or
AFTER
is used to set the new value\*(Aqs sort position somewhere other than at the end of the list\&. However, sometimes it will happen even though the new value is added at the end (this occurs if the OID counter
\(lqwrapped around\(rq
since the original creation of the enum type)\&. The slowdown is usually insignificant; but if it matters, optimal performance can be regained by dropping and recreating the enum type, or by dumping and reloading the database\&.
.SH "EXAMPLES"
.PP
To rename a data type:
.sp
.if n \{\
.RS 4
.\}
.nf
ALTER TYPE electronic_mail RENAME TO email;
.fi
.if n \{\
.RE
.\}
.PP
To change the owner of the type
email
to
joe:
.sp
.if n \{\
.RS 4
.\}
.nf
ALTER TYPE email OWNER TO joe;
.fi
.if n \{\
.RE
.\}
.PP
To change the schema of the type
email
to
customers:
.sp
.if n \{\
.RS 4
.\}
.nf
ALTER TYPE email SET SCHEMA customers;
.fi
.if n \{\
.RE
.\}
.PP
To add a new attribute to a type:
.sp
.if n \{\
.RS 4
.\}
.nf
ALTER TYPE compfoo ADD ATTRIBUTE f3 int;
.fi
.if n \{\
.RE
.\}
.PP
To add a new value to an enum type in a particular sort position:
.sp
.if n \{\
.RS 4
.\}
.nf
ALTER TYPE colors ADD VALUE \*(Aqorange\*(Aq AFTER \*(Aqred\*(Aq;
.fi
.if n \{\
.RE
.\}
.SH "COMPATIBILITY"
.PP
The variants to add and drop attributes are part of the SQL standard; the other variants are PostgreSQL extensions\&.
.SH "SEE ALSO"
CREATE TYPE (\fBCREATE_TYPE\fR(7)), DROP TYPE (\fBDROP_TYPE\fR(7))
man/man7/CREATE_SERVER.7 0000644 00000007205 14751153421 0010311 0 ustar 00 '\" t
.\" Title: CREATE SERVER
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "CREATE SERVER" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
CREATE_SERVER \- define a new foreign server
.SH "SYNOPSIS"
.sp
.nf
CREATE SERVER \fIserver_name\fR [ TYPE \*(Aq\fIserver_type\fR\*(Aq ] [ VERSION \*(Aq\fIserver_version\fR\*(Aq ]
FOREIGN DATA WRAPPER \fIfdw_name\fR
[ OPTIONS ( \fIoption\fR \*(Aq\fIvalue\fR\*(Aq [, \&.\&.\&. ] ) ]
.fi
.SH "DESCRIPTION"
.PP
\fBCREATE SERVER\fR
defines a new foreign server\&. The user who defines the server becomes its owner\&.
.PP
A foreign server typically encapsulates connection information that a foreign\-data wrapper uses to access an external data resource\&. Additional user\-specific connection information may be specified by means of user mappings\&.
.PP
The server name must be unique within the database\&.
.PP
Creating a server requires
USAGE
privilege on the foreign\-data wrapper being used\&.
.SH "PARAMETERS"
.PP
\fIserver_name\fR
.RS 4
The name of the foreign server to be created\&.
.RE
.PP
\fIserver_type\fR
.RS 4
Optional server type, potentially useful to foreign\-data wrappers\&.
.RE
.PP
\fIserver_version\fR
.RS 4
Optional server version, potentially useful to foreign\-data wrappers\&.
.RE
.PP
\fIfdw_name\fR
.RS 4
The name of the foreign\-data wrapper that manages the server\&.
.RE
.PP
OPTIONS ( \fIoption\fR \*(Aq\fIvalue\fR\*(Aq [, \&.\&.\&. ] )
.RS 4
This clause specifies the options for the server\&. The options typically define the connection details of the server, but the actual names and values are dependent on the server\*(Aqs foreign\-data wrapper\&.
.RE
.SH "NOTES"
.PP
When using the
dblink
module, a foreign server\*(Aqs name can be used as an argument of the
\fBdblink_connect\fR(3)
function to indicate the connection parameters\&. It is necessary to have the
USAGE
privilege on the foreign server to be able to use it in this way\&.
.SH "EXAMPLES"
.PP
Create a server
myserver
that uses the foreign\-data wrapper
postgres_fdw:
.sp
.if n \{\
.RS 4
.\}
.nf
CREATE SERVER myserver FOREIGN DATA WRAPPER postgres_fdw OPTIONS (host \*(Aqfoo\*(Aq, dbname \*(Aqfoodb\*(Aq, port \*(Aq5432\*(Aq);
.fi
.if n \{\
.RE
.\}
.sp
See
postgres_fdw
for more details\&.
.SH "COMPATIBILITY"
.PP
\fBCREATE SERVER\fR
conforms to ISO/IEC 9075\-9 (SQL/MED)\&.
.SH "SEE ALSO"
ALTER SERVER (\fBALTER_SERVER\fR(7)), DROP SERVER (\fBDROP_SERVER\fR(7)), CREATE FOREIGN DATA WRAPPER (\fBCREATE_FOREIGN_DATA_WRAPPER\fR(7)), CREATE FOREIGN TABLE (\fBCREATE_FOREIGN_TABLE\fR(7)), CREATE USER MAPPING (\fBCREATE_USER_MAPPING\fR(7))
man/man7/ALTER_EXTENSION.7 0000644 00000015625 14751153421 0010570 0 ustar 00 '\" t
.\" Title: ALTER EXTENSION
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "ALTER EXTENSION" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
ALTER_EXTENSION \- change the definition of an extension
.SH "SYNOPSIS"
.sp
.nf
ALTER EXTENSION \fIname\fR UPDATE [ TO \fInew_version\fR ]
ALTER EXTENSION \fIname\fR SET SCHEMA \fInew_schema\fR
ALTER EXTENSION \fIname\fR ADD \fImember_object\fR
ALTER EXTENSION \fIname\fR DROP \fImember_object\fR
where \fImember_object\fR is:
ACCESS METHOD \fIobject_name\fR |
AGGREGATE \fIaggregate_name\fR ( \fIaggregate_signature\fR ) |
CAST (\fIsource_type\fR AS \fItarget_type\fR) |
COLLATION \fIobject_name\fR |
CONVERSION \fIobject_name\fR |
DOMAIN \fIobject_name\fR |
EVENT TRIGGER \fIobject_name\fR |
FOREIGN DATA WRAPPER \fIobject_name\fR |
FOREIGN TABLE \fIobject_name\fR |
FUNCTION \fIfunction_name\fR ( [ [ \fIargmode\fR ] [ \fIargname\fR ] \fIargtype\fR [, \&.\&.\&.] ] ) |
MATERIALIZED VIEW \fIobject_name\fR |
OPERATOR \fIoperator_name\fR (\fIleft_type\fR, \fIright_type\fR) |
OPERATOR CLASS \fIobject_name\fR USING \fIindex_method\fR |
OPERATOR FAMILY \fIobject_name\fR USING \fIindex_method\fR |
[ PROCEDURAL ] LANGUAGE \fIobject_name\fR |
SCHEMA \fIobject_name\fR |
SEQUENCE \fIobject_name\fR |
SERVER \fIobject_name\fR |
TABLE \fIobject_name\fR |
TEXT SEARCH CONFIGURATION \fIobject_name\fR |
TEXT SEARCH DICTIONARY \fIobject_name\fR |
TEXT SEARCH PARSER \fIobject_name\fR |
TEXT SEARCH TEMPLATE \fIobject_name\fR |
TRANSFORM FOR \fItype_name\fR LANGUAGE \fIlang_name\fR |
TYPE \fIobject_name\fR |
VIEW \fIobject_name\fR
and \fIaggregate_signature\fR is:
* |
[ \fIargmode\fR ] [ \fIargname\fR ] \fIargtype\fR [ , \&.\&.\&. ] |
[ [ \fIargmode\fR ] [ \fIargname\fR ] \fIargtype\fR [ , \&.\&.\&. ] ] ORDER BY [ \fIargmode\fR ] [ \fIargname\fR ] \fIargtype\fR [ , \&.\&.\&. ]
.fi
.SH "DESCRIPTION"
.PP
\fBALTER EXTENSION\fR
changes the definition of an installed extension\&. There are several subforms:
.PP
UPDATE
.RS 4
This form updates the extension to a newer version\&. The extension must supply a suitable update script (or series of scripts) that can modify the currently\-installed version into the requested version\&.
.RE
.PP
SET SCHEMA
.RS 4
This form moves the extension\*(Aqs objects into another schema\&. The extension has to be
relocatable
for this command to succeed\&.
.RE
.PP
ADD \fImember_object\fR
.RS 4
This form adds an existing object to the extension\&. This is mainly useful in extension update scripts\&. The object will subsequently be treated as a member of the extension; notably, it can only be dropped by dropping the extension\&.
.RE
.PP
DROP \fImember_object\fR
.RS 4
This form removes a member object from the extension\&. This is mainly useful in extension update scripts\&. The object is not dropped, only disassociated from the extension\&.
.RE
See
Section 36.15, \(lqPackaging Related Objects into an Extension\(rq, in the documentation
for more information about these operations\&.
.PP
You must own the extension to use
\fBALTER EXTENSION\fR\&. The
ADD/DROP
forms require ownership of the added/dropped object as well\&.
.SH "PARAMETERS"
.PP
.PP
\fIname\fR
.RS 4
The name of an installed extension\&.
.RE
.PP
\fInew_version\fR
.RS 4
The desired new version of the extension\&. This can be written as either an identifier or a string literal\&. If not specified,
\fBALTER EXTENSION UPDATE\fR
attempts to update to whatever is shown as the default version in the extension\*(Aqs control file\&.
.RE
.PP
\fInew_schema\fR
.RS 4
The new schema for the extension\&.
.RE
.PP
\fIobject_name\fR
.br
\fIaggregate_name\fR
.br
\fIfunction_name\fR
.br
\fIoperator_name\fR
.RS 4
The name of an object to be added to or removed from the extension\&. Names of tables, aggregates, domains, foreign tables, functions, operators, operator classes, operator families, sequences, text search objects, types, and views can be schema\-qualified\&.
.RE
.PP
\fIsource_type\fR
.RS 4
The name of the source data type of the cast\&.
.RE
.PP
\fItarget_type\fR
.RS 4
The name of the target data type of the cast\&.
.RE
.PP
\fIargmode\fR
.RS 4
The mode of a function or aggregate argument:
IN,
OUT,
INOUT, or
VARIADIC\&. If omitted, the default is
IN\&. Note that
\fBALTER EXTENSION\fR
does not actually pay any attention to
OUT
arguments, since only the input arguments are needed to determine the function\*(Aqs identity\&. So it is sufficient to list the
IN,
INOUT, and
VARIADIC
arguments\&.
.RE
.PP
\fIargname\fR
.RS 4
The name of a function or aggregate argument\&. Note that
\fBALTER EXTENSION\fR
does not actually pay any attention to argument names, since only the argument data types are needed to determine the function\*(Aqs identity\&.
.RE
.PP
\fIargtype\fR
.RS 4
The data type of a function or aggregate argument\&.
.RE
.PP
\fIleft_type\fR
.br
\fIright_type\fR
.RS 4
The data type(s) of the operator\*(Aqs arguments (optionally schema\-qualified)\&. Write
NONE
for the missing argument of a prefix or postfix operator\&.
.RE
.PP
PROCEDURAL
.RS 4
This is a noise word\&.
.RE
.PP
\fItype_name\fR
.RS 4
The name of the data type of the transform\&.
.RE
.PP
\fIlang_name\fR
.RS 4
The name of the language of the transform\&.
.RE
.SH "EXAMPLES"
.PP
To update the
hstore
extension to version 2\&.0:
.sp
.if n \{\
.RS 4
.\}
.nf
ALTER EXTENSION hstore UPDATE TO \*(Aq2\&.0\*(Aq;
.fi
.if n \{\
.RE
.\}
.PP
To change the schema of the
hstore
extension to
utils:
.sp
.if n \{\
.RS 4
.\}
.nf
ALTER EXTENSION hstore SET SCHEMA utils;
.fi
.if n \{\
.RE
.\}
.PP
To add an existing function to the
hstore
extension:
.sp
.if n \{\
.RS 4
.\}
.nf
ALTER EXTENSION hstore ADD FUNCTION populate_record(anyelement, hstore);
.fi
.if n \{\
.RE
.\}
.SH "COMPATIBILITY"
.PP
\fBALTER EXTENSION\fR
is a
PostgreSQL
extension\&.
.SH "SEE ALSO"
CREATE EXTENSION (\fBCREATE_EXTENSION\fR(7)), DROP EXTENSION (\fBDROP_EXTENSION\fR(7))
man/man7/CREATE_FOREIGN_TABLE.7 0000644 00000022005 14751153421 0011276 0 ustar 00 '\" t
.\" Title: CREATE FOREIGN TABLE
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "CREATE FOREIGN TABLE" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
CREATE_FOREIGN_TABLE \- define a new foreign table
.SH "SYNOPSIS"
.sp
.nf
CREATE FOREIGN TABLE [ IF NOT EXISTS ] \fItable_name\fR ( [
{ \fIcolumn_name\fR \fIdata_type\fR [ OPTIONS ( \fIoption\fR \*(Aq\fIvalue\fR\*(Aq [, \&.\&.\&. ] ) ] [ COLLATE \fIcollation\fR ] [ \fIcolumn_constraint\fR [ \&.\&.\&. ] ]
| \fItable_constraint\fR }
[, \&.\&.\&. ]
] )
[ INHERITS ( \fIparent_table\fR [, \&.\&.\&. ] ) ]
SERVER \fIserver_name\fR
[ OPTIONS ( \fIoption\fR \*(Aq\fIvalue\fR\*(Aq [, \&.\&.\&. ] ) ]
where \fIcolumn_constraint\fR is:
[ CONSTRAINT \fIconstraint_name\fR ]
{ NOT NULL |
NULL |
CHECK ( \fIexpression\fR ) [ NO INHERIT ] |
DEFAULT \fIdefault_expr\fR }
and \fItable_constraint\fR is:
[ CONSTRAINT \fIconstraint_name\fR ]
CHECK ( \fIexpression\fR ) [ NO INHERIT ]
.fi
.SH "DESCRIPTION"
.PP
\fBCREATE FOREIGN TABLE\fR
creates a new foreign table in the current database\&. The table will be owned by the user issuing the command\&.
.PP
If a schema name is given (for example,
CREATE FOREIGN TABLE myschema\&.mytable \&.\&.\&.) then the table is created in the specified schema\&. Otherwise it is created in the current schema\&. The name of the foreign table must be distinct from the name of any other foreign table, table, sequence, index, view, or materialized view in the same schema\&.
.PP
\fBCREATE FOREIGN TABLE\fR
also automatically creates a data type that represents the composite type corresponding to one row of the foreign table\&. Therefore, foreign tables cannot have the same name as any existing data type in the same schema\&.
.PP
To be able to create a foreign table, you must have
USAGE
privilege on the foreign server, as well as
USAGE
privilege on all column types used in the table\&.
.SH "PARAMETERS"
.PP
IF NOT EXISTS
.RS 4
Do not throw an error if a relation with the same name already exists\&. A notice is issued in this case\&. Note that there is no guarantee that the existing relation is anything like the one that would have been created\&.
.RE
.PP
\fItable_name\fR
.RS 4
The name (optionally schema\-qualified) of the table to be created\&.
.RE
.PP
\fIcolumn_name\fR
.RS 4
The name of a column to be created in the new table\&.
.RE
.PP
\fIdata_type\fR
.RS 4
The data type of the column\&. This can include array specifiers\&. For more information on the data types supported by
PostgreSQL, refer to
Chapter 8, Data Types, in the documentation\&.
.RE
.PP
COLLATE \fIcollation\fR
.RS 4
The
COLLATE
clause assigns a collation to the column (which must be of a collatable data type)\&. If not specified, the column data type\*(Aqs default collation is used\&.
.RE
.PP
INHERITS ( \fIparent_table\fR [, \&.\&.\&. ] )
.RS 4
The optional
INHERITS
clause specifies a list of tables from which the new foreign table automatically inherits all columns\&. Parent tables can be plain tables or foreign tables\&. See the similar form of
CREATE TABLE (\fBCREATE_TABLE\fR(7))
for more details\&.
.RE
.PP
CONSTRAINT \fIconstraint_name\fR
.RS 4
An optional name for a column or table constraint\&. If the constraint is violated, the constraint name is present in error messages, so constraint names like
col must be positive
can be used to communicate helpful constraint information to client applications\&. (Double\-quotes are needed to specify constraint names that contain spaces\&.) If a constraint name is not specified, the system generates a name\&.
.RE
.PP
NOT NULL
.RS 4
The column is not allowed to contain null values\&.
.RE
.PP
NULL
.RS 4
The column is allowed to contain null values\&. This is the default\&.
.sp
This clause is only provided for compatibility with non\-standard SQL databases\&. Its use is discouraged in new applications\&.
.RE
.PP
CHECK ( \fIexpression\fR ) [ NO INHERIT ]
.RS 4
The
CHECK
clause specifies an expression producing a Boolean result which each row in the foreign table is expected to satisfy; that is, the expression should produce TRUE or UNKNOWN, never FALSE, for all rows in the foreign table\&. A check constraint specified as a column constraint should reference that column\*(Aqs value only, while an expression appearing in a table constraint can reference multiple columns\&.
.sp
Currently,
CHECK
expressions cannot contain subqueries nor refer to variables other than columns of the current row\&. The system column
tableoid
may be referenced, but not any other system column\&.
.sp
A constraint marked with
NO INHERIT
will not propagate to child tables\&.
.RE
.PP
DEFAULT \fIdefault_expr\fR
.RS 4
The
DEFAULT
clause assigns a default data value for the column whose column definition it appears within\&. The value is any variable\-free expression (subqueries and cross\-references to other columns in the current table are not allowed)\&. The data type of the default expression must match the data type of the column\&.
.sp
The default expression will be used in any insert operation that does not specify a value for the column\&. If there is no default for a column, then the default is null\&.
.RE
.PP
\fIserver_name\fR
.RS 4
The name of an existing foreign server to use for the foreign table\&. For details on defining a server, see
CREATE SERVER (\fBCREATE_SERVER\fR(7))\&.
.RE
.PP
OPTIONS ( \fIoption\fR \*(Aq\fIvalue\fR\*(Aq [, \&.\&.\&.] )
.RS 4
Options to be associated with the new foreign table or one of its columns\&. The allowed option names and values are specific to each foreign data wrapper and are validated using the foreign\-data wrapper\*(Aqs validator function\&. Duplicate option names are not allowed (although it\*(Aqs OK for a table option and a column option to have the same name)\&.
.RE
.SH "NOTES"
.PP
Constraints on foreign tables (such as
CHECK
or
NOT NULL
clauses) are not enforced by the core
PostgreSQL
system, and most foreign data wrappers do not attempt to enforce them either; that is, the constraint is simply assumed to hold true\&. There would be little point in such enforcement since it would only apply to rows inserted or updated via the foreign table, and not to rows modified by other means, such as directly on the remote server\&. Instead, a constraint attached to a foreign table should represent a constraint that is being enforced by the remote server\&.
.PP
Some special\-purpose foreign data wrappers might be the only access mechanism for the data they access, and in that case it might be appropriate for the foreign data wrapper itself to perform constraint enforcement\&. But you should not assume that a wrapper does that unless its documentation says so\&.
.PP
Although
PostgreSQL
does not attempt to enforce constraints on foreign tables, it does assume that they are correct for purposes of query optimization\&. If there are rows visible in the foreign table that do not satisfy a declared constraint, queries on the table might produce incorrect answers\&. It is the user\*(Aqs responsibility to ensure that the constraint definition matches reality\&.
.SH "EXAMPLES"
.PP
Create foreign table
films, which will be accessed through the server
film_server:
.sp
.if n \{\
.RS 4
.\}
.nf
CREATE FOREIGN TABLE films (
code char(5) NOT NULL,
title varchar(40) NOT NULL,
did integer NOT NULL,
date_prod date,
kind varchar(10),
len interval hour to minute
)
SERVER film_server;
.fi
.if n \{\
.RE
.\}
.SH "COMPATIBILITY"
.PP
The
\fBCREATE FOREIGN TABLE\fR
command largely conforms to the
SQL
standard; however, much as with
\fBCREATE TABLE\fR,
NULL
constraints and zero\-column foreign tables are permitted\&. The ability to specify column default values is also a
PostgreSQL
extension\&. Table inheritance, in the form defined by
PostgreSQL, is nonstandard\&.
.SH "SEE ALSO"
ALTER FOREIGN TABLE (\fBALTER_FOREIGN_TABLE\fR(7)), DROP FOREIGN TABLE (\fBDROP_FOREIGN_TABLE\fR(7)), CREATE TABLE (\fBCREATE_TABLE\fR(7)), CREATE SERVER (\fBCREATE_SERVER\fR(7)), IMPORT FOREIGN SCHEMA (\fBIMPORT_FOREIGN_SCHEMA\fR(7))
man/man7/ALTER_DOMAIN.7 0000644 00000017332 14751153421 0010160 0 ustar 00 '\" t
.\" Title: ALTER DOMAIN
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "ALTER DOMAIN" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
ALTER_DOMAIN \- change the definition of a domain
.SH "SYNOPSIS"
.sp
.nf
ALTER DOMAIN \fIname\fR
{ SET DEFAULT \fIexpression\fR | DROP DEFAULT }
ALTER DOMAIN \fIname\fR
{ SET | DROP } NOT NULL
ALTER DOMAIN \fIname\fR
ADD \fIdomain_constraint\fR [ NOT VALID ]
ALTER DOMAIN \fIname\fR
DROP CONSTRAINT [ IF EXISTS ] \fIconstraint_name\fR [ RESTRICT | CASCADE ]
ALTER DOMAIN \fIname\fR
RENAME CONSTRAINT \fIconstraint_name\fR TO \fInew_constraint_name\fR
ALTER DOMAIN \fIname\fR
VALIDATE CONSTRAINT \fIconstraint_name\fR
ALTER DOMAIN \fIname\fR
OWNER TO { \fInew_owner\fR | CURRENT_USER | SESSION_USER }
ALTER DOMAIN \fIname\fR
RENAME TO \fInew_name\fR
ALTER DOMAIN \fIname\fR
SET SCHEMA \fInew_schema\fR
.fi
.SH "DESCRIPTION"
.PP
\fBALTER DOMAIN\fR
changes the definition of an existing domain\&. There are several sub\-forms:
.PP
SET/DROP DEFAULT
.RS 4
These forms set or remove the default value for a domain\&. Note that defaults only apply to subsequent
\fBINSERT\fR
commands; they do not affect rows already in a table using the domain\&.
.RE
.PP
SET/DROP NOT NULL
.RS 4
These forms change whether a domain is marked to allow NULL values or to reject NULL values\&. You can only
SET NOT NULL
when the columns using the domain contain no null values\&.
.RE
.PP
ADD \fIdomain_constraint\fR [ NOT VALID ]
.RS 4
This form adds a new constraint to a domain using the same syntax as
CREATE DOMAIN (\fBCREATE_DOMAIN\fR(7))\&. When a new constraint is added to a domain, all columns using that domain will be checked against the newly added constraint\&. These checks can be suppressed by adding the new constraint using the
NOT VALID
option; the constraint can later be made valid using
\fBALTER DOMAIN \&.\&.\&. VALIDATE CONSTRAINT\fR\&. Newly inserted or updated rows are always checked against all constraints, even those marked
NOT VALID\&.
NOT VALID
is only accepted for
CHECK
constraints\&.
.RE
.PP
DROP CONSTRAINT [ IF EXISTS ]
.RS 4
This form drops constraints on a domain\&. If
IF EXISTS
is specified and the constraint does not exist, no error is thrown\&. In this case a notice is issued instead\&.
.RE
.PP
RENAME CONSTRAINT
.RS 4
This form changes the name of a constraint on a domain\&.
.RE
.PP
VALIDATE CONSTRAINT
.RS 4
This form validates a constraint previously added as
NOT VALID, that is, it verifies that all values in table columns of the domain type satisfy the specified constraint\&.
.RE
.PP
OWNER
.RS 4
This form changes the owner of the domain to the specified user\&.
.RE
.PP
RENAME
.RS 4
This form changes the name of the domain\&.
.RE
.PP
SET SCHEMA
.RS 4
This form changes the schema of the domain\&. Any constraints associated with the domain are moved into the new schema as well\&.
.RE
.PP
You must own the domain to use
\fBALTER DOMAIN\fR\&. To change the schema of a domain, you must also have
CREATE
privilege on the new schema\&. To alter the owner, you must also be a direct or indirect member of the new owning role, and that role must have
CREATE
privilege on the domain\*(Aqs schema\&. (These restrictions enforce that altering the owner doesn\*(Aqt do anything you couldn\*(Aqt do by dropping and recreating the domain\&. However, a superuser can alter ownership of any domain anyway\&.)
.SH "PARAMETERS"
.PP
.PP
\fIname\fR
.RS 4
The name (possibly schema\-qualified) of an existing domain to alter\&.
.RE
.PP
\fIdomain_constraint\fR
.RS 4
New domain constraint for the domain\&.
.RE
.PP
\fIconstraint_name\fR
.RS 4
Name of an existing constraint to drop or rename\&.
.RE
.PP
\fINOT VALID\fR
.RS 4
Do not verify existing stored data for constraint validity\&.
.RE
.PP
CASCADE
.RS 4
Automatically drop objects that depend on the constraint, and in turn all objects that depend on those objects (see
Section 5.13, \(lqDependency Tracking\(rq, in the documentation)\&.
.RE
.PP
RESTRICT
.RS 4
Refuse to drop the constraint if there are any dependent objects\&. This is the default behavior\&.
.RE
.PP
\fInew_name\fR
.RS 4
The new name for the domain\&.
.RE
.PP
\fInew_constraint_name\fR
.RS 4
The new name for the constraint\&.
.RE
.PP
\fInew_owner\fR
.RS 4
The user name of the new owner of the domain\&.
.RE
.PP
\fInew_schema\fR
.RS 4
The new schema for the domain\&.
.RE
.SH "NOTES"
.PP
Although
\fBALTER DOMAIN ADD CONSTRAINT\fR
attempts to verify that existing stored data satisfies the new constraint, this check is not bulletproof, because the command cannot
\(lqsee\(rq
table rows that are newly inserted or updated and not yet committed\&. If there is a hazard that concurrent operations might insert bad data, the way to proceed is to add the constraint using the
NOT VALID
option, commit that command, wait until all transactions started before that commit have finished, and then issue
\fBALTER DOMAIN VALIDATE CONSTRAINT\fR
to search for data violating the constraint\&. This method is reliable because once the constraint is committed, all new transactions are guaranteed to enforce it against new values of the domain type\&.
.PP
Currently,
\fBALTER DOMAIN ADD CONSTRAINT\fR,
\fBALTER DOMAIN VALIDATE CONSTRAINT\fR, and
\fBALTER DOMAIN SET NOT NULL\fR
will fail if the validated named domain or any derived domain is used within a composite\-type column of any table in the database\&. They should eventually be improved to be able to verify the new constraint for such nested columns\&.
.SH "EXAMPLES"
.PP
To add a
NOT NULL
constraint to a domain:
.sp
.if n \{\
.RS 4
.\}
.nf
ALTER DOMAIN zipcode SET NOT NULL;
.fi
.if n \{\
.RE
.\}
.sp
To remove a
NOT NULL
constraint from a domain:
.sp
.if n \{\
.RS 4
.\}
.nf
ALTER DOMAIN zipcode DROP NOT NULL;
.fi
.if n \{\
.RE
.\}
.PP
To add a check constraint to a domain:
.sp
.if n \{\
.RS 4
.\}
.nf
ALTER DOMAIN zipcode ADD CONSTRAINT zipchk CHECK (char_length(VALUE) = 5);
.fi
.if n \{\
.RE
.\}
.PP
To remove a check constraint from a domain:
.sp
.if n \{\
.RS 4
.\}
.nf
ALTER DOMAIN zipcode DROP CONSTRAINT zipchk;
.fi
.if n \{\
.RE
.\}
.PP
To rename a check constraint on a domain:
.sp
.if n \{\
.RS 4
.\}
.nf
ALTER DOMAIN zipcode RENAME CONSTRAINT zipchk TO zip_check;
.fi
.if n \{\
.RE
.\}
.PP
To move the domain into a different schema:
.sp
.if n \{\
.RS 4
.\}
.nf
ALTER DOMAIN zipcode SET SCHEMA customers;
.fi
.if n \{\
.RE
.\}
.SH "COMPATIBILITY"
.PP
\fBALTER DOMAIN\fR
conforms to the
SQL
standard, except for the
OWNER,
RENAME,
SET SCHEMA, and
VALIDATE CONSTRAINT
variants, which are
PostgreSQL
extensions\&. The
NOT VALID
clause of the
ADD CONSTRAINT
variant is also a
PostgreSQL
extension\&.
.SH "SEE ALSO"
CREATE DOMAIN (\fBCREATE_DOMAIN\fR(7)), DROP DOMAIN (\fBDROP_DOMAIN\fR(7))
man/man7/DROP_TEXT_SEARCH_TEMPLATE.7 0000644 00000005307 14751153421 0012211 0 ustar 00 '\" t
.\" Title: DROP TEXT SEARCH TEMPLATE
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "DROP TEXT SEARCH TEMPLATE" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
DROP_TEXT_SEARCH_TEMPLATE \- remove a text search template
.SH "SYNOPSIS"
.sp
.nf
DROP TEXT SEARCH TEMPLATE [ IF EXISTS ] \fIname\fR [ CASCADE | RESTRICT ]
.fi
.SH "DESCRIPTION"
.PP
\fBDROP TEXT SEARCH TEMPLATE\fR
drops an existing text search template\&. You must be a superuser to use this command\&.
.SH "PARAMETERS"
.PP
IF EXISTS
.RS 4
Do not throw an error if the text search template does not exist\&. A notice is issued in this case\&.
.RE
.PP
\fIname\fR
.RS 4
The name (optionally schema\-qualified) of an existing text search template\&.
.RE
.PP
CASCADE
.RS 4
Automatically drop objects that depend on the text search template, and in turn all objects that depend on those objects (see
Section 5.13, \(lqDependency Tracking\(rq, in the documentation)\&.
.RE
.PP
RESTRICT
.RS 4
Refuse to drop the text search template if any objects depend on it\&. This is the default\&.
.RE
.SH "EXAMPLES"
.PP
Remove the text search template
thesaurus:
.sp
.if n \{\
.RS 4
.\}
.nf
DROP TEXT SEARCH TEMPLATE thesaurus;
.fi
.if n \{\
.RE
.\}
.sp
This command will not succeed if there are any existing text search dictionaries that use the template\&. Add
CASCADE
to drop such dictionaries along with the template\&.
.SH "COMPATIBILITY"
.PP
There is no
\fBDROP TEXT SEARCH TEMPLATE\fR
statement in the SQL standard\&.
.SH "SEE ALSO"
ALTER TEXT SEARCH TEMPLATE (\fBALTER_TEXT_SEARCH_TEMPLATE\fR(7)), CREATE TEXT SEARCH TEMPLATE (\fBCREATE_TEXT_SEARCH_TEMPLATE\fR(7))
man/man7/LOCK.7 0000644 00000020014 14751153421 0007001 0 ustar 00 '\" t
.\" Title: LOCK
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "LOCK" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
LOCK \- lock a table
.SH "SYNOPSIS"
.sp
.nf
LOCK [ TABLE ] [ ONLY ] \fIname\fR [ * ] [, \&.\&.\&.] [ IN \fIlockmode\fR MODE ] [ NOWAIT ]
where \fIlockmode\fR is one of:
ACCESS SHARE | ROW SHARE | ROW EXCLUSIVE | SHARE UPDATE EXCLUSIVE
| SHARE | SHARE ROW EXCLUSIVE | EXCLUSIVE | ACCESS EXCLUSIVE
.fi
.SH "DESCRIPTION"
.PP
\fBLOCK TABLE\fR
obtains a table\-level lock, waiting if necessary for any conflicting locks to be released\&. If
NOWAIT
is specified,
\fBLOCK TABLE\fR
does not wait to acquire the desired lock: if it cannot be acquired immediately, the command is aborted and an error is emitted\&. Once obtained, the lock is held for the remainder of the current transaction\&. (There is no
\fBUNLOCK TABLE\fR
command; locks are always released at transaction end\&.)
.PP
When acquiring locks automatically for commands that reference tables,
PostgreSQL
always uses the least restrictive lock mode possible\&.
\fBLOCK TABLE\fR
provides for cases when you might need more restrictive locking\&. For example, suppose an application runs a transaction at the
READ COMMITTED
isolation level and needs to ensure that data in a table remains stable for the duration of the transaction\&. To achieve this you could obtain
SHARE
lock mode over the table before querying\&. This will prevent concurrent data changes and ensure subsequent reads of the table see a stable view of committed data, because
SHARE
lock mode conflicts with the
ROW EXCLUSIVE
lock acquired by writers, and your
\fBLOCK TABLE \fR\fB\fIname\fR\fR\fB IN SHARE MODE\fR
statement will wait until any concurrent holders of
ROW EXCLUSIVE
mode locks commit or roll back\&. Thus, once you obtain the lock, there are no uncommitted writes outstanding; furthermore none can begin until you release the lock\&.
.PP
To achieve a similar effect when running a transaction at the
REPEATABLE READ
or
SERIALIZABLE
isolation level, you have to execute the
\fBLOCK TABLE\fR
statement before executing any
\fBSELECT\fR
or data modification statement\&. A
REPEATABLE READ
or
SERIALIZABLE
transaction\*(Aqs view of data will be frozen when its first
\fBSELECT\fR
or data modification statement begins\&. A
\fBLOCK TABLE\fR
later in the transaction will still prevent concurrent writes \(em but it won\*(Aqt ensure that what the transaction reads corresponds to the latest committed values\&.
.PP
If a transaction of this sort is going to change the data in the table, then it should use
SHARE ROW EXCLUSIVE
lock mode instead of
SHARE
mode\&. This ensures that only one transaction of this type runs at a time\&. Without this, a deadlock is possible: two transactions might both acquire
SHARE
mode, and then be unable to also acquire
ROW EXCLUSIVE
mode to actually perform their updates\&. (Note that a transaction\*(Aqs own locks never conflict, so a transaction can acquire
ROW EXCLUSIVE
mode when it holds
SHARE
mode \(em but not if anyone else holds
SHARE
mode\&.) To avoid deadlocks, make sure all transactions acquire locks on the same objects in the same order, and if multiple lock modes are involved for a single object, then transactions should always acquire the most restrictive mode first\&.
.PP
More information about the lock modes and locking strategies can be found in
Section 13.3, \(lqExplicit Locking\(rq, in the documentation\&.
.SH "PARAMETERS"
.PP
\fIname\fR
.RS 4
The name (optionally schema\-qualified) of an existing table to lock\&. If
ONLY
is specified before the table name, only that table is locked\&. If
ONLY
is not specified, the table and all its descendant tables (if any) are locked\&. Optionally,
*
can be specified after the table name to explicitly indicate that descendant tables are included\&.
.sp
The command
LOCK TABLE a, b;
is equivalent to
LOCK TABLE a; LOCK TABLE b;\&. The tables are locked one\-by\-one in the order specified in the
\fBLOCK TABLE\fR
command\&.
.RE
.PP
\fIlockmode\fR
.RS 4
The lock mode specifies which locks this lock conflicts with\&. Lock modes are described in
Section 13.3, \(lqExplicit Locking\(rq, in the documentation\&.
.sp
If no lock mode is specified, then
ACCESS EXCLUSIVE, the most restrictive mode, is used\&.
.RE
.PP
NOWAIT
.RS 4
Specifies that
\fBLOCK TABLE\fR
should not wait for any conflicting locks to be released: if the specified lock(s) cannot be acquired immediately without waiting, the transaction is aborted\&.
.RE
.SH "NOTES"
.PP
LOCK TABLE \&.\&.\&. IN ACCESS SHARE MODE
requires
SELECT
privileges on the target table\&.
LOCK TABLE \&.\&.\&. IN ROW EXCLUSIVE MODE
requires
INSERT,
UPDATE,
DELETE, or
TRUNCATE
privileges on the target table\&. All other forms of
\fBLOCK\fR
require table\-level
UPDATE,
DELETE, or
TRUNCATE
privileges\&.
.PP
\fBLOCK TABLE\fR
is useless outside a transaction block: the lock would remain held only to the completion of the statement\&. Therefore
PostgreSQL
reports an error if
\fBLOCK\fR
is used outside a transaction block\&. Use
\fBBEGIN\fR(7)
and
\fBCOMMIT\fR(7)
(or
\fBROLLBACK\fR(7)) to define a transaction block\&.
.PP
\fBLOCK TABLE\fR
only deals with table\-level locks, and so the mode names involving
ROW
are all misnomers\&. These mode names should generally be read as indicating the intention of the user to acquire row\-level locks within the locked table\&. Also,
ROW EXCLUSIVE
mode is a shareable table lock\&. Keep in mind that all the lock modes have identical semantics so far as
\fBLOCK TABLE\fR
is concerned, differing only in the rules about which modes conflict with which\&. For information on how to acquire an actual row\-level lock, see
Section 13.3.2, \(lqRow-level Locks\(rq, in the documentation
and the
The Locking Clause
in the
\fBSELECT\fR
reference documentation\&.
.SH "EXAMPLES"
.PP
Obtain a
SHARE
lock on a primary key table when going to perform inserts into a foreign key table:
.sp
.if n \{\
.RS 4
.\}
.nf
BEGIN WORK;
LOCK TABLE films IN SHARE MODE;
SELECT id FROM films
WHERE name = \*(AqStar Wars: Episode I \- The Phantom Menace\*(Aq;
\-\- Do ROLLBACK if record was not returned
INSERT INTO films_user_comments VALUES
(_id_, \*(AqGREAT! I was waiting for it for so long!\*(Aq);
COMMIT WORK;
.fi
.if n \{\
.RE
.\}
.PP
Take a
SHARE ROW EXCLUSIVE
lock on a primary key table when going to perform a delete operation:
.sp
.if n \{\
.RS 4
.\}
.nf
BEGIN WORK;
LOCK TABLE films IN SHARE ROW EXCLUSIVE MODE;
DELETE FROM films_user_comments WHERE id IN
(SELECT id FROM films WHERE rating < 5);
DELETE FROM films WHERE rating < 5;
COMMIT WORK;
.fi
.if n \{\
.RE
.\}
.SH "COMPATIBILITY"
.PP
There is no
\fBLOCK TABLE\fR
in the SQL standard, which instead uses
\fBSET TRANSACTION\fR
to specify concurrency levels on transactions\&.
PostgreSQL
supports that too; see
SET TRANSACTION (\fBSET_TRANSACTION\fR(7))
for details\&.
.PP
Except for
ACCESS SHARE,
ACCESS EXCLUSIVE, and
SHARE UPDATE EXCLUSIVE
lock modes, the
PostgreSQL
lock modes and the
\fBLOCK TABLE\fR
syntax are compatible with those present in
Oracle\&.
man/man7/CREATE_OPERATOR_CLASS.7 0000644 00000021025 14751153421 0011457 0 ustar 00 '\" t
.\" Title: CREATE OPERATOR CLASS
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "CREATE OPERATOR CLASS" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
CREATE_OPERATOR_CLASS \- define a new operator class
.SH "SYNOPSIS"
.sp
.nf
CREATE OPERATOR CLASS \fIname\fR [ DEFAULT ] FOR TYPE \fIdata_type\fR
USING \fIindex_method\fR [ FAMILY \fIfamily_name\fR ] AS
{ OPERATOR \fIstrategy_number\fR \fIoperator_name\fR [ ( \fIop_type\fR, \fIop_type\fR ) ] [ FOR SEARCH | FOR ORDER BY \fIsort_family_name\fR ]
| FUNCTION \fIsupport_number\fR [ ( \fIop_type\fR [ , \fIop_type\fR ] ) ] \fIfunction_name\fR ( \fIargument_type\fR [, \&.\&.\&.] )
| STORAGE \fIstorage_type\fR
} [, \&.\&.\&. ]
.fi
.SH "DESCRIPTION"
.PP
\fBCREATE OPERATOR CLASS\fR
creates a new operator class\&. An operator class defines how a particular data type can be used with an index\&. The operator class specifies that certain operators will fill particular roles or
\(lqstrategies\(rq
for this data type and this index method\&. The operator class also specifies the support procedures to be used by the index method when the operator class is selected for an index column\&. All the operators and functions used by an operator class must be defined before the operator class can be created\&.
.PP
If a schema name is given then the operator class is created in the specified schema\&. Otherwise it is created in the current schema\&. Two operator classes in the same schema can have the same name only if they are for different index methods\&.
.PP
The user who defines an operator class becomes its owner\&. Presently, the creating user must be a superuser\&. (This restriction is made because an erroneous operator class definition could confuse or even crash the server\&.)
.PP
\fBCREATE OPERATOR CLASS\fR
does not presently check whether the operator class definition includes all the operators and functions required by the index method, nor whether the operators and functions form a self\-consistent set\&. It is the user\*(Aqs responsibility to define a valid operator class\&.
.PP
Related operator classes can be grouped into
operator families\&. To add a new operator class to an existing family, specify the
FAMILY
option in
\fBCREATE OPERATOR CLASS\fR\&. Without this option, the new class is placed into a family named the same as the new class (creating that family if it doesn\*(Aqt already exist)\&.
.PP
Refer to
Section 36.14, \(lqInterfacing Extensions To Indexes\(rq, in the documentation
for further information\&.
.SH "PARAMETERS"
.PP
\fIname\fR
.RS 4
The name of the operator class to be created\&. The name can be schema\-qualified\&.
.RE
.PP
DEFAULT
.RS 4
If present, the operator class will become the default operator class for its data type\&. At most one operator class can be the default for a specific data type and index method\&.
.RE
.PP
\fIdata_type\fR
.RS 4
The column data type that this operator class is for\&.
.RE
.PP
\fIindex_method\fR
.RS 4
The name of the index method this operator class is for\&.
.RE
.PP
\fIfamily_name\fR
.RS 4
The name of the existing operator family to add this operator class to\&. If not specified, a family named the same as the operator class is used (creating it, if it doesn\*(Aqt already exist)\&.
.RE
.PP
\fIstrategy_number\fR
.RS 4
The index method\*(Aqs strategy number for an operator associated with the operator class\&.
.RE
.PP
\fIoperator_name\fR
.RS 4
The name (optionally schema\-qualified) of an operator associated with the operator class\&.
.RE
.PP
\fIop_type\fR
.RS 4
In an
OPERATOR
clause, the operand data type(s) of the operator, or
NONE
to signify a left\-unary or right\-unary operator\&. The operand data types can be omitted in the normal case where they are the same as the operator class\*(Aqs data type\&.
.sp
In a
FUNCTION
clause, the operand data type(s) the function is intended to support, if different from the input data type(s) of the function (for B\-tree comparison functions and hash functions) or the class\*(Aqs data type (for B\-tree sort support functions and all functions in GiST, SP\-GiST, GIN and BRIN operator classes)\&. These defaults are correct, and so
\fIop_type\fR
need not be specified in
FUNCTION
clauses, except for the case of a B\-tree sort support function that is meant to support cross\-data\-type comparisons\&.
.RE
.PP
\fIsort_family_name\fR
.RS 4
The name (optionally schema\-qualified) of an existing
btree
operator family that describes the sort ordering associated with an ordering operator\&.
.sp
If neither
FOR SEARCH
nor
FOR ORDER BY
is specified,
FOR SEARCH
is the default\&.
.RE
.PP
\fIsupport_number\fR
.RS 4
The index method\*(Aqs support procedure number for a function associated with the operator class\&.
.RE
.PP
\fIfunction_name\fR
.RS 4
The name (optionally schema\-qualified) of a function that is an index method support procedure for the operator class\&.
.RE
.PP
\fIargument_type\fR
.RS 4
The parameter data type(s) of the function\&.
.RE
.PP
\fIstorage_type\fR
.RS 4
The data type actually stored in the index\&. Normally this is the same as the column data type, but some index methods (currently GiST, GIN and BRIN) allow it to be different\&. The
STORAGE
clause must be omitted unless the index method allows a different type to be used\&.
.RE
.PP
The
OPERATOR,
FUNCTION, and
STORAGE
clauses can appear in any order\&.
.SH "NOTES"
.PP
Because the index machinery does not check access permissions on functions before using them, including a function or operator in an operator class is tantamount to granting public execute permission on it\&. This is usually not an issue for the sorts of functions that are useful in an operator class\&.
.PP
The operators should not be defined by SQL functions\&. A SQL function is likely to be inlined into the calling query, which will prevent the optimizer from recognizing that the query matches an index\&.
.PP
Before
PostgreSQL
8\&.4, the
OPERATOR
clause could include a
RECHECK
option\&. This is no longer supported because whether an index operator is
\(lqlossy\(rq
is now determined on\-the\-fly at run time\&. This allows efficient handling of cases where an operator might or might not be lossy\&.
.SH "EXAMPLES"
.PP
The following example command defines a GiST index operator class for the data type
_int4
(array of
int4)\&. See the
intarray
module for the complete example\&.
.sp
.if n \{\
.RS 4
.\}
.nf
CREATE OPERATOR CLASS gist__int_ops
DEFAULT FOR TYPE _int4 USING gist AS
OPERATOR 3 &&,
OPERATOR 6 = (anyarray, anyarray),
OPERATOR 7 @>,
OPERATOR 8 <@,
OPERATOR 20 @@ (_int4, query_int),
FUNCTION 1 g_int_consistent (internal, _int4, smallint, oid, internal),
FUNCTION 2 g_int_union (internal, internal),
FUNCTION 3 g_int_compress (internal),
FUNCTION 4 g_int_decompress (internal),
FUNCTION 5 g_int_penalty (internal, internal, internal),
FUNCTION 6 g_int_picksplit (internal, internal),
FUNCTION 7 g_int_same (_int4, _int4, internal);
.fi
.if n \{\
.RE
.\}
.SH "COMPATIBILITY"
.PP
\fBCREATE OPERATOR CLASS\fR
is a
PostgreSQL
extension\&. There is no
\fBCREATE OPERATOR CLASS\fR
statement in the SQL standard\&.
.SH "SEE ALSO"
ALTER OPERATOR CLASS (\fBALTER_OPERATOR_CLASS\fR(7)), DROP OPERATOR CLASS (\fBDROP_OPERATOR_CLASS\fR(7)), CREATE OPERATOR FAMILY (\fBCREATE_OPERATOR_FAMILY\fR(7)), ALTER OPERATOR FAMILY (\fBALTER_OPERATOR_FAMILY\fR(7))
man/man7/DROP_TRIGGER.7 0000644 00000005157 14751153421 0010213 0 ustar 00 '\" t
.\" Title: DROP TRIGGER
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "DROP TRIGGER" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
DROP_TRIGGER \- remove a trigger
.SH "SYNOPSIS"
.sp
.nf
DROP TRIGGER [ IF EXISTS ] \fIname\fR ON \fItable_name\fR [ CASCADE | RESTRICT ]
.fi
.SH "DESCRIPTION"
.PP
\fBDROP TRIGGER\fR
removes an existing trigger definition\&. To execute this command, the current user must be the owner of the table for which the trigger is defined\&.
.SH "PARAMETERS"
.PP
IF EXISTS
.RS 4
Do not throw an error if the trigger does not exist\&. A notice is issued in this case\&.
.RE
.PP
\fIname\fR
.RS 4
The name of the trigger to remove\&.
.RE
.PP
\fItable_name\fR
.RS 4
The name (optionally schema\-qualified) of the table for which the trigger is defined\&.
.RE
.PP
CASCADE
.RS 4
Automatically drop objects that depend on the trigger, and in turn all objects that depend on those objects (see
Section 5.13, \(lqDependency Tracking\(rq, in the documentation)\&.
.RE
.PP
RESTRICT
.RS 4
Refuse to drop the trigger if any objects depend on it\&. This is the default\&.
.RE
.SH "EXAMPLES"
.PP
Destroy the trigger
if_dist_exists
on the table
films:
.sp
.if n \{\
.RS 4
.\}
.nf
DROP TRIGGER if_dist_exists ON films;
.fi
.if n \{\
.RE
.\}
.SH "COMPATIBILITY"
.PP
The
\fBDROP TRIGGER\fR
statement in
PostgreSQL
is incompatible with the SQL standard\&. In the SQL standard, trigger names are not local to tables, so the command is simply
DROP TRIGGER \fIname\fR\&.
.SH "SEE ALSO"
CREATE TRIGGER (\fBCREATE_TRIGGER\fR(7))
man/man7/ALTER_CONVERSION.7 0000644 00000005626 14751153421 0010701 0 ustar 00 '\" t
.\" Title: ALTER CONVERSION
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "ALTER CONVERSION" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
ALTER_CONVERSION \- change the definition of a conversion
.SH "SYNOPSIS"
.sp
.nf
ALTER CONVERSION \fIname\fR RENAME TO \fInew_name\fR
ALTER CONVERSION \fIname\fR OWNER TO { \fInew_owner\fR | CURRENT_USER | SESSION_USER }
ALTER CONVERSION \fIname\fR SET SCHEMA \fInew_schema\fR
.fi
.SH "DESCRIPTION"
.PP
\fBALTER CONVERSION\fR
changes the definition of a conversion\&.
.PP
You must own the conversion to use
\fBALTER CONVERSION\fR\&. To alter the owner, you must also be a direct or indirect member of the new owning role, and that role must have
CREATE
privilege on the conversion\*(Aqs schema\&. (These restrictions enforce that altering the owner doesn\*(Aqt do anything you couldn\*(Aqt do by dropping and recreating the conversion\&. However, a superuser can alter ownership of any conversion anyway\&.)
.SH "PARAMETERS"
.PP
\fIname\fR
.RS 4
The name (optionally schema\-qualified) of an existing conversion\&.
.RE
.PP
\fInew_name\fR
.RS 4
The new name of the conversion\&.
.RE
.PP
\fInew_owner\fR
.RS 4
The new owner of the conversion\&.
.RE
.PP
\fInew_schema\fR
.RS 4
The new schema for the conversion\&.
.RE
.SH "EXAMPLES"
.PP
To rename the conversion
iso_8859_1_to_utf8
to
latin1_to_unicode:
.sp
.if n \{\
.RS 4
.\}
.nf
ALTER CONVERSION iso_8859_1_to_utf8 RENAME TO latin1_to_unicode;
.fi
.if n \{\
.RE
.\}
.PP
To change the owner of the conversion
iso_8859_1_to_utf8
to
joe:
.sp
.if n \{\
.RS 4
.\}
.nf
ALTER CONVERSION iso_8859_1_to_utf8 OWNER TO joe;
.fi
.if n \{\
.RE
.\}
.SH "COMPATIBILITY"
.PP
There is no
\fBALTER CONVERSION\fR
statement in the SQL standard\&.
.SH "SEE ALSO"
CREATE CONVERSION (\fBCREATE_CONVERSION\fR(7)), DROP CONVERSION (\fBDROP_CONVERSION\fR(7))
man/man7/DROP_POLICY.7 0000644 00000005044 14751153421 0010102 0 ustar 00 '\" t
.\" Title: DROP POLICY
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "DROP POLICY" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
DROP_POLICY \- remove a row level security policy from a table
.SH "SYNOPSIS"
.sp
.nf
DROP POLICY [ IF EXISTS ] \fIname\fR ON \fItable_name\fR [ CASCADE | RESTRICT ]
.fi
.SH "DESCRIPTION"
.PP
\fBDROP POLICY\fR
removes the specified policy from the table\&. Note that if the last policy is removed for a table and the table still has row level security enabled via
\fBALTER TABLE\fR, then the default\-deny policy will be used\&.
ALTER TABLE \&.\&.\&. DISABLE ROW LEVEL SECURITY
can be used to disable row level security for a table, whether policies for the table exist or not\&.
.SH "PARAMETERS"
.PP
IF EXISTS
.RS 4
Do not throw an error if the policy does not exist\&. A notice is issued in this case\&.
.RE
.PP
\fIname\fR
.RS 4
The name of the policy to drop\&.
.RE
.PP
\fItable_name\fR
.RS 4
The name (optionally schema\-qualified) of the table that the policy is on\&.
.RE
.PP
CASCADE
.br
RESTRICT
.RS 4
These key words do not have any effect, since there are no dependencies on policies\&.
.RE
.SH "EXAMPLES"
.PP
To drop the policy called
p1
on the table named
my_table:
.sp
.if n \{\
.RS 4
.\}
.nf
DROP POLICY p1 ON my_table;
.fi
.if n \{\
.RE
.\}
.sp
.SH "COMPATIBILITY"
.PP
\fBDROP POLICY\fR
is a
PostgreSQL
extension\&.
.SH "SEE ALSO"
CREATE POLICY (\fBCREATE_POLICY\fR(7)), ALTER POLICY (\fBALTER_POLICY\fR(7))
man/man7/SET_SESSION_AUTHORIZATION.7 0000644 00000007611 14751153421 0012237 0 ustar 00 '\" t
.\" Title: SET SESSION AUTHORIZATION
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "SET SESSION AUTHORIZATION" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
SET_SESSION_AUTHORIZATION \- set the session user identifier and the current user identifier of the current session
.SH "SYNOPSIS"
.sp
.nf
SET [ SESSION | LOCAL ] SESSION AUTHORIZATION \fIuser_name\fR
SET [ SESSION | LOCAL ] SESSION AUTHORIZATION DEFAULT
RESET SESSION AUTHORIZATION
.fi
.SH "DESCRIPTION"
.PP
This command sets the session user identifier and the current user identifier of the current SQL session to be
\fIuser_name\fR\&. The user name can be written as either an identifier or a string literal\&. Using this command, it is possible, for example, to temporarily become an unprivileged user and later switch back to being a superuser\&.
.PP
The session user identifier is initially set to be the (possibly authenticated) user name provided by the client\&. The current user identifier is normally equal to the session user identifier, but might change temporarily in the context of
SECURITY DEFINER
functions and similar mechanisms; it can also be changed by
SET ROLE (\fBSET_ROLE\fR(7))\&. The current user identifier is relevant for permission checking\&.
.PP
The session user identifier can be changed only if the initial session user (the
authenticated user) had the superuser privilege\&. Otherwise, the command is accepted only if it specifies the authenticated user name\&.
.PP
The
SESSION
and
LOCAL
modifiers act the same as for the regular
\fBSET\fR(7)
command\&.
.PP
The
DEFAULT
and
RESET
forms reset the session and current user identifiers to be the originally authenticated user name\&. These forms can be executed by any user\&.
.SH "NOTES"
.PP
\fBSET SESSION AUTHORIZATION\fR
cannot be used within a
SECURITY DEFINER
function\&.
.SH "EXAMPLES"
.sp
.if n \{\
.RS 4
.\}
.nf
SELECT SESSION_USER, CURRENT_USER;
session_user | current_user
\-\-\-\-\-\-\-\-\-\-\-\-\-\-+\-\-\-\-\-\-\-\-\-\-\-\-\-\-
peter | peter
SET SESSION AUTHORIZATION \*(Aqpaul\*(Aq;
SELECT SESSION_USER, CURRENT_USER;
session_user | current_user
\-\-\-\-\-\-\-\-\-\-\-\-\-\-+\-\-\-\-\-\-\-\-\-\-\-\-\-\-
paul | paul
.fi
.if n \{\
.RE
.\}
.SH "COMPATIBILITY"
.PP
The SQL standard allows some other expressions to appear in place of the literal
\fIuser_name\fR, but these options are not important in practice\&.
PostgreSQL
allows identifier syntax ("\fIusername\fR"), which SQL does not\&. SQL does not allow this command during a transaction;
PostgreSQL
does not make this restriction because there is no reason to\&. The
SESSION
and
LOCAL
modifiers are a
PostgreSQL
extension, as is the
RESET
syntax\&.
.PP
The privileges necessary to execute this command are left implementation\-defined by the standard\&.
.SH "SEE ALSO"
SET ROLE (\fBSET_ROLE\fR(7))
man/man7/DROP_EVENT_TRIGGER.7 0000644 00000004616 14751153421 0011153 0 ustar 00 '\" t
.\" Title: DROP EVENT TRIGGER
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "DROP EVENT TRIGGER" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
DROP_EVENT_TRIGGER \- remove an event trigger
.SH "SYNOPSIS"
.sp
.nf
DROP EVENT TRIGGER [ IF EXISTS ] \fIname\fR [ CASCADE | RESTRICT ]
.fi
.SH "DESCRIPTION"
.PP
\fBDROP EVENT TRIGGER\fR
removes an existing event trigger\&. To execute this command, the current user must be the owner of the event trigger\&.
.SH "PARAMETERS"
.PP
IF EXISTS
.RS 4
Do not throw an error if the event trigger does not exist\&. A notice is issued in this case\&.
.RE
.PP
\fIname\fR
.RS 4
The name of the event trigger to remove\&.
.RE
.PP
CASCADE
.RS 4
Automatically drop objects that depend on the trigger, and in turn all objects that depend on those objects (see
Section 5.13, \(lqDependency Tracking\(rq, in the documentation)\&.
.RE
.PP
RESTRICT
.RS 4
Refuse to drop the trigger if any objects depend on it\&. This is the default\&.
.RE
.SH "EXAMPLES"
.PP
Destroy the trigger
snitch:
.sp
.if n \{\
.RS 4
.\}
.nf
DROP EVENT TRIGGER snitch;
.fi
.if n \{\
.RE
.\}
.SH "COMPATIBILITY"
.PP
There is no
\fBDROP EVENT TRIGGER\fR
statement in the SQL standard\&.
.SH "SEE ALSO"
CREATE EVENT TRIGGER (\fBCREATE_EVENT_TRIGGER\fR(7)), ALTER EVENT TRIGGER (\fBALTER_EVENT_TRIGGER\fR(7))
man/man7/DROP_SERVER.7 0000644 00000004620 14751153421 0010110 0 ustar 00 '\" t
.\" Title: DROP SERVER
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "DROP SERVER" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
DROP_SERVER \- remove a foreign server descriptor
.SH "SYNOPSIS"
.sp
.nf
DROP SERVER [ IF EXISTS ] \fIname\fR [ CASCADE | RESTRICT ]
.fi
.SH "DESCRIPTION"
.PP
\fBDROP SERVER\fR
removes an existing foreign server descriptor\&. To execute this command, the current user must be the owner of the server\&.
.SH "PARAMETERS"
.PP
IF EXISTS
.RS 4
Do not throw an error if the server does not exist\&. A notice is issued in this case\&.
.RE
.PP
\fIname\fR
.RS 4
The name of an existing server\&.
.RE
.PP
CASCADE
.RS 4
Automatically drop objects that depend on the server (such as user mappings), and in turn all objects that depend on those objects (see
Section 5.13, \(lqDependency Tracking\(rq, in the documentation)\&.
.RE
.PP
RESTRICT
.RS 4
Refuse to drop the server if any objects depend on it\&. This is the default\&.
.RE
.SH "EXAMPLES"
.PP
Drop a server
foo
if it exists:
.sp
.if n \{\
.RS 4
.\}
.nf
DROP SERVER IF EXISTS foo;
.fi
.if n \{\
.RE
.\}
.SH "COMPATIBILITY"
.PP
\fBDROP SERVER\fR
conforms to ISO/IEC 9075\-9 (SQL/MED)\&. The
IF EXISTS
clause is a
PostgreSQL
extension\&.
.SH "SEE ALSO"
CREATE SERVER (\fBCREATE_SERVER\fR(7)), ALTER SERVER (\fBALTER_SERVER\fR(7))
man/man7/CREATE_FUNCTION.7 0000644 00000061716 14751153421 0010537 0 ustar 00 '\" t
.\" Title: CREATE FUNCTION
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "CREATE FUNCTION" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
CREATE_FUNCTION \- define a new function
.SH "SYNOPSIS"
.sp
.nf
CREATE [ OR REPLACE ] FUNCTION
\fIname\fR ( [ [ \fIargmode\fR ] [ \fIargname\fR ] \fIargtype\fR [ { DEFAULT | = } \fIdefault_expr\fR ] [, \&.\&.\&.] ] )
[ RETURNS \fIrettype\fR
| RETURNS TABLE ( \fIcolumn_name\fR \fIcolumn_type\fR [, \&.\&.\&.] ) ]
{ LANGUAGE \fIlang_name\fR
| TRANSFORM { FOR TYPE \fItype_name\fR } [, \&.\&.\&. ]
| WINDOW
| { IMMUTABLE | STABLE | VOLATILE }
| [ NOT ] LEAKPROOF
| { CALLED ON NULL INPUT | RETURNS NULL ON NULL INPUT | STRICT }
| { [ EXTERNAL ] SECURITY INVOKER | [ EXTERNAL ] SECURITY DEFINER }
| PARALLEL { UNSAFE | RESTRICTED | SAFE }
| COST \fIexecution_cost\fR
| ROWS \fIresult_rows\fR
| SET \fIconfiguration_parameter\fR { TO \fIvalue\fR | = \fIvalue\fR | FROM CURRENT }
| AS \*(Aq\fIdefinition\fR\*(Aq
| AS \*(Aq\fIobj_file\fR\*(Aq, \*(Aq\fIlink_symbol\fR\*(Aq
} \&.\&.\&.
[ WITH ( \fIattribute\fR [, \&.\&.\&.] ) ]
.fi
.SH "DESCRIPTION"
.PP
\fBCREATE FUNCTION\fR
defines a new function\&.
\fBCREATE OR REPLACE FUNCTION\fR
will either create a new function, or replace an existing definition\&. To be able to define a function, the user must have the
USAGE
privilege on the language\&.
.PP
If a schema name is included, then the function is created in the specified schema\&. Otherwise it is created in the current schema\&. The name of the new function must not match any existing function with the same input argument types in the same schema\&. However, functions of different argument types can share a name (this is called
overloading)\&.
.PP
To replace the current definition of an existing function, use
\fBCREATE OR REPLACE FUNCTION\fR\&. It is not possible to change the name or argument types of a function this way (if you tried, you would actually be creating a new, distinct function)\&. Also,
\fBCREATE OR REPLACE FUNCTION\fR
will not let you change the return type of an existing function\&. To do that, you must drop and recreate the function\&. (When using
OUT
parameters, that means you cannot change the types of any
OUT
parameters except by dropping the function\&.)
.PP
When
\fBCREATE OR REPLACE FUNCTION\fR
is used to replace an existing function, the ownership and permissions of the function do not change\&. All other function properties are assigned the values specified or implied in the command\&. You must own the function to replace it (this includes being a member of the owning role)\&.
.PP
If you drop and then recreate a function, the new function is not the same entity as the old; you will have to drop existing rules, views, triggers, etc\&. that refer to the old function\&. Use
\fBCREATE OR REPLACE FUNCTION\fR
to change a function definition without breaking objects that refer to the function\&. Also,
\fBALTER FUNCTION\fR
can be used to change most of the auxiliary properties of an existing function\&.
.PP
The user that creates the function becomes the owner of the function\&.
.PP
To be able to create a function, you must have
USAGE
privilege on the argument types and the return type\&.
.SH "PARAMETERS"
.PP
\fIname\fR
.RS 4
The name (optionally schema\-qualified) of the function to create\&.
.RE
.PP
\fIargmode\fR
.RS 4
The mode of an argument:
IN,
OUT,
INOUT, or
VARIADIC\&. If omitted, the default is
IN\&. Only
OUT
arguments can follow a
VARIADIC
one\&. Also,
OUT
and
INOUT
arguments cannot be used together with the
RETURNS TABLE
notation\&.
.RE
.PP
\fIargname\fR
.RS 4
The name of an argument\&. Some languages (including SQL and PL/pgSQL) let you use the name in the function body\&. For other languages the name of an input argument is just extra documentation, so far as the function itself is concerned; but you can use input argument names when calling a function to improve readability (see
Section 4.3, \(lqCalling Functions\(rq, in the documentation)\&. In any case, the name of an output argument is significant, because it defines the column name in the result row type\&. (If you omit the name for an output argument, the system will choose a default column name\&.)
.RE
.PP
\fIargtype\fR
.RS 4
The data type(s) of the function\*(Aqs arguments (optionally schema\-qualified), if any\&. The argument types can be base, composite, or domain types, or can reference the type of a table column\&.
.sp
Depending on the implementation language it might also be allowed to specify
\(lqpseudotypes\(rq
such as
cstring\&. Pseudotypes indicate that the actual argument type is either incompletely specified, or outside the set of ordinary SQL data types\&.
.sp
The type of a column is referenced by writing
\fItable_name\fR\&.\fIcolumn_name\fR%TYPE\&. Using this feature can sometimes help make a function independent of changes to the definition of a table\&.
.RE
.PP
\fIdefault_expr\fR
.RS 4
An expression to be used as default value if the parameter is not specified\&. The expression has to be coercible to the argument type of the parameter\&. Only input (including
INOUT) parameters can have a default value\&. All input parameters following a parameter with a default value must have default values as well\&.
.RE
.PP
\fIrettype\fR
.RS 4
The return data type (optionally schema\-qualified)\&. The return type can be a base, composite, or domain type, or can reference the type of a table column\&. Depending on the implementation language it might also be allowed to specify
\(lqpseudotypes\(rq
such as
cstring\&. If the function is not supposed to return a value, specify
void
as the return type\&.
.sp
When there are
OUT
or
INOUT
parameters, the
RETURNS
clause can be omitted\&. If present, it must agree with the result type implied by the output parameters:
RECORD
if there are multiple output parameters, or the same type as the single output parameter\&.
.sp
The
SETOF
modifier indicates that the function will return a set of items, rather than a single item\&.
.sp
The type of a column is referenced by writing
\fItable_name\fR\&.\fIcolumn_name\fR%TYPE\&.
.RE
.PP
\fIcolumn_name\fR
.RS 4
The name of an output column in the
RETURNS TABLE
syntax\&. This is effectively another way of declaring a named
OUT
parameter, except that
RETURNS TABLE
also implies
RETURNS SETOF\&.
.RE
.PP
\fIcolumn_type\fR
.RS 4
The data type of an output column in the
RETURNS TABLE
syntax\&.
.RE
.PP
\fIlang_name\fR
.RS 4
The name of the language that the function is implemented in\&. It can be
sql,
c,
internal, or the name of a user\-defined procedural language, e\&.g\&.,
plpgsql\&. Enclosing the name in single quotes is deprecated and requires matching case\&.
.RE
.PP
TRANSFORM { FOR TYPE \fItype_name\fR } [, \&.\&.\&. ] }
.RS 4
Lists which transforms a call to the function should apply\&. Transforms convert between SQL types and language\-specific data types; see
CREATE TRANSFORM (\fBCREATE_TRANSFORM\fR(7))\&. Procedural language implementations usually have hardcoded knowledge of the built\-in types, so those don\*(Aqt need to be listed here\&. If a procedural language implementation does not know how to handle a type and no transform is supplied, it will fall back to a default behavior for converting data types, but this depends on the implementation\&.
.RE
.PP
WINDOW
.RS 4
WINDOW
indicates that the function is a
window function
rather than a plain function\&. This is currently only useful for functions written in C\&. The
WINDOW
attribute cannot be changed when replacing an existing function definition\&.
.RE
.PP
IMMUTABLE
.br
STABLE
.br
VOLATILE
.RS 4
These attributes inform the query optimizer about the behavior of the function\&. At most one choice can be specified\&. If none of these appear,
VOLATILE
is the default assumption\&.
.sp
IMMUTABLE
indicates that the function cannot modify the database and always returns the same result when given the same argument values; that is, it does not do database lookups or otherwise use information not directly present in its argument list\&. If this option is given, any call of the function with all\-constant arguments can be immediately replaced with the function value\&.
.sp
STABLE
indicates that the function cannot modify the database, and that within a single table scan it will consistently return the same result for the same argument values, but that its result could change across SQL statements\&. This is the appropriate selection for functions whose results depend on database lookups, parameter variables (such as the current time zone), etc\&. (It is inappropriate for
AFTER
triggers that wish to query rows modified by the current command\&.) Also note that the
\fBcurrent_timestamp\fR
family of functions qualify as stable, since their values do not change within a transaction\&.
.sp
VOLATILE
indicates that the function value can change even within a single table scan, so no optimizations can be made\&. Relatively few database functions are volatile in this sense; some examples are
random(),
currval(),
timeofday()\&. But note that any function that has side\-effects must be classified volatile, even if its result is quite predictable, to prevent calls from being optimized away; an example is
setval()\&.
.sp
For additional details see
Section 36.6, \(lqFunction Volatility Categories\(rq, in the documentation\&.
.RE
.PP
LEAKPROOF
.RS 4
LEAKPROOF
indicates that the function has no side effects\&. It reveals no information about its arguments other than by its return value\&. For example, a function which throws an error message for some argument values but not others, or which includes the argument values in any error message, is not leakproof\&. This affects how the system executes queries against views created with the
security_barrier
option or tables with row level security enabled\&. The system will enforce conditions from security policies and security barrier views before any user\-supplied conditions from the query itself that contain non\-leakproof functions, in order to prevent the inadvertent exposure of data\&. Functions and operators marked as leakproof are assumed to be trustworthy, and may be executed before conditions from security policies and security barrier views\&. In addition, functions which do not take arguments or which are not passed any arguments from the security barrier view or table do not have to be marked as leakproof to be executed before security conditions\&. See
CREATE VIEW (\fBCREATE_VIEW\fR(7))
and
Section 39.5, \(lqRules and Privileges\(rq, in the documentation\&. This option can only be set by the superuser\&.
.RE
.PP
CALLED ON NULL INPUT
.br
RETURNS NULL ON NULL INPUT
.br
STRICT
.RS 4
CALLED ON NULL INPUT
(the default) indicates that the function will be called normally when some of its arguments are null\&. It is then the function author\*(Aqs responsibility to check for null values if necessary and respond appropriately\&.
.sp
RETURNS NULL ON NULL INPUT
or
STRICT
indicates that the function always returns null whenever any of its arguments are null\&. If this parameter is specified, the function is not executed when there are null arguments; instead a null result is assumed automatically\&.
.RE
.PP
[EXTERNAL] SECURITY INVOKER
.br
[EXTERNAL] SECURITY DEFINER
.RS 4
SECURITY INVOKER
indicates that the function is to be executed with the privileges of the user that calls it\&. That is the default\&.
SECURITY DEFINER
specifies that the function is to be executed with the privileges of the user that created it\&.
.sp
The key word
EXTERNAL
is allowed for SQL conformance, but it is optional since, unlike in SQL, this feature applies to all functions not only external ones\&.
.RE
.PP
PARALLEL
.RS 4
PARALLEL UNSAFE
indicates that the function can\*(Aqt be executed in parallel mode and the presence of such a function in an SQL statement forces a serial execution plan\&. This is the default\&.
PARALLEL RESTRICTED
indicates that the function can be executed in parallel mode, but the execution is restricted to parallel group leader\&.
PARALLEL SAFE
indicates that the function is safe to run in parallel mode without restriction\&.
.sp
Functions should be labeled parallel unsafe if they modify any database state, or if they make changes to the transaction such as using sub\-transactions, or if they access sequences or attempt to make persistent changes to settings (e\&.g\&.,
setval)\&. They should be labeled as parallel restricted if they access temporary tables, client connection state, cursors, prepared statements, or miscellaneous backend\-local state which the system cannot synchronize in parallel mode (e\&.g\&.,
setseed
cannot be executed other than by the group leader because a change made by another process would not be reflected in the leader)\&. In general, if a function is labeled as being safe when it is restricted or unsafe, or if it is labeled as being restricted when it is in fact unsafe, it may throw errors or produce wrong answers when used in a parallel query\&. C\-language functions could in theory exhibit totally undefined behavior if mislabeled, since there is no way for the system to protect itself against arbitrary C code, but in most likely cases the result will be no worse than for any other function\&. If in doubt, functions should be labeled as
UNSAFE, which is the default\&.
.RE
.PP
\fIexecution_cost\fR
.RS 4
A positive number giving the estimated execution cost for the function, in units of
cpu_operator_cost\&. If the function returns a set, this is the cost per returned row\&. If the cost is not specified, 1 unit is assumed for C\-language and internal functions, and 100 units for functions in all other languages\&. Larger values cause the planner to try to avoid evaluating the function more often than necessary\&.
.RE
.PP
\fIresult_rows\fR
.RS 4
A positive number giving the estimated number of rows that the planner should expect the function to return\&. This is only allowed when the function is declared to return a set\&. The default assumption is 1000 rows\&.
.RE
.PP
\fIconfiguration_parameter\fR
.br
\fIvalue\fR
.RS 4
The
SET
clause causes the specified configuration parameter to be set to the specified value when the function is entered, and then restored to its prior value when the function exits\&.
SET FROM CURRENT
saves the value of the parameter that is current when
\fBCREATE FUNCTION\fR
is executed as the value to be applied when the function is entered\&.
.sp
If a
SET
clause is attached to a function, then the effects of a
\fBSET LOCAL\fR
command executed inside the function for the same variable are restricted to the function: the configuration parameter\*(Aqs prior value is still restored at function exit\&. However, an ordinary
\fBSET\fR
command (without
LOCAL) overrides the
SET
clause, much as it would do for a previous
\fBSET LOCAL\fR
command: the effects of such a command will persist after function exit, unless the current transaction is rolled back\&.
.sp
See
\fBSET\fR(7)
and
Chapter 19, Server Configuration, in the documentation
for more information about allowed parameter names and values\&.
.RE
.PP
\fIdefinition\fR
.RS 4
A string constant defining the function; the meaning depends on the language\&. It can be an internal function name, the path to an object file, an SQL command, or text in a procedural language\&.
.sp
It is often helpful to use dollar quoting (see
Section 4.1.2.4, \(lqDollar-quoted String Constants\(rq, in the documentation) to write the function definition string, rather than the normal single quote syntax\&. Without dollar quoting, any single quotes or backslashes in the function definition must be escaped by doubling them\&.
.RE
.PP
\fIobj_file\fR, \fIlink_symbol\fR
.RS 4
This form of the
AS
clause is used for dynamically loadable C language functions when the function name in the C language source code is not the same as the name of the SQL function\&. The string
\fIobj_file\fR
is the name of the file containing the dynamically loadable object, and
\fIlink_symbol\fR
is the function\*(Aqs link symbol, that is, the name of the function in the C language source code\&. If the link symbol is omitted, it is assumed to be the same as the name of the SQL function being defined\&. The C names of all functions must be different, so you must give overloaded C functions different C names (for example, use the argument types as part of the C names)\&.
.sp
When repeated
\fBCREATE FUNCTION\fR
calls refer to the same object file, the file is only loaded once per session\&. To unload and reload the file (perhaps during development), start a new session\&.
.RE
.PP
\fIattribute\fR
.RS 4
The historical way to specify optional pieces of information about the function\&. The following attributes can appear here:
.PP
isStrict
.RS 4
Equivalent to
STRICT
or
RETURNS NULL ON NULL INPUT\&.
.RE
.PP
isCachable
.RS 4
isCachable
is an obsolete equivalent of
IMMUTABLE; it\*(Aqs still accepted for backwards\-compatibility reasons\&.
.RE
.sp
Attribute names are not case\-sensitive\&.
.RE
.PP
Refer to
Section 36.3, \(lqUser-defined Functions\(rq, in the documentation
for further information on writing functions\&.
.SH "OVERLOADING"
.PP
PostgreSQL
allows function
overloading; that is, the same name can be used for several different functions so long as they have distinct input argument types\&. Whether or not you use it, this capability entails security precautions when calling functions in databases where some users mistrust other users; see
Section 10.3, \(lqFunctions\(rq, in the documentation\&.
.PP
Two functions are considered the same if they have the same names and
\fIinput\fR
argument types, ignoring any
OUT
parameters\&. Thus for example these declarations conflict:
.sp
.if n \{\
.RS 4
.\}
.nf
CREATE FUNCTION foo(int) \&.\&.\&.
CREATE FUNCTION foo(int, out text) \&.\&.\&.
.fi
.if n \{\
.RE
.\}
.PP
Functions that have different argument type lists will not be considered to conflict at creation time, but if defaults are provided they might conflict in use\&. For example, consider
.sp
.if n \{\
.RS 4
.\}
.nf
CREATE FUNCTION foo(int) \&.\&.\&.
CREATE FUNCTION foo(int, int default 42) \&.\&.\&.
.fi
.if n \{\
.RE
.\}
.sp
A call
foo(10)
will fail due to the ambiguity about which function should be called\&.
.SH "NOTES"
.PP
The full
SQL
type syntax is allowed for declaring a function\*(Aqs arguments and return value\&. However, parenthesized type modifiers (e\&.g\&., the precision field for type
numeric) are discarded by
\fBCREATE FUNCTION\fR\&. Thus for example
CREATE FUNCTION foo (varchar(10)) \&.\&.\&.
is exactly the same as
CREATE FUNCTION foo (varchar) \&.\&.\&.\&.
.PP
When replacing an existing function with
\fBCREATE OR REPLACE FUNCTION\fR, there are restrictions on changing parameter names\&. You cannot change the name already assigned to any input parameter (although you can add names to parameters that had none before)\&. If there is more than one output parameter, you cannot change the names of the output parameters, because that would change the column names of the anonymous composite type that describes the function\*(Aqs result\&. These restrictions are made to ensure that existing calls of the function do not stop working when it is replaced\&.
.PP
If a function is declared
STRICT
with a
VARIADIC
argument, the strictness check tests that the variadic array
\fIas a whole\fR
is non\-null\&. The function will still be called if the array has null elements\&.
.SH "EXAMPLES"
.PP
Here are some trivial examples to help you get started\&. For more information and examples, see
Section 36.3, \(lqUser-defined Functions\(rq, in the documentation\&.
.sp
.if n \{\
.RS 4
.\}
.nf
CREATE FUNCTION add(integer, integer) RETURNS integer
AS \*(Aqselect $1 + $2;\*(Aq
LANGUAGE SQL
IMMUTABLE
RETURNS NULL ON NULL INPUT;
.fi
.if n \{\
.RE
.\}
.PP
Increment an integer, making use of an argument name, in
PL/pgSQL:
.sp
.if n \{\
.RS 4
.\}
.nf
CREATE OR REPLACE FUNCTION increment(i integer) RETURNS integer AS $$
BEGIN
RETURN i + 1;
END;
$$ LANGUAGE plpgsql;
.fi
.if n \{\
.RE
.\}
.PP
Return a record containing multiple output parameters:
.sp
.if n \{\
.RS 4
.\}
.nf
CREATE FUNCTION dup(in int, out f1 int, out f2 text)
AS $$ SELECT $1, CAST($1 AS text) || \*(Aq is text\*(Aq $$
LANGUAGE SQL;
SELECT * FROM dup(42);
.fi
.if n \{\
.RE
.\}
.sp
You can do the same thing more verbosely with an explicitly named composite type:
.sp
.if n \{\
.RS 4
.\}
.nf
CREATE TYPE dup_result AS (f1 int, f2 text);
CREATE FUNCTION dup(int) RETURNS dup_result
AS $$ SELECT $1, CAST($1 AS text) || \*(Aq is text\*(Aq $$
LANGUAGE SQL;
SELECT * FROM dup(42);
.fi
.if n \{\
.RE
.\}
.sp
Another way to return multiple columns is to use a
TABLE
function:
.sp
.if n \{\
.RS 4
.\}
.nf
CREATE FUNCTION dup(int) RETURNS TABLE(f1 int, f2 text)
AS $$ SELECT $1, CAST($1 AS text) || \*(Aq is text\*(Aq $$
LANGUAGE SQL;
SELECT * FROM dup(42);
.fi
.if n \{\
.RE
.\}
.sp
However, a
TABLE
function is different from the preceding examples, because it actually returns a
\fIset\fR
of records, not just one record\&.
.SH "WRITING SECURITY DEFINER FUNCTIONS SAFELY"
.PP
Because a
SECURITY DEFINER
function is executed with the privileges of the user that created it, care is needed to ensure that the function cannot be misused\&. For security,
search_path
should be set to exclude any schemas writable by untrusted users\&. This prevents malicious users from creating objects (e\&.g\&., tables, functions, and operators) that mask objects intended to be used by the function\&. Particularly important in this regard is the temporary\-table schema, which is searched first by default, and is normally writable by anyone\&. A secure arrangement can be obtained by forcing the temporary schema to be searched last\&. To do this, write
pg_temp
as the last entry in
\fIsearch_path\fR\&. This function illustrates safe usage:
.sp
.if n \{\
.RS 4
.\}
.nf
CREATE FUNCTION check_password(uname TEXT, pass TEXT)
RETURNS BOOLEAN AS $$
DECLARE passed BOOLEAN;
BEGIN
SELECT (pwd = $2) INTO passed
FROM pwds
WHERE username = $1;
RETURN passed;
END;
$$ LANGUAGE plpgsql
SECURITY DEFINER
\-\- Set a secure search_path: trusted schema(s), then \*(Aqpg_temp\*(Aq\&.
SET search_path = admin, pg_temp;
.fi
.if n \{\
.RE
.\}
.sp
This function\*(Aqs intention is to access a table
admin\&.pwds\&. But without the
SET
clause, or with a
SET
clause mentioning only
admin, the function could be subverted by creating a temporary table named
pwds\&.
.PP
Before
PostgreSQL
version 8\&.3, the
SET
clause was not available, and so older functions may contain rather complicated logic to save, set, and restore
\fIsearch_path\fR\&. The
SET
clause is far easier to use for this purpose\&.
.PP
Another point to keep in mind is that by default, execute privilege is granted to
PUBLIC
for newly created functions (see
\fBGRANT\fR(7)
for more information)\&. Frequently you will wish to restrict use of a security definer function to only some users\&. To do that, you must revoke the default
PUBLIC
privileges and then grant execute privilege selectively\&. To avoid having a window where the new function is accessible to all, create it and set the privileges within a single transaction\&. For example:
.sp
.if n \{\
.RS 4
.\}
.nf
BEGIN;
CREATE FUNCTION check_password(uname TEXT, pass TEXT) \&.\&.\&. SECURITY DEFINER;
REVOKE ALL ON FUNCTION check_password(uname TEXT, pass TEXT) FROM PUBLIC;
GRANT EXECUTE ON FUNCTION check_password(uname TEXT, pass TEXT) TO admins;
COMMIT;
.fi
.if n \{\
.RE
.\}
.SH "COMPATIBILITY"
.PP
A
\fBCREATE FUNCTION\fR
command is defined in SQL:1999 and later\&. The
PostgreSQL
version is similar but not fully compatible\&. The attributes are not portable, neither are the different available languages\&.
.PP
For compatibility with some other database systems,
\fIargmode\fR
can be written either before or after
\fIargname\fR\&. But only the first way is standard\-compliant\&.
.PP
For parameter defaults, the SQL standard specifies only the syntax with the
DEFAULT
key word\&. The syntax with
=
is used in T\-SQL and Firebird\&.
.SH "SEE ALSO"
ALTER FUNCTION (\fBALTER_FUNCTION\fR(7)), DROP FUNCTION (\fBDROP_FUNCTION\fR(7)), \fBGRANT\fR(7), \fBLOAD\fR(7), \fBREVOKE\fR(7), \fBcreatelang\fR(1)
man/man7/CREATE_TRIGGER.7 0000644 00000041012 14751153421 0010400 0 ustar 00 '\" t
.\" Title: CREATE TRIGGER
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "CREATE TRIGGER" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
CREATE_TRIGGER \- define a new trigger
.SH "SYNOPSIS"
.sp
.nf
CREATE [ CONSTRAINT ] TRIGGER \fIname\fR { BEFORE | AFTER | INSTEAD OF } { \fIevent\fR [ OR \&.\&.\&. ] }
ON \fItable_name\fR
[ FROM \fIreferenced_table_name\fR ]
[ NOT DEFERRABLE | [ DEFERRABLE ] [ INITIALLY IMMEDIATE | INITIALLY DEFERRED ] ]
[ FOR [ EACH ] { ROW | STATEMENT } ]
[ WHEN ( \fIcondition\fR ) ]
EXECUTE PROCEDURE \fIfunction_name\fR ( \fIarguments\fR )
where \fIevent\fR can be one of:
INSERT
UPDATE [ OF \fIcolumn_name\fR [, \&.\&.\&. ] ]
DELETE
TRUNCATE
.fi
.SH "DESCRIPTION"
.PP
\fBCREATE TRIGGER\fR
creates a new trigger\&. The trigger will be associated with the specified table, view, or foreign table and will execute the specified function
\fIfunction_name\fR
when certain events occur\&.
.PP
The trigger can be specified to fire before the operation is attempted on a row (before constraints are checked and the
\fBINSERT\fR,
\fBUPDATE\fR, or
\fBDELETE\fR
is attempted); or after the operation has completed (after constraints are checked and the
\fBINSERT\fR,
\fBUPDATE\fR, or
\fBDELETE\fR
has completed); or instead of the operation (in the case of inserts, updates or deletes on a view)\&. If the trigger fires before or instead of the event, the trigger can skip the operation for the current row, or change the row being inserted (for
\fBINSERT\fR
and
\fBUPDATE\fR
operations only)\&. If the trigger fires after the event, all changes, including the effects of other triggers, are
\(lqvisible\(rq
to the trigger\&.
.PP
A trigger that is marked
FOR EACH ROW
is called once for every row that the operation modifies\&. For example, a
\fBDELETE\fR
that affects 10 rows will cause any
ON DELETE
triggers on the target relation to be called 10 separate times, once for each deleted row\&. In contrast, a trigger that is marked
FOR EACH STATEMENT
only executes once for any given operation, regardless of how many rows it modifies (in particular, an operation that modifies zero rows will still result in the execution of any applicable
FOR EACH STATEMENT
triggers)\&. Note that with an
\fBINSERT\fR
with an
ON CONFLICT DO UPDATE
clause, both
\fBINSERT\fR
and
\fBUPDATE\fR
statement level trigger will be fired\&.
.PP
Triggers that are specified to fire
INSTEAD OF
the trigger event must be marked
FOR EACH ROW, and can only be defined on views\&.
BEFORE
and
AFTER
triggers on a view must be marked as
FOR EACH STATEMENT\&.
.PP
In addition, triggers may be defined to fire for
\fBTRUNCATE\fR, though only
FOR EACH STATEMENT\&.
.PP
The following table summarizes which types of triggers may be used on tables, views, and foreign tables:
.TS
allbox tab(:);
lB lB lB lB.
T{
When
T}:T{
Event
T}:T{
Row\-level
T}:T{
Statement\-level
T}
.T&
c c c c
^ c c c
c c c c
^ c c c
c c c c
^ c c c.
T{
BEFORE
T}:T{
\fBINSERT\fR/\fBUPDATE\fR/\fBDELETE\fR
T}:T{
Tables and foreign tables
T}:T{
Tables, views, and foreign tables
T}
:T{
\fBTRUNCATE\fR
T}:T{
\(em
T}:T{
Tables
T}
T{
AFTER
T}:T{
\fBINSERT\fR/\fBUPDATE\fR/\fBDELETE\fR
T}:T{
Tables and foreign tables
T}:T{
Tables, views, and foreign tables
T}
:T{
\fBTRUNCATE\fR
T}:T{
\(em
T}:T{
Tables
T}
T{
INSTEAD OF
T}:T{
\fBINSERT\fR/\fBUPDATE\fR/\fBDELETE\fR
T}:T{
Views
T}:T{
\(em
T}
:T{
\fBTRUNCATE\fR
T}:T{
\(em
T}:T{
\(em
T}
.TE
.sp 1
.PP
Also, a trigger definition can specify a Boolean
WHEN
condition, which will be tested to see whether the trigger should be fired\&. In row\-level triggers the
WHEN
condition can examine the old and/or new values of columns of the row\&. Statement\-level triggers can also have
WHEN
conditions, although the feature is not so useful for them since the condition cannot refer to any values in the table\&.
.PP
If multiple triggers of the same kind are defined for the same event, they will be fired in alphabetical order by name\&.
.PP
When the
CONSTRAINT
option is specified, this command creates a
constraint trigger\&. This is the same as a regular trigger except that the timing of the trigger firing can be adjusted using
SET CONSTRAINTS (\fBSET_CONSTRAINTS\fR(7))\&. Constraint triggers must be
AFTER ROW
triggers on tables\&. They can be fired either at the end of the statement causing the triggering event, or at the end of the containing transaction; in the latter case they are said to be
deferred\&. A pending deferred\-trigger firing can also be forced to happen immediately by using
\fBSET CONSTRAINTS\fR\&. Constraint triggers are expected to raise an exception when the constraints they implement are violated\&.
.PP
\fBSELECT\fR
does not modify any rows so you cannot create
\fBSELECT\fR
triggers\&. Rules and views are more appropriate in such cases\&.
.PP
Refer to
Chapter 37, Triggers, in the documentation
for more information about triggers\&.
.SH "PARAMETERS"
.PP
\fIname\fR
.RS 4
The name to give the new trigger\&. This must be distinct from the name of any other trigger for the same table\&. The name cannot be schema\-qualified \(em the trigger inherits the schema of its table\&. For a constraint trigger, this is also the name to use when modifying the trigger\*(Aqs behavior using
\fBSET CONSTRAINTS\fR\&.
.RE
.PP
BEFORE
.br
AFTER
.br
INSTEAD OF
.RS 4
Determines whether the function is called before, after, or instead of the event\&. A constraint trigger can only be specified as
AFTER\&.
.RE
.PP
\fIevent\fR
.RS 4
One of
INSERT,
UPDATE,
DELETE, or
TRUNCATE; this specifies the event that will fire the trigger\&. Multiple events can be specified using
OR\&.
.sp
For
UPDATE
events, it is possible to specify a list of columns using this syntax:
.sp
.if n \{\
.RS 4
.\}
.nf
UPDATE OF \fIcolumn_name1\fR [, \fIcolumn_name2\fR \&.\&.\&. ]
.fi
.if n \{\
.RE
.\}
.sp
The trigger will only fire if at least one of the listed columns is mentioned as a target of the
\fBUPDATE\fR
command\&.
.sp
INSTEAD OF UPDATE
events do not support lists of columns\&.
.RE
.PP
\fItable_name\fR
.RS 4
The name (optionally schema\-qualified) of the table, view, or foreign table the trigger is for\&.
.RE
.PP
\fIreferenced_table_name\fR
.RS 4
The (possibly schema\-qualified) name of another table referenced by the constraint\&. This option is used for foreign\-key constraints and is not recommended for general use\&. This can only be specified for constraint triggers\&.
.RE
.PP
DEFERRABLE
.br
NOT DEFERRABLE
.br
INITIALLY IMMEDIATE
.br
INITIALLY DEFERRED
.RS 4
The default timing of the trigger\&. See the
CREATE TABLE (\fBCREATE_TABLE\fR(7))
documentation for details of these constraint options\&. This can only be specified for constraint triggers\&.
.RE
.PP
FOR EACH ROW
.br
FOR EACH STATEMENT
.RS 4
This specifies whether the trigger procedure should be fired once for every row affected by the trigger event, or just once per SQL statement\&. If neither is specified,
FOR EACH STATEMENT
is the default\&. Constraint triggers can only be specified
FOR EACH ROW\&.
.RE
.PP
\fIcondition\fR
.RS 4
A Boolean expression that determines whether the trigger function will actually be executed\&. If
WHEN
is specified, the function will only be called if the
\fIcondition\fR
returns
true\&. In
FOR EACH ROW
triggers, the
WHEN
condition can refer to columns of the old and/or new row values by writing
OLD\&.\fIcolumn_name\fR
or
NEW\&.\fIcolumn_name\fR
respectively\&. Of course,
INSERT
triggers cannot refer to
OLD
and
DELETE
triggers cannot refer to
NEW\&.
.sp
INSTEAD OF
triggers do not support
WHEN
conditions\&.
.sp
Currently,
WHEN
expressions cannot contain subqueries\&.
.sp
Note that for constraint triggers, evaluation of the
WHEN
condition is not deferred, but occurs immediately after the row update operation is performed\&. If the condition does not evaluate to true then the trigger is not queued for deferred execution\&.
.RE
.PP
\fIfunction_name\fR
.RS 4
A user\-supplied function that is declared as taking no arguments and returning type
trigger, which is executed when the trigger fires\&.
.RE
.PP
\fIarguments\fR
.RS 4
An optional comma\-separated list of arguments to be provided to the function when the trigger is executed\&. The arguments are literal string constants\&. Simple names and numeric constants can be written here, too, but they will all be converted to strings\&. Please check the description of the implementation language of the trigger function to find out how these arguments can be accessed within the function; it might be different from normal function arguments\&.
.RE
.SH "NOTES"
.PP
To create a trigger on a table, the user must have the
TRIGGER
privilege on the table\&. The user must also have
EXECUTE
privilege on the trigger function\&.
.PP
Use
DROP TRIGGER (\fBDROP_TRIGGER\fR(7))
to remove a trigger\&.
.PP
A column\-specific trigger (one defined using the
UPDATE OF \fIcolumn_name\fR
syntax) will fire when any of its columns are listed as targets in the
\fBUPDATE\fR
command\*(Aqs
SET
list\&. It is possible for a column\*(Aqs value to change even when the trigger is not fired, because changes made to the row\*(Aqs contents by
BEFORE UPDATE
triggers are not considered\&. Conversely, a command such as
UPDATE \&.\&.\&. SET x = x \&.\&.\&.
will fire a trigger on column
x, even though the column\*(Aqs value did not change\&.
.PP
There are a few built\-in trigger functions that can be used to solve common problems without having to write your own trigger code; see
Section 9.27, \(lqTrigger Functions\(rq, in the documentation\&.
.PP
In a
BEFORE
trigger, the
WHEN
condition is evaluated just before the function is or would be executed, so using
WHEN
is not materially different from testing the same condition at the beginning of the trigger function\&. Note in particular that the
NEW
row seen by the condition is the current value, as possibly modified by earlier triggers\&. Also, a
BEFORE
trigger\*(Aqs
WHEN
condition is not allowed to examine the system columns of the
NEW
row (such as
oid), because those won\*(Aqt have been set yet\&.
.PP
In an
AFTER
trigger, the
WHEN
condition is evaluated just after the row update occurs, and it determines whether an event is queued to fire the trigger at the end of statement\&. So when an
AFTER
trigger\*(Aqs
WHEN
condition does not return true, it is not necessary to queue an event nor to re\-fetch the row at end of statement\&. This can result in significant speedups in statements that modify many rows, if the trigger only needs to be fired for a few of the rows\&.
.PP
Statement\-level triggers on a view are fired only if the action on the view is handled by a row\-level
INSTEAD OF
trigger\&. If the action is handled by an
INSTEAD
rule, then whatever statements are emitted by the rule are executed in place of the original statement naming the view, so that the triggers that will be fired are those on tables named in the replacement statements\&. Similarly, if the view is automatically updatable, then the action is handled by automatically rewriting the statement into an action on the view\*(Aqs base table, so that the base table\*(Aqs statement\-level triggers are the ones that are fired\&.
.PP
In
PostgreSQL
versions before 7\&.3, it was necessary to declare trigger functions as returning the placeholder type
opaque, rather than
trigger\&. To support loading of old dump files,
\fBCREATE TRIGGER\fR
will accept a function declared as returning
opaque, but it will issue a notice and change the function\*(Aqs declared return type to
trigger\&.
.SH "EXAMPLES"
.PP
Execute the function
\fBcheck_account_update\fR
whenever a row of the table
accounts
is about to be updated:
.sp
.if n \{\
.RS 4
.\}
.nf
CREATE TRIGGER check_update
BEFORE UPDATE ON accounts
FOR EACH ROW
EXECUTE PROCEDURE check_account_update();
.fi
.if n \{\
.RE
.\}
.sp
The same, but only execute the function if column
balance
is specified as a target in the
\fBUPDATE\fR
command:
.sp
.if n \{\
.RS 4
.\}
.nf
CREATE TRIGGER check_update
BEFORE UPDATE OF balance ON accounts
FOR EACH ROW
EXECUTE PROCEDURE check_account_update();
.fi
.if n \{\
.RE
.\}
.sp
This form only executes the function if column
balance
has in fact changed value:
.sp
.if n \{\
.RS 4
.\}
.nf
CREATE TRIGGER check_update
BEFORE UPDATE ON accounts
FOR EACH ROW
WHEN (OLD\&.balance IS DISTINCT FROM NEW\&.balance)
EXECUTE PROCEDURE check_account_update();
.fi
.if n \{\
.RE
.\}
.sp
Call a function to log updates of
accounts, but only if something changed:
.sp
.if n \{\
.RS 4
.\}
.nf
CREATE TRIGGER log_update
AFTER UPDATE ON accounts
FOR EACH ROW
WHEN (OLD\&.* IS DISTINCT FROM NEW\&.*)
EXECUTE PROCEDURE log_account_update();
.fi
.if n \{\
.RE
.\}
.sp
Execute the function
\fBview_insert_row\fR
for each row to insert rows into the tables underlying a view:
.sp
.if n \{\
.RS 4
.\}
.nf
CREATE TRIGGER view_insert
INSTEAD OF INSERT ON my_view
FOR EACH ROW
EXECUTE PROCEDURE view_insert_row();
.fi
.if n \{\
.RE
.\}
.PP
Section 37.4, \(lqA Complete Trigger Example\(rq, in the documentation
contains a complete example of a trigger function written in C\&.
.SH "COMPATIBILITY"
.PP
The
\fBCREATE TRIGGER\fR
statement in
PostgreSQL
implements a subset of the
SQL
standard\&. The following functionalities are currently missing:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
SQL allows you to define aliases for the
\(lqold\(rq
and
\(lqnew\(rq
rows or tables for use in the definition of the triggered action (e\&.g\&.,
CREATE TRIGGER \&.\&.\&. ON tablename REFERENCING OLD ROW AS somename NEW ROW AS othername \&.\&.\&.)\&. Since
PostgreSQL
allows trigger procedures to be written in any number of user\-defined languages, access to the data is handled in a language\-specific way\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
PostgreSQL
does not allow the old and new tables to be referenced in statement\-level triggers, i\&.e\&., the tables that contain all the old and/or new rows, which are referred to by the
OLD TABLE
and
NEW TABLE
clauses in the
SQL
standard\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
PostgreSQL
only allows the execution of a user\-defined function for the triggered action\&. The standard allows the execution of a number of other SQL commands, such as
\fBCREATE TABLE\fR, as the triggered action\&. This limitation is not hard to work around by creating a user\-defined function that executes the desired commands\&.
.RE
.PP
SQL specifies that multiple triggers should be fired in time\-of\-creation order\&.
PostgreSQL
uses name order, which was judged to be more convenient\&.
.PP
SQL specifies that
BEFORE DELETE
triggers on cascaded deletes fire
\fIafter\fR
the cascaded
DELETE
completes\&. The
PostgreSQL
behavior is for
BEFORE DELETE
to always fire before the delete action, even a cascading one\&. This is considered more consistent\&. There is also nonstandard behavior if
BEFORE
triggers modify rows or prevent updates during an update that is caused by a referential action\&. This can lead to constraint violations or stored data that does not honor the referential constraint\&.
.PP
The ability to specify multiple actions for a single trigger using
OR
is a
PostgreSQL
extension of the SQL standard\&.
.PP
The ability to fire triggers for
\fBTRUNCATE\fR
is a
PostgreSQL
extension of the SQL standard, as is the ability to define statement\-level triggers on views\&.
.PP
\fBCREATE CONSTRAINT TRIGGER\fR
is a
PostgreSQL
extension of the
SQL
standard\&.
.SH "SEE ALSO"
ALTER TRIGGER (\fBALTER_TRIGGER\fR(7)), DROP TRIGGER (\fBDROP_TRIGGER\fR(7)), CREATE FUNCTION (\fBCREATE_FUNCTION\fR(7)), SET CONSTRAINTS (\fBSET_CONSTRAINTS\fR(7))
man/man7/CREATE_TYPE.7 0000644 00000072211 14751153421 0010063 0 ustar 00 '\" t
.\" Title: CREATE TYPE
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "CREATE TYPE" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
CREATE_TYPE \- define a new data type
.SH "SYNOPSIS"
.sp
.nf
CREATE TYPE \fIname\fR AS
( [ \fIattribute_name\fR \fIdata_type\fR [ COLLATE \fIcollation\fR ] [, \&.\&.\&. ] ] )
CREATE TYPE \fIname\fR AS ENUM
( [ \*(Aq\fIlabel\fR\*(Aq [, \&.\&.\&. ] ] )
CREATE TYPE \fIname\fR AS RANGE (
SUBTYPE = \fIsubtype\fR
[ , SUBTYPE_OPCLASS = \fIsubtype_operator_class\fR ]
[ , COLLATION = \fIcollation\fR ]
[ , CANONICAL = \fIcanonical_function\fR ]
[ , SUBTYPE_DIFF = \fIsubtype_diff_function\fR ]
)
CREATE TYPE \fIname\fR (
INPUT = \fIinput_function\fR,
OUTPUT = \fIoutput_function\fR
[ , RECEIVE = \fIreceive_function\fR ]
[ , SEND = \fIsend_function\fR ]
[ , TYPMOD_IN = \fItype_modifier_input_function\fR ]
[ , TYPMOD_OUT = \fItype_modifier_output_function\fR ]
[ , ANALYZE = \fIanalyze_function\fR ]
[ , INTERNALLENGTH = { \fIinternallength\fR | VARIABLE } ]
[ , PASSEDBYVALUE ]
[ , ALIGNMENT = \fIalignment\fR ]
[ , STORAGE = \fIstorage\fR ]
[ , LIKE = \fIlike_type\fR ]
[ , CATEGORY = \fIcategory\fR ]
[ , PREFERRED = \fIpreferred\fR ]
[ , DEFAULT = \fIdefault\fR ]
[ , ELEMENT = \fIelement\fR ]
[ , DELIMITER = \fIdelimiter\fR ]
[ , COLLATABLE = \fIcollatable\fR ]
)
CREATE TYPE \fIname\fR
.fi
.SH "DESCRIPTION"
.PP
\fBCREATE TYPE\fR
registers a new data type for use in the current database\&. The user who defines a type becomes its owner\&.
.PP
If a schema name is given then the type is created in the specified schema\&. Otherwise it is created in the current schema\&. The type name must be distinct from the name of any existing type or domain in the same schema\&. (Because tables have associated data types, the type name must also be distinct from the name of any existing table in the same schema\&.)
.PP
There are five forms of
\fBCREATE TYPE\fR, as shown in the syntax synopsis above\&. They respectively create a
composite type, an
enum type, a
range type, a
base type, or a
shell type\&. The first four of these are discussed in turn below\&. A shell type is simply a placeholder for a type to be defined later; it is created by issuing
\fBCREATE TYPE\fR
with no parameters except for the type name\&. Shell types are needed as forward references when creating range types and base types, as discussed in those sections\&.
.SS "Composite Types"
.PP
The first form of
\fBCREATE TYPE\fR
creates a composite type\&. The composite type is specified by a list of attribute names and data types\&. An attribute\*(Aqs collation can be specified too, if its data type is collatable\&. A composite type is essentially the same as the row type of a table, but using
\fBCREATE TYPE\fR
avoids the need to create an actual table when all that is wanted is to define a type\&. A stand\-alone composite type is useful, for example, as the argument or return type of a function\&.
.PP
To be able to create a composite type, you must have
USAGE
privilege on all attribute types\&.
.SS "Enumerated Types"
.PP
The second form of
\fBCREATE TYPE\fR
creates an enumerated (enum) type, as described in
Section 8.7, \(lqEnumerated Types\(rq, in the documentation\&. Enum types take a list of quoted labels, each of which must be less than
NAMEDATALEN
bytes long (64 bytes in a standard
PostgreSQL
build)\&. (It is possible to create an enumerated type with zero labels, but such a type cannot be used to hold values before at least one label is added using
ALTER TYPE (\fBALTER_TYPE\fR(7))\&.)
.SS "Range Types"
.PP
The third form of
\fBCREATE TYPE\fR
creates a new range type, as described in
Section 8.17, \(lqRange Types\(rq, in the documentation\&.
.PP
The range type\*(Aqs
\fIsubtype\fR
can be any type with an associated b\-tree operator class (to determine the ordering of values for the range type)\&. Normally the subtype\*(Aqs default b\-tree operator class is used to determine ordering; to use a non\-default operator class, specify its name with
\fIsubtype_opclass\fR\&. If the subtype is collatable, and you want to use a non\-default collation in the range\*(Aqs ordering, specify the desired collation with the
\fIcollation\fR
option\&.
.PP
The optional
\fIcanonical\fR
function must take one argument of the range type being defined, and return a value of the same type\&. This is used to convert range values to a canonical form, when applicable\&. See
Section 8.17.8, \(lqDefining New Range Types\(rq, in the documentation
for more information\&. Creating a
\fIcanonical\fR
function is a bit tricky, since it must be defined before the range type can be declared\&. To do this, you must first create a shell type, which is a placeholder type that has no properties except a name and an owner\&. This is done by issuing the command
CREATE TYPE \fIname\fR, with no additional parameters\&. Then the function can be declared using the shell type as argument and result, and finally the range type can be declared using the same name\&. This automatically replaces the shell type entry with a valid range type\&.
.PP
The optional
\fIsubtype_diff\fR
function must take two values of the
\fIsubtype\fR
type as argument, and return a
double precision
value representing the difference between the two given values\&. While this is optional, providing it allows much greater efficiency of GiST indexes on columns of the range type\&. See
Section 8.17.8, \(lqDefining New Range Types\(rq, in the documentation
for more information\&.
.SS "Base Types"
.PP
The fourth form of
\fBCREATE TYPE\fR
creates a new base type (scalar type)\&. To create a new base type, you must be a superuser\&. (This restriction is made because an erroneous type definition could confuse or even crash the server\&.)
.PP
The parameters can appear in any order, not only that illustrated above, and most are optional\&. You must register two or more functions (using
\fBCREATE FUNCTION\fR) before defining the type\&. The support functions
\fIinput_function\fR
and
\fIoutput_function\fR
are required, while the functions
\fIreceive_function\fR,
\fIsend_function\fR,
\fItype_modifier_input_function\fR,
\fItype_modifier_output_function\fR
and
\fIanalyze_function\fR
are optional\&. Generally these functions have to be coded in C or another low\-level language\&.
.PP
The
\fIinput_function\fR
converts the type\*(Aqs external textual representation to the internal representation used by the operators and functions defined for the type\&.
\fIoutput_function\fR
performs the reverse transformation\&. The input function can be declared as taking one argument of type
cstring, or as taking three arguments of types
cstring,
oid,
integer\&. The first argument is the input text as a C string, the second argument is the type\*(Aqs own OID (except for array types, which instead receive their element type\*(Aqs OID), and the third is the
typmod
of the destination column, if known (\-1 will be passed if not)\&. The input function must return a value of the data type itself\&. Usually, an input function should be declared STRICT; if it is not, it will be called with a NULL first parameter when reading a NULL input value\&. The function must still return NULL in this case, unless it raises an error\&. (This case is mainly meant to support domain input functions, which might need to reject NULL inputs\&.) The output function must be declared as taking one argument of the new data type\&. The output function must return type
cstring\&. Output functions are not invoked for NULL values\&.
.PP
The optional
\fIreceive_function\fR
converts the type\*(Aqs external binary representation to the internal representation\&. If this function is not supplied, the type cannot participate in binary input\&. The binary representation should be chosen to be cheap to convert to internal form, while being reasonably portable\&. (For example, the standard integer data types use network byte order as the external binary representation, while the internal representation is in the machine\*(Aqs native byte order\&.) The receive function should perform adequate checking to ensure that the value is valid\&. The receive function can be declared as taking one argument of type
internal, or as taking three arguments of types
internal,
oid,
integer\&. The first argument is a pointer to a
StringInfo
buffer holding the received byte string; the optional arguments are the same as for the text input function\&. The receive function must return a value of the data type itself\&. Usually, a receive function should be declared STRICT; if it is not, it will be called with a NULL first parameter when reading a NULL input value\&. The function must still return NULL in this case, unless it raises an error\&. (This case is mainly meant to support domain receive functions, which might need to reject NULL inputs\&.) Similarly, the optional
\fIsend_function\fR
converts from the internal representation to the external binary representation\&. If this function is not supplied, the type cannot participate in binary output\&. The send function must be declared as taking one argument of the new data type\&. The send function must return type
bytea\&. Send functions are not invoked for NULL values\&.
.PP
You should at this point be wondering how the input and output functions can be declared to have results or arguments of the new type, when they have to be created before the new type can be created\&. The answer is that the type should first be defined as a
shell type, which is a placeholder type that has no properties except a name and an owner\&. This is done by issuing the command
CREATE TYPE \fIname\fR, with no additional parameters\&. Then the C I/O functions can be defined referencing the shell type\&. Finally,
\fBCREATE TYPE\fR
with a full definition replaces the shell entry with a complete, valid type definition, after which the new type can be used normally\&.
.PP
The optional
\fItype_modifier_input_function\fR
and
\fItype_modifier_output_function\fR
are needed if the type supports modifiers, that is optional constraints attached to a type declaration, such as
char(5)
or
numeric(30,2)\&.
PostgreSQL
allows user\-defined types to take one or more simple constants or identifiers as modifiers\&. However, this information must be capable of being packed into a single non\-negative integer value for storage in the system catalogs\&. The
\fItype_modifier_input_function\fR
is passed the declared modifier(s) in the form of a
cstring
array\&. It must check the values for validity (throwing an error if they are wrong), and if they are correct, return a single non\-negative
integer
value that will be stored as the column
\(lqtypmod\(rq\&. Type modifiers will be rejected if the type does not have a
\fItype_modifier_input_function\fR\&. The
\fItype_modifier_output_function\fR
converts the internal integer typmod value back to the correct form for user display\&. It must return a
cstring
value that is the exact string to append to the type name; for example
numeric\*(Aqs function might return
(30,2)\&. It is allowed to omit the
\fItype_modifier_output_function\fR, in which case the default display format is just the stored typmod integer value enclosed in parentheses\&.
.PP
The optional
\fIanalyze_function\fR
performs type\-specific statistics collection for columns of the data type\&. By default,
\fBANALYZE\fR
will attempt to gather statistics using the type\*(Aqs
\(lqequals\(rq
and
\(lqless\-than\(rq
operators, if there is a default b\-tree operator class for the type\&. For non\-scalar types this behavior is likely to be unsuitable, so it can be overridden by specifying a custom analysis function\&. The analysis function must be declared to take a single argument of type
internal, and return a
boolean
result\&. The detailed API for analysis functions appears in
src/include/commands/vacuum\&.h\&.
.PP
While the details of the new type\*(Aqs internal representation are only known to the I/O functions and other functions you create to work with the type, there are several properties of the internal representation that must be declared to
PostgreSQL\&. Foremost of these is
\fIinternallength\fR\&. Base data types can be fixed\-length, in which case
\fIinternallength\fR
is a positive integer, or variable\-length, indicated by setting
\fIinternallength\fR
to
VARIABLE\&. (Internally, this is represented by setting
typlen
to \-1\&.) The internal representation of all variable\-length types must start with a 4\-byte integer giving the total length of this value of the type\&. (Note that the length field is often encoded, as described in
Section 65.2, \(lqTOAST\(rq, in the documentation; it\*(Aqs unwise to access it directly\&.)
.PP
The optional flag
PASSEDBYVALUE
indicates that values of this data type are passed by value, rather than by reference\&. Types passed by value must be fixed\-length, and their internal representation cannot be larger than the size of the
Datum
type (4 bytes on some machines, 8 bytes on others)\&.
.PP
The
\fIalignment\fR
parameter specifies the storage alignment required for the data type\&. The allowed values equate to alignment on 1, 2, 4, or 8 byte boundaries\&. Note that variable\-length types must have an alignment of at least 4, since they necessarily contain an
int4
as their first component\&.
.PP
The
\fIstorage\fR
parameter allows selection of storage strategies for variable\-length data types\&. (Only
plain
is allowed for fixed\-length types\&.)
plain
specifies that data of the type will always be stored in\-line and not compressed\&.
extended
specifies that the system will first try to compress a long data value, and will move the value out of the main table row if it\*(Aqs still too long\&.
external
allows the value to be moved out of the main table, but the system will not try to compress it\&.
main
allows compression, but discourages moving the value out of the main table\&. (Data items with this storage strategy might still be moved out of the main table if there is no other way to make a row fit, but they will be kept in the main table preferentially over
extended
and
external
items\&.)
.PP
All
\fIstorage\fR
values other than
plain
imply that the functions of the data type can handle values that have been
toasted, as described in
Section 65.2, \(lqTOAST\(rq, in the documentation
and
Section 36.11.1, \(lqTOAST Considerations\(rq, in the documentation\&. The specific other value given merely determines the default TOAST storage strategy for columns of a toastable data type; users can pick other strategies for individual columns using
ALTER TABLE SET STORAGE\&.
.PP
The
\fIlike_type\fR
parameter provides an alternative method for specifying the basic representation properties of a data type: copy them from some existing type\&. The values of
\fIinternallength\fR,
\fIpassedbyvalue\fR,
\fIalignment\fR, and
\fIstorage\fR
are copied from the named type\&. (It is possible, though usually undesirable, to override some of these values by specifying them along with the
LIKE
clause\&.) Specifying representation this way is especially useful when the low\-level implementation of the new type
\(lqpiggybacks\(rq
on an existing type in some fashion\&.
.PP
The
\fIcategory\fR
and
\fIpreferred\fR
parameters can be used to help control which implicit cast will be applied in ambiguous situations\&. Each data type belongs to a category named by a single ASCII character, and each type is either
\(lqpreferred\(rq
or not within its category\&. The parser will prefer casting to preferred types (but only from other types within the same category) when this rule is helpful in resolving overloaded functions or operators\&. For more details see
Chapter 10, Type Conversion, in the documentation\&. For types that have no implicit casts to or from any other types, it is sufficient to leave these settings at the defaults\&. However, for a group of related types that have implicit casts, it is often helpful to mark them all as belonging to a category and select one or two of the
\(lqmost general\(rq
types as being preferred within the category\&. The
\fIcategory\fR
parameter is especially useful when adding a user\-defined type to an existing built\-in category, such as the numeric or string types\&. However, it is also possible to create new entirely\-user\-defined type categories\&. Select any ASCII character other than an upper\-case letter to name such a category\&.
.PP
A default value can be specified, in case a user wants columns of the data type to default to something other than the null value\&. Specify the default with the
DEFAULT
key word\&. (Such a default can be overridden by an explicit
DEFAULT
clause attached to a particular column\&.)
.PP
To indicate that a type is an array, specify the type of the array elements using the
ELEMENT
key word\&. For example, to define an array of 4\-byte integers (int4), specify
ELEMENT = int4\&. More details about array types appear below\&.
.PP
To indicate the delimiter to be used between values in the external representation of arrays of this type,
\fIdelimiter\fR
can be set to a specific character\&. The default delimiter is the comma (,)\&. Note that the delimiter is associated with the array element type, not the array type itself\&.
.PP
If the optional Boolean parameter
\fIcollatable\fR
is true, column definitions and expressions of the type may carry collation information through use of the
COLLATE
clause\&. It is up to the implementations of the functions operating on the type to actually make use of the collation information; this does not happen automatically merely by marking the type collatable\&.
.SS "Array Types"
.PP
Whenever a user\-defined type is created,
PostgreSQL
automatically creates an associated array type, whose name consists of the element type\*(Aqs name prepended with an underscore, and truncated if necessary to keep it less than
NAMEDATALEN
bytes long\&. (If the name so generated collides with an existing type name, the process is repeated until a non\-colliding name is found\&.) This implicitly\-created array type is variable length and uses the built\-in input and output functions
array_in
and
array_out\&. The array type tracks any changes in its element type\*(Aqs owner or schema, and is dropped if the element type is\&.
.PP
You might reasonably ask why there is an
\fBELEMENT\fR
option, if the system makes the correct array type automatically\&. The only case where it\*(Aqs useful to use
\fBELEMENT\fR
is when you are making a fixed\-length type that happens to be internally an array of a number of identical things, and you want to allow these things to be accessed directly by subscripting, in addition to whatever operations you plan to provide for the type as a whole\&. For example, type
point
is represented as just two floating\-point numbers, which can be accessed using
point[0]
and
point[1]\&. Note that this facility only works for fixed\-length types whose internal form is exactly a sequence of identical fixed\-length fields\&. A subscriptable variable\-length type must have the generalized internal representation used by
array_in
and
array_out\&. For historical reasons (i\&.e\&., this is clearly wrong but it\*(Aqs far too late to change it), subscripting of fixed\-length array types starts from zero, rather than from one as for variable\-length arrays\&.
.SH "PARAMETERS"
.PP
\fIname\fR
.RS 4
The name (optionally schema\-qualified) of a type to be created\&.
.RE
.PP
\fIattribute_name\fR
.RS 4
The name of an attribute (column) for the composite type\&.
.RE
.PP
\fIdata_type\fR
.RS 4
The name of an existing data type to become a column of the composite type\&.
.RE
.PP
\fIcollation\fR
.RS 4
The name of an existing collation to be associated with a column of a composite type, or with a range type\&.
.RE
.PP
\fIlabel\fR
.RS 4
A string literal representing the textual label associated with one value of an enum type\&.
.RE
.PP
\fIsubtype\fR
.RS 4
The name of the element type that the range type will represent ranges of\&.
.RE
.PP
\fIsubtype_operator_class\fR
.RS 4
The name of a b\-tree operator class for the subtype\&.
.RE
.PP
\fIcanonical_function\fR
.RS 4
The name of the canonicalization function for the range type\&.
.RE
.PP
\fIsubtype_diff_function\fR
.RS 4
The name of a difference function for the subtype\&.
.RE
.PP
\fIinput_function\fR
.RS 4
The name of a function that converts data from the type\*(Aqs external textual form to its internal form\&.
.RE
.PP
\fIoutput_function\fR
.RS 4
The name of a function that converts data from the type\*(Aqs internal form to its external textual form\&.
.RE
.PP
\fIreceive_function\fR
.RS 4
The name of a function that converts data from the type\*(Aqs external binary form to its internal form\&.
.RE
.PP
\fIsend_function\fR
.RS 4
The name of a function that converts data from the type\*(Aqs internal form to its external binary form\&.
.RE
.PP
\fItype_modifier_input_function\fR
.RS 4
The name of a function that converts an array of modifier(s) for the type into internal form\&.
.RE
.PP
\fItype_modifier_output_function\fR
.RS 4
The name of a function that converts the internal form of the type\*(Aqs modifier(s) to external textual form\&.
.RE
.PP
\fIanalyze_function\fR
.RS 4
The name of a function that performs statistical analysis for the data type\&.
.RE
.PP
\fIinternallength\fR
.RS 4
A numeric constant that specifies the length in bytes of the new type\*(Aqs internal representation\&. The default assumption is that it is variable\-length\&.
.RE
.PP
\fIalignment\fR
.RS 4
The storage alignment requirement of the data type\&. If specified, it must be
char,
int2,
int4, or
double; the default is
int4\&.
.RE
.PP
\fIstorage\fR
.RS 4
The storage strategy for the data type\&. If specified, must be
plain,
external,
extended, or
main; the default is
plain\&.
.RE
.PP
\fIlike_type\fR
.RS 4
The name of an existing data type that the new type will have the same representation as\&. The values of
\fIinternallength\fR,
\fIpassedbyvalue\fR,
\fIalignment\fR, and
\fIstorage\fR
are copied from that type, unless overridden by explicit specification elsewhere in this
\fBCREATE TYPE\fR
command\&.
.RE
.PP
\fIcategory\fR
.RS 4
The category code (a single ASCII character) for this type\&. The default is
\*(AqU\*(Aq
for
\(lquser\-defined type\(rq\&. Other standard category codes can be found in
Table\ \&50.56, \(lqtypcategory Codes\(rq\&. You may also choose other ASCII characters in order to create custom categories\&.
.RE
.PP
\fIpreferred\fR
.RS 4
True if this type is a preferred type within its type category, else false\&. The default is false\&. Be very careful about creating a new preferred type within an existing type category, as this could cause surprising changes in behavior\&.
.RE
.PP
\fIdefault\fR
.RS 4
The default value for the data type\&. If this is omitted, the default is null\&.
.RE
.PP
\fIelement\fR
.RS 4
The type being created is an array; this specifies the type of the array elements\&.
.RE
.PP
\fIdelimiter\fR
.RS 4
The delimiter character to be used between values in arrays made of this type\&.
.RE
.PP
\fIcollatable\fR
.RS 4
True if this type\*(Aqs operations can use collation information\&. The default is false\&.
.RE
.SH "NOTES"
.PP
Because there are no restrictions on use of a data type once it\*(Aqs been created, creating a base type or range type is tantamount to granting public execute permission on the functions mentioned in the type definition\&. This is usually not an issue for the sorts of functions that are useful in a type definition\&. But you might want to think twice before designing a type in a way that would require
\(lqsecret\(rq
information to be used while converting it to or from external form\&.
.PP
Before
PostgreSQL
version 8\&.3, the name of a generated array type was always exactly the element type\*(Aqs name with one underscore character (_) prepended\&. (Type names were therefore restricted in length to one fewer character than other names\&.) While this is still usually the case, the array type name may vary from this in case of maximum\-length names or collisions with user type names that begin with underscore\&. Writing code that depends on this convention is therefore deprecated\&. Instead, use
pg_type\&.typarray
to locate the array type associated with a given type\&.
.PP
It may be advisable to avoid using type and table names that begin with underscore\&. While the server will change generated array type names to avoid collisions with user\-given names, there is still risk of confusion, particularly with old client software that may assume that type names beginning with underscores always represent arrays\&.
.PP
Before
PostgreSQL
version 8\&.2, the shell\-type creation syntax
CREATE TYPE \fIname\fR
did not exist\&. The way to create a new base type was to create its input function first\&. In this approach,
PostgreSQL
will first see the name of the new data type as the return type of the input function\&. The shell type is implicitly created in this situation, and then it can be referenced in the definitions of the remaining I/O functions\&. This approach still works, but is deprecated and might be disallowed in some future release\&. Also, to avoid accidentally cluttering the catalogs with shell types as a result of simple typos in function definitions, a shell type will only be made this way when the input function is written in C\&.
.PP
In
PostgreSQL
versions before 7\&.3, it was customary to avoid creating a shell type at all, by replacing the functions\*(Aq forward references to the type name with the placeholder pseudotype
opaque\&. The
cstring
arguments and results also had to be declared as
opaque
before 7\&.3\&. To support loading of old dump files,
\fBCREATE TYPE\fR
will accept I/O functions declared using
opaque, but it will issue a notice and change the function declarations to use the correct types\&.
.SH "EXAMPLES"
.PP
This example creates a composite type and uses it in a function definition:
.sp
.if n \{\
.RS 4
.\}
.nf
CREATE TYPE compfoo AS (f1 int, f2 text);
CREATE FUNCTION getfoo() RETURNS SETOF compfoo AS $$
SELECT fooid, fooname FROM foo
$$ LANGUAGE SQL;
.fi
.if n \{\
.RE
.\}
.PP
This example creates an enumerated type and uses it in a table definition:
.sp
.if n \{\
.RS 4
.\}
.nf
CREATE TYPE bug_status AS ENUM (\*(Aqnew\*(Aq, \*(Aqopen\*(Aq, \*(Aqclosed\*(Aq);
CREATE TABLE bug (
id serial,
description text,
status bug_status
);
.fi
.if n \{\
.RE
.\}
.PP
This example creates a range type:
.sp
.if n \{\
.RS 4
.\}
.nf
CREATE TYPE float8_range AS RANGE (subtype = float8, subtype_diff = float8mi);
.fi
.if n \{\
.RE
.\}
.PP
This example creates the base data type
box
and then uses the type in a table definition:
.sp
.if n \{\
.RS 4
.\}
.nf
CREATE TYPE box;
CREATE FUNCTION my_box_in_function(cstring) RETURNS box AS \&.\&.\&. ;
CREATE FUNCTION my_box_out_function(box) RETURNS cstring AS \&.\&.\&. ;
CREATE TYPE box (
INTERNALLENGTH = 16,
INPUT = my_box_in_function,
OUTPUT = my_box_out_function
);
CREATE TABLE myboxes (
id integer,
description box
);
.fi
.if n \{\
.RE
.\}
.PP
If the internal structure of
box
were an array of four
float4
elements, we might instead use:
.sp
.if n \{\
.RS 4
.\}
.nf
CREATE TYPE box (
INTERNALLENGTH = 16,
INPUT = my_box_in_function,
OUTPUT = my_box_out_function,
ELEMENT = float4
);
.fi
.if n \{\
.RE
.\}
.sp
which would allow a box value\*(Aqs component numbers to be accessed by subscripting\&. Otherwise the type behaves the same as before\&.
.PP
This example creates a large object type and uses it in a table definition:
.sp
.if n \{\
.RS 4
.\}
.nf
CREATE TYPE bigobj (
INPUT = lo_filein, OUTPUT = lo_fileout,
INTERNALLENGTH = VARIABLE
);
CREATE TABLE big_objs (
id integer,
obj bigobj
);
.fi
.if n \{\
.RE
.\}
.PP
More examples, including suitable input and output functions, are in
Section 36.11, \(lqUser-defined Types\(rq, in the documentation\&.
.SH "COMPATIBILITY"
.PP
The first form of the
\fBCREATE TYPE\fR
command, which creates a composite type, conforms to the
SQL
standard\&. The other forms are
PostgreSQL
extensions\&. The
\fBCREATE TYPE\fR
statement in the
SQL
standard also defines other forms that are not implemented in
PostgreSQL\&.
.PP
The ability to create a composite type with zero attributes is a
PostgreSQL\-specific deviation from the standard (analogous to the same case in
\fBCREATE TABLE\fR)\&.
.SH "SEE ALSO"
ALTER TYPE (\fBALTER_TYPE\fR(7)), CREATE DOMAIN (\fBCREATE_DOMAIN\fR(7)), CREATE FUNCTION (\fBCREATE_FUNCTION\fR(7)), DROP TYPE (\fBDROP_TYPE\fR(7))
man/man7/ALTER_SYSTEM.7 0000644 00000007466 14751153421 0010244 0 ustar 00 '\" t
.\" Title: ALTER SYSTEM
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "ALTER SYSTEM" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
ALTER_SYSTEM \- change a server configuration parameter
.SH "SYNOPSIS"
.sp
.nf
ALTER SYSTEM SET \fIconfiguration_parameter\fR { TO | = } { \fIvalue\fR | \*(Aq\fIvalue\fR\*(Aq | DEFAULT }
ALTER SYSTEM RESET \fIconfiguration_parameter\fR
ALTER SYSTEM RESET ALL
.fi
.SH "DESCRIPTION"
.PP
\fBALTER SYSTEM\fR
is used for changing server configuration parameters across the entire database cluster\&. It can be more convenient than the traditional method of manually editing the
postgresql\&.conf
file\&.
\fBALTER SYSTEM\fR
writes the given parameter setting to the
postgresql\&.auto\&.conf
file, which is read in addition to
postgresql\&.conf\&. Setting a parameter to
DEFAULT, or using the
\fBRESET\fR
variant, removes that configuration entry from the
postgresql\&.auto\&.conf
file\&. Use
RESET ALL
to remove all such configuration entries\&.
.PP
Values set with
\fBALTER SYSTEM\fR
will be effective after the next server configuration reload, or after the next server restart in the case of parameters that can only be changed at server start\&. A server configuration reload can be commanded by calling the SQL function
\fBpg_reload_conf()\fR, running
pg_ctl reload, or sending a
SIGHUP
signal to the main server process\&.
.PP
Only superusers can use
\fBALTER SYSTEM\fR\&. Also, since this command acts directly on the file system and cannot be rolled back, it is not allowed inside a transaction block or function\&.
.SH "PARAMETERS"
.PP
\fIconfiguration_parameter\fR
.RS 4
Name of a settable configuration parameter\&. Available parameters are documented in
Chapter 19, Server Configuration, in the documentation\&.
.RE
.PP
\fIvalue\fR
.RS 4
New value of the parameter\&. Values can be specified as string constants, identifiers, numbers, or comma\-separated lists of these, as appropriate for the particular parameter\&.
DEFAULT
can be written to specify removing the parameter and its value from
postgresql\&.auto\&.conf\&.
.RE
.SH "NOTES"
.PP
This command can\*(Aqt be used to set
data_directory, nor parameters that are not allowed in
postgresql\&.conf
(e\&.g\&.,
preset options)\&.
.PP
See
Section 19.1, \(lqSetting Parameters\(rq, in the documentation
for other ways to set the parameters\&.
.SH "EXAMPLES"
.PP
Set the
wal_level:
.sp
.if n \{\
.RS 4
.\}
.nf
ALTER SYSTEM SET wal_level = replica;
.fi
.if n \{\
.RE
.\}
.PP
Undo that, restoring whatever setting was effective in
postgresql\&.conf:
.sp
.if n \{\
.RS 4
.\}
.nf
ALTER SYSTEM RESET wal_level;
.fi
.if n \{\
.RE
.\}
.sp
.SH "COMPATIBILITY"
.PP
The
\fBALTER SYSTEM\fR
statement is a
PostgreSQL
extension\&.
.SH "SEE ALSO"
\fBSET\fR(7), \fBSHOW\fR(7)
man/man7/UPDATE.7 0000644 00000030441 14751153421 0007240 0 ustar 00 '\" t
.\" Title: UPDATE
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "UPDATE" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
UPDATE \- update rows of a table
.SH "SYNOPSIS"
.sp
.nf
[ WITH [ RECURSIVE ] \fIwith_query\fR [, \&.\&.\&.] ]
UPDATE [ ONLY ] \fItable_name\fR [ * ] [ [ AS ] \fIalias\fR ]
SET { \fIcolumn_name\fR = { \fIexpression\fR | DEFAULT } |
( \fIcolumn_name\fR [, \&.\&.\&.] ) = ( { \fIexpression\fR | DEFAULT } [, \&.\&.\&.] ) |
( \fIcolumn_name\fR [, \&.\&.\&.] ) = ( \fIsub\-SELECT\fR )
} [, \&.\&.\&.]
[ FROM \fIfrom_item\fR [, \&.\&.\&.] ]
[ WHERE \fIcondition\fR | WHERE CURRENT OF \fIcursor_name\fR ]
[ RETURNING * | \fIoutput_expression\fR [ [ AS ] \fIoutput_name\fR ] [, \&.\&.\&.] ]
.fi
.SH "DESCRIPTION"
.PP
\fBUPDATE\fR
changes the values of the specified columns in all rows that satisfy the condition\&. Only the columns to be modified need be mentioned in the
SET
clause; columns not explicitly modified retain their previous values\&.
.PP
There are two ways to modify a table using information contained in other tables in the database: using sub\-selects, or specifying additional tables in the
FROM
clause\&. Which technique is more appropriate depends on the specific circumstances\&.
.PP
The optional
RETURNING
clause causes
\fBUPDATE\fR
to compute and return value(s) based on each row actually updated\&. Any expression using the table\*(Aqs columns, and/or columns of other tables mentioned in
FROM, can be computed\&. The new (post\-update) values of the table\*(Aqs columns are used\&. The syntax of the
RETURNING
list is identical to that of the output list of
\fBSELECT\fR\&.
.PP
You must have the
UPDATE
privilege on the table, or at least on the column(s) that are listed to be updated\&. You must also have the
SELECT
privilege on any column whose values are read in the
\fIexpressions\fR
or
\fIcondition\fR\&.
.SH "PARAMETERS"
.PP
\fIwith_query\fR
.RS 4
The
WITH
clause allows you to specify one or more subqueries that can be referenced by name in the
\fBUPDATE\fR
query\&. See
Section 7.8, \(lqWITH Queries (Common Table Expressions)\(rq, in the documentation
and
\fBSELECT\fR(7)
for details\&.
.RE
.PP
\fItable_name\fR
.RS 4
The name (optionally schema\-qualified) of the table to update\&. If
ONLY
is specified before the table name, matching rows are updated in the named table only\&. If
ONLY
is not specified, matching rows are also updated in any tables inheriting from the named table\&. Optionally,
*
can be specified after the table name to explicitly indicate that descendant tables are included\&.
.RE
.PP
\fIalias\fR
.RS 4
A substitute name for the target table\&. When an alias is provided, it completely hides the actual name of the table\&. For example, given
UPDATE foo AS f, the remainder of the
\fBUPDATE\fR
statement must refer to this table as
f
not
foo\&.
.RE
.PP
\fIcolumn_name\fR
.RS 4
The name of a column in the table named by
\fItable_name\fR\&. The column name can be qualified with a subfield name or array subscript, if needed\&. Do not include the table\*(Aqs name in the specification of a target column \(em for example,
UPDATE table_name SET table_name\&.col = 1
is invalid\&.
.RE
.PP
\fIexpression\fR
.RS 4
An expression to assign to the column\&. The expression can use the old values of this and other columns in the table\&.
.RE
.PP
DEFAULT
.RS 4
Set the column to its default value (which will be NULL if no specific default expression has been assigned to it)\&.
.RE
.PP
\fIsub\-SELECT\fR
.RS 4
A
SELECT
sub\-query that produces as many output columns as are listed in the parenthesized column list preceding it\&. The sub\-query must yield no more than one row when executed\&. If it yields one row, its column values are assigned to the target columns; if it yields no rows, NULL values are assigned to the target columns\&. The sub\-query can refer to old values of the current row of the table being updated\&.
.RE
.PP
\fIfrom_item\fR
.RS 4
A table expression allowing columns from other tables to appear in the
WHERE
condition and update expressions\&. This uses the same syntax as the
FROM Clause
of a
\fBSELECT\fR
statement; for example, an alias for the table name can be specified\&. Do not repeat the target table as a
\fIfrom_item\fR
unless you intend a self\-join (in which case it must appear with an alias in the
\fIfrom_item\fR)\&.
.RE
.PP
\fIcondition\fR
.RS 4
An expression that returns a value of type
boolean\&. Only rows for which this expression returns
true
will be updated\&.
.RE
.PP
\fIcursor_name\fR
.RS 4
The name of the cursor to use in a
WHERE CURRENT OF
condition\&. The row to be updated is the one most recently fetched from this cursor\&. The cursor must be a non\-grouping query on the
\fBUPDATE\fR\*(Aqs target table\&. Note that
WHERE CURRENT OF
cannot be specified together with a Boolean condition\&. See
\fBDECLARE\fR(7)
for more information about using cursors with
WHERE CURRENT OF\&.
.RE
.PP
\fIoutput_expression\fR
.RS 4
An expression to be computed and returned by the
\fBUPDATE\fR
command after each row is updated\&. The expression can use any column names of the table named by
\fItable_name\fR
or table(s) listed in
FROM\&. Write
*
to return all columns\&.
.RE
.PP
\fIoutput_name\fR
.RS 4
A name to use for a returned column\&.
.RE
.SH "OUTPUTS"
.PP
On successful completion, an
\fBUPDATE\fR
command returns a command tag of the form
.sp
.if n \{\
.RS 4
.\}
.nf
UPDATE \fIcount\fR
.fi
.if n \{\
.RE
.\}
.sp
The
\fIcount\fR
is the number of rows updated, including matched rows whose values did not change\&. Note that the number may be less than the number of rows that matched the
\fIcondition\fR
when updates were suppressed by a
BEFORE UPDATE
trigger\&. If
\fIcount\fR
is 0, no rows were updated by the query (this is not considered an error)\&.
.PP
If the
\fBUPDATE\fR
command contains a
RETURNING
clause, the result will be similar to that of a
\fBSELECT\fR
statement containing the columns and values defined in the
RETURNING
list, computed over the row(s) updated by the command\&.
.SH "NOTES"
.PP
When a
FROM
clause is present, what essentially happens is that the target table is joined to the tables mentioned in the
\fIfrom_item\fR
list, and each output row of the join represents an update operation for the target table\&. When using
FROM
you should ensure that the join produces at most one output row for each row to be modified\&. In other words, a target row shouldn\*(Aqt join to more than one row from the other table(s)\&. If it does, then only one of the join rows will be used to update the target row, but which one will be used is not readily predictable\&.
.PP
Because of this indeterminacy, referencing other tables only within sub\-selects is safer, though often harder to read and slower than using a join\&.
.SH "EXAMPLES"
.PP
Change the word
Drama
to
Dramatic
in the column
kind
of the table
films:
.sp
.if n \{\
.RS 4
.\}
.nf
UPDATE films SET kind = \*(AqDramatic\*(Aq WHERE kind = \*(AqDrama\*(Aq;
.fi
.if n \{\
.RE
.\}
.PP
Adjust temperature entries and reset precipitation to its default value in one row of the table
weather:
.sp
.if n \{\
.RS 4
.\}
.nf
UPDATE weather SET temp_lo = temp_lo+1, temp_hi = temp_lo+15, prcp = DEFAULT
WHERE city = \*(AqSan Francisco\*(Aq AND date = \*(Aq2003\-07\-03\*(Aq;
.fi
.if n \{\
.RE
.\}
.PP
Perform the same operation and return the updated entries:
.sp
.if n \{\
.RS 4
.\}
.nf
UPDATE weather SET temp_lo = temp_lo+1, temp_hi = temp_lo+15, prcp = DEFAULT
WHERE city = \*(AqSan Francisco\*(Aq AND date = \*(Aq2003\-07\-03\*(Aq
RETURNING temp_lo, temp_hi, prcp;
.fi
.if n \{\
.RE
.\}
.PP
Use the alternative column\-list syntax to do the same update:
.sp
.if n \{\
.RS 4
.\}
.nf
UPDATE weather SET (temp_lo, temp_hi, prcp) = (temp_lo+1, temp_lo+15, DEFAULT)
WHERE city = \*(AqSan Francisco\*(Aq AND date = \*(Aq2003\-07\-03\*(Aq;
.fi
.if n \{\
.RE
.\}
.PP
Increment the sales count of the salesperson who manages the account for Acme Corporation, using the
FROM
clause syntax:
.sp
.if n \{\
.RS 4
.\}
.nf
UPDATE employees SET sales_count = sales_count + 1 FROM accounts
WHERE accounts\&.name = \*(AqAcme Corporation\*(Aq
AND employees\&.id = accounts\&.sales_person;
.fi
.if n \{\
.RE
.\}
.PP
Perform the same operation, using a sub\-select in the
WHERE
clause:
.sp
.if n \{\
.RS 4
.\}
.nf
UPDATE employees SET sales_count = sales_count + 1 WHERE id =
(SELECT sales_person FROM accounts WHERE name = \*(AqAcme Corporation\*(Aq);
.fi
.if n \{\
.RE
.\}
.PP
Update contact names in an accounts table to match the currently assigned salesmen:
.sp
.if n \{\
.RS 4
.\}
.nf
UPDATE accounts SET (contact_first_name, contact_last_name) =
(SELECT first_name, last_name FROM salesmen
WHERE salesmen\&.id = accounts\&.sales_id);
.fi
.if n \{\
.RE
.\}
.sp
A similar result could be accomplished with a join:
.sp
.if n \{\
.RS 4
.\}
.nf
UPDATE accounts SET contact_first_name = first_name,
contact_last_name = last_name
FROM salesmen WHERE salesmen\&.id = accounts\&.sales_id;
.fi
.if n \{\
.RE
.\}
.sp
However, the second query may give unexpected results if
salesmen\&.id
is not a unique key, whereas the first query is guaranteed to raise an error if there are multiple
id
matches\&. Also, if there is no match for a particular
accounts\&.sales_id
entry, the first query will set the corresponding name fields to NULL, whereas the second query will not update that row at all\&.
.PP
Update statistics in a summary table to match the current data:
.sp
.if n \{\
.RS 4
.\}
.nf
UPDATE summary s SET (sum_x, sum_y, avg_x, avg_y) =
(SELECT sum(x), sum(y), avg(x), avg(y) FROM data d
WHERE d\&.group_id = s\&.group_id);
.fi
.if n \{\
.RE
.\}
.PP
Attempt to insert a new stock item along with the quantity of stock\&. If the item already exists, instead update the stock count of the existing item\&. To do this without failing the entire transaction, use savepoints:
.sp
.if n \{\
.RS 4
.\}
.nf
BEGIN;
\-\- other operations
SAVEPOINT sp1;
INSERT INTO wines VALUES(\*(AqChateau Lafite 2003\*(Aq, \*(Aq24\*(Aq);
\-\- Assume the above fails because of a unique key violation,
\-\- so now we issue these commands:
ROLLBACK TO sp1;
UPDATE wines SET stock = stock + 24 WHERE winename = \*(AqChateau Lafite 2003\*(Aq;
\-\- continue with other operations, and eventually
COMMIT;
.fi
.if n \{\
.RE
.\}
.PP
Change the
kind
column of the table
films
in the row on which the cursor
c_films
is currently positioned:
.sp
.if n \{\
.RS 4
.\}
.nf
UPDATE films SET kind = \*(AqDramatic\*(Aq WHERE CURRENT OF c_films;
.fi
.if n \{\
.RE
.\}
.SH "COMPATIBILITY"
.PP
This command conforms to the
SQL
standard, except that the
FROM
and
RETURNING
clauses are
PostgreSQL
extensions, as is the ability to use
WITH
with
\fBUPDATE\fR\&.
.PP
Some other database systems offer a
FROM
option in which the target table is supposed to be listed again within
FROM\&. That is not how
PostgreSQL
interprets
FROM\&. Be careful when porting applications that use this extension\&.
.PP
According to the standard, the source value for a parenthesized sub\-list of column names can be any row\-valued expression yielding the correct number of columns\&.
PostgreSQL
only allows the source value to be a parenthesized list of expressions or a sub\-SELECT\&. An individual column\*(Aqs updated value can be specified as
DEFAULT
in the list\-of\-expressions case, but not inside a sub\-SELECT\&.
man/man7/CREATE_CONVERSION.7 0000644 00000007447 14751153421 0011000 0 ustar 00 '\" t
.\" Title: CREATE CONVERSION
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "CREATE CONVERSION" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
CREATE_CONVERSION \- define a new encoding conversion
.SH "SYNOPSIS"
.sp
.nf
CREATE [ DEFAULT ] CONVERSION \fIname\fR
FOR \fIsource_encoding\fR TO \fIdest_encoding\fR FROM \fIfunction_name\fR
.fi
.SH "DESCRIPTION"
.PP
\fBCREATE CONVERSION\fR
defines a new conversion between character set encodings\&. Also, conversions that are marked
DEFAULT
can be used for automatic encoding conversion between client and server\&. For this purpose, two conversions, from encoding A to B
\fIand\fR
from encoding B to A, must be defined\&.
.PP
To be able to create a conversion, you must have
EXECUTE
privilege on the function and
CREATE
privilege on the destination schema\&.
.SH "PARAMETERS"
.PP
DEFAULT
.RS 4
The
DEFAULT
clause indicates that this conversion is the default for this particular source to destination encoding\&. There should be only one default encoding in a schema for the encoding pair\&.
.RE
.PP
\fIname\fR
.RS 4
The name of the conversion\&. The conversion name can be schema\-qualified\&. If it is not, the conversion is defined in the current schema\&. The conversion name must be unique within a schema\&.
.RE
.PP
\fIsource_encoding\fR
.RS 4
The source encoding name\&.
.RE
.PP
\fIdest_encoding\fR
.RS 4
The destination encoding name\&.
.RE
.PP
\fIfunction_name\fR
.RS 4
The function used to perform the conversion\&. The function name can be schema\-qualified\&. If it is not, the function will be looked up in the path\&.
.sp
The function must have the following signature:
.sp
.if n \{\
.RS 4
.\}
.nf
conv_proc(
integer, \-\- source encoding ID
integer, \-\- destination encoding ID
cstring, \-\- source string (null terminated C string)
internal, \-\- destination (fill with a null terminated C string)
integer \-\- source string length
) RETURNS void;
.fi
.if n \{\
.RE
.\}
.RE
.SH "NOTES"
.PP
Use
\fBDROP CONVERSION\fR
to remove user\-defined conversions\&.
.PP
The privileges required to create a conversion might be changed in a future release\&.
.SH "EXAMPLES"
.PP
To create a conversion from encoding
UTF8
to
LATIN1
using
\fBmyfunc\fR:
.sp
.if n \{\
.RS 4
.\}
.nf
CREATE CONVERSION myconv FOR \*(AqUTF8\*(Aq TO \*(AqLATIN1\*(Aq FROM myfunc;
.fi
.if n \{\
.RE
.\}
.SH "COMPATIBILITY"
.PP
\fBCREATE CONVERSION\fR
is a
PostgreSQL
extension\&. There is no
\fBCREATE CONVERSION\fR
statement in the SQL standard, but a
\fBCREATE TRANSLATION\fR
statement that is very similar in purpose and syntax\&.
.SH "SEE ALSO"
ALTER CONVERSION (\fBALTER_CONVERSION\fR(7)), CREATE FUNCTION (\fBCREATE_FUNCTION\fR(7)), DROP CONVERSION (\fBDROP_CONVERSION\fR(7))
man/man7/CREATE_COLLATION.7 0000644 00000007745 14751153421 0010640 0 ustar 00 '\" t
.\" Title: CREATE COLLATION
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "CREATE COLLATION" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
CREATE_COLLATION \- define a new collation
.SH "SYNOPSIS"
.sp
.nf
CREATE COLLATION \fIname\fR (
[ LOCALE = \fIlocale\fR, ]
[ LC_COLLATE = \fIlc_collate\fR, ]
[ LC_CTYPE = \fIlc_ctype\fR ]
)
CREATE COLLATION \fIname\fR FROM \fIexisting_collation\fR
.fi
.SH "DESCRIPTION"
.PP
\fBCREATE COLLATION\fR
defines a new collation using the specified operating system locale settings, or by copying an existing collation\&.
.PP
To be able to create a collation, you must have
CREATE
privilege on the destination schema\&.
.SH "PARAMETERS"
.PP
\fIname\fR
.RS 4
The name of the collation\&. The collation name can be schema\-qualified\&. If it is not, the collation is defined in the current schema\&. The collation name must be unique within that schema\&. (The system catalogs can contain collations with the same name for other encodings, but these are ignored if the database encoding does not match\&.)
.RE
.PP
\fIlocale\fR
.RS 4
This is a shortcut for setting
LC_COLLATE
and
LC_CTYPE
at once\&. If you specify this, you cannot specify either of those parameters\&.
.RE
.PP
\fIlc_collate\fR
.RS 4
Use the specified operating system locale for the
LC_COLLATE
locale category\&. The locale must be applicable to the current database encoding\&. (See
CREATE DATABASE (\fBCREATE_DATABASE\fR(7))
for the precise rules\&.)
.RE
.PP
\fIlc_ctype\fR
.RS 4
Use the specified operating system locale for the
LC_CTYPE
locale category\&. The locale must be applicable to the current database encoding\&. (See
CREATE DATABASE (\fBCREATE_DATABASE\fR(7))
for the precise rules\&.)
.RE
.PP
\fIexisting_collation\fR
.RS 4
The name of an existing collation to copy\&. The new collation will have the same properties as the existing one, but it will be an independent object\&.
.RE
.SH "NOTES"
.PP
Use
\fBDROP COLLATION\fR
to remove user\-defined collations\&.
.PP
See
Section 23.2, \(lqCollation Support\(rq, in the documentation
for more information about collation support in PostgreSQL\&.
.SH "EXAMPLES"
.PP
To create a collation from the operating system locale
fr_FR\&.utf8
(assuming the current database encoding is
UTF8):
.sp
.if n \{\
.RS 4
.\}
.nf
CREATE COLLATION french (LOCALE = \*(Aqfr_FR\&.utf8\*(Aq);
.fi
.if n \{\
.RE
.\}
.PP
To create a collation from an existing collation:
.sp
.if n \{\
.RS 4
.\}
.nf
CREATE COLLATION german FROM "de_DE";
.fi
.if n \{\
.RE
.\}
.sp
This can be convenient to be able to use operating\-system\-independent collation names in applications\&.
.SH "COMPATIBILITY"
.PP
There is a
\fBCREATE COLLATION\fR
statement in the SQL standard, but it is limited to copying an existing collation\&. The syntax to create a new collation is a
PostgreSQL
extension\&.
.SH "SEE ALSO"
ALTER COLLATION (\fBALTER_COLLATION\fR(7)), DROP COLLATION (\fBDROP_COLLATION\fR(7))
man/man7/SET.7 0000644 00000017117 14751153421 0006716 0 ustar 00 '\" t
.\" Title: SET
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "SET" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
SET \- change a run\-time parameter
.SH "SYNOPSIS"
.sp
.nf
SET [ SESSION | LOCAL ] \fIconfiguration_parameter\fR { TO | = } { \fIvalue\fR | \*(Aq\fIvalue\fR\*(Aq | DEFAULT }
SET [ SESSION | LOCAL ] TIME ZONE { \fItimezone\fR | LOCAL | DEFAULT }
.fi
.SH "DESCRIPTION"
.PP
The
\fBSET\fR
command changes run\-time configuration parameters\&. Many of the run\-time parameters listed in
Chapter 19, Server Configuration, in the documentation
can be changed on\-the\-fly with
\fBSET\fR\&. (But some require superuser privileges to change, and others cannot be changed after server or session start\&.)
\fBSET\fR
only affects the value used by the current session\&.
.PP
If
\fBSET\fR
(or equivalently
\fBSET SESSION\fR) is issued within a transaction that is later aborted, the effects of the
\fBSET\fR
command disappear when the transaction is rolled back\&. Once the surrounding transaction is committed, the effects will persist until the end of the session, unless overridden by another
\fBSET\fR\&.
.PP
The effects of
\fBSET LOCAL\fR
last only till the end of the current transaction, whether committed or not\&. A special case is
\fBSET\fR
followed by
\fBSET LOCAL\fR
within a single transaction: the
\fBSET LOCAL\fR
value will be seen until the end of the transaction, but afterwards (if the transaction is committed) the
\fBSET\fR
value will take effect\&.
.PP
The effects of
\fBSET\fR
or
\fBSET LOCAL\fR
are also canceled by rolling back to a savepoint that is earlier than the command\&.
.PP
If
\fBSET LOCAL\fR
is used within a function that has a
SET
option for the same variable (see
CREATE FUNCTION (\fBCREATE_FUNCTION\fR(7))), the effects of the
\fBSET LOCAL\fR
command disappear at function exit; that is, the value in effect when the function was called is restored anyway\&. This allows
\fBSET LOCAL\fR
to be used for dynamic or repeated changes of a parameter within a function, while still having the convenience of using the
SET
option to save and restore the caller\*(Aqs value\&. However, a regular
\fBSET\fR
command overrides any surrounding function\*(Aqs
SET
option; its effects will persist unless rolled back\&.
.if n \{\
.sp
.\}
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBNote\fR
.ps -1
.br
.PP
In
PostgreSQL
versions 8\&.0 through 8\&.2, the effects of a
\fBSET LOCAL\fR
would be canceled by releasing an earlier savepoint, or by successful exit from a
PL/pgSQL
exception block\&. This behavior has been changed because it was deemed unintuitive\&.
.sp .5v
.RE
.SH "PARAMETERS"
.PP
SESSION
.RS 4
Specifies that the command takes effect for the current session\&. (This is the default if neither
SESSION
nor
LOCAL
appears\&.)
.RE
.PP
LOCAL
.RS 4
Specifies that the command takes effect for only the current transaction\&. After
\fBCOMMIT\fR
or
\fBROLLBACK\fR, the session\-level setting takes effect again\&. Issuing this outside of a transaction block emits a warning and otherwise has no effect\&.
.RE
.PP
\fIconfiguration_parameter\fR
.RS 4
Name of a settable run\-time parameter\&. Available parameters are documented in
Chapter 19, Server Configuration, in the documentation
and below\&.
.RE
.PP
\fIvalue\fR
.RS 4
New value of parameter\&. Values can be specified as string constants, identifiers, numbers, or comma\-separated lists of these, as appropriate for the particular parameter\&.
DEFAULT
can be written to specify resetting the parameter to its default value (that is, whatever value it would have had if no
\fBSET\fR
had been executed in the current session)\&.
.RE
.PP
Besides the configuration parameters documented in
Chapter 19, Server Configuration, in the documentation, there are a few that can only be adjusted using the
\fBSET\fR
command or that have a special syntax:
.PP
SCHEMA
.RS 4
SET SCHEMA \*(Aq\fIvalue\fR\*(Aq
is an alias for
SET search_path TO \fIvalue\fR\&. Only one schema can be specified using this syntax\&.
.RE
.PP
NAMES
.RS 4
SET NAMES \fIvalue\fR
is an alias for
SET client_encoding TO \fIvalue\fR\&.
.RE
.PP
SEED
.RS 4
Sets the internal seed for the random number generator (the function
\fBrandom\fR)\&. Allowed values are floating\-point numbers between \-1 and 1, which are then multiplied by 2^31\-1\&.
.sp
The seed can also be set by invoking the function
\fBsetseed\fR:
.sp
.if n \{\
.RS 4
.\}
.nf
SELECT setseed(\fIvalue\fR);
.fi
.if n \{\
.RE
.\}
.RE
.PP
TIME ZONE
.RS 4
SET TIME ZONE \fIvalue\fR
is an alias for
SET timezone TO \fIvalue\fR\&. The syntax
SET TIME ZONE
allows special syntax for the time zone specification\&. Here are examples of valid values:
.PP
\*(AqPST8PDT\*(Aq
.RS 4
The time zone for Berkeley, California\&.
.RE
.PP
\*(AqEurope/Rome\*(Aq
.RS 4
The time zone for Italy\&.
.RE
.PP
\-7
.RS 4
The time zone 7 hours west from UTC (equivalent to PDT)\&. Positive values are east from UTC\&.
.RE
.PP
INTERVAL \*(Aq\-08:00\*(Aq HOUR TO MINUTE
.RS 4
The time zone 8 hours west from UTC (equivalent to PST)\&.
.RE
.PP
LOCAL
.br
DEFAULT
.RS 4
Set the time zone to your local time zone (that is, the server\*(Aqs default value of
\fItimezone\fR)\&.
.RE
.sp
Timezone settings given as numbers or intervals are internally translated to POSIX timezone syntax\&. For example, after
SET TIME ZONE \-7,
\fBSHOW TIME ZONE\fR
would report
<\-07>+07\&.
.sp
See
Section 8.5.3, \(lqTime Zones\(rq, in the documentation
for more information about time zones\&.
.RE
.SH "NOTES"
.PP
The function
\fBset_config\fR
provides equivalent functionality; see
Section 9.26, \(lqSystem Administration Functions\(rq, in the documentation\&. Also, it is possible to UPDATE the
pg_settings
system view to perform the equivalent of
\fBSET\fR\&.
.SH "EXAMPLES"
.PP
Set the schema search path:
.sp
.if n \{\
.RS 4
.\}
.nf
SET search_path TO my_schema, public;
.fi
.if n \{\
.RE
.\}
.PP
Set the style of date to traditional
POSTGRES
with
\(lqday before month\(rq
input convention:
.sp
.if n \{\
.RS 4
.\}
.nf
SET datestyle TO postgres, dmy;
.fi
.if n \{\
.RE
.\}
.PP
Set the time zone for Berkeley, California:
.sp
.if n \{\
.RS 4
.\}
.nf
SET TIME ZONE \*(AqPST8PDT\*(Aq;
.fi
.if n \{\
.RE
.\}
.PP
Set the time zone for Italy:
.sp
.if n \{\
.RS 4
.\}
.nf
SET TIME ZONE \*(AqEurope/Rome\*(Aq;
.fi
.if n \{\
.RE
.\}
.SH "COMPATIBILITY"
.PP
SET TIME ZONE
extends syntax defined in the SQL standard\&. The standard allows only numeric time zone offsets while
PostgreSQL
allows more flexible time\-zone specifications\&. All other
SET
features are
PostgreSQL
extensions\&.
.SH "SEE ALSO"
\fBRESET\fR(7), \fBSHOW\fR(7)
man/man7/ALTER_FOREIGN_DATA_WRAPPER.7 0000644 00000011103 14751153421 0012261 0 ustar 00 '\" t
.\" Title: ALTER FOREIGN DATA WRAPPER
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "ALTER FOREIGN DATA WRAPPER" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
ALTER_FOREIGN_DATA_WRAPPER \- change the definition of a foreign\-data wrapper
.SH "SYNOPSIS"
.sp
.nf
ALTER FOREIGN DATA WRAPPER \fIname\fR
[ HANDLER \fIhandler_function\fR | NO HANDLER ]
[ VALIDATOR \fIvalidator_function\fR | NO VALIDATOR ]
[ OPTIONS ( [ ADD | SET | DROP ] \fIoption\fR [\*(Aq\fIvalue\fR\*(Aq] [, \&.\&.\&. ]) ]
ALTER FOREIGN DATA WRAPPER \fIname\fR OWNER TO { \fInew_owner\fR | CURRENT_USER | SESSION_USER }
ALTER FOREIGN DATA WRAPPER \fIname\fR RENAME TO \fInew_name\fR
.fi
.SH "DESCRIPTION"
.PP
\fBALTER FOREIGN DATA WRAPPER\fR
changes the definition of a foreign\-data wrapper\&. The first form of the command changes the support functions or the generic options of the foreign\-data wrapper (at least one clause is required)\&. The second form changes the owner of the foreign\-data wrapper\&.
.PP
Only superusers can alter foreign\-data wrappers\&. Additionally, only superusers can own foreign\-data wrappers\&.
.SH "PARAMETERS"
.PP
\fIname\fR
.RS 4
The name of an existing foreign\-data wrapper\&.
.RE
.PP
HANDLER \fIhandler_function\fR
.RS 4
Specifies a new handler function for the foreign\-data wrapper\&.
.RE
.PP
NO HANDLER
.RS 4
This is used to specify that the foreign\-data wrapper should no longer have a handler function\&.
.sp
Note that foreign tables that use a foreign\-data wrapper with no handler cannot be accessed\&.
.RE
.PP
VALIDATOR \fIvalidator_function\fR
.RS 4
Specifies a new validator function for the foreign\-data wrapper\&.
.sp
Note that it is possible that pre\-existing options of the foreign\-data wrapper, or of dependent servers, user mappings, or foreign tables, are invalid according to the new validator\&.
PostgreSQL
does not check for this\&. It is up to the user to make sure that these options are correct before using the modified foreign\-data wrapper\&. However, any options specified in this
\fBALTER FOREIGN DATA WRAPPER\fR
command will be checked using the new validator\&.
.RE
.PP
NO VALIDATOR
.RS 4
This is used to specify that the foreign\-data wrapper should no longer have a validator function\&.
.RE
.PP
OPTIONS ( [ ADD | SET | DROP ] \fIoption\fR [\*(Aq\fIvalue\fR\*(Aq] [, \&.\&.\&. ] )
.RS 4
Change options for the foreign\-data wrapper\&.
ADD,
SET, and
DROP
specify the action to be performed\&.
ADD
is assumed if no operation is explicitly specified\&. Option names must be unique; names and values are also validated using the foreign data wrapper\*(Aqs validator function, if any\&.
.RE
.PP
\fInew_owner\fR
.RS 4
The user name of the new owner of the foreign\-data wrapper\&.
.RE
.PP
\fInew_name\fR
.RS 4
The new name for the foreign\-data wrapper\&.
.RE
.SH "EXAMPLES"
.PP
Change a foreign\-data wrapper
dbi, add option
foo, drop
bar:
.sp
.if n \{\
.RS 4
.\}
.nf
ALTER FOREIGN DATA WRAPPER dbi OPTIONS (ADD foo \*(Aq1\*(Aq, DROP \*(Aqbar\*(Aq);
.fi
.if n \{\
.RE
.\}
.PP
Change the foreign\-data wrapper
dbi
validator to
bob\&.myvalidator:
.sp
.if n \{\
.RS 4
.\}
.nf
ALTER FOREIGN DATA WRAPPER dbi VALIDATOR bob\&.myvalidator;
.fi
.if n \{\
.RE
.\}
.SH "COMPATIBILITY"
.PP
\fBALTER FOREIGN DATA WRAPPER\fR
conforms to ISO/IEC 9075\-9 (SQL/MED), except that the
HANDLER,
VALIDATOR,
OWNER TO, and
RENAME
clauses are extensions\&.
.SH "SEE ALSO"
CREATE FOREIGN DATA WRAPPER (\fBCREATE_FOREIGN_DATA_WRAPPER\fR(7)), DROP FOREIGN DATA WRAPPER (\fBDROP_FOREIGN_DATA_WRAPPER\fR(7))
man/man7/DROP_TABLESPACE.7 0000644 00000004756 14751153421 0010517 0 ustar 00 '\" t
.\" Title: DROP TABLESPACE
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "DROP TABLESPACE" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
DROP_TABLESPACE \- remove a tablespace
.SH "SYNOPSIS"
.sp
.nf
DROP TABLESPACE [ IF EXISTS ] \fIname\fR
.fi
.SH "DESCRIPTION"
.PP
\fBDROP TABLESPACE\fR
removes a tablespace from the system\&.
.PP
A tablespace can only be dropped by its owner or a superuser\&. The tablespace must be empty of all database objects before it can be dropped\&. It is possible that objects in other databases might still reside in the tablespace even if no objects in the current database are using the tablespace\&. Also, if the tablespace is listed in the
temp_tablespaces
setting of any active session, the
\fBDROP\fR
might fail due to temporary files residing in the tablespace\&.
.SH "PARAMETERS"
.PP
IF EXISTS
.RS 4
Do not throw an error if the tablespace does not exist\&. A notice is issued in this case\&.
.RE
.PP
\fIname\fR
.RS 4
The name of a tablespace\&.
.RE
.SH "NOTES"
.PP
\fBDROP TABLESPACE\fR
cannot be executed inside a transaction block\&.
.SH "EXAMPLES"
.PP
To remove tablespace
mystuff
from the system:
.sp
.if n \{\
.RS 4
.\}
.nf
DROP TABLESPACE mystuff;
.fi
.if n \{\
.RE
.\}
.SH "COMPATIBILITY"
.PP
\fBDROP TABLESPACE\fR
is a
PostgreSQL
extension\&.
.SH "SEE ALSO"
CREATE TABLESPACE (\fBCREATE_TABLESPACE\fR(7)), ALTER TABLESPACE (\fBALTER_TABLESPACE\fR(7))
man/man7/DECLARE.7 0000644 00000024451 14751153421 0007321 0 ustar 00 '\" t
.\" Title: DECLARE
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "DECLARE" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
DECLARE \- define a cursor
.SH "SYNOPSIS"
.sp
.nf
DECLARE \fIname\fR [ BINARY ] [ INSENSITIVE ] [ [ NO ] SCROLL ]
CURSOR [ { WITH | WITHOUT } HOLD ] FOR \fIquery\fR
.fi
.SH "DESCRIPTION"
.PP
\fBDECLARE\fR
allows a user to create cursors, which can be used to retrieve a small number of rows at a time out of a larger query\&. After the cursor is created, rows are fetched from it using
\fBFETCH\fR(7)\&.
.if n \{\
.sp
.\}
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBNote\fR
.ps -1
.br
.PP
This page describes usage of cursors at the SQL command level\&. If you are trying to use cursors inside a
PL/pgSQL
function, the rules are different \(em see
Section 41.7, \(lqCursors\(rq, in the documentation\&.
.sp .5v
.RE
.SH "PARAMETERS"
.PP
\fIname\fR
.RS 4
The name of the cursor to be created\&.
.RE
.PP
BINARY
.RS 4
Causes the cursor to return data in binary rather than in text format\&.
.RE
.PP
INSENSITIVE
.RS 4
Indicates that data retrieved from the cursor should be unaffected by updates to the table(s) underlying the cursor that occur after the cursor is created\&. In
PostgreSQL, this is the default behavior; so this key word has no effect and is only accepted for compatibility with the SQL standard\&.
.RE
.PP
SCROLL
.br
NO SCROLL
.RS 4
SCROLL
specifies that the cursor can be used to retrieve rows in a nonsequential fashion (e\&.g\&., backward)\&. Depending upon the complexity of the query\*(Aqs execution plan, specifying
SCROLL
might impose a performance penalty on the query\*(Aqs execution time\&.
NO SCROLL
specifies that the cursor cannot be used to retrieve rows in a nonsequential fashion\&. The default is to allow scrolling in some cases; this is not the same as specifying
SCROLL\&. See
NOTES
for details\&.
.RE
.PP
WITH HOLD
.br
WITHOUT HOLD
.RS 4
WITH HOLD
specifies that the cursor can continue to be used after the transaction that created it successfully commits\&.
WITHOUT HOLD
specifies that the cursor cannot be used outside of the transaction that created it\&. If neither
WITHOUT HOLD
nor
WITH HOLD
is specified,
WITHOUT HOLD
is the default\&.
.RE
.PP
\fIquery\fR
.RS 4
A
\fBSELECT\fR(7)
or
\fBVALUES\fR(7)
command which will provide the rows to be returned by the cursor\&.
.RE
.PP
The key words
BINARY,
INSENSITIVE, and
SCROLL
can appear in any order\&.
.SH "NOTES"
.PP
Normal cursors return data in text format, the same as a
\fBSELECT\fR
would produce\&. The
BINARY
option specifies that the cursor should return data in binary format\&. This reduces conversion effort for both the server and client, at the cost of more programmer effort to deal with platform\-dependent binary data formats\&. As an example, if a query returns a value of one from an integer column, you would get a string of
1
with a default cursor, whereas with a binary cursor you would get a 4\-byte field containing the internal representation of the value (in big\-endian byte order)\&.
.PP
Binary cursors should be used carefully\&. Many applications, including
psql, are not prepared to handle binary cursors and expect data to come back in the text format\&.
.if n \{\
.sp
.\}
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBNote\fR
.ps -1
.br
.PP
When the client application uses the
\(lqextended query\(rq
protocol to issue a
\fBFETCH\fR
command, the Bind protocol message specifies whether data is to be retrieved in text or binary format\&. This choice overrides the way that the cursor is defined\&. The concept of a binary cursor as such is thus obsolete when using extended query protocol \(em any cursor can be treated as either text or binary\&.
.sp .5v
.RE
.PP
Unless
WITH HOLD
is specified, the cursor created by this command can only be used within the current transaction\&. Thus,
\fBDECLARE\fR
without
WITH HOLD
is useless outside a transaction block: the cursor would survive only to the completion of the statement\&. Therefore
PostgreSQL
reports an error if such a command is used outside a transaction block\&. Use
\fBBEGIN\fR(7)
and
\fBCOMMIT\fR(7)
(or
\fBROLLBACK\fR(7)) to define a transaction block\&.
.PP
If
WITH HOLD
is specified and the transaction that created the cursor successfully commits, the cursor can continue to be accessed by subsequent transactions in the same session\&. (But if the creating transaction is aborted, the cursor is removed\&.) A cursor created with
WITH HOLD
is closed when an explicit
\fBCLOSE\fR
command is issued on it, or the session ends\&. In the current implementation, the rows represented by a held cursor are copied into a temporary file or memory area so that they remain available for subsequent transactions\&.
.PP
WITH HOLD
may not be specified when the query includes
FOR UPDATE
or
FOR SHARE\&.
.PP
The
SCROLL
option should be specified when defining a cursor that will be used to fetch backwards\&. This is required by the SQL standard\&. However, for compatibility with earlier versions,
PostgreSQL
will allow backward fetches without
SCROLL, if the cursor\*(Aqs query plan is simple enough that no extra overhead is needed to support it\&. However, application developers are advised not to rely on using backward fetches from a cursor that has not been created with
SCROLL\&. If
NO SCROLL
is specified, then backward fetches are disallowed in any case\&.
.PP
Backward fetches are also disallowed when the query includes
FOR UPDATE
or
FOR SHARE; therefore
SCROLL
may not be specified in this case\&.
.if n \{\
.sp
.\}
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBCaution\fR
.ps -1
.br
.PP
Scrollable and
WITH HOLD
cursors may give unexpected results if they invoke any volatile functions (see
Section 36.6, \(lqFunction Volatility Categories\(rq, in the documentation)\&. When a previously fetched row is re\-fetched, the functions might be re\-executed, perhaps leading to results different from the first time\&. One workaround for such cases is to declare the cursor
WITH HOLD
and commit the transaction before reading any rows from it\&. This will force the entire output of the cursor to be materialized in temporary storage, so that volatile functions are executed exactly once for each row\&.
.sp .5v
.RE
.PP
If the cursor\*(Aqs query includes
FOR UPDATE
or
FOR SHARE, then returned rows are locked at the time they are first fetched, in the same way as for a regular
\fBSELECT\fR(7)
command with these options\&. In addition, the returned rows will be the most up\-to\-date versions; therefore these options provide the equivalent of what the SQL standard calls a
\(lqsensitive cursor\(rq\&. (Specifying
INSENSITIVE
together with
FOR UPDATE
or
FOR SHARE
is an error\&.)
.if n \{\
.sp
.\}
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBCaution\fR
.ps -1
.br
.PP
It is generally recommended to use
FOR UPDATE
if the cursor is intended to be used with
\fBUPDATE \&.\&.\&. WHERE CURRENT OF\fR
or
\fBDELETE \&.\&.\&. WHERE CURRENT OF\fR\&. Using
FOR UPDATE
prevents other sessions from changing the rows between the time they are fetched and the time they are updated\&. Without
FOR UPDATE, a subsequent
WHERE CURRENT OF
command will have no effect if the row was changed since the cursor was created\&.
.PP
Another reason to use
FOR UPDATE
is that without it, a subsequent
WHERE CURRENT OF
might fail if the cursor query does not meet the SQL standard\*(Aqs rules for being
\(lqsimply updatable\(rq
(in particular, the cursor must reference just one table and not use grouping or
ORDER BY)\&. Cursors that are not simply updatable might work, or might not, depending on plan choice details; so in the worst case, an application might work in testing and then fail in production\&. If
FOR UPDATE
is specified, the cursor is guaranteed to be updatable\&.
.PP
The main reason not to use
FOR UPDATE
with
WHERE CURRENT OF
is if you need the cursor to be scrollable, or to be insensitive to the subsequent updates (that is, continue to show the old data)\&. If this is a requirement, pay close heed to the caveats shown above\&.
.sp .5v
.RE
.PP
The SQL standard only makes provisions for cursors in embedded
SQL\&. The
PostgreSQL
server does not implement an
\fBOPEN\fR
statement for cursors; a cursor is considered to be open when it is declared\&. However,
ECPG, the embedded SQL preprocessor for
PostgreSQL, supports the standard SQL cursor conventions, including those involving
\fBDECLARE\fR
and
\fBOPEN\fR
statements\&.
.PP
You can see all available cursors by querying the
pg_cursors
system view\&.
.SH "EXAMPLES"
.PP
To declare a cursor:
.sp
.if n \{\
.RS 4
.\}
.nf
DECLARE liahona CURSOR FOR SELECT * FROM films;
.fi
.if n \{\
.RE
.\}
.sp
See
\fBFETCH\fR(7)
for more examples of cursor usage\&.
.SH "COMPATIBILITY"
.PP
The SQL standard says that it is implementation\-dependent whether cursors are sensitive to concurrent updates of the underlying data by default\&. In
PostgreSQL, cursors are insensitive by default, and can be made sensitive by specifying
FOR UPDATE\&. Other products may work differently\&.
.PP
The SQL standard allows cursors only in embedded
SQL
and in modules\&.
PostgreSQL
permits cursors to be used interactively\&.
.PP
Binary cursors are a
PostgreSQL
extension\&.
.SH "SEE ALSO"
\fBCLOSE\fR(7), \fBFETCH\fR(7), \fBMOVE\fR(7)
man/man7/ALTER_SCHEMA.7 0000644 00000004505 14751153421 0010147 0 ustar 00 '\" t
.\" Title: ALTER SCHEMA
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "ALTER SCHEMA" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
ALTER_SCHEMA \- change the definition of a schema
.SH "SYNOPSIS"
.sp
.nf
ALTER SCHEMA \fIname\fR RENAME TO \fInew_name\fR
ALTER SCHEMA \fIname\fR OWNER TO { \fInew_owner\fR | CURRENT_USER | SESSION_USER }
.fi
.SH "DESCRIPTION"
.PP
\fBALTER SCHEMA\fR
changes the definition of a schema\&.
.PP
You must own the schema to use
\fBALTER SCHEMA\fR\&. To rename a schema you must also have the
CREATE
privilege for the database\&. To alter the owner, you must also be a direct or indirect member of the new owning role, and you must have the
CREATE
privilege for the database\&. (Note that superusers have all these privileges automatically\&.)
.SH "PARAMETERS"
.PP
\fIname\fR
.RS 4
The name of an existing schema\&.
.RE
.PP
\fInew_name\fR
.RS 4
The new name of the schema\&. The new name cannot begin with
pg_, as such names are reserved for system schemas\&.
.RE
.PP
\fInew_owner\fR
.RS 4
The new owner of the schema\&.
.RE
.SH "COMPATIBILITY"
.PP
There is no
\fBALTER SCHEMA\fR
statement in the SQL standard\&.
.SH "SEE ALSO"
CREATE SCHEMA (\fBCREATE_SCHEMA\fR(7)), DROP SCHEMA (\fBDROP_SCHEMA\fR(7))
man/man7/DEALLOCATE.7 0000644 00000003763 14751153421 0007662 0 ustar 00 '\" t
.\" Title: DEALLOCATE
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "DEALLOCATE" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
DEALLOCATE \- deallocate a prepared statement
.SH "SYNOPSIS"
.sp
.nf
DEALLOCATE [ PREPARE ] { \fIname\fR | ALL }
.fi
.SH "DESCRIPTION"
.PP
\fBDEALLOCATE\fR
is used to deallocate a previously prepared SQL statement\&. If you do not explicitly deallocate a prepared statement, it is deallocated when the session ends\&.
.PP
For more information on prepared statements, see
\fBPREPARE\fR(7)\&.
.SH "PARAMETERS"
.PP
PREPARE
.RS 4
This key word is ignored\&.
.RE
.PP
\fIname\fR
.RS 4
The name of the prepared statement to deallocate\&.
.RE
.PP
ALL
.RS 4
Deallocate all prepared statements\&.
.RE
.SH "COMPATIBILITY"
.PP
The SQL standard includes a
\fBDEALLOCATE\fR
statement, but it is only for use in embedded SQL\&.
.SH "SEE ALSO"
\fBEXECUTE\fR(7), \fBPREPARE\fR(7)
man/man7/NOTIFY.7 0000644 00000020334 14751153421 0007266 0 ustar 00 '\" t
.\" Title: NOTIFY
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "NOTIFY" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
NOTIFY \- generate a notification
.SH "SYNOPSIS"
.sp
.nf
NOTIFY \fIchannel\fR [ , \fIpayload\fR ]
.fi
.SH "DESCRIPTION"
.PP
The
\fBNOTIFY\fR
command sends a notification event together with an optional
\(lqpayload\(rq
string to each client application that has previously executed
\fBLISTEN \fR\fB\fIchannel\fR\fR
for the specified channel name in the current database\&. Notifications are visible to all users\&.
.PP
\fBNOTIFY\fR
provides a simple interprocess communication mechanism for a collection of processes accessing the same
PostgreSQL
database\&. A payload string can be sent along with the notification, and higher\-level mechanisms for passing structured data can be built by using tables in the database to pass additional data from notifier to listener(s)\&.
.PP
The information passed to the client for a notification event includes the notification channel name, the notifying session\*(Aqs server process
PID, and the payload string, which is an empty string if it has not been specified\&.
.PP
It is up to the database designer to define the channel names that will be used in a given database and what each one means\&. Commonly, the channel name is the same as the name of some table in the database, and the notify event essentially means,
\(lqI changed this table, take a look at it to see what\*(Aqs new\(rq\&. But no such association is enforced by the
\fBNOTIFY\fR
and
\fBLISTEN\fR
commands\&. For example, a database designer could use several different channel names to signal different sorts of changes to a single table\&. Alternatively, the payload string could be used to differentiate various cases\&.
.PP
When
\fBNOTIFY\fR
is used to signal the occurrence of changes to a particular table, a useful programming technique is to put the
\fBNOTIFY\fR
in a statement trigger that is triggered by table updates\&. In this way, notification happens automatically when the table is changed, and the application programmer cannot accidentally forget to do it\&.
.PP
\fBNOTIFY\fR
interacts with SQL transactions in some important ways\&. Firstly, if a
\fBNOTIFY\fR
is executed inside a transaction, the notify events are not delivered until and unless the transaction is committed\&. This is appropriate, since if the transaction is aborted, all the commands within it have had no effect, including
\fBNOTIFY\fR\&. But it can be disconcerting if one is expecting the notification events to be delivered immediately\&. Secondly, if a listening session receives a notification signal while it is within a transaction, the notification event will not be delivered to its connected client until just after the transaction is completed (either committed or aborted)\&. Again, the reasoning is that if a notification were delivered within a transaction that was later aborted, one would want the notification to be undone somehow \(em but the server cannot
\(lqtake back\(rq
a notification once it has sent it to the client\&. So notification events are only delivered between transactions\&. The upshot of this is that applications using
\fBNOTIFY\fR
for real\-time signaling should try to keep their transactions short\&.
.PP
If the same channel name is signaled multiple times from the same transaction with identical payload strings, the database server can decide to deliver a single notification only\&. On the other hand, notifications with distinct payload strings will always be delivered as distinct notifications\&. Similarly, notifications from different transactions will never get folded into one notification\&. Except for dropping later instances of duplicate notifications,
\fBNOTIFY\fR
guarantees that notifications from the same transaction get delivered in the order they were sent\&. It is also guaranteed that messages from different transactions are delivered in the order in which the transactions committed\&.
.PP
It is common for a client that executes
\fBNOTIFY\fR
to be listening on the same notification channel itself\&. In that case it will get back a notification event, just like all the other listening sessions\&. Depending on the application logic, this could result in useless work, for example, reading a database table to find the same updates that that session just wrote out\&. It is possible to avoid such extra work by noticing whether the notifying session\*(Aqs server process
PID
(supplied in the notification event message) is the same as one\*(Aqs own session\*(Aqs
PID
(available from
libpq)\&. When they are the same, the notification event is one\*(Aqs own work bouncing back, and can be ignored\&.
.SH "PARAMETERS"
.PP
\fIchannel\fR
.RS 4
Name of the notification channel to be signaled (any identifier)\&.
.RE
.PP
\fIpayload\fR
.RS 4
The
\(lqpayload\(rq
string to be communicated along with the notification\&. This must be specified as a simple string literal\&. In the default configuration it must be shorter than 8000 bytes\&. (If binary data or large amounts of information need to be communicated, it\*(Aqs best to put it in a database table and send the key of the record\&.)
.RE
.SH "NOTES"
.PP
There is a queue that holds notifications that have been sent but not yet processed by all listening sessions\&. If this queue becomes full, transactions calling
\fBNOTIFY\fR
will fail at commit\&. The queue is quite large (8GB in a standard installation) and should be sufficiently sized for almost every use case\&. However, no cleanup can take place if a session executes
\fBLISTEN\fR
and then enters a transaction for a very long time\&. Once the queue is half full you will see warnings in the log file pointing you to the session that is preventing cleanup\&. In this case you should make sure that this session ends its current transaction so that cleanup can proceed\&.
.PP
The function
\fBpg_notification_queue_usage\fR
returns the fraction of the queue that is currently occupied by pending notifications\&. See
Section 9.25, \(lqSystem Information Functions\(rq, in the documentation
for more information\&.
.PP
A transaction that has executed
\fBNOTIFY\fR
cannot be prepared for two\-phase commit\&.
.SS "pg_notify"
.PP
To send a notification you can also use the function
\fBpg_notify\fR(text, text)\&. The function takes the channel name as the first argument and the payload as the second\&. The function is much easier to use than the
\fBNOTIFY\fR
command if you need to work with non\-constant channel names and payloads\&.
.SH "EXAMPLES"
.PP
Configure and execute a listen/notify sequence from
psql:
.sp
.if n \{\
.RS 4
.\}
.nf
LISTEN virtual;
NOTIFY virtual;
Asynchronous notification "virtual" received from server process with PID 8448\&.
NOTIFY virtual, \*(AqThis is the payload\*(Aq;
Asynchronous notification "virtual" with payload "This is the payload" received from server process with PID 8448\&.
LISTEN foo;
SELECT pg_notify(\*(Aqfo\*(Aq || \*(Aqo\*(Aq, \*(Aqpay\*(Aq || \*(Aqload\*(Aq);
Asynchronous notification "foo" with payload "payload" received from server process with PID 14728\&.
.fi
.if n \{\
.RE
.\}
.SH "COMPATIBILITY"
.PP
There is no
\fBNOTIFY\fR
statement in the SQL standard\&.
.SH "SEE ALSO"
\fBLISTEN\fR(7), \fBUNLISTEN\fR(7)
man/man7/ALTER_TABLE.7 0000644 00000111015 14751153421 0010031 0 ustar 00 '\" t
.\" Title: ALTER TABLE
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "ALTER TABLE" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
ALTER_TABLE \- change the definition of a table
.SH "SYNOPSIS"
.sp
.nf
ALTER TABLE [ IF EXISTS ] [ ONLY ] \fIname\fR [ * ]
\fIaction\fR [, \&.\&.\&. ]
ALTER TABLE [ IF EXISTS ] [ ONLY ] \fIname\fR [ * ]
RENAME [ COLUMN ] \fIcolumn_name\fR TO \fInew_column_name\fR
ALTER TABLE [ IF EXISTS ] [ ONLY ] \fIname\fR [ * ]
RENAME CONSTRAINT \fIconstraint_name\fR TO \fInew_constraint_name\fR
ALTER TABLE [ IF EXISTS ] \fIname\fR
RENAME TO \fInew_name\fR
ALTER TABLE [ IF EXISTS ] \fIname\fR
SET SCHEMA \fInew_schema\fR
ALTER TABLE ALL IN TABLESPACE \fIname\fR [ OWNED BY \fIrole_name\fR [, \&.\&.\&. ] ]
SET TABLESPACE \fInew_tablespace\fR [ NOWAIT ]
where \fIaction\fR is one of:
ADD [ COLUMN ] [ IF NOT EXISTS ] \fIcolumn_name\fR \fIdata_type\fR [ COLLATE \fIcollation\fR ] [ \fIcolumn_constraint\fR [ \&.\&.\&. ] ]
DROP [ COLUMN ] [ IF EXISTS ] \fIcolumn_name\fR [ RESTRICT | CASCADE ]
ALTER [ COLUMN ] \fIcolumn_name\fR [ SET DATA ] TYPE \fIdata_type\fR [ COLLATE \fIcollation\fR ] [ USING \fIexpression\fR ]
ALTER [ COLUMN ] \fIcolumn_name\fR SET DEFAULT \fIexpression\fR
ALTER [ COLUMN ] \fIcolumn_name\fR DROP DEFAULT
ALTER [ COLUMN ] \fIcolumn_name\fR { SET | DROP } NOT NULL
ALTER [ COLUMN ] \fIcolumn_name\fR SET STATISTICS \fIinteger\fR
ALTER [ COLUMN ] \fIcolumn_name\fR SET ( \fIattribute_option\fR = \fIvalue\fR [, \&.\&.\&. ] )
ALTER [ COLUMN ] \fIcolumn_name\fR RESET ( \fIattribute_option\fR [, \&.\&.\&. ] )
ALTER [ COLUMN ] \fIcolumn_name\fR SET STORAGE { PLAIN | EXTERNAL | EXTENDED | MAIN }
ADD \fItable_constraint\fR [ NOT VALID ]
ADD \fItable_constraint_using_index\fR
ALTER CONSTRAINT \fIconstraint_name\fR [ DEFERRABLE | NOT DEFERRABLE ] [ INITIALLY DEFERRED | INITIALLY IMMEDIATE ]
VALIDATE CONSTRAINT \fIconstraint_name\fR
DROP CONSTRAINT [ IF EXISTS ] \fIconstraint_name\fR [ RESTRICT | CASCADE ]
DISABLE TRIGGER [ \fItrigger_name\fR | ALL | USER ]
ENABLE TRIGGER [ \fItrigger_name\fR | ALL | USER ]
ENABLE REPLICA TRIGGER \fItrigger_name\fR
ENABLE ALWAYS TRIGGER \fItrigger_name\fR
DISABLE RULE \fIrewrite_rule_name\fR
ENABLE RULE \fIrewrite_rule_name\fR
ENABLE REPLICA RULE \fIrewrite_rule_name\fR
ENABLE ALWAYS RULE \fIrewrite_rule_name\fR
DISABLE ROW LEVEL SECURITY
ENABLE ROW LEVEL SECURITY
FORCE ROW LEVEL SECURITY
NO FORCE ROW LEVEL SECURITY
CLUSTER ON \fIindex_name\fR
SET WITHOUT CLUSTER
SET WITH OIDS
SET WITHOUT OIDS
SET TABLESPACE \fInew_tablespace\fR
SET { LOGGED | UNLOGGED }
SET ( \fIstorage_parameter\fR [= \fIvalue\fR] [, \&.\&.\&. ] )
RESET ( \fIstorage_parameter\fR [, \&.\&.\&. ] )
INHERIT \fIparent_table\fR
NO INHERIT \fIparent_table\fR
OF \fItype_name\fR
NOT OF
OWNER TO { \fInew_owner\fR | CURRENT_USER | SESSION_USER }
REPLICA IDENTITY { DEFAULT | USING INDEX \fIindex_name\fR | FULL | NOTHING }
and \fItable_constraint_using_index\fR is:
[ CONSTRAINT \fIconstraint_name\fR ]
{ UNIQUE | PRIMARY KEY } USING INDEX \fIindex_name\fR
[ DEFERRABLE | NOT DEFERRABLE ] [ INITIALLY DEFERRED | INITIALLY IMMEDIATE ]
.fi
.SH "DESCRIPTION"
.PP
\fBALTER TABLE\fR
changes the definition of an existing table\&. There are several subforms described below\&. Note that the lock level required may differ for each subform\&. An
ACCESS EXCLUSIVE
lock is acquired unless explicitly noted\&. When multiple subcommands are given, the lock acquired will be the strictest one required by any subcommand\&.
.PP
ADD COLUMN [ IF NOT EXISTS ]
.RS 4
This form adds a new column to the table, using the same syntax as
CREATE TABLE (\fBCREATE_TABLE\fR(7))\&. If
IF NOT EXISTS
is specified and a column already exists with this name, no error is thrown\&.
.RE
.PP
DROP COLUMN [ IF EXISTS ]
.RS 4
This form drops a column from a table\&. Indexes and table constraints involving the column will be automatically dropped as well\&. You will need to say
CASCADE
if anything outside the table depends on the column, for example, foreign key references or views\&. If
IF EXISTS
is specified and the column does not exist, no error is thrown\&. In this case a notice is issued instead\&.
.RE
.PP
SET DATA TYPE
.RS 4
This form changes the type of a column of a table\&. Indexes and simple table constraints involving the column will be automatically converted to use the new column type by reparsing the originally supplied expression\&. The optional
COLLATE
clause specifies a collation for the new column; if omitted, the collation is the default for the new column type\&. The optional
USING
clause specifies how to compute the new column value from the old; if omitted, the default conversion is the same as an assignment cast from old data type to new\&. A
USING
clause must be provided if there is no implicit or assignment cast from old to new type\&.
.RE
.PP
SET/DROP DEFAULT
.RS 4
These forms set or remove the default value for a column\&. Default values only apply in subsequent
\fBINSERT\fR
or
\fBUPDATE\fR
commands; they do not cause rows already in the table to change\&.
.RE
.PP
SET/DROP NOT NULL
.RS 4
These forms change whether a column is marked to allow null values or to reject null values\&. You can only use
SET NOT NULL
when the column contains no null values\&.
.RE
.PP
SET STATISTICS
.RS 4
This form sets the per\-column statistics\-gathering target for subsequent
\fBANALYZE\fR(7)
operations\&. The target can be set in the range 0 to 10000; alternatively, set it to \-1 to revert to using the system default statistics target (default_statistics_target)\&. For more information on the use of statistics by the
PostgreSQL
query planner, refer to
Section 14.2, \(lqStatistics Used by the Planner\(rq, in the documentation\&.
.sp
SET STATISTICS
acquires a
SHARE UPDATE EXCLUSIVE
lock\&.
.RE
.PP
SET ( \fIattribute_option\fR = \fIvalue\fR [, \&.\&.\&. ] )
.br
RESET ( \fIattribute_option\fR [, \&.\&.\&. ] )
.RS 4
This form sets or resets per\-attribute options\&. Currently, the only defined per\-attribute options are
n_distinct
and
n_distinct_inherited, which override the number\-of\-distinct\-values estimates made by subsequent
\fBANALYZE\fR(7)
operations\&.
n_distinct
affects the statistics for the table itself, while
n_distinct_inherited
affects the statistics gathered for the table plus its inheritance children\&. When set to a positive value,
\fBANALYZE\fR
will assume that the column contains exactly the specified number of distinct nonnull values\&. When set to a negative value, which must be greater than or equal to \-1,
\fBANALYZE\fR
will assume that the number of distinct nonnull values in the column is linear in the size of the table; the exact count is to be computed by multiplying the estimated table size by the absolute value of the given number\&. For example, a value of \-1 implies that all values in the column are distinct, while a value of \-0\&.5 implies that each value appears twice on the average\&. This can be useful when the size of the table changes over time, since the multiplication by the number of rows in the table is not performed until query planning time\&. Specify a value of 0 to revert to estimating the number of distinct values normally\&. For more information on the use of statistics by the
PostgreSQL
query planner, refer to
Section 14.2, \(lqStatistics Used by the Planner\(rq, in the documentation\&.
.sp
Changing per\-attribute options acquires a
SHARE UPDATE EXCLUSIVE
lock\&.
.RE
.PP
SET STORAGE
.RS 4
This form sets the storage mode for a column\&. This controls whether this column is held inline or in a secondary
TOAST
table, and whether the data should be compressed or not\&.
PLAIN
must be used for fixed\-length values such as
integer
and is inline, uncompressed\&.
MAIN
is for inline, compressible data\&.
EXTERNAL
is for external, uncompressed data, and
EXTENDED
is for external, compressed data\&.
EXTENDED
is the default for most data types that support non\-PLAIN
storage\&. Use of
EXTERNAL
will make substring operations on very large
text
and
bytea
values run faster, at the penalty of increased storage space\&. Note that
SET STORAGE
doesn\*(Aqt itself change anything in the table, it just sets the strategy to be pursued during future table updates\&. See
Section 65.2, \(lqTOAST\(rq, in the documentation
for more information\&.
.RE
.PP
ADD \fItable_constraint\fR [ NOT VALID ]
.RS 4
This form adds a new constraint to a table using the same constraint syntax as
CREATE TABLE (\fBCREATE_TABLE\fR(7)), plus the option
NOT VALID, which is currently only allowed for foreign key and CHECK constraints\&.
.sp
Normally, this form will cause a scan of the table to verify that all existing rows in the table satisfy the new constraint\&. But if the
NOT VALID
option is used, this potentially\-lengthy scan is skipped\&. The constraint will still be enforced against subsequent inserts or updates (that is, they\*(Aqll fail unless there is a matching row in the referenced table, in the case of foreign keys, or they\*(Aqll fail unless the new row matches the specified check condition)\&. But the database will not assume that the constraint holds for all rows in the table, until it is validated by using the
VALIDATE CONSTRAINT
option\&. See
NOTES
below for more information about using the
NOT VALID
option\&.
.sp
Although most forms of
ADD \fItable_constraint\fR
require an
ACCESS EXCLUSIVE
lock,
ADD FOREIGN KEY
requires only a
SHARE ROW EXCLUSIVE
lock\&. Note that
ADD FOREIGN KEY
also acquires a
SHARE ROW EXCLUSIVE
lock on the referenced table, in addition to the lock on the table on which the constraint is declared\&.
.RE
.PP
ADD \fItable_constraint_using_index\fR
.RS 4
This form adds a new
PRIMARY KEY
or
UNIQUE
constraint to a table based on an existing unique index\&. All the columns of the index will be included in the constraint\&.
.sp
The index cannot have expression columns nor be a partial index\&. Also, it must be a b\-tree index with default sort ordering\&. These restrictions ensure that the index is equivalent to one that would be built by a regular
ADD PRIMARY KEY
or
ADD UNIQUE
command\&.
.sp
If
PRIMARY KEY
is specified, and the index\*(Aqs columns are not already marked
NOT NULL, then this command will attempt to do
ALTER COLUMN SET NOT NULL
against each such column\&. That requires a full table scan to verify the column(s) contain no nulls\&. In all other cases, this is a fast operation\&.
.sp
If a constraint name is provided then the index will be renamed to match the constraint name\&. Otherwise the constraint will be named the same as the index\&.
.sp
After this command is executed, the index is
\(lqowned\(rq
by the constraint, in the same way as if the index had been built by a regular
ADD PRIMARY KEY
or
ADD UNIQUE
command\&. In particular, dropping the constraint will make the index disappear too\&.
.if n \{\
.sp
.\}
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBNote\fR
.ps -1
.br
Adding a constraint using an existing index can be helpful in situations where a new constraint needs to be added without blocking table updates for a long time\&. To do that, create the index using
\fBCREATE INDEX CONCURRENTLY\fR, and then install it as an official constraint using this syntax\&. See the example below\&.
.sp .5v
.RE
.RE
.PP
ALTER CONSTRAINT
.RS 4
This form alters the attributes of a constraint that was previously created\&. Currently only foreign key constraints may be altered\&.
.RE
.PP
VALIDATE CONSTRAINT
.RS 4
This form validates a foreign key or check constraint that was previously created as
NOT VALID, by scanning the table to ensure there are no rows for which the constraint is not satisfied\&. Nothing happens if the constraint is already marked valid\&. (See
NOTES
below for an explanation of the usefulness of this command\&.)
.sp
This command acquires a
SHARE UPDATE EXCLUSIVE
lock\&.
.RE
.PP
DROP CONSTRAINT [ IF EXISTS ]
.RS 4
This form drops the specified constraint on a table\&. If
IF EXISTS
is specified and the constraint does not exist, no error is thrown\&. In this case a notice is issued instead\&.
.RE
.PP
DISABLE/ENABLE [ REPLICA | ALWAYS ] TRIGGER
.RS 4
These forms configure the firing of trigger(s) belonging to the table\&. A disabled trigger is still known to the system, but is not executed when its triggering event occurs\&. For a deferred trigger, the enable status is checked when the event occurs, not when the trigger function is actually executed\&. One can disable or enable a single trigger specified by name, or all triggers on the table, or only user triggers (this option excludes internally generated constraint triggers such as those that are used to implement foreign key constraints or deferrable uniqueness and exclusion constraints)\&. Disabling or enabling internally generated constraint triggers requires superuser privileges; it should be done with caution since of course the integrity of the constraint cannot be guaranteed if the triggers are not executed\&. The trigger firing mechanism is also affected by the configuration variable
session_replication_role\&. Simply enabled triggers will fire when the replication role is
\(lqorigin\(rq
(the default) or
\(lqlocal\(rq\&. Triggers configured as
ENABLE REPLICA
will only fire if the session is in
\(lqreplica\(rq
mode, and triggers configured as
ENABLE ALWAYS
will fire regardless of the current replication mode\&.
.sp
This command acquires a
SHARE ROW EXCLUSIVE
lock\&.
.RE
.PP
DISABLE/ENABLE [ REPLICA | ALWAYS ] RULE
.RS 4
These forms configure the firing of rewrite rules belonging to the table\&. A disabled rule is still known to the system, but is not applied during query rewriting\&. The semantics are as for disabled/enabled triggers\&. This configuration is ignored for
ON SELECT
rules, which are always applied in order to keep views working even if the current session is in a non\-default replication role\&.
.RE
.PP
DISABLE/ENABLE ROW LEVEL SECURITY
.RS 4
These forms control the application of row security policies belonging to the table\&. If enabled and no policies exist for the table, then a default\-deny policy is applied\&. Note that policies can exist for a table even if row level security is disabled \- in this case, the policies will NOT be applied and the policies will be ignored\&. See also
CREATE POLICY (\fBCREATE_POLICY\fR(7))\&.
.RE
.PP
NO FORCE/FORCE ROW LEVEL SECURITY
.RS 4
These forms control the application of row security policies belonging to the table when the user is the table owner\&. If enabled, row level security policies will be applied when the user is the table owner\&. If disabled (the default) then row level security will not be applied when the user is the table owner\&. See also
CREATE POLICY (\fBCREATE_POLICY\fR(7))\&.
.RE
.PP
CLUSTER ON
.RS 4
This form selects the default index for future
\fBCLUSTER\fR(7)
operations\&. It does not actually re\-cluster the table\&.
.sp
Changing cluster options acquires a
SHARE UPDATE EXCLUSIVE
lock\&.
.RE
.PP
SET WITHOUT CLUSTER
.RS 4
This form removes the most recently used
\fBCLUSTER\fR(7)
index specification from the table\&. This affects future cluster operations that don\*(Aqt specify an index\&.
.sp
Changing cluster options acquires a
SHARE UPDATE EXCLUSIVE
lock\&.
.RE
.PP
SET WITH OIDS
.RS 4
This form adds an
oid
system column to the table (see
Section 5.4, \(lqSystem Columns\(rq, in the documentation)\&. It does nothing if the table already has OIDs\&.
.sp
Note that this is not equivalent to
ADD COLUMN oid oid; that would add a normal column that happened to be named
oid, not a system column\&.
.RE
.PP
SET WITHOUT OIDS
.RS 4
This form removes the
oid
system column from the table\&. This is exactly equivalent to
DROP COLUMN oid RESTRICT, except that it will not complain if there is already no
oid
column\&.
.RE
.PP
SET TABLESPACE
.RS 4
This form changes the table\*(Aqs tablespace to the specified tablespace and moves the data file(s) associated with the table to the new tablespace\&. Indexes on the table, if any, are not moved; but they can be moved separately with additional
SET TABLESPACE
commands\&. All tables in the current database in a tablespace can be moved by using the
ALL IN TABLESPACE
form, which will lock all tables to be moved first and then move each one\&. This form also supports
OWNED BY, which will only move tables owned by the roles specified\&. If the
NOWAIT
option is specified then the command will fail if it is unable to acquire all of the locks required immediately\&. Note that system catalogs are not moved by this command, use
\fBALTER DATABASE\fR
or explicit
\fBALTER TABLE\fR
invocations instead if desired\&. The
information_schema
relations are not considered part of the system catalogs and will be moved\&. See also
CREATE TABLESPACE (\fBCREATE_TABLESPACE\fR(7))\&.
.RE
.PP
SET { LOGGED | UNLOGGED }
.RS 4
This form changes the table from unlogged to logged or vice\-versa (see
UNLOGGED)\&. It cannot be applied to a temporary table\&.
.RE
.PP
SET ( \fIstorage_parameter\fR [= \fIvalue\fR] [, \&.\&.\&. ] )
.RS 4
This form changes one or more storage parameters for the table\&. See
Storage Parameters
for details on the available parameters\&. Note that the table contents will not be modified immediately by this command; depending on the parameter you might need to rewrite the table to get the desired effects\&. That can be done with
VACUUM FULL,
\fBCLUSTER\fR(7)
or one of the forms of
\fBALTER TABLE\fR
that forces a table rewrite\&.
.sp
Changing fillfactor and autovacuum storage parameters acquires a
SHARE UPDATE EXCLUSIVE
lock\&.
.if n \{\
.sp
.\}
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBNote\fR
.ps -1
.br
While
\fBCREATE TABLE\fR
allows
OIDS
to be specified in the
WITH (\fIstorage_parameter\fR)
syntax,
\fBALTER TABLE\fR
does not treat
OIDS
as a storage parameter\&. Instead use the
SET WITH OIDS
and
SET WITHOUT OIDS
forms to change OID status\&.
.sp .5v
.RE
.RE
.PP
RESET ( \fIstorage_parameter\fR [, \&.\&.\&. ] )
.RS 4
This form resets one or more storage parameters to their defaults\&. As with
SET, a table rewrite might be needed to update the table entirely\&.
.RE
.PP
INHERIT \fIparent_table\fR
.RS 4
This form adds the target table as a new child of the specified parent table\&. Subsequently, queries against the parent will include records of the target table\&. To be added as a child, the target table must already contain all the same columns as the parent (it could have additional columns, too)\&. The columns must have matching data types, and if they have
NOT NULL
constraints in the parent then they must also have
NOT NULL
constraints in the child\&.
.sp
There must also be matching child\-table constraints for all
CHECK
constraints of the parent, except those marked non\-inheritable (that is, created with
ALTER TABLE \&.\&.\&. ADD CONSTRAINT \&.\&.\&. NO INHERIT) in the parent, which are ignored; all child\-table constraints matched must not be marked non\-inheritable\&. Currently
UNIQUE,
PRIMARY KEY, and
FOREIGN KEY
constraints are not considered, but this might change in the future\&.
.RE
.PP
NO INHERIT \fIparent_table\fR
.RS 4
This form removes the target table from the list of children of the specified parent table\&. Queries against the parent table will no longer include records drawn from the target table\&.
.RE
.PP
OF \fItype_name\fR
.RS 4
This form links the table to a composite type as though
\fBCREATE TABLE OF\fR
had formed it\&. The table\*(Aqs list of column names and types must precisely match that of the composite type; the presence of an
oid
system column is permitted to differ\&. The table must not inherit from any other table\&. These restrictions ensure that
\fBCREATE TABLE OF\fR
would permit an equivalent table definition\&.
.RE
.PP
NOT OF
.RS 4
This form dissociates a typed table from its type\&.
.RE
.PP
OWNER
.RS 4
This form changes the owner of the table, sequence, view, materialized view, or foreign table to the specified user\&.
.RE
.PP
REPLICA IDENTITY
.RS 4
This form changes the information which is written to the write\-ahead log to identify rows which are updated or deleted\&. This option has no effect except when logical replication is in use\&.
DEFAULT
(the default for non\-system tables) records the old values of the columns of the primary key, if any\&.
USING INDEX
records the old values of the columns covered by the named index, which must be unique, not partial, not deferrable, and include only columns marked
NOT NULL\&.
FULL
records the old values of all columns in the row\&.
NOTHING
records no information about the old row\&. (This is the default for system tables\&.) In all cases, no old values are logged unless at least one of the columns that would be logged differs between the old and new versions of the row\&.
.RE
.PP
RENAME
.RS 4
The
RENAME
forms change the name of a table (or an index, sequence, view, materialized view, or foreign table), the name of an individual column in a table, or the name of a constraint of the table\&. There is no effect on the stored data\&.
.RE
.PP
SET SCHEMA
.RS 4
This form moves the table into another schema\&. Associated indexes, constraints, and sequences owned by table columns are moved as well\&.
.RE
.PP
All the forms of ALTER TABLE that act on a single table, except
RENAME, and
SET SCHEMA
can be combined into a list of multiple alterations to applied together\&. For example, it is possible to add several columns and/or alter the type of several columns in a single command\&. This is particularly useful with large tables, since only one pass over the table need be made\&.
.PP
You must own the table to use
\fBALTER TABLE\fR\&. To change the schema or tablespace of a table, you must also have
CREATE
privilege on the new schema or tablespace\&. To add the table as a new child of a parent table, you must own the parent table as well\&. To alter the owner, you must also be a direct or indirect member of the new owning role, and that role must have
CREATE
privilege on the table\*(Aqs schema\&. (These restrictions enforce that altering the owner doesn\*(Aqt do anything you couldn\*(Aqt do by dropping and recreating the table\&. However, a superuser can alter ownership of any table anyway\&.) To add a column or alter a column type or use the
OF
clause, you must also have
USAGE
privilege on the data type\&.
.SH "PARAMETERS"
.PP
IF EXISTS
.RS 4
Do not throw an error if the table does not exist\&. A notice is issued in this case\&.
.RE
.PP
\fIname\fR
.RS 4
The name (optionally schema\-qualified) of an existing table to alter\&. If
ONLY
is specified before the table name, only that table is altered\&. If
ONLY
is not specified, the table and all its descendant tables (if any) are altered\&. Optionally,
*
can be specified after the table name to explicitly indicate that descendant tables are included\&.
.RE
.PP
\fIcolumn_name\fR
.RS 4
Name of a new or existing column\&.
.RE
.PP
\fInew_column_name\fR
.RS 4
New name for an existing column\&.
.RE
.PP
\fInew_name\fR
.RS 4
New name for the table\&.
.RE
.PP
\fIdata_type\fR
.RS 4
Data type of the new column, or new data type for an existing column\&.
.RE
.PP
\fItable_constraint\fR
.RS 4
New table constraint for the table\&.
.RE
.PP
\fIconstraint_name\fR
.RS 4
Name of a new or existing constraint\&.
.RE
.PP
CASCADE
.RS 4
Automatically drop objects that depend on the dropped column or constraint (for example, views referencing the column), and in turn all objects that depend on those objects (see
Section 5.13, \(lqDependency Tracking\(rq, in the documentation)\&.
.RE
.PP
RESTRICT
.RS 4
Refuse to drop the column or constraint if there are any dependent objects\&. This is the default behavior\&.
.RE
.PP
\fItrigger_name\fR
.RS 4
Name of a single trigger to disable or enable\&.
.RE
.PP
ALL
.RS 4
Disable or enable all triggers belonging to the table\&. (This requires superuser privilege if any of the triggers are internally generated constraint triggers such as those that are used to implement foreign key constraints or deferrable uniqueness and exclusion constraints\&.)
.RE
.PP
USER
.RS 4
Disable or enable all triggers belonging to the table except for internally generated constraint triggers such as those that are used to implement foreign key constraints or deferrable uniqueness and exclusion constraints\&.
.RE
.PP
\fIindex_name\fR
.RS 4
The name of an existing index\&.
.RE
.PP
\fIstorage_parameter\fR
.RS 4
The name of a table storage parameter\&.
.RE
.PP
\fIvalue\fR
.RS 4
The new value for a table storage parameter\&. This might be a number or a word depending on the parameter\&.
.RE
.PP
\fIparent_table\fR
.RS 4
A parent table to associate or de\-associate with this table\&.
.RE
.PP
\fInew_owner\fR
.RS 4
The user name of the new owner of the table\&.
.RE
.PP
\fInew_tablespace\fR
.RS 4
The name of the tablespace to which the table will be moved\&.
.RE
.PP
\fInew_schema\fR
.RS 4
The name of the schema to which the table will be moved\&.
.RE
.SH "NOTES"
.PP
The key word
COLUMN
is noise and can be omitted\&.
.PP
When a column is added with
ADD COLUMN, all existing rows in the table are initialized with the column\*(Aqs default value (NULL if no
DEFAULT
clause is specified)\&. If there is no
DEFAULT
clause, this is merely a metadata change and does not require any immediate update of the table\*(Aqs data; the added NULL values are supplied on readout, instead\&.
.PP
Adding a column with a
DEFAULT
clause or changing the type of an existing column will require the entire table and its indexes to be rewritten\&. As an exception when changing the type of an existing column, if the
USING
clause does not change the column contents and the old type is either binary coercible to the new type or an unconstrained domain over the new type, a table rewrite is not needed; but any indexes on the affected columns must still be rebuilt\&. Adding or removing a system
oid
column also requires rewriting the entire table\&. Table and/or index rebuilds may take a significant amount of time for a large table; and will temporarily require as much as double the disk space\&.
.PP
Adding a
CHECK
or
NOT NULL
constraint requires scanning the table to verify that existing rows meet the constraint, but does not require a table rewrite\&.
.PP
The main reason for providing the option to specify multiple changes in a single
\fBALTER TABLE\fR
is that multiple table scans or rewrites can thereby be combined into a single pass over the table\&.
.PP
Scanning a large table to verify a new foreign key or check constraint can take a long time, and other updates to the table are locked out until the
\fBALTER TABLE ADD CONSTRAINT\fR
command is committed\&. The main purpose of the
NOT VALID
constraint option is to reduce the impact of adding a constraint on concurrent updates\&. With
NOT VALID, the
\fBADD CONSTRAINT\fR
command does not scan the table and can be committed immediately\&. After that, a
VALIDATE CONSTRAINT
command can be issued to verify that existing rows satisfy the constraint\&. The validation step does not need to lock out concurrent updates, since it knows that other transactions will be enforcing the constraint for rows that they insert or update; only pre\-existing rows need to be checked\&. Hence, validation acquires only a
SHARE UPDATE EXCLUSIVE
lock on the table being altered\&. (If the constraint is a foreign key then a
ROW SHARE
lock is also required on the table referenced by the constraint\&.) In addition to improving concurrency, it can be useful to use
NOT VALID
and
VALIDATE CONSTRAINT
in cases where the table is known to contain pre\-existing violations\&. Once the constraint is in place, no new violations can be inserted, and the existing problems can be corrected at leisure until
VALIDATE CONSTRAINT
finally succeeds\&.
.PP
The
DROP COLUMN
form does not physically remove the column, but simply makes it invisible to SQL operations\&. Subsequent insert and update operations in the table will store a null value for the column\&. Thus, dropping a column is quick but it will not immediately reduce the on\-disk size of your table, as the space occupied by the dropped column is not reclaimed\&. The space will be reclaimed over time as existing rows are updated\&. (These statements do not apply when dropping the system
oid
column; that is done with an immediate rewrite\&.)
.PP
To force immediate reclamation of space occupied by a dropped column, you can execute one of the forms of
\fBALTER TABLE\fR
that performs a rewrite of the whole table\&. This results in reconstructing each row with the dropped column replaced by a null value\&.
.PP
The rewriting forms of
\fBALTER TABLE\fR
are not MVCC\-safe\&. After a table rewrite, the table will appear empty to concurrent transactions, if they are using a snapshot taken before the rewrite occurred\&. See
Section 13.5, \(lqCaveats\(rq, in the documentation
for more details\&.
.PP
The
USING
option of
SET DATA TYPE
can actually specify any expression involving the old values of the row; that is, it can refer to other columns as well as the one being converted\&. This allows very general conversions to be done with the
SET DATA TYPE
syntax\&. Because of this flexibility, the
USING
expression is not applied to the column\*(Aqs default value (if any); the result might not be a constant expression as required for a default\&. This means that when there is no implicit or assignment cast from old to new type,
SET DATA TYPE
might fail to convert the default even though a
USING
clause is supplied\&. In such cases, drop the default with
DROP DEFAULT, perform the
ALTER TYPE, and then use
SET DEFAULT
to add a suitable new default\&. Similar considerations apply to indexes and constraints involving the column\&.
.PP
If a table has any descendant tables, it is not permitted to add, rename, or change the type of a column, or rename an inherited constraint in the parent table without doing the same to the descendants\&. That is,
\fBALTER TABLE ONLY\fR
will be rejected\&. This ensures that the descendants always have columns matching the parent\&.
.PP
A recursive
DROP COLUMN
operation will remove a descendant table\*(Aqs column only if the descendant does not inherit that column from any other parents and never had an independent definition of the column\&. A nonrecursive
DROP COLUMN
(i\&.e\&.,
\fBALTER TABLE ONLY \&.\&.\&. DROP COLUMN\fR) never removes any descendant columns, but instead marks them as independently defined rather than inherited\&.
.PP
The
TRIGGER,
CLUSTER,
OWNER, and
TABLESPACE
actions never recurse to descendant tables; that is, they always act as though
ONLY
were specified\&. Adding a constraint recurses only for
CHECK
constraints that are not marked
NO INHERIT\&.
.PP
Changing any part of a system catalog table is not permitted\&.
.PP
Refer to
CREATE TABLE (\fBCREATE_TABLE\fR(7))
for a further description of valid parameters\&.
Chapter 5, Data Definition, in the documentation
has further information on inheritance\&.
.SH "EXAMPLES"
.PP
To add a column of type
varchar
to a table:
.sp
.if n \{\
.RS 4
.\}
.nf
ALTER TABLE distributors ADD COLUMN address varchar(30);
.fi
.if n \{\
.RE
.\}
.PP
To drop a column from a table:
.sp
.if n \{\
.RS 4
.\}
.nf
ALTER TABLE distributors DROP COLUMN address RESTRICT;
.fi
.if n \{\
.RE
.\}
.PP
To change the types of two existing columns in one operation:
.sp
.if n \{\
.RS 4
.\}
.nf
ALTER TABLE distributors
ALTER COLUMN address TYPE varchar(80),
ALTER COLUMN name TYPE varchar(100);
.fi
.if n \{\
.RE
.\}
.PP
To change an integer column containing Unix timestamps to
timestamp with time zone
via a
USING
clause:
.sp
.if n \{\
.RS 4
.\}
.nf
ALTER TABLE foo
ALTER COLUMN foo_timestamp SET DATA TYPE timestamp with time zone
USING
timestamp with time zone \*(Aqepoch\*(Aq + foo_timestamp * interval \*(Aq1 second\*(Aq;
.fi
.if n \{\
.RE
.\}
.PP
The same, when the column has a default expression that won\*(Aqt automatically cast to the new data type:
.sp
.if n \{\
.RS 4
.\}
.nf
ALTER TABLE foo
ALTER COLUMN foo_timestamp DROP DEFAULT,
ALTER COLUMN foo_timestamp TYPE timestamp with time zone
USING
timestamp with time zone \*(Aqepoch\*(Aq + foo_timestamp * interval \*(Aq1 second\*(Aq,
ALTER COLUMN foo_timestamp SET DEFAULT now();
.fi
.if n \{\
.RE
.\}
.PP
To rename an existing column:
.sp
.if n \{\
.RS 4
.\}
.nf
ALTER TABLE distributors RENAME COLUMN address TO city;
.fi
.if n \{\
.RE
.\}
.PP
To rename an existing table:
.sp
.if n \{\
.RS 4
.\}
.nf
ALTER TABLE distributors RENAME TO suppliers;
.fi
.if n \{\
.RE
.\}
.PP
To rename an existing constraint:
.sp
.if n \{\
.RS 4
.\}
.nf
ALTER TABLE distributors RENAME CONSTRAINT zipchk TO zip_check;
.fi
.if n \{\
.RE
.\}
.PP
To add a not\-null constraint to a column:
.sp
.if n \{\
.RS 4
.\}
.nf
ALTER TABLE distributors ALTER COLUMN street SET NOT NULL;
.fi
.if n \{\
.RE
.\}
.sp
To remove a not\-null constraint from a column:
.sp
.if n \{\
.RS 4
.\}
.nf
ALTER TABLE distributors ALTER COLUMN street DROP NOT NULL;
.fi
.if n \{\
.RE
.\}
.PP
To add a check constraint to a table and all its children:
.sp
.if n \{\
.RS 4
.\}
.nf
ALTER TABLE distributors ADD CONSTRAINT zipchk CHECK (char_length(zipcode) = 5);
.fi
.if n \{\
.RE
.\}
.PP
To add a check constraint only to a table and not to its children:
.sp
.if n \{\
.RS 4
.\}
.nf
ALTER TABLE distributors ADD CONSTRAINT zipchk CHECK (char_length(zipcode) = 5) NO INHERIT;
.fi
.if n \{\
.RE
.\}
.sp
(The check constraint will not be inherited by future children, either\&.)
.PP
To remove a check constraint from a table and all its children:
.sp
.if n \{\
.RS 4
.\}
.nf
ALTER TABLE distributors DROP CONSTRAINT zipchk;
.fi
.if n \{\
.RE
.\}
.PP
To remove a check constraint from one table only:
.sp
.if n \{\
.RS 4
.\}
.nf
ALTER TABLE ONLY distributors DROP CONSTRAINT zipchk;
.fi
.if n \{\
.RE
.\}
.sp
(The check constraint remains in place for any child tables\&.)
.PP
To add a foreign key constraint to a table:
.sp
.if n \{\
.RS 4
.\}
.nf
ALTER TABLE distributors ADD CONSTRAINT distfk FOREIGN KEY (address) REFERENCES addresses (address);
.fi
.if n \{\
.RE
.\}
.PP
To add a foreign key constraint to a table with the least impact on other work:
.sp
.if n \{\
.RS 4
.\}
.nf
ALTER TABLE distributors ADD CONSTRAINT distfk FOREIGN KEY (address) REFERENCES addresses (address) NOT VALID;
ALTER TABLE distributors VALIDATE CONSTRAINT distfk;
.fi
.if n \{\
.RE
.\}
.PP
To add a (multicolumn) unique constraint to a table:
.sp
.if n \{\
.RS 4
.\}
.nf
ALTER TABLE distributors ADD CONSTRAINT dist_id_zipcode_key UNIQUE (dist_id, zipcode);
.fi
.if n \{\
.RE
.\}
.PP
To add an automatically named primary key constraint to a table, noting that a table can only ever have one primary key:
.sp
.if n \{\
.RS 4
.\}
.nf
ALTER TABLE distributors ADD PRIMARY KEY (dist_id);
.fi
.if n \{\
.RE
.\}
.PP
To move a table to a different tablespace:
.sp
.if n \{\
.RS 4
.\}
.nf
ALTER TABLE distributors SET TABLESPACE fasttablespace;
.fi
.if n \{\
.RE
.\}
.PP
To move a table to a different schema:
.sp
.if n \{\
.RS 4
.\}
.nf
ALTER TABLE myschema\&.distributors SET SCHEMA yourschema;
.fi
.if n \{\
.RE
.\}
.PP
To recreate a primary key constraint, without blocking updates while the index is rebuilt:
.sp
.if n \{\
.RS 4
.\}
.nf
CREATE UNIQUE INDEX CONCURRENTLY dist_id_temp_idx ON distributors (dist_id);
ALTER TABLE distributors DROP CONSTRAINT distributors_pkey,
ADD CONSTRAINT distributors_pkey PRIMARY KEY USING INDEX dist_id_temp_idx;
.fi
.if n \{\
.RE
.\}
.SH "COMPATIBILITY"
.PP
The forms
ADD
(without
USING INDEX),
DROP,
SET DEFAULT, and
SET DATA TYPE
(without
USING) conform with the SQL standard\&. The other forms are
PostgreSQL
extensions of the SQL standard\&. Also, the ability to specify more than one manipulation in a single
\fBALTER TABLE\fR
command is an extension\&.
.PP
\fBALTER TABLE DROP COLUMN\fR
can be used to drop the only column of a table, leaving a zero\-column table\&. This is an extension of SQL, which disallows zero\-column tables\&.
.SH "SEE ALSO"
CREATE TABLE (\fBCREATE_TABLE\fR(7))
man/man7/INSERT.7 0000644 00000047165 14751153421 0007275 0 ustar 00 '\" t
.\" Title: INSERT
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "INSERT" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
INSERT \- create new rows in a table
.SH "SYNOPSIS"
.sp
.nf
[ WITH [ RECURSIVE ] \fIwith_query\fR [, \&.\&.\&.] ]
INSERT INTO \fItable_name\fR [ AS \fIalias\fR ] [ ( \fIcolumn_name\fR [, \&.\&.\&.] ) ]
{ DEFAULT VALUES | VALUES ( { \fIexpression\fR | DEFAULT } [, \&.\&.\&.] ) [, \&.\&.\&.] | \fIquery\fR }
[ ON CONFLICT [ \fIconflict_target\fR ] \fIconflict_action\fR ]
[ RETURNING * | \fIoutput_expression\fR [ [ AS ] \fIoutput_name\fR ] [, \&.\&.\&.] ]
where \fIconflict_target\fR can be one of:
( { \fIindex_column_name\fR | ( \fIindex_expression\fR ) } [ COLLATE \fIcollation\fR ] [ \fIopclass\fR ] [, \&.\&.\&.] ) [ WHERE \fIindex_predicate\fR ]
ON CONSTRAINT \fIconstraint_name\fR
and \fIconflict_action\fR is one of:
DO NOTHING
DO UPDATE SET { \fIcolumn_name\fR = { \fIexpression\fR | DEFAULT } |
( \fIcolumn_name\fR [, \&.\&.\&.] ) = ( { \fIexpression\fR | DEFAULT } [, \&.\&.\&.] ) |
( \fIcolumn_name\fR [, \&.\&.\&.] ) = ( \fIsub\-SELECT\fR )
} [, \&.\&.\&.]
[ WHERE \fIcondition\fR ]
.fi
.SH "DESCRIPTION"
.PP
\fBINSERT\fR
inserts new rows into a table\&. One can insert one or more rows specified by value expressions, or zero or more rows resulting from a query\&.
.PP
The target column names can be listed in any order\&. If no list of column names is given at all, the default is all the columns of the table in their declared order; or the first
\fIN\fR
column names, if there are only
\fIN\fR
columns supplied by the
VALUES
clause or
\fIquery\fR\&. The values supplied by the
VALUES
clause or
\fIquery\fR
are associated with the explicit or implicit column list left\-to\-right\&.
.PP
Each column not present in the explicit or implicit column list will be filled with a default value, either its declared default value or null if there is none\&.
.PP
If the expression for any column is not of the correct data type, automatic type conversion will be attempted\&.
.PP
ON CONFLICT
can be used to specify an alternative action to raising a unique constraint or exclusion constraint violation error\&. (See
ON CONFLICT Clause
below\&.)
.PP
The optional
RETURNING
clause causes
\fBINSERT\fR
to compute and return value(s) based on each row actually inserted (or updated, if an
ON CONFLICT DO UPDATE
clause was used)\&. This is primarily useful for obtaining values that were supplied by defaults, such as a serial sequence number\&. However, any expression using the table\*(Aqs columns is allowed\&. The syntax of the
RETURNING
list is identical to that of the output list of
\fBSELECT\fR\&. Only rows that were successfully inserted or updated will be returned\&. For example, if a row was locked but not updated because an
ON CONFLICT DO UPDATE \&.\&.\&. WHERE
clause
\fIcondition\fR
was not satisfied, the row will not be returned\&.
.PP
You must have
INSERT
privilege on a table in order to insert into it\&. If
ON CONFLICT DO UPDATE
is present,
UPDATE
privilege on the table is also required\&.
.PP
If a column list is specified, you only need
INSERT
privilege on the listed columns\&. Similarly, when
ON CONFLICT DO UPDATE
is specified, you only need
UPDATE
privilege on the column(s) that are listed to be updated\&. However,
ON CONFLICT DO UPDATE
also requires
SELECT
privilege on any column whose values are read in the
ON CONFLICT DO UPDATE
expressions or
\fIcondition\fR\&.
.PP
Use of the
RETURNING
clause requires
SELECT
privilege on all columns mentioned in
RETURNING\&. If you use the
\fIquery\fR
clause to insert rows from a query, you of course need to have
SELECT
privilege on any table or column used in the query\&.
.SH "PARAMETERS"
.SS "Inserting"
.PP
This section covers parameters that may be used when only inserting new rows\&. Parameters
\fIexclusively\fR
used with the
ON CONFLICT
clause are described separately\&.
.PP
\fIwith_query\fR
.RS 4
The
WITH
clause allows you to specify one or more subqueries that can be referenced by name in the
\fBINSERT\fR
query\&. See
Section 7.8, \(lqWITH Queries (Common Table Expressions)\(rq, in the documentation
and
\fBSELECT\fR(7)
for details\&.
.sp
It is possible for the
\fIquery\fR
(\fBSELECT\fR
statement) to also contain a
WITH
clause\&. In such a case both sets of
\fIwith_query\fR
can be referenced within the
\fIquery\fR, but the second one takes precedence since it is more closely nested\&.
.RE
.PP
\fItable_name\fR
.RS 4
The name (optionally schema\-qualified) of an existing table\&.
.RE
.PP
\fIalias\fR
.RS 4
A substitute name for
\fItable_name\fR\&. When an alias is provided, it completely hides the actual name of the table\&. This is particularly useful when
ON CONFLICT DO UPDATE
targets a table named excluded, since that\*(Aqs also the name of the special table representing rows proposed for insertion\&.
.RE
.PP
\fIcolumn_name\fR
.RS 4
The name of a column in the table named by
\fItable_name\fR\&. The column name can be qualified with a subfield name or array subscript, if needed\&. (Inserting into only some fields of a composite column leaves the other fields null\&.) When referencing a column with
ON CONFLICT DO UPDATE, do not include the table\*(Aqs name in the specification of a target column\&. For example,
INSERT INTO table_name \&.\&.\&. ON CONFLICT DO UPDATE SET table_name\&.col = 1
is invalid (this follows the general behavior for
\fBUPDATE\fR)\&.
.RE
.PP
DEFAULT VALUES
.RS 4
All columns will be filled with their default values\&.
.RE
.PP
\fIexpression\fR
.RS 4
An expression or value to assign to the corresponding column\&.
.RE
.PP
DEFAULT
.RS 4
The corresponding column will be filled with its default value\&.
.RE
.PP
\fIquery\fR
.RS 4
A query (\fBSELECT\fR
statement) that supplies the rows to be inserted\&. Refer to the
\fBSELECT\fR(7)
statement for a description of the syntax\&.
.RE
.PP
\fIoutput_expression\fR
.RS 4
An expression to be computed and returned by the
\fBINSERT\fR
command after each row is inserted or updated\&. The expression can use any column names of the table named by
\fItable_name\fR\&. Write
*
to return all columns of the inserted or updated row(s)\&.
.RE
.PP
\fIoutput_name\fR
.RS 4
A name to use for a returned column\&.
.RE
.SS "ON CONFLICT Clause"
.PP
The optional
ON CONFLICT
clause specifies an alternative action to raising a unique violation or exclusion constraint violation error\&. For each individual row proposed for insertion, either the insertion proceeds, or, if an
\fIarbiter\fR
constraint or index specified by
\fIconflict_target\fR
is violated, the alternative
\fIconflict_action\fR
is taken\&.
ON CONFLICT DO NOTHING
simply avoids inserting a row as its alternative action\&.
ON CONFLICT DO UPDATE
updates the existing row that conflicts with the row proposed for insertion as its alternative action\&.
.PP
\fIconflict_target\fR
can perform
\fIunique index inference\fR\&. When performing inference, it consists of one or more
\fIindex_column_name\fR
columns and/or
\fIindex_expression\fR
expressions, and an optional
\fIindex_predicate\fR\&. All
\fItable_name\fR
unique indexes that, without regard to order, contain exactly the
\fIconflict_target\fR\-specified columns/expressions are inferred (chosen) as arbiter indexes\&. If an
\fIindex_predicate\fR
is specified, it must, as a further requirement for inference, satisfy arbiter indexes\&. Note that this means a non\-partial unique index (a unique index without a predicate) will be inferred (and thus used by
ON CONFLICT) if such an index satisfying every other criteria is available\&. If an attempt at inference is unsuccessful, an error is raised\&.
.PP
ON CONFLICT DO UPDATE
guarantees an atomic
\fBINSERT\fR
or
\fBUPDATE\fR
outcome; provided there is no independent error, one of those two outcomes is guaranteed, even under high concurrency\&. This is also known as
UPSERT
\(em
\(lqUPDATE or INSERT\(rq\&.
.PP
\fIconflict_target\fR
.RS 4
Specifies which conflicts
ON CONFLICT
takes the alternative action on by choosing
arbiter indexes\&. Either performs
\fIunique index inference\fR, or names a constraint explicitly\&. For
ON CONFLICT DO NOTHING, it is optional to specify a
\fIconflict_target\fR; when omitted, conflicts with all usable constraints (and unique indexes) are handled\&. For
ON CONFLICT DO UPDATE, a
\fIconflict_target\fR
\fImust\fR
be provided\&.
.RE
.PP
\fIconflict_action\fR
.RS 4
\fIconflict_action\fR
specifies an alternative
ON CONFLICT
action\&. It can be either
DO NOTHING, or a
DO UPDATE
clause specifying the exact details of the
UPDATE
action to be performed in case of a conflict\&. The
SET
and
WHERE
clauses in
ON CONFLICT DO UPDATE
have access to the existing row using the table\*(Aqs name (or an alias), and to rows proposed for insertion using the special
\fIexcluded\fR
table\&.
SELECT
privilege is required on any column in the target table where corresponding
\fIexcluded\fR
columns are read\&.
.sp
Note that the effects of all per\-row
BEFORE INSERT
triggers are reflected in
\fIexcluded\fR
values, since those effects may have contributed to the row being excluded from insertion\&.
.RE
.PP
\fIindex_column_name\fR
.RS 4
The name of a
\fItable_name\fR
column\&. Used to infer arbiter indexes\&. Follows
\fBCREATE INDEX\fR
format\&.
SELECT
privilege on
\fIindex_column_name\fR
is required\&.
.RE
.PP
\fIindex_expression\fR
.RS 4
Similar to
\fIindex_column_name\fR, but used to infer expressions on
\fItable_name\fR
columns appearing within index definitions (not simple columns)\&. Follows
\fBCREATE INDEX\fR
format\&.
SELECT
privilege on any column appearing within
\fIindex_expression\fR
is required\&.
.RE
.PP
\fIcollation\fR
.RS 4
When specified, mandates that corresponding
\fIindex_column_name\fR
or
\fIindex_expression\fR
use a particular collation in order to be matched during inference\&. Typically this is omitted, as collations usually do not affect whether or not a constraint violation occurs\&. Follows
\fBCREATE INDEX\fR
format\&.
.RE
.PP
\fIopclass\fR
.RS 4
When specified, mandates that corresponding
\fIindex_column_name\fR
or
\fIindex_expression\fR
use particular operator class in order to be matched during inference\&. Typically this is omitted, as the
\fIequality\fR
semantics are often equivalent across a type\*(Aqs operator classes anyway, or because it\*(Aqs sufficient to trust that the defined unique indexes have the pertinent definition of equality\&. Follows
\fBCREATE INDEX\fR
format\&.
.RE
.PP
\fIindex_predicate\fR
.RS 4
Used to allow inference of partial unique indexes\&. Any indexes that satisfy the predicate (which need not actually be partial indexes) can be inferred\&. Follows
\fBCREATE INDEX\fR
format\&.
SELECT
privilege on any column appearing within
\fIindex_predicate\fR
is required\&.
.RE
.PP
\fIconstraint_name\fR
.RS 4
Explicitly specifies an arbiter
\fIconstraint\fR
by name, rather than inferring a constraint or index\&.
.RE
.PP
\fIcondition\fR
.RS 4
An expression that returns a value of type
boolean\&. Only rows for which this expression returns
true
will be updated, although all rows will be locked when the
ON CONFLICT DO UPDATE
action is taken\&. Note that
\fIcondition\fR
is evaluated last, after a conflict has been identified as a candidate to update\&.
.RE
.PP
Note that exclusion constraints are not supported as arbiters with
ON CONFLICT DO UPDATE\&. In all cases, only
NOT DEFERRABLE
constraints and unique indexes are supported as arbiters\&.
.PP
\fBINSERT\fR
with an
ON CONFLICT DO UPDATE
clause is a
\(lqdeterministic\(rq
statement\&. This means that the command will not be allowed to affect any single existing row more than once; a cardinality violation error will be raised when this situation arises\&. Rows proposed for insertion should not duplicate each other in terms of attributes constrained by an arbiter index or constraint\&.
.if n \{\
.sp
.\}
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBTip\fR
.ps -1
.br
.PP
It is often preferable to use unique index inference rather than naming a constraint directly using
ON CONFLICT ON CONSTRAINT
\fI constraint_name\fR\&. Inference will continue to work correctly when the underlying index is replaced by another more or less equivalent index in an overlapping way, for example when using
CREATE UNIQUE INDEX \&.\&.\&. CONCURRENTLY
before dropping the index being replaced\&.
.sp .5v
.RE
.SH "OUTPUTS"
.PP
On successful completion, an
\fBINSERT\fR
command returns a command tag of the form
.sp
.if n \{\
.RS 4
.\}
.nf
INSERT \fIoid\fR \fIcount\fR
.fi
.if n \{\
.RE
.\}
.sp
The
\fIcount\fR
is the number of rows inserted or updated\&. If
\fIcount\fR
is exactly one, and the target table has OIDs, then
\fIoid\fR
is the
OID
assigned to the inserted row\&. The single row must have been inserted rather than updated\&. Otherwise
\fIoid\fR
is zero\&.
.PP
If the
\fBINSERT\fR
command contains a
RETURNING
clause, the result will be similar to that of a
\fBSELECT\fR
statement containing the columns and values defined in the
RETURNING
list, computed over the row(s) inserted or updated by the command\&.
.SH "EXAMPLES"
.PP
Insert a single row into table
films:
.sp
.if n \{\
.RS 4
.\}
.nf
INSERT INTO films VALUES
(\*(AqUA502\*(Aq, \*(AqBananas\*(Aq, 105, \*(Aq1971\-07\-13\*(Aq, \*(AqComedy\*(Aq, \*(Aq82 minutes\*(Aq);
.fi
.if n \{\
.RE
.\}
.PP
In this example, the
len
column is omitted and therefore it will have the default value:
.sp
.if n \{\
.RS 4
.\}
.nf
INSERT INTO films (code, title, did, date_prod, kind)
VALUES (\*(AqT_601\*(Aq, \*(AqYojimbo\*(Aq, 106, \*(Aq1961\-06\-16\*(Aq, \*(AqDrama\*(Aq);
.fi
.if n \{\
.RE
.\}
.PP
This example uses the
DEFAULT
clause for the date columns rather than specifying a value:
.sp
.if n \{\
.RS 4
.\}
.nf
INSERT INTO films VALUES
(\*(AqUA502\*(Aq, \*(AqBananas\*(Aq, 105, DEFAULT, \*(AqComedy\*(Aq, \*(Aq82 minutes\*(Aq);
INSERT INTO films (code, title, did, date_prod, kind)
VALUES (\*(AqT_601\*(Aq, \*(AqYojimbo\*(Aq, 106, DEFAULT, \*(AqDrama\*(Aq);
.fi
.if n \{\
.RE
.\}
.PP
To insert a row consisting entirely of default values:
.sp
.if n \{\
.RS 4
.\}
.nf
INSERT INTO films DEFAULT VALUES;
.fi
.if n \{\
.RE
.\}
.PP
To insert multiple rows using the multirow
\fBVALUES\fR
syntax:
.sp
.if n \{\
.RS 4
.\}
.nf
INSERT INTO films (code, title, did, date_prod, kind) VALUES
(\*(AqB6717\*(Aq, \*(AqTampopo\*(Aq, 110, \*(Aq1985\-02\-10\*(Aq, \*(AqComedy\*(Aq),
(\*(AqHG120\*(Aq, \*(AqThe Dinner Game\*(Aq, 140, DEFAULT, \*(AqComedy\*(Aq);
.fi
.if n \{\
.RE
.\}
.PP
This example inserts some rows into table
films
from a table
tmp_films
with the same column layout as
films:
.sp
.if n \{\
.RS 4
.\}
.nf
INSERT INTO films SELECT * FROM tmp_films WHERE date_prod < \*(Aq2004\-05\-07\*(Aq;
.fi
.if n \{\
.RE
.\}
.PP
This example inserts into array columns:
.sp
.if n \{\
.RS 4
.\}
.nf
\-\- Create an empty 3x3 gameboard for noughts\-and\-crosses
INSERT INTO tictactoe (game, board[1:3][1:3])
VALUES (1, \*(Aq{{" "," "," "},{" "," "," "},{" "," "," "}}\*(Aq);
\-\- The subscripts in the above example aren\*(Aqt really needed
INSERT INTO tictactoe (game, board)
VALUES (2, \*(Aq{{X," "," "},{" ",O," "},{" ",X," "}}\*(Aq);
.fi
.if n \{\
.RE
.\}
.PP
Insert a single row into table
distributors, returning the sequence number generated by the
DEFAULT
clause:
.sp
.if n \{\
.RS 4
.\}
.nf
INSERT INTO distributors (did, dname) VALUES (DEFAULT, \*(AqXYZ Widgets\*(Aq)
RETURNING did;
.fi
.if n \{\
.RE
.\}
.PP
Increment the sales count of the salesperson who manages the account for Acme Corporation, and record the whole updated row along with current time in a log table:
.sp
.if n \{\
.RS 4
.\}
.nf
WITH upd AS (
UPDATE employees SET sales_count = sales_count + 1 WHERE id =
(SELECT sales_person FROM accounts WHERE name = \*(AqAcme Corporation\*(Aq)
RETURNING *
)
INSERT INTO employees_log SELECT *, current_timestamp FROM upd;
.fi
.if n \{\
.RE
.\}
.PP
Insert or update new distributors as appropriate\&. Assumes a unique index has been defined that constrains values appearing in the
did
column\&. Note that the special
\fIexcluded\fR
table is used to reference values originally proposed for insertion:
.sp
.if n \{\
.RS 4
.\}
.nf
INSERT INTO distributors (did, dname)
VALUES (5, \*(AqGizmo Transglobal\*(Aq), (6, \*(AqAssociated Computing, Inc\*(Aq)
ON CONFLICT (did) DO UPDATE SET dname = EXCLUDED\&.dname;
.fi
.if n \{\
.RE
.\}
.PP
Insert a distributor, or do nothing for rows proposed for insertion when an existing, excluded row (a row with a matching constrained column or columns after before row insert triggers fire) exists\&. Example assumes a unique index has been defined that constrains values appearing in the
did
column:
.sp
.if n \{\
.RS 4
.\}
.nf
INSERT INTO distributors (did, dname) VALUES (7, \*(AqRedline GmbH\*(Aq)
ON CONFLICT (did) DO NOTHING;
.fi
.if n \{\
.RE
.\}
.PP
Insert or update new distributors as appropriate\&. Example assumes a unique index has been defined that constrains values appearing in the
did
column\&.
WHERE
clause is used to limit the rows actually updated (any existing row not updated will still be locked, though):
.sp
.if n \{\
.RS 4
.\}
.nf
\-\- Don\*(Aqt update existing distributors based in a certain ZIP code
INSERT INTO distributors AS d (did, dname) VALUES (8, \*(AqAnvil Distribution\*(Aq)
ON CONFLICT (did) DO UPDATE
SET dname = EXCLUDED\&.dname || \*(Aq (formerly \*(Aq || d\&.dname || \*(Aq)\*(Aq
WHERE d\&.zipcode <> \*(Aq21201\*(Aq;
\-\- Name a constraint directly in the statement (uses associated
\-\- index to arbitrate taking the DO NOTHING action)
INSERT INTO distributors (did, dname) VALUES (9, \*(AqAntwerp Design\*(Aq)
ON CONFLICT ON CONSTRAINT distributors_pkey DO NOTHING;
.fi
.if n \{\
.RE
.\}
.PP
Insert new distributor if possible; otherwise
DO NOTHING\&. Example assumes a unique index has been defined that constrains values appearing in the
did
column on a subset of rows where the
is_active
Boolean column evaluates to
true:
.sp
.if n \{\
.RS 4
.\}
.nf
\-\- This statement could infer a partial unique index on "did"
\-\- with a predicate of "WHERE is_active", but it could also
\-\- just use a regular unique constraint on "did"
INSERT INTO distributors (did, dname) VALUES (10, \*(AqConrad International\*(Aq)
ON CONFLICT (did) WHERE is_active DO NOTHING;
.fi
.if n \{\
.RE
.\}
.sp
.SH "COMPATIBILITY"
.PP
\fBINSERT\fR
conforms to the SQL standard, except that the
RETURNING
clause is a
PostgreSQL
extension, as is the ability to use
WITH
with
\fBINSERT\fR, and the ability to specify an alternative action with
ON CONFLICT\&. Also, the case in which a column name list is omitted, but not all the columns are filled from the
VALUES
clause or
\fIquery\fR, is disallowed by the standard\&.
.PP
Possible limitations of the
\fIquery\fR
clause are documented under
\fBSELECT\fR(7)\&.
man/man7/ALTER_TRIGGER.7 0000644 00000005764 14751153421 0010322 0 ustar 00 '\" t
.\" Title: ALTER TRIGGER
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "ALTER TRIGGER" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
ALTER_TRIGGER \- change the definition of a trigger
.SH "SYNOPSIS"
.sp
.nf
ALTER TRIGGER \fIname\fR ON \fItable_name\fR RENAME TO \fInew_name\fR
ALTER TRIGGER \fIname\fR ON \fItable_name\fR DEPENDS ON EXTENSION \fIextension_name\fR
.fi
.SH "DESCRIPTION"
.PP
\fBALTER TRIGGER\fR
changes properties of an existing trigger\&. The
RENAME
clause changes the name of the given trigger without otherwise changing the trigger definition\&. The
DEPENDS ON EXTENSION
clause marks the trigger as dependent on an extension, such that if the extension is dropped, the trigger will automatically be dropped as well\&.
.PP
You must own the table on which the trigger acts to be allowed to change its properties\&.
.SH "PARAMETERS"
.PP
\fIname\fR
.RS 4
The name of an existing trigger to alter\&.
.RE
.PP
\fItable_name\fR
.RS 4
The name of the table on which this trigger acts\&.
.RE
.PP
\fInew_name\fR
.RS 4
The new name for the trigger\&.
.RE
.PP
\fIextension_name\fR
.RS 4
The name of the extension that the trigger is to depend on\&.
.RE
.SH "NOTES"
.PP
The ability to temporarily enable or disable a trigger is provided by
ALTER TABLE (\fBALTER_TABLE\fR(7)), not by
\fBALTER TRIGGER\fR, because
\fBALTER TRIGGER\fR
has no convenient way to express the option of enabling or disabling all of a table\*(Aqs triggers at once\&.
.SH "EXAMPLES"
.PP
To rename an existing trigger:
.sp
.if n \{\
.RS 4
.\}
.nf
ALTER TRIGGER emp_stamp ON emp RENAME TO emp_track_chgs;
.fi
.if n \{\
.RE
.\}
.PP
To mark a trigger as being dependent on an extension:
.sp
.if n \{\
.RS 4
.\}
.nf
ALTER TRIGGER emp_stamp ON emp DEPENDS ON EXTENSION emplib;
.fi
.if n \{\
.RE
.\}
.SH "COMPATIBILITY"
.PP
\fBALTER TRIGGER\fR
is a
PostgreSQL
extension of the SQL standard\&.
.SH "SEE ALSO"
ALTER TABLE (\fBALTER_TABLE\fR(7))
man/man7/DROP_GROUP.7 0000644 00000003113 14751153421 0007772 0 ustar 00 '\" t
.\" Title: DROP GROUP
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "DROP GROUP" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
DROP_GROUP \- remove a database role
.SH "SYNOPSIS"
.sp
.nf
DROP GROUP [ IF EXISTS ] \fIname\fR [, \&.\&.\&.]
.fi
.SH "DESCRIPTION"
.PP
\fBDROP GROUP\fR
is now an alias for
DROP ROLE (\fBDROP_ROLE\fR(7))\&.
.SH "COMPATIBILITY"
.PP
There is no
\fBDROP GROUP\fR
statement in the SQL standard\&.
.SH "SEE ALSO"
DROP ROLE (\fBDROP_ROLE\fR(7))
man/man7/ABORT.7 0000644 00000004257 14751153421 0007133 0 ustar 00 '\" t
.\" Title: ABORT
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "ABORT" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
ABORT \- abort the current transaction
.SH "SYNOPSIS"
.sp
.nf
ABORT [ WORK | TRANSACTION ]
.fi
.SH "DESCRIPTION"
.PP
\fBABORT\fR
rolls back the current transaction and causes all the updates made by the transaction to be discarded\&. This command is identical in behavior to the standard
SQL
command
\fBROLLBACK\fR(7), and is present only for historical reasons\&.
.SH "PARAMETERS"
.PP
WORK
.br
TRANSACTION
.RS 4
Optional key words\&. They have no effect\&.
.RE
.SH "NOTES"
.PP
Use
\fBCOMMIT\fR(7)
to successfully terminate a transaction\&.
.PP
Issuing
\fBABORT\fR
outside of a transaction block emits a warning and otherwise has no effect\&.
.SH "EXAMPLES"
.PP
To abort all changes:
.sp
.if n \{\
.RS 4
.\}
.nf
ABORT;
.fi
.if n \{\
.RE
.\}
.SH "COMPATIBILITY"
.PP
This command is a
PostgreSQL
extension present for historical reasons\&.
\fBROLLBACK\fR
is the equivalent standard SQL command\&.
.SH "SEE ALSO"
\fBBEGIN\fR(7), \fBCOMMIT\fR(7), \fBROLLBACK\fR(7)
man/man7/DROP_TRANSFORM.7 0000644 00000005144 14751153421 0010457 0 ustar 00 '\" t
.\" Title: DROP TRANSFORM
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "DROP TRANSFORM" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
DROP_TRANSFORM \- remove a transform
.SH "SYNOPSIS"
.sp
.nf
DROP TRANSFORM [ IF EXISTS ] FOR \fItype_name\fR LANGUAGE \fIlang_name\fR [ CASCADE | RESTRICT ]
.fi
.SH "DESCRIPTION"
.PP
\fBDROP TRANSFORM\fR
removes a previously defined transform\&.
.PP
To be able to drop a transform, you must own the type and the language\&. These are the same privileges that are required to create a transform\&.
.SH "PARAMETERS"
.PP
IF EXISTS
.RS 4
Do not throw an error if the transform does not exist\&. A notice is issued in this case\&.
.RE
.PP
\fItype_name\fR
.RS 4
The name of the data type of the transform\&.
.RE
.PP
\fIlang_name\fR
.RS 4
The name of the language of the transform\&.
.RE
.PP
CASCADE
.RS 4
Automatically drop objects that depend on the transform, and in turn all objects that depend on those objects (see
Section 5.13, \(lqDependency Tracking\(rq, in the documentation)\&.
.RE
.PP
RESTRICT
.RS 4
Refuse to drop the transform if any objects depend on it\&. This is the default\&.
.RE
.SH "EXAMPLES"
.PP
To drop the transform for type
hstore
and language
plpythonu:
.sp
.if n \{\
.RS 4
.\}
.nf
DROP TRANSFORM FOR hstore LANGUAGE plpythonu;
.fi
.if n \{\
.RE
.\}
.SH "COMPATIBILITY"
.PP
This form of
\fBDROP TRANSFORM\fR
is a
PostgreSQL
extension\&. See
CREATE TRANSFORM (\fBCREATE_TRANSFORM\fR(7))
for details\&.
.SH "SEE ALSO"
CREATE TRANSFORM (\fBCREATE_TRANSFORM\fR(7))
man/man7/REINDEX.7 0000644 00000017327 14751153421 0007364 0 ustar 00 '\" t
.\" Title: REINDEX
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "REINDEX" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
REINDEX \- rebuild indexes
.SH "SYNOPSIS"
.sp
.nf
REINDEX [ ( VERBOSE ) ] { INDEX | TABLE | SCHEMA | DATABASE | SYSTEM } \fIname\fR
.fi
.SH "DESCRIPTION"
.PP
\fBREINDEX\fR
rebuilds an index using the data stored in the index\*(Aqs table, replacing the old copy of the index\&. There are several scenarios in which to use
\fBREINDEX\fR:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
An index has become corrupted, and no longer contains valid data\&. Although in theory this should never happen, in practice indexes can become corrupted due to software bugs or hardware failures\&.
\fBREINDEX\fR
provides a recovery method\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
An index has become
\(lqbloated\(rq, that is it contains many empty or nearly\-empty pages\&. This can occur with B\-tree indexes in
PostgreSQL
under certain uncommon access patterns\&.
\fBREINDEX\fR
provides a way to reduce the space consumption of the index by writing a new version of the index without the dead pages\&. See
Section 24.2, \(lqRoutine Reindexing\(rq, in the documentation
for more information\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
You have altered a storage parameter (such as fillfactor) for an index, and wish to ensure that the change has taken full effect\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
An index build with the
CONCURRENTLY
option failed, leaving an
\(lqinvalid\(rq
index\&. Such indexes are useless but it can be convenient to use
\fBREINDEX\fR
to rebuild them\&. Note that
\fBREINDEX\fR
will not perform a concurrent build\&. To build the index without interfering with production you should drop the index and reissue the
\fBCREATE INDEX CONCURRENTLY\fR
command\&.
.RE
.SH "PARAMETERS"
.PP
INDEX
.RS 4
Recreate the specified index\&.
.RE
.PP
TABLE
.RS 4
Recreate all indexes of the specified table\&. If the table has a secondary
\(lqTOAST\(rq
table, that is reindexed as well\&.
.RE
.PP
SCHEMA
.RS 4
Recreate all indexes of the specified schema\&. If a table of this schema has a secondary
\(lqTOAST\(rq
table, that is reindexed as well\&. Indexes on shared system catalogs are also processed\&. This form of
\fBREINDEX\fR
cannot be executed inside a transaction block\&.
.RE
.PP
DATABASE
.RS 4
Recreate all indexes within the current database\&. Indexes on shared system catalogs are also processed\&. This form of
\fBREINDEX\fR
cannot be executed inside a transaction block\&.
.RE
.PP
SYSTEM
.RS 4
Recreate all indexes on system catalogs within the current database\&. Indexes on shared system catalogs are included\&. Indexes on user tables are not processed\&. This form of
\fBREINDEX\fR
cannot be executed inside a transaction block\&.
.RE
.PP
\fIname\fR
.RS 4
The name of the specific index, table, or database to be reindexed\&. Index and table names can be schema\-qualified\&. Presently,
\fBREINDEX DATABASE\fR
and
\fBREINDEX SYSTEM\fR
can only reindex the current database, so their parameter must match the current database\*(Aqs name\&.
.RE
.PP
VERBOSE
.RS 4
Prints a progress report as each index is reindexed\&.
.RE
.SH "NOTES"
.PP
If you suspect corruption of an index on a user table, you can simply rebuild that index, or all indexes on the table, using
\fBREINDEX INDEX\fR
or
\fBREINDEX TABLE\fR\&.
.PP
Things are more difficult if you need to recover from corruption of an index on a system table\&. In this case it\*(Aqs important for the system to not have used any of the suspect indexes itself\&. (Indeed, in this sort of scenario you might find that server processes are crashing immediately at start\-up, due to reliance on the corrupted indexes\&.) To recover safely, the server must be started with the
\fB\-P\fR
option, which prevents it from using indexes for system catalog lookups\&.
.PP
One way to do this is to shut down the server and start a single\-user
PostgreSQL
server with the
\fB\-P\fR
option included on its command line\&. Then,
\fBREINDEX DATABASE\fR,
\fBREINDEX SYSTEM\fR,
\fBREINDEX TABLE\fR, or
\fBREINDEX INDEX\fR
can be issued, depending on how much you want to reconstruct\&. If in doubt, use
\fBREINDEX SYSTEM\fR
to select reconstruction of all system indexes in the database\&. Then quit the single\-user server session and restart the regular server\&. See the
\fBpostgres\fR(1)
reference page for more information about how to interact with the single\-user server interface\&.
.PP
Alternatively, a regular server session can be started with
\fB\-P\fR
included in its command line options\&. The method for doing this varies across clients, but in all
libpq\-based clients, it is possible to set the
\fBPGOPTIONS\fR
environment variable to
\-P
before starting the client\&. Note that while this method does not require locking out other clients, it might still be wise to prevent other users from connecting to the damaged database until repairs have been completed\&.
.PP
\fBREINDEX\fR
is similar to a drop and recreate of the index in that the index contents are rebuilt from scratch\&. However, the locking considerations are rather different\&.
\fBREINDEX\fR
locks out writes but not reads of the index\*(Aqs parent table\&. It also takes an
ACCESS EXCLUSIVE
lock on the specific index being processed, which will block reads that attempt to use that index\&. In contrast,
\fBDROP INDEX\fR
momentarily takes an
ACCESS EXCLUSIVE
lock on the parent table, blocking both writes and reads\&. The subsequent
\fBCREATE INDEX\fR
locks out writes but not reads; since the index is not there, no read will attempt to use it, meaning that there will be no blocking but reads might be forced into expensive sequential scans\&.
.PP
Reindexing a single index or table requires being the owner of that index or table\&. Reindexing a database requires being the owner of the database (note that the owner can therefore rebuild indexes of tables owned by other users)\&. Of course, superusers can always reindex anything\&.
.SH "EXAMPLES"
.PP
Rebuild a single index:
.sp
.if n \{\
.RS 4
.\}
.nf
REINDEX INDEX my_index;
.fi
.if n \{\
.RE
.\}
.PP
Rebuild all the indexes on the table
my_table:
.sp
.if n \{\
.RS 4
.\}
.nf
REINDEX TABLE my_table;
.fi
.if n \{\
.RE
.\}
.PP
Rebuild all indexes in a particular database, without trusting the system indexes to be valid already:
.sp
.if n \{\
.RS 4
.\}
.nf
$ \fBexport PGOPTIONS="\-P"\fR
$ \fBpsql broken_db\fR
\&.\&.\&.
broken_db=> REINDEX DATABASE broken_db;
broken_db=> \eq
.fi
.if n \{\
.RE
.\}
.SH "COMPATIBILITY"
.PP
There is no
\fBREINDEX\fR
command in the SQL standard\&.
man/man7/ALTER_FUNCTION.7 0000644 00000020417 14751153421 0010434 0 ustar 00 '\" t
.\" Title: ALTER FUNCTION
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "ALTER FUNCTION" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
ALTER_FUNCTION \- change the definition of a function
.SH "SYNOPSIS"
.sp
.nf
ALTER FUNCTION \fIname\fR ( [ [ \fIargmode\fR ] [ \fIargname\fR ] \fIargtype\fR [, \&.\&.\&.] ] )
\fIaction\fR [ \&.\&.\&. ] [ RESTRICT ]
ALTER FUNCTION \fIname\fR ( [ [ \fIargmode\fR ] [ \fIargname\fR ] \fIargtype\fR [, \&.\&.\&.] ] )
RENAME TO \fInew_name\fR
ALTER FUNCTION \fIname\fR ( [ [ \fIargmode\fR ] [ \fIargname\fR ] \fIargtype\fR [, \&.\&.\&.] ] )
OWNER TO { \fInew_owner\fR | CURRENT_USER | SESSION_USER }
ALTER FUNCTION \fIname\fR ( [ [ \fIargmode\fR ] [ \fIargname\fR ] \fIargtype\fR [, \&.\&.\&.] ] )
SET SCHEMA \fInew_schema\fR
ALTER FUNCTION \fIname\fR ( [ [ \fIargmode\fR ] [ \fIargname\fR ] \fIargtype\fR [, \&.\&.\&.] ] )
DEPENDS ON EXTENSION \fIextension_name\fR
where \fIaction\fR is one of:
CALLED ON NULL INPUT | RETURNS NULL ON NULL INPUT | STRICT
IMMUTABLE | STABLE | VOLATILE
[ NOT ] LEAKPROOF
[ EXTERNAL ] SECURITY INVOKER | [ EXTERNAL ] SECURITY DEFINER
PARALLEL { UNSAFE | RESTRICTED | SAFE }
COST \fIexecution_cost\fR
ROWS \fIresult_rows\fR
SET \fIconfiguration_parameter\fR { TO | = } { \fIvalue\fR | DEFAULT }
SET \fIconfiguration_parameter\fR FROM CURRENT
RESET \fIconfiguration_parameter\fR
RESET ALL
.fi
.SH "DESCRIPTION"
.PP
\fBALTER FUNCTION\fR
changes the definition of a function\&.
.PP
You must own the function to use
\fBALTER FUNCTION\fR\&. To change a function\*(Aqs schema, you must also have
CREATE
privilege on the new schema\&. To alter the owner, you must also be a direct or indirect member of the new owning role, and that role must have
CREATE
privilege on the function\*(Aqs schema\&. (These restrictions enforce that altering the owner doesn\*(Aqt do anything you couldn\*(Aqt do by dropping and recreating the function\&. However, a superuser can alter ownership of any function anyway\&.)
.SH "PARAMETERS"
.PP
\fIname\fR
.RS 4
The name (optionally schema\-qualified) of an existing function\&.
.RE
.PP
\fIargmode\fR
.RS 4
The mode of an argument:
IN,
OUT,
INOUT, or
VARIADIC\&. If omitted, the default is
IN\&. Note that
\fBALTER FUNCTION\fR
does not actually pay any attention to
OUT
arguments, since only the input arguments are needed to determine the function\*(Aqs identity\&. So it is sufficient to list the
IN,
INOUT, and
VARIADIC
arguments\&.
.RE
.PP
\fIargname\fR
.RS 4
The name of an argument\&. Note that
\fBALTER FUNCTION\fR
does not actually pay any attention to argument names, since only the argument data types are needed to determine the function\*(Aqs identity\&.
.RE
.PP
\fIargtype\fR
.RS 4
The data type(s) of the function\*(Aqs arguments (optionally schema\-qualified), if any\&.
.RE
.PP
\fInew_name\fR
.RS 4
The new name of the function\&.
.RE
.PP
\fInew_owner\fR
.RS 4
The new owner of the function\&. Note that if the function is marked
SECURITY DEFINER, it will subsequently execute as the new owner\&.
.RE
.PP
\fInew_schema\fR
.RS 4
The new schema for the function\&.
.RE
.PP
\fIextension_name\fR
.RS 4
The name of the extension that the function is to depend on\&.
.RE
.PP
CALLED ON NULL INPUT
.br
RETURNS NULL ON NULL INPUT
.br
STRICT
.RS 4
CALLED ON NULL INPUT
changes the function so that it will be invoked when some or all of its arguments are null\&.
RETURNS NULL ON NULL INPUT
or
STRICT
changes the function so that it is not invoked if any of its arguments are null; instead, a null result is assumed automatically\&. See
CREATE FUNCTION (\fBCREATE_FUNCTION\fR(7))
for more information\&.
.RE
.PP
IMMUTABLE
.br
STABLE
.br
VOLATILE
.RS 4
Change the volatility of the function to the specified setting\&. See
CREATE FUNCTION (\fBCREATE_FUNCTION\fR(7))
for details\&.
.RE
.PP
[ EXTERNAL ] SECURITY INVOKER
.br
[ EXTERNAL ] SECURITY DEFINER
.RS 4
Change whether the function is a security definer or not\&. The key word
EXTERNAL
is ignored for SQL conformance\&. See
CREATE FUNCTION (\fBCREATE_FUNCTION\fR(7))
for more information about this capability\&.
.RE
.PP
PARALLEL
.RS 4
Change whether the function is deemed safe for parallelism\&. See
CREATE FUNCTION (\fBCREATE_FUNCTION\fR(7))
for details\&.
.RE
.PP
LEAKPROOF
.RS 4
Change whether the function is considered leakproof or not\&. See
CREATE FUNCTION (\fBCREATE_FUNCTION\fR(7))
for more information about this capability\&.
.RE
.PP
COST \fIexecution_cost\fR
.RS 4
Change the estimated execution cost of the function\&. See
CREATE FUNCTION (\fBCREATE_FUNCTION\fR(7))
for more information\&.
.RE
.PP
ROWS \fIresult_rows\fR
.RS 4
Change the estimated number of rows returned by a set\-returning function\&. See
CREATE FUNCTION (\fBCREATE_FUNCTION\fR(7))
for more information\&.
.RE
.PP
\fIconfiguration_parameter\fR
.br
\fIvalue\fR
.RS 4
Add or change the assignment to be made to a configuration parameter when the function is called\&. If
\fIvalue\fR
is
DEFAULT
or, equivalently,
RESET
is used, the function\-local setting is removed, so that the function executes with the value present in its environment\&. Use
RESET ALL
to clear all function\-local settings\&.
SET FROM CURRENT
saves the value of the parameter that is current when
\fBALTER FUNCTION\fR
is executed as the value to be applied when the function is entered\&.
.sp
See
\fBSET\fR(7)
and
Chapter 19, Server Configuration, in the documentation
for more information about allowed parameter names and values\&.
.RE
.PP
RESTRICT
.RS 4
Ignored for conformance with the SQL standard\&.
.RE
.SH "EXAMPLES"
.PP
To rename the function
sqrt
for type
integer
to
square_root:
.sp
.if n \{\
.RS 4
.\}
.nf
ALTER FUNCTION sqrt(integer) RENAME TO square_root;
.fi
.if n \{\
.RE
.\}
.PP
To change the owner of the function
sqrt
for type
integer
to
joe:
.sp
.if n \{\
.RS 4
.\}
.nf
ALTER FUNCTION sqrt(integer) OWNER TO joe;
.fi
.if n \{\
.RE
.\}
.PP
To change the schema of the function
sqrt
for type
integer
to
maths:
.sp
.if n \{\
.RS 4
.\}
.nf
ALTER FUNCTION sqrt(integer) SET SCHEMA maths;
.fi
.if n \{\
.RE
.\}
.PP
To mark the function
sqrt
for type
integer
as being dependent on the extension
mathlib:
.sp
.if n \{\
.RS 4
.\}
.nf
ALTER FUNCTION sqrt(integer) DEPENDS ON EXTENSION mathlib;
.fi
.if n \{\
.RE
.\}
.PP
To adjust the search path that is automatically set for a function:
.sp
.if n \{\
.RS 4
.\}
.nf
ALTER FUNCTION check_password(text) SET search_path = admin, pg_temp;
.fi
.if n \{\
.RE
.\}
.PP
To disable automatic setting of
\fIsearch_path\fR
for a function:
.sp
.if n \{\
.RS 4
.\}
.nf
ALTER FUNCTION check_password(text) RESET search_path;
.fi
.if n \{\
.RE
.\}
.sp
The function will now execute with whatever search path is used by its caller\&.
.SH "COMPATIBILITY"
.PP
This statement is partially compatible with the
\fBALTER FUNCTION\fR
statement in the SQL standard\&. The standard allows more properties of a function to be modified, but does not provide the ability to rename a function, make a function a security definer, attach configuration parameter values to a function, or change the owner, schema, or volatility of a function\&. The standard also requires the
RESTRICT
key word, which is optional in
PostgreSQL\&.
.SH "SEE ALSO"
CREATE FUNCTION (\fBCREATE_FUNCTION\fR(7)), DROP FUNCTION (\fBDROP_FUNCTION\fR(7))
man/man7/CREATE_TEXT_SEARCH_PARSER.7 0000644 00000007106 14751153421 0012170 0 ustar 00 '\" t
.\" Title: CREATE TEXT SEARCH PARSER
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "CREATE TEXT SEARCH PARSER" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
CREATE_TEXT_SEARCH_PARSER \- define a new text search parser
.SH "SYNOPSIS"
.sp
.nf
CREATE TEXT SEARCH PARSER \fIname\fR (
START = \fIstart_function\fR ,
GETTOKEN = \fIgettoken_function\fR ,
END = \fIend_function\fR ,
LEXTYPES = \fIlextypes_function\fR
[, HEADLINE = \fIheadline_function\fR ]
)
.fi
.SH "DESCRIPTION"
.PP
\fBCREATE TEXT SEARCH PARSER\fR
creates a new text search parser\&. A text search parser defines a method for splitting a text string into tokens and assigning types (categories) to the tokens\&. A parser is not particularly useful by itself, but must be bound into a text search configuration along with some text search dictionaries to be used for searching\&.
.PP
If a schema name is given then the text search parser is created in the specified schema\&. Otherwise it is created in the current schema\&.
.PP
You must be a superuser to use
\fBCREATE TEXT SEARCH PARSER\fR\&. (This restriction is made because an erroneous text search parser definition could confuse or even crash the server\&.)
.PP
Refer to
Chapter 12, Full Text Search, in the documentation
for further information\&.
.SH "PARAMETERS"
.PP
\fIname\fR
.RS 4
The name of the text search parser to be created\&. The name can be schema\-qualified\&.
.RE
.PP
\fIstart_function\fR
.RS 4
The name of the start function for the parser\&.
.RE
.PP
\fIgettoken_function\fR
.RS 4
The name of the get\-next\-token function for the parser\&.
.RE
.PP
\fIend_function\fR
.RS 4
The name of the end function for the parser\&.
.RE
.PP
\fIlextypes_function\fR
.RS 4
The name of the lextypes function for the parser (a function that returns information about the set of token types it produces)\&.
.RE
.PP
\fIheadline_function\fR
.RS 4
The name of the headline function for the parser (a function that summarizes a set of tokens)\&.
.RE
.PP
The function names can be schema\-qualified if necessary\&. Argument types are not given, since the argument list for each type of function is predetermined\&. All except the headline function are required\&.
.PP
The arguments can appear in any order, not only the one shown above\&.
.SH "COMPATIBILITY"
.PP
There is no
\fBCREATE TEXT SEARCH PARSER\fR
statement in the SQL standard\&.
.SH "SEE ALSO"
ALTER TEXT SEARCH PARSER (\fBALTER_TEXT_SEARCH_PARSER\fR(7)), DROP TEXT SEARCH PARSER (\fBDROP_TEXT_SEARCH_PARSER\fR(7))
man/man7/ROLLBACK_PREPARED.7 0000644 00000005153 14751153421 0010733 0 ustar 00 '\" t
.\" Title: ROLLBACK PREPARED
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "ROLLBACK PREPARED" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
ROLLBACK_PREPARED \- cancel a transaction that was earlier prepared for two\-phase commit
.SH "SYNOPSIS"
.sp
.nf
ROLLBACK PREPARED \fItransaction_id\fR
.fi
.SH "DESCRIPTION"
.PP
\fBROLLBACK PREPARED\fR
rolls back a transaction that is in prepared state\&.
.SH "PARAMETERS"
.PP
\fItransaction_id\fR
.RS 4
The transaction identifier of the transaction that is to be rolled back\&.
.RE
.SH "NOTES"
.PP
To roll back a prepared transaction, you must be either the same user that executed the transaction originally, or a superuser\&. But you do not have to be in the same session that executed the transaction\&.
.PP
This command cannot be executed inside a transaction block\&. The prepared transaction is rolled back immediately\&.
.PP
All currently available prepared transactions are listed in the
pg_prepared_xacts
system view\&.
.SH "EXAMPLES"
.PP
Roll back the transaction identified by the transaction identifier
foobar:
.sp
.if n \{\
.RS 4
.\}
.nf
ROLLBACK PREPARED \*(Aqfoobar\*(Aq;
.fi
.if n \{\
.RE
.\}
.SH "COMPATIBILITY"
.PP
\fBROLLBACK PREPARED\fR
is a
PostgreSQL
extension\&. It is intended for use by external transaction management systems, some of which are covered by standards (such as X/Open XA), but the SQL side of those systems is not standardized\&.
.SH "SEE ALSO"
PREPARE TRANSACTION (\fBPREPARE_TRANSACTION\fR(7)), COMMIT PREPARED (\fBCOMMIT_PREPARED\fR(7))
man/man7/DROP_OPERATOR_CLASS.7 0000644 00000006755 14751153421 0011275 0 ustar 00 '\" t
.\" Title: DROP OPERATOR CLASS
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "DROP OPERATOR CLASS" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
DROP_OPERATOR_CLASS \- remove an operator class
.SH "SYNOPSIS"
.sp
.nf
DROP OPERATOR CLASS [ IF EXISTS ] \fIname\fR USING \fIindex_method\fR [ CASCADE | RESTRICT ]
.fi
.SH "DESCRIPTION"
.PP
\fBDROP OPERATOR CLASS\fR
drops an existing operator class\&. To execute this command you must be the owner of the operator class\&.
.PP
\fBDROP OPERATOR CLASS\fR
does not drop any of the operators or functions referenced by the class\&. If there are any indexes depending on the operator class, you will need to specify
CASCADE
for the drop to complete\&.
.SH "PARAMETERS"
.PP
IF EXISTS
.RS 4
Do not throw an error if the operator class does not exist\&. A notice is issued in this case\&.
.RE
.PP
\fIname\fR
.RS 4
The name (optionally schema\-qualified) of an existing operator class\&.
.RE
.PP
\fIindex_method\fR
.RS 4
The name of the index access method the operator class is for\&.
.RE
.PP
CASCADE
.RS 4
Automatically drop objects that depend on the operator class (such as indexes), and in turn all objects that depend on those objects (see
Section 5.13, \(lqDependency Tracking\(rq, in the documentation)\&.
.RE
.PP
RESTRICT
.RS 4
Refuse to drop the operator class if any objects depend on it\&. This is the default\&.
.RE
.SH "NOTES"
.PP
\fBDROP OPERATOR CLASS\fR
will not drop the operator family containing the class, even if there is nothing else left in the family (in particular, in the case where the family was implicitly created by
\fBCREATE OPERATOR CLASS\fR)\&. An empty operator family is harmless, but for the sake of tidiness you might wish to remove the family with
\fBDROP OPERATOR FAMILY\fR; or perhaps better, use
\fBDROP OPERATOR FAMILY\fR
in the first place\&.
.SH "EXAMPLES"
.PP
Remove the B\-tree operator class
widget_ops:
.sp
.if n \{\
.RS 4
.\}
.nf
DROP OPERATOR CLASS widget_ops USING btree;
.fi
.if n \{\
.RE
.\}
.sp
This command will not succeed if there are any existing indexes that use the operator class\&. Add
CASCADE
to drop such indexes along with the operator class\&.
.SH "COMPATIBILITY"
.PP
There is no
\fBDROP OPERATOR CLASS\fR
statement in the SQL standard\&.
.SH "SEE ALSO"
ALTER OPERATOR CLASS (\fBALTER_OPERATOR_CLASS\fR(7)), CREATE OPERATOR CLASS (\fBCREATE_OPERATOR_CLASS\fR(7)), DROP OPERATOR FAMILY (\fBDROP_OPERATOR_FAMILY\fR(7))
man/man7/CLUSTER.7 0000644 00000014363 14751153421 0007404 0 ustar 00 '\" t
.\" Title: CLUSTER
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "CLUSTER" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
CLUSTER \- cluster a table according to an index
.SH "SYNOPSIS"
.sp
.nf
CLUSTER [VERBOSE] \fItable_name\fR [ USING \fIindex_name\fR ]
CLUSTER [VERBOSE]
.fi
.SH "DESCRIPTION"
.PP
\fBCLUSTER\fR
instructs
PostgreSQL
to cluster the table specified by
\fItable_name\fR
based on the index specified by
\fIindex_name\fR\&. The index must already have been defined on
\fItable_name\fR\&.
.PP
When a table is clustered, it is physically reordered based on the index information\&. Clustering is a one\-time operation: when the table is subsequently updated, the changes are not clustered\&. That is, no attempt is made to store new or updated rows according to their index order\&. (If one wishes, one can periodically recluster by issuing the command again\&. Also, setting the table\*(Aqs
fillfactor
storage parameter to less than 100% can aid in preserving cluster ordering during updates, since updated rows are kept on the same page if enough space is available there\&.)
.PP
When a table is clustered,
PostgreSQL
remembers which index it was clustered by\&. The form
\fBCLUSTER \fR\fB\fItable_name\fR\fR
reclusters the table using the same index as before\&. You can also use the
CLUSTER
or
SET WITHOUT CLUSTER
forms of
ALTER TABLE (\fBALTER_TABLE\fR(7))
to set the index to be used for future cluster operations, or to clear any previous setting\&.
.PP
\fBCLUSTER\fR
without any parameter reclusters all the previously\-clustered tables in the current database that the calling user owns, or all such tables if called by a superuser\&. This form of
\fBCLUSTER\fR
cannot be executed inside a transaction block\&.
.PP
When a table is being clustered, an
ACCESS EXCLUSIVE
lock is acquired on it\&. This prevents any other database operations (both reads and writes) from operating on the table until the
\fBCLUSTER\fR
is finished\&.
.SH "PARAMETERS"
.PP
\fItable_name\fR
.RS 4
The name (possibly schema\-qualified) of a table\&.
.RE
.PP
\fIindex_name\fR
.RS 4
The name of an index\&.
.RE
.PP
VERBOSE
.RS 4
Prints a progress report as each table is clustered\&.
.RE
.SH "NOTES"
.PP
In cases where you are accessing single rows randomly within a table, the actual order of the data in the table is unimportant\&. However, if you tend to access some data more than others, and there is an index that groups them together, you will benefit from using
\fBCLUSTER\fR\&. If you are requesting a range of indexed values from a table, or a single indexed value that has multiple rows that match,
\fBCLUSTER\fR
will help because once the index identifies the table page for the first row that matches, all other rows that match are probably already on the same table page, and so you save disk accesses and speed up the query\&.
.PP
\fBCLUSTER\fR
can re\-sort the table using either an index scan on the specified index, or (if the index is a b\-tree) a sequential scan followed by sorting\&. It will attempt to choose the method that will be faster, based on planner cost parameters and available statistical information\&.
.PP
When an index scan is used, a temporary copy of the table is created that contains the table data in the index order\&. Temporary copies of each index on the table are created as well\&. Therefore, you need free space on disk at least equal to the sum of the table size and the index sizes\&.
.PP
When a sequential scan and sort is used, a temporary sort file is also created, so that the peak temporary space requirement is as much as double the table size, plus the index sizes\&. This method is often faster than the index scan method, but if the disk space requirement is intolerable, you can disable this choice by temporarily setting
enable_sort
to
off\&.
.PP
It is advisable to set
maintenance_work_mem
to a reasonably large value (but not more than the amount of RAM you can dedicate to the
\fBCLUSTER\fR
operation) before clustering\&.
.PP
Because the planner records statistics about the ordering of tables, it is advisable to run
\fBANALYZE\fR(7)
on the newly clustered table\&. Otherwise, the planner might make poor choices of query plans\&.
.PP
Because
\fBCLUSTER\fR
remembers which indexes are clustered, one can cluster the tables one wants clustered manually the first time, then set up a periodic maintenance script that executes
\fBCLUSTER\fR
without any parameters, so that the desired tables are periodically reclustered\&.
.SH "EXAMPLES"
.PP
Cluster the table
employees
on the basis of its index
employees_ind:
.sp
.if n \{\
.RS 4
.\}
.nf
CLUSTER employees USING employees_ind;
.fi
.if n \{\
.RE
.\}
.PP
Cluster the
employees
table using the same index that was used before:
.sp
.if n \{\
.RS 4
.\}
.nf
CLUSTER employees;
.fi
.if n \{\
.RE
.\}
.PP
Cluster all tables in the database that have previously been clustered:
.sp
.if n \{\
.RS 4
.\}
.nf
CLUSTER;
.fi
.if n \{\
.RE
.\}
.SH "COMPATIBILITY"
.PP
There is no
\fBCLUSTER\fR
statement in the SQL standard\&.
.PP
The syntax
.sp
.if n \{\
.RS 4
.\}
.nf
CLUSTER \fIindex_name\fR ON \fItable_name\fR
.fi
.if n \{\
.RE
.\}
.sp
is also supported for compatibility with pre\-8\&.3
PostgreSQL
versions\&.
.SH "SEE ALSO"
\fBclusterdb\fR(1)
man/man7/DISCARD.7 0000644 00000005503 14751153421 0007330 0 ustar 00 '\" t
.\" Title: DISCARD
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "DISCARD" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
DISCARD \- discard session state
.SH "SYNOPSIS"
.sp
.nf
DISCARD { ALL | PLANS | SEQUENCES | TEMPORARY | TEMP }
.fi
.SH "DESCRIPTION"
.PP
\fBDISCARD\fR
releases internal resources associated with a database session\&. This command is useful for partially or fully resetting the session\*(Aqs state\&. There are several subcommands to release different types of resources; the
\fBDISCARD ALL\fR
variant subsumes all the others, and also resets additional state\&.
.SH "PARAMETERS"
.PP
PLANS
.RS 4
Releases all cached query plans, forcing re\-planning to occur the next time the associated prepared statement is used\&.
.RE
.PP
SEQUENCES
.RS 4
Discards all cached sequence\-related state, including
\fBcurrval()\fR/\fBlastval()\fR
information and any preallocated sequence values that have not yet been returned by
\fBnextval()\fR\&. (See
CREATE SEQUENCE (\fBCREATE_SEQUENCE\fR(7))
for a description of preallocated sequence values\&.)
.RE
.PP
TEMPORARY or TEMP
.RS 4
Drops all temporary tables created in the current session\&.
.RE
.PP
ALL
.RS 4
Releases all temporary resources associated with the current session and resets the session to its initial state\&. Currently, this has the same effect as executing the following sequence of statements:
.sp
.if n \{\
.RS 4
.\}
.nf
SET SESSION AUTHORIZATION DEFAULT;
RESET ALL;
DEALLOCATE ALL;
CLOSE ALL;
UNLISTEN *;
SELECT pg_advisory_unlock_all();
DISCARD PLANS;
DISCARD SEQUENCES;
DISCARD TEMP;
.fi
.if n \{\
.RE
.\}
.RE
.SH "NOTES"
.PP
\fBDISCARD ALL\fR
cannot be executed inside a transaction block\&.
.SH "COMPATIBILITY"
.PP
\fBDISCARD\fR
is a
PostgreSQL
extension\&.
man/man7/ALTER_USER.7 0000644 00000005246 14751153421 0007770 0 ustar 00 '\" t
.\" Title: ALTER USER
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "ALTER USER" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
ALTER_USER \- change a database role
.SH "SYNOPSIS"
.sp
.nf
ALTER USER \fIrole_specification\fR [ WITH ] \fIoption\fR [ \&.\&.\&. ]
where \fIoption\fR can be:
SUPERUSER | NOSUPERUSER
| CREATEDB | NOCREATEDB
| CREATEROLE | NOCREATEROLE
| INHERIT | NOINHERIT
| LOGIN | NOLOGIN
| REPLICATION | NOREPLICATION
| BYPASSRLS | NOBYPASSRLS
| CONNECTION LIMIT \fIconnlimit\fR
| [ ENCRYPTED | UNENCRYPTED ] PASSWORD \*(Aq\fIpassword\fR\*(Aq
| VALID UNTIL \*(Aq\fItimestamp\fR\*(Aq
ALTER USER \fIname\fR RENAME TO \fInew_name\fR
ALTER USER { \fIrole_specification\fR | ALL } [ IN DATABASE \fIdatabase_name\fR ] SET \fIconfiguration_parameter\fR { TO | = } { \fIvalue\fR | DEFAULT }
ALTER USER { \fIrole_specification\fR | ALL } [ IN DATABASE \fIdatabase_name\fR ] SET \fIconfiguration_parameter\fR FROM CURRENT
ALTER USER { \fIrole_specification\fR | ALL } [ IN DATABASE \fIdatabase_name\fR ] RESET \fIconfiguration_parameter\fR
ALTER USER { \fIrole_specification\fR | ALL } [ IN DATABASE \fIdatabase_name\fR ] RESET ALL
where \fIrole_specification\fR can be:
\fIrole_name\fR
| CURRENT_USER
| SESSION_USER
.fi
.SH "DESCRIPTION"
.PP
\fBALTER USER\fR
is now an alias for
ALTER ROLE (\fBALTER_ROLE\fR(7))\&.
.SH "COMPATIBILITY"
.PP
The
\fBALTER USER\fR
statement is a
PostgreSQL
extension\&. The SQL standard leaves the definition of users to the implementation\&.
.SH "SEE ALSO"
ALTER ROLE (\fBALTER_ROLE\fR(7))
man/man7/COMMENT.7 0000644 00000024321 14751153421 0007360 0 ustar 00 '\" t
.\" Title: COMMENT
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "COMMENT" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
COMMENT \- define or change the comment of an object
.SH "SYNOPSIS"
.sp
.nf
COMMENT ON
{
ACCESS METHOD \fIobject_name\fR |
AGGREGATE \fIaggregate_name\fR ( \fIaggregate_signature\fR ) |
CAST (\fIsource_type\fR AS \fItarget_type\fR) |
COLLATION \fIobject_name\fR |
COLUMN \fIrelation_name\fR\&.\fIcolumn_name\fR |
CONSTRAINT \fIconstraint_name\fR ON \fItable_name\fR |
CONSTRAINT \fIconstraint_name\fR ON DOMAIN \fIdomain_name\fR |
CONVERSION \fIobject_name\fR |
DATABASE \fIobject_name\fR |
DOMAIN \fIobject_name\fR |
EXTENSION \fIobject_name\fR |
EVENT TRIGGER \fIobject_name\fR |
FOREIGN DATA WRAPPER \fIobject_name\fR |
FOREIGN TABLE \fIobject_name\fR |
FUNCTION \fIfunction_name\fR ( [ [ \fIargmode\fR ] [ \fIargname\fR ] \fIargtype\fR [, \&.\&.\&.] ] ) |
INDEX \fIobject_name\fR |
LARGE OBJECT \fIlarge_object_oid\fR |
MATERIALIZED VIEW \fIobject_name\fR |
OPERATOR \fIoperator_name\fR (\fIleft_type\fR, \fIright_type\fR) |
OPERATOR CLASS \fIobject_name\fR USING \fIindex_method\fR |
OPERATOR FAMILY \fIobject_name\fR USING \fIindex_method\fR |
POLICY \fIpolicy_name\fR ON \fItable_name\fR |
[ PROCEDURAL ] LANGUAGE \fIobject_name\fR |
ROLE \fIobject_name\fR |
RULE \fIrule_name\fR ON \fItable_name\fR |
SCHEMA \fIobject_name\fR |
SEQUENCE \fIobject_name\fR |
SERVER \fIobject_name\fR |
TABLE \fIobject_name\fR |
TABLESPACE \fIobject_name\fR |
TEXT SEARCH CONFIGURATION \fIobject_name\fR |
TEXT SEARCH DICTIONARY \fIobject_name\fR |
TEXT SEARCH PARSER \fIobject_name\fR |
TEXT SEARCH TEMPLATE \fIobject_name\fR |
TRANSFORM FOR \fItype_name\fR LANGUAGE \fIlang_name\fR |
TRIGGER \fItrigger_name\fR ON \fItable_name\fR |
TYPE \fIobject_name\fR |
VIEW \fIobject_name\fR
} IS \*(Aq\fItext\fR\*(Aq
where \fIaggregate_signature\fR is:
* |
[ \fIargmode\fR ] [ \fIargname\fR ] \fIargtype\fR [ , \&.\&.\&. ] |
[ [ \fIargmode\fR ] [ \fIargname\fR ] \fIargtype\fR [ , \&.\&.\&. ] ] ORDER BY [ \fIargmode\fR ] [ \fIargname\fR ] \fIargtype\fR [ , \&.\&.\&. ]
.fi
.SH "DESCRIPTION"
.PP
\fBCOMMENT\fR
stores a comment about a database object\&.
.PP
Only one comment string is stored for each object, so to modify a comment, issue a new
\fBCOMMENT\fR
command for the same object\&. To remove a comment, write
NULL
in place of the text string\&. Comments are automatically dropped when their object is dropped\&.
.PP
For most kinds of object, only the object\*(Aqs owner can set the comment\&. Roles don\*(Aqt have owners, so the rule for
COMMENT ON ROLE
is that you must be superuser to comment on a superuser role, or have the
CREATEROLE
privilege to comment on non\-superuser roles\&. Likewise, access methods don\*(Aqt have owners either; you must be superuser to comment on an access method\&. Of course, a superuser can comment on anything\&.
.PP
Comments can be viewed using
psql\*(Aqs
\fB\ed\fR
family of commands\&. Other user interfaces to retrieve comments can be built atop the same built\-in functions that
psql
uses, namely
\fBobj_description\fR,
\fBcol_description\fR, and
\fBshobj_description\fR
(see
Table\ \&9.67, \(lqComment Information Functions\(rq)\&.
.SH "PARAMETERS"
.PP
\fIobject_name\fR
.br
\fIrelation_name\fR\&.\fIcolumn_name\fR
.br
\fIaggregate_name\fR
.br
\fIconstraint_name\fR
.br
\fIfunction_name\fR
.br
\fIoperator_name\fR
.br
\fIpolicy_name\fR
.br
\fIrule_name\fR
.br
\fItrigger_name\fR
.RS 4
The name of the object to be commented\&. Names of tables, aggregates, collations, conversions, domains, foreign tables, functions, indexes, operators, operator classes, operator families, sequences, text search objects, types, and views can be schema\-qualified\&. When commenting on a column,
\fIrelation_name\fR
must refer to a table, view, composite type, or foreign table\&.
.RE
.PP
\fItable_name\fR
.br
\fIdomain_name\fR
.RS 4
When creating a comment on a constraint, a trigger, a rule or a policy these parameters specify the name of the table or domain on which that object is defined\&.
.RE
.PP
\fIsource_type\fR
.RS 4
The name of the source data type of the cast\&.
.RE
.PP
\fItarget_type\fR
.RS 4
The name of the target data type of the cast\&.
.RE
.PP
\fIargmode\fR
.RS 4
The mode of a function or aggregate argument:
IN,
OUT,
INOUT, or
VARIADIC\&. If omitted, the default is
IN\&. Note that
\fBCOMMENT\fR
does not actually pay any attention to
OUT
arguments, since only the input arguments are needed to determine the function\*(Aqs identity\&. So it is sufficient to list the
IN,
INOUT, and
VARIADIC
arguments\&.
.RE
.PP
\fIargname\fR
.RS 4
The name of a function or aggregate argument\&. Note that
\fBCOMMENT\fR
does not actually pay any attention to argument names, since only the argument data types are needed to determine the function\*(Aqs identity\&.
.RE
.PP
\fIargtype\fR
.RS 4
The data type of a function or aggregate argument\&.
.RE
.PP
\fIlarge_object_oid\fR
.RS 4
The OID of the large object\&.
.RE
.PP
\fIleft_type\fR
.br
\fIright_type\fR
.RS 4
The data type(s) of the operator\*(Aqs arguments (optionally schema\-qualified)\&. Write
NONE
for the missing argument of a prefix or postfix operator\&.
.RE
.PP
PROCEDURAL
.RS 4
This is a noise word\&.
.RE
.PP
\fItype_name\fR
.RS 4
The name of the data type of the transform\&.
.RE
.PP
\fIlang_name\fR
.RS 4
The name of the language of the transform\&.
.RE
.PP
\fItext\fR
.RS 4
The new comment, written as a string literal; or
NULL
to drop the comment\&.
.RE
.SH "NOTES"
.PP
There is presently no security mechanism for viewing comments: any user connected to a database can see all the comments for objects in that database\&. For shared objects such as databases, roles, and tablespaces, comments are stored globally so any user connected to any database in the cluster can see all the comments for shared objects\&. Therefore, don\*(Aqt put security\-critical information in comments\&.
.SH "EXAMPLES"
.PP
Attach a comment to the table
mytable:
.sp
.if n \{\
.RS 4
.\}
.nf
COMMENT ON TABLE mytable IS \*(AqThis is my table\&.\*(Aq;
.fi
.if n \{\
.RE
.\}
.sp
Remove it again:
.sp
.if n \{\
.RS 4
.\}
.nf
COMMENT ON TABLE mytable IS NULL;
.fi
.if n \{\
.RE
.\}
.PP
Some more examples:
.sp
.if n \{\
.RS 4
.\}
.nf
COMMENT ON ACCESS METHOD rtree IS \*(AqR\-Tree access method\*(Aq;
COMMENT ON AGGREGATE my_aggregate (double precision) IS \*(AqComputes sample variance\*(Aq;
COMMENT ON CAST (text AS int4) IS \*(AqAllow casts from text to int4\*(Aq;
COMMENT ON COLLATION "fr_CA" IS \*(AqCanadian French\*(Aq;
COMMENT ON COLUMN my_table\&.my_column IS \*(AqEmployee ID number\*(Aq;
COMMENT ON CONVERSION my_conv IS \*(AqConversion to UTF8\*(Aq;
COMMENT ON CONSTRAINT bar_col_cons ON bar IS \*(AqConstrains column col\*(Aq;
COMMENT ON CONSTRAINT dom_col_constr ON DOMAIN dom IS \*(AqConstrains col of domain\*(Aq;
COMMENT ON DATABASE my_database IS \*(AqDevelopment Database\*(Aq;
COMMENT ON DOMAIN my_domain IS \*(AqEmail Address Domain\*(Aq;
COMMENT ON EXTENSION hstore IS \*(Aqimplements the hstore data type\*(Aq;
COMMENT ON FOREIGN DATA WRAPPER mywrapper IS \*(Aqmy foreign data wrapper\*(Aq;
COMMENT ON FOREIGN TABLE my_foreign_table IS \*(AqEmployee Information in other database\*(Aq;
COMMENT ON FUNCTION my_function (timestamp) IS \*(AqReturns Roman Numeral\*(Aq;
COMMENT ON INDEX my_index IS \*(AqEnforces uniqueness on employee ID\*(Aq;
COMMENT ON LANGUAGE plpython IS \*(AqPython support for stored procedures\*(Aq;
COMMENT ON LARGE OBJECT 346344 IS \*(AqPlanning document\*(Aq;
COMMENT ON MATERIALIZED VIEW my_matview IS \*(AqSummary of order history\*(Aq;
COMMENT ON OPERATOR ^ (text, text) IS \*(AqPerforms intersection of two texts\*(Aq;
COMMENT ON OPERATOR \- (NONE, integer) IS \*(AqUnary minus\*(Aq;
COMMENT ON OPERATOR CLASS int4ops USING btree IS \*(Aq4 byte integer operators for btrees\*(Aq;
COMMENT ON OPERATOR FAMILY integer_ops USING btree IS \*(Aqall integer operators for btrees\*(Aq;
COMMENT ON POLICY my_policy ON mytable IS \*(AqFilter rows by users\*(Aq;
COMMENT ON ROLE my_role IS \*(AqAdministration group for finance tables\*(Aq;
COMMENT ON RULE my_rule ON my_table IS \*(AqLogs updates of employee records\*(Aq;
COMMENT ON SCHEMA my_schema IS \*(AqDepartmental data\*(Aq;
COMMENT ON SEQUENCE my_sequence IS \*(AqUsed to generate primary keys\*(Aq;
COMMENT ON SERVER myserver IS \*(Aqmy foreign server\*(Aq;
COMMENT ON TABLE my_schema\&.my_table IS \*(AqEmployee Information\*(Aq;
COMMENT ON TABLESPACE my_tablespace IS \*(AqTablespace for indexes\*(Aq;
COMMENT ON TEXT SEARCH CONFIGURATION my_config IS \*(AqSpecial word filtering\*(Aq;
COMMENT ON TEXT SEARCH DICTIONARY swedish IS \*(AqSnowball stemmer for Swedish language\*(Aq;
COMMENT ON TEXT SEARCH PARSER my_parser IS \*(AqSplits text into words\*(Aq;
COMMENT ON TEXT SEARCH TEMPLATE snowball IS \*(AqSnowball stemmer\*(Aq;
COMMENT ON TRANSFORM FOR hstore LANGUAGE plpythonu IS \*(AqTransform between hstore and Python dict\*(Aq;
COMMENT ON TRIGGER my_trigger ON my_table IS \*(AqUsed for RI\*(Aq;
COMMENT ON TYPE complex IS \*(AqComplex number data type\*(Aq;
COMMENT ON VIEW my_view IS \*(AqView of departmental costs\*(Aq;
.fi
.if n \{\
.RE
.\}
.SH "COMPATIBILITY"
.PP
There is no
\fBCOMMENT\fR
command in the SQL standard\&.
man/man7/COMMIT.7 0000644 00000004151 14751153421 0007245 0 ustar 00 '\" t
.\" Title: COMMIT
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "COMMIT" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
COMMIT \- commit the current transaction
.SH "SYNOPSIS"
.sp
.nf
COMMIT [ WORK | TRANSACTION ]
.fi
.SH "DESCRIPTION"
.PP
\fBCOMMIT\fR
commits the current transaction\&. All changes made by the transaction become visible to others and are guaranteed to be durable if a crash occurs\&.
.SH "PARAMETERS"
.PP
WORK
.br
TRANSACTION
.RS 4
Optional key words\&. They have no effect\&.
.RE
.SH "NOTES"
.PP
Use
\fBROLLBACK\fR(7)
to abort a transaction\&.
.PP
Issuing
\fBCOMMIT\fR
when not inside a transaction does no harm, but it will provoke a warning message\&.
.SH "EXAMPLES"
.PP
To commit the current transaction and make all changes permanent:
.sp
.if n \{\
.RS 4
.\}
.nf
COMMIT;
.fi
.if n \{\
.RE
.\}
.SH "COMPATIBILITY"
.PP
The SQL standard only specifies the two forms
COMMIT
and
COMMIT WORK\&. Otherwise, this command is fully conforming\&.
.SH "SEE ALSO"
\fBBEGIN\fR(7), \fBROLLBACK\fR(7)
man/man7/CREATE_TEXT_SEARCH_TEMPLATE.7 0000644 00000006614 14751153421 0012412 0 ustar 00 '\" t
.\" Title: CREATE TEXT SEARCH TEMPLATE
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "CREATE TEXT SEARCH TEMPLATE" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
CREATE_TEXT_SEARCH_TEMPLATE \- define a new text search template
.SH "SYNOPSIS"
.sp
.nf
CREATE TEXT SEARCH TEMPLATE \fIname\fR (
[ INIT = \fIinit_function\fR , ]
LEXIZE = \fIlexize_function\fR
)
.fi
.SH "DESCRIPTION"
.PP
\fBCREATE TEXT SEARCH TEMPLATE\fR
creates a new text search template\&. Text search templates define the functions that implement text search dictionaries\&. A template is not useful by itself, but must be instantiated as a dictionary to be used\&. The dictionary typically specifies parameters to be given to the template functions\&.
.PP
If a schema name is given then the text search template is created in the specified schema\&. Otherwise it is created in the current schema\&.
.PP
You must be a superuser to use
\fBCREATE TEXT SEARCH TEMPLATE\fR\&. This restriction is made because an erroneous text search template definition could confuse or even crash the server\&. The reason for separating templates from dictionaries is that a template encapsulates the
\(lqunsafe\(rq
aspects of defining a dictionary\&. The parameters that can be set when defining a dictionary are safe for unprivileged users to set, and so creating a dictionary need not be a privileged operation\&.
.PP
Refer to
Chapter 12, Full Text Search, in the documentation
for further information\&.
.SH "PARAMETERS"
.PP
\fIname\fR
.RS 4
The name of the text search template to be created\&. The name can be schema\-qualified\&.
.RE
.PP
\fIinit_function\fR
.RS 4
The name of the init function for the template\&.
.RE
.PP
\fIlexize_function\fR
.RS 4
The name of the lexize function for the template\&.
.RE
.PP
The function names can be schema\-qualified if necessary\&. Argument types are not given, since the argument list for each type of function is predetermined\&. The lexize function is required, but the init function is optional\&.
.PP
The arguments can appear in any order, not only the one shown above\&.
.SH "COMPATIBILITY"
.PP
There is no
\fBCREATE TEXT SEARCH TEMPLATE\fR
statement in the SQL standard\&.
.SH "SEE ALSO"
ALTER TEXT SEARCH TEMPLATE (\fBALTER_TEXT_SEARCH_TEMPLATE\fR(7)), DROP TEXT SEARCH TEMPLATE (\fBDROP_TEXT_SEARCH_TEMPLATE\fR(7))
man/man7/ALTER_LANGUAGE.7 0000644 00000004147 14751153421 0010374 0 ustar 00 '\" t
.\" Title: ALTER LANGUAGE
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "ALTER LANGUAGE" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
ALTER_LANGUAGE \- change the definition of a procedural language
.SH "SYNOPSIS"
.sp
.nf
ALTER [ PROCEDURAL ] LANGUAGE \fIname\fR RENAME TO \fInew_name\fR
ALTER [ PROCEDURAL ] LANGUAGE \fIname\fR OWNER TO { \fInew_owner\fR | CURRENT_USER | SESSION_USER }
.fi
.SH "DESCRIPTION"
.PP
\fBALTER LANGUAGE\fR
changes the definition of a procedural language\&. The only functionality is to rename the language or assign a new owner\&. You must be superuser or owner of the language to use
\fBALTER LANGUAGE\fR\&.
.SH "PARAMETERS"
.PP
\fIname\fR
.RS 4
Name of a language
.RE
.PP
\fInew_name\fR
.RS 4
The new name of the language
.RE
.PP
\fInew_owner\fR
.RS 4
The new owner of the language
.RE
.SH "COMPATIBILITY"
.PP
There is no
\fBALTER LANGUAGE\fR
statement in the SQL standard\&.
.SH "SEE ALSO"
CREATE LANGUAGE (\fBCREATE_LANGUAGE\fR(7)), DROP LANGUAGE (\fBDROP_LANGUAGE\fR(7))
man/man7/SET_ROLE.7 0000644 00000011242 14751153421 0007530 0 ustar 00 '\" t
.\" Title: SET ROLE
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "SET ROLE" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
SET_ROLE \- set the current user identifier of the current session
.SH "SYNOPSIS"
.sp
.nf
SET [ SESSION | LOCAL ] ROLE \fIrole_name\fR
SET [ SESSION | LOCAL ] ROLE NONE
RESET ROLE
.fi
.SH "DESCRIPTION"
.PP
This command sets the current user identifier of the current SQL session to be
\fIrole_name\fR\&. The role name can be written as either an identifier or a string literal\&. After
\fBSET ROLE\fR, permissions checking for SQL commands is carried out as though the named role were the one that had logged in originally\&.
.PP
The specified
\fIrole_name\fR
must be a role that the current session user is a member of\&. (If the session user is a superuser, any role can be selected\&.)
.PP
The
SESSION
and
LOCAL
modifiers act the same as for the regular
\fBSET\fR(7)
command\&.
.PP
SET ROLE NONE
sets the current user identifier to the current session user identifier, as returned by
\fBsession_user\fR\&.
RESET ROLE
sets the current user identifier to the connection\-time setting specified by the
command\-line options,
\fBALTER ROLE\fR, or
\fBALTER DATABASE\fR, if any such settings exist\&. Otherwise,
RESET ROLE
sets the current user identifier to the current session user identifier\&. These forms can be executed by any user\&.
.SH "NOTES"
.PP
Using this command, it is possible to either add privileges or restrict one\*(Aqs privileges\&. If the session user role has the
INHERIT
attribute, then it automatically has all the privileges of every role that it could
\fBSET ROLE\fR
to; in this case
\fBSET ROLE\fR
effectively drops all the privileges assigned directly to the session user and to the other roles it is a member of, leaving only the privileges available to the named role\&. On the other hand, if the session user role has the
NOINHERIT
attribute,
\fBSET ROLE\fR
drops the privileges assigned directly to the session user and instead acquires the privileges available to the named role\&.
.PP
In particular, when a superuser chooses to
\fBSET ROLE\fR
to a non\-superuser role, they lose their superuser privileges\&.
.PP
\fBSET ROLE\fR
has effects comparable to
SET SESSION AUTHORIZATION (\fBSET_SESSION_AUTHORIZATION\fR(7)), but the privilege checks involved are quite different\&. Also,
\fBSET SESSION AUTHORIZATION\fR
determines which roles are allowable for later
\fBSET ROLE\fR
commands, whereas changing roles with
\fBSET ROLE\fR
does not change the set of roles allowed to a later
\fBSET ROLE\fR\&.
.PP
\fBSET ROLE\fR
does not process session variables as specified by the role\*(Aqs
ALTER ROLE (\fBALTER_ROLE\fR(7))
settings; this only happens during login\&.
.PP
\fBSET ROLE\fR
cannot be used within a
SECURITY DEFINER
function\&.
.SH "EXAMPLES"
.sp
.if n \{\
.RS 4
.\}
.nf
SELECT SESSION_USER, CURRENT_USER;
session_user | current_user
\-\-\-\-\-\-\-\-\-\-\-\-\-\-+\-\-\-\-\-\-\-\-\-\-\-\-\-\-
peter | peter
SET ROLE \*(Aqpaul\*(Aq;
SELECT SESSION_USER, CURRENT_USER;
session_user | current_user
\-\-\-\-\-\-\-\-\-\-\-\-\-\-+\-\-\-\-\-\-\-\-\-\-\-\-\-\-
peter | paul
.fi
.if n \{\
.RE
.\}
.SH "COMPATIBILITY"
.PP
PostgreSQL
allows identifier syntax ("\fIrolename\fR"), while the SQL standard requires the role name to be written as a string literal\&. SQL does not allow this command during a transaction;
PostgreSQL
does not make this restriction because there is no reason to\&. The
SESSION
and
LOCAL
modifiers are a
PostgreSQL
extension, as is the
RESET
syntax\&.
.SH "SEE ALSO"
SET SESSION AUTHORIZATION (\fBSET_SESSION_AUTHORIZATION\fR(7))
man/man7/CREATE_CAST.7 0000644 00000033067 14751153421 0010042 0 ustar 00 '\" t
.\" Title: CREATE CAST
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "CREATE CAST" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
CREATE_CAST \- define a new cast
.SH "SYNOPSIS"
.sp
.nf
CREATE CAST (\fIsource_type\fR AS \fItarget_type\fR)
WITH FUNCTION \fIfunction_name\fR (\fIargument_type\fR [, \&.\&.\&.])
[ AS ASSIGNMENT | AS IMPLICIT ]
CREATE CAST (\fIsource_type\fR AS \fItarget_type\fR)
WITHOUT FUNCTION
[ AS ASSIGNMENT | AS IMPLICIT ]
CREATE CAST (\fIsource_type\fR AS \fItarget_type\fR)
WITH INOUT
[ AS ASSIGNMENT | AS IMPLICIT ]
.fi
.SH "DESCRIPTION"
.PP
\fBCREATE CAST\fR
defines a new cast\&. A cast specifies how to perform a conversion between two data types\&. For example,
.sp
.if n \{\
.RS 4
.\}
.nf
SELECT CAST(42 AS float8);
.fi
.if n \{\
.RE
.\}
.sp
converts the integer constant 42 to type
float8
by invoking a previously specified function, in this case
float8(int4)\&. (If no suitable cast has been defined, the conversion fails\&.)
.PP
Two types can be
binary coercible, which means that the conversion can be performed
\(lqfor free\(rq
without invoking any function\&. This requires that corresponding values use the same internal representation\&. For instance, the types
text
and
varchar
are binary coercible both ways\&. Binary coercibility is not necessarily a symmetric relationship\&. For example, the cast from
xml
to
text
can be performed for free in the present implementation, but the reverse direction requires a function that performs at least a syntax check\&. (Two types that are binary coercible both ways are also referred to as binary compatible\&.)
.PP
You can define a cast as an
I/O conversion cast
by using the
WITH INOUT
syntax\&. An I/O conversion cast is performed by invoking the output function of the source data type, and passing the resulting string to the input function of the target data type\&. In many common cases, this feature avoids the need to write a separate cast function for conversion\&. An I/O conversion cast acts the same as a regular function\-based cast; only the implementation is different\&.
.PP
By default, a cast can be invoked only by an explicit cast request, that is an explicit
CAST(\fIx\fR AS \fItypename\fR)
or
\fIx\fR::\fItypename\fR
construct\&.
.PP
If the cast is marked
AS ASSIGNMENT
then it can be invoked implicitly when assigning a value to a column of the target data type\&. For example, supposing that
foo\&.f1
is a column of type
text, then:
.sp
.if n \{\
.RS 4
.\}
.nf
INSERT INTO foo (f1) VALUES (42);
.fi
.if n \{\
.RE
.\}
.sp
will be allowed if the cast from type
integer
to type
text
is marked
AS ASSIGNMENT, otherwise not\&. (We generally use the term
assignment cast
to describe this kind of cast\&.)
.PP
If the cast is marked
AS IMPLICIT
then it can be invoked implicitly in any context, whether assignment or internally in an expression\&. (We generally use the term
implicit cast
to describe this kind of cast\&.) For example, consider this query:
.sp
.if n \{\
.RS 4
.\}
.nf
SELECT 2 + 4\&.0;
.fi
.if n \{\
.RE
.\}
.sp
The parser initially marks the constants as being of type
integer
and
numeric
respectively\&. There is no
integer
+
numeric
operator in the system catalogs, but there is a
numeric
+
numeric
operator\&. The query will therefore succeed if a cast from
integer
to
numeric
is available and is marked
AS IMPLICIT
\(em which in fact it is\&. The parser will apply the implicit cast and resolve the query as if it had been written
.sp
.if n \{\
.RS 4
.\}
.nf
SELECT CAST ( 2 AS numeric ) + 4\&.0;
.fi
.if n \{\
.RE
.\}
.PP
Now, the catalogs also provide a cast from
numeric
to
integer\&. If that cast were marked
AS IMPLICIT
\(em which it is not \(em then the parser would be faced with choosing between the above interpretation and the alternative of casting the
numeric
constant to
integer
and applying the
integer
+
integer
operator\&. Lacking any knowledge of which choice to prefer, it would give up and declare the query ambiguous\&. The fact that only one of the two casts is implicit is the way in which we teach the parser to prefer resolution of a mixed
numeric\-and\-integer
expression as
numeric; there is no built\-in knowledge about that\&.
.PP
It is wise to be conservative about marking casts as implicit\&. An overabundance of implicit casting paths can cause
PostgreSQL
to choose surprising interpretations of commands, or to be unable to resolve commands at all because there are multiple possible interpretations\&. A good rule of thumb is to make a cast implicitly invokable only for information\-preserving transformations between types in the same general type category\&. For example, the cast from
int2
to
int4
can reasonably be implicit, but the cast from
float8
to
int4
should probably be assignment\-only\&. Cross\-type\-category casts, such as
text
to
int4, are best made explicit\-only\&.
.if n \{\
.sp
.\}
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBNote\fR
.ps -1
.br
.PP
Sometimes it is necessary for usability or standards\-compliance reasons to provide multiple implicit casts among a set of types, resulting in ambiguity that cannot be avoided as above\&. The parser has a fallback heuristic based on
type categories
and
preferred types
that can help to provide desired behavior in such cases\&. See
CREATE TYPE (\fBCREATE_TYPE\fR(7))
for more information\&.
.sp .5v
.RE
.PP
To be able to create a cast, you must own the source or the target data type and have
USAGE
privilege on the other type\&. To create a binary\-coercible cast, you must be superuser\&. (This restriction is made because an erroneous binary\-coercible cast conversion can easily crash the server\&.)
.SH "PARAMETERS"
.PP
\fIsource_type\fR
.RS 4
The name of the source data type of the cast\&.
.RE
.PP
\fItarget_type\fR
.RS 4
The name of the target data type of the cast\&.
.RE
.PP
\fIfunction_name\fR(\fIargument_type\fR [, \&.\&.\&.])
.RS 4
The function used to perform the cast\&. The function name can be schema\-qualified\&. If it is not, the function will be looked up in the schema search path\&. The function\*(Aqs result data type must match the target type of the cast\&. Its arguments are discussed below\&.
.RE
.PP
WITHOUT FUNCTION
.RS 4
Indicates that the source type is binary\-coercible to the target type, so no function is required to perform the cast\&.
.RE
.PP
WITH INOUT
.RS 4
Indicates that the cast is an I/O conversion cast, performed by invoking the output function of the source data type, and passing the resulting string to the input function of the target data type\&.
.RE
.PP
AS ASSIGNMENT
.RS 4
Indicates that the cast can be invoked implicitly in assignment contexts\&.
.RE
.PP
AS IMPLICIT
.RS 4
Indicates that the cast can be invoked implicitly in any context\&.
.RE
.PP
Cast implementation functions can have one to three arguments\&. The first argument type must be identical to or binary\-coercible from the cast\*(Aqs source type\&. The second argument, if present, must be type
integer; it receives the type modifier associated with the destination type, or
\-1
if there is none\&. The third argument, if present, must be type
boolean; it receives
true
if the cast is an explicit cast,
false
otherwise\&. (Bizarrely, the SQL standard demands different behaviors for explicit and implicit casts in some cases\&. This argument is supplied for functions that must implement such casts\&. It is not recommended that you design your own data types so that this matters\&.)
.PP
The return type of a cast function must be identical to or binary\-coercible to the cast\*(Aqs target type\&.
.PP
Ordinarily a cast must have different source and target data types\&. However, it is allowed to declare a cast with identical source and target types if it has a cast implementation function with more than one argument\&. This is used to represent type\-specific length coercion functions in the system catalogs\&. The named function is used to coerce a value of the type to the type modifier value given by its second argument\&.
.PP
When a cast has different source and target types and a function that takes more than one argument, it supports converting from one type to another and applying a length coercion in a single step\&. When no such entry is available, coercion to a type that uses a type modifier involves two cast steps, one to convert between data types and a second to apply the modifier\&.
.PP
A cast to or from a domain type currently has no effect\&. Casting to or from a domain uses the casts associated with its underlying type\&.
.SH "NOTES"
.PP
Use
DROP CAST (\fBDROP_CAST\fR(7))
to remove user\-defined casts\&.
.PP
Remember that if you want to be able to convert types both ways you need to declare casts both ways explicitly\&.
.PP
It is normally not necessary to create casts between user\-defined types and the standard string types (text,
varchar, and
char(\fIn\fR), as well as user\-defined types that are defined to be in the string category)\&.
PostgreSQL
provides automatic I/O conversion casts for that\&. The automatic casts to string types are treated as assignment casts, while the automatic casts from string types are explicit\-only\&. You can override this behavior by declaring your own cast to replace an automatic cast, but usually the only reason to do so is if you want the conversion to be more easily invokable than the standard assignment\-only or explicit\-only setting\&. Another possible reason is that you want the conversion to behave differently from the type\*(Aqs I/O function; but that is sufficiently surprising that you should think twice about whether it\*(Aqs a good idea\&. (A small number of the built\-in types do indeed have different behaviors for conversions, mostly because of requirements of the SQL standard\&.)
.PP
While not required, it is recommended that you continue to follow this old convention of naming cast implementation functions after the target data type\&. Many users are used to being able to cast data types using a function\-style notation, that is
\fItypename\fR(\fIx\fR)\&. This notation is in fact nothing more nor less than a call of the cast implementation function; it is not specially treated as a cast\&. If your conversion functions are not named to support this convention then you will have surprised users\&. Since
PostgreSQL
allows overloading of the same function name with different argument types, there is no difficulty in having multiple conversion functions from different types that all use the target type\*(Aqs name\&.
.if n \{\
.sp
.\}
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBNote\fR
.ps -1
.br
.PP
Actually the preceding paragraph is an oversimplification: there are two cases in which a function\-call construct will be treated as a cast request without having matched it to an actual function\&. If a function call
\fIname\fR(\fIx\fR) does not exactly match any existing function, but
\fIname\fR
is the name of a data type and
pg_cast
provides a binary\-coercible cast to this type from the type of
\fIx\fR, then the call will be construed as a binary\-coercible cast\&. This exception is made so that binary\-coercible casts can be invoked using functional syntax, even though they lack any function\&. Likewise, if there is no
pg_cast
entry but the cast would be to or from a string type, the call will be construed as an I/O conversion cast\&. This exception allows I/O conversion casts to be invoked using functional syntax\&.
.sp .5v
.RE
.if n \{\
.sp
.\}
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBNote\fR
.ps -1
.br
.PP
There is also an exception to the exception: I/O conversion casts from composite types to string types cannot be invoked using functional syntax, but must be written in explicit cast syntax (either
CAST
or
::
notation)\&. This exception was added because after the introduction of automatically\-provided I/O conversion casts, it was found too easy to accidentally invoke such a cast when a function or column reference was intended\&.
.sp .5v
.RE
.SH "EXAMPLES"
.PP
To create an assignment cast from type
bigint
to type
int4
using the function
int4(bigint):
.sp
.if n \{\
.RS 4
.\}
.nf
CREATE CAST (bigint AS int4) WITH FUNCTION int4(bigint) AS ASSIGNMENT;
.fi
.if n \{\
.RE
.\}
.sp
(This cast is already predefined in the system\&.)
.SH "COMPATIBILITY"
.PP
The
\fBCREATE CAST\fR
command conforms to the
SQL
standard, except that SQL does not make provisions for binary\-coercible types or extra arguments to implementation functions\&.
AS IMPLICIT
is a
PostgreSQL
extension, too\&.
.SH "SEE ALSO"
.PP
CREATE FUNCTION (\fBCREATE_FUNCTION\fR(7)),
CREATE TYPE (\fBCREATE_TYPE\fR(7)),
DROP CAST (\fBDROP_CAST\fR(7))
man/man7/CREATE_DATABASE.7 0000644 00000021053 14751153421 0010444 0 ustar 00 '\" t
.\" Title: CREATE DATABASE
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "CREATE DATABASE" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
CREATE_DATABASE \- create a new database
.SH "SYNOPSIS"
.sp
.nf
CREATE DATABASE \fIname\fR
[ [ WITH ] [ OWNER [=] \fIuser_name\fR ]
[ TEMPLATE [=] \fItemplate\fR ]
[ ENCODING [=] \fIencoding\fR ]
[ LC_COLLATE [=] \fIlc_collate\fR ]
[ LC_CTYPE [=] \fIlc_ctype\fR ]
[ TABLESPACE [=] \fItablespace_name\fR ]
[ ALLOW_CONNECTIONS [=] \fIallowconn\fR ]
[ CONNECTION LIMIT [=] \fIconnlimit\fR ]
[ IS_TEMPLATE [=] \fIistemplate\fR ] ]
.fi
.SH "DESCRIPTION"
.PP
\fBCREATE DATABASE\fR
creates a new
PostgreSQL
database\&.
.PP
To create a database, you must be a superuser or have the special
CREATEDB
privilege\&. See
CREATE USER (\fBCREATE_USER\fR(7))\&.
.PP
By default, the new database will be created by cloning the standard system database
template1\&. A different template can be specified by writing
TEMPLATE \fIname\fR\&. In particular, by writing
TEMPLATE template0, you can create a virgin database containing only the standard objects predefined by your version of
PostgreSQL\&. This is useful if you wish to avoid copying any installation\-local objects that might have been added to
template1\&.
.SH "PARAMETERS"
.PP
\fIname\fR
.RS 4
The name of a database to create\&.
.RE
.PP
\fIuser_name\fR
.RS 4
The role name of the user who will own the new database, or
DEFAULT
to use the default (namely, the user executing the command)\&. To create a database owned by another role, you must be a direct or indirect member of that role, or be a superuser\&.
.RE
.PP
\fItemplate\fR
.RS 4
The name of the template from which to create the new database, or
DEFAULT
to use the default template (template1)\&.
.RE
.PP
\fIencoding\fR
.RS 4
Character set encoding to use in the new database\&. Specify a string constant (e\&.g\&.,
\*(AqSQL_ASCII\*(Aq), or an integer encoding number, or
DEFAULT
to use the default encoding (namely, the encoding of the template database)\&. The character sets supported by the
PostgreSQL
server are described in
Section 23.3.1, \(lqSupported Character Sets\(rq, in the documentation\&. See below for additional restrictions\&.
.RE
.PP
\fIlc_collate\fR
.RS 4
Collation order (LC_COLLATE) to use in the new database\&. This affects the sort order applied to strings, e\&.g\&., in queries with ORDER BY, as well as the order used in indexes on text columns\&. The default is to use the collation order of the template database\&. See below for additional restrictions\&.
.RE
.PP
\fIlc_ctype\fR
.RS 4
Character classification (LC_CTYPE) to use in the new database\&. This affects the categorization of characters, e\&.g\&., lower, upper and digit\&. The default is to use the character classification of the template database\&. See below for additional restrictions\&.
.RE
.PP
\fItablespace_name\fR
.RS 4
The name of the tablespace that will be associated with the new database, or
DEFAULT
to use the template database\*(Aqs tablespace\&. This tablespace will be the default tablespace used for objects created in this database\&. See
CREATE TABLESPACE (\fBCREATE_TABLESPACE\fR(7))
for more information\&.
.RE
.PP
\fIallowconn\fR
.RS 4
If false then no one can connect to this database\&. The default is true, allowing connections (except as restricted by other mechanisms, such as
GRANT/REVOKE CONNECT)\&.
.RE
.PP
\fIconnlimit\fR
.RS 4
How many concurrent connections can be made to this database\&. \-1 (the default) means no limit\&.
.RE
.PP
\fIistemplate\fR
.RS 4
If true, then this database can be cloned by any user with
CREATEDB
privileges; if false (the default), then only superusers or the owner of the database can clone it\&.
.RE
.PP
Optional parameters can be written in any order, not only the order illustrated above\&.
.SH "NOTES"
.PP
\fBCREATE DATABASE\fR
cannot be executed inside a transaction block\&.
.PP
Errors along the line of
\(lqcould not initialize database directory\(rq
are most likely related to insufficient permissions on the data directory, a full disk, or other file system problems\&.
.PP
Use
DROP DATABASE (\fBDROP_DATABASE\fR(7))
to remove a database\&.
.PP
The program
\fBcreatedb\fR(1)
is a wrapper program around this command, provided for convenience\&.
.PP
Database\-level configuration parameters (set via
ALTER DATABASE (\fBALTER_DATABASE\fR(7))) and database\-level permissions (set via
\fBGRANT\fR(7)) are not copied from the template database\&.
.PP
Although it is possible to copy a database other than
template1
by specifying its name as the template, this is not (yet) intended as a general\-purpose
\(lq\fBCOPY DATABASE\fR\(rq
facility\&. The principal limitation is that no other sessions can be connected to the template database while it is being copied\&.
\fBCREATE DATABASE\fR
will fail if any other connection exists when it starts; otherwise, new connections to the template database are locked out until
\fBCREATE DATABASE\fR
completes\&. See
Section 22.3, \(lqTemplate Databases\(rq, in the documentation
for more information\&.
.PP
The character set encoding specified for the new database must be compatible with the chosen locale settings (LC_COLLATE
and
LC_CTYPE)\&. If the locale is
C
(or equivalently
POSIX), then all encodings are allowed, but for other locale settings there is only one encoding that will work properly\&. (On Windows, however, UTF\-8 encoding can be used with any locale\&.)
\fBCREATE DATABASE\fR
will allow superusers to specify
SQL_ASCII
encoding regardless of the locale settings, but this choice is deprecated and may result in misbehavior of character\-string functions if data that is not encoding\-compatible with the locale is stored in the database\&.
.PP
The encoding and locale settings must match those of the template database, except when
template0
is used as template\&. This is because other databases might contain data that does not match the specified encoding, or might contain indexes whose sort ordering is affected by
LC_COLLATE
and
LC_CTYPE\&. Copying such data would result in a database that is corrupt according to the new settings\&.
template0, however, is known to not contain any data or indexes that would be affected\&.
.PP
The
CONNECTION LIMIT
option is only enforced approximately; if two new sessions start at about the same time when just one connection
\(lqslot\(rq
remains for the database, it is possible that both will fail\&. Also, the limit is not enforced against superusers or background worker processes\&.
.SH "EXAMPLES"
.PP
To create a new database:
.sp
.if n \{\
.RS 4
.\}
.nf
CREATE DATABASE lusiadas;
.fi
.if n \{\
.RE
.\}
.PP
To create a database
sales
owned by user
salesapp
with a default tablespace of
salesspace:
.sp
.if n \{\
.RS 4
.\}
.nf
CREATE DATABASE sales OWNER salesapp TABLESPACE salesspace;
.fi
.if n \{\
.RE
.\}
.PP
To create a database
music
which supports the ISO\-8859\-1 character set:
.sp
.if n \{\
.RS 4
.\}
.nf
CREATE DATABASE music ENCODING \*(AqLATIN1\*(Aq TEMPLATE template0;
.fi
.if n \{\
.RE
.\}
.sp
In this example, the
TEMPLATE template0
clause would only be required if
template1\*(Aqs encoding is not ISO\-8859\-1\&. Note that changing encoding might require selecting new
LC_COLLATE
and
LC_CTYPE
settings as well\&.
.SH "COMPATIBILITY"
.PP
There is no
\fBCREATE DATABASE\fR
statement in the SQL standard\&. Databases are equivalent to catalogs, whose creation is implementation\-defined\&.
.SH "SEE ALSO"
ALTER DATABASE (\fBALTER_DATABASE\fR(7)), DROP DATABASE (\fBDROP_DATABASE\fR(7))
man/man7/REVOKE.7 0000644 00000025152 14751153421 0007254 0 ustar 00 '\" t
.\" Title: REVOKE
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "REVOKE" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
REVOKE \- remove access privileges
.SH "SYNOPSIS"
.sp
.nf
REVOKE [ GRANT OPTION FOR ]
{ { SELECT | INSERT | UPDATE | DELETE | TRUNCATE | REFERENCES | TRIGGER }
[, \&.\&.\&.] | ALL [ PRIVILEGES ] }
ON { [ TABLE ] \fItable_name\fR [, \&.\&.\&.]
| ALL TABLES IN SCHEMA \fIschema_name\fR [, \&.\&.\&.] }
FROM \fIrole_specification\fR [, \&.\&.\&.]
[ CASCADE | RESTRICT ]
REVOKE [ GRANT OPTION FOR ]
{ { SELECT | INSERT | UPDATE | REFERENCES } ( \fIcolumn_name\fR [, \&.\&.\&.] )
[, \&.\&.\&.] | ALL [ PRIVILEGES ] ( \fIcolumn_name\fR [, \&.\&.\&.] ) }
ON [ TABLE ] \fItable_name\fR [, \&.\&.\&.]
FROM \fIrole_specification\fR [, \&.\&.\&.]
[ CASCADE | RESTRICT ]
REVOKE [ GRANT OPTION FOR ]
{ { USAGE | SELECT | UPDATE }
[, \&.\&.\&.] | ALL [ PRIVILEGES ] }
ON { SEQUENCE \fIsequence_name\fR [, \&.\&.\&.]
| ALL SEQUENCES IN SCHEMA \fIschema_name\fR [, \&.\&.\&.] }
FROM \fIrole_specification\fR [, \&.\&.\&.]
[ CASCADE | RESTRICT ]
REVOKE [ GRANT OPTION FOR ]
{ { CREATE | CONNECT | TEMPORARY | TEMP } [, \&.\&.\&.] | ALL [ PRIVILEGES ] }
ON DATABASE \fIdatabase_name\fR [, \&.\&.\&.]
FROM \fIrole_specification\fR [, \&.\&.\&.]
[ CASCADE | RESTRICT ]
REVOKE [ GRANT OPTION FOR ]
{ USAGE | ALL [ PRIVILEGES ] }
ON DOMAIN \fIdomain_name\fR [, \&.\&.\&.]
FROM \fIrole_specification\fR [, \&.\&.\&.]
[ CASCADE | RESTRICT ]
REVOKE [ GRANT OPTION FOR ]
{ USAGE | ALL [ PRIVILEGES ] }
ON FOREIGN DATA WRAPPER \fIfdw_name\fR [, \&.\&.\&.]
FROM \fIrole_specification\fR [, \&.\&.\&.]
[ CASCADE | RESTRICT ]
REVOKE [ GRANT OPTION FOR ]
{ USAGE | ALL [ PRIVILEGES ] }
ON FOREIGN SERVER \fIserver_name\fR [, \&.\&.\&.]
FROM \fIrole_specification\fR [, \&.\&.\&.]
[ CASCADE | RESTRICT ]
REVOKE [ GRANT OPTION FOR ]
{ EXECUTE | ALL [ PRIVILEGES ] }
ON { FUNCTION \fIfunction_name\fR ( [ [ \fIargmode\fR ] [ \fIarg_name\fR ] \fIarg_type\fR [, \&.\&.\&.] ] ) [, \&.\&.\&.]
| ALL FUNCTIONS IN SCHEMA \fIschema_name\fR [, \&.\&.\&.] }
FROM \fIrole_specification\fR [, \&.\&.\&.]
[ CASCADE | RESTRICT ]
REVOKE [ GRANT OPTION FOR ]
{ USAGE | ALL [ PRIVILEGES ] }
ON LANGUAGE \fIlang_name\fR [, \&.\&.\&.]
FROM \fIrole_specification\fR [, \&.\&.\&.]
[ CASCADE | RESTRICT ]
REVOKE [ GRANT OPTION FOR ]
{ { SELECT | UPDATE } [, \&.\&.\&.] | ALL [ PRIVILEGES ] }
ON LARGE OBJECT \fIloid\fR [, \&.\&.\&.]
FROM \fIrole_specification\fR [, \&.\&.\&.]
[ CASCADE | RESTRICT ]
REVOKE [ GRANT OPTION FOR ]
{ { CREATE | USAGE } [, \&.\&.\&.] | ALL [ PRIVILEGES ] }
ON SCHEMA \fIschema_name\fR [, \&.\&.\&.]
FROM \fIrole_specification\fR [, \&.\&.\&.]
[ CASCADE | RESTRICT ]
REVOKE [ GRANT OPTION FOR ]
{ CREATE | ALL [ PRIVILEGES ] }
ON TABLESPACE \fItablespace_name\fR [, \&.\&.\&.]
FROM \fIrole_specification\fR [, \&.\&.\&.]
[ CASCADE | RESTRICT ]
REVOKE [ GRANT OPTION FOR ]
{ USAGE | ALL [ PRIVILEGES ] }
ON TYPE \fItype_name\fR [, \&.\&.\&.]
FROM \fIrole_specification\fR [, \&.\&.\&.]
[ CASCADE | RESTRICT ]
REVOKE [ ADMIN OPTION FOR ]
\fIrole_name\fR [, \&.\&.\&.] FROM \fIrole_specification\fR [, \&.\&.\&.]
[ GRANTED BY \fIrole_specification\fR ]
[ CASCADE | RESTRICT ]
where \fIrole_specification\fR can be:
[ GROUP ] \fIrole_name\fR
| PUBLIC
| CURRENT_USER
| SESSION_USER
.fi
.SH "DESCRIPTION"
.PP
The
\fBREVOKE\fR
command revokes previously granted privileges from one or more roles\&. The key word
PUBLIC
refers to the implicitly defined group of all roles\&.
.PP
See the description of the
\fBGRANT\fR(7)
command for the meaning of the privilege types\&.
.PP
Note that any particular role will have the sum of privileges granted directly to it, privileges granted to any role it is presently a member of, and privileges granted to
PUBLIC\&. Thus, for example, revoking
SELECT
privilege from
PUBLIC
does not necessarily mean that all roles have lost
SELECT
privilege on the object: those who have it granted directly or via another role will still have it\&. Similarly, revoking
SELECT
from a user might not prevent that user from using
SELECT
if
PUBLIC
or another membership role still has
SELECT
rights\&.
.PP
If
GRANT OPTION FOR
is specified, only the grant option for the privilege is revoked, not the privilege itself\&. Otherwise, both the privilege and the grant option are revoked\&.
.PP
If a user holds a privilege with grant option and has granted it to other users then the privileges held by those other users are called dependent privileges\&. If the privilege or the grant option held by the first user is being revoked and dependent privileges exist, those dependent privileges are also revoked if
CASCADE
is specified; if it is not, the revoke action will fail\&. This recursive revocation only affects privileges that were granted through a chain of users that is traceable to the user that is the subject of this
REVOKE
command\&. Thus, the affected users might effectively keep the privilege if it was also granted through other users\&.
.PP
When revoking privileges on a table, the corresponding column privileges (if any) are automatically revoked on each column of the table, as well\&. On the other hand, if a role has been granted privileges on a table, then revoking the same privileges from individual columns will have no effect\&.
.PP
When revoking membership in a role,
GRANT OPTION
is instead called
ADMIN OPTION, but the behavior is similar\&. This form of the command also allows a
GRANTED BY
option, but that option is currently ignored (except for checking the existence of the named role)\&. Note also that this form of the command does not allow the noise word
GROUP
in
\fIrole_specification\fR\&.
.SH "NOTES"
.PP
Use
\fBpsql\fR(1)\*(Aqs
\fB\edp\fR
command to display the privileges granted on existing tables and columns\&. See
\fBGRANT\fR(7)
for information about the format\&. For non\-table objects there are other
\fB\ed\fR
commands that can display their privileges\&.
.PP
A user can only revoke privileges that were granted directly by that user\&. If, for example, user A has granted a privilege with grant option to user B, and user B has in turn granted it to user C, then user A cannot revoke the privilege directly from C\&. Instead, user A could revoke the grant option from user B and use the
CASCADE
option so that the privilege is in turn revoked from user C\&. For another example, if both A and B have granted the same privilege to C, A can revoke their own grant but not B\*(Aqs grant, so C will still effectively have the privilege\&.
.PP
When a non\-owner of an object attempts to
\fBREVOKE\fR
privileges on the object, the command will fail outright if the user has no privileges whatsoever on the object\&. As long as some privilege is available, the command will proceed, but it will revoke only those privileges for which the user has grant options\&. The
\fBREVOKE ALL PRIVILEGES\fR
forms will issue a warning message if no grant options are held, while the other forms will issue a warning if grant options for any of the privileges specifically named in the command are not held\&. (In principle these statements apply to the object owner as well, but since the owner is always treated as holding all grant options, the cases can never occur\&.)
.PP
If a superuser chooses to issue a
\fBGRANT\fR
or
\fBREVOKE\fR
command, the command is performed as though it were issued by the owner of the affected object\&. Since all privileges ultimately come from the object owner (possibly indirectly via chains of grant options), it is possible for a superuser to revoke all privileges, but this might require use of
CASCADE
as stated above\&.
.PP
\fBREVOKE\fR
can also be done by a role that is not the owner of the affected object, but is a member of the role that owns the object, or is a member of a role that holds privileges
WITH GRANT OPTION
on the object\&. In this case the command is performed as though it were issued by the containing role that actually owns the object or holds the privileges
WITH GRANT OPTION\&. For example, if table
t1
is owned by role
g1, of which role
u1
is a member, then
u1
can revoke privileges on
t1
that are recorded as being granted by
g1\&. This would include grants made by
u1
as well as by other members of role
g1\&.
.PP
If the role executing
\fBREVOKE\fR
holds privileges indirectly via more than one role membership path, it is unspecified which containing role will be used to perform the command\&. In such cases it is best practice to use
\fBSET ROLE\fR
to become the specific role you want to do the
\fBREVOKE\fR
as\&. Failure to do so might lead to revoking privileges other than the ones you intended, or not revoking anything at all\&.
.SH "EXAMPLES"
.PP
Revoke insert privilege for the public on table
films:
.sp
.if n \{\
.RS 4
.\}
.nf
REVOKE INSERT ON films FROM PUBLIC;
.fi
.if n \{\
.RE
.\}
.PP
Revoke all privileges from user
manuel
on view
kinds:
.sp
.if n \{\
.RS 4
.\}
.nf
REVOKE ALL PRIVILEGES ON kinds FROM manuel;
.fi
.if n \{\
.RE
.\}
.sp
Note that this actually means
\(lqrevoke all privileges that I granted\(rq\&.
.PP
Revoke membership in role
admins
from user
joe:
.sp
.if n \{\
.RS 4
.\}
.nf
REVOKE admins FROM joe;
.fi
.if n \{\
.RE
.\}
.SH "COMPATIBILITY"
.PP
The compatibility notes of the
\fBGRANT\fR(7)
command apply analogously to
\fBREVOKE\fR\&. The keyword
RESTRICT
or
CASCADE
is required according to the standard, but
PostgreSQL
assumes
RESTRICT
by default\&.
.SH "SEE ALSO"
.sp
\fBGRANT\fR(7)
man/man7/DROP_TEXT_SEARCH_CONFIGURATION.7 0000644 00000005533 14751153421 0013006 0 ustar 00 '\" t
.\" Title: DROP TEXT SEARCH CONFIGURATION
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "DROP TEXT SEARCH CONFIGURATION" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
DROP_TEXT_SEARCH_CONFIGURATION \- remove a text search configuration
.SH "SYNOPSIS"
.sp
.nf
DROP TEXT SEARCH CONFIGURATION [ IF EXISTS ] \fIname\fR [ CASCADE | RESTRICT ]
.fi
.SH "DESCRIPTION"
.PP
\fBDROP TEXT SEARCH CONFIGURATION\fR
drops an existing text search configuration\&. To execute this command you must be the owner of the configuration\&.
.SH "PARAMETERS"
.PP
IF EXISTS
.RS 4
Do not throw an error if the text search configuration does not exist\&. A notice is issued in this case\&.
.RE
.PP
\fIname\fR
.RS 4
The name (optionally schema\-qualified) of an existing text search configuration\&.
.RE
.PP
CASCADE
.RS 4
Automatically drop objects that depend on the text search configuration, and in turn all objects that depend on those objects (see
Section 5.13, \(lqDependency Tracking\(rq, in the documentation)\&.
.RE
.PP
RESTRICT
.RS 4
Refuse to drop the text search configuration if any objects depend on it\&. This is the default\&.
.RE
.SH "EXAMPLES"
.PP
Remove the text search configuration
my_english:
.sp
.if n \{\
.RS 4
.\}
.nf
DROP TEXT SEARCH CONFIGURATION my_english;
.fi
.if n \{\
.RE
.\}
.sp
This command will not succeed if there are any existing indexes that reference the configuration in
\fBto_tsvector\fR
calls\&. Add
CASCADE
to drop such indexes along with the text search configuration\&.
.SH "COMPATIBILITY"
.PP
There is no
\fBDROP TEXT SEARCH CONFIGURATION\fR
statement in the SQL standard\&.
.SH "SEE ALSO"
ALTER TEXT SEARCH CONFIGURATION (\fBALTER_TEXT_SEARCH_CONFIGURATION\fR(7)), CREATE TEXT SEARCH CONFIGURATION (\fBCREATE_TEXT_SEARCH_CONFIGURATION\fR(7))
man/man7/END.7 0000644 00000004307 14751153421 0006666 0 ustar 00 '\" t
.\" Title: END
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "END" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
END \- commit the current transaction
.SH "SYNOPSIS"
.sp
.nf
END [ WORK | TRANSACTION ]
.fi
.SH "DESCRIPTION"
.PP
\fBEND\fR
commits the current transaction\&. All changes made by the transaction become visible to others and are guaranteed to be durable if a crash occurs\&. This command is a
PostgreSQL
extension that is equivalent to
\fBCOMMIT\fR(7)\&.
.SH "PARAMETERS"
.PP
WORK
.br
TRANSACTION
.RS 4
Optional key words\&. They have no effect\&.
.RE
.SH "NOTES"
.PP
Use
\fBROLLBACK\fR(7)
to abort a transaction\&.
.PP
Issuing
\fBEND\fR
when not inside a transaction does no harm, but it will provoke a warning message\&.
.SH "EXAMPLES"
.PP
To commit the current transaction and make all changes permanent:
.sp
.if n \{\
.RS 4
.\}
.nf
END;
.fi
.if n \{\
.RE
.\}
.SH "COMPATIBILITY"
.PP
\fBEND\fR
is a
PostgreSQL
extension that provides functionality equivalent to
\fBCOMMIT\fR(7), which is specified in the SQL standard\&.
.SH "SEE ALSO"
\fBBEGIN\fR(7), \fBCOMMIT\fR(7), \fBROLLBACK\fR(7)
man/man7/WITH.7 0000644 00000000022 14751153421 0007021 0 ustar 00 .so man7/SELECT.7
man/man7/ALTER_OPERATOR.7 0000644 00000007267 14751153421 0010452 0 ustar 00 '\" t
.\" Title: ALTER OPERATOR
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "ALTER OPERATOR" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
ALTER_OPERATOR \- change the definition of an operator
.SH "SYNOPSIS"
.sp
.nf
ALTER OPERATOR \fIname\fR ( { \fIleft_type\fR | NONE } , { \fIright_type\fR | NONE } )
OWNER TO { \fInew_owner\fR | CURRENT_USER | SESSION_USER }
ALTER OPERATOR \fIname\fR ( { \fIleft_type\fR | NONE } , { \fIright_type\fR | NONE } )
SET SCHEMA \fInew_schema\fR
ALTER OPERATOR \fIname\fR ( { \fIleft_type\fR | NONE } , { \fIright_type\fR | NONE } )
SET ( { RESTRICT = { \fIres_proc\fR | NONE }
| JOIN = { \fIjoin_proc\fR | NONE }
} [, \&.\&.\&. ] )
.fi
.SH "DESCRIPTION"
.PP
\fBALTER OPERATOR\fR
changes the definition of an operator\&.
.PP
You must own the operator to use
\fBALTER OPERATOR\fR\&. To alter the owner, you must also be a direct or indirect member of the new owning role, and that role must have
CREATE
privilege on the operator\*(Aqs schema\&. (These restrictions enforce that altering the owner doesn\*(Aqt do anything you couldn\*(Aqt do by dropping and recreating the operator\&. However, a superuser can alter ownership of any operator anyway\&.)
.SH "PARAMETERS"
.PP
\fIname\fR
.RS 4
The name (optionally schema\-qualified) of an existing operator\&.
.RE
.PP
\fIleft_type\fR
.RS 4
The data type of the operator\*(Aqs left operand; write
NONE
if the operator has no left operand\&.
.RE
.PP
\fIright_type\fR
.RS 4
The data type of the operator\*(Aqs right operand; write
NONE
if the operator has no right operand\&.
.RE
.PP
\fInew_owner\fR
.RS 4
The new owner of the operator\&.
.RE
.PP
\fInew_schema\fR
.RS 4
The new schema for the operator\&.
.RE
.PP
\fIres_proc\fR
.RS 4
The restriction selectivity estimator function for this operator; write NONE to remove existing selectivity estimator\&.
.RE
.PP
\fIjoin_proc\fR
.RS 4
The join selectivity estimator function for this operator; write NONE to remove existing selectivity estimator\&.
.RE
.SH "EXAMPLES"
.PP
Change the owner of a custom operator
a @@ b
for type
text:
.sp
.if n \{\
.RS 4
.\}
.nf
ALTER OPERATOR @@ (text, text) OWNER TO joe;
.fi
.if n \{\
.RE
.\}
.PP
Change the restriction and join selectivity estimator functions of a custom operator
a && b
for type
int[]:
.sp
.if n \{\
.RS 4
.\}
.nf
ALTER OPERATOR && (_int4, _int4) SET (RESTRICT = _int_contsel, JOIN = _int_contjoinsel);
.fi
.if n \{\
.RE
.\}
.SH "COMPATIBILITY"
.PP
There is no
\fBALTER OPERATOR\fR
statement in the SQL standard\&.
.SH "SEE ALSO"
CREATE OPERATOR (\fBCREATE_OPERATOR\fR(7)), DROP OPERATOR (\fBDROP_OPERATOR\fR(7))
man/man7/ALTER_INDEX.7 0000644 00000013142 14751153421 0010053 0 ustar 00 '\" t
.\" Title: ALTER INDEX
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "ALTER INDEX" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
ALTER_INDEX \- change the definition of an index
.SH "SYNOPSIS"
.sp
.nf
ALTER INDEX [ IF EXISTS ] \fIname\fR RENAME TO \fInew_name\fR
ALTER INDEX [ IF EXISTS ] \fIname\fR SET TABLESPACE \fItablespace_name\fR
ALTER INDEX \fIname\fR DEPENDS ON EXTENSION \fIextension_name\fR
ALTER INDEX [ IF EXISTS ] \fIname\fR SET ( \fIstorage_parameter\fR [= \fIvalue\fR] [, \&.\&.\&. ] )
ALTER INDEX [ IF EXISTS ] \fIname\fR RESET ( \fIstorage_parameter\fR [, \&.\&.\&. ] )
ALTER INDEX ALL IN TABLESPACE \fIname\fR [ OWNED BY \fIrole_name\fR [, \&.\&.\&. ] ]
SET TABLESPACE \fInew_tablespace\fR [ NOWAIT ]
.fi
.SH "DESCRIPTION"
.PP
\fBALTER INDEX\fR
changes the definition of an existing index\&. There are several subforms:
.PP
RENAME
.RS 4
The
RENAME
form changes the name of the index\&. There is no effect on the stored data\&.
.RE
.PP
SET TABLESPACE
.RS 4
This form changes the index\*(Aqs tablespace to the specified tablespace and moves the data file(s) associated with the index to the new tablespace\&. To change the tablespace of an index, you must own the index and have
CREATE
privilege on the new tablespace\&. All indexes in the current database in a tablespace can be moved by using the
ALL IN TABLESPACE
form, which will lock all indexes to be moved and then move each one\&. This form also supports
OWNED BY, which will only move indexes owned by the roles specified\&. If the
NOWAIT
option is specified then the command will fail if it is unable to acquire all of the locks required immediately\&. Note that system catalogs will not be moved by this command, use
\fBALTER DATABASE\fR
or explicit
\fBALTER INDEX\fR
invocations instead if desired\&. See also
CREATE TABLESPACE (\fBCREATE_TABLESPACE\fR(7))\&.
.RE
.PP
DEPENDS ON EXTENSION
.RS 4
This form marks the index as dependent on the extension, such that if the extension is dropped, the index will automatically be dropped as well\&.
.RE
.PP
SET ( \fIstorage_parameter\fR [= \fIvalue\fR] [, \&.\&.\&. ] )
.RS 4
This form changes one or more index\-method\-specific storage parameters for the index\&. See
CREATE INDEX (\fBCREATE_INDEX\fR(7))
for details on the available parameters\&. Note that the index contents will not be modified immediately by this command; depending on the parameter you might need to rebuild the index with
\fBREINDEX\fR(7)
to get the desired effects\&.
.RE
.PP
RESET ( \fIstorage_parameter\fR [, \&.\&.\&. ] )
.RS 4
This form resets one or more index\-method\-specific storage parameters to their defaults\&. As with
SET, a
REINDEX
might be needed to update the index entirely\&.
.RE
.SH "PARAMETERS"
.PP
IF EXISTS
.RS 4
Do not throw an error if the index does not exist\&. A notice is issued in this case\&.
.RE
.PP
\fIname\fR
.RS 4
The name (possibly schema\-qualified) of an existing index to alter\&.
.RE
.PP
\fInew_name\fR
.RS 4
The new name for the index\&.
.RE
.PP
\fItablespace_name\fR
.RS 4
The tablespace to which the index will be moved\&.
.RE
.PP
\fIextension_name\fR
.RS 4
The name of the extension that the index is to depend on\&.
.RE
.PP
\fIstorage_parameter\fR
.RS 4
The name of an index\-method\-specific storage parameter\&.
.RE
.PP
\fIvalue\fR
.RS 4
The new value for an index\-method\-specific storage parameter\&. This might be a number or a word depending on the parameter\&.
.RE
.SH "NOTES"
.PP
These operations are also possible using
ALTER TABLE (\fBALTER_TABLE\fR(7))\&.
\fBALTER INDEX\fR
is in fact just an alias for the forms of
\fBALTER TABLE\fR
that apply to indexes\&.
.PP
There was formerly an
\fBALTER INDEX OWNER\fR
variant, but this is now ignored (with a warning)\&. An index cannot have an owner different from its table\*(Aqs owner\&. Changing the table\*(Aqs owner automatically changes the index as well\&.
.PP
Changing any part of a system catalog index is not permitted\&.
.SH "EXAMPLES"
.PP
To rename an existing index:
.sp
.if n \{\
.RS 4
.\}
.nf
ALTER INDEX distributors RENAME TO suppliers;
.fi
.if n \{\
.RE
.\}
.PP
To move an index to a different tablespace:
.sp
.if n \{\
.RS 4
.\}
.nf
ALTER INDEX distributors SET TABLESPACE fasttablespace;
.fi
.if n \{\
.RE
.\}
.PP
To change an index\*(Aqs fill factor (assuming that the index method supports it):
.sp
.if n \{\
.RS 4
.\}
.nf
ALTER INDEX distributors SET (fillfactor = 75);
REINDEX INDEX distributors;
.fi
.if n \{\
.RE
.\}
.SH "COMPATIBILITY"
.PP
\fBALTER INDEX\fR
is a
PostgreSQL
extension\&.
.SH "SEE ALSO"
CREATE INDEX (\fBCREATE_INDEX\fR(7)), \fBREINDEX\fR(7)
man/man7/CREATE_OPERATOR_FAMILY.7 0000644 00000007147 14751153421 0011604 0 ustar 00 '\" t
.\" Title: CREATE OPERATOR FAMILY
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "CREATE OPERATOR FAMILY" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
CREATE_OPERATOR_FAMILY \- define a new operator family
.SH "SYNOPSIS"
.sp
.nf
CREATE OPERATOR FAMILY \fIname\fR USING \fIindex_method\fR
.fi
.SH "DESCRIPTION"
.PP
\fBCREATE OPERATOR FAMILY\fR
creates a new operator family\&. An operator family defines a collection of related operator classes, and perhaps some additional operators and support functions that are compatible with these operator classes but not essential for the functioning of any individual index\&. (Operators and functions that are essential to indexes should be grouped within the relevant operator class, rather than being
\(lqloose\(rq
in the operator family\&. Typically, single\-data\-type operators are bound to operator classes, while cross\-data\-type operators can be loose in an operator family containing operator classes for both data types\&.)
.PP
The new operator family is initially empty\&. It should be populated by issuing subsequent
\fBCREATE OPERATOR CLASS\fR
commands to add contained operator classes, and optionally
\fBALTER OPERATOR FAMILY\fR
commands to add
\(lqloose\(rq
operators and their corresponding support functions\&.
.PP
If a schema name is given then the operator family is created in the specified schema\&. Otherwise it is created in the current schema\&. Two operator families in the same schema can have the same name only if they are for different index methods\&.
.PP
The user who defines an operator family becomes its owner\&. Presently, the creating user must be a superuser\&. (This restriction is made because an erroneous operator family definition could confuse or even crash the server\&.)
.PP
Refer to
Section 36.14, \(lqInterfacing Extensions To Indexes\(rq, in the documentation
for further information\&.
.SH "PARAMETERS"
.PP
\fIname\fR
.RS 4
The name of the operator family to be created\&. The name can be schema\-qualified\&.
.RE
.PP
\fIindex_method\fR
.RS 4
The name of the index method this operator family is for\&.
.RE
.SH "COMPATIBILITY"
.PP
\fBCREATE OPERATOR FAMILY\fR
is a
PostgreSQL
extension\&. There is no
\fBCREATE OPERATOR FAMILY\fR
statement in the SQL standard\&.
.SH "SEE ALSO"
ALTER OPERATOR FAMILY (\fBALTER_OPERATOR_FAMILY\fR(7)), DROP OPERATOR FAMILY (\fBDROP_OPERATOR_FAMILY\fR(7)), CREATE OPERATOR CLASS (\fBCREATE_OPERATOR_CLASS\fR(7)), ALTER OPERATOR CLASS (\fBALTER_OPERATOR_CLASS\fR(7)), DROP OPERATOR CLASS (\fBDROP_OPERATOR_CLASS\fR(7))
man/man7/DROP_SEQUENCE.7 0000644 00000004736 14751153421 0010322 0 ustar 00 '\" t
.\" Title: DROP SEQUENCE
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "DROP SEQUENCE" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
DROP_SEQUENCE \- remove a sequence
.SH "SYNOPSIS"
.sp
.nf
DROP SEQUENCE [ IF EXISTS ] \fIname\fR [, \&.\&.\&.] [ CASCADE | RESTRICT ]
.fi
.SH "DESCRIPTION"
.PP
\fBDROP SEQUENCE\fR
removes sequence number generators\&. A sequence can only be dropped by its owner or a superuser\&.
.SH "PARAMETERS"
.PP
IF EXISTS
.RS 4
Do not throw an error if the sequence does not exist\&. A notice is issued in this case\&.
.RE
.PP
\fIname\fR
.RS 4
The name (optionally schema\-qualified) of a sequence\&.
.RE
.PP
CASCADE
.RS 4
Automatically drop objects that depend on the sequence, and in turn all objects that depend on those objects (see
Section 5.13, \(lqDependency Tracking\(rq, in the documentation)\&.
.RE
.PP
RESTRICT
.RS 4
Refuse to drop the sequence if any objects depend on it\&. This is the default\&.
.RE
.SH "EXAMPLES"
.PP
To remove the sequence
serial:
.sp
.if n \{\
.RS 4
.\}
.nf
DROP SEQUENCE serial;
.fi
.if n \{\
.RE
.\}
.SH "COMPATIBILITY"
.PP
\fBDROP SEQUENCE\fR
conforms to the
SQL
standard, except that the standard only allows one sequence to be dropped per command, and apart from the
IF EXISTS
option, which is a
PostgreSQL
extension\&.
.SH "SEE ALSO"
CREATE SEQUENCE (\fBCREATE_SEQUENCE\fR(7)), ALTER SEQUENCE (\fBALTER_SEQUENCE\fR(7))
man/man7/ALTER_COLLATION.7 0000644 00000005465 14751153421 0010541 0 ustar 00 '\" t
.\" Title: ALTER COLLATION
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "ALTER COLLATION" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
ALTER_COLLATION \- change the definition of a collation
.SH "SYNOPSIS"
.sp
.nf
ALTER COLLATION \fIname\fR RENAME TO \fInew_name\fR
ALTER COLLATION \fIname\fR OWNER TO { \fInew_owner\fR | CURRENT_USER | SESSION_USER }
ALTER COLLATION \fIname\fR SET SCHEMA \fInew_schema\fR
.fi
.SH "DESCRIPTION"
.PP
\fBALTER COLLATION\fR
changes the definition of a collation\&.
.PP
You must own the collation to use
\fBALTER COLLATION\fR\&. To alter the owner, you must also be a direct or indirect member of the new owning role, and that role must have
CREATE
privilege on the collation\*(Aqs schema\&. (These restrictions enforce that altering the owner doesn\*(Aqt do anything you couldn\*(Aqt do by dropping and recreating the collation\&. However, a superuser can alter ownership of any collation anyway\&.)
.SH "PARAMETERS"
.PP
\fIname\fR
.RS 4
The name (optionally schema\-qualified) of an existing collation\&.
.RE
.PP
\fInew_name\fR
.RS 4
The new name of the collation\&.
.RE
.PP
\fInew_owner\fR
.RS 4
The new owner of the collation\&.
.RE
.PP
\fInew_schema\fR
.RS 4
The new schema for the collation\&.
.RE
.SH "EXAMPLES"
.PP
To rename the collation
de_DE
to
german:
.sp
.if n \{\
.RS 4
.\}
.nf
ALTER COLLATION "de_DE" RENAME TO german;
.fi
.if n \{\
.RE
.\}
.PP
To change the owner of the collation
en_US
to
joe:
.sp
.if n \{\
.RS 4
.\}
.nf
ALTER COLLATION "en_US" OWNER TO joe;
.fi
.if n \{\
.RE
.\}
.SH "COMPATIBILITY"
.PP
There is no
\fBALTER COLLATION\fR
statement in the SQL standard\&.
.SH "SEE ALSO"
CREATE COLLATION (\fBCREATE_COLLATION\fR(7)), DROP COLLATION (\fBDROP_COLLATION\fR(7))
man/man7/DO.7 0000644 00000006123 14751153421 0006560 0 ustar 00 '\" t
.\" Title: DO
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "DO" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
DO \- execute an anonymous code block
.SH "SYNOPSIS"
.sp
.nf
DO [ LANGUAGE \fIlang_name\fR ] \fIcode\fR
.fi
.SH "DESCRIPTION"
.PP
\fBDO\fR
executes an anonymous code block, or in other words a transient anonymous function in a procedural language\&.
.PP
The code block is treated as though it were the body of a function with no parameters, returning
void\&. It is parsed and executed a single time\&.
.PP
The optional
LANGUAGE
clause can be written either before or after the code block\&.
.SH "PARAMETERS"
.PP
\fIcode\fR
.RS 4
The procedural language code to be executed\&. This must be specified as a string literal, just as in
\fBCREATE FUNCTION\fR\&. Use of a dollar\-quoted literal is recommended\&.
.RE
.PP
\fIlang_name\fR
.RS 4
The name of the procedural language the code is written in\&. If omitted, the default is
plpgsql\&.
.RE
.SH "NOTES"
.PP
The procedural language to be used must already have been installed into the current database by means of
\fBCREATE LANGUAGE\fR\&.
plpgsql
is installed by default, but other languages are not\&.
.PP
The user must have
USAGE
privilege for the procedural language, or must be a superuser if the language is untrusted\&. This is the same privilege requirement as for creating a function in the language\&.
.SH "EXAMPLES"
.PP
Grant all privileges on all views in schema
public
to role
webuser:
.sp
.if n \{\
.RS 4
.\}
.nf
DO $$DECLARE r record;
BEGIN
FOR r IN SELECT table_schema, table_name FROM information_schema\&.tables
WHERE table_type = \*(AqVIEW\*(Aq AND table_schema = \*(Aqpublic\*(Aq
LOOP
EXECUTE \*(AqGRANT ALL ON \*(Aq || quote_ident(r\&.table_schema) || \*(Aq\&.\*(Aq || quote_ident(r\&.table_name) || \*(Aq TO webuser\*(Aq;
END LOOP;
END$$;
.fi
.if n \{\
.RE
.\}
.SH "COMPATIBILITY"
.PP
There is no
\fBDO\fR
statement in the SQL standard\&.
.SH "SEE ALSO"
CREATE LANGUAGE (\fBCREATE_LANGUAGE\fR(7))
man/man7/CREATE_TABLESPACE.7 0000644 00000010746 14751153421 0010712 0 ustar 00 '\" t
.\" Title: CREATE TABLESPACE
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "CREATE TABLESPACE" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
CREATE_TABLESPACE \- define a new tablespace
.SH "SYNOPSIS"
.sp
.nf
CREATE TABLESPACE \fItablespace_name\fR
[ OWNER { \fInew_owner\fR | CURRENT_USER | SESSION_USER } ]
LOCATION \*(Aq\fIdirectory\fR\*(Aq
[ WITH ( \fItablespace_option\fR = \fIvalue\fR [, \&.\&.\&. ] ) ]
.fi
.SH "DESCRIPTION"
.PP
\fBCREATE TABLESPACE\fR
registers a new cluster\-wide tablespace\&. The tablespace name must be distinct from the name of any existing tablespace in the database cluster\&.
.PP
A tablespace allows superusers to define an alternative location on the file system where the data files containing database objects (such as tables and indexes) can reside\&.
.PP
A user with appropriate privileges can pass
\fItablespace_name\fR
to
\fBCREATE DATABASE\fR,
\fBCREATE TABLE\fR,
\fBCREATE INDEX\fR
or
\fBADD CONSTRAINT\fR
to have the data files for these objects stored within the specified tablespace\&.
.if n \{\
.sp
.\}
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBWarning\fR
.ps -1
.br
.PP
A tablespace cannot be used independently of the cluster in which it is defined; see
Section 22.6, \(lqTablespaces\(rq, in the documentation\&.
.sp .5v
.RE
.SH "PARAMETERS"
.PP
\fItablespace_name\fR
.RS 4
The name of a tablespace to be created\&. The name cannot begin with
pg_, as such names are reserved for system tablespaces\&.
.RE
.PP
\fIuser_name\fR
.RS 4
The name of the user who will own the tablespace\&. If omitted, defaults to the user executing the command\&. Only superusers can create tablespaces, but they can assign ownership of tablespaces to non\-superusers\&.
.RE
.PP
\fIdirectory\fR
.RS 4
The directory that will be used for the tablespace\&. The directory should be empty and must be owned by the
PostgreSQL
system user\&. The directory must be specified by an absolute path name\&.
.RE
.PP
\fItablespace_option\fR
.RS 4
A tablespace parameter to be set or reset\&. Currently, the only available parameters are
\fIseq_page_cost\fR,
\fIrandom_page_cost\fR
and
\fIeffective_io_concurrency\fR\&. Setting either value for a particular tablespace will override the planner\*(Aqs usual estimate of the cost of reading pages from tables in that tablespace, as established by the configuration parameters of the same name (see
seq_page_cost,
random_page_cost,
effective_io_concurrency)\&. This may be useful if one tablespace is located on a disk which is faster or slower than the remainder of the I/O subsystem\&.
.RE
.SH "NOTES"
.PP
Tablespaces are only supported on systems that support symbolic links\&.
.PP
\fBCREATE TABLESPACE\fR
cannot be executed inside a transaction block\&.
.SH "EXAMPLES"
.PP
Create a tablespace
dbspace
at
/data/dbs:
.sp
.if n \{\
.RS 4
.\}
.nf
CREATE TABLESPACE dbspace LOCATION \*(Aq/data/dbs\*(Aq;
.fi
.if n \{\
.RE
.\}
.PP
Create a tablespace
indexspace
at
/data/indexes
owned by user
genevieve:
.sp
.if n \{\
.RS 4
.\}
.nf
CREATE TABLESPACE indexspace OWNER genevieve LOCATION \*(Aq/data/indexes\*(Aq;
.fi
.if n \{\
.RE
.\}
.SH "COMPATIBILITY"
.PP
\fBCREATE TABLESPACE\fR
is a
PostgreSQL
extension\&.
.SH "SEE ALSO"
CREATE DATABASE (\fBCREATE_DATABASE\fR(7)), CREATE TABLE (\fBCREATE_TABLE\fR(7)), CREATE INDEX (\fBCREATE_INDEX\fR(7)), DROP TABLESPACE (\fBDROP_TABLESPACE\fR(7)), ALTER TABLESPACE (\fBALTER_TABLESPACE\fR(7))
man/man7/DROP_CONVERSION.7 0000644 00000004571 14751153421 0010574 0 ustar 00 '\" t
.\" Title: DROP CONVERSION
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "DROP CONVERSION" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
DROP_CONVERSION \- remove a conversion
.SH "SYNOPSIS"
.sp
.nf
DROP CONVERSION [ IF EXISTS ] \fIname\fR [ CASCADE | RESTRICT ]
.fi
.SH "DESCRIPTION"
.PP
\fBDROP CONVERSION\fR
removes a previously defined conversion\&. To be able to drop a conversion, you must own the conversion\&.
.SH "PARAMETERS"
.PP
IF EXISTS
.RS 4
Do not throw an error if the conversion does not exist\&. A notice is issued in this case\&.
.RE
.PP
\fIname\fR
.RS 4
The name of the conversion\&. The conversion name can be schema\-qualified\&.
.RE
.PP
CASCADE
.br
RESTRICT
.RS 4
These key words do not have any effect, since there are no dependencies on conversions\&.
.RE
.SH "EXAMPLES"
.PP
To drop the conversion named
myname:
.sp
.if n \{\
.RS 4
.\}
.nf
DROP CONVERSION myname;
.fi
.if n \{\
.RE
.\}
.SH "COMPATIBILITY"
.PP
There is no
\fBDROP CONVERSION\fR
statement in the SQL standard, but a
\fBDROP TRANSLATION\fR
statement that goes along with the
\fBCREATE TRANSLATION\fR
statement that is similar to the
\fBCREATE CONVERSION\fR
statement in PostgreSQL\&.
.SH "SEE ALSO"
ALTER CONVERSION (\fBALTER_CONVERSION\fR(7)), CREATE CONVERSION (\fBCREATE_CONVERSION\fR(7))
man/man7/UNLISTEN.7 0000644 00000005400 14751153421 0007514 0 ustar 00 '\" t
.\" Title: UNLISTEN
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "UNLISTEN" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
UNLISTEN \- stop listening for a notification
.SH "SYNOPSIS"
.sp
.nf
UNLISTEN { \fIchannel\fR | * }
.fi
.SH "DESCRIPTION"
.PP
\fBUNLISTEN\fR
is used to remove an existing registration for
\fBNOTIFY\fR
events\&.
\fBUNLISTEN\fR
cancels any existing registration of the current
PostgreSQL
session as a listener on the notification channel named
\fIchannel\fR\&. The special wildcard
*
cancels all listener registrations for the current session\&.
.PP
\fBNOTIFY\fR(7)
contains a more extensive discussion of the use of
\fBLISTEN\fR
and
\fBNOTIFY\fR\&.
.SH "PARAMETERS"
.PP
\fIchannel\fR
.RS 4
Name of a notification channel (any identifier)\&.
.RE
.PP
*
.RS 4
All current listen registrations for this session are cleared\&.
.RE
.SH "NOTES"
.PP
You can unlisten something you were not listening for; no warning or error will appear\&.
.PP
At the end of each session,
\fBUNLISTEN *\fR
is automatically executed\&.
.PP
A transaction that has executed
\fBUNLISTEN\fR
cannot be prepared for two\-phase commit\&.
.SH "EXAMPLES"
.PP
To make a registration:
.sp
.if n \{\
.RS 4
.\}
.nf
LISTEN virtual;
NOTIFY virtual;
Asynchronous notification "virtual" received from server process with PID 8448\&.
.fi
.if n \{\
.RE
.\}
.PP
Once
\fBUNLISTEN\fR
has been executed, further
\fBNOTIFY\fR
messages will be ignored:
.sp
.if n \{\
.RS 4
.\}
.nf
UNLISTEN virtual;
NOTIFY virtual;
\-\- no NOTIFY event is received
.fi
.if n \{\
.RE
.\}
.SH "COMPATIBILITY"
.PP
There is no
\fBUNLISTEN\fR
command in the SQL standard\&.
.SH "SEE ALSO"
\fBLISTEN\fR(7), \fBNOTIFY\fR(7)
man/man7/CREATE_USER.7 0000644 00000004715 14751153421 0010064 0 ustar 00 '\" t
.\" Title: CREATE USER
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "CREATE USER" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
CREATE_USER \- define a new database role
.SH "SYNOPSIS"
.sp
.nf
CREATE USER \fIname\fR [ [ WITH ] \fIoption\fR [ \&.\&.\&. ] ]
where \fIoption\fR can be:
SUPERUSER | NOSUPERUSER
| CREATEDB | NOCREATEDB
| CREATEROLE | NOCREATEROLE
| INHERIT | NOINHERIT
| LOGIN | NOLOGIN
| REPLICATION | NOREPLICATION
| BYPASSRLS | NOBYPASSRLS
| CONNECTION LIMIT \fIconnlimit\fR
| [ ENCRYPTED | UNENCRYPTED ] PASSWORD \*(Aq\fIpassword\fR\*(Aq
| VALID UNTIL \*(Aq\fItimestamp\fR\*(Aq
| IN ROLE \fIrole_name\fR [, \&.\&.\&.]
| IN GROUP \fIrole_name\fR [, \&.\&.\&.]
| ROLE \fIrole_name\fR [, \&.\&.\&.]
| ADMIN \fIrole_name\fR [, \&.\&.\&.]
| USER \fIrole_name\fR [, \&.\&.\&.]
| SYSID \fIuid\fR
.fi
.SH "DESCRIPTION"
.PP
\fBCREATE USER\fR
is now an alias for
CREATE ROLE (\fBCREATE_ROLE\fR(7))\&. The only difference is that when the command is spelled
\fBCREATE USER\fR,
LOGIN
is assumed by default, whereas
NOLOGIN
is assumed when the command is spelled
\fBCREATE ROLE\fR\&.
.SH "COMPATIBILITY"
.PP
The
\fBCREATE USER\fR
statement is a
PostgreSQL
extension\&. The SQL standard leaves the definition of users to the implementation\&.
.SH "SEE ALSO"
CREATE ROLE (\fBCREATE_ROLE\fR(7))
man/man7/CREATE_LANGUAGE.7 0000644 00000023521 14751153421 0010465 0 ustar 00 '\" t
.\" Title: CREATE LANGUAGE
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "CREATE LANGUAGE" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
CREATE_LANGUAGE \- define a new procedural language
.SH "SYNOPSIS"
.sp
.nf
CREATE [ OR REPLACE ] [ PROCEDURAL ] LANGUAGE \fIname\fR
CREATE [ OR REPLACE ] [ TRUSTED ] [ PROCEDURAL ] LANGUAGE \fIname\fR
HANDLER \fIcall_handler\fR [ INLINE \fIinline_handler\fR ] [ VALIDATOR \fIvalfunction\fR ]
.fi
.SH "DESCRIPTION"
.PP
\fBCREATE LANGUAGE\fR
registers a new procedural language with a
PostgreSQL
database\&. Subsequently, functions and trigger procedures can be defined in this new language\&.
.if n \{\
.sp
.\}
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBNote\fR
.ps -1
.br
.PP
As of
PostgreSQL
9\&.1, most procedural languages have been made into
\(lqextensions\(rq, and should therefore be installed with
CREATE EXTENSION (\fBCREATE_EXTENSION\fR(7))
not
\fBCREATE LANGUAGE\fR\&. Direct use of
\fBCREATE LANGUAGE\fR
should now be confined to extension installation scripts\&. If you have a
\(lqbare\(rq
language in your database, perhaps as a result of an upgrade, you can convert it to an extension using
CREATE EXTENSION \fIlangname\fR FROM unpackaged\&.
.sp .5v
.RE
.PP
\fBCREATE LANGUAGE\fR
effectively associates the language name with handler function(s) that are responsible for executing functions written in the language\&. Refer to
Chapter 54, Writing A Procedural Language Handler, in the documentation
for more information about language handlers\&.
.PP
There are two forms of the
\fBCREATE LANGUAGE\fR
command\&. In the first form, the user supplies just the name of the desired language, and the
PostgreSQL
server consults the
pg_pltemplate
system catalog to determine the correct parameters\&. In the second form, the user supplies the language parameters along with the language name\&. The second form can be used to create a language that is not defined in
pg_pltemplate, but this approach is considered obsolescent\&.
.PP
When the server finds an entry in the
pg_pltemplate
catalog for the given language name, it will use the catalog data even if the command includes language parameters\&. This behavior simplifies loading of old dump files, which are likely to contain out\-of\-date information about language support functions\&.
.PP
Ordinarily, the user must have the
PostgreSQL
superuser privilege to register a new language\&. However, the owner of a database can register a new language within that database if the language is listed in the
pg_pltemplate
catalog and is marked as allowed to be created by database owners (tmpldbacreate
is true)\&. The default is that trusted languages can be created by database owners, but this can be adjusted by superusers by modifying the contents of
pg_pltemplate\&. The creator of a language becomes its owner and can later drop it, rename it, or assign it to a new owner\&.
.PP
\fBCREATE OR REPLACE LANGUAGE\fR
will either create a new language, or replace an existing definition\&. If the language already exists, its parameters are updated according to the values specified or taken from
pg_pltemplate, but the language\*(Aqs ownership and permissions settings do not change, and any existing functions written in the language are assumed to still be valid\&. In addition to the normal privilege requirements for creating a language, the user must be superuser or owner of the existing language\&. The
REPLACE
case is mainly meant to be used to ensure that the language exists\&. If the language has a
pg_pltemplate
entry then
REPLACE
will not actually change anything about an existing definition, except in the unusual case where the
pg_pltemplate
entry has been modified since the language was created\&.
.SH "PARAMETERS"
.PP
TRUSTED
.RS 4
TRUSTED
specifies that the language does not grant access to data that the user would not otherwise have\&. If this key word is omitted when registering the language, only users with the
PostgreSQL
superuser privilege can use this language to create new functions\&.
.RE
.PP
PROCEDURAL
.RS 4
This is a noise word\&.
.RE
.PP
\fIname\fR
.RS 4
The name of the new procedural language\&. The name must be unique among the languages in the database\&.
.sp
For backward compatibility, the name can be enclosed by single quotes\&.
.RE
.PP
HANDLER \fIcall_handler\fR
.RS 4
\fIcall_handler\fR
is the name of a previously registered function that will be called to execute the procedural language\*(Aqs functions\&. The call handler for a procedural language must be written in a compiled language such as C with version 1 call convention and registered with
PostgreSQL
as a function taking no arguments and returning the
language_handler
type, a placeholder type that is simply used to identify the function as a call handler\&.
.RE
.PP
INLINE \fIinline_handler\fR
.RS 4
\fIinline_handler\fR
is the name of a previously registered function that will be called to execute an anonymous code block (\fBDO\fR(7)
command) in this language\&. If no
\fIinline_handler\fR
function is specified, the language does not support anonymous code blocks\&. The handler function must take one argument of type
internal, which will be the
\fBDO\fR
command\*(Aqs internal representation, and it will typically return
void\&. The return value of the handler is ignored\&.
.RE
.PP
VALIDATOR \fIvalfunction\fR
.RS 4
\fIvalfunction\fR
is the name of a previously registered function that will be called when a new function in the language is created, to validate the new function\&. If no validator function is specified, then a new function will not be checked when it is created\&. The validator function must take one argument of type
oid, which will be the OID of the to\-be\-created function, and will typically return
void\&.
.sp
A validator function would typically inspect the function body for syntactical correctness, but it can also look at other properties of the function, for example if the language cannot handle certain argument types\&. To signal an error, the validator function should use the
\fBereport()\fR
function\&. The return value of the function is ignored\&.
.RE
.PP
The
TRUSTED
option and the support function name(s) are ignored if the server has an entry for the specified language name in
pg_pltemplate\&.
.SH "NOTES"
.PP
The
\fBcreatelang\fR(1)
program is a simple wrapper around the
\fBCREATE LANGUAGE\fR
command\&. It eases installation of procedural languages from the shell command line\&.
.PP
Use
DROP LANGUAGE (\fBDROP_LANGUAGE\fR(7)), or better yet the
\fBdroplang\fR(1)
program, to drop procedural languages\&.
.PP
The system catalog
pg_language
(see
Section 50.29, \(lqpg_language\(rq, in the documentation) records information about the currently installed languages\&. Also,
\fBcreatelang\fR
has an option to list the installed languages\&.
.PP
To create functions in a procedural language, a user must have the
USAGE
privilege for the language\&. By default,
USAGE
is granted to
PUBLIC
(i\&.e\&., everyone) for trusted languages\&. This can be revoked if desired\&.
.PP
Procedural languages are local to individual databases\&. However, a language can be installed into the
template1
database, which will cause it to be available automatically in all subsequently\-created databases\&.
.PP
The call handler function, the inline handler function (if any), and the validator function (if any) must already exist if the server does not have an entry for the language in
pg_pltemplate\&. But when there is an entry, the functions need not already exist; they will be automatically defined if not present in the database\&. (This might result in
\fBCREATE LANGUAGE\fR
failing, if the shared library that implements the language is not available in the installation\&.)
.PP
In
PostgreSQL
versions before 7\&.3, it was necessary to declare handler functions as returning the placeholder type
opaque, rather than
language_handler\&. To support loading of old dump files,
\fBCREATE LANGUAGE\fR
will accept a function declared as returning
opaque, but it will issue a notice and change the function\*(Aqs declared return type to
language_handler\&.
.SH "EXAMPLES"
.PP
The preferred way of creating any of the standard procedural languages is just:
.sp
.if n \{\
.RS 4
.\}
.nf
CREATE LANGUAGE plperl;
.fi
.if n \{\
.RE
.\}
.PP
For a language not known in the
pg_pltemplate
catalog, a sequence such as this is needed:
.sp
.if n \{\
.RS 4
.\}
.nf
CREATE FUNCTION plsample_call_handler() RETURNS language_handler
AS \*(Aq$libdir/plsample\*(Aq
LANGUAGE C;
CREATE LANGUAGE plsample
HANDLER plsample_call_handler;
.fi
.if n \{\
.RE
.\}
.SH "COMPATIBILITY"
.PP
\fBCREATE LANGUAGE\fR
is a
PostgreSQL
extension\&.
.SH "SEE ALSO"
ALTER LANGUAGE (\fBALTER_LANGUAGE\fR(7)), CREATE FUNCTION (\fBCREATE_FUNCTION\fR(7)), DROP LANGUAGE (\fBDROP_LANGUAGE\fR(7)), \fBGRANT\fR(7), \fBREVOKE\fR(7), \fBcreatelang\fR(1), \fBdroplang\fR(1)
man/man7/DROP_MATERIALIZED_VIEW.7 0000644 00000005223 14751153421 0011606 0 ustar 00 '\" t
.\" Title: DROP MATERIALIZED VIEW
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "DROP MATERIALIZED VIEW" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
DROP_MATERIALIZED_VIEW \- remove a materialized view
.SH "SYNOPSIS"
.sp
.nf
DROP MATERIALIZED VIEW [ IF EXISTS ] \fIname\fR [, \&.\&.\&.] [ CASCADE | RESTRICT ]
.fi
.SH "DESCRIPTION"
.PP
\fBDROP MATERIALIZED VIEW\fR
drops an existing materialized view\&. To execute this command you must be the owner of the materialized view\&.
.SH "PARAMETERS"
.PP
IF EXISTS
.RS 4
Do not throw an error if the materialized view does not exist\&. A notice is issued in this case\&.
.RE
.PP
\fIname\fR
.RS 4
The name (optionally schema\-qualified) of the materialized view to remove\&.
.RE
.PP
CASCADE
.RS 4
Automatically drop objects that depend on the materialized view (such as other materialized views, or regular views), and in turn all objects that depend on those objects (see
Section 5.13, \(lqDependency Tracking\(rq, in the documentation)\&.
.RE
.PP
RESTRICT
.RS 4
Refuse to drop the materialized view if any objects depend on it\&. This is the default\&.
.RE
.SH "EXAMPLES"
.PP
This command will remove the materialized view called
order_summary:
.sp
.if n \{\
.RS 4
.\}
.nf
DROP MATERIALIZED VIEW order_summary;
.fi
.if n \{\
.RE
.\}
.SH "COMPATIBILITY"
.PP
\fBDROP MATERIALIZED VIEW\fR
is a
PostgreSQL
extension\&.
.SH "SEE ALSO"
CREATE MATERIALIZED VIEW (\fBCREATE_MATERIALIZED_VIEW\fR(7)), ALTER MATERIALIZED VIEW (\fBALTER_MATERIALIZED_VIEW\fR(7)), REFRESH MATERIALIZED VIEW (\fBREFRESH_MATERIALIZED_VIEW\fR(7))
man/man7/ALTER_DATABASE.7 0000644 00000013331 14751153421 0010350 0 ustar 00 '\" t
.\" Title: ALTER DATABASE
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "ALTER DATABASE" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
ALTER_DATABASE \- change a database
.SH "SYNOPSIS"
.sp
.nf
ALTER DATABASE \fIname\fR [ [ WITH ] \fIoption\fR [ \&.\&.\&. ] ]
where \fIoption\fR can be:
ALLOW_CONNECTIONS \fIallowconn\fR
CONNECTION LIMIT \fIconnlimit\fR
IS_TEMPLATE \fIistemplate\fR
ALTER DATABASE \fIname\fR RENAME TO \fInew_name\fR
ALTER DATABASE \fIname\fR OWNER TO { \fInew_owner\fR | CURRENT_USER | SESSION_USER }
ALTER DATABASE \fIname\fR SET TABLESPACE \fInew_tablespace\fR
ALTER DATABASE \fIname\fR SET \fIconfiguration_parameter\fR { TO | = } { \fIvalue\fR | DEFAULT }
ALTER DATABASE \fIname\fR SET \fIconfiguration_parameter\fR FROM CURRENT
ALTER DATABASE \fIname\fR RESET \fIconfiguration_parameter\fR
ALTER DATABASE \fIname\fR RESET ALL
.fi
.SH "DESCRIPTION"
.PP
\fBALTER DATABASE\fR
changes the attributes of a database\&.
.PP
The first form changes certain per\-database settings\&. (See below for details\&.) Only the database owner or a superuser can change these settings\&.
.PP
The second form changes the name of the database\&. Only the database owner or a superuser can rename a database; non\-superuser owners must also have the
CREATEDB
privilege\&. The current database cannot be renamed\&. (Connect to a different database if you need to do that\&.)
.PP
The third form changes the owner of the database\&. To alter the owner, you must own the database and also be a direct or indirect member of the new owning role, and you must have the
CREATEDB
privilege\&. (Note that superusers have all these privileges automatically\&.)
.PP
The fourth form changes the default tablespace of the database\&. Only the database owner or a superuser can do this; you must also have create privilege for the new tablespace\&. This command physically moves any tables or indexes in the database\*(Aqs old default tablespace to the new tablespace\&. The new default tablespace must be empty for this database, and no one can be connected to the database\&. Tables and indexes in non\-default tablespaces are unaffected\&.
.PP
The remaining forms change the session default for a run\-time configuration variable for a
PostgreSQL
database\&. Whenever a new session is subsequently started in that database, the specified value becomes the session default value\&. The database\-specific default overrides whatever setting is present in
postgresql\&.conf
or has been received from the
\fBpostgres\fR
command line\&. Only the database owner or a superuser can change the session defaults for a database\&. Certain variables cannot be set this way, or can only be set by a superuser\&.
.SH "PARAMETERS"
.PP
\fIname\fR
.RS 4
The name of the database whose attributes are to be altered\&.
.RE
.PP
\fIallowconn\fR
.RS 4
If false then no one can connect to this database\&.
.RE
.PP
\fIconnlimit\fR
.RS 4
How many concurrent connections can be made to this database\&. \-1 means no limit\&.
.RE
.PP
\fIistemplate\fR
.RS 4
If true, then this database can be cloned by any user with
CREATEDB
privileges; if false, then only superusers or the owner of the database can clone it\&.
.RE
.PP
\fInew_name\fR
.RS 4
The new name of the database\&.
.RE
.PP
\fInew_owner\fR
.RS 4
The new owner of the database\&.
.RE
.PP
\fInew_tablespace\fR
.RS 4
The new default tablespace of the database\&.
.RE
.PP
\fIconfiguration_parameter\fR
.br
\fIvalue\fR
.RS 4
Set this database\*(Aqs session default for the specified configuration parameter to the given value\&. If
\fIvalue\fR
is
DEFAULT
or, equivalently,
RESET
is used, the database\-specific setting is removed, so the system\-wide default setting will be inherited in new sessions\&. Use
RESET ALL
to clear all database\-specific settings\&.
SET FROM CURRENT
saves the session\*(Aqs current value of the parameter as the database\-specific value\&.
.sp
See
\fBSET\fR(7)
and
Chapter 19, Server Configuration, in the documentation
for more information about allowed parameter names and values\&.
.RE
.SH "NOTES"
.PP
It is also possible to tie a session default to a specific role rather than to a database; see
ALTER ROLE (\fBALTER_ROLE\fR(7))\&. Role\-specific settings override database\-specific ones if there is a conflict\&.
.SH "EXAMPLES"
.PP
To disable index scans by default in the database
test:
.sp
.if n \{\
.RS 4
.\}
.nf
ALTER DATABASE test SET enable_indexscan TO off;
.fi
.if n \{\
.RE
.\}
.SH "COMPATIBILITY"
.PP
The
\fBALTER DATABASE\fR
statement is a
PostgreSQL
extension\&.
.SH "SEE ALSO"
CREATE DATABASE (\fBCREATE_DATABASE\fR(7)), DROP DATABASE (\fBDROP_DATABASE\fR(7)), \fBSET\fR(7), CREATE TABLESPACE (\fBCREATE_TABLESPACE\fR(7))
man/man7/REASSIGN_OWNED.7 0000644 00000006153 14751153421 0010430 0 ustar 00 '\" t
.\" Title: REASSIGN OWNED
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "REASSIGN OWNED" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
REASSIGN_OWNED \- change the ownership of database objects owned by a database role
.SH "SYNOPSIS"
.sp
.nf
REASSIGN OWNED BY { \fIold_role\fR | CURRENT_USER | SESSION_USER } [, \&.\&.\&.]
TO { \fInew_role\fR | CURRENT_USER | SESSION_USER }
.fi
.SH "DESCRIPTION"
.PP
\fBREASSIGN OWNED\fR
instructs the system to change the ownership of database objects owned by any of the
\fIold_roles\fR
to
\fInew_role\fR\&.
.SH "PARAMETERS"
.PP
\fIold_role\fR
.RS 4
The name of a role\&. The ownership of all the objects within the current database, and of all shared objects (databases, tablespaces), owned by this role will be reassigned to
\fInew_role\fR\&.
.RE
.PP
\fInew_role\fR
.RS 4
The name of the role that will be made the new owner of the affected objects\&.
.RE
.SH "NOTES"
.PP
\fBREASSIGN OWNED\fR
is often used to prepare for the removal of one or more roles\&. Because
\fBREASSIGN OWNED\fR
does not affect objects within other databases, it is usually necessary to execute this command in each database that contains objects owned by a role that is to be removed\&.
.PP
\fBREASSIGN OWNED\fR
requires privileges on both the source role(s) and the target role\&.
.PP
The
DROP OWNED (\fBDROP_OWNED\fR(7))
command is an alternative that simply drops all the database objects owned by one or more roles\&.
.PP
The
\fBREASSIGN OWNED\fR
command does not affect any privileges granted to the
\fIold_roles\fR
on objects that are not owned by them\&. Likewise, it does not affect default privileges created with
\fBALTER DEFAULT PRIVILEGES\fR\&. Use
\fBDROP OWNED\fR
to revoke such privileges\&.
.PP
See
Section 21.4, \(lqDropping Roles\(rq, in the documentation
for more discussion\&.
.SH "COMPATIBILITY"
.PP
The
\fBREASSIGN OWNED\fR
command is a
PostgreSQL
extension\&.
.SH "SEE ALSO"
DROP OWNED (\fBDROP_OWNED\fR(7)), DROP ROLE (\fBDROP_ROLE\fR(7)), ALTER DATABASE (\fBALTER_DATABASE\fR(7))
man/man7/ALTER_VIEW.7 0000644 00000011260 14751153421 0007755 0 ustar 00 '\" t
.\" Title: ALTER VIEW
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "ALTER VIEW" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
ALTER_VIEW \- change the definition of a view
.SH "SYNOPSIS"
.sp
.nf
ALTER VIEW [ IF EXISTS ] \fIname\fR ALTER [ COLUMN ] \fIcolumn_name\fR SET DEFAULT \fIexpression\fR
ALTER VIEW [ IF EXISTS ] \fIname\fR ALTER [ COLUMN ] \fIcolumn_name\fR DROP DEFAULT
ALTER VIEW [ IF EXISTS ] \fIname\fR OWNER TO { \fInew_owner\fR | CURRENT_USER | SESSION_USER }
ALTER VIEW [ IF EXISTS ] \fIname\fR RENAME TO \fInew_name\fR
ALTER VIEW [ IF EXISTS ] \fIname\fR SET SCHEMA \fInew_schema\fR
ALTER VIEW [ IF EXISTS ] \fIname\fR SET ( \fIview_option_name\fR [= \fIview_option_value\fR] [, \&.\&.\&. ] )
ALTER VIEW [ IF EXISTS ] \fIname\fR RESET ( \fIview_option_name\fR [, \&.\&.\&. ] )
.fi
.SH "DESCRIPTION"
.PP
\fBALTER VIEW\fR
changes various auxiliary properties of a view\&. (If you want to modify the view\*(Aqs defining query, use
\fBCREATE OR REPLACE VIEW\fR\&.)
.PP
You must own the view to use
\fBALTER VIEW\fR\&. To change a view\*(Aqs schema, you must also have
CREATE
privilege on the new schema\&. To alter the owner, you must also be a direct or indirect member of the new owning role, and that role must have
CREATE
privilege on the view\*(Aqs schema\&. (These restrictions enforce that altering the owner doesn\*(Aqt do anything you couldn\*(Aqt do by dropping and recreating the view\&. However, a superuser can alter ownership of any view anyway\&.)
.SH "PARAMETERS"
.PP
\fIname\fR
.RS 4
The name (optionally schema\-qualified) of an existing view\&.
.RE
.PP
IF EXISTS
.RS 4
Do not throw an error if the view does not exist\&. A notice is issued in this case\&.
.RE
.PP
SET/DROP DEFAULT
.RS 4
These forms set or remove the default value for a column\&. A view column\*(Aqs default value is substituted into any
\fBINSERT\fR
or
\fBUPDATE\fR
command whose target is the view, before applying any rules or triggers for the view\&. The view\*(Aqs default will therefore take precedence over any default values from underlying relations\&.
.RE
.PP
\fInew_owner\fR
.RS 4
The user name of the new owner of the view\&.
.RE
.PP
\fInew_name\fR
.RS 4
The new name for the view\&.
.RE
.PP
\fInew_schema\fR
.RS 4
The new schema for the view\&.
.RE
.PP
SET ( \fIview_option_name\fR [= \fIview_option_value\fR] [, \&.\&.\&. ] )
.br
RESET ( \fIview_option_name\fR [, \&.\&.\&. ] )
.RS 4
Sets or resets a view option\&. Currently supported options are:
.PP
check_option (string)
.RS 4
Changes the check option of the view\&. The value must be
local
or
cascaded\&.
.RE
.PP
security_barrier (boolean)
.RS 4
Changes the security\-barrier property of the view\&. The value must be Boolean value, such as
true
or
false\&.
.RE
.sp
.RE
.SH "NOTES"
.PP
For historical reasons,
\fBALTER TABLE\fR
can be used with views too; but the only variants of
\fBALTER TABLE\fR
that are allowed with views are equivalent to the ones shown above\&.
.SH "EXAMPLES"
.PP
To rename the view
foo
to
bar:
.sp
.if n \{\
.RS 4
.\}
.nf
ALTER VIEW foo RENAME TO bar;
.fi
.if n \{\
.RE
.\}
.PP
To attach a default column value to an updatable view:
.sp
.if n \{\
.RS 4
.\}
.nf
CREATE TABLE base_table (id int, ts timestamptz);
CREATE VIEW a_view AS SELECT * FROM base_table;
ALTER VIEW a_view ALTER COLUMN ts SET DEFAULT now();
INSERT INTO base_table(id) VALUES(1); \-\- ts will receive a NULL
INSERT INTO a_view(id) VALUES(2); \-\- ts will receive the current time
.fi
.if n \{\
.RE
.\}
.SH "COMPATIBILITY"
.PP
\fBALTER VIEW\fR
is a
PostgreSQL
extension of the SQL standard\&.
.SH "SEE ALSO"
CREATE VIEW (\fBCREATE_VIEW\fR(7)), DROP VIEW (\fBDROP_VIEW\fR(7))
man/man7/CREATE_GROUP.7 0000644 00000004330 14751153421 0010173 0 ustar 00 '\" t
.\" Title: CREATE GROUP
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "CREATE GROUP" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
CREATE_GROUP \- define a new database role
.SH "SYNOPSIS"
.sp
.nf
CREATE GROUP \fIname\fR [ [ WITH ] \fIoption\fR [ \&.\&.\&. ] ]
where \fIoption\fR can be:
SUPERUSER | NOSUPERUSER
| CREATEDB | NOCREATEDB
| CREATEROLE | NOCREATEROLE
| INHERIT | NOINHERIT
| LOGIN | NOLOGIN
| REPLICATION | NOREPLICATION
| BYPASSRLS | NOBYPASSRLS
| CONNECTION LIMIT \fIconnlimit\fR
| [ ENCRYPTED | UNENCRYPTED ] PASSWORD \*(Aq\fIpassword\fR\*(Aq
| VALID UNTIL \*(Aq\fItimestamp\fR\*(Aq
| IN ROLE \fIrole_name\fR [, \&.\&.\&.]
| IN GROUP \fIrole_name\fR [, \&.\&.\&.]
| ROLE \fIrole_name\fR [, \&.\&.\&.]
| ADMIN \fIrole_name\fR [, \&.\&.\&.]
| USER \fIrole_name\fR [, \&.\&.\&.]
| SYSID \fIuid\fR
.fi
.SH "DESCRIPTION"
.PP
\fBCREATE GROUP\fR
is now an alias for
CREATE ROLE (\fBCREATE_ROLE\fR(7))\&.
.SH "COMPATIBILITY"
.PP
There is no
\fBCREATE GROUP\fR
statement in the SQL standard\&.
.SH "SEE ALSO"
CREATE ROLE (\fBCREATE_ROLE\fR(7))
man/man7/ALTER_EVENT_TRIGGER.7 0000644 00000004664 14751153421 0011261 0 ustar 00 '\" t
.\" Title: ALTER EVENT TRIGGER
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "ALTER EVENT TRIGGER" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
ALTER_EVENT_TRIGGER \- change the definition of an event trigger
.SH "SYNOPSIS"
.sp
.nf
ALTER EVENT TRIGGER \fIname\fR DISABLE
ALTER EVENT TRIGGER \fIname\fR ENABLE [ REPLICA | ALWAYS ]
ALTER EVENT TRIGGER \fIname\fR OWNER TO { \fInew_owner\fR | CURRENT_USER | SESSION_USER }
ALTER EVENT TRIGGER \fIname\fR RENAME TO \fInew_name\fR
.fi
.SH "DESCRIPTION"
.PP
\fBALTER EVENT TRIGGER\fR
changes properties of an existing event trigger\&.
.PP
You must be superuser to alter an event trigger\&.
.SH "PARAMETERS"
.PP
\fIname\fR
.RS 4
The name of an existing trigger to alter\&.
.RE
.PP
\fInew_owner\fR
.RS 4
The user name of the new owner of the event trigger\&.
.RE
.PP
\fInew_name\fR
.RS 4
The new name of the event trigger\&.
.RE
.PP
DISABLE/ENABLE [ REPLICA | ALWAYS ] TRIGGER
.RS 4
These forms configure the firing of event triggers\&. A disabled trigger is still known to the system, but is not executed when its triggering event occurs\&. See also
session_replication_role\&.
.RE
.SH "COMPATIBILITY"
.PP
There is no
\fBALTER EVENT TRIGGER\fR
statement in the SQL standard\&.
.SH "SEE ALSO"
CREATE EVENT TRIGGER (\fBCREATE_EVENT_TRIGGER\fR(7)), DROP EVENT TRIGGER (\fBDROP_EVENT_TRIGGER\fR(7))
man/man7/ALTER_TABLESPACE.7 0000644 00000006546 14751153421 0010621 0 ustar 00 '\" t
.\" Title: ALTER TABLESPACE
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "ALTER TABLESPACE" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
ALTER_TABLESPACE \- change the definition of a tablespace
.SH "SYNOPSIS"
.sp
.nf
ALTER TABLESPACE \fIname\fR RENAME TO \fInew_name\fR
ALTER TABLESPACE \fIname\fR OWNER TO { \fInew_owner\fR | CURRENT_USER | SESSION_USER }
ALTER TABLESPACE \fIname\fR SET ( \fItablespace_option\fR = \fIvalue\fR [, \&.\&.\&. ] )
ALTER TABLESPACE \fIname\fR RESET ( \fItablespace_option\fR [, \&.\&.\&. ] )
.fi
.SH "DESCRIPTION"
.PP
\fBALTER TABLESPACE\fR
can be used to change the definition of a tablespace\&.
.PP
You must own the tablespace to change the definition of a tablespace\&. To alter the owner, you must also be a direct or indirect member of the new owning role\&. (Note that superusers have these privileges automatically\&.)
.SH "PARAMETERS"
.PP
\fIname\fR
.RS 4
The name of an existing tablespace\&.
.RE
.PP
\fInew_name\fR
.RS 4
The new name of the tablespace\&. The new name cannot begin with
pg_, as such names are reserved for system tablespaces\&.
.RE
.PP
\fInew_owner\fR
.RS 4
The new owner of the tablespace\&.
.RE
.PP
\fItablespace_option\fR
.RS 4
A tablespace parameter to be set or reset\&. Currently, the only available parameters are
\fIseq_page_cost\fR,
\fIrandom_page_cost\fR
and
\fIeffective_io_concurrency\fR\&. Setting either value for a particular tablespace will override the planner\*(Aqs usual estimate of the cost of reading pages from tables in that tablespace, as established by the configuration parameters of the same name (see
seq_page_cost,
random_page_cost,
effective_io_concurrency)\&. This may be useful if one tablespace is located on a disk which is faster or slower than the remainder of the I/O subsystem\&.
.RE
.SH "EXAMPLES"
.PP
Rename tablespace
index_space
to
fast_raid:
.sp
.if n \{\
.RS 4
.\}
.nf
ALTER TABLESPACE index_space RENAME TO fast_raid;
.fi
.if n \{\
.RE
.\}
.PP
Change the owner of tablespace
index_space:
.sp
.if n \{\
.RS 4
.\}
.nf
ALTER TABLESPACE index_space OWNER TO mary;
.fi
.if n \{\
.RE
.\}
.SH "COMPATIBILITY"
.PP
There is no
\fBALTER TABLESPACE\fR
statement in the SQL standard\&.
.SH "SEE ALSO"
CREATE TABLESPACE (\fBCREATE_TABLESPACE\fR(7)), DROP TABLESPACE (\fBDROP_TABLESPACE\fR(7))
man/man7/CREATE_ROLE.7 0000644 00000031566 14751153421 0010053 0 ustar 00 '\" t
.\" Title: CREATE ROLE
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "CREATE ROLE" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
CREATE_ROLE \- define a new database role
.SH "SYNOPSIS"
.sp
.nf
CREATE ROLE \fIname\fR [ [ WITH ] \fIoption\fR [ \&.\&.\&. ] ]
where \fIoption\fR can be:
SUPERUSER | NOSUPERUSER
| CREATEDB | NOCREATEDB
| CREATEROLE | NOCREATEROLE
| INHERIT | NOINHERIT
| LOGIN | NOLOGIN
| REPLICATION | NOREPLICATION
| BYPASSRLS | NOBYPASSRLS
| CONNECTION LIMIT \fIconnlimit\fR
| [ ENCRYPTED | UNENCRYPTED ] PASSWORD \*(Aq\fIpassword\fR\*(Aq
| VALID UNTIL \*(Aq\fItimestamp\fR\*(Aq
| IN ROLE \fIrole_name\fR [, \&.\&.\&.]
| IN GROUP \fIrole_name\fR [, \&.\&.\&.]
| ROLE \fIrole_name\fR [, \&.\&.\&.]
| ADMIN \fIrole_name\fR [, \&.\&.\&.]
| USER \fIrole_name\fR [, \&.\&.\&.]
| SYSID \fIuid\fR
.fi
.SH "DESCRIPTION"
.PP
\fBCREATE ROLE\fR
adds a new role to a
PostgreSQL
database cluster\&. A role is an entity that can own database objects and have database privileges; a role can be considered a
\(lquser\(rq, a
\(lqgroup\(rq, or both depending on how it is used\&. Refer to
Chapter 21, Database Roles, in the documentation
and
Chapter 20, Client Authentication, in the documentation
for information about managing users and authentication\&. You must have
CREATEROLE
privilege or be a database superuser to use this command\&.
.PP
Note that roles are defined at the database cluster level, and so are valid in all databases in the cluster\&.
.SH "PARAMETERS"
.PP
\fIname\fR
.RS 4
The name of the new role\&.
.RE
.PP
SUPERUSER
.br
NOSUPERUSER
.RS 4
These clauses determine whether the new role is a
\(lqsuperuser\(rq, who can override all access restrictions within the database\&. Superuser status is dangerous and should be used only when really needed\&. You must yourself be a superuser to create a new superuser\&. If not specified,
NOSUPERUSER
is the default\&.
.RE
.PP
CREATEDB
.br
NOCREATEDB
.RS 4
These clauses define a role\*(Aqs ability to create databases\&. If
CREATEDB
is specified, the role being defined will be allowed to create new databases\&. Specifying
NOCREATEDB
will deny a role the ability to create databases\&. If not specified,
NOCREATEDB
is the default\&.
.RE
.PP
CREATEROLE
.br
NOCREATEROLE
.RS 4
These clauses determine whether a role will be permitted to create new roles (that is, execute
\fBCREATE ROLE\fR)\&. A role with
CREATEROLE
privilege can also alter and drop other roles\&. If not specified,
NOCREATEROLE
is the default\&.
.RE
.PP
INHERIT
.br
NOINHERIT
.RS 4
These clauses determine whether a role
\(lqinherits\(rq
the privileges of roles it is a member of\&. A role with the
INHERIT
attribute can automatically use whatever database privileges have been granted to all roles it is directly or indirectly a member of\&. Without
INHERIT, membership in another role only grants the ability to
\fBSET ROLE\fR
to that other role; the privileges of the other role are only available after having done so\&. If not specified,
INHERIT
is the default\&.
.RE
.PP
LOGIN
.br
NOLOGIN
.RS 4
These clauses determine whether a role is allowed to log in; that is, whether the role can be given as the initial session authorization name during client connection\&. A role having the
LOGIN
attribute can be thought of as a user\&. Roles without this attribute are useful for managing database privileges, but are not users in the usual sense of the word\&. If not specified,
NOLOGIN
is the default, except when
\fBCREATE ROLE\fR
is invoked through its alternative spelling
CREATE USER (\fBCREATE_USER\fR(7))\&.
.RE
.PP
REPLICATION
.br
NOREPLICATION
.RS 4
These clauses determine whether a role is a replication role\&. A role must have this attribute (or be a superuser) in order to be able to connect to the server in replication mode (physical or logical replication) and in order to be able to create or drop replication slots\&. A role having the
REPLICATION
attribute is a very highly privileged role, and should only be used on roles actually used for replication\&. If not specified,
NOREPLICATION
is the default\&. You must be a superuser to create a new role having the
REPLICATION
attribute\&.
.RE
.PP
BYPASSRLS
.br
NOBYPASSRLS
.RS 4
These clauses determine whether a role bypasses every row\-level security (RLS) policy\&.
NOBYPASSRLS
is the default\&. You must be a superuser to create a new role having the
BYPASSRLS
attribute\&.
.sp
Note that pg_dump will set
row_security
to
OFF
by default, to ensure all contents of a table are dumped out\&. If the user running pg_dump does not have appropriate permissions, an error will be returned\&. However, superusers and the owner of the table being dumped always bypass RLS\&.
.RE
.PP
CONNECTION LIMIT \fIconnlimit\fR
.RS 4
If role can log in, this specifies how many concurrent connections the role can make\&. \-1 (the default) means no limit\&. Note that only normal connections are counted towards this limit\&. Neither prepared transactions nor background worker connections are counted towards this limit\&.
.RE
.PP
PASSWORD \fIpassword\fR
.RS 4
Sets the role\*(Aqs password\&. (A password is only of use for roles having the
LOGIN
attribute, but you can nonetheless define one for roles without it\&.) If you do not plan to use password authentication you can omit this option\&. If no password is specified, the password will be set to null and password authentication will always fail for that user\&. A null password can optionally be written explicitly as
PASSWORD NULL\&.
.RE
.PP
ENCRYPTED
.br
UNENCRYPTED
.RS 4
These key words control whether the password is stored encrypted in the system catalogs\&. (If neither is specified, the default behavior is determined by the configuration parameter
password_encryption\&.) If the presented password string is already in MD5\-encrypted format, then it is stored encrypted as\-is, regardless of whether
ENCRYPTED
or
UNENCRYPTED
is specified (since the system cannot decrypt the specified encrypted password string)\&. This allows reloading of encrypted passwords during dump/restore\&.
.RE
.PP
VALID UNTIL \*(Aq\fItimestamp\fR\*(Aq
.RS 4
The
VALID UNTIL
clause sets a date and time after which the role\*(Aqs password is no longer valid\&. If this clause is omitted the password will be valid for all time\&.
.RE
.PP
IN ROLE \fIrole_name\fR
.RS 4
The
IN ROLE
clause lists one or more existing roles to which the new role will be immediately added as a new member\&. (Note that there is no option to add the new role as an administrator; use a separate
\fBGRANT\fR
command to do that\&.)
.RE
.PP
IN GROUP \fIrole_name\fR
.RS 4
IN GROUP
is an obsolete spelling of
IN ROLE\&.
.RE
.PP
ROLE \fIrole_name\fR
.RS 4
The
ROLE
clause lists one or more existing roles which are automatically added as members of the new role\&. (This in effect makes the new role a
\(lqgroup\(rq\&.)
.RE
.PP
ADMIN \fIrole_name\fR
.RS 4
The
ADMIN
clause is like
ROLE, but the named roles are added to the new role
WITH ADMIN OPTION, giving them the right to grant membership in this role to others\&.
.RE
.PP
USER \fIrole_name\fR
.RS 4
The
USER
clause is an obsolete spelling of the
ROLE
clause\&.
.RE
.PP
SYSID \fIuid\fR
.RS 4
The
SYSID
clause is ignored, but is accepted for backwards compatibility\&.
.RE
.SH "NOTES"
.PP
Use
ALTER ROLE (\fBALTER_ROLE\fR(7))
to change the attributes of a role, and
DROP ROLE (\fBDROP_ROLE\fR(7))
to remove a role\&. All the attributes specified by
\fBCREATE ROLE\fR
can be modified by later
\fBALTER ROLE\fR
commands\&.
.PP
The preferred way to add and remove members of roles that are being used as groups is to use
\fBGRANT\fR(7)
and
\fBREVOKE\fR(7)\&.
.PP
The
VALID UNTIL
clause defines an expiration time for a password only, not for the role
per se\&. In particular, the expiration time is not enforced when logging in using a non\-password\-based authentication method\&.
.PP
The
INHERIT
attribute governs inheritance of grantable privileges (that is, access privileges for database objects and role memberships)\&. It does not apply to the special role attributes set by
\fBCREATE ROLE\fR
and
\fBALTER ROLE\fR\&. For example, being a member of a role with
CREATEDB
privilege does not immediately grant the ability to create databases, even if
INHERIT
is set; it would be necessary to become that role via
SET ROLE (\fBSET_ROLE\fR(7))
before creating a database\&.
.PP
The
INHERIT
attribute is the default for reasons of backwards compatibility: in prior releases of
PostgreSQL, users always had access to all privileges of groups they were members of\&. However,
NOINHERIT
provides a closer match to the semantics specified in the SQL standard\&.
.PP
Be careful with the
CREATEROLE
privilege\&. There is no concept of inheritance for the privileges of a
CREATEROLE\-role\&. That means that even if a role does not have a certain privilege but is allowed to create other roles, it can easily create another role with different privileges than its own (except for creating roles with superuser privileges)\&. For example, if the role
\(lquser\(rq
has the
CREATEROLE
privilege but not the
CREATEDB
privilege, nonetheless it can create a new role with the
CREATEDB
privilege\&. Therefore, regard roles that have the
CREATEROLE
privilege as almost\-superuser\-roles\&.
.PP
PostgreSQL
includes a program
\fBcreateuser\fR(1)
that has the same functionality as
\fBCREATE ROLE\fR
(in fact, it calls this command) but can be run from the command shell\&.
.PP
The
CONNECTION LIMIT
option is only enforced approximately; if two new sessions start at about the same time when just one connection
\(lqslot\(rq
remains for the role, it is possible that both will fail\&. Also, the limit is never enforced for superusers\&.
.PP
Caution must be exercised when specifying an unencrypted password with this command\&. The password will be transmitted to the server in cleartext, and it might also be logged in the client\*(Aqs command history or the server log\&. The command
\fBcreateuser\fR(1), however, transmits the password encrypted\&. Also,
\fBpsql\fR(1)
contains a command
\fB\epassword\fR
that can be used to safely change the password later\&.
.SH "EXAMPLES"
.PP
Create a role that can log in, but don\*(Aqt give it a password:
.sp
.if n \{\
.RS 4
.\}
.nf
CREATE ROLE jonathan LOGIN;
.fi
.if n \{\
.RE
.\}
.PP
Create a role with a password:
.sp
.if n \{\
.RS 4
.\}
.nf
CREATE USER davide WITH PASSWORD \*(Aqjw8s0F4\*(Aq;
.fi
.if n \{\
.RE
.\}
.sp
(\fBCREATE USER\fR
is the same as
\fBCREATE ROLE\fR
except that it implies
LOGIN\&.)
.PP
Create a role with a password that is valid until the end of 2004\&. After one second has ticked in 2005, the password is no longer valid\&.
.sp
.if n \{\
.RS 4
.\}
.nf
CREATE ROLE miriam WITH LOGIN PASSWORD \*(Aqjw8s0F4\*(Aq VALID UNTIL \*(Aq2005\-01\-01\*(Aq;
.fi
.if n \{\
.RE
.\}
.PP
Create a role that can create databases and manage roles:
.sp
.if n \{\
.RS 4
.\}
.nf
CREATE ROLE admin WITH CREATEDB CREATEROLE;
.fi
.if n \{\
.RE
.\}
.SH "COMPATIBILITY"
.PP
The
\fBCREATE ROLE\fR
statement is in the SQL standard, but the standard only requires the syntax
.sp
.if n \{\
.RS 4
.\}
.nf
CREATE ROLE \fIname\fR [ WITH ADMIN \fIrole_name\fR ]
.fi
.if n \{\
.RE
.\}
.sp
Multiple initial administrators, and all the other options of
\fBCREATE ROLE\fR, are
PostgreSQL
extensions\&.
.PP
The SQL standard defines the concepts of users and roles, but it regards them as distinct concepts and leaves all commands defining users to be specified by each database implementation\&. In
PostgreSQL
we have chosen to unify users and roles into a single kind of entity\&. Roles therefore have many more optional attributes than they do in the standard\&.
.PP
The behavior specified by the SQL standard is most closely approximated by giving users the
NOINHERIT
attribute, while roles are given the
INHERIT
attribute\&.
.SH "SEE ALSO"
SET ROLE (\fBSET_ROLE\fR(7)), ALTER ROLE (\fBALTER_ROLE\fR(7)), DROP ROLE (\fBDROP_ROLE\fR(7)), \fBGRANT\fR(7), \fBREVOKE\fR(7), \fBcreateuser\fR(1)
man/man7/VACUUM.7 0000644 00000017676 14751153421 0007275 0 ustar 00 '\" t
.\" Title: VACUUM
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "VACUUM" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
VACUUM \- garbage\-collect and optionally analyze a database
.SH "SYNOPSIS"
.sp
.nf
VACUUM [ ( { FULL | FREEZE | VERBOSE | ANALYZE | DISABLE_PAGE_SKIPPING } [, \&.\&.\&.] ) ] [ \fItable_name\fR [ (\fIcolumn_name\fR [, \&.\&.\&.] ) ] ]
VACUUM [ FULL ] [ FREEZE ] [ VERBOSE ] [ \fItable_name\fR ]
VACUUM [ FULL ] [ FREEZE ] [ VERBOSE ] ANALYZE [ \fItable_name\fR [ (\fIcolumn_name\fR [, \&.\&.\&.] ) ] ]
.fi
.SH "DESCRIPTION"
.PP
\fBVACUUM\fR
reclaims storage occupied by dead tuples\&. In normal
PostgreSQL
operation, tuples that are deleted or obsoleted by an update are not physically removed from their table; they remain present until a
\fBVACUUM\fR
is done\&. Therefore it\*(Aqs necessary to do
\fBVACUUM\fR
periodically, especially on frequently\-updated tables\&.
.PP
With no parameter,
\fBVACUUM\fR
processes every table in the current database that the current user has permission to vacuum\&. With a parameter,
\fBVACUUM\fR
processes only that table\&.
.PP
\fBVACUUM ANALYZE\fR
performs a
\fBVACUUM\fR
and then an
\fBANALYZE\fR
for each selected table\&. This is a handy combination form for routine maintenance scripts\&. See
\fBANALYZE\fR(7)
for more details about its processing\&.
.PP
Plain
\fBVACUUM\fR
(without
FULL) simply reclaims space and makes it available for re\-use\&. This form of the command can operate in parallel with normal reading and writing of the table, as an exclusive lock is not obtained\&. However, extra space is not returned to the operating system (in most cases); it\*(Aqs just kept available for re\-use within the same table\&.
\fBVACUUM FULL\fR
rewrites the entire contents of the table into a new disk file with no extra space, allowing unused space to be returned to the operating system\&. This form is much slower and requires an
ACCESS EXCLUSIVE
lock on each table while it is being processed\&.
.PP
When the option list is surrounded by parentheses, the options can be written in any order\&. Without parentheses, options must be specified in exactly the order shown above\&. The parenthesized syntax was added in
PostgreSQL
9\&.0; the unparenthesized syntax is deprecated\&.
.SH "PARAMETERS"
.PP
FULL
.RS 4
Selects
\(lqfull\(rq
vacuum, which can reclaim more space, but takes much longer and exclusively locks the table\&. This method also requires extra disk space, since it writes a new copy of the table and doesn\*(Aqt release the old copy until the operation is complete\&. Usually this should only be used when a significant amount of space needs to be reclaimed from within the table\&.
.RE
.PP
FREEZE
.RS 4
Selects aggressive
\(lqfreezing\(rq
of tuples\&. Specifying
FREEZE
is equivalent to performing
\fBVACUUM\fR
with the
vacuum_freeze_min_age
and
vacuum_freeze_table_age
parameters set to zero\&. Aggressive freezing is always performed when the table is rewritten, so this option is redundant when
FULL
is specified\&.
.RE
.PP
VERBOSE
.RS 4
Prints a detailed vacuum activity report for each table\&.
.RE
.PP
ANALYZE
.RS 4
Updates statistics used by the planner to determine the most efficient way to execute a query\&.
.RE
.PP
DISABLE_PAGE_SKIPPING
.RS 4
Normally,
\fBVACUUM\fR
will skip pages based on the
visibility map\&. Pages where all tuples are known to be frozen can always be skipped, and those where all tuples are known to be visible to all transactions may be skipped except when performing an aggressive vacuum\&. Furthermore, except when performing an aggressive vacuum, some pages may be skipped in order to avoid waiting for other sessions to finish using them\&. This option disables all page\-skipping behavior, and is intended to be used only the contents of the visibility map are thought to be suspect, which should happen only if there is a hardware or software issue causing database corruption\&.
.RE
.PP
\fItable_name\fR
.RS 4
The name (optionally schema\-qualified) of a specific table to vacuum\&. Defaults to all tables in the current database\&.
.RE
.PP
\fIcolumn_name\fR
.RS 4
The name of a specific column to analyze\&. Defaults to all columns\&. If a column list is specified,
ANALYZE
is implied\&.
.RE
.SH "OUTPUTS"
.PP
When
VERBOSE
is specified,
\fBVACUUM\fR
emits progress messages to indicate which table is currently being processed\&. Various statistics about the tables are printed as well\&.
.SH "NOTES"
.PP
To vacuum a table, one must ordinarily be the table\*(Aqs owner or a superuser\&. However, database owners are allowed to vacuum all tables in their databases, except shared catalogs\&. (The restriction for shared catalogs means that a true database\-wide
\fBVACUUM\fR
can only be performed by a superuser\&.)
\fBVACUUM\fR
will skip over any tables that the calling user does not have permission to vacuum\&.
.PP
\fBVACUUM\fR
cannot be executed inside a transaction block\&.
.PP
For tables with
GIN
indexes,
\fBVACUUM\fR
(in any form) also completes any pending index insertions, by moving pending index entries to the appropriate places in the main
GIN
index structure\&. See
Section 63.4.1, \(lqGIN Fast Update Technique\(rq, in the documentation
for details\&.
.PP
We recommend that active production databases be vacuumed frequently (at least nightly), in order to remove dead rows\&. After adding or deleting a large number of rows, it might be a good idea to issue a
\fBVACUUM ANALYZE\fR
command for the affected table\&. This will update the system catalogs with the results of all recent changes, and allow the
PostgreSQL
query planner to make better choices in planning queries\&.
.PP
The
\fBFULL\fR
option is not recommended for routine use, but might be useful in special cases\&. An example is when you have deleted or updated most of the rows in a table and would like the table to physically shrink to occupy less disk space and allow faster table scans\&.
\fBVACUUM FULL\fR
will usually shrink the table more than a plain
\fBVACUUM\fR
would\&.
.PP
\fBVACUUM\fR
causes a substantial increase in I/O traffic, which might cause poor performance for other active sessions\&. Therefore, it is sometimes advisable to use the cost\-based vacuum delay feature\&. See
Section 19.4.4, \(lqCost-based Vacuum Delay\(rq, in the documentation
for details\&.
.PP
PostgreSQL
includes an
\(lqautovacuum\(rq
facility which can automate routine vacuum maintenance\&. For more information about automatic and manual vacuuming, see
Section 24.1, \(lqRoutine Vacuuming\(rq, in the documentation\&.
.SH "EXAMPLES"
.PP
To clean a single table
onek, analyze it for the optimizer and print a detailed vacuum activity report:
.sp
.if n \{\
.RS 4
.\}
.nf
VACUUM (VERBOSE, ANALYZE) onek;
.fi
.if n \{\
.RE
.\}
.SH "COMPATIBILITY"
.PP
There is no
\fBVACUUM\fR
statement in the SQL standard\&.
.SH "SEE ALSO"
\fBvacuumdb\fR(1), Section 19.4.4, \(lqCost-based Vacuum Delay\(rq, in the documentation, Section 24.1.6, \(lqThe Autovacuum Daemon\(rq, in the documentation
man/man7/DROP_TEXT_SEARCH_DICTIONARY.7 0000644 00000005403 14751153421 0012440 0 ustar 00 '\" t
.\" Title: DROP TEXT SEARCH DICTIONARY
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "DROP TEXT SEARCH DICTIONARY" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
DROP_TEXT_SEARCH_DICTIONARY \- remove a text search dictionary
.SH "SYNOPSIS"
.sp
.nf
DROP TEXT SEARCH DICTIONARY [ IF EXISTS ] \fIname\fR [ CASCADE | RESTRICT ]
.fi
.SH "DESCRIPTION"
.PP
\fBDROP TEXT SEARCH DICTIONARY\fR
drops an existing text search dictionary\&. To execute this command you must be the owner of the dictionary\&.
.SH "PARAMETERS"
.PP
IF EXISTS
.RS 4
Do not throw an error if the text search dictionary does not exist\&. A notice is issued in this case\&.
.RE
.PP
\fIname\fR
.RS 4
The name (optionally schema\-qualified) of an existing text search dictionary\&.
.RE
.PP
CASCADE
.RS 4
Automatically drop objects that depend on the text search dictionary, and in turn all objects that depend on those objects (see
Section 5.13, \(lqDependency Tracking\(rq, in the documentation)\&.
.RE
.PP
RESTRICT
.RS 4
Refuse to drop the text search dictionary if any objects depend on it\&. This is the default\&.
.RE
.SH "EXAMPLES"
.PP
Remove the text search dictionary
english:
.sp
.if n \{\
.RS 4
.\}
.nf
DROP TEXT SEARCH DICTIONARY english;
.fi
.if n \{\
.RE
.\}
.sp
This command will not succeed if there are any existing text search configurations that use the dictionary\&. Add
CASCADE
to drop such configurations along with the dictionary\&.
.SH "COMPATIBILITY"
.PP
There is no
\fBDROP TEXT SEARCH DICTIONARY\fR
statement in the SQL standard\&.
.SH "SEE ALSO"
ALTER TEXT SEARCH DICTIONARY (\fBALTER_TEXT_SEARCH_DICTIONARY\fR(7)), CREATE TEXT SEARCH DICTIONARY (\fBCREATE_TEXT_SEARCH_DICTIONARY\fR(7))
man/man7/DROP_AGGREGATE.7 0000644 00000007473 14751153421 0010401 0 ustar 00 '\" t
.\" Title: DROP AGGREGATE
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "DROP AGGREGATE" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
DROP_AGGREGATE \- remove an aggregate function
.SH "SYNOPSIS"
.sp
.nf
DROP AGGREGATE [ IF EXISTS ] \fIname\fR ( \fIaggregate_signature\fR ) [ CASCADE | RESTRICT ]
where \fIaggregate_signature\fR is:
* |
[ \fIargmode\fR ] [ \fIargname\fR ] \fIargtype\fR [ , \&.\&.\&. ] |
[ [ \fIargmode\fR ] [ \fIargname\fR ] \fIargtype\fR [ , \&.\&.\&. ] ] ORDER BY [ \fIargmode\fR ] [ \fIargname\fR ] \fIargtype\fR [ , \&.\&.\&. ]
.fi
.SH "DESCRIPTION"
.PP
\fBDROP AGGREGATE\fR
removes an existing aggregate function\&. To execute this command the current user must be the owner of the aggregate function\&.
.SH "PARAMETERS"
.PP
IF EXISTS
.RS 4
Do not throw an error if the aggregate does not exist\&. A notice is issued in this case\&.
.RE
.PP
\fIname\fR
.RS 4
The name (optionally schema\-qualified) of an existing aggregate function\&.
.RE
.PP
\fIargmode\fR
.RS 4
The mode of an argument:
IN
or
VARIADIC\&. If omitted, the default is
IN\&.
.RE
.PP
\fIargname\fR
.RS 4
The name of an argument\&. Note that
\fBDROP AGGREGATE\fR
does not actually pay any attention to argument names, since only the argument data types are needed to determine the aggregate function\*(Aqs identity\&.
.RE
.PP
\fIargtype\fR
.RS 4
An input data type on which the aggregate function operates\&. To reference a zero\-argument aggregate function, write
*
in place of the list of argument specifications\&. To reference an ordered\-set aggregate function, write
ORDER BY
between the direct and aggregated argument specifications\&.
.RE
.PP
CASCADE
.RS 4
Automatically drop objects that depend on the aggregate function (such as views using it), and in turn all objects that depend on those objects (see
Section 5.13, \(lqDependency Tracking\(rq, in the documentation)\&.
.RE
.PP
RESTRICT
.RS 4
Refuse to drop the aggregate function if any objects depend on it\&. This is the default\&.
.RE
.SH "NOTES"
.PP
Alternative syntaxes for referencing ordered\-set aggregates are described under
ALTER AGGREGATE (\fBALTER_AGGREGATE\fR(7))\&.
.SH "EXAMPLES"
.PP
To remove the aggregate function
myavg
for type
integer:
.sp
.if n \{\
.RS 4
.\}
.nf
DROP AGGREGATE myavg(integer);
.fi
.if n \{\
.RE
.\}
.PP
To remove the hypothetical\-set aggregate function
myrank, which takes an arbitrary list of ordering columns and a matching list of direct arguments:
.sp
.if n \{\
.RS 4
.\}
.nf
DROP AGGREGATE myrank(VARIADIC "any" ORDER BY VARIADIC "any");
.fi
.if n \{\
.RE
.\}
.sp
.SH "COMPATIBILITY"
.PP
There is no
\fBDROP AGGREGATE\fR
statement in the SQL standard\&.
.SH "SEE ALSO"
ALTER AGGREGATE (\fBALTER_AGGREGATE\fR(7)), CREATE AGGREGATE (\fBCREATE_AGGREGATE\fR(7))
man/man7/BEGIN.7 0000644 00000010103 14751153421 0007073 0 ustar 00 '\" t
.\" Title: BEGIN
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "BEGIN" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
BEGIN \- start a transaction block
.SH "SYNOPSIS"
.sp
.nf
BEGIN [ WORK | TRANSACTION ] [ \fItransaction_mode\fR [, \&.\&.\&.] ]
where \fItransaction_mode\fR is one of:
ISOLATION LEVEL { SERIALIZABLE | REPEATABLE READ | READ COMMITTED | READ UNCOMMITTED }
READ WRITE | READ ONLY
[ NOT ] DEFERRABLE
.fi
.SH "DESCRIPTION"
.PP
\fBBEGIN\fR
initiates a transaction block, that is, all statements after a
\fBBEGIN\fR
command will be executed in a single transaction until an explicit
\fBCOMMIT\fR(7)
or
\fBROLLBACK\fR(7)
is given\&. By default (without
\fBBEGIN\fR),
PostgreSQL
executes transactions in
\(lqautocommit\(rq
mode, that is, each statement is executed in its own transaction and a commit is implicitly performed at the end of the statement (if execution was successful, otherwise a rollback is done)\&.
.PP
Statements are executed more quickly in a transaction block, because transaction start/commit requires significant CPU and disk activity\&. Execution of multiple statements inside a transaction is also useful to ensure consistency when making several related changes: other sessions will be unable to see the intermediate states wherein not all the related updates have been done\&.
.PP
If the isolation level, read/write mode, or deferrable mode is specified, the new transaction has those characteristics, as if
SET TRANSACTION (\fBSET_TRANSACTION\fR(7))
was executed\&.
.SH "PARAMETERS"
.PP
WORK
.br
TRANSACTION
.RS 4
Optional key words\&. They have no effect\&.
.RE
.PP
Refer to
SET TRANSACTION (\fBSET_TRANSACTION\fR(7))
for information on the meaning of the other parameters to this statement\&.
.SH "NOTES"
.PP
START TRANSACTION (\fBSTART_TRANSACTION\fR(7))
has the same functionality as
\fBBEGIN\fR\&.
.PP
Use
\fBCOMMIT\fR(7)
or
\fBROLLBACK\fR(7)
to terminate a transaction block\&.
.PP
Issuing
\fBBEGIN\fR
when already inside a transaction block will provoke a warning message\&. The state of the transaction is not affected\&. To nest transactions within a transaction block, use savepoints (see
\fBSAVEPOINT\fR(7))\&.
.PP
For reasons of backwards compatibility, the commas between successive
\fItransaction_modes\fR
can be omitted\&.
.SH "EXAMPLES"
.PP
To begin a transaction block:
.sp
.if n \{\
.RS 4
.\}
.nf
BEGIN;
.fi
.if n \{\
.RE
.\}
.SH "COMPATIBILITY"
.PP
\fBBEGIN\fR
is a
PostgreSQL
language extension\&. It is equivalent to the SQL\-standard command
START TRANSACTION (\fBSTART_TRANSACTION\fR(7)), whose reference page contains additional compatibility information\&.
.PP
The
DEFERRABLE
\fItransaction_mode\fR
is a
PostgreSQL
language extension\&.
.PP
Incidentally, the
BEGIN
key word is used for a different purpose in embedded SQL\&. You are advised to be careful about the transaction semantics when porting database applications\&.
.SH "SEE ALSO"
\fBCOMMIT\fR(7), \fBROLLBACK\fR(7), START TRANSACTION (\fBSTART_TRANSACTION\fR(7)), \fBSAVEPOINT\fR(7)
man/man7/CREATE_ACCESS_METHOD.7 0000644 00000005631 14751153421 0011305 0 ustar 00 '\" t
.\" Title: CREATE ACCESS METHOD
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "CREATE ACCESS METHOD" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
CREATE_ACCESS_METHOD \- define a new access method
.SH "SYNOPSIS"
.sp
.nf
CREATE ACCESS METHOD \fIname\fR
TYPE \fIaccess_method_type\fR
HANDLER \fIhandler_function\fR
.fi
.SH "DESCRIPTION"
.PP
\fBCREATE ACCESS METHOD\fR
creates a new access method\&.
.PP
The access method name must be unique within the database\&.
.PP
Only superusers can define new access methods\&.
.SH "PARAMETERS"
.PP
\fIname\fR
.RS 4
The name of the access method to be created\&.
.RE
.PP
\fIaccess_method_type\fR
.RS 4
This clause specifies the type of access method to define\&. Only
INDEX
is supported at present\&.
.RE
.PP
\fIhandler_function\fR
.RS 4
\fIhandler_function\fR
is the name (possibly schema\-qualified) of a previously registered function that represents the access method\&. The handler function must be declared to take a single argument of type
internal, and its return type depends on the type of access method; for
INDEX
access methods, it must be
index_am_handler\&. The C\-level API that the handler function must implement varies depending on the type of access method\&. The index access method API is described in
Chapter 59, Index Access Method Interface Definition, in the documentation\&.
.RE
.SH "EXAMPLES"
.PP
Create an index access method
heptree
with handler function
heptree_handler:
.sp
.if n \{\
.RS 4
.\}
.nf
CREATE ACCESS METHOD heptree TYPE INDEX HANDLER heptree_handler;
.fi
.if n \{\
.RE
.\}
.sp
.SH "COMPATIBILITY"
.PP
\fBCREATE ACCESS METHOD\fR
is a
PostgreSQL
extension\&.
.SH "SEE ALSO"
DROP ACCESS METHOD (\fBDROP_ACCESS_METHOD\fR(7)), CREATE OPERATOR CLASS (\fBCREATE_OPERATOR_CLASS\fR(7)), CREATE OPERATOR FAMILY (\fBCREATE_OPERATOR_FAMILY\fR(7))
man/man7/SET_CONSTRAINTS.7 0000644 00000010754 14751153421 0010605 0 ustar 00 '\" t
.\" Title: SET CONSTRAINTS
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "SET CONSTRAINTS" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
SET_CONSTRAINTS \- set constraint check timing for the current transaction
.SH "SYNOPSIS"
.sp
.nf
SET CONSTRAINTS { ALL | \fIname\fR [, \&.\&.\&.] } { DEFERRED | IMMEDIATE }
.fi
.SH "DESCRIPTION"
.PP
\fBSET CONSTRAINTS\fR
sets the behavior of constraint checking within the current transaction\&.
IMMEDIATE
constraints are checked at the end of each statement\&.
DEFERRED
constraints are not checked until transaction commit\&. Each constraint has its own
IMMEDIATE
or
DEFERRED
mode\&.
.PP
Upon creation, a constraint is given one of three characteristics:
DEFERRABLE INITIALLY DEFERRED,
DEFERRABLE INITIALLY IMMEDIATE, or
NOT DEFERRABLE\&. The third class is always
IMMEDIATE
and is not affected by the
\fBSET CONSTRAINTS\fR
command\&. The first two classes start every transaction in the indicated mode, but their behavior can be changed within a transaction by
\fBSET CONSTRAINTS\fR\&.
.PP
\fBSET CONSTRAINTS\fR
with a list of constraint names changes the mode of just those constraints (which must all be deferrable)\&. Each constraint name can be schema\-qualified\&. The current schema search path is used to find the first matching name if no schema name is specified\&.
\fBSET CONSTRAINTS ALL\fR
changes the mode of all deferrable constraints\&.
.PP
When
\fBSET CONSTRAINTS\fR
changes the mode of a constraint from
DEFERRED
to
IMMEDIATE, the new mode takes effect retroactively: any outstanding data modifications that would have been checked at the end of the transaction are instead checked during the execution of the
\fBSET CONSTRAINTS\fR
command\&. If any such constraint is violated, the
\fBSET CONSTRAINTS\fR
fails (and does not change the constraint mode)\&. Thus,
\fBSET CONSTRAINTS\fR
can be used to force checking of constraints to occur at a specific point in a transaction\&.
.PP
Currently, only
UNIQUE,
PRIMARY KEY,
REFERENCES
(foreign key), and
EXCLUDE
constraints are affected by this setting\&.
NOT NULL
and
CHECK
constraints are always checked immediately when a row is inserted or modified (\fInot\fR
at the end of the statement)\&. Uniqueness and exclusion constraints that have not been declared
DEFERRABLE
are also checked immediately\&.
.PP
The firing of triggers that are declared as
\(lqconstraint triggers\(rq
is also controlled by this setting \(em they fire at the same time that the associated constraint should be checked\&.
.SH "NOTES"
.PP
Because
PostgreSQL
does not require constraint names to be unique within a schema (but only per\-table), it is possible that there is more than one match for a specified constraint name\&. In this case
\fBSET CONSTRAINTS\fR
will act on all matches\&. For a non\-schema\-qualified name, once a match or matches have been found in some schema in the search path, schemas appearing later in the path are not searched\&.
.PP
This command only alters the behavior of constraints within the current transaction\&. Issuing this outside of a transaction block emits a warning and otherwise has no effect\&.
.SH "COMPATIBILITY"
.PP
This command complies with the behavior defined in the SQL standard, except for the limitation that, in
PostgreSQL, it does not apply to
NOT NULL
and
CHECK
constraints\&. Also,
PostgreSQL
checks non\-deferrable uniqueness constraints immediately, not at end of statement as the standard would suggest\&.
man/man7/ALTER_ROLE.7 0000644 00000022130 14751153421 0007742 0 ustar 00 '\" t
.\" Title: ALTER ROLE
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "ALTER ROLE" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
ALTER_ROLE \- change a database role
.SH "SYNOPSIS"
.sp
.nf
ALTER ROLE \fIrole_specification\fR [ WITH ] \fIoption\fR [ \&.\&.\&. ]
where \fIoption\fR can be:
SUPERUSER | NOSUPERUSER
| CREATEDB | NOCREATEDB
| CREATEROLE | NOCREATEROLE
| INHERIT | NOINHERIT
| LOGIN | NOLOGIN
| REPLICATION | NOREPLICATION
| BYPASSRLS | NOBYPASSRLS
| CONNECTION LIMIT \fIconnlimit\fR
| [ ENCRYPTED | UNENCRYPTED ] PASSWORD \*(Aq\fIpassword\fR\*(Aq
| VALID UNTIL \*(Aq\fItimestamp\fR\*(Aq
ALTER ROLE \fIname\fR RENAME TO \fInew_name\fR
ALTER ROLE { \fIrole_specification\fR | ALL } [ IN DATABASE \fIdatabase_name\fR ] SET \fIconfiguration_parameter\fR { TO | = } { \fIvalue\fR | DEFAULT }
ALTER ROLE { \fIrole_specification\fR | ALL } [ IN DATABASE \fIdatabase_name\fR ] SET \fIconfiguration_parameter\fR FROM CURRENT
ALTER ROLE { \fIrole_specification\fR | ALL } [ IN DATABASE \fIdatabase_name\fR ] RESET \fIconfiguration_parameter\fR
ALTER ROLE { \fIrole_specification\fR | ALL } [ IN DATABASE \fIdatabase_name\fR ] RESET ALL
where \fIrole_specification\fR can be:
\fIrole_name\fR
| CURRENT_USER
| SESSION_USER
.fi
.SH "DESCRIPTION"
.PP
\fBALTER ROLE\fR
changes the attributes of a
PostgreSQL
role\&.
.PP
The first variant of this command listed in the synopsis can change many of the role attributes that can be specified in
CREATE ROLE (\fBCREATE_ROLE\fR(7))\&. (All the possible attributes are covered, except that there are no options for adding or removing memberships; use
\fBGRANT\fR(7)
and
\fBREVOKE\fR(7)
for that\&.) Attributes not mentioned in the command retain their previous settings\&. Database superusers can change any of these settings for any role\&. Roles having
CREATEROLE
privilege can change any of these settings except
SUPERUSER,
REPLICATION, and
BYPASSRLS; but only for non\-superuser and non\-replication roles\&. Ordinary roles can only change their own password\&.
.PP
The second variant changes the name of the role\&. Database superusers can rename any role\&. Roles having
CREATEROLE
privilege can rename non\-superuser roles\&. The current session user cannot be renamed\&. (Connect as a different user if you need to do that\&.) Because
MD5\-encrypted passwords use the role name as cryptographic salt, renaming a role clears its password if the password is
MD5\-encrypted\&.
.PP
The remaining variants change a role\*(Aqs session default for a configuration variable, either for all databases or, when the
IN DATABASE
clause is specified, only for sessions in the named database\&. If
ALL
is specified instead of a role name, this changes the setting for all roles\&. Using
ALL
with
IN DATABASE
is effectively the same as using the command
ALTER DATABASE \&.\&.\&. SET \&.\&.\&.\&.
.PP
Whenever the role subsequently starts a new session, the specified value becomes the session default, overriding whatever setting is present in
postgresql\&.conf
or has been received from the
\fBpostgres\fR
command line\&. This only happens at login time; executing
SET ROLE (\fBSET_ROLE\fR(7))
or
SET SESSION AUTHORIZATION (\fBSET_SESSION_AUTHORIZATION\fR(7))
does not cause new configuration values to be set\&. Settings set for all databases are overridden by database\-specific settings attached to a role\&. Settings for specific databases or specific roles override settings for all roles\&.
.PP
Superusers can change anyone\*(Aqs session defaults\&. Roles having
CREATEROLE
privilege can change defaults for non\-superuser roles\&. Ordinary roles can only set defaults for themselves\&. Certain configuration variables cannot be set this way, or can only be set if a superuser issues the command\&. Only superusers can change a setting for all roles in all databases\&.
.SH "PARAMETERS"
.PP
\fIname\fR
.RS 4
The name of the role whose attributes are to be altered\&.
.RE
.PP
CURRENT_USER
.RS 4
Alter the current user instead of an explicitly identified role\&.
.RE
.PP
SESSION_USER
.RS 4
Alter the current session user instead of an explicitly identified role\&.
.RE
.PP
SUPERUSER
.br
NOSUPERUSER
.br
CREATEDB
.br
NOCREATEDB
.br
CREATEROLE
.br
NOCREATEROLE
.br
INHERIT
.br
NOINHERIT
.br
LOGIN
.br
NOLOGIN
.br
REPLICATION
.br
NOREPLICATION
.br
BYPASSRLS
.br
NOBYPASSRLS
.br
CONNECTION LIMIT \fIconnlimit\fR
.br
PASSWORD \fIpassword\fR
.br
ENCRYPTED
.br
UNENCRYPTED
.br
VALID UNTIL \*(Aq\fItimestamp\fR\*(Aq
.RS 4
These clauses alter attributes originally set by
CREATE ROLE (\fBCREATE_ROLE\fR(7))\&. For more information, see the
\fBCREATE ROLE\fR
reference page\&.
.RE
.PP
\fInew_name\fR
.RS 4
The new name of the role\&.
.RE
.PP
\fIdatabase_name\fR
.RS 4
The name of the database the configuration variable should be set in\&.
.RE
.PP
\fIconfiguration_parameter\fR
.br
\fIvalue\fR
.RS 4
Set this role\*(Aqs session default for the specified configuration parameter to the given value\&. If
\fIvalue\fR
is
DEFAULT
or, equivalently,
RESET
is used, the role\-specific variable setting is removed, so the role will inherit the system\-wide default setting in new sessions\&. Use
RESET ALL
to clear all role\-specific settings\&.
SET FROM CURRENT
saves the session\*(Aqs current value of the parameter as the role\-specific value\&. If
IN DATABASE
is specified, the configuration parameter is set or removed for the given role and database only\&.
.sp
Role\-specific variable settings take effect only at login;
SET ROLE (\fBSET_ROLE\fR(7))
and
SET SESSION AUTHORIZATION (\fBSET_SESSION_AUTHORIZATION\fR(7))
do not process role\-specific variable settings\&.
.sp
See
\fBSET\fR(7)
and
Chapter 19, Server Configuration, in the documentation
for more information about allowed parameter names and values\&.
.RE
.SH "NOTES"
.PP
Use
CREATE ROLE (\fBCREATE_ROLE\fR(7))
to add new roles, and
DROP ROLE (\fBDROP_ROLE\fR(7))
to remove a role\&.
.PP
\fBALTER ROLE\fR
cannot change a role\*(Aqs memberships\&. Use
\fBGRANT\fR(7)
and
\fBREVOKE\fR(7)
to do that\&.
.PP
Caution must be exercised when specifying an unencrypted password with this command\&. The password will be transmitted to the server in cleartext, and it might also be logged in the client\*(Aqs command history or the server log\&.
\fBpsql\fR(1)
contains a command
\fB\epassword\fR
that can be used to change a role\*(Aqs password without exposing the cleartext password\&.
.PP
It is also possible to tie a session default to a specific database rather than to a role; see
ALTER DATABASE (\fBALTER_DATABASE\fR(7))\&. If there is a conflict, database\-role\-specific settings override role\-specific ones, which in turn override database\-specific ones\&.
.SH "EXAMPLES"
.PP
Change a role\*(Aqs password:
.sp
.if n \{\
.RS 4
.\}
.nf
ALTER ROLE davide WITH PASSWORD \*(Aqhu8jmn3\*(Aq;
.fi
.if n \{\
.RE
.\}
.PP
Remove a role\*(Aqs password:
.sp
.if n \{\
.RS 4
.\}
.nf
ALTER ROLE davide WITH PASSWORD NULL;
.fi
.if n \{\
.RE
.\}
.PP
Change a password expiration date, specifying that the password should expire at midday on 4th May 2015 using the time zone which is one hour ahead of
UTC:
.sp
.if n \{\
.RS 4
.\}
.nf
ALTER ROLE chris VALID UNTIL \*(AqMay 4 12:00:00 2015 +1\*(Aq;
.fi
.if n \{\
.RE
.\}
.PP
Make a password valid forever:
.sp
.if n \{\
.RS 4
.\}
.nf
ALTER ROLE fred VALID UNTIL \*(Aqinfinity\*(Aq;
.fi
.if n \{\
.RE
.\}
.PP
Give a role the ability to create other roles and new databases:
.sp
.if n \{\
.RS 4
.\}
.nf
ALTER ROLE miriam CREATEROLE CREATEDB;
.fi
.if n \{\
.RE
.\}
.PP
Give a role a non\-default setting of the
maintenance_work_mem
parameter:
.sp
.if n \{\
.RS 4
.\}
.nf
ALTER ROLE worker_bee SET maintenance_work_mem = 100000;
.fi
.if n \{\
.RE
.\}
.PP
Give a role a non\-default, database\-specific setting of the
client_min_messages
parameter:
.sp
.if n \{\
.RS 4
.\}
.nf
ALTER ROLE fred IN DATABASE devel SET client_min_messages = DEBUG;
.fi
.if n \{\
.RE
.\}
.SH "COMPATIBILITY"
.PP
The
\fBALTER ROLE\fR
statement is a
PostgreSQL
extension\&.
.SH "SEE ALSO"
CREATE ROLE (\fBCREATE_ROLE\fR(7)), DROP ROLE (\fBDROP_ROLE\fR(7)), ALTER DATABASE (\fBALTER_DATABASE\fR(7)), \fBSET\fR(7)
man/man7/DROP_OWNED.7 0000644 00000006223 14751153421 0007757 0 ustar 00 '\" t
.\" Title: DROP OWNED
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "DROP OWNED" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
DROP_OWNED \- remove database objects owned by a database role
.SH "SYNOPSIS"
.sp
.nf
DROP OWNED BY { \fIname\fR | CURRENT_USER | SESSION_USER } [, \&.\&.\&.] [ CASCADE | RESTRICT ]
.fi
.SH "DESCRIPTION"
.PP
\fBDROP OWNED\fR
drops all the objects within the current database that are owned by one of the specified roles\&. Any privileges granted to the given roles on objects in the current database or on shared objects (databases, tablespaces) will also be revoked\&.
.SH "PARAMETERS"
.PP
\fIname\fR
.RS 4
The name of a role whose objects will be dropped, and whose privileges will be revoked\&.
.RE
.PP
CASCADE
.RS 4
Automatically drop objects that depend on the affected objects, and in turn all objects that depend on those objects (see
Section 5.13, \(lqDependency Tracking\(rq, in the documentation)\&.
.RE
.PP
RESTRICT
.RS 4
Refuse to drop the objects owned by a role if any other database objects depend on one of the affected objects\&. This is the default\&.
.RE
.SH "NOTES"
.PP
\fBDROP OWNED\fR
is often used to prepare for the removal of one or more roles\&. Because
\fBDROP OWNED\fR
only affects the objects in the current database, it is usually necessary to execute this command in each database that contains objects owned by a role that is to be removed\&.
.PP
Using the
CASCADE
option might make the command recurse to objects owned by other users\&.
.PP
The
REASSIGN OWNED (\fBREASSIGN_OWNED\fR(7))
command is an alternative that reassigns the ownership of all the database objects owned by one or more roles\&. However,
\fBREASSIGN OWNED\fR
does not deal with privileges for other objects\&.
.PP
Databases and tablespaces owned by the role(s) will not be removed\&.
.PP
See
Section 21.4, \(lqDropping Roles\(rq, in the documentation
for more discussion\&.
.SH "COMPATIBILITY"
.PP
The
\fBDROP OWNED\fR
command is a
PostgreSQL
extension\&.
.SH "SEE ALSO"
REASSIGN OWNED (\fBREASSIGN_OWNED\fR(7)), DROP ROLE (\fBDROP_ROLE\fR(7))
man/man7/CREATE_EXTENSION.7 0000644 00000020142 14751153421 0010652 0 ustar 00 '\" t
.\" Title: CREATE EXTENSION
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "CREATE EXTENSION" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
CREATE_EXTENSION \- install an extension
.SH "SYNOPSIS"
.sp
.nf
CREATE EXTENSION [ IF NOT EXISTS ] \fIextension_name\fR
[ WITH ] [ SCHEMA \fIschema_name\fR ]
[ VERSION \fIversion\fR ]
[ FROM \fIold_version\fR ]
[ CASCADE ]
.fi
.SH "DESCRIPTION"
.PP
\fBCREATE EXTENSION\fR
loads a new extension into the current database\&. There must not be an extension of the same name already loaded\&.
.PP
Loading an extension essentially amounts to running the extension\*(Aqs script file\&. The script will typically create new
SQL
objects such as functions, data types, operators and index support methods\&.
\fBCREATE EXTENSION\fR
additionally records the identities of all the created objects, so that they can be dropped again if
\fBDROP EXTENSION\fR
is issued\&.
.PP
Loading an extension requires the same privileges that would be required to create its component objects\&. For most extensions this means superuser or database owner privileges are needed\&. The user who runs
\fBCREATE EXTENSION\fR
becomes the owner of the extension for purposes of later privilege checks, as well as the owner of any objects created by the extension\*(Aqs script\&.
.SH "PARAMETERS"
.PP
IF NOT EXISTS
.RS 4
Do not throw an error if an extension with the same name already exists\&. A notice is issued in this case\&. Note that there is no guarantee that the existing extension is anything like the one that would have been created from the currently\-available script file\&.
.RE
.PP
\fIextension_name\fR
.RS 4
The name of the extension to be installed\&.
PostgreSQL
will create the extension using details from the file
SHAREDIR/extension/\fIextension_name\fR\&.control\&.
.RE
.PP
\fIschema_name\fR
.RS 4
The name of the schema in which to install the extension\*(Aqs objects, given that the extension allows its contents to be relocated\&. The named schema must already exist\&. If not specified, and the extension\*(Aqs control file does not specify a schema either, the current default object creation schema is used\&.
.sp
If the extension specifies a
schema
parameter in its control file, then that schema cannot be overridden with a
SCHEMA
clause\&. Normally, an error will be raised if a
SCHEMA
clause is given and it conflicts with the extension\*(Aqs
schema
parameter\&. However, if the
CASCADE
clause is also given, then
\fIschema_name\fR
is ignored when it conflicts\&. The given
\fIschema_name\fR
will be used for installation of any needed extensions that do not specify
schema
in their control files\&.
.sp
Remember that the extension itself is not considered to be within any schema: extensions have unqualified names that must be unique database\-wide\&. But objects belonging to the extension can be within schemas\&.
.RE
.PP
\fIversion\fR
.RS 4
The version of the extension to install\&. This can be written as either an identifier or a string literal\&. The default version is whatever is specified in the extension\*(Aqs control file\&.
.RE
.PP
\fIold_version\fR
.RS 4
FROM
\fIold_version\fR
must be specified when, and only when, you are attempting to install an extension that replaces an
\(lqold style\(rq
module that is just a collection of objects not packaged into an extension\&. This option causes
\fBCREATE EXTENSION\fR
to run an alternative installation script that absorbs the existing objects into the extension, instead of creating new objects\&. Be careful that
SCHEMA
specifies the schema containing these pre\-existing objects\&.
.sp
The value to use for
\fIold_version\fR
is determined by the extension\*(Aqs author, and might vary if there is more than one version of the old\-style module that can be upgraded into an extension\&. For the standard additional modules supplied with pre\-9\&.1
PostgreSQL, use
unpackaged
for
\fIold_version\fR
when updating a module to extension style\&.
.RE
.PP
CASCADE
.RS 4
Automatically install any extensions that this extension depends on that are not already installed\&. Their dependencies are likewise automatically installed, recursively\&. The
SCHEMA
clause, if given, applies to all extensions that get installed this way\&. Other options of the statement are not applied to automatically\-installed extensions; in particular, their default versions are always selected\&.
.RE
.SH "NOTES"
.PP
Before you can use
\fBCREATE EXTENSION\fR
to load an extension into a database, the extension\*(Aqs supporting files must be installed\&. Information about installing the extensions supplied with
PostgreSQL
can be found in
Additional Supplied Modules\&.
.PP
The extensions currently available for loading can be identified from the
pg_available_extensions
or
pg_available_extension_versions
system views\&.
.if n \{\
.sp
.\}
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBCaution\fR
.ps -1
.br
.PP
Installing an extension as superuser requires trusting that the extension\*(Aqs author wrote the extension installation script in a secure fashion\&. It is not terribly difficult for a malicious user to create trojan\-horse objects that will compromise later execution of a carelessly\-written extension script, allowing that user to acquire superuser privileges\&. However, trojan\-horse objects are only hazardous if they are in the
\fIsearch_path\fR
during script execution, meaning that they are in the extension\*(Aqs installation target schema or in the schema of some extension it depends on\&. Therefore, a good rule of thumb when dealing with extensions whose scripts have not been carefully vetted is to install them only into schemas for which CREATE privilege has not been and will not be granted to any untrusted users\&. Likewise for any extensions they depend on\&.
.PP
The extensions supplied with
PostgreSQL
are believed to be secure against installation\-time attacks of this sort, except for a few that depend on other extensions\&. As stated in the documentation for those extensions, they should be installed into secure schemas, or installed into the same schemas as the extensions they depend on, or both\&.
.sp .5v
.RE
.PP
For information about writing new extensions, see
Section 36.15, \(lqPackaging Related Objects into an Extension\(rq, in the documentation\&.
.SH "EXAMPLES"
.PP
Install the
hstore
extension into the current database, placing its objects in schema
addons:
.sp
.if n \{\
.RS 4
.\}
.nf
CREATE EXTENSION hstore SCHEMA addons;
.fi
.if n \{\
.RE
.\}
.sp
Another way to accomplish the same thing:
.sp
.if n \{\
.RS 4
.\}
.nf
SET search_path = addons;
CREATE EXTENSION hstore;
.fi
.if n \{\
.RE
.\}
.PP
Update a pre\-9\&.1 installation of
hstore
into extension style:
.sp
.if n \{\
.RS 4
.\}
.nf
CREATE EXTENSION hstore SCHEMA public FROM unpackaged;
.fi
.if n \{\
.RE
.\}
.sp
Be careful to specify the schema in which you installed the existing
hstore
objects\&.
.SH "COMPATIBILITY"
.PP
\fBCREATE EXTENSION\fR
is a
PostgreSQL
extension\&.
.SH "SEE ALSO"
ALTER EXTENSION (\fBALTER_EXTENSION\fR(7)), DROP EXTENSION (\fBDROP_EXTENSION\fR(7))
man/man7/ALTER_MATERIALIZED_VIEW.7 0000644 00000011253 14751153421 0011711 0 ustar 00 '\" t
.\" Title: ALTER MATERIALIZED VIEW
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "ALTER MATERIALIZED VIEW" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
ALTER_MATERIALIZED_VIEW \- change the definition of a materialized view
.SH "SYNOPSIS"
.sp
.nf
ALTER MATERIALIZED VIEW [ IF EXISTS ] \fIname\fR
\fIaction\fR [, \&.\&.\&. ]
ALTER MATERIALIZED VIEW \fIname\fR
DEPENDS ON EXTENSION \fIextension_name\fR
ALTER MATERIALIZED VIEW [ IF EXISTS ] \fIname\fR
RENAME [ COLUMN ] \fIcolumn_name\fR TO \fInew_column_name\fR
ALTER MATERIALIZED VIEW [ IF EXISTS ] \fIname\fR
RENAME TO \fInew_name\fR
ALTER MATERIALIZED VIEW [ IF EXISTS ] \fIname\fR
SET SCHEMA \fInew_schema\fR
ALTER MATERIALIZED VIEW ALL IN TABLESPACE \fIname\fR [ OWNED BY \fIrole_name\fR [, \&.\&.\&. ] ]
SET TABLESPACE \fInew_tablespace\fR [ NOWAIT ]
where \fIaction\fR is one of:
ALTER [ COLUMN ] \fIcolumn_name\fR SET STATISTICS \fIinteger\fR
ALTER [ COLUMN ] \fIcolumn_name\fR SET ( \fIattribute_option\fR = \fIvalue\fR [, \&.\&.\&. ] )
ALTER [ COLUMN ] \fIcolumn_name\fR RESET ( \fIattribute_option\fR [, \&.\&.\&. ] )
ALTER [ COLUMN ] \fIcolumn_name\fR SET STORAGE { PLAIN | EXTERNAL | EXTENDED | MAIN }
CLUSTER ON \fIindex_name\fR
SET WITHOUT CLUSTER
SET ( \fIstorage_parameter\fR [= \fIvalue\fR] [, \&.\&.\&. ] )
RESET ( \fIstorage_parameter\fR [, \&.\&.\&. ] )
OWNER TO { \fInew_owner\fR | CURRENT_USER | SESSION_USER }
.fi
.SH "DESCRIPTION"
.PP
\fBALTER MATERIALIZED VIEW\fR
changes various auxiliary properties of an existing materialized view\&.
.PP
You must own the materialized view to use
\fBALTER MATERIALIZED VIEW\fR\&. To change a materialized view\*(Aqs schema, you must also have
CREATE
privilege on the new schema\&. To alter the owner, you must also be a direct or indirect member of the new owning role, and that role must have
CREATE
privilege on the materialized view\*(Aqs schema\&. (These restrictions enforce that altering the owner doesn\*(Aqt do anything you couldn\*(Aqt do by dropping and recreating the materialized view\&. However, a superuser can alter ownership of any view anyway\&.)
.PP
The
DEPENDS ON EXTENSION
form marks the materialized view as dependent on an extension, such that the materialized view will automatically be dropped if the extension is dropped\&.
.PP
The statement subforms and actions available for
\fBALTER MATERIALIZED VIEW\fR
are a subset of those available for
\fBALTER TABLE\fR, and have the same meaning when used for materialized views\&. See the descriptions for
ALTER TABLE (\fBALTER_TABLE\fR(7))
for details\&.
.SH "PARAMETERS"
.PP
\fIname\fR
.RS 4
The name (optionally schema\-qualified) of an existing materialized view\&.
.RE
.PP
\fIcolumn_name\fR
.RS 4
Name of a new or existing column\&.
.RE
.PP
\fIextension_name\fR
.RS 4
The name of the extension that the materialized view is to depend on\&.
.RE
.PP
\fInew_column_name\fR
.RS 4
New name for an existing column\&.
.RE
.PP
\fInew_owner\fR
.RS 4
The user name of the new owner of the materialized view\&.
.RE
.PP
\fInew_name\fR
.RS 4
The new name for the materialized view\&.
.RE
.PP
\fInew_schema\fR
.RS 4
The new schema for the materialized view\&.
.RE
.SH "EXAMPLES"
.PP
To rename the materialized view
foo
to
bar:
.sp
.if n \{\
.RS 4
.\}
.nf
ALTER MATERIALIZED VIEW foo RENAME TO bar;
.fi
.if n \{\
.RE
.\}
.SH "COMPATIBILITY"
.PP
\fBALTER MATERIALIZED VIEW\fR
is a
PostgreSQL
extension\&.
.SH "SEE ALSO"
CREATE MATERIALIZED VIEW (\fBCREATE_MATERIALIZED_VIEW\fR(7)), DROP MATERIALIZED VIEW (\fBDROP_MATERIALIZED_VIEW\fR(7)), REFRESH MATERIALIZED VIEW (\fBREFRESH_MATERIALIZED_VIEW\fR(7))
man/man7/SAVEPOINT.7 0000644 00000007004 14751153421 0007625 0 ustar 00 '\" t
.\" Title: SAVEPOINT
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "SAVEPOINT" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
SAVEPOINT \- define a new savepoint within the current transaction
.SH "SYNOPSIS"
.sp
.nf
SAVEPOINT \fIsavepoint_name\fR
.fi
.SH "DESCRIPTION"
.PP
\fBSAVEPOINT\fR
establishes a new savepoint within the current transaction\&.
.PP
A savepoint is a special mark inside a transaction that allows all commands that are executed after it was established to be rolled back, restoring the transaction state to what it was at the time of the savepoint\&.
.SH "PARAMETERS"
.PP
\fIsavepoint_name\fR
.RS 4
The name to give to the new savepoint\&.
.RE
.SH "NOTES"
.PP
Use
ROLLBACK TO SAVEPOINT (\fBROLLBACK_TO_SAVEPOINT\fR(7))
to rollback to a savepoint\&. Use
RELEASE SAVEPOINT (\fBRELEASE_SAVEPOINT\fR(7))
to destroy a savepoint, keeping the effects of commands executed after it was established\&.
.PP
Savepoints can only be established when inside a transaction block\&. There can be multiple savepoints defined within a transaction\&.
.SH "EXAMPLES"
.PP
To establish a savepoint and later undo the effects of all commands executed after it was established:
.sp
.if n \{\
.RS 4
.\}
.nf
BEGIN;
INSERT INTO table1 VALUES (1);
SAVEPOINT my_savepoint;
INSERT INTO table1 VALUES (2);
ROLLBACK TO SAVEPOINT my_savepoint;
INSERT INTO table1 VALUES (3);
COMMIT;
.fi
.if n \{\
.RE
.\}
.sp
The above transaction will insert the values 1 and 3, but not 2\&.
.PP
To establish and later destroy a savepoint:
.sp
.if n \{\
.RS 4
.\}
.nf
BEGIN;
INSERT INTO table1 VALUES (3);
SAVEPOINT my_savepoint;
INSERT INTO table1 VALUES (4);
RELEASE SAVEPOINT my_savepoint;
COMMIT;
.fi
.if n \{\
.RE
.\}
.sp
The above transaction will insert both 3 and 4\&.
.SH "COMPATIBILITY"
.PP
SQL requires a savepoint to be destroyed automatically when another savepoint with the same name is established\&. In
PostgreSQL, the old savepoint is kept, though only the more recent one will be used when rolling back or releasing\&. (Releasing the newer savepoint with
\fBRELEASE SAVEPOINT\fR
will cause the older one to again become accessible to
\fBROLLBACK TO SAVEPOINT\fR
and
\fBRELEASE SAVEPOINT\fR\&.) Otherwise,
\fBSAVEPOINT\fR
is fully SQL conforming\&.
.SH "SEE ALSO"
\fBBEGIN\fR(7), \fBCOMMIT\fR(7), RELEASE SAVEPOINT (\fBRELEASE_SAVEPOINT\fR(7)), \fBROLLBACK\fR(7), ROLLBACK TO SAVEPOINT (\fBROLLBACK_TO_SAVEPOINT\fR(7))
man/man7/CREATE_OPERATOR.7 0000644 00000016172 14751153421 0010541 0 ustar 00 '\" t
.\" Title: CREATE OPERATOR
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "CREATE OPERATOR" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
CREATE_OPERATOR \- define a new operator
.SH "SYNOPSIS"
.sp
.nf
CREATE OPERATOR \fIname\fR (
PROCEDURE = \fIfunction_name\fR
[, LEFTARG = \fIleft_type\fR ] [, RIGHTARG = \fIright_type\fR ]
[, COMMUTATOR = \fIcom_op\fR ] [, NEGATOR = \fIneg_op\fR ]
[, RESTRICT = \fIres_proc\fR ] [, JOIN = \fIjoin_proc\fR ]
[, HASHES ] [, MERGES ]
)
.fi
.SH "DESCRIPTION"
.PP
\fBCREATE OPERATOR\fR
defines a new operator,
\fIname\fR\&. The user who defines an operator becomes its owner\&. If a schema name is given then the operator is created in the specified schema\&. Otherwise it is created in the current schema\&.
.PP
The operator name is a sequence of up to
NAMEDATALEN\-1 (63 by default) characters from the following list:
.sp
.if n \{\
.RS 4
.\}
.nf
+ \- * / < > = ~ ! @ # % ^ & | ` ?
.fi
.if n \{\
.RE
.\}
.sp
There are a few restrictions on your choice of name:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\-\-
and
/*
cannot appear anywhere in an operator name, since they will be taken as the start of a comment\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
A multicharacter operator name cannot end in
+
or
\-, unless the name also contains at least one of these characters:
.sp
.if n \{\
.RS 4
.\}
.nf
~ ! @ # % ^ & | ` ?
.fi
.if n \{\
.RE
.\}
.sp
For example,
@\-
is an allowed operator name, but
*\-
is not\&. This restriction allows
PostgreSQL
to parse SQL\-compliant commands without requiring spaces between tokens\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
The use of
=>
as an operator name is deprecated\&. It may be disallowed altogether in a future release\&.
.RE
.PP
The operator
!=
is mapped to
<>
on input, so these two names are always equivalent\&.
.PP
At least one of
LEFTARG
and
RIGHTARG
must be defined\&. For binary operators, both must be defined\&. For right unary operators, only
LEFTARG
should be defined, while for left unary operators only
RIGHTARG
should be defined\&.
.if n \{\
.sp
.\}
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBNote\fR
.ps -1
.br
.PP
Right unary, also called postfix, operators are deprecated and will be removed in
PostgreSQL
version 14\&.
.sp .5v
.RE
.PP
The
\fIfunction_name\fR
procedure must have been previously defined using
\fBCREATE FUNCTION\fR
and must be defined to accept the correct number of arguments (either one or two) of the indicated types\&.
.PP
The other clauses specify optional operator optimization clauses\&. Their meaning is detailed in
Section 36.13, \(lqOperator Optimization Information\(rq, in the documentation\&.
.PP
To be able to create an operator, you must have
USAGE
privilege on the argument types and the return type, as well as
EXECUTE
privilege on the underlying function\&. If a commutator or negator operator is specified, you must own these operators\&.
.SH "PARAMETERS"
.PP
\fIname\fR
.RS 4
The name of the operator to be defined\&. See above for allowable characters\&. The name can be schema\-qualified, for example
CREATE OPERATOR myschema\&.+ (\&.\&.\&.)\&. If not, then the operator is created in the current schema\&. Two operators in the same schema can have the same name if they operate on different data types\&. This is called
overloading\&.
.RE
.PP
\fIfunction_name\fR
.RS 4
The function used to implement this operator\&.
.RE
.PP
\fIleft_type\fR
.RS 4
The data type of the operator\*(Aqs left operand, if any\&. This option would be omitted for a left\-unary operator\&.
.RE
.PP
\fIright_type\fR
.RS 4
The data type of the operator\*(Aqs right operand, if any\&. This option would be omitted for a right\-unary operator\&.
.RE
.PP
\fIcom_op\fR
.RS 4
The commutator of this operator\&.
.RE
.PP
\fIneg_op\fR
.RS 4
The negator of this operator\&.
.RE
.PP
\fIres_proc\fR
.RS 4
The restriction selectivity estimator function for this operator\&.
.RE
.PP
\fIjoin_proc\fR
.RS 4
The join selectivity estimator function for this operator\&.
.RE
.PP
HASHES
.RS 4
Indicates this operator can support a hash join\&.
.RE
.PP
MERGES
.RS 4
Indicates this operator can support a merge join\&.
.RE
.PP
To give a schema\-qualified operator name in
\fIcom_op\fR
or the other optional arguments, use the
OPERATOR()
syntax, for example:
.sp
.if n \{\
.RS 4
.\}
.nf
COMMUTATOR = OPERATOR(myschema\&.===) ,
.fi
.if n \{\
.RE
.\}
.SH "NOTES"
.PP
Refer to
Section 36.12, \(lqUser-defined Operators\(rq, in the documentation
for further information\&.
.PP
It is not possible to specify an operator\*(Aqs lexical precedence in
\fBCREATE OPERATOR\fR, because the parser\*(Aqs precedence behavior is hard\-wired\&. See
Section 4.1.6, \(lqOperator Precedence\(rq, in the documentation
for precedence details\&.
.PP
The obsolete options
SORT1,
SORT2,
LTCMP, and
GTCMP
were formerly used to specify the names of sort operators associated with a merge\-joinable operator\&. This is no longer necessary, since information about associated operators is found by looking at B\-tree operator families instead\&. If one of these options is given, it is ignored except for implicitly setting
MERGES
true\&.
.PP
Use
DROP OPERATOR (\fBDROP_OPERATOR\fR(7))
to delete user\-defined operators from a database\&. Use
ALTER OPERATOR (\fBALTER_OPERATOR\fR(7))
to modify operators in a database\&.
.SH "EXAMPLES"
.PP
The following command defines a new operator, area\-equality, for the data type
box:
.sp
.if n \{\
.RS 4
.\}
.nf
CREATE OPERATOR === (
LEFTARG = box,
RIGHTARG = box,
PROCEDURE = area_equal_procedure,
COMMUTATOR = ===,
NEGATOR = !==,
RESTRICT = area_restriction_procedure,
JOIN = area_join_procedure,
HASHES, MERGES
);
.fi
.if n \{\
.RE
.\}
.SH "COMPATIBILITY"
.PP
\fBCREATE OPERATOR\fR
is a
PostgreSQL
extension\&. There are no provisions for user\-defined operators in the SQL standard\&.
.SH "SEE ALSO"
ALTER OPERATOR (\fBALTER_OPERATOR\fR(7)), CREATE OPERATOR CLASS (\fBCREATE_OPERATOR_CLASS\fR(7)), DROP OPERATOR (\fBDROP_OPERATOR\fR(7))
man/man7/START_TRANSACTION.7 0000644 00000005633 14751153421 0011025 0 ustar 00 '\" t
.\" Title: START TRANSACTION
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "START TRANSACTION" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
START_TRANSACTION \- start a transaction block
.SH "SYNOPSIS"
.sp
.nf
START TRANSACTION [ \fItransaction_mode\fR [, \&.\&.\&.] ]
where \fItransaction_mode\fR is one of:
ISOLATION LEVEL { SERIALIZABLE | REPEATABLE READ | READ COMMITTED | READ UNCOMMITTED }
READ WRITE | READ ONLY
[ NOT ] DEFERRABLE
.fi
.SH "DESCRIPTION"
.PP
This command begins a new transaction block\&. If the isolation level, read/write mode, or deferrable mode is specified, the new transaction has those characteristics, as if
SET TRANSACTION (\fBSET_TRANSACTION\fR(7))
was executed\&. This is the same as the
\fBBEGIN\fR(7)
command\&.
.SH "PARAMETERS"
.PP
Refer to
SET TRANSACTION (\fBSET_TRANSACTION\fR(7))
for information on the meaning of the parameters to this statement\&.
.SH "COMPATIBILITY"
.PP
In the standard, it is not necessary to issue
\fBSTART TRANSACTION\fR
to start a transaction block: any SQL command implicitly begins a block\&.
PostgreSQL\*(Aqs behavior can be seen as implicitly issuing a
\fBCOMMIT\fR
after each command that does not follow
\fBSTART TRANSACTION\fR
(or
\fBBEGIN\fR), and it is therefore often called
\(lqautocommit\(rq\&. Other relational database systems might offer an autocommit feature as a convenience\&.
.PP
The
DEFERRABLE
\fItransaction_mode\fR
is a
PostgreSQL
language extension\&.
.PP
The SQL standard requires commas between successive
\fItransaction_modes\fR, but for historical reasons
PostgreSQL
allows the commas to be omitted\&.
.PP
See also the compatibility section of
SET TRANSACTION (\fBSET_TRANSACTION\fR(7))\&.
.SH "SEE ALSO"
\fBBEGIN\fR(7), \fBCOMMIT\fR(7), \fBROLLBACK\fR(7), \fBSAVEPOINT\fR(7), SET TRANSACTION (\fBSET_TRANSACTION\fR(7))
man/man7/CREATE_VIEW.7 0000644 00000035205 14751153421 0010056 0 ustar 00 '\" t
.\" Title: CREATE VIEW
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "CREATE VIEW" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
CREATE_VIEW \- define a new view
.SH "SYNOPSIS"
.sp
.nf
CREATE [ OR REPLACE ] [ TEMP | TEMPORARY ] [ RECURSIVE ] VIEW \fIname\fR [ ( \fIcolumn_name\fR [, \&.\&.\&.] ) ]
[ WITH ( \fIview_option_name\fR [= \fIview_option_value\fR] [, \&.\&.\&. ] ) ]
AS \fIquery\fR
[ WITH [ CASCADED | LOCAL ] CHECK OPTION ]
.fi
.SH "DESCRIPTION"
.PP
\fBCREATE VIEW\fR
defines a view of a query\&. The view is not physically materialized\&. Instead, the query is run every time the view is referenced in a query\&.
.PP
\fBCREATE OR REPLACE VIEW\fR
is similar, but if a view of the same name already exists, it is replaced\&. The new query must generate the same columns that were generated by the existing view query (that is, the same column names in the same order and with the same data types), but it may add additional columns to the end of the list\&. The calculations giving rise to the output columns may be completely different\&.
.PP
If a schema name is given (for example,
CREATE VIEW myschema\&.myview \&.\&.\&.) then the view is created in the specified schema\&. Otherwise it is created in the current schema\&. Temporary views exist in a special schema, so a schema name cannot be given when creating a temporary view\&. The name of the view must be distinct from the name of any other view, table, sequence, index or foreign table in the same schema\&.
.SH "PARAMETERS"
.PP
TEMPORARY or TEMP
.RS 4
If specified, the view is created as a temporary view\&. Temporary views are automatically dropped at the end of the current session\&. Existing permanent relations with the same name are not visible to the current session while the temporary view exists, unless they are referenced with schema\-qualified names\&.
.sp
If any of the tables referenced by the view are temporary, the view is created as a temporary view (whether
TEMPORARY
is specified or not)\&.
.RE
.PP
RECURSIVE
.RS 4
Creates a recursive view\&. The syntax
.sp
.if n \{\
.RS 4
.\}
.nf
CREATE RECURSIVE VIEW [ \fIschema\fR \&. ] \fIview_name\fR (\fIcolumn_names\fR) AS SELECT \fI\&.\&.\&.\fR;
.fi
.if n \{\
.RE
.\}
.sp
is equivalent to
.sp
.if n \{\
.RS 4
.\}
.nf
CREATE VIEW [ \fIschema\fR \&. ] \fIview_name\fR AS WITH RECURSIVE \fIview_name\fR (\fIcolumn_names\fR) AS (SELECT \fI\&.\&.\&.\fR) SELECT \fIcolumn_names\fR FROM \fIview_name\fR;
.fi
.if n \{\
.RE
.\}
.sp
A view column name list must be specified for a recursive view\&.
.RE
.PP
\fIname\fR
.RS 4
The name (optionally schema\-qualified) of a view to be created\&.
.RE
.PP
\fIcolumn_name\fR
.RS 4
An optional list of names to be used for columns of the view\&. If not given, the column names are deduced from the query\&.
.RE
.PP
WITH ( \fIview_option_name\fR [= \fIview_option_value\fR] [, \&.\&.\&. ] )
.RS 4
This clause specifies optional parameters for a view; the following parameters are supported:
.PP
check_option (string)
.RS 4
This parameter may be either
local
or
cascaded, and is equivalent to specifying
WITH [ CASCADED | LOCAL ] CHECK OPTION
(see below)\&. This option can be changed on existing views using
ALTER VIEW (\fBALTER_VIEW\fR(7))\&.
.RE
.PP
security_barrier (boolean)
.RS 4
This should be used if the view is intended to provide row\-level security\&. See
Section 39.5, \(lqRules and Privileges\(rq, in the documentation
for full details\&.
.RE
.sp
.RE
.PP
\fIquery\fR
.RS 4
A
\fBSELECT\fR(7)
or
\fBVALUES\fR(7)
command which will provide the columns and rows of the view\&.
.RE
.PP
WITH [ CASCADED | LOCAL ] CHECK OPTION
.RS 4
This option controls the behavior of automatically updatable views\&. When this option is specified,
\fBINSERT\fR
and
\fBUPDATE\fR
commands on the view will be checked to ensure that new rows satisfy the view\-defining condition (that is, the new rows are checked to ensure that they are visible through the view)\&. If they are not, the update will be rejected\&. If the
CHECK OPTION
is not specified,
\fBINSERT\fR
and
\fBUPDATE\fR
commands on the view are allowed to create rows that are not visible through the view\&. The following check options are supported:
.PP
LOCAL
.RS 4
New rows are only checked against the conditions defined directly in the view itself\&. Any conditions defined on underlying base views are not checked (unless they also specify the
CHECK OPTION)\&.
.RE
.PP
CASCADED
.RS 4
New rows are checked against the conditions of the view and all underlying base views\&. If the
CHECK OPTION
is specified, and neither
LOCAL
nor
CASCADED
is specified, then
CASCADED
is assumed\&.
.RE
.sp
The
CHECK OPTION
may not be used with
RECURSIVE
views\&.
.sp
Note that the
CHECK OPTION
is only supported on views that are automatically updatable, and do not have
INSTEAD OF
triggers or
INSTEAD
rules\&. If an automatically updatable view is defined on top of a base view that has
INSTEAD OF
triggers, then the
LOCAL CHECK OPTION
may be used to check the conditions on the automatically updatable view, but the conditions on the base view with
INSTEAD OF
triggers will not be checked (a cascaded check option will not cascade down to a trigger\-updatable view, and any check options defined directly on a trigger\-updatable view will be ignored)\&. If the view or any of its base relations has an
INSTEAD
rule that causes the
\fBINSERT\fR
or
\fBUPDATE\fR
command to be rewritten, then all check options will be ignored in the rewritten query, including any checks from automatically updatable views defined on top of the relation with the
INSTEAD
rule\&.
.RE
.SH "NOTES"
.PP
Use the
DROP VIEW (\fBDROP_VIEW\fR(7))
statement to drop views\&.
.PP
Be careful that the names and types of the view\*(Aqs columns will be assigned the way you want\&. For example:
.sp
.if n \{\
.RS 4
.\}
.nf
CREATE VIEW vista AS SELECT \*(AqHello World\*(Aq;
.fi
.if n \{\
.RE
.\}
.sp
is bad form in two ways: the column name defaults to
?column?, and the column data type defaults to
unknown\&. If you want a string literal in a view\*(Aqs result, use something like:
.sp
.if n \{\
.RS 4
.\}
.nf
CREATE VIEW vista AS SELECT text \*(AqHello World\*(Aq AS hello;
.fi
.if n \{\
.RE
.\}
.PP
Access to tables referenced in the view is determined by permissions of the view owner\&. In some cases, this can be used to provide secure but restricted access to the underlying tables\&. However, not all views are secure against tampering; see
Section 39.5, \(lqRules and Privileges\(rq, in the documentation
for details\&. Functions called in the view are treated the same as if they had been called directly from the query using the view\&. Therefore the user of a view must have permissions to call all functions used by the view\&.
.PP
When
\fBCREATE OR REPLACE VIEW\fR
is used on an existing view, only the view\*(Aqs defining SELECT rule is changed\&. Other view properties, including ownership, permissions, and non\-SELECT rules, remain unchanged\&. You must own the view to replace it (this includes being a member of the owning role)\&.
.SS "Updatable Views"
.PP
Simple views are automatically updatable: the system will allow
\fBINSERT\fR,
\fBUPDATE\fR
and
\fBDELETE\fR
statements to be used on the view in the same way as on a regular table\&. A view is automatically updatable if it satisfies all of the following conditions:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
The view must have exactly one entry in its
FROM
list, which must be a table or another updatable view\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
The view definition must not contain
WITH,
DISTINCT,
GROUP BY,
HAVING,
LIMIT, or
OFFSET
clauses at the top level\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
The view definition must not contain set operations (UNION,
INTERSECT
or
EXCEPT) at the top level\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
The view\*(Aqs select list must not contain any aggregates, window functions or set\-returning functions\&.
.RE
.PP
An automatically updatable view may contain a mix of updatable and non\-updatable columns\&. A column is updatable if it is a simple reference to an updatable column of the underlying base relation; otherwise the column is read\-only, and an error will be raised if an
\fBINSERT\fR
or
\fBUPDATE\fR
statement attempts to assign a value to it\&.
.PP
If the view is automatically updatable the system will convert any
\fBINSERT\fR,
\fBUPDATE\fR
or
\fBDELETE\fR
statement on the view into the corresponding statement on the underlying base relation\&.
\fBINSERT\fR
statements that have an
ON CONFLICT UPDATE
clause are fully supported\&.
.PP
If an automatically updatable view contains a
WHERE
condition, the condition restricts which rows of the base relation are available to be modified by
\fBUPDATE\fR
and
\fBDELETE\fR
statements on the view\&. However, an
\fBUPDATE\fR
is allowed to change a row so that it no longer satisfies the
WHERE
condition, and thus is no longer visible through the view\&. Similarly, an
\fBINSERT\fR
command can potentially insert base\-relation rows that do not satisfy the
WHERE
condition and thus are not visible through the view (ON CONFLICT UPDATE
may similarly affect an existing row not visible through the view)\&. The
CHECK OPTION
may be used to prevent
\fBINSERT\fR
and
\fBUPDATE\fR
commands from creating such rows that are not visible through the view\&.
.PP
If an automatically updatable view is marked with the
security_barrier
property then all the view\*(Aqs
WHERE
conditions (and any conditions using operators which are marked as
LEAKPROOF) will always be evaluated before any conditions that a user of the view has added\&. See
Section 39.5, \(lqRules and Privileges\(rq, in the documentation
for full details\&. Note that, due to this, rows which are not ultimately returned (because they do not pass the user\*(Aqs
WHERE
conditions) may still end up being locked\&.
\fBEXPLAIN\fR
can be used to see which conditions are applied at the relation level (and therefore do not lock rows) and which are not\&.
.PP
A more complex view that does not satisfy all these conditions is read\-only by default: the system will not allow an insert, update, or delete on the view\&. You can get the effect of an updatable view by creating
INSTEAD OF
triggers on the view, which must convert attempted inserts, etc\&. on the view into appropriate actions on other tables\&. For more information see
CREATE TRIGGER (\fBCREATE_TRIGGER\fR(7))\&. Another possibility is to create rules (see
CREATE RULE (\fBCREATE_RULE\fR(7))), but in practice triggers are easier to understand and use correctly\&.
.PP
Note that the user performing the insert, update or delete on the view must have the corresponding insert, update or delete privilege on the view\&. In addition the view\*(Aqs owner must have the relevant privileges on the underlying base relations, but the user performing the update does not need any permissions on the underlying base relations (see
Section 39.5, \(lqRules and Privileges\(rq, in the documentation)\&.
.SH "EXAMPLES"
.PP
Create a view consisting of all comedy films:
.sp
.if n \{\
.RS 4
.\}
.nf
CREATE VIEW comedies AS
SELECT *
FROM films
WHERE kind = \*(AqComedy\*(Aq;
.fi
.if n \{\
.RE
.\}
.sp
This will create a view containing the columns that are in the
film
table at the time of view creation\&. Though
*
was used to create the view, columns added later to the table will not be part of the view\&.
.PP
Create a view with
LOCAL CHECK OPTION:
.sp
.if n \{\
.RS 4
.\}
.nf
CREATE VIEW universal_comedies AS
SELECT *
FROM comedies
WHERE classification = \*(AqU\*(Aq
WITH LOCAL CHECK OPTION;
.fi
.if n \{\
.RE
.\}
.sp
This will create a view based on the
comedies
view, showing only films with
kind = \*(AqComedy\*(Aq
and
classification = \*(AqU\*(Aq\&. Any attempt to
\fBINSERT\fR
or
\fBUPDATE\fR
a row in the view will be rejected if the new row doesn\*(Aqt have
classification = \*(AqU\*(Aq, but the film
kind
will not be checked\&.
.PP
Create a view with
CASCADED CHECK OPTION:
.sp
.if n \{\
.RS 4
.\}
.nf
CREATE VIEW pg_comedies AS
SELECT *
FROM comedies
WHERE classification = \*(AqPG\*(Aq
WITH CASCADED CHECK OPTION;
.fi
.if n \{\
.RE
.\}
.sp
This will create a view that checks both the
kind
and
classification
of new rows\&.
.PP
Create a view with a mix of updatable and non\-updatable columns:
.sp
.if n \{\
.RS 4
.\}
.nf
CREATE VIEW comedies AS
SELECT f\&.*,
country_code_to_name(f\&.country_code) AS country,
(SELECT avg(r\&.rating)
FROM user_ratings r
WHERE r\&.film_id = f\&.id) AS avg_rating
FROM films f
WHERE f\&.kind = \*(AqComedy\*(Aq;
.fi
.if n \{\
.RE
.\}
.sp
This view will support
\fBINSERT\fR,
\fBUPDATE\fR
and
\fBDELETE\fR\&. All the columns from the
films
table will be updatable, whereas the computed columns
country
and
avg_rating
will be read\-only\&.
.PP
Create a recursive view consisting of the numbers from 1 to 100:
.sp
.if n \{\
.RS 4
.\}
.nf
CREATE RECURSIVE VIEW public\&.nums_1_100 (n) AS
VALUES (1)
UNION ALL
SELECT n+1 FROM nums_1_100 WHERE n < 100;
.fi
.if n \{\
.RE
.\}
.sp
Notice that although the recursive view\*(Aqs name is schema\-qualified in this
\fBCREATE\fR, its internal self\-reference is not schema\-qualified\&. This is because the implicitly\-created CTE\*(Aqs name cannot be schema\-qualified\&.
.SH "COMPATIBILITY"
.PP
\fBCREATE OR REPLACE VIEW\fR
is a
PostgreSQL
language extension\&. So is the concept of a temporary view\&. The
WITH ( \&.\&.\&. )
clause is an extension as well\&.
.SH "SEE ALSO"
ALTER VIEW (\fBALTER_VIEW\fR(7)), DROP VIEW (\fBDROP_VIEW\fR(7)), CREATE MATERIALIZED VIEW (\fBCREATE_MATERIALIZED_VIEW\fR(7))
man/man7/LOAD.7 0000644 00000005053 14751153421 0006776 0 ustar 00 '\" t
.\" Title: LOAD
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "LOAD" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
LOAD \- load a shared library file
.SH "SYNOPSIS"
.sp
.nf
LOAD \*(Aq\fIfilename\fR\*(Aq
.fi
.SH "DESCRIPTION"
.PP
This command loads a shared library file into the
PostgreSQL
server\*(Aqs address space\&. If the file has been loaded already, the command does nothing\&. Shared library files that contain C functions are automatically loaded whenever one of their functions is called\&. Therefore, an explicit
\fBLOAD\fR
is usually only needed to load a library that modifies the server\*(Aqs behavior through
\(lqhooks\(rq
rather than providing a set of functions\&.
.PP
The file name is specified in the same way as for shared library names in
CREATE FUNCTION (\fBCREATE_FUNCTION\fR(7)); in particular, one can rely on a search path and automatic addition of the system\*(Aqs standard shared library file name extension\&. See
Section 36.9, \(lqC-Language Functions\(rq, in the documentation
for more information on this topic\&.
.PP
Non\-superusers can only apply
\fBLOAD\fR
to library files located in
$libdir/plugins/
\(em the specified
\fIfilename\fR
must begin with exactly that string\&. (It is the database administrator\*(Aqs responsibility to ensure that only
\(lqsafe\(rq
libraries are installed there\&.)
.SH "COMPATIBILITY"
.PP
\fBLOAD\fR
is a
PostgreSQL
extension\&.
.SH "SEE ALSO"
.PP
CREATE FUNCTION (\fBCREATE_FUNCTION\fR(7))
man/man7/DROP_INDEX.7 0000644 00000006372 14751153421 0007757 0 ustar 00 '\" t
.\" Title: DROP INDEX
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "DROP INDEX" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
DROP_INDEX \- remove an index
.SH "SYNOPSIS"
.sp
.nf
DROP INDEX [ CONCURRENTLY ] [ IF EXISTS ] \fIname\fR [, \&.\&.\&.] [ CASCADE | RESTRICT ]
.fi
.SH "DESCRIPTION"
.PP
\fBDROP INDEX\fR
drops an existing index from the database system\&. To execute this command you must be the owner of the index\&.
.SH "PARAMETERS"
.PP
CONCURRENTLY
.RS 4
Drop the index without locking out concurrent selects, inserts, updates, and deletes on the index\*(Aqs table\&. A normal
\fBDROP INDEX\fR
acquires an
ACCESS EXCLUSIVE
lock on the table, blocking other accesses until the index drop can be completed\&. With this option, the command instead waits until conflicting transactions have completed\&.
.sp
There are several caveats to be aware of when using this option\&. Only one index name can be specified, and the
CASCADE
option is not supported\&. (Thus, an index that supports a
UNIQUE
or
PRIMARY KEY
constraint cannot be dropped this way\&.) Also, regular
\fBDROP INDEX\fR
commands can be performed within a transaction block, but
\fBDROP INDEX CONCURRENTLY\fR
cannot\&.
.sp
For temporary tables,
\fBDROP INDEX\fR
is always non\-concurrent, as no other session can access them, and non\-concurrent index drop is cheaper\&.
.RE
.PP
IF EXISTS
.RS 4
Do not throw an error if the index does not exist\&. A notice is issued in this case\&.
.RE
.PP
\fIname\fR
.RS 4
The name (optionally schema\-qualified) of an index to remove\&.
.RE
.PP
CASCADE
.RS 4
Automatically drop objects that depend on the index, and in turn all objects that depend on those objects (see
Section 5.13, \(lqDependency Tracking\(rq, in the documentation)\&.
.RE
.PP
RESTRICT
.RS 4
Refuse to drop the index if any objects depend on it\&. This is the default\&.
.RE
.SH "EXAMPLES"
.PP
This command will remove the index
title_idx:
.sp
.if n \{\
.RS 4
.\}
.nf
DROP INDEX title_idx;
.fi
.if n \{\
.RE
.\}
.SH "COMPATIBILITY"
.PP
\fBDROP INDEX\fR
is a
PostgreSQL
language extension\&. There are no provisions for indexes in the SQL standard\&.
.SH "SEE ALSO"
CREATE INDEX (\fBCREATE_INDEX\fR(7))
man/man7/DROP_DATABASE.7 0000644 00000004604 14751153421 0010250 0 ustar 00 '\" t
.\" Title: DROP DATABASE
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "DROP DATABASE" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
DROP_DATABASE \- remove a database
.SH "SYNOPSIS"
.sp
.nf
DROP DATABASE [ IF EXISTS ] \fIname\fR
.fi
.SH "DESCRIPTION"
.PP
\fBDROP DATABASE\fR
drops a database\&. It removes the catalog entries for the database and deletes the directory containing the data\&. It can only be executed by the database owner\&. Also, it cannot be executed while you or anyone else are connected to the target database\&. (Connect to
postgres
or any other database to issue this command\&.)
.PP
\fBDROP DATABASE\fR
cannot be undone\&. Use it with care!
.SH "PARAMETERS"
.PP
IF EXISTS
.RS 4
Do not throw an error if the database does not exist\&. A notice is issued in this case\&.
.RE
.PP
\fIname\fR
.RS 4
The name of the database to remove\&.
.RE
.SH "NOTES"
.PP
\fBDROP DATABASE\fR
cannot be executed inside a transaction block\&.
.PP
This command cannot be executed while connected to the target database\&. Thus, it might be more convenient to use the program
\fBdropdb\fR(1)
instead, which is a wrapper around this command\&.
.SH "COMPATIBILITY"
.PP
There is no
\fBDROP DATABASE\fR
statement in the SQL standard\&.
.SH "SEE ALSO"
CREATE DATABASE (\fBCREATE_DATABASE\fR(7))
man/man7/DROP_OPERATOR_FAMILY.7 0000644 00000006371 14751153421 0011403 0 ustar 00 '\" t
.\" Title: DROP OPERATOR FAMILY
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "DROP OPERATOR FAMILY" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
DROP_OPERATOR_FAMILY \- remove an operator family
.SH "SYNOPSIS"
.sp
.nf
DROP OPERATOR FAMILY [ IF EXISTS ] \fIname\fR USING \fIindex_method\fR [ CASCADE | RESTRICT ]
.fi
.SH "DESCRIPTION"
.PP
\fBDROP OPERATOR FAMILY\fR
drops an existing operator family\&. To execute this command you must be the owner of the operator family\&.
.PP
\fBDROP OPERATOR FAMILY\fR
includes dropping any operator classes contained in the family, but it does not drop any of the operators or functions referenced by the family\&. If there are any indexes depending on operator classes within the family, you will need to specify
CASCADE
for the drop to complete\&.
.SH "PARAMETERS"
.PP
IF EXISTS
.RS 4
Do not throw an error if the operator family does not exist\&. A notice is issued in this case\&.
.RE
.PP
\fIname\fR
.RS 4
The name (optionally schema\-qualified) of an existing operator family\&.
.RE
.PP
\fIindex_method\fR
.RS 4
The name of the index access method the operator family is for\&.
.RE
.PP
CASCADE
.RS 4
Automatically drop objects that depend on the operator family, and in turn all objects that depend on those objects (see
Section 5.13, \(lqDependency Tracking\(rq, in the documentation)\&.
.RE
.PP
RESTRICT
.RS 4
Refuse to drop the operator family if any objects depend on it\&. This is the default\&.
.RE
.SH "EXAMPLES"
.PP
Remove the B\-tree operator family
float_ops:
.sp
.if n \{\
.RS 4
.\}
.nf
DROP OPERATOR FAMILY float_ops USING btree;
.fi
.if n \{\
.RE
.\}
.sp
This command will not succeed if there are any existing indexes that use operator classes within the family\&. Add
CASCADE
to drop such indexes along with the operator family\&.
.SH "COMPATIBILITY"
.PP
There is no
\fBDROP OPERATOR FAMILY\fR
statement in the SQL standard\&.
.SH "SEE ALSO"
ALTER OPERATOR FAMILY (\fBALTER_OPERATOR_FAMILY\fR(7)), CREATE OPERATOR FAMILY (\fBCREATE_OPERATOR_FAMILY\fR(7)), ALTER OPERATOR CLASS (\fBALTER_OPERATOR_CLASS\fR(7)), CREATE OPERATOR CLASS (\fBCREATE_OPERATOR_CLASS\fR(7)), DROP OPERATOR CLASS (\fBDROP_OPERATOR_CLASS\fR(7))
man/man7/CREATE_FOREIGN_DATA_WRAPPER.7 0000644 00000011733 14751153421 0012366 0 ustar 00 '\" t
.\" Title: CREATE FOREIGN DATA WRAPPER
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "CREATE FOREIGN DATA WRAPPER" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
CREATE_FOREIGN_DATA_WRAPPER \- define a new foreign\-data wrapper
.SH "SYNOPSIS"
.sp
.nf
CREATE FOREIGN DATA WRAPPER \fIname\fR
[ HANDLER \fIhandler_function\fR | NO HANDLER ]
[ VALIDATOR \fIvalidator_function\fR | NO VALIDATOR ]
[ OPTIONS ( \fIoption\fR \*(Aq\fIvalue\fR\*(Aq [, \&.\&.\&. ] ) ]
.fi
.SH "DESCRIPTION"
.PP
\fBCREATE FOREIGN DATA WRAPPER\fR
creates a new foreign\-data wrapper\&. The user who defines a foreign\-data wrapper becomes its owner\&.
.PP
The foreign\-data wrapper name must be unique within the database\&.
.PP
Only superusers can create foreign\-data wrappers\&.
.SH "PARAMETERS"
.PP
\fIname\fR
.RS 4
The name of the foreign\-data wrapper to be created\&.
.RE
.PP
HANDLER \fIhandler_function\fR
.RS 4
\fIhandler_function\fR
is the name of a previously registered function that will be called to retrieve the execution functions for foreign tables\&. The handler function must take no arguments, and its return type must be
fdw_handler\&.
.sp
It is possible to create a foreign\-data wrapper with no handler function, but foreign tables using such a wrapper can only be declared, not accessed\&.
.RE
.PP
VALIDATOR \fIvalidator_function\fR
.RS 4
\fIvalidator_function\fR
is the name of a previously registered function that will be called to check the generic options given to the foreign\-data wrapper, as well as options for foreign servers, user mappings and foreign tables using the foreign\-data wrapper\&. If no validator function or
NO VALIDATOR
is specified, then options will not be checked at creation time\&. (Foreign\-data wrappers will possibly ignore or reject invalid option specifications at run time, depending on the implementation\&.) The validator function must take two arguments: one of type
text[], which will contain the array of options as stored in the system catalogs, and one of type
oid, which will be the OID of the system catalog containing the options\&. The return type is ignored; the function should report invalid options using the
\fBereport(ERROR)\fR
function\&.
.RE
.PP
OPTIONS ( \fIoption\fR \*(Aq\fIvalue\fR\*(Aq [, \&.\&.\&. ] )
.RS 4
This clause specifies options for the new foreign\-data wrapper\&. The allowed option names and values are specific to each foreign data wrapper and are validated using the foreign\-data wrapper\*(Aqs validator function\&. Option names must be unique\&.
.RE
.SH "NOTES"
.PP
PostgreSQL\*(Aqs foreign\-data functionality is still under active development\&. Optimization of queries is primitive (and mostly left to the wrapper, too)\&. Thus, there is considerable room for future performance improvements\&.
.SH "EXAMPLES"
.PP
Create a useless foreign\-data wrapper
dummy:
.sp
.if n \{\
.RS 4
.\}
.nf
CREATE FOREIGN DATA WRAPPER dummy;
.fi
.if n \{\
.RE
.\}
.PP
Create a foreign\-data wrapper
file
with handler function
file_fdw_handler:
.sp
.if n \{\
.RS 4
.\}
.nf
CREATE FOREIGN DATA WRAPPER file HANDLER file_fdw_handler;
.fi
.if n \{\
.RE
.\}
.PP
Create a foreign\-data wrapper
mywrapper
with some options:
.sp
.if n \{\
.RS 4
.\}
.nf
CREATE FOREIGN DATA WRAPPER mywrapper
OPTIONS (debug \*(Aqtrue\*(Aq);
.fi
.if n \{\
.RE
.\}
.SH "COMPATIBILITY"
.PP
\fBCREATE FOREIGN DATA WRAPPER\fR
conforms to ISO/IEC 9075\-9 (SQL/MED), with the exception that the
HANDLER
and
VALIDATOR
clauses are extensions and the standard clauses
LIBRARY
and
LANGUAGE
are not implemented in
PostgreSQL\&.
.PP
Note, however, that the SQL/MED functionality as a whole is not yet conforming\&.
.SH "SEE ALSO"
ALTER FOREIGN DATA WRAPPER (\fBALTER_FOREIGN_DATA_WRAPPER\fR(7)), DROP FOREIGN DATA WRAPPER (\fBDROP_FOREIGN_DATA_WRAPPER\fR(7)), CREATE SERVER (\fBCREATE_SERVER\fR(7)), CREATE USER MAPPING (\fBCREATE_USER_MAPPING\fR(7)), CREATE FOREIGN TABLE (\fBCREATE_FOREIGN_TABLE\fR(7))
man/man7/ALTER_OPERATOR_FAMILY.7 0000644 00000022200 14751153421 0011473 0 ustar 00 '\" t
.\" Title: ALTER OPERATOR FAMILY
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "ALTER OPERATOR FAMILY" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
ALTER_OPERATOR_FAMILY \- change the definition of an operator family
.SH "SYNOPSIS"
.sp
.nf
ALTER OPERATOR FAMILY \fIname\fR USING \fIindex_method\fR ADD
{ OPERATOR \fIstrategy_number\fR \fIoperator_name\fR ( \fIop_type\fR, \fIop_type\fR )
[ FOR SEARCH | FOR ORDER BY \fIsort_family_name\fR ]
| FUNCTION \fIsupport_number\fR [ ( \fIop_type\fR [ , \fIop_type\fR ] ) ]
\fIfunction_name\fR ( \fIargument_type\fR [, \&.\&.\&.] )
} [, \&.\&.\&. ]
ALTER OPERATOR FAMILY \fIname\fR USING \fIindex_method\fR DROP
{ OPERATOR \fIstrategy_number\fR ( \fIop_type\fR [ , \fIop_type\fR ] )
| FUNCTION \fIsupport_number\fR ( \fIop_type\fR [ , \fIop_type\fR ] )
} [, \&.\&.\&. ]
ALTER OPERATOR FAMILY \fIname\fR USING \fIindex_method\fR
RENAME TO \fInew_name\fR
ALTER OPERATOR FAMILY \fIname\fR USING \fIindex_method\fR
OWNER TO { \fInew_owner\fR | CURRENT_USER | SESSION_USER }
ALTER OPERATOR FAMILY \fIname\fR USING \fIindex_method\fR
SET SCHEMA \fInew_schema\fR
.fi
.SH "DESCRIPTION"
.PP
\fBALTER OPERATOR FAMILY\fR
changes the definition of an operator family\&. You can add operators and support functions to the family, remove them from the family, or change the family\*(Aqs name or owner\&.
.PP
When operators and support functions are added to a family with
\fBALTER OPERATOR FAMILY\fR, they are not part of any specific operator class within the family, but are just
\(lqloose\(rq
within the family\&. This indicates that these operators and functions are compatible with the family\*(Aqs semantics, but are not required for correct functioning of any specific index\&. (Operators and functions that are so required should be declared as part of an operator class, instead; see
CREATE OPERATOR CLASS (\fBCREATE_OPERATOR_CLASS\fR(7))\&.)
PostgreSQL
will allow loose members of a family to be dropped from the family at any time, but members of an operator class cannot be dropped without dropping the whole class and any indexes that depend on it\&. Typically, single\-data\-type operators and functions are part of operator classes because they are needed to support an index on that specific data type, while cross\-data\-type operators and functions are made loose members of the family\&.
.PP
You must be a superuser to use
\fBALTER OPERATOR FAMILY\fR\&. (This restriction is made because an erroneous operator family definition could confuse or even crash the server\&.)
.PP
\fBALTER OPERATOR FAMILY\fR
does not presently check whether the operator family definition includes all the operators and functions required by the index method, nor whether the operators and functions form a self\-consistent set\&. It is the user\*(Aqs responsibility to define a valid operator family\&.
.PP
Refer to
Section 36.14, \(lqInterfacing Extensions To Indexes\(rq, in the documentation
for further information\&.
.SH "PARAMETERS"
.PP
\fIname\fR
.RS 4
The name (optionally schema\-qualified) of an existing operator family\&.
.RE
.PP
\fIindex_method\fR
.RS 4
The name of the index method this operator family is for\&.
.RE
.PP
\fIstrategy_number\fR
.RS 4
The index method\*(Aqs strategy number for an operator associated with the operator family\&.
.RE
.PP
\fIoperator_name\fR
.RS 4
The name (optionally schema\-qualified) of an operator associated with the operator family\&.
.RE
.PP
\fIop_type\fR
.RS 4
In an
OPERATOR
clause, the operand data type(s) of the operator, or
NONE
to signify a left\-unary or right\-unary operator\&. Unlike the comparable syntax in
\fBCREATE OPERATOR CLASS\fR, the operand data types must always be specified\&.
.sp
In an
ADD FUNCTION
clause, the operand data type(s) the function is intended to support, if different from the input data type(s) of the function\&. For B\-tree comparison functions and hash functions it is not necessary to specify
\fIop_type\fR
since the function\*(Aqs input data type(s) are always the correct ones to use\&. For B\-tree sort support functions and all functions in GiST, SP\-GiST and GIN operator classes, it is necessary to specify the operand data type(s) the function is to be used with\&.
.sp
In a
DROP FUNCTION
clause, the operand data type(s) the function is intended to support must be specified\&.
.RE
.PP
\fIsort_family_name\fR
.RS 4
The name (optionally schema\-qualified) of an existing
btree
operator family that describes the sort ordering associated with an ordering operator\&.
.sp
If neither
FOR SEARCH
nor
FOR ORDER BY
is specified,
FOR SEARCH
is the default\&.
.RE
.PP
\fIsupport_number\fR
.RS 4
The index method\*(Aqs support procedure number for a function associated with the operator family\&.
.RE
.PP
\fIfunction_name\fR
.RS 4
The name (optionally schema\-qualified) of a function that is an index method support procedure for the operator family\&.
.RE
.PP
\fIargument_type\fR
.RS 4
The parameter data type(s) of the function\&.
.RE
.PP
\fInew_name\fR
.RS 4
The new name of the operator family\&.
.RE
.PP
\fInew_owner\fR
.RS 4
The new owner of the operator family\&.
.RE
.PP
\fInew_schema\fR
.RS 4
The new schema for the operator family\&.
.RE
.PP
The
OPERATOR
and
FUNCTION
clauses can appear in any order\&.
.SH "NOTES"
.PP
Notice that the
DROP
syntax only specifies the
\(lqslot\(rq
in the operator family, by strategy or support number and input data type(s)\&. The name of the operator or function occupying the slot is not mentioned\&. Also, for
DROP FUNCTION
the type(s) to specify are the input data type(s) the function is intended to support; for GiST, SP\-GiST and GIN indexes this might have nothing to do with the actual input argument types of the function\&.
.PP
Because the index machinery does not check access permissions on functions before using them, including a function or operator in an operator family is tantamount to granting public execute permission on it\&. This is usually not an issue for the sorts of functions that are useful in an operator family\&.
.PP
The operators should not be defined by SQL functions\&. A SQL function is likely to be inlined into the calling query, which will prevent the optimizer from recognizing that the query matches an index\&.
.PP
Before
PostgreSQL
8\&.4, the
OPERATOR
clause could include a
RECHECK
option\&. This is no longer supported because whether an index operator is
\(lqlossy\(rq
is now determined on\-the\-fly at run time\&. This allows efficient handling of cases where an operator might or might not be lossy\&.
.SH "EXAMPLES"
.PP
The following example command adds cross\-data\-type operators and support functions to an operator family that already contains B\-tree operator classes for data types
int4
and
int2\&.
.sp
.if n \{\
.RS 4
.\}
.nf
ALTER OPERATOR FAMILY integer_ops USING btree ADD
\-\- int4 vs int2
OPERATOR 1 < (int4, int2) ,
OPERATOR 2 <= (int4, int2) ,
OPERATOR 3 = (int4, int2) ,
OPERATOR 4 >= (int4, int2) ,
OPERATOR 5 > (int4, int2) ,
FUNCTION 1 btint42cmp(int4, int2) ,
\-\- int2 vs int4
OPERATOR 1 < (int2, int4) ,
OPERATOR 2 <= (int2, int4) ,
OPERATOR 3 = (int2, int4) ,
OPERATOR 4 >= (int2, int4) ,
OPERATOR 5 > (int2, int4) ,
FUNCTION 1 btint24cmp(int2, int4) ;
.fi
.if n \{\
.RE
.\}
.PP
To remove these entries again:
.sp
.if n \{\
.RS 4
.\}
.nf
ALTER OPERATOR FAMILY integer_ops USING btree DROP
\-\- int4 vs int2
OPERATOR 1 (int4, int2) ,
OPERATOR 2 (int4, int2) ,
OPERATOR 3 (int4, int2) ,
OPERATOR 4 (int4, int2) ,
OPERATOR 5 (int4, int2) ,
FUNCTION 1 (int4, int2) ,
\-\- int2 vs int4
OPERATOR 1 (int2, int4) ,
OPERATOR 2 (int2, int4) ,
OPERATOR 3 (int2, int4) ,
OPERATOR 4 (int2, int4) ,
OPERATOR 5 (int2, int4) ,
FUNCTION 1 (int2, int4) ;
.fi
.if n \{\
.RE
.\}
.SH "COMPATIBILITY"
.PP
There is no
\fBALTER OPERATOR FAMILY\fR
statement in the SQL standard\&.
.SH "SEE ALSO"
CREATE OPERATOR FAMILY (\fBCREATE_OPERATOR_FAMILY\fR(7)), DROP OPERATOR FAMILY (\fBDROP_OPERATOR_FAMILY\fR(7)), CREATE OPERATOR CLASS (\fBCREATE_OPERATOR_CLASS\fR(7)), ALTER OPERATOR CLASS (\fBALTER_OPERATOR_CLASS\fR(7)), DROP OPERATOR CLASS (\fBDROP_OPERATOR_CLASS\fR(7))
man/man7/ALTER_DEFAULT_PRIVILEGES.7 0000644 00000016114 14751153421 0012023 0 ustar 00 '\" t
.\" Title: ALTER DEFAULT PRIVILEGES
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "ALTER DEFAULT PRIVILEGES" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
ALTER_DEFAULT_PRIVILEGES \- define default access privileges
.SH "SYNOPSIS"
.sp
.nf
ALTER DEFAULT PRIVILEGES
[ FOR { ROLE | USER } \fItarget_role\fR [, \&.\&.\&.] ]
[ IN SCHEMA \fIschema_name\fR [, \&.\&.\&.] ]
\fIabbreviated_grant_or_revoke\fR
where \fIabbreviated_grant_or_revoke\fR is one of:
GRANT { { SELECT | INSERT | UPDATE | DELETE | TRUNCATE | REFERENCES | TRIGGER }
[, \&.\&.\&.] | ALL [ PRIVILEGES ] }
ON TABLES
TO { [ GROUP ] \fIrole_name\fR | PUBLIC } [, \&.\&.\&.] [ WITH GRANT OPTION ]
GRANT { { USAGE | SELECT | UPDATE }
[, \&.\&.\&.] | ALL [ PRIVILEGES ] }
ON SEQUENCES
TO { [ GROUP ] \fIrole_name\fR | PUBLIC } [, \&.\&.\&.] [ WITH GRANT OPTION ]
GRANT { EXECUTE | ALL [ PRIVILEGES ] }
ON FUNCTIONS
TO { [ GROUP ] \fIrole_name\fR | PUBLIC } [, \&.\&.\&.] [ WITH GRANT OPTION ]
GRANT { USAGE | ALL [ PRIVILEGES ] }
ON TYPES
TO { [ GROUP ] \fIrole_name\fR | PUBLIC } [, \&.\&.\&.] [ WITH GRANT OPTION ]
REVOKE [ GRANT OPTION FOR ]
{ { SELECT | INSERT | UPDATE | DELETE | TRUNCATE | REFERENCES | TRIGGER }
[, \&.\&.\&.] | ALL [ PRIVILEGES ] }
ON TABLES
FROM { [ GROUP ] \fIrole_name\fR | PUBLIC } [, \&.\&.\&.]
[ CASCADE | RESTRICT ]
REVOKE [ GRANT OPTION FOR ]
{ { USAGE | SELECT | UPDATE }
[, \&.\&.\&.] | ALL [ PRIVILEGES ] }
ON SEQUENCES
FROM { [ GROUP ] \fIrole_name\fR | PUBLIC } [, \&.\&.\&.]
[ CASCADE | RESTRICT ]
REVOKE [ GRANT OPTION FOR ]
{ EXECUTE | ALL [ PRIVILEGES ] }
ON FUNCTIONS
FROM { [ GROUP ] \fIrole_name\fR | PUBLIC } [, \&.\&.\&.]
[ CASCADE | RESTRICT ]
REVOKE [ GRANT OPTION FOR ]
{ USAGE | ALL [ PRIVILEGES ] }
ON TYPES
FROM { [ GROUP ] \fIrole_name\fR | PUBLIC } [, \&.\&.\&.]
[ CASCADE | RESTRICT ]
.fi
.SH "DESCRIPTION"
.PP
\fBALTER DEFAULT PRIVILEGES\fR
allows you to set the privileges that will be applied to objects created in the future\&. (It does not affect privileges assigned to already\-existing objects\&.) Currently, only the privileges for tables (including views and foreign tables), sequences, functions, and types (including domains) can be altered\&.
.PP
You can change default privileges only for objects that will be created by yourself or by roles that you are a member of\&. The privileges can be set globally (i\&.e\&., for all objects created in the current database), or just for objects created in specified schemas\&.
.PP
As explained under
\fBGRANT\fR(7), the default privileges for any object type normally grant all grantable permissions to the object owner, and may grant some privileges to
PUBLIC
as well\&. However, this behavior can be changed by altering the global default privileges with
\fBALTER DEFAULT PRIVILEGES\fR\&.
.PP
Default privileges that are specified per\-schema are added to whatever the global default privileges are for the particular object type\&. This means you cannot revoke privileges per\-schema if they are granted globally (either by default, or according to a previous
\fBALTER DEFAULT PRIVILEGES\fR
command that did not specify a schema)\&. Per\-schema
REVOKE
is only useful to reverse the effects of a previous per\-schema
GRANT\&.
.SS "Parameters"
.PP
\fItarget_role\fR
.RS 4
The name of an existing role of which the current role is a member\&. If
FOR ROLE
is omitted, the current role is assumed\&.
.RE
.PP
\fIschema_name\fR
.RS 4
The name of an existing schema\&. If specified, the default privileges are altered for objects later created in that schema\&. If
IN SCHEMA
is omitted, the global default privileges are altered\&.
.RE
.PP
\fIrole_name\fR
.RS 4
The name of an existing role to grant or revoke privileges for\&. This parameter, and all the other parameters in
\fIabbreviated_grant_or_revoke\fR, act as described under
\fBGRANT\fR(7)
or
\fBREVOKE\fR(7), except that one is setting permissions for a whole class of objects rather than specific named objects\&.
.RE
.SH "NOTES"
.PP
Use
\fBpsql\fR(1)\*(Aqs
\fB\eddp\fR
command to obtain information about existing assignments of default privileges\&. The meaning of the privilege values is the same as explained for
\fB\edp\fR
under
\fBGRANT\fR(7)\&.
.PP
If you wish to drop a role for which the default privileges have been altered, it is necessary to reverse the changes in its default privileges or use
\fBDROP OWNED BY\fR
to get rid of the default privileges entry for the role\&.
.SH "EXAMPLES"
.PP
Grant SELECT privilege to everyone for all tables (and views) you subsequently create in schema
myschema, and allow role
webuser
to INSERT into them too:
.sp
.if n \{\
.RS 4
.\}
.nf
ALTER DEFAULT PRIVILEGES IN SCHEMA myschema GRANT SELECT ON TABLES TO PUBLIC;
ALTER DEFAULT PRIVILEGES IN SCHEMA myschema GRANT INSERT ON TABLES TO webuser;
.fi
.if n \{\
.RE
.\}
.PP
Undo the above, so that subsequently\-created tables won\*(Aqt have any more permissions than normal:
.sp
.if n \{\
.RS 4
.\}
.nf
ALTER DEFAULT PRIVILEGES IN SCHEMA myschema REVOKE SELECT ON TABLES FROM PUBLIC;
ALTER DEFAULT PRIVILEGES IN SCHEMA myschema REVOKE INSERT ON TABLES FROM webuser;
.fi
.if n \{\
.RE
.\}
.PP
Remove the public EXECUTE permission that is normally granted on functions, for all functions subsequently created by role
admin:
.sp
.if n \{\
.RS 4
.\}
.nf
ALTER DEFAULT PRIVILEGES FOR ROLE admin REVOKE EXECUTE ON FUNCTIONS FROM PUBLIC;
.fi
.if n \{\
.RE
.\}
.sp
Note however that you
\fIcannot\fR
accomplish that effect with a command limited to a single schema\&. This command has no effect, unless it is undoing a matching
GRANT:
.sp
.if n \{\
.RS 4
.\}
.nf
ALTER DEFAULT PRIVILEGES IN SCHEMA public REVOKE EXECUTE ON FUNCTIONS FROM PUBLIC;
.fi
.if n \{\
.RE
.\}
.sp
That\*(Aqs because per\-schema default privileges can only add privileges to the global setting, not remove privileges granted by it\&.
.SH "COMPATIBILITY"
.PP
There is no
\fBALTER DEFAULT PRIVILEGES\fR
statement in the SQL standard\&.
.SH "SEE ALSO"
\fBGRANT\fR(7), \fBREVOKE\fR(7)
man/man7/ROLLBACK.7 0000644 00000004137 14751153421 0007452 0 ustar 00 '\" t
.\" Title: ROLLBACK
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "ROLLBACK" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
ROLLBACK \- abort the current transaction
.SH "SYNOPSIS"
.sp
.nf
ROLLBACK [ WORK | TRANSACTION ]
.fi
.SH "DESCRIPTION"
.PP
\fBROLLBACK\fR
rolls back the current transaction and causes all the updates made by the transaction to be discarded\&.
.SH "PARAMETERS"
.PP
WORK
.br
TRANSACTION
.RS 4
Optional key words\&. They have no effect\&.
.RE
.SH "NOTES"
.PP
Use
\fBCOMMIT\fR(7)
to successfully terminate a transaction\&.
.PP
Issuing
\fBROLLBACK\fR
outside of a transaction block emits a warning and otherwise has no effect\&.
.SH "EXAMPLES"
.PP
To abort all changes:
.sp
.if n \{\
.RS 4
.\}
.nf
ROLLBACK;
.fi
.if n \{\
.RE
.\}
.SH "COMPATIBILITY"
.PP
The SQL standard only specifies the two forms
ROLLBACK
and
ROLLBACK WORK\&. Otherwise, this command is fully conforming\&.
.SH "SEE ALSO"
\fBBEGIN\fR(7), \fBCOMMIT\fR(7), ROLLBACK TO SAVEPOINT (\fBROLLBACK_TO_SAVEPOINT\fR(7))
man/man7/CREATE_SEQUENCE.7 0000644 00000023450 14751153421 0010513 0 ustar 00 '\" t
.\" Title: CREATE SEQUENCE
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "CREATE SEQUENCE" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
CREATE_SEQUENCE \- define a new sequence generator
.SH "SYNOPSIS"
.sp
.nf
CREATE [ TEMPORARY | TEMP ] SEQUENCE [ IF NOT EXISTS ] \fIname\fR [ INCREMENT [ BY ] \fIincrement\fR ]
[ MINVALUE \fIminvalue\fR | NO MINVALUE ] [ MAXVALUE \fImaxvalue\fR | NO MAXVALUE ]
[ START [ WITH ] \fIstart\fR ] [ CACHE \fIcache\fR ] [ [ NO ] CYCLE ]
[ OWNED BY { \fItable_name\fR\&.\fIcolumn_name\fR | NONE } ]
.fi
.SH "DESCRIPTION"
.PP
\fBCREATE SEQUENCE\fR
creates a new sequence number generator\&. This involves creating and initializing a new special single\-row table with the name
\fIname\fR\&. The generator will be owned by the user issuing the command\&.
.PP
If a schema name is given then the sequence is created in the specified schema\&. Otherwise it is created in the current schema\&. Temporary sequences exist in a special schema, so a schema name cannot be given when creating a temporary sequence\&. The sequence name must be distinct from the name of any other sequence, table, index, view, or foreign table in the same schema\&.
.PP
After a sequence is created, you use the functions
\fBnextval\fR,
\fBcurrval\fR, and
\fBsetval\fR
to operate on the sequence\&. These functions are documented in
Section 9.16, \(lqSequence Manipulation Functions\(rq, in the documentation\&.
.PP
Although you cannot update a sequence directly, you can use a query like:
.sp
.if n \{\
.RS 4
.\}
.nf
SELECT * FROM \fIname\fR;
.fi
.if n \{\
.RE
.\}
.sp
to examine the parameters and current state of a sequence\&. In particular, the
last_value
field of the sequence shows the last value allocated by any session\&. (Of course, this value might be obsolete by the time it\*(Aqs printed, if other sessions are actively doing
\fBnextval\fR
calls\&.)
.SH "PARAMETERS"
.PP
TEMPORARY or TEMP
.RS 4
If specified, the sequence object is created only for this session, and is automatically dropped on session exit\&. Existing permanent sequences with the same name are not visible (in this session) while the temporary sequence exists, unless they are referenced with schema\-qualified names\&.
.RE
.PP
IF NOT EXISTS
.RS 4
Do not throw an error if a relation with the same name already exists\&. A notice is issued in this case\&. Note that there is no guarantee that the existing relation is anything like the sequence that would have been created \- it might not even be a sequence\&.
.RE
.PP
\fIname\fR
.RS 4
The name (optionally schema\-qualified) of the sequence to be created\&.
.RE
.PP
\fIincrement\fR
.RS 4
The optional clause
INCREMENT BY \fIincrement\fR
specifies which value is added to the current sequence value to create a new value\&. A positive value will make an ascending sequence, a negative one a descending sequence\&. The default value is 1\&.
.RE
.PP
\fIminvalue\fR
.br
NO MINVALUE
.RS 4
The optional clause
MINVALUE \fIminvalue\fR
determines the minimum value a sequence can generate\&. If this clause is not supplied or
\fBNO MINVALUE\fR
is specified, then defaults will be used\&. The defaults are 1 and \-2^63\-1 for ascending and descending sequences, respectively\&.
.RE
.PP
\fImaxvalue\fR
.br
NO MAXVALUE
.RS 4
The optional clause
MAXVALUE \fImaxvalue\fR
determines the maximum value for the sequence\&. If this clause is not supplied or
\fBNO MAXVALUE\fR
is specified, then default values will be used\&. The defaults are 2^63\-1 and \-1 for ascending and descending sequences, respectively\&.
.RE
.PP
\fIstart\fR
.RS 4
The optional clause
START WITH \fIstart\fR
allows the sequence to begin anywhere\&. The default starting value is
\fIminvalue\fR
for ascending sequences and
\fImaxvalue\fR
for descending ones\&.
.RE
.PP
\fIcache\fR
.RS 4
The optional clause
CACHE \fIcache\fR
specifies how many sequence numbers are to be preallocated and stored in memory for faster access\&. The minimum value is 1 (only one value can be generated at a time, i\&.e\&., no cache), and this is also the default\&.
.RE
.PP
CYCLE
.br
NO CYCLE
.RS 4
The
CYCLE
option allows the sequence to wrap around when the
\fImaxvalue\fR
or
\fIminvalue\fR
has been reached by an ascending or descending sequence respectively\&. If the limit is reached, the next number generated will be the
\fIminvalue\fR
or
\fImaxvalue\fR, respectively\&.
.sp
If
NO CYCLE
is specified, any calls to
\fBnextval\fR
after the sequence has reached its maximum value will return an error\&. If neither
CYCLE
or
NO CYCLE
are specified,
NO CYCLE
is the default\&.
.RE
.PP
OWNED BY \fItable_name\fR\&.\fIcolumn_name\fR
.br
OWNED BY NONE
.RS 4
The
OWNED BY
option causes the sequence to be associated with a specific table column, such that if that column (or its whole table) is dropped, the sequence will be automatically dropped as well\&. The specified table must have the same owner and be in the same schema as the sequence\&.
OWNED BY NONE, the default, specifies that there is no such association\&.
.RE
.SH "NOTES"
.PP
Use
\fBDROP SEQUENCE\fR
to remove a sequence\&.
.PP
Sequences are based on
bigint
arithmetic, so the range cannot exceed the range of an eight\-byte integer (\-9223372036854775808 to 9223372036854775807)\&.
.PP
Because
\fBnextval\fR
and
\fBsetval\fR
calls are never rolled back, sequence objects cannot be used if
\(lqgapless\(rq
assignment of sequence numbers is needed\&. It is possible to build gapless assignment by using exclusive locking of a table containing a counter; but this solution is much more expensive than sequence objects, especially if many transactions need sequence numbers concurrently\&.
.PP
Unexpected results might be obtained if a
\fIcache\fR
setting greater than one is used for a sequence object that will be used concurrently by multiple sessions\&. Each session will allocate and cache successive sequence values during one access to the sequence object and increase the sequence object\*(Aqs
last_value
accordingly\&. Then, the next
\fIcache\fR\-1 uses of
\fBnextval\fR
within that session simply return the preallocated values without touching the sequence object\&. So, any numbers allocated but not used within a session will be lost when that session ends, resulting in
\(lqholes\(rq
in the sequence\&.
.PP
Furthermore, although multiple sessions are guaranteed to allocate distinct sequence values, the values might be generated out of sequence when all the sessions are considered\&. For example, with a
\fIcache\fR
setting of 10, session A might reserve values 1\&.\&.10 and return
\fBnextval\fR=1, then session B might reserve values 11\&.\&.20 and return
\fBnextval\fR=11 before session A has generated
nextval=2\&. Thus, with a
\fIcache\fR
setting of one it is safe to assume that
\fBnextval\fR
values are generated sequentially; with a
\fIcache\fR
setting greater than one you should only assume that the
\fBnextval\fR
values are all distinct, not that they are generated purely sequentially\&. Also,
last_value
will reflect the latest value reserved by any session, whether or not it has yet been returned by
\fBnextval\fR\&.
.PP
Another consideration is that a
\fBsetval\fR
executed on such a sequence will not be noticed by other sessions until they have used up any preallocated values they have cached\&.
.SH "EXAMPLES"
.PP
Create an ascending sequence called
serial, starting at 101:
.sp
.if n \{\
.RS 4
.\}
.nf
CREATE SEQUENCE serial START 101;
.fi
.if n \{\
.RE
.\}
.PP
Select the next number from this sequence:
.sp
.if n \{\
.RS 4
.\}
.nf
SELECT nextval(\*(Aqserial\*(Aq);
nextval
\-\-\-\-\-\-\-\-\-
101
.fi
.if n \{\
.RE
.\}
.PP
Select the next number from this sequence:
.sp
.if n \{\
.RS 4
.\}
.nf
SELECT nextval(\*(Aqserial\*(Aq);
nextval
\-\-\-\-\-\-\-\-\-
102
.fi
.if n \{\
.RE
.\}
.PP
Use this sequence in an
\fBINSERT\fR
command:
.sp
.if n \{\
.RS 4
.\}
.nf
INSERT INTO distributors VALUES (nextval(\*(Aqserial\*(Aq), \*(Aqnothing\*(Aq);
.fi
.if n \{\
.RE
.\}
.PP
Update the sequence value after a
\fBCOPY FROM\fR:
.sp
.if n \{\
.RS 4
.\}
.nf
BEGIN;
COPY distributors FROM \*(Aqinput_file\*(Aq;
SELECT setval(\*(Aqserial\*(Aq, max(id)) FROM distributors;
END;
.fi
.if n \{\
.RE
.\}
.SH "COMPATIBILITY"
.PP
\fBCREATE SEQUENCE\fR
conforms to the
SQL
standard, with the following exceptions:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
The standard\*(Aqs
AS \fIdata_type\fR
expression is not supported\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Obtaining the next value is done using the
\fBnextval()\fR
function instead of the standard\*(Aqs
\fBNEXT VALUE FOR\fR
expression\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
The
OWNED BY
clause is a
PostgreSQL
extension\&.
.RE
.SH "SEE ALSO"
ALTER SEQUENCE (\fBALTER_SEQUENCE\fR(7)), DROP SEQUENCE (\fBDROP_SEQUENCE\fR(7))
man/man7/SELECT_INTO.7 0000644 00000010557 14751153421 0010074 0 ustar 00 '\" t
.\" Title: SELECT INTO
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "SELECT INTO" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
SELECT_INTO \- define a new table from the results of a query
.SH "SYNOPSIS"
.sp
.nf
[ WITH [ RECURSIVE ] \fIwith_query\fR [, \&.\&.\&.] ]
SELECT [ ALL | DISTINCT [ ON ( \fIexpression\fR [, \&.\&.\&.] ) ] ]
* | \fIexpression\fR [ [ AS ] \fIoutput_name\fR ] [, \&.\&.\&.]
INTO [ TEMPORARY | TEMP | UNLOGGED ] [ TABLE ] \fInew_table\fR
[ FROM \fIfrom_item\fR [, \&.\&.\&.] ]
[ WHERE \fIcondition\fR ]
[ GROUP BY \fIexpression\fR [, \&.\&.\&.] ]
[ HAVING \fIcondition\fR ]
[ WINDOW \fIwindow_name\fR AS ( \fIwindow_definition\fR ) [, \&.\&.\&.] ]
[ { UNION | INTERSECT | EXCEPT } [ ALL | DISTINCT ] \fIselect\fR ]
[ ORDER BY \fIexpression\fR [ ASC | DESC | USING \fIoperator\fR ] [ NULLS { FIRST | LAST } ] [, \&.\&.\&.] ]
[ LIMIT { \fIcount\fR | ALL } ]
[ OFFSET \fIstart\fR [ ROW | ROWS ] ]
[ FETCH { FIRST | NEXT } [ \fIcount\fR ] { ROW | ROWS } ONLY ]
[ FOR { UPDATE | SHARE } [ OF \fItable_name\fR [, \&.\&.\&.] ] [ NOWAIT ] [\&.\&.\&.] ]
.fi
.SH "DESCRIPTION"
.PP
\fBSELECT INTO\fR
creates a new table and fills it with data computed by a query\&. The data is not returned to the client, as it is with a normal
\fBSELECT\fR\&. The new table\*(Aqs columns have the names and data types associated with the output columns of the
\fBSELECT\fR\&.
.SH "PARAMETERS"
.PP
TEMPORARY or TEMP
.RS 4
If specified, the table is created as a temporary table\&. Refer to
CREATE TABLE (\fBCREATE_TABLE\fR(7))
for details\&.
.RE
.PP
UNLOGGED
.RS 4
If specified, the table is created as an unlogged table\&. Refer to
CREATE TABLE (\fBCREATE_TABLE\fR(7))
for details\&.
.RE
.PP
\fInew_table\fR
.RS 4
The name (optionally schema\-qualified) of the table to be created\&.
.RE
.PP
All other parameters are described in detail under
\fBSELECT\fR(7)\&.
.SH "NOTES"
.PP
CREATE TABLE AS (\fBCREATE_TABLE_AS\fR(7))
is functionally similar to
\fBSELECT INTO\fR\&.
\fBCREATE TABLE AS\fR
is the recommended syntax, since this form of
\fBSELECT INTO\fR
is not available in
ECPG
or
PL/pgSQL, because they interpret the
INTO
clause differently\&. Furthermore,
\fBCREATE TABLE AS\fR
offers a superset of the functionality provided by
\fBSELECT INTO\fR\&.
.PP
To add OIDs to the table created by
\fBSELECT INTO\fR, enable the
default_with_oids
configuration variable\&. Alternatively,
\fBCREATE TABLE AS\fR
can be used with the
WITH OIDS
clause\&.
.SH "EXAMPLES"
.PP
Create a new table
films_recent
consisting of only recent entries from the table
films:
.sp
.if n \{\
.RS 4
.\}
.nf
SELECT * INTO films_recent FROM films WHERE date_prod >= \*(Aq2002\-01\-01\*(Aq;
.fi
.if n \{\
.RE
.\}
.SH "COMPATIBILITY"
.PP
The SQL standard uses
\fBSELECT INTO\fR
to represent selecting values into scalar variables of a host program, rather than creating a new table\&. This indeed is the usage found in
ECPG
(see
Chapter 34, ECPG - Embedded SQL in C, in the documentation) and
PL/pgSQL
(see
Chapter 41, PL/pgSQL - SQL Procedural Language, in the documentation)\&. The
PostgreSQL
usage of
\fBSELECT INTO\fR
to represent table creation is historical\&. It is best to use
\fBCREATE TABLE AS\fR
for this purpose in new code\&.
.SH "SEE ALSO"
CREATE TABLE AS (\fBCREATE_TABLE_AS\fR(7))
man/man7/PREPARE.7 0000644 00000020341 14751153421 0007352 0 ustar 00 '\" t
.\" Title: PREPARE
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "PREPARE" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
PREPARE \- prepare a statement for execution
.SH "SYNOPSIS"
.sp
.nf
PREPARE \fIname\fR [ ( \fIdata_type\fR [, \&.\&.\&.] ) ] AS \fIstatement\fR
.fi
.SH "DESCRIPTION"
.PP
\fBPREPARE\fR
creates a prepared statement\&. A prepared statement is a server\-side object that can be used to optimize performance\&. When the
\fBPREPARE\fR
statement is executed, the specified statement is parsed, analyzed, and rewritten\&. When an
\fBEXECUTE\fR
command is subsequently issued, the prepared statement is planned and executed\&. This division of labor avoids repetitive parse analysis work, while allowing the execution plan to depend on the specific parameter values supplied\&.
.PP
Prepared statements can take parameters: values that are substituted into the statement when it is executed\&. When creating the prepared statement, refer to parameters by position, using
$1,
$2, etc\&. A corresponding list of parameter data types can optionally be specified\&. When a parameter\*(Aqs data type is not specified or is declared as
unknown, the type is inferred from the context in which the parameter is first used (if possible)\&. When executing the statement, specify the actual values for these parameters in the
\fBEXECUTE\fR
statement\&. Refer to
\fBEXECUTE\fR(7)
for more information about that\&.
.PP
Prepared statements only last for the duration of the current database session\&. When the session ends, the prepared statement is forgotten, so it must be recreated before being used again\&. This also means that a single prepared statement cannot be used by multiple simultaneous database clients; however, each client can create their own prepared statement to use\&. Prepared statements can be manually cleaned up using the
\fBDEALLOCATE\fR(7)
command\&.
.PP
Prepared statements potentially have the largest performance advantage when a single session is being used to execute a large number of similar statements\&. The performance difference will be particularly significant if the statements are complex to plan or rewrite, e\&.g\&., if the query involves a join of many tables or requires the application of several rules\&. If the statement is relatively simple to plan and rewrite but relatively expensive to execute, the performance advantage of prepared statements will be less noticeable\&.
.SH "PARAMETERS"
.PP
\fIname\fR
.RS 4
An arbitrary name given to this particular prepared statement\&. It must be unique within a single session and is subsequently used to execute or deallocate a previously prepared statement\&.
.RE
.PP
\fIdata_type\fR
.RS 4
The data type of a parameter to the prepared statement\&. If the data type of a particular parameter is unspecified or is specified as
unknown, it will be inferred from the context in which the parameter is first used\&. To refer to the parameters in the prepared statement itself, use
$1,
$2, etc\&.
.RE
.PP
\fIstatement\fR
.RS 4
Any
\fBSELECT\fR,
\fBINSERT\fR,
\fBUPDATE\fR,
\fBDELETE\fR, or
\fBVALUES\fR
statement\&.
.RE
.SH "NOTES"
.PP
Prepared statements can use generic plans rather than re\-planning with each set of supplied
\fBEXECUTE\fR
values\&. This occurs immediately for prepared statements with no parameters; otherwise it occurs only after five or more executions produce plans whose estimated cost average (including planning overhead) is more expensive than the generic plan cost estimate\&. Once a generic plan is chosen, it is used for the remaining lifetime of the prepared statement\&. Using
\fBEXECUTE\fR
values which are rare in columns with many duplicates can generate custom plans that are so much cheaper than the generic plan, even after adding planning overhead, that the generic plan might never be used\&.
.PP
A generic plan assumes that each value supplied to
\fBEXECUTE\fR
is one of the column\*(Aqs distinct values and that column values are uniformly distributed\&. For example, if statistics record three distinct column values, a generic plan assumes a column equality comparison will match 33% of processed rows\&. Column statistics also allow generic plans to accurately compute the selectivity of unique columns\&. Comparisons on non\-uniformly\-distributed columns and specification of non\-existent values affects the average plan cost, and hence if and when a generic plan is chosen\&.
.PP
To examine the query plan
PostgreSQL
is using for a prepared statement, use
\fBEXPLAIN\fR(7), e\&.g\&.,
\fBEXPLAIN EXECUTE\fR\&. If a generic plan is in use, it will contain parameter symbols
$\fIn\fR, while a custom plan will have the supplied parameter values substituted into it\&. The row estimates in the generic plan reflect the selectivity computed for the parameters\&.
.PP
For more information on query planning and the statistics collected by
PostgreSQL
for that purpose, see the
\fBANALYZE\fR(7)
documentation\&.
.PP
Although the main point of a prepared statement is to avoid repeated parse analysis and planning of the statement,
PostgreSQL
will force re\-analysis and re\-planning of the statement before using it whenever database objects used in the statement have undergone definitional (DDL) changes since the previous use of the prepared statement\&. Also, if the value of
search_path
changes from one use to the next, the statement will be re\-parsed using the new
\fIsearch_path\fR\&. (This latter behavior is new as of
PostgreSQL
9\&.3\&.) These rules make use of a prepared statement semantically almost equivalent to re\-submitting the same query text over and over, but with a performance benefit if no object definitions are changed, especially if the best plan remains the same across uses\&. An example of a case where the semantic equivalence is not perfect is that if the statement refers to a table by an unqualified name, and then a new table of the same name is created in a schema appearing earlier in the
\fIsearch_path\fR, no automatic re\-parse will occur since no object used in the statement changed\&. However, if some other change forces a re\-parse, the new table will be referenced in subsequent uses\&.
.PP
You can see all prepared statements available in the session by querying the
pg_prepared_statements
system view\&.
.SH "EXAMPLES"
.PP
Create a prepared statement for an
\fBINSERT\fR
statement, and then execute it:
.sp
.if n \{\
.RS 4
.\}
.nf
PREPARE fooplan (int, text, bool, numeric) AS
INSERT INTO foo VALUES($1, $2, $3, $4);
EXECUTE fooplan(1, \*(AqHunter Valley\*(Aq, \*(Aqt\*(Aq, 200\&.00);
.fi
.if n \{\
.RE
.\}
.PP
Create a prepared statement for a
\fBSELECT\fR
statement, and then execute it:
.sp
.if n \{\
.RS 4
.\}
.nf
PREPARE usrrptplan (int) AS
SELECT * FROM users u, logs l WHERE u\&.usrid=$1 AND u\&.usrid=l\&.usrid
AND l\&.date = $2;
EXECUTE usrrptplan(1, current_date);
.fi
.if n \{\
.RE
.\}
.sp
Note that the data type of the second parameter is not specified, so it is inferred from the context in which
$2
is used\&.
.SH "COMPATIBILITY"
.PP
The SQL standard includes a
\fBPREPARE\fR
statement, but it is only for use in embedded SQL\&. This version of the
\fBPREPARE\fR
statement also uses a somewhat different syntax\&.
.SH "SEE ALSO"
\fBDEALLOCATE\fR(7), \fBEXECUTE\fR(7)
man/man7/ALTER_AGGREGATE.7 0000644 00000011742 14751153421 0010476 0 ustar 00 '\" t
.\" Title: ALTER AGGREGATE
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "ALTER AGGREGATE" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
ALTER_AGGREGATE \- change the definition of an aggregate function
.SH "SYNOPSIS"
.sp
.nf
ALTER AGGREGATE \fIname\fR ( \fIaggregate_signature\fR ) RENAME TO \fInew_name\fR
ALTER AGGREGATE \fIname\fR ( \fIaggregate_signature\fR )
OWNER TO { \fInew_owner\fR | CURRENT_USER | SESSION_USER }
ALTER AGGREGATE \fIname\fR ( \fIaggregate_signature\fR ) SET SCHEMA \fInew_schema\fR
where \fIaggregate_signature\fR is:
* |
[ \fIargmode\fR ] [ \fIargname\fR ] \fIargtype\fR [ , \&.\&.\&. ] |
[ [ \fIargmode\fR ] [ \fIargname\fR ] \fIargtype\fR [ , \&.\&.\&. ] ] ORDER BY [ \fIargmode\fR ] [ \fIargname\fR ] \fIargtype\fR [ , \&.\&.\&. ]
.fi
.SH "DESCRIPTION"
.PP
\fBALTER AGGREGATE\fR
changes the definition of an aggregate function\&.
.PP
You must own the aggregate function to use
\fBALTER AGGREGATE\fR\&. To change the schema of an aggregate function, you must also have
CREATE
privilege on the new schema\&. To alter the owner, you must also be a direct or indirect member of the new owning role, and that role must have
CREATE
privilege on the aggregate function\*(Aqs schema\&. (These restrictions enforce that altering the owner doesn\*(Aqt do anything you couldn\*(Aqt do by dropping and recreating the aggregate function\&. However, a superuser can alter ownership of any aggregate function anyway\&.)
.SH "PARAMETERS"
.PP
\fIname\fR
.RS 4
The name (optionally schema\-qualified) of an existing aggregate function\&.
.RE
.PP
\fIargmode\fR
.RS 4
The mode of an argument:
IN
or
VARIADIC\&. If omitted, the default is
IN\&.
.RE
.PP
\fIargname\fR
.RS 4
The name of an argument\&. Note that
\fBALTER AGGREGATE\fR
does not actually pay any attention to argument names, since only the argument data types are needed to determine the aggregate function\*(Aqs identity\&.
.RE
.PP
\fIargtype\fR
.RS 4
An input data type on which the aggregate function operates\&. To reference a zero\-argument aggregate function, write
*
in place of the list of argument specifications\&. To reference an ordered\-set aggregate function, write
ORDER BY
between the direct and aggregated argument specifications\&.
.RE
.PP
\fInew_name\fR
.RS 4
The new name of the aggregate function\&.
.RE
.PP
\fInew_owner\fR
.RS 4
The new owner of the aggregate function\&.
.RE
.PP
\fInew_schema\fR
.RS 4
The new schema for the aggregate function\&.
.RE
.SH "NOTES"
.PP
The recommended syntax for referencing an ordered\-set aggregate is to write
ORDER BY
between the direct and aggregated argument specifications, in the same style as in
CREATE AGGREGATE (\fBCREATE_AGGREGATE\fR(7))\&. However, it will also work to omit
ORDER BY
and just run the direct and aggregated argument specifications into a single list\&. In this abbreviated form, if
VARIADIC "any"
was used in both the direct and aggregated argument lists, write
VARIADIC "any"
only once\&.
.SH "EXAMPLES"
.PP
To rename the aggregate function
myavg
for type
integer
to
my_average:
.sp
.if n \{\
.RS 4
.\}
.nf
ALTER AGGREGATE myavg(integer) RENAME TO my_average;
.fi
.if n \{\
.RE
.\}
.PP
To change the owner of the aggregate function
myavg
for type
integer
to
joe:
.sp
.if n \{\
.RS 4
.\}
.nf
ALTER AGGREGATE myavg(integer) OWNER TO joe;
.fi
.if n \{\
.RE
.\}
.PP
To move the ordered\-set aggregate
mypercentile
with direct argument of type
float8
and aggregated argument of type
integer
into schema
myschema:
.sp
.if n \{\
.RS 4
.\}
.nf
ALTER AGGREGATE mypercentile(float8 ORDER BY integer) SET SCHEMA myschema;
.fi
.if n \{\
.RE
.\}
.sp
This will work too:
.sp
.if n \{\
.RS 4
.\}
.nf
ALTER AGGREGATE mypercentile(float8, integer) SET SCHEMA myschema;
.fi
.if n \{\
.RE
.\}
.sp
.SH "COMPATIBILITY"
.PP
There is no
\fBALTER AGGREGATE\fR
statement in the SQL standard\&.
.SH "SEE ALSO"
CREATE AGGREGATE (\fBCREATE_AGGREGATE\fR(7)), DROP AGGREGATE (\fBDROP_AGGREGATE\fR(7))
man/man7/ALTER_TEXT_SEARCH_DICTIONARY.7 0000644 00000010030 14751153421 0012533 0 ustar 00 '\" t
.\" Title: ALTER TEXT SEARCH DICTIONARY
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "ALTER TEXT SEARCH DICTIONARY" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
ALTER_TEXT_SEARCH_DICTIONARY \- change the definition of a text search dictionary
.SH "SYNOPSIS"
.sp
.nf
ALTER TEXT SEARCH DICTIONARY \fIname\fR (
\fIoption\fR [ = \fIvalue\fR ] [, \&.\&.\&. ]
)
ALTER TEXT SEARCH DICTIONARY \fIname\fR RENAME TO \fInew_name\fR
ALTER TEXT SEARCH DICTIONARY \fIname\fR OWNER TO { \fInew_owner\fR | CURRENT_USER | SESSION_USER }
ALTER TEXT SEARCH DICTIONARY \fIname\fR SET SCHEMA \fInew_schema\fR
.fi
.SH "DESCRIPTION"
.PP
\fBALTER TEXT SEARCH DICTIONARY\fR
changes the definition of a text search dictionary\&. You can change the dictionary\*(Aqs template\-specific options, or change the dictionary\*(Aqs name or owner\&.
.PP
You must be the owner of the dictionary to use
\fBALTER TEXT SEARCH DICTIONARY\fR\&.
.SH "PARAMETERS"
.PP
\fIname\fR
.RS 4
The name (optionally schema\-qualified) of an existing text search dictionary\&.
.RE
.PP
\fIoption\fR
.RS 4
The name of a template\-specific option to be set for this dictionary\&.
.RE
.PP
\fIvalue\fR
.RS 4
The new value to use for a template\-specific option\&. If the equal sign and value are omitted, then any previous setting for the option is removed from the dictionary, allowing the default to be used\&.
.RE
.PP
\fInew_name\fR
.RS 4
The new name of the text search dictionary\&.
.RE
.PP
\fInew_owner\fR
.RS 4
The new owner of the text search dictionary\&.
.RE
.PP
\fInew_schema\fR
.RS 4
The new schema for the text search dictionary\&.
.RE
.PP
Template\-specific options can appear in any order\&.
.SH "EXAMPLES"
.PP
The following example command changes the stopword list for a Snowball\-based dictionary\&. Other parameters remain unchanged\&.
.sp
.if n \{\
.RS 4
.\}
.nf
ALTER TEXT SEARCH DICTIONARY my_dict ( StopWords = newrussian );
.fi
.if n \{\
.RE
.\}
.PP
The following example command changes the language option to
dutch, and removes the stopword option entirely\&.
.sp
.if n \{\
.RS 4
.\}
.nf
ALTER TEXT SEARCH DICTIONARY my_dict ( language = dutch, StopWords );
.fi
.if n \{\
.RE
.\}
.PP
The following example command
\(lqupdates\(rq
the dictionary\*(Aqs definition without actually changing anything\&.
.sp
.if n \{\
.RS 4
.\}
.nf
ALTER TEXT SEARCH DICTIONARY my_dict ( dummy );
.fi
.if n \{\
.RE
.\}
.sp
(The reason this works is that the option removal code doesn\*(Aqt complain if there is no such option\&.) This trick is useful when changing configuration files for the dictionary: the
\fBALTER\fR
will force existing database sessions to re\-read the configuration files, which otherwise they would never do if they had read them earlier\&.
.SH "COMPATIBILITY"
.PP
There is no
\fBALTER TEXT SEARCH DICTIONARY\fR
statement in the SQL standard\&.
.SH "SEE ALSO"
CREATE TEXT SEARCH DICTIONARY (\fBCREATE_TEXT_SEARCH_DICTIONARY\fR(7)), DROP TEXT SEARCH DICTIONARY (\fBDROP_TEXT_SEARCH_DICTIONARY\fR(7))
man/man7/DROP_USER_MAPPING.7 0000644 00000005100 14751153421 0011025 0 ustar 00 '\" t
.\" Title: DROP USER MAPPING
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "DROP USER MAPPING" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
DROP_USER_MAPPING \- remove a user mapping for a foreign server
.SH "SYNOPSIS"
.sp
.nf
DROP USER MAPPING [ IF EXISTS ] FOR { \fIuser_name\fR | USER | CURRENT_USER | PUBLIC } SERVER \fIserver_name\fR
.fi
.SH "DESCRIPTION"
.PP
\fBDROP USER MAPPING\fR
removes an existing user mapping from foreign server\&.
.PP
The owner of a foreign server can drop user mappings for that server for any user\&. Also, a user can drop a user mapping for their own user name if
USAGE
privilege on the server has been granted to the user\&.
.SH "PARAMETERS"
.PP
IF EXISTS
.RS 4
Do not throw an error if the user mapping does not exist\&. A notice is issued in this case\&.
.RE
.PP
\fIuser_name\fR
.RS 4
User name of the mapping\&.
CURRENT_USER
and
USER
match the name of the current user\&.
PUBLIC
is used to match all present and future user names in the system\&.
.RE
.PP
\fIserver_name\fR
.RS 4
Server name of the user mapping\&.
.RE
.SH "EXAMPLES"
.PP
Drop a user mapping
bob, server
foo
if it exists:
.sp
.if n \{\
.RS 4
.\}
.nf
DROP USER MAPPING IF EXISTS FOR bob SERVER foo;
.fi
.if n \{\
.RE
.\}
.SH "COMPATIBILITY"
.PP
\fBDROP USER MAPPING\fR
conforms to ISO/IEC 9075\-9 (SQL/MED)\&. The
IF EXISTS
clause is a
PostgreSQL
extension\&.
.SH "SEE ALSO"
CREATE USER MAPPING (\fBCREATE_USER_MAPPING\fR(7)), ALTER USER MAPPING (\fBALTER_USER_MAPPING\fR(7))
man/man7/ALTER_TEXT_SEARCH_PARSER.7 0000644 00000004354 14751153421 0012076 0 ustar 00 '\" t
.\" Title: ALTER TEXT SEARCH PARSER
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "ALTER TEXT SEARCH PARSER" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
ALTER_TEXT_SEARCH_PARSER \- change the definition of a text search parser
.SH "SYNOPSIS"
.sp
.nf
ALTER TEXT SEARCH PARSER \fIname\fR RENAME TO \fInew_name\fR
ALTER TEXT SEARCH PARSER \fIname\fR SET SCHEMA \fInew_schema\fR
.fi
.SH "DESCRIPTION"
.PP
\fBALTER TEXT SEARCH PARSER\fR
changes the definition of a text search parser\&. Currently, the only supported functionality is to change the parser\*(Aqs name\&.
.PP
You must be a superuser to use
\fBALTER TEXT SEARCH PARSER\fR\&.
.SH "PARAMETERS"
.PP
\fIname\fR
.RS 4
The name (optionally schema\-qualified) of an existing text search parser\&.
.RE
.PP
\fInew_name\fR
.RS 4
The new name of the text search parser\&.
.RE
.PP
\fInew_schema\fR
.RS 4
The new schema for the text search parser\&.
.RE
.SH "COMPATIBILITY"
.PP
There is no
\fBALTER TEXT SEARCH PARSER\fR
statement in the SQL standard\&.
.SH "SEE ALSO"
CREATE TEXT SEARCH PARSER (\fBCREATE_TEXT_SEARCH_PARSER\fR(7)), DROP TEXT SEARCH PARSER (\fBDROP_TEXT_SEARCH_PARSER\fR(7))
man/man7/CREATE_RULE.7 0000644 00000021206 14751153421 0010047 0 ustar 00 '\" t
.\" Title: CREATE RULE
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "CREATE RULE" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
CREATE_RULE \- define a new rewrite rule
.SH "SYNOPSIS"
.sp
.nf
CREATE [ OR REPLACE ] RULE \fIname\fR AS ON \fIevent\fR
TO \fItable_name\fR [ WHERE \fIcondition\fR ]
DO [ ALSO | INSTEAD ] { NOTHING | \fIcommand\fR | ( \fIcommand\fR ; \fIcommand\fR \&.\&.\&. ) }
where \fIevent\fR can be one of:
SELECT | INSERT | UPDATE | DELETE
.fi
.SH "DESCRIPTION"
.PP
\fBCREATE RULE\fR
defines a new rule applying to a specified table or view\&.
\fBCREATE OR REPLACE RULE\fR
will either create a new rule, or replace an existing rule of the same name for the same table\&.
.PP
The
PostgreSQL
rule system allows one to define an alternative action to be performed on insertions, updates, or deletions in database tables\&. Roughly speaking, a rule causes additional commands to be executed when a given command on a given table is executed\&. Alternatively, an
INSTEAD
rule can replace a given command by another, or cause a command not to be executed at all\&. Rules are used to implement SQL views as well\&. It is important to realize that a rule is really a command transformation mechanism, or command macro\&. The transformation happens before the execution of the command starts\&. If you actually want an operation that fires independently for each physical row, you probably want to use a trigger, not a rule\&. More information about the rules system is in
Chapter 39, The Rule System, in the documentation\&.
.PP
Presently,
ON SELECT
rules must be unconditional
INSTEAD
rules and must have actions that consist of a single
\fBSELECT\fR
command\&. Thus, an
ON SELECT
rule effectively turns the table into a view, whose visible contents are the rows returned by the rule\*(Aqs
\fBSELECT\fR
command rather than whatever had been stored in the table (if anything)\&. It is considered better style to write a
\fBCREATE VIEW\fR
command than to create a real table and define an
ON SELECT
rule for it\&.
.PP
You can create the illusion of an updatable view by defining
ON INSERT,
ON UPDATE, and
ON DELETE
rules (or any subset of those that\*(Aqs sufficient for your purposes) to replace update actions on the view with appropriate updates on other tables\&. If you want to support
\fBINSERT RETURNING\fR
and so on, then be sure to put a suitable
RETURNING
clause into each of these rules\&.
.PP
There is a catch if you try to use conditional rules for complex view updates: there
\fImust\fR
be an unconditional
INSTEAD
rule for each action you wish to allow on the view\&. If the rule is conditional, or is not
INSTEAD, then the system will still reject attempts to perform the update action, because it thinks it might end up trying to perform the action on the dummy table of the view in some cases\&. If you want to handle all the useful cases in conditional rules, add an unconditional
DO INSTEAD NOTHING
rule to ensure that the system understands it will never be called on to update the dummy table\&. Then make the conditional rules non\-INSTEAD; in the cases where they are applied, they add to the default
INSTEAD NOTHING
action\&. (This method does not currently work to support
RETURNING
queries, however\&.)
.if n \{\
.sp
.\}
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBNote\fR
.ps -1
.br
.PP
A view that is simple enough to be automatically updatable (see
CREATE VIEW (\fBCREATE_VIEW\fR(7))) does not require a user\-created rule in order to be updatable\&. While you can create an explicit rule anyway, the automatic update transformation will generally outperform an explicit rule\&.
.PP
Another alternative worth considering is to use
INSTEAD OF
triggers (see
CREATE TRIGGER (\fBCREATE_TRIGGER\fR(7))) in place of rules\&.
.sp .5v
.RE
.SH "PARAMETERS"
.PP
\fIname\fR
.RS 4
The name of a rule to create\&. This must be distinct from the name of any other rule for the same table\&. Multiple rules on the same table and same event type are applied in alphabetical name order\&.
.RE
.PP
\fIevent\fR
.RS 4
The event is one of
SELECT,
INSERT,
UPDATE, or
DELETE\&. Note that an
\fBINSERT\fR
containing an
ON CONFLICT
clause cannot be used on tables that have either
INSERT
or
UPDATE
rules\&. Consider using an updatable view instead\&.
.RE
.PP
\fItable_name\fR
.RS 4
The name (optionally schema\-qualified) of the table or view the rule applies to\&.
.RE
.PP
\fIcondition\fR
.RS 4
Any
SQL
conditional expression (returning
boolean)\&. The condition expression cannot refer to any tables except
NEW
and
OLD, and cannot contain aggregate functions\&.
.RE
.PP
\fBINSTEAD\fR
.RS 4
INSTEAD
indicates that the commands should be executed
\fIinstead of\fR
the original command\&.
.RE
.PP
\fBALSO\fR
.RS 4
ALSO
indicates that the commands should be executed
\fIin addition to\fR
the original command\&.
.sp
If neither
ALSO
nor
INSTEAD
is specified,
ALSO
is the default\&.
.RE
.PP
\fIcommand\fR
.RS 4
The command or commands that make up the rule action\&. Valid commands are
\fBSELECT\fR,
\fBINSERT\fR,
\fBUPDATE\fR,
\fBDELETE\fR, or
\fBNOTIFY\fR\&.
.RE
.PP
Within
\fIcondition\fR
and
\fIcommand\fR, the special table names
NEW
and
OLD
can be used to refer to values in the referenced table\&.
NEW
is valid in
ON INSERT
and
ON UPDATE
rules to refer to the new row being inserted or updated\&.
OLD
is valid in
ON UPDATE
and
ON DELETE
rules to refer to the existing row being updated or deleted\&.
.SH "NOTES"
.PP
You must be the owner of a table to create or change rules for it\&.
.PP
In a rule for
INSERT,
UPDATE, or
DELETE
on a view, you can add a
RETURNING
clause that emits the view\*(Aqs columns\&. This clause will be used to compute the outputs if the rule is triggered by an
\fBINSERT RETURNING\fR,
\fBUPDATE RETURNING\fR, or
\fBDELETE RETURNING\fR
command respectively\&. When the rule is triggered by a command without
RETURNING, the rule\*(Aqs
RETURNING
clause will be ignored\&. The current implementation allows only unconditional
INSTEAD
rules to contain
RETURNING; furthermore there can be at most one
RETURNING
clause among all the rules for the same event\&. (This ensures that there is only one candidate
RETURNING
clause to be used to compute the results\&.)
RETURNING
queries on the view will be rejected if there is no
RETURNING
clause in any available rule\&.
.PP
It is very important to take care to avoid circular rules\&. For example, though each of the following two rule definitions are accepted by
PostgreSQL, the
\fBSELECT\fR
command would cause
PostgreSQL
to report an error because of recursive expansion of a rule:
.sp
.if n \{\
.RS 4
.\}
.nf
CREATE RULE "_RETURN" AS
ON SELECT TO t1
DO INSTEAD
SELECT * FROM t2;
CREATE RULE "_RETURN" AS
ON SELECT TO t2
DO INSTEAD
SELECT * FROM t1;
SELECT * FROM t1;
.fi
.if n \{\
.RE
.\}
.PP
Presently, if a rule action contains a
\fBNOTIFY\fR
command, the
\fBNOTIFY\fR
command will be executed unconditionally, that is, the
\fBNOTIFY\fR
will be issued even if there are not any rows that the rule should apply to\&. For example, in:
.sp
.if n \{\
.RS 4
.\}
.nf
CREATE RULE notify_me AS ON UPDATE TO mytable DO ALSO NOTIFY mytable;
UPDATE mytable SET name = \*(Aqfoo\*(Aq WHERE id = 42;
.fi
.if n \{\
.RE
.\}
.sp
one
\fBNOTIFY\fR
event will be sent during the
\fBUPDATE\fR, whether or not there are any rows that match the condition
id = 42\&. This is an implementation restriction that might be fixed in future releases\&.
.SH "COMPATIBILITY"
.PP
\fBCREATE RULE\fR
is a
PostgreSQL
language extension, as is the entire query rewrite system\&.
.SH "SEE ALSO"
ALTER RULE (\fBALTER_RULE\fR(7)), DROP RULE (\fBDROP_RULE\fR(7))
man/man7/CREATE_TABLE.7 0000644 00000124674 14751153421 0010144 0 ustar 00 '\" t
.\" Title: CREATE TABLE
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "CREATE TABLE" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
CREATE_TABLE \- define a new table
.SH "SYNOPSIS"
.sp
.nf
CREATE [ [ GLOBAL | LOCAL ] { TEMPORARY | TEMP } | UNLOGGED ] TABLE [ IF NOT EXISTS ] \fItable_name\fR ( [
{ \fIcolumn_name\fR \fIdata_type\fR [ COLLATE \fIcollation\fR ] [ \fIcolumn_constraint\fR [ \&.\&.\&. ] ]
| \fItable_constraint\fR
| LIKE \fIsource_table\fR [ \fIlike_option\fR \&.\&.\&. ] }
[, \&.\&.\&. ]
] )
[ INHERITS ( \fIparent_table\fR [, \&.\&.\&. ] ) ]
[ WITH ( \fIstorage_parameter\fR [= \fIvalue\fR] [, \&.\&.\&. ] ) | WITH OIDS | WITHOUT OIDS ]
[ ON COMMIT { PRESERVE ROWS | DELETE ROWS | DROP } ]
[ TABLESPACE \fItablespace_name\fR ]
CREATE [ [ GLOBAL | LOCAL ] { TEMPORARY | TEMP } | UNLOGGED ] TABLE [ IF NOT EXISTS ] \fItable_name\fR
OF \fItype_name\fR [ (
{ \fIcolumn_name\fR WITH OPTIONS [ \fIcolumn_constraint\fR [ \&.\&.\&. ] ]
| \fItable_constraint\fR }
[, \&.\&.\&. ]
) ]
[ WITH ( \fIstorage_parameter\fR [= \fIvalue\fR] [, \&.\&.\&. ] ) | WITH OIDS | WITHOUT OIDS ]
[ ON COMMIT { PRESERVE ROWS | DELETE ROWS | DROP } ]
[ TABLESPACE \fItablespace_name\fR ]
where \fIcolumn_constraint\fR is:
[ CONSTRAINT \fIconstraint_name\fR ]
{ NOT NULL |
NULL |
CHECK ( \fIexpression\fR ) [ NO INHERIT ] |
DEFAULT \fIdefault_expr\fR |
UNIQUE \fIindex_parameters\fR |
PRIMARY KEY \fIindex_parameters\fR |
REFERENCES \fIreftable\fR [ ( \fIrefcolumn\fR ) ] [ MATCH FULL | MATCH PARTIAL | MATCH SIMPLE ]
[ ON DELETE \fIaction\fR ] [ ON UPDATE \fIaction\fR ] }
[ DEFERRABLE | NOT DEFERRABLE ] [ INITIALLY DEFERRED | INITIALLY IMMEDIATE ]
and \fItable_constraint\fR is:
[ CONSTRAINT \fIconstraint_name\fR ]
{ CHECK ( \fIexpression\fR ) [ NO INHERIT ] |
UNIQUE ( \fIcolumn_name\fR [, \&.\&.\&. ] ) \fIindex_parameters\fR |
PRIMARY KEY ( \fIcolumn_name\fR [, \&.\&.\&. ] ) \fIindex_parameters\fR |
EXCLUDE [ USING \fIindex_method\fR ] ( \fIexclude_element\fR WITH \fIoperator\fR [, \&.\&.\&. ] ) \fIindex_parameters\fR [ WHERE ( \fIpredicate\fR ) ] |
FOREIGN KEY ( \fIcolumn_name\fR [, \&.\&.\&. ] ) REFERENCES \fIreftable\fR [ ( \fIrefcolumn\fR [, \&.\&.\&. ] ) ]
[ MATCH FULL | MATCH PARTIAL | MATCH SIMPLE ] [ ON DELETE \fIaction\fR ] [ ON UPDATE \fIaction\fR ] }
[ DEFERRABLE | NOT DEFERRABLE ] [ INITIALLY DEFERRED | INITIALLY IMMEDIATE ]
and \fIlike_option\fR is:
{ INCLUDING | EXCLUDING } { DEFAULTS | CONSTRAINTS | INDEXES | STORAGE | COMMENTS | ALL }
\fIindex_parameters\fR in UNIQUE, PRIMARY KEY, and EXCLUDE constraints are:
[ WITH ( \fIstorage_parameter\fR [= \fIvalue\fR] [, \&.\&.\&. ] ) ]
[ USING INDEX TABLESPACE \fItablespace_name\fR ]
\fIexclude_element\fR in an EXCLUDE constraint is:
{ \fIcolumn_name\fR | ( \fIexpression\fR ) } [ \fIopclass\fR ] [ ASC | DESC ] [ NULLS { FIRST | LAST } ]
.fi
.SH "DESCRIPTION"
.PP
\fBCREATE TABLE\fR
will create a new, initially empty table in the current database\&. The table will be owned by the user issuing the command\&.
.PP
If a schema name is given (for example,
CREATE TABLE myschema\&.mytable \&.\&.\&.) then the table is created in the specified schema\&. Otherwise it is created in the current schema\&. Temporary tables exist in a special schema, so a schema name cannot be given when creating a temporary table\&. The name of the table must be distinct from the name of any other table, sequence, index, view, or foreign table in the same schema\&.
.PP
\fBCREATE TABLE\fR
also automatically creates a data type that represents the composite type corresponding to one row of the table\&. Therefore, tables cannot have the same name as any existing data type in the same schema\&.
.PP
The optional constraint clauses specify constraints (tests) that new or updated rows must satisfy for an insert or update operation to succeed\&. A constraint is an SQL object that helps define the set of valid values in the table in various ways\&.
.PP
There are two ways to define constraints: table constraints and column constraints\&. A column constraint is defined as part of a column definition\&. A table constraint definition is not tied to a particular column, and it can encompass more than one column\&. Every column constraint can also be written as a table constraint; a column constraint is only a notational convenience for use when the constraint only affects one column\&.
.PP
To be able to create a table, you must have
USAGE
privilege on all column types or the type in the
OF
clause, respectively\&.
.SH "PARAMETERS"
.PP
TEMPORARY or TEMP
.RS 4
If specified, the table is created as a temporary table\&. Temporary tables are automatically dropped at the end of a session, or optionally at the end of the current transaction (see
ON COMMIT
below)\&. Existing permanent tables with the same name are not visible to the current session while the temporary table exists, unless they are referenced with schema\-qualified names\&. Any indexes created on a temporary table are automatically temporary as well\&.
.sp
The
autovacuum daemon
cannot access and therefore cannot vacuum or analyze temporary tables\&. For this reason, appropriate vacuum and analyze operations should be performed via session SQL commands\&. For example, if a temporary table is going to be used in complex queries, it is wise to run
\fBANALYZE\fR
on the temporary table after it is populated\&.
.sp
Optionally,
GLOBAL
or
LOCAL
can be written before
TEMPORARY
or
TEMP\&. This presently makes no difference in
PostgreSQL
and is deprecated; see
COMPATIBILITY\&.
.RE
.PP
UNLOGGED
.RS 4
If specified, the table is created as an unlogged table\&. Data written to unlogged tables is not written to the write\-ahead log (see
Chapter 30, Reliability and the Write-Ahead Log, in the documentation), which makes them considerably faster than ordinary tables\&. However, they are not crash\-safe: an unlogged table is automatically truncated after a crash or unclean shutdown\&. The contents of an unlogged table are also not replicated to standby servers\&. Any indexes created on an unlogged table are automatically unlogged as well\&.
.RE
.PP
IF NOT EXISTS
.RS 4
Do not throw an error if a relation with the same name already exists\&. A notice is issued in this case\&. Note that there is no guarantee that the existing relation is anything like the one that would have been created\&.
.RE
.PP
\fItable_name\fR
.RS 4
The name (optionally schema\-qualified) of the table to be created\&.
.RE
.PP
OF \fItype_name\fR
.RS 4
Creates a
typed table, which takes its structure from the specified composite type (name optionally schema\-qualified)\&. A typed table is tied to its type; for example the table will be dropped if the type is dropped (with
DROP TYPE \&.\&.\&. CASCADE)\&.
.sp
When a typed table is created, then the data types of the columns are determined by the underlying composite type and are not specified by the
CREATE TABLE
command\&. But the
CREATE TABLE
command can add defaults and constraints to the table and can specify storage parameters\&.
.RE
.PP
\fIcolumn_name\fR
.RS 4
The name of a column to be created in the new table\&.
.RE
.PP
\fIdata_type\fR
.RS 4
The data type of the column\&. This can include array specifiers\&. For more information on the data types supported by
PostgreSQL, refer to
Chapter 8, Data Types, in the documentation\&.
.RE
.PP
COLLATE \fIcollation\fR
.RS 4
The
COLLATE
clause assigns a collation to the column (which must be of a collatable data type)\&. If not specified, the column data type\*(Aqs default collation is used\&.
.RE
.PP
INHERITS ( \fIparent_table\fR [, \&.\&.\&. ] )
.RS 4
The optional
INHERITS
clause specifies a list of tables from which the new table automatically inherits all columns\&. Parent tables can be plain tables or foreign tables\&.
.sp
Use of
INHERITS
creates a persistent relationship between the new child table and its parent table(s)\&. Schema modifications to the parent(s) normally propagate to children as well, and by default the data of the child table is included in scans of the parent(s)\&.
.sp
If the same column name exists in more than one parent table, an error is reported unless the data types of the columns match in each of the parent tables\&. If there is no conflict, then the duplicate columns are merged to form a single column in the new table\&. If the column name list of the new table contains a column name that is also inherited, the data type must likewise match the inherited column(s), and the column definitions are merged into one\&. If the new table explicitly specifies a default value for the column, this default overrides any defaults from inherited declarations of the column\&. Otherwise, any parents that specify default values for the column must all specify the same default, or an error will be reported\&.
.sp
CHECK
constraints are merged in essentially the same way as columns: if multiple parent tables and/or the new table definition contain identically\-named
CHECK
constraints, these constraints must all have the same check expression, or an error will be reported\&. Constraints having the same name and expression will be merged into one copy\&. A constraint marked
NO INHERIT
in a parent will not be considered\&. Notice that an unnamed
CHECK
constraint in the new table will never be merged, since a unique name will always be chosen for it\&.
.sp
Column
STORAGE
settings are also copied from parent tables\&.
.RE
.PP
LIKE \fIsource_table\fR [ \fIlike_option\fR \&.\&.\&. ]
.RS 4
The
LIKE
clause specifies a table from which the new table automatically copies all column names, their data types, and their not\-null constraints\&.
.sp
Unlike
INHERITS, the new table and original table are completely decoupled after creation is complete\&. Changes to the original table will not be applied to the new table, and it is not possible to include data of the new table in scans of the original table\&.
.sp
Default expressions for the copied column definitions will be copied only if
INCLUDING DEFAULTS
is specified\&. The default behavior is to exclude default expressions, resulting in the copied columns in the new table having null defaults\&. Note that copying defaults that call database\-modification functions, such as
\fBnextval\fR, may create a functional linkage between the original and new tables\&.
.sp
Not\-null constraints are always copied to the new table\&.
CHECK
constraints will be copied only if
INCLUDING CONSTRAINTS
is specified\&. No distinction is made between column constraints and table constraints\&.
.sp
Indexes,
PRIMARY KEY,
UNIQUE, and
EXCLUDE
constraints on the original table will be created on the new table only if
INCLUDING INDEXES
is specified\&. Names for the new indexes and constraints are chosen according to the default rules, regardless of how the originals were named\&. (This behavior avoids possible duplicate\-name failures for the new indexes\&.)
.sp
STORAGE
settings for the copied column definitions will be copied only if
INCLUDING STORAGE
is specified\&. The default behavior is to exclude
STORAGE
settings, resulting in the copied columns in the new table having type\-specific default settings\&. For more on
STORAGE
settings, see
Section 65.2, \(lqTOAST\(rq, in the documentation\&.
.sp
Comments for the copied columns, constraints, and indexes will be copied only if
INCLUDING COMMENTS
is specified\&. The default behavior is to exclude comments, resulting in the copied columns and constraints in the new table having no comments\&.
.sp
INCLUDING ALL
is an abbreviated form of
INCLUDING DEFAULTS INCLUDING CONSTRAINTS INCLUDING INDEXES INCLUDING STORAGE INCLUDING COMMENTS\&.
.sp
Note that unlike
INHERITS, columns and constraints copied by
LIKE
are not merged with similarly named columns and constraints\&. If the same name is specified explicitly or in another
LIKE
clause, an error is signaled\&.
.sp
The
LIKE
clause can also be used to copy column definitions from views, foreign tables, or composite types\&. Inapplicable options (e\&.g\&.,
INCLUDING INDEXES
from a view) are ignored\&.
.RE
.PP
CONSTRAINT \fIconstraint_name\fR
.RS 4
An optional name for a column or table constraint\&. If the constraint is violated, the constraint name is present in error messages, so constraint names like
col must be positive
can be used to communicate helpful constraint information to client applications\&. (Double\-quotes are needed to specify constraint names that contain spaces\&.) If a constraint name is not specified, the system generates a name\&.
.RE
.PP
NOT NULL
.RS 4
The column is not allowed to contain null values\&.
.RE
.PP
NULL
.RS 4
The column is allowed to contain null values\&. This is the default\&.
.sp
This clause is only provided for compatibility with non\-standard SQL databases\&. Its use is discouraged in new applications\&.
.RE
.PP
CHECK ( \fIexpression\fR ) [ NO INHERIT ]
.RS 4
The
CHECK
clause specifies an expression producing a Boolean result which new or updated rows must satisfy for an insert or update operation to succeed\&. Expressions evaluating to TRUE or UNKNOWN succeed\&. Should any row of an insert or update operation produce a FALSE result, an error exception is raised and the insert or update does not alter the database\&. A check constraint specified as a column constraint should reference that column\*(Aqs value only, while an expression appearing in a table constraint can reference multiple columns\&.
.sp
Currently,
CHECK
expressions cannot contain subqueries nor refer to variables other than columns of the current row (see
Section 5.3.1, \(lqCheck Constraints\(rq, in the documentation)\&. The system column
tableoid
may be referenced, but not any other system column\&.
.sp
A constraint marked with
NO INHERIT
will not propagate to child tables\&.
.sp
When a table has multiple
CHECK
constraints, they will be tested for each row in alphabetical order by name, after checking
NOT NULL
constraints\&. (PostgreSQL
versions before 9\&.5 did not honor any particular firing order for
CHECK
constraints\&.)
.RE
.PP
DEFAULT \fIdefault_expr\fR
.RS 4
The
DEFAULT
clause assigns a default data value for the column whose column definition it appears within\&. The value is any variable\-free expression (subqueries and cross\-references to other columns in the current table are not allowed)\&. The data type of the default expression must match the data type of the column\&.
.sp
The default expression will be used in any insert operation that does not specify a value for the column\&. If there is no default for a column, then the default is null\&.
.RE
.PP
UNIQUE (column constraint)
.br
UNIQUE ( \fIcolumn_name\fR [, \&.\&.\&. ] ) (table constraint)
.RS 4
The
UNIQUE
constraint specifies that a group of one or more columns of a table can contain only unique values\&. The behavior of a unique table constraint is the same as that of a unique column constraint, with the additional capability to span multiple columns\&. The constraint therefore enforces that any two rows must differ in at least one of these columns\&.
.sp
For the purpose of a unique constraint, null values are not considered equal\&.
.sp
Each unique constraint should name a set of columns that is different from the set of columns named by any other unique or primary key constraint defined for the table\&. (Otherwise, redundant unique constraints will be discarded\&.)
.RE
.PP
PRIMARY KEY (column constraint)
.br
PRIMARY KEY ( \fIcolumn_name\fR [, \&.\&.\&. ] ) (table constraint)
.RS 4
The
PRIMARY KEY
constraint specifies that a column or columns of a table can contain only unique (non\-duplicate), nonnull values\&. Only one primary key can be specified for a table, whether as a column constraint or a table constraint\&.
.sp
The primary key constraint should name a set of columns that is different from the set of columns named by any unique constraint defined for the same table\&. (Otherwise, the unique constraint is redundant and will be discarded\&.)
.sp
PRIMARY KEY
enforces the same data constraints as a combination of
UNIQUE
and
NOT NULL\&. However, identifying a set of columns as the primary key also provides metadata about the design of the schema, since a primary key implies that other tables can rely on this set of columns as a unique identifier for rows\&.
.sp
Adding a
PRIMARY KEY
constraint will automatically create a unique btree index on the column or group of columns used in the constraint\&.
.RE
.PP
EXCLUDE [ USING \fIindex_method\fR ] ( \fIexclude_element\fR WITH \fIoperator\fR [, \&.\&.\&. ] ) \fIindex_parameters\fR [ WHERE ( \fIpredicate\fR ) ]
.RS 4
The
EXCLUDE
clause defines an exclusion constraint, which guarantees that if any two rows are compared on the specified column(s) or expression(s) using the specified operator(s), not all of these comparisons will return
TRUE\&. If all of the specified operators test for equality, this is equivalent to a
UNIQUE
constraint, although an ordinary unique constraint will be faster\&. However, exclusion constraints can specify constraints that are more general than simple equality\&. For example, you can specify a constraint that no two rows in the table contain overlapping circles (see
Section 8.8, \(lqGeometric Types\(rq, in the documentation) by using the
&&
operator\&.
.sp
Exclusion constraints are implemented using an index, so each specified operator must be associated with an appropriate operator class (see
Section 11.9, \(lqOperator Classes and Operator Families\(rq, in the documentation) for the index access method
\fIindex_method\fR\&. The operators are required to be commutative\&. Each
\fIexclude_element\fR
can optionally specify an operator class and/or ordering options; these are described fully under
CREATE INDEX (\fBCREATE_INDEX\fR(7))\&.
.sp
The access method must support
amgettuple
(see
Chapter 59, Index Access Method Interface Definition, in the documentation); at present this means
GIN
cannot be used\&. Although it\*(Aqs allowed, there is little point in using B\-tree or hash indexes with an exclusion constraint, because this does nothing that an ordinary unique constraint doesn\*(Aqt do better\&. So in practice the access method will always be
GiST
or
SP\-GiST\&.
.sp
The
\fIpredicate\fR
allows you to specify an exclusion constraint on a subset of the table; internally this creates a partial index\&. Note that parentheses are required around the predicate\&.
.RE
.PP
REFERENCES \fIreftable\fR [ ( \fIrefcolumn\fR ) ] [ MATCH \fImatchtype\fR ] [ ON DELETE \fIaction\fR ] [ ON UPDATE \fIaction\fR ] (column constraint)
.br
FOREIGN KEY ( \fIcolumn_name\fR [, \&.\&.\&. ] ) REFERENCES \fIreftable\fR [ ( \fIrefcolumn\fR [, \&.\&.\&. ] ) ] [ MATCH \fImatchtype\fR ] [ ON DELETE \fIaction\fR ] [ ON UPDATE \fIaction\fR ] (table constraint)
.RS 4
These clauses specify a foreign key constraint, which requires that a group of one or more columns of the new table must only contain values that match values in the referenced column(s) of some row of the referenced table\&. If the
\fIrefcolumn\fR
list is omitted, the primary key of the
\fIreftable\fR
is used\&. The referenced columns must be the columns of a non\-deferrable unique or primary key constraint in the referenced table\&. Note that foreign key constraints cannot be defined between temporary tables and permanent tables\&.
.sp
A value inserted into the referencing column(s) is matched against the values of the referenced table and referenced columns using the given match type\&. There are three match types:
MATCH FULL,
MATCH PARTIAL, and
MATCH SIMPLE
(which is the default)\&.
MATCH FULL
will not allow one column of a multicolumn foreign key to be null unless all foreign key columns are null; if they are all null, the row is not required to have a match in the referenced table\&.
MATCH SIMPLE
allows any of the foreign key columns to be null; if any of them are null, the row is not required to have a match in the referenced table\&.
MATCH PARTIAL
is not yet implemented\&. (Of course,
NOT NULL
constraints can be applied to the referencing column(s) to prevent these cases from arising\&.)
.sp
In addition, when the data in the referenced columns is changed, certain actions are performed on the data in this table\*(Aqs columns\&. The
ON DELETE
clause specifies the action to perform when a referenced row in the referenced table is being deleted\&. Likewise, the
ON UPDATE
clause specifies the action to perform when a referenced column in the referenced table is being updated to a new value\&. If the row is updated, but the referenced column is not actually changed, no action is done\&. Referential actions other than the
NO ACTION
check cannot be deferred, even if the constraint is declared deferrable\&. There are the following possible actions for each clause:
.PP
NO ACTION
.RS 4
Produce an error indicating that the deletion or update would create a foreign key constraint violation\&. If the constraint is deferred, this error will be produced at constraint check time if there still exist any referencing rows\&. This is the default action\&.
.RE
.PP
RESTRICT
.RS 4
Produce an error indicating that the deletion or update would create a foreign key constraint violation\&. This is the same as
NO ACTION
except that the check is not deferrable\&.
.RE
.PP
CASCADE
.RS 4
Delete any rows referencing the deleted row, or update the values of the referencing column(s) to the new values of the referenced columns, respectively\&.
.RE
.PP
SET NULL
.RS 4
Set the referencing column(s) to null\&.
.RE
.PP
SET DEFAULT
.RS 4
Set the referencing column(s) to their default values\&. (There must be a row in the referenced table matching the default values, if they are not null, or the operation will fail\&.)
.RE
.sp
If the referenced column(s) are changed frequently, it might be wise to add an index to the referencing column(s) so that referential actions associated with the foreign key constraint can be performed more efficiently\&.
.RE
.PP
DEFERRABLE
.br
NOT DEFERRABLE
.RS 4
This controls whether the constraint can be deferred\&. A constraint that is not deferrable will be checked immediately after every command\&. Checking of constraints that are deferrable can be postponed until the end of the transaction (using the
SET CONSTRAINTS (\fBSET_CONSTRAINTS\fR(7))
command)\&.
NOT DEFERRABLE
is the default\&. Currently, only
UNIQUE,
PRIMARY KEY,
EXCLUDE, and
REFERENCES
(foreign key) constraints accept this clause\&.
NOT NULL
and
CHECK
constraints are not deferrable\&. Note that deferrable constraints cannot be used as conflict arbitrators in an
\fBINSERT\fR
statement that includes an
ON CONFLICT DO UPDATE
clause\&.
.RE
.PP
INITIALLY IMMEDIATE
.br
INITIALLY DEFERRED
.RS 4
If a constraint is deferrable, this clause specifies the default time to check the constraint\&. If the constraint is
INITIALLY IMMEDIATE, it is checked after each statement\&. This is the default\&. If the constraint is
INITIALLY DEFERRED, it is checked only at the end of the transaction\&. The constraint check time can be altered with the
SET CONSTRAINTS (\fBSET_CONSTRAINTS\fR(7))
command\&.
.RE
.PP
WITH ( \fIstorage_parameter\fR [= \fIvalue\fR] [, \&.\&.\&. ] )
.RS 4
This clause specifies optional storage parameters for a table or index; see
Storage Parameters
for more information\&. The
WITH
clause for a table can also include
OIDS=TRUE
(or just
OIDS) to specify that rows of the new table should have OIDs (object identifiers) assigned to them, or
OIDS=FALSE
to specify that the rows should not have OIDs\&. If
OIDS
is not specified, the default setting depends upon the
default_with_oids
configuration parameter\&. (If the new table inherits from any tables that have OIDs, then
OIDS=TRUE
is forced even if the command says
OIDS=FALSE\&.)
.sp
If
OIDS=FALSE
is specified or implied, the new table does not store OIDs and no OID will be assigned for a row inserted into it\&. This is generally considered worthwhile, since it will reduce OID consumption and thereby postpone the wraparound of the 32\-bit OID counter\&. Once the counter wraps around, OIDs can no longer be assumed to be unique, which makes them considerably less useful\&. In addition, excluding OIDs from a table reduces the space required to store the table on disk by 4 bytes per row (on most machines), slightly improving performance\&.
.sp
To remove OIDs from a table after it has been created, use
ALTER TABLE (\fBALTER_TABLE\fR(7))\&.
.RE
.PP
WITH OIDS
.br
WITHOUT OIDS
.RS 4
These are obsolescent syntaxes equivalent to
WITH (OIDS)
and
WITH (OIDS=FALSE), respectively\&. If you wish to give both an
OIDS
setting and storage parameters, you must use the
WITH ( \&.\&.\&. )
syntax; see above\&.
.RE
.PP
ON COMMIT
.RS 4
The behavior of temporary tables at the end of a transaction block can be controlled using
ON COMMIT\&. The three options are:
.PP
PRESERVE ROWS
.RS 4
No special action is taken at the ends of transactions\&. This is the default behavior\&.
.RE
.PP
DELETE ROWS
.RS 4
All rows in the temporary table will be deleted at the end of each transaction block\&. Essentially, an automatic
\fBTRUNCATE\fR(7)
is done at each commit\&.
.RE
.PP
DROP
.RS 4
The temporary table will be dropped at the end of the current transaction block\&.
.RE
.RE
.PP
TABLESPACE \fItablespace_name\fR
.RS 4
The
\fItablespace_name\fR
is the name of the tablespace in which the new table is to be created\&. If not specified,
default_tablespace
is consulted, or
temp_tablespaces
if the table is temporary\&.
.RE
.PP
USING INDEX TABLESPACE \fItablespace_name\fR
.RS 4
This clause allows selection of the tablespace in which the index associated with a
UNIQUE,
PRIMARY KEY, or
EXCLUDE
constraint will be created\&. If not specified,
default_tablespace
is consulted, or
temp_tablespaces
if the table is temporary\&.
.RE
.SS "Storage Parameters"
.PP
The
WITH
clause can specify
storage parameters
for tables, and for indexes associated with a
UNIQUE,
PRIMARY KEY, or
EXCLUDE
constraint\&. Storage parameters for indexes are documented in
CREATE INDEX (\fBCREATE_INDEX\fR(7))\&. The storage parameters currently available for tables are listed below\&. For many of these parameters, as shown, there is an additional parameter with the same name prefixed with
toast\&., which controls the behavior of the table\*(Aqs secondary
TOAST
table, if any (see
Section 65.2, \(lqTOAST\(rq, in the documentation
for more information about TOAST)\&. If a table parameter value is set and the equivalent
toast\&.
parameter is not, the TOAST table will use the table\*(Aqs parameter value\&.
.PP
fillfactor (integer)
.RS 4
The fillfactor for a table is a percentage between 10 and 100\&. 100 (complete packing) is the default\&. When a smaller fillfactor is specified,
\fBINSERT\fR
operations pack table pages only to the indicated percentage; the remaining space on each page is reserved for updating rows on that page\&. This gives
\fBUPDATE\fR
a chance to place the updated copy of a row on the same page as the original, which is more efficient than placing it on a different page\&. For a table whose entries are never updated, complete packing is the best choice, but in heavily updated tables smaller fillfactors are appropriate\&. This parameter cannot be set for TOAST tables\&.
.RE
.PP
parallel_workers (integer)
.RS 4
This sets the number of workers that should be used to assist a parallel scan of this table\&. If not set, the system will determine a value based on the relation size\&. The actual number of workers chosen by the planner may be less, for example due to the setting of
max_worker_processes\&.
.RE
.PP
autovacuum_enabled, toast\&.autovacuum_enabled (boolean)
.RS 4
Enables or disables the autovacuum daemon for a particular table\&. If true, the autovacuum daemon will perform automatic
\fBVACUUM\fR
and/or
\fBANALYZE\fR
operations on this table following the rules discussed in
Section 24.1.6, \(lqThe Autovacuum Daemon\(rq, in the documentation\&. If false, this table will not be autovacuumed, except to prevent transaction ID wraparound\&. See
Section 24.1.5, \(lqPreventing Transaction ID Wraparound Failures\(rq, in the documentation
for more about wraparound prevention\&. Note that the autovacuum daemon does not run at all (except to prevent transaction ID wraparound) if the
autovacuum
parameter is false; setting individual tables\*(Aq storage parameters does not override that\&. Therefore there is seldom much point in explicitly setting this storage parameter to
true, only to
false\&.
.RE
.PP
autovacuum_vacuum_threshold, toast\&.autovacuum_vacuum_threshold (integer)
.RS 4
Per\-table value for
autovacuum_vacuum_threshold
parameter\&.
.RE
.PP
autovacuum_vacuum_scale_factor, toast\&.autovacuum_vacuum_scale_factor (floating point)
.RS 4
Per\-table value for
autovacuum_vacuum_scale_factor
parameter\&.
.RE
.PP
autovacuum_analyze_threshold (integer)
.RS 4
Per\-table value for
autovacuum_analyze_threshold
parameter\&.
.RE
.PP
autovacuum_analyze_scale_factor (floating point)
.RS 4
Per\-table value for
autovacuum_analyze_scale_factor
parameter\&.
.RE
.PP
autovacuum_vacuum_cost_delay, toast\&.autovacuum_vacuum_cost_delay (integer)
.RS 4
Per\-table value for
autovacuum_vacuum_cost_delay
parameter\&.
.RE
.PP
autovacuum_vacuum_cost_limit, toast\&.autovacuum_vacuum_cost_limit (integer)
.RS 4
Per\-table value for
autovacuum_vacuum_cost_limit
parameter\&.
.RE
.PP
autovacuum_freeze_min_age, toast\&.autovacuum_freeze_min_age (integer)
.RS 4
Per\-table value for
vacuum_freeze_min_age
parameter\&. Note that autovacuum will ignore per\-table
autovacuum_freeze_min_age
parameters that are larger than half the system\-wide
autovacuum_freeze_max_age
setting\&.
.RE
.PP
autovacuum_freeze_max_age, toast\&.autovacuum_freeze_max_age (integer)
.RS 4
Per\-table value for
autovacuum_freeze_max_age
parameter\&. Note that autovacuum will ignore per\-table
autovacuum_freeze_max_age
parameters that are larger than the system\-wide setting (it can only be set smaller)\&.
.RE
.PP
autovacuum_freeze_table_age, toast\&.autovacuum_freeze_table_age (integer)
.RS 4
Per\-table value for
vacuum_freeze_table_age
parameter\&.
.RE
.PP
autovacuum_multixact_freeze_min_age, toast\&.autovacuum_multixact_freeze_min_age (integer)
.RS 4
Per\-table value for
vacuum_multixact_freeze_min_age
parameter\&. Note that autovacuum will ignore per\-table
autovacuum_multixact_freeze_min_age
parameters that are larger than half the system\-wide
autovacuum_multixact_freeze_max_age
setting\&.
.RE
.PP
autovacuum_multixact_freeze_max_age, toast\&.autovacuum_multixact_freeze_max_age (integer)
.RS 4
Per\-table value for
autovacuum_multixact_freeze_max_age
parameter\&. Note that autovacuum will ignore per\-table
autovacuum_multixact_freeze_max_age
parameters that are larger than the system\-wide setting (it can only be set smaller)\&.
.RE
.PP
autovacuum_multixact_freeze_table_age, toast\&.autovacuum_multixact_freeze_table_age (integer)
.RS 4
Per\-table value for
vacuum_multixact_freeze_table_age
parameter\&.
.RE
.PP
log_autovacuum_min_duration, toast\&.log_autovacuum_min_duration (integer)
.RS 4
Per\-table value for
log_autovacuum_min_duration
parameter\&.
.RE
.PP
user_catalog_table (boolean)
.RS 4
Declare the table as an additional catalog table for purposes of logical replication\&. See
Section 47.6.2, \(lqCapabilities\(rq, in the documentation
for details\&. This parameter cannot be set for TOAST tables\&.
.RE
.SH "NOTES"
.PP
Using OIDs in new applications is not recommended: where possible, using a
SERIAL
or other sequence generator as the table\*(Aqs primary key is preferred\&. However, if your application does make use of OIDs to identify specific rows of a table, it is recommended to create a unique constraint on the
oid
column of that table, to ensure that OIDs in the table will indeed uniquely identify rows even after counter wraparound\&. Avoid assuming that OIDs are unique across tables; if you need a database\-wide unique identifier, use the combination of
tableoid
and row OID for the purpose\&.
.if n \{\
.sp
.\}
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBTip\fR
.ps -1
.br
.PP
The use of
OIDS=FALSE
is not recommended for tables with no primary key, since without either an OID or a unique data key, it is difficult to identify specific rows\&.
.sp .5v
.RE
.PP
PostgreSQL
automatically creates an index for each unique constraint and primary key constraint to enforce uniqueness\&. Thus, it is not necessary to create an index explicitly for primary key columns\&. (See
CREATE INDEX (\fBCREATE_INDEX\fR(7))
for more information\&.)
.PP
Unique constraints and primary keys are not inherited in the current implementation\&. This makes the combination of inheritance and unique constraints rather dysfunctional\&.
.PP
A table cannot have more than 1600 columns\&. (In practice, the effective limit is usually lower because of tuple\-length constraints\&.)
.SH "EXAMPLES"
.PP
Create table
films
and table
distributors:
.sp
.if n \{\
.RS 4
.\}
.nf
CREATE TABLE films (
code char(5) CONSTRAINT firstkey PRIMARY KEY,
title varchar(40) NOT NULL,
did integer NOT NULL,
date_prod date,
kind varchar(10),
len interval hour to minute
);
CREATE TABLE distributors (
did integer PRIMARY KEY DEFAULT nextval(\*(Aqserial\*(Aq),
name varchar(40) NOT NULL CHECK (name <> \*(Aq\*(Aq)
);
.fi
.if n \{\
.RE
.\}
.PP
Create a table with a 2\-dimensional array:
.sp
.if n \{\
.RS 4
.\}
.nf
CREATE TABLE array_int (
vector int[][]
);
.fi
.if n \{\
.RE
.\}
.PP
Define a unique table constraint for the table
films\&. Unique table constraints can be defined on one or more columns of the table:
.sp
.if n \{\
.RS 4
.\}
.nf
CREATE TABLE films (
code char(5),
title varchar(40),
did integer,
date_prod date,
kind varchar(10),
len interval hour to minute,
CONSTRAINT production UNIQUE(date_prod)
);
.fi
.if n \{\
.RE
.\}
.PP
Define a check column constraint:
.sp
.if n \{\
.RS 4
.\}
.nf
CREATE TABLE distributors (
did integer CHECK (did > 100),
name varchar(40)
);
.fi
.if n \{\
.RE
.\}
.PP
Define a check table constraint:
.sp
.if n \{\
.RS 4
.\}
.nf
CREATE TABLE distributors (
did integer,
name varchar(40),
CONSTRAINT con1 CHECK (did > 100 AND name <> \*(Aq\*(Aq)
);
.fi
.if n \{\
.RE
.\}
.PP
Define a primary key table constraint for the table
films:
.sp
.if n \{\
.RS 4
.\}
.nf
CREATE TABLE films (
code char(5),
title varchar(40),
did integer,
date_prod date,
kind varchar(10),
len interval hour to minute,
CONSTRAINT code_title PRIMARY KEY(code,title)
);
.fi
.if n \{\
.RE
.\}
.PP
Define a primary key constraint for table
distributors\&. The following two examples are equivalent, the first using the table constraint syntax, the second the column constraint syntax:
.sp
.if n \{\
.RS 4
.\}
.nf
CREATE TABLE distributors (
did integer,
name varchar(40),
PRIMARY KEY(did)
);
CREATE TABLE distributors (
did integer PRIMARY KEY,
name varchar(40)
);
.fi
.if n \{\
.RE
.\}
.PP
Assign a literal constant default value for the column
name, arrange for the default value of column
did
to be generated by selecting the next value of a sequence object, and make the default value of
modtime
be the time at which the row is inserted:
.sp
.if n \{\
.RS 4
.\}
.nf
CREATE TABLE distributors (
name varchar(40) DEFAULT \*(AqLuso Films\*(Aq,
did integer DEFAULT nextval(\*(Aqdistributors_serial\*(Aq),
modtime timestamp DEFAULT current_timestamp
);
.fi
.if n \{\
.RE
.\}
.PP
Define two
NOT NULL
column constraints on the table
distributors, one of which is explicitly given a name:
.sp
.if n \{\
.RS 4
.\}
.nf
CREATE TABLE distributors (
did integer CONSTRAINT no_null NOT NULL,
name varchar(40) NOT NULL
);
.fi
.if n \{\
.RE
.\}
.PP
Define a unique constraint for the
name
column:
.sp
.if n \{\
.RS 4
.\}
.nf
CREATE TABLE distributors (
did integer,
name varchar(40) UNIQUE
);
.fi
.if n \{\
.RE
.\}
.sp
The same, specified as a table constraint:
.sp
.if n \{\
.RS 4
.\}
.nf
CREATE TABLE distributors (
did integer,
name varchar(40),
UNIQUE(name)
);
.fi
.if n \{\
.RE
.\}
.PP
Create the same table, specifying 70% fill factor for both the table and its unique index:
.sp
.if n \{\
.RS 4
.\}
.nf
CREATE TABLE distributors (
did integer,
name varchar(40),
UNIQUE(name) WITH (fillfactor=70)
)
WITH (fillfactor=70);
.fi
.if n \{\
.RE
.\}
.PP
Create table
circles
with an exclusion constraint that prevents any two circles from overlapping:
.sp
.if n \{\
.RS 4
.\}
.nf
CREATE TABLE circles (
c circle,
EXCLUDE USING gist (c WITH &&)
);
.fi
.if n \{\
.RE
.\}
.PP
Create table
cinemas
in tablespace
diskvol1:
.sp
.if n \{\
.RS 4
.\}
.nf
CREATE TABLE cinemas (
id serial,
name text,
location text
) TABLESPACE diskvol1;
.fi
.if n \{\
.RE
.\}
.PP
Create a composite type and a typed table:
.sp
.if n \{\
.RS 4
.\}
.nf
CREATE TYPE employee_type AS (name text, salary numeric);
CREATE TABLE employees OF employee_type (
PRIMARY KEY (name),
salary WITH OPTIONS DEFAULT 1000
);
.fi
.if n \{\
.RE
.\}
.SH "COMPATIBILITY"
.PP
The
\fBCREATE TABLE\fR
command conforms to the
SQL
standard, with exceptions listed below\&.
.SS "Temporary Tables"
.PP
Although the syntax of
CREATE TEMPORARY TABLE
resembles that of the SQL standard, the effect is not the same\&. In the standard, temporary tables are defined just once and automatically exist (starting with empty contents) in every session that needs them\&.
PostgreSQL
instead requires each session to issue its own
CREATE TEMPORARY TABLE
command for each temporary table to be used\&. This allows different sessions to use the same temporary table name for different purposes, whereas the standard\*(Aqs approach constrains all instances of a given temporary table name to have the same table structure\&.
.PP
The standard\*(Aqs definition of the behavior of temporary tables is widely ignored\&.
PostgreSQL\*(Aqs behavior on this point is similar to that of several other SQL databases\&.
.PP
The SQL standard also distinguishes between global and local temporary tables, where a local temporary table has a separate set of contents for each SQL module within each session, though its definition is still shared across sessions\&. Since
PostgreSQL
does not support SQL modules, this distinction is not relevant in
PostgreSQL\&.
.PP
For compatibility\*(Aqs sake,
PostgreSQL
will accept the
GLOBAL
and
LOCAL
keywords in a temporary table declaration, but they currently have no effect\&. Use of these keywords is discouraged, since future versions of
PostgreSQL
might adopt a more standard\-compliant interpretation of their meaning\&.
.PP
The
ON COMMIT
clause for temporary tables also resembles the SQL standard, but has some differences\&. If the
ON COMMIT
clause is omitted, SQL specifies that the default behavior is
ON COMMIT DELETE ROWS\&. However, the default behavior in
PostgreSQL
is
ON COMMIT PRESERVE ROWS\&. The
ON COMMIT DROP
option does not exist in SQL\&.
.SS "Non\-deferred Uniqueness Constraints"
.PP
When a
UNIQUE
or
PRIMARY KEY
constraint is not deferrable,
PostgreSQL
checks for uniqueness immediately whenever a row is inserted or modified\&. The SQL standard says that uniqueness should be enforced only at the end of the statement; this makes a difference when, for example, a single command updates multiple key values\&. To obtain standard\-compliant behavior, declare the constraint as
DEFERRABLE
but not deferred (i\&.e\&.,
INITIALLY IMMEDIATE)\&. Be aware that this can be significantly slower than immediate uniqueness checking\&.
.SS "Column Check Constraints"
.PP
The SQL standard says that
CHECK
column constraints can only refer to the column they apply to; only
CHECK
table constraints can refer to multiple columns\&.
PostgreSQL
does not enforce this restriction; it treats column and table check constraints alike\&.
.SS "EXCLUDE Constraint"
.PP
The
EXCLUDE
constraint type is a
PostgreSQL
extension\&.
.SS "NULL \(lqConstraint\(rq"
.PP
The
NULL
\(lqconstraint\(rq
(actually a non\-constraint) is a
PostgreSQL
extension to the SQL standard that is included for compatibility with some other database systems (and for symmetry with the
NOT NULL
constraint)\&. Since it is the default for any column, its presence is simply noise\&.
.SS "Inheritance"
.PP
Multiple inheritance via the
INHERITS
clause is a
PostgreSQL
language extension\&. SQL:1999 and later define single inheritance using a different syntax and different semantics\&. SQL:1999\-style inheritance is not yet supported by
PostgreSQL\&.
.SS "Zero\-column Tables"
.PP
PostgreSQL
allows a table of no columns to be created (for example,
CREATE TABLE foo();)\&. This is an extension from the SQL standard, which does not allow zero\-column tables\&. Zero\-column tables are not in themselves very useful, but disallowing them creates odd special cases for
\fBALTER TABLE DROP COLUMN\fR, so it seems cleaner to ignore this spec restriction\&.
.SS "LIKE Clause"
.PP
While a
LIKE
clause exists in the SQL standard, many of the options that
PostgreSQL
accepts for it are not in the standard, and some of the standard\*(Aqs options are not implemented by
PostgreSQL\&.
.SS "WITH Clause"
.PP
The
WITH
clause is a
PostgreSQL
extension; neither storage parameters nor OIDs are in the standard\&.
.SS "Tablespaces"
.PP
The
PostgreSQL
concept of tablespaces is not part of the standard\&. Hence, the clauses
TABLESPACE
and
USING INDEX TABLESPACE
are extensions\&.
.SS "Typed Tables"
.PP
Typed tables implement a subset of the SQL standard\&. According to the standard, a typed table has columns corresponding to the underlying composite type as well as one other column that is the
\(lqself\-referencing column\(rq\&. PostgreSQL does not support these self\-referencing columns explicitly, but the same effect can be had using the OID feature\&.
.SH "SEE ALSO"
ALTER TABLE (\fBALTER_TABLE\fR(7)), DROP TABLE (\fBDROP_TABLE\fR(7)), CREATE TABLE AS (\fBCREATE_TABLE_AS\fR(7)), CREATE TABLESPACE (\fBCREATE_TABLESPACE\fR(7)), CREATE TYPE (\fBCREATE_TYPE\fR(7))
man/man7/DROP_TEXT_SEARCH_PARSER.7 0000644 00000005243 14751153421 0011771 0 ustar 00 '\" t
.\" Title: DROP TEXT SEARCH PARSER
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "DROP TEXT SEARCH PARSER" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
DROP_TEXT_SEARCH_PARSER \- remove a text search parser
.SH "SYNOPSIS"
.sp
.nf
DROP TEXT SEARCH PARSER [ IF EXISTS ] \fIname\fR [ CASCADE | RESTRICT ]
.fi
.SH "DESCRIPTION"
.PP
\fBDROP TEXT SEARCH PARSER\fR
drops an existing text search parser\&. You must be a superuser to use this command\&.
.SH "PARAMETERS"
.PP
IF EXISTS
.RS 4
Do not throw an error if the text search parser does not exist\&. A notice is issued in this case\&.
.RE
.PP
\fIname\fR
.RS 4
The name (optionally schema\-qualified) of an existing text search parser\&.
.RE
.PP
CASCADE
.RS 4
Automatically drop objects that depend on the text search parser, and in turn all objects that depend on those objects (see
Section 5.13, \(lqDependency Tracking\(rq, in the documentation)\&.
.RE
.PP
RESTRICT
.RS 4
Refuse to drop the text search parser if any objects depend on it\&. This is the default\&.
.RE
.SH "EXAMPLES"
.PP
Remove the text search parser
my_parser:
.sp
.if n \{\
.RS 4
.\}
.nf
DROP TEXT SEARCH PARSER my_parser;
.fi
.if n \{\
.RE
.\}
.sp
This command will not succeed if there are any existing text search configurations that use the parser\&. Add
CASCADE
to drop such configurations along with the parser\&.
.SH "COMPATIBILITY"
.PP
There is no
\fBDROP TEXT SEARCH PARSER\fR
statement in the SQL standard\&.
.SH "SEE ALSO"
ALTER TEXT SEARCH PARSER (\fBALTER_TEXT_SEARCH_PARSER\fR(7)), CREATE TEXT SEARCH PARSER (\fBCREATE_TEXT_SEARCH_PARSER\fR(7))
man/man7/DELETE.7 0000644 00000016624 14751153421 0007227 0 ustar 00 '\" t
.\" Title: DELETE
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "DELETE" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
DELETE \- delete rows of a table
.SH "SYNOPSIS"
.sp
.nf
[ WITH [ RECURSIVE ] \fIwith_query\fR [, \&.\&.\&.] ]
DELETE FROM [ ONLY ] \fItable_name\fR [ * ] [ [ AS ] \fIalias\fR ]
[ USING \fIfrom_item\fR [, \&.\&.\&.] ]
[ WHERE \fIcondition\fR | WHERE CURRENT OF \fIcursor_name\fR ]
[ RETURNING * | \fIoutput_expression\fR [ [ AS ] \fIoutput_name\fR ] [, \&.\&.\&.] ]
.fi
.SH "DESCRIPTION"
.PP
\fBDELETE\fR
deletes rows that satisfy the
WHERE
clause from the specified table\&. If the
WHERE
clause is absent, the effect is to delete all rows in the table\&. The result is a valid, but empty table\&.
.if n \{\
.sp
.\}
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBTip\fR
.ps -1
.br
.PP
\fBTRUNCATE\fR(7)
is a
PostgreSQL
extension that provides a faster mechanism to remove all rows from a table\&.
.sp .5v
.RE
.PP
There are two ways to delete rows in a table using information contained in other tables in the database: using sub\-selects, or specifying additional tables in the
USING
clause\&. Which technique is more appropriate depends on the specific circumstances\&.
.PP
The optional
RETURNING
clause causes
\fBDELETE\fR
to compute and return value(s) based on each row actually deleted\&. Any expression using the table\*(Aqs columns, and/or columns of other tables mentioned in
USING, can be computed\&. The syntax of the
RETURNING
list is identical to that of the output list of
\fBSELECT\fR\&.
.PP
You must have the
DELETE
privilege on the table to delete from it, as well as the
SELECT
privilege for any table in the
USING
clause or whose values are read in the
\fIcondition\fR\&.
.SH "PARAMETERS"
.PP
\fIwith_query\fR
.RS 4
The
WITH
clause allows you to specify one or more subqueries that can be referenced by name in the
\fBDELETE\fR
query\&. See
Section 7.8, \(lqWITH Queries (Common Table Expressions)\(rq, in the documentation
and
\fBSELECT\fR(7)
for details\&.
.RE
.PP
\fItable_name\fR
.RS 4
The name (optionally schema\-qualified) of the table to delete rows from\&. If
ONLY
is specified before the table name, matching rows are deleted from the named table only\&. If
ONLY
is not specified, matching rows are also deleted from any tables inheriting from the named table\&. Optionally,
*
can be specified after the table name to explicitly indicate that descendant tables are included\&.
.RE
.PP
\fIalias\fR
.RS 4
A substitute name for the target table\&. When an alias is provided, it completely hides the actual name of the table\&. For example, given
DELETE FROM foo AS f, the remainder of the
\fBDELETE\fR
statement must refer to this table as
f
not
foo\&.
.RE
.PP
\fIfrom_item\fR
.RS 4
A table expression allowing columns from other tables to appear in the
WHERE
condition\&. This uses the same syntax as the
FROM Clause
of a
\fBSELECT\fR
statement; for example, an alias for the table name can be specified\&. Do not repeat the target table as a
\fIfrom_item\fR
unless you wish to set up a self\-join (in which case it must appear with an alias in the
\fIfrom_item\fR)\&.
.RE
.PP
\fIcondition\fR
.RS 4
An expression that returns a value of type
boolean\&. Only rows for which this expression returns
true
will be deleted\&.
.RE
.PP
\fIcursor_name\fR
.RS 4
The name of the cursor to use in a
WHERE CURRENT OF
condition\&. The row to be deleted is the one most recently fetched from this cursor\&. The cursor must be a non\-grouping query on the
\fBDELETE\fR\*(Aqs target table\&. Note that
WHERE CURRENT OF
cannot be specified together with a Boolean condition\&. See
\fBDECLARE\fR(7)
for more information about using cursors with
WHERE CURRENT OF\&.
.RE
.PP
\fIoutput_expression\fR
.RS 4
An expression to be computed and returned by the
\fBDELETE\fR
command after each row is deleted\&. The expression can use any column names of the table named by
\fItable_name\fR
or table(s) listed in
USING\&. Write
*
to return all columns\&.
.RE
.PP
\fIoutput_name\fR
.RS 4
A name to use for a returned column\&.
.RE
.SH "OUTPUTS"
.PP
On successful completion, a
\fBDELETE\fR
command returns a command tag of the form
.sp
.if n \{\
.RS 4
.\}
.nf
DELETE \fIcount\fR
.fi
.if n \{\
.RE
.\}
.sp
The
\fIcount\fR
is the number of rows deleted\&. Note that the number may be less than the number of rows that matched the
\fIcondition\fR
when deletes were suppressed by a
BEFORE DELETE
trigger\&. If
\fIcount\fR
is 0, no rows were deleted by the query (this is not considered an error)\&.
.PP
If the
\fBDELETE\fR
command contains a
RETURNING
clause, the result will be similar to that of a
\fBSELECT\fR
statement containing the columns and values defined in the
RETURNING
list, computed over the row(s) deleted by the command\&.
.SH "NOTES"
.PP
PostgreSQL
lets you reference columns of other tables in the
WHERE
condition by specifying the other tables in the
USING
clause\&. For example, to delete all films produced by a given producer, one can do:
.sp
.if n \{\
.RS 4
.\}
.nf
DELETE FROM films USING producers
WHERE producer_id = producers\&.id AND producers\&.name = \*(Aqfoo\*(Aq;
.fi
.if n \{\
.RE
.\}
.sp
What is essentially happening here is a join between
films
and
producers, with all successfully joined
films
rows being marked for deletion\&. This syntax is not standard\&. A more standard way to do it is:
.sp
.if n \{\
.RS 4
.\}
.nf
DELETE FROM films
WHERE producer_id IN (SELECT id FROM producers WHERE name = \*(Aqfoo\*(Aq);
.fi
.if n \{\
.RE
.\}
.sp
In some cases the join style is easier to write or faster to execute than the sub\-select style\&.
.SH "EXAMPLES"
.PP
Delete all films but musicals:
.sp
.if n \{\
.RS 4
.\}
.nf
DELETE FROM films WHERE kind <> \*(AqMusical\*(Aq;
.fi
.if n \{\
.RE
.\}
.PP
Clear the table
films:
.sp
.if n \{\
.RS 4
.\}
.nf
DELETE FROM films;
.fi
.if n \{\
.RE
.\}
.PP
Delete completed tasks, returning full details of the deleted rows:
.sp
.if n \{\
.RS 4
.\}
.nf
DELETE FROM tasks WHERE status = \*(AqDONE\*(Aq RETURNING *;
.fi
.if n \{\
.RE
.\}
.PP
Delete the row of
tasks
on which the cursor
c_tasks
is currently positioned:
.sp
.if n \{\
.RS 4
.\}
.nf
DELETE FROM tasks WHERE CURRENT OF c_tasks;
.fi
.if n \{\
.RE
.\}
.SH "COMPATIBILITY"
.PP
This command conforms to the
SQL
standard, except that the
USING
and
RETURNING
clauses are
PostgreSQL
extensions, as is the ability to use
WITH
with
\fBDELETE\fR\&.
man/man7/DROP_LANGUAGE.7 0000644 00000005561 14751153421 0010272 0 ustar 00 '\" t
.\" Title: DROP LANGUAGE
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "DROP LANGUAGE" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
DROP_LANGUAGE \- remove a procedural language
.SH "SYNOPSIS"
.sp
.nf
DROP [ PROCEDURAL ] LANGUAGE [ IF EXISTS ] \fIname\fR [ CASCADE | RESTRICT ]
.fi
.SH "DESCRIPTION"
.PP
\fBDROP LANGUAGE\fR
removes the definition of a previously registered procedural language\&. You must be a superuser or the owner of the language to use
\fBDROP LANGUAGE\fR\&.
.if n \{\
.sp
.\}
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBNote\fR
.ps -1
.br
.PP
As of
PostgreSQL
9\&.1, most procedural languages have been made into
\(lqextensions\(rq, and should therefore be removed with
DROP EXTENSION (\fBDROP_EXTENSION\fR(7))
not
\fBDROP LANGUAGE\fR\&.
.sp .5v
.RE
.SH "PARAMETERS"
.PP
IF EXISTS
.RS 4
Do not throw an error if the language does not exist\&. A notice is issued in this case\&.
.RE
.PP
\fIname\fR
.RS 4
The name of an existing procedural language\&. For backward compatibility, the name can be enclosed by single quotes\&.
.RE
.PP
CASCADE
.RS 4
Automatically drop objects that depend on the language (such as functions in the language), and in turn all objects that depend on those objects (see
Section 5.13, \(lqDependency Tracking\(rq, in the documentation)\&.
.RE
.PP
RESTRICT
.RS 4
Refuse to drop the language if any objects depend on it\&. This is the default\&.
.RE
.SH "EXAMPLES"
.PP
This command removes the procedural language
plsample:
.sp
.if n \{\
.RS 4
.\}
.nf
DROP LANGUAGE plsample;
.fi
.if n \{\
.RE
.\}
.SH "COMPATIBILITY"
.PP
There is no
\fBDROP LANGUAGE\fR
statement in the SQL standard\&.
.SH "SEE ALSO"
ALTER LANGUAGE (\fBALTER_LANGUAGE\fR(7)), CREATE LANGUAGE (\fBCREATE_LANGUAGE\fR(7)), \fBdroplang\fR(1)
man/man7/CREATE_TRANSFORM.7 0000644 00000013457 14751153421 0010664 0 ustar 00 '\" t
.\" Title: CREATE TRANSFORM
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "CREATE TRANSFORM" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
CREATE_TRANSFORM \- define a new transform
.SH "SYNOPSIS"
.sp
.nf
CREATE [ OR REPLACE ] TRANSFORM FOR \fItype_name\fR LANGUAGE \fIlang_name\fR (
FROM SQL WITH FUNCTION \fIfrom_sql_function_name\fR (\fIargument_type\fR [, \&.\&.\&.]),
TO SQL WITH FUNCTION \fIto_sql_function_name\fR (\fIargument_type\fR [, \&.\&.\&.])
);
.fi
.SH "DESCRIPTION"
.PP
\fBCREATE TRANSFORM\fR
defines a new transform\&.
\fBCREATE OR REPLACE TRANSFORM\fR
will either create a new transform, or replace an existing definition\&.
.PP
A transform specifies how to adapt a data type to a procedural language\&. For example, when writing a function in PL/Python using the
hstore
type, PL/Python has no prior knowledge how to present
hstore
values in the Python environment\&. Language implementations usually default to using the text representation, but that is inconvenient when, for example, an associative array or a list would be more appropriate\&.
.PP
A transform specifies two functions:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
A
\(lqfrom SQL\(rq
function that converts the type from the SQL environment to the language\&. This function will be invoked on the arguments of a function written in the language\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
A
\(lqto SQL\(rq
function that converts the type from the language to the SQL environment\&. This function will be invoked on the return value of a function written in the language\&.
.RE
.sp
It is not necessary to provide both of these functions\&. If one is not specified, the language\-specific default behavior will be used if necessary\&. (To prevent a transformation in a certain direction from happening at all, you could also write a transform function that always errors out\&.)
.PP
To be able to create a transform, you must own and have
USAGE
privilege on the type, have
USAGE
privilege on the language, and own and have
EXECUTE
privilege on the from\-SQL and to\-SQL functions, if specified\&.
.SH "PARAMETERS"
.PP
\fItype_name\fR
.RS 4
The name of the data type of the transform\&.
.RE
.PP
\fIlang_name\fR
.RS 4
The name of the language of the transform\&.
.RE
.PP
\fIfrom_sql_function_name\fR(\fIargument_type\fR [, \&.\&.\&.])
.RS 4
The name of the function for converting the type from the SQL environment to the language\&. It must take one argument of type
internal
and return type
internal\&. The actual argument will be of the type for the transform, and the function should be coded as if it were\&. (But it is not allowed to declare an SQL\-level function returning
internal
without at least one argument of type
internal\&.) The actual return value will be something specific to the language implementation\&.
.RE
.PP
\fIto_sql_function_name\fR(\fIargument_type\fR [, \&.\&.\&.])
.RS 4
The name of the function for converting the type from the language to the SQL environment\&. It must take one argument of type
internal
and return the type that is the type for the transform\&. The actual argument value will be something specific to the language implementation\&.
.RE
.SH "NOTES"
.PP
Use
DROP TRANSFORM (\fBDROP_TRANSFORM\fR(7))
to remove transforms\&.
.SH "EXAMPLES"
.PP
To create a transform for type
hstore
and language
plpythonu, first set up the type and the language:
.sp
.if n \{\
.RS 4
.\}
.nf
CREATE TYPE hstore \&.\&.\&.;
CREATE LANGUAGE plpythonu \&.\&.\&.;
.fi
.if n \{\
.RE
.\}
.sp
Then create the necessary functions:
.sp
.if n \{\
.RS 4
.\}
.nf
CREATE FUNCTION hstore_to_plpython(val internal) RETURNS internal
LANGUAGE C STRICT IMMUTABLE
AS \&.\&.\&.;
CREATE FUNCTION plpython_to_hstore(val internal) RETURNS hstore
LANGUAGE C STRICT IMMUTABLE
AS \&.\&.\&.;
.fi
.if n \{\
.RE
.\}
.sp
And finally create the transform to connect them all together:
.sp
.if n \{\
.RS 4
.\}
.nf
CREATE TRANSFORM FOR hstore LANGUAGE plpythonu (
FROM SQL WITH FUNCTION hstore_to_plpython(internal),
TO SQL WITH FUNCTION plpython_to_hstore(internal)
);
.fi
.if n \{\
.RE
.\}
.sp
In practice, these commands would be wrapped up in extensions\&.
.PP
The
contrib
section contains a number of extensions that provide transforms, which can serve as real\-world examples\&.
.SH "COMPATIBILITY"
.PP
This form of
\fBCREATE TRANSFORM\fR
is a
PostgreSQL
extension\&. There is a
\fBCREATE TRANSFORM\fR
command in the
SQL
standard, but it is for adapting data types to client languages\&. That usage is not supported by
PostgreSQL\&.
.SH "SEE ALSO"
.PP
CREATE FUNCTION (\fBCREATE_FUNCTION\fR(7)),
CREATE LANGUAGE (\fBCREATE_LANGUAGE\fR(7)),
CREATE TYPE (\fBCREATE_TYPE\fR(7)),
DROP TRANSFORM (\fBDROP_TRANSFORM\fR(7))
man/man7/DROP_OPERATOR.7 0000644 00000006017 14751153421 0010337 0 ustar 00 '\" t
.\" Title: DROP OPERATOR
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "DROP OPERATOR" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
DROP_OPERATOR \- remove an operator
.SH "SYNOPSIS"
.sp
.nf
DROP OPERATOR [ IF EXISTS ] \fIname\fR ( { \fIleft_type\fR | NONE } , { \fIright_type\fR | NONE } ) [ CASCADE | RESTRICT ]
.fi
.SH "DESCRIPTION"
.PP
\fBDROP OPERATOR\fR
drops an existing operator from the database system\&. To execute this command you must be the owner of the operator\&.
.SH "PARAMETERS"
.PP
IF EXISTS
.RS 4
Do not throw an error if the operator does not exist\&. A notice is issued in this case\&.
.RE
.PP
\fIname\fR
.RS 4
The name (optionally schema\-qualified) of an existing operator\&.
.RE
.PP
\fIleft_type\fR
.RS 4
The data type of the operator\*(Aqs left operand; write
NONE
if the operator has no left operand\&.
.RE
.PP
\fIright_type\fR
.RS 4
The data type of the operator\*(Aqs right operand; write
NONE
if the operator has no right operand\&.
.RE
.PP
CASCADE
.RS 4
Automatically drop objects that depend on the operator (such as views using it), and in turn all objects that depend on those objects (see
Section 5.13, \(lqDependency Tracking\(rq, in the documentation)\&.
.RE
.PP
RESTRICT
.RS 4
Refuse to drop the operator if any objects depend on it\&. This is the default\&.
.RE
.SH "EXAMPLES"
.PP
Remove the power operator
a^b
for type
integer:
.sp
.if n \{\
.RS 4
.\}
.nf
DROP OPERATOR ^ (integer, integer);
.fi
.if n \{\
.RE
.\}
.PP
Remove the left unary bitwise complement operator
~b
for type
bit:
.sp
.if n \{\
.RS 4
.\}
.nf
DROP OPERATOR ~ (none, bit);
.fi
.if n \{\
.RE
.\}
.PP
Remove the right unary factorial operator
x!
for type
bigint:
.sp
.if n \{\
.RS 4
.\}
.nf
DROP OPERATOR ! (bigint, none);
.fi
.if n \{\
.RE
.\}
.SH "COMPATIBILITY"
.PP
There is no
\fBDROP OPERATOR\fR
statement in the SQL standard\&.
.SH "SEE ALSO"
CREATE OPERATOR (\fBCREATE_OPERATOR\fR(7)), ALTER OPERATOR (\fBALTER_OPERATOR\fR(7))
man/man7/ALTER_RULE.7 0000644 00000004326 14751153421 0007757 0 ustar 00 '\" t
.\" Title: ALTER RULE
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "ALTER RULE" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
ALTER_RULE \- change the definition of a rule
.SH "SYNOPSIS"
.sp
.nf
ALTER RULE \fIname\fR ON \fItable_name\fR RENAME TO \fInew_name\fR
.fi
.SH "DESCRIPTION"
.PP
\fBALTER RULE\fR
changes properties of an existing rule\&. Currently, the only available action is to change the rule\*(Aqs name\&.
.PP
To use
\fBALTER RULE\fR, you must own the table or view that the rule applies to\&.
.SH "PARAMETERS"
.PP
\fIname\fR
.RS 4
The name of an existing rule to alter\&.
.RE
.PP
\fItable_name\fR
.RS 4
The name (optionally schema\-qualified) of the table or view that the rule applies to\&.
.RE
.PP
\fInew_name\fR
.RS 4
The new name for the rule\&.
.RE
.SH "EXAMPLES"
.PP
To rename an existing rule:
.sp
.if n \{\
.RS 4
.\}
.nf
ALTER RULE notify_all ON emp RENAME TO notify_me;
.fi
.if n \{\
.RE
.\}
.SH "COMPATIBILITY"
.PP
\fBALTER RULE\fR
is a
PostgreSQL
language extension, as is the entire query rewrite system\&.
.SH "SEE ALSO"
CREATE RULE (\fBCREATE_RULE\fR(7)), DROP RULE (\fBDROP_RULE\fR(7))
man/man7/CREATE_TEXT_SEARCH_DICTIONARY.7 0000644 00000006543 14751153421 0012645 0 ustar 00 '\" t
.\" Title: CREATE TEXT SEARCH DICTIONARY
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "CREATE TEXT SEARCH DICTIONARY" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
CREATE_TEXT_SEARCH_DICTIONARY \- define a new text search dictionary
.SH "SYNOPSIS"
.sp
.nf
CREATE TEXT SEARCH DICTIONARY \fIname\fR (
TEMPLATE = \fItemplate\fR
[, \fIoption\fR = \fIvalue\fR [, \&.\&.\&. ]]
)
.fi
.SH "DESCRIPTION"
.PP
\fBCREATE TEXT SEARCH DICTIONARY\fR
creates a new text search dictionary\&. A text search dictionary specifies a way of recognizing interesting or uninteresting words for searching\&. A dictionary depends on a text search template, which specifies the functions that actually perform the work\&. Typically the dictionary provides some options that control the detailed behavior of the template\*(Aqs functions\&.
.PP
If a schema name is given then the text search dictionary is created in the specified schema\&. Otherwise it is created in the current schema\&.
.PP
The user who defines a text search dictionary becomes its owner\&.
.PP
Refer to
Chapter 12, Full Text Search, in the documentation
for further information\&.
.SH "PARAMETERS"
.PP
\fIname\fR
.RS 4
The name of the text search dictionary to be created\&. The name can be schema\-qualified\&.
.RE
.PP
\fItemplate\fR
.RS 4
The name of the text search template that will define the basic behavior of this dictionary\&.
.RE
.PP
\fIoption\fR
.RS 4
The name of a template\-specific option to be set for this dictionary\&.
.RE
.PP
\fIvalue\fR
.RS 4
The value to use for a template\-specific option\&. If the value is not a simple identifier or number, it must be quoted (but you can always quote it, if you wish)\&.
.RE
.PP
The options can appear in any order\&.
.SH "EXAMPLES"
.PP
The following example command creates a Snowball\-based dictionary with a nonstandard list of stop words\&.
.sp
.if n \{\
.RS 4
.\}
.nf
CREATE TEXT SEARCH DICTIONARY my_russian (
template = snowball,
language = russian,
stopwords = myrussian
);
.fi
.if n \{\
.RE
.\}
.SH "COMPATIBILITY"
.PP
There is no
\fBCREATE TEXT SEARCH DICTIONARY\fR
statement in the SQL standard\&.
.SH "SEE ALSO"
ALTER TEXT SEARCH DICTIONARY (\fBALTER_TEXT_SEARCH_DICTIONARY\fR(7)), DROP TEXT SEARCH DICTIONARY (\fBDROP_TEXT_SEARCH_DICTIONARY\fR(7))
man/man7/DROP_TYPE.7 0000644 00000005040 14751153421 0007660 0 ustar 00 '\" t
.\" Title: DROP TYPE
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "DROP TYPE" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
DROP_TYPE \- remove a data type
.SH "SYNOPSIS"
.sp
.nf
DROP TYPE [ IF EXISTS ] \fIname\fR [, \&.\&.\&.] [ CASCADE | RESTRICT ]
.fi
.SH "DESCRIPTION"
.PP
\fBDROP TYPE\fR
removes a user\-defined data type\&. Only the owner of a type can remove it\&.
.SH "PARAMETERS"
.PP
IF EXISTS
.RS 4
Do not throw an error if the type does not exist\&. A notice is issued in this case\&.
.RE
.PP
\fIname\fR
.RS 4
The name (optionally schema\-qualified) of the data type to remove\&.
.RE
.PP
CASCADE
.RS 4
Automatically drop objects that depend on the type (such as table columns, functions, and operators), and in turn all objects that depend on those objects (see
Section 5.13, \(lqDependency Tracking\(rq, in the documentation)\&.
.RE
.PP
RESTRICT
.RS 4
Refuse to drop the type if any objects depend on it\&. This is the default\&.
.RE
.SH "EXAMPLES"
.PP
To remove the data type
box:
.sp
.if n \{\
.RS 4
.\}
.nf
DROP TYPE box;
.fi
.if n \{\
.RE
.\}
.SH "COMPATIBILITY"
.PP
This command is similar to the corresponding command in the SQL standard, apart from the
IF EXISTS
option, which is a
PostgreSQL
extension\&. But note that much of the
\fBCREATE TYPE\fR
command and the data type extension mechanisms in
PostgreSQL
differ from the SQL standard\&.
.SH "SEE ALSO"
ALTER TYPE (\fBALTER_TYPE\fR(7)), CREATE TYPE (\fBCREATE_TYPE\fR(7))
man/man7/SECURITY_LABEL.7 0000644 00000012624 14751153421 0010427 0 ustar 00 '\" t
.\" Title: SECURITY LABEL
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "SECURITY LABEL" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
SECURITY_LABEL \- define or change a security label applied to an object
.SH "SYNOPSIS"
.sp
.nf
SECURITY LABEL [ FOR \fIprovider\fR ] ON
{
TABLE \fIobject_name\fR |
COLUMN \fItable_name\fR\&.\fIcolumn_name\fR |
AGGREGATE \fIaggregate_name\fR ( \fIaggregate_signature\fR ) |
DATABASE \fIobject_name\fR |
DOMAIN \fIobject_name\fR |
EVENT TRIGGER \fIobject_name\fR |
FOREIGN TABLE \fIobject_name\fR
FUNCTION \fIfunction_name\fR ( [ [ \fIargmode\fR ] [ \fIargname\fR ] \fIargtype\fR [, \&.\&.\&.] ] ) |
LARGE OBJECT \fIlarge_object_oid\fR |
MATERIALIZED VIEW \fIobject_name\fR |
[ PROCEDURAL ] LANGUAGE \fIobject_name\fR |
ROLE \fIobject_name\fR |
SCHEMA \fIobject_name\fR |
SEQUENCE \fIobject_name\fR |
TABLESPACE \fIobject_name\fR |
TYPE \fIobject_name\fR |
VIEW \fIobject_name\fR
} IS \*(Aq\fIlabel\fR\*(Aq
where \fIaggregate_signature\fR is:
* |
[ \fIargmode\fR ] [ \fIargname\fR ] \fIargtype\fR [ , \&.\&.\&. ] |
[ [ \fIargmode\fR ] [ \fIargname\fR ] \fIargtype\fR [ , \&.\&.\&. ] ] ORDER BY [ \fIargmode\fR ] [ \fIargname\fR ] \fIargtype\fR [ , \&.\&.\&. ]
.fi
.SH "DESCRIPTION"
.PP
\fBSECURITY LABEL\fR
applies a security label to a database object\&. An arbitrary number of security labels, one per label provider, can be associated with a given database object\&. Label providers are loadable modules which register themselves by using the function
\fBregister_label_provider\fR\&.
.if n \{\
.sp
.\}
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBNote\fR
.ps -1
.br
.PP
\fBregister_label_provider\fR
is not an SQL function; it can only be called from C code loaded into the backend\&.
.sp .5v
.RE
.PP
The label provider determines whether a given label is valid and whether it is permissible to assign that label to a given object\&. The meaning of a given label is likewise at the discretion of the label provider\&.
PostgreSQL
places no restrictions on whether or how a label provider must interpret security labels; it merely provides a mechanism for storing them\&. In practice, this facility is intended to allow integration with label\-based mandatory access control (MAC) systems such as
SELinux\&. Such systems make all access control decisions based on object labels, rather than traditional discretionary access control (DAC) concepts such as users and groups\&.
.SH "PARAMETERS"
.PP
\fIobject_name\fR
.br
\fItable_name\&.column_name\fR
.br
\fIaggregate_name\fR
.br
\fIfunction_name\fR
.RS 4
The name of the object to be labeled\&. Names of tables, aggregates, domains, foreign tables, functions, sequences, types, and views can be schema\-qualified\&.
.RE
.PP
\fIprovider\fR
.RS 4
The name of the provider with which this label is to be associated\&. The named provider must be loaded and must consent to the proposed labeling operation\&. If exactly one provider is loaded, the provider name may be omitted for brevity\&.
.RE
.PP
\fIargmode\fR
.RS 4
The mode of a function or aggregate argument:
IN,
OUT,
INOUT, or
VARIADIC\&. If omitted, the default is
IN\&. Note that
\fBSECURITY LABEL\fR
does not actually pay any attention to
OUT
arguments, since only the input arguments are needed to determine the function\*(Aqs identity\&. So it is sufficient to list the
IN,
INOUT, and
VARIADIC
arguments\&.
.RE
.PP
\fIargname\fR
.RS 4
The name of a function or aggregate argument\&. Note that
\fBSECURITY LABEL\fR
does not actually pay any attention to argument names, since only the argument data types are needed to determine the function\*(Aqs identity\&.
.RE
.PP
\fIargtype\fR
.RS 4
The data type of a function or aggregate argument\&.
.RE
.PP
\fIlarge_object_oid\fR
.RS 4
The OID of the large object\&.
.RE
.PP
PROCEDURAL
.RS 4
This is a noise word\&.
.RE
.PP
\fIlabel\fR
.RS 4
The new security label, written as a string literal; or
NULL
to drop the security label\&.
.RE
.SH "EXAMPLES"
.PP
The following example shows how the security label of a table might be changed\&.
.sp
.if n \{\
.RS 4
.\}
.nf
SECURITY LABEL FOR selinux ON TABLE mytable IS \*(Aqsystem_u:object_r:sepgsql_table_t:s0\*(Aq;
.fi
.if n \{\
.RE
.\}
.SH "COMPATIBILITY"
.PP
There is no
\fBSECURITY LABEL\fR
command in the SQL standard\&.
.SH "SEE ALSO"
sepgsql, src/test/modules/dummy_seclabel
man/man7/ALTER_SEQUENCE.7 0000644 00000017042 14751153421 0010417 0 ustar 00 '\" t
.\" Title: ALTER SEQUENCE
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "ALTER SEQUENCE" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
ALTER_SEQUENCE \- change the definition of a sequence generator
.SH "SYNOPSIS"
.sp
.nf
ALTER SEQUENCE [ IF EXISTS ] \fIname\fR [ INCREMENT [ BY ] \fIincrement\fR ]
[ MINVALUE \fIminvalue\fR | NO MINVALUE ] [ MAXVALUE \fImaxvalue\fR | NO MAXVALUE ]
[ START [ WITH ] \fIstart\fR ]
[ RESTART [ [ WITH ] \fIrestart\fR ] ]
[ CACHE \fIcache\fR ] [ [ NO ] CYCLE ]
[ OWNED BY { \fItable_name\fR\&.\fIcolumn_name\fR | NONE } ]
ALTER SEQUENCE [ IF EXISTS ] \fIname\fR OWNER TO { \fInew_owner\fR | CURRENT_USER | SESSION_USER }
ALTER SEQUENCE [ IF EXISTS ] \fIname\fR RENAME TO \fInew_name\fR
ALTER SEQUENCE [ IF EXISTS ] \fIname\fR SET SCHEMA \fInew_schema\fR
.fi
.SH "DESCRIPTION"
.PP
\fBALTER SEQUENCE\fR
changes the parameters of an existing sequence generator\&. Any parameters not specifically set in the
\fBALTER SEQUENCE\fR
command retain their prior settings\&.
.PP
You must own the sequence to use
\fBALTER SEQUENCE\fR\&. To change a sequence\*(Aqs schema, you must also have
CREATE
privilege on the new schema\&. To alter the owner, you must also be a direct or indirect member of the new owning role, and that role must have
CREATE
privilege on the sequence\*(Aqs schema\&. (These restrictions enforce that altering the owner doesn\*(Aqt do anything you couldn\*(Aqt do by dropping and recreating the sequence\&. However, a superuser can alter ownership of any sequence anyway\&.)
.SH "PARAMETERS"
.PP
.PP
\fIname\fR
.RS 4
The name (optionally schema\-qualified) of a sequence to be altered\&.
.RE
.PP
IF EXISTS
.RS 4
Do not throw an error if the sequence does not exist\&. A notice is issued in this case\&.
.RE
.PP
\fIincrement\fR
.RS 4
The clause
INCREMENT BY \fIincrement\fR
is optional\&. A positive value will make an ascending sequence, a negative one a descending sequence\&. If unspecified, the old increment value will be maintained\&.
.RE
.PP
\fIminvalue\fR
.br
NO MINVALUE
.RS 4
The optional clause
MINVALUE \fIminvalue\fR
determines the minimum value a sequence can generate\&. If
NO MINVALUE
is specified, the defaults of 1 and \-2^63\-1 for ascending and descending sequences, respectively, will be used\&. If neither option is specified, the current minimum value will be maintained\&.
.RE
.PP
\fImaxvalue\fR
.br
NO MAXVALUE
.RS 4
The optional clause
MAXVALUE \fImaxvalue\fR
determines the maximum value for the sequence\&. If
NO MAXVALUE
is specified, the defaults are 2^63\-1 and \-1 for ascending and descending sequences, respectively, will be used\&. If neither option is specified, the current maximum value will be maintained\&.
.RE
.PP
\fIstart\fR
.RS 4
The optional clause
START WITH \fIstart\fR
changes the recorded start value of the sequence\&. This has no effect on the
\fIcurrent\fR
sequence value; it simply sets the value that future
\fBALTER SEQUENCE RESTART\fR
commands will use\&.
.RE
.PP
\fIrestart\fR
.RS 4
The optional clause
RESTART [ WITH \fIrestart\fR ]
changes the current value of the sequence\&. This is equivalent to calling the
\fBsetval\fR
function with
is_called
=
false: the specified value will be returned by the
\fInext\fR
call of
\fBnextval\fR\&. Writing
RESTART
with no
\fIrestart\fR
value is equivalent to supplying the start value that was recorded by
\fBCREATE SEQUENCE\fR
or last set by
\fBALTER SEQUENCE START WITH\fR\&.
.RE
.PP
\fIcache\fR
.RS 4
The clause
CACHE \fIcache\fR
enables sequence numbers to be preallocated and stored in memory for faster access\&. The minimum value is 1 (only one value can be generated at a time, i\&.e\&., no cache)\&. If unspecified, the old cache value will be maintained\&.
.RE
.PP
CYCLE
.RS 4
The optional
CYCLE
key word can be used to enable the sequence to wrap around when the
\fImaxvalue\fR
or
\fIminvalue\fR
has been reached by an ascending or descending sequence respectively\&. If the limit is reached, the next number generated will be the
\fIminvalue\fR
or
\fImaxvalue\fR, respectively\&.
.RE
.PP
NO CYCLE
.RS 4
If the optional
NO CYCLE
key word is specified, any calls to
\fBnextval\fR
after the sequence has reached its maximum value will return an error\&. If neither
CYCLE
or
NO CYCLE
are specified, the old cycle behavior will be maintained\&.
.RE
.PP
OWNED BY \fItable_name\fR\&.\fIcolumn_name\fR
.br
OWNED BY NONE
.RS 4
The
OWNED BY
option causes the sequence to be associated with a specific table column, such that if that column (or its whole table) is dropped, the sequence will be automatically dropped as well\&. If specified, this association replaces any previously specified association for the sequence\&. The specified table must have the same owner and be in the same schema as the sequence\&. Specifying
OWNED BY NONE
removes any existing association, making the sequence
\(lqfree\-standing\(rq\&.
.RE
.PP
\fInew_owner\fR
.RS 4
The user name of the new owner of the sequence\&.
.RE
.PP
\fInew_name\fR
.RS 4
The new name for the sequence\&.
.RE
.PP
\fInew_schema\fR
.RS 4
The new schema for the sequence\&.
.RE
.SH "NOTES"
.PP
To avoid blocking of concurrent transactions that obtain numbers from the same sequence,
\fBALTER SEQUENCE\fR\*(Aqs effects on the sequence generation parameters are never rolled back; those changes take effect immediately and are not reversible\&. However, the
OWNED BY,
OWNER TO,
RENAME TO, and
SET SCHEMA
clauses cause ordinary catalog updates that can be rolled back\&.
.PP
\fBALTER SEQUENCE\fR
will not immediately affect
\fBnextval\fR
results in backends, other than the current one, that have preallocated (cached) sequence values\&. They will use up all cached values prior to noticing the changed sequence generation parameters\&. The current backend will be affected immediately\&.
.PP
\fBALTER SEQUENCE\fR
does not affect the
\fBcurrval\fR
status for the sequence\&. (Before
PostgreSQL
8\&.3, it sometimes did\&.)
.PP
For historical reasons,
\fBALTER TABLE\fR
can be used with sequences too; but the only variants of
\fBALTER TABLE\fR
that are allowed with sequences are equivalent to the forms shown above\&.
.SH "EXAMPLES"
.PP
Restart a sequence called
serial, at 105:
.sp
.if n \{\
.RS 4
.\}
.nf
ALTER SEQUENCE serial RESTART WITH 105;
.fi
.if n \{\
.RE
.\}
.SH "COMPATIBILITY"
.PP
\fBALTER SEQUENCE\fR
conforms to the
SQL
standard, except for the
START WITH,
OWNED BY,
OWNER TO,
RENAME TO, and
SET SCHEMA
clauses, which are
PostgreSQL
extensions\&.
.SH "SEE ALSO"
CREATE SEQUENCE (\fBCREATE_SEQUENCE\fR(7)), DROP SEQUENCE (\fBDROP_SEQUENCE\fR(7))
man/man7/ALTER_USER_MAPPING.7 0000644 00000006420 14751153421 0011136 0 ustar 00 '\" t
.\" Title: ALTER USER MAPPING
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "ALTER USER MAPPING" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
ALTER_USER_MAPPING \- change the definition of a user mapping
.SH "SYNOPSIS"
.sp
.nf
ALTER USER MAPPING FOR { \fIuser_name\fR | USER | CURRENT_USER | SESSION_USER | PUBLIC }
SERVER \fIserver_name\fR
OPTIONS ( [ ADD | SET | DROP ] \fIoption\fR [\*(Aq\fIvalue\fR\*(Aq] [, \&.\&.\&. ] )
.fi
.SH "DESCRIPTION"
.PP
\fBALTER USER MAPPING\fR
changes the definition of a user mapping\&.
.PP
The owner of a foreign server can alter user mappings for that server for any user\&. Also, a user can alter a user mapping for their own user name if
USAGE
privilege on the server has been granted to the user\&.
.SH "PARAMETERS"
.PP
\fIuser_name\fR
.RS 4
User name of the mapping\&.
CURRENT_USER
and
USER
match the name of the current user\&.
PUBLIC
is used to match all present and future user names in the system\&.
.RE
.PP
\fIserver_name\fR
.RS 4
Server name of the user mapping\&.
.RE
.PP
OPTIONS ( [ ADD | SET | DROP ] \fIoption\fR [\*(Aq\fIvalue\fR\*(Aq] [, \&.\&.\&. ] )
.RS 4
Change options for the user mapping\&. The new options override any previously specified options\&.
ADD,
SET, and
DROP
specify the action to be performed\&.
ADD
is assumed if no operation is explicitly specified\&. Option names must be unique; options are also validated by the server\*(Aqs foreign\-data wrapper\&.
.RE
.SH "EXAMPLES"
.PP
Change the password for user mapping
bob, server
foo:
.sp
.if n \{\
.RS 4
.\}
.nf
ALTER USER MAPPING FOR bob SERVER foo OPTIONS (SET password \*(Aqpublic\*(Aq);
.fi
.if n \{\
.RE
.\}
.SH "COMPATIBILITY"
.PP
\fBALTER USER MAPPING\fR
conforms to ISO/IEC 9075\-9 (SQL/MED)\&. There is a subtle syntax issue: The standard omits the
FOR
key word\&. Since both
CREATE USER MAPPING
and
DROP USER MAPPING
use
FOR
in analogous positions, and IBM DB2 (being the other major SQL/MED implementation) also requires it for
ALTER USER MAPPING, PostgreSQL diverges from the standard here in the interest of consistency and interoperability\&.
.SH "SEE ALSO"
CREATE USER MAPPING (\fBCREATE_USER_MAPPING\fR(7)), DROP USER MAPPING (\fBDROP_USER_MAPPING\fR(7))
man/man7/ALTER_LARGE_OBJECT.7 0000644 00000004227 14751153421 0011070 0 ustar 00 '\" t
.\" Title: ALTER LARGE OBJECT
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "ALTER LARGE OBJECT" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
ALTER_LARGE_OBJECT \- change the definition of a large object
.SH "SYNOPSIS"
.sp
.nf
ALTER LARGE OBJECT \fIlarge_object_oid\fR OWNER TO { \fInew_owner\fR | CURRENT_USER | SESSION_USER }
.fi
.SH "DESCRIPTION"
.PP
\fBALTER LARGE OBJECT\fR
changes the definition of a large object\&.
.PP
You must own the large object to use
\fBALTER LARGE OBJECT\fR\&. To alter the owner, you must also be a direct or indirect member of the new owning role\&. (However, a superuser can alter any large object anyway\&.) Currently, the only functionality is to assign a new owner, so both restrictions always apply\&.
.SH "PARAMETERS"
.PP
\fIlarge_object_oid\fR
.RS 4
OID of the large object to be altered
.RE
.PP
\fInew_owner\fR
.RS 4
The new owner of the large object
.RE
.SH "COMPATIBILITY"
.PP
There is no
\fBALTER LARGE OBJECT\fR
statement in the SQL standard\&.
.SH "SEE ALSO"
Chapter 33, Large Objects, in the documentation
man/man7/CREATE_USER_MAPPING.7 0000644 00000006430 14751153421 0011233 0 ustar 00 '\" t
.\" Title: CREATE USER MAPPING
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "CREATE USER MAPPING" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
CREATE_USER_MAPPING \- define a new mapping of a user to a foreign server
.SH "SYNOPSIS"
.sp
.nf
CREATE USER MAPPING FOR { \fIuser_name\fR | USER | CURRENT_USER | PUBLIC }
SERVER \fIserver_name\fR
[ OPTIONS ( \fIoption\fR \*(Aq\fIvalue\fR\*(Aq [ , \&.\&.\&. ] ) ]
.fi
.SH "DESCRIPTION"
.PP
\fBCREATE USER MAPPING\fR
defines a mapping of a user to a foreign server\&. A user mapping typically encapsulates connection information that a foreign\-data wrapper uses together with the information encapsulated by a foreign server to access an external data resource\&.
.PP
The owner of a foreign server can create user mappings for that server for any user\&. Also, a user can create a user mapping for their own user name if
USAGE
privilege on the server has been granted to the user\&.
.SH "PARAMETERS"
.PP
\fIuser_name\fR
.RS 4
The name of an existing user that is mapped to foreign server\&.
CURRENT_USER
and
USER
match the name of the current user\&. When
PUBLIC
is specified, a so\-called public mapping is created that is used when no user\-specific mapping is applicable\&.
.RE
.PP
\fIserver_name\fR
.RS 4
The name of an existing server for which the user mapping is to be created\&.
.RE
.PP
OPTIONS ( \fIoption\fR \*(Aq\fIvalue\fR\*(Aq [, \&.\&.\&. ] )
.RS 4
This clause specifies the options of the user mapping\&. The options typically define the actual user name and password of the mapping\&. Option names must be unique\&. The allowed option names and values are specific to the server\*(Aqs foreign\-data wrapper\&.
.RE
.SH "EXAMPLES"
.PP
Create a user mapping for user
bob, server
foo:
.sp
.if n \{\
.RS 4
.\}
.nf
CREATE USER MAPPING FOR bob SERVER foo OPTIONS (user \*(Aqbob\*(Aq, password \*(Aqsecret\*(Aq);
.fi
.if n \{\
.RE
.\}
.SH "COMPATIBILITY"
.PP
\fBCREATE USER MAPPING\fR
conforms to ISO/IEC 9075\-9 (SQL/MED)\&.
.SH "SEE ALSO"
ALTER USER MAPPING (\fBALTER_USER_MAPPING\fR(7)), DROP USER MAPPING (\fBDROP_USER_MAPPING\fR(7)), CREATE FOREIGN DATA WRAPPER (\fBCREATE_FOREIGN_DATA_WRAPPER\fR(7)), CREATE SERVER (\fBCREATE_SERVER\fR(7))
man/man7/EXPLAIN.7 0000644 00000032041 14751153421 0007354 0 ustar 00 '\" t
.\" Title: EXPLAIN
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "EXPLAIN" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
EXPLAIN \- show the execution plan of a statement
.SH "SYNOPSIS"
.sp
.nf
EXPLAIN [ ( \fIoption\fR [, \&.\&.\&.] ) ] \fIstatement\fR
EXPLAIN [ ANALYZE ] [ VERBOSE ] \fIstatement\fR
where \fIoption\fR can be one of:
ANALYZE [ \fIboolean\fR ]
VERBOSE [ \fIboolean\fR ]
COSTS [ \fIboolean\fR ]
BUFFERS [ \fIboolean\fR ]
TIMING [ \fIboolean\fR ]
FORMAT { TEXT | XML | JSON | YAML }
.fi
.SH "DESCRIPTION"
.PP
This command displays the execution plan that the
PostgreSQL
planner generates for the supplied statement\&. The execution plan shows how the table(s) referenced by the statement will be scanned \(em by plain sequential scan, index scan, etc\&. \(em and if multiple tables are referenced, what join algorithms will be used to bring together the required rows from each input table\&.
.PP
The most critical part of the display is the estimated statement execution cost, which is the planner\*(Aqs guess at how long it will take to run the statement (measured in cost units that are arbitrary, but conventionally mean disk page fetches)\&. Actually two numbers are shown: the start\-up cost before the first row can be returned, and the total cost to return all the rows\&. For most queries the total cost is what matters, but in contexts such as a subquery in
EXISTS, the planner will choose the smallest start\-up cost instead of the smallest total cost (since the executor will stop after getting one row, anyway)\&. Also, if you limit the number of rows to return with a
LIMIT
clause, the planner makes an appropriate interpolation between the endpoint costs to estimate which plan is really the cheapest\&.
.PP
The
ANALYZE
option causes the statement to be actually executed, not only planned\&. Then actual run time statistics are added to the display, including the total elapsed time expended within each plan node (in milliseconds) and the total number of rows it actually returned\&. This is useful for seeing whether the planner\*(Aqs estimates are close to reality\&.
.if n \{\
.sp
.\}
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBImportant\fR
.ps -1
.br
.PP
Keep in mind that the statement is actually executed when the
ANALYZE
option is used\&. Although
\fBEXPLAIN\fR
will discard any output that a
\fBSELECT\fR
would return, other side effects of the statement will happen as usual\&. If you wish to use
\fBEXPLAIN ANALYZE\fR
on an
\fBINSERT\fR,
\fBUPDATE\fR,
\fBDELETE\fR,
\fBCREATE TABLE AS\fR, or
\fBEXECUTE\fR
statement without letting the command affect your data, use this approach:
.sp
.if n \{\
.RS 4
.\}
.nf
BEGIN;
EXPLAIN ANALYZE \&.\&.\&.;
ROLLBACK;
.fi
.if n \{\
.RE
.\}
.sp .5v
.RE
.PP
Only the
ANALYZE
and
VERBOSE
options can be specified, and only in that order, without surrounding the option list in parentheses\&. Prior to
PostgreSQL
9\&.0, the unparenthesized syntax was the only one supported\&. It is expected that all new options will be supported only in the parenthesized syntax\&.
.SH "PARAMETERS"
.PP
ANALYZE
.RS 4
Carry out the command and show actual run times and other statistics\&. This parameter defaults to
FALSE\&.
.RE
.PP
VERBOSE
.RS 4
Display additional information regarding the plan\&. Specifically, include the output column list for each node in the plan tree, schema\-qualify table and function names, always label variables in expressions with their range table alias, and always print the name of each trigger for which statistics are displayed\&. This parameter defaults to
FALSE\&.
.RE
.PP
COSTS
.RS 4
Include information on the estimated startup and total cost of each plan node, as well as the estimated number of rows and the estimated width of each row\&. This parameter defaults to
TRUE\&.
.RE
.PP
BUFFERS
.RS 4
Include information on buffer usage\&. Specifically, include the number of shared blocks hit, read, dirtied, and written, the number of local blocks hit, read, dirtied, and written, and the number of temp blocks read and written\&. A
\fIhit\fR
means that a read was avoided because the block was found already in cache when needed\&. Shared blocks contain data from regular tables and indexes; local blocks contain data from temporary tables and indexes; while temp blocks contain short\-term working data used in sorts, hashes, Materialize plan nodes, and similar cases\&. The number of blocks
\fIdirtied\fR
indicates the number of previously unmodified blocks that were changed by this query; while the number of blocks
\fIwritten\fR
indicates the number of previously\-dirtied blocks evicted from cache by this backend during query processing\&. The number of blocks shown for an upper\-level node includes those used by all its child nodes\&. In text format, only non\-zero values are printed\&. This parameter may only be used when
ANALYZE
is also enabled\&. It defaults to
FALSE\&.
.RE
.PP
TIMING
.RS 4
Include actual startup time and time spent in each node in the output\&. The overhead of repeatedly reading the system clock can slow down the query significantly on some systems, so it may be useful to set this parameter to
FALSE
when only actual row counts, and not exact times, are needed\&. Run time of the entire statement is always measured, even when node\-level timing is turned off with this option\&. This parameter may only be used when
ANALYZE
is also enabled\&. It defaults to
TRUE\&.
.RE
.PP
FORMAT
.RS 4
Specify the output format, which can be TEXT, XML, JSON, or YAML\&. Non\-text output contains the same information as the text output format, but is easier for programs to parse\&. This parameter defaults to
TEXT\&.
.RE
.PP
\fIboolean\fR
.RS 4
Specifies whether the selected option should be turned on or off\&. You can write
TRUE,
ON, or
1
to enable the option, and
FALSE,
OFF, or
0
to disable it\&. The
\fIboolean\fR
value can also be omitted, in which case
TRUE
is assumed\&.
.RE
.PP
\fIstatement\fR
.RS 4
Any
\fBSELECT\fR,
\fBINSERT\fR,
\fBUPDATE\fR,
\fBDELETE\fR,
\fBVALUES\fR,
\fBEXECUTE\fR,
\fBDECLARE\fR,
\fBCREATE TABLE AS\fR, or
\fBCREATE MATERIALIZED VIEW AS\fR
statement, whose execution plan you wish to see\&.
.RE
.SH "OUTPUTS"
.PP
The command\*(Aqs result is a textual description of the plan selected for the
\fIstatement\fR, optionally annotated with execution statistics\&.
Section 14.1, \(lqUsing EXPLAIN\(rq, in the documentation
describes the information provided\&.
.SH "NOTES"
.PP
In order to allow the
PostgreSQL
query planner to make reasonably informed decisions when optimizing queries, the
pg_statistic
data should be up\-to\-date for all tables used in the query\&. Normally the
autovacuum daemon
will take care of that automatically\&. But if a table has recently had substantial changes in its contents, you might need to do a manual
\fBANALYZE\fR(7)
rather than wait for autovacuum to catch up with the changes\&.
.PP
In order to measure the run\-time cost of each node in the execution plan, the current implementation of
\fBEXPLAIN ANALYZE\fR
adds profiling overhead to query execution\&. As a result, running
\fBEXPLAIN ANALYZE\fR
on a query can sometimes take significantly longer than executing the query normally\&. The amount of overhead depends on the nature of the query, as well as the platform being used\&. The worst case occurs for plan nodes that in themselves require very little time per execution, and on machines that have relatively slow operating system calls for obtaining the time of day\&.
.SH "EXAMPLES"
.PP
To show the plan for a simple query on a table with a single
integer
column and 10000 rows:
.sp
.if n \{\
.RS 4
.\}
.nf
EXPLAIN SELECT * FROM foo;
QUERY PLAN
\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
Seq Scan on foo (cost=0\&.00\&.\&.155\&.00 rows=10000 width=4)
(1 row)
.fi
.if n \{\
.RE
.\}
.PP
Here is the same query, with JSON output formatting:
.sp
.if n \{\
.RS 4
.\}
.nf
EXPLAIN (FORMAT JSON) SELECT * FROM foo;
QUERY PLAN
\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
[ +
{ +
"Plan": { +
"Node Type": "Seq Scan",+
"Relation Name": "foo", +
"Alias": "foo", +
"Startup Cost": 0\&.00, +
"Total Cost": 155\&.00, +
"Plan Rows": 10000, +
"Plan Width": 4 +
} +
} +
]
(1 row)
.fi
.if n \{\
.RE
.\}
.PP
If there is an index and we use a query with an indexable
WHERE
condition,
\fBEXPLAIN\fR
might show a different plan:
.sp
.if n \{\
.RS 4
.\}
.nf
EXPLAIN SELECT * FROM foo WHERE i = 4;
QUERY PLAN
\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
Index Scan using fi on foo (cost=0\&.00\&.\&.5\&.98 rows=1 width=4)
Index Cond: (i = 4)
(2 rows)
.fi
.if n \{\
.RE
.\}
.PP
Here is the same query, but in YAML format:
.sp
.if n \{\
.RS 4
.\}
.nf
EXPLAIN (FORMAT YAML) SELECT * FROM foo WHERE i=\*(Aq4\*(Aq;
QUERY PLAN
\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
\- Plan: +
Node Type: "Index Scan" +
Scan Direction: "Forward"+
Index Name: "fi" +
Relation Name: "foo" +
Alias: "foo" +
Startup Cost: 0\&.00 +
Total Cost: 5\&.98 +
Plan Rows: 1 +
Plan Width: 4 +
Index Cond: "(i = 4)"
(1 row)
.fi
.if n \{\
.RE
.\}
.sp
XML format is left as an exercise for the reader\&.
.PP
Here is the same plan with cost estimates suppressed:
.sp
.if n \{\
.RS 4
.\}
.nf
EXPLAIN (COSTS FALSE) SELECT * FROM foo WHERE i = 4;
QUERY PLAN
\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
Index Scan using fi on foo
Index Cond: (i = 4)
(2 rows)
.fi
.if n \{\
.RE
.\}
.PP
Here is an example of a query plan for a query using an aggregate function:
.sp
.if n \{\
.RS 4
.\}
.nf
EXPLAIN SELECT sum(i) FROM foo WHERE i < 10;
QUERY PLAN
\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
Aggregate (cost=23\&.93\&.\&.23\&.93 rows=1 width=4)
\-> Index Scan using fi on foo (cost=0\&.00\&.\&.23\&.92 rows=6 width=4)
Index Cond: (i < 10)
(3 rows)
.fi
.if n \{\
.RE
.\}
.PP
Here is an example of using
\fBEXPLAIN EXECUTE\fR
to display the execution plan for a prepared query:
.sp
.if n \{\
.RS 4
.\}
.nf
PREPARE query(int, int) AS SELECT sum(bar) FROM test
WHERE id > $1 AND id < $2
GROUP BY foo;
EXPLAIN ANALYZE EXECUTE query(100, 200);
QUERY PLAN
\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
HashAggregate (cost=9\&.54\&.\&.9\&.54 rows=1 width=8) (actual time=0\&.156\&.\&.0\&.161 rows=11 loops=1)
Group Key: foo
\-> Index Scan using test_pkey on test (cost=0\&.29\&.\&.9\&.29 rows=50 width=8) (actual time=0\&.039\&.\&.0\&.091 rows=99 loops=1)
Index Cond: ((id > $1) AND (id < $2))
Planning time: 0\&.197 ms
Execution time: 0\&.225 ms
(6 rows)
.fi
.if n \{\
.RE
.\}
.PP
Of course, the specific numbers shown here depend on the actual contents of the tables involved\&. Also note that the numbers, and even the selected query strategy, might vary between
PostgreSQL
releases due to planner improvements\&. In addition, the
\fBANALYZE\fR
command uses random sampling to estimate data statistics; therefore, it is possible for cost estimates to change after a fresh run of
\fBANALYZE\fR, even if the actual distribution of data in the table has not changed\&.
.SH "COMPATIBILITY"
.PP
There is no
\fBEXPLAIN\fR
statement defined in the SQL standard\&.
.SH "SEE ALSO"
\fBANALYZE\fR(7)
man/man7/COMMIT_PREPARED.7 0000644 00000005124 14751153421 0010530 0 ustar 00 '\" t
.\" Title: COMMIT PREPARED
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "COMMIT PREPARED" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
COMMIT_PREPARED \- commit a transaction that was earlier prepared for two\-phase commit
.SH "SYNOPSIS"
.sp
.nf
COMMIT PREPARED \fItransaction_id\fR
.fi
.SH "DESCRIPTION"
.PP
\fBCOMMIT PREPARED\fR
commits a transaction that is in prepared state\&.
.SH "PARAMETERS"
.PP
\fItransaction_id\fR
.RS 4
The transaction identifier of the transaction that is to be committed\&.
.RE
.SH "NOTES"
.PP
To commit a prepared transaction, you must be either the same user that executed the transaction originally, or a superuser\&. But you do not have to be in the same session that executed the transaction\&.
.PP
This command cannot be executed inside a transaction block\&. The prepared transaction is committed immediately\&.
.PP
All currently available prepared transactions are listed in the
pg_prepared_xacts
system view\&.
.SH "EXAMPLES"
.PP
Commit the transaction identified by the transaction identifier
foobar:
.sp
.if n \{\
.RS 4
.\}
.nf
COMMIT PREPARED \*(Aqfoobar\*(Aq;
.fi
.if n \{\
.RE
.\}
.SH "COMPATIBILITY"
.PP
\fBCOMMIT PREPARED\fR
is a
PostgreSQL
extension\&. It is intended for use by external transaction management systems, some of which are covered by standards (such as X/Open XA), but the SQL side of those systems is not standardized\&.
.SH "SEE ALSO"
PREPARE TRANSACTION (\fBPREPARE_TRANSACTION\fR(7)), ROLLBACK PREPARED (\fBROLLBACK_PREPARED\fR(7))
man/man7/DROP_COLLATION.7 0000644 00000004666 14751153421 0010440 0 ustar 00 '\" t
.\" Title: DROP COLLATION
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "DROP COLLATION" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
DROP_COLLATION \- remove a collation
.SH "SYNOPSIS"
.sp
.nf
DROP COLLATION [ IF EXISTS ] \fIname\fR [ CASCADE | RESTRICT ]
.fi
.SH "DESCRIPTION"
.PP
\fBDROP COLLATION\fR
removes a previously defined collation\&. To be able to drop a collation, you must own the collation\&.
.SH "PARAMETERS"
.PP
IF EXISTS
.RS 4
Do not throw an error if the collation does not exist\&. A notice is issued in this case\&.
.RE
.PP
\fIname\fR
.RS 4
The name of the collation\&. The collation name can be schema\-qualified\&.
.RE
.PP
CASCADE
.RS 4
Automatically drop objects that depend on the collation, and in turn all objects that depend on those objects (see
Section 5.13, \(lqDependency Tracking\(rq, in the documentation)\&.
.RE
.PP
RESTRICT
.RS 4
Refuse to drop the collation if any objects depend on it\&. This is the default\&.
.RE
.SH "EXAMPLES"
.PP
To drop the collation named
german:
.sp
.if n \{\
.RS 4
.\}
.nf
DROP COLLATION german;
.fi
.if n \{\
.RE
.\}
.SH "COMPATIBILITY"
.PP
The
\fBDROP COLLATION\fR
command conforms to the
SQL
standard, apart from the
IF EXISTS
option, which is a
PostgreSQL
extension\&.
.SH "SEE ALSO"
ALTER COLLATION (\fBALTER_COLLATION\fR(7)), CREATE COLLATION (\fBCREATE_COLLATION\fR(7))
man/man7/TRUNCATE.7 0000644 00000014621 14751153421 0007505 0 ustar 00 '\" t
.\" Title: TRUNCATE
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "TRUNCATE" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
TRUNCATE \- empty a table or set of tables
.SH "SYNOPSIS"
.sp
.nf
TRUNCATE [ TABLE ] [ ONLY ] \fIname\fR [ * ] [, \&.\&.\&. ]
[ RESTART IDENTITY | CONTINUE IDENTITY ] [ CASCADE | RESTRICT ]
.fi
.SH "DESCRIPTION"
.PP
\fBTRUNCATE\fR
quickly removes all rows from a set of tables\&. It has the same effect as an unqualified
\fBDELETE\fR
on each table, but since it does not actually scan the tables it is faster\&. Furthermore, it reclaims disk space immediately, rather than requiring a subsequent
\fBVACUUM\fR
operation\&. This is most useful on large tables\&.
.SH "PARAMETERS"
.PP
\fIname\fR
.RS 4
The name (optionally schema\-qualified) of a table to truncate\&. If
ONLY
is specified before the table name, only that table is truncated\&. If
ONLY
is not specified, the table and all its descendant tables (if any) are truncated\&. Optionally,
*
can be specified after the table name to explicitly indicate that descendant tables are included\&.
.RE
.PP
RESTART IDENTITY
.RS 4
Automatically restart sequences owned by columns of the truncated table(s)\&.
.RE
.PP
CONTINUE IDENTITY
.RS 4
Do not change the values of sequences\&. This is the default\&.
.RE
.PP
CASCADE
.RS 4
Automatically truncate all tables that have foreign\-key references to any of the named tables, or to any tables added to the group due to
CASCADE\&.
.RE
.PP
RESTRICT
.RS 4
Refuse to truncate if any of the tables have foreign\-key references from tables that are not listed in the command\&. This is the default\&.
.RE
.SH "NOTES"
.PP
You must have the
TRUNCATE
privilege on a table to truncate it\&.
.PP
\fBTRUNCATE\fR
acquires an
ACCESS EXCLUSIVE
lock on each table it operates on, which blocks all other concurrent operations on the table\&. When
RESTART IDENTITY
is specified, any sequences that are to be restarted are likewise locked exclusively\&. If concurrent access to a table is required, then the
\fBDELETE\fR
command should be used instead\&.
.PP
\fBTRUNCATE\fR
cannot be used on a table that has foreign\-key references from other tables, unless all such tables are also truncated in the same command\&. Checking validity in such cases would require table scans, and the whole point is not to do one\&. The
CASCADE
option can be used to automatically include all dependent tables \(em but be very careful when using this option, or else you might lose data you did not intend to!
.PP
\fBTRUNCATE\fR
will not fire any
ON DELETE
triggers that might exist for the tables\&. But it will fire
ON TRUNCATE
triggers\&. If
ON TRUNCATE
triggers are defined for any of the tables, then all
BEFORE TRUNCATE
triggers are fired before any truncation happens, and all
AFTER TRUNCATE
triggers are fired after the last truncation is performed and any sequences are reset\&. The triggers will fire in the order that the tables are to be processed (first those listed in the command, and then any that were added due to cascading)\&.
.PP
\fBTRUNCATE\fR
is not MVCC\-safe\&. After truncation, the table will appear empty to concurrent transactions, if they are using a snapshot taken before the truncation occurred\&. See
Section 13.5, \(lqCaveats\(rq, in the documentation
for more details\&.
.PP
\fBTRUNCATE\fR
is transaction\-safe with respect to the data in the tables: the truncation will be safely rolled back if the surrounding transaction does not commit\&.
.PP
When
RESTART IDENTITY
is specified, the implied
\fBALTER SEQUENCE RESTART\fR
operations are also done transactionally; that is, they will be rolled back if the surrounding transaction does not commit\&. This is unlike the normal behavior of
\fBALTER SEQUENCE RESTART\fR\&. Be aware that if any additional sequence operations are done on the restarted sequences before the transaction rolls back, the effects of these operations on the sequences will be rolled back, but not their effects on
\fBcurrval()\fR; that is, after the transaction
\fBcurrval()\fR
will continue to reflect the last sequence value obtained inside the failed transaction, even though the sequence itself may no longer be consistent with that\&. This is similar to the usual behavior of
\fBcurrval()\fR
after a failed transaction\&.
.PP
\fBTRUNCATE\fR
is not currently supported for foreign tables\&. This implies that if a specified table has any descendant tables that are foreign, the command will fail\&.
.SH "EXAMPLES"
.PP
Truncate the tables
bigtable
and
fattable:
.sp
.if n \{\
.RS 4
.\}
.nf
TRUNCATE bigtable, fattable;
.fi
.if n \{\
.RE
.\}
.PP
The same, and also reset any associated sequence generators:
.sp
.if n \{\
.RS 4
.\}
.nf
TRUNCATE bigtable, fattable RESTART IDENTITY;
.fi
.if n \{\
.RE
.\}
.PP
Truncate the table
othertable, and cascade to any tables that reference
othertable
via foreign\-key constraints:
.sp
.if n \{\
.RS 4
.\}
.nf
TRUNCATE othertable CASCADE;
.fi
.if n \{\
.RE
.\}
.SH "COMPATIBILITY"
.PP
The SQL:2008 standard includes a
\fBTRUNCATE\fR
command with the syntax
TRUNCATE TABLE \fItablename\fR\&. The clauses
CONTINUE IDENTITY/RESTART IDENTITY
also appear in that standard, but have slightly different though related meanings\&. Some of the concurrency behavior of this command is left implementation\-defined by the standard, so the above notes should be considered and compared with other implementations if necessary\&.
man/man7/EXECUTE.7 0000644 00000005637 14751153421 0007371 0 ustar 00 '\" t
.\" Title: EXECUTE
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "EXECUTE" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
EXECUTE \- execute a prepared statement
.SH "SYNOPSIS"
.sp
.nf
EXECUTE \fIname\fR [ ( \fIparameter\fR [, \&.\&.\&.] ) ]
.fi
.SH "DESCRIPTION"
.PP
\fBEXECUTE\fR
is used to execute a previously prepared statement\&. Since prepared statements only exist for the duration of a session, the prepared statement must have been created by a
\fBPREPARE\fR
statement executed earlier in the current session\&.
.PP
If the
\fBPREPARE\fR
statement that created the statement specified some parameters, a compatible set of parameters must be passed to the
\fBEXECUTE\fR
statement, or else an error is raised\&. Note that (unlike functions) prepared statements are not overloaded based on the type or number of their parameters; the name of a prepared statement must be unique within a database session\&.
.PP
For more information on the creation and usage of prepared statements, see
\fBPREPARE\fR(7)\&.
.SH "PARAMETERS"
.PP
\fIname\fR
.RS 4
The name of the prepared statement to execute\&.
.RE
.PP
\fIparameter\fR
.RS 4
The actual value of a parameter to the prepared statement\&. This must be an expression yielding a value that is compatible with the data type of this parameter, as was determined when the prepared statement was created\&.
.RE
.SH "OUTPUTS"
.PP
The command tag returned by
\fBEXECUTE\fR
is that of the prepared statement, and not
EXECUTE\&.
.SH "EXAMPLES"
.PP
Examples are given in the
EXAMPLES
section of the
\fBPREPARE\fR(7)
documentation\&.
.SH "COMPATIBILITY"
.PP
The SQL standard includes an
\fBEXECUTE\fR
statement, but it is only for use in embedded SQL\&. This version of the
\fBEXECUTE\fR
statement also uses a somewhat different syntax\&.
.SH "SEE ALSO"
\fBDEALLOCATE\fR(7), \fBPREPARE\fR(7)
man/man7/ALTER_FOREIGN_TABLE.7 0000644 00000031467 14751153421 0011216 0 ustar 00 '\" t
.\" Title: ALTER FOREIGN TABLE
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "ALTER FOREIGN TABLE" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
ALTER_FOREIGN_TABLE \- change the definition of a foreign table
.SH "SYNOPSIS"
.sp
.nf
ALTER FOREIGN TABLE [ IF EXISTS ] [ ONLY ] \fIname\fR [ * ]
\fIaction\fR [, \&.\&.\&. ]
ALTER FOREIGN TABLE [ IF EXISTS ] [ ONLY ] \fIname\fR [ * ]
RENAME [ COLUMN ] \fIcolumn_name\fR TO \fInew_column_name\fR
ALTER FOREIGN TABLE [ IF EXISTS ] \fIname\fR
RENAME TO \fInew_name\fR
ALTER FOREIGN TABLE [ IF EXISTS ] \fIname\fR
SET SCHEMA \fInew_schema\fR
where \fIaction\fR is one of:
ADD [ COLUMN ] \fIcolumn_name\fR \fIdata_type\fR [ COLLATE \fIcollation\fR ] [ \fIcolumn_constraint\fR [ \&.\&.\&. ] ]
DROP [ COLUMN ] [ IF EXISTS ] \fIcolumn_name\fR [ RESTRICT | CASCADE ]
ALTER [ COLUMN ] \fIcolumn_name\fR [ SET DATA ] TYPE \fIdata_type\fR [ COLLATE \fIcollation\fR ]
ALTER [ COLUMN ] \fIcolumn_name\fR SET DEFAULT \fIexpression\fR
ALTER [ COLUMN ] \fIcolumn_name\fR DROP DEFAULT
ALTER [ COLUMN ] \fIcolumn_name\fR { SET | DROP } NOT NULL
ALTER [ COLUMN ] \fIcolumn_name\fR SET STATISTICS \fIinteger\fR
ALTER [ COLUMN ] \fIcolumn_name\fR SET ( \fIattribute_option\fR = \fIvalue\fR [, \&.\&.\&. ] )
ALTER [ COLUMN ] \fIcolumn_name\fR RESET ( \fIattribute_option\fR [, \&.\&.\&. ] )
ALTER [ COLUMN ] \fIcolumn_name\fR SET STORAGE { PLAIN | EXTERNAL | EXTENDED | MAIN }
ALTER [ COLUMN ] \fIcolumn_name\fR OPTIONS ( [ ADD | SET | DROP ] \fIoption\fR [\*(Aq\fIvalue\fR\*(Aq] [, \&.\&.\&. ])
ADD \fItable_constraint\fR [ NOT VALID ]
VALIDATE CONSTRAINT \fIconstraint_name\fR
DROP CONSTRAINT [ IF EXISTS ] \fIconstraint_name\fR [ RESTRICT | CASCADE ]
DISABLE TRIGGER [ \fItrigger_name\fR | ALL | USER ]
ENABLE TRIGGER [ \fItrigger_name\fR | ALL | USER ]
ENABLE REPLICA TRIGGER \fItrigger_name\fR
ENABLE ALWAYS TRIGGER \fItrigger_name\fR
SET WITH OIDS
SET WITHOUT OIDS
INHERIT \fIparent_table\fR
NO INHERIT \fIparent_table\fR
OWNER TO { \fInew_owner\fR | CURRENT_USER | SESSION_USER }
OPTIONS ( [ ADD | SET | DROP ] \fIoption\fR [\*(Aq\fIvalue\fR\*(Aq] [, \&.\&.\&. ])
.fi
.SH "DESCRIPTION"
.PP
\fBALTER FOREIGN TABLE\fR
changes the definition of an existing foreign table\&. There are several subforms:
.PP
ADD COLUMN
.RS 4
This form adds a new column to the foreign table, using the same syntax as
CREATE FOREIGN TABLE (\fBCREATE_FOREIGN_TABLE\fR(7))\&. Unlike the case when adding a column to a regular table, nothing happens to the underlying storage: this action simply declares that some new column is now accessible through the foreign table\&.
.RE
.PP
DROP COLUMN [ IF EXISTS ]
.RS 4
This form drops a column from a foreign table\&. You will need to say
CASCADE
if anything outside the table depends on the column; for example, views\&. If
IF EXISTS
is specified and the column does not exist, no error is thrown\&. In this case a notice is issued instead\&.
.RE
.PP
SET DATA TYPE
.RS 4
This form changes the type of a column of a foreign table\&. Again, this has no effect on any underlying storage: this action simply changes the type that
PostgreSQL
believes the column to have\&.
.RE
.PP
SET/DROP DEFAULT
.RS 4
These forms set or remove the default value for a column\&. Default values only apply in subsequent
\fBINSERT\fR
or
\fBUPDATE\fR
commands; they do not cause rows already in the table to change\&.
.RE
.PP
SET/DROP NOT NULL
.RS 4
Mark a column as allowing, or not allowing, null values\&.
.RE
.PP
SET STATISTICS
.RS 4
This form sets the per\-column statistics\-gathering target for subsequent
\fBANALYZE\fR(7)
operations\&. See the similar form of
ALTER TABLE (\fBALTER_TABLE\fR(7))
for more details\&.
.RE
.PP
SET ( \fIattribute_option\fR = \fIvalue\fR [, \&.\&.\&. ] )
.br
RESET ( \fIattribute_option\fR [, \&.\&.\&. ] )
.RS 4
This form sets or resets per\-attribute options\&. See the similar form of
ALTER TABLE (\fBALTER_TABLE\fR(7))
for more details\&.
.RE
.PP
SET STORAGE
.RS 4
This form sets the storage mode for a column\&. See the similar form of
ALTER TABLE (\fBALTER_TABLE\fR(7))
for more details\&. Note that the storage mode has no effect unless the table\*(Aqs foreign\-data wrapper chooses to pay attention to it\&.
.RE
.PP
ADD \fItable_constraint\fR [ NOT VALID ]
.RS 4
This form adds a new constraint to a foreign table, using the same syntax as
CREATE FOREIGN TABLE (\fBCREATE_FOREIGN_TABLE\fR(7))\&. Currently only
CHECK
constraints are supported\&.
.sp
Unlike the case when adding a constraint to a regular table, nothing is done to verify the constraint is correct; rather, this action simply declares that some new condition should be assumed to hold for all rows in the foreign table\&. (See the discussion in
CREATE FOREIGN TABLE (\fBCREATE_FOREIGN_TABLE\fR(7))\&.) If the constraint is marked
NOT VALID, then it isn\*(Aqt assumed to hold, but is only recorded for possible future use\&.
.RE
.PP
VALIDATE CONSTRAINT
.RS 4
This form marks as valid a constraint that was previously marked as
NOT VALID\&. No action is taken to verify the constraint, but future queries will assume that it holds\&.
.RE
.PP
DROP CONSTRAINT [ IF EXISTS ]
.RS 4
This form drops the specified constraint on a foreign table\&. If
IF EXISTS
is specified and the constraint does not exist, no error is thrown\&. In this case a notice is issued instead\&.
.RE
.PP
DISABLE/ENABLE [ REPLICA | ALWAYS ] TRIGGER
.RS 4
These forms configure the firing of trigger(s) belonging to the foreign table\&. See the similar form of
ALTER TABLE (\fBALTER_TABLE\fR(7))
for more details\&.
.RE
.PP
SET WITH OIDS
.RS 4
This form adds an
oid
system column to the table (see
Section 5.4, \(lqSystem Columns\(rq, in the documentation)\&. It does nothing if the table already has OIDs\&. Unless the table\*(Aqs foreign\-data wrapper supports OIDs, this column will simply read as zeroes\&.
.sp
Note that this is not equivalent to
ADD COLUMN oid oid; that would add a normal column that happened to be named
oid, not a system column\&.
.RE
.PP
SET WITHOUT OIDS
.RS 4
This form removes the
oid
system column from the table\&. This is exactly equivalent to
DROP COLUMN oid RESTRICT, except that it will not complain if there is already no
oid
column\&.
.RE
.PP
INHERIT \fIparent_table\fR
.RS 4
This form adds the target foreign table as a new child of the specified parent table\&. See the similar form of
ALTER TABLE (\fBALTER_TABLE\fR(7))
for more details\&.
.RE
.PP
NO INHERIT \fIparent_table\fR
.RS 4
This form removes the target foreign table from the list of children of the specified parent table\&.
.RE
.PP
OWNER
.RS 4
This form changes the owner of the foreign table to the specified user\&.
.RE
.PP
OPTIONS ( [ ADD | SET | DROP ] \fIoption\fR [\*(Aq\fIvalue\fR\*(Aq] [, \&.\&.\&. ] )
.RS 4
Change options for the foreign table or one of its columns\&.
ADD,
SET, and
DROP
specify the action to be performed\&.
ADD
is assumed if no operation is explicitly specified\&. Duplicate option names are not allowed (although it\*(Aqs OK for a table option and a column option to have the same name)\&. Option names and values are also validated using the foreign data wrapper library\&.
.RE
.PP
RENAME
.RS 4
The
RENAME
forms change the name of a foreign table or the name of an individual column in a foreign table\&.
.RE
.PP
SET SCHEMA
.RS 4
This form moves the foreign table into another schema\&.
.RE
.PP
All the actions except
RENAME
and
SET SCHEMA
can be combined into a list of multiple alterations to apply in parallel\&. For example, it is possible to add several columns and/or alter the type of several columns in a single command\&.
.PP
If the command is written as
ALTER FOREIGN TABLE IF EXISTS \&.\&.\&.
and the foreign table does not exist, no error is thrown\&. A notice is issued in this case\&.
.PP
You must own the table to use
\fBALTER FOREIGN TABLE\fR\&. To change the schema of a foreign table, you must also have
CREATE
privilege on the new schema\&. To alter the owner, you must also be a direct or indirect member of the new owning role, and that role must have
CREATE
privilege on the table\*(Aqs schema\&. (These restrictions enforce that altering the owner doesn\*(Aqt do anything you couldn\*(Aqt do by dropping and recreating the table\&. However, a superuser can alter ownership of any table anyway\&.) To add a column or alter a column type, you must also have
USAGE
privilege on the data type\&.
.SH "PARAMETERS"
.PP
\fIname\fR
.RS 4
The name (possibly schema\-qualified) of an existing foreign table to alter\&. If
ONLY
is specified before the table name, only that table is altered\&. If
ONLY
is not specified, the table and all its descendant tables (if any) are altered\&. Optionally,
*
can be specified after the table name to explicitly indicate that descendant tables are included\&.
.RE
.PP
\fIcolumn_name\fR
.RS 4
Name of a new or existing column\&.
.RE
.PP
\fInew_column_name\fR
.RS 4
New name for an existing column\&.
.RE
.PP
\fInew_name\fR
.RS 4
New name for the table\&.
.RE
.PP
\fIdata_type\fR
.RS 4
Data type of the new column, or new data type for an existing column\&.
.RE
.PP
\fItable_constraint\fR
.RS 4
New table constraint for the foreign table\&.
.RE
.PP
\fIconstraint_name\fR
.RS 4
Name of an existing constraint to drop\&.
.RE
.PP
CASCADE
.RS 4
Automatically drop objects that depend on the dropped column or constraint (for example, views referencing the column), and in turn all objects that depend on those objects (see
Section 5.13, \(lqDependency Tracking\(rq, in the documentation)\&.
.RE
.PP
RESTRICT
.RS 4
Refuse to drop the column or constraint if there are any dependent objects\&. This is the default behavior\&.
.RE
.PP
\fItrigger_name\fR
.RS 4
Name of a single trigger to disable or enable\&.
.RE
.PP
ALL
.RS 4
Disable or enable all triggers belonging to the foreign table\&. (This requires superuser privilege if any of the triggers are internally generated triggers\&. The core system does not add such triggers to foreign tables, but add\-on code could do so\&.)
.RE
.PP
USER
.RS 4
Disable or enable all triggers belonging to the foreign table except for internally generated triggers\&.
.RE
.PP
\fIparent_table\fR
.RS 4
A parent table to associate or de\-associate with this foreign table\&.
.RE
.PP
\fInew_owner\fR
.RS 4
The user name of the new owner of the table\&.
.RE
.PP
\fInew_schema\fR
.RS 4
The name of the schema to which the table will be moved\&.
.RE
.SH "NOTES"
.PP
The key word
COLUMN
is noise and can be omitted\&.
.PP
Consistency with the foreign server is not checked when a column is added or removed with
ADD COLUMN
or
DROP COLUMN, a
NOT NULL
or
CHECK
constraint is added, or a column type is changed with
SET DATA TYPE\&. It is the user\*(Aqs responsibility to ensure that the table definition matches the remote side\&.
.PP
Refer to
CREATE FOREIGN TABLE (\fBCREATE_FOREIGN_TABLE\fR(7))
for a further description of valid parameters\&.
.SH "EXAMPLES"
.PP
To mark a column as not\-null:
.sp
.if n \{\
.RS 4
.\}
.nf
ALTER FOREIGN TABLE distributors ALTER COLUMN street SET NOT NULL;
.fi
.if n \{\
.RE
.\}
.PP
To change options of a foreign table:
.sp
.if n \{\
.RS 4
.\}
.nf
ALTER FOREIGN TABLE myschema\&.distributors OPTIONS (ADD opt1 \*(Aqvalue\*(Aq, SET opt2 \*(Aqvalue2\*(Aq, DROP opt3 \*(Aqvalue3\*(Aq);
.fi
.if n \{\
.RE
.\}
.SH "COMPATIBILITY"
.PP
The forms
ADD,
DROP, and
SET DATA TYPE
conform with the SQL standard\&. The other forms are
PostgreSQL
extensions of the SQL standard\&. Also, the ability to specify more than one manipulation in a single
\fBALTER FOREIGN TABLE\fR
command is an extension\&.
.PP
\fBALTER FOREIGN TABLE DROP COLUMN\fR
can be used to drop the only column of a foreign table, leaving a zero\-column table\&. This is an extension of SQL, which disallows zero\-column foreign tables\&.
.SH "SEE ALSO"
CREATE FOREIGN TABLE (\fBCREATE_FOREIGN_TABLE\fR(7)), DROP FOREIGN TABLE (\fBDROP_FOREIGN_TABLE\fR(7))
man/man7/MOVE.7 0000644 00000005664 14751153421 0007035 0 ustar 00 '\" t
.\" Title: MOVE
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "MOVE" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
MOVE \- position a cursor
.SH "SYNOPSIS"
.sp
.nf
MOVE [ \fIdirection\fR [ FROM | IN ] ] \fIcursor_name\fR
where \fIdirection\fR can be empty or one of:
NEXT
PRIOR
FIRST
LAST
ABSOLUTE \fIcount\fR
RELATIVE \fIcount\fR
\fIcount\fR
ALL
FORWARD
FORWARD \fIcount\fR
FORWARD ALL
BACKWARD
BACKWARD \fIcount\fR
BACKWARD ALL
.fi
.SH "DESCRIPTION"
.PP
\fBMOVE\fR
repositions a cursor without retrieving any data\&.
\fBMOVE\fR
works exactly like the
\fBFETCH\fR
command, except it only positions the cursor and does not return rows\&.
.PP
The parameters for the
\fBMOVE\fR
command are identical to those of the
\fBFETCH\fR
command; refer to
\fBFETCH\fR(7)
for details on syntax and usage\&.
.SH "OUTPUTS"
.PP
On successful completion, a
\fBMOVE\fR
command returns a command tag of the form
.sp
.if n \{\
.RS 4
.\}
.nf
MOVE \fIcount\fR
.fi
.if n \{\
.RE
.\}
.sp
The
\fIcount\fR
is the number of rows that a
\fBFETCH\fR
command with the same parameters would have returned (possibly zero)\&.
.SH "EXAMPLES"
.sp
.if n \{\
.RS 4
.\}
.nf
BEGIN WORK;
DECLARE liahona CURSOR FOR SELECT * FROM films;
\-\- Skip the first 5 rows:
MOVE FORWARD 5 IN liahona;
MOVE 5
\-\- Fetch the 6th row from the cursor liahona:
FETCH 1 FROM liahona;
code | title | did | date_prod | kind | len
\-\-\-\-\-\-\-+\-\-\-\-\-\-\-\-+\-\-\-\-\-+\-\-\-\-\-\-\-\-\-\-\-\-+\-\-\-\-\-\-\-\-+\-\-\-\-\-\-\-
P_303 | 48 Hrs | 103 | 1982\-10\-22 | Action | 01:37
(1 row)
\-\- Close the cursor liahona and end the transaction:
CLOSE liahona;
COMMIT WORK;
.fi
.if n \{\
.RE
.\}
.SH "COMPATIBILITY"
.PP
There is no
\fBMOVE\fR
statement in the SQL standard\&.
.SH "SEE ALSO"
\fBCLOSE\fR(7), \fBDECLARE\fR(7), \fBFETCH\fR(7)
man/man7/DROP_ACCESS_METHOD.7 0000644 00000004553 14751153421 0011110 0 ustar 00 '\" t
.\" Title: DROP ACCESS METHOD
.\" Author: The PostgreSQL Global Development Group
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 2021
.\" Manual: PostgreSQL 9.6.24 Documentation
.\" Source: PostgreSQL 9.6.24
.\" Language: English
.\"
.TH "DROP ACCESS METHOD" "7" "2021" "PostgreSQL 9.6.24" "PostgreSQL 9.6.24 Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
DROP_ACCESS_METHOD \- remove an access method
.SH "SYNOPSIS"
.sp
.nf
DROP ACCESS METHOD [ IF EXISTS ] \fIname\fR [ CASCADE | RESTRICT ]
.fi
.SH "DESCRIPTION"
.PP
\fBDROP ACCESS METHOD\fR
removes an existing access method\&. Only superusers can drop access methods\&.
.SH "PARAMETERS"
.PP
IF EXISTS
.RS 4
Do not throw an error if the access method does not exist\&. A notice is issued in this case\&.
.RE
.PP
\fIname\fR
.RS 4
The name of an existing access method\&.
.RE
.PP
CASCADE
.RS 4
Automatically drop objects that depend on the access method (such as operator classes, operator families, and indexes), and in turn all objects that depend on those objects (see
Section 5.13, \(lqDependency Tracking\(rq, in the documentation)\&.
.RE
.PP
RESTRICT
.RS 4
Refuse to drop the access method if any objects depend on it\&. This is the default\&.
.RE
.SH "EXAMPLES"
.PP
Drop the access method
heptree:
.sp
.if n \{\
.RS 4
.\}
.nf
DROP ACCESS METHOD heptree;
.fi
.if n \{\
.RE
.\}
.SH "COMPATIBILITY"
.PP
\fBDROP ACCESS METHOD\fR
is a
PostgreSQL
extension\&.
.SH "SEE ALSO"
CREATE ACCESS METHOD (\fBCREATE_ACCESS_METHOD\fR(7))
postgresql-9.6-libs.conf 0000644 00000000024 14751153421 0011056 0 ustar 00 /usr/pgsql-9.6/lib/
man/man3/CURLOPT_SSL_ENABLE_NPN.3 0000644 00000004161 14751172371 0011645 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_SSL_ENABLE_NPN 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_SSL_ENABLE_NPN \- use NPN
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_SSL_ENABLE_NPN, long npn);
.fi
.SH DESCRIPTION
Deprecated in 7.86.0. Setting this option has no function.
Pass a long as parameter, 0 or 1 where 1 is for enable and 0 for disable. This
option enables/disables NPN in the SSL handshake (if the SSL backend libcurl
is built to use supports it), which can be used to negotiate http2.
.SH DEFAULT
1, enabled
.SH PROTOCOLS
HTTP
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/");
curl_easy_setopt(curl, CURLOPT_SSL_ENABLE_NPN, 1L);
ret = curl_easy_perform(curl);
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Added in 7.36.0. Deprecated in 7.86.0.
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR CURLOPT_SSL_ENABLE_ALPN (3),
.BR CURLOPT_SSL_OPTIONS (3)
man/man3/CURLOPT_HTTPPROXYTUNNEL.3 0000644 00000005546 14751172371 0012042 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_HTTPPROXYTUNNEL 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_HTTPPROXYTUNNEL \- tunnel through HTTP proxy
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_HTTPPROXYTUNNEL, long tunnel);
.fi
.SH DESCRIPTION
Set the \fBtunnel\fP parameter to 1L to make libcurl tunnel all operations
through the HTTP proxy (set with \fICURLOPT_PROXY(3)\fP). There is a big
difference between using a proxy and to tunnel through it.
Tunneling means that an HTTP CONNECT request is sent to the proxy, asking it
to connect to a remote host on a specific port number and then the traffic is
just passed through the proxy. Proxies tend to white-list specific port numbers
it allows CONNECT requests to and often only port 80 and 443 are allowed.
To suppress proxy CONNECT response headers from user callbacks use
\fICURLOPT_SUPPRESS_CONNECT_HEADERS(3)\fP.
HTTP proxies can generally only speak HTTP (for obvious reasons), which makes
libcurl convert non-HTTP requests to HTTP when using an HTTP proxy without
this tunnel option set. For example, asking for an FTP URL and specifying an
HTTP proxy makes libcurl send an FTP URL in an HTTP GET request to the
proxy. By instead tunneling through the proxy, you avoid that conversion (that
rarely works through the proxy anyway).
.SH DEFAULT
0
.SH PROTOCOLS
All network protocols
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "ftp://example.com/file.txt");
curl_easy_setopt(curl, CURLOPT_PROXY, "http://127.0.0.1:80");
curl_easy_setopt(curl, CURLOPT_HTTPPROXYTUNNEL, 1L);
curl_easy_perform(curl);
}
.fi
.SH AVAILABILITY
Always
.SH RETURN VALUE
Returns CURLE_OK
.SH "SEE ALSO"
.BR CURLOPT_PROXY (3),
.BR CURLOPT_PROXYTYPE (3),
.BR CURLOPT_PROXYPORT (3)
man/man3/CURLOPT_TLSAUTH_TYPE.3 0000644 00000005140 14751172371 0011446 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_TLSAUTH_TYPE 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_TLSAUTH_TYPE \- TLS authentication methods
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_TLSAUTH_TYPE, char *type);
.fi
.SH DESCRIPTION
Pass a pointer to a null-terminated string as parameter. The string should be
the method of the TLS authentication. Supported method is "SRP".
.IP SRP
TLS-SRP authentication. Secure Remote Password authentication for TLS is
defined in RFC 5054 and provides mutual authentication if both sides have a
shared secret. To use TLS-SRP, you must also set the
\fICURLOPT_TLSAUTH_USERNAME(3)\fP and \fICURLOPT_TLSAUTH_PASSWORD(3)\fP
options.
The application does not have to keep the string around after setting this
option.
TLS SRP does not work with TLS 1.3.
.SH DEFAULT
blank
.SH PROTOCOLS
All TLS-based protocols
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/");
curl_easy_setopt(curl, CURLOPT_TLSAUTH_TYPE, "SRP");
curl_easy_setopt(curl, CURLOPT_TLSAUTH_USERNAME, "user");
curl_easy_setopt(curl, CURLOPT_TLSAUTH_PASSWORD, "secret");
ret = curl_easy_perform(curl);
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
You need to build libcurl with GnuTLS or OpenSSL with TLS-SRP support for this
to work. Added in 7.21.4
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR CURLOPT_TLSAUTH_USERNAME (3),
.BR CURLOPT_TLSAUTH_PASSWORD (3)
man/man3/CURLOPT_PROXY_KEYPASSWD.3 0000644 00000004652 14751172371 0012043 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_PROXY_KEYPASSWD 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_PROXY_KEYPASSWD \- passphrase for the proxy private key
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_PROXY_KEYPASSWD, char *pwd);
.fi
.SH DESCRIPTION
This option is for connecting to an HTTPS proxy, not an HTTPS server.
Pass a pointer to a null-terminated string as parameter. It is used as the
password required to use the \fICURLOPT_PROXY_SSLKEY(3)\fP private key. You
never need a pass phrase to load a certificate but you need one to load your
private key.
The application does not have to keep the string around after setting this
option.
.SH DEFAULT
NULL
.SH PROTOCOLS
Used with HTTPS proxy
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/foo.bin");
curl_easy_setopt(curl, CURLOPT_PROXY, "https://proxy:443");
curl_easy_setopt(curl, CURLOPT_PROXY_KEYPASSWD, "superman");
ret = curl_easy_perform(curl);
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Added in 7.52.0
.SH RETURN VALUE
Returns CURLE_OK if TLS enabled, CURLE_UNKNOWN_OPTION if not, or
CURLE_OUT_OF_MEMORY if there was insufficient heap space.
.SH "SEE ALSO"
.BR CURLOPT_KEYPASSWD (3),
.BR CURLOPT_PROXY_SSLKEY (3),
.BR CURLOPT_SSH_PRIVATE_KEYFILE (3),
.BR CURLOPT_SSLKEY (3)
man/man3/curl_getdate.3 0000644 00000012050 14751172371 0010711 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
a.TH curl_getdate 3 "12 Aug 2005" "libcurl" "libcurl"
.SH NAME
curl_getdate - Convert a date string to number of seconds
.SH SYNOPSIS
.nf
#include <curl/curl.h>
time_t curl_getdate(char *datestring, time_t *now);
.fi
.SH DESCRIPTION
\fIcurl_getdate(3)\fP returns the number of seconds since the Epoch, January
1st 1970 00:00:00 in the UTC time zone, for the date and time that the
\fIdatestring\fP parameter specifies. The \fInow\fP parameter is not used,
pass a NULL there.
This function works with valid dates and does not always detect and reject
wrong dates, such as February 30.
.SH PARSING DATES AND TIMES
A "date" is a string containing several items separated by whitespace. The
order of the items is immaterial. A date string may contain many flavors of
items:
.TP 0.8i
.B calendar date items
Can be specified several ways. Month names can only be three-letter English
abbreviations, numbers can be zero-prefixed and the year may use 2 or 4
digits. Examples: 06 Nov 1994, 06-Nov-94 and Nov-94 6.
.TP
.B time of the day items
This string specifies the time on a given day. You must specify it with 6
digits with two colons: HH:MM:SS. If there is no time given in a provided date
string, 00:00:00 is assumed. Example: 18:19:21.
.TP
.B time zone items
Specifies international time zone. There are a few acronyms supported, but in
general you should instead use the specific relative time compared to
UTC. Supported formats include: -1200, MST, +0100.
.TP
.B day of the week items
Specifies a day of the week. Days of the week may be spelled out in full
(using English): `Sunday', `Monday', etc or they may be abbreviated to their
first three letters. This is usually not info that adds anything.
.TP
.B pure numbers
If a decimal number of the form YYYYMMDD appears, then YYYY is read as the
year, MM as the month number and DD as the day of the month, for the specified
calendar date.
.SH EXAMPLE
.nf
time_t t;
t = curl_getdate("Sun, 06 Nov 1994 08:49:37 GMT", NULL);
t = curl_getdate("Sunday, 06-Nov-94 08:49:37 GMT", NULL);
t = curl_getdate("Sun Nov 6 08:49:37 1994", NULL);
t = curl_getdate("06 Nov 1994 08:49:37 GMT", NULL);
t = curl_getdate("06-Nov-94 08:49:37 GMT", NULL);
t = curl_getdate("Nov 6 08:49:37 1994", NULL);
t = curl_getdate("06 Nov 1994 08:49:37", NULL);
t = curl_getdate("06-Nov-94 08:49:37", NULL);
t = curl_getdate("1994 Nov 6 08:49:37", NULL);
t = curl_getdate("GMT 08:49:37 06-Nov-94 Sunday", NULL);
t = curl_getdate("94 6 Nov 08:49:37", NULL);
t = curl_getdate("1994 Nov 6", NULL);
t = curl_getdate("06-Nov-94", NULL);
t = curl_getdate("Sun Nov 6 94", NULL);
t = curl_getdate("1994.Nov.6", NULL);
t = curl_getdate("Sun/Nov/6/94/GMT", NULL);
t = curl_getdate("Sun, 06 Nov 1994 08:49:37 CET", NULL);
t = curl_getdate("06 Nov 1994 08:49:37 EST", NULL);
t = curl_getdate("Sun, 12 Sep 2004 15:05:58 -0700", NULL);
t = curl_getdate("Sat, 11 Sep 2004 21:32:11 +0200", NULL);
t = curl_getdate("20040912 15:05:58 -0700", NULL);
t = curl_getdate("20040911 +0200", NULL);
.fi
.SH STANDARDS
This parser handles date formats specified in RFC 822 (including the update in
RFC 1123) using time zone name or time zone delta and RFC 850 (obsoleted by
RFC 1036) and ANSI C's \fIasctime()\fP format.
These formats are the only ones RFC 7231 says HTTP applications may use.
.SH AVAILABILITY
Always
.SH RETURN VALUE
This function returns -1 when it fails to parse the date string. Otherwise it
returns the number of seconds as described.
On systems with a signed 32 bit time_t: if the year is larger than 2037 or
less than 1903, this function returns -1.
On systems with an unsigned 32 bit time_t: if the year is larger than 2106 or
less than 1970, this function returns -1.
On systems with 64 bit time_t: if the year is less than 1583, this function
returns -1. (The Gregorian calendar was first introduced 1582 so no "real"
dates in this way of doing dates existed before then.)
.SH "SEE ALSO"
.BR curl_easy_escape (3),
.BR curl_easy_unescape (3),
.BR CURLOPT_TIMECONDITION (3),
.BR CURLOPT_TIMEVALUE (3)
man/man3/CURLOPT_DEBUGDATA.3 0000644 00000004362 14751172371 0010746 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_DEBUGDATA 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_DEBUGDATA \- pointer passed to the debug callback
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_DEBUGDATA, void *pointer);
.fi
.SH DESCRIPTION
Pass a \fIpointer\fP to whatever you want passed in to your
\fICURLOPT_DEBUGFUNCTION(3)\fP in the last void * argument. This pointer is
not used by libcurl, it is only passed to the callback.
.SH DEFAULT
NULL
.SH PROTOCOLS
All
.SH EXAMPLE
.nf
int main(void)
{
CURL *curl;
CURLcode res;
struct data my_tracedata;
curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_DEBUGFUNCTION, my_trace);
curl_easy_setopt(curl, CURLOPT_DEBUGDATA, &my_tracedata);
/* the DEBUGFUNCTION has no effect until we enable VERBOSE */
curl_easy_setopt(curl, CURLOPT_VERBOSE, 1L);
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/");
res = curl_easy_perform(curl);
/* always cleanup */
curl_easy_cleanup(curl);
}
return 0;
}
.fi
.SH AVAILABILITY
Always
.SH RETURN VALUE
Returns CURLE_OK
.SH "SEE ALSO"
.BR CURLOPT_DEBUGFUNCTION (3),
.BR CURLOPT_STDERR (3)
man/man3/CURLOPT_PATH_AS_IS.3 0000644 00000004753 14751172371 0011204 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_PATH_AS_IS 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_PATH_AS_IS \- do not handle dot dot sequences
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_PATH_AS_IS, long leaveit);
.fi
.SH DESCRIPTION
Set the long \fIleaveit\fP to 1, to explicitly tell libcurl to not alter the
given path before passing it on to the server.
This instructs libcurl to NOT squash sequences of "/../" or "/./" that may
exist in the URL's path part and that is supposed to be removed according to
RFC 3986 section 5.2.4.
Some server implementations are known to (erroneously) require the dot dot
sequences to remain in the path and some clients want to pass these on in
order to try out server implementations.
By default libcurl normalizes such sequences before using the path.
The corresponding flag for the \fIcurl_url_set(3)\fP function is called
\fBCURLU_PATH_AS_IS\fP.
.SH DEFAULT
0
.SH PROTOCOLS
All
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/../../etc/password");
curl_easy_setopt(curl, CURLOPT_PATH_AS_IS, 1L);
curl_easy_perform(curl);
}
.fi
.SH AVAILABILITY
Added in 7.42.0
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR curl_url_set (3),
.BR CURLOPT_STDERR (3),
.BR CURLOPT_DEBUGFUNCTION (3),
.BR CURLOPT_URL (3)
man/man3/CURLOPT_FRESH_CONNECT.3 0000644 00000004411 14751172371 0011501 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_FRESH_CONNECT 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_FRESH_CONNECT \- force a new connection to be used
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_FRESH_CONNECT, long fresh);
.fi
.SH DESCRIPTION
Pass a long. Set to 1 to make the next transfer use a new (fresh) connection
by force instead of trying to reuse an existing one. This option should be
used with caution and only if you understand what it does as it may impact
performance negatively.
Related functionality is \fICURLOPT_FORBID_REUSE(3)\fP which makes sure the
connection is closed after use so that it cannot be reused.
Set \fIfresh\fP to 0 to have libcurl attempt reusing an existing connection
(default behavior).
.SH DEFAULT
0
.SH PROTOCOLS
Most
.SH EXAMPLE
.nf
{
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/");
curl_easy_setopt(curl, CURLOPT_FRESH_CONNECT, 1L);
/* this transfer must use a new connection, not reuse an existing */
curl_easy_perform(curl);
}
.fi
.SH AVAILABILITY
Always
.SH RETURN VALUE
Returns CURLE_OK
.SH "SEE ALSO"
.BR CURLOPT_FORBID_REUSE (3),
.BR CURLOPT_MAXAGE_CONN (3),
.BR CURLOPT_MAXLIFETIME_CONN (3)
man/man3/CURLOPT_QUICK_EXIT.3 0000644 00000004252 14751172371 0011171 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_QUICK_EXIT 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_QUICK_EXIT \- allow to exit quickly
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_QUICK_EXIT,
long value);
.SH DESCRIPTION
Pass a long as a parameter, 1L meaning that when recovering from a timeout,
libcurl should skip lengthy cleanups that are intended to avoid all kinds of
leaks (threads etc.), as the caller program is about to call exit() anyway.
This allows for a swift termination after a DNS timeout for example, by
canceling and/or forgetting about a resolver thread, at the expense of a
possible (though short-lived) leak of associated resources.
.SH DEFAULT
0
.SH PROTOCOLS
All
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
CURLcode ret;
curl_easy_setopt(curl, CURLOPT_QUICK_EXIT, 1L);
ret = curl_easy_perform(curl);
}
.fi
.SH AVAILABILITY
Added in 7.87.0
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR CURLOPT_FAILONERROR (3),
.BR CURLOPT_RESOLVE (3)
man/man3/CURLINFO_TOTAL_TIME_T.3 0000644 00000004703 14751172371 0011542 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLINFO_TOTAL_TIME_T 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLINFO_TOTAL_TIME_T \- get total time of previous transfer in microseconds
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_getinfo(CURL *handle, CURLINFO_TOTAL_TIME_T,
curl_off_t *timep);
.fi
.SH DESCRIPTION
Pass a pointer to a curl_off_t to receive the total time in microseconds
for the previous transfer, including name resolving, TCP connect etc.
The curl_off_t represents the time in microseconds.
When a redirect is followed, the time from each request is added together.
See also the TIMES overview in the \fIcurl_easy_getinfo(3)\fP man page.
.SH PROTOCOLS
All
.SH EXAMPLE
.nf
curl = curl_easy_init();
if(curl) {
curl_off_t total;
curl_easy_setopt(curl, CURLOPT_URL, url);
res = curl_easy_perform(curl);
if(CURLE_OK == res) {
res = curl_easy_getinfo(curl, CURLINFO_TOTAL_TIME_T, &total);
if(CURLE_OK == res) {
printf("Time: %" CURL_FORMAT_CURL_OFF_T ".%06ld", total / 1000000,
(long)(total % 1000000));
}
}
/* always cleanup */
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Added in 7.61.0
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR curl_easy_getinfo (3),
.BR curl_easy_setopt (3),
.BR CURLINFO_TOTAL_TIME (3),
.BR CURLOPT_TIMEOUT (3)
man/man3/CURLOPT_DOH_URL.3 0000644 00000007126 14751172371 0010623 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_DOH_URL 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_DOH_URL \- provide the DNS-over-HTTPS URL
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_DOH_URL, char *URL);
.fi
.SH DESCRIPTION
Pass in a pointer to a \fIURL\fP for the DoH server to use for name
resolving. The parameter should be a char * to a null-terminated string which
must be URL-encoded in the following format: "https://host:port/path". It MUST
specify an HTTPS URL.
libcurl does not validate the syntax or use this variable until the transfer
is issued. Even if you set a crazy value here, \fIcurl_easy_setopt(3)\fP still
returns \fICURLE_OK\fP.
curl sends POST requests to the given DNS-over-HTTPS URL.
To find the DoH server itself, which might be specified using a name, libcurl
uses the default name lookup function. You can bootstrap that by providing the
address for the DoH server with \fICURLOPT_RESOLVE(3)\fP.
Disable DoH use again by setting this option to NULL.
.SH "INHERIT OPTIONS"
DoH lookups use SSL and some SSL settings from your transfer are inherited,
like \fICURLOPT_SSL_CTX_FUNCTION(3)\fP.
The hostname and peer certificate verification settings are not inherited but
can be controlled separately via \fICURLOPT_DOH_SSL_VERIFYHOST(3)\fP and
\fICURLOPT_DOH_SSL_VERIFYPEER(3)\fP.
A set \fICURLOPT_OPENSOCKETFUNCTION(3)\fP callback is not inherited.
.SH "KNOWN BUGS"
Even when DoH is set to be used with this option, there are still some name
resolves that are performed without it, using the default name resolver
mechanism. This includes name resolves done for \fICURLOPT_INTERFACE(3)\fP,
\fICURLOPT_FTPPORT(3)\fP, a proxy type set to \fBCURLPROXY_SOCKS4\fP or
\fBCURLPROXY_SOCKS5\fP and probably some more.
.SH DEFAULT
NULL - there is no default DoH URL. If this option is not set, libcurl uses
the default name resolver.
.SH PROTOCOLS
All
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
curl_easy_setopt(curl, CURLOPT_DOH_URL, "https://dns.example.com");
curl_easy_perform(curl);
}
.fi
.SH AVAILABILITY
Added in 7.62.0
.SH RETURN VALUE
Returns CURLE_OK on success or CURLE_OUT_OF_MEMORY if there was insufficient
heap space.
Note that \fIcurl_easy_setopt(3)\fP does immediately parse the given string so
when given a bad DoH URL, libcurl might not detect the problem until it later
tries to resolve a name with it.
.SH "SEE ALSO"
.BR CURLOPT_DNS_CACHE_TIMEOUT (3),
.BR CURLOPT_RESOLVE (3),
.BR CURLOPT_VERBOSE (3)
man/man3/curl_multi_get_handles.3 0000644 00000005151 14751172371 0012767 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.TH curl_multi_get_handles 3 "September 26, 2023" "libcurl 8.4.0" "libcurl"
.SH NAME
curl_multi_get_handles - returns all added easy handles
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURL **curl_multi_get_handles(CURLM *multi_handle);
.fi
.SH DESCRIPTION
Returns an array with pointers to all added easy handles. The end of the list
is marked with a NULL pointer.
Even if there is not a single easy handle added, this still returns an array
but with only a single NULL pointer entry.
The returned array contains all the handles that are present at the time of
the call. As soon as a handle has been removed from or a handle has been added
to the multi handle after the handle array was returned, the two data points
are out of sync.
The order of the easy handles within the array is not guaranteed.
The returned array must be freed with a call to \fIcurl_free(3)\fP after use.
.SH EXAMPLE
.nf
/* init a multi stack */
multi_handle = curl_multi_init();
/* add a transfer */
curl_multi_add_handle(multi_handle, http_handle);
/* extract all added handles */
CURL **list = curl_multi_get_handles(multi_handle);
if(list) {
/* remove all added handles */
for(i = 0; list[i]; i++) {
curl_multi_remove_handle(multi_handle, list[i]);
}
curl_free(list);
}
.fi
.SH AVAILABILITY
Added in 8.4.0
.SH RETURN VALUE
Returns NULL on failure. Otherwise it returns a pointer to an allocated array.
.SH "SEE ALSO"
.BR curl_multi_add_handle (3),
.BR curl_multi_cleanup (3),
.BR curl_multi_init (3),
.BR curl_multi_remove_handle (3)
man/man3/CURLOPT_RANGE.3 0000644 00000006000 14751172371 0010311 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_RANGE 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_RANGE \- byte range to request
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_RANGE, char *range);
.fi
.SH DESCRIPTION
Pass a char * as parameter, which should contain the specified range you want
to retrieve. It should be in the format "X-Y", where either X or Y may be left
out and X and Y are byte indexes.
HTTP transfers also support several intervals, separated with commas as in
\fI"X-Y,N-M"\fP. Using this kind of multiple intervals causes the HTTP server
to send the response document in pieces (using standard MIME separation
techniques). Unfortunately, the HTTP standard (RFC 7233 section 3.1) allows
servers to ignore range requests so even when you set \fICURLOPT_RANGE(3)\fP
for a request, you may end up getting the full response sent back.
For RTSP, the formatting of a range should follow RFC 2326 Section 12.29. For
RTSP, byte ranges are \fBnot\fP permitted. Instead, ranges should be given in
\fBnpt\fP, \fButc\fP, or \fBsmpte\fP formats.
For HTTP PUT uploads this option should not be used, since it may conflict with
other options.
Pass a NULL to this option to disable the use of ranges.
The application does not have to keep the string around after setting this
option.
.SH DEFAULT
NULL
.SH PROTOCOLS
HTTP, FTP, FILE, RTSP and SFTP.
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
/* get the first 200 bytes */
curl_easy_setopt(curl, CURLOPT_RANGE, "0-199");
/* Perform the request */
curl_easy_perform(curl);
}
.fi
.SH AVAILABILITY
FILE since 7.18.0, RTSP since 7.20.0
.SH RETURN VALUE
Returns CURLE_OK on success or
CURLE_OUT_OF_MEMORY if there was insufficient heap space.
.SH "SEE ALSO"
.BR CURLOPT_LOW_SPEED_LIMIT (3),
.BR CURLOPT_MAX_RECV_SPEED_LARGE (3),
.BR CURLOPT_MAXFILESIZE_LARGE (3),
.BR CURLOPT_RESUME_FROM (3)
man/man3/CURLOPT_TCP_NODELAY.3 0000644 00000005134 14751172371 0011265 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_TCP_NODELAY 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_TCP_NODELAY \- the TCP_NODELAY option
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_TCP_NODELAY, long nodelay);
.fi
.SH DESCRIPTION
Pass a long specifying whether the \fITCP_NODELAY\fP option is to be set or
cleared (1L = set, 0 = clear). The option is set by default. This has no
effect after the connection has been established.
Setting this option to 1L disables TCP's Nagle algorithm on connections
created using this handle. The purpose of this algorithm is to try to minimize
the number of small packets on the network (where "small packets" means TCP
segments less than the Maximum Segment Size for the network).
Maximizing the amount of data sent per TCP segment is good because it
amortizes the overhead of the send. However, in some cases small segments may
need to be sent without delay. This is less efficient than sending larger
amounts of data at a time, and can contribute to congestion on the network if
overdone.
.SH DEFAULT
1
.SH PROTOCOLS
All
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
/* leave Nagle enabled */
curl_easy_setopt(curl, CURLOPT_TCP_NODELAY, 0);
curl_easy_perform(curl);
}
.fi
.SH AVAILABILITY
Always. The default was changed to 1 from 0 in 7.50.2.
.SH RETURN VALUE
Returns CURLE_OK
.SH "SEE ALSO"
.BR CURLOPT_BUFFERSIZE (3),
.BR CURLOPT_SOCKOPTFUNCTION (3),
.BR CURLOPT_TCP_KEEPALIVE (3)
man/man3/CURLOPT_SSLENGINE_DEFAULT.3 0000644 00000004543 14751172371 0012162 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_SSLENGINE_DEFAULT 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_SSLENGINE_DEFAULT \- make SSL engine default
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_SSLENGINE_DEFAULT, long val);
.fi
.SH DESCRIPTION
Pass a long set to 1 to make the already specified crypto engine the default
for (asymmetric) crypto operations.
This option has no effect unless set after \fICURLOPT_SSLENGINE(3)\fP.
.SH DEFAULT
None
.SH PROTOCOLS
All TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc.
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/");
curl_easy_setopt(curl, CURLOPT_SSLENGINE, "dynamic");
curl_easy_setopt(curl, CURLOPT_SSLENGINE_DEFAULT, 1L);
ret = curl_easy_perform(curl);
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Only if the SSL backend is OpenSSL built with engine support.
.SH RETURN VALUE
CURLE_OK - Engine set as default.
CURLE_SSL_ENGINE_SETFAILED - Engine could not be set as default.
CURLE_NOT_BUILT_IN - Option not built in, OpenSSL is not the SSL backend.
CURLE_UNKNOWN_OPTION - Option not recognized.
CURLE_OUT_OF_MEMORY - Insufficient heap space.
.SH "SEE ALSO"
.BR CURLOPT_SSLENGINE (3),
.BR CURLOPT_SSLCERT (3)
man/man3/CURLINFO_RTSP_CSEQ_RECV.3 0000644 00000004216 14751172371 0011777 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLINFO_RTSP_CSEQ_RECV 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLINFO_RTSP_CSEQ_RECV \- get the recently received CSeq
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_getinfo(CURL *handle, CURLINFO_RTSP_CSEQ_RECV, long *cseq);
.fi
.SH DESCRIPTION
Pass a pointer to a long to receive the most recently received CSeq from the
server. If your application encounters a \fICURLE_RTSP_CSEQ_ERROR\fP then you
may wish to troubleshoot and/or fix the CSeq mismatch by peeking at this
value.
.SH PROTOCOLS
RTSP
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
CURLcode res;
curl_easy_setopt(curl, CURLOPT_URL, "rtsp://rtsp.example.com");
res = curl_easy_perform(curl);
if(res == CURLE_OK) {
long cseq;
curl_easy_getinfo(curl, CURLINFO_RTSP_CSEQ_RECV, &cseq);
}
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Added in 7.20.0
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR curl_easy_getinfo (3),
.BR curl_easy_setopt (3),
.BR CURLINFO_RTSP_SERVER_CSEQ (3)
man/man3/libcurl-share.3 0000644 00000005770 14751172371 0011016 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.TH libcurl-share 3 "September 27, 2023" "libcurl 8.4.0" "libcurl"
.SH NAME
libcurl-share \- how to use the share interface
.SH DESCRIPTION
This is an overview on how to use the libcurl share interface in your C
programs. There are specific man pages for each function mentioned in
here.
All functions in the share interface are prefixed with curl_share.
.SH "OBJECTIVES"
The share interface was added to enable sharing of data between curl
\&"handles".
.SH "ONE SET OF DATA - MANY TRANSFERS"
You can have multiple easy handles share data between them. Have them update
and use the \fBsame\fP cookie database, DNS cache, TLS session cache and/or
connection cache! This way, each single transfer takes advantage from data
updates made by the other transfer(s).
.SH "SHARE OBJECT"
You create a shared object with \fIcurl_share_init(3)\fP. It returns a handle
for a newly created one.
You tell the shared object what data you want it to share by using
\fIcurl_share_setopt(3)\fP.
Since you can use this share from multiple threads, and libcurl has no
internal thread synchronization, you must provide mutex callbacks if you are
using this multi-threaded. You set lock and unlock functions with
\fIcurl_share_setopt(3)\fP too.
Then, you make an easy handle to use this share, you set the
\fICURLOPT_SHARE(3)\fP option with \fIcurl_easy_setopt(3)\fP, and pass in
share handle. You can make any number of easy handles share the same share
handle.
To make an easy handle stop using that particular share, you set
\fICURLOPT_SHARE(3)\fP to NULL for that easy handle. To make a handle stop
sharing a particular data, you can \fICURLSHOPT_UNSHARE(3)\fP it.
When you are done using the share, make sure that no easy handle is still using
it, and call \fIcurl_share_cleanup(3)\fP on the handle.
.SH "SEE ALSO"
.BR curl_share_init (3),
.BR curl_share_setopt (3),
.BR curl_share_cleanup (3),
.BR libcurl-errors (3),
.BR libcurl-easy (3),
.BR libcurl-multi (3)
man/man3/CURLMOPT_MAX_CONCURRENT_STREAMS.3 0000644 00000004201 14751172371 0013160 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLMOPT_MAX_CONCURRENT_STREAMS 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLMOPT_MAX_CONCURRENT_STREAMS \- max concurrent streams for http2
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLMcode curl_multi_setopt(CURLM *handle, CURLMOPT_MAX_CONCURRENT_STREAMS,
long max);
.fi
.SH DESCRIPTION
Pass a long indicating the \fBmax\fP. The set number is used as the maximum
number of concurrent streams for a connections that libcurl should support on
connections done using HTTP/2.
Valid values range from 1 to 2147483647 (2^31 - 1) and defaults to 100. The
value passed here would be honored based on other system resources properties.
.SH DEFAULT
100
.SH PROTOCOLS
All
.SH EXAMPLE
.nf
CURLM *m = curl_multi_init();
/* max concurrent streams 200 */
curl_multi_setopt(m, CURLMOPT_MAX_CONCURRENT_STREAMS, 200L);
.fi
.SH AVAILABILITY
Added in 7.67.0
.SH RETURN VALUE
Returns CURLM_OK if the option is supported, and CURLM_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR CURLMOPT_MAXCONNECTS (3),
.BR CURLOPT_MAXCONNECTS (3)
man/man3/CURLOPT_NOPROXY.3 0000644 00000006533 14751172371 0010646 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_NOPROXY 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_NOPROXY \- disable proxy use for specific hosts
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_NOPROXY, char *noproxy);
.fi
.SH DESCRIPTION
Pass a pointer to a null-terminated string. The string consists of a comma
separated list of host names that do not require a proxy to get reached, even
if one is specified. The only wildcard available is a single * character,
which matches all hosts, and effectively disables the proxy. Each name in this
list is matched as either a domain which contains the hostname, or the
hostname itself. For example, "ample.com" would match ample.com, ample.com:80,
and www.ample.com, but not www.example.com or ample.com.org.
Setting the \fInoproxy\fP string to "" (an empty string) explicitly enables
the proxy for all host names, even if there is an environment variable set for
it.
Enter IPv6 numerical addresses in the list of host names without enclosing
brackets:
"example.com,::1,localhost"
Since 7.86.0, IP addresses specified to this option can be provided using CIDR
notation: an appended slash and number specifies the number of "network bits"
out of the address to use in the comparison. For example "192.168.0.0/16"
would match all addresses starting with "192.168".
The application does not have to keep the string around after setting this
option.
.SH "Environment variables"
If there is an environment variable called \fBno_proxy\fP (or \fBNO_PROXY\fP),
it is used if the \fICURLOPT_NOPROXY(3)\fP option is not set. It works exactly
the same way.
.SH DEFAULT
NULL
.SH PROTOCOLS
Most
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
/* accept various URLs */
curl_easy_setopt(curl, CURLOPT_URL, input);
/* use this proxy */
curl_easy_setopt(curl, CURLOPT_PROXY, "http://proxy:80");
/* ... but make sure this host name is not proxied */
curl_easy_setopt(curl, CURLOPT_NOPROXY, "www.example.com");
curl_easy_perform(curl);
}
.fi
.SH AVAILABILITY
Added in 7.19.4
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, CURLE_UNKNOWN_OPTION if not, or
CURLE_OUT_OF_MEMORY if there was insufficient heap space.
.SH "SEE ALSO"
.BR CURLOPT_PROXY (3),
.BR CURLOPT_PROXYAUTH (3),
.BR CURLOPT_PROXYTYPE (3)
man/man3/CURLOPT_BUFFERSIZE.3 0000644 00000005373 14751172371 0011135 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_BUFFERSIZE 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_BUFFERSIZE \- receive buffer size
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_BUFFERSIZE, long size);
.fi
.SH DESCRIPTION
Pass a long specifying your preferred \fIsize\fP (in bytes) for the receive
buffer in libcurl. The main point of this would be that the write callback
gets called more often and with smaller chunks. Secondly, for some protocols,
there is a benefit of having a larger buffer for performance.
This is just treated as a request, not an order. You cannot be guaranteed to
actually get the given size.
This buffer size is by default \fICURL_MAX_WRITE_SIZE\fP (16kB). The maximum
buffer size allowed to be set is \fICURL_MAX_READ_SIZE\fP (10MB). The minimum
buffer size allowed to be set is 1024.
DO NOT set this option on a handle that is currently used for an active
transfer as that may lead to unintended consequences.
The maximum size was 512kB until 7.88.0.
.SH DEFAULT
CURL_MAX_WRITE_SIZE (16kB)
.SH PROTOCOLS
All
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "sftp://example.com/foo.bin");
/* ask libcurl to allocate a larger receive buffer */
curl_easy_setopt(curl, CURLOPT_BUFFERSIZE, 120000L);
ret = curl_easy_perform(curl);
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Added in 7.10. Growing the buffer was added in 7.53.0.
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR CURLOPT_MAX_RECV_SPEED_LARGE (3),
.BR CURLOPT_MAXFILESIZE (3),
.BR CURLOPT_UPLOAD_BUFFERSIZE (3),
.BR CURLOPT_WRITEFUNCTION (3)
man/man3/CURLOPT_PROXY_SSLVERSION.3 0000644 00000006772 14751172371 0012205 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_PROXY_SSLVERSION 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_PROXY_SSLVERSION \- preferred HTTPS proxy TLS version
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_PROXY_SSLVERSION,
long version);
.fi
.SH DESCRIPTION
Pass a long as parameter to control which version of SSL/TLS to attempt to use
when connecting to an HTTPS proxy.
Use one of the available defines for this purpose. The available options are:
.RS
.IP CURL_SSLVERSION_DEFAULT
The default action. This attempts to figure out the remote SSL protocol
version.
.IP CURL_SSLVERSION_TLSv1
TLSv1.x
.IP CURL_SSLVERSION_TLSv1_0
TLSv1.0
.IP CURL_SSLVERSION_TLSv1_1
TLSv1.1
.IP CURL_SSLVERSION_TLSv1_2
TLSv1.2
.IP CURL_SSLVERSION_TLSv1_3
TLSv1.3
.RE
The maximum TLS version can be set by using \fIone\fP of the
CURL_SSLVERSION_MAX_ macros below. It is also possible to OR \fIone\fP of the
CURL_SSLVERSION_ macros with \fIone\fP of the CURL_SSLVERSION_MAX_ macros.
The MAX macros are not supported for WolfSSL.
.RS
.IP CURL_SSLVERSION_MAX_DEFAULT
The flag defines the maximum supported TLS version as TLSv1.2, or the default
value from the SSL library.
(Added in 7.54.0)
.IP CURL_SSLVERSION_MAX_TLSv1_0
The flag defines maximum supported TLS version as TLSv1.0.
(Added in 7.54.0)
.IP CURL_SSLVERSION_MAX_TLSv1_1
The flag defines maximum supported TLS version as TLSv1.1.
(Added in 7.54.0)
.IP CURL_SSLVERSION_MAX_TLSv1_2
The flag defines maximum supported TLS version as TLSv1.2.
(Added in 7.54.0)
.IP CURL_SSLVERSION_MAX_TLSv1_3
The flag defines maximum supported TLS version as TLSv1.3.
(Added in 7.54.0)
.RE
In versions of curl prior to 7.54 the CURL_SSLVERSION_TLS options were
documented to allow \fIonly\fP the specified TLS version, but behavior was
inconsistent depending on the TLS library.
.SH DEFAULT
CURL_SSLVERSION_DEFAULT
.SH PROTOCOLS
All
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
/* ask libcurl to use TLS version 1.0 or later */
curl_easy_setopt(curl, CURLOPT_SSLVERSION, CURL_SSLVERSION_TLSv1);
/* Perform the request */
curl_easy_perform(curl);
}
.fi
.SH AVAILABILITY
Added in 7.52.0
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR CURLOPT_HTTP_VERSION (3),
.BR CURLOPT_IPRESOLVE (3),
.BR CURLOPT_SSLVERSION (3),
.BR CURLOPT_USE_SSL (3)
man/man3/CURLSHOPT_UNSHARE.3 0000644 00000005457 14751172371 0011034 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.TH CURLSHOPT_UNSHARE 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLSHOPT_UNSHARE - remove data to share
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLSHcode curl_share_setopt(CURLSH *share, CURLSHOPT_UNSHARE, long type);
.fi
.SH DESCRIPTION
The \fItype\fP parameter specifies what specific data that should no longer be
shared and kept in the share object that was created with
\fIcurl_share_init(3)\fP. In other words, stop sharing that data in this
shared object. The given \fItype\fP must be be one of the values described
below. You can set \fICURLSHOPT_UNSHARE(3)\fP multiple times with different
data arguments to remove multiple types from the shared object. Add data to
share again with \fICURLSHOPT_SHARE(3)\fP.
.IP CURL_LOCK_DATA_COOKIE
Cookie data is no longer shared across the easy handles using this shared
object.
.IP CURL_LOCK_DATA_DNS
Cached DNS hosts are no longer shared across the easy handles using this
shared object.
.IP CURL_LOCK_DATA_SSL_SESSION
SSL session IDs are no longer shared across the easy handles using this shared
object.
.IP CURL_LOCK_DATA_CONNECT
The connection cache is no longer shared.
.IP CURL_LOCK_DATA_PSL
The Public Suffix List is no longer shared.
.SH PROTOCOLS
All
.SH EXAMPLE
.nf
CURLSHcode sh;
share = curl_share_init();
sh = curl_share_setopt(share, CURLSHOPT_UNSHARE, CURL_LOCK_DATA_COOKIE);
if(sh)
printf("Error: %s\\n", curl_share_strerror(sh));
.fi
.SH AVAILABILITY
Added in 7.10
.SH RETURN VALUE
CURLSHE_OK (zero) means that the option was set properly, non-zero means an
error occurred. See \fIlibcurl-errors(3)\fP for the full list with
descriptions.
.SH "SEE ALSO"
.BR curl_share_cleanup (3),
.BR curl_share_init (3),
.BR curl_share_setopt (3),
.BR CURLSHOPT_SHARE (3)
man/man3/CURLOPT_DNS_SERVERS.3 0000644 00000004776 14751172371 0011334 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_DNS_SERVERS 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_DNS_SERVERS \- DNS servers to use
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_DNS_SERVERS, char *servers);
.fi
.SH DESCRIPTION
Pass a char * that is the list of DNS servers to be used instead of the system
default. The format of the dns servers option is:
host[:port][,host[:port]]...
For example:
192.168.1.100,192.168.1.101,3.4.5.6
The application does not have to keep the string around after setting this
option.
.SH DEFAULT
NULL - use system default
.SH PROTOCOLS
All
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/foo.bin");
curl_easy_setopt(curl, CURLOPT_DNS_SERVERS, "192.168.1.100:53,192.168.1.101");
ret = curl_easy_perform(curl);
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
This option requires that libcurl was built with a resolver backend that
supports this operation. The c-ares backend is the only such one.
Added in 7.24.0
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, CURLE_UNKNOWN_OPTION if not,
CURLE_NOT_BUILT_IN if support was disabled at compile-time,
CURLE_BAD_FUNCTION_ARGUMENT when given an invalid server list, or
CURLE_OUT_OF_MEMORY if there was insufficient heap space.
.SH "SEE ALSO"
.BR CURLOPT_DNS_CACHE_TIMEOUT (3),
.BR CURLOPT_DNS_LOCAL_IP4 (3),
.BR CURLOPT_DNS_LOCAL_IP6 (3)
man/man3/CURLOPT_PRE_PROXY.3 0000644 00000006524 14751172371 0011117 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_PRE_PROXY 3 "September 27, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_PRE_PROXY \- pre-proxy host to use
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_PRE_PROXY, char *preproxy);
.fi
.SH DESCRIPTION
Set the \fIpreproxy\fP to use for the upcoming request. The parameter
should be a char * to a null-terminated string holding the host name or dotted
numerical IP address. A numerical IPv6 address must be written within
[brackets].
To specify port number in this string, append :[port] to the end of the host
name. The proxy's port number may optionally be specified with the separate
option \fICURLOPT_PROXYPORT(3)\fP. If not specified, libcurl defaults to using
port 1080 for proxies.
A pre proxy is a SOCKS proxy that curl connects to before it connects to the
HTTP(S) proxy specified in the \fICURLOPT_PROXY(3)\fP option. The pre proxy
can only be a SOCKS proxy.
The pre proxy string should be prefixed with [scheme]:// to specify which kind
of socks is used. Use socks4://, socks4a://, socks5:// or socks5h:// (the last
one to enable socks5 and asking the proxy to do the resolving, also known as
\fICURLPROXY_SOCKS5_HOSTNAME\fP type) to request the specific SOCKS version to
be used. Otherwise SOCKS4 is used as default.
Setting the pre proxy string to "" (an empty string) explicitly disables the
use of a pre proxy.
The application does not have to keep the string around after setting this
option.
.SH DEFAULT
Default is NULL, meaning no pre proxy is used.
When you set a host name to use, do not assume that there is any particular
single port number used widely for proxies. Specify it!
.SH PROTOCOLS
All except file://. Note that some protocols do not work well over proxy.
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/file.txt");
curl_easy_setopt(curl, CURLOPT_PRE_PROXY, "socks4://socks-proxy:1080");
curl_easy_setopt(curl, CURLOPT_PROXY, "http://proxy:80");
curl_easy_perform(curl);
}
.fi
.SH AVAILABILITY
Added in 7.52.0
.SH RETURN VALUE
Returns CURLE_OK if proxies are supported, CURLE_UNKNOWN_OPTION if not, or
CURLE_OUT_OF_MEMORY if there was insufficient heap space.
.SH "SEE ALSO"
.BR CURLOPT_PROXY (3),
.BR CURLOPT_HTTPPROXYTUNNEL (3)
man/man3/CURLOPT_ALTSVC.3 0000644 00000005724 14751172371 0010465 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_ALTSVC 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_ALTSVC \- alt-svc cache file name
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_ALTSVC, char *filename);
.fi
.SH DESCRIPTION
Pass in a pointer to a \fIfilename\fP to instruct libcurl to use that file as
the Alt-Svc cache to read existing cache contents from and possibly also write
it back to after a transfer, unless \fBCURLALTSVC_READONLYFILE\fP is set in
\fICURLOPT_ALTSVC_CTRL(3)\fP.
Specify a blank file name ("") to make libcurl not load from a file at all.
.SH DEFAULT
NULL. The alt-svc cache is not read nor written to file.
.SH PROTOCOLS
HTTPS
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_ALTSVC_CTRL, CURLALTSVC_H1);
curl_easy_setopt(curl, CURLOPT_ALTSVC, "altsvc-cache.txt");
curl_easy_perform(curl);
}
.fi
.SH "FILE FORMAT"
A text based file with one line per alt-svc entry and each line consists of
nine space-separated fields.
An example line could look like
h2 www.example 8443 h3 second.example 443 "20190808 06:18:37" 1 0
The fields of that line are:
.IP h2
ALPN id for the source origin
.IP www.example
Host name for the source origin
.IP 8443
Port number for the source origin
.IP h3
ALPN id for the destination host
.IP second.example
Host name for the destination host
.IP 443
Port number for the destination host
.IP 2019*
Expiration date and time of this entry within double quotes. The date format
is "YYYYMMDD HH:MM:SS" and the time zone is GMT.
.IP 1
Boolean (1 or 0) if "persist" was set for this entry
.IP 0
Integer priority value (not currently used)
.SH AVAILABILITY
Added in 7.64.1
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR CURLOPT_ALTSVC_CTRL (3),
.BR CURLOPT_CONNECT_TO (3),
.BR CURLOPT_COOKIEFILE (3),
.BR CURLOPT_RESOLVE (3)
man/man3/CURLOPT_PROXY_ISSUERCERT.3 0000644 00000006223 14751172371 0012155 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_PROXY_ISSUERCERT 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_PROXY_ISSUERCERT \- proxy issuer SSL certificate filename
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_PROXY_ISSUERCERT, char *file);
.fi
.SH DESCRIPTION
Pass a char * to a null-terminated string naming a \fIfile\fP holding a CA
certificate in PEM format. If the option is set, an additional check against
the peer certificate is performed to verify the issuer of the the HTTPS proxy
is indeed the one associated with the certificate provided by the option.
This additional check is useful in multi-level PKI where one needs to enforce
that the peer certificate is from a specific branch of the tree.
This option makes sense only when used in combination with the
\fICURLOPT_PROXY_SSL_VERIFYPEER(3)\fP option. Otherwise, the result of the
check is not considered as failure.
A specific error code (CURLE_SSL_ISSUER_ERROR) is defined with the option,
which is returned if the setup of the SSL/TLS session has failed due to a
mismatch with the issuer of peer certificate
(\fICURLOPT_PROXY_SSL_VERIFYPEER(3)\fP has to be set too for the check to
fail).
The application does not have to keep the string around after setting this
option.
.SH DEFAULT
NULL
.SH PROTOCOLS
All TLS-based protocols
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/");
/* using an HTTPS proxy */
curl_easy_setopt(curl, CURLOPT_PROXY, "https://localhost:443");
curl_easy_setopt(curl, CURLOPT_PROXY_ISSUERCERT, "/etc/certs/cacert.pem");
ret = curl_easy_perform(curl);
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Added in 7.71.0. This option is supported by the OpenSSL backends.
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, CURLE_UNKNOWN_OPTION if not, or
CURLE_OUT_OF_MEMORY if there was insufficient heap space.
.SH "SEE ALSO"
.BR CURLOPT_ISSUERCERT (3),
.BR CURLOPT_PROXY_SSL_VERIFYHOST (3),
.BR CURLOPT_PROXY_SSL_VERIFYPEER (3),
.BR CURLOPT_SSL_VERIFYHOST (3),
.BR CURLOPT_SSL_VERIFYPEER (3)
man/man3/CURLOPT_DIRLISTONLY.3 0000644 00000005606 14751172371 0011304 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_DIRLISTONLY 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_DIRLISTONLY \- ask for names only in a directory listing
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_DIRLISTONLY, long listonly);
.fi
.SH DESCRIPTION
For FTP and SFTP based URLs a parameter set to 1 tells the library to list the
names of files in a directory, rather than performing a full directory listing
that would normally include file sizes, dates etc.
For POP3 a parameter of 1 tells the library to list the email message or
messages on the POP3 server. This can be used to change the default behavior
of libcurl, when combined with a URL that contains a message ID, to perform a
"scan listing" which can then be used to determine the size of an email.
Note: For FTP this causes a NLST command to be sent to the FTP server. Beware
that some FTP servers list only files in their response to NLST; they might not
include subdirectories and symbolic links.
Setting this option to 1 also implies a directory listing even if the URL
does not end with a slash, which otherwise is necessary.
Do not use this option if you also use \fICURLOPT_WILDCARDMATCH(3)\fP as it
effectively breaks that feature.
.SH DEFAULT
0, disabled
.SH PROTOCOLS
FTP, SFTP and POP3
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "ftp://example.com/dir/");
/* list only */
curl_easy_setopt(curl, CURLOPT_DIRLISTONLY, 1L);
ret = curl_easy_perform(curl);
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
This option was known as CURLOPT_FTPLISTONLY up to 7.16.4. POP3 is supported
since 7.21.5.
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR CURLOPT_CUSTOMREQUEST (3),
.BR CURLOPT_WILDCARDMATCH (3)
man/man3/CURLOPT_PROXY_CRLFILE.3 0000644 00000006157 14751172371 0011553 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_PROXY_CRLFILE 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_PROXY_CRLFILE \- HTTPS proxy Certificate Revocation List file
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_PROXY_CRLFILE, char *file);
.fi
.SH DESCRIPTION
This option is for connecting to an HTTPS proxy, not an HTTPS server.
Pass a char * to a null-terminated string naming a \fIfile\fP with the
concatenation of CRL (in PEM format) to use in the certificate validation that
occurs during the SSL exchange.
When curl is built to use GnuTLS, there is no way to influence the use of CRL
passed to help in the verification process. When libcurl is built with OpenSSL
support, X509_V_FLAG_CRL_CHECK and X509_V_FLAG_CRL_CHECK_ALL are both set,
requiring CRL check against all the elements of the certificate chain if a CRL
file is passed.
This option makes sense only when used in combination with the
\fICURLOPT_PROXY_SSL_VERIFYPEER(3)\fP option.
A specific error code (\fICURLE_SSL_CRL_BADFILE\fP) is defined with the
option. It is returned when the SSL exchange fails because the CRL file cannot
be loaded. A failure in certificate verification due to a revocation
information found in the CRL does not trigger this specific error.
The application does not have to keep the string around after setting this
option.
.SH DEFAULT
NULL
.SH PROTOCOLS
Used with HTTPS proxy.
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/");
curl_easy_setopt(curl, CURLOPT_PROXY, "https://localhost:80");
curl_easy_setopt(curl, CURLOPT_PROXY_CRLFILE, "/etc/certs/crl.pem");
ret = curl_easy_perform(curl);
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Added in 7.52.0
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, CURLE_UNKNOWN_OPTION if not, or
CURLE_OUT_OF_MEMORY if there was insufficient heap space.
.SH "SEE ALSO"
.BR CURLOPT_PROXY_SSL_VERIFYHOST (3),
.BR CURLOPT_PROXY_SSL_VERIFYPEER (3),
.BR CURLOPT_SSL_VERIFYHOST (3),
.BR CURLOPT_SSL_VERIFYPEER (3)
man/man3/CURLOPT_SSL_CTX_FUNCTION.3 0000644 00000014621 14751172371 0012151 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_SSL_CTX_FUNCTION 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_SSL_CTX_FUNCTION \- SSL context callback for OpenSSL, wolfSSL or mbedTLS
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode ssl_ctx_callback(CURL *curl, void *ssl_ctx, void *clientp);
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_SSL_CTX_FUNCTION,
ssl_ctx_callback);
.SH DESCRIPTION
This option only works for libcurl powered by OpenSSL, wolfSSL, mbedTLS or
BearSSL. If libcurl was built against another SSL library this functionality
is absent.
Pass a pointer to your callback function, which should match the prototype
shown above.
This callback function gets called by libcurl just before the initialization
of an SSL connection after having processed all other SSL related options to
give a last chance to an application to modify the behavior of the SSL
initialization. The \fIssl_ctx\fP parameter is actually a pointer to the SSL
library's \fISSL_CTX\fP for OpenSSL or wolfSSL, a pointer to
\fImbedtls_ssl_config\fP for mbedTLS or a pointer to
\fIbr_ssl_client_context\fP for BearSSL. If an error is returned from the
callback no attempt to establish a connection is made and the perform
operation returns the callback's error code. Set the \fIclientp\fP argument
with the \fICURLOPT_SSL_CTX_DATA(3)\fP option.
This function gets called on all new connections made to a server, during the
SSL negotiation. The \fIssl_ctx\fP points to a newly initialized object each
time, but note the pointer may be the same as from a prior call.
To use this properly, a non-trivial amount of knowledge of your SSL library is
necessary. For example, you can use this function to call library-specific
callbacks to add additional validation code for certificates, and even to
change the actual URI of an HTTPS request.
For OpenSSL, asynchronous certificate verification via
\fISSL_set_retry_verify\fP is supported. (Added in 8.3.0)
WARNING: The \fICURLOPT_SSL_CTX_FUNCTION(3)\fP callback allows the application
to reach in and modify SSL details in the connection without libcurl itself
knowing anything about it, which then subsequently can lead to libcurl
unknowingly reusing SSL connections with different properties. To remedy this
you may set \fICURLOPT_FORBID_REUSE(3)\fP from the callback function.
WARNING: If you are using DNS-over-HTTPS (DoH) via \fICURLOPT_DOH_URL(3)\fP
then this callback is also called for those transfers and the curl handle is
set to an internal handle. \fBThis behavior is subject to change.\fP We
recommend before performing your transfer set \fICURLOPT_PRIVATE(3)\fP on your
curl handle so you can identify it in the context callback. If you have a
reason to modify DoH SSL context please let us know on the curl-library
mailing list because we are considering removing this capability.
.SH DEFAULT
NULL
.SH PROTOCOLS
All TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc.
.SH EXAMPLE
.nf
/* OpenSSL specific */
#include <openssl/ssl.h>
#include <curl/curl.h>
#include <stdio.h>
static CURLcode sslctx_function(CURL *curl, void *sslctx, void *parm)
{
X509_STORE *store;
X509 *cert = NULL;
BIO *bio;
char *mypem = parm;
/* get a BIO */
bio = BIO_new_mem_buf(mypem, -1);
/* use it to read the PEM formatted certificate from memory into an
* X509 structure that SSL can use
*/
PEM_read_bio_X509(bio, &cert, 0, NULL);
if(cert == NULL)
printf("PEM_read_bio_X509 failed...\\n");
/* get a pointer to the X509 certificate store (which may be empty) */
store = SSL_CTX_get_cert_store((SSL_CTX *)sslctx);
/* add our certificate to this store */
if(X509_STORE_add_cert(store, cert) == 0)
printf("error adding certificate\\n");
/* decrease reference counts */
X509_free(cert);
BIO_free(bio);
/* all set to go */
return CURLE_OK;
}
int main(void)
{
CURL * ch;
CURLcode rv;
char *mypem = /* example CA cert PEM - shortened */
"-----BEGIN CERTIFICATE-----\\n"
"MIIHPTCCBSWgAwIBAgIBADANBgkqhkiG9w0BAQQFADB5MRAwDgYDVQQKEwdSb290\\n"
"IENBMR4wHAYDVQQLExVodHRwOi8vd3d3LmNhY2VydC5vcmcxIjAgBgNVBAMTGUNB\\n"
"IENlcnQgU2lnbmluZyBBdXRob3JpdHkxITAfBgkqhkiG9w0BCQEWEnN1cHBvcnRA\\n"
"Y2FjZXJ0Lm9yZzAeFw0wMzAzMzAxMjI5NDlaFw0zMzAzMjkxMjI5NDlaMHkxEDAO\\n"
"GCSNe9FINSkYQKyTYOGWhlC0elnYjyELn8+CkcY7v2vcB5G5l1YjqrZslMZIBjzk\\n"
"zk6q5PYvCdxTby78dOs6Y5nCpqyJvKeyRKANihDjbPIky/qbn3BHLt4Ui9SyIAmW\\n"
"omTxJBzcoTWcFbLUvFUufQb1nA5V9FrWk9p2rSVzTMVD\\n"
"-----END CERTIFICATE-----\\n";
curl_global_init(CURL_GLOBAL_ALL);
ch = curl_easy_init();
curl_easy_setopt(ch, CURLOPT_SSLCERTTYPE, "PEM");
curl_easy_setopt(ch, CURLOPT_SSL_VERIFYPEER, 1L);
curl_easy_setopt(ch, CURLOPT_URL, "https://www.example.com/");
curl_easy_setopt(ch, CURLOPT_SSL_CTX_FUNCTION, *sslctx_function);
curl_easy_setopt(ch, CURLOPT_SSL_CTX_DATA, mypem);
rv = curl_easy_perform(ch);
if(!rv)
printf("*** transfer succeeded ***\\n");
else
printf("*** transfer failed ***\\n");
curl_easy_cleanup(ch);
curl_global_cleanup();
return rv;
}
.fi
.SH AVAILABILITY
Added in 7.11.0 for OpenSSL, in 7.42.0 for wolfSSL, in 7.54.0 for mbedTLS,
in 7.83.0 in BearSSL. Other SSL backends are not supported.
.SH RETURN VALUE
CURLE_OK if supported; or an error such as:
CURLE_NOT_BUILT_IN - Not supported by the SSL backend
CURLE_UNKNOWN_OPTION
.SH "SEE ALSO"
.BR CURLOPT_SSL_CTX_DATA (3),
.BR CURLOPT_SSL_VERIFYPEER (3)
man/man3/CURLOPT_MAXFILESIZE.3 0000644 00000004626 14751172371 0011251 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_MAXFILESIZE 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_MAXFILESIZE \- maximum file size allowed to download
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_MAXFILESIZE, long size);
.fi
.SH DESCRIPTION
Pass a long as parameter. This specifies the maximum accepted \fIsize\fP (in
bytes) of a file to download. If the file requested is found larger than this
value, the transfer is aborted and \fICURLE_FILESIZE_EXCEEDED\fP is returned.
The file size is not always known prior to the download start, and for such
transfers this option has no effect - even if the file transfer eventually
ends up being larger than this given limit.
If you want a limit above 2GB, use \fICURLOPT_MAXFILESIZE_LARGE(3)\fP.
Since 8.4.0, this option also stops ongoing transfers if they reach this
threshold.
.SH DEFAULT
None
.SH PROTOCOLS
FTP, HTTP and MQTT
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
CURLcode ret;
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/");
/* refuse to download if larger than 1000 bytes! */
curl_easy_setopt(curl, CURLOPT_MAXFILESIZE, 1000L);
ret = curl_easy_perform(curl);
}
.fi
.SH AVAILABILITY
Always
.SH RETURN VALUE
Returns CURLE_OK
.SH "SEE ALSO"
.BR CURLOPT_MAX_RECV_SPEED_LARGE (3),
.BR CURLOPT_MAXFILESIZE_LARGE (3)
man/man3/curl_url_dup.3 0000644 00000003734 14751172371 0010757 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.TH curl_url_dup 3 "September 26, 2023" "libcurl 8.4.0" "libcurl"
.SH NAME
curl_url_dup - duplicate a URL handle
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLU *curl_url_dup(CURLU *inhandle);
.fi
.SH DESCRIPTION
Duplicates the URL object the input \fICURLU\fP \fIinhandle\fP identifies and
returns a pointer to the copy as a new \fICURLU\fP handle. The new handle also
needs to be freed with \fIcurl_url_cleanup(3)\fP.
.SH EXAMPLE
.nf
CURLUcode rc;
CURLU *url = curl_url();
CURLU *url2;
rc = curl_url_set(url, CURLUPART_URL, "https://example.com", 0);
if(!rc) {
url2 = curl_url_dup(url); /* clone it! */
curl_url_cleanup(url2);
}
curl_url_cleanup(url);
.fi
.SH AVAILABILITY
Added in 7.62.0
.SH RETURN VALUE
Returns a new handle or NULL if out of memory.
.SH "SEE ALSO"
.BR curl_url (3),
.BR curl_url_cleanup (3),
.BR curl_url_get (3),
.BR curl_url_set (3),
.BR CURLOPT_CURLU (3)
man/man3/CURLINFO_PROXY_SSL_VERIFYRESULT.3 0000644 00000004464 14751172371 0013247 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLINFO_PROXY_SSL_VERIFYRESULT 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLINFO_PROXY_SSL_VERIFYRESULT \- get the result of the proxy certificate verification
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_getinfo(CURL *handle, CURLINFO_PROXY_SSL_VERIFYRESULT,
long *result);
.fi
.SH DESCRIPTION
Pass a pointer to a long to receive the result of the certificate verification
that was requested (using the \fICURLOPT_PROXY_SSL_VERIFYPEER(3)\fP
option. This is only used for HTTPS proxies.
.SH PROTOCOLS
All
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
CURLcode res;
long verifyresult;
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
curl_easy_setopt(curl, CURLOPT_PROXY, "https://proxy:443");
res = curl_easy_perform(curl);
curl_easy_getinfo(curl, CURLINFO_PROXY_SSL_VERIFYRESULT, &verifyresult);
printf("The peer verification said %s\\n", verifyresult?
"fine":"BAAAD");
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Added in 7.52.0
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR curl_easy_getinfo (3),
.BR curl_easy_setopt (3),
.BR CURLINFO_SSL_VERIFYRESULT (3)
man/man3/CURLOPT_CAPATH.3 0000644 00000005250 14751172371 0010423 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_CAPATH 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_CAPATH \- directory holding CA certificates
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_CAPATH, char *capath);
.fi
.SH DESCRIPTION
Pass a char * to a null-terminated string naming a directory holding multiple
CA certificates to verify the peer with. If libcurl is built against OpenSSL,
the certificate directory must be prepared using the OpenSSL c_rehash utility.
This makes sense only when used in combination with the
\fICURLOPT_SSL_VERIFYPEER(3)\fP option.
The \fICURLOPT_CAPATH(3)\fP function apparently does not work in Windows due
to some limitation in OpenSSL.
The application does not have to keep the string around after setting this
option.
The default value for this can be figured out with \fICURLINFO_CAPATH(3)\fP.
.SH DEFAULT
A default path detected at build time.
.SH PROTOCOLS
All TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc.
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/");
curl_easy_setopt(curl, CURLOPT_CAPATH, "/etc/cert-dir");
ret = curl_easy_perform(curl);
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
This option is supported by the OpenSSL, GnuTLS and mbedTLS (since 7.56.0)
backends.
.SH RETURN VALUE
CURLE_OK if supported; or an error such as:
CURLE_NOT_BUILT_IN - Not supported by the SSL backend
CURLE_UNKNOWN_OPTION
CURLE_OUT_OF_MEMORY
.SH "SEE ALSO"
.BR CURLINFO_CAPATH (3),
.BR CURLOPT_CAINFO (3),
.BR CURLOPT_DEBUGFUNCTION (3),
.BR CURLOPT_STDERR (3)
man/man3/CURLOPT_ADDRESS_SCOPE.3 0000644 00000004071 14751172371 0011501 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_ADDRESS_SCOPE 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_ADDRESS_SCOPE \- scope id for IPv6 addresses
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_ADDRESS_SCOPE, long scope);
.fi
.SH DESCRIPTION
Pass a long specifying the scope id value to use when connecting to IPv6 addresses.
.SH DEFAULT
0
.SH PROTOCOLS
All, when using IPv6
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
CURLcode ret;
long my_scope_id;
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/");
my_scope_id = if_nametoindex("eth0");
curl_easy_setopt(curl, CURLOPT_ADDRESS_SCOPE, my_scope_id);
ret = curl_easy_perform(curl);
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Added in 7.19.0
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
Returns CURLE_BAD_FUNCTION_ARGUMENT if set to a negative value.
.SH "SEE ALSO"
.BR CURLOPT_DEBUGFUNCTION (3),
.BR CURLOPT_STDERR (3)
man/man3/CURLOPT_PROXYAUTH.3 0000644 00000005434 14751172371 0011072 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_PROXYAUTH 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_PROXYAUTH \- HTTP proxy authentication methods
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_PROXYAUTH, long bitmask);
.fi
.SH DESCRIPTION
Pass a long as parameter, which is set to a bitmask, to tell libcurl which
HTTP authentication method(s) you want it to use for your proxy
authentication. If more than one bit is set, libcurl first queries the site to
see what authentication methods it supports and then it picks the best one you
allow it to use. For some methods, this induces an extra network round-trip.
Set the actual name and password with the \fICURLOPT_PROXYUSERPWD(3)\fP
option.
The bitmask can be constructed by the bits listed and described in the
\fICURLOPT_HTTPAUTH(3)\fP man page.
.SH DEFAULT
CURLAUTH_BASIC
.SH PROTOCOLS
HTTP
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
CURLcode ret;
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/");
/* use this proxy */
curl_easy_setopt(curl, CURLOPT_PROXY, "http://local.example.com:1080");
/* allow whatever auth the proxy speaks */
curl_easy_setopt(curl, CURLOPT_PROXYAUTH, CURLAUTH_ANY);
/* set the proxy credentials */
curl_easy_setopt(curl, CURLOPT_PROXYUSERPWD, "james:007");
ret = curl_easy_perform(curl);
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Added in 7.10.7
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, CURLE_UNKNOWN_OPTION if not, or
CURLE_NOT_BUILT_IN if the bitmask specified no supported authentication
methods.
.SH "SEE ALSO"
.BR CURLOPT_HTTPAUTH (3),
.BR CURLOPT_PROXY (3),
.BR CURLOPT_PROXYPORT (3),
.BR CURLOPT_PROXYTYPE (3),
.BR CURLOPT_PROXYUSERPWD (3)
man/man3/CURLINFO_CAINFO.3 0000644 00000004575 14751172371 0010524 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLINFO_CAINFO 3 "September 26, 2023" "libcurl 8.4.0" "libcurl"
.SH NAME
CURLINFO_CAINFO \- get the default built-in CA certificate path
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_getinfo(CURL *handle, CURLINFO_CAINFO, char **path);
.fi
.SH DESCRIPTION
Pass a pointer to a char pointer to receive the pointer to a null-terminated
string holding the default built-in path used for the \fICURLOPT_CAINFO(3)\fP
option unless set by the user.
Note that in a situation where libcurl has been built to support multiple TLS
libraries, this option might return a string even if the specific TLS library
currently set to be used does not support \fICURLOPT_CAINFO(3)\fP.
This is a path identifying a single file containing CA certificates.
The \fBpath\fP pointer is set to NULL if there is no default path.
.SH PROTOCOLS
All
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
CURLcode res;
char *cainfo = NULL;
curl_easy_getinfo(curl, CURLINFO_CAINFO, &cainfo);
if(cainfo)
printf("default ca info path: %s\\n", cainfo);
}
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Added in 7.84.0
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR curl_easy_getinfo (3),
.BR curl_easy_setopt (3),
.BR CURLINFO_CAPATH (3)
man/man3/CURLOPT_QUOTE.3 0000644 00000011752 14751172371 0010364 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_QUOTE 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_QUOTE \- (S)FTP commands to run before transfer
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_QUOTE,
struct curl_slist *cmds);
.fi
.SH DESCRIPTION
Pass a pointer to a linked list of FTP or SFTP commands to pass to the server
prior to your request. This is done before any other commands are issued (even
before the CWD command for FTP). The linked list should be a fully valid list
of 'struct curl_slist' structs properly filled in with text strings. Use
\fIcurl_slist_append(3)\fP to append strings (commands) to the list, and clear
the entire list afterwards with \fIcurl_slist_free_all(3)\fP.
Disable this operation again by setting a NULL to this option.
When speaking to an FTP server, prefix the command with an asterisk (*) to
make libcurl continue even if the command fails as by default libcurl stops at
first failure.
The set of valid FTP commands depends on the server (see RFC 959 for a list of
mandatory commands).
libcurl does not inspect, parse or "understand" the commands passed to the
server using this option. If you change connection state, working directory or
similar using quote commands, libcurl does not know about it.
The valid SFTP commands are:
.RS
.IP "atime date file"
The atime command sets the last access time of the file named by the file
operand. The <date expression> can be all sorts of date strings, see the
\fIcurl_getdate(3)\fP man page for date expression details. (Added in 7.73.0)
.IP "chgrp group file"
The chgrp command sets the group ID of the file named by the file operand to
the group ID specified by the group operand. The group operand is a decimal
integer group ID.
.IP "chmod mode file"
The chmod command modifies the file mode bits of the specified file. The
mode operand is an octal integer mode number.
.IP "chown user file"
The chown command sets the owner of the file named by the file operand to the
user ID specified by the user operand. The user operand is a decimal
integer user ID.
.IP "ln source_file target_file"
The \fBln\fP and \fBsymlink\fP commands create a symbolic link at the
target_file location pointing to the source_file location.
.IP "mkdir directory_name"
The mkdir command creates the directory named by the directory_name operand.
.IP "mtime date file"
The mtime command sets the last modification time of the file named by the
file operand. The <date expression> can be all sorts of date strings, see the
\fIcurl_getdate(3)\fP man page for date expression details. (Added in 7.73.0)
.IP "pwd"
The \fBpwd\fP command returns the absolute path of the current working
directory.
.IP "rename source target"
The rename command renames the file or directory named by the source
operand to the destination path named by the target operand.
.IP "rm file"
The rm command removes the file specified by the file operand.
.IP "rmdir directory"
The rmdir command removes the directory entry specified by the directory
operand, provided it is empty.
.IP "statvfs file"
The statvfs command returns statistics on the file system in which specified
file resides. (Added in 7.49.0)
.IP "symlink source_file target_file"
See ln.
.RE
.SH DEFAULT
NULL
.SH PROTOCOLS
SFTP and FTP
.SH EXAMPLE
.nf
struct curl_slist *cmdlist = NULL;
cmdlist = curl_slist_append(cmdlist, "RNFR source-name");
cmdlist = curl_slist_append(cmdlist, "RNTO new-name");
curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "ftp://example.com/foo.bin");
/* pass in the FTP commands to run before the transfer */
curl_easy_setopt(curl, CURLOPT_QUOTE, cmdlist);
ret = curl_easy_perform(curl);
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
SFTP support added in 7.16.3. *-prefix for SFTP added in 7.24.0
.SH RETURN VALUE
Returns CURLE_OK
.SH "SEE ALSO"
.BR CURLOPT_CUSTOMREQUEST (3),
.BR CURLOPT_DIRLISTONLY (3),
.BR CURLOPT_POSTQUOTE (3),
.BR CURLOPT_PREQUOTE (3)
man/man3/CURLOPT_SSH_HOSTKEYDATA.3 0000644 00000004610 14751172371 0011757 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_SSH_KEYDATA 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_SSH_HOSTKEYDATA \- pointer to pass to the SSH host key callback
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_SSH_HOSTKEYDATA, void *pointer);
.fi
.SH DESCRIPTION
Pass a void * as parameter. This \fIpointer\fP is passed along untouched to
the callback set with \fICURLOPT_SSH_HOSTKEYFUNCTION(3)\fP.
.SH DEFAULT
NULL
.SH PROTOCOLS
SCP and SFTP
.SH EXAMPLE
.nf
int hostkeycb(void *clientp, /* passed with CURLOPT_SSH_HOSTKEYDATA */
int keytype, /* CURLKHTYPE */
const char * key, /* host key to check */
size_t keylen); /* length of the key */
{
/* 'clientp' points to the callback_data struct */
/* investigate the situation and return the correct value */
return CURLKHMATCH_OK;
}
{
curl_easy_setopt(curl, CURLOPT_URL, "sftp://example.com/thisfile.txt");
curl_easy_setopt(curl, CURLOPT_SSH_HOSTKEYFUNCTION, hostkeycb);
curl_easy_setopt(curl, CURLOPT_SSH_HOSTKEYDATA, &callback_data);
curl_easy_perform(curl);
}
.fi
.SH AVAILABILITY
Added in 7.84.0, works only with libssh2 backend.
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR CURLOPT_SSH_HOSTKEYFUNCTION (3)
man/man3/curl_easy_nextheader.3 0000644 00000010103 14751172371 0012441 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.TH curl_easy_nextheader 3 "September 26, 2023" "libcurl 8.4.0" "libcurl"
.SH NAME
curl_easy_nextheader - get the next HTTP header
.SH SYNOPSIS
.nf
#include <curl/curl.h>
struct curl_header *curl_easy_nextheader(CURL *easy,
unsigned int origin,
int request,
struct curl_header *prev);
.fi
.SH DESCRIPTION
This function lets an application iterate over all previously received HTTP
headers.
The \fIorigin\fP argument is for specifying which headers to receive, as a
single HTTP transfer might provide headers from several different places and
they may then have different importance to the user and headers using the same
name might be used. The \fIorigin\fP is a bitmask for what header sources you
want. See the \fIcurl_easy_header(3)\fP man page for the origin descriptions.
The \fIrequest\fP argument tells libcurl from which request you want headers
from. A single transfer might consist of a series of HTTP requests and this
argument lets you specify which particular individual request you want the
headers from. 0 being the first request and then the number increases for
further redirects or when multi-state authentication is used. Passing in -1 is
a shortcut to "the last" request in the series, independently of the actual
amount of requests used.
It is suggested that you pass in the same \fBorigin\fP and \fBrequest\fP when
iterating over a range of headers as changing the value mid-loop might give
you unexpected results.
If \fIprev\fP is NULL, this function returns a pointer to the first header
stored within the given scope (origin + request).
If \fIprev\fP is a pointer to a previously returned header struct,
\fIcurl_easy_nextheader(3)\fP returns a pointer the next header stored within
the given scope. This way, an application can iterate over all available
headers.
The memory for the struct this points to, is owned and managed by libcurl and
is associated with the easy handle. Applications must copy the data if they
want it to survive subsequent API calls or the life-time of the easy handle.
.SH EXAMPLE
.nf
struct curl_header *prev = NULL;
struct curl_header *h;
/* extract the normal headers from the first request */
while((h = curl_easy_nextheader(easy, CURLH_HEADER, 0, prev))) {
printf("%s: %s\\n", h->name, h->value);
prev = h;
}
/* extract the normal headers + 1xx + trailers from the last request */
unsigned int origin = CURLH_HEADER| CURLH_1XX | CURLH_TRAILER;
while((h = curl_easy_nextheader(easy, origin, -1, prev))) {
printf("%s: %s\\n", h->name, h->value);
prev = h;
}
.fi
.SH AVAILABILITY
Added in 7.83.0. Officially supported since 7.84.0.
.SH RETURN VALUE
This function returns the next header, or NULL when there are no more
(matching) headers or an error occurred.
If this function returns NULL when \fIprev\fP was set to NULL, then there are
no headers available within the scope to return.
.SH "SEE ALSO"
.BR curl_easy_header (3),
.BR curl_easy_perform (3)
man/man3/CURLOPT_CONNECTTIMEOUT.3 0000644 00000006434 14751172371 0011630 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_CONNECTTIMEOUT 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_CONNECTTIMEOUT \- timeout for the connect phase
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_CONNECTTIMEOUT, long timeout);
.fi
.SH DESCRIPTION
Pass a long. It should contain the maximum time in seconds that you allow the
connection phase to the server to take. This timeout only limits the
connection phase, it has no impact once it has connected. Set to zero to
switch to the default built-in connection timeout - 300 seconds. See also the
\fICURLOPT_TIMEOUT(3)\fP option.
\fICURLOPT_CONNECTTIMEOUT_MS(3)\fP is the same function but set in milliseconds.
If both \fICURLOPT_CONNECTTIMEOUT(3)\fP and \fICURLOPT_CONNECTTIMEOUT_MS(3)\fP
are set, the value set last is used.
The "connection phase" is considered complete when the requested TCP, TLS or
QUIC handshakes are done.
The connection timeout set with \fICURLOPT_CONNECTTIMEOUT(3)\fP is included in
the general all-covering \fICURLOPT_TIMEOUT(3)\fP.
With \fICURLOPT_CONNECTTIMEOUT(3)\fP set to 3 and \fICURLOPT_TIMEOUT(3)\fP set
to 5, the operation can never last longer than 5 seconds, and the connection
phase cannot last longer than 3 seconds.
With \fICURLOPT_CONNECTTIMEOUT(3)\fP set to 4 and \fICURLOPT_TIMEOUT(3)\fP set
to 2, the operation can never last longer than 2 seconds. Including the
connection phase.
This option may cause libcurl to use the SIGALRM signal to timeout system
calls on builds not using asynch DNS. In unix-like systems, this might cause
signals to be used unless \fICURLOPT_NOSIGNAL(3)\fP is set.
.SH DEFAULT
300
.SH PROTOCOLS
All
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
/* complete connection within 10 seconds */
curl_easy_setopt(curl, CURLOPT_CONNECTTIMEOUT, 10L);
curl_easy_perform(curl);
}
.fi
.SH AVAILABILITY
Always
.SH RETURN VALUE
Returns CURLE_OK. Returns CURLE_BAD_FUNCTION_ARGUMENT if set to a negative
value or a value that when converted to milliseconds is too large.
.SH "SEE ALSO"
.BR CURLOPT_CONNECTTIMEOUT_MS (3),
.BR CURLOPT_LOW_SPEED_LIMIT (3),
.BR CURLOPT_MAX_RECV_SPEED_LARGE (3),
.BR CURLOPT_TIMEOUT (3)
man/man3/CURLOPT_MAXCONNECTS.3 0000644 00000005336 14751172371 0011252 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_MAXCONNECTS 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_MAXCONNECTS \- maximum connection cache size
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_MAXCONNECTS, long amount);
.fi
.SH DESCRIPTION
Pass a long. The set \fIamount\fP is the maximum number of simultaneously open
persistent connections that libcurl may cache in the pool associated with this
handle. The default is 5, and there is not much point in changing this value
unless you are perfectly aware of how this works. This concerns connections
using any of the protocols that support persistent connections.
When reaching the maximum limit, curl closes the oldest one in the cache to
prevent increasing the number of open connections.
If you already have performed transfers with this curl handle, setting a
smaller \fICURLOPT_MAXCONNECTS(3)\fP than before may cause open connections to
get closed unnecessarily.
If you add this easy handle to a multi handle, this setting is not
acknowledged, and you must instead use \fIcurl_multi_setopt(3)\fP and the
\fICURLMOPT_MAXCONNECTS(3)\fP option.
.SH DEFAULT
5
.SH PROTOCOLS
Most
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
CURLcode ret;
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/");
/* limit the connection cache for this handle to no more than 3 */
curl_easy_setopt(curl, CURLOPT_MAXCONNECTS, 3L);
ret = curl_easy_perform(curl);
}
.fi
.SH AVAILABILITY
Always
.SH RETURN VALUE
Returns CURLE_OK
.SH "SEE ALSO"
.BR CURLMOPT_MAX_HOST_CONNECTIONS (3),
.BR CURLMOPT_MAX_TOTAL_CONNECTIONS (3),
.BR CURLMOPT_MAXCONNECTS (3),
.BR CURLOPT_MAXREDIRS (3)
man/man3/CURLOPT_SSH_KEYFUNCTION.3 0000644 00000012414 14751172371 0011776 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_SSH_KEYFUNCTION 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_SSH_KEYFUNCTION \- callback for known host matching logic
.SH SYNOPSIS
.nf
#include <curl/curl.h>
enum curl_khstat {
CURLKHSTAT_FINE_ADD_TO_FILE,
CURLKHSTAT_FINE,
CURLKHSTAT_REJECT, /* reject the connection, return an error */
CURLKHSTAT_DEFER, /* do not accept it, but we cannot answer right
now. Causes a CURLE_PEER_FAILED_VERIFICATION error but
the connection is left intact */
CURLKHSTAT_FINE_REPLACE
};
enum curl_khmatch {
CURLKHMATCH_OK, /* match */
CURLKHMATCH_MISMATCH, /* host found, key mismatch! */
CURLKHMATCH_MISSING, /* no matching host/key found */
};
struct curl_khkey {
const char *key; /* points to a null-terminated string encoded with
base64 if len is zero, otherwise to the "raw"
data */
size_t len;
enum curl_khtype keytype;
};
int ssh_keycallback(CURL *easy,
const struct curl_khkey *knownkey,
const struct curl_khkey *foundkey,
enum curl_khmatch match,
void *clientp);
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_SSH_KEYFUNCTION,
ssh_keycallback);
.SH DESCRIPTION
Pass a pointer to your callback function, which should match the prototype
shown above.
It gets called when the known_host matching has been done, to allow the
application to act and decide for libcurl how to proceed. The callback is only
called if \fICURLOPT_SSH_KNOWNHOSTS(3)\fP is also set.
This callback function gets passed the CURL handle, the key from the
known_hosts file \fIknownkey\fP, the key from the remote site \fIfoundkey\fP,
info from libcurl on the matching status and a custom pointer (set with
\fICURLOPT_SSH_KEYDATA(3)\fP). It MUST return one of the following return
codes to tell libcurl how to act:
.IP CURLKHSTAT_FINE_REPLACE
The new host+key is accepted and libcurl replaces the old host+key into the
known_hosts file before continuing with the connection. This also adds the new
host+key combo to the known_host pool kept in memory if it was not already
present there. The adding of data to the file is done by completely replacing
the file with a new copy, so the permissions of the file must allow
this. (Added in 7.73.0)
.IP CURLKHSTAT_FINE_ADD_TO_FILE
The host+key is accepted and libcurl appends it to the known_hosts file before
continuing with the connection. This also adds the host+key combo to the
known_host pool kept in memory if it was not already present there. The adding
of data to the file is done by completely replacing the file with a new copy,
so the permissions of the file must allow this.
.IP CURLKHSTAT_FINE
The host+key is accepted libcurl continues with the connection. This also adds
the host+key combo to the known_host pool kept in memory if it was not already
present there.
.IP CURLKHSTAT_REJECT
The host+key is rejected. libcurl denies the connection to continue and it is
closed.
.IP CURLKHSTAT_DEFER
The host+key is rejected, but the SSH connection is asked to be kept alive.
This feature could be used when the app wants to somehow return back and act
on the host+key situation and then retry without needing the overhead of
setting it up from scratch again.
.SH DEFAULT
NULL
.SH PROTOCOLS
SFTP and SCP
.SH EXAMPLE
.nf
static int keycb(CURL *easy,
const struct curl_khkey *knownkey,
const struct curl_khkey *foundkey,
enum curl_khmatch match,
void *clientp)
{
/* 'clientp' points to the callback_data struct */
/* investigate the situation and return the correct value */
return CURLKHSTAT_FINE_ADD_TO_FILE;
}
{
curl_easy_setopt(curl, CURLOPT_URL, "sftp://example.com/thisfile.txt");
curl_easy_setopt(curl, CURLOPT_SSH_KEYFUNCTION, keycb);
curl_easy_setopt(curl, CURLOPT_SSH_KEYDATA, &callback_data);
curl_easy_setopt(curl, CURLOPT_SSH_KNOWNHOSTS, "/home/user/known_hosts");
curl_easy_perform(curl);
}
.fi
.SH AVAILABILITY
Added in 7.19.6
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR CURLOPT_SSH_KEYDATA (3),
.BR CURLOPT_SSH_KNOWNHOSTS (3)
man/man3/CURLOPT_DNS_USE_GLOBAL_CACHE.3 0000644 00000004507 14751172371 0012532 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_DNS_USE_GLOBAL_CACHE 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_DNS_USE_GLOBAL_CACHE \- global DNS cache
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_DNS_USE_GLOBAL_CACHE,
long enable);
.fi
.SH DESCRIPTION
Has no function since 7.62.0. Do not use!
Pass a long. If the \fIenable\fP value is 1, it tells curl to use a global DNS
cache that survives between easy handle creations and deletions. This is not
thread-safe and this uses a global variable.
See \fICURLOPT_SHARE(3)\fP and \fIcurl_share_init(3)\fP for the correct way to
share DNS cache between transfers.
.SH DEFAULT
0
.SH PROTOCOLS
All
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
CURLcode ret;
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/");
/* switch off the use of a global, thread unsafe, cache */
curl_easy_setopt(curl, CURLOPT_DNS_USE_GLOBAL_CACHE, 0L);
ret = curl_easy_perform(curl);
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Deprecated since 7.11.1. Function removed in 7.62.0.
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR CURLOPT_DNS_CACHE_TIMEOUT (3),
.BR CURLOPT_SHARE (3)
man/man3/CURLINFO_APPCONNECT_TIME.3 0000644 00000005032 14751172371 0012022 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLINFO_APPCONNECT_TIME 3 "September 26, 2023" "libcurl 8.4.0" "libcurl"
.SH NAME
CURLINFO_APPCONNECT_TIME \- get the time until the SSL/SSH handshake is completed
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_getinfo(CURL *handle, CURLINFO_APPCONNECT_TIME,
double *timep);
.fi
.SH DESCRIPTION
Pass a pointer to a double to receive the time, in seconds, it took from the
start until the SSL/SSH connect/handshake to the remote host was completed.
This time is most often close to the \fICURLINFO_PRETRANSFER_TIME(3)\fP time,
except for cases such as HTTP pipelining where the pretransfer time can be
delayed due to waits in line for the pipeline and more.
When a redirect is followed, the time from each request is added together.
See also the TIMES overview in the \fIcurl_easy_getinfo(3)\fP man page.
.SH PROTOCOLS
All
.SH EXAMPLE
.nf
curl = curl_easy_init();
if(curl) {
double connect;
curl_easy_setopt(curl, CURLOPT_URL, url);
res = curl_easy_perform(curl);
if(CURLE_OK == res) {
res = curl_easy_getinfo(curl, CURLINFO_APPCONNECT_TIME, &connect);
if(CURLE_OK == res) {
printf("Time: %.1f", connect);
}
}
/* always cleanup */
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Added in 7.19.0
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR curl_easy_getinfo (3),
.BR curl_easy_setopt (3),
.BR CURLINFO_APPCONNECT_TIME_T (3)
man/man3/CURLMOPT_SOCKETFUNCTION.3 0000644 00000010522 14751172371 0011734 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLMOPT_SOCKETFUNCTION 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLMOPT_SOCKETFUNCTION \- callback informed about what to wait for
.SH SYNOPSIS
.nf
#include <curl/curl.h>
int socket_callback(CURL *easy, /* easy handle */
curl_socket_t s, /* socket */
int what, /* describes the socket */
void *clientp, /* private callback pointer */
void *socketp); /* private socket pointer */
CURLMcode curl_multi_setopt(CURLM *handle, CURLMOPT_SOCKETFUNCTION, socket_callback);
.SH DESCRIPTION
Pass a pointer to your callback function, which should match the prototype
shown above.
When the \fIcurl_multi_socket_action(3)\fP function is called, it uses this
callback to inform the application about updates in the socket (file
descriptor) status by doing none, one, or multiple calls to the
\fBsocket_callback\fP. The callback function gets status updates with changes
since the previous time the callback was called. If the given callback pointer
is set to NULL, no callback is called.
libcurl then expects the application to monitor the sockets for the specific
activities and tell libcurl again when something happens on one of them. Tell
libcurl by calling \fIcurl_multi_socket_action(3)\fP.
.SH "CALLBACK ARGUMENTS"
\fIeasy\fP identifies the specific transfer for which this update is related.
\fIs\fP is the specific socket this function invocation concerns. If the
\fBwhat\fP argument is not CURL_POLL_REMOVE then it holds information about
what activity on this socket the application is supposed to
monitor. Subsequent calls to this callback might update the \fBwhat\fP bits
for a socket that is already monitored.
The socket callback should return 0 on success, and -1 on error. If this
callback returns error, \fBall\fP transfers currently in progress in this
multi handle are aborted and made to fail.
\fBclientp\fP is set with \fICURLMOPT_SOCKETDATA(3)\fP.
\fBsocketp\fP is set with \fIcurl_multi_assign(3)\fP or NULL.
The \fBwhat\fP parameter informs the callback on the status of the given
socket. It can hold one of these values:
.IP CURL_POLL_IN
Wait for incoming data. For the socket to become readable.
.IP CURL_POLL_OUT
Wait for outgoing data. For the socket to become writable.
.IP CURL_POLL_INOUT
Wait for incoming and outgoing data. For the socket to become readable or
writable.
.IP CURL_POLL_REMOVE
The specified socket/file descriptor is no longer used by libcurl for any
active transfer. It might soon be added again.
.SH DEFAULT
NULL (no callback)
.SH PROTOCOLS
All
.SH EXAMPLE
.nf
static int sock_cb(CURL *e, curl_socket_t s, int what, void *cbp, void *sockp)
{
GlobalInfo *g = cbp;
SockInfo *fdp = sockp;
if(what == CURL_POLL_REMOVE) {
remsock(fdp);
}
else {
if(!fdp) {
addsock(s, e, what, g);
}
else {
setsock(fdp, s, e, what, g);
}
}
return 0;
}
main()
{
GlobalInfo setup;
/* ... use socket callback and custom pointer */
curl_multi_setopt(multi, CURLMOPT_SOCKETFUNCTION, sock_cb);
curl_multi_setopt(multi, CURLMOPT_SOCKETDATA, &setup);
}
.fi
.SH AVAILABILITY
Added in 7.15.4
.SH RETURN VALUE
Returns CURLM_OK.
.SH "SEE ALSO"
.BR curl_multi_socket_action (3),
.BR CURLMOPT_SOCKETDATA (3),
.BR CURLMOPT_TIMERFUNCTION (3)
man/man3/CURLOPT_SSH_HOST_PUBLIC_KEY_SHA256.3 0000644 00000004464 14751172371 0013461 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_SSH_HOST_PUBLIC_KEY_SHA256 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_SSH_HOST_PUBLIC_KEY_SHA256 \- SHA256 hash of SSH server public key
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_SSH_HOST_PUBLIC_KEY_SHA256,
char *sha256);
.SH DESCRIPTION
Pass a char * pointing to a string containing a Base64-encoded SHA256 hash of
the remote host's public key. The transfer fails if the given hash does not
match the hash the remote host provides.
.SH DEFAULT
NULL
.SH PROTOCOLS
SCP and SFTP
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "sftp://example.com/file");
curl_easy_setopt(curl, CURLOPT_SSH_HOST_PUBLIC_KEY_SHA256,
"NDVkMTQxMGQ1ODdmMjQ3MjczYjAyOTY5MmRkMjVmNDQ=");
ret = curl_easy_perform(curl);
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Added in 7.80.0
Requires the libssh2 backend.
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, CURLE_UNKNOWN_OPTION if not, or
CURLE_OUT_OF_MEMORY if there was insufficient heap space.
.SH "SEE ALSO"
.BR CURLOPT_SSH_AUTH_TYPES (3),
.BR CURLOPT_SSH_HOST_PUBLIC_KEY_MD5 (3),
.BR CURLOPT_SSH_PUBLIC_KEYFILE (3)
man/man3/CURLOPT_PROTOCOLS_STR.3 0000644 00000006421 14751172371 0011600 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_PROTOCOLS_STR 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_PROTOCOLS_STR \- allowed protocols
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_PROTOCOLS_STR, char *spec);
.fi
.SH DESCRIPTION
Pass a pointer to a string that holds a comma-separated list of case
insensitive protocol names (URL schemes) to allow in the transfer. This
option allows applications to use libcurl built to support a wide range of
protocols but still limit specific transfers to only be allowed to use a
subset of them. By default, libcurl accepts all protocols it was built with
support for. See also \fICURLOPT_REDIR_PROTOCOLS_STR(3)\fP.
If trying to set a non-existing protocol or if no matching protocol at all is
set, it returns error.
These are the available protocols:
DICT, FILE, FTP, FTPS, GOPHER, GOPHERS, HTTP, HTTPS, IMAP, IMAPS, LDAP, LDAPS,
MQTT, POP3, POP3S, RTMP, RTMPE, RTMPS, RTMPT, RTMPTE, RTMPTS, RTSP, SCP, SFTP,
SMB, SMBS, SMTP, SMTPS, TELNET, TFTP, WS, WSS
You can set "ALL" as a short-cut to enable all protocols. Note that by setting
all, you may enable protocols that were not supported the day you write this
but are introduced in a future libcurl version.
\fIcurl_version_info(3)\fP can be used to get a list of all supported
protocols in the current libcurl. \fICURLINFO_SCHEME(3)\fP is the recommended
way to figure out the protocol used in a previous transfer.
.SH DEFAULT
All protocols built-in
.SH PROTOCOLS
All
.SH EXAMPLE
.nf
curl = curl_easy_init();
if(curl) {
/* pass in the URL from an external source */
curl_easy_setopt(curl, CURLOPT_URL, argv[1]);
/* only allow HTTP, TFTP and SFTP */
curl_easy_setopt(curl, CURLOPT_PROTOCOLS_STR, "http,tftp,sftp");
/* Perform the request */
curl_easy_perform(curl);
}
.fi
.SH AVAILABILITY
Added in 7.85.0
.SH RETURN VALUE
Returns CURLE_UNKNOWN_OPTION if the option is not implemented,
CURLE_UNSUPPORTED_PROTOCOL if a listed protocol is not supported or disabled,
CURLE_BAD_FUNCTION_ARGUMENT if no protocol is listed else CURLE_OK.
.SH "SEE ALSO"
.BR curl_version_info (3),
.BR CURLINFO_SCHEME (3),
.BR CURLOPT_DEFAULT_PROTOCOL (3),
.BR CURLOPT_REDIR_PROTOCOLS_STR (3),
.BR CURLOPT_URL (3)
man/man3/CURLOPT_DNS_SHUFFLE_ADDRESSES.3 0000644 00000005326 14751172371 0012664 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_DNS_SHUFFLE_ADDRESSES 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_DNS_SHUFFLE_ADDRESSES \- shuffle IP addresses for hostname
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_DNS_SHUFFLE_ADDRESSES, long onoff);
.fi
.SH DESCRIPTION
Pass a long set to 1 to enable this option.
When a name is resolved and more than one IP address is returned, this
function shuffles the order of all returned addresses so that they are used in
a random order. This is similar to the ordering behavior of the legacy
gethostbyname function which is no longer used on most platforms.
Addresses are not reshuffled if name resolution is completed using the DNS
cache. \fICURLOPT_DNS_CACHE_TIMEOUT(3)\fP can be used together with this
option to reduce DNS cache timeout or disable caching entirely if frequent
reshuffling is needed.
Since the addresses returned are randomly reordered, the order is not in
accordance with RFC 3484 or any other deterministic order that may be
generated by the system's name resolution implementation. This may have
performance impacts and may cause IPv4 to be used before IPv6 or vice versa.
.SH DEFAULT
0 (disabled)
.SH PROTOCOLS
All
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
curl_easy_setopt(curl, CURLOPT_DNS_SHUFFLE_ADDRESSES, 1L);
curl_easy_perform(curl);
/* always cleanup */
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Added in 7.60.0
.SH RETURN VALUE
CURLE_OK or an error such as CURLE_UNKNOWN_OPTION.
.SH "SEE ALSO"
.BR CURLOPT_DNS_CACHE_TIMEOUT (3),
.BR CURLOPT_IPRESOLVE (3)
man/man3/CURLOPT_LOGIN_OPTIONS.3 0000644 00000005565 14751172371 0011557 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_LOGIN_OPTIONS 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_LOGIN_OPTIONS \- login options
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_LOGIN_OPTIONS, char *options);
.fi
.SH DESCRIPTION
Pass a char * as parameter, which should be pointing to the null-terminated
\fIoptions\fP string to use for the transfer.
For more information about the login options please see RFC 2384, RFC 5092 and
the IETF draft \fBdraft-earhart-url-smtp-00.txt\fP.
\fICURLOPT_LOGIN_OPTIONS(3)\fP can be used to set protocol specific login
options, such as the preferred authentication mechanism via "AUTH=NTLM" or
"AUTH=*", and should be used in conjunction with the \fICURLOPT_USERNAME(3)\fP
option.
Since 8.2.0, IMAP supports the login option "AUTH=+LOGIN". With this option,
curl uses the plain (not SASL) LOGIN IMAP command even if the server
advertises SASL authentication. Care should be taken in using this option, as
it sends your password in plain text. This does not work if the IMAP server
disables the plain LOGIN (e.g. to prevent password snooping).
The application does not have to keep the string around after setting this
option.
.SH DEFAULT
NULL
.SH PROTOCOLS
Only IMAP, LDAP, POP3 and SMTP support login options.
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "smtp://example.com/");
curl_easy_setopt(curl, CURLOPT_LOGIN_OPTIONS, "AUTH=*");
ret = curl_easy_perform(curl);
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Added in 7.34.0. Support for OpenLDAP added in 7.82.0.
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, CURLE_UNKNOWN_OPTION if not, or
CURLE_OUT_OF_MEMORY if there was insufficient heap space.
.SH "SEE ALSO"
.BR CURLOPT_PASSWORD (3),
.BR CURLOPT_USERNAME (3)
man/man3/CURLOPT_DISALLOW_USERNAME_IN_URL.3 0000644 00000004415 14751172371 0013312 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_DISALLOW_USERNAME_IN_URL 3 "September 27, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_DISALLOW_USERNAME_IN_URL \- disallow specifying username in the URL
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_DISALLOW_USERNAME_IN_URL,
long disallow);
.fi
.SH DESCRIPTION
A long parameter set to 1 tells the library to not allow URLs that include a
username.
This is the equivalent to the \fICURLU_DISALLOW_USER\fP flag for the
\fIcurl_url_set(3)\fP function.
.SH DEFAULT
0 (disabled) - user names are allowed by default.
.SH PROTOCOLS
Several
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
curl_easy_setopt(curl, CURLOPT_DISALLOW_USERNAME_IN_URL, 1L);
curl_easy_perform(curl);
}
.fi
.SH AVAILABILITY
Added in 7.61.0
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
\fIcurl_easy_perform(3)\fP returns CURLE_LOGIN_DENIED if this option is
enabled and a URL containing a username is specified.
.SH "SEE ALSO"
.BR curl_url_set (3),
.BR CURLOPT_PROTOCOLS (3),
.BR CURLOPT_URL (3),
.BR libcurl-security (3)
man/man3/curl_url_cleanup.3 0000644 00000003416 14751172371 0011613 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.TH curl_url_cleanup 3 "September 26, 2023" "libcurl 8.4.0" "libcurl"
.SH NAME
curl_url_cleanup - free the URL handle
.SH SYNOPSIS
.nf
#include <curl/curl.h>
void curl_url_cleanup(CURLU *handle);
.fi
.SH DESCRIPTION
Frees all the resources associated with the given \fICURLU\fP handle!
Passing in a NULL pointer in \fIhandle\fP makes this function return
immediately with no action.
.SH EXAMPLE
.nf
CURLU *url = curl_url();
curl_url_set(url, CURLUPART_URL, "https://example.com", 0);
curl_url_cleanup(url);
.fi
.SH AVAILABILITY
Added in 7.62.0
.SH RETURN VALUE
none
.SH "SEE ALSO"
.BR curl_url_dup (3),
.BR curl_url (3),
.BR curl_url_set (3),
.BR curl_url_get (3),
.BR CURLOPT_CURLU (3)
man/man3/CURLOPT_POSTQUOTE.3 0000644 00000004701 14751172371 0011066 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_POSTQUOTE 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_POSTQUOTE \- (S)FTP commands to run after the transfer
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_POSTQUOTE,
struct curl_slist *cmds);
.fi
.SH DESCRIPTION
Pass a pointer to a linked list of FTP or SFTP commands to pass to the server
after your FTP transfer request. The commands are only issues if no error
occur. The linked list should be a fully valid list of struct curl_slist
structs properly filled in as described for \fICURLOPT_QUOTE(3)\fP.
Disable this operation again by setting a NULL to this option.
.SH DEFAULT
NULL
.SH PROTOCOLS
SFTP and FTP
.SH EXAMPLE
.nf
struct curl_slist *cmdlist = NULL;
cmdlist = curl_slist_append(cmdlist, "RNFR source-name");
cmdlist = curl_slist_append(cmdlist, "RNTO new-name");
curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "ftp://example.com/foo.bin");
/* pass in the FTP commands to run after the transfer */
curl_easy_setopt(curl, CURLOPT_POSTQUOTE, cmdlist);
ret = curl_easy_perform(curl);
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
If support for the protocols are built-in.
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR CURLOPT_PREQUOTE (3),
.BR CURLOPT_QUOTE (3)
man/man3/CURLINFO_SPEED_DOWNLOAD.3 0000644 00000004421 14751172371 0011702 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLINFO_SPEED_DOWNLOAD 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLINFO_SPEED_DOWNLOAD \- get download speed
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_getinfo(CURL *handle, CURLINFO_SPEED_DOWNLOAD,
double *speed);
.fi
.SH DESCRIPTION
Pass a pointer to a double to receive the average download speed that curl
measured for the complete download. Measured in bytes/second.
\fICURLINFO_SPEED_DOWNLOAD_T(3)\fP is a newer replacement that returns a more
sensible variable type.
.SH PROTOCOLS
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
/* Perform the request */
res = curl_easy_perform(curl);
if(!res) {
double speed;
res = curl_easy_getinfo(curl, CURLINFO_SPEED_DOWNLOAD, &speed);
if(!res) {
printf("Download speed %.0f bytes/sec\\n", speed);
}
}
}
.fi
.SH AVAILABILITY
Added in 7.4.1. Deprecated since 7.55.0.
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR curl_easy_getinfo (3),
.BR curl_easy_setopt (3),
.BR CURLINFO_SIZE_UPLOAD_T (3),
.BR CURLINFO_SPEED_UPLOAD (3)
man/man3/curl_url_set.3 0000644 00000021625 14751172371 0010761 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.TH curl_url_set 3 "September 26, 2023" "libcurl 8.4.0" "libcurl"
.SH NAME
curl_url_set - set a URL part
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLUcode curl_url_set(CURLU *url,
CURLUPart part,
const char *content,
unsigned int flags);
.fi
.SH DESCRIPTION
The \fIurl\fP handle to work on, passed in as the first argument, must be a
handle previously created by \fIcurl_url(3)\fP or \fIcurl_url_dup(3)\fP.
This function sets or updates individual URL components, or parts, held by the
URL object the handle identifies.
The \fIpart\fP argument should identify the particular URL part (see list
below) to set or change, with \fIcontent\fP pointing to a null-terminated
string with the new contents for that URL part. The contents should be in the
form and encoding they would use in a URL: URL encoded.
When setting part in the URL object that was previously already set, it
replaces the data that was previously stored for that part with the new
\fIcontent\fP.
The caller does not have to keep \fIcontent\fP around after a successful call
as this function copies the content.
Setting a part to a NULL pointer removes that part's contents from the
\fICURLU\fP handle.
By default, this API only accepts URLs using schemes for protocols that are
supported built-in. To make libcurl parse URLs generically even for schemes it
does not know about, the \fBCURLU_NON_SUPPORT_SCHEME\fP flags bit must be
set. Otherwise, this function returns \fICURLUE_UNSUPPORTED_SCHEME\fP for URL
schemes it does not recognize.
This function has an 8 MB maximum length limit for all provided input strings.
In the real world, excessively long fields in URLs cause problems even if this
API accepts them.
When setting or updating contents of individual URL parts, this API might
accept data that would not be otherwise possible to set in the string when it
gets populated as a result of a full URL parse. Beware. If done so, extracting
a full URL later on from such components might render an invalid URL.
The \fIflags\fP argument is a bitmask with independent features.
.SH PARTS
.IP CURLUPART_URL
Allows the full URL of the handle to be replaced. If the handle already is
populated with a URL, the new URL can be relative to the previous.
When successfully setting a new URL, relative or absolute, the handle contents
is replaced with the components of the newly set URL.
Pass a pointer to a null-terminated string to the \fIurl\fP parameter. The
string must point to a correctly formatted "RFC 3986+" URL or be a NULL
pointer.
Unless \fICURLU_NO_AUTHORITY\fP is set, a blank host name is not allowed in
the URL.
.IP CURLUPART_SCHEME
Scheme cannot be URL decoded on set. libcurl only accepts setting schemes up
to 40 bytes long.
.IP CURLUPART_USER
.IP CURLUPART_PASSWORD
.IP CURLUPART_OPTIONS
The options field is an optional field that might follow the password in the
userinfo part. It is only recognized/used when parsing URLs for the following
schemes: pop3, smtp and imap. This function however allows users to
independently set this field.
.IP CURLUPART_HOST
The host name. If it is International Domain Name (IDN) the string must then
be encoded as your locale says or UTF-8 (when WinIDN is used). If it is a
bracketed IPv6 numeric address it may contain a zone id (or you can use
\fICURLUPART_ZONEID\fP).
Unless \fICURLU_NO_AUTHORITY\fP is set, a blank host name is not allowed to set.
.IP CURLUPART_ZONEID
If the host name is a numeric IPv6 address, this field can also be set.
.IP CURLUPART_PORT
The port number cannot be URL encoded on set. The given port number is
provided as a string and the decimal number in it must be between 0 and
65535. Anything else returns an error.
.IP CURLUPART_PATH
If a path is set in the URL without a leading slash, a slash is prepended
automatically.
.IP CURLUPART_QUERY
The query part gets spaces converted to pluses when asked to URL encode on set
with the \fICURLU_URLENCODE\fP bit.
If used together with the \fICURLU_APPENDQUERY\fP bit, the provided part is
appended on the end of the existing query.
The question mark in the URL is not part of the actual query contents.
.IP CURLUPART_FRAGMENT
The hash sign in the URL is not part of the actual fragment contents.
.SH FLAGS
The flags argument is zero, one or more bits set in a bitmask.
.IP CURLU_APPENDQUERY
Can be used when setting the \fICURLUPART_QUERY\fP component. The provided new
part is then appended at the end of the existing query - and if the previous
part did not end with an ampersand (&), an ampersand gets inserted before the
new appended part.
When \fICURLU_APPENDQUERY\fP is used together with \fICURLU_URLENCODE\fP, the
first '=' symbol is not URL encoded.
.IP CURLU_NON_SUPPORT_SCHEME
If set, allows \fIcurl_url_set(3)\fP to set a non-supported scheme.
.IP CURLU_URLENCODE
When set, \fIcurl_url_set(3)\fP URL encodes the part on entry, except for
scheme, port and URL.
When setting the path component with URL encoding enabled, the slash character
is be skipped.
The query part gets space-to-plus conversion before the URL conversion.
This URL encoding is charset unaware and converts the input in a byte-by-byte
manner.
.IP CURLU_DEFAULT_SCHEME
If set, allows the URL to be set without a scheme and then sets that to the
default scheme: HTTPS. Overrides the \fICURLU_GUESS_SCHEME\fP option if both
are set.
.IP CURLU_GUESS_SCHEME
If set, allows the URL to be set without a scheme and it instead "guesses"
which scheme that was intended based on the host name. If the outermost
subdomain name matches DICT, FTP, IMAP, LDAP, POP3 or SMTP then that scheme
is used, otherwise it picks HTTP. Conflicts with the
\fICURLU_DEFAULT_SCHEME\fP option which takes precedence if both are set.
.IP CURLU_NO_AUTHORITY
If set, skips authority checks. The RFC allows individual schemes to omit the
host part (normally the only mandatory part of the authority), but libcurl
cannot know whether this is permitted for custom schemes. Specifying the flag
permits empty authority sections, similar to how file scheme is handled.
.IP CURLU_PATH_AS_IS
When set for \fBCURLUPART_URL\fP, this skips the normalization of the
path. That is the procedure where libcurl otherwise removes sequences of
dot-slash and dot-dot etc. The same option used for transfers is called
\fICURLOPT_PATH_AS_IS(3)\fP.
.IP CURLU_ALLOW_SPACE
If set, the URL parser allows space (ASCII 32) where possible. The URL syntax
does normally not allow spaces anywhere, but they should be encoded as %20
or '+'. When spaces are allowed, they are still not allowed in the scheme.
When space is used and allowed in a URL, it is stored as-is unless
\fICURLU_URLENCODE\fP is also set, which then makes libcurl URL encode the
space before stored. This affects how the URL is constructed when
\fIcurl_url_get(3)\fP is subsequently used to extract the full URL or
individual parts. (Added in 7.78.0)
.IP CURLU_DISALLOW_USER
If set, the URL parser does not accept embedded credentials for the
\fBCURLUPART_URL\fP, and instead returns \fBCURLUE_USER_NOT_ALLOWED\fP for
such URLs.
.SH EXAMPLE
.nf
CURLUcode rc;
CURLU *url = curl_url();
rc = curl_url_set(url, CURLUPART_URL, "https://example.com", 0);
if(!rc) {
char *scheme;
/* change it to an FTP URL */
rc = curl_url_set(url, CURLUPART_SCHEME, "ftp", 0);
}
curl_url_cleanup(url);
.fi
.SH AVAILABILITY
Added in 7.62.0. CURLUPART_ZONEID was added in 7.65.0.
.SH RETURN VALUE
Returns a \fICURLUcode\fP error value, which is CURLUE_OK (0) if everything
went fine. See the \fIlibcurl-errors(3)\fP man page for the full list with
descriptions.
The input string passed to \fIcurl_url_set(3)\fP must be shorter than eight
million bytes. Otherwise this function returns \fBCURLUE_MALFORMED_INPUT\fP.
If this function returns an error, no URL part is set.
.SH "SEE ALSO"
.BR curl_url (3),
.BR curl_url_cleanup (3),
.BR curl_url_dup (3),
.BR curl_url_get (3),
.BR curl_url_strerror (3),
.BR CURLOPT_CURLU (3)
man/man3/CURLOPT_HTTPPOST.3 0000644 00000006232 14751172371 0010751 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_HTTPPOST 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_HTTPPOST \- multipart formpost content
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_HTTPPOST,
struct curl_httppost *formpost);
.SH DESCRIPTION
\fBThis option is deprecated.\fP Use \fICURLOPT_MIMEPOST(3)\fP instead.
Tells libcurl you want a \fBmultipart/formdata\fP HTTP POST to be made and you
instruct what data to pass on to the server in the \fIformpost\fP argument.
Pass a pointer to a linked list of \fIcurl_httppost\fP structs as parameter.
The easiest way to create such a list, is to use \fIcurl_formadd(3)\fP as
documented. The data in this list must remain intact as long as the curl
transfer is alive and is using it.
Using POST with HTTP 1.1 implies the use of a "Expect: 100-continue" header.
You can disable this header with \fICURLOPT_HTTPHEADER(3)\fP.
When setting \fICURLOPT_HTTPPOST(3)\fP, libcurl automatically sets
\fICURLOPT_NOBODY(3)\fP to 0.
.SH DEFAULT
NULL
.SH PROTOCOLS
HTTP
.SH EXAMPLE
.nf
/* Fill in the file upload field. This makes libcurl load data from
the given file name when curl_easy_perform() is called. */
curl_formadd(&formpost,
&lastptr,
CURLFORM_COPYNAME, "sendfile",
CURLFORM_FILE, "postit2.c",
CURLFORM_END);
/* Fill in the filename field */
curl_formadd(&formpost,
&lastptr,
CURLFORM_COPYNAME, "filename",
CURLFORM_COPYCONTENTS, "postit2.c",
CURLFORM_END);
/* Fill in the submit field too, even if this is rarely needed */
curl_formadd(&formpost,
&lastptr,
CURLFORM_COPYNAME, "submit",
CURLFORM_COPYCONTENTS, "send",
CURLFORM_END);
.fi
.SH AVAILABILITY
As long as HTTP is enabled. Deprecated in 7.56.0.
.SH RETURN VALUE
Returns CURLE_OK if HTTP is enabled, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR curl_formadd (3),
.BR curl_formfree (3),
.BR curl_mime_init (3),
.BR CURLOPT_MIMEPOST (3),
.BR CURLOPT_POST (3),
.BR CURLOPT_POSTFIELDS (3)
man/man3/curl_global_init.3 0000644 00000011440 14751172371 0011561 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.TH curl_global_init 3 "September 26, 2023" "libcurl 8.4.0" "libcurl"
.SH NAME
curl_global_init - Global libcurl initialization
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_global_init(long flags);
.fi
.SH DESCRIPTION
This function sets up the program environment that libcurl needs. Think of it
as an extension of the library loader.
This function must be called at least once within a program (a program is all
the code that shares a memory space) before the program calls any other
function in libcurl. The environment it sets up is constant for the life of
the program and is the same for every program, so multiple calls have the same
effect as one call.
The flags option is a bit pattern that tells libcurl exactly what features to
init, as described below. Set the desired bits by ORing the values together.
In normal operation, you must specify CURL_GLOBAL_ALL. Do not use any other
value unless you are familiar with it and mean to control internal operations
of libcurl.
This function is thread-safe since libcurl 7.84.0 if
\fIcurl_version_info(3)\fP has the CURL_VERSION_THREADSAFE feature bit set
(most platforms).
If this is not thread-safe, you must not call this function when any other
thread in the program (i.e. a thread sharing the same memory) is running.
This does not just mean no other thread that is using libcurl. Because
\fIcurl_global_init(3)\fP calls functions of other libraries that are
similarly thread unsafe, it could conflict with any other thread that uses
these other libraries.
If you are initializing libcurl from a Windows DLL you should not initialize
it from \fIDllMain\fP or a static initializer because Windows holds the loader
lock during that time and it could cause a deadlock.
See the description in \fIlibcurl(3)\fP of global environment requirements for
details of how to use this function.
.SH FLAGS
.IP CURL_GLOBAL_ALL
Initialize everything possible. This sets all known bits except
\fBCURL_GLOBAL_ACK_EINTR\fP.
.IP CURL_GLOBAL_SSL
(This flag's presence or absence serves no meaning since 7.57.0. The
description below is for older libcurl versions.)
Initialize SSL.
The implication here is that if this bit is not set, the initialization of the
SSL layer needs to be done by the application or at least outside of
libcurl. The exact procedure how to do SSL initialization depends on the TLS
backend libcurl uses.
Doing TLS based transfers without having the TLS layer initialized may lead to
unexpected behaviors.
.IP CURL_GLOBAL_WIN32
Initialize the Win32 socket libraries.
The implication here is that if this bit is not set, the initialization of
winsock has to be done by the application or you risk getting undefined
behaviors. This option exists for when the initialization is handled outside
of libcurl so there is no need for libcurl to do it again.
.IP CURL_GLOBAL_NOTHING
Initialize nothing extra. This sets no bit.
.IP CURL_GLOBAL_DEFAULT
A sensible default. It initializes both SSL and Win32. Right now, this equals
the functionality of the \fBCURL_GLOBAL_ALL\fP mask.
.IP CURL_GLOBAL_ACK_EINTR
This bit has no point since 7.69.0 but its behavior is instead the default.
Before 7.69.0: when this flag is set, curl acknowledges EINTR condition when
connecting or when waiting for data. Otherwise, curl waits until full timeout
elapses. (Added in 7.30.0)
.SH EXAMPLE
.nf
curl_global_init(CURL_GLOBAL_DEFAULT);
/* use libcurl, then before exiting... */
curl_global_cleanup();
.fi
.SH AVAILABILITY
Added in 7.8
.SH RETURN VALUE
If this function returns non-zero, something went wrong and you cannot use the
other curl functions.
.SH "SEE ALSO"
.BR curl_easy_init (3),
.BR curl_global_cleanup (3),
.BR curl_global_init_mem (3),
.BR curl_global_sslset (3),
.BR curl_global_trace (3),
.BR libcurl (3)
man/man3/CURLOPT_COOKIE.3 0000644 00000006516 14751172371 0010442 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_COOKIE 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_COOKIE \- HTTP Cookie header
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_COOKIE, char *cookie);
.fi
.SH DESCRIPTION
Pass a pointer to a null-terminated string as parameter. It is used to set one
or more cookies in the HTTP request. The format of the string should be
NAME=CONTENTS, where NAME is the cookie name and CONTENTS is what the cookie
should contain.
To set multiple cookies, set them all using a single option concatenated like
this: "name1=content1; name2=content2;" etc.
This option sets the cookie header explicitly in the outgoing request(s). If
multiple requests are done due to authentication, followed redirections or
similar, they all get this cookie passed on.
The cookies set by this option are separate from the internal cookie storage
held by the cookie engine and they are not be modified by it. If you enable
the cookie engine and either you have imported a cookie of the same name
(e.g. 'foo') or the server has set one, it has no effect on the cookies you
set here. A request to the server sends both the 'foo' held by the cookie
engine and the 'foo' held by this option. To set a cookie that is instead held
by the cookie engine and can be modified by the server use
\fICURLOPT_COOKIELIST(3)\fP.
Using this option multiple times makes the last set string override the
previous ones.
This option does not enable the cookie engine. Use \fICURLOPT_COOKIEFILE(3)\fP
or \fICURLOPT_COOKIEJAR(3)\fP to enable parsing and sending cookies
automatically.
The application does not have to keep the string around after setting this
option.
.SH DEFAULT
NULL, no cookies
.SH PROTOCOLS
HTTP
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
curl_easy_setopt(curl, CURLOPT_COOKIE, "tool=curl; fun=yes;");
curl_easy_perform(curl);
}
.fi
.SH AVAILABILITY
If HTTP is enabled
.SH RETURN VALUE
Returns CURLE_OK if HTTP is enabled, CURLE_UNKNOWN_OPTION if not, or
CURLE_OUT_OF_MEMORY if there was insufficient heap space.
.SH "SEE ALSO"
.BR CURLINFO_COOKIELIST (3),
.BR CURLOPT_COOKIEFILE (3),
.BR CURLOPT_COOKIEJAR (3),
.BR CURLOPT_COOKIELIST (3),
.BR CURLOPT_HTTPHEADER (3)
man/man3/CURLINFO_LASTSOCKET.3 0000644 00000005402 14751172371 0011227 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLINFO_LASTSOCKET 3 "September 27, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLINFO_LASTSOCKET \- get the last socket used
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_getinfo(CURL *handle, CURLINFO_LASTSOCKET, long *socket);
.fi
.SH DESCRIPTION
Deprecated since 7.45.0. Use \fICURLINFO_ACTIVESOCKET(3)\fP instead.
Pass a pointer to a long to receive the last socket used by this curl
session. If the socket is no longer valid, -1 is returned. When you finish
working with the socket, you must call \fIcurl_easy_cleanup(3)\fP as usual and
let libcurl close the socket and cleanup other resources associated with the
handle. This is typically used in combination with
\fICURLOPT_CONNECT_ONLY(3)\fP.
NOTE: this API is deprecated since it is not working on win64 where the SOCKET
type is 64 bits large while its 'long' is 32 bits. Use the
\fICURLINFO_ACTIVESOCKET(3)\fP instead, if possible.
.SH PROTOCOLS
All
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
long sockfd; /* does not work on win64! */
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
/* Do not do the transfer - only connect to host */
curl_easy_setopt(curl, CURLOPT_CONNECT_ONLY, 1L);
res = curl_easy_perform(curl);
/* Extract the socket from the curl handle */
res = curl_easy_getinfo(curl, CURLINFO_LASTSOCKET, &sockfd);
if(res != CURLE_OK) {
printf("Error: %s\\n", curl_easy_strerror(res));
return 1;
}
}
.fi
.SH AVAILABILITY
Added in 7.15.2
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR curl_easy_getinfo (3),
.BR curl_easy_setopt (3),
.BR CURLINFO_ACTIVESOCKET (3),
.BR CURLOPT_CONNECT_ONLY (3)
man/man3/CURLINFO_COOKIELIST.3 0000644 00000005510 14751172371 0011220 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLINFO_COOKIELIST 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLINFO_COOKIELIST \- get all known cookies
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_getinfo(CURL *handle, CURLINFO_COOKIELIST,
struct curl_slist **cookies);
.fi
.SH DESCRIPTION
Pass a pointer to a 'struct curl_slist *' to receive a linked-list of all
cookies curl knows (expired ones, too). do not forget to call
\fIcurl_slist_free_all(3)\fP on the list after it has been used. If there are
no cookies (cookies for the handle have not been enabled or simply none have
been received) the 'struct curl_slist *' is made a NULL pointer.
Since 7.43.0 cookies that were imported in the Set-Cookie format without a
domain name are not exported by this option.
.SH PROTOCOLS
HTTP(S)
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
/* enable the cookie engine */
curl_easy_setopt(curl, CURLOPT_COOKIEFILE, "");
res = curl_easy_perform(curl);
if(!res) {
/* extract all known cookies */
struct curl_slist *cookies = NULL;
res = curl_easy_getinfo(curl, CURLINFO_COOKIELIST, &cookies);
if(!res && cookies) {
/* a linked list of cookies in cookie file format */
struct curl_slist *each = cookies;
while(each) {
printf("%s\\n", each->data);
each = each->next;
}
/* we must free these cookies when we are done */
curl_slist_free_all(cookies);
}
}
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Added in 7.14.1
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR curl_easy_getinfo (3),
.BR curl_easy_setopt (3),
.BR CURLOPT_COOKIELIST (3)
man/man3/curl_mime_type.3 0000644 00000005473 14751172371 0011277 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.TH curl_mime_type 3 "September 26, 2023" "libcurl 8.4.0" "libcurl"
.SH NAME
curl_mime_type - set a mime part's content type
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_mime_type(curl_mimepart *part, const char *mimetype);
.fi
.SH DESCRIPTION
\fIcurl_mime_type(3)\fP sets a mime part's content type.
\fIpart\fP is the part's handle to assign the content type to.
\fImimetype\fP points to the null-terminated file mime type string; it may be
set to NULL to remove a previously attached mime type.
The mime type string is copied into the part, thus the associated storage may
safely be released or reused after call. Setting a part's type multiple times
is valid: only the value set by the last call is retained.
In the absence of a mime type and if needed by the protocol specifications,
a default mime type is determined by the context:
.br
- If set as a custom header, use this value.
.br
- application/form-data for an HTTP form post.
.br
- If a remote file name is set, the mime type is taken from the file name
extension, or application/octet-stream by default.
.br
- For a multipart part, multipart/mixed.
.br
- text/plain in other cases.
.SH EXAMPLE
.nf
curl_mime *mime;
curl_mimepart *part;
/* create a mime handle */
mime = curl_mime_init(easy);
/* add a part */
part = curl_mime_addpart(mime);
/* get data from this file */
curl_mime_filedata(part, "image.png");
/* content-type for this part */
curl_mime_type(part, "image/png");
/* set name */
curl_mime_name(part, "image");
.fi
.SH AVAILABILITY
As long as at least one of HTTP, SMTP or IMAP is enabled. Added in 7.56.0.
.SH RETURN VALUE
CURLE_OK or a CURL error code upon failure.
.SH "SEE ALSO"
.BR curl_mime_addpart (3),
.BR curl_mime_data (3),
.BR curl_mime_name (3)
man/man3/CURLOPT_SHARE.3 0000644 00000006213 14751172371 0010325 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_SHARE 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_SHARE \- share handle to use
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_SHARE, CURLSH *share);
.fi
.SH DESCRIPTION
Pass a \fIshare\fP handle as a parameter. The share handle must have been
created by a previous call to \fIcurl_share_init(3)\fP. Setting this option,
makes this curl handle use the data from the shared handle instead of keeping
the data to itself. This enables several curl handles to share data. If the
curl handles are used simultaneously in multiple threads, you \fBMUST\fP use
the locking methods in the share handle. See \fIcurl_share_setopt(3)\fP for
details.
If you add a share that is set to share cookies, your easy handle uses that
cookie cache and get the cookie engine enabled. If you stop sharing an object
that was using cookies (or change to another object that does not share
cookies), the easy handle gets its cookie engine disabled.
Data that the share object is not set to share is dealt with the usual way, as
if no share was used.
Set this option to NULL again to stop using that share object.
.SH DEFAULT
NULL
.SH PROTOCOLS
All
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
CURL *curl2 = curl_easy_init(); /* a second handle */
if(curl) {
CURLSH *shobject = curl_share_init();
curl_share_setopt(shobject, CURLSHOPT_SHARE, CURL_LOCK_DATA_COOKIE);
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/");
curl_easy_setopt(curl, CURLOPT_COOKIEFILE, "");
curl_easy_setopt(curl, CURLOPT_SHARE, shobject);
ret = curl_easy_perform(curl);
curl_easy_cleanup(curl);
/* the second handle shares cookies from the first */
curl_easy_setopt(curl2, CURLOPT_URL, "https://example.com/second");
curl_easy_setopt(curl2, CURLOPT_COOKIEFILE, "");
curl_easy_setopt(curl2, CURLOPT_SHARE, shobject);
ret = curl_easy_perform(curl2);
curl_easy_cleanup(curl2);
curl_share_cleanup(shobject);
}
.fi
.SH AVAILABILITY
Always
.SH RETURN VALUE
Returns CURLE_OK
.SH "SEE ALSO"
.BR CURLOPT_COOKIE (3),
.BR CURLSHOPT_SHARE (3)
man/man3/CURLOPT_AUTOREFERER.3 0000644 00000004661 14751172371 0011253 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_AUTOREFERER 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_AUTOREFERER \- automatically update the referer header
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_AUTOREFERER, long autorefer);
.fi
.SH DESCRIPTION
Pass a long parameter set to 1 to enable this. When enabled, libcurl
automatically sets the Referer: header field in HTTP requests to the full URL
when it follows a Location: redirect to a new destination.
The automatic referer is set to the full previous URL even when redirects are
done cross-origin or following redirects to insecure protocols. This is
considered a minor privacy leak by some.
.SH DEFAULT
0, disabled
.SH PROTOCOLS
HTTP
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/foo.bin");
/* follow redirects */
curl_easy_setopt(curl, CURLOPT_FOLLOWLOCATION, 1L);
/* set Referer: automatically when following redirects */
curl_easy_setopt(curl, CURLOPT_AUTOREFERER, 1L);
ret = curl_easy_perform(curl);
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Along with HTTP
.SH RETURN VALUE
Returns CURLE_OK if HTTP is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR CURLINFO_EFFECTIVE_URL (3),
.BR CURLINFO_REDIRECT_URL (3),
.BR CURLOPT_FOLLOWLOCATION (3),
.BR CURLOPT_REFERER (3)
man/man3/CURLOPT_DNS_LOCAL_IP4.3 0000644 00000004724 14751172371 0011502 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_DNS_LOCAL_IP4 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_DNS_LOCAL_IP4 \- IPv4 address to bind DNS resolves to
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_DNS_LOCAL_IP4, char *address);
.fi
.SH DESCRIPTION
Set the local IPv4 \fIaddress\fP that the resolver should bind to. The
argument should be of type char * and contain a single numerical IPv4 address
as a string. Set this option to NULL to use the default setting (do not bind
to a specific IP address).
The application does not have to keep the string around after setting this
option.
.SH DEFAULT
NULL
.SH PROTOCOLS
All
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/foo.bin");
curl_easy_setopt(curl, CURLOPT_DNS_LOCAL_IP4, "192.168.0.14");
ret = curl_easy_perform(curl);
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
This option requires that libcurl was built with a resolver backend that
supports this operation. The c-ares backend is the only such one.
Added in 7.33.0
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, CURLE_UNKNOWN_OPTION if not,
CURLE_NOT_BUILT_IN if support was disabled at compile-time, or
CURLE_BAD_FUNCTION_ARGUMENT when given a bad address.
.SH "SEE ALSO"
.BR CURLOPT_DNS_INTERFACE (3),
.BR CURLOPT_DNS_LOCAL_IP6 (3),
.BR CURLOPT_DNS_SERVERS (3)
man/man3/CURLOPT_XOAUTH2_BEARER.3 0000644 00000004577 14751172371 0011610 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_XOAUTH2_BEARER 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_XOAUTH2_BEARER \- OAuth 2.0 access token
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_XOAUTH2_BEARER, char *token);
.fi
.SH DESCRIPTION
Pass a char * as parameter, which should point to the null-terminated OAuth
2.0 Bearer Access Token for use with HTTP, IMAP, LDAP, POP3 and SMTP servers
that support the OAuth 2.0 Authorization Framework.
Note: For IMAP, LDAP, POP3 and SMTP, the user name used to generate the
Bearer Token should be supplied via the \fICURLOPT_USERNAME(3)\fP option.
The application does not have to keep the string around after setting this
option.
.SH DEFAULT
NULL
.SH PROTOCOLS
HTTP, IMAP, LDAP, POP3 and SMTP
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "pop3://example.com/");
curl_easy_setopt(curl, CURLOPT_XOAUTH2_BEARER, "1ab9cb22ba269a7");
ret = curl_easy_perform(curl);
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Added in 7.33.0. Support for OpenLDAP added in 7.82.0.
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, CURLE_UNKNOWN_OPTION if not, or
CURLE_OUT_OF_MEMORY if there was insufficient heap space.
.SH "SEE ALSO"
.BR CURLOPT_MAIL_AUTH (3),
.BR CURLOPT_USERNAME (3)
man/man3/CURLOPT_HEADEROPT.3 0000644 00000006154 14751172371 0011002 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_HEADEROPT 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_HEADEROPT \- send HTTP headers to both proxy and host or separately
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_HEADEROPT, long bitmask);
.fi
.SH DESCRIPTION
Pass a long that is a bitmask of options of how to deal with headers. The two
mutually exclusive options are:
\fBCURLHEADER_UNIFIED\fP - the headers specified in
\fICURLOPT_HTTPHEADER(3)\fP are used in requests both to servers and
proxies. With this option enabled, \fICURLOPT_PROXYHEADER(3)\fP does not have
any effect.
\fBCURLHEADER_SEPARATE\fP - makes \fICURLOPT_HTTPHEADER(3)\fP headers only get
sent to a server and not to a proxy. Proxy headers must be set with
\fICURLOPT_PROXYHEADER(3)\fP to get used. Note that if a non-CONNECT request
is sent to a proxy, libcurl sends both server headers and proxy headers. When
doing CONNECT, libcurl sends \fICURLOPT_PROXYHEADER(3)\fP headers only to the
proxy and then \fICURLOPT_HTTPHEADER(3)\fP headers only to the server.
.SH DEFAULT
CURLHEADER_SEPARATE (changed in 7.42.1, used CURLHEADER_UNIFIED before then)
.SH PROTOCOLS
HTTP
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
CURLcode ret;
struct curl_slist *list;
list = curl_slist_append(NULL, "Shoesize: 10");
list = curl_slist_append(list, "Accept:");
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/");
curl_easy_setopt(curl, CURLOPT_PROXY, "http://localhost:8080");
curl_easy_setopt(curl, CURLOPT_HTTPHEADER, list);
/* HTTPS over a proxy makes a separate CONNECT to the proxy, so tell
libcurl to not send the custom headers to the proxy. Keep them
separate! */
curl_easy_setopt(curl, CURLOPT_HEADEROPT, CURLHEADER_SEPARATE);
ret = curl_easy_perform(curl);
curl_slist_free_all(list);
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Added in 7.37.0
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR CURLOPT_HTTPHEADER (3),
.BR CURLOPT_PROXYHEADER (3)
man/man3/CURLOPT_DEFAULT_PROTOCOL.3 0000644 00000005776 14751172371 0012105 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_DEFAULT_PROTOCOL 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_DEFAULT_PROTOCOL \- default protocol to use if the URL is missing a
scheme name
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_DEFAULT_PROTOCOL,
char *protocol);
.fi
.SH DESCRIPTION
This option tells libcurl to use \fIprotocol\fP if the URL is missing a scheme
name.
Use one of these protocol (scheme) names:
dict, file, ftp, ftps, gopher, http, https, imap, imaps, ldap, ldaps, pop3,
pop3s, rtsp, scp, sftp, smb, smbs, smtp, smtps, telnet, tftp
An unknown or unsupported protocol causes error
\fICURLE_UNSUPPORTED_PROTOCOL\fP when libcurl parses a URL without a
scheme. Parsing happens when \fIcurl_easy_perform(3)\fP or
\fIcurl_multi_perform(3)\fP is called. The protocol set supported by libcurl
vary depending on how it was built. Use \fIcurl_version_info(3)\fP if you need
a list of protocol names supported by the build of libcurl that you are using.
This option does not change the default proxy protocol (http).
Without this option libcurl would make a guess based on the host, see
\fICURLOPT_URL(3)\fP for details.
The application does not have to keep the string around after setting this
option.
.SH DEFAULT
NULL (make a guess based on the host)
.SH PROTOCOLS
All
.SH EXAMPLE
.nf
curl = curl_easy_init();
if(curl) {
/* set a URL without a scheme */
curl_easy_setopt(curl, CURLOPT_URL, "example.com");
/* set the default protocol (scheme) for schemeless URLs */
curl_easy_setopt(curl, CURLOPT_DEFAULT_PROTOCOL, "https");
/* Perform the request */
curl_easy_perform(curl);
}
.fi
.SH AVAILABILITY
Added in 7.45.0
.SH RETURN VALUE
CURLE_OK if the option is supported.
CURLE_OUT_OF_MEMORY if there was insufficient heap space.
CURLE_UNKNOWN_OPTION if the option is not supported.
.SH "SEE ALSO"
.BR CURLINFO_PROTOCOL (3),
.BR CURLINFO_SCHEME (3),
.BR CURLOPT_URL (3)
man/man3/CURLMOPT_PUSHDATA.3 0000644 00000005215 14751172371 0011012 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLMOPT_PUSHDATA 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLMOPT_PUSHDATA \- pointer to pass to push callback
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLMcode curl_multi_setopt(CURLM *handle, CURLMOPT_PUSHDATA, void *pointer);
.fi
.SH DESCRIPTION
Set a \fIpointer\fP to pass as the last argument to the
\fICURLMOPT_PUSHFUNCTION(3)\fP callback. The pointer is not touched or used by
libcurl itself, only passed on to the callback function.
.SH DEFAULT
NULL
.SH PROTOCOLS
HTTP(S)
.SH EXAMPLE
.nf
/* only allow pushes for file names starting with "push-" */
int push_callback(CURL *parent,
CURL *easy,
size_t num_headers,
struct curl_pushheaders *headers,
void *clientp)
{
char *headp;
int *transfers = (int *)clientp;
FILE *out;
headp = curl_pushheader_byname(headers, ":path");
if(headp && !strncmp(headp, "/push-", 6)) {
fprintf(stderr, "The PATH is %s\\n", headp);
/* save the push here */
out = fopen("pushed-stream", "wb");
/* write to this file */
curl_easy_setopt(easy, CURLOPT_WRITEDATA, out);
(*transfers)++; /* one more */
return CURL_PUSH_OK;
}
return CURL_PUSH_DENY;
}
curl_multi_setopt(multi, CURLMOPT_PUSHFUNCTION, push_callback);
curl_multi_setopt(multi, CURLMOPT_PUSHDATA, &counter);
.fi
.SH AVAILABILITY
Added in 7.44.0
.SH RETURN VALUE
Returns CURLM_OK if the option is supported, and CURLM_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR CURLMOPT_PIPELINING (3),
.BR CURLMOPT_PUSHFUNCTION (3),
.BR CURLOPT_PIPEWAIT (3),
.BR RFC 7540
man/man3/curl_mime_free.3 0000644 00000004415 14751172371 0011232 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.TH curl_mime_free 3 "September 26, 2023" "libcurl 8.4.0" "libcurl"
.SH NAME
curl_mime_free - free a previously built mime structure
.SH SYNOPSIS
.nf
#include <curl/curl.h>
void curl_mime_free(curl_mime *mime);
.fi
.SH DESCRIPTION
\fIcurl_mime_free(3)\fP is used to clean up data previously built/appended
with \fIcurl_mime_addpart(3)\fP and other mime-handling functions. This must
be called when the data has been used, which typically means after
\fIcurl_easy_perform(3)\fP has been called.
The handle to free is the one you passed to the \fICURLOPT_MIMEPOST(3)\fP
option: attached sub part mime structures must not be explicitly freed as they
are by the top structure freeing.
\fBmime\fP is the handle as returned from a previous call to
\fIcurl_mime_init(3)\fP and may be NULL.
Passing in a NULL pointer in \fImime\fP makes this function return immediately
with no action.
.SH EXAMPLE
.nf
/* Build the mime message. */
mime = curl_mime_init(curl);
/* ... */
/* Free multipart message. */
curl_mime_free(mime);
.fi
.SH AVAILABILITY
As long as at least one of HTTP, SMTP or IMAP is enabled. Added in 7.56.0.
.SH RETURN VALUE
None
.SH "SEE ALSO"
.BR curl_free (3),
.BR curl_mime_init (3)
man/man3/curl_multi_wait.3 0000644 00000010742 14751172371 0011460 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.TH curl_multi_wait 3 "September 26, 2023" "libcurl 8.4.0" "libcurl"
.SH NAME
curl_multi_wait - polls on all easy handles in a multi handle
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLMcode curl_multi_wait(CURLM *multi_handle,
struct curl_waitfd extra_fds[],
unsigned int extra_nfds,
int timeout_ms,
int *numfds);
.ad
.SH DESCRIPTION
\fIcurl_multi_wait(3)\fP polls all file descriptors used by the curl easy
handles contained in the given multi handle set. It blocks until activity is
detected on at least one of the handles or \fItimeout_ms\fP has passed.
Alternatively, if the multi handle has a pending internal timeout that has a
shorter expiry time than \fItimeout_ms\fP, that shorter time is be used
instead to make sure timeout accuracy is reasonably kept.
The calling application may pass additional \fIcurl_waitfd\fP structures which
are similar to \fIpoll(2)\fP's \fIpollfd\fP structure to be waited on in the
same call.
On completion, if \fInumfds\fP is non-NULL, it gets populated with the total
number of file descriptors on which interesting events occurred. This number
can include both libcurl internal descriptors as well as descriptors provided
in \fIextra_fds\fP.
If no extra file descriptors are provided and libcurl has no file descriptor
to offer to wait for, this function returns immediately. (Consider using
\fIcurl_multi_poll(3)\fP to avoid this behavior.)
This function is encouraged to be used instead of select(3) when using the
multi interface to allow applications to easier circumvent the common problem
with 1024 maximum file descriptors.
.SH curl_waitfd
.nf
struct curl_waitfd {
curl_socket_t fd;
short events;
short revents;
};
.fi
.IP CURL_WAIT_POLLIN
Bit flag to \fIcurl_waitfd.events\fP indicating the socket should poll on read
events such as new data received.
.IP CURL_WAIT_POLLPRI
Bit flag to \fIcurl_waitfd.events\fP indicating the socket should poll on high
priority read events such as out of band data.
.IP CURL_WAIT_POLLOUT
Bit flag to \fIcurl_waitfd.events\fP indicating the socket should poll on
write events such as the socket being clear to write without blocking.
.SH EXAMPLE
.nf
CURL *easy_handle;
CURLM *multi_handle;
/* add the individual easy handle */
curl_multi_add_handle(multi_handle, easy_handle);
do {
CURLMcode mc;
int numfds;
mc = curl_multi_perform(multi_handle, &still_running);
if(mc == CURLM_OK ) {
/* wait for activity, timeout or "nothing" */
mc = curl_multi_wait(multi_handle, NULL, 0, 1000, &numfds);
}
if(mc != CURLM_OK) {
fprintf(stderr, "curl_multi failed, code %d.\\n", mc);
break;
}
/* 'numfds' being zero means either a timeout or no file descriptors to
wait for. Try timeout on first occurrence, then assume no file
descriptors and no file descriptors to wait for means wait for 100
milliseconds. */
if(!numfds) {
repeats++; /* count number of repeated zero numfds */
if(repeats > 1) {
WAITMS(100); /* sleep 100 milliseconds */
}
}
else
repeats = 0;
} while(still_running);
curl_multi_remove_handle(multi_handle, easy_handle);
.fi
.SH AVAILABILITY
This function was added in libcurl 7.28.0.
.SH RETURN VALUE
CURLMcode type, general libcurl multi interface error code. See
\fIlibcurl-errors(3)\fP
.SH "SEE ALSO"
.BR curl_multi_fdset (3),
.BR curl_multi_perform (3),
.BR curl_multi_poll (3)
man/man3/CURLOPT_MAXREDIRS.3 0000644 00000004710 14751172371 0011021 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_MAXREDIRS 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_MAXREDIRS \- maximum number of redirects allowed
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_MAXREDIRS, long amount);
.fi
.SH DESCRIPTION
Pass a long. The set number is the redirection limit \fIamount\fP. If that
many redirections have been followed, the next redirect triggers the error
(\fICURLE_TOO_MANY_REDIRECTS\fP). This option only makes sense if the
\fICURLOPT_FOLLOWLOCATION(3)\fP is used at the same time.
Setting the limit to 0 makes libcurl refuse any redirect.
Set it to -1 for an infinite number of redirects. This allows your application
to get stuck in never-ending redirect loops.
.SH DEFAULT
30 (since 8.3.0), it was previously unlimited.
.SH PROTOCOLS
HTTP(S)
.SH EXAMPLE
.nf
curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/");
/* enable redirect following */
curl_easy_setopt(curl, CURLOPT_FOLLOWLOCATION, 1L);
/* allow three redirects */
curl_easy_setopt(curl, CURLOPT_MAXREDIRS, 3L);
/* Perform the request */
curl_easy_perform(curl);
}
.fi
.SH AVAILABILITY
Along with HTTP
.SH RETURN VALUE
Returns CURLE_OK if HTTP is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR CURLINFO_REDIRECT_COUNT (3),
.BR CURLINFO_REDIRECT_URL (3),
.BR CURLOPT_FOLLOWLOCATION (3)
man/man3/CURLOPT_PROXY_SSLCERT.3 0000644 00000005661 14751172371 0011611 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_PROXY_SSLCERT 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_PROXY_SSLCERT \- HTTPS proxy client certificate
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_PROXY_SSLCERT, char *cert);
.fi
.SH DESCRIPTION
This option is for connecting to an HTTPS proxy, not an HTTPS server.
Pass a pointer to a null-terminated string as parameter. The string should be
the file name of your client certificate used to connect to the HTTPS proxy.
The default format is "P12" on Secure Transport and "PEM" on other engines,
and can be changed with \fICURLOPT_PROXY_SSLCERTTYPE(3)\fP.
With Secure Transport, this can also be the nickname of the certificate you
wish to authenticate with as it is named in the security database. If you want
to use a file from the current directory, please precede it with "./" prefix,
in order to avoid confusion with a nickname.
When using a client certificate, you most likely also need to provide a
private key with \fICURLOPT_PROXY_SSLKEY(3)\fP.
The application does not have to keep the string around after setting this
option.
.SH DEFAULT
NULL
.SH PROTOCOLS
Used with HTTPS proxy
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/");
curl_easy_setopt(curl, CURLOPT_PROXY, "https://proxy");
curl_easy_setopt(curl, CURLOPT_PROXY_SSLCERT, "client.pem");
curl_easy_setopt(curl, CURLOPT_PROXY_SSLKEY, "key.pem");
curl_easy_setopt(curl, CURLOPT_PROXY_KEYPASSWD, "s3cret");
ret = curl_easy_perform(curl);
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Added in 7.52.0
.SH RETURN VALUE
Returns CURLE_OK if TLS enabled, CURLE_UNKNOWN_OPTION if not, or
CURLE_OUT_OF_MEMORY if there was insufficient heap space.
.SH "SEE ALSO"
.BR CURLOPT_PROXY_SSLCERTTYPE (3),
.BR CURLOPT_PROXY_SSLKEY (3),
.BR CURLOPT_SSLCERT (3)
man/man3/CURLOPT_XFERINFOFUNCTION.3 0000644 00000010310 14751172371 0012042 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_XFERINFOFUNCTION 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_XFERINFOFUNCTION \- progress meter callback
.SH SYNOPSIS
.nf
#include <curl/curl.h>
int progress_callback(void *clientp,
curl_off_t dltotal,
curl_off_t dlnow,
curl_off_t ultotal,
curl_off_t ulnow);
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_XFERINFOFUNCTION,
progress_callback);
.fi
.SH DESCRIPTION
Pass a pointer to your callback function, which should match the prototype
shown above.
This function gets called by libcurl instead of its internal equivalent with a
frequent interval. While data is being transferred it gets called frequently,
and during slow periods like when nothing is being transferred it can slow
down to about one call per second.
\fIclientp\fP is the pointer set with \fICURLOPT_XFERINFODATA(3)\fP, it is not
used by libcurl but is only passed along from the application to the callback.
The callback gets told how much data libcurl is about to transfer and has
already transferred, in number of bytes. \fIdltotal\fP is the total number of
bytes libcurl expects to download in this transfer. \fIdlnow\fP is the number
of bytes downloaded so far. \fIultotal\fP is the total number of bytes libcurl
expects to upload in this transfer. \fIulnow\fP is the number of bytes
uploaded so far.
Unknown/unused argument values passed to the callback are set to zero (like if
you only download data, the upload size remains 0). Many times the callback is
called one or more times first, before it knows the data sizes so a program
must be made to handle that.
If your callback function returns CURL_PROGRESSFUNC_CONTINUE it makes libcurl
to continue executing the default progress function.
Returning any other non-zero value from this callback makes libcurl abort the
transfer and return \fICURLE_ABORTED_BY_CALLBACK\fP.
If you transfer data with the multi interface, this function is not called
during periods of idleness unless you call the appropriate libcurl function
that performs transfers.
\fICURLOPT_NOPROGRESS(3)\fP must be set to 0 to make this function actually
get called.
.SH DEFAULT
By default, libcurl has an internal progress meter. That is rarely wanted by
users.
.SH PROTOCOLS
All
.SH EXAMPLE
.nf
struct progress {
char *private;
size_t size;
};
static size_t progress_callback(void *clientp,
curl_off_t dltotal,
curl_off_t dlnow,
curl_off_t ultotal,
curl_off_t ulnow)
{
struct progress *memory = (struct progress *)clientp;
/* use the values */
return 0; /* all is good */
}
struct progress data;
/* pass struct to callback */
curl_easy_setopt(curl_handle, CURLOPT_XFERINFODATA, &data);
curl_easy_setopt(curl_handle, CURLOPT_XFERINFOFUNCTION, progress_callback);
.fi
.SH AVAILABILITY
Added in 7.32.0. This callback replaces \fICURLOPT_PROGRESSFUNCTION(3)\fP
.SH RETURN VALUE
Returns CURLE_OK.
.SH "SEE ALSO"
.BR CURLOPT_NOPROGRESS (3),
.BR CURLOPT_XFERINFODATA (3)
man/man3/CURLMOPT_TIMERFUNCTION.3 0000644 00000007460 14751172371 0011633 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLMOPT_TIMERFUNCTION 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLMOPT_TIMERFUNCTION \- callback to receive timeout values
.SH SYNOPSIS
.nf
#include <curl/curl.h>
int timer_callback(CURLM *multi, /* multi handle */
long timeout_ms, /* timeout in number of ms */
void *clientp); /* private callback pointer */
CURLMcode curl_multi_setopt(CURLM *handle, CURLMOPT_TIMERFUNCTION, timer_callback);
.SH DESCRIPTION
Pass a pointer to your callback function, which should match the prototype
shown above.
Certain features, such as timeouts and retries, require you to call libcurl
even when there is no activity on the file descriptors.
Your callback function \fBtimer_callback\fP should install a non-repeating
timer with an expire time of \fBtimeout_ms\fP milliseconds. When that timer
fires, call either \fIcurl_multi_socket_action(3)\fP or
\fIcurl_multi_perform(3)\fP, depending on which interface you use.
A \fBtimeout_ms\fP value of -1 passed to this callback means you should delete
the timer. All other values are valid expire times in number of milliseconds.
The \fBtimer_callback\fP is called when the timeout expire time is changed.
The \fBclientp\fP pointer is set with \fICURLMOPT_TIMERDATA(3)\fP.
The timer callback should return 0 on success, and -1 on error. If this
callback returns error, \fBall\fP transfers currently in progress in this
multi handle are aborted and made to fail.
This callback can be used instead of, or in addition to,
\fIcurl_multi_timeout(3)\fP.
\fBWARNING:\fP do not call libcurl directly from within the callback itself
when the \fBtimeout_ms\fP value is zero, since it risks triggering an
unpleasant recursive behavior that immediately calls another call to the
callback with a zero timeout...
.SH DEFAULT
NULL
.SH PROTOCOLS
All
.SH EXAMPLE
.nf
static gboolean timeout_cb(gpointer user_data)
{
int running;
if(user_data) {
g_free(user_data);
curl_multi_setopt(curl_handle, CURLMOPT_TIMERDATA, NULL);
}
curl_multi_socket_action(multi, CURL_SOCKET_TIMEOUT, 0, &running);
return G_SOURCE_REMOVE;
}
static int timerfunc(CURLM *multi, long timeout_ms, void *clientp)
{
guint *id = clientp;
if(id)
g_source_remove(*id);
/* -1 means we should just delete our timer. */
if(timeout_ms == -1) {
g_free(id);
id = NULL;
}
else {
if(!id)
id = g_new(guint, 1);
*id = g_timeout_add(timeout_ms, timeout_cb, id);
}
current_timer = id;
return 0;
}
curl_multi_setopt(multi, CURLMOPT_TIMERFUNCTION, timerfunc);
.fi
.SH AVAILABILITY
Added in 7.16.0
.SH RETURN VALUE
Returns CURLM_OK if the option is supported, and CURLM_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR CURLMOPT_TIMERDATA (3),
.BR CURLMOPT_SOCKETFUNCTION (3)
man/man3/CURLOPT_MAX_SEND_SPEED_LARGE.3 0000644 00000005130 14751172371 0012550 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_MAX_SEND_SPEED_LARGE 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_MAX_SEND_SPEED_LARGE \- rate limit data upload speed
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_MAX_SEND_SPEED_LARGE,
curl_off_t maxspeed);
.SH DESCRIPTION
Pass a curl_off_t as parameter with the \fImaxspeed\fP. If an upload exceeds
this speed (counted in bytes per second) the transfer pauses to keep the
average speed less than or equal to the parameter value. Defaults to unlimited
speed.
This is not an exact science. libcurl attempts to keep the average speed below
the given threshold over a period time.
If you set \fImaxspeed\fP to a value lower than
\fICURLOPT_UPLOAD_BUFFERSIZE(3)\fP, libcurl might "shoot over" the limit on
its first send and still send off a full buffer.
This option does not affect transfer speeds done with FILE:// URLs.
.SH DEFAULT
0, disabled
.SH PROTOCOLS
All except file://
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
CURLcode ret;
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/");
/* cap the upload speed to 1000 bytes/sec */
curl_easy_setopt(curl, CURLOPT_MAX_SEND_SPEED_LARGE, (curl_off_t)1000);
/* (set some upload options as well!) */
ret = curl_easy_perform(curl);
}
.fi
.SH AVAILABILITY
Added in 7.15.5
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR CURLOPT_LOW_SPEED_LIMIT (3),
.BR CURLOPT_MAX_RECV_SPEED_LARGE (3)
man/man3/CURLOPT_MIMEPOST.3 0000644 00000005350 14751172371 0010721 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_MIMEPOST 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_MIMEPOST \- send data from mime structure
.SH SYNOPSIS
.nf
#include <curl/curl.h>
curl_mime *mime;
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_MIMEPOST, mime);
.SH DESCRIPTION
Pass a mime handle previously obtained from \fIcurl_mime_init(3)\fP.
This setting is supported by the HTTP protocol to post forms and by the
SMTP and IMAP protocols to provide the email data to send/upload.
This option is the preferred way of posting an HTTP form, replacing and
extending the \fICURLOPT_HTTPPOST(3)\fP option.
When setting \fICURLOPT_MIMEPOST(3)\fP to NULL, libcurl resets the request
type for HTTP to the default to disable the POST. Typically that would mean it
is reset to GET. Instead you should set a desired request method explicitly.
.SH PROTOCOLS
HTTP, SMTP, IMAP.
.SH EXAMPLE
.nf
curl_mime *multipart = curl_mime_init(handle);
curl_mimepart *part = curl_mime_addpart(multipart);
curl_mime_name(part, "name");
curl_mime_data(part, "daniel", CURL_ZERO_TERMINATED);
part = curl_mime_addpart(multipart);
curl_mime_name(part, "project");
curl_mime_data(part, "curl", CURL_ZERO_TERMINATED);
part = curl_mime_addpart(multipart);
curl_mime_name(part, "logotype-image");
curl_mime_filedata(part, "curl.png");
/* Set the form info */
curl_easy_setopt(handle, CURLOPT_MIMEPOST, multipart);
curl_easy_perform(handle); /* post away! */
curl_mime_free(multipart); /* free the post data */
.fi
.SH AVAILABILITY
Added in 7.56.0
.SH RETURN VALUE
This returns CURLE_OK.
.SH "SEE ALSO"
.BR curl_mime_init (3),
.BR CURLOPT_HTTPPOST (3),
.BR CURLOPT_POSTFIELDS (3),
.BR CURLOPT_PUT (3)
man/man3/CURLINFO_HTTPAUTH_AVAIL.3 0000644 00000005145 14751172371 0011734 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLINFO_HTTPAUTH_AVAIL 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLINFO_HTTPAUTH_AVAIL \- get available HTTP authentication methods
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_getinfo(CURL *handle, CURLINFO_HTTPAUTH_AVAIL, long *authp);
.fi
.SH DESCRIPTION
Pass a pointer to a long to receive a bitmask indicating the authentication
method(s) available according to the previous response. The meaning of the
bits is explained in the \fICURLOPT_HTTPAUTH(3)\fP option for
\fIcurl_easy_setopt(3)\fP.
.SH PROTOCOLS
HTTP(S)
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
res = curl_easy_perform(curl);
if(!res) {
/* extract the available authentication types */
long auth;
res = curl_easy_getinfo(curl, CURLINFO_HTTPAUTH_AVAIL, &auth);
if(!res) {
if(!auth)
printf("No auth available, perhaps no 401?\\n");
else {
printf("%s%s%s%s\\n",
auth & CURLAUTH_BASIC ? "Basic ":"",
auth & CURLAUTH_DIGEST ? "Digest ":"",
auth & CURLAUTH_NEGOTIATE ? "Negotiate ":"",
auth % CURLAUTH_NTLM ? "NTLM ":"");
}
}
}
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Added RFC 2617 in 7.10.8
Added RFC 7616 in 7.57.0
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR curl_easy_getinfo (3),
.BR curl_easy_setopt (3),
.BR CURLINFO_PROXYAUTH_AVAIL (3),
.BR CURLOPT_HTTPAUTH (3)
man/man3/libcurl-env.3 0000644 00000010574 14751172371 0010502 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.TH libcurl-env 3 "September 07, 2023" "libcurl 8.4.0" "libcurl"
.SH NAME
libcurl-env \- environment variables libcurl understands
.SH DESCRIPTION
libcurl reads and understands a set of environment variables that if set
controls and changes behaviors. This is the full list of variables to set and
description of what they do. Also note that curl, the command line tool,
supports a set of additional environment variables independently of this.
.RS
.IP "[scheme]_proxy"
When libcurl is given a URL to use in a transfer, it first extracts the scheme
part from the URL and checks if there is a given proxy set for that in its
corresponding environment variable. A URL like https://example.com makes
libcurl use the \fBhttp_proxy\fP variable, while a URL like ftp://example.com
uses the \fBftp_proxy\fP variable.
These proxy variables are also checked for in their uppercase versions, except
the \fBhttp_proxy\fP one which is only used lowercase. Note also that some
systems actually have a case insensitive handling of environment variables and
then of course \fBHTTP_PROXY\fP still works.
An exception exists for the WebSocket \fBws\fP and \fBwss\fP URL schemes,
where libcurl first checks \fBws_proxy\fP or \fBwss_proxy\fP but if they are
not set, it will fall back and try the http and https versions instead if set.
.IP ALL_PROXY
This is a setting to set proxy for all URLs, independently of what scheme is
being used. Note that the scheme specific variables overrides this one if set.
.IP CURL_SSL_BACKEND
When libcurl is built to support multiple SSL backends, it selects a specific
backend at first use. If no selection is done by the program using libcurl,
this variable's selection is used. Setting a name that is not a built-in
alternative makes libcurl stay with the default.
SSL backend names (case-insensitive): BearSSL, GnuTLS, mbedTLS,
nss, OpenSSL, rustls, Schannel, Secure-Transport, wolfSSL
.IP HOME
When the netrc feature is used (\fICURLOPT_NETRC(3)\fP), this variable is
checked as the primary way to find the "current" home directory in which
the .netrc file is likely to exist.
.IP USERPROFILE
When the netrc feature is used (\fICURLOPT_NETRC(3)\fP), this variable is
checked as the secondary way to find the "current" home directory (on Windows
only) in which the .netrc file is likely to exist.
.IP LOGNAME
User name to use when invoking the \fIntlm-wb\fP tool, if \fINTLMUSER\fP was
not set.
.IP NO_PROXY
This has the same functionality as the \fICURLOPT_NOPROXY(3)\fP option: it
gives libcurl a comma-separated list of host name patterns for which libcurl
should not use a proxy.
.IP NTLMUSER
User name to use when invoking the \fIntlm-wb\fP tool.
.IP SSLKEYLOGFILE
When set and libcurl runs with a SSL backend that supports this feature,
libcurl saves SSL secrets into the given file name. Using those SSL secrets,
other tools (such as Wireshark) can decrypt the SSL communication and
analyze/view the traffic.
These secrets and this file might be sensitive. Users are advised to take
precautions so that they are not stolen or otherwise inadvertently revealed.
.IP USER
User name to use when invoking the \fIntlm-wb\fP tool, if \fINTLMUSER\fP and
\fILOGNAME\fP were not set.
.RE
.SH "Debug Variables"
Debug variables are intended for internal use and are documented in
\fIlibcurl-env-dbg(3)\fP.
.SH "SEE ALSO"
.BR libcurl-env-dbg (3)
man/man3/CURLMOPT_PIPELINING.3 0000644 00000005277 14751172371 0011247 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLMOPT_PIPELINING 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLMOPT_PIPELINING \- enable HTTP pipelining and multiplexing
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLMcode curl_multi_setopt(CURLM *handle, CURLMOPT_PIPELINING, long bitmask);
.fi
.SH DESCRIPTION
Pass in the correct value in the \fBbitmask\fP parameter to instruct libcurl
to enable multiplexing for this multi handle.
With multiplexing enabled, libcurl attempts to do multiple transfers over the
same connection when doing parallel transfers to the same hosts.
.IP CURLPIPE_NOTHING (0)
Default, which means doing no attempts at multiplexing.
.IP CURLPIPE_HTTP1 (1)
This bit is deprecated and has no effect since version 7.62.0.
.IP CURLPIPE_MULTIPLEX (2)
If this bit is set, libcurl tries to multiplex the new transfer over an
existing connection if possible. This requires HTTP/2 or HTTP/3.
.SH DEFAULT
Since 7.62.0, \fBCURLPIPE_MULTIPLEX\fP is enabled by default.
Before that, default was \fBCURLPIPE_NOTHING\fP.
.SH PROTOCOLS
HTTP(S)
.SH EXAMPLE
.nf
CURLM *m = curl_multi_init();
/* try HTTP/2 multiplexing */
curl_multi_setopt(m, CURLMOPT_PIPELINING, CURLPIPE_MULTIPLEX);
.fi
.SH AVAILABILITY
Added in 7.16.0. Multiplex support bit added in 7.43.0. HTTP/1 Pipelining
support was disabled in 7.62.0.
.SH RETURN VALUE
Returns CURLM_OK if the option is supported, and CURLM_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR CURLMOPT_CHUNK_LENGTH_PENALTY_SIZE (3),
.BR CURLMOPT_CONTENT_LENGTH_PENALTY_SIZE (3),
.BR CURLMOPT_MAX_HOST_CONNECTIONS (3),
.BR CURLMOPT_MAX_PIPELINE_LENGTH (3),
.BR CURLMOPT_MAXCONNECTS (3),
.BR CURLMOPT_PIPELINING_SITE_BL (3)
man/man3/CURLOPT_PROXYUSERNAME.3 0000644 00000004732 14751172371 0011550 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_PROXYUSERNAME 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_PROXYUSERNAME \- user name to use for proxy authentication
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_PROXYUSERNAME,
char *username);
.SH DESCRIPTION
Pass a char * as parameter, which should be pointing to the null-terminated
user name to use for the transfer.
\fICURLOPT_PROXYUSERNAME(3)\fP sets the user name to be used in protocol
authentication with the proxy.
To specify the proxy password use the \fICURLOPT_PROXYPASSWORD(3)\fP.
The application does not have to keep the string around after setting this
option.
.SH DEFAULT
blank
.SH PROTOCOLS
Most
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/foo.bin");
curl_easy_setopt(curl, CURLOPT_PROXY, "http://localhost:8080");
curl_easy_setopt(curl, CURLOPT_PROXYUSERNAME, "mrsmith");
curl_easy_setopt(curl, CURLOPT_PROXYPASSWORD, "qwerty");
ret = curl_easy_perform(curl);
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Added in 7.19.1
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, CURLE_UNKNOWN_OPTION if not, or
CURLE_OUT_OF_MEMORY if there was insufficient heap space.
.SH "SEE ALSO"
.BR CURLOPT_PROXYPASSWORD (3),
.BR CURLOPT_USERNAME (3),
.BR CURLOPT_HTTPAUTH (3),
.BR CURLOPT_PROXYAUTH (3)
man/man3/curl_multi_info_read.3 0000644 00000007364 14751172371 0012450 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.TH curl_multi_info_read 3 "September 26, 2023" "libcurl 8.4.0" "libcurl"
.SH NAME
curl_multi_info_read - read multi stack information
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLMsg *curl_multi_info_read(CURLM *multi_handle, int *msgs_in_queue);
.fi
.SH DESCRIPTION
Ask the multi handle if there are any messages from the individual
transfers. Messages may include information such as an error code from the
transfer or just the fact that a transfer is completed. More details on these
should be written down as well.
Repeated calls to this function returns a new struct each time, until a NULL
is returned as a signal that there is no more to get at this point. The
integer pointed to with \fImsgs_in_queue\fP contains the number of remaining
messages after this function was called.
When you fetch a message using this function, it is removed from the internal
queue so calling this function again does not return the same message
again. It instead returns new messages at each new invoke until the queue is
emptied.
\fBWARNING:\fP The data the returned pointer points to does not survive
calling \fIcurl_multi_cleanup(3)\fP, \fIcurl_multi_remove_handle(3)\fP or
\fIcurl_easy_cleanup(3)\fP.
The \fICURLMsg\fP struct is simple and only contains basic information. If
more involved information is wanted, the particular "easy handle" is present
in that struct and can be used in subsequent regular
\fIcurl_easy_getinfo(3)\fP calls (or similar):
.nf
struct CURLMsg {
CURLMSG msg; /* what this message means */
CURL *easy_handle; /* the handle it concerns */
union {
void *whatever; /* message-specific data */
CURLcode result; /* return code for transfer */
} data;
};
.fi
When \fBmsg\fP is \fICURLMSG_DONE\fP, the message identifies a transfer that
is done, and then \fBresult\fP contains the return code for the easy handle
that just completed.
At this point, there are no other \fBmsg\fP types defined.
.SH EXAMPLE
.nf
struct CURLMsg *m;
/* call curl_multi_perform or curl_multi_socket_action first, then loop
through and check if there are any transfers that have completed */
do {
int msgq = 0;
m = curl_multi_info_read(multi_handle, &msgq);
if(m && (m->msg == CURLMSG_DONE)) {
CURL *e = m->easy_handle;
transfers--;
curl_multi_remove_handle(multi_handle, e);
curl_easy_cleanup(e);
}
} while(m);
.fi
.SH AVAILABILITY
Added in 7.9.6
.SH RETURN VALUE
A pointer to a filled-in struct, or NULL if it failed or ran out of
structs. It also writes the number of messages left in the queue (after this
read) in the integer the second argument points to.
.SH "SEE ALSO"
.BR curl_multi_cleanup (3),
.BR curl_multi_init (3),
.BR curl_multi_perform (3)
man/man3/curl_share_init.3 0000644 00000004322 14751172371 0011424 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.TH curl_share_init 3 "September 26, 2023" "libcurl 8.4.0" "libcurl"
.SH NAME
curl_share_init - Create a shared object
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLSH *curl_share_init();
.fi
.SH DESCRIPTION
This function returns a pointer to a \fICURLSH\fP handle to be used as input
to all the other share-functions, sometimes referred to as a share handle in
some places in the documentation. This init call MUST have a corresponding
call to \fIcurl_share_cleanup(3)\fP when all operations using the share are
complete.
This \fIshare handle\fP is what you pass to curl using the
\fICURLOPT_SHARE(3)\fP option with \fIcurl_easy_setopt(3)\fP, to make that
specific curl handle use the data in this share.
.SH EXAMPLE
.nf
CURLSHcode sh;
share = curl_share_init();
sh = curl_share_setopt(share, CURLSHOPT_SHARE, CURL_LOCK_DATA_CONNECT);
if(sh)
printf("Error: %s\\n", curl_share_strerror(sh));
.fi
.SH AVAILABILITY
Added in 7.10
.SH RETURN VALUE
If this function returns NULL, something went wrong (out of memory, etc.)
and therefore the share object was not created.
.SH "SEE ALSO"
.BR curl_share_cleanup (3),
.BR curl_share_setopt (3)
man/man3/CURLOPT_NETRC_FILE.3 0000644 00000004475 14751172371 0011145 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_NETRC_FILE 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_NETRC_FILE \- file name to read .netrc info from
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_NETRC_FILE, char *file);
.fi
.SH DESCRIPTION
Pass a char * as parameter, pointing to a null-terminated string containing
the full path name to the \fIfile\fP you want libcurl to use as .netrc
file. If this option is omitted, and \fICURLOPT_NETRC(3)\fP is set, libcurl
checks for a .netrc file in the current user's home directory.
The application does not have to keep the string around after setting this
option.
.SH DEFAULT
NULL
.SH PROTOCOLS
All
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
CURLcode ret;
curl_easy_setopt(curl, CURLOPT_URL, "ftp://example.com/");
curl_easy_setopt(curl, CURLOPT_NETRC, CURL_NETRC_OPTIONAL);
curl_easy_setopt(curl, CURLOPT_NETRC_FILE, "/tmp/magic-netrc");
ret = curl_easy_perform(curl);
}
.fi
.SH AVAILABILITY
Added in 7.10.9
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, CURLE_UNKNOWN_OPTION if not, or
CURLE_OUT_OF_MEMORY if there was insufficient heap space.
.SH "SEE ALSO"
.BR CURLOPT_NETRC (3),
.BR CURLOPT_PASSWORD (3),
.BR CURLOPT_USERNAME (3)
man/man3/CURLOPT_VERBOSE.3 0000644 00000004515 14751172371 0010573 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_VERBOSE 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_VERBOSE \- verbose mode
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_VERBOSE, long onoff);
.fi
.SH DESCRIPTION
Set the \fIonoff\fP parameter to 1 to make the library display a lot of
verbose information about its operations on this \fIhandle\fP. Useful for
libcurl and/or protocol debugging and understanding. The verbose information
is sent to stderr, or the stream set with \fICURLOPT_STDERR(3)\fP.
You hardly ever want this enabled in production use, you almost always want
this used when you debug/report problems.
To also get all the protocol data sent and received, consider using the
\fICURLOPT_DEBUGFUNCTION(3)\fP.
.SH DEFAULT
0, meaning disabled.
.SH PROTOCOLS
All
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
/* ask libcurl to show us the verbose output */
curl_easy_setopt(curl, CURLOPT_VERBOSE, 1L);
/* Perform the request */
curl_easy_perform(curl);
}
.fi
.SH AVAILABILITY
Always
.SH RETURN VALUE
Returns CURLE_OK
.SH "SEE ALSO"
.BR CURLOPT_STDERR (3),
.BR CURLOPT_DEBUGFUNCTION (3),
.BR CURLOPT_ERRORBUFFER (3),
.BR curl_global_trace (3)
man/man3/CURLOPT_UPLOAD_BUFFERSIZE.3 0000644 00000005364 14751172371 0012201 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_UPLOAD_BUFFERSIZE 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_UPLOAD_BUFFERSIZE \- upload buffer size
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_UPLOAD_BUFFERSIZE, long size);
.fi
.SH DESCRIPTION
Pass a long specifying your preferred \fIsize\fP (in bytes) for the upload
buffer in libcurl. It makes libcurl uses a larger buffer that gets passed to
the next layer in the stack to get sent off. In some setups and for some
protocols, there is a huge performance benefit of having a larger upload
buffer.
This is just treated as a request, not an order. You cannot be guaranteed to
actually get the given size.
The upload buffer size is by default 64 kilobytes. The maximum buffer size
allowed to be set is 2 megabytes. The minimum buffer size allowed to be set is
16 kilobytes.
The upload buffer is allocated on-demand - so if the handle is not used for
upload, this buffer is not allocated at all.
DO NOT set this option on a handle that is currently used for an active
transfer as that may lead to unintended consequences.
.SH DEFAULT
65536 bytes
.SH PROTOCOLS
All
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "sftp://example.com/foo.bin");
/* ask libcurl to allocate a larger upload buffer */
curl_easy_setopt(curl, CURLOPT_UPLOAD_BUFFERSIZE, 120000L);
ret = curl_easy_perform(curl);
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Added in 7.62.0.
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR CURLOPT_BUFFERSIZE (3),
.BR CURLOPT_READFUNCTION (3),
.BR CURLOPT_TCP_NODELAY (3)
man/man3/CURLOPT_MIME_OPTIONS.3 0000644 00000006303 14751172371 0011425 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_MIME_OPTIONS 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_MIME_OPTIONS \- set MIME option flags
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_MIME_OPTIONS, long options);
.fi
.SH DESCRIPTION
Pass a long that holds a bitmask of CURLMIMEOPT_* defines. Each bit is a
Boolean flag used while encoding a MIME tree or multipart form data.
Available bits are:
.IP CURLMIMEOPT_FORMESCAPE
Tells libcurl to escape multipart form field and file names using the
backslash-escaping algorithm rather than percent-encoding (HTTP only).
Backslash-escaping consists in preceding backslashes and double quotes with
a backslash. Percent encoding maps all occurrences of double quote,
carriage return and line feed to %22, %0D and %0A respectively.
Before version 7.81.0, percent-encoding was never applied.
HTTP browsers used to do backslash-escaping in the past but have over time
transitioned to use percent-encoding. This option allows one to address
server-side applications that have not yet have been converted.
As an example, consider field or file name \fIstrange\\name"kind\fP.
When the containing multipart form is sent, this is normally transmitted as
\fIstrange\\name%22kind\fP. When this option is set, it is sent as
\fIstrange\\\\name\\"kind\fP.
.SH DEFAULT
0, meaning disabled.
.SH PROTOCOLS
HTTP, IMAP, SMTP
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
curl_mime *form = NULL;
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
curl_easy_setopt(curl, CURLOPT_MIME_OPTIONS, CURLMIMEOPT_FORMESCAPE);
form = curl_mime_init(curl);
if(form) {
curl_mimepart *part = curl_mime_addpart(form);
if(part) {
curl_mime_filedata(part, "strange\\\\file\\\\name");
curl_mime_name(part, "strange\\"field\\"name");
curl_easy_setopt(curl, CURLOPT_MIMEPOST, form);
/* Perform the request */
curl_easy_perform(curl);
}
}
curl_easy_cleanup(curl);
curl_mime_free(mime);
}
.fi
.SH AVAILABILITY
Option added in 7.81.0.
.SH RETURN VALUE
Returns CURLE_OK
.SH "SEE ALSO"
.BR CURLOPT_HTTPPOST (3),
.BR CURLOPT_MIMEPOST (3)
man/man3/CURLOPT_SSL_FALSESTART.3 0000644 00000004426 14751172371 0011660 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_SSL_FALSESTART 3 "August 22, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_SSL_FALSESTART \- TLS false start
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_SSL_FALSESTART, long enable);
.fi
.SH DESCRIPTION
Pass a long as parameter set to 1L to enable or 0 to disable.
This option determines whether libcurl should use false start during the TLS
handshake. False start is a mode where a TLS client starts sending application
data before verifying the server's Finished message, thus saving a round trip
when performing a full handshake.
.SH DEFAULT
0
.SH PROTOCOLS
All TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc.
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
curl_easy_setopt(curl, CURLOPT_SSL_FALSESTART, 1L);
curl_easy_perform(curl);
}
.fi
.SH AVAILABILITY
Added in 7.42.0. This option is currently only supported by the Secure
Transport (on iOS 7.0 or later, or OS X 10.9 or later) TLS backend.
.SH RETURN VALUE
Returns CURLE_OK if false start is supported by the SSL backend, otherwise
returns CURLE_NOT_BUILT_IN.
.SH SEE ALSO
.BR CURLOPT_TCP_FASTOPEN "(3), "
man/man3/CURLINFO_SSL_VERIFYRESULT.3 0000644 00000004466 14751172371 0012250 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLINFO_SSL_VERIFYRESULT 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLINFO_SSL_VERIFYRESULT \- get the result of the certificate verification
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_getinfo(CURL *handle, CURLINFO_SSL_VERIFYRESULT,
long *result);
.fi
.SH DESCRIPTION
Pass a pointer to a long to receive the result of the server SSL certificate
verification that was requested (using the \fICURLOPT_SSL_VERIFYPEER(3)\fP
option).
0 is a positive result. Non-zero is an error.
.SH PROTOCOLS
All using TLS
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
CURLcode res;
long verifyresult;
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
res = curl_easy_perform(curl);
curl_easy_getinfo(curl, CURLINFO_SSL_VERIFYRESULT, &verifyresult);
printf("The peer verification said %s\\n", verifyresult?
"BAAAD":"fine");
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Added in 7.5. Only set by the OpenSSL/libressl/boringssl and GnuTLS backends.
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR curl_easy_getinfo (3),
.BR curl_easy_setopt (3),
.BR CURLINFO_PROXY_SSL_VERIFYRESULT (3)
man/man3/CURLOPT_CHUNK_BGN_FUNCTION.3 0000644 00000010573 14751172371 0012332 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_CHUNK_BGN_FUNCTION 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_CHUNK_BGN_FUNCTION \- callback before a transfer with FTP wildcard match
.SH SYNOPSIS
.nf
#include <curl/curl.h>
struct curl_fileinfo {
char *filename;
curlfiletype filetype;
time_t time; /* always zero! */
unsigned int perm;
int uid;
int gid;
curl_off_t size;
long int hardlinks;
struct {
/* If some of these fields is not NULL, it is a pointer to b_data. */
char *time;
char *perm;
char *user;
char *group;
char *target; /* pointer to the target filename of a symlink */
} strings;
unsigned int flags;
/* used internally */
char *b_data;
size_t b_size;
size_t b_used;
};
long chunk_bgn_callback(const void *transfer_info, void *ptr,
int remains);
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_CHUNK_BGN_FUNCTION,
chunk_bgn_callback);
.SH DESCRIPTION
Pass a pointer to your callback function, which should match the prototype
shown above.
This callback function gets called by libcurl before a part of the stream is
going to be transferred (if the transfer supports chunks).
The \fItransfer_info\fP pointer points to a \fBcurl_fileinfo\fP struct with
details about the file that is about to get transferred.
This callback makes sense only when using the \fICURLOPT_WILDCARDMATCH(3)\fP
option for now.
The target of transfer_info parameter is a "feature depended" structure. For
the FTP wildcard download, the target is \fBcurl_fileinfo\fP structure (see
\fIcurl/curl.h\fP). The parameter \fIptr\fP is a pointer given by
\fICURLOPT_CHUNK_DATA(3)\fP. The parameter remains contains number of chunks
remaining per the transfer. If the feature is not available, the parameter has
zero value.
Return \fICURL_CHUNK_BGN_FUNC_OK\fP if everything is fine,
\fICURL_CHUNK_BGN_FUNC_SKIP\fP if you want to skip the concrete chunk or
\fICURL_CHUNK_BGN_FUNC_FAIL\fP to tell libcurl to stop if some error occurred.
.SH DEFAULT
NULL
.SH PROTOCOLS
FTP
.SH EXAMPLE
.nf
static long file_is_coming(struct curl_fileinfo *finfo,
struct callback_data *data,
int remains)
{
printf("%3d %40s %10luB ", remains, finfo->filename,
(unsigned long)finfo->size);
switch(finfo->filetype) {
case CURLFILETYPE_DIRECTORY:
printf(" DIR\\n");
break;
case CURLFILETYPE_FILE:
printf("FILE ");
break;
default:
printf("OTHER\\n");
break;
}
if(finfo->filetype == CURLFILETYPE_FILE) {
/* do not transfer files >= 50B */
if(finfo->size > 50) {
printf("SKIPPED\\n");
return CURL_CHUNK_BGN_FUNC_SKIP;
}
data->output = fopen(finfo->filename, "wb");
if(!data->output) {
return CURL_CHUNK_BGN_FUNC_FAIL;
}
}
return CURL_CHUNK_BGN_FUNC_OK;
}
int main()
{
/* data for callback */
struct callback_data callback_info;
/* callback is called before download of concrete file started */
curl_easy_setopt(curl, CURLOPT_CHUNK_BGN_FUNCTION, file_is_coming);
curl_easy_setopt(curl, CURLOPT_CHUNK_DATA, &callback_info);
}
.fi
.SH AVAILABILITY
This was added in 7.21.0
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR CURLOPT_CHUNK_END_FUNCTION (3),
.BR CURLOPT_WILDCARDMATCH (3)
man/man3/curl_formadd.3 0000644 00000031035 14751172371 0010714 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.TH curl_formadd 3 "September 26, 2023" "libcurl 8.4.0" "libcurl"
.SH NAME
curl_formadd - add a section to a multipart form POST
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLFORMcode curl_formadd(struct curl_httppost **firstitem,
struct curl_httppost **lastitem, ...);
.fi
.SH DESCRIPTION
\fBThis function is deprecated.\fP Use \fIcurl_mime_init(3)\fP instead.
curl_formadd() is used to append sections when building a multipart form
post. Append one section at a time until you have added all the sections you
want included and then you pass the \fIfirstitem\fP pointer as parameter to
\fICURLOPT_HTTPPOST(3)\fP. \fIlastitem\fP is set after each
\fIcurl_formadd(3)\fP call and on repeated invokes it should be left as set to
allow repeated invokes to find the end of the list faster.
After the \fIlastitem\fP pointer follow the real arguments.
The pointers \fIfirstitem\fP and \fIlastitem\fP should both be pointing to
NULL in the first call to this function. All list-data is allocated by the
function itself. You must call \fIcurl_formfree(3)\fP on the \fIfirstitem\fP
after the form post has been done to free the resources.
Using POST with HTTP 1.1 implies the use of a "Expect: 100-continue" header.
You can disable this header with \fICURLOPT_HTTPHEADER(3)\fP as usual.
First, there are some basics you need to understand about multipart form
posts. Each part consists of at least a NAME and a CONTENTS part. If the part
is made for file upload, there are also a stored CONTENT-TYPE and a FILENAME.
Below, we discuss what options you use to set these properties in the parts
you want to add to your post.
The options listed first are for making normal parts. The options from
\fICURLFORM_FILE\fP through \fICURLFORM_BUFFERLENGTH\fP are for file upload
parts.
.SH OPTIONS
.IP CURLFORM_COPYNAME
followed by a string which provides the \fIname\fP of this part. libcurl
copies the string so your application does not need to keep it around after
this function call. If the name is not null-terminated, you must set its
length with \fBCURLFORM_NAMELENGTH\fP. The \fIname\fP is not allowed to
contain zero-valued bytes. The copied data is freed by \fIcurl_formfree(3)\fP.
.IP CURLFORM_PTRNAME
followed by a string which provides the \fIname\fP of this part. libcurl uses
the pointer and refer to the data in your application, so you must make sure
it remains until curl no longer needs it. If the name is not null-terminated,
you must set its length with \fBCURLFORM_NAMELENGTH\fP. The \fIname\fP is not
allowed to contain zero-valued bytes.
.IP CURLFORM_COPYCONTENTS
followed by a pointer to the contents of this part, the actual data to send
away. libcurl copies the provided data, so your application does not need to
keep it around after this function call. If the data is not null terminated,
or if you would like it to contain zero bytes, you must set the length of the
name with \fBCURLFORM_CONTENTSLENGTH\fP. The copied data is freed by
\fIcurl_formfree(3)\fP.
.IP CURLFORM_PTRCONTENTS
followed by a pointer to the contents of this part, the actual data to send
away. libcurl uses the pointer and refer to the data in your application, so
you must make sure it remains until curl no longer needs it. If the data is
not null-terminated, or if you would like it to contain zero bytes, you must
set its length with \fBCURLFORM_CONTENTSLENGTH\fP.
.IP CURLFORM_CONTENTLEN
followed by a curl_off_t value giving the length of the contents. Note that
for \fICURLFORM_STREAM\fP contents, this option is mandatory.
If you pass a 0 (zero) for this option, libcurl calls strlen() on the contents
to figure out the size. If you really want to send a zero byte content then
you must make sure strlen() on the data pointer returns zero.
(Option added in 7.46.0)
.IP CURLFORM_CONTENTSLENGTH
(This option is deprecated. Use \fICURLFORM_CONTENTLEN\fP instead!)
followed by a long giving the length of the contents. Note that for
\fICURLFORM_STREAM\fP contents, this option is mandatory.
If you pass a 0 (zero) for this option, libcurl calls strlen() on the contents
to figure out the size. If you really want to send a zero byte content then
you must make sure strlen() on the data pointer returns zero.
.IP CURLFORM_FILECONTENT
followed by a filename, causes that file to be read and its contents used
as data in this part. This part does \fInot\fP automatically become a file
upload part simply because its data was read from a file.
The specified file needs to kept around until the associated transfer is done.
.IP CURLFORM_FILE
followed by a filename, makes this part a file upload part. It sets the
\fIfilename\fP field to the basename of the provided filename, it reads the
contents of the file and passes them as data and sets the content-type if the
given file match one of the internally known file extensions. For
\fBCURLFORM_FILE\fP the user may send one or more files in one part by
providing multiple \fBCURLFORM_FILE\fP arguments each followed by the filename
(and each \fICURLFORM_FILE\fP is allowed to have a
\fICURLFORM_CONTENTTYPE\fP).
The given upload file has to exist in its full in the file system already when
the upload starts, as libcurl needs to read the correct file size beforehand.
The specified file needs to kept around until the associated transfer is done.
.IP CURLFORM_CONTENTTYPE
is used in combination with \fICURLFORM_FILE\fP. Followed by a pointer to a
string which provides the content-type for this part, possibly instead of an
internally chosen one.
.IP CURLFORM_FILENAME
is used in combination with \fICURLFORM_FILE\fP. Followed by a pointer to a
string, it tells libcurl to use the given string as the \fIfilename\fP in the
file upload part instead of the actual file name.
.IP CURLFORM_BUFFER
is used for custom file upload parts without use of \fICURLFORM_FILE\fP. It
tells libcurl that the file contents are already present in a buffer. The
parameter is a string which provides the \fIfilename\fP field in the content
header.
.IP CURLFORM_BUFFERPTR
is used in combination with \fICURLFORM_BUFFER\fP. The parameter is a pointer
to the buffer to be uploaded. This buffer must not be freed until after
\fIcurl_easy_cleanup(3)\fP is called. You must also use
\fICURLFORM_BUFFERLENGTH\fP to set the number of bytes in the buffer.
.IP CURLFORM_BUFFERLENGTH
is used in combination with \fICURLFORM_BUFFER\fP. The parameter is a
long which gives the length of the buffer.
.IP CURLFORM_STREAM
Tells libcurl to use the \fICURLOPT_READFUNCTION(3)\fP callback to get
data. The parameter you pass to \fICURLFORM_STREAM\fP is the pointer passed on
to the read callback's fourth argument. If you want the part to look like a
file upload one, set the \fICURLFORM_FILENAME\fP parameter as well. Note that
when using \fICURLFORM_STREAM\fP, \fICURLFORM_CONTENTSLENGTH\fP must also be
set with the total expected length of the part unless the formpost is sent
chunked encoded. (Option added in libcurl 7.18.2)
.IP CURLFORM_ARRAY
Another possibility to send options to curl_formadd() is the
\fBCURLFORM_ARRAY\fP option, that passes a struct curl_forms array pointer as
its value. Each curl_forms structure element has a \fICURLformoption\fP and a
char pointer. The final element in the array must be a CURLFORM_END. All
available options can be used in an array, except the CURLFORM_ARRAY option
itself. The last argument in such an array must always be \fBCURLFORM_END\fP.
.IP CURLFORM_CONTENTHEADER
specifies extra headers for the form POST section. This takes a curl_slist
prepared in the usual way using \fBcurl_slist_append\fP and appends the list
of headers to those libcurl automatically generates. The list must exist while
the POST occurs, if you free it before the post completes you may experience
problems.
When you have passed the \fIstruct curl_httppost\fP pointer to
\fIcurl_easy_setopt(3)\fP (using the \fICURLOPT_HTTPPOST(3)\fP option), you
must not free the list until after you have called \fIcurl_easy_cleanup(3)\fP
for the curl handle.
See example below.
.SH EXAMPLE
.nf
struct curl_httppost *post = NULL;
struct curl_httppost *last = NULL;
char namebuffer[] = "name buffer";
long namelength = strlen(namebuffer);
char buffer[] = "test buffer";
char htmlbuffer[] = "<HTML>test buffer</HTML>";
long htmlbufferlength = strlen(htmlbuffer);
struct curl_forms forms[3];
char file1[] = "my-face.jpg";
char file2[] = "your-face.jpg";
/* add null character into htmlbuffer, to demonstrate that
transfers of buffers containing null characters actually work
*/
htmlbuffer[8] = '\\0';
/* Add simple name/content section */
curl_formadd(&post, &last, CURLFORM_COPYNAME, "name",
CURLFORM_COPYCONTENTS, "content", CURLFORM_END);
/* Add simple name/content/contenttype section */
curl_formadd(&post, &last, CURLFORM_COPYNAME, "htmlcode",
CURLFORM_COPYCONTENTS, "<HTML></HTML>",
CURLFORM_CONTENTTYPE, "text/html", CURLFORM_END);
/* Add name/ptrcontent section */
curl_formadd(&post, &last, CURLFORM_COPYNAME, "name_for_ptrcontent",
CURLFORM_PTRCONTENTS, buffer, CURLFORM_END);
/* Add ptrname/ptrcontent section */
curl_formadd(&post, &last, CURLFORM_PTRNAME, namebuffer,
CURLFORM_PTRCONTENTS, buffer, CURLFORM_NAMELENGTH,
namelength, CURLFORM_END);
/* Add name/ptrcontent/contenttype section */
curl_formadd(&post, &last, CURLFORM_COPYNAME, "html_code_with_hole",
CURLFORM_PTRCONTENTS, htmlbuffer,
CURLFORM_CONTENTSLENGTH, htmlbufferlength,
CURLFORM_CONTENTTYPE, "text/html", CURLFORM_END);
/* Add simple file section */
curl_formadd(&post, &last, CURLFORM_COPYNAME, "picture",
CURLFORM_FILE, "my-face.jpg", CURLFORM_END);
/* Add file/contenttype section */
curl_formadd(&post, &last, CURLFORM_COPYNAME, "picture",
CURLFORM_FILE, "my-face.jpg",
CURLFORM_CONTENTTYPE, "image/jpeg", CURLFORM_END);
/* Add two file section */
curl_formadd(&post, &last, CURLFORM_COPYNAME, "pictures",
CURLFORM_FILE, "my-face.jpg",
CURLFORM_FILE, "your-face.jpg", CURLFORM_END);
/* Add two file section using CURLFORM_ARRAY */
forms[0].option = CURLFORM_FILE;
forms[0].value = file1;
forms[1].option = CURLFORM_FILE;
forms[1].value = file2;
forms[2].option = CURLFORM_END;
/* Add a buffer to upload */
curl_formadd(&post, &last,
CURLFORM_COPYNAME, "name",
CURLFORM_BUFFER, "data",
CURLFORM_BUFFERPTR, record,
CURLFORM_BUFFERLENGTH, record_length,
CURLFORM_END);
/* no option needed for the end marker */
curl_formadd(&post, &last, CURLFORM_COPYNAME, "pictures",
CURLFORM_ARRAY, forms, CURLFORM_END);
/* Add the content of a file as a normal post text value */
curl_formadd(&post, &last, CURLFORM_COPYNAME, "filecontent",
CURLFORM_FILECONTENT, ".bashrc", CURLFORM_END);
/* Set the form info */
curl_easy_setopt(curl, CURLOPT_HTTPPOST, post);
.SH AVAILABILITY
Deprecated in 7.56.0. Before this release, field names were allowed to
contain zero-valued bytes. The pseudo-filename "-" to read stdin is
discouraged although still supported, but data is not read before being
actually sent: the effective data size can then not be automatically
determined, resulting in a chunked encoding transfer. Backslashes and
double quotes in field and file names are now escaped before transmission.
.SH RETURN VALUE
0 means everything was OK, non-zero means an error occurred corresponding
to a CURL_FORMADD_* constant defined in
.I <curl/curl.h>
.SH "SEE ALSO"
.BR curl_easy_setopt (3),
.BR curl_formfree (3),
.BR curl_mime_init (3)
man/man3/curl_ws_send.3 0000644 00000007370 14751172371 0010747 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH curl_ws_send 3 "September 26, 2023" "libcurl 8.4.0" "libcurl"
.SH NAME
curl_ws_send - send WebSocket data
.SH SYNOPSIS
.nf
#include <curl/easy.h>
CURLcode curl_ws_send(CURL *curl, const void *buffer, size_t buflen,
size_t *sent, curl_off_t fragsize,
unsigned int flags);
.fi
.SH DESCRIPTION
This function call is EXPERIMENTAL.
Send the specific message fragment over an established WebSocket
connection. The \fIbuffer\fP holds the data to send and it is \fIbuflen\fP
number of payload bytes in that memory area.
\fIsent\fP is returned as the number of payload bytes actually sent.
To send a (huge) fragment using multiple calls with partial content per
invoke, set the \fICURLWS_OFFSET\fP bit and the \fIfragsize\fP argument as the
total expected size for the first part, then set the \fICURLWS_OFFSET\fP with
a zero \fIfragsize\fP for the following parts.
If not sending a partial fragment or if this is raw mode, \fIfragsize\fP
should be set to zero.
If \fBCURLWS_RAW_MODE\fP is enabled in \fICURLOPT_WS_OPTIONS(3)\fP, the
\fBflags\fP argument should be set to 0.
To send a message consisting of multiple frames, set the \fICURLWS_CONT\fP bit
in all frames except the final one.
.SH FLAGS
.IP CURLWS_TEXT
The buffer contains text data. Note that this makes a difference to WebSocket
but libcurl itself does not make any verification of the content or
precautions that you actually send valid UTF-8 content.
.IP CURLWS_BINARY
This is binary data.
.IP CURLWS_CONT
This is not the final fragment of the message, which implies that there is
another fragment coming as part of the same message where this bit is not set.
.IP CURLWS_CLOSE
Close this transfer.
.IP CURLWS_PING
This is a ping.
.IP CURLWS_PONG
This is a pong.
.IP CURLWS_OFFSET
The provided data is only a partial fragment and there is more coming in a
following call to \fIcurl_ws_send()\fP. When sending only a piece of the
fragment like this, the \fIfragsize\fP must be provided with the total
expected fragment size in the first call and it needs to be zero in subsequent
calls.
.SH EXAMPLE
.nf
int ping(CURL *curl, const char *send_payload)
{
size_t sent;
CURLcode result =
curl_ws_send(curl, send_payload, strlen(send_payload), &sent, 0,
CURLWS_PING);
return (int)result;
}
.fi
.SH AVAILABILITY
Added in 7.86.0.
.SH RETURN VALUE
\fICURLE_OK\fP (zero) means that the data was sent properly, non-zero means an
error occurred as \fI<curl/curl.h>\fP defines. See the \fIlibcurl-errors(3)\fP
man page for the full list with descriptions.
.SH "SEE ALSO"
.BR curl_easy_setopt (3),
.BR curl_easy_perform (3),
.BR curl_easy_getinfo (3),
.BR curl_ws_recv (3),
.BR libcurl-ws (3)
man/man3/CURLOPT_SSLCERT.3 0000644 00000006731 14751172371 0010607 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_SSLCERT 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_SSLCERT \- SSL client certificate
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_SSLCERT, char *cert);
.fi
.SH DESCRIPTION
Pass a pointer to a null-terminated string as parameter. The string should be
the file name of your client certificate. The default format is "P12" on
Secure Transport and "PEM" on other engines, and can be changed with
\fICURLOPT_SSLCERTTYPE(3)\fP.
With Secure Transport, this can also be the nickname of the certificate you
wish to authenticate with as it is named in the security database. If you want
to use a file from the current directory, please precede it with "./" prefix,
in order to avoid confusion with a nickname.
(Schannel only) Client certificates can be specified by a path expression to a
certificate store. (You can import \fIPFX\fP to a store first). You can use
"<store location>\\<store name>\\<thumbprint>" to refer to a certificate in
the system certificates store, for example,
\fB"CurrentUser\\MY\\934a7ac6f8a5d579285a74fa"\fP. The thumbprint is usually a
SHA-1 hex string which you can see in certificate details. Following store
locations are supported: \fBCurrentUser\fP, \fBLocalMachine\fP,
\fBCurrentService\fP, \fBServices\fP, \fBCurrentUserGroupPolicy\fP,
\fBLocalMachineGroupPolicy\fP, \fBLocalMachineEnterprise\fP. Schannel also
support P12 certificate file, with the string "P12" specified with
\fICURLOPT_SSLCERTTYPE(3)\fP.
When using a client certificate, you most likely also need to provide a
private key with \fICURLOPT_SSLKEY(3)\fP.
The application does not have to keep the string around after setting this
option.
.SH DEFAULT
NULL
.SH PROTOCOLS
All TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc.
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/");
curl_easy_setopt(curl, CURLOPT_SSLCERT, "client.pem");
curl_easy_setopt(curl, CURLOPT_SSLKEY, "key.pem");
curl_easy_setopt(curl, CURLOPT_KEYPASSWD, "s3cret");
ret = curl_easy_perform(curl);
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
If built TLS enabled.
.SH RETURN VALUE
Returns CURLE_OK if TLS enabled, CURLE_UNKNOWN_OPTION if not, or
CURLE_OUT_OF_MEMORY if there was insufficient heap space.
.SH "SEE ALSO"
.BR CURLOPT_SSLCERTTYPE (3),
.BR CURLOPT_SSLKEY (3),
.BR CURLOPT_KEYPASSWD (3)
man/man3/CURLOPT_HAPROXYPROTOCOL.3 0000644 00000004271 14751172371 0012001 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_HAPROXYPROTOCOL 3 "April 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_HAPROXYPROTOCOL \- send HAProxy PROXY protocol v1 header
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_HAPROXYPROTOCOL,
long haproxy_protocol);
.fi
.SH DESCRIPTION
A long parameter set to 1 tells the library to send an HAProxy PROXY
protocol v1 header at beginning of the connection. The default action is not to
send this header.
This option is primarily useful when sending test requests to a service that
expects this header.
Most applications do not need this option.
.SH DEFAULT
0, do not send any HAProxy PROXY protocol header
.SH PROTOCOLS
HTTP
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
CURLcode ret;
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/");
curl_easy_setopt(curl, CURLOPT_HAPROXYPROTOCOL, 1L);
ret = curl_easy_perform(curl);
}
.fi
.SH AVAILABILITY
Along with HTTP. Added in 7.60.0.
.SH RETURN VALUE
Returns CURLE_OK if HTTP is enabled, and CURLE_UNKNOWN_OPTION if not.
.SH SEE ALSO
.BR CURLOPT_PROXY "(3), "
man/man3/CURLOPT_RESOLVER_START_FUNCTION.3 0000644 00000005662 14751172371 0013215 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_RESOLVER_START_FUNCTION 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_RESOLVER_START_FUNCTION \- callback called before a new name resolve is started
.SH SYNOPSIS
.nf
#include <curl/curl.h>
int resolver_start_cb(void *resolver_state, void *reserved, void *userdata);
CURLcode curl_easy_setopt(CURL *handle,
CURLOPT_RESOLVER_START_FUNCTION,
resolver_start_cb);
.SH DESCRIPTION
Pass a pointer to your callback function, which should match the prototype
shown above.
This callback function gets called by libcurl every time before a new resolve
request is started.
\fIresolver_state\fP points to a backend-specific resolver state. Currently
only the ares resolver backend has a resolver state. It can be used to set up
any desired option on the ares channel before it's used, for example setting up
socket callback options.
\fIreserved\fP is reserved.
\fIuserdata\fP is the user pointer set with the
\fICURLOPT_RESOLVER_START_DATA(3)\fP option.
The callback must return 0 on success. Returning a non-zero value causes the
resolve to fail.
.SH DEFAULT
NULL (No callback)
.SH PROTOCOLS
All
.SH EXAMPLE
.nf
static int resolver_start_cb(void *resolver_state, void *reserved,
void *userdata)
{
(void)reserved;
printf("Received resolver_state=%p userdata=%p\\n",
resolver_state, userdata);
return 0;
}
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_RESOLVER_START_FUNCTION, resolver_start_cb);
curl_easy_setopt(curl, CURLOPT_RESOLVER_START_DATA, curl);
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
curl_easy_perform(curl);
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Added in 7.59.0
.SH RETURN VALUE
Returns CURLE_OK
.SH "SEE ALSO"
.BR CURLOPT_PREREQFUNCTION (3),
.BR CURLOPT_RESOLVER_START_DATA (3)
man/man3/curl_easy_getinfo.3 0000644 00000027055 14751172371 0011763 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH curl_easy_getinfo 3 "September 27, 2023" "libcurl 8.4.0" "libcurl"
.SH NAME
curl_easy_getinfo - extract information from a curl handle
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_getinfo(CURL *curl, CURLINFO info, ... );
.fi
.SH DESCRIPTION
Get the \fIinfo\fP kept in the \fIcurl\fP handle. The third argument
\fBMUST\fP be pointing to the specific type of the used option which is
documented in each man page of the \fIinfo\fP option. The data is stored
accordingly and can be relied upon only if this function returns CURLE_OK. Use
this function after a performed transfer if you want to get transfer related
data.
You should not free the memory returned by this function unless it is
explicitly mentioned below.
.SH AVAILABLE INFORMATION
The following information can be extracted:
.IP CURLINFO_EFFECTIVE_METHOD
Last used HTTP method.
See \fICURLINFO_EFFECTIVE_METHOD(3)\fP
.IP CURLINFO_EFFECTIVE_URL
Last used URL.
See \fICURLINFO_EFFECTIVE_URL(3)\fP
.IP CURLINFO_RESPONSE_CODE
Last received response code.
See \fICURLINFO_RESPONSE_CODE(3)\fP
.IP CURLINFO_REFERER
Referrer header.
See \fICURLINFO_REFERER(3)\fP
.IP CURLINFO_HTTP_CONNECTCODE
Last proxy CONNECT response code.
See \fICURLINFO_HTTP_CONNECTCODE(3)\fP
.IP CURLINFO_HTTP_VERSION
The http version used in the connection.
See \fICURLINFO_HTTP_VERSION(3)\fP
.IP CURLINFO_FILETIME
Remote time of the retrieved document. See \fICURLINFO_FILETIME(3)\fP
.IP CURLINFO_FILETIME_T
Remote time of the retrieved document. See \fICURLINFO_FILETIME_T(3)\fP
.IP CURLINFO_TOTAL_TIME
Total time of previous transfer.
See \fICURLINFO_TOTAL_TIME(3)\fP
.IP CURLINFO_TOTAL_TIME_T
Total time of previous transfer.
See \fICURLINFO_TOTAL_TIME_T(3)\fP
.IP CURLINFO_NAMELOOKUP_TIME
Time from start until name resolving completed.
See \fICURLINFO_NAMELOOKUP_TIME(3)\fP
.IP CURLINFO_NAMELOOKUP_TIME_T
Time from start until name resolving completed.
See \fICURLINFO_NAMELOOKUP_TIME_T(3)\fP
.IP CURLINFO_CONNECT_TIME
Time from start until remote host or proxy completed.
See \fICURLINFO_CONNECT_TIME(3)\fP
.IP CURLINFO_CONNECT_TIME_T
Time from start until remote host or proxy completed.
See \fICURLINFO_CONNECT_TIME_T(3)\fP
.IP CURLINFO_APPCONNECT_TIME
Time from start until SSL/SSH handshake completed.
See \fICURLINFO_APPCONNECT_TIME(3)\fP
.IP CURLINFO_APPCONNECT_TIME_T
Time from start until SSL/SSH handshake completed.
See \fICURLINFO_APPCONNECT_TIME_T(3)\fP
.IP CURLINFO_PRETRANSFER_TIME
Time from start until just before the transfer begins.
See \fICURLINFO_PRETRANSFER_TIME(3)\fP
.IP CURLINFO_PRETRANSFER_TIME_T
Time from start until just before the transfer begins.
See \fICURLINFO_PRETRANSFER_TIME_T(3)\fP
.IP CURLINFO_STARTTRANSFER_TIME
Time from start until just when the first byte is received.
See \fICURLINFO_STARTTRANSFER_TIME(3)\fP
.IP CURLINFO_STARTTRANSFER_TIME_T
Time from start until just when the first byte is received.
See \fICURLINFO_STARTTRANSFER_TIME_T(3)\fP
.IP CURLINFO_REDIRECT_TIME
Time taken for all redirect steps before the final transfer.
See \fICURLINFO_REDIRECT_TIME(3)\fP
.IP CURLINFO_REDIRECT_TIME_T
Time taken for all redirect steps before the final transfer.
See \fICURLINFO_REDIRECT_TIME_T(3)\fP
.IP CURLINFO_REDIRECT_COUNT
Total number of redirects that were followed.
See \fICURLINFO_REDIRECT_COUNT(3)\fP
.IP CURLINFO_REDIRECT_URL
URL a redirect would take you to, had you enabled redirects.
See \fICURLINFO_REDIRECT_URL(3)\fP
.IP CURLINFO_SIZE_UPLOAD
(Deprecated) Number of bytes uploaded.
See \fICURLINFO_SIZE_UPLOAD(3)\fP
.IP CURLINFO_SIZE_UPLOAD_T
Number of bytes uploaded.
See \fICURLINFO_SIZE_UPLOAD_T(3)\fP
.IP CURLINFO_SIZE_DOWNLOAD
(Deprecated) Number of bytes downloaded.
See \fICURLINFO_SIZE_DOWNLOAD(3)\fP
.IP CURLINFO_SIZE_DOWNLOAD_T
Number of bytes downloaded.
See \fICURLINFO_SIZE_DOWNLOAD_T(3)\fP
.IP CURLINFO_SPEED_DOWNLOAD
(Deprecated) Average download speed.
See \fICURLINFO_SPEED_DOWNLOAD(3)\fP
.IP CURLINFO_SPEED_DOWNLOAD_T
Average download speed.
See \fICURLINFO_SPEED_DOWNLOAD_T(3)\fP
.IP CURLINFO_SPEED_UPLOAD
(Deprecated) Average upload speed.
See \fICURLINFO_SPEED_UPLOAD(3)\fP
.IP CURLINFO_SPEED_UPLOAD_T
Average upload speed.
See \fICURLINFO_SPEED_UPLOAD_T(3)\fP
.IP CURLINFO_HEADER_SIZE
Number of bytes of all headers received.
See \fICURLINFO_HEADER_SIZE(3)\fP
.IP CURLINFO_REQUEST_SIZE
Number of bytes sent in the issued HTTP requests.
See \fICURLINFO_REQUEST_SIZE(3)\fP
.IP CURLINFO_SSL_VERIFYRESULT
Certificate verification result.
See \fICURLINFO_SSL_VERIFYRESULT(3)\fP
.IP CURLINFO_PROXY_ERROR
Detailed proxy error.
See \fICURLINFO_PROXY_ERROR(3)\fP
.IP CURLINFO_PROXY_SSL_VERIFYRESULT
Proxy certificate verification result.
See \fICURLINFO_PROXY_SSL_VERIFYRESULT(3)\fP
.IP CURLINFO_SSL_ENGINES
A list of OpenSSL crypto engines.
See \fICURLINFO_SSL_ENGINES(3)\fP
.IP CURLINFO_CONTENT_LENGTH_DOWNLOAD
(Deprecated) Content length from the Content-Length header.
See \fICURLINFO_CONTENT_LENGTH_DOWNLOAD(3)\fP
.IP CURLINFO_CONTENT_LENGTH_DOWNLOAD_T
Content length from the Content-Length header.
See \fICURLINFO_CONTENT_LENGTH_DOWNLOAD_T(3)\fP
.IP CURLINFO_CONTENT_LENGTH_UPLOAD
(Deprecated) Upload size. See \fICURLINFO_CONTENT_LENGTH_UPLOAD(3)\fP
.IP CURLINFO_CONTENT_LENGTH_UPLOAD_T
Upload size. See \fICURLINFO_CONTENT_LENGTH_UPLOAD_T(3)\fP
.IP CURLINFO_CONTENT_TYPE
Content type from the Content-Type header.
See \fICURLINFO_CONTENT_TYPE(3)\fP
.IP CURLINFO_RETRY_AFTER
The value from the Retry-After header.
See \fICURLINFO_RETRY_AFTER(3)\fP
.IP CURLINFO_PRIVATE
User's private data pointer.
See \fICURLINFO_PRIVATE(3)\fP
.IP CURLINFO_HTTPAUTH_AVAIL
Available HTTP authentication methods.
See \fICURLINFO_HTTPAUTH_AVAIL(3)\fP
.IP CURLINFO_PROXYAUTH_AVAIL
Available HTTP proxy authentication methods.
See \fICURLINFO_PROXYAUTH_AVAIL(3)\fP
.IP CURLINFO_OS_ERRNO
The errno from the last failure to connect.
See \fICURLINFO_OS_ERRNO(3)\fP
.IP CURLINFO_NUM_CONNECTS
Number of new successful connections used for previous transfer.
See \fICURLINFO_NUM_CONNECTS(3)\fP
.IP CURLINFO_PRIMARY_IP
IP address of the last connection.
See \fICURLINFO_PRIMARY_IP(3)\fP
.IP CURLINFO_PRIMARY_PORT
Port of the last connection.
See \fICURLINFO_PRIMARY_PORT(3)\fP
.IP CURLINFO_LOCAL_IP
Local-end IP address of last connection.
See \fICURLINFO_LOCAL_IP(3)\fP
.IP CURLINFO_LOCAL_PORT
Local-end port of last connection.
See \fICURLINFO_LOCAL_PORT(3)\fP
.IP CURLINFO_COOKIELIST
List of all known cookies.
See \fICURLINFO_COOKIELIST(3)\fP
.IP CURLINFO_LASTSOCKET
(Deprecated) Last socket used.
See \fICURLINFO_LASTSOCKET(3)\fP
.IP CURLINFO_ACTIVESOCKET
The session's active socket.
See \fICURLINFO_ACTIVESOCKET(3)\fP
.IP CURLINFO_FTP_ENTRY_PATH
The entry path after logging in to an FTP server.
See \fICURLINFO_FTP_ENTRY_PATH(3)\fP
.IP CURLINFO_CAPATH
Get the default value for \fICURLOPT_CAPATH(3)\fP.
See \fICURLINFO_CAPATH(3)\fP
.IP CURLINFO_CAINFO
Get the default value for \fICURLOPT_CAINFO(3)\fP.
See \fICURLINFO_CAINFO(3)\fP
.IP CURLINFO_CERTINFO
Certificate chain.
See \fICURLINFO_CERTINFO(3)\fP
.IP CURLINFO_TLS_SSL_PTR
TLS session info that can be used for further processing.
See \fICURLINFO_TLS_SSL_PTR(3)\fP
.IP CURLINFO_TLS_SESSION
TLS session info that can be used for further processing. See
\fICURLINFO_TLS_SESSION(3)\fP. Deprecated option, use
\fICURLINFO_TLS_SSL_PTR(3)\fP instead!
.IP CURLINFO_CONDITION_UNMET
Whether or not a time conditional was met or 304 HTTP response.
See \fICURLINFO_CONDITION_UNMET(3)\fP
.IP CURLINFO_RTSP_SESSION_ID
RTSP session ID.
See \fICURLINFO_RTSP_SESSION_ID(3)\fP
.IP CURLINFO_RTSP_CLIENT_CSEQ
The RTSP client CSeq that is expected next.
See \fICURLINFO_RTSP_CLIENT_CSEQ(3)\fP
.IP CURLINFO_RTSP_SERVER_CSEQ
The RTSP server CSeq that is expected next.
See \fICURLINFO_RTSP_SERVER_CSEQ(3)\fP
.IP CURLINFO_RTSP_CSEQ_RECV
RTSP CSeq last received.
See \fICURLINFO_RTSP_CSEQ_RECV(3)\fP
.IP CURLINFO_PROTOCOL
(Deprecated) The protocol used for the connection. (Added in 7.52.0)
See \fICURLINFO_PROTOCOL(3)\fP
.IP CURLINFO_SCHEME
The scheme used for the connection. (Added in 7.52.0)
See \fICURLINFO_SCHEME(3)\fP
.IP CURLINFO_CONN_ID
The ID of the last connection used by the transfer. (Added in 8.2.0)
See \fICURLINFO_CONN_ID(3)\fP
.IP CURLINFO_XFER_ID
The ID of the transfer. (Added in 8.2.0)
See \fICURLINFO_XFER_ID(3)\fP
.SH TIMES
An overview of the six time values available from \fIcurl_easy_getinfo(3)\fP
.nf
curl_easy_perform()
|
|--NAMELOOKUP
|--|--CONNECT
|--|--|--APPCONNECT
|--|--|--|--PRETRANSFER
|--|--|--|--|--STARTTRANSFER
|--|--|--|--|--|--TOTAL
|--|--|--|--|--|--REDIRECT
.fi
.IP NAMELOOKUP
\fICURLINFO_NAMELOOKUP_TIME(3)\fP and \fICURLINFO_NAMELOOKUP_TIME_T(3)\fP.
The time it took from the start until the name resolving was completed.
.IP CONNECT
\fICURLINFO_CONNECT_TIME(3)\fP and \fICURLINFO_CONNECT_TIME_T(3)\fP. The time
it took from the start until the connect to the remote host (or proxy) was
completed.
.IP APPCONNECT
\fICURLINFO_APPCONNECT_TIME(3)\fP and \fICURLINFO_APPCONNECT_TIME_T(3)\fP.
The time it took from the start until the SSL connect/handshake with the
remote host was completed. (Added in 7.19.0) The latter is the integer version
(measuring microseconds). (Added in 7.60.0)
.IP PRETRANSFER
\fICURLINFO_PRETRANSFER_TIME(3)\fP and \fICURLINFO_PRETRANSFER_TIME_T(3)\fP.
The time it took from the start until the file transfer is just about to
begin. This includes all pre-transfer commands and negotiations that are
specific to the particular protocol(s) involved.
.IP STARTTRANSFER
\fICURLINFO_STARTTRANSFER_TIME(3)\fP and
\fICURLINFO_STARTTRANSFER_TIME_T(3)\fP. The time it took from the start until
the first byte is received by libcurl.
.IP TOTAL
\fICURLINFO_TOTAL_TIME(3)\fP and \fICURLINFO_TOTAL_TIME_T(3)\fP. Total time
of the previous request.
.IP REDIRECT
\fICURLINFO_REDIRECT_TIME(3)\fP and \fICURLINFO_REDIRECT_TIME_T(3)\fP. The
time it took for all redirection steps include name lookup, connect,
pretransfer and transfer before final transaction was started. So, this is
zero if no redirection took place.
.SH EXAMPLE
.nf
curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://www.example.com/");
res = curl_easy_perform(curl);
if(CURLE_OK == res) {
char *ct;
/* ask for the content-type */
res = curl_easy_getinfo(curl, CURLINFO_CONTENT_TYPE, &ct);
if((CURLE_OK == res) && ct)
printf("We received Content-Type: %s\\n", ct);
}
/* always cleanup */
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Added in 7.4.1
.SH RETURN VALUE
If the operation was successful, CURLE_OK is returned. Otherwise an
appropriate error code is returned.
.SH "SEE ALSO"
.BR curl_easy_setopt (3)
man/man3/curl_mime_encoder.3 0000644 00000007263 14751172371 0011734 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.TH curl_mime_encoder 3 "September 27, 2023" "libcurl 8.4.0" "libcurl"
.SH NAME
curl_mime_encoder - set a mime part's encoder and content transfer encoding
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_mime_encoder(curl_mimepart *part, const char *encoding);
.fi
.SH DESCRIPTION
curl_mime_encoder() requests a mime part's content to be encoded before being
transmitted.
\fIpart\fP is the part's handle to assign an encoder.
\fIencoding\fP is a pointer to a null-terminated encoding scheme. It may be
set to NULL to disable an encoder previously attached to the part. The encoding
scheme storage may safely be reused after this function returns.
Setting a part's encoder multiple times is valid: only the value set by the
last call is retained.
Upon multipart rendering, the part's content is encoded according to the
pertaining scheme and a corresponding \fI"Content-Transfer-Encoding"\fP header
is added to the part.
Supported encoding schemes are:
.br
"\fIbinary\fP": the data is left unchanged, the header is added.
.br
"\fI8bit\fP": header added, no data change.
.br
"\fI7bit\fP": the data is unchanged, but is each byte is checked
to be a 7-bit value; if not, a read error occurs.
.br
"\fIbase64\fP": Data is converted to base64 encoding, then split in
CRLF-terminated lines of at most 76 characters.
.br
"\fIquoted-printable\fP": data is encoded in quoted printable lines of
at most 76 characters. Since the resulting size of the final data cannot be
determined prior to reading the original data, it is left as unknown, causing
chunked transfer in HTTP. For the same reason, this encoder may not be used
with IMAP. This encoder targets text data that is mostly ASCII and should
not be used with other types of data.
If the original data is already encoded in such a scheme, a custom
\fIContent-Transfer-Encoding\fP header should be added with
\fIcurl_mime_headers(3)\fP instead of setting a part encoder.
Encoding should not be applied to multiparts, thus the use of this function on
a part with content set with \fIcurl_mime_subparts(3)\fP is strongly
discouraged.
.SH EXAMPLE
.nf
curl_mime *mime;
curl_mimepart *part;
/* create a mime handle */
mime = curl_mime_init(easy);
/* add a part */
part = curl_mime_addpart(mime);
/* send a file */
curl_mime_filedata(part, "image.png");
/* encode file data in base64 for transfer */
curl_mime_encoder(part, "base64");
.fi
.SH AVAILABILITY
As long as at least one of HTTP, SMTP or IMAP is enabled. Added in 7.56.0.
.SH RETURN VALUE
CURLE_OK or a CURL error code upon failure.
.SH "SEE ALSO"
.BR curl_mime_addpart (3),
.BR curl_mime_headers (3),
.BR curl_mime_subparts (3)
man/man3/CURLOPT_PROXY_CAINFO_BLOB.3 0000644 00000006022 14751172371 0012217 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_PROXY_CAINFO_BLOB 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_PROXY_CAINFO_BLOB \- proxy Certificate Authority (CA) bundle in PEM format
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_PROXY_CAINFO_BLOB,
struct curl_blob *stblob);
.fi
.SH DESCRIPTION
This option is for connecting to an HTTPS proxy, not an HTTPS server.
Pass a pointer to a curl_blob structure, which contains information (pointer
and size) about a memory block with binary data of PEM encoded content holding
one or more certificates to verify the HTTPS proxy with.
If \fICURLOPT_PROXY_SSL_VERIFYPEER(3)\fP is zero and you avoid verifying the
server's certificate, \fICURLOPT_PROXY_CAINFO_BLOB(3)\fP is not needed.
This option overrides \fICURLOPT_PROXY_CAINFO(3)\fP.
.SH DEFAULT
NULL
.SH PROTOCOLS
Used with HTTPS proxy
.SH EXAMPLE
.nf
char *strpem; /* strpem must point to a PEM string */
CURL *curl = curl_easy_init();
if(curl) {
struct curl_blob blob;
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/");
/* using an HTTPS proxy */
curl_easy_setopt(curl, CURLOPT_PROXY, "https://localhost:443");
blob.data = strpem;
blob.len = strlen(strpem);
blob.flags = CURL_BLOB_COPY;
curl_easy_setopt(curl, CURLOPT_PROXY_CAINFO_BLOB, &blob);
ret = curl_easy_perform(curl);
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Added in 7.77.0.
This option is supported by the rustls (since 7.82.0), OpenSSL, Secure
Transport and Schannel backends.
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, CURLE_UNKNOWN_OPTION if not, or
CURLE_OUT_OF_MEMORY if there was insufficient heap space.
.SH "SEE ALSO"
.BR CURLOPT_CAINFO (3),
.BR CURLOPT_CAINFO_BLOB (3),
.BR CURLOPT_CAPATH (3),
.BR CURLOPT_PROXY_CAINFO (3),
.BR CURLOPT_PROXY_CAPATH (3),
.BR CURLOPT_PROXY_SSL_VERIFYHOST (3),
.BR CURLOPT_PROXY_SSL_VERIFYPEER (3),
.BR CURLOPT_SSL_VERIFYHOST (3),
.BR CURLOPT_SSL_VERIFYPEER (3)
man/man3/CURLOPT_TCP_KEEPALIVE.3 0000644 00000004626 14751172371 0011504 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_TCP_KEEPALIVE 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_TCP_KEEPALIVE \- TCP keep-alive probing
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_TCP_KEEPALIVE, long probe);
.fi
.SH DESCRIPTION
Pass a long. If set to 1, TCP keepalive probes are used. The delay and
frequency of these probes can be controlled by the
\fICURLOPT_TCP_KEEPIDLE(3)\fP and \fICURLOPT_TCP_KEEPINTVL(3)\fP options,
provided the operating system supports them. Set to 0 (default behavior) to
disable keepalive probes
.SH DEFAULT
0
.SH PROTOCOLS
All
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
/* enable TCP keep-alive for this transfer */
curl_easy_setopt(curl, CURLOPT_TCP_KEEPALIVE, 1L);
/* keep-alive idle time to 120 seconds */
curl_easy_setopt(curl, CURLOPT_TCP_KEEPIDLE, 120L);
/* interval time between keep-alive probes: 60 seconds */
curl_easy_setopt(curl, CURLOPT_TCP_KEEPINTVL, 60L);
curl_easy_perform(curl);
}
.fi
.SH AVAILABILITY
Added in 7.25.0
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR CURLOPT_TCP_KEEPIDLE (3),
.BR CURLOPT_TCP_KEEPINTVL (3),
.BR CURLOPT_LOW_SPEED_LIMIT (3),
.BR CURLOPT_MAX_RECV_SPEED_LARGE (3)
man/man3/CURLOPT_REDIR_PROTOCOLS_STR.3 0000644 00000006576 14751172371 0012540 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_REDIR_PROTOCOLS_STR 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_REDIR_PROTOCOLS_STR \- protocols allowed to redirect to
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_REDIR_PROTOCOLS_STR,
char *spec);
.fi
.SH DESCRIPTION
Pass a pointer to a string that holds a comma-separated list of case
insensitive protocol names (URL schemes). That list limits what protocols
libcurl may use in a transfer that it follows to in a redirect when
\fICURLOPT_FOLLOWLOCATION(3)\fP is enabled. This option allows applications to
limit specific transfers to only be allowed to use a subset of protocols in
redirections.
Protocols denied by \fICURLOPT_PROTOCOLS_STR(3)\fP are not overridden by this
option.
By default libcurl allows HTTP, HTTPS, FTP and FTPS on redirects (since
7.65.2).
These are the available protocols:
DICT, FILE, FTP, FTPS, GOPHER, GOPHERS, HTTP, HTTPS, IMAP, IMAPS, LDAP, LDAPS,
MQTT, POP3, POP3S, RTMP, RTMPE, RTMPS, RTMPT, RTMPTE, RTMPTS, RTSP, SCP, SFTP,
SMB, SMBS, SMTP, SMTPS, TELNET, TFTP, WS, WSS
You can set "ALL" as a short-cut to enable all protocols. Note that by setting
all, you may enable protocols that were not supported the day you write this
but are introduced in a future libcurl version.
If trying to set a non-existing protocol or if no matching protocol at all is
set, it returns error.
.SH DEFAULT
HTTP, HTTPS, FTP and FTPS (Added in 7.65.2).
Older versions defaulted to all protocols except FILE, SCP and since 7.40.0
SMB and SMBS.
.SH PROTOCOLS
All
.SH EXAMPLE
.nf
curl = curl_easy_init();
if(curl) {
/* pass in the URL from an external source */
curl_easy_setopt(curl, CURLOPT_URL, argv[1]);
/* only allow redirects to HTTP and HTTPS URLs */
curl_easy_setopt(curl, CURLOPT_REDIR_PROTOCOLS_STR, "http,https");
/* Perform the request */
curl_easy_perform(curl);
}
.fi
.SH AVAILABILITY
Added in 7.85.0.
.SH RETURN VALUE
Returns CURLE_UNKNOWN_OPTION if the option is not implemented,
CURLE_UNSUPPORTED_PROTOCOL if a listed protocol is not supported or disabled,
CURLE_BAD_FUNCTION_ARGUMENT if no protocol is listed else CURLE_OK.
.SH "SEE ALSO"
.BR CURLOPT_PROTOCOLS_STR (3),
.BR CURLINFO_SCHEME (3),
.BR CURLOPT_DEFAULT_PROTOCOL (3),
.BR CURLOPT_PROTOCOLS (3),
.BR CURLOPT_REDIR_PROTOCOLS (3)
man/man3/CURLOPT_POSTREDIR.3 0000644 00000006207 14751172371 0011041 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_POSTREDIR 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_POSTREDIR \- how to act on an HTTP POST redirect
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_POSTREDIR,
long bitmask);
.SH DESCRIPTION
Pass a bitmask to control how libcurl acts on redirects after POSTs that get a
301, 302 or 303 response back. A parameter with bit 0 set (value
\fBCURL_REDIR_POST_301\fP) tells the library to respect RFC 7231 (section
6.4.2 to 6.4.4) and not convert POST requests into GET requests when following
a 301 redirection. Setting bit 1 (value \fBCURL_REDIR_POST_302\fP) makes
libcurl maintain the request method after a 302 redirect whilst setting bit 2
(value \fBCURL_REDIR_POST_303\fP) makes libcurl maintain the request method
after a 303 redirect. The value \fBCURL_REDIR_POST_ALL\fP is a convenience
define that sets all three bits.
The non-RFC behavior is ubiquitous in web browsers, so the library does the
conversion by default to maintain consistency. However, a server may require a
POST to remain a POST after such a redirection. This option is meaningful only
when setting \fICURLOPT_FOLLOWLOCATION(3)\fP.
.SH DEFAULT
0
.SH PROTOCOLS
HTTP(S)
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
/* a silly POST example */
curl_easy_setopt(curl, CURLOPT_POSTFIELDS, "data=true");
/* example.com is redirected, so we tell libcurl to send POST on 301, 302 and
303 HTTP response codes */
curl_easy_setopt(curl, CURLOPT_POSTREDIR, CURL_REDIR_POST_ALL);
curl_easy_perform(curl);
}
.fi
.SH AVAILABILITY
Added in 7.17.1. This option was known as CURLOPT_POST301 up to 7.19.0 as it
only supported the 301 then. CURL_REDIR_POST_303 was added in 7.26.0.
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR CURLINFO_EFFECTIVE_METHOD (3),
.BR CURLINFO_REDIRECT_COUNT (3),
.BR CURLOPT_FOLLOWLOCATION (3),
.BR CURLOPT_MAXREDIRS (3),
.BR CURLOPT_POSTFIELDS (3)
man/man3/curl_easy_init.3 0000644 00000005665 14751172371 0011276 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.TH curl_easy_init 3 "September 26, 2023" "libcurl 8.4.0" "libcurl"
.SH NAME
curl_easy_init - Start a libcurl easy session
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURL *curl_easy_init();
.fi
.SH DESCRIPTION
This function allocates and returns a CURL easy handle. Such a handle is used
as input to other functions in the easy interface. This call must have a
corresponding call to \fIcurl_easy_cleanup(3)\fP when the operation is
complete.
The easy handle is used to hold and control a single network transfer. It is
encouraged to reuse easy handles for repeated transfers.
An alternative way to get a new easy handle is to duplicate an already
existing one with \fIcurl_easy_duphandle(3)\fP, which has the upside that it
gets all the options that were set in the source handle set in the new copy as
well.
If you did not already call \fIcurl_global_init(3)\fP before calling this
function, \fIcurl_easy_init(3)\fP does it automatically. This may be lethal in
multi-threaded cases, if \fIcurl_global_init(3)\fP is not thread-safe in your
system, and it may then result in resource problems because there is no
corresponding cleanup.
You are strongly advised to not allow this automatic behavior, by calling
\fIcurl_global_init(3)\fP yourself properly. See the description in
\fBlibcurl\fP(3) of global environment requirements for details of how to use
this function.
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
CURLcode res;
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
res = curl_easy_perform(curl);
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Always
.SH RETURN VALUE
If this function returns NULL, something went wrong and you cannot use the
other curl functions.
.SH "SEE ALSO"
.BR curl_easy_cleanup (3),
.BR curl_easy_duphandle (3),
.BR curl_easy_perform (3),
.BR curl_easy_reset (3),
.BR curl_global_init (3),
.BR curl_multi_init (3)
man/man3/CURLOPT_PREQUOTE.3 0000644 00000004733 14751172371 0010734 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_PREQUOTE 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_PREQUOTE \- commands to run before an FTP transfer
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_PREQUOTE,
struct curl_slist *cmds);
.fi
.SH DESCRIPTION
Pass a pointer to a linked list of FTP commands to pass to the server after
the transfer type is set. The linked list should be a fully valid list of
struct curl_slist structs properly filled in as described for
\fICURLOPT_QUOTE(3)\fP. Disable this operation again by setting a NULL to this
option.
These commands are not performed when a directory listing is performed, only
for file transfers.
While \fICURLOPT_QUOTE(3)\fP and \fICURLOPT_POSTQUOTE(3)\fP work for SFTP,
this option does not.
.SH DEFAULT
NULL
.SH PROTOCOLS
FTP
.SH EXAMPLE
.nf
struct curl_slist *cmdlist = NULL;
cmdlist = curl_slist_append(cmdlist, "SYST");
curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "ftp://example.com/foo.bin");
/* pass in the FTP commands to run */
curl_easy_setopt(curl, CURLOPT_PREQUOTE, cmdlist);
ret = curl_easy_perform(curl);
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Along with the protocol support
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR CURLOPT_POSTQUOTE (3),
.BR CURLOPT_QUOTE (3)
man/man3/CURLOPT_CONNECT_ONLY.3 0000644 00000006064 14751172371 0011421 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_CONNECT_ONLY 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_CONNECT_ONLY \- stop when connected to target server
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_CONNECT_ONLY, long only);
.fi
.SH DESCRIPTION
Pass a long. If the parameter equals 1, it tells the library to perform all
the required proxy authentication and connection setup, but no data transfer,
and then return.
The option can be used to simply test a connection to a server, but is more
useful when used with the \fICURLINFO_ACTIVESOCKET(3)\fP option to
\fIcurl_easy_getinfo(3)\fP as the library can set up the connection and then
the application can obtain the most recently used socket for special data
transfers.
Since 7.86.0, this option can be set to '2' and if HTTP or WebSocket are used,
libcurl performs the request and reads all response headers before handing
over control to the application.
Transfers marked connect only do not reuse any existing connections and
connections marked connect only are not allowed to get reused.
If the connect only transfer is done using the multi interface, the particular
easy handle must remain added to the multi handle for as long as the
application wants to use it. Once it has been removed with
\fIcurl_multi_remove_handle(3)\fP, \fIcurl_easy_send(3)\fP and
\fIcurl_easy_recv(3)\fP do not function.
.SH DEFAULT
0
.SH PROTOCOLS
HTTP, SMTP, POP3 and IMAP. For WS and WSS starting in 7.86.0.
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
CURLcode ret;
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/");
curl_easy_setopt(curl, CURLOPT_CONNECT_ONLY, 1L);
ret = curl_easy_perform(curl);
if(ret == CURLE_OK) {
/* only connected! */
}
}
.fi
.SH AVAILABILITY
Added in 7.15.2
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR curl_easy_recv (3),
.BR curl_easy_send (3),
.BR CURLOPT_HTTPPROXYTUNNEL (3),
.BR CURLOPT_VERBOSE (3)
man/man3/CURLOPT_SSH_COMPRESSION.3 0000644 00000004166 14751172371 0012006 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_SSH_COMPRESSION 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_SSH_COMPRESSION \- enable SSH compression
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_SSH_COMPRESSION, long enable);
.fi
.SH DESCRIPTION
Pass a long as parameter set to 1L to enable or 0L to disable.
Enables built-in SSH compression. This is a request, not an order; the server
may or may not do it.
.SH DEFAULT
0, disabled
.SH PROTOCOLS
All SSH based protocols: SCP, SFTP
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "sftp://example.com");
/* enable built-in compression */
curl_easy_setopt(curl, CURLOPT_SSH_COMPRESSION, 1L);
/* Perform the request */
curl_easy_perform(curl);
}
.fi
.SH AVAILABILITY
Added in 7.56.0
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, CURLE_UNKNOWN_OPTION if not, or
CURLE_OUT_OF_MEMORY if there was insufficient heap space.
.SH "SEE ALSO"
.BR CURLOPT_ACCEPT_ENCODING (3),
.BR CURLOPT_TRANSFER_ENCODING (3)
man/man3/CURLOPT_UNIX_SOCKET_PATH.3 0000644 00000006463 14751172371 0012141 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_UNIX_SOCKET_PATH 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_UNIX_SOCKET_PATH \- Unix domain socket
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_UNIX_SOCKET_PATH, char *path);
.fi
.SH DESCRIPTION
Enables the use of Unix domain sockets as connection endpoint and sets the
path to \fIpath\fP. If \fIpath\fP is NULL, then Unix domain sockets are
disabled.
When enabled, curl connects to the Unix domain socket instead of establishing
a TCP connection to the host. Since no network connection is created, curl
does not resolve the DNS hostname in the URL.
The maximum path length on Cygwin, Linux and Solaris is 107. On other platforms
it might be even less.
Proxy and TCP options such as \fICURLOPT_TCP_NODELAY(3)\fP are not
supported. Proxy options such as \fICURLOPT_PROXY(3)\fP have no effect either
as these are TCP-oriented, and asking a proxy server to connect to a certain
Unix domain socket is not possible.
The application does not have to keep the string around after setting this
option.
.SH DEFAULT
Default is NULL, meaning that no Unix domain sockets are used.
.SH PROTOCOLS
All protocols except for FILE and FTP are supported in theory. HTTP, IMAP,
POP3 and SMTP should in particular work (including their SSL/TLS variants).
.SH EXAMPLE
Given that you have an HTTP server running listening on /tmp/httpd.sock, you
can request an HTTP resource with:
.nf
curl_easy_setopt(curl_handle, CURLOPT_UNIX_SOCKET_PATH, "/tmp/httpd.sock");
curl_easy_setopt(curl_handle, CURLOPT_URL, "http://localhost/");
.fi
If you are on Linux and somehow have a need for paths larger than 107 bytes,
you could use the proc filesystem to bypass the limitation:
.nf
int dirfd = open(long_directory_path_to_socket, O_DIRECTORY | O_RDONLY);
char path[108];
snprintf(path, sizeof(path), "/proc/self/fd/%d/httpd.sock", dirfd);
curl_easy_setopt(curl_handle, CURLOPT_UNIX_SOCKET_PATH, path);
/* Be sure to keep dirfd valid until you discard the handle */
.fi
.SH AVAILABILITY
Added in 7.40.0.
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR CURLOPT_ABSTRACT_UNIX_SOCKET (3),
.BR CURLOPT_OPENSOCKETFUNCTION (3),
.BR unix (7)
man/man3/CURLOPT_IGNORE_CONTENT_LENGTH.3 0000644 00000005165 14751172371 0012706 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_IGNORE_CONTENT_LENGTH 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_IGNORE_CONTENT_LENGTH \- ignore content length
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_IGNORE_CONTENT_LENGTH,
long ignore);
.SH DESCRIPTION
If \fIignore\fP is set to 1L, ignore the Content-Length header in the HTTP
response and ignore asking for or relying on it for FTP transfers.
This is useful for doing HTTP transfers with ancient web servers which report
incorrect content length for files over 2 gigabytes. If this option is used,
curl cannot accurately report progress, and it instead stops the download when
the server ends the connection.
It is also useful with FTP when for example the file is growing while the
transfer is in progress which otherwise unconditionally causes libcurl to
report error.
Only use this option if strictly necessary.
.SH DEFAULT
0
.SH PROTOCOLS
HTTP
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
/* we know the server is silly, ignore content-length */
curl_easy_setopt(curl, CURLOPT_IGNORE_CONTENT_LENGTH, 1L);
curl_easy_perform(curl);
}
.fi
.SH AVAILABILITY
Added in 7.14.1. Support for FTP added in 7.46.0. This option is not working
for HTTP when libcurl is built to use the hyper backend.
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR CURLOPT_HTTP_VERSION (3),
.BR CURLOPT_MAXFILESIZE_LARGE (3)
man/man3/CURLOPT_SOCKS5_AUTH.3 0000644 00000005016 14751172371 0011253 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_SOCKS5_AUTH 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_SOCKS5_AUTH \- methods for SOCKS5 proxy authentication
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_SOCKS5_AUTH, long bitmask);
.fi
.SH DESCRIPTION
Pass a long as parameter, which is set to a bitmask, to tell libcurl which
authentication method(s) are allowed for SOCKS5 proxy authentication. The only
supported flags are \fICURLAUTH_BASIC\fP, which allows username/password
authentication, \fICURLAUTH_GSSAPI\fP, which allows GSS-API authentication, and
\fICURLAUTH_NONE\fP, which allows no authentication. Set the actual user name
and password with the \fICURLOPT_PROXYUSERPWD(3)\fP option.
.SH DEFAULT
CURLAUTH_BASIC|CURLAUTH_GSSAPI
.SH PROTOCOLS
All
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
/* request to use a SOCKS5 proxy */
curl_easy_setopt(curl, CURLOPT_PROXY, "socks5://user:pass@myproxy.com");
/* enable username/password authentication only */
curl_easy_setopt(curl, CURLOPT_SOCKS5_AUTH, (long)CURLAUTH_BASIC);
/* Perform the request */
curl_easy_perform(curl);
}
.fi
.SH AVAILABILITY
Added in 7.55.0
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, CURLE_UNKNOWN_OPTION if not, or
CURLE_NOT_BUILT_IN if the bitmask contains unsupported flags.
.SH "SEE ALSO"
.BR CURLOPT_PROXY (3),
.BR CURLOPT_PROXYTYPE (3)
man/man3/CURLOPT_FTP_USE_PRET.3 0000644 00000004206 14751172371 0011462 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_FTP_USE_PRET 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_FTP_USE_PRET \- use PRET for FTP
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_FTP_USE_PRET, long enable);
.fi
.SH DESCRIPTION
Pass a long. If the value is 1, it tells curl to send a PRET command before
PASV (and EPSV). Certain FTP servers, mainly drftpd, require this non-standard
command for directory listings as well as up and downloads in PASV mode. Has
no effect when using the active FTP transfers mode.
.SH DEFAULT
0
.SH PROTOCOLS
FTP
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "ftp://example.com/old-server/file.txt");
/* a drftpd server, do it! */
curl_easy_setopt(curl, CURLOPT_FTP_USE_PRET, 1L);
ret = curl_easy_perform(curl);
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Added in 7.20.0
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR CURLOPT_FTP_USE_EPRT (3),
.BR CURLOPT_FTP_USE_EPSV (3)
man/man3/CURLOPT_CRLF.3 0000644 00000004001 14751172371 0010202 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_CRLF 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_CRLF \- CRLF conversion
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_CRLF, long conv);
.fi
.SH DESCRIPTION
Pass a long. If the value is set to 1 (one), libcurl converts Unix newlines to
CRLF newlines on transfers. Disable this option again by setting the value to
0 (zero).
This is a legacy option of questionable use.
.SH DEFAULT
0
.SH PROTOCOLS
All
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
CURLcode ret;
curl_easy_setopt(curl, CURLOPT_URL, "ftp://example.com/");
curl_easy_setopt(curl, CURLOPT_CRLF, 1L);
ret = curl_easy_perform(curl);
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
SMTP since 7.40.0, other protocols since they were introduced
.SH RETURN VALUE
Returns CURLE_OK
.SH "SEE ALSO"
.BR CURLOPT_CONV_FROM_NETWORK_FUNCTION (3),
.BR CURLOPT_CONV_TO_NETWORK_FUNCTION (3)
man/man3/libcurl-errors.3 0000644 00000045245 14751172371 0011231 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH libcurl-errors 3 "September 26, 2023" "libcurl 8.4.0" "libcurl"
.SH NAME
libcurl-errors \- error codes in libcurl
.SH DESCRIPTION
This man page includes most, if not all, available error codes in libcurl.
Why they occur and possibly what you can do to fix the problem are also included.
.SH "CURLcode"
Almost all "easy" interface functions return a CURLcode error code. No matter
what, using the \fIcurl_easy_setopt(3)\fP option \fICURLOPT_ERRORBUFFER(3)\fP
is a good idea as it gives you a human readable error string that may offer
more details about the cause of the error than just the error code.
\fIcurl_easy_strerror(3)\fP can be called to get an error string from a given
CURLcode number.
CURLcode is one of the following:
.IP "CURLE_OK (0)"
All fine. Proceed as usual.
.IP "CURLE_UNSUPPORTED_PROTOCOL (1)"
The URL you passed to libcurl used a protocol that this libcurl does not
support. The support might be a compile-time option that you did not use, it
can be a misspelled protocol string or just a protocol libcurl has no code
for.
.IP "CURLE_FAILED_INIT (2)"
Early initialization code failed. This is likely to be an internal error or
problem, or a resource problem where something fundamental could not get done
at init time.
.IP "CURLE_URL_MALFORMAT (3)"
The URL was not properly formatted.
.IP "CURLE_NOT_BUILT_IN (4)"
A requested feature, protocol or option was not found built-in in this libcurl
due to a build-time decision. This means that a feature or option was not
enabled or explicitly disabled when libcurl was built and in order to get it
to function you have to get a rebuilt libcurl.
.IP "CURLE_COULDNT_RESOLVE_PROXY (5)"
Could not resolve proxy. The given proxy host could not be resolved.
.IP "CURLE_COULDNT_RESOLVE_HOST (6)"
Could not resolve host. The given remote host was not resolved.
.IP "CURLE_COULDNT_CONNECT (7)"
Failed to connect() to host or proxy.
.IP "CURLE_WEIRD_SERVER_REPLY (8)"
The server sent data libcurl could not parse. This error code was known as
\fICURLE_FTP_WEIRD_SERVER_REPLY\fP before 7.51.0.
.IP "CURLE_REMOTE_ACCESS_DENIED (9)"
We were denied access to the resource given in the URL. For FTP, this occurs
while trying to change to the remote directory.
.IP "CURLE_FTP_ACCEPT_FAILED (10)"
While waiting for the server to connect back when an active FTP session is
used, an error code was sent over the control connection or similar.
.IP "CURLE_FTP_WEIRD_PASS_REPLY (11)"
After having sent the FTP password to the server, libcurl expects a proper
reply. This error code indicates that an unexpected code was returned.
.IP "CURLE_FTP_ACCEPT_TIMEOUT (12)"
During an active FTP session while waiting for the server to connect, the
\fICURLOPT_ACCEPTTIMEOUT_MS(3)\fP (or the internal default) timeout expired.
.IP "CURLE_FTP_WEIRD_PASV_REPLY (13)"
libcurl failed to get a sensible result back from the server as a response to
either a PASV or a EPSV command. The server is flawed.
.IP "CURLE_FTP_WEIRD_227_FORMAT (14)"
FTP servers return a 227-line as a response to a PASV command. If libcurl
fails to parse that line, this return code is passed back.
.IP "CURLE_FTP_CANT_GET_HOST (15)"
An internal failure to lookup the host used for the new connection.
.IP "CURLE_HTTP2 (16)"
A problem was detected in the HTTP2 framing layer. This is somewhat generic
and can be one out of several problems, see the error buffer for details.
.IP "CURLE_FTP_COULDNT_SET_TYPE (17)"
Received an error when trying to set the transfer mode to binary or ASCII.
.IP "CURLE_PARTIAL_FILE (18)"
A file transfer was shorter or larger than expected. This happens when the
server first reports an expected transfer size, and then delivers data that
does not match the previously given size.
.IP "CURLE_FTP_COULDNT_RETR_FILE (19)"
This was either a weird reply to a 'RETR' command or a zero byte transfer
complete.
.IP "Obsolete error (20)"
Not used in modern versions.
.IP "CURLE_QUOTE_ERROR (21)"
When sending custom "QUOTE" commands to the remote server, one of the commands
returned an error code that was 400 or higher (for FTP) or otherwise
indicated unsuccessful completion of the command.
.IP "CURLE_HTTP_RETURNED_ERROR (22)"
This is returned if \fICURLOPT_FAILONERROR(3)\fP is set TRUE and the HTTP
server returns an error code that is >= 400.
.IP "CURLE_WRITE_ERROR (23)"
An error occurred when writing received data to a local file, or an error was
returned to libcurl from a write callback.
.IP "Obsolete error (24)"
Not used in modern versions.
.IP "CURLE_UPLOAD_FAILED (25)"
Failed starting the upload. For FTP, the server typically denied the STOR
command. The error buffer usually contains the server's explanation for this.
.IP "CURLE_READ_ERROR (26)"
There was a problem reading a local file or an error returned by the read
callback.
.IP "CURLE_OUT_OF_MEMORY (27)"
A memory allocation request failed. This is serious badness and
things are severely screwed up if this ever occurs.
.IP "CURLE_OPERATION_TIMEDOUT (28)"
Operation timeout. The specified time-out period was reached according to the
conditions.
.IP "Obsolete error (29)"
Not used in modern versions.
.IP "CURLE_FTP_PORT_FAILED (30)"
The FTP PORT command returned error. This mostly happens when you have not
specified a good enough address for libcurl to use. See
\fICURLOPT_FTPPORT(3)\fP.
.IP "CURLE_FTP_COULDNT_USE_REST (31)"
The FTP REST command returned error. This should never happen if the server is
sane.
.IP "Obsolete error (32)"
Not used in modern versions.
.IP "CURLE_RANGE_ERROR (33)"
The server does not support or accept range requests.
.IP "CURLE_HTTP_POST_ERROR (34)"
This is an odd error that mainly occurs due to internal confusion.
.IP "CURLE_SSL_CONNECT_ERROR (35)"
A problem occurred somewhere in the SSL/TLS handshake. You really want the
error buffer and read the message there as it pinpoints the problem slightly
more. Could be certificates (file formats, paths, permissions), passwords, and
others.
.IP "CURLE_BAD_DOWNLOAD_RESUME (36)"
The download could not be resumed because the specified offset was out of the
file boundary.
.IP "CURLE_FILE_COULDNT_READ_FILE (37)"
A file given with FILE:// could not be opened. Most likely because the file
path does not identify an existing file. Did you check file permissions?
.IP "CURLE_LDAP_CANNOT_BIND (38)"
LDAP cannot bind. LDAP bind operation failed.
.IP "CURLE_LDAP_SEARCH_FAILED (39)"
LDAP search failed.
.IP "Obsolete error (40)"
Not used in modern versions.
.IP "CURLE_FUNCTION_NOT_FOUND (41)"
Function not found. A required zlib function was not found.
.IP "CURLE_ABORTED_BY_CALLBACK (42)"
Aborted by callback. A callback returned "abort" to libcurl.
.IP "CURLE_BAD_FUNCTION_ARGUMENT (43)"
A function was called with a bad parameter.
.IP "Obsolete error (44)"
Not used in modern versions.
.IP "CURLE_INTERFACE_FAILED (45)"
Interface error. A specified outgoing interface could not be used. Set which
interface to use for outgoing connections' source IP address with
\fICURLOPT_INTERFACE(3)\fP.
.IP "Obsolete error (46)"
Not used in modern versions.
.IP "CURLE_TOO_MANY_REDIRECTS (47)"
Too many redirects. When following redirects, libcurl hit the maximum amount.
Set your limit with \fICURLOPT_MAXREDIRS(3)\fP.
.IP "CURLE_UNKNOWN_OPTION (48)"
An option passed to libcurl is not recognized/known. Refer to the appropriate
documentation. This is most likely a problem in the program that uses
libcurl. The error buffer might contain more specific information about which
exact option it concerns.
.IP "CURLE_SETOPT_OPTION_SYNTAX (49)"
An option passed in to a setopt was wrongly formatted. See error message for
details about what option.
.IP "Obsolete errors (50-51)"
Not used in modern versions.
.IP "CURLE_GOT_NOTHING (52)"
Nothing was returned from the server, and under the circumstances, getting
nothing is considered an error.
.IP "CURLE_SSL_ENGINE_NOTFOUND (53)"
The specified crypto engine was not found.
.IP "CURLE_SSL_ENGINE_SETFAILED (54)"
Failed setting the selected SSL crypto engine as default.
.IP "CURLE_SEND_ERROR (55)"
Failed sending network data.
.IP "CURLE_RECV_ERROR (56)"
Failure with receiving network data.
.IP "Obsolete error (57)"
Not used in modern versions.
.IP "CURLE_SSL_CERTPROBLEM (58)"
problem with the local client certificate.
.IP "CURLE_SSL_CIPHER (59)"
Could not use specified cipher.
.IP "CURLE_PEER_FAILED_VERIFICATION (60)"
The remote server's SSL certificate or SSH fingerprint was deemed not OK.
This error code has been unified with CURLE_SSL_CACERT since 7.62.0. Its
previous value was 51.
.IP "CURLE_BAD_CONTENT_ENCODING (61)"
Unrecognized transfer encoding.
.IP "Obsolete error (62)"
Not used in modern versions.
.IP "CURLE_FILESIZE_EXCEEDED (63)"
Maximum file size exceeded.
.IP "CURLE_USE_SSL_FAILED (64)"
Requested FTP SSL level failed.
.IP "CURLE_SEND_FAIL_REWIND (65)"
When doing a send operation curl had to rewind the data to retransmit, but the
rewinding operation failed.
.IP "CURLE_SSL_ENGINE_INITFAILED (66)"
Initiating the SSL Engine failed.
.IP "CURLE_LOGIN_DENIED (67)"
The remote server denied curl to login (Added in 7.13.1)
.IP "CURLE_TFTP_NOTFOUND (68)"
File not found on TFTP server.
.IP "CURLE_TFTP_PERM (69)"
Permission problem on TFTP server.
.IP "CURLE_REMOTE_DISK_FULL (70)"
Out of disk space on the server.
.IP "CURLE_TFTP_ILLEGAL (71)"
Illegal TFTP operation.
.IP "CURLE_TFTP_UNKNOWNID (72)"
Unknown TFTP transfer ID.
.IP "CURLE_REMOTE_FILE_EXISTS (73)"
File already exists and is not overwritten.
.IP "CURLE_TFTP_NOSUCHUSER (74)"
This error should never be returned by a properly functioning TFTP server.
.IP "Obsolete error (75-76)"
Not used in modern versions.
.IP "CURLE_SSL_CACERT_BADFILE (77)"
Problem with reading the SSL CA cert (path? access rights?)
.IP "CURLE_REMOTE_FILE_NOT_FOUND (78)"
The resource referenced in the URL does not exist.
.IP "CURLE_SSH (79)"
An unspecified error occurred during the SSH session.
.IP "CURLE_SSL_SHUTDOWN_FAILED (80)"
Failed to shut down the SSL connection.
.IP "CURLE_AGAIN (81)"
Socket is not ready for send/recv wait till it's ready and try again. This
return code is only returned from \fIcurl_easy_recv(3)\fP and
\fIcurl_easy_send(3)\fP (Added in 7.18.2)
.IP "CURLE_SSL_CRL_BADFILE (82)"
Failed to load CRL file (Added in 7.19.0)
.IP "CURLE_SSL_ISSUER_ERROR (83)"
Issuer check failed (Added in 7.19.0)
.IP "CURLE_FTP_PRET_FAILED (84)"
The FTP server does not understand the PRET command at all or does not support
the given argument. Be careful when using \fICURLOPT_CUSTOMREQUEST(3)\fP, a
custom LIST command is sent with the PRET command before PASV as well. (Added
in 7.20.0)
.IP "CURLE_RTSP_CSEQ_ERROR (85)"
Mismatch of RTSP CSeq numbers.
.IP "CURLE_RTSP_SESSION_ERROR (86)"
Mismatch of RTSP Session Identifiers.
.IP "CURLE_FTP_BAD_FILE_LIST (87)"
Unable to parse FTP file list (during FTP wildcard downloading).
.IP "CURLE_CHUNK_FAILED (88)"
Chunk callback reported error.
.IP "CURLE_NO_CONNECTION_AVAILABLE (89)"
(For internal use only, is never returned by libcurl) No connection available,
the session is queued. (added in 7.30.0)
.IP "CURLE_SSL_PINNEDPUBKEYNOTMATCH (90)"
Failed to match the pinned key specified with \fICURLOPT_PINNEDPUBLICKEY(3)\fP.
.IP "CURLE_SSL_INVALIDCERTSTATUS (91)"
Status returned failure when asked with \fICURLOPT_SSL_VERIFYSTATUS(3)\fP.
.IP "CURLE_HTTP2_STREAM (92)"
Stream error in the HTTP/2 framing layer.
.IP "CURLE_RECURSIVE_API_CALL (93)"
An API function was called from inside a callback.
.IP "CURLE_AUTH_ERROR (94)"
An authentication function returned an error.
.IP "CURLE_HTTP3 (95)"
A problem was detected in the HTTP/3 layer. This is somewhat generic and can
be one out of several problems, see the error buffer for details.
.IP "CURLE_QUIC_CONNECT_ERROR (96)"
QUIC connection error. This error may be caused by an SSL library error. QUIC
is the protocol used for HTTP/3 transfers.
.IP "CURLE_PROXY (97)"
Proxy handshake error. \fICURLINFO_PROXY_ERROR(3)\fP provides extra details on
the specific problem.
.IP "CURLE_SSL_CLIENTCERT (98)"
SSL Client Certificate required.
.IP "CURLE_UNRECOVERABLE_POLL (99)"
An internal call to poll() or select() returned error that is not recoverable.
.IP "CURLE_OBSOLETE*"
These error codes are never returned. They were used in an old libcurl version
and are currently unused.
.SH "CURLMcode"
This is the generic return code used by functions in the libcurl multi
interface. Also consider \fIcurl_multi_strerror(3)\fP.
.IP "CURLM_CALL_MULTI_PERFORM (-1)"
This is not really an error. It means you should call
\fIcurl_multi_perform(3)\fP again without doing select() or similar in
between. Before version 7.20.0 (released on February 9 2010) this could be returned by
\fIcurl_multi_perform(3)\fP, but in later versions this return code is never
used.
.IP "CURLM_CALL_MULTI_SOCKET (-1)"
An alias for \fICURLM_CALL_MULTI_PERFORM\fP. Never returned by modern libcurl
versions.
.IP "CURLM_OK (0)"
Things are fine.
.IP "CURLM_BAD_HANDLE (1)"
The passed-in handle is not a valid \fICURLM\fP handle.
.IP "CURLM_BAD_EASY_HANDLE (2)"
An easy handle was not good/valid. It could mean that it is not an easy handle
at all, or possibly that the handle already is in use by this or another multi
handle.
.IP "CURLM_OUT_OF_MEMORY (3)"
You are doomed.
.IP "CURLM_INTERNAL_ERROR (4)"
This can only be returned if libcurl bugs. Please report it to us!
.IP "CURLM_BAD_SOCKET (5)"
The passed-in socket is not a valid one that libcurl already knows about.
(Added in 7.15.4)
.IP "CURLM_UNKNOWN_OPTION (6)"
curl_multi_setopt() with unsupported option
(Added in 7.15.4)
.IP "CURLM_ADDED_ALREADY (7)"
An easy handle already added to a multi handle was attempted to get added a
second time. (Added in 7.32.1)
.IP "CURLM_RECURSIVE_API_CALL (8)"
An API function was called from inside a callback.
.IP "CURLM_WAKEUP_FAILURE (9)"
Wake up is unavailable or failed.
.IP "CURLM_BAD_FUNCTION_ARGUMENT (10)"
A function was called with a bad parameter.
.IP "CURLM_ABORTED_BY_CALLBACK (11)"
A multi handle callback returned error.
.IP "CURLM_UNRECOVERABLE_POLL (12)"
An internal call to poll() or select() returned error that is not recoverable.
.SH "CURLSHcode"
The "share" interface returns a \fBCURLSHcode\fP to indicate when an error has
occurred. Also consider \fIcurl_share_strerror(3)\fP.
.IP "CURLSHE_OK (0)"
All fine. Proceed as usual.
.IP "CURLSHE_BAD_OPTION (1)"
An invalid option was passed to the function.
.IP "CURLSHE_IN_USE (2)"
The share object is currently in use.
.IP "CURLSHE_INVALID (3)"
An invalid share object was passed to the function.
.IP "CURLSHE_NOMEM (4)"
Not enough memory was available.
(Added in 7.12.0)
.IP "CURLSHE_NOT_BUILT_IN (5)"
The requested sharing could not be done because the library you use do not have
that particular feature enabled. (Added in 7.23.0)
.SH "CURLUcode"
The URL interface returns a \fICURLUcode\fP to indicate when an error has
occurred. Also consider \fIcurl_url_strerror(3)\fP.
.IP "CURLUE_OK (0)"
All fine. Proceed as usual.
.IP "CURLUE_BAD_HANDLE (1)"
An invalid URL handle was passed as argument.
.IP "CURLUE_BAD_PARTPOINTER (2)"
An invalid 'part' argument was passed as argument.
.IP "CURLUE_MALFORMED_INPUT (3)"
A malformed input was passed to a URL API function.
.IP "CURLUE_BAD_PORT_NUMBER (4)"
The port number was not a decimal number between 0 and 65535.
.IP "CURLUE_UNSUPPORTED_SCHEME (5)"
This libcurl build does not support the given URL scheme.
.IP "CURLUE_URLDECODE (6)"
URL decode error, most likely because of rubbish in the input.
.IP "CURLUE_OUT_OF_MEMORY (7)"
A memory function failed.
.IP "CURLUE_USER_NOT_ALLOWED (8)"
Credentials was passed in the URL when prohibited.
.IP "CURLUE_UNKNOWN_PART (9)"
An unknown part ID was passed to a URL API function.
.IP "CURLUE_NO_SCHEME (10)"
There is no scheme part in the URL.
.IP "CURLUE_NO_USER (11)"
There is no user part in the URL.
.IP "CURLUE_NO_PASSWORD (12)"
There is no password part in the URL.
.IP "CURLUE_NO_OPTIONS (13)"
There is no options part in the URL.
.IP "CURLUE_NO_HOST (14)"
There is no host part in the URL.
.IP "CURLUE_NO_PORT (15)"
There is no port part in the URL.
.IP "CURLUE_NO_QUERY (16)"
There is no query part in the URL.
.IP "CURLUE_NO_FRAGMENT (17)"
There is no fragment part in the URL.
.IP "CURLUE_NO_ZONEID (18)"
There is no zone id set in the URL.
.IP "CURLUE_BAD_FILE_URL (19)"
The file:// URL is invalid.
.IP "CURLUE_BAD_FRAGMENT (20)"
The fragment part of the URL contained bad or invalid characters.
.IP "CURLUE_BAD_HOSTNAME (21)"
The hostname contained bad or invalid characters.
.IP "CURLUE_BAD_IPV6 (22)"
The IPv6 address hostname contained bad or invalid characters.
.IP "CURLUE_BAD_LOGIN (23)"
The login part of the URL contained bad or invalid characters.
.IP "CURLUE_BAD_PASSWORD (24)"
The password part of the URL contained bad or invalid characters.
.IP "CURLUE_BAD_PATH (25)"
The path part of the URL contained bad or invalid characters.
.IP "CURLUE_BAD_QUERY (26)"
The query part of the URL contained bad or invalid characters.
.IP "CURLUE_BAD_SCHEME (27)"
The scheme part of the URL contained bad or invalid characters.
.IP "CURLUE_BAD_SLASHES (28)"
The URL contained an invalid number of slashes.
.IP "CURLUE_BAD_USER (29)"
The user part of the URL contained bad or invalid characters.
.SH "CURLHcode"
The header interface returns a \fICURLHcode\fP to indicate when an error has
occurred.
.IP "CURLHE_BADINDEX (1)"
There is no header with the requested index.
.IP "CURLHE_MISSING (2)"
No such header exists.
.IP "CURLHE_NOHEADERS (3)"
No headers at all have been recorded.
.IP "CURLHE_NOREQUEST (4)"
There was no such request number.
.IP "CURLHE_OUT_OF_MEMORY (5)"
Out of resources
.IP "CURLHE_BAD_ARGUMENT (6)"
One or more of the given arguments are bad.
.IP "CURLHE_NOT_BUILT_IN (7)"
HTTP support or the header API has been disabled in the build.
.SH "SEE ALSO"
.BR curl_easy_strerror (3),
.BR curl_multi_strerror (3),
.BR curl_share_strerror (3),
.BR curl_url_strerror (3),
.BR CURLOPT_ERRORBUFFER (3),
.BR CURLOPT_VERBOSE (3),
.BR CURLOPT_DEBUGFUNCTION (3)
man/man3/curl_pushheader_bynum.3 0000644 00000005043 14751172371 0012642 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.TH curl_pushheader_bynum 3 "September 26, 2023" "libcurl 8.4.0" "libcurl"
.SH NAME
curl_pushheader_bynum - get a push header by index
.SH SYNOPSIS
.nf
#include <curl/curl.h>
char *curl_pushheader_bynum(struct curl_pushheaders *h, size_t num);
.fi
.SH DESCRIPTION
This is a function that is only functional within a
\fICURLMOPT_PUSHFUNCTION(3)\fP callback. It makes no sense to try to use it
elsewhere and it has no function then.
It returns the value for the header field at the given index \fBnum\fP, for
the incoming server push request or NULL. The data pointed to is freed by
libcurl when this callback returns. The returned pointer points to a
"name:value" string that gets freed when this callback returns.
.SH EXAMPLE
.nf
/* output all the incoming push request headers */
int curl_push_callback(CURL *parent,
CURL *easy,
size_t num_headers,
struct curl_pushheaders *headers,
void *clientp)
{
sizt_t i = 0;
char *field;
do {
field = curl_pushheader_bynum(headers, i);
if(field)
fprintf(stderr, "Push header: %s\\n", field);
i++;
} while(field);
return CURL_PUSH_OK; /* permission granted */
}
curl_multi_setopt(multi, CURLMOPT_PUSHFUNCTION, curl_push_callback);
.fi
.SH AVAILABILITY
Added in 7.44.0
.SH RETURN VALUE
Returns a pointer to the header field content or NULL.
.SH "SEE ALSO"
.BR CURLMOPT_PUSHFUNCTION (3),
.BR curl_pushheader_byname (3)
man/man3/CURLINFO_EFFECTIVE_METHOD.3 0000644 00000005034 14751172371 0012114 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLINFO_EFFECTIVE_METHOD 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLINFO_EFFECTIVE_METHOD \- get the last used HTTP method
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_getinfo(CURL *handle, CURLINFO_EFFECTIVE_METHOD,
char **methodp);
.fi
.SH DESCRIPTION
Pass in a pointer to a char pointer and get the last used effective HTTP
method.
In cases when you have asked libcurl to follow redirects, the method may not be
the same method the first request would use.
The \fBmethodp\fP pointer is NULL or points to private memory. You MUST NOT
free - it gets freed when you call \fIcurl_easy_cleanup(3)\fP on the
corresponding CURL handle.
.SH PROTOCOLS
HTTP(S)
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
CURLcode res;
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
curl_easy_setopt(curl, CURLOPT_POSTFIELDS, "data");
curl_easy_setopt(curl, CURLOPT_FOLLOWLOCATION, 1L);
res = curl_easy_perform(curl);
if(res == CURLE_OK) {
char *method = NULL;
curl_easy_getinfo(curl, CURLINFO_EFFECTIVE_METHOD, &method);
if(method)
printf("Redirected to method: %s\\n", method);
}
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Added in 7.72.0
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR curl_easy_getinfo (3),
.BR curl_easy_setopt (3),
.BR CURLOPT_CUSTOMREQUEST (3),
.BR CURLOPT_FOLLOWLOCATION (3)
man/man3/CURLOPT_SUPPRESS_CONNECT_HEADERS.3 0000644 00000006033 14751172371 0013253 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_SUPPRESS_CONNECT_HEADERS 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_SUPPRESS_CONNECT_HEADERS \- suppress proxy CONNECT response headers from user callbacks
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_SUPPRESS_CONNECT_HEADERS, long onoff);
.fi
.SH DESCRIPTION
When \fICURLOPT_HTTPPROXYTUNNEL(3)\fP is used and a CONNECT request is made,
suppress proxy CONNECT response headers from the user callback functions
\fICURLOPT_HEADERFUNCTION(3)\fP and \fICURLOPT_WRITEFUNCTION(3)\fP.
Proxy CONNECT response headers can complicate header processing since it's
essentially a separate set of headers. You can enable this option to suppress
those headers.
For example let's assume an HTTPS URL is to be retrieved via CONNECT. On
success there would normally be two sets of headers, and each header line sent
to the header function and/or the write function. The data given to the
callbacks would look like this:
.nf
HTTP/1.1 200 Connection established
{headers}...
HTTP/1.1 200 OK
Content-Type: application/json
{headers}...
{body}...
.fi
However by enabling this option the CONNECT response headers are suppressed, so
the data given to the callbacks would look like this:
.nf
HTTP/1.1 200 OK
Content-Type: application/json
{headers}...
{body}...
.fi
.SH DEFAULT
0
.SH PROTOCOLS
All
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
curl_easy_setopt(curl, CURLOPT_HEADER, 1L);
curl_easy_setopt(curl, CURLOPT_PROXY, "http://foo:3128");
curl_easy_setopt(curl, CURLOPT_HTTPPROXYTUNNEL, 1L);
curl_easy_setopt(curl, CURLOPT_SUPPRESS_CONNECT_HEADERS, 1L);
curl_easy_perform(curl);
/* always cleanup */
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Added in 7.54.0
.SH RETURN VALUE
CURLE_OK or an error such as CURLE_UNKNOWN_OPTION.
.SH "SEE ALSO"
.BR CURLOPT_HEADER (3),
.BR CURLOPT_PROXY (3),
.BR CURLOPT_HTTPPROXYTUNNEL (3)
man/man3/CURLOPT_INTERLEAVEDATA.3 0000644 00000004275 14751172371 0011561 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_INTERLEAVEDATA 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_INTERLEAVEDATA \- pointer passed to RTSP interleave callback
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_INTERLEAVEDATA, void *pointer);
.fi
.SH DESCRIPTION
This is the userdata \fIpointer\fP that is passed to
\fICURLOPT_INTERLEAVEFUNCTION(3)\fP when interleaved RTP data is received. If
the interleave function callback is not set, this pointer is not used
anywhere.
.SH DEFAULT
NULL
.SH PROTOCOLS
RTSP
.SH EXAMPLE
.nf
static size_t rtp_write(void *ptr, size_t size, size_t nmemb, void *user)
{
struct local *l = (struct local *)user;
/* take care of the packet in 'ptr', then return... */
return size * nmemb;
}
{
struct local rtp_data;
curl_easy_setopt(curl, CURLOPT_INTERLEAVEFUNCTION, rtp_write);
curl_easy_setopt(curl, CURLOPT_INTERLEAVEDATA, &rtp_data);
}
.fi
.SH AVAILABILITY
Added in 7.20.0
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR CURLOPT_INTERLEAVEFUNCTION (3),
.BR CURLOPT_RTSP_REQUEST (3)
man/man3/CURLOPT_NOSIGNAL.3 0000644 00000005567 14751172371 0010710 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_NOSIGNAL 3 "August 22, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_NOSIGNAL \- skip all signal handling
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_NOSIGNAL, long onoff);
.fi
.SH DESCRIPTION
If \fIonoff\fP is 1, libcurl uses no functions that install signal handlers or
any functions that cause signals to be sent to the process. This option is
here to allow multi-threaded unix applications to still set/use all timeout
options etc, without risking getting signals.
If this option is set and libcurl has been built with the standard name
resolver, timeouts cannot occur while the name resolve takes place. Consider
building libcurl with the c-ares or threaded resolver backends to enable
asynchronous DNS lookups, to enable timeouts for name resolves without the use
of signals.
Setting \fICURLOPT_NOSIGNAL(3)\fP to 1 makes libcurl NOT ask the system to
ignore SIGPIPE signals, which otherwise are sent by the system when trying to
send data to a socket which is closed in the other end. libcurl makes an
effort to never cause such SIGPIPE signals to trigger, but some operating
systems have no way to avoid them and even on those that have there are some
corner cases when they may still happen, contrary to our desire. In addition,
using \fICURLAUTH_NTLM_WB\fP authentication could cause a SIGCHLD signal to be
raised.
.SH DEFAULT
0
.SH PROTOCOLS
All
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/");
curl_easy_setopt(curl, CURLOPT_NOSIGNAL, 1L);
ret = curl_easy_perform(curl);
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Added in 7.10
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH SEE ALSO
.BR CURLOPT_TIMEOUT "(3), "
man/man3/curl_mime_data.3 0000644 00000005173 14751172371 0011224 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.TH curl_mime_data 3 "September 26, 2023" "libcurl 8.4.0" "libcurl"
.SH NAME
curl_mime_data - set a mime part's body data from memory
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_mime_data(curl_mimepart *part, const char *data,
size_t datasize);
.fi
.SH DESCRIPTION
\fIcurl_mime_data(3)\fP sets a mime part's body content from memory data.
\fIpart\fP is the mime part to assign contents to, created with
\fIcurl_mime_addpart(3)\fP.
\fIdata\fP points to the data that gets copied by this function. The storage
may safely be reused after the call.
\fIdatasize\fP is the number of bytes \fIdata\fP points to. It can be set to
\fICURL_ZERO_TERMINATED\fP to indicate \fIdata\fP is a null-terminated
character string.
Setting a part's contents multiple times is valid: only the value set by the
last call is retained. It is possible to unassign part's contents by setting
\fIdata\fP to NULL.
Setting large data is memory consuming: one might consider using
\fIcurl_mime_data_cb(3)\fP in such a case.
.SH EXAMPLE
.nf
curl_mime *mime;
curl_mimepart *part;
/* create a mime handle */
mime = curl_mime_init(easy);
/* add a part */
part = curl_mime_addpart(mime);
/* add data to the part */
curl_mime_data(part, "raw contents to send", CURL_ZERO_TERMINATED);
.fi
.SH AVAILABILITY
As long as at least one of HTTP, SMTP or IMAP is enabled. Added in 7.56.0.
.SH RETURN VALUE
CURLE_OK or a CURL error code upon failure.
.SH "SEE ALSO"
.BR curl_mime_addpart (3),
.BR curl_mime_data_cb (3),
.BR curl_mime_name (3),
.BR curl_mime_type (3)
man/man3/CURLINFO_TOTAL_TIME.3 0000644 00000004477 14751172371 0011267 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLINFO_TOTAL_TIME 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLINFO_TOTAL_TIME \- get total time of previous transfer
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_getinfo(CURL *handle, CURLINFO_TOTAL_TIME, double *timep);
.fi
.SH DESCRIPTION
Pass a pointer to a double to receive the total time in seconds for the
previous transfer, including name resolving, TCP connect etc. The double
represents the time in seconds, including fractions.
When a redirect is followed, the time from each request is added together.
See also the TIMES overview in the \fIcurl_easy_getinfo(3)\fP man page.
.SH PROTOCOLS
All
.SH EXAMPLE
.nf
curl = curl_easy_init();
if(curl) {
double total;
curl_easy_setopt(curl, CURLOPT_URL, url);
res = curl_easy_perform(curl);
if(CURLE_OK == res) {
res = curl_easy_getinfo(curl, CURLINFO_TOTAL_TIME, &total);
if(CURLE_OK == res) {
printf("Time: %.1f", total);
}
}
/* always cleanup */
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Added in 7.4.1
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR curl_easy_getinfo (3),
.BR curl_easy_setopt (3),
.BR CURLINFO_TOTAL_TIME_T (3),
.BR CURLOPT_TIMEOUT (3)
man/man3/curl_global_trace.3 0000644 00000011137 14751172371 0011717 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.TH curl_global_trace 3 "September 26, 2023" "libcurl 8.4.0" "libcurl"
.SH NAME
curl_global_trace - Global libcurl logging configuration
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_global_trace(const char *config);
.fi
.SH DESCRIPTION
This function configures the logging behavior, allowing to make some
parts of curl more verbose or silent than others.
This function may be called during the initialization phase of a program. It
does not have to be. It can be called several times even, possibly overwriting
settings of previous calls.
Calling this function after transfers have been started is undefined. On
some platforms/architectures it might take effect, on others not.
This function is thread-safe since libcurl 8.3.0 if
\fIcurl_version_info(3)\fP has the CURL_VERSION_THREADSAFE feature bit set
(most platforms).
If this is not thread-safe, you must not call this function when any other
thread in the program (i.e. a thread sharing the same memory) is running.
This does not just mean no other thread that is using libcurl. Because
\fIcurl_global_init(3)\fP may call functions of other libraries that are
similarly thread unsafe, it could conflict with any other thread that uses
these other libraries.
If you are initializing libcurl from a Windows DLL you should not initialize
it from \fIDllMain\fP or a static initializer because Windows holds the loader
lock during that time and it could cause a deadlock.
The \fIconfig\fP string is a list of comma-separated component names. Names
are case-insensitive and unknown names are ignored. The special name "all"
applies to all components. Names may be prefixed with '+' or '-' to enable
or disable detailed logging for a component.
The list of component names is not part of curl's public API. Names may be
added or disappear in future versions of libcurl. Since unknown names are
silently ignored, outdated log configurations does not cause errors when
upgrading libcurl. Given that, some names can be expected to be fairly stable
and are listed below for easy reference.
Note that log configuration applies only to transfers where debug logging
is enabled. See \fICURLOPT_VERBOSE(3)\fP or \fICURLOPT_DEBUGFUNCTION(3)\fP
on how to control that.
.SH TRACE COMPONENTS
.IP tcp
Tracing of TCP socket handling: connect, reads, writes.
.IP ssl
Tracing of SSL/TLS operations, whichever SSL backend is used in your build.
.IP http/2
Details about HTTP/2 handling: frames, events, I/O, etc.
.IP http/3
Details about HTTP/3 handling: connect, frames, events, I/O etc.
.IP http-proxy
Involved when transfers are tunneled through a HTTP proxy. "h1-proxy" or
"h2-proxy" are also involved, depending on the HTTP version negotiated with
the proxy.
In order to find out all components involved in a transfer, run it with "all"
configured. You can then see all names involved in your libcurl version in the
trace.
.SH EXAMPLE
.nf
/* log details of HTTP/2 and SSL handling */
curl_global_trace("http/2,ssl");
/* log all details, except SSL handling */
curl_global_trace("all,-ssl");
.fi
Below is a trace sample where "http/2" was configured. The trace output
of an enabled component appears at the beginning in brackets.
.nf
* [HTTP/2] [h2sid=1] cf_send(len=96) submit https://example.com/
...
* [HTTP/2] [h2sid=1] FRAME[HEADERS]
* [HTTP/2] [h2sid=1] 249 header bytes
...
.fi
.SH AVAILABILITY
Added in 8.3
.SH RETURN VALUE
If this function returns non-zero, something went wrong and the configuration
may not have any effects or may only been applied partially.
.SH "SEE ALSO"
.BR curl_global_init (3),
.BR libcurl (3)
man/man3/CURLOPT_TFTP_NO_OPTIONS.3 0000644 00000004763 14751172371 0012057 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_TFTP_NO_OPTIONS 3 "June 25, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_TFTP_NO_OPTIONS \- send no TFTP options requests
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_TFTP_NO_OPTIONS, long onoff);
.fi
.SH DESCRIPTION
Set \fIonoff\fP to 1L to exclude all TFTP options defined in RFC 2347,
RFC 2348 and RFC 2349 from read and write requests.
This option improves interoperability with legacy servers that do not
acknowledge or properly implement TFTP options. When this option is used
\fICURLOPT_TFTP_BLKSIZE(3)\fP is ignored.
.SH DEFAULT
0
.SH PROTOCOLS
TFTP
.SH EXAMPLE
.nf
size_t write_callback(char *ptr, size_t size, size_t nmemb, void *fp)
{
return fwrite(ptr, size, nmemb, (FILE *)fp);
}
CURL *curl = curl_easy_init();
if(curl) {
FILE *fp = fopen("foo.bin", "wb");
if(fp) {
curl_easy_setopt(curl, CURLOPT_WRITEDATA, (void *)fp);
curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, write_callback);
curl_easy_setopt(curl, CURLOPT_URL, "tftp://example.com/foo.bin");
/* do not send TFTP options requests */
curl_easy_setopt(curl, CURLOPT_TFTP_NO_OPTIONS, 1L);
/* Perform the request */
curl_easy_perform(curl);
fclose(fp);
}
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Added in 7.48.0
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH SEE ALSO
.BR CURLOPT_TFTP_BLKSIZE "(3), "
man/man3/CURLOPT_MAXLIFETIME_CONN.3 0000644 00000005304 14751172371 0012044 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_MAXLIFETIME_CONN 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_MAXLIFETIME_CONN \- max lifetime (since creation) allowed for reusing a connection
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_MAXLIFETIME_CONN,
long maxlifetime);
.fi
.SH DESCRIPTION
Pass a long as parameter containing \fImaxlifetime\fP - the maximum time in
seconds, since the creation of the connection, that you allow an existing
connection to have to be considered for reuse for this request.
libcurl features a connection cache that holds previously used connections.
When a new request is to be done, libcurl considers any connection that
matches for reuse. The \fICURLOPT_MAXLIFETIME_CONN(3)\fP limit prevents
libcurl from trying too old connections for reuse. This can be used for
client-side load balancing. If a connection is found in the cache that is
older than this set \fImaxlifetime\fP, it is instead marked for closure.
If set to 0, this behavior is disabled: all connections are eligible for reuse.
.SH DEFAULT
Default \fImaxlifetime\fP is 0 seconds (i.e., disabled).
.SH PROTOCOLS
All
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
/* only allow each connection to be reused for 30 seconds */
curl_easy_setopt(curl, CURLOPT_MAXLIFETIME_CONN, 30L);
curl_easy_perform(curl);
}
.fi
.SH AVAILABILITY
Added in 7.80.0
.SH RETURN VALUE
Returns CURLE_OK.
.SH "SEE ALSO"
.BR CURLOPT_FORBID_REUSE (3),
.BR CURLOPT_FRESH_CONNECT (3),
.BR CURLOPT_MAXAGE_CONN (3),
.BR CURLOPT_TIMEOUT (3)
man/man3/curl_easy_header.3 0000644 00000014070 14751172371 0011551 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.TH curl_easy_header 3 "September 26, 2023" "libcurl 8.4.0" "libcurl"
.SH NAME
curl_easy_header - get an HTTP header
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLHcode curl_easy_header(CURL *easy,
const char *name,
size_t index,
unsigned int origin,
int request,
struct curl_header **hout);
.SH DESCRIPTION
\fIcurl_easy_header(3)\fP returns a pointer to a "curl_header" struct in
\fBhout\fP with data for the HTTP response header \fIname\fP. The case
insensitive null-terminated header name should be specified without colon.
\fIindex\fP 0 means asking for the first instance of the header. If the
returned header struct has \fBamount\fP set larger than 1, it means there are
more instances of the same header name available to get. Asking for a too big
index makes \fBCURLHE_BADINDEX\fP get returned.
The \fIorigin\fP argument is for specifying which headers to receive, as a
single HTTP transfer might provide headers from several different places and
they may then have different importance to the user and headers using the same
name might be used. The \fIorigin\fP is a bitmask for what header sources you
want. See the descriptions below.
The \fIrequest\fP argument tells libcurl from which request you want headers
from. A single transfer might consist of a series of HTTP requests and this
argument lets you specify which particular individual request you want the
headers from. 0 being the first request and then the number increases for
further redirects or when multi-state authentication is used. Passing in -1 is
a shortcut to "the last" request in the series, independently of the actual
amount of requests used.
libcurl stores and provides the actually used "correct" headers. If for
example two headers with the same name arrive and the latter overrides the
former, then only the latter is provided. If the first header survives the
second, then only the first one is provided. An application using this API
does not have to bother about multiple headers used wrongly.
The memory for the returned struct is associated with the easy handle and
subsequent calls to \fIcurl_easy_header(3)\fP clobbers the struct used in the
previous calls for the same easy handle. Applications need to copy the data if
it wants to keep it around. The memory used for the struct gets freed with
calling \fIcurl_easy_cleanup(3)\fP of the easy handle.
The first line in an HTTP response is called the status line. It is not
considered a header by this function. Headers are the "name: value" lines
following the status.
This function can be used before (all) headers have been received and is fine
to call from within libcurl callbacks. It returns the state of the headers at
the time it is called.
.SH "The header struct"
.nf
struct curl_header {
char *name;
char *value;
size_t amount;
size_t index;
unsigned int origin;
void *anchor;
};
.fi
The data \fBname\fP field points to, is the same as the requested name, but
might have a different case.
The data \fBvalue\fP field points to, comes exactly as delivered over the
network but with leading and trailing whitespace and newlines stripped
off. The `value` data is null-terminated. For legacy HTTP/1 "folded headers",
this API provides the full single value in an unfolded manner with a single
whitespace between the lines.
\fBamount\fP is how many headers using this name that exist, within the origin
and request scope asked for.
\fBindex\fP is the zero based entry number of this particular header, which in
case this header was used more than once in the requested scope can be larger
than 0 but is always less than \fBamount\fP.
The \fBorigin\fP field in the "curl_header" struct has one of the origin bits
set, indicating where from the header originates. At the time of this writing,
there are 5 bits with defined use. The undocumented 27 remaining bits are
reserved for future use and must not be assumed to have any particular value.
\fBanchor\fP is a private handle used by libcurl internals. Do not modify.
.SH ORIGINS
.IP CURLH_HEADER
The header arrived as a header from the server.
.IP CURLH_TRAILER
The header arrived as a trailer. A header that arrives after the body.
.IP CURLH_CONNECT
The header arrived in a CONNECT response. A CONNECT request is being done to
setup a transfer "through" an HTTP(S) proxy.
.IP CURLH_1XX
The header arrived in an HTTP 1xx response. A 1xx response is an "intermediate"
response that might happen before the "real" response.
.IP CURLH_PSEUDO
The header is an HTTP/2 or HTTP/3 pseudo header
.SH EXAMPLE
.nf
struct curl_header *type;
CURLHcode h =
curl_easy_header(easy, "Content-Type", 0, CURLH_HEADER, -1, &type);
.fi
.SH AVAILABILITY
Added in 7.83.0. Officially supported since 7.84.0.
.SH RETURN VALUE
This function returns a CURLHcode indicating success or error.
.SH "SEE ALSO"
.BR curl_easy_nextheader (3),
.BR curl_easy_perform (3),
.BR CURLINFO_CONTENT_TYPE (3),
.BR CURLOPT_HEADERFUNCTION (3),
.BR libcurl-errors (3)
man/man3/CURLOPT_NOPROGRESS.3 0000644 00000004165 14751172371 0011170 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_NOPROGRESS 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_NOPROGRESS \- switch off the progress meter
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_NOPROGRESS, long onoff);
.fi
.SH DESCRIPTION
If \fIonoff\fP is to 1, it tells the library to shut off the progress meter
completely for requests done with this \fIhandle\fP. It also prevents the
\fICURLOPT_XFERINFOFUNCTION(3)\fP or \fICURLOPT_PROGRESSFUNCTION(3)\fP from
getting called.
.SH DEFAULT
1, meaning it normally runs without a progress meter.
.SH PROTOCOLS
All
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
/* enable progress meter */
curl_easy_setopt(curl, CURLOPT_NOPROGRESS, 0L);
/* Perform the request */
curl_easy_perform(curl);
}
.fi
.SH AVAILABILITY
Always
.SH RETURN VALUE
Returns CURLE_OK.
.SH "SEE ALSO"
.BR CURLOPT_DEBUGFUNCTION (3),
.BR CURLOPT_PROGRESSFUNCTION (3),
.BR CURLOPT_VERBOSE (3),
.BR CURLOPT_XFERINFOFUNCTION (3)
man/man3/CURLOPT_CRLFILE.3 0000644 00000006057 14751172371 0010551 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_CRLFILE 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_CRLFILE \- Certificate Revocation List file
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_CRLFILE, char *file);
.fi
.SH DESCRIPTION
Pass a char * to a null-terminated string naming a \fIfile\fP with the
concatenation of CRL (in PEM format) to use in the certificate validation that
occurs during the SSL exchange.
When curl is built to use GnuTLS, there is no way to influence the use of CRL
passed to help in the verification process.
When libcurl is built with OpenSSL support, X509_V_FLAG_CRL_CHECK and
X509_V_FLAG_CRL_CHECK_ALL are both set, requiring CRL check against all the
elements of the certificate chain if a CRL file is passed. Also note that
\fICURLOPT_CRLFILE(3)\fP implies \fBCURLSSLOPT_NO_PARTIALCHAIN\fP (see
\fICURLOPT_SSL_OPTIONS(3)\fP) since curl 7.71.0 due to an OpenSSL bug.
This option makes sense only when used in combination with the
\fICURLOPT_SSL_VERIFYPEER(3)\fP option.
A specific error code (\fICURLE_SSL_CRL_BADFILE\fP) is defined with the
option. It is returned when the SSL exchange fails because the CRL file cannot
be loaded. A failure in certificate verification due to a revocation
information found in the CRL does not trigger this specific error.
The application does not have to keep the string around after setting this
option.
.SH DEFAULT
NULL
.SH PROTOCOLS
All TLS-based protocols
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/");
curl_easy_setopt(curl, CURLOPT_CRLFILE, "/etc/certs/crl.pem");
ret = curl_easy_perform(curl);
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Added in 7.19.0
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, CURLE_UNKNOWN_OPTION if not, or
CURLE_OUT_OF_MEMORY if there was insufficient heap space.
.SH "SEE ALSO"
.BR CURLOPT_PROXY_CRLFILE (3),
.BR CURLOPT_SSL_VERIFYHOST (3),
.BR CURLOPT_SSL_VERIFYPEER (3)
man/man3/curl_url_strerror.3 0000644 00000003636 14751172371 0012052 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.TH curl_url_strerror 3 "September 27, 2023" "libcurl 8.4.0" "libcurl"
.SH NAME
curl_url_strerror - return string describing error code
.SH SYNOPSIS
.nf
.B #include <curl/curl.h>
.BI "const char *curl_url_strerror(CURLUcode " errornum ");"
.SH DESCRIPTION
This function returns a string describing the CURLUcode error code passed in
the argument \fIerrornum\fP.
.SH EXAMPLE
.nf
CURLUcode rc;
CURLU *url = curl_url();
rc = curl_url_set(url, CURLUPART_URL, "https://example.com", 0);
if(rc)
printf("URL error: %s\\n", curl_url_strerror(rc));
curl_url_cleanup(url);
.fi
.SH AVAILABILITY
Added in 7.80.0
.SH RETURN VALUE
A pointer to a null-terminated string.
.SH "SEE ALSO"
.BR curl_easy_strerror (3),
.BR curl_multi_strerror (3),
.BR curl_share_strerror (3),
.BR curl_url_get (3),
.BR curl_url_set (3),
.BR libcurl-errors (3)
man/man3/CURLOPT_PROXY_TLSAUTH_PASSWORD.3 0000644 00000005141 14751172371 0013131 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_PROXY_TLSAUTH_PASSWORD 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_PROXY_TLSAUTH_PASSWORD \- password to use for proxy TLS authentication
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_PROXY_TLSAUTH_PASSWORD,
char *pwd);
.fi
.SH DESCRIPTION
Pass a char * as parameter, which should point to the null-terminated password
to use for the TLS authentication method specified with the
\fICURLOPT_PROXY_TLSAUTH_TYPE(3)\fP option. Requires that the
\fICURLOPT_PROXY_TLSAUTH_USERNAME(3)\fP option also be set.
The application does not have to keep the string around after setting this
option.
.SH DEFAULT
NULL
.SH PROTOCOLS
All
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/");
curl_easy_setopt(curl, CURLOPT_PROXY, "https://proxy");
curl_easy_setopt(curl, CURLOPT_PROXY_TLSAUTH_TYPE, "SRP");
curl_easy_setopt(curl, CURLOPT_PROXY_TLSAUTH_USERNAME, "user");
curl_easy_setopt(curl, CURLOPT_PROXY_TLSAUTH_PASSWORD, "secret");
ret = curl_easy_perform(curl);
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Added in 7.52.0, with the OpenSSL and GnuTLS backends only
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, CURLE_UNKNOWN_OPTION if not, or
CURLE_OUT_OF_MEMORY if there was insufficient heap space.
.SH "SEE ALSO"
.BR CURLOPT_PROXY_TLSAUTH_TYPE (3),
.BR CURLOPT_PROXY_TLSAUTH_USERNAME (3),
.BR CURLOPT_TLSAUTH_TYPE (3),
.BR CURLOPT_TLSAUTH_USERNAME (3)
man/man3/curl_easy_option_by_name.3 0000644 00000004160 14751172371 0013322 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.TH curl_easy_option_by_name 3 "September 26, 2023" "libcurl 8.4.0" "libcurl"
.SH NAME
curl_easy_option_by_name - find an easy setopt option by name
.SH SYNOPSIS
.nf
#include <curl/curl.h>
const struct curl_easyoption *curl_easy_option_by_name(const char *name);
.fi
.SH DESCRIPTION
Given a \fBname\fP, this function returns a pointer to the
\fIcurl_easyoption\fP struct, holding information about the
\fIcurl_easy_setopt(3)\fP option using that name. The name should be specified
without the "CURLOPT_" prefix and the name comparison is made case
insensitive.
If libcurl has no option with the given name, this function returns NULL.
.SH EXAMPLE
.nf
const struct curl_easyoption *opt = curl_easy_option_by_name("URL");
if(opt) {
printf("This option wants CURLoption %x\\n", (int)opt->id);
}
.fi
.SH AVAILABILITY
This function was added in libcurl 7.73.0
.SH RETURN VALUE
A pointer to the \fIcurl_easyoption\fP struct for the option or NULL.
.SH "SEE ALSO"
.BR curl_easy_option_by_id (3),
.BR curl_easy_option_next (3),
.BR curl_easy_setopt (3)
man/man3/CURLOPT_FTP_CREATE_MISSING_DIRS.3 0000644 00000006163 14751172371 0013155 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_FTP_CREATE_MISSING_DIRS 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_FTP_CREATE_MISSING_DIRS \- create missing directories for FTP and SFTP
.SH SYNOPSIS
.nf
#include <curl/curl.h>
typedef enum {
CURLFTP_CREATE_DIR_NONE,
CURLFTP_CREATE_DIR,
CURLFTP_CREATE_DIR_RETRY
} curl_ftpcreatedir;
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_FTP_CREATE_MISSING_DIRS,
long create);
.SH DESCRIPTION
Pass a long telling libcurl to \fIcreate\fP the dir. If the value is
\fICURLFTP_CREATE_DIR\fP (1), libcurl may create any remote directory that it
fails to "move" into.
For FTP requests, that means a CWD command fails. CWD being the command that
changes working directory.
For SFTP requests, libcurl may create the remote directory if it cannot obtain
a handle to the target-location. The creation fails if a file of the same name
as the directory to create already exists or lack of permissions prevents
creation.
Setting \fIcreate\fP to \fICURLFTP_CREATE_DIR_RETRY\fP (2), tells libcurl to
retry the CWD command again if the subsequent \fBMKD\fP command fails. This is
especially useful if you are doing many simultaneous connections against the
same server and they all have this option enabled, as then CWD may first fail
but then another connection does \fBMKD\fP before this connection and thus
\fBMKD\fP fails but trying CWD works!
.SH DEFAULT
CURLFTP_CREATE_DIR_NONE (0)
.SH PROTOCOLS
FTP and SFTP
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "ftp://example.com/non-existing/new.txt");
curl_easy_setopt(curl, CURLOPT_FTP_CREATE_MISSING_DIRS,
(long)CURLFTP_CREATE_DIR_RETRY);
ret = curl_easy_perform(curl);
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Added in 7.10.7. SFTP support added in 7.16.3. The retry option was added in
7.19.4.
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if the
create value is not.
.SH "SEE ALSO"
.BR CURLOPT_FTP_FILEMETHOD (3),
.BR CURLOPT_FTP_USE_EPSV (3)
man/man3/curl_global_cleanup.3 0000644 00000005531 14751172371 0012251 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.TH curl_global_cleanup 3 "September 26, 2023" "libcurl 8.4.0" "libcurl"
.SH NAME
curl_global_cleanup - global libcurl cleanup
.SH SYNOPSIS
.nf
#include <curl/curl.h>
void curl_global_cleanup(void);
.fi
.SH DESCRIPTION
This function releases resources acquired by \fIcurl_global_init(3)\fP.
You should call \fIcurl_global_cleanup(3)\fP once for each call you make to
\fIcurl_global_init(3)\fP, after you are done using libcurl.
This function is thread-safe since libcurl 7.84.0 if
\fIcurl_version_info(3)\fP has the CURL_VERSION_THREADSAFE feature bit set
(most platforms).
If this is not thread-safe, you must not call this function when any other
thread in the program (i.e. a thread sharing the same memory) is running.
This does not just mean no other thread that is using libcurl. Because
\fIcurl_global_cleanup(3)\fP calls functions of other libraries that are
similarly thread unsafe, it could conflict with any other thread that uses
these other libraries.
See the description in \fIlibcurl(3)\fP of global environment requirements for
details of how to use this function.
.SH CAUTION
\fIcurl_global_cleanup(3)\fP does not block waiting for any libcurl-created
threads to terminate (such as threads used for name resolving). If a module
containing libcurl is dynamically unloaded while libcurl-created threads are
still running then your program may crash or other corruption may occur. We
recommend you do not run libcurl from any module that may be unloaded
dynamically. This behavior may be addressed in the future.
.SH EXAMPLE
.nf
curl_global_init(CURL_GLOBAL_DEFAULT);
/* use libcurl, then before exiting... */
curl_global_cleanup();
.fi
.SH AVAILABILITY
Added in 7.8
.SH RETURN VALUE
None
.SH "SEE ALSO"
.BR curl_global_init (3),
.BR libcurl (3),
.BR libcurl-thread (3)
man/man3/CURLOPT_TIMECONDITION.3 0000644 00000005012 14751172371 0011464 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_TIMECONDITION 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_TIMECONDITION \- select condition for a time request
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_TIMECONDITION, long cond);
.fi
.SH DESCRIPTION
Pass a long as parameter. This defines how the \fICURLOPT_TIMEVALUE(3)\fP time
value is treated. You can set this parameter to \fICURL_TIMECOND_IFMODSINCE\fP
or \fICURL_TIMECOND_IFUNMODSINCE\fP.
The last modification time of a file is not always known and in such instances
this feature has no effect even if the given time condition would not have
been met. \fIcurl_easy_getinfo(3)\fP with the \fICURLINFO_CONDITION_UNMET\fP
option can be used after a transfer to learn if a zero-byte successful
"transfer" was due to this condition not matching.
.SH DEFAULT
CURL_TIMECOND_NONE (0)
.SH PROTOCOLS
HTTP, FTP, RTSP, and FILE
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
/* January 1, 2020 is 1577833200 */
curl_easy_setopt(curl, CURLOPT_TIMEVALUE, 1577833200L);
/* If-Modified-Since the above time stamp */
curl_easy_setopt(curl, CURLOPT_TIMECONDITION,
(long)CURL_TIMECOND_IFMODSINCE);
/* Perform the request */
curl_easy_perform(curl);
}
.fi
.SH AVAILABILITY
Always
.SH RETURN VALUE
Returns CURLE_OK
.SH "SEE ALSO"
.BR CURLOPT_TIMEVALUE (3),
.BR CURLINFO_FILETIME (3)
man/man3/CURLOPT_XFERINFODATA.3 0000644 00000004700 14751172371 0011334 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_XFERINFODATA 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_XFERINFODATA \- pointer passed to the progress callback
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_XFERINFODATA, void *pointer);
.fi
.SH DESCRIPTION
Pass a \fIpointer\fP that is untouched by libcurl and passed as the first
argument in the progress callback set with \fICURLOPT_XFERINFOFUNCTION(3)\fP.
This is an alias for \fICURLOPT_PROGRESSDATA(3)\fP.
.SH DEFAULT
The default value of this parameter is NULL.
.SH PROTOCOLS
All
.SH EXAMPLE
.nf
struct progress {
char *private;
size_t size;
};
static size_t progress_callback(void *clientp,
curl_off_t dltotal,
curl_off_t dlnow,
curl_off_t ultotal,
curl_off_t ulnow)
{
struct memory *progress = (struct progress *)clientp;
/* use the values */
return 0; /* all is good */
}
struct progress data;
/* pass struct to callback */
curl_easy_setopt(curl_handle, CURLOPT_XFERINFODATA, &data);
curl_easy_setopt(curl_handle, CURLOPT_XFERINFOFUNCTION, progress_callback);
.fi
.SH AVAILABILITY
Added in 7.32.0
.SH RETURN VALUE
Returns CURLE_OK
.SH "SEE ALSO"
.BR CURLOPT_NOPROGRESS (3),
.BR CURLOPT_VERBOSE (3),
.BR CURLOPT_XFERINFOFUNCTION (3)
man/man3/CURLOPT_FTPSSLAUTH.3 0000644 00000004610 14751172371 0011157 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_FTPSSLAUTH 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_FTPSSLAUTH \- order in which to attempt TLS vs SSL
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_FTPSSLAUTH, long order);
.fi
.SH DESCRIPTION
Pass a long using one of the values from below, to alter how libcurl issues
\&"AUTH TLS" or "AUTH SSL" when FTP over SSL is activated. This is only
interesting if \fICURLOPT_USE_SSL(3)\fP is also set.
Possible \fIorder\fP values:
.IP CURLFTPAUTH_DEFAULT
Allow libcurl to decide.
.IP CURLFTPAUTH_SSL
Try "AUTH SSL" first, and only if that fails try "AUTH TLS".
.IP CURLFTPAUTH_TLS
Try "AUTH TLS" first, and only if that fails try "AUTH SSL".
.SH DEFAULT
CURLFTPAUTH_DEFAULT
.SH PROTOCOLS
FTP
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "ftp://example.com/file.txt");
curl_easy_setopt(curl, CURLOPT_USE_SSL, CURLUSESSL_TRY);
/* funny server, ask for SSL before TLS */
curl_easy_setopt(curl, CURLOPT_FTPSSLAUTH, (long)CURLFTPAUTH_SSL);
ret = curl_easy_perform(curl);
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Added in 7.12.2
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR CURLOPT_USE_SSL (3),
.BR CURLOPT_FTP_SSL_CCC (3)
man/man3/CURLOPT_INFILESIZE.3 0000644 00000005410 14751172371 0011122 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_INFILESIZE 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_INFILESIZE \- size of the input file to send off
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_INFILESIZE, long filesize);
.fi
.SH DESCRIPTION
When uploading a file to a remote site, \fIfilesize\fP should be used to tell
libcurl what the expected size of the input file is. This value must be passed
as a long. See also \fICURLOPT_INFILESIZE_LARGE(3)\fP for sending files larger
than 2GB.
For uploading using SCP, this option or \fICURLOPT_INFILESIZE_LARGE(3)\fP is
mandatory.
To unset this value again, set it to -1.
Using \fICURLOPT_UPLOAD(3)\fP to a HTTP/1.1 server and this value set to -1,
makes libcurl do a chunked transfer-encoded upload.
When sending emails using SMTP, this command can be used to specify the
optional SIZE parameter for the MAIL FROM command.
This option does not limit how much data libcurl actually sends, as that is
controlled entirely by what the read callback returns, but telling one value
and sending a different amount may lead to errors.
.SH DEFAULT
Unset
.SH PROTOCOLS
Many
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
long uploadsize = FILE_SIZE;
curl_easy_setopt(curl, CURLOPT_URL, "ftp://example.com/destination.tar.gz");
curl_easy_setopt(curl, CURLOPT_UPLOAD, 1L);
curl_easy_setopt(curl, CURLOPT_INFILESIZE, uploadsize);
curl_easy_perform(curl);
}
.fi
.SH AVAILABILITY
SMTP support added in 7.23.0
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR CURLINFO_CONTENT_LENGTH_UPLOAD_T (3),
.BR CURLOPT_INFILESIZE_LARGE (3),
.BR CURLOPT_UPLOAD (3)
man/man3/CURLOPT_HAPROXY_CLIENT_IP.3 0000644 00000004336 14751172371 0012247 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_HAPROXY_CLIENT_IP 3 "August 22, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_HAPROXY_CLIENT_IP \- set HAProxy PROXY protocol client IP
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_HAPROXY_CLIENT_IP,
char *client_ip);
.fi
.SH DESCRIPTION
When this parameter is set to a valid IPv4 or IPv6 numerical address, the
library sends this address as client address in the HAProxy PROXY protocol v1
header at beginning of the connection.
This option is an alternative to \fICURLOPT_HAPROXYPROTOCOL(3)\fP as that one
cannot use a specified address.
.SH DEFAULT
NULL, no HAProxy header is sent
.SH PROTOCOLS
HTTP, HAProxy PROTOCOL
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
CURLcode ret;
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/");
curl_easy_setopt(curl, CURLOPT_HAPROXY_CLIENT_IP, "1.1.1.1");
ret = curl_easy_perform(curl);
}
.fi
.SH AVAILABILITY
Along with HTTP. Added in 8.2.0.
.SH RETURN VALUE
Returns CURLE_OK if HTTP is enabled, and CURLE_UNKNOWN_OPTION if not.
.SH SEE ALSO
.BR CURLOPT_PROXY "(3), "
.BR CURLOPT_HAPROXYPROTOCOL "(3), "
man/man3/CURLOPT_LOW_SPEED_TIME.3 0000644 00000004243 14751172371 0011663 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_LOW_SPEED_TIME 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_LOW_SPEED_TIME \- low speed limit time period
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_LOW_SPEED_TIME,
long speedtime);
.fi
.SH DESCRIPTION
Pass a long as parameter. It contains the time in number seconds that the
transfer speed should be below the \fICURLOPT_LOW_SPEED_LIMIT(3)\fP for the
library to consider it too slow and abort.
.SH DEFAULT
0, disabled
.SH PROTOCOLS
All
.SH EXAMPLE
.nf
curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, url);
/* abort if slower than 30 bytes/sec during 60 seconds */
curl_easy_setopt(curl, CURLOPT_LOW_SPEED_TIME, 60L);
curl_easy_setopt(curl, CURLOPT_LOW_SPEED_LIMIT, 30L);
res = curl_easy_perform(curl);
if(CURLE_OPERATION_TIMEDOUT == res) {
printf("Timeout!\\n");
}
/* always cleanup */
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Always
.SH RETURN VALUE
Returns CURLE_OK
.SH "SEE ALSO"
.BR CURLOPT_LOW_SPEED_LIMIT (3),
.BR CURLOPT_TIMEOUT (3)
man/man3/CURLOPT_CONNECT_TO.3 0000644 00000011105 14751172371 0011152 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_CONNECT_TO 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_CONNECT_TO \- connect to a specific host and port instead of the URL's host and port
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_CONNECT_TO,
struct curl_slist *connect_to);
.fi
.SH DESCRIPTION
Pass a pointer to a linked list of strings with "connect to" information to
use for establishing network connections with this handle. The linked list
should be a fully valid list of \fBstruct curl_slist\fP structs properly
filled in. Use \fIcurl_slist_append(3)\fP to create the list and
\fIcurl_slist_free_all(3)\fP to clean up an entire list.
Each single string should be written using the format
HOST:PORT:CONNECT-TO-HOST:CONNECT-TO-PORT where HOST is the host of the
request, PORT is the port of the request, CONNECT-TO-HOST is the host name to
connect to, and CONNECT-TO-PORT is the port to connect to.
The first string that matches the request's host and port is used.
Dotted numerical IP addresses are supported for HOST and CONNECT-TO-HOST.
A numerical IPv6 address must be written within [brackets].
Any of the four values may be empty. When the HOST or PORT is empty, the host
or port always match (the request's host or port is ignored). When
CONNECT-TO-HOST or CONNECT-TO-PORT is empty, the "connect to" feature is
disabled for the host or port, and the request's host or port are used to
establish the network connection.
This option is suitable to direct the request at a specific server, e.g. at a
specific cluster node in a cluster of servers.
The "connect to" host and port are only used to establish the network
connection. They do NOT affect the host and port that are used for TLS/SSL
(e.g. SNI, certificate verification) or for the application protocols.
In contrast to \fICURLOPT_RESOLVE(3)\fP, the option
\fICURLOPT_CONNECT_TO(3)\fP does not pre-populate the DNS cache and therefore
it does not affect future transfers of other easy handles that have been added
to the same multi handle.
The "connect to" host and port are ignored if they are equal to the host and
the port in the request URL, because connecting to the host and the port in
the request URL is the default behavior.
If an HTTP proxy is used for a request having a special "connect to" host or
port, and the "connect to" host or port differs from the request's host and
port, the HTTP proxy is automatically switched to tunnel mode for this
specific request. This is necessary because it is not possible to connect to a
specific host or port in normal (non-tunnel) mode.
When this option is passed to \fIcurl_easy_setopt(3)\fP, libcurl does not copy
the list so you \fBmust\fP keep it around until you no longer use this
\fIhandle\fP for a transfer before you call \fIcurl_slist_free_all(3)\fP on
the list.
.SH DEFAULT
NULL
.SH PROTOCOLS
All
.SH EXAMPLE
.nf
CURL *curl;
struct curl_slist *connect_to = NULL;
connect_to = curl_slist_append(NULL, "example.com::server1.example.com:");
curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_CONNECT_TO, connect_to);
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
curl_easy_perform(curl);
/* always cleanup */
curl_easy_cleanup(curl);
}
curl_slist_free_all(connect_to);
.fi
.SH AVAILABILITY
Added in 7.49.0
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR CURLOPT_FOLLOWLOCATION (3),
.BR CURLOPT_HTTPPROXYTUNNEL (3),
.BR CURLOPT_RESOLVE (3),
.BR CURLOPT_URL (3)
man/man3/CURLOPT_PROXY_SSLKEYTYPE.3 0000644 00000004725 14751172371 0012206 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_PROXY_SSLKEYTYPE 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_PROXY_SSLKEYTYPE \- type of the proxy private key file
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_PROXY_SSLKEYTYPE, char *type);
.fi
.SH DESCRIPTION
This option is for connecting to an HTTPS proxy, not an HTTPS server.
Pass a pointer to a null-terminated string as parameter. The string should be
the format of your private key. Supported formats are "PEM", "DER" and "ENG".
The application does not have to keep the string around after setting this
option.
.SH PROTOCOLS
Used with HTTPS proxy
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/");
curl_easy_setopt(curl, CURLOPT_PROXY, "https://proxy");
curl_easy_setopt(curl, CURLOPT_PROXY_SSLCERT, "client.pem");
curl_easy_setopt(curl, CURLOPT_PROXY_SSLKEY, "key.pem");
curl_easy_setopt(curl, CURLOPT_PROXY_SSLKEYTYPE, "PEM");
curl_easy_setopt(curl, CURLOPT_PROXY_KEYPASSWD, "s3cret");
ret = curl_easy_perform(curl);
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Added in 7.52.0
.SH RETURN VALUE
Returns CURLE_OK if TLS is supported, CURLE_UNKNOWN_OPTION if not, or
CURLE_OUT_OF_MEMORY if there was insufficient heap space.
.SH "SEE ALSO"
.BR CURLOPT_PROXY_SSLCERT (3),
.BR CURLOPT_PROXY_SSLKEY (3),
.BR CURLOPT_SSLKEYTYPE (3)
man/man3/curl_multi_socket_all.3 0000644 00000000035 14751172371 0012626 0 ustar 00 .so man3/curl_multi_socket.3
man/man3/curl_mime_filedata.3 0000644 00000006436 14751172371 0012067 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.TH curl_mime_filedata 3 "September 26, 2023" "libcurl 8.4.0" "libcurl"
.SH NAME
curl_mime_filedata - set a mime part's body data from a file contents
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_mime_filedata(curl_mimepart *part,
const char *filename);
.fi
.SH DESCRIPTION
\fIcurl_mime_filedata(3)\fP sets a mime part's body content from the named
file's contents. This is an alternative to \fIcurl_mime_data(3)\fP for setting
data to a mime part.
\fIpart\fP is the part's to assign contents to.
\fIfilename\fP points to the null-terminated file's path name. The pointer can
be NULL to detach the previous part contents settings. Filename storage can
be safely be reused after this call.
As a side effect, the part's remote file name is set to the base name of the
given \fIfilename\fP if it is a valid named file. This can be undone or
overridden by a subsequent call to \fIcurl_mime_filename(3)\fP.
The contents of the file is read during the file transfer in a streaming
manner to allow huge files to get transferred without using much memory. It
therefore requires that the file is kept intact during the entire request.
If the file size cannot be determined before actually reading it (such as for
a character device or named pipe), the whole mime structure containing the
part is transferred using chunks by HTTP but is rejected by IMAP.
Setting a part's contents multiple times is valid: only the value set by the
last call is retained.
.SH EXAMPLE
.nf
curl_mime *mime;
curl_mimepart *part;
/* create a mime handle */
mime = curl_mime_init(easy);
/* add a part */
part = curl_mime_addpart(mime);
/* send data from this file */
curl_mime_filedata(part, "image.png");
/* set name */
curl_mime_name(part, "data");
.fi
.SH AVAILABILITY
As long as at least one of HTTP, SMTP or IMAP is enabled. Added in 7.56.0.
.SH RETURN VALUE
CURLE_OK or a CURL error code upon failure. CURLE_READ_ERROR is only an
indication that the file is not yet readable: it can be safely ignored at
this time, but the file must be made readable before the pertaining
easy handle is performed.
.SH "SEE ALSO"
.BR curl_mime_addpart (3),
.BR curl_mime_data (3),
.BR curl_mime_filename (3),
.BR curl_mime_name (3)
man/man3/CURLOPT_PROXY_SERVICE_NAME.3 0000644 00000004453 14751172371 0012370 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_PROXY_SERVICE_NAME 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_PROXY_SERVICE_NAME \- proxy authentication service name
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_PROXY_SERVICE_NAME,
char *name);
.fi
.SH DESCRIPTION
Pass a char * as parameter to a string holding the \fIname\fP of the
service. The default service name is \fB"HTTP"\fP for HTTP based proxies and
\fB"rcmd"\fP for SOCKS5. This option allows you to change it.
The application does not have to keep the string around after setting this
option.
.SH DEFAULT
See above
.SH PROTOCOLS
All network protocols
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
CURLcode ret;
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/");
curl_easy_setopt(curl, CURLOPT_PROXY_SERVICE_NAME, "custom");
ret = curl_easy_perform(curl);
}
.fi
.SH AVAILABILITY
Added in 7.43.0 for HTTP proxies, 7.49.0 for SOCKS5 proxies.
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, CURLE_UNKNOWN_OPTION if not, or
CURLE_OUT_OF_MEMORY if there was insufficient heap space.
.SH "SEE ALSO"
.BR CURLOPT_PROXY (3),
.BR CURLOPT_PROXYTYPE (3),
.BR CURLOPT_SERVICE_NAME (3)
man/man3/CURLSHOPT_LOCKFUNC.3 0000644 00000005347 14751172371 0011131 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.TH CURLSHOPT_LOCKFUNC 3 "September 27, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLSHOPT_LOCKFUNC - mutex lock callback
.SH SYNOPSIS
.nf
#include <curl/curl.h>
void lockcb(CURL *handle, curl_lock_data data, curl_lock_access access,
void *clientp);
CURLSHcode curl_share_setopt(CURLSH *share, CURLSHOPT_LOCKFUNC, lockcb);
.fi
.SH DESCRIPTION
Set a mutex lock callback for the share object, to allow it to get used by
multiple threads concurrently. There is a corresponding
\fICURLSHOPT_UNLOCKFUNC(3)\fP callback called when the mutex is again released.
The \fIlockcb\fP argument must be a pointer to a function matching the
prototype shown above. The arguments to the callback are:
\fIhandle\fP is the currently active easy handle in use when the share object
is intended to get used.
The \fIdata\fP argument tells what kind of data libcurl wants to lock. Make
sure that the callback uses a different lock for each kind of data.
\fIaccess\fP defines what access type libcurl wants, shared or single.
\fIclientp\fP is the private pointer you set with \fICURLSHOPT_USERDATA(3)\fP.
This pointer is not used by libcurl itself.
.SH PROTOCOLS
All
.SH EXAMPLE
.nf
CURLSHcode sh;
share = curl_share_init();
sh = curl_share_setopt(share, CURLSHOPT_LOCKFUNC, mutex_lock);
if(sh)
printf("Error: %s\\n", curl_share_strerror(sh));
.fi
.SH AVAILABILITY
Added in 7.10
.SH RETURN VALUE
CURLSHE_OK (zero) means that the option was set properly, non-zero means an
error occurred. See \fIlibcurl-errors(3)\fP for the full list with
descriptions.
.SH "SEE ALSO"
.BR curl_share_cleanup (3),
.BR curl_share_init (3),
.BR curl_share_setopt (3),
.BR CURLSHOPT_UNLOCKFUNC (3)
man/man3/CURLINFO_SSL_ENGINES.3 0000644 00000004650 14751172371 0011370 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLINFO_SSL_ENGINES 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLINFO_SSL_ENGINES \- get an slist of OpenSSL crypto-engines
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_getinfo(CURL *handle, CURLINFO_SSL_ENGINES,
struct curl_slist **engine_list);
.fi
.SH DESCRIPTION
Pass the address of a 'struct curl_slist *' to receive a linked-list of
OpenSSL crypto-engines supported. Note that engines are normally implemented
in separate dynamic libraries. Hence not all the returned engines may be
available at runtime. \fBNOTE:\fP you must call \fIcurl_slist_free_all(3)\fP
on the list pointer once you are done with it, as libcurl does not free this
data for you.
.SH PROTOCOLS
All TLS based ones.
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
CURLcode res;
struct curl_slist *engines;
res = curl_easy_getinfo(curl, CURLINFO_SSL_ENGINES, &engines);
if((res == CURLE_OK) && engines) {
/* we have a list, free it when done using it */
curl_slist_free_all(engines);
}
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Added in 7.12.3. Available in OpenSSL builds with "engine" support.
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR curl_easy_getinfo (3),
.BR curl_easy_setopt (3),
.BR CURLOPT_SSLENGINE (3)
man/man3/CURLINFO_PRIMARY_IP.3 0000644 00000005044 14751172371 0011270 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLINFO_PRIMARY_IP 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLINFO_PRIMARY_IP \- get IP address of last connection
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_getinfo(CURL *handle, CURLINFO_PRIMARY_IP, char **ip);
.fi
.SH DESCRIPTION
Pass a pointer to a char pointer to receive the pointer to a null-terminated
string holding the IP address of the most recent connection done with this
\fBcurl\fP handle. This string may be IPv6 when that is enabled. Note that you
get a pointer to a memory area that is reused at next request so you need to
copy the string if you want to keep the information.
The \fBip\fP pointer is NULL or points to private memory. You MUST NOT free -
it gets freed when you call \fIcurl_easy_cleanup(3)\fP on the corresponding
CURL handle.
.SH PROTOCOLS
All network based ones
.SH EXAMPLE
.nf
{
char *ip;
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
/* Perform the transfer */
res = curl_easy_perform(curl);
/* Check for errors */
if((res == CURLE_OK) &&
!curl_easy_getinfo(curl, CURLINFO_PRIMARY_IP, &ip) && ip) {
printf("IP: %s\\n", ip);
}
/* always cleanup */
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Added in 7.19.0
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR curl_easy_getinfo (3),
.BR curl_easy_setopt (3),
.BR CURLINFO_LOCAL_IP (3),
.BR CURLINFO_LOCAL_PORT (3),
.BR CURLINFO_PRIMARY_PORT (3)
man/man3/CURLOPT_KRBLEVEL.3 0000644 00000004514 14751172371 0010673 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_KRBLEVEL 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_KRBLEVEL \- FTP kerberos security level
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_KRBLEVEL, char *level);
.fi
.SH DESCRIPTION
Pass a char * as parameter. Set the kerberos security level for FTP; this also
enables kerberos awareness. This is a string that should match one of the
following: \&'clear', \&'safe', \&'confidential' or \&'private'. If the string
is set but does not match one of these, 'private' is used. Set the string to
NULL to disable kerberos support for FTP.
The application does not have to keep the string around after setting this
option.
.SH DEFAULT
NULL
.SH PROTOCOLS
FTP
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "ftp://example.com/foo.bin");
curl_easy_setopt(curl, CURLOPT_KRBLEVEL, "private");
ret = curl_easy_perform(curl);
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
This option was known as CURLOPT_KRB4LEVEL up to 7.16.3
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, CURLE_UNKNOWN_OPTION if not, or
CURLE_OUT_OF_MEMORY if there was insufficient heap space.
.SH "SEE ALSO"
.BR CURLOPT_KRBLEVEL (3),
.BR CURLOPT_USE_SSL (3)
man/man3/CURLINFO_PRIVATE.3 0000644 00000004363 14751172371 0010672 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLINFO_PRIVATE 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLINFO_PRIVATE \- get the private pointer
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_getinfo(CURL *handle, CURLINFO_PRIVATE, char **private);
.fi
.SH DESCRIPTION
Pass a pointer to a char pointer to receive the pointer to the private data
associated with the curl handle (set with the \fICURLOPT_PRIVATE(3)\fP).
Please note that for internal reasons, the value is returned as a char
pointer, although effectively being a 'void *'.
.SH PROTOCOLS
All
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
void *pointer = 0x2345454;
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/foo.bin");
/* set the private pointer */
curl_easy_setopt(curl, CURLOPT_PRIVATE, pointer);
ret = curl_easy_perform(curl);
/* extract the private pointer again */
ret = curl_easy_getinfo(curl, CURLINFO_PRIVATE, &pointer);
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Added in 7.10.3
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR curl_easy_getinfo (3),
.BR curl_easy_setopt (3),
.BR CURLOPT_PRIVATE (3)
man/man3/curl_free.3 0000644 00000003554 14751172371 0010226 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.TH curl_free 3 "September 26, 2023" "libcurl 8.4.0" "libcurl"
.SH NAME
curl_free - reclaim memory that has been obtained through a libcurl call
.SH SYNOPSIS
.nf
#include <curl/curl.h>
void curl_free(void *ptr);
.fi
.SH DESCRIPTION
curl_free reclaims memory that has been obtained through a libcurl call. Use
\fIcurl_free(3)\fP instead of free() to avoid anomalies that can result from
differences in memory management between your application and libcurl.
Passing in a NULL pointer in \fIptr\fP makes this function return immediately
with no action.
.SH EXAMPLE
.nf
char *width = curl_getenv("COLUMNS");
if(width) {
/* it was set! */
curl_free(width);
}
.fi
.SH AVAILABILITY
Always
.SH RETURN VALUE
None
.SH "SEE ALSO"
.BR curl_easy_escape (3),
.BR curl_easy_unescape (3)
man/man3/CURLOPT_PROTOCOLS.3 0000644 00000006020 14751172371 0011043 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_PROTOCOLS 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_PROTOCOLS \- allowed protocols
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_PROTOCOLS, long bitmask);
.fi
.SH DESCRIPTION
This option is deprecated. We strongly recommend using
\fICURLOPT_PROTOCOLS_STR(3)\fP instead because this option cannot control all
available protocols!
Pass a long that holds a bitmask of CURLPROTO_* defines. If used, this bitmask
limits what protocols libcurl may use in the transfer. This allows you to have
a libcurl built to support a wide range of protocols but still limit specific
transfers to only be allowed to use a subset of them. By default libcurl
accepts all protocols it supports (\fICURLPROTO_ALL\fP). See also
\fICURLOPT_REDIR_PROTOCOLS(3)\fP.
These are the available protocol defines:
.nf
CURLPROTO_DICT
CURLPROTO_FILE
CURLPROTO_FTP
CURLPROTO_FTPS
CURLPROTO_GOPHER
CURLPROTO_HTTP
CURLPROTO_HTTPS
CURLPROTO_IMAP
CURLPROTO_IMAPS
CURLPROTO_LDAP
CURLPROTO_LDAPS
CURLPROTO_POP3
CURLPROTO_POP3S
CURLPROTO_RTMP
CURLPROTO_RTMPE
CURLPROTO_RTMPS
CURLPROTO_RTMPT
CURLPROTO_RTMPTE
CURLPROTO_RTMPTS
CURLPROTO_RTSP
CURLPROTO_SCP
CURLPROTO_SFTP
CURLPROTO_SMB
CURLPROTO_SMBS
CURLPROTO_SMTP
CURLPROTO_SMTPS
CURLPROTO_TELNET
CURLPROTO_TFTP
.fi
.SH DEFAULT
All protocols built-in.
.SH PROTOCOLS
All
.SH EXAMPLE
.nf
curl = curl_easy_init();
if(curl) {
/* pass in the URL from an external source */
curl_easy_setopt(curl, CURLOPT_URL, argv[1]);
/* only allow HTTP, TFTP and SFTP */
curl_easy_setopt(curl, CURLOPT_PROTOCOLS,
CURLPROTO_HTTP | CURLPROTO_TFTP | CURLPROTO_SFTP);
/* Perform the request */
curl_easy_perform(curl);
}
.fi
.SH AVAILABILITY
Added in 7.19.4. Deprecated since 7.85.0.
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR CURLOPT_DEFAULT_PROTOCOL (3),
.BR CURLOPT_REDIR_PROTOCOLS (3),
.BR CURLOPT_URL (3)
man/man3/CURLOPT_COOKIELIST.3 0000644 00000011146 14751172371 0011131 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_COOKIELIST 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_COOKIELIST \- add to or manipulate cookies held in memory
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_COOKIELIST,
char *cookie);
.SH DESCRIPTION
Pass a char * to a \fIcookie\fP string.
Such a cookie can be either a single line in Netscape / Mozilla format or just
regular HTTP-style header (Set-Cookie: ...) format. This option also enables
the cookie engine. This adds that single cookie to the internal cookie store.
We strongly advice against loading cookies from a HTTP header file, as that is
an inferior data exchange format.
Exercise caution if you are using this option and multiple transfers may
occur. If you use the Set-Cookie format and the string does not specify a
domain, then the cookie is sent for any domain (even after redirects are
followed) and cannot be modified by a server-set cookie. If a server sets a
cookie of the same name (or maybe you have imported one) then both are sent on
future transfers to that server, likely not what you intended. To address
these issues set a domain in Set-Cookie (doing that includes subdomains) or
much better: use the Netscape file format.
Additionally, there are commands available that perform actions if you pass in
these exact strings:
.IP ALL
erases all cookies held in memory
.IP SESS
erases all session cookies held in memory
.IP FLUSH
writes all known cookies to the file specified by \fICURLOPT_COOKIEJAR(3)\fP
.IP RELOAD
loads all cookies from the files specified by \fICURLOPT_COOKIEFILE(3)\fP
.SH DEFAULT
NULL
.SH PROTOCOLS
HTTP
.SH EXAMPLE
.nf
/* an inline import of a cookie in Netscape format. */
#define SEP "\\t" /* Tab separates the fields */
char *my_cookie =
"example.com" /* Hostname */
SEP "FALSE" /* Include subdomains */
SEP "/" /* Path */
SEP "FALSE" /* Secure */
SEP "0" /* Expiry in epoch time format. 0 == Session */
SEP "foo" /* Name */
SEP "bar"; /* Value */
/* my_cookie is imported immediately via CURLOPT_COOKIELIST. */
curl_easy_setopt(curl, CURLOPT_COOKIELIST, my_cookie);
/* The list of cookies in cookies.txt are not be imported until right
before a transfer is performed. Cookies in the list that have the same
hostname, path and name as in my_cookie are skipped. That is because
libcurl has already imported my_cookie and it's considered a "live"
cookie. A live cookie is not replaced by one read from a file.
*/
curl_easy_setopt(curl, CURLOPT_COOKIEFILE, "cookies.txt"); /* import */
/* Cookies are exported after curl_easy_cleanup is called. The server
may have added, deleted or modified cookies by then. The cookies that
were skipped on import are not exported.
*/
curl_easy_setopt(curl, CURLOPT_COOKIEJAR, "cookies.txt"); /* export */
curl_easy_perform(curl); /* cookies imported from cookies.txt */
curl_easy_cleanup(curl); /* cookies exported to cookies.txt */
.fi
.SH "Cookie file format"
The cookie file format and general cookie concepts in curl are described
online here: https://curl.se/docs/http-cookies.html
.SH AVAILABILITY
\fBALL\fP was added in 7.14.1
\fBSESS\fP was added in 7.15.4
\fBFLUSH\fP was added in 7.17.1
\fBRELOAD\fP was added in 7.39.0
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, CURLE_UNKNOWN_OPTION if not, or
CURLE_OUT_OF_MEMORY if there was insufficient heap space.
.SH "SEE ALSO"
.BR CURLINFO_COOKIELIST (3),
.BR CURLOPT_COOKIE (3),
.BR CURLOPT_COOKIEFILE (3),
.BR CURLOPT_COOKIEJAR (3)
man/man3/CURLOPT_PROXY_TLSAUTH_USERNAME.3 0000644 00000005160 14751172371 0013107 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_PROXY_TLSAUTH_USERNAME 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_PROXY_TLSAUTH_USERNAME \- user name to use for proxy TLS authentication
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_PROXY_TLSAUTH_USERNAME,
char *user);
.fi
.SH DESCRIPTION
Pass a char * as parameter, which should point to the null-terminated username
to use for the HTTPS proxy TLS authentication method specified with the
\fICURLOPT_PROXY_TLSAUTH_TYPE(3)\fP option. Requires that the
\fICURLOPT_PROXY_TLSAUTH_PASSWORD(3)\fP option also be set.
The application does not have to keep the string around after setting this
option.
.SH DEFAULT
NULL
.SH PROTOCOLS
All
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/");
curl_easy_setopt(curl, CURLOPT_PROXY, "https://proxy");
curl_easy_setopt(curl, CURLOPT_PROXY_TLSAUTH_TYPE, "SRP");
curl_easy_setopt(curl, CURLOPT_PROXY_TLSAUTH_USERNAME, "user");
curl_easy_setopt(curl, CURLOPT_PROXY_TLSAUTH_PASSWORD, "secret");
ret = curl_easy_perform(curl);
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Added in 7.52.0, with the OpenSSL and GnuTLS backends only.
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, CURLE_UNKNOWN_OPTION if not, or
CURLE_OUT_OF_MEMORY if there was insufficient heap space.
.SH "SEE ALSO"
.BR CURLOPT_PROXY_TLSAUTH_PASSWORD (3),
.BR CURLOPT_PROXY_TLSAUTH_TYPE (3),
.BR CURLOPT_TLSAUTH_PASSWORD (3),
.BR CURLOPT_TLSAUTH_TYPE (3)
man/man3/CURLOPT_HTTP200ALIASES.3 0000644 00000005435 14751172371 0011473 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_HTTP200ALIASES 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_HTTP200ALIASES \- alternative matches for HTTP 200 OK
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_HTTP200ALIASES,
struct curl_slist *aliases);
.SH DESCRIPTION
Pass a pointer to a linked list of \fIaliases\fP to be treated as valid HTTP
200 responses. Some servers respond with a custom header response line. For
example, SHOUTcast servers respond with "ICY 200 OK". Also some old Icecast
1.3.x servers respond like that for certain user agent headers or in absence
of such. By including this string in your list of aliases, the response gets
treated as a valid HTTP header line such as "HTTP/1.0 200 OK".
The linked list should be a fully valid list of struct curl_slist structs, and
be properly filled in. Use \fIcurl_slist_append(3)\fP to create the list and
\fIcurl_slist_free_all(3)\fP to clean up an entire list.
The alias itself is not parsed for any version strings. The protocol is
assumed to match HTTP 1.0 when an alias match.
.SH DEFAULT
NULL
.SH PROTOCOLS
HTTP
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
struct curl_slist *list;
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
list = curl_slist_append(NULL, "ICY 200 OK");
list = curl_slist_append(list, "WEIRDO 99 FINE");
curl_easy_setopt(curl, CURLOPT_HTTP200ALIASES, list);
curl_easy_perform(curl);
curl_slist_free_all(list); /* free the list again */
}
.fi
.SH AVAILABILITY
Added in 7.10.3
.SH RETURN VALUE
Returns CURLE_OK if HTTP is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR CURLOPT_HTTP09_ALLOWED (3),
.BR CURLOPT_HTTP_VERSION (3)
man/man3/CURLINFO_CONTENT_TYPE.3 0000644 00000005055 14751172371 0011532 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLINFO_CONTENT_TYPE 3 "September 26, 2023" "libcurl 8.4.0" "libcurl"
.SH NAME
CURLINFO_CONTENT_TYPE \- get Content-Type
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_getinfo(CURL *handle, CURLINFO_CONTENT_TYPE, char **ct);
.fi
.SH DESCRIPTION
Pass a pointer to a char pointer to receive the content-type of the downloaded
object. This is the value read from the Content-Type: field. If you get NULL,
it means that the server did not send a valid Content-Type header or that the
protocol used does not support this.
The \fBct\fP pointer is set to NULL or pointing to private memory. You MUST
NOT free it - it gets freed when you call \fIcurl_easy_cleanup(3)\fP on the
corresponding CURL handle.
The modern way to get this header from a response is to instead use the
\fIcurl_easy_header(3)\fP function.
.SH PROTOCOLS
HTTP(S)
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
res = curl_easy_perform(curl);
if(!res) {
/* extract the content-type */
char *ct = NULL;
res = curl_easy_getinfo(curl, CURLINFO_CONTENT_TYPE, &ct);
if(!res && ct) {
printf("Content-Type: %s\\n", ct);
}
}
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Added in 7.9.4
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR curl_easy_getinfo (3),
.BR curl_easy_header (3),
.BR curl_easy_setopt (3),
.BR CURLOPT_HEADERFUNCTION (3)
man/man3/CURLOPT_SSL_EC_CURVES.3 0000644 00000004177 14751172371 0011571 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_SSL_EC_CURVES 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_SSL_EC_CURVES \- key exchange curves
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_SSL_EC_CURVES, char *alg_list);
.fi
.SH DESCRIPTION
Pass a string as parameter with a colon delimited list of (EC) algorithms. This
option defines the client's key exchange algorithms in the SSL handshake (if
the SSL backend libcurl is built to use supports it).
.SH DEFAULT
"", embedded in SSL backend
.SH PROTOCOLS
HTTP
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/");
curl_easy_setopt(curl, CURLOPT_SSL_EC_CURVES, "X25519:P-521");
ret = curl_easy_perform(curl);
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Added in 7.73.0. Supported by the OpenSSL backend.
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR CURLOPT_SSL_OPTIONS (3),
.BR CURLOPT_SSL_CIPHER_LIST (3),
.BR CURLOPT_TLS13_CIPHERS (3)
man/man3/libcurl-env-dbg.3 0000644 00000010263 14751172371 0011227 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.TH libcurl-env-dbg 3 "September 07, 2023" "libcurl 8.4.0" "libcurl"
.SH NAME
libcurl-env-dbg \- environment variables libcurl DEBUGBUILD understands
.SH DESCRIPTION
This is a set of variables only recognized and used if libcurl was built
"debug enabled", which should never be true for a library used in production.
These variables are intended for internal use only, subject to change and have
many effects on the behavior of libcurl. Refer to the source code to determine
how exactly they are being used.
.RS
.IP "CURL_ALTSVC_HTTP"
Bypass the AltSvc HTTPS protocol restriction if this variable exists.
.IP "CURL_DBG_SOCK_RBLOCK"
The percentage of recv() calls that should be answered with a EAGAIN at random.
For TCP/UNIX sockets.
.IP "CURL_DBG_SOCK_RMAX"
The maximum data that shall be received from the network in one recv() call.
For TCP/UNIX sockets. This is applied to every recv.
Example: \fBCURL_DBG_SOCK_RMAX=400\fP means recv buffer size is limited to a
maximum of 400 bytes.
.IP "CURL_DBG_SOCK_WBLOCK"
The percentage of send() calls that should be answered with a EAGAIN at random.
For TCP/UNIX sockets.
.IP "CURL_DBG_SOCK_WPARTIAL"
The percentage of data that shall be written to the network. For TCP/UNIX
sockets. This is applied to every send.
Example: \fBCURL_DBG_SOCK_WPARTIAL=80\fP means a send with 1000 bytes would
only send 800.
.IP "CURL_DBG_QUIC_WBLOCK"
The percentage of send() calls that should be answered with EAGAIN at random.
QUIC only.
.IP "CURL_DEBUG"
Trace logging behavior as an alternative to calling \fIcurl_global_trace(3)\fP.
Example: \fBCURL_DEBUG=http/2\fP means trace details about HTTP/2 handling.
.IP "CURL_DEBUG_SIZE"
Fake the size returned by CURLINFO_HEADER_SIZE and CURLINFO_REQUEST_SIZE.
.IP "CURL_GETHOSTNAME"
Fake the local machine's unqualified hostname for NTLM and SMTP.
.IP "CURL_HSTS_HTTP"
Bypass the HSTS HTTPS protocol restriction if this variable exists.
.IP "CURL_FORCETIME"
A time of 0 is used for AWS signatures and NTLM if this variable exists.
.IP "CURL_ENTROPY"
A fixed faked value to use instead of a proper random number so that functions
in libcurl that are otherwise getting random outputs can be tested for what
they generate.
.IP "CURL_SMALLREQSEND"
An alternative size of HTTP data to be sent at a time only if smaller than the
current.
.IP "CURL_SMALLSENDS"
An alternative size of socket data to be sent at a time only if smaller than
the current.
.IP "CURL_TIME"
Fake unix timestamp to use for AltSvc, HSTS and CURLINFO variables that are
time related.
This variable can also be used to fake the data returned by some CURLINFO
variables that are not time-related (such as CURLINFO_LOCAL_PORT), and in that
case the value is not a timestamp.
.IP "CURL_TRACE"
LDAP tracing is enabled if this variable exists and its value is 1 or greater.
OpenLDAP tracing is separate. Refer to CURL_OPENLDAP_TRACE.
.IP "CURL_NTLM_WB_FILE"
Debug-version of the \fIntlm-wb\fP executable.
.IP "CURL_OPENLDAP_TRACE"
OpenLDAP tracing is enabled if this variable exists and its value is 1 or
greater. There's a number of debug levels, refer to \fIopenldap.c\fP comments.
.RE
.SH "SEE ALSO"
.BR libcurl-env (3)
man/man3/CURLINFO_LOCAL_PORT.3 0000644 00000004260 14751172371 0011252 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLINFO_LOCAL_PORT 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLINFO_LOCAL_PORT \- get the latest local port number
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_getinfo(CURL *handle, CURLINFO_LOCAL_PORT, long *portp);
.fi
.SH DESCRIPTION
Pass a pointer to a long to receive the local port number of the most recent
connection done with this \fBcurl\fP handle.
.SH PROTOCOLS
All
.SH EXAMPLE
.nf
{
CURL *curl;
CURLcode res;
curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/");
res = curl_easy_perform(curl);
if(CURLE_OK == res) {
long port;
res = curl_easy_getinfo(curl, CURLINFO_LOCAL_PORT, &port);
if(CURLE_OK == res) {
printf("We used local port: %ld\\n", port);
}
}
curl_easy_cleanup(curl);
}
return 0;
}
.fi
.SH AVAILABILITY
Added in 7.21.0
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR curl_easy_getinfo (3),
.BR curl_easy_setopt (3),
.BR CURLINFO_LOCAL_IP (3),
.BR CURLINFO_PRIMARY_PORT (3)
man/man3/curl_easy_pause.3 0000644 00000013307 14751172371 0011440 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.TH curl_easy_pause 3 "October 06, 2023" "libcurl 8.4.0" "libcurl"
.SH NAME
curl_easy_pause - pause and unpause a connection
.SH SYNOPSIS
.nf
.B #include <curl/curl.h>
.BI "CURLcode curl_easy_pause(CURL *"handle ", int "bitmask ");"
.fi
.SH DESCRIPTION
Using this function, you can explicitly mark a running connection to get
paused, and you can unpause a connection that was previously paused. Unlike
most other libcurl functions, \fIcurl_easy_pause(3)\fP can be used from within
callbacks.
A connection can be paused by using this function or by letting the read or
the write callbacks return the proper magic return code
(\fICURL_READFUNC_PAUSE\fP and \fICURL_WRITEFUNC_PAUSE\fP). A write callback
that returns pause signals to the library that it could not take care of any
data at all, and that data is then delivered again to the callback when the
transfer is unpaused.
While it may feel tempting, take care and notice that you cannot call this
function from another thread. To unpause, you may for example call it from the
progress callback (\fICURLOPT_PROGRESSFUNCTION(3)\fP).
When this function is called to unpause receiving, the write callback might
get called before this function returns to deliver cached content. When
libcurl delivers such cached data to the write callback, it is delivered as
fast as possible, which may overstep the boundary set in
\fICURLOPT_MAX_RECV_SPEED_LARGE(3)\fP etc.
The \fBhandle\fP argument identifies the transfer you want to pause or
unpause.
A paused transfer is excluded from low speed cancels via the
\fICURLOPT_LOW_SPEED_LIMIT(3)\fP option and unpausing a transfer resets the
time period required for the low speed limit to be met.
The \fBbitmask\fP argument is a set of bits that sets the new state of the
connection. The following bits can be used:
.IP CURLPAUSE_RECV
Pause receiving data. There is no data received on this connection until this
function is called again without this bit set. Thus, the write callback
(\fICURLOPT_WRITEFUNCTION(3)\fP) is not called.
.IP CURLPAUSE_SEND
Pause sending data. There is no data sent on this connection until this
function is called again without this bit set. Thus, the read callback
(\fICURLOPT_READFUNCTION(3)\fP) is not called.
.IP CURLPAUSE_ALL
Convenience define that pauses both directions.
.IP CURLPAUSE_CONT
Convenience define that unpauses both directions.
.SH LIMITATIONS
The pausing of transfers does not work with protocols that work without
network connectivity, like FILE://. Trying to pause such a transfer, in any
direction, might cause problems or error.
.SH MULTIPLEXED
When a connection is used multiplexed, like for HTTP/2, and one of the
transfers over the connection is paused and the others continue flowing,
libcurl might end up buffering contents for the paused transfer. It has to do
this because it needs to drain the socket for the other transfers and the
already announced window size for the paused transfer allows the server to
continue sending data up to that window size amount. By default, libcurl
announces a 32 megabyte window size, which thus can make libcurl end up
buffering 32 megabyte of data for a paused stream.
When such a paused stream is unpaused again, any buffered data is delivered
first.
.SH EXAMPLE
.nf
/* pause a transfer in both directions */
curl_easy_pause(curl, CURL_READFUNC_PAUSE | CURL_WRITEFUNC_PAUSE);
.fi
.SH "MEMORY USE"
When pausing a download transfer by returning the magic return code from a
write callback, the read data is already in libcurl's internal buffers so it
has to keep it in an allocated buffer until the receiving is again unpaused
using this function.
If the downloaded data is compressed and is asked to get uncompressed
automatically on download, libcurl continues to uncompress the entire
downloaded chunk and it caches the data uncompressed. This has the side-
effect that if you download something that is compressed a lot, it can result
in a large data amount needing to be allocated to save the data during the
pause. consider not using paused receiving if you allow libcurl to uncompress
data automatically.
If the download is done with HTTP/2 or HTTP/3, there is up to a stream window
size worth of data that curl cannot stop but instead needs to cache while the
transfer is paused. This means that if a window size of 64 MB is used, libcurl
might end up having to cache 64 MB of data.
.SH AVAILABILITY
Added in 7.18.0.
.SH RETURN VALUE
CURLE_OK (zero) means that the option was set properly, and a non-zero return
code means something wrong occurred after the new state was set. See the
\fIlibcurl-errors(3)\fP man page for the full list with descriptions.
.SH "SEE ALSO"
.BR curl_easy_cleanup (3),
.BR curl_easy_reset (3)
man/man3/CURLOPT_PIPEWAIT.3 0000644 00000005620 14751172371 0010706 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_PIPEWAIT 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_PIPEWAIT \- wait for multiplexing
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_PIPEWAIT, long wait);
.fi
.SH DESCRIPTION
Set \fIwait\fP to 1L to tell libcurl to prefer to wait for a connection to
confirm or deny that it can do multiplexing before continuing.
When about to perform a new transfer that allows multiplexing, libcurl checks
for existing connections to use. If no such connection exists it immediately
continues and creates a fresh new connection to use.
By setting this option to 1 - and having \fICURLMOPT_PIPELINING(3)\fP enabled
for the multi handle this transfer is associated with - libcurl instead waits
for the connection to reveal if it is possible to multiplex on before it
continues. This enables libcurl to much better keep the number of connections
to a minimum when using multiplexing protocols.
With this option set, libcurl prefers to wait and reuse an existing connection
for multiplexing rather than the opposite: prefer to open a new connection
rather than waiting.
The waiting time is as long as it takes for the connection to get up and for
libcurl to get the necessary response back that informs it about its protocol
and support level.
.SH DEFAULT
0 (off)
.SH PROTOCOLS
HTTP(S)
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/");
curl_easy_setopt(curl, CURLOPT_PIPEWAIT, 1L);
/* now add this easy handle to the multi handle */
}
.fi
.SH AVAILABILITY
Added in 7.43.0
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR CURLMOPT_MAX_HOST_CONNECTIONS (3),
.BR CURLMOPT_PIPELINING (3),
.BR CURLOPT_FORBID_REUSE (3),
.BR CURLOPT_FRESH_CONNECT (3)
man/man3/CURLOPT_INFILESIZE_LARGE.3 0000644 00000005162 14751172371 0012040 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_INFILESIZE_LARGE 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_INFILESIZE_LARGE \- size of the input file to send off
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_INFILESIZE_LARGE,
curl_off_t filesize);
.SH DESCRIPTION
When uploading a file to a remote site, \fIfilesize\fP should be used to tell
libcurl what the expected size of the input file is. This value must be passed
as a \fBcurl_off_t\fP.
For uploading using SCP, this option or \fICURLOPT_INFILESIZE(3)\fP is
mandatory.
To unset this value again, set it to -1.
When sending emails using SMTP, this command can be used to specify the
optional SIZE parameter for the MAIL FROM command.
This option does not limit how much data libcurl actually sends, as that is
controlled entirely by what the read callback returns, but telling one value
and sending a different amount may lead to errors.
.SH DEFAULT
Unset
.SH PROTOCOLS
Many
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_off_t uploadsize = FILE_SIZE;
curl_easy_setopt(curl, CURLOPT_URL, "ftp://example.com/destination.tar.gz");
curl_easy_setopt(curl, CURLOPT_UPLOAD, 1L);
curl_easy_setopt(curl, CURLOPT_INFILESIZE_LARGE, uploadsize);
curl_easy_perform(curl);
}
.fi
.SH AVAILABILITY
SMTP support added in 7.23.0
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR CURLINFO_CONTENT_LENGTH_UPLOAD_T (3),
.BR CURLOPT_INFILESIZE (3),
.BR CURLOPT_UPLOAD (3)
man/man3/CURLINFO_RTSP_SESSION_ID.3 0000644 00000004457 14751172371 0012133 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLINFO_RTSP_SESSION_ID 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLINFO_RTSP_SESSION_ID \- get RTSP session ID
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_getinfo(CURL *handle, CURLINFO_RTSP_SESSION_ID, char **id);
.fi
.SH DESCRIPTION
Pass a pointer to a char pointer to receive a pointer to a string holding the
most recent RTSP Session ID.
Applications wishing to resume an RTSP session on another connection should
retrieve this info before closing the active connection.
The \fBid\fP pointer is NULL or points to private memory. You MUST NOT free -
it gets freed when you call \fIcurl_easy_cleanup(3)\fP on the corresponding
CURL handle.
.SH PROTOCOLS
RTSP
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
CURLcode res;
curl_easy_setopt(curl, CURLOPT_URL, "rtsp://rtsp.example.com");
res = curl_easy_perform(curl);
if(res == CURLE_OK) {
char *id;
curl_easy_getinfo(curl, CURLINFO_RTSP_SESSION_ID, &id);
}
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Added in 7.20.0
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR curl_easy_getinfo (3),
.BR curl_easy_setopt (3),
.BR CURLINFO_RTSP_CSEQ_RECV (3)
man/man3/CURLINFO_ACTIVESOCKET.3 0000644 00000005550 14751172371 0011443 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLINFO_ACTIVESOCKET 3 "September 26, 2023" "libcurl 8.4.0" "libcurl"
.SH NAME
CURLINFO_ACTIVESOCKET \- get the active socket
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_getinfo(CURL *handle, CURLINFO_ACTIVESOCKET,
curl_socket_t *socket);
.fi
.SH DESCRIPTION
Pass a pointer to a curl_socket_t to receive the most recently active socket
used for the transfer connection by this curl session. If the socket is no
longer valid, \fICURL_SOCKET_BAD\fP is returned. When you are finished working
with the socket, you must call \fIcurl_easy_cleanup(3)\fP as usual on the easy
handle and let libcurl close the socket and cleanup other resources associated
with the handle. This option returns the active socket only after the transfer
is complete, and is typically used in combination with
\fICURLOPT_CONNECT_ONLY(3)\fP, which skips the transfer phase.
\fICURLINFO_ACTIVESOCKET(3)\fP was added as a replacement for
\fICURLINFO_LASTSOCKET(3)\fP since that one is not working on all platforms.
.SH PROTOCOLS
All
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_socket_t sockfd;
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
/* Do not do the transfer - only connect to host */
curl_easy_setopt(curl, CURLOPT_CONNECT_ONLY, 1L);
res = curl_easy_perform(curl);
/* Extract the socket from the curl handle */
res = curl_easy_getinfo(curl, CURLINFO_ACTIVESOCKET, &sockfd);
if(res != CURLE_OK) {
printf("Error: %s\\n", curl_easy_strerror(res));
return 1;
}
}
.fi
.SH AVAILABILITY
Added in 7.45.0
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR curl_easy_getinfo (3),
.BR curl_easy_setopt (3),
.BR CURLINFO_LASTSOCKET (3),
.BR CURLOPT_CONNECT_ONLY (3)
man/man3/CURLINFO_EFFECTIVE_URL.3 0000644 00000004557 14751172371 0011607 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLINFO_EFFECTIVE_URL 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLINFO_EFFECTIVE_URL \- get the last used URL
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_getinfo(CURL *handle, CURLINFO_EFFECTIVE_URL, char **urlp);
.fi
.SH DESCRIPTION
Pass in a pointer to a char pointer and get the last used effective URL.
In cases when you have asked libcurl to follow redirects, it may not be the same
value you set with \fICURLOPT_URL(3)\fP.
The \fBurlp\fP pointer is NULL or points to private memory. You MUST NOT free
- it gets freed when you call \fIcurl_easy_cleanup(3)\fP on the corresponding
CURL handle.
.SH PROTOCOLS
HTTP(S)
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
CURLcode res;
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
curl_easy_setopt(curl, CURLOPT_FOLLOWLOCATION, 1L);
res = curl_easy_perform(curl);
if(res == CURLE_OK) {
char *url = NULL;
curl_easy_getinfo(curl, CURLINFO_EFFECTIVE_URL, &url);
if(url)
printf("Redirect to: %s\\n", url);
}
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Added in 7.4
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR curl_easy_getinfo (3),
.BR curl_easy_setopt (3),
.BR CURLOPT_FOLLOWLOCATION (3)
man/man3/curl_slist_free_all.3 0000644 00000003605 14751172371 0012271 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.TH curl_slist_free_all 3 "September 26, 2023" "libcurl 8.4.0" "libcurl"
.SH NAME
curl_slist_free_all - free an entire curl_slist list
.SH SYNOPSIS
.nf
#include <curl/curl.h>
void curl_slist_free_all(struct curl_slist *list);
.fi
.SH DESCRIPTION
curl_slist_free_all() removes all traces of a previously built curl_slist
linked list.
Passing in a NULL pointer in \fIlist\fP makes this function return immediately
with no action.
.SH EXAMPLE
.nf
CURL *handle;
struct curl_slist *slist=NULL;
slist = curl_slist_append(slist, "X-libcurl: coolness");
if (slist == NULL)
return -1;
curl_easy_setopt(handle, CURLOPT_HTTPHEADER, slist);
curl_easy_perform(handle);
curl_slist_free_all(slist); /* free the list again */
.fi
.SH AVAILABILITY
Always
.SH RETURN VALUE
Nothing.
.SH "SEE ALSO"
.BR curl_slist_append (3)
man/man3/curl_easy_escape.3 0000644 00000005741 14751172371 0011566 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH curl_easy_escape 3 "September 26, 2023" "libcurl 8.4.0" "libcurl"
.SH NAME
curl_easy_escape - URL encodes the given string
.SH SYNOPSIS
.nf
#include <curl/curl.h>
char *curl_easy_escape(CURL *curl, const char *string, int length);
.fi
.SH DESCRIPTION
This function converts the given input \fIstring\fP to a URL encoded string
and returns that as a new allocated string. All input characters that are not
a-z, A-Z, 0-9, '-', '.', '_' or '~' are converted to their "URL escaped"
version (\fB%NN\fP where \fBNN\fP is a two-digit hexadecimal number).
If \fIlength\fP is set to 0 (zero), \fIcurl_easy_escape(3)\fP uses strlen() on
the input \fIstring\fP to find out the size. This function does not accept
input strings longer than \fBCURL_MAX_INPUT_LENGTH\fP (8 MB).
Since 7.82.0, the \fBcurl\fP parameter is ignored. Prior to that there was
per-handle character conversion support for some old operating systems such as
TPF, but it was otherwise ignored.
You must \fIcurl_free(3)\fP the returned string when you are done with it.
.SH ENCODING
libcurl is typically not aware of, nor does it care about, character
encodings. \fIcurl_easy_escape(3)\fP encodes the data byte-by-byte into the
URL encoded version without knowledge or care for what particular character
encoding the application or the receiving server may assume that the data
uses.
The caller of \fIcurl_easy_escape(3)\fP must make sure that the data passed in
to the function is encoded correctly.
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
char *output = curl_easy_escape(curl, "data to convert", 15);
if(output) {
printf("Encoded: %s\\n", output);
curl_free(output);
}
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Added in 7.15.4 and replaces the old \fIcurl_escape(3)\fP function.
.SH RETURN VALUE
A pointer to a null-terminated string or NULL if it failed.
.SH "SEE ALSO"
.BR curl_easy_unescape (3),
.BR curl_free (3)
man/man3/CURLOPT_HSTS.3 0000644 00000005641 14751172371 0010250 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_HSTS 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_HSTS \- HSTS cache file name
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_HSTS, char *filename);
.fi
.SH DESCRIPTION
Make the \fIfilename\fP point to a file name to load an existing HSTS cache
from, and to store the cache in when the easy handle is closed. Setting a file
name with this option also enables HSTS for this handle (the equivalent of
setting \fICURLHSTS_ENABLE\fP with \fICURLOPT_HSTS_CTRL(3)\fP).
If the given file does not exist or contains no HSTS entries at startup, the
HSTS cache simply starts empty. Setting the file name to NULL or "" only
enables HSTS without reading from or writing to any file.
If this option is set multiple times, libcurl loads cache entries from each
given file but only stores the last used name for later writing.
.SH "FILE FORMAT"
The HSTS cache is saved to and loaded from a text file with one entry per
physical line. Each line in the file has the following format:
[host] [stamp]
[host] is the domain name for the entry and the name is dot-prefixed if it is
an entry valid for all subdomains to the name as well or only for the exact
name.
[stamp] is the time (in UTC) when the entry expires and it uses the format
\&"YYYYMMDD HH:MM:SS".
Lines starting with "#" are treated as comments and are ignored. There is
currently no length or size limit.
.SH DEFAULT
NULL, no file name
.SH PROTOCOLS
HTTPS and HTTP
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_HSTS, "/home/user/.hsts-cache");
curl_easy_perform(curl);
}
.fi
.SH AVAILABILITY
Added in 7.74.0
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR CURLOPT_ALTSVC (3),
.BR CURLOPT_HSTS_CTRL (3),
.BR CURLOPT_RESOLVE (3)
man/man3/CURLINFO_NAMELOOKUP_TIME_T.3 0000644 00000004611 14751172371 0012327 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLINFO_NAMELOOKUP_TIME_T 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLINFO_NAMELOOKUP_TIME_T \- get the name lookup time in microseconds
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_getinfo(CURL *handle, CURLINFO_NAMELOOKUP_TIME_T,
curl_off_t *timep);
.fi
.SH DESCRIPTION
Pass a pointer to a curl_off_t to receive the total time in microseconds
from the start until the name resolving was completed.
When a redirect is followed, the time from each request is added together.
See also the TIMES overview in the \fIcurl_easy_getinfo(3)\fP man page.
.SH PROTOCOLS
All
.SH EXAMPLE
.nf
curl = curl_easy_init();
if(curl) {
curl_off_t namelookup;
curl_easy_setopt(curl, CURLOPT_URL, url);
res = curl_easy_perform(curl);
if(CURLE_OK == res) {
res = curl_easy_getinfo(curl, CURLINFO_NAMELOOKUP_TIME_T, &namelookup);
if(CURLE_OK == res) {
printf("Time: %" CURL_FORMAT_CURL_OFF_T ".%06ld", namelookup / 1000000,
(long)(namelookup % 1000000));
}
}
/* always cleanup */
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Added in 7.61.0
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR curl_easy_getinfo (3),
.BR curl_easy_setopt (3),
.BR CURLINFO_NAMELOOKUP_TIME (3)
man/man3/CURLINFO_CONTENT_LENGTH_UPLOAD_T.3 0000644 00000004323 14751172371 0013256 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLINFO_CONTENT_LENGTH_UPLOAD_T 3 "September 26, 2023" "libcurl 8.4.0" "libcurl"
.SH NAME
CURLINFO_CONTENT_LENGTH_UPLOAD_T \- get the specified size of the upload
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_getinfo(CURL *handle, CURLINFO_CONTENT_LENGTH_UPLOAD_T,
curl_off_t *content_length);
.fi
.SH DESCRIPTION
Pass a pointer to a \fIcurl_off_t\fP to receive the specified size of the
upload. Stores -1 if the size is not known.
.SH PROTOCOLS
All
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
/* Perform the upload */
res = curl_easy_perform(curl);
if(!res) {
/* check the size */
curl_off_t cl;
res = curl_easy_getinfo(curl, CURLINFO_CONTENT_LENGTH_UPLOAD_T, &cl);
if(!res) {
printf("Upload size: %" CURL_FORMAT_CURL_OFF_T "\\n", cl);
}
}
}
.fi
.SH AVAILABILITY
Added in 7.55.0
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR curl_easy_getinfo (3),
.BR curl_easy_setopt (3),
.BR CURLINFO_CONTENT_LENGTH_DOWNLOAD_T (3)
man/man3/CURLINFO_SPEED_DOWNLOAD_T.3 0000644 00000004305 14751172371 0012166 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLINFO_SPEED_DOWNLOAD_T 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLINFO_SPEED_DOWNLOAD_T \- get download speed
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_getinfo(CURL *handle, CURLINFO_SPEED_DOWNLOAD_T,
curl_off_t *speed);
.fi
.SH DESCRIPTION
Pass a pointer to a \fIcurl_off_t\fP to receive the average download speed
that curl measured for the complete download. Measured in bytes/second.
.SH PROTOCOLS
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
/* Perform the request */
res = curl_easy_perform(curl);
if(!res) {
curl_off_t speed;
res = curl_easy_getinfo(curl, CURLINFO_SPEED_DOWNLOAD_T, &speed);
if(!res) {
printf("Download speed %" CURL_FORMAT_CURL_OFF_T " bytes/sec\\n", speed);
}
}
}
.fi
.SH AVAILABILITY
Added in 7.55.0
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR curl_easy_getinfo (3),
.BR curl_easy_setopt (3),
.BR CURLINFO_SIZE_UPLOAD_T (3),
.BR CURLINFO_SPEED_UPLOAD_T (3)
man/man3/CURLOPT_PROXYPASSWORD.3 0000644 00000004630 14751172371 0011570 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_PROXYPASSWORD 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_PROXYPASSWORD \- password to use with proxy authentication
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_PROXYPASSWORD, char *pwd);
.fi
.SH DESCRIPTION
Pass a char * as parameter, which should be pointing to the null-terminated
password to use for authentication with the proxy.
The \fICURLOPT_PROXYPASSWORD(3)\fP option should be used in conjunction with
the \fICURLOPT_PROXYUSERNAME(3)\fP option.
The application does not have to keep the string around after setting this
option.
.SH DEFAULT
blank
.SH PROTOCOLS
Most
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/foo.bin");
curl_easy_setopt(curl, CURLOPT_PROXY, "http://localhost:8080");
curl_easy_setopt(curl, CURLOPT_PROXYUSERNAME, "mrsmith");
curl_easy_setopt(curl, CURLOPT_PROXYPASSWORD, "qwerty");
ret = curl_easy_perform(curl);
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Added in 7.19.1
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, CURLE_UNKNOWN_OPTION if not, or
CURLE_OUT_OF_MEMORY if there was insufficient heap space.
.SH "SEE ALSO"
.BR CURLOPT_HTTPAUTH (3),
.BR CURLOPT_PASSWORD (3),
.BR CURLOPT_PROXYAUTH (3),
.BR CURLOPT_PROXYUSERNAME (3)
man/man3/CURLMOPT_MAX_HOST_CONNECTIONS.3 0000644 00000005556 14751172371 0012735 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLMOPT_MAX_HOST_CONNECTIONS 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLMOPT_MAX_HOST_CONNECTIONS \- max number of connections to a single host
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLMcode curl_multi_setopt(CURLM *handle, CURLMOPT_MAX_HOST_CONNECTIONS,
long max);
.fi
.SH DESCRIPTION
Pass a long to indicate \fBmax\fP. The set number is used as the maximum
amount of simultaneously open connections to a single host (a host being the
same as a host name + port number pair). For each new session to a host,
libcurl might open a new connection up to the limit set by
\fICURLMOPT_MAX_HOST_CONNECTIONS(3)\fP. When the limit is reached, new
sessions are kept pending until a connection becomes available.
The default \fBmax\fP value is 0, unlimited. This set limit is also used for
proxy connections, and then the proxy is considered to be the host for which
this limit counts.
When more transfers are added to the multi handle than what can be performed
due to the set limit, they are queued up waiting for their chance. When that
happens, the \fICURLOPT_TIMEOUT_MS(3)\fP timeout is inclusive of the waiting
time, meaning that if you set a too narrow timeout in such a case the transfer
might never even start before it times out.
Even in the queued up situation, the \fICURLOPT_CONNECTTIMEOUT_MS(3)\fP
timeout is however treated as a per-connect timeout.
.SH DEFAULT
0
.SH PROTOCOLS
HTTP(S)
.SH EXAMPLE
.nf
CURLM *m = curl_multi_init();
/* do no more than 2 connections per host */
curl_multi_setopt(m, CURLMOPT_MAX_HOST_CONNECTIONS, 2L);
.fi
.SH AVAILABILITY
Added in 7.30.0
.SH RETURN VALUE
Returns CURLM_OK if the option is supported, and CURLM_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR CURLMOPT_MAXCONNECTS (3),
.BR CURLMOPT_MAX_TOTAL_CONNECTIONS (3)
man/man3/curl_easy_duphandle.3 0000644 00000005262 14751172371 0012270 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.TH curl_easy_duphandle 3 "September 26, 2023" "libcurl 8.4.0" "libcurl"
.SH NAME
curl_easy_duphandle - Clone a libcurl session handle
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURL *curl_easy_duphandle(CURL *handle);
.fi
.SH DESCRIPTION
This function returns a new curl handle, a duplicate, using all the options
previously set in the input curl \fIhandle\fP. Both handles can subsequently
be used independently and they must both be freed with
\fIcurl_easy_cleanup(3)\fP.
Any options that the input handle has been told to point to (as opposed to
copy) with previous calls to \fIcurl_easy_setopt(3)\fP, are pointed to by the
new handle as well. You must therefore make sure to keep the data around until
both handles have been cleaned up.
The new handle does \fBnot\fP inherit any state information, no connections,
no SSL sessions and no cookies. It also does not inherit any share object
states or options (created as if \fICURLOPT_SHARE(3)\fP was set to NULL).
In multi-threaded programs, this function must be called in a synchronous way,
the input handle may not be in use when cloned.
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
CURL *nother;
if(curl) {
CURLcode res;
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
nother = curl_easy_duphandle(curl);
res = curl_easy_perform(nother);
curl_easy_cleanup(nother);
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Added in 7.9
.SH RETURN VALUE
If this function returns NULL, something went wrong and no valid handle was
returned.
.SH SEE ALSO
.BR curl_easy_cleanup (3),
.BR curl_easy_init (3),
.BR curl_easy_reset (3),
.BR curl_global_init (3)
man/man3/CURLOPT_SSLKEY.3 0000644 00000005056 14751172371 0010501 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_SSLKEY 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_SSLKEY \- private key file for TLS and SSL client cert
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_SSLKEY, char *keyfile);
.fi
.SH DESCRIPTION
Pass a pointer to a null-terminated string as parameter. The string should be
the file name of your private key. The default format is "PEM" and can be
changed with \fICURLOPT_SSLKEYTYPE(3)\fP.
(Windows, iOS and Mac OS X) This option is ignored by Secure Transport and
Schannel SSL backends because they expect the private key to be already present
in the key-chain or PKCS#12 file containing the certificate.
The application does not have to keep the string around after setting this
option.
.SH DEFAULT
NULL
.SH PROTOCOLS
All TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc.
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/");
curl_easy_setopt(curl, CURLOPT_SSLCERT, "client.pem");
curl_easy_setopt(curl, CURLOPT_SSLKEY, "key.pem");
curl_easy_setopt(curl, CURLOPT_KEYPASSWD, "s3cret");
ret = curl_easy_perform(curl);
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
If built TLS enabled.
.SH RETURN VALUE
Returns CURLE_OK if TLS is supported, CURLE_UNKNOWN_OPTION if not, or
CURLE_OUT_OF_MEMORY if there was insufficient heap space.
.SH "SEE ALSO"
.BR CURLOPT_SSLCERT (3),
.BR CURLOPT_SSLKEY_BLOB (3),
.BR CURLOPT_SSLKEYTYPE (3)
man/man3/CURLINFO_RESPONSE_CODE.3 0000644 00000004637 14751172371 0011614 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLINFO_RESPONSE_CODE 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLINFO_RESPONSE_CODE \- get the last response code
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_getinfo(CURL *handle, CURLINFO_RESPONSE_CODE, long *codep);
.fi
.SH DESCRIPTION
Pass a pointer to a long to receive the last received HTTP, FTP, SMTP or LDAP
(OpenLDAP only) response code. This option was previously known as
CURLINFO_HTTP_CODE in libcurl 7.10.7 and earlier. The stored value is zero if
no server response code has been received.
Note that a proxy's CONNECT response should be read with
\fICURLINFO_HTTP_CONNECTCODE(3)\fP and not this.
.SH PROTOCOLS
HTTP, FTP, SMTP and LDAP
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
CURLcode res;
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
res = curl_easy_perform(curl);
if(res == CURLE_OK) {
long response_code;
curl_easy_getinfo(curl, CURLINFO_RESPONSE_CODE, &response_code);
}
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Added in 7.10.8. CURLINFO_HTTP_CODE was added in 7.4.1.
Support for SMTP responses added in 7.25.0, for OpenLDAP in 7.81.0.
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR curl_easy_getinfo (3),
.BR curl_easy_setopt (3),
.BR CURLINFO_HTTP_CONNECTCODE (3)
man/man3/CURLSHOPT_USERDATA.3 0000644 00000004173 14751172371 0011131 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.TH CURLSHOPT_USERDATA 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLSHOPT_USERDATA - pointer passed to the lock and unlock mutex callbacks
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLSHcode curl_share_setopt(CURLSH *share, CURLSHOPT_USERDATA, void *clientp);
.fi
.SH DESCRIPTION
The \fIclientp\fP parameter is held verbatim by libcurl and is passed on as
the \fIclientp\fP argument to the callbacks set with
\fICURLSHOPT_LOCKFUNC(3)\fP and \fICURLSHOPT_UNLOCKFUNC(3)\fP.
.SH PROTOCOLS
All
.SH EXAMPLE
.nf
CURLSHcode sh;
struct secrets private_stuff;
share = curl_share_init();
sh = curl_share_setopt(share, CURLSHOPT_USERDATA, &private_stuff);
if(sh)
printf("Error: %s\\n", curl_share_strerror(sh));
.fi
.SH AVAILABILITY
Added in 7.10
.SH RETURN VALUE
CURLSHE_OK (zero) means that the option was set properly, non-zero means an
error occurred. See \fIlibcurl-errors(3)\fP for the full list with
descriptions.
.SH "SEE ALSO"
.BR curl_share_cleanup (3),
.BR curl_share_init (3),
.BR curl_share_setopt (3),
.BR CURLSHOPT_LOCKFUNC (3)
man/man3/curl_url_get.3 0000644 00000015765 14751172371 0010755 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.TH curl_url_get 3 "September 26, 2023" "libcurl 8.4.0" "libcurl"
.SH NAME
curl_url_get - extract a part from a URL
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLUcode curl_url_get(CURLU *url,
CURLUPart part,
char **content,
unsigned int flags);
.fi
.SH DESCRIPTION
Given a \fIurl\fP handle of a URL object, this function extracts an individual
piece or the full URL from it.
The \fIpart\fP argument specifies which part to extract (see list below) and
\fIcontent\fP points to a 'char *' to get updated to point to a newly
allocated string with the contents.
The \fIflags\fP argument is a bitmask with individual features.
The returned content pointer must be freed with \fIcurl_free(3)\fP after use.
.SH FLAGS
The flags argument is zero, one or more bits set in a bitmask.
.IP CURLU_DEFAULT_PORT
If the handle has no port stored, this option makes \fIcurl_url_get(3)\fP
return the default port for the used scheme.
.IP CURLU_DEFAULT_SCHEME
If the handle has no scheme stored, this option makes \fIcurl_url_get(3)\fP
return the default scheme instead of error.
.IP CURLU_NO_DEFAULT_PORT
Instructs \fIcurl_url_get(3)\fP to not return a port number if it matches the
default port for the scheme.
.IP CURLU_URLDECODE
Asks \fIcurl_url_get(3)\fP to URL decode the contents before returning it. It
does not decode the scheme, the port number or the full URL.
The query component also gets plus-to-space conversion as a bonus when this
bit is set.
Note that this URL decoding is charset unaware and you get a zero terminated
string back with data that could be intended for a particular encoding.
If there are byte values lower than 32 in the decoded string, the get
operation returns an error instead.
.IP CURLU_URLENCODE
If set, \fIcurl_url_get(3)\fP URL encodes the host name part when a full URL
is retrieved. If not set (default), libcurl returns the URL with the host name
"raw" to support IDN names to appear as-is. IDN host names are typically using
non-ASCII bytes that otherwise gets percent-encoded.
Note that even when not asking for URL encoding, the '%' (byte 37) is URL
encoded to make sure the host name remains valid.
.IP CURLU_PUNYCODE
If set and \fICURLU_URLENCODE\fP is not set, and asked to retrieve the
\fBCURLUPART_HOST\fP or \fBCURLUPART_URL\fP parts, libcurl returns the host
name in its punycode version if it contains any non-ASCII octets (and is an
IDN name).
If libcurl is built without IDN capabilities, using this bit makes
\fIcurl_url_get(3)\fP return \fICURLUE_LACKS_IDN\fP if the host name contains
anything outside the ASCII range.
(Added in curl 7.88.0)
.IP CURLU_PUNY2IDN
If set and asked to retrieve the \fBCURLUPART_HOST\fP or \fBCURLUPART_URL\fP
parts, libcurl returns the host name in its IDN (International Domain Name)
UTF-8 version if it otherwise is a punycode version. If the punycode name
cannot be converted to IDN correctly, libcurl returns
\fICURLUE_BAD_HOSTNAME\fP.
If libcurl is built without IDN capabilities, using this bit makes
\fIcurl_url_get(3)\fP return \fICURLUE_LACKS_IDN\fP if the host name is using
punycode.
(Added in curl 8.3.0)
.SH PARTS
.IP CURLUPART_URL
When asked to return the full URL, \fIcurl_url_get(3)\fP returns a normalized
and possibly cleaned up version using all available URL parts.
We advise using the \fICURLU_PUNYCODE\fP option to get the URL as "normalized"
as possible since IDN allows host names to be written in many different ways
that still end up the same punycode version.
.IP CURLUPART_SCHEME
Scheme cannot be URL decoded on get.
.IP CURLUPART_USER
.IP CURLUPART_PASSWORD
.IP CURLUPART_OPTIONS
The options field is an optional field that might follow the password in the
userinfo part. It is only recognized/used when parsing URLs for the following
schemes: pop3, smtp and imap. The URL API still allows users to set and get
this field independently of scheme when not parsing full URLs.
.IP CURLUPART_HOST
The host name. If it is an IPv6 numeric address, the zone id is not part of it
but is provided separately in \fICURLUPART_ZONEID\fP. IPv6 numerical addresses
are returned within brackets ([]).
IPv6 names are normalized when set, which should make them as short as
possible while maintaining correct syntax.
.IP CURLUPART_ZONEID
If the host name is a numeric IPv6 address, this field might also be set.
.IP CURLUPART_PORT
A port cannot be URL decoded on get. This number is returned in a string just
like all other parts. That string is guaranteed to hold a valid port number in
ASCII using base 10.
.IP CURLUPART_PATH
The \fIpart\fP is always at least a slash ('/') even if no path was supplied
in the URL. A URL path always starts with a slash.
.IP CURLUPART_QUERY
The initial question mark that denotes the beginning of the query part is a
delimiter only. It is not part of the query contents.
A not-present query returns \fIpart\fP set to NULL.
A zero-length query returns \fIpart\fP as a zero-length string.
The query part gets pluses converted to space when asked to URL decode on get
with the CURLU_URLDECODE bit.
.IP CURLUPART_FRAGMENT
The initial hash sign that denotes the beginning of the fragment is a
delimiter only. It is not part of the fragment contents.
.SH EXAMPLE
.nf
CURLUcode rc;
CURLU *url = curl_url();
rc = curl_url_set(url, CURLUPART_URL, "https://example.com", 0);
if(!rc) {
char *scheme;
rc = curl_url_get(url, CURLUPART_SCHEME, &scheme, 0);
if(!rc) {
printf("the scheme is %s\\n", scheme);
curl_free(scheme);
}
curl_url_cleanup(url);
}
.fi
.SH AVAILABILITY
Added in 7.62.0. CURLUPART_ZONEID was added in 7.65.0.
.SH RETURN VALUE
Returns a CURLUcode error value, which is CURLUE_OK (0) if everything went
fine. See the \fIlibcurl-errors(3)\fP man page for the full list with
descriptions.
If this function returns an error, no URL part is returned.
.SH "SEE ALSO"
.BR curl_url (3),
.BR curl_url_cleanup (3),
.BR curl_url_dup (3),
.BR curl_url_set (3),
.BR curl_url_strerror (3),
.BR CURLOPT_CURLU (3)
man/man3/CURLINFO_NUM_CONNECTS.3 0000644 00000004650 14751172371 0011512 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLINFO_NUM_CONNECTS 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLINFO_NUM_CONNECTS \- get number of created connections
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_getinfo(CURL *handle, CURLINFO_NUM_CONNECTS, long *nump);
.fi
.SH DESCRIPTION
Pass a pointer to a long to receive how many new connections libcurl had to
create to achieve the previous transfer (only the successful connects are
counted). Combined with \fICURLINFO_REDIRECT_COUNT(3)\fP you are able to know
how many times libcurl successfully reused existing connection(s) or not. See
the connection options of \fIcurl_easy_setopt(3)\fP to see how libcurl tries
to make persistent connections to save time.
.SH PROTOCOLS
All
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
CURLcode res;
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
curl_easy_setopt(curl, CURLOPT_FOLLOWLOCATION, 1L);
res = curl_easy_perform(curl);
if(res == CURLE_OK) {
long connects;
res = curl_easy_getinfo(curl, CURLINFO_NUM_CONNECTS, &connects);
if(res)
printf("It needed %d connects\\n", connects);
}
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Added in 7.12.3
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR curl_easy_getinfo (3),
.BR curl_easy_setopt (3)
man/man3/curl_multi_strerror.3 0000644 00000003535 14751172371 0012400 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.TH curl_multi_strerror 3 "September 27, 2023" "libcurl 8.4.0" "libcurl"
.SH NAME
curl_multi_strerror - return string describing error code
.SH SYNOPSIS
.nf
.B #include <curl/curl.h>
.BI "const char *curl_multi_strerror(CURLMcode " errornum ");"
.SH DESCRIPTION
This function returns a string describing the \fICURLMcode\fP error code
passed in the argument \fIerrornum\fP.
.SH EXAMPLE
.nf
int still_running;
CURLMcode mc = curl_multi_perform(multi_handle, &still_running);
if(mc)
printf("error: %s\\n", curl_multi_strerror(mc));
.fi
.SH AVAILABILITY
This function was added in libcurl 7.12.0
.SH RETURN VALUE
A pointer to a null-terminated string.
.SH "SEE ALSO"
.BR curl_easy_strerror (3),
.BR curl_share_strerror (3),
.BR curl_url_strerror (3),
.BR libcurl-errors (3)
man/man3/CURLOPT_WILDCARDMATCH.3 0000644 00000007510 14751172371 0011432 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_WILDCARDMATCH 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_WILDCARDMATCH \- directory wildcard transfers
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_WILDCARDMATCH, long onoff);
.fi
.SH DESCRIPTION
Set \fIonoff\fP to 1 if you want to transfer multiple files according to a
file name pattern. The pattern can be specified as part of the
\fICURLOPT_URL(3)\fP option, using an \fBfnmatch\fP-like pattern (Shell
Pattern Matching) in the last part of URL (file name).
By default, libcurl uses its internal wildcard matching implementation. You
can provide your own matching function by the
\fICURLOPT_FNMATCH_FUNCTION(3)\fP option.
A brief introduction of its syntax follows:
.RS
.IP "* - ASTERISK"
.nf
ftp://example.com/some/path/*.txt
.fi
for all txt's from the root directory. Only two asterisks are allowed within
the same pattern string.
.RE
.RS
.IP "? - QUESTION MARK"
Question mark matches any (exactly one) character.
.nf
ftp://example.com/some/path/photo?.jpg
.fi
.RE
.RS
.IP "[ - BRACKET EXPRESSION"
The left bracket opens a bracket expression. The question mark and asterisk have
no special meaning in a bracket expression. Each bracket expression ends by the
right bracket and matches exactly one character. Some examples follow:
\fB[a-zA-Z0\-9]\fP or \fB[f\-gF\-G]\fP \- character interval
\fB[abc]\fP - character enumeration
\fB[^abc]\fP or \fB[!abc]\fP - negation
\fB[[:name:]]\fP class expression. Supported classes are
\fBalnum\fP,\fBlower\fP, \fBspace\fP, \fBalpha\fP, \fBdigit\fP, \fBprint\fP,
\fBupper\fP, \fBblank\fP, \fBgraph\fP, \fBxdigit\fP.
\fB[][-!^]\fP - special case \- matches only '\-', ']', '[', '!' or '^'. These
characters have no special purpose.
\fB[\\[\\]\\\\]\fP - escape syntax. Matches '[', ']' or '\e'.
Using the rules above, a file name pattern can be constructed:
.nf
ftp://example.com/some/path/[a-z[:upper:]\\\\].jpg
.fi
.SH PROTOCOLS
This feature is only supported for FTP download.
.SH EXAMPLE
.nf
/* initialization of easy handle */
handle = curl_easy_init();
/* turn on wildcard matching */
curl_easy_setopt(handle, CURLOPT_WILDCARDMATCH, 1L);
/* callback is called before download of concrete file started */
curl_easy_setopt(handle, CURLOPT_CHUNK_BGN_FUNCTION, file_is_coming);
/* callback is called after data from the file have been transferred */
curl_easy_setopt(handle, CURLOPT_CHUNK_END_FUNCTION, file_is_downloaded);
/* See more on https://curl.se/libcurl/c/ftp-wildcard.html */
.fi
.SH AVAILABILITY
Added in 7.21.0
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR CURLOPT_CHUNK_BGN_FUNCTION (3),
.BR CURLOPT_CHUNK_END_FUNCTION (3),
.BR CURLOPT_FNMATCH_FUNCTION (3),
.BR CURLOPT_URL (3)
man/man3/CURLOPT_HEADERFUNCTION.3 0000644 00000012420 14751172371 0011556 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_HEADERFUNCTION 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_HEADERFUNCTION \- callback that receives header data
.SH SYNOPSIS
.nf
#include <curl/curl.h>
size_t header_callback(char *buffer,
size_t size,
size_t nitems,
void *userdata);
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_HEADERFUNCTION,
header_callback);
.fi
.SH DESCRIPTION
Pass a pointer to your callback function, which should match the prototype
shown above.
This callback function gets invoked by libcurl as soon as it has received
header data. The header callback is called once for each header and only
complete header lines are passed on to the callback. Parsing headers is easy
to do using this callback. \fIbuffer\fP points to the delivered data, and the
size of that data is \fInitems\fP; \fIsize\fP is always 1. The provide header
line is not null-terminated!
The pointer named \fIuserdata\fP is the one you set with the
\fICURLOPT_HEADERDATA(3)\fP option.
Your callback should return the number of bytes actually taken care of. If
that amount differs from the amount passed to your callback function, it
signals an error condition to the library. This causes the transfer to get
aborted and the libcurl function used returns \fICURLE_WRITE_ERROR\fP.
You can also abort the transfer by returning CURL_WRITEFUNC_ERROR. (7.87.0)
A complete HTTP header that is passed to this function can be up to
\fICURL_MAX_HTTP_HEADER\fP (100K) bytes and includes the final line terminator.
If this option is not set, or if it is set to NULL, but
\fICURLOPT_HEADERDATA(3)\fP is set to anything but NULL, the function used to
accept response data is used instead. That is the function specified with
\fICURLOPT_WRITEFUNCTION(3)\fP, or if it is not specified or NULL - the
default, stream-writing function.
It's important to note that the callback is invoked for the headers of all
responses received after initiating a request and not just the final
response. This includes all responses which occur during authentication
negotiation. If you need to operate on only the headers from the final
response, you need to collect headers in the callback yourself and use HTTP
status lines, for example, to delimit response boundaries.
For an HTTP transfer, the status line and the blank line preceding the response
body are both included as headers and passed to this function.
When a server sends a chunked encoded transfer, it may contain a trailer. That
trailer is identical to an HTTP header and if such a trailer is received it is
passed to the application using this callback as well. There are several ways
to detect it being a trailer and not an ordinary header: 1) it comes after the
response-body. 2) it comes after the final header line (CR LF) 3) a Trailer:
header among the regular response-headers mention what header(s) to expect in
the trailer.
For non-HTTP protocols like FTP, POP3, IMAP and SMTP this function gets called
with the server responses to the commands that libcurl sends.
A more convenient way to get HTTP headers might be to use
\fIcurl_easy_header(3)\fP.
.SH LIMITATIONS
libcurl does not unfold HTTP "folded headers" (deprecated since RFC 7230). A
folded header is a header that continues on a subsequent line and starts with
a whitespace. Such folds are passed to the header callback as separate ones,
although strictly they are just continuations of the previous lines.
.SH DEFAULT
Nothing.
.SH PROTOCOLS
Used for all protocols with headers or meta-data concept: HTTP, FTP, POP3,
IMAP, SMTP and more.
.SH EXAMPLE
.nf
static size_t header_callback(char *buffer, size_t size,
size_t nitems, void *userdata)
{
/* received header is nitems * size long in 'buffer' NOT ZERO TERMINATED */
/* 'userdata' is set with CURLOPT_HEADERDATA */
return nitems * size;
}
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
curl_easy_setopt(curl, CURLOPT_HEADERFUNCTION, header_callback);
curl_easy_perform(curl);
}
.fi
.SH AVAILABILITY
Always
.SH RETURN VALUE
Returns CURLE_OK
.SH "SEE ALSO"
.BR curl_easy_header (3),
.BR CURLOPT_HEADERDATA (3),
.BR CURLOPT_WRITEFUNCTION (3)
man/man3/CURLOPT_TIMEVALUE_LARGE.3 0000644 00000004625 14751172371 0011735 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_TIMEVALUE_LARGE 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_TIMEVALUE_LARGE \- time value for conditional
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_TIMEVALUE_LARGE,
curl_off_t val);
.fi
.SH DESCRIPTION
Pass a curl_off_t \fIval\fP as parameter. This should be the time counted as
seconds since 1 Jan 1970, and the time is used in a condition as specified
with \fICURLOPT_TIMECONDITION(3)\fP.
The difference between this option and \fICURLOPT_TIMEVALUE(3)\fP is the type
of the argument. On systems where 'long' is only 32 bit wide, this option has
to be used to set dates beyond the year 2038.
.SH DEFAULT
0
.SH PROTOCOLS
HTTP, FTP, RTSP, and FILE
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
/* January 1, 2020 is 1577833200 */
curl_easy_setopt(curl, CURLOPT_TIMEVALUE_LARGE, (curl_off_t)1577833200);
/* If-Modified-Since the above time stamp */
curl_easy_setopt(curl, CURLOPT_TIMECONDITION, CURL_TIMECOND_IFMODSINCE);
/* Perform the request */
curl_easy_perform(curl);
}
.fi
.SH AVAILABILITY
Added in 7.59.0.
.SH RETURN VALUE
Returns CURLE_OK
.SH "SEE ALSO"
.BR CURLOPT_TIMECONDITION (3),
.BR CURLOPT_TIMEVALUE (3),
.BR CURLINFO_FILETIME (3)
man/man3/CURLOPT_PROXYTYPE.3 0000644 00000005417 14751172371 0011113 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_PROXYTYPE 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_PROXYTYPE \- proxy protocol type
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_PROXYTYPE, long type);
.fi
.SH DESCRIPTION
Pass one of the values below to set the type of the proxy.
.RS
.IP CURLPROXY_HTTP
HTTP Proxy. Default.
.IP CURLPROXY_HTTPS
HTTPS Proxy using HTTP/1. (Added in 7.52.0 for OpenSSL and GnuTLS. Since
7.87.0, it also works for BearSSL, mbedTLS, rustls, Schannel, Secure Transport
and wolfSSL.)
.IP CURLPROXY_HTTPS2
HTTPS Proxy and attempt to speak HTTP/2 over it. (Added in 8.1.0)
.IP CURLPROXY_HTTP_1_0
HTTP 1.0 Proxy. This is similar to CURLPROXY_HTTP except it uses HTTP/1.0 for
any CONNECT tunneling. It does not change the HTTP version of the actual HTTP
requests, controlled by \fICURLOPT_HTTP_VERSION(3)\fP.
.IP CURLPROXY_SOCKS4
SOCKS4 Proxy.
.IP CURLPROXY_SOCKS4A
SOCKS4a Proxy. Proxy resolves URL hostname.
.IP CURLPROXY_SOCKS5
SOCKS5 Proxy.
.IP CURLPROXY_SOCKS5_HOSTNAME
SOCKS5 Proxy. Proxy resolves URL hostname.
.RE
Often it is more convenient to specify the proxy type with the scheme part of
the \fICURLOPT_PROXY(3)\fP string.
.SH DEFAULT
CURLPROXY_HTTP
.SH PROTOCOLS
Most
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
CURLcode ret;
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/");
curl_easy_setopt(curl, CURLOPT_PROXY, "local.example.com:1080");
/* set the proxy type */
curl_easy_setopt(curl, CURLOPT_PROXYTYPE, CURLPROXY_SOCKS5);
ret = curl_easy_perform(curl);
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Always
.SH RETURN VALUE
Returns CURLE_OK
.SH "SEE ALSO"
.BR CURLOPT_PROXY (3),
.BR CURLOPT_PROXYPORT (3)
man/man3/CURLOPT_SSL_SESSIONID_CACHE.3 0000644 00000004525 14751172371 0012433 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_SSL_SESSIONID_CACHE 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_SSL_SESSIONID_CACHE \- use the SSL session-ID cache
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_SSL_SESSIONID_CACHE,
long enabled);
.SH DESCRIPTION
Pass a long set to 0 to disable libcurl's use of SSL session-ID caching. Set
this to 1 to enable it. By default all transfers are done using the cache
enabled. While nothing ever should get hurt by attempting to reuse SSL
session-IDs, there seem to be or have been broken SSL implementations in the
wild that may require you to disable this in order for you to succeed.
.SH DEFAULT
1
.SH PROTOCOLS
All TLS-based
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/");
/* switch off session-id use! */
curl_easy_setopt(curl, CURLOPT_SSL_SESSIONID_CACHE, 0L);
ret = curl_easy_perform(curl);
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Added in 7.16.0
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR CURLOPT_DNS_CACHE_TIMEOUT (3),
.BR CURLOPT_MAXAGE_CONN (3),
.BR CURLOPT_MAXLIFETIME_CONN (3),
.BR CURLOPT_SSLVERSION (3)
man/man3/CURLOPT_PROXY.3 0000644 00000012057 14751172371 0010407 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_PROXY 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_PROXY \- proxy to use
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_PROXY, char *proxy);
.fi
.SH DESCRIPTION
Set the \fIproxy\fP to use for transfers with this easy handle. The parameter
should be a char * to a null-terminated string holding the host name or dotted
numerical IP address. A numerical IPv6 address must be written within
[brackets].
To specify port number in this string, append :[port] to the end of the host
name. The proxy's port number may optionally (but discouraged) be specified
with the separate option \fICURLOPT_PROXYPORT(3)\fP. If not specified, libcurl
defaults to using port 1080 for proxies.
The proxy string may be prefixed with [scheme]:// to specify which kind of
proxy is used.
.RS
.IP http://
HTTP Proxy. Default when no scheme or proxy type is specified.
.IP https://
HTTPS Proxy. (Added in 7.52.0 for OpenSSL and GnuTLS Since 7.87.0, it
also works for BearSSL, mbedTLS, rustls, Schannel, Secure Transport and
wolfSSL.)
This uses HTTP/1 by default. Setting \fICURLOPT_PROXYTYPE(3)\fP to
\fBCURLPROXY_HTTPS2\fP allows libcurl to negotiate using HTTP/2 with proxy.
.IP socks4://
SOCKS4 Proxy.
.IP socks4a://
SOCKS4a Proxy. Proxy resolves URL hostname.
.IP socks5://
SOCKS5 Proxy.
.IP socks5h://
SOCKS5 Proxy. Proxy resolves URL hostname.
.RE
Without a scheme prefix, \fICURLOPT_PROXYTYPE(3)\fP can be used to specify
which kind of proxy the string identifies.
When you tell the library to use an HTTP proxy, libcurl transparently converts
operations to HTTP even if you specify an FTP URL etc. This may have an impact
on what other features of the library you can use, such as
\fICURLOPT_QUOTE(3)\fP and similar FTP specifics that do not work unless you
tunnel through the HTTP proxy. Such tunneling is activated with
\fICURLOPT_HTTPPROXYTUNNEL(3)\fP.
Setting the proxy string to "" (an empty string) explicitly disables the use
of a proxy, even if there is an environment variable set for it.
A proxy host string can also include protocol scheme (http://) and embedded
user + password.
Unix domain sockets are supported for socks proxies since 7.84.0. Set
localhost for the host part. e.g. socks5h://localhost/path/to/socket.sock
The application does not have to keep the string around after setting this
option.
When a proxy is used, the active FTP mode as set with \fICUROPT_FTPPORT(3)\fP,
cannot be used.
.SH "Environment variables"
libcurl respects the proxy environment variables named \fBhttp_proxy\fP,
\fBftp_proxy\fP, \fBsftp_proxy\fP etc. If set, libcurl uses the specified
proxy for that URL scheme. So for a "FTP://" URL, the \fBftp_proxy\fP is
considered. \fBall_proxy\fP is used if no protocol specific proxy was set.
If \fBno_proxy\fP (or \fBNO_PROXY\fP) is set, it is the exact equivalent of
setting the \fICURLOPT_NOPROXY(3)\fP option.
The \fICURLOPT_PROXY(3)\fP and \fICURLOPT_NOPROXY(3)\fP options override
environment variables.
.SH DEFAULT
Default is NULL, meaning no proxy is used.
When you set a host name to use, do not assume that there is any particular
single port number used widely for proxies. Specify it!
.SH PROTOCOLS
All except file://. Note that some protocols do not work well over proxy.
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/file.txt");
curl_easy_setopt(curl, CURLOPT_PROXY, "http://proxy:80");
curl_easy_perform(curl);
}
.fi
.SH AVAILABILITY
Since 7.14.1 the proxy environment variable names can include the protocol
scheme.
Since 7.21.7 the proxy string supports the socks protocols as "schemes".
Since 7.50.2, unsupported schemes in proxy strings cause libcurl to return
error.
.SH RETURN VALUE
Returns CURLE_OK if proxies are supported, CURLE_UNKNOWN_OPTION if not, or
CURLE_OUT_OF_MEMORY if there was insufficient heap space.
.SH "SEE ALSO"
.BR CURLOPT_HTTPPROXYTUNNEL (3),
.BR CURLOPT_PRE_PROXY (3),
.BR CURLOPT_PROXYPORT (3),
.BR CURLOPT_PROXYTYPE (3)
man/man3/CURLOPT_PROXY_ISSUERCERT_BLOB.3 0000644 00000007046 14751172371 0012757 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_PROXY_ISSUERCERT_BLOB 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_PROXY_ISSUERCERT_BLOB \- proxy issuer SSL certificate from memory blob
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_PROXY_ISSUERCERT_BLOB,
struct curl_blob *blob);
.fi
.SH DESCRIPTION
Pass a pointer to a curl_blob struct, which contains information (pointer and
size) about a memory block with binary data of a CA certificate in PEM
format. If the option is set, an additional check against the peer certificate
is performed to verify the issuer of the the HTTPS proxy is indeed the one
associated with the certificate provided by the option. This additional check
is useful in multi-level PKI where one needs to enforce that the peer
certificate is from a specific branch of the tree.
This option should be used in combination with the
\fICURLOPT_PROXY_SSL_VERIFYPEER(3)\fP option. Otherwise, the result of the
check is not considered as failure.
A specific error code (CURLE_SSL_ISSUER_ERROR) is defined with the option,
which is returned if the setup of the SSL/TLS session has failed due to a
mismatch with the issuer of peer certificate
(\fICURLOPT_PROXY_SSL_VERIFYPEER(3)\fP has to be set too for the check to
fail).
If the blob is initialized with the flags member of struct curl_blob set to
CURL_BLOB_COPY, the application does not have to keep the buffer around after
setting this.
This option is an alternative to \fICURLOPT_PROXY_ISSUERCERT(3)\fP which
instead expects a file name as input.
.SH DEFAULT
NULL
.SH PROTOCOLS
All TLS-based protocols
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
struct curl_blob blob;
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/");
/* using an HTTPS proxy */
curl_easy_setopt(curl, CURLOPT_PROXY, "https://localhost:443");
blob.data = certificateData;
blob.len = filesize;
blob.flags = CURL_BLOB_COPY;
curl_easy_setopt(curl, CURLOPT_PROXY_ISSUERCERT_BLOB, &blob);
ret = curl_easy_perform(curl);
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Added in 7.71.0. This option is supported by the OpenSSL backends.
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, CURLE_UNKNOWN_OPTION if not, or
CURLE_OUT_OF_MEMORY if there was insufficient heap space.
.SH "SEE ALSO"
.BR CURLOPT_ISSUERCERT_BLOB (3),
.BR CURLOPT_PROXY_SSL_VERIFYHOST (3),
.BR CURLOPT_PROXY_SSL_VERIFYPEER (3),
.BR CURLOPT_SSL_VERIFYHOST (3),
.BR CURLOPT_SSL_VERIFYPEER (3)
man/man3/CURLOPT_TRANSFERTEXT.3 0000644 00000004505 14751172371 0011416 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_TRANSFERTEXT 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_TRANSFERTEXT \- request a text based transfer for FTP
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_TRANSFERTEXT, long text);
.fi
.SH DESCRIPTION
A parameter set to 1 tells the library to use ASCII mode for FTP transfers,
instead of the default binary transfer. For win32 systems it does not set the
stdout to binary mode. This option can be usable when transferring text data
between systems with different views on certain characters, such as newlines
or similar.
libcurl does not do a complete ASCII conversion when doing ASCII transfers
over FTP. This is a known limitation/flaw that nobody has rectified. libcurl
simply sets the mode to ASCII and performs a standard transfer.
.SH DEFAULT
0, disabled
.SH PROTOCOLS
FTP
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "ftp://example.com/textfile");
curl_easy_setopt(curl, CURLOPT_TRANSFERTEXT, 1L);
ret = curl_easy_perform(curl);
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Along with FTP
.SH RETURN VALUE
Returns CURLE_OK if FTP is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR CURLOPT_CRLF (3)
man/man3/CURLOPT_MAIL_FROM.3 0000644 00000004553 14751172371 0011035 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_MAIL_FROM 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_MAIL_FROM \- SMTP sender address
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_MAIL_FROM, char *from);
.fi
.SH DESCRIPTION
Pass a pointer to a null-terminated string as parameter. This should be used
to specify the sender's email address when sending SMTP mail with libcurl.
An originator email address should be specified with angled brackets (<>)
around it, which if not specified are added automatically.
If this parameter is not specified then an empty address is sent to the SMTP
server which might cause the email to be rejected.
The application does not have to keep the string around after setting this
option.
.SH DEFAULT
blank
.SH PROTOCOLS
SMTP
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "smtp://example.com/");
curl_easy_setopt(curl, CURLOPT_MAIL_FROM, "president@example.com");
ret = curl_easy_perform(curl);
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Added in 7.20.0
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, CURLE_UNKNOWN_OPTION if not, or
CURLE_OUT_OF_MEMORY if there was insufficient heap space.
.SH "SEE ALSO"
.BR CURLOPT_MAIL_AUTH (3),
.BR CURLOPT_MAIL_RCPT (3)
man/man3/CURLOPT_HTTPHEADER.3 0000644 00000016331 14751172371 0011115 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_HTTPHEADER 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_HTTPHEADER \- set of HTTP headers
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_HTTPHEADER,
struct curl_slist *headers);
.fi
.SH DESCRIPTION
Pass a pointer to a linked list of HTTP headers to pass to the server and/or
proxy in your HTTP request. The same list can be used for both host and proxy
requests!
When used within an IMAP or SMTP request to upload a MIME mail, the given
header list establishes the document-level MIME headers to prepend to the
uploaded document described by \fICURLOPT_MIMEPOST(3)\fP. This does not affect
raw mail uploads.
The linked list should be a fully valid list of \fBstruct curl_slist\fP
structs properly filled in. Use \fIcurl_slist_append(3)\fP to create the list
and \fIcurl_slist_free_all(3)\fP to clean up an entire list. If you add a
header that is otherwise generated and used by libcurl internally, your added
header is used instead. If you add a header with no content as in 'Accept:'
(no data on the right side of the colon), the internally used header is
disabled/removed. With this option you can add new headers, replace internal
headers and remove internal headers. To add a header with no content (nothing
to the right side of the colon), use the form 'name;' (note the ending
semicolon).
The headers included in the linked list \fBmust not\fP be CRLF-terminated,
because libcurl adds CRLF after each header item itself. Failure to comply
with this might result in strange behavior.
The first line in an HTTP request (containing the method, usually a GET or
POST) is not a header and cannot be replaced using this option. Only the lines
following the request-line are headers. Adding this method line in this list
of headers only causes your request to send an invalid header. Use
\fICURLOPT_CUSTOMREQUEST(3)\fP to change the method.
When this option is passed to \fIcurl_easy_setopt(3)\fP, libcurl does not copy
the entire list so you \fBmust\fP keep it around until you no longer use this
\fIhandle\fP for a transfer before you call \fIcurl_slist_free_all(3)\fP on
the list.
Pass a NULL to this option to reset back to no custom headers.
The most commonly replaced HTTP headers have "shortcuts" in the options
\fICURLOPT_COOKIE(3)\fP, \fICURLOPT_USERAGENT(3)\fP and
\fICURLOPT_REFERER(3)\fP. We recommend using those.
There is an alternative option that sets or replaces headers only for requests
that are sent with CONNECT to a proxy: \fICURLOPT_PROXYHEADER(3)\fP. Use
\fICURLOPT_HEADEROPT(3)\fP to control the behavior.
.SH SPECIFIC HTTP HEADERS
Setting some specific headers causes libcurl to act differently.
.IP "Host:"
The specified host name is used for cookie matching if the cookie engine is
also enabled for this transfer. If the request is done over HTTP/2 or HTTP/3,
the custom host name is instead used in the ":authority" header field and
Host: is not sent at all over the wire.
.IP "Transfer-Encoding: chunked"
Tells libcurl the upload is to be done using this chunked encoding instead of
providing the Content-Length: field in the request.
.SH SPECIFIC MIME HEADERS
When used to build a MIME e-mail for IMAP or SMTP, the following
document-level headers can be set to override libcurl-generated values:
.IP "Mime-Version:"
Tells the parser at the receiving site how to interpret the MIME framing.
It defaults to "1.0" and should normally not be altered.
.IP "Content-Type:"
Indicates the document's global structure type. By default, libcurl sets it
to "multipart/mixed", describing a document made of independent parts. When a
MIME mail is only composed of alternative representations of the same data
(i.e.: HTML and plain text), this header must be set to "multipart/alternative".
In all cases the value must be of the form "multipart/*" to respect the
document structure and may not include the "boundary=" parameter.
.P
Other specific headers that do not have a libcurl default value but are
strongly desired by mail delivery and user agents should also be included.
These are "From:", "To:", "Date:" and "Subject:" among others and their
presence and value is generally checked by anti-spam utilities.
.SH SECURITY CONCERNS
By default, this option makes libcurl send the given headers in all HTTP
requests done by this handle. You should therefore use this option with
caution if you for example connect to the remote site using a proxy and a
CONNECT request, you should to consider if that proxy is supposed to also get
the headers. They may be private or otherwise sensitive to leak.
Use \fICURLOPT_HEADEROPT(3)\fP to make the headers only get sent to where you
intend them to get sent.
Custom headers are sent in all requests done by the easy handle, which implies
that if you tell libcurl to follow redirects
(\fICURLOPT_FOLLOWLOCATION(3)\fP), the same set of custom headers is sent in
the subsequent request. Redirects can of course go to other hosts and thus
those servers get all the contents of your custom headers too.
Starting in 7.58.0, libcurl specifically prevents "Authorization:" headers
from being sent to other hosts than the first used one, unless specifically
permitted with the \fICURLOPT_UNRESTRICTED_AUTH(3)\fP option.
Starting in 7.64.0, libcurl specifically prevents "Cookie:" headers from being
sent to other hosts than the first used one, unless specifically permitted
with the \fICURLOPT_UNRESTRICTED_AUTH(3)\fP option.
.SH DEFAULT
NULL
.SH PROTOCOLS
HTTP, IMAP and SMTP
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
struct curl_slist *list = NULL;
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
list = curl_slist_append(list, "Shoesize: 10");
list = curl_slist_append(list, "Accept:");
curl_easy_setopt(curl, CURLOPT_HTTPHEADER, list);
curl_easy_perform(curl);
curl_slist_free_all(list); /* free the list */
}
.fi
.SH AVAILABILITY
As long as HTTP is enabled. Use in MIME mail added in 7.56.0.
.SH RETURN VALUE
Returns CURLE_OK if HTTP is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR curl_mime_init (3),
.BR CURLOPT_CUSTOMREQUEST (3),
.BR CURLOPT_HEADER (3),
.BR CURLOPT_HEADEROPT (3),
.BR CURLOPT_MIMEPOST (3),
.BR CURLOPT_PROXYHEADER (3)
man/man3/CURLOPT_APPEND.3 0000644 00000004040 14751172371 0010426 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_APPEND 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_APPEND \- append to the remote file
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_APPEND, long append);
.fi
.SH DESCRIPTION
A long parameter set to 1 tells the library to append to the remote file
instead of overwrite it. This is only useful when uploading to an FTP site.
.SH DEFAULT
0 (disabled)
.SH PROTOCOLS
FTP
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "ftp://example.com/dir/to/newfile");
curl_easy_setopt(curl, CURLOPT_UPLOAD, 1L);
curl_easy_setopt(curl, CURLOPT_APPEND, 1L);
curl_easy_perform(curl);
}
.fi
.SH AVAILABILITY
This option was known as CURLOPT_FTPAPPEND up to 7.16.4
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR CURLOPT_DIRLISTONLY (3),
.BR CURLOPT_RESUME_FROM (3),
.BR CURLOPT_UPLOAD (3)
man/man3/curl_easy_upkeep.3 0000644 00000005423 14751172371 0011614 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH curl_easy_upkeep 3 "April 26, 2023" "libcurl 8.4.0" "libcurl"
.SH NAME
curl_easy_upkeep - Perform any connection upkeep checks.
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_upkeep(CURL *handle);
.fi
.SH DESCRIPTION
Some protocols have "connection upkeep" mechanisms. These mechanisms usually
send some traffic on existing connections in order to keep them alive; this
can prevent connections from being closed due to overzealous firewalls, for
example.
Currently the only protocol with a connection upkeep mechanism is HTTP/2: when
the connection upkeep interval is exceeded and \fIcurl_easy_upkeep(3)\fP
is called, an HTTP/2 PING frame is sent on the connection.
This function must be explicitly called in order to perform the upkeep work.
The connection upkeep interval is set with
\fICURLOPT_UPKEEP_INTERVAL_MS(3)\fP.
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
/* Make a connection to an HTTP/2 server. */
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
/* Set the interval to 30000ms / 30s */
curl_easy_setopt(curl, CURLOPT_UPKEEP_INTERVAL_MS, 30000L);
curl_easy_perform(curl);
/* Perform more work here. */
/* While the connection is being held open, curl_easy_upkeep() can be
called. If curl_easy_upkeep() is called and the time since the last
upkeep exceeds the interval, then an HTTP/2 PING is sent. */
curl_easy_upkeep(curl);
/* Perform more work here. */
/* always cleanup */
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Added in 7.62.0.
.SH RETURN VALUE
On success, returns \fBCURLE_OK\fP.
On failure, returns the appropriate error code.
.SH SEE ALSO
.BR CURLOPT_TCP_KEEPALIVE "(3), "
.BR CURLOPT_TCP_KEEPIDLE "(3), "
man/man3/CURLINFO_HEADER_SIZE.3 0000644 00000004314 14751172371 0011336 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLINFO_HEADER_SIZE 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLINFO_HEADER_SIZE \- get size of retrieved headers
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_getinfo(CURL *handle, CURLINFO_HEADER_SIZE, long *sizep);
.fi
.SH DESCRIPTION
Pass a pointer to a long to receive the total size of all the headers
received. Measured in number of bytes.
The total includes the size of any received headers suppressed by
\fICURLOPT_SUPPRESS_CONNECT_HEADERS(3)\fP.
.SH PROTOCOLS
All
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
CURLcode res;
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
res = curl_easy_perform(curl);
if(res == CURLE_OK) {
long size;
res = curl_easy_getinfo(curl, CURLINFO_HEADER_SIZE, &size);
if(!res)
printf("Header size: %ld bytes\\n", size);
}
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Added in 7.4.1
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR curl_easy_getinfo (3),
.BR curl_easy_setopt (3),
.BR CURLINFO_REQUEST_SIZE (3),
.BR CURLINFO_SIZE_DOWNLOAD (3)
man/man3/CURLOPT_SSH_HOSTKEYFUNCTION.3 0000644 00000006155 14751172371 0012501 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_SSH_HOSTKEYFUNCTION 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_SSH_HOSTKEYFUNCTION \- callback to check host key
.SH SYNOPSIS
.nf
#include <curl/curl.h>
int keycallback(void *clientp,
int keytype,
const char *key,
size_t keylen);
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_SSH_HOSTKEYFUNCTION,
keycallback);
.fi
.SH DESCRIPTION
Pass a pointer to your callback function, which should match the prototype
shown above. It overrides \fICURLOPT_SSH_KNOWNHOSTS(3)\fP.
This callback gets called when the verification of the SSH host key is needed.
\fBkey\fP is \fBkeylen\fP bytes long and is the key to check. \fBkeytype\fP
says what type it is, from the \fBCURLKHTYPE_*\fP series in the
\fBcurl_khtype\fP enum.
\fBclientp\fP is a custom pointer set with \fICURLOPT_SSH_HOSTKEYDATA(3)\fP.
The callback MUST return one of the following return codes to tell libcurl how
to act:
.IP CURLKHMATCH_OK
The host key is accepted, the connection should continue.
.IP CURLKHMATCH_MISMATCH
the host key is rejected, the connection is canceled.
.SH DEFAULT
NULL
.SH PROTOCOLS
SCP and SFTP
.SH EXAMPLE
.nf
int hostkeycb(void *clientp, /* passed with CURLOPT_SSH_HOSTKEYDATA */
int keytype, /* CURLKHTYPE */
const char * key, /* host key to check */
size_t keylen); /* length of the key */
{
/* 'clientp' points to the callback_data struct */
/* investigate the situation and return the correct value */
return CURLKHMATCH_OK;
}
{
curl_easy_setopt(curl, CURLOPT_URL, "sftp://example.com/thisfile.txt");
curl_easy_setopt(curl, CURLOPT_SSH_HOSTKEYFUNCTION, hostkeycb);
curl_easy_setopt(curl, CURLOPT_SSH_HOSTKEYDATA, &callback_data);
curl_easy_perform(curl);
}
.fi
.SH AVAILABILITY
Added in 7.84.0 , work only with libssh2 backend.
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR CURLOPT_SSH_HOSTKEYDATA (3),
.BR CURLOPT_SSH_KNOWNHOSTS (3)
man/man3/CURLINFO_PROXYAUTH_AVAIL.3 0000644 00000005274 14751172371 0012101 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLINFO_PROXYAUTH_AVAIL 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLINFO_PROXYAUTH_AVAIL \- get available HTTP proxy authentication methods
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_getinfo(CURL *handle, CURLINFO_PROXYAUTH_AVAIL,
long *authp);
.fi
.SH DESCRIPTION
Pass a pointer to a long to receive a bitmask indicating the authentication
method(s) available according to the previous response. The meaning of the
bits is explained in the \fICURLOPT_PROXYAUTH(3)\fP option for
\fIcurl_easy_setopt(3)\fP.
.SH PROTOCOLS
HTTP(S)
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
curl_easy_setopt(curl, CURLOPT_PROXY, "http://127.0.0.1:80");
res = curl_easy_perform(curl);
if(!res) {
/* extract the available proxy authentication types */
long auth;
res = curl_easy_getinfo(curl, CURLINFO_PROXYAUTH_AVAIL, &auth);
if(!res) {
if(!auth)
printf("No proxy auth available, perhaps no 407?\\n");
else {
printf("%s%s%s%s\\n",
auth & CURLAUTH_BASIC ? "Basic ":"",
auth & CURLAUTH_DIGEST ? "Digest ":"",
auth & CURLAUTH_NEGOTIATE ? "Negotiate ":"",
auth % CURLAUTH_NTLM ? "NTLM ":"");
}
}
}
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Added RFC 2617 in 7.10.8
Added RFC 7616 in 7.57.0
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR curl_easy_getinfo (3),
.BR curl_easy_setopt (3),
.BR CURLINFO_HTTPAUTH_AVAIL (3)
man/man3/CURLOPT_NETRC.3 0000644 00000012217 14751172371 0010337 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_NETRC 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_NETRC \- enable use of .netrc
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_NETRC, long level);
.fi
.SH DESCRIPTION
This parameter controls the preference \fIlevel\fP of libcurl between using
user names and passwords from your \fI~/.netrc\fP file, relative to user names
and passwords in the URL supplied with \fICURLOPT_URL(3)\fP.
On Windows, libcurl uses the file as \fI%HOME%/_netrc\fP. If \fI%HOME%\fP is
not set on Windows, libcurl falls back to \fI%USERPROFILE%\fP.
You can also tell libcurl a different file name to use with
\fICURLOPT_NETRC_FILE(3)\fP.
libcurl uses a user name (and supplied or prompted password) supplied with
\fICURLOPT_USERPWD(3)\fP or \fICURLOPT_USERNAME(3)\fP in preference to any of
the options controlled by this parameter.
Only machine name, user name and password are taken into account (init macros
and similar things are not supported).
libcurl does not verify that the file has the correct properties set (as the
standard Unix ftp client does). It should only be readable by user.
\fIlevel\fP is a long that should be set to one of the values described below.
.IP "CURL_NETRC_IGNORED (0)"
libcurl ignores the \fI.netrc\fP file. This is the default.
.IP "CURL_NETRC_OPTIONAL (1)"
The use of the \fI.netrc\fP file is optional, and information in the URL is to
be preferred. The file is scanned for the host and user name (to find the
password only) or for the host only, to find the first user name and password
after that \fImachine\fP, which ever information is not specified.
.IP "CURL_NETRC_REQUIRED (2)"
The use of the \fI.netrc\fP file is required, and any credential information
present in the URL is ignored. The file is scanned for the host and user name
(to find the password only) or for the host only, to find the first user name
and password after that \fImachine\fP, which ever information is not
specified.
.SH FILE FORMAT
The \fB.netrc\fP file format is simple: you specify lines with a machine name
and follow the login and password that are associated with that machine.
Each field is provided as a sequence of letters that ends with a space or
newline. Starting in 7.84.0, libcurl also supports quoted strings. They start
and end with double quotes and support the escaped special letters \\\", \\n,
\\r, and \\t. Quoted strings are the only way a space character can be used in
a user name or password.
.IP "machine <name>"
Provides credentials for a host called \fBname\fP. libcurl searches the .netrc
file for a machine token that matches the host name specified in the URL. Once
a match is made, the subsequent tokens are processed, stopping when the end of
file is reached or another "machine" is encountered.
.IP default
This is the same as "machine" name except that default matches any name. There
can be only one default token, and it must be after all machine tokens. To
provide a default anonymous login for hosts that are not otherwise matched,
add a line similar to this in the end:
default login anonymous password user@domain
.IP "login <name>"
The user name string for the remote machine.
.IP "password <secret>"
Supply a password. If this token is present, curl supplies the specified
string if the remote server requires a password as part of the login process.
Note that if this token is present in the .netrc file you really should make
sure the file is not readable by anyone besides the user.
.IP "macdef <name>"
Define a macro. This feature is not supported by libcurl. In order for the
rest of the .netrc to still work fine, libcurl properly skips every definition
done with "macdef" that it finds.
.SH DEFAULT
CURL_NETRC_IGNORED
.SH PROTOCOLS
Most
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
CURLcode ret;
curl_easy_setopt(curl, CURLOPT_URL, "ftp://example.com/");
curl_easy_setopt(curl, CURLOPT_NETRC, CURL_NETRC_OPTIONAL);
ret = curl_easy_perform(curl);
}
.fi
.SH AVAILABILITY
Always
.SH RETURN VALUE
Returns CURLE_OK
.SH "SEE ALSO"
.BR CURLOPT_USERPWD (3),
.BR CURLOPT_USERNAME (3),
.BR CURLOPT_NETRC_FILE (3)
man/man3/CURLOPT_RESUME_FROM_LARGE.3 0000644 00000005424 14751172371 0012223 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_RESUME_FROM_LARGE 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_RESUME_FROM_LARGE \- offset to resume transfer from
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_RESUME_FROM_LARGE,
curl_off_t from);
.SH DESCRIPTION
Pass a curl_off_t as parameter. It contains the offset in number of bytes that
you want the transfer to start from. Set this option to 0 to make the transfer
start from the beginning (effectively disabling resume). For FTP, set this
option to -1 to make the transfer start from the end of the target file
(useful to continue an interrupted upload).
When doing uploads with FTP, the resume position is where in the local/source
file libcurl should try to resume the upload from and it appends the source
file to the remote target file.
.SH DEFAULT
0, not used
.SH PROTOCOLS
HTTP, FTP, SFTP, FILE
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_off_t resume_position = GET_IT_SOMEHOW;
curl_off_t file_size = GET_IT_SOMEHOW_AS_WELL;
curl_easy_setopt(curl, CURLOPT_URL, "ftp://example.com");
/* resuming upload at this position, possibly beyond 2GB */
curl_easy_setopt(curl, CURLOPT_RESUME_FROM_LARGE, resume_position);
/* ask for upload */
curl_easy_setopt(curl, CURLOPT_UPLOAD, 1L);
/* set total data amount to expect */
curl_easy_setopt(curl, CURLOPT_INFILESIZE_LARGE, file_size);
/* Perform the request */
curl_easy_perform(curl);
}
.fi
.SH AVAILABILITY
Added in 7.11.0
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR CURLOPT_INFILESIZE_LARGE (3),
.BR CURLOPT_RANGE (3),
.BR CURLOPT_RESUME_FROM (3)
man/man3/curl_multi_assign.3 0000644 00000006105 14751172371 0011776 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.TH curl_multi_assign 3 "September 26, 2023" "libcurl 8.4.0" "libcurl"
.SH NAME
curl_multi_assign \- set data to associate with an internal socket
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLMcode curl_multi_assign(CURLM *multi_handle, curl_socket_t sockfd,
void *sockptr);
.fi
.SH DESCRIPTION
This function creates an association in the multi handle between the given
socket and a private pointer of the application. This is designed for
\fIcurl_multi_socket_action(3)\fP uses.
When set, the \fIsockptr\fP pointer is passed to all future socket callbacks
for the specific \fIsockfd\fP socket.
If the given \fIsockfd\fP is not already in use by libcurl, this function
returns an error.
libcurl only keeps one single pointer associated with a socket, so calling
this function several times for the same socket makes the last set pointer get
used.
The idea here being that this association (socket to private pointer) is
something that just about every application that uses this API needs and then
libcurl can just as well do it since it already has the necessary
functionality.
It is acceptable to call this function from your multi callback functions.
.SH EXAMPLE
.nf
/* make our struct pointer associated with socket fd */
mc = curl_multi_assign(multi_handle, fd, ourstructp);
.fi
.SH AVAILABILITY
Added in 7.15.5
.SH RETURN VALUE
The standard CURLMcode for multi interface error codes.
.SH TYPICAL USAGE
In a typical application you allocate a struct or at least use some kind of
semi-dynamic data for each socket that we must wait for action on when using
the \fIcurl_multi_socket_action(3)\fP approach.
When our socket-callback gets called by libcurl and we get to know about yet
another socket to wait for, we can use \fIcurl_multi_assign(3)\fP to point out
the particular data so that when we get updates about this same socket again,
we do not have to find the struct associated with this socket by ourselves.
.SH "SEE ALSO"
.BR curl_multi_setopt (3),
.BR curl_multi_socket_action (3)
man/man3/CURLOPT_PROXY_TLS13_CIPHERS.3 0000644 00000005411 14751172371 0012446 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_PROXY_TLS13_CIPHERS 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_PROXY_TLS13_CIPHERS \- ciphers suites for proxy TLS 1.3
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_PROXY_TLS13_CIPHERS,
char *list);
.fi
.SH DESCRIPTION
Pass a char *, pointing to a null-terminated string holding the list of cipher
suites to use for the TLS 1.3 connection to a proxy. The list must be
syntactically correct, it consists of one or more cipher suite strings
separated by colons.
Find more details about cipher lists on this URL:
https://curl.se/docs/ssl-ciphers.html
This option is currently used only when curl is built to use OpenSSL 1.1.1 or
later. If you are using a different SSL backend you can try setting TLS 1.3
cipher suites by using the \fICURLOPT_PROXY_SSL_CIPHER_LIST(3)\fP option.
The application does not have to keep the string around after setting this
option.
.SH DEFAULT
NULL, use internal default
.SH PROTOCOLS
All TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc.
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/");
curl_easy_setopt(curl, CURLOPT_PROXY_TLS13_CIPHERS,
"TLS_CHACHA20_POLY1305_SHA256");
ret = curl_easy_perform(curl);
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Added in 7.61.0.
Available when built with OpenSSL >= 1.1.1.
.SH RETURN VALUE
Returns CURLE_OK if supported, CURLE_NOT_BUILT_IN otherwise.
.SH "SEE ALSO"
.BR CURLOPT_PROXY_SSL_CIPHER_LIST (3),
.BR CURLOPT_PROXY_SSLVERSION (3),
.BR CURLOPT_SSL_CIPHER_LIST (3),
.BR CURLOPT_SSLVERSION (3),
.BR CURLOPT_TLS13_CIPHERS (3)
man/man3/CURLOPT_STREAM_WEIGHT.3 0000644 00000006022 14751172371 0011523 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_STREAM_WEIGHT 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_STREAM_WEIGHT \- numerical stream weight
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_STREAM_WEIGHT, long weight);
.fi
.SH DESCRIPTION
Set the long \fIweight\fP to a number between 1 and 256.
When using HTTP/2, this option sets the individual weight for this particular
stream used by the easy \fIhandle\fP. Setting and using weights only makes
sense and is only usable when doing multiple streams over the same
connections, which thus implies that you use \fICURLMOPT_PIPELINING(3)\fP.
This option can be set during transfer and causes the updated weight info get
sent to the server the next time an HTTP/2 frame is sent to the server.
See section 5.3 of RFC 7540 for protocol details.
Streams with the same parent should be allocated resources proportionally
based on their weight. So if you have two streams going, stream A with weight
16 and stream B with weight 32, stream B gets two thirds (32/48) of the
available bandwidth (assuming the server can send off the data equally for
both streams).
.SH DEFAULT
If nothing is set, the HTTP/2 protocol itself uses its own default which is
16.
.SH PROTOCOLS
HTTP/2
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
CURL *curl2 = curl_easy_init(); /* a second handle */
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/one");
curl_easy_setopt(curl, CURLOPT_STREAM_WEIGHT, 10L);
/* the second has twice the weight */
curl_easy_setopt(curl2, CURLOPT_URL, "https://example.com/two");
curl_easy_setopt(curl2, CURLOPT_STREAM_WEIGHT, 20L);
/* then add both to a multi handle and transfer them! */
}
.fi
.SH AVAILABILITY
Added in 7.46.0
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR CURLMOPT_PIPELINING (3),
.BR CURLOPT_PIPEWAIT (3),
.BR CURLOPT_STREAM_DEPENDS (3),
.BR CURLOPT_STREAM_DEPENDS_E (3)
man/man3/CURLOPT_LOW_SPEED_LIMIT.3 0000644 00000004424 14751172371 0012004 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_LOW_SPEED_LIMIT 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_LOW_SPEED_LIMIT \- low speed limit in bytes per second
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_LOW_SPEED_LIMIT,
long speedlimit);
.fi
.SH DESCRIPTION
Pass a long as parameter. It contains the average transfer speed in bytes per
second that the transfer should be below during
\fICURLOPT_LOW_SPEED_TIME(3)\fP seconds for libcurl to consider it to be too
slow and abort.
.SH DEFAULT
0, disabled
.SH PROTOCOLS
All
.SH EXAMPLE
.nf
curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, url);
/* abort if slower than 30 bytes/sec during 60 seconds */
curl_easy_setopt(curl, CURLOPT_LOW_SPEED_TIME, 60L);
curl_easy_setopt(curl, CURLOPT_LOW_SPEED_LIMIT, 30L);
res = curl_easy_perform(curl);
if(CURLE_OPERATION_TIMEDOUT == res) {
printf("Timeout!\\n");
}
/* always cleanup */
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Always
.SH RETURN VALUE
Returns CURLE_OK
.SH "SEE ALSO"
.BR CURLOPT_LOW_SPEED_TIME (3),
.BR CURLOPT_MAX_RECV_SPEED_LARGE (3),
.BR CURLOPT_MAX_SEND_SPEED_LARGE (3),
.BR CURLOPT_TIMEOUT (3)
man/man3/curl_ws_recv.3 0000644 00000005242 14751172371 0010751 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH curl_ws_recv 3 "September 26, 2023" "libcurl 8.4.0" "libcurl"
.SH NAME
curl_ws_recv - receive WebSocket data
.SH SYNOPSIS
.nf
#include <curl/easy.h>
CURLcode curl_ws_recv(CURL *curl, void *buffer, size_t buflen,
size_t *recv, const struct curl_ws_frame **meta);
.fi
.SH DESCRIPTION
This function call is EXPERIMENTAL.
Retrieves as much as possible of a received WebSocket data fragment into the
\fBbuffer\fP, but not more than \fBbuflen\fP bytes. \fIrecv\fP is set to the
number of bytes actually stored.
If there is more fragment data to deliver than what fits in the provided
\fIbuffer\fP, libcurl returns a full buffer and the application needs to call
this function again to continue draining the buffer.
The \fImeta\fP pointer gets set to point to a \fIconst struct curl_ws_frame\fP
that contains information about the received data. See the
\fIcurl_ws_meta(3)\fP for details on that struct.
.SH EXAMPLE
.nf
size_t rlen;
const struct curl_ws_frame *meta;
char buffer[256];
CURLcode result = curl_ws_recv(curl, buffer, sizeof(buffer), &rlen, &meta);
.fi
.SH AVAILABILITY
Added in 7.86.0.
.SH RETURN VALUE
Returns \fBCURLE_OK\fP if everything is okay, and a non-zero number for
errors. Returns \fBCURLE_GOT_NOTHING\fP if the associated connection is
closed.
Instead of blocking, the function returns \fBCURLE_AGAIN\fP. The correct
behavior is then to wait for the socket to signal readability before calling
this function again.
.SH "SEE ALSO"
.BR curl_easy_setopt (3),
.BR curl_easy_perform (3),
.BR curl_easy_getinfo (3),
.BR curl_ws_send (3),
.BR libcurl-ws (3)
man/man3/CURLOPT_STREAM_DEPENDS.3 0000644 00000005427 14751172371 0011626 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_STREAM_DEPENDS 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_STREAM_DEPENDS \- stream this transfer depends on
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_STREAM_DEPENDS,
CURL *dephandle);
.fi
.SH DESCRIPTION
Pass a CURL * pointer in \fIdephandle\fP to identify the stream within the
same connection that this stream is depending upon. This option clears the
exclusive bit and is mutually exclusive to the
\fICURLOPT_STREAM_DEPENDS_E(3)\fP option.
The spec says "Including a dependency expresses a preference to allocate
resources to the identified stream rather than to the dependent stream."
This option can be set during transfer.
\fIdephandle\fP must not be the same as \fIhandle\fP, that makes this function
return an error. It must be another easy handle, and it also needs to be a
handle of a transfer that is about to be sent over the same HTTP/2 connection
for this option to have an actual effect.
.SH DEFAULT
NULL
.SH PROTOCOLS
HTTP/2
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
CURL *curl2 = curl_easy_init(); /* a second handle */
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/one");
/* the second depends on the first */
curl_easy_setopt(curl2, CURLOPT_URL, "https://example.com/two");
curl_easy_setopt(curl2, CURLOPT_STREAM_DEPENDS, curl);
/* then add both to a multi handle and transfer them! */
}
.fi
.SH AVAILABILITY
Added in 7.46.0
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR CURLMOPT_PIPELINING (3),
.BR CURLOPT_HTTP_VERSION (3),
.BR CURLOPT_STREAM_DEPENDS_E (3),
.BR CURLOPT_STREAM_WEIGHT (3)
man/man3/CURLINFO_REDIRECT_URL.3 0000644 00000004725 14751172371 0011505 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLINFO_REDIRECT_URL 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLINFO_REDIRECT_URL \- get the URL a redirect would go to
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_getinfo(CURL *handle, CURLINFO_REDIRECT_URL, char **urlp);
.fi
.SH DESCRIPTION
Pass a pointer to a char pointer to receive the URL a redirect \fIwould\fP
take you to if you would enable \fICURLOPT_FOLLOWLOCATION(3)\fP. This can come
handy if you think using the built-in libcurl redirect logic is not good enough
for you but you would still prefer to avoid implementing all the magic of
figuring out the new URL.
This URL is also set if the \fICURLOPT_MAXREDIRS(3)\fP limit prevented a
redirect to happen (since 7.54.1).
.SH PROTOCOLS
HTTP(S)
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
CURLcode res;
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
res = curl_easy_perform(curl);
if(res == CURLE_OK) {
char *url = NULL;
curl_easy_getinfo(curl, CURLINFO_REDIRECT_URL, &url);
if(url)
printf("Redirect to: %s\\n", url);
}
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Added in 7.18.2
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR curl_easy_getinfo (3),
.BR curl_easy_setopt (3),
.BR CURLINFO_REDIRECT_COUNT (3),
.BR CURLINFO_REDIRECT_TIME_T (3),
.BR CURLOPT_FOLLOWLOCATION (3)
man/man3/CURLINFO_FILETIME.3 0000644 00000005437 14751172371 0010761 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLINFO_FILETIME 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLINFO_FILETIME \- get the remote time of the retrieved document
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_getinfo(CURL *handle, CURLINFO_FILETIME, long *timep);
.fi
.SH DESCRIPTION
Pass a pointer to a long to receive the remote time of the retrieved document
in number of seconds since January 1 1970 in the GMT/UTC time zone. If you get
-1, it can be because of many reasons (it might be unknown, the server might
hide it or the server does not support the command that tells document time
etc) and the time of the document is unknown.
You must tell libcurl to collect this information before the transfer is made,
by using the \fICURLOPT_FILETIME(3)\fP option to \fIcurl_easy_setopt(3)\fP or
you this unconditionally gets a -1 back.
Consider using \fICURLINFO_FILETIME_T(3)\fP to be able to extract dates beyond
the year 2038 on systems using 32 bit longs (Windows).
.SH PROTOCOLS
HTTP(S), FTP(S), SFTP
.SH EXAMPLE
.nf
curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, url);
/* Ask for filetime */
curl_easy_setopt(curl, CURLOPT_FILETIME, 1L);
res = curl_easy_perform(curl);
if(CURLE_OK == res) {
res = curl_easy_getinfo(curl, CURLINFO_FILETIME, &filetime);
if((CURLE_OK == res) && (filetime >= 0)) {
time_t file_time = (time_t)filetime;
printf("filetime %s: %s", filename, ctime(&file_time));
}
}
/* always cleanup */
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Added in 7.5
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR curl_easy_getinfo (3),
.BR curl_easy_setopt (3),
.BR CURLOPT_FILETIME (3)
man/man3/CURLOPT_DNS_LOCAL_IP6.3 0000644 00000004722 14751172371 0011502 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_DNS_LOCAL_IP6 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_DNS_LOCAL_IP6 \- IPv6 address to bind DNS resolves to
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_DNS_LOCAL_IP6, char *address);
.fi
.SH DESCRIPTION
Set the local IPv6 \fIaddress\fP that the resolver should bind to. The
argument should be of type char * and contain a single IPv6 address as a
string. Set this option to NULL to use the default setting (do not bind to a
specific IP address).
The application does not have to keep the string around after setting this
option.
.SH DEFAULT
NULL
.SH PROTOCOLS
All
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/foo.bin");
curl_easy_setopt(curl, CURLOPT_DNS_LOCAL_IP6, "fe80::a9ff:fe46:b619");
ret = curl_easy_perform(curl);
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
This option requires that libcurl was built with a resolver backend that
supports this operation. The c-ares backend is the only such one.
Added in 7.33.0
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, CURLE_UNKNOWN_OPTION if not,
CURLE_NOT_BUILT_IN if support was disabled at compile-time, or
CURLE_BAD_FUNCTION_ARGUMENT when given a bad address.
.SH "SEE ALSO"
.BR CURLOPT_DNS_INTERFACE (3),
.BR CURLOPT_DNS_LOCAL_IP4 (3),
.BR CURLOPT_DNS_SERVERS (3)
man/man3/CURLOPT_TELNETOPTIONS.3 0000644 00000004414 14751172371 0011533 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_TELNETOPTIONS 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_TELNETOPTIONS \- set of telnet options
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_TELNETOPTIONS,
struct curl_slist *cmds);
.fi
.SH DESCRIPTION
Provide a pointer to a curl_slist with variables to pass to the telnet
negotiations. The variables should be in the format <option=value>. libcurl
supports the options \fBTTYPE\fP, \fBXDISPLOC\fP and \fBNEW_ENV\fP. See the
TELNET standard for details.
.SH DEFAULT
NULL
.SH PROTOCOLS
TELNET
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
struct curl_slist *options;
options = curl_slist_append(NULL, "TTTYPE=vt100");
options = curl_slist_append(options, "USER=foobar");
curl_easy_setopt(curl, CURLOPT_URL, "telnet://example.com/");
curl_easy_setopt(curl, CURLOPT_TELNETOPTIONS, options);
ret = curl_easy_perform(curl);
curl_easy_cleanup(curl);
curl_slist_free_all(options);
}
.fi
.SH AVAILABILITY
Along with TELNET
.SH RETURN VALUE
Returns CURLE_OK if TELNET is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR CURLOPT_HTTPHEADER (3),
.BR CURLOPT_QUOTE (3)
man/man3/CURLMOPT_CONTENT_LENGTH_PENALTY_SIZE.3 0000644 00000004401 14751172371 0013776 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLMOPT_CONTENT_LENGTH_PENALTY_SIZE 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLMOPT_CONTENT_LENGTH_PENALTY_SIZE \- size threshold for pipelining penalty
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLMcode curl_multi_setopt(CURLM *handle, CURLMOPT_CONTENT_LENGTH_PENALTY_SIZE,
long size);
.fi
.SH DESCRIPTION
No function since pipelining was removed in 7.62.0.
Pass a long with a \fBsize\fP in bytes. If a transfer in a pipeline is
currently processing a request with a Content-Length larger than this
\fICURLMOPT_CONTENT_LENGTH_PENALTY_SIZE(3)\fP, that pipeline is not considered
for additional requests, even if it is shorter than
\fICURLMOPT_MAX_PIPELINE_LENGTH(3)\fP.
.SH DEFAULT
The default value is 0, which means that the size penalization is inactive.
.SH PROTOCOLS
HTTP(S)
.SH EXAMPLE
.nf
CURLM *m = curl_multi_init();
long maxlength = 10000;
curl_multi_setopt(m, CURLMOPT_CONTENT_LENGTH_PENALTY_SIZE, maxlength);
.fi
.SH AVAILABILITY
Added in 7.30.0
.SH RETURN VALUE
Returns CURLM_OK if the option is supported, and CURLM_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR CURLMOPT_PIPELINING (3),
.BR CURLMOPT_CHUNK_LENGTH_PENALTY_SIZE (3)
man/man3/CURLOPT_TCP_KEEPINTVL.3 0000644 00000004427 14751172371 0011537 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_TCP_KEEPINTVL 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_TCP_KEEPINTVL \- TCP keep-alive interval
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_TCP_KEEPINTVL, long interval);
.fi
.SH DESCRIPTION
Pass a long. Sets the interval, in seconds, to wait between sending keepalive
probes. Not all operating systems support this option. (Added in 7.25.0)
The maximum value this accepts is 2147483648. Any larger value is capped to
this amount.
.SH DEFAULT
60
.SH PROTOCOLS
All
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
/* enable TCP keep-alive for this transfer */
curl_easy_setopt(curl, CURLOPT_TCP_KEEPALIVE, 1L);
/* set keep-alive idle time to 120 seconds */
curl_easy_setopt(curl, CURLOPT_TCP_KEEPIDLE, 120L);
/* interval time between keep-alive probes: 60 seconds */
curl_easy_setopt(curl, CURLOPT_TCP_KEEPINTVL, 60L);
curl_easy_perform(curl);
}
.fi
.SH AVAILABILITY
Always
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR CURLOPT_TCP_KEEPALIVE (3),
.BR CURLOPT_TCP_KEEPIDLE (3)
man/man3/CURLOPT_CONV_TO_NETWORK_FUNCTION.3 0000644 00000007404 14751172371 0013353 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_CONV_TO_NETWORK_FUNCTION 3 "September 27, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_CONV_TO_NETWORK_FUNCTION \- convert data to network from host encoding
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode conv_callback(char *ptr, size_t length);
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_CONV_TO_NETWORK_FUNCTION,
conv_callback);
.SH DESCRIPTION
Pass a pointer to your callback function, which should match the prototype
shown above.
Applies to non-ASCII platforms. \fIcurl_version_info(3)\fP returns the
CURL_VERSION_CONV feature bit set if this option is provided.
The data to be converted is in a buffer pointed to by the \fIptr\fP parameter.
The amount of data to convert is indicated by the \fIlength\fP parameter. The
converted data overlays the input data in the buffer pointed to by the ptr
parameter. \fICURLE_OK\fP must be returned upon successful conversion. A
CURLcode return value defined by curl.h, such as \fICURLE_CONV_FAILED\fP,
should be returned if an error was encountered.
\fICURLOPT_CONV_TO_NETWORK_FUNCTION(3)\fP converts from host encoding to the
network encoding. It is used when commands or ASCII data are sent over the
network.
If you set a callback pointer to NULL, or do not set it at all, the built-in
libcurl iconv functions are used. If HAVE_ICONV was not defined when libcurl
was built, and no callback has been established, the conversion returns the
CURLE_CONV_REQD error code.
If HAVE_ICONV is defined, CURL_ICONV_CODESET_OF_HOST must also be defined.
For example:
\&#define CURL_ICONV_CODESET_OF_HOST "IBM-1047"
The iconv code in libcurl defaults the network and UTF8 codeset names as
follows:
\&#define CURL_ICONV_CODESET_OF_NETWORK "ISO8859-1"
\&#define CURL_ICONV_CODESET_FOR_UTF8 "UTF-8"
You need to override these definitions if they are different on your system.
.SH DEFAULT
NULL
.SH PROTOCOLS
FTP, SMTP, IMAP, POP3
.SH EXAMPLE
.nf
static CURLcode my_conv_from_ebcdic_to_ascii(char *buffer, size_t length)
{
char *tempptrin, *tempptrout;
size_t bytes = length;
int rc;
tempptrin = tempptrout = buffer;
rc = platform_e2a(&tempptrin, &bytes, &tempptrout, &bytes);
if(rc == PLATFORM_CONV_OK) {
return CURLE_OK;
}
else {
return CURLE_CONV_FAILED;
}
}
curl_easy_setopt(curl, CURLOPT_CONV_TO_NETWORK_FUNCTION,
my_conv_from_ebcdic_to_ascii);
.fi
.SH AVAILABILITY
Not available and deprecated since 7.82.0.
Available only if \fBCURL_DOES_CONVERSIONS\fP was defined when libcurl was
built.
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR CURLOPT_CONV_FROM_NETWORK_FUNCTION (3),
.BR CURLOPT_CONV_FROM_UTF8_FUNCTION (3)
man/man3/CURLOPT_DNS_CACHE_TIMEOUT.3 0000644 00000006353 14751172371 0012205 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_DNS_CACHE_TIMEOUT 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_DNS_CACHE_TIMEOUT \- life-time for DNS cache entries
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_DNS_CACHE_TIMEOUT, long age);
.fi
.SH DESCRIPTION
Pass a long, this sets the timeout in seconds. Name resolve results are kept
in memory and used for this number of seconds. Set to zero to completely
disable caching, or set to -1 to make the cached entries remain forever. By
default, libcurl caches this info for 60 seconds.
We recommend users not to tamper with this option unless strictly necessary.
If you do, be careful of using large values that can make the cache size grow
significantly if many different host names are used within that timeout
period.
The name resolve functions of various libc implementations do not re-read name
server information unless explicitly told so (for example, by calling
\fIres_init(3)\fP). This may cause libcurl to keep using the older server even
if DHCP has updated the server info, and this may look like a DNS cache issue
to the casual libcurl-app user.
DNS entries have a "TTL" property but libcurl does not use that. This DNS
cache timeout is entirely speculative that a name resolves to the same address
for a small amount of time into the future.
Since version 8.1.0, libcurl prunes entries from the DNS cache if it exceeds
30,000 entries no matter which timeout value is used.
.SH DEFAULT
60
.SH PROTOCOLS
All
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/foo.bin");
/* only reuse addresses for a short time */
curl_easy_setopt(curl, CURLOPT_DNS_CACHE_TIMEOUT, 2L);
ret = curl_easy_perform(curl);
/* in this second request, the cache is not be used if more than
two seconds have passed since the previous name resolve */
ret = curl_easy_perform(curl);
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Always
.SH RETURN VALUE
Returns CURLE_OK
.SH "SEE ALSO"
.BR CURLOPT_CONNECTTIMEOUT_MS (3),
.BR CURLOPT_DNS_SERVERS (3),
.BR CURLOPT_DNS_USE_GLOBAL_CACHE (3),
.BR CURLOPT_MAXAGE_CONN (3),
.BR CURLOPT_RESOLVE (3)
man/man3/CURLOPT_PROXY_SSLCERT_BLOB.3 0000644 00000006021 14751172371 0012376 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_PROXY_SSLCERT_BLOB 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_PROXY_SSLCERT_BLOB \- SSL proxy client certificate from memory blob
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_PROXY_SSLCERT_BLOB,
struct curl_blob *blob);
.fi
.SH DESCRIPTION
Pass a pointer to a curl_blob structure, which contains information (pointer
and size) about a memory block with binary data of the certificate used to
connect to the HTTPS proxy. The format must be "P12" on Secure Transport or
Schannel. The format must be "P12" or "PEM" on OpenSSL. The string "P12" or
"PEM" must be specified with \fICURLOPT_PROXY_SSLCERTTYPE(3)\fP.
If the blob is initialized with the flags member of struct curl_blob set to
CURL_BLOB_COPY, the application does not have to keep the buffer around after
setting this.
This option is an alternative to \fICURLOPT_PROXY_SSLCERT(3)\fP which instead
expects a file name as input.
.SH DEFAULT
NULL
.SH PROTOCOLS
Used with HTTPS proxy
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
struct curl_blob blob;
blob.data = certificateData;
blob.len = filesize;
blob.flags = CURL_BLOB_COPY;
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/");
curl_easy_setopt(curl, CURLOPT_PROXY, "https://proxy");
curl_easy_setopt(curl, CURLOPT_PROXY_SSLKEY, "key.pem");
curl_easy_setopt(curl, CURLOPT_PROXY_KEYPASSWD, "s3cret");
curl_easy_setopt(curl, CURLOPT_PROXY_SSLCERT_BLOB, &blob);
ret = curl_easy_perform(curl);
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Added in 7.71.0. This option is supported by the OpenSSL, Secure Transport and
Schannel backends.
.SH RETURN VALUE
Returns CURLE_OK if TLS enabled, CURLE_UNKNOWN_OPTION if not, or
CURLE_OUT_OF_MEMORY if there was insufficient heap space.
.SH "SEE ALSO"
.BR CURLOPT_PROXY_SSLCERT (3),
.BR CURLOPT_PROXY_SSLCERTTYPE (3),
.BR CURLOPT_PROXY_SSLKEY (3),
.BR CURLOPT_SSLCERT_BLOB (3)
man/man3/CURLOPT_HSTSWRITEDATA.3 0000644 00000004360 14751172371 0011512 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_HSTSWRITEDATA 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_HSTSWRITEDATA \- pointer passed to the HSTS write callback
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_HSTSWRITEDATA, void *pointer);
.fi
.SH DESCRIPTION
Data \fIpointer\fP to pass to the HSTS write function. If you use the
\fICURLOPT_HSTSWRITEFUNCTION(3)\fP option, this is the pointer you get as
input in the fourth argument to the callback.
This option does not enable HSTS, you need to use \fICURLOPT_HSTS_CTRL(3)\fP to
do that.
.SH DEFAULT
NULL
.SH PROTOCOLS
This feature is only used for HTTP(S) transfer.
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
struct MyData this;
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "http://example.com");
/* pass pointer that gets passed in to the
CURLOPT_HSTSWRITEFUNCTION callback */
curl_easy_setopt(curl, CURLOPT_HSTSWRITEDATA, &this);
curl_easy_perform(curl);
}
.fi
.SH AVAILABILITY
Added in 7.74.0
.SH RETURN VALUE
This returns CURLE_OK.
.SH "SEE ALSO"
.BR CURLOPT_HSTS (3),
.BR CURLOPT_HSTSREADDATA (3),
.BR CURLOPT_HSTSREADFUNCTION (3),
.BR CURLOPT_HSTSWRITEFUNCTION (3)
man/man3/libcurl-easy.3 0000644 00000006027 14751172371 0010651 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.TH libcurl 3 "September 26, 2023" "libcurl 8.4.0" "libcurl"
.SH NAME
libcurl-easy \- easy interface overview
.SH DESCRIPTION
When using libcurl's "easy" interface you init your session and get a handle
(often referred to as an "easy handle"), which you use as input to the easy
interface functions you use. Use \fIcurl_easy_init(3)\fP to get the handle.
You continue by setting all the options you want in the upcoming transfer, the
most important among them is the URL itself (you cannot transfer anything
without a specified URL as you may have figured out yourself). You might want
to set some callbacks as well that are called from the library when data is
available etc. \fIcurl_easy_setopt(3)\fP is used for all this.
\fICURLOPT_URL(3)\fP is the only option you really must set, as otherwise
there can be no transfer. Another commonly used option is
\fICURLOPT_VERBOSE(3)\fP that helps you see what libcurl is doing under the
hood, which is useful when debugging for example. The
\fIcurl_easy_setopt(3)\fP man page has a full index of the almost 300
available options.
If you at any point would like to blank all previously set options for a
single easy handle, you can call \fIcurl_easy_reset(3)\fP and you can also
make a clone of an easy handle (with all its set options) using
\fIcurl_easy_duphandle(3)\fP.
When all is setup, you tell libcurl to perform the transfer using
\fIcurl_easy_perform(3)\fP. It performs the entire transfer operation and does
not return until it is done (successfully or not).
After the transfer has been made, you can set new options and make another
transfer, or if you are done, cleanup the session by calling
\fIcurl_easy_cleanup(3)\fP. If you want persistent connections, you do not
cleanup immediately, but instead run ahead and perform other transfers using
the same easy handle.
.SH "SEE ALSO"
.BR curl_easy_init (3),
.BR curl_easy_cleanup (3),
.BR curl_easy_setopt (3),
.BR libcurl-errors (3),
.BR libcurl-multi (3),
.BR libcurl (3)
man/man3/CURLOPT_PROXY_TRANSFER_MODE.3 0000644 00000004750 14751172371 0012520 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_PROXY_TRANSFER_MODE 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_PROXY_TRANSFER_MODE \- append FTP transfer mode to URL for proxy
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_PROXY_TRANSFER_MODE,
long enabled);
.fi
.SH DESCRIPTION
Pass a long. If the value is set to 1 (one), it tells libcurl to set the
transfer mode (binary or ASCII) for FTP transfers done via an HTTP proxy, by
appending ;type=a or ;type=i to the URL. Without this setting, or it being set
to 0 (zero, the default), \fICURLOPT_TRANSFERTEXT(3)\fP has no effect when
doing FTP via a proxy. Beware that not all proxies support this feature.
.SH DEFAULT
0, disabled
.SH PROTOCOLS
FTP over proxy
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "ftp://example.com/old-server/file.txt");
curl_easy_setopt(curl, CURLOPT_PROXY, "http://localhost:80");
curl_easy_setopt(curl, CURLOPT_PROXY_TRANSFER_MODE, 1L);
curl_easy_setopt(curl, CURLOPT_TRANSFERTEXT, 1L);
ret = curl_easy_perform(curl);
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Added in 7.18.0
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if the
enabled value is not supported.
.SH "SEE ALSO"
.BN CURLOPT_CRLF (3),
.BN CURLOPT_TRANSFERTEXT (3),
.BR CURLOPT_HTTPPROXYTUNNEL (3),
.BR CURLOPT_PROXY (3)
man/man3/CURLINFO_SIZE_UPLOAD_T.3 0000644 00000004204 14751172371 0011653 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLINFO_SIZE_UPLOAD_T 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLINFO_SIZE_UPLOAD_T \- get the number of uploaded bytes
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_getinfo(CURL *handle, CURLINFO_SIZE_UPLOAD_T,
curl_off_t *uploadp);
.fi
.SH DESCRIPTION
Pass a pointer to a \fIcurl_off_t\fP to receive the total amount of bytes that
were uploaded.
.SH PROTOCOLS
All
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
/* Perform the request */
res = curl_easy_perform(curl);
if(!res) {
curl_off_t ul;
res = curl_easy_getinfo(curl, CURLINFO_SIZE_UPLOAD_T, &ul);
if(!res) {
printf("Uploaded %" CURL_FORMAT_CURL_OFF_T " bytes\\n", ul);
}
}
}
.fi
.SH AVAILABILITY
Added in 7.55.0
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR curl_easy_getinfo (3),
.BR curl_easy_setopt (3),
.BR CURLINFO_SIZE_DOWNLOAD_T (3),
.BR CURLINFO_SIZE_UPLOAD (3)
man/man3/CURLOPT_NOBODY.3 0000644 00000005260 14751172371 0010456 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_NOBODY 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_NOBODY \- do the download request without getting the body
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_NOBODY, long opt);
.fi
.SH DESCRIPTION
A long parameter set to 1 tells libcurl to not include the body-part in the
output when doing what would otherwise be a download. For HTTP(S), this makes
libcurl do a HEAD request. For most other protocols it means just not asking
to transfer the body data.
For HTTP operations when \fICURLOPT_NOBODY(3)\fP has been set, disabling this
option (with 0) makes it a GET again - only if the method is still set to be
HEAD. The proper way to get back to a GET request is to set
\fICURLOPT_HTTPGET(3)\fP and for other methods, use the POST or UPLOAD
options.
Enabling \fICURLOPT_NOBODY(3)\fP means asking for a download without a body.
If you do a transfer with HTTP that involves a method other than HEAD, you get
a body (unless the resource and server sends a zero byte body for the specific
URL you request).
.SH DEFAULT
0, the body is transferred
.SH PROTOCOLS
Most
.SH EXAMPLE
.nf
curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
/* get us the resource without a body - use HEAD! */
curl_easy_setopt(curl, CURLOPT_NOBODY, 1L);
/* Perform the request */
curl_easy_perform(curl);
}
.fi
.SH AVAILABILITY
Always
.SH RETURN VALUE
Returns CURLE_OK
.SH "SEE ALSO"
.BR CURLOPT_HTTPGET (3),
.BR CURLOPT_MIMEPOST (3),
.BR CURLOPT_POSTFIELDS (3),
.BR CURLOPT_REQUEST_TARGET (3),
.BR CURLOPT_UPLOAD (3)
man/man3/curl_multi_remove_handle.3 0000644 00000005520 14751172371 0013322 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.TH curl_multi_remove_handle 3 "September 26, 2023" "libcurl 8.4.0" "libcurl"
.SH NAME
curl_multi_remove_handle - remove an easy handle from a multi session
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLMcode curl_multi_remove_handle(CURLM *multi_handle, CURL *easy_handle);
.fi
.SH DESCRIPTION
Removes a given \fIeasy_handle\fP from the \fImulti_handle\fP. This makes the
specified easy handle be removed from this multi handle's control.
When the easy handle has been removed from a multi stack, it is again
perfectly legal to invoke \fIcurl_easy_perform(3)\fP on this easy handle.
Removing an easy handle while being in use is perfectly legal and effectively
halts the transfer in progress involving that easy handle. All other easy
handles and transfers remain unaffected.
It is fine to remove a handle at any time during a transfer, just not from
within any libcurl callback function.
Removing an easy handle from the multi handle before the corresponding
transfer is complete might cause libcurl to close the connection - if the
state of it and the internal protocol handler deem it necessary. Otherwise
libcurl keeps the connection alive in the connection pool associated with the
multi handle, ready to get reused for a future transfer using this multi
handle.
.SH EXAMPLE
.nf
/* when an easy handle has completed, remove it */
msg = curl_multi_info_read(multi_handle, &queued);
if(msg) {
if(msg->msg == CURLMSG_DONE) {
/* a transfer ended */
fprintf(stderr, "Transfer completed\\n");
curl_multi_remove_handle(multi_handle, msg->easy_handle);
}
}
.fi
.SH AVAILABILITY
Added in 7.9.6
.SH RETURN VALUE
CURLMcode type, general libcurl multi interface error code.
.SH "SEE ALSO"
.BR curl_multi_add_handle (3),
.BR curl_multi_cleanup (3),
.BR curl_multi_init (3)
man/man3/CURLINFO_LOCAL_IP.3 0000644 00000005005 14751172371 0010774 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLINFO_LOCAL_IP 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLINFO_LOCAL_IP \- get local IP address of last connection
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_getinfo(CURL *handle, CURLINFO_LOCAL_IP, char **ip);
.fi
.SH DESCRIPTION
Pass a pointer to a char pointer to receive the pointer to a null-terminated
string holding the IP address of the local end of most recent connection done
with this \fBcurl\fP handle. This string may be IPv6 when that is
enabled. Note that you get a pointer to a memory area that is reused at next
request so you need to copy the string if you want to keep the information.
The \fBip\fP pointer is NULL or points to private memory. You MUST NOT free -
it gets freed when you call \fIcurl_easy_cleanup(3)\fP on the corresponding
CURL handle.
.SH PROTOCOLS
All
.SH EXAMPLE
.nf
{
char *ip;
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
/* Perform the transfer */
res = curl_easy_perform(curl);
/* Check for errors */
if((res == CURLE_OK) &&
!curl_easy_getinfo(curl, CURLINFO_LOCAL_IP, &ip) && ip) {
printf("Local IP: %s\\n", ip);
}
/* always cleanup */
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Added in 7.21.0
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR curl_easy_getinfo (3),
.BR curl_easy_setopt (3),
.BR CURLINFO_PRIMARY_IP (3),
.BR CURLINFO_LOCAL_PORT (3)
man/man3/CURLINFO_SIZE_UPLOAD.3 0000644 00000004321 14751172371 0011370 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLINFO_SIZE_UPLOAD 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLINFO_SIZE_UPLOAD \- get the number of uploaded bytes
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_getinfo(CURL *handle, CURLINFO_SIZE_UPLOAD,
double *uploadp);
.fi
.SH DESCRIPTION
Pass a pointer to a double to receive the total amount of bytes that were
uploaded.
\fICURLINFO_SIZE_UPLOAD_T(3)\fP is a newer replacement that returns a more
sensible variable type.
.SH PROTOCOLS
All
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
/* Perform the request */
res = curl_easy_perform(curl);
if(!res) {
double ul;
res = curl_easy_getinfo(curl, CURLINFO_SIZE_UPLOAD, &ul);
if(!res) {
printf("Uploaded %.0f bytes\\n", ul);
}
}
}
.fi
.SH AVAILABILITY
Added in 7.4.1. Deprecated since 7.55.0.
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR curl_easy_getinfo (3),
.BR curl_easy_setopt (3),
.BR CURLINFO_SIZE_DOWNLOAD_T (3),
.BR CURLINFO_SIZE_UPLOAD_T (3)
man/man3/CURLOPT_HEADERDATA.3 0000644 00000005366 14751172371 0011055 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_HEADERDATA 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_HEADERDATA \- pointer to pass to header callback
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_HEADERDATA, void *pointer);
.fi
.SH DESCRIPTION
Pass a \fIpointer\fP to be used to write the header part of the received data
to.
If \fICURLOPT_WRITEFUNCTION(3)\fP or \fICURLOPT_HEADERFUNCTION(3)\fP is used,
\fIpointer\fP is passed in to the respective callback.
If neither of those options are set, \fIpointer\fP must be a valid FILE * and
it is used by a plain fwrite() to write headers to.
If you are using libcurl as a win32 DLL, you \fBMUST\fP use a
\fICURLOPT_WRITEFUNCTION(3)\fP or \fICURLOPT_HEADERFUNCTION(3)\fP if you set
this option or you might experience crashes.
.SH DEFAULT
NULL
.SH PROTOCOLS
All
.SH EXAMPLE
.nf
struct my_info {
int shoesize;
char *secret;
};
static size_t header_callback(char *buffer, size_t size,
size_t nitems, void *userdata)
{
struct my_info *i = (struct my_info *)userdata;
/* now this callback can access the my_info struct */
return nitems * size;
}
CURL *curl = curl_easy_init();
if(curl) {
struct my_info my = { 10, "the cookies are in the cupboard" };
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
curl_easy_setopt(curl, CURLOPT_HEADERFUNCTION, header_callback);
/* pass in custom data to the callback */
curl_easy_setopt(curl, CURLOPT_HEADERDATA, &my);
curl_easy_perform(curl);
}
.fi
.SH AVAILABILITY
Always
.SH RETURN VALUE
Returns CURLE_OK
.SH "SEE ALSO"
.BR curl_easy_header (3),
.BR CURLOPT_HEADERFUNCTION (3),
.BR CURLOPT_WRITEFUNCTION (3)
man/man3/CURLOPT_UNRESTRICTED_AUTH.3 0000644 00000005741 14751172371 0012224 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_UNRESTRICTED_AUTH 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_UNRESTRICTED_AUTH \- send credentials to other hosts too
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_UNRESTRICTED_AUTH,
long goahead);
.SH DESCRIPTION
Set the long \fIgohead\fP parameter to 1L to make libcurl continue to send
authentication (user+password) credentials when following locations, even when
hostname changed. This option is meaningful only when setting
\fICURLOPT_FOLLOWLOCATION(3)\fP.
Further, when this option is not used or set to \fB0L\fP, libcurl does not
send custom nor internally generated Authentication: headers on requests done
to other hosts than the one used for the initial URL.
By default, libcurl only sends credentials and Authentication headers to the
initial host name as given in the original URL, to avoid leaking username +
password to other sites.
This option should be used with caution: when curl follows redirects it
blindly fetches the next URL as instructed by the server. Setting
\fICURLOPT_UNRESTRICTED_AUTH(3)\fP to 1L therefore also makes curl trust the
server and sends possibly sensitive credentials to any host the server points
out. And then maybe again and again as the following hosts can keep
redirecting to new hosts.
.SH DEFAULT
0
.SH PROTOCOLS
HTTP
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
curl_easy_setopt(curl, CURLOPT_FOLLOWLOCATION, 1L);
curl_easy_setopt(curl, CURLOPT_UNRESTRICTED_AUTH, 1L);
curl_easy_perform(curl);
}
.fi
.SH AVAILABILITY
Along with HTTP
.SH RETURN VALUE
Returns CURLE_OK if HTTP is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR CURLOPT_FOLLOWLOCATION (3),
.BR CURLOPT_USERPWD (3),
.BR CURLOPT_MAXREDIRS (3),
.BR CURLOPT_REDIR_PROTOCOLS_STR (3),
.BR CURLINFO_REDIRECT_COUNT (3)
man/man3/CURLOPT_FILETIME.3 0000644 00000004651 14751172371 0010665 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_FILETIME 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_FILETIME \- get the modification time of the remote resource
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_FILETIME, long gettime);
.fi
.SH DESCRIPTION
Pass a long. If it is 1, libcurl attempts to get the modification time of the
remote document in this operation. This requires that the remote server sends
the time or replies to a time querying command. The \fIcurl_easy_getinfo(3)\fP
function with the \fICURLINFO_FILETIME(3)\fP argument can be used after a
transfer to extract the received time (if any).
.SH DEFAULT
0
.SH PROTOCOLS
HTTP(S), FTP(S), SFTP, FILE, SMB(S)
.SH EXAMPLE
.nf
curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, url);
/* Ask for filetime */
curl_easy_setopt(curl, CURLOPT_FILETIME, 1L);
res = curl_easy_perform(curl);
if(CURLE_OK == res) {
res = curl_easy_getinfo(curl, CURLINFO_FILETIME, &filetime);
if((CURLE_OK == res) && (filetime >= 0)) {
time_t file_time = (time_t)filetime;
printf("filetime %s: %s", filename, ctime(&file_time));
}
}
/* always cleanup */
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Always, for SFTP since 7.49.0
.SH RETURN VALUE
Returns CURLE_OK
.SH "SEE ALSO"
.BR curl_easy_getinfo (3),
.BR CURLINFO_FILETIME (3)
man/man3/CURLOPT_MAX_RECV_SPEED_LARGE.3 0000644 00000005027 14751172371 0012563 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_MAX_RECV_SPEED_LARGE 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_MAX_RECV_SPEED_LARGE \- rate limit data download speed
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_MAX_RECV_SPEED_LARGE,
curl_off_t maxspeed);
.SH DESCRIPTION
Pass a curl_off_t as parameter. If a download exceeds this \fImaxspeed\fP
(counted in bytes per second) the transfer pauses to keep the average speed
less than or equal to the parameter value. Defaults to unlimited speed.
This is not an exact science. libcurl attempts to keep the average speed below
the given threshold over a period time.
If you set \fImaxspeed\fP to a value lower than \fICURLOPT_BUFFERSIZE(3)\fP,
libcurl might download faster than the set limit initially.
This option does not affect transfer speeds done with FILE:// URLs.
.SH DEFAULT
0, disabled
.SH PROTOCOLS
All but file://
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
CURLcode ret;
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/");
/* cap the download speed to 31415 bytes/sec */
curl_easy_setopt(curl, CURLOPT_MAX_RECV_SPEED_LARGE, (curl_off_t)31415);
ret = curl_easy_perform(curl);
}
.fi
.SH AVAILABILITY
Added in 7.15.5
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR CURLOPT_LOW_SPEED_LIMIT (3),
.BR CURLOPT_MAX_SEND_SPEED_LARGE (3),
.BR CURLOPT_TIMEOUT (3)
man/man3/CURLOPT_SSL_VERIFYHOST.3 0000644 00000010445 14751172371 0011710 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_SSL_VERIFYHOST 3 "September 27, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_SSL_VERIFYHOST \- verify the certificate's name against host
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_SSL_VERIFYHOST, long verify);
.fi
.SH DESCRIPTION
Pass a long as parameter specifying what to \fIverify\fP.
This option determines whether libcurl verifies that the server cert is for
the server it is known as.
When negotiating TLS and SSL connections, the server sends a certificate
indicating its identity.
When \fICURLOPT_SSL_VERIFYHOST(3)\fP is 2, that certificate must indicate that
the server is the server to which you meant to connect, or the connection
fails. Simply put, it means it has to have the same name in the certificate as
is in the URL you operate against.
Curl considers the server the intended one when the Common Name field or a
Subject Alternate Name field in the certificate matches the host name in the
URL to which you told Curl to connect.
If \fIverify\fP value is set to 1:
In 7.28.0 and earlier: treated as a debug option of some sorts, not supported
anymore due to frequently leading to programmer mistakes.
From 7.28.1 to 7.65.3: setting it to 1 made \fIcurl_easy_setopt(3)\fP return
an error and leaving the flag untouched.
From 7.66.0: treats 1 and 2 the same.
When the \fIverify\fP value is 0, the connection succeeds regardless of the
names in the certificate. Use that ability with caution!
The default value for this option is 2.
This option controls checking the server's certificate's claimed identity.
The server could be lying. To control lying, see
\fICURLOPT_SSL_VERIFYPEER(3)\fP.
WARNING: disabling verification of the certificate allows bad guys to
man-in-the-middle the communication without you knowing it. Disabling
verification makes the communication insecure. Just having encryption on a
transfer is not enough as you cannot be sure that you are communicating with
the correct end-point.
When libcurl uses secure protocols it trusts responses and allows for example
HSTS and Alt-Svc information to be stored and used subsequently. Disabling
certificate verification can make libcurl trust and use such information from
malicious servers.
.SH LIMITATIONS
Secure Transport: If \fIverify\fP value is 0, then SNI is also disabled. SNI is
a TLS extension that sends the hostname to the server. The server may use that
information to do such things as sending back a specific certificate for the
hostname, or forwarding the request to a specific origin server. Some hostnames
may be inaccessible if SNI is not sent.
.SH DEFAULT
2
.SH PROTOCOLS
All TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc.
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
/* Set the default value: strict name check please */
curl_easy_setopt(curl, CURLOPT_SSL_VERIFYHOST, 2L);
curl_easy_perform(curl);
}
.fi
.SH AVAILABILITY
If built TLS enabled.
.SH RETURN VALUE
Returns CURLE_OK if TLS is supported, and CURLE_UNKNOWN_OPTION if not.
If 1 is set as argument, \fICURLE_BAD_FUNCTION_ARGUMENT\fP is returned.
.SH "SEE ALSO"
.BR CURLOPT_CAINFO (3),
.BR CURLOPT_PINNEDPUBLICKEY (3),
.BR CURLOPT_SSL_VERIFYPEER (3)
man/man3/CURLMOPT_PIPELINING_SERVER_BL.3 0000644 00000004703 14751172371 0012703 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLMOPT_PIPELINING_SERVER_BL 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLMOPT_PIPELINING_SERVER_BL \- pipelining server block list
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLMcode curl_multi_setopt(CURLM *handle, CURLMOPT_PIPELINING_SERVER_BL,
char **servers);
.fi
.SH DESCRIPTION
No function since pipelining was removed in 7.62.0.
Pass a \fBservers\fP array of char *, ending with a NULL entry. This is a list
of server types prefixes (in the Server: HTTP header) that are blocked from
pipelining, i.e server types that are known to not support HTTP
pipelining. The array is copied by libcurl.
Note that the comparison matches if the Server: header begins with the string
in the block list, i.e "Server: Ninja 1.2.3" and "Server: Ninja 1.4.0" can
both be blocked by having "Ninja" in the list.
Pass a NULL pointer to clear the block list.
.SH DEFAULT
The default value is NULL, which means that there is no block list.
.SH PROTOCOLS
.SH EXAMPLE
.nf
char *server_block_list[] =
{
"Microsoft-IIS/6.0",
"nginx/0.8.54",
NULL
};
curl_multi_setopt(m, CURLMOPT_PIPELINING_SERVER_BL, server_block_list);
.fi
.SH AVAILABILITY
Added in 7.30.0
.SH RETURN VALUE
Returns CURLM_OK if the option is supported, and CURLM_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR CURLMOPT_PIPELINING (3),
.BR CURLMOPT_PIPELINING_SITE_BL (3)
man/man3/curl_multi_socket.3 0000644 00000010102 14751172371 0011772 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.TH curl_multi_socket 3 "September 26, 2023" "libcurl 8.4.0" "libcurl"
.SH NAME
curl_multi_socket \- reads/writes available data
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLMcode curl_multi_socket(CURLM *multi_handle, curl_socket_t sockfd,
int *running_handles);
CURLMcode curl_multi_socket_all(CURLM *multi_handle,
int *running_handles);
.fi
.SH DESCRIPTION
These functions are deprecated. Do not use. See
\fIcurl_multi_socket_action(3)\fP instead.
At return, the integer \fBrunning_handles\fP points to contains the number of
still running easy handles within the multi handle. When this number reaches
zero, all transfers are complete/done. Note that when you call
\fIcurl_multi_socket_action(3)\fP on a specific socket and the counter
decreases by one, it DOES NOT necessarily mean that this exact socket/transfer
is the one that completed. Use \fIcurl_multi_info_read(3)\fP to figure out
which easy handle that completed.
The \fIcurl_multi_socket_action(3)\fP functions inform the application about
updates in the socket (file descriptor) status by doing none, one, or multiple
calls to the socket callback function set with the
\fICURLMOPT_SOCKETFUNCTION(3)\fP option to \fIcurl_multi_setopt(3)\fP. They
update the status with changes since the previous time the callback was
called.
Get the timeout time by setting the \fICURLMOPT_TIMERFUNCTION(3)\fP option
with \fIcurl_multi_setopt(3)\fP. Your application then gets called with
information on how long to wait for socket actions at most before doing the
timeout action: call the \fIcurl_multi_socket_action(3)\fP function with the
\fBsockfd\fP argument set to CURL_SOCKET_TIMEOUT. You can also use the
\fIcurl_multi_timeout(3)\fP function to poll the value at any given time, but
for an event-based system using the callback is far better than relying on
polling the timeout value.
Usage of \fIcurl_multi_socket(3)\fP is deprecated, whereas the function is
equivalent to \fIcurl_multi_socket_action(3)\fP with \fBev_bitmask\fP set to
0.
Force libcurl to (re-)check all its internal sockets and transfers instead of
just a single one by calling \fIcurl_multi_socket_all(3)\fP. Note that there
should not be any reason to use this function.
.SH EXAMPLE
.nf
/* the event-library gets told when there activity on the socket 'fd',
which we translate to a call to curl_multi_socket_action() */
int running;
rc = curl_multi_socket(multi_handle, fd, &running);
.fi
.SH AVAILABILITY
This function was added in libcurl 7.15.4, and is deemed stable since
7.16.0.
\fIcurl_multi_socket(3)\fP is deprecated, use
\fIcurl_multi_socket_action(3)\fP instead!
.SH "RETURN VALUE"
CURLMcode type, general libcurl multi interface error code.
The return code is for the whole multi stack. Problems still might have
occurred on individual transfers even when one of these functions return OK.
.SH "SEE ALSO"
.BR curl_multi_cleanup (3),
.BR curl_multi_init (3),
.BR curl_multi_fdset (3),
.BR curl_multi_info_read (3),
.BR the hiperfifo.c example
man/man3/CURLOPT_PROGRESSDATA.3 0000644 00000004537 14751172371 0011370 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_PROGRESSDATA 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_PROGRESSDATA \- pointer passed to the progress callback
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_PROGRESSDATA, void *pointer);
.fi
.SH DESCRIPTION
Pass a \fIpointer\fP that is untouched by libcurl and passed as the first
argument in the progress callback set with \fICURLOPT_PROGRESSFUNCTION(3)\fP.
.SH DEFAULT
The default value of this parameter is NULL.
.SH PROTOCOLS
All
.SH EXAMPLE
.nf
struct progress {
char *private;
size_t size;
};
static size_t progress_callback(void *clientp,
double dltotal,
double dlnow,
double ultotal,
double ulnow)
{
struct memory *progress = (struct progress *)clientp;
/* use the values */
return 0; /* all is good */
}
struct progress data;
/* pass struct to callback */
curl_easy_setopt(curl_handle, CURLOPT_PROGRESSDATA, &data);
curl_easy_setopt(curl_handle, CURLOPT_PROGRESSFUNCTION, progress_callback);
.fi
.SH AVAILABILITY
Always
.SH RETURN VALUE
Returns CURLE_OK
.SH "SEE ALSO"
.BR CURLOPT_PROGRESSFUNCTION (3),
.BR CURLOPT_XFERINFOFUNCTION (3)
man/man3/CURLOPT_PROXYPORT.3 0000644 00000004323 14751172371 0011111 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_PROXYPORT 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_PROXYPORT \- port number the proxy listens on
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_PROXYPORT, long port);
.fi
.SH DESCRIPTION
We discourage use of this option.
Pass a long with this option to set the proxy port to connect to unless it is
specified in the proxy string \fICURLOPT_PROXY(3)\fP or uses 443 for https
proxies and 1080 for all others as default.
While this accepts a 'long', the port number is 16 bit so it cannot be larger
than 65535.
.SH DEFAULT
0, not specified which makes it use the default port
.SH PROTOCOLS
All
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/foo.bin");
curl_easy_setopt(curl, CURLOPT_PROXY, "localhost");
curl_easy_setopt(curl, CURLOPT_PROXYPORT, 8080L);
ret = curl_easy_perform(curl);
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Always
.SH RETURN VALUE
Returns CURLE_OK
.SH "SEE ALSO"
.BR CURLINFO_PRIMARY_PORT (3),
.BR CURLOPT_PORT (3),
.BR CURLOPT_PROXY (3),
.BR CURLOPT_PROXYTYPE (3)
man/man3/curl_multi_poll.3 0000644 00000010567 14751172371 0011467 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.TH curl_multi_poll 3 "September 26, 2023" "libcurl 8.4.0" "libcurl"
.SH NAME
curl_multi_poll - polls on all easy handles in a multi handle
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLMcode curl_multi_poll(CURLM *multi_handle,
struct curl_waitfd extra_fds[],
unsigned int extra_nfds,
int timeout_ms,
int *numfds);
.ad
.SH DESCRIPTION
\fIcurl_multi_poll(3)\fP polls all file descriptors used by the curl easy
handles contained in the given multi handle set. It blocks until activity is
detected on at least one of the handles or \fItimeout_ms\fP has passed.
Alternatively, if the multi handle has a pending internal timeout that has a
shorter expiry time than \fItimeout_ms\fP, that shorter time is used instead
to make sure timeout accuracy is reasonably kept.
The calling application may pass additional curl_waitfd structures which are
similar to \fIpoll(2)\fP's \fIpollfd\fP structure to be waited on in the same
call.
On completion, if \fInumfds\fP is non-NULL, it gets populated with the total
number of file descriptors on which interesting events occurred. This number
can include both libcurl internal descriptors as well as descriptors provided
in \fIextra_fds\fP.
The \fIcurl_multi_wakeup(3)\fP function can be used from another thread to
wake up this function and return faster. This is one of the details
that makes this function different than \fIcurl_multi_wait(3)\fP which cannot
be woken up this way.
If no extra file descriptors are provided and libcurl has no file descriptor
to offer to wait for, this function instead waits during \fItimeout_ms\fP
milliseconds (or shorter if an internal timer indicates so). This is the other
detail that makes this function different than \fIcurl_multi_wait(3)\fP.
This function is encouraged to be used instead of select(3) when using the
multi interface to allow applications to easier circumvent the common problem
with 1024 maximum file descriptors.
.SH curl_waitfd
.nf
struct curl_waitfd {
curl_socket_t fd;
short events;
short revents;
};
.fi
.IP CURL_WAIT_POLLIN
Bit flag to curl_waitfd.events indicating the socket should poll on read
events such as new data received.
.IP CURL_WAIT_POLLPRI
Bit flag to curl_waitfd.events indicating the socket should poll on high
priority read events such as out of band data.
.IP CURL_WAIT_POLLOUT
Bit flag to curl_waitfd.events indicating the socket should poll on write
events such as the socket being clear to write without blocking.
.SH EXAMPLE
.nf
CURL *easy_handle;
CURLM *multi_handle;
/* add the individual easy handle */
curl_multi_add_handle(multi_handle, easy_handle);
do {
CURLMcode mc;
int numfds;
mc = curl_multi_perform(multi_handle, &still_running);
if(mc == CURLM_OK) {
/* wait for activity or timeout */
mc = curl_multi_poll(multi_handle, NULL, 0, 1000, &numfds);
}
if(mc != CURLM_OK) {
fprintf(stderr, "curl_multi failed, code %d.\\n", mc);
break;
}
} while(still_running);
curl_multi_remove_handle(multi_handle, easy_handle);
.fi
.SH AVAILABILITY
Added in 7.66.0.
.SH RETURN VALUE
CURLMcode type, general libcurl multi interface error code. See
\fIlibcurl-errors(3)\fP
.SH "SEE ALSO"
.BR curl_multi_fdset (3),
.BR curl_multi_perform (3),
.BR curl_multi_wait (3),
.BR curl_multi_wakeup (3)
man/man3/CURLOPT_CAINFO_BLOB.3 0000644 00000005410 14751172371 0011216 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_CAINFO_BLOB 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_CAINFO_BLOB \- Certificate Authority (CA) bundle in PEM format
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_CAINFO_BLOB,
struct curl_blob *stblob);
.fi
.SH DESCRIPTION
Pass a pointer to a curl_blob structure, which contains information (pointer
and size) about a memory block with binary data of PEM encoded content holding
one or more certificates to verify the HTTPS server with.
If \fICURLOPT_SSL_VERIFYPEER(3)\fP is zero and you avoid verifying the
server's certificate, \fICURLOPT_CAINFO_BLOB(3)\fP is not needed.
This option overrides \fICURLOPT_CAINFO(3)\fP.
.SH DEFAULT
NULL
.SH PROTOCOLS
All TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc.
.SH EXAMPLE
.nf
char *strpem; /* strpem must point to a PEM string */
CURL *curl = curl_easy_init();
if(curl) {
struct curl_blob blob;
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/");
blob.data = strpem;
blob.len = strlen(strpem);
blob.flags = CURL_BLOB_COPY;
curl_easy_setopt(curl, CURLOPT_CAINFO_BLOB, &blob);
ret = curl_easy_perform(curl);
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Added in 7.77.0.
This option is supported by the BearSSL (since 7.79.0), mbedTLS (since 7.81.0),
rustls (since 7.82.0), wolfSSL (since 8.2.0), OpenSSL, Secure Transport and Schannel backends.
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, CURLE_UNKNOWN_OPTION if not, or
CURLE_OUT_OF_MEMORY if there was insufficient heap space.
.SH "SEE ALSO"
.BR CURLOPT_CAINFO (3),
.BR CURLOPT_CAPATH (3),
.BR CURLOPT_SSL_VERIFYPEER (3),
.BR CURLOPT_SSL_VERIFYHOST (3)
man/man3/CURLINFO_PRIMARY_PORT.3 0000644 00000004560 14751172371 0011546 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLINFO_PRIMARY_PORT 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLINFO_PRIMARY_PORT \- get the latest destination port number
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_getinfo(CURL *handle, CURLINFO_PRIMARY_PORT, long *portp);
.fi
.SH DESCRIPTION
Pass a pointer to a long to receive the destination port of the most recent
connection done with this \fBcurl\fP handle.
This is the destination port of the actual TCP or UDP connection libcurl used.
If a proxy was used for the most recent transfer, this is the port number of
the proxy, if no proxy was used it is the port number of the most recently
accessed URL.
.SH PROTOCOLS
All
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
CURLcode res;
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
res = curl_easy_perform(curl);
if(res == CURLE_OK) {
long port;
res = curl_easy_getinfo(curl, CURLINFO_PRIMARY_PORT, &port);
if(!res)
printf("Connected to remote port: %ld\\n", port);
}
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Added in 7.21.0
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR curl_easy_getinfo (3),
.BR curl_easy_setopt (3),
.BR CURLINFO_LOCAL_PORT (3),
.BR CURLINFO_PRIMARY_IP (3)
man/man3/CURLOPT_HAPPY_EYEBALLS_TIMEOUT_MS.3 0000644 00000005132 14751172371 0013430 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_HAPPY_EYEBALLS_TIMEOUT_MS 3 "April 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_HAPPY_EYEBALLS_TIMEOUT_MS \- head start for IPv6 for happy eyeballs
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_HAPPY_EYEBALLS_TIMEOUT_MS,
long timeout);
.fi
.SH DESCRIPTION
Happy eyeballs is an algorithm that attempts to connect to both IPv4 and IPv6
addresses for dual-stack hosts, preferring IPv6 first for \fItimeout\fP
milliseconds. If the IPv6 address cannot be connected to within that time then
a connection attempt is made to the IPv4 address in parallel. The first
connection to be established is the one that is used.
The range of suggested useful values for \fItimeout\fP is limited. Happy
Eyeballs RFC 6555 says "It is RECOMMENDED that connection attempts be paced
150-250 ms apart to balance human factors against network load." libcurl
currently defaults to 200 ms. Firefox and Chrome currently default to 300 ms.
.SH DEFAULT
CURL_HET_DEFAULT (currently defined as 200L)
.SH PROTOCOLS
All except FILE
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
curl_easy_setopt(curl, CURLOPT_HAPPY_EYEBALLS_TIMEOUT_MS, 300L);
curl_easy_perform(curl);
/* always cleanup */
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Added in 7.59.0
.SH RETURN VALUE
Returns CURLE_OK
.SH SEE ALSO
.BR CURLOPT_CONNECTTIMEOUT_MS "(3), "
.BR CURLOPT_TIMEOUT "(3), " CURLOPT_LOW_SPEED_LIMIT "(3), "
man/man3/CURLOPT_HTTPGET.3 0000644 00000004575 14751172371 0010613 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_HTTPGET 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_HTTPGET \- ask for an HTTP GET request
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_HTTPGET, long useget);
.fi
.SH DESCRIPTION
Pass a long. If \fIuseget\fP is 1, this forces the HTTP request to get back to
using GET. Usable if a POST, HEAD, PUT, etc has been used previously using the
same curl \fIhandle\fP.
When setting \fICURLOPT_HTTPGET(3)\fP to 1, libcurl automatically sets
\fICURLOPT_NOBODY(3)\fP to 0 and \fICURLOPT_UPLOAD(3)\fP to 0.
Setting this option to zero has no effect. Applications need to explicitly
select which HTTP request method to use, they cannot deselect a method. To
reset a handle to default method, consider \fIcurl_easy_reset(3)\fP.
.SH DEFAULT
0
.SH PROTOCOLS
HTTP(S)
.SH EXAMPLE
.nf
curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
/* use a GET to fetch this */
curl_easy_setopt(curl, CURLOPT_HTTPGET, 1L);
/* Perform the request */
curl_easy_perform(curl);
}
.fi
.SH AVAILABILITY
Along with HTTP
.SH RETURN VALUE
Returns CURLE_OK if HTTP is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR curl_easy_reset (3),
.BR CURLOPT_NOBODY (3),
.BR CURLOPT_POST (3),
.BR CURLOPT_UPLOAD (3)
man/man3/CURLOPT_SEEKFUNCTION.3 0000644 00000007344 14751172371 0011366 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_SEEKFUNCTION 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_SEEKFUNCTION \- user callback for seeking in input stream
.SH SYNOPSIS
.nf
#include <curl/curl.h>
/* These are the return codes for the seek callbacks */
#define CURL_SEEKFUNC_OK 0
#define CURL_SEEKFUNC_FAIL 1 /* fail the entire transfer */
#define CURL_SEEKFUNC_CANTSEEK 2 /* tell libcurl seeking cannot be done, so
libcurl might try other means instead */
int seek_callback(void *clientp, curl_off_t offset, int origin);
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_SEEKFUNCTION, seek_callback);
.SH DESCRIPTION
Pass a pointer to your callback function, which should match the prototype
shown above.
This function gets called by libcurl to seek to a certain position in the
input stream and can be used to fast forward a file in a resumed upload
(instead of reading all uploaded bytes with the normal read
function/callback). It is also called to rewind a stream when data has already
been sent to the server and needs to be sent again. This may happen when doing
an HTTP PUT or POST with a multi-pass authentication method, or when an
existing HTTP connection is reused too late and the server closes the
connection. The function shall work like fseek(3) or lseek(3) and it gets
SEEK_SET, SEEK_CUR or SEEK_END as argument for \fIorigin\fP, although libcurl
currently only passes SEEK_SET.
\fIclientp\fP is the pointer you set with \fICURLOPT_SEEKDATA(3)\fP.
The callback function must return \fICURL_SEEKFUNC_OK\fP on success,
\fICURL_SEEKFUNC_FAIL\fP to cause the upload operation to fail or
\fICURL_SEEKFUNC_CANTSEEK\fP to indicate that while the seek failed, libcurl
is free to work around the problem if possible. The latter can sometimes be
done by instead reading from the input or similar.
If you forward the input arguments directly to fseek(3) or lseek(3), note that
the data type for \fIoffset\fP is not the same as defined for curl_off_t on
many systems!
.SH DEFAULT
By default, this is NULL and unused.
.SH PROTOCOLS
HTTP, FTP, SFTP
.SH EXAMPLE
.nf
static int seek_cb(void *clientp, curl_off_t offset, int origin)
{
struct data *d = (struct data *)clientp;
lseek(our_fd, offset, origin);
return CURL_SEEKFUNC_OK;
}
{
struct data seek_data;
curl_easy_setopt(CURL *handle, CURLOPT_SEEKFUNCTION, seek_cb);
curl_easy_setopt(CURL *handle, CURLOPT_SEEKDATA, &seek_data);
}
.fi
.SH AVAILABILITY
Added in 7.18.0
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR CURLOPT_DEBUGFUNCTION (3),
.BR CURLOPT_IOCTLFUNCTION (3),
.BR CURLOPT_SEEKDATA (3),
.BR CURLOPT_STDERR (3)
man/man3/CURLOPT_ACCEPTTIMEOUT_MS.3 0000644 00000004115 14751172371 0012067 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_ACCEPTTIMEOUT_MS 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_ACCEPTTIMEOUT_MS \- timeout waiting for FTP server to connect back
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_ACCEPTTIMEOUT_MS, long ms);
.fi
.SH DESCRIPTION
Pass a long telling libcurl the maximum number of milliseconds to wait for a
server to connect back to libcurl when an active FTP connection is used.
.SH DEFAULT
60000 milliseconds
.SH PROTOCOLS
FTP
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "ftp://example.com/path/file");
/* wait no more than 5 seconds for FTP server responses */
curl_easy_setopt(curl, CURLOPT_ACCEPTTIMEOUT_MS, 5000L);
curl_easy_perform(curl);
}
.fi
.SH AVAILABILITY
Added in 7.24.0
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR CURLOPT_CONNECTTIMEOUT_MS (3),
.BR CURLOPT_DEBUGFUNCTION (3),
.BR CURLOPT_STDERR (3)
man/man3/CURLOPT_FOLLOWLOCATION.3 0000644 00000007137 14751172371 0011624 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_FOLLOWLOCATION 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_FOLLOWLOCATION \- follow HTTP 3xx redirects
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_FOLLOWLOCATION, long enable);
.fi
.SH DESCRIPTION
A long parameter set to 1 tells the library to follow any Location: header
redirects that a HTTP server sends in a 30x response. The Location: header can
specify a relative or an absolute URL to follow.
libcurl issues another request for the new URL and follows subsequent new
Location: redirects all the way until no more such headers are returned or the
maximum limit is reached. \fICURLOPT_MAXREDIRS(3)\fP is used to limit the
number of redirects libcurl follows.
libcurl restricts what protocols it automatically follow redirects to. The
accepted target protocols are set with \fICURLOPT_REDIR_PROTOCOLS(3)\fP. By
default libcurl allows HTTP, HTTPS, FTP and FTPS on redirects.
When following a redirect, the specific 30x response code also dictates which
request method libcurl uses in the subsequent request: For 301, 302 and 303
responses libcurl switches method from POST to GET unless
\fICURLOPT_POSTREDIR(3)\fP instructs libcurl otherwise. All other redirect
response codes make libcurl use the same method again.
For users who think the existing location following is too naive, too simple
or just lacks features, it is easy to instead implement your own redirect
follow logic with the use of \fIcurl_easy_getinfo(3)\fP's
\fICURLINFO_REDIRECT_URL(3)\fP option instead of using
\fICURLOPT_FOLLOWLOCATION(3)\fP.
.SH NOTE
Since libcurl changes method or not based on the specific HTTP response code,
setting \fICURLOPT_CUSTOMREQUEST(3)\fP while following redirects may change
what libcurl would otherwise do and if not that carefully may even make it
misbehave since \fICURLOPT_CUSTOMREQUEST(3)\fP overrides the method libcurl
would otherwise select internally.
.SH DEFAULT
0, disabled
.SH PROTOCOLS
HTTP(S)
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
/* example.com is redirected, so we tell libcurl to follow redirection */
curl_easy_setopt(curl, CURLOPT_FOLLOWLOCATION, 1L);
curl_easy_perform(curl);
}
.fi
.SH AVAILABILITY
Along with HTTP
.SH RETURN VALUE
Returns CURLE_OK if HTTP is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR CURLINFO_REDIRECT_COUNT (3),
.BR CURLINFO_REDIRECT_URL (3),
.BR CURLOPT_POSTREDIR (3),
.BR CURLOPT_PROTOCOLS (3),
.BR CURLOPT_REDIR_PROTOCOLS (3)
man/man3/CURLOPT_POSTFIELDSIZE.3 0000644 00000004555 14751172371 0011516 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_POSTFIELDSIZE 3 "September 27, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_POSTFIELDSIZE \- size of POST data pointed to
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_POSTFIELDSIZE, long size);
.fi
.SH DESCRIPTION
If you want to post static data to the server without having libcurl do a
strlen() to measure the data size, this option must be used. When this option
is used you can post fully binary data, which otherwise is likely to fail. If
this size is set to -1, libcurl uses strlen() to get the size or relies on the
\fICURLOPT_READFUNCTION(3)\fP (if used) to signal the end of data.
If you post more than 2GB, use \fICURLOPT_POSTFIELDSIZE_LARGE(3)\fP.
.SH DEFAULT
-1
.SH PROTOCOLS
HTTP
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
const char *data = "data to send";
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
/* size of the POST data */
curl_easy_setopt(curl, CURLOPT_POSTFIELDSIZE, (long) strlen(data));
curl_easy_setopt(curl, CURLOPT_POSTFIELDS, data);
curl_easy_perform(curl);
}
.fi
.SH AVAILABILITY
Along with HTTP
.SH RETURN VALUE
Returns CURLE_OK if HTTP is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR CURLOPT_POSTFIELDS (3),
.BR CURLOPT_POSTFIELDSIZE_LARGE (3)
man/man3/CURLINFO_OS_ERRNO.3 0000644 00000004212 14751172371 0011037 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLINFO_OS_ERRNO 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLINFO_OS_ERRNO \- get errno number from last connect failure
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_getinfo(CURL *handle, CURLINFO_OS_ERRNO, long *errnop);
.fi
.SH DESCRIPTION
Pass a pointer to a long to receive the errno variable from a connect failure.
Note that the value is only set on failure, it is not reset upon a successful
operation. The number is OS and system specific.
.SH PROTOCOLS
All
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
CURLcode res;
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
res = curl_easy_perform(curl);
if(res != CURLE_OK) {
long error;
res = curl_easy_getinfo(curl, CURLINFO_OS_ERRNO, &error);
if(res && error) {
printf("Errno: %ld\\n", error);
}
}
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Added in 7.12.2
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR curl_easy_getinfo (3),
.BR curl_easy_setopt (3)
man/man3/CURLINFO_REFERER.3 0000644 00000004404 14751172371 0010646 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLINFO_REFERER 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLINFO_REFERER \- get the referrer header
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_getinfo(CURL *handle, CURLINFO_REFERER, char **hdrp);
.fi
.SH DESCRIPTION
Pass in a pointer to a char pointer and get the referrer header.
The \fBhdrp\fP pointer is NULL or points to private memory you MUST NOT free -
it gets freed when you call \fIcurl_easy_cleanup(3)\fP on the corresponding
CURL handle.
.SH PROTOCOLS
HTTP(S)
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
CURLcode res;
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
curl_easy_setopt(curl, CURLOPT_REFERER, "https://example.org/referrer");
res = curl_easy_perform(curl);
if(res == CURLE_OK) {
char *hdr = NULL;
curl_easy_getinfo(curl, CURLINFO_REFERER, &hdr);
if(hdr)
printf("Referrer header: %s\\n", hdr);
}
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Added in 7.76.0
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR curl_easy_getinfo (3),
.BR curl_easy_header (3),
.BR curl_easy_setopt (3),
.BR CURLOPT_REFERER (3)
man/man3/curl_mprintf.3 0000644 00000026221 14751172371 0010760 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.TH curl_printf 3 "August 22, 2023" "libcurl 8.4.0" "libcurl"
.SH NAME
curl_maprintf, curl_mfprintf, curl_mprintf, curl_msnprintf, curl_msprintf
curl_mvaprintf, curl_mvfprintf, curl_mvprintf, curl_mvsnprintf,
curl_mvsprintf - formatted output conversion
.SH SYNOPSIS
.nf
#include <curl/mprintf.h>
int curl_mprintf(const char *format, ...);
int curl_mfprintf(FILE *fd, const char *format, ...);
int curl_msprintf(char *buffer, const char *format, ...);
int curl_msnprintf(char *buffer, size_t maxlength, const char *format, ...);
int curl_mvprintf(const char *format, va_list args);
int curl_mvfprintf(FILE *fd, const char *format, va_list args);
int curl_mvsprintf(char *buffer, const char *format, va_list args);
int curl_mvsnprintf(char *buffer, size_t maxlength, const char *format,
va_list args);
char *curl_maprintf(const char *format , ...);
char *curl_mvaprintf(const char *format, va_list args);
.fi
.SH DESCRIPTION
These functions produce output according to the format string and given
arguments. They are mostly clones of the well-known C-style functions but
there are slight differences in behavior.
We discourage users from using any of these functions in new applications.
Functions in the curl_mprintf() family produce output according to a format as
described below. The functions \fBcurl_mprintf()\fP and \fBcurl_mvprintf()\fP
write output to stdout, the standard output stream; \fBcurl_mfprintf()\fP and
\fBcurl_mvfprintf()\fP write output to the given output stream;
\fBcurl_msprintf()\fP, \fBcurl_msnprintf()\fP, \fBcurl_mvsprintf()\fP, and
\fBcurl_mvsnprintf()\fP write to the character string \fBbuffer\fP.
The functions \fBcurl_msnprintf()\fP and \fBcurl_mvsnprintf()\fP write at most
\fImaxlength\fP bytes (including the terminating null byte ('\\0')) to
\fIbuffer\fP.
The functions \fBcurl_mvprintf()\fP, \fBcurl_mvfprintf()\fP,
\fBcurl_mvsprintf()\fP, \fBcurl_mvsnprintf()\fP are equivalent to the
functions \fBcurl_mprintf()\fP, \fBcurl_mfprintf()\fP, \fBcurl_msprintf()\fP,
\fBcurl_msnprintf()\fP, respectively, except that they are called with a
\fIva_list\fP instead of a variable number of arguments. These functions do
not call the \fIva_end\fP macro. Because they invoke the \fIva_arg\fP macro,
the value of \fIap\fP is undefined after the call.
The functions \fBcurl_maprintf()\fP and \fBcurl_mvaprintf()\fP return the
output string as pointer to a newly allocated memory area. The returned string
must be \fIcurl_free(3)\fPed by the receiver.
All of these functions write the output under the control of a format string
that specifies how subsequent arguments are converted for output.
.SH FORMAT STRING
The format string is composed of zero or more directives: ordinary characters
(not %), which are copied unchanged to the output stream; and conversion
specifications, each of which results in fetching zero or more subsequent
arguments. Each conversion specification is introduced by the character %, and
ends with a conversion specifier. In between there may be (in this order) zero
or more \fIflags\fP, an optional minimum \fIfield width\fP, an optional
\fIprecision\fP and an optional \fIlength modifier\fP.
.SH "The $ modifier"
The arguments must correspond properly with the conversion specifier. By
default, the arguments are used in the order given, where each '*' (see Field
width and Precision below) and each conversion specifier asks for the next
argument (and it is an error if insufficiently many arguments are given). One
can also specify explicitly which argument is taken, at each place where an
argument is required, by writing "%m$" instead of '%' and "*m$" instead
of '*', where the decimal integer m denotes the position in the argument list
of the desired argument, indexed starting from 1. Thus,
.nf
curl_mprintf("%*d", width, num);
.fi
and
.nf
curl_mprintf("%2$*1$d", width, num);
.fi
are equivalent. The second style allows repeated references to the same
argument.
If the style using '$' is used, it must be used throughout for all conversions
taking an argument and all width and precision arguments, but it may be mixed
with "%%" formats, which do not consume an argument. There may be no gaps in
the numbers of arguments specified using '$'; for example, if arguments 1 and
3 are specified, argument 2 must also be specified somewhere in the format
string.
.SH "Flag characters"
The character % is followed by zero or more of the following flags:
.TP
.B #
The value should be converted to its "alternate form".
.TP
.B 0
The value should be zero padded.
.TP
.B -
The converted value is to be left adjusted on the field boundary. (The
default is right justification.) The converted value is padded on the right
with blanks, rather than on the left with blanks or zeros. A '-' overrides a
\&'0' if both are given.
.TP
.B ' '
(a space) A blank should be left before a positive number (or empty string)
produced by a signed conversion.
.TP
.B +
A sign (+ or -) should always be placed before a number produced by a signed
conversion. By default, a sign is used only for negative numbers. A '+'
overrides a space if both are used.
.SH "Field width"
An optional decimal digit string (with nonzero first digit) specifying a
minimum field width. If the converted value has fewer characters than the
field width, it gets padded with spaces on the left (or right, if the
left-adjustment flag has been given). Instead of a decimal digit string one
may write "*" or "*m$" (for some decimal integer m) to specify that the field
width is given in the next argument, or in the \fIm-th\fP argument,
respectively, which must be of type int. A negative field width is taken as
a '-' flag followed by a positive field width. In no case does a nonexistent
or small field width cause truncation of a field; if the result of a
conversion is wider than the field width, the field is expanded to contain the
conversion result.
.SH "Precision"
An optional precision in the form of a period ('.') followed by an optional
decimal digit string. Instead of a decimal digit string one may write "*" or
"*m$" (for some decimal integer m) to specify that the precision is given in
the next argument, or in the \fIm-th\fP argument, respectively, which must be of
type int. If the precision is given as just '.', the precision is taken to be
zero. A negative precision is taken as if the precision were omitted. This
gives the minimum number of digits to appear for \fBd\fP, \fBi\fP, \fBo\fP,
\fBu\fP, \fBx\fP, and \fBX\fP conversions, the number of digits to appear
after the radix character for \fBa\fP, \fBA\fP, \fBe\fP, \fBE\fP, \fBf\fP, and
\fBF\fP conversions, the maximum number of significant digits for \fBg\fP and
\fBG\fP conversions, or the maximum number of characters to be printed from a
string for \fBs\fP and \fBS\fP conversions.
.SH "Length modifier"
.TP
.B h
A following integer conversion corresponds to a \fIshort\fP or \fIunsigned
short\fP argument.
.TP
.B l
(ell) A following integer conversion corresponds to a \fIlong\fP or
\fIunsigned long\fP argument, or a following n conversion corresponds to a
pointer to a long argument
.TP
.B ll
(ell-ell). A following integer conversion corresponds to a \fIlong long\fP or
\fIunsigned long long\fP argument, or a following n conversion corresponds to
a pointer to a long long argument.
.TP
.B q
A synonym for \fBll\fP.
.TP
.B L
A following a, A, e, E, f, F, g, or G conversion corresponds to a long double
argument.
.TP
.B z
A following integer conversion corresponds to a \fIsize_t\fP or \fIssize_t\fP
argument.
.SH "Conversion specifiers"
A character that specifies the type of conversion to be applied. The
conversion specifiers and their meanings are:
.TP
.B d, i
The int argument is converted to signed decimal notation. The precision, if
any, gives the minimum number of digits that must appear; if the converted
value requires fewer digits, it is padded on the left with zeros. The default
precision is 1. When 0 is printed with an explicit precision 0, the output is
empty.
.TP
.B o, u, x, X
The unsigned int argument is converted to unsigned octal (o), unsigned decimal
(u), or unsigned hexadecimal (\fBx\fP and \fBX\fP) notation. The letters
\fIabcdef\fP are used for \fBx\fP conversions; the letters \fIABCDEF\fP are
used for \fBX\fP conversions. The precision, if any, gives the minimum number
of digits that must appear; if the converted value requires fewer digits, it
is padded on the left with zeros. The default precision is 1. When 0 is
printed with an explicit precision 0, the output is empty.
.TP
.B e, E
The double argument is rounded and output in the style \fB"[-]d.ddde±dd"\fP
.TP
.B f, F
The double argument is rounded and output to decimal notation in the style
\fB"[-]ddd.ddd"\fP.
.TP
.B g, G
The double argument is converted in style f or e.
.TP
.B c
The int argument is converted to an unsigned char, and the resulting character
is written.
.TP
.B s
The \fIconst char *\fP argument is expected to be a pointer to an array of
character type (pointer to a string). Characters from the array are written up
to (but not including) a terminating null byte. If a precision is specified,
no more than the number specified are written. If a precision is given, no
null byte need be present; if the precision is not specified, or is greater
than the size of the array, the array must contain a terminating null byte.
.TP
.B p
The \fIvoid *\fP pointer argument is printed in hexadecimal.
.TP
.B n
The number of characters written so far is stored into the integer pointed to
by the corresponding argument.
.TP
.B %
A '%' is written. No argument is converted.
.SH EXAMPLE
.nf
curl_mprintf("My name is %s\\n", name);
curl_mprintf("Pi is almost %f\\n", 25/8);
.fi
.SH AVAILABILITY
These functions might be removed from the public libcurl API in the future. Do
not use them in new programs or projects.
.SH RETURN VALUE
The \fBcurl_maprintf\fP and \fBcurl_mvaprintf\fP functions return a pointer to
a newly allocated string, or NULL if it failed.
All other functions return the number of characters actually printed
(excluding the null byte used to end output to strings). Note that this
sometimes differ from how the POSIX versions of these functions work.
.SH "SEE ALSO"
.BR printf "(3), " sprintf "(3), " fprintf "(3), " vprintf "(3) "
man/man3/CURLINFO_CONNECT_TIME_T.3 0000644 00000004635 14751172371 0011754 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLINFO_CONNECT_TIME_T 3 "September 26, 2023" "libcurl 8.4.0" "libcurl"
.SH NAME
CURLINFO_CONNECT_TIME_T \- get the time until connect
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_getinfo(CURL *handle, CURLINFO_CONNECT_TIME_T,
curl_off_t *timep);
.fi
.SH DESCRIPTION
Pass a pointer to a curl_off_t to receive the total time in microseconds from
the start until the connection to the remote host (or proxy) was completed.
When a redirect is followed, the time from each request is added together.
See also the TIMES overview in the \fIcurl_easy_getinfo(3)\fP man page.
.SH PROTOCOLS
All
.SH EXAMPLE
.nf
curl = curl_easy_init();
if(curl) {
curl_off_t connect;
curl_easy_setopt(curl, CURLOPT_URL, url);
res = curl_easy_perform(curl);
if(CURLE_OK == res) {
res = curl_easy_getinfo(curl, CURLINFO_CONNECT_TIME_T, &connect);
if(CURLE_OK == res) {
printf("Time: %" CURL_FORMAT_CURL_OFF_T ".%06ld", connect / 1000000,
(long)(connect % 1000000));
}
}
/* always cleanup */
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Added in 7.61.0
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR curl_easy_getinfo (3),
.BR curl_easy_setopt (3),
.BR CURLINFO_CONNECT_TIME (3),
.BR CURLOPT_CONNECTTIMEOUT (3)
man/man3/CURLINFO_SIZE_DOWNLOAD_T.3 0000644 00000004624 14751172371 0012104 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLINFO_SIZE_DOWNLOAD_T 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLINFO_SIZE_DOWNLOAD_T \- get the number of downloaded bytes
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_getinfo(CURL *handle, CURLINFO_SIZE_DOWNLOAD_T,
curl_off_t *dlp);
.fi
.SH DESCRIPTION
Pass a pointer to a \fIcurl_off_t\fP to receive the total amount of bytes that
were downloaded. The amount is only for the latest transfer and gets reset
again for each new transfer. This counts actual payload data, what's also
commonly called body. All meta and header data is excluded from this amount.
.SH PROTOCOLS
All
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
/* Perform the request */
res = curl_easy_perform(curl);
if(!res) {
/* check the size */
curl_off_t dl;
res = curl_easy_getinfo(curl, CURLINFO_SIZE_DOWNLOAD_T, &dl);
if(!res) {
printf("Downloaded %" CURL_FORMAT_CURL_OFF_T " bytes\\n", dl);
}
}
}
.fi
.SH AVAILABILITY
Added in 7.55.0
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR curl_easy_getinfo (3),
.BR curl_easy_setopt (3),
.BR CURLINFO_SIZE_DOWNLOAD (3),
.BR CURLINFO_SIZE_UPLOAD_T (3),
.BR CURLOPT_MAXFILESIZE (3)
man/man3/libcurl-ws.3 0000644 00000012340 14751172371 0010334 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.TH libcurl 3 "September 26, 2023" "libcurl 8.4.0" "libcurl"
.SH NAME
libcurl-ws \- WebSocket interface overview
.SH DESCRIPTION
The WebSocket interface provides functions for receiving and sending WebSocket
data.
.SH INCLUDE
You still only include <curl/curl.h> in your code.
.SH SETUP
WebSocket is also often known as \fIWebSockets\fP, in plural. It is done by
upgrading a regular HTTP(S) GET request to a WebSocket connection.
WebSocket is a TCP-like message-based communication protocol done over HTTP,
specified in RFC 6455.
To initiate a WebSocket session with libcurl, setup an easy handle to use a
URL with a "WS://" or "WSS://" scheme. "WS" is for cleartext communication
over HTTP and "WSS" is for doing WebSocket securely over HTTPS.
A WebSocket request is done as an HTTP/1 GET request with an "Upgrade
WebSocket" request header field. When the upgrade is accepted by the server,
it responds with a 101 Switching and then the client can speak WebSocket with
the server. The communication can happen in both directions at the same time.
.SH MESSAGES
WebSocket communication is message based. That means that both ends send and
receive entire messages, not streams like TCP. A WebSocket message is sent
over the wire in one or more frames. Each frame in a message can have a size
up to 2^63 bytes.
libcurl delivers WebSocket data as frame fragments. It might send a whole
frame, but it might also deliver them in pieces depending on size and network
patterns. It makes sure to provide the API user about the exact specifics
about the fragment: type, offset, size and how much data there is pending to
arrive for the same frame.
A message has an unknown size until the last frame header for the message has
been received since only frames have set sizes.
.SH "Raw mode"
libcurl can be told to speak WebSocket in "raw mode" by setting the
\fBCURLWS_RAW_MODE\fP bit to the \fICURLOPT_WS_OPTIONS(3)\fP option.
Raw WebSocket means that libcurl passes on the data from the network without
parsing it leaving that entirely to the application. This mode assumes that
the user of this knows WebSocket and can parse and figure out the data all by
itself.
This mode is intended for applications that already have a WebSocket
parser/engine that want to switch over to use libcurl for enabling WebSocket,
but keep parts of the existing software architecture.
.SH PING
WebSocket is designed to allow long-lived sessions and in order to keep the
connections alive, both ends can send PING messages for the other end to
respond with a PONG.
libcurl automatically responds to server PING messages with a PONG. It does
not send any PING messages automatically.
.SH MODELS
Because of the many different ways WebSocket can be used, which is much more
flexible than limited to plain downloads or uploads, libcurl offers two
different API models to use it:
1. Using a write callback with \fICURLOPT_WRITEFUNCTION(3)\fP much like other
downloads for when the traffic is download oriented.
2. Using \fICURLOPT_CONNECT_ONLY(3)\fP and use the WebSocket recv/send
functions.
.SH "Callback model"
When a write callback is set and a WebSocket transfer is performed, the
callback is called to deliver all WebSocket data that arrives.
The callback can then call \fIcurl_ws_meta(3)\fP to learn about the details of
the incoming data fragment.
.SH "CONNECT_ONLY model"
By setting \fICURLOPT_CONNECT_ONLY(3)\fP to \fB2L\fP, the transfer only
establishes and setups the WebSocket communication and then returns control
back to the application.
Once such a setup has been successfully performed, the application can proceed
and use \fIcurl_ws_recv(3)\fP and \fIcurl_ws_send(3)\fP freely to exchange
WebSocket messages with the server.
.SH AVAILABILITY
The WebSocket API was introduced as experimental in 7.86.0 and is still
experimental today.
It is only built-in if explicitly opted in at build time. We discourage use of
the WebSocket API in production because of its experimental state. We might
change API, ABI and behavior before this "goes live".
.SH "SEE ALSO"
.BR curl_easy_init (3),
.BR curl_ws_meta (3),
.BR curl_ws_recv (3),
.BR curl_ws_send (3),
.BR CURLOPT_CONNECT_ONLY (3),
.BR CURLOPT_WRITEFUNCTION (3),
.BR CURLOPT_WS_OPTIONS (3)
man/man3/CURLOPT_TRANSFER_ENCODING.3 0000644 00000004777 14751172371 0012172 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_TRANSFER_ENCODING 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_TRANSFER_ENCODING \- ask for HTTP Transfer Encoding
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_TRANSFER_ENCODING,
long enable);
.fi
.SH DESCRIPTION
Pass a long set to 1L to \fIenable\fP or 0 to disable.
Adds a request for compressed Transfer Encoding in the outgoing HTTP
request. If the server supports this and so desires, it can respond with the
HTTP response sent using a compressed Transfer-Encoding that is automatically
uncompressed by libcurl on reception.
Transfer-Encoding differs slightly from the Content-Encoding you ask for with
\fICURLOPT_ACCEPT_ENCODING(3)\fP in that a Transfer-Encoding is strictly meant
to be for the transfer and thus MUST be decoded before the data arrives in the
client. Traditionally, Transfer-Encoding has been much less used and supported
by both HTTP clients and HTTP servers.
.SH DEFAULT
0
.SH PROTOCOLS
HTTP
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
curl_easy_setopt(curl, CURLOPT_TRANSFER_ENCODING, 1L);
curl_easy_perform(curl);
}
.fi
.SH AVAILABILITY
Added in 7.21.6
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR CURLOPT_ACCEPT_ENCODING (3),
.BR CURLOPT_HTTP_TRANSFER_DECODING (3)
man/man3/CURLOPT_FNMATCH_FUNCTION.3 0000644 00000005252 14751172371 0012052 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_FNMATCH_FUNCTION 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_FNMATCH_FUNCTION \- wildcard match callback
.SH SYNOPSIS
.nf
#include <curl/curl.h>
int fnmatch_callback(void *ptr,
const char *pattern,
const char *string);
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_FNMATCH_FUNCTION,
fnmatch_callback);
.SH DESCRIPTION
Pass a pointer to your callback function, which should match the prototype
shown above.
This callback is used for wildcard matching.
Return \fICURL_FNMATCHFUNC_MATCH\fP if pattern matches the string,
\fICURL_FNMATCHFUNC_NOMATCH\fP if not or \fICURL_FNMATCHFUNC_FAIL\fP if an
error occurred.
.SH DEFAULT
NULL == an internal function for wildcard matching.
.SH PROTOCOLS
FTP
.SH EXAMPLE
.nf
static int my_fnmatch(void *clientp,
const char *pattern, const char *string)
{
struct local_stuff *data = (struct local_stuff *)clientp;
if(string_match(pattern, string))
return CURL_FNMATCHFUNC_MATCH;
else
return CURL_FNMATCHFUNC_NOMATCH;
}
{
struct local_stuff local_data;
curl_easy_setopt(curl, CURLOPT_URL, "ftp://ftp.example.com/file*");
curl_easy_setopt(curl, CURLOPT_WILDCARDMATCH, 1L);
curl_easy_setopt(curl, CURLOPT_FNMATCH_FUNCTION, my_fnmatch);
curl_easy_setopt(curl, CURLOPT_FNMATCH_DATA, &local_data);
}
.fi
.SH AVAILABILITY
Added in 7.21.0
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR CURLOPT_DEBUGFUNCTION (3),
.BR CURLOPT_FNMATCH_DATA (3),
.BR CURLOPT_WILDCARDMATCH (3)
man/man3/CURLOPT_RTSP_REQUEST.3 0000644 00000012525 14751172371 0011466 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_RTSP_REQUEST 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_RTSP_REQUEST \- RTSP request
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_RTSP_REQUEST, long request);
.fi
.SH DESCRIPTION
Tell libcurl what kind of RTSP request to make. Pass one of the following RTSP
enum values as a long in the \fIrequest\fP argument. Unless noted otherwise,
commands require the Session ID to be initialized.
.IP CURL_RTSPREQ_OPTIONS
Used to retrieve the available methods of the server. The application is
responsible for parsing and obeying the response. The session ID is not needed
for this method.
.IP CURL_RTSPREQ_DESCRIBE
Used to get the low level description of a stream. The application should note
what formats it understands in the \fI'Accept:'\fP header. Unless set
manually, libcurl automatically adds in \fI'Accept: application/sdp'\fP.
Time-condition headers are added to Describe requests if the
\fICURLOPT_TIMECONDITION(3)\fP option is used. \fB(The session ID is not
needed for this method)\fP
.IP CURL_RTSPREQ_ANNOUNCE
When sent by a client, this method changes the description of the session. For
example, if a client is using the server to record a meeting, the client can
use Announce to inform the server of all the meta-information about the
session. ANNOUNCE acts like an HTTP PUT or POST just like
\fICURL_RTSPREQ_SET_PARAMETER\fP
.IP CURL_RTSPREQ_SETUP
Setup is used to initialize the transport layer for the session. The
application must set the desired Transport options for a session by using the
\fICURLOPT_RTSP_TRANSPORT(3)\fP option prior to calling setup. If no session
ID is currently set with \fICURLOPT_RTSP_SESSION_ID(3)\fP, libcurl extracts
and uses the session ID in the response to this request. The session ID is not
needed for this method.
.IP CURL_RTSPREQ_PLAY
Send a Play command to the server. Use the \fICURLOPT_RANGE(3)\fP option to
modify the playback time (e.g. \fInpt=10-15\fP).
.IP CURL_RTSPREQ_PAUSE
Send a Pause command to the server. Use the \fICURLOPT_RANGE(3)\fP option with
a single value to indicate when the stream should be
halted. (e.g. \fInpt=25\fP)
.IP CURL_RTSPREQ_TEARDOWN
This command terminates an RTSP session. Simply closing a connection does not
terminate the RTSP session since it is valid to control an RTSP session over
different connections.
.IP CURL_RTSPREQ_GET_PARAMETER
Retrieve a parameter from the server. By default, libcurl adds a
\fIContent-Type: text/parameters\fP header on all non-empty requests unless a
custom one is set. GET_PARAMETER acts just like an HTTP PUT or POST (see
\fICURL_RTSPREQ_SET_PARAMETER\fP). Applications wishing to send a heartbeat
message (e.g. in the presence of a server-specified timeout) should send use
an empty GET_PARAMETER request.
.IP CURL_RTSPREQ_SET_PARAMETER
Set a parameter on the server. By default, libcurl uses a
\fIContent-Type: text/parameters\fP header unless a custom one is set.
The interaction with SET_PARAMETER is much like an HTTP PUT or POST. An
application may either use \fICURLOPT_UPLOAD(3)\fP with
\fICURLOPT_READDATA(3)\fP like a HTTP PUT, or it may use
\fICURLOPT_POSTFIELDS(3)\fP like an HTTP POST. No chunked transfers are
allowed, so the application must set the \fICURLOPT_INFILESIZE(3)\fP in the
former and \fICURLOPT_POSTFIELDSIZE(3)\fP in the latter. Also, there is no use
of multi-part POSTs within RTSP.
.IP CURL_RTSPREQ_RECORD
Used to tell the server to record a session. Use the \fICURLOPT_RANGE(3)\fP
option to modify the record time.
.IP CURL_RTSPREQ_RECEIVE
This is a special request because it does not send any data to the server. The
application may call this function in order to receive interleaved RTP
data. It returns after processing one read buffer of data in order to give the
application a chance to run.
.SH DEFAULT
.SH PROTOCOLS
RTSP
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "rtsp://example.com/");
/* ask for options! */
curl_easy_setopt(curl, CURLOPT_RTSP_REQUEST, CURL_RTSPREQ_OPTIONS);
ret = curl_easy_perform(curl);
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Added in 7.20.0
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR CURLOPT_RTSP_SESSION_ID (3),
.BR CURLOPT_RTSP_STREAM_URI (3)
man/man3/CURLOPT_ABSTRACT_UNIX_SOCKET.3 0000644 00000005062 14751172371 0012602 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_ABSTRACT_UNIX_SOCKET 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_ABSTRACT_UNIX_SOCKET \- abstract Unix domain socket
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_ABSTRACT_UNIX_SOCKET,
char *path);
.fi
.SH DESCRIPTION
Enables the use of an abstract Unix domain socket instead of establishing a
TCP connection to a host. The parameter should be a char * to a
null-terminated string holding the path of the socket. The path is set to
\fIpath\fP prefixed by a NULL byte. This is the convention for abstract
sockets, however it should be stressed that the path passed to this function
should not contain a leading NULL byte.
On non-supporting platforms, the abstract address is interpreted as an empty
string and fails gracefully, generating a runtime error.
This option shares the same semantics as \fICURLOPT_UNIX_SOCKET_PATH(3)\fP in
which documentation more details can be found. Internally, these two options
share the same storage and therefore only one of them can be set per handle.
.SH DEFAULT
Default is NULL.
.SH PROTOCOLS
All
.SH EXAMPLE
.nf
curl_easy_setopt(curl_handle, CURLOPT_ABSTRACT_UNIX_SOCKET, "/tmp/foo.sock");
curl_easy_setopt(curl_handle, CURLOPT_URL, "http://localhost/");
.fi
.SH AVAILABILITY
Added in 7.53.0.
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR CURLOPT_UNIX_SOCKET_PATH (3),
.BR unix (7)
man/man3/CURLOPT_SSH_PUBLIC_KEYFILE.3 0000644 00000005005 14751172371 0012324 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_SSH_PUBLIC_KEYFILE 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_SSH_PUBLIC_KEYFILE \- public key file for SSH auth
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_SSH_PUBLIC_KEYFILE,
char *filename);
.SH DESCRIPTION
Pass a char * pointing to a \fIfilename\fP for your public key. If not used,
libcurl defaults to \fB$HOME/.ssh/id_dsa.pub\fP if the HOME environment
variable is set, and just "id_dsa.pub" in the current directory if HOME is not
set.
If NULL (or an empty string) is passed, libcurl passes no public key to
libssh2, which then computes it from the private key. This is known to work
with libssh2 1.4.0+ linked against OpenSSL.
The application does not have to keep the string around after setting this
option.
.SH DEFAULT
NULL
.SH PROTOCOLS
SFTP and SCP
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "sftp://example.com/file");
curl_easy_setopt(curl, CURLOPT_SSH_PUBLIC_KEYFILE,
"/home/clarkkent/.ssh/id_rsa.pub");
ret = curl_easy_perform(curl);
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
The "" trick was added in 7.26.0
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, CURLE_UNKNOWN_OPTION if not, or
CURLE_OUT_OF_MEMORY if there was insufficient heap space.
.SH "SEE ALSO"
.BR CURLOPT_SSH_PRIVATE_KEYFILE (3),
.BR CURLOPT_SSH_AUTH_TYPES (3)
man/man3/CURLOPT_DOH_SSL_VERIFYSTATUS.3 0000644 00000005131 14751172371 0012644 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_DOH_SSL_VERIFYSTATUS 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_DOH_SSL_VERIFYSTATUS \- verify the DoH SSL certificate's status
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_DOH_SSL_VERIFYSTATUS,
long verify);
.fi
.SH DESCRIPTION
Pass a long as parameter set to 1 to enable or 0 to disable.
This option determines whether libcurl verifies the status of the DoH
(DNS-over-HTTPS) server cert using the "Certificate Status Request" TLS
extension (aka. OCSP stapling).
This option is the DoH equivalent of \fICURLOPT_SSL_VERIFYSTATUS(3)\fP and
only affects requests to the DoH server.
If this option is enabled and the server does not support the TLS extension,
the verification fails.
.SH DEFAULT
0
.SH PROTOCOLS
DoH
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
curl_easy_setopt(curl, CURLOPT_DOH_URL, "https://cloudflare-dns.com/dns-query");
/* Ask for OCSP stapling when verifying the DoH server */
curl_easy_setopt(curl, CURLOPT_DOH_SSL_VERIFYSTATUS, 1L);
curl_easy_perform(curl);
}
.fi
.SH AVAILABILITY
Added in 7.76.0. This option is currently only supported by the OpenSSL, and
GnuTLS TLS backends.
.SH RETURN VALUE
Returns CURLE_OK if OCSP stapling is supported by the SSL backend, otherwise
returns CURLE_NOT_BUILT_IN.
.SH "SEE ALSO"
.BR CURLOPT_DOH_SSL_VERIFYHOST (3),
.BR CURLOPT_DOH_SSL_VERIFYPEER (3),
.BR CURLOPT_SSL_VERIFYSTATUS (3)
man/man3/CURLOPT_ISSUERCERT_BLOB.3 0000644 00000006515 14751172371 0011756 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_ISSUERCERT_BLOB 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_ISSUERCERT_BLOB \- issuer SSL certificate from memory blob
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_ISSUERCERT_BLOB,
struct curl_blob *stblob);
.fi
.SH DESCRIPTION
Pass a pointer to a curl_blob structure, which contains information (pointer
and size) about a memory block with binary data of a CA certificate in PEM
format. If the option is set, an additional check against the peer certificate
is performed to verify the issuer is indeed the one associated with the
certificate provided by the option. This additional check is useful in
multi-level PKI where one needs to enforce that the peer certificate is from a
specific branch of the tree.
This option should be used in combination with the
\fICURLOPT_SSL_VERIFYPEER(3)\fP option. Otherwise, the result of the check is
not considered as failure.
A specific error code (CURLE_SSL_ISSUER_ERROR) is defined with the option,
which is returned if the setup of the SSL/TLS session has failed due to a
mismatch with the issuer of peer certificate (\fICURLOPT_SSL_VERIFYPEER(3)\fP
has to be set too for the check to fail).
If the blob is initialized with the flags member of struct curl_blob set to
CURL_BLOB_COPY, the application does not have to keep the buffer around after
setting this.
This option is an alternative to \fICURLOPT_ISSUERCERT(3)\fP which instead
expects a file name as input.
.SH DEFAULT
NULL
.SH PROTOCOLS
All TLS-based protocols
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
struct curl_blob blob;
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/");
blob.data = certificateData;
blob.len = filesize;
blob.flags = CURL_BLOB_COPY;
curl_easy_setopt(curl, CURLOPT_ISSUERCERT_BLOB, &blob);
ret = curl_easy_perform(curl);
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Added in 7.71.0. This option is supported by the OpenSSL backends.
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, CURLE_UNKNOWN_OPTION if not, or
CURLE_OUT_OF_MEMORY if there was insufficient heap space.
.SH "SEE ALSO"
.BR CURLOPT_ISSUERCERT (3),
.BR CURLOPT_CRLFILE (3),
.BR CURLOPT_SSL_VERIFYHOST (3),
.BR CURLOPT_SSL_VERIFYPEER (3)
man/man3/CURLOPT_COOKIESESSION.3 0000644 00000005114 14751172371 0011477 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_COOKIESESSION 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_COOKIESESSION \- start a new cookie session
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_COOKIESESSION, long init);
.fi
.SH DESCRIPTION
Pass a long set to 1 to mark this as a new cookie "session". It forces libcurl
to ignore all cookies it is about to load that are "session cookies" from the
previous session. By default, libcurl always loads all cookies, independent if
they are session cookies or not. Session cookies are cookies without expiry
date and they are meant to be alive and existing for this "session" only.
A "session" is usually defined in browser land for as long as you have your
browser up, more or less. libcurl needs the application to use this option to
tell it when a new session starts, otherwise it assumes everything is still in
the same session.
.SH DEFAULT
0
.SH PROTOCOLS
HTTP
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/foo.bin");
/* new "session", do not load session cookies */
curl_easy_setopt(curl, CURLOPT_COOKIESESSION, 1L);
/* get the (non session) cookies from this file */
curl_easy_setopt(curl, CURLOPT_COOKIEFILE, "/tmp/cookies.txt");
ret = curl_easy_perform(curl);
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Along with HTTP
.SH RETURN VALUE
Returns CURLE_OK
.SH "SEE ALSO"
.BR CURLOPT_COOKIE (3),
.BR CURLOPT_COOKIEFILE (3),
.BR CURLOPT_COOKIEJAR (3)
man/man3/curl_multi_socket_action.3 0000644 00000012554 14751172371 0013344 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.TH curl_multi_socket_action 3 "September 26, 2023" "libcurl 8.4.0" "libcurl"
.SH NAME
curl_multi_socket_action \- reads/writes available data given an action
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLMcode curl_multi_socket_action(CURLM *multi_handle,
curl_socket_t sockfd,
int ev_bitmask,
int *running_handles);
.fi
.SH DESCRIPTION
When the application has detected action on a socket handled by libcurl, it
should call \fIcurl_multi_socket_action(3)\fP with the \fBsockfd\fP argument
set to the socket with the action. When the events on a socket are known, they
can be passed as an events bitmask \fBev_bitmask\fP by first setting
\fBev_bitmask\fP to 0, and then adding using bitwise OR (|) any combination of
events to be chosen from CURL_CSELECT_IN, CURL_CSELECT_OUT or
CURL_CSELECT_ERR. When the events on a socket are unknown, pass 0 instead, and
libcurl tests the descriptor internally. It is also permissible to pass
CURL_SOCKET_TIMEOUT to the \fBsockfd\fP parameter in order to initiate the
whole process or when a timeout occurs.
At return, \fBrunning_handles\fP points to the number of running easy handles
within the multi handle. When this number reaches zero, all transfers are
complete/done. When you call \fIcurl_multi_socket_action(3)\fP on a specific
socket and the counter decreases by one, it DOES NOT necessarily mean that
this exact socket/transfer is the one that completed. Use
\fIcurl_multi_info_read(3)\fP to figure out which easy handle that completed.
The \fIcurl_multi_socket_action(3)\fP function informs the application about
updates in the socket (file descriptor) status by doing none, one, or multiple
calls to the socket callback function set with the
\fICURLMOPT_SOCKETFUNCTION(3)\fP option to \fIcurl_multi_setopt(3)\fP. They
update the status with changes since the previous time the callback was
called.
Get the timeout time by setting the \fICURLMOPT_TIMERFUNCTION(3)\fP option
with \fIcurl_multi_setopt(3)\fP. Your application then gets called with
information on how long to wait for socket actions at most before doing the
timeout action: call the \fIcurl_multi_socket_action(3)\fP function with the
\fBsockfd\fP argument set to CURL_SOCKET_TIMEOUT. You can also use the
\fIcurl_multi_timeout(3)\fP function to poll the value at any given time, but
for an event-based system using the callback is far better than relying on
polling the timeout value.
When this function returns error, the state of all transfers are uncertain and
they cannot be continued. \fIcurl_multi_socket_action(3)\fP should not be
called again on the same multi handle after an error has been returned, unless
first removing all the handles and adding new ones.
.SH "TYPICAL USAGE"
1. Create a multi handle
2. Set the socket callback with \fICURLMOPT_SOCKETFUNCTION(3)\fP
3. Set the timeout callback with \fICURLMOPT_TIMERFUNCTION(3)\fP, to get to
know what timeout value to use when waiting for socket activities.
4. Add easy handles with curl_multi_add_handle()
5. Provide some means to manage the sockets libcurl is using, so you can check
them for activity. This can be done through your application code, or by way
of an external library such as libevent or glib.
6. Call curl_multi_socket_action(..., CURL_SOCKET_TIMEOUT, 0, ...)
to kickstart everything. To get one or more callbacks called.
7. Wait for activity on any of libcurl's sockets, use the timeout value your
callback has been told.
8, When activity is detected, call curl_multi_socket_action() for the
socket(s) that got action. If no activity is detected and the timeout expires,
call \fIcurl_multi_socket_action(3)\fP with \fICURL_SOCKET_TIMEOUT\fP.
.SH EXAMPLE
.nf
/* the event-library gets told when there activity on the socket 'fd',
which we translate to a call to curl_multi_socket_action() */
int running;
rc = curl_multi_socket_action(multi_handle, fd, EVENT,
&running);
.fi
.SH AVAILABILITY
This function was added in libcurl 7.15.4, and is deemed stable since 7.16.0.
.SH RETURN VALUE
CURLMcode type, general libcurl multi interface error code. See
\fIlibcurl-errors(3)\fP
.SH "SEE ALSO"
.BR curl_multi_cleanup (3),
.BR curl_multi_fdset (3),
.BR curl_multi_info_read (3),
.BR curl_multi_init (3),
.BR the hiperfifo.c example
man/man3/CURLOPT_POSTFIELDS.3 0000644 00000011032 14751172371 0011132 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_POSTFIELDS 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_POSTFIELDS \- data to POST to server
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_POSTFIELDS, char *postdata);
.fi
.SH DESCRIPTION
Pass a char * as parameter, pointing to the data buffer to use in an HTTP POST
operation. The data must be formatted and encoded the way you want the server
to receive it. libcurl does not convert or encode it in any way. For example,
the web server may assume that this data is URL encoded.
The data pointed to is NOT copied by the library: as a consequence, it must be
preserved by the calling application until the associated transfer finishes.
This behavior can be changed (so libcurl does copy the data) by instead using
the \fICURLOPT_COPYPOSTFIELDS(3)\fP option.
This POST is a normal \fBapplication/x-www-form-urlencoded\fP kind (and
libcurl sets that Content-Type by default when this option is used), which is
commonly used by HTML forms. Change Content-Type with
\fICURLOPT_HTTPHEADER(3)\fP.
You can use \fIcurl_easy_escape(3)\fP to URL encode your data, if
necessary. It returns a pointer to an encoded string that can be passed as
\fIpostdata\fP.
Using \fICURLOPT_POSTFIELDS(3)\fP implies setting \fICURLOPT_POST(3)\fP to 1.
If \fICURLOPT_POSTFIELDS(3)\fP is explicitly set to NULL then libcurl gets the
POST data from the read callback. If you want to send a zero-byte POST set
\fICURLOPT_POSTFIELDS(3)\fP to an empty string, or set \fICURLOPT_POST(3)\fP
to 1 and \fICURLOPT_POSTFIELDSIZE(3)\fP to 0.
libcurl assumes this option points to a null-terminated string unless you also
set \fICURLOPT_POSTFIELDSIZE(3)\fP to specify the length of the provided data,
which then is strictly required if you want to send off null bytes included in
the data.
Using POST with HTTP 1.1 implies the use of a "Expect: 100-continue" header,
and libcurl adds that header automatically if the POST is either known to be
larger than 1MB or if the expected size is unknown. You can disable this
header with \fICURLOPT_HTTPHEADER(3)\fP as usual.
To make \fBmultipart/formdata\fP posts, check out the
\fICURLOPT_MIMEPOST(3)\fP option combined with \fIcurl_mime_init(3)\fP.
.SH DEFAULT
NULL
.SH PROTOCOLS
HTTP
.SH EXAMPLE
.nf
/* send an application/x-www-form-urlencoded POST */
CURL *curl = curl_easy_init();
if(curl) {
const char *data = "data to send";
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
/* size of the POST data if strlen() is not good enough */
curl_easy_setopt(curl, CURLOPT_POSTFIELDSIZE, 12L);
/* pass in a pointer to the data - libcurl does not copy */
curl_easy_setopt(curl, CURLOPT_POSTFIELDS, data);
curl_easy_perform(curl);
}
/* send an application/json POST */
CURL *curl = curl_easy_init();
if(curl) {
const char *json = "{\"name\": \"daniel\"}";
struct curl_slist *slist1 = NULL;
slist1 = curl_slist_append(slist1, "Content-Type: application/json");
slist1 = curl_slist_append(slist1, "Accept: application/json");
/* set custom headers */
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, slist1);
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
/* pass in a pointer to the data - libcurl does not copy */
curl_easy_setopt(curl, CURLOPT_POSTFIELDS, json);
curl_easy_perform(curl);
}
.fi
.SH AVAILABILITY
Always
.SH RETURN VALUE
Returns CURLE_OK
.SH "SEE ALSO"
.BR CURLOPT_MIMEPOST (3),
.BR CURLOPT_POSTFIELDSIZE (3),
.BR CURLOPT_READFUNCTION (3),
.BR CURLOPT_UPLOAD (3)
man/man3/CURLOPT_HTTPAUTH.3 0000644 00000013603 14751172371 0010725 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_HTTPAUTH 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_HTTPAUTH \- HTTP server authentication methods to try
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_HTTPAUTH, long bitmask);
.SH DESCRIPTION
Pass a long as parameter, which is set to a bitmask, to tell libcurl which
authentication method(s) you want it to use speaking to the remote server.
The available bits are listed below. If more than one bit is set, libcurl
first queries the host to see which authentication methods it supports and
then picks the best one you allow it to use. For some methods, this induces an
extra network round-trip. Set the actual name and password with the
\fICURLOPT_USERPWD(3)\fP option or with the \fICURLOPT_USERNAME(3)\fP and the
\fICURLOPT_PASSWORD(3)\fP options.
For authentication with a proxy, see \fICURLOPT_PROXYAUTH(3)\fP.
.IP CURLAUTH_BASIC
HTTP Basic authentication. This is the default choice, and the only method
that is in wide-spread use and supported virtually everywhere. This sends
the user name and password over the network in plain text, easily captured by
others.
.IP CURLAUTH_DIGEST
HTTP Digest authentication. Digest authentication is defined in RFC 2617 and
is a more secure way to do authentication over public networks than the
regular old-fashioned Basic method.
.IP CURLAUTH_DIGEST_IE
HTTP Digest authentication with an IE flavor. Digest authentication is
defined in RFC 2617 and is a more secure way to do authentication over public
networks than the regular old-fashioned Basic method. The IE flavor is simply
that libcurl uses a special "quirk" that IE is known to have used before
version 7 and that some servers require the client to use.
.IP CURLAUTH_BEARER
HTTP Bearer token authentication, used primarily in OAuth 2.0 protocol.
You can set the Bearer token to use with \fICURLOPT_XOAUTH2_BEARER(3)\fP.
.IP CURLAUTH_NEGOTIATE
HTTP Negotiate (SPNEGO) authentication. Negotiate authentication is defined
in RFC 4559 and is the most secure way to perform authentication over HTTP.
You need to build libcurl with a suitable GSS-API library or SSPI on Windows
for this to work.
.IP CURLAUTH_NTLM
HTTP NTLM authentication. A proprietary protocol invented and used by
Microsoft. It uses a challenge-response and hash concept similar to Digest, to
prevent the password from being eavesdropped.
You need to build libcurl with either OpenSSL or GnuTLS support for this
option to work, or build libcurl on Windows with SSPI support.
.IP CURLAUTH_NTLM_WB
NTLM delegating to winbind helper. Authentication is performed by a separate
binary application that is executed when needed. The name of the application
is specified at compile time but is typically \fB/usr/bin/ntlm_auth\fP.
Note that libcurl forks when necessary to run the winbind application and kill
it when complete, calling \fBwaitpid()\fP to await its exit when done. On
POSIX operating systems, killing the process causes a SIGCHLD signal to be
raised (regardless of whether \fICURLOPT_NOSIGNAL(3)\fP is set), which must be
handled intelligently by the application. In particular, the application must
not unconditionally call wait() in its SIGCHLD signal handler to avoid being
subject to a race condition. This behavior is subject to change in future
versions of libcurl.
.IP CURLAUTH_ANY
This is a convenience macro that sets all bits and thus makes libcurl pick any
it finds suitable. libcurl automatically selects the one it finds most secure.
.IP CURLAUTH_ANYSAFE
This is a convenience macro that sets all bits except Basic and thus makes
libcurl pick any it finds suitable. libcurl automatically selects the one it
finds most secure.
.IP CURLAUTH_ONLY
This is a meta symbol. OR this value together with a single specific auth
value to force libcurl to probe for unrestricted auth and if not, only that
single auth algorithm is acceptable.
.IP CURLAUTH_AWS_SIGV4
provides AWS V4 signature authentication on HTTPS header
see \fICURLOPT_AWS_SIGV4(3)\fP.
.SH DEFAULT
CURLAUTH_BASIC
.SH PROTOCOLS
HTTP
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
CURLcode ret;
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/");
/* allow whatever auth the server speaks */
curl_easy_setopt(curl, CURLOPT_HTTPAUTH, (long)CURLAUTH_ANY);
curl_easy_setopt(curl, CURLOPT_USERPWD, "james:bond");
ret = curl_easy_perform(curl);
}
.fi
.SH AVAILABILITY
Option Added in 7.10.6.
CURLAUTH_DIGEST_IE was added in 7.19.3
CURLAUTH_ONLY was added in 7.21.3
CURLAUTH_NTLM_WB was added in 7.22.0
CURLAUTH_BEARER was added in 7.61.0
CURLAUTH_AWS_SIGV4 was added in 7.74.0
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, CURLE_UNKNOWN_OPTION if not, or
CURLE_NOT_BUILT_IN if the bitmask specified no supported authentication
methods.
.SH "SEE ALSO"
.BR CURLOPT_PASSWORD (3),
.BR CURLOPT_PROXYAUTH (3),
.BR CURLOPT_USERNAME (3)
man/man3/CURLOPT_PROXY_CAINFO.3 0000644 00000006651 14751172371 0011431 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_PROXY_CAINFO 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_PROXY_CAINFO \- path to proxy Certificate Authority (CA) bundle
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_PROXY_CAINFO, char *path);
.fi
.SH DESCRIPTION
This option is for connecting to an HTTPS proxy, not an HTTPS server.
Pass a char * to a null-terminated string naming a file holding one or more
certificates to verify the HTTPS proxy with.
If \fICURLOPT_PROXY_SSL_VERIFYPEER(3)\fP is zero and you avoid verifying the
server's certificate, \fICURLOPT_PROXY_CAINFO(3)\fP need not even indicate an
accessible file.
This option is by default set to the system path where libcurl's CA
certificate bundle is assumed to be stored, as established at build time.
(iOS and macOS only) If curl is built against Secure Transport, then this
option is supported for backward compatibility with other SSL engines, but it
should not be set. If the option is not set, then curl uses the certificates
in the system and user Keychain to verify the peer, which is the preferred
method of verifying the peer's certificate chain.
The application does not have to keep the string around after setting this
option.
The default value for this can be figured out with \fICURLINFO_CAINFO(3)\fP.
.SH DEFAULT
Built-in system specific
.SH PROTOCOLS
Used with HTTPS proxy
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/");
/* using an HTTPS proxy */
curl_easy_setopt(curl, CURLOPT_PROXY, "https://localhost:443");
curl_easy_setopt(curl, CURLOPT_PROXY_CAINFO, "/etc/certs/cabundle.pem");
ret = curl_easy_perform(curl);
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Added in 7.52.0
For TLS backends that do not support certificate files, the
\fICURLOPT_PROXY_CAINFO(3)\fP option is ignored. Refer to
https://curl.se/docs/ssl-compared.html
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, CURLE_UNKNOWN_OPTION if not, or
CURLE_OUT_OF_MEMORY if there was insufficient heap space.
.SH "SEE ALSO"
.BR CURLOPT_CAINFO (3),
.BR CURLOPT_CAINFO_BLOB (3),
.BR CURLOPT_CAPATH (3),
.BR CURLOPT_PROXY_CAINFO_BLOB (3),
.BR CURLOPT_PROXY_CAPATH (3),
.BR CURLOPT_PROXY_SSL_VERIFYHOST (3),
.BR CURLOPT_PROXY_SSL_VERIFYPEER (3),
.BR CURLOPT_SSL_VERIFYHOST (3),
.BR CURLOPT_SSL_VERIFYPEER (3)
man/man3/CURLOPT_TCP_FASTOPEN.3 0000644 00000004420 14751172371 0011406 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_TCP_FASTOPEN 3 "June 25, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_TCP_FASTOPEN \- TCP Fast Open
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_TCP_FASTOPEN, long enable);
.fi
.SH DESCRIPTION
Pass a long as parameter set to 1L to enable or 0 to disable.
TCP Fast Open (RFC 7413) is a mechanism that allows data to be carried in the
SYN and SYN-ACK packets and consumed by the receiving end during the initial
connection handshake, saving up to one full round-trip time (RTT).
Beware: the TLS session cache does not work when TCP Fast Open is enabled. TCP
Fast Open is also known to be problematic on or across certain networks.
.SH DEFAULT
0
.SH PROTOCOLS
All
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
curl_easy_setopt(curl, CURLOPT_TCP_FASTOPEN, 1L);
curl_easy_perform(curl);
}
.fi
.SH AVAILABILITY
Added in 7.49.0. This option is currently only supported on Linux and macOS
10.11 or later.
.SH RETURN VALUE
Returns CURLE_OK if fast open is supported by the operating system, otherwise
returns CURLE_NOT_BUILT_IN.
.SH SEE ALSO
.BR CURLOPT_SSL_FALSESTART "(3), "
man/man3/CURLOPT_RESOLVER_START_DATA.3 0000644 00000004467 14751172371 0012503 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_RESOLVER_START_DATA 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_RESOLVER_START_DATA \- pointer passed to the resolver start callback
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_RESOLVER_START_DATA,
void *pointer);
.fi
.SH DESCRIPTION
Pass a \fIpointer\fP is be untouched by libcurl and passed as the third
argument in the resolver start callback set with
\fICURLOPT_RESOLVER_START_FUNCTION(3)\fP.
.SH DEFAULT
NULL
.SH PROTOCOLS
All
.SH EXAMPLE
.nf
static int resolver_start_cb(void *resolver_state, void *reserved,
void *userdata)
{
(void)reserved;
printf("Received resolver_state=%p userdata=%p\\n",
resolver_state, userdata);
return 0;
}
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_RESOLVER_START_FUNCTION, resolver_start_cb);
curl_easy_setopt(curl, CURLOPT_RESOLVER_START_DATA, curl);
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
curl_easy_perform(curl);
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Added in 7.59.0
.SH RETURN VALUE
Returns CURLE_OK
.SH "SEE ALSO"
.BR CURLOPT_PREREQFUNCTION (3),
.BR CURLOPT_RESOLVER_START_FUNCTION (3)
man/man3/CURLOPT_AWS_SIGV4.3 0000644 00000010475 14751172371 0011036 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.haxx.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_AWS_SIGV4 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_AWS_SIGV4 \- V4 signature
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_AWS_SIGV4, char *param);
.fi
.SH DESCRIPTION
Provides AWS V4 signature authentication on HTTP(S) header.
.PP
Pass a char * that is the collection of specific arguments are used for
creating outgoing authentication headers. The format of the \fIparam\fP
option is:
.IP provider1[:provider2[:region[:service]]]
.IP provider1,\ provider2
The providers arguments are used for generating some authentication parameters
such as "Algorithm", "date", "request type" and "signed headers".
.IP region
The argument is a geographic area of a resources collection.
It is extracted from the host name specified in the URL if omitted.
.IP service
The argument is a function provided by a cloud.
It is extracted from the host name specified in the URL if omitted.
.PP
NOTE: This call set \fICURLOPT_HTTPAUTH(3)\fP to CURLAUTH_AWS_SIGV4.
Calling \fICURLOPT_HTTPAUTH(3)\fP with CURLAUTH_AWS_SIGV4 is the same
as calling this with \fB"aws:amz"\fP in parameter.
.PP
Example with "Test:Try", when curl uses the algorithm, it generates
\fB"TEST-HMAC-SHA256"\fP for "Algorithm", \fB"x-try-date"\fP and
\fB"X-Try-Date"\fP for "date", \fB"test4_request"\fP for "request type",
\fB"SignedHeaders=content-type;host;x-try-date"\fP for "signed headers"
.PP
If you use just "test", instead of "test:try", test is used for every
generated string.
.SH DEFAULT
By default, the value of this parameter is NULL.
Calling \fICURLOPT_HTTPAUTH(3)\fP with CURLAUTH_AWS_SIGV4 is the same
as calling this with \fB"aws:amz"\fP in parameter.
.SH PROTOCOLS
HTTP
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL,
"https://service.region.example.com/uri");
curl_easy_setopt(c, CURLOPT_AWS_SIGV4, "provider1:provider2");
/* service and region can also be set in CURLOPT_AWS_SIGV4 */
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/uri");
curl_easy_setopt(c, CURLOPT_AWS_SIGV4,
"provider1:provider2:region:service");
curl_easy_setopt(c, CURLOPT_USERPWD, "MY_ACCESS_KEY:MY_SECRET_KEY");
curl_easy_perform(curl);
}
.fi
.SH AVAILABILITY
Added in 7.75.0
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH NOTES
This option overrides the other auth types you might have set in
\fICURLOPT_HTTPAUTH(3)\fP which should be highlighted as this makes this auth
method special. This method cannot be combined with other auth types.
.PP
A sha256 checksum of the request payload is used as input to the signature
calculation. For POST requests, this is a checksum of the provided
\fICURLOPT_POSTFIELDS(3)\fP. Otherwise, it's the checksum of an empty buffer.
For requests like PUT, you can provide your own checksum in an HTTP header named
\fBx-provider2-content-sha256\fP.
.PP
For \fBaws:s3\fP, a \fBx-amz-content-sha256\fP header is added to every request
if not already present. For s3 requests with unknown payload, this header takes
the special value "UNSIGNED-PAYLOAD".
.SH "SEE ALSO"
.BR CURLOPT_HEADEROPT (3),
.BR CURLOPT_HTTPAUTH (3),
.BR CURLOPT_HTTPHEADER (3),
.BR CURLOPT_PROXYAUTH (3)
man/man3/CURLOPT_SSL_VERIFYPEER.3 0000644 00000007771 14751172371 0011676 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_SSL_VERIFYPEER 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_SSL_VERIFYPEER \- verify the peer's SSL certificate
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_SSL_VERIFYPEER, long verify);
.fi
.SH DESCRIPTION
Pass a long as parameter to enable or disable.
This option determines whether curl verifies the authenticity of the peer's
certificate. A value of 1 means curl verifies; 0 (zero) means it does not.
When negotiating a TLS or SSL connection, the server sends a certificate
indicating its identity. Curl verifies whether the certificate is authentic,
i.e. that you can trust that the server is who the certificate says it is.
This trust is based on a chain of digital signatures, rooted in certification
authority (CA) certificates you supply. curl uses a default bundle of CA
certificates (the path for that is determined at build time) and you can
specify alternate certificates with the \fICURLOPT_CAINFO(3)\fP option or the
\fICURLOPT_CAPATH(3)\fP option.
When \fICURLOPT_SSL_VERIFYPEER(3)\fP is enabled, and the verification fails to
prove that the certificate is signed by a CA, the connection fails.
When this option is disabled (set to zero), the CA certificates are not loaded
and the peer certificate verification is simply skipped.
Authenticating the certificate is not enough to be sure about the server. You
typically also want to ensure that the server is the server you mean to be
talking to. Use \fICURLOPT_SSL_VERIFYHOST(3)\fP for that. The check that the
host name in the certificate is valid for the host name you are connecting to
is done independently of the \fICURLOPT_SSL_VERIFYPEER(3)\fP option.
WARNING: disabling verification of the certificate allows bad guys to
man-in-the-middle the communication without you knowing it. Disabling
verification makes the communication insecure. Just having encryption on a
transfer is not enough as you cannot be sure that you are communicating with
the correct end-point.
When libcurl uses secure protocols it trusts responses and allows for example
HSTS and Alt-Svc information to be stored and used subsequently. Disabling
certificate verification can make libcurl trust and use such information from
malicious servers.
.SH DEFAULT
1 - enabled
.SH PROTOCOLS
All TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc.
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
/* Set the default value: strict certificate check please */
curl_easy_setopt(curl, CURLOPT_SSL_VERIFYPEER, 1L);
curl_easy_perform(curl);
}
.fi
.SH AVAILABILITY
If built TLS enabled.
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR CURLOPT_SSL_VERIFYHOST (3),
.BR CURLOPT_PROXY_SSL_VERIFYPEER (3),
.BR CURLOPT_PROXY_SSL_VERIFYHOST (3),
.BR CURLOPT_CAINFO (3),
.BR CURLINFO_CAINFO (3),
.BR CURLINFO_CAPATH (3)
man/man3/CURLOPT_USE_SSL.3 0000644 00000005434 14751172371 0010644 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_USE_SSL 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_USE_SSL \- request using SSL / TLS for the transfer
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_USE_SSL, long level);
.fi
.SH DESCRIPTION
Pass a long using one of the values from below, to make libcurl use your
desired \fIlevel\fP of SSL for the transfer.
These are all protocols that start out plain text and get "upgraded" to SSL
using the STARTTLS command.
This is for enabling SSL/TLS when you use FTP, SMTP, POP3, IMAP etc.
.IP CURLUSESSL_NONE
do not attempt to use SSL.
.IP CURLUSESSL_TRY
Try using SSL, proceed as normal otherwise. Note that server may close the
connection if the negotiation does not succeed.
.IP CURLUSESSL_CONTROL
Require SSL for the control connection or fail with \fICURLE_USE_SSL_FAILED\fP.
.IP CURLUSESSL_ALL
Require SSL for all communication or fail with \fICURLE_USE_SSL_FAILED\fP.
.SH DEFAULT
CURLUSESSL_NONE
.SH PROTOCOLS
FTP, SMTP, POP3, IMAP, LDAP
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "ftp://example.com/dir/file.ext");
/* require use of SSL for this, or fail */
curl_easy_setopt(curl, CURLOPT_USE_SSL, (long)CURLUSESSL_ALL);
/* Perform the request */
curl_easy_perform(curl);
}
.fi
.SH AVAILABILITY
Added in 7.11.0. This option was known as CURLOPT_FTP_SSL up to 7.16.4, and
the constants were known as CURLFTPSSL_*
Handled by LDAP since 7.81.0. Fully supported by the OpenLDAP backend only.
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR CURLOPT_SSLVERSION (3),
.BR CURLOPT_PROXY_SSLVERSION (3),
.BR CURLOPT_SSL_OPTIONS (3)
man/man3/curl_slist_append.3 0000644 00000005153 14751172371 0011767 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.TH curl_slist_append 3 "September 26, 2023" "libcurl 8.4.0" "libcurl"
.SH NAME
curl_slist_append - add a string to an slist
.SH SYNOPSIS
.nf
#include <curl/curl.h>
struct curl_slist *curl_slist_append(struct curl_slist *list,
const char *string);
.fi
.SH DESCRIPTION
\fIcurl_slist_append(3)\fP appends a string to a linked list of strings. The
existing \fBlist\fP should be passed as the first argument and the new list is
returned from this function. Pass in NULL in the \fBlist\fP argument to create
a new list. The specified \fBstring\fP has been appended when this function
returns. \fIcurl_slist_append(3)\fP copies the string.
The list should be freed again (after usage) with
\fIcurl_slist_free_all(3)\fP.
.SH EXAMPLE
.nf
CURL *handle;
struct curl_slist *slist=NULL;
struct curl_slist *temp=NULL;
slist = curl_slist_append(slist, "pragma:");
if (slist == NULL)
return -1;
temp = curl_slist_append(slist, "Accept:")
if (temp == NULL) {
curl_slist_free_all(slist);
return -1;
}
slist = temp;
curl_easy_setopt(handle, CURLOPT_HTTPHEADER, slist);
curl_easy_perform(handle);
curl_slist_free_all(slist); /* free the list again */
.fi
.SH AVAILABILITY
Always
.SH RETURN VALUE
A null pointer is returned if anything went wrong, otherwise the new list
pointer is returned. To avoid overwriting an existing non-empty list on
failure, the new list should be returned to a temporary variable which can
be tested for NULL before updating the original list pointer.
.SH "SEE ALSO"
.BR curl_slist_free_all (3)
man/man3/CURLOPT_TLS13_CIPHERS.3 0000644 00000005435 14751172371 0011453 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_TLS13_CIPHERS 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_TLS13_CIPHERS \- ciphers suites to use for TLS 1.3
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_TLS13_CIPHERS, char *list);
.fi
.SH DESCRIPTION
Pass a char *, pointing to a null-terminated string holding the list of cipher
suites to use for the TLS 1.3 connection. The list must be syntactically
correct, it consists of one or more cipher suite strings separated by colons.
Find more details about cipher lists on this URL:
https://curl.se/docs/ssl-ciphers.html
This option is currently used only when curl is built to use OpenSSL 1.1.1 or
later, or Schannel. If you are using a different SSL backend you can try
setting TLS 1.3 cipher suites by using the \fICURLOPT_SSL_CIPHER_LIST(3)\fP
option.
The application does not have to keep the string around after setting this
option.
.SH DEFAULT
NULL, use internal default
.SH PROTOCOLS
All TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc.
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/");
curl_easy_setopt(curl, CURLOPT_TLS13_CIPHERS,
"TLS_CHACHA20_POLY1305_SHA256");
ret = curl_easy_perform(curl);
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Added in 7.61.0 for OpenSSL. Available when built with OpenSSL >= 1.1.1.
Added in 7.85.0 for Schannel.
.SH RETURN VALUE
Returns CURLE_OK if supported, CURLE_NOT_BUILT_IN otherwise.
.SH "SEE ALSO"
.BR CURLOPT_PROXY_SSL_CIPHER_LIST (3),
.BR CURLOPT_PROXY_SSLVERSION (3),
.BR CURLOPT_PROXY_TLS13_CIPHERS (3),
.BR CURLOPT_SSL_CIPHER_LIST (3),
.BR CURLOPT_SSLVERSION (3),
.BR CURLOPT_USE_SSL (3)
man/man3/CURLOPT_FTPPORT.3 0000644 00000007056 14751172371 0010627 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_FTPPORT 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_FTPPORT \- make FTP transfer active
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_FTPPORT, char *spec);
.fi
.SH DESCRIPTION
Pass a pointer to a null-terminated string as parameter. It specifies that the
FTP transfer should be made actively and the given string is used to get the
IP address to use for the FTP PORT instruction.
The PORT instruction tells the remote server to do a TCP connect to our
specified IP address. The string may be a plain IP address, a host name, a
network interface name (under Unix) or just a '-' symbol to let the library
use your system's default IP address. Default FTP operations are passive, and
does not use the PORT command.
The address can be followed by a ':' to specify a port, optionally followed by
a '-' to specify a port range. If the port specified is 0, the operating
system picks a free port. If a range is provided and all ports in the range
are not available, libcurl reports CURLE_FTP_PORT_FAILED for the
handle. Invalid port/range settings are ignored. IPv6 addresses followed by a
port or port range have to be in brackets. IPv6 addresses without port/range
specifier can be in brackets.
Examples with specified ports:
.nf
eth0:0
192.168.1.2:32000-33000
curl.se:32123
[::1]:1234-4567
.fi
We strongly advise against specifying the address with a name, as it causes
libcurl to do a blocking name resolve call to retrieve the IP address. That
name resolve operation does \fBnot\fP use DNS-over-HTTPS even if
\fICURLOPT_DOH_URL(3)\fP is set.
Using anything else than "-" for this option should typically only be done if
you have special knowledge and confirmation that it works.
You disable PORT again and go back to using the passive version by setting
this option to NULL.
The application does not have to keep the string around after setting this
option.
.SH DEFAULT
NULL
.SH PROTOCOLS
FTP
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "ftp://example.com/old-server/file.txt");
curl_easy_setopt(curl, CURLOPT_FTPPORT, "-");
ret = curl_easy_perform(curl);
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Port range support was added in 7.19.5
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, CURLE_UNKNOWN_OPTION if not, or
CURLE_OUT_OF_MEMORY if there was insufficient heap space.
.SH "SEE ALSO"
.BR CURLOPT_FTP_USE_EPRT (3),
.BR CURLOPT_FTP_USE_EPSV (3)
man/man3/CURLINFO_PROXY_ERROR.3 0000644 00000006406 14751172371 0011452 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLINFO_PROXY_ERROR 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLINFO_PROXY_ERROR \- get the detailed (SOCKS) proxy error
.SH SYNOPSIS
.nf
#include <curl/curl.h>
typedef enum {
CURLPX_OK,
CURLPX_BAD_ADDRESS_TYPE,
CURLPX_BAD_VERSION,
CURLPX_CLOSED,
CURLPX_GSSAPI,
CURLPX_GSSAPI_PERMSG,
CURLPX_GSSAPI_PROTECTION,
CURLPX_IDENTD,
CURLPX_IDENTD_DIFFER,
CURLPX_LONG_HOSTNAME,
CURLPX_LONG_PASSWD,
CURLPX_LONG_USER,
CURLPX_NO_AUTH,
CURLPX_RECV_ADDRESS,
CURLPX_RECV_AUTH,
CURLPX_RECV_CONNECT,
CURLPX_RECV_REQACK,
CURLPX_REPLY_ADDRESS_TYPE_NOT_SUPPORTED,
CURLPX_REPLY_COMMAND_NOT_SUPPORTED,
CURLPX_REPLY_CONNECTION_REFUSED,
CURLPX_REPLY_GENERAL_SERVER_FAILURE,
CURLPX_REPLY_HOST_UNREACHABLE,
CURLPX_REPLY_NETWORK_UNREACHABLE,
CURLPX_REPLY_NOT_ALLOWED,
CURLPX_REPLY_TTL_EXPIRED,
CURLPX_REPLY_UNASSIGNED,
CURLPX_REQUEST_FAILED,
CURLPX_RESOLVE_HOST,
CURLPX_SEND_AUTH,
CURLPX_SEND_CONNECT,
CURLPX_SEND_REQUEST,
CURLPX_UNKNOWN_FAIL,
CURLPX_UNKNOWN_MODE,
CURLPX_USER_REJECTED,
CURLPX_LAST /* never use */
} CURLproxycode;
CURLcode curl_easy_getinfo(CURL *handle, CURLINFO_PROXY_ERROR, long *detail);
.fi
.SH DESCRIPTION
Pass a pointer to a long to receive a detailed error code when the most recent
transfer returned a \fBCURLE_PROXY\fP error. That error code matches the
\fBCURLproxycode\fP set.
The error code is zero (\fBCURLPX_OK\fP) if no response code was available.
.SH PROTOCOLS
All that can be done over SOCKS
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
CURLcode res;
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
curl_easy_setopt(curl, CURLOPT_PROXY, "socks5://127.0.0.1");
res = curl_easy_perform(curl);
if(res == CURLE_PROXY) {
long proxycode;
res = curl_easy_getinfo(curl, CURLINFO_PROXY_ERROR, &proxycode);
if(!res && proxycode)
printf("The detailed proxy error: %ld\\n", proxycode);
}
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Added in 7.73.0
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR curl_easy_getinfo (3),
.BR curl_easy_setopt (3),
.BR CURLINFO_RESPONSE_CODE (3),
.BR libcurl-errors (3)
man/man3/CURLOPT_SSH_KNOWNHOSTS.3 0000644 00000004730 14751172371 0011717 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_SSH_KNOWNHOSTS 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_SSH_KNOWNHOSTS \- file name holding the SSH known hosts
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_SSH_KNOWNHOSTS, char *fname);
.fi
.SH DESCRIPTION
Pass a pointer to a null-terminated string holding the file name of the
known_host file to use. The known_hosts file should use the OpenSSH file
format as supported by libssh2. If this file is specified, libcurl only
accepts connections with hosts that are known and present in that file, with a
matching public key. Use \fICURLOPT_SSH_KEYFUNCTION(3)\fP to alter the default
behavior on host and key matches and mismatches.
The application does not have to keep the string around after setting this
option.
.SH DEFAULT
NULL
.SH PROTOCOLS
SFTP and SCP
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "sftp://example.com/file");
curl_easy_setopt(curl, CURLOPT_SSH_KNOWNHOSTS,
"/home/clarkkent/.ssh/known_hosts");
ret = curl_easy_perform(curl);
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Added in 7.19.6
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, CURLE_UNKNOWN_OPTION if not, or
CURLE_OUT_OF_MEMORY if there was insufficient heap space.
.SH "SEE ALSO"
.BR CURLOPT_SSH_AUTH_TYPES (3),
.BR CURLOPT_SSH_HOST_PUBLIC_KEY_MD5 (3)
man/man3/CURLOPT_RTSP_TRANSPORT.3 0000644 00000004606 14751172371 0011733 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_RTSP_TRANSPORT 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_RTSP_TRANSPORT \- RTSP Transport: header
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_RTSP_TRANSPORT,
char *transport);
.SH DESCRIPTION
Pass a char * to tell libcurl what to pass for the Transport: header for this
RTSP session. This is mainly a convenience method to avoid needing to set a
custom Transport: header for every SETUP request. The application must set a
Transport: header before issuing a SETUP request.
The application does not have to keep the string around after setting this
option.
.SH DEFAULT
NULL
.SH PROTOCOLS
RTSP
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "rtsp://example.com/");
curl_easy_setopt(curl, CURLOPT_RTSP_REQUEST, CURL_RTSPREQ_SETUP);
curl_easy_setopt(curl, CURLOPT_RTSP_TRANSPORT,
"RTP/AVP;unicast;client_port=4588-4589");
ret = curl_easy_perform(curl);
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Added in 7.20.0
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, CURLE_UNKNOWN_OPTION if not, or
CURLE_OUT_OF_MEMORY if there was insufficient heap space.
.SH "SEE ALSO"
.BR CURLOPT_RTSP_REQUEST (3),
.BR CURLOPT_RTSP_SESSION_ID (3)
man/man3/CURLOPT_COPYPOSTFIELDS.3 0000644 00000005655 14751172371 0011643 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_COPYPOSTFIELDS 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_COPYPOSTFIELDS \- have libcurl copy data to POST
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_COPYPOSTFIELDS, char *data);
.fi
.SH DESCRIPTION
Pass a char * as parameter, which should be the full \fIdata\fP to post in a
HTTP POST operation. It behaves as the \fICURLOPT_POSTFIELDS(3)\fP option, but
the original data is instead copied by the library, allowing the application
to overwrite the original data after setting this option.
Because data are copied, care must be taken when using this option in
conjunction with \fICURLOPT_POSTFIELDSIZE(3)\fP or
\fICURLOPT_POSTFIELDSIZE_LARGE(3)\fP: If the size has not been set prior to
\fICURLOPT_COPYPOSTFIELDS(3)\fP, the data is assumed to be a null-terminated
string; else the stored size informs the library about the byte count to
copy. In any case, the size must not be changed after
\fICURLOPT_COPYPOSTFIELDS(3)\fP, unless another \fICURLOPT_POSTFIELDS(3)\fP or
\fICURLOPT_COPYPOSTFIELDS(3)\fP option is issued.
.SH DEFAULT
NULL
.SH PROTOCOLS
HTTP(S)
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
char local_buffer[1024]="data to send";
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
/* size of the data to copy from the buffer and send in the request */
curl_easy_setopt(curl, CURLOPT_POSTFIELDSIZE, 12L);
/* send data from the local stack */
curl_easy_setopt(curl, CURLOPT_COPYPOSTFIELDS, local_buffer);
curl_easy_perform(curl);
}
.fi
.SH AVAILABILITY
Added in 7.17.1
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, CURLE_UNKNOWN_OPTION if not, or
CURLE_OUT_OF_MEMORY if there was insufficient heap space.
.SH "SEE ALSO"
.BR CURLOPT_MIMEPOST (3),
.BR CURLOPT_POSTFIELDS (3),
.BR CURLOPT_POSTFIELDSIZE (3),
.BR CURLOPT_UPLOAD (3)
man/man3/CURLOPT_CHUNK_END_FUNCTION.3 0000644 00000004653 14751172371 0012334 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_CHUNK_END_FUNCTION 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_CHUNK_END_FUNCTION \- callback after a transfer with FTP wildcard match
.SH SYNOPSIS
.nf
#include <curl/curl.h>
long chunk_end_callback(void *ptr);
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_CHUNK_END_FUNCTION,
chunk_end_callback);
.SH DESCRIPTION
Pass a pointer to your callback function, which should match the prototype
shown above.
This function gets called by libcurl as soon as a part of the stream has been
transferred (or skipped).
Return \fICURL_CHUNK_END_FUNC_OK\fP if everything is fine or
\fBCURL_CHUNK_END_FUNC_FAIL\fP to tell the lib to stop if some error occurred.
.SH DEFAULT
NULL
.SH PROTOCOLS
FTP
.SH EXAMPLE
.nf
static long file_is_downloaded(struct callback_data *data)
{
if(data->output) {
fclose(data->output);
data->output = 0x0;
}
return CURL_CHUNK_END_FUNC_OK;
}
int main()
{
/* data for callback */
struct callback_data callback_info;
curl_easy_setopt(curl, CURLOPT_CHUNK_END_FUNCTION, file_is_downloaded);
curl_easy_setopt(curl, CURLOPT_CHUNK_DATA, &callback_info);
}
.fi
.SH AVAILABILITY
Added in 7.21.0
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR CURLOPT_CHUNK_BGN_FUNCTION (3),
.BR CURLOPT_WILDCARDMATCH (3)
man/man3/curl_url.3 0000644 00000004344 14751172371 0010105 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.TH curl_url 3 "September 26, 2023" "libcurl 8.4.0" "libcurl"
.SH NAME
curl_url - returns a new URL handle
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLU *curl_url();
.fi
.SH DESCRIPTION
This function allocates a URL object and returns a \fICURLU\fP handle for it,
to be used as input to all other URL API functions.
This is a handle to a URL object that holds or can hold URL components for a
single URL. When the object is first created, there is of course no components
stored. They are then set in the object with the \fIcurl_url_set(3)\fP
function.
.SH EXAMPLE
.nf
CURLUcode rc;
CURLU *url = curl_url();
rc = curl_url_set(url, CURLUPART_URL, "https://example.com", 0);
if(!rc) {
char *scheme;
rc = curl_url_get(url, CURLUPART_SCHEME, &scheme, 0);
if(!rc) {
printf("the scheme is %s\\n", scheme);
curl_free(scheme);
}
curl_url_cleanup(url);
}
.fi
.SH AVAILABILITY
Added in 7.62.0
.SH RETURN VALUE
Returns a \fBCURLU *\fP if successful, or NULL if out of memory.
.SH "SEE ALSO"
.BR curl_url_cleanup (3),
.BR curl_url_dup (3),
.BR curl_url_get (3),
.BR curl_url_set (3),
.BR curl_url_strerror (3),
.BR CURLOPT_CURLU (3)
man/man3/CURLOPT_CLOSESOCKETFUNCTION.3 0000644 00000005133 14751172371 0012407 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_CLOSESOCKETFUNCTION 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_CLOSESOCKETFUNCTION \- callback to socket close replacement
.SH SYNOPSIS
.nf
#include <curl/curl.h>
int closesocket_callback(void *clientp, curl_socket_t item);
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_CLOSESOCKETFUNCTION,
closesocket_callback);
.fi
.SH DESCRIPTION
Pass a pointer to your callback function, which should match the prototype
shown above.
This callback function gets called by libcurl instead of the \fIclose(3)\fP or
\fIclosesocket(3)\fP call when sockets are closed (not for any other file
descriptors). This is pretty much the reverse to the
\fICURLOPT_OPENSOCKETFUNCTION(3)\fP option. Return 0 to signal success and 1
if there was an error.
The \fIclientp\fP pointer is set with
\fICURLOPT_CLOSESOCKETDATA(3)\fP. \fIitem\fP is the socket libcurl wants to be
closed.
.SH DEFAULT
By default libcurl uses the standard socket close function.
.SH PROTOCOLS
All
.SH EXAMPLE
.nf
static int closesocket(void *clientp, curl_socket_t item)
{
printf("libcurl wants to close %d now\\n", (int)item);
return 0;
}
/* call this function to close sockets */
curl_easy_setopt(curl, CURLOPT_CLOSESOCKETFUNCTION, closesocket);
curl_easy_setopt(curl, CURLOPT_CLOSESOCKETDATA, &sockfd);
.fi
.SH AVAILABILITY
Added in 7.21.7
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR CURLOPT_CLOSESOCKETDATA (3),
.BR CURLOPT_OPENSOCKETFUNCTION (3)
man/man3/libcurl-tutorial.3 0000644 00000170641 14751172371 0011557 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH libcurl-tutorial 3 "September 27, 2023" "libcurl 8.4.0" "libcurl"
.SH NAME
libcurl-tutorial \- libcurl programming tutorial
.SH "Objective"
This document attempts to describe the general principles and some basic
approaches to consider when programming with libcurl. The text focuses on the
C interface but should apply fairly well on other language bindings as well as
they usually follow the C API pretty closely.
This document refers to 'the user' as the person writing the source code that
uses libcurl. That would probably be you or someone in your position. What is
generally referred to as 'the program' is the collected source code that you
write that is using libcurl for transfers. The program is outside libcurl and
libcurl is outside of the program.
To get more details on all options and functions described herein, please
refer to their respective man pages.
.SH "Building"
There are many different ways to build C programs. This chapter assumes a Unix
style build process. If you use a different build system, you can still read
this to get general information that may apply to your environment as well.
.IP "Compiling the Program"
Your compiler needs to know where the libcurl headers are located. Therefore
you must set your compiler's include path to point to the directory where you
installed them. The 'curl-config'[3] tool can be used to get this information:
.nf
$ curl-config --cflags
.fi
.IP "Linking the Program with libcurl"
When having compiled the program, you need to link your object files to create
a single executable. For that to succeed, you need to link with libcurl and
possibly also with other libraries that libcurl itself depends on. Like the
OpenSSL libraries, but even some standard OS libraries may be needed on the
command line. To figure out which flags to use, once again the 'curl-config'
tool comes to the rescue:
.nf
$ curl-config --libs
.fi
.IP "SSL or Not"
libcurl can be built and customized in many ways. One of the things that
varies from different libraries and builds is the support for SSL-based
transfers, like HTTPS and FTPS. If a supported SSL library was detected
properly at build-time, libcurl is built with SSL support. To figure out if an
installed libcurl has been built with SSL support enabled, use \&'curl-config'
like this:
.nf
$ curl-config --feature
.fi
And if SSL is supported, the keyword \fISSL\fP is written to stdout, possibly
together with a other features that could be either on or off on for different
libcurls.
See also the "Features libcurl Provides" further down.
.IP "autoconf macro"
When you write your configure script to detect libcurl and setup variables
accordingly, we offer a macro that probably does everything you need in this
area. See docs/libcurl/libcurl.m4 file - it includes docs on how to use it.
.SH "Portable Code in a Portable World"
The people behind libcurl have put a considerable effort to make libcurl work
on a large amount of different operating systems and environments.
You program libcurl the same way on all platforms that libcurl runs on. There
are only a few minor details that differ. If you just make sure to write your
code portable enough, you can create a portable program. libcurl should not
stop you from that.
.SH "Global Preparation"
The program must initialize some of the libcurl functionality globally. That
means it should be done exactly once, no matter how many times you intend to
use the library. Once for your program's entire life time. This is done using
.nf
curl_global_init()
.fi
and it takes one parameter which is a bit pattern that tells libcurl what to
initialize. Using \fICURL_GLOBAL_ALL\fP makes it initialize all known internal
sub modules, and might be a good default option. The current two bits that are
specified are:
.RS
.IP "CURL_GLOBAL_WIN32"
which only does anything on Windows machines. When used on a Windows machine,
it makes libcurl initialize the win32 socket stuff. Without having that
initialized properly, your program cannot use sockets properly. You should
only do this once for each application, so if your program already does this
or of another library in use does it, you should not tell libcurl to do this
as well.
.IP CURL_GLOBAL_SSL
which only does anything on libcurls compiled and built SSL-enabled. On these
systems, this makes libcurl initialize the SSL library properly for this
application. This only needs to be done once for each application so if your
program or another library already does this, this bit should not be needed.
.RE
libcurl has a default protection mechanism that detects if
\fIcurl_global_init(3)\fP has not been called by the time
\fIcurl_easy_perform(3)\fP is called and if that is the case, libcurl runs the
function itself with a guessed bit pattern. Please note that depending solely
on this is not considered nice nor good.
When the program no longer uses libcurl, it should call
\fIcurl_global_cleanup(3)\fP, which is the opposite of the init call. It
performs the reversed operations to cleanup the resources the
\fIcurl_global_init(3)\fP call initialized.
Repeated calls to \fIcurl_global_init(3)\fP and \fIcurl_global_cleanup(3)\fP
should be avoided. They should only be called once each.
.SH "Features libcurl Provides"
It is considered best-practice to determine libcurl features at runtime rather
than at build-time (if possible of course). By calling
\fIcurl_version_info(3)\fP and checking out the details of the returned
struct, your program can figure out exactly what the currently running libcurl
supports.
.SH "Two Interfaces"
libcurl first introduced the so called easy interface. All operations in the
easy interface are prefixed with 'curl_easy'. The easy interface lets you do
single transfers with a synchronous and blocking function call.
libcurl also offers another interface that allows multiple simultaneous
transfers in a single thread, the so called multi interface. More about that
interface is detailed in a separate chapter further down. You still need to
understand the easy interface first, so please continue reading for better
understanding.
.SH "Handle the Easy libcurl"
To use the easy interface, you must first create yourself an easy handle. You
need one handle for each easy session you want to perform. Basically, you
should use one handle for every thread you plan to use for transferring. You
must never share the same handle in multiple threads.
Get an easy handle with
.nf
handle = curl_easy_init();
.fi
It returns an easy handle. Using that you proceed to the next step: setting
up your preferred actions. A handle is just a logic entity for the upcoming
transfer or series of transfers.
You set properties and options for this handle using
\fIcurl_easy_setopt(3)\fP. They control how the subsequent transfer or
transfers using this handle are made. Options remain set in the handle until
set again to something different. They are sticky. Multiple requests using the
same handle use the same options.
If you at any point would like to blank all previously set options for a
single easy handle, you can call \fIcurl_easy_reset(3)\fP and you can also
make a clone of an easy handle (with all its set options) using
\fIcurl_easy_duphandle(3)\fP.
Many of the options you set in libcurl are "strings", pointers to data
terminated with a zero byte. When you set strings with
\fIcurl_easy_setopt(3)\fP, libcurl makes its own copy so that they do not need
to be kept around in your application after being set[4].
One of the most basic properties to set in the handle is the URL. You set your
preferred URL to transfer with \fICURLOPT_URL(3)\fP in a manner similar to:
.nf
curl_easy_setopt(handle, CURLOPT_URL, "http://domain.com/");
.fi
Let's assume for a while that you want to receive data as the URL identifies a
remote resource you want to get here. Since you write a sort of application
that needs this transfer, I assume that you would like to get the data passed
to you directly instead of simply getting it passed to stdout. So, you write
your own function that matches this prototype:
.nf
size_t write_data(void *buffer, size_t size, size_t nmemb, void *userp);
.fi
You tell libcurl to pass all data to this function by issuing a function
similar to this:
.nf
curl_easy_setopt(handle, CURLOPT_WRITEFUNCTION, write_data);
.fi
You can control what data your callback function gets in the fourth argument
by setting another property:
.nf
curl_easy_setopt(handle, CURLOPT_WRITEDATA, &internal_struct);
.fi
Using that property, you can easily pass local data between your application
and the function that gets invoked by libcurl. libcurl itself does not touch
the data you pass with \fICURLOPT_WRITEDATA(3)\fP.
libcurl offers its own default internal callback that takes care of the data
if you do not set the callback with \fICURLOPT_WRITEFUNCTION(3)\fP. It simply
outputs the received data to stdout. You can have the default callback write
the data to a different file handle by passing a 'FILE *' to a file opened for
writing with the \fICURLOPT_WRITEDATA(3)\fP option.
Now, we need to take a step back and take a deep breath. Here is one of those
rare platform-dependent nitpicks. Did you spot it? On some platforms[2],
libcurl is not able to operate on file handles opened by the
program. Therefore, if you use the default callback and pass in an open file
handle with \fICURLOPT_WRITEDATA(3)\fP, libcurl crashes. You should avoid this
to make your program run fine virtually everywhere.
(\fICURLOPT_WRITEDATA(3)\fP was formerly known as \fICURLOPT_FILE\fP. Both
names still work and do the same thing).
If you are using libcurl as a win32 DLL, you MUST use the
\fICURLOPT_WRITEFUNCTION(3)\fP if you set \fICURLOPT_WRITEDATA(3)\fP - or
experience crashes.
There are of course many more options you can set, and we get back to a few of
them later. Let's instead continue to the actual transfer:
.nf
success = curl_easy_perform(handle);
.fi
\fIcurl_easy_perform(3)\fP connects to the remote site, does the necessary
commands and performs the transfer. Whenever it receives data, it calls the
callback function we previously set. The function may get one byte at a time,
or it may get many kilobytes at once. libcurl delivers as much as possible as
often as possible. Your callback function should return the number of bytes it
\&"took care of". If that is not the same amount of bytes that was passed to
it, libcurl aborts the operation and returns with an error code.
When the transfer is complete, the function returns a return code that informs
you if it succeeded in its mission or not. If a return code is not enough for
you, you can use the \fICURLOPT_ERRORBUFFER(3)\fP to point libcurl to a buffer
of yours where it stores a human readable error message as well.
If you then want to transfer another file, the handle is ready to be used
again. It is even preferred and encouraged that you reuse an existing handle
if you intend to make another transfer. libcurl then attempts to reuse a
previous connection.
For some protocols, downloading a file can involve a complicated process of
logging in, setting the transfer mode, changing the current directory and
finally transferring the file data. libcurl takes care of all that
complication for you. Given simply the URL to a file, libcurl takes care of
all the details needed to get the file moved from one machine to another.
.SH "Multi-threading Issues"
libcurl is thread safe but there are a few exceptions. Refer to
\fIlibcurl-thread(3)\fP for more information.
.SH "When It does not Work"
There are times when the transfer fails for some reason. You might have set
the wrong libcurl option or misunderstood what the libcurl option actually
does, or the remote server might return non-standard replies that confuse the
library which then confuses your program.
There is one golden rule when these things occur: set the
\fICURLOPT_VERBOSE(3)\fP option to 1. it causes the library to spew out the
entire protocol details it sends, some internal info and some received
protocol data as well (especially when using FTP). If you are using HTTP,
adding the headers in the received output to study is also a clever way to get
a better understanding why the server behaves the way it does. Include headers
in the normal body output with \fICURLOPT_HEADER(3)\fP set 1.
Of course, there are bugs left. We need to know about them to be able to fix
them, so we are quite dependent on your bug reports. When you do report
suspected bugs in libcurl, please include as many details as you possibly can:
a protocol dump that \fICURLOPT_VERBOSE(3)\fP produces, library version, as
much as possible of your code that uses libcurl, operating system name and
version, compiler name and version etc.
If \fICURLOPT_VERBOSE(3)\fP is not enough, you increase the level of debug
data your application receive by using the \fICURLOPT_DEBUGFUNCTION(3)\fP.
Getting some in-depth knowledge about the protocols involved is never wrong,
and if you are trying to do funny things, you might understand libcurl and how
to use it better if you study the appropriate RFC documents at least briefly.
.SH "Upload Data to a Remote Site"
libcurl tries to keep a protocol independent approach to most transfers, thus
uploading to a remote FTP site is similar to uploading data to an HTTP server
with a PUT request.
Of course, first you either create an easy handle or you reuse one existing
one. Then you set the URL to operate on just like before. This is the remote
URL, that we now upload.
Since we write an application, we most likely want libcurl to get the upload
data by asking us for it. To make it do that, we set the read callback and the
custom pointer libcurl passes to our read callback. The read callback should
have a prototype similar to:
.nf
size_t function(char *bufptr, size_t size, size_t nitems, void *userp);
.fi
Where \fIbufptr\fP is the pointer to a buffer we fill in with data to upload
and \fIsize*nitems\fP is the size of the buffer and therefore also the maximum
amount of data we can return to libcurl in this call. The \fIuserp\fP pointer
is the custom pointer we set to point to a struct of ours to pass private data
between the application and the callback.
.nf
curl_easy_setopt(handle, CURLOPT_READFUNCTION, read_function);
curl_easy_setopt(handle, CURLOPT_READDATA, &filedata);
.fi
Tell libcurl that we want to upload:
.nf
curl_easy_setopt(handle, CURLOPT_UPLOAD, 1L);
.fi
A few protocols do not behave properly when uploads are done without any prior
knowledge of the expected file size. So, set the upload file size using the
\fICURLOPT_INFILESIZE_LARGE(3)\fP for all known file sizes like this[1]:
.nf
/* in this example, file_size must be an curl_off_t variable */
curl_easy_setopt(handle, CURLOPT_INFILESIZE_LARGE, file_size);
.fi
When you call \fIcurl_easy_perform(3)\fP this time, it performs all the
necessary operations and when it has invoked the upload it calls your supplied
callback to get the data to upload. The program should return as much data as
possible in every invoke, as that is likely to make the upload perform as fast
as possible. The callback should return the number of bytes it wrote in the
buffer. Returning 0 signals the end of the upload.
.SH "Passwords"
Many protocols use or even require that user name and password are provided
to be able to download or upload the data of your choice. libcurl offers
several ways to specify them.
Most protocols support that you specify the name and password in the URL
itself. libcurl detects this and use them accordingly. This is written like
this:
.nf
protocol://user:password@example.com/path/
.fi
If you need any odd letters in your user name or password, you should enter
them URL encoded, as %XX where XX is a two-digit hexadecimal number.
libcurl also provides options to set various passwords. The user name and
password as shown embedded in the URL can instead get set with the
\fICURLOPT_USERPWD(3)\fP option. The argument passed to libcurl should be a
char * to a string in the format "user:password". In a manner like this:
.nf
curl_easy_setopt(handle, CURLOPT_USERPWD, "myname:thesecret");
.fi
Another case where name and password might be needed at times, is for those
users who need to authenticate themselves to a proxy they use. libcurl offers
another option for this, the \fICURLOPT_PROXYUSERPWD(3)\fP. It is used quite
similar to the \fICURLOPT_USERPWD(3)\fP option like this:
.nf
curl_easy_setopt(handle, CURLOPT_PROXYUSERPWD, "myname:thesecret");
.fi
There is a long time Unix "standard" way of storing FTP user names and
passwords, namely in the $HOME/.netrc file (on Windows, libcurl also checks
the \fI%USERPROFILE% environment\fP variable if \fI%HOME%\fP is unset, and
tries "_netrc" as name). The file should be made private so that only the user
may read it (see also the "Security Considerations" chapter), as it might
contain the password in plain text. libcurl has the ability to use this file
to figure out what set of user name and password to use for a particular
host. As an extension to the normal functionality, libcurl also supports this
file for non-FTP protocols such as HTTP. To make curl use this file, use the
\fICURLOPT_NETRC(3)\fP option:
.nf
curl_easy_setopt(handle, CURLOPT_NETRC, 1L);
.fi
And a basic example of how such a .netrc file may look like:
.nf
machine myhost.mydomain.com
login userlogin
password secretword
.fi
All these examples have been cases where the password has been optional, or
at least you could leave it out and have libcurl attempt to do its job
without it. There are times when the password is not optional, like when
you are using an SSL private key for secure transfers.
To pass the known private key password to libcurl:
.nf
curl_easy_setopt(handle, CURLOPT_KEYPASSWD, "keypassword");
.fi
.SH "HTTP Authentication"
The previous chapter showed how to set user name and password for getting URLs
that require authentication. When using the HTTP protocol, there are many
different ways a client can provide those credentials to the server and you
can control which way libcurl uses them. The default HTTP authentication
method is called 'Basic', which is sending the name and password in clear-text
in the HTTP request, base64-encoded. This is insecure.
At the time of this writing, libcurl can be built to use: Basic, Digest, NTLM,
Negotiate (SPNEGO). You can tell libcurl which one to use
with \fICURLOPT_HTTPAUTH(3)\fP as in:
.nf
curl_easy_setopt(handle, CURLOPT_HTTPAUTH, CURLAUTH_DIGEST);
.fi
And when you send authentication to a proxy, you can also set authentication
type the same way but instead with \fICURLOPT_PROXYAUTH(3)\fP:
.nf
curl_easy_setopt(handle, CURLOPT_PROXYAUTH, CURLAUTH_NTLM);
.fi
Both these options allow you to set multiple types (by ORing them together),
to make libcurl pick the most secure one out of the types the server/proxy
claims to support. This method does however add a round-trip since libcurl
must first ask the server what it supports:
.nf
curl_easy_setopt(handle, CURLOPT_HTTPAUTH, CURLAUTH_DIGEST|CURLAUTH_BASIC);
.fi
For convenience, you can use the \fICURLAUTH_ANY\fP define (instead of a list
with specific types) which allows libcurl to use whatever method it wants.
When asking for multiple types, libcurl picks the available one it considers
"best" in its own internal order of preference.
.SH "HTTP POSTing"
We get many questions regarding how to issue HTTP POSTs with libcurl the
proper way. This chapter thus includes examples using both different versions
of HTTP POST that libcurl supports.
The first version is the simple POST, the most common version, that most HTML
pages using the <form> tag uses. We provide a pointer to the data and tell
libcurl to post it all to the remote site:
.nf
char *data="name=daniel&project=curl";
curl_easy_setopt(handle, CURLOPT_POSTFIELDS, data);
curl_easy_setopt(handle, CURLOPT_URL, "http://posthere.com/");
curl_easy_perform(handle); /* post away! */
.fi
Simple enough, huh? Since you set the POST options with the
\fICURLOPT_POSTFIELDS(3)\fP, this automatically switches the handle to use
POST in the upcoming request.
What if you want to post binary data that also requires you to set the
Content-Type: header of the post? Well, binary posts prevent libcurl from being
able to do strlen() on the data to figure out the size, so therefore we must
tell libcurl the size of the post data. Setting headers in libcurl requests are
done in a generic way, by building a list of our own headers and then passing
that list to libcurl.
.nf
struct curl_slist *headers=NULL;
headers = curl_slist_append(headers, "Content-Type: text/xml");
/* post binary data */
curl_easy_setopt(handle, CURLOPT_POSTFIELDS, binaryptr);
/* set the size of the postfields data */
curl_easy_setopt(handle, CURLOPT_POSTFIELDSIZE, 23L);
/* pass our list of custom made headers */
curl_easy_setopt(handle, CURLOPT_HTTPHEADER, headers);
curl_easy_perform(handle); /* post away! */
curl_slist_free_all(headers); /* free the header list */
.fi
While the simple examples above cover the majority of all cases where HTTP
POST operations are required, they do not do multi-part formposts. Multi-part
formposts were introduced as a better way to post (possibly large) binary data
and were first documented in the RFC 1867 (updated in RFC 2388). they are
called multi-part because they are built by a chain of parts, each part being
a single unit of data. Each part has its own name and contents. You can in
fact create and post a multi-part formpost with the regular libcurl POST
support described above, but that would require that you build a formpost
yourself and provide to libcurl. To make that easier, libcurl provides a MIME
API consisting in several functions: using those, you can create and fill a
multi-part form. Function \fIcurl_mime_init(3)\fP creates a multi-part body;
you can then append new parts to a multi-part body using
\fIcurl_mime_addpart(3)\fP. There are three possible data sources for a part:
memory using \fIcurl_mime_data(3)\fP, file using \fIcurl_mime_filedata(3)\fP
and user-defined data read callback using \fIcurl_mime_data_cb(3)\fP.
\fIcurl_mime_name(3)\fP sets a part's (i.e.: form field) name, while
\fIcurl_mime_filename(3)\fP fills in the remote file name. With
\fIcurl_mime_type(3)\fP, you can tell the MIME type of a part,
\fIcurl_mime_headers(3)\fP allows defining the part's headers. When a
multi-part body is no longer needed, you can destroy it using
\fIcurl_mime_free(3)\fP.
The following example sets two simple text parts with plain textual contents,
and then a file with binary contents and uploads the whole thing.
.nf
curl_mime *multipart = curl_mime_init(handle);
curl_mimepart *part = curl_mime_addpart(multipart);
curl_mime_name(part, "name");
curl_mime_data(part, "daniel", CURL_ZERO_TERMINATED);
part = curl_mime_addpart(multipart);
curl_mime_name(part, "project");
curl_mime_data(part, "curl", CURL_ZERO_TERMINATED);
part = curl_mime_addpart(multipart);
curl_mime_name(part, "logotype-image");
curl_mime_filedata(part, "curl.png");
/* Set the form info */
curl_easy_setopt(handle, CURLOPT_MIMEPOST, multipart);
curl_easy_perform(handle); /* post away! */
/* free the post data again */
curl_mime_free(multipart);
.fi
To post multiple files for a single form field, you must supply each file in
a separate part, all with the same field name. Although function
\fIcurl_mime_subparts(3)\fP implements nested multi-parts, this way of
multiple files posting is deprecated by RFC 7578, chapter 4.3.
To set the data source from an already opened FILE pointer, use:
.nf
curl_mime_data_cb(part, filesize, (curl_read_callback) fread,
(curl_seek_callback) fseek, NULL, filepointer);
.fi
A deprecated \fIcurl_formadd(3)\fP function is still supported in libcurl.
It should however not be used anymore for new designs and programs using it
ought to be converted to the MIME API. It is however described here as an
aid to conversion.
Using \fIcurl_formadd\fP, you add parts to the form. When you are done adding
parts, you post the whole form.
The MIME API example above is expressed as follows using this function:
.nf
struct curl_httppost *post=NULL;
struct curl_httppost *last=NULL;
curl_formadd(&post, &last,
CURLFORM_COPYNAME, "name",
CURLFORM_COPYCONTENTS, "daniel", CURLFORM_END);
curl_formadd(&post, &last,
CURLFORM_COPYNAME, "project",
CURLFORM_COPYCONTENTS, "curl", CURLFORM_END);
curl_formadd(&post, &last,
CURLFORM_COPYNAME, "logotype-image",
CURLFORM_FILECONTENT, "curl.png", CURLFORM_END);
/* Set the form info */
curl_easy_setopt(handle, CURLOPT_HTTPPOST, post);
curl_easy_perform(handle); /* post away! */
/* free the post data again */
curl_formfree(post);
.fi
Multipart formposts are chains of parts using MIME-style separators and
headers. It means that each one of these separate parts get a few headers set
that describe the individual content-type, size etc. To enable your
application to handicraft this formpost even more, libcurl allows you to
supply your own set of custom headers to such an individual form part. You can
of course supply headers to as many parts as you like, but this little example
shows how you set headers to one specific part when you add that to the post
handle:
.nf
struct curl_slist *headers=NULL;
headers = curl_slist_append(headers, "Content-Type: text/xml");
curl_formadd(&post, &last,
CURLFORM_COPYNAME, "logotype-image",
CURLFORM_FILECONTENT, "curl.xml",
CURLFORM_CONTENTHEADER, headers,
CURLFORM_END);
curl_easy_perform(handle); /* post away! */
curl_formfree(post); /* free post */
curl_slist_free_all(headers); /* free custom header list */
.fi
Since all options on an easy handle are "sticky", they remain the same until
changed even if you do call \fIcurl_easy_perform(3)\fP, you may need to tell
curl to go back to a plain GET request if you intend to do one as your next
request. You force an easy handle to go back to GET by using the
\fICURLOPT_HTTPGET(3)\fP option:
.nf
curl_easy_setopt(handle, CURLOPT_HTTPGET, 1L);
.fi
Just setting \fICURLOPT_POSTFIELDS(3)\fP to "" or NULL does *not* stop libcurl
from doing a POST. It just makes it POST without any data to send!
.SH "Converting from deprecated form API to MIME API"
Four rules have to be respected in building the multi-part:
.br
- The easy handle must be created before building the multi-part.
.br
- The multi-part is always created by a call to curl_mime_init(handle).
.br
- Each part is created by a call to curl_mime_addpart(multipart).
.br
- When complete, the multi-part must be bound to the easy handle using
\fICURLOPT_MIMEPOST(3)\fP instead of \fICURLOPT_HTTPPOST(3)\fP.
Here are some example of \fIcurl_formadd\fP calls to MIME API sequences:
.nf
curl_formadd(&post, &last,
CURLFORM_COPYNAME, "id",
CURLFORM_COPYCONTENTS, "daniel", CURLFORM_END);
CURLFORM_CONTENTHEADER, headers,
CURLFORM_END);
.fi
becomes:
.nf
part = curl_mime_addpart(multipart);
curl_mime_name(part, "id");
curl_mime_data(part, "daniel", CURL_ZERO_TERMINATED);
curl_mime_headers(part, headers, FALSE);
.fi
Setting the last \fIcurl_mime_headers(3)\fP argument to TRUE would have caused
the headers to be automatically released upon destroyed the multi-part, thus
saving a clean-up call to \fIcurl_slist_free_all(3)\fP.
.nf
curl_formadd(&post, &last,
CURLFORM_PTRNAME, "logotype-image",
CURLFORM_FILECONTENT, "-",
CURLFORM_END);
.fi
becomes:
.nf
part = curl_mime_addpart(multipart);
curl_mime_name(part, "logotype-image");
curl_mime_data_cb(part, (curl_off_t) -1, fread, fseek, NULL, stdin);
.fi
\fIcurl_mime_name(3)\fP always copies the field name. The special file name
"-" is not supported by \fIcurl_mime_filename(3)\fP: to read an open file, use
a callback source using fread(). The transfer is be chunk-encoded since the
data size is unknown.
.nf
curl_formadd(&post, &last,
CURLFORM_COPYNAME, "datafile[]",
CURLFORM_FILE, "file1",
CURLFORM_FILE, "file2",
CURLFORM_END);
.fi
becomes:
.nf
part = curl_mime_addpart(multipart);
curl_mime_name(part, "datafile[]");
curl_mime_filedata(part, "file1");
part = curl_mime_addpart(multipart);
curl_mime_name(part, "datafile[]");
curl_mime_filedata(part, "file2");
.fi
The deprecated multipart/mixed implementation of multiple files field is
translated to two distinct parts with the same name.
.nf
curl_easy_setopt(handle, CURLOPT_READFUNCTION, myreadfunc);
curl_formadd(&post, &last,
CURLFORM_COPYNAME, "stream",
CURLFORM_STREAM, arg,
CURLFORM_CONTENTLEN, (curl_off_t) datasize,
CURLFORM_FILENAME, "archive.zip",
CURLFORM_CONTENTTYPE, "application/zip",
CURLFORM_END);
.fi
becomes:
.nf
part = curl_mime_addpart(multipart);
curl_mime_name(part, "stream");
curl_mime_data_cb(part, (curl_off_t) datasize,
myreadfunc, NULL, NULL, arg);
curl_mime_filename(part, "archive.zip");
curl_mime_type(part, "application/zip");
.fi
\fICURLOPT_READFUNCTION(3)\fP callback is not used: it is replace by directly
setting the part source data from the callback read function.
.nf
curl_formadd(&post, &last,
CURLFORM_COPYNAME, "memfile",
CURLFORM_BUFFER, "memfile.bin",
CURLFORM_BUFFERPTR, databuffer,
CURLFORM_BUFFERLENGTH, (long) sizeof databuffer,
CURLFORM_END);
.fi
becomes:
.nf
part = curl_mime_addpart(multipart);
curl_mime_name(part, "memfile");
curl_mime_data(part, databuffer, (curl_off_t) sizeof databuffer);
curl_mime_filename(part, "memfile.bin");
.fi
\fIcurl_mime_data(3)\fP always copies the initial data: data buffer is thus
free for immediate reuse.
.nf
curl_formadd(&post, &last,
CURLFORM_COPYNAME, "message",
CURLFORM_FILECONTENT, "msg.txt",
CURLFORM_END);
.fi
becomes:
.nf
part = curl_mime_addpart(multipart);
curl_mime_name(part, "message");
curl_mime_filedata(part, "msg.txt");
curl_mime_filename(part, NULL);
.fi
Use of \fIcurl_mime_filedata(3)\fP sets the remote file name as a side effect:
it is therefore necessary to clear it for \fICURLFORM_FILECONTENT\fP
emulation.
.SH "Showing Progress"
For historical and traditional reasons, libcurl has a built-in progress meter
that can be switched on and then makes it present a progress meter in your
terminal.
Switch on the progress meter by, oddly enough, setting
\fICURLOPT_NOPROGRESS(3)\fP to zero. This option is set to 1 by default.
For most applications however, the built-in progress meter is useless and what
instead is interesting is the ability to specify a progress callback. The
function pointer you pass to libcurl is then called on irregular intervals
with information about the current transfer.
Set the progress callback by using \fICURLOPT_PROGRESSFUNCTION(3)\fP. And pass
a pointer to a function that matches this prototype:
.nf
int progress_callback(void *clientp,
double dltotal,
double dlnow,
double ultotal,
double ulnow);
.fi
If any of the input arguments is unknown, a 0 is provided. The first argument,
the 'clientp' is the pointer you pass to libcurl with
\fICURLOPT_PROGRESSDATA(3)\fP. libcurl does not touch it.
.SH "libcurl with C++"
There is basically only one thing to keep in mind when using C++ instead of C
when interfacing libcurl:
The callbacks CANNOT be non-static class member functions
Example C++ code:
.nf
class AClass {
static size_t write_data(void *ptr, size_t size, size_t nmemb,
void *ourpointer)
{
/* do what you want with the data */
}
}
.fi
.SH "Proxies"
What "proxy" means according to Merriam-Webster: "a person authorized to act
for another" but also "the agency, function, or office of a deputy who acts as
a substitute for another".
Proxies are exceedingly common these days. Companies often only offer Internet
access to employees through their proxies. Network clients or user-agents ask
the proxy for documents, the proxy does the actual request and then it returns
them.
libcurl supports SOCKS and HTTP proxies. When a given URL is wanted, libcurl
asks the proxy for it instead of trying to connect to the actual remote host
identified in the URL.
If you are using a SOCKS proxy, you may find that libcurl does not quite support
all operations through it.
For HTTP proxies: the fact that the proxy is an HTTP proxy puts certain
restrictions on what can actually happen. A requested URL that might not be a
HTTP URL is passed to the HTTP proxy to deliver back to libcurl. This happens
transparently, and an application may not need to know. I say "may", because
at times it is important to understand that all operations over an HTTP proxy
use the HTTP protocol. For example, you cannot invoke your own custom FTP
commands or even proper FTP directory listings.
.IP "Proxy Options"
To tell libcurl to use a proxy at a given port number:
.nf
curl_easy_setopt(handle, CURLOPT_PROXY, "proxy-host.com:8080");
.fi
Some proxies require user authentication before allowing a request, and you
pass that information similar to this:
.nf
curl_easy_setopt(handle, CURLOPT_PROXYUSERPWD, "user:password");
.fi
If you want to, you can specify the host name only in the
\fICURLOPT_PROXY(3)\fP option, and set the port number separately with
\fICURLOPT_PROXYPORT(3)\fP.
Tell libcurl what kind of proxy it is with \fICURLOPT_PROXYTYPE(3)\fP (if not,
it defaults to assuming an HTTP proxy):
.nf
curl_easy_setopt(handle, CURLOPT_PROXYTYPE, CURLPROXY_SOCKS4);
.fi
.IP "Environment Variables"
libcurl automatically checks and uses a set of environment variables to know
what proxies to use for certain protocols. The names of the variables are
following an old tradition and are built up as "[protocol]_proxy" (note the
lower casing). Which makes the variable \&'http_proxy' checked for a name of a
proxy to use when the input URL is HTTP. Following the same rule, the variable
named 'ftp_proxy' is checked for FTP URLs. Again, the proxies are always HTTP
proxies, the different names of the variables simply allows different HTTP
proxies to be used.
The proxy environment variable contents should be in the format
\&"[protocol://][user:password@]machine[:port]". Where the protocol:// part
specifies which type of proxy it is, and the optional port number specifies on
which port the proxy operates. If not specified, the internal default port
number is used and that is most likely not the one you would like it to be.
There are two special environment variables. 'all_proxy' is what sets proxy
for any URL in case the protocol specific variable was not set, and
\&'no_proxy' defines a list of hosts that should not use a proxy even though a
variable may say so. If 'no_proxy' is a plain asterisk ("*") it matches all
hosts.
To explicitly disable libcurl's checking for and using the proxy environment
variables, set the proxy name to "" - an empty string - with
\fICURLOPT_PROXY(3)\fP.
.IP "SSL and Proxies"
SSL is for secure point-to-point connections. This involves strong encryption
and similar things, which effectively makes it impossible for a proxy to
operate as a "man in between" which the proxy's task is, as previously
discussed. Instead, the only way to have SSL work over an HTTP proxy is to ask
the proxy to tunnel everything through without being able to check or fiddle
with the traffic.
Opening an SSL connection over an HTTP proxy is therefore a matter of asking the
proxy for a straight connection to the target host on a specified port. This
is made with the HTTP request CONNECT. ("please dear proxy, connect me to that
remote host").
Because of the nature of this operation, where the proxy has no idea what kind
of data that is passed in and out through this tunnel, this breaks some of the
few advantages that come from using a proxy, such as caching. Many
organizations prevent this kind of tunneling to other destination port numbers
than 443 (which is the default HTTPS port number).
.IP "Tunneling Through Proxy"
As explained above, tunneling is required for SSL to work and often even
restricted to the operation intended for SSL; HTTPS.
This is however not the only time proxy-tunneling might offer benefits to
you or your application.
As tunneling opens a direct connection from your application to the remote
machine, it suddenly also re-introduces the ability to do non-HTTP
operations over an HTTP proxy. You can in fact use things such as FTP
upload or FTP custom commands this way.
Again, this is often prevented by the administrators of proxies and is
rarely allowed.
Tell libcurl to use proxy tunneling like this:
.nf
curl_easy_setopt(handle, CURLOPT_HTTPPROXYTUNNEL, 1L);
.fi
In fact, there might even be times when you want to do plain HTTP operations
using a tunnel like this, as it then enables you to operate on the remote
server instead of asking the proxy to do so. libcurl does not stand in the way
for such innovative actions either!
.IP "Proxy Auto-Config"
Netscape first came up with this. It is basically a web page (usually using a
\&.pac extension) with a JavaScript that when executed by the browser with the
requested URL as input, returns information to the browser on how to connect
to the URL. The returned information might be "DIRECT" (which means no proxy
should be used), "PROXY host:port" (to tell the browser where the proxy for
this particular URL is) or "SOCKS host:port" (to direct the browser to a SOCKS
proxy).
libcurl has no means to interpret or evaluate JavaScript and thus it does not
support this. If you get yourself in a position where you face this nasty
invention, the following advice have been mentioned and used in the past:
- Depending on the JavaScript complexity, write up a script that translates it
to another language and execute that.
- Read the JavaScript code and rewrite the same logic in another language.
- Implement a JavaScript interpreter; people have successfully used the
Mozilla JavaScript engine in the past.
- Ask your admins to stop this, for a static proxy setup or similar.
.SH "Persistence Is The Way to Happiness"
Re-cycling the same easy handle several times when doing multiple requests is
the way to go.
After each single \fIcurl_easy_perform(3)\fP operation, libcurl keeps the
connection alive and open. A subsequent request using the same easy handle to
the same host might just be able to use the already open connection! This
reduces network impact a lot.
Even if the connection is dropped, all connections involving SSL to the same
host again, benefit from libcurl's session ID cache that drastically reduces
re-connection time.
FTP connections that are kept alive save a lot of time, as the command-
response round-trips are skipped, and also you do not risk getting blocked
without permission to login again like on many FTP servers only allowing N
persons to be logged in at the same time.
libcurl caches DNS name resolving results, to make lookups of a previously
looked up name a lot faster.
Other interesting details that improve performance for subsequent requests
may also be added in the future.
Each easy handle attempts to keep the last few connections alive for a while
in case they are to be used again. You can set the size of this "cache" with
the \fICURLOPT_MAXCONNECTS(3)\fP option. Default is 5. There is rarely any
point in changing this value, and if you think of changing this it is often
just a matter of thinking again.
To force your upcoming request to not use an already existing connection, you
can do that by setting \fICURLOPT_FRESH_CONNECT(3)\fP to 1. In a similar
spirit, you can also forbid the upcoming request to be "lying" around and
possibly get reused after the request by setting
\fICURLOPT_FORBID_REUSE(3)\fP to 1.
.SH "HTTP Headers Used by libcurl"
When you use libcurl to do HTTP requests, it passes along a series of headers
automatically. It might be good for you to know and understand these. You can
replace or remove them by using the \fICURLOPT_HTTPHEADER(3)\fP option.
.IP "Host"
This header is required by HTTP 1.1 and even many 1.0 servers and should be
the name of the server we want to talk to. This includes the port number if
anything but default.
.IP "Accept"
\&"*/*".
.IP "Expect"
When doing POST requests, libcurl sets this header to \&"100-continue" to ask
the server for an "OK" message before it proceeds with sending the data part
of the post. If the posted data amount is deemed "small", libcurl does not use
this header.
.SH "Customizing Operations"
There is an ongoing development today where more and more protocols are built
upon HTTP for transport. This has obvious benefits as HTTP is a tested and
reliable protocol that is widely deployed and has excellent proxy-support.
When you use one of these protocols, and even when doing other kinds of
programming you may need to change the traditional HTTP (or FTP or...)
manners. You may need to change words, headers or various data.
libcurl is your friend here too.
.IP CUSTOMREQUEST
If just changing the actual HTTP request keyword is what you want, like when
GET, HEAD or POST is not good enough for you, \fICURLOPT_CUSTOMREQUEST(3)\fP
is there for you. It is simple to use:
.nf
curl_easy_setopt(handle, CURLOPT_CUSTOMREQUEST, "MYOWNREQUEST");
.fi
When using the custom request, you change the request keyword of the actual
request you are performing. Thus, by default you make a GET request but you can
also make a POST operation (as described before) and then replace the POST
keyword if you want to. you are the boss.
.IP "Modify Headers"
HTTP-like protocols pass a series of headers to the server when doing the
request, and you are free to pass any amount of extra headers that you
think fit. Adding headers is this easy:
.nf
struct curl_slist *headers=NULL; /* init to NULL is important */
headers = curl_slist_append(headers, "Hey-server-hey: how are you?");
headers = curl_slist_append(headers, "X-silly-content: yes");
/* pass our list of custom made headers */
curl_easy_setopt(handle, CURLOPT_HTTPHEADER, headers);
curl_easy_perform(handle); /* transfer http */
curl_slist_free_all(headers); /* free the header list */
.fi
\&... and if you think some of the internally generated headers, such as
Accept: or Host: do not contain the data you want them to contain, you can
replace them by simply setting them too:
.nf
headers = curl_slist_append(headers, "Accept: Agent-007");
headers = curl_slist_append(headers, "Host: munged.host.line");
.fi
.IP "Delete Headers"
If you replace an existing header with one with no contents, you prevent the
header from being sent. For instance, if you want to completely prevent the
\&"Accept:" header from being sent, you can disable it with code similar to
this:
headers = curl_slist_append(headers, "Accept:");
Both replacing and canceling internal headers should be done with careful
consideration and you should be aware that you may violate the HTTP protocol
when doing so.
.IP "Enforcing chunked transfer-encoding"
By making sure a request uses the custom header "Transfer-Encoding: chunked"
when doing a non-GET HTTP operation, libcurl switches over to "chunked"
upload, even though the size of the data to upload might be known. By default,
libcurl usually switches over to chunked upload automatically if the upload
data size is unknown.
.IP "HTTP Version"
All HTTP requests includes the version number to tell the server which version
we support. libcurl speaks HTTP 1.1 by default. Some old servers do not like
getting 1.1-requests and when dealing with stubborn old things like that, you
can tell libcurl to use 1.0 instead by doing something like this:
curl_easy_setopt(handle, CURLOPT_HTTP_VERSION, CURL_HTTP_VERSION_1_0);
.IP "FTP Custom Commands"
Not all protocols are HTTP-like, and thus the above may not help you when
you want to make, for example, your FTP transfers to behave differently.
Sending custom commands to an FTP server means that you need to send the
commands exactly as the FTP server expects them (RFC 959 is a good guide
here), and you can only use commands that work on the control-connection
alone. All kinds of commands that require data interchange and thus need a
data-connection must be left to libcurl's own judgment. Also be aware that
libcurl does its best to change directory to the target directory before doing
any transfer, so if you change directory (with CWD or similar) you might
confuse libcurl and then it might not attempt to transfer the file in the
correct remote directory.
A little example that deletes a given file before an operation:
.nf
headers = curl_slist_append(headers, "DELE file-to-remove");
/* pass the list of custom commands to the handle */
curl_easy_setopt(handle, CURLOPT_QUOTE, headers);
curl_easy_perform(handle); /* transfer ftp data! */
curl_slist_free_all(headers); /* free the header list */
.fi
If you would instead want this operation (or chain of operations) to happen
_after_ the data transfer took place the option to \fIcurl_easy_setopt(3)\fP
would instead be called \fICURLOPT_POSTQUOTE(3)\fP and used the exact same
way.
The custom FTP commands are issued to the server in the same order they are
added to the list, and if a command gets an error code returned back from the
server, no more commands are issued and libcurl bails out with an error code
(CURLE_QUOTE_ERROR). Note that if you use \fICURLOPT_QUOTE(3)\fP to send
commands before a transfer, no transfer actually takes place when a quote
command has failed.
If you set the \fICURLOPT_HEADER(3)\fP to 1, you tell libcurl to get
information about the target file and output "headers" about it. The headers
are in "HTTP-style", looking like they do in HTTP.
The option to enable headers or to run custom FTP commands may be useful to
combine with \fICURLOPT_NOBODY(3)\fP. If this option is set, no actual file
content transfer is performed.
.IP "FTP Custom CUSTOMREQUEST"
If you do want to list the contents of an FTP directory using your own defined
FTP command, \fICURLOPT_CUSTOMREQUEST(3)\fP does just that. "NLST" is the
default one for listing directories but you are free to pass in your idea of a
good alternative.
.SH "Cookies Without Chocolate Chips"
In the HTTP sense, a cookie is a name with an associated value. A server sends
the name and value to the client, and expects it to get sent back on every
subsequent request to the server that matches the particular conditions
set. The conditions include that the domain name and path match and that the
cookie has not become too old.
In real-world cases, servers send new cookies to replace existing ones to
update them. Server use cookies to "track" users and to keep "sessions".
Cookies are sent from server to clients with the header Set-Cookie: and
they are sent from clients to servers with the Cookie: header.
To just send whatever cookie you want to a server, you can use
\fICURLOPT_COOKIE(3)\fP to set a cookie string like this:
.nf
curl_easy_setopt(handle, CURLOPT_COOKIE, "name1=var1; name2=var2;");
.fi
In many cases, that is not enough. You might want to dynamically save
whatever cookies the remote server passes to you, and make sure those cookies
are then used accordingly on later requests.
One way to do this, is to save all headers you receive in a plain file and
when you make a request, you tell libcurl to read the previous headers to
figure out which cookies to use. Set the header file to read cookies from with
\fICURLOPT_COOKIEFILE(3)\fP.
The \fICURLOPT_COOKIEFILE(3)\fP option also automatically enables the cookie
parser in libcurl. Until the cookie parser is enabled, libcurl does not parse
or understand incoming cookies and they are just be ignored. However, when the
parser is enabled the cookies are understood and the cookies are kept in
memory and used properly in subsequent requests when the same handle is
used. Many times this is enough, and you may not have to save the cookies to
disk at all. Note that the file you specify to \fICURLOPT_COOKIEFILE(3)\fP
does not have to exist to enable the parser, so a common way to just enable
the parser and not read any cookies is to use the name of a file you know does
not exist.
If you would rather use existing cookies that you have previously received
with your Netscape or Mozilla browsers, you can make libcurl use that cookie
file as input. The \fICURLOPT_COOKIEFILE(3)\fP is used for that too, as
libcurl automatically finds out what kind of file it is and acts accordingly.
Perhaps the most advanced cookie operation libcurl offers, is saving the
entire internal cookie state back into a Netscape/Mozilla formatted cookie
file. We call that the cookie-jar. When you set a file name with
\fICURLOPT_COOKIEJAR(3)\fP, that file name is created and all received cookies
get stored in it when \fIcurl_easy_cleanup(3)\fP is called. This enables
cookies to get passed on properly between multiple handles without any
information getting lost.
.SH "FTP Peculiarities We Need"
FTP transfers use a second TCP/IP connection for the data transfer. This is
usually a fact you can forget and ignore but at times this detail comes back
to haunt you. libcurl offers several different ways to customize how the
second connection is being made.
libcurl can either connect to the server a second time or tell the server to
connect back to it. The first option is the default and it is also what works
best for all the people behind firewalls, NATs or IP-masquerading setups.
libcurl then tells the server to open up a new port and wait for a second
connection. This is by default attempted with EPSV first, and if that does not
work it tries PASV instead. (EPSV is an extension to the original FTP spec
and does not exist nor work on all FTP servers.)
You can prevent libcurl from first trying the EPSV command by setting
\fICURLOPT_FTP_USE_EPSV(3)\fP to zero.
In some cases, you want to have the server connect back to you for the second
connection. This might be when the server is perhaps behind a firewall or
something and only allows connections on a single port. libcurl then informs
the remote server which IP address and port number to connect to. This is
made with the \fICURLOPT_FTPPORT(3)\fP option. If you set it to "-", libcurl
uses your system's "default IP address". If you want to use a particular IP,
you can set the full IP address, a host name to resolve to an IP address or
even a local network interface name that libcurl gets the IP address from.
When doing the "PORT" approach, libcurl attempts to use the EPRT and the LPRT
before trying PORT, as they work with more protocols. You can disable this
behavior by setting \fICURLOPT_FTP_USE_EPRT(3)\fP to zero.
.SH "MIME API revisited for SMTP and IMAP"
In addition to support HTTP multi-part form fields, the MIME API can be used
to build structured email messages and send them via SMTP or append such
messages to IMAP directories.
A structured email message may contain several parts: some are displayed
inline by the MUA, some are attachments. Parts can also be structured as
multi-part, for example to include another email message or to offer several
text formats alternatives. This can be nested to any level.
To build such a message, you prepare the nth-level multi-part and then include
it as a source to the parent multi-part using function
\fIcurl_mime_subparts(3)\fP. Once it has been
bound to its parent multi-part, a nth-level multi-part belongs to it and
should not be freed explicitly.
Email messages data is not supposed to be non-ascii and line length is
limited: fortunately, some transfer encodings are defined by the standards to
support the transmission of such incompatible data. Function
\fIcurl_mime_encoder(3)\fP tells a part that its source data must be encoded
before being sent. It also generates the corresponding header for that part.
If the part data you want to send is already encoded in such a scheme, do not
use this function (this would over-encode it), but explicitly set the
corresponding part header.
Upon sending such a message, libcurl prepends it with the header list
set with \fICURLOPT_HTTPHEADER(3)\fP, as zero level mime part headers.
Here is an example building an email message with an inline plain/html text
alternative and a file attachment encoded in base64:
.nf
curl_mime *message = curl_mime_init(handle);
/* The inline part is an alternative proposing the html and the text
versions of the email. */
curl_mime *alt = curl_mime_init(handle);
/* HTML message. */
curl_mimepart *part = curl_mime_addpart(alt);
curl_mime_data(part, "<html><body><p>This is HTML</p></body></html>",
CURL_ZERO_TERMINATED);
curl_mime_type(part, "text/html");
/* Text message. */
part = curl_mime_addpart(alt);
curl_mime_data(part, "This is plain text message",
CURL_ZERO_TERMINATED);
/* Create the inline part. */
part = curl_mime_addpart(message);
curl_mime_subparts(part, alt);
curl_mime_type(part, "multipart/alternative");
struct curl_slist *headers = curl_slist_append(NULL,
"Content-Disposition: inline");
curl_mime_headers(part, headers, TRUE);
/* Add the attachment. */
part = curl_mime_addpart(message);
curl_mime_filedata(part, "manual.pdf");
curl_mime_encoder(part, "base64");
/* Build the mail headers. */
headers = curl_slist_append(NULL, "From: me@example.com");
headers = curl_slist_append(headers, "To: you@example.com");
/* Set these into the easy handle. */
curl_easy_setopt(handle, CURLOPT_HTTPHEADER, headers);
curl_easy_setopt(handle, CURLOPT_MIMEPOST, mime);
.fi
It should be noted that appending a message to an IMAP directory requires
the message size to be known prior upload. It is therefore not possible to
include parts with unknown data size in this context.
.SH "Headers Equal Fun"
Some protocols provide "headers", meta-data separated from the normal
data. These headers are by default not included in the normal data stream, but
you can make them appear in the data stream by setting \fICURLOPT_HEADER(3)\fP
to 1.
What might be even more useful, is libcurl's ability to separate the headers
from the data and thus make the callbacks differ. You can for example set a
different pointer to pass to the ordinary write callback by setting
\fICURLOPT_HEADERDATA(3)\fP.
Or, you can set an entirely separate function to receive the headers, by using
\fICURLOPT_HEADERFUNCTION(3)\fP.
The headers are passed to the callback function one by one, and you can
depend on that fact. It makes it easier for you to add custom header parsers
etc.
\&"Headers" for FTP transfers equal all the FTP server responses. They are not
actually true headers, but in this case we pretend they are! ;-)
.SH "Post Transfer Information"
See \fIcurl_easy_getinfo(3)\fP.
.SH "The multi Interface"
The easy interface as described in detail in this document is a synchronous
interface that transfers one file at a time and does not return until it is
done.
The multi interface, on the other hand, allows your program to transfer
multiple files in both directions at the same time, without forcing you to use
multiple threads. The name might make it seem that the multi interface is for
multi-threaded programs, but the truth is almost the reverse. The multi
interface allows a single-threaded application to perform the same kinds of
multiple, simultaneous transfers that multi-threaded programs can perform. It
allows many of the benefits of multi-threaded transfers without the complexity
of managing and synchronizing many threads.
To complicate matters somewhat more, there are even two versions of the multi
interface. The event based one, also called multi_socket and the "normal one"
designed for using with select(). See the libcurl-multi.3 man page for details
on the multi_socket event based API, this description here is for the select()
oriented one.
To use this interface, you are better off if you first understand the basics
of how to use the easy interface. The multi interface is simply a way to make
multiple transfers at the same time by adding up multiple easy handles into
a "multi stack".
You create the easy handles you want, one for each concurrent transfer, and
you set all the options just like you learned above, and then you create a
multi handle with \fIcurl_multi_init(3)\fP and add all those easy handles to
that multi handle with \fIcurl_multi_add_handle(3)\fP.
When you have added the handles you have for the moment (you can still add new
ones at any time), you start the transfers by calling
\fIcurl_multi_perform(3)\fP.
\fIcurl_multi_perform(3)\fP is asynchronous. It only performs what can be done
now and then return control to your program. It is designed to never
block. You need to keep calling the function until all transfers are
completed.
The best usage of this interface is when you do a select() on all possible
file descriptors or sockets to know when to call libcurl again. This also
makes it easy for you to wait and respond to actions on your own application's
sockets/handles. You figure out what to select() for by using
\fIcurl_multi_fdset(3)\fP, that fills in a set of \fIfd_set\fP variables for
you with the particular file descriptors libcurl uses for the moment.
When you then call select(), it returns when one of the file handles signal
action and you then call \fIcurl_multi_perform(3)\fP to allow libcurl to do
what it wants to do. Take note that libcurl does also feature some time-out
code so we advise you to never use long timeouts on select() before you call
\fIcurl_multi_perform(3)\fP again. \fIcurl_multi_timeout(3)\fP is provided to
help you get a suitable timeout period.
Another precaution you should use: always call \fIcurl_multi_fdset(3)\fP
immediately before the select() call since the current set of file descriptors
may change in any curl function invoke.
If you want to stop the transfer of one of the easy handles in the stack, you
can use \fIcurl_multi_remove_handle(3)\fP to remove individual easy
handles. Remember that easy handles should be \fIcurl_easy_cleanup(3)\fPed.
When a transfer within the multi stack has finished, the counter of running
transfers (as filled in by \fIcurl_multi_perform(3)\fP) decreases. When the
number reaches zero, all transfers are done.
\fIcurl_multi_info_read(3)\fP can be used to get information about completed
transfers. It then returns the CURLcode for each easy transfer, to allow you
to figure out success on each individual transfer.
.SH "SSL, Certificates and Other Tricks"
[ seeding, passwords, keys, certificates, ENGINE, ca certs ]
.SH "Sharing Data Between Easy Handles"
You can share some data between easy handles when the easy interface is used,
and some data is share automatically when you use the multi interface.
When you add easy handles to a multi handle, these easy handles automatically
share a lot of the data that otherwise would be kept on a per-easy handle
basis when the easy interface is used.
The DNS cache is shared between handles within a multi handle, making
subsequent name resolving faster, and the connection pool that is kept to
better allow persistent connections and connection reuse is also shared. If
you are using the easy interface, you can still share these between specific
easy handles by using the share interface, see \fIlibcurl-share(3)\fP.
Some things are never shared automatically, not within multi handles, like for
example cookies so the only way to share that is with the share interface.
.SH "Footnotes"
.IP "[1]"
libcurl 7.10.3 and later have the ability to switch over to chunked
Transfer-Encoding in cases where HTTP uploads are done with data of an unknown
size.
.IP "[2]"
This happens on Windows machines when libcurl is built and used as a
DLL. However, you can still do this on Windows if you link with a static
library.
.IP "[3]"
The curl-config tool is generated at build-time (on Unix-like systems) and
should be installed with the 'make install' or similar instruction that
installs the library, header files, man pages etc.
.IP "[4]"
This behavior was different in versions before 7.17.0, where strings had to
remain valid past the end of the \fIcurl_easy_setopt(3)\fP call.
.SH "SEE ALSO"
.BR libcurl-easy (3),
.BR libcurl-errors (3),
.BR libcurl-multi (3),
.BR libcurl-url (3)
man/man3/CURLOPT_REQUEST_TARGET.3 0000644 00000004132 14751172371 0011657 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_REQUEST_TARGET 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_REQUEST_TARGET \- alternative target for this request
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_REQUEST_TARGET, string);
.fi
.SH DESCRIPTION
Pass a char * to string which libcurl uses in the upcoming request instead of
the path as extracted from the URL.
.SH DEFAULT
NULL
.SH PROTOCOLS
HTTP
.SH EXAMPLE
.nf
curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/*");
curl_easy_setopt(curl, CURLOPT_CUSTOMREQUEST, "OPTIONS");
/* issue an OPTIONS * request (no leading slash) */
curl_easy_setopt(curl, CURLOPT_REQUEST_TARGET, "*");
/* Perform the request */
curl_easy_perform(curl);
}
.fi
.SH AVAILABILITY
Added in 7.55.0
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR CURLOPT_CUSTOMREQUEST (3),
.BR CURLOPT_HTTPGET (3),
.BR CURLOPT_PATH_AS_IS (3),
.BR CURLOPT_URL (3)
man/man3/CURLOPT_DOH_SSL_VERIFYPEER.3 0000644 00000007711 14751172371 0012362 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_DOH_SSL_VERIFYPEER 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_DOH_SSL_VERIFYPEER \- verify the DoH SSL certificate
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_DOH_SSL_VERIFYPEER,
long verify);
.fi
.SH DESCRIPTION
Pass a long as parameter set to 1L to enable or 0L to disable.
This option tells curl to verify the authenticity of the DoH (DNS-over-HTTPS)
server's certificate. A value of 1 means curl verifies; 0 (zero) means it
does not.
This option is the DoH equivalent of \fICURLOPT_SSL_VERIFYPEER(3)\fP and
only affects requests to the DoH server.
When negotiating a TLS or SSL connection, the server sends a certificate
indicating its identity. Curl verifies whether the certificate is authentic,
i.e. that you can trust that the server is who the certificate says it is.
This trust is based on a chain of digital signatures, rooted in certification
authority (CA) certificates you supply. curl uses a default bundle of CA
certificates (the path for that is determined at build time) and you can
specify alternate certificates with the \fICURLOPT_CAINFO(3)\fP option
or the \fICURLOPT_CAPATH(3)\fP option.
When \fICURLOPT_DOH_SSL_VERIFYPEER(3)\fP is enabled, and the verification
fails to prove that the certificate is authentic, the connection fails. When
the option is zero, the peer certificate verification succeeds regardless.
Authenticating the certificate is not enough to be sure about the server. You
typically also want to ensure that the server is the server you mean to be
talking to. Use \fICURLOPT_DOH_SSL_VERIFYHOST(3)\fP for that. The check
that the host name in the certificate is valid for the host name you are
connecting to is done independently of the
\fICURLOPT_DOH_SSL_VERIFYPEER(3)\fP option.
WARNING: disabling verification of the certificate allows bad guys to
man-in-the-middle the communication without you knowing it. Disabling
verification makes the communication insecure. Just having encryption on a
transfer is not enough as you cannot be sure that you are communicating with
the correct end-point.
.SH DEFAULT
1
.SH PROTOCOLS
DoH
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
curl_easy_setopt(curl, CURLOPT_DOH_URL, "https://cloudflare-dns.com/dns-query");
/* Disable certificate verification of the DoH server */
curl_easy_setopt(curl, CURLOPT_DOH_SSL_VERIFYPEER, 0L);
curl_easy_perform(curl);
}
.fi
.SH AVAILABILITY
Added in 7.76.0
If built TLS enabled.
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR CURLOPT_CAINFO (3),
.BR CURLOPT_CAPATH (3),
.BR CURLOPT_DOH_SSL_VERIFYHOST (3),
.BR CURLOPT_PROXY_SSL_VERIFYHOST (3),
.BR CURLOPT_PROXY_SSL_VERIFYPEER (3),
.BR CURLOPT_SSL_VERIFYHOST (3),
.BR CURLOPT_SSL_VERIFYPEER (3)
man/man3/CURLMOPT_MAX_TOTAL_CONNECTIONS.3 0000644 00000005557 14751172371 0013044 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLMOPT_MAX_TOTAL_CONNECTIONS 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLMOPT_MAX_TOTAL_CONNECTIONS \- max simultaneously open connections
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLMcode curl_multi_setopt(CURLM *handle, CURLMOPT_MAX_TOTAL_CONNECTIONS,
long amount);
.fi
.SH DESCRIPTION
Pass a long for the \fBamount\fP. The set number is used as the maximum number
of simultaneously open connections in total using this multi handle. For each
new session, libcurl might open a new connection up to the limit set by
\fICURLMOPT_MAX_TOTAL_CONNECTIONS(3)\fP. When the limit is reached, new
sessions are held pending until there are available connections. If
\fICURLMOPT_PIPELINING(3)\fP is enabled, libcurl can try multiplexing if the
host is capable of it.
When more transfers are added to the multi handle than what can be performed
due to the set limit, they get queued up waiting for their chance. When that
happens, the \fICURLOPT_TIMEOUT_MS(3)\fP timeout is counted inclusive of the
waiting time, meaning that if you set a too narrow timeout in such a case the
transfer might never even start before it times out.
Even in the queued up situation, the \fICURLOPT_CONNECTTIMEOUT_MS(3)\fP
timeout is however treated as a per-connect timeout.
.SH DEFAULT
The default value is 0, which means that there is no limit. It is then simply
controlled by the number of easy handles added.
.SH PROTOCOLS
All
.SH EXAMPLE
.nf
CURLM *m = curl_multi_init();
/* never do more than 15 connections */
curl_multi_setopt(m, CURLMOPT_MAX_TOTAL_CONNECTIONS, 15L);
.fi
.SH AVAILABILITY
Added in 7.30.0
.SH RETURN VALUE
Returns CURLM_OK if the option is supported, and CURLM_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR CURLMOPT_MAXCONNECTS (3),
.BR CURLMOPT_MAX_HOST_CONNECTIONS (3)
man/man3/CURLINFO_RETRY_AFTER.3 0000644 00000004744 14751172371 0011411 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLINFO_RETRY_AFTER 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLINFO_RETRY_AFTER \- returns the Retry-After retry delay
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_getinfo(CURL *handle, CURLINFO_RETRY_AFTER,
curl_off_t *retry);
.fi
.SH DESCRIPTION
Pass a pointer to a curl_off_t variable to receive the number of seconds the
HTTP server suggests the client should wait until the next request is
issued. The information from the "Retry-After:" header.
While the HTTP header might contain a fixed date string, the
\fICURLINFO_RETRY_AFTER(3)\fP always returns the number of seconds to wait -
or zero if there was no header or the header could not be parsed.
.SH DEFAULT
Returns zero delay if there was no header.
.SH PROTOCOLS
HTTP(S)
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
CURLcode res;
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
res = curl_easy_perform(curl);
if(res == CURLE_OK) {
curl_off_t wait = 0;
curl_easy_getinfo(curl, CURLINFO_RETRY_AFTER, &wait);
if(wait)
printf("Wait for %" CURL_FORMAT_CURL_OFF_T " seconds\\n", wait);
}
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Added in 7.66.0
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR curl_easy_header (3),
.BR CURLOPT_HEADERFUNCTION (3),
.BR CURLOPT_STDERR (3)
man/man3/CURLINFO_REDIRECT_TIME.3 0000644 00000004653 14751172371 0011601 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLINFO_REDIRECT_TIME 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLINFO_REDIRECT_TIME \- get the time for all redirection steps
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_getinfo(CURL *handle, CURLINFO_REDIRECT_TIME,
double *timep);
.fi
.SH DESCRIPTION
Pass a pointer to a double to receive the total time, in seconds, it took for
all redirection steps include name lookup, connect, pretransfer and transfer
before final transaction was started. \fICURLINFO_REDIRECT_TIME(3)\fP contains
the complete execution time for multiple redirections.
See also the TIMES overview in the \fIcurl_easy_getinfo(3)\fP man page.
.SH PROTOCOLS
All
.SH EXAMPLE
.nf
curl = curl_easy_init();
if(curl) {
double redirect;
curl_easy_setopt(curl, CURLOPT_URL, url);
res = curl_easy_perform(curl);
if(CURLE_OK == res) {
res = curl_easy_getinfo(curl, CURLINFO_REDIRECT_TIME, &redirect);
if(CURLE_OK == res) {
printf("Time: %.1f", redirect);
}
}
/* always cleanup */
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Added in 7.9.7
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR curl_easy_getinfo (3),
.BR curl_easy_setopt (3),
.BR CURLINFO_REDIRECT_COUNT (3),
.BR CURLINFO_REDIRECT_TIME_T (3),
.BR CURLINFO_REDIRECT_URL (3)
man/man3/CURLINFO_FILETIME_T.3 0000644 00000005572 14751172371 0011244 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLINFO_FILETIME 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLINFO_FILETIME_T \- get the remote time of the retrieved document
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_getinfo(CURL *handle, CURLINFO_FILETIME_T,
curl_off_t *timep);
.fi
.SH DESCRIPTION
Pass a pointer to a curl_off_t to receive the remote time of the retrieved
document in number of seconds since January 1 1970 in the GMT/UTC time
zone. If you get -1, it can be because of many reasons (it might be unknown,
the server might hide it or the server does not support the command that tells
document time etc) and the time of the document is unknown.
You must ask libcurl to collect this information before the transfer is made,
by using the \fICURLOPT_FILETIME(3)\fP option to \fIcurl_easy_setopt(3)\fP or
you unconditionally get a -1 back.
This option is an alternative to \fICURLINFO_FILETIME(3)\fP to allow systems
with 32 bit long variables to extract dates outside of the 32bit timestamp
range.
.SH PROTOCOLS
HTTP(S), FTP(S), SFTP
.SH EXAMPLE
.nf
curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, url);
/* Ask for filetime */
curl_easy_setopt(curl, CURLOPT_FILETIME, 1L);
res = curl_easy_perform(curl);
if(CURLE_OK == res) {
curl_off_t filetime;
res = curl_easy_getinfo(curl, CURLINFO_FILETIME_T, &filetime);
if((CURLE_OK == res) && (filetime >= 0)) {
time_t file_time = (time_t)filetime;
printf("filetime %s: %s", filename, ctime(&file_time));
}
}
/* always cleanup */
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Added in 7.59.0
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR curl_easy_getinfo (3),
.BR curl_easy_setopt (3),
.BR CURLOPT_FILETIME (3)
man/man3/CURLOPT_PROXY_SSL_VERIFYPEER.3 0000644 00000007401 14751172371 0012665 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_PROXY_SSL_VERIFYPEER 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_PROXY_SSL_VERIFYPEER \- verify the proxy's SSL certificate
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_PROXY_SSL_VERIFYPEER,
long verify);
.fi
.SH DESCRIPTION
Pass a long as parameter set to 1L to enable or 0L to disable.
This option tells curl to verify the authenticity of the HTTPS proxy's
certificate. A value of 1 means curl verifies; 0 (zero) means it does not.
This is the proxy version of \fICURLOPT_SSL_VERIFYPEER(3)\fP that is used for
ordinary HTTPS servers.
When negotiating a TLS or SSL connection, the server sends a certificate
indicating its identity. Curl verifies whether the certificate is authentic,
i.e. that you can trust that the server is who the certificate says it is.
This trust is based on a chain of digital signatures, rooted in certification
authority (CA) certificates you supply. curl uses a default bundle of CA
certificates (the path for that is determined at build time) and you can
specify alternate certificates with the \fICURLOPT_PROXY_CAINFO(3)\fP option
or the \fICURLOPT_PROXY_CAPATH(3)\fP option.
When \fICURLOPT_PROXY_SSL_VERIFYPEER(3)\fP is enabled, and the verification
fails to prove that the certificate is authentic, the connection fails. When
the option is zero, the peer certificate verification succeeds regardless.
Authenticating the certificate is not enough to be sure about the server. You
typically also want to ensure that the server is the server you mean to be
talking to. Use \fICURLOPT_PROXY_SSL_VERIFYHOST(3)\fP for that. The check
that the host name in the certificate is valid for the host name you are
connecting to is done independently of the
\fICURLOPT_PROXY_SSL_VERIFYPEER(3)\fP option.
WARNING: disabling verification of the certificate allows bad guys to
man-in-the-middle the communication without you knowing it. Disabling
verification makes the communication insecure. Just having encryption on a
transfer is not enough as you cannot be sure that you are communicating with
the correct end-point.
.SH DEFAULT
1
.SH PROTOCOLS
All
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
/* Set the default value: strict certificate check please */
curl_easy_setopt(curl, CURLOPT_PROXY_SSL_VERIFYPEER, 1L);
curl_easy_perform(curl);
}
.fi
.SH AVAILABILITY
Added in 7.52.0
If built TLS enabled.
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR CURLOPT_PROXY_SSL_VERIFYHOST (3),
.BR CURLOPT_SSL_VERIFYPEER (3),
.BR CURLOPT_SSL_VERIFYHOST (3)
man/man3/CURLOPT_CHUNK_DATA.3 0000644 00000005520 14751172371 0011124 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_CHUNK_DATA 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_CHUNK_DATA \- pointer passed to the FTP chunk callbacks
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_CHUNK_DATA, void *pointer);
.fi
.SH DESCRIPTION
Pass a \fIpointer\fP that is untouched by libcurl and passed as the ptr
argument to the \fICURLOPT_CHUNK_BGN_FUNCTION(3)\fP and
\fICURLOPT_CHUNK_END_FUNCTION(3)\fP.
.SH DEFAULT
NULL
.SH PROTOCOLS
FTP
.SH EXAMPLE
.nf
static long file_is_coming(struct curl_fileinfo *finfo,
struct callback_data *data,
int remains)
{
printf("%3d %40s %10luB ", remains, finfo->filename,
(unsigned long)finfo->size);
switch(finfo->filetype) {
case CURLFILETYPE_DIRECTORY:
printf(" DIR\\n");
break;
case CURLFILETYPE_FILE:
printf("FILE ");
break;
default:
printf("OTHER\\n");
break;
}
if(finfo->filetype == CURLFILETYPE_FILE) {
/* do not transfer files >= 50B */
if(finfo->size > 50) {
printf("SKIPPED\\n");
return CURL_CHUNK_BGN_FUNC_SKIP;
}
data->output = fopen(finfo->filename, "wb");
if(!data->output) {
return CURL_CHUNK_BGN_FUNC_FAIL;
}
}
return CURL_CHUNK_BGN_FUNC_OK;
}
int main()
{
/* data for callback */
struct callback_data callback_info;
/* callback is called before download of concrete file started */
curl_easy_setopt(curl, CURLOPT_CHUNK_BGN_FUNCTION, file_is_coming);
curl_easy_setopt(curl, CURLOPT_CHUNK_DATA, &callback_info);
}
.fi
.SH AVAILABILITY
Added in 7.21.0
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR CURLOPT_CHUNK_BGN_FUNCTION (3),
.BR CURLOPT_WILDCARDMATCH (3)
man/man3/CURLOPT_TRAILERDATA.3 0000644 00000003607 14751172371 0011223 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_TRAILERDATA 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_TRAILERDATA \- pointer passed to trailing headers callback
.SH SYNOPSIS
.nf
#include <curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_TRAILERDATA, void *userdata);
.fi
.SH DESCRIPTION
Data pointer to be passed to the HTTP trailer callback function.
.SH DEFAULT
NULL
.SH PROTOCOLS
HTTP
.SH EXAMPLE
.nf
/* Assuming we have a CURL handle in the hndl variable. */
struct MyData data;
curl_easy_setopt(hndl, CURLOPT_TRAILERDATA, &data);
.fi
A more complete example can be found in examples/http_trailers.html
.SH AVAILABILITY
This option was added in curl 7.64.0 and is present if HTTP support is enabled
.SH RETURN VALUE
Returns CURLE_OK.
.SH "SEE ALSO"
.BR CURLOPT_TRAILERFUNCTION (3),
.BR CURLOPT_WRITEFUNCTION (3)
man/man3/CURLINFO_STARTTRANSFER_TIME_T.3 0000644 00000005032 14751172371 0012715 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLINFO_STARTTRANSFER_TIME_T 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLINFO_STARTTRANSFER_TIME_T \- get the time until the first byte is received
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_getinfo(CURL *handle, CURLINFO_STARTTRANSFER_TIME_T,
curl_off_t *timep);
.fi
.SH DESCRIPTION
Pass a pointer to a curl_off_t to receive the time, in microseconds,
it took from the
start until the first byte is received by libcurl. This includes
\fICURLINFO_PRETRANSFER_TIME_T(3)\fP and also the time the server needs to
calculate the result.
When a redirect is followed, the time from each request is added together.
See also the TIMES overview in the \fIcurl_easy_getinfo(3)\fP man page.
.SH PROTOCOLS
All
.SH EXAMPLE
.nf
curl = curl_easy_init();
if(curl) {
curl_off_t start;
curl_easy_setopt(curl, CURLOPT_URL, url);
res = curl_easy_perform(curl);
if(CURLE_OK == res) {
res = curl_easy_getinfo(curl, CURLINFO_STARTTRANSFER_TIME_T, &start);
if(CURLE_OK == res) {
printf("Time: %" CURL_FORMAT_CURL_OFF_T ".%06ld", start / 1000000,
(long)(start % 1000000));
}
}
/* always cleanup */
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Added in 7.61.0
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR curl_easy_getinfo (3),
.BR curl_easy_setopt (3),
.BR CURLINFO_STARTTRANSFER_TIME (3),
.BR CURLOPT_TIMEOUT (3)
man/man3/curl_multi_timeout.3 0000644 00000006453 14751172371 0012206 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.TH curl_multi_timeout 3 "September 27, 2023" "libcurl 8.4.0" "libcurl"
.SH NAME
curl_multi_timeout \- how long to wait for action before proceeding
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLMcode curl_multi_timeout(CURLM *multi_handle, long *timeout);
.fi
.SH DESCRIPTION
An application using the libcurl multi interface should call
\fIcurl_multi_timeout(3)\fP to figure out how long it should wait for socket
actions \- at most \- before proceeding.
Proceeding means either doing the socket-style timeout action: call the
\fIcurl_multi_socket_action(3)\fP function with the \fBsockfd\fP argument set
to CURL_SOCKET_TIMEOUT, or call \fIcurl_multi_perform(3)\fP if you are using
the simpler and older multi interface approach.
The timeout value returned in the long \fBtimeout\fP points to, is in number
of milliseconds at this moment. If 0, it means you should proceed immediately
without waiting for anything. If it returns -1, there is no timeout at all set.
An application that uses the multi_socket API SHOULD NOT use this function,
but SHOULD instead use the \fICURLMOPT_TIMERFUNCTION(3)\fP option for proper
and desired behavior.
Note: if libcurl returns a -1 timeout here, it just means that libcurl
currently has no stored timeout value. You must not wait too long (more than a
few seconds perhaps) before you call \fIcurl_multi_perform(3)\fP again.
.SH EXAMPLE
.nf
struct timeval timeout;
long timeo;
curl_multi_timeout(multi_handle, &timeo);
if(timeo < 0)
/* no set timeout, use a default */
timeo = 980;
timeout.tv_sec = timeo / 1000;
timeout.tv_usec = (timeo % 1000) * 1000;
/* wait for activities no longer than the set timeout */
select(maxfd+1, &fdread, &fdwrite, &fdexcep, &timeout);
.fi
.SH TYPICAL USAGE
Call \fIcurl_multi_timeout(3)\fP, then wait for action on the sockets. Figure
out which sockets to wait for by calling \fIcurl_multi_fdset(3)\fP.
When there is activity or timeout, call \fIcurl_multi_perform(3)\fP and then
loop - until all transfers are complete.
.SH AVAILABILITY
This function was added in libcurl 7.15.4.
.SH RETURN VALUE
The standard CURLMcode for multi interface error codes.
.SH "SEE ALSO"
.BR curl_multi_fdset (3),
.BR curl_multi_info_read (3),
.BR curl_multi_setopt (3),
.BR curl_multi_socket (3)
man/man3/curl_easy_strerror.3 0000644 00000004052 14751172371 0012202 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.TH curl_easy_strerror 3 "September 26, 2023" "libcurl 8.4.0" "libcurl"
.SH NAME
curl_easy_strerror - return string describing error code
.SH SYNOPSIS
.nf
#include <curl/curl.h>
const char *curl_easy_strerror(CURLcode errornum);
.fi
.SH DESCRIPTION
The \fIcurl_easy_strerror(3)\fP function returns a string describing the
CURLcode error code passed in the argument \fIerrornum\fP.
Typically applications also appreciate \fICURLOPT_ERRORBUFFER(3)\fP for more
specific error descriptions generated at runtime.
.SH EXAMPLE
.nf
/* Perform the entire transfer */
res = curl_easy_perform(curl);
/* Check for errors */
if(res != CURLE_OK)
fprintf(stderr, "curl_easy_perform() failed: %s\\n",
curl_easy_strerror(res));
.fi
.SH AVAILABILITY
This function was added in libcurl 7.12.0
.SH RETURN VALUE
A pointer to a null-terminated string.
.SH "SEE ALSO"
.BR libcurl-errors (3),
.BR curl_multi_strerror (3),
.BR curl_share_strerror (3),
.BR curl_url_strerror (3)
man/man3/CURLOPT_READDATA.3 0000644 00000005076 14751172371 0010636 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_READDATA 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_READDATA \- pointer passed to the read callback
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_READDATA, void *pointer);
.fi
.SH DESCRIPTION
Data \fIpointer\fP to pass to the file read function. If you use the
\fICURLOPT_READFUNCTION(3)\fP option, this is the pointer you get as input in
the fourth argument to the callback.
If you do not specify a read callback but instead rely on the default internal
read function, this data must be a valid readable FILE * (cast to 'void *').
If you are using libcurl as a DLL on Windows, you must use the
\fICURLOPT_READFUNCTION(3)\fP callback if you set this option, otherwise you
might experience crashes.
.SH DEFAULT
By default, this is a FILE * to stdin.
.SH PROTOCOLS
This is used for all protocols when sending data.
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
struct MyData this;
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
/* pass pointer that gets passed in to the
CURLOPT_READFUNCTION callback */
curl_easy_setopt(curl, CURLOPT_READDATA, &this);
curl_easy_perform(curl);
}
.fi
.SH AVAILABILITY
This option was once known by the older name CURLOPT_INFILE, the name
\fICURLOPT_READDATA(3)\fP was introduced in 7.9.7.
.SH RETURN VALUE
This returns CURLE_OK.
.SH "SEE ALSO"
.BR CURLOPT_HEADERDATA (3),
.BR CURLOPT_READFUNCTION (3),
.BR CURLOPT_WRITEDATA (3),
.BR CURLOPT_WRITEFUNCTION (3)
man/man3/CURLINFO_SPEED_UPLOAD_T.3 0000644 00000004226 14751172371 0011745 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLINFO_SPEED_UPLOAD_T 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLINFO_SPEED_UPLOAD_T \- get upload speed
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_getinfo(CURL *handle, CURLINFO_SPEED_UPLOAD_T,
curl_off_t *speed);
.fi
.SH DESCRIPTION
Pass a pointer to a \fIcurl_off_t\fP to receive the average upload speed that
curl measured for the complete upload. Measured in bytes/second.
.SH PROTOCOLS
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
/* Perform the request */
res = curl_easy_perform(curl);
if(!res) {
curl_off_t speed;
res = curl_easy_getinfo(curl, CURLINFO_SPEED_UPLOAD_T, &speed);
if(!res) {
printf("Upload speed %" CURL_FORMAT_CURL_OFF_T " bytes/sec\\n", speed);
}
}
}
.fi
.SH AVAILABILITY
Added in 7.55.0
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR curl_easy_getinfo (3),
.BR curl_easy_setopt (3),
.BR CURLINFO_SPEED_DOWNLOAD_T (3)
man/man3/CURLOPT_RTSP_CLIENT_CSEQ.3 0000644 00000004132 14751172371 0012122 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_RTSP_CLIENT_CSEQ 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_RTSP_CLIENT_CSEQ \- RTSP client CSEQ number
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_RTSP_CLIENT_CSEQ, long cseq);
.fi
.SH DESCRIPTION
Pass a long to set the CSEQ number to issue for the next RTSP request. Useful
if the application is resuming a previously broken connection. The CSEQ
increments from this new number henceforth.
.SH DEFAULT
0
.SH PROTOCOLS
RTSP
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "rtsp://example.com/");
curl_easy_setopt(curl, CURLOPT_RTSP_CLIENT_CSEQ, 1234L);
ret = curl_easy_perform(curl);
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Added in 7.20.0
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR CURLINFO_RTSP_CLIENT_CSEQ (3),
.BR CURLINFO_RTSP_SERVER_CSEQ (3),
.BR CURLOPT_RTSP_REQUEST (3),
.BR CURLOPT_RTSP_SERVER_CSEQ (3)
man/man3/CURLOPT_PROXY_SSLKEY_BLOB.3 0000644 00000005574 14751172371 0012305 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_PROXY_SSLKEY_BLOB 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_PROXY_SSLKEY_BLOB \- private key for proxy cert from memory blob
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_PROXY_SSLKEY_BLOB,
struct curl_blob *blob);
.fi
.SH DESCRIPTION
Pass a pointer to a curl_blob structure that contains information (pointer and
size) about the private key for connecting to the HTTPS proxy. Compatible with
OpenSSL. The format (like "PEM") must be specified with
\fICURLOPT_PROXY_SSLKEYTYPE(3)\fP.
If the blob is initialized with the flags member of struct curl_blob set to
CURL_BLOB_COPY, the application does not have to keep the buffer around after
setting this.
.SH DEFAULT
NULL
.SH PROTOCOLS
All TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc.
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
struct curl_blob blob;
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/");
curl_easy_setopt(curl, CURLOPT_PROXY, "https://proxy");
blob.data = certificateData;
blob.len = filesize;
blob.flags = CURL_BLOB_COPY;
curl_easy_setopt(curl, CURLOPT_PROXY_SSLCERT_BLOB, &blob);
curl_easy_setopt(curl, CURLOPT_PROXY_SSLCERTTYPE, "PEM");
blob.data = privateKeyData;
blob.len = privateKeySize;
curl_easy_setopt(curl, CURLOPT_PROXY_SSLKEY_BLOB, &blob);
curl_easy_setopt(curl, CURLOPT_PROXY_KEYPASSWD, "s3cret");
ret = curl_easy_perform(curl);
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Added in 7.71.0. This option is supported by the OpenSSL backends.
.SH RETURN VALUE
Returns CURLE_OK if TLS enabled, CURLE_UNKNOWN_OPTION if not, or
CURLE_OUT_OF_MEMORY if there was insufficient heap space.
.SH "SEE ALSO"
.BR CURLOPT_SSLKEY (3),
.BR CURLOPT_SSLKEY_BLOB (3),
.BR CURLOPT_SSLKEYTYPE (3)
man/man3/CURLOPT_ACCEPT_ENCODING.3 0000644 00000010702 14751172371 0011666 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_ACCEPT_ENCODING 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_ACCEPT_ENCODING \- automatic decompression of HTTP downloads
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_ACCEPT_ENCODING, char *enc);
.fi
.SH DESCRIPTION
Pass a char * argument specifying what encoding you would like.
Sets the contents of the Accept-Encoding: header sent in an HTTP request, and
enables decoding of a response when a Content-Encoding: header is received.
libcurl potentially supports several different compressed encodings depending
on what support that has been built-in.
To aid applications not having to bother about what specific algorithms this
particular libcurl build supports, libcurl allows a zero-length string to be
set ("") to ask for an Accept-Encoding: header to be used that contains all
built-in supported encodings.
Alternatively, you can specify exactly the encoding or list of encodings you
want in the response. The following encodings are supported: \fIidentity\fP,
meaning non-compressed, \fIdeflate\fP which requests the server to compress
its response using the zlib algorithm, \fIgzip\fP which requests the gzip
algorithm, (since curl 7.57.0) \fIbr\fP which is brotli and (since curl
7.72.0) \fIzstd\fP which is zstd. Provide them in the string as a
comma-separated list of accepted encodings, like: \fB"br, gzip, deflate"\fP.
Set \fICURLOPT_ACCEPT_ENCODING(3)\fP to NULL to explicitly disable it, which
makes libcurl not send an Accept-Encoding: header and not decompress received
contents automatically.
You can also opt to just include the Accept-Encoding: header in your request
with \fICURLOPT_HTTPHEADER(3)\fP but then there is no automatic decompressing
when receiving data.
This is a request, not an order; the server may or may not do it. This option
must be set (to any non-NULL value) or else any unsolicited encoding done by
the server is ignored.
Servers might respond with Content-Encoding even without getting a
Accept-Encoding: in the request. Servers might respond with a different
Content-Encoding than what was asked for in the request.
The Content-Length: servers send for a compressed response is supposed to
indicate the length of the compressed content so when auto decoding is enabled
it may not match the sum of bytes reported by the write callbacks (although,
sending the length of the non-compressed content is a common server mistake).
The application does not have to keep the string around after setting this
option.
.SH DEFAULT
NULL
.SH PROTOCOLS
HTTP
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
/* enable all supported built-in compressions */
curl_easy_setopt(curl, CURLOPT_ACCEPT_ENCODING, "");
/* Perform the request */
curl_easy_perform(curl);
}
.fi
.SH AVAILABILITY
This option was called CURLOPT_ENCODING before 7.21.6
The specific libcurl you are using must have been built with zlib to be able to
decompress gzip and deflate responses, with the brotli library to
decompress brotli responses and with the zstd library to decompress zstd
responses.
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, CURLE_UNKNOWN_OPTION if not, or
CURLE_OUT_OF_MEMORY if there was insufficient heap space.
.SH "SEE ALSO"
.BR CURLOPT_HTTP_CONTENT_DECODING (3),
.BR CURLOPT_HTTPHEADER (3),
.BR CURLOPT_TRANSFER_ENCODING (3)
man/man3/curl_multi_cleanup.3 0000644 00000004552 14751172371 0012145 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.TH curl_multi_cleanup 3 "September 26, 2023" "libcurl 8.4.0" "libcurl"
.SH NAME
curl_multi_cleanup - close down a multi session
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLMcode curl_multi_cleanup(CURLM *multi_handle);
.fi
.SH DESCRIPTION
Cleans up and removes a whole multi stack. It does not free or touch any
individual easy handles in any way - they still need to be closed
individually, using the usual \fIcurl_easy_cleanup(3)\fP way. The order of
cleaning up should be:
1 - \fIcurl_multi_remove_handle(3)\fP before any easy handles are cleaned up
2 - \fIcurl_easy_cleanup(3)\fP can now be called independently since the easy
handle is no longer connected to the multi handle
3 - \fIcurl_multi_cleanup(3)\fP should be called when all easy handles are
removed
Passing in a NULL pointer in \fImulti_handle\fP makes this function return
CURLM_BAD_HANDLE immediately with no other action.
.SH EXAMPLE
.nf
/* when the multi transfer is done ... */
/* remove all easy handles, then: */
curl_multi_cleanup(multi_handle);
.fi
.SH AVAILABILITY
Added in 7.9.6
.SH RETURN VALUE
CURLMcode type, general libcurl multi interface error code. On success,
CURLM_OK is returned.
.SH "SEE ALSO"
.BR curl_easy_cleanup (3),
.BR curl_multi_get_handles (3),
.BR curl_easy_init (3),
.BR curl_multi_init (3)
man/man3/curl_multi_setopt.3 0000644 00000007026 14751172371 0012033 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.TH curl_multi_setopt 3 "September 26, 2023" "libcurl 8.4.0" "libcurl"
.SH NAME
curl_multi_setopt \- set options for a curl multi handle
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLMcode curl_multi_setopt(CURLM *multi_handle, CURLMoption option, param);
.fi
.SH DESCRIPTION
\fIcurl_multi_setopt(3)\fP is used to tell a libcurl multi handle how to
behave. By using the appropriate options to \fIcurl_multi_setopt(3)\fP, you
can change libcurl's behavior when using that multi handle. All options are
set with the \fIoption\fP followed by the parameter \fIparam\fP. That
parameter can be a \fBlong\fP, a \fBfunction pointer\fP, an \fBobject
pointer\fP or a \fBcurl_off_t\fP type, depending on what the specific option
expects. Read this manual carefully as bad input values may cause libcurl to
behave badly. You can only set one option in each function call.
.SH OPTIONS
.IP CURLMOPT_CHUNK_LENGTH_PENALTY_SIZE
See \fICURLMOPT_CHUNK_LENGTH_PENALTY_SIZE(3)\fP
.IP CURLMOPT_CONTENT_LENGTH_PENALTY_SIZE
See \fICURLMOPT_CONTENT_LENGTH_PENALTY_SIZE(3)\fP
.IP CURLMOPT_MAX_HOST_CONNECTIONS
See \fICURLMOPT_MAX_HOST_CONNECTIONS(3)\fP
.IP CURLMOPT_MAX_PIPELINE_LENGTH
See \fICURLMOPT_MAX_PIPELINE_LENGTH(3)\fP
.IP CURLMOPT_MAX_TOTAL_CONNECTIONS
See \fICURLMOPT_MAX_TOTAL_CONNECTIONS(3)\fP
.IP CURLMOPT_MAXCONNECTS
See \fICURLMOPT_MAXCONNECTS(3)\fP
.IP CURLMOPT_PIPELINING
See \fICURLMOPT_PIPELINING(3)\fP
.IP CURLMOPT_PIPELINING_SITE_BL
See \fICURLMOPT_PIPELINING_SITE_BL(3)\fP
.IP CURLMOPT_PIPELINING_SERVER_BL
See \fICURLMOPT_PIPELINING_SERVER_BL(3)\fP
.IP CURLMOPT_PUSHFUNCTION
See \fICURLMOPT_PUSHFUNCTION(3)\fP
.IP CURLMOPT_PUSHDATA
See \fICURLMOPT_PUSHDATA(3)\fP
.IP CURLMOPT_SOCKETFUNCTION
See \fICURLMOPT_SOCKETFUNCTION(3)\fP
.IP CURLMOPT_SOCKETDATA
See \fICURLMOPT_SOCKETDATA(3)\fP
.IP CURLMOPT_TIMERFUNCTION
See \fICURLMOPT_TIMERFUNCTION(3)\fP
.IP CURLMOPT_TIMERDATA
See \fICURLMOPT_TIMERDATA(3)\fP
.IP CURLMOPT_MAX_CONCURRENT_STREAMS
See \fICURLMOPT_MAX_CONCURRENT_STREAMS(3)\fP
.SH EXAMPLE
.fi
/* Limit the amount of simultaneous connections curl should allow: */
curl_multi_setopt(handle, CURLMOPT_MAXCONNECTS, (long)MAX_PARALLEL);
.nf
.SH AVAILABILITY
Added in 7.15.4
.SH RETURN VALUE
The standard CURLMcode for multi interface error codes. Note that it returns a
CURLM_UNKNOWN_OPTION if you try setting an option that this version of libcurl
does not know of.
.SH "SEE ALSO"
.BR curl_multi_cleanup (3),
.BR curl_multi_info_read (3),
.BR curl_multi_init (3),
.BR curl_multi_socket (3)
man/man3/CURLINFO_CONN_ID.3 0000644 00000004473 14751172371 0010673 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLINFO_CONN_ID 3 "September 26, 2023" "libcurl 8.4.0" "libcurl"
.SH NAME
CURLINFO_CONN_ID \- get the ID of the last connection used by the handle
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_getinfo(CURL *handle, CURLINFO_CONN_ID,
curl_off_t *conn_id);
.fi
.SH DESCRIPTION
Pass a pointer to a \fIcurl_off_t\fP to receive the connection identifier last
used by the handle. Stores -1 if there was no connection used.
The connection id is unique among all connections using the same
connection cache. This is implicitly the case for all connections in the
same multi handle.
.SH PROTOCOLS
All
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
/* Perform the request */
res = curl_easy_perform(curl);
if(!res) {
curl_off_t conn_id;
res = curl_easy_getinfo(curl, CURLINFO_CONN_ID, &conn_id);
if(!res) {
printf("Connection used: %" CURL_FORMAT_CURL_OFF_T "\\n", conn_id);
}
}
}
.fi
.SH AVAILABILITY
Added in 8.2.0
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR curl_easy_getinfo (3),
.BR curl_easy_setopt (3),
.BR CURLINFO_XFER_ID (3)
man/man3/CURLOPT_TLSAUTH_PASSWORD.3 0000644 00000005011 14751172371 0012124 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_TLSAUTH_PASSWORD 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_TLSAUTH_PASSWORD \- password to use for TLS authentication
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_TLSAUTH_PASSWORD, char *pwd);
.fi
.SH DESCRIPTION
Pass a char * as parameter, which should point to the null-terminated password
to use for the TLS authentication method specified with the
\fICURLOPT_TLSAUTH_TYPE(3)\fP option. Requires that the
\fICURLOPT_TLSAUTH_USERNAME(3)\fP option also be set.
The application does not have to keep the string around after setting this
option.
This feature relies in TLS SRP which does not work with TLS 1.3.
.SH DEFAULT
NULL
.SH PROTOCOLS
All TLS-based protocols
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/");
curl_easy_setopt(curl, CURLOPT_TLSAUTH_TYPE, "SRP");
curl_easy_setopt(curl, CURLOPT_TLSAUTH_USERNAME, "user");
curl_easy_setopt(curl, CURLOPT_TLSAUTH_PASSWORD, "secret");
ret = curl_easy_perform(curl);
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Added in 7.21.4, with the OpenSSL and GnuTLS backends only
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, CURLE_UNKNOWN_OPTION if not, or
CURLE_OUT_OF_MEMORY if there was insufficient heap space.
.SH "SEE ALSO"
.BR CURLOPT_PROXY_TLSAUTH_PASSWORD (3),
.BR CURLOPT_TLSAUTH_TYPE (3),
.BR CURLOPT_TLSAUTH_USERNAME (3)
man/man3/CURLINFO_CONNECT_TIME.3 0000644 00000004373 14751172371 0011470 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLINFO_CONNECT_TIME 3 "September 26, 2023" "libcurl 8.4.0" "libcurl"
.SH NAME
CURLINFO_CONNECT_TIME \- get the time until connect
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_getinfo(CURL *handle, CURLINFO_CONNECT_TIME, double *timep);
.fi
.SH DESCRIPTION
Pass a pointer to a double to receive the total time in seconds from the start
until the connection to the remote host (or proxy) was completed.
When a redirect is followed, the time from each request is added together.
See also the TIMES overview in the \fIcurl_easy_getinfo(3)\fP man page.
.SH PROTOCOLS
All
.SH EXAMPLE
.nf
curl = curl_easy_init();
if(curl) {
double connect;
curl_easy_setopt(curl, CURLOPT_URL, url);
res = curl_easy_perform(curl);
if(CURLE_OK == res) {
res = curl_easy_getinfo(curl, CURLINFO_CONNECT_TIME, &connect);
if(CURLE_OK == res) {
printf("Time: %.1f", connect);
}
}
/* always cleanup */
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Added in 7.4.1
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR curl_easy_getinfo (3),
.BR curl_easy_setopt (3),
.BR CURLINFO_CONNECT_TIME_T (3)
man/man3/CURLINFO_HTTP_CONNECTCODE.3 0000644 00000004434 14751172371 0012142 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLINFO_HTTP_CONNECTCODE 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLINFO_HTTP_CONNECTCODE \- get the CONNECT response code
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_getinfo(CURL *handle, CURLINFO_HTTP_CONNECTCODE, long *p);
.fi
.SH DESCRIPTION
Pass a pointer to a long to receive the last received HTTP proxy response code
to a CONNECT request. The returned value is zero if no such response code was
available.
.SH PROTOCOLS
HTTP
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
CURLcode res;
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
/* typically CONNECT is used to do HTTPS over HTTP proxies */
curl_easy_setopt(curl, CURLOPT_PROXY, "http://127.0.0.1");
res = curl_easy_perform(curl);
if(res == CURLE_OK) {
long code;
res = curl_easy_getinfo(curl, CURLINFO_HTTP_CONNECTCODE, &code);
if(!res && code)
printf("The CONNECT response code: %03ld\\n", code);
}
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Added in 7.10.7
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR curl_easy_getinfo (3),
.BR curl_easy_setopt (3),
.BR CURLINFO_RESPONSE_CODE (3)
man/man3/curl_easy_option_next.3 0000644 00000006413 14751172371 0012671 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.TH curl_easy_option_next 3 "September 26, 2023" "libcurl 8.4.0" "libcurl"
.SH NAME
curl_easy_option_next - iterate over easy setopt options
.SH SYNOPSIS
.nf
#include <curl/curl.h>
typedef enum {
CURLOT_LONG, /* long (a range of values) */
CURLOT_VALUES, /* (a defined set or bitmask) */
CURLOT_OFF_T, /* curl_off_t (a range of values) */
CURLOT_OBJECT, /* pointer (void *) */
CURLOT_STRING, /* (char * to null-terminated buffer) */
CURLOT_SLIST, /* (struct curl_slist *) */
CURLOT_CBPTR, /* (void * passed as-is to a callback) */
CURLOT_BLOB, /* blob (struct curl_blob *) */
CURLOT_FUNCTION /* function pointer */
} curl_easytype;
/* The CURLOPTTYPE_* id ranges can still be used to figure out what type/size
to use for curl_easy_setopt() for the given id */
struct curl_easyoption {
const char *name;
CURLoption id;
curl_easytype type;
unsigned int flags;
};
const struct curl_easyoption *
curl_easy_option_next(const struct curl_easyoption *prev);
.fi
.SH DESCRIPTION
This function returns a pointer to the first or the next \fIcurl_easyoption\fP
struct, providing an ability to iterate over all known options for
\fIcurl_easy_setopt(3)\fP in this instance of libcurl.
Pass a \fBNULL\fP argument as \fBprev\fP to get the first option returned, or
pass in the current option to get the next one returned. If there is no more
option to return, \fIcurl_easy_option_next(3)\fP returns NULL.
The options returned by this functions are the ones known to this libcurl and
information about what argument type they want.
If the \fBCURLOT_FLAG_ALIAS\fP bit is set in the flags field, it means the
name is provided for backwards compatibility as an alias.
.SH EXAMPLE
.nf
/* iterate over all available options */
const struct curl_easyoption *opt;
opt = curl_easy_option_by_next(NULL);
while(opt) {
printf("Name: %s\\n", opt->name);
opt = curl_easy_option_by_next(opt);
}
.fi
.SH AVAILABILITY
This function was added in libcurl 7.73.0
.SH RETURN VALUE
A pointer to the \fIcurl_easyoption\fP struct for the next option or NULL if
no more options.
.SH "SEE ALSO"
.BR curl_easy_option_by_id (3),
.BR curl_easy_option_by_name (3),
.BR curl_easy_setopt (3)
man/man3/CURLOPT_SASL_IR.3 0000644 00000004451 14751172371 0010621 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_SASL_IR 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_SASL_IR \- send initial response in first packet
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_SASL_IR, long enable);
.fi
.SH DESCRIPTION
Pass a long. If the value is 1, curl sends the initial response to the server
in the first authentication packet in order to reduce the number of ping pong
requests. Only applicable to the following supporting SASL authentication
mechanisms:
* Login
* Plain
* GSSAPI
* NTLM
* OAuth 2.0
Note: Whilst IMAP supports this option there is no need to explicitly set it,
as libcurl can determine the feature itself when the server supports the
SASL-IR CAPABILITY.
.SH DEFAULT
0
.SH PROTOCOLS
IMAP, POP3 and SMTP
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "smtp://example.com/");
curl_easy_setopt(curl, CURLOPT_SASL_IR, 1L);
ret = curl_easy_perform(curl);
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Added in 7.31.0
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR CURLOPT_MAIL_AUTH (3),
.BR CURLOPT_MAIL_FROM (3),
.BR CURLOPT_SASL_AUTHZID (3)
man/man3/libcurl.3 0000644 00000027002 14751172371 0007706 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.TH libcurl 3 "August 22, 2023" "libcurl 8.4.0" "libcurl"
.SH NAME
libcurl \- client-side URL transfers
.SH DESCRIPTION
This is a short overview on how to use libcurl in your C programs. There are
specific man pages for each function mentioned in here. See
\fIlibcurl-easy(3)\fP, \fIlibcurl-multi(3)\fP, \fIlibcurl-share(3)\fP,
\fIlibcurl-url(3)\fP, \fIlibcurl-ws(3)\fP and \fIlibcurl-tutorial(3)\fP for
in-depth understanding on how to program with libcurl.
There are many bindings available that bring libcurl access to your favorite
language. Look elsewhere for documentation on those.
.SH TRANSFERS
To transfer files, you create an "easy handle" using \fIcurl_easy_init(3)\fP
for a single individual transfer (in either direction). You then set your
desired set of options in that handle with \fIcurl_easy_setopt(3)\fP. Options
you set with \fIcurl_easy_setopt(3)\fP stick. They are then used for every
repeated use of this handle until you either change the option, or you reset
them all with \fIcurl_easy_reset(3)\fP.
To actually transfer data you have the option of using the "easy" interface,
or the "multi" interface.
The easy interface is a synchronous interface with which you call
\fIcurl_easy_perform(3)\fP and let it perform the transfer. When it is
completed, the function returns and you can continue. More details are found in
the \fIlibcurl-easy(3)\fP man page.
The multi interface on the other hand is an asynchronous interface, that you
call and that performs only a little piece of the transfer on each invoke. It
is perfect if you want to do things while the transfer is in progress, or
similar. The multi interface allows you to select() on libcurl action, and
even to easily download multiple files simultaneously using a single
thread. See further details in the \fIlibcurl-multi(3)\fP man page.
.SH "SUPPORT INTERFACES"
There is also a series of other helpful functions and interface families to
use, including these:
.RS
.IP curl_version_info()
gets detailed libcurl (and other used libraries) version info. See
\fIcurl_version_info(3)\fP
.IP curl_getdate()
converts a date string to time_t. See \fIcurl_getdate(3)\fP
.IP curl_easy_getinfo()
get information about a performed transfer. See \fIcurl_easy_getinfo(3)\fP
.IP curl_mime_addpart()
helps building an HTTP form POST. See \fIcurl_mime_addpart(3)\fP
.IP curl_slist_append()
builds a linked list. See \fIcurl_slist_append(3)\fP
.IP Sharing data between transfers
You can have multiple easy handles share certain data, even if they are used
in different threads. This magic is setup using the share interface, as
described in the \fIlibcurl-share(3)\fP man page.
.IP "URL Parsing"
URL parsing and manipulations. See \fIlibcurl-url(3)\fP
.IP "WebSocket communication"
See \fIlibcurl-ws(3)\fP
.RE
.SH "LINKING WITH LIBCURL"
On unix-like machines, there is a tool named curl-config that gets installed
with the rest of the curl stuff when 'make install' is performed.
curl-config is added to make it easier for applications to link with libcurl
and developers to learn about libcurl and how to use it.
Run 'curl-config --libs' to get the (additional) linker options you need to
link with the particular version of libcurl you have installed. See the
\fIcurl-config(1)\fP man page for further details.
Unix-like operating system that ship libcurl as part of their distributions
often do not provide the curl-config tool, but simply install the library and
headers in the common path for this purpose.
Many Linux and similar systems use pkg-config to provide build and link
options about libraries and libcurl supports that as well.
.SH "LIBCURL SYMBOL NAMES"
All public functions in the libcurl interface are prefixed with 'curl_' (with
a lowercase c). You can find other functions in the library source code, but
other prefixes indicate that the functions are private and may change without
further notice in the next release.
Only use documented functions and functionality!
.SH "PORTABILITY"
libcurl works
.B exactly
the same, on any of the platforms it compiles and builds on.
.SH "THREADS"
libcurl is thread safe but there are a few exceptions. Refer to
\fIlibcurl-thread(3)\fP for more information.
.SH "PERSISTENT CONNECTIONS"
Persistent connections means that libcurl can reuse the same connection for
several transfers, if the conditions are right.
libcurl always attempts to use persistent connections. Whenever you use
\fIcurl_easy_perform(3)\fP or \fIcurl_multi_perform(3)\fP etc, libcurl
attempts to use an existing connection to do the transfer, and if none exists
it opens a new one that is subject for reuse on a possible following call to
\fIcurl_easy_perform(3)\fP or \fIcurl_multi_perform(3)\fP.
To allow libcurl to take full advantage of persistent connections, you should
do as many of your file transfers as possible using the same handle.
If you use the easy interface, and you call \fIcurl_easy_cleanup(3)\fP, all
the possibly open connections held by libcurl are closed and forgotten.
When you have created a multi handle and are using the multi interface, the
connection pool is instead kept in the multi handle so closing and creating
new easy handles to do transfers do not affect them. Instead all added easy
handles can take advantage of the single shared pool.
.SH "GLOBAL CONSTANTS"
There are a variety of constants that libcurl uses, mainly through its
internal use of other libraries, which are too complicated for the
library loader to set up. Therefore, a program must call a library
function after the program is loaded and running to finish setting up
the library code. For example, when libcurl is built for SSL
capability via the GNU TLS library, there is an elaborate tree inside
that library that describes the SSL protocol.
\fIcurl_global_init(3)\fP is the function that you must call. This may
allocate resources (e.g. the memory for the GNU TLS tree mentioned above), so
the companion function \fIcurl_global_cleanup(3)\fP releases them.
If libcurl was compiled with support for multiple SSL backends, the function
\fIcurl_global_sslset(3)\fP can be called before \fIcurl_global_init(3)\fP
to select the active SSL backend.
The global constant functions are thread-safe since libcurl 7.84.0 if
\fIcurl_version_info(3)\fP has the CURL_VERSION_THREADSAFE feature bit set
(most platforms). Read \fIlibcurl-thread(3)\fP for thread safety guidelines.
If the global constant functions are \fInot thread safe\fP, then you must
not call them when any other thread in the program is running. It
is not good enough that no other thread is using libcurl at the time,
because these functions internally call similar functions of other
libraries, and those functions are similarly thread-unsafe. You cannot
generally know what these libraries are, or whether other threads are
using them.
If the global constant functions are \fInot thread safe\fP, then the basic rule
for constructing a program that uses libcurl is this: Call
\fIcurl_global_init(3)\fP, with a \fICURL_GLOBAL_ALL\fP argument, immediately
after the program starts, while it is still only one thread and before it uses
libcurl at all. Call \fIcurl_global_cleanup(3)\fP immediately before the
program exits, when the program is again only one thread and after its last
use of libcurl.
It is not actually required that the functions be called at the beginning
and end of the program -- that is just usually the easiest way to do it.
You can call both of these multiple times, as long as all calls meet
these requirements and the number of calls to each is the same.
The global constant situation merits special consideration when the
code you are writing to use libcurl is not the main program, but rather
a modular piece of a program, e.g. another library. As a module,
your code does not know about other parts of the program -- it does not
know whether they use libcurl or not. And its code does not necessarily
run at the start and end of the whole program.
A module like this must have global constant functions of its own, just like
\fIcurl_global_init(3)\fP and \fIcurl_global_cleanup(3)\fP. The module thus
has control at the beginning and end of the program and has a place to call
the libcurl functions. If multiple modules in the program use libcurl, they
all separately call the libcurl functions, and that is OK because only the
first \fIcurl_global_init(3)\fP and the last \fIcurl_global_cleanup(3)\fP in a
program change anything. (libcurl uses a reference count in static memory).
In a C++ module, it is common to deal with the global constant situation by
defining a special class that represents the global constant environment of
the module. A program always has exactly one object of the class, in static
storage. That way, the program automatically calls the constructor of the
object as the program starts up and the destructor as it terminates. As the
author of this libcurl-using module, you can make the constructor call
\fIcurl_global_init(3)\fP and the destructor call \fIcurl_global_cleanup(3)\fP
and satisfy libcurl's requirements without your user having to think about it.
(Caveat: If you are initializing libcurl from a Windows DLL you should not
initialize it from \fIDllMain\fP or a static initializer because Windows holds
the loader lock during that time and it could cause a deadlock.)
\fIcurl_global_init(3)\fP has an argument that tells what particular parts of
the global constant environment to set up. In order to successfully use any
value except \fICURL_GLOBAL_ALL\fP (which says to set up the whole thing), you
must have specific knowledge of internal workings of libcurl and all other
parts of the program of which it is part.
A special part of the global constant environment is the identity of the
memory allocator. \fIcurl_global_init(3)\fP selects the system default memory
allocator, but you can use \fIcurl_global_init_mem(3)\fP to supply one of your
own. However, there is no way to use \fIcurl_global_init_mem(3)\fP in a
modular program -- all modules in the program that might use libcurl would
have to agree on one allocator.
There is a failsafe in libcurl that makes it usable in simple situations
without you having to worry about the global constant environment at all:
\fIcurl_easy_init(3)\fP sets up the environment itself if it has not been done
yet. The resources it acquires to do so get released by the operating system
automatically when the program exits.
This failsafe feature exists mainly for backward compatibility because there
was a time when the global functions did not exist. Because it is sufficient
only in the simplest of programs, it is not recommended for any program to
rely on it.
man/man3/CURLMOPT_SOCKETDATA.3 0000644 00000004534 14751172371 0011226 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLMOPT_SOCKETDATA 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLMOPT_SOCKETDATA \- custom pointer passed to the socket callback
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLMcode curl_multi_setopt(CURLM *handle, CURLMOPT_SOCKETDATA, void *pointer);
.SH DESCRIPTION
A data \fIpointer\fP to pass to the socket callback set with the
\fICURLMOPT_SOCKETFUNCTION(3)\fP option.
This pointer is not touched by libcurl but is only passed in as the socket
callbacks's \fBclientp\fP argument.
.SH DEFAULT
NULL
.SH PROTOCOLS
All
.SH EXAMPLE
.nf
static int sock_cb(CURL *e, curl_socket_t s, int what, void *cbp, void *sockp)
{
GlobalInfo *g = (GlobalInfo*) cbp;
SockInfo *fdp = (SockInfo*) sockp;
if(what == CURL_POLL_REMOVE) {
remsock(fdp);
}
else {
if(!fdp) {
addsock(s, e, what, g);
}
else {
setsock(fdp, s, e, what, g);
}
}
return 0;
}
main()
{
GlobalInfo setup;
/* ... use socket callback and custom pointer */
curl_multi_setopt(multi, CURLMOPT_SOCKETFUNCTION, sock_cb);
curl_multi_setopt(multi, CURLMOPT_SOCKETDATA, &setup);
}
.fi
.SH AVAILABILITY
Added in 7.15.4
.SH RETURN VALUE
Returns CURLM_OK.
.SH "SEE ALSO"
.BR curl_multi_socket_action (3),
.BR CURLMOPT_SOCKETFUNCTION (3),
.BR CURLMOPT_TIMERFUNCTION (3)
man/man3/CURLOPT_PRIVATE.3 0000644 00000004375 14751172371 0010604 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_PRIVATE 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_PRIVATE \- store a private pointer
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_PRIVATE, void *pointer);
.fi
.SH DESCRIPTION
Pass a void * as parameter, pointing to data that should be associated with
this curl handle. The pointer can subsequently be retrieved using
\fIcurl_easy_getinfo(3)\fP with the \fICURLINFO_PRIVATE(3)\fP option. libcurl
itself never does anything with this data.
.SH DEFAULT
NULL
.SH PROTOCOLS
All
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
struct private secrets;
if(curl) {
struct private *extracted;
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
/* store a pointer to our private struct */
curl_easy_setopt(curl, CURLOPT_PRIVATE, &secrets);
curl_easy_perform(curl);
/* we can extract the private pointer again too */
curl_easy_getinfo(curl, CURLINFO_PRIVATE, &extracted);
}
.fi
.SH AVAILABILITY
Added in 7.10.3
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR CURLINFO_PRIVATE (3),
.BR CURLOPT_STDERR (3),
.BR CURLOPT_VERBOSE (3)
man/man3/CURLINFO_CAPATH.3 0000644 00000004526 14751172371 0010521 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLINFO_CAPATH 3 "September 26, 2023" "libcurl 8.4.0" "libcurl"
.SH NAME
CURLINFO_CAPATH \- get the default built-in CA path string
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_getinfo(CURL *handle, CURLINFO_CAPATH, char **path);
.fi
.SH DESCRIPTION
Pass a pointer to a char pointer to receive the pointer to a null-terminated
string holding the default built-in path used for the \fICURLOPT_CAPATH(3)\fP
option unless set by the user.
Note that in a situation where libcurl has been built to support multiple TLS
libraries, this option might return a string even if the specific TLS library
currently set to be used does not support \fICURLOPT_CAPATH(3)\fP.
This is a path identifying a directory.
The \fBpath\fP pointer is set to NULL if there is no default path.
.SH PROTOCOLS
All
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
CURLcode res;
char *capath = NULL;
curl_easy_getinfo(curl, CURLINFO_CAPATH, &capath);
if(capath)
printf("default ca path: %s\\n", capath);
}
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Added in 7.84.0
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR curl_easy_getinfo (3),
.BR curl_easy_setopt (3),
.BR CURLINFO_CAINFO (3)
man/man3/CURLOPT_IOCTLFUNCTION.3 0000644 00000006574 14751172371 0011515 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_IOCTLFUNCTION 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_IOCTLFUNCTION \- callback for I/O operations
.SH SYNOPSIS
.nf
#include <curl/curl.h>
typedef enum {
CURLIOE_OK, /* I/O operation successful */
CURLIOE_UNKNOWNCMD, /* command was unknown to callback */
CURLIOE_FAILRESTART, /* failed to restart the read */
CURLIOE_LAST /* never use */
} curlioerr;
typedef enum {
CURLIOCMD_NOP, /* no operation */
CURLIOCMD_RESTARTREAD, /* restart the read stream from start */
CURLIOCMD_LAST /* never use */
} curliocmd;
curlioerr ioctl_callback(CURL *handle, int cmd, void *clientp);
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_IOCTLFUNCTION, ioctl_callback);
.SH DESCRIPTION
Pass a pointer to your callback function, which should match the prototype
shown above.
This callback function gets called by libcurl when something special
I/O-related needs to be done that the library cannot do by itself. For now,
rewinding the read data stream is the only action it can request. The
rewinding of the read data stream may be necessary when doing an HTTP PUT or
POST with a multi-pass authentication method.
The callback MUST return \fICURLIOE_UNKNOWNCMD\fP if the input \fIcmd\fP is
not \fICURLIOCMD_RESTARTREAD\fP.
The \fIclientp\fP argument to the callback is set with the
\fICURLOPT_IOCTLDATA(3)\fP option.
This option is deprecated! Do not use it. Use \fICURLOPT_SEEKFUNCTION(3)\fP
instead to provide seeking! If \fICURLOPT_SEEKFUNCTION(3)\fP is set, this
parameter is ignored when seeking.
.SH DEFAULT
By default, this parameter is set to NULL. Not used.
.SH PROTOCOLS
Used with HTTP
.SH EXAMPLE
.nf
static curlioerr ioctl_callback(CURL *handle, int cmd, void *clientp)
{
struct data *io = (struct data *)clientp;
if(cmd == CURLIOCMD_RESTARTREAD) {
lseek(fd, 0, SEEK_SET);
current_offset = 0;
return CURLIOE_OK;
}
return CURLIOE_UNKNOWNCMD;
}
{
struct data ioctl_data;
curl_easy_setopt(curl, CURLOPT_IOCTLFUNCTION, ioctl_callback);
curl_easy_setopt(curl, CURLOPT_IOCTLDATA, &ioctl_data);
}
.fi
.SH AVAILABILITY
Added in 7.12.3. Deprecated since 7.18.0.
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR CURLOPT_IOCTLDATA (3),
.BR CURLOPT_SEEKFUNCTION (3)
man/man3/CURLOPT_CAINFO.3 0000644 00000006500 14751172371 0010421 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_CAINFO 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_CAINFO \- path to Certificate Authority (CA) bundle
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_CAINFO, char *path);
.fi
.SH DESCRIPTION
Pass a char * to a null-terminated string naming a file holding one or more
certificates to verify the peer with.
If \fICURLOPT_SSL_VERIFYPEER(3)\fP is zero and you avoid verifying the
server's certificate, \fICURLOPT_CAINFO(3)\fP need not even indicate an
accessible file.
This option is by default set to the system path where libcurl's CA
certificate bundle is assumed to be stored, as established at build time.
(iOS and macOS) When curl uses Secure Transport this option is supported. If
the option is not set, then curl uses the certificates in the system and user
Keychain to verify the peer.
(Schannel) This option is supported for Schannel in Windows 7 or later but we
recommend not using it until Windows 8 since it works better starting then.
If the option is not set, then curl uses the certificates in the Windows'
store of root certificates (the default for Schannel).
The application does not have to keep the string around after setting this
option.
The default value for this can be figured out with \fICURLINFO_CAINFO(3)\fP.
.SH DEFAULT
Built-in system specific. When curl is built with Secure Transport or
Schannel, this option is not set by default.
.SH PROTOCOLS
All TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc.
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/");
curl_easy_setopt(curl, CURLOPT_CAINFO, "/etc/certs/cabundle.pem");
ret = curl_easy_perform(curl);
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
For the SSL engines that do not support certificate files the
\fICURLOPT_CAINFO(3)\fP option is ignored. Schannel support added in libcurl
7.60.
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, CURLE_UNKNOWN_OPTION if not, or
CURLE_OUT_OF_MEMORY if there was insufficient heap space.
.SH "SEE ALSO"
.BR CURLINFO_CAINFO (3),
.BR CURLOPT_CA_CACHE_TIMEOUT (3),
.BR CURLOPT_CAINFO_BLOB (3),
.BR CURLOPT_CAPATH (3),
.BR CURLOPT_SSL_VERIFYHOST (3),
.BR CURLOPT_SSL_VERIFYPEER (3)
man/man3/curl_mime_name.3 0000644 00000004416 14751172371 0011232 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.TH curl_mime_name 3 "September 26, 2023" "libcurl 8.4.0" "libcurl"
.SH NAME
curl_mime_name - set a mime part's name
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_mime_name(curl_mimepart *part, const char *name);
.fi
.SH DESCRIPTION
\fIcurl_mime_name(3)\fP sets a mime part's name. This is the way HTTP form
fields are named.
\fIpart\fP is the part's handle to assign a name to.
\fIname\fP points to the null-terminated name string.
The name string is copied into the part, thus the associated storage may
safely be released or reused after call. Setting a part's name multiple times
is valid: only the value set by the last call is retained. It is possible to
reset the name of a part by setting \fIname\fP to NULL.
.SH EXAMPLE
.nf
curl_mime *mime;
curl_mimepart *part;
/* create a mime handle */
mime = curl_mime_init(easy);
/* add a part */
part = curl_mime_addpart(mime);
/* give the part a name */
curl_mime_name(part, "shoe_size");
.fi
.SH AVAILABILITY
As long as at least one of HTTP, SMTP or IMAP is enabled. Added in 7.56.0.
.SH RETURN VALUE
CURLE_OK or a CURL error code upon failure.
.SH "SEE ALSO"
.BR curl_mime_addpart (3),
.BR curl_mime_data (3),
.BR curl_mime_type (3)
man/man3/CURLMOPT_MAX_PIPELINE_LENGTH.3 0000644 00000004606 14751172371 0012557 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLMOPT_MAX_PIPELINE_LENGTH 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLMOPT_MAX_PIPELINE_LENGTH \- maximum number of requests in a pipeline
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLMcode curl_multi_setopt(CURLM *handle, CURLMOPT_MAX_PIPELINE_LENGTH,
long max);
.fi
.SH DESCRIPTION
No function since pipelining was removed in 7.62.0.
Pass a long. The set \fBmax\fP number is used as the maximum amount of
outstanding requests in an HTTP/1.1 pipeline. This option is only used for
HTTP/1.1 pipelining, not for HTTP/2 multiplexing.
When this limit is reached, libcurl creates another connection to the same
host (see \fICURLMOPT_MAX_HOST_CONNECTIONS(3)\fP), or queue the request until
one of the pipelines to the host is ready to accept a request. Thus, the
total number of requests in-flight is \fICURLMOPT_MAX_HOST_CONNECTIONS(3)\fP *
\fICURLMOPT_MAX_PIPELINE_LENGTH(3)\fP.
.SH DEFAULT
5
.SH PROTOCOLS
HTTP(S)
.SH EXAMPLE
.nf
CURLM *m = curl_multi_init();
/* set a more conservative pipe length */
curl_multi_setopt(m, CURLMOPT_MAX_PIPELINE_LENGTH, 3L);
.fi
.SH AVAILABILITY
Added in 7.30.0
.SH RETURN VALUE
Returns CURLM_OK if the option is supported, and CURLM_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR CURLMOPT_PIPELINING (3),
.BR CURLMOPT_MAX_HOST_CONNECTIONS (3)
man/man3/CURLOPT_PROXYUSERPWD.3 0000644 00000005072 14751172371 0011460 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_PROXYUSERPWD 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_PROXYUSERPWD \- user name and password to use for proxy authentication
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_PROXYUSERPWD, char *userpwd);
.fi
.SH DESCRIPTION
Pass a char * as parameter, which should be [user name]:[password] to use for
the connection to the HTTP proxy. Both the name and the password are URL
decoded before used, so to include for example a colon in the user name you
should encode it as %3A. (This is different to how \fICURLOPT_USERPWD(3)\fP is
used - beware.)
Use \fICURLOPT_PROXYAUTH(3)\fP to specify the authentication method.
The application does not have to keep the string around after setting this
option.
.SH DEFAULT
This is NULL by default.
.SH PROTOCOLS
Used with all protocols that can use a proxy
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/foo.bin");
curl_easy_setopt(curl, CURLOPT_PROXY, "http://localhost:8080");
curl_easy_setopt(curl, CURLOPT_PROXYUSERPWD, "clark%20kent:superman");
ret = curl_easy_perform(curl);
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Always
.SH RETURN VALUE
Returns CURLE_OK if proxies are supported, CURLE_UNKNOWN_OPTION if not, or
CURLE_OUT_OF_MEMORY if there was insufficient heap space.
.SH "SEE ALSO"
.BR CURLOPT_PROXY (3),
.BR CURLOPT_PROXYPASSWORD (3),
.BR CURLOPT_PROXYTYPE (3),
.BR CURLOPT_PROXYUSERNAME (3)
man/man3/CURLOPT_DOH_SSL_VERIFYHOST.3 0000644 00000006300 14751172371 0012375 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_DOH_SSL_VERIFYHOST 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_DOH_SSL_VERIFYHOST \- verify the host name in the DoH SSL certificate
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_DOH_SSL_VERIFYHOST,
long verify);
.fi
.SH DESCRIPTION
Pass a long set to 2L as asking curl to \fIverify\fP the DoH (DNS-over-HTTPS)
server's certificate name fields against the host name.
This option is the DoH equivalent of \fICURLOPT_SSL_VERIFYHOST(3)\fP and
only affects requests to the DoH server.
When \fICURLOPT_DOH_SSL_VERIFYHOST(3)\fP is 2, the SSL certificate provided by
the DoH server must indicate that the server name is the same as the server
name to which you meant to connect to, or the connection fails.
Curl considers the DoH server the intended one when the Common Name field or a
Subject Alternate Name field in the certificate matches the host name in the
DoH URL to which you told Curl to connect.
When the \fIverify\fP value is set to 1L it is treated the same as 2L. However
for consistency with the other \fIVERIFYHOST\fP options we suggest use 2 and
not 1.
When the \fIverify\fP value is set to 0L, the connection succeeds regardless of
the names used in the certificate. Use that ability with caution!
See also \fICURLOPT_DOH_SSL_VERIFYPEER(3)\fP to verify the digital signature
of the DoH server certificate.
.SH DEFAULT
2
.SH PROTOCOLS
DoH
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
curl_easy_setopt(curl, CURLOPT_DOH_URL, "https://cloudflare-dns.com/dns-query");
/* Disable host name verification of the DoH server */
curl_easy_setopt(curl, CURLOPT_DOH_SSL_VERIFYHOST, 0L);
curl_easy_perform(curl);
}
.fi
.SH AVAILABILITY
Added in 7.76.0
If built TLS enabled.
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR CURLOPT_DOH_SSL_VERIFYPEER (3),
.BR CURLOPT_PROXY_SSL_VERIFYHOST (3),
.BR CURLOPT_PROXY_SSL_VERIFYPEER (3),
.BR CURLOPT_SSL_VERIFYHOST (3),
.BR CURLOPT_SSL_VERIFYPEER (3)
man/man3/curl_easy_cleanup.3 0000644 00000005601 14751172371 0011750 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH curl_easy_cleanup 3 "September 26, 2023" "libcurl 8.4.0" "libcurl"
.SH NAME
curl_easy_cleanup - End a libcurl easy handle
.SH SYNOPSIS
.nf
#include <curl/curl.h>
void curl_easy_cleanup(CURL *handle);
.fi
.SH DESCRIPTION
This function is the opposite of \fIcurl_easy_init(3)\fP. It closes down and
frees all resources previously associated with this easy handle.
This call closes all connections this handle has used and possibly has kept
open until now unless the easy handle was attached to a multi handle while
doing the transfers. Do not call this function if you intend to transfer more
files, reusing handles is a key to good performance with libcurl.
Occasionally you may get your progress callback or header callback called from
within \fIcurl_easy_cleanup(3)\fP (if previously set for the handle using
\fIcurl_easy_setopt(3)\fP). Like if libcurl decides to shut down the
connection and the protocol is of a kind that requires a command/response
sequence before disconnect. Examples of such protocols are FTP, POP3 and IMAP.
Any use of the easy \fBhandle\fP after this function has been called and have
returned, is illegal.
To close an easy handle that has been used with the multi interface, make sure
to first call \fIcurl_multi_remove_handle(3)\fP to remove it from the multi
handle before it is closed.
Passing in a NULL pointer in \fIhandle\fP makes this function return
immediately with no action.
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
CURLcode res;
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
res = curl_easy_perform(curl);
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Added in 7.1
.SH RETURN VALUE
None
.SH "SEE ALSO"
.BR curl_easy_duphandle (3),
.BR curl_easy_init (3),
.BR curl_easy_reset (3),
.BR curl_multi_cleanup (3),
.BR curl_multi_remove_handle (3)
man/man3/CURLOPT_EGDSOCKET.3 0000644 00000004426 14751172371 0010777 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_EGDSOCKET 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_EGDSOCKET \- EGD socket path
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_EGDSOCKET, char *path);
.fi
.SH DESCRIPTION
Deprecated option. It serves no purpose anymore.
Pass a char * to the null-terminated path name to the Entropy Gathering Daemon
socket. It is used to seed the random engine for TLS.
The application does not have to keep the string around after setting this
option.
.SH DEFAULT
NULL
.SH PROTOCOLS
All TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc.
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/");
curl_easy_setopt(curl, CURLOPT_EGDSOCKET, "/var/egd.socket");
ret = curl_easy_perform(curl);
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
If built with TLS enabled. Only the OpenSSL backend uses this, and only with
OpenSSL versions before 1.1.0.
This option was deprecated in 7.84.0.
.SH RETURN VALUE
Returns CURLE_OK if TLS is supported, CURLE_UNKNOWN_OPTION if not, or
CURLE_OUT_OF_MEMORY if there was insufficient heap space.
.SH "SEE ALSO"
.BR CURLOPT_RANDOM_FILE (3)
man/man3/CURLOPT_HTTP_TRANSFER_DECODING.3 0000644 00000004272 14751172371 0013005 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_HTTP_TRANSFER_DECODING 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_HTTP_TRANSFER_DECODING \- HTTP transfer decoding control
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_HTTP_TRANSFER_DECODING,
long enabled);
.SH DESCRIPTION
Pass a long to tell libcurl how to act on transfer decoding. If set to zero,
transfer decoding is disabled, if set to 1 it is enabled (default). libcurl
does chunked transfer decoding by default unless this option is set to zero.
.SH DEFAULT
1
.SH PROTOCOLS
HTTP
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
CURLcode ret;
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/");
curl_easy_setopt(curl, CURLOPT_HTTP_TRANSFER_DECODING, 0L);
ret = curl_easy_perform(curl);
}
.fi
.SH AVAILABILITY
Added in 7.16.2 Does not work with the hyper backend (it always has transfer
decoding enabled).
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR CURLOPT_HTTP_CONTENT_DECODING (3),
.BR CURLOPT_ACCEPT_ENCODING (3)
man/man3/curl_mime_addpart.3 0000644 00000004567 14751172371 0011740 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.TH curl_mime_addpart 3 "September 26, 2023" "libcurl 8.4.0" "libcurl"
.SH NAME
curl_mime_addpart - append a new empty part to a mime structure
.SH SYNOPSIS
.nf
#include <curl/curl.h>
curl_mimepart *curl_mime_addpart(curl_mime *mime);
.fi
.SH DESCRIPTION
\fIcurl_mime_addpart(3)\fP creates and appends a new empty part to the given
mime structure and returns a handle to it. The returned part handle can
subsequently be populated using functions from the mime API.
\fImime\fP is the handle of the mime structure in which the new part must be
appended.
.SH EXAMPLE
.nf
curl_mime *mime;
curl_mimepart *part;
/* create a mime handle */
mime = curl_mime_init(easy);
/* add a part */
part = curl_mime_addpart(mime);
/* continue and set name + data to the part */
curl_mime_data(part, "This is the field data", CURL_ZERO_TERMINATED);
curl_mime_name(part, "data");
.fi
.SH AVAILABILITY
As long as at least one of HTTP, SMTP or IMAP is enabled. Added in 7.56.0.
.SH RETURN VALUE
A mime part structure handle, or NULL upon failure.
.SH "SEE ALSO"
.BR curl_mime_data (3),
.BR curl_mime_data_cb (3),
.BR curl_mime_encoder (3),
.BR curl_mime_filedata (3),
.BR curl_mime_filename (3),
.BR curl_mime_headers (3),
.BR curl_mime_init (3),
.BR curl_mime_name (3),
.BR curl_mime_subparts (3),
.BR curl_mime_type (3)
man/man3/CURLOPT_CONV_FROM_NETWORK_FUNCTION.3 0000644 00000007547 14751172371 0013604 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_CONV_FROM_NETWORK_FUNCTION 3 "September 27, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_CONV_FROM_NETWORK_FUNCTION \- convert data from network to host encoding
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode conv_callback(char *ptr, size_t length);
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_CONV_FROM_NETWORK_FUNCTION,
conv_callback);
.SH DESCRIPTION
Pass a pointer to your callback function, which should match the prototype
shown above.
Applies to non-ASCII platforms. \fIcurl_version_info(3)\fP returns the
\fBCURL_VERSION_CONV\fP feature bit set if this option is provided.
The data to be converted is in a buffer pointed to by the \fIptr\fP parameter.
The amount of data to convert is indicated by the \fIlength\fP parameter. The
converted data overlays the input data in the buffer pointed to by the ptr
parameter. \fICURLE_OK\fP must be returned upon successful conversion. A
CURLcode return value defined by curl.h, such as \fICURLE_CONV_FAILED\fP,
should be returned if an error was encountered.
\fICURLOPT_CONV_FROM_NETWORK_FUNCTION(3)\fP converts to host encoding from the
network encoding. It is used when commands or ASCII data are received over
the network.
If you set a callback pointer to NULL, or do not set it at all, the built-in
libcurl iconv functions are used. If HAVE_ICONV was not defined when libcurl
was built, and no callback has been established, the conversion returns the
\fBCURLE_CONV_REQD\fP error code.
If \fBHAVE_ICONV\fP is defined, \fBCURL_ICONV_CODESET_OF_HOST\fP must also be
defined. For example:
\&#define CURL_ICONV_CODESET_OF_HOST "IBM-1047"
The iconv code in libcurl defaults the network and UTF8 codeset names as
follows:
\&#define CURL_ICONV_CODESET_OF_NETWORK "ISO8859-1"
\&#define CURL_ICONV_CODESET_FOR_UTF8 "UTF-8"
You need to override these definitions if they are different on your system.
.SH DEFAULT
NULL
.SH PROTOCOLS
FTP, SMTP, IMAP, POP3
.SH EXAMPLE
.nf
static CURLcode my_conv_from_ascii_to_ebcdic(char *buffer, size_t length)
{
char *tempptrin, *tempptrout;
size_t bytes = length;
int rc;
tempptrin = tempptrout = buffer;
rc = platform_a2e(&tempptrin, &bytes, &tempptrout, &bytes);
if(rc == PLATFORM_CONV_OK) {
return CURLE_OK;
}
else {
return CURLE_CONV_FAILED;
}
}
/* use platform-specific functions for codeset conversions */
curl_easy_setopt(curl, CURLOPT_CONV_FROM_NETWORK_FUNCTION,
my_conv_from_ascii_to_ebcdic);
.fi
.SH AVAILABILITY
Not available and deprecated since 7.82.0.
Available only if \fBCURL_DOES_CONVERSIONS\fP was defined when libcurl was
built.
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR CURLOPT_CONV_FROM_UTF8_FUNCTION (3),
.BR CURLOPT_CONV_TO_NETWORK_FUNCTION (3)
man/man3/CURLOPT_WS_OPTIONS.3 0000644 00000004610 14751172371 0011226 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_WS_OPTIONS 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_WS_OPTIONS \- WebSocket behavior options
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_WS_OPTIONS, long bitmask);
.fi
.SH DESCRIPTION
Pass a long with a bitmask to tell libcurl about specific WebSocket
behaviors.
To detach a WebSocket connection and use the \fIcurl_ws_send(3)\fP and
\fIcurl_ws_recv(3)\fP functions after the HTTP upgrade procedure, set the
\fICURLOPT_CONNECT_ONLY(3)\fP option to 2L.
Available bits in the bitmask
.IP "CURLWS_RAW_MODE (1)"
Deliver "raw" WebSocket traffic to the \fICURLOPT_WRITEFUNCTION(3)\fP
callback.
In raw mode, libcurl does not handle pings or any other frame for the
application.
.SH DEFAULT
0
.SH PROTOCOLS
WebSocket
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "ws://example.com/");
/* tell curl we deal with all the WebSocket magic ourselves */
curl_easy_setopt(curl, CURLOPT_WS_OPTIONS, (long)CURLWS_RAW_MODE);
ret = curl_easy_perform(curl);
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Added in 7.86.0
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR curl_ws_recv (3),
.BR curl_ws_send (3),
.BR CURLOPT_CONNECT_ONLY (3)
man/man3/libcurl-symbols.3 0000644 00000154726 14751172371 0011412 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.TH libcurl-symbols 3 "Oct 11, 2023" "libcurl" "libcurl"
.SH NAME
libcurl-symbols \- libcurl symbol version information
.SH "libcurl symbols"
This man page details version information for public symbols provided in the
libcurl header files. This lists the first version in which the symbol was
introduced and for some symbols two additional information pieces:
The first version in which the symbol is marked "deprecated" - meaning that
since that version no new code should be written to use the symbol as it is
marked for getting removed in a future.
The last version that featured the specific symbol. Using the symbol in source
code will make it no longer compile error-free after that specified version.
This man page is automatically generated from the symbols-in-versions file.
.IP CURL_AT_LEAST_VERSION
Introduced in 7.43.0
.IP CURL_BLOB_COPY
Introduced in 7.71.0
.IP CURL_BLOB_NOCOPY
Introduced in 7.71.0
.IP CURL_CHUNK_BGN_FUNC_FAIL
Introduced in 7.21.0
.IP CURL_CHUNK_BGN_FUNC_OK
Introduced in 7.21.0
.IP CURL_CHUNK_BGN_FUNC_SKIP
Introduced in 7.21.0
.IP CURL_CHUNK_END_FUNC_FAIL
Introduced in 7.21.0
.IP CURL_CHUNK_END_FUNC_OK
Introduced in 7.21.0
.IP CURL_CSELECT_ERR
Introduced in 7.16.3
.IP CURL_CSELECT_IN
Introduced in 7.16.3
.IP CURL_CSELECT_OUT
Introduced in 7.16.3
.IP CURL_DEPRECATED
Introduced in 7.87.0
.IP CURL_DID_MEMORY_FUNC_TYPEDEFS
Introduced in 7.49.0
.IP CURL_EASY_NONE
Introduced in 7.14.0
.IP CURL_EASY_TIMEOUT
Introduced in 7.14.0
.IP CURL_ERROR_SIZE
Introduced in 7.1
.IP CURL_FNMATCHFUNC_FAIL
Introduced in 7.21.0
.IP CURL_FNMATCHFUNC_MATCH
Introduced in 7.21.0
.IP CURL_FNMATCHFUNC_NOMATCH
Introduced in 7.21.0
.IP CURL_FORMADD_DISABLED
Introduced in 7.12.1
Deprecated since 7.56.0
.IP CURL_FORMADD_ILLEGAL_ARRAY
Introduced in 7.9.8
Deprecated since 7.56.0
.IP CURL_FORMADD_INCOMPLETE
Introduced in 7.9.8
Deprecated since 7.56.0
.IP CURL_FORMADD_MEMORY
Introduced in 7.9.8
Deprecated since 7.56.0
.IP CURL_FORMADD_NULL
Introduced in 7.9.8
Deprecated since 7.56.0
.IP CURL_FORMADD_OK
Introduced in 7.9.8
Deprecated since 7.56.0
.IP CURL_FORMADD_OPTION_TWICE
Introduced in 7.9.8
Deprecated since 7.56.0
.IP CURL_FORMADD_UNKNOWN_OPTION
Introduced in 7.9.8
Deprecated since 7.56.0
.IP CURL_GLOBAL_ACK_EINTR
Introduced in 7.30.0
.IP CURL_GLOBAL_ALL
Introduced in 7.8
.IP CURL_GLOBAL_DEFAULT
Introduced in 7.8
.IP CURL_GLOBAL_NOTHING
Introduced in 7.8
.IP CURL_GLOBAL_SSL
Introduced in 7.8
.IP CURL_GLOBAL_WIN32
Introduced in 7.8.1
.IP CURL_HET_DEFAULT
Introduced in 7.59.0
.IP CURL_HTTP_VERSION_1_0
Introduced in 7.9.1
.IP CURL_HTTP_VERSION_1_1
Introduced in 7.9.1
.IP CURL_HTTP_VERSION_2
Introduced in 7.43.0
.IP CURL_HTTP_VERSION_2_0
Introduced in 7.33.0
.IP CURL_HTTP_VERSION_2_PRIOR_KNOWLEDGE
Introduced in 7.49.0
.IP CURL_HTTP_VERSION_2TLS
Introduced in 7.47.0
.IP CURL_HTTP_VERSION_3
Introduced in 7.66.0
.IP CURL_HTTP_VERSION_3ONLY
Introduced in 7.88.0
.IP CURL_HTTP_VERSION_NONE
Introduced in 7.9.1
.IP CURL_HTTPPOST_BUFFER
Introduced in 7.46.0
.IP CURL_HTTPPOST_CALLBACK
Introduced in 7.46.0
.IP CURL_HTTPPOST_FILENAME
Introduced in 7.46.0
.IP CURL_HTTPPOST_LARGE
Introduced in 7.46.0
.IP CURL_HTTPPOST_PTRBUFFER
Introduced in 7.46.0
.IP CURL_HTTPPOST_PTRCONTENTS
Introduced in 7.46.0
.IP CURL_HTTPPOST_PTRNAME
Introduced in 7.46.0
.IP CURL_HTTPPOST_READFILE
Introduced in 7.46.0
.IP CURL_IGNORE_DEPRECATION
Introduced in 7.87.0
.IP CURL_IPRESOLVE_V4
Introduced in 7.10.8
.IP CURL_IPRESOLVE_V6
Introduced in 7.10.8
.IP CURL_IPRESOLVE_WHATEVER
Introduced in 7.10.8
.IP CURL_ISOCPP
Introduced in 7.10.2
.IP CURL_LOCK_ACCESS_NONE
Introduced in 7.10.3
.IP CURL_LOCK_ACCESS_SHARED
Introduced in 7.10.3
.IP CURL_LOCK_ACCESS_SINGLE
Introduced in 7.10.3
.IP CURL_LOCK_DATA_CONNECT
Introduced in 7.10.3
.IP CURL_LOCK_DATA_COOKIE
Introduced in 7.10.3
.IP CURL_LOCK_DATA_DNS
Introduced in 7.10.3
.IP CURL_LOCK_DATA_HSTS
Introduced in 7.88.0
.IP CURL_LOCK_DATA_NONE
Introduced in 7.10.3
.IP CURL_LOCK_DATA_PSL
Introduced in 7.61.0
.IP CURL_LOCK_DATA_SHARE
Introduced in 7.10.4
.IP CURL_LOCK_DATA_SSL_SESSION
Introduced in 7.10.3
.IP CURL_LOCK_TYPE_CONNECT
Introduced in 7.10
.IP CURL_LOCK_TYPE_COOKIE
Introduced in 7.10
.IP CURL_LOCK_TYPE_DNS
Introduced in 7.10
.IP CURL_LOCK_TYPE_NONE
Introduced in 7.10
.IP CURL_LOCK_TYPE_SSL_SESSION
Introduced in 7.10
.IP CURL_MAX_HTTP_HEADER
Introduced in 7.19.7
.IP CURL_MAX_READ_SIZE
Introduced in 7.53.0
.IP CURL_MAX_WRITE_SIZE
Introduced in 7.9.7
.IP CURL_NETRC_IGNORED
Introduced in 7.9.8
.IP CURL_NETRC_OPTIONAL
Introduced in 7.9.8
.IP CURL_NETRC_REQUIRED
Introduced in 7.9.8
.IP CURL_POLL_IN
Introduced in 7.14.0
.IP CURL_POLL_INOUT
Introduced in 7.14.0
.IP CURL_POLL_NONE
Introduced in 7.14.0
.IP CURL_POLL_OUT
Introduced in 7.14.0
.IP CURL_POLL_REMOVE
Introduced in 7.14.0
.IP CURL_PREREQFUNC_ABORT
Introduced in 7.79.0
.IP CURL_PREREQFUNC_OK
Introduced in 7.79.0
.IP CURL_PROGRESS_BAR
Introduced in 7.1.1
.IP CURL_PROGRESS_STATS
Introduced in 7.1.1
.IP CURL_PROGRESSFUNC_CONTINUE
Introduced in 7.68.0
.IP CURL_PULL_SYS_POLL_H
Introduced in 7.56.0
.IP CURL_PUSH_DENY
Introduced in 7.44.0
.IP CURL_PUSH_ERROROUT
Introduced in 7.72.0
.IP CURL_PUSH_OK
Introduced in 7.44.0
.IP CURL_READFUNC_ABORT
Introduced in 7.12.1
.IP CURL_READFUNC_PAUSE
Introduced in 7.18.0
.IP CURL_REDIR_GET_ALL
Introduced in 7.19.1
.IP CURL_REDIR_POST_301
Introduced in 7.19.1
.IP CURL_REDIR_POST_302
Introduced in 7.19.1
.IP CURL_REDIR_POST_303
Introduced in 7.25.1
.IP CURL_REDIR_POST_ALL
Introduced in 7.19.1
.IP CURL_RTSPREQ_ANNOUNCE
Introduced in 7.20.0
.IP CURL_RTSPREQ_DESCRIBE
Introduced in 7.20.0
.IP CURL_RTSPREQ_GET_PARAMETER
Introduced in 7.20.0
.IP CURL_RTSPREQ_NONE
Introduced in 7.20.0
.IP CURL_RTSPREQ_OPTIONS
Introduced in 7.20.0
.IP CURL_RTSPREQ_PAUSE
Introduced in 7.20.0
.IP CURL_RTSPREQ_PLAY
Introduced in 7.20.0
.IP CURL_RTSPREQ_RECEIVE
Introduced in 7.20.0
.IP CURL_RTSPREQ_RECORD
Introduced in 7.20.0
.IP CURL_RTSPREQ_SET_PARAMETER
Introduced in 7.20.0
.IP CURL_RTSPREQ_SETUP
Introduced in 7.20.0
.IP CURL_RTSPREQ_TEARDOWN
Introduced in 7.20.0
.IP CURL_SEEKFUNC_CANTSEEK
Introduced in 7.19.5
.IP CURL_SEEKFUNC_FAIL
Introduced in 7.19.5
.IP CURL_SEEKFUNC_OK
Introduced in 7.19.5
.IP CURL_SOCKET_BAD
Introduced in 7.14.0
.IP CURL_SOCKET_TIMEOUT
Introduced in 7.14.0
.IP CURL_SOCKOPT_ALREADY_CONNECTED
Introduced in 7.21.5
.IP CURL_SOCKOPT_ERROR
Introduced in 7.21.5
.IP CURL_SOCKOPT_OK
Introduced in 7.21.5
.IP CURL_SSLVERSION_DEFAULT
Introduced in 7.9.2
.IP CURL_SSLVERSION_MAX_DEFAULT
Introduced in 7.54.0
.IP CURL_SSLVERSION_MAX_NONE
Introduced in 7.54.0
.IP CURL_SSLVERSION_MAX_TLSv1_0
Introduced in 7.54.0
.IP CURL_SSLVERSION_MAX_TLSv1_1
Introduced in 7.54.0
.IP CURL_SSLVERSION_MAX_TLSv1_2
Introduced in 7.54.0
.IP CURL_SSLVERSION_MAX_TLSv1_3
Introduced in 7.54.0
.IP CURL_SSLVERSION_SSLv2
Introduced in 7.9.2
.IP CURL_SSLVERSION_SSLv3
Introduced in 7.9.2
.IP CURL_SSLVERSION_TLSv1
Introduced in 7.9.2
.IP CURL_SSLVERSION_TLSv1_0
Introduced in 7.34.0
.IP CURL_SSLVERSION_TLSv1_1
Introduced in 7.34.0
.IP CURL_SSLVERSION_TLSv1_2
Introduced in 7.34.0
.IP CURL_SSLVERSION_TLSv1_3
Introduced in 7.52.0
.IP CURL_STRICTER
Introduced in 7.50.2
.IP CURL_TIMECOND_IFMODSINCE
Introduced in 7.9.7
.IP CURL_TIMECOND_IFUNMODSINCE
Introduced in 7.9.7
.IP CURL_TIMECOND_LASTMOD
Introduced in 7.9.7
.IP CURL_TIMECOND_NONE
Introduced in 7.9.7
.IP CURL_TLSAUTH_NONE
Introduced in 7.21.4
.IP CURL_TLSAUTH_SRP
Introduced in 7.21.4
.IP CURL_TRAILERFUNC_ABORT
Introduced in 7.64.0
.IP CURL_TRAILERFUNC_OK
Introduced in 7.64.0
.IP CURL_UPKEEP_INTERVAL_DEFAULT
Introduced in 7.62.0
.IP CURL_VERSION_ALTSVC
Introduced in 7.64.1
.IP CURL_VERSION_ASYNCHDNS
Introduced in 7.10.7
.IP CURL_VERSION_BITS
Introduced in 7.43.0
.IP CURL_VERSION_BROTLI
Introduced in 7.57.0
.IP CURL_VERSION_CONV
Introduced in 7.15.4
.IP CURL_VERSION_CURLDEBUG
Introduced in 7.19.6
.IP CURL_VERSION_DEBUG
Introduced in 7.10.6
.IP CURL_VERSION_GSASL
Introduced in 7.76.0
.IP CURL_VERSION_GSSAPI
Introduced in 7.38.0
.IP CURL_VERSION_GSSNEGOTIATE
Introduced in 7.10.6
Deprecated since 7.38.0
.IP CURL_VERSION_HSTS
Introduced in 7.74.0
.IP CURL_VERSION_HTTP2
Introduced in 7.33.0
.IP CURL_VERSION_HTTP3
Introduced in 7.66.0
.IP CURL_VERSION_HTTPS_PROXY
Introduced in 7.52.0
.IP CURL_VERSION_IDN
Introduced in 7.12.0
.IP CURL_VERSION_IPV6
Introduced in 7.10
.IP CURL_VERSION_KERBEROS4
Introduced in 7.10
Deprecated since 7.33.0
.IP CURL_VERSION_KERBEROS5
Introduced in 7.40.0
.IP CURL_VERSION_LARGEFILE
Introduced in 7.11.1
.IP CURL_VERSION_LIBZ
Introduced in 7.10
.IP CURL_VERSION_MULTI_SSL
Introduced in 7.56.0
.IP CURL_VERSION_NTLM
Introduced in 7.10.6
.IP CURL_VERSION_NTLM_WB
Introduced in 7.22.0
.IP CURL_VERSION_PSL
Introduced in 7.47.0
.IP CURL_VERSION_SPNEGO
Introduced in 7.10.8
.IP CURL_VERSION_SSL
Introduced in 7.10
.IP CURL_VERSION_SSPI
Introduced in 7.13.2
.IP CURL_VERSION_THREADSAFE
Introduced in 7.84.0
.IP CURL_VERSION_TLSAUTH_SRP
Introduced in 7.21.4
.IP CURL_VERSION_UNICODE
Introduced in 7.72.0
.IP CURL_VERSION_UNIX_SOCKETS
Introduced in 7.40.0
.IP CURL_VERSION_ZSTD
Introduced in 7.72.0
.IP CURL_WAIT_POLLIN
Introduced in 7.28.0
.IP CURL_WAIT_POLLOUT
Introduced in 7.28.0
.IP CURL_WAIT_POLLPRI
Introduced in 7.28.0
.IP CURL_WIN32
Introduced in 7.69.0
.IP CURL_WRITEFUNC_ERROR
Introduced in 7.87.0
.IP CURL_WRITEFUNC_PAUSE
Introduced in 7.18.0
.IP CURL_ZERO_TERMINATED
Introduced in 7.56.0
.IP CURLALTSVC_H1
Introduced in 7.64.1
.IP CURLALTSVC_H2
Introduced in 7.64.1
.IP CURLALTSVC_H3
Introduced in 7.64.1
.IP CURLALTSVC_READONLYFILE
Introduced in 7.64.1
.IP CURLAUTH_ANY
Introduced in 7.10.6
.IP CURLAUTH_ANYSAFE
Introduced in 7.10.6
.IP CURLAUTH_AWS_SIGV4
Introduced in 7.75.0
.IP CURLAUTH_BASIC
Introduced in 7.10.6
.IP CURLAUTH_BEARER
Introduced in 7.61.0
.IP CURLAUTH_DIGEST
Introduced in 7.10.6
.IP CURLAUTH_DIGEST_IE
Introduced in 7.19.3
.IP CURLAUTH_GSSAPI
Introduced in 7.55.0
.IP CURLAUTH_GSSNEGOTIATE
Introduced in 7.10.6
Deprecated since 7.38.0
.IP CURLAUTH_NEGOTIATE
Introduced in 7.38.0
.IP CURLAUTH_NONE
Introduced in 7.10.6
.IP CURLAUTH_NTLM
Introduced in 7.10.6
.IP CURLAUTH_NTLM_WB
Introduced in 7.22.0
.IP CURLAUTH_ONLY
Introduced in 7.21.3
.IP CURLCLOSEPOLICY_CALLBACK
Introduced in 7.7
.IP CURLCLOSEPOLICY_LEAST_RECENTLY_USED
Introduced in 7.7
.IP CURLCLOSEPOLICY_LEAST_TRAFFIC
Introduced in 7.7
.IP CURLCLOSEPOLICY_NONE
Introduced in 7.7
.IP CURLCLOSEPOLICY_OLDEST
Introduced in 7.7
.IP CURLCLOSEPOLICY_SLOWEST
Introduced in 7.7
.IP CURLE_ABORTED_BY_CALLBACK
Introduced in 7.1
.IP CURLE_AGAIN
Introduced in 7.18.2
.IP CURLE_ALREADY_COMPLETE
Introduced in 7.7.2
Deprecated since 7.8
.IP CURLE_AUTH_ERROR
Introduced in 7.66.0
.IP CURLE_BAD_CALLING_ORDER
Introduced in 7.1
Deprecated since 7.17.0
.IP CURLE_BAD_CONTENT_ENCODING
Introduced in 7.10
.IP CURLE_BAD_DOWNLOAD_RESUME
Introduced in 7.10
.IP CURLE_BAD_FUNCTION_ARGUMENT
Introduced in 7.1
.IP CURLE_BAD_PASSWORD_ENTERED
Introduced in 7.4.2
Deprecated since 7.17.0
.IP CURLE_CHUNK_FAILED
Introduced in 7.21.0
.IP CURLE_CONV_FAILED
Introduced in 7.15.4
Deprecated since 7.82.0
.IP CURLE_CONV_REQD
Introduced in 7.15.4
Deprecated since 7.82.0
.IP CURLE_COULDNT_CONNECT
Introduced in 7.1
.IP CURLE_COULDNT_RESOLVE_HOST
Introduced in 7.1
.IP CURLE_COULDNT_RESOLVE_PROXY
Introduced in 7.1
.IP CURLE_FAILED_INIT
Introduced in 7.1
.IP CURLE_FILE_COULDNT_READ_FILE
Introduced in 7.1
.IP CURLE_FILESIZE_EXCEEDED
Introduced in 7.10.8
.IP CURLE_FTP_ACCEPT_FAILED
Introduced in 7.24.0
.IP CURLE_FTP_ACCEPT_TIMEOUT
Introduced in 7.24.0
.IP CURLE_FTP_ACCESS_DENIED
Introduced in 7.1
Deprecated since 7.17.0
.IP CURLE_FTP_BAD_DOWNLOAD_RESUME
Introduced in 7.1
Deprecated since 7.1
.IP CURLE_FTP_BAD_FILE_LIST
Introduced in 7.21.0
.IP CURLE_FTP_CANT_GET_HOST
Introduced in 7.1
.IP CURLE_FTP_CANT_RECONNECT
Introduced in 7.1
Deprecated since 7.17.0
.IP CURLE_FTP_COULDNT_GET_SIZE
Introduced in 7.1
Deprecated since 7.17.0
.IP CURLE_FTP_COULDNT_RETR_FILE
Introduced in 7.1
.IP CURLE_FTP_COULDNT_SET_ASCII
Introduced in 7.1
Deprecated since 7.17.0
.IP CURLE_FTP_COULDNT_SET_BINARY
Introduced in 7.1
Deprecated since 7.17.0
.IP CURLE_FTP_COULDNT_SET_TYPE
Introduced in 7.17.0
.IP CURLE_FTP_COULDNT_STOR_FILE
Introduced in 7.1
Deprecated since 7.16.3
.IP CURLE_FTP_COULDNT_USE_REST
Introduced in 7.1
.IP CURLE_FTP_PARTIAL_FILE
Introduced in 7.1
Deprecated since 7.1
.IP CURLE_FTP_PORT_FAILED
Introduced in 7.1
.IP CURLE_FTP_PRET_FAILED
Introduced in 7.20.0
.IP CURLE_FTP_QUOTE_ERROR
Introduced in 7.1
Deprecated since 7.17.0
.IP CURLE_FTP_SSL_FAILED
Introduced in 7.11.0
Deprecated since 7.17.0
.IP CURLE_FTP_USER_PASSWORD_INCORRECT
Introduced in 7.1
Deprecated since 7.17.0
.IP CURLE_FTP_WEIRD_227_FORMAT
Introduced in 7.1
.IP CURLE_FTP_WEIRD_PASS_REPLY
Introduced in 7.1
.IP CURLE_FTP_WEIRD_PASV_REPLY
Introduced in 7.1
.IP CURLE_FTP_WEIRD_SERVER_REPLY
Introduced in 7.1
Deprecated since 7.51.0
.IP CURLE_FTP_WEIRD_USER_REPLY
Introduced in 7.1
Deprecated since 7.17.0
.IP CURLE_FTP_WRITE_ERROR
Introduced in 7.1
Deprecated since 7.17.0
.IP CURLE_FUNCTION_NOT_FOUND
Introduced in 7.1
.IP CURLE_GOT_NOTHING
Introduced in 7.9.1
.IP CURLE_HTTP2
Introduced in 7.38.0
.IP CURLE_HTTP2_STREAM
Introduced in 7.49.0
.IP CURLE_HTTP3
Introduced in 7.68.0
.IP CURLE_HTTP_NOT_FOUND
Introduced in 7.1
Deprecated since 7.10.3
.IP CURLE_HTTP_PORT_FAILED
Introduced in 7.3
Deprecated since 7.12.0
.IP CURLE_HTTP_POST_ERROR
Introduced in 7.1
.IP CURLE_HTTP_RANGE_ERROR
Introduced in 7.1
Deprecated since 7.17.0
.IP CURLE_HTTP_RETURNED_ERROR
Introduced in 7.10.3
.IP CURLE_INTERFACE_FAILED
Introduced in 7.12.0
.IP CURLE_LDAP_CANNOT_BIND
Introduced in 7.1
.IP CURLE_LDAP_INVALID_URL
Introduced in 7.10.8
Deprecated since 7.82.0
.IP CURLE_LDAP_SEARCH_FAILED
Introduced in 7.1
.IP CURLE_LIBRARY_NOT_FOUND
Introduced in 7.1
Deprecated since 7.17.0
.IP CURLE_LOGIN_DENIED
Introduced in 7.13.1
.IP CURLE_MALFORMAT_USER
Introduced in 7.1
Deprecated since 7.17.0
.IP CURLE_NO_CONNECTION_AVAILABLE
Introduced in 7.30.0
.IP CURLE_NOT_BUILT_IN
Introduced in 7.21.5
.IP CURLE_OK
Introduced in 7.1
.IP CURLE_OPERATION_TIMEDOUT
Introduced in 7.10.2
.IP CURLE_OPERATION_TIMEOUTED
Introduced in 7.1
Deprecated since 7.17.0
.IP CURLE_OUT_OF_MEMORY
Introduced in 7.1
.IP CURLE_PARTIAL_FILE
Introduced in 7.1
.IP CURLE_PEER_FAILED_VERIFICATION
Introduced in 7.17.1
.IP CURLE_PROXY
Introduced in 7.73.0
.IP CURLE_QUIC_CONNECT_ERROR
Introduced in 7.69.0
.IP CURLE_QUOTE_ERROR
Introduced in 7.17.0
.IP CURLE_RANGE_ERROR
Introduced in 7.17.0
.IP CURLE_READ_ERROR
Introduced in 7.1
.IP CURLE_RECURSIVE_API_CALL
Introduced in 7.59.0
.IP CURLE_RECV_ERROR
Introduced in 7.10
.IP CURLE_REMOTE_ACCESS_DENIED
Introduced in 7.17.0
.IP CURLE_REMOTE_DISK_FULL
Introduced in 7.17.0
.IP CURLE_REMOTE_FILE_EXISTS
Introduced in 7.17.0
.IP CURLE_REMOTE_FILE_NOT_FOUND
Introduced in 7.16.1
.IP CURLE_RTSP_CSEQ_ERROR
Introduced in 7.20.0
.IP CURLE_RTSP_SESSION_ERROR
Introduced in 7.20.0
.IP CURLE_SEND_ERROR
Introduced in 7.10
.IP CURLE_SEND_FAIL_REWIND
Introduced in 7.12.3
.IP CURLE_SETOPT_OPTION_SYNTAX
Introduced in 7.78.0
.IP CURLE_SHARE_IN_USE
Introduced in 7.9.6
Deprecated since 7.17.0
.IP CURLE_SSH
Introduced in 7.16.1
.IP CURLE_SSL_CACERT
Introduced in 7.10
Deprecated since 7.62.0
.IP CURLE_SSL_CACERT_BADFILE
Introduced in 7.16.0
.IP CURLE_SSL_CERTPROBLEM
Introduced in 7.10
.IP CURLE_SSL_CIPHER
Introduced in 7.10
.IP CURLE_SSL_CLIENTCERT
Introduced in 7.77.0
.IP CURLE_SSL_CONNECT_ERROR
Introduced in 7.1
.IP CURLE_SSL_CRL_BADFILE
Introduced in 7.19.0
.IP CURLE_SSL_ENGINE_INITFAILED
Introduced in 7.12.3
.IP CURLE_SSL_ENGINE_NOTFOUND
Introduced in 7.9.3
.IP CURLE_SSL_ENGINE_SETFAILED
Introduced in 7.9.3
.IP CURLE_SSL_INVALIDCERTSTATUS
Introduced in 7.41.0
.IP CURLE_SSL_ISSUER_ERROR
Introduced in 7.19.0
.IP CURLE_SSL_PEER_CERTIFICATE
Introduced in 7.8
Deprecated since 7.17.1
.IP CURLE_SSL_PINNEDPUBKEYNOTMATCH
Introduced in 7.39.0
.IP CURLE_SSL_SHUTDOWN_FAILED
Introduced in 7.16.1
.IP CURLE_TELNET_OPTION_SYNTAX
Introduced in 7.7
.IP CURLE_TFTP_DISKFULL
Introduced in 7.15.0
Deprecated since 7.17.0
.IP CURLE_TFTP_EXISTS
Introduced in 7.15.0
Deprecated since 7.17.0
.IP CURLE_TFTP_ILLEGAL
Introduced in 7.15.0
.IP CURLE_TFTP_NOSUCHUSER
Introduced in 7.15.0
.IP CURLE_TFTP_NOTFOUND
Introduced in 7.15.0
.IP CURLE_TFTP_PERM
Introduced in 7.15.0
.IP CURLE_TFTP_UNKNOWNID
Introduced in 7.15.0
.IP CURLE_TOO_MANY_REDIRECTS
Introduced in 7.5
.IP CURLE_UNKNOWN_OPTION
Introduced in 7.21.5
.IP CURLE_UNKNOWN_TELNET_OPTION
Introduced in 7.7
Deprecated since 7.21.5
.IP CURLE_UNRECOVERABLE_POLL
Introduced in 7.84.0
.IP CURLE_UNSUPPORTED_PROTOCOL
Introduced in 7.1
.IP CURLE_UPLOAD_FAILED
Introduced in 7.16.3
.IP CURLE_URL_MALFORMAT
Introduced in 7.1
.IP CURLE_URL_MALFORMAT_USER
Introduced in 7.1
Deprecated since 7.17.0
.IP CURLE_USE_SSL_FAILED
Introduced in 7.17.0
.IP CURLE_WEIRD_SERVER_REPLY
Introduced in 7.51.0
.IP CURLE_WRITE_ERROR
Introduced in 7.1
.IP CURLFILETYPE_DEVICE_BLOCK
Introduced in 7.21.0
.IP CURLFILETYPE_DEVICE_CHAR
Introduced in 7.21.0
.IP CURLFILETYPE_DIRECTORY
Introduced in 7.21.0
.IP CURLFILETYPE_DOOR
Introduced in 7.21.0
.IP CURLFILETYPE_FILE
Introduced in 7.21.0
.IP CURLFILETYPE_NAMEDPIPE
Introduced in 7.21.0
.IP CURLFILETYPE_SOCKET
Introduced in 7.21.0
.IP CURLFILETYPE_SYMLINK
Introduced in 7.21.0
.IP CURLFILETYPE_UNKNOWN
Introduced in 7.21.0
.IP CURLFINFOFLAG_KNOWN_FILENAME
Introduced in 7.21.0
.IP CURLFINFOFLAG_KNOWN_FILETYPE
Introduced in 7.21.0
.IP CURLFINFOFLAG_KNOWN_GID
Introduced in 7.21.0
.IP CURLFINFOFLAG_KNOWN_HLINKCOUNT
Introduced in 7.21.0
.IP CURLFINFOFLAG_KNOWN_PERM
Introduced in 7.21.0
.IP CURLFINFOFLAG_KNOWN_SIZE
Introduced in 7.21.0
.IP CURLFINFOFLAG_KNOWN_TIME
Introduced in 7.21.0
.IP CURLFINFOFLAG_KNOWN_UID
Introduced in 7.21.0
.IP CURLFORM_ARRAY
Introduced in 7.9.1
Deprecated since 7.56.0
.IP CURLFORM_ARRAY_END
Introduced in 7.9.1
Deprecated since 7.9.5
Last used in 7.9.6
.IP CURLFORM_ARRAY_START
Introduced in 7.9.1
Deprecated since 7.9.5
Last used in 7.9.6
.IP CURLFORM_BUFFER
Introduced in 7.9.8
Deprecated since 7.56.0
.IP CURLFORM_BUFFERLENGTH
Introduced in 7.9.8
Deprecated since 7.56.0
.IP CURLFORM_BUFFERPTR
Introduced in 7.9.8
Deprecated since 7.56.0
.IP CURLFORM_CONTENTHEADER
Introduced in 7.9.3
Deprecated since 7.56.0
.IP CURLFORM_CONTENTLEN
Introduced in 7.46.0
Deprecated since 7.56.0
.IP CURLFORM_CONTENTSLENGTH
Introduced in 7.9
Deprecated since 7.56.0
.IP CURLFORM_CONTENTTYPE
Introduced in 7.9
Deprecated since 7.56.0
.IP CURLFORM_COPYCONTENTS
Introduced in 7.9
Deprecated since 7.56.0
.IP CURLFORM_COPYNAME
Introduced in 7.9
Deprecated since 7.56.0
.IP CURLFORM_END
Introduced in 7.9
Deprecated since 7.56.0
.IP CURLFORM_FILE
Introduced in 7.9
Deprecated since 7.56.0
.IP CURLFORM_FILECONTENT
Introduced in 7.9.1
Deprecated since 7.56.0
.IP CURLFORM_FILENAME
Introduced in 7.9.6
Deprecated since 7.56.0
.IP CURLFORM_NAMELENGTH
Introduced in 7.9
Deprecated since 7.56.0
.IP CURLFORM_NOTHING
Introduced in 7.9
Deprecated since 7.56.0
.IP CURLFORM_PTRCONTENTS
Introduced in 7.9
Deprecated since 7.56.0
.IP CURLFORM_PTRNAME
Introduced in 7.9
Deprecated since 7.56.0
.IP CURLFORM_STREAM
Introduced in 7.18.2
Deprecated since 7.56.0
.IP CURLFTP_CREATE_DIR
Introduced in 7.19.4
.IP CURLFTP_CREATE_DIR_NONE
Introduced in 7.19.4
.IP CURLFTP_CREATE_DIR_RETRY
Introduced in 7.19.4
.IP CURLFTPAUTH_DEFAULT
Introduced in 7.12.2
.IP CURLFTPAUTH_SSL
Introduced in 7.12.2
.IP CURLFTPAUTH_TLS
Introduced in 7.12.2
.IP CURLFTPMETHOD_DEFAULT
Introduced in 7.15.3
.IP CURLFTPMETHOD_MULTICWD
Introduced in 7.15.3
.IP CURLFTPMETHOD_NOCWD
Introduced in 7.15.3
.IP CURLFTPMETHOD_SINGLECWD
Introduced in 7.15.3
.IP CURLFTPSSL_ALL
Introduced in 7.11.0
Deprecated since 7.17.0
.IP CURLFTPSSL_CCC_ACTIVE
Introduced in 7.16.2
.IP CURLFTPSSL_CCC_NONE
Introduced in 7.16.2
.IP CURLFTPSSL_CCC_PASSIVE
Introduced in 7.16.1
.IP CURLFTPSSL_CONTROL
Introduced in 7.11.0
Deprecated since 7.17.0
.IP CURLFTPSSL_NONE
Introduced in 7.11.0
Deprecated since 7.17.0
.IP CURLFTPSSL_TRY
Introduced in 7.11.0
Deprecated since 7.17.0
.IP CURLGSSAPI_DELEGATION_FLAG
Introduced in 7.22.0
.IP CURLGSSAPI_DELEGATION_NONE
Introduced in 7.22.0
.IP CURLGSSAPI_DELEGATION_POLICY_FLAG
Introduced in 7.22.0
.IP CURLH_1XX
Introduced in 7.83.0
.IP CURLH_CONNECT
Introduced in 7.83.0
.IP CURLH_HEADER
Introduced in 7.83.0
.IP CURLH_PSEUDO
Introduced in 7.83.0
.IP CURLH_TRAILER
Introduced in 7.83.0
.IP CURLHE_BAD_ARGUMENT
Introduced in 7.83.0
.IP CURLHE_BADINDEX
Introduced in 7.83.0
.IP CURLHE_MISSING
Introduced in 7.83.0
.IP CURLHE_NOHEADERS
Introduced in 7.83.0
.IP CURLHE_NOREQUEST
Introduced in 7.83.0
.IP CURLHE_NOT_BUILT_IN
Introduced in 7.83.0
.IP CURLHE_OK
Introduced in 7.83.0
.IP CURLHE_OUT_OF_MEMORY
Introduced in 7.83.0
.IP CURLHEADER_SEPARATE
Introduced in 7.37.0
.IP CURLHEADER_UNIFIED
Introduced in 7.37.0
.IP CURLHSTS_ENABLE
Introduced in 7.74.0
.IP CURLHSTS_READONLYFILE
Introduced in 7.74.0
.IP CURLINFO_ACTIVESOCKET
Introduced in 7.45.0
.IP CURLINFO_APPCONNECT_TIME
Introduced in 7.19.0
.IP CURLINFO_APPCONNECT_TIME_T
Introduced in 7.61.0
.IP CURLINFO_CAINFO
Introduced in 7.84.0
.IP CURLINFO_CAPATH
Introduced in 7.84.0
.IP CURLINFO_CERTINFO
Introduced in 7.19.1
.IP CURLINFO_CONDITION_UNMET
Introduced in 7.19.4
.IP CURLINFO_CONN_ID
Introduced in 8.2.0
.IP CURLINFO_CONNECT_TIME
Introduced in 7.4.1
.IP CURLINFO_CONNECT_TIME_T
Introduced in 7.61.0
.IP CURLINFO_CONTENT_LENGTH_DOWNLOAD
Introduced in 7.6.1
Deprecated since 7.55.0
.IP CURLINFO_CONTENT_LENGTH_DOWNLOAD_T
Introduced in 7.55.0
.IP CURLINFO_CONTENT_LENGTH_UPLOAD
Introduced in 7.6.1
Deprecated since 7.55.0
.IP CURLINFO_CONTENT_LENGTH_UPLOAD_T
Introduced in 7.55.0
.IP CURLINFO_CONTENT_TYPE
Introduced in 7.9.4
.IP CURLINFO_COOKIELIST
Introduced in 7.14.1
.IP CURLINFO_DATA_IN
Introduced in 7.9.6
.IP CURLINFO_DATA_OUT
Introduced in 7.9.6
.IP CURLINFO_DOUBLE
Introduced in 7.4.1
.IP CURLINFO_EFFECTIVE_METHOD
Introduced in 7.72.0
.IP CURLINFO_EFFECTIVE_URL
Introduced in 7.4
.IP CURLINFO_END
Introduced in 7.9.6
.IP CURLINFO_FILETIME
Introduced in 7.5
.IP CURLINFO_FILETIME_T
Introduced in 7.59.0
.IP CURLINFO_FTP_ENTRY_PATH
Introduced in 7.15.4
.IP CURLINFO_HEADER_IN
Introduced in 7.9.6
.IP CURLINFO_HEADER_OUT
Introduced in 7.9.6
.IP CURLINFO_HEADER_SIZE
Introduced in 7.4.1
.IP CURLINFO_HTTP_CODE
Introduced in 7.4.1
Deprecated since 7.10.8
.IP CURLINFO_HTTP_CONNECTCODE
Introduced in 7.10.7
.IP CURLINFO_HTTP_VERSION
Introduced in 7.50.0
.IP CURLINFO_HTTPAUTH_AVAIL
Introduced in 7.10.8
.IP CURLINFO_LASTONE
Introduced in 7.4.1
.IP CURLINFO_LASTSOCKET
Introduced in 7.15.2
Deprecated since 7.45.0
.IP CURLINFO_LOCAL_IP
Introduced in 7.21.0
.IP CURLINFO_LOCAL_PORT
Introduced in 7.21.0
.IP CURLINFO_LONG
Introduced in 7.4.1
.IP CURLINFO_MASK
Introduced in 7.4.1
.IP CURLINFO_NAMELOOKUP_TIME
Introduced in 7.4.1
.IP CURLINFO_NAMELOOKUP_TIME_T
Introduced in 7.61.0
.IP CURLINFO_NONE
Introduced in 7.4.1
.IP CURLINFO_NUM_CONNECTS
Introduced in 7.12.3
.IP CURLINFO_OFF_T
Introduced in 7.55.0
.IP CURLINFO_OS_ERRNO
Introduced in 7.12.2
.IP CURLINFO_PRETRANSFER_TIME
Introduced in 7.4.1
.IP CURLINFO_PRETRANSFER_TIME_T
Introduced in 7.61.0
.IP CURLINFO_PRIMARY_IP
Introduced in 7.19.0
.IP CURLINFO_PRIMARY_PORT
Introduced in 7.21.0
.IP CURLINFO_PRIVATE
Introduced in 7.10.3
.IP CURLINFO_PROTOCOL
Introduced in 7.52.0
Deprecated since 7.85.0
.IP CURLINFO_PROXY_ERROR
Introduced in 7.73.0
.IP CURLINFO_PROXY_SSL_VERIFYRESULT
Introduced in 7.52.0
.IP CURLINFO_PROXYAUTH_AVAIL
Introduced in 7.10.8
.IP CURLINFO_PTR
Introduced in 7.54.1
.IP CURLINFO_REDIRECT_COUNT
Introduced in 7.9.7
.IP CURLINFO_REDIRECT_TIME
Introduced in 7.9.7
.IP CURLINFO_REDIRECT_TIME_T
Introduced in 7.61.0
.IP CURLINFO_REDIRECT_URL
Introduced in 7.18.2
.IP CURLINFO_REFERER
Introduced in 7.76.0
.IP CURLINFO_REQUEST_SIZE
Introduced in 7.4.1
.IP CURLINFO_RESPONSE_CODE
Introduced in 7.10.8
.IP CURLINFO_RETRY_AFTER
Introduced in 7.66.0
.IP CURLINFO_RTSP_CLIENT_CSEQ
Introduced in 7.20.0
.IP CURLINFO_RTSP_CSEQ_RECV
Introduced in 7.20.0
.IP CURLINFO_RTSP_SERVER_CSEQ
Introduced in 7.20.0
.IP CURLINFO_RTSP_SESSION_ID
Introduced in 7.20.0
.IP CURLINFO_SCHEME
Introduced in 7.52.0
.IP CURLINFO_SIZE_DOWNLOAD
Introduced in 7.4.1
Deprecated since 7.55.0
.IP CURLINFO_SIZE_DOWNLOAD_T
Introduced in 7.55.0
.IP CURLINFO_SIZE_UPLOAD
Introduced in 7.4.1
Deprecated since 7.55.0
.IP CURLINFO_SIZE_UPLOAD_T
Introduced in 7.55.0
.IP CURLINFO_SLIST
Introduced in 7.12.3
.IP CURLINFO_SOCKET
Introduced in 7.45.0
.IP CURLINFO_SPEED_DOWNLOAD
Introduced in 7.4.1
Deprecated since 7.55.0
.IP CURLINFO_SPEED_DOWNLOAD_T
Introduced in 7.55.0
.IP CURLINFO_SPEED_UPLOAD
Introduced in 7.4.1
Deprecated since 7.55.0
.IP CURLINFO_SPEED_UPLOAD_T
Introduced in 7.55.0
.IP CURLINFO_SSL_DATA_IN
Introduced in 7.12.1
.IP CURLINFO_SSL_DATA_OUT
Introduced in 7.12.1
.IP CURLINFO_SSL_ENGINES
Introduced in 7.12.3
.IP CURLINFO_SSL_VERIFYRESULT
Introduced in 7.5
.IP CURLINFO_STARTTRANSFER_TIME
Introduced in 7.9.2
.IP CURLINFO_STARTTRANSFER_TIME_T
Introduced in 7.61.0
.IP CURLINFO_STRING
Introduced in 7.4.1
.IP CURLINFO_TEXT
Introduced in 7.9.6
.IP CURLINFO_TLS_SESSION
Introduced in 7.34.0
Deprecated since 7.48.0
.IP CURLINFO_TLS_SSL_PTR
Introduced in 7.48.0
.IP CURLINFO_TOTAL_TIME
Introduced in 7.4.1
.IP CURLINFO_TOTAL_TIME_T
Introduced in 7.61.0
.IP CURLINFO_TYPEMASK
Introduced in 7.4.1
.IP CURLINFO_XFER_ID
Introduced in 8.2.0
.IP CURLIOCMD_NOP
Introduced in 7.12.3
.IP CURLIOCMD_RESTARTREAD
Introduced in 7.12.3
.IP CURLIOE_FAILRESTART
Introduced in 7.12.3
.IP CURLIOE_OK
Introduced in 7.12.3
.IP CURLIOE_UNKNOWNCMD
Introduced in 7.12.3
.IP CURLKHMATCH_MISMATCH
Introduced in 7.19.6
.IP CURLKHMATCH_MISSING
Introduced in 7.19.6
.IP CURLKHMATCH_OK
Introduced in 7.19.6
.IP CURLKHSTAT_DEFER
Introduced in 7.19.6
.IP CURLKHSTAT_FINE
Introduced in 7.19.6
.IP CURLKHSTAT_FINE_ADD_TO_FILE
Introduced in 7.19.6
.IP CURLKHSTAT_FINE_REPLACE
Introduced in 7.73.0
.IP CURLKHSTAT_REJECT
Introduced in 7.19.6
.IP CURLKHTYPE_DSS
Introduced in 7.19.6
.IP CURLKHTYPE_ECDSA
Introduced in 7.58.0
.IP CURLKHTYPE_ED25519
Introduced in 7.58.0
.IP CURLKHTYPE_RSA
Introduced in 7.19.6
.IP CURLKHTYPE_RSA1
Introduced in 7.19.6
.IP CURLKHTYPE_UNKNOWN
Introduced in 7.19.6
.IP CURLM_ABORTED_BY_CALLBACK
Introduced in 7.81.0
.IP CURLM_ADDED_ALREADY
Introduced in 7.32.1
.IP CURLM_BAD_EASY_HANDLE
Introduced in 7.9.6
.IP CURLM_BAD_FUNCTION_ARGUMENT
Introduced in 7.69.0
.IP CURLM_BAD_HANDLE
Introduced in 7.9.6
.IP CURLM_BAD_SOCKET
Introduced in 7.15.4
.IP CURLM_CALL_MULTI_PERFORM
Introduced in 7.9.6
.IP CURLM_CALL_MULTI_SOCKET
Introduced in 7.15.5
.IP CURLM_INTERNAL_ERROR
Introduced in 7.9.6
.IP CURLM_OK
Introduced in 7.9.6
.IP CURLM_OUT_OF_MEMORY
Introduced in 7.9.6
.IP CURLM_RECURSIVE_API_CALL
Introduced in 7.59.0
.IP CURLM_UNKNOWN_OPTION
Introduced in 7.15.4
.IP CURLM_UNRECOVERABLE_POLL
Introduced in 7.84.0
.IP CURLM_WAKEUP_FAILURE
Introduced in 7.68.0
.IP CURLMIMEOPT_FORMESCAPE
Introduced in 7.81.0
.IP CURLMOPT_CHUNK_LENGTH_PENALTY_SIZE
Introduced in 7.30.0
.IP CURLMOPT_CONTENT_LENGTH_PENALTY_SIZE
Introduced in 7.30.0
.IP CURLMOPT_MAX_CONCURRENT_STREAMS
Introduced in 7.67.0
.IP CURLMOPT_MAX_HOST_CONNECTIONS
Introduced in 7.30.0
.IP CURLMOPT_MAX_PIPELINE_LENGTH
Introduced in 7.30.0
.IP CURLMOPT_MAX_TOTAL_CONNECTIONS
Introduced in 7.30.0
.IP CURLMOPT_MAXCONNECTS
Introduced in 7.16.3
.IP CURLMOPT_PIPELINING
Introduced in 7.16.0
.IP CURLMOPT_PIPELINING_SERVER_BL
Introduced in 7.30.0
.IP CURLMOPT_PIPELINING_SITE_BL
Introduced in 7.30.0
.IP CURLMOPT_PUSHDATA
Introduced in 7.44.0
.IP CURLMOPT_PUSHFUNCTION
Introduced in 7.44.0
.IP CURLMOPT_SOCKETDATA
Introduced in 7.15.4
.IP CURLMOPT_SOCKETFUNCTION
Introduced in 7.15.4
.IP CURLMOPT_TIMERDATA
Introduced in 7.16.0
.IP CURLMOPT_TIMERFUNCTION
Introduced in 7.16.0
.IP CURLMSG_DONE
Introduced in 7.9.6
.IP CURLMSG_NONE
Introduced in 7.9.6
.IP CURLOPT
Introduced in 7.69.0
.IP CURLOPT_ABSTRACT_UNIX_SOCKET
Introduced in 7.53.0
.IP CURLOPT_ACCEPT_ENCODING
Introduced in 7.21.6
.IP CURLOPT_ACCEPTTIMEOUT_MS
Introduced in 7.24.0
.IP CURLOPT_ADDRESS_SCOPE
Introduced in 7.19.0
.IP CURLOPT_ALTSVC
Introduced in 7.64.1
.IP CURLOPT_ALTSVC_CTRL
Introduced in 7.64.1
.IP CURLOPT_APPEND
Introduced in 7.17.0
.IP CURLOPT_AUTOREFERER
Introduced in 7.1
.IP CURLOPT_AWS_SIGV4
Introduced in 7.75.0
.IP CURLOPT_BUFFERSIZE
Introduced in 7.10
.IP CURLOPT_CAINFO
Introduced in 7.4.2
.IP CURLOPT_CAINFO_BLOB
Introduced in 7.77.0
.IP CURLOPT_CAPATH
Introduced in 7.9.8
.IP CURLOPT_CA_CACHE_TIMEOUT
Introduced in 7.87.0
.IP CURLOPT_CERTINFO
Introduced in 7.19.1
.IP CURLOPT_CHUNK_BGN_FUNCTION
Introduced in 7.21.0
.IP CURLOPT_CHUNK_DATA
Introduced in 7.21.0
.IP CURLOPT_CHUNK_END_FUNCTION
Introduced in 7.21.0
.IP CURLOPT_CLOSEFUNCTION
Introduced in 7.7
Deprecated since 7.11.1
Last used in 7.15.5
.IP CURLOPT_CLOSEPOLICY
Introduced in 7.7
Deprecated since 7.16.1
.IP CURLOPT_CLOSESOCKETDATA
Introduced in 7.21.7
.IP CURLOPT_CLOSESOCKETFUNCTION
Introduced in 7.21.7
.IP CURLOPT_CONNECT_ONLY
Introduced in 7.15.2
.IP CURLOPT_CONNECT_TO
Introduced in 7.49.0
.IP CURLOPT_CONNECTTIMEOUT
Introduced in 7.7
.IP CURLOPT_CONNECTTIMEOUT_MS
Introduced in 7.16.2
.IP CURLOPT_CONV_FROM_NETWORK_FUNCTION
Introduced in 7.15.4
Deprecated since 7.82.0
.IP CURLOPT_CONV_FROM_UTF8_FUNCTION
Introduced in 7.15.4
Deprecated since 7.82.0
.IP CURLOPT_CONV_TO_NETWORK_FUNCTION
Introduced in 7.15.4
Deprecated since 7.82.0
.IP CURLOPT_COOKIE
Introduced in 7.1
.IP CURLOPT_COOKIEFILE
Introduced in 7.1
.IP CURLOPT_COOKIEJAR
Introduced in 7.9
.IP CURLOPT_COOKIELIST
Introduced in 7.14.1
.IP CURLOPT_COOKIESESSION
Introduced in 7.9.7
.IP CURLOPT_COPYPOSTFIELDS
Introduced in 7.17.1
.IP CURLOPT_CRLF
Introduced in 7.1
.IP CURLOPT_CRLFILE
Introduced in 7.19.0
.IP CURLOPT_CURLU
Introduced in 7.63.0
.IP CURLOPT_CUSTOMREQUEST
Introduced in 7.1
.IP CURLOPT_DEBUGDATA
Introduced in 7.9.6
.IP CURLOPT_DEBUGFUNCTION
Introduced in 7.9.6
.IP CURLOPT_DEFAULT_PROTOCOL
Introduced in 7.45.0
.IP CURLOPT_DIRLISTONLY
Introduced in 7.17.0
.IP CURLOPT_DISALLOW_USERNAME_IN_URL
Introduced in 7.61.0
.IP CURLOPT_DNS_CACHE_TIMEOUT
Introduced in 7.9.3
.IP CURLOPT_DNS_INTERFACE
Introduced in 7.33.0
.IP CURLOPT_DNS_LOCAL_IP4
Introduced in 7.33.0
.IP CURLOPT_DNS_LOCAL_IP6
Introduced in 7.33.0
.IP CURLOPT_DNS_SERVERS
Introduced in 7.24.0
.IP CURLOPT_DNS_SHUFFLE_ADDRESSES
Introduced in 7.60.0
.IP CURLOPT_DNS_USE_GLOBAL_CACHE
Introduced in 7.9.3
Deprecated since 7.11.1
.IP CURLOPT_DOH_SSL_VERIFYHOST
Introduced in 7.76.0
.IP CURLOPT_DOH_SSL_VERIFYPEER
Introduced in 7.76.0
.IP CURLOPT_DOH_SSL_VERIFYSTATUS
Introduced in 7.76.0
.IP CURLOPT_DOH_URL
Introduced in 7.62.0
.IP CURLOPT_EGDSOCKET
Introduced in 7.7
Deprecated since 7.84.0
.IP CURLOPT_ENCODING
Introduced in 7.10
Deprecated since 7.21.6
.IP CURLOPT_ERRORBUFFER
Introduced in 7.1
.IP CURLOPT_EXPECT_100_TIMEOUT_MS
Introduced in 7.36.0
.IP CURLOPT_FAILONERROR
Introduced in 7.1
.IP CURLOPT_FILE
Introduced in 7.1
Deprecated since 7.9.7
.IP CURLOPT_FILETIME
Introduced in 7.5
.IP CURLOPT_FNMATCH_DATA
Introduced in 7.21.0
.IP CURLOPT_FNMATCH_FUNCTION
Introduced in 7.21.0
.IP CURLOPT_FOLLOWLOCATION
Introduced in 7.1
.IP CURLOPT_FORBID_REUSE
Introduced in 7.7
.IP CURLOPT_FRESH_CONNECT
Introduced in 7.7
.IP CURLOPT_FTP_ACCOUNT
Introduced in 7.13.0
.IP CURLOPT_FTP_ALTERNATIVE_TO_USER
Introduced in 7.15.5
.IP CURLOPT_FTP_CREATE_MISSING_DIRS
Introduced in 7.10.7
.IP CURLOPT_FTP_FILEMETHOD
Introduced in 7.15.1
.IP CURLOPT_FTP_RESPONSE_TIMEOUT
Introduced in 7.10.8
Deprecated since 7.85.0
.IP CURLOPT_FTP_SKIP_PASV_IP
Introduced in 7.15.0
.IP CURLOPT_FTP_SSL
Introduced in 7.11.0
Deprecated since 7.16.4
.IP CURLOPT_FTP_SSL_CCC
Introduced in 7.16.1
.IP CURLOPT_FTP_USE_EPRT
Introduced in 7.10.5
.IP CURLOPT_FTP_USE_EPSV
Introduced in 7.9.2
.IP CURLOPT_FTP_USE_PRET
Introduced in 7.20.0
.IP CURLOPT_FTPAPPEND
Introduced in 7.1
Deprecated since 7.16.4
.IP CURLOPT_FTPASCII
Introduced in 7.1
Deprecated since 7.11.1
Last used in 7.15.5
.IP CURLOPT_FTPLISTONLY
Introduced in 7.1
Deprecated since 7.16.4
.IP CURLOPT_FTPPORT
Introduced in 7.1
.IP CURLOPT_FTPSSLAUTH
Introduced in 7.12.2
.IP CURLOPT_GSSAPI_DELEGATION
Introduced in 7.22.0
.IP CURLOPT_HAPPY_EYEBALLS_TIMEOUT_MS
Introduced in 7.59.0
.IP CURLOPT_HAPROXYPROTOCOL
Introduced in 7.60.0
.IP CURLOPT_HAPROXY_CLIENT_IP
Introduced in 8.2.0
.IP CURLOPT_HEADER
Introduced in 7.1
.IP CURLOPT_HEADERDATA
Introduced in 7.10
.IP CURLOPT_HEADERFUNCTION
Introduced in 7.7.2
.IP CURLOPT_HEADEROPT
Introduced in 7.37.0
.IP CURLOPT_HSTS
Introduced in 7.74.0
.IP CURLOPT_HSTS_CTRL
Introduced in 7.74.0
.IP CURLOPT_HSTSREADDATA
Introduced in 7.74.0
.IP CURLOPT_HSTSREADFUNCTION
Introduced in 7.74.0
.IP CURLOPT_HSTSWRITEDATA
Introduced in 7.74.0
.IP CURLOPT_HSTSWRITEFUNCTION
Introduced in 7.74.0
.IP CURLOPT_HTTP09_ALLOWED
Introduced in 7.64.0
.IP CURLOPT_HTTP200ALIASES
Introduced in 7.10.3
.IP CURLOPT_HTTP_CONTENT_DECODING
Introduced in 7.16.2
.IP CURLOPT_HTTP_TRANSFER_DECODING
Introduced in 7.16.2
.IP CURLOPT_HTTP_VERSION
Introduced in 7.9.1
.IP CURLOPT_HTTPAUTH
Introduced in 7.10.6
.IP CURLOPT_HTTPGET
Introduced in 7.8.1
.IP CURLOPT_HTTPHEADER
Introduced in 7.1
.IP CURLOPT_HTTPPOST
Introduced in 7.1
Deprecated since 7.56.0
.IP CURLOPT_HTTPPROXYTUNNEL
Introduced in 7.3
.IP CURLOPT_HTTPREQUEST
Introduced in 7.1
.IP CURLOPT_IGNORE_CONTENT_LENGTH
Introduced in 7.14.1
.IP CURLOPT_INFILE
Introduced in 7.1
Deprecated since 7.9.7
.IP CURLOPT_INFILESIZE
Introduced in 7.1
.IP CURLOPT_INFILESIZE_LARGE
Introduced in 7.11.0
.IP CURLOPT_INTERFACE
Introduced in 7.3
.IP CURLOPT_INTERLEAVEDATA
Introduced in 7.20.0
.IP CURLOPT_INTERLEAVEFUNCTION
Introduced in 7.20.0
.IP CURLOPT_IOCTLDATA
Introduced in 7.12.3
Deprecated since 7.18.0
.IP CURLOPT_IOCTLFUNCTION
Introduced in 7.12.3
Deprecated since 7.18.0
.IP CURLOPT_IPRESOLVE
Introduced in 7.10.8
.IP CURLOPT_ISSUERCERT
Introduced in 7.19.0
.IP CURLOPT_ISSUERCERT_BLOB
Introduced in 7.71.0
.IP CURLOPT_KEEP_SENDING_ON_ERROR
Introduced in 7.51.0
.IP CURLOPT_KEYPASSWD
Introduced in 7.17.0
.IP CURLOPT_KRB4LEVEL
Introduced in 7.3
Deprecated since 7.17.0
.IP CURLOPT_KRBLEVEL
Introduced in 7.16.4
.IP CURLOPT_LOCALPORT
Introduced in 7.15.2
.IP CURLOPT_LOCALPORTRANGE
Introduced in 7.15.2
.IP CURLOPT_LOGIN_OPTIONS
Introduced in 7.34.0
.IP CURLOPT_LOW_SPEED_LIMIT
Introduced in 7.1
.IP CURLOPT_LOW_SPEED_TIME
Introduced in 7.1
.IP CURLOPT_MAIL_AUTH
Introduced in 7.25.0
.IP CURLOPT_MAIL_FROM
Introduced in 7.20.0
.IP CURLOPT_MAIL_RCPT
Introduced in 7.20.0
.IP CURLOPT_MAIL_RCPT_ALLLOWFAILS
Introduced in 7.69.0
Deprecated since 8.2.0
.IP CURLOPT_MAIL_RCPT_ALLOWFAILS
Introduced in 8.2.0
.IP CURLOPT_QUICK_EXIT
Introduced in 7.87.0
.IP CURLOPT_MAX_RECV_SPEED_LARGE
Introduced in 7.15.5
.IP CURLOPT_MAX_SEND_SPEED_LARGE
Introduced in 7.15.5
.IP CURLOPT_MAXAGE_CONN
Introduced in 7.65.0
.IP CURLOPT_MAXCONNECTS
Introduced in 7.7
.IP CURLOPT_MAXFILESIZE
Introduced in 7.10.8
.IP CURLOPT_MAXFILESIZE_LARGE
Introduced in 7.11.0
.IP CURLOPT_MAXLIFETIME_CONN
Introduced in 7.80.0
.IP CURLOPT_MAXREDIRS
Introduced in 7.5
.IP CURLOPT_MIME_OPTIONS
Introduced in 7.81.0
.IP CURLOPT_MIMEPOST
Introduced in 7.56.0
.IP CURLOPT_MUTE
Introduced in 7.1
Deprecated since 7.8
Last used in 7.15.5
.IP CURLOPT_NETRC
Introduced in 7.1
.IP CURLOPT_NETRC_FILE
Introduced in 7.11.0
.IP CURLOPT_NEW_DIRECTORY_PERMS
Introduced in 7.16.4
.IP CURLOPT_NEW_FILE_PERMS
Introduced in 7.16.4
.IP CURLOPT_NOBODY
Introduced in 7.1
.IP CURLOPT_NOPROGRESS
Introduced in 7.1
.IP CURLOPT_NOPROXY
Introduced in 7.19.4
.IP CURLOPT_NOSIGNAL
Introduced in 7.10
.IP CURLOPT_NOTHING
Introduced in 7.1.1
Deprecated since 7.11.1
Last used in 7.11.0
.IP CURLOPT_OPENSOCKETDATA
Introduced in 7.17.1
.IP CURLOPT_OPENSOCKETFUNCTION
Introduced in 7.17.1
.IP CURLOPT_PASSWDDATA
Introduced in 7.4.2
Deprecated since 7.11.1
Last used in 7.15.5
.IP CURLOPT_PASSWDFUNCTION
Introduced in 7.4.2
Deprecated since 7.11.1
Last used in 7.15.5
.IP CURLOPT_PASSWORD
Introduced in 7.19.1
.IP CURLOPT_PASV_HOST
Introduced in 7.12.1
Deprecated since 7.16.0
Last used in 7.15.5
.IP CURLOPT_PATH_AS_IS
Introduced in 7.42.0
.IP CURLOPT_PINNEDPUBLICKEY
Introduced in 7.39.0
.IP CURLOPT_PIPEWAIT
Introduced in 7.43.0
.IP CURLOPT_PORT
Introduced in 7.1
.IP CURLOPT_POST
Introduced in 7.1
.IP CURLOPT_POST301
Introduced in 7.17.1
Deprecated since 7.19.1
.IP CURLOPT_POSTFIELDS
Introduced in 7.1
.IP CURLOPT_POSTFIELDSIZE
Introduced in 7.2
.IP CURLOPT_POSTFIELDSIZE_LARGE
Introduced in 7.11.1
.IP CURLOPT_POSTQUOTE
Introduced in 7.1
.IP CURLOPT_POSTREDIR
Introduced in 7.19.1
.IP CURLOPT_PRE_PROXY
Introduced in 7.52.0
.IP CURLOPT_PREQUOTE
Introduced in 7.9.5
.IP CURLOPT_PREREQDATA
Introduced in 7.80.0
.IP CURLOPT_PREREQFUNCTION
Introduced in 7.80.0
.IP CURLOPT_PRIVATE
Introduced in 7.10.3
.IP CURLOPT_PROGRESSDATA
Introduced in 7.1
.IP CURLOPT_PROGRESSFUNCTION
Introduced in 7.1
Deprecated since 7.32.0
.IP CURLOPT_PROTOCOLS
Introduced in 7.19.4
Deprecated since 7.85.0
.IP CURLOPT_PROTOCOLS_STR
Introduced in 7.85.0
.IP CURLOPT_PROXY
Introduced in 7.1
.IP CURLOPT_PROXY_CAINFO
Introduced in 7.52.0
.IP CURLOPT_PROXY_CAINFO_BLOB
Introduced in 7.77.0
.IP CURLOPT_PROXY_CAPATH
Introduced in 7.52.0
.IP CURLOPT_PROXY_CRLFILE
Introduced in 7.52.0
.IP CURLOPT_PROXY_ISSUERCERT
Introduced in 7.71.0
.IP CURLOPT_PROXY_ISSUERCERT_BLOB
Introduced in 7.71.0
.IP CURLOPT_PROXY_KEYPASSWD
Introduced in 7.52.0
.IP CURLOPT_PROXY_PINNEDPUBLICKEY
Introduced in 7.52.0
.IP CURLOPT_PROXY_SERVICE_NAME
Introduced in 7.43.0
.IP CURLOPT_PROXY_SSL_CIPHER_LIST
Introduced in 7.52.0
.IP CURLOPT_PROXY_SSL_OPTIONS
Introduced in 7.52.0
.IP CURLOPT_PROXY_SSL_VERIFYHOST
Introduced in 7.52.0
.IP CURLOPT_PROXY_SSL_VERIFYPEER
Introduced in 7.52.0
.IP CURLOPT_PROXY_SSLCERT
Introduced in 7.52.0
.IP CURLOPT_PROXY_SSLCERT_BLOB
Introduced in 7.71.0
.IP CURLOPT_PROXY_SSLCERTTYPE
Introduced in 7.52.0
.IP CURLOPT_PROXY_SSLKEY
Introduced in 7.52.0
.IP CURLOPT_PROXY_SSLKEY_BLOB
Introduced in 7.71.0
.IP CURLOPT_PROXY_SSLKEYTYPE
Introduced in 7.52.0
.IP CURLOPT_PROXY_SSLVERSION
Introduced in 7.52.0
.IP CURLOPT_PROXY_TLS13_CIPHERS
Introduced in 7.61.0
.IP CURLOPT_PROXY_TLSAUTH_PASSWORD
Introduced in 7.52.0
.IP CURLOPT_PROXY_TLSAUTH_TYPE
Introduced in 7.52.0
.IP CURLOPT_PROXY_TLSAUTH_USERNAME
Introduced in 7.52.0
.IP CURLOPT_PROXY_TRANSFER_MODE
Introduced in 7.18.0
.IP CURLOPT_PROXYAUTH
Introduced in 7.10.7
.IP CURLOPT_PROXYHEADER
Introduced in 7.37.0
.IP CURLOPT_PROXYPASSWORD
Introduced in 7.19.1
.IP CURLOPT_PROXYPORT
Introduced in 7.1
.IP CURLOPT_PROXYTYPE
Introduced in 7.10
.IP CURLOPT_PROXYUSERNAME
Introduced in 7.19.1
.IP CURLOPT_PROXYUSERPWD
Introduced in 7.1
.IP CURLOPT_PUT
Introduced in 7.1
Deprecated since 7.12.1
.IP CURLOPT_QUOTE
Introduced in 7.1
.IP CURLOPT_RANDOM_FILE
Introduced in 7.7
Deprecated since 7.84.0
.IP CURLOPT_RANGE
Introduced in 7.1
.IP CURLOPT_READDATA
Introduced in 7.9.7
.IP CURLOPT_READFUNCTION
Introduced in 7.1
.IP CURLOPT_REDIR_PROTOCOLS
Introduced in 7.19.4
Deprecated since 7.85.0
.IP CURLOPT_REDIR_PROTOCOLS_STR
Introduced in 7.85.0
.IP CURLOPT_REFERER
Introduced in 7.1
.IP CURLOPT_REQUEST_TARGET
Introduced in 7.55.0
.IP CURLOPT_RESOLVE
Introduced in 7.21.3
.IP CURLOPT_RESOLVER_START_DATA
Introduced in 7.59.0
.IP CURLOPT_RESOLVER_START_FUNCTION
Introduced in 7.59.0
.IP CURLOPT_RESUME_FROM
Introduced in 7.1
.IP CURLOPT_RESUME_FROM_LARGE
Introduced in 7.11.0
.IP CURLOPT_RTSP_CLIENT_CSEQ
Introduced in 7.20.0
.IP CURLOPT_RTSP_REQUEST
Introduced in 7.20.0
.IP CURLOPT_RTSP_SERVER_CSEQ
Introduced in 7.20.0
.IP CURLOPT_RTSP_SESSION_ID
Introduced in 7.20.0
.IP CURLOPT_RTSP_STREAM_URI
Introduced in 7.20.0
.IP CURLOPT_RTSP_TRANSPORT
Introduced in 7.20.0
.IP CURLOPT_RTSPHEADER
Introduced in 7.20.0
.IP CURLOPT_SASL_AUTHZID
Introduced in 7.66.0
.IP CURLOPT_SASL_IR
Introduced in 7.31.0
.IP CURLOPT_SEEKDATA
Introduced in 7.18.0
.IP CURLOPT_SEEKFUNCTION
Introduced in 7.18.0
.IP CURLOPT_SERVER_RESPONSE_TIMEOUT
Introduced in 7.20.0
.IP CURLOPT_SERVICE_NAME
Introduced in 7.43.0
.IP CURLOPT_SHARE
Introduced in 7.10
.IP CURLOPT_SOCKOPTDATA
Introduced in 7.16.0
.IP CURLOPT_SOCKOPTFUNCTION
Introduced in 7.16.0
.IP CURLOPT_SOCKS5_AUTH
Introduced in 7.55.0
.IP CURLOPT_SOCKS5_GSSAPI_NEC
Introduced in 7.19.4
.IP CURLOPT_SOCKS5_GSSAPI_SERVICE
Introduced in 7.19.4
Deprecated since 7.49.0
.IP CURLOPT_SOURCE_HOST
Introduced in 7.12.1
.IP CURLOPT_SOURCE_PATH
Introduced in 7.12.1
.IP CURLOPT_SOURCE_PORT
Introduced in 7.12.1
.IP CURLOPT_SOURCE_POSTQUOTE
Introduced in 7.12.1
.IP CURLOPT_SOURCE_PREQUOTE
Introduced in 7.12.1
.IP CURLOPT_SOURCE_QUOTE
Introduced in 7.13.0
.IP CURLOPT_SOURCE_URL
Introduced in 7.13.0
.IP CURLOPT_SOURCE_USERPWD
Introduced in 7.12.1
.IP CURLOPT_SSH_AUTH_TYPES
Introduced in 7.16.1
.IP CURLOPT_SSH_COMPRESSION
Introduced in 7.56.0
.IP CURLOPT_SSH_HOST_PUBLIC_KEY_MD5
Introduced in 7.17.1
.IP CURLOPT_SSH_HOST_PUBLIC_KEY_SHA256
Introduced in 7.80.0
.IP CURLOPT_SSH_HOSTKEYDATA
Introduced in 7.84.0
.IP CURLOPT_SSH_HOSTKEYFUNCTION
Introduced in 7.84.0
.IP CURLOPT_SSH_KEYDATA
Introduced in 7.19.6
.IP CURLOPT_SSH_KEYFUNCTION
Introduced in 7.19.6
.IP CURLOPT_SSH_KNOWNHOSTS
Introduced in 7.19.6
.IP CURLOPT_SSH_PRIVATE_KEYFILE
Introduced in 7.16.1
.IP CURLOPT_SSH_PUBLIC_KEYFILE
Introduced in 7.16.1
.IP CURLOPT_SSL_CIPHER_LIST
Introduced in 7.9
.IP CURLOPT_SSL_CTX_DATA
Introduced in 7.10.6
.IP CURLOPT_SSL_CTX_FUNCTION
Introduced in 7.10.6
.IP CURLOPT_SSL_EC_CURVES
Introduced in 7.73.0
.IP CURLOPT_SSL_ENABLE_ALPN
Introduced in 7.36.0
.IP CURLOPT_SSL_ENABLE_NPN
Introduced in 7.36.0
Deprecated since 7.86.0
.IP CURLOPT_SSL_FALSESTART
Introduced in 7.42.0
.IP CURLOPT_SSL_OPTIONS
Introduced in 7.25.0
.IP CURLOPT_SSL_SESSIONID_CACHE
Introduced in 7.16.0
.IP CURLOPT_SSL_VERIFYHOST
Introduced in 7.8.1
.IP CURLOPT_SSL_VERIFYPEER
Introduced in 7.4.2
.IP CURLOPT_SSL_VERIFYSTATUS
Introduced in 7.41.0
.IP CURLOPT_SSLCERT
Introduced in 7.1
.IP CURLOPT_SSLCERT_BLOB
Introduced in 7.71.0
.IP CURLOPT_SSLCERTPASSWD
Introduced in 7.1.1
Deprecated since 7.17.0
.IP CURLOPT_SSLCERTTYPE
Introduced in 7.9.3
.IP CURLOPT_SSLENGINE
Introduced in 7.9.3
.IP CURLOPT_SSLENGINE_DEFAULT
Introduced in 7.9.3
.IP CURLOPT_SSLKEY
Introduced in 7.9.3
.IP CURLOPT_SSLKEY_BLOB
Introduced in 7.71.0
.IP CURLOPT_SSLKEYPASSWD
Introduced in 7.9.3
Deprecated since 7.17.0
.IP CURLOPT_SSLKEYTYPE
Introduced in 7.9.3
.IP CURLOPT_SSLVERSION
Introduced in 7.1
.IP CURLOPT_STDERR
Introduced in 7.1
.IP CURLOPT_STREAM_DEPENDS
Introduced in 7.46.0
.IP CURLOPT_STREAM_DEPENDS_E
Introduced in 7.46.0
.IP CURLOPT_STREAM_WEIGHT
Introduced in 7.46.0
.IP CURLOPT_SUPPRESS_CONNECT_HEADERS
Introduced in 7.54.0
.IP CURLOPT_TCP_FASTOPEN
Introduced in 7.49.0
.IP CURLOPT_TCP_KEEPALIVE
Introduced in 7.25.0
.IP CURLOPT_TCP_KEEPIDLE
Introduced in 7.25.0
.IP CURLOPT_TCP_KEEPINTVL
Introduced in 7.25.0
.IP CURLOPT_TCP_NODELAY
Introduced in 7.11.2
.IP CURLOPT_TELNETOPTIONS
Introduced in 7.7
.IP CURLOPT_TFTP_BLKSIZE
Introduced in 7.19.4
.IP CURLOPT_TFTP_NO_OPTIONS
Introduced in 7.48.0
.IP CURLOPT_TIMECONDITION
Introduced in 7.1
.IP CURLOPT_TIMEOUT
Introduced in 7.1
.IP CURLOPT_TIMEOUT_MS
Introduced in 7.16.2
.IP CURLOPT_TIMEVALUE
Introduced in 7.1
.IP CURLOPT_TIMEVALUE_LARGE
Introduced in 7.59.0
.IP CURLOPT_TLS13_CIPHERS
Introduced in 7.61.0
.IP CURLOPT_TLSAUTH_PASSWORD
Introduced in 7.21.4
.IP CURLOPT_TLSAUTH_TYPE
Introduced in 7.21.4
.IP CURLOPT_TLSAUTH_USERNAME
Introduced in 7.21.4
.IP CURLOPT_TRAILERDATA
Introduced in 7.64.0
.IP CURLOPT_TRAILERFUNCTION
Introduced in 7.64.0
.IP CURLOPT_TRANSFER_ENCODING
Introduced in 7.21.6
.IP CURLOPT_TRANSFERTEXT
Introduced in 7.1.1
.IP CURLOPT_UNIX_SOCKET_PATH
Introduced in 7.40.0
.IP CURLOPT_UNRESTRICTED_AUTH
Introduced in 7.10.4
.IP CURLOPT_UPKEEP_INTERVAL_MS
Introduced in 7.62.0
.IP CURLOPT_UPLOAD
Introduced in 7.1
.IP CURLOPT_UPLOAD_BUFFERSIZE
Introduced in 7.62.0
.IP CURLOPT_URL
Introduced in 7.1
.IP CURLOPT_USE_SSL
Introduced in 7.17.0
.IP CURLOPT_USERAGENT
Introduced in 7.1
.IP CURLOPT_USERNAME
Introduced in 7.19.1
.IP CURLOPT_USERPWD
Introduced in 7.1
.IP CURLOPT_VERBOSE
Introduced in 7.1
.IP CURLOPT_WILDCARDMATCH
Introduced in 7.21.0
.IP CURLOPT_WRITEDATA
Introduced in 7.9.7
.IP CURLOPT_WRITEFUNCTION
Introduced in 7.1
.IP CURLOPT_WRITEHEADER
Introduced in 7.1
.IP CURLOPT_WRITEINFO
Introduced in 7.1
.IP CURLOPT_WS_OPTIONS
Introduced in 7.86.0
.IP CURLOPT_XFERINFODATA
Introduced in 7.32.0
.IP CURLOPT_XFERINFOFUNCTION
Introduced in 7.32.0
.IP CURLOPT_XOAUTH2_BEARER
Introduced in 7.33.0
.IP CURLOPTDEPRECATED
Introduced in 7.87.0
.IP CURLOPTTYPE_BLOB
Introduced in 7.71.0
.IP CURLOPTTYPE_CBPOINT
Introduced in 7.73.0
.IP CURLOPTTYPE_FUNCTIONPOINT
Introduced in 7.1
.IP CURLOPTTYPE_LONG
Introduced in 7.1
.IP CURLOPTTYPE_OBJECTPOINT
Introduced in 7.1
.IP CURLOPTTYPE_OFF_T
Introduced in 7.11.0
.IP CURLOPTTYPE_SLISTPOINT
Introduced in 7.65.2
.IP CURLOPTTYPE_STRINGPOINT
Introduced in 7.46.0
.IP CURLOPTTYPE_VALUES
Introduced in 7.73.0
.IP CURLOT_BLOB
Introduced in 7.73.0
.IP CURLOT_CBPTR
Introduced in 7.73.0
.IP CURLOT_FLAG_ALIAS
Introduced in 7.73.0
.IP CURLOT_FUNCTION
Introduced in 7.73.0
.IP CURLOT_LONG
Introduced in 7.73.0
.IP CURLOT_OBJECT
Introduced in 7.73.0
.IP CURLOT_OFF_T
Introduced in 7.73.0
.IP CURLOT_SLIST
Introduced in 7.73.0
.IP CURLOT_STRING
Introduced in 7.73.0
.IP CURLOT_VALUES
Introduced in 7.73.0
.IP CURLPAUSE_ALL
Introduced in 7.18.0
.IP CURLPAUSE_CONT
Introduced in 7.18.0
.IP CURLPAUSE_RECV
Introduced in 7.18.0
.IP CURLPAUSE_RECV_CONT
Introduced in 7.18.0
.IP CURLPAUSE_SEND
Introduced in 7.18.0
.IP CURLPAUSE_SEND_CONT
Introduced in 7.18.0
.IP CURLPIPE_HTTP1
Introduced in 7.43.0
.IP CURLPIPE_MULTIPLEX
Introduced in 7.43.0
.IP CURLPIPE_NOTHING
Introduced in 7.43.0
.IP CURLPROTO_ALL
Introduced in 7.19.4
.IP CURLPROTO_DICT
Introduced in 7.19.4
.IP CURLPROTO_FILE
Introduced in 7.19.4
.IP CURLPROTO_FTP
Introduced in 7.19.4
.IP CURLPROTO_FTPS
Introduced in 7.19.4
.IP CURLPROTO_GOPHER
Introduced in 7.21.2
.IP CURLPROTO_GOPHERS
Introduced in 7.75.0
.IP CURLPROTO_HTTP
Introduced in 7.19.4
.IP CURLPROTO_HTTPS
Introduced in 7.19.4
.IP CURLPROTO_IMAP
Introduced in 7.20.0
.IP CURLPROTO_IMAPS
Introduced in 7.20.0
.IP CURLPROTO_LDAP
Introduced in 7.19.4
.IP CURLPROTO_LDAPS
Introduced in 7.19.4
.IP CURLPROTO_MQTT
Introduced in 7.71.0
.IP CURLPROTO_POP3
Introduced in 7.20.0
.IP CURLPROTO_POP3S
Introduced in 7.20.0
.IP CURLPROTO_RTMP
Introduced in 7.21.0
.IP CURLPROTO_RTMPE
Introduced in 7.21.0
.IP CURLPROTO_RTMPS
Introduced in 7.21.0
.IP CURLPROTO_RTMPT
Introduced in 7.21.0
.IP CURLPROTO_RTMPTE
Introduced in 7.21.0
.IP CURLPROTO_RTMPTS
Introduced in 7.21.0
.IP CURLPROTO_RTSP
Introduced in 7.20.0
.IP CURLPROTO_SCP
Introduced in 7.19.4
.IP CURLPROTO_SFTP
Introduced in 7.19.4
.IP CURLPROTO_SMB
Introduced in 7.40.0
.IP CURLPROTO_SMBS
Introduced in 7.40.0
.IP CURLPROTO_SMTP
Introduced in 7.20.0
.IP CURLPROTO_SMTPS
Introduced in 7.20.0
.IP CURLPROTO_TELNET
Introduced in 7.19.4
.IP CURLPROTO_TFTP
Introduced in 7.19.4
.IP CURLPROXY_HTTP
Introduced in 7.10
.IP CURLPROXY_HTTP_1_0
Introduced in 7.19.4
.IP CURLPROXY_HTTPS
Introduced in 7.52.0
.IP CURLPROXY_HTTPS2
Introduced in 8.1.0
.IP CURLPROXY_SOCKS4
Introduced in 7.10
.IP CURLPROXY_SOCKS4A
Introduced in 7.18.0
.IP CURLPROXY_SOCKS5
Introduced in 7.10
.IP CURLPROXY_SOCKS5_HOSTNAME
Introduced in 7.18.0
.IP CURLPX_BAD_ADDRESS_TYPE
Introduced in 7.73.0
.IP CURLPX_BAD_VERSION
Introduced in 7.73.0
.IP CURLPX_CLOSED
Introduced in 7.73.0
.IP CURLPX_GSSAPI
Introduced in 7.73.0
.IP CURLPX_GSSAPI_PERMSG
Introduced in 7.73.0
.IP CURLPX_GSSAPI_PROTECTION
Introduced in 7.73.0
.IP CURLPX_IDENTD
Introduced in 7.73.0
.IP CURLPX_IDENTD_DIFFER
Introduced in 7.73.0
.IP CURLPX_LONG_HOSTNAME
Introduced in 7.73.0
.IP CURLPX_LONG_PASSWD
Introduced in 7.73.0
.IP CURLPX_LONG_USER
Introduced in 7.73.0
.IP CURLPX_NO_AUTH
Introduced in 7.73.0
.IP CURLPX_OK
Introduced in 7.73.0
.IP CURLPX_RECV_ADDRESS
Introduced in 7.73.0
.IP CURLPX_RECV_AUTH
Introduced in 7.73.0
.IP CURLPX_RECV_CONNECT
Introduced in 7.73.0
.IP CURLPX_RECV_REQACK
Introduced in 7.73.0
.IP CURLPX_REPLY_ADDRESS_TYPE_NOT_SUPPORTED
Introduced in 7.73.0
.IP CURLPX_REPLY_COMMAND_NOT_SUPPORTED
Introduced in 7.73.0
.IP CURLPX_REPLY_CONNECTION_REFUSED
Introduced in 7.73.0
.IP CURLPX_REPLY_GENERAL_SERVER_FAILURE
Introduced in 7.73.0
.IP CURLPX_REPLY_HOST_UNREACHABLE
Introduced in 7.73.0
.IP CURLPX_REPLY_NETWORK_UNREACHABLE
Introduced in 7.73.0
.IP CURLPX_REPLY_NOT_ALLOWED
Introduced in 7.73.0
.IP CURLPX_REPLY_TTL_EXPIRED
Introduced in 7.73.0
.IP CURLPX_REPLY_UNASSIGNED
Introduced in 7.73.0
.IP CURLPX_REQUEST_FAILED
Introduced in 7.73.0
.IP CURLPX_RESOLVE_HOST
Introduced in 7.73.0
.IP CURLPX_SEND_AUTH
Introduced in 7.73.0
.IP CURLPX_SEND_CONNECT
Introduced in 7.73.0
.IP CURLPX_SEND_REQUEST
Introduced in 7.73.0
.IP CURLPX_UNKNOWN_FAIL
Introduced in 7.73.0
.IP CURLPX_UNKNOWN_MODE
Introduced in 7.73.0
.IP CURLPX_USER_REJECTED
Introduced in 7.73.0
.IP CURLSHE_BAD_OPTION
Introduced in 7.10.3
.IP CURLSHE_IN_USE
Introduced in 7.10.3
.IP CURLSHE_INVALID
Introduced in 7.10.3
.IP CURLSHE_NOMEM
Introduced in 7.12.0
.IP CURLSHE_NOT_BUILT_IN
Introduced in 7.23.0
.IP CURLSHE_OK
Introduced in 7.10.3
.IP CURLSHOPT_LOCKFUNC
Introduced in 7.10.3
.IP CURLSHOPT_NONE
Introduced in 7.10.3
.IP CURLSHOPT_SHARE
Introduced in 7.10.3
.IP CURLSHOPT_UNLOCKFUNC
Introduced in 7.10.3
.IP CURLSHOPT_UNSHARE
Introduced in 7.10.3
.IP CURLSHOPT_USERDATA
Introduced in 7.10.3
.IP CURLSOCKTYPE_ACCEPT
Introduced in 7.28.0
.IP CURLSOCKTYPE_IPCXN
Introduced in 7.16.0
.IP CURLSSH_AUTH_AGENT
Introduced in 7.28.0
.IP CURLSSH_AUTH_ANY
Introduced in 7.16.1
.IP CURLSSH_AUTH_DEFAULT
Introduced in 7.16.1
.IP CURLSSH_AUTH_GSSAPI
Introduced in 7.58.0
.IP CURLSSH_AUTH_HOST
Introduced in 7.16.1
.IP CURLSSH_AUTH_KEYBOARD
Introduced in 7.16.1
.IP CURLSSH_AUTH_NONE
Introduced in 7.16.1
.IP CURLSSH_AUTH_PASSWORD
Introduced in 7.16.1
.IP CURLSSH_AUTH_PUBLICKEY
Introduced in 7.16.1
.IP CURLSSLBACKEND_AWSLC
Introduced in 8.1.0
.IP CURLSSLBACKEND_AXTLS
Introduced in 7.38.0
Deprecated since 7.61.0
.IP CURLSSLBACKEND_BEARSSL
Introduced in 7.68.0
.IP CURLSSLBACKEND_BORINGSSL
Introduced in 7.49.0
.IP CURLSSLBACKEND_CYASSL
Introduced in 7.34.0
.IP CURLSSLBACKEND_DARWINSSL
Introduced in 7.34.0
Deprecated since 7.64.1
.IP CURLSSLBACKEND_GNUTLS
Introduced in 7.34.0
.IP CURLSSLBACKEND_GSKIT
Introduced in 7.34.0
.IP CURLSSLBACKEND_LIBRESSL
Introduced in 7.49.0
.IP CURLSSLBACKEND_MBEDTLS
Introduced in 7.46.0
.IP CURLSSLBACKEND_MESALINK
Introduced in 7.62.0
.IP CURLSSLBACKEND_NONE
Introduced in 7.34.0
.IP CURLSSLBACKEND_NSS
Introduced in 7.34.0
.IP CURLSSLBACKEND_OPENSSL
Introduced in 7.34.0
.IP CURLSSLBACKEND_POLARSSL
Introduced in 7.34.0
Deprecated since 7.69.0
.IP CURLSSLBACKEND_QSOSSL
Introduced in 7.34.0
.IP CURLSSLBACKEND_RUSTLS
Introduced in 7.76.0
.IP CURLSSLBACKEND_SCHANNEL
Introduced in 7.34.0
.IP CURLSSLBACKEND_SECURETRANSPORT
Introduced in 7.64.1
.IP CURLSSLBACKEND_WOLFSSL
Introduced in 7.49.0
.IP CURLSSLOPT_ALLOW_BEAST
Introduced in 7.25.0
.IP CURLSSLOPT_AUTO_CLIENT_CERT
Introduced in 7.77.0
.IP CURLSSLOPT_NATIVE_CA
Introduced in 7.71.0
.IP CURLSSLOPT_NO_PARTIALCHAIN
Introduced in 7.68.0
.IP CURLSSLOPT_NO_REVOKE
Introduced in 7.44.0
.IP CURLSSLOPT_REVOKE_BEST_EFFORT
Introduced in 7.70.0
.IP CURLSSLSET_NO_BACKENDS
Introduced in 7.56.0
.IP CURLSSLSET_OK
Introduced in 7.56.0
.IP CURLSSLSET_TOO_LATE
Introduced in 7.56.0
.IP CURLSSLSET_UNKNOWN_BACKEND
Introduced in 7.56.0
.IP CURLSTS_DONE
Introduced in 7.74.0
.IP CURLSTS_FAIL
Introduced in 7.74.0
.IP CURLSTS_OK
Introduced in 7.74.0
.IP CURLU_ALLOW_SPACE
Introduced in 7.78.0
.IP CURLU_APPENDQUERY
Introduced in 7.62.0
.IP CURLU_DEFAULT_PORT
Introduced in 7.62.0
.IP CURLU_DEFAULT_SCHEME
Introduced in 7.62.0
.IP CURLU_DISALLOW_USER
Introduced in 7.62.0
.IP CURLU_GUESS_SCHEME
Introduced in 7.62.0
.IP CURLU_NO_AUTHORITY
Introduced in 7.67.0
.IP CURLU_NO_DEFAULT_PORT
Introduced in 7.62.0
.IP CURLU_NON_SUPPORT_SCHEME
Introduced in 7.62.0
.IP CURLU_PATH_AS_IS
Introduced in 7.62.0
.IP CURLU_PUNY2IDN
Introduced in 8.3.0
.IP CURLU_PUNYCODE
Introduced in 7.88.0
.IP CURLU_URLDECODE
Introduced in 7.62.0
.IP CURLU_URLENCODE
Introduced in 7.62.0
.IP CURLUE_BAD_FILE_URL
Introduced in 7.81.0
.IP CURLUE_BAD_FRAGMENT
Introduced in 7.81.0
.IP CURLUE_BAD_HANDLE
Introduced in 7.62.0
.IP CURLUE_BAD_HOSTNAME
Introduced in 7.81.0
.IP CURLUE_BAD_IPV6
Introduced in 7.81.0
.IP CURLUE_BAD_LOGIN
Introduced in 7.81.0
.IP CURLUE_BAD_PARTPOINTER
Introduced in 7.62.0
.IP CURLUE_BAD_PASSWORD
Introduced in 7.81.0
.IP CURLUE_BAD_PATH
Introduced in 7.81.0
.IP CURLUE_BAD_PORT_NUMBER
Introduced in 7.62.0
.IP CURLUE_BAD_QUERY
Introduced in 7.81.0
.IP CURLUE_BAD_SCHEME
Introduced in 7.81.0
.IP CURLUE_BAD_SLASHES
Introduced in 7.81.0
.IP CURLUE_BAD_USER
Introduced in 7.81.0
.IP CURLUE_LACKS_IDN
Introduced in 7.88.0
.IP CURLUE_MALFORMED_INPUT
Introduced in 7.62.0
.IP CURLUE_NO_FRAGMENT
Introduced in 7.62.0
.IP CURLUE_NO_HOST
Introduced in 7.62.0
.IP CURLUE_NO_OPTIONS
Introduced in 7.62.0
.IP CURLUE_NO_PASSWORD
Introduced in 7.62.0
.IP CURLUE_NO_PORT
Introduced in 7.62.0
.IP CURLUE_NO_QUERY
Introduced in 7.62.0
.IP CURLUE_NO_SCHEME
Introduced in 7.62.0
.IP CURLUE_NO_USER
Introduced in 7.62.0
.IP CURLUE_NO_ZONEID
Introduced in 7.81.0
.IP CURLUE_OK
Introduced in 7.62.0
.IP CURLUE_OUT_OF_MEMORY
Introduced in 7.62.0
.IP CURLUE_UNKNOWN_PART
Introduced in 7.62.0
.IP CURLUE_UNSUPPORTED_SCHEME
Introduced in 7.62.0
.IP CURLUE_URLDECODE
Introduced in 7.62.0
.IP CURLUE_USER_NOT_ALLOWED
Introduced in 7.62.0
.IP CURLUPART_FRAGMENT
Introduced in 7.62.0
.IP CURLUPART_HOST
Introduced in 7.62.0
.IP CURLUPART_OPTIONS
Introduced in 7.62.0
.IP CURLUPART_PASSWORD
Introduced in 7.62.0
.IP CURLUPART_PATH
Introduced in 7.62.0
.IP CURLUPART_PORT
Introduced in 7.62.0
.IP CURLUPART_QUERY
Introduced in 7.62.0
.IP CURLUPART_SCHEME
Introduced in 7.62.0
.IP CURLUPART_URL
Introduced in 7.62.0
.IP CURLUPART_USER
Introduced in 7.62.0
.IP CURLUPART_ZONEID
Introduced in 7.65.0
.IP CURLUSESSL_ALL
Introduced in 7.17.0
.IP CURLUSESSL_CONTROL
Introduced in 7.17.0
.IP CURLUSESSL_NONE
Introduced in 7.17.0
.IP CURLUSESSL_TRY
Introduced in 7.17.0
.IP CURLVERSION_EIGHTH
Introduced in 7.72.0
.IP CURLVERSION_ELEVENTH
Introduced in 7.87.0
.IP CURLVERSION_FIFTH
Introduced in 7.57.0
.IP CURLVERSION_FIRST
Introduced in 7.10
.IP CURLVERSION_FOURTH
Introduced in 7.16.1
.IP CURLVERSION_NINTH
Introduced in 7.75.0
.IP CURLVERSION_NOW
Introduced in 7.10
.IP CURLVERSION_SECOND
Introduced in 7.11.1
.IP CURLVERSION_SEVENTH
Introduced in 7.70.0
.IP CURLVERSION_SIXTH
Introduced in 7.66.0
.IP CURLVERSION_TENTH
Introduced in 7.77.0
.IP CURLVERSION_THIRD
Introduced in 7.12.0
.IP CURLWARNING
Introduced in 7.66.0
.IP CURLWS_BINARY
Introduced in 7.86.0
.IP CURLWS_CLOSE
Introduced in 7.86.0
.IP CURLWS_CONT
Introduced in 7.86.0
.IP CURLWS_OFFSET
Introduced in 7.86.0
.IP CURLWS_PING
Introduced in 7.86.0
.IP CURLWS_PONG
Introduced in 7.86.0
.IP CURLWS_RAW_MODE
Introduced in 7.86.0
.IP CURLWS_TEXT
Introduced in 7.86.0
man/man3/curl_multi_fdset.3 0000644 00000011215 14751172371 0011615 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.TH curl_multi_fdset 3 "September 26, 2023" "libcurl 8.4.0" "libcurl"
.SH NAME
curl_multi_fdset - extracts file descriptor information from a multi handle
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLMcode curl_multi_fdset(CURLM *multi_handle,
fd_set *read_fd_set,
fd_set *write_fd_set,
fd_set *exc_fd_set,
int *max_fd);
.ad
.SH DESCRIPTION
This function extracts file descriptor information from a given multi_handle.
libcurl returns its \fIfd_set\fP sets. The application can use these to
select() on, but be sure to \fIFD_ZERO\fP them before calling this function as
\fIcurl_multi_fdset(3)\fP only adds its own descriptors, it does not zero or
otherwise remove any others. The \fIcurl_multi_perform(3)\fP function should
be called as soon as one of them is ready to be read from or written to.
If the \fIread_fd_set\fP argument is not a null pointer, it points to an
object of type \fBfd_set\fP that on returns specifies the file descriptors to
be checked for being ready to read.
If the \fIwrite_fd_set\fP argument is not a null pointer, it points to an
object of type \fBfd_set\fP that on return specifies the file descriptors to
be checked for being ready to write.
If the \fIexc_fd_set\fP argument is not a null pointer, it points to an object
of type \fBfd_set\fP that on return specifies the file descriptors to be
checked for error conditions pending.
If no file descriptors are set by libcurl, \fImax_fd\fP contain -1 when this
function returns. Otherwise it contains the highest descriptor number libcurl
set. When libcurl returns -1 in \fImax_fd\fP, it is because libcurl currently
does something that is not possible for your application to monitor with a
socket and unfortunately you can then not know exactly when the current action
is completed using select(). You then need to wait a while before you proceed
and call \fIcurl_multi_perform(3)\fP anyway. How long to wait? Unless
\fIcurl_multi_timeout(3)\fP gives you a lower number, we suggest 100
milliseconds or so, but you may want to test it out in your own particular
conditions to find a suitable value.
When doing select(), you should use \fIcurl_multi_timeout(3)\fP to figure out
how long to wait for action. Call \fIcurl_multi_perform(3)\fP even if no
activity has been seen on the \fBfd_sets\fP after the timeout expires as
otherwise internal retries and timeouts may not work as you would think and
want.
If one of the sockets used by libcurl happens to be larger than what can be
set in an \fBfd_set\fP, which on POSIX systems means that the file descriptor
is larger than \fBFD_SETSIZE\fP, then libcurl tries to not set it. Setting a
too large file descriptor in an \fBfd_set\fP implies an out of bounds write
which can cause crashes, or worse. The effect of NOT storing it might possibly
save you from the crash, but makes your program NOT wait for sockets it should
wait for...
.SH EXAMPLE
.nf
/* get file descriptors from the transfers */
mc = curl_multi_fdset(multi_handle, &fdread, &fdwrite, &fdexcep, &maxfd);
if(mc != CURLM_OK) {
fprintf(stderr, "curl_multi_fdset() failed, code %d.\\n", mc);
break;
}
/* wait for activity on one of the sockets */
rc = select(maxfd + 1, &fdread, &fdwrite, &fdexcep, &timeout);
.fi
.SH AVAILABILITY
Added in 7.9.6
.SH RETURN VALUE
\fBCURLMcode\fP type, general libcurl multi interface error code. See
\fIlibcurl-errors(3)\fP
.SH "SEE ALSO"
.BR curl_multi_cleanup (3),
.BR curl_multi_init (3),
.BR curl_multi_perform (3),
.BR curl_multi_timeout (3),
.BR curl_multi_wait (3),
.BR select (2)
man/man3/CURLOPT_SERVICE_NAME.3 0000644 00000004523 14751172371 0011365 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_SERVICE_NAME 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_SERVICE_NAME \- authentication service name
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_SERVICE_NAME, char *name);
.fi
.SH DESCRIPTION
Pass a char * as parameter to a string holding the \fIname\fP of the service
for DIGEST-MD5, SPNEGO and Kerberos 5 authentication mechanisms. The default
service names are "ftp", "HTTP", "imap", "ldap", "pop" and "smtp". This option
allows you to change them.
The application does not have to keep the string around after setting this
option.
.SH DEFAULT
See above
.SH PROTOCOLS
HTTP, FTP, IMAP, LDAP, POP3 and SMTP
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
CURLcode ret;
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/");
curl_easy_setopt(curl, CURLOPT_SERVICE_NAME, "custom");
ret = curl_easy_perform(curl);
}
.fi
.SH AVAILABILITY
Added in 7.43.0 for HTTP, 7.49.0 for FTP, IMAP, POP3 and SMTP,
7.82.0 for OpenLDAP.
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, CURLE_UNKNOWN_OPTION if not, or
CURLE_OUT_OF_MEMORY if there was insufficient heap space.
.SH "SEE ALSO"
.BR CURLOPT_PROXY (3),
.BR CURLOPT_PROXY_SERVICE_NAME (3),
.BR CURLOPT_PROXYTYPE (3)
man/man3/CURLOPT_LOCALPORTRANGE.3 0000644 00000004640 14751172371 0011601 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_LOCALPORTRANGE 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_LOCALPORTRANGE \- number of additional local ports to try
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_LOCALPORTRANGE,
long range);
.fi
.SH DESCRIPTION
Pass a long. The \fIrange\fP argument is the number of attempts libcurl makes
to find a working local port number. It starts with the given
\fICURLOPT_LOCALPORT(3)\fP and adds one to the number for each retry. Setting
this option to 1 or below makes libcurl only do one try for the exact port
number. Port numbers by nature are scarce resources that are busy at times so
setting this value to something too low might cause unnecessary connection
setup failures.
.SH DEFAULT
1
.SH PROTOCOLS
All
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/foo.bin");
curl_easy_setopt(curl, CURLOPT_LOCALPORT, 49152L);
/* and try 20 more ports following that */
curl_easy_setopt(curl, CURLOPT_LOCALPORTRANGE, 20L);
ret = curl_easy_perform(curl);
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Added in 7.15.2
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR CURLOPT_INTERFACE (3),
.BR CURLOPT_LOCALPORT (3)
man/man3/CURLOPT_TRAILERFUNCTION.3 0000644 00000007400 14751172371 0011732 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_TRAILERFUNCTION 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_TRAILERFUNCTION \- callback for sending trailing headers
.SH SYNOPSIS
.nf
#include <curl.h>
int curl_trailer_callback(struct curl_slist ** list, void *userdata);
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_TRAILERFUNCTION,
curl_trailer_callback *func);
.fi
.SH DESCRIPTION
Pass a pointer to a callback function.
This callback function is called once right before sending the final CR LF in
an HTTP chunked transfer to fill a list of trailing headers to be sent before
finishing the HTTP transfer.
You can set the userdata argument with the \fICURLOPT_TRAILERDATA(3)\fP
option.
The trailing headers included in the linked list must not be CRLF-terminated,
because libcurl adds the appropriate line termination characters after each
header item.
If you use curl_slist_append to add trailing headers to the curl_slist then
libcurl duplicates the strings, and frees the curl_slist and the duplicates
once the trailers have been sent.
If one of the trailing header fields is not formatted correctly it is ignored
and an info message is emitted.
The return value can either be \fBCURL_TRAILERFUNC_OK\fP or
\fBCURL_TRAILERFUNC_ABORT\fP which would respectively instruct libcurl to
either continue with sending the trailers or to abort the request.
If you set this option to NULL, then the transfer proceeds as usual
without any interruptions.
.SH DEFAULT
NULL
.SH PROTOCOLS
HTTP
.SH EXAMPLE
#include <curl/curl.h>
static int trailer_cb(struct curl_slist **tr, void *data)
{
/* libcurl frees the list */
*tr = curl_slist_append(*tr, "My-super-awesome-trailer: trailer-stuff");
return CURL_TRAILERFUNC_OK;
}
CURL *curl = curl_easy_init();
if(curl) {
/* Set the URL of the request */
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/");
/* Now set it as a put */
curl_easy_setopt(curl, CURLOPT_PUT, 1L);
/* Assuming we have a function that returns the data to be pushed
Let that function be read_cb */
curl_easy_setopt(curl, CURLOPT_READFUNCTION, read_cb);
struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Trailer: My-super-awesome-trailer");
res = curl_easy_setopt(curl, CURLOPT_HTTPHEADER, headers);
/* Set the trailers filling callback */
curl_easy_setopt(curl, CURLOPT_TRAILERFUNCTION, trailer_cb);
/* Perform the transfer */
res = curl_easy_perform(curl);
curl_easy_cleanup(curl);
curl_slist_free_all(headers);
}
.SH AVAILABILITY
This option was added in curl 7.64.0 and is present if HTTP support is enabled
.SH RETURN VALUE
Returns CURLE_OK.
.SH "SEE ALSO"
.BR CURLOPT_TRAILERDATA (3),
.BR CURLOPT_WRITEFUNCTION (3)
man/man3/curl_easy_unescape.3 0000644 00000005600 14751172371 0012123 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH curl_easy_unescape 3 "September 26, 2023" "libcurl 8.4.0" "libcurl"
.SH NAME
curl_easy_unescape - URL decodes the given string
.SH SYNOPSIS
.nf
#include <curl/curl.h>
char *curl_easy_unescape(CURL *curl, const char *input,
int inlength, int *outlength);
.fi
.SH DESCRIPTION
This function converts the URL encoded string \fBinput\fP to a "plain string"
and returns that in an allocated memory area. All input characters that are URL
encoded (%XX where XX is a two-digit hexadecimal number) are converted to their
binary versions.
If the \fBlength\fP argument is set to 0 (zero), \fIcurl_easy_unescape(3)\fP
uses strlen() on \fBinput\fP to find out the size.
If \fBoutlength\fP is non-NULL, the function writes the length of the returned
string in the integer it points to. This allows proper handling even for
strings containing %00. Since this is a pointer to an \fIint\fP type, it can
only return a value up to \fIINT_MAX\fP so no longer string can be returned in
this parameter.
Since 7.82.0, the \fBcurl\fP parameter is ignored. Prior to that there was
per-handle character conversion support for some old operating systems such as
TPF, but it was otherwise ignored.
You must \fIcurl_free(3)\fP the returned string when you are done with it.
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
int decodelen;
char *decoded = curl_easy_unescape(curl, "%63%75%72%6c", 12, &decodelen);
if(decoded) {
/* do not assume printf() works on the decoded data! */
printf("Decoded: ");
/* ... */
curl_free(decoded);
}
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Added in 7.15.4 and replaces the old \fIcurl_unescape(3)\fP function.
.SH RETURN VALUE
A pointer to a null-terminated string or NULL if it failed.
.SH "SEE ALSO"
.BR curl_easy_escape (3),
.BR curl_free (3)
man/man3/CURLOPT_KEYPASSWD.3 0000644 00000004724 14751172371 0011042 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_KEYPASSWD 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_KEYPASSWD \- passphrase to private key
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_KEYPASSWD, char *pwd);
.fi
.SH DESCRIPTION
Pass a pointer to a null-terminated string as parameter. It is used as the
password required to use the \fICURLOPT_SSLKEY(3)\fP or
\fICURLOPT_SSH_PRIVATE_KEYFILE(3)\fP private key. You never need a pass
phrase to load a certificate but you need one to load your private key.
The application does not have to keep the string around after setting this
option.
.SH DEFAULT
NULL
.SH PROTOCOLS
All TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc.
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/foo.bin");
curl_easy_setopt(curl, CURLOPT_SSLCERT, "client.pem");
curl_easy_setopt(curl, CURLOPT_SSLKEY, "key.pem");
curl_easy_setopt(curl, CURLOPT_KEYPASSWD, "superman");
ret = curl_easy_perform(curl);
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
This option was known as CURLOPT_SSLKEYPASSWD up to 7.16.4 and
CURLOPT_SSLCERTPASSWD up to 7.9.2.
.SH RETURN VALUE
Returns CURLE_OK if TLS enabled, CURLE_UNKNOWN_OPTION if not, or
CURLE_OUT_OF_MEMORY if there was insufficient heap space.
.SH "SEE ALSO"
.BR CURLOPT_SSH_PRIVATE_KEYFILE (3),
.BR CURLOPT_SSLKEY (3)
man/man3/CURLOPT_MAIL_RCPT.3 0000644 00000005717 14751172371 0011045 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_MAIL_RCPT 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_MAIL_RCPT \- list of SMTP mail recipients
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_MAIL_RCPT,
struct curl_slist *rcpts);
.SH DESCRIPTION
Pass a pointer to a linked list of recipients to pass to the server in your
SMTP mail request. The linked list should be a fully valid list of
\fBstruct curl_slist\fP structs properly filled in. Use
\fIcurl_slist_append(3)\fP to create the list and \fIcurl_slist_free_all(3)\fP
to clean up an entire list.
When performing a mail transfer, each recipient should be specified within a
pair of angled brackets (<>), however, should you not use an angled bracket as
the first character libcurl assumes you provided a single email address and
encloses that address within brackets for you.
When performing an address verification (\fBVRFY\fP command), each recipient
should be specified as the user name or user name and domain (as per Section
3.5 of RFC 5321).
When performing a mailing list expand (\fBEXPN\fP command), each recipient
should be specified using the mailing list name, such as "Friends" or
"London-Office".
.SH DEFAULT
NULL
.SH PROTOCOLS
SMTP
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
struct curl_slist *list;
list = curl_slist_append(NULL, "root@localhost");
list = curl_slist_append(list, "person@example.com");
curl_easy_setopt(curl, CURLOPT_URL, "smtp://example.com/");
curl_easy_setopt(curl, CURLOPT_MAIL_RCPT, list);
ret = curl_easy_perform(curl);
curl_slist_free_all(list);
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Added in 7.20.0. The \fBVRFY\fP and \fBEXPN\fP logic was added in 7.34.0
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR CURLOPT_MAIL_AUTH (3),
.BR CURLOPT_MAIL_FROM (3)
man/man3/CURLINFO_APPCONNECT_TIME_T.3 0000644 00000005167 14751172371 0012316 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLINFO_APPCONNECT_TIME_T 3 "September 26, 2023" "libcurl 8.4.0" "libcurl"
.SH NAME
CURLINFO_APPCONNECT_TIME_T \- time until the SSL/SSH handshake completed
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_getinfo(CURL *handle, CURLINFO_APPCONNECT_TIME_T,
curl_off_t *timep);
.fi
.SH DESCRIPTION
Pass a pointer to a curl_off_t to receive the time, in microseconds, it took
from the start until the SSL/SSH connect/handshake to the remote host was
completed. This time is most often close to the
\fICURLINFO_PRETRANSFER_TIME_T(3)\fP time, except for cases such as HTTP
pipelining where the pretransfer time can be delayed due to waits in line for
the pipeline and more.
When a redirect is followed, the time from each request is added together.
See also the TIMES overview in the \fIcurl_easy_getinfo(3)\fP man page.
.SH PROTOCOLS
All
.SH EXAMPLE
.nf
curl = curl_easy_init();
if(curl) {
curl_off_t connect;
curl_easy_setopt(curl, CURLOPT_URL, url);
res = curl_easy_perform(curl);
if(CURLE_OK == res) {
res = curl_easy_getinfo(curl, CURLINFO_APPCONNECT_TIME_T, &connect);
if(CURLE_OK == res) {
printf("Time: %" CURL_FORMAT_CURL_OFF_T ".%06ld", connect / 1000000,
(long)(connect % 1000000));
}
}
/* always cleanup */
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Added in 7.61.0
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR curl_easy_getinfo (3),
.BR curl_easy_setopt (3),
.BR CURLINFO_APPCONNECT_TIME (3)
man/man3/CURLOPT_READFUNCTION.3 0000644 00000011120 14751172371 0011335 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_READFUNCTION 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_READFUNCTION \- read callback for data uploads
.SH SYNOPSIS
.nf
#include <curl/curl.h>
size_t read_callback(char *buffer, size_t size, size_t nitems, void *userdata);
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_READFUNCTION, read_callback);
.fi
.SH DESCRIPTION
Pass a pointer to your callback function, as the prototype shows above.
This callback function gets called by libcurl as soon as it needs to read data
in order to send it to the peer - like if you ask it to upload or post data to
the server. The data area pointed at by the pointer \fIbuffer\fP should be
filled up with at most \fIsize\fP multiplied with \fInitems\fP number of bytes
by your function. \fIsize\fP is always 1.
Set the \fIuserdata\fP argument with the \fICURLOPT_READDATA(3)\fP option.
Your function must return the actual number of bytes that it stored in the
data area pointed at by the pointer \fIbuffer\fP. Returning 0 signals
end-of-file to the library and causes it to stop the current transfer.
If you stop the current transfer by returning 0 "pre-maturely" (i.e before the
server expected it, like when you have said you would upload N bytes and you
upload less than N bytes), you may experience that the server "hangs" waiting
for the rest of the data that is not sent.
The read callback may return \fICURL_READFUNC_ABORT\fP to stop the current
operation immediately, resulting in a \fICURLE_ABORTED_BY_CALLBACK\fP error
code from the transfer.
The callback can return \fICURL_READFUNC_PAUSE\fP to cause reading from this
connection to pause. See \fIcurl_easy_pause(3)\fP for further details.
\fBBugs\fP: when doing TFTP uploads, you must return the exact amount of data
that the callback wants, or it is considered the final packet by the server
end and the transfer ends there.
If you set this callback pointer to NULL, or do not set it at all, the default
internal read function is used. It is doing an fread() on the FILE * userdata
set with \fICURLOPT_READDATA(3)\fP.
You can set the total size of the data you are sending by using
\fICURLOPT_INFILESIZE_LARGE(3)\fP or \fICURLOPT_POSTFIELDSIZE_LARGE(3)\fP,
depending on the type of transfer. For some transfer types it may be required
and it allows for better error checking.
.SH DEFAULT
The default internal read callback is fread().
.SH PROTOCOLS
This is used for all protocols when doing uploads.
.SH EXAMPLE
.nf
size_t read_callback(char *ptr, size_t size, size_t nmemb, void *userdata)
{
FILE *readhere = (FILE *)userdata;
curl_off_t nread;
/* copy as much data as possible into the 'ptr' buffer, but no more than
'size' * 'nmemb' bytes! */
size_t retcode = fread(ptr, size, nmemb, readhere);
nread = (curl_off_t)retcode;
fprintf(stderr, "*** We read %" CURL_FORMAT_CURL_OFF_T
" bytes from file\\n", nread);
return retcode;
}
void setup(char *uploadthis)
{
FILE *file = fopen(uploadthis, "rb");
CURLcode result;
/* set callback to use */
curl_easy_setopt(curl, CURLOPT_READFUNCTION, read_callback);
/* pass in suitable argument to callback */
curl_easy_setopt(curl, CURLOPT_READDATA, (void *)file);
result = curl_easy_perform(curl);
}
.fi
.SH AVAILABILITY
CURL_READFUNC_PAUSE return code was added in 7.18.0 and CURL_READFUNC_ABORT
was added in 7.12.1.
.SH RETURN VALUE
This returns CURLE_OK.
.SH "SEE ALSO"
.BR CURLOPT_POST (3),
.BR CURLOPT_READDATA (3),
.BR CURLOPT_SEEKFUNCTION (3),
.BR CURLOPT_UPLOAD (3),
.BR CURLOPT_UPLOAD_BUFFERSIZE (3),
.BR CURLOPT_WRITEFUNCTION (3)
man/man3/libcurl-url.3 0000644 00000012633 14751172371 0010512 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.TH libcurl 3 "September 26, 2023" "libcurl 8.4.0" "libcurl"
.SH NAME
libcurl-url \- URL interface overview
.SH DESCRIPTION
The URL interface provides functions for parsing and generating URLs.
.SH INCLUDE
You still only include <curl/curl.h> in your code.
.SH CREATE
Create a handle that holds URL info and resources with \fIcurl_url(3)\fP:
.nf
CURLU *h = curl_url();
.fi
.SH CLEANUP
When done with it, clean it up with \fIcurl_url_cleanup(3)\fP
.nf
curl_url_cleanup(h);
.fi
.SH DUPLICATE
When you need a copy of a handle, just duplicate it with \fIcurl_url_dup(3)\fP:
.nf
CURLU *nh = curl_url_dup(h);
.fi
.SH PARSING
By setting a URL to the handle with \fIcurl_url_set(3)\fP, the URL is parsed
and stored in the handle. If the URL is not syntactically correct it returns
an error instead.
.nf
rc = curl_url_set(h, CURLUPART_URL,
"https://example.com:449/foo/bar?name=moo", 0);
.fi
The zero in the fourth argument is a bitmask for changing specific features.
If successful, this stores the URL in its individual parts within the handle.
.SH REDIRECT
When a handle already contains info about a URL, setting a relative URL makes
it "redirect" to that.
.nf
rc = curl_url_set(h, CURLUPART_URL, "../test?another", 0);
.fi
.SH "GET URL"
The \fBCURLU\fP handle represents a URL and you can easily extract that with
\fIcurl_url_get(3)\fP:
.nf
char *url;
rc = curl_url_get(h, CURLUPART_URL, &url, 0);
curl_free(url);
.fi
The zero in the fourth argument is a bitmask for changing specific features.
.SH "GET PARTS"
When a URL has been parsed or parts have been set, you can extract those
pieces from the handle at any time.
.nf
rc = curl_url_get(h, CURLUPART_FRAGMENT, &fragment, 0);
rc = curl_url_get(h, CURLUPART_HOST, &host, 0);
rc = curl_url_get(h, CURLUPART_PASSWORD, &password, 0);
rc = curl_url_get(h, CURLUPART_PATH, &path, 0);
rc = curl_url_get(h, CURLUPART_PORT, &port, 0);
rc = curl_url_get(h, CURLUPART_QUERY, &query, 0);
rc = curl_url_get(h, CURLUPART_SCHEME, &scheme, 0);
rc = curl_url_get(h, CURLUPART_USER, &user, 0);
rc = curl_url_get(h, CURLUPART_ZONEID, &zoneid, 0);
.fi
Extracted parts are not URL decoded unless the user also asks for it with the
\fICURLU_URLDECODE\fP flag set in the fourth bitmask argument.
Remember to free the returned string with \fIcurl_free(3)\fP when you are done
with it!
.SH "SET PARTS"
A user set individual URL parts, either after having parsed a full URL or
instead of parsing such.
.nf
rc = curl_url_set(urlp, CURLUPART_FRAGMENT, "anchor", 0);
rc = curl_url_set(urlp, CURLUPART_HOST, "www.example.com", 0);
rc = curl_url_set(urlp, CURLUPART_PASSWORD, "doe", 0);
rc = curl_url_set(urlp, CURLUPART_PATH, "/index.html", 0);
rc = curl_url_set(urlp, CURLUPART_PORT, "443", 0);
rc = curl_url_set(urlp, CURLUPART_QUERY, "name=john", 0);
rc = curl_url_set(urlp, CURLUPART_SCHEME, "https", 0);
rc = curl_url_set(urlp, CURLUPART_USER, "john", 0);
rc = curl_url_set(urlp, CURLUPART_ZONEID, "eth0", 0);
.fi
Set parts are not URL encoded unless the user asks for it with the
\fICURLU_URLENCODE\fP flag.
.SH "CURLU_APPENDQUERY"
An application can append a string to the right end of the query part with the
\fICURLU_APPENDQUERY\fP flag to \fIcurl_url_set(3)\fP.
Imagine a handle that holds the URL "https://example.com/?shoes=2". An
application can then add the string "hat=1" to the query part like this:
.nf
rc = curl_url_set(urlp, CURLUPART_QUERY, "hat=1", CURLU_APPENDQUERY);
.fi
It notices the lack of an ampersand (&) separator and injects one, and the
handle's full URL then equals "https://example.com/?shoes=2&hat=1".
The appended string can of course also get URL encoded on add, and if asked to
URL encode, the encoding process skips the '=' character. For example, append
"candy=N&N" to what we already have, and URL encode it to deal with the
ampersand in the data:
.nf
rc = curl_url_set(urlp, CURLUPART_QUERY, "candy=N&N",
CURLU_APPENDQUERY | CURLU_URLENCODE);
.fi
Now the URL looks like
.nf
https://example.com/?shoes=2&hat=1&candy=N%26N
.fi
.SH AVAILABILITY
The URL API was introduced in libcurl 7.62.0.
A URL with a literal IPv6 address can be parsed even when IPv6 support is not
enabled.
.SH "SEE ALSO"
.BR curl_url (3),
.BR curl_url_cleanup (3),
.BR curl_url_dup (3),
.BR curl_url_get (3),
.BR curl_url_set (3),
.BR curl_url_strerror (3),
.BR CURLOPT_URL (3)
man/man3/curl_mime_headers.3 0000644 00000004741 14751172371 0011726 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.TH curl_mime_headers 3 "September 26, 2023" "libcurl 8.4.0" "libcurl"
.SH NAME
curl_mime_headers - set a mime part's custom headers
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_mime_headers(curl_mimepart *part,
struct curl_slist *headers, int take_ownership);
.fi
.SH DESCRIPTION
\fIcurl_mime_headers(3)\fP sets a mime part's custom headers.
\fIpart\fP is the part's handle to assign the custom headers list to.
\fIheaders\fP is the head of a list of custom headers; it may be set to NULL
to remove a previously attached custom header list.
\fItake_ownership\fP: when non-zero, causes the list to be freed upon
replacement or mime structure deletion; in this case the list must not be
freed explicitly.
Setting a part's custom headers list multiple times is valid: only the value
set by the last call is retained.
.SH EXAMPLE
.nf
struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "Custom-Header: mooo");
/* use these headers, please take ownership */
curl_mime_headers(part, headers, TRUE);
/* pass on this data */
curl_mime_data(part, "12345679", CURL_ZERO_TERMINATED);
/* set name */
curl_mime_name(part, "numbers");
.fi
.SH AVAILABILITY
As long as at least one of HTTP, SMTP or IMAP is enabled. Added in 7.56.0.
.SH RETURN VALUE
CURLE_OK or a CURL error code upon failure.
.SH "SEE ALSO"
.BR curl_mime_addpart (3),
.BR curl_mime_name (3)
man/man3/CURLSHOPT_SHARE.3 0000644 00000010552 14751172371 0010561 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.TH CURLSHOPT_SHARE 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLSHOPT_SHARE - add data to share
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLSHcode curl_share_setopt(CURLSH *share, CURLSHOPT_SHARE, long type);
.fi
.SH DESCRIPTION
The \fItype\fP parameter specifies what specific data that should be shared
and kept in the share object that was created with \fIcurl_share_init(3)\fP.
The given \fItype\fP must be be one of the values described below. You can set
\fICURLSHOPT_SHARE(3)\fP multiple times with different data arguments to have
the share object share multiple types of data. Unset a type again by setting
\fICURLSHOPT_UNSHARE(3)\fP.
.IP CURL_LOCK_DATA_COOKIE
Cookie data is shared across the easy handles using this shared object. Note
that this does not activate an easy handle's cookie handling. You can do that
separately by using \fICURLOPT_COOKIEFILE(3)\fP for example.
.IP CURL_LOCK_DATA_DNS
Cached DNS hosts are shared across the easy handles using this shared
object. Note that when you use the multi interface, all easy handles added to
the same multi handle share DNS cache by default without using this option.
.IP CURL_LOCK_DATA_SSL_SESSION
SSL session IDs are shared across the easy handles using this shared
object. This reduces the time spent in the SSL handshake when reconnecting to
the same server. Note SSL session IDs are reused within the same easy handle
by default. Note this symbol was added in 7.10.3 but was not implemented until
7.23.0.
.IP CURL_LOCK_DATA_CONNECT
Put the connection cache in the share object and make all easy handles using
this share object share the connection cache.
It is not supported to share connections between multiple concurrent threads.
Connections that are used for HTTP/1.1 Pipelining or HTTP/2 multiplexing only
get additional transfers added to them if the existing connection is held by
the same multi or easy handle. libcurl does not support doing HTTP/2 streams
in different threads using a shared connection.
Support for \fBCURL_LOCK_DATA_CONNECT\fP was added in 7.57.0, but the symbol
existed before this.
Note that when you use the multi interface, all easy handles added to the same
multi handle shares connection cache by default without using this option.
.IP CURL_LOCK_DATA_PSL
The Public Suffix List stored in the share object is made available to all
easy handle bound to the later. Since the Public Suffix List is periodically
refreshed, this avoids updates in too many different contexts.
Added in 7.61.0.
Note that when you use the multi interface, all easy handles added to the same
multi handle shares PSL cache by default without using this option.
.IP CURL_LOCK_DATA_HSTS
The in-memory HSTS cache.
It is not supported to share the HSTS between multiple concurrent threads.
Added in 7.88.0
.SH PROTOCOLS
All
.SH EXAMPLE
.nf
CURLSHcode sh;
share = curl_share_init();
sh = curl_share_setopt(share, CURLSHOPT_SHARE, CURL_LOCK_DATA_COOKIE);
if(sh)
printf("Error: %s\\n", curl_share_strerror(sh));
.fi
.SH AVAILABILITY
Added in 7.10
.SH RETURN VALUE
CURLSHE_OK (zero) means that the option was set properly, non-zero means an
error occurred. See \fIlibcurl-errors(3)\fP for the full list with
descriptions.
.SH "SEE ALSO"
.BR curl_share_cleanup (3),
.BR curl_share_init (3),
.BR curl_share_setopt (3),
.BR CURLSHOPT_UNSHARE (3)
man/man3/CURLOPT_PROXY_SSL_VERIFYHOST.3 0000644 00000006421 14751172371 0012710 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_PROXY_SSL_VERIFYHOST 3 "September 27, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_PROXY_SSL_VERIFYHOST \- verify the proxy certificate's name against host
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_PROXY_SSL_VERIFYHOST,
long verify);
.fi
.SH DESCRIPTION
Pass a long set to 2L as asking curl to \fIverify\fP in the HTTPS proxy's
certificate name fields against the proxy name.
This option determines whether libcurl verifies that the proxy cert contains
the correct name for the name it is known as.
When \fICURLOPT_PROXY_SSL_VERIFYHOST(3)\fP is 2, the proxy certificate must
indicate that the server is the proxy to which you meant to connect to, or the
connection fails.
Curl considers the proxy the intended one when the Common Name field or a
Subject Alternate Name field in the certificate matches the host name in the
proxy string which you told curl to use.
If \fIverify\fP value is set to 1:
In 7.28.0 and earlier: treated as a debug option of some sorts, not supported
anymore due to frequently leading to programmer mistakes.
From 7.28.1 to 7.65.3: setting it to 1 made \fIcurl_easy_setopt(3)\fP return
an error and leaving the flag untouched.
From 7.66.0: treats 1 and 2 the same.
When the \fIverify\fP value is 0L, the connection succeeds regardless of the
names used in the certificate. Use that ability with caution!
See also \fICURLOPT_PROXY_SSL_VERIFYPEER(3)\fP to verify the digital signature
of the proxy certificate.
.SH DEFAULT
2
.SH PROTOCOLS
All protocols when used over an HTTPS proxy.
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
/* Set the default value: strict name check please */
curl_easy_setopt(curl, CURLOPT_PROXY_SSL_VERIFYHOST, 2L);
curl_easy_perform(curl);
}
.fi
.SH AVAILABILITY
Added in 7.52.0.
If built TLS enabled.
.SH RETURN VALUE
Returns CURLE_OK if TLS is supported, and CURLE_UNKNOWN_OPTION if not.
If 1 is set as argument, \fICURLE_BAD_FUNCTION_ARGUMENT\fP is returned.
.SH "SEE ALSO"
.BR CURLOPT_CAINFO (3),
.BR CURLOPT_PROXY_CAINFO (3),
.BR CURLOPT_PROXY_SSL_VERIFYPEER (3),
.BR CURLOPT_SSL_VERIFYPEER (3)
man/man3/CURLOPT_FAILONERROR.3 0000644 00000005237 14751172371 0011252 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_FAILONERROR 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_FAILONERROR \- request failure on HTTP response >= 400
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_FAILONERROR, long fail);
.fi
.SH DESCRIPTION
A long parameter set to 1 tells the library to fail the request if the HTTP
code returned is equal to or larger than 400. The default action would be to
return the page normally, ignoring that code.
This method is not fail-safe and there are occasions where non-successful
response codes slip through, especially when authentication is involved
(response codes 401 and 407).
You might get some amounts of headers transferred before this situation is
detected, like when a "100-continue" is received as a response to a POST/PUT
and a 401 or 407 is received immediately afterwards.
When this option is used and an error is detected, it causes the connection to
get closed and \fICURLE_HTTP_RETURNED_ERROR\fP is returned.
.SH DEFAULT
0, do not fail on error
.SH PROTOCOLS
HTTP
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
CURLcode ret;
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/");
curl_easy_setopt(curl, CURLOPT_FAILONERROR, 1L);
ret = curl_easy_perform(curl);
if(ret == CURLE_HTTP_RETURNED_ERROR) {
/* an HTTP response error problem */
}
}
.fi
.SH AVAILABILITY
Along with HTTP.
.SH RETURN VALUE
Returns CURLE_OK if HTTP is enabled, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR CURLINFO_RESPONSE_CODE (3),
.BR CURLOPT_HTTP200ALIASES (3),
.BR CURLOPT_KEEP_SENDING_ON_ERROR (3)
man/man3/CURLOPT_OPENSOCKETDATA.3 0000644 00000006011 14751172371 0011563 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_OPENSOCKETDATA 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_OPENSOCKETDATA \- pointer passed to open socket callback
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_OPENSOCKETDATA, void *pointer);
.fi
.SH DESCRIPTION
Pass a \fIpointer\fP that is untouched by libcurl and passed as the first
argument in the open socket callback set with
\fICURLOPT_OPENSOCKETFUNCTION(3)\fP.
.SH DEFAULT
The default value of this parameter is NULL.
.SH PROTOCOLS
All
.SH EXAMPLE
.nf
/* make libcurl use the already established socket 'sockfd' */
static curl_socket_t opensocket(void *clientp,
curlsocktype purpose,
struct curl_sockaddr *address)
{
curl_socket_t sockfd;
sockfd = *(curl_socket_t *)clientp;
/* the actual externally set socket is passed in via the OPENSOCKETDATA
option */
return sockfd;
}
static int sockopt_callback(void *clientp, curl_socket_t curlfd,
curlsocktype purpose)
{
/* This return code was added in libcurl 7.21.5 */
return CURL_SOCKOPT_ALREADY_CONNECTED;
}
curl = curl_easy_init();
if(curl) {
/* libcurl thinks that you connect to the host
* and port that you specify in the URL option. */
curl_easy_setopt(curl, CURLOPT_URL, "http://99.99.99.99:9999");
/* call this function to get a socket */
curl_easy_setopt(curl, CURLOPT_OPENSOCKETFUNCTION, opensocket);
curl_easy_setopt(curl, CURLOPT_OPENSOCKETDATA, &sockfd);
/* call this function to set options for the socket */
curl_easy_setopt(curl, CURLOPT_SOCKOPTFUNCTION, sockopt_callback);
res = curl_easy_perform(curl);
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Added in 7.17.1
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR CURLOPT_CLOSESOCKETFUNCTION (3),
.BR CURLOPT_OPENSOCKETFUNCTION (3),
.BR CURLOPT_SOCKOPTFUNCTION (3)
man/man3/CURLMOPT_PIPELINING_SITE_BL.3 0000644 00000004300 14751172371 0012432 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLMOPT_PIPELINING_SITE_BL 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLMOPT_PIPELINING_SITE_BL \- pipelining host block list
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLMcode curl_multi_setopt(CURLM *handle, CURLMOPT_PIPELINING_SITE_BL,
char **hosts);
.fi
.SH DESCRIPTION
No function since pipelining was removed in 7.62.0.
Pass a \fBhosts\fP array of char *, ending with a NULL entry. This is a list
of sites that are blocked from pipelining, i.e sites that are known to not
support HTTP pipelining. The array is copied by libcurl.
Pass a NULL pointer to clear the block list.
.SH DEFAULT
The default value is NULL, which means that there is no block list.
.SH PROTOCOLS
HTTP(S)
.SH EXAMPLE
.nf
char *site_block_list[] =
{
"www.haxx.se",
"www.example.com:1234",
NULL
};
curl_multi_setopt(m, CURLMOPT_PIPELINING_SITE_BL, site_block_list);
.fi
.SH AVAILABILITY
Added in 7.30.0
.SH RETURN VALUE
Returns CURLM_OK if the option is supported, and CURLM_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR CURLMOPT_PIPELINING (3),
.BR CURLMOPT_PIPELINING_SERVER_BL (3)
man/man3/curl_mime_data_cb.3 0000644 00000014306 14751172371 0011666 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.TH curl_mime_data_cb 3 "September 26, 2023" "libcurl 8.4.0" "libcurl"
.SH NAME
curl_mime_data_cb - set a callback-based data source for a mime part's body
.SH SYNOPSIS
.nf
#include <curl/curl.h>
size_t readfunc(char *buffer, size_t size, size_t nitems, void *arg);
int seekfunc(void *arg, curl_off_t offset, int origin);
void freefunc(void *arg);
CURLcode curl_mime_data_cb(curl_mimepart *part, curl_off_t datasize,
curl_read_callback readfunc,
curl_seek_callback seekfunc,
curl_free_callback freefunc, void *arg);
.fi
.SH DESCRIPTION
\fIcurl_mime_data_cb(3)\fP sets the data source of a mime part's body content
from a data read callback function.
\fIpart\fP is the part's to assign contents to.
\fIreadfunc\fP is a pointer to a data read callback function, with a signature
as shown by the above prototype. It may not be set to NULL.
\fIseekfunc\fP is a pointer to a seek callback function, with a signature as
shown by the above prototype. This function is used when resending data (i.e.:
after a redirect); this pointer may be set to NULL, in which case a resend
might not be not possible.
\fIfreefunc\fP is a pointer to a user resource freeing callback function, with
a signature as shown by the above prototype. If no resource is to be freed, it
may safely be set to NULL. This function is called upon mime structure
freeing.
\fIarg\fP is a user defined argument to callback functions.
The read callback function gets called by libcurl as soon as it needs to
read data in order to send it to the peer - like if you ask it to upload or
post data to the server. The data area pointed at by the pointer \fIbuffer\fP
should be filled up with at most \fIsize\fP multiplied with \fInitems\fP number
of bytes by your function.
Your read function must then return the actual number of bytes that it stored
in that memory area. Returning 0 signals end-of-file to the library and cause
it to stop the current transfer.
If you stop the current transfer by returning 0 "pre-maturely" (i.e. before
the server expected it, like when you have said you intend to upload N bytes
and yet you upload less than N bytes), you may experience that the server
"hangs" waiting for the rest of the data that does not come.
The read callback may return \fICURL_READFUNC_ABORT\fP to stop the current
operation immediately, resulting in a \fICURLE_ABORTED_BY_CALLBACK\fP error
code from the transfer.
The callback can return \fICURL_READFUNC_PAUSE\fP to cause reading from this
connection to pause. See \fIcurl_easy_pause(3)\fP for further details.
The seek function gets called by libcurl to rewind input stream data or to
seek to a certain position. The function shall work like fseek(3) or lseek(3)
and it gets SEEK_SET, SEEK_CUR or SEEK_END as argument for \fIorigin\fP,
although libcurl currently only passes SEEK_SET.
The callback function must return \fICURL_SEEKFUNC_OK\fP on success,
\fICURL_SEEKFUNC_FAIL\fP to cause the upload operation to fail or
\fICURL_SEEKFUNC_CANTSEEK\fP to indicate that while the seek failed, libcurl
is free to work around the problem if possible. The latter can sometimes be
done by instead reading from the input or similar.
Care must be taken if the part is bound to a curl easy handle that is later
duplicated: the \fIarg\fP pointer argument is also duplicated, resulting in
the pointed item to be shared between the original and the copied handle. In
particular, special attention should be given to the \fIfreefunc\fP procedure
code since it then gets called twice with the same argument.
.SH EXAMPLE
Sending a huge data string causes the same amount of memory to be allocated:
to avoid overhead resources consumption, one might want to use a callback
source to avoid data duplication. In this case, original data must be retained
until after the transfer terminates.
.nf
char hugedata[512000];
struct ctl {
char *buffer;
curl_off_t size;
curl_off_t position;
};
size_t read_callback(char *buffer, size_t size, size_t nitems, void *arg)
{
struct ctl *p = (struct ctl *) arg;
curl_off_t sz = p->size - p->position;
nitems *= size;
if(sz > nitems)
sz = nitems;
if(sz)
memcpy(buffer, p->buffer + p->position, sz);
p->position += sz;
return sz;
}
int seek_callback(void *arg, curl_off_t offset, int origin)
{
struct ctl *p = (struct ctl *) arg;
switch(origin) {
case SEEK_END:
offset += p->size;
break;
case SEEK_CUR:
offset += p->position;
break;
}
if(offset < 0)
return CURL_SEEKFUNC_FAIL;
p->position = offset;
return CURL_SEEKFUNC_OK;
}
CURL *easy = curl_easy_init();
curl_mime *mime = curl_mime_init(easy);
curl_mimepart *part = curl_mime_addpart(mime);
struct ctl hugectl;
hugectl.buffer = hugedata;
hugectl.size = sizeof hugedata;
hugectl.position = 0;
curl_mime_data_cb(part, hugectl.size, read_callback, seek_callback, NULL,
&hugectl);
.SH AVAILABILITY
As long as at least one of HTTP, SMTP or IMAP is enabled. Added in 7.56.0.
.SH RETURN VALUE
CURLE_OK or a CURL error code upon failure.
.SH "SEE ALSO"
.BR curl_easy_duphandle (3),
.BR curl_mime_addpart (3),
.BR curl_mime_data (3),
.BR curl_mime_name (3)
man/man3/CURLOPT_POSTFIELDSIZE_LARGE.3 0000644 00000004637 14751172371 0012431 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_POSTFIELDSIZE_LARGE 3 "September 27, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_POSTFIELDSIZE_LARGE \- size of POST data pointed to
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_POSTFIELDSIZE_LARGE,
curl_off_t size);
.SH DESCRIPTION
If you want to post static data to the server without having libcurl do a
strlen() to measure the data size, this option must be used. When this option
is used you can post fully binary data, which otherwise is likely to fail. If
this size is set to -1, libcurl uses strlen() to get the size or relies on the
\fICURLOPT_READFUNCTION(3)\fP (if used) to signal the end of data.
.SH DEFAULT
-1
.SH PROTOCOLS
HTTP(S)
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
const char *data = large_chunk;
curl_off_t length_of_data; /* set somehow */
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
/* size of the POST data */
curl_easy_setopt(curl, CURLOPT_POSTFIELDSIZE_LARGE, length_of_data);
curl_easy_setopt(curl, CURLOPT_POSTFIELDS, data);
curl_easy_perform(curl);
}
.fi
.SH AVAILABILITY
Along with HTTP
.SH RETURN VALUE
Returns CURLE_OK if HTTP is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR CURLOPT_COPYPOSTFIELDS (3),
.BR CURLOPT_POSTFIELDS (3),
.BR CURLOPT_POSTFIELDSIZE (3)
man/man3/CURLOPT_PASSWORD.3 0000644 00000004340 14751172371 0010724 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_PASSWORD 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_PASSWORD \- password to use in authentication
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_PASSWORD, char *pwd);
.fi
.SH DESCRIPTION
Pass a char * as parameter, which should be pointing to the null-terminated
password to use for the transfer.
The \fICURLOPT_PASSWORD(3)\fP option should be used in conjunction with the
\fICURLOPT_USERNAME(3)\fP option.
The application does not have to keep the string around after setting this
option.
.SH DEFAULT
blank
.SH PROTOCOLS
Most
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/foo.bin");
curl_easy_setopt(curl, CURLOPT_PASSWORD, "qwerty");
ret = curl_easy_perform(curl);
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Added in 7.19.1
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, CURLE_UNKNOWN_OPTION if not, or
CURLE_OUT_OF_MEMORY if there was insufficient heap space.
.SH "SEE ALSO"
.BR CURLOPT_HTTPAUTH (3),
.BR CURLOPT_PROXYAUTH (3),
.BR CURLOPT_USERNAME (3),
.BR CURLOPT_USERPWD (3)
man/man3/CURLINFO_CONTENT_LENGTH_DOWNLOAD_T.3 0000644 00000004423 14751172371 0013502 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLINFO_CONTENT_LENGTH_DOWNLOAD_T 3 "September 26, 2023" "libcurl 8.4.0" "libcurl"
.SH NAME
CURLINFO_CONTENT_LENGTH_DOWNLOAD_T \- get content-length of download
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_getinfo(CURL *handle, CURLINFO_CONTENT_LENGTH_DOWNLOAD_T,
curl_off_t *content_length);
.fi
.SH DESCRIPTION
Pass a pointer to a \fIcurl_off_t\fP to receive the content-length of the
download. This is the value read from the Content-Length: field. Stores -1 if
the size is not known.
.SH PROTOCOLS
HTTP(S)
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
/* Perform the request */
res = curl_easy_perform(curl);
if(!res) {
/* check the size */
curl_off_t cl;
res = curl_easy_getinfo(curl, CURLINFO_CONTENT_LENGTH_DOWNLOAD_T, &cl);
if(!res) {
printf("Download size: %" CURL_FORMAT_CURL_OFF_T "\\n", cl);
}
}
}
.fi
.SH AVAILABILITY
Added in 7.55.0
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR curl_easy_getinfo (3),
.BR curl_easy_setopt (3),
.BR CURLINFO_CONTENT_LENGTH_UPLOAD_T (3)
man/man3/CURLOPT_COOKIEJAR.3 0000644 00000006153 14751172371 0010774 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_COOKIEJAR 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_COOKIEJAR \- file name to store cookies to
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_COOKIEJAR, char *filename);
.fi
.SH DESCRIPTION
Pass a \fIfilename\fP as a char *, null-terminated. This makes libcurl write
all internally known cookies to the specified file when
\fIcurl_easy_cleanup(3)\fP is called. If no cookies are kept in memory at that
time, no file is created. Specify "-" as filename to instead have the cookies
written to stdout. Using this option also enables cookies for this session, so
if you for example follow a redirect it makes matching cookies get sent
accordingly.
Note that libcurl does not read any cookies from the cookie jar specified with
this option. To read cookies from a file, use \fICURLOPT_COOKIEFILE(3)\fP.
If the cookie jar file cannot be created or written to (when the
\fIcurl_easy_cleanup(3)\fP is called), libcurl does not and cannot report an
error for this. Using \fICURLOPT_VERBOSE(3)\fP or
\fICURLOPT_DEBUGFUNCTION(3)\fP displays a warning, but that is the only
visible feedback you get about this possibly lethal situation.
Cookies are imported in the Set-Cookie format without a domain name are not
exported by this option.
The application does not have to keep the string around after setting this
option.
.SH DEFAULT
NULL
.SH PROTOCOLS
HTTP
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/foo.bin");
/* export cookies to this file when closing the handle */
curl_easy_setopt(curl, CURLOPT_COOKIEJAR, "/tmp/cookies.txt");
ret = curl_easy_perform(curl);
/* close the handle, write the cookies! */
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Along with HTTP
.SH RETURN VALUE
Returns CURLE_OK if HTTP is supported, CURLE_UNKNOWN_OPTION if not, or
CURLE_OUT_OF_MEMORY if there was insufficient heap space.
.SH "SEE ALSO"
.BR CURLOPT_COOKIE (3),
.BR CURLOPT_COOKIEFILE (3),
.BR CURLOPT_COOKIELIST (3)
man/man3/CURLOPT_USERAGENT.3 0000644 00000004401 14751172371 0011015 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_USERAGENT 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_USERAGENT \- HTTP user-agent header
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_USERAGENT, char *ua);
.fi
.SH DESCRIPTION
Pass a pointer to a null-terminated string as parameter. It is used to set the
User-Agent: header field in the HTTP request sent to the remote server. You
can also set any custom header with \fICURLOPT_HTTPHEADER(3)\fP.
The application does not have to keep the string around after setting this
option.
.SH DEFAULT
NULL, no User-Agent: header is used by default.
.SH PROTOCOLS
HTTP, HTTPS
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
curl_easy_setopt(curl, CURLOPT_USERAGENT, "Dark Secret Ninja/1.0");
curl_easy_perform(curl);
}
.fi
.SH AVAILABILITY
As long as HTTP is supported
.SH RETURN VALUE
Returns CURLE_OK if HTTP is supported, CURLE_UNKNOWN_OPTION if not, or
CURLE_OUT_OF_MEMORY if there was insufficient heap space.
.SH "SEE ALSO"
.BR CURLOPT_CUSTOMREQUEST (3),
.BR CURLOPT_HTTPHEADER (3),
.BR CURLOPT_REFERER (3),
.BR CURLOPT_REQUEST_TARGET (3)
man/man3/CURLOPT_STDERR.3 0000644 00000004226 14751172371 0010470 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_STDERR 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_STDERR \- redirect stderr to another stream
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_STDERR, FILE *stream);
.fi
.SH DESCRIPTION
Pass a FILE * as parameter. Tell libcurl to use this \fIstream\fP instead of
stderr when showing the progress meter and displaying \fICURLOPT_VERBOSE(3)\fP
data.
If you are using libcurl as a Windows DLL, this option causes an exception and
a crash in the library since it cannot access a FILE * passed on from the
application. A work-around is to instead use \fICURLOPT_DEBUGFUNCTION(3)\fP.
.SH DEFAULT
stderr
.SH PROTOCOLS
All
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
FILE *filep = fopen("dump", "wb");
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
curl_easy_setopt(curl, CURLOPT_STDERR, filep);
curl_easy_perform(curl);
}
.fi
.SH AVAILABILITY
Always
.SH RETURN VALUE
Returns CURLE_OK
.SH "SEE ALSO"
.BR CURLOPT_VERBOSE (3),
.BR CURLOPT_NOPROGRESS (3),
.BR CURLOPT_DEBUGFUNCTION (3)
man/man3/CURLINFO_TLS_SSL_PTR.3 0000644 00000014140 14751172371 0011462 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLINFO_TLS_SSL_PTR 3 "September 27, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLINFO_TLS_SESSION, CURLINFO_TLS_SSL_PTR \- get TLS session info
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_getinfo(CURL *handle, CURLINFO_TLS_SSL_PTR,
struct curl_tlssessioninfo **session);
/* if you need compatibility with libcurl < 7.48.0 use
CURLINFO_TLS_SESSION instead: */
CURLcode curl_easy_getinfo(CURL *handle, CURLINFO_TLS_SESSION,
struct curl_tlssessioninfo **session);
.SH DESCRIPTION
Pass a pointer to a \fIstruct curl_tlssessioninfo *\fP. The pointer is
initialized to refer to a \fIstruct curl_tlssessioninfo *\fP that contains an
enum indicating the SSL library used for the handshake and a pointer to the
respective internal TLS session structure of this underlying SSL library.
This option may be useful for example to extract certificate information in a
format convenient for further processing, such as manual validation. Refer to
the \fBLIMITATIONS\fP section.
.nf
struct curl_tlssessioninfo {
curl_sslbackend backend;
void *internals;
};
.fi
The \fIbackend\fP struct member is one of the defines in the CURLSSLBACKEND_*
series: CURLSSLBACKEND_NONE (when built without TLS support),
CURLSSLBACKEND_WOLFSSL, CURLSSLBACKEND_SECURETRANSPORT, CURLSSLBACKEND_GNUTLS,
CURLSSLBACKEND_MBEDTLS, CURLSSLBACKEND_NSS, CURLSSLBACKEND_OPENSSL,
CURLSSLBACKEND_SCHANNEL or CURLSSLBACKEND_MESALINK. (Note that the OpenSSL
forks are all reported as just OpenSSL here.)
The \fIinternals\fP struct member points to a TLS library specific pointer for
the active ("in use") SSL connection, with the following underlying types:
.RS
.IP GnuTLS
\fBgnutls_session_t\fP
.IP NSS
\fBPRFileDesc *\fP
.IP OpenSSL
\fICURLINFO_TLS_SESSION(3)\fP: \fBSSL_CTX *\fP
\fICURLINFO_TLS_SSL_PTR(3)\fP: \fBSSL *\fP
.RE
Since 7.48.0 the \fIinternals\fP member can point to these other SSL backends
as well:
.RS
.IP mbedTLS
\fBmbedTLS_ssl_context *\fP
.IP "Secure Channel"
\fBCtxtHandle *\fP
.IP "Secure Transport"
\fBSSLContext *\fP
.IP "wolfSSL"
\fBSSL *\fP
.RE
If the \fIinternals\fP pointer is NULL then either the SSL backend is not
supported, an SSL session has not yet been established or the connection is no
longer associated with the easy handle (e.g. \fIcurl_easy_perform(3)\fP has
returned).
.SH LIMITATIONS
This option has some limitations that could make it unsafe when it comes to
the manual verification of certificates.
This option only retrieves the first in-use SSL session pointer for your easy
handle, however your easy handle may have more than one in-use SSL session if
using FTP over SSL. That is because the FTP protocol has a control channel and
a data channel and one or both may be over SSL. Currently there is no way to
retrieve a second in-use SSL session associated with an easy handle.
This option has not been thoroughly tested with clear text protocols that can
be upgraded/downgraded to/from SSL: FTP, SMTP, POP3, IMAP when used with
\fICURLOPT_USE_SSL(3)\fP. Though you can to retrieve the SSL pointer, it's
possible that before you can do that, data (including auth) may have already
been sent over a connection after it was upgraded.
Renegotiation. If unsafe renegotiation or renegotiation in a way that the
certificate is allowed to change is allowed by your SSL library this may occur
and the certificate may change, and data may continue to be sent or received
after renegotiation but before you are able to get the (possibly) changed SSL
pointer, with the (possibly) changed certificate information.
Instead of using this option to poll for certificate changes use
\fICURLOPT_SSL_CTX_FUNCTION(3)\fP to set a verification callback, if supported.
That is safer and does not suffer from any of the problems above.
How are you using this option? Are you affected by any of these limitations?
Please let us know by making a comment at
https://github.com/curl/curl/issues/685
.SH PROTOCOLS
All TLS-based
.SH EXAMPLE
.nf
#include <curl/curl.h>
#include <openssl/ssl.h>
CURL *curl;
static size_t wf(void *ptr, size_t size, size_t nmemb, void *stream)
{
const struct curl_tlssessioninfo *info = NULL;
CURLcode res = curl_easy_getinfo(curl, CURLINFO_TLS_SSL_PTR, &info);
if(info && !res) {
if(CURLSSLBACKEND_OPENSSL == info->backend) {
printf("OpenSSL ver. %s\\n", SSL_get_version((SSL*)info->internals));
}
}
return size * nmemb;
}
int main(int argc, char** argv)
{
CURLcode res;
curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, wf);
res = curl_easy_perform(curl);
curl_easy_cleanup(curl);
}
return res;
}
.fi
.SH AVAILABILITY
Added in 7.48.0.
This option supersedes \fICURLINFO_TLS_SESSION(3)\fP which was added in 7.34.0.
This option is exactly the same as that option except in the case of OpenSSL.
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR curl_easy_getinfo (3),
.BR curl_easy_setopt (3),
.BR CURLINFO_TLS_SESSION (3)
man/man3/CURLOPT_CA_CACHE_TIMEOUT.3 0000644 00000005502 14751172371 0012037 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_CA_CACHE_TIMEOUT 3 "September 27, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_CA_CACHE_TIMEOUT \- life-time for cached certificate stores
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_CA_CACHE_TIMEOUT, long age);
.fi
.SH DESCRIPTION
Pass a long, this sets the timeout in seconds. This tells libcurl the maximum
time any cached certificate store it has in memory may be kept and reused for
new connections. Once the timeout has expired, a subsequent fetch requiring a
certificate has to reload it.
Building a certificate store from a \fICURLOPT_CAINFO(3)\fP file is a slow
operation so curl may cache the generated certificate store internally to speed
up future connections.
Set to zero to completely disable caching, or set to -1 to retain the cached
store remain forever. By default, libcurl caches this info for 24 hours.
.SH DEFAULT
86400 (24 hours)
.SH PROTOCOLS
All
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/foo.bin");
/* only reuse certificate stores for a short time */
curl_easy_setopt(curl, CURLOPT_CA_CACHE_TIMEOUT, 60L);
ret = curl_easy_perform(curl);
/* in this second request, the cache is not used if more than
sixty seconds passed since the previous connection */
ret = curl_easy_perform(curl);
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
This option was added in curl 7.87.0.
Currently the only SSL backend to implement this certificate store caching
functionality is the OpenSSL (and forks) backend.
.SH RETURN VALUE
Returns CURLE_OK
.SH "SEE ALSO"
.BR CURLOPT_CAINFO (3),
.BR CURLOPT_CAINFO_BLOB (3),
.BR CURLOPT_CAPATH (3),
.BR CURLOPT_SSL_VERIFYPEER (3),
.BR CURLOPT_SSL_VERIFYHOST (3)
man/man3/curl_version_info.3 0000644 00000030213 14751172371 0011775 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH curl_version_info 3 "September 27, 2023" "libcurl 8.4.0" "libcurl"
.SH NAME
curl_version_info - returns runtime libcurl version info
.SH SYNOPSIS
.nf
#include <curl/curl.h>
curl_version_info_data *curl_version_info(CURLversion age);
.fi
.SH DESCRIPTION
Returns a pointer to a filled in static struct with information about various
features in the running version of libcurl. \fIage\fP should be set to the
version of this functionality by the time you write your program. This way,
libcurl always returns a proper struct that your program understands, while
programs in the future might get a different struct. \fBCURLVERSION_NOW\fP is
the most recent one for the library you have installed:
.nf
data = curl_version_info(CURLVERSION_NOW);
.fi
Applications should use this information to judge if things are possible to do
or not, instead of using compile-time checks, as dynamic/DLL libraries can be
changed independent of applications.
This function can alter the returned static data as long as
\fIcurl_global_init(3)\fP has not been called. It is therefore not thread-safe
before libcurl initialization occurs.
The curl_version_info_data struct looks like this
.nf
typedef struct {
CURLversion age; /* see description below */
const char *version; /* human readable string */
unsigned int version_num; /* numeric representation */
const char *host; /* human readable string */
int features; /* bitmask, see below */
char *ssl_version; /* human readable string */
long ssl_version_num; /* not used, always zero */
const char *libz_version; /* human readable string */
const char *const *protocols; /* protocols */
/* when 'age' is CURLVERSION_SECOND or higher, the members below exist */
const char *ares; /* human readable string */
int ares_num; /* number */
/* when 'age' is CURLVERSION_THIRD or higher, the members below exist */
const char *libidn; /* human readable string */
/* when 'age' is CURLVERSION_FOURTH or higher (>= 7.16.1), the members
below exist */
int iconv_ver_num; /* '_libiconv_version' if iconv support enabled */
const char *libssh_version; /* human readable string */
/* when 'age' is CURLVERSION_FIFTH or higher (>= 7.57.0), the members
below exist */
unsigned int brotli_ver_num; /* Numeric Brotli version
(MAJOR << 24) | (MINOR << 12) | PATCH */
const char *brotli_version; /* human readable string. */
/* when 'age' is CURLVERSION_SIXTH or higher (>= 7.66.0), the members
below exist */
unsigned int nghttp2_ver_num; /* Numeric nghttp2 version
(MAJOR << 16) | (MINOR << 8) | PATCH */
const char *nghttp2_version; /* human readable string. */
const char *quic_version; /* human readable quic (+ HTTP/3) library +
version or NULL */
/* when 'age' is CURLVERSION_SEVENTH or higher (>= 7.70.0), the members
below exist */
const char *cainfo; /* the built-in default CURLOPT_CAINFO, might
be NULL */
const char *capath; /* the built-in default CURLOPT_CAPATH, might
be NULL */
/* when 'age' is CURLVERSION_EIGHTH or higher (>= 7.71.0), the members
below exist */
unsigned int zstd_ver_num; /* Numeric Zstd version
(MAJOR << 24) | (MINOR << 12) | PATCH */
const char *zstd_version; /* human readable string. */
/* when 'age' is CURLVERSION_NINTH or higher (>= 7.75.0), the members
below exist */
const char *hyper_version; /* human readable string. */
/* when 'age' is CURLVERSION_TENTH or higher (>= 7.77.0), the members
below exist */
const char *gsasl_version; /* human readable string. */
/* when 'age' is CURLVERSION_ELEVENTH or higher (>= 7.87.0), the members
below exist */
const char *const *feature_names; /* Feature names. */
} curl_version_info_data;
.fi
\fIage\fP describes what the age of this struct is. The number depends on how
new the libcurl you are using is. You are however guaranteed to get a struct
that you have a matching struct for in the header, as you tell libcurl your
"age" with the input argument.
\fIversion\fP is just an ascii string for the libcurl version.
\fIversion_num\fP is a 24 bit number created like this: <8 bits major number>
| <8 bits minor number> | <8 bits patch number>. Version 7.9.8 is therefore
returned as 0x070908.
\fIhost\fP is an ascii string showing what host information that this libcurl
was built for. As discovered by a configure script or set by the build
environment.
\fIfeatures\fP is a bit mask representing available features. It can
have none, one or more bits set.
The use of this field is deprecated: use \fIfeature_names\fP instead.
The feature names description below lists the associated bits.
\fIfeature_names\fP is a pointer to an array of string pointers, containing the
names of the features that libcurl supports. The array is terminated by a NULL
entry. Currently defined names are:
.RS
.IP """alt-svc"""
\fIfeatures\fP mask bit: CURL_VERSION_ALTSVC
.br
HTTP Alt-Svc parsing and the associated options (Added in 7.64.1)
.IP """AsynchDNS"""
\fIfeatures\fP mask bit: CURL_VERSION_ASYNCHDNS
.br
libcurl was built with support for asynchronous name lookups, which allows
more exact timeouts (even on Windows) and less blocking when using the multi
interface. (added in 7.10.7)
.IP """brotli"""
\fIfeatures\fP mask bit: CURL_VERSION_BROTLI
.br
supports HTTP Brotli content encoding using libbrotlidec (Added in 7.57.0)
.IP """Debug"""
\fIfeatures\fP mask bit: CURL_VERSION_DEBUG
.br
libcurl was built with debug capabilities (added in 7.10.6)
.IP """gsasl"""
\fIfeatures\fP mask bit: CURL_VERSION_GSASL
.br
libcurl was built with libgsasl and thus with some extra SCRAM-SHA
authentication methods. (added in 7.76.0)
.IP """GSS-API"""
\fIfeatures\fP mask bit: CURL_VERSION_GSSAPI
.br
libcurl was built with support for GSS-API. This makes libcurl use provided
functions for Kerberos and SPNEGO authentication. It also allows libcurl
to use the current user credentials without the app having to pass them on.
(Added in 7.38.0)
.IP """HSTS"""
\fIfeatures\fP mask bit: CURL_VERSION_HSTS
.br
libcurl was built with support for HSTS (HTTP Strict Transport Security)
(Added in 7.74.0)
.IP """HTTP2"""
\fIfeatures\fP mask bit: CURL_VERSION_HTTP2
.br
libcurl was built with support for HTTP2.
(Added in 7.33.0)
.IP """HTTP3"""
\fIfeatures\fP mask bit: CURL_VERSION_HTTP3
.br
HTTP/3 and QUIC support are built-in (Added in 7.66.0)
.IP """HTTPS-proxy"""
\fIfeatures\fP mask bit: CURL_VERSION_HTTPS_PROXY
.br
libcurl was built with support for HTTPS-proxy.
(Added in 7.52.0)
.IP """IDN"""
\fIfeatures\fP mask bit: CURL_VERSION_IDN
.br
libcurl was built with support for IDNA, domain names with international
letters. (Added in 7.12.0)
.IP """IPv6"""
\fIfeatures\fP mask bit: CURL_VERSION_IPV6
.br
supports IPv6
.IP """Kerberos"""
\fIfeatures\fP mask bit: CURL_VERSION_KERBEROS5
.br
supports Kerberos V5 authentication for FTP, IMAP, LDAP, POP3, SMTP and
SOCKSv5 proxy. (Added in 7.40.0)
.IP """Largefile"""
\fIfeatures\fP mask bit: CURL_VERSION_LARGEFILE
.br
libcurl was built with support for large files. (Added in 7.11.1)
.IP """libz"""
\fIfeatures\fP mask bit: CURL_VERSION_LIBZ
.br
supports HTTP deflate using libz (Added in 7.10)
.IP """MultiSSL"""
\fIfeatures\fP mask bit: CURL_VERSION_MULTI_SSL
.br
libcurl was built with multiple SSL backends. For details, see
\fIcurl_global_sslset(3)\fP.
(Added in 7.56.0)
.IP """NTLM"""
\fIfeatures\fP mask bit: CURL_VERSION_NTLM
.br
supports HTTP NTLM (added in 7.10.6)
.IP """NTLM_WB"""
\fIfeatures\fP mask bit: CURL_VERSION_NTLM_WB
.br
libcurl was built with support for NTLM delegation to a winbind helper.
(Added in 7.22.0)
.IP """PSL"""
\fIfeatures\fP mask bit: CURL_VERSION_PSL
.br
libcurl was built with support for Mozilla's Public Suffix List. This makes
libcurl ignore cookies with a domain that is on the list.
(Added in 7.47.0)
.IP """SPNEGO"""
\fIfeatures\fP mask bit: CURL_VERSION_SPNEGO
.br
libcurl was built with support for SPNEGO authentication (Simple and Protected
GSS-API Negotiation Mechanism, defined in RFC 2478.) (added in 7.10.8)
.IP """SSL"""
\fIfeatures\fP mask bit: CURL_VERSION_SSL
.br
supports SSL (HTTPS/FTPS) (Added in 7.10)
.IP """SSPI"""
\fIfeatures\fP mask bit: CURL_VERSION_SSPI
.br
libcurl was built with support for SSPI. This is only available on Windows and
makes libcurl use Windows-provided functions for Kerberos, NTLM, SPNEGO and
Digest authentication. It also allows libcurl to use the current user
credentials without the app having to pass them on. (Added in 7.13.2)
.IP """threadsafe"""
\fIfeatures\fP mask bit: CURL_VERSION_THREADSAFE
.br
libcurl was built with thread-safety support (Atomic or SRWLOCK) to protect
curl initialization. (Added in 7.84.0) See \fIlibcurl-thread(3)\fP
.IP """TLS-SRP"""
\fIfeatures\fP mask bit: CURL_VERSION_TLSAUTH_SRP
.br
libcurl was built with support for TLS-SRP (in one or more of the built-in TLS
backends). (Added in 7.21.4)
.IP """TrackMemory"""
\fIfeatures\fP mask bit: CURL_VERSION_CURLDEBUG
.br
libcurl was built with memory tracking debug capabilities. This is mainly of
interest for libcurl hackers. (added in 7.19.6)
.IP """Unicode"""
\fIfeatures\fP mask bit: CURL_VERSION_UNICODE
.br
libcurl was built with Unicode support on Windows. This makes non-ASCII
characters work in filenames and options passed to libcurl. (Added in 7.72.0)
.IP """UnixSockets"""
\fIfeatures\fP mask bit: CURL_VERSION_UNIX_SOCKETS
.br
libcurl was built with support for Unix domain sockets.
(Added in 7.40.0)
.IP """zstd"""
\fIfeatures\fP mask bit: CURL_VERSION_ZSTD
.br
supports HTTP zstd content encoding using zstd library (Added in 7.72.0)
.IP none
\fIfeatures\fP mask bit: CURL_VERSION_CONV
.br
libcurl was built with support for character conversions, as provided by the
CURLOPT_CONV_* callbacks. Always 0 since 7.82.0. (Added in 7.15.4)
.IP none
\fIfeatures\fP mask bit: CURL_VERSION_GSSNEGOTIATE
.br
supports HTTP GSS-Negotiate (added in 7.10.6, deprecated in 7.38.0)
.IP none
\fIfeatures\fP mask bit: CURL_VERSION_KERBEROS4
.br
supports Kerberos V4 (when using FTP). Legacy bit. Deprecated since 7.33.0.
.RE
\fIssl_version\fP is an ASCII string for the TLS library name + version
used. If libcurl has no SSL support, this is NULL. For example "Schannel",
\&"Secure Transport" or "OpenSSL/1.1.0g".
\fIssl_version_num\fP is always 0.
\fIlibz_version\fP is an ASCII string (there is no numerical version). If
libcurl has no libz support, this is NULL.
\fIprotocols\fP is a pointer to an array of char * pointers, containing the
names protocols that libcurl supports (using lowercase letters). The protocol
names are the same as would be used in URLs. The array is terminated by a NULL
entry.
.SH EXAMPLE
.nf
curl_version_info_data *ver = curl_version_info(CURLVERSION_NOW);
printf("libcurl version %u.%u.%u\\n",
(ver->version_num >> 16) & 0xff,
(ver->version_num >> 8) & 0xff,
ver->version_num & 0xff);
.fi
.SH AVAILABILITY
Added in 7.10
.SH RETURN VALUE
A pointer to a curl_version_info_data struct.
.SH "SEE ALSO"
\fIcurl_version(3)\fP
man/man3/CURLINFO_REDIRECT_TIME_T.3 0000644 00000005022 14751172371 0012053 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLINFO_REDIRECT_TIME_T 3 "September 27, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLINFO_REDIRECT_TIME_T \- get the time for all redirection steps
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_getinfo(CURL *handle, CURLINFO_REDIRECT_TIME_T,
curl_off_t *timep);
.fi
.SH DESCRIPTION
Pass a pointer to a curl_off_t to receive the total time, in microseconds, it
took for all redirection steps include name lookup, connect, pretransfer and
transfer before final transaction was started.
\fICURLINFO_REDIRECT_TIME_T(3)\fP holds the complete execution time for
multiple redirections.
See also the TIMES overview in the \fIcurl_easy_getinfo(3)\fP man page.
.SH PROTOCOLS
All
.SH EXAMPLE
.nf
curl = curl_easy_init();
if(curl) {
curl_off_t redirect;
curl_easy_setopt(curl, CURLOPT_URL, url);
res = curl_easy_perform(curl);
if(CURLE_OK == res) {
res = curl_easy_getinfo(curl, CURLINFO_REDIRECT_TIME_T, &redirect);
if(CURLE_OK == res) {
printf("Time: %" CURL_FORMAT_CURL_OFF_T ".%06ld", redirect / 1000000,
(long)(redirect % 1000000));
}
}
/* always cleanup */
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Added in 7.61.0
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR curl_easy_getinfo (3),
.BR curl_easy_setopt (3),
.BR CURLINFO_REDIRECT_COUNT (3),
.BR CURLINFO_REDIRECT_TIME (3),
.BR CURLINFO_REDIRECT_URL (3)
man/man3/CURLINFO_SPEED_UPLOAD.3 0000644 00000004310 14751172371 0011454 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLINFO_SPEED_UPLOAD 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLINFO_SPEED_UPLOAD \- get upload speed
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_getinfo(CURL *handle, CURLINFO_SPEED_UPLOAD, double *speed);
.fi
.SH DESCRIPTION
Pass a pointer to a double to receive the average upload speed that curl
measured for the complete upload. Measured in bytes/second.
\fICURLINFO_SPEED_UPLOAD_T(3)\fP is a newer replacement that returns a more
sensible variable type.
.SH PROTOCOLS
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
/* Perform the request */
res = curl_easy_perform(curl);
if(!res) {
double speed;
res = curl_easy_getinfo(curl, CURLINFO_SPEED_UPLOAD, &speed);
if(!res) {
printf("Upload speed %.0f bytes/sec\\n", speed);
}
}
}
.fi
.SH AVAILABILITY
Added in 7.4.1. Deprecated since 7.55.0.
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR curl_easy_getinfo (3),
.BR curl_easy_setopt (3),
.BR CURLINFO_SPEED_DOWNLOAD_T (3)
man/man3/CURLOPT_MAIL_AUTH.3 0000644 00000005435 14751172371 0011033 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_MAIL_AUTH 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_MAIL_AUTH \- SMTP authentication address
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_MAIL_AUTH, char *auth);
.fi
.SH DESCRIPTION
Pass a pointer to a null-terminated string as parameter. This is used to
specify the authentication address (identity) of a submitted message that is
being relayed to another server.
This optional parameter allows co-operating agents in a trusted environment to
communicate the authentication of individual messages and should only be used
by the application program, using libcurl, if the application is itself a mail
server acting in such an environment. If the application is operating as such
and the AUTH address is not known or is invalid, then an empty string should
be used for this parameter.
Unlike \fICURLOPT_MAIL_FROM(3)\fP and \fICURLOPT_MAIL_RCPT(3)\fP, the address
should not be specified within a pair of angled brackets (<>). However, if an
empty string is used then a pair of brackets are sent by libcurl as required
by RFC 2554.
The application does not have to keep the string around after setting this
option.
.SH DEFAULT
NULL
.SH PROTOCOLS
SMTP
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "smtp://example.com/");
curl_easy_setopt(curl, CURLOPT_MAIL_AUTH, "<secret@cave>");
ret = curl_easy_perform(curl);
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Added in 7.25.0
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, CURLE_UNKNOWN_OPTION if not, or
CURLE_OUT_OF_MEMORY if there was insufficient heap space.
.SH "SEE ALSO"
.BR CURLOPT_MAIL_FROM (3),
.BR CURLOPT_MAIL_RCPT (3)
man/man3/CURLOPT_FTP_SSL_CCC.3 0000644 00000005052 14751172371 0011305 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_FTP_SSL_CCC 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_FTP_SSL_CCC \- switch off SSL again with FTP after auth
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_FTP_SSL_CCC,
long how);
.fi
.SH DESCRIPTION
If enabled, this option makes libcurl use CCC (Clear Command Channel). It
shuts down the SSL/TLS layer after authenticating. The rest of the control
channel communication remains unencrypted. This allows NAT routers to follow
the FTP transaction. Pass a long using one of the values below
.IP CURLFTPSSL_CCC_NONE
do not attempt to use CCC.
.IP CURLFTPSSL_CCC_PASSIVE
Do not initiate the shutdown, but wait for the server to do it. Do not send a
reply.
.IP CURLFTPSSL_CCC_ACTIVE
Initiate the shutdown and wait for a reply.
.SH DEFAULT
CURLFTPSSL_CCC_NONE
.SH PROTOCOLS
FTP
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "ftp://example.com/file.txt");
curl_easy_setopt(curl, CURLOPT_USE_SSL, CURLUSESSL_CONTROL);
/* go back to clear-text FTP after authenticating */
curl_easy_setopt(curl, CURLOPT_FTP_SSL_CCC, (long)CURLFTPSSL_CCC_ACTIVE);
ret = curl_easy_perform(curl);
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Added in 7.16.1
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR CURLOPT_FTPSSLAUTH (3),
.BR CURLOPT_PROTOCOLS_STR (3),
.BR CURLOPT_USE_SSL (3)
man/man3/CURLOPT_RTSP_SERVER_CSEQ.3 0000644 00000004033 14751172371 0012152 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_RTSP_SERVER_CSEQ 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_RTSP_SERVER_CSEQ \- RTSP server CSEQ number
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_RTSP_SERVER_CSEQ, long cseq);
.fi
.SH DESCRIPTION
Pass a long to set the CSEQ number to expect for the next RTSP Server->Client
request. \fBNOTE\fP: this feature (listening for Server requests) is
unimplemented.
.SH DEFAULT
0
.SH PROTOCOLS
RTSP
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "rtsp://example.com/");
curl_easy_setopt(curl, CURLOPT_RTSP_SERVER_CSEQ, 1234L);
ret = curl_easy_perform(curl);
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Added in 7.20.0
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR CURLINFO_RTSP_SERVER_CSEQ (3),
.BR CURLOPT_RTSP_CLIENT_CSEQ (3),
.BR CURLOPT_RTSP_STREAM_URI (3)
man/man3/curl_share_strerror.3 0000644 00000003642 14751172371 0012347 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.TH curl_share_strerror 3 "September 26, 2023" "libcurl 8.4.0" "libcurl"
.SH NAME
curl_share_strerror - return string describing error code
.SH SYNOPSIS
.nf
.B #include <curl/curl.h>
.BI "const char *curl_share_strerror(CURLSHcode " errornum ");"
.SH DESCRIPTION
The \fIcurl_share_strerror(3)\fP function returns a string describing the
\fICURLSHcode\fP error code passed in the argument \fIerrornum\fP.
.SH EXAMPLE
.nf
CURLSHcode sh;
share = curl_share_init();
sh = curl_share_setopt(share, CURLSHOPT_SHARE, CURL_LOCK_DATA_CONNECT);
if(sh)
printf("Error: %s\\n", curl_share_strerror(sh));
.fi
.SH AVAILABILITY
This function was added in libcurl 7.12.0
.SH RETURN VALUE
A pointer to a null-terminated string.
.SH "SEE ALSO"
.BR curl_easy_strerror (3),
.BR curl_multi_strerror (3),
.BR curl_url_strerror (3),
.BR libcurl-errors (3)
man/man3/CURLOPT_WRITEFUNCTION.3 0000644 00000011167 14751172371 0011527 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_WRITEFUNCTION 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_WRITEFUNCTION \- callback for writing received data
.SH SYNOPSIS
.nf
#include <curl/curl.h>
size_t write_callback(char *ptr, size_t size, size_t nmemb, void *userdata);
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_WRITEFUNCTION, write_callback);
.SH DESCRIPTION
Pass a pointer to your callback function, which should match the prototype
shown above.
This callback function gets called by libcurl as soon as there is data
received that needs to be saved. For most transfers, this callback gets called
many times and each invoke delivers another chunk of data. \fIptr\fP points to
the delivered data, and the size of that data is \fInmemb\fP; \fIsize\fP is
always 1.
The callback function is passed as much data as possible in all invokes, but
you must not make any assumptions. It may be one byte, it may be
thousands. The maximum amount of body data that is be passed to the write
callback is defined in the curl.h header file: \fICURL_MAX_WRITE_SIZE\fP (the
usual default is 16K). If \fICURLOPT_HEADER(3)\fP is enabled, which makes
header data get passed to the write callback, you can get up to
\fICURL_MAX_HTTP_HEADER\fP bytes of header data passed into it. This usually
means 100K.
This function may be called with zero bytes data if the transferred file is
empty.
The data passed to this function is not null-terminated!
Set the \fIuserdata\fP argument with the \fICURLOPT_WRITEDATA(3)\fP option.
Your callback should return the number of bytes actually taken care of. If
that amount differs from the amount passed to your callback function, it
signals an error condition to the library. This causes the transfer to get
aborted and the libcurl function used returns \fICURLE_WRITE_ERROR\fP.
You can also abort the transfer by returning CURL_WRITEFUNC_ERROR. (7.87.0)
If the callback function returns CURL_WRITEFUNC_PAUSE it pauses this
transfer. See \fIcurl_easy_pause(3)\fP for further details.
Set this option to NULL to get the internal default function used instead of
your callback. The internal default function writes the data to the FILE *
given with \fICURLOPT_WRITEDATA(3)\fP.
This option does not enable HSTS, you need to use \fICURLOPT_HSTS_CTRL(3)\fP to
do that.
.SH DEFAULT
libcurl uses 'fwrite' as a callback by default.
.SH PROTOCOLS
For all protocols
.SH EXAMPLE
.nf
struct memory {
char *response;
size_t size;
};
static size_t cb(void *data, size_t size, size_t nmemb, void *clientp)
{
size_t realsize = size * nmemb;
struct memory *mem = (struct memory *)clientp;
char *ptr = realloc(mem->response, mem->size + realsize + 1);
if(ptr == NULL)
return 0; /* out of memory! */
mem->response = ptr;
memcpy(&(mem->response[mem->size]), data, realsize);
mem->size += realsize;
mem->response[mem->size] = 0;
return realsize;
}
struct memory chunk = {0};
CURLcode res;
CURL *curl_handle = curl_easy_init();
if (curl_handle)
{
/* send all data to this function */
curl_easy_setopt(curl_handle, CURLOPT_WRITEFUNCTION, cb);
/* we pass our 'chunk' struct to the callback function */
curl_easy_setopt(curl_handle, CURLOPT_WRITEDATA, (void *)&chunk);
/* send a request */
res = curl_easy_perform(curl_handle);
/* remember to free the buffer */
free(chunk.response);
curl_easy_cleanup(curl_handle);
}
.fi
.SH AVAILABILITY
Support for the CURL_WRITEFUNC_PAUSE return code was added in version 7.18.0.
.SH RETURN VALUE
This returns CURLE_OK.
.SH "SEE ALSO"
.BR CURLOPT_WRITEDATA (3),
.BR CURLOPT_READFUNCTION (3),
.BR CURLOPT_HEADERFUNCTION (3)
man/man3/CURLOPT_IPRESOLVE.3 0000644 00000004751 14751172371 0011040 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_IPRESOLVE 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_IPRESOLVE \- IP protocol version to use
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_IPRESOLVE, long resolve);
.fi
.SH DESCRIPTION
Allows an application to select what kind of IP addresses to use when
establishing a connection or choosing one from the connection pool. This is
interesting when using host names that resolve to more than one IP family.
If the URL provided for a transfer contains a numerical IP version as a host
name, this option does not override or prohibit libcurl from using that IP
version.
Available values for this option are:
.IP CURL_IPRESOLVE_WHATEVER
Default, can use addresses of all IP versions that your system allows.
.IP CURL_IPRESOLVE_V4
Uses only IPv4 addresses.
.IP CURL_IPRESOLVE_V6
Uses only IPv6 addresses.
.SH DEFAULT
CURL_IPRESOLVE_WHATEVER
.SH PROTOCOLS
All
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/foo.bin");
/* of all addresses example.com resolves to, only IPv6 ones are used */
curl_easy_setopt(curl, CURLOPT_IPRESOLVE, CURL_IPRESOLVE_V6);
ret = curl_easy_perform(curl);
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Always
.SH RETURN VALUE
Returns CURLE_OK
.SH "SEE ALSO"
.BR CURLOPT_HTTP_VERSION (3),
.BR CURLOPT_RESOLVE (3),
.BR CURLOPT_SSLVERSION (3)
man/man3/CURLOPT_REFERER.3 0000644 00000004403 14751172371 0010554 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_REFERER 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_REFERER \- the HTTP referer header
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_REFERER, char *where);
.fi
.SH DESCRIPTION
Pass a pointer to a null-terminated string as parameter. It is used to set the
Referer: header field in the HTTP request sent to the remote server. You can
set any custom header with \fICURLOPT_HTTPHEADER(3)\fP.
The application does not have to keep the string around after setting this
option.
.SH DEFAULT
NULL
.SH PROTOCOLS
HTTP
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
/* tell it where we found the link to this place */
curl_easy_setopt(curl, CURLOPT_REFERER, "https://example.com/aboutme.html");
curl_easy_perform(curl);
}
.fi
.SH AVAILABILITY
If built with HTTP support
.SH RETURN VALUE
Returns CURLE_OK if HTTP support is enabled, CURLE_UNKNOWN_OPTION if not, or
CURLE_OUT_OF_MEMORY if there was insufficient heap space.
.SH "SEE ALSO"
.BR CURLINFO_REDIRECT_URL (3),
.BR CURLINFO_REFERER (3),
.BR CURLOPT_HTTPHEADER (3),
.BR CURLOPT_USERAGENT (3)
man/man3/CURLOPT_TIMEVALUE.3 0000644 00000004404 14751172371 0011016 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_TIMEVALUE 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_TIMEVALUE \- time value for conditional
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_TIMEVALUE, long val);
.fi
.SH DESCRIPTION
Pass a long \fIval\fP as parameter. This should be the time counted as seconds
since 1 Jan 1970, and the time is used in a condition as specified with
\fICURLOPT_TIMECONDITION(3)\fP.
On systems with 32 bit 'long' variables (such as Windows), this option cannot
set dates beyond the year 2038. Consider \fICURLOPT_TIMEVALUE_LARGE(3)\fP
instead.
.SH DEFAULT
0
.SH PROTOCOLS
HTTP, FTP, RTSP, and FILE
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
/* January 1, 2020 is 1577833200 */
curl_easy_setopt(curl, CURLOPT_TIMEVALUE, 1577833200L);
/* If-Modified-Since the above time stamp */
curl_easy_setopt(curl, CURLOPT_TIMECONDITION, CURL_TIMECOND_IFMODSINCE);
/* Perform the request */
curl_easy_perform(curl);
}
.fi
.SH AVAILABILITY
Always
.SH RETURN VALUE
Returns CURLE_OK
.SH "SEE ALSO"
.BR CURLOPT_TIMECONDITION (3),
.BR CURLOPT_TIMEVALUE_LARGE (3)
man/man3/curl_easy_reset.3 0000644 00000004006 14751172371 0011441 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.TH curl_easy_reset 3 "September 26, 2023" "libcurl 8.4.0" "libcurl"
.SH NAME
curl_easy_reset - reset all options of a libcurl session handle
.SH SYNOPSIS
.nf
#include <curl/curl.h>
void curl_easy_reset(CURL *handle);
.fi
.SH DESCRIPTION
Re-initializes all options previously set on a specified CURL handle to the
default values. This puts back the handle to the same state as it was in when
it was just created with \fIcurl_easy_init(3)\fP.
It does not change the following information kept in the handle: live
connections, the Session ID cache, the DNS cache, the cookies, the shares or
the alt-svc cache.
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
/* ... the handle is used and options are set ... */
curl_easy_reset(curl);
.fi
.SH AVAILABILITY
This function was added in libcurl 7.12.1
.SH RETURN VALUE
Nothing
.SH "SEE ALSO"
.BR curl_easy_cleanup (3),
.BR curl_easy_duphandle (3),
.BR curl_easy_init (3),
.BR curl_easy_setopt (3)
man/man3/CURLOPT_SSL_OPTIONS.3 0000644 00000010733 14751172371 0011341 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_SSL_OPTIONS 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_SSL_OPTIONS \- SSL behavior options
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_SSL_OPTIONS, long bitmask);
.fi
.SH DESCRIPTION
Pass a long with a bitmask to tell libcurl about specific SSL
behaviors. Available bits:
.IP CURLSSLOPT_ALLOW_BEAST
Tells libcurl to not attempt to use any workarounds for a security flaw in the
SSL3 and TLS1.0 protocols. If this option is not used or this bit is set to 0,
the SSL layer libcurl uses may use a work-around for this flaw although it
might cause interoperability problems with some (older) SSL implementations.
WARNING: avoiding this work-around lessens the security, and by setting this
option to 1 you ask for exactly that. This option is only supported for
Secure Transport and OpenSSL.
.IP CURLSSLOPT_NO_REVOKE
Tells libcurl to disable certificate revocation checks for those SSL backends
where such behavior is present. This option is only supported for Schannel
(the native Windows SSL library), with an exception in the case of Windows'
Untrusted Publishers block list which it seems cannot be bypassed. (Added in
7.44.0)
.IP CURLSSLOPT_NO_PARTIALCHAIN
Tells libcurl to not accept "partial" certificate chains, which it otherwise
does by default. This option is only supported for OpenSSL and fails the
certificate verification if the chain ends with an intermediate certificate
and not with a root cert. (Added in 7.68.0)
.IP CURLSSLOPT_REVOKE_BEST_EFFORT
Tells libcurl to ignore certificate revocation checks in case of missing or
offline distribution points for those SSL backends where such behavior is
present. This option is only supported for Schannel (the native Windows SSL
library). If combined with \fICURLSSLOPT_NO_REVOKE\fP, the latter takes
precedence. (Added in 7.70.0)
.IP CURLSSLOPT_NATIVE_CA
Tell libcurl to use the operating system's native CA store for certificate
verification. Works only on Windows, Linux (Debian, Ubuntu, Gentoo, Fedora,
RHEL), macOS, Android and iOS when built to use wolfSSL (since 8.3.0) or on
Windows when built to use OpenSSL. If you set this option and also set a CA
certificate file or directory then during verification those certificates
are searched in addition to the native CA store.
(Added in 7.71.0)
.IP CURLSSLOPT_AUTO_CLIENT_CERT
Tell libcurl to automatically locate and use a client certificate for
authentication, when requested by the server. This option is only supported
for Schannel (the native Windows SSL library). Prior to 7.77.0 this was the
default behavior in libcurl with Schannel. Since the server can request any
certificate that supports client authentication in the OS certificate store it
could be a privacy violation and unexpected.
(Added in 7.77.0)
.SH DEFAULT
0
.SH PROTOCOLS
All TLS-based protocols
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/");
/* weaken TLS only for use with silly servers */
curl_easy_setopt(curl, CURLOPT_SSL_OPTIONS, (long)CURLSSLOPT_ALLOW_BEAST |
CURLSSLOPT_NO_REVOKE);
ret = curl_easy_perform(curl);
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Added in 7.25.0
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR CURLOPT_PROXY_SSL_OPTIONS (3),
.BR CURLOPT_SSL_CIPHER_LIST (3),
.BR CURLOPT_SSLVERSION (3)
man/man3/CURLOPT_HSTS_CTRL.3 0000644 00000005067 14751172371 0011076 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_HSTS_CTRL 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_HSTS_CTRL \- control HSTS behavior
.SH SYNOPSIS
.nf
#include <curl/curl.h>
#define CURLHSTS_ENABLE (1<<0)
#define CURLHSTS_READONLYFILE (1<<1)
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_HSTS_CTRL, long bitmask);
.fi
.SH DESCRIPTION
HSTS (HTTP Strict Transport Security) means that an HTTPS server can instruct
the client to not contact it again over clear-text HTTP for a certain period
into the future. libcurl then automatically redirects HTTP attempts to such
hosts to instead use HTTPS. This is done by libcurl retaining this knowledge
in an in-memory cache.
Populate the long \fIbitmask\fP with the correct set of features to instruct
libcurl how to handle HSTS for the transfers using this handle.
.SH BITS
.IP "CURLHSTS_ENABLE"
Enable the in-memory HSTS cache for this handle.
.IP "CURLHSTS_READONLYFILE"
Make the HSTS file (if specified) read-only - makes libcurl not save the cache
to the file when closing the handle.
.SH DEFAULT
0. HSTS is disabled by default.
.SH PROTOCOLS
HTTPS and HTTP
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_HSTS_CTRL, (long)CURLHSTS_ENABLE);
curl_easy_perform(curl);
}
.fi
.SH AVAILABILITY
Added in 7.74.0
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR CURLOPT_ALTSVC (3),
.BR CURLOPT_CONNECT_TO (3),
.BR CURLOPT_HSTS (3),
.BR CURLOPT_RESOLVE (3)
man/man3/CURLOPT_SERVER_RESPONSE_TIMEOUT.3 0000644 00000005446 14751172371 0013224 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_SERVER_RESPONSE_TIMEOUT 3 "September 27, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_SERVER_RESPONSE_TIMEOUT \- time allowed to wait for server response
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_SERVER_RESPONSE_TIMEOUT,
long timeout);
.fi
.SH DESCRIPTION
Pass a long. Causes libcurl to set a \fItimeout\fP period (in seconds) on the
amount of time that the server is allowed to take in order to send a response
message for a command before the session is considered dead. While libcurl is
waiting for a response, this value overrides \fICURLOPT_TIMEOUT(3)\fP. It is
recommended that if used in conjunction with \fICURLOPT_TIMEOUT(3)\fP, you set
\fICURLOPT_SERVER_RESPONSE_TIMEOUT(3)\fP to a value smaller than
\fICURLOPT_TIMEOUT(3)\fP.
This option was formerly known as CURLOPT_FTP_RESPONSE_TIMEOUT.
.SH DEFAULT
None
.SH PROTOCOLS
FTP, IMAP, POP3, SMTP, and SSH
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "ftp://example.com/slow.txt");
/* wait no more than 23 seconds */
curl_easy_setopt(curl, CURLOPT_SERVER_RESPONSE_TIMEOUT, 23L);
ret = curl_easy_perform(curl);
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Added in 7.10.8. Used under this name since 7.20.0
Support for SSH is predicated on a new enough (1.11.0) version of libssh2
being available when compiling libcurl.
.SH RETURN VALUE
Returns CURLE_OK if supported, and CURLE_UNKNOWN_OPTION if not. Returns
CURLE_BAD_FUNCTION_ARGUMENT if set to a negative value or a value that when
converted to milliseconds is too large.
.SH "SEE ALSO"
.BR CURLOPT_CONNECTTIMEOUT (3),
.BR CURLOPT_LOW_SPEED_LIMIT (3),
.BR CURLOPT_TIMEOUT (3)
man/man3/CURLOPT_STREAM_DEPENDS_E.3 0000644 00000005655 14751172371 0012075 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_STREAM_DEPENDS_E 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_STREAM_DEPENDS_E \- stream this transfer depends on exclusively
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_STREAM_DEPENDS_E,
CURL *dephandle);
.fi
.SH DESCRIPTION
Pass a CURL * pointer in \fIdephandle\fP to identify the stream within the
same connection that this stream is depending upon exclusively. That means it
depends on it and sets the Exclusive bit.
The spec says "Including a dependency expresses a preference to allocate
resources to the identified stream rather than to the dependent stream."
Setting a dependency with the exclusive flag for a reprioritized stream causes
all the dependencies of the new parent stream to become dependent on the
reprioritized stream.
This option can be set during transfer.
\fIdephandle\fP must not be the same as \fIhandle\fP, that makes this function
return an error. It must be another easy handle, and it also needs to be a
handle of a transfer that is about to be sent over the same HTTP/2 connection
for this option to have an actual effect.
.SH DEFAULT
NULL
.SH PROTOCOLS
HTTP/2
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
CURL *curl2 = curl_easy_init(); /* a second handle */
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/one");
/* the second depends on the first */
curl_easy_setopt(curl2, CURLOPT_URL, "https://example.com/two");
curl_easy_setopt(curl2, CURLOPT_STREAM_DEPENDS_E, curl);
/* then add both to a multi handle and transfer them! */
}
.fi
.SH AVAILABILITY
Added in 7.46.0
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR CURLMOPT_PIPELINING (3),
.BR CURLOPT_HTTP_VERSION (3),
.BR CURLOPT_STREAM_DEPENDS (3),
.BR CURLOPT_STREAM_WEIGHT (3)
man/man3/CURLOPT_IOCTLDATA.3 0000644 00000004351 14751172371 0010770 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_IOCTLDATA 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_IOCTLDATA \- pointer passed to I/O callback
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_IOCTLDATA, void *pointer);
.fi
.SH DESCRIPTION
Pass the \fIpointer\fP that is untouched by libcurl and passed as the 3rd
argument in the ioctl callback set with \fICURLOPT_IOCTLFUNCTION(3)\fP.
.SH DEFAULT
By default, the value of this parameter is NULL.
.SH PROTOCOLS
Used with HTTP
.SH EXAMPLE
.nf
static curlioerr ioctl_callback(CURL *handle, int cmd, void *clientp)
{
struct data *io = (struct data *)clientp;
if(cmd == CURLIOCMD_RESTARTREAD) {
lseek(fd, 0, SEEK_SET);
current_offset = 0;
return CURLIOE_OK;
}
return CURLIOE_UNKNOWNCMD;
}
{
struct data ioctl_data;
curl_easy_setopt(curl, CURLOPT_IOCTLFUNCTION, ioctl_callback);
curl_easy_setopt(curl, CURLOPT_IOCTLDATA, &ioctl_data);
}
.fi
.SH AVAILABILITY
Added in 7.12.3. Deprecated since 7.18.0.
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR CURLOPT_IOCTLFUNCTION (3),
.BR CURLOPT_SEEKFUNCTION (3)
man/man3/CURLOPT_PROXY_SSLKEY.3 0000644 00000005314 14751172371 0011477 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_PROXY_SSLKEY 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_PROXY_SSLKEY \- private key file for HTTPS proxy client cert
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_PROXY_SSLKEY, char *keyfile);
.fi
.SH DESCRIPTION
Pass a pointer to a null-terminated string as parameter. The string should be
the file name of your private key used for connecting to the HTTPS proxy. The
default format is "PEM" and can be changed with
\fICURLOPT_PROXY_SSLKEYTYPE(3)\fP.
(Windows, iOS and Mac OS X) This option is ignored by Secure Transport and
Schannel SSL backends because they expect the private key to be already
present in the key chain or PKCS#12 file containing the certificate.
The application does not have to keep the string around after setting this
option.
.SH DEFAULT
NULL
.SH PROTOCOLS
All
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/");
curl_easy_setopt(curl, CURLOPT_PROXY, "https://proxy");
curl_easy_setopt(curl, CURLOPT_PROXY_SSLCERT, "client.pem");
curl_easy_setopt(curl, CURLOPT_PROXY_SSLKEY, "key.pem");
curl_easy_setopt(curl, CURLOPT_PROXY_KEYPASSWD, "s3cret");
ret = curl_easy_perform(curl);
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Added in 7.52.0
If built TLS enabled.
.SH RETURN VALUE
Returns CURLE_OK if TLS is supported, CURLE_UNKNOWN_OPTION if not, or
CURLE_OUT_OF_MEMORY if there was insufficient heap space.
.SH "SEE ALSO"
.BR CURLOPT_PROXY_SSLCERT (3),
.BR CURLOPT_PROXY_SSLKEYTYPE (3),
.BR CURLOPT_SSLCERT (3),
.BR CURLOPT_SSLKEY (3),
.BR CURLOPT_SSLKEYTYPE (3)
man/man3/CURLOPT_RANDOM_FILE.3 0000644 00000004304 14751172371 0011241 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_RANDOM_FILE 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_RANDOM_FILE \- file to read random data from
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_RANDOM_FILE, char *path);
.fi
.SH DESCRIPTION
Deprecated option. It serves no purpose anymore.
Pass a char * to a null-terminated file name. The file might be used to read
from to seed the random engine for SSL and more.
The application does not have to keep the string around after setting this
option.
.SH DEFAULT
NULL, not used
.SH PROTOCOLS
All
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/");
curl_easy_setopt(curl, CURLOPT_RANDOM_FILE, "junk.txt");
ret = curl_easy_perform(curl);
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
If built with TLS enabled. Only the OpenSSL backend uses this, and only with
OpenSSL versions before 1.1.0.
This option was deprecated in 7.84.0.
.SH RETURN VALUE
Returns CURLE_OK on success or
CURLE_OUT_OF_MEMORY if there was insufficient heap space.
.SH "SEE ALSO"
.BR CURLOPT_EGDSOCKET (3)
man/man3/CURLOPT_FTP_USE_EPRT.3 0000644 00000005074 14751172371 0011466 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_FTP_USE_EPRT 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_FTP_USE_EPRT \- use EPRT for FTP
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_FTP_USE_EPRT, long enabled);
.fi
.SH DESCRIPTION
Pass a long. If the value is 1, it tells curl to use the EPRT command when
doing active FTP downloads (which is enabled by
\fICURLOPT_FTPPORT(3)\fP). Using EPRT means that libcurl first attempts to use
EPRT before using PORT, but if you pass zero to this option, it avoids using
EPRT, only plain PORT.
The EPRT command is a slightly newer addition to the FTP protocol than PORT
and is the preferred command to use since it enables IPv6 to be used. Very old
FTP servers might not support it, which is why libcurl has a fallback
mechanism. Sometimes that fallback is not enough and then this option might
come handy.
If the server is an IPv6 host, this option has no effect as EPRT is necessary
then.
.SH DEFAULT
.SH PROTOCOLS
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "ftp://example.com/file.txt");
/* contact us back, aka "active" FTP */
curl_easy_setopt(curl, CURLOPT_FTPPORT, "-");
/* FTP the way the neanderthals did it */
curl_easy_setopt(curl, CURLOPT_FTP_USE_EPRT, 0L);
ret = curl_easy_perform(curl);
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Added in 7.10.5
.SH RETURN VALUE
Returns CURLE_OK
.SH "SEE ALSO"
.BR CURLOPT_FTP_USE_EPSV (3),
.BR CURLOPT_FTPPORT (3)
man/man3/CURLOPT_LOCALPORT.3 0000644 00000004322 14751172371 0011021 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_LOCALPORT 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_LOCALPORT \- local port number to use for socket
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_LOCALPORT, long port);
.fi
.SH DESCRIPTION
Pass a long. This sets the local port number of the socket used for the
connection. This can be used in combination with \fICURLOPT_INTERFACE(3)\fP
and you are recommended to use \fICURLOPT_LOCALPORTRANGE(3)\fP as well when
this option is set. Valid port numbers are 1 - 65535.
.SH DEFAULT
0, disabled - use whatever the system thinks is fine
.SH PROTOCOLS
All
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/foo.bin");
curl_easy_setopt(curl, CURLOPT_LOCALPORT, 49152L);
/* and try 20 more ports following that */
curl_easy_setopt(curl, CURLOPT_LOCALPORTRANGE, 20L);
ret = curl_easy_perform(curl);
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Added in 7.15.2
.SH RETURN VALUE
Returns CURLE_OK
.SH "SEE ALSO"
.BR CURLINFO_LOCAL_PORT (3),
.BR CURLOPT_INTERFACE (3),
.BR CURLOPT_LOCALPORTRANGE (3)
man/man3/CURLOPT_HTTP_CONTENT_DECODING.3 0000644 00000004200 14751172371 0012662 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_HTTP_CONTENT_DECODING 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_HTTP_CONTENT_DECODING \- HTTP content decoding control
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_HTTP_CONTENT_DECODING,
long enabled);
.SH DESCRIPTION
Pass a long to tell libcurl how to act on content decoding. If set to zero,
content decoding is disabled. If set to 1 it is enabled. Libcurl has no
default content decoding but requires you to use
\fICURLOPT_ACCEPT_ENCODING(3)\fP for that.
.SH DEFAULT
1
.SH PROTOCOLS
HTTP
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
CURLcode ret;
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/");
curl_easy_setopt(curl, CURLOPT_HTTP_CONTENT_DECODING, 0L);
ret = curl_easy_perform(curl);
}
.fi
.SH AVAILABILITY
Added in 7.16.2
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR CURLOPT_ACCEPT_ENCODING (3),
.BR CURLOPT_DEBUGFUNCTION (3),
.BR CURLOPT_STDERR (3)
man/man3/curl_formget.3 0000644 00000005411 14751172371 0010742 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.TH curl_formget 3 "September 26, 2023" "libcurl 8.4.0" "libcurl"
.SH NAME
curl_formget - serialize a previously built multipart form POST chain
.SH SYNOPSIS
.nf
.B #include <curl/curl.h>
int curl_formget(struct curl_httppost * form, void *userp,
curl_formget_callback append );
.SH DESCRIPTION
curl_formget() is used to serialize data previously built/appended with
\fIcurl_formadd(3)\fP. Accepts a void pointer as second argument named
\fIuserp\fP which is passed as the first argument to the curl_formget_callback
function.
.BI "typedef size_t (*curl_formget_callback)(void *" userp, " const char *" buf,
.BI " size_t " len ");"
The curl_formget_callback is invoked for each part of the HTTP POST chain. The
character buffer passed to the callback must not be freed. The callback should
return the buffer length passed to it on success.
If the \fBCURLFORM_STREAM\fP option is used in the formpost, it prevents
\fIcurl_formget(3)\fP from working until you have performed the actual HTTP
request. This, because first then does libcurl known which actual read
callback to use!
.SH EXAMPLE
.nf
size_t print_httppost_callback(void *arg, const char *buf, size_t len)
{
fwrite(buf, len, 1, stdout);
(*(size_t *) arg) += len;
return len;
}
size_t print_httppost(struct curl_httppost *post)
{
size_t total_size = 0;
if(curl_formget(post, &total_size, print_httppost_callback)) {
return (size_t) -1;
}
return total_size;
}
.SH AVAILABILITY
This function was added in libcurl 7.15.5. The form API is deprecated in
libcurl 7.56.0.
.SH RETURN VALUE
0 means everything was OK, non-zero means an error occurred
.SH "SEE ALSO"
.BR curl_formadd (3),
.BR curl_mime_init (3)
man/man3/CURLOPT_FNMATCH_DATA.3 0000644 00000004473 14751172371 0011342 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_FNMATCH_DATA 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_FNMATCH_DATA \- pointer passed to the fnmatch callback
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_FNMATCH_DATA,
void *pointer);
.SH DESCRIPTION
Pass a pointer that is untouched by libcurl and passed as the ptr argument to
the \fICURLOPT_FNMATCH_FUNCTION(3)\fP.
.SH DEFAULT
NULL
.SH PROTOCOLS
FTP
.SH EXAMPLE
.nf
static int my_fnmatch(void *clientp,
const char *pattern, const char *string)
{
struct local_stuff *data = (struct local_stuff *)clientp;
if(string_match(pattern, string))
return CURL_FNMATCHFUNC_MATCH;
else
return CURL_FNMATCHFUNC_NOMATCH;
}
{
struct local_stuff local_data;
curl_easy_setopt(curl, CURLOPT_URL, "ftp://ftp.example.com/file*");
curl_easy_setopt(curl, CURLOPT_WILDCARDMATCH, 1L);
curl_easy_setopt(curl, CURLOPT_FNMATCH_FUNCTION, my_fnmatch);
curl_easy_setopt(curl, CURLOPT_FNMATCH_DATA, &local_data);
}
.fi
.SH AVAILABILITY
Added in 7.21.0
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR CURLOPT_FNMATCH_FUNCTION (3),
.BR CURLOPT_WILDCARDMATCH (3)
man/man3/CURLOPT_EXPECT_100_TIMEOUT_MS.3 0000644 00000004336 14751172371 0012644 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_EXPECT_100_TIMEOUT_MS 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_EXPECT_100_TIMEOUT_MS \- timeout for Expect: 100-continue response
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_EXPECT_100_TIMEOUT_MS,
long milliseconds);
.SH DESCRIPTION
Pass a long to tell libcurl the number of \fImilliseconds\fP to wait for a
server response with the HTTP status 100 (Continue), 417 (Expectation Failed)
or similar after sending an HTTP request containing an Expect: 100-continue
header. If this times out before a response is received, the request body is
sent anyway.
.SH DEFAULT
1000 milliseconds
.SH PROTOCOLS
HTTP
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
/* wait 3 seconds for 100-continue */
curl_easy_setopt(curl, CURLOPT_EXPECT_100_TIMEOUT_MS, 3000L);
curl_easy_perform(curl);
}
.fi
.SH AVAILABILITY
Added in 7.36.0
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR CURLOPT_HTTPPOST (3),
.BR CURLOPT_POST (3)
man/man3/curl_version.3 0000644 00000003367 14751172371 0010774 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.TH curl_version 3 "September 26, 2023" "libcurl 8.4.0" "libcurl"
.SH NAME
curl_version - returns the libcurl version string
.SH SYNOPSIS
.nf
#include <curl/curl.h>
char *curl_version();
.fi
.SH DESCRIPTION
Returns a human readable string with the version number of libcurl and some of
its important components (like OpenSSL version).
We recommend using \fIcurl_version_info(3)\fP instead!
.SH EXAMPLE
.nf
printf("libcurl version %s\\n", curl_version());
.fi
.SH AVAILABILITY
Always
.SH RETURN VALUE
A pointer to a null-terminated string. The string resides in a statically
allocated buffer and must not be freed by the caller.
.SH "SEE ALSO"
.BR curl_version_info (3)
man/man3/CURLOPT_SSLCERT_BLOB.3 0000644 00000005614 14751172371 0011404 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_SSLCERT_BLOB 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_SSLCERT_BLOB \- SSL client certificate from memory blob
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_SSLCERT_BLOB,
struct curl_blob *stblob);
.fi
.SH DESCRIPTION
Pass a pointer to a curl_blob structure, which contains (pointer and size) a
client certificate. The format must be "P12" on Secure Transport or
Schannel. The format must be "P12" or "PEM" on OpenSSL. The format must be
"DER" or "PEM" on mbedTLS. The format must be specified with
\fICURLOPT_SSLCERTTYPE(3)\fP.
If the blob is initialized with the flags member of struct curl_blob set to
CURL_BLOB_COPY, the application does not have to keep the buffer around after
setting this.
This option is an alternative to \fICURLOPT_SSLCERT(3)\fP which instead
expects a file name as input.
.SH DEFAULT
NULL
.SH PROTOCOLS
All TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc.
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
struct curl_blob stblob;
stblob.data = certificateData;
stblob.len = filesize;
stblob.flags = CURL_BLOB_COPY;
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/");
curl_easy_setopt(curl, CURLOPT_SSLCERT_BLOB, &stblob);
curl_easy_setopt(curl, CURLOPT_SSLCERTTYPE, "P12");
curl_easy_setopt(curl, CURLOPT_KEYPASSWD, "s3cret");
ret = curl_easy_perform(curl);
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Added in 7.71.0. This option is supported by the OpenSSL, Secure Transport,
Schannel and mbedTLS (since 7.78.0) backends.
.SH RETURN VALUE
Returns CURLE_OK if TLS enabled, CURLE_UNKNOWN_OPTION if not, or
CURLE_OUT_OF_MEMORY if there was insufficient heap space.
.SH "SEE ALSO"
.BR CURLOPT_SSLCERTTYPE (3),
.BR CURLOPT_SSLKEY (3),
.BR CURLOPT_KEYPASSWD (3)
man/man3/CURLOPT_COOKIEFILE.3 0000644 00000007152 14751172371 0011077 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_COOKIEFILE 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_COOKIEFILE \- file name to read cookies from
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_COOKIEFILE, char *filename);
.fi
.SH DESCRIPTION
Pass a pointer to a null-terminated string as parameter. It should point to
the file name of your file holding cookie data to read. The cookie data can be
in either the old Netscape / Mozilla cookie data format or just regular HTTP
headers (Set-Cookie style) dumped to a file.
It also enables the cookie engine, making libcurl parse and send cookies on
subsequent requests with this handle.
By passing the empty string ("") to this option, you enable the cookie engine
without reading any initial cookies. If you tell libcurl the file name is "-"
(just a single minus sign), libcurl instead reads from stdin.
This option only \fBreads\fP cookies. To make libcurl write cookies to file,
see \fICURLOPT_COOKIEJAR(3)\fP.
If you read cookies from a plain HTTP headers file and it does not specify a
domain in the Set-Cookie line, then the cookie is not sent since the cookie
domain cannot match the target URL's. To address this, set a domain in
Set-Cookie line (doing that includes subdomains) or preferably: use the
Netscape format.
If you use this option multiple times, you add more files to read cookies
from.
The application does not have to keep the string around after setting this
option.
Setting this option to NULL (since 7.77.0) explicitly disables the cookie
engine and clears the list of files to read cookies from.
.SH SECURITY
This document previously mentioned how specifying a non-existing file can also
enable the cookie engine. While true, we strongly advise against using that
method as it is too hard to be sure that files that stay that way in the long
run.
.SH DEFAULT
NULL
.SH PROTOCOLS
HTTP
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/foo.bin");
/* get cookies from an existing file */
curl_easy_setopt(curl, CURLOPT_COOKIEFILE, "/tmp/cookies.txt");
ret = curl_easy_perform(curl);
curl_easy_cleanup(curl);
}
.fi
.SH "Cookie file format"
The cookie file format and general cookie concepts in curl are described
online here: https://curl.se/docs/http-cookies.html
.SH AVAILABILITY
As long as HTTP is supported
.SH RETURN VALUE
Returns CURLE_OK if HTTP is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR CURLOPT_COOKIE (3),
.BR CURLOPT_COOKIEJAR (3),
.BR CURLOPT_COOKIESESSION (3)
man/man3/CURLOPT_INTERLEAVEFUNCTION.3 0000644 00000007646 14751172371 0012302 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_INTERLEAVEFUNCTION 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_INTERLEAVEFUNCTION \- callback for RTSP interleaved data
.SH SYNOPSIS
.nf
#include <curl/curl.h>
size_t interleave_callback(void *ptr, size_t size, size_t nmemb,
void *userdata);
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_INTERLEAVEFUNCTION,
interleave_callback);
.SH DESCRIPTION
Pass a pointer to your callback function, which should match the prototype
shown above.
This callback function gets called by libcurl as soon as it has received
interleaved RTP data. This function gets called for each $ block and therefore
contains exactly one upper-layer protocol unit (e.g. one RTP packet). Curl
writes the interleaved header as well as the included data for each call. The
first byte is always an ASCII dollar sign. The dollar sign is followed by a
one byte channel identifier and then a 2 byte integer length in network byte
order. See RFC 2326 Section 10.12 for more information on how RTP interleaving
behaves. If unset or set to NULL, curl uses the default write function.
Interleaved RTP poses some challenges for the client application. Since the
stream data is sharing the RTSP control connection, it is critical to service
the RTP in a timely fashion. If the RTP data is not handled quickly,
subsequent response processing may become unreasonably delayed and the
connection may close. The application may use \fICURL_RTSPREQ_RECEIVE\fP to
service RTP data when no requests are desired. If the application makes a
request, (e.g. \fICURL_RTSPREQ_PAUSE\fP) then the response handler processes
any pending RTP data before marking the request as finished.
The \fICURLOPT_INTERLEAVEDATA(3)\fP is passed in the \fIuserdata\fP argument in
the callback.
Your callback should return the number of bytes actually taken care of. If
that amount differs from the amount passed to your callback function, it
signals an error condition to the library. This causes the transfer to abort
and the libcurl function used returns \fICURLE_WRITE_ERROR\fP.
You can also abort the transfer by returning CURL_WRITEFUNC_ERROR. (7.87.0)
.SH DEFAULT
NULL, the interleave data is then passed to the regular write function:
\fICURLOPT_WRITEFUNCTION(3)\fP.
.SH PROTOCOLS
RTSP
.SH EXAMPLE
.nf
static size_t rtp_write(void *ptr, size_t size, size_t nmemb, void *user)
{
struct local *l = (struct local *)user;
/* take care of the packet in 'ptr', then return... */
return size * nmemb;
}
{
struct local rtp_data;
curl_easy_setopt(curl, CURLOPT_INTERLEAVEFUNCTION, rtp_write);
curl_easy_setopt(curl, CURLOPT_INTERLEAVEDATA, &rtp_data);
}
.fi
.SH AVAILABILITY
Added in 7.20.0
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR CURLOPT_INTERLEAVEDATA (3),
.BR CURLOPT_RTSP_REQUEST (3)
man/man3/CURLINFO_CONDITION_UNMET.3 0000644 00000005520 14751172371 0012052 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLINFO_CONDITION_UNMET 3 "September 26, 2023" "libcurl 8.4.0" "libcurl"
.SH NAME
CURLINFO_CONDITION_UNMET \- get info on unmet time conditional or 304 HTTP response.
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_getinfo(CURL *handle, CURLINFO_CONDITION_UNMET,
long *unmet);
.fi
.SH DESCRIPTION
Pass a pointer to a long to receive the number 1 if the condition provided in
the previous request did not match (see \fICURLOPT_TIMECONDITION(3)\fP). Alas,
if this returns a 1 you know that the reason you did not get data in return is
because it did not fulfill the condition. The long this argument points to
gets a zero stored if the condition instead was met. This can also return 1 if
the server responded with a 304 HTTP status code, for example after sending a
custom "If-Match-*" header.
.SH PROTOCOLS
HTTP and some
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
/* January 1, 2020 is 1577833200 */
curl_easy_setopt(curl, CURLOPT_TIMEVALUE, 1577833200L);
/* If-Modified-Since the above time stamp */
curl_easy_setopt(curl, CURLOPT_TIMECONDITION,
(long)CURL_TIMECOND_IFMODSINCE);
/* Perform the request */
res = curl_easy_perform(curl);
if(!res) {
/* check the time condition */
long unmet;
res = curl_easy_getinfo(curl, CURLINFO_CONDITION_UNMET, &unmet);
if(!res) {
printf("The time condition was %sfulfilled\\n", unmet?"NOT":"");
}
}
}
.fi
.SH AVAILABILITY
Added in 7.19.4
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR curl_easy_getinfo (3),
.BR curl_easy_setopt (3),
.BR CURLOPT_TIMECONDITION (3),
.BR CURLOPT_TIMEVALUE (3)
man/man3/CURLINFO_STARTTRANSFER_TIME.3 0000644 00000004663 14751172371 0012443 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLINFO_STARTTRANSFER_TIME 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLINFO_STARTTRANSFER_TIME \- get the time until the first byte is received
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_getinfo(CURL *handle, CURLINFO_STARTTRANSFER_TIME,
double *timep);
.fi
.SH DESCRIPTION
Pass a pointer to a double to receive the time, in seconds, it took from the
start until the first byte is received by libcurl. This includes
\fICURLINFO_PRETRANSFER_TIME(3)\fP and also the time the server needs to
calculate the result.
When a redirect is followed, the time from each request is added together.
See also the TIMES overview in the \fIcurl_easy_getinfo(3)\fP man page.
.SH PROTOCOLS
All
.SH EXAMPLE
.nf
curl = curl_easy_init();
if(curl) {
double start;
curl_easy_setopt(curl, CURLOPT_URL, url);
res = curl_easy_perform(curl);
if(CURLE_OK == res) {
res = curl_easy_getinfo(curl, CURLINFO_STARTTRANSFER_TIME, &start);
if(CURLE_OK == res) {
printf("Time: %.1f", start);
}
}
/* always cleanup */
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Added in 7.9.2
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR curl_easy_getinfo (3),
.BR curl_easy_setopt (3),
.BR CURLINFO_STARTTRANSFER_TIME_T (3),
.BR CURLOPT_TIMEOUT (3)
man/man3/CURLOPT_PROXYHEADER.3 0000644 00000005313 14751172371 0011255 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_PROXYHEADER 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_PROXYHEADER \- set of HTTP headers to pass to proxy
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_PROXYHEADER,
struct curl_slist *headers);
.SH DESCRIPTION
Pass a pointer to a linked list of HTTP headers to pass in your HTTP request
sent to a proxy. The rules for this list is identical to the
\fICURLOPT_HTTPHEADER(3)\fP option's.
The headers set with this option is only ever used in requests sent to a proxy
- when there is also a request sent to a host.
The first line in a request (containing the method, usually a GET or POST) is
NOT a header and cannot be replaced using this option. Only the lines
following the request-line are headers. Adding this method line in this list
of headers causes your request to send an invalid header.
Pass a NULL to this to reset back to no custom headers.
.SH DEFAULT
NULL
.SH PROTOCOLS
HTTP
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
struct curl_slist *list;
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
curl_easy_setopt(curl, CURLOPT_PROXY, "http://proxy.example.com:80");
list = curl_slist_append(NULL, "Shoesize: 10");
list = curl_slist_append(list, "Accept:");
curl_easy_setopt(curl, CURLOPT_PROXYHEADER, list);
curl_easy_perform(curl);
curl_slist_free_all(list); /* free the list again */
}
.fi
.SH AVAILABILITY
Added in 7.37.0
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR CURLOPT_HEADEROPT (3),
.BR CURLOPT_HTTPHEADER (3)
man/man3/CURLOPT_SSH_AUTH_TYPES.3 0000644 00000004705 14751172371 0011731 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_SSH_AUTH_TYPES 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_SSH_AUTH_TYPES \- auth types for SFTP and SCP
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_SSH_AUTH_TYPES, long bitmask);
.fi
.SH DESCRIPTION
Pass a long set to a bitmask consisting of one or more of
CURLSSH_AUTH_PUBLICKEY, CURLSSH_AUTH_PASSWORD, CURLSSH_AUTH_HOST,
CURLSSH_AUTH_KEYBOARD and CURLSSH_AUTH_AGENT.
Set \fICURLSSH_AUTH_ANY\fP to let libcurl pick a suitable one. Currently
CURLSSH_AUTH_HOST has no effect. If CURLSSH_AUTH_AGENT is used, libcurl
attempts to connect to ssh-agent or pageant and let the agent attempt the
authentication.
.SH DEFAULT
CURLSSH_AUTH_ANY (all available)
.SH PROTOCOLS
SFTP and SCP
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "sftp://example.com/file");
curl_easy_setopt(curl, CURLOPT_SSH_AUTH_TYPES,
CURLSSH_AUTH_PUBLICKEY | CURLSSH_AUTH_KEYBOARD);
ret = curl_easy_perform(curl);
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
CURLSSH_AUTH_HOST was added in 7.16.1, CURLSSH_AUTH_AGENT was added in 7.28.0
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR CURLOPT_SSH_HOST_PUBLIC_KEY_MD5 (3),
.BR CURLOPT_SSH_HOST_PUBLIC_KEY_SHA256 (3),
.BR CURLOPT_SSH_PUBLIC_KEYFILE (3)
man/man3/CURLOPT_SSLCERTTYPE.3 0000644 00000005014 14751172371 0011302 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_SSLCERTTYPE 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_SSLCERTTYPE \- type of client SSL certificate
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_SSLCERTTYPE, char *type);
.fi
.SH DESCRIPTION
Pass a pointer to a null-terminated string as parameter. The string should be
the format of your certificate.
Supported formats are "PEM" and "DER", except with Secure Transport or
Schannel. OpenSSL (versions 0.9.3 and later), Secure Transport (on iOS 5 or
later, or OS X 10.7 or later) and Schannel support "P12" for PKCS#12-encoded
files.
The application does not have to keep the string around after setting this
option.
.SH DEFAULT
"PEM"
.SH PROTOCOLS
All TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc.
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/");
curl_easy_setopt(curl, CURLOPT_SSLCERT, "client.pem");
curl_easy_setopt(curl, CURLOPT_SSLCERTTYPE, "PEM");
curl_easy_setopt(curl, CURLOPT_SSLKEY, "key.pem");
curl_easy_setopt(curl, CURLOPT_KEYPASSWD, "s3cret");
ret = curl_easy_perform(curl);
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
If built TLS enabled. Added in 7.9.3
.SH RETURN VALUE
Returns CURLE_OK if TLS is supported, CURLE_UNKNOWN_OPTION if not, or
CURLE_OUT_OF_MEMORY if there was insufficient heap space.
.SH "SEE ALSO"
.BR CURLOPT_SSLCERT (3),
.BR CURLOPT_SSLKEY (3)
man/man3/CURLOPT_HSTSREADFUNCTION.3 0000644 00000006302 14751172371 0012045 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_HSTSREADFUNCTION 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_HSTSREADFUNCTION \- read callback for HSTS hosts
.SH SYNOPSIS
.nf
#include <curl/curl.h>
struct curl_hstsentry {
char *name;
size_t namelen;
unsigned int includeSubDomains:1;
char expire[18]; /* YYYYMMDD HH:MM:SS [null-terminated] */
};
CURLSTScode hstsread(CURL *easy, struct curl_hstsentry *sts, void *clientp);
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_HSTSREADFUNCTION, hstsread);
.fi
.SH DESCRIPTION
Pass a pointer to your callback function, as the prototype shows above.
This callback function gets called by libcurl repeatedly when it populates the
in-memory HSTS cache.
Set the \fIclientp\fP argument with the \fICURLOPT_HSTSREADDATA(3)\fP option
or it is NULL.
When this callback is invoked, the \fIsts\fP pointer points to a populated
struct: Copy the host name to \fIname\fP (no longer than \fInamelen\fP
bytes). Make it null-terminated. Set \fIincludeSubDomains\fP to TRUE or
FALSE. Set \fIexpire\fP to a date stamp or a zero length string for *forever*
(wrong date stamp format might cause the name to not get accepted)
The callback should return \fICURLSTS_OK\fP if it returns a name and is
prepared to be called again (for another host) or \fICURLSTS_DONE\fP if it has
no entry to return. It can also return \fICURLSTS_FAIL\fP to signal
error. Returning \fICURLSTS_FAIL\fP stops the transfer from being performed
and make \fICURLE_ABORTED_BY_CALLBACK\fP get returned.
This option does not enable HSTS, you need to use \fICURLOPT_HSTS_CTRL(3)\fP to
do that.
.SH DEFAULT
NULL - no callback.
.SH PROTOCOLS
This feature is only used for HTTP(S) transfer.
.SH EXAMPLE
.nf
{
/* set HSTS read callback */
curl_easy_setopt(curl, CURLOPT_HSTSREADFUNCTION, hstsread);
/* pass in suitable argument to the callback */
curl_easy_setopt(curl, CURLOPT_HSTSREADDATA, &hstspreload[0]);
result = curl_easy_perform(curl);
}
.fi
.SH AVAILABILITY
Added in 7.74.0
.SH RETURN VALUE
This returns CURLE_OK.
.SH "SEE ALSO"
.BR CURLOPT_HSTS (3),
.BR CURLOPT_HSTS_CTRL (3),
.BR CURLOPT_HSTSREADDATA (3),
.BR CURLOPT_HSTSWRITEFUNCTION (3)
man/man3/CURLOPT_URL.3 0000644 00000013045 14751172371 0010126 0 ustar 00
.\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_URL 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_URL \- URL for this transfer
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_URL, char *URL);
.fi
.SH DESCRIPTION
Pass in a pointer to the \fIURL\fP to work with. The parameter should be a
char * to a null-terminated string which must be URL-encoded in the following
format:
scheme://host:port/path
For a greater explanation of the format please see RFC 3986.
libcurl does not validate the syntax or use the URL until the transfer is
started. Even if you set a crazy value here, \fIcurl_easy_setopt(3)\fP might
still return \fICURLE_OK\fP.
If the given URL is missing a scheme name (such as "http://" or "ftp://" etc)
then libcurl guesses based on the host. If the outermost subdomain name
matches DICT, FTP, IMAP, LDAP, POP3 or SMTP then that protocol gets used,
otherwise HTTP is used. Since 7.45.0 guessing can be disabled by setting a
default protocol, see \fICURLOPT_DEFAULT_PROTOCOL(3)\fP for details.
Should the protocol, either as specified by the URL scheme or deduced by
libcurl from the host name, not be supported by libcurl then
\fICURLE_UNSUPPORTED_PROTOCOL\fP is returned from either the
\fIcurl_easy_perform(3)\fP or \fIcurl_multi_perform(3)\fP functions when you
call them. Use \fIcurl_version_info(3)\fP for detailed information of which
protocols are supported by the build of libcurl you are using.
\fICURLOPT_PROTOCOLS_STR(3)\fP can be used to limit what protocols libcurl may
use for this transfer, independent of what libcurl has been compiled to
support. That may be useful if you accept the URL from an external source and
want to limit the accessibility.
The \fICURLOPT_URL(3)\fP string is ignored if \fICURLOPT_CURLU(3)\fP is set.
Either \fICURLOPT_URL(3)\fP or \fICURLOPT_CURLU(3)\fP must be set before a
transfer is started.
The application does not have to keep the string around after setting this
option.
The parser used for handling the URL set with \fICURLOPT_URL(3)\fP is the same
that \fIcurl_url_set(3)\fP uses.
.SH ENCODING
The string pointed to in the \fICURLOPT_URL(3)\fP argument is generally
expected to be a sequence of characters using an ASCII compatible encoding.
If libcurl is built with IDN support, the server name part of the URL can use
an "international name" by using the current encoding (according to locale) or
UTF-8 (when winidn is used; or a Windows Unicode build using libidn2).
If libcurl is built without IDN support, the server name is used exactly as
specified when passed to the name resolver functions.
.SH DEFAULT
There is no default URL. If this option is not set, no transfer can be
performed.
.SH SECURITY CONCERNS
Applications may at times find it convenient to allow users to specify URLs
for various purposes and that string would then end up fed to this option.
Getting a URL from an external untrusted party brings several security
concerns:
If you have an application that runs as or in a server application, getting an
unfiltered URL can easily trick your application to access a local resource
instead of a remote. Protecting yourself against localhost accesses is hard
when accepting user provided URLs.
Such custom URLs can also access other ports than you planned as port numbers
are part of the regular URL format. The combination of a local host and a
custom port number can allow external users to play tricks with your local
services.
Accepting external URLs may also use other protocols than http:// or other
common ones. Restrict what accept with \fICURLOPT_PROTOCOLS(3)\fP.
User provided URLs can also be made to point to sites that redirect further on
(possibly to other protocols too). Consider your
\fICURLOPT_FOLLOWLOCATION(3)\fP and \fICURLOPT_REDIR_PROTOCOLS(3)\fP settings.
.SH PROTOCOLS
All
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
curl_easy_perform(curl);
}
.fi
.SH AVAILABILITY
POP3 and SMTP were added in 7.31.0
.SH RETURN VALUE
Returns CURLE_OK on success or CURLE_OUT_OF_MEMORY if there was insufficient
heap space.
Note that \fIcurl_easy_setopt(3)\fP does not parse the given string so given a
bad URL, it is not detected until \fIcurl_easy_perform(3)\fP or similar is
called.
.SH "SEE ALSO"
.BR curl_easy_perform (3),
.BR curl_url_get (3),
.BR curl_url_set (3),
.BR CURLINFO_REDIRECT_URL (3),
.BR CURLOPT_CURLU (3),
.BR CURLOPT_FORBID_REUSE (3),
.BR CURLOPT_FRESH_CONNECT (3),
.BR CURLOPT_PATH_AS_IS (3),
.BR CURLOPT_PROTOCOLS (3)
man/man3/CURLOPT_HSTSREADDATA.3 0000644 00000004346 14751172371 0011337 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_HSTSREADDATA 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_HSTSREADDATA \- pointer passed to the HSTS read callback
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_HSTSREADDATA, void *pointer);
.fi
.SH DESCRIPTION
Data \fIpointer\fP to pass to the HSTS read function. If you use the
\fICURLOPT_HSTSREADFUNCTION(3)\fP option, this is the pointer you get as input
in the 3rd argument to the callback.
This option does not enable HSTS, you need to use \fICURLOPT_HSTS_CTRL(3)\fP to
do that.
.SH DEFAULT
NULL
.SH PROTOCOLS
This feature is only used for HTTP(S) transfer.
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
struct MyData this;
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "http://example.com");
/* pass pointer that gets passed in to the
CURLOPT_HSTSREADFUNCTION callback */
curl_easy_setopt(curl, CURLOPT_HSTSREADDATA, &this);
curl_easy_perform(curl);
}
.fi
.SH AVAILABILITY
Added in 7.74.0
.SH RETURN VALUE
This returns CURLE_OK.
.SH "SEE ALSO"
.BR CURLOPT_HSTS (3),
.BR CURLOPT_HSTSREADFUNCTION (3),
.BR CURLOPT_HSTSWRITEDATA (3),
.BR CURLOPT_HSTSWRITEFUNCTION (3)
man/man3/CURLINFO_PRETRANSFER_TIME.3 0000644 00000005067 14751172371 0012173 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLINFO_PRETRANSFER_TIME 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLINFO_PRETRANSFER_TIME \- get the time until the file transfer start
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_getinfo(CURL *handle, CURLINFO_PRETRANSFER_TIME,
double *timep);
.fi
.SH DESCRIPTION
Pass a pointer to a double to receive the time, in seconds, it took from the
start until the file transfer is just about to begin.
This time-stamp includes all pre-transfer commands and negotiations that are
specific to the particular protocol(s) involved. It includes the sending of
the protocol- specific protocol instructions that triggers a transfer.
When a redirect is followed, the time from each request is added together.
See also the TIMES overview in the \fIcurl_easy_getinfo(3)\fP man page.
.SH PROTOCOLS
All
.SH EXAMPLE
.nf
curl = curl_easy_init();
if(curl) {
double pretransfer;
curl_easy_setopt(curl, CURLOPT_URL, url);
res = curl_easy_perform(curl);
if(CURLE_OK == res) {
res = curl_easy_getinfo(curl, CURLINFO_PRETRANSFER_TIME, &pretransfer);
if(CURLE_OK == res) {
printf("Time: %.1f", pretransfer);
}
}
/* always cleanup */
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Added in 7.4.1
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR curl_easy_getinfo (3),
.BR curl_easy_setopt (3),
.BR CURLINFO_CONNECT_TIME_T (3),
.BR CURLINFO_PRETRANSFER_TIME_T (3)
man/man3/CURLOPT_SSLVERSION.3 0000644 00000010536 14751172371 0011175 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_SSLVERSION 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_SSLVERSION \- preferred TLS/SSL version
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_SSLVERSION, long version);
.fi
.SH DESCRIPTION
Pass a long as parameter to control which version range of SSL/TLS versions to
use.
The SSL and TLS versions have typically developed from the most insecure
version to be more and more secure in this order through history: SSL v2,
SSLv3, TLS v1.0, TLS v1.1, TLS v1.2 and the most recent TLS v1.3.
Use one of the available defines for this purpose. The available options are:
.RS
.IP CURL_SSLVERSION_DEFAULT
The default acceptable version range. The minimum acceptable version is by
default TLS v1.0 since 7.39.0 (unless the TLS library has a stricter rule).
.IP CURL_SSLVERSION_TLSv1
TLS v1.0 or later
.IP CURL_SSLVERSION_SSLv2
SSL v2 - refused
.IP CURL_SSLVERSION_SSLv3
SSL v3 - refused
.IP CURL_SSLVERSION_TLSv1_0
TLS v1.0 or later (Added in 7.34.0)
.IP CURL_SSLVERSION_TLSv1_1
TLS v1.1 or later (Added in 7.34.0)
.IP CURL_SSLVERSION_TLSv1_2
TLS v1.2 or later (Added in 7.34.0)
.IP CURL_SSLVERSION_TLSv1_3
TLS v1.3 or later (Added in 7.52.0)
.RE
The maximum TLS version can be set by using \fIone\fP of the
CURL_SSLVERSION_MAX_ macros below. It is also possible to OR \fIone\fP of the
CURL_SSLVERSION_ macros with \fIone\fP of the CURL_SSLVERSION_MAX_ macros.
The MAX macros are not supported for WolfSSL.
.RS
.IP CURL_SSLVERSION_MAX_DEFAULT
The flag defines the maximum supported TLS version by libcurl, or the default
value from the SSL library is used. libcurl uses a sensible default maximum,
which was TLS v1.2 up to before 7.61.0 and is TLS v1.3 since then - assuming
the TLS library support it. (Added in 7.54.0)
.IP CURL_SSLVERSION_MAX_TLSv1_0
The flag defines maximum supported TLS version as TLS v1.0.
(Added in 7.54.0)
.IP CURL_SSLVERSION_MAX_TLSv1_1
The flag defines maximum supported TLS version as TLS v1.1.
(Added in 7.54.0)
.IP CURL_SSLVERSION_MAX_TLSv1_2
The flag defines maximum supported TLS version as TLS v1.2.
(Added in 7.54.0)
.IP CURL_SSLVERSION_MAX_TLSv1_3
The flag defines maximum supported TLS version as TLS v1.3.
(Added in 7.54.0)
.RE
In versions of curl prior to 7.54 the CURL_SSLVERSION_TLS options were
documented to allow \fIonly\fP the specified TLS version, but behavior was
inconsistent depending on the TLS library.
.SH DEFAULT
CURL_SSLVERSION_DEFAULT
.SH PROTOCOLS
All TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc.
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
/* ask libcurl to use TLS version 1.0 or later */
curl_easy_setopt(curl, CURLOPT_SSLVERSION, (long)CURL_SSLVERSION_TLSv1);
/* Perform the request */
curl_easy_perform(curl);
}
.fi
.SH AVAILABILITY
SSLv2 and SSLv3 are refused completely since curl 7.77.0
SSLv2 is disabled by default since 7.18.1. Other SSL versions availability may
vary depending on which backend libcurl has been built to use.
SSLv3 is disabled by default since 7.39.0.
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR CURLOPT_HTTP_VERSION (3),
.BR CURLOPT_IPRESOLVE (3),
.BR CURLOPT_PROXY_SSLVERSION (3),
.BR CURLOPT_USE_SSL (3)
man/man3/CURLOPT_UPLOAD.3 0000644 00000005753 14751172371 0010457 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_UPLOAD 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_UPLOAD \- data upload
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_UPLOAD, long upload);
.fi
.SH DESCRIPTION
The long parameter \fIupload\fP set to 1 tells the library to prepare for and
perform an upload. The \fICURLOPT_READDATA(3)\fP and
\fICURLOPT_INFILESIZE(3)\fP or \fICURLOPT_INFILESIZE_LARGE(3)\fP options are
also interesting for uploads. If the protocol is HTTP, uploading means using
the PUT request unless you tell libcurl otherwise.
Using PUT with HTTP 1.1 implies the use of a "Expect: 100-continue" header.
You can disable this header with \fICURLOPT_HTTPHEADER(3)\fP as usual.
If you use PUT to an HTTP 1.1 server, you can upload data without knowing the
size before starting the transfer. The library enables this by adding a header
"Transfer-Encoding: chunked". With HTTP 1.0 or if you prefer not to use chunked
transfer, you must specify the size of the data with
\fICURLOPT_INFILESIZE(3)\fP or \fICURLOPT_INFILESIZE_LARGE(3)\fP.
.SH DEFAULT
0, default is download
.SH PROTOCOLS
Most
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
/* we want to use our own read function */
curl_easy_setopt(curl, CURLOPT_READFUNCTION, read_callback);
/* enable uploading */
curl_easy_setopt(curl, CURLOPT_UPLOAD, 1L);
/* specify target */
curl_easy_setopt(curl, CURLOPT_URL, "ftp://example.com/dir/to/newfile");
/* now specify which pointer to pass to our callback */
curl_easy_setopt(curl, CURLOPT_READDATA, hd_src);
/* Set the size of the file to upload */
curl_easy_setopt(curl, CURLOPT_INFILESIZE_LARGE, (curl_off_t)fsize);
/* Now run off and do what you have been told! */
curl_easy_perform(curl);
}
.fi
.SH AVAILABILITY
Always
.SH RETURN VALUE
Returns CURLE_OK
.SH "SEE ALSO"
.BR CURLOPT_PUT (3),
.BR CURLOPT_READFUNCTION (3),
.BR CURLOPT_INFILESIZE_LARGE (3)
man/man3/curl_easy_send.3 0000644 00000007345 14751172371 0011261 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH curl_easy_send 3 "September 26, 2023" "libcurl 8.4.0" "libcurl"
.SH NAME
curl_easy_send - sends raw data over an "easy" connection
.SH SYNOPSIS
.nf
#include <curl/easy.h>
CURLcode curl_easy_send(CURL *curl, const void *buffer,
size_t buflen, size_t *n);
.fi
.SH DESCRIPTION
This function sends arbitrary data over the established connection. You may
use it together with \fIcurl_easy_recv(3)\fP to implement custom protocols
using libcurl. This functionality can be particularly useful if you use
proxies and/or SSL encryption: libcurl takes care of proxy negotiation and
connection setup.
\fBbuffer\fP is a pointer to the data of length \fBbuflen\fP that you want
sent. The variable \fBn\fP points to receives the number of sent bytes.
To establish the connection, set \fICURLOPT_CONNECT_ONLY(3)\fP option before
calling \fIcurl_easy_perform(3)\fP or \fIcurl_multi_perform(3)\fP. Note that
\fIcurl_easy_send(3)\fP does not work on connections that were created without
this option.
The call returns \fBCURLE_AGAIN\fP if it's not possible to send data right now
- the socket is used in non-blocking mode internally. When \fBCURLE_AGAIN\fP
is returned, use your operating system facilities like \fIselect(2)\fP to wait
until the socket is writable. The socket may be obtained using
\fIcurl_easy_getinfo(3)\fP with \fICURLINFO_ACTIVESOCKET(3)\fP.
Furthermore if you wait on the socket and it tells you it's writable,
\fIcurl_easy_send(3)\fP may return \fBCURLE_AGAIN\fP if the only data that was
sent was for internal SSL processing, and no other data could be sent.
.SH EXAMPLE
.nf
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
/* Do not do the transfer - only connect to host */
curl_easy_setopt(curl, CURLOPT_CONNECT_ONLY, 1L);
res = curl_easy_perform(curl);
if(res == CURLE_OK) {
/* Extract the socket from the curl handle - we need it for waiting. */
res = curl_easy_getinfo(curl, CURLINFO_ACTIVESOCKET, &sockfd);
/* send data */
res = curl_easy_send(curl, "hello", 5, &sent);
}
.fi
.SH AVAILABILITY
Added in 7.18.2.
.SH RETURN VALUE
On success, returns \fBCURLE_OK\fP and stores the number of bytes actually
sent into \fB*n\fP. Note that this may be less than the amount you wanted to
send.
On failure, returns the appropriate error code.
This function may return \fBCURLE_AGAIN\fP. In this case, use your operating
system facilities to wait until the socket is writable, and retry.
If there is no socket available to use from the previous transfer, this function
returns \fBCURLE_UNSUPPORTED_PROTOCOL\fP.
.SH "SEE ALSO"
.BR curl_easy_setopt (3),
.BR curl_easy_perform (3),
.BR curl_easy_getinfo (3),
.BR curl_easy_recv (3)
man/man3/CURLOPT_ISSUERCERT.3 0000644 00000005610 14751172371 0011153 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_ISSUERCERT 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_ISSUERCERT \- issuer SSL certificate filename
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_ISSUERCERT, char *file);
.fi
.SH DESCRIPTION
Pass a char * to a null-terminated string naming a \fIfile\fP holding a CA
certificate in PEM format. If the option is set, an additional check against
the peer certificate is performed to verify the issuer is indeed the one
associated with the certificate provided by the option. This additional check
is useful in multi-level PKI where one needs to enforce that the peer
certificate is from a specific branch of the tree.
This option makes sense only when used in combination with the
\fICURLOPT_SSL_VERIFYPEER(3)\fP option. Otherwise, the result of the check is
not considered as failure.
A specific error code (CURLE_SSL_ISSUER_ERROR) is defined with the option,
which is returned if the setup of the SSL/TLS session has failed due to a
mismatch with the issuer of peer certificate (\fICURLOPT_SSL_VERIFYPEER(3)\fP
has to be set too for the check to fail). (Added in 7.19.0)
The application does not have to keep the string around after setting this
option.
.SH DEFAULT
NULL
.SH PROTOCOLS
All TLS-based protocols
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/");
curl_easy_setopt(curl, CURLOPT_ISSUERCERT, "/etc/certs/cacert.pem");
ret = curl_easy_perform(curl);
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
If built TLS enabled
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, CURLE_UNKNOWN_OPTION if not, or
CURLE_OUT_OF_MEMORY if there was insufficient heap space.
.SH "SEE ALSO"
.BR CURLOPT_CRLFILE (3),
.BR CURLOPT_SSL_VERIFYHOST (3),
.BR CURLOPT_SSL_VERIFYPEER (3)
man/man3/curl_easy_setopt.3 0000644 00000100722 14751172371 0011637 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH curl_easy_setopt 3 "September 26, 2023" "libcurl 8.4.0" "libcurl"
.SH NAME
curl_easy_setopt \- set options for a curl easy handle
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLoption option, parameter);
.fi
.SH DESCRIPTION
\fIcurl_easy_setopt(3)\fP is used to tell libcurl how to behave. By setting
the appropriate options, the application can change libcurl's behavior. All
options are set with an \fIoption\fP followed by a \fIparameter\fP. That
parameter can be a \fBlong\fP, a \fBfunction pointer\fP, an \fBobject
pointer\fP or a \fBcurl_off_t\fP, depending on what the specific option
expects. Read this manual carefully as bad input values may cause libcurl to
behave badly! You can only set one option in each function call. A typical
application uses many \fIcurl_easy_setopt(3)\fP calls in the setup phase.
Options set with this function call are valid for all forthcoming transfers
performed using this \fIhandle\fP. The options are not in any way reset
between transfers, so if you want subsequent transfers with different options,
you must change them between the transfers. You can optionally reset all
options back to internal default with \fIcurl_easy_reset(3)\fP.
Strings passed to libcurl as 'char *' arguments, are copied by the library;
the string storage associated to the pointer argument may be discarded or
reused after \fIcurl_easy_setopt(3)\fP returns. The only exception to this
rule is really \fICURLOPT_POSTFIELDS(3)\fP, but the alternative that copies
the string \fICURLOPT_COPYPOSTFIELDS(3)\fP has some usage characteristics you
need to read up on. This function does not accept input strings longer than
\fBCURL_MAX_INPUT_LENGTH\fP (8 MB).
The order in which the options are set does not matter.
Before version 7.17.0, strings were not copied. Instead the user was forced
keep them available until libcurl no longer needed them.
The \fIhandle\fP is the return code from a \fIcurl_easy_init(3)\fP or
\fIcurl_easy_duphandle(3)\fP call.
.SH BEHAVIOR OPTIONS
.IP CURLOPT_VERBOSE
Display verbose information. See \fICURLOPT_VERBOSE(3)\fP
.IP CURLOPT_HEADER
Include the header in the body output. See \fICURLOPT_HEADER(3)\fP
.IP CURLOPT_NOPROGRESS
Shut off the progress meter. See \fICURLOPT_NOPROGRESS(3)\fP
.IP CURLOPT_NOSIGNAL
Do not install signal handlers. See \fICURLOPT_NOSIGNAL(3)\fP
.IP CURLOPT_WILDCARDMATCH
Transfer multiple files according to a file name pattern. See \fICURLOPT_WILDCARDMATCH(3)\fP
.SH CALLBACK OPTIONS
.IP CURLOPT_WRITEFUNCTION
Callback for writing data. See \fICURLOPT_WRITEFUNCTION(3)\fP
.IP CURLOPT_WRITEDATA
Data pointer to pass to the write callback. See \fICURLOPT_WRITEDATA(3)\fP
.IP CURLOPT_READFUNCTION
Callback for reading data. See \fICURLOPT_READFUNCTION(3)\fP
.IP CURLOPT_READDATA
Data pointer to pass to the read callback. See \fICURLOPT_READDATA(3)\fP
.IP CURLOPT_IOCTLFUNCTION
\fBDeprecated option\fP Callback for I/O operations.
See \fICURLOPT_IOCTLFUNCTION(3)\fP
.IP CURLOPT_IOCTLDATA
\fBDeprecated option\fP Data pointer to pass to the I/O callback.
See \fICURLOPT_IOCTLDATA(3)\fP
.IP CURLOPT_SEEKFUNCTION
Callback for seek operations. See \fICURLOPT_SEEKFUNCTION(3)\fP
.IP CURLOPT_SEEKDATA
Data pointer to pass to the seek callback. See \fICURLOPT_SEEKDATA(3)\fP
.IP CURLOPT_SOCKOPTFUNCTION
Callback for sockopt operations. See \fICURLOPT_SOCKOPTFUNCTION(3)\fP
.IP CURLOPT_SOCKOPTDATA
Data pointer to pass to the sockopt callback. See \fICURLOPT_SOCKOPTDATA(3)\fP
.IP CURLOPT_OPENSOCKETFUNCTION
Callback for socket creation. See \fICURLOPT_OPENSOCKETFUNCTION(3)\fP
.IP CURLOPT_OPENSOCKETDATA
Data pointer to pass to the open socket callback. See \fICURLOPT_OPENSOCKETDATA(3)\fP
.IP CURLOPT_CLOSESOCKETFUNCTION
Callback for closing socket. See \fICURLOPT_CLOSESOCKETFUNCTION(3)\fP
.IP CURLOPT_CLOSESOCKETDATA
Data pointer to pass to the close socket callback. See \fICURLOPT_CLOSESOCKETDATA(3)\fP
.IP CURLOPT_PROGRESSFUNCTION
\fBOBSOLETE\fP callback for progress meter.
See \fICURLOPT_PROGRESSFUNCTION(3)\fP
.IP CURLOPT_PROGRESSDATA
Data pointer to pass to the progress meter callback. See \fICURLOPT_PROGRESSDATA(3)\fP
.IP CURLOPT_XFERINFOFUNCTION
Callback for progress meter. See \fICURLOPT_XFERINFOFUNCTION(3)\fP
.IP CURLOPT_XFERINFODATA
Data pointer to pass to the progress meter callback. See \fICURLOPT_XFERINFODATA(3)\fP
.IP CURLOPT_HEADERFUNCTION
Callback for writing received headers. See \fICURLOPT_HEADERFUNCTION(3)\fP
.IP CURLOPT_HEADERDATA
Data pointer to pass to the header callback. See \fICURLOPT_HEADERDATA(3)\fP
.IP CURLOPT_DEBUGFUNCTION
Callback for debug information. See \fICURLOPT_DEBUGFUNCTION(3)\fP
.IP CURLOPT_DEBUGDATA
Data pointer to pass to the debug callback. See \fICURLOPT_DEBUGDATA(3)\fP
.IP CURLOPT_SSL_CTX_FUNCTION
Callback for SSL context logic. See \fICURLOPT_SSL_CTX_FUNCTION(3)\fP
.IP CURLOPT_SSL_CTX_DATA
Data pointer to pass to the SSL context callback. See \fICURLOPT_SSL_CTX_DATA(3)\fP
.IP CURLOPT_CONV_TO_NETWORK_FUNCTION
\fBOBSOLETE\fP Callback for code base conversion.
See \fICURLOPT_CONV_TO_NETWORK_FUNCTION(3)\fP
.IP CURLOPT_CONV_FROM_NETWORK_FUNCTION
\fBOBSOLETE\fP Callback for code base conversion.
See \fICURLOPT_CONV_FROM_NETWORK_FUNCTION(3)\fP
.IP CURLOPT_CONV_FROM_UTF8_FUNCTION
\fBOBSOLETE\fP Callback for code base conversion.
See \fICURLOPT_CONV_FROM_UTF8_FUNCTION(3)\fP
.IP CURLOPT_INTERLEAVEFUNCTION
Callback for RTSP interleaved data. See \fICURLOPT_INTERLEAVEFUNCTION(3)\fP
.IP CURLOPT_INTERLEAVEDATA
Data pointer to pass to the RTSP interleave callback. See \fICURLOPT_INTERLEAVEDATA(3)\fP
.IP CURLOPT_CHUNK_BGN_FUNCTION
Callback for wildcard download start of chunk. See \fICURLOPT_CHUNK_BGN_FUNCTION(3)\fP
.IP CURLOPT_CHUNK_END_FUNCTION
Callback for wildcard download end of chunk. See \fICURLOPT_CHUNK_END_FUNCTION(3)\fP
.IP CURLOPT_CHUNK_DATA
Data pointer to pass to the chunk callbacks. See \fICURLOPT_CHUNK_DATA(3)\fP
.IP CURLOPT_FNMATCH_FUNCTION
Callback for wildcard matching. See \fICURLOPT_FNMATCH_FUNCTION(3)\fP
.IP CURLOPT_FNMATCH_DATA
Data pointer to pass to the wildcard matching callback. See \fICURLOPT_FNMATCH_DATA(3)\fP
.IP CURLOPT_SUPPRESS_CONNECT_HEADERS
Suppress proxy CONNECT response headers from user callbacks. See \fICURLOPT_SUPPRESS_CONNECT_HEADERS(3)\fP
.IP CURLOPT_RESOLVER_START_FUNCTION
Callback to be called before a new resolve request is started. See \fICURLOPT_RESOLVER_START_FUNCTION(3)\fP
.IP CURLOPT_RESOLVER_START_DATA
Data pointer to pass to resolver start callback. See \fICURLOPT_RESOLVER_START_DATA(3)\fP
.IP CURLOPT_PREREQFUNCTION
Callback to be called after a connection is established but before a request is made on that connection. See \fICURLOPT_PREREQFUNCTION(3)\fP
.IP CURLOPT_PREREQDATA
Data pointer to pass to the CURLOPT_PREREQFUNCTION callback. See \fICURLOPT_PREREQDATA(3)\fP
.SH ERROR OPTIONS
.IP CURLOPT_ERRORBUFFER
Error message buffer. See \fICURLOPT_ERRORBUFFER(3)\fP
.IP CURLOPT_STDERR
stderr replacement stream. See \fICURLOPT_STDERR(3)\fP
.IP CURLOPT_FAILONERROR
Fail on HTTP 4xx errors. \fICURLOPT_FAILONERROR(3)\fP
.IP CURLOPT_KEEP_SENDING_ON_ERROR
Keep sending on HTTP >= 300 errors. \fICURLOPT_KEEP_SENDING_ON_ERROR(3)\fP
.SH NETWORK OPTIONS
.IP CURLOPT_URL
URL to work on. See \fICURLOPT_URL(3)\fP
.IP CURLOPT_PATH_AS_IS
Disable squashing /../ and /./ sequences in the path. See \fICURLOPT_PATH_AS_IS(3)\fP
.IP CURLOPT_PROTOCOLS
\fBDeprecated option\fP Allowed protocols. See \fICURLOPT_PROTOCOLS(3)\fP
.IP CURLOPT_PROTOCOLS_STR
Allowed protocols. See \fICURLOPT_PROTOCOLS_STR(3)\fP
.IP CURLOPT_REDIR_PROTOCOLS
\fBDeprecated option\fP Protocols to allow redirects to. See
\fICURLOPT_REDIR_PROTOCOLS(3)\fP
.IP CURLOPT_REDIR_PROTOCOLS_STR
Protocols to allow redirects to. See \fICURLOPT_REDIR_PROTOCOLS_STR(3)\fP
.IP CURLOPT_DEFAULT_PROTOCOL
Default protocol. See \fICURLOPT_DEFAULT_PROTOCOL(3)\fP
.IP CURLOPT_PROXY
Proxy to use. See \fICURLOPT_PROXY(3)\fP
.IP CURLOPT_PRE_PROXY
Socks proxy to use. See \fICURLOPT_PRE_PROXY(3)\fP
.IP CURLOPT_PROXYPORT
Proxy port to use. See \fICURLOPT_PROXYPORT(3)\fP
.IP CURLOPT_PROXYTYPE
Proxy type. See \fICURLOPT_PROXYTYPE(3)\fP
.IP CURLOPT_NOPROXY
Filter out hosts from proxy use. \fICURLOPT_NOPROXY(3)\fP
.IP CURLOPT_HTTPPROXYTUNNEL
Tunnel through the HTTP proxy. \fICURLOPT_HTTPPROXYTUNNEL(3)\fP
.IP CURLOPT_CONNECT_TO
Connect to a specific host and port. See \fICURLOPT_CONNECT_TO(3)\fP
.IP CURLOPT_SOCKS5_AUTH
Socks5 authentication methods. See \fICURLOPT_SOCKS5_AUTH(3)\fP
.IP CURLOPT_SOCKS5_GSSAPI_SERVICE
\fBDeprecated option\fP Socks5 GSSAPI service name.
See \fICURLOPT_SOCKS5_GSSAPI_SERVICE(3)\fP
.IP CURLOPT_SOCKS5_GSSAPI_NEC
Socks5 GSSAPI NEC mode. See \fICURLOPT_SOCKS5_GSSAPI_NEC(3)\fP
.IP CURLOPT_PROXY_SERVICE_NAME
Proxy authentication service name. \fICURLOPT_PROXY_SERVICE_NAME(3)\fP
.IP CURLOPT_HAPROXYPROTOCOL
Send an HAProxy PROXY protocol v1 header. See \fICURLOPT_HAPROXYPROTOCOL(3)\fP
.IP CURLOPT_HAPROXY_CLIENT_IP
Spoof the client IP in an HAProxy PROXY protocol v1 header. See \fICURLOPT_HAPROXY_CLIENT_IP(3)\fP
.IP CURLOPT_SERVICE_NAME
Authentication service name. \fICURLOPT_SERVICE_NAME(3)\fP
.IP CURLOPT_INTERFACE
Bind connection locally to this. See \fICURLOPT_INTERFACE(3)\fP
.IP CURLOPT_LOCALPORT
Bind connection locally to this port. See \fICURLOPT_LOCALPORT(3)\fP
.IP CURLOPT_LOCALPORTRANGE
Bind connection locally to port range. See \fICURLOPT_LOCALPORTRANGE(3)\fP
.IP CURLOPT_DNS_CACHE_TIMEOUT
Timeout for DNS cache. See \fICURLOPT_DNS_CACHE_TIMEOUT(3)\fP
.IP CURLOPT_DNS_USE_GLOBAL_CACHE
\fBOBSOLETE\fP Enable global DNS cache.
See \fICURLOPT_DNS_USE_GLOBAL_CACHE(3)\fP
.IP CURLOPT_DOH_URL
Use this DoH server for name resolves. See \fICURLOPT_DOH_URL(3)\fP
.IP CURLOPT_BUFFERSIZE
Ask for alternate buffer size. See \fICURLOPT_BUFFERSIZE(3)\fP
.IP CURLOPT_PORT
Port number to connect to. See \fICURLOPT_PORT(3)\fP
.IP CURLOPT_TCP_FASTOPEN
Enable TCP Fast Open. See \fICURLOPT_TCP_FASTOPEN(3)\fP
.IP CURLOPT_TCP_NODELAY
Disable the Nagle algorithm. See \fICURLOPT_TCP_NODELAY(3)\fP
.IP CURLOPT_ADDRESS_SCOPE
IPv6 scope for local addresses. See \fICURLOPT_ADDRESS_SCOPE(3)\fP
.IP CURLOPT_TCP_KEEPALIVE
Enable TCP keep-alive. See \fICURLOPT_TCP_KEEPALIVE(3)\fP
.IP CURLOPT_TCP_KEEPIDLE
Idle time before sending keep-alive. See \fICURLOPT_TCP_KEEPIDLE(3)\fP
.IP CURLOPT_TCP_KEEPINTVL
Interval between keep-alive probes. See \fICURLOPT_TCP_KEEPINTVL(3)\fP
.IP CURLOPT_UNIX_SOCKET_PATH
Path to a Unix domain socket. See \fICURLOPT_UNIX_SOCKET_PATH(3)\fP
.IP CURLOPT_ABSTRACT_UNIX_SOCKET
Path to an abstract Unix domain socket. See \fICURLOPT_ABSTRACT_UNIX_SOCKET(3)\fP
.SH NAMES and PASSWORDS OPTIONS (Authentication)
.IP CURLOPT_NETRC
Enable .netrc parsing. See \fICURLOPT_NETRC(3)\fP
.IP CURLOPT_NETRC_FILE
\&.netrc file name. See \fICURLOPT_NETRC_FILE(3)\fP
.IP CURLOPT_USERPWD
User name and password. See \fICURLOPT_USERPWD(3)\fP
.IP CURLOPT_PROXYUSERPWD
Proxy user name and password. See \fICURLOPT_PROXYUSERPWD(3)\fP
.IP CURLOPT_USERNAME
User name. See \fICURLOPT_USERNAME(3)\fP
.IP CURLOPT_PASSWORD
Password. See \fICURLOPT_PASSWORD(3)\fP
.IP CURLOPT_LOGIN_OPTIONS
Login options. See \fICURLOPT_LOGIN_OPTIONS(3)\fP
.IP CURLOPT_PROXYUSERNAME
Proxy user name. See \fICURLOPT_PROXYUSERNAME(3)\fP
.IP CURLOPT_PROXYPASSWORD
Proxy password. See \fICURLOPT_PROXYPASSWORD(3)\fP
.IP CURLOPT_HTTPAUTH
HTTP server authentication methods. See \fICURLOPT_HTTPAUTH(3)\fP
.IP CURLOPT_TLSAUTH_USERNAME
TLS authentication user name. See \fICURLOPT_TLSAUTH_USERNAME(3)\fP
.IP CURLOPT_PROXY_TLSAUTH_USERNAME
Proxy TLS authentication user name. See \fICURLOPT_PROXY_TLSAUTH_USERNAME(3)\fP
.IP CURLOPT_TLSAUTH_PASSWORD
TLS authentication password. See \fICURLOPT_TLSAUTH_PASSWORD(3)\fP
.IP CURLOPT_PROXY_TLSAUTH_PASSWORD
Proxy TLS authentication password. See \fICURLOPT_PROXY_TLSAUTH_PASSWORD(3)\fP
.IP CURLOPT_TLSAUTH_TYPE
TLS authentication methods. See \fICURLOPT_TLSAUTH_TYPE(3)\fP
.IP CURLOPT_PROXY_TLSAUTH_TYPE
Proxy TLS authentication methods. See \fICURLOPT_PROXY_TLSAUTH_TYPE(3)\fP
.IP CURLOPT_PROXYAUTH
HTTP proxy authentication methods. See \fICURLOPT_PROXYAUTH(3)\fP
.IP CURLOPT_SASL_AUTHZID
SASL authorization identity (identity to act as). See \fICURLOPT_SASL_AUTHZID(3)\fP
.IP CURLOPT_SASL_IR
Enable SASL initial response. See \fICURLOPT_SASL_IR(3)\fP
.IP CURLOPT_XOAUTH2_BEARER
OAuth2 bearer token. See \fICURLOPT_XOAUTH2_BEARER(3)\fP
.IP CURLOPT_DISALLOW_USERNAME_IN_URL
Do not allow username in URL. See \fICURLOPT_DISALLOW_USERNAME_IN_URL(3)\fP
.SH HTTP OPTIONS
.IP CURLOPT_AUTOREFERER
Automatically set Referer: header. See \fICURLOPT_AUTOREFERER(3)\fP
.IP CURLOPT_ACCEPT_ENCODING
Accept-Encoding and automatic decompressing data. See \fICURLOPT_ACCEPT_ENCODING(3)\fP
.IP CURLOPT_TRANSFER_ENCODING
Request Transfer-Encoding. See \fICURLOPT_TRANSFER_ENCODING(3)\fP
.IP CURLOPT_FOLLOWLOCATION
Follow HTTP redirects. See \fICURLOPT_FOLLOWLOCATION(3)\fP
.IP CURLOPT_UNRESTRICTED_AUTH
Do not restrict authentication to original host. \fICURLOPT_UNRESTRICTED_AUTH(3)\fP
.IP CURLOPT_MAXREDIRS
Maximum number of redirects to follow. See \fICURLOPT_MAXREDIRS(3)\fP
.IP CURLOPT_POSTREDIR
How to act on redirects after POST. See \fICURLOPT_POSTREDIR(3)\fP
.IP CURLOPT_PUT
\fBDeprecated option\fP Issue an HTTP PUT request. See \fICURLOPT_PUT(3)\fP
.IP CURLOPT_POST
Issue an HTTP POST request. See \fICURLOPT_POST(3)\fP
.IP CURLOPT_POSTFIELDS
Send a POST with this data. See \fICURLOPT_POSTFIELDS(3)\fP
.IP CURLOPT_POSTFIELDSIZE
The POST data is this big. See \fICURLOPT_POSTFIELDSIZE(3)\fP
.IP CURLOPT_POSTFIELDSIZE_LARGE
The POST data is this big. See \fICURLOPT_POSTFIELDSIZE_LARGE(3)\fP
.IP CURLOPT_COPYPOSTFIELDS
Send a POST with this data - and copy it. See \fICURLOPT_COPYPOSTFIELDS(3)\fP
.IP CURLOPT_HTTPPOST
\fBDeprecated option\fP Multipart formpost HTTP POST.
See \fICURLOPT_HTTPPOST(3)\fP
.IP CURLOPT_REFERER
Referer: header. See \fICURLOPT_REFERER(3)\fP
.IP CURLOPT_USERAGENT
User-Agent: header. See \fICURLOPT_USERAGENT(3)\fP
.IP CURLOPT_HTTPHEADER
Custom HTTP headers. See \fICURLOPT_HTTPHEADER(3)\fP
.IP CURLOPT_HEADEROPT
Control custom headers. See \fICURLOPT_HEADEROPT(3)\fP
.IP CURLOPT_PROXYHEADER
Custom HTTP headers sent to proxy. See \fICURLOPT_PROXYHEADER(3)\fP
.IP CURLOPT_HTTP200ALIASES
Alternative versions of 200 OK. See \fICURLOPT_HTTP200ALIASES(3)\fP
.IP CURLOPT_COOKIE
Cookie(s) to send. See \fICURLOPT_COOKIE(3)\fP
.IP CURLOPT_COOKIEFILE
File to read cookies from. See \fICURLOPT_COOKIEFILE(3)\fP
.IP CURLOPT_COOKIEJAR
File to write cookies to. See \fICURLOPT_COOKIEJAR(3)\fP
.IP CURLOPT_COOKIESESSION
Start a new cookie session. See \fICURLOPT_COOKIESESSION(3)\fP
.IP CURLOPT_COOKIELIST
Add or control cookies. See \fICURLOPT_COOKIELIST(3)\fP
.IP CURLOPT_ALTSVC
Specify the Alt-Svc: cache file name. See \fICURLOPT_ALTSVC(3)\fP
.IP CURLOPT_ALTSVC_CTRL
Enable and configure Alt-Svc: treatment. See \fICURLOPT_ALTSVC_CTRL(3)\fP
.IP CURLOPT_HSTS
Set HSTS cache file. See \fICURLOPT_HSTS(3)\fP
.IP CURLOPT_HSTS_CTRL
Enable HSTS. See \fICURLOPT_HSTS_CTRL(3)\fP
.IP CURLOPT_HSTSREADFUNCTION
Set HSTS read callback. See \fICURLOPT_HSTSREADFUNCTION(3)\fP
.IP CURLOPT_HSTSREADDATA
Pass pointer to the HSTS read callback. See \fICURLOPT_HSTSREADDATA(3)\fP
.IP CURLOPT_HSTSWRITEFUNCTION
Set HSTS write callback. See \fICURLOPT_HSTSWRITEFUNCTION(3)\fP
.IP CURLOPT_HSTSWRITEDATA
Pass pointer to the HSTS write callback. See \fICURLOPT_HSTSWRITEDATA(3)\fP
.IP CURLOPT_HTTPGET
Do an HTTP GET request. See \fICURLOPT_HTTPGET(3)\fP
.IP CURLOPT_REQUEST_TARGET
Set the request target. \fICURLOPT_REQUEST_TARGET(3)\fP
.IP CURLOPT_HTTP_VERSION
HTTP version to use. \fICURLOPT_HTTP_VERSION(3)\fP
.IP CURLOPT_HTTP09_ALLOWED
Allow HTTP/0.9 responses. \fICURLOPT_HTTP09_ALLOWED(3)\fP
.IP CURLOPT_IGNORE_CONTENT_LENGTH
Ignore Content-Length. See \fICURLOPT_IGNORE_CONTENT_LENGTH(3)\fP
.IP CURLOPT_HTTP_CONTENT_DECODING
Disable Content decoding. See \fICURLOPT_HTTP_CONTENT_DECODING(3)\fP
.IP CURLOPT_HTTP_TRANSFER_DECODING
Disable Transfer decoding. See \fICURLOPT_HTTP_TRANSFER_DECODING(3)\fP
.IP CURLOPT_EXPECT_100_TIMEOUT_MS
100-continue timeout. See \fICURLOPT_EXPECT_100_TIMEOUT_MS(3)\fP
.IP CURLOPT_TRAILERFUNCTION
Set callback for sending trailing headers. See
\fICURLOPT_TRAILERFUNCTION(3)\fP
.IP CURLOPT_TRAILERDATA
Custom pointer passed to the trailing headers callback. See
\fICURLOPT_TRAILERDATA(3)\fP
.IP CURLOPT_PIPEWAIT
Wait on connection to pipeline on it. See \fICURLOPT_PIPEWAIT(3)\fP
.IP CURLOPT_STREAM_DEPENDS
This HTTP/2 stream depends on another. See \fICURLOPT_STREAM_DEPENDS(3)\fP
.IP CURLOPT_STREAM_DEPENDS_E
This HTTP/2 stream depends on another exclusively. See
\fICURLOPT_STREAM_DEPENDS_E(3)\fP
.IP CURLOPT_STREAM_WEIGHT
Set this HTTP/2 stream's weight. See \fICURLOPT_STREAM_WEIGHT(3)\fP
.SH SMTP OPTIONS
.IP CURLOPT_MAIL_FROM
Address of the sender. See \fICURLOPT_MAIL_FROM(3)\fP
.IP CURLOPT_MAIL_RCPT
Address of the recipients. See \fICURLOPT_MAIL_RCPT(3)\fP
.IP CURLOPT_MAIL_AUTH
Authentication address. See \fICURLOPT_MAIL_AUTH(3)\fP
.IP CURLOPT_MAIL_RCPT_ALLOWFAILS
Allow RCPT TO command to fail for some recipients. See
\fICURLOPT_MAIL_RCPT_ALLOWFAILS(3)\fP
.SH TFTP OPTIONS
.IP CURLOPT_TFTP_BLKSIZE
TFTP block size. See \fICURLOPT_TFTP_BLKSIZE(3)\fP
.IP CURLOPT_TFTP_NO_OPTIONS
Do not send TFTP options requests. See \fICURLOPT_TFTP_NO_OPTIONS(3)\fP
.SH FTP OPTIONS
.IP CURLOPT_FTPPORT
Use active FTP. See \fICURLOPT_FTPPORT(3)\fP
.IP CURLOPT_QUOTE
Commands to run before transfer. See \fICURLOPT_QUOTE(3)\fP
.IP CURLOPT_POSTQUOTE
Commands to run after transfer. See \fICURLOPT_POSTQUOTE(3)\fP
.IP CURLOPT_PREQUOTE
Commands to run just before transfer. See \fICURLOPT_PREQUOTE(3)\fP
.IP CURLOPT_APPEND
Append to remote file. See \fICURLOPT_APPEND(3)\fP
.IP CURLOPT_FTP_USE_EPRT
Use EPRT. See \fICURLOPT_FTP_USE_EPRT(3)\fP
.IP CURLOPT_FTP_USE_EPSV
Use EPSV. See \fICURLOPT_FTP_USE_EPSV(3)\fP
.IP CURLOPT_FTP_USE_PRET
Use PRET. See \fICURLOPT_FTP_USE_PRET(3)\fP
.IP CURLOPT_FTP_CREATE_MISSING_DIRS
Create missing directories on the remote server. See \fICURLOPT_FTP_CREATE_MISSING_DIRS(3)\fP
.IP CURLOPT_SERVER_RESPONSE_TIMEOUT
Timeout for server responses. See \fICURLOPT_SERVER_RESPONSE_TIMEOUT(3)\fP
.IP CURLOPT_FTP_ALTERNATIVE_TO_USER
Alternative to USER. See \fICURLOPT_FTP_ALTERNATIVE_TO_USER(3)\fP
.IP CURLOPT_FTP_SKIP_PASV_IP
Ignore the IP address in the PASV response. See \fICURLOPT_FTP_SKIP_PASV_IP(3)\fP
.IP CURLOPT_FTPSSLAUTH
Control how to do TLS. See \fICURLOPT_FTPSSLAUTH(3)\fP
.IP CURLOPT_FTP_SSL_CCC
Back to non-TLS again after authentication. See \fICURLOPT_FTP_SSL_CCC(3)\fP
.IP CURLOPT_FTP_ACCOUNT
Send ACCT command. See \fICURLOPT_FTP_ACCOUNT(3)\fP
.IP CURLOPT_FTP_FILEMETHOD
Specify how to reach files. See \fICURLOPT_FTP_FILEMETHOD(3)\fP
.SH RTSP OPTIONS
.IP CURLOPT_RTSP_REQUEST
RTSP request. See \fICURLOPT_RTSP_REQUEST(3)\fP
.IP CURLOPT_RTSP_SESSION_ID
RTSP session-id. See \fICURLOPT_RTSP_SESSION_ID(3)\fP
.IP CURLOPT_RTSP_STREAM_URI
RTSP stream URI. See \fICURLOPT_RTSP_STREAM_URI(3)\fP
.IP CURLOPT_RTSP_TRANSPORT
RTSP Transport: header. See \fICURLOPT_RTSP_TRANSPORT(3)\fP
.IP CURLOPT_RTSP_CLIENT_CSEQ
Client CSEQ number. See \fICURLOPT_RTSP_CLIENT_CSEQ(3)\fP
.IP CURLOPT_RTSP_SERVER_CSEQ
CSEQ number for RTSP Server->Client request. See \fICURLOPT_RTSP_SERVER_CSEQ(3)\fP
.IP CURLOPT_AWS_SIGV4
AWS HTTP V4 Signature. See \fICURLOPT_AWS_SIGV4(3)\fP
.SH PROTOCOL OPTIONS
.IP CURLOPT_TRANSFERTEXT
Use text transfer. See \fICURLOPT_TRANSFERTEXT(3)\fP
.IP CURLOPT_PROXY_TRANSFER_MODE
Add transfer mode to URL over proxy. See \fICURLOPT_PROXY_TRANSFER_MODE(3)\fP
.IP CURLOPT_CRLF
Convert newlines. See \fICURLOPT_CRLF(3)\fP
.IP CURLOPT_RANGE
Range requests. See \fICURLOPT_RANGE(3)\fP
.IP CURLOPT_RESUME_FROM
Resume a transfer. See \fICURLOPT_RESUME_FROM(3)\fP
.IP CURLOPT_RESUME_FROM_LARGE
Resume a transfer. See \fICURLOPT_RESUME_FROM_LARGE(3)\fP
.IP CURLOPT_CURLU
Set URL to work on with a URL handle. See \fICURLOPT_CURLU(3)\fP
.IP CURLOPT_CUSTOMREQUEST
Custom request/method. See \fICURLOPT_CUSTOMREQUEST(3)\fP
.IP CURLOPT_FILETIME
Request file modification date and time. See \fICURLOPT_FILETIME(3)\fP
.IP CURLOPT_DIRLISTONLY
List only. See \fICURLOPT_DIRLISTONLY(3)\fP
.IP CURLOPT_NOBODY
Do not get the body contents. See \fICURLOPT_NOBODY(3)\fP
.IP CURLOPT_INFILESIZE
Size of file to send. \fICURLOPT_INFILESIZE(3)\fP
.IP CURLOPT_INFILESIZE_LARGE
Size of file to send. \fICURLOPT_INFILESIZE_LARGE(3)\fP
.IP CURLOPT_UPLOAD
Upload data. See \fICURLOPT_UPLOAD(3)\fP
.IP CURLOPT_UPLOAD_BUFFERSIZE
Set upload buffer size. See \fICURLOPT_UPLOAD_BUFFERSIZE(3)\fP
.IP CURLOPT_MIMEPOST
Post/send MIME data. See \fICURLOPT_MIMEPOST(3)\fP
.IP CURLOPT_MIME_OPTIONS
Set MIME option flags. See \fICURLOPT_MIME_OPTIONS(3)\fP
.IP CURLOPT_MAXFILESIZE
Maximum file size to get. See \fICURLOPT_MAXFILESIZE(3)\fP
.IP CURLOPT_MAXFILESIZE_LARGE
Maximum file size to get. See \fICURLOPT_MAXFILESIZE_LARGE(3)\fP
.IP CURLOPT_TIMECONDITION
Make a time conditional request. See \fICURLOPT_TIMECONDITION(3)\fP
.IP CURLOPT_TIMEVALUE
Time value for the time conditional request. See \fICURLOPT_TIMEVALUE(3)\fP
.IP CURLOPT_TIMEVALUE_LARGE
Time value for the time conditional request. See \fICURLOPT_TIMEVALUE_LARGE(3)\fP
.SH CONNECTION OPTIONS
.IP CURLOPT_TIMEOUT
Timeout for the entire request. See \fICURLOPT_TIMEOUT(3)\fP
.IP CURLOPT_TIMEOUT_MS
Millisecond timeout for the entire request. See \fICURLOPT_TIMEOUT_MS(3)\fP
.IP CURLOPT_LOW_SPEED_LIMIT
Low speed limit to abort transfer. See \fICURLOPT_LOW_SPEED_LIMIT(3)\fP
.IP CURLOPT_LOW_SPEED_TIME
Time to be below the speed to trigger low speed abort. See \fICURLOPT_LOW_SPEED_TIME(3)\fP
.IP CURLOPT_MAX_SEND_SPEED_LARGE
Cap the upload speed to this. See \fICURLOPT_MAX_SEND_SPEED_LARGE(3)\fP
.IP CURLOPT_MAX_RECV_SPEED_LARGE
Cap the download speed to this. See \fICURLOPT_MAX_RECV_SPEED_LARGE(3)\fP
.IP CURLOPT_MAXCONNECTS
Maximum number of connections in the connection pool. See \fICURLOPT_MAXCONNECTS(3)\fP
.IP CURLOPT_FRESH_CONNECT
Use a new connection. \fICURLOPT_FRESH_CONNECT(3)\fP
.IP CURLOPT_FORBID_REUSE
Prevent subsequent connections from reusing this. See \fICURLOPT_FORBID_REUSE(3)\fP
.IP CURLOPT_MAXAGE_CONN
Limit the age (idle time) of connections for reuse. See \fICURLOPT_MAXAGE_CONN(3)\fP
.IP CURLOPT_MAXLIFETIME_CONN
Limit the age (since creation) of connections for reuse. See \fICURLOPT_MAXLIFETIME_CONN(3)\fP
.IP CURLOPT_CONNECTTIMEOUT
Timeout for the connection phase. See \fICURLOPT_CONNECTTIMEOUT(3)\fP
.IP CURLOPT_CONNECTTIMEOUT_MS
Millisecond timeout for the connection phase. See \fICURLOPT_CONNECTTIMEOUT_MS(3)\fP
.IP CURLOPT_IPRESOLVE
IP version to use. See \fICURLOPT_IPRESOLVE(3)\fP
.IP CURLOPT_CONNECT_ONLY
Only connect, nothing else. See \fICURLOPT_CONNECT_ONLY(3)\fP
.IP CURLOPT_USE_SSL
Use TLS/SSL. See \fICURLOPT_USE_SSL(3)\fP
.IP CURLOPT_RESOLVE
Provide fixed/fake name resolves. See \fICURLOPT_RESOLVE(3)\fP
.IP CURLOPT_DNS_INTERFACE
Bind name resolves to this interface. See \fICURLOPT_DNS_INTERFACE(3)\fP
.IP CURLOPT_DNS_LOCAL_IP4
Bind name resolves to this IP4 address. See \fICURLOPT_DNS_LOCAL_IP4(3)\fP
.IP CURLOPT_DNS_LOCAL_IP6
Bind name resolves to this IP6 address. See \fICURLOPT_DNS_LOCAL_IP6(3)\fP
.IP CURLOPT_DNS_SERVERS
Preferred DNS servers. See \fICURLOPT_DNS_SERVERS(3)\fP
.IP CURLOPT_DNS_SHUFFLE_ADDRESSES
Shuffle addresses before use. See \fICURLOPT_DNS_SHUFFLE_ADDRESSES(3)\fP
.IP CURLOPT_ACCEPTTIMEOUT_MS
Timeout for waiting for the server's connect back to be accepted. See \fICURLOPT_ACCEPTTIMEOUT_MS(3)\fP
.IP CURLOPT_HAPPY_EYEBALLS_TIMEOUT_MS
Timeout for happy eyeballs. See \fICURLOPT_HAPPY_EYEBALLS_TIMEOUT_MS(3)\fP
.IP CURLOPT_UPKEEP_INTERVAL_MS
Sets the interval at which connection upkeep are performed. See
\fICURLOPT_UPKEEP_INTERVAL_MS(3)\fP
.SH SSL and SECURITY OPTIONS
.IP CURLOPT_SSLCERT
Client cert. See \fICURLOPT_SSLCERT(3)\fP
.IP CURLOPT_SSLCERT_BLOB
Client cert memory buffer. See \fICURLOPT_SSLCERT_BLOB(3)\fP
.IP CURLOPT_PROXY_SSLCERT
Proxy client cert. See \fICURLOPT_PROXY_SSLCERT(3)\fP
.IP CURLOPT_PROXY_SSLCERT_BLOB
Proxy client cert memory buffer. See \fICURLOPT_PROXY_SSLCERT_BLOB(3)\fP
.IP CURLOPT_SSLCERTTYPE
Client cert type. See \fICURLOPT_SSLCERTTYPE(3)\fP
.IP CURLOPT_PROXY_SSLCERTTYPE
Proxy client cert type. See \fICURLOPT_PROXY_SSLCERTTYPE(3)\fP
.IP CURLOPT_SSLKEY
Client key. See \fICURLOPT_SSLKEY(3)\fP
.IP CURLOPT_SSLKEY_BLOB
Client key memory buffer. See \fICURLOPT_SSLKEY_BLOB(3)\fP
.IP CURLOPT_PROXY_SSLKEY
Proxy client key. See \fICURLOPT_PROXY_SSLKEY(3)\fP
.IP CURLOPT_PROXY_SSLKEY_BLOB
Proxy client key. See \fICURLOPT_PROXY_SSLKEY_BLOB(3)\fP
.IP CURLOPT_SSLKEYTYPE
Client key type. See \fICURLOPT_SSLKEYTYPE(3)\fP
.IP CURLOPT_PROXY_SSLKEYTYPE
Proxy client key type. See \fICURLOPT_PROXY_SSLKEYTYPE(3)\fP
.IP CURLOPT_KEYPASSWD
Client key password. See \fICURLOPT_KEYPASSWD(3)\fP
.IP CURLOPT_PROXY_KEYPASSWD
Proxy client key password. See \fICURLOPT_PROXY_KEYPASSWD(3)\fP
.IP CURLOPT_SSL_EC_CURVES
Set key exchange curves. See \fICURLOPT_SSL_EC_CURVES(3)\fP
.IP CURLOPT_SSL_ENABLE_ALPN
Enable use of ALPN. See \fICURLOPT_SSL_ENABLE_ALPN(3)\fP
.IP CURLOPT_SSL_ENABLE_NPN
\fBOBSOLETE\fP Enable use of NPN. See \fICURLOPT_SSL_ENABLE_NPN(3)\fP
.IP CURLOPT_SSLENGINE
Use identifier with SSL engine. See \fICURLOPT_SSLENGINE(3)\fP
.IP CURLOPT_SSLENGINE_DEFAULT
Default SSL engine. See \fICURLOPT_SSLENGINE_DEFAULT(3)\fP
.IP CURLOPT_SSL_FALSESTART
Enable TLS False Start. See \fICURLOPT_SSL_FALSESTART(3)\fP
.IP CURLOPT_SSLVERSION
SSL version to use. See \fICURLOPT_SSLVERSION(3)\fP
.IP CURLOPT_PROXY_SSLVERSION
Proxy SSL version to use. See \fICURLOPT_PROXY_SSLVERSION(3)\fP
.IP CURLOPT_SSL_VERIFYHOST
Verify the host name in the SSL certificate. See \fICURLOPT_SSL_VERIFYHOST(3)\fP
.IP CURLOPT_DOH_SSL_VERIFYHOST
Verify the host name in the DoH (DNS-over-HTTPS) SSL certificate. See
\fICURLOPT_DOH_SSL_VERIFYHOST(3)\fP
.IP CURLOPT_PROXY_SSL_VERIFYHOST
Verify the host name in the proxy SSL certificate. See \fICURLOPT_PROXY_SSL_VERIFYHOST(3)\fP
.IP CURLOPT_SSL_VERIFYPEER
Verify the SSL certificate. See \fICURLOPT_SSL_VERIFYPEER(3)\fP
.IP CURLOPT_DOH_SSL_VERIFYPEER
Verify the DoH (DNS-over-HTTPS) SSL certificate. See
\fICURLOPT_DOH_SSL_VERIFYPEER(3)\fP
.IP CURLOPT_PROXY_SSL_VERIFYPEER
Verify the proxy SSL certificate. See \fICURLOPT_PROXY_SSL_VERIFYPEER(3)\fP
.IP CURLOPT_SSL_VERIFYSTATUS
Verify the SSL certificate's status. See \fICURLOPT_SSL_VERIFYSTATUS(3)\fP
.IP CURLOPT_DOH_SSL_VERIFYSTATUS
Verify the DoH (DNS-over-HTTPS) SSL certificate's status. See
\fICURLOPT_DOH_SSL_VERIFYSTATUS(3)\fP
.IP CURLOPT_CAINFO
CA cert bundle. See \fICURLOPT_CAINFO(3)\fP
.IP CURLOPT_CAINFO_BLOB
CA cert bundle memory buffer. See \fICURLOPT_CAINFO_BLOB(3)\fP
.IP CURLOPT_PROXY_CAINFO
Proxy CA cert bundle. See \fICURLOPT_PROXY_CAINFO(3)\fP
.IP CURLOPT_PROXY_CAINFO_BLOB
Proxy CA cert bundle memory buffer. See \fICURLOPT_PROXY_CAINFO_BLOB(3)\fP
.IP CURLOPT_ISSUERCERT
Issuer certificate. See \fICURLOPT_ISSUERCERT(3)\fP
.IP CURLOPT_ISSUERCERT_BLOB
Issuer certificate memory buffer. See \fICURLOPT_ISSUERCERT_BLOB(3)\fP
.IP CURLOPT_PROXY_ISSUERCERT
Proxy issuer certificate. See \fICURLOPT_PROXY_ISSUERCERT(3)\fP
.IP CURLOPT_PROXY_ISSUERCERT_BLOB
Proxy issuer certificate memory buffer. See \fICURLOPT_PROXY_ISSUERCERT_BLOB(3)\fP
.IP CURLOPT_CAPATH
Path to CA cert bundle. See \fICURLOPT_CAPATH(3)\fP
.IP CURLOPT_PROXY_CAPATH
Path to proxy CA cert bundle. See \fICURLOPT_PROXY_CAPATH(3)\fP
.IP CURLOPT_CRLFILE
Certificate Revocation List. See \fICURLOPT_CRLFILE(3)\fP
.IP CURLOPT_PROXY_CRLFILE
Proxy Certificate Revocation List. See \fICURLOPT_PROXY_CRLFILE(3)\fP
.IP CURLOPT_CA_CACHE_TIMEOUT
Timeout for CA cache. See \fICURLOPT_CA_CACHE_TIMEOUT(3)\fP
.IP CURLOPT_CERTINFO
Extract certificate info. See \fICURLOPT_CERTINFO(3)\fP
.IP CURLOPT_PINNEDPUBLICKEY
Set pinned SSL public key . See \fICURLOPT_PINNEDPUBLICKEY(3)\fP
.IP CURLOPT_PROXY_PINNEDPUBLICKEY
Set the proxy's pinned SSL public key. See
\fICURLOPT_PROXY_PINNEDPUBLICKEY(3)\fP
.IP CURLOPT_RANDOM_FILE
\fBOBSOLETE\fP Provide source for entropy random data.
See \fICURLOPT_RANDOM_FILE(3)\fP
.IP CURLOPT_EGDSOCKET
\fBOBSOLETE\fP Identify EGD socket for entropy. See \fICURLOPT_EGDSOCKET(3)\fP
.IP CURLOPT_SSL_CIPHER_LIST
Ciphers to use. See \fICURLOPT_SSL_CIPHER_LIST(3)\fP
.IP CURLOPT_PROXY_SSL_CIPHER_LIST
Proxy ciphers to use. See \fICURLOPT_PROXY_SSL_CIPHER_LIST(3)\fP
.IP CURLOPT_TLS13_CIPHERS
TLS 1.3 cipher suites to use. See \fICURLOPT_TLS13_CIPHERS(3)\fP
.IP CURLOPT_PROXY_TLS13_CIPHERS
Proxy TLS 1.3 cipher suites to use. See \fICURLOPT_PROXY_TLS13_CIPHERS(3)\fP
.IP CURLOPT_SSL_SESSIONID_CACHE
Disable SSL session-id cache. See \fICURLOPT_SSL_SESSIONID_CACHE(3)\fP
.IP CURLOPT_SSL_OPTIONS
Control SSL behavior. See \fICURLOPT_SSL_OPTIONS(3)\fP
.IP CURLOPT_PROXY_SSL_OPTIONS
Control proxy SSL behavior. See \fICURLOPT_PROXY_SSL_OPTIONS(3)\fP
.IP CURLOPT_KRBLEVEL
Kerberos security level. See \fICURLOPT_KRBLEVEL(3)\fP
.IP CURLOPT_GSSAPI_DELEGATION
Disable GSS-API delegation. See \fICURLOPT_GSSAPI_DELEGATION(3)\fP
.SH SSH OPTIONS
.IP CURLOPT_SSH_AUTH_TYPES
SSH authentication types. See \fICURLOPT_SSH_AUTH_TYPES(3)\fP
.IP CURLOPT_SSH_COMPRESSION
Enable SSH compression. See \fICURLOPT_SSH_COMPRESSION(3)\fP
.IP CURLOPT_SSH_HOST_PUBLIC_KEY_MD5
MD5 of host's public key. See \fICURLOPT_SSH_HOST_PUBLIC_KEY_MD5(3)\fP
.IP CURLOPT_SSH_HOST_PUBLIC_KEY_SHA256
SHA256 of host's public key. See \fICURLOPT_SSH_HOST_PUBLIC_KEY_SHA256(3)\fP
.IP CURLOPT_SSH_PUBLIC_KEYFILE
File name of public key. See \fICURLOPT_SSH_PUBLIC_KEYFILE(3)\fP
.IP CURLOPT_SSH_PRIVATE_KEYFILE
File name of private key. See \fICURLOPT_SSH_PRIVATE_KEYFILE(3)\fP
.IP CURLOPT_SSH_KNOWNHOSTS
File name with known hosts. See \fICURLOPT_SSH_KNOWNHOSTS(3)\fP
.IP CURLOPT_SSH_KEYFUNCTION
Callback for known hosts handling. See \fICURLOPT_SSH_KEYFUNCTION(3)\fP
.IP CURLOPT_SSH_KEYDATA
Custom pointer to pass to ssh key callback. See \fICURLOPT_SSH_KEYDATA(3)\fP
.IP CURLOPT_SSH_HOSTKEYFUNCTION
Callback for checking host key handling. See \fICURLOPT_SSH_HOSTKEYFUNCTION(3)\fP
.IP CURLOPT_SSH_HOSTKEYDATA
Custom pointer to pass to ssh host key callback. See \fICURLOPT_SSH_HOSTKEYDATA(3)\fP
.SH WEBSOCKET
.IP CURLOPT_WS_OPTIONS
Set WebSocket options. See \fICURLOPT_WS_OPTIONS(3)\fP
.SH OTHER OPTIONS
.IP CURLOPT_PRIVATE
Private pointer to store. See \fICURLOPT_PRIVATE(3)\fP
.IP CURLOPT_SHARE
Share object to use. See \fICURLOPT_SHARE(3)\fP
.IP CURLOPT_NEW_FILE_PERMS
Mode for creating new remote files. See \fICURLOPT_NEW_FILE_PERMS(3)\fP
.IP CURLOPT_NEW_DIRECTORY_PERMS
Mode for creating new remote directories. See \fICURLOPT_NEW_DIRECTORY_PERMS(3)\fP
.IP CURLOPT_QUICK_EXIT
To be set by toplevel tools like "curl" to skip lengthy cleanups when they are about to call exit() anyway. See \fICURLOPT_QUICK_EXIT(3)\fP
.SH TELNET OPTIONS
.IP CURLOPT_TELNETOPTIONS
TELNET options. See \fICURLOPT_TELNETOPTIONS(3)\fP
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
CURLcode res;
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
res = curl_easy_perform(curl);
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Always
.SH RETURN VALUE
\fICURLE_OK\fP (zero) means that the option was set properly, non-zero means an
error occurred as \fI<curl/curl.h>\fP defines. See the \fIlibcurl-errors(3)\fP
man page for the full list with descriptions.
Strings passed on to libcurl must be shorter than 8000000 bytes, otherwise
\fIcurl_easy_setopt(3)\fP returns \fBCURLE_BAD_FUNCTION_ARGUMENT\fP (added in
7.65.0).
\fBCURLE_BAD_FUNCTION_ARGUMENT\fP is returned when the argument to an option
is invalid, like perhaps out of range.
If you try to set an option that libcurl does not know about, perhaps because
the library is too old to support it or the option was removed in a recent
version, this function returns \fICURLE_UNKNOWN_OPTION\fP. If support for the
option was disabled at compile-time, it returns \fICURLE_NOT_BUILT_IN\fP.
.SH "SEE ALSO"
.BR curl_easy_cleanup (3),
.BR curl_easy_getinfo (3),
.BR curl_easy_init (3),
.BR curl_easy_option_by_id (3),
.BR curl_easy_option_by_name (3),
.BR curl_easy_option_next (3),
.BR curl_easy_reset (3),
.BR curl_multi_setopt (3)
man/man3/CURLINFO_HTTP_VERSION.3 0000644 00000004260 14751172371 0011540 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLINFO_HTTP_VERSION 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLINFO_HTTP_VERSION \- get the http version used in the connection
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_getinfo(CURL *handle, CURLINFO_HTTP_VERSION, long *p);
.fi
.SH DESCRIPTION
Pass a pointer to a long to receive the version used in the last http
connection done using this handle. The returned value is
CURL_HTTP_VERSION_1_0, CURL_HTTP_VERSION_1_1, CURL_HTTP_VERSION_2_0,
CURL_HTTP_VERSION_3 or 0 if the version cannot be determined.
.SH PROTOCOLS
HTTP
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
CURLcode res;
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
res = curl_easy_perform(curl);
if(res == CURLE_OK) {
long http_version;
curl_easy_getinfo(curl, CURLINFO_HTTP_VERSION, &http_version);
}
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Added in 7.50.0
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR curl_easy_getinfo (3),
.BR curl_easy_setopt (3),
.BR CURLINFO_RESPONSE_CODE (3)
man/man3/CURLINFO_TLS_SESSION.3 0000644 00000005566 14751172371 0011433 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLINFO_TLS_SESSION 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLINFO_TLS_SESSION \- get TLS session info
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_getinfo(CURL *handle, CURLINFO_TLS_SESSION,
struct curl_tlssessioninfo **session);
.SH DESCRIPTION
\fBThis option has been superseded\fP by \fICURLINFO_TLS_SSL_PTR(3)\fP which
was added in 7.48.0. The only reason you would use this option instead is if
you could be using a version of libcurl earlier than 7.48.0.
This option is exactly the same as \fICURLINFO_TLS_SSL_PTR(3)\fP except in the
case of OpenSSL. If the session \fIbackend\fP is CURLSSLBACKEND_OPENSSL the
session \fIinternals\fP pointer varies depending on the option:
\fICURLINFO_TLS_SESSION(3)\fP OpenSSL session \fIinternals\fP is \fBSSL_CTX *\fP.
\fICURLINFO_TLS_SSL_PTR(3)\fP OpenSSL session \fIinternals\fP is \fBSSL *\fP.
You can obtain an \fBSSL_CTX\fP pointer from an SSL pointer using OpenSSL
function \fISSL_get_SSL_CTX(3)\fP. Therefore unless you need compatibility
with older versions of libcurl use \fICURLINFO_TLS_SSL_PTR(3)\fP. Refer to
that document for more information.
.SH PROTOCOLS
All TLS-based
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
CURLcode res;
struct curl_tlssessioninfo *tls;
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
res = curl_easy_perform(curl);
curl_easy_getinfo(curl, CURLINFO_TLS_SESSION, &tls);
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Added in 7.34.0. Deprecated since 7.48.0 and supported OpenSSL, GnuTLS, and
NSS only up until this version was released.
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR curl_easy_getinfo (3),
.BR curl_easy_setopt (3),
.BR CURLINFO_TLS_SSL_PTR (3)
man/man3/CURLOPT_SASL_AUTHZID.3 0000644 00000005260 14751172371 0011416 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_SASL_AUTHZID 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_SASL_AUTHZID \- authorization identity (identity to act as)
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_SASL_AUTHZID, char *authzid);
.fi
.SH DESCRIPTION
Pass a char * as parameter, which should be pointing to the null-terminated
authorization identity (\fIauthzid\fP) for the transfer. Only applicable to
the PLAIN SASL authentication mechanism where it is optional.
When not specified only the authentication identity (\fIauthcid\fP) as
specified by the username is sent to the server, along with the password. The
server derives a \fIauthzid\fP from the \fIauthcid\fP when not provided, which
it then uses internally.
When the \fIauthzid\fP is specified, the use of which is server dependent, it
can be used to access another user's inbox, that the user has been granted
access to, or a shared mailbox for example.
.SH DEFAULT
blank
.SH PROTOCOLS
IMAP, LDAP, POP3 and SMTP
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "imap://example.com/");
curl_easy_setopt(curl, CURLOPT_USERNAME, "Kurt");
curl_easy_setopt(curl, CURLOPT_PASSWORD, "xipj3plmq");
curl_easy_setopt(curl, CURLOPT_SASL_AUTHZID, "Ursel");
ret = curl_easy_perform(curl);
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Added in 7.66.0. Support for OpenLDAP added in 7.82.0.
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR CURLOPT_PASSWORD (3),
.BR CURLOPT_USERNAME (3),
.BR CURLOPT_USERPWD (3)
man/man3/curl_mime_subparts.3 0000644 00000005441 14751172371 0012154 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.TH curl_mime_subparts 3 "September 27, 2023" "libcurl 8.4.0" "libcurl"
.SH NAME
curl_mime_subparts - set sub-parts of a multipart mime part
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_mime_subparts(curl_mimepart *part, curl_mime *subparts);
.fi
.SH DESCRIPTION
\fIcurl_mime_subparts(3)\fP sets a multipart mime part's content from a mime
structure.
\fIpart\fP is a handle to the multipart part.
\fIsubparts\fP is a mime structure handle holding the sub-parts. After
\fIcurl_mime_subparts(3)\fP succeeds, the mime structure handle belongs to the
multipart part and must not be freed explicitly. It may however be updated by
subsequent calls to mime API functions.
Setting a part's contents multiple times is valid: only the value set by the
last call is retained. It is possible to unassign previous part's contents by
setting \fIsubparts\fP to NULL.
.SH EXAMPLE
.nf
/* The inline part is an alternative proposing the html and the text
versions of the email. */
alt = curl_mime_init(curl);
/* HTML message. */
part = curl_mime_addpart(alt);
curl_mime_data(part, inline_html, CURL_ZERO_TERMINATED);
curl_mime_type(part, "text/html");
/* Text message. */
part = curl_mime_addpart(alt);
curl_mime_data(part, inline_text, CURL_ZERO_TERMINATED);
/* Create the inline part. */
part = curl_mime_addpart(mime);
curl_mime_subparts(part, alt);
curl_mime_type(part, "multipart/alternative");
slist = curl_slist_append(NULL, "Content-Disposition: inline");
curl_mime_headers(part, slist, 1);
.fi
.SH AVAILABILITY
As long as at least one of HTTP, SMTP or IMAP is enabled. Added in 7.56.0.
.SH RETURN VALUE
CURLE_OK or a CURL error code upon failure.
.SH "SEE ALSO"
.BR curl_mime_addpart (3),
.BR curl_mime_init (3)
man/man3/curl_multi_add_handle.3 0000644 00000006467 14751172371 0012570 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.TH curl_multi_add_handle 3 "September 26, 2023" "libcurl 8.4.0" "libcurl"
.SH NAME
curl_multi_add_handle - add an easy handle to a multi session
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLMcode curl_multi_add_handle(CURLM *multi_handle, CURL *easy_handle);
.fi
.SH DESCRIPTION
Adds the \fIeasy handle\fP to the \fImulti_handle\fP.
While an easy handle is added to a multi stack, you cannot and you must not
use \fIcurl_easy_perform(3)\fP on that handle. After having removed the easy
handle from the multi stack again, it is perfectly fine to use it with the
easy interface again.
If the easy handle is not set to use a shared (\fICURLOPT_SHARE(3)\fP) cache,
it is made to use a DNS cache that is shared between all easy handles within
the multi handle when \fIcurl_multi_add_handle(3)\fP is called.
When an easy interface is added to a multi handle, it is set to use a shared
connection cache owned by the multi handle. Removing and adding new easy
handles does not affect the pool of connections or the ability to do
connection reuse.
If you have \fICURLMOPT_TIMERFUNCTION(3)\fP set in the multi handle (as you
should if you are working event-based with \fIcurl_multi_socket_action(3)\fP
and friends), that callback is called from within this function to ask for an
updated timer so that your main event loop gets the activity on this handle to
get started.
The easy handle remains added to the multi handle until you remove it again
with \fIcurl_multi_remove_handle(3)\fP - even when a transfer with that
specific easy handle is completed.
You should remove the easy handle from the multi stack before you terminate
first the easy handle and then the multi handle:
1 - \fIcurl_multi_remove_handle(3)\fP
2 - \fIcurl_easy_cleanup(3)\fP
3 - \fIcurl_multi_cleanup(3)\fP
.SH EXAMPLE
.nf
/* init a multi stack */
multi_handle = curl_multi_init();
/* add individual transfers */
curl_multi_add_handle(multi_handle, http_handle);
curl_multi_add_handle(multi_handle, http_handle2);
.fi
.SH AVAILABILITY
Added in 7.9.6
.SH RETURN VALUE
CURLMcode type, general libcurl multi interface error code.
.SH "SEE ALSO"
.BR curl_multi_cleanup (3),
.BR curl_multi_get_handles (3),
.BR curl_multi_init (3),
.BR curl_multi_setopt (3),
.BR curl_multi_socket_action (3)
man/man3/curl_easy_perform.3 0000644 00000007111 14751172371 0011771 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.TH curl_easy_perform 3 "September 27, 2023" "libcurl 8.4.0" "libcurl"
.SH NAME
curl_easy_perform - perform a blocking file transfer
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_perform(CURL *easy_handle);
.fi
.SH DESCRIPTION
\fIcurl_easy_perform(3)\fP performs a network transfer in a blocking manner
and returns when done, or earlier if it fails. For non-blocking behavior, see
\fIcurl_multi_perform(3)\fP.
Invoke this function after \fIcurl_easy_init(3)\fP and all the
\fIcurl_easy_setopt(3)\fP calls are made, and it performs the transfer as
described in the options. It must be called with the same \fBeasy_handle\fP as
input as the \fIcurl_easy_init(3)\fP call returned.
You can do any amount of calls to \fIcurl_easy_perform(3)\fP while using the
same \fBeasy_handle\fP. If you intend to transfer more than one file, you are
even encouraged to do so. libcurl attempts to reuse existing connections for
the following transfers, thus making the operations faster, less CPU intense
and using less network resources. You probably want to use
\fIcurl_easy_setopt(3)\fP between the invokes to set options for the following
\fIcurl_easy_perform(3)\fP call.
You must never call this function simultaneously from two places using the
same \fBeasy_handle\fP. Let the function return first before invoking it
another time. If you want parallel transfers, you must use several curl
easy_handles.
A network transfer moves data to a peer or from a peer. An application tells
libcurl how to receive data by setting the \fICURLOPT_WRITEFUNCTION(3)\fP and
\fICURLOPT_WRITEDATA(3)\fP options. To tell libcurl what data to send, there
are a few more alternatives but two common ones are
\fICURLOPT_READFUNCTION(3)\fP and \fICURLOPT_POSTFIELDS(3)\fP.
While the \fBeasy_handle\fP is added to a multi handle, it cannot be used by
\fIcurl_easy_perform(3)\fP.
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
CURLcode res;
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
res = curl_easy_perform(curl);
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Always
.SH RETURN VALUE
CURLE_OK (0) means everything was OK, non-zero means an error occurred as
.I <curl/curl.h>
defines - see \fIlibcurl-errors(3)\fP. If the \fICURLOPT_ERRORBUFFER(3)\fP was
set with \fIcurl_easy_setopt(3)\fP there is a readable error message stored in
the error buffer when non-zero is returned.
.SH "SEE ALSO"
.BR curl_easy_init (3),
.BR curl_easy_setopt (3),
.BR curl_multi_add_handle (3),
.BR curl_multi_perform (3),
.BR libcurl-errors (3)
man/man3/CURLOPT_PROXY_SSL_CIPHER_LIST.3 0000644 00000006525 14751172371 0013020 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_PROXY_SSL_CIPHER_LIST 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_PROXY_SSL_CIPHER_LIST \- ciphers to use for HTTPS proxy
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_PROXY_SSL_CIPHER_LIST,
char *list);
.fi
.SH DESCRIPTION
Pass a char *, pointing to a null-terminated string holding the list of
ciphers to use for the connection to the HTTPS proxy. The list must be
syntactically correct, it consists of one or more cipher strings separated by
colons. Commas or spaces are also acceptable separators but colons are
normally used, \&!, \&- and \&+ can be used as operators.
For OpenSSL and GnuTLS valid examples of cipher lists include \fBRC4-SHA\fP,
\fBSHA1+DES\fP, \fBTLSv1\fP and \fBDEFAULT\fP. The default list is normally
set when you compile OpenSSL.
For WolfSSL, valid examples of cipher lists include \fBECDHE-RSA-RC4-SHA\fP,
\fBAES256-SHA:AES256-SHA256\fP, etc.
For BearSSL, valid examples of cipher lists include
\fBECDHE-RSA-CHACHA20-POLY1305:ECDHE-RSA-AES128-GCM-SHA256\fP, or when using IANA names
\fBTLS_ECDHE_RSA_WITH_CHACHA20_POLY1305_SHA256:TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256\fP,
etc.
With BearSSL you do not add/remove ciphers. If one uses this option then all
known ciphers are disabled and only those passed in are enabled.
Find more details about cipher lists on this URL:
https://curl.se/docs/ssl-ciphers.html
The application does not have to keep the string around after setting this
option.
.SH DEFAULT
NULL, use internal default
.SH PROTOCOLS
All
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/");
curl_easy_setopt(curl, CURLOPT_PROXY, "https://localhost");
curl_easy_setopt(curl, CURLOPT_PROXY_SSL_CIPHER_LIST, "TLSv1");
ret = curl_easy_perform(curl);
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Added in 7.52.0, in 7.83.0 for BearSSL
If built TLS enabled.
.SH RETURN VALUE
Returns CURLE_OK if TLS is supported, CURLE_UNKNOWN_OPTION if not, or
CURLE_OUT_OF_MEMORY if there was insufficient heap space.
.SH "SEE ALSO"
.BR CURLOPT_PROXY_SSLVERSION (3),
.BR CURLOPT_PROXY_TLS13_CIPHERS (3),
.BR CURLOPT_SSL_CIPHER_LIST (3),
.BR CURLOPT_SSLVERSION (3),
.BR CURLOPT_TLS13_CIPHERS (3)
man/man3/CURLOPT_INTERFACE.3 0000644 00000005534 14751172371 0010770 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_INTERFACE 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_INTERFACE \- source interface for outgoing traffic
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_INTERFACE, char *interface);
.fi
.SH DESCRIPTION
Pass a char * as parameter. This sets the \fIinterface\fP name to use as
outgoing network interface. The name can be an interface name, an IP address,
or a host name.
If the parameter starts with "if!" then it is treated only as an interface
name. If the parameter starts with \&"host!" it is treated as either an IP
address or a hostname.
If "if!" is specified but the parameter does not match an existing interface,
\fICURLE_INTERFACE_FAILED\fP is returned from the libcurl function used to
perform the transfer.
libcurl does not support using network interface names for this option on
Windows.
We strongly advise against specifying the interface with a hostname, as it
causes libcurl to do a blocking name resolve call to retrieve the IP
address. That name resolve operation does \fBnot\fP use DNS-over-HTTPS even if
\fICURLOPT_DOH_URL(3)\fP is set.
The application does not have to keep the string around after setting this
option.
.SH DEFAULT
NULL, use whatever the TCP stack finds suitable
.SH PROTOCOLS
All
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/foo.bin");
curl_easy_setopt(curl, CURLOPT_INTERFACE, "eth0");
ret = curl_easy_perform(curl);
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
The "if!" and "host!" syntax was added in 7.24.0.
.SH RETURN VALUE
Returns CURLE_OK on success or
CURLE_OUT_OF_MEMORY if there was insufficient heap space.
.SH "SEE ALSO"
.BR CURLOPT_SOCKOPTFUNCTION (3),
.BR CURLOPT_TCP_NODELAY (3)
man/man3/CURLOPT_PORT.3 0000644 00000004750 14751172371 0010253 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_PORT 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_PORT \- remote port number to connect to
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_PORT, long number);
.fi
.SH DESCRIPTION
We discourage using this option since its scope is not obvious and hard to
predict. Set the preferred port number in the URL instead.
This option sets \fInumber\fP to be the remote port number to connect to,
instead of the one specified in the URL or the default port for the used
protocol.
Usually, you just let the URL decide which port to use but this allows the
application to override that.
While this option accepts a 'long', a port number is an unsigned 16 bit number
and therefore using a port number lower than zero or over 65535 causes a
\fBCURLE_BAD_FUNCTION_ARGUMENT\fP error.
.SH DEFAULT
By default this is 0 which makes it not used. This also makes port number zero
impossible to set with this API.
.SH PROTOCOLS
Used for all protocols that speak to a port number.
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/foo.bin");
curl_easy_setopt(curl, CURLOPT_PORT, 8080L);
ret = curl_easy_perform(curl);
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Always
.SH RETURN VALUE
Returns CURLE_OK
.SH "SEE ALSO"
.BR CURLINFO_PRIMARY_PORT (3),
.BR CURLOPT_STDERR (3),
.BR CURLOPT_URL (3)
man/man3/CURLOPT_GSSAPI_DELEGATION.3 0000644 00000004603 14751172372 0012146 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_GSSAPI_DELEGATION 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_GSSAPI_DELEGATION \- allowed GSS-API delegation
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_GSSAPI_DELEGATION, long level);
.fi
.SH DESCRIPTION
Set the long parameter \fIlevel\fP to \fBCURLGSSAPI_DELEGATION_FLAG\fP to
allow unconditional GSSAPI credential delegation. The delegation is disabled
by default since 7.21.7. Set the parameter to
\fBCURLGSSAPI_DELEGATION_POLICY_FLAG\fP to delegate only if the OK-AS-DELEGATE
flag is set in the service ticket in case this feature is supported by the
GSS-API implementation and the definition of \fIGSS_C_DELEG_POLICY_FLAG\fP was
available at compile-time.
.SH DEFAULT
CURLGSSAPI_DELEGATION_NONE
.SH PROTOCOLS
HTTP
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
CURLcode ret;
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/");
/* delegate if okayed by policy */
curl_easy_setopt(curl, CURLOPT_GSSAPI_DELEGATION,
(long)CURLGSSAPI_DELEGATION_POLICY_FLAG);
ret = curl_easy_perform(curl);
}
.fi
.SH AVAILABILITY
Added in 7.22.0
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR CURLOPT_HTTPAUTH (3),
.BR CURLOPT_PROXYAUTH (3)
man/man3/CURLINFO_RTSP_SERVER_CSEQ.3 0000644 00000004350 14751172372 0012246 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLINFO_RTSP_SERVER_CSEQ 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLINFO_RTSP_SERVER_CSEQ \- get the next RTSP server CSeq
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_getinfo(CURL *handle, CURLINFO_RTSP_SERVER_CSEQ,
long *cseq);
.fi
.SH DESCRIPTION
Pass a pointer to a long to receive the next CSeq that is expected to be used
by the application.
Listening for server initiated requests is not implemented!
Applications wishing to resume an RTSP session on another connection should
retrieve this info before closing the active connection.
.SH PROTOCOLS
RTSP
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
CURLcode res;
curl_easy_setopt(curl, CURLOPT_URL, "rtsp://rtsp.example.com");
res = curl_easy_perform(curl);
if(res == CURLE_OK) {
long cseq;
curl_easy_getinfo(curl, CURLINFO_RTSP_SERVER_CSEQ, &cseq);
}
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Added in 7.20.0
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR curl_easy_getinfo (3),
.BR curl_easy_setopt (3),
.BR CURLINFO_RTSP_CSEQ_RECV (3)
man/man3/CURLMOPT_CHUNK_LENGTH_PENALTY_SIZE.3 0000644 00000004476 14751172372 0013551 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLMOPT_CHUNK_LENGTH_PENALTY_SIZE 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLMOPT_CHUNK_LENGTH_PENALTY_SIZE \- chunk length threshold for pipelining
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLMcode curl_multi_setopt(CURLM *handle, CURLMOPT_CHUNK_LENGTH_PENALTY_SIZE,
long size);
.fi
.SH DESCRIPTION
No function since pipelining was removed in 7.62.0.
Pass a long with a \fBsize\fP in bytes. If a transfer in a pipeline is
currently processing a chunked (Transfer-encoding: chunked) request with a
current chunk length larger than \fICURLMOPT_CHUNK_LENGTH_PENALTY_SIZE(3)\fP,
that pipeline is not considered for additional requests, even if it is shorter
than \fICURLMOPT_MAX_PIPELINE_LENGTH(3)\fP.
.SH DEFAULT
The default value is 0, which means that the penalization is inactive.
.SH PROTOCOLS
HTTP(S)
.SH EXAMPLE
.nf
CURLM *m = curl_multi_init();
long maxchunk = 10000;
curl_multi_setopt(m, CURLMOPT_CHUNK_LENGTH_PENALTY_SIZE, maxchunk);
.fi
.SH AVAILABILITY
Added in 7.30.0
.SH RETURN VALUE
Returns CURLM_OK if the option is supported, and CURLM_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR CURLMOPT_CONTENT_LENGTH_PENALTY_SIZE (3),
.BR CURLMOPT_MAX_PIPELINE_LENGTH (3),
.BR CURLMOPT_PIPELINING (3)
man/man3/CURLOPT_MAIL_RCPT_ALLOWFAILS.3 0000644 00000005401 14751172372 0012551 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_MAIL_RCPT_ALLOWFAILS 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_MAIL_RCPT_ALLOWFAILS \- allow RCPT TO command to fail for some recipients
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_MAIL_RCPT_ALLOWFAILS,
long allow);
.SH DESCRIPTION
If \fIallow\fP is set to 1L, allow RCPT TO command to fail for some recipients.
When sending data to multiple recipients, by default curl aborts the SMTP
conversation if either one of the recipients causes the RCPT TO command to
return an error.
The default behavior can be changed by setting \fIallow\fP to 1L which makes
libcurl ignore errors for individual recipients and proceed with the remaining
accepted recipients.
If all recipients trigger RCPT TO failures and this flag is specified, curl
aborts the SMTP conversation and returns the error received from to the last
RCPT TO command.
.SH DEFAULT
0
.SH PROTOCOLS
SMTP
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
struct curl_slist *list;
/* Adding one valid and one invalid email address */
list = curl_slist_append(NULL, "person@example.com");
list = curl_slist_append(list, "invalidemailaddress");
curl_easy_setopt(curl, CURLOPT_URL, "smtp://example.com/");
curl_easy_setopt(curl, CURLOPT_MAIL_RCPT_ALLOWFAILS, 1L);
ret = curl_easy_perform(curl);
curl_slist_free_all(list);
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
This option was called CURLOPT_MAIL_RCPT_ALLLOWFAILS before 8.2.0
Added in 7.69.0.
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR CURLOPT_MAIL_FROM (3),
.BR CURLOPT_MAIL_RCPT (3)
man/man3/CURLINFO_CONTENT_LENGTH_DOWNLOAD.3 0000644 00000004564 14751172372 0013226 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLINFO_CONTENT_LENGTH_DOWNLOAD 3 "September 26, 2023" "libcurl 8.4.0" "libcurl"
.SH NAME
CURLINFO_CONTENT_LENGTH_DOWNLOAD \- get content-length of download
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_getinfo(CURL *handle, CURLINFO_CONTENT_LENGTH_DOWNLOAD,
double *content_length);
.fi
.SH DESCRIPTION
Pass a pointer to a double to receive the content-length of the download. This
is the value read from the Content-Length: field. Since 7.19.4, this returns
-1 if the size is not known.
\fICURLINFO_CONTENT_LENGTH_DOWNLOAD_T(3)\fP is a newer replacement that returns a more
sensible variable type.
.SH PROTOCOLS
HTTP(S)
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
/* Perform the request */
res = curl_easy_perform(curl);
if(!res) {
/* check the size */
double cl;
res = curl_easy_getinfo(curl, CURLINFO_CONTENT_LENGTH_DOWNLOAD, &cl);
if(!res) {
printf("Size: %.0f\\n", cl);
}
}
}
.fi
.SH AVAILABILITY
Added in 7.6.1. Deprecated since 7.55.0.
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR curl_easy_getinfo (3),
.BR curl_easy_setopt (3),
.BR CURLINFO_CONTENT_LENGTH_UPLOAD (3)
man/man3/CURLOPT_DEBUGFUNCTION.3 0000644 00000013533 14751172372 0011463 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_DEBUGFUNCTION 3 "October 05, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_DEBUGFUNCTION \- debug callback
.SH SYNOPSIS
.nf
#include <curl/curl.h>
typedef enum {
CURLINFO_TEXT = 0,
CURLINFO_HEADER_IN, /* 1 */
CURLINFO_HEADER_OUT, /* 2 */
CURLINFO_DATA_IN, /* 3 */
CURLINFO_DATA_OUT, /* 4 */
CURLINFO_SSL_DATA_IN, /* 5 */
CURLINFO_SSL_DATA_OUT, /* 6 */
CURLINFO_END
} curl_infotype;
int debug_callback(CURL *handle,
curl_infotype type,
char *data,
size_t size,
void *clientp);
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_DEBUGFUNCTION,
debug_callback);
.SH DESCRIPTION
Pass a pointer to your callback function, which should match the prototype
shown above.
\fICURLOPT_DEBUGFUNCTION(3)\fP replaces the standard debug function used when
\fICURLOPT_VERBOSE(3)\fP is in effect. This callback receives debug
information, as specified in the \fItype\fP argument. This function must
return 0. The \fIdata\fP pointed to by the char * passed to this function is
not null-terminated, but is exactly of the \fIsize\fP as told by the
\fIsize\fP argument.
The \fIclientp\fP argument is the pointer set with \fICURLOPT_DEBUGDATA(3)\fP.
Available \fBcurl_infotype\fP values:
.RS
.IP CURLINFO_TEXT
The data is informational text.
.IP CURLINFO_HEADER_IN
The data is header (or header-like) data received from the peer.
.IP CURLINFO_HEADER_OUT
The data is header (or header-like) data sent to the peer.
.IP CURLINFO_DATA_IN
The data is the unprocessed protocol data received from the peer. Even if the
data is encoded or compressed, it is not not provided decoded nor decompressed
to this callback. If you need the data in decoded and decompressed form, use
\fICURLOPT_WRITEFUNCTION(3)\fP.
.IP CURLINFO_DATA_OUT
The data is protocol data sent to the peer.
.IP CURLINFO_SSL_DATA_OUT
The data is SSL/TLS (binary) data sent to the peer.
.IP CURLINFO_SSL_DATA_IN
The data is SSL/TLS (binary) data received from the peer.
.RE
WARNING: This callback may be called with the curl \fIhandle\fP set to an
internal handle. (Added in 8.4.0)
If you need to distinguish your curl \fIhandle\fP from internal handles then
set \fICURLOPT_PRIVATE(3)\fP on your handle.
.SH DEFAULT
NULL
.SH PROTOCOLS
All
.SH EXAMPLE
.nf
static
void dump(const char *text,
FILE *stream, unsigned char *ptr, size_t size)
{
size_t i;
size_t c;
unsigned int width=0x10;
fprintf(stream, "%s, %10.10ld bytes (0x%8.8lx)\\n",
text, (long)size, (long)size);
for(i=0; i<size; i+= width) {
fprintf(stream, "%4.4lx: ", (long)i);
/* show hex to the left */
for(c = 0; c < width; c++) {
if(i+c < size)
fprintf(stream, "%02x ", ptr[i+c]);
else
fputs(" ", stream);
}
/* show data on the right */
for(c = 0; (c < width) && (i+c < size); c++) {
char x = (ptr[i+c] >= 0x20 && ptr[i+c] < 0x80) ? ptr[i+c] : '.';
fputc(x, stream);
}
fputc('\\n', stream); /* newline */
}
}
static
int my_trace(CURL *handle, curl_infotype type,
char *data, size_t size,
void *clientp)
{
const char *text;
(void)handle; /* prevent compiler warning */
(void)clientp;
switch (type) {
case CURLINFO_TEXT:
fputs("== Info: ", stderr);
fwrite(data, size, 1, stderr);
default: /* in case a new one is introduced to shock us */
return 0;
case CURLINFO_HEADER_OUT:
text = "=> Send header";
break;
case CURLINFO_DATA_OUT:
text = "=> Send data";
break;
case CURLINFO_SSL_DATA_OUT:
text = "=> Send SSL data";
break;
case CURLINFO_HEADER_IN:
text = "<= Recv header";
break;
case CURLINFO_DATA_IN:
text = "<= Recv data";
break;
case CURLINFO_SSL_DATA_IN:
text = "<= Recv SSL data";
break;
}
dump(text, stderr, (unsigned char *)data, size);
return 0;
}
int main(void)
{
CURL *curl;
CURLcode res;
curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_DEBUGFUNCTION, my_trace);
/* the DEBUGFUNCTION has no effect until we enable VERBOSE */
curl_easy_setopt(curl, CURLOPT_VERBOSE, 1L);
/* example.com is redirected, so we tell libcurl to follow redirection */
curl_easy_setopt(curl, CURLOPT_FOLLOWLOCATION, 1L);
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/");
res = curl_easy_perform(curl);
/* Check for errors */
if(res != CURLE_OK)
fprintf(stderr, "curl_easy_perform() failed: %s\\n",
curl_easy_strerror(res));
/* always cleanup */
curl_easy_cleanup(curl);
}
return 0;
}
.fi
.SH AVAILABILITY
Always
.SH RETURN VALUE
Returns CURLE_OK
.SH "SEE ALSO"
.BR curl_global_trace (3),
.BR CURLINFO_CONN_ID (3),
.BR CURLINFO_XFER_ID (3),
.BR CURLOPT_DEBUGDATA (3),
.BR CURLOPT_VERBOSE (3)
man/man3/CURLOPT_SSLKEY_BLOB.3 0000644 00000005555 14751172372 0011304 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_SSLKEY_BLOB 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_SSLKEY_BLOB \- private key for client cert from memory blob
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_SSLKEY_BLOB,
struct curl_blob *blob);
.fi
.SH DESCRIPTION
Pass a pointer to a curl_blob structure, which contains information (pointer
and size) for a private key. Compatible with OpenSSL. The format (like "PEM")
must be specified with \fICURLOPT_SSLKEYTYPE(3)\fP.
If the blob is initialized with the flags member of struct curl_blob set to
CURL_BLOB_COPY, the application does not have to keep the buffer around after
setting this.
This option is an alternative to \fICURLOPT_SSLKEY(3)\fP which instead expects
a file name as input.
.SH DEFAULT
NULL
.SH PROTOCOLS
All TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc.
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
struct curl_blob blob;
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/");
blob.data = certificateData;
blob.len = filesize;
blob.flags = CURL_BLOB_COPY;
curl_easy_setopt(curl, CURLOPT_SSLCERT_BLOB, &blob);
curl_easy_setopt(curl, CURLOPT_SSLCERTTYPE, "PEM");
blob.data = privateKeyData;
blob.len = privateKeySize;
curl_easy_setopt(curl, CURLOPT_SSLKEY_BLOB, &blob);
curl_easy_setopt(curl, CURLOPT_KEYPASSWD, "s3cret");
curl_easy_setopt(curl, CURLOPT_SSLKEYTYPE, "PEM");
ret = curl_easy_perform(curl);
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Added in 7.71.0. This option is supported by the OpenSSL backends.
.SH RETURN VALUE
Returns CURLE_OK if TLS enabled, CURLE_UNKNOWN_OPTION if not, or
CURLE_OUT_OF_MEMORY if there was insufficient heap space.
.SH "SEE ALSO"
.BR CURLOPT_SSLKEYTYPE (3),
.BR CURLOPT_SSLKEY (3)
man/man3/CURLOPT_SSL_ENABLE_ALPN.3 0000644 00000004101 14751172372 0011737 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_SSL_ENABLE_ALPN 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_SSL_ENABLE_ALPN \- Application Layer Protocol Negotiation
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_SSL_ENABLE_ALPN, long npn);
.fi
.SH DESCRIPTION
Pass a long as parameter, 0 or 1 where 1 is for enable and 0 for disable. This
option enables/disables ALPN in the SSL handshake (if the SSL backend libcurl
is built to use supports it), which can be used to negotiate http2.
.SH DEFAULT
1, enabled
.SH PROTOCOLS
HTTP
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/");
curl_easy_setopt(curl, CURLOPT_SSL_ENABLE_ALPN, 0L);
ret = curl_easy_perform(curl);
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Added in 7.36.0
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR CURLOPT_SSL_ENABLE_NPN (3),
.BR CURLOPT_SSL_OPTIONS (3)
man/man3/curl_formfree.3 0000644 00000004766 14751172372 0011121 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.TH curl_formfree 3 "September 26, 2023" "libcurl 8.4.0" "libcurl"
.SH NAME
curl_formfree - free a previously build multipart form post chain
.SH SYNOPSIS
.nf
#include <curl/curl.h>
void curl_formfree(struct curl_httppost *form);
.fi
.SH DESCRIPTION
This function is deprecated. Do not use. See \fIcurl_mime_init(3)\fP instead!
curl_formfree() is used to clean up data previously built/appended with
\fIcurl_formadd(3)\fP. This must be called when the data has been used, which
typically means after \fIcurl_easy_perform(3)\fP has been called.
The pointer to free is the same pointer you passed to the
\fICURLOPT_HTTPPOST(3)\fP option, which is the \fIfirstitem\fP pointer from
the \fIcurl_formadd(3)\fP invoke(s).
\fBform\fP is the pointer as returned from a previous call to
\fIcurl_formadd(3)\fP and may be NULL.
Passing in a NULL pointer in \fIform\fP makes this function return immediately
with no action.
.SH EXAMPLE
.nf
/* Fill in a file upload field */
curl_formadd(&formpost,
&lastptr,
CURLFORM_COPYNAME, "file",
CURLFORM_FILE, "nice-image.jpg",
CURLFORM_END);
curl_easy_setopt(curl, CURLOPT_HTTPPOST, formpost);
curl_easy_perform(curl);
/* then cleanup the formpost chain */
curl_formfree(formpost);
.fi
.SH AVAILABILITY
Deprecated in 7.56.0.
.SH RETURN VALUE
None
.SH "SEE ALSO"
.BR curl_formadd (3),
.BR curl_mime_init (3),
.BR curl_mime_free (3)
man/man3/CURLOPT_WRITEDATA.3 0000644 00000005230 14751172372 0011006 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_WRITEDATA 3 "September 27, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_WRITEDATA \- pointer passed to the write callback
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_WRITEDATA, void *pointer);
.fi
.SH DESCRIPTION
A data \fIpointer\fP to pass to the write callback. If you use the
\fICURLOPT_WRITEFUNCTION(3)\fP option, this is the pointer you get in that
callback's fourth and last argument. If you do not use a write callback, you
must make \fIpointer\fP a 'FILE *' (cast to 'void *') as libcurl passes this
to \fIfwrite(3)\fP when writing data.
The internal \fICURLOPT_WRITEFUNCTION(3)\fP writes the data to the FILE *
given with this option, or to stdout if this option has not been set.
If you are using libcurl as a Windows DLL, you \fBMUST\fP use a
\fICURLOPT_WRITEFUNCTION(3)\fP if you set this option or you might experience
crashes.
.SH DEFAULT
By default, this is a FILE * to stdout.
.SH PROTOCOLS
Used for all protocols.
.SH EXAMPLE
A common technique is to use the write callback to store the incoming data
into a dynamically growing allocated buffer, and then this
\fICURLOPT_WRITEDATA(3)\fP is used to point to a struct or the buffer to store
data in. Like in the getinmemory example:
https://curl.se/libcurl/c/getinmemory.html
.SH AVAILABILITY
Available in all libcurl versions. This option was formerly known as
CURLOPT_FILE, the name \fICURLOPT_WRITEDATA(3)\fP was added in 7.9.7.
.SH RETURN VALUE
This returns CURLE_OK.
.SH "SEE ALSO"
.BR CURLOPT_WRITEFUNCTION (3),
.BR CURLOPT_HEADERDATA (3),
.BR CURLOPT_READDATA (3)
man/man3/CURLOPT_PROXY_TLSAUTH_TYPE.3 0000644 00000005446 14751172372 0012461 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_PROXY_TLSAUTH_TYPE 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_PROXY_TLSAUTH_TYPE \- HTTPS proxy TLS authentication methods
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_PROXY_TLSAUTH_TYPE,
char *type);
.fi
.SH DESCRIPTION
Pass a pointer to a null-terminated string as parameter. The string should be
the method of the TLS authentication used for the HTTPS connection. Supported
method is "SRP".
.IP SRP
TLS-SRP authentication. Secure Remote Password authentication for TLS is
defined in RFC 5054 and provides mutual authentication if both sides have a
shared secret. To use TLS-SRP, you must also set the
\fICURLOPT_PROXY_TLSAUTH_USERNAME(3)\fP and
\fICURLOPT_PROXY_TLSAUTH_PASSWORD(3)\fP options.
The application does not have to keep the string around after setting this
option.
.SH DEFAULT
blank
.SH PROTOCOLS
All
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/");
curl_easy_setopt(curl, CURLOPT_PROXY, "https://proxy");
curl_easy_setopt(curl, CURLOPT_PROXY_TLSAUTH_TYPE, "SRP");
curl_easy_setopt(curl, CURLOPT_PROXY_TLSAUTH_USERNAME, "user");
curl_easy_setopt(curl, CURLOPT_PROXY_TLSAUTH_PASSWORD, "secret");
ret = curl_easy_perform(curl);
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Added in 7.52.0
You need to build libcurl with GnuTLS or OpenSSL with TLS-SRP support for this
to work.
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR CURLOPT_PROXY_TLSAUTH_PASSWORD (3),
.BR CURLOPT_PROXY_TLSAUTH_USERNAME (3),
.BR CURLOPT_TLSAUTH_PASSWORD (3),
.BR CURLOPT_TLSAUTH_USERNAME (3)
man/man3/CURLOPT_SOCKOPTFUNCTION.3 0000644 00000011650 14751172372 0011755 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_SOCKOPTFUNCTION 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_SOCKOPTFUNCTION \- callback for setting socket options
.SH SYNOPSIS
.nf
#include <curl/curl.h>
typedef enum {
CURLSOCKTYPE_IPCXN, /* socket created for a specific IP connection */
CURLSOCKTYPE_ACCEPT, /* socket created by accept() call */
CURLSOCKTYPE_LAST /* never use */
} curlsocktype;
#define CURL_SOCKOPT_OK 0
#define CURL_SOCKOPT_ERROR 1 /* causes libcurl to abort and return
CURLE_ABORTED_BY_CALLBACK */
#define CURL_SOCKOPT_ALREADY_CONNECTED 2
int sockopt_callback(void *clientp,
curl_socket_t curlfd,
curlsocktype purpose);
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_SOCKOPTFUNCTION, sockopt_callback);
.SH DESCRIPTION
Pass a pointer to your callback function, which should match the prototype
shown above.
When set, this callback function gets called by libcurl when the socket has
been created, but before the connect call to allow applications to change
specific socket options. The callback's \fIpurpose\fP argument identifies the
exact purpose for this particular socket:
\fICURLSOCKTYPE_IPCXN\fP for actively created connections or since 7.28.0
\fICURLSOCKTYPE_ACCEPT\fP for FTP when the connection was setup with PORT/EPSV
(in earlier versions these sockets were not passed to this callback).
Future versions of libcurl may support more purposes. libcurl passes the newly
created socket descriptor to the callback in the \fIcurlfd\fP parameter so
additional setsockopt() calls can be done at the user's discretion.
The \fIclientp\fP pointer contains whatever user-defined value set using the
\fICURLOPT_SOCKOPTDATA(3)\fP function.
Return \fICURL_SOCKOPT_OK\fP from the callback on success. Return
\fICURL_SOCKOPT_ERROR\fP from the callback function to signal an unrecoverable
error to the library and it closes the socket and returns
\fICURLE_COULDNT_CONNECT\fP. Alternatively, the callback function can return
\fICURL_SOCKOPT_ALREADY_CONNECTED\fP, to tell libcurl that the socket is
already connected and then libcurl does no attempt to connect. This allows an
application to pass in an already connected socket with
\fICURLOPT_OPENSOCKETFUNCTION(3)\fP and then have this function make libcurl
not attempt to connect (again).
.SH DEFAULT
By default, this callback is NULL and unused.
.SH PROTOCOLS
All
.SH EXAMPLE
.nf
/* make libcurl use the already established socket 'sockfd' */
static curl_socket_t opensocket(void *clientp,
curlsocktype purpose,
struct curl_sockaddr *address)
{
curl_socket_t sockfd;
sockfd = *(curl_socket_t *)clientp;
/* the actual externally set socket is passed in via the OPENSOCKETDATA
option */
return sockfd;
}
static int sockopt_callback(void *clientp, curl_socket_t curlfd,
curlsocktype purpose)
{
/* This return code was added in libcurl 7.21.5 */
return CURL_SOCKOPT_ALREADY_CONNECTED;
}
curl = curl_easy_init();
if(curl) {
/* libcurl thinks that you connect to the host
* and port that you specify in the URL option. */
curl_easy_setopt(curl, CURLOPT_URL, "http://99.99.99.99:9999");
/* call this function to get a socket */
curl_easy_setopt(curl, CURLOPT_OPENSOCKETFUNCTION, opensocket);
curl_easy_setopt(curl, CURLOPT_OPENSOCKETDATA, &sockfd);
/* call this function to set options for the socket */
curl_easy_setopt(curl, CURLOPT_SOCKOPTFUNCTION, sockopt_callback);
res = curl_easy_perform(curl);
curl_easy_cleanup(curl);
.fi
.SH AVAILABILITY
Added in 7.16.0. The \fICURL_SOCKOPT_ALREADY_CONNECTED\fP return code was
added in 7.21.5.
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR CURLOPT_OPENSOCKETFUNCTION (3),
.BR CURLOPT_SEEKFUNCTION (3),
.BR CURLOPT_SOCKOPTDATA (3)
man/man3/CURLINFO_REQUEST_SIZE.3 0000644 00000004274 14751172372 0011544 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLINFO_REQUEST_SIZE 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLINFO_REQUEST_SIZE \- get size of sent request
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_getinfo(CURL *handle, CURLINFO_REQUEST_SIZE, long *sizep);
.fi
.SH DESCRIPTION
Pass a pointer to a long to receive the total size of the issued
requests. This is so far only for HTTP requests. Note that this may be more
than one request if \fICURLOPT_FOLLOWLOCATION(3)\fP is enabled.
.SH PROTOCOLS
All
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
CURLcode res;
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
res = curl_easy_perform(curl);
if(res == CURLE_OK) {
long req;
res = curl_easy_getinfo(curl, CURLINFO_REQUEST_SIZE, &req);
if(!res)
printf("Request size: %ld bytes\\n", req);
}
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Added in 7.4.1
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR curl_easy_getinfo (3),
.BR curl_easy_setopt (3),
.BR CURLINFO_HEADER_SIZE (3),
.BR CURLINFO_SIZE_DOWNLOAD_T (3)
man/man3/CURLOPT_CERTINFO.3 0000644 00000005614 14751172372 0010701 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_CERTINFO 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_CERTINFO \- request SSL certificate information
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_CERTINFO, long certinfo);
.fi
.SH DESCRIPTION
Pass a long set to 1 to enable libcurl's certificate chain info gatherer. With
this enabled, libcurl extracts lots of information and data about the
certificates in the certificate chain used in the SSL connection. This data
may then be retrieved after a transfer using \fIcurl_easy_getinfo(3)\fP and
its option \fICURLINFO_CERTINFO(3)\fP.
.SH DEFAULT
0
.SH PROTOCOLS
All TLS-based
.SH EXAMPLE
.nf
curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://www.example.com/");
/* connect to any HTTPS site, trusted or not */
curl_easy_setopt(curl, CURLOPT_SSL_VERIFYPEER, 0L);
curl_easy_setopt(curl, CURLOPT_SSL_VERIFYHOST, 0L);
curl_easy_setopt(curl, CURLOPT_CERTINFO, 1L);
res = curl_easy_perform(curl);
if (!res) {
struct curl_certinfo *ci;
res = curl_easy_getinfo(curl, CURLINFO_CERTINFO, &ci);
if (!res) {
printf("%d certs!\\n", ci->num_of_certs);
for(i = 0; i < ci->num_of_certs; i++) {
struct curl_slist *slist;
for(slist = ci->certinfo[i]; slist; slist = slist->next)
printf("%s\\n", slist->data);
}
}
}
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
This option is supported by the OpenSSL, GnuTLS, Schannel and Secure
Transport backends. Schannel support added in 7.50.0. Secure Transport support
added in 7.79.0.
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR CURLINFO_CAINFO (3),
.BR CURLINFO_CAPATH (3),
.BR CURLINFO_CERTINFO (3),
.BR CURLOPT_CAINFO (3),
.BR CURLOPT_SSL_VERIFYPEER (3)
man/man3/CURLOPT_FTP_ALTERNATIVE_TO_USER.3 0000644 00000004636 14751172372 0013222 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_FTP_ALTERNATIVE_TO_USER 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_FTP_ALTERNATIVE_TO_USER \- command to use instead of USER with FTP
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_FTP_ALTERNATIVE_TO_USER,
char *cmd);
.SH DESCRIPTION
Pass a char * as parameter, pointing to a string which is used to authenticate
if the usual FTP "USER user" and "PASS password" negotiation fails. This is
currently only known to be required when connecting to Tumbleweed's Secure
Transport FTPS server using client certificates for authentication.
The application does not have to keep the string around after setting this
option.
.SH DEFAULT
NULL
.SH PROTOCOLS
FTP
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "ftp://example.com/foo.bin");
curl_easy_setopt(curl, CURLOPT_FTP_ALTERNATIVE_TO_USER, "two users");
ret = curl_easy_perform(curl);
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Added in 7.15.5
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, CURLE_UNKNOWN_OPTION if not, or
CURLE_OUT_OF_MEMORY if there was insufficient heap space.
.SH "SEE ALSO"
.BR CURLOPT_FTP_ACCOUNT (3),
.BR CURLOPT_FTP_SKIP_PASV_IP (3),
.BR CURLOPT_SERVER_RESPONSE_TIMEOUT (3),
.BR CURLOPT_USERNAME (3)
man/man3/CURLOPT_TCP_KEEPIDLE.3 0000644 00000004456 14751172372 0011363 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_TCP_KEEPIDLE 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_TCP_KEEPIDLE \- TCP keep-alive idle time wait
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_TCP_KEEPIDLE, long delay);
.fi
.SH DESCRIPTION
Pass a long. Sets the \fIdelay\fP, in seconds, to wait while the connection is
idle before sending keepalive probes. Not all operating systems support this
option.
The maximum value this accepts is 2147483648. Any larger value is capped to
this amount.
.SH DEFAULT
60
.SH PROTOCOLS
All
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
/* enable TCP keep-alive for this transfer */
curl_easy_setopt(curl, CURLOPT_TCP_KEEPALIVE, 1L);
/* set keep-alive idle time to 120 seconds */
curl_easy_setopt(curl, CURLOPT_TCP_KEEPIDLE, 120L);
/* interval time between keep-alive probes: 60 seconds */
curl_easy_setopt(curl, CURLOPT_TCP_KEEPINTVL, 60L);
curl_easy_perform(curl);
}
.fi
.SH AVAILABILITY
Added in 7.25.0
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR CURLOPT_TCP_KEEPALIVE (3),
.BR CURLOPT_TCP_KEEPINTVL (3)
man/man3/CURLOPT_CONV_FROM_UTF8_FUNCTION.3 0000644 00000007331 14751172372 0013171 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_CONV_FROM_UTF8_FUNCTION 3 "September 27, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_CONV_FROM_UTF8_FUNCTION \- convert data from UTF8 to host encoding
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode conv_callback(char *ptr, size_t length);
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_CONV_FROM_UTF8_FUNCTION,
conv_callback);
.SH DESCRIPTION
Pass a pointer to your callback function, which should match the prototype
shown above.
Applies to non-ASCII platforms. \fIcurl_version_info(3)\fP returns the
CURL_VERSION_CONV feature bit set if this option is provided.
The data to be converted is in a buffer pointed to by the \fIptr\fP parameter.
The amount of data to convert is indicated by the \fIlength\fP parameter. The
converted data overlays the input data in the buffer pointed to by the ptr
parameter. \fICURLE_OK\fP must be returned upon successful conversion. A
CURLcode return value defined by curl.h, such as \fICURLE_CONV_FAILED\fP,
should be returned if an error was encountered.
\fICURLOPT_CONV_FROM_UTF8_FUNCTION(3)\fP converts to host encoding from UTF8
encoding. It is required only for SSL processing.
If you set a callback pointer to NULL, or do not set it at all, the built-in
libcurl iconv functions are used. If HAVE_ICONV was not defined when libcurl
was built, and no callback has been established, the conversion returns the
CURLE_CONV_REQD error code.
If HAVE_ICONV is defined, CURL_ICONV_CODESET_OF_HOST must also be defined.
For example:
\&#define CURL_ICONV_CODESET_OF_HOST "IBM-1047"
The iconv code in libcurl defaults the network and UTF8 codeset names as
follows:
\&#define CURL_ICONV_CODESET_OF_NETWORK "ISO8859-1"
\&#define CURL_ICONV_CODESET_FOR_UTF8 "UTF-8"
You need to override these definitions if they are different on your system.
.SH DEFAULT
NULL
.SH PROTOCOLS
TLS-based protocols.
.SH EXAMPLE
.nf
static CURLcode my_conv_from_utf8_to_ebcdic(char *buffer, size_t length)
{
char *tempptrin, *tempptrout;
size_t bytes = length;
int rc;
tempptrin = tempptrout = buffer;
rc = platform_u2e(&tempptrin, &bytes, &tempptrout, &bytes);
if(rc == PLATFORM_CONV_OK) {
return CURLE_OK;
}
else {
return CURLE_CONV_FAILED;
}
}
curl_easy_setopt(curl, CURLOPT_CONV_FROM_UTF8_FUNCTION,
my_conv_from_utf8_to_ebcdic);
.fi
.SH AVAILABILITY
Not available and deprecated since 7.82.0.
Available only if \fBCURL_DOES_CONVERSIONS\fP was defined when libcurl was
built.
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR CURLOPT_CONV_FROM_NETWORK_FUNCTION (3),
.BR CURLOPT_CONV_TO_NETWORK_FUNCTION (3)
man/man3/CURLOPT_SSL_CTX_DATA.3 0000644 00000010061 14751172372 0011430 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_SSL_CTX_DATA 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_SSL_CTX_DATA \- pointer passed to SSL context callback
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_SSL_CTX_DATA, void *pointer);
.fi
.SH DESCRIPTION
Data \fIpointer\fP to pass to the ssl context callback set by the option
\fICURLOPT_SSL_CTX_FUNCTION(3)\fP, this is the pointer you get as third
parameter.
.SH DEFAULT
NULL
.SH PROTOCOLS
All TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc.
.SH EXAMPLE
.nf
/* OpenSSL specific */
#include <openssl/ssl.h>
#include <curl/curl.h>
#include <stdio.h>
static CURLcode sslctx_function(CURL *curl, void *sslctx, void *parm)
{
X509_STORE *store;
X509 *cert = NULL;
BIO *bio;
char *mypem = parm;
/* get a BIO */
bio = BIO_new_mem_buf(mypem, -1);
/* use it to read the PEM formatted certificate from memory into an
* X509 structure that SSL can use
*/
PEM_read_bio_X509(bio, &cert, 0, NULL);
if(cert == NULL)
printf("PEM_read_bio_X509 failed...\\n");
/* get a pointer to the X509 certificate store (which may be empty) */
store = SSL_CTX_get_cert_store((SSL_CTX *)sslctx);
/* add our certificate to this store */
if(X509_STORE_add_cert(store, cert) == 0)
printf("error adding certificate\\n");
/* decrease reference counts */
X509_free(cert);
BIO_free(bio);
/* all set to go */
return CURLE_OK;
}
int main(void)
{
CURL * ch;
CURLcode rv;
char *mypem = /* example CA cert PEM - shortened */
"-----BEGIN CERTIFICATE-----\\n"
"MIIHPTCCBSWgAwIBAgIBADANBgkqhkiG9w0BAQQFADB5MRAwDgYDVQQKEwdSb290\\n"
"IENBMR4wHAYDVQQLExVodHRwOi8vd3d3LmNhY2VydC5vcmcxIjAgBgNVBAMTGUNB\\n"
"IENlcnQgU2lnbmluZyBBdXRob3JpdHkxITAfBgkqhkiG9w0BCQEWEnN1cHBvcnRA\\n"
"Y2FjZXJ0Lm9yZzAeFw0wMzAzMzAxMjI5NDlaFw0zMzAzMjkxMjI5NDlaMHkxEDAO\\n"
"GCSNe9FINSkYQKyTYOGWhlC0elnYjyELn8+CkcY7v2vcB5G5l1YjqrZslMZIBjzk\\n"
"zk6q5PYvCdxTby78dOs6Y5nCpqyJvKeyRKANihDjbPIky/qbn3BHLt4Ui9SyIAmW\\n"
"omTxJBzcoTWcFbLUvFUufQb1nA5V9FrWk9p2rSVzTMVD\\n"
"-----END CERTIFICATE-----\\n";
curl_global_init(CURL_GLOBAL_ALL);
ch = curl_easy_init();
curl_easy_setopt(ch, CURLOPT_SSLCERTTYPE, "PEM");
curl_easy_setopt(ch, CURLOPT_SSL_VERIFYPEER, 1L);
curl_easy_setopt(ch, CURLOPT_URL, "https://www.example.com/");
curl_easy_setopt(ch, CURLOPT_SSL_CTX_FUNCTION, *sslctx_function);
curl_easy_setopt(ch, CURLOPT_SSL_CTX_DATA, mypem);
rv = curl_easy_perform(ch);
if(!rv)
printf("*** transfer succeeded ***\\n");
else
printf("*** transfer failed ***\\n");
curl_easy_cleanup(ch);
curl_global_cleanup();
return rv;
}
.fi
.SH AVAILABILITY
Added in 7.11.0 for OpenSSL, in 7.42.0 for wolfSSL, in 7.54.0 for mbedTLS,
in 7.83.0 in BearSSL. Other SSL backends are not supported.
.SH RETURN VALUE
CURLE_OK if supported; or an error such as:
CURLE_NOT_BUILT_IN - Not supported by the SSL backend
CURLE_UNKNOWN_OPTION
.SH "SEE ALSO"
.BR CURLOPT_SSL_CTX_FUNCTION (3),
.BR CURLOPT_SSLVERSION (3)
man/man3/CURLOPT_RESOLVE.3 0000644 00000007775 14751172372 0010621 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_RESOLVE 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_RESOLVE \- provide custom host name to IP address resolves
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_RESOLVE,
struct curl_slist *hosts);
.SH DESCRIPTION
Pass a pointer to a linked list of strings with host name resolve information
to use for requests with this handle. The linked list should be a fully valid
list of \fBstruct curl_slist\fP structs properly filled in. Use
\fIcurl_slist_append(3)\fP to create the list and \fIcurl_slist_free_all(3)\fP
to clean up an entire list.
Each resolve rule to add should be written using the format
.nf
[+]HOST:PORT:ADDRESS[,ADDRESS]
.fi
HOST is the name libcurl wants to resolve, PORT is the port number of the
service where libcurl wants to connect to the HOST and ADDRESS is one or more
numerical IP addresses. If you specify multiple IP addresses they need to be
separated by comma. If libcurl is built to support IPv6, each of the ADDRESS
entries can of course be either IPv4 or IPv6 style addressing.
This option effectively populates the DNS cache with entries for the host+port
pair so redirects and everything that operations against the HOST+PORT instead
use your provided ADDRESS.
The optional leading "+" specifies that the new entry should time-out. Entries
added without the leading plus character never times out whereas entries added
with "+HOST:..." times out just like ordinary DNS cache entries.
If the DNS cache already has an entry for the given host+port pair, the new
entry overrides the former one.
An ADDRESS provided by this option is only used if not restricted by the
setting of \fICURLOPT_IPRESOLVE(3)\fP to a different IP version.
To remove names from the DNS cache again, to stop providing these fake
resolves, include a string in the linked list that uses the format
.nf
-HOST:PORT
.fi
The entry to remove must be prefixed with a dash, and the host name and port
number must exactly match what was added previously.
.SH DEFAULT
NULL
.SH PROTOCOLS
All
.SH EXAMPLE
.nf
CURL *curl;
struct curl_slist *host = NULL;
host = curl_slist_append(NULL, "example.com:443:127.0.0.1");
curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_RESOLVE, host);
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
curl_easy_perform(curl);
/* always cleanup */
curl_easy_cleanup(curl);
}
curl_slist_free_all(host);
.fi
.SH AVAILABILITY
Added in 7.21.3. Removal support added in 7.42.0.
Support for providing the ADDRESS within [brackets] was added in 7.57.0.
Support for providing multiple IP addresses per entry was added in 7.59.0.
Support for adding non-permanent entries by using the "+" prefix was added in
7.75.0.
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR CURLOPT_CONNECT_TO (3),
.BR CURLOPT_DNS_CACHE_TIMEOUT (3),
.BR CURLOPT_IPRESOLVE (3)
man/man3/libcurl-security.3 0000644 00000055027 14751172372 0011564 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH libcurl-security 3 "August 21, 2023" "libcurl 8.4.0" "libcurl"
.SH NAME
libcurl-security \- security considerations when using libcurl
.SH "Security"
The libcurl project takes security seriously. The library is written with
caution and precautions are taken to mitigate many kinds of risks encountered
while operating with potentially malicious servers on the Internet. It is a
powerful library, however, which allows application writers to make trade-offs
between ease of writing and exposure to potential risky operations. If used
the right way, you can use libcurl to transfer data pretty safely.
Many applications are used in closed networks where users and servers can
(possibly) be trusted, but many others are used on arbitrary servers and are
fed input from potentially untrusted users. Following is a discussion about
some risks in the ways in which applications commonly use libcurl and
potential mitigations of those risks. It is not comprehensive, but shows
classes of attacks that robust applications should consider. The Common
Weakness Enumeration project at https://cwe.mitre.org/ is a good reference for
many of these and similar types of weaknesses of which application writers
should be aware.
.SH "Command Lines"
If you use a command line tool (such as curl) that uses libcurl, and you give
options to the tool on the command line those options can get read by other
users of your system when they use \fIps\fP or other tools to list currently
running processes.
To avoid these problems, never feed sensitive things to programs using command
line options. Write them to a protected file and use the \-K option to avoid
this.
.SH ".netrc"
\&.netrc is a pretty handy file/feature that allows you to login quickly and
automatically to frequently visited sites. The file contains passwords in
clear text and is a real security risk. In some cases, your .netrc is also
stored in a home directory that is NFS mounted or used on another network
based file system, so the clear text password flies through your network every
time anyone reads that file.
For applications that enable .netrc use, a user who manage to set the right
URL might then be possible to pass on passwords.
To avoid these problems, do not use .netrc files and never store passwords in
plain text anywhere.
.SH "Clear Text Passwords"
Many of the protocols libcurl supports send name and password unencrypted as
clear text (HTTP Basic authentication, FTP, TELNET etc). It is easy for anyone
on your network or a network nearby yours to just fire up a network analyzer
tool and eavesdrop on your passwords. do not let the fact that HTTP Basic uses
base64 encoded passwords fool you. They may not look readable at a first
glance, but they are easily "deciphered" by anyone within seconds.
To avoid this problem, use an authentication mechanism or other protocol that
does not let snoopers see your password: Digest, CRAM-MD5, Kerberos, SPNEGO or
NTLM authentication. Or even better: use authenticated protocols that protect
the entire connection and everything sent over it.
.SH "Unauthenticated Connections"
Protocols that do not have any form of cryptographic authentication cannot
with any certainty know that they communicate with the right remote server.
If your application is using a fixed scheme or fixed host name, it is not safe
as long as the connection is unauthenticated. There can be a man-in-the-middle
or in fact the whole server might have been replaced by an evil actor.
Unauthenticated protocols are unsafe. The data that comes back to curl may
have been injected by an attacker. The data that curl sends might be modified
before it reaches the intended server. If it even reaches the intended server
at all.
Remedies:
.IP "Restrict operations to authenticated transfers"
Use authenticated protocols protected with HTTPS or SSH.
.IP "Make sure the server's certificate etc is verified"
Never ever switch off certificate verification.
.SH "Redirects"
The \fICURLOPT_FOLLOWLOCATION(3)\fP option automatically follows HTTP
redirects sent by a remote server. These redirects can refer to any kind of
URL, not just HTTP. libcurl restricts the protocols allowed to be used in
redirects for security reasons: only HTTP, HTTPS, FTP and FTPS are
enabled by default. Applications may opt to restrict that set further.
A redirect to a file: URL would cause the libcurl to read (or write) arbitrary
files from the local filesystem. If the application returns the data back to
the user (as would happen in some kinds of CGI scripts), an attacker could
leverage this to read otherwise forbidden data (e.g.
\fBfile://localhost/etc/passwd\fP).
If authentication credentials are stored in the ~/.netrc file, or Kerberos is
in use, any other URL type (not just file:) that requires authentication is
also at risk. A redirect such as ftp://some-internal-server/private-file would
then return data even when the server is password protected.
In the same way, if an unencrypted SSH private key has been configured for the
user running the libcurl application, SCP: or SFTP: URLs could access password
or private-key protected resources,
e.g. \fBsftp://user@some-internal-server/etc/passwd\fP
The \fICURLOPT_REDIR_PROTOCOLS(3)\fP and \fICURLOPT_NETRC(3)\fP options can be
used to mitigate against this kind of attack.
A redirect can also specify a location available only on the machine running
libcurl, including servers hidden behind a firewall from the attacker.
e.g. http://127.0.0.1/ or http://intranet/delete-stuff.cgi?delete=all or
tftp://bootp-server/pc-config-data
Applications can mitigate against this by disabling
\fICURLOPT_FOLLOWLOCATION(3)\fP and handling redirects itself, sanitizing URLs
as necessary. Alternately, an app could leave \fICURLOPT_FOLLOWLOCATION(3)\fP
enabled but set \fICURLOPT_REDIR_PROTOCOLS(3)\fP and install a
\fICURLOPT_OPENSOCKETFUNCTION(3)\fP or \fICURLOPT_PREREQFUNCTION(3)\fP callback
function in which addresses are sanitized before use.
.SH "CRLF in Headers"
For all options in libcurl which specify headers, including but not limited to
\fICURLOPT_HTTPHEADER(3)\fP, \fICURLOPT_PROXYHEADER(3)\fP,
\fICURLOPT_COOKIE(3)\fP, \fICURLOPT_USERAGENT(3)\fP, \fICURLOPT_REFERER(3)\fP
and \fICURLOPT_RANGE(3)\fP, libcurl sends the headers as-is and does not apply
any special sanitation or normalization to them.
If you allow untrusted user input into these options without sanitizing CRLF
sequences in them, someone malicious may be able to modify the request in a
way you did not intend such as injecting new headers.
.SH "Local Resources"
A user who can control the DNS server of a domain being passed in within a URL
can change the address of the host to a local, private address which a
server-side libcurl-using application could then use. e.g. the innocuous URL
\fBhttp://fuzzybunnies.example.com/\fP could actually resolve to the IP
address of a server behind a firewall, such as 127.0.0.1 or
10.1.2.3. Applications can mitigate against this by setting a
\fICURLOPT_OPENSOCKETFUNCTION(3)\fP or \fICURLOPT_PREREQFUNCTION(3)\fP and
checking the address before a connection.
All the malicious scenarios regarding redirected URLs apply just as well to
non-redirected URLs, if the user is allowed to specify an arbitrary URL that
could point to a private resource. For example, a web app providing a
translation service might happily translate \fBfile://localhost/etc/passwd\fP
and display the result. Applications can mitigate against this with the
\fICURLOPT_PROTOCOLS(3)\fP option as well as by similar mitigation techniques
for redirections.
A malicious FTP server could in response to the PASV command return an IP
address and port number for a server local to the app running libcurl but
behind a firewall. Applications can mitigate against this by using the
\fICURLOPT_FTP_SKIP_PASV_IP(3)\fP option or \fICURLOPT_FTPPORT(3)\fP.
Local servers sometimes assume local access comes from friends and trusted
users. An application that expects https://example.com/file_to_read that and
instead gets http://192.168.0.1/my_router_config might print a file that would
otherwise be protected by the firewall.
Allowing your application to connect to local hosts, be it the same machine
that runs the application or a machine on the same local network, might be
possible to exploit by an attacker who then perhaps can "port-scan" the
particular hosts - depending on how the application and servers acts.
.SH "IPv4 Addresses"
Some users might be tempted to filter access to local resources or similar
based on numerical IPv4 addresses used in URLs. This is a bad and error-prone
idea because of the many different ways a numerical IPv4 address can be
specified and libcurl accepts: one to four dot-separated fields using one of
or a mix of decimal, octal or hexadecimal encoding.
.SH "IPv6 Addresses"
libcurl handles IPv6 addresses transparently and just as easily as IPv4
addresses. That means that a sanitizing function that filters out addresses
like 127.0.0.1 is not sufficient - the equivalent IPv6 addresses \fB::1\fP,
\fB::\fP, \fB0:00::0:1\fP, \fB::127.0.0.1\fP and \fB::ffff:7f00:1\fP supplied
somehow by an attacker would all bypass a naive filter and could allow access
to undesired local resources. IPv6 also has special address blocks like
link-local and site-local that generally should not be accessed by a
server-side libcurl-using application. A poorly configured firewall installed
in a data center, organization or server may also be configured to limit IPv4
connections but leave IPv6 connections wide open. In some cases, setting
\fICURLOPT_IPRESOLVE(3)\fP to CURL_IPRESOLVE_V4 can be used to limit resolved
addresses to IPv4 only and bypass these issues.
.SH Uploads
When uploading, a redirect can cause a local (or remote) file to be
overwritten. Applications must not allow any unsanitized URL to be passed in
for uploads. Also, \fICURLOPT_FOLLOWLOCATION(3)\fP should not be used on
uploads. Instead, the applications should consider handling redirects itself,
sanitizing each URL first.
.SH Authentication
Use of \fICURLOPT_UNRESTRICTED_AUTH(3)\fP could cause authentication
information to be sent to an unknown second server. Applications can mitigate
against this by disabling \fICURLOPT_FOLLOWLOCATION(3)\fP and handling
redirects itself, sanitizing where necessary.
Use of the CURLAUTH_ANY option to \fICURLOPT_HTTPAUTH(3)\fP could result in
user name and password being sent in clear text to an HTTP server. Instead,
use CURLAUTH_ANYSAFE which ensures that the password is encrypted over the
network, or else fail the request.
Use of the CURLUSESSL_TRY option to \fICURLOPT_USE_SSL(3)\fP could result in
user name and password being sent in clear text to an FTP server. Instead,
use CURLUSESSL_CONTROL to ensure that an encrypted connection is used or else
fail the request.
.SH Cookies
If cookies are enabled and cached, then a user could craft a URL which
performs some malicious action to a site whose authentication is already
stored in a cookie. e.g. http://mail.example.com/delete-stuff.cgi?delete=all
Applications can mitigate against this by disabling cookies or clearing them
between requests.
.SH "Dangerous SCP URLs"
SCP URLs can contain raw commands within the scp: URL, which is a side effect
of how the SCP protocol is designed. e.g.
.nf
scp://user:pass@host/a;date >/tmp/test;
.fi
Applications must not allow unsanitized SCP: URLs to be passed in for
downloads.
.SH "file://"
By default curl and libcurl support file:// URLs. Such a URL is always an
access, or attempted access, to a local resource. If your application wants to
avoid that, keep control of what URLs to use and/or prevent curl/libcurl from
using the protocol.
By default, libcurl prohibits redirects to file:// URLs.
.SH "Warning: file:// on Windows"
The Windows operating system tries automatically, and without any way for
applications to disable it, to establish a connection to another host over the
network and access it (over SMB or other protocols), if only the correct file
path is accessed.
When first realizing this, the curl team tried to filter out such attempts in
order to protect applications for inadvertent probes of for example internal
networks etc. This resulted in CVE-2019-15601 and the associated security fix.
However, we have since been made aware of the fact that the previous fix was far
from adequate as there are several other ways to accomplish more or less the
same thing: accessing a remote host over the network instead of the local file
system.
The conclusion we have come to is that this is a weakness or feature in the
Windows operating system itself, that we as an application cannot safely
protect users against. It would just be a whack-a-mole race we do not want to
participate in. There are too many ways to do it and there is no knob we can
use to turn off the practice.
If you use curl or libcurl on Windows (any version), disable the use of the
FILE protocol in curl or be prepared that accesses to a range of "magic paths"
potentially make your system access other hosts on your network. curl cannot
protect you against this.
.SH "What if the user can set the URL"
Applications may find it tempting to let users set the URL that it can work
on. That is probably fine, but opens up for mischief and trickery that you as
an application author may want to address or take precautions against.
If your curl-using script allow a custom URL do you also, perhaps
unintentionally, allow the user to pass other options to the curl command line
if creative use of special characters are applied?
If the user can set the URL, the user can also specify the scheme part to
other protocols that you did not intend for users to use and perhaps did not
consider. curl supports over 20 different URL schemes. "http://" might be what
you thought, "ftp://" or "imap://" might be what the user gives your
application. Also, cross-protocol operations might be done by using a
particular scheme in the URL but point to a server doing a different protocol
on a non-standard port.
Remedies:
.IP "Use --proto"
curl command lines can use \fI--proto\fP to limit what URL schemes it accepts
.IP "Use CURLOPT_PROTOCOLS"
libcurl programs can use \fICURLOPT_PROTOCOLS(3)\fP to limit what URL schemes it accepts
.IP "consider not allowing the user to set the full URL"
Maybe just let the user provide data for parts of it? Or maybe filter input to
only allow specific choices?
.SH "RFC 3986 vs WHATWG URL"
curl supports URLs mostly according to how they are defined in RFC 3986, and
has done so since the beginning.
Web browsers mostly adhere to the WHATWG URL Specification.
This deviance makes some URLs copied between browsers (or returned over HTTP
for redirection) and curl not work the same way. It can also cause problems if
an application parses URLs differently from libcurl and makes different
assumptions about a link. This can mislead users into getting the wrong thing,
connecting to the wrong host or otherwise not working identically.
Within an application, this can be mitigated by always using the
\fIcurl_url(3)\fP API to parse URLs, ensuring that they are parsed the same way
as within libcurl itself.
.SH "FTP uses two connections"
When performing an FTP transfer, two TCP connections are used: one for setting
up the transfer and one for the actual data.
FTP is not only unauthenticated, but the setting up of the second transfer is
also a weak spot. The second connection to use for data, is either setup with
the PORT/EPRT command that makes the server connect back to the client on the
given IP+PORT, or with PASV/EPSV that makes the server setup a port to listen
to and tells the client to connect to a given IP+PORT.
Again, unauthenticated means that the connection might be meddled with by a
man-in-the-middle or that there is a malicious server pretending to be the
right one.
A malicious FTP server can respond to PASV commands with the IP+PORT of a
totally different machine. Perhaps even a third party host, and when there are
many clients trying to connect to that third party, it could create a
Distributed Denial-Of-Service attack out of it. If the client makes an upload
operation, it can make the client send the data to another site. If the
attacker can affect what data the client uploads, it can be made to work as a
HTTP request and then the client could be made to issue HTTP requests to third
party hosts.
An attacker that manages to control curl's command line options can tell curl
to send an FTP PORT command to ask the server to connect to a third party host
instead of back to curl.
The fact that FTP uses two connections makes it vulnerable in a way that is
hard to avoid.
.SH "Denial of Service"
A malicious server could cause libcurl to effectively hang by sending data
slowly, or even no data at all but just keeping the TCP connection open. This
could effectively result in a denial-of-service attack. The
\fICURLOPT_TIMEOUT(3)\fP and/or \fICURLOPT_LOW_SPEED_LIMIT(3)\fP options can
be used to mitigate against this.
A malicious server could cause libcurl to download an infinite amount of data,
potentially causing all of memory or disk to be filled. Setting the
\fICURLOPT_MAXFILESIZE_LARGE(3)\fP option is not sufficient to guard against
this. Instead, applications should monitor the amount of data received within
the write or progress callback and abort once the limit is reached.
A malicious HTTP server could cause an infinite redirection loop, causing a
denial-of-service. This can be mitigated by using the
\fICURLOPT_MAXREDIRS(3)\fP option.
.SH "Arbitrary Headers"
User-supplied data must be sanitized when used in options like
\fICURLOPT_USERAGENT(3)\fP, \fICURLOPT_HTTPHEADER(3)\fP,
\fICURLOPT_POSTFIELDS(3)\fP and others that are used to generate structured
data. Characters like embedded carriage returns or ampersands could allow the
user to create additional headers or fields that could cause malicious
transactions.
.SH "Server-supplied Names"
A server can supply data which the application may, in some cases, use as a
file name. The curl command-line tool does this with
\fI--remote-header-name\fP, using the Content-disposition: header to generate
a file name. An application could also use \fICURLINFO_EFFECTIVE_URL(3)\fP to
generate a file name from a server-supplied redirect URL. Special care must be
taken to sanitize such names to avoid the possibility of a malicious server
supplying one like \fB"/etc/passwd"\fP, \fB"\\autoexec.bat"\fP, \fB"prn:"\fP
or even \fB".bashrc"\fP.
.SH "Server Certificates"
A secure application should never use the \fICURLOPT_SSL_VERIFYPEER(3)\fP
option to disable certificate validation. There are numerous attacks that are
enabled by applications that fail to properly validate server TLS/SSL
certificates, thus enabling a malicious server to spoof a legitimate
one. HTTPS without validated certificates is potentially as insecure as a
plain HTTP connection.
.SH "Showing What You Do"
Relatedly, be aware that in situations when you have problems with libcurl and
ask someone for help, everything you reveal in order to get best possible help
might also impose certain security related risks. Host names, user names,
paths, operating system specifics, etc. (not to mention passwords of course)
may in fact be used by intruders to gain additional information of a potential
target.
Be sure to limit access to application logs if they could hold private or
security-related data. Besides the obvious candidates like user names and
passwords, things like URLs, cookies or even file names could also hold
sensitive data.
To avoid this problem, you must of course use your common sense. Often, you
can just edit out the sensitive data or just search/replace your true
information with faked data.
.SH "setuid applications using libcurl"
libcurl-using applications that set the 'setuid' bit to run with elevated or
modified rights also implicitly give that extra power to libcurl and this
should only be done after careful considerations.
Giving setuid powers to the application means that libcurl can save files using
those new rights (if for example the `SSLKEYLOGFILE` environment variable is
set). Also: if the application wants these powers to read or manage secrets
that the user is otherwise not able to view (like credentials for a login
etc), it should be noted that libcurl still might understand proxy environment
variables that allow the user to redirect libcurl operations to use a proxy
controlled by the user.
.SH "File descriptors, fork and NTLM"
An application that uses libcurl and invokes \fIfork()\fP gets all file
descriptors duplicated in the child process, including the ones libcurl
created.
libcurl itself uses \fIfork()\fP and \fIexecl()\fP if told to use the
\fBCURLAUTH_NTLM_WB\fP authentication method which then invokes the helper
command in a child process with file descriptors duplicated. Make sure that
only the trusted and reliable helper program is invoked!
.SH "Secrets in memory"
When applications pass user names, passwords or other sensitive data to
libcurl to be used for upcoming transfers, those secrets are kept around as-is
in memory. In many cases they are stored in the heap for as long as the handle
itself for which the options are set.
If an attacker can access the heap, like maybe by reading swap space or via a
core dump file, such data might be accessible.
Further, when eventually closing a handle and the secrets are no longer
needed, libcurl does not explicitly clear memory before freeing it, so
credentials may be left in freed data.
.SH "Saving files"
libcurl cannot protect against attacks where an attacker has write access to
the same directory where libcurl is directed to save files.
.SH "Report Security Problems"
Should you detect or just suspect a security problem in libcurl or curl,
contact the project curl security team immediately. See
https://curl.se/dev/secprocess.html for details.
man/man3/CURLOPT_HSTSWRITEFUNCTION.3 0000644 00000006446 14751172372 0012236 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_HSTSWRITEFUNCTION 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_HSTSWRITEFUNCTION \- write callback for HSTS hosts
.SH SYNOPSIS
.nf
#include <curl/curl.h>
struct curl_hstsentry {
char *name;
size_t namelen;
unsigned int includeSubDomains:1;
char expire[18]; /* YYYYMMDD HH:MM:SS [null-terminated] */
};
struct curl_index {
size_t index; /* the provided entry's "index" or count */
size_t total; /* total number of entries to save */
};
CURLSTScode hstswrite(CURL *easy, struct curl_hstsentry *sts,
struct curl_index *count, void *clientp);
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_HSTSWRITEFUNCTION, hstswrite);
.fi
.SH DESCRIPTION
Pass a pointer to your callback function, as the prototype shows above.
This callback function gets called by libcurl repeatedly to allow the
application to store the in-memory HSTS cache when libcurl is about to discard
it.
Set the \fIclientp\fP argument with the \fICURLOPT_HSTSWRITEDATA(3)\fP option
or it is NULL.
When the callback is invoked, the \fIsts\fP pointer points to a populated
struct: Read the host name to 'name' (it is \fInamelen\fP bytes long and null
terminated. The \fIincludeSubDomains\fP field is non-zero if the entry matches
subdomains. The \fIexpire\fP string is a date stamp null-terminated string
using the syntax YYYYMMDD HH:MM:SS.
The callback should return \fICURLSTS_OK\fP if it succeeded and is prepared to
be called again (for another host) or \fICURLSTS_DONE\fP if there is nothing
more to do. It can also return \fICURLSTS_FAIL\fP to signal error.
This option does not enable HSTS, you need to use \fICURLOPT_HSTS_CTRL(3)\fP to
do that.
.SH DEFAULT
NULL - no callback.
.SH PROTOCOLS
This feature is only used for HTTP(S) transfer.
.SH EXAMPLE
.nf
{
/* set HSTS read callback */
curl_easy_setopt(curl, CURLOPT_HSTSWRITEFUNCTION, hstswrite);
/* pass in suitable argument to the callback */
curl_easy_setopt(curl, CURLOPT_HSTSWRITEDATA, &hstspreload[0]);
result = curl_easy_perform(curl);
}
.fi
.SH AVAILABILITY
Added in 7.74.0
.SH RETURN VALUE
This returns CURLE_OK.
.SH "SEE ALSO"
.BR CURLOPT_HSTS (3),
.BR CURLOPT_HSTS_CTRL (3),
.BR CURLOPT_HSTSWRITEDATA (3),
.BR CURLOPT_HSTSWRITEFUNCTION (3)
man/man3/CURLOPT_USERNAME.3 0000644 00000006144 14751172372 0010706 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_USERNAME 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_USERNAME \- user name to use in authentication
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_USERNAME,
char *username);
.SH DESCRIPTION
Pass a char * as parameter, which should be pointing to the null-terminated
user name to use for the transfer.
\fICURLOPT_USERNAME(3)\fP sets the user name to be used in protocol
authentication. You should not use this option together with the (older)
\fICURLOPT_USERPWD(3)\fP option.
When using Kerberos V5 authentication with a Windows based server, you should
include the domain name in order for the server to successfully obtain a
Kerberos Ticket. If you do not then the initial part of the authentication
handshake may fail.
When using NTLM, the user name can be specified simply as the user name
without the domain name should the server be part of a single domain and
forest.
To include the domain name use either Down-Level Logon Name or UPN (User
Principal Name) formats. For example, EXAMPLE\\user and user@example.com
respectively.
Some HTTP servers (on Windows) support inclusion of the domain for Basic
authentication as well.
To specify the password and login options, along with the user name, use the
\fICURLOPT_PASSWORD(3)\fP and \fICURLOPT_LOGIN_OPTIONS(3)\fP options.
The application does not have to keep the string around after setting this
option.
.SH DEFAULT
blank
.SH PROTOCOLS
Most
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/foo.bin");
curl_easy_setopt(curl, CURLOPT_USERNAME, "clark");
ret = curl_easy_perform(curl);
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Added in 7.19.1
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, CURLE_UNKNOWN_OPTION if not, or
CURLE_OUT_OF_MEMORY if there was insufficient heap space.
.SH "SEE ALSO"
.BR CURLOPT_USERPWD (3),
.BR CURLOPT_PASSWORD (3),
.BR CURLOPT_HTTPAUTH (3),
.BR CURLOPT_PROXYAUTH (3)
man/man3/CURLOPT_FTP_USE_EPSV.3 0000644 00000005014 14751172372 0011464 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_FTP_USE_EPSV 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_FTP_USE_EPSV \- use EPSV for FTP
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_FTP_USE_EPSV, long epsv);
.fi
.SH DESCRIPTION
Pass \fIepsv\fP as a long. If the value is 1, it tells curl to use the EPSV
command when doing passive FTP downloads (which it does by default). Using
EPSV means that libcurl first attempts to use the EPSV command before using
PASV. If you pass zero to this option, it does not use EPSV, only plain PASV.
The EPSV command is a slightly newer addition to the FTP protocol than PASV
and is the preferred command to use since it enables IPv6 to be used. Very old
FTP servers might not support it, which is why libcurl has a fallback
mechanism. Sometimes that fallback is not enough and then this option might
come handy.
If the server is an IPv6 host, this option has no effect.
.SH DEFAULT
1
.SH PROTOCOLS
FTP
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "ftp://example.com/old-server/file.txt");
/* let's shut off this modern feature */
curl_easy_setopt(curl, CURLOPT_FTP_USE_EPSV, 0L);
ret = curl_easy_perform(curl);
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Along with FTP
.SH RETURN VALUE
Returns CURLE_OK if FTP is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR CURLOPT_FTP_USE_EPRT (3),
.BR CURLOPT_FTPPORT (3)
man/man3/CURLOPT_UPKEEP_INTERVAL_MS.3 0000644 00000005466 14751172372 0012371 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_UPKEEP_INTERVAL_MS 3 "August 31, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_UPKEEP_INTERVAL_MS \- connection upkeep interval
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_UPKEEP_INTERVAL_MS,
long upkeep_interval_ms);
.fi
.SH DESCRIPTION
Some protocols have "connection upkeep" mechanisms. These mechanisms usually
send some traffic on existing connections in order to keep them alive; this
can prevent connections from being closed due to overzealous firewalls, for
example.
The user needs to explicitly call \fIcurl_easy_upkeep(3)\fP in order to
perform the upkeep work.
Currently the only protocol with a connection upkeep mechanism is HTTP/2: when
the connection upkeep interval is exceeded and \fIcurl_easy_upkeep(3)\fP
is called, an HTTP/2 PING frame is sent on the connection.
.SH DEFAULT
CURL_UPKEEP_INTERVAL_DEFAULT (currently defined as 60000L, which is 60 seconds)
.SH PROTOCOLS
All
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
/* Make a connection to an HTTP/2 server. */
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
/* Set the interval to 30000ms / 30s */
curl_easy_setopt(curl, CURLOPT_UPKEEP_INTERVAL_MS, 30000L);
curl_easy_perform(curl);
/* Perform more work here. */
/* While the connection is being held open, curl_easy_upkeep() can be
called. If curl_easy_upkeep() is called and the time since the last
upkeep exceeds the interval, then an HTTP/2 PING is sent. */
curl_easy_upkeep(curl);
/* Perform more work here. */
/* always cleanup */
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Added in 7.62.0
.SH RETURN VALUE
Returns CURLE_OK
.SH SEE ALSO
.BR CURLOPT_TCP_KEEPALIVE "(3), "
man/man3/CURLOPT_SOCKS5_GSSAPI_NEC.3 0000644 00000004333 14751172372 0012167 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_SOCKS5_GSSAPI_NEC 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_SOCKS5_GSSAPI_NEC \- SOCKS proxy GSSAPI negotiation protection
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_SOCKS5_GSSAPI_NEC, long nec);
.fi
.SH DESCRIPTION
Pass a long set to 1 to enable or 0 to disable. As part of the GSSAPI
negotiation a protection mode is negotiated. The RFC 1961 says in section
4.3/4.4 it should be protected, but the NEC reference implementation does not.
If enabled, this option allows the unprotected exchange of the protection mode
negotiation.
.SH DEFAULT
?
.SH PROTOCOLS
Most
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/");
curl_easy_setopt(curl, CURLOPT_PROXY, "socks5://proxy");
curl_easy_setopt(curl, CURLOPT_SOCKS5_GSSAPI_NEC, 1L);
ret = curl_easy_perform(curl);
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Added in 7.19.4
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR CURLOPT_SOCKS5_GSSAPI_SERVICE (3),
.BR CURLOPT_PROXY (3)
man/man3/CURLINFO_CERTINFO.3 0000644 00000006516 14751172372 0010774 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLINFO_CERTINFO 3 "September 26, 2023" "libcurl 8.4.0" "libcurl"
.SH NAME
CURLINFO_CERTINFO \- get the TLS certificate chain
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_getinfo(CURL *handle, CURLINFO_CERTINFO,
struct curl_certinfo **chainp);
.fi
.SH DESCRIPTION
Pass a pointer to a \fIstruct curl_certinfo *\fP and it is set to point to a
struct that holds info about the server's certificate chain, assuming you had
\fICURLOPT_CERTINFO(3)\fP enabled when the request was made.
.nf
struct curl_certinfo {
int num_of_certs;
struct curl_slist **certinfo;
};
.fi
The \fIcertinfo\fP struct member is an array of linked lists of certificate
information. The \fInum_of_certs\fP struct member is the number of
certificates which is the number of elements in the array. Each certificate's
list has items with textual information in the format "name:content" such as
\&"Subject:Foo", "Issuer:Bar", etc. The items in each list varies depending on
the SSL backend and the certificate.
.SH PROTOCOLS
All TLS-based
.SH EXAMPLE
.nf
curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://www.example.com/");
/* connect to any HTTPS site, trusted or not */
curl_easy_setopt(curl, CURLOPT_SSL_VERIFYPEER, 0L);
curl_easy_setopt(curl, CURLOPT_SSL_VERIFYHOST, 0L);
curl_easy_setopt(curl, CURLOPT_CERTINFO, 1L);
res = curl_easy_perform(curl);
if (!res) {
struct curl_certinfo *ci;
res = curl_easy_getinfo(curl, CURLINFO_CERTINFO, &ci);
if (!res) {
printf("%d certs!\\n", ci->num_of_certs);
for(i = 0; i < ci->num_of_certs; i++) {
struct curl_slist *slist;
for(slist = ci->certinfo[i]; slist; slist = slist->next)
printf("%s\\n", slist->data);
}
}
}
curl_easy_cleanup(curl);
}
.fi
See also the \fIcertinfo.c\fP example.
.SH AVAILABILITY
This option is only working in libcurl built with OpenSSL, GnuTLS, Schannel or
Secure Transport. GnuTLS support added in 7.42.0. Schannel support added in
7.50.0. Secure Transport support added in 7.79.0.
Added in 7.19.1
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR curl_easy_getinfo (3),
.BR curl_easy_setopt (3),
.BR CURLINFO_CAPATH (3)
man/man3/CURLOPT_CUSTOMREQUEST.3 0000644 00000010531 14751172372 0011545 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_CUSTOMREQUEST 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_CUSTOMREQUEST \- custom request method
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_CUSTOMREQUEST, char *method);
.fi
.SH DESCRIPTION
Pass a pointer to a null-terminated string as parameter.
When you change the request \fImethod\fP by setting
\fICURLOPT_CUSTOMREQUEST(3)\fP to something, you do not actually change how
libcurl behaves or acts in regards to the particular request method, it only
changes the actual string sent in the request.
Restore to the internal default by setting this to NULL.
This option can be used to specify the request:
.IP HTTP
Instead of GET or HEAD when performing HTTP based requests. This is
particularly useful, for example, for performing an HTTP DELETE request.
For example:
When you tell libcurl to do a HEAD request, but then specify a GET though a
custom request libcurl still acts as if it sent a HEAD. To switch to a proper
HEAD use \fICURLOPT_NOBODY(3)\fP, to switch to a proper POST use
\fICURLOPT_POST(3)\fP or \fICURLOPT_POSTFIELDS(3)\fP and to switch to a proper
GET use \fICURLOPT_HTTPGET(3)\fP.
Many people have wrongly used this option to replace the entire request with
their own, including multiple headers and POST contents. While that might work
in many cases, it might cause libcurl to send invalid requests and it could
possibly confuse the remote server badly. Use \fICURLOPT_POST(3)\fP and
\fICURLOPT_POSTFIELDS(3)\fP to set POST data. Use \fICURLOPT_HTTPHEADER(3)\fP
to replace or extend the set of headers sent by libcurl. Use
\fICURLOPT_HTTP_VERSION(3)\fP to change HTTP version.
.IP FTP
Instead of LIST and NLST when performing FTP directory listings.
.IP IMAP
Instead of LIST when issuing IMAP based requests.
.IP POP3
Instead of LIST and RETR when issuing POP3 based requests.
For example:
When you tell libcurl to use a custom request it behaves like a LIST or RETR
command was sent where it expects data to be returned by the server. As such
\fICURLOPT_NOBODY(3)\fP should be used when specifying commands such as
\fBDELE\fP and \fBNOOP\fP for example.
.IP SMTP
Instead of a \fBHELP\fP or \fBVRFY\fP when issuing SMTP based requests.
For example:
Normally a multi line response is returned which can be used, in conjunction
with \fICURLOPT_MAIL_RCPT(3)\fP, to specify an EXPN request. If the
\fICURLOPT_NOBODY(3)\fP option is specified then the request can be used to
issue \fBNOOP\fP and \fBRSET\fP commands.
The application does not have to keep the string around after setting this
option.
.SH DEFAULT
NULL
.SH PROTOCOLS
HTTP, FTP, IMAP, POP3 and SMTP
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/foo.bin");
/* DELETE the given path */
curl_easy_setopt(curl, CURLOPT_CUSTOMREQUEST, "DELETE");
ret = curl_easy_perform(curl);
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
IMAP is supported since 7.30.0, POP3 since 7.26.0 and SMTP since 7.34.0.
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, CURLE_UNKNOWN_OPTION if not, or
CURLE_OUT_OF_MEMORY if there was insufficient heap space.
.SH "SEE ALSO"
.BR CURLINFO_EFFECTIVE_METHOD (3),
.BR CURLOPT_HTTPHEADER (3),
.BR CURLOPT_NOBODY (3),
.BR CURLOPT_REQUEST_TARGET (3)
man/man3/CURLOPT_NEW_FILE_PERMS.3 0000644 00000004233 14751172372 0011662 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_NEW_FILE_PERMS 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_NEW_FILE_PERMS \- permissions for remotely created files
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_NEW_FILE_PERMS,
long mode);
.SH DESCRIPTION
Pass a long as a parameter, containing the value of the permissions that are
set on newly created files on the remote server. The default value is
\fI0644\fP, but any valid value can be used. The only protocols that can use
this are \fIsftp://\fP, \fIscp://\fP, and \fIfile://\fP.
.SH DEFAULT
0644
.SH PROTOCOLS
SFTP, SCP and FILE
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
CURLcode ret;
curl_easy_setopt(curl, CURLOPT_URL, "sftp://upload.example.com/file.txt");
curl_easy_setopt(curl, CURLOPT_NEW_FILE_PERMS, 0664L);
ret = curl_easy_perform(curl);
}
.fi
.SH AVAILABILITY
Added in 7.16.4
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR CURLOPT_NEW_DIRECTORY_PERMS (3),
.BR CURLOPT_UPLOAD (3)
man/man3/CURLOPT_RTSP_STREAM_URI.3 0000644 00000005405 14751172372 0012050 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_RTSP_STREAM_URI 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_RTSP_STREAM_URI \- RTSP stream URI
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_RTSP_STREAM_URI, char *URI);
.fi
.SH DESCRIPTION
Set the stream \fIURI\fP to operate on by passing a char * . For example, a
single session may be controlling \fIrtsp://foo/twister/audio\fP and
\fIrtsp://foo/twister/video\fP and the application can switch to the
appropriate stream using this option. If unset, libcurl defaults to operating
on generic server options by passing '*' in the place of the RTSP Stream
URI. This option is distinct from \fICURLOPT_URL(3)\fP. When working with
RTSP, the \fICURLOPT_RTSP_STREAM_URI(3)\fP indicates what URL to send to the
server in the request header while the \fICURLOPT_URL(3)\fP indicates where to
make the connection to. (e.g. the \fICURLOPT_URL(3)\fP for the above examples
might be set to \fIrtsp://foo/twister\fP
The application does not have to keep the string around after setting this
option.
.SH DEFAULT
\&'*'
.SH PROTOCOLS
RTSP
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
char *prev_id; /* saved from before somehow */
curl_easy_setopt(curl, CURLOPT_URL, "rtsp://example.com/");
curl_easy_setopt(curl, CURLOPT_RTSP_STREAM_URI,
"rtsp://foo.example.com/twister/video");
ret = curl_easy_perform(curl);
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Added in 7.20.0
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, CURLE_UNKNOWN_OPTION if not, or
CURLE_OUT_OF_MEMORY if there was insufficient heap space.
.SH "SEE ALSO"
.BR CURLOPT_RTSP_REQUEST (3),
.BR CURLOPT_RTSP_TRANSPORT (3)
man/man3/CURLOPT_POST.3 0000644 00000010000 14751172372 0010236 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_POST 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_POST \- make an HTTP POST
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_POST, long post);
.fi
.SH DESCRIPTION
A parameter set to 1 tells libcurl to do a regular HTTP post. This also makes
libcurl use a "Content-Type: application/x-www-form-urlencoded" header. This
is the most commonly used POST method.
Use one of \fICURLOPT_POSTFIELDS(3)\fP or \fICURLOPT_COPYPOSTFIELDS(3)\fP
options to specify what data to post and \fICURLOPT_POSTFIELDSIZE(3)\fP or
\fICURLOPT_POSTFIELDSIZE_LARGE(3)\fP to set the data size.
Optionally, you can provide data to POST using the
\fICURLOPT_READFUNCTION(3)\fP and \fICURLOPT_READDATA(3)\fP options but then
you must make sure to not set \fICURLOPT_POSTFIELDS(3)\fP to anything but
NULL. When providing data with a callback, you must transmit it using chunked
transfer-encoding or you must set the size of the data with the
\fICURLOPT_POSTFIELDSIZE(3)\fP or \fICURLOPT_POSTFIELDSIZE_LARGE(3)\fP
options. To enable chunked encoding, you simply pass in the appropriate
Transfer-Encoding header, see the post-callback.c example.
You can override the default POST Content-Type: header by setting your own
with \fICURLOPT_HTTPHEADER(3)\fP.
Using POST with HTTP 1.1 implies the use of a "Expect: 100-continue" header.
You can disable this header with \fICURLOPT_HTTPHEADER(3)\fP as usual.
If you use POST to an HTTP 1.1 server, you can send data without knowing the
size before starting the POST if you use chunked encoding. You enable this by
adding a header like "Transfer-Encoding: chunked" with
\fICURLOPT_HTTPHEADER(3)\fP. With HTTP 1.0 or without chunked transfer, you
must specify the size in the request. (Since 7.66.0, libcurl automatically
uses chunked encoding for POSTs if the size is unknown.)
When setting \fICURLOPT_POST(3)\fP to 1, libcurl automatically sets
\fICURLOPT_NOBODY(3)\fP and \fICURLOPT_HTTPGET(3)\fP to 0.
If you issue a POST request and then want to make a HEAD or GET using the same
reused handle, you must explicitly set the new request type using
\fICURLOPT_NOBODY(3)\fP or \fICURLOPT_HTTPGET(3)\fP or similar.
When setting \fICURLOPT_POST(3)\fP to 0, libcurl resets the request type to
the default to disable the POST. Typically that would mean it's reset to GET.
Instead you should set a new request type explicitly as described above.
.SH DEFAULT
0, disabled
.SH PROTOCOLS
HTTP
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/foo.bin");
curl_easy_setopt(curl, CURLOPT_POST, 1L);
/* set up the read callback with CURLOPT_READFUNCTION */
ret = curl_easy_perform(curl);
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Along with HTTP
.SH RETURN VALUE
Returns CURLE_OK if HTTP is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR CURLOPT_HTTPPOST (3),
.BR CURLOPT_POSTFIELDS (3),
.BR CURLOPT_PUT (3)
man/man3/CURLOPT_SSLENGINE.3 0000644 00000004673 14751172372 0011023 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_SSLENGINE 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_SSLENGINE \- SSL engine identifier
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_SSLENGINE, char *id);
.fi
.SH DESCRIPTION
Pass a pointer to a null-terminated string as parameter. It is used as the
identifier for the crypto engine you want to use for your private key.
The application does not have to keep the string around after setting this
option.
.SH DEFAULT
NULL
.SH PROTOCOLS
All TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc.
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/");
curl_easy_setopt(curl, CURLOPT_SSLENGINE, "dynamic");
ret = curl_easy_perform(curl);
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Only if the SSL backend is OpenSSL built with engine support.
.SH RETURN VALUE
CURLE_OK - Engine found.
CURLE_SSL_ENGINE_NOTFOUND - Engine not found, or OpenSSL was not built with
engine support.
CURLE_SSL_ENGINE_INITFAILED - Engine found but initialization failed.
CURLE_NOT_BUILT_IN - Option not built in, OpenSSL is not the SSL backend.
CURLE_UNKNOWN_OPTION - Option not recognized.
CURLE_OUT_OF_MEMORY - Insufficient heap space.
.SH "SEE ALSO"
.BR CURLINFO_SSL_ENGINES (3),
.BR CURLOPT_SSLENGINE_DEFAULT (3),
.BR CURLOPT_SSLKEY (3)
man/man3/CURLMOPT_PUSHFUNCTION.3 0000644 00000011515 14751172372 0011527 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLMOPT_PUSHFUNCTION 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLMOPT_PUSHFUNCTION \- callback that approves or denies server pushes
.SH SYNOPSIS
.nf
#include <curl/curl.h>
int curl_push_callback(CURL *parent,
CURL *easy,
size_t num_headers,
struct curl_pushheaders *headers,
void *clientp);
CURLMcode curl_multi_setopt(CURLM *handle, CURLMOPT_PUSHFUNCTION,
curl_push_callback func);
.fi
.SH DESCRIPTION
This callback gets called when a new HTTP/2 stream is being pushed by the
server (using the PUSH_PROMISE frame). If no push callback is set, all offered
pushes are denied automatically.
.SH CALLBACK DESCRIPTION
The callback gets its arguments like this:
\fIparent\fP is the handle of the stream on which this push arrives. The new
handle has been duplicated from the parent, meaning that it has gotten all its
options inherited. It is then up to the application to alter any options if
desired.
\fIeasy\fP is a newly created handle that represents this upcoming transfer.
\fInum_headers\fP is the number of name+value pairs that was received and can
be accessed
\fIheaders\fP is a handle used to access push headers using the accessor
functions described below. This only accesses and provides the PUSH_PROMISE
headers, the normal response headers are provided in the header callback as
usual.
\fIclientp\fP is the pointer set with \fICURLMOPT_PUSHDATA(3)\fP
If the callback returns CURL_PUSH_OK, the new easy handle is added to the
multi handle, the callback must not do that by itself.
The callback can access PUSH_PROMISE headers with two accessor
functions. These functions can only be used from within this callback and they
can only access the PUSH_PROMISE headers: \fIcurl_pushheader_byname(3)\fP and
\fIcurl_pushheader_bynum(3)\fP. The normal response headers are passed to the
header callback for pushed streams just as for normal streams.
The header fields can also be accessed with \fIcurl_easy_header(3)\fP,
introduced in later libcurl versions.
.SH CALLBACK RETURN VALUE
.IP "CURL_PUSH_OK (0)"
The application has accepted the stream and it can now start receiving data,
the ownership of the CURL handle has been taken over by the application.
.IP "CURL_PUSH_DENY (1)"
The callback denies the stream and no data reaches the application, the easy
handle is destroyed by libcurl.
.IP "CURL_PUSH_ERROROUT (2)"
Returning this code rejects the pushed stream and returns an error back on the
parent stream making it get closed with an error. (Added in 7.72.0)
.IP *
All other return codes are reserved for future use.
.SH DEFAULT
NULL, no callback
.SH PROTOCOLS
HTTP(S) (HTTP/2 only)
.SH EXAMPLE
.nf
/* only allow pushes for file names starting with "push-" */
int push_callback(CURL *parent,
CURL *easy,
size_t num_headers,
struct curl_pushheaders *headers,
void *clientp)
{
char *headp;
int *transfers = (int *)clientp;
FILE *out;
headp = curl_pushheader_byname(headers, ":path");
if(headp && !strncmp(headp, "/push-", 6)) {
fprintf(stderr, "The PATH is %s\\n", headp);
/* save the push here */
out = fopen("pushed-stream", "wb");
/* write to this file */
curl_easy_setopt(easy, CURLOPT_WRITEDATA, out);
(*transfers)++; /* one more */
return CURL_PUSH_OK;
}
return CURL_PUSH_DENY;
}
curl_multi_setopt(multi, CURLMOPT_PUSHFUNCTION, push_callback);
curl_multi_setopt(multi, CURLMOPT_PUSHDATA, &counter);
.fi
.SH AVAILABILITY
Added in 7.44.0
.SH RETURN VALUE
Returns CURLM_OK if the option is supported, and CURLM_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR CURLMOPT_PUSHDATA (3),
.BR CURLMOPT_PIPELINING (3),
.BR CURLOPT_PIPEWAIT (3),
.BR RFC 7540
man/man3/CURLMOPT_TIMERDATA.3 0000644 00000005030 14751172372 0011107 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLMOPT_TIMERDATA 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLMOPT_TIMERDATA \- custom pointer to pass to timer callback
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLMcode curl_multi_setopt(CURLM *handle, CURLMOPT_TIMERDATA, void *pointer);
.SH DESCRIPTION
A data \fBpointer\fP to pass to the timer callback set with the
\fICURLMOPT_TIMERFUNCTION(3)\fP option.
This pointer is not touched by libcurl but is only be passed in to the timer
callbacks's \fBclientp\fP argument.
.SH DEFAULT
NULL
.SH PROTOCOLS
All
.SH EXAMPLE
.nf
static gboolean timeout_cb(gpointer user_data)
{
int running;
if(user_data) {
g_free(user_data);
curl_multi_setopt(curl_handle, CURLMOPT_TIMERDATA, NULL);
}
curl_multi_socket_action(multi, CURL_SOCKET_TIMEOUT, 0, &running);
return G_SOURCE_REMOVE;
}
static int timerfunc(CURLM *multi, long timeout_ms, void *clientp)
{
guint *id = clientp;
if(id)
g_source_remove(*id);
/* -1 means we should just delete our timer. */
if(timeout_ms == -1) {
g_free(id);
id = NULL;
}
else {
if(!id)
id = g_new(guint, 1);
*id = g_timeout_add(timeout_ms, timeout_cb, id);
}
current_timer = id;
return 0;
}
curl_multi_setopt(multi, CURLMOPT_TIMERFUNCTION, timerfunc);
.fi
.SH AVAILABILITY
Added in 7.16.0
.SH RETURN VALUE
Returns CURLM_OK if the option is supported, and CURLM_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR CURLMOPT_TIMERFUNCTION (3),
.BR CURLMOPT_SOCKETFUNCTION (3)
man/man3/curl_unescape.3 0000644 00000004622 14751172372 0011106 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.TH curl_unescape 3 "September 26, 2023" "libcurl 8.4.0" "libcurl"
.SH NAME
curl_unescape - URL decodes the given string
.SH SYNOPSIS
.nf
#include <curl/curl.h>
char *curl_unescape(const char *input, int length);
.fi
.SH DESCRIPTION
Obsolete function. Use \fIcurl_easy_unescape(3)\fP instead!
This function converts the URL encoded string \fBinput\fP to a "plain string"
and return that as a new allocated string. All input characters that are URL
encoded (%XX where XX is a two-digit hexadecimal number) are converted to
their plain text versions.
If the \fBlength\fP argument is set to 0, \fIcurl_unescape(3)\fP calls
strlen() on \fBinput\fP to find out the size.
You must \fIcurl_free(3)\fP the returned string when you are done with it.
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
int decodelen;
char *decoded = curl_unescape("%63%75%72%6c", 12, &decodelen);
if(decoded) {
/* do not assume printf() works on the decoded data! */
printf("Decoded: ");
/* ... */
curl_free(decoded);
}
}
.fi
.SH AVAILABILITY
Since 7.15.4, \fIcurl_easy_unescape(3)\fP should be used. This function might
be removed in a future release.
.SH RETURN VALUE
A pointer to a null-terminated string or NULL if it failed.
.SH "SEE ALSO"
.BR curl_easy_escape (3),
.BR curl_easy_unescape (3),
.BR curl_free (3),
.BR RFC 2396
man/man3/curl_multi_perform.3 0000644 00000010341 14751172372 0012162 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.TH curl_multi_perform 3 "September 26, 2023" "libcurl 8.4.0" "libcurl"
.SH NAME
curl_multi_perform - reads/writes available data from easy handles
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLMcode curl_multi_perform(CURLM *multi_handle, int *running_handles);
.fi
.SH DESCRIPTION
This function performs transfers on all the added handles that need attention
in a non-blocking fashion. The easy handles have previously been added to the
multi handle with \fIcurl_multi_add_handle(3)\fP.
When an application has found out there is data available for the multi_handle
or a timeout has elapsed, the application should call this function to
read/write whatever there is to read or write right now etc.
\fIcurl_multi_perform(3)\fP returns as soon as the reads/writes are done. This
function does not require that there actually is any data available for
reading or that data can be written, it can be called just in case. It stores
the number of handles that still transfer data in the second argument's
integer-pointer.
If the amount of \fIrunning_handles\fP is changed from the previous call (or
is less than the amount of easy handles you have added to the multi handle),
you know that there is one or more transfers less "running". You can then call
\fIcurl_multi_info_read(3)\fP to get information about each individual
completed transfer, and that returned info includes CURLcode and more. If an
added handle fails quickly, it may never be counted as a running_handle. You
could use \fIcurl_multi_info_read(3)\fP to track actual status of the added
handles in that case.
When \fIrunning_handles\fP is set to zero (0) on the return of this function,
there is no longer any transfers in progress.
When this function returns error, the state of all transfers are uncertain and
they cannot be continued. \fIcurl_multi_perform(3)\fP should not be called
again on the same multi handle after an error has been returned, unless first
removing all the handles and adding new ones.
.SH EXAMPLE
.nf
int still_running;
do {
CURLMcode mc = curl_multi_perform(multi_handle, &still_running);
if(!mc && still_running)
/* wait for activity, timeout or "nothing" */
mc = curl_multi_poll(multi_handle, NULL, 0, 1000, NULL);
if(mc) {
fprintf(stderr, "curl_multi_poll() failed, code %d.\\n", (int)mc);
break;
}
/* if there are still transfers, loop! */
} while(still_running);
.fi
.SH AVAILABILITY
Added in 7.9.6
.SH RETURN VALUE
CURLMcode type, general libcurl multi interface error code.
This function returns errors regarding the whole multi stack. Problems on
individual transfers may have occurred even when this function returns
\fICURLM_OK\fP. Use \fIcurl_multi_info_read(3)\fP to figure out how individual
transfers did.
.SH "TYPICAL USAGE"
Most applications use \fIcurl_multi_poll(3)\fP to make libcurl wait for
activity on any of the ongoing transfers. As soon as one or more file
descriptor has activity or the function times out, the application calls
\fIcurl_multi_perform(3)\fP.
.SH "SEE ALSO"
.BR curl_multi_add_handle (3),
.BR curl_multi_cleanup (3),
.BR curl_multi_fdset (3),
.BR curl_multi_info_read (3),
.BR curl_multi_init (3),
.BR curl_multi_wait (3),
.BR libcurl-errors (3)
man/man3/CURLOPT_DNS_INTERFACE.3 0000644 00000004737 14751172372 0011501 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_DNS_INTERFACE 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_DNS_INTERFACE \- interface to speak DNS over
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_DNS_INTERFACE, char *ifname);
.fi
.SH DESCRIPTION
Pass a char * as parameter. Set the name of the network interface that the DNS
resolver should bind to. This must be an interface name (not an address). Set
this option to NULL to use the default setting (do not bind to a specific
interface).
The application does not have to keep the string around after setting this
option.
.SH DEFAULT
NULL
.SH PROTOCOLS
All protocols except file:// - protocols that resolve host names.
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/foo.bin");
curl_easy_setopt(curl, CURLOPT_DNS_INTERFACE, "eth0");
ret = curl_easy_perform(curl);
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Added in 7.33.0. This option also requires that libcurl was built with a
resolver backend that supports this operation. The c-ares backend is the only
such one.
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, CURLE_UNKNOWN_OPTION if not,
or CURLE_NOT_BUILT_IN if support was disabled at compile-time.
.SH "SEE ALSO"
.BR CURLOPT_DNS_LOCAL_IP4 (3),
.BR CURLOPT_DNS_LOCAL_IP6 (3),
.BR CURLOPT_DNS_SERVERS (3),
.BR CURLOPT_INTERFACE (3)
man/man3/CURLMOPT_MAXCONNECTS.3 0000644 00000004760 14751172372 0011370 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLMOPT_MAXCONNECTS 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLMOPT_MAXCONNECTS \- size of connection cache
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLMcode curl_multi_setopt(CURLM *handle, CURLMOPT_MAXCONNECTS, long max);
.fi
.SH DESCRIPTION
Pass a long indicating the \fBmax\fP. The set number is used as the maximum
amount of simultaneously open connections that libcurl may keep in its
connection cache after completed use. By default libcurl enlarges the size for
each added easy handle to make it fit 4 times the number of added easy
handles.
By setting this option, you can prevent the cache size from growing beyond the
limit set by you.
When the cache is full, curl closes the oldest one in the cache to prevent the
number of open connections from increasing.
This option is for the multi handle's use only, when using the easy interface
you should instead use the \fICURLOPT_MAXCONNECTS(3)\fP option.
See \fICURLMOPT_MAX_TOTAL_CONNECTIONS(3)\fP for limiting the number of active
connections.
.SH DEFAULT
See DESCRIPTION
.SH PROTOCOLS
All
.SH EXAMPLE
.nf
CURLM *m = curl_multi_init();
/* only keep 10 connections in the cache */
curl_multi_setopt(m, CURLMOPT_MAXCONNECTS, 10L);
.fi
.SH AVAILABILITY
Added in 7.16.3
.SH RETURN VALUE
Returns CURLM_OK if the option is supported, and CURLM_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR CURLMOPT_MAX_HOST_CONNECTIONS (3),
.BR CURLOPT_MAXCONNECTS (3)
man/man3/curl_ws_meta.3 0000644 00000010342 14751172372 0010736 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH curl_ws_meta 3 "September 26, 2023" "libcurl 8.4.0" "libcurl"
.SH NAME
curl_ws_meta - meta data WebSocket information
.SH SYNOPSIS
.nf
#include <curl/easy.h>
struct curl_ws_frame {
int age; /* zero */
int flags; /* See the CURLWS_* defines */
curl_off_t offset; /* the offset of this data into the frame */
curl_off_t bytesleft; /* number of pending bytes left of the payload */
};
const struct curl_ws_frame *curl_ws_meta(CURL *curl);
.fi
.SH DESCRIPTION
This function call is EXPERIMENTAL.
When the write callback (\fICURLOPT_WRITEFUNCTION(3)\fP) is invoked on
received WebSocket traffic, \fIcurl_ws_meta(3)\fP can be called from within
the callback to provide additional information about the current frame.
This function only works from within the callback, and only when receiving
WebSocket data.
This function requires an easy handle as input argument for libcurl to know
what transfer the question is about, but as there is no such pointer provided
to the callback by libcurl itself, applications that want to use
\fIcurl_ws_meta(3)\fP need to pass it on to the callback on its own.
.SH "struct fields"
.IP age
This field specify the age of this struct. It is always zero for now.
.IP flags
This is a bitmask with individual bits set that describes the WebSocket
data. See the list below.
.IP offset
When this frame is a continuation of fragment data already delivered, this is
the offset into the final fragment where this piece belongs.
.IP bytesleft
If this is not a complete fragment, the \fIbytesleft\fP field informs about
how many additional bytes are expected to arrive before this fragment is
complete.
.SH FLAGS
.IP CURLWS_TEXT
The buffer contains text data. Note that this makes a difference to WebSocket
but libcurl itself does not make any verification of the content or
precautions that you actually receive valid UTF-8 content.
.IP CURLWS_BINARY
This is binary data.
.IP CURLWS_CONT
This is not the final fragment of the message, it implies that there is
another fragment coming as part of the same message.
.IP CURLWS_CLOSE
This transfer is now closed.
.IP CURLWS_PING
This as an incoming ping message, that expects a pong response.
.SH EXAMPLE
.nf
/* we pass a pointer to this struct to the callback */
struct customdata {
CURL *easy;
void *ptr;
};
static size_t writecb(unsigned char *buffer,
size_t size, size_t nitems, void *p)
{
struct customdata *c = (struct customdata *)p;
const struct curl_ws_frame *m = curl_ws_meta(c->easy);
/* m->flags tells us about the traffic */
}
{
struct customdata custom;
custom.easy = easy;
custom.ptr = NULL;
curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, writecb);
curl_easy_setopt(curl, CURLOPT_WRITEDATA, &custom);
}
.fi
.SH AVAILABILITY
Added in 7.86.0.
.SH RETURN VALUE
This function returns a pointer to a \fIcurl_ws_frame\fP struct with read-only
information that is valid for this specific callback invocation. If it cannot
return this information, or if the function is called in the wrong context, it
returns NULL.
.SH "SEE ALSO"
.BR curl_easy_setopt (3),
.BR curl_easy_getinfo (3),
.BR curl_ws_send (3),
.BR curl_ws_recv (3),
.BR libcurl-ws (3)
man/man3/CURLOPT_PROXY_PINNEDPUBLICKEY.3 0000644 00000010460 14751172372 0012711 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_PROXY_PINNEDPUBLICKEY 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_PROXY_PINNEDPUBLICKEY \- pinned public key for https proxy
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_PROXY_PINNEDPUBLICKEY, char *pinnedpubkey);
.fi
.SH DESCRIPTION
Pass a pointer to a null-terminated string as parameter. The string can be the
file name of your pinned public key. The file format expected is "PEM" or "DER".
The string can also be any number of base64 encoded sha256 hashes preceded by
"sha256//" and separated by ";"
When negotiating a TLS or SSL connection, the https proxy sends a certificate
indicating its identity. A public key is extracted from this certificate and
if it does not exactly match the public key provided to this option, libcurl
aborts the connection before sending or receiving any data.
On mismatch, \fICURLE_SSL_PINNEDPUBKEYNOTMATCH\fP is returned.
The application does not have to keep the string around after setting this
option.
.SH DEFAULT
NULL
.SH PROTOCOLS
All TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc.
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
curl_easy_setopt(curl, CURLOPT_PROXY, "https://proxy:443");
curl_easy_setopt(curl, CURLOPT_PROXY_PINNEDPUBLICKEY,
"sha256//YhKJKSzoTt2b5FP18fvpHo7fJYqQCjAa3HWY3tvRMwE=;sha256//t62CeU2tQiqkexU74Gxa2eg7fRbEgoChTociMee9wno=");
/* Perform the request */
curl_easy_perform(curl);
}
.fi
.SH PUBLIC KEY EXTRACTION
If you do not have the https proxy server's public key file you can extract it
from the https proxy server's certificate.
.nf
# retrieve the server's certificate if you do not already have it
#
# be sure to examine the certificate to see if it is what you expected
#
# Windows-specific:
# - Use NUL instead of /dev/null.
# - OpenSSL may wait for input instead of disconnecting. Hit enter.
# - If you do not have sed, then just copy the certificate into a file:
# Lines from -----BEGIN CERTIFICATE----- to -----END CERTIFICATE-----.
#
openssl s_client -servername www.example.com -connect www.example.com:443 < /dev/null | sed -n "/-----BEGIN/,/-----END/p" > www.example.com.pem
# extract public key in pem format from certificate
openssl x509 -in www.example.com.pem -pubkey -noout > www.example.com.pubkey.pem
# convert public key from pem to der
openssl asn1parse -noout -inform pem -in www.example.com.pubkey.pem -out www.example.com.pubkey.der
# sha256 hash and base64 encode der to string for use
openssl dgst -sha256 -binary www.example.com.pubkey.der | openssl base64
.fi
The public key in PEM format contains a header, base64 data and a
footer:
.nf
-----BEGIN PUBLIC KEY-----
[BASE 64 DATA]
-----END PUBLIC KEY-----
.fi
.SH AVAILABILITY
PEM/DER support:
7.52.0: GnuTLS, OpenSSL, mbedTLS, wolfSSL
sha256 support:
7.52.0: GnuTLS, OpenSSL, mbedTLS, wolfSSL
Other SSL backends not supported.
.SH RETURN VALUE
Returns CURLE_OK if TLS enabled, CURLE_UNKNOWN_OPTION if not, or
CURLE_OUT_OF_MEMORY if there was insufficient heap space.
.SH "SEE ALSO"
.BR CURLOPT_PINNEDPUBLICKEY (3),
.BR CURLOPT_PROXY_CAINFO (3),
.BR CURLOPT_PROXY_CAPATH (3),
.BR CURLOPT_PROXY_SSL_VERIFYHOST (3),
.BR CURLOPT_PROXY_SSL_VERIFYPEER (3)
man/man3/CURLOPT_USERPWD.3 0000644 00000007033 14751172372 0010616 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_USERPWD 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_USERPWD \- user name and password to use in authentication
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_USERPWD, char *userpwd);
.fi
.SH DESCRIPTION
Pass a char * as parameter, pointing to a null-terminated login details string
for the connection. The format of which is: [user name]:[password].
When using Kerberos V5 authentication with a Windows based server, you should
specify the user name part with the domain name in order for the server to
successfully obtain a Kerberos Ticket. If you do not then the initial part of
the authentication handshake may fail.
When using NTLM, the user name can be specified simply as the user name
without the domain name should the server be part of a single domain and
forest.
To specify the domain name use either Down-Level Logon Name or UPN (User
Principal Name) formats. For example, EXAMPLE\\user and user@example.com
respectively.
Some HTTP servers (on Windows) support inclusion of the domain for Basic
authentication as well.
When using HTTP and \fICURLOPT_FOLLOWLOCATION(3)\fP, libcurl might perform
several requests to possibly different hosts. libcurl only sends this user and
password information to hosts using the initial host name (unless
\fICURLOPT_UNRESTRICTED_AUTH(3)\fP is set), so if libcurl follows redirects to
other hosts, it does not send the user and password to those. This is enforced
to prevent accidental information leakage.
Use \fICURLOPT_HTTPAUTH(3)\fP to specify the authentication method for HTTP
based connections or \fICURLOPT_LOGIN_OPTIONS(3)\fP to control IMAP, POP3 and
SMTP options.
The user and password strings are not URL decoded, so there is no way to send
in a user name containing a colon using this option. Use
\fICURLOPT_USERNAME(3)\fP for that, or include it in the URL.
The application does not have to keep the string around after setting this
option.
.SH DEFAULT
NULL
.SH PROTOCOLS
Most
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/foo.bin");
curl_easy_setopt(curl, CURLOPT_USERPWD, "clark:kent");
ret = curl_easy_perform(curl);
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Always
.SH RETURN VALUE
Returns CURLE_OK on success or
CURLE_OUT_OF_MEMORY if there was insufficient heap space.
.SH "SEE ALSO"
.BR CURLOPT_USERNAME (3),
.BR CURLOPT_PASSWORD (3),
.BR CURLOPT_PROXYUSERPWD (3)
man/man3/CURLOPT_FTP_SKIP_PASV_IP.3 0000644 00000005130 14751172372 0012161 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_FTP_SKIP_PASV_IP 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_FTP_SKIP_PASV_IP \- ignore the IP address in the PASV response
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_FTP_SKIP_PASV_IP, long skip);
.fi
.SH DESCRIPTION
Pass a long. If \fIskip\fP is set to 1, it instructs libcurl to not use the IP
address the server suggests in its 227-response to libcurl's PASV command when
libcurl connects the data connection. Instead libcurl reuses the same IP
address it already uses for the control connection. It still uses the port
number from the 227-response.
This option allows libcurl to work around broken server installations or funny
network setups that due to NATs, firewalls or incompetence report the wrong IP
address. Setting this option also reduces the risk for various sorts of client
abuse by malicious servers.
This option has no effect if PORT, EPRT or EPSV is used instead of PASV.
.SH DEFAULT
1 since 7.74.0, was 0 before then.
.SH PROTOCOLS
FTP
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "ftp://example.com/file.txt");
/* please ignore the IP in the PASV response */
curl_easy_setopt(curl, CURLOPT_FTP_SKIP_PASV_IP, 1L);
ret = curl_easy_perform(curl);
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Added in 7.14.2
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR CURLOPT_FTPPORT (3),
.BR CURLOPT_FTP_USE_EPRT (3)
man/man3/CURLOPT_RESUME_FROM.3 0000644 00000005174 14751172372 0011314 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_RESUME_FROM 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_RESUME_FROM \- offset to resume transfer from
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_RESUME_FROM, long from);
.fi
.SH DESCRIPTION
Pass a long as parameter. It contains the offset in number of bytes that you
want the transfer to start from. Set this option to 0 to make the transfer
start from the beginning (effectively disabling resume). For FTP, set this
option to -1 to make the transfer start from the end of the target file
(useful to continue an interrupted upload).
When doing uploads with FTP, the resume position is where in the local/source
file libcurl should try to resume the upload from and it then appends the
source file to the remote target file.
If you need to resume a transfer beyond the 2GB limit, use
\fICURLOPT_RESUME_FROM_LARGE(3)\fP instead.
.SH DEFAULT
0, not used
.SH PROTOCOLS
HTTP, FTP, SFTP, FILE
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "ftp://example.com");
/* resume upload at byte index 200 */
curl_easy_setopt(curl, CURLOPT_RESUME_FROM, 200L);
/* ask for upload */
curl_easy_setopt(curl, CURLOPT_UPLOAD, 1L);
/* set total data amount to expect */
curl_easy_setopt(curl, CURLOPT_INFILESIZE, size_of_file);
/* Perform the request */
curl_easy_perform(curl);
}
.fi
.SH AVAILABILITY
Always
.SH RETURN VALUE
Returns CURLE_OK
.SH "SEE ALSO"
.BR CURLOPT_RESUME_FROM_LARGE (3),
.BR CURLOPT_RANGE (3),
.BR CURLOPT_INFILESIZE (3)
man/man3/CURLOPT_TIMEOUT.3 0000644 00000006761 14751172372 0010622 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_TIMEOUT 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_TIMEOUT \- maximum time the transfer is allowed to complete
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_TIMEOUT, long timeout);
.fi
.SH DESCRIPTION
Pass a long as parameter containing \fItimeout\fP - the maximum time in
seconds that you allow the entire transfer operation to take. The whole thing,
from start to end. Normally, name lookups can take a considerable time and
limiting operations risk aborting perfectly normal operations.
\fICURLOPT_TIMEOUT_MS(3)\fP is the same function but set in milliseconds.
If both \fICURLOPT_TIMEOUT(3)\fP and \fICURLOPT_TIMEOUT_MS(3)\fP are set, the
value set last is used.
Since this option puts a hard limit on how long time a request is allowed to
take, it has limited use in dynamic use cases with varying transfer
times. That is especially apparent when using the multi interface, which may
queue the transfer, and that time is included. You are advised to explore
\fICURLOPT_LOW_SPEED_LIMIT(3)\fP, \fICURLOPT_LOW_SPEED_TIME(3)\fP or using
\fICURLOPT_PROGRESSFUNCTION(3)\fP to implement your own timeout logic.
The connection timeout set with \fICURLOPT_CONNECTTIMEOUT(3)\fP is included in
this general all-covering timeout.
With \fICURLOPT_CONNECTTIMEOUT(3)\fP set to 3 and \fICURLOPT_TIMEOUT(3)\fP set
to 5, the operation can never last longer than 5 seconds.
With \fICURLOPT_CONNECTTIMEOUT(3)\fP set to 4 and \fICURLOPT_TIMEOUT(3)\fP set
to 2, the operation can never last longer than 2 seconds.
This option may cause libcurl to use the SIGALRM signal to timeout system
calls on builds not using asynch DNS. In unix-like systems, this might cause
signals to be used unless \fICURLOPT_NOSIGNAL(3)\fP is set.
.SH DEFAULT
Default timeout is 0 (zero) which means it never times out during transfer.
.SH PROTOCOLS
All
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
/* complete within 20 seconds */
curl_easy_setopt(curl, CURLOPT_TIMEOUT, 20L);
curl_easy_perform(curl);
}
.fi
.SH AVAILABILITY
Always
.SH RETURN VALUE
Returns CURLE_OK. Returns CURLE_BAD_FUNCTION_ARGUMENT if set to a negative
value or a value that when converted to milliseconds is too large.
.SH "SEE ALSO"
.BR CURLOPT_CONNECTTIMEOUT (3),
.BR CURLOPT_LOW_SPEED_LIMIT (3),
.BR CURLOPT_TCP_KEEPALIVE (3),
.BR CURLOPT_TIMEOUT_MS (3)
man/man3/curl_global_init_mem.3 0000644 00000006305 14751172372 0012424 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.TH curl_global_init_mem 3 "September 26, 2023" "libcurl 8.4.0" "libcurl"
.SH NAME
curl_global_init_mem - Global libcurl initialization with memory callbacks
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_global_init_mem(long flags,
curl_malloc_callback m,
curl_free_callback f,
curl_realloc_callback r,
curl_strdup_callback s,
curl_calloc_callback c);
.fi
.SH DESCRIPTION
This function works exactly as \fIcurl_global_init(3)\fP with one addition: it
allows the application to set callbacks to replace the otherwise used internal
memory functions.
If you are using libcurl from multiple threads or libcurl was built with the
threaded resolver option then the callback functions must be thread safe. The
threaded resolver is a common build option to enable (and in some cases the
default) so we strongly urge you to make your callback functions thread safe.
All callback arguments must be set to valid function pointers. The
prototypes for the given callbacks must match these:
.IP "void *malloc_callback(size_t size);"
To replace malloc()
.IP "void free_callback(void *ptr);"
To replace free()
.IP "void *realloc_callback(void *ptr, size_t size);"
To replace realloc()
.IP "char *strdup_callback(const char *str);"
To replace strdup()
.IP "void *calloc_callback(size_t nmemb, size_t size);"
To replace calloc()
.PP
This function is otherwise the same as \fIcurl_global_init(3)\fP, please refer
to that man page for documentation.
.SH CAUTION
Manipulating these gives considerable powers to the application to severely
screw things up for libcurl. Take care!
.SH EXAMPLE
.nf
curl_global_init_mem(CURL_GLOBAL_DEFAULT, curl_malloc_cb,
curl_free_cb, curl_realloc_cb,
curl_strdup_cb, curl_calloc_cb);
.fi
.SH AVAILABILITY
Added in 7.12.0
.SH RETURN VALUE
CURLE_OK (0) means everything was OK, non-zero means an error occurred as
\fI<curl/curl.h>\fP defines - see \fIlibcurl-errors(3)\fP.
.SH "SEE ALSO"
.BR curl_global_init (3),
.BR curl_global_cleanup (3)
man/man3/CURLOPT_REDIR_PROTOCOLS.3 0000644 00000006647 14751172372 0012010 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_REDIR_PROTOCOLS 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_REDIR_PROTOCOLS \- protocols allowed to redirect to
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_REDIR_PROTOCOLS, long bitmask);
.fi
.SH DESCRIPTION
This option is deprecated. We strongly recommend using
\fICURLOPT_REDIR_PROTOCOLS_STR(3)\fP instead because this option cannot
control all available protocols!
Pass a long that holds a bitmask of CURLPROTO_* defines. If used, this bitmask
limits what protocols libcurl may use in a transfer that it follows to in a
redirect when \fICURLOPT_FOLLOWLOCATION(3)\fP is enabled. This allows you to
limit specific transfers to only be allowed to use a subset of protocols in
redirections.
Protocols denied by \fICURLOPT_PROTOCOLS(3)\fP are not overridden by this
option.
By default libcurl allows HTTP, HTTPS, FTP and FTPS on redirect (7.65.2).
\fICURLPROTO_ALL\fP enables all protocols on redirect, including those
otherwise disabled for security.
These are the available protocol defines:
.nf
CURLPROTO_DICT
CURLPROTO_FILE
CURLPROTO_FTP
CURLPROTO_FTPS
CURLPROTO_GOPHER
CURLPROTO_HTTP
CURLPROTO_HTTPS
CURLPROTO_IMAP
CURLPROTO_IMAPS
CURLPROTO_LDAP
CURLPROTO_LDAPS
CURLPROTO_POP3
CURLPROTO_POP3S
CURLPROTO_RTMP
CURLPROTO_RTMPE
CURLPROTO_RTMPS
CURLPROTO_RTMPT
CURLPROTO_RTMPTE
CURLPROTO_RTMPTS
CURLPROTO_RTSP
CURLPROTO_SCP
CURLPROTO_SFTP
CURLPROTO_SMB
CURLPROTO_SMBS
CURLPROTO_SMTP
CURLPROTO_SMTPS
CURLPROTO_TELNET
CURLPROTO_TFTP
.fi
.SH DEFAULT
HTTP, HTTPS, FTP and FTPS (Added in 7.65.2).
Older versions defaulted to all protocols except FILE, SCP and since 7.40.0
SMB and SMBS.
.SH PROTOCOLS
All
.SH EXAMPLE
.nf
curl = curl_easy_init();
if(curl) {
/* pass in the URL from an external source */
curl_easy_setopt(curl, CURLOPT_URL, argv[1]);
/* only allow redirects to HTTP and HTTPS URLs */
curl_easy_setopt(curl, CURLOPT_REDIR_PROTOCOLS,
CURLPROTO_HTTP | CURLPROTO_HTTPS);
/* Perform the request */
curl_easy_perform(curl);
}
.fi
.SH AVAILABILITY
Added in 7.19.4, before then it would follow all protocols. Deprecated
since 7.85.0.
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR CURLINFO_SCHEME (3),
.BR CURLOPT_DEFAULT_PROTOCOL (3),
.BR CURLOPT_PROTOCOLS (3),
.BR CURLOPT_REDIR_PROTOCOLS_STR (3)
man/man3/CURLOPT_SSL_CIPHER_LIST.3 0000644 00000006620 14751172372 0012014 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_SSL_CIPHER_LIST 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_SSL_CIPHER_LIST \- ciphers to use for TLS
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_SSL_CIPHER_LIST, char *list);
.fi
.SH DESCRIPTION
Pass a char *, pointing to a null-terminated string holding the list of
ciphers to use for the SSL connection. The list must be syntactically correct,
it consists of one or more cipher strings separated by colons. Commas or
spaces are also acceptable separators but colons are normally used, \&!, \&-
and \&+ can be used as operators.
For OpenSSL and GnuTLS valid examples of cipher lists include \fBRC4-SHA\fP,
\fBSHA1+DES\fP, \fBTLSv1\fP and \fBDEFAULT\fP. The default list is normally
set when you compile OpenSSL.
For WolfSSL, valid examples of cipher lists include \fBECDHE-RSA-RC4-SHA\fP,
\fBAES256-SHA:AES256-SHA256\fP, etc.
For BearSSL, valid examples of cipher lists include
\fBECDHE-RSA-CHACHA20-POLY1305:ECDHE-RSA-AES128-GCM-SHA256\fP, or when using IANA names
\fBTLS_ECDHE_RSA_WITH_CHACHA20_POLY1305_SHA256:TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256\fP,
etc.
With BearSSL you do not add/remove ciphers. If one uses this option then all
known ciphers are disabled and only those passed in are enabled.
For Schannel, you can use this option to set algorithms but not specific cipher
suites. Refer to the ciphers lists document for algorithms.
Find more details about cipher lists on this URL:
https://curl.se/docs/ssl-ciphers.html
The application does not have to keep the string around after setting this
option.
.SH DEFAULT
NULL, use internal default
.SH PROTOCOLS
All TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc.
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/");
curl_easy_setopt(curl, CURLOPT_SSL_CIPHER_LIST, "TLSv1");
ret = curl_easy_perform(curl);
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Added in 7.9, in 7.83.0 for BearSSL
If built TLS enabled.
.SH RETURN VALUE
Returns CURLE_OK if TLS is supported, CURLE_UNKNOWN_OPTION if not, or
CURLE_OUT_OF_MEMORY if there was insufficient heap space.
.SH "SEE ALSO"
.BR CURLOPT_TLS13_CIPHERS (3),
.BR CURLOPT_SSLVERSION (3),
.BR CURLOPT_PROXY_SSL_CIPHER_LIST (3),
.BR CURLOPT_PROXY_TLS13_CIPHERS (3),
.BR CURLOPT_USE_SSL (3)
man/man3/CURLOPT_SSH_KEYDATA.3 0000644 00000004634 14751172372 0011270 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_SSH_KEYDATA 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_SSH_KEYDATA \- pointer passed to the SSH key callback
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_SSH_KEYDATA, void *pointer);
.fi
.SH DESCRIPTION
Pass a void * as parameter. This \fIpointer\fP is passed along verbatim to the
callback set with \fICURLOPT_SSH_KEYFUNCTION(3)\fP.
.SH DEFAULT
NULL
.SH PROTOCOLS
SFTP and SCP
.SH EXAMPLE
.nf
static int keycb(CURL *easy,
const struct curl_khkey *knownkey,
const struct curl_khkey *foundkey,
enum curl_khmatch match,
void *clientp)
{
/* 'clientp' points to the callback_data struct */
/* investigate the situation and return the correct value */
return CURLKHSTAT_FINE_ADD_TO_FILE;
}
{
curl_easy_setopt(curl, CURLOPT_URL, "sftp://example.com/thisfile.txt");
curl_easy_setopt(curl, CURLOPT_SSH_KEYFUNCTION, keycb);
curl_easy_setopt(curl, CURLOPT_SSH_KEYDATA, &callback_data);
curl_easy_setopt(curl, CURLOPT_SSH_KNOWNHOSTS, "/home/user/known_hosts");
curl_easy_perform(curl);
}
.fi
.SH AVAILABILITY
Added in 7.19.6
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR CURLOPT_SSH_KEYDATA (3),
.BR CURLOPT_SSH_KNOWNHOSTS (3)
man/man3/CURLOPT_SOCKOPTDATA.3 0000644 00000004707 14751172372 0011246 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_SOCKOPTDATA 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_SOCKOPTDATA \- pointer to pass to sockopt callback
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_SOCKOPTDATA, void *pointer);
.fi
.SH DESCRIPTION
Pass a \fIpointer\fP that is untouched by libcurl and passed as the first
argument in the sockopt callback set with \fICURLOPT_SOCKOPTFUNCTION(3)\fP.
.SH DEFAULT
The default value of this parameter is NULL.
.SH PROTOCOLS
All
.SH EXAMPLE
.nf
static int sockopt_callback(void *clientp, curl_socket_t curlfd,
curlsocktype purpose)
{
int val = *(int *)clientp;
setsockopt(curldfd, SOL_SOCKET, SO_RCVBUF, (const char *)&val, sizeof(val));
return CURL_SOCKOPT_OK;
}
curl = curl_easy_init();
if(curl) {
int recvbuffersize = 256 * 1024;
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/");
/* call this function to set options for the socket */
curl_easy_setopt(curl, CURLOPT_SOCKOPTFUNCTION, sockopt_callback);
curl_easy_setopt(curl, CURLOPT_SOCKOPTDATA, &recvbuffersize);
res = curl_easy_perform(curl);
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Added in 7.16.0
.SH RETURN VALUE
Returns \fICURLE_OK\fP if the option is supported, and \fICURLE_UNKNOWN_OPTION\fP if not.
.SH "SEE ALSO"
.BR CURLOPT_OPENSOCKETFUNCTION (3),
.BR CURLOPT_SOCKOPTFUNCTION (3)
man/man3/CURLINFO_REDIRECT_COUNT.3 0000644 00000004171 14751172372 0011727 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLINFO_REDIRECT_COUNT 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLINFO_REDIRECT_COUNT \- get the number of redirects
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_getinfo(CURL *handle, CURLINFO_REDIRECT_COUNT,
long *countp);
.fi
.SH DESCRIPTION
Pass a pointer to a long to receive the total number of redirections that were
actually followed.
.SH PROTOCOLS
HTTP(S)
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
CURLcode res;
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
curl_easy_setopt(curl, CURLOPT_FOLLOWLOCATION, 1L);
res = curl_easy_perform(curl);
if(res == CURLE_OK) {
long redirects;
curl_easy_getinfo(curl, CURLINFO_REDIRECT_COUNT, &redirects);
}
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Added in 7.9.7
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR curl_easy_getinfo (3),
.BR curl_easy_setopt (3),
.BR CURLINFO_REDIRECT_URL (3),
.BR CURLOPT_FOLLOWLOCATION (3)
man/man3/CURLOPT_FTP_ACCOUNT.3 0000644 00000004241 14751172372 0011270 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_FTP_ACCOUNT 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_FTP_ACCOUNT \- account info for FTP
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_FTP_ACCOUNT, char *account);
.fi
.SH DESCRIPTION
Pass a pointer to a null-terminated string (or NULL to disable). When an FTP
server asks for "account data" after user name and password has been provided,
this data is sent off using the ACCT command.
The application does not have to keep the string around after setting this
option.
.SH DEFAULT
NULL
.SH PROTOCOLS
FTP
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "ftp://example.com/foo.bin");
curl_easy_setopt(curl, CURLOPT_FTP_ACCOUNT, "human-resources");
ret = curl_easy_perform(curl);
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Added in 7.13.0
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, CURLE_UNKNOWN_OPTION if not, or
CURLE_OUT_OF_MEMORY if there was insufficient heap space.
.SH "SEE ALSO"
.BR CURLOPT_PASSWORD (3),
.BR CURLOPT_USERNAME (3)
man/man3/curl_share_cleanup.3 0000644 00000004141 14751172372 0012110 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.TH curl_share_cleanup 3 "September 27, 2023" "libcurl 8.4.0" "libcurl"
.SH NAME
curl_share_cleanup - Clean up a shared object
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLSHcode curl_share_cleanup(CURLSH *share_handle);
.fi
.SH DESCRIPTION
This function deletes a shared object. The share handle cannot be used anymore
when this function has been called.
Passing in a NULL pointer in \fIshare_handle\fP makes this function return
immediately with no action.
.SH EXAMPLE
.nf
CURLSHcode sh;
share = curl_share_init();
sh = curl_share_setopt(share, CURLSHOPT_SHARE, CURL_LOCK_DATA_CONNECT);
/* use the share, then ... */
curl_share_cleanup(share);
.fi
.SH AVAILABILITY
Added in 7.10
.SH RETURN VALUE
CURLSHE_OK (zero) means that the option was set properly, non-zero means an
error occurred as \fI<curl/curl.h>\fP defines. See the \fIlibcurl-errors(3)\fP
man page for the full list with descriptions. If an error occurs, then the
share object is not deleted.
.SH "SEE ALSO"
.BR curl_share_init (3),
.BR curl_share_setopt (3)
man/man3/CURLINFO_XFER_ID.3 0000644 00000004501 14751172372 0010673 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLINFO_XFER_ID 3 "September 26, 2023" "libcurl 8.4.0" "libcurl"
.SH NAME
CURLINFO_XFER_ID \- get the ID of a transfer
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_getinfo(CURL *handle, CURLINFO_XFER_ID,
curl_off_t *xfer_id);
.fi
.SH DESCRIPTION
Pass a pointer to a \fIcurl_off_t\fP to receive the identifier of the
current/last transfer done with the handle. Stores -1 if no transfer
has been started yet for the handle.
The transfer id is unique among all transfers performed using the same
connection cache. This is implicitly the case for all transfers in the
same multi handle.
.SH PROTOCOLS
All
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
/* Perform the request */
res = curl_easy_perform(curl);
if(!res) {
curl_off_t xfer_id;
res = curl_easy_getinfo(curl, CURLINFO_XFER_ID, &xfer_id);
if(!res) {
printf("Transfer ID: %" CURL_FORMAT_CURL_OFF_T "\\n", xfer_id);
}
}
}
.fi
.SH AVAILABILITY
Added in 8.2.0
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR curl_easy_getinfo (3),
.BR curl_easy_setopt (3),
.BR CURLINFO_CONN_ID (3)
man/man3/curl_multi_init.3 0000644 00000004116 14751172372 0011456 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.TH curl_multi_init 3 "September 26, 2023" "libcurl 8.4.0" "libcurl"
.SH NAME
curl_multi_init - create a multi handle
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLM *curl_multi_init();
.fi
.SH DESCRIPTION
This function returns a pointer to a \fICURLM\fP handle to be used as input to
all the other multi-functions, sometimes referred to as a multi handle in some
places in the documentation. This init call MUST have a corresponding call to
\fIcurl_multi_cleanup(3)\fP when the operation is complete.
.SH EXAMPLE
.nf
/* init a multi stack */
multi_handle = curl_multi_init();
/* add individual transfers */
curl_multi_add_handle(multi_handle, http_handle);
curl_multi_add_handle(multi_handle, http_handle2);
.fi
.SH AVAILABILITY
Added in 7.9.6
.SH RETURN VALUE
If this function returns NULL, something went wrong and you cannot use the
other curl functions.
.SH "SEE ALSO"
.BR curl_multi_cleanup (3),
.BR curl_multi_add_handle (3),
.BR curl_multi_get_handles (3),
.BR curl_global_init (3),
.BR curl_easy_init (3)
man/man3/CURLOPT_HEADER.3 0000644 00000005171 14751172372 0010416 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_HEADER 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_HEADER \- pass headers to the data stream
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_HEADER, long onoff);
.fi
.SH DESCRIPTION
Pass the long value \fIonoff\fP set to 1 to ask libcurl to include the headers
in the write callback (\fICURLOPT_WRITEFUNCTION(3)\fP). This option is
relevant for protocols that actually have headers or other meta-data (like
HTTP and FTP).
When asking to get the headers passed to the same callback as the body, it is
not possible to accurately separate them again without detailed knowledge
about the protocol in use.
Further: the \fICURLOPT_WRITEFUNCTION(3)\fP callback is limited to only ever
get a maximum of \fICURL_MAX_WRITE_SIZE\fP bytes passed to it (16KB), while a
header can be longer and the \fICURLOPT_HEADERFUNCTION(3)\fP supports getting
called with headers up to \fICURL_MAX_HTTP_HEADER\fP bytes big (100KB).
It is often better to use \fICURLOPT_HEADERFUNCTION(3)\fP to get the header
data separately.
While named confusingly similar, \fICURLOPT_HTTPHEADER(3)\fP is used to set
custom HTTP headers!
.SH DEFAULT
0
.SH PROTOCOLS
Most
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
curl_easy_setopt(curl, CURLOPT_HEADER, 1L);
curl_easy_perform(curl);
}
.fi
.SH AVAILABILITY
Provided in all libcurl versions.
.SH RETURN VALUE
Returns CURLE_OK.
.SH "SEE ALSO"
.BR CURLOPT_HEADERFUNCTION (3),
.BR CURLOPT_HTTPHEADER (3)
man/man3/curl_share_setopt.3 0000644 00000004316 14751172372 0012003 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.TH curl_share_setopt 3 "September 27, 2023" "libcurl 8.4.0" "libcurl"
.SH NAME
curl_share_setopt - Set options for a shared object
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLSHcode curl_share_setopt(CURLSH *share, CURLSHoption option, parameter);
.fi
.SH DESCRIPTION
Set the \fIoption\fP to \fIparameter\fP for the given \fIshare\fP.
.SH OPTIONS
.IP CURLSHOPT_LOCKFUNC
See \fICURLSHOPT_LOCKFUNC(3)\fP.
.IP CURLSHOPT_UNLOCKFUNC
See \fICURLSHOPT_UNLOCKFUNC(3)\fP.
.IP CURLSHOPT_SHARE
See \fICURLSHOPT_SHARE(3)\fP.
.IP CURLSHOPT_UNSHARE
See \fICURLSHOPT_UNSHARE(3)\fP.
.IP CURLSHOPT_USERDATA
See \fICURLSHOPT_USERDATA(3)\fP.
.SH EXAMPLE
.nf
CURLSHcode sh;
share = curl_share_init();
sh = curl_share_setopt(share, CURLSHOPT_SHARE, CURL_LOCK_DATA_CONNECT);
if(sh)
printf("Error: %s\\n", curl_share_strerror(sh));
.fi
.SH AVAILABILITY
Added in 7.10
.SH RETURN VALUE
CURLSHE_OK (zero) means that the option was set properly, non-zero means an
error occurred as \fI<curl/curl.h>\fP defines. See the \fIlibcurl-errors(3)\fP
man page for the full list with descriptions.
.SH "SEE ALSO"
.BR curl_share_cleanup (3),
.BR curl_share_init (3)
man/man3/CURLOPT_PROGRESSFUNCTION.3 0000644 00000010411 14751172372 0012071 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_PROGRESSFUNCTION 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_PROGRESSFUNCTION \- progress meter callback
.SH SYNOPSIS
.nf
#include <curl/curl.h>
int progress_callback(void *clientp,
double dltotal,
double dlnow,
double ultotal,
double ulnow);
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_PROGRESSFUNCTION,
progress_callback);
.fi
.SH DESCRIPTION
Pass a pointer to your callback function, which should match the prototype
shown above.
This option is deprecated and we encourage users to use the
newer \fICURLOPT_XFERINFOFUNCTION(3)\fP instead, if you can.
This function gets called by libcurl instead of its internal equivalent with a
frequent interval. While data is being transferred it is invoked frequently,
and during slow periods like when nothing is being transferred it can slow
down to about one call per second.
\fIclientp\fP is the pointer set with \fICURLOPT_PROGRESSDATA(3)\fP, it is not
used by libcurl but is only passed along from the application to the callback.
The callback gets told how much data libcurl is about to transfer and has
transferred, in number of bytes. \fIdltotal\fP is the total number of bytes
libcurl expects to download in this transfer. \fIdlnow\fP is the number of
bytes downloaded so far. \fIultotal\fP is the total number of bytes libcurl
expects to upload in this transfer. \fIulnow\fP is the number of bytes
uploaded so far.
Unknown/unused argument values passed to the callback are be set to zero (like
if you only download data, the upload size remains 0). Many times the callback
is called one or more times first, before it knows the data sizes so a program
must be made to handle that.
If your callback function returns CURL_PROGRESSFUNC_CONTINUE it causes libcurl
to continue executing the default progress function.
Returning any other non-zero value from this callback makes libcurl abort the
transfer and return \fICURLE_ABORTED_BY_CALLBACK\fP.
If you transfer data with the multi interface, this function is not called
during periods of idleness unless you call the appropriate libcurl function
that performs transfers.
\fICURLOPT_NOPROGRESS(3)\fP must be set to 0 to make this function actually
get called.
.SH DEFAULT
By default, libcurl has an internal progress meter. That is rarely wanted by
users.
.SH PROTOCOLS
All
.SH EXAMPLE
.nf
struct progress {
char *private;
size_t size;
};
static size_t progress_callback(void *clientp,
double dltotal,
double dlnow,
double ultotal,
double ulnow)
{
struct progress *memory = (struct progress *)clientp;
/* use the values */
return 0; /* all is good */
}
struct progress data;
/* pass struct to callback */
curl_easy_setopt(curl_handle, CURLOPT_PROGRESSDATA, &data);
curl_easy_setopt(curl_handle, CURLOPT_PROGRESSFUNCTION, progress_callback);
.fi
.SH AVAILABILITY
Deprecated since 7.32.0.
.SH RETURN VALUE
Returns CURLE_OK.
.SH "SEE ALSO"
.BR CURLOPT_VERBOSE (3),
.BR CURLOPT_NOPROGRESS (3),
.BR CURLOPT_XFERINFOFUNCTION (3)
man/man3/CURLSHOPT_UNLOCKFUNC.3 0000644 00000005104 14751172372 0011364 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.TH CURLSHOPT_UNLOCKFUNC 3 "September 27, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLSHOPT_UNLOCKFUNC - mutex unlock callback
.SH SYNOPSIS
.nf
#include <curl/curl.h>
void unlockcb(CURL *handle, curl_lock_data data, void *clientp);
CURLSHcode curl_share_setopt(CURLSH *share, CURLSHOPT_UNLOCKFUNC, unlockcb);
.fi
.SH DESCRIPTION
Set a mutex unlock callback for the share object. There is a corresponding
\fICURLSHOPT_LOCKFUNC(3)\fP callback called when the mutex is first locked.
The \fIunlockcb\fP argument must be a pointer to a function matching the
prototype shown above. The arguments to the callback are:
\fIhandle\fP is the currently active easy handle in use when the share object
is released.
The \fIdata\fP argument tells what kind of data libcurl wants to unlock. Make
sure that the callback uses a different lock for each kind of data.
\fIclientp\fP is the private pointer you set with \fICURLSHOPT_USERDATA(3)\fP.
This pointer is not used by libcurl itself.
.SH PROTOCOLS
All
.SH EXAMPLE
.nf
CURLSHcode sh;
share = curl_share_init();
sh = curl_share_setopt(share, CURLSHOPT_UNLOCKFUNC, mutex_unlock);
if(sh)
printf("Error: %s\\n", curl_share_strerror(sh));
.fi
.SH AVAILABILITY
Added in 7.10
.SH RETURN VALUE
CURLSHE_OK (zero) means that the option was set properly, non-zero means an
error occurred. See \fIlibcurl-errors(3)\fP for the full list with
descriptions.
.SH "SEE ALSO"
.BR curl_share_cleanup (3),
.BR curl_share_init (3),
.BR curl_share_setopt (3),
.BR CURLSHOPT_LOCKFUNC (3)
man/man3/CURLOPT_SSL_VERIFYSTATUS.3 0000644 00000004576 14751172372 0012167 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_SSL_VERIFYSTATUS 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_SSL_VERIFYSTATUS \- verify the certificate's status
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_SSL_VERIFYSTATUS, long verify);
.fi
.SH DESCRIPTION
Pass a long as parameter set to 1 to enable or 0 to disable.
This option determines whether libcurl verifies the status of the server cert
using the "Certificate Status Request" TLS extension (aka. OCSP stapling).
Note that if this option is enabled but the server does not support the TLS
extension, the verification fails.
.SH DEFAULT
0
.SH PROTOCOLS
All TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc.
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/");
/* ask for OCSP stapling! */
curl_easy_setopt(curl, CURLOPT_SSL_VERIFYSTATUS, 1L);
ret = curl_easy_perform(curl);
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Added in 7.41.0. This option is currently only supported by the OpenSSL and
GnuTLS TLS backends.
.SH RETURN VALUE
Returns CURLE_OK if OCSP stapling is supported by the SSL backend, otherwise
returns CURLE_NOT_BUILT_IN.
.SH "SEE ALSO"
.BR CURLOPT_SSL_VERIFYHOST (3),
.BR CURLOPT_SSL_VERIFYPEER (3),
.BR CURLOPT_CAINFO (3)
man/man3/CURLINFO_PRETRANSFER_TIME_T.3 0000644 00000005226 14751172372 0012454 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLINFO_PRETRANSFER_TIME_T 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLINFO_PRETRANSFER_TIME_T \- get the time until the file transfer start
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_getinfo(CURL *handle, CURLINFO_PRETRANSFER_TIME_T,
curl_off_t *timep);
.fi
.SH DESCRIPTION
Pass a pointer to a curl_off_t to receive the time, in microseconds,
it took from the
start until the file transfer is just about to begin. This includes all
pre-transfer commands and negotiations that are specific to the particular
protocol(s) involved. It does \fInot\fP involve the sending of the protocol-
specific request that triggers a transfer.
When a redirect is followed, the time from each request is added together.
See also the TIMES overview in the \fIcurl_easy_getinfo(3)\fP man page.
.SH PROTOCOLS
All
.SH EXAMPLE
.nf
curl = curl_easy_init();
if(curl) {
curl_off_t pretransfer;
curl_easy_setopt(curl, CURLOPT_URL, url);
res = curl_easy_perform(curl);
if(CURLE_OK == res) {
res = curl_easy_getinfo(curl, CURLINFO_PRETRANSFER_TIME_T, &pretransfer);
if(CURLE_OK == res) {
printf("Time: %" CURL_FORMAT_CURL_OFF_T ".%06ld", pretransfer / 1000000,
(long)(pretransfer % 1000000));
}
}
/* always cleanup */
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Added in 7.61.0
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR curl_easy_getinfo (3),
.BR curl_easy_setopt (3),
.BR CURLINFO_CONNECT_TIME (3),
.BR CURLINFO_PRETRANSFER_TIME_T (3)
man/man3/libcurl-multi.3 0000644 00000022220 14751172372 0011034 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH libcurl-multi 3 "September 26, 2023" "libcurl 8.4.0" "libcurl"
.SH NAME
libcurl-multi \- how to use the multi interface
.SH DESCRIPTION
This is an overview on how to use the libcurl multi interface in your C
programs. There are specific man pages for each function mentioned in
here. There is also the \fIlibcurl-tutorial(3)\fP man page for a complete
tutorial to programming with libcurl and the \fIlibcurl-easy(3)\fP man page
for an overview of the libcurl easy interface.
All functions in the multi interface are prefixed with curl_multi.
.SH "OBJECTIVES"
The multi interface offers several abilities that the easy interface does not.
They are mainly:
1. Enable a "pull" interface. The application that uses libcurl decides where
and when to ask libcurl to get/send data.
2. Enable multiple simultaneous transfers in the same thread without making it
complicated for the application.
3. Enable the application to wait for action on its own file descriptors and
curl's file descriptors simultaneously.
4. Enable event-based handling and scaling transfers up to and beyond
thousands of parallel connections.
.SH "ONE MULTI HANDLE MANY EASY HANDLES"
To use the multi interface, you must first create a 'multi handle' with
\fIcurl_multi_init(3)\fP. This handle is then used as input to all further
curl_multi_* functions.
With a multi handle and the multi interface you can do several simultaneous
transfers in parallel. Each single transfer is built up around an easy
handle. You create all the easy handles you need, and setup the appropriate
options for each easy handle using \fIcurl_easy_setopt(3)\fP.
There are two flavors of the multi interface, the select() oriented one and
the event based one we call multi_socket. You benefit from reading through the
description of both versions to fully understand how they work and
differentiate. We start out with the select() oriented version.
When an easy handle is setup and ready for transfer, then instead of using
\fIcurl_easy_perform(3)\fP like when using the easy interface for transfers,
you should add the easy handle to the multi handle with
\fIcurl_multi_add_handle(3)\fP. You can add more easy handles to a multi
handle at any point, even if other transfers are already running.
Should you change your mind, the easy handle is again removed from the multi
stack using \fIcurl_multi_remove_handle(3)\fP. Once removed from the multi
handle, you can again use other easy interface functions like
\fIcurl_easy_perform(3)\fP on the handle or whatever you think is
necessary. You can remove handles at any point during transfers.
Adding the easy handle to the multi handle does not start the transfer.
Remember that one of the main ideas with this interface is to let your
application drive. You drive the transfers by invoking
\fIcurl_multi_perform(3)\fP. libcurl then transfers data if there is anything
available to transfer. It uses the callbacks and everything else you have
setup in the individual easy handles. It transfers data on all current
transfers in the multi stack that are ready to transfer anything. It may be
all, it may be none. When there is nothing more to do for now, it returns back
to the calling application.
Your application extracts info from libcurl about when it would like to get
invoked to transfer data or do other work. The most convenient way is to use
\fIcurl_multi_poll(3)\fP that helps you wait until the application should call
libcurl again. The older API to accomplish the same thing is
\fIcurl_multi_fdset(3)\fP that extracts \fIfd_sets\fP from libcurl to use in
select() or poll() calls in order to get to know when the transfers in the
multi stack might need attention. Both these APIs allow for your program to
wait for input on your own private file descriptors at the same time.
\fIcurl_multi_timeout(3)\fP also helps you with providing a suitable timeout
period for your select() calls.
\fIcurl_multi_perform(3)\fP stores the number of still running transfers in
one of its input arguments, and by reading that you can figure out when all
the transfers in the multi handles are done. 'done' does not mean
successful. One or more of the transfers may have failed.
To get information about completed transfers, to figure out success or not and
similar, \fIcurl_multi_info_read(3)\fP should be called. It can return a
message about a current or previous transfer. Repeated invokes of the function
get more messages until the message queue is empty. The information you
receive there includes an easy handle pointer which you may use to identify
which easy handle the information regards.
When a single transfer is completed, the easy handle is still left added to
the multi stack. You need to first remove the easy handle with
\fIcurl_multi_remove_handle(3)\fP and then close it with
\fIcurl_easy_cleanup(3)\fP, or possibly set new options to it and add it again
with \fIcurl_multi_add_handle(3)\fP to start another transfer.
When all transfers in the multi stack are done, close the multi handle with
\fIcurl_multi_cleanup(3)\fP. Be careful and please note that you \fBMUST\fP
invoke separate \fIcurl_easy_cleanup(3)\fP calls for every single easy handle
to clean them up properly.
If you want to reuse an easy handle that was added to the multi handle for
transfer, you must first remove it from the multi stack and then re-add it
again (possibly after having altered some options at your own choice).
.SH "MULTI_SOCKET"
\fIcurl_multi_socket_action(3)\fP function offers a way for applications to
not only avoid being forced to use select(), but it also offers a much more
high-performance API that makes a significant difference for applications
using large numbers of simultaneous connections.
\fIcurl_multi_socket_action(3)\fP is then used instead of
\fIcurl_multi_perform(3)\fP.
When using this API, you add easy handles to the multi handle just as with the
normal multi interface. Then you also set two callbacks with the
\fICURLMOPT_SOCKETFUNCTION(3)\fP and \fICURLMOPT_TIMERFUNCTION(3)\fP options
to \fIcurl_multi_setopt(3)\fP. They are two callback functions that libcurl
calls with information about what sockets to wait for, and for what activity,
and what the current timeout time is - if that expires libcurl should be
notified.
The multi_socket API is designed to inform your application about which
sockets libcurl is currently using and for what activities (read and/or write)
on those sockets your application is expected to wait for.
Your application must make sure to receive all sockets informed about in the
\fICURLMOPT_SOCKETFUNCTION(3)\fP callback and make sure it reacts on the given
activity on them. When a socket has the given activity, you call
\fIcurl_multi_socket_action(3)\fP specifying which socket and action there
are.
The \fICURLMOPT_TIMERFUNCTION(3)\fP callback is called to set a timeout. When
that timeout expires, your application should call the
\fIcurl_multi_socket_action(3)\fP function saying it was due to a timeout.
This API is typically used with an event-driven underlying functionality (like
libevent, libev, kqueue, epoll or similar) with which the application
"subscribes" on socket changes. This allows applications and libcurl to much
better scale upward and beyond thousands of simultaneous transfers without
losing performance.
When you have added your initial set of handles, you call
\fIcurl_multi_socket_action(3)\fP with CURL_SOCKET_TIMEOUT set in the
\fIsockfd\fP argument, and you get callbacks invoked that set you up and you
then continue to call \fIcurl_multi_socket_action(3)\fP accordingly when you
get activity on the sockets you have been asked to wait on, or if the timeout
timer expires.
You can poll \fIcurl_multi_info_read(3)\fP to see if any transfer has
completed, as it then has a message saying so.
.SH "BLOCKING"
A few areas in the code are still using blocking code, even when used from the
multi interface. While we certainly want and intend for these to get fixed in
the future, you should be aware of the following current restrictions:
.nf
- Name resolves unless the c-ares or threaded-resolver backends are used
- file:// transfers
- TELNET transfers
.fi
.SH "SEE ALSO"
.BR libcurl-errors (3),
.BR libcurl-easy (3),
.BR libcurl (3)
man/man3/CURLOPT_HTTP09_ALLOWED.3 0000644 00000004361 14751172372 0011565 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_HTTP09_ALLOWED 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_HTTP09_ALLOWED \- allow HTTP/0.9 response
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_HTTP09_ALLOWED, long allowed);
.fi
.SH DESCRIPTION
Pass the long argument \fIallowed\fP set to 1L to allow HTTP/0.9 responses.
An HTTP/0.9 response is a server response entirely without headers and only a
body. You can connect to lots of random TCP services and still get a response
that curl might consider to be HTTP/0.9!
.SH DEFAULT
curl allowed HTTP/0.9 responses by default before 7.66.0
Since 7.66.0, libcurl requires this option set to 1L to allow HTTP/0.9
responses.
.SH PROTOCOLS
HTTP
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
CURLcode ret;
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/");
curl_easy_setopt(curl, CURLOPT_HTTP09_ALLOWED, 1L);
ret = curl_easy_perform(curl);
}
.fi
.SH AVAILABILITY
Option added in 7.64.0, present along with HTTP.
.SH RETURN VALUE
Returns CURLE_OK if HTTP is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR CURLOPT_HTTP_VERSION (3),
.BR CURLOPT_SSLVERSION (3)
man/man3/CURLINFO_RTSP_CLIENT_CSEQ.3 0000644 00000004110 14751172372 0012210 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLINFO_RTSP_CLIENT_CSEQ 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLINFO_RTSP_CLIENT_CSEQ \- get the next RTSP client CSeq
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_getinfo(CURL *handle, CURLINFO_RTSP_CLIENT_CSEQ,
long *cseq);
.fi
.SH DESCRIPTION
Pass a pointer to a long to receive the next CSeq that is expected to be used
by the application.
.SH PROTOCOLS
RTSP
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
CURLcode res;
curl_easy_setopt(curl, CURLOPT_URL, "rtsp://rtsp.example.com");
res = curl_easy_perform(curl);
if(res == CURLE_OK) {
long cseq;
curl_easy_getinfo(curl, CURLINFO_RTSP_CLIENT_CSEQ, &cseq);
}
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Added in 7.20.0
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR curl_easy_getinfo (3),
.BR curl_easy_setopt (3),
.BR CURLINFO_RTSP_CSEQ_RECV (3),
.BR CURLINFO_RTSP_SERVER_CSEQ (3)
man/man3/curl_mime_init.3 0000644 00000005342 14751172372 0011255 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.TH curl_mime_init 3 "September 26, 2023" "libcurl 8.4.0" "libcurl"
.SH NAME
curl_mime_init - create a mime handle
.SH SYNOPSIS
.nf
#include <curl/curl.h>
curl_mime *curl_mime_init(CURL *easy_handle);
.fi
.SH DESCRIPTION
\fIcurl_mime_init(3)\fP creates a handle to a new empty mime structure.
This mime structure can be subsequently filled using the mime API, then
attached to some easy handle using option \fICURLOPT_MIMEPOST(3)\fP within
a \fIcurl_easy_setopt(3)\fP call or added as a multipart in another mime
handle's part using \fIcurl_mime_subparts(3)\fP.
\fIeasy_handle\fP is used for part separator randomization and error
reporting. Since 7.87.0, it does not need to be the final target handle.
Using a mime handle is the recommended way to post an HTTP form, format and
send a multi-part email with SMTP or upload such an email to an IMAP server.
.SH EXAMPLE
.nf
CURL *easy = curl_easy_init();
curl_mime *mime;
curl_mimepart *part;
/* Build an HTTP form with a single field named "data", */
mime = curl_mime_init(easy);
part = curl_mime_addpart(mime);
curl_mime_data(part, "This is the field data", CURL_ZERO_TERMINATED);
curl_mime_name(part, "data");
/* Post and send it. */
curl_easy_setopt(easy, CURLOPT_MIMEPOST, mime);
curl_easy_setopt(easy, CURLOPT_URL, "https://example.com");
curl_easy_perform(easy);
/* Clean-up. */
curl_easy_cleanup(easy);
curl_mime_free(mime);
.SH AVAILABILITY
As long as at least one of HTTP, SMTP or IMAP is enabled. Added in 7.56.0.
.SH RETURN VALUE
A mime struct handle, or NULL upon failure.
.SH "SEE ALSO"
.BR curl_mime_addpart (3),
.BR curl_mime_free (3),
.BR curl_mime_subparts (3),
.BR CURLOPT_MIMEPOST (3)
man/man3/CURLOPT_NEW_DIRECTORY_PERMS.3 0000644 00000004444 14751172372 0012513 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_NEW_DIRECTORY_PERMS 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_NEW_DIRECTORY_PERMS \- permissions for remotely created directories
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_NEW_DIRECTORY_PERMS,
long mode);
.SH DESCRIPTION
Pass a long as a parameter, containing the value of the permissions that is
set on newly created directories on the remote server. The default value is
\fI0755\fP, but any valid value can be used. The only protocols that can use
this are \fIsftp://\fP, \fIscp://\fP, and \fIfile://\fP.
.SH DEFAULT
0755
.SH PROTOCOLS
SFTP, SCP and FILE
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
CURLcode ret;
curl_easy_setopt(curl, CURLOPT_URL, "sftp://upload.example.com/newdir/file.zip");
curl_easy_setopt(curl, CURLOPT_FTP_CREATE_MISSING_DIRS, 1L);
curl_easy_setopt(curl, CURLOPT_NEW_DIRECTORY_PERMS, 0644L);
ret = curl_easy_perform(curl);
}
.fi
.SH AVAILABILITY
Added in 7.16.4
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR CURLOPT_FTP_CREATE_MISSING_DIRS (3),
.BR CURLOPT_NEW_FILE_PERMS (3),
.BR CURLOPT_UPLOAD (3)
man/man3/CURLOPT_TIMEOUT_MS.3 0000644 00000004126 14751172372 0011212 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_TIMEOUT_MS 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_TIMEOUT_MS \- maximum time the transfer is allowed to complete
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_TIMEOUT_MS, long timeout);
.fi
.SH DESCRIPTION
Pass a long as parameter containing \fItimeout\fP - the maximum time in
milliseconds that you allow the libcurl transfer operation to take.
See \fICURLOPT_TIMEOUT(3)\fP for details.
.SH DEFAULT
Default timeout is 0 (zero) which means it never times out during transfer.
.SH PROTOCOLS
All
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
/* complete within 20000 milliseconds */
curl_easy_setopt(curl, CURLOPT_TIMEOUT_MS, 20000L);
curl_easy_perform(curl);
}
.fi
.SH AVAILABILITY
Always
.SH RETURN VALUE
Returns CURLE_OK
.SH "SEE ALSO"
.BR CURLOPT_CONNECTTIMEOUT (3),
.BR CURLOPT_LOW_SPEED_LIMIT (3),
.BR CURLOPT_TCP_KEEPALIVE (3),
.BR CURLOPT_TIMEOUT (3)
man/man3/CURLOPT_SOCKS5_GSSAPI_SERVICE.3 0000644 00000004610 14751172372 0012660 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_SOCKS5_GSSAPI_SERVICE 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_SOCKS5_GSSAPI_SERVICE \- SOCKS5 proxy authentication service name
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_SOCKS5_GSSAPI_SERVICE,
char *name);
.fi
.SH DESCRIPTION
Deprecated since 7.49.0. Use \fICURLOPT_PROXY_SERVICE_NAME(3)\fP instead.
Pass a \fBchar *\fP as parameter to a string holding the \fIname\fP of the
service. The default service name for a SOCKS5 server is \fI"rcmd"\fP. This
option allows you to change it.
The application does not have to keep the string around after setting this
option.
.SH DEFAULT
See above
.SH PROTOCOLS
All network protocols
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/");
curl_easy_setopt(curl, CURLOPT_PROXY, "socks5://proxy");
curl_easy_setopt(curl, CURLOPT_SOCKS5_GSSAPI_SERVICE, "rcmd-special");
ret = curl_easy_perform(curl);
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Added in 7.19.4, deprecated in 7.49.0
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, CURLE_UNKNOWN_OPTION if not, or
CURLE_OUT_OF_MEMORY if there was insufficient heap space.
.SH "SEE ALSO"
.BR CURLOPT_PROXY (3),
.BR CURLOPT_PROXYTYPE (3)
man/man3/CURLOPT_PREREQDATA.3 0000644 00000004475 14751172372 0011124 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Max Dymond, <max.dymond@microsoft.com>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_PREREQDATA 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_PREREQDATA \- pointer passed to the pre-request callback
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_PREREQDATA, void *pointer);
.fi
.SH DESCRIPTION
Pass a \fIpointer\fP that is untouched by libcurl and passed as the first
argument in the pre-request callback set with \fICURLOPT_PREREQFUNCTION(3)\fP.
.SH DEFAULT
NULL
.SH PROTOCOLS
All
.SH EXAMPLE
.nf
static int prereq_callback(void *clientp,
char *conn_primary_ip,
char *conn_local_ip,
int conn_primary_port,
int conn_local_port)
{
printf("Connection made to %s:%s\\n", conn_primary_ip, conn_primary_port);
return CURL_PREREQFUNC_OK;
}
{
struct data prereq_data;
curl_easy_setopt(CURL *handle, CURLOPT_PREREQFUNCTION, prereq_callback);
curl_easy_setopt(CURL *handle, CURLOPT_PREREQDATA, &prereq_data);
}
.fi
.SH AVAILABILITY
Added in 7.80.0
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR CURLINFO_PRIMARY_IP (3),
.BR CURLINFO_PRIMARY_PORT (3),
.BR CURLOPT_PREREQFUNCTION (3)
man/man3/CURLOPT_MAXAGE_CONN.3 0000644 00000005074 14751172372 0011247 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_MAXAGE_CONN 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_MAXAGE_CONN \- max idle time allowed for reusing a connection
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_MAXAGE_CONN, long age);
.fi
.SH DESCRIPTION
Pass a long as parameter containing \fIage\fP - the maximum time in seconds
allowed for an existing connection to have been idle to be considered for
reuse for this request.
The "connection cache" holds previously used connections. When a new request
is to be done, libcurl considers any connection that matches for reuse. The
\fICURLOPT_MAXAGE_CONN(3)\fP limit prevents libcurl from trying too old
connections for reuse, since old connections have a higher risk of not working
and thus trying them is a performance loss and sometimes service loss due to
the difficulties to figure out the situation. If a connection is found in the
cache that is older than this set \fIage\fP, it is closed instead.
.SH DEFAULT
Default maximum age is set to 118 seconds.
.SH PROTOCOLS
All
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
/* only allow 30 seconds idle time */
curl_easy_setopt(curl, CURLOPT_MAXAGE_CONN, 30L);
curl_easy_perform(curl);
}
.fi
.SH AVAILABILITY
Added in 7.65.0
.SH RETURN VALUE
Returns CURLE_OK.
.SH "SEE ALSO"
.BR CURLOPT_FORBID_REUSE (3),
.BR CURLOPT_FRESH_CONNECT (3),
.BR CURLOPT_MAXLIFETIME_CONN (3),
.BR CURLOPT_TIMEOUT (3)
man/man3/CURLOPT_PUT.3 0000644 00000004752 14751172372 0010142 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_PUT 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_PUT \- make an HTTP PUT request
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_PUT, long put);
.fi
.SH DESCRIPTION
A parameter set to 1 tells the library to use HTTP PUT to transfer data. The
data should be set with \fICURLOPT_READDATA(3)\fP and
\fICURLOPT_INFILESIZE(3)\fP.
This option is \fBdeprecated\fP since version 7.12.1. Use
\fICURLOPT_UPLOAD(3)\fP!
.SH DEFAULT
0, disabled
.SH PROTOCOLS
HTTP
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
/* we want to use our own read function */
curl_easy_setopt(curl, CURLOPT_READFUNCTION, read_callback);
/* enable PUT */
curl_easy_setopt(curl, CURLOPT_PUT, 1L);
/* specify target */
curl_easy_setopt(curl, CURLOPT_URL, "ftp://example.com/dir/to/newfile");
/* now specify which pointer to pass to our callback */
curl_easy_setopt(curl, CURLOPT_READDATA, hd_src);
/* Set the size of the file to upload */
curl_easy_setopt(curl, CURLOPT_INFILESIZE_LARGE, (curl_off_t)fsize);
/* Now run off and do what you have been told! */
curl_easy_perform(curl);
}
.fi
.SH AVAILABILITY
Deprecated since 7.12.1. Do not use.
.SH RETURN VALUE
Returns CURLE_OK if HTTP is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR CURLOPT_HTTPGET (3),
.BR CURLOPT_MIMEPOST (3),
.BR CURLOPT_POSTFIELDS (3),
.BR CURLOPT_UPLOAD (3)
man/man3/curl_mime_filename.3 0000644 00000005322 14751172372 0012070 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.TH curl_mime_filename 3 "September 26, 2023" "libcurl 8.4.0" "libcurl"
.SH NAME
curl_mime_filename - set a mime part's remote file name
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_mime_filename(curl_mimepart *part,
const char *filename);
.fi
.SH DESCRIPTION
\fIcurl_mime_filename(3)\fP sets a mime part's remote file name. When remote
file name is set, content data is processed as a file, whatever is the part's
content source. A part's remote file name is transmitted to the server in the
associated Content-Disposition generated header.
\fIpart\fP is the part's handle to assign the remote file name to.
\fIfilename\fP points to the null-terminated file name string; it may be set
to NULL to remove a previously attached remote file name.
The remote file name string is copied into the part, thus the associated
storage may safely be released or reused after call. Setting a part's file
name multiple times is valid: only the value set by the last call is retained.
.SH EXAMPLE
.nf
curl_mime *mime;
curl_mimepart *part;
/* create a mime handle */
mime = curl_mime_init(easy);
/* add a part */
part = curl_mime_addpart(mime);
/* send image data from memory */
curl_mime_data(part, imagebuf, imagebuf_len);
/* set a file name to make it look like a file upload */
curl_mime_filename(part, "image.png");
/* set name */
curl_mime_name(part, "data");
.fi
.SH AVAILABILITY
As long as at least one of HTTP, SMTP or IMAP is enabled. Added in 7.56.0.
.SH RETURN VALUE
CURLE_OK or a CURL error code upon failure.
.SH "SEE ALSO"
.BR curl_mime_addpart (3),
.BR curl_mime_data (3),
.BR curl_mime_filedata (3)
man/man3/CURLOPT_ERRORBUFFER.3 0000644 00000006711 14751172372 0011252 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_ERRORBUFFER 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_ERRORBUFFER \- error buffer for error messages
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_ERRORBUFFER, char *buf);
.fi
.SH DESCRIPTION
Pass a char * to a buffer that libcurl may use to store human readable error
messages on failures or problems. This may be more helpful than just the
return code from \fIcurl_easy_perform(3)\fP and related functions. The buffer
must be at least \fBCURL_ERROR_SIZE\fP bytes big.
You must keep the associated buffer available until libcurl no longer needs
it. Failing to do so might cause odd behavior or even crashes. libcurl might
need it until you call \fIcurl_easy_cleanup(3)\fP or you set the same option
again to use a different pointer.
Do not rely on the contents of the buffer unless an error code was returned.
Since 7.60.0 libcurl initializes the contents of the error buffer to an empty
string before performing the transfer. For earlier versions if an error code
was returned but there was no error detail then the buffer was untouched.
Consider \fICURLOPT_VERBOSE(3)\fP and \fICURLOPT_DEBUGFUNCTION(3)\fP to better
debug and trace why errors happen.
.SH DEFAULT
NULL
.SH PROTOCOLS
All
.SH EXAMPLE
.nf
curl = curl_easy_init();
if(curl) {
CURLcode res;
char errbuf[CURL_ERROR_SIZE];
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
/* provide a buffer to store errors in */
curl_easy_setopt(curl, CURLOPT_ERRORBUFFER, errbuf);
/* set the error buffer as empty before performing a request */
errbuf[0] = 0;
/* perform the request */
res = curl_easy_perform(curl);
/* if the request did not complete correctly, show the error
information. if no detailed error information was written to errbuf
show the more generic information from curl_easy_strerror instead.
*/
if(res != CURLE_OK) {
size_t len = strlen(errbuf);
fprintf(stderr, "\\nlibcurl: (%d) ", res);
if(len)
fprintf(stderr, "%s%s", errbuf,
((errbuf[len - 1] != '\\n') ? "\\n" : ""));
else
fprintf(stderr, "%s\\n", curl_easy_strerror(res));
}
}
.fi
.SH AVAILABILITY
Always
.SH RETURN VALUE
Returns CURLE_OK
.SH "SEE ALSO"
.BR curl_easy_strerror (3),
.BR curl_multi_strerror (3),
.BR curl_share_strerror (3),
.BR curl_url_strerror (3),
.BR CURLOPT_DEBUGFUNCTION (3),
.BR CURLOPT_VERBOSE (3)
man/man3/CURLOPT_KEEP_SENDING_ON_ERROR.3 0000644 00000004740 14751172372 0012727 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_KEEP_SENDING_ON_ERROR 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_KEEP_SENDING_ON_ERROR \- keep sending on early HTTP response >= 300
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_KEEP_SENDING_ON_ERROR,
long keep_sending);
.fi
.SH DESCRIPTION
A long parameter set to 1 tells the library to keep sending the request body
if the HTTP code returned is equal to or larger than 300. The default action
would be to stop sending and close the stream or connection.
This option is suitable for manual NTLM authentication, i.e. if an application
does not use \fICURLOPT_HTTPAUTH(3)\fP, but instead sets "Authorization: NTLM ..."
headers manually using \fICURLOPT_HTTPHEADER(3)\fP.
Most applications do not need this option.
.SH DEFAULT
0, stop sending on error
.SH PROTOCOLS
HTTP
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
CURLcode ret;
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/");
curl_easy_setopt(curl, CURLOPT_POSTFIELDS, "sending data");
curl_easy_setopt(curl, CURLOPT_KEEP_SENDING_ON_ERROR, 1L);
ret = curl_easy_perform(curl);
}
.fi
.SH AVAILABILITY
Along with HTTP. Added in 7.51.0.
.SH RETURN VALUE
Returns CURLE_OK if HTTP is enabled, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR CURLINFO_RESPONSE_CODE (3),
.BR CURLOPT_FAILONERROR (3),
.BR CURLOPT_HTTPHEADER (3)
man/man3/CURLOPT_CLOSESOCKETDATA.3 0000644 00000004255 14751172372 0011700 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_CLOSESOCKETDATA 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_CLOSESOCKETDATA \- pointer passed to the socket close callback
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_CLOSESOCKETDATA,
void *pointer);
.fi
.SH DESCRIPTION
Pass a \fIpointer\fP that remains untouched by libcurl and passed as the first
argument in the closesocket callback set with
\fICURLOPT_CLOSESOCKETFUNCTION(3)\fP.
.SH DEFAULT
The default value of this parameter is NULL.
.SH PROTOCOLS
All except file:
.SH EXAMPLE
.nf
static int closesocket(void *clientp, curl_socket_t item)
{
printf("libcurl wants to close %d now\\n", (int)item);
return 0;
}
/* call this function to close sockets */
curl_easy_setopt(curl, CURLOPT_CLOSESOCKETFUNCTION, closesocket);
curl_easy_setopt(curl, CURLOPT_CLOSESOCKETDATA, &sockfd);
.fi
.SH AVAILABILITY
Added in 7.21.7
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR CURLOPT_CLOSESOCKETFUNCTION (3),
.BR CURLOPT_OPENSOCKETFUNCTION (3)
man/man3/curl_pushheader_byname.3 0000644 00000005551 14751172372 0012770 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.TH curl_pushheader_byname 3 "September 26, 2023" "libcurl 8.4.0" "libcurl"
.SH NAME
curl_pushheader_byname - get a push header by name
.SH SYNOPSIS
.nf
#include <curl/curl.h>
char *curl_pushheader_byname(struct curl_pushheaders *h, const char *name);
.fi
.SH DESCRIPTION
This is a function that is only functional within a
\fICURLMOPT_PUSHFUNCTION(3)\fP callback. It makes no sense to try to use it
elsewhere and it has no function then.
It returns the value for the given header field name (or NULL) for the
incoming server push request. This is a shortcut so that the application does
not have to loop through all headers to find the one it is interested in. The
data this function points to is freed when this callback returns. If more than
one header field use the same name, this returns only the first one.
.SH EXAMPLE
.nf
int curl_push_callback(CURL *parent,
CURL *easy,
size_t num_headers,
struct curl_pushheaders *headers,
void *clientp)
{
char *headp;
int *transfers = (int *)clientp;
FILE *out;
headp = curl_pushheader_byname(headers, ":path");
if(headp && !strncmp(headp, "/push-", 6)) {
fprintf(stderr, "The PATH is %s\\n", headp);
/* save the push here */
out = fopen("pushed-stream", "wb");
/* write to this file */
curl_easy_setopt(easy, CURLOPT_WRITEDATA, out);
(*transfers)++; /* one more */
return CURL_PUSH_OK;
}
return CURL_PUSH_DENY;
}
curl_multi_setopt(multi, CURLMOPT_PUSHFUNCTION, curl_push_callback);
curl_multi_setopt(multi, CURLMOPT_PUSHDATA, &counter);
.fi
.SH AVAILABILITY
Added in 7.44.0
.SH RETURN VALUE
Returns a pointer to the header field content or NULL.
.SH "SEE ALSO"
.BR CURLMOPT_PUSHFUNCTION (3),
.BR curl_pushheader_bynum (3)
man/man3/curl_easy_option_by_id.3 0000644 00000004277 14751172372 0013010 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.TH curl_easy_option_by_id 3 "September 26, 2023" "libcurl 8.4.0" "libcurl"
.SH NAME
curl_easy_option_by_id - find an easy setopt option by id
.SH SYNOPSIS
.nf
#include <curl/curl.h>
const struct curl_easyoption *curl_easy_option_by_id(CURLoption id);
.fi
.SH DESCRIPTION
Given a \fICURLoption\fP \fBid\fP, this function returns a pointer to the
\fIcurl_easyoption\fP struct, holding information about the
\fIcurl_easy_setopt(3)\fP option using that id. The option id is the CURLOPT_
prefix ones provided in the standard curl/curl.h header file. This function
returns the non-alias version of the cases where there is an alias function as
well.
If libcurl has no option with the given id, this function returns NULL.
.SH EXAMPLE
.nf
const struct curl_easyoption *opt = curl_easy_option_by_id(CURLOPT_URL);
if(opt) {
printf("This option wants type %x\\n", opt->type);
}
.fi
.SH AVAILABILITY
This function was added in libcurl 7.73.0
.SH RETURN VALUE
A pointer to the \fIcurl_easyoption\fP struct for the option or NULL.
.SH "SEE ALSO"
.BR curl_easy_option_by_name (3),
.BR curl_easy_option_next (3),
.BR curl_easy_setopt (3)
man/man3/CURLOPT_SSLKEYTYPE.3 0000644 00000005217 14751172372 0011203 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_SSLKEYTYPE 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_SSLKEYTYPE \- type of the private key file
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_SSLKEYTYPE, char *type);
.fi
.SH DESCRIPTION
Pass a pointer to a null-terminated string as parameter. The string should be
the format of your private key. Supported formats are "PEM", "DER" and "ENG".
The format "ENG" enables you to load the private key from a crypto engine. In
this case \fICURLOPT_SSLKEY(3)\fP is used as an identifier passed to the
engine. You have to set the crypto engine with \fICURLOPT_SSLENGINE(3)\fP.
\&"DER" format key file currently does not work because of a bug in OpenSSL.
The application does not have to keep the string around after setting this
option.
.SH DEFAULT
"PEM"
.SH PROTOCOLS
All TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc.
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/");
curl_easy_setopt(curl, CURLOPT_SSLCERT, "client.pem");
curl_easy_setopt(curl, CURLOPT_SSLKEY, "key.pem");
curl_easy_setopt(curl, CURLOPT_SSLKEYTYPE, "PEM");
curl_easy_setopt(curl, CURLOPT_KEYPASSWD, "s3cret");
ret = curl_easy_perform(curl);
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
If built TLS enabled.
.SH RETURN VALUE
Returns CURLE_OK if TLS is supported, CURLE_UNKNOWN_OPTION if not, or
CURLE_OUT_OF_MEMORY if there was insufficient heap space.
.SH "SEE ALSO"
.BR CURLOPT_SSLCERT (3),
.BR CURLOPT_SSLKEY (3),
.BR CURLOPT_PROXY_SSLKEYTYPE (3)
man/man3/CURLOPT_ALTSVC_CTRL.3 0000644 00000006763 14751172372 0011316 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_ALTSVC_CTRL 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_ALTSVC_CTRL \- control alt-svc behavior
.SH SYNOPSIS
.nf
#include <curl/curl.h>
#define CURLALTSVC_READONLYFILE (1<<2)
#define CURLALTSVC_H1 (1<<3)
#define CURLALTSVC_H2 (1<<4)
#define CURLALTSVC_H3 (1<<5)
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_ALTSVC_CTRL, long bitmask);
.fi
.SH DESCRIPTION
Populate the long \fIbitmask\fP with the correct set of features to instruct
libcurl how to handle Alt-Svc for the transfers using this handle.
libcurl only accepts Alt-Svc headers over a secure transport, meaning
HTTPS. It also only completes a request to an alternative origin if that
origin is properly hosted over HTTPS. These requirements are there to make
sure both the source and the destination are legitimate.
Alternative services are only used when setting up new connections. If there
exists an existing connection to the host in the connection pool, then that is
preferred.
Setting any bit enables the alt-svc engine.
.IP "CURLALTSVC_READONLYFILE"
Do not write the alt-svc cache back to the file specified with
\fICURLOPT_ALTSVC(3)\fP even if it gets updated. By default a file specified
with that option is read and written to as deemed necessary.
.IP "CURLALTSVC_H1"
Accept alternative services offered over HTTP/1.1.
.IP "CURLALTSVC_H2"
Accept alternative services offered over HTTP/2. This is only used if libcurl
was also built to actually support HTTP/2, otherwise this bit is ignored.
.IP "CURLALTSVC_H3"
Accept alternative services offered over HTTP/3. This is only used if libcurl
was also built to actually support HTTP/3, otherwise this bit is ignored.
.SH DEFAULT
Alt-Svc handling is disabled by default. If \fICURLOPT_ALTSVC(3)\fP is set,
\fICURLOPT_ALTSVC_CTRL(3)\fP has a default value corresponding to
CURLALTSVC_H1 | CURLALTSVC_H2 | CURLALTSVC_H3 - the HTTP/2 and HTTP/3 bits are
only set if libcurl was built with support for those versions.
.SH PROTOCOLS
HTTPS
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_ALTSVC_CTRL, (long)CURLALTSVC_H1);
curl_easy_setopt(curl, CURLOPT_ALTSVC, "altsvc-cache.txt");
curl_easy_perform(curl);
}
.fi
.SH AVAILABILITY
Added in 7.64.1
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR CURLOPT_ALTSVC (3),
.BR CURLOPT_CONNECT_TO (3),
.BR CURLOPT_RESOLVE (3)
man/man3/curl_easy_recv.3 0000644 00000010055 14751172372 0011260 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH curl_easy_recv 3 "September 26, 2023" "libcurl 8.4.0" "libcurl"
.SH NAME
curl_easy_recv - receives raw data on an "easy" connection
.SH SYNOPSIS
.nf
#include <curl/easy.h>
CURLcode curl_easy_recv(CURL *curl, void *buffer, size_t buflen, size_t *n);
.fi
.SH DESCRIPTION
This function receives raw data from the established connection. You may use
it together with \fIcurl_easy_send(3)\fP to implement custom protocols using
libcurl. This functionality can be particularly useful if you use proxies
and/or SSL encryption: libcurl takes care of proxy negotiation and connection
setup.
\fBbuffer\fP is a pointer to your buffer memory that gets populated by the
received data. \fBbuflen\fP is the maximum amount of data you can get in that
buffer. The variable \fBn\fP points to receives the number of received bytes.
To establish the connection, set \fICURLOPT_CONNECT_ONLY(3)\fP option before
calling \fIcurl_easy_perform(3)\fP or \fIcurl_multi_perform(3)\fP. Note that
\fIcurl_easy_recv(3)\fP does not work on connections that were created without
this option.
The call returns \fBCURLE_AGAIN\fP if there is no data to read - the socket is
used in non-blocking mode internally. When \fBCURLE_AGAIN\fP is returned, use
your operating system facilities like \fIselect(2)\fP to wait for data. The
socket may be obtained using \fIcurl_easy_getinfo(3)\fP with
\fICURLINFO_ACTIVESOCKET(3)\fP.
Wait on the socket only if \fIcurl_easy_recv(3)\fP returns \fBCURLE_AGAIN\fP.
The reason for this is libcurl or the SSL library may internally cache some
data, therefore you should call \fIcurl_easy_recv(3)\fP until all data is
read which would include any cached data.
Furthermore if you wait on the socket and it tells you there is data to read,
\fIcurl_easy_recv(3)\fP may return \fBCURLE_AGAIN\fP if the only data that was
read was for internal SSL processing, and no other data is available.
.SH EXAMPLE
.nf
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
/* Do not do the transfer - only connect to host */
curl_easy_setopt(curl, CURLOPT_CONNECT_ONLY, 1L);
res = curl_easy_perform(curl);
if(res == CURLE_OK) {
/* Extract the socket from the curl handle - we need it for waiting. */
res = curl_easy_getinfo(curl, CURLINFO_ACTIVESOCKET, &sockfd);
/* read data */
res = curl_easy_recv(curl, buf, sizeof(buf), &nread);
}
.fi
.SH AVAILABILITY
Added in 7.18.2.
.SH RETURN VALUE
On success, returns \fBCURLE_OK\fP, stores the received data into
\fBbuffer\fP, and the number of bytes it actually read into \fB*n\fP.
On failure, returns the appropriate error code.
The function may return \fBCURLE_AGAIN\fP. In this case, use your operating
system facilities to wait until data can be read, and retry.
Reading exactly 0 bytes indicates a closed connection.
If there is no socket available to use from the previous transfer, this function
returns \fBCURLE_UNSUPPORTED_PROTOCOL\fP.
.SH "SEE ALSO"
.BR curl_easy_getinfo (3),
.BR curl_easy_perform (3),
.BR curl_easy_send (3),
.BR curl_easy_setopt (3)
man/man3/CURLINFO_NAMELOOKUP_TIME.3 0000644 00000004417 14751172372 0012051 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLINFO_NAMELOOKUP_TIME 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLINFO_NAMELOOKUP_TIME \- get the name lookup time
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_getinfo(CURL *handle, CURLINFO_NAMELOOKUP_TIME,
double *timep);
.fi
.SH DESCRIPTION
Pass a pointer to a double to receive the total time in seconds from the start
until the name resolving was completed.
When a redirect is followed, the time from each request is added together.
See also the TIMES overview in the \fIcurl_easy_getinfo(3)\fP man page.
.SH PROTOCOLS
All
.SH EXAMPLE
.nf
curl = curl_easy_init();
if(curl) {
double namelookup;
curl_easy_setopt(curl, CURLOPT_URL, url);
res = curl_easy_perform(curl);
if(CURLE_OK == res) {
res = curl_easy_getinfo(curl, CURLINFO_NAMELOOKUP_TIME, &namelookup);
if(CURLE_OK == res) {
printf("Time: %.1f", namelookup);
}
}
/* always cleanup */
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Added in 7.4.1
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR curl_easy_getinfo (3),
.BR curl_easy_setopt (3),
.BR CURLINFO_NAMELOOKUP_TIME_T (3)
man/man3/CURLOPT_PROXY_SSL_OPTIONS.3 0000644 00000011163 14751172372 0012341 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_PROXY_SSL_OPTIONS 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_PROXY_SSL_OPTIONS \- HTTPS proxy SSL behavior options
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_PROXY_SSL_OPTIONS,
long bitmask);
.fi
.SH DESCRIPTION
Pass a long with a bitmask to tell libcurl about specific SSL
behaviors. Available bits:
.IP CURLSSLOPT_ALLOW_BEAST
Tells libcurl to not attempt to use any workarounds for a security flaw in the
SSL3 and TLS1.0 protocols. If this option is not used or this bit is set to 0,
the SSL layer libcurl uses may use a work-around for this flaw although it
might cause interoperability problems with some (older) SSL implementations.
WARNING: avoiding this work-around lessens the security, and by setting this
option to 1 you ask for exactly that. This option is only supported for
Secure Transport and OpenSSL.
.IP CURLSSLOPT_NO_REVOKE
Tells libcurl to disable certificate revocation checks for those SSL backends
where such behavior is present. This option is only supported for Schannel
(the native Windows SSL library), with an exception in the case of Windows'
Untrusted Publishers block list which it seems cannot be bypassed. (Added in
7.44.0)
.IP CURLSSLOPT_NO_PARTIALCHAIN
Tells libcurl to not accept "partial" certificate chains, which it otherwise
does by default. This option is only supported for OpenSSL and fails the
certificate verification if the chain ends with an intermediate certificate
and not with a root cert. (Added in 7.68.0)
.IP CURLSSLOPT_REVOKE_BEST_EFFORT
Tells libcurl to ignore certificate revocation checks in case of missing or
offline distribution points for those SSL backends where such behavior is
present. This option is only supported for Schannel (the native Windows SSL
library). If combined with \fICURLSSLOPT_NO_REVOKE\fP, the latter takes
precedence. (Added in 7.70.0)
.IP CURLSSLOPT_NATIVE_CA
Tell libcurl to use the operating system's native CA store for certificate
verification. Works only on Windows, Linux (Debian, Ubuntu, Gentoo, Fedora,
RHEL), macOS, Android and iOS when built to use wolfSSL (since 8.3.0) or on
Windows when built to use OpenSSL. If you set this option and also set a CA
certificate file or directory then during verification those certificates
are searched in addition to the native CA store.
(Added in 7.71.0)
.IP CURLSSLOPT_AUTO_CLIENT_CERT
Tell libcurl to automatically locate and use a client certificate for
authentication, when requested by the server. This option is only supported
for Schannel (the native Windows SSL library). Prior to 7.77.0 this was the
default behavior in libcurl with Schannel. Since the server can request any
certificate that supports client authentication in the OS certificate store it
could be a privacy violation and unexpected.
(Added in 7.77.0)
.SH DEFAULT
0
.SH PROTOCOLS
All TLS-based protocols
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/");
curl_easy_setopt(curl, CURLOPT_PROXY, "https://proxy");
/* weaken TLS only for use with silly proxies */
curl_easy_setopt(curl, CURLOPT_PROXY_SSL_OPTIONS, CURLSSLOPT_ALLOW_BEAST |
CURLSSLOPT_NO_REVOKE);
ret = curl_easy_perform(curl);
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Added in 7.52.0
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR CURLOPT_PROXY_SSL_CIPHER_LIST (3),
.BR CURLOPT_PROXY_SSLVERSION (3),
.BR CURLOPT_SSL_CIPHER_LIST (3),
.BR CURLOPT_SSLVERSION (3)
man/man3/curl_strequal.3 0000644 00000004361 14751172372 0011143 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.TH curl_strequal 3 "April 26, 2023" "libcurl 8.4.0" "libcurl"
.SH NAME
curl_strequal, curl_strnequal - case insensitive string comparisons
.SH SYNOPSIS
.nf
#include <curl/curl.h>
int curl_strequal(char *str1, char *str2);
int curl_strnequal(char *str1, char *str2, size_t length);
.fi
.SH DESCRIPTION
The
.B curl_strequal()
function compares the two strings \fIstr1\fP and \fIstr2\fP, ignoring the case
of the characters. It returns a non-zero (TRUE) integer if the strings are
identical.
.sp
The \fBcurl_strnequal()\fP function is similar, except it only compares the
first \fIlength\fP characters of \fIstr1\fP.
.sp
These functions are provided by libcurl to enable applications to compare
strings in a truly portable manner. There are no standard portable case
insensitive string comparison functions. These two work on all platforms.
.SH EXAMPLE
.nf
if(curl_strequal(name, input))
printf("Name and input matches\\n");
if(curl_strnequal(name, input, 5))
printf("Name and input matches in the 5 first bytes\\n");
.fi
.SH AVAILABILITY
Always
.SH RETURN VALUE
Non-zero if the strings are identical. Zero if they are not.
.SH "SEE ALSO"
.BR strcmp "(3), " strcasecmp "(3)"
man/man3/CURLOPT_RTSP_SESSION_ID.3 0000644 00000004612 14751172372 0012034 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_RTSP_SESSION_ID 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_RTSP_SESSION_ID \- RTSP session ID
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_RTSP_SESSION_ID, char *id);
.fi
.SH DESCRIPTION
Pass a char * as a parameter to set the value of the current RTSP Session ID
for the handle. Useful for resuming an in-progress session. Once this value is
set to any non-NULL value, libcurl returns \fICURLE_RTSP_SESSION_ERROR\fP if
ID received from the server does not match. If unset (or set to NULL), libcurl
automatically sets the ID the first time the server sets it in a response.
The application does not have to keep the string around after setting this
option.
.SH DEFAULT
NULL
.SH PROTOCOLS
RTSP
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
char *prev_id; /* saved from before somehow */
curl_easy_setopt(curl, CURLOPT_URL, "rtsp://example.com/");
curl_easy_setopt(curl, CURLOPT_RTSP_SESSION_ID, prev_id);
ret = curl_easy_perform(curl);
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Added in 7.20.0
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, CURLE_UNKNOWN_OPTION if not, or
CURLE_OUT_OF_MEMORY if there was insufficient heap space.
.SH "SEE ALSO"
.BR CURLOPT_RTSP_REQUEST (3),
.BR CURLOPT_RTSP_STREAM_URI (3)
man/man3/CURLINFO_SIZE_DOWNLOAD.3 0000644 00000004730 14751172372 0011620 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLINFO_SIZE_DOWNLOAD 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLINFO_SIZE_DOWNLOAD \- get the number of downloaded bytes
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_getinfo(CURL *handle, CURLINFO_SIZE_DOWNLOAD, double *dlp);
.fi
.SH DESCRIPTION
Pass a pointer to a double to receive the total amount of bytes that were
downloaded. The amount is only for the latest transfer and gets reset again
for each new transfer. This counts actual payload data, what's also commonly
called body. All meta and header data is excluded and not included in this
number.
\fICURLINFO_SIZE_DOWNLOAD_T(3)\fP is a newer replacement that returns a more
sensible variable type.
.SH PROTOCOLS
All
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
/* Perform the request */
res = curl_easy_perform(curl);
if(!res) {
/* check the size */
double dl;
res = curl_easy_getinfo(curl, CURLINFO_SIZE_DOWNLOAD, &dl);
if(!res) {
printf("Downloaded %.0f bytes\\n", cl);
}
}
}
.fi
.SH AVAILABILITY
Added in 7.4.1. Deprecated since 7.55.0.
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR curl_easy_getinfo (3),
.BR curl_easy_setopt (3),
.BR CURLINFO_SIZE_DOWNLOAD_T (3),
.BR CURLINFO_SIZE_UPLOAD_T (3),
.BR CURLOPT_MAXFILESIZE (3)
man/man3/curl_global_sslset.3 0000644 00000012344 14751172372 0012140 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.TH curl_global_sslset 3 "September 26, 2023" "libcurl 8.4.0" "libcurl"
.SH NAME
curl_global_sslset - Select SSL backend to use with libcurl
.SH SYNOPSIS
.nf
#include <curl/curl.h>
typedef struct {
curl_sslbackend id;
const char *name;
} curl_ssl_backend;
typedef enum {
CURLSSLBACKEND_NONE = 0,
CURLSSLBACKEND_OPENSSL = 1, /* or one of its forks */
CURLSSLBACKEND_GNUTLS = 2,
CURLSSLBACKEND_NSS = 3,
CURLSSLBACKEND_GSKIT = 5, /* deprecated */
CURLSSLBACKEND_POLARSSL = 6, /* deprecated */
CURLSSLBACKEND_WOLFSSL = 7,
CURLSSLBACKEND_SCHANNEL = 8,
CURLSSLBACKEND_SECURETRANSPORT = 9,
CURLSSLBACKEND_AXTLS = 10, /* deprecated */
CURLSSLBACKEND_MBEDTLS = 11,
CURLSSLBACKEND_MESALINK = 12, /* deprecated */
CURLSSLBACKEND_BEARSSL = 13,
CURLSSLBACKEND_RUSTLS = 14
} curl_sslbackend;
CURLsslset curl_global_sslset(curl_sslbackend id,
const char *name,
curl_ssl_backend ***avail);
.fi
.SH DESCRIPTION
This function configures at runtime which SSL backend to use with
libcurl. This function can only be used to select an SSL backend once, and it
must be called \fBbefore\fP \fIcurl_global_init(3)\fP.
The backend can be identified by the \fIid\fP
(e.g. \fBCURLSSLBACKEND_OPENSSL\fP). The backend can also be specified via the
\fIname\fP parameter for a case insensitive match (passing
\fBCURLSSLBACKEND_NONE\fP as \fIid\fP). If both \fIid\fP and \fIname\fP are
specified, the \fIname\fP is ignored.
If neither \fIid\fP nor \fPname\fP are specified, the function fails with
\fBCURLSSLSET_UNKNOWN_BACKEND\fP and set the \fIavail\fP pointer to the
NULL-terminated list of available backends. The available backends are those
that this particular build of libcurl supports.
Since libcurl 7.60.0, the \fIavail\fP pointer is always set to the list of
alternatives if non-NULL.
Upon success, the function returns \fBCURLSSLSET_OK\fP.
If the specified SSL backend is not available, the function returns
\fBCURLSSLSET_UNKNOWN_BACKEND\fP and sets the \fIavail\fP pointer to a
NULL-terminated list of available SSL backends. In this case, you may call the
function again to try to select a different backend.
The SSL backend can be set only once. If it has already been set, a subsequent
attempt to change it results in a \fBCURLSSLSET_TOO_LATE\fP getting returned.
This function is thread-safe since libcurl 7.84.0 if
\fIcurl_version_info(3)\fP has the CURL_VERSION_THREADSAFE feature bit set
(most platforms).
If this is not thread-safe, you must not call this function when any other
thread in the program (i.e. a thread sharing the same memory) is running.
This does not just mean no other thread that is using libcurl.
.SH OpenSSL
The name "OpenSSL" is used for all versions of OpenSSL and its associated
forks/flavors in this function. OpenSSL, BoringSSL, libressl, quictls and
AmiSSL are all supported by libcurl, but in the eyes of
\fIcurl_global_sslset(3)\fP they are all just "OpenSSL". They all mostly
provide the same API.
\fIcurl_version_info(3)\fP can return more specific info about the exact
OpenSSL flavor and version number is use.
.SH EXAMPLE
.nf
/* choose a specific backend */
curl_global_sslset(CURLSSLBACKEND_WOLFSSL, NULL, NULL);
/* list the available ones */
const curl_ssl_backend **list;
curl_global_sslset(CURLSSLBACKEND_NONE, NULL, &list);
for(i = 0; list[i]; i++)
printf("SSL backend #%d: '%s' (ID: %d)\\n",
i, list[i]->name, list[i]->id);
.fi
.SH AVAILABILITY
This function was added in libcurl 7.56.0. Before this version, there was no
support for choosing SSL backends at runtime.
.SH RETURN VALUE
If this function returns \fICURLSSLSET_OK\fP, the backend was successfully
selected.
If the chosen backend is unknown (or support for the chosen backend has not
been compiled into libcurl), the function returns
\fICURLSSLSET_UNKNOWN_BACKEND\fP.
If the backend had been configured previously, or if \fIcurl_global_init(3)\fP
has already been called, the function returns \fICURLSSLSET_TOO_LATE\fP.
If this libcurl was built completely without SSL support, with no backends at
all, this function returns \fICURLSSLSET_NO_BACKENDS\fP.
.SH "SEE ALSO"
.BR curl_global_init (3),
.BR libcurl (3)
man/man3/CURLINFO_SCHEME.3 0000644 00000004622 14751172372 0010523 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLINFO_SCHEME 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLINFO_SCHEME \- get the URL scheme (sometimes called protocol) used in the connection
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_getinfo(CURL *handle, CURLINFO_SCHEME, char **scheme);
.fi
.SH DESCRIPTION
Pass a pointer to a char pointer to receive the pointer to a null-terminated
string holding the URL scheme used for the most recent connection done with
this CURL \fBhandle\fP.
The \fBscheme\fP pointer is NULL or points to private memory. You MUST NOT
free - it gets freed when you call \fIcurl_easy_cleanup(3)\fP on the
corresponding CURL handle.
.SH PROTOCOLS
All
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
CURLcode res;
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
res = curl_easy_perform(curl);
if(res == CURLE_OK) {
char *scheme = NULL;
curl_easy_getinfo(curl, CURLINFO_SCHEME, &scheme);
if(scheme)
printf("scheme: %s\\n", scheme); /* scheme: HTTP */
}
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Added in 7.52.0
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR curl_easy_getinfo (3),
.BR curl_easy_setopt (3),
.BR CURLINFO_EFFECTIVE_URL (3),
.BR CURLINFO_PROTOCOL (3),
.BR CURLINFO_RESPONSE_CODE (3)
man/man3/CURLOPT_TFTP_BLKSIZE.3 0000644 00000004315 14751172372 0011425 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_TFTP_BLKSIZE 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_TFTP_BLKSIZE \- TFTP block size
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_TFTP_BLKSIZE, long blocksize);
.fi
.SH DESCRIPTION
Specify \fIblocksize\fP to use for TFTP data transmission. Valid range as per
RFC 2348 is 8-65464 bytes. The default of 512 bytes is used if this option is
not specified. The specified block size is only used if supported by the
remote server. If the server does not return an option acknowledgment or
returns an option acknowledgment with no block size, the default of 512 bytes
is used.
.SH DEFAULT
512
.SH PROTOCOLS
TFTP
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "tftp://example.com/bootimage");
/* try using larger blocks */
curl_easy_setopt(curl, CURLOPT_TFTP_BLKSIZE, 2048L);
ret = curl_easy_perform(curl);
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Added in 7.19.4
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR CURLOPT_MAXFILESIZE (3)
man/man3/curl_strnequal.3 0000644 00000000031 14751172372 0011307 0 ustar 00 .so man3/curl_strequal.3
man/man3/libcurl-thread.3 0000644 00000013553 14751172372 0011162 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH libcurl-thread 3 "August 22, 2023" "libcurl 8.4.0" "libcurl"
.SH NAME
libcurl-thread \- libcurl thread safety
.SH "Multi-threading with libcurl"
libcurl is thread safe but has no internal thread synchronization. You may have
to provide your own locking should you meet any of the thread safety exceptions
below.
.SH "Handles"
You must \fBnever\fP share the same handle in multiple threads. You can pass
the handles around among threads, but you must never use a single handle from
more than one thread at any given time.
.SH "Shared objects"
You can share certain data between multiple handles by using the share
interface but you must provide your own locking and set
\fIcurl_share_setopt(3)\fP CURLSHOPT_LOCKFUNC and CURLSHOPT_UNLOCKFUNC.
Note that some items are specifically documented as not thread-safe in the
share API (the connection pool and HSTS cache for example).
.SH TLS
If you are accessing HTTPS or FTPS URLs in a multi-threaded manner, you are
then of course using the underlying SSL library multi-threaded and those libs
might have their own requirements on this issue. You may need to provide one
or two functions to allow it to function properly:
.IP OpenSSL
OpenSSL 1.1.0+ "can be safely used in multi-threaded applications provided that
support for the underlying OS threading API is built-in." In that case the
engine is used by libcurl in a way that is fully thread-safe.
https://www.openssl.org/docs/man1.1.0/man3/CRYPTO_THREAD_run_once.html#DESCRIPTION
OpenSSL <= 1.0.2 the user must set callbacks.
https://www.openssl.org/docs/man1.0.2/man3/CRYPTO_set_locking_callback.html#DESCRIPTION
https://curl.se/libcurl/c/opensslthreadlock.html
.IP GnuTLS
https://gnutls.org/manual/html_node/Thread-safety.html
.IP NSS
thread-safe already without anything required.
.IP Secure-Transport
The engine is used by libcurl in a way that is fully thread-safe.
.IP Schannel
The engine is used by libcurl in a way that is fully thread-safe.
.IP wolfSSL
The engine is used by libcurl in a way that is fully thread-safe.
.IP BoringSSL
The engine is used by libcurl in a way that is fully thread-safe.
.IP AWS-LC
The engine is used by libcurl in a way that is fully thread-safe.
.SH "Signals"
Signals are used for timing out name resolves (during DNS lookup) - when built
without using either the c-ares or threaded resolver backends. On systems that
have a signal concept.
When using multiple threads you should set the \fICURLOPT_NOSIGNAL(3)\fP
option to 1L for all handles. Everything works fine except that timeouts
cannot be honored during DNS lookups - which you can work around by building
libcurl with c-ares or threaded-resolver support. c-ares is a library that
provides asynchronous name resolves. On some platforms, libcurl simply cannot
function properly multi-threaded unless the \fICURLOPT_NOSIGNAL(3)\fP option
is set.
When \fICURLOPT_NOSIGNAL(3)\fP is set to 1L, your application needs to deal
with the risk of a SIGPIPE (that at least the OpenSSL backend can
trigger). Note that setting \fICURLOPT_NOSIGNAL(3)\fP to 0L does not work in a
threaded situation as there is a race condition where libcurl risks restoring
the former signal handler while another thread should still ignore it.
.SH "Name resolving"
The \fBgethostbyname\fP or \fBgetaddrinfo\fP and other name resolving system
calls used by libcurl are provided by your operating system and must be thread
safe. It is important that libcurl can find and use thread safe versions of
these and other system calls, as otherwise it cannot function fully thread
safe. Some operating systems are known to have faulty thread
implementations. We have previously received problem reports on *BSD (at least
in the past, they may be working fine these days). Some operating systems that
are known to have solid and working thread support are Linux, Solaris and
Windows.
.SH "curl_global_* functions"
These functions are thread-safe since libcurl 7.84.0 if
\fIcurl_version_info(3)\fP has the \fBCURL_VERSION_THREADSAFE\fP feature bit
set (most platforms).
If these functions are not thread-safe and you are using libcurl with multiple
threads it is especially important that before use you call
\fIcurl_global_init(3)\fP or \fIcurl_global_init_mem(3)\fP to explicitly
initialize the library and its dependents, rather than rely on the "lazy"
fail-safe initialization that takes place the first time
\fIcurl_easy_init(3)\fP is called. For an in-depth explanation refer to
\fIlibcurl(3)\fP section \fBGLOBAL CONSTANTS\fP.
.SH "Memory functions"
These functions, provided either by your operating system or your own
replacements, must be thread safe. You can use \fIcurl_global_init_mem(3)\fP
to set your own replacement memory functions.
.SH "Non-safe functions"
\fICURLOPT_DNS_USE_GLOBAL_CACHE(3)\fP is not thread-safe.
\fIcurl_version_info(3)\fP is not thread-safe before libcurl initialization.
man/man3/CURLOPT_MAXFILESIZE_LARGE.3 0000644 00000004757 14751172372 0012171 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_MAXFILESIZE_LARGE 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_MAXFILESIZE_LARGE \- maximum file size allowed to download
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_MAXFILESIZE_LARGE,
curl_off_t size);
.SH DESCRIPTION
Pass a curl_off_t as parameter. This specifies the maximum accepted \fIsize\fP
(in bytes) of a file to download. If the file requested is found larger than
this value, the transfer is aborted and \fICURLE_FILESIZE_EXCEEDED\fP is
returned.
The file size is not always known prior to the download start, and for such
transfers this option has no effect - even if the file transfer eventually
ends up being larger than this given limit.
Since 8.4.0, this option also stops ongoing transfers if they reach this
threshold.
.SH DEFAULT
None
.SH PROTOCOLS
FTP, HTTP and MQTT
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
CURLcode ret;
curl_off_t ridiculous = 1 << 48;
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/");
/* refuse to download if larger than ridiculous */
curl_easy_setopt(curl, CURLOPT_MAXFILESIZE_LARGE, ridiculous);
ret = curl_easy_perform(curl);
}
.fi
.SH AVAILABILITY
Added in 7.11.0
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR CURLOPT_MAX_RECV_SPEED_LARGE (3),
.BR CURLOPT_MAXFILESIZE (3)
man/man3/CURLINFO_PROTOCOL.3 0000644 00000005256 14751172372 0011024 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLINFO_PROTOCOL 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLINFO_PROTOCOL \- get the protocol used in the connection
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_getinfo(CURL *handle, CURLINFO_PROTOCOL, long *p);
.fi
.SH DESCRIPTION
This option is deprecated. We strongly recommend using
\fICURLINFO_SCHEME(3)\fP instead, because this option cannot return all
possible protocols!
Pass a pointer to a long to receive the version used in the last http
connection. The returned value is set to one of the CURLPROTO_* values:
.nf
CURLPROTO_DICT, CURLPROTO_FILE, CURLPROTO_FTP, CURLPROTO_FTPS,
CURLPROTO_GOPHER, CURLPROTO_HTTP, CURLPROTO_HTTPS, CURLPROTO_IMAP,
CURLPROTO_IMAPS, CURLPROTO_LDAP, CURLPROTO_LDAPS, CURLPROTO_POP3,
CURLPROTO_POP3S, CURLPROTO_RTMP, CURLPROTO_RTMPE, CURLPROTO_RTMPS,
CURLPROTO_RTMPT, CURLPROTO_RTMPTE, CURLPROTO_RTMPTS, CURLPROTO_RTSP,
CURLPROTO_SCP, CURLPROTO_SFTP, CURLPROTO_SMB, CURLPROTO_SMBS, CURLPROTO_SMTP,
CURLPROTO_SMTPS, CURLPROTO_TELNET, CURLPROTO_TFTP, CURLPROTO_MQTT
.SH PROTOCOLS
All
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
CURLcode res;
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
res = curl_easy_perform(curl);
if(res == CURLE_OK) {
long protocol;
curl_easy_getinfo(curl, CURLINFO_PROTOCOL, &protocol);
}
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Added in 7.52.0. Deprecated since 7.85.0.
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR curl_easy_getinfo (3),
.BR curl_easy_setopt (3),
.BR CURLINFO_RESPONSE_CODE (3)
man/man3/curl_escape.3 0000644 00000004334 14751172372 0010543 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.TH curl_escape 3 "September 26, 2023" "libcurl 8.4.0" "libcurl"
.SH NAME
curl_escape - URL encodes the given string
.SH SYNOPSIS
.nf
#include <curl/curl.h>
char *curl_escape(const char *string, int length);
.fi
.SH DESCRIPTION
Obsolete function. Use \fIcurl_easy_escape(3)\fP instead!
This function converts the given input \fBstring\fP to a URL encoded string
and return that as a new allocated string. All input characters that are not
a-z, A-Z or 0-9 are converted to their "URL escaped" version (\fB%NN\fP where
\fBNN\fP is a two-digit hexadecimal number).
If the \fBlength\fP argument is set to 0, \fIcurl_escape(3)\fP uses strlen()
on \fBstring\fP to find out the size.
You must \fIcurl_free(3)\fP the returned string when you are done with it.
.SH EXAMPLE
.nf
char *output = curl_escape("data to convert", 15);
if(output) {
printf("Encoded: %s\\n", output);
curl_free(output);
}
.fi
.SH AVAILABILITY
Since 7.15.4, \fIcurl_easy_escape(3)\fP should be used. This function might be
removed in a future release.
.SH RETURN VALUE
A pointer to a null-terminated string or NULL if it failed.
.SH "SEE ALSO"
.BR curl_unescape (3),
.BR curl_free (3)
man/man3/CURLOPT_OPENSOCKETFUNCTION.3 0000644 00000011313 14751172372 0012301 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_OPENSOCKETFUNCTION 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_OPENSOCKETFUNCTION \- callback for opening socket
.SH SYNOPSIS
.nf
#include <curl/curl.h>
typedef enum {
CURLSOCKTYPE_IPCXN, /* socket created for a specific IP connection */
} curlsocktype;
struct curl_sockaddr {
int family;
int socktype;
int protocol;
unsigned int addrlen;
struct sockaddr addr;
};
curl_socket_t opensocket_callback(void *clientp,
curlsocktype purpose,
struct curl_sockaddr *address);
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_OPENSOCKETFUNCTION, opensocket_callback);
.SH DESCRIPTION
Pass a pointer to your callback function, which should match the prototype
shown above.
This callback function gets called by libcurl instead of the \fIsocket(2)\fP
call. The callback's \fIpurpose\fP argument identifies the exact purpose for
this particular socket. \fICURLSOCKTYPE_IPCXN\fP is for IP based connections
and is the only purpose currently used in libcurl. Future versions of libcurl
may support more purposes.
The \fIclientp\fP pointer contains whatever user-defined value set using the
\fICURLOPT_OPENSOCKETDATA(3)\fP function.
The callback gets the resolved peer address as the \fIaddress\fP argument and
is allowed to modify the address or refuse to connect completely. The callback
function should return the newly created socket or \fICURL_SOCKET_BAD\fP in
case no connection could be established or another error was detected. Any
additional \fIsetsockopt(2)\fP calls can of course be done on the socket at
the user's discretion. A \fICURL_SOCKET_BAD\fP return value from the callback
function signals an unrecoverable error to libcurl and it returns
\fICURLE_COULDNT_CONNECT\fP from the function that triggered this callback.
This return code can be used for IP address block listing.
If you want to pass in a socket with an already established connection, pass
the socket back with this callback and then use
\fICURLOPT_SOCKOPTFUNCTION(3)\fP to signal that it already is connected.
.SH DEFAULT
The default behavior is the equivalent of this:
.nf
return socket(addr->family, addr->socktype, addr->protocol);
.fi
.SH PROTOCOLS
All
.SH EXAMPLE
.nf
/* make libcurl use the already established socket 'sockfd' */
static curl_socket_t opensocket(void *clientp,
curlsocktype purpose,
struct curl_sockaddr *address)
{
curl_socket_t sockfd;
sockfd = *(curl_socket_t *)clientp;
/* the actual externally set socket is passed in via the OPENSOCKETDATA
option */
return sockfd;
}
static int sockopt_callback(void *clientp, curl_socket_t curlfd,
curlsocktype purpose)
{
/* This return code was added in libcurl 7.21.5 */
return CURL_SOCKOPT_ALREADY_CONNECTED;
}
curl = curl_easy_init();
if(curl) {
/* libcurl thinks that you connect to the host
* and port that you specify in the URL option. */
curl_easy_setopt(curl, CURLOPT_URL, "http://99.99.99.99:9999");
/* call this function to get a socket */
curl_easy_setopt(curl, CURLOPT_OPENSOCKETFUNCTION, opensocket);
curl_easy_setopt(curl, CURLOPT_OPENSOCKETDATA, &sockfd);
/* call this function to set options for the socket */
curl_easy_setopt(curl, CURLOPT_SOCKOPTFUNCTION, sockopt_callback);
res = curl_easy_perform(curl);
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Added in 7.17.1.
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR CURLOPT_CLOSESOCKETFUNCTION (3),
.BR CURLOPT_OPENSOCKETFUNCTION (3),
.BR CURLOPT_SOCKOPTFUNCTION (3)
man/man3/CURLOPT_SSH_PRIVATE_KEYFILE.3 0000644 00000004774 14751172372 0012475 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_SSH_PRIVATE_KEYFILE 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_SSH_PRIVATE_KEYFILE \- private key file for SSH auth
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_SSH_PRIVATE_KEYFILE,
char *filename);
.SH DESCRIPTION
Pass a char * pointing to a \fIfilename\fP for your private key. If not used,
libcurl defaults to \fB$HOME/.ssh/id_rsa\fP or \fB$HOME/.ssh/id_dsa\fP if the
HOME environment variable is set, and just \fB"id_rsa"\fP or \fB"id_dsa"\fP in
the current directory if HOME is not set.
If the file is password-protected, set the password with
\fICURLOPT_KEYPASSWD(3)\fP.
The application does not have to keep the string around after setting this
option.
.SH DEFAULT
As explained above
.SH PROTOCOLS
SFTP and SCP
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "sftp://example.com/file");
curl_easy_setopt(curl, CURLOPT_SSH_PRIVATE_KEYFILE,
"/home/clarkkent/.ssh/id_rsa");
curl_easy_setopt(curl, CURLOPT_KEYPASSWD, "password");
ret = curl_easy_perform(curl);
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Added in 7.16.1
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, CURLE_UNKNOWN_OPTION if not, or
CURLE_OUT_OF_MEMORY if there was insufficient heap space.
.SH "SEE ALSO"
.BR CURLOPT_SSH_PUBLIC_KEYFILE (3),
.BR CURLOPT_SSH_AUTH_TYPES (3)
man/man3/CURLINFO_CONTENT_LENGTH_UPLOAD.3 0000644 00000004467 14751172372 0013005 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLINFO_CONTENT_LENGTH_UPLOAD 3 "September 26, 2023" "libcurl 8.4.0" "libcurl"
.SH NAME
CURLINFO_CONTENT_LENGTH_UPLOAD \- get the specified size of the upload
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_getinfo(CURL *handle, CURLINFO_CONTENT_LENGTH_UPLOAD,
double *content_length);
.fi
.SH DESCRIPTION
Pass a pointer to a double to receive the specified size of the upload. Since
7.19.4, this returns -1 if the size is not known.
\fICURLINFO_CONTENT_LENGTH_UPLOAD_T(3)\fP is a newer replacement that returns a
more sensible variable type.
.SH PROTOCOLS
All
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
/* Perform the upload */
res = curl_easy_perform(curl);
if(!res) {
/* check the size */
double cl;
res = curl_easy_getinfo(curl, CURLINFO_CONTENT_LENGTH_UPLOAD, &cl);
if(!res) {
printf("Size: %.0f\\n", cl);
}
}
}
.fi
.SH AVAILABILITY
Added in 7.6.1. Deprecated since 7.55.0.
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR curl_easy_getinfo (3),
.BR curl_easy_setopt (3),
.BR CURLINFO_CONTENT_LENGTH_DOWNLOAD_T (3)
man/man3/CURLOPT_TLSAUTH_USERNAME.3 0000644 00000004743 14751172372 0012115 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_TLSAUTH_USERNAME 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_TLSAUTH_USERNAME \- user name to use for TLS authentication
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_TLSAUTH_USERNAME, char *user);
.fi
.SH DESCRIPTION
Pass a char * as parameter, which should point to the null-terminated username
to use for the TLS authentication method specified with the
\fICURLOPT_TLSAUTH_TYPE(3)\fP option. Requires that the
\fICURLOPT_TLSAUTH_PASSWORD(3)\fP option also be set.
The application does not have to keep the string around after setting this
option.
This feature relies in TLS SRP which does not work with TLS 1.3.
.SH DEFAULT
NULL
.SH PROTOCOLS
All TLS-based protocols
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/");
curl_easy_setopt(curl, CURLOPT_TLSAUTH_TYPE, "SRP");
curl_easy_setopt(curl, CURLOPT_TLSAUTH_USERNAME, "user");
curl_easy_setopt(curl, CURLOPT_TLSAUTH_PASSWORD, "secret");
ret = curl_easy_perform(curl);
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Added in 7.21.4, with the OpenSSL and GnuTLS backends only
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, CURLE_UNKNOWN_OPTION if not, or
CURLE_OUT_OF_MEMORY if there was insufficient heap space.
.SH "SEE ALSO"
.BR CURLOPT_TLSAUTH_TYPE (3),
.BR CURLOPT_TLSAUTH_PASSWORD (3)
man/man3/CURLINFO_FTP_ENTRY_PATH.3 0000644 00000004625 14751172372 0012010 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLINFO_FTP_ENTRY_PATH 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLINFO_FTP_ENTRY_PATH \- get entry path in FTP server
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_getinfo(CURL *handle, CURLINFO_FTP_ENTRY_PATH, char **path);
.fi
.SH DESCRIPTION
Pass a pointer to a char pointer to receive a pointer to a string holding the
path of the entry path. That is the initial path libcurl ended up in when
logging on to the remote FTP server. This stores a NULL as pointer if
something is wrong.
The \fBpath\fP pointer is NULL or points to private memory. You MUST NOT free
- it gets freed when you call \fIcurl_easy_cleanup(3)\fP on the corresponding
CURL handle.
.SH PROTOCOLS
FTP(S) and SFTP
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "ftp://example.com");
res = curl_easy_perform(curl);
if(!res) {
/* extract the entry path */
char *ep = NULL;
res = curl_easy_getinfo(curl, CURLINFO_FTP_ENTRY_PATH, &ep);
if(!res && ep) {
printf("Entry path was: %s\\n", ep);
}
}
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Added in 7.15.4. Works for SFTP since 7.21.4
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR curl_easy_getinfo (3),
.BR curl_easy_setopt (3)
man/man3/curl_getenv.3 0000644 00000004110 14751172372 0010563 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.TH curl_getenv 3 "September 26, 2023" "libcurl 8.4.0" "libcurl"
.SH NAME
curl_getenv - return value for environment name
.SH SYNOPSIS
.nf
#include <curl/curl.h>
char *curl_getenv(const char *name);
.fi
.SH DESCRIPTION
curl_getenv() is a portable wrapper for the getenv() function, meant to
emulate its behavior and provide an identical interface for all operating
systems libcurl builds on (including win32).
You must \fIcurl_free(3)\fP the returned string when you are done with it.
.SH EXAMPLE
.nf
char *width = curl_getenv("COLUMNS");
if(width) {
/* it was set! */
curl_free(width);
}
.fi
.SH AVAILABILITY
Always
.SH RETURN VALUE
A pointer to a null-terminated string or NULL if it failed to find the
specified name.
.SH NOTE
Under unix operating systems, there is no point in returning an allocated
memory, although other systems does not work properly if this is not done. The
unix implementation thus suffers slightly from the drawbacks of other systems.
.SH "SEE ALSO"
.BR getenv (3C)
man/man3/CURLOPT_PINNEDPUBLICKEY.3 0000644 00000011037 14751172372 0011711 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_PINNEDPUBLICKEY 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_PINNEDPUBLICKEY \- pinned public key
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_PINNEDPUBLICKEY,
char *pinnedpubkey);
.fi
.SH DESCRIPTION
Pass a pointer to a null-terminated string as parameter. The string can be the
file name of your pinned public key. The file format expected is "PEM" or "DER".
The string can also be any number of base64 encoded sha256 hashes preceded by
"sha256//" and separated by ";"
When negotiating a TLS or SSL connection, the server sends a certificate
indicating its identity. A public key is extracted from this certificate and
if it does not exactly match the public key provided to this option, curl
aborts the connection before sending or receiving any data.
This option is independent of option \fICURLOPT_SSL_VERIFYPEER(3)\fP. If you
turn off that option then the peer is still verified by public key.
On mismatch, \fICURLE_SSL_PINNEDPUBKEYNOTMATCH\fP is returned.
The application does not have to keep the string around after setting this
option.
.SH DEFAULT
NULL
.SH PROTOCOLS
All TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc.
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
curl_easy_setopt(curl, CURLOPT_PINNEDPUBLICKEY, "/etc/publickey.der");
/* OR
curl_easy_setopt(curl, CURLOPT_PINNEDPUBLICKEY, "sha256//YhKJKSzoTt2b5FP18fvpHo7fJYqQCjAa3HWY3tvRMwE=;sha256//t62CeU2tQiqkexU74Gxa2eg7fRbEgoChTociMee9wno=");
*/
/* Perform the request */
curl_easy_perform(curl);
}
.fi
.SH PUBLIC KEY EXTRACTION
If you do not have the server's public key file you can extract it from the
server's certificate.
.nf
# retrieve the server's certificate if you do not already have it
#
# be sure to examine the certificate to see if it is what you expected
#
# Windows-specific:
# - Use NUL instead of /dev/null.
# - OpenSSL may wait for input instead of disconnecting. Hit enter.
# - If you do not have sed, then just copy the certificate into a file:
# Lines from -----BEGIN CERTIFICATE----- to -----END CERTIFICATE-----.
#
openssl s_client -servername www.example.com -connect www.example.com:443 < /dev/null | sed -n "/-----BEGIN/,/-----END/p" > www.example.com.pem
# extract public key in pem format from certificate
openssl x509 -in www.example.com.pem -pubkey -noout > www.example.com.pubkey.pem
# convert public key from pem to der
openssl asn1parse -noout -inform pem -in www.example.com.pubkey.pem -out www.example.com.pubkey.der
# sha256 hash and base64 encode der to string for use
openssl dgst -sha256 -binary www.example.com.pubkey.der | openssl base64
.fi
The public key in PEM format contains a header, base64 data and a
footer:
.nf
-----BEGIN PUBLIC KEY-----
[BASE 64 DATA]
-----END PUBLIC KEY-----
.fi
.SH AVAILABILITY
PEM/DER support:
7.39.0: OpenSSL, GnuTLS
7.43.0: wolfSSL
7.47.0: mbedTLS
7.54.1: Secure Transport on macOS 10.7+/iOS 10+
7.58.1: Schannel
sha256 support:
7.44.0: OpenSSL, GnuTLS and wolfSSL
7.47.0: mbedTLS
7.54.1: Secure Transport on macOS 10.7+/iOS 10+
7.58.1: Schannel
Other SSL backends not supported.
.SH RETURN VALUE
Returns CURLE_OK if TLS enabled, CURLE_UNKNOWN_OPTION if not, or
CURLE_OUT_OF_MEMORY if there was insufficient heap space.
.SH "SEE ALSO"
.BR CURLOPT_CAINFO (3),
.BR CURLOPT_CAPATH (3),
.BR CURLOPT_SSL_VERIFYHOST (3),
.BR CURLOPT_SSL_VERIFYPEER (3)
man/man3/CURLOPT_PROXY_CAPATH.3 0000644 00000005321 14751172372 0011424 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_PROXY_CAPATH 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_PROXY_CAPATH \- directory holding HTTPS proxy CA certificates
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_PROXY_CAPATH, char *capath);
.fi
.SH DESCRIPTION
Pass a char * to a null-terminated string naming a directory holding multiple
CA certificates to verify the HTTPS proxy with. If libcurl is built against
OpenSSL, the certificate directory must be prepared using the OpenSSL
\fBc_rehash\fP utility. This makes sense only when
\fICURLOPT_PROXY_SSL_VERIFYPEER(3)\fP is enabled (which it is by default).
The application does not have to keep the string around after setting this
option.
The default value for this can be figured out with \fICURLINFO_CAPATH(3)\fP.
.SH DEFAULT
NULL
.SH PROTOCOLS
Everything used over an HTTPS proxy
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/");
/* using an HTTPS proxy */
curl_easy_setopt(curl, CURLOPT_PROXY, "https://localhost:443");
curl_easy_setopt(curl, CURLOPT_PROXY_CAPATH, "/etc/cert-dir");
ret = curl_easy_perform(curl);
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Added in 7.52.0
This option is supported by the OpenSSL, GnuTLS, and mbedTLS (since 7.56.0)
backends.
.SH RETURN VALUE
CURLE_OK if supported; or an error such as:
CURLE_NOT_BUILT_IN - Not supported by the SSL backend
CURLE_UNKNOWN_OPTION
CURLE_OUT_OF_MEMORY
.SH "SEE ALSO"
.BR CURLOPT_CAINFO (3),
.BR CURLOPT_DEBUGFUNCTION (3),
.BR CURLOPT_PROXY_CAINFO (3),
.BR CURLOPT_PROXY_SSL_VERIFYHOST (3),
.BR CURLOPT_STDERR (3)
man/man3/CURLOPT_SSH_HOST_PUBLIC_KEY_MD5.3 0000644 00000004772 14751172372 0013201 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_SSH_HOST_PUBLIC_KEY_MD5 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_SSH_HOST_PUBLIC_KEY_MD5 \- MD5 checksum of SSH server public key
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_SSH_HOST_PUBLIC_KEY_MD5,
char *md5);
.SH DESCRIPTION
Pass a char * pointing to a string containing 32 hexadecimal digits. The
string should be the 128 bit MD5 checksum of the remote host's public key, and
libcurl aborts the connection to the host unless the MD5 checksum match.
MD5 is a weak algorithm. We strongly recommend using
\fICURLOPT_SSH_HOST_PUBLIC_KEY_SHA256(3)\fP instead.
The application does not have to keep the string around after setting this
option.
.SH DEFAULT
NULL
.SH PROTOCOLS
SCP and SFTP
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "sftp://example.com/file");
curl_easy_setopt(curl, CURLOPT_SSH_HOST_PUBLIC_KEY_MD5,
"afe17cd62a0f3b61f1ab9cb22ba269a7");
ret = curl_easy_perform(curl);
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Added in 7.17.1
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, CURLE_UNKNOWN_OPTION if not, or
CURLE_OUT_OF_MEMORY if there was insufficient heap space.
.SH "SEE ALSO"
.BR CURLOPT_SSH_AUTH_TYPES (3),
.BR CURLOPT_SSH_HOST_PUBLIC_KEY_SHA256 (3),
.BR CURLOPT_SSH_PUBLIC_KEYFILE (3),
.BR CURLOPT_SSH_KNOWNHOSTS (3)
man/man3/CURLOPT_PROXY_SSLCERTTYPE.3 0000644 00000005230 14751172372 0012304 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_PROXY_SSLCERTTYPE 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_PROXY_SSLCERTTYPE \- type of the proxy client SSL certificate
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_PROXY_SSLCERTTYPE, char *type);
.fi
.SH DESCRIPTION
Pass a pointer to a null-terminated string as parameter. The string should be
the format of your client certificate used when connecting to an HTTPS proxy.
Supported formats are "PEM" and "DER", except with Secure Transport or
Schannel. OpenSSL (versions 0.9.3 and later), Secure Transport (on iOS 5 or
later, or OS X 10.7 or later) and Schannel support "P12" for PKCS#12-encoded
files.
The application does not have to keep the string around after setting this
option.
.SH DEFAULT
"PEM"
.SH PROTOCOLS
All
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/");
curl_easy_setopt(curl, CURLOPT_PROXY, "https://proxy");
curl_easy_setopt(curl, CURLOPT_PROXY_SSLCERT, "client.pem");
curl_easy_setopt(curl, CURLOPT_PROXY_SSLCERTTYPE, "PEM");
curl_easy_setopt(curl, CURLOPT_PROXY_SSLKEY, "key.pem");
curl_easy_setopt(curl, CURLOPT_PROXY_KEYPASSWD, "s3cret");
ret = curl_easy_perform(curl);
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Added in 7.52.0
If built TLS enabled.
.SH RETURN VALUE
Returns CURLE_OK if TLS is supported, CURLE_UNKNOWN_OPTION if not, or
CURLE_OUT_OF_MEMORY if there was insufficient heap space.
.SH "SEE ALSO"
.BR CURLOPT_PROXY_SSLCERT (3),
.BR CURLOPT_PROXY_SSLKEY (3),
.BR CURLOPT_SSLCERTTYPE (3)
man/man3/CURLOPT_FORBID_REUSE.3 0000644 00000004407 14751172372 0011377 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_FORBID_REUSE 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_FORBID_REUSE \- make connection get closed at once after use
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_FORBID_REUSE, long close);
.fi
.SH DESCRIPTION
Pass a long. Set \fIclose\fP to 1 to make libcurl explicitly close the
connection when done with the transfer. Normally, libcurl keeps all
connections alive when done with one transfer in case a succeeding one follows
that can reuse them. This option should be used with caution and only if you
understand what it does as it can seriously impact performance.
Set to 0 to have libcurl keep the connection open for possible later reuse
(default behavior).
.SH DEFAULT
0
.SH PROTOCOLS
Most
.SH EXAMPLE
.nf
{
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/");
curl_easy_setopt(curl, CURLOPT_FORBID_REUSE, 1L);
curl_easy_perform(curl);
/* this second transfer may not reuse the same connection */
curl_easy_perform(curl);
}
.fi
.SH AVAILABILITY
Always
.SH RETURN VALUE
Returns CURLE_OK
.SH "SEE ALSO"
.BR CURLOPT_FRESH_CONNECT (3),
.BR CURLOPT_MAXCONNECTS (3),
.BR CURLOPT_MAXLIFETIME_CONN (3)
man/man3/CURLOPT_FTP_FILEMETHOD.3 0000644 00000005617 14751172372 0011624 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_FTP_FILEMETHOD 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_FTP_FILEMETHOD \- select directory traversing method for FTP
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_FTP_FILEMETHOD,
long method);
.SH DESCRIPTION
Pass a long telling libcurl which \fImethod\fP to use to reach a file on a
FTP(S) server.
This option exists because some server implementations are not compliant to
what the standards say should work.
The argument should be one of the following alternatives:
.IP CURLFTPMETHOD_MULTICWD
libcurl does a single CWD operation for each path part in the given URL. For
deep hierarchies this means many commands. This is how RFC 1738 says it should
be done. This is the default but the slowest behavior.
.IP CURLFTPMETHOD_NOCWD
libcurl makes no CWD at all. libcurl does SIZE, RETR, STOR etc and gives a
full path to the server for all these commands. This is the fastest behavior
since it skips having to change directories.
.IP CURLFTPMETHOD_SINGLECWD
libcurl does one CWD with the full target directory and then operates on the
file \&"normally" (like in the multicwd case). This is somewhat more standards
compliant than 'nocwd' but without the full penalty of 'multicwd'.
.SH DEFAULT
CURLFTPMETHOD_MULTICWD
.SH PROTOCOLS
FTP
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "ftp://example.com/1/2/3/4/new.txt");
curl_easy_setopt(curl, CURLOPT_FTP_FILEMETHOD,
(long)CURLFTPMETHOD_SINGLECWD);
ret = curl_easy_perform(curl);
curl_easy_cleanup(curl);
}
.fi
.SH AVAILABILITY
Added in 7.15.1
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR CURLOPT_DIRLISTONLY (3),
.BR CURLOPT_FTP_SKIP_PASV_IP (3)
man/man3/curl_multi_wakeup.3 0000644 00000005365 14751172372 0012016 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.TH curl_multi_wakeup 3 "September 26, 2023" "libcurl 8.4.0" "libcurl"
.SH NAME
curl_multi_wakeup - wakes up a sleeping curl_multi_poll call
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLMcode curl_multi_wakeup(CURLM *multi_handle);
.fi
.SH DESCRIPTION
This function can be called from any thread and it wakes up a sleeping
\fIcurl_multi_poll(3)\fP call that is currently (or is about to be) waiting
for activity or a timeout.
If the function is called when there is no \fIcurl_multi_poll(3)\fP call, it
causes the next call to return immediately.
Calling this function only guarantees to wake up the current (or the next if
there is no current) \fIcurl_multi_poll(3)\fP call, which means it is possible
that multiple calls to this function wake up the same waiting operation.
This function has no effect on \fIcurl_multi_wait(3)\fP calls.
.SH EXAMPLE
.nf
CURL *easy_handle;
CURLM *multi_handle;
/* add the individual easy handle */
curl_multi_add_handle(multi_handle, easy_handle);
/* this is thread 1 */
do {
CURLMcode mc;
int numfds;
mc = curl_multi_perform(multi_handle, &still_running);
if(mc == CURLM_OK) {
/* wait for activity, timeout or wakeup */
mc = curl_multi_poll(multi_handle, NULL, 0, 10000, &numfds);
}
if(time_to_die())
exit(1);
} while(still_running);
curl_multi_remove_handle(multi_handle, easy_handle);
/* this is thread 2 */
if(something makes us decide to stop thread 1) {
set_something_to_signal_thread_1_to_exit();
curl_multi_wakeup(multi_handle);
}
.fi
.SH AVAILABILITY
Added in 7.68.0
.SH RETURN VALUE
CURLMcode type, general libcurl multi interface error code.
.SH "SEE ALSO"
.BR curl_multi_poll (3),
.BR curl_multi_wait (3)
man/man3/CURLOPT_HTTP_VERSION.3 0000644 00000007636 14751172372 0011462 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_HTTP_VERSION 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_HTTP_VERSION \- HTTP protocol version to use
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_HTTP_VERSION, long version);
.fi
.SH DESCRIPTION
Pass \fIversion\fP a long, set to one of the values described below. They ask
libcurl to use the specific HTTP versions.
Note that the HTTP version is just a request. libcurl still prioritizes to
reuse existing connections so it might then reuse a connection using a HTTP
version you have not asked for.
.IP CURL_HTTP_VERSION_NONE
We do not care about what version the library uses. libcurl uses whatever it
thinks fit.
.IP CURL_HTTP_VERSION_1_0
Enforce HTTP 1.0 requests.
.IP CURL_HTTP_VERSION_1_1
Enforce HTTP 1.1 requests.
.IP CURL_HTTP_VERSION_2_0
Attempt HTTP 2 requests. libcurl falls back to HTTP 1.1 if HTTP 2 cannot be
negotiated with the server. (Added in 7.33.0)
When libcurl uses HTTP/2 over HTTPS, it does not itself insist on TLS 1.2 or
higher even though that is required by the specification. A user can add this
version requirement with \fICURLOPT_SSLVERSION(3)\fP.
The alias \fICURL_HTTP_VERSION_2\fP was added in 7.43.0 to better reflect the
actual protocol name.
.IP CURL_HTTP_VERSION_2TLS
Attempt HTTP 2 over TLS (HTTPS) only. libcurl falls back to HTTP 1.1 if HTTP 2
cannot be negotiated with the HTTPS server. For clear text HTTP servers,
libcurl uses 1.1. (Added in 7.47.0)
.IP CURL_HTTP_VERSION_2_PRIOR_KNOWLEDGE
Issue non-TLS HTTP requests using HTTP/2 without HTTP/1.1 Upgrade. It requires
prior knowledge that the server supports HTTP/2 straight away. HTTPS requests
still do HTTP/2 the standard way with negotiated protocol version in the TLS
handshake. (Added in 7.49.0)
.IP CURL_HTTP_VERSION_3
(Added in 7.66.0) This option makes libcurl attempt to use HTTP/3 to the host
given in the URL, with fallback to earlier HTTP versions if needed.
.IP CURL_HTTP_VERSION_3ONLY
(Added in 7.88.0) Setting this makes libcurl attempt to use HTTP/3 directly to
server given in the URL and does not downgrade to earlier HTTP version if the
server does not support HTTP/3.
.SH DEFAULT
Since curl 7.62.0: CURL_HTTP_VERSION_2TLS
Before that: CURL_HTTP_VERSION_1_1
.SH PROTOCOLS
HTTP
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
CURLcode ret;
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/");
curl_easy_setopt(curl, CURLOPT_HTTP_VERSION,
(long)CURL_HTTP_VERSION_2TLS);
ret = curl_easy_perform(curl);
if(ret == CURLE_HTTP_RETURNED_ERROR) {
/* an HTTP response error problem */
}
}
.fi
.SH AVAILABILITY
Along with HTTP
.SH RETURN VALUE
Returns CURLE_OK if HTTP is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR CURLOPT_ALTSVC (3),
.BR CURLOPT_HTTP09_ALLOWED (3),
.BR CURLOPT_HTTP200ALIASES (3),
.BR CURLOPT_SSLVERSION (3)
man/man3/CURLOPT_SEEKDATA.3 0000644 00000004163 14751172372 0010647 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_SEEKDATA 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_SEEKDATA \- pointer passed to the seek callback
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_SEEKDATA, void *pointer);
.fi
.SH DESCRIPTION
Data \fIpointer\fP to pass to the seek callback function. If you use the
\fICURLOPT_SEEKFUNCTION(3)\fP option, this is the pointer you get as input.
.SH DEFAULT
If you do not set this, NULL is passed to the callback.
.SH PROTOCOLS
HTTP, FTP, SFTP
.SH EXAMPLE
.nf
static int seek_cb(void *clientp, curl_off_t offset, int origin)
{
struct data *d = (struct data *)clientp;
lseek(d->our_fd, offset, origin);
return CURL_SEEKFUNC_OK;
}
{
struct data seek_data;
curl_easy_setopt(CURL *handle, CURLOPT_SEEKFUNCTION, seek_cb);
curl_easy_setopt(CURL *handle, CURLOPT_SEEKDATA, &seek_data);
}
.fi
.SH AVAILABILITY
Added in 7.18.0
.SH RETURN VALUE
.SH "SEE ALSO"
.BR CURLOPT_DEBUGFUNCTION (3),
.BR CURLOPT_IOCTLFUNCTION (3),
.BR CURLOPT_SEEKFUNCTION (3),
.BR CURLOPT_STDERR (3)
man/man3/CURLOPT_PREREQFUNCTION.3 0000644 00000010262 14751172372 0011627 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Max Dymond, <max.dymond@microsoft.com>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_PREREQFUNCTION 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_PREREQFUNCTION \- user callback called when a connection has been
established, but before a request has been made.
.SH SYNOPSIS
.nf
#include <curl/curl.h>
/* These are the return codes for the pre-request callback. */
#define CURL_PREREQFUNC_OK 0
#define CURL_PREREQFUNC_ABORT 1 /* fail the entire transfer */
int prereq_callback(void *clientp,
char *conn_primary_ip,
char *conn_local_ip,
int conn_primary_port,
int conn_local_port);
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_PREREQFUNCTION, prereq_callback);
.SH DESCRIPTION
Pass a pointer to your callback function, which should match the prototype
shown above.
This function gets called by libcurl after a connection has been established
or a connection has been reused (including any SSL handshaking), but before any
request is actually made on the connection. For example, for HTTP, this
callback is called once a connection has been established to the server, but
before a GET/HEAD/POST/etc request has been sent.
This function may be called multiple times if redirections are enabled and are
being followed (see \fICURLOPT_FOLLOWLOCATION(3)\fP).
The callback function must return \fICURL_PREREQFUNC_OK\fP on success, or
\fICURL_PREREQFUNC_ABORT\fP to cause the transfer to fail.
This function is passed the following arguments:
.IP conn_primary_ip
A null-terminated pointer to a C string containing the primary IP of the
remote server established with this connection. For FTP, this is the IP for
the control connection. IPv6 addresses are represented without surrounding
brackets.
.IP conn_local_ip
A null-terminated pointer to a C string containing the originating IP for this
connection. IPv6 addresses are represented without surrounding brackets.
.IP conn_primary_port
The primary port number on the remote server established with this connection.
For FTP, this is the port for the control connection. This can be a TCP or a
UDP port number depending on the protocol.
.IP conn_local_port
The originating port number for this connection. This can be a TCP or a UDP
port number depending on the protocol.
.IP clientp
The pointer you set with \fICURLOPT_PREREQDATA(3)\fP.
.SH DEFAULT
By default, this is NULL and unused.
.SH PROTOCOLS
ALL
.SH EXAMPLE
.nf
static int prereq_callback(void *clientp,
char *conn_primary_ip,
char *conn_local_ip,
int conn_primary_port,
int conn_local_port)
{
printf("Connection made to %s:%s\\n", conn_primary_ip, conn_primary_port);
return CURL_PREREQFUNC_OK;
}
{
struct data prereq_data;
curl_easy_setopt(CURL *handle, CURLOPT_PREREQFUNCTION, prereq_callback);
curl_easy_setopt(CURL *handle, CURLOPT_PREREQDATA, &prereq_data);
}
.fi
.SH AVAILABILITY
Added in 7.80.0
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR CURLINFO_PRIMARY_IP (3),
.BR CURLINFO_PRIMARY_PORT (3),
.BR CURLOPT_PREREQDATA (3)
man/man3/CURLOPT_CURLU.3 0000644 00000005021 14751172372 0010352 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_CURLU 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_CURLU \- URL in URL handle format
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_CURLU, CURLU *pointer);
.fi
.SH DESCRIPTION
Pass in a pointer to the \fIURL\fP handle to work with. The parameter should
be a \fICURLU *\fP. Setting \fICURLOPT_CURLU(3)\fP explicitly overrides
\fICURLOPT_URL(3)\fP.
\fICURLOPT_URL(3)\fP or \fICURLOPT_CURLU(3)\fP \fBmust\fP be set before a
transfer is started.
libcurl uses this handle and its contents read-only and does not change its
contents. An application can update the contents of the URL handle after a
transfer is done and if the same handle is used in a subsequent request the
updated contents is used.
.SH DEFAULT
The default value of this parameter is NULL.
.SH PROTOCOLS
All
.SH EXAMPLE
.nf
CURL *handle = curl_easy_init();
CURLU *urlp = curl_url();
int res = 0;
if(curl) {
res = curl_url_set(urlp, CURLUPART_URL, "https://example.com", 0);
curl_easy_setopt(handle, CURLOPT_CURLU, urlp);
ret = curl_easy_perform(handle);
curl_url_cleanup(urlp);
curl_easy_cleanup(handle);
}
.fi
.SH AVAILABILITY
Added in 7.63.0.
.SH RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
.SH "SEE ALSO"
.BR curl_url (3),
.BR curl_url_cleanup (3),
.BR curl_url_dup (3),
.BR curl_url_get (3),
.BR curl_url_set (3),
.BR curl_url_strerror (3),
.BR CURLOPT_URL (3)
man/man3/CURLOPT_CONNECTTIMEOUT_MS.3 0000644 00000004026 14751172372 0012223 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH CURLOPT_CONNECTTIMEOUT_MS 3 "September 26, 2023" "ibcurl 8.4.0" libcurl
.SH NAME
CURLOPT_CONNECTTIMEOUT_MS \- timeout for the connect phase
.SH SYNOPSIS
.nf
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_CONNECTTIMEOUT_MS,
long timeout);
.fi
.SH DESCRIPTION
Pass a long. It should contain the maximum time in milliseconds that you allow
the connection phase to the server to take.
See \fICURLOPT_CONNECTTIMEOUT(3)\fP for details.
.SH DEFAULT
300000
.SH PROTOCOLS
All
.SH EXAMPLE
.nf
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
/* complete connection within 10000 milliseconds */
curl_easy_setopt(curl, CURLOPT_CONNECTTIMEOUT_MS, 10000L);
curl_easy_perform(curl);
}
.fi
.SH AVAILABILITY
Always
.SH RETURN VALUE
Returns CURLE_OK
.SH "SEE ALSO"
.BR CURLOPT_CONNECTTIMEOUT (3),
.BR CURLOPT_LOW_SPEED_LIMIT (3),
.BR CURLOPT_TIMEOUT (3)
man/man1/curl.1 0000644 00000704001 14751172372 0007215 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX\-License\-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.\" DO NOT EDIT. Generated by the curl project gen.pl man page generator.
.\"
.TH curl 1 "October 05 2023" "curl 8.4.0" "curl Manual"
.SH NAME
curl \- transfer a URL
.SH SYNOPSIS
.B curl [options / URLs]
.SH DESCRIPTION
\fBcurl\fP is a tool for transferring data from or to a server using URLs. It
supports these protocols: DICT, FILE, FTP, FTPS, GOPHER, GOPHERS, HTTP, HTTPS,
IMAP, IMAPS, LDAP, LDAPS, MQTT, POP3, POP3S, RTMP, RTMPS, RTSP, SCP, SFTP,
SMB, SMBS, SMTP, SMTPS, TELNET, TFTP, WS and WSS.
curl is powered by libcurl for all transfer\-related features. See
\fIlibcurl(3)\fP for details.
.SH URL
The URL syntax is protocol\-dependent. You find a detailed description in
RFC 3986.
If you provide a URL without a leading \fBprotocol://\fP scheme, curl guesses
what protocol you want. It then defaults to HTTP but assumes others based on
often\-used host name prefixes. For example, for host names starting with
\(dqftp." curl assumes you want FTP.
You can specify any amount of URLs on the command line. They are fetched in a
sequential manner in the specified order unless you use \fI\-Z, \-\-parallel\fP. You can
specify command line options and URLs mixed and in any order on the command
line.
curl attempts to reuse connections when doing multiple transfers, so that
getting many files from the same server do not use multiple connects and setup
handshakes. This improves speed. Connection reuse can only be done for URLs
specified for a single command line invocation and cannot be performed between
separate curl runs.
Provide an IPv6 zone id in the URL with an escaped percentage sign. Like in
.nf
\(dqhttp://[fe80::3%25eth0]/"
.fi
Everything provided on the command line that is not a command line option or
its argument, curl assumes is a URL and treats it as such.
.SH GLOBBING
You can specify multiple URLs or parts of URLs by writing lists within braces
or ranges within brackets. We call this "globbing".
Provide a list with three different names like this:
.nf
\(dqhttp://site.{one,two,three}.com"
.fi
or you can get sequences of alphanumeric series by using [] as in:
.nf
\(dqftp://ftp.example.com/file[1\-100].txt"
.fi
.nf
\(dqftp://ftp.example.com/file[001\-100].txt" (with leading zeros)
.fi
.nf
\(dqftp://ftp.example.com/file[a\-z].txt"
.fi
Nested sequences are not supported, but you can use several ones next to each
other:
.nf
\(dqhttp://example.com/archive[1996\-1999]/vol[1\-4]/part{a,b,c}.html"
.fi
You can specify a step counter for the ranges to get every Nth number or
letter:
.nf
\(dqhttp://example.com/file[1\-100:10].txt"
.fi
.nf
\(dqhttp://example.com/file[a\-z:2].txt"
.fi
When using [] or {} sequences when invoked from a command line prompt, you
probably have to put the full URL within double quotes to avoid the shell from
interfering with it. This also goes for other characters treated special, like
for example \(aq&\(aq, \(aq?\(aq and \(aq*\(aq.
Switch off globbing with \fI\-g, \-\-globoff\fP.
.SH VARIABLES
curl supports command line variables (added in 8.3.0). Set variables with
\fI\-\-variable\fP name=content or \fI\-\-variable\fP name@file (where "file" can be stdin if
set to a single dash (\-)).
Variable contents can expanded in option parameters using "{{name}}" (without
the quotes) if the option name is prefixed with "\--expand\-". This gets the
contents of the variable "name" inserted, or a blank if the name does not
exist as a variable. Insert "{{" verbatim in the string by prefixing it with a
backslash, like "\\{{".
You an access and expand environment variables by first importing them. You
can select to either require the environment variable to be set or you can
provide a default value in case it is not already set. Plain \fI\-\-variable\fP %name
imports the variable called \(aqname\(aq but exits with an error if that environment
variable is not already set. To provide a default value if it is not set, use
\fI\-\-variable\fP %name=content or \fI\-\-variable\fP %name@content.
Example. Get the USER environment variable into the URL, fail if USER is not
set:
.nf
\--variable \(aq%USER\(aq
\--expand\-url = "https://example.com/api/{{USER}}/method"
.fi
When expanding variables, curl supports a set of functions that can make the
variable contents more convenient to use. It can trim leading and trailing
white space with \fItrim\fP, it can output the contents as a JSON quoted string
with \fIjson\fP, URL encode the string with \fIurl\fP or base64 encode it with
\fIb64\fP. You apply function to a variable expansion, add them colon separated to
the right side of the variable. Variable content holding null bytes that are
not encoded when expanded cause error.
Example: get the contents of a file called $HOME/.secret into a variable
called "fix". Make sure that the content is trimmed and percent\-encoded sent
as POST data:
.nf
\--variable %HOME
\--expand\-variable fix@{{HOME}}/.secret
\--expand\-data "{{fix:trim:url}}"
https://example.com/
.fi
Command line variables and expansions were added in in 8.3.0.
.SH OUTPUT
If not told otherwise, curl writes the received data to stdout. It can be
instructed to instead save that data into a local file, using the \fI\-o, \-\-output\fP or
\fI\-O, \-\-remote\-name\fP options. If curl is given multiple URLs to transfer on the
command line, it similarly needs multiple options for where to save them.
curl does not parse or otherwise "understand" the content it gets or writes as
output. It does no encoding or decoding, unless explicitly asked to with
dedicated command line options.
.SH PROTOCOLS
curl supports numerous protocols, or put in URL terms: schemes. Your
particular build may not support them all.
.IP DICT
Lets you lookup words using online dictionaries.
.IP FILE
Read or write local files. curl does not support accessing file:// URL
remotely, but when running on Microsoft Windows using the native UNC approach
works.
.IP FTP(S)
curl supports the File Transfer Protocol with a lot of tweaks and levers. With
or without using TLS.
.IP GOPHER(S)
Retrieve files.
.IP HTTP(S)
curl supports HTTP with numerous options and variations. It can speak HTTP
version 0.9, 1.0, 1.1, 2 and 3 depending on build options and the correct
command line options.
.IP IMAP(S)
Using the mail reading protocol, curl can "download" emails for you. With or
without using TLS.
.IP LDAP(S)
curl can do directory lookups for you, with or without TLS.
.IP MQTT
curl supports MQTT version 3. Downloading over MQTT equals "subscribe" to a
topic while uploading/posting equals "publish" on a topic. MQTT over TLS is
not supported (yet).
.IP POP3(S)
Downloading from a pop3 server means getting a mail. With or without using
TLS.
.IP RTMP(S)
The \fI\fPRealtime Messaging Protocol\fI\fP is primarily used to serve streaming media
and curl can download it.
.IP RTSP
curl supports RTSP 1.0 downloads.
.IP SCP
curl supports SSH version 2 scp transfers.
.IP SFTP
curl supports SFTP (draft 5) done over SSH version 2.
.IP SMB(S)
curl supports SMB version 1 for upload and download.
.IP SMTP(S)
Uploading contents to an SMTP server means sending an email. With or without
TLS.
.IP TELNET
Telling curl to fetch a telnet URL starts an interactive session where it
sends what it reads on stdin and outputs what the server sends it.
.IP TFTP
curl can do TFTP downloads and uploads.
.SH "PROGRESS METER"
curl normally displays a progress meter during operations, indicating the
amount of transferred data, transfer speeds and estimated time left, etc. The
progress meter displays the transfer rate in bytes per second. The suffixes
(k, M, G, T, P) are 1024 based. For example 1k is 1024 bytes. 1M is 1048576
bytes.
curl displays this data to the terminal by default, so if you invoke curl to
do an operation and it is about to write data to the terminal, it
\fIdisables\fP the progress meter as otherwise it would mess up the output
mixing progress meter and response data.
If you want a progress meter for HTTP POST or PUT requests, you need to
redirect the response output to a file, using shell redirect (>), \fI\-o, \-\-output\fP or
similar.
This does not apply to FTP upload as that operation does not spit out any
response data to the terminal.
If you prefer a progress "bar" instead of the regular meter, \fI\-#, \-\-progress\-bar\fP is
your friend. You can also disable the progress meter completely with the
\fI\-s, \-\-silent\fP option.
.SH VERSION
This man page describes curl 8.4.0. If you use a later version, chances are
this man page does not fully document it. If you use an earlier version, this
document tries to include version information about which specific version
that introduced changes.
You can always learn which the latest curl version is by running
.nf
curl https://curl.se/info
.fi
The online version of this man page is always showing the latest incarnation:
https://curl.se/docs/manpage.html
.SH OPTIONS
Options start with one or two dashes. Many of the options require an
additional value next to them. If provided text does not start with a dash, it
is presumed to be and treated as a URL.
The short "single\-dash" form of the options, \-d for example, may be used with
or without a space between it and its value, although a space is a recommended
separator. The long "double\-dash" form, \fI\-d, \-\-data\fP for example, requires a space
between it and its value.
Short version options that do not need any additional values can be used
immediately next to each other, like for example you can specify all the
options \fI\-O\fP, \fI\-L\fP and \fI\-v\fP at once as \fI\-OLv\fP.
In general, all boolean options are enabled with \--\fBoption\fP and yet again
disabled with \--\fBno\-\fPoption. That is, you use the same option name but
prefix it with "no\-". However, in this list we mostly only list and show the
\fI\--option\fP version of them.
When \fI\-:, \-\-next\fP is used, it resets the parser state and you start again with a
clean option state, except for the options that are "global". Global options
retain their values and meaning even after \fI\-:, \-\-next\fP.
The following options are global:
\fI\-\-fail\-early\fP, \fI\-\-libcurl\fP, \fI\-\-parallel\-immediate\fP, \fI\-Z, \-\-parallel\fP, \fI\-#, \-\-progress\-bar\fP, \fI\-\-rate\fP, \fI\-S, \-\-show\-error\fP, \fI\-\-stderr\fP, \fI\-\-styled\-output\fP, \fI\-\-trace\-ascii\fP, \fI\-\-trace\-config\fP, \fI\-\-trace\-ids\fP, \fI\-\-trace\-time\fP, \fI\-\-trace\fP and \fI\-v, \-\-verbose\fP.
.IP "\-\-abstract\-unix\-socket <path>"
(HTTP) Connect through an abstract Unix domain socket, instead of using the network.
Note: netstat shows the path of an abstract socket prefixed with \(aq@\(aq, however
the <path> argument should not have this leading character.
If \fI\-\-abstract\-unix\-socket\fP is provided several times, the last set value is used.
Example:
.nf
curl \-\-abstract\-unix\-socket socketpath https://example.com
.fi
See also \fI\-\-unix\-socket\fP. Added in 7.53.0.
.IP "\-\-alt\-svc <file name>"
(HTTPS) This option enables the alt\-svc parser in curl. If the file name points to an
existing alt\-svc cache file, that gets used. After a completed transfer, the
cache is saved to the file name again if it has been modified.
Specify a "" file name (zero length) to avoid loading/saving and make curl
just handle the cache in memory.
If this option is used several times, curl loads contents from all the
files but the last one is used for saving.
\fI\-\-alt\-svc\fP can be used several times in a command line
Example:
.nf
curl \-\-alt\-svc svc.txt https://example.com
.fi
See also \fI\-\-resolve\fP and \fI\-\-connect\-to\fP. Added in 7.64.1.
.IP "\-\-anyauth"
(HTTP) Tells curl to figure out authentication method by itself, and use the most
secure one the remote site claims to support. This is done by first doing a
request and checking the response\-headers, thus possibly inducing an extra
network round\-trip. This is used instead of setting a specific authentication
method, which you can do with \fI\-\-basic\fP, \fI\-\-digest\fP, \fI\-\-ntlm\fP, and \fI\-\-negotiate\fP.
Using \fI\-\-anyauth\fP is not recommended if you do uploads from stdin, since it may
require data to be sent twice and then the client must be able to rewind. If
the need should arise when uploading from stdin, the upload operation fails.
Used together with \fI\-u, \-\-user\fP.
Providing \fI\-\-anyauth\fP multiple times has no extra effect.
Example:
.nf
curl \-\-anyauth \-\-user me:pwd https://example.com
.fi
See also \fI\-\-proxy\-anyauth\fP, \fI\-\-basic\fP and \fI\-\-digest\fP.
.IP "\-a, \-\-append"
(FTP SFTP) When used in an upload, this option makes curl append to the target file
instead of overwriting it. If the remote file does not exist, it is
created. Note that this flag is ignored by some SFTP servers (including
OpenSSH).
Providing \fI\-a, \-\-append\fP multiple times has no extra effect.
Disable it again with \-\-no\-append.
Example:
.nf
curl \-\-upload\-file local \-\-append ftp://example.com/
.fi
See also \fI-r, \-\-range\fP and \fI-C, \-\-continue\-at\fP.
.IP "\-\-aws\-sigv4 <provider1[:provider2[:region[:service]]]>"
Use AWS V4 signature authentication in the transfer.
The provider argument is a string that is used by the algorithm when creating
outgoing authentication headers.
The region argument is a string that points to a geographic area of
a resources collection (region\-code) when the region name is omitted from
the endpoint.
The service argument is a string that points to a function provided by a cloud
(service\-code) when the service name is omitted from the endpoint.
If \fI\-\-aws\-sigv4\fP is provided several times, the last set value is used.
Example:
.nf
curl \-\-aws\-sigv4 "aws:amz:us\-east\-2:es" \-\-user "key:secret" https://example.com
.fi
See also \fI\-\-basic\fP and \fI-u, \-\-user\fP. Added in 7.75.0.
.IP "\-\-basic"
(HTTP) Tells curl to use HTTP Basic authentication with the remote host. This is the
default and this option is usually pointless, unless you use it to override a
previously set option that sets a different authentication method (such as
\fI\-\-ntlm\fP, \fI\-\-digest\fP, or \fI\-\-negotiate\fP).
Used together with \fI\-u, \-\-user\fP.
Providing \fI\-\-basic\fP multiple times has no extra effect.
Example:
.nf
curl \-u name:password \-\-basic https://example.com
.fi
See also \fI\-\-proxy\-basic\fP.
.IP "\-\-ca\-native"
(TLS) Tells curl to use the CA store from the native operating system to verify the
peer. By default, curl otherwise uses a CA store provided in a single file or
directory, but when using this option it interfaces the operating system\(aqs
own vault.
This option only works for curl on Windows when built to use OpenSSL. When
curl on Windows is built to use Schannel, this feature is implied and curl
then only uses the native CA store.
curl built with wolfSSL also supports this option (added in 8.3.0).
Providing \fI\-\-ca\-native\fP multiple times has no extra effect.
Disable it again with \-\-no\-ca\-native.
Example:
.nf
curl \-\-ca\-native https://example.com
.fi
See also \fI\-\-cacert\fP, \fI\-\-capath\fP and \fI-k, \-\-insecure\fP. Added in 8.2.0.
.IP "\-\-cacert <file>"
(TLS) Tells curl to use the specified certificate file to verify the peer. The file
may contain multiple CA certificates. The certificate(s) must be in PEM
format. Normally curl is built to use a default file for this, so this option
is typically used to alter that default file.
curl recognizes the environment variable named \(aqCURL_CA_BUNDLE\(aq if it is
set, and uses the given path as a path to a CA cert bundle. This option
overrides that variable.
The windows version of curl automatically looks for a CA certs file named
\(aqcurl\-ca\-bundle.crt\(aq, either in the same directory as curl.exe, or in the
Current Working Directory, or in any folder along your PATH.
(iOS and macOS only) If curl is built against Secure Transport, then this
option is supported for backward compatibility with other SSL engines, but it
should not be set. If the option is not set, then curl uses the certificates
in the system and user Keychain to verify the peer, which is the preferred
method of verifying the peer\(aqs certificate chain.
(Schannel only) This option is supported for Schannel in Windows 7 or later
(added in 7.60.0). This option is supported for backward compatibility with
other SSL engines; instead it is recommended to use Windows\(aq store of root
certificates (the default for Schannel).
If \fI\-\-cacert\fP is provided several times, the last set value is used.
Example:
.nf
curl \-\-cacert CA\-file.txt https://example.com
.fi
See also \fI\-\-capath\fP and \fI-k, \-\-insecure\fP.
.IP "\-\-capath <dir>"
(TLS) Tells curl to use the specified certificate directory to verify the
peer. Multiple paths can be provided by separating them with ":" (e.g.
\(dqpath1:path2:path3"). The certificates must be in PEM format, and if curl is
built against OpenSSL, the directory must have been processed using the
c_rehash utility supplied with OpenSSL. Using \fI\-\-capath\fP can allow
OpenSSL\-powered curl to make SSL\-connections much more efficiently than using
\fI\-\-cacert\fP if the \fI\-\-cacert\fP file contains many CA certificates.
If this option is set, the default capath value is ignored.
If \fI\-\-capath\fP is provided several times, the last set value is used.
Example:
.nf
curl \-\-capath /local/directory https://example.com
.fi
See also \fI\-\-cacert\fP and \fI-k, \-\-insecure\fP.
.IP "\-\-cert\-status"
(TLS) Tells curl to verify the status of the server certificate by using the
Certificate Status Request (aka. OCSP stapling) TLS extension.
If this option is enabled and the server sends an invalid (e.g. expired)
response, if the response suggests that the server certificate has been
revoked, or no response at all is received, the verification fails.
This is currently only implemented in the OpenSSL and GnuTLS backends.
Providing \fI\-\-cert\-status\fP multiple times has no extra effect.
Disable it again with \-\-no\-cert\-status.
Example:
.nf
curl \-\-cert\-status https://example.com
.fi
See also \fI\-\-pinnedpubkey\fP.
.IP "\-\-cert\-type <type>"
(TLS) Tells curl what type the provided client certificate is using. PEM, DER, ENG
and P12 are recognized types.
The default type depends on the TLS backend and is usually PEM, however for
Secure Transport and Schannel it is P12. If \fI\-E, \-\-cert\fP is a pkcs11: URI then ENG is
the default type.
If \fI\-\-cert\-type\fP is provided several times, the last set value is used.
Example:
.nf
curl \-\-cert\-type PEM \-\-cert file https://example.com
.fi
See also \fI-E, \-\-cert\fP, \fI\-\-key\fP and \fI\-\-key\-type\fP.
.IP "\-E, \-\-cert <certificate[:password]>"
(TLS) Tells curl to use the specified client certificate file when getting a file
with HTTPS, FTPS or another SSL\-based protocol. The certificate must be in
PKCS#12 format if using Secure Transport, or PEM format if using any other
engine. If the optional password is not specified, it is queried for on
the terminal. Note that this option assumes a certificate file that is the
private key and the client certificate concatenated. See \fI\-E, \-\-cert\fP and \fI\-\-key\fP to
specify them independently.
In the <certificate> portion of the argument, you must escape the character ":"
as "\\:" so that it is not recognized as the password delimiter. Similarly, you
must escape the character "\\" as "\\\\" so that it is not recognized as an
escape character.
If curl is built against OpenSSL library, and the engine pkcs11 is available,
then a PKCS#11 URI (RFC 7512) can be used to specify a certificate located in
a PKCS#11 device. A string beginning with "pkcs11:" is interpreted as a
PKCS#11 URI. If a PKCS#11 URI is provided, then the \fI\-\-engine\fP option is set as
\(dqpkcs11" if none was provided and the \fI\-\-cert\-type\fP option is set as "ENG" if
none was provided.
(iOS and macOS only) If curl is built against Secure Transport, then the
certificate string can either be the name of a certificate/private key in the
system or user keychain, or the path to a PKCS#12\-encoded certificate and
private key. If you want to use a file from the current directory, please
precede it with "./" prefix, in order to avoid confusion with a nickname.
(Schannel only) Client certificates must be specified by a path
expression to a certificate store. (Loading \fIPFX\fP is not supported; you can
import it to a store first). You can use
\(dq<store location>\\<store name>\\<thumbprint>" to refer to a certificate
in the system certificates store, for example,
\fI"CurrentUser\\MY\\934a7ac6f8a5d579285a74fa61e19f23ddfe8d7a"\fP. Thumbprint is
usually a SHA\-1 hex string which you can see in certificate details. Following
store locations are supported: \fICurrentUser\fP, \fILocalMachine\fP, \fICurrentService\fP,
\fIServices\fP, \fICurrentUserGroupPolicy\fP, \fILocalMachineGroupPolicy\fP and
\fILocalMachineEnterprise\fP.
If \fI\-E, \-\-cert\fP is provided several times, the last set value is used.
Example:
.nf
curl \-\-cert certfile \-\-key keyfile https://example.com
.fi
See also \fI\-\-cert\-type\fP, \fI\-\-key\fP and \fI\-\-key\-type\fP.
.IP "\-\-ciphers <list of ciphers>"
(TLS) Specifies which ciphers to use in the connection. The list of ciphers must
specify valid ciphers. Read up on SSL cipher list details on this URL:
https://curl.se/docs/ssl\-ciphers.html
If \fI\-\-ciphers\fP is provided several times, the last set value is used.
Example:
.nf
curl \-\-ciphers ECDHE\-ECDSA\-AES256\-CCM8 https://example.com
.fi
See also \fI\-\-tlsv1.3\fP, \fI\-\-tls13\-ciphers\fP and \fI\-\-proxy\-ciphers\fP.
.IP "\-\-compressed\-ssh"
(SCP SFTP) Enables built\-in SSH compression.
This is a request, not an order; the server may or may not do it.
Providing \fI\-\-compressed\-ssh\fP multiple times has no extra effect.
Disable it again with \-\-no\-compressed\-ssh.
Example:
.nf
curl \-\-compressed\-ssh sftp://example.com/
.fi
See also \fI\-\-compressed\fP. Added in 7.56.0.
.IP "\-\-compressed"
(HTTP) Request a compressed response using one of the algorithms curl supports, and
automatically decompress the content.
Response headers are not modified when saved, so if they are "interpreted"
separately again at a later point they might appear to be saying that the
content is (still) compressed; while in fact it has already been decompressed.
If this option is used and the server sends an unsupported encoding, curl
reports an error. This is a request, not an order; the server may or may not
deliver data compressed.
Providing \fI\-\-compressed\fP multiple times has no extra effect.
Disable it again with \-\-no\-compressed.
Example:
.nf
curl \-\-compressed https://example.com
.fi
See also \fI\-\-compressed\-ssh\fP.
.IP "\-K, \-\-config <file>"
Specify a text file to read curl arguments from. The command line arguments
found in the text file are used as if they were provided on the command
line.
Options and their parameters must be specified on the same line in the file,
separated by whitespace, colon, or the equals sign. Long option names can
optionally be given in the config file without the initial double dashes and
if so, the colon or equals characters can be used as separators. If the option
is specified with one or two dashes, there can be no colon or equals character
between the option and its parameter.
If the parameter contains whitespace or starts with a colon (:) or equals sign
(=), it must be specified enclosed within double quotes (\&"). Within double
quotes the following escape sequences are available: \\\\, \\", \\t, \\n, \\r
and \\v. A backslash preceding any other letter is ignored.
If the first non\-blank column of a config line is a \(aq#\(aq character, that line
is treated as a comment.
Only write one option per physical line in the config file. A single line is
required to be no more than 10 megabytes (since 8.2.0).
Specify the filename to \fI\-K, \-\-config\fP as \(aq\-\(aq to make curl read the file from stdin.
Note that to be able to specify a URL in the config file, you need to specify
it using the \fI\-\-url\fP option, and not by simply writing the URL on its own
line. So, it could look similar to this:
url = "https://curl.se/docs/"
.nf
# \--\- Example file \--\-
# this is a comment
url = "example.com"
output = "curlhere.html"
user\-agent = "superagent/1.0"
.fi
.nf
# and fetch another URL too
url = "example.com/docs/manpage.html"
\-O
referer = "http://nowhereatall.example.com/"
# \--\- End of example file \--\-
.fi
When curl is invoked, it (unless \fI\-q, \-\-disable\fP is used) checks for a default
config file and uses it if found, even when \fI\-K, \-\-config\fP is used. The default
config file is checked for in the following places in this order:
1) \fB"$CURL_HOME/.curlrc"\fP
2) \fB"$XDG_CONFIG_HOME/curlrc"\fP (Added in 7.73.0)
3) \fB"$HOME/.curlrc"\fP
4) Windows: \fB"%USERPROFILE%\\.curlrc"\fP
5) Windows: \fB"%APPDATA%\\.curlrc"\fP
6) Windows: \fI\fP"%USERPROFILE%\\Application Data\\.curlrc"\fI\fP
7) Non\-Windows: use getpwuid to find the home directory
8) On Windows, if it finds no \fI.curlrc\fP file in the sequence described above, it
checks for one in the same dir the curl executable is placed.
On Windows two filenames are checked per location: \fI.curlrc\fP and \fI_curlrc\fP,
preferring the former. Older versions on Windows checked for \fI_curlrc\fP only.
\fI\-K, \-\-config\fP can be used several times in a command line
Example:
.nf
curl \-\-config file.txt https://example.com
.fi
See also \fI-q, \-\-disable\fP.
.IP "\-\-connect\-timeout <fractional seconds>"
Maximum time in seconds that you allow curl\(aqs connection to take. This only
limits the connection phase, so if curl connects within the given period it
continues \- if not it exits.
This option accepts decimal values. The decimal value needs
to be provided using a dot (.) as decimal separator \- not the local version
even if it might be using another separator.
The connection phase is considered complete when the DNS lookup and requested
TCP, TLS or QUIC handshakes are done.
If \fI\-\-connect\-timeout\fP is provided several times, the last set value is used.
Examples:
.nf
curl \-\-connect\-timeout 20 https://example.com
curl \-\-connect\-timeout 3.14 https://example.com
.fi
See also \fI-m, \-\-max\-time\fP.
.IP "\-\-connect\-to <HOST1:PORT1:HOST2:PORT2>"
For a request to the given HOST1:PORT1 pair, connect to HOST2:PORT2 instead.
This option is suitable to direct requests at a specific server, e.g. at a
specific cluster node in a cluster of servers. This option is only used to
establish the network connection. It does NOT affect the hostname/port that is
used for TLS/SSL (e.g. SNI, certificate verification) or for the application
protocols. "HOST1" and "PORT1" may be the empty string, meaning "any
host/port". "HOST2" and "PORT2" may also be the empty string, meaning "use the
request\(aqs original host/port".
A "host" specified to this option is compared as a string, so it needs to
match the name used in request URL. It can be either numerical such as
\(dq127.0.0.1" or the full host name such as "example.org".
\fI\-\-connect\-to\fP can be used several times in a command line
Example:
.nf
curl \-\-connect\-to example.com:443:example.net:8443 https://example.com
.fi
See also \fI\-\-resolve\fP and \fI-H, \-\-header\fP.
.IP "\-C, \-\-continue\-at <offset>"
Continue/Resume a previous file transfer at the given offset. The given offset
is the exact number of bytes that are skipped, counting from the beginning
of the source file before it is transferred to the destination. If used with
uploads, the FTP server command SIZE is not used by curl.
Use "\-C \-" to tell curl to automatically find out where/how to resume the
transfer. It then uses the given output/input files to figure that out.
If \fI\-C, \-\-continue\-at\fP is provided several times, the last set value is used.
Examples:
.nf
curl \-C \- https://example.com
curl \-C 400 https://example.com
.fi
See also \fI-r, \-\-range\fP.
.IP "\-c, \-\-cookie\-jar <filename>"
(HTTP) Specify to which file you want curl to write all cookies after a completed
operation. Curl writes all cookies from its in\-memory cookie storage to the
given file at the end of operations. If no cookies are known, no data is
written. The file is created using the Netscape cookie file format. If you set
the file name to a single dash, "\-", the cookies are written to stdout.
The file specified with \fI\-c, \-\-cookie\-jar\fP is only used for output. No cookies are
read from the file. To read cookies, use the \fI\-b, \-\-cookie\fP option. Both options
can specify the same file.
This command line option activates the cookie engine that makes curl record
and use cookies. The \fI\-b, \-\-cookie\fP option also activates it.
If the cookie jar cannot be created or written to, the whole curl operation
does not fail or even report an error clearly. Using \fI\-v, \-\-verbose\fP gets a warning
displayed, but that is the only visible feedback you get about this possibly
lethal situation.
If \fI\-c, \-\-cookie\-jar\fP is provided several times, the last set value is used.
Examples:
.nf
curl \-c store\-here.txt https://example.com
curl \-c store\-here.txt \-b read\-these https://example.com
.fi
See also \fI-b, \-\-cookie\fP.
.IP "\-b, \-\-cookie <data|filename>"
(HTTP) Pass the data to the HTTP server in the Cookie header. It is supposedly the
data previously received from the server in a "Set\-Cookie:" line. The data
should be in the format "NAME1=VALUE1; NAME2=VALUE2". This makes curl use the
cookie header with this content explicitly in all outgoing request(s). If
multiple requests are done due to authentication, followed redirects or
similar, they all get this cookie passed on.
If no \(aq=\(aq symbol is used in the argument, it is instead treated as a filename
to read previously stored cookie from. This option also activates the cookie
engine which makes curl record incoming cookies, which may be handy if you are
using this in combination with the \fI\-L, \-\-location\fP option or do multiple URL
transfers on the same invoke. If the file name is exactly a minus ("\-"), curl
instead reads the contents from stdin.
The file format of the file to read cookies from should be plain HTTP headers
(Set\-Cookie style) or the Netscape/Mozilla cookie file format.
The file specified with \fI\-b, \-\-cookie\fP is only used as input. No cookies are written
to the file. To store cookies, use the \fI\-c, \-\-cookie\-jar\fP option.
If you use the Set\-Cookie file format and do not specify a domain then the
cookie is not sent since the domain never matches. To address this, set a
domain in Set\-Cookie line (doing that includes subdomains) or preferably: use
the Netscape format.
Users often want to both read cookies from a file and write updated cookies
back to a file, so using both \fI\-b, \-\-cookie\fP and \fI\-c, \-\-cookie\-jar\fP in the same command
line is common.
\fI\-b, \-\-cookie\fP can be used several times in a command line
Examples:
.nf
curl \-b cookiefile https://example.com
curl \-b cookiefile \-c cookiefile https://example.com
.fi
See also \fI-c, \-\-cookie\-jar\fP and \fI-j, \-\-junk\-session\-cookies\fP.
.IP "\-\-create\-dirs"
When used in conjunction with the \fI\-o, \-\-output\fP option, curl creates the necessary
local directory hierarchy as needed. This option creates the directories
mentioned with the \fI\-o, \-\-output\fP option combined with the path possibly set with
\fI\-\-output\-dir\fP. If the combined output file name uses no directory, or if the
directories it mentions already exist, no directories are created.
Created directories are made with mode 0750 on unix style file systems.
To create remote directories when using FTP or SFTP, try \fI\-\-ftp\-create\-dirs\fP.
Providing \fI\-\-create\-dirs\fP multiple times has no extra effect.
Disable it again with \-\-no\-create\-dirs.
Example:
.nf
curl \-\-create\-dirs \-\-output local/dir/file https://example.com
.fi
See also \fI\-\-ftp\-create\-dirs\fP and \fI\-\-output\-dir\fP.
.IP "\-\-create\-file\-mode <mode>"
(SFTP SCP FILE) When curl is used to create files remotely using one of the supported
protocols, this option allows the user to set which \(aqmode\(aq to set on the file
at creation time, instead of the default 0644.
This option takes an octal number as argument.
If \fI\-\-create\-file\-mode\fP is provided several times, the last set value is used.
Example:
.nf
curl \-\-create\-file\-mode 0777 \-T localfile sftp://example.com/new
.fi
See also \fI\-\-ftp\-create\-dirs\fP. Added in 7.75.0.
.IP "\-\-crlf"
(FTP SMTP) Convert line feeds to carriage return plus line feeds in upload. Useful for
\fI\fPMVS (OS/390)\fI\fP.
(SMTP added in 7.40.0)
Providing \fI\-\-crlf\fP multiple times has no extra effect.
Disable it again with \-\-no\-crlf.
Example:
.nf
curl \-\-crlf \-T file ftp://example.com/
.fi
See also \fI-B, \-\-use\-ascii\fP.
.IP "\-\-crlfile <file>"
(TLS) Provide a file using PEM format with a Certificate Revocation List that may
specify peer certificates that are to be considered revoked.
If \fI\-\-crlfile\fP is provided several times, the last set value is used.
Example:
.nf
curl \-\-crlfile rejects.txt https://example.com
.fi
See also \fI\-\-cacert\fP and \fI\-\-capath\fP.
.IP "\-\-curves <algorithm list>"
(TLS) Tells curl to request specific curves to use during SSL session establishment
according to RFC 8422, 5.1. Multiple algorithms can be provided by separating
them with ":" (e.g. "X25519:P\-521"). The parameter is available identically
in the "openssl s_client/s_server" utilities.
\fI\-\-curves\fP allows a OpenSSL powered curl to make SSL\-connections with exactly
the (EC) curve requested by the client, avoiding nontransparent client/server
negotiations.
If this option is set, the default curves list built into OpenSSL are ignored.
If \fI\-\-curves\fP is provided several times, the last set value is used.
Example:
.nf
curl \-\-curves X25519 https://example.com
.fi
See also \fI\-\-ciphers\fP. Added in 7.73.0.
.IP "\-\-data\-ascii <data>"
(HTTP) This is just an alias for \fI\-d, \-\-data\fP.
\fI\-\-data\-ascii\fP can be used several times in a command line
Example:
.nf
curl \-\-data\-ascii @file https://example.com
.fi
See also \fI\-\-data\-binary\fP, \fI\-\-data\-raw\fP and \fI\-\-data\-urlencode\fP.
.IP "\-\-data\-binary <data>"
(HTTP) This posts data exactly as specified with no extra processing whatsoever.
If you start the data with the letter @, the rest should be a filename. Data
is posted in a similar manner as \fI\-d, \-\-data\fP does, except that newlines and
carriage returns are preserved and conversions are never done.
Like \fI\-d, \-\-data\fP the default content\-type sent to the server is
application/x\-www\-form\-urlencoded. If you want the data to be treated as
arbitrary binary data by the server then set the content\-type to octet\-stream:
-H "Content\-Type: application/octet\-stream".
If this option is used several times, the ones following the first append
data as described in \fI\-d, \-\-data\fP.
\fI\-\-data\-binary\fP can be used several times in a command line
Example:
.nf
curl \-\-data\-binary @filename https://example.com
.fi
See also \fI\-\-data\-ascii\fP.
.IP "\-\-data\-raw <data>"
(HTTP) This posts data similarly to \fI\-d, \-\-data\fP but without the special
interpretation of the @ character.
\fI\-\-data\-raw\fP can be used several times in a command line
Examples:
.nf
curl \-\-data\-raw "hello" https://example.com
curl \-\-data\-raw "@at@at@" https://example.com
.fi
See also \fI-d, \-\-data\fP.
.IP "\-\-data\-urlencode <data>"
(HTTP) This posts data, similar to the other \fI\-d, \-\-data\fP options with the exception
that this performs URL\-encoding.
To be CGI\-compliant, the <data> part should begin with a \fIname\fP followed
by a separator and a content specification. The <data> part can be passed to
curl using one of the following syntaxes:
.RS
.IP "content"
This makes curl URL\-encode the content and pass that on. Just be careful
so that the content does not contain any = or @ symbols, as that makes
the syntax match one of the other cases below!
.IP "=content"
This makes curl URL\-encode the content and pass that on. The preceding =
symbol is not included in the data.
.IP "name=content"
This makes curl URL\-encode the content part and pass that on. Note that
the name part is expected to be URL\-encoded already.
.IP "@filename"
This makes curl load data from the given file (including any newlines),
URL\-encode that data and pass it on in the POST.
.IP "name@filename"
This makes curl load data from the given file (including any newlines),
URL\-encode that data and pass it on in the POST. The name part gets an equal
sign appended, resulting in \fIname=urlencoded\-file\-content\fP. Note that the
name is expected to be URL\-encoded already.
.RE
.IP
\fI\-\-data\-urlencode\fP can be used several times in a command line
Examples:
.nf
curl \-\-data\-urlencode name=val https://example.com
curl \-\-data\-urlencode =encodethis https://example.com
curl \-\-data\-urlencode name@file https://example.com
curl \-\-data\-urlencode @fileonly https://example.com
.fi
See also \fI-d, \-\-data\fP and \fI\-\-data\-raw\fP.
.IP "\-d, \-\-data <data>"
(HTTP MQTT) Sends the specified data in a POST request to the HTTP server, in the same way
that a browser does when a user has filled in an HTML form and presses the
submit button. This makes curl pass the data to the server using the
content\-type application/x\-www\-form\-urlencoded. Compare to \fI\-F, \-\-form\fP.
\fI\-\-data\-raw\fP is almost the same but does not have a special interpretation of
the @ character. To post data purely binary, you should instead use the
\fI\-\-data\-binary\fP option. To URL\-encode the value of a form field you may use
\fI\-\-data\-urlencode\fP.
If any of these options is used more than once on the same command line, the
data pieces specified are merged with a separating &\-symbol. Thus, using
\(aq\-d name=daniel \-d skill=lousy\(aq would generate a post chunk that looks like
\(aqname=daniel&skill=lousy\(aq.
If you start the data with the letter @, the rest should be a file name to
read the data from, or \- if you want curl to read the data from stdin. Posting
data from a file named \(aqfoobar\(aq would thus be done with \fI\-d, \-\-data\fP @foobar. When
\fI\-d, \-\-data\fP is told to read from a file like that, carriage returns and newlines
are stripped out. If you do not want the @ character to have a special
interpretation use \fI\-\-data\-raw\fP instead.
The data for this option is passed on to the server exactly as provided on the
command line. curl does not convert, change or improve it. It is up to the
user to provide the data in the correct form.
\fI\-d, \-\-data\fP can be used several times in a command line
Examples:
.nf
curl \-d "name=curl" https://example.com
curl \-d "name=curl" \-d "tool=cmdline" https://example.com
curl \-d @filename https://example.com
.fi
See also \fI\-\-data\-binary\fP, \fI\-\-data\-urlencode\fP and \fI\-\-data\-raw\fP. This option is mutually exclusive to \fI-F, \-\-form\fP and \fI-I, \-\-head\fP and \fI-T, \-\-upload\-file\fP.
.IP "\-\-delegation <LEVEL>"
(GSS/kerberos) Set LEVEL to tell the server what it is allowed to delegate when it
comes to user credentials.
.RS
.IP "none"
Do not allow any delegation.
.IP "policy"
Delegates if and only if the OK\-AS\-DELEGATE flag is set in the Kerberos
service ticket, which is a matter of realm policy.
.IP "always"
Unconditionally allow the server to delegate.
.RE
.IP
If \fI\-\-delegation\fP is provided several times, the last set value is used.
Example:
.nf
curl \-\-delegation "none" https://example.com
.fi
See also \fI-k, \-\-insecure\fP and \fI\-\-ssl\fP.
.IP "\-\-digest"
(HTTP) Enables HTTP Digest authentication. This is an authentication scheme that
prevents the password from being sent over the wire in clear text. Use this in
combination with the normal \fI\-u, \-\-user\fP option to set user name and password.
Providing \fI\-\-digest\fP multiple times has no extra effect.
Disable it again with \-\-no\-digest.
Example:
.nf
curl \-u name:password \-\-digest https://example.com
.fi
See also \fI-u, \-\-user\fP, \fI\-\-proxy\-digest\fP and \fI\-\-anyauth\fP. This option is mutually exclusive to \fI\-\-basic\fP and \fI\-\-ntlm\fP and \fI\-\-negotiate\fP.
.IP "\-\-disable\-eprt"
(FTP) Tell curl to disable the use of the EPRT and LPRT commands when doing active
FTP transfers. Curl normally first attempts to use EPRT before using PORT, but
with this option, it uses PORT right away. EPRT is an extension to the
original FTP protocol, and does not work on all servers, but enables more
functionality in a better way than the traditional PORT command.
-\-eprt can be used to explicitly enable EPRT again and \--no\-eprt is an alias
for \fI\-\-disable\-eprt\fP.
If the server is accessed using IPv6, this option has no effect as EPRT is
necessary then.
Disabling EPRT only changes the active behavior. If you want to switch to
passive mode you need to not use \fI\-P, \-\-ftp\-port\fP or force it with \fI\-\-ftp\-pasv\fP.
Providing \fI\-\-disable\-eprt\fP multiple times has no extra effect.
Disable it again with \-\-no\-disable\-eprt.
Example:
.nf
curl \-\-disable\-eprt ftp://example.com/
.fi
See also \fI\-\-disable\-epsv\fP and \fI-P, \-\-ftp\-port\fP.
.IP "\-\-disable\-epsv"
(FTP) Tell curl to disable the use of the EPSV command when doing passive FTP
transfers. Curl normally first attempts to use EPSV before PASV, but with this
option, it does not try EPSV.
-\-epsv can be used to explicitly enable EPSV again and \--no\-epsv is an alias
for \fI\-\-disable\-epsv\fP.
If the server is an IPv6 host, this option has no effect as EPSV is necessary
then.
Disabling EPSV only changes the passive behavior. If you want to switch to
active mode you need to use \fI\-P, \-\-ftp\-port\fP.
Providing \fI\-\-disable\-epsv\fP multiple times has no extra effect.
Disable it again with \-\-no\-disable\-epsv.
Example:
.nf
curl \-\-disable\-epsv ftp://example.com/
.fi
See also \fI\-\-disable\-eprt\fP and \fI-P, \-\-ftp\-port\fP.
.IP "\-q, \-\-disable"
If used as the \fBfirst\fP parameter on the command line, the \fIcurlrc\fP config
file is not read or used. See the \fI\-K, \-\-config\fP for details on the default config
file search path.
Prior to 7.50.0 curl supported the short option name \fIq\fP but not the long
option name \fIdisable\fP.
Providing \fI\-q, \-\-disable\fP multiple times has no extra effect.
Disable it again with \-\-no\-disable.
Example:
.nf
curl \-q https://example.com
.fi
See also \fI-K, \-\-config\fP.
.IP "\-\-disallow\-username\-in\-url"
(HTTP) This tells curl to exit if passed a URL containing a username. This is probably
most useful when the URL is being provided at runtime or similar.
Providing \fI\-\-disallow\-username\-in\-url\fP multiple times has no extra effect.
Disable it again with \-\-no\-disallow\-username\-in\-url.
Example:
.nf
curl \-\-disallow\-username\-in\-url https://example.com
.fi
See also \fI\-\-proto\fP. Added in 7.61.0.
.IP "\-\-dns\-interface <interface>"
(DNS) Tell curl to send outgoing DNS requests through <interface>. This option is a
counterpart to \fI\-\-interface\fP (which does not affect DNS). The supplied string
must be an interface name (not an address).
If \fI\-\-dns\-interface\fP is provided several times, the last set value is used.
Example:
.nf
curl \-\-dns\-interface eth0 https://example.com
.fi
See also \fI\-\-dns\-ipv4\-addr\fP and \fI\-\-dns\-ipv6\-addr\fP. \fI\-\-dns\-interface\fP requires that the underlying libcurl was built to support c-ares.
.IP "\-\-dns\-ipv4\-addr <address>"
(DNS) Tell curl to bind to a specific IP address when making IPv4 DNS requests, so
that the DNS requests originate from this address. The argument should be a
single IPv4 address.
If \fI\-\-dns\-ipv4\-addr\fP is provided several times, the last set value is used.
Example:
.nf
curl \-\-dns\-ipv4\-addr 10.1.2.3 https://example.com
.fi
See also \fI\-\-dns\-interface\fP and \fI\-\-dns\-ipv6\-addr\fP. \fI\-\-dns\-ipv4\-addr\fP requires that the underlying libcurl was built to support c-ares.
.IP "\-\-dns\-ipv6\-addr <address>"
(DNS) Tell curl to bind to a specific IP address when making IPv6 DNS requests, so
that the DNS requests originate from this address. The argument should be a
single IPv6 address.
If \fI\-\-dns\-ipv6\-addr\fP is provided several times, the last set value is used.
Example:
.nf
curl \-\-dns\-ipv6\-addr 2a04:4e42::561 https://example.com
.fi
See also \fI\-\-dns\-interface\fP and \fI\-\-dns\-ipv4\-addr\fP. \fI\-\-dns\-ipv6\-addr\fP requires that the underlying libcurl was built to support c-ares.
.IP "\-\-dns\-servers <addresses>"
Set the list of DNS servers to be used instead of the system default.
The list of IP addresses should be separated with commas. Port numbers
may also optionally be given as \fI:<port\-number>\fP after each IP
address.
If \fI\-\-dns\-servers\fP is provided several times, the last set value is used.
Example:
.nf
curl \-\-dns\-servers 192.168.0.1,192.168.0.2 https://example.com
.fi
See also \fI\-\-dns\-interface\fP and \fI\-\-dns\-ipv4\-addr\fP. \fI\-\-dns\-servers\fP requires that the underlying libcurl was built to support c-ares.
.IP "\-\-doh\-cert\-status"
Same as \fI\-\-cert\-status\fP but used for DoH (DNS\-over\-HTTPS).
Providing \fI\-\-doh\-cert\-status\fP multiple times has no extra effect.
Disable it again with \-\-no\-doh\-cert\-status.
Example:
.nf
curl \-\-doh\-cert\-status \-\-doh\-url https://doh.example https://example.com
.fi
See also \fI\-\-doh\-insecure\fP. Added in 7.76.0.
.IP "\-\-doh\-insecure"
Same as \fI\-k, \-\-insecure\fP but used for DoH (DNS\-over\-HTTPS).
Providing \fI\-\-doh\-insecure\fP multiple times has no extra effect.
Disable it again with \-\-no\-doh\-insecure.
Example:
.nf
curl \-\-doh\-insecure \-\-doh\-url https://doh.example https://example.com
.fi
See also \fI\-\-doh\-url\fP. Added in 7.76.0.
.IP "\-\-doh\-url <URL>"
Specifies which DNS\-over\-HTTPS (DoH) server to use to resolve hostnames,
instead of using the default name resolver mechanism. The URL must be HTTPS.
Some SSL options that you set for your transfer also applies to DoH since the
name lookups take place over SSL. However, the certificate verification
settings are not inherited but are controlled separately via \fI\-\-doh\-insecure\fP
and \fI\-\-doh\-cert\-status\fP.
This option is unset if an empty string "" is used as the URL.
(Added in 7.85.0)
If \fI\-\-doh\-url\fP is provided several times, the last set value is used.
Example:
.nf
curl \-\-doh\-url https://doh.example https://example.com
.fi
See also \fI\-\-doh\-insecure\fP. Added in 7.62.0.
.IP "\-D, \-\-dump\-header <filename>"
(HTTP FTP) Write the received protocol headers to the specified file. If no headers are
received, the use of this option creates an empty file.
When used in FTP, the FTP server response lines are considered being "headers"
and thus are saved there.
Having multiple transfers in one set of operations (i.e. the URLs in one
\fI\-:, \-\-next\fP clause), appends them to the same file, separated by a blank line.
If \fI\-D, \-\-dump\-header\fP is provided several times, the last set value is used.
Example:
.nf
curl \-\-dump\-header store.txt https://example.com
.fi
See also \fI-o, \-\-output\fP.
.IP "\-\-egd\-file <file>"
(TLS) Deprecated option (added in 7.84.0). Prior to that it only had an effect on
curl if built to use old versions of OpenSSL.
Specify the path name to the Entropy Gathering Daemon socket. The socket is
used to seed the random engine for SSL connections.
If \fI\-\-egd\-file\fP is provided several times, the last set value is used.
Example:
.nf
curl \-\-egd\-file /random/here https://example.com
.fi
See also \fI\-\-random\-file\fP.
.IP "\-\-engine <name>"
(TLS) Select the OpenSSL crypto engine to use for cipher operations. Use \fI\-\-engine\fP
list to print a list of build\-time supported engines. Note that not all (and
possibly none) of the engines may be available at runtime.
If \fI\-\-engine\fP is provided several times, the last set value is used.
Example:
.nf
curl \-\-engine flavor https://example.com
.fi
See also \fI\-\-ciphers\fP and \fI\-\-curves\fP.
.IP "\-\-etag\-compare <file>"
(HTTP) This option makes a conditional HTTP request for the specific ETag read
from the given file by sending a custom If\-None\-Match header using the
stored ETag.
For correct results, make sure that the specified file contains only a
single line with the desired ETag. An empty file is parsed as an empty
ETag.
Use the option \fI\-\-etag\-save\fP to first save the ETag from a response, and
then use this option to compare against the saved ETag in a subsequent
request.
If \fI\-\-etag\-compare\fP is provided several times, the last set value is used.
Example:
.nf
curl \-\-etag\-compare etag.txt https://example.com
.fi
See also \fI\-\-etag\-save\fP and \fI-z, \-\-time\-cond\fP. Added in 7.68.0.
.IP "\-\-etag\-save <file>"
(HTTP) This option saves an HTTP ETag to the specified file. An ETag is a
caching related header, usually returned in a response.
If no ETag is sent by the server, an empty file is created.
If \fI\-\-etag\-save\fP is provided several times, the last set value is used.
Example:
.nf
curl \-\-etag\-save storetag.txt https://example.com
.fi
See also \fI\-\-etag\-compare\fP. Added in 7.68.0.
.IP "\-\-expect100\-timeout <seconds>"
(HTTP) Maximum time in seconds that you allow curl to wait for a 100\-continue
response when curl emits an Expects: 100\-continue header in its request. By
default curl waits one second. This option accepts decimal values! When
curl stops waiting, it continues as if the response has been received.
The decimal value needs to provided using a dot (.) as decimal separator \- not
the local version even if it might be using another separator.
If \fI\-\-expect100\-timeout\fP is provided several times, the last set value is used.
Example:
.nf
curl \-\-expect100\-timeout 2.5 \-T file https://example.com
.fi
See also \fI\-\-connect\-timeout\fP.
.IP "\-\-fail\-early"
Fail and exit on the first detected transfer error.
When curl is used to do multiple transfers on the command line, it attempts to
operate on each given URL, one by one. By default, it ignores errors if there
are more URLs given and the last URL\(aqs success determines the error code curl
returns. So early failures are "hidden" by subsequent successful transfers.
Using this option, curl instead returns an error on the first transfer that
fails, independent of the amount of URLs that are given on the command
line. This way, no transfer failures go undetected by scripts and similar.
This option does not imply \fI\-f, \-\-fail\fP, which causes transfers to fail due to the
server\(aqs HTTP status code. You can combine the two options, however note \fI\-f, \-\-fail\fP
is not global and is therefore contained by \fI\-:, \-\-next\fP.
This option is global and does not need to be specified for each use of --next.
Providing \fI\-\-fail\-early\fP multiple times has no extra effect.
Disable it again with \-\-no\-fail\-early.
Example:
.nf
curl \-\-fail\-early https://example.com https://two.example
.fi
See also \fI-f, \-\-fail\fP and \fI\-\-fail\-with\-body\fP. Added in 7.52.0.
.IP "\-\-fail\-with\-body"
(HTTP) Return an error on server errors where the HTTP response code is 400 or
greater). In normal cases when an HTTP server fails to deliver a document, it
returns an HTML document stating so (which often also describes why and
more). This flag allows curl to output and save that content but also to
return error 22.
This is an alternative option to \fI\-f, \-\-fail\fP which makes curl fail for the same
circumstances but without saving the content.
Providing \fI\-\-fail\-with\-body\fP multiple times has no extra effect.
Disable it again with \-\-no\-fail\-with\-body.
Example:
.nf
curl \-\-fail\-with\-body https://example.com
.fi
See also \fI-f, \-\-fail\fP and \fI\-\-fail\-early\fP. This option is mutually exclusive to \fI-f, \-\-fail\fP. Added in 7.76.0.
.IP "\-f, \-\-fail"
(HTTP) Fail fast with no output at all on server errors. This is useful to enable
scripts and users to better deal with failed attempts. In normal cases when an
HTTP server fails to deliver a document, it returns an HTML document stating
so (which often also describes why and more). This flag prevents curl from
outputting that and return error 22.
This method is not fail\-safe and there are occasions where non\-successful
response codes slip through, especially when authentication is involved
(response codes 401 and 407).
Providing \fI\-f, \-\-fail\fP multiple times has no extra effect.
Disable it again with \-\-no\-fail.
Example:
.nf
curl \-\-fail https://example.com
.fi
See also \fI\-\-fail\-with\-body\fP and \fI\-\-fail\-early\fP. This option is mutually exclusive to \fI\-\-fail\-with\-body\fP.
.IP "\-\-false\-start"
(TLS) Tells curl to use false start during the TLS handshake. False start is a mode
where a TLS client starts sending application data before verifying the
server\(aqs Finished message, thus saving a round trip when performing a full
handshake.
This is currently only implemented in the Secure Transport (on iOS 7.0 or
later, or OS X 10.9 or later) backend.
Providing \fI\-\-false\-start\fP multiple times has no extra effect.
Disable it again with \-\-no\-false\-start.
Example:
.nf
curl \-\-false\-start https://example.com
.fi
See also \fI\-\-tcp\-fastopen\fP.
.IP "\-\-form\-escape"
(HTTP) Tells curl to pass on names of multipart form fields and files using
backslash\-escaping instead of percent\-encoding.
If \fI\-\-form\-escape\fP is provided several times, the last set value is used.
Example:
.nf
curl \-\-form\-escape \-F \(aqfield\\name=curl\(aq \-F \(aqfile=@load"this\(aq https://example.com
.fi
See also \fI-F, \-\-form\fP. Added in 7.81.0.
.IP "\-\-form\-string <name=string>"
(HTTP SMTP IMAP) Similar to \fI\-F, \-\-form\fP except that the value string for the named parameter is used
literally. Leading \(aq@\(aq and \(aq<\(aq characters, and the \(aq;type=\(aq string in
the value have no special meaning. Use this in preference to \fI\-F, \-\-form\fP if
there is any possibility that the string value may accidentally trigger the
\(aq@\(aq or \(aq<\(aq features of \fI\-F, \-\-form\fP.
\fI\-\-form\-string\fP can be used several times in a command line
Example:
.nf
curl \-\-form\-string "data" https://example.com
.fi
See also \fI-F, \-\-form\fP.
.IP "\-F, \-\-form <name=content>"
(HTTP SMTP IMAP) For HTTP protocol family, this lets curl emulate a filled\-in form in which a
user has pressed the submit button. This causes curl to POST data using the
Content\-Type multipart/form\-data according to RFC 2388.
For SMTP and IMAP protocols, this is the means to compose a multipart mail
message to transmit.
This enables uploading of binary files etc. To force the \(aqcontent\(aq part to be
a file, prefix the file name with an @ sign. To just get the content part from
a file, prefix the file name with the symbol <. The difference between @ and <
is then that @ makes a file get attached in the post as a file upload, while
the < makes a text field and just get the contents for that text field from a
file.
Tell curl to read content from stdin instead of a file by using \- as
filename. This goes for both @ and < constructs. When stdin is used, the
contents is buffered in memory first by curl to determine its size and allow a
possible resend. Defining a part\(aqs data from a named non\-regular file (such as
a named pipe or similar) is not subject to buffering and is instead read at
transmission time; since the full size is unknown before the transfer starts,
such data is sent as chunks by HTTP and rejected by IMAP.
Example: send an image to an HTTP server, where \(aqprofile\(aq is the name of the
form\-field to which the file \fBportrait.jpg\fP is the input:
.nf
curl \-F profile=@portrait.jpg https://example.com/upload.cgi
.fi
Example: send your name and shoe size in two text fields to the server:
.nf
curl \-F name=John \-F shoesize=11 https://example.com/
.fi
Example: send your essay in a text field to the server. Send it as a plain
text field, but get the contents for it from a local file:
.nf
curl \-F "story=<hugefile.txt" https://example.com/
.fi
You can also tell curl what Content\-Type to use by using \(aqtype=\(aq, in a manner
similar to:
.nf
curl \-F "web=@index.html;type=text/html" example.com
.fi
or
.nf
curl \-F "name=daniel;type=text/foo" example.com
.fi
You can also explicitly change the name field of a file upload part by setting
filename=, like this:
.nf
curl \-F "file=@localfile;filename=nameinpost" example.com
.fi
If filename/path contains \(aq,\(aq or \(aq;\(aq, it must be quoted by double\-quotes like:
.nf
curl \-F "file=@\\"local,file\\";filename=\\"name;in;post\\"" example.com
.fi
or
.nf
curl \-F \(aqfile=@"local,file";filename="name;in;post"\(aq example.com
.fi
Note that if a filename/path is quoted by double\-quotes, any double\-quote
or backslash within the filename must be escaped by backslash.
Quoting must also be applied to non\-file data if it contains semicolons,
leading/trailing spaces or leading double quotes:
.nf
curl \-F \(aqcolors="red; green; blue";type=text/x\-myapp\(aq example.com
.fi
You can add custom headers to the field by setting headers=, like
.nf
curl \-F "submit=OK;headers=\\"X\-submit\-type: OK\\"" example.com
.fi
or
.nf
curl \-F "submit=OK;headers=@headerfile" example.com
.fi
The headers= keyword may appear more that once and above notes about quoting
apply. When headers are read from a file, Empty lines and lines starting
with \(aq#\(aq are comments and ignored; each header can be folded by splitting
between two words and starting the continuation line with a space; embedded
carriage\-returns and trailing spaces are stripped.
Here is an example of a header file contents:
.nf
# This file contain two headers.
X\-header\-1: this is a header
.fi
.nf
# The following header is folded.
X\-header\-2: this is
another header
.fi
To support sending multipart mail messages, the syntax is extended as follows:
.br
- name can be omitted: the equal sign is the first character of the argument,
.br
- if data starts with \(aq(\(aq, this signals to start a new multipart: it can be
followed by a content type specification.
.br
- a multipart can be terminated with a \(aq=)\(aq argument.
Example: the following command sends an SMTP mime email consisting in an
inline part in two alternative formats: plain text and HTML. It attaches a
text file:
.nf
curl \-F \(aq=(;type=multipart/alternative\(aq \\
\-F \(aq=plain text message\(aq \\
\-F \(aq= <body>HTML message</body>;type=text/html\(aq \\
\-F \(aq=)\(aq \-F \(aq=@textfile.txt\(aq ... smtp://example.com
.fi
Data can be encoded for transfer using encoder=. Available encodings are
\fIbinary\fP and \fI8bit\fP that do nothing else than adding the corresponding
Content\-Transfer\-Encoding header, \fI7bit\fP that only rejects 8\-bit characters
with a transfer error, \fIquoted\-printable\fP and \fIbase64\fP that encodes data
according to the corresponding schemes, limiting lines length to 76
characters.
Example: send multipart mail with a quoted\-printable text message and a
base64 attached file:
.nf
curl \-F \(aq=text message;encoder=quoted\-printable\(aq \\
\-F \(aq=@localfile;encoder=base64\(aq ... smtp://example.com
.fi
See further examples and details in the MANUAL.
\fI\-F, \-\-form\fP can be used several times in a command line
Example:
.nf
curl \-\-form "name=curl" \-\-form "file=@loadthis" https://example.com
.fi
See also \fI-d, \-\-data\fP, \fI\-\-form\-string\fP and \fI\-\-form\-escape\fP. This option is mutually exclusive to \fI-d, \-\-data\fP and \fI-I, \-\-head\fP and \fI-T, \-\-upload\-file\fP.
.IP "\-\-ftp\-account <data>"
(FTP) When an FTP server asks for "account data" after user name and password has
been provided, this data is sent off using the ACCT command.
If \fI\-\-ftp\-account\fP is provided several times, the last set value is used.
Example:
.nf
curl \-\-ftp\-account "mr.robot" ftp://example.com/
.fi
See also \fI-u, \-\-user\fP.
.IP "\-\-ftp\-alternative\-to\-user <command>"
(FTP) If authenticating with the USER and PASS commands fails, send this command.
When connecting to Tumbleweed\(aqs Secure Transport server over FTPS using a
client certificate, using "SITE AUTH" tells the server to retrieve the
username from the certificate.
If \fI\-\-ftp\-alternative\-to\-user\fP is provided several times, the last set value is used.
Example:
.nf
curl \-\-ftp\-alternative\-to\-user "U53r" ftp://example.com
.fi
See also \fI\-\-ftp\-account\fP and \fI-u, \-\-user\fP.
.IP "\-\-ftp\-create\-dirs"
(FTP SFTP) When an FTP or SFTP URL/operation uses a path that does not currently exist on
the server, the standard behavior of curl is to fail. Using this option, curl
instead attempts to create missing directories.
Providing \fI\-\-ftp\-create\-dirs\fP multiple times has no extra effect.
Disable it again with \-\-no\-ftp\-create\-dirs.
Example:
.nf
curl \-\-ftp\-create\-dirs \-T file ftp://example.com/remote/path/file
.fi
See also \fI\-\-create\-dirs\fP.
.IP "\-\-ftp\-method <method>"
(FTP) Control what method curl should use to reach a file on an FTP(S)
server. The method argument should be one of the following alternatives:
.RS
.IP multicwd
curl does a single CWD operation for each path part in the given URL. For deep
hierarchies this means many commands. This is how RFC 1738 says it should
be done. This is the default but the slowest behavior.
.IP nocwd
curl does no CWD at all. curl does SIZE, RETR, STOR etc and give a full
path to the server for all these commands. This is the fastest behavior.
.IP singlecwd
curl does one CWD with the full target directory and then operates on the file
\(dqnormally" (like in the multicwd case). This is somewhat more standards
compliant than \(aqnocwd\(aq but without the full penalty of \(aqmulticwd\(aq.
.RE
.IP
If \fI\-\-ftp\-method\fP is provided several times, the last set value is used.
Examples:
.nf
curl \-\-ftp\-method multicwd ftp://example.com/dir1/dir2/file
curl \-\-ftp\-method nocwd ftp://example.com/dir1/dir2/file
curl \-\-ftp\-method singlecwd ftp://example.com/dir1/dir2/file
.fi
See also \fI-l, \-\-list\-only\fP.
.IP "\-\-ftp\-pasv"
(FTP) Use passive mode for the data connection. Passive is the internal default
behavior, but using this option can be used to override a previous \fI\-P, \-\-ftp\-port\fP
option.
Reversing an enforced passive really is not doable but you must then instead
enforce the correct \fI\-P, \-\-ftp\-port\fP again.
Passive mode means that curl tries the EPSV command first and then PASV,
unless \fI\-\-disable\-epsv\fP is used.
Providing \fI\-\-ftp\-pasv\fP multiple times has no extra effect.
Disable it again with \-\-no\-ftp\-pasv.
Example:
.nf
curl \-\-ftp\-pasv ftp://example.com/
.fi
See also \fI\-\-disable\-epsv\fP.
.IP "\-P, \-\-ftp\-port <address>"
(FTP) Reverses the default initiator/listener roles when connecting with FTP. This
option makes curl use active mode. curl then tells the server to connect back
to the client\(aqs specified address and port, while passive mode asks the server
to setup an IP address and port for it to connect to. <address> should be one
of:
.RS
.IP interface
e.g. "eth0" to specify which interface\(aqs IP address you want to use (Unix only)
.IP "IP address"
e.g. "192.168.10.1" to specify the exact IP address
.IP "host name"
e.g. "my.host.domain" to specify the machine
.IP "\-"
make curl pick the same IP address that is already used for the control
connection
.RE
.IP
Disable the use of PORT with \fI\-\-ftp\-pasv\fP. Disable the attempt to use the EPRT
command instead of PORT by using \fI\-\-disable\-eprt\fP. EPRT is really PORT++.
You can also append ":[start]\-[end]\&" to the right of the address, to tell
curl what TCP port range to use. That means you specify a port range, from a
lower to a higher number. A single number works as well, but do note that it
increases the risk of failure since the port may not be available.
If \fI\-P, \-\-ftp\-port\fP is provided several times, the last set value is used.
Examples:
.nf
curl \-P \- ftp:/example.com
curl \-P eth0 ftp:/example.com
curl \-P 192.168.0.2 ftp:/example.com
.fi
See also \fI\-\-ftp\-pasv\fP and \fI\-\-disable\-eprt\fP.
.IP "\-\-ftp\-pret"
(FTP) Tell curl to send a PRET command before PASV (and EPSV). Certain FTP servers,
mainly drftpd, require this non\-standard command for directory listings as
well as up and downloads in PASV mode.
Providing \fI\-\-ftp\-pret\fP multiple times has no extra effect.
Disable it again with \-\-no\-ftp\-pret.
Example:
.nf
curl \-\-ftp\-pret ftp://example.com/
.fi
See also \fI-P, \-\-ftp\-port\fP and \fI\-\-ftp\-pasv\fP.
.IP "\-\-ftp\-skip\-pasv\-ip"
(FTP) Tell curl to not use the IP address the server suggests in its response to
curl\(aqs PASV command when curl connects the data connection. Instead curl
reuses the same IP address it already uses for the control connection.
This option is enabled by default (added in 7.74.0).
This option has no effect if PORT, EPRT or EPSV is used instead of PASV.
Providing \fI\-\-ftp\-skip\-pasv\-ip\fP multiple times has no extra effect.
Disable it again with \-\-no\-ftp\-skip\-pasv\-ip.
Example:
.nf
curl \-\-ftp\-skip\-pasv\-ip ftp://example.com/
.fi
See also \fI\-\-ftp\-pasv\fP.
.IP "\-\-ftp\-ssl\-ccc\-mode <active/passive>"
(FTP) Sets the CCC mode. The passive mode does not initiate the shutdown, but
instead waits for the server to do it, and does not reply to the shutdown from
the server. The active mode initiates the shutdown and waits for a reply from
the server.
Providing \fI\-\-ftp\-ssl\-ccc\-mode\fP multiple times has no extra effect.
Disable it again with \-\-no\-ftp\-ssl\-ccc\-mode.
Example:
.nf
curl \-\-ftp\-ssl\-ccc\-mode active \-\-ftp\-ssl\-ccc ftps://example.com/
.fi
See also \fI\-\-ftp\-ssl\-ccc\fP.
.IP "\-\-ftp\-ssl\-ccc"
(FTP) Use CCC (Clear Command Channel) Shuts down the SSL/TLS layer after
authenticating. The rest of the control channel communication is be
unencrypted. This allows NAT routers to follow the FTP transaction. The
default mode is passive.
Providing \fI\-\-ftp\-ssl\-ccc\fP multiple times has no extra effect.
Disable it again with \-\-no\-ftp\-ssl\-ccc.
Example:
.nf
curl \-\-ftp\-ssl\-ccc ftps://example.com/
.fi
See also \fI\-\-ssl\fP and \fI\-\-ftp\-ssl\-ccc\-mode\fP.
.IP "\-\-ftp\-ssl\-control"
(FTP) Require SSL/TLS for the FTP login, clear for transfer. Allows secure
authentication, but non\-encrypted data transfers for efficiency. Fails the
transfer if the server does not support SSL/TLS.
Providing \fI\-\-ftp\-ssl\-control\fP multiple times has no extra effect.
Disable it again with \-\-no\-ftp\-ssl\-control.
Example:
.nf
curl \-\-ftp\-ssl\-control ftp://example.com
.fi
See also \fI\-\-ssl\fP.
.IP "\-G, \-\-get"
When used, this option makes all data specified with \fI\-d, \-\-data\fP, \fI\-\-data\-binary\fP
or \fI\-\-data\-urlencode\fP to be used in an HTTP GET request instead of the POST
request that otherwise would be used. The data is appended to the URL
with a \(aq?\(aq separator.
If used in combination with \fI\-I, \-\-head\fP, the POST data is instead appended to the
URL with a HEAD request.
Providing \fI\-G, \-\-get\fP multiple times has no extra effect.
Disable it again with \-\-no\-get.
Examples:
.nf
curl \-\-get https://example.com
curl \-\-get \-d "tool=curl" \-d "age=old" https://example.com
curl \-\-get \-I \-d "tool=curl" https://example.com
.fi
See also \fI-d, \-\-data\fP and \fI-X, \-\-request\fP.
.IP "\-g, \-\-globoff"
This option switches off the "URL globbing parser". When you set this option,
you can specify URLs that contain the letters {}[] without having curl itself
interpret them. Note that these letters are not normal legal URL contents but
they should be encoded according to the URI standard.
Providing \fI\-g, \-\-globoff\fP multiple times has no extra effect.
Disable it again with \-\-no\-globoff.
Example:
.nf
curl \-g "https://example.com/{[]}}}}"
.fi
See also \fI-K, \-\-config\fP and \fI-q, \-\-disable\fP.
.IP "\-\-happy\-eyeballs\-timeout\-ms <milliseconds>"
Happy Eyeballs is an algorithm that attempts to connect to both IPv4 and IPv6
addresses for dual\-stack hosts, giving IPv6 a head\-start of the specified
number of milliseconds. If the IPv6 address cannot be connected to within that
time, then a connection attempt is made to the IPv4 address in parallel. The
first connection to be established is the one that is used.
The range of suggested useful values is limited. Happy Eyeballs RFC 6555 says
\(dqIt is RECOMMENDED that connection attempts be paced 150\-250 ms apart to
balance human factors against network load." libcurl currently defaults to
200 ms. Firefox and Chrome currently default to 300 ms.
If \fI\-\-happy\-eyeballs\-timeout\-ms\fP is provided several times, the last set value is used.
Example:
.nf
curl \-\-happy\-eyeballs\-timeout\-ms 500 https://example.com
.fi
See also \fI-m, \-\-max\-time\fP and \fI\-\-connect\-timeout\fP. Added in 7.59.0.
.IP "\-\-haproxy\-clientip"
(HTTP) Sets a client IP in HAProxy PROXY protocol v1 header at the beginning of the
connection.
For valid requests, IPv4 addresses must be indicated as a series of exactly
4 integers in the range [0..255] inclusive written in decimal representation
separated by exactly one dot between each other. Heading zeroes are not
permitted in front of numbers in order to avoid any possible confusion
with octal numbers. IPv6 addresses must be indicated as series of 4 hexadecimal
digits (upper or lower case) delimited by colons between each other, with the
acceptance of one double colon sequence to replace the largest acceptable range
of consecutive zeroes. The total number of decoded bits must exactly be 128.
Otherwise, any string can be accepted for the client IP and get sent.
It replaces \fI\-\-haproxy\-protocol\fP if used, it is not necessary to specify both flags.
This option is primarily useful when sending test requests to
verify a service is working as intended.
If \fI\-\-haproxy\-clientip\fP is provided several times, the last set value is used.
Example:
.nf
curl \-\-haproxy\-clientip $IP
.fi
See also \fI-x, \-\-proxy\fP. Added in 8.2.0.
.IP "\-\-haproxy\-protocol"
(HTTP) Send a HAProxy PROXY protocol v1 header at the beginning of the
connection. This is used by some load balancers and reverse proxies to
indicate the client\(aqs true IP address and port.
This option is primarily useful when sending test requests to a service that
expects this header.
Providing \fI\-\-haproxy\-protocol\fP multiple times has no extra effect.
Disable it again with \-\-no\-haproxy\-protocol.
Example:
.nf
curl \-\-haproxy\-protocol https://example.com
.fi
See also \fI-x, \-\-proxy\fP. Added in 7.60.0.
.IP "\-I, \-\-head"
(HTTP FTP FILE) Fetch the headers only! HTTP\-servers feature the command HEAD which this uses
to get nothing but the header of a document. When used on an FTP or FILE file,
curl displays the file size and last modification time only.
Providing \fI\-I, \-\-head\fP multiple times has no extra effect.
Disable it again with \-\-no\-head.
Example:
.nf
curl \-I https://example.com
.fi
See also \fI-G, \-\-get\fP, \fI-v, \-\-verbose\fP and \fI\-\-trace\-ascii\fP.
.IP "\-H, \-\-header <header/@file>"
(HTTP IMAP SMTP) Extra header to include in information sent. When used within an HTTP request,
it is added to the regular request headers.
For an IMAP or SMTP MIME uploaded mail built with \fI\-F, \-\-form\fP options, it is
prepended to the resulting MIME document, effectively including it at the mail
global level. It does not affect raw uploaded mails (Added in 7.56.0).
You may specify any number of extra headers. Note that if you should add a
custom header that has the same name as one of the internal ones curl would
use, your externally set header is used instead of the internal one. This
allows you to make even trickier stuff than curl would normally do. You should
not replace internally set headers without knowing perfectly well what you are
doing. Remove an internal header by giving a replacement without content on
the right side of the colon, as in: \-H "Host:". If you send the custom header
with no\-value then its header must be terminated with a semicolon, such as \-H
\(dqX\-Custom\-Header;" to send "X\-Custom\-Header:".
curl makes sure that each header you add/replace is sent with the proper
end\-of\-line marker, you should thus \fBnot\fP add that as a part of the header
content: do not add newlines or carriage returns, they only mess things up for
you.
This option can take an argument in @filename style, which then adds a header
for each line in the input file. Using @\- makes curl read the header file from
stdin. Added in 7.55.0.
Please note that most anti\-spam utilities check the presence and value of
several MIME mail headers: these are "From:", "To:", "Date:" and "Subject:"
among others and should be added with this option.
You need \fI\-\-proxy\-header\fP to send custom headers intended for an HTTP
proxy. Added in 7.37.0.
Passing on a "Transfer\-Encoding: chunked" header when doing an HTTP request
with a request body, makes curl send the data using chunked encoding.
\fBWARNING\fP: headers set with this option are set in all HTTP requests \- even
after redirects are followed, like when told with \fI\-L, \-\-location\fP. This can lead to
the header being sent to other hosts than the original host, so sensitive
headers should be used with caution combined with following redirects.
\fI\-H, \-\-header\fP can be used several times in a command line
Examples:
.nf
curl \-H "X\-First\-Name: Joe" https://example.com
curl \-H "User\-Agent: yes\-please/2000" https://example.com
curl \-H "Host:" https://example.com
curl \-H @headers.txt https://example.com
.fi
See also \fI-A, \-\-user\-agent\fP and \fI-e, \-\-referer\fP.
.IP "\-h, \-\-help <category>"
Usage help. This lists all curl command line options within the given
\fBcategory\fP.
If no argument is provided, curl displays only the most important command line
arguments.
For category \fBall\fP, curl displays help for all options.
If \fBcategory\fP is specified, curl displays all available help categories.
Example:
.nf
curl \-\-help all
.fi
See also \fI-v, \-\-verbose\fP.
.IP "\-\-hostpubmd5 <md5>"
(SFTP SCP) Pass a string containing 32 hexadecimal digits. The string should
be the 128 bit MD5 checksum of the remote host\(aqs public key, curl refuses
the connection with the host unless the md5sums match.
If \fI\-\-hostpubmd5\fP is provided several times, the last set value is used.
Example:
.nf
curl \-\-hostpubmd5 e5c1c49020640a5ab0f2034854c321a8 sftp://example.com/
.fi
See also \fI\-\-hostpubsha256\fP.
.IP "\-\-hostpubsha256 <sha256>"
(SFTP SCP) Pass a string containing a Base64\-encoded SHA256 hash of the remote host\(aqs
public key. Curl refuses the connection with the host unless the hashes match.
This feature requires libcurl to be built with libssh2 and does not work with
other SSH backends.
If \fI\-\-hostpubsha256\fP is provided several times, the last set value is used.
Example:
.nf
curl \-\-hostpubsha256 NDVkMTQxMGQ1ODdmMjQ3MjczYjAyOTY5MmRkMjVmNDQ= sftp://example.com/
.fi
See also \fI\-\-hostpubmd5\fP. Added in 7.80.0.
.IP "\-\-hsts <file name>"
(HTTPS) This option enables HSTS for the transfer. If the file name points to an
existing HSTS cache file, that is used. After a completed transfer, the
cache is saved to the file name again if it has been modified.
If curl is told to use HTTP:// for a transfer involving a host name that
exists in the HSTS cache, it upgrades the transfer to use HTTPS. Each HSTS
cache entry has an individual life time after which the upgrade is no longer
performed.
Specify a "" file name (zero length) to avoid loading/saving and make curl
just handle HSTS in memory.
If this option is used several times, curl loads contents from all the
files but the last one is used for saving.
\fI\-\-hsts\fP can be used several times in a command line
Example:
.nf
curl \-\-hsts cache.txt https://example.com
.fi
See also \fI\-\-proto\fP. Added in 7.74.0.
.IP "\-\-http0.9"
(HTTP) Tells curl to be fine with HTTP version 0.9 response.
HTTP/0.9 is a response without headers and therefore you can also connect with
this to non\-HTTP servers and still get a response since curl simply
transparently downgrades \- if allowed.
HTTP/0.9 is disabled by default (added in 7.66.0)
Providing \fI\-\-http0.9\fP multiple times has no extra effect.
Disable it again with \-\-no\-http0.9.
Example:
.nf
curl \-\-http0.9 https://example.com
.fi
See also \fI\-\-http1.1\fP, \fI\-\-http2\fP and \fI\-\-http3\fP. Added in 7.64.0.
.IP "\-0, \-\-http1.0"
(HTTP) Tells curl to use HTTP version 1.0 instead of using its internally preferred
HTTP version.
Providing \fI\-0, \-\-http1.0\fP multiple times has no extra effect.
Example:
.nf
curl \-\-http1.0 https://example.com
.fi
See also \fI\-\-http0.9\fP and \fI\-\-http1.1\fP. This option is mutually exclusive to \fI\-\-http1.1\fP and \fI\-\-http2\fP and \fI\-\-http2\-prior\-knowledge\fP and \fI\-\-http3\fP.
.IP "\-\-http1.1"
(HTTP) Tells curl to use HTTP version 1.1.
Providing \fI\-\-http1.1\fP multiple times has no extra effect.
Example:
.nf
curl \-\-http1.1 https://example.com
.fi
See also \fI-0, \-\-http1.0\fP and \fI\-\-http0.9\fP. This option is mutually exclusive to \fI-0, \-\-http1.0\fP and \fI\-\-http2\fP and \fI\-\-http2\-prior\-knowledge\fP and \fI\-\-http3\fP.
.IP "\-\-http2\-prior\-knowledge"
(HTTP) Tells curl to issue its non\-TLS HTTP requests using HTTP/2 without HTTP/1.1
Upgrade. It requires prior knowledge that the server supports HTTP/2 straight
away. HTTPS requests still do HTTP/2 the standard way with negotiated protocol
version in the TLS handshake.
Providing \fI\-\-http2\-prior\-knowledge\fP multiple times has no extra effect.
Disable it again with \-\-no\-http2\-prior\-knowledge.
Example:
.nf
curl \-\-http2\-prior\-knowledge https://example.com
.fi
See also \fI\-\-http2\fP and \fI\-\-http3\fP. \fI\-\-http2\-prior\-knowledge\fP requires that the underlying libcurl was built to support HTTP/2. This option is mutually exclusive to \fI\-\-http1.1\fP and \fI-0, \-\-http1.0\fP and \fI\-\-http2\fP and \fI\-\-http3\fP.
.IP "\-\-http2"
(HTTP) Tells curl to use HTTP version 2.
For HTTPS, this means curl negotiates HTTP/2 in the TLS handshake. curl does
this by default.
For HTTP, this means curl attempts to upgrade the request to HTTP/2 using the
Upgrade: request header.
When curl uses HTTP/2 over HTTPS, it does not itself insist on TLS 1.2 or
higher even though that is required by the specification. A user can add this
version requirement with \fI\-\-tlsv1.2\fP.
Providing \fI\-\-http2\fP multiple times has no extra effect.
Example:
.nf
curl \-\-http2 https://example.com
.fi
See also \fI\-\-http1.1\fP, \fI\-\-http3\fP and \fI\-\-no\-alpn\fP. \fI\-\-http2\fP requires that the underlying libcurl was built to support HTTP/2. This option is mutually exclusive to \fI\-\-http1.1\fP and \fI-0, \-\-http1.0\fP and \fI\-\-http2\-prior\-knowledge\fP and \fI\-\-http3\fP.
.IP "\-\-http3\-only"
(HTTP) **WARNING**: this option is experimental. Do not use in production.
Instructs curl to use HTTP/3 to the host in the URL, with no fallback to
earlier HTTP versions. HTTP/3 can only be used for HTTPS and not for HTTP
URLs. For HTTP, this option triggers an error.
This option allows a user to avoid using the Alt\-Svc method of upgrading to
HTTP/3 when you know that the target speaks HTTP/3 on the given host and port.
This option makes curl fail if a QUIC connection cannot be established, it
does not attempt any other HTTP versions on its own. Use \fI\-\-http3\fP for similar
functionality \fIwith\fP a fallback.
Providing \fI\-\-http3\-only\fP multiple times has no extra effect.
Example:
.nf
curl \-\-http3\-only https://example.com
.fi
See also \fI\-\-http1.1\fP, \fI\-\-http2\fP and \fI\-\-http3\fP. \fI\-\-http3\-only\fP requires that the underlying libcurl was built to support HTTP/3. This option is mutually exclusive to \fI\-\-http1.1\fP and \fI-0, \-\-http1.0\fP and \fI\-\-http2\fP and \fI\-\-http2\-prior\-knowledge\fP and \fI\-\-http3\fP. Added in 7.88.0.
.IP "\-\-http3"
(HTTP) **WARNING**: this option is experimental. Do not use in production.
Tells curl to try HTTP/3 to the host in the URL, but fallback to earlier
HTTP versions if the HTTP/3 connection establishment fails. HTTP/3 is only
available for HTTPS and not for HTTP URLs.
This option allows a user to avoid using the Alt\-Svc method of upgrading to
HTTP/3 when you know that the target speaks HTTP/3 on the given host and port.
When asked to use HTTP/3, curl issues a separate attempt to use older HTTP
versions with a slight delay, so if the HTTP/3 transfer fails or is slow, curl
still tries to proceed with an older HTTP version.
Use \fI\-\-http3\-only\fP for similar functionality \fIwithout\fP a fallback.
Providing \fI\-\-http3\fP multiple times has no extra effect.
Example:
.nf
curl \-\-http3 https://example.com
.fi
See also \fI\-\-http1.1\fP and \fI\-\-http2\fP. \fI\-\-http3\fP requires that the underlying libcurl was built to support HTTP/3. This option is mutually exclusive to \fI\-\-http1.1\fP and \fI-0, \-\-http1.0\fP and \fI\-\-http2\fP and \fI\-\-http2\-prior\-knowledge\fP and \fI\-\-http3\-only\fP. Added in 7.66.0.
.IP "\-\-ignore\-content\-length"
(FTP HTTP) For HTTP, Ignore the Content\-Length header. This is particularly useful for
servers running Apache 1.x, which reports incorrect Content\-Length for
files larger than 2 gigabytes.
For FTP, this makes curl skip the SIZE command to figure out the size before
downloading a file.
This option does not work for HTTP if libcurl was built to use hyper.
Providing \fI\-\-ignore\-content\-length\fP multiple times has no extra effect.
Disable it again with \-\-no\-ignore\-content\-length.
Example:
.nf
curl \-\-ignore\-content\-length https://example.com
.fi
See also \fI\-\-ftp\-skip\-pasv\-ip\fP.
.IP "\-i, \-\-include"
Include the HTTP response headers in the output. The HTTP response headers can
include things like server name, cookies, date of the document, HTTP version
and more...
To view the request headers, consider the \fI\-v, \-\-verbose\fP option.
Prior to 7.75.0 curl did not print the headers if \fI\-f, \-\-fail\fP was used in
combination with this option and there was error reported by server.
Providing \fI\-i, \-\-include\fP multiple times has no extra effect.
Disable it again with \-\-no\-include.
Example:
.nf
curl \-i https://example.com
.fi
See also \fI-v, \-\-verbose\fP.
.IP "\-k, \-\-insecure"
(TLS SFTP SCP) By default, every secure connection curl makes is verified to be secure before
the transfer takes place. This option makes curl skip the verification step
and proceed without checking.
When this option is not used for protocols using TLS, curl verifies the
server\(aqs TLS certificate before it continues: that the certificate contains
the right name which matches the host name used in the URL and that the
certificate has been signed by a CA certificate present in the cert store.
See this online resource for further details:
.nf
https://curl.se/docs/sslcerts.html
.fi
For SFTP and SCP, this option makes curl skip the \fIknown_hosts\fP verification.
\fIknown_hosts\fP is a file normally stored in the user\(aqs home directory in the
\(dq.ssh" subdirectory, which contains host names and their public keys.
\fBWARNING\fP: using this option makes the transfer insecure.
When curl uses secure protocols it trusts responses and allows for example
HSTS and Alt\-Svc information to be stored and used subsequently. Using
\fI\-k, \-\-insecure\fP can make curl trust and use such information from malicious
servers.
Providing \fI\-k, \-\-insecure\fP multiple times has no extra effect.
Disable it again with \-\-no\-insecure.
Example:
.nf
curl \-\-insecure https://example.com
.fi
See also \fI\-\-proxy\-insecure\fP, \fI\-\-cacert\fP and \fI\-\-capath\fP.
.IP "\-\-interface <name>"
Perform an operation using a specified interface. You can enter interface
name, IP address or host name. An example could look like:
.nf
curl \--interface eth0:1 https://www.example.com/
.fi
On Linux it can be used to specify a \fBVRF\fP, but the binary needs to either
have \fBCAP_NET_RAW\fP or to be run as root. More information about Linux
\fBVRF\fP: https://www.kernel.org/doc/Documentation/networking/vrf.txt
If \fI\-\-interface\fP is provided several times, the last set value is used.
Example:
.nf
curl \-\-interface eth0 https://example.com
.fi
See also \fI\-\-dns\-interface\fP.
.IP "\-\-ipfs\-gateway <URL>"
Specifies which gateway to use for IPFS and IPNS URLs.
Not specifying this argument will let cURL try to automatically
check if IPFS_GATEWAY environment variable is set,
or if ~/.ipfs/gateway plain text file exists.
If you run a local IPFS node, this gateway is by default
available under http://localhost:8080. A full example URL would
look like:
.nf
curl \--ipfs\-gateway http://localhost:8080 ipfs://bafybeigagd5nmnn2iys2f3doro7ydrevyr2mzarwidgadawmamiteydbzi
.fi
You can also specify publicly available gateways. One such
gateway is https://ipfs.io. A full example url would look like:
.nf
curl \--ipfs\-gateway https://ipfs.io ipfs://bafybeigagd5nmnn2iys2f3doro7ydrevyr2mzarwidgadawmamiteydbzi
.fi
There are many public IPFS gateways. As a starting point to find
one that works for your case, consult this page:
.nf
https://ipfs.github.io/public\-gateway\-checker/
.fi
A word of caution! When you opt to go for a remote gateway you should
be aware that you completely trust the gateway. This is fine in local gateways
as you host it yourself. With remote gateways there could potentially be
a malicious actor returning you data that does not match the request you made,
inspect or even interfere with the request. You won\(aqt notice this when using cURL.
A mitigation could be to go for a "trustless" gateway. This means you
locally verify that the data. Consult the docs page on trusted vs trustless:
https://docs.ipfs.tech/reference/http/gateway/#trusted\-vs\-trustless
If \fI\-\-ipfs\-gateway\fP is provided several times, the last set value is used.
Example:
.nf
curl \-\-ipfs\-gateway https://example.com ipfs://
.fi
See also \fI-h, \-\-help\fP and \fI-M, \-\-manual\fP. Added in 8.4.0.
.IP "\-4, \-\-ipv4"
This option tells curl to use IPv4 addresses only when resolving host names,
and not for example try IPv6.
Providing \fI\-4, \-\-ipv4\fP multiple times has no extra effect.
Example:
.nf
curl \-\-ipv4 https://example.com
.fi
See also \fI\-\-http1.1\fP and \fI\-\-http2\fP. This option is mutually exclusive to \fI-6, \-\-ipv6\fP.
.IP "\-6, \-\-ipv6"
This option tells curl to use IPv6 addresses only when resolving host names,
and not for example try IPv4.
Providing \fI\-6, \-\-ipv6\fP multiple times has no extra effect.
Example:
.nf
curl \-\-ipv6 https://example.com
.fi
See also \fI\-\-http1.1\fP and \fI\-\-http2\fP. This option is mutually exclusive to \fI-4, \-\-ipv4\fP.
.IP "\-\-json <data>"
(HTTP) Sends the specified JSON data in a POST request to the HTTP server. \fI\-\-json\fP
works as a shortcut for passing on these three options:
.nf
\--data [arg]
\--header "Content\-Type: application/json"
\--header "Accept: application/json"
.fi
There is \fI\fPno verification\fI\fP that the passed in data is actual JSON or that
the syntax is correct.
If you start the data with the letter @, the rest should be a file name to
read the data from, or a single dash (\-) if you want curl to read the data
from stdin. Posting data from a file named \(aqfoobar\(aq would thus be done with
\fI\-\-json\fP @foobar and to instead read the data from stdin, use \fI\-\-json\fP @\-.
If this option is used more than once on the same command line, the additional
data pieces are concatenated to the previous before sending.
The headers this option sets can be overridden with \fI\-H, \-\-header\fP as usual.
\fI\-\-json\fP can be used several times in a command line
Examples:
.nf
curl \-\-json \(aq{ "drink": "coffe" }\(aq https://example.com
curl \-\-json \(aq{ "drink":\(aq \-\-json \(aq "coffe" }\(aq https://example.com
curl \-\-json @prepared https://example.com
curl \-\-json @\- https://example.com < json.txt
.fi
See also \fI\-\-data\-binary\fP and \fI\-\-data\-raw\fP. This option is mutually exclusive to \fI-F, \-\-form\fP and \fI-I, \-\-head\fP and \fI-T, \-\-upload\-file\fP. Added in 7.82.0.
.IP "\-j, \-\-junk\-session\-cookies"
(HTTP) When curl is told to read cookies from a given file, this option makes it
discard all "session cookies". This has the same effect as if a new session is
started. Typical browsers discard session cookies when they are closed down.
Providing \fI\-j, \-\-junk\-session\-cookies\fP multiple times has no extra effect.
Disable it again with \-\-no\-junk\-session\-cookies.
Example:
.nf
curl \-\-junk\-session\-cookies \-b cookies.txt https://example.com
.fi
See also \fI-b, \-\-cookie\fP and \fI-c, \-\-cookie\-jar\fP.
.IP "\-\-keepalive\-time <seconds>"
This option sets the time a connection needs to remain idle before sending
keepalive probes and the time between individual keepalive probes. It is
currently effective on operating systems offering the TCP_KEEPIDLE and
TCP_KEEPINTVL socket options (meaning Linux, recent AIX, HP\-UX and more).
Keepalives are used by the TCP stack to detect broken networks on idle
connections. The number of missed keepalive probes before declaring the
connection down is OS dependent and is commonly 9 or 10. This option has no
effect if \fI\-\-no\-keepalive\fP is used.
If unspecified, the option defaults to 60 seconds.
If \fI\-\-keepalive\-time\fP is provided several times, the last set value is used.
Example:
.nf
curl \-\-keepalive\-time 20 https://example.com
.fi
See also \fI\-\-no\-keepalive\fP and \fI-m, \-\-max\-time\fP.
.IP "\-\-key\-type <type>"
(TLS) Private key file type. Specify which type your \fI\-\-key\fP provided private key
is. DER, PEM, and ENG are supported. If not specified, PEM is assumed.
If \fI\-\-key\-type\fP is provided several times, the last set value is used.
Example:
.nf
curl \-\-key\-type DER \-\-key here https://example.com
.fi
See also \fI\-\-key\fP.
.IP "\-\-key <key>"
(TLS SSH) Private key file name. Allows you to provide your private key in this separate
file. For SSH, if not specified, curl tries the following candidates in order:
\(aq~/.ssh/id_rsa\(aq, \(aq~/.ssh/id_dsa\(aq, \(aq./id_rsa\(aq, \(aq./id_dsa\(aq.
If curl is built against OpenSSL library, and the engine pkcs11 is available,
then a PKCS#11 URI (RFC 7512) can be used to specify a private key located in
a PKCS#11 device. A string beginning with "pkcs11:" is interpreted as a
PKCS#11 URI. If a PKCS#11 URI is provided, then the \fI\-\-engine\fP option is set as
\(dqpkcs11" if none was provided and the \fI\-\-key\-type\fP option is set as "ENG" if
none was provided.
If curl is built against Secure Transport or Schannel then this option is
ignored for TLS protocols (HTTPS, etc). Those backends expect the private key
to be already present in the keychain or PKCS#12 file containing the
certificate.
If \fI\-\-key\fP is provided several times, the last set value is used.
Example:
.nf
curl \-\-cert certificate \-\-key here https://example.com
.fi
See also \fI\-\-key\-type\fP and \fI-E, \-\-cert\fP.
.IP "\-\-krb <level>"
(FTP) Enable Kerberos authentication and use. The level must be entered and should
be one of \(aqclear\(aq, \(aqsafe\(aq, \(aqconfidential\(aq, or \(aqprivate\(aq. Should you use a
level that is not one of these, \(aqprivate\(aq is used.
If \fI\-\-krb\fP is provided several times, the last set value is used.
Example:
.nf
curl \-\-krb clear ftp://example.com/
.fi
See also \fI\-\-delegation\fP and \fI\-\-ssl\fP. \fI\-\-krb\fP requires that the underlying libcurl was built to support Kerberos.
.IP "\-\-libcurl <file>"
Append this option to any ordinary curl command line, and you get
libcurl\-using C source code written to the file that does the equivalent of
what your command\-line operation does!
This option is global and does not need to be specified for each use of --next.
If \fI\-\-libcurl\fP is provided several times, the last set value is used.
Example:
.nf
curl \-\-libcurl client.c https://example.com
.fi
See also \fI-v, \-\-verbose\fP.
.IP "\-\-limit\-rate <speed>"
Specify the maximum transfer rate you want curl to use \- for both downloads
and uploads. This feature is useful if you have a limited pipe and you would like
your transfer not to use your entire bandwidth. To make it slower than it
otherwise would be.
The given speed is measured in bytes/second, unless a suffix is appended.
Appending \(aqk\(aq or \(aqK\(aq counts the number as kilobytes, \(aqm\(aq or \(aqM\(aq makes it
megabytes, while \(aqg\(aq or \(aqG\(aq makes it gigabytes. The suffixes (k, M, G, T, P)
are 1024 based. For example 1k is 1024. Examples: 200K, 3m and 1G.
The rate limiting logic works on averaging the transfer speed to no more than
the set threshold over a period of multiple seconds.
If you also use the \fI\-Y, \-\-speed\-limit\fP option, that option takes precedence and
might cripple the rate\-limiting slightly, to help keeping the speed\-limit
logic working.
If \fI\-\-limit\-rate\fP is provided several times, the last set value is used.
Examples:
.nf
curl \-\-limit\-rate 100K https://example.com
curl \-\-limit\-rate 1000 https://example.com
curl \-\-limit\-rate 10M https://example.com
.fi
See also \fI\-\-rate\fP, \fI-Y, \-\-speed\-limit\fP and \fI-y, \-\-speed\-time\fP.
.IP "\-l, \-\-list\-only"
(FTP POP3 SFTP) (FTP)
When listing an FTP directory, this switch forces a name\-only view. This is
especially useful if the user wants to machine\-parse the contents of an FTP
directory since the normal directory view does not use a standard look or
format. When used like this, the option causes an NLST command to be sent to
the server instead of LIST.
Note: Some FTP servers list only files in their response to NLST; they do not
include sub\-directories and symbolic links.
(SFTP)
When listing an SFTP directory, this switch forces a name\-only view, one per line.
This is especially useful if the user wants to machine\-parse the contents of an
SFTP directory since the normal directory view provides more information than just
file names.
(POP3)
When retrieving a specific email from POP3, this switch forces a LIST command
to be performed instead of RETR. This is particularly useful if the user wants
to see if a specific message\-id exists on the server and what size it is.
Note: When combined with \fI\-X, \-\-request\fP, this option can be used to send a UIDL
command instead, so the user may use the email\(aqs unique identifier rather than
its message\-id to make the request.
Providing \fI\-l, \-\-list\-only\fP multiple times has no extra effect.
Disable it again with \-\-no\-list\-only.
Example:
.nf
curl \-\-list\-only ftp://example.com/dir/
.fi
See also \fI-Q, \-\-quote\fP and \fI-X, \-\-request\fP.
.IP "\-\-local\-port <num/range>"
Set a preferred single number or range (FROM\-TO) of local port numbers to use
for the connection(s). Note that port numbers by nature are a scarce resource
so setting this range to something too narrow might cause unnecessary
connection setup failures.
If \fI\-\-local\-port\fP is provided several times, the last set value is used.
Example:
.nf
curl \-\-local\-port 1000\-3000 https://example.com
.fi
See also \fI-g, \-\-globoff\fP.
.IP "\-\-location\-trusted"
(HTTP) Like \fI\-L, \-\-location\fP, but allows sending the name + password to all hosts that the
site may redirect to. This may or may not introduce a security breach if the
site redirects you to a site to which you send your authentication info
(which is plaintext in the case of HTTP Basic authentication).
Providing \fI\-\-location\-trusted\fP multiple times has no extra effect.
Disable it again with \-\-no\-location\-trusted.
Example:
.nf
curl \-\-location\-trusted \-u user:password https://example.com
.fi
See also \fI-u, \-\-user\fP.
.IP "\-L, \-\-location"
(HTTP) If the server reports that the requested page has moved to a different
location (indicated with a Location: header and a 3XX response code), this
option makes curl redo the request on the new place. If used together with
\fI\-i, \-\-include\fP or \fI\-I, \-\-head\fP, headers from all requested pages are shown.
When authentication is used, curl only sends its credentials to the initial
host. If a redirect takes curl to a different host, it does not get the
user+password pass on. See also \fI\-\-location\-trusted\fP on how to change this.
Limit the amount of redirects to follow by using the \fI\-\-max\-redirs\fP option.
When curl follows a redirect and if the request is a POST, it sends the
following request with a GET if the HTTP response was 301, 302, or 303. If the
response code was any other 3xx code, curl resends the following request using
the same unmodified method.
You can tell curl to not change POST requests to GET after a 30x response by
using the dedicated options for that: \fI\-\-post301\fP, \fI\-\-post302\fP and \fI\-\-post303\fP.
The method set with \fI\-X, \-\-request\fP overrides the method curl would otherwise select
to use.
Providing \fI\-L, \-\-location\fP multiple times has no extra effect.
Disable it again with \-\-no\-location.
Example:
.nf
curl \-L https://example.com
.fi
See also \fI\-\-resolve\fP and \fI\-\-alt\-svc\fP.
.IP "\-\-login\-options <options>"
(IMAP LDAP POP3 SMTP) Specify the login options to use during server authentication.
You can use login options to specify protocol specific options that may be
used during authentication. At present only IMAP, POP3 and SMTP support login
options. For more information about login options please see RFC 2384,
RFC 5092 and the IETF draft
https://datatracker.ietf.org/doc/html/draft\-earhart\-url\-smtp\-00.
Since 8.2.0, IMAP supports the login option "AUTH=+LOGIN". With this option,
curl uses the plain (not SASL) LOGIN IMAP command even if the server
advertises SASL authentication. Care should be taken in using this option, as
it sends your password over the network in plain text. This does not work if
the IMAP server disables the plain LOGIN (e.g. to prevent password snooping).
If \fI\-\-login\-options\fP is provided several times, the last set value is used.
Example:
.nf
curl \-\-login\-options \(aqAUTH=*\(aq imap://example.com
.fi
See also \fI-u, \-\-user\fP.
.IP "\-\-mail\-auth <address>"
(SMTP) Specify a single address. This is used to specify the authentication address
(identity) of a submitted message that is being relayed to another server.
If \fI\-\-mail\-auth\fP is provided several times, the last set value is used.
Example:
.nf
curl \-\-mail\-auth user@example.come \-T mail smtp://example.com/
.fi
See also \fI\-\-mail\-rcpt\fP and \fI\-\-mail\-from\fP.
.IP "\-\-mail\-from <address>"
(SMTP) Specify a single address that the given mail should get sent from.
If \fI\-\-mail\-from\fP is provided several times, the last set value is used.
Example:
.nf
curl \-\-mail\-from user@example.com \-T mail smtp://example.com/
.fi
See also \fI\-\-mail\-rcpt\fP and \fI\-\-mail\-auth\fP.
.IP "\-\-mail\-rcpt\-allowfails"
(SMTP) When sending data to multiple recipients, by default curl aborts SMTP
conversation if at least one of the recipients causes RCPT TO command to
return an error.
The default behavior can be changed by passing \fI\-\-mail\-rcpt\-allowfails\fP
command\-line option which makes curl ignore errors and proceed with the
remaining valid recipients.
If all recipients trigger RCPT TO failures and this flag is specified, curl
still aborts the SMTP conversation and returns the error received from to the
last RCPT TO command.
Providing \fI\-\-mail\-rcpt\-allowfails\fP multiple times has no extra effect.
Disable it again with \-\-no\-mail\-rcpt\-allowfails.
Example:
.nf
curl \-\-mail\-rcpt\-allowfails \-\-mail\-rcpt dest@example.com smtp://example.com
.fi
See also \fI\-\-mail\-rcpt\fP. Added in 7.69.0.
.IP "\-\-mail\-rcpt <address>"
(SMTP) Specify a single email address, user name or mailing list name. Repeat this
option several times to send to multiple recipients.
When performing an address verification (\fBVRFY\fP command), the recipient should be
specified as the user name or user name and domain (as per Section 3.5 of
RFC 5321).
When performing a mailing list expand (EXPN command), the recipient should be
specified using the mailing list name, such as "Friends" or "London\-Office".
\fI\-\-mail\-rcpt\fP can be used several times in a command line
Example:
.nf
curl \-\-mail\-rcpt user@example.net smtp://example.com
.fi
See also \fI\-\-mail\-rcpt\-allowfails\fP.
.IP "\-M, \-\-manual"
Manual. Display the huge help text.
Example:
.nf
curl \-\-manual
.fi
See also \fI-v, \-\-verbose\fP, \fI\-\-libcurl\fP and \fI\-\-trace\fP.
.IP "\-\-max\-filesize <bytes>"
(FTP HTTP MQTT) Specify the maximum size (in bytes) of a file to download. If the file
requested is larger than this value, the transfer does not start and curl
returns with exit code 63.
A size modifier may be used. For example, Appending \(aqk\(aq or \(aqK\(aq counts the
number as kilobytes, \(aqm\(aq or \(aqM\(aq makes it megabytes, while \(aqg\(aq or \(aqG\(aq makes it
gigabytes. Examples: 200K, 3m and 1G. (Added in 7.58.0)
\fBNOTE\fP: before curl 8.4.0, when the file size is not known prior to
download, for such files this option has no effect even if the file transfer
ends up being larger than this given limit.
Starting with curl 8.4.0, this option aborts the transfer if it reaches the
threshold during transfer.
If \fI\-\-max\-filesize\fP is provided several times, the last set value is used.
Example:
.nf
curl \-\-max\-filesize 100K https://example.com
.fi
See also \fI\-\-limit\-rate\fP.
.IP "\-\-max\-redirs <num>"
(HTTP) Set maximum number of redirections to follow. When \fI\-L, \-\-location\fP is used, to
prevent curl from following too many redirects, by default, the limit is
set to 50 redirects. Set this option to \-1 to make it unlimited.
If \fI\-\-max\-redirs\fP is provided several times, the last set value is used.
Example:
.nf
curl \-\-max\-redirs 3 \-\-location https://example.com
.fi
See also \fI-L, \-\-location\fP.
.IP "\-m, \-\-max\-time <fractional seconds>"
Maximum time in seconds that you allow each transfer to take. This is useful
for preventing your batch jobs from hanging for hours due to slow networks or
links going down. This option accepts decimal values.
If you enable retrying the transfer (\fI\-\-retry\fP) then the maximum time counter is
reset each time the transfer is retried. You can use \fI\-\-retry\-max\-time\fP to limit
the retry time.
The decimal value needs to provided using a dot (.) as decimal separator \- not
the local version even if it might be using another separator.
If \fI\-m, \-\-max\-time\fP is provided several times, the last set value is used.
Examples:
.nf
curl \-\-max\-time 10 https://example.com
curl \-\-max\-time 2.92 https://example.com
.fi
See also \fI\-\-connect\-timeout\fP and \fI\-\-retry\-max\-time\fP.
.IP "\-\-metalink"
This option was previously used to specify a Metalink resource. Metalink
support is disabled in curl for security reasons (added in 7.78.0).
If \fI\-\-metalink\fP is provided several times, the last set value is used.
Example:
.nf
curl \-\-metalink file https://example.com
.fi
See also \fI-Z, \-\-parallel\fP.
.IP "\-\-negotiate"
(HTTP) Enables Negotiate (SPNEGO) authentication.
This option requires a library built with GSS\-API or SSPI support. Use
\fI\-V, \-\-version\fP to see if your curl supports GSS\-API/SSPI or SPNEGO.
When using this option, you must also provide a fake \fI\-u, \-\-user\fP option to activate
the authentication code properly. Sending a \(aq\-u :\(aq is enough as the user name
and password from the \fI\-u, \-\-user\fP option are not actually used.
Providing \fI\-\-negotiate\fP multiple times has no extra effect.
Example:
.nf
curl \-\-negotiate \-u : https://example.com
.fi
See also \fI\-\-basic\fP, \fI\-\-ntlm\fP, \fI\-\-anyauth\fP and \fI\-\-proxy\-negotiate\fP.
.IP "\-\-netrc\-file <filename>"
This option is similar to \fI\-n, \-\-netrc\fP, except that you provide the path (absolute
or relative) to the netrc file that curl should use. You can only specify one
netrc file per invocation.
It abides by \fI\-\-netrc\-optional\fP if specified.
If \fI\-\-netrc\-file\fP is provided several times, the last set value is used.
Example:
.nf
curl \-\-netrc\-file netrc https://example.com
.fi
See also \fI-n, \-\-netrc\fP, \fI-u, \-\-user\fP and \fI-K, \-\-config\fP. This option is mutually exclusive to \fI-n, \-\-netrc\fP.
.IP "\-\-netrc\-optional"
Similar to \fI\-n, \-\-netrc\fP, but this option makes the .netrc usage \fBoptional\fP
and not mandatory as the \fI\-n, \-\-netrc\fP option does.
Providing \fI\-\-netrc\-optional\fP multiple times has no extra effect.
Disable it again with \-\-no\-netrc\-optional.
Example:
.nf
curl \-\-netrc\-optional https://example.com
.fi
See also \fI\-\-netrc\-file\fP. This option is mutually exclusive to \fI-n, \-\-netrc\fP.
.IP "\-n, \-\-netrc"
Makes curl scan the \fI.netrc\fP file in the user\(aqs home directory for login name
and password. This is typically used for FTP on Unix. If used with HTTP, curl
enables user authentication. See \fInetrc(5)\fP and \fIftp(1)\fP for details on the
file format. Curl does not complain if that file does not have the right
permissions (it should be neither world\- nor group\-readable). The environment
variable "HOME" is used to find the home directory.
On Windows two filenames in the home directory are checked: \fI.netrc\fP and
\fI_netrc\fP, preferring the former. Older versions on Windows checked for \fI_netrc\fP
only.
A quick and simple example of how to setup a \fI.netrc\fP to allow curl to FTP to
the machine host.domain.com with user name \(aqmyself\(aq and password \(aqsecret\(aq
could look similar to:
.nf
machine host.domain.com
login myself
password secret
.fi
Providing \fI\-n, \-\-netrc\fP multiple times has no extra effect.
Disable it again with \-\-no\-netrc.
Example:
.nf
curl \-\-netrc https://example.com
.fi
See also \fI\-\-netrc\-file\fP, \fI-K, \-\-config\fP and \fI-u, \-\-user\fP. This option is mutually exclusive to \fI\-\-netrc\-file\fP and \fI\-\-netrc\-optional\fP.
.IP "\-:, \-\-next"
Tells curl to use a separate operation for the following URL and associated
options. This allows you to send several URL requests, each with their own
specific options, for example, such as different user names or custom requests
for each.
\fI\-:, \-\-next\fP resets all local options and only global ones have their values survive
over to the operation following the \fI\-:, \-\-next\fP instruction. Global options include
\fI\-v, \-\-verbose\fP, \fI\-\-trace\fP, \fI\-\-trace\-ascii\fP and \fI\-\-fail\-early\fP.
For example, you can do both a GET and a POST in a single command line:
.nf
curl www1.example.com \--next \-d postthis www2.example.com
.fi
\fI\-:, \-\-next\fP can be used several times in a command line
Examples:
.nf
curl https://example.com \-\-next \-d postthis www2.example.com
curl \-I https://example.com \-\-next https://example.net/
.fi
See also \fI-Z, \-\-parallel\fP and \fI-K, \-\-config\fP.
.IP "\-\-no\-alpn"
(HTTPS) Disable the ALPN TLS extension. ALPN is enabled by default if libcurl was built
with an SSL library that supports ALPN. ALPN is used by a libcurl that supports
HTTP/2 to negotiate HTTP/2 support with the server during https sessions.
Note that this is the negated option name documented. You can use \--alpn to
enable ALPN.
Providing \fI\-\-no\-alpn\fP multiple times has no extra effect.
Disable it again with \-\-alpn.
Example:
.nf
curl \-\-no\-alpn https://example.com
.fi
See also \fI\-\-no\-npn\fP and \fI\-\-http2\fP. \fI\-\-no\-alpn\fP requires that the underlying libcurl was built to support TLS.
.IP "\-N, \-\-no\-buffer"
Disables the buffering of the output stream. In normal work situations, curl
uses a standard buffered output stream that has the effect that it outputs the
data in chunks, not necessarily exactly when the data arrives. Using this
option disables that buffering.
Note that this is the negated option name documented. You can use \--buffer to
enable buffering again.
Providing \fI\-N, \-\-no\-buffer\fP multiple times has no extra effect.
Disable it again with \-\-buffer.
Example:
.nf
curl \-\-no\-buffer https://example.com
.fi
See also \fI-#, \-\-progress\-bar\fP.
.IP "\-\-no\-clobber"
When used in conjunction with the \fI\-o, \-\-output\fP, \fI\-J, \-\-remote\-header\-name\fP,
\fI\-O, \-\-remote\-name\fP, or \fI\-\-remote\-name\-all\fP options, curl avoids overwriting files
that already exist. Instead, a dot and a number gets appended to the name of
the file that would be created, up to filename.100 after which it does not
create any file.
Note that this is the negated option name documented. You can thus use
-\-clobber to enforce the clobbering, even if \fI\-J, \-\-remote\-header\-name\fP is
specified.
Providing \fI\-\-no\-clobber\fP multiple times has no extra effect.
Disable it again with \-\-clobber.
Example:
.nf
curl \-\-no\-clobber \-\-output local/dir/file https://example.com
.fi
See also \fI-o, \-\-output\fP and \fI-O, \-\-remote\-name\fP. Added in 7.83.0.
.IP "\-\-no\-keepalive"
Disables the use of keepalive messages on the TCP connection. curl otherwise
enables them by default.
Note that this is the negated option name documented. You can thus use
-\-keepalive to enforce keepalive.
Providing \fI\-\-no\-keepalive\fP multiple times has no extra effect.
Disable it again with \-\-keepalive.
Example:
.nf
curl \-\-no\-keepalive https://example.com
.fi
See also \fI\-\-keepalive\-time\fP.
.IP "\-\-no\-npn"
(HTTPS) curl never uses NPN, this option has no effect (added in 7.86.0).
Disable the NPN TLS extension. NPN is enabled by default if libcurl was built
with an SSL library that supports NPN. NPN is used by a libcurl that supports
HTTP/2 to negotiate HTTP/2 support with the server during https sessions.
Providing \fI\-\-no\-npn\fP multiple times has no extra effect.
Disable it again with \-\-npn.
Example:
.nf
curl \-\-no\-npn https://example.com
.fi
See also \fI\-\-no\-alpn\fP and \fI\-\-http2\fP. \fI\-\-no\-npn\fP requires that the underlying libcurl was built to support TLS.
.IP "\-\-no\-progress\-meter"
Option to switch off the progress meter output without muting or otherwise
affecting warning and informational messages like \fI\-s, \-\-silent\fP does.
Note that this is the negated option name documented. You can thus use
-\-progress\-meter to enable the progress meter again.
Providing \fI\-\-no\-progress\-meter\fP multiple times has no extra effect.
Disable it again with \-\-progress\-meter.
Example:
.nf
curl \-\-no\-progress\-meter \-o store https://example.com
.fi
See also \fI-v, \-\-verbose\fP and \fI-s, \-\-silent\fP. Added in 7.67.0.
.IP "\-\-no\-sessionid"
(TLS) Disable curl\(aqs use of SSL session\-ID caching. By default all transfers are
done using the cache. Note that while nothing should ever get hurt by
attempting to reuse SSL session\-IDs, there seem to be broken SSL
implementations in the wild that may require you to disable this in order for
you to succeed.
Note that this is the negated option name documented. You can thus use
-\-sessionid to enforce session\-ID caching.
Providing \fI\-\-no\-sessionid\fP multiple times has no extra effect.
Disable it again with \-\-sessionid.
Example:
.nf
curl \-\-no\-sessionid https://example.com
.fi
See also \fI-k, \-\-insecure\fP.
.IP "\-\-noproxy <no\-proxy\-list>"
Comma\-separated list of hosts for which not to use a proxy, if one is
specified. The only wildcard is a single * character, which matches all hosts,
and effectively disables the proxy. Each name in this list is matched as
either a domain which contains the hostname, or the hostname itself. For
example, local.com would match local.com, local.com:80, and www.local.com, but
not www.notlocal.com.
This option overrides the environment variables that disable the proxy
(\(aqno_proxy\(aq and \(aqNO_PROXY\(aq) (added in 7.53.0). If there is an environment
variable disabling a proxy, you can set the no proxy list to "" to override
it.
IP addresses specified to this option can be provided using CIDR notation
(added in 7.86.0): an appended slash and number specifies the number of
\(dqnetwork bits" out of the address to use in the comparison. For example
\(dq192.168.0.0/16" would match all addresses starting with "192.168".
If \fI\-\-noproxy\fP is provided several times, the last set value is used.
Example:
.nf
curl \-\-noproxy "www.example" https://example.com
.fi
See also \fI-x, \-\-proxy\fP.
.IP "\-\-ntlm\-wb"
(HTTP) Enables NTLM much in the style \fI\-\-ntlm\fP does, but hand over the authentication
to the separate binary ntlmauth application that is executed when needed.
Providing \fI\-\-ntlm\-wb\fP multiple times has no extra effect.
Example:
.nf
curl \-\-ntlm\-wb \-u user:password https://example.com
.fi
See also \fI\-\-ntlm\fP and \fI\-\-proxy\-ntlm\fP.
.IP "\-\-ntlm"
(HTTP) Enables NTLM authentication. The NTLM authentication method was designed by
Microsoft and is used by IIS web servers. It is a proprietary protocol,
reverse\-engineered by clever people and implemented in curl based on their
efforts. This kind of behavior should not be endorsed, you should encourage
everyone who uses NTLM to switch to a public and documented authentication
method instead, such as Digest.
If you want to enable NTLM for your proxy authentication, then use
\fI\-\-proxy\-ntlm\fP.
Providing \fI\-\-ntlm\fP multiple times has no extra effect.
Example:
.nf
curl \-\-ntlm \-u user:password https://example.com
.fi
See also \fI\-\-proxy\-ntlm\fP. \fI\-\-ntlm\fP requires that the underlying libcurl was built to support TLS. This option is mutually exclusive to \fI\-\-basic\fP and \fI\-\-negotiate\fP and \fI\-\-digest\fP and \fI\-\-anyauth\fP.
.IP "\-\-oauth2\-bearer <token>"
(IMAP LDAP POP3 SMTP HTTP) Specify the Bearer Token for OAUTH 2.0 server authentication. The Bearer Token
is used in conjunction with the user name which can be specified as part of
the \fI\-\-url\fP or \fI\-u, \-\-user\fP options.
The Bearer Token and user name are formatted according to RFC 6750.
If \fI\-\-oauth2\-bearer\fP is provided several times, the last set value is used.
Example:
.nf
curl \-\-oauth2\-bearer "mF_9.B5f\-4.1JqM" https://example.com
.fi
See also \fI\-\-basic\fP, \fI\-\-ntlm\fP and \fI\-\-digest\fP.
.IP "\-\-output\-dir <dir>"
This option specifies the directory in which files should be stored, when
\fI\-O, \-\-remote\-name\fP or \fI\-o, \-\-output\fP are used.
The given output directory is used for all URLs and output options on the
command line, up until the first \fI\-:, \-\-next\fP.
If the specified target directory does not exist, the operation fails unless
\fI\-\-create\-dirs\fP is also used.
If \fI\-\-output\-dir\fP is provided several times, the last set value is used.
Example:
.nf
curl \-\-output\-dir "tmp" \-O https://example.com
.fi
See also \fI-O, \-\-remote\-name\fP and \fI-J, \-\-remote\-header\-name\fP. Added in 7.73.0.
.IP "\-o, \-\-output <file>"
Write output to <file> instead of stdout. If you are using {} or [] to fetch
multiple documents, you should quote the URL and you can use \(aq#\(aq followed by a
number in the <file> specifier. That variable is replaced with the current
string for the URL being fetched. Like in:
.nf
curl "http://{one,two}.example.com" \-o "file_#1.txt"
.fi
or use several variables like:
.nf
curl "http://{site,host}.host[1\-5].example" \-o "#1_#2"
.fi
You may use this option as many times as the number of URLs you have. For
example, if you specify two URLs on the same command line, you can use it like
this:
.nf
curl \-o aa example.com \-o bb example.net
.fi
and the order of the \-o options and the URLs does not matter, just that the
first \-o is for the first URL and so on, so the above command line can also be
written as
.nf
curl example.com example.net \-o aa \-o bb
.fi
See also the \fI\-\-create\-dirs\fP option to create the local directories
dynamically. Specifying the output as \(aq\-\(aq (a single dash) passes the output to
stdout.
To suppress response bodies, you can redirect output to /dev/null:
.nf
curl example.com \-o /dev/null
.fi
Or for Windows:
.nf
curl example.com \-o nul
.fi
\fI\-o, \-\-output\fP can be used several times in a command line
Examples:
.nf
curl \-o file https://example.com
curl "http://{one,two}.example.com" \-o "file_#1.txt"
curl "http://{site,host}.host[1\-5].example" \-o "#1_#2"
curl \-o file https://example.com \-o file2 https://example.net
.fi
See also \fI-O, \-\-remote\-name\fP, \fI\-\-remote\-name\-all\fP and \fI-J, \-\-remote\-header\-name\fP.
.IP "\-\-parallel\-immediate"
When doing parallel transfers, this option instructs curl that it should
rather prefer opening up more connections in parallel at once rather than
waiting to see if new transfers can be added as multiplexed streams on another
connection.
This option is global and does not need to be specified for each use of --next.
Providing \fI\-\-parallel\-immediate\fP multiple times has no extra effect.
Disable it again with \-\-no\-parallel\-immediate.
Example:
.nf
curl \-\-parallel\-immediate \-Z https://example.com \-o file1 https://example.com \-o file2
.fi
See also \fI-Z, \-\-parallel\fP and \fI\-\-parallel\-max\fP. Added in 7.68.0.
.IP "\-\-parallel\-max <num>"
When asked to do parallel transfers, using \fI\-Z, \-\-parallel\fP, this option controls
the maximum amount of transfers to do simultaneously.
This option is global and does not need to be specified for each use of
\fI\-:, \-\-next\fP.
The default is 50.
If \fI\-\-parallel\-max\fP is provided several times, the last set value is used.
Example:
.nf
curl \-\-parallel\-max 100 \-Z https://example.com ftp://example.com/
.fi
See also \fI-Z, \-\-parallel\fP. Added in 7.66.0.
.IP "\-Z, \-\-parallel"
Makes curl perform its transfers in parallel as compared to the regular serial
manner.
This option is global and does not need to be specified for each use of --next.
Providing \fI\-Z, \-\-parallel\fP multiple times has no extra effect.
Disable it again with \-\-no\-parallel.
Example:
.nf
curl \-\-parallel https://example.com \-o file1 https://example.com \-o file2
.fi
See also \fI-:, \-\-next\fP and \fI-v, \-\-verbose\fP. Added in 7.66.0.
.IP "\-\-pass <phrase>"
(SSH TLS) Passphrase for the private key.
If \fI\-\-pass\fP is provided several times, the last set value is used.
Example:
.nf
curl \-\-pass secret \-\-key file https://example.com
.fi
See also \fI\-\-key\fP and \fI-u, \-\-user\fP.
.IP "\-\-path\-as\-is"
Tell curl to not handle sequences of /../ or /./ in the given URL
path. Normally curl squashes or merges them according to standards but with
this option set you tell it not to do that.
Providing \fI\-\-path\-as\-is\fP multiple times has no extra effect.
Disable it again with \-\-no\-path\-as\-is.
Example:
.nf
curl \-\-path\-as\-is https://example.com/../../etc/passwd
.fi
See also \fI\-\-request\-target\fP.
.IP "\-\-pinnedpubkey <hashes>"
(TLS) Tells curl to use the specified public key file (or hashes) to verify the
peer. This can be a path to a file which contains a single public key in PEM
or DER format, or any number of base64 encoded sha256 hashes preceded by
\(aqsha256//\(aq and separated by \(aq;\(aq.
When negotiating a TLS or SSL connection, the server sends a certificate
indicating its identity. A public key is extracted from this certificate and
if it does not exactly match the public key provided to this option, curl
aborts the connection before sending or receiving any data.
This option is independent of option \fI\-k, \-\-insecure\fP. If you use both options
together then the peer is still verified by public key.
PEM/DER support:
OpenSSL and GnuTLS, wolfSSL (added in 7.43.0), mbedTLS
, Secure Transport macOS 10.7+/iOS 10+ (7.54.1), Schannel
(7.58.1)
sha256 support:
OpenSSL, GnuTLS and wolfSSL, mbedTLS (added in 7.47.0),
Secure Transport macOS 10.7+/iOS 10+ (7.54.1), Schannel (7.58.1)
Other SSL backends not supported.
If \fI\-\-pinnedpubkey\fP is provided several times, the last set value is used.
Examples:
.nf
curl \-\-pinnedpubkey keyfile https://example.com
curl \-\-pinnedpubkey \(aqsha256//ce118b51897f4452dc\(aq https://example.com
.fi
See also \fI\-\-hostpubsha256\fP.
.IP "\-\-post301"
(HTTP) Tells curl to respect RFC 7231/6.4.2 and not convert POST requests into GET
requests when following a 301 redirection. The non\-RFC behavior is ubiquitous
in web browsers, so curl does the conversion by default to maintain
consistency. However, a server may require a POST to remain a POST after such
a redirection. This option is meaningful only when using \fI\-L, \-\-location\fP.
Providing \fI\-\-post301\fP multiple times has no extra effect.
Disable it again with \-\-no\-post301.
Example:
.nf
curl \-\-post301 \-\-location \-d "data" https://example.com
.fi
See also \fI\-\-post302\fP, \fI\-\-post303\fP and \fI-L, \-\-location\fP.
.IP "\-\-post302"
(HTTP) Tells curl to respect RFC 7231/6.4.3 and not convert POST requests into GET
requests when following a 302 redirection. The non\-RFC behavior is ubiquitous
in web browsers, so curl does the conversion by default to maintain
consistency. However, a server may require a POST to remain a POST after such
a redirection. This option is meaningful only when using \fI\-L, \-\-location\fP.
Providing \fI\-\-post302\fP multiple times has no extra effect.
Disable it again with \-\-no\-post302.
Example:
.nf
curl \-\-post302 \-\-location \-d "data" https://example.com
.fi
See also \fI\-\-post301\fP, \fI\-\-post303\fP and \fI-L, \-\-location\fP.
.IP "\-\-post303"
(HTTP) Tells curl to violate RFC 7231/6.4.4 and not convert POST requests into GET
requests when following 303 redirections. A server may require a POST to
remain a POST after a 303 redirection. This option is meaningful only when
using \fI\-L, \-\-location\fP.
Providing \fI\-\-post303\fP multiple times has no extra effect.
Disable it again with \-\-no\-post303.
Example:
.nf
curl \-\-post303 \-\-location \-d "data" https://example.com
.fi
See also \fI\-\-post302\fP, \fI\-\-post301\fP and \fI-L, \-\-location\fP.
.IP "\-\-preproxy [protocol://]host[:port]"
Use the specified SOCKS proxy before connecting to an HTTP or HTTPS \fI\-x, \-\-proxy\fP. In
such a case curl first connects to the SOCKS proxy and then connects (through
SOCKS) to the HTTP or HTTPS proxy. Hence pre proxy.
The pre proxy string should be specified with a protocol:// prefix to specify
alternative proxy protocols. Use socks4://, socks4a://, socks5:// or
socks5h:// to request the specific SOCKS version to be used. No protocol
specified makes curl default to SOCKS4.
If the port number is not specified in the proxy string, it is assumed to be
1080.
User and password that might be provided in the proxy string are URL decoded
by curl. This allows you to pass in special characters such as @ by using %40
or pass in a colon with %3a.
If \fI\-\-preproxy\fP is provided several times, the last set value is used.
Example:
.nf
curl \-\-preproxy socks5://proxy.example \-x http://http.example https://example.com
.fi
See also \fI-x, \-\-proxy\fP and \fI\-\-socks5\fP. Added in 7.52.0.
.IP "\-#, \-\-progress\-bar"
Make curl display transfer progress as a simple progress bar instead of the
standard, more informational, meter.
This progress bar draws a single line of \(aq#\(aq characters across the screen and
shows a percentage if the transfer size is known. For transfers without a
known size, there is a space ship (\-=o=\-) that moves back and forth but only
while data is being transferred, with a set of flying hash sign symbols on
top.
This option is global and does not need to be specified for each use of --next.
Providing \fI\-#, \-\-progress\-bar\fP multiple times has no extra effect.
Disable it again with \-\-no\-progress\-bar.
Example:
.nf
curl \-# \-O https://example.com
.fi
See also \fI\-\-styled\-output\fP.
.IP "\-\-proto\-default <protocol>"
Tells curl to use \fIprotocol\fP for any URL missing a scheme name.
An unknown or unsupported protocol causes error
\fICURLE_UNSUPPORTED_PROTOCOL\fP (1).
This option does not change the default proxy protocol (http).
Without this option set, curl guesses protocol based on the host name, see
\fI\-\-url\fP for details.
If \fI\-\-proto\-default\fP is provided several times, the last set value is used.
Example:
.nf
curl \-\-proto\-default https ftp.example.com
.fi
See also \fI\-\-proto\fP and \fI\-\-proto\-redir\fP.
.IP "\-\-proto\-redir <protocols>"
Tells curl to limit what protocols it may use on redirect. Protocols denied by
\fI\-\-proto\fP are not overridden by this option. See \fI\-\-proto\fP for how protocols are
represented.
Example, allow only HTTP and HTTPS on redirect:
.nf
curl \--proto\-redir \-all,http,https http://example.com
.fi
By default curl only allows HTTP, HTTPS, FTP and FTPS on redirects (added in
7.65.2). Specifying \fIall\fP or \fI+all\fP enables all protocols on redirects, which
is not good for security.
If \fI\-\-proto\-redir\fP is provided several times, the last set value is used.
Example:
.nf
curl \-\-proto\-redir =http,https https://example.com
.fi
See also \fI\-\-proto\fP.
.IP "\-\-proto <protocols>"
Tells curl to limit what protocols it may use for transfers. Protocols are
evaluated left to right, are comma separated, and are each a protocol name or
\(aqall\(aq, optionally prefixed by zero or more modifiers. Available modifiers are:
.RS
.TP 3
.B +
Permit this protocol in addition to protocols already permitted (this is
the default if no modifier is used).
.TP
.B \-
Deny this protocol, removing it from the list of protocols already permitted.
.TP
.B =
Permit only this protocol (ignoring the list already permitted), though
subject to later modification by subsequent entries in the comma separated
list.
.RE
.IP
For example:
.RS
.TP 15
.B \fI\-\-proto\fP \-ftps
uses the default protocols, but disables ftps
.TP
.B \fI\-\-proto\fP \-all,https,+http
only enables http and https
.TP
.B \fI\-\-proto\fP =http,https
also only enables http and https
.RE
.IP
Unknown and disabled protocols produce a warning. This allows scripts to
safely rely on being able to disable potentially dangerous protocols, without
relying upon support for that protocol being built into curl to avoid an error.
This option can be used multiple times, in which case the effect is the same
as concatenating the protocols into one instance of the option.
If \fI\-\-proto\fP is provided several times, the last set value is used.
Example:
.nf
curl \-\-proto =http,https,sftp https://example.com
.fi
See also \fI\-\-proto\-redir\fP and \fI\-\-proto\-default\fP.
.IP "\-\-proxy\-anyauth"
Tells curl to pick a suitable authentication method when communicating with
the given HTTP proxy. This might cause an extra request/response round\-trip.
Providing \fI\-\-proxy\-anyauth\fP multiple times has no extra effect.
Example:
.nf
curl \-\-proxy\-anyauth \-\-proxy\-user user:passwd \-x proxy https://example.com
.fi
See also \fI-x, \-\-proxy\fP, \fI\-\-proxy\-basic\fP and \fI\-\-proxy\-digest\fP.
.IP "\-\-proxy\-basic"
Tells curl to use HTTP Basic authentication when communicating with the given
proxy. Use \fI\-\-basic\fP for enabling HTTP Basic with a remote host. Basic is the
default authentication method curl uses with proxies.
Providing \fI\-\-proxy\-basic\fP multiple times has no extra effect.
Example:
.nf
curl \-\-proxy\-basic \-\-proxy\-user user:passwd \-x proxy https://example.com
.fi
See also \fI-x, \-\-proxy\fP, \fI\-\-proxy\-anyauth\fP and \fI\-\-proxy\-digest\fP.
.IP "\-\-proxy\-ca\-native"
(TLS) Tells curl to use the CA store from the native operating system to verify the
HTTPS proxy. By default, curl uses a CA store provided in a single file or
directory, but when using this option it interfaces the operating system\(aqs own
vault.
This option only works for curl on Windows when built to use OpenSSL. When
curl on Windows is built to use Schannel, this feature is implied and curl
then only uses the native CA store.
curl built with wolfSSL also supports this option (added in 8.3.0).
Providing \fI\-\-proxy\-ca\-native\fP multiple times has no extra effect.
Disable it again with \-\-no\-proxy\-ca\-native.
Example:
.nf
curl \-\-ca\-native https://example.com
.fi
See also \fI\-\-cacert\fP, \fI\-\-capath\fP and \fI-k, \-\-insecure\fP. Added in 8.2.0.
.IP "\-\-proxy\-cacert <file>"
Same as \fI\-\-cacert\fP but used in HTTPS proxy context.
If \fI\-\-proxy\-cacert\fP is provided several times, the last set value is used.
Example:
.nf
curl \-\-proxy\-cacert CA\-file.txt \-x https://proxy https://example.com
.fi
See also \fI\-\-proxy\-capath\fP, \fI\-\-cacert\fP, \fI\-\-capath\fP and \fI-x, \-\-proxy\fP. Added in 7.52.0.
.IP "\-\-proxy\-capath <dir>"
Same as \fI\-\-capath\fP but used in HTTPS proxy context.
If \fI\-\-proxy\-capath\fP is provided several times, the last set value is used.
Example:
.nf
curl \-\-proxy\-capath /local/directory \-x https://proxy https://example.com
.fi
See also \fI\-\-proxy\-cacert\fP, \fI-x, \-\-proxy\fP and \fI\-\-capath\fP. Added in 7.52.0.
.IP "\-\-proxy\-cert\-type <type>"
Same as \fI\-\-cert\-type\fP but used in HTTPS proxy context.
If \fI\-\-proxy\-cert\-type\fP is provided several times, the last set value is used.
Example:
.nf
curl \-\-proxy\-cert\-type PEM \-\-proxy\-cert file \-x https://proxy https://example.com
.fi
See also \fI\-\-proxy\-cert\fP. Added in 7.52.0.
.IP "\-\-proxy\-cert <cert[:passwd]>"
Same as \fI\-E, \-\-cert\fP but used in HTTPS proxy context.
If \fI\-\-proxy\-cert\fP is provided several times, the last set value is used.
Example:
.nf
curl \-\-proxy\-cert file \-x https://proxy https://example.com
.fi
See also \fI\-\-proxy\-cert\-type\fP. Added in 7.52.0.
.IP "\-\-proxy\-ciphers <list>"
Same as \fI\-\-ciphers\fP but used in HTTPS proxy context.
Specifies which ciphers to use in the connection to the HTTPS proxy. The list
of ciphers must specify valid ciphers. Read up on SSL cipher list details on
this URL:
https://curl.se/docs/ssl\-ciphers.html
If \fI\-\-proxy\-ciphers\fP is provided several times, the last set value is used.
Example:
.nf
curl \-\-proxy\-ciphers ECDHE\-ECDSA\-AES256\-CCM8 \-x https://proxy https://example.com
.fi
See also \fI\-\-ciphers\fP, \fI\-\-curves\fP and \fI-x, \-\-proxy\fP. Added in 7.52.0.
.IP "\-\-proxy\-crlfile <file>"
Same as \fI\-\-crlfile\fP but used in HTTPS proxy context.
If \fI\-\-proxy\-crlfile\fP is provided several times, the last set value is used.
Example:
.nf
curl \-\-proxy\-crlfile rejects.txt \-x https://proxy https://example.com
.fi
See also \fI\-\-crlfile\fP and \fI-x, \-\-proxy\fP. Added in 7.52.0.
.IP "\-\-proxy\-digest"
Tells curl to use HTTP Digest authentication when communicating with the given
proxy. Use \fI\-\-digest\fP for enabling HTTP Digest with a remote host.
Providing \fI\-\-proxy\-digest\fP multiple times has no extra effect.
Example:
.nf
curl \-\-proxy\-digest \-\-proxy\-user user:passwd \-x proxy https://example.com
.fi
See also \fI-x, \-\-proxy\fP, \fI\-\-proxy\-anyauth\fP and \fI\-\-proxy\-basic\fP.
.IP "\-\-proxy\-header <header/@file>"
(HTTP) Extra header to include in the request when sending HTTP to a proxy. You may
specify any number of extra headers. This is the equivalent option to \fI\-H, \-\-header\fP
but is for proxy communication only like in CONNECT requests when you want a
separate header sent to the proxy to what is sent to the actual remote host.
curl makes sure that each header you add/replace is sent with the proper
end\-of\-line marker, you should thus \fBnot\fP add that as a part of the header
content: do not add newlines or carriage returns, they only mess things up for
you.
Headers specified with this option are not included in requests that curl
knows are not be sent to a proxy.
This option can take an argument in @filename style, which then adds a header
for each line in the input file (added in 7.55.0). Using @\- makes curl read
the headers from stdin.
This option can be used multiple times to add/replace/remove multiple headers.
\fI\-\-proxy\-header\fP can be used several times in a command line
Examples:
.nf
curl \-\-proxy\-header "X\-First\-Name: Joe" \-x http://proxy https://example.com
curl \-\-proxy\-header "User\-Agent: surprise" \-x http://proxy https://example.com
curl \-\-proxy\-header "Host:" \-x http://proxy https://example.com
.fi
See also \fI-x, \-\-proxy\fP.
.IP "\-\-proxy\-http2"
(HTTP) Tells curl to try negotiate HTTP version 2 with an HTTPS proxy. The proxy might
still only offer HTTP/1 and then curl sticks to using that version.
This has no effect for any other kinds of proxies.
Providing \fI\-\-proxy\-http2\fP multiple times has no extra effect.
Disable it again with \-\-no\-proxy\-http2.
Example:
.nf
curl \-\-proxy\-http2 \-x proxy https://example.com
.fi
See also \fI-x, \-\-proxy\fP. \fI\-\-proxy\-http2\fP requires that the underlying libcurl was built to support HTTP/2. Added in 8.1.0.
.IP "\-\-proxy\-insecure"
Same as \fI\-k, \-\-insecure\fP but used in HTTPS proxy context.
Providing \fI\-\-proxy\-insecure\fP multiple times has no extra effect.
Disable it again with \-\-no\-proxy\-insecure.
Example:
.nf
curl \-\-proxy\-insecure \-x https://proxy https://example.com
.fi
See also \fI-x, \-\-proxy\fP and \fI-k, \-\-insecure\fP. Added in 7.52.0.
.IP "\-\-proxy\-key\-type <type>"
Same as \fI\-\-key\-type\fP but used in HTTPS proxy context.
If \fI\-\-proxy\-key\-type\fP is provided several times, the last set value is used.
Example:
.nf
curl \-\-proxy\-key\-type DER \-\-proxy\-key here \-x https://proxy https://example.com
.fi
See also \fI\-\-proxy\-key\fP and \fI-x, \-\-proxy\fP. Added in 7.52.0.
.IP "\-\-proxy\-key <key>"
Same as \fI\-\-key\fP but used in HTTPS proxy context.
If \fI\-\-proxy\-key\fP is provided several times, the last set value is used.
Example:
.nf
curl \-\-proxy\-key here \-x https://proxy https://example.com
.fi
See also \fI\-\-proxy\-key\-type\fP and \fI-x, \-\-proxy\fP. Added in 7.52.0.
.IP "\-\-proxy\-negotiate"
Tells curl to use HTTP Negotiate (SPNEGO) authentication when communicating
with the given proxy. Use \fI\-\-negotiate\fP for enabling HTTP Negotiate (SPNEGO)
with a remote host.
Providing \fI\-\-proxy\-negotiate\fP multiple times has no extra effect.
Example:
.nf
curl \-\-proxy\-negotiate \-\-proxy\-user user:passwd \-x proxy https://example.com
.fi
See also \fI\-\-proxy\-anyauth\fP and \fI\-\-proxy\-basic\fP.
.IP "\-\-proxy\-ntlm"
Tells curl to use HTTP NTLM authentication when communicating with the given
proxy. Use \fI\-\-ntlm\fP for enabling NTLM with a remote host.
Providing \fI\-\-proxy\-ntlm\fP multiple times has no extra effect.
Example:
.nf
curl \-\-proxy\-ntlm \-\-proxy\-user user:passwd \-x http://proxy https://example.com
.fi
See also \fI\-\-proxy\-negotiate\fP and \fI\-\-proxy\-anyauth\fP.
.IP "\-\-proxy\-pass <phrase>"
Same as \fI\-\-pass\fP but used in HTTPS proxy context.
If \fI\-\-proxy\-pass\fP is provided several times, the last set value is used.
Example:
.nf
curl \-\-proxy\-pass secret \-\-proxy\-key here \-x https://proxy https://example.com
.fi
See also \fI-x, \-\-proxy\fP and \fI\-\-proxy\-key\fP. Added in 7.52.0.
.IP "\-\-proxy\-pinnedpubkey <hashes>"
(TLS) Tells curl to use the specified public key file (or hashes) to verify the
proxy. This can be a path to a file which contains a single public key in PEM
or DER format, or any number of base64 encoded sha256 hashes preceded by
\(aqsha256//\(aq and separated by \(aq;\(aq.
When negotiating a TLS or SSL connection, the server sends a certificate
indicating its identity. A public key is extracted from this certificate and
if it does not exactly match the public key provided to this option, curl
aborts the connection before sending or receiving any data.
If \fI\-\-proxy\-pinnedpubkey\fP is provided several times, the last set value is used.
Examples:
.nf
curl \-\-proxy\-pinnedpubkey keyfile https://example.com
curl \-\-proxy\-pinnedpubkey \(aqsha256//ce118b51897f4452dc\(aq https://example.com
.fi
See also \fI\-\-pinnedpubkey\fP and \fI-x, \-\-proxy\fP. Added in 7.59.0.
.IP "\-\-proxy\-service\-name <name>"
This option allows you to change the service name for proxy negotiation.
If \fI\-\-proxy\-service\-name\fP is provided several times, the last set value is used.
Example:
.nf
curl \-\-proxy\-service\-name "shrubbery" \-x proxy https://example.com
.fi
See also \fI\-\-service\-name\fP and \fI-x, \-\-proxy\fP.
.IP "\-\-proxy\-ssl\-allow\-beast"
Same as \fI\-\-ssl\-allow\-beast\fP but used in HTTPS proxy context.
Providing \fI\-\-proxy\-ssl\-allow\-beast\fP multiple times has no extra effect.
Disable it again with \-\-no\-proxy\-ssl\-allow\-beast.
Example:
.nf
curl \-\-proxy\-ssl\-allow\-beast \-x https://proxy https://example.com
.fi
See also \fI\-\-ssl\-allow\-beast\fP and \fI-x, \-\-proxy\fP. Added in 7.52.0.
.IP "\-\-proxy\-ssl\-auto\-client\-cert"
Same as \fI\-\-ssl\-auto\-client\-cert\fP but used in HTTPS proxy context.
Providing \fI\-\-proxy\-ssl\-auto\-client\-cert\fP multiple times has no extra effect.
Disable it again with \-\-no\-proxy\-ssl\-auto\-client\-cert.
Example:
.nf
curl \-\-proxy\-ssl\-auto\-client\-cert \-x https://proxy https://example.com
.fi
See also \fI\-\-ssl\-auto\-client\-cert\fP and \fI-x, \-\-proxy\fP. Added in 7.77.0.
.IP "\-\-proxy\-tls13\-ciphers <ciphersuite list>"
(TLS) Specifies which cipher suites to use in the connection to your HTTPS proxy
when it negotiates TLS 1.3. The list of ciphers suites must specify valid
ciphers. Read up on TLS 1.3 cipher suite details on this URL:
https://curl.se/docs/ssl\-ciphers.html
This option is currently used only when curl is built to use OpenSSL 1.1.1 or
later. If you are using a different SSL backend you can try setting TLS 1.3
cipher suites by using the \fI\-\-proxy\-ciphers\fP option.
If \fI\-\-proxy\-tls13\-ciphers\fP is provided several times, the last set value is used.
Example:
.nf
curl \-\-proxy\-tls13\-ciphers TLS_AES_128_GCM_SHA256 \-x proxy https://example.com
.fi
See also \fI\-\-tls13\-ciphers\fP, \fI\-\-curves\fP and \fI\-\-proxy\-ciphers\fP. Added in 7.61.0.
.IP "\-\-proxy\-tlsauthtype <type>"
Same as \fI\-\-tlsauthtype\fP but used in HTTPS proxy context.
If \fI\-\-proxy\-tlsauthtype\fP is provided several times, the last set value is used.
Example:
.nf
curl \-\-proxy\-tlsauthtype SRP \-x https://proxy https://example.com
.fi
See also \fI-x, \-\-proxy\fP and \fI\-\-proxy\-tlsuser\fP. Added in 7.52.0.
.IP "\-\-proxy\-tlspassword <string>"
Same as \fI\-\-tlspassword\fP but used in HTTPS proxy context.
If \fI\-\-proxy\-tlspassword\fP is provided several times, the last set value is used.
Example:
.nf
curl \-\-proxy\-tlspassword passwd \-x https://proxy https://example.com
.fi
See also \fI-x, \-\-proxy\fP and \fI\-\-proxy\-tlsuser\fP. Added in 7.52.0.
.IP "\-\-proxy\-tlsuser <name>"
Same as \fI\-\-tlsuser\fP but used in HTTPS proxy context.
If \fI\-\-proxy\-tlsuser\fP is provided several times, the last set value is used.
Example:
.nf
curl \-\-proxy\-tlsuser smith \-x https://proxy https://example.com
.fi
See also \fI-x, \-\-proxy\fP and \fI\-\-proxy\-tlspassword\fP. Added in 7.52.0.
.IP "\-\-proxy\-tlsv1"
Same as \fI\-1, \-\-tlsv1\fP but used in HTTPS proxy context.
Providing \fI\-\-proxy\-tlsv1\fP multiple times has no extra effect.
Example:
.nf
curl \-\-proxy\-tlsv1 \-x https://proxy https://example.com
.fi
See also \fI-x, \-\-proxy\fP. Added in 7.52.0.
.IP "\-U, \-\-proxy\-user <user:password>"
Specify the user name and password to use for proxy authentication.
If you use a Windows SSPI\-enabled curl binary and do either Negotiate or NTLM
authentication then you can tell curl to select the user name and password
from your environment by specifying a single colon with this option: "\-U :".
On systems where it works, curl hides the given option argument from process
listings. This is not enough to protect credentials from possibly getting seen
by other users on the same system as they still are visible for a moment
before cleared. Such sensitive data should be retrieved from a file instead or
similar and never used in clear text in a command line.
If \fI\-U, \-\-proxy\-user\fP is provided several times, the last set value is used.
Example:
.nf
curl \-\-proxy\-user name:pwd \-x proxy https://example.com
.fi
See also \fI\-\-proxy\-pass\fP.
.IP "\-x, \-\-proxy [protocol://]host[:port]"
Use the specified proxy.
The proxy string can be specified with a protocol:// prefix. No protocol
specified or http:// it is treated as an HTTP proxy. Use socks4://,
socks4a://, socks5:// or socks5h:// to request a specific SOCKS version to be
used.
Unix domain sockets are supported for socks proxy. Set localhost for the host
part. e.g. socks5h://localhost/path/to/socket.sock
HTTPS proxy support works set with the https:// protocol prefix for OpenSSL
and GnuTLS (added in 7.52.0). It also works for BearSSL, mbedTLS, rustls,
Schannel, Secure Transport and wolfSSL (added in 7.87.0).
Unrecognized and unsupported proxy protocols cause an error (added in 7.52.0).
Ancient curl versions ignored unknown schemes and used http:// instead.
If the port number is not specified in the proxy string, it is assumed to be
1080.
This option overrides existing environment variables that set the proxy to
use. If there is an environment variable setting a proxy, you can set proxy to
\(dq" to override it.
All operations that are performed over an HTTP proxy are transparently
converted to HTTP. It means that certain protocol specific operations might
not be available. This is not the case if you can tunnel through the proxy, as
one with the \fI\-p, \-\-proxytunnel\fP option.
User and password that might be provided in the proxy string are URL decoded
by curl. This allows you to pass in special characters such as @ by using %40
or pass in a colon with %3a.
The proxy host can be specified the same way as the proxy environment
variables, including the protocol prefix (http://) and the embedded user +
password.
When a proxy is used, the active FTP mode as set with \fI\-P, \-\-ftp\-port\fP, cannot be
used.
If \fI\-x, \-\-proxy\fP is provided several times, the last set value is used.
Example:
.nf
curl \-\-proxy http://proxy.example https://example.com
.fi
See also \fI\-\-socks5\fP and \fI\-\-proxy\-basic\fP.
.IP "\-\-proxy1.0 <host[:port]>"
Use the specified HTTP 1.0 proxy. If the port number is not specified, it is
assumed at port 1080.
The only difference between this and the HTTP proxy option \fI\-x, \-\-proxy\fP, is that
attempts to use CONNECT through the proxy specifies an HTTP 1.0 protocol
instead of the default HTTP 1.1.
Providing \fI\-\-proxy1.0\fP multiple times has no extra effect.
Example:
.nf
curl \-\-proxy1.0 \-x http://proxy https://example.com
.fi
See also \fI-x, \-\-proxy\fP, \fI\-\-socks5\fP and \fI\-\-preproxy\fP.
.IP "\-p, \-\-proxytunnel"
When an HTTP proxy is used \fI\-x, \-\-proxy\fP, this option makes curl tunnel the traffic
through the proxy. The tunnel approach is made with the HTTP proxy CONNECT
request and requires that the proxy allows direct connect to the remote port
number curl wants to tunnel through to.
To suppress proxy CONNECT response headers when curl is set to output headers
use \fI\-\-suppress\-connect\-headers\fP.
Providing \fI\-p, \-\-proxytunnel\fP multiple times has no extra effect.
Disable it again with \-\-no\-proxytunnel.
Example:
.nf
curl \-\-proxytunnel \-x http://proxy https://example.com
.fi
See also \fI-x, \-\-proxy\fP.
.IP "\-\-pubkey <key>"
(SFTP SCP) Public key file name. Allows you to provide your public key in this separate
file.
curl attempts to automatically extract the public key from the private key
file, so passing this option is generally not required. Note that this public
key extraction requires libcurl to be linked against a copy of libssh2 1.2.8
or higher that is itself linked against OpenSSL.
If \fI\-\-pubkey\fP is provided several times, the last set value is used.
Example:
.nf
curl \-\-pubkey file.pub sftp://example.com/
.fi
See also \fI\-\-pass\fP.
.IP "\-Q, \-\-quote <command>"
(FTP SFTP) Send an arbitrary command to the remote FTP or SFTP server. Quote commands are
sent BEFORE the transfer takes place (just after the initial \fBPWD\fP command
in an FTP transfer, to be exact). To make commands take place after a
successful transfer, prefix them with a dash \(aq\-\(aq.
(FTP only) To make commands be sent after curl has changed the working
directory, just before the file transfer command(s), prefix the command with a
\(aq+\(aq. This is not performed when a directory listing is performed.
You may specify any number of commands.
By default curl stops at first failure. To make curl continue even if the
command fails, prefix the command with an asterisk (*). Otherwise, if the
server returns failure for one of the commands, the entire operation is
aborted.
You must send syntactically correct FTP commands as RFC 959 defines to FTP
servers, or one of the commands listed below to SFTP servers.
SFTP is a binary protocol. Unlike for FTP, curl interprets SFTP quote commands
itself before sending them to the server. File names may be quoted
shell\-style to embed spaces or special characters. Following is the list of
all supported SFTP quote commands:
.RS
.TP
\fI\fP"atime date file"\fI\fP
The atime command sets the last access time of the file named by the file
operand. The <date expression> can be all sorts of date strings, see the
\fIcurl_getdate(3)\fP man page for date expression details. (Added in 7.73.0)
.TP
\fI\fP"chgrp group file"\fI\fP
The chgrp command sets the group ID of the file named by the file operand to
the group ID specified by the group operand. The group operand is a decimal
integer group ID.
.TP
\fI\fP"chmod mode file"\fI\fP
The chmod command modifies the file mode bits of the specified file. The
mode operand is an octal integer mode number.
.TP
\fI\fP"chown user file"\fI\fP
The chown command sets the owner of the file named by the file operand to the
user ID specified by the user operand. The user operand is a decimal
integer user ID.
.TP
\fI\fP"ln source_file target_file"\fI\fP
The ln and symlink commands create a symbolic link at the target_file location
pointing to the source_file location.
.TP
\fI\fP"mkdir directory_name"\fI\fP
The mkdir command creates the directory named by the directory_name operand.
.TP
\fI\fP"mtime date file"\fI\fP
The mtime command sets the last modification time of the file named by the
file operand. The <date expression> can be all sorts of date strings, see the
\fIcurl_getdate(3)\fP man page for date expression details. (Added in 7.73.0)
.TP
\fB"pwd"\fP
The pwd command returns the absolute path name of the current working directory.
.TP
\fI\fP"rename source target"\fI\fP
The rename command renames the file or directory named by the source
operand to the destination path named by the target operand.
.TP
\fI\fP"rm file"\fI\fP
The rm command removes the file specified by the file operand.
.TP
\fI\fP"rmdir directory"\fI\fP
The rmdir command removes the directory entry specified by the directory
operand, provided it is empty.
.TP
\fI\fP"symlink source_file target_file"\fI\fP
See ln.
.RE
.IP
\fI\-Q, \-\-quote\fP can be used several times in a command line
Example:
.nf
curl \-\-quote "DELE file" ftp://example.com/foo
.fi
See also \fI-X, \-\-request\fP.
.IP "\-\-random\-file <file>"
Deprecated option. This option is ignored (added in 7.84.0). Prior to that it
only had an effect on curl if built to use old versions of OpenSSL.
Specify the path name to file containing random data. The data may be used to
seed the random engine for SSL connections.
If \fI\-\-random\-file\fP is provided several times, the last set value is used.
Example:
.nf
curl \-\-random\-file rubbish https://example.com
.fi
See also \fI\-\-egd\-file\fP.
.IP "\-r, \-\-range <range>"
(HTTP FTP SFTP FILE) Retrieve a byte range (i.e. a partial document) from an HTTP/1.1, FTP or SFTP
server or a local FILE. Ranges can be specified in a number of ways.
.RS
.TP 10
.B 0\-499
specifies the first 500 bytes
.TP
.B 500\-999
specifies the second 500 bytes
.TP
.B \-500
specifies the last 500 bytes
.TP
.B 9500\-
specifies the bytes from offset 9500 and forward
.TP
.B 0\-0,\-1
specifies the first and last byte only(*)(HTTP)
.TP
.B 100\-199,500\-599
specifies two separate 100\-byte ranges(*) (HTTP)
.RE
.IP
(*) = NOTE that this causes the server to reply with a multipart response,
which is returned as\-is by curl! Parsing or otherwise transforming this
response is the responsibility of the caller.
Only digit characters (0\-9) are valid in the \(aqstart\(aq and \(aqstop\(aq fields of the
\(aqstart\-stop\(aq range syntax. If a non\-digit character is given in the range, the
server\(aqs response is unspecified, depending on the server\(aqs configuration.
Many HTTP/1.1 servers do not have this feature enabled, so that when you
attempt to get a range, curl instead gets the whole document.
FTP and SFTP range downloads only support the simple \(aqstart\-stop\(aq syntax
(optionally with one of the numbers omitted). FTP use depends on the extended
FTP command SIZE.
If \fI\-r, \-\-range\fP is provided several times, the last set value is used.
Example:
.nf
curl \-\-range 22\-44 https://example.com
.fi
See also \fI-C, \-\-continue\-at\fP and \fI-a, \-\-append\fP.
.IP "\-\-rate <max request rate>"
Specify the maximum transfer frequency you allow curl to use \- in number of
transfer starts per time unit (sometimes called request rate). Without this
option, curl starts the next transfer as fast as possible.
If given several URLs and a transfer completes faster than the allowed rate,
curl waits until the next transfer is started to maintain the requested
rate. This option has no effect when \fI\-Z, \-\-parallel\fP is used.
The request rate is provided as "N/U" where N is an integer number and U is a
time unit. Supported units are \(aqs\(aq (second), \(aqm\(aq (minute), \(aqh\(aq (hour) and \(aqd\(aq
/(day, as in a 24 hour unit). The default time unit, if no "/U" is provided,
is number of transfers per hour.
If curl is told to allow 10 requests per minute, it does not start the next
request until 6 seconds have elapsed since the previous transfer was started.
This function uses millisecond resolution. If the allowed frequency is set
more than 1000 per second, it instead runs unrestricted.
When retrying transfers, enabled with \fI\-\-retry\fP, the separate retry delay logic
is used and not this setting.
This option is global and does not need to be specified for each use of --next.
If \fI\-\-rate\fP is provided several times, the last set value is used.
Examples:
.nf
curl \-\-rate 2/s https://example.com ...
curl \-\-rate 3/h https://example.com ...
curl \-\-rate 14/m https://example.com ...
.fi
See also \fI\-\-limit\-rate\fP and \fI\-\-retry\-delay\fP. Added in 7.84.0.
.IP "\-\-raw"
(HTTP) When used, it disables all internal HTTP decoding of content or transfer
encodings and instead makes them passed on unaltered, raw.
Providing \fI\-\-raw\fP multiple times has no extra effect.
Disable it again with \-\-no\-raw.
Example:
.nf
curl \-\-raw https://example.com
.fi
See also \fI\-\-tr\-encoding\fP.
.IP "\-e, \-\-referer <URL>"
(HTTP) Sends the "Referrer Page" information to the HTTP server. This can also be set
with the \fI\-H, \-\-header\fP flag of course. When used with \fI\-L, \-\-location\fP you can append
\(dq;auto" to the \fI\-e, \-\-referer\fP URL to make curl automatically set the previous URL
when it follows a Location: header. The ";auto" string can be used alone,
even if you do not set an initial \fI\-e, \-\-referer\fP.
If \fI\-e, \-\-referer\fP is provided several times, the last set value is used.
Examples:
.nf
curl \-\-referer "https://fake.example" https://example.com
curl \-\-referer "https://fake.example;auto" \-L https://example.com
curl \-\-referer ";auto" \-L https://example.com
.fi
See also \fI-A, \-\-user\-agent\fP and \fI-H, \-\-header\fP.
.IP "\-J, \-\-remote\-header\-name"
(HTTP) This option tells the \fI\-O, \-\-remote\-name\fP option to use the server\-specified
Content\-Disposition filename instead of extracting a filename from the URL. If
the server\-provided file name contains a path, that is stripped off before the
file name is used.
The file is saved in the current directory, or in the directory specified with
\fI\-\-output\-dir\fP.
If the server specifies a file name and a file with that name already exists
in the destination directory, it is not overwritten and an error occurs \-
unless you allow it by using the \--clobber option. If the server does not
specify a file name then this option has no effect.
There is no attempt to decode %\-sequences (yet) in the provided file name, so
this option may provide you with rather unexpected file names.
This feature uses the name from the "filename" field, it does not yet support
the "filename*" field (filenames with explicit character sets).
\fBWARNING\fP: Exercise judicious use of this option, especially on Windows. A
rogue server could send you the name of a DLL or other file that could be
loaded automatically by Windows or some third party software.
Providing \fI\-J, \-\-remote\-header\-name\fP multiple times has no extra effect.
Disable it again with \-\-no\-remote\-header\-name.
Example:
.nf
curl \-OJ https://example.com/file
.fi
See also \fI-O, \-\-remote\-name\fP.
.IP "\-\-remote\-name\-all"
This option changes the default action for all given URLs to be dealt with as
if \fI\-O, \-\-remote\-name\fP were used for each one. So if you want to disable that for a
specific URL after \fI\-\-remote\-name\-all\fP has been used, you must use "\-o \-" or
-\-no\-remote\-name.
Providing \fI\-\-remote\-name\-all\fP multiple times has no extra effect.
Disable it again with \-\-no\-remote\-name\-all.
Example:
.nf
curl \-\-remote\-name\-all ftp://example.com/file1 ftp://example.com/file2
.fi
See also \fI-O, \-\-remote\-name\fP.
.IP "\-O, \-\-remote\-name"
Write output to a local file named like the remote file we get. (Only the file
part of the remote file is used, the path is cut off.)
The file is saved in the current working directory. If you want the file saved
in a different directory, make sure you change the current working directory
before invoking curl with this option or use \fI\-\-output\-dir\fP.
The remote file name to use for saving is extracted from the given URL,
nothing else, and if it already exists it is overwritten. If you want the
server to be able to choose the file name refer to \fI\-J, \-\-remote\-header\-name\fP which
can be used in addition to this option. If the server chooses a file name and
that name already exists it is not overwritten.
There is no URL decoding done on the file name. If it has %20 or other URL
encoded parts of the name, they end up as\-is as file name.
You may use this option as many times as the number of URLs you have.
\fI\-O, \-\-remote\-name\fP can be used several times in a command line
Example:
.nf
curl \-O https://example.com/filename
.fi
See also \fI\-\-remote\-name\-all\fP, \fI\-\-output\-dir\fP and \fI-J, \-\-remote\-header\-name\fP.
.IP "\-R, \-\-remote\-time"
Makes curl attempt to figure out the timestamp of the remote file that is
getting downloaded, and if that is available make the local file get that same
timestamp.
Providing \fI\-R, \-\-remote\-time\fP multiple times has no extra effect.
Disable it again with \-\-no\-remote\-time.
Example:
.nf
curl \-\-remote\-time \-o foo https://example.com
.fi
See also \fI-O, \-\-remote\-name\fP and \fI-z, \-\-time\-cond\fP.
.IP "\-\-remove\-on\-error"
When curl returns an error when told to save output in a local file, this
option removes that saved file before exiting. This prevents curl from
leaving a partial file in the case of an error during transfer.
If the output is not a file, this option has no effect.
Providing \fI\-\-remove\-on\-error\fP multiple times has no extra effect.
Disable it again with \-\-no\-remove\-on\-error.
Example:
.nf
curl \-\-remove\-on\-error \-o output https://example.com
.fi
See also \fI-f, \-\-fail\fP. Added in 7.83.0.
.IP "\-\-request\-target <path>"
(HTTP) Tells curl to use an alternative "target" (path) instead of using the path as
provided in the URL. Particularly useful when wanting to issue HTTP requests
without leading slash or other data that does not follow the regular URL
pattern, like "OPTIONS *".
If \fI\-\-request\-target\fP is provided several times, the last set value is used.
Example:
.nf
curl \-\-request\-target "*" \-X OPTIONS https://example.com
.fi
See also \fI-X, \-\-request\fP. Added in 7.55.0.
.IP "\-X, \-\-request <method>"
Change the method to use when starting the transfer.
.RS
.TP 15
\fBHTTP\fP
Specifies a custom request method to use when communicating with the HTTP
server. The specified request method is used instead of the method otherwise
used (which defaults to \fIGET\fP). Read the HTTP 1.1 specification for details
and explanations. Common additional HTTP requests include \fIPUT\fP and \fIDELETE\fP,
but related technologies like WebDAV offers \fIPROPFIND\fP, \fICOPY\fP, \fIMOVE\fP and
more.
Normally you do not need this option. All sorts of \fIGET\fP, \fIHEAD\fP, \fIPOST\fP and
\fIPUT\fP requests are rather invoked by using dedicated command line options.
This option only changes the actual word used in the HTTP request, it does not
alter the way curl behaves. So for example if you want to make a proper HEAD
request, using \-X HEAD does not suffice. You need to use the \fI\-I, \-\-head\fP option.
The method string you set with \fI\-X, \-\-request\fP is used for all requests, which
if you for example use \fI\-L, \-\-location\fP may cause unintended side\-effects when curl
does not change request method according to the HTTP 30x response codes \- and
similar.
.TP
\fBFTP\fP
Specifies a custom FTP command to use instead of \fILIST\fP when doing file lists
with FTP.
.TP
\fBPOP3\fP
Specifies a custom POP3 command to use instead of \fILIST\fP or \fIRETR\fP.
.TP
\fBIMAP\fP
Specifies a custom IMAP command to use instead of \fILIST\fP.
.TP
\fBSMTP\fP
Specifies a custom SMTP command to use instead of \fIHELP\fP or \fBVRFY\fP.
.RE
.IP
If \fI\-X, \-\-request\fP is provided several times, the last set value is used.
Examples:
.nf
curl \-X "DELETE" https://example.com
curl \-X NLST ftp://example.com/
.fi
See also \fI\-\-request\-target\fP.
.IP "\-\-resolve <[+]host:port:addr[,addr]...>"
Provide a custom address for a specific host and port pair. Using this, you
can make the curl requests(s) use a specified address and prevent the
otherwise normally resolved address to be used. Consider it a sort of
/etc/hosts alternative provided on the command line. The port number should be
the number used for the specific protocol the host is used for. It means
you need several entries if you want to provide address for the same host but
different ports.
By specifying \(aq*\(aq as host you can tell curl to resolve any host and specific
port pair to the specified address. Wildcard is resolved last so any \fI\-\-resolve\fP
with a specific host and port is used first.
The provided address set by this option is used even if \fI\-4, \-\-ipv4\fP or \fI\-6, \-\-ipv6\fP is
set to make curl use another IP version.
By prefixing the host with a \(aq+\(aq you can make the entry time out after curl\(aqs
default timeout (1 minute). Note that this only makes sense for long running
parallel transfers with a lot of files. In such cases, if this option is used
curl tries to resolve the host as it normally would once the timeout has
expired.
Support for providing the IP address within [brackets] was added in 7.57.0.
Support for providing multiple IP addresses per entry was added in 7.59.0.
Support for resolving with wildcard was added in 7.64.0.
Support for the \(aq+\(aq prefix was was added in 7.75.0.
This option can be used many times to add many host names to resolve.
\fI\-\-resolve\fP can be used several times in a command line
Example:
.nf
curl \-\-resolve example.com:443:127.0.0.1 https://example.com
.fi
See also \fI\-\-connect\-to\fP and \fI\-\-alt\-svc\fP.
.IP "\-\-retry\-all\-errors"
Retry on any error. This option is used together with \fI\-\-retry\fP.
This option is the "sledgehammer" of retrying. Do not use this option by
default (for example in your \fBcurlrc\fP), there may be unintended consequences
such as sending or receiving duplicate data. Do not use with redirected input
or output. You\(aqd be much better off handling your unique problems in shell
script. Please read the example below.
\fBWARNING\fP: For server compatibility curl attempts to retry failed flaky
transfers as close as possible to how they were started, but this is not
possible with redirected input or output. For example, before retrying it
removes output data from a failed partial transfer that was written to an
output file. However this is not true of data redirected to a | pipe or >
file, which are not reset. We strongly suggest you do not parse or record
output via redirect in combination with this option, since you may receive
duplicate data.
By default curl does not return error for transfers with an HTTP response code
that indicates an HTTP error, if the transfer was successful. For example, if
a server replies 404 Not Found and the reply is fully received then that is
not an error. When \fI\-\-retry\fP is used then curl retries on some HTTP response
codes that indicate transient HTTP errors, but that does not include most 4xx
response codes such as 404. If you want to retry on all response codes that
indicate HTTP errors (4xx and 5xx) then combine with \fI\-f, \-\-fail\fP.
Providing \fI\-\-retry\-all\-errors\fP multiple times has no extra effect.
Disable it again with \-\-no\-retry\-all\-errors.
Example:
.nf
curl \-\-retry 5 \-\-retry\-all\-errors https://example.com
.fi
See also \fI\-\-retry\fP. Added in 7.71.0.
.IP "\-\-retry\-connrefused"
In addition to the other conditions, consider ECONNREFUSED as a transient
error too for \fI\-\-retry\fP. This option is used together with \fI\-\-retry\fP.
Providing \fI\-\-retry\-connrefused\fP multiple times has no extra effect.
Disable it again with \-\-no\-retry\-connrefused.
Example:
.nf
curl \-\-retry\-connrefused \-\-retry 7 https://example.com
.fi
See also \fI\-\-retry\fP and \fI\-\-retry\-all\-errors\fP. Added in 7.52.0.
.IP "\-\-retry\-delay <seconds>"
Make curl sleep this amount of time before each retry when a transfer has
failed with a transient error (it changes the default backoff time algorithm
between retries). This option is only interesting if \fI\-\-retry\fP is also
used. Setting this delay to zero makes curl use the default backoff time.
If \fI\-\-retry\-delay\fP is provided several times, the last set value is used.
Example:
.nf
curl \-\-retry\-delay 5 \-\-retry 7 https://example.com
.fi
See also \fI\-\-retry\fP.
.IP "\-\-retry\-max\-time <seconds>"
The retry timer is reset before the first transfer attempt. Retries are done
as usual (see \fI\-\-retry\fP) as long as the timer has not reached this given
limit. Notice that if the timer has not reached the limit, the request is
made and while performing, it may take longer than this given time period. To
limit a single request\(aqs maximum time, use \fI\-m, \-\-max\-time\fP. Set this option to zero
to not timeout retries.
If \fI\-\-retry\-max\-time\fP is provided several times, the last set value is used.
Example:
.nf
curl \-\-retry\-max\-time 30 \-\-retry 10 https://example.com
.fi
See also \fI\-\-retry\fP.
.IP "\-\-retry <num>"
If a transient error is returned when curl tries to perform a transfer, it
retries this number of times before giving up. Setting the number to 0
makes curl do no retries (which is the default). Transient error means either:
a timeout, an FTP 4xx response code or an HTTP 408, 429, 500, 502, 503 or 504
response code.
When curl is about to retry a transfer, it first waits one second and then for
all forthcoming retries it doubles the waiting time until it reaches 10
minutes which then remains delay between the rest of the retries. By using
\fI\-\-retry\-delay\fP you disable this exponential backoff algorithm. See also
\fI\-\-retry\-max\-time\fP to limit the total time allowed for retries.
curl complies with the Retry\-After: response header if one was present to know
when to issue the next retry (added in 7.66.0).
If \fI\-\-retry\fP is provided several times, the last set value is used.
Example:
.nf
curl \-\-retry 7 https://example.com
.fi
See also \fI\-\-retry\-max\-time\fP.
.IP "\-\-sasl\-authzid <identity>"
Use this authorization identity (\fBauthzid\fP), during SASL PLAIN
authentication, in addition to the authentication identity (\fBauthcid\fP) as
specified by \fI\-u, \-\-user\fP.
If the option is not specified, the server derives the \fBauthzid\fP from the
\fBauthcid\fP, but if specified, and depending on the server implementation, it
may be used to access another user\(aqs inbox, that the user has been granted
access to, or a shared mailbox for example.
If \fI\-\-sasl\-authzid\fP is provided several times, the last set value is used.
Example:
.nf
curl \-\-sasl\-authzid zid imap://example.com/
.fi
See also \fI\-\-login\-options\fP. Added in 7.66.0.
.IP "\-\-sasl\-ir"
Enable initial response in SASL authentication.
Providing \fI\-\-sasl\-ir\fP multiple times has no extra effect.
Disable it again with \-\-no\-sasl\-ir.
Example:
.nf
curl \-\-sasl\-ir imap://example.com/
.fi
See also \fI\-\-sasl\-authzid\fP.
.IP "\-\-service\-name <name>"
This option allows you to change the service name for SPNEGO.
If \fI\-\-service\-name\fP is provided several times, the last set value is used.
Example:
.nf
curl \-\-service\-name sockd/server https://example.com
.fi
See also \fI\-\-negotiate\fP and \fI\-\-proxy\-service\-name\fP.
.IP "\-S, \-\-show\-error"
When used with \fI\-s, \-\-silent\fP, it makes curl show an error message if it fails.
This option is global and does not need to be specified for each use of --next.
Providing \fI\-S, \-\-show\-error\fP multiple times has no extra effect.
Disable it again with \-\-no\-show\-error.
Example:
.nf
curl \-\-show\-error \-\-silent https://example.com
.fi
See also \fI\-\-no\-progress\-meter\fP.
.IP "\-s, \-\-silent"
Silent or quiet mode. Do not show progress meter or error messages. Makes Curl
mute. It still outputs the data you ask for, potentially even to the
terminal/stdout unless you redirect it.
Use \fI\-S, \-\-show\-error\fP in addition to this option to disable progress meter but
still show error messages.
Providing \fI\-s, \-\-silent\fP multiple times has no extra effect.
Disable it again with \-\-no\-silent.
Example:
.nf
curl \-s https://example.com
.fi
See also \fI-v, \-\-verbose\fP, \fI\-\-stderr\fP and \fI\-\-no\-progress\-meter\fP.
.IP "\-\-socks4 <host[:port]>"
Use the specified SOCKS4 proxy. If the port number is not specified, it is
assumed at port 1080. Using this socket type make curl resolve the host name
and passing the address on to the proxy.
To specify proxy on a unix domain socket, use localhost for host, e.g.
socks4://localhost/path/to/socket.sock
This option overrides any previous use of \fI\-x, \-\-proxy\fP, as they are mutually
exclusive.
This option is superfluous since you can specify a socks4 proxy with \fI\-x, \-\-proxy\fP
using a socks4:// protocol prefix.
\fI\-\-preproxy\fP can be used to specify a SOCKS proxy at the same time proxy is used
with an HTTP/HTTPS proxy (added in 7.52.0). In such a case, curl first
connects to the SOCKS proxy and then connects (through SOCKS) to the HTTP or
HTTPS proxy.
If \fI\-\-socks4\fP is provided several times, the last set value is used.
Example:
.nf
curl \-\-socks4 hostname:4096 https://example.com
.fi
See also \fI\-\-socks4a\fP, \fI\-\-socks5\fP and \fI\-\-socks5\-hostname\fP.
.IP "\-\-socks4a <host[:port]>"
Use the specified SOCKS4a proxy. If the port number is not specified, it is
assumed at port 1080. This asks the proxy to resolve the host name.
To specify proxy on a unix domain socket, use localhost for host, e.g.
socks4a://localhost/path/to/socket.sock
This option overrides any previous use of \fI\-x, \-\-proxy\fP, as they are mutually
exclusive.
This option is superfluous since you can specify a socks4a proxy with \fI\-x, \-\-proxy\fP
using a socks4a:// protocol prefix.
\fI\-\-preproxy\fP can be used to specify a SOCKS proxy at the same time \fI\-x, \-\-proxy\fP is
used with an HTTP/HTTPS proxy (added in 7.52.0). In such a case, curl first
connects to the SOCKS proxy and then connects (through SOCKS) to the HTTP or
HTTPS proxy.
If \fI\-\-socks4a\fP is provided several times, the last set value is used.
Example:
.nf
curl \-\-socks4a hostname:4096 https://example.com
.fi
See also \fI\-\-socks4\fP, \fI\-\-socks5\fP and \fI\-\-socks5\-hostname\fP.
.IP "\-\-socks5\-basic"
Tells curl to use username/password authentication when connecting to a SOCKS5
proxy. The username/password authentication is enabled by default. Use
\fI\-\-socks5\-gssapi\fP to force GSS\-API authentication to SOCKS5 proxies.
Providing \fI\-\-socks5\-basic\fP multiple times has no extra effect.
Example:
.nf
curl \-\-socks5\-basic \-\-socks5 hostname:4096 https://example.com
.fi
See also \fI\-\-socks5\fP. Added in 7.55.0.
.IP "\-\-socks5\-gssapi\-nec"
As part of the GSS\-API negotiation a protection mode is negotiated. RFC 1961
says in section 4.3/4.4 it should be protected, but the NEC reference
implementation does not. The option \fI\-\-socks5\-gssapi\-nec\fP allows the
unprotected exchange of the protection mode negotiation.
Providing \fI\-\-socks5\-gssapi\-nec\fP multiple times has no extra effect.
Disable it again with \-\-no\-socks5\-gssapi\-nec.
Example:
.nf
curl \-\-socks5\-gssapi\-nec \-\-socks5 hostname:4096 https://example.com
.fi
See also \fI\-\-socks5\fP.
.IP "\-\-socks5\-gssapi\-service <name>"
The default service name for a socks server is \fBrcmd/server\-fqdn\fP. This option
allows you to change it.
If \fI\-\-socks5\-gssapi\-service\fP is provided several times, the last set value is used.
Example:
.nf
curl \-\-socks5\-gssapi\-service sockd \-\-socks5 hostname:4096 https://example.com
.fi
See also \fI\-\-socks5\fP.
.IP "\-\-socks5\-gssapi"
Tells curl to use GSS\-API authentication when connecting to a SOCKS5 proxy.
The GSS\-API authentication is enabled by default (if curl is compiled with
GSS\-API support). Use \fI\-\-socks5\-basic\fP to force username/password authentication
to SOCKS5 proxies.
Providing \fI\-\-socks5\-gssapi\fP multiple times has no extra effect.
Disable it again with \-\-no\-socks5\-gssapi.
Example:
.nf
curl \-\-socks5\-gssapi \-\-socks5 hostname:4096 https://example.com
.fi
See also \fI\-\-socks5\fP. Added in 7.55.0.
.IP "\-\-socks5\-hostname <host[:port]>"
Use the specified SOCKS5 proxy (and let the proxy resolve the host name). If
the port number is not specified, it is assumed at port 1080.
To specify proxy on a unix domain socket, use localhost for host, e.g.
socks5h://localhost/path/to/socket.sock
This option overrides any previous use of \fI\-x, \-\-proxy\fP, as they are mutually
exclusive.
This option is superfluous since you can specify a socks5 hostname proxy with
\fI\-x, \-\-proxy\fP using a socks5h:// protocol prefix.
\fI\-\-preproxy\fP can be used to specify a SOCKS proxy at the same time \fI\-x, \-\-proxy\fP is
used with an HTTP/HTTPS proxy (added in 7.52.0). In such a case, curl first
connects to the SOCKS proxy and then connects (through SOCKS) to the HTTP or
HTTPS proxy.
If \fI\-\-socks5\-hostname\fP is provided several times, the last set value is used.
Example:
.nf
curl \-\-socks5\-hostname proxy.example:7000 https://example.com
.fi
See also \fI\-\-socks5\fP and \fI\-\-socks4a\fP.
.IP "\-\-socks5 <host[:port]>"
Use the specified SOCKS5 proxy \- but resolve the host name locally. If the
port number is not specified, it is assumed at port 1080.
To specify proxy on a unix domain socket, use localhost for host, e.g.
socks5://localhost/path/to/socket.sock
This option overrides any previous use of \fI\-x, \-\-proxy\fP, as they are mutually
exclusive.
This option is superfluous since you can specify a socks5 proxy with \fI\-x, \-\-proxy\fP
using a socks5:// protocol prefix.
\fI\-\-preproxy\fP can be used to specify a SOCKS proxy at the same time \fI\-x, \-\-proxy\fP is
used with an HTTP/HTTPS proxy (added in 7.52.0). In such a case, curl first
connects to the SOCKS proxy and then connects (through SOCKS) to the HTTP or
HTTPS proxy.
This option (as well as \fI\-\-socks4\fP) does not work with IPV6, FTPS or LDAP.
If \fI\-\-socks5\fP is provided several times, the last set value is used.
Example:
.nf
curl \-\-socks5 proxy.example:7000 https://example.com
.fi
See also \fI\-\-socks5\-hostname\fP and \fI\-\-socks4a\fP.
.IP "\-Y, \-\-speed\-limit <speed>"
If a transfer is slower than this given speed (in bytes per second) for
speed\-time seconds it gets aborted. speed\-time is set with \fI\-y, \-\-speed\-time\fP and is
30 if not set.
If \fI\-Y, \-\-speed\-limit\fP is provided several times, the last set value is used.
Example:
.nf
curl \-\-speed\-limit 300 \-\-speed\-time 10 https://example.com
.fi
See also \fI-y, \-\-speed\-time\fP, \fI\-\-limit\-rate\fP and \fI-m, \-\-max\-time\fP.
.IP "\-y, \-\-speed\-time <seconds>"
If a transfer runs slower than speed\-limit bytes per second during a
speed\-time period, the transfer is aborted. If speed\-time is used, the default
speed\-limit is 1 unless set with \fI\-Y, \-\-speed\-limit\fP.
This option controls transfers (in both directions) but does not affect slow
connects etc. If this is a concern for you, try the \fI\-\-connect\-timeout\fP option.
If \fI\-y, \-\-speed\-time\fP is provided several times, the last set value is used.
Example:
.nf
curl \-\-speed\-limit 300 \-\-speed\-time 10 https://example.com
.fi
See also \fI-Y, \-\-speed\-limit\fP and \fI\-\-limit\-rate\fP.
.IP "\-\-ssl\-allow\-beast"
This option tells curl to not work around a security flaw in the SSL3 and
TLS1.0 protocols known as BEAST. If this option is not used, the SSL layer
may use workarounds known to cause interoperability problems with some older
SSL implementations.
\fBWARNING\fP: this option loosens the SSL security, and by using this flag you
ask for exactly that.
Providing \fI\-\-ssl\-allow\-beast\fP multiple times has no extra effect.
Disable it again with \-\-no\-ssl\-allow\-beast.
Example:
.nf
curl \-\-ssl\-allow\-beast https://example.com
.fi
See also \fI\-\-proxy\-ssl\-allow\-beast\fP and \fI-k, \-\-insecure\fP.
.IP "\-\-ssl\-auto\-client\-cert"
(Schannel) Tell libcurl to automatically locate and use a client certificate
for authentication, when requested by the server. Since the server can request
any certificate that supports client authentication in the OS certificate
store it could be a privacy violation and unexpected.
Providing \fI\-\-ssl\-auto\-client\-cert\fP multiple times has no extra effect.
Disable it again with \-\-no\-ssl\-auto\-client\-cert.
Example:
.nf
curl \-\-ssl\-auto\-client\-cert https://example.com
.fi
See also \fI\-\-proxy\-ssl\-auto\-client\-cert\fP. Added in 7.77.0.
.IP "\-\-ssl\-no\-revoke"
(Schannel) This option tells curl to disable certificate revocation checks.
WARNING: this option loosens the SSL security, and by using this flag you ask
for exactly that.
Providing \fI\-\-ssl\-no\-revoke\fP multiple times has no extra effect.
Disable it again with \-\-no\-ssl\-no\-revoke.
Example:
.nf
curl \-\-ssl\-no\-revoke https://example.com
.fi
See also \fI\-\-crlfile\fP.
.IP "\-\-ssl\-reqd"
(FTP IMAP POP3 SMTP LDAP) Require SSL/TLS for the connection. Terminates the connection if the transfer
cannot be upgraded to use SSL/TLS.
This option is handled in LDAP (added in 7.81.0). It is fully supported by the
OpenLDAP backend and rejected by the generic ldap backend if explicit TLS is
required.
This option is unnecessary if you use a URL scheme that in itself implies
immediate and implicit use of TLS, like for FTPS, IMAPS, POP3S, SMTPS and
LDAPS. Such a transfer always fails if the TLS handshake does not work.
This option was formerly known as \--ftp\-ssl\-reqd.
Providing \fI\-\-ssl\-reqd\fP multiple times has no extra effect.
Disable it again with \-\-no\-ssl\-reqd.
Example:
.nf
curl \-\-ssl\-reqd ftp://example.com
.fi
See also \fI\-\-ssl\fP and \fI-k, \-\-insecure\fP.
.IP "\-\-ssl\-revoke\-best\-effort"
(Schannel) This option tells curl to ignore certificate revocation checks when
they failed due to missing/offline distribution points for the revocation check
lists.
Providing \fI\-\-ssl\-revoke\-best\-effort\fP multiple times has no extra effect.
Disable it again with \-\-no\-ssl\-revoke\-best\-effort.
Example:
.nf
curl \-\-ssl\-revoke\-best\-effort https://example.com
.fi
See also \fI\-\-crlfile\fP and \fI-k, \-\-insecure\fP. Added in 7.70.0.
.IP "\-\-ssl"
(FTP IMAP POP3 SMTP LDAP) Warning: this is considered an insecure option. Consider using \fI\-\-ssl\-reqd\fP
instead to be sure curl upgrades to a secure connection.
Try to use SSL/TLS for the connection. Reverts to a non\-secure connection if
the server does not support SSL/TLS. See also \fI\-\-ftp\-ssl\-control\fP and \fI\-\-ssl\-reqd\fP
for different levels of encryption required.
This option is handled in LDAP (added in 7.81.0). It is fully supported by the
OpenLDAP backend and ignored by the generic ldap backend.
Please note that a server may close the connection if the negotiation does
not succeed.
This option was formerly known as \--ftp\-ssl. That option
name can still be used but might be removed in a future version.
Providing \fI\-\-ssl\fP multiple times has no extra effect.
Disable it again with \-\-no\-ssl.
Example:
.nf
curl \-\-ssl pop3://example.com/
.fi
See also \fI\-\-ssl\-reqd\fP, \fI-k, \-\-insecure\fP and \fI\-\-ciphers\fP.
.IP "\-2, \-\-sslv2"
(SSL) This option previously asked curl to use SSLv2, but is now ignored
(added in 7.77.0). SSLv2 is widely considered insecure (see RFC 6176).
Providing \fI\-2, \-\-sslv2\fP multiple times has no extra effect.
Example:
.nf
curl \-\-sslv2 https://example.com
.fi
See also \fI\-\-http1.1\fP and \fI\-\-http2\fP. \fI-2, \-\-sslv2\fP requires that the underlying libcurl was built to support TLS. This option is mutually exclusive to \fI-3, \-\-sslv3\fP and \fI-1, \-\-tlsv1\fP and \fI\-\-tlsv1.1\fP and \fI\-\-tlsv1.2\fP.
.IP "\-3, \-\-sslv3"
(SSL) This option previously asked curl to use SSLv3, but is now ignored
(added in 7.77.0). SSLv3 is widely considered insecure (see RFC 7568).
Providing \fI\-3, \-\-sslv3\fP multiple times has no extra effect.
Example:
.nf
curl \-\-sslv3 https://example.com
.fi
See also \fI\-\-http1.1\fP and \fI\-\-http2\fP. \fI-3, \-\-sslv3\fP requires that the underlying libcurl was built to support TLS. This option is mutually exclusive to \fI-2, \-\-sslv2\fP and \fI-1, \-\-tlsv1\fP and \fI\-\-tlsv1.1\fP and \fI\-\-tlsv1.2\fP.
.IP "\-\-stderr <file>"
Redirect all writes to stderr to the specified file instead. If the file name
is a plain \(aq\-\(aq, it is instead written to stdout.
This option is global and does not need to be specified for each use of --next.
If \fI\-\-stderr\fP is provided several times, the last set value is used.
Example:
.nf
curl \-\-stderr output.txt https://example.com
.fi
See also \fI-v, \-\-verbose\fP and \fI-s, \-\-silent\fP.
.IP "\-\-styled\-output"
Enables the automatic use of bold font styles when writing HTTP headers to the
terminal. Use \--no\-styled\-output to switch them off.
Styled output requires a terminal that supports bold fonts. This feature is
not present on curl for Windows due to lack of this capability.
This option is global and does not need to be specified for each use of --next.
Providing \fI\-\-styled\-output\fP multiple times has no extra effect.
Disable it again with \-\-no\-styled\-output.
Example:
.nf
curl \-\-styled\-output \-I https://example.com
.fi
See also \fI-I, \-\-head\fP and \fI-v, \-\-verbose\fP. Added in 7.61.0.
.IP "\-\-suppress\-connect\-headers"
When \fI\-p, \-\-proxytunnel\fP is used and a CONNECT request is made do not output proxy
CONNECT response headers. This option is meant to be used with \fI\-D, \-\-dump\-header\fP or
\fI\-i, \-\-include\fP which are used to show protocol headers in the output. It has no
effect on debug options such as \fI\-v, \-\-verbose\fP or \fI\-\-trace\fP, or any statistics.
Providing \fI\-\-suppress\-connect\-headers\fP multiple times has no extra effect.
Disable it again with \-\-no\-suppress\-connect\-headers.
Example:
.nf
curl \-\-suppress\-connect\-headers \-\-include \-x proxy https://example.com
.fi
See also \fI-D, \-\-dump\-header\fP, \fI-i, \-\-include\fP and \fI-p, \-\-proxytunnel\fP. Added in 7.54.0.
.IP "\-\-tcp\-fastopen"
Enable use of TCP Fast Open (RFC 7413). TCP Fast Open is a TCP extension that
allows data to get sent earlier over the connection (before the final
handshake ACK) if the client and server have been connected previously.
Providing \fI\-\-tcp\-fastopen\fP multiple times has no extra effect.
Disable it again with \-\-no\-tcp\-fastopen.
Example:
.nf
curl \-\-tcp\-fastopen https://example.com
.fi
See also \fI\-\-false\-start\fP.
.IP "\-\-tcp\-nodelay"
Turn on the TCP_NODELAY option. See the \fIcurl_easy_setopt(3)\fP man page for
details about this option.
curl sets this option by default and you need to explicitly switch it off if
you do not want it on (added in 7.50.2).
Providing \fI\-\-tcp\-nodelay\fP multiple times has no extra effect.
Disable it again with \-\-no\-tcp\-nodelay.
Example:
.nf
curl \-\-tcp\-nodelay https://example.com
.fi
See also \fI-N, \-\-no\-buffer\fP.
.IP "\-t, \-\-telnet\-option <opt=val>"
Pass options to the telnet protocol. Supported options are:
.RS
.TP 15
\fBTTYPE\fP=<term> Sets the terminal type.
.TP
\fBXDISPLOC\fP=<X display> Sets the X display location.
.TP
\fBNEW_ENV\fP=<var,val> Sets an environment variable.
.RE
.IP
\fI\-t, \-\-telnet\-option\fP can be used several times in a command line
Example:
.nf
curl \-t TTYPE=vt100 telnet://example.com/
.fi
See also \fI-K, \-\-config\fP.
.IP "\-\-tftp\-blksize <value>"
(TFTP) Set the TFTP \fBBLKSIZE\fP option (must be >512). This is the block size that
curl tries to use when transferring data to or from a TFTP server. By
default 512 bytes are used.
If \fI\-\-tftp\-blksize\fP is provided several times, the last set value is used.
Example:
.nf
curl \-\-tftp\-blksize 1024 tftp://example.com/file
.fi
See also \fI\-\-tftp\-no\-options\fP.
.IP "\-\-tftp\-no\-options"
(TFTP) Tells curl not to send TFTP options requests.
This option improves interop with some legacy servers that do not acknowledge
or properly implement TFTP options. When this option is used \fI\-\-tftp\-blksize\fP is
ignored.
Providing \fI\-\-tftp\-no\-options\fP multiple times has no extra effect.
Disable it again with \-\-no\-tftp\-no\-options.
Example:
.nf
curl \-\-tftp\-no\-options tftp://192.168.0.1/
.fi
See also \fI\-\-tftp\-blksize\fP.
.IP "\-z, \-\-time\-cond <time>"
(HTTP FTP) Request a file that has been modified later than the given time and date, or
one that has been modified before that time. The <date expression> can be all
sorts of date strings or if it does not match any internal ones, it is taken as
a filename and tries to get the modification date (mtime) from <file>
instead. See the \fIcurl_getdate(3)\fP man pages for date expression details.
Start the date expression with a dash (\-) to make it request for a document
that is older than the given date/time, default is a document that is newer
than the specified date/time.
If provided a non\-existing file, curl outputs a warning about that fact and
proceeds to do the transfer without a time condition.
If \fI\-z, \-\-time\-cond\fP is provided several times, the last set value is used.
Examples:
.nf
curl \-z "Wed 01 Sep 2021 12:18:00" https://example.com
curl \-z "\-Wed 01 Sep 2021 12:18:00" https://example.com
curl \-z file https://example.com
.fi
See also \fI\-\-etag\-compare\fP and \fI-R, \-\-remote\-time\fP.
.IP "\-\-tls\-max <VERSION>"
(TLS) VERSION defines maximum supported TLS version. The minimum acceptable version
is set by tlsv1.0, tlsv1.1, tlsv1.2 or tlsv1.3.
If the connection is done without TLS, this option has no effect. This
includes QUIC\-using (HTTP/3) transfers.
.RS
.IP "default"
Use up to recommended TLS version.
.IP "1.0"
Use up to TLSv1.0.
.IP "1.1"
Use up to TLSv1.1.
.IP "1.2"
Use up to TLSv1.2.
.IP "1.3"
Use up to TLSv1.3.
.RE
.IP
If \fI\-\-tls\-max\fP is provided several times, the last set value is used.
Examples:
.nf
curl \-\-tls\-max 1.2 https://example.com
curl \-\-tls\-max 1.3 \-\-tlsv1.2 https://example.com
.fi
See also \fI\-\-tlsv1.0\fP, \fI\-\-tlsv1.1\fP, \fI\-\-tlsv1.2\fP and \fI\-\-tlsv1.3\fP. \fI\-\-tls\-max\fP requires that the underlying libcurl was built to support TLS. Added in 7.54.0.
.IP "\-\-tls13\-ciphers <ciphersuite list>"
(TLS) Specifies which cipher suites to use in the connection if it negotiates TLS
1.3. The list of ciphers suites must specify valid ciphers. Read up on TLS 1.3
cipher suite details on this URL:
https://curl.se/docs/ssl\-ciphers.html
This option is currently used only when curl is built to use OpenSSL 1.1.1 or
later, or Schannel. If you are using a different SSL backend you can try
setting TLS 1.3 cipher suites by using the \fI\-\-ciphers\fP option.
If \fI\-\-tls13\-ciphers\fP is provided several times, the last set value is used.
Example:
.nf
curl \-\-tls13\-ciphers TLS_AES_128_GCM_SHA256 https://example.com
.fi
See also \fI\-\-ciphers\fP, \fI\-\-curves\fP and \fI\-\-proxy\-tls13\-ciphers\fP. Added in 7.61.0.
.IP "\-\-tlsauthtype <type>"
Set TLS authentication type. Currently, the only supported option is "SRP",
for TLS\-SRP (RFC 5054). If \fI\-\-tlsuser\fP and \fI\-\-tlspassword\fP are specified but
\fI\-\-tlsauthtype\fP is not, then this option defaults to "SRP". This option works
only if the underlying libcurl is built with TLS\-SRP support, which requires
OpenSSL or GnuTLS with TLS\-SRP support.
If \fI\-\-tlsauthtype\fP is provided several times, the last set value is used.
Example:
.nf
curl \-\-tlsauthtype SRP https://example.com
.fi
See also \fI\-\-tlsuser\fP.
.IP "\-\-tlspassword <string>"
Set password for use with the TLS authentication method specified with
\fI\-\-tlsauthtype\fP. Requires that \fI\-\-tlsuser\fP also be set.
This option does not work with TLS 1.3.
If \fI\-\-tlspassword\fP is provided several times, the last set value is used.
Example:
.nf
curl \-\-tlspassword pwd \-\-tlsuser user https://example.com
.fi
See also \fI\-\-tlsuser\fP.
.IP "\-\-tlsuser <name>"
Set username for use with the TLS authentication method specified with
\fI\-\-tlsauthtype\fP. Requires that \fI\-\-tlspassword\fP also is set.
This option does not work with TLS 1.3.
If \fI\-\-tlsuser\fP is provided several times, the last set value is used.
Example:
.nf
curl \-\-tlspassword pwd \-\-tlsuser user https://example.com
.fi
See also \fI\-\-tlspassword\fP.
.IP "\-\-tlsv1.0"
(TLS) Forces curl to use TLS version 1.0 or later when connecting to a remote TLS server.
In old versions of curl this option was documented to allow _only_ TLS 1.0.
That behavior was inconsistent depending on the TLS library. Use \fI\-\-tls\-max\fP if
you want to set a maximum TLS version.
Providing \fI\-\-tlsv1.0\fP multiple times has no extra effect.
Example:
.nf
curl \-\-tlsv1.0 https://example.com
.fi
See also \fI\-\-tlsv1.3\fP.
.IP "\-\-tlsv1.1"
(TLS) Forces curl to use TLS version 1.1 or later when connecting to a remote TLS server.
In old versions of curl this option was documented to allow _only_ TLS 1.1.
That behavior was inconsistent depending on the TLS library. Use \fI\-\-tls\-max\fP if
you want to set a maximum TLS version.
Providing \fI\-\-tlsv1.1\fP multiple times has no extra effect.
Example:
.nf
curl \-\-tlsv1.1 https://example.com
.fi
See also \fI\-\-tlsv1.3\fP and \fI\-\-tls\-max\fP.
.IP "\-\-tlsv1.2"
(TLS) Forces curl to use TLS version 1.2 or later when connecting to a remote TLS server.
In old versions of curl this option was documented to allow _only_ TLS 1.2.
That behavior was inconsistent depending on the TLS library. Use \fI\-\-tls\-max\fP if
you want to set a maximum TLS version.
Providing \fI\-\-tlsv1.2\fP multiple times has no extra effect.
Example:
.nf
curl \-\-tlsv1.2 https://example.com
.fi
See also \fI\-\-tlsv1.3\fP and \fI\-\-tls\-max\fP.
.IP "\-\-tlsv1.3"
(TLS) Forces curl to use TLS version 1.3 or later when connecting to a remote TLS
server.
If the connection is done without TLS, this option has no effect. This
includes QUIC\-using (HTTP/3) transfers.
Note that TLS 1.3 is not supported by all TLS backends.
Providing \fI\-\-tlsv1.3\fP multiple times has no extra effect.
Example:
.nf
curl \-\-tlsv1.3 https://example.com
.fi
See also \fI\-\-tlsv1.2\fP and \fI\-\-tls\-max\fP. Added in 7.52.0.
.IP "\-1, \-\-tlsv1"
(TLS) Tells curl to use at least TLS version 1.x when negotiating with a remote TLS
server. That means TLS version 1.0 or higher
Providing \fI\-1, \-\-tlsv1\fP multiple times has no extra effect.
Example:
.nf
curl \-\-tlsv1 https://example.com
.fi
See also \fI\-\-http1.1\fP and \fI\-\-http2\fP. \fI-1, \-\-tlsv1\fP requires that the underlying libcurl was built to support TLS. This option is mutually exclusive to \fI\-\-tlsv1.1\fP and \fI\-\-tlsv1.2\fP and \fI\-\-tlsv1.3\fP.
.IP "\-\-tr\-encoding"
(HTTP) Request a compressed Transfer\-Encoding response using one of the algorithms
curl supports, and uncompress the data while receiving it.
Providing \fI\-\-tr\-encoding\fP multiple times has no extra effect.
Disable it again with \-\-no\-tr\-encoding.
Example:
.nf
curl \-\-tr\-encoding https://example.com
.fi
See also \fI\-\-compressed\fP.
.IP "\-\-trace\-ascii <file>"
Enables a full trace dump of all incoming and outgoing data, including
descriptive information, to the given output file. Use "\-" as filename to have
the output sent to stdout.
This is similar to \fI\-\-trace\fP, but leaves out the hex part and only shows the
ASCII part of the dump. It makes smaller output that might be easier to read
for untrained humans.
Note that verbose output of curl activities and network traffic might contain
sensitive data, including user names, credentials or secret data content. Be
aware and be careful when sharing trace logs with others.
This option is global and does not need to be specified for each use of --next.
If \fI\-\-trace\-ascii\fP is provided several times, the last set value is used.
Example:
.nf
curl \-\-trace\-ascii log.txt https://example.com
.fi
See also \fI-v, \-\-verbose\fP and \fI\-\-trace\fP. This option is mutually exclusive to \fI\-\-trace\fP and \fI-v, \-\-verbose\fP.
.IP "\-\-trace\-config <string>"
Set configuration for trace output. A comma\-separated list of components where
detailed output can be made available from. Names are case\-insensitive.
Specify \(aqall\(aq to enable all trace components.
In addition to trace component names, specify "ids" and "time" to
avoid extra \fI\-\-trace\-ids\fP or \fI\-\-trace\-time\fP parameters.
See the \fIcurl_global_trace(3)\fP man page for more details.
This option is global and does not need to be specified for each use of --next.
\fI\-\-trace\-config\fP can be used several times in a command line
Example:
.nf
curl \-\-trace\-config ids,http/2 https://example.com
.fi
See also \fI-v, \-\-verbose\fP and \fI\-\-trace\fP. This option is mutually exclusive to \fI\-\-trace\fP and \fI-v, \-\-verbose\fP. Added in 8.3.0.
.IP "\-\-trace\-ids"
Prepends the transfer and connection identifiers to each trace or verbose line that curl displays.
This option is global and does not need to be specified for each use of --next.
Providing \fI\-\-trace\-ids\fP multiple times has no extra effect.
Disable it again with \-\-no\-trace\-ids.
Example:
.nf
curl \-\-trace\-ids \-\-trace\-ascii output https://example.com
.fi
See also \fI\-\-trace\fP and \fI-v, \-\-verbose\fP. Added in 8.2.0.
.IP "\-\-trace\-time"
Prepends a time stamp to each trace or verbose line that curl displays.
This option is global and does not need to be specified for each use of --next.
Providing \fI\-\-trace\-time\fP multiple times has no extra effect.
Disable it again with \-\-no\-trace\-time.
Example:
.nf
curl \-\-trace\-time \-\-trace\-ascii output https://example.com
.fi
See also \fI\-\-trace\fP and \fI-v, \-\-verbose\fP.
.IP "\-\-trace <file>"
Enables a full trace dump of all incoming and outgoing data, including
descriptive information, to the given output file. Use "\-" as filename to have
the output sent to stdout. Use "%" as filename to have the output sent to
stderr.
Note that verbose output of curl activities and network traffic might contain
sensitive data, including user names, credentials or secret data content. Be
aware and be careful when sharing trace logs with others.
This option is global and does not need to be specified for each use of --next.
If \fI\-\-trace\fP is provided several times, the last set value is used.
Example:
.nf
curl \-\-trace log.txt https://example.com
.fi
See also \fI\-\-trace\-ascii\fP, \fI\-\-trace\-config\fP, \fI\-\-trace\-ids\fP and \fI\-\-trace\-time\fP. This option is mutually exclusive to \fI-v, \-\-verbose\fP and \fI\-\-trace\-ascii\fP.
.IP "\-\-unix\-socket <path>"
(HTTP) Connect through this Unix domain socket, instead of using the network.
If \fI\-\-unix\-socket\fP is provided several times, the last set value is used.
Example:
.nf
curl \-\-unix\-socket socket\-path https://example.com
.fi
See also \fI\-\-abstract\-unix\-socket\fP.
.IP "\-T, \-\-upload\-file <file>"
This transfers the specified local file to the remote URL.
If there is no file part in the specified URL, curl appends the local file
name to the end of the URL before the operation starts. You must use a
trailing slash (/) on the last directory to prove to curl that there is no
file name or curl thinks that your last directory name is the remote file name
to use.
When putting the local file name at the end of the URL, curl ignores what is
on the left side of any slash (/) or backslash (\\) used in the file name and
only appends what is on the right side of the rightmost such character.
Use the file name "\-" (a single dash) to use stdin instead of a given file.
Alternately, the file name "." (a single period) may be specified instead of
\(dq\-" to use stdin in non\-blocking mode to allow reading server output while
stdin is being uploaded.
If this option is used with a HTTP(S) URL, the PUT method is used.
You can specify one \fI\-T, \-\-upload\-file\fP for each URL on the command line. Each
\fI\-T, \-\-upload\-file\fP + URL pair specifies what to upload and to where. curl also
supports "globbing" of the \fI\-T, \-\-upload\-file\fP argument, meaning that you can upload
multiple files to a single URL by using the same URL globbing style supported
in the URL.
When uploading to an SMTP server: the uploaded data is assumed to be RFC 5322
formatted. It has to feature the necessary set of headers and mail body
formatted correctly by the user as curl does not transcode nor encode it
further in any way.
\fI\-T, \-\-upload\-file\fP can be used several times in a command line
Examples:
.nf
curl \-T file https://example.com
curl \-T "img[1\-1000].png" ftp://ftp.example.com/
curl \-\-upload\-file "{file1,file2}" https://example.com
.fi
See also \fI-G, \-\-get\fP, \fI-I, \-\-head\fP, \fI-X, \-\-request\fP and \fI-d, \-\-data\fP.
.IP "\-\-url\-query <data>"
(all) This option adds a piece of data, usually a name + value pair, to the end of
the URL query part. The syntax is identical to that used for \fI\-\-data\-urlencode\fP
with one extension:
If the argument starts with a \(aq+\(aq (plus), the rest of the string is provided
as\-is unencoded.
The query part of a URL is the one following the question mark on the right
end.
\fI\-\-url\-query\fP can be used several times in a command line
Examples:
.nf
curl \-\-url\-query name=val https://example.com
curl \-\-url\-query =encodethis http://example.net/foo
curl \-\-url\-query name@file https://example.com
curl \-\-url\-query @fileonly https://example.com
curl \-\-url\-query "+name=%20foo" https://example.com
.fi
See also \fI\-\-data\-urlencode\fP and \fI-G, \-\-get\fP. Added in 7.87.0.
.IP "\-\-url <url>"
Specify a URL to fetch. This option is mostly handy when you want to specify
URL(s) in a config file.
If the given URL is missing a scheme name (such as "http://" or "ftp://" etc)
then curl makes a guess based on the host. If the outermost subdomain name
matches DICT, FTP, IMAP, LDAP, POP3 or SMTP then that protocol is used,
otherwise HTTP is used. Guessing can be avoided by providing a full URL
including the scheme, or disabled by setting a default protocol (added in
7.45.0), see \fI\-\-proto\-default\fP for details.
To control where this URL is written, use the \fI\-o, \-\-output\fP or the \fI\-O, \-\-remote\-name\fP
options.
\fBWARNING\fP: On Windows, particular file:// accesses can be converted to
network accesses by the operating system. Beware!
\fI\-\-url\fP can be used several times in a command line
Example:
.nf
curl \-\-url https://example.com
.fi
See also \fI-:, \-\-next\fP and \fI-K, \-\-config\fP.
.IP "\-B, \-\-use\-ascii"
(FTP LDAP) Enable ASCII transfer. For FTP, this can also be enforced by using a URL that
ends with ";type=A". This option causes data sent to stdout to be in text mode
for win32 systems.
Providing \fI\-B, \-\-use\-ascii\fP multiple times has no extra effect.
Disable it again with \-\-no\-use\-ascii.
Example:
.nf
curl \-B ftp://example.com/README
.fi
See also \fI\-\-crlf\fP and \fI\-\-data\-ascii\fP.
.IP "\-A, \-\-user\-agent <name>"
(HTTP) Specify the User\-Agent string to send to the HTTP server. To encode blanks in
the string, surround the string with single quote marks. This header can also
be set with the \fI\-H, \-\-header\fP or the \fI\-\-proxy\-header\fP options.
If you give an empty argument to \fI\-A, \-\-user\-agent\fP (""), it removes the header
completely from the request. If you prefer a blank header, you can set it to a
single space (" ").
If \fI\-A, \-\-user\-agent\fP is provided several times, the last set value is used.
Example:
.nf
curl \-A "Agent 007" https://example.com
.fi
See also \fI-H, \-\-header\fP and \fI\-\-proxy\-header\fP.
.IP "\-u, \-\-user <user:password>"
Specify the user name and password to use for server authentication. Overrides
\fI\-n, \-\-netrc\fP and \fI\-\-netrc\-optional\fP.
If you simply specify the user name, curl prompts for a password.
The user name and passwords are split up on the first colon, which makes it
impossible to use a colon in the user name with this option. The password can,
still.
On systems where it works, curl hides the given option argument from process
listings. This is not enough to protect credentials from possibly getting seen
by other users on the same system as they still are visible for a brief moment
before cleared. Such sensitive data should be retrieved from a file instead or
similar and never used in clear text in a command line.
When using Kerberos V5 with a Windows based server you should include the
Windows domain name in the user name, in order for the server to successfully
obtain a Kerberos Ticket. If you do not, then the initial authentication
handshake may fail.
When using NTLM, the user name can be specified simply as the user name,
without the domain, if there is a single domain and forest in your setup
for example.
To specify the domain name use either Down\-Level Logon Name or UPN (User
Principal Name) formats. For example, EXAMPLE\\user and user@example.com
respectively.
If you use a Windows SSPI\-enabled curl binary and perform Kerberos V5,
Negotiate, NTLM or Digest authentication then you can tell curl to select
the user name and password from your environment by specifying a single colon
with this option: "\-u :".
If \fI\-u, \-\-user\fP is provided several times, the last set value is used.
Example:
.nf
curl \-u user:secret https://example.com
.fi
See also \fI-n, \-\-netrc\fP and \fI-K, \-\-config\fP.
.IP "\-\-variable <[%]name=text/@file>"
Set a variable with "name=content" or "name@file" (where "file" can be stdin
if set to a single dash (\-)). The name is a case sensitive identifier that
must consist of no other letters than a\-z, A\-Z, 0\-9 or underscore. The
specified content is then associated with this identifier.
Setting the same variable name again overwrites the old contents with the new.
The contents of a variable can be referenced in a later command line option
when that option name is prefixed with "\--expand\-", and the name is used as
\(dq{{name}}" (without the quotes).
\fI\-\-variable\fP can import environment variables into the name space. Opt to either
require the environment variable to be set or provide a default value for the
variable in case it is not already set.
\fI\-\-variable\fP %name imports the variable called \(aqname\(aq but exits with an error if
that environment variable is not already set. To provide a default value if
the environment variable is not set, use \fI\-\-variable\fP %name=content or
\fI\-\-variable\fP %name@content. Note that on some systems \- but not all \-
environment variables are case insensitive.
When expanding variables, curl supports a set of functions that can make the
variable contents more convenient to use. You apply a function to a variable
expansion by adding a colon and then list the desired functions in a
comma\-separated list that is evaluated in a left\-to\-right order. Variable
content holding null bytes that are not encoded when expanded, causes an
error.
Available functions:
.RS
.TP 15
\fBtrim\fP
removes all leading and trailing white space.
.TP
\fBjson\fP
outputs the content using JSON string quoting rules.
.TP
\fBurl\fP
shows the content URL (percent) encoded.
.TP
\fBb64\fP
expands the variable base64 encoded
.RE
.IP
\fI\-\-variable\fP can be used several times in a command line
Example:
.nf
curl \-\-variable name=smith https://example.com
.fi
See also \fI-K, \-\-config\fP. Added in 8.3.0.
.IP "\-v, \-\-verbose"
Makes curl verbose during the operation. Useful for debugging and seeing
what\(aqs going on "under the hood". A line starting with \(aq>\(aq means "header data"
sent by curl, \(aq<\(aq means "header data" received by curl that is hidden in
normal cases, and a line starting with \(aq*\(aq means additional info provided by
curl.
If you only want HTTP headers in the output, \fI\-i, \-\-include\fP or \fI\-D, \-\-dump\-header\fP might
be more suitable options.
If you think this option still does not give you enough details, consider using
\fI\-\-trace\fP or \fI\-\-trace\-ascii\fP instead.
Note that verbose output of curl activities and network traffic might contain
sensitive data, including user names, credentials or secret data content. Be
aware and be careful when sharing trace logs with others.
This option is global and does not need to be specified for each use of --next.
Providing \fI\-v, \-\-verbose\fP multiple times has no extra effect.
Disable it again with \-\-no\-verbose.
Example:
.nf
curl \-\-verbose https://example.com
.fi
See also \fI-i, \-\-include\fP, \fI-s, \-\-silent\fP, \fI\-\-trace\fP and \fI\-\-trace\-ascii\fP. This option is mutually exclusive to \fI\-\-trace\fP and \fI\-\-trace\-ascii\fP.
.IP "\-V, \-\-version"
Displays information about curl and the libcurl version it uses.
The first line includes the full version of curl, libcurl and other 3rd party
libraries linked with the executable.
The second line (starts with "Release\-Date:") shows the release date.
The third line (starts with "Protocols:") shows all protocols that libcurl
reports to support.
The fourth line (starts with "Features:") shows specific features libcurl
reports to offer. Available features include:
.RS
.IP "alt\-svc"
Support for the Alt\-Svc: header is provided.
.IP "AsynchDNS"
This curl uses asynchronous name resolves. Asynchronous name resolves can be
done using either the c\-ares or the threaded resolver backends.
.IP "brotli"
Support for automatic brotli compression over HTTP(S).
.IP "CharConv"
curl was built with support for character set conversions (like EBCDIC)
.IP "Debug"
This curl uses a libcurl built with Debug. This enables more error\-tracking
and memory debugging etc. For curl\-developers only!
.IP "gsasl"
The built\-in SASL authentication includes extensions to support SCRAM because
libcurl was built with libgsasl.
.IP "GSS\-API"
GSS\-API is supported.
.IP "HSTS"
HSTS support is present.
.IP "HTTP2"
HTTP/2 support has been built\-in.
.IP "HTTP3"
HTTP/3 support has been built\-in.
.IP "HTTPS\-proxy"
This curl is built to support HTTPS proxy.
.IP "IDN"
This curl supports IDN \- international domain names.
.IP "IPv6"
You can use IPv6 with this.
.IP "Kerberos"
Kerberos V5 authentication is supported.
.IP "Largefile"
This curl supports transfers of large files, files larger than 2GB.
.IP "libz"
Automatic decompression (via gzip, deflate) of compressed files over HTTP is
supported.
.IP "MultiSSL"
This curl supports multiple TLS backends.
.IP "NTLM"
NTLM authentication is supported.
.IP "NTLM_WB"
NTLM delegation to winbind helper is supported.
.IP "PSL"
PSL is short for Public Suffix List and means that this curl has been built
with knowledge about "public suffixes".
.IP "SPNEGO"
SPNEGO authentication is supported.
.IP "SSL"
SSL versions of various protocols are supported, such as HTTPS, FTPS, POP3S
and so on.
.IP "SSPI"
SSPI is supported.
.IP "TLS\-SRP"
SRP (Secure Remote Password) authentication is supported for TLS.
.IP "TrackMemory"
Debug memory tracking is supported.
.IP "Unicode"
Unicode support on Windows.
.IP "UnixSockets"
Unix sockets support is provided.
.IP "zstd"
Automatic decompression (via zstd) of compressed files over HTTP is supported.
.RE
.IP
Example:
.nf
curl \-\-version
.fi
See also \fI-h, \-\-help\fP and \fI-M, \-\-manual\fP.
.IP "\-w, \-\-write\-out <format>"
Make curl display information on stdout after a completed transfer. The format
is a string that may contain plain text mixed with any number of
variables. The format can be specified as a literal "string", or you can have
curl read the format from a file with "@filename" and to tell curl to read the
format from stdin you write "@\-".
The variables present in the output format are substituted by the value or
text that curl thinks fit, as described below. All variables are specified as
%{variable_name} and to output a normal % you just write them as %%. You can
output a newline by using \\n, a carriage return with \\r and a tab space with
\\t.
The output is by default written to standard output, but can be changed with
%{stderr} and %output{}.
Output HTTP headers from the most recent request by using \fI%header{name}\fP
where \fIname\fP is the case insensitive name of the header (without the trailing
colon). The header contents are exactly as sent over the network, with leading
and trailing whitespace trimmed (added in 7.84.0).
Select a specific target destination file to write the output to, by using
\fI%output{name}\fP (added in curl 8.3.0) where \fIname\fP is the full file name. The
output following that instruction is then written to that file. More than one
\fI%output{}\fP instruction can be specified in the same write\-out argument. If
the file name cannot be created, curl leaves the output destination to the one
used prior to the \fI%output{}\fP instruction. Use \fI%output{>>name}\fP to append
data to an existing file.
\fBNOTE:\fP
In Windows the %\-symbol is a special symbol used to expand environment
variables. In batch files all occurrences of % must be doubled when using this
option to properly escape. If this option is used at the command prompt then
the % cannot be escaped and unintended expansion is possible.
The variables available are:
.RS
.TP 15
\fBcerts\fP
Output the certificate chain with details. Supported only by the OpenSSL,
GnuTLS, Schannel and Secure Transport backends. (Added in 7.88.0)
.TP
\fBcontent_type\fP
The Content\-Type of the requested document, if there was any.
.TP
\fBerrormsg\fP
The error message. (Added in 7.75.0)
.TP
\fBexitcode\fP
The numerical exit code of the transfer. (Added in 7.75.0)
.TP
\fBfilename_effective\fP
The ultimate filename that curl writes out to. This is only meaningful if curl
is told to write to a file with the \fI\-O, \-\-remote\-name\fP or \fI\-o, \-\-output\fP
option. It\(aqs most useful in combination with the \fI\-J, \-\-remote\-header\-name\fP
option.
.TP
\fBftp_entry_path\fP
The initial path curl ended up in when logging on to the remote FTP
server.
.TP
\fBheader_json\fP
A JSON object with all HTTP response headers from the recent transfer. Values
are provided as arrays, since in the case of multiple headers there can be
multiple values. (Added in 7.83.0)
The header names provided in lowercase, listed in order of appearance over the
wire. Except for duplicated headers. They are grouped on the first occurrence
of that header, each value is presented in the JSON array.
.TP
\fBhttp_code\fP
The numerical response code that was found in the last retrieved HTTP(S) or
FTP(s) transfer.
.TP
\fBhttp_connect\fP
The numerical code that was found in the last response (from a proxy) to a
curl CONNECT request.
.TP
\fBhttp_version\fP
The http version that was effectively used. (Added in 7.50.0)
.TP
\fBjson\fP
A JSON object with all available keys.
.TP
\fBlocal_ip\fP
The IP address of the local end of the most recently done connection \- can be
either IPv4 or IPv6.
.TP
\fBlocal_port\fP
The local port number of the most recently done connection.
.TP
\fBmethod\fP
The http method used in the most recent HTTP request. (Added in 7.72.0)
.TP
\fBnum_certs\fP
Number of server certificates received in the TLS handshake. Supported only by
the OpenSSL, GnuTLS, Schannel and Secure Transport backends.
(Added in 7.88.0)
.TP
\fBnum_connects\fP
Number of new connects made in the recent transfer.
.TP
\fBnum_headers\fP
The number of response headers in the most recent request (restarted at each
redirect). Note that the status line IS NOT a header. (Added in 7.73.0)
.TP
\fBnum_redirects\fP
Number of redirects that were followed in the request.
.TP
\fBonerror\fP
The rest of the output is only shown if the transfer returned a non\-zero error.
(Added in 7.75.0)
.TP
\fBproxy_ssl_verify_result\fP
The result of the HTTPS proxy\(aqs SSL peer certificate verification that was
requested. 0 means the verification was successful. (Added in 7.52.0)
.TP
\fBredirect_url\fP
When an HTTP request was made without \fI\-L, \-\-location\fP to follow redirects (or when
\fI\-\-max\-redirs\fP is met), this variable shows the actual URL a redirect
\fIwould\fP have gone to.
.TP
\fBreferer\fP
The Referer: header, if there was any. (Added in 7.76.0)
.TP
\fBremote_ip\fP
The remote IP address of the most recently done connection \- can be either
IPv4 or IPv6.
.TP
\fBremote_port\fP
The remote port number of the most recently done connection.
.TP
\fBresponse_code\fP
The numerical response code that was found in the last transfer (formerly
known as "http_code").
.TP
\fBscheme\fP
The URL scheme (sometimes called protocol) that was effectively used. (Added in 7.52.0)
.TP
\fBsize_download\fP
The total amount of bytes that were downloaded. This is the size of the
body/data that was transferred, excluding headers.
.TP
\fBsize_header\fP
The total amount of bytes of the downloaded headers.
.TP
\fBsize_request\fP
The total amount of bytes that were sent in the HTTP request.
.TP
\fBsize_upload\fP
The total amount of bytes that were uploaded. This is the size of the
body/data that was transferred, excluding headers.
.TP
\fBspeed_download\fP
The average download speed that curl measured for the complete download. Bytes
per second.
.TP
\fBspeed_upload\fP
The average upload speed that curl measured for the complete upload. Bytes per
second.
.TP
\fBssl_verify_result\fP
The result of the SSL peer certificate verification that was requested. 0
means the verification was successful.
.TP
\fBstderr\fP
From this point on, the \fI\-w, \-\-write\-out\fP output is written to standard
error. (Added in 7.63.0)
.TP
\fBstdout\fP
From this point on, the \fI\-w, \-\-write\-out\fP output is written to standard output.
This is the default, but can be used to switch back after switching to stderr.
(Added in 7.63.0)
.TP
\fBtime_appconnect\fP
The time, in seconds, it took from the start until the SSL/SSH/etc
connect/handshake to the remote host was completed.
.TP
\fBtime_connect\fP
The time, in seconds, it took from the start until the TCP connect to the
remote host (or proxy) was completed.
.TP
\fBtime_namelookup\fP
The time, in seconds, it took from the start until the name resolving was
completed.
.TP
\fBtime_pretransfer\fP
The time, in seconds, it took from the start until the file transfer was just
about to begin. This includes all pre\-transfer commands and negotiations that
are specific to the particular protocol(s) involved.
.TP
\fBtime_redirect\fP
The time, in seconds, it took for all redirection steps including name lookup,
connect, pretransfer and transfer before the final transaction was
started. time_redirect shows the complete execution time for multiple
redirections.
.TP
\fBtime_starttransfer\fP
The time, in seconds, it took from the start until the first byte is received.
This includes time_pretransfer and also the time the server needed to calculate
the result.
.TP
\fBtime_total\fP
The total time, in seconds, that the full operation lasted.
.TP
\fBurl\fP
The URL that was fetched. (Added in 7.75.0)
.TP
\fBurl.scheme\fP
The scheme part of the URL that was fetched. (Added in 8.1.0)
.TP
\fBurl.user\fP
The user part of the URL that was fetched. (Added in 8.1.0)
.TP
\fBurl.password\fP
The password part of the URL that was fetched. (Added in 8.1.0)
.TP
\fBurl.options\fP
The options part of the URL that was fetched. (Added in 8.1.0)
.TP
\fBurl.host\fP
The host part of the URL that was fetched. (Added in 8.1.0)
.TP
\fBurl.port\fP
The port number of the URL that was fetched. If no port number was specified,
but the URL scheme is known, that scheme\(aqs default port number is
shown. (Added in 8.1.0)
.TP
\fBurl.path\fP
The path part of the URL that was fetched. (Added in 8.1.0)
.TP
\fBurl.query\fP
The query part of the URL that was fetched. (Added in 8.1.0)
.TP
\fBurl.fragment\fP
The fragment part of the URL that was fetched. (Added in 8.1.0)
.TP
\fBurl.zoneid\fP
The zone id part of the URL that was fetched. (Added in 8.1.0)
.TP
\fBurle.scheme\fP
The scheme part of the effective (last) URL that was fetched. (Added in 8.1.0)
.TP
\fBurle.user\fP
The user part of the effective (last) URL that was fetched. (Added in 8.1.0)
.TP
\fBurle.password\fP
The password part of the effective (last) URL that was fetched. (Added in 8.1.0)
.TP
\fBurle.options\fP
The options part of the effective (last) URL that was fetched. (Added in 8.1.0)
.TP
\fBurle.host\fP
The host part of the effective (last) URL that was fetched. (Added in 8.1.0)
.TP
\fBurle.port\fP
The port number of the effective (last) URL that was fetched. If no port
number was specified, but the URL scheme is known, that scheme\(aqs default port
number is shown. (Added in 8.1.0)
.TP
\fBurle.path\fP
The path part of the effective (last) URL that was fetched. (Added in 8.1.0)
.TP
\fBurle.query\fP
The query part of the effective (last) URL that was fetched. (Added in 8.1.0)
.TP
\fBurle.fragment\fP
The fragment part of the effective (last) URL that was fetched. (Added in 8.1.0)
.TP
\fBurle.zoneid\fP
The zone id part of the effective (last) URL that was fetched. (Added in 8.1.0)
.TP
\fBurlnum\fP
The URL index number of this transfer, 0\-indexed. Unglobbed URLs share the
same index number as the origin globbed URL. (Added in 7.75.0)
.TP
\fBurl_effective\fP
The URL that was fetched last. This is most meaningful if you have told curl
to follow location: headers.
.RE
.IP
If \fI\-w, \-\-write\-out\fP is provided several times, the last set value is used.
Example:
.nf
curl \-w \(aq%{response_code}\\n\(aq https://example.com
.fi
See also \fI-v, \-\-verbose\fP and \fI-I, \-\-head\fP.
.IP "\-\-xattr"
When saving output to a file, this option tells curl to store certain file
metadata in extended file attributes. Currently, the URL is stored in the
xdg.origin.url attribute and, for HTTP, the content type is stored in
the mime_type attribute. If the file system does not support extended
attributes, a warning is issued.
Providing \fI\-\-xattr\fP multiple times has no extra effect.
Disable it again with \-\-no\-xattr.
Example:
.nf
curl \-\-xattr \-o storage https://example.com
.fi
See also \fI-R, \-\-remote\-time\fP, \fI-w, \-\-write\-out\fP and \fI-v, \-\-verbose\fP.
.SH FILES
.I ~/.curlrc
.RS
Default config file, see \fI\-K, \-\-config\fP for details.
.SH ENVIRONMENT
The environment variables can be specified in lower case or upper case. The
lower case version has precedence. http_proxy is an exception as it is only
available in lower case.
Using an environment variable to set the proxy has the same effect as using
the \fI\-x, \-\-proxy\fP option.
.IP "http_proxy [protocol://]<host>[:port]"
Sets the proxy server to use for HTTP.
.IP "HTTPS_PROXY [protocol://]<host>[:port]"
Sets the proxy server to use for HTTPS.
.IP "[url\-protocol]_PROXY [protocol://]<host>[:port]"
Sets the proxy server to use for [url\-protocol], where the protocol is a
protocol that curl supports and as specified in a URL. FTP, FTPS, POP3, IMAP,
SMTP, LDAP, etc.
.IP "ALL_PROXY [protocol://]<host>[:port]"
Sets the proxy server to use if no protocol\-specific proxy is set.
.IP "NO_PROXY <comma\-separated list of hosts/domains>"
list of host names that should not go through any proxy. If set to an asterisk
\(aq*\(aq only, it matches all hosts. Each name in this list is matched as either
a domain name which contains the hostname, or the hostname itself.
This environment variable disables use of the proxy even when specified with
the \fI\-x, \-\-proxy\fP option. That is
.B NO_PROXY=direct.example.com curl \-x http://proxy.example.com
.B http://direct.example.com
accesses the target URL directly, and
.B NO_PROXY=direct.example.com curl \-x http://proxy.example.com
.B http://somewhere.example.com
accesses the target URL through the proxy.
The list of host names can also be include numerical IP addresses, and IPv6
versions should then be given without enclosing brackets.
IP addresses can be specified using CIDR notation: an appended slash and
number specifies the number of "network bits" out of the address to use in the
comparison (added in 7.86.0). For example "192.168.0.0/16" would match all
addresses starting with "192.168".
.IP "APPDATA <dir>"
On Windows, this variable is used when trying to find the home directory. If
the primary home variable are all unset.
.IP "COLUMNS <terminal width>"
If set, the specified number of characters is used as the terminal width when
the alternative progress\-bar is shown. If not set, curl tries to figure it out
using other ways.
.IP "CURL_CA_BUNDLE <file>"
If set, it is used as the \fI\-\-cacert\fP value.
.IP "CURL_HOME <dir>"
If set, is the first variable curl checks when trying to find its home
directory. If not set, it continues to check \fIXDG_CONFIG_HOME\fP
.IP "CURL_SSL_BACKEND <TLS backend>"
If curl was built with support for "MultiSSL", meaning that it has built\-in
support for more than one TLS backend, this environment variable can be set to
the case insensitive name of the particular backend to use when curl is
invoked. Setting a name that is not a built\-in alternative makes curl stay
with the default.
SSL backend names (case\-insensitive): \fBbearssl\fP, \fBgnutls\fP, \fBmbedtls\fP,
\fBopenssl\fP, \fBrustls\fP, \fBschannel\fP, \fBsecure\-transport\fP, \fBwolfssl\fP
.IP "HOME <dir>"
If set, this is used to find the home directory when that is needed. Like when
looking for the default .curlrc. \fICURL_HOME\fP and \fIXDG_CONFIG_HOME\fP
have preference.
.IP "QLOGDIR <directory name>"
If curl was built with HTTP/3 support, setting this environment variable to a
local directory makes curl produce \fBqlogs\fP in that directory, using file
names named after the destination connection id (in hex). Do note that these
files can become rather large. Works with the ngtcp2 and quiche QUIC backends.
.IP SHELL
Used on VMS when trying to detect if using a \fBDCL\fP or a \fBunix\fP shell.
.IP "SSL_CERT_DIR <dir>"
If set, it is used as the \fI\-\-capath\fP value.
.IP "SSL_CERT_FILE <path>"
If set, it is used as the \fI\-\-cacert\fP value.
.IP "SSLKEYLOGFILE <file name>"
If you set this environment variable to a file name, curl stores TLS secrets
from its connections in that file when invoked to enable you to analyze the
TLS traffic in real time using network analyzing tools such as Wireshark. This
works with the following TLS backends: OpenSSL, libressl, BoringSSL, GnuTLS
and wolfSSL.
.IP "USERPROFILE <dir>"
On Windows, this variable is used when trying to find the home directory. If
the other, primary, variable are all unset. If set, curl uses the path
\fI\fP"$USERPROFILE\\Application Data"\fI\fP.
.IP "XDG_CONFIG_HOME <dir>"
If \fICURL_HOME\fP is not set, this variable is checked when looking for a
default .curlrc file.
.SH "PROXY PROTOCOL PREFIXES"
The proxy string may be specified with a protocol:// prefix to specify
alternative proxy protocols.
If no protocol is specified in the proxy string or if the string does not
match a supported one, the proxy is treated as an HTTP proxy.
The supported proxy protocol prefixes are as follows:
.IP "http://"
Makes it use it as an HTTP proxy. The default if no scheme prefix is used.
.IP "https://"
Makes it treated as an \fBHTTPS\fP proxy.
.IP "socks4://"
Makes it the equivalent of \fI\-\-socks4\fP
.IP "socks4a://"
Makes it the equivalent of \fI\-\-socks4a\fP
.IP "socks5://"
Makes it the equivalent of \fI\-\-socks5\fP
.IP "socks5h://"
Makes it the equivalent of \fI\-\-socks5\-hostname\fP
.SH EXIT CODES
There are a bunch of different error codes and their corresponding error
messages that may appear under error conditions. At the time of this writing,
the exit codes are:
.IP 0
Success. The operation completed successfully according to the instructions.
.IP 1
Unsupported protocol. This build of curl has no support for this protocol.
.IP 2
Failed to initialize.
.IP 3
URL malformed. The syntax was not correct.
.IP 4
A feature or option that was needed to perform the desired request was not
enabled or was explicitly disabled at build\-time. To make curl able to do
this, you probably need another build of libcurl.
.IP 5
Could not resolve proxy. The given proxy host could not be resolved.
.IP 6
Could not resolve host. The given remote host could not be resolved.
.IP 7
Failed to connect to host.
.IP 8
Weird server reply. The server sent data curl could not parse.
.IP 9
FTP access denied. The server denied login or denied access to the particular
resource or directory you wanted to reach. Most often you tried to change to a
directory that does not exist on the server.
.IP 10
FTP accept failed. While waiting for the server to connect back when an active
FTP session is used, an error code was sent over the control connection or
similar.
.IP 11
FTP weird PASS reply. Curl could not parse the reply sent to the PASS request.
.IP 12
During an active FTP session while waiting for the server to connect back to
curl, the timeout expired.
.IP 13
FTP weird PASV reply, Curl could not parse the reply sent to the PASV request.
.IP 14
FTP weird 227 format. Curl could not parse the 227\-line the server sent.
.IP 15
FTP cannot use host. Could not resolve the host IP we got in the 227\-line.
.IP 16
HTTP/2 error. A problem was detected in the HTTP2 framing layer. This is
somewhat generic and can be one out of several problems, see the error message
for details.
.IP 17
FTP could not set binary. Could not change transfer method to binary.
.IP 18
Partial file. Only a part of the file was transferred.
.IP 19
FTP could not download/access the given file, the RETR (or similar) command
failed.
.IP 21
FTP quote error. A quote command returned error from the server.
.IP 22
HTTP page not retrieved. The requested URL was not found or returned another
error with the HTTP error code being 400 or above. This return code only
appears if \fI\-f, \-\-fail\fP is used.
.IP 23
Write error. Curl could not write data to a local filesystem or similar.
.IP 25
FTP could not STOR file. The server denied the STOR operation, used for FTP
uploading.
.IP 26
Read error. Various reading problems.
.IP 27
Out of memory. A memory allocation request failed.
.IP 28
Operation timeout. The specified time\-out period was reached according to the
conditions.
.IP 30
FTP PORT failed. The PORT command failed. Not all FTP servers support the PORT
command, try doing a transfer using PASV instead!
.IP 31
FTP could not use REST. The REST command failed. This command is used for
resumed FTP transfers.
.IP 33
HTTP range error. The range "command" did not work.
.IP 34
HTTP post error. Internal post\-request generation error.
.IP 35
SSL connect error. The SSL handshaking failed.
.IP 36
Bad download resume. Could not continue an earlier aborted download.
.IP 37
FILE could not read file. Failed to open the file. Permissions?
.IP 38
LDAP cannot bind. LDAP bind operation failed.
.IP 39
LDAP search failed.
.IP 41
Function not found. A required LDAP function was not found.
.IP 42
Aborted by callback. An application told curl to abort the operation.
.IP 43
Internal error. A function was called with a bad parameter.
.IP 45
Interface error. A specified outgoing interface could not be used.
.IP 47
Too many redirects. When following redirects, curl hit the maximum amount.
.IP 48
Unknown option specified to libcurl. This indicates that you passed a weird
option to curl that was passed on to libcurl and rejected. Read up in the
manual!
.IP 49
Malformed telnet option.
.IP 52
The server did not reply anything, which here is considered an error.
.IP 53
SSL crypto engine not found.
.IP 54
Cannot set SSL crypto engine as default.
.IP 55
Failed sending network data.
.IP 56
Failure in receiving network data.
.IP 58
Problem with the local certificate.
.IP 59
Could not use specified SSL cipher.
.IP 60
Peer certificate cannot be authenticated with known CA certificates.
.IP 61
Unrecognized transfer encoding.
.IP 63
Maximum file size exceeded.
.IP 64
Requested FTP SSL level failed.
.IP 65
Sending the data requires a rewind that failed.
.IP 66
Failed to initialize SSL Engine.
.IP 67
The user name, password, or similar was not accepted and curl failed to log in.
.IP 68
File not found on TFTP server.
.IP 69
Permission problem on TFTP server.
.IP 70
Out of disk space on TFTP server.
.IP 71
Illegal TFTP operation.
.IP 72
Unknown TFTP transfer ID.
.IP 73
File already exists (TFTP).
.IP 74
No such user (TFTP).
.IP 77
Problem reading the SSL CA cert (path? access rights?).
.IP 78
The resource referenced in the URL does not exist.
.IP 79
An unspecified error occurred during the SSH session.
.IP 80
Failed to shut down the SSL connection.
.IP 82
Could not load CRL file, missing or wrong format.
.IP 83
Issuer check failed.
.IP 84
The FTP PRET command failed.
.IP 85
Mismatch of RTSP CSeq numbers.
.IP 86
Mismatch of RTSP Session Identifiers.
.IP 87
Unable to parse FTP file list.
.IP 88
FTP chunk callback reported error.
.IP 89
No connection available, the session is queued.
.IP 90
SSL public key does not matched pinned public key.
.IP 91
Invalid SSL certificate status.
.IP 92
Stream error in HTTP/2 framing layer.
.IP 93
An API function was called from inside a callback.
.IP 94
An authentication function returned an error.
.IP 95
A problem was detected in the HTTP/3 layer. This is somewhat generic and can
be one out of several problems, see the error message for details.
.IP 96
QUIC connection error. This error may be caused by an SSL library error. QUIC
is the protocol used for HTTP/3 transfers.
.IP 97
Proxy handshake error.
.IP 98
A client\-side certificate is required to complete the TLS handshake.
.IP 99
Poll or select returned fatal error.
.IP XX
More error codes might appear here in future releases. The existing ones are
meant to never change.
.SH BUGS
If you experience any problems with curl, submit an issue in the project\(aqs bug
tracker on GitHub: https://github.com/curl/curl/issues
.SH AUTHORS / CONTRIBUTORS
Daniel Stenberg is the main author, but the whole list of contributors is
found in the separate THANKS file.
.SH WWW
https://curl.se
.SH "SEE ALSO"
.BR ftp (1),
.BR wget (1)
man/man1/curl-config.1 0000644 00000010564 14751172372 0010464 0 ustar 00 .\" **************************************************************************
.\" * _ _ ____ _
.\" * Project ___| | | | _ \| |
.\" * / __| | | | |_) | |
.\" * | (__| |_| | _ <| |___
.\" * \___|\___/|_| \_\_____|
.\" *
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
.\" *
.\" * This software is licensed as described in the file COPYING, which
.\" * you should have received as part of this distribution. The terms
.\" * are also available at https://curl.se/docs/copyright.html.
.\" *
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
.\" * copies of the Software, and permit persons to whom the Software is
.\" * furnished to do so, under the terms of the COPYING file.
.\" *
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
.\" * KIND, either express or implied.
.\" *
.\" * SPDX-License-Identifier: curl
.\" *
.\" **************************************************************************
.\"
.TH curl-config 1 "April 26, 2023" "url-config 8.4.0" curl-config
.SH NAME
curl-config \- Get information about a libcurl installation
.SH SYNOPSIS
.B curl-config [options]
.SH DESCRIPTION
.B curl-config
displays information about the curl and libcurl installation.
.SH OPTIONS
.IP "--ca"
Displays the built-in path to the CA cert bundle this libcurl uses.
.IP "--cc"
Displays the compiler used to build libcurl.
.IP "--cflags"
Set of compiler options (CFLAGS) to use when compiling files that use
libcurl. Currently that is only the include path to the curl include files.
.IP "--checkfor [version]"
Specify the oldest possible libcurl version string you want, and this
script will return 0 if the current installation is new enough or it
returns 1 and outputs a text saying that the current version is not new
enough. (Added in 7.15.4)
.IP "--configure"
Displays the arguments given to configure when building curl.
.IP "--feature"
Lists what particular main features the installed libcurl was built with. At
the time of writing, this list may include SSL, KRB4 or IPv6. Do not assume
any particular order. The keywords will be separated by newlines. There may be
none, one, or several keywords in the list.
.IP "--help"
Displays the available options.
.IP "--libs"
Shows the complete set of libs and other linker options you will need in order
to link your application with libcurl.
.IP "--prefix"
This is the prefix used when libcurl was installed. Libcurl is then installed
in $prefix/lib and its header files are installed in $prefix/include and so
on. The prefix is set with "configure --prefix".
.IP "--protocols"
Lists what particular protocols the installed libcurl was built to support. At
the time of writing, this list may include HTTP, HTTPS, FTP, FTPS, FILE,
TELNET, LDAP, DICT and many more. Do not assume any particular order. The
protocols will be listed using uppercase and are separated by newlines. There
may be none, one, or several protocols in the list. (Added in 7.13.0)
.IP "--ssl-backends"
Lists the SSL backends that were enabled when libcurl was built. It might be
no, one or several names. If more than one name, they will appear
comma-separated. (Added in 7.58.0)
.IP "--static-libs"
Shows the complete set of libs and other linker options you will need in order
to link your application with libcurl statically. (Added in 7.17.1)
.IP "--version"
Outputs version information about the installed libcurl.
.IP "--vernum"
Outputs version information about the installed libcurl, in numerical mode.
This outputs the version number, in hexadecimal, with 8 bits for each part:
major, minor, and patch. So that libcurl 7.7.4 would appear as 070704 and libcurl
12.13.14 would appear as 0c0d0e... Note that the initial zero might be
omitted. (This option was broken in the 7.15.0 release.)
.SH "EXAMPLES"
What linker options do I need when I link with libcurl?
.nf
$ curl-config --libs
.fi
What compiler options do I need when I compile using libcurl functions?
.nf
$ curl-config --cflags
.fi
How do I know if libcurl was built with SSL support?
.nf
$ curl-config --feature | grep SSL
.fi
What's the installed libcurl version?
.nf
$ curl-config --version
.fi
How do I build a single file with a one-line command?
.nf
$ `curl-config --cc --cflags` -o example example.c `curl-config --libs`
.fi
.SH "SEE ALSO"
.BR curl (1)
aclocal/libcurl.m4 0000644 00000025744 14751172372 0010065 0 ustar 00 #***************************************************************************
# _ _ ____ _
# Project ___| | | | _ \| |
# / __| | | | |_) | |
# | (__| |_| | _ <| |___
# \___|\___/|_| \_\_____|
#
# Copyright (C) David Shaw <dshaw@jabberwocky.com>
#
# This software is licensed as described in the file COPYING, which
# you should have received as part of this distribution. The terms
# are also available at https://curl.se/docs/copyright.html.
#
# You may opt to use, copy, modify, merge, publish, distribute and/or sell
# copies of the Software, and permit persons to whom the Software is
# furnished to do so, under the terms of the COPYING file.
#
# This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
# KIND, either express or implied.
#
# SPDX-License-Identifier: curl
#
###########################################################################
# LIBCURL_CHECK_CONFIG ([DEFAULT-ACTION], [MINIMUM-VERSION],
# [ACTION-IF-YES], [ACTION-IF-NO])
# ----------------------------------------------------------
# David Shaw <dshaw@jabberwocky.com> May-09-2006
#
# Checks for libcurl. DEFAULT-ACTION is the string yes or no to
# specify whether to default to --with-libcurl or --without-libcurl.
# If not supplied, DEFAULT-ACTION is yes. MINIMUM-VERSION is the
# minimum version of libcurl to accept. Pass the version as a regular
# version number like 7.10.1. If not supplied, any version is
# accepted. ACTION-IF-YES is a list of shell commands to run if
# libcurl was successfully found and passed the various tests.
# ACTION-IF-NO is a list of shell commands that are run otherwise.
# Note that using --without-libcurl does run ACTION-IF-NO.
#
# This macro #defines HAVE_LIBCURL if a working libcurl setup is
# found, and sets @LIBCURL@ and @LIBCURL_CPPFLAGS@ to the necessary
# values. Other useful defines are LIBCURL_FEATURE_xxx where xxx are
# the various features supported by libcurl, and LIBCURL_PROTOCOL_yyy
# where yyy are the various protocols supported by libcurl. Both xxx
# and yyy are capitalized. See the list of AH_TEMPLATEs at the top of
# the macro for the complete list of possible defines. Shell
# variables $libcurl_feature_xxx and $libcurl_protocol_yyy are also
# defined to 'yes' for those features and protocols that were found.
# Note that xxx and yyy keep the same capitalization as in the
# curl-config list (e.g. it's "HTTP" and not "http").
#
# Users may override the detected values by doing something like:
# LIBCURL="-lcurl" LIBCURL_CPPFLAGS="-I/usr/myinclude" ./configure
#
# For the sake of sanity, this macro assumes that any libcurl that is found is
# after version 7.7.2, the first version that included the curl-config script.
# Note that it is important for people packaging binary versions of libcurl to
# include this script! Without curl-config, we can only guess what protocols
# are available, or use curl_version_info to figure it out at runtime.
AC_DEFUN([LIBCURL_CHECK_CONFIG],
[
AH_TEMPLATE([LIBCURL_FEATURE_SSL],[Defined if libcurl supports SSL])
AH_TEMPLATE([LIBCURL_FEATURE_KRB4],[Defined if libcurl supports KRB4])
AH_TEMPLATE([LIBCURL_FEATURE_IPV6],[Defined if libcurl supports IPv6])
AH_TEMPLATE([LIBCURL_FEATURE_LIBZ],[Defined if libcurl supports libz])
AH_TEMPLATE([LIBCURL_FEATURE_ASYNCHDNS],[Defined if libcurl supports AsynchDNS])
AH_TEMPLATE([LIBCURL_FEATURE_IDN],[Defined if libcurl supports IDN])
AH_TEMPLATE([LIBCURL_FEATURE_SSPI],[Defined if libcurl supports SSPI])
AH_TEMPLATE([LIBCURL_FEATURE_NTLM],[Defined if libcurl supports NTLM])
AH_TEMPLATE([LIBCURL_PROTOCOL_HTTP],[Defined if libcurl supports HTTP])
AH_TEMPLATE([LIBCURL_PROTOCOL_HTTPS],[Defined if libcurl supports HTTPS])
AH_TEMPLATE([LIBCURL_PROTOCOL_FTP],[Defined if libcurl supports FTP])
AH_TEMPLATE([LIBCURL_PROTOCOL_FTPS],[Defined if libcurl supports FTPS])
AH_TEMPLATE([LIBCURL_PROTOCOL_FILE],[Defined if libcurl supports FILE])
AH_TEMPLATE([LIBCURL_PROTOCOL_TELNET],[Defined if libcurl supports TELNET])
AH_TEMPLATE([LIBCURL_PROTOCOL_LDAP],[Defined if libcurl supports LDAP])
AH_TEMPLATE([LIBCURL_PROTOCOL_DICT],[Defined if libcurl supports DICT])
AH_TEMPLATE([LIBCURL_PROTOCOL_TFTP],[Defined if libcurl supports TFTP])
AH_TEMPLATE([LIBCURL_PROTOCOL_RTSP],[Defined if libcurl supports RTSP])
AH_TEMPLATE([LIBCURL_PROTOCOL_POP3],[Defined if libcurl supports POP3])
AH_TEMPLATE([LIBCURL_PROTOCOL_IMAP],[Defined if libcurl supports IMAP])
AH_TEMPLATE([LIBCURL_PROTOCOL_SMTP],[Defined if libcurl supports SMTP])
AC_ARG_WITH(libcurl,
AS_HELP_STRING([--with-libcurl=PREFIX],[look for the curl library in PREFIX/lib and headers in PREFIX/include]),
[_libcurl_with=$withval],[_libcurl_with=ifelse([$1],,[yes],[$1])])
if test "$_libcurl_with" != "no" ; then
AC_PROG_AWK
_libcurl_version_parse="eval $AWK '{split(\$NF,A,\".\"); X=256*256*A[[1]]+256*A[[2]]+A[[3]]; print X;}'"
_libcurl_try_link=yes
if test -d "$_libcurl_with" ; then
LIBCURL_CPPFLAGS="-I$withval/include"
_libcurl_ldflags="-L$withval/lib"
AC_PATH_PROG([_libcurl_config],[curl-config],[],
["$withval/bin"])
else
AC_PATH_PROG([_libcurl_config],[curl-config],[],[$PATH])
fi
if test x$_libcurl_config != "x" ; then
AC_CACHE_CHECK([for the version of libcurl],
[libcurl_cv_lib_curl_version],
[libcurl_cv_lib_curl_version=`$_libcurl_config --version | $AWK '{print $[]2}'`])
_libcurl_version=`echo $libcurl_cv_lib_curl_version | $_libcurl_version_parse`
_libcurl_wanted=`echo ifelse([$2],,[0],[$2]) | $_libcurl_version_parse`
if test $_libcurl_wanted -gt 0 ; then
AC_CACHE_CHECK([for libcurl >= version $2],
[libcurl_cv_lib_version_ok],
[
if test $_libcurl_version -ge $_libcurl_wanted ; then
libcurl_cv_lib_version_ok=yes
else
libcurl_cv_lib_version_ok=no
fi
])
fi
if test $_libcurl_wanted -eq 0 || test x$libcurl_cv_lib_version_ok = xyes ; then
if test x"$LIBCURL_CPPFLAGS" = "x" ; then
LIBCURL_CPPFLAGS=`$_libcurl_config --cflags`
fi
if test x"$LIBCURL" = "x" ; then
LIBCURL=`$_libcurl_config --libs`
# This is so silly, but Apple actually has a bug in their
# curl-config script. Fixed in Tiger, but there are still
# lots of Panther installs around.
case "${host}" in
powerpc-apple-darwin7*)
LIBCURL=`echo $LIBCURL | sed -e 's|-arch i386||g'`
;;
esac
fi
# All curl-config scripts support --feature
_libcurl_features=`$_libcurl_config --feature`
# Is it modern enough to have --protocols? (7.12.4)
if test $_libcurl_version -ge 461828 ; then
_libcurl_protocols=`$_libcurl_config --protocols`
fi
else
_libcurl_try_link=no
fi
unset _libcurl_wanted
fi
if test $_libcurl_try_link = yes ; then
# we did not find curl-config, so let's see if the user-supplied
# link line (or failing that, "-lcurl") is enough.
LIBCURL=${LIBCURL-"$_libcurl_ldflags -lcurl"}
AC_CACHE_CHECK([whether libcurl is usable],
[libcurl_cv_lib_curl_usable],
[
_libcurl_save_cppflags=$CPPFLAGS
CPPFLAGS="$LIBCURL_CPPFLAGS $CPPFLAGS"
_libcurl_save_libs=$LIBS
LIBS="$LIBCURL $LIBS"
AC_LINK_IFELSE([AC_LANG_PROGRAM([[#include <curl/curl.h>]],[[
/* Try and use a few common options to force a failure if we are
missing symbols or cannot link. */
int x;
curl_easy_setopt(NULL,CURLOPT_URL,NULL);
x=CURL_ERROR_SIZE;
x=CURLOPT_WRITEFUNCTION;
x=CURLOPT_WRITEDATA;
x=CURLOPT_ERRORBUFFER;
x=CURLOPT_STDERR;
x=CURLOPT_VERBOSE;
if (x) {;}
]])],libcurl_cv_lib_curl_usable=yes,libcurl_cv_lib_curl_usable=no)
CPPFLAGS=$_libcurl_save_cppflags
LIBS=$_libcurl_save_libs
unset _libcurl_save_cppflags
unset _libcurl_save_libs
])
if test $libcurl_cv_lib_curl_usable = yes ; then
# Does curl_free() exist in this version of libcurl?
# If not, fake it with free()
_libcurl_save_cppflags=$CPPFLAGS
CPPFLAGS="$CPPFLAGS $LIBCURL_CPPFLAGS"
_libcurl_save_libs=$LIBS
LIBS="$LIBS $LIBCURL"
AC_CHECK_DECL([curl_free],[],
[AC_DEFINE([curl_free],[free],
[Define curl_free() as free() if our version of curl lacks curl_free.])],
[[#include <curl/curl.h>]])
CPPFLAGS=$_libcurl_save_cppflags
LIBS=$_libcurl_save_libs
unset _libcurl_save_cppflags
unset _libcurl_save_libs
AC_DEFINE(HAVE_LIBCURL,1,
[Define to 1 if you have a functional curl library.])
AC_SUBST(LIBCURL_CPPFLAGS)
AC_SUBST(LIBCURL)
for _libcurl_feature in $_libcurl_features ; do
AC_DEFINE_UNQUOTED(AS_TR_CPP(libcurl_feature_$_libcurl_feature),[1])
eval AS_TR_SH(libcurl_feature_$_libcurl_feature)=yes
done
if test "x$_libcurl_protocols" = "x" ; then
# We do not have --protocols, so just assume that all
# protocols are available
_libcurl_protocols="HTTP FTP FILE TELNET LDAP DICT TFTP"
if test x$libcurl_feature_SSL = xyes ; then
_libcurl_protocols="$_libcurl_protocols HTTPS"
# FTPS was not standards-compliant until version
# 7.11.0 (0x070b00 == 461568)
if test $_libcurl_version -ge 461568; then
_libcurl_protocols="$_libcurl_protocols FTPS"
fi
fi
# RTSP, IMAP, POP3 and SMTP were added in
# 7.20.0 (0x071400 == 463872)
if test $_libcurl_version -ge 463872; then
_libcurl_protocols="$_libcurl_protocols RTSP IMAP POP3 SMTP"
fi
fi
for _libcurl_protocol in $_libcurl_protocols ; do
AC_DEFINE_UNQUOTED(AS_TR_CPP(libcurl_protocol_$_libcurl_protocol),[1])
eval AS_TR_SH(libcurl_protocol_$_libcurl_protocol)=yes
done
else
unset LIBCURL
unset LIBCURL_CPPFLAGS
fi
fi
unset _libcurl_try_link
unset _libcurl_version_parse
unset _libcurl_config
unset _libcurl_feature
unset _libcurl_features
unset _libcurl_protocol
unset _libcurl_protocols
unset _libcurl_version
unset _libcurl_ldflags
fi
if test x$_libcurl_with = xno || test x$libcurl_cv_lib_curl_usable != xyes ; then
# This is the IF-NO path
ifelse([$4],,:,[$4])
else
# This is the IF-YES path
ifelse([$3],,:,[$3])
fi
unset _libcurl_with
])