dev/nixpkgs
1
0
Fork 0
Code Issues Pull Requests Actions 2 Packages Projects Releases Wiki Activity

Merge master into haskell-updates

Browse Source
This commit is contained in:
github-actions[bot] 2022-08-03 00:15:49 +00:00 committed by GitHub
commit 1d51c8b324
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1275 changed files with 11074 additions and 10265 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
.github/workflows/update-terraform-providers.yml vendored
View File

@ -39,7 +39,7 @@ jobs:
Check that all providers build with: Check that all providers build with:
``` ```
@ofborg build terraform-full @ofborg build terraform.full
``` ```
branch: terraform-providers-update branch: terraform-providers-update
delete-branch: false delete-branch: false

21
maintainers/maintainer-list.nix
View File

@ -6339,6 +6339,12 @@
github = "JoshuaFern"; github = "JoshuaFern";
githubId = 4300747; githubId = 4300747;
}; };
joshvanl = {
email = " me@joshvanl.dev ";
github = "joshvanl";
githubId = 15893072;
name = "Josh van Leeuwen";
};
jpas = { jpas = {
name = "Jarrod Pas"; name = "Jarrod Pas";
email = "jarrod@jarrodpas.com"; email = "jarrod@jarrodpas.com";
@ -6691,6 +6697,15 @@
githubId = 37185887; githubId = 37185887;
name = "Calvin Kim"; name = "Calvin Kim";
}; };
keksbg = {
email = "keksbg@riseup.net";
name = "Stella";
github = "keksbg";
githubId = 10682187;
keys = [{
fingerprint = "AB42 1F18 5A19 A160 AD77 9885 3D6D CA5B 6F2C 2A7A";
}];
};
keldu = { keldu = {
email = "mail@keldu.de"; email = "mail@keldu.de";
github = "keldu"; github = "keldu";
@ -13094,6 +13109,12 @@
githubId = 61303; githubId = 61303;
name = "Tom Fitzhenry"; name = "Tom Fitzhenry";
}; };
tomhoule = {
email = "secondary+nixpkgs@tomhoule.com";
github = "tomhoule";
githubId = 13155277;
name = "Tom Houle";
};
tomsmeets = { tomsmeets = {
email = "tom.tsmeets@gmail.com"; email = "tom.tsmeets@gmail.com";
github = "TomSmeets"; github = "TomSmeets";

1
maintainers/scripts/luarocks-packages.csv
View File

@ -86,6 +86,7 @@ plenary.nvim,https://github.com/nvim-lua/plenary.nvim.git,,,,lua5_1,
rapidjson,https://github.com/xpol/lua-rapidjson.git,,,,, rapidjson,https://github.com/xpol/lua-rapidjson.git,,,,,
readline,,,,,, readline,,,,,,
say,https://github.com/Olivine-Labs/say.git,,,,, say,https://github.com/Olivine-Labs/say.git,,,,,
serpent,,,,,,lockejan
sqlite,,,,,, sqlite,,,,,,
std._debug,https://github.com/lua-stdlib/_debug.git,,,,, std._debug,https://github.com/lua-stdlib/_debug.git,,,,,
std.normalize,https://github.com/lua-stdlib/normalize.git,,,,, std.normalize,https://github.com/lua-stdlib/normalize.git,,,,,

Can't render this file because it has a wrong number of fields in line 72.

31
nixos/lib/make-options-doc/default.nix
View File

@ -99,6 +99,14 @@ let
optionsNix = builtins.listToAttrs (map (o: { name = o.name; value = removeAttrs o ["name" "visible" "internal"]; }) optionsList); optionsNix = builtins.listToAttrs (map (o: { name = o.name; value = removeAttrs o ["name" "visible" "internal"]; }) optionsList);
pythonMD =
let
self = (pkgs.python3Minimal.override {
inherit self;
includeSiteCustomize = true;
});
in self.withPackages (p: [ p.mistune_2_0 ]);
in rec { in rec {
inherit optionsNix; inherit optionsNix;
@ -116,17 +124,20 @@ in rec {
optionsJSON = pkgs.runCommand "options.json" optionsJSON = pkgs.runCommand "options.json"
{ meta.description = "List of NixOS options in JSON format"; { meta.description = "List of NixOS options in JSON format";
buildInputs = [ buildInputs = [ pkgs.brotli pythonMD ];
pkgs.brotli
(let
self = (pkgs.python3Minimal.override {
inherit self;
includeSiteCustomize = true;
});
in self.withPackages (p: [ p.mistune_2_0 ]))
];
options = builtins.toFile "options.json" options = builtins.toFile "options.json"
(builtins.unsafeDiscardStringContext (builtins.toJSON optionsNix)); (builtins.unsafeDiscardStringContext (builtins.toJSON optionsNix));
# convert markdown to docbook in its own derivation to cache the
# conversion results. the conversion is surprisingly expensive.
baseJSON =
if baseOptionsJSON != null
then
pkgs.runCommand "base-json-md-converted" {
buildInputs = [ pythonMD ];
} ''
python ${./mergeJSON.py} ${baseOptionsJSON} <(echo '{}') > $out
''
else null;
} }
'' ''
# Export list of options in different format. # Export list of options in different format.
@ -143,7 +154,7 @@ in rec {
else '' else ''
python ${./mergeJSON.py} \ python ${./mergeJSON.py} \
${lib.optionalString warningsAreErrors "--warnings-are-errors"} \ ${lib.optionalString warningsAreErrors "--warnings-are-errors"} \
${baseOptionsJSON} $options \ $baseJSON $options \
> $dst/options.json > $dst/options.json
'' ''
} }

14
nixos/lib/make-options-doc/mergeJSON.py
View File

@ -53,12 +53,14 @@ def convertMD(options: Dict[str, Any]) -> str:
'.note': 'note' '.note': 'note'
} }
class Renderer(mistune.renderers.BaseRenderer): class Renderer(mistune.renderers.BaseRenderer):
def __init__(self, path):
self.path = path
def _get_method(self, name): def _get_method(self, name):
try: try:
return super(Renderer, self)._get_method(name) return super(Renderer, self)._get_method(name)
except AttributeError: except AttributeError:
def not_supported(*args, **kwargs): def not_supported(*args, **kwargs):
raise NotImplementedError("md node not supported yet", name, args, **kwargs) raise NotImplementedError("md node not supported yet", self.path, name, args, **kwargs)
return not_supported return not_supported
def text(self, text): def text(self, text):
@ -166,8 +168,8 @@ def convertMD(options: Dict[str, Any]) -> str:
md.block.rules.append('admonition') md.block.rules.append('admonition')
plugins.append(admonition) plugins.append(admonition)
def convertString(text: str) -> str: def convertString(path: str, text: str) -> str:
rendered = mistune.markdown(text, renderer=Renderer(), plugins=plugins) rendered = mistune.markdown(text, renderer=Renderer(path), plugins=plugins)
# keep trailing spaces so we can diff the generated XML to check for conversion bugs. # keep trailing spaces so we can diff the generated XML to check for conversion bugs.
return rendered.rstrip() + text[len(text.rstrip()):] return rendered.rstrip() + text[len(text.rstrip()):]
@ -179,12 +181,12 @@ def convertMD(options: Dict[str, Any]) -> str:
for (name, option) in options.items(): for (name, option) in options.items():
if optionIs(option, 'description', 'mdDoc'): if optionIs(option, 'description', 'mdDoc'):
option['description'] = convertString(option['description']['text']) option['description'] = convertString(name, option['description']['text'])
if optionIs(option, 'example', 'literalMD'): if optionIs(option, 'example', 'literalMD'):
docbook = convertString(option['example']['text']) docbook = convertString(name, option['example']['text'])
option['example'] = { '_type': 'literalDocBook', 'text': docbook } option['example'] = { '_type': 'literalDocBook', 'text': docbook }
if optionIs(option, 'default', 'literalMD'): if optionIs(option, 'default', 'literalMD'):
docbook = convertString(option['default']['text']) docbook = convertString(name, option['default']['text'])
option['default'] = { '_type': 'literalDocBook', 'text': docbook } option['default'] = { '_type': 'literalDocBook', 'text': docbook }
return options return options

10
nixos/modules/config/console.nix
View File

@ -58,7 +58,7 @@ in
type = with types; either str path; type = with types; either str path;
default = "us"; default = "us";
example = "fr"; example = "fr";
description = '' description = lib.mdDoc ''
The keyboard mapping table for the virtual consoles. The keyboard mapping table for the virtual consoles.
''; '';
}; };
@ -72,7 +72,7 @@ in
"002b36" "cb4b16" "586e75" "657b83" "002b36" "cb4b16" "586e75" "657b83"
"839496" "6c71c4" "93a1a1" "fdf6e3" "839496" "6c71c4" "93a1a1" "fdf6e3"
]; ];
description = '' description = lib.mdDoc ''
The 16 colors palette used by the virtual consoles. The 16 colors palette used by the virtual consoles.
Leave empty to use the default colors. Leave empty to use the default colors.
Colors must be in hexadecimal format and listed in Colors must be in hexadecimal format and listed in
@ -84,7 +84,7 @@ in
packages = mkOption { packages = mkOption {
type = types.listOf types.package; type = types.listOf types.package;
default = [ ]; default = [ ];
description = '' description = lib.mdDoc ''
List of additional packages that provide console fonts, keymaps and List of additional packages that provide console fonts, keymaps and
other resources for virtual consoles use. other resources for virtual consoles use.
''; '';
@ -93,7 +93,7 @@ in
useXkbConfig = mkOption { useXkbConfig = mkOption {
type = types.bool; type = types.bool;
default = false; default = false;
description = '' description = lib.mdDoc ''
If set, configure the virtual console keymap from the xserver If set, configure the virtual console keymap from the xserver
keyboard settings. keyboard settings.
''; '';
@ -102,7 +102,7 @@ in
earlySetup = mkOption { earlySetup = mkOption {
default = false; default = false;
type = types.bool; type = types.bool;
description = '' description = lib.mdDoc ''
Enable setting virtual console options as early as possible (in initrd). Enable setting virtual console options as early as possible (in initrd).
''; '';
}; };

56
nixos/modules/config/fonts/fontconfig.nix
View File

@ -246,7 +246,7 @@ in
enable = mkOption { enable = mkOption {
type = types.bool; type = types.bool;
default = true; default = true;
description = '' description = lib.mdDoc ''
If enabled, a Fontconfig configuration file will be built If enabled, a Fontconfig configuration file will be built
pointing to a set of default fonts. If you don't care about pointing to a set of default fonts. If you don't care about
running X11 applications or any other program that uses running X11 applications or any other program that uses
@ -267,7 +267,7 @@ in
antialias = mkOption { antialias = mkOption {
type = types.bool; type = types.bool;
default = true; default = true;
description = '' description = lib.mdDoc ''
Enable font antialiasing. At high resolution (> 200 DPI), Enable font antialiasing. At high resolution (> 200 DPI),
antialiasing has no visible effect; users of such displays may want antialiasing has no visible effect; users of such displays may want
to disable this option. to disable this option.
@ -277,9 +277,9 @@ in
localConf = mkOption { localConf = mkOption {
type = types.lines; type = types.lines;
default = ""; default = "";
description = '' description = lib.mdDoc ''
System-wide customization file contents, has higher priority than System-wide customization file contents, has higher priority than
<literal>defaultFonts</literal> settings. `defaultFonts` settings.
''; '';
}; };
@ -287,7 +287,7 @@ in
monospace = mkOption { monospace = mkOption {
type = types.listOf types.str; type = types.listOf types.str;
default = ["DejaVu Sans Mono"]; default = ["DejaVu Sans Mono"];
description = '' description = lib.mdDoc ''
System-wide default monospace font(s). Multiple fonts may be System-wide default monospace font(s). Multiple fonts may be
listed in case multiple languages must be supported. listed in case multiple languages must be supported.
''; '';
@ -296,7 +296,7 @@ in
sansSerif = mkOption { sansSerif = mkOption {
type = types.listOf types.str; type = types.listOf types.str;
default = ["DejaVu Sans"]; default = ["DejaVu Sans"];
description = '' description = lib.mdDoc ''
System-wide default sans serif font(s). Multiple fonts may be System-wide default sans serif font(s). Multiple fonts may be
listed in case multiple languages must be supported. listed in case multiple languages must be supported.
''; '';
@ -305,7 +305,7 @@ in
serif = mkOption { serif = mkOption {
type = types.listOf types.str; type = types.listOf types.str;
default = ["DejaVu Serif"]; default = ["DejaVu Serif"];
description = '' description = lib.mdDoc ''
System-wide default serif font(s). Multiple fonts may be listed System-wide default serif font(s). Multiple fonts may be listed
in case multiple languages must be supported. in case multiple languages must be supported.
''; '';
@ -314,7 +314,7 @@ in
emoji = mkOption { emoji = mkOption {
type = types.listOf types.str; type = types.listOf types.str;
default = ["Noto Color Emoji"]; default = ["Noto Color Emoji"];
description = '' description = lib.mdDoc ''
System-wide default emoji font(s). Multiple fonts may be listed System-wide default emoji font(s). Multiple fonts may be listed
in case a font does not support all emoji. in case a font does not support all emoji.
@ -331,7 +331,7 @@ in
enable = mkOption { enable = mkOption {
type = types.bool; type = types.bool;
default = true; default = true;
description = '' description = lib.mdDoc ''
Enable font hinting. Hinting aligns glyphs to pixel boundaries to Enable font hinting. Hinting aligns glyphs to pixel boundaries to
improve rendering sharpness at low resolution. At high resolution improve rendering sharpness at low resolution. At high resolution
(> 200 dpi) hinting will do nothing (at best); users of such (> 200 dpi) hinting will do nothing (at best); users of such
@ -342,7 +342,7 @@ in
autohint = mkOption { autohint = mkOption {
type = types.bool; type = types.bool;
default = false; default = false;
description = '' description = lib.mdDoc ''
Enable the autohinter in place of the default interpreter. Enable the autohinter in place of the default interpreter.
The results are usually lower quality than correctly-hinted The results are usually lower quality than correctly-hinted
fonts, but better than unhinted fonts. fonts, but better than unhinted fonts.
@ -352,7 +352,7 @@ in
style = mkOption { style = mkOption {
type = types.enum [ "hintnone" "hintslight" "hintmedium" "hintfull" ]; type = types.enum [ "hintnone" "hintslight" "hintmedium" "hintfull" ];
default = "hintslight"; default = "hintslight";
description = '' description = lib.mdDoc ''
Hintstyle is the amount of font reshaping done to line up Hintstyle is the amount of font reshaping done to line up
to the grid. to the grid.
@ -367,10 +367,10 @@ in
includeUserConf = mkOption { includeUserConf = mkOption {
type = types.bool; type = types.bool;
default = true; default = true;
description = '' description = lib.mdDoc ''
Include the user configuration from Include the user configuration from
<filename>~/.config/fontconfig/fonts.conf</filename> or {file}`~/.config/fontconfig/fonts.conf` or
<filename>~/.config/fontconfig/conf.d</filename>. {file}`~/.config/fontconfig/conf.d`.
''; '';
}; };
@ -379,26 +379,26 @@ in
rgba = mkOption { rgba = mkOption {
default = "rgb"; default = "rgb";
type = types.enum ["rgb" "bgr" "vrgb" "vbgr" "none"]; type = types.enum ["rgb" "bgr" "vrgb" "vbgr" "none"];
description = '' description = lib.mdDoc ''
Subpixel order. The overwhelming majority of displays are Subpixel order. The overwhelming majority of displays are
<literal>rgb</literal> in their normal orientation. Select `rgb` in their normal orientation. Select
<literal>vrgb</literal> for mounting such a display 90 degrees `vrgb` for mounting such a display 90 degrees
clockwise from its normal orientation or <literal>vbgr</literal> clockwise from its normal orientation or `vbgr`
for mounting 90 degrees counter-clockwise. Select for mounting 90 degrees counter-clockwise. Select
<literal>bgr</literal> in the unlikely event of mounting 180 `bgr` in the unlikely event of mounting 180
degrees from the normal orientation. Reverse these directions in degrees from the normal orientation. Reverse these directions in
the improbable event that the display's native subpixel order is the improbable event that the display's native subpixel order is
<literal>bgr</literal>. `bgr`.
''; '';
}; };
lcdfilter = mkOption { lcdfilter = mkOption {
default = "default"; default = "default";
type = types.enum ["none" "default" "light" "legacy"]; type = types.enum ["none" "default" "light" "legacy"];
description = '' description = lib.mdDoc ''
FreeType LCD filter. At high resolution (> 200 DPI), LCD filtering FreeType LCD filter. At high resolution (> 200 DPI), LCD filtering
has no visible effect; users of such displays may want to select has no visible effect; users of such displays may want to select
<literal>none</literal>. `none`.
''; '';
}; };
@ -407,7 +407,7 @@ in
cache32Bit = mkOption { cache32Bit = mkOption {
default = false; default = false;
type = types.bool; type = types.bool;
description = '' description = lib.mdDoc ''
Generate system fonts cache for 32-bit applications. Generate system fonts cache for 32-bit applications.
''; '';
}; };
@ -415,8 +415,8 @@ in
allowBitmaps = mkOption { allowBitmaps = mkOption {
type = types.bool; type = types.bool;
default = true; default = true;
description = '' description = lib.mdDoc ''
Allow bitmap fonts. Set to <literal>false</literal> to ban all Allow bitmap fonts. Set to `false` to ban all
bitmap fonts. bitmap fonts.
''; '';
}; };
@ -424,8 +424,8 @@ in
allowType1 = mkOption { allowType1 = mkOption {
type = types.bool; type = types.bool;
default = false; default = false;
description = '' description = lib.mdDoc ''
Allow Type-1 fonts. Default is <literal>false</literal> because of Allow Type-1 fonts. Default is `false` because of
poor rendering. poor rendering.
''; '';
}; };
@ -433,7 +433,7 @@ in
useEmbeddedBitmaps = mkOption { useEmbeddedBitmaps = mkOption {
type = types.bool; type = types.bool;
default = false; default = false;
description = "Use embedded bitmaps in fonts like Calibri."; description = lib.mdDoc "Use embedded bitmaps in fonts like Calibri.";
}; };
}; };

4
nixos/modules/config/fonts/fonts.nix
View File

@ -57,13 +57,13 @@ in
type = types.listOf types.path; type = types.listOf types.path;
default = []; default = [];
example = literalExpression "[ pkgs.dejavu_fonts ]"; example = literalExpression "[ pkgs.dejavu_fonts ]";
description = "List of primary font paths."; description = lib.mdDoc "List of primary font paths.";
}; };
enableDefaultFonts = mkOption { enableDefaultFonts = mkOption {
type = types.bool; type = types.bool;
default = false; default = false;
description = '' description = lib.mdDoc ''
Enable a basic set of fonts providing several font styles Enable a basic set of fonts providing several font styles
and families and reasonable coverage of Unicode. and families and reasonable coverage of Unicode.
''; '';

2
nixos/modules/config/fonts/ghostscript.nix
View File

@ -11,7 +11,7 @@ with lib;
enableGhostscriptFonts = mkOption { enableGhostscriptFonts = mkOption {
type = types.bool; type = types.bool;
default = false; default = false;
description = '' description = lib.mdDoc ''
Whether to add the fonts provided by Ghostscript (such as Whether to add the fonts provided by Ghostscript (such as
various URW fonts and the “Base-14” Postscript fonts) to the various URW fonts and the “Base-14” Postscript fonts) to the
list of system fonts, making them available to X11 list of system fonts, making them available to X11

2
nixos/modules/config/gnu.nix
View File

@ -5,7 +5,7 @@
gnu = lib.mkOption { gnu = lib.mkOption {
type = lib.types.bool; type = lib.types.bool;
default = false; default = false;
description = '' description = lib.mdDoc ''
When enabled, GNU software is chosen by default whenever a there is When enabled, GNU software is chosen by default whenever a there is
a choice between GNU and non-GNU software (e.g., GNU lsh a choice between GNU and non-GNU software (e.g., GNU lsh
vs. OpenSSH). vs. OpenSSH).

2
nixos/modules/config/gtk/gtk-icon-cache.nix
View File

@ -7,7 +7,7 @@ with lib;
type = types.bool; type = types.bool;
default = config.services.xserver.enable; default = config.services.xserver.enable;
defaultText = literalExpression "config.services.xserver.enable"; defaultText = literalExpression "config.services.xserver.enable";
description = '' description = lib.mdDoc ''
Whether to build icon theme caches for GTK applications. Whether to build icon theme caches for GTK applications.
''; '';
}; };

10
nixos/modules/config/i18n.nix
View File

@ -21,7 +21,7 @@ with lib;
} }
''; '';
example = literalExpression "pkgs.glibcLocales"; example = literalExpression "pkgs.glibcLocales";
description = '' description = lib.mdDoc ''
Customized pkg.glibcLocales package. Customized pkg.glibcLocales package.
Changing this option can disable handling of i18n.defaultLocale Changing this option can disable handling of i18n.defaultLocale
@ -33,7 +33,7 @@ with lib;
type = types.str; type = types.str;
default = "en_US.UTF-8"; default = "en_US.UTF-8";
example = "nl_NL.UTF-8"; example = "nl_NL.UTF-8";
description = '' description = lib.mdDoc ''
The default locale. It determines the language for program The default locale. It determines the language for program
messages, the format for dates and times, sort order, and so on. messages, the format for dates and times, sort order, and so on.
It also determines the character set, such as UTF-8. It also determines the character set, such as UTF-8.
@ -44,10 +44,10 @@ with lib;
type = types.attrsOf types.str; type = types.attrsOf types.str;
default = {}; default = {};
example = { LC_MESSAGES = "en_US.UTF-8"; LC_TIME = "de_DE.UTF-8"; }; example = { LC_MESSAGES = "en_US.UTF-8"; LC_TIME = "de_DE.UTF-8"; };
description = '' description = lib.mdDoc ''
A set of additional system-wide locale settings other than A set of additional system-wide locale settings other than
<literal>LANG</literal> which can be configured with `LANG` which can be configured with
<option>i18n.defaultLocale</option>. {option}`i18n.defaultLocale`.
''; '';
}; };

2
nixos/modules/config/iproute2.nix
View File

@ -11,7 +11,7 @@ in
rttablesExtraConfig = mkOption { rttablesExtraConfig = mkOption {
type = types.lines; type = types.lines;
default = ""; default = "";
description = '' description = lib.mdDoc ''
Verbatim lines to add to /etc/iproute2/rt_tables Verbatim lines to add to /etc/iproute2/rt_tables
''; '';
}; };

50
nixos/modules/config/krb5/default.nix
View File

@ -85,9 +85,9 @@ in {
default = pkgs.krb5Full; default = pkgs.krb5Full;
defaultText = literalExpression "pkgs.krb5Full"; defaultText = literalExpression "pkgs.krb5Full";
example = literalExpression "pkgs.heimdal"; example = literalExpression "pkgs.heimdal";
description = '' description = lib.mdDoc ''
The Kerberos implementation that will be present in The Kerberos implementation that will be present in
<literal>environment.systemPackages</literal> after enabling this `environment.systemPackages` after enabling this
service. service.
''; '';
}; };
@ -101,7 +101,7 @@ in {
default_realm = "ATHENA.MIT.EDU"; default_realm = "ATHENA.MIT.EDU";
}; };
''; '';
description = '' description = lib.mdDoc ''
Settings used by the Kerberos V5 library. Settings used by the Kerberos V5 library.
''; '';
}; };
@ -121,7 +121,7 @@ in {
}; };
''; '';
apply = attrs: filterEmbeddedMetadata attrs; apply = attrs: filterEmbeddedMetadata attrs;
description = "Realm-specific contact information and settings."; description = lib.mdDoc "Realm-specific contact information and settings.";
}; };
domain_realm = mkOption { domain_realm = mkOption {
@ -134,7 +134,7 @@ in {
}; };
''; '';
apply = attrs: filterEmbeddedMetadata attrs; apply = attrs: filterEmbeddedMetadata attrs;
description = '' description = lib.mdDoc ''
Map of server hostnames to Kerberos realms. Map of server hostnames to Kerberos realms.
''; '';
}; };
@ -153,7 +153,7 @@ in {
}; };
''; '';
apply = attrs: filterEmbeddedMetadata attrs; apply = attrs: filterEmbeddedMetadata attrs;
description = '' description = lib.mdDoc ''
Authentication paths for non-hierarchical cross-realm authentication. Authentication paths for non-hierarchical cross-realm authentication.
''; '';
}; };
@ -174,7 +174,7 @@ in {
}; };
''; '';
apply = attrs: filterEmbeddedMetadata attrs; apply = attrs: filterEmbeddedMetadata attrs;
description = '' description = lib.mdDoc ''
Settings used by some Kerberos V5 applications. Settings used by some Kerberos V5 applications.
''; '';
}; };
@ -190,7 +190,7 @@ in {
}; };
''; '';
apply = attrs: filterEmbeddedMetadata attrs; apply = attrs: filterEmbeddedMetadata attrs;
description = '' description = lib.mdDoc ''
Controls plugin module registration. Controls plugin module registration.
''; '';
}; };
@ -235,14 +235,14 @@ in {
admin_server = SYSLOG:NOTICE admin_server = SYSLOG:NOTICE
default = SYSLOG:NOTICE default = SYSLOG:NOTICE
''; '';
description = '' description = lib.mdDoc ''
Verbatim <literal>krb5.conf</literal> configuration. Note that this Verbatim `krb5.conf` configuration. Note that this
is mutually exclusive with configuration via is mutually exclusive with configuration via
<literal>libdefaults</literal>, <literal>realms</literal>, `libdefaults`, `realms`,
<literal>domain_realm</literal>, <literal>capaths</literal>, `domain_realm`, `capaths`,
<literal>appdefaults</literal>, <literal>plugins</literal> and `appdefaults`, `plugins` and
<literal>extraConfig</literal> configuration options. Consult `extraConfig` configuration options. Consult
<literal>man krb5.conf</literal> for documentation. `man krb5.conf` for documentation.
''; '';
}; };
@ -250,9 +250,9 @@ in {
type = with types; nullOr str; type = with types; nullOr str;
default = null; default = null;
example = "ATHENA.MIT.EDU"; example = "ATHENA.MIT.EDU";
description = '' description = lib.mdDoc ''
DEPRECATED, please use DEPRECATED, please use
<literal>krb5.libdefaults.default_realm</literal>. `krb5.libdefaults.default_realm`.
''; '';
}; };
@ -260,9 +260,9 @@ in {
type = with types; nullOr str; type = with types; nullOr str;
default = null; default = null;
example = "athena.mit.edu"; example = "athena.mit.edu";
description = '' description = lib.mdDoc ''
DEPRECATED, please create a map of server hostnames to Kerberos realms DEPRECATED, please create a map of server hostnames to Kerberos realms
in <literal>krb5.domain_realm</literal>. in `krb5.domain_realm`.
''; '';
}; };
@ -270,9 +270,9 @@ in {
type = with types; nullOr str; type = with types; nullOr str;
default = null; default = null;
example = "kerberos.mit.edu"; example = "kerberos.mit.edu";
description = '' description = lib.mdDoc ''
DEPRECATED, please pass a <literal>kdc</literal> attribute to a realm DEPRECATED, please pass a `kdc` attribute to a realm
in <literal>krb5.realms</literal>. in `krb5.realms`.
''; '';
}; };
@ -280,9 +280,9 @@ in {
type = with types; nullOr str; type = with types; nullOr str;
default = null; default = null;
example = "kerberos.mit.edu"; example = "kerberos.mit.edu";
description = '' description = lib.mdDoc ''
DEPRECATED, please pass an <literal>admin_server</literal> attribute DEPRECATED, please pass an `admin_server` attribute
to a realm in <literal>krb5.realms</literal>. to a realm in `krb5.realms`.
''; '';
}; };
}; };

