• Stars
    star
    179
  • Rank 209,562 (Top 5 %)
  • Language
    Go
  • License
    GNU General Publi...
  • Created over 3 years ago
  • Updated 24 days ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

Active Directory bridging tool suite

adsys

Active Directory bridging toolset

Code quality Code coverage Go Reference Go Report Card License

Usage

User commands

adsysctl

AD integration client

Synopsis

Active Directory integration bridging toolset command line tool.

adsysctl COMMAND [flags]
Options
  -c, --config string   use a specific configuration file
  -h, --help            help for adsysctl
  -s, --socket string   socket path to use between daemon and client. Can be overridden by systemd socket activation. (default "/run/adsysd.sock")
  -t, --timeout int     time in seconds before cancelling the client request when the server gives no result. 0 for no timeout. (default 30)
  -v, --verbose count   issue INFO (-v), DEBUG (-vv) or DEBUG with caller (-vvv) output

adsysctl applied

Print last applied GPOs for current or given user/machine

Synopsis

Alias of "policy applied"

adsysctl applied [USER_NAME] [flags]
Options
  -a, --all        show overridden rules in each GPOs.
      --details    show applied rules in addition to GPOs.
  -h, --help       help for applied
  -m, --machine    show applied rules to the machine.
      --no-color   don't display colorized version.
Options inherited from parent commands
  -c, --config string   use a specific configuration file
  -s, --socket string   socket path to use between daemon and client. Can be overridden by systemd socket activation. (default "/run/adsysd.sock")
  -t, --timeout int     time in seconds before cancelling the client request when the server gives no result. 0 for no timeout. (default 30)
  -v, --verbose count   issue INFO (-v), DEBUG (-vv) or DEBUG with caller (-vvv) output

adsysctl completion

Generate the autocompletion script for the specified shell

Synopsis

Generate the autocompletion script for adsysctl for the specified shell. See each sub-command's help for details on how to use the generated script.

Options
  -h, --help   help for completion
Options inherited from parent commands
  -c, --config string   use a specific configuration file
  -s, --socket string   socket path to use between daemon and client. Can be overridden by systemd socket activation. (default "/run/adsysd.sock")
  -t, --timeout int     time in seconds before cancelling the client request when the server gives no result. 0 for no timeout. (default 30)
  -v, --verbose count   issue INFO (-v), DEBUG (-vv) or DEBUG with caller (-vvv) output

adsysctl completion bash

Generate the autocompletion script for bash

Synopsis

Generate the autocompletion script for the bash shell.

This script depends on the 'bash-completion' package. If it is not installed already, you can install it via your OS's package manager.

To load completions in your current shell session:

source <(adsysctl completion bash)

To load completions for every new session, execute once:

Linux:
adsysctl completion bash > /etc/bash_completion.d/adsysctl
macOS:
adsysctl completion bash > $(brew --prefix)/etc/bash_completion.d/adsysctl

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

adsysctl completion bash
Options
  -h, --help              help for bash
      --no-descriptions   disable completion descriptions
Options inherited from parent commands
  -c, --config string   use a specific configuration file
  -s, --socket string   socket path to use between daemon and client. Can be overridden by systemd socket activation. (default "/run/adsysd.sock")
  -t, --timeout int     time in seconds before cancelling the client request when the server gives no result. 0 for no timeout. (default 30)
  -v, --verbose count   issue INFO (-v), DEBUG (-vv) or DEBUG with caller (-vvv) output

adsysctl completion fish

Generate the autocompletion script for fish

Synopsis

Generate the autocompletion script for the fish shell.

To load completions in your current shell session:

adsysctl completion fish | source

To load completions for every new session, execute once:

adsysctl completion fish > ~/.config/fish/completions/adsysctl.fish

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

adsysctl completion fish [flags]
Options
  -h, --help              help for fish
      --no-descriptions   disable completion descriptions
Options inherited from parent commands
  -c, --config string   use a specific configuration file
  -s, --socket string   socket path to use between daemon and client. Can be overridden by systemd socket activation. (default "/run/adsysd.sock")
  -t, --timeout int     time in seconds before cancelling the client request when the server gives no result. 0 for no timeout. (default 30)
  -v, --verbose count   issue INFO (-v), DEBUG (-vv) or DEBUG with caller (-vvv) output

adsysctl completion powershell

Generate the autocompletion script for powershell

Synopsis

Generate the autocompletion script for powershell.

To load completions in your current shell session:

adsysctl completion powershell | Out-String | Invoke-Expression

To load completions for every new session, add the output of the above command to your powershell profile.

adsysctl completion powershell [flags]
Options
  -h, --help              help for powershell
      --no-descriptions   disable completion descriptions
Options inherited from parent commands
  -c, --config string   use a specific configuration file
  -s, --socket string   socket path to use between daemon and client. Can be overridden by systemd socket activation. (default "/run/adsysd.sock")
  -t, --timeout int     time in seconds before cancelling the client request when the server gives no result. 0 for no timeout. (default 30)
  -v, --verbose count   issue INFO (-v), DEBUG (-vv) or DEBUG with caller (-vvv) output

