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

Authors

  • Joris Weijters (@molekuul)

Hint

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