aix_inittab – Manages the inittab on AIX

From Get docs
Ansible/docs/2.8/modules/aix inittab module


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

string / required

  • 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

  • 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.


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