mirror of
https://salsa.debian.org/freeipa-team/freeipa.git
synced 2025-01-01 11:47:11 -06:00
7336a176b4
Several Commands were missing the 'version' option. Add it to those that were missing it. Do not remove the version option before calling commands. This means methods such as execute(), forward(), run() receive it. Several of these needed `**options` added to their signatures. Commands in the Cert plugin passed any unknown options to the underlying functions, these are changed to pass what's needed explicitly. Some commands in DNS and Batch plugins now pass version to commands they call. When the option is not given, fill it in automatically. (In a subsequent commit, a warning will be added in this case). Note that the public API did not change: all RPC calls already accepted a version option. There's no need for an API version bump (even though API.txt changes substantially). Design page: http://freeipa.org/page/V3/Messages Tickets: https://fedorahosted.org/freeipa/ticket/2732 https://fedorahosted.org/freeipa/ticket/3294
69 lines
2.2 KiB
Python
69 lines
2.2 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 api
|
|
from ipalib import Command
|
|
from ipalib import output
|
|
from ipalib import _, ngettext
|
|
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 u'https://ipa.example.com/ipa/xml'
|
|
-----------------------------------------------------
|
|
IPA server version 2.1.9. API version 2.20
|
|
-----------------------------------------------------
|
|
""")
|
|
|
|
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))
|
|
|
|
api.register(ping)
|