SimplePing.h

//
//  SimplePing.h
//  TSCPrinters SDK
//
//  Created by Realbuber on 2024/4/11.
//
 
#ifndef SimplePing_h
#define SimplePing_h
 
 
#endif /* SimplePing_h */
/*
    Copyright (C) 2016 Apple Inc. All Rights Reserved.
    See LICENSE.txt for this sample’s licensing information
    
    Abstract:
    An object wrapper around the low-level BSD Sockets ping function.
 */
#import <Foundation/Foundation.h>
#include <sys/types.h>
#include <sys/socket.h>
//@import Foundation;
 
#include <AssertMacros.h>           // for __Check_Compile_Time
 
NS_ASSUME_NONNULL_BEGIN

 
@protocol SimplePingDelegate;

 
typedef NS_ENUM(NSInteger, SimplePingAddressStyle) {
    SimplePingAddressStyleAny,          
    SimplePingAddressStyleICMPv4,       
    SimplePingAddressStyleICMPv6        
};

 
@interface SimplePing : NSObject
 
- (instancetype)init NS_UNAVAILABLE;

 
- (instancetype)initWithHostName:(NSString *)hostName NS_DESIGNATED_INITIALIZER;

 
@property (nonatomic, copy, readonly) NSString * hostName;

 
@property (nonatomic, weak, readwrite, nullable) id<SimplePingDelegate> delegate;

 
@property (nonatomic, assign, readwrite) SimplePingAddressStyle addressStyle;

 
@property (nonatomic, copy, readonly, nullable) NSData * hostAddress;

 
@property (nonatomic, assign, readonly) sa_family_t hostAddressFamily;

 
@property (nonatomic, assign, readonly) uint16_t identifier;

 
@property (nonatomic, assign, readonly) uint16_t nextSequenceNumber;

 
- (void)start;

 
- (void)sendPingWithData:(nullable NSData *)data;

 
- (void)stop;
 
@end

 
@protocol SimplePingDelegate <NSObject>
 
@optional

 
- (void)simplePing:(SimplePing *)pinger didStartWithAddress:(NSData *)address;

    
- (void)simplePing:(SimplePing *)pinger didFailWithError:(NSError *)error;

 
- (void)simplePing:(SimplePing *)pinger didSendPacket:(NSData *)packet sequenceNumber:(uint16_t)sequenceNumber;

 
- (void)simplePing:(SimplePing *)pinger didFailToSendPacket:(NSData *)packet sequenceNumber:(uint16_t)sequenceNumber error:(NSError *)error;

 
- (void)simplePing:(SimplePing *)pinger didReceivePingResponsePacket:(NSData *)packet sequenceNumber:(uint16_t)sequenceNumber;

 
- (void)simplePing:(SimplePing *)pinger didReceiveUnexpectedPacket:(NSData *)packet;
 
@end
 
#pragma mark * ICMP On-The-Wire Format

 
struct ICMPHeader {
    uint8_t     type;
    uint8_t     code;
    uint16_t    checksum;
    uint16_t    identifier;
    uint16_t    sequenceNumber;
    // data...
};
typedef struct ICMPHeader ICMPHeader;
 
__Check_Compile_Time(sizeof(ICMPHeader) == 8);
__Check_Compile_Time(offsetof(ICMPHeader, type) == 0);
__Check_Compile_Time(offsetof(ICMPHeader, code) == 1);
__Check_Compile_Time(offsetof(ICMPHeader, checksum) == 2);
__Check_Compile_Time(offsetof(ICMPHeader, identifier) == 4);
__Check_Compile_Time(offsetof(ICMPHeader, sequenceNumber) == 6);
 
enum {
    ICMPv4TypeEchoRequest = 8,          
    ICMPv4TypeEchoReply   = 0           
};
 
enum {
    ICMPv6TypeEchoRequest = 128,        
    ICMPv6TypeEchoReply   = 129         
};
 
NS_ASSUME_NONNULL_END