adsysctl completion zsh

Generate the autocompletion script for zsh

Synopsis

Generate the autocompletion script for the zsh shell.

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 in your current shell session:

source <(adsysctl completion zsh)

To load completions for every new session, execute once:

Linux:
adsysctl completion zsh > "${fpath[1]}/_adsysctl"
macOS:
adsysctl completion zsh > $(brew --prefix)/share/zsh/site-functions/_adsysctl

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

adsysctl completion zsh [flags]
Options
  -h, --help              help for zsh
      --no-descriptions   disable completion descriptions
Options inherited from parent commands
  -c, --config string   use a specific configuration file
  -s, --socket string   socket path to use between daemon and client. Can be overridden by systemd socket activation. (default "/run/adsysd.sock")
  -t, --timeout int     time in seconds before cancelling the client request when the server gives no result. 0 for no timeout. (default 30)
  -v, --verbose count   issue INFO (-v), DEBUG (-vv) or DEBUG with caller (-vvv) output

adsysctl doc

Documentation

adsysctl doc [CHAPTER] [flags]
Options
  -d, --dest string     Write documentation file(s) to this directory.
  -f, --format string   Format type (markdown, raw or html). (default "markdown")
  -h, --help            help for doc
Options inherited from parent commands
  -c, --config string   use a specific configuration file
  -s, --socket string   socket path to use between daemon and client. Can be overridden by systemd socket activation. (default "/run/adsysd.sock")
  -t, --timeout int     time in seconds before cancelling the client request when the server gives no result. 0 for no timeout. (default 30)
  -v, --verbose count   issue INFO (-v), DEBUG (-vv) or DEBUG with caller (-vvv) output

adsysctl policy

Policy management

adsysctl policy COMMAND [flags]
Options
  -h, --help   help for policy
Options inherited from parent commands
  -c, --config string   use a specific configuration file
  -s, --socket string   socket path to use between daemon and client. Can be overridden by systemd socket activation. (default "/run/adsysd.sock")
  -t, --timeout int     time in seconds before cancelling the client request when the server gives no result. 0 for no timeout. (default 30)
  -v, --verbose count   issue INFO (-v), DEBUG (-vv) or DEBUG with caller (-vvv) output

adsysctl policy admx

Dump windows policy definitions

adsysctl policy admx lts-only|all [flags]
Options
      --distro string   distro for which to retrieve policy definition. (default "Ubuntu")
  -h, --help            help for admx
Options inherited from parent commands
  -c, --config string   use a specific configuration file
  -s, --socket string   socket path to use between daemon and client. Can be overridden by systemd socket activation. (default "/run/adsysd.sock")
  -t, --timeout int     time in seconds before cancelling the client request when the server gives no result. 0 for no timeout. (default 30)
  -v, --verbose count   issue INFO (-v), DEBUG (-vv) or DEBUG with caller (-vvv) output

adsysctl policy applied

Print last applied GPOs for current or given user/machine

adsysctl policy applied [USER_NAME] [flags]
Options
  -a, --all        show overridden rules in each GPOs.
      --details    show applied rules in addition to GPOs.
  -h, --help       help for applied
  -m, --machine    show applied rules to the machine.
      --no-color   don't display colorized version.
Options inherited from parent commands
  -c, --config string   use a specific configuration file
  -s, --socket string   socket path to use between daemon and client. Can be overridden by systemd socket activation. (default "/run/adsysd.sock")
  -t, --timeout int     time in seconds before cancelling the client request when the server gives no result. 0 for no timeout. (default 30)
  -v, --verbose count   issue INFO (-v), DEBUG (-vv) or DEBUG with caller (-vvv) output

adsysctl policy purge

Purges policies for the current user or a specified one

adsysctl policy purge [USER_NAME] [flags]
Options
  -a, --all       all purges the policy of the computer and all the logged in users. -m or USER_NAME cannot be used with this option.
  -h, --help      help for purge
  -m, --machine   machine purges the policy of the computer.
Options inherited from parent commands
  -c, --config string   use a specific configuration file
  -s, --socket string   socket path to use between daemon and client. Can be overridden by systemd socket activation. (default "/run/adsysd.sock")
  -t, --timeout int     time in seconds before cancelling the client request when the server gives no result. 0 for no timeout. (default 30)
  -v, --verbose count   issue INFO (-v), DEBUG (-vv) or DEBUG with caller (-vvv) output

adsysctl policy update

Updates/Create a policy for current user or given user with its kerberos ticket

adsysctl policy update [USER_NAME KERBEROS_TICKET_PATH] [flags]
Options
  -a, --all       all updates the policy of the computer and all the logged in users. -m or USER_NAME/TICKET cannot be used with this option.
  -h, --help      help for update
  -m, --machine   machine updates the policy of the computer.
Options inherited from parent commands
  -c, --config string   use a specific configuration file
  -s, --socket string   socket path to use between daemon and client. Can be overridden by systemd socket activation. (default "/run/adsysd.sock")
  -t, --timeout int     time in seconds before cancelling the client request when the server gives no result. 0 for no timeout. (default 30)
  -v, --verbose count   issue INFO (-v), DEBUG (-vv) or DEBUG with caller (-vvv) output

