salt.modules.mac_softwareupdate

Support for the softwareupdate command on MacOS.

salt.modules.mac_softwareupdate.download(name)

Download a named update so that it can be installed later with the update or update_all functions

Parameters:

name (str) -- The update to download.

Returns:

True if successful, otherwise False

Return type:

bool

CLI Example:

salt '*' softwareupdate.download <update name>
salt.modules.mac_softwareupdate.download_all(recommended=False, restart=True)

Download all available updates so that they can be installed later with the update or update_all functions. It returns a list of updates that are now downloaded.

Parameters:
  • recommended (bool) -- If set to True, only install the recommended updates. If set to False (default) all updates are installed.

  • restart (bool) -- Set this to False if you do not want to install updates that require a restart. Default is True

Returns:

A list containing all downloaded updates on the system.

Return type:

list

CLI Example:

salt '*' softwareupdate.download_all
salt.modules.mac_softwareupdate.get_catalog()

New in version 2016.3.0.

Get the current catalog being used for update lookups. Will return a url if a custom catalog has been specified. Otherwise the word 'Default' will be returned

Returns:

The catalog being used for update lookups

Return type:

str

CLI Example:

salt '*' softwareupdates.get_catalog
salt.modules.mac_softwareupdate.ignore(name)

Ignore a specific program update. When an update is ignored the '-' and version number at the end will be omitted, so "SecUpd2014-001-1.0" becomes "SecUpd2014-001". It will be removed automatically if present. An update is successfully ignored when it no longer shows up after list_updates.

Parameters:

name -- The name of the update to add to the ignore list.

Ptype:

str

Returns:

True if successful, False if not

Return type:

bool

CLI Example:

salt '*' softwareupdate.ignore <update-name>
salt.modules.mac_softwareupdate.list_available(recommended=False, restart=False, shut_down=False)

List all available updates.

Parameters:
  • recommended (bool) -- Show only recommended updates.

  • restart (bool) -- Show only updates that require a restart.

Returns:

Returns a dictionary containing the updates

Return type:

dict

CLI Example:

salt '*' softwareupdate.list_available
salt.modules.mac_softwareupdate.list_downloads()

Return a list of all updates that have been downloaded locally.

Returns:

A list of updates that have been downloaded

Return type:

list

CLI Example:

salt '*' softwareupdate.list_downloads
salt.modules.mac_softwareupdate.list_ignored()

List all updates that have been ignored. Ignored updates are shown without the '-' and version number at the end, this is how the softwareupdate command works.

Returns:

The list of ignored updates

Return type:

list

CLI Example:

salt '*' softwareupdate.list_ignored
salt.modules.mac_softwareupdate.reset_catalog()

New in version 2016.3.0.

Reset the Software Update Catalog to the default.

Returns:

True if successful, False if not

Return type:

bool

CLI Example:

salt '*' softwareupdates.reset_catalog
salt.modules.mac_softwareupdate.reset_ignored()

Make sure the ignored updates are not ignored anymore, returns a list of the updates that are no longer ignored.

Returns:

True if the list was reset, Otherwise False

Return type:

bool

CLI Example:

salt '*' softwareupdate.reset_ignored
salt.modules.mac_softwareupdate.schedule_enable(enable)

Enable/disable automatic update scheduling.

Parameters:

enable -- True/On/Yes/1 to turn on automatic updates. False/No/Off/0 to turn off automatic updates. If this value is empty, the current status will be returned.

Type:

bool str

Returns:

True if scheduling is enabled, False if disabled

Return type:

bool

CLI Example:

salt '*' softwareupdate.schedule_enable on|off
salt.modules.mac_softwareupdate.schedule_enabled()

Check the status of automatic update scheduling.

Returns:

True if scheduling is enabled, False if disabled

Return type:

bool

CLI Example:

salt '*' softwareupdate.schedule_enabled
salt.modules.mac_softwareupdate.set_catalog(url)

New in version 2016.3.0.

Set the Software Update Catalog to the URL specified

Parameters:

url (str) -- The url to the update catalog

Returns:

True if successful, False if not

Return type:

bool

CLI Example:

salt '*' softwareupdates.set_catalog http://swupd.local:8888/index.sucatalog
salt.modules.mac_softwareupdate.update(name)

Install a named update.

Parameters:

name (str) -- The name of the of the update to install.

Returns:

True if successfully updated, otherwise False

Return type:

bool

CLI Example:

salt '*' softwareupdate.update <update-name>
salt.modules.mac_softwareupdate.update_all(recommended=False, restart=True)

Install all available updates. Returns a dictionary containing the name of the update and the status of its installation.

Parameters:
  • recommended (bool) -- If set to True, only install the recommended updates. If set to False (default) all updates are installed.

  • restart (bool) -- Set this to False if you do not want to install updates that require a restart. Default is True

Returns:

A dictionary containing the updates that were installed and the status of its installation. If no updates were installed an empty dictionary is returned.

Return type:

dict

CLI Example:

salt '*' softwareupdate.update_all
salt.modules.mac_softwareupdate.update_available(name)

Check whether or not an update is available with a given name.

Parameters:

name (str) -- The name of the update to look for

Returns:

True if available, False if not

Return type:

bool

CLI Example:

salt '*' softwareupdate.update_available <update-name>
salt '*' softwareupdate.update_available "<update with whitespace>"