mirror of
git://nv-tegra.nvidia.com/linux-nvgpu.git
synced 2025-12-22 09:12:24 +03:00
3a64fdefc4
Create device nodes for user-created scheduling domains. This helps leverage filesystem based access control: domains can be chosen to be available for a limited set of users on a system. The device nodes are dynamic: they can be removed while the driver is running normally. This is a bit different from the nodes that exist until the driver is unloaded, so the devno/domain mapping is stored in a separate list. The usual container_of pattern would suffer from an unavoidable race condition if a domain file was opened while the same domain would get removed. As usual, domain refcounting prevents a domain from being removed. Now the open device files hold refs and thus any open domain files prevent a domain from getting removed, in addition to the userspace-invisible ref that is taken when a TSG is bound to a domain. While at it, make the query ioctl guarded by the sched domain mutex, as domains might technically get added or removed during the querying code. Jira NVGPU-6788 Change-Id: Ief2a09a442c4e70f1f2be8a32359341071d74659 Signed-off-by: Konsta Hölttä <kholtta@nvidia.com> Reviewed-on: https://git-master.nvidia.com/r/c/linux-nvgpu/+/2651164 Reviewed-by: Alex Waterman <alexw@nvidia.com> GVS: Gerrit_Virtual_Submit
159 lines
4.2 KiB
C
159 lines
4.2 KiB
C
/*
|
|
* Copyright (c) 2021-2022, NVIDIA CORPORATION. All rights reserved.
|
|
*
|
|
* This program is free software; you can redistribute it and/or modify it
|
|
* under the terms and conditions of the GNU General Public License,
|
|
* version 2, as published by the Free Software Foundation.
|
|
*
|
|
* This program is distributed in the hope it will be useful, but WITHOUT
|
|
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
|
|
* FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
|
|
* more details.
|
|
*/
|
|
|
|
#ifndef _UAPI__LINUX_NVGPU_NVS_H
|
|
#define _UAPI__LINUX_NVGPU_NVS_H
|
|
|
|
#include "nvgpu-uapi-common.h"
|
|
|
|
#define NVGPU_NVS_IOCTL_MAGIC 'N'
|
|
|
|
/**
|
|
* Domain parameters to pass to the kernel.
|
|
*/
|
|
struct nvgpu_nvs_ioctl_domain {
|
|
/*
|
|
* Human readable null-terminated name for this domain.
|
|
*/
|
|
char name[32];
|
|
|
|
/*
|
|
* Scheduling parameters: specify how long this domain should be scheduled
|
|
* for and what the grace period the scheduler should give this domain when
|
|
* preempting. A value of zero is treated as an infinite timeslice or an
|
|
* infinite grace period, respectively.
|
|
*/
|
|
__u64 timeslice_ns;
|
|
__u64 preempt_grace_ns;
|
|
|
|
/*
|
|
* Pick which subscheduler to use. These will be implemented by the kernel
|
|
* as needed. There'll always be at least one, which is the host HW built in
|
|
* round-robin scheduler.
|
|
*/
|
|
__u32 subscheduler;
|
|
|
|
/*
|
|
* GPU host hardware round-robin.
|
|
*/
|
|
#define NVGPU_SCHED_IOCTL_SUBSCHEDULER_HOST_HW_RR 0x0
|
|
|
|
/*
|
|
* Populated by the IOCTL when created: unique identifier. User space
|
|
* must set this to 0.
|
|
*/
|
|
__u64 dom_id;
|
|
|
|
/* Must be 0. */
|
|
__u64 reserved1;
|
|
/* Must be 0. */
|
|
__u64 reserved2;
|
|
};
|
|
|
|
/**
|
|
* NVGPU_NVS_IOCTL_CREATE_DOMAIN
|
|
*
|
|
* Create a domain - essentially a group of GPU contexts. Applications
|
|
* can be bound into this domain on request for each TSG.
|
|
*
|
|
* The domain ID is returned in dom_id; this id is _not_ secure. The
|
|
* nvsched device needs to have restricted permissions such that only a
|
|
* single user, or group of users, has permissions to modify the
|
|
* scheduler.
|
|
*
|
|
* It's fine to allow read-only access to the device node for other
|
|
* users; this lets other users query scheduling information that may be
|
|
* of interest to them.
|
|
*/
|
|
struct nvgpu_nvs_ioctl_create_domain {
|
|
/*
|
|
* In/out: domain parameters that userspace configures.
|
|
*
|
|
* The domain ID is returned here.
|
|
*/
|
|
struct nvgpu_nvs_ioctl_domain domain_params;
|
|
|
|
/* Must be 0. */
|
|
__u64 reserved1;
|
|
};
|
|
|
|
/**
|
|
* NVGPU_NVS_IOCTL_REMOVE_DOMAIN
|
|
*
|
|
* Remove a domain that has been previously created.
|
|
*
|
|
* The domain must be empty; it must have no TSGs bound to it. The domain's
|
|
* device node must not be open by anyone.
|
|
*/
|
|
struct nvgpu_nvs_ioctl_remove_domain {
|
|
/*
|
|
* In: a domain_id to remove.
|
|
*/
|
|
__u64 dom_id;
|
|
|
|
/* Must be 0. */
|
|
__u64 reserved1;
|
|
};
|
|
|
|
/**
|
|
* NVGPU_NVS_IOCTL_QUERY_DOMAINS
|
|
*
|
|
* Query the current list of domains in the scheduler. This is a two
|
|
* part IOCTL.
|
|
*
|
|
* If domains is 0, then this IOCTL will populate nr with the number
|
|
* of present domains.
|
|
*
|
|
* If domains is nonzero, then this IOCTL will treat domains as a pointer to an
|
|
* array of nvgpu_nvs_ioctl_domain and will write up to nr domains into that
|
|
* array. The nr field will be updated with the number of present domains,
|
|
* which may be more than the number of entries written.
|
|
*/
|
|
struct nvgpu_nvs_ioctl_query_domains {
|
|
/*
|
|
* In/Out: If 0, leave untouched. If nonzero, then write up to nr
|
|
* elements of nvgpu_nvs_ioctl_domain into where domains points to.
|
|
*/
|
|
__u64 domains;
|
|
|
|
/*
|
|
* - In: the capacity of the domains array if domais is not 0.
|
|
* - Out: populate with the number of domains present.
|
|
*/
|
|
__u32 nr;
|
|
|
|
/* Must be 0. */
|
|
__u32 reserved0;
|
|
|
|
/* Must be 0. */
|
|
__u64 reserved1;
|
|
};
|
|
|
|
#define NVGPU_NVS_IOCTL_CREATE_DOMAIN \
|
|
_IOWR(NVGPU_NVS_IOCTL_MAGIC, 1, \
|
|
struct nvgpu_nvs_ioctl_create_domain)
|
|
#define NVGPU_NVS_IOCTL_REMOVE_DOMAIN \
|
|
_IOW(NVGPU_NVS_IOCTL_MAGIC, 2, \
|
|
struct nvgpu_nvs_ioctl_remove_domain)
|
|
#define NVGPU_NVS_IOCTL_QUERY_DOMAINS \
|
|
_IOWR(NVGPU_NVS_IOCTL_MAGIC, 3, \
|
|
struct nvgpu_nvs_ioctl_query_domains)
|
|
|
|
|
|
#define NVGPU_NVS_IOCTL_LAST \
|
|
_IOC_NR(NVGPU_NVS_IOCTL_QUERY_DOMAINS)
|
|
#define NVGPU_NVS_IOCTL_MAX_ARG_SIZE \
|
|
sizeof(struct nvgpu_nvs_ioctl_create_domain)
|
|
|
|
#endif
|