mirror of
https://salsa.debian.org/freeipa-team/freeipa.git
synced 2024-12-26 17:01:14 -06:00
7804a74826
This makes plugin registration easier to read, less error-prone, and, for many Plugins in a single module, faster to write. Functionally, the decorator is equivalent to current plugin registration. However, in the future this style will allow cleaner semantics. As an example, and to exercise the new syntax to prevent regressions, the ping plugin is converted to this style.
71 lines
2.3 KiB
Python
71 lines
2.3 KiB
Python
# Authors:
|
|
# Rob Crittenden <rcritten@redhat.com>
|
|
#
|
|
# Copyright (C) 2010 Red Hat
|
|
# see file 'COPYING' for use and warranty information
|
|
#
|
|
# This program is free software; you can redistribute it and/or modify
|
|
# it under the terms of the GNU General Public License as published by
|
|
# the Free Software Foundation, either version 3 of the License, or
|
|
# (at your option) any later version.
|
|
#
|
|
# This program is distributed in the hope that it will be useful,
|
|
# but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
# GNU General Public License for more details.
|
|
#
|
|
# You should have received a copy of the GNU General Public License
|
|
# along with this program. If not, see <http://www.gnu.org/licenses/>.
|
|
|
|
from ipalib import Command
|
|
from ipalib import output
|
|
from ipalib import _, ngettext
|
|
from ipalib.plugable import Registry
|
|
from ipapython.version import VERSION, API_VERSION
|
|
|
|
__doc__ = _("""
|
|
Ping the remote IPA server to ensure it is running.
|
|
|
|
The ping command sends an echo request to an IPA server. The server
|
|
returns its version information. This is used by an IPA client
|
|
to confirm that the server is available and accepting requests.
|
|
|
|
The server from xmlrpc_uri in /etc/ipa/default.conf is contacted first.
|
|
If it does not respond then the client will contact any servers defined
|
|
by ldap SRV records in DNS.
|
|
|
|
EXAMPLES:
|
|
|
|
Ping an IPA server:
|
|
ipa ping
|
|
------------------------------------------
|
|
IPA server version 2.1.9. API version 2.20
|
|
------------------------------------------
|
|
|
|
Ping an IPA server verbosely:
|
|
ipa -v ping
|
|
ipa: INFO: trying https://ipa.example.com/ipa/xml
|
|
ipa: INFO: Forwarding 'ping' to server 'https://ipa.example.com/ipa/xml'
|
|
-----------------------------------------------------
|
|
IPA server version 2.1.9. API version 2.20
|
|
-----------------------------------------------------
|
|
""")
|
|
|
|
register = Registry()
|
|
|
|
|
|
@register()
|
|
class ping(Command):
|
|
__doc__ = _('Ping a remote server.')
|
|
|
|
has_output = (
|
|
output.summary,
|
|
)
|
|
|
|
def execute(self, **options):
|
|
"""
|
|
A possible enhancement would be to take an argument and echo it
|
|
back but a fixed value works for now.
|
|
"""
|
|
return dict(summary=u'IPA server version %s. API version %s' % (VERSION, API_VERSION))
|