{"Entry":{"collection":"guc","key":"krb_srvname","name":"krb_srvname","aliases":[],"metadata":{"baseline":false,"boot_human":"postgres","boot_val":"postgres","category":"Connections and Authentication / Security and Authentication","category_zh":"","changed_in":[],"changes":[{"documentation_changed":false,"fields":{},"from":"8.0","status":"added","to":"8.1"},{"documentation_changed":true,"fields":{},"from":"8.2","status":"changed","to":"8.3"},{"documentation_changed":true,"fields":{},"from":"8.3","status":"changed","to":"8.4"},{"documentation_changed":false,"fields":{},"from":"9.3","status":"removed","to":"9.4"}],"content_hash":"cc7acfac50671286c2ffc6aaaf43a356502203c231ae3a44ba3db191db2ebcad","context":"sighup","default_changed_in":[],"default_history":[{"from":"9.0","to":"9.3","value":"postgres"}],"editorial":{"advice":{"olap":"For an upgrade or analytical estate, inventory every generated configuration before cutover. Map the old control to its successor and compare plans, throughput, WAL, or logging behavior rather than assuming the old numeric value is portable.","oltp":"Do not add this retired name to a current OLTP configuration. Translate its intent to the documented successor, test the migration under connection and write concurrency, and remove stale automation that still emits it.","small":"Delete the obsolete override after recording why it existed. On a small node, prefer the successor's default until measurements justify a new value; an unknown startup parameter can otherwise stop the server."},"mechanism":["PostgreSQL describes krb_srvname as follows: “Sets the name of the Kerberos service.” A configuration reload applies the value to the server without a full restart. The atlas measures it in PG9.0–9.3; boot_val is the compiled or initialized baseline, not proof of a running cluster's effective setting.","This historical authentication setting selected the Kerberos service principal name used by the server. It disappeared after PostgreSQL 9.3; current deployments should derive their GSS/Kerberos design from pg_hba.conf, the keytab selected by krb_server_keyfile, DNS, and the client service-name options rather than carrying this obsolete server GUC forward.","Read it together with krb_server_keyfile, hba_file, ssl, password_encryption. Check SHOW and pg_settings on the target server, verify the source and pending_restart fields, and compare workload, logs, and resource metrics before and after any change."],"pitfalls":["Treating the measured boot_val for krb_srvname as proof of the effective value on an initialized or managed cluster.","Applying a change as though it were immediate while pg_settings reports sighup context.","Changing this setting in isolation without checking the linked limits, observability, and rollback path.","Copying the removed name into a modern postgresql.conf instead of migrating to its documented successor."],"references":[{"title":"PostgreSQL 9.3: krb_srvname","url":"https://www.postgresql.org/docs/9.3/runtime-config-connection.html#GUC-KRB-SRVNAME"}],"related":["krb_server_keyfile","hba_file","ssl","password_encryption"],"summary":"krb_srvname — Sets the name of the Kerberos service. Observed in PG9.0–9.3; its last measured boot default is postgres in PG9.3, with sighup context. It was removed in PG9.4."},"enumvals":[],"first_version":"8.1","group":"Connections and Authentication","group_slug":"connection","imported_at":"2026-09-27T17:57:31.463069+08:00","intro_commit":{},"key":"krb_srvname","last_version":"9.3","max_val":"","min_val":"","name":"krb_srvname","position":205,"present_in":["8.1","8.2","8.3","8.4","9.0","9.1","9.2","9.3"],"short_desc":"Sets the Kerberos service name.","short_desc_zh":"","source_rev":"english-manuals:6d48821dc3ede5c9a2046a84c54875cad0f8140165389b30f674ab6b47de07d9","unit":"","vartype":"string"}},"Definition":{"Collection":"guc","Key":"krb_srvname","SourceDatabase":"center","Version":"9.3","SourceTable":"guc","SourceKey":"krb_srvname","SourceRevision":"english-manuals:6d48821dc3ede5c9a2046a84c54875cad0f8140165389b30f674ab6b47de07d9","Facts":{"boot_val":"postgres","category":"Connections and Authentication / Security and Authentication","context":"sighup","description":"Sets the Kerberos service name. See Section 19.3.5 for details. This parameter can only be set in the postgresql.conf file or on the server command line.","doc":{"anchor":"GUC-KRB-SRVNAME","file":"runtime-config-connection.html","lang":"en","sha256":"95792185217cad8f8f57c1f2fd8fab80819049ecb6585eed6b5c6a21d1e40259","slug":"9.3"},"documented":true,"enumvals":null,"extra_desc":null,"lang":"en","max_val":null,"metadata_version":"9.3","min_val":null,"name":"krb_srvname","short_desc":"Sets the name of the Kerberos service.","source":"pg-settings-source-snapshot","unit":null,"vartype":"string"},"ManualEvidence":{"doc":{"anchor":"GUC-KRB-SRVNAME","file":"runtime-config-connection.html","lang":"en","sha256":"95792185217cad8f8f57c1f2fd8fab80819049ecb6585eed6b5c6a21d1e40259","slug":"9.3"}},"MeasuredEvidence":{"metadata_version":"9.3"}},"Text":{"Collection":"guc","Key":"krb_srvname","SourceDatabase":"pgweb","Version":"9.3","Locale":"zh-Hans","Title":"krb_srvname","Summary":"","BodyHTML":"\u003cp\u003e设置 Kerberos 服务名。详情见\u003ca href=\"/docs/9.3/auth-methods.html#KERBEROS-AUTH\" rel=\"nofollow\"\u003e第 19.3.5 节\u003c/a\u003e。这个参数只能在\u003ccode\u003epostgresql.conf\u003c/code\u003e文件中或者服务器命令行上设置。\u003c/p\u003e","SourceRevision":"2026-09-11@29c86d9","ContentHash":"6f203d6733d896cef568c15b57cf513fe1ac6a75bbc5b81dd7050ff24909bd24","Payload":{"carried_from":"","carry_reason":"","doc_html":"\u003cp\u003e设置 Kerberos 服务名。详情见\u003ca href=\"/docs/9.3/auth-methods.html#KERBEROS-AUTH\" title=\"19.3.5. Kerberos 认证\"\u003e第 19.3.5 节\u003c/a\u003e。这个参数只能在\u003ccode class=\"filename\"\u003epostgresql.conf\u003c/code\u003e文件中或者服务器命令行上设置。\u003c/p\u003e","doc_same_as":""}},"RequestedLocale":"zh-Hans","Fallback":false,"Versions":["8.1","8.2","8.3","8.4","9.0","9.1","9.2","9.3"],"Locales":["en","zh-Hans"],"Signatures":null,"Spellings":null,"SQLState":null,"Evidence":null}