adsysctl service

Service management

adsysctl service COMMAND [flags]
Options
  -h, --help   help for service
Options inherited from parent commands
  -c, --config string   use a specific configuration file
  -s, --socket string   socket path to use between daemon and client. Can be overridden by systemd socket activation. (default "/run/adsysd.sock")
  -t, --timeout int     time in seconds before cancelling the client request when the server gives no result. 0 for no timeout. (default 30)
  -v, --verbose count   issue INFO (-v), DEBUG (-vv) or DEBUG with caller (-vvv) output

adsysctl service cat

Print service logs

adsysctl service cat [flags]
Options
  -h, --help   help for cat
Options inherited from parent commands
  -c, --config string   use a specific configuration file
  -s, --socket string   socket path to use between daemon and client. Can be overridden by systemd socket activation. (default "/run/adsysd.sock")
  -t, --timeout int     time in seconds before cancelling the client request when the server gives no result. 0 for no timeout. (default 30)
  -v, --verbose count   issue INFO (-v), DEBUG (-vv) or DEBUG with caller (-vvv) output

adsysctl service status

Print service status

adsysctl service status [flags]
Options
  -h, --help   help for status
Options inherited from parent commands
  -c, --config string   use a specific configuration file
  -s, --socket string   socket path to use between daemon and client. Can be overridden by systemd socket activation. (default "/run/adsysd.sock")
  -t, --timeout int     time in seconds before cancelling the client request when the server gives no result. 0 for no timeout. (default 30)
  -v, --verbose count   issue INFO (-v), DEBUG (-vv) or DEBUG with caller (-vvv) output

adsysctl service stop

Requests to stop the service once all connections are done

adsysctl service stop [flags]
Options
  -f, --force   force will shut it down immediately and drop existing connections.
  -h, --help    help for stop
Options inherited from parent commands
  -c, --config string   use a specific configuration file
  -s, --socket string   socket path to use between daemon and client. Can be overridden by systemd socket activation. (default "/run/adsysd.sock")
  -t, --timeout int     time in seconds before cancelling the client request when the server gives no result. 0 for no timeout. (default 30)
  -v, --verbose count   issue INFO (-v), DEBUG (-vv) or DEBUG with caller (-vvv) output

adsysctl update

Updates/Create a policy for current user or given user with its kerberos ticket

Synopsis

Alias of "policy update"

adsysctl update [USER_NAME KERBEROS_TICKET_PATH] [flags]
Options
  -a, --all       all updates the policy of the computer and all the logged in users. -m or USER_NAME/TICKET cannot be used with this option.
  -h, --help      help for update
  -m, --machine   machine updates the policy of the computer.
Options inherited from parent commands
  -c, --config string   use a specific configuration file
  -s, --socket string   socket path to use between daemon and client. Can be overridden by systemd socket activation. (default "/run/adsysd.sock")
  -t, --timeout int     time in seconds before cancelling the client request when the server gives no result. 0 for no timeout. (default 30)
  -v, --verbose count   issue INFO (-v), DEBUG (-vv) or DEBUG with caller (-vvv) output

adsysctl version

Returns version of client and service

adsysctl version [flags]
Options
  -h, --help   help for version
Options inherited from parent commands
  -c, --config string   use a specific configuration file
  -s, --socket string   socket path to use between daemon and client. Can be overridden by systemd socket activation. (default "/run/adsysd.sock")
  -t, --timeout int     time in seconds before cancelling the client request when the server gives no result. 0 for no timeout. (default 30)
  -v, --verbose count   issue INFO (-v), DEBUG (-vv) or DEBUG with caller (-vvv) output

adsysd

AD integration daemon

Synopsis

Active Directory integration bridging toolset daemon.

adsysd COMMAND [flags]
Options
      --ad-backend string       Active Directory authentication backend (default "sssd")
      --cache-dir string        directory where ADsys caches GPOs downloads and policies. (default "/var/cache/adsys")
  -c, --config string           use a specific configuration file
  -h, --help                    help for adsysd
      --run-dir string          directory where ADsys stores transient information erased on reboot. (default "/run/adsys")
  -s, --socket string           socket path to use between daemon and client. Can be overridden by systemd socket activation. (default "/run/adsysd.sock")
      --sssd.cache-dir string   SSSd cache directory (default "/var/lib/sss/db")
      --sssd.config string      SSSd config file path (default "/etc/sssd/sssd.conf")
  -t, --timeout int             time in seconds without activity before the service exists. 0 for no timeout. (default 120)
  -v, --verbose count           issue INFO (-v), DEBUG (-vv) or DEBUG with caller (-vvv) output

adsysd completion

Generate the autocompletion script for the specified shell

Synopsis

Generate the autocompletion script for adsysd for the specified shell. See each sub-command's help for details on how to use the generated script.

Options
  -h, --help   help for completion
