mirror of
https://salsa.debian.org/freeipa-team/freeipa.git
synced 2024-12-28 18:01:23 -06:00
6e44557b60
Move the remaining plugin code from ipalib.plugins to ipaserver.plugins. Remove the now unused ipalib.plugins package. https://fedorahosted.org/freeipa/ticket/4739 Reviewed-By: David Kupka <dkupka@redhat.com>
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 _
|
|
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))
|