libressl/README

   1 The windows version of Alpine can be compiled with LibreSSL. The build
   2 script will compile using LibreSSL if there is a libressl folder in the
   3 main Alpine source code directory. If you rename or remove this folder,
   4 Alpine will be compiled using the default SSL libraries in your computer.
   5
   6 There are pros and cons to every decision. Here are the pros and cons to
   7 building using LibreSSL.
   8
   9 Pros:
  10
  11   * LibreSSL can be updated at any time. This will make it possible to
  12     build Alpine with the latest features of LibreSSL. If you decide to
  13     not use LibreSSL, your SSL libraries will eventually not be updated.
  14
  15   * Certificates can be updated at any time, and so you can run your
  16     favorite version of Alpine for many years, even after your Windows
  17     version is not supported anymore.
  18
  19   * You get S/MIME support in Windows for free.
  20
  21 Cons:
  22
  23   * LibreSSL will check certificates not using the certificates installed
  24     in your Windows computer, but it will use those saved in
  25     C:\libressl\ssl]certs. This means that it is the responsibility of the
  26     user to update the certificates. No matter what choice is made, if
  27     certificates are not updated, validation will always eventually fail.
  28
  29 Default Certificates Location:
  30
  31   * When Alpine is compiled with LibreSSL support, certificates must be
  32     placed in the C:\\libressl\ssl\certs directory. You can find a copy
  33     of certificates in the git repository in the libressl/certs directory.
  34     All you have to do is to copy the certificates in that directory to
  35     the C:\\libressl\ssl\certs directory.
  36
  37   * In order to make it easy to distribute certificates, each certificate
  38     is distributed twice. Once with a long name, and another with the
  39     short name. The short name is called the "subject hash". A unix script
  40     called "doit.sh" can be used to create the short name. You can run
  41     such script, from this directory by using the command
  42
  43      ./doit.sh
  44
  45     and copy the resulting files with short names, to the
  46     C:\\libressl\ssl\certs folder. You only need the files with the short
  47     names, but both are distributed.
  48