Options inherited from parent commands
      --ad-backend string       Active Directory authentication backend (default "sssd")
      --cache-dir string        directory where ADsys caches GPOs downloads and policies. (default "/var/cache/adsys")
  -c, --config string           use a specific configuration file
      --run-dir string          directory where ADsys stores transient information erased on reboot. (default "/run/adsys")
  -s, --socket string           socket path to use between daemon and client. Can be overridden by systemd socket activation. (default "/run/adsysd.sock")
      --sssd.cache-dir string   SSSd cache directory (default "/var/lib/sss/db")
      --sssd.config string      SSSd config file path (default "/etc/sssd/sssd.conf")
  -t, --timeout int             time in seconds without activity before the service exists. 0 for no timeout. (default 120)
  -v, --verbose count           issue INFO (-v), DEBUG (-vv) or DEBUG with caller (-vvv) output

adsysd completion bash

Generate the autocompletion script for bash

Synopsis

Generate the autocompletion script for the bash shell.

This script depends on the 'bash-completion' package. If it is not installed already, you can install it via your OS's package manager.

To load completions in your current shell session:

source <(adsysd completion bash)

To load completions for every new session, execute once:

Linux:
adsysd completion bash > /etc/bash_completion.d/adsysd
macOS:
adsysd completion bash > $(brew --prefix)/etc/bash_completion.d/adsysd

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

adsysd completion bash
Options
  -h, --help              help for bash
      --no-descriptions   disable completion descriptions
Options inherited from parent commands
      --ad-backend string       Active Directory authentication backend (default "sssd")
      --cache-dir string        directory where ADsys caches GPOs downloads and policies. (default "/var/cache/adsys")
  -c, --config string           use a specific configuration file
      --run-dir string          directory where ADsys stores transient information erased on reboot. (default "/run/adsys")
  -s, --socket string           socket path to use between daemon and client. Can be overridden by systemd socket activation. (default "/run/adsysd.sock")
      --sssd.cache-dir string   SSSd cache directory (default "/var/lib/sss/db")
      --sssd.config string      SSSd config file path (default "/etc/sssd/sssd.conf")
  -t, --timeout int             time in seconds without activity before the service exists. 0 for no timeout. (default 120)
  -v, --verbose count           issue INFO (-v), DEBUG (-vv) or DEBUG with caller (-vvv) output

adsysd completion fish

Generate the autocompletion script for fish

Synopsis

Generate the autocompletion script for the fish shell.

To load completions in your current shell session:

adsysd completion fish | source

To load completions for every new session, execute once:

adsysd completion fish > ~/.config/fish/completions/adsysd.fish

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

adsysd completion fish [flags]
Options
  -h, --help              help for fish
      --no-descriptions   disable completion descriptions
Options inherited from parent commands
      --ad-backend string       Active Directory authentication backend (default "sssd")
      --cache-dir string        directory where ADsys caches GPOs downloads and policies. (default "/var/cache/adsys")
  -c, --config string           use a specific configuration file
      --run-dir string          directory where ADsys stores transient information erased on reboot. (default "/run/adsys")
  -s, --socket string           socket path to use between daemon and client. Can be overridden by systemd socket activation. (default "/run/adsysd.sock")
      --sssd.cache-dir string   SSSd cache directory (default "/var/lib/sss/db")
      --sssd.config string      SSSd config file path (default "/etc/sssd/sssd.conf")
  -t, --timeout int             time in seconds without activity before the service exists. 0 for no timeout. (default 120)
  -v, --verbose count           issue INFO (-v), DEBUG (-vv) or DEBUG with caller (-vvv) output

adsysd completion powershell

Generate the autocompletion script for powershell

Synopsis

Generate the autocompletion script for powershell.

To load completions in your current shell session:

adsysd completion powershell | Out-String | Invoke-Expression

To load completions for every new session, add the output of the above command to your powershell profile.

adsysd completion powershell [flags]
Options
  -h, --help              help for powershell
      --no-descriptions   disable completion descriptions
Options inherited from parent commands
      --ad-backend string       Active Directory authentication backend (default "sssd")
      --cache-dir string        directory where ADsys caches GPOs downloads and policies. (default "/var/cache/adsys")
  -c, --config string           use a specific configuration file
      --run-dir string          directory where ADsys stores transient information erased on reboot. (default "/run/adsys")
  -s, --socket string           socket path to use between daemon and client. Can be overridden by systemd socket activation. (default "/run/adsysd.sock")
      --sssd.cache-dir string   SSSd cache directory (default "/var/lib/sss/db")
      --sssd.config string      SSSd config file path (default "/etc/sssd/sssd.conf")
  -t, --timeout int             time in seconds without activity before the service exists. 0 for no timeout. (default 120)
  -v, --verbose count           issue INFO (-v), DEBUG (-vv) or DEBUG with caller (-vvv) output

adsysd completion zsh

Generate the autocompletion script for zsh

Synopsis

Generate the autocompletion script for the zsh shell.

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 in your current shell session:

source <(adsysd completion zsh)

To load completions for every new session, execute once:

Linux:
adsysd completion zsh > "${fpath[1]}/_adsysd"
macOS:
adsysd completion zsh > $(brew --prefix)/share/zsh/site-functions/_adsysd

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

