Install software from the FreeBSD ports(7) system
New in version 2014.1.0: (Hydrogen)
This module allows you to install ports using BATCH=yes to bypass configuration prompts. It is recommended to use the the ports state to install ports, but it it also possible to use this module exclusively from the command line.
salt minion-id ports.config security/nmap IPV6=off
salt minion-id ports.install security/nmap
Modify configuration options for a given port. Multiple options can be specified. To see the available options for a port, use ports.showconfig.
CLI Examples:
salt '*' ports.config security/nmap IPV6=off
De-install a port.
CLI Example:
salt '*' ports.deinstall security/nmap
Install a port from the ports tree. Installs using BATCH=yes for non-interactive building. To set config options for a given port, use ports.config.
Note
It may be helpful to run this function using the -t option to set a higher timeout, since compiling a port may cause the Salt command to exceed the default timeout.
CLI Example:
salt -t 1200 '*' ports.install security/nmap
Lists all ports available.
CLI Example:
salt '*' ports.list_all
Warning
Takes a while to run, and returns a LOT of output
Clear the cached options for the specified port; run a make rmconfig
CLI Example:
salt '*' ports.rmconfig security/nmap
Search for matches in the ports tree. Globs are supported, and the category is optional
CLI Examples:
salt '*' ports.search 'security/*'
salt '*' ports.search 'security/n*'
salt '*' ports.search nmap
Warning
Takes a while to run
Show the configuration options for a given port.
CLI Example:
salt '*' ports.showconfig security/nmap
salt '*' ports.showconfig security/nmap default=True
Update the ports tree
CLI Example:
salt '*' ports.update
Current Salt release: 2014.1.6
Docs for previous releases on salt.rtfd.org.