nixos/modules/rename.nix

   1 { lib, ... }:
   2
   3 let
   4   inherit (lib)
   5     mkAliasOptionModuleMD
   6     mkRemovedOptionModule;
   7 in
   8 {
   9   imports = [
  10     /*
  11     This file defines some renaming/removing options for backwards compatibility
  12
  13     It should ONLY be used when the relevant module can't define these imports
  14     itself, such as when the module was removed completely.
  15     See https://github.com/NixOS/nixpkgs/pull/61570 for explanation
  16     */
  17
  18     # This alias module can't be where _module.check is defined because it would
  19     # be added to submodules as well there
  20     (mkAliasOptionModuleMD [ "environment" "checkConfigurationOptions" ] [ "_module" "check" ])
  21
  22     # Completely removed modules
  23     (mkRemovedOptionModule [ "environment" "blcr" "enable" ] "The BLCR module has been removed")
  24     (mkRemovedOptionModule [ "environment" "noXlibs" ] ''
  25       The environment.noXlibs option was removed, as it often caused surprising breakages for new users.
  26       If you need its functionality, you can apply similar overlays in your own config.
  27     '')
  28     (mkRemovedOptionModule [ "fonts" "fontconfig" "penultimate" ] "The corresponding package has removed from nixpkgs.")
  29     (mkRemovedOptionModule [ "hardware" "brightnessctl" ] ''
  30       The brightnessctl module was removed because newer versions of
  31       brightnessctl don't require the udev rules anymore (they can use the
  32       systemd-logind API). Instead of using the module you can now
  33       simply add the brightnessctl package to environment.systemPackages.
  34     '')
  35     (mkRemovedOptionModule [ "hardware" "u2f" ] ''
  36       The U2F modules module was removed, as all it did was adding the
  37       udev rules from libu2f-host to the system. Udev gained native support
  38       to handle FIDO security tokens, so this isn't necessary anymore.
  39     '')
  40     (mkRemovedOptionModule [ "hardware" "xow" ] ''
  41       The xow package was removed from nixpkgs. Upstream has deprecated
  42       the project and users are urged to switch to xone.
  43     '')
  44     (mkRemovedOptionModule [ "networking" "vpnc" ] "Use environment.etc.\"vpnc/service.conf\" instead.")
  45     (mkRemovedOptionModule [ "networking" "wicd" ] "The corresponding package was removed from nixpkgs.")
  46     (mkRemovedOptionModule [ "programs" "gnome-documents" ] "The corresponding package was removed from nixpkgs.")
  47     (mkRemovedOptionModule [ "programs" "pantheon-tweaks" ] ''
  48       pantheon-tweaks is no longer a switchboard plugin but an independent app,
  49       adding the package to environment.systemPackages is sufficient.
  50     '')
  51     (mkRemovedOptionModule [ "programs" "tilp2" ] "The corresponding package was removed from nixpkgs.")
  52     (mkRemovedOptionModule [ "programs" "way-cooler" ] ("way-cooler is abandoned by its author: " +
  53       "https://way-cooler.org/blog/2020/01/09/way-cooler-post-mortem.html"))
  54     (mkRemovedOptionModule [ "security" "hideProcessInformation" ] ''
  55       The hidepid module was removed, since the underlying machinery
  56       is broken when using cgroups-v2.
  57     '')
  58     (mkRemovedOptionModule [ "services" "antennas" ] "The antennas package and the corresponding module have been removed as they only work with tvheadend, which nobody was willing to maintain and was stuck on an unmaintained version that required FFmpeg 4; please see https://github.com/NixOS/nixpkgs/pull/332259 if you are interested in maintaining a newer version.")
  59     (mkRemovedOptionModule [ "services" "ankisyncd" ] "`services.ankisyncd` has been replaced by `services.anki-sync-server`.")
  60     (mkRemovedOptionModule [ "services" "baget" "enable" ] "The baget module was removed due to the upstream package being unmaintained.")
  61     (mkRemovedOptionModule [ "services" "beegfs" ] "The BeeGFS module has been removed")
  62     (mkRemovedOptionModule [ "services" "beegfsEnable" ] "The BeeGFS module has been removed")
  63     (mkRemovedOptionModule [ "services" "cgmanager" "enable"] "cgmanager was deprecated by lxc and therefore removed from nixpkgs.")
  64     (mkRemovedOptionModule [ "services" "chronos" ] "The corresponding package was removed from nixpkgs.")
  65     (mkRemovedOptionModule [ "services" "couchpotato" ] "The corresponding package was removed from nixpkgs.")
  66     (mkRemovedOptionModule [ "services" "dd-agent" ] "dd-agent was removed from nixpkgs in favor of the newer datadog-agent.")
  67     (mkRemovedOptionModule [ "services" "dnscrypt-proxy" ] "Use services.dnscrypt-proxy2 instead")
  68     (mkRemovedOptionModule [ "services" "dnscrypt-wrapper" ] ''
  69       The dnscrypt-wrapper module was removed since the project has been effectively unmaintained since 2018;
  70       moreover the NixOS module had to rely on an abandoned version of dnscrypt-proxy v1 for the rotation of keys.
  71
  72       To wrap a resolver with DNSCrypt you can instead use dnsdist. See options `services.dnsdist.dnscrypt.*`
  73     '')
  74     (mkRemovedOptionModule [ "services" "exhibitor" ] "The corresponding package was removed from nixpkgs.")
  75     (mkRemovedOptionModule [ "services" "firefox" "syncserver" ] "The corresponding package was removed from nixpkgs.")
  76     (mkRemovedOptionModule [ "services" "flashpolicyd" ] "The flashpolicyd module has been removed. Adobe Flash Player is deprecated.")
  77     (mkRemovedOptionModule [ "services" "fourStore" ] "The fourStore module has been removed")
  78     (mkRemovedOptionModule [ "services" "fourStoreEndpoint" ] "The fourStoreEndpoint module has been removed")
  79     (mkRemovedOptionModule [ "services" "fprot" ] "The corresponding package was removed from nixpkgs.")
  80     (mkRemovedOptionModule [ "services" "frab" ] "The frab module has been removed")
  81     (mkRemovedOptionModule [ "services" "globalprotect"] "The corresponding package was removed from nixpkgs.")
  82     (mkRemovedOptionModule [ "services" "homeassistant-satellite"] "The `services.homeassistant-satellite` module has been replaced by `services.wyoming-satellite`.")
  83     (mkRemovedOptionModule [ "services" "hydron" ] "The `services.hydron` module has been removed as the project has been archived upstream since 2022 and is affected by a severe remote code execution vulnerability.")
  84     (mkRemovedOptionModule [ "services" "ihatemoney" ] "The ihatemoney module has been removed for lack of downstream maintainer")
  85     (mkRemovedOptionModule [ "services" "kippo" ] "The corresponding package was removed from nixpkgs.")
  86     (mkRemovedOptionModule [ "services" "lshd" ] "The corresponding package was removed from nixpkgs as it had no maintainer in Nixpkgs and hasn't seen an upstream release in over a decades.")
  87     (mkRemovedOptionModule [ "services" "mailpile" ] "The corresponding package was removed from nixpkgs.")
  88     (mkRemovedOptionModule [ "services" "marathon" ] "The corresponding package was removed from nixpkgs.")
  89     (mkRemovedOptionModule [ "services" "mathics" ] "The Mathics module has been removed")
  90     (mkRemovedOptionModule [ "services" "meguca" ] "Use meguca has been removed from nixpkgs")
  91     (mkRemovedOptionModule [ "services" "mesos" ] "The corresponding package was removed from nixpkgs.")
  92     (mkRemovedOptionModule [ "services" "mxisd" ] "The mxisd module has been removed as both mxisd and ma1sd got removed.")
  93     (mkRemovedOptionModule [ "services" "moinmoin" ] "The corresponding package was removed from nixpkgs.")
  94     (mkRemovedOptionModule [ "services" "mwlib" ] "The corresponding package was removed from nixpkgs.")
  95     (mkRemovedOptionModule [ "services" "pantheon" "files" ] ''
  96       This module was removed, please add pkgs.pantheon.elementary-files to environment.systemPackages directly.
  97     '')
  98     (mkRemovedOptionModule [ "services" "prey" ] ''
  99       prey-bash-client is deprecated upstream
 100     '')
 101     (mkRemovedOptionModule [ "services" "quagga" ] "the corresponding package has been removed from nixpkgs")
 102     (mkRemovedOptionModule [ "services" "railcar" ] "the corresponding package has been removed from nixpkgs")
 103     (mkRemovedOptionModule [ "services" "replay-sorcery" ] "the corresponding package has been removed from nixpkgs as it is unmaintained upstream. Consider using `gpu-screen-recorder` or `obs-studio` instead.")
 104     (mkRemovedOptionModule [ "services" "seeks" ] "")
 105     (mkRemovedOptionModule [ "services" "ssmtp" ] ''
 106       The ssmtp package and the corresponding module have been removed due to
 107       the program being unmaintained. The options `programs.msmtp.*` can be
 108       used instead.
 109     '')
 110     (mkRemovedOptionModule [ "services" "tvheadend" ] "The tvheadend package and the corresponding module have been removed as nobody was willing to maintain them and they were stuck on an unmaintained version that required FFmpeg 4; please see https://github.com/NixOS/nixpkgs/pull/332259 if you are interested in maintaining a newer version.")
 111     (mkRemovedOptionModule [ "services" "venus" ] "The corresponding package was removed from nixpkgs.")
 112     (mkRemovedOptionModule [ "services" "wakeonlan"] "This module was removed in favor of enabling it with networking.interfaces.<name>.wakeOnLan")
 113     (mkRemovedOptionModule [ "services" "winstone" ] "The corresponding package was removed from nixpkgs.")
 114     (mkRemovedOptionModule [ "services" "xserver" "displayManager" "auto" ] ''
 115       The services.xserver.displayManager.auto module has been removed
 116       because it was only intended for use in internal NixOS tests, and gave the
 117       false impression of it being a special display manager when it's actually
 118       LightDM. Please use the services.displayManager.autoLogin options
 119       instead, or any other display manager in NixOS as they all support auto-login.
 120     '')
 121     (mkRemovedOptionModule [ "services" "xserver" "multitouch" ] ''
 122       services.xserver.multitouch (which uses xf86_input_mtrack) has been removed
 123       as the underlying package isn't being maintained. Working alternatives are
 124       libinput and synaptics.
 125     '')
 126     (mkRemovedOptionModule [ "services" "xmr-stak" ] "The corresponding package was removed from nixpkgs.")
 127     (mkRemovedOptionModule [ "virtualisation" "rkt" ] "The rkt module has been removed, it was archived by upstream")
 128     (mkRemovedOptionModule [ "services" "racoon" ] ''
 129       The racoon module has been removed, because the software project was abandoned upstream.
 130     '')
 131     (mkRemovedOptionModule [ "services" "shellinabox" ] "The corresponding package was removed from nixpkgs.")
 132     (mkRemovedOptionModule [ "services" "gogoclient" ] "The corresponding package was removed from nixpkgs.")
 133     (mkRemovedOptionModule [ "services" "virtuoso" ] "The corresponding package was removed from nixpkgs.")
 134     (mkRemovedOptionModule [ "services" "openfire" ] "The corresponding package was removed from nixpkgs.")
 135     (mkRemovedOptionModule [ "services" "riak" ] "The corresponding package was removed from nixpkgs.")
 136     (mkRemovedOptionModule [ "services" "rtsp-simple-server" ] "Package has been completely rebranded by upstream as mediamtx, and thus the service and the package were renamed in NixOS as well.")
 137     (mkRemovedOptionModule [ "services" "prayer" ] "The corresponding package was removed from nixpkgs.")
 138     (mkRemovedOptionModule [ "services" "restya-board" ] "The corresponding package was removed from nixpkgs.")
 139
 140     (mkRemovedOptionModule [ "i18n" "inputMethod" "fcitx" ] "The fcitx module has been removed. Please use fcitx5 instead")
 141     (mkRemovedOptionModule [ "services" "dhcpd4" ] ''
 142       The dhcpd4 module has been removed because ISC DHCP reached its end of life.
 143       See https://www.isc.org/blogs/isc-dhcp-eol/ for details.
 144       Please switch to a different implementation like kea or dnsmasq.
 145     '')
 146     (mkRemovedOptionModule [ "services" "dhcpd6" ] ''
 147       The dhcpd6 module has been removed because ISC DHCP reached its end of life.
 148       See https://www.isc.org/blogs/isc-dhcp-eol/ for details.
 149       Please switch to a different implementation like kea or dnsmasq.
 150     '')
 151     (mkRemovedOptionModule [ "services" "tedicross" ] ''
 152       The corresponding package was broken and removed from nixpkgs.
 153     '')
 154
 155     # Do NOT add any option renames here, see top of the file
 156   ];
 157 }