639ec13157
No functional change (in program code). Additional DWARF metadata is generated in the .eh_frame section. Also, it is now a compile-time requirement that machine/asm.h ENTRY() and END() macros are paired. (This is subject to ongoing discussion and may change.) This DWARF metadata allows llvm-libunwind to unwind program stacks when the program is executing the function. The goal is to collect accurate userspace stacktraces when programs have entered syscalls. (The motivation for "Call Frame Information," or CFI for short -- not to be confused with Control Flow Integrity -- is to sufficiently annotate assembly functions such that stack unwinders can unwind out of the local frame without the requirement of a dedicated framepointer register; i.e., -fomit-frame-pointer. This is necessary for C++ exception handling or collecting backtraces.) For the curious, a more thorough description of the metadata and some examples may be found at [1] and documentation at [2]. You can also look at 'cc -S -o - foo.c | less' and search for '.cfi_' to see the CFI directives generated by your C compiler. [1]: https://www.imperialviolet.org/2017/01/18/cfi.html [2]: https://sourceware.org/binutils/docs/as/CFI-directives.html Reviewed by: emaste, kib (with reservations) Differential Revision: https://reviews.freebsd.org/D22122
113 lines
3.6 KiB
C
113 lines
3.6 KiB
C
/*-
|
|
* SPDX-License-Identifier: BSD-3-Clause
|
|
*
|
|
* Copyright (c) 1990 The Regents of the University of California.
|
|
* All rights reserved.
|
|
*
|
|
* This code is derived from software contributed to Berkeley by
|
|
* William Jolitz.
|
|
*
|
|
* Redistribution and use in source and binary forms, with or without
|
|
* modification, are permitted provided that the following conditions
|
|
* are met:
|
|
* 1. Redistributions of source code must retain the above copyright
|
|
* notice, this list of conditions and the following disclaimer.
|
|
* 2. Redistributions in binary form must reproduce the above copyright
|
|
* notice, this list of conditions and the following disclaimer in the
|
|
* documentation and/or other materials provided with the distribution.
|
|
* 3. Neither the name of the University nor the names of its contributors
|
|
* may be used to endorse or promote products derived from this software
|
|
* without specific prior written permission.
|
|
*
|
|
* THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
|
|
* ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
|
|
* IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
|
|
* ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
|
|
* FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
|
|
* DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
|
|
* OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
|
|
* HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
|
|
* LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
|
|
* OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
|
|
* SUCH DAMAGE.
|
|
*
|
|
* from: @(#)DEFS.h 5.1 (Berkeley) 4/23/90
|
|
* $FreeBSD$
|
|
*/
|
|
|
|
#ifndef _MACHINE_ASM_H_
|
|
#define _MACHINE_ASM_H_
|
|
|
|
#include <sys/cdefs.h>
|
|
|
|
#ifdef PIC
|
|
#define PIC_PLT(x) x@PLT
|
|
#define PIC_GOT(x) x@GOTPCREL(%rip)
|
|
#else
|
|
#define PIC_PLT(x) x
|
|
#endif
|
|
|
|
/*
|
|
* CNAME and HIDENAME manage the relationship between symbol names in C
|
|
* and the equivalent assembly language names. CNAME is given a name as
|
|
* it would be used in a C program. It expands to the equivalent assembly
|
|
* language name. HIDENAME is given an assembly-language name, and expands
|
|
* to a possibly-modified form that will be invisible to C programs.
|
|
*/
|
|
#define CNAME(csym) csym
|
|
#define HIDENAME(asmsym) .asmsym
|
|
|
|
#define _START_ENTRY .text; .p2align 4,0x90
|
|
|
|
#define _ENTRY(x) _START_ENTRY; \
|
|
.globl CNAME(x); .type CNAME(x),@function; CNAME(x):; \
|
|
.cfi_startproc
|
|
|
|
#ifdef PROF
|
|
#define ALTENTRY(x) _ENTRY(x); \
|
|
pushq %rbp; \
|
|
.cfi_def_cfa_offset 16; \
|
|
.cfi_offset %rbp, -16; \
|
|
movq %rsp,%rbp; \
|
|
call PIC_PLT(HIDENAME(mcount)); \
|
|
popq %rbp; \
|
|
.cfi_restore %rbp; \
|
|
.cfi_def_cfa_offset 8; \
|
|
jmp 9f
|
|
#define ENTRY(x) _ENTRY(x); \
|
|
pushq %rbp; \
|
|
.cfi_def_cfa_offset 16; \
|
|
.cfi_offset %rbp, -16; \
|
|
movq %rsp,%rbp; \
|
|
call PIC_PLT(HIDENAME(mcount)); \
|
|
popq %rbp; \
|
|
.cfi_restore %rbp; \
|
|
.cfi_def_cfa_offset 8; \
|
|
9:
|
|
#else
|
|
#define ALTENTRY(x) _ENTRY(x)
|
|
#define ENTRY(x) _ENTRY(x)
|
|
#endif
|
|
|
|
#define END(x) .size x, . - x; .cfi_endproc
|
|
/*
|
|
* WEAK_REFERENCE(): create a weak reference alias from sym.
|
|
* The macro is not a general asm macro that takes arbitrary names,
|
|
* but one that takes only C names. It does the non-null name
|
|
* translation inside the macro.
|
|
*/
|
|
#define WEAK_REFERENCE(sym, alias) \
|
|
.weak CNAME(alias); \
|
|
.equ CNAME(alias),CNAME(sym)
|
|
|
|
#define RCSID(x) .text; .asciz x
|
|
|
|
#undef __FBSDID
|
|
#if !defined(STRIP_FBSDID)
|
|
#define __FBSDID(s) .ident s
|
|
#else
|
|
#define __FBSDID(s) /* nothing */
|
|
#endif /* !STRIP_FBSDID */
|
|
|
|
#endif /* !_MACHINE_ASM_H_ */
|