introt/zsys

ZSys daemon and client for zfs systems

ZSys

ZSys daemon and client for zfs systems

ZSys is a Zfs SYStem tool targeting an enhanced ZOL experience.

It allows running multiple ZFS systems in parallel on the same machine, get automated snapshots, managing complex zfs dataset layouts separating user data from system and persistent data, and more.

Documentation

You can find a whole series of blog posts explaining in details the internals and goals of ZSys.

Usage

User commands

zsysctl

ZFS SYStem integration control zsys daemon

Synopsis

Zfs SYStem tool for an enhanced ZFS on Linux experience. It allows running multiple ZFS system in parallels on the same machine, get automated snapshots, managing complex zfs dataset layouts separating user data from system and persistent data, and more.

zsysctl COMMAND [flags]

Options

  -h, --help            help for zsysctl
  -v, --verbose count   issue INFO (-v) and DEBUG (-vv) output

zsysctl completion

Generates completion scripts (will attempt to automatically detect shell)

Synopsis

To load completions: NOTE: When shell type isn't defined shell will be automatically identified based on the $SHELL environment vairable

Bash:

$ source <(zsysctl completion bash)

To load completions for each session, execute once:

Linux:

$ zsysctl completion bash > /etc/bash_completion.d/zsysctl

macOS:

$ zsysctl completion bash > /usr/local/etc/bash_completion.d/zsysctl

Zsh:

If shell completion is not already enabled in your environment,

you will need to enable it. You can execute the following once:

$ echo "autoload -U compinit; compinit" >> ~/.zshrc

To load completions for each session, execute once:

$ zsysctl completion zsh > "${fpath[1]}/_zsysctl"

You will need to start a new shell for this setup to take effect.

PowerShell:

PS> zsysctl completion powershell | Out-String | Invoke-Expression

To load completions for every new session, run:

PS> zsysctl completion powershell > zsysctl.ps1

and source this file from your PowerShell profile.

zsysctl completion [bash|zsh|powershell] [flags]

Options

  -h, --help   help for completion

Options inherited from parent commands

  -v, --verbose count   issue INFO (-v) and DEBUG (-vv) output

zsysctl list

List all the machines and basic information.

Synopsis

Alias of zsysctl machine list

zsysctl list [flags]

Options

  -h, --help   help for list

Options inherited from parent commands

  -v, --verbose count   issue INFO (-v) and DEBUG (-vv) output

zsysctl machine

Machine management

Synopsis

Machine management

zsysctl machine COMMAND [flags]

Options

  -h, --help   help for machine

Options inherited from parent commands

  -v, --verbose count   issue INFO (-v) and DEBUG (-vv) output

zsysctl machine list

List all the machines and basic information.

Synopsis

List all the machines and basic information.

zsysctl machine list [flags]

Options

  -h, --help   help for list

Options inherited from parent commands

  -v, --verbose count   issue INFO (-v) and DEBUG (-vv) output

zsysctl machine show

Shows the status of the machine.

Synopsis

Shows the status of the machine.

zsysctl machine show [MachineID] [flags]

Options

      --full   Give more detail informations on each machine.
  -h, --help   help for show

Options inherited from parent commands

  -v, --verbose count   issue INFO (-v) and DEBUG (-vv) output

zsysctl save

Saves the current state of the machine. By default it saves only the user state. state_id is generated if not provided.

Synopsis

Alias of zsysctl state save

zsysctl save [state id] [flags]

Options

      --auto                 Signal this is an automated request triggered by script
  -h, --help                 help for save
      --no-update-bootmenu   Do not update bootmenu on system state save
  -s, --system               Save complete system state (users and system)
  -u, --user string          Save the state for a given user or current user if empty

Options inherited from parent commands

  -v, --verbose count   issue INFO (-v) and DEBUG (-vv) output

zsysctl service

Service management

Synopsis

Service management

zsysctl service COMMAND [flags]

Options

  -h, --help   help for service

Options inherited from parent commands

  -v, --verbose count   issue INFO (-v) and DEBUG (-vv) output

zsysctl service dump

Dumps the current state of zsys.

Synopsis

Dumps the current state of zsys.

zsysctl service dump [flags]

Options

  -h, --help   help for dump

Options inherited from parent commands

  -v, --verbose count   issue INFO (-v) and DEBUG (-vv) output

zsysctl service gc

Run daemon state saves garbage collection.

Synopsis

Run daemon state saves garbage collection.

zsysctl service gc [flags]

Options

  -a, --all    Collects all the datasets including manual snapshots and clones.
  -h, --help   help for gc

Options inherited from parent commands

  -v, --verbose count   issue INFO (-v) and DEBUG (-vv) output

zsysctl service loglevel

Sets the logging level of the daemon.

Synopsis

