commit 7978d240c25502fdbfe33f0d483cec77a8d82918 · pyrox.dev/nixpkgs

nixos/doc/manual/release-notes/rl-2411.section.md

···

       87
        
       

     

       88
        
       ## New Modules {#sec-release-24.11-new-modules}

     

       89
        
       

     

       0
        
       
     

       0
        
       
     

       90
        
       - [KMonad](https://github.com/kmonad/kmonad), an advanced keyboard remapping utility. Available as [services.kmonad](#opt-services.kmonad.enable).

     

       91
        
       

     

       92
        
       - [Coral](https://coral.ai/), hardware support for Coral.ai Edge TPU devices. Available as [hardware.coral.usb.enable](#opt-hardware.coral.usb.enable) and [hardware.coral.pcie.enable](#opt-hardware.coral.pcie.enable).

···

       87
        
       

     

       88
        
       ## New Modules {#sec-release-24.11-new-modules}

     

       89
        
       

     

       90
       +
       - [hardware.block](options.html#hardware-block.defaultScheduler) allows configuration of I/O schedulers for block devices.

     

       91
       +
       

     

       92
        
       - [KMonad](https://github.com/kmonad/kmonad), an advanced keyboard remapping utility. Available as [services.kmonad](#opt-services.kmonad.enable).

     

       93
        
       

     

       94
        
       - [Coral](https://coral.ai/), hardware support for Coral.ai Edge TPU devices. Available as [hardware.coral.usb.enable](#opt-hardware.coral.usb.enable) and [hardware.coral.pcie.enable](#opt-hardware.coral.pcie.enable).

+70 -31

nixos/modules/hardware/iosched.nix

···

       6
        
       }:

     

       7
        
       

     

       8
        
       let

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       9
        
         cfg = config.hardware.block;

     

       10
        
         escape = lib.strings.escape [ ''"'' ];

     

       0
        
       
     

       11
        
         udevValue = types.addCheck types.nonEmptyStr (x: builtins.match "[^\n\r]*" x != null) // {

     

       12
        
           name = "udevValue";

     

       13
        
           description = "udev rule value";

     

       14
        
           descriptionClass = "noun";

     

       15
        
         };

     

       16
        
       

     

       17
       -
         inherit (lib)

     

       18
       -
           mkIf

     

       19
       -
           mkOption

     

       20
       -
           types

     

       21
       -
       

     

       22
       -
           concatLines

     

       23
       -
           concatStringsSep

     

       24
       -
           mapAttrsToList

     

       25
       -
           optional

     

       26
       -
           ;

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       27
        
       in

     

       28
        
       {

     

       29
        
         options.hardware.block = {

     
···

       54
        
             example = "bfq";

     

       55
        
           };

     

       56
        
       

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       57
        
           scheduler = mkOption {

     

       58
        
             type = types.attrsOf udevValue;

     

       59
        
             default = { };

     
···

       120
        
               services.udev.packages = [

     

       121
        
                 (pkgs.writeTextDir "etc/udev/rules.d/98-block-io-scheduler.rules" (

     

       122
        
                   concatLines (

     

       123
       -
                     map (concatStringsSep ", ") (

     

       124
       -
                       optional (cfg.defaultScheduler != null) [

     

       125
       -
                         ''SUBSYSTEM=="block"''

     

       126
       -
                         ''ACTION=="add|change"''

     

       127
       -
                         ''TEST=="queue/scheduler"''

     

       128
       -
                         ''ATTR{queue/scheduler}="${escape cfg.defaultScheduler}"''

     

       129
       -
                       ]

     

       130
       -
                       ++ optional (cfg.defaultSchedulerRotational != null) [

     

       131
       -
                         ''SUBSYSTEM=="block"''

     

       132
       -
                         ''ACTION=="add|change"''

     

       133
       -
                         ''ATTR{queue/rotational}=="1"''

     

       134
       -
                         ''TEST=="queue/scheduler"''

     

       135
       -
                         ''ATTR{queue/scheduler}="${escape cfg.defaultSchedulerRotational}"''

     

       136
       -
                       ]

     

       137
       -
                       ++ mapAttrsToList (name: sched: [

     

       138
       -
                         ''SUBSYSTEM=="block"''

     

       139
       -
                         ''ACTION=="add|change"''

     

       140
       -
                         ''KERNEL=="${escape name}"''

     

       141
       -
                         ''ATTR{queue/scheduler}="${escape sched}"''

     

       142
       -
                       ]) cfg.scheduler

     

       143
       -
                     )

     

       144
        
                   )

     

       145
        
                 ))

     

       146
        
               ];

···

       6
        
       }:

     

       7
        
       

     

       8
        
       let

     

       9
       +
         inherit (lib)

     

       10
       +
           concatLines

     

       11
       +
           concatStringsSep

     

       12
       +
           mapAttrsToList

     

       13
       +
           optional

     

       14
       +
           optionals

     

       15
       +
       

     

       16
       +
           mkIf

     

       17
       +
           mkOption

     

       18
       +
           types

     

       19
       +
           ;

     

       20
       +
       

     

       21
        
         cfg = config.hardware.block;

     

       22
        
         escape = lib.strings.escape [ ''"'' ];

     

       23
       +
       

     

       24
        
         udevValue = types.addCheck types.nonEmptyStr (x: builtins.match "[^\n\r]*" x != null) // {

     

       25
        
           name = "udevValue";

     

       26
        
           description = "udev rule value";

     

       27
        
           descriptionClass = "noun";

     

       28
        
         };

     

       29
        
       

     

       30
       +
         udevRule =

     

       31
       +
           {

     

       32
       +
             rotational ? null,

     

       33
       +
             include ? null,

     

       34
       +
             exclude ? null,

     

       35
       +
             scheduler,

     

       36
       +
           }:

     

       37
       +
           concatStringsSep ", " (

     

       38
       +
             [

     

       39
       +
               ''SUBSYSTEM=="block"''

     

       40
       +
               ''ACTION=="add|change"''

     

       41
       +
               ''TEST=="queue/scheduler"''

     

       42
       +
             ]

     

       43
       +
             ++ optionals (rotational != null) [

     

       44
       +
               ''ATTR{queue/rotational}=="${if rotational then "1" else "0"}"''

     

       45
       +
             ]

     

       46
       +
             ++ optionals (include != null) [

     

       47
       +
               ''KERNEL=="${escape include}"''

     

       48
       +
             ]

     

       49
       +
             ++ optionals (exclude != null) [

     

       50
       +
               ''KERNEL!="${escape exclude}"''

     

       51
       +
             ]

     

       52
       +
             ++ [

     

       53
       +
               ''ATTR{queue/scheduler}="${escape scheduler}"''

     

       54
       +
             ]

     

       55
       +
           );

     

       56
        
       in

     

       57
        
       {

     

       58
        
         options.hardware.block = {

     
···

       83
        
             example = "bfq";

     

       84
        
           };

     

       85
        
       

     

       86
       +
           defaultSchedulerExclude = mkOption {

     

       87
       +
             type = types.nullOr udevValue;

     

       88
       +
             default = "loop[0-9]*";

     

       89
       +
             description = ''

     

       90
       +
               Device name pattern to exclude from default scheduler assignment

     

       91
       +
               through {option}`config.hardware.block.defaultScheduler` and

     

       92
       +
               {option}`config.hardware.block.defaultSchedulerRotational`.

     

       93
       +
       

     

       94
       +
               By default this excludes loop devices which generally do not benefit

     

       95
       +
               from extra I/O scheduling in addition to the scheduling already

     

       96
       +
               performed for their backing devices.

     

       97
       +
       

     

       98
       +
               This setting does not affect {option}`config.hardware.block.scheduler`.

     

       99
       +
             '';

     

       100
       +
           };

     

       101
       +
       

     

       102
        
           scheduler = mkOption {

     

       103
        
             type = types.attrsOf udevValue;

     

       104
        
             default = { };

     
···

       165
        
               services.udev.packages = [

     

       166
        
                 (pkgs.writeTextDir "etc/udev/rules.d/98-block-io-scheduler.rules" (

     

       167
        
                   concatLines (

     

       168
       +
                     optional (cfg.defaultScheduler != null) (udevRule {

     

       169
       +
                       exclude = cfg.defaultSchedulerExclude;

     

       170
       +
                       scheduler = cfg.defaultScheduler;

     

       171
       +
                     })

     

       172
       +
                     ++ optional (cfg.defaultSchedulerRotational != null) (udevRule {

     

       173
       +
                       rotational = true;

     

       174
       +
                       exclude = cfg.defaultSchedulerExclude;

     

       175
       +
                       scheduler = cfg.defaultSchedulerRotational;

     

       176
       +
                     })

     

       177
       +
                     ++ mapAttrsToList (

     

       178
       +
                       include: scheduler:

     

       179
       +
                       udevRule {

     

       180
       +
                         inherit include scheduler;

     

       181
       +
                       }

     

       182
       +
                     ) cfg.scheduler

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       183
        
                   )

     

       184
        
                 ))

     

       185
        
               ];

nixos/tests/iosched.nix

···

       63
        
             check_scheduler("sdb", "mq-deadline")

     

       64
        
             check_scheduler("nvme0n1", "kyber")

     

       65
        
             check_scheduler("mmcblk0", "bfq")

     

       0
        
       
     

       0
        
       
     

       0
        
       
     

       66
        
           '';

     

       67
        
         }

     

       68
        
       )

···

       63
        
             check_scheduler("sdb", "mq-deadline")

     

       64
        
             check_scheduler("nvme0n1", "kyber")

     

       65
        
             check_scheduler("mmcblk0", "bfq")

     

       66
       +
       

     

       67
       +
             machine.succeed("tmp=\"$(mktemp)\"; losetup /dev/loop0 \"$tmp\"")

     

       68
       +
             check_scheduler("loop0", "none")

     

       69
        
           '';

     

       70
        
         }

     

       71
        
       )