ANI(1)

NAME
ani - Apple Net Install command line tool

SYNOPSIS
ani list --trains

ani list --train train [--cached]

ani refresh --trains

ani refresh --train train

ani download --update update <DOWNLOAD OPTIONS>

ani download --latest train <DOWNLOAD OPTIONS> <FILTER OPTIONS>

ani install --update update <DOWNLOAD OPTIONS> <INSTALL OPTIONS>

ani install --latest train <DOWNLOAD OPTIONS> <FILTER OPTIONS> <INSTALL OPTIONS>

ani install --file <path/to/dmg> [--type image_type] <INSTALL OPTIONS>

ani [-v | --version]

ani [-h | --help]

  DOWNLOAD OPTIONS
--image image

  FILTER OPTIONS
[--livable | --livable-with-issues | --release | --quicklooks]

  INSTALL OPTIONS
[--volume target_volume_path [--erase [filesystem_type]]]

[--boot-args boot_arguments_string]

[--noBootOnce]

DESCRIPTION
ani is the command line tool of Apple Net Install. It talks to the same daemon as Apple Net Install.app and shares its data. You can use ani to easily automate updates of your system

COMMANDS

  ani list

--trains
    Lists all trains in local cache.

--train train [--cached]
    Lists all updates for train in local cache. If --cached is specified, only lists updates with at least one cache disk image.

  ani refresh

--trains
    Refreshes list of trains and updates the local cache. Afterwards, lists all trains in local cache.

--train train
    Refreshes train and updates the local cache. Afterwards, lists all updates in local cache.

  ani download

--update update <DOWNLOAD OPTIONS>
    Downloads update.

--latest train <DOWNLOAD OPTIONS> <FILTER OPTIONS>
    Downloads the latest image for train.

  ani install

--update update <DOWNLOAD OPTIONS> <INSTALL OPTIONS>
    Installs update.

--latest train <DOWNLOAD OPTIONS> <FILTER OPTIONS> <INSTALL OPTIONS>
    Installs the latest image for train.

--file path_to_dmg [--type image_type] <INSTALL OPTIONS>
    Install an image that is not managed by Apple Net Install. Use --file to specify the path to the disk image file. Apple Net Install tries to figure out which image you specified. If it is not able to do that, you have to specify the image type using --type. Currently supported image types are:
    AppleInternal AppleInternalAssistant

help | -h | --help
    Prints ani's usage information

version | -v | --version
    Prints ani's version

  DOWNLOAD OPTIONS

--image image
    The name of the image to download (e.g. 'AppleInternal')

  FILTER OPTIONS

[--livable | --livable-with-issues | --release | --quicklooks]
    Optional flags to filter for updates. All the flags are mutually exclusive.
    --livable: Last 'Livable' update.
    --livable-with-issues: Last 'Livable with Issues' update.
    --release: Last update marked as 'Release'.
    --quicklooks: Last update marked as 'QuickLooks'.
    We do not only filter for the specified flag, but for everything that is at least the specified flag. So --livable-with-issues will include all updates that are marked as 'Recommended with Issues' or 'Recommended.' --quicklooks will include all updates that are marked as 'QuickLooks' or 'Release.'

  INSTALL OPTIONS

[--volume target_volume_path [--erase [filesystem_type]]]
    Optional flag to specify a target volume for an installation. If flag it not present, ani boots into the installer. --erase can be used to erase the volume before the installation and the optional filesystem_type can be used to specify a new filesystem type. If no filesystem type is specified, the volume will keep its current filesystem type.

[--boot-args boot_arguments_string]
    Optional flag to specify boot arguments.

[--noBootOnce]
    Optional flag to disable boot next.

RETURN VALUES
Returns EXIT_SUCCESS on success, and EXIT_FAILURE on failure.

BUGS
Bugs should be submitted as a Radar in the component 'Apple Net Install App | X'. Please attach Apple Net Install's log file. You can find it in '~/Library/Logs/AppleNetInstall.log'.