adsysd completion zsh [flags]
Options
  -h, --help              help for zsh
      --no-descriptions   disable completion descriptions
Options inherited from parent commands
      --ad-backend string       Active Directory authentication backend (default "sssd")
      --cache-dir string        directory where ADsys caches GPOs downloads and policies. (default "/var/cache/adsys")
  -c, --config string           use a specific configuration file
      --run-dir string          directory where ADsys stores transient information erased on reboot. (default "/run/adsys")
  -s, --socket string           socket path to use between daemon and client. Can be overridden by systemd socket activation. (default "/run/adsysd.sock")
      --sssd.cache-dir string   SSSd cache directory (default "/var/lib/sss/db")
      --sssd.config string      SSSd config file path (default "/etc/sssd/sssd.conf")
  -t, --timeout int             time in seconds without activity before the service exists. 0 for no timeout. (default 120)
  -v, --verbose count           issue INFO (-v), DEBUG (-vv) or DEBUG with caller (-vvv) output

adsysd version

Returns version of service and exits

adsysd version [flags]
Options
  -h, --help   help for version
Options inherited from parent commands
      --ad-backend string       Active Directory authentication backend (default "sssd")
      --cache-dir string        directory where ADsys caches GPOs downloads and policies. (default "/var/cache/adsys")
  -c, --config string           use a specific configuration file
      --run-dir string          directory where ADsys stores transient information erased on reboot. (default "/run/adsys")
  -s, --socket string           socket path to use between daemon and client. Can be overridden by systemd socket activation. (default "/run/adsysd.sock")
      --sssd.cache-dir string   SSSd cache directory (default "/var/lib/sss/db")
      --sssd.config string      SSSd config file path (default "/etc/sssd/sssd.conf")
  -t, --timeout int             time in seconds without activity before the service exists. 0 for no timeout. (default 120)
  -v, --verbose count           issue INFO (-v), DEBUG (-vv) or DEBUG with caller (-vvv) output

adwatchd

AD watch daemon

Synopsis

Watch directories for changes and bump the relevant GPT.ini versions.

adwatchd [COMMAND] [flags]
Options
  -c, --config string   use a specific configuration file
  -h, --help            help for adwatchd
  -v, --verbose count   issue INFO (-v), DEBUG (-vv) or DEBUG with caller (-vvv) output

adwatchd completion

Generate the autocompletion script for the specified shell

Synopsis

Generate the autocompletion script for adwatchd for the specified shell. See each sub-command's help for details on how to use the generated script.

Options
  -h, --help   help for completion
Options inherited from parent commands
  -v, --verbose count   issue INFO (-v), DEBUG (-vv) or DEBUG with caller (-vvv) output

adwatchd completion bash

Generate the autocompletion script for bash

Synopsis

Generate the autocompletion script for the bash shell.

This script depends on the 'bash-completion' package. If it is not installed already, you can install it via your OS's package manager.

To load completions in your current shell session:

source <(adwatchd completion bash)

To load completions for every new session, execute once:

Linux:
adwatchd completion bash > /etc/bash_completion.d/adwatchd
macOS:
adwatchd completion bash > $(brew --prefix)/etc/bash_completion.d/adwatchd

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

adwatchd completion bash
Options
  -h, --help              help for bash
      --no-descriptions   disable completion descriptions
Options inherited from parent commands
  -v, --verbose count   issue INFO (-v), DEBUG (-vv) or DEBUG with caller (-vvv) output

adwatchd completion fish

Generate the autocompletion script for fish

Synopsis

Generate the autocompletion script for the fish shell.

To load completions in your current shell session:

adwatchd completion fish | source

To load completions for every new session, execute once:

adwatchd completion fish > ~/.config/fish/completions/adwatchd.fish

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

adwatchd completion fish [flags]
Options
  -h, --help              help for fish
      --no-descriptions   disable completion descriptions
Options inherited from parent commands
  -v, --verbose count   issue INFO (-v), DEBUG (-vv) or DEBUG with caller (-vvv) output

adwatchd completion powershell

Generate the autocompletion script for powershell

Synopsis

Generate the autocompletion script for powershell.

To load completions in your current shell session:

adwatchd completion powershell | Out-String | Invoke-Expression

To load completions for every new session, add the output of the above command to your powershell profile.

adwatchd completion powershell [flags]
Options
  -h, --help              help for powershell
      --no-descriptions   disable completion descriptions
Options inherited from parent commands
  -v, --verbose count   issue INFO (-v), DEBUG (-vv) or DEBUG with caller (-vvv) output

adwatchd completion zsh

Generate the autocompletion script for zsh

Synopsis

Generate the autocompletion script for the zsh shell.

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 in your current shell session:

source <(adwatchd completion zsh)

To load completions for every new session, execute once:

Linux:
adwatchd completion zsh > "${fpath[1]}/_adwatchd"
macOS:
adwatchd completion zsh > $(brew --prefix)/share/zsh/site-functions/_adwatchd

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

adwatchd completion zsh [flags]
Options
  -h, --help              help for zsh
      --no-descriptions   disable completion descriptions
