NAME

       update-ca-certificates - update /etc/ssl/certs and ca-certificates.crt

SYNOPSIS

       update-ca-certificates [options]

DESCRIPTION

       This manual page documents briefly the update-ca-certificates command.

       update-ca-certificates is a program that manages the collection of TLS certificates for the local machine
       and generates ca-certificates.crt.  ca-certificates.crt is a single-file  of  concatenated  certificates.
       The collection of individual certificates is stored at /etc/ssl/certs.

       The  program  reads  the configuration file /etc/ca-certificates.conf. Each line gives a pathname of a CA
       certificate under /usr/share/ca-certificates that should be  trusted.  Lines  that  begin  with  "#"  are
       comment  lines  and  thus ignored.  Lines that begin with "!" are deselected, causing the deactivation of
       the CA certificate in question.

       Certificates must be in PEM format and have a .crt extension  in  order  to  be  included  by  update-ca-
       certificates.  Furthermore,  all  certificates  with  a  .crt  extension found below /usr/local/share/ca-
       certificates are also included and implicitly trusted.

       To add one or more certificates to the machine, copy the  certificates  in  PEM  format  with  the  *.crt
       extension to /usr/local/share/ca-certificates. There should be one certificate per file, and not multiple
       certificates in a single file. Then run update-ca-certificates to merge the  new  certificates  into  the
       existing machine store at /etc/ssl/certs.

       Before  terminating,  update-ca-certificates invokes run-parts on /etc/ca-certificates/update.d and calls
       each hook with a list of certificates: those added are prefixed with a +, those removed are prefixed with
       a -.

OPTIONS

       A summary of options is included below.

       -h, --help
              Show summary of options.

       -v, --verbose
              Be verbose. Output openssl rehash.

       -f, --fresh
              Fresh updates.  Remove symlinks in /etc/ssl/certs directory.

       --certsconf
              Change the configuration file. By default, the file /etc/ca-certificates.conf is used.

       --certsdir
              Change the certificate directory. By default, the directory /usr/share/ca-certificates is used.

       --localcertsdir
              Change the local certificate directory. By default, the directory /usr/local/share/ca-certificates
              is used.

       --etccertsdir
              Change the /etc certificate directory. By default, the directory /etc/ssl/certs is used.

       FILES

       /etc/ca-certificates.conf
              A configuration file.

       /etc/ssl/certs/ca-certificates.crt
              A single-file version of CA certificates. This holds all CA certificates that  were  activated  in
              /etc/ca-certificates.conf.

       /usr/share/ca-certificates
              Directory of CA certificates provided by the distribution.

       /usr/local/share/ca-certificates
              Directory of local CA certificates, with .crt extension, provided by the user.

SEE ALSO

       openssl(1)

AUTHOR

       This  manual  page  was written by Fumitoshi UKAI <ukai@debian.or.jp>, for the Debian project (but may be
       used by others).

                                                  20 April 2003                        UPDATE-CA-CERTIFICATES(8)