[apple/syslog.git] / libsystem_asl.tproj / include / asl_private.h

/*
 * Copyright (c) 2007-2015 Apple Inc. All rights reserved.
 *
 * @APPLE_LICENSE_HEADER_START@
 *
 * 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 2.0 (the 'License'). You may not use this file except in
 * compliance with the License. Please obtain a copy of the License at
 * http://www.opensource.apple.com/apsl/ 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, QUIET ENJOYMENT OR NON-INFRINGEMENT.
 * Please see the License for the specific language governing rights and
 * limitations under the License.
 * 
 * @APPLE_LICENSE_HEADER_END@
 */

#ifndef __ASL_PRIVATE_H__
#define __ASL_PRIVATE_H__

#include <asl.h>
#include <stdint.h>
#include <sys/socket.h>
#include <sys/un.h>
#include <sys/time.h>
#include <mach/vm_statistics.h>
#include <netinet/in.h>
#include <arpa/inet.h>
#include <Availability.h>
#include <os/object.h>
#include <os/object_private.h>

#define ASL_QUERY_OP_NULL          0x00000

#define ASLMANAGER_SERVICE_NAME "com.apple.aslmanager"
#define NOTIFY_SYSTEM_MASTER "com.apple.system.syslog.master"
#define NOTIFY_SYSTEM_ASL_FILTER "com.apple.system.syslog.asl_filter"
#define NOTIFY_PREFIX_SYSTEM "com.apple.system.syslog"
#define NOTIFY_PREFIX_USER "user.syslog"
#define NOTIFY_RC "com.apple.asl.remote"

#define ASL_OPT_IGNORE "ignore"
#define ASL_OPT_STORE "store"
#define ASL_OPT_CONTROL "control"

/* File and Store Open Option */
#define ASL_OPT_OPEN_READ   0x80000000

#define ASL_OPT_SHIM_NO_ASL   0x10000000
#define ASL_OPT_SHIM_NO_TRACE 0x20000000

#define ASL_STORE_LOCATION_FILE 0
#define ASL_STORE_LOCATION_MEMORY 1

#define ASL_OPT_SYSLOG_LEGACY  0x00010000

#define ASL_KEY_FREE_NOTE "ASLFreeNotify"
#define ASL_KEY_MESSAGETRACER "com.apple.message.domain"

/* remote control bits */
#define EVAL_LEVEL_MASK   0x000000ff
#define EVAL_ACTION_MASK  0xffff0000
#define EVAL_ACTIVE       0x00010000
#define EVAL_SEND_ASL     0x00020000
#define EVAL_SEND_TRACE   0x00040000
#define EVAL_TEXT_FILE    0x00080000
#define EVAL_ASL_FILE     0x00100000
#define EVAL_TUNNEL       0x00200000
#define EVAL_QUOTA        0x00400000

/*
 * Private types
 */
#define ASL_TYPE_STRING       6
#define ASL_TYPE_COUNT        7

/* SPI to enable ASL filter tunneling using asl_set_filter() */
#define ASL_FILTER_MASK_TUNNEL   0x100

#define NOQUOTA_FILE_PATH "/etc/asl/.noquota"

// TODO: this could move to vm_statistics.h
#ifndef VM_MEMORY_ASL
#define VM_MEMORY_ASL (VM_MEMORY_APPLICATION_SPECIFIC_1 + 7)
#endif

/*
 * Memory limits: work queue size for syslogd and max message size in libasl
 */
#if TARGET_OS_EMBEDDED
#define SYSLOGD_WORK_QUEUE_MEMORY 3072000
#define LIBASL_MAX_MSG_SIZE       2048000
#else
#define SYSLOGD_WORK_QUEUE_MEMORY 10240000
#define LIBASL_MAX_MSG_SIZE        8192000
#endif

__BEGIN_DECLS