Options inherited from parent commands
  -v, --verbose count   issue INFO (-v), DEBUG (-vv) or DEBUG with caller (-vvv) output

adwatchd run

Starts the directory watch loop

Synopsis

Can run as a service through the service manager or interactively as a standalone application.

The program will monitor the configured directories for changes and bump the appropriate GPT.ini versions anytime a change is detected. If a GPT.ini file does not exist for a directory, a warning will be issued and the file will be created. If the GPT.ini file is incompatible or malformed, the program will report an error.

adwatchd run [flags]
Options
  -c, --config string    use a specific configuration file
  -d, --dirs directory   a directory to check for changes (can be specified multiple times)
  -f, --force            force the program to run even if another instance is already running
  -h, --help             help for run
Options inherited from parent commands
  -v, --verbose count   issue INFO (-v), DEBUG (-vv) or DEBUG with caller (-vvv) output

adwatchd service

Manages the adwatchd service

Synopsis

The service command allows the user to interact with the adwatchd service. It can manage and query the service status, and also install and uninstall the service.

adwatchd service COMMAND [flags]
Options
  -h, --help   help for service
Options inherited from parent commands
  -v, --verbose count   issue INFO (-v), DEBUG (-vv) or DEBUG with caller (-vvv) output

adwatchd service install

Installs the service

Synopsis

Installs the adwatchd service.

The service will be installed as a Windows service.

adwatchd service install [flags]
Options
  -c, --config string   use a specific configuration file
  -h, --help            help for install
Options inherited from parent commands
  -v, --verbose count   issue INFO (-v), DEBUG (-vv) or DEBUG with caller (-vvv) output

adwatchd service restart

Restarts the service

Synopsis

Restarts the adwatchd service.

adwatchd service restart [flags]
Options
  -h, --help   help for restart
Options inherited from parent commands
  -v, --verbose count   issue INFO (-v), DEBUG (-vv) or DEBUG with caller (-vvv) output

adwatchd service start

Starts the service

Synopsis

Starts the adwatchd service.

adwatchd service start [flags]
Options
  -h, --help   help for start
Options inherited from parent commands
  -v, --verbose count   issue INFO (-v), DEBUG (-vv) or DEBUG with caller (-vvv) output

adwatchd service status

Returns service status

Synopsis

Returns the status of the adwatchd service.

adwatchd service status [flags]
Options
  -h, --help   help for status
Options inherited from parent commands
  -v, --verbose count   issue INFO (-v), DEBUG (-vv) or DEBUG with caller (-vvv) output

adwatchd service stop

Stops the service

Synopsis

Stops the adwatchd service.

adwatchd service stop [flags]
Options
  -h, --help   help for stop
Options inherited from parent commands
  -v, --verbose count   issue INFO (-v), DEBUG (-vv) or DEBUG with caller (-vvv) output

adwatchd service uninstall

Uninstalls the service

Synopsis

Uninstalls the adwatchd service.

adwatchd service uninstall [flags]
Options
  -h, --help   help for uninstall
Options inherited from parent commands
  -v, --verbose count   issue INFO (-v), DEBUG (-vv) or DEBUG with caller (-vvv) output

adwatchd version

Returns version of service and exits

adwatchd version [flags]
Options
  -h, --help   help for version
Options inherited from parent commands
  -v, --verbose count   issue INFO (-v), DEBUG (-vv) or DEBUG with caller (-vvv) output

Hidden commands

Those commands are hidden from help and should primarily be used by the system or for debugging.

adsysctl policy debug

Debug various policy infos

adsysctl policy debug [flags]
Options
  -h, --help   help for debug
Options inherited from parent commands
  -c, --config string   use a specific configuration file
  -s, --socket string   socket path to use between daemon and client. Can be overridden by systemd socket activation. (default "/run/adsysd.sock")
  -t, --timeout int     time in seconds before cancelling the client request when the server gives no result. 0 for no timeout. (default 30)
  -v, --verbose count   issue INFO (-v), DEBUG (-vv) or DEBUG with caller (-vvv) output

adsysctl policy debug gpolist-script

Write GPO list python embeeded script in current directory

adsysctl policy debug gpolist-script [flags]
Options
  -h, --help   help for gpolist-script
Options inherited from parent commands
  -c, --config string   use a specific configuration file
  -s, --socket string   socket path to use between daemon and client. Can be overridden by systemd socket activation. (default "/run/adsysd.sock")
  -t, --timeout int     time in seconds before cancelling the client request when the server gives no result. 0 for no timeout. (default 30)
  -v, --verbose count   issue INFO (-v), DEBUG (-vv) or DEBUG with caller (-vvv) output

adsysd mount

Mount the locations listed in the specified file for the current user

adsysd mount MOUNTS_FILE [flags]
Options
  -h, --help   help for mount
