pingmgmt.c File Reference

ICMP ping management. More...

#include <stdint.h>
#include <stdio.h>
#include <string.h>
#include <ipxe/pinger.h>
#include <ipxe/monojob.h>
#include <ipxe/timer.h>
#include <usr/pingmgmt.h>

Go to the source code of this file.

Functions
	FILE_LICENCE (GPL2_OR_LATER_OR_UBDL)
	FILE_SECBOOT (PERMITTED)
static void	ping_callback (struct sockaddr *peer, unsigned int sequence, size_t len, int rc)
	Display ping result.
int	ping (const char *hostname, unsigned long timeout, size_t len, unsigned int count, int quiet)
	Ping a host.

Detailed Description

ICMP ping management.

Definition in file pingmgmt.c.

Function Documentation

FILE_LICENCE()

FILE_LICENCE

(

GPL2_OR_LATER_OR_UBDL

)

FILE_SECBOOT()

FILE_SECBOOT

(

PERMITTED

)

ping_callback()

void ping_callback ( struct sockaddr * peer, unsigned int sequence, size_t len, int rc )

static

Display ping result.

Parameters

src	Source socket address, or NULL
sequence	Sequence number
len	Payload length
rc	Status code

Definition at line 49 of file pingmgmt.c.

                                                 {
 
        /* Display ping response */
        printf ( "%zd bytes from %s: seq=%d",
                 len, ( peer ? sock_ntoa ( peer ) : "<none>" ), sequence );
        if ( rc != 0 )
                printf ( ": %s", strerror ( rc ) );
        printf ( "\n" );
}

References len, peer, printf(), rc, sock_ntoa(), and strerror().

Referenced by ping().

ping()

int ping	(	const char *	hostname,
		unsigned long	timeout,
		size_t	len,
		unsigned int	count,
		int	quiet )

Ping a host.

Parameters

hostname	Hostname
timeout	Timeout between pings, in ticks
len	Payload length
count	Number of packets to send (or zero for no limit)
quiet	Inhibit output

Return values

rc	Return status code

Definition at line 70 of file pingmgmt.c.

                                           {
        int rc;
 
        /* Create pinger */
        if ( ( rc = create_pinger ( &monojob, hostname, timeout, len, count,
                                    ( quiet ? NULL : ping_callback ) ) ) != 0 ){
                printf ( "Could not start ping: %s\n", strerror ( rc ) );
                return rc;
        }
 
        /* Wait for ping to complete */
        if ( ( rc = monojob_wait ( NULL, 0 ) ) != 0 ) {
                if ( ! quiet )
                        printf ( "Finished: %s\n", strerror ( rc ) );
                return rc;
        }
 
        return 0;
}

References count, create_pinger(), len, monojob, monojob_wait(), NULL, ping_callback(), printf(), rc, strerror(), and timeout().

Referenced by COMMAND(), ping_alloc_iob(), ping_close(), ping_deliver(), ping_demux(), ping_exec(), ping_open(), and ping_rx().