Sets the logging level of the daemon.

zsysctl service loglevel 0|1|2 [flags]

Options

  -h, --help   help for loglevel

Options inherited from parent commands

  -v, --verbose count   issue INFO (-v) and DEBUG (-vv) output

zsysctl service refresh

Refreshes machines states.

Synopsis

Refreshes machines states.

zsysctl service refresh [flags]

Options

  -h, --help   help for refresh

Options inherited from parent commands

  -v, --verbose count   issue INFO (-v) and DEBUG (-vv) output

zsysctl service reload

Reloads daemon configuration.

Synopsis

Reloads daemon configuration.

zsysctl service reload [flags]

Options

  -h, --help   help for reload

Options inherited from parent commands

  -v, --verbose count   issue INFO (-v) and DEBUG (-vv) output

zsysctl service status

Shows the status of the daemon.

Synopsis

Shows the status of the daemon.

zsysctl service status [flags]

Options

  -h, --help   help for status

Options inherited from parent commands

  -v, --verbose count   issue INFO (-v) and DEBUG (-vv) output

zsysctl service stop

Stops zsys daemon.

Synopsis

Stops zsys daemon.

zsysctl service stop [flags]

Options

  -h, --help   help for stop

Options inherited from parent commands

  -v, --verbose count   issue INFO (-v) and DEBUG (-vv) output

zsysctl service trace

Start profiling until you exit this command yourself or when duration is done. Default is CPU profiling with a 30s timeout.

Synopsis

Start profiling until you exit this command yourself or when duration is done. Default is CPU profiling with a 30s timeout.

zsysctl service trace [flags]

Options

      --duration int    Duration of the capture. Default is 30 seconds. (default 30)
  -h, --help            help for trace
  -o, --output string   Dump the trace to a file. Default is ./zsys.<trace-type>.pprof
  -t, --type string     Type of profiling cpu or mem. Default is cpu. (default "cpu")

Options inherited from parent commands

  -v, --verbose count   issue INFO (-v) and DEBUG (-vv) output

zsysctl show

Shows the status of the machine.

Synopsis

Alias of zsysctl machine show

zsysctl show [MachineID] [flags]

Options

      --full   Give more detail informations on each machine.
  -h, --help   help for show

Options inherited from parent commands

  -v, --verbose count   issue INFO (-v) and DEBUG (-vv) output

zsysctl state

Machine state management

Synopsis

Machine state management

zsysctl state COMMAND [flags]

Options

  -h, --help   help for state

Options inherited from parent commands

  -v, --verbose count   issue INFO (-v) and DEBUG (-vv) output

zsysctl state remove

Remove the current state of the machine. By default it removes only the user state if not linked to any system state.

Synopsis

Remove the current state of the machine. By default it removes only the user state if not linked to any system state.

zsysctl state remove [state id] [flags]

Options

      --dry-run       Dry run, will not remove anything
  -f, --force         Force removing, even if dependencies are found
  -h, --help          help for remove
  -s, --system        Remove system state (system and users linked to it)
  -u, --user string   Remove the state for a given user or current user if empty

Options inherited from parent commands

  -v, --verbose count   issue INFO (-v) and DEBUG (-vv) output

zsysctl state save

Saves the current state of the machine. By default it saves only the user state. state_id is generated if not provided.

Synopsis

Saves the current state of the machine. By default it saves only the user state. state_id is generated if not provided.

zsysctl state save [state id] [flags]

Options

      --auto                 Signal this is an automated request triggered by script
  -h, --help                 help for save
      --no-update-bootmenu   Do not update bootmenu on system state save
  -s, --system               Save complete system state (users and system)
  -u, --user string          Save the state for a given user or current user if empty

Options inherited from parent commands

  -v, --verbose count   issue INFO (-v) and DEBUG (-vv) output

zsysctl version

Returns version of client and server

Synopsis

Returns version of client and server

zsysctl version [flags]

Options

  -h, --help   help for version

Options inherited from parent commands

  -v, --verbose count   issue INFO (-v) and DEBUG (-vv) output

zsysd

ZFS SYStem integration daemon

Synopsis

Zfs SYStem daemon for an enhanced ZFS on Linux experience. It allows running multiple ZFS system in parallels on the same machine, get automated snapshots, managing complex zfs dataset layouts separating user data from system and persistent data, and more.

zsysd [flags]

Options

  -h, --help            help for zsysd
  -v, --verbose count   issue INFO (-v) and DEBUG (-vv) output

zsysd completion

Generates completion scripts (will attempt to automatically detect shell)

Synopsis

To load completions: NOTE: When shell type isn't defined shell will be automatically identified based on the $SHELL environment vairable

Bash:

$ source <(zsysd completion bash)

To load completions for each session, execute once:

Linux:

$ zsysd completion bash > /etc/bash_completion.d/zsysd

macOS:

$ zsysd completion bash > /usr/local/etc/bash_completion.d/zsysd

Zsh:

If shell completion is not already enabled in your environment,

you will need to enable it. You can execute the following once:

$ echo "autoload -U compinit; compinit" >> ~/.zshrc

To load completions for each session, execute once:

$ zsysd completion zsh > "${fpath[1]}/_zsysd"

You will need to start a new shell for this setup to take effect.

PowerShell:

PS> zsysd completion powershell | Out-String | Invoke-Expression

To load completions for every new session, run:

PS> zsysd completion powershell > zsysd.ps1

and source this file from your PowerShell profile.

zsysd completion [bash|zsh|powershell] [flags]

Options

  -h, --help   help for completion

Options inherited from parent commands

  -v, --verbose count   issue INFO (-v) and DEBUG (-vv) output

System commands

Those commands are hidden from help and should primarily be used by the system itself.

zsysctl boot

Ensure that the right datasets are ready to be mounted and committed during early boot

Synopsis

Ensure that the right datasets are ready to be mounted and committed during early boot

zsysctl boot COMMAND [flags]

Options

  -h, --help            help for boot
  -p, --print-changes   Display if any zfs datasets have been modified to boot

Options inherited from parent commands

  -v, --verbose count   issue INFO (-v) and DEBUG (-vv) output

zsysctl boot commit

Commit system and user datasets states as a successful boot

Synopsis

Commit system and user datasets states as a successful boot

zsysctl boot commit [flags]

Options

  -h, --help   help for commit

Options inherited from parent commands

  -p, --print-changes   Display if any zfs datasets have been modified to boot
  -v, --verbose count   issue INFO (-v) and DEBUG (-vv) output

zsysctl boot prepare

Prepare boot by ensuring correct system and user datasets are switched on and off

Synopsis

Prepare boot by ensuring correct system and user datasets are switched on and off

zsysctl boot prepare [flags]

Options

  -h, --help   help for prepare

Options inherited from parent commands

  -p, --print-changes   Display if any zfs datasets have been modified to boot
  -v, --verbose count   issue INFO (-v) and DEBUG (-vv) output

zsysctl boot update-lastused

Update last used timestamp

Synopsis

Update last used timestamp

zsysctl boot update-lastused [flags]

Options

  -h, --help   help for update-lastused

Options inherited from parent commands

  -p, --print-changes   Display if any zfs datasets have been modified to boot
  -v, --verbose count   issue INFO (-v) and DEBUG (-vv) output

zsysctl boot update-menu

Update system boot menu

Synopsis

Update system boot menu

zsysctl boot update-menu [flags]

Options

      --auto   Signal this is an automated request triggered by script
  -h, --help   help for update-menu

Options inherited from parent commands

  -p, --print-changes   Display if any zfs datasets have been modified to boot
  -v, --verbose count   issue INFO (-v) and DEBUG (-vv) output

zsysctl userdata

User datasets creation and rename

Synopsis

User datasets creation and rename

zsysctl userdata COMMAND [flags]

Options

  -h, --help   help for userdata

Options inherited from parent commands

  -v, --verbose count   issue INFO (-v) and DEBUG (-vv) output

zsysctl userdata create

Create a new home user dataset via an user dataset (if doesn't exist) creation

Synopsis

Create a new home user dataset via an user dataset (if doesn't exist) creation

zsysctl userdata create USER HOME_DIRECTORY [flags]

Options

  -h, --help   help for create

Options inherited from parent commands

  -v, --verbose count   issue INFO (-v) and DEBUG (-vv) output

zsysctl userdata dissociate

dissociate current user data from current system but preserve history

Synopsis

dissociate current user data from current system but preserve history

zsysctl userdata dissociate USER [flags]

Options

  -h, --help     help for dissociate
  -r, --remove   Empty home directory content if not associated to any machine state

Options inherited from parent commands

  -v, --verbose count   issue INFO (-v) and DEBUG (-vv) output

zsysctl userdata set-home

Rename a user's home directory via renaming corresponding user dataset

Synopsis

Rename a user's home directory via renaming corresponding user dataset

zsysctl userdata set-home OLD_HOME NEW_HOME [flags]

Options

  -h, --help   help for set-home

Options inherited from parent commands

  -v, --verbose count   issue INFO (-v) and DEBUG (-vv) output

zsysd boot-prepare

Prepare boot by ensuring correct system and user datasets are switched on and off, synchronously

Synopsis

Prepare boot by ensuring correct system and user datasets are switched on and off, synchronously

zsysd boot-prepare [flags]

Options

  -h, --help   help for boot-prepare

Options inherited from parent commands

  -v, --verbose count   issue INFO (-v) and DEBUG (-vv) output