nixpkgs/nixos/doc/manual
aszlig 78b4b90d6c
Merge pull request #39526 (improve dhparams)
This introduces an option that allows us to turn off stateful generation
of Diffie-Hellman parameters, which in some way is still "stateful" as
the generated DH params file is non-deterministic.

However what we can avoid with this is to have an increased surface for
failures during system startup, because generation of the parameters is
done during build-time.

Aside from adding a NixOS VM test it also restructures the type of the
security.dhparams.params option, so that it's a submodule.

A new defaultBitSize option is also there to allow users to set a
system-wide default.

I added a release notes entry that described what has changed and also
included a few notes for module developers using this module, as the
first usage already popped up in NixOS/nixpkgs#39507.

Thanks to @Ekleog and @abbradar for reviewing.
2018-05-08 02:09:46 +02:00
..
administration nixos docs: format =) 2018-05-01 19:57:09 -04:00
configuration nixos docs: format =) 2018-05-01 19:57:09 -04:00
development nixos docs: format =) 2018-05-01 19:57:09 -04:00
installation nixos docs: format =) 2018-05-01 19:57:09 -04:00
release-notes Merge pull request #39526 (improve dhparams) 2018-05-08 02:09:46 +02:00
.gitignore nixos docs: ignore generated files 2018-05-01 19:50:02 -04:00
default.nix nixos docs: Add a makefile for hacking on the nixos docs 2018-04-28 04:00:55 -04:00
Makefile nixos docs: fixup 2018-05-01 19:43:52 -04:00
man-configuration.xml nixos docs: format =) 2018-05-01 19:57:09 -04:00
man-nixos-build-vms.xml nixos docs: format =) 2018-05-01 19:57:09 -04:00
man-nixos-enter.xml nixos docs: format =) 2018-05-01 19:57:09 -04:00
man-nixos-generate-config.xml nixos docs: format =) 2018-05-01 19:57:09 -04:00
man-nixos-install.xml nixos docs: format =) 2018-05-01 19:57:09 -04:00
man-nixos-option.xml nixos docs: format =) 2018-05-01 19:57:09 -04:00
man-nixos-rebuild.xml nixos docs: format =) 2018-05-01 19:57:09 -04:00
man-nixos-version.xml nixos docs: format =) 2018-05-01 19:57:09 -04:00
man-pages.xml nixos docs: format =) 2018-05-01 19:57:09 -04:00
manual.xml nixos docs: format =) 2018-05-01 19:57:09 -04:00
options-to-docbook.xsl nixos docs: Add a makefile for hacking on the nixos docs 2018-04-28 04:00:55 -04:00
README
shell.nix nixos docs: makefile for formatting 2018-05-01 18:03:25 -04:00

To build the manual, you need Nix installed on your system (no need
for NixOS). To install Nix, follow the instructions at

    https://nixos.org/nix/download.html

When you have Nix on your system, in the root directory of the project
(i.e., `nixpkgs`), run:

    nix-build nixos/release.nix -A manual.x86_64-linux

When this command successfully finishes, it will tell you where the
manual got generated.