40
nixos/modules/config/ldap.nix
View File

@ -64,34 +64,34 @@ in
loginPam = mkOption { loginPam = mkOption {
type = types.bool; type = types.bool;
default = true; default = true;
description = "Whether to include authentication against LDAP in login PAM."; description = lib.mdDoc "Whether to include authentication against LDAP in login PAM.";
}; };
nsswitch = mkOption { nsswitch = mkOption {
type = types.bool; type = types.bool;
default = true; default = true;
description = "Whether to include lookup against LDAP in NSS."; description = lib.mdDoc "Whether to include lookup against LDAP in NSS.";
}; };
server = mkOption { server = mkOption {
type = types.str; type = types.str;
example = "ldap://ldap.example.org/"; example = "ldap://ldap.example.org/";
description = "The URL of the LDAP server."; description = lib.mdDoc "The URL of the LDAP server.";
}; };
base = mkOption { base = mkOption {
type = types.str; type = types.str;
example = "dc=example,dc=org"; example = "dc=example,dc=org";
description = "The distinguished name of the search base."; description = lib.mdDoc "The distinguished name of the search base.";
}; };
useTLS = mkOption { useTLS = mkOption {
type = types.bool; type = types.bool;
default = false; default = false;
description = '' description = lib.mdDoc ''
If enabled, use TLS (encryption) over an LDAP (port 389) If enabled, use TLS (encryption) over an LDAP (port 389)
connection. The alternative is to specify an LDAPS server (port connection. The alternative is to specify an LDAPS server (port
636) in <option>users.ldap.server</option> or to forego 636) in {option}`users.ldap.server` or to forego
security. security.
''; '';
}; };
@ -99,7 +99,7 @@ in
timeLimit = mkOption { timeLimit = mkOption {
default = 0; default = 0;
type = types.int; type = types.int;
description = '' description = lib.mdDoc ''
Specifies the time limit (in seconds) to use when performing Specifies the time limit (in seconds) to use when performing
searches. A value of zero (0), which is the default, is to searches. A value of zero (0), which is the default, is to
wait indefinitely for searches to be completed. wait indefinitely for searches to be completed.
@ -110,7 +110,7 @@ in
enable = mkOption { enable = mkOption {
type = types.bool; type = types.bool;
default = false; default = false;
description = '' description = lib.mdDoc ''
Whether to let the nslcd daemon (nss-pam-ldapd) handle the Whether to let the nslcd daemon (nss-pam-ldapd) handle the
LDAP lookups for NSS and PAM. This can improve performance, LDAP lookups for NSS and PAM. This can improve performance,
and if you need to bind to the LDAP server with a password, and if you need to bind to the LDAP server with a password,
@ -125,9 +125,9 @@ in
extraConfig = mkOption { extraConfig = mkOption {
default = ""; default = "";
type = types.lines; type = types.lines;
description = '' description = lib.mdDoc ''
Extra configuration options that will be added verbatim at Extra configuration options that will be added verbatim at
the end of the nslcd configuration file (<literal>nslcd.conf(5)</literal>). the end of the nslcd configuration file (`nslcd.conf(5)`).
'' ; '' ;
} ; } ;
@ -135,7 +135,7 @@ in
default = ""; default = "";
example = "cn=admin,dc=example,dc=com"; example = "cn=admin,dc=example,dc=com";
type = types.str; type = types.str;
description = '' description = lib.mdDoc ''
The distinguished name to use to bind to the LDAP server The distinguished name to use to bind to the LDAP server
when the root user tries to modify a user's password. when the root user tries to modify a user's password.
''; '';
@ -145,7 +145,7 @@ in
default = ""; default = "";
example = "/run/keys/nslcd.rootpwmodpw"; example = "/run/keys/nslcd.rootpwmodpw";
type = types.str; type = types.str;
description = '' description = lib.mdDoc ''
The path to a file containing the credentials with which to bind to The path to a file containing the credentials with which to bind to
the LDAP server if the root user tries to change a user's password. the LDAP server if the root user tries to change a user's password.
''; '';
@ -157,7 +157,7 @@ in
default = ""; default = "";
example = "cn=admin,dc=example,dc=com"; example = "cn=admin,dc=example,dc=com";
type = types.str; type = types.str;
description = '' description = lib.mdDoc ''
The distinguished name to bind to the LDAP server with. If this The distinguished name to bind to the LDAP server with. If this
is not specified, an anonymous bind will be done. is not specified, an anonymous bind will be done.
''; '';
@ -166,7 +166,7 @@ in
passwordFile = mkOption { passwordFile = mkOption {
default = "/etc/ldap/bind.password"; default = "/etc/ldap/bind.password";
type = types.str; type = types.str;
description = '' description = lib.mdDoc ''
The path to a file containing the credentials to use when binding The path to a file containing the credentials to use when binding
to the LDAP server (if not binding anonymously). to the LDAP server (if not binding anonymously).
''; '';
@ -175,10 +175,10 @@ in
timeLimit = mkOption { timeLimit = mkOption {
default = 30; default = 30;
type = types.int; type = types.int;
description = '' description = lib.mdDoc ''
Specifies the time limit (in seconds) to use when connecting Specifies the time limit (in seconds) to use when connecting
to the directory server. This is distinct from the time limit to the directory server. This is distinct from the time limit
specified in <option>users.ldap.timeLimit</option> and affects specified in {option}`users.ldap.timeLimit` and affects
the initial server connection only. the initial server connection only.
''; '';
}; };
@ -205,12 +205,12 @@ in
extraConfig = mkOption { extraConfig = mkOption {
default = ""; default = "";
type = types.lines; type = types.lines;
description = '' description = lib.mdDoc ''
Extra configuration options that will be added verbatim at Extra configuration options that will be added verbatim at
the end of the ldap configuration file (<literal>ldap.conf(5)</literal>). the end of the ldap configuration file (`ldap.conf(5)`).
If <option>users.ldap.daemon</option> is enabled, this If {option}`users.ldap.daemon` is enabled, this
configuration will not be used. In that case, use configuration will not be used. In that case, use
<option>users.ldap.daemon.extraConfig</option> instead. {option}`users.ldap.daemon.extraConfig` instead.
'' ; '' ;
}; };

28
nixos/modules/config/networking.nix
View File

@ -28,7 +28,7 @@ in
"192.168.0.2" = [ "fileserver.local" "nameserver.local" ]; "192.168.0.2" = [ "fileserver.local" "nameserver.local" ];
}; };
''; '';
description = '' description = lib.mdDoc ''
Locally defined maps of hostnames to IP addresses. Locally defined maps of hostnames to IP addresses.
''; '';
}; };
@ -37,8 +37,8 @@ in
type = types.listOf types.path; type = types.listOf types.path;
defaultText = literalDocBook "Hosts from <option>networking.hosts</option> and <option>networking.extraHosts</option>"; defaultText = literalDocBook "Hosts from <option>networking.hosts</option> and <option>networking.extraHosts</option>";
example = literalExpression ''[ "''${pkgs.my-blocklist-package}/share/my-blocklist/hosts" ]''; example = literalExpression ''[ "''${pkgs.my-blocklist-package}/share/my-blocklist/hosts" ]'';
description = '' description = lib.mdDoc ''
Files that should be concatenated together to form <filename>/etc/hosts</filename>. Files that should be concatenated together to form {file}`/etc/hosts`.
''; '';
}; };
@ -46,9 +46,9 @@ in
type = types.lines; type = types.lines;
default = ""; default = "";
example = "192.168.0.1 lanlocalhost"; example = "192.168.0.1 lanlocalhost";
description = '' description = lib.mdDoc ''
Additional verbatim entries to be appended to <filename>/etc/hosts</filename>. Additional verbatim entries to be appended to {file}`/etc/hosts`.
For adding hosts from derivation results, use <option>networking.hostFiles</option> instead. For adding hosts from derivation results, use {option}`networking.hostFiles` instead.
''; '';
}; };
@ -60,7 +60,7 @@ in
"3.nixos.pool.ntp.org" "3.nixos.pool.ntp.org"
]; ];
type = types.listOf types.str; type = types.listOf types.str;
description = '' description = lib.mdDoc ''
The set of NTP servers from which to synchronise. The set of NTP servers from which to synchronise.
''; '';
}; };
@ -70,7 +70,7 @@ in
default = lib.mkOption { default = lib.mkOption {
type = types.nullOr types.str; type = types.nullOr types.str;
default = null; default = null;
description = '' description = lib.mdDoc ''
This option specifies the default value for httpProxy, httpsProxy, ftpProxy and rsyncProxy. This option specifies the default value for httpProxy, httpsProxy, ftpProxy and rsyncProxy.
''; '';
example = "http://127.0.0.1:3128"; example = "http://127.0.0.1:3128";
@ -80,7 +80,7 @@ in
type = types.nullOr types.str; type = types.nullOr types.str;
default = cfg.proxy.default; default = cfg.proxy.default;
defaultText = literalExpression "config.${opt.proxy.default}"; defaultText = literalExpression "config.${opt.proxy.default}";
description = '' description = lib.mdDoc ''
This option specifies the http_proxy environment variable. This option specifies the http_proxy environment variable.
''; '';
example = "http://127.0.0.1:3128"; example = "http://127.0.0.1:3128";
@ -90,7 +90,7 @@ in
type = types.nullOr types.str; type = types.nullOr types.str;
default = cfg.proxy.default; default = cfg.proxy.default;
defaultText = literalExpression "config.${opt.proxy.default}"; defaultText = literalExpression "config.${opt.proxy.default}";
description = '' description = lib.mdDoc ''
This option specifies the https_proxy environment variable. This option specifies the https_proxy environment variable.
''; '';
example = "http://127.0.0.1:3128"; example = "http://127.0.0.1:3128";
@ -100,7 +100,7 @@ in
type = types.nullOr types.str; type = types.nullOr types.str;
default = cfg.proxy.default; default = cfg.proxy.default;
defaultText = literalExpression "config.${opt.proxy.default}"; defaultText = literalExpression "config.${opt.proxy.default}";
description = '' description = lib.mdDoc ''
This option specifies the ftp_proxy environment variable. This option specifies the ftp_proxy environment variable.
''; '';
example = "http://127.0.0.1:3128"; example = "http://127.0.0.1:3128";
@ -110,7 +110,7 @@ in
type = types.nullOr types.str; type = types.nullOr types.str;
default = cfg.proxy.default; default = cfg.proxy.default;
defaultText = literalExpression "config.${opt.proxy.default}"; defaultText = literalExpression "config.${opt.proxy.default}";
description = '' description = lib.mdDoc ''
This option specifies the rsync_proxy environment variable. This option specifies the rsync_proxy environment variable.
''; '';
example = "http://127.0.0.1:3128"; example = "http://127.0.0.1:3128";
@ -120,7 +120,7 @@ in
type = types.nullOr types.str; type = types.nullOr types.str;
default = cfg.proxy.default; default = cfg.proxy.default;
defaultText = literalExpression "config.${opt.proxy.default}"; defaultText = literalExpression "config.${opt.proxy.default}";
description = '' description = lib.mdDoc ''
This option specifies the all_proxy environment variable. This option specifies the all_proxy environment variable.
''; '';
example = "http://127.0.0.1:3128"; example = "http://127.0.0.1:3128";
@ -129,7 +129,7 @@ in
noProxy = lib.mkOption { noProxy = lib.mkOption {
type = types.nullOr types.str; type = types.nullOr types.str;
default = null; default = null;
description = '' description = lib.mdDoc ''
This option specifies the no_proxy environment variable. This option specifies the no_proxy environment variable.
If a default proxy is used and noProxy is null, If a default proxy is used and noProxy is null,
then noProxy will be set to 127.0.0.1,localhost. then noProxy will be set to 127.0.0.1,localhost.

2
nixos/modules/config/no-x-libs.nix
View File

@ -10,7 +10,7 @@ with lib;
environment.noXlibs = mkOption { environment.noXlibs = mkOption {
type = types.bool; type = types.bool;
default = false; default = false;
description = '' description = lib.mdDoc ''
Switch off the options in the default configuration that Switch off the options in the default configuration that
require X11 libraries. This includes client-side font require X11 libraries. This includes client-side font
configuration and SSH forwarding of X11 authentication configuration and SSH forwarding of X11 authentication

8
nixos/modules/config/power-management.nix
View File

@ -20,7 +20,7 @@ in
type = types.bool; type = types.bool;
default = true; default = true;
description = description =
'' lib.mdDoc ''
Whether to enable power management. This includes support Whether to enable power management. This includes support
for suspend-to-RAM and powersave features on laptops. for suspend-to-RAM and powersave features on laptops.
''; '';
@ -29,7 +29,7 @@ in
resumeCommands = mkOption { resumeCommands = mkOption {
type = types.lines; type = types.lines;
default = ""; default = "";
description = "Commands executed after the system resumes from suspend-to-RAM."; description = lib.mdDoc "Commands executed after the system resumes from suspend-to-RAM.";
}; };
powerUpCommands = mkOption { powerUpCommands = mkOption {
@ -39,7 +39,7 @@ in
"''${pkgs.hdparm}/sbin/hdparm -B 255 /dev/sda" "''${pkgs.hdparm}/sbin/hdparm -B 255 /dev/sda"
''; '';
description = description =
'' lib.mdDoc ''
Commands executed when the machine powers up. That is, Commands executed when the machine powers up. That is,
they're executed both when the system first boots and when they're executed both when the system first boots and when
it resumes from suspend or hibernation. it resumes from suspend or hibernation.
@ -53,7 +53,7 @@ in
"''${pkgs.hdparm}/sbin/hdparm -B 255 /dev/sda" "''${pkgs.hdparm}/sbin/hdparm -B 255 /dev/sda"
''; '';
description = description =
'' lib.mdDoc ''
Commands executed when the machine powers down. That is, Commands executed when the machine powers down. That is,
they're executed both when the system shuts down and when they're executed both when the system shuts down and when
it goes to suspend or hibernation. it goes to suspend or hibernation.

20
nixos/modules/config/resolvconf.nix
View File

@ -49,7 +49,7 @@ in
type = types.bool; type = types.bool;
default = !(config.environment.etc ? "resolv.conf"); default = !(config.environment.etc ? "resolv.conf");
defaultText = literalExpression ''!(config.environment.etc ? "resolv.conf")''; defaultText = literalExpression ''!(config.environment.etc ? "resolv.conf")'';
description = '' description = lib.mdDoc ''
Whether DNS configuration is managed by resolvconf. Whether DNS configuration is managed by resolvconf.
''; '';
}; };
@ -58,9 +58,9 @@ in
type = types.package; type = types.package;
default = pkgs.openresolv; default = pkgs.openresolv;
defaultText = literalExpression "pkgs.openresolv"; defaultText = literalExpression "pkgs.openresolv";
description = '' description = lib.mdDoc ''
The package that provides the system-wide resolvconf command. Defaults to <literal>openresolv</literal> The package that provides the system-wide resolvconf command. Defaults to `openresolv`
if this module is enabled. Otherwise, can be used by other modules (for example <option>services.resolved</option>) to if this module is enabled. Otherwise, can be used by other modules (for example {option}`services.resolved`) to
provide a compatibility layer. provide a compatibility layer.
This option generally shouldn't be set by the user. This option generally shouldn't be set by the user.
@ -70,7 +70,7 @@ in
dnsSingleRequest = lib.mkOption { dnsSingleRequest = lib.mkOption {
type = types.bool; type = types.bool;
default = false; default = false;
description = '' description = lib.mdDoc ''
Recent versions of glibc will issue both ipv4 (A) and ipv6 (AAAA) Recent versions of glibc will issue both ipv4 (A) and ipv6 (AAAA)
address queries at the same time, from the same port. Sometimes upstream address queries at the same time, from the same port. Sometimes upstream
routers will systemically drop the ipv4 queries. The symptom of this problem is routers will systemically drop the ipv4 queries. The symptom of this problem is
@ -95,8 +95,8 @@ in
type = types.lines; type = types.lines;
default = ""; default = "";
example = "libc=NO"; example = "libc=NO";
description = '' description = lib.mdDoc ''
Extra configuration to append to <filename>resolvconf.conf</filename>. Extra configuration to append to {file}`resolvconf.conf`.
''; '';
}; };
@ -104,15 +104,15 @@ in
type = types.listOf types.str; type = types.listOf types.str;
default = []; default = [];
example = [ "ndots:1" "rotate" ]; example = [ "ndots:1" "rotate" ];
description = '' description = lib.mdDoc ''
Set the options in <filename>/etc/resolv.conf</filename>. Set the options in {file}`/etc/resolv.conf`.
''; '';
}; };
useLocalResolver = mkOption { useLocalResolver = mkOption {
type = types.bool; type = types.bool;
default = false; default = false;
description = '' description = lib.mdDoc ''
Use local DNS server for resolving. Use local DNS server for resolving.
''; '';
}; };

24
nixos/modules/config/shells-environment.nix
View File

@ -35,7 +35,7 @@ in
environment.variables = mkOption { environment.variables = mkOption {
default = {}; default = {};
example = { EDITOR = "nvim"; VISUAL = "nvim"; }; example = { EDITOR = "nvim"; VISUAL = "nvim"; };
description = '' description = lib.mdDoc ''
A set of environment variables used in the global environment. A set of environment variables used in the global environment.
These variables will be set on shell initialisation (e.g. in /etc/profile). These variables will be set on shell initialisation (e.g. in /etc/profile).
The value of each variable can be either a string or a list of The value of each variable can be either a string or a list of
@ -48,7 +48,7 @@ in
environment.profiles = mkOption { environment.profiles = mkOption {
default = []; default = [];
description = '' description = lib.mdDoc ''
A list of profiles used to setup the global environment. A list of profiles used to setup the global environment.
''; '';
type = types.listOf types.str; type = types.listOf types.str;
@ -57,10 +57,10 @@ in
environment.profileRelativeEnvVars = mkOption { environment.profileRelativeEnvVars = mkOption {
type = types.attrsOf (types.listOf types.str); type = types.attrsOf (types.listOf types.str);
example = { PATH = [ "/bin" ]; MANPATH = [ "/man" "/share/man" ]; }; example = { PATH = [ "/bin" ]; MANPATH = [ "/man" "/share/man" ]; };
description = '' description = lib.mdDoc ''
Attribute set of environment variable. Each attribute maps to a list Attribute set of environment variable. Each attribute maps to a list
of relative paths. Each relative path is appended to the each profile of relative paths. Each relative path is appended to the each profile
of <option>environment.profiles</option> to form the content of the of {option}`environment.profiles` to form the content of the
corresponding environment variable. corresponding environment variable.
''; '';
}; };
@ -68,7 +68,7 @@ in
# !!! isn't there a better way? # !!! isn't there a better way?
environment.extraInit = mkOption { environment.extraInit = mkOption {
default = ""; default = "";
description = '' description = lib.mdDoc ''
Shell script code called during global environment initialisation Shell script code called during global environment initialisation
after all variables and profileVariables have been set. after all variables and profileVariables have been set.
This code is assumed to be shell-independent, which means you should This code is assumed to be shell-independent, which means you should
@ -79,7 +79,7 @@ in
environment.shellInit = mkOption { environment.shellInit = mkOption {
default = ""; default = "";
description = '' description = lib.mdDoc ''
Shell script code called during shell initialisation. Shell script code called during shell initialisation.
This code is assumed to be shell-independent, which means you should This code is assumed to be shell-independent, which means you should
stick to pure sh without sh word split. stick to pure sh without sh word split.
@ -89,7 +89,7 @@ in
environment.loginShellInit = mkOption { environment.loginShellInit = mkOption {
default = ""; default = "";
description = '' description = lib.mdDoc ''
Shell script code called during login shell initialisation. Shell script code called during login shell initialisation.
This code is assumed to be shell-independent, which means you should This code is assumed to be shell-independent, which means you should
stick to pure sh without sh word split. stick to pure sh without sh word split.
@ -99,7 +99,7 @@ in
environment.interactiveShellInit = mkOption { environment.interactiveShellInit = mkOption {
default = ""; default = "";
description = '' description = lib.mdDoc ''
Shell script code called during interactive shell initialisation. Shell script code called during interactive shell initialisation.
This code is assumed to be shell-independent, which means you should This code is assumed to be shell-independent, which means you should
stick to pure sh without sh word split. stick to pure sh without sh word split.
@ -119,7 +119,7 @@ in
}; };
environment.homeBinInPath = mkOption { environment.homeBinInPath = mkOption {
description = '' description = lib.mdDoc ''
Include ~/bin/ in $PATH. Include ~/bin/ in $PATH.
''; '';
default = false; default = false;
@ -127,7 +127,7 @@ in
}; };
environment.localBinInPath = mkOption { environment.localBinInPath = mkOption {
description = '' description = lib.mdDoc ''
Add ~/.local/bin/ to $PATH Add ~/.local/bin/ to $PATH
''; '';
default = false; default = false;
@ -151,9 +151,9 @@ in
environment.shells = mkOption { environment.shells = mkOption {
default = []; default = [];
example = literalExpression "[ pkgs.bashInteractive pkgs.zsh ]"; example = literalExpression "[ pkgs.bashInteractive pkgs.zsh ]";
description = '' description = lib.mdDoc ''
A list of permissible login shells for user accounts. A list of permissible login shells for user accounts.
No need to mention <literal>/bin/sh</literal> No need to mention `/bin/sh`
here, it is placed into this list implicitly. here, it is placed into this list implicitly.
''; '';
type = types.listOf (types.either types.shellPackage types.path); type = types.listOf (types.either types.shellPackage types.path);

30
nixos/modules/config/swap.nix
View File

@ -14,7 +14,7 @@ let
enable = mkOption { enable = mkOption {
default = false; default = false;
type = types.bool; type = types.bool;
description = '' description = lib.mdDoc ''
Encrypt swap device with a random key. This way you won't have a persistent swap device. Encrypt swap device with a random key. This way you won't have a persistent swap device.
WARNING: Don't try to hibernate when you have at least one swap partition with WARNING: Don't try to hibernate when you have at least one swap partition with
@ -31,7 +31,7 @@ let
default = "aes-xts-plain64"; default = "aes-xts-plain64";
example = "serpent-xts-plain64"; example = "serpent-xts-plain64";
type = types.str; type = types.str;
description = '' description = lib.mdDoc ''
Use specified cipher for randomEncryption. Use specified cipher for randomEncryption.
Hint: Run "cryptsetup benchmark" to see which one is fastest on your machine. Hint: Run "cryptsetup benchmark" to see which one is fastest on your machine.
@ -42,7 +42,7 @@ let
default = "/dev/urandom"; default = "/dev/urandom";
example = "/dev/random"; example = "/dev/random";
type = types.str; type = types.str;
description = '' description = lib.mdDoc ''
Define the source of randomness to obtain a random key for encryption. Define the source of randomness to obtain a random key for encryption.
''; '';
}; };
@ -50,7 +50,7 @@ let
allowDiscards = mkOption { allowDiscards = mkOption {
default = false; default = false;
type = types.bool; type = types.bool;
description = '' description = lib.mdDoc ''
Whether to allow TRIM requests to the underlying device. This option Whether to allow TRIM requests to the underlying device. This option
has security implications; please read the LUKS documentation before has security implications; please read the LUKS documentation before
activating it. activating it.
@ -67,7 +67,7 @@ let
device = mkOption { device = mkOption {
example = "/dev/sda3"; example = "/dev/sda3";
type = types.str; type = types.str;
description = "Path of the device or swap file."; description = lib.mdDoc "Path of the device or swap file.";
}; };
label = mkOption { label = mkOption {
@ -82,7 +82,7 @@ let
default = null; default = null;
example = 2048; example = 2048;
type = types.nullOr types.int; type = types.nullOr types.int;
description = '' description = lib.mdDoc ''
If this option is set, ‘device’ is interpreted as the If this option is set, ‘device’ is interpreted as the
path of a swapfile that will be created automatically path of a swapfile that will be created automatically
with the indicated size (in megabytes). with the indicated size (in megabytes).
@ -93,7 +93,7 @@ let
default = null; default = null;
example = 2048; example = 2048;
type = types.nullOr types.int; type = types.nullOr types.int;
description = '' description = lib.mdDoc ''
Specify the priority of the swap device. Priority is a value between 0 and 32767. Specify the priority of the swap device. Priority is a value between 0 and 32767.
Higher numbers indicate higher priority. Higher numbers indicate higher priority.
null lets the kernel choose a priority, which will show up as a negative value. null lets the kernel choose a priority, which will show up as a negative value.
@ -108,7 +108,7 @@ let
source = "/dev/random"; source = "/dev/random";
}; };
type = types.coercedTo types.bool randomEncryptionCoerce (types.submodule randomEncryptionOpts); type = types.coercedTo types.bool randomEncryptionCoerce (types.submodule randomEncryptionOpts);
description = '' description = lib.mdDoc ''
Encrypt swap device with a random key. This way you won't have a persistent swap device. Encrypt swap device with a random key. This way you won't have a persistent swap device.
HINT: run "cryptsetup benchmark" to test cipher performance on your machine. HINT: run "cryptsetup benchmark" to test cipher performance on your machine.
@ -127,7 +127,7 @@ let
default = null; default = null;
example = "once"; example = "once";
type = types.nullOr (types.enum ["once" "pages" "both" ]); type = types.nullOr (types.enum ["once" "pages" "both" ]);
description = '' description = lib.mdDoc ''
Specify the discard policy for the swap device. If "once", then the Specify the discard policy for the swap device. If "once", then the
whole swap space is discarded at swapon invocation. If "pages", whole swap space is discarded at swapon invocation. If "pages",
asynchronous discard on freed pages is performed, before returning to asynchronous discard on freed pages is performed, before returning to
@ -140,7 +140,7 @@ let
default = [ "defaults" ]; default = [ "defaults" ];
example = [ "nofail" ]; example = [ "nofail" ];
type = types.listOf types.nonEmptyStr; type = types.listOf types.nonEmptyStr;
description = '' description = lib.mdDoc ''
Options used to mount the swap. Options used to mount the swap.
''; '';
}; };
@ -181,13 +181,13 @@ in
{ device = "/var/swapfile"; } { device = "/var/swapfile"; }
{ label = "bigswap"; } { label = "bigswap"; }
]; ];
description = '' description = lib.mdDoc ''
The swap devices and swap files. These must have been The swap devices and swap files. These must have been
initialised using <command>mkswap</command>. Each element initialised using {command}`mkswap`. Each element
should be an attribute set specifying either the path of the should be an attribute set specifying either the path of the
swap device or file (<literal>device</literal>) or the label swap device or file (`device`) or the label
of the swap device (<literal>label</literal>, see of the swap device (`label`, see
<command>mkswap -L</command>). Using a label is {command}`mkswap -L`). Using a label is
recommended. recommended.
''; '';

10
nixos/modules/config/system-path.nix
View File

@ -64,14 +64,14 @@ in
type = types.listOf types.package; type = types.listOf types.package;
default = []; default = [];
example = literalExpression "[ pkgs.firefox pkgs.thunderbird ]"; example = literalExpression "[ pkgs.firefox pkgs.thunderbird ]";
description = '' description = lib.mdDoc ''
The set of packages that appear in The set of packages that appear in
/run/current-system/sw. These packages are /run/current-system/sw. These packages are
automatically available to all users, and are automatically available to all users, and are
automatically updated every time you rebuild the system automatically updated every time you rebuild the system
configuration. (The latter is the main difference with configuration. (The latter is the main difference with
installing them in the default profile, installing them in the default profile,
<filename>/nix/var/nix/profiles/default</filename>. {file}`/nix/var/nix/profiles/default`.
''; '';
}; };
@ -109,20 +109,20 @@ in
# to work. # to work.
default = []; default = [];
example = ["/"]; example = ["/"];
description = "List of directories to be symlinked in <filename>/run/current-system/sw</filename>."; description = lib.mdDoc "List of directories to be symlinked in {file}`/run/current-system/sw`.";
}; };
extraOutputsToInstall = mkOption { extraOutputsToInstall = mkOption {
type = types.listOf types.str; type = types.listOf types.str;
default = [ ]; default = [ ];
example = [ "doc" "info" "devdoc" ]; example = [ "doc" "info" "devdoc" ];
description = "List of additional package outputs to be symlinked into <filename>/run/current-system/sw</filename>."; description = lib.mdDoc "List of additional package outputs to be symlinked into {file}`/run/current-system/sw`.";
}; };
extraSetup = mkOption { extraSetup = mkOption {
type = types.lines; type = types.lines;
default = ""; default = "";
description = "Shell fragments to be run after the system environment has been created. This should only be used for things that need to modify the internals of the environment, e.g. generating MIME caches. The environment being built can be accessed at $out."; description = lib.mdDoc "Shell fragments to be run after the system environment has been created. This should only be used for things that need to modify the internals of the environment, e.g. generating MIME caches. The environment being built can be accessed at $out.";
}; };
}; };

2
nixos/modules/config/terminfo.nix
View File

@ -9,7 +9,7 @@ with lib;
options.environment.enableAllTerminfo = with lib; mkOption { options.environment.enableAllTerminfo = with lib; mkOption {
default = false; default = false;
type = types.bool; type = types.bool;
description = '' description = lib.mdDoc ''
Whether to install all terminfo outputs Whether to install all terminfo outputs
''; '';
}; };

86
nixos/modules/config/users-groups.nix
View File

@ -56,7 +56,7 @@ let
name = mkOption { name = mkOption {
type = types.passwdEntry types.str; type = types.passwdEntry types.str;
apply = x: assert (builtins.stringLength x < 32 || abort "Username '${x}' is longer than 31 characters which is not allowed!"); x; apply = x: assert (builtins.stringLength x < 32 || abort "Username '${x}' is longer than 31 characters which is not allowed!"); x;
description = '' description = lib.mdDoc ''
The name of the user account. If undefined, the name of the The name of the user account. If undefined, the name of the
attribute set will be used. attribute set will be used.
''; '';
@ -66,17 +66,17 @@ let
type = types.passwdEntry types.str; type = types.passwdEntry types.str;
default = ""; default = "";
example = "Alice Q. User"; example = "Alice Q. User";
description = '' description = lib.mdDoc ''
A short description of the user account, typically the A short description of the user account, typically the
user's full name. This is actually the “GECOS” or “comment” user's full name. This is actually the “GECOS” or “comment”
field in <filename>/etc/passwd</filename>. field in {file}`/etc/passwd`.
''; '';
}; };
uid = mkOption { uid = mkOption {
type = with types; nullOr int; type = with types; nullOr int;
default = null; default = null;
description = '' description = lib.mdDoc ''
The account UID. If the UID is null, a free UID is picked on The account UID. If the UID is null, a free UID is picked on
activation. activation.
''; '';
@ -85,15 +85,15 @@ let
isSystemUser = mkOption { isSystemUser = mkOption {
type = types.bool; type = types.bool;
default = false; default = false;
description = '' description = lib.mdDoc ''
Indicates if the user is a system user or not. This option Indicates if the user is a system user or not. This option
only has an effect if <option>uid</option> is only has an effect if {option}`uid` is
<option>null</option>, in which case it determines whether {option}`null`, in which case it determines whether
the user's UID is allocated in the range for system users the user's UID is allocated in the range for system users
(below 500) or in the range for normal users (starting at (below 500) or in the range for normal users (starting at
1000). 1000).
Exactly one of <literal>isNormalUser</literal> and Exactly one of `isNormalUser` and
<literal>isSystemUser</literal> must be true. `isSystemUser` must be true.
''; '';
}; };
@ -118,31 +118,31 @@ let
type = types.str; type = types.str;
apply = x: assert (builtins.stringLength x < 32 || abort "Group name '${x}' is longer than 31 characters which is not allowed!"); x; apply = x: assert (builtins.stringLength x < 32 || abort "Group name '${x}' is longer than 31 characters which is not allowed!"); x;
default = ""; default = "";
description = "The user's primary group."; description = lib.mdDoc "The user's primary group.";
}; };
extraGroups = mkOption { extraGroups = mkOption {
type = types.listOf types.str; type = types.listOf types.str;
default = []; default = [];
description = "The user's auxiliary groups."; description = lib.mdDoc "The user's auxiliary groups.";
}; };
home = mkOption { home = mkOption {
type = types.passwdEntry types.path; type = types.passwdEntry types.path;
default = "/var/empty"; default = "/var/empty";
description = "The user's home directory."; description = lib.mdDoc "The user's home directory.";
}; };
homeMode = mkOption { homeMode = mkOption {
type = types.strMatching "[0-7]{1,5}"; type = types.strMatching "[0-7]{1,5}";
default = "700"; default = "700";
description = "The user's home directory mode in numeric format. See chmod(1). The mode is only applied if <option>users.users.&lt;name&gt;.createHome</option> is true."; description = lib.mdDoc "The user's home directory mode in numeric format. See chmod(1). The mode is only applied if {option}`users.users.<name>.createHome` is true.";
}; };
cryptHomeLuks = mkOption { cryptHomeLuks = mkOption {
type = with types; nullOr str; type = with types; nullOr str;
default = null; default = null;
description = '' description = lib.mdDoc ''
Path to encrypted luks device that contains Path to encrypted luks device that contains
the user's home directory. the user's home directory.
''; '';
@ -183,10 +183,10 @@ let
{ startUid = 1000; count = 1; } { startUid = 1000; count = 1; }
{ startUid = 100001; count = 65534; } { startUid = 100001; count = 65534; }
]; ];
description = '' description = lib.mdDoc ''
Subordinate user ids that user is allowed to use. Subordinate user ids that user is allowed to use.
They are set into <filename>/etc/subuid</filename> and are used They are set into {file}`/etc/subuid` and are used
by <literal>newuidmap</literal> for user namespaces. by `newuidmap` for user namespaces.
''; '';
}; };
@ -197,10 +197,10 @@ let
{ startGid = 100; count = 1; } { startGid = 100; count = 1; }
{ startGid = 1001; count = 999; } { startGid = 1001; count = 999; }
]; ];
description = '' description = lib.mdDoc ''
Subordinate group ids that user is allowed to use. Subordinate group ids that user is allowed to use.
They are set into <filename>/etc/subgid</filename> and are used They are set into {file}`/etc/subgid` and are used
by <literal>newgidmap</literal> for user namespaces. by `newgidmap` for user namespaces.
''; '';
}; };
@ -208,7 +208,7 @@ let
type = types.bool; type = types.bool;
default = false; default = false;
example = true; example = true;
description = '' description = lib.mdDoc ''
Automatically allocate subordinate user and group ids for this user. Automatically allocate subordinate user and group ids for this user.
Allocated range is currently always of size 65536. Allocated range is currently always of size 65536.
''; '';
@ -217,7 +217,7 @@ let
createHome = mkOption { createHome = mkOption {
type = types.bool; type = types.bool;
default = false; default = false;
description = '' description = lib.mdDoc ''
Whether to create the home directory and ensure ownership as well as Whether to create the home directory and ensure ownership as well as
permissions to match the user. permissions to match the user.
''; '';
@ -226,9 +226,9 @@ let
useDefaultShell = mkOption { useDefaultShell = mkOption {
type = types.bool; type = types.bool;
default = false; default = false;
description = '' description = lib.mdDoc ''
If true, the user's shell will be set to If true, the user's shell will be set to
<option>users.defaultUserShell</option>. {option}`users.defaultUserShell`.
''; '';
}; };
@ -284,13 +284,13 @@ let
initialPassword = mkOption { initialPassword = mkOption {
type = with types; nullOr str; type = with types; nullOr str;
default = null; default = null;
description = '' description = lib.mdDoc ''
Specifies the initial password for the user, i.e. the Specifies the initial password for the user, i.e. the
password assigned if the user does not already exist. If password assigned if the user does not already exist. If
<option>users.mutableUsers</option> is true, the password {option}`users.mutableUsers` is true, the password
can be changed subsequently using the can be changed subsequently using the
<command>passwd</command> command. Otherwise, it's {command}`passwd` command. Otherwise, it's
equivalent to setting the <option>password</option> equivalent to setting the {option}`password`
option. The same caveat applies: the password specified here option. The same caveat applies: the password specified here
is world-readable in the Nix store, so it should only be is world-readable in the Nix store, so it should only be
used for guest accounts or passwords that will be changed used for guest accounts or passwords that will be changed
@ -302,9 +302,9 @@ let
type = types.listOf types.package; type = types.listOf types.package;
default = []; default = [];
example = literalExpression "[ pkgs.firefox pkgs.thunderbird ]"; example = literalExpression "[ pkgs.firefox pkgs.thunderbird ]";
description = '' description = lib.mdDoc ''
The set of packages that should be made available to the user. The set of packages that should be made available to the user.
This is in contrast to <option>environment.systemPackages</option>, This is in contrast to {option}`environment.systemPackages`,
which adds packages to all users. which adds packages to all users.
''; '';
}; };
@ -344,7 +344,7 @@ let
name = mkOption { name = mkOption {
type = types.passwdEntry types.str; type = types.passwdEntry types.str;
description = '' description = lib.mdDoc ''
The name of the group. If undefined, the name of the attribute set The name of the group. If undefined, the name of the attribute set
will be used. will be used.
''; '';
@ -353,7 +353,7 @@ let
gid = mkOption { gid = mkOption {
type = with types; nullOr int; type = with types; nullOr int;
default = null; default = null;
description = '' description = lib.mdDoc ''
The group GID. If the GID is null, a free GID is picked on The group GID. If the GID is null, a free GID is picked on
activation. activation.
''; '';
@ -362,9 +362,9 @@ let
members = mkOption { members = mkOption {
type = with types; listOf (passwdEntry str); type = with types; listOf (passwdEntry str);
default = []; default = [];
description = '' description = lib.mdDoc ''
The user names of the group members, added to the The user names of the group members, added to the
<literal>/etc/group</literal> file. `/etc/group` file.
''; '';
}; };
@ -384,7 +384,7 @@ let
options = { options = {
startUid = mkOption { startUid = mkOption {
type = types.int; type = types.int;
description = '' description = lib.mdDoc ''
Start of the range of subordinate user ids that user is Start of the range of subordinate user ids that user is
allowed to use. allowed to use.
''; '';
@ -392,7 +392,7 @@ let
count = mkOption { count = mkOption {
type = types.int; type = types.int;
default = 1; default = 1;
description = "Count of subordinate user ids"; description = lib.mdDoc "Count of subordinate user ids";
}; };
}; };
}; };
@ -401,7 +401,7 @@ let
options = { options = {
startGid = mkOption { startGid = mkOption {
type = types.int; type = types.int;
description = '' description = lib.mdDoc ''
Start of the range of subordinate group ids that user is Start of the range of subordinate group ids that user is
allowed to use. allowed to use.
''; '';
@ -409,7 +409,7 @@ let
count = mkOption { count = mkOption {
type = types.int; type = types.int;
default = 1; default = 1;
description = "Count of subordinate group ids"; description = lib.mdDoc "Count of subordinate group ids";
}; };
}; };
}; };
@ -484,7 +484,7 @@ in {
users.enforceIdUniqueness = mkOption { users.enforceIdUniqueness = mkOption {
type = types.bool; type = types.bool;
default = true; default = true;
description = '' description = lib.mdDoc ''
Whether to require that no two users/groups share the same uid/gid. Whether to require that no two users/groups share the same uid/gid.
''; '';
}; };
@ -503,7 +503,7 @@ in {
shell = "/bin/sh"; shell = "/bin/sh";
}; };
}; };
description = '' description = lib.mdDoc ''
Additional user accounts to be created automatically by the system. Additional user accounts to be created automatically by the system.
This can also be used to set options for root. This can also be used to set options for root.
''; '';
@ -516,7 +516,7 @@ in {
hackers = { }; hackers = { };
}; };
type = with types; attrsOf (submodule groupOpts); type = with types; attrsOf (submodule groupOpts);
description = '' description = lib.mdDoc ''
Additional groups to be created automatically by the system. Additional groups to be created automatically by the system.
''; '';
}; };
@ -525,8 +525,8 @@ in {
users.allowNoPasswordLogin = mkOption { users.allowNoPasswordLogin = mkOption {
type = types.bool; type = types.bool;
default = false; default = false;
description = '' description = lib.mdDoc ''
Disable checking that at least the <literal>root</literal> user or a user in the <literal>wheel</literal> group can log in using Disable checking that at least the `root` user or a user in the `wheel` group can log in using
a password or an SSH key. a password or an SSH key.
WARNING: enabling this can lock you out of your system. Enable this only if you know what are you doing. WARNING: enabling this can lock you out of your system. Enable this only if you know what are you doing.

4
nixos/modules/config/vte.nix
View File

@ -25,7 +25,7 @@ in
programs.bash.vteIntegration = mkOption { programs.bash.vteIntegration = mkOption {
default = false; default = false;
type = types.bool; type = types.bool;
description = '' description = lib.mdDoc ''
Whether to enable Bash integration for VTE terminals. Whether to enable Bash integration for VTE terminals.
This allows it to preserve the current directory of the shell This allows it to preserve the current directory of the shell
across terminals. across terminals.
@ -35,7 +35,7 @@ in
programs.zsh.vteIntegration = mkOption { programs.zsh.vteIntegration = mkOption {
default = false; default = false;
type = types.bool; type = types.bool;
description = '' description = lib.mdDoc ''
Whether to enable Zsh integration for VTE terminals. Whether to enable Zsh integration for VTE terminals.
This allows it to preserve the current directory of the shell This allows it to preserve the current directory of the shell
across terminals. across terminals.

24
nixos/modules/config/xdg/mime.nix
View File

@ -18,10 +18,10 @@ in
xdg.mime.enable = mkOption { xdg.mime.enable = mkOption {
type = types.bool; type = types.bool;
default = true; default = true;
description = '' description = lib.mdDoc ''
Whether to install files to support the Whether to install files to support the
<link xlink:href="https://specifications.freedesktop.org/shared-mime-info-spec/shared-mime-info-spec-latest.html">XDG Shared MIME-info specification</link> and the [XDG Shared MIME-info specification](https://specifications.freedesktop.org/shared-mime-info-spec/shared-mime-info-spec-latest.html) and the
<link xlink:href="https://specifications.freedesktop.org/mime-apps-spec/mime-apps-spec-latest.html">XDG MIME Applications specification</link>. [XDG MIME Applications specification](https://specifications.freedesktop.org/mime-apps-spec/mime-apps-spec-latest.html).
''; '';
}; };
@ -32,10 +32,10 @@ in
"application/pdf" = "firefox.desktop"; "application/pdf" = "firefox.desktop";
"text/xml" = [ "nvim.desktop" "codium.desktop" ]; "text/xml" = [ "nvim.desktop" "codium.desktop" ];
}; };
description = '' description = lib.mdDoc ''
Adds associations between mimetypes and applications. See the Adds associations between mimetypes and applications. See the
<link xlink:href="https://specifications.freedesktop.org/mime-apps-spec/mime-apps-spec-latest.html#associations"> [
specifications</link> for more information. specifications](https://specifications.freedesktop.org/mime-apps-spec/mime-apps-spec-latest.html#associations) for more information.
''; '';
}; };
@ -46,10 +46,10 @@ in
"application/pdf" = "firefox.desktop"; "application/pdf" = "firefox.desktop";
"image/png" = [ "sxiv.desktop" "gimp.desktop" ]; "image/png" = [ "sxiv.desktop" "gimp.desktop" ];
}; };
description = '' description = lib.mdDoc ''
Sets the default applications for given mimetypes. See the Sets the default applications for given mimetypes. See the
<link xlink:href="https://specifications.freedesktop.org/mime-apps-spec/mime-apps-spec-latest.html#default"> [
specifications</link> for more information. specifications](https://specifications.freedesktop.org/mime-apps-spec/mime-apps-spec-latest.html#default) for more information.
''; '';
}; };
@ -60,10 +60,10 @@ in
"audio/mp3" = [ "mpv.desktop" "umpv.desktop" ]; "audio/mp3" = [ "mpv.desktop" "umpv.desktop" ];
"inode/directory" = "codium.desktop"; "inode/directory" = "codium.desktop";
}; };
description = '' description = lib.mdDoc ''
Removes associations between mimetypes and applications. See the Removes associations between mimetypes and applications. See the
<link xlink:href="https://specifications.freedesktop.org/mime-apps-spec/mime-apps-spec-latest.html#associations"> [
specifications</link> for more information. specifications](https://specifications.freedesktop.org/mime-apps-spec/mime-apps-spec-latest.html#associations) for more information.
''; '';
}; };
}; };

24
nixos/modules/config/zram.nix
View File

@ -40,21 +40,21 @@ in
enable = mkOption { enable = mkOption {
default = false; default = false;
type = types.bool; type = types.bool;
description = '' description = lib.mdDoc ''
Enable in-memory compressed devices and swap space provided by the zram Enable in-memory compressed devices and swap space provided by the zram
kernel module. kernel module.
See <link xlink:href="https://www.kernel.org/doc/Documentation/blockdev/zram.txt"> See [
https://www.kernel.org/doc/Documentation/blockdev/zram.txt https://www.kernel.org/doc/Documentation/blockdev/zram.txt
</link>. ](https://www.kernel.org/doc/Documentation/blockdev/zram.txt).
''; '';
}; };
numDevices = mkOption { numDevices = mkOption {
default = 1; default = 1;
type = types.int; type = types.int;
description = '' description = lib.mdDoc ''
Number of zram devices to create. See also Number of zram devices to create. See also
<literal>zramSwap.swapDevices</literal> `zramSwap.swapDevices`
''; '';
}; };
@ -62,20 +62,20 @@ in
default = null; default = null;
example = 1; example = 1;
type = with types; nullOr int; type = with types; nullOr int;
description = '' description = lib.mdDoc ''
Number of zram devices to be used as swap. Must be Number of zram devices to be used as swap. Must be
<literal>&lt;= zramSwap.numDevices</literal>. `<= zramSwap.numDevices`.
Default is same as <literal>zramSwap.numDevices</literal>, recommended is 1. Default is same as `zramSwap.numDevices`, recommended is 1.
''; '';
}; };
memoryPercent = mkOption { memoryPercent = mkOption {
default = 50; default = 50;
type = types.int; type = types.int;
description = '' description = lib.mdDoc ''
Maximum amount of memory that can be used by the zram swap devices Maximum amount of memory that can be used by the zram swap devices
(as a percentage of your total memory). Defaults to 1/2 of your total (as a percentage of your total memory). Defaults to 1/2 of your total
RAM. Run <literal>zramctl</literal> to check how good memory is RAM. Run `zramctl` to check how good memory is
compressed. compressed.
''; '';
}; };
@ -83,7 +83,7 @@ in
memoryMax = mkOption { memoryMax = mkOption {
default = null; default = null;
type = with types; nullOr int; type = with types; nullOr int;
description = '' description = lib.mdDoc ''
Maximum total amount of memory (in bytes) that can be used by the zram Maximum total amount of memory (in bytes) that can be used by the zram
swap devices. swap devices.
''; '';
@ -92,7 +92,7 @@ in
priority = mkOption { priority = mkOption {
default = 5; default = 5;
type = types.int; type = types.int;
description = '' description = lib.mdDoc ''
Priority of the zram swap devices. It should be a number higher than Priority of the zram swap devices. It should be a number higher than
the priority of your disk-based swap devices (so that the system will the priority of your disk-based swap devices (so that the system will
fill the zram swap devices before falling back to disk swap). fill the zram swap devices before falling back to disk swap).

2
nixos/modules/hardware/acpilight.nix
View File

@ -10,7 +10,7 @@ in
enable = mkOption { enable = mkOption {
default = false; default = false;
type = types.bool; type = types.bool;
description = '' description = lib.mdDoc ''
Enable acpilight. Enable acpilight.
This will allow brightness control via xbacklight from users in the video group This will allow brightness control via xbacklight from users in the video group
''; '';

6
nixos/modules/hardware/all-firmware.nix
View File

@ -21,7 +21,7 @@ in {
hardware.enableAllFirmware = mkOption { hardware.enableAllFirmware = mkOption {
default = false; default = false;
type = types.bool; type = types.bool;
description = '' description = lib.mdDoc ''
Turn on this option if you want to enable all the firmware. Turn on this option if you want to enable all the firmware.
''; '';
}; };
@ -30,7 +30,7 @@ in {
default = config.hardware.enableAllFirmware; default = config.hardware.enableAllFirmware;
defaultText = lib.literalExpression "config.hardware.enableAllFirmware"; defaultText = lib.literalExpression "config.hardware.enableAllFirmware";
type = types.bool; type = types.bool;
description = '' description = lib.mdDoc ''
Turn on this option if you want to enable all the firmware with a license allowing redistribution. Turn on this option if you want to enable all the firmware with a license allowing redistribution.
''; '';
}; };
@ -38,7 +38,7 @@ in {
hardware.wirelessRegulatoryDatabase = mkOption { hardware.wirelessRegulatoryDatabase = mkOption {
default = false; default = false;
type = types.bool; type = types.bool;
description = '' description = lib.mdDoc ''
Load the wireless regulatory database at boot. Load the wireless regulatory database at boot.
''; '';
}; };

2
nixos/modules/hardware/bladeRF.nix
View File

@ -12,7 +12,7 @@ in
enable = mkOption { enable = mkOption {
type = types.bool; type = types.bool;
default = false; default = false;
description = '' description = lib.mdDoc ''
Enables udev rules for BladeRF devices. By default grants access Enables udev rules for BladeRF devices. By default grants access
to users in the "bladerf" group. You may want to install the to users in the "bladerf" group. You may want to install the
libbladeRF package. libbladeRF package.

4
nixos/modules/hardware/ckb-next.nix
View File

@ -19,7 +19,7 @@ in
type = types.nullOr types.int; type = types.nullOr types.int;
default = null; default = null;
example = 100; example = 100;
description = '' description = lib.mdDoc ''
Limit access to the ckb daemon to a particular group. Limit access to the ckb daemon to a particular group.
''; '';
}; };
@ -28,7 +28,7 @@ in
type = types.package; type = types.package;
default = pkgs.ckb-next; default = pkgs.ckb-next;
defaultText = literalExpression "pkgs.ckb-next"; defaultText = literalExpression "pkgs.ckb-next";
description = '' description = lib.mdDoc ''
The package implementing the Corsair keyboard/mouse driver. The package implementing the Corsair keyboard/mouse driver.
''; '';
}; };

2
nixos/modules/hardware/cpu/amd-microcode.nix
View File

@ -11,7 +11,7 @@ with lib;
hardware.cpu.amd.updateMicrocode = mkOption { hardware.cpu.amd.updateMicrocode = mkOption {
default = false; default = false;
type = types.bool; type = types.bool;
description = '' description = lib.mdDoc ''
Update the CPU microcode for AMD processors. Update the CPU microcode for AMD processors.
''; '';
}; };

2
nixos/modules/hardware/cpu/intel-microcode.nix
View File

@ -11,7 +11,7 @@ with lib;
hardware.cpu.intel.updateMicrocode = mkOption { hardware.cpu.intel.updateMicrocode = mkOption {
default = false; default = false;
type = types.bool; type = types.bool;
description = '' description = lib.mdDoc ''
Update the CPU microcode for Intel processors. Update the CPU microcode for Intel processors.
''; '';
}; };

18
nixos/modules/hardware/device-tree.nix
View File

@ -9,14 +9,14 @@ let
options = { options = {
name = mkOption { name = mkOption {
type = types.str; type = types.str;
description = '' description = lib.mdDoc ''
Name of this overlay Name of this overlay
''; '';
}; };
dtsFile = mkOption { dtsFile = mkOption {
type = types.nullOr types.path; type = types.nullOr types.path;
description = '' description = lib.mdDoc ''
Path to .dts overlay file, overlay is applied to Path to .dts overlay file, overlay is applied to
each .dtb file matching "compatible" of the overlay. each .dtb file matching "compatible" of the overlay.
''; '';
@ -27,7 +27,7 @@ let
dtsText = mkOption { dtsText = mkOption {
type = types.nullOr types.str; type = types.nullOr types.str;
default = null; default = null;
description = '' description = lib.mdDoc ''
Literal DTS contents, overlay is applied to Literal DTS contents, overlay is applied to
each .dtb file matching "compatible" of the overlay. each .dtb file matching "compatible" of the overlay.
''; '';
@ -49,7 +49,7 @@ let
dtboFile = mkOption { dtboFile = mkOption {
type = types.nullOr types.path; type = types.nullOr types.path;
default = null; default = null;
description = '' description = lib.mdDoc ''
Path to .dtbo compiled overlay file. Path to .dtbo compiled overlay file.
''; '';
}; };
@ -115,7 +115,7 @@ in
enable = mkOption { enable = mkOption {
default = pkgs.stdenv.hostPlatform.linux-kernel.DTB or false; default = pkgs.stdenv.hostPlatform.linux-kernel.DTB or false;
type = types.bool; type = types.bool;
description = '' description = lib.mdDoc ''
Build device tree files. These are used to describe the Build device tree files. These are used to describe the
non-discoverable hardware of a system. non-discoverable hardware of a system.
''; '';
@ -126,7 +126,7 @@ in
defaultText = literalExpression "config.boot.kernelPackages.kernel"; defaultText = literalExpression "config.boot.kernelPackages.kernel";
example = literalExpression "pkgs.linux_latest"; example = literalExpression "pkgs.linux_latest";
type = types.path; type = types.path;
description = '' description = lib.mdDoc ''
Kernel package containing the base device-tree (.dtb) to boot. Uses Kernel package containing the base device-tree (.dtb) to boot. Uses
device trees bundled with the Linux kernel by default. device trees bundled with the Linux kernel by default.
''; '';
@ -136,7 +136,7 @@ in
default = null; default = null;
example = "some-dtb.dtb"; example = "some-dtb.dtb";
type = types.nullOr types.str; type = types.nullOr types.str;
description = '' description = lib.mdDoc ''
The name of an explicit dtb to be loaded, relative to the dtb base. The name of an explicit dtb to be loaded, relative to the dtb base.
Useful in extlinux scenarios if the bootloader doesn't pick the Useful in extlinux scenarios if the bootloader doesn't pick the
right .dtb file from FDTDIR. right .dtb file from FDTDIR.
@ -147,7 +147,7 @@ in
type = types.nullOr types.str; type = types.nullOr types.str;
default = null; default = null;
example = "*rpi*.dtb"; example = "*rpi*.dtb";
description = '' description = lib.mdDoc ''
Only include .dtb files matching glob expression. Only include .dtb files matching glob expression.
''; '';
}; };
@ -167,7 +167,7 @@ in
name = baseNameOf path; name = baseNameOf path;
dtboFile = path; dtboFile = path;
}) overlayType); }) overlayType);
description = '' description = lib.mdDoc ''
List of overlays to apply to base device-tree (.dtb) files. List of overlays to apply to base device-tree (.dtb) files.
''; '';
}; };

4
nixos/modules/hardware/digitalbitbox.nix
View File

@ -11,7 +11,7 @@ in
enable = mkOption { enable = mkOption {
type = types.bool; type = types.bool;
default = false; default = false;
description = '' description = lib.mdDoc ''
Enables udev rules for Digital Bitbox devices. Enables udev rules for Digital Bitbox devices.
''; '';
}; };
@ -20,7 +20,7 @@ in
type = types.package; type = types.package;
default = pkgs.digitalbitbox; default = pkgs.digitalbitbox;
defaultText = literalExpression "pkgs.digitalbitbox"; defaultText = literalExpression "pkgs.digitalbitbox";
description = "The Digital Bitbox package to use. This can be used to install a package with udev rules that differ from the defaults."; description = lib.mdDoc "The Digital Bitbox package to use. This can be used to install a package with udev rules that differ from the defaults.";
}; };
}; };

2
nixos/modules/hardware/hackrf.nix
View File

@ -9,7 +9,7 @@ in
enable = lib.mkOption { enable = lib.mkOption {
type = lib.types.bool; type = lib.types.bool;
default = false; default = false;
description = '' description = lib.mdDoc ''
Enables hackrf udev rules and ensures 'plugdev' group exists. Enables hackrf udev rules and ensures 'plugdev' group exists.
This is a prerequisite to using HackRF devices without being root, since HackRF USB descriptors will be owned by plugdev through udev. This is a prerequisite to using HackRF devices without being root, since HackRF USB descriptors will be owned by plugdev through udev.
''; '';

2
nixos/modules/hardware/i2c.nix
View File

@ -17,7 +17,7 @@ in
group = mkOption { group = mkOption {
type = types.str; type = types.str;
default = "i2c"; default = "i2c";
description = '' description = lib.mdDoc ''
Grant access to i2c devices (/dev/i2c-*) to users in this group. Grant access to i2c devices (/dev/i2c-*) to users in this group.
''; '';
}; };

2
nixos/modules/hardware/keyboard/zsa.nix
View File

@ -9,7 +9,7 @@ in
enable = mkOption { enable = mkOption {
type = types.bool; type = types.bool;
default = false; default = false;
description = '' description = lib.mdDoc ''
Enables udev rules for keyboards from ZSA like the ErgoDox EZ, Planck EZ and Moonlander Mark I. Enables udev rules for keyboards from ZSA like the ErgoDox EZ, Planck EZ and Moonlander Mark I.
You need it when you want to flash a new configuration on the keyboard You need it when you want to flash a new configuration on the keyboard
or use their live training in the browser. or use their live training in the browser.

4
nixos/modules/hardware/logitech.nix
View File

@ -24,7 +24,7 @@ in
startWhenNeeded = mkOption { startWhenNeeded = mkOption {
type = types.bool; type = types.bool;
default = true; default = true;
description = '' description = lib.mdDoc ''
Only run the service when an actual supported device is plugged. Only run the service when an actual supported device is plugged.
''; '';
}; };
@ -47,7 +47,7 @@ in
enableGraphical = mkOption { enableGraphical = mkOption {
type = types.bool; type = types.bool;
default = false; default = false;
description = "Enable graphical support applications."; description = lib.mdDoc "Enable graphical support applications.";
}; };
}; };
}; };

2
nixos/modules/hardware/mcelog.nix
View File

@ -10,7 +10,7 @@ with lib;
enable = mkOption { enable = mkOption {
type = types.bool; type = types.bool;
default = false; default = false;
description = '' description = lib.mdDoc ''
Enable the Machine Check Exception logger. Enable the Machine Check Exception logger.
''; '';
}; };

2
nixos/modules/hardware/network/ath-user-regd.nix
View File

@ -14,7 +14,7 @@ in
options.networking.wireless.athUserRegulatoryDomain = mkOption { options.networking.wireless.athUserRegulatoryDomain = mkOption {
default = false; default = false;
type = types.bool; type = types.bool;
description = '' description = lib.mdDoc ''
If enabled, sets the ATH_USER_REGD kernel config switch to true to If enabled, sets the ATH_USER_REGD kernel config switch to true to
disable the enforcement of EEPROM regulatory restrictions for ath disable the enforcement of EEPROM regulatory restrictions for ath
drivers. Requires at least Linux ${linuxKernelMinVersion}. drivers. Requires at least Linux ${linuxKernelMinVersion}.

2
nixos/modules/hardware/network/b43.nix
View File

@ -13,7 +13,7 @@ let kernelVersion = config.boot.kernelPackages.kernel.version; in
networking.enableB43Firmware = mkOption { networking.enableB43Firmware = mkOption {
default = false; default = false;
type = types.bool; type = types.bool;
description = '' description = lib.mdDoc ''
Turn on this option if you want firmware for the NICs supported by the b43 module. Turn on this option if you want firmware for the NICs supported by the b43 module.
''; '';
}; };

2
nixos/modules/hardware/network/intel-2200bg.nix
View File

@ -9,7 +9,7 @@
networking.enableIntel2200BGFirmware = lib.mkOption { networking.enableIntel2200BGFirmware = lib.mkOption {
default = false; default = false;
type = lib.types.bool; type = lib.types.bool;
description = '' description = lib.mdDoc ''
Turn on this option if you want firmware for the Intel Turn on this option if you want firmware for the Intel
PRO/Wireless 2200BG to be loaded automatically. This is PRO/Wireless 2200BG to be loaded automatically. This is
required if you want to use this device. required if you want to use this device.

2
nixos/modules/hardware/new-lg4ff.nix
View File

@ -10,7 +10,7 @@ in {
enable = mkOption { enable = mkOption {
type = types.bool; type = types.bool;
default = false; default = false;
description = '' description = lib.mdDoc ''
Enables improved Linux module drivers for Logitech driving wheels. Enables improved Linux module drivers for Logitech driving wheels.
This will replace the existing in-kernel hid-logitech modules. This will replace the existing in-kernel hid-logitech modules.
Works most notably on the Logitech G25, G27, G29 and Driving Force (GT). Works most notably on the Logitech G25, G27, G29 and Driving Force (GT).

2
nixos/modules/hardware/nitrokey.nix
View File

@ -13,7 +13,7 @@ in
enable = mkOption { enable = mkOption {
type = types.bool; type = types.bool;
default = false; default = false;
description = '' description = lib.mdDoc ''
Enables udev rules for Nitrokey devices. By default grants access Enables udev rules for Nitrokey devices. By default grants access
to users in the "nitrokey" group. You may want to install the to users in the "nitrokey" group. You may want to install the
nitrokey-app package, depending on your device and needs. nitrokey-app package, depending on your device and needs.

2
nixos/modules/hardware/onlykey/default.nix
View File

@ -12,7 +12,7 @@ with lib;
enable = mkOption { enable = mkOption {
type = types.bool; type = types.bool;
default = false; default = false;
description = '' description = lib.mdDoc ''
Enable OnlyKey device (https://crp.to/p/) support. Enable OnlyKey device (https://crp.to/p/) support.
''; '';
}; };

16
nixos/modules/hardware/opengl.nix
View File

@ -35,7 +35,7 @@ in
hardware.opengl = { hardware.opengl = {
enable = mkOption { enable = mkOption {
description = '' description = lib.mdDoc ''
Whether to enable OpenGL drivers. This is needed to enable Whether to enable OpenGL drivers. This is needed to enable
OpenGL support in X11 systems, as well as for Wayland compositors OpenGL support in X11 systems, as well as for Wayland compositors
like sway and Weston. It is enabled by default like sway and Weston. It is enabled by default
@ -51,7 +51,7 @@ in
driSupport = mkOption { driSupport = mkOption {
type = types.bool; type = types.bool;
default = true; default = true;
description = '' description = lib.mdDoc ''
Whether to enable accelerated OpenGL rendering through the Whether to enable accelerated OpenGL rendering through the
Direct Rendering Interface (DRI). Direct Rendering Interface (DRI).
''; '';
@ -60,11 +60,11 @@ in
driSupport32Bit = mkOption { driSupport32Bit = mkOption {
type = types.bool; type = types.bool;
default = false; default = false;
description = '' description = lib.mdDoc ''
On 64-bit systems, whether to support Direct Rendering for On 64-bit systems, whether to support Direct Rendering for
32-bit applications (such as Wine). This is currently only 32-bit applications (such as Wine). This is currently only
supported for the <literal>nvidia</literal> as well as supported for the `nvidia` as well as
<literal>Mesa</literal>. `Mesa`.
''; '';
}; };
@ -90,7 +90,7 @@ in
type = types.listOf types.package; type = types.listOf types.package;
default = []; default = [];
example = literalExpression "with pkgs; [ vaapiIntel libvdpau-va-gl vaapiVdpau intel-ocl ]"; example = literalExpression "with pkgs; [ vaapiIntel libvdpau-va-gl vaapiVdpau intel-ocl ]";
description = '' description = lib.mdDoc ''
Additional packages to add to OpenGL drivers. This can be used Additional packages to add to OpenGL drivers. This can be used
to add OpenCL drivers, VA-API/VDPAU drivers etc. to add OpenCL drivers, VA-API/VDPAU drivers etc.
''; '';
@ -100,9 +100,9 @@ in
type = types.listOf types.package; type = types.listOf types.package;
default = []; default = [];
example = literalExpression "with pkgs.pkgsi686Linux; [ vaapiIntel libvdpau-va-gl vaapiVdpau ]"; example = literalExpression "with pkgs.pkgsi686Linux; [ vaapiIntel libvdpau-va-gl vaapiVdpau ]";
description = '' description = lib.mdDoc ''
Additional packages to add to 32-bit OpenGL drivers on Additional packages to add to 32-bit OpenGL drivers on
64-bit systems. Used when <option>driSupport32Bit</option> is 64-bit systems. Used when {option}`driSupport32Bit` is
set. This can be used to add OpenCL drivers, VA-API/VDPAU drivers etc. set. This can be used to add OpenCL drivers, VA-API/VDPAU drivers etc.
''; '';
}; };

12
nixos/modules/hardware/openrazer.nix
View File

@ -56,7 +56,7 @@ in
verboseLogging = mkOption { verboseLogging = mkOption {
type = types.bool; type = types.bool;
default = false; default = false;
description = '' description = lib.mdDoc ''
Whether to enable verbose logging. Logs debug messages. Whether to enable verbose logging. Logs debug messages.
''; '';
}; };
@ -64,7 +64,7 @@ in
syncEffectsEnabled = mkOption { syncEffectsEnabled = mkOption {
type = types.bool; type = types.bool;
default = true; default = true;
description = '' description = lib.mdDoc ''
Set the sync effects flag to true so any assignment of Set the sync effects flag to true so any assignment of
effects will work across devices. effects will work across devices.
''; '';
@ -73,7 +73,7 @@ in
devicesOffOnScreensaver = mkOption { devicesOffOnScreensaver = mkOption {
type = types.bool; type = types.bool;
default = true; default = true;
description = '' description = lib.mdDoc ''
Turn off the devices when the systems screensaver kicks in. Turn off the devices when the systems screensaver kicks in.
''; '';
}; };
@ -81,7 +81,7 @@ in
mouseBatteryNotifier = mkOption { mouseBatteryNotifier = mkOption {
type = types.bool; type = types.bool;
default = true; default = true;
description = '' description = lib.mdDoc ''
Mouse battery notifier. Mouse battery notifier.
''; '';
}; };
@ -89,7 +89,7 @@ in
keyStatistics = mkOption { keyStatistics = mkOption {
type = types.bool; type = types.bool;
default = false; default = false;
description = '' description = lib.mdDoc ''
Collects number of keypresses per hour per key used to Collects number of keypresses per hour per key used to
generate a heatmap. generate a heatmap.
''; '';
@ -98,7 +98,7 @@ in
users = mkOption { users = mkOption {
type = with types; listOf str; type = with types; listOf str;
default = []; default = [];
description = '' description = lib.mdDoc ''
Usernames to be added to the "openrazer" group, so that they Usernames to be added to the "openrazer" group, so that they
can start and interact with the OpenRazer userspace daemon. can start and interact with the OpenRazer userspace daemon.
''; '';

8
nixos/modules/hardware/opentabletdriver.nix
View File

@ -12,7 +12,7 @@ in
enable = mkOption { enable = mkOption {
default = false; default = false;
type = types.bool; type = types.bool;
description = '' description = lib.mdDoc ''
Enable OpenTabletDriver udev rules, user service and blacklist kernel Enable OpenTabletDriver udev rules, user service and blacklist kernel
modules known to conflict with OpenTabletDriver. modules known to conflict with OpenTabletDriver.
''; '';
@ -21,7 +21,7 @@ in
blacklistedKernelModules = mkOption { blacklistedKernelModules = mkOption {
type = types.listOf types.str; type = types.listOf types.str;
default = [ "hid-uclogic" "wacom" ]; default = [ "hid-uclogic" "wacom" ];
description = '' description = lib.mdDoc ''
Blacklist of kernel modules known to conflict with OpenTabletDriver. Blacklist of kernel modules known to conflict with OpenTabletDriver.
''; '';
}; };
@ -30,7 +30,7 @@ in
type = types.package; type = types.package;
default = pkgs.opentabletdriver; default = pkgs.opentabletdriver;
defaultText = literalExpression "pkgs.opentabletdriver"; defaultText = literalExpression "pkgs.opentabletdriver";
description = '' description = lib.mdDoc ''
OpenTabletDriver derivation to use. OpenTabletDriver derivation to use.
''; '';
}; };
@ -39,7 +39,7 @@ in
enable = mkOption { enable = mkOption {
default = true; default = true;
type = types.bool; type = types.bool;
description = '' description = lib.mdDoc ''
Whether to start OpenTabletDriver daemon as a systemd user service. Whether to start OpenTabletDriver daemon as a systemd user service.
''; '';
}; };

6
nixos/modules/hardware/pcmcia.nix
View File

@ -20,7 +20,7 @@ in
enable = mkOption { enable = mkOption {
type = types.bool; type = types.bool;
default = false; default = false;
description = '' description = lib.mdDoc ''
Enable this option to support PCMCIA card. Enable this option to support PCMCIA card.
''; '';
}; };
@ -28,7 +28,7 @@ in
firmware = mkOption { firmware = mkOption {
type = types.listOf types.path; type = types.listOf types.path;
default = []; default = [];
description = '' description = lib.mdDoc ''
List of firmware used to handle specific PCMCIA card. List of firmware used to handle specific PCMCIA card.
''; '';
}; };
@ -36,7 +36,7 @@ in
config = mkOption { config = mkOption {
default = null; default = null;
type = types.nullOr types.path; type = types.nullOr types.path;
description = '' description = lib.mdDoc ''
Path to the configuration file which maps the memory, IRQs Path to the configuration file which maps the memory, IRQs
and ports used by the PCMCIA hardware. and ports used by the PCMCIA hardware.
''; '';

26
nixos/modules/hardware/printers.nix
View File

@ -30,17 +30,17 @@ in {
ensureDefaultPrinter = mkOption { ensureDefaultPrinter = mkOption {
type = types.nullOr printerName; type = types.nullOr printerName;
default = null; default = null;
description = '' description = lib.mdDoc ''
Ensures the named printer is the default CUPS printer / printer queue. Ensures the named printer is the default CUPS printer / printer queue.
''; '';
}; };
ensurePrinters = mkOption { ensurePrinters = mkOption {
description = '' description = lib.mdDoc ''
Will regularly ensure that the given CUPS printers are configured as declared here. Will regularly ensure that the given CUPS printers are configured as declared here.
If a printer's options are manually changed afterwards, they will be overwritten eventually. If a printer's options are manually changed afterwards, they will be overwritten eventually.
This option will never delete any printer, even if removed from this list. This option will never delete any printer, even if removed from this list.
You can check existing printers with <command>lpstat -s</command> You can check existing printers with {command}`lpstat -s`
and remove printers with <command>lpadmin -x &lt;printer-name&gt;</command>. and remove printers with {command}`lpadmin -x <printer-name>`.
Printers not listed here can still be manually configured. Printers not listed here can still be manually configured.
''; '';
default = []; default = [];
@ -49,7 +49,7 @@ in {
name = mkOption { name = mkOption {
type = printerName; type = printerName;
example = "BrotherHL_Workroom"; example = "BrotherHL_Workroom";
description = '' description = lib.mdDoc ''
Name of the printer / printer queue. Name of the printer / printer queue.
May contain any printable characters except "/", "#", and space. May contain any printable characters except "/", "#", and space.
''; '';
@ -58,7 +58,7 @@ in {
type = types.nullOr types.str; type = types.nullOr types.str;
default = null; default = null;
example = "Workroom"; example = "Workroom";
description = '' description = lib.mdDoc ''
Optional human-readable location. Optional human-readable location.
''; '';
}; };
@ -66,7 +66,7 @@ in {
type = types.nullOr types.str; type = types.nullOr types.str;
default = null; default = null;
example = "Brother HL-5140"; example = "Brother HL-5140";
description = '' description = lib.mdDoc ''
Optional human-readable description. Optional human-readable description.
''; '';
}; };
@ -76,9 +76,9 @@ in {
"ipp://printserver.local/printers/BrotherHL_Workroom" "ipp://printserver.local/printers/BrotherHL_Workroom"
"usb://HP/DESKJET%20940C?serial=CN16E6C364BH" "usb://HP/DESKJET%20940C?serial=CN16E6C364BH"
''; '';
description = '' description = lib.mdDoc ''
How to reach the printer. How to reach the printer.
<command>lpinfo -v</command> shows a list of supported device URIs and schemes. {command}`lpinfo -v` shows a list of supported device URIs and schemes.
''; '';
}; };
model = mkOption { model = mkOption {
@ -86,9 +86,9 @@ in {
example = literalExpression '' example = literalExpression ''
"gutenprint.''${lib.versions.majorMinor (lib.getVersion pkgs.gutenprint)}://brother-hl-5140/expert" "gutenprint.''${lib.versions.majorMinor (lib.getVersion pkgs.gutenprint)}://brother-hl-5140/expert"
''; '';
description = '' description = lib.mdDoc ''
Location of the ppd driver file for the printer. Location of the ppd driver file for the printer.
<command>lpinfo -m</command> shows a list of supported models. {command}`lpinfo -m` shows a list of supported models.
''; '';
}; };
ppdOptions = mkOption { ppdOptions = mkOption {
@ -98,9 +98,9 @@ in {
Duplex = "DuplexNoTumble"; Duplex = "DuplexNoTumble";
}; };
default = {}; default = {};
description = '' description = lib.mdDoc ''
Sets PPD options for the printer. Sets PPD options for the printer.
<command>lpoptions [-p printername] -l</command> shows suported PPD options for the given printer. {command}`lpoptions [-p printername] -l` shows suported PPD options for the given printer.
''; '';
}; };
}; };

2
nixos/modules/hardware/rtl-sdr.nix
View File

@ -8,7 +8,7 @@ in {
enable = lib.mkOption { enable = lib.mkOption {
type = lib.types.bool; type = lib.types.bool;
default = false; default = false;
description = '' description = lib.mdDoc ''
Enables rtl-sdr udev rules, ensures 'plugdev' group exists, and blacklists DVB kernel modules. Enables rtl-sdr udev rules, ensures 'plugdev' group exists, and blacklists DVB kernel modules.
This is a prerequisite to using devices supported by rtl-sdr without being root, since rtl-sdr USB descriptors will be owned by plugdev through udev. This is a prerequisite to using devices supported by rtl-sdr without being root, since rtl-sdr USB descriptors will be owned by plugdev through udev.
''; '';

2
nixos/modules/hardware/saleae-logic.nix
View File

@ -11,7 +11,7 @@ in
type = lib.types.package; type = lib.types.package;
default = pkgs.saleae-logic-2; default = pkgs.saleae-logic-2;
defaultText = lib.literalExpression "pkgs.saleae-logic-2"; defaultText = lib.literalExpression "pkgs.saleae-logic-2";
description = '' description = lib.mdDoc ''
Saleae Logic package to use. Saleae Logic package to use.
''; '';
}; };

8
nixos/modules/hardware/sata.nix
View File

@ -41,7 +41,7 @@ in
deciSeconds = mkOption { deciSeconds = mkOption {
example = 70; example = 70;
type = types.int; type = types.int;
description = '' description = lib.mdDoc ''
Set SCT Error Recovery Control timeout in deciseconds for use in RAID configurations. Set SCT Error Recovery Control timeout in deciseconds for use in RAID configurations.
Values are as follows: Values are as follows:
@ -53,17 +53,17 @@ in
}; };
drives = mkOption { drives = mkOption {
description = "List of drives for which to configure the timeout."; description = lib.mdDoc "List of drives for which to configure the timeout.";
type = types.listOf type = types.listOf
(types.submodule { (types.submodule {
options = { options = {
name = mkOption { name = mkOption {
description = "Drive name without the full path."; description = lib.mdDoc "Drive name without the full path.";
type = types.str; type = types.str;
}; };
idBy = mkOption { idBy = mkOption {
description = "The method to identify the drive."; description = lib.mdDoc "The method to identify the drive.";
type = types.enum [ "path" "wwn" ]; type = types.enum [ "path" "wwn" ];
default = "path"; default = "path";
}; };

10
nixos/modules/hardware/sensor/hddtemp.nix
View File

@ -30,7 +30,7 @@ in
options = { options = {
hardware.sensor.hddtemp = { hardware.sensor.hddtemp = {
enable = mkOption { enable = mkOption {
description = '' description = lib.mdDoc ''
Enable this option to support HDD/SSD temperature sensors. Enable this option to support HDD/SSD temperature sensors.
''; '';
type = types.bool; type = types.bool;
@ -38,24 +38,24 @@ in
}; };
drives = mkOption { drives = mkOption {
description = "List of drives to monitor. If you pass /dev/disk/by-path/* entries the symlinks will be resolved as hddtemp doesn't like names with colons."; description = lib.mdDoc "List of drives to monitor. If you pass /dev/disk/by-path/* entries the symlinks will be resolved as hddtemp doesn't like names with colons.";
type = types.listOf types.str; type = types.listOf types.str;
}; };
unit = mkOption { unit = mkOption {
description = "Celcius or Fahrenheit"; description = lib.mdDoc "Celcius or Fahrenheit";
type = types.enum [ "C" "F" ]; type = types.enum [ "C" "F" ];
default = "C"; default = "C";
}; };
dbEntries = mkOption { dbEntries = mkOption {
description = "Additional DB entries"; description = lib.mdDoc "Additional DB entries";
type = types.listOf types.str; type = types.listOf types.str;
default = [ ]; default = [ ];
}; };
extraArgs = mkOption { extraArgs = mkOption {
description = "Additional arguments passed to the daemon."; description = lib.mdDoc "Additional arguments passed to the daemon.";
type = types.listOf types.str; type = types.listOf types.str;
default = [ ]; default = [ ];
}; };

2
nixos/modules/hardware/sensor/iio.nix
View File

@ -8,7 +8,7 @@ with lib;
options = { options = {
hardware.sensor.iio = { hardware.sensor.iio = {
enable = mkOption { enable = mkOption {
description = '' description = lib.mdDoc ''
Enable this option to support IIO sensors with iio-sensor-proxy. Enable this option to support IIO sensors with iio-sensor-proxy.
IIO sensors are used for orientation and ambient light IIO sensors are used for orientation and ambient light

2
nixos/modules/hardware/steam-hardware.nix
View File

@ -13,7 +13,7 @@ in
enable = mkOption { enable = mkOption {
type = types.bool; type = types.bool;
default = false; default = false;
description = "Enable udev rules for Steam hardware such as the Steam Controller, other supported controllers and the HTC Vive"; description = lib.mdDoc "Enable udev rules for Steam hardware such as the Steam Controller, other supported controllers and the HTC Vive";
}; };
}; };

6
nixos/modules/hardware/system-76.nix
View File

@ -63,7 +63,7 @@ in {
default = cfg.enableAll; default = cfg.enableAll;
defaultText = literalExpression "config.${opt.enableAll}"; defaultText = literalExpression "config.${opt.enableAll}";
example = true; example = true;
description = "Whether to enable the system76 firmware daemon"; description = lib.mdDoc "Whether to enable the system76 firmware daemon";
type = types.bool; type = types.bool;
}; };
@ -71,7 +71,7 @@ in {
default = cfg.enableAll; default = cfg.enableAll;
defaultText = literalExpression "config.${opt.enableAll}"; defaultText = literalExpression "config.${opt.enableAll}";
example = true; example = true;
description = "Whether to make the system76 out-of-tree kernel modules available"; description = lib.mdDoc "Whether to make the system76 out-of-tree kernel modules available";
type = types.bool; type = types.bool;
}; };
@ -79,7 +79,7 @@ in {
default = cfg.enableAll; default = cfg.enableAll;
defaultText = literalExpression "config.${opt.enableAll}"; defaultText = literalExpression "config.${opt.enableAll}";
example = true; example = true;
description = "Whether to enable the system76 power daemon"; description = lib.mdDoc "Whether to enable the system76 power daemon";
type = types.bool; type = types.bool;
}; };
}; };

2
nixos/modules/hardware/ubertooth.nix
View File

@ -16,7 +16,7 @@ in {
type = types.str; type = types.str;
default = "ubertooth"; default = "ubertooth";
example = "wheel"; example = "wheel";
description = "Group for Ubertooth's udev rules."; description = lib.mdDoc "Group for Ubertooth's udev rules.";
}; };
}; };

2
nixos/modules/hardware/usb-wwan.nix
View File

@ -11,7 +11,7 @@ with lib;
enable = mkOption { enable = mkOption {
type = types.bool; type = types.bool;
default = false; default = false;
description = '' description = lib.mdDoc ''
Enable this option to support USB WWAN adapters. Enable this option to support USB WWAN adapters.
''; '';
}; };

10
nixos/modules/hardware/video/bumblebee.nix
View File

@ -29,7 +29,7 @@ in
enable = mkOption { enable = mkOption {
default = false; default = false;
type = types.bool; type = types.bool;
description = '' description = lib.mdDoc ''
Enable the bumblebee daemon to manage Optimus hybrid video cards. Enable the bumblebee daemon to manage Optimus hybrid video cards.
This should power off secondary GPU until its use is requested This should power off secondary GPU until its use is requested
by running an application with optirun. by running an application with optirun.
@ -40,13 +40,13 @@ in
default = "wheel"; default = "wheel";
example = "video"; example = "video";
type = types.str; type = types.str;
description = "Group for bumblebee socket"; description = lib.mdDoc "Group for bumblebee socket";
}; };
connectDisplay = mkOption { connectDisplay = mkOption {
default = false; default = false;
type = types.bool; type = types.bool;
description = '' description = lib.mdDoc ''
Set to true if you intend to connect your discrete card to a Set to true if you intend to connect your discrete card to a
monitor. This option will set up your Nvidia card for EDID monitor. This option will set up your Nvidia card for EDID
discovery and to turn on the monitor signal. discovery and to turn on the monitor signal.
@ -58,7 +58,7 @@ in
driver = mkOption { driver = mkOption {
default = "nvidia"; default = "nvidia";
type = types.enum [ "nvidia" "nouveau" ]; type = types.enum [ "nvidia" "nouveau" ];
description = '' description = lib.mdDoc ''
Set driver used by bumblebeed. Supported are nouveau and nvidia. Set driver used by bumblebeed. Supported are nouveau and nvidia.
''; '';
}; };
@ -66,7 +66,7 @@ in
pmMethod = mkOption { pmMethod = mkOption {
default = "auto"; default = "auto";
type = types.enum [ "auto" "bbswitch" "switcheroo" "none" ]; type = types.enum [ "auto" "bbswitch" "switcheroo" "none" ];
description = '' description = lib.mdDoc ''
Set preferred power management method for unused card. Set preferred power management method for unused card.
''; '';
}; };

44
nixos/modules/hardware/video/nvidia.nix
View File

@ -40,7 +40,7 @@ in
hardware.nvidia.powerManagement.enable = mkOption { hardware.nvidia.powerManagement.enable = mkOption {
type = types.bool; type = types.bool;
default = false; default = false;
description = '' description = lib.mdDoc ''
Experimental power management through systemd. For more information, see Experimental power management through systemd. For more information, see
the NVIDIA docs, on Chapter 21. Configuring Power Management Support. the NVIDIA docs, on Chapter 21. Configuring Power Management Support.
''; '';
@ -49,7 +49,7 @@ in
hardware.nvidia.powerManagement.finegrained = mkOption { hardware.nvidia.powerManagement.finegrained = mkOption {
type = types.bool; type = types.bool;
default = false; default = false;
description = '' description = lib.mdDoc ''
Experimental power management of PRIME offload. For more information, see Experimental power management of PRIME offload. For more information, see
the NVIDIA docs, chapter 22. PCI-Express runtime power management. the NVIDIA docs, chapter 22. PCI-Express runtime power management.
''; '';
@ -58,11 +58,11 @@ in
hardware.nvidia.modesetting.enable = mkOption { hardware.nvidia.modesetting.enable = mkOption {
type = types.bool; type = types.bool;
default = false; default = false;
description = '' description = lib.mdDoc ''
Enable kernel modesetting when using the NVIDIA proprietary driver. Enable kernel modesetting when using the NVIDIA proprietary driver.
Enabling this fixes screen tearing when using Optimus via PRIME (see Enabling this fixes screen tearing when using Optimus via PRIME (see
<option>hardware.nvidia.prime.sync.enable</option>. This is not enabled {option}`hardware.nvidia.prime.sync.enable`. This is not enabled
by default because it is not officially supported by NVIDIA and would not by default because it is not officially supported by NVIDIA and would not
work with SLI. work with SLI.
''; '';
@ -72,7 +72,7 @@ in
type = busIDType; type = busIDType;
default = ""; default = "";
example = "PCI:1:0:0"; example = "PCI:1:0:0";
description = '' description = lib.mdDoc ''
Bus ID of the NVIDIA GPU. You can find it using lspci; for example if lspci Bus ID of the NVIDIA GPU. You can find it using lspci; for example if lspci
shows the NVIDIA GPU at "01:00.0", set this option to "PCI:1:0:0". shows the NVIDIA GPU at "01:00.0", set this option to "PCI:1:0:0".
''; '';
@ -82,7 +82,7 @@ in
type = busIDType; type = busIDType;
default = ""; default = "";
example = "PCI:0:2:0"; example = "PCI:0:2:0";
description = '' description = lib.mdDoc ''
Bus ID of the Intel GPU. You can find it using lspci; for example if lspci Bus ID of the Intel GPU. You can find it using lspci; for example if lspci
shows the Intel GPU at "00:02.0", set this option to "PCI:0:2:0". shows the Intel GPU at "00:02.0", set this option to "PCI:0:2:0".
''; '';
@ -92,7 +92,7 @@ in
type = busIDType; type = busIDType;
default = ""; default = "";
example = "PCI:4:0:0"; example = "PCI:4:0:0";
description = '' description = lib.mdDoc ''
Bus ID of the AMD APU. You can find it using lspci; for example if lspci Bus ID of the AMD APU. You can find it using lspci; for example if lspci
shows the AMD APU at "04:00.0", set this option to "PCI:4:0:0". shows the AMD APU at "04:00.0", set this option to "PCI:4:0:0".
''; '';
@ -101,26 +101,26 @@ in
hardware.nvidia.prime.sync.enable = mkOption { hardware.nvidia.prime.sync.enable = mkOption {
type = types.bool; type = types.bool;
default = false; default = false;
description = '' description = lib.mdDoc ''
Enable NVIDIA Optimus support using the NVIDIA proprietary driver via PRIME. Enable NVIDIA Optimus support using the NVIDIA proprietary driver via PRIME.
If enabled, the NVIDIA GPU will be always on and used for all rendering, If enabled, the NVIDIA GPU will be always on and used for all rendering,
while enabling output to displays attached only to the integrated Intel GPU while enabling output to displays attached only to the integrated Intel GPU
without a multiplexer. without a multiplexer.
Note that this option only has any effect if the "nvidia" driver is specified Note that this option only has any effect if the "nvidia" driver is specified
in <option>services.xserver.videoDrivers</option>, and it should preferably in {option}`services.xserver.videoDrivers`, and it should preferably
be the only driver there. be the only driver there.
If this is enabled, then the bus IDs of the NVIDIA and Intel GPUs have to be If this is enabled, then the bus IDs of the NVIDIA and Intel GPUs have to be
specified (<option>hardware.nvidia.prime.nvidiaBusId</option> and specified ({option}`hardware.nvidia.prime.nvidiaBusId` and
<option>hardware.nvidia.prime.intelBusId</option>). {option}`hardware.nvidia.prime.intelBusId`).
If you enable this, you may want to also enable kernel modesetting for the If you enable this, you may want to also enable kernel modesetting for the
NVIDIA driver (<option>hardware.nvidia.modesetting.enable</option>) in order NVIDIA driver ({option}`hardware.nvidia.modesetting.enable`) in order
to prevent tearing. to prevent tearing.
Note that this configuration will only be successful when a display manager Note that this configuration will only be successful when a display manager
for which the <option>services.xserver.displayManager.setupCommands</option> for which the {option}`services.xserver.displayManager.setupCommands`
option is supported is used. option is supported is used.
''; '';
}; };
@ -128,7 +128,7 @@ in
hardware.nvidia.prime.sync.allowExternalGpu = mkOption { hardware.nvidia.prime.sync.allowExternalGpu = mkOption {
type = types.bool; type = types.bool;
default = false; default = false;
description = '' description = lib.mdDoc ''
Configure X to allow external NVIDIA GPUs when using optimus. Configure X to allow external NVIDIA GPUs when using optimus.
''; '';
}; };
@ -136,19 +136,19 @@ in
hardware.nvidia.prime.offload.enable = mkOption { hardware.nvidia.prime.offload.enable = mkOption {
type = types.bool; type = types.bool;
default = false; default = false;
description = '' description = lib.mdDoc ''
Enable render offload support using the NVIDIA proprietary driver via PRIME. Enable render offload support using the NVIDIA proprietary driver via PRIME.
If this is enabled, then the bus IDs of the NVIDIA and Intel GPUs have to be If this is enabled, then the bus IDs of the NVIDIA and Intel GPUs have to be
specified (<option>hardware.nvidia.prime.nvidiaBusId</option> and specified ({option}`hardware.nvidia.prime.nvidiaBusId` and
<option>hardware.nvidia.prime.intelBusId</option>). {option}`hardware.nvidia.prime.intelBusId`).
''; '';
}; };
hardware.nvidia.nvidiaSettings = mkOption { hardware.nvidia.nvidiaSettings = mkOption {
default = true; default = true;
type = types.bool; type = types.bool;
description = '' description = lib.mdDoc ''
Whether to add nvidia-settings, NVIDIA's GUI configuration tool, to Whether to add nvidia-settings, NVIDIA's GUI configuration tool, to
systemPackages. systemPackages.
''; '';
@ -157,7 +157,7 @@ in
hardware.nvidia.nvidiaPersistenced = mkOption { hardware.nvidia.nvidiaPersistenced = mkOption {
default = false; default = false;
type = types.bool; type = types.bool;
description = '' description = lib.mdDoc ''
Update for NVIDA GPU headless mode, i.e. nvidia-persistenced. It ensures all Update for NVIDA GPU headless mode, i.e. nvidia-persistenced. It ensures all
GPUs stay awake even during headless mode. GPUs stay awake even during headless mode.
''; '';
@ -166,7 +166,7 @@ in
hardware.nvidia.forceFullCompositionPipeline = lib.mkOption { hardware.nvidia.forceFullCompositionPipeline = lib.mkOption {
default = false; default = false;
type = types.bool; type = types.bool;
description = '' description = lib.mdDoc ''
Whether to force-enable the full composition pipeline. Whether to force-enable the full composition pipeline.
This sometimes fixes screen tearing issues. This sometimes fixes screen tearing issues.
This has been reported to reduce the performance of some OpenGL applications and may produce issues in WebGL. This has been reported to reduce the performance of some OpenGL applications and may produce issues in WebGL.
@ -178,7 +178,7 @@ in
type = types.package; type = types.package;
default = config.boot.kernelPackages.nvidiaPackages.stable; default = config.boot.kernelPackages.nvidiaPackages.stable;
defaultText = literalExpression "config.boot.kernelPackages.nvidiaPackages.stable"; defaultText = literalExpression "config.boot.kernelPackages.nvidiaPackages.stable";
description = '' description = lib.mdDoc ''
The NVIDIA X11 derivation to use. The NVIDIA X11 derivation to use.
''; '';
example = literalExpression "config.boot.kernelPackages.nvidiaPackages.legacy_340"; example = literalExpression "config.boot.kernelPackages.nvidiaPackages.legacy_340";
@ -187,7 +187,7 @@ in
hardware.nvidia.open = lib.mkOption { hardware.nvidia.open = lib.mkOption {
type = lib.types.bool; type = lib.types.bool;
default = false; default = false;
description = '' description = lib.mdDoc ''
Whether to use the open source kernel module Whether to use the open source kernel module
''; '';
}; };

8
nixos/modules/hardware/video/uvcvideo/default.nix
View File

@ -22,12 +22,12 @@ in
enable = mkOption { enable = mkOption {
type = types.bool; type = types.bool;
default = false; default = false;
description = '' description = lib.mdDoc ''
Whether to enable <command>uvcvideo</command> dynamic controls. Whether to enable {command}`uvcvideo` dynamic controls.
Note that enabling this brings the <command>uvcdynctrl</command> tool Note that enabling this brings the {command}`uvcdynctrl` tool
into your environment and register all dynamic controls from into your environment and register all dynamic controls from
specified <command>packages</command> to the <command>uvcvideo</command> driver. specified {command}`packages` to the {command}`uvcvideo` driver.
''; '';
}; };

4
nixos/modules/hardware/video/webcam/facetimehd.nix
View File

@ -18,10 +18,10 @@ in
default = false; default = false;
example = true; example = true;
type = types.bool; type = types.bool;
description = '' description = lib.mdDoc ''
Whether to include sensor calibration files for facetimehd. Whether to include sensor calibration files for facetimehd.
This makes colors look much better but is experimental, see This makes colors look much better but is experimental, see
<link xlink:href="https://github.com/patjak/facetimehd/wiki/Extracting-the-sensor-calibration-files"/> <https://github.com/patjak/facetimehd/wiki/Extracting-the-sensor-calibration-files>
for details. for details.
''; '';
}; };

2
nixos/modules/i18n/input-method/fcitx5.nix
View File

@ -15,7 +15,7 @@ in {
type = with types; listOf package; type = with types; listOf package;
default = []; default = [];
example = literalExpression "with pkgs; [ fcitx5-rime ]"; example = literalExpression "with pkgs; [ fcitx5-rime ]";
description = '' description = lib.mdDoc ''
Enabled Fcitx5 addons. Enabled Fcitx5 addons.
''; '';
}; };

4
nixos/modules/i18n/input-method/kime.nix
View File

@ -27,8 +27,8 @@ in
}; };
} }
''; '';
description = '' description = lib.mdDoc ''
kime configuration. Refer to <link xlink:href="https://github.com/Riey/kime/blob/v${pkgs.kime.version}/docs/CONFIGURATION.md"/> for details on supported values. kime configuration. Refer to <https://github.com/Riey/kime/blob/v${pkgs.kime.version}/docs/CONFIGURATION.md> for details on supported values.
''; '';
}; };
}; };

2
nixos/modules/i18n/input-method/uim.nix
View File

@ -13,7 +13,7 @@ in
type = types.enum [ "gtk" "gtk3" "gtk-systray" "gtk3-systray" "qt4" ]; type = types.enum [ "gtk" "gtk3" "gtk-systray" "gtk3-systray" "qt4" ];
default = "gtk"; default = "gtk";
example = "gtk-systray"; example = "gtk-systray";
description = '' description = lib.mdDoc ''
selected UIM toolbar. selected UIM toolbar.
''; '';
}; };

6
nixos/modules/misc/crashdump.nix
View File

@ -16,7 +16,7 @@ in
enable = mkOption { enable = mkOption {
type = types.bool; type = types.bool;
default = false; default = false;
description = '' description = lib.mdDoc ''
If enabled, NixOS will set up a kernel that will If enabled, NixOS will set up a kernel that will
boot on crash, and leave the user in systemd rescue boot on crash, and leave the user in systemd rescue
to be able to save the crashed kernel dump at to be able to save the crashed kernel dump at
@ -27,7 +27,7 @@ in
reservedMemory = mkOption { reservedMemory = mkOption {
default = "128M"; default = "128M";
type = types.str; type = types.str;
description = '' description = lib.mdDoc ''
The amount of memory reserved for the crashdump kernel. The amount of memory reserved for the crashdump kernel.
If you choose a too high value, dmesg will mention If you choose a too high value, dmesg will mention
"crashkernel reservation failed". "crashkernel reservation failed".
@ -36,7 +36,7 @@ in
kernelParams = mkOption { kernelParams = mkOption {
type = types.listOf types.str; type = types.listOf types.str;
default = [ "1" "boot.shell_on_fail" ]; default = [ "1" "boot.shell_on_fail" ];
description = '' description = lib.mdDoc ''
Parameters that will be passed to the kernel kexec-ed on crash. Parameters that will be passed to the kernel kexec-ed on crash.
''; '';
}; };

2
nixos/modules/misc/lib.nix
View File

@ -7,7 +7,7 @@
type = lib.types.attrsOf lib.types.attrs; type = lib.types.attrsOf lib.types.attrs;
description = '' description = lib.mdDoc ''
This option allows modules to define helper functions, constants, etc. This option allows modules to define helper functions, constants, etc.
''; '';
}; };

24
nixos/modules/misc/locate.nix
View File

@ -19,9 +19,9 @@ in
enable = mkOption { enable = mkOption {
type = bool; type = bool;
default = false; default = false;
description = '' description = lib.mdDoc ''
If enabled, NixOS will periodically update the database of If enabled, NixOS will periodically update the database of
files used by the <command>locate</command> command. files used by the {command}`locate` command.
''; '';
}; };
@ -30,7 +30,7 @@ in
default = pkgs.findutils.locate; default = pkgs.findutils.locate;
defaultText = literalExpression "pkgs.findutils"; defaultText = literalExpression "pkgs.findutils";
example = literalExpression "pkgs.mlocate"; example = literalExpression "pkgs.mlocate";
description = '' description = lib.mdDoc ''
The locate implementation to use The locate implementation to use
''; '';
}; };
@ -55,15 +55,15 @@ in
extraFlags = mkOption { extraFlags = mkOption {
type = listOf str; type = listOf str;
default = [ ]; default = [ ];
description = '' description = lib.mdDoc ''
Extra flags to pass to <command>updatedb</command>. Extra flags to pass to {command}`updatedb`.
''; '';
}; };
output = mkOption { output = mkOption {
type = path; type = path;
default = "/var/cache/locatedb"; default = "/var/cache/locatedb";
description = '' description = lib.mdDoc ''
The database file to build. The database file to build.
''; '';
}; };
@ -71,9 +71,9 @@ in
localuser = mkOption { localuser = mkOption {
type = nullOr str; type = nullOr str;
default = "nobody"; default = "nobody";
description = '' description = lib.mdDoc ''
The user to search non-network directories as, using The user to search non-network directories as, using
<command>su</command>. {command}`su`.
''; '';
}; };
@ -159,7 +159,7 @@ in
"vboxsf" "vboxsf"
"vperfctrfs" "vperfctrfs"
]; ];
description = '' description = lib.mdDoc ''
Which filesystem types to exclude from indexing Which filesystem types to exclude from indexing
''; '';
}; };
@ -176,7 +176,7 @@ in
"/nix/store" "/nix/store"
"/nix/var/log/nix" "/nix/var/log/nix"
]; ];
description = '' description = lib.mdDoc ''
Which paths to exclude from indexing Which paths to exclude from indexing
''; '';
}; };
@ -188,7 +188,7 @@ in
<literal>[ ".bzr" ".cache" ".git" ".hg" ".svn" ]</literal>, if <literal>[ ".bzr" ".cache" ".git" ".hg" ".svn" ]</literal>, if
supported by the locate implementation (i.e. mlocate or plocate). supported by the locate implementation (i.e. mlocate or plocate).
''; '';
description = '' description = lib.mdDoc ''
Directory components which should exclude paths containing them from indexing Directory components which should exclude paths containing them from indexing
''; '';
}; };
@ -196,7 +196,7 @@ in
pruneBindMounts = mkOption { pruneBindMounts = mkOption {
type = bool; type = bool;
default = false; default = false;
description = '' description = lib.mdDoc ''
Whether not to index bind mounts Whether not to index bind mounts
''; '';
}; };

2
nixos/modules/programs/_1password-gui.nix
View File

@ -22,7 +22,7 @@ in
type = types.listOf types.str; type = types.listOf types.str;
default = [ ]; default = [ ];
example = literalExpression ''["user1" "user2" "user3"]''; example = literalExpression ''["user1" "user2" "user3"]'';
description = '' description = lib.mdDoc ''
A list of users who should be able to integrate 1Password with polkit-based authentication mechanisms. A list of users who should be able to integrate 1Password with polkit-based authentication mechanisms.
''; '';
}; };

2
nixos/modules/programs/autojump.nix
View File

@ -13,7 +13,7 @@ in
enable = mkOption { enable = mkOption {
type = types.bool; type = types.bool;
default = false; default = false;
description = '' description = lib.mdDoc ''
Whether to enable autojump. Whether to enable autojump.
''; '';
}; };

2
nixos/modules/programs/bandwhich.nix
View File

@ -11,7 +11,7 @@ in {
enable = mkOption { enable = mkOption {
type = types.bool; type = types.bool;
default = false; default = false;
description = '' description = lib.mdDoc ''
Whether to add bandwhich to the global environment and configure a Whether to add bandwhich to the global environment and configure a
setcap wrapper for it. setcap wrapper for it.
''; '';

2
nixos/modules/programs/bash/undistract-me.nix
View File

@ -14,7 +14,7 @@ in
timeout = mkOption { timeout = mkOption {
default = 10; default = 10;
description = '' description = lib.mdDoc ''
Number of seconds it would take for a command to be considered long-running. Number of seconds it would take for a command to be considered long-running.
''; '';
type = types.int; type = types.int;

10
nixos/modules/programs/captive-browser.nix
View File

@ -40,12 +40,12 @@ in
type = types.package; type = types.package;
default = pkgs.captive-browser; default = pkgs.captive-browser;
defaultText = literalExpression "pkgs.captive-browser"; defaultText = literalExpression "pkgs.captive-browser";
description = "Which package to use for captive-browser"; description = lib.mdDoc "Which package to use for captive-browser";
}; };
interface = mkOption { interface = mkOption {
type = types.str; type = types.str;
description = "your public network interface (wlp3s0, wlan0, eth0, ...)"; description = lib.mdDoc "your public network interface (wlp3s0, wlan0, eth0, ...)";
}; };
# the options below are the same as in "captive-browser.toml" # the options below are the same as in "captive-browser.toml"
@ -53,7 +53,7 @@ in
type = types.str; type = types.str;
default = browserDefault pkgs.chromium; default = browserDefault pkgs.chromium;
defaultText = literalExpression (browserDefault "\${pkgs.chromium}"); defaultText = literalExpression (browserDefault "\${pkgs.chromium}");
description = '' description = lib.mdDoc ''
The shell (/bin/sh) command executed once the proxy starts. The shell (/bin/sh) command executed once the proxy starts.
When browser exits, the proxy exits. An extra env var PROXY is available. When browser exits, the proxy exits. An extra env var PROXY is available.
@ -69,7 +69,7 @@ in
dhcp-dns = mkOption { dhcp-dns = mkOption {
type = types.str; type = types.str;
description = '' description = lib.mdDoc ''
The shell (/bin/sh) command executed to obtain the DHCP The shell (/bin/sh) command executed to obtain the DHCP
DNS server address. The first match of an IPv4 regex is used. DNS server address. The first match of an IPv4 regex is used.
IPv4 only, because let's be real, it's a captive portal. IPv4 only, because let's be real, it's a captive portal.
@ -79,7 +79,7 @@ in
socks5-addr = mkOption { socks5-addr = mkOption {
type = types.str; type = types.str;
default = "localhost:1666"; default = "localhost:1666";
description = "the listen address for the SOCKS5 proxy server"; description = lib.mdDoc "the listen address for the SOCKS5 proxy server";
}; };
bindInterface = mkOption { bindInterface = mkOption {

4
nixos/modules/programs/ccache.nix
View File

@ -9,13 +9,13 @@ in {
enable = mkEnableOption "CCache"; enable = mkEnableOption "CCache";
cacheDir = mkOption { cacheDir = mkOption {
type = types.path; type = types.path;
description = "CCache directory"; description = lib.mdDoc "CCache directory";
default = "/var/cache/ccache"; default = "/var/cache/ccache";
}; };
# target configuration # target configuration
packageNames = mkOption { packageNames = mkOption {
type = types.listOf types.str; type = types.listOf types.str;
description = "Nix top-level packages to be compiled using CCache"; description = lib.mdDoc "Nix top-level packages to be compiled using CCache";
default = []; default = [];
example = [ "wxGTK30" "ffmpeg" "libav_all" ]; example = [ "wxGTK30" "ffmpeg" "libav_all" ];
}; };

16
nixos/modules/programs/cdemu.nix
View File

@ -10,29 +10,29 @@ in {
enable = mkOption { enable = mkOption {
type = types.bool; type = types.bool;
default = false; default = false;
description = '' description = lib.mdDoc ''
<command>cdemu</command> for members of {command}`cdemu` for members of
<option>programs.cdemu.group</option>. {option}`programs.cdemu.group`.
''; '';
}; };
group = mkOption { group = mkOption {
type = types.str; type = types.str;
default = "cdrom"; default = "cdrom";
description = '' description = lib.mdDoc ''
Group that users must be in to use <command>cdemu</command>. Group that users must be in to use {command}`cdemu`.
''; '';
}; };
gui = mkOption { gui = mkOption {
type = types.bool; type = types.bool;
default = true; default = true;
description = '' description = lib.mdDoc ''
Whether to install the <command>cdemu</command> GUI (gCDEmu). Whether to install the {command}`cdemu` GUI (gCDEmu).
''; '';
}; };
image-analyzer = mkOption { image-analyzer = mkOption {
type = types.bool; type = types.bool;
default = true; default = true;
description = '' description = lib.mdDoc ''
Whether to install the image analyzer. Whether to install the image analyzer.
''; '';
}; };

14
nixos/modules/programs/chromium.nix
View File

@ -23,14 +23,14 @@ in
extensions = mkOption { extensions = mkOption {
type = types.listOf types.str; type = types.listOf types.str;
description = '' description = lib.mdDoc ''
List of chromium extensions to install. List of chromium extensions to install.
For list of plugins ids see id in url of extensions on For list of plugins ids see id in url of extensions on
<link xlink:href="https://chrome.google.com/webstore/category/extensions">chrome web store</link> [chrome web store](https://chrome.google.com/webstore/category/extensions)
page. To install a chromium extension not included in the chrome web page. To install a chromium extension not included in the chrome web
store, append to the extension id a semicolon ";" followed by a URL store, append to the extension id a semicolon ";" followed by a URL
pointing to an Update Manifest XML file. See pointing to an Update Manifest XML file. See
<link xlink:href="https://cloud.google.com/docs/chrome-enterprise/policies/?policy=ExtensionInstallForcelist">ExtensionInstallForcelist</link> [ExtensionInstallForcelist](https://cloud.google.com/docs/chrome-enterprise/policies/?policy=ExtensionInstallForcelist)
for additional details. for additional details.
''; '';
default = []; default = [];
@ -46,21 +46,21 @@ in
homepageLocation = mkOption { homepageLocation = mkOption {
type = types.nullOr types.str; type = types.nullOr types.str;
description = "Chromium default homepage"; description = lib.mdDoc "Chromium default homepage";
default = null; default = null;
example = "https://nixos.org"; example = "https://nixos.org";
}; };
defaultSearchProviderEnabled = mkOption { defaultSearchProviderEnabled = mkOption {
type = types.nullOr types.bool; type = types.nullOr types.bool;
description = "Enable the default search provider."; description = lib.mdDoc "Enable the default search provider.";
default = null; default = null;
example = true; example = true;
}; };
defaultSearchProviderSearchURL = mkOption { defaultSearchProviderSearchURL = mkOption {
type = types.nullOr types.str; type = types.nullOr types.str;
description = "Chromium default search provider url."; description = lib.mdDoc "Chromium default search provider url.";
default = null; default = null;
example = example =
"https://encrypted.google.com/search?q={searchTerms}&{google:RLZ}{google:originalQueryForSuggestion}{google:assistedQueryStats}{google:searchFieldtrialParameter}{google:searchClient}{google:sourceId}{google:instantExtendedEnabledParameter}ie={inputEncoding}"; "https://encrypted.google.com/search?q={searchTerms}&{google:RLZ}{google:originalQueryForSuggestion}{google:assistedQueryStats}{google:searchFieldtrialParameter}{google:searchClient}{google:sourceId}{google:instantExtendedEnabledParameter}ie={inputEncoding}";
@ -68,7 +68,7 @@ in
defaultSearchProviderSuggestURL = mkOption { defaultSearchProviderSuggestURL = mkOption {
type = types.nullOr types.str; type = types.nullOr types.str;
description = "Chromium default search provider url for suggestions."; description = lib.mdDoc "Chromium default search provider url for suggestions.";
default = null; default = null;
example = example =
"https://encrypted.google.com/complete/search?output=chrome&q={searchTerms}"; "https://encrypted.google.com/complete/search?output=chrome&q={searchTerms}";

4
nixos/modules/programs/command-not-found/command-not-found.nix
View File

@ -26,7 +26,7 @@ in
enable = mkOption { enable = mkOption {
type = types.bool; type = types.bool;
default = true; default = true;
description = '' description = lib.mdDoc ''
Whether interactive shells should show which Nix package (if Whether interactive shells should show which Nix package (if
any) provides a missing command. any) provides a missing command.
''; '';
@ -34,7 +34,7 @@ in
dbPath = mkOption { dbPath = mkOption {
default = "/nix/var/nix/profiles/per-user/root/channels/nixos/programs.sqlite" ; default = "/nix/var/nix/profiles/per-user/root/channels/nixos/programs.sqlite" ;
description = '' description = lib.mdDoc ''
Absolute path to programs.sqlite. Absolute path to programs.sqlite.
By default this file will be provided by your channel By default this file will be provided by your channel

4
nixos/modules/programs/criu.nix
View File

@ -10,8 +10,8 @@ in {
enable = mkOption { enable = mkOption {
type = types.bool; type = types.bool;
default = false; default = false;
description = '' description = lib.mdDoc ''
Install <command>criu</command> along with necessary kernel options. Install {command}`criu` along with necessary kernel options.
''; '';
}; };
}; };

4
nixos/modules/programs/digitalbitbox/default.nix
View File

@ -11,7 +11,7 @@ in
enable = mkOption { enable = mkOption {
type = types.bool; type = types.bool;
default = false; default = false;
description = '' description = lib.mdDoc ''
Installs the Digital Bitbox application and enables the complementary hardware module. Installs the Digital Bitbox application and enables the complementary hardware module.
''; '';
}; };
@ -20,7 +20,7 @@ in
type = types.package; type = types.package;
default = pkgs.digitalbitbox; default = pkgs.digitalbitbox;
defaultText = literalExpression "pkgs.digitalbitbox"; defaultText = literalExpression "pkgs.digitalbitbox";
description = "The Digital Bitbox package to use. This can be used to install a package with udev rules that differ from the defaults."; description = lib.mdDoc "The Digital Bitbox package to use. This can be used to install a package with udev rules that differ from the defaults.";
}; };
}; };

4
nixos/modules/programs/dmrconfig.nix
View File

@ -14,7 +14,7 @@ in {
enable = mkOption { enable = mkOption {
default = false; default = false;
type = types.bool; type = types.bool;
description = '' description = lib.mdDoc ''
Whether to configure system to enable use of dmrconfig. This Whether to configure system to enable use of dmrconfig. This
enables the required udev rules and installs the program. enables the required udev rules and installs the program.
''; '';
@ -25,7 +25,7 @@ in {
default = pkgs.dmrconfig; default = pkgs.dmrconfig;
type = types.package; type = types.package;
defaultText = literalExpression "pkgs.dmrconfig"; defaultText = literalExpression "pkgs.dmrconfig";
description = "dmrconfig derivation to use"; description = lib.mdDoc "dmrconfig derivation to use";
}; };
}; };
}; };

2
nixos/modules/programs/evince.nix
View File

@ -28,7 +28,7 @@ in {
type = types.package; type = types.package;
default = pkgs.evince; default = pkgs.evince;
defaultText = literalExpression "pkgs.evince"; defaultText = literalExpression "pkgs.evince";
description = "Evince derivation to use."; description = lib.mdDoc "Evince derivation to use.";
}; };
}; };

2
nixos/modules/programs/feedbackd.nix
View File

@ -13,7 +13,7 @@ in {
Your user needs to be in the `feedbackd` group to trigger effects. Your user needs to be in the `feedbackd` group to trigger effects.
''; '';
package = mkOption { package = mkOption {
description = '' description = lib.mdDoc ''
Which feedbackd package to use. Which feedbackd package to use.
''; '';
type = types.package; type = types.package;

2
nixos/modules/programs/file-roller.nix
View File

@ -27,7 +27,7 @@ in {
type = types.package; type = types.package;
default = pkgs.gnome.file-roller; default = pkgs.gnome.file-roller;
defaultText = literalExpression "pkgs.gnome.file-roller"; defaultText = literalExpression "pkgs.gnome.file-roller";
description = "File Roller derivation to use."; description = lib.mdDoc "File Roller derivation to use.";
}; };
}; };

2
nixos/modules/programs/flashrom.nix
View File

@ -10,7 +10,7 @@ in
enable = mkOption { enable = mkOption {
type = types.bool; type = types.bool;
default = false; default = false;
description = '' description = lib.mdDoc ''
Installs flashrom and configures udev rules for programmers Installs flashrom and configures udev rules for programmers
used by flashrom. Grants access to users in the "flashrom" used by flashrom. Grants access to users in the "flashrom"
group. group.

2
nixos/modules/programs/flexoptix-app.nix
View File

@ -10,7 +10,7 @@ in {
enable = mkEnableOption "FLEXOPTIX app + udev rules"; enable = mkEnableOption "FLEXOPTIX app + udev rules";
package = mkOption { package = mkOption {
description = "FLEXOPTIX app package to use"; description = lib.mdDoc "FLEXOPTIX app package to use";
type = types.package; type = types.package;
default = pkgs.flexoptix-app; default = pkgs.flexoptix-app;
defaultText = literalExpression "pkgs.flexoptix-app"; defaultText = literalExpression "pkgs.flexoptix-app";

2
nixos/modules/programs/freetds.nix
View File

@ -26,7 +26,7 @@ in
} }
''; '';
description = description =
'' lib.mdDoc ''
Configure freetds database entries. Each attribute denotes Configure freetds database entries. Each attribute denotes
a section within freetds.conf, and the value (a string) is the config a section within freetds.conf, and the value (a string) is the config
content for that section. When at least one entry is configured content for that section. When at least one entry is configured

4
nixos/modules/programs/fuse.nix
View File

@ -13,7 +13,7 @@ in {
# negative numbers obviously make no sense: # negative numbers obviously make no sense:
type = types.ints.between 0 32767; # 2^15 - 1 type = types.ints.between 0 32767; # 2^15 - 1
default = 1000; default = 1000;
description = '' description = lib.mdDoc ''
Set the maximum number of FUSE mounts allowed to non-root users. Set the maximum number of FUSE mounts allowed to non-root users.
''; '';
}; };
@ -21,7 +21,7 @@ in {
userAllowOther = mkOption { userAllowOther = mkOption {
type = types.bool; type = types.bool;
default = false; default = false;
description = '' description = lib.mdDoc ''
Allow non-root users to specify the allow_other or allow_root mount Allow non-root users to specify the allow_other or allow_root mount
options, see mount.fuse3(8). options, see mount.fuse3(8).
''; '';

2
nixos/modules/programs/gamemode.nix
View File

@ -19,7 +19,7 @@ in
settings = mkOption { settings = mkOption {
type = settingsFormat.type; type = settingsFormat.type;
default = {}; default = {};
description = '' description = lib.mdDoc ''
System-wide configuration for GameMode (/etc/gamemode.ini). System-wide configuration for GameMode (/etc/gamemode.ini).
See gamemoded(8) man page for available settings. See gamemoded(8) man page for available settings.
''; '';

6
nixos/modules/programs/git.nix
View File

@ -16,7 +16,7 @@ in
default = pkgs.git; default = pkgs.git;
defaultText = literalExpression "pkgs.git"; defaultText = literalExpression "pkgs.git";
example = literalExpression "pkgs.gitFull"; example = literalExpression "pkgs.gitFull";
description = "The git package to use"; description = lib.mdDoc "The git package to use";
}; };
config = mkOption { config = mkOption {
@ -26,7 +26,7 @@ in
init.defaultBranch = "main"; init.defaultBranch = "main";
url."https://github.com/".insteadOf = [ "gh:" "github:" ]; url."https://github.com/".insteadOf = [ "gh:" "github:" ];
}; };
description = '' description = lib.mdDoc ''
Configuration to write to /etc/gitconfig. See the CONFIGURATION FILE Configuration to write to /etc/gitconfig. See the CONFIGURATION FILE
section of git-config(1) for more information. section of git-config(1) for more information.
''; '';
@ -39,7 +39,7 @@ in
type = types.package; type = types.package;
default = pkgs.git-lfs; default = pkgs.git-lfs;
defaultText = literalExpression "pkgs.git-lfs"; defaultText = literalExpression "pkgs.git-lfs";
description = "The git-lfs package to use"; description = lib.mdDoc "The git-lfs package to use";
}; };
}; };
}; };

2
nixos/modules/programs/gnome-disks.nix
View File

@ -26,7 +26,7 @@ with lib;
enable = mkOption { enable = mkOption {
type = types.bool; type = types.bool;
default = false; default = false;
description = '' description = lib.mdDoc ''
Whether to enable GNOME Disks daemon, a program designed to Whether to enable GNOME Disks daemon, a program designed to
be a UDisks2 graphical front-end. be a UDisks2 graphical front-end.
''; '';

2
nixos/modules/programs/gnome-documents.nix
View File

@ -26,7 +26,7 @@ with lib;
enable = mkOption { enable = mkOption {
type = types.bool; type = types.bool;
default = false; default = false;
description = '' description = lib.mdDoc ''
Whether to enable GNOME Documents, a document Whether to enable GNOME Documents, a document
manager application for GNOME. manager application for GNOME.
''; '';

14
nixos/modules/programs/gnupg.nix
View File

@ -28,7 +28,7 @@ in
type = types.package; type = types.package;
default = pkgs.gnupg; default = pkgs.gnupg;
defaultText = literalExpression "pkgs.gnupg"; defaultText = literalExpression "pkgs.gnupg";
description = '' description = lib.mdDoc ''
The gpg package that should be used. The gpg package that should be used.
''; '';
}; };
@ -36,7 +36,7 @@ in
agent.enable = mkOption { agent.enable = mkOption {
type = types.bool; type = types.bool;
default = false; default = false;
description = '' description = lib.mdDoc ''
Enables GnuPG agent with socket-activation for every user session. Enables GnuPG agent with socket-activation for every user session.
''; '';
}; };
@ -44,7 +44,7 @@ in
agent.enableSSHSupport = mkOption { agent.enableSSHSupport = mkOption {
type = types.bool; type = types.bool;
default = false; default = false;
description = '' description = lib.mdDoc ''
Enable SSH agent support in GnuPG agent. Also sets SSH_AUTH_SOCK Enable SSH agent support in GnuPG agent. Also sets SSH_AUTH_SOCK
environment variable correctly. This will disable socket-activation environment variable correctly. This will disable socket-activation
and thus always start a GnuPG agent per user session. and thus always start a GnuPG agent per user session.
@ -54,7 +54,7 @@ in
agent.enableExtraSocket = mkOption { agent.enableExtraSocket = mkOption {
type = types.bool; type = types.bool;
default = false; default = false;
description = '' description = lib.mdDoc ''
Enable extra socket for GnuPG agent. Enable extra socket for GnuPG agent.
''; '';
}; };
@ -62,7 +62,7 @@ in
agent.enableBrowserSocket = mkOption { agent.enableBrowserSocket = mkOption {
type = types.bool; type = types.bool;
default = false; default = false;
description = '' description = lib.mdDoc ''
Enable browser socket for GnuPG agent. Enable browser socket for GnuPG agent.
''; '';
}; };
@ -72,7 +72,7 @@ in
example = "gnome3"; example = "gnome3";
default = defaultPinentryFlavor; default = defaultPinentryFlavor;
defaultText = literalDocBook ''matching the configured desktop environment''; defaultText = literalDocBook ''matching the configured desktop environment'';
description = '' description = lib.mdDoc ''
Which pinentry interface to use. If not null, the path to the Which pinentry interface to use. If not null, the path to the
pinentry binary will be passed to gpg-agent via commandline and pinentry binary will be passed to gpg-agent via commandline and
thus overrides the pinentry option in gpg-agent.conf in the user's thus overrides the pinentry option in gpg-agent.conf in the user's
@ -86,7 +86,7 @@ in
dirmngr.enable = mkOption { dirmngr.enable = mkOption {
type = types.bool; type = types.bool;
default = false; default = false;
description = '' description = lib.mdDoc ''
Enables GnuPG network certificate management daemon with socket-activation for every user session. Enables GnuPG network certificate management daemon with socket-activation for every user session.
''; '';
}; };

2
nixos/modules/programs/gpaste.nix
View File

@ -18,7 +18,7 @@ with lib;
enable = mkOption { enable = mkOption {
type = types.bool; type = types.bool;
default = false; default = false;
description = '' description = lib.mdDoc ''
Whether to enable GPaste, a clipboard manager. Whether to enable GPaste, a clipboard manager.
''; '';
}; };

4
nixos/modules/programs/htop.nix
View File

@ -21,7 +21,7 @@ in
type = types.package; type = types.package;
default = pkgs.htop; default = pkgs.htop;
defaultText = "pkgs.htop"; defaultText = "pkgs.htop";
description = '' description = lib.mdDoc ''
The htop package that should be used. The htop package that should be used.
''; '';
}; };
@ -35,7 +35,7 @@ in
hide_kernel_threads = true; hide_kernel_threads = true;
hide_userland_threads = true; hide_userland_threads = true;
}; };
description = '' description = lib.mdDoc ''
Extra global default configuration for htop Extra global default configuration for htop
which is read on first startup only. which is read on first startup only.
Htop subsequently uses ~/.config/htop/htoprc Htop subsequently uses ~/.config/htop/htoprc

2
nixos/modules/programs/java.nix
View File

@ -35,7 +35,7 @@ in
package = mkOption { package = mkOption {
default = pkgs.jdk; default = pkgs.jdk;
defaultText = literalExpression "pkgs.jdk"; defaultText = literalExpression "pkgs.jdk";
description = '' description = lib.mdDoc ''
Java package to install. Typical values are pkgs.jdk or pkgs.jre. Java package to install. Typical values are pkgs.jdk or pkgs.jre.
''; '';
type = types.package; type = types.package;

4
nixos/modules/programs/k40-whisperer.nix
View File

@ -14,7 +14,7 @@ in
group = mkOption { group = mkOption {
type = types.str; type = types.str;
description = '' description = lib.mdDoc ''
Group assigned to the device when connected. Group assigned to the device when connected.
''; '';
default = "k40"; default = "k40";
@ -25,7 +25,7 @@ in
default = pkgs.k40-whisperer; default = pkgs.k40-whisperer;
defaultText = literalExpression "pkgs.k40-whisperer"; defaultText = literalExpression "pkgs.k40-whisperer";
example = literalExpression "pkgs.k40-whisperer"; example = literalExpression "pkgs.k40-whisperer";
description = '' description = lib.mdDoc ''
K40 Whisperer package to use. K40 Whisperer package to use.
''; '';
}; };

2
nixos/modules/programs/kdeconnect.nix
View File

@ -16,7 +16,7 @@ with lib;
defaultText = literalExpression "pkgs.plasma5Packages.kdeconnect-kde"; defaultText = literalExpression "pkgs.plasma5Packages.kdeconnect-kde";
type = types.package; type = types.package;
example = literalExpression "pkgs.gnomeExtensions.gsconnect"; example = literalExpression "pkgs.gnomeExtensions.gsconnect";
description = '' description = lib.mdDoc ''
The package providing the implementation for kdeconnect. The package providing the implementation for kdeconnect.
''; '';
}; };

2
nixos/modules/programs/light.nix
View File

@ -12,7 +12,7 @@ in
enable = mkOption { enable = mkOption {
default = false; default = false;
type = types.bool; type = types.bool;
description = '' description = lib.mdDoc ''
Whether to install Light backlight control command Whether to install Light backlight control command
and udev rules granting access to members of the "video" group. and udev rules granting access to members of the "video" group.
''; '';

Some files were not shown because too many files have changed in this diff Show More