int asl_store_location() __OSX_AVAILABLE_STARTING(__MAC_10_7, __IPHONE_4_3);
char *asl_remote_notify_name() __OSX_AVAILABLE_STARTING(__MAC_10_7, __IPHONE_4_3);
int asl_syslog_faciliy_name_to_num(const char *name) __OSX_AVAILABLE_STARTING(__MAC_10_5, __IPHONE_2_0);
const char *asl_syslog_faciliy_num_to_name(int n) __OSX_AVAILABLE_STARTING(__MAC_10_5, __IPHONE_2_0);
int asl_trigger_aslmanager(void) __OSX_AVAILABLE_STARTING(__MAC_10_10, __IPHONE_7_0);
int asl_get_filter(asl_object_t client, int *local, int *master, int *remote, int *active) __OSX_AVAILABLE_STARTING(__MAC_10_7, __IPHONE_4_3);
uint32_t asl_set_local_control(asl_object_t client, uint32_t filter) __OSX_AVAILABLE_STARTING(__MAC_10_11, __IPHONE_9_0);
uint32_t asl_get_local_control(asl_object_t client) __OSX_AVAILABLE_STARTING(__MAC_10_11, __IPHONE_9_0);

/* EXCLUSIVLY FOR USE BY DEV TOOLS */
/* DO NOT USE THIS INTERFACE OTHERWISE */

uint32_t asl_store_match_timeout(void *ignored, void *query_v1, void **result_v1, uint64_t *last_id, uint64_t start_id, uint32_t count, int32_t direction, uint32_t usec) __OSX_AVAILABLE_STARTING(__MAC_10_10, __IPHONE_7_0);

__END_DECLS


#endif /* __ASL_PRIVATE_H__ */
Commit	Line	Data
81582353	1	/*
5222c21d	2	* Copyright (c) 2007-2015 Apple Inc. All rights reserved.
81582353 A	3	*
	4	* @APPLE_LICENSE_HEADER_START@
	5	*
	6	* This file contains Original Code and/or Modifications of Original Code
	7	* as defined in and that are subject to the Apple Public Source License
	8	* Version 2.0 (the 'License'). You may not use this file except in
	9	* compliance with the License. Please obtain a copy of the License at
	10	* http://www.opensource.apple.com/apsl/ and read it before using this
	11	* file.
	12	*
	13	* The Original Code and all software distributed under the License are
	14	* distributed on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER
	15	* EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES,
	16	* INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY,
	17	* FITNESS FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT.
	18	* Please see the License for the specific language governing rights and
	19	* limitations under the License.
	20	*
	21	* @APPLE_LICENSE_HEADER_END@
	22	*/
	23
	24	#ifndef __ASL_PRIVATE_H__
	25	#define __ASL_PRIVATE_H__
	26
f3df4c03	27	#include <asl.h>
81582353 A	28	#include <stdint.h>
	29	#include <sys/socket.h>
	30	#include <sys/un.h>
f3df4c03	31	#include <sys/time.h>
5222c21d	32	#include <mach/vm_statistics.h>
81582353 A	33	#include <netinet/in.h>
81582353 A	34	#include <arpa/inet.h>
81582353	35	#include <Availability.h>
f3df4c03 A	36	#include <os/object.h>
	37	#include <os/object_private.h>
	38
81582353 A	39	#define ASL_QUERY_OP_NULL 0x00000
	40
	41	#define ASLMANAGER_SERVICE_NAME "com.apple.aslmanager"
	42	#define NOTIFY_SYSTEM_MASTER "com.apple.system.syslog.master"
	43	#define NOTIFY_SYSTEM_ASL_FILTER "com.apple.system.syslog.asl_filter"
	44	#define NOTIFY_PREFIX_SYSTEM "com.apple.system.syslog"
	45	#define NOTIFY_PREFIX_USER "user.syslog"
	46	#define NOTIFY_RC "com.apple.asl.remote"
	47
	48	#define ASL_OPT_IGNORE "ignore"
	49	#define ASL_OPT_STORE "store"
f3df4c03 A	50	#define ASL_OPT_CONTROL "control"
	51
	52	/* File and Store Open Option */
	53	#define ASL_OPT_OPEN_READ 0x80000000
81582353	54
5222c21d A	55	#define ASL_OPT_SHIM_NO_ASL 0x10000000
	56	#define ASL_OPT_SHIM_NO_TRACE 0x20000000
	57
81582353 A	58	#define ASL_STORE_LOCATION_FILE 0
	59	#define ASL_STORE_LOCATION_MEMORY 1
	60
	61	#define ASL_OPT_SYSLOG_LEGACY 0x00010000
	62
