community.general.aix_inittab – Manages the inittab on AIX

Note

This plugin is part of the community.general collection (version 4.2.0).

You might already have this collection installed if you are using the ansible package. It is not included in ansible-core. To check whether it is installed, run ansible-galaxy collection list.

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
    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)