# salt.modules.freebsdports

Install software from the FreeBSD `ports(7)` system

New in version 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

`salt.modules.freebsdports.` `config`(name, reset=False, **kwargs)

  Modify configuration options for a given port. Multiple options can be specified. To see the available options for a port, use `ports.showconfig`.

  name
    The port name, in `category/name` format
  reset : False
    If `True`, runs a `make rmconfig` for the port, clearing its configuration before setting the desired options

  CLI Examples:

      salt '*' ports.config security/nmap IPV6=off

`salt.modules.freebsdports.` `deinstall`(name)

  De-install a port.

  CLI Example:

      salt '*' ports.deinstall security/nmap

`salt.modules.freebsdports.` `install`(name, clean=True)

  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`.

  clean : True
    If `True`, cleans after installation. Equivalent to running `make install clean BATCH=yes`.

  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

`salt.modules.freebsdports.` `list_all`()

  Lists all ports available.

  CLI Example:

      salt '*' ports.list_all

  Warning

  Takes a while to run, and returns a LOT of output

`salt.modules.freebsdports.` `rmconfig`(name)

  Clear the cached options for the specified port; run a `make rmconfig`

  name
    The name of the port to clear

  CLI Example:

      salt '*' ports.rmconfig security/nmap

`salt.modules.freebsdports.` `search`(name)

  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

`salt.modules.freebsdports.` `showconfig`(name, default=False, dict_return=False)

  Show the configuration options for a given port.

  default : False
    Show the default options for a port (not necessarily the same as the current configuration)
  dict_return : False
    Instead of returning the output of `make showconfig`, return the data in an dictionary

  CLI Example:

      salt '*' ports.showconfig security/nmap
      salt '*' ports.showconfig security/nmap default=True

`salt.modules.freebsdports.` `update`(extract=False)

  Update the ports tree

  extract : False
    If `True`, runs a `portsnap extract` after fetching, should be used for first-time installation of the ports tree.

  CLI Example:

      salt '*' ports.update

Current Salt release: 0.17.1

#### Previous topic

salt.modules.freebsdpkg

#### Next topic

salt.modules.freebsdservice

### Quick search

Enter search terms or a module, class or function name.

### Upcoming SaltStack Events

My conferences on Lanyrd