Options inherited from parent commands
      --ad-backend string       Active Directory authentication backend (default "sssd")
      --cache-dir string        directory where ADsys caches GPOs downloads and policies. (default "/var/cache/adsys")
  -c, --config string           use a specific configuration file
      --run-dir string          directory where ADsys stores transient information erased on reboot. (default "/run/adsys")
  -s, --socket string           socket path to use between daemon and client. Can be overridden by systemd socket activation. (default "/run/adsysd.sock")
      --sssd.cache-dir string   SSSd cache directory (default "/var/lib/sss/db")
      --sssd.config string      SSSd config file path (default "/etc/sssd/sssd.conf")
  -t, --timeout int             time in seconds without activity before the service exists. 0 for no timeout. (default 120)
  -v, --verbose count           issue INFO (-v), DEBUG (-vv) or DEBUG with caller (-vvv) output

adsysd runscripts

Runs scripts in the given subdirectory

adsysd runscripts ORDER_FILE [flags]
Options
      --allow-order-missing   allow ORDER_FILE to be missing once the scripts are ready.
  -h, --help                  help for runscripts
Options inherited from parent commands
      --ad-backend string       Active Directory authentication backend (default "sssd")
      --cache-dir string        directory where ADsys caches GPOs downloads and policies. (default "/var/cache/adsys")
  -c, --config string           use a specific configuration file
      --run-dir string          directory where ADsys stores transient information erased on reboot. (default "/run/adsys")
  -s, --socket string           socket path to use between daemon and client. Can be overridden by systemd socket activation. (default "/run/adsysd.sock")
      --sssd.cache-dir string   SSSd cache directory (default "/var/lib/sss/db")
      --sssd.config string      SSSd config file path (default "/etc/sssd/sssd.conf")
  -t, --timeout int             time in seconds without activity before the service exists. 0 for no timeout. (default 120)
  -v, --verbose count           issue INFO (-v), DEBUG (-vv) or DEBUG with caller (-vvv) output

Installing development versions

For every commit on the main branch of the adsys repository, the GitHub Actions CI builds a development version of the adwatchd project. This is NOT a stable version of the application and should not be used for production purposes. However, it may prove useful to preview features or bugfixes not yet available as part of a stable release.

To get access to the build artifact you need to be logged in on GitHub. Then, click on any passing run of the QA workflow that has the Windows tests for adwatchd job, and look for the adwatchd_setup file.

More Repositories

1

yaru

All Ubuntu Yaru GNOME themes
SCSS
1,300
star
2

ubuntu-make

Easy setup of common tools for developers on Ubuntu.
HTML
1,185
star
3

gnome-shell-extension-appindicator

Adds KStatusNotifierItem support to the Shell
JavaScript
1,107
star
4

app-center

App Store for Ubuntu made with Flutter 🧡 💙
Dart
586
star
5

archive_yaru.dart

Ubuntu Yaru Flutter Theme
Dart
336
star
6

zsys

ZSys daemon and client for zfs systems
Go
300
star
7

snappy-playpen

ARCHIVED. Preserved for posterity, but these examples are no longer maintained here. Please take discussion to the snapcraft forum.
Shell
179
star
8

yaru.dart

Ubuntu Yaru Flutter widgets and themes for building desktop and web applications
Dart
176
star
9

gnome-shell-communitheme

GNOME Shell Ubuntu community theme "communitheme"
CSS
149
star
10

aad-auth

Azure AD authentication module for Ubuntu
Go
143
star
11

WSL

Ubuntu WSL image build and launcher code.
Go
123
star
12

snapcraft-desktop-helpers

Various launchers for snapcraft wiki parts
C
73
star
13

ubuntu-report

Report hardware and other collected metrics like installer or upgrade information
Go
68
star
14

libreoffice-style-yaru-fullcolor

A fullcolor icon pack for Libreoffice of the awesome Yaru theme
Shell
62
star
15

face-detection-demo

Code for face detection demo snap
Go
36
star
16

authd

Authentication daemon for external Brokers
Go
36
star
17

snap-tutorials-code

Code and examples used in snap related tutorials
QML
34
star
18

archive_yaru_icons.dart

Ubuntu Yaru Flutter Icon Theme
Dart
28
star
19

handy_window.dart

Provides modern-looking Handy windows with rounded bottom corners for Flutter applications on Linux
C
25
star
20

codelabs

Ubuntu codelabs offline website
HTML
24
star
21

yaru_colors.dart

Yaru Colors for Flutter
Dart
23
star
22

user_manager

A tutorial for creating an Ubuntu Linux Flutter app, using the yaru theme
Dart
21
star
23

yaru_window.dart

Provides API for interacting with top-level Flutter windows.
Dart
20
star
24

font-ubuntu

Polymer imports for ubuntu fonts.
HTML
18
star
25

libreoffice

This repository hosts the snap info to package up the Libreoffice snap.
Python
18
star
26

zsys-install

Zfs experiment on ubuntu system
Shell
18
star
27

gnome-sdk

GNOME SDK/Platform snap
Python
16
star
28

codelabs-source

HTML
16
star
29

wsl-setup

WSL setup starts the setup and reconfigure GUI or TUI
15
star
30

ubuntu-wsl-splash

A graphical application to enhance user experience with Ubuntu on WSL during the distro installation process.
Dart
14
star
31

desktop-snaps

Snap automation tools
Python
12
star
32

docker-snapcraft

