{ config, pkgs, ... }: with pkgs.lib; let inherit (pkgs) writeText openssh; cfg = config.services.nfsKernel; exports = pkgs.writeText "exports" cfg.server.exports; /* Description at http://nfs.sourceforge.net/nfs-howto/ar01s03.html : "If your distribution does not include them in the startup scripts, then then you should add them, configured to start in the following order: rpc.portmap rpc.mountd, rpc.nfsd rpc.statd, rpc.lockd (if necessary), and rpc.rquotad" I tried to mimic that with upstart, playing with stopping/stopped/started/starting events. I consider two scenarios: - Starting at boot. Then, portmap will emit a started event. - "restart nfs-kernel-exports". Then, portmap will not emit anything. Due to the comment in postStart, this will happen on nixos-rebuild if the exportfs file changed. From these scenarios, I came up with the startOn and stopOn at the time of commiting this comment. */ in { ###### interface options = { services.nfsKernel = { client.enable = mkOption { default = any (fs: fs.fsType == "nfs" || fs.fsType == "nfs4") config.fileSystems; description = '' Whether to enable the kernel's NFS client daemons. ''; }; server = { enable = mkOption { default = false; description = '' Whether to enable the kernel's NFS server. ''; }; exports = mkOption { default = ""; description = '' Contents of the /etc/exports file. See exports 5 for the format. ''; }; hostName = mkOption { default = null; description = '' Hostname or address on which NFS requests will be accepted. Default is all. See the option in nfsd 8. ''; }; nproc = mkOption { default = 8; description = '' Number of NFS server threads. Defaults to the recommended value of 8. ''; }; createMountPoints = mkOption { default = false; description = "Whether to create the mount points in the exports file at startup time."; }; }; }; }; ###### implementation config = mkAssert (cfg.client.enable || cfg.server.enable -> config.services.portmap.enable) " Please enable portmap (services.portmap.enable) to use nfs-kernel. " { services.portmap.enable = mkAlways (cfg.client.enable || cfg.server.enable); environment.etc = mkIf cfg.server.enable (singleton { source = exports; target = "exports"; }); jobs = optionalAttrs cfg.server.enable { nfs_kernel_exports = { name = "nfs-kernel-exports"; description = "Kernel NFS server"; startOn = "started network-interfaces and started portmap"; postStart = '' # exports file is ${exports} # keep this comment so that this job is restarted whenever exports changes! exportfs -ra ''; }; } // optionalAttrs cfg.server.enable { nfs_kernel_nfsd = { name = "nfs-kernel-nfsd"; description = "Kernel NFS server"; startOn = "starting nfs-kernel-exports or started portmap"; stopOn = "stopped nfs-kernel-statd or stopping portmap"; preStart = '' export PATH=${pkgs.nfsUtils}/sbin:$PATH mkdir -p /var/lib/nfs # Create a state directory required by NFSv4. mkdir -p /var/lib/nfs/v4recovery # rpc.nfsd needs the kernel support ${config.system.sbin.modprobe}/sbin/modprobe nfsd || true ${pkgs.sysvtools}/bin/mountpoint -q /proc/fs/nfsd \ || ${config.system.sbin.mount}/bin/mount -t nfsd none /proc/fs/nfsd ${optionalString cfg.server.createMountPoints '' # create export directories: # skip comments, take first col which may either be a quoted # "foo bar" or just foo (-> man export) sed '/^#.*/d;s/^"\([^"]*\)".*/\1/;t;s/[ ].*//' ${exports} \ | xargs -d '\n' mkdir -p '' } ${pkgs.nfsUtils}/sbin/rpc.nfsd \ ${if cfg.server.hostName != null then "-H ${cfg.server.hostName}" else ""} \ ${builtins.toString cfg.server.nproc} ''; postStop = "${pkgs.nfsUtils}/sbin/rpc.nfsd 0"; }; } // optionalAttrs cfg.server.enable { nfs_kernel_mountd = { name = "nfs-kernel-mountd"; description = "Kernel NFS server - mount daemon"; startOn = "starting nfs-kernel-exports or started portmap"; stopOn = "stopped nfs-kernel-statd"; daemonType = "fork"; exec = "${pkgs.nfsUtils}/sbin/rpc.mountd -f /etc/exports"; }; } // optionalAttrs (cfg.client.enable || cfg.server.enable) { nfs_kernel_statd = { name = "nfs-kernel-statd"; description = "Kernel NFS server - Network Status Monitor"; startOn = if (cfg.server.enable) then "started nfs-kernel-mountd and started nfs-kernel-nfsd" else "started portmap"; stopOn = "stopping nfs-kernel-exports or stopping portmap"; preStart = '' mkdir -p /var/lib/nfs mkdir -p /var/lib/nfs/sm mkdir -p /var/lib/nfs/sm.bak ''; daemonType = "fork"; exec = "${pkgs.nfsUtils}/sbin/rpc.statd --no-notify"; postStart = "${pkgs.nfsUtils}/sbin/sm-notify -d"; }; }; }; }