Whamcloud - gitweb
Land b_head_libcfs onto HEAD (20080805_1722)
[fs/lustre-release.git] / libcfs / include / libcfs / darwin / libcfs.h
1 /* -*- mode: c; c-basic-offset: 8; indent-tabs-mode: nil; -*-
2  * vim:expandtab:shiftwidth=8:tabstop=8:
3  *
4  * GPL HEADER START
5  *
6  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
7  *
8  * This program is free software; you can redistribute it and/or modify
9  * it under the terms of the GNU General Public License version 2 only,
10  * as published by the Free Software Foundation.
11  *
12  * This program is distributed in the hope that it will be useful, but
13  * WITHOUT ANY WARRANTY; without even the implied warranty of
14  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
15  * General Public License version 2 for more details (a copy is included
16  * in the LICENSE file that accompanied this code).
17  *
18  * You should have received a copy of the GNU General Public License
19  * version 2 along with this program; If not, see [sun.com URL with a
20  * copy of GPLv2].
21  *
22  * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
23  * CA 95054 USA or visit www.sun.com if you need additional information or
24  * have any questions.
25  *
26  * GPL HEADER END
27  */
28 /*
29  * Copyright  2008 Sun Microsystems, Inc. All rights reserved
30  * Use is subject to license terms.
31  */
32 /*
33  * This file is part of Lustre, http://www.lustre.org/
34  * Lustre is a trademark of Sun Microsystems, Inc.
35  */
36
37 #ifndef __LIBCFS_DARWIN_LIBCFS_H__
38 #define __LIBCFS_DARWIN_LIBCFS_H__
39
40 #ifndef __LIBCFS_LIBCFS_H__
41 #error Do not #include this file directly. #include <libcfs/libcfs.h> instead
42 #endif
43
44 #include <mach/mach_types.h>
45 #include <sys/errno.h>
46 #include <string.h>
47 #include <libcfs/darwin/darwin-types.h>
48 #include <libcfs/darwin/darwin-time.h>
49 #include <libcfs/darwin/darwin-prim.h>
50 #include <libcfs/darwin/darwin-mem.h>
51 #include <libcfs/darwin/darwin-lock.h>
52 #include <libcfs/darwin/darwin-fs.h>
53 #include <libcfs/darwin/darwin-tcpip.h>
54 #include <libcfs/darwin/kp30.h>
55
56 #ifdef __KERNEL__
57 # include <sys/types.h>
58 # include <sys/time.h>
59 # define do_gettimeofday(tv) microuptime(tv)
60 #else
61 # include <sys/time.h>
62 # define do_gettimeofday(tv) gettimeofday(tv, NULL);
63 typedef unsigned long long cycles_t;
64 #endif
65
66 #define __cpu_to_le64(x)                        OSSwapHostToLittleInt64(x)
67 #define __cpu_to_le32(x)                        OSSwapHostToLittleInt32(x)
68 #define __cpu_to_le16(x)                        OSSwapHostToLittleInt16(x)
69
70 #define __le16_to_cpu(x)                        OSSwapLittleToHostInt16(x)
71 #define __le32_to_cpu(x)                        OSSwapLittleToHostInt32(x)
72 #define __le64_to_cpu(x)                        OSSwapLittleToHostInt64(x)
73
74 #define cpu_to_le64(x)                          __cpu_to_le64(x)
75 #define cpu_to_le32(x)                          __cpu_to_le32(x)
76 #define cpu_to_le16(x)                          __cpu_to_le16(x)
77
78 #define le64_to_cpu(x)                          __le64_to_cpu(x)
79 #define le32_to_cpu(x)                          __le32_to_cpu(x)
80 #define le16_to_cpu(x)                          __le16_to_cpu(x)
81
82 #define __swab16(x)                             OSSwapInt16(x)
83 #define __swab32(x)                             OSSwapInt32(x)
84 #define __swab64(x)                             OSSwapInt64(x)
85 #define __swab16s(x)                            do { *(x) = __swab16(*(x)); } while (0)
86 #define __swab32s(x)                            do { *(x) = __swab32(*(x)); } while (0)
87 #define __swab64s(x)                            do { *(x) = __swab64(*(x)); } while (0)
88
89
90 #ifdef __KERNEL__
91 # include <sys/systm.h>
92 # include <pexpert/pexpert.h>
93 /* Fix me */
94 # define THREAD_SIZE 8192
95 #else
96 # define THREAD_SIZE 8192
97 #endif
98 #define LUSTRE_TRACE_SIZE (THREAD_SIZE >> 5)
99
100 #define CHECK_STACK() do { } while(0)
101 #define CDEBUG_STACK() (0L)
102
103 /* Darwin has defined RETURN, so we have to undef it in lustre */
104 #ifdef RETURN
105 #undef RETURN
106 #endif
107
108 /*
109  * When this is enabled debugging messages are indented according to the
110  * current "nesting level". Nesting level in increased when ENTRY macro
111  * is executed, and decreased on EXIT and RETURN.
112  */
113 #ifdef __KERNEL__
114 #define ENTRY_NESTING_SUPPORT (0)
115 #endif
116
117 #if ENTRY_NESTING_SUPPORT
118
119 /*
120  * Currently ENTRY_NESTING_SUPPORT is only supported for XNU port. Basic
121  * idea is to keep per-thread pointer to small data structure (struct
122  * cfs_debug_data) describing current nesting level. In XNU unused
123  * proc->p_wmegs field in hijacked for this. On Linux
124  * current->journal_info can be used. In user space
125  * pthread_{g,s}etspecific().
126  *
127  * ENTRY macro allocates new cfs_debug_data on stack, and installs it as
128  * a current nesting level, storing old data in cfs_debug_data it just
129  * created.
130  *
131  * EXIT pops old value back.
132  *
133  */
134
135 /*
136  * One problem with this approach is that there is a lot of code that
137  * does ENTRY and then escapes scope without doing EXIT/RETURN. In this
138  * case per-thread current nesting level pointer is dangling (it points
139  * to the stack area that is possible already overridden). To detect
140  * such cases, we add two magic fields to the cfs_debug_data and check
141  * them whenever current nesting level pointer is dereferenced. While
142  * looking flaky this works because stack is always consumed
143  * "continously".
144  */
145 enum {
146         CDD_MAGIC1 = 0x02128506,
147         CDD_MAGIC2 = 0x42424242
148 };
149
150 struct cfs_debug_data {
151         unsigned int           magic1;
152         struct cfs_debug_data *parent;
153         int                    nesting_level;
154         unsigned int           magic2;
155 };
156
157 void __entry_nesting(struct cfs_debug_data *child);
158 void __exit_nesting(struct cfs_debug_data *child);
159 unsigned int __current_nesting_level(void);
160
161 #define ENTRY_NESTING                                           \
162 struct cfs_debug_data __cdd = { .magic1        = CDD_MAGIC1,    \
163                                 .parent        = NULL,          \
164                                 .nesting_level = 0,             \
165                                 .magic2        = CDD_MAGIC2 };  \
166 __entry_nesting(&__cdd);
167
168 #define EXIT_NESTING __exit_nesting(&__cdd)
169
170 /* ENTRY_NESTING_SUPPORT */
171 #else
172
173 #define ENTRY_NESTING   do {;} while (0)
174 #define EXIT_NESTING   do {;} while (0)
175 #define __current_nesting_level() (0)
176
177 /* ENTRY_NESTING_SUPPORT */
178 #endif
179
180 #define LUSTRE_LNET_PID          12345
181
182 #define _XNU_LIBCFS_H
183
184 /*
185  * Platform specific declarations for cfs_curproc API (libcfs/curproc.h)
186  *
187  * Implementation is in darwin-curproc.c
188  */
189 #define CFS_CURPROC_COMM_MAX    MAXCOMLEN
190 /*
191  * XNU has no capabilities
192  */
193 typedef int cfs_kernel_cap_t;
194
195 #ifdef __KERNEL__
196 enum {
197         /* if you change this, update darwin-util.c:cfs_stack_trace_fill() */
198         CFS_STACK_TRACE_DEPTH = 16
199 };
200
201 struct cfs_stack_trace {
202         void *frame[CFS_STACK_TRACE_DEPTH];
203 };
204
205 #define printk(format, args...)                 printf(format, ## args)
206
207 #ifdef WITH_WATCHDOG
208 #undef WITH_WATCHDOG
209 #endif
210
211 #endif /* __KERNEL__ */
212
213 #endif /* _XNU_LIBCFS_H */