Docker image autobuild for latests snapcraft on latest ubuntu LTS version
12
star
33

zfs

Temporary fork of ZOL (manually pushed to have it in github dashboard)
C
11
star
34

tutorial-deployment

Tutorial deployment tools
Go
11
star
35

gnome-boxes

GNOME Boxes
Shell
9
star
36

thunderbird

Python
9
star
37

GoWSL

GoWSL is a package that wraps around the wslApi.dll for safe and idiomatic use within Go projects.
Go
9
star
38

ubuntu-proxy-manager

D-Bus service to manage system proxy settings on Ubuntu Desktop
Go
8
star
39

gnome-calculator

GNOME Calculator Snap Package
8
star
40

microk8s-website

HTML
8
star
41

communitheme-sounds

The Ubuntu community sound theme "Communitheme"
Meson
8
star
42

communitheme-snap-helpers

Various build and run helper for communitheme snap
Shell
7
star
43

grubzfs-testsuite

Test for zfs (zsys/non zsys) grub menu generation
Go
7
star
44

snow-on-me-snap

A simple nodejs webserver serving christmas snow on demand and showing up configure snap options
JavaScript
7
star
45

homebrew-microk8s

Homebrew MicroK8s repo for the MacOS installer
Ruby
6
star
46

cheese

Take photos and videos with your webcam, with fun graphical effects
6
star
47

gtk-common-themes

Shell
6
star
48

ubuntu-release-metrics

Code to fetch data to display on https://ubuntu-release.kpi.ubuntu.com/
Python
6
star
49

uupgrade-web

Ubuntu Upgrade checker web frontend
Python
6
star
50

face-detection-web

Single page website for face detection (using face-detection-demo backend) using Polymer
JavaScript
6
star
51

gnome-system-monitor

System Monitor
5
star
52

yaru_test.dart

Extensions for testing Yaru Flutter applications
Dart
5
star
53

simple-webserver-part

Snapcraft simple webserver part
Go
5
star
54

gedit

Edit text files
5
star
55

dev-scripts-ubuntu

Random scripts for doing Ubuntu work
Python
5
star
56

communitheme-set-default

Tools to help end user resetting communitheme settings
Shell
5
star
57

desktop-devel-feedback

Shell
5
star
58

snap-tools

Tools useful for snap maintenance by the ~ubuntu-desktop team
Shell
5
star
59

christmas-music-carousel-snap

Snap for a christmas music carousel
Go
5
star
60

desktop-cve-import

Build reports of the Ubuntu Desktop Snaps which could benefit from a rebuild to fix CVE issues in their staged packages
Python
5
star
61

wsl-actions-example

A small demonstration on how to use our Github actions to run your CI on WSL
Python
5
star
62

uupgrade-docker

Docker containers for upgrade jobs
Shell
4
star
63

kstore

Key store
C
4
star
64

booth-demo-websites

Demo websites configuration for Ubuntu Demo manager
4
star
65

community-fosdem-2022-content

4
star
66

gnome-text-editor

GNOME Text Editor
4
star
67

app-center-ratings

Rust
4
star
68

booth-demo-manager

Display snap for events
Go
4
star
69

gnome-chess

This repository is the snap data that grabs the upstream gnome-chess and packages it as a snap.
4
star
70

ubuntu-core-slides

Web version of ubuntu-core-slides exported.
4
star
71

community-fosdem-2022-static

4
star
72

gnome-mines

Clear hidden mines from a minefield
4
star
73

gnome-shell-ubuntu-extensions

The ubuntu gnome-shell-extensions
4
star
74

snaps-demo-manager

Manage snaps used in our demo by autoinstalling, autoremoving and such
Go
3
star
75

simple-scan

Document Scanning Application
3
star
76

go-i18n

i18n wrapper joining gettext support for Linux and Windows
Go
3
star
77

uupgrade-worker

3
star
78

tali

Roll dice and score points
3
star
79

gnome-sudoku

3
star
80

gnome-font-viewer

3
star
81

evince

Document viewer for popular document formats
3
star
82

decorate

Go package containing various helpers to decorate errors with fewer lines of code in functions.
Go
3
star
83

quadrapassel

Quadrapassel Snap Package
3
star
84

gtk-theme-pop

Shell
3
star
85

snap-theme-examples

Experimenting some snap themes possible syntax
3
star
86

gnome-mahjongg

Match tiles and clear the board
3
star
87

gnome-2048

GNOME 2048 Snap Package
3
star
88

test-contributions-review

This is just a project to test contribution review solutions
C++
3
star
89

gnome-contacts

snap packaging for gnome-contacts
2
star
90

gnome-taquin

2
star
91

gnome-info-collect

A simple utility to collect system information.
2
star
92

community-events-assets

2
star
93

gnome-dictionary

2
star
94

gnome-recipes

Snap packaging for gnome-recipes
2
star
95

gnome-characters

A character map application
2
star
96

gnome-weather

2
star
97

gnome-logs

Log viewer for the systemd journal
2
star
98

drawing

2
star
99

epiphany

snap packaging for epiphany (GNOME Web)
2
star
100

community-events-celery

2
star