Webserver+3d print

Dependents:   Nucleo

Embed: (wiki syntax)

« Back to documentation index

ping.c File Reference

ping.c File Reference

Ping utility. More...

Go to the source code of this file.

Functions

error_t ping (NetInterface *interface, const IpAddr *targetIpAddr, size_t size, uint8_t ttl, systime_t timeout, systime_t *rtt)
 Test the reachability of a host.
void pingInit (PingContext *context)
 Initialize ping context.
error_t pingSetTimeout (PingContext *context, systime_t timeout)
 Set timeout value.
error_t pingBindToInterface (PingContext *context, NetInterface *interface)
 Select a particular network interface.
error_t pingSendRequest (PingContext *context, const IpAddr *targetIpAddr, size_t size, uint8_t ttl)
 Send an ICMP Echo Request message.
error_t pingCheckReply (PingContext *context, const IpAddr *srcIpAddr, const IpAddr *destIpAddr, const IcmpEchoMessage *message, size_t length)
 Check whether an incoming ICMP message is acceptable.
error_t pingWaitForReply (PingContext *context, IpAddr *targetIpAddr, systime_t *rtt)
 Wait for a matching ICMP Echo Reply message.
void pingRelease (PingContext *context)
 Release ping context.

Detailed Description

Ping utility.

License

Copyright (C) 2010-2017 Oryx Embedded SARL. All rights reserved.

This file is part of CycloneTCP Open.

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 2 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, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.

Author:
Oryx Embedded SARL (www.oryx-embedded.com)
Version:
1.7.6

Definition in file ping.c.


Function Documentation

error_t ping ( NetInterface *  interface,
const IpAddr targetIpAddr,
size_t  size,
uint8_t  ttl,
systime_t  timeout,
systime_t *  rtt 
)

Test the reachability of a host.

Ping operates by sending an ICMP Echo Request message to the target host and waiting for an ICMP Echo Reply message

Parameters:
[in]interfaceUnderlying network interface (optional parameter)
[in]targetIpAddrIP address of the host to reach
[in]sizeSize of the data payload in bytes
[in]ttlTime-To-Live value to be used
[in]timeoutMaximum time to wait before giving up
[out]rttRound-trip time (optional parameter)
Returns:
Error code

Definition at line 66 of file ping.c.

error_t pingBindToInterface ( PingContext context,
NetInterface *  interface 
)

Select a particular network interface.

Parameters:
[in]contextPointer to the ping context
[in]interfaceNetwork interface to be used
Returns:
Error code

Definition at line 164 of file ping.c.

error_t pingCheckReply ( PingContext context,
const IpAddr srcIpAddr,
const IpAddr destIpAddr,
const IcmpEchoMessage *  message,
size_t  length 
)

Check whether an incoming ICMP message is acceptable.

Parameters:
[in]contextPointer to the ping context
[in]srcIpAddrSource IP address
[in]destIpAddrDestination IP address
[in]messagePointer to the incoming ICMP message
[in]lengthLength of the message, in bytes
Returns:
Error code

Definition at line 360 of file ping.c.

void pingInit ( PingContext context )

Initialize ping context.

Parameters:
[in]contextPointer to the ping context

Definition at line 122 of file ping.c.

void pingRelease ( PingContext context )

Release ping context.

Parameters:
[in]contextPointer to the ping context

Definition at line 546 of file ping.c.

error_t pingSendRequest ( PingContext context,
const IpAddr targetIpAddr,
size_t  size,
uint8_t  ttl 
)

Send an ICMP Echo Request message.

Parameters:
[in]contextPointer to the ping context
[in]targetIpAddrIP address of the host to reach
[in]sizeSize of the data payload, in bytes
[in]ttlTime-To-Live value to be used
Returns:
Error code

Definition at line 187 of file ping.c.

error_t pingSetTimeout ( PingContext context,
systime_t  timeout 
)

Set timeout value.

Parameters:
[in]contextPointer to the ping context
[in]timeoutMaximum time to wait
Returns:
Error code

Definition at line 143 of file ping.c.

error_t pingWaitForReply ( PingContext context,
IpAddr targetIpAddr,
systime_t *  rtt 
)

Wait for a matching ICMP Echo Reply message.

Parameters:
[in]contextPointer to the ping context
[out]targetIpAddrIP address of the remote host (optional parameter)
[out]rttRound-trip time (optional parameter)
Returns:
Error code

Definition at line 452 of file ping.c.