'\" t
.\"     Title: ca-legacy
.\"    Author: [see the "AUTHOR" section]
.\" Generator: DocBook XSL Stylesheets v1.78.1 <http://docbook.sf.net/>
.\"      Date: 07/04/2025
.\"    Manual: \ \&
.\"    Source: ca-legacy
.\"  Language: English
.\"
.TH "CA\-LEGACY" "8" "07/04/2025" "ca\-legacy" "\ \&"
.\" -----------------------------------------------------------------
.\" * 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"
ca-legacy \- Manage the system configuration for legacy CA certificates
.SH "SYNOPSIS"
.sp
\fBca\-legacy\fR [\fICOMMAND\fR]
.SH "DESCRIPTION"
.sp
ca\-legacy(8) is used to include or exclude a set of legacy Certificate Authority (CA) certificates in the system\(cqs list of trusted CA certificates\&.
.sp
The list of CA certificates and trust flags included in the ca\-certificates package are based on the decisions made by Mozilla\&.org according to the Mozilla CA policy\&.
.sp
Occasionally, removal or distrust decisions made by Mozilla\&.org might be incompatible with the requirements or limitations of some applications that also use the CA certificates list in the Linux environment\&.
.sp
The ca\-certificates package might keep some CA certificates included and trusted by default, as long as it is seen necessary by the maintainers, despite the fact that they have been removed by Mozilla\&. These certificates are called legacy CA certificates\&.
.sp
The general requirements to keep legacy CA certificates included and trusted might change over time, for example if functional limitations of software packages have been resolved\&. Future versions of the ca\-certificates package might reduce the set of legacy CA certificates that are included and trusted by default\&.
.sp
The ca\-legacy(8) command can be used to override the default behaviour\&.
.sp
The mechanisms to individually trust or distrust CA certificates as described in update\-ca\-trust(8) still apply\&.
.SH "COMMANDS"
.PP
\fBcheck\fR
.RS 4
The current configuration will be shown\&.
.RE
.PP
\fBdefault\fR
.RS 4
Configure the system to use the default configuration, as recommended by the package maintainers\&.
.RE
.PP
\fBdisable\fR
.RS 4
Configure the system to explicitly disable legacy CA certificates\&. Using this configuration, the system will use the set of included and trusted CA certificates as released by Mozilla\&.
.RE
.PP
\fBinstall\fR
.RS 4
The configuration file will be read and the system configuration will be set accordingly\&. This command is executed automatically during upgrades of the ca\-certificates package\&.
.RE
.SH "FILES"
.PP
/etc/pki/ca\-trust/ca\-legacy\&.conf
.RS 4
A configuration file that will be used and modified by the ca\-legacy command\&. The contents of the configuration file will be read on package upgrades\&.
.RE
.SH "AUTHOR"
.sp
Written by Kai Engert\&.
