Skip to main content

Command line

The command line format for Snow Inventory Agent for macOS is:

snowagent [options] [<command> [<arguments>]]

Some command lines require superuser privileges. To temporarily gain superuser privileges, send the command line as an argument to the command sudo.

sudo /opt/snow/snowagent test

Global option

Description

-w <dir>

Override working directory that is otherwise inherited from shell/environment

-v

Enable verbose mode, bump all logging to max level (enable all tags)

-c snowagent.config

Read the configuration file from the given location instead of the default one.

This should be considered a one-time operation as it does not change other behaviors of the agent.

-data-dir <dir>

Override the data directory (regardless of configuration).

When this option is used, only the directory of the inventory result file will be changed. The log file will still be placed in the default location.

-log-dir <dir>

Override log directory (regardless of configuration)

-? or -h

Print help text and exit

Command

Option

Description

copyright

Show copyright notice

manifest

Print the manifest in JSON format and exit

scan

Scan the current device and create a snowpack file in the target destination (as set by configuration). This will start a scan regardless of any schedule or other configuration. It will not start a scan if there's a running scan in progress. After the scan is completed the agent will exit. The scan result is not automatically sent.

send

Send files from the data directory. Files that are successfully sent are deleted

test

Run a self-test. Check configuration and server connectivity, then exit with a 0 (if successful) otherwise with a non-zero exit code

update

-package <location>

Check for updates now, and install if any are found.

Use an update package from a specific location

version

Print the current snowagent version and exit