--- /dev/null
+/*
+ * Copyright (c) 2002 Apple Computer, Inc. All rights reserved.
+ *
+ * @APPLE_LICENSE_HEADER_START@
+ *
+ * Portions Copyright (c) 2002 Apple Computer, Inc. All Rights
+ * Reserved. This file contains Original Code and/or Modifications of
+ * Original Code as defined in and that are subject to the Apple Public
+ * Source License Version 1.1 (the "License"). You may not use this file
+ * except in compliance with the License. Please obtain a copy of the
+ * License at http://www.apple.com/publicsource and read it before using
+ * this file.
+ *
+ * The Original Code and all software distributed under the License are
+ * distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY KIND, EITHER
+ * EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES,
+ * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE OR NON- INFRINGEMENT. Please see the
+ * License for the specific language governing rights and limitations
+ * under the License.
+ *
+ * @APPLE_LICENSE_HEADER_END@
+ */
+
+#ifndef _NETDB_ASYNC_H_
+#define _NETDB_ASYNC_H_
+
+#include <sys/cdefs.h>
+#include <mach/mach.h>
+#include <netdb.h>
+
+__BEGIN_DECLS
+
+/*
+ @typedef gethostbyaddr_async_callback
+ @discussion Type of the callback function used when a
+ gethostbyaddr_async_start() request is delivered.
+ @param hent The resolved host entry.
+ @param context The context provided when the request
+ was initiated.
+ */
+typedef void (*gethostbyaddr_async_callback) (
+ struct hostent *hent,
+ void *context
+ );
+
+/*!
+ @function gethostbyaddr_async_start
+ @description Asynchronously resolves an Internet address
+ @param addr The address to be resolved.
+ @param len The length, in bytes, of the address.
+ @param type
+ @param callout The function to be called when the specified
+ address has been resolved.
+ @param context A user specified context which will be passed
+ to the callout function.
+ @result A mach reply port which will be sent a message when
+ the addr resolution has completed. This message
+ should be passed to the gethostbyaddr_async_handleReply
+ function. A NULL value indicates that no address
+ was specified or some other error occurred which
+ prevented the resolution from being started.
+ */
+mach_port_t
+gethostbyaddr_async_start (
+ const char *addr,
+ int len,
+ int type,
+ gethostbyaddr_async_callback callout,
+ void *context
+ );
+
+
+/*!
+ @function gethostbyaddr_async_handleReply
+ @description This function should be called with the Mach message sent
+ to the port returned by the call to gethostbyaddr_async_start.
+ The reply message will be interpreted and will result in a
+ call to the specified callout function.
+ @param replyMsg The Mach message.
+ */
+void
+gethostbyaddr_async_handleReply (
+ void *replyMsg
+ );
+
+
+/*
+ @typedef gethostbyname_async_callback
+ @discussion Type of the callback function used when a
+ gethostbyname_async_start() request is delivered.
+ @param hent The resolved host entry.
+ @param context The context provided when the request
+ was initiated.
+ */
+typedef void (*gethostbyname_async_callback) (
+ struct hostent *hent,
+ void *context
+ );
+
+/*!
+ @function gethostbyname_async_start
+ @description Asynchronously resolves a hostname
+ @param name The hostname to be resolved.
+ @param callout The function to be called when the specified
+ hostname has been resolved.
+ @param context A user specified context which will be passed
+ to the callout function.
+ @result A mach reply port which will be sent a message when
+ the name resolution has completed. This message
+ should be passed to the gethostbyname_async_handleReply
+ function. A NULL value indicates that no hostname
+ was specified or some other error occurred which
+ prevented the resolution from being started.
+ */
+mach_port_t
+gethostbyname_async_start (
+ const char *name,
+ gethostbyname_async_callback callout,
+ void *context
+ );
+
+
+/*!
+ @function gethostbyname_async_handleReply
+ @description This function should be called with the Mach message sent
+ to the port returned by the call to gethostbyname_async_start.
+ The reply message will be interpreted and will result in a
+ call to the specified callout function.
+ @param replyMsg The Mach message.
+ */
+void
+gethostbyname_async_handleReply (
+ void *replyMsg
+ );
+
+
+/*
+ @typedef getipnodebyaddr_async_callback
+ @discussion Type of the callback function used when a
+ getipnodebyaddr_async_start() request is delivered.
+ @param hent The resolved host entry. If not NULL, the caller
+ must call freehostent() on the host entry.
+ @param error If error code if the resolved host entry is NULL
+ @param context The context provided when the request
+ was initiated.
+ */
+typedef void (*getipnodebyaddr_async_callback) (
+ struct hostent *hent,
+ int error,
+ void *context
+ );
+
+/*!
+ @function getipnodebyaddr_async_start
+ @description Asynchronously resolves an Internet address
+ @param addr The address to be resolved.
+ @param len The length, in bytes, of the address.
+ @param af The address family
+ @param error
+ @param callout The function to be called when the specified
+ address has been resolved.
+ @param context A user specified context which will be passed
+ to the callout function.
+ @result A mach reply port which will be sent a message when
+ the addr resolution has completed. This message
+ should be passed to the getipnodebyaddr_async_handleReply
+ function. A NULL value indicates that no address
+ was specified or some other error occurred which
+ prevented the resolution from being started.
+ */
+mach_port_t
+getipnodebyaddr_async_start (
+ const void *addr,
+ size_t len,
+ int af,
+ int *error,
+ getipnodebyaddr_async_callback callout,
+ void *context
+ );
+
+
+/*!
+ @function getipnodebyaddr_async_handleReply
+ @description This function should be called with the Mach message sent
+ to the port returned by the call to getipnodebyaddr_async_start.
+ The reply message will be interpreted and will result in a
+ call to the specified callout function.
+ @param replyMsg The Mach message.
+ */
+void
+getipnodebyaddr_async_handleReply (
+ void *replyMsg
+ );
+
+
+/*
+ @typedef getipnodebyname_async_callback
+ @discussion Type of the callback function used when a
+ getipnodebyname_async_start() request is delivered.
+ @param hent The resolved host entry. If not NULL, the caller
+ must call freehostent() on the host entry.
+ @param error If error code if the resolved host entry is NULL
+ @param context The context provided when the request
+ was initiated.
+ */
+typedef void (*getipnodebyname_async_callback) (
+ struct hostent *hent,
+ int error,
+ void *context
+ );
+
+/*!
+ @function getipnodebyname_async_start
+ @description Asynchronously resolves a hostname
+ @param name The hostname to be resolved.
+ @param af
+ @param flags
+ @param error
+ @param callout The function to be called when the specified
+ hostname has been resolved.
+ @param context A user specified context which will be passed
+ to the callout function.
+ @result A mach reply port which will be sent a message when
+ the name resolution has completed. This message
+ should be passed to the getipnodebyname_async_handleReply
+ function. A NULL value indicates that no hostname
+ was specified or some other error occurred which
+ prevented the resolution from being started.
+ */
+mach_port_t
+getipnodebyname_async_start (
+ const char *name,
+ int af,
+ int flags,
+ int *error,
+ getipnodebyname_async_callback callout,
+ void *context
+ );
+
+
+/*!
+ @function getipnodebyname_async_handleReply
+ @description This function should be called with the Mach message sent
+ to the port returned by the call to getipnodebyname_async_start.
+ The reply message will be interpreted and will result in a
+ call to the specified callout function.
+ @param replyMsg The Mach message.
+ */
+void
+getipnodebyname_async_handleReply (
+ void *replyMsg
+ );
+
+__END_DECLS
+
+#endif /* !_NETDB_ASYNC_H_ */
projects / apple / libinfo.git / blobdiff