source.h

Go to the documentation of this file.

/*
 * Copyright (c) 2008-2009 Apple Inc. All rights reserved.
 * Copyright (c) 2011-2012 MLBA-Team. All rights reserved.
 *
 * @APPLE_APACHE_LICENSE_HEADER_START@
 * 
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 * 
 *     http://www.apache.org/licenses/LICENSE-2.0
 * 
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 * 
 * @APPLE_APACHE_LICENSE_HEADER_END@
 */

#ifndef __DISPATCH_SOURCE__
#define __DISPATCH_SOURCE__

#ifndef __DISPATCH_INDIRECT__
#error "Please #include <dispatch/dispatch.h> instead of this file directly."
#include "base.h"  // for HeaderDoc
#endif

#ifdef _WIN32
# define DISPATCH_SOURCE_HAS_DATA_ADD 1
# define DISPATCH_SOURCE_HAS_DATA_OR 1
# define DISPATCH_SOURCE_HAS_MACH_SEND 0
# define DISPATCH_SOURCE_HAS_MACH_RECV 0
# define DISPATCH_SOURCE_HAS_PROC 0
# define DISPATCH_SOURCE_HAS_READ 0
# define DISPATCH_SOURCE_HAS_SIGNAL 0
# define DISPATCH_SOURCE_HAS_TIMER 1
# define DISPATCH_SOURCE_HAS_VNODE 0
# define DISPATCH_SOURCE_HAS_WRITE 0
#elif defined __APPLE__
# define DISPATCH_SOURCE_HAS_DATA_ADD 1
# define DISPATCH_SOURCE_HAS_DATA_OR 1
# define DISPATCH_SOURCE_HAS_MACH_SEND 1
# define DISPATCH_SOURCE_HAS_MACH_RECV 1
# define DISPATCH_SOURCE_HAS_PROC 1
# define DISPATCH_SOURCE_HAS_READ 1
# define DISPATCH_SOURCE_HAS_SIGNAL 1
# define DISPATCH_SOURCE_HAS_TIMER 1
# define DISPATCH_SOURCE_HAS_VNODE 1
# define DISPATCH_SOURCE_HAS_WRITE 1
#elif defined __linux__
# define DISPATCH_SOURCE_HAS_DATA_ADD 1
# define DISPATCH_SOURCE_HAS_DATA_OR 1
# define DISPATCH_SOURCE_HAS_MACH_SEND 0
# define DISPATCH_SOURCE_HAS_MACH_RECV 0
# define DISPATCH_SOURCE_HAS_PROC 0
# define DISPATCH_SOURCE_HAS_READ 1
# define DISPATCH_SOURCE_HAS_SIGNAL 1
# define DISPATCH_SOURCE_HAS_TIMER 1
# define DISPATCH_SOURCE_HAS_VNODE 1
# define DISPATCH_SOURCE_HAS_WRITE 1
#else
# warning "Completely unsupported platform, might result in errors"
#endif

DISPATCH_DECL(dispatch_source);

typedef const struct dispatch_source_type_s *dispatch_source_type_t;

__DISPATCH_BEGIN_DECLS

#if __DISPATCH_BUILD_FEATURE(DISPATCH_SOURCE_HAS_DATA_ADD)

#define DISPATCH_SOURCE_TYPE_DATA_ADD (&_dispatch_source_type_data_add)

extern DISPATCH_EXPORT
const struct dispatch_source_type_s _dispatch_source_type_data_add;

#endif /* __DISPATCH_BUILD_FEATURE(DISPATCH_SOURCE_HAS_DATA_ADD) */


#if __DISPATCH_BUILD_FEATURE(DISPATCH_SOURCE_HAS_DATA_OR)

#define DISPATCH_SOURCE_TYPE_DATA_OR (&_dispatch_source_type_data_or)

extern DISPATCH_EXPORT
const struct dispatch_source_type_s _dispatch_source_type_data_or;

#endif /* __DISPATCH_BUILD_FEATURE(DISPATCH_SOURCE_HAS_DATA_ADD) */


#if __DISPATCH_BUILD_FEATURE(DISPATCH_SOURCE_HAS_MACH_SEND)

#define DISPATCH_SOURCE_TYPE_MACH_SEND (&_dispatch_source_type_mach_send)

extern DISPATCH_EXPORT
const struct dispatch_source_type_s _dispatch_source_type_mach_send;

#endif /* __DISPATCH_BUILD_FEATURE(DISPATCH_SOURCE_HAS_MACH_SEND) */


#if __DISPATCH_BUILD_FEATURE(DISPATCH_SOURCE_HAS_MACH_RECV)

#define DISPATCH_SOURCE_TYPE_MACH_RECV (&_dispatch_source_type_mach_recv)

extern DISPATCH_EXPORT
const struct dispatch_source_type_s _dispatch_source_type_mach_recv;

#endif /* __DISPATCH_BUILD_FEATURE(DISPATCH_SOURCE_HAS_MACH_RECV) */


#if __DISPATCH_BUILD_FEATURE(DISPATCH_SOURCE_HAS_PROC)

#define DISPATCH_SOURCE_TYPE_PROC (&_dispatch_source_type_proc)