f3df4c03	63	#define ASL_KEY_FREE_NOTE "ASLFreeNotify"
5222c21d A	64	#define ASL_KEY_MESSAGETRACER "com.apple.message.domain"
	65
	66	/* remote control bits */
	67	#define EVAL_LEVEL_MASK 0x000000ff
	68	#define EVAL_ACTION_MASK 0xffff0000
	69	#define EVAL_ACTIVE 0x00010000
	70	#define EVAL_SEND_ASL 0x00020000
	71	#define EVAL_SEND_TRACE 0x00040000
	72	#define EVAL_TEXT_FILE 0x00080000
	73	#define EVAL_ASL_FILE 0x00100000
	74	#define EVAL_TUNNEL 0x00200000
	75	#define EVAL_QUOTA 0x00400000
f3df4c03 A	76
	77	/*
	78	* Private types
	79	*/
	80	#define ASL_TYPE_STRING 6
	81	#define ASL_TYPE_COUNT 7
81582353 A	82
	83	/* SPI to enable ASL filter tunneling using asl_set_filter() */
	84	#define ASL_FILTER_MASK_TUNNEL 0x100
	85
f3df4c03	86	#define NOQUOTA_FILE_PATH "/etc/asl/.noquota"
81582353	87
5222c21d A	88	// TODO: this could move to vm_statistics.h
	89	#ifndef VM_MEMORY_ASL
	90	#define VM_MEMORY_ASL (VM_MEMORY_APPLICATION_SPECIFIC_1 + 7)
	91	#endif
	92
	93	/*
	94	* Memory limits: work queue size for syslogd and max message size in libasl
	95	*/
	96	#if TARGET_OS_EMBEDDED
	97	#define SYSLOGD_WORK_QUEUE_MEMORY 3072000
	98	#define LIBASL_MAX_MSG_SIZE 2048000
	99	#else
	100	#define SYSLOGD_WORK_QUEUE_MEMORY 10240000
	101	#define LIBASL_MAX_MSG_SIZE 8192000
	102	#endif
	103
81582353 A	104	__BEGIN_DECLS
81582353 A	105
81582353	106	int asl_store_location() __OSX_AVAILABLE_STARTING(__MAC_10_7, __IPHONE_4_3);
81582353	107	char *asl_remote_notify_name() __OSX_AVAILABLE_STARTING(__MAC_10_7, __IPHONE_4_3);
f3df4c03 A	108	int asl_syslog_faciliy_name_to_num(const char *name) __OSX_AVAILABLE_STARTING(__MAC_10_5, __IPHONE_2_0);
	109	const char *asl_syslog_faciliy_num_to_name(int n) __OSX_AVAILABLE_STARTING(__MAC_10_5, __IPHONE_2_0);
	110	int asl_trigger_aslmanager(void) __OSX_AVAILABLE_STARTING(__MAC_10_10, __IPHONE_7_0);
	111	int asl_get_filter(asl_object_t client, int local, int master, int remote, int active) __OSX_AVAILABLE_STARTING(__MAC_10_7, __IPHONE_4_3);
5222c21d A	112	uint32_t asl_set_local_control(asl_object_t client, uint32_t filter) __OSX_AVAILABLE_STARTING(__MAC_10_11, __IPHONE_9_0);
5222c21d A	113	uint32_t asl_get_local_control(asl_object_t client) __OSX_AVAILABLE_STARTING(__MAC_10_11, __IPHONE_9_0);
f3df4c03 A	114
	115	/* EXCLUSIVLY FOR USE BY DEV TOOLS */
	116	/* DO NOT USE THIS INTERFACE OTHERWISE */
	117
	118	uint32_t asl_store_match_timeout(void ignored, void query_v1, void *result_v1, uint64_t last_id, uint64_t start_id, uint32_t count, int32_t direction, uint32_t usec) __OSX_AVAILABLE_STARTING(__MAC_10_10, __IPHONE_7_0);
81582353 A	119
	120	__END_DECLS
	121
f3df4c03	122
81582353	123	#endif /* __ASL_PRIVATE_H__ */