cachepc-linux

Fork of AMDESE/linux with modifications for CachePC side-channel attack
git clone https://git.sinitax.com/sinitax/cachepc-linux
Log | Files | Refs | README | LICENSE | sfeed.txt

trace_seq.h (4009B)


      1/* SPDX-License-Identifier: GPL-2.0 */
      2#ifndef _LINUX_TRACE_SEQ_H
      3#define _LINUX_TRACE_SEQ_H
      4
      5#include <linux/seq_buf.h>
      6
      7#include <asm/page.h>
      8
      9/*
     10 * Trace sequences are used to allow a function to call several other functions
     11 * to create a string of data to use (up to a max of PAGE_SIZE).
     12 */
     13
     14struct trace_seq {
     15	char			buffer[PAGE_SIZE];
     16	struct seq_buf		seq;
     17	int			full;
     18};
     19
     20static inline void
     21trace_seq_init(struct trace_seq *s)
     22{
     23	seq_buf_init(&s->seq, s->buffer, PAGE_SIZE);
     24	s->full = 0;
     25}
     26
     27/**
     28 * trace_seq_used - amount of actual data written to buffer
     29 * @s: trace sequence descriptor
     30 *
     31 * Returns the amount of data written to the buffer.
     32 *
     33 * IMPORTANT!
     34 *
     35 * Use this instead of @s->seq.len if you need to pass the amount
     36 * of data from the buffer to another buffer (userspace, or what not).
     37 * The @s->seq.len on overflow is bigger than the buffer size and
     38 * using it can cause access to undefined memory.
     39 */
     40static inline int trace_seq_used(struct trace_seq *s)
     41{
     42	return seq_buf_used(&s->seq);
     43}
     44
     45/**
     46 * trace_seq_buffer_ptr - return pointer to next location in buffer
     47 * @s: trace sequence descriptor
     48 *
     49 * Returns the pointer to the buffer where the next write to
     50 * the buffer will happen. This is useful to save the location
     51 * that is about to be written to and then return the result
     52 * of that write.
     53 */
     54static inline char *
     55trace_seq_buffer_ptr(struct trace_seq *s)
     56{
     57	return s->buffer + seq_buf_used(&s->seq);
     58}
     59
     60/**
     61 * trace_seq_has_overflowed - return true if the trace_seq took too much
     62 * @s: trace sequence descriptor
     63 *
     64 * Returns true if too much data was added to the trace_seq and it is
     65 * now full and will not take anymore.
     66 */
     67static inline bool trace_seq_has_overflowed(struct trace_seq *s)
     68{
     69	return s->full || seq_buf_has_overflowed(&s->seq);
     70}
     71
     72/*
     73 * Currently only defined when tracing is enabled.
     74 */
     75#ifdef CONFIG_TRACING
     76extern __printf(2, 3)
     77void trace_seq_printf(struct trace_seq *s, const char *fmt, ...);
     78extern __printf(2, 0)
     79void trace_seq_vprintf(struct trace_seq *s, const char *fmt, va_list args);
     80extern void
     81trace_seq_bprintf(struct trace_seq *s, const char *fmt, const u32 *binary);
     82extern int trace_print_seq(struct seq_file *m, struct trace_seq *s);
     83extern int trace_seq_to_user(struct trace_seq *s, char __user *ubuf,
     84			     int cnt);
     85extern void trace_seq_puts(struct trace_seq *s, const char *str);
     86extern void trace_seq_putc(struct trace_seq *s, unsigned char c);
     87extern void trace_seq_putmem(struct trace_seq *s, const void *mem, unsigned int len);
     88extern void trace_seq_putmem_hex(struct trace_seq *s, const void *mem,
     89				unsigned int len);
     90extern int trace_seq_path(struct trace_seq *s, const struct path *path);
     91
     92extern void trace_seq_bitmask(struct trace_seq *s, const unsigned long *maskp,
     93			     int nmaskbits);
     94
     95extern int trace_seq_hex_dump(struct trace_seq *s, const char *prefix_str,
     96			      int prefix_type, int rowsize, int groupsize,
     97			      const void *buf, size_t len, bool ascii);
     98
     99#else /* CONFIG_TRACING */
    100static inline void trace_seq_printf(struct trace_seq *s, const char *fmt, ...)
    101{
    102}
    103static inline void
    104trace_seq_bprintf(struct trace_seq *s, const char *fmt, const u32 *binary)
    105{
    106}
    107
    108static inline void
    109trace_seq_bitmask(struct trace_seq *s, const unsigned long *maskp,
    110		  int nmaskbits)
    111{
    112}
    113
    114static inline int trace_print_seq(struct seq_file *m, struct trace_seq *s)
    115{
    116	return 0;
    117}
    118static inline int trace_seq_to_user(struct trace_seq *s, char __user *ubuf,
    119				    int cnt)
    120{
    121	return 0;
    122}
    123static inline void trace_seq_puts(struct trace_seq *s, const char *str)
    124{
    125}
    126static inline void trace_seq_putc(struct trace_seq *s, unsigned char c)
    127{
    128}
    129static inline void
    130trace_seq_putmem(struct trace_seq *s, const void *mem, unsigned int len)
    131{
    132}
    133static inline void trace_seq_putmem_hex(struct trace_seq *s, const void *mem,
    134				       unsigned int len)
    135{
    136}
    137static inline int trace_seq_path(struct trace_seq *s, const struct path *path)
    138{
    139	return 0;
    140}
    141#endif /* CONFIG_TRACING */
    142
    143#endif /* _LINUX_TRACE_SEQ_H */