extern DISPATCH_EXPORT
const struct dispatch_source_type_s _dispatch_source_type_proc;

#endif /* __DISPATCH_BUILD_FEATURE(DISPATCH_SOURCE_HAS_PROC) */


#if __DISPATCH_BUILD_FEATURE(DISPATCH_SOURCE_HAS_READ)

#define DISPATCH_SOURCE_TYPE_READ (&_dispatch_source_type_read)

extern DISPATCH_EXPORT
const struct dispatch_source_type_s _dispatch_source_type_read;

#endif /* __DISPATCH_BUILD_FEATURE(DISPATCH_SOURCE_HAS_READ) */


#if __DISPATCH_BUILD_FEATURE(DISPATCH_SOURCE_HAS_SIGNAL)

#define DISPATCH_SOURCE_TYPE_SIGNAL (&_dispatch_source_type_signal)

extern DISPATCH_EXPORT
const struct dispatch_source_type_s _dispatch_source_type_signal;

#endif /* __DISPATCH_BUILD_FEATURE(DISPATCH_SOURCE_HAS_SIGNAL) */


#if __DISPATCH_BUILD_FEATURE(DISPATCH_SOURCE_HAS_TIMER)

#define DISPATCH_SOURCE_TYPE_TIMER (&_dispatch_source_type_timer)

extern DISPATCH_EXPORT
const struct dispatch_source_type_s _dispatch_source_type_timer;

#endif /* __DISPATCH_BUILD_FEATURE(DISPATCH_SOURCE_HAS_TIMER) */


#if __DISPATCH_BUILD_FEATURE(DISPATCH_SOURCE_HAS_VNODE)

#define DISPATCH_SOURCE_TYPE_VNODE (&_dispatch_source_type_vnode)

extern DISPATCH_EXPORT
const struct dispatch_source_type_s _dispatch_source_type_vnode;

#endif /* __DISPATCH_BUILD_FEATURE(DISPATCH_SOURCE_HAS_VNODE) */


#if __DISPATCH_BUILD_FEATURE(DISPATCH_SOURCE_HAS_WRITE)

#define DISPATCH_SOURCE_TYPE_WRITE (&_dispatch_source_type_write)

extern DISPATCH_EXPORT 
const struct dispatch_source_type_s _dispatch_source_type_write;

#endif /* __DISPATCH_BUILD_FEATURE(DISPATCH_SOURCE_HAS_WRITE) */

__DISPATCH_END_DECLS

enum {
    DISPATCH_MACH_SEND_DEAD = 0x1, 
};

enum {
    DISPATCH_PROC_EXIT = 0x80000000, 
    DISPATCH_PROC_FORK = 0x40000000, 
    DISPATCH_PROC_EXEC = 0x20000000, 
    DISPATCH_PROC_SIGNAL = 0x08000000, 
};

enum {
    DISPATCH_VNODE_DELETE = 0x1, 
    DISPATCH_VNODE_WRITE = 0x2, 
    DISPATCH_VNODE_EXTEND = 0x4, 
    DISPATCH_VNODE_ATTRIB = 0x8, 
    DISPATCH_VNODE_LINK     = 0x10, 
    DISPATCH_VNODE_RENAME = 0x20, 
    DISPATCH_VNODE_REVOKE = 0x40, 
};

__DISPATCH_BEGIN_DECLS

DISPATCH_EXPORT  
dispatch_source_t
dispatch_source_create(dispatch_source_type_t type,
       uintptr_t handle,
       unsigned long mask,
       dispatch_queue_t queue);

#ifdef __BLOCKS__

DISPATCH_EXPORT  
void
dispatch_source_set_event_handler(dispatch_source_t source,
       dispatch_block_t handler);
#endif /* __BLOCKS__ */

DISPATCH_EXPORT  
void
dispatch_source_set_event_handler_f(dispatch_source_t source,
       dispatch_function_t handler);

#ifdef __BLOCKS__

DISPATCH_EXPORT  
void
dispatch_source_set_cancel_handler(dispatch_source_t source,
       dispatch_block_t cancel_handler);
#endif /* __BLOCKS__ */

DISPATCH_EXPORT  
void
dispatch_source_set_cancel_handler_f(dispatch_source_t source,
       dispatch_function_t cancel_handler);

DISPATCH_EXPORT  
void
dispatch_source_cancel(dispatch_source_t source);

DISPATCH_EXPORT  
long
dispatch_source_testcancel(dispatch_source_t source);

DISPATCH_EXPORT    
uintptr_t
dispatch_source_get_handle(dispatch_source_t source);

DISPATCH_EXPORT    
unsigned long
dispatch_source_get_mask(dispatch_source_t source);

DISPATCH_EXPORT    
unsigned long
dispatch_source_get_data(dispatch_source_t source);

DISPATCH_EXPORT  
void
dispatch_source_merge_data(dispatch_source_t source, unsigned long value);

DISPATCH_EXPORT  
void
dispatch_source_set_timer(dispatch_source_t source,
       dispatch_time_t start,
       uint64_t interval,
       uint64_t leeway);

__DISPATCH_END_DECLS

#endif