mirror of
git://nv-tegra.nvidia.com/linux-nvgpu.git
synced 2025-12-22 17:36:20 +03:00
8c84f8836a
Change NV license for nvsched sources and Makefile.doxygen to MIT
license as those can be distributed with other linux sources but
they are also used in qnx.
Bug 3871403
Change-Id: Iefc957b4afdf4c3c2ff19df144caac9790490114
Signed-off-by: Sagar Kamble <skamble@nvidia.com>
Reviewed-on: https://git-master.nvidia.com/r/c/linux-nvgpu/+/2814847
(cherry picked from commit 406e5392b7)
Reviewed-on: https://git-master.nvidia.com/r/c/linux-nvgpu/+/2818121
Reviewed-by: svc-mobile-coverity <svc-mobile-coverity@nvidia.com>
Reviewed-by: svcacv <svcacv@nvidia.com>
Reviewed-by: svc-mobile-cert <svc-mobile-cert@nvidia.com>
Reviewed-by: svc-mobile-misra <svc-mobile-misra@nvidia.com>
Reviewed-by: Ankur Kishore <ankkishore@nvidia.com>
GVS: Gerrit_Virtual_Submit <buildbot_gerritrpt@nvidia.com>
85 lines
2.6 KiB
C
85 lines
2.6 KiB
C
/*
|
|
* Copyright (c) 2021-2022, NVIDIA CORPORATION. All rights reserved.
|
|
*
|
|
* Permission is hereby granted, free of charge, to any person obtaining a
|
|
* copy of this software and associated documentation files (the "Software"),
|
|
* to deal in the Software without restriction, including without limitation
|
|
* the rights to use, copy, modify, merge, publish, distribute, sublicense,
|
|
* and/or sell copies of the Software, and to permit persons to whom the
|
|
* Software is furnished to do so, subject to the following conditions:
|
|
*
|
|
* The above copyright notice and this permission notice shall be included in
|
|
* all copies or substantial portions of the Software.
|
|
*
|
|
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
|
|
* THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
|
|
* FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
|
|
* DEALINGS IN THE SOFTWARE.
|
|
*/
|
|
|
|
#ifndef NVS_LOG_H
|
|
#define NVS_LOG_H
|
|
|
|
#include <nvs/types-internal.h>
|
|
|
|
/*
|
|
* Default log size; 64K entries at 8 bytes each is 512Kb of space. For a space
|
|
* constrained system this is obviously a lot. It can be overridden.
|
|
*/
|
|
#ifndef NVS_LOG_ENTRIES
|
|
#define NVS_LOG_ENTRIES (64 * 1024)
|
|
#endif
|
|
|
|
/*
|
|
* Fast and efficient logging, even on microcontrollers, is an absolute
|
|
* must for nvsched. The logging provided here is binary encoded to take up
|
|
* a small amount of space and reduce time spent writing the logs.
|
|
*
|
|
* An implementation of nvsched should decode the logs later, when not in
|
|
* a time critical path. The event type can be decoded with nvs_log_event_string().
|
|
*/
|
|
enum nvs_event {
|
|
NVS_EV_NO_EVENT,
|
|
NVS_EV_CREATE_SCHED,
|
|
NVS_EV_CREATE_DOMAIN,
|
|
NVS_EV_REMOVE_DOMAIN,
|
|
NVS_EV_CTRL_QUEUE,
|
|
NVS_EV_MAX = 0xffffffff /* Force to 32 bit enum size. */
|
|
};
|
|
|
|
struct nvs_sched;
|
|
|
|
/**
|
|
* @brief A single log event used to track event type, timestamp, etc. Note this
|
|
* is 8 byte aligned.
|
|
*/
|
|
struct nvs_log_event {
|
|
s64 timestamp;
|
|
u32 data;
|
|
enum nvs_event event;
|
|
};
|
|
|
|
/**
|
|
* Simple circular buffer for putting and getting events.
|
|
*/
|
|
struct nvs_log_buffer {
|
|
struct nvs_log_event *events;
|
|
u32 entries;
|
|
|
|
u32 get;
|
|
u32 put;
|
|
|
|
s64 ts_offset;
|
|
};
|
|
|
|
int nvs_log_init(struct nvs_sched *sched);
|
|
void nvs_log_destroy(struct nvs_sched *sched);
|
|
void nvs_log_event(struct nvs_sched *sched, enum nvs_event event, u32 data);
|
|
void nvs_log_get(struct nvs_sched *sched, struct nvs_log_event *ev);
|
|
const char *nvs_log_event_string(enum nvs_event ev);
|
|
|
|
#endif
|