"Fossies" - the Fresh Open Source Software Archive 
Source code changes of the file "lib/ansible/modules/apt.py" between
ansible-2.14.0.tar.gz and ansible-2.14.1rc1.tar.gz
About: Ansible is an IT Configuration Management, Deployment & Orchestration tool. Release candidate.
| apt.py (ansible-2.14.0) | : | apt.py (ansible-2.14.1rc1) | ||
|---|---|---|---|---|
| skipping to change at line 70 | skipping to change at line 70 | |||
| - Will force purging of configuration files if the module state is set to I (absent). | - Will force purging of configuration files if the module state is set to I (absent). | |||
| type: bool | type: bool | |||
| default: 'no' | default: 'no' | |||
| default_release: | default_release: | |||
| description: | description: | |||
| - Corresponds to the C(-t) option for I(apt) and sets pin priorities | - Corresponds to the C(-t) option for I(apt) and sets pin priorities | |||
| aliases: [ default-release ] | aliases: [ default-release ] | |||
| type: str | type: str | |||
| install_recommends: | install_recommends: | |||
| description: | description: | |||
| - Corresponds to the C(--no-install-recommends) option for I(apt). C(yes) installs recommended packages. C(no) does not install | - Corresponds to the C(--no-install-recommends) option for I(apt). C(true) installs recommended packages. C(false) does not install | |||
| recommended packages. By default, Ansible will use the same defaults as the operating system. Suggested packages are never installed. | recommended packages. By default, Ansible will use the same defaults as the operating system. Suggested packages are never installed. | |||
| aliases: [ install-recommends ] | aliases: [ install-recommends ] | |||
| type: bool | type: bool | |||
| force: | force: | |||
| description: | description: | |||
| - 'Corresponds to the C(--force-yes) to I(apt-get) and implies C(allow_una uthenticated: yes) and C(allow_downgrade: yes)' | - 'Corresponds to the C(--force-yes) to I(apt-get) and implies C(allow_una uthenticated: yes) and C(allow_downgrade: yes)' | |||
| - "This option will disable checking both the packages' signatures and the certificates of the | - "This option will disable checking both the packages' signatures and the certificates of the | |||
| web servers they are downloaded from." | web servers they are downloaded from." | |||
| - 'This option *is not* the equivalent of passing the C(-f) flag to I(apt- get) on the command line' | - 'This option *is not* the equivalent of passing the C(-f) flag to I(apt- get) on the command line' | |||
| - '**This is a destructive operation with the potential to destroy your sy stem, and it should almost never be used.** | - '**This is a destructive operation with the potential to destroy your sy stem, and it should almost never be used.** | |||
| skipping to change at line 143 | skipping to change at line 143 | |||
| deb: | deb: | |||
| description: | description: | |||
| - Path to a .deb package on the remote machine. | - Path to a .deb package on the remote machine. | |||
| - If :// in the path, ansible will attempt to download deb before install ing. (Version added 2.1) | - If :// in the path, ansible will attempt to download deb before install ing. (Version added 2.1) | |||
| - Requires the C(xz-utils) package to extract the control file of the deb package to install. | - Requires the C(xz-utils) package to extract the control file of the deb package to install. | |||
| type: path | type: path | |||
| required: false | required: false | |||
| version_added: "1.6" | version_added: "1.6" | |||
| autoremove: | autoremove: | |||
| description: | description: | |||
| - If C(yes), remove unused dependency packages for all module states excep t I(build-dep). It can also be used as the only option. | - If C(true), remove unused dependency packages for all module states exce pt I(build-dep). It can also be used as the only option. | |||
| - Previous to version 2.4, autoclean was also an alias for autoremove, now it is its own separate command. See documentation for further information. | - Previous to version 2.4, autoclean was also an alias for autoremove, now it is its own separate command. See documentation for further information. | |||
| type: bool | type: bool | |||
| default: 'no' | default: 'no' | |||
| version_added: "2.1" | version_added: "2.1" | |||
| autoclean: | autoclean: | |||
| description: | description: | |||
| - If C(yes), cleans the local repository of retrieved package files that c an no longer be downloaded. | - If C(true), cleans the local repository of retrieved package files that can no longer be downloaded. | |||
| type: bool | type: bool | |||
| default: 'no' | default: 'no' | |||
| version_added: "2.4" | version_added: "2.4" | |||
| policy_rc_d: | policy_rc_d: | |||
| description: | description: | |||
| - Force the exit code of /usr/sbin/policy-rc.d. | - Force the exit code of /usr/sbin/policy-rc.d. | |||
| - For example, if I(policy_rc_d=101) the installed package will not trigge r a service start. | - For example, if I(policy_rc_d=101) the installed package will not trigge r a service start. | |||
| - If /usr/sbin/policy-rc.d already exists, it is backed up and restored af ter the package installation. | - If /usr/sbin/policy-rc.d already exists, it is backed up and restored af ter the package installation. | |||
| - If C(null), the /usr/sbin/policy-rc.d isn't created/changed. | - If C(null), the /usr/sbin/policy-rc.d isn't created/changed. | |||
| type: int | type: int | |||
| skipping to change at line 172 | skipping to change at line 172 | |||
| version_added: "2.8" | version_added: "2.8" | |||
| only_upgrade: | only_upgrade: | |||
| description: | description: | |||
| - Only upgrade a package if it is already installed. | - Only upgrade a package if it is already installed. | |||
| type: bool | type: bool | |||
| default: 'no' | default: 'no' | |||
| version_added: "2.1" | version_added: "2.1" | |||
| fail_on_autoremove: | fail_on_autoremove: | |||
| description: | description: | |||
| - 'Corresponds to the C(--no-remove) option for C(apt).' | - 'Corresponds to the C(--no-remove) option for C(apt).' | |||
| - 'If C(yes), it is ensured that no packages will be removed or the task w ill fail.' | - 'If C(true), it is ensured that no packages will be removed or the task will fail.' | |||
| - 'C(fail_on_autoremove) is only supported with state except C(absent)' | - 'C(fail_on_autoremove) is only supported with state except C(absent)' | |||
| type: bool | type: bool | |||
| default: 'no' | default: 'no' | |||
| version_added: "2.11" | version_added: "2.11" | |||
| force_apt_get: | force_apt_get: | |||
| description: | description: | |||
| - Force usage of apt-get instead of aptitude | - Force usage of apt-get instead of aptitude | |||
| type: bool | type: bool | |||
| default: 'no' | default: 'no' | |||
| version_added: "2.4" | version_added: "2.4" | |||
| skipping to change at line 204 | skipping to change at line 204 | |||
| author: "Matthew Williams (@mgwilliams)" | author: "Matthew Williams (@mgwilliams)" | |||
| extends_documentation_fragment: action_common_attributes | extends_documentation_fragment: action_common_attributes | |||
| attributes: | attributes: | |||
| check_mode: | check_mode: | |||
| support: full | support: full | |||
| diff_mode: | diff_mode: | |||
| support: full | support: full | |||
| platform: | platform: | |||
| platforms: debian | platforms: debian | |||
| notes: | notes: | |||
| - Three of the upgrade modes (C(full), C(safe) and its alias C(yes)) required C(aptitude) up to 2.3, since 2.4 C(apt-get) is used as a fall-back. | - Three of the upgrade modes (C(full), C(safe) and its alias C(true)) require d C(aptitude) up to 2.3, since 2.4 C(apt-get) is used as a fall-back. | |||
| - In most cases, packages installed with apt will start newly installed servi ces by default. Most distributions have mechanisms to avoid this. | - In most cases, packages installed with apt will start newly installed servi ces by default. Most distributions have mechanisms to avoid this. | |||
| For example when installing Postgresql-9.5 in Debian 9, creating an excutab le shell script (/usr/sbin/policy-rc.d) that throws | For example when installing Postgresql-9.5 in Debian 9, creating an excutab le shell script (/usr/sbin/policy-rc.d) that throws | |||
| a return code of 101 will stop Postgresql 9.5 starting up after install. Re move the file or remove its execute permission afterwards. | a return code of 101 will stop Postgresql 9.5 starting up after install. Re move the file or remove its execute permission afterwards. | |||
| - The apt-get commandline supports implicit regex matches here but we do not because it can let typos through easier | - The apt-get commandline supports implicit regex matches here but we do not because it can let typos through easier | |||
| (If you typo C(foo) as C(fo) apt-get would install packages that have "fo" in their name with a warning and a prompt for the user. | (If you typo C(foo) as C(fo) apt-get would install packages that have "fo" in their name with a warning and a prompt for the user. | |||
| Since we don't have warnings and prompts before installing we disallow this .Use an explicit fnmatch pattern if you want wildcarding) | Since we don't have warnings and prompts before installing we disallow this .Use an explicit fnmatch pattern if you want wildcarding) | |||
| - When used with a C(loop:) each package will be processed individually, it i s much more efficient to pass the list directly to the I(name) option. | - When used with a C(loop:) each package will be processed individually, it i s much more efficient to pass the list directly to the I(name) option. | |||
| - When C(default_release) is used, an implicit priority of 990 is used. This is the same behavior as C(apt-get -t). | - When C(default_release) is used, an implicit priority of 990 is used. This is the same behavior as C(apt-get -t). | |||
| - When an exact version is specified, an implicit priority of 1001 is used. | - When an exact version is specified, an implicit priority of 1001 is used. | |||
| ''' | ''' | |||
| End of changes. 5 change blocks. | ||||
| 5 lines changed or deleted | 5 lines changed or added | |||