W3cubDocs

/Ansible 2.10

community.general.aix_inittab – Manages the inittab on AIX

Note

This plugin is part of the community.general collection.

To install it use: ansible-galaxy collection install community.general.

To use it in a playbook, specify: community.general.aix_inittab.

Synopsis

  • Manages the inittab on AIX.

Requirements

The below requirements are needed on the host that executes this module.

  • itertools

Parameters

Parameter Choices/Defaults Comments
action
string / required
    Choices:
  • boot
  • bootwait
  • hold
  • initdefault
  • off
  • once
  • ondemand
  • powerfail
  • powerwait
  • respawn
  • sysinit
  • wait
Action what the init has to do with this entry.
command
string / required
What command has to run.
insertafter
string
After which inittabline should the new entry inserted.
name
string / required
Name of the inittab entry.

aliases: service
runlevel
string / required
Runlevel of the entry.
state
string
    Choices:
  • absent
  • present ←
Whether the entry should be present or absent in the inittab file.

Notes

Note

  • The changes are persistent across reboots.
  • You need root rights to read or adjust the inittab with the lsitab, chitab, mkitab or rmitab commands.
  • Tested on AIX 7.1.

Examples

# Add service startmyservice to the inittab, directly after service existingservice.
- name: Add startmyservice to inittab
  community.general.aix_inittab:
    name: startmyservice
    runlevel: 4
    action: once
    command: echo hello
    insertafter: existingservice
    state: present
  become: yes

# Change inittab entry startmyservice to runlevel "2" and processaction "wait".
- name: Change startmyservice to inittab
  community.general.aix_inittab:
    name: startmyservice
    runlevel: 2
    action: wait
    command: echo hello
    state: present
  become: yes

- name: Remove startmyservice from inittab
  community.general.aix_inittab:
    name: startmyservice
    runlevel: 2
    action: wait
    command: echo hello
    state: absent
  become: yes

Return Values

Common return values are documented here, the following are the fields unique to this module:

Key Returned Description
changed
boolean
always
Whether the inittab changed or not

Sample:
True
msg
string
changed
Action done with the inittab entry

Sample:
changed inittab entry startmyservice
name
string
always
Name of the adjusted inittab entry

Sample:
startmyservice


Authors

  • Joris Weijters (@molekuul)

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/community/general/aix_inittab_module.html