usr/src/lib/libc/inc/lint.h

   1 /*
   2  * CDDL HEADER START
   3  *
   4  * The contents of this file are subject to the terms of the
   5  * Common Development and Distribution License (the "License").
   6  * You may not use this file except in compliance with the License.
   7  *
   8  * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
   9  * or http://www.opensolaris.org/os/licensing.
  10  * See the License for the specific language governing permissions
  11  * and limitations under the License.
  12  *
  13  * When distributing Covered Code, include this CDDL HEADER in each
  14  * file and include the License file at usr/src/OPENSOLARIS.LICENSE.
  15  * If applicable, add the following below this CDDL HEADER, with the
  16  * fields enclosed by brackets "[]" replaced with your own identifying
  17  * information: Portions Copyright [yyyy] [name of copyright owner]
  18  *
  19  * CDDL HEADER END
  20  */
  21
  22 /*
  23  * Copyright 2009 Sun Microsystems, Inc.  All rights reserved.
  24  * Use is subject to license terms.
  25  */
  26
  27 #ifndef _LIBC_LINT_H
  28 #define _LIBC_LINT_H
  29
  30 #ifdef __cplusplus
  31 extern "C" {
  32 #endif
  33
  34 /* we need the following to pick up _LP64 */
  35 #include <sys/feature_tests.h>
  36
  37 /*
  38  * We must include "lint.h" as the first #include in all libc source files
  39  * for the purpose of running lint over libc, else lint errors occur due to
  40  * lint not knowing the details of the implementation of locales and stdio.
  41  */
  42
  43 /*
  44  * Small optimization for callers of syscall() and __systemcall().
  45  * This could/should be defined elsewhere, but here is a particularly
  46  * attractive place since all source files in libc include "lint.h".
  47  */
  48 #define syscall         _syscall6
  49 #define __systemcall    __systemcall6
  50
  51 /*
  52  * Shades of the old and deprecated "synonyms.h" file.
  53  * Because of the awkward relationship between these functions:
  54  *      memcmp()
  55  *      memcpy()
  56  *      memmove()
  57  *      memset()
  58  * and the sparc auxiliary filters:
  59  *      /platform/.../lib/libc_psr.so.1
  60  * we must be careful always to call the leading-underscore
  61  * symbol names when calling from within libc itself.
  62  *
  63  * If an interposer interposes on these mem*() symbol names,
  64  * and we call one of them from within a critical region in libc,
  65  * we will end up in the interposer code while executing within
  66  * the critical region.  Chaos can ensue.
  67  *
  68  * We try to avoid this by calling only the leading-underscore names.
  69  * We hope that no interposer will interpose on the leading-underscore
  70  * versions of these functions, else all hope is lost.
  71  */
  72
  73 #pragma redefine_extname        memcmp          _memcmp
  74 #pragma redefine_extname        memcpy          _memcpy
  75 #pragma redefine_extname        memmove         _memmove
  76 #pragma redefine_extname        memset          _memset
  77
  78
  79 #ifdef __cplusplus
  80 }
  81 #endif
  82
  83 #endif /* _LIBC_LINT_H */