openstack-completion.service - Man Page

regenerate OpenStack bash completion

Synopsis

systemctl start openstack-completion.service

Description

openstack-completion.service is a oneshot systemd service that regenerates the OpenStack unified CLI bash completion script by introspecting all currently installed OpenStack client entry points.

The completion script is written atomically: a temporary file is first created in /run/openstack-client/ and then moved into place at /var/lib/openstack-client/bash-completion. A failed run will therefore never leave a broken or truncated completion file in place.

The service is normally triggered automatically by openstack-completion.timer on boot and every 24 hours thereafter. It may be started manually to immediately update completions after installing or removing OpenStack client packages without waiting for the timer to fire.

The service runs as the openstack-completion system user and requires no elevated privileges.

Files

/var/lib/openstack-client/bash-completion

The generated bash completion script, containing the _openstack function and all command data for currently installed components.

/usr/lib/bash-completion/completions/openstack

Static bash completion entry point that sources the generated file.

/usr/lib/sysusers.d/openstack-completion.conf

sysusers.d configuration creating the openstack-completion system user.

Notes

To override the timer interval, create a drop-in file:

    systemctl edit openstack-completion.timer

See Also

openstack(1)

Info

OpenStack Client System Administration