aix_inittab - Manages the inittab on AIX

New in version 2.3.

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 required	Choices: boot bootwait hold initdefault no once ondemand powerfail powerwait respawn sysinit wait	Action what the init has to do with this entry.
command required		What command has to run.
insertafter		After which inittabline should the new entry inserted.
name required		Name of the inittab entry. aliases: service
runlevel required		Runlevel of the entry.
state	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
  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
  aix_inittab:
    name: startmyservice
    runlevel: 2
    action: wait
    command: echo hello
    state: present
  become: yes

- name: Remove startmyservice from inittab
  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

Status

This module is flagged as preview which means that it is not guaranteed to have a backwards compatible interface.

Maintenance

This module is flagged as community which means that it is maintained by the Ansible Community. See Module Maintenance & Support for more info.

For a list of other modules that are also maintained by the Ansible Community, see here.

Author

• Joris Weijters (@molekuul)

Hint

If you notice any issues in this documentation you can edit this document to improve it.