diff options
Diffstat (limited to 'sideband/internal/include/pt_sb_session.h')
| -rw-r--r-- | sideband/internal/include/pt_sb_session.h | 101 |
1 files changed, 101 insertions, 0 deletions
diff --git a/sideband/internal/include/pt_sb_session.h b/sideband/internal/include/pt_sb_session.h new file mode 100644 index 000000000000..365e7daf32dc --- /dev/null +++ b/sideband/internal/include/pt_sb_session.h @@ -0,0 +1,101 @@ +/* + * Copyright (c) 2017-2019, Intel Corporation + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions are met: + * + * * Redistributions of source code must retain the above copyright notice, + * this list of conditions and the following disclaimer. + * * 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. + * * Neither the name of Intel Corporation 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 COPYRIGHT HOLDERS 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 COPYRIGHT OWNER 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. + */ + +#ifndef PT_SB_SESSION_H +#define PT_SB_SESSION_H + +#include "libipt-sb.h" + +struct pt_image_section_cache; +struct pt_image; +struct pt_sb_context; +struct pt_sb_decoder; + + +struct pt_sb_session { + /* The image section cache to use for new image sections. + * + * This allows sharing image sections across contexts. + */ + struct pt_image_section_cache *iscache; + + /* A linear list of contexts in no particular order. */ + struct pt_sb_context *contexts; + + /* The kernel memory image. + * + * Just like process images, the kernel image may change over time. It + * is used to populate new process images. + * + * This assumes that the full kernel is mapped into every process. + */ + struct pt_image *kernel; + + /* A list of sideband decoders ordered by their @tsc (ascending). */ + struct pt_sb_decoder *decoders; + + /* A list of newly added sideband decoders in no particular order. + * + * Use pt_sb_init_decoders() to fetch the first record and move them to + * @decoders. + */ + struct pt_sb_decoder *waiting; + + /* A list of retired sideband decoders in no particular order. + * + * They ran out of trace but might still have a postponed effect + * pending. We present events to them until @apply() returns -pte_eos. + */ + struct pt_sb_decoder *retired; + + /* A list of removed sideband decoders in no particular order. + * + * They wait for their destruction when the session is destroyed. + */ + struct pt_sb_decoder *removed; + + /* An optional callback function to be called on sideband decode errors + * and warnings. + */ + pt_sb_error_notifier_t *notify_error; + + /* The private data for the error notifier. */ + void *priv_error; + + /* An optional callback function to be called on context switches. */ + pt_sb_ctx_switch_notifier_t *notify_switch_to; + + /* The private data for the context switch notifier. */ + void *priv_switch_to; +}; + + +extern int pt_sb_error(const struct pt_sb_session *session, int errcode, + const char *filename, uint64_t offset); + +#endif /* PT_SB_SESSION_H */ |