sync_file.h

/* SPDX-License-Identifier: GPL-1.0+ WITH Linux-syscall-note */
/*
 * Copyright (C) 2012 Google, Inc.
 *
 * This program is distributed in the hope that 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_SYNC_H
#define _UAPI_LINUX_SYNC_H

#include <linux/ioctl.h>
#include <linux/types.h>

/**
 * struct sync_merge_data - SYNC_IOC_MERGE: merge two fences
 * @name:	name of new fence
 * @fd2:	file descriptor of second fence
 * @fence:	returns the fd of the new fence to userspace
 * @flags:	merge_data flags
 * @pad:	padding for 64-bit alignment, should always be zero
 *
 * Creates a new fence containing copies of the sync_pts in both
 * the calling fd and sync_merge_data.fd2.  Returns the new fence's
 * fd in sync_merge_data.fence
 */
struct sync_merge_data {
	char	name[32];
	__s32	fd2;
	__s32	fence;
	__u32	flags;
	__u32	pad;
};

/**
 * struct sync_fence_info - detailed fence information
 * @obj_name:		name of parent sync_timeline
 * @driver_name:	name of driver implementing the parent
 * @status:		status of the fence 0:active 1:signaled <0:error
 * @flags:		fence_info flags
 * @timestamp_ns:	timestamp of status change in nanoseconds
 */
struct sync_fence_info {
	char	obj_name[32];
	char	driver_name[32];
	__s32	status;
	__u32	flags;
	__u64	timestamp_ns;
};

/**
 * struct sync_file_info - SYNC_IOC_FILE_INFO: get detailed information on a sync_file
 * @name:	name of fence
 * @status:	status of fence. 1: signaled 0:active <0:error
 * @flags:	sync_file_info flags
 * @num_fences:	number of fences in the sync_file
 * @pad:	padding for 64-bit alignment, should always be zero
 * @sync_fence_info: pointer to array of struct &sync_fence_info with all
 *		 fences in the sync_file
 *
 * Takes a struct sync_file_info. If num_fences is 0, the field is updated
 * with the actual number of fences. If num_fences is > 0, the system will
 * use the pointer provided on sync_fence_info to return up to num_fences of
 * struct sync_fence_info, with detailed fence information.
 */
struct sync_file_info {
	char	name[32];
	__s32	status;
	__u32	flags;
	__u32	num_fences;
	__u32	pad;

__u64	sync_fence_info;
};

/**
 * struct sync_set_deadline - SYNC_IOC_SET_DEADLINE - set a deadline hint on a fence
 * @deadline_ns: absolute time of the deadline
 * @pad:	must be zero
 *
 * Allows userspace to set a deadline on a fence, see &dma_fence_set_deadline
 *
 * The timebase for the deadline is CLOCK_MONOTONIC (same as vblank).  For
 * example
 *
 *     clock_gettime(CLOCK_MONOTONIC, &t);
 *     deadline_ns = (t.tv_sec * 1000000000L) + t.tv_nsec + ns_until_deadline
 */
struct sync_set_deadline {
	__u64	deadline_ns;
	/* Not strictly needed for alignment but gives some possibility
	 * for future extension:
	 */
	__u64	pad;
};

#define SYNC_IOC_MAGIC		'>'

/*
 * Opcodes  0, 1 and 2 were burned during a API change to avoid users of the
 * old API to get weird errors when trying to handling sync_files. The API
 * change happened during the de-stage of the Sync Framework when there was
 * no upstream users available.
 */

#define SYNC_IOC_MERGE		_IOWR(SYNC_IOC_MAGIC, 3, struct sync_merge_data)
#define SYNC_IOC_FILE_INFO	_IOWR(SYNC_IOC_MAGIC, 4, struct sync_file_info)
#define SYNC_IOC_SET_DEADLINE	_IOW(SYNC_IOC_MAGIC, 5, struct sync_set_deadline)

#endif /* _UAPI_LINUX_SYNC_H */

docroot: /var/www/469ed2f6-4d4b-4a8a-9f5e-ee4ef04d3bc8/public_html

curdir: /usr/src/linux-headers-6.8.0-117/include/uapi/linux

	.	28672
	..	4096
X	a.out.h	6959
X	acct.h	4095
X	acrn.h	18971
X	adb.h	1155
X	adfs_fs.h	1008
X	affs_hardblocks.h	1578
X	agpgart.h	4016
X	aio_abi.h	3398
X	am437x-vpfe.h	3681
X	amt.h	1762
	android	4096
X	apm_bios.h	3698
X	apparmor.h	3492
X	arcfb.h	213
X	arm_sdei.h	2766
X	aspeed-lpc-ctrl.h	1795
X	aspeed-p2a-ctrl.h	1921
X	aspeed-video.h	404
X	atalk.h	1038
X	atm.h	7937
X	atm_eni.h	648
X	atm_he.h	406
X	atm_idt77105.h	955
X	atm_nicstar.h	1278
X	atm_tcp.h	1637
X	atm_zatm.h	1540
X	atmapi.h	952
X	atmarp.h	1296
X	atmbr2684.h	3272
X	atmclip.h	576
X	atmdev.h	7520
X	atmioc.h	1647
X	atmlec.h	2381
X	atmmpc.h	4226
X	atmppp.h	639
X	atmsap.h	4970
X	atmsvc.h	1853
X	audit.h	21726
X	auto_dev-ioctl.h	4996
X	auto_fs.h	6450
X	auto_fs4.h	466
X	auxvec.h	1736
X	ax25.h	2824
X	batadv_packet.h	21647
X	batman_adv.h	16902
X	baycom.h	883
X	bcm933xx_hcs.h	419
X	bfs_fs.h	1905
X	binfmts.h	791
X	blkpg.h	953
X	blktrace_api.h	4716
X	blkzoned.h	6507
X	bpf.h	275657
X	bpf_common.h	1382
X	bpf_perf_event.h	544
X	bpqether.h	981
X	bsg.h	2509
X	bt-bmc.h	587
X	btf.h	5606
X	btrfs.h	37212
X	btrfs_tree.h	35611
	byteorder	4096
X	cachefiles.h	1650
	caif	4096
	can	4096
X	can.h	11220
X	capability.h	13578
X	capi.h	3157
X	cciss_defs.h	3281
X	cciss_ioctl.h	2790
X	ccs.h	767
X	cdrom.h	29611
X	cec-funcs.h	53811
X	cec.h	42073
X	cfm_bridge.h	1466
X	cgroupstats.h	2105
X	chio.h	5304
	cifs	4096
X	close_range.h	392
X	cn_proc.h	4171
X	coda.h	18393
X	coff.h	12564
X	comedi.h	55530
X	connector.h	2267
X	const.h	1006
X	coresight-stm.h	747
X	counter.h	4904
X	cramfs_fs.h	3570
X	cryptouser.h	5336
X	cuda.h	920
X	cxl_mem.h	8007
X	cyclades.h	984
X	cycx_cfm.h	2989
X	dcbnl.h	25571
X	dccp.h	6447
X	devlink.h	22721
X	dlm.h	2596
X	dlm_device.h	2597
X	dlm_plock.h	931
X	dlmconstants.h	5091
X	dm-ioctl.h	11598
X	dm-log-userspace.h	15190
X	dma-buf.h	7322
X	dma-heap.h	1409
X	dns_resolver.h	3904
X	dpll.h	5995
X	dqblk_xfs.h	9388
	dvb	4096
X	dw100.h	357
X	edd.h	5619
X	efs_fs_sb.h	2227
X	elf-em.h	2627
X	elf-fdpic.h	1636
X	elf.h	15511
X	errno.h	23
X	errqueue.h	2066
X	erspan.h	1074
X	ethtool.h	88826
X	ethtool_netlink.h	27032
X	eventfd.h	279
X	eventpoll.h	2737
X	ext4.h	4137
X	f2fs.h	3378
X	fadvise.h	842
X	falloc.h	3658
X	fanotify.h	8385
X	fb.h	16517
X	fcntl.h	4627
X	fd.h	12166
X	fdreg.h	5364
X	fib_rules.h	2036
X	fiemap.h	2789
X	filter.h	2265
X	firewire-cdev.h	50720
X	firewire-constants.h	3231
X	fou.h	834
X	fpga-dfl.h	8743
X	fs.h	14389
X	fscrypt.h	6651
X	fsi.h	3103
X	fsl_hypervisor.h	7316
X	fsl_mc.h	749
X	fsmap.h	4394
X	fsverity.h	3293
X	fuse.h	27742
X	futex.h	6183
X	gameport.h	912
X	gen_stats.h	1526
X	genetlink.h	2253
	genwqe	4096
X	gfs2_ondisk.h	14769
X	gpio.h	19937
X	gsmmux.h	4509
X	gtp.h	749
X	handshake.h	1661
X	hash_info.h	1049
	hdlc	4096
X	hdlc.h	652
X	hdlcdrv.h	2923
X	hdreg.h	22945
X	hid.h	2101
X	hiddev.h	6360
X	hidraw.h	2058
X	hpet.h	785
	hsi	4096
X	hsr_netlink.h	1101
X	hw_breakpoint.h	620
X	hyperv.h	11167
X	i2c-dev.h	1931
X	i2c.h	6905
X	i2o-dev.h	11646
X	i8k.h	1528
X	icmp.h	4800
X	icmpv6.h	4284
X	idxd.h	9372
X	if.h	11015
X	if_addr.h	2169
X	if_addrlabel.h	721
X	if_alg.h	1601
X	if_arcnet.h	3714
X	if_arp.h	6604
X	if_bonding.h	5145
X	if_bridge.h	20681
X	if_cablemodem.h	986
X	if_eql.h	1364
X	if_ether.h	8781
X	if_fc.h	1738
X	if_fddi.h	4384
X	if_hippi.h	4235
X	if_infiniband.h	1245
X	if_link.h	55866
X	if_ltalk.h	225
X	if_macsec.h	6518
X	if_packet.h	8268
X	if_phonet.h	439
X	if_plip.h	660
X	if_ppp.h	29
X	if_pppol2tp.h	3318
X	if_pppox.h	4802
X	if_slip.h	872
X	if_team.h	2615
X	if_tun.h	4330
X	if_tunnel.h	4925
X	if_vlan.h	1846
X	if_x25.h	881
X	if_xdp.h	5010
X	ife.h	351
X	igmp.h	3076
	iio	4096
X	ila.h	1261
X	in.h	10879
X	in6.h	7593
X	in_route.h	936
X	inet_diag.h	5031
X	inotify.h	3306
X	input-event-codes.h	30268
X	input.h	16265
X	io_uring.h	19716
X	ioam6.h	2398
X	ioam6_genl.h	960
X	ioam6_iptunnel.h	1297
X	ioctl.h	163
X	iommu.h	4919
X	iommufd.h	25856
X	ioprio.h	4190
X	ip.h	4861
X	ip6_tunnel.h	1953
X	ip_vs.h	14133
X	ipc.h	2123
X	ipmi.h	15505
X	ipmi_bmc.h	503
X	ipmi_msgdefs.h	3430
X	ipmi_ssif_bmc.h	456
X	ipsec.h	947
X	ipv6.h	4340
X	ipv6_route.h	1923
X	irqnr.h	104
	isdn	4096
X	iso_fs.h	6483
X	isst_if.h	15281
X	ivtv.h	3063
X	ivtvfb.h	1241
X	jffs2.h	6811
X	joystick.h	3449
X	kcm.h	822
X	kcmp.h	537
X	kcov.h	1958
X	kd.h	6515
X	kdev_t.h	441
X	kernel-page-flags.h	915
X	kernel.h	209
X	kernelcapi.h	1034
X	kexec.h	2108
X	keyboard.h	13474
X	keyctl.h	6010
X	kfd_ioctl.h	53995
X	kfd_sysfs.h	5134
X	kvm.h	63736
X	kvm_para.h	1016
X	l2tp.h	5761
X	landlock.h	9429
X	libc-compat.h	8304
X	limits.h	947
X	lirc.h	8327
X	llc.h	3179
X	loadpin.h	849
X	loop.h	3411
X	lp.h	4205
X	lsm.h	2574
X	lwtunnel.h	2382
X	magic.h	3860
X	major.h	4657
X	map_to_14segment.h	9505
X	map_to_7segment.h	6608
X	matroxfb.h	1464
X	max2175.h	1035
X	mctp.h	1488
X	mdio.h	24120
X	media-bus-format.h	7323
X	media.h	13246
X	mei.h	3474
X	mei_uuid.h	753
X	membarrier.h	9581
X	memfd.h	1482
X	mempolicy.h	2583
X	mii.h	9511
X	minix_fs.h	2120
	misc	4096
X	mman.h	1802
	mmc	4096
X	mmtimer.h	2117
X	module.h	308
X	mount.h	7953
X	mpls.h	2317
X	mpls_iptunnel.h	776
X	mptcp.h	3903
X	mptcp_pm.h	4605
X	mqueue.h	2201
X	mroute.h	5937
X	mroute6.h	5020
X	mrp_bridge.h	1718
X	msdos_fs.h	6746
X	msg.h	3401
X	mtio.h	8175
X	nbd-netlink.h	2423
X	nbd.h	3631
X	ncsi.h	4828
X	ndctl.h	6651
X	neighbour.h	6102
X	net.h	2100
X	net_dropmon.h	2920
X	net_namespace.h	730
X	net_tstamp.h	6115
X	netconf.h	629
X	netdev.h	4342
X	netdevice.h	2268
	netfilter	4096
X	netfilter.h	1861
	netfilter_arp	4096
X	netfilter_arp.h	471
	netfilter_bridge	4096
X	netfilter_bridge.h	1209
	netfilter_ipv4	4096
X	netfilter_ipv4.h	1548
	netfilter_ipv6	4096
X	netfilter_ipv6.h	1443
X	netlink.h	12459
X	netlink_diag.h	1550
X	netrom.h	807
X	nexthop.h	2835
X	nfc.h	11236
X	nfs.h	4481
X	nfs2.h	1468
X	nfs3.h	2468
X	nfs4.h	6556
X	nfs4_mount.h	1953
X	nfs_fs.h	1669
X	nfs_idmap.h	2258
X	nfs_mount.h	2142
X	nfsacl.h	733
	nfsd	4096
X	nfsd_netlink.h	948
X	nilfs2_api.h	7565
X	nilfs2_ondisk.h	18053
X	nitro_enclaves.h	13176
X	nl80211-vnd-intel.h	4602
X	nl80211.h	343002
X	npcm-video.h	1230
X	nsfs.h	639
X	nsm.h	740
X	nubus.h	8206
X	nvme_ioctl.h	2505
X	nvram.h	547
X	omap3isp.h	21423
X	omapfb.h	5940
X	oom.h	526
X	openat2.h	1465
X	openvswitch.h	42018
X	packet_diag.h	1672
X	param.h	141
X	parport.h	3856
X	patchkey.h	965
X	pci.h	1395
X	pci_regs.h	61883
X	pcitest.h	920
X	perf_event.h	43313
X	personality.h	2112
X	pfkeyv2.h	10636
X	pfrut.h	8003
X	pg.h	2409
X	phantom.h	1654
X	phonet.h	4640
X	pidfd.h	271
X	pkt_cls.h	18583
X	pkt_sched.h	29346
X	pktcdvd.h	2418
X	pmu.h	5459
X	poll.h	22
X	posix_acl.h	1254
X	posix_acl_xattr.h	1115
X	posix_types.h	1098
X	ppdev.h	3300
X	ppp-comp.h	2542
X	ppp-ioctl.h	5763
X	ppp_defs.h	5572
X	pps.h	4734
X	pr.h	1645
X	prctl.h	10671
X	psample.h	2271
X	psci.h	5156
X	psp-dbc.h	5234
X	psp-sev.h	4388
X	ptp_clock.h	7644
X	ptrace.h	5516
X	qemu_fw_cfg.h	2469
X	qnx4_fs.h	2328
X	qnxtypes.h	624
X	qrtr.h	878
X	quota.h	6327
X	radeonfb.h	360
	raid	4096
X	random.h	1429
X	rds.h	11168
X	reboot.h	1358
X	reiserfs_fs.h	775
X	reiserfs_xattr.h	542
X	remoteproc_cdev.h	1112
X	resource.h	2610
X	rfkill.h	6118
X	rio_cm_cdev.h	3248
X	rio_mport_cdev.h	9330
X	rkisp1-config.h	34211
X	romfs_fs.h	1236
X	rose.h	2232
X	route.h	2392
X	rpl.h	864
X	rpl_iptunnel.h	434
X	rpmsg.h	1327
X	rpmsg_types.h	303
X	rseq.h	5463
X	rtc.h	5331
X	rtnetlink.h	21387
X	rxrpc.h	4937
X	scc.h	4639
	sched	4096
X	sched.h	6281
X	scif_ioctl.h	6382
X	screen_info.h	2494
X	sctp.h	36122
X	seccomp.h	6032
X	securebits.h	2719
X	sed-opal.h	5358
X	seg6.h	1179
X	seg6_genl.h	599
X	seg6_hmac.h	433
X	seg6_iptunnel.h	993
X	seg6_local.h	3877
X	selinux_netlink.h	1221
X	sem.h	3094
X	serial.h	5260
X	serial_core.h	5061
X	serial_reg.h	16023
X	serio.h	2114
X	sev-guest.h	2364
X	shm.h	3835
X	signal.h	403
X	signalfd.h	1248
X	smc.h	8678
X	smc_diag.h	2966
X	smiapp.h	1058
X	snmp.h	14533
X	sock_diag.h	1316
X	socket.h	1055
X	sockios.h	6846
X	sonet.h	2305
X	sonypi.h	5324
X	sound.h	1252
X	soundcard.h	46180
	spi	4096
X	stat.h	7047
X	stddef.h	2034
X	stm.h	1289
X	string.h	296
	sunrpc	4096
	surface_aggregator	4096
X	suspend_ioctls.h	1431
X	swab.h	7010
X	switchtec_ioctl.h	5272
X	sync_file.h	3464
X	synclink.h	9000
X	sysctl.h	26103
X	sysinfo.h	1049
X	target_core_user.h	4576
X	taskstats.h	8322
	tc_act	4096
	tc_ematch	4096
X	tcp.h	17034
X	tcp_metrics.h	1549
X	tdx-guest.h	1320
X	tee.h	13412
X	termios.h	172
X	thermal.h	3325
X	thp7312.h	659
X	time.h	1793
X	time_types.h	1282
X	timerfd.h	951
X	times.h	278
X	timex.h	7884
X	tiocl.h	1729
X	tipc.h	8805
X	tipc_config.h	14863
X	tipc_netlink.h	9395
X	tipc_sockets_diag.h	483
X	tls.h	7241
X	toshiba.h	1945
X	tps6594_pfsm.h	1160
X	tty.h	1800
X	tty_flags.h	4553
X	types.h	2035
X	ublk_cmd.h	11957
X	udf_fs_i.h	697
X	udmabuf.h	658
X	udp.h	1703
X	uhid.h	4655
X	uinput.h	9276
X	uio.h	781
X	uleds.h	813
X	ultrasound.h	4562
X	um_timetravel.h	3976
X	un.h	384
X	unistd.h	220
X	unix_diag.h	1328
	usb	4096
X	usbdevice_fs.h	8372
X	usbip.h	1518
X	user_events.h	2361
X	userfaultfd.h	12002
X	userio.h	1516
X	utime.h	223
X	utsname.h	684
X	uuid.h	28
X	uvcvideo.h	2626
X	v4l2-common.h	2082
X	v4l2-controls.h	149416
X	v4l2-dv-timings.h	31123
X	v4l2-mediabus.h	5271
X	v4l2-subdev.h	10005
X	vbox_err.h	7257
X	vbox_vmmdev_types.h	11591
X	vboxguest.h	9368
X	vdpa.h	1795
X	vduse.h	9823
X	veth.h	224
X	vfio.h	71884
X	vfio_ccw.h	1257
X	vfio_zdev.h	2542
X	vhost.h	11007
X	vhost_types.h	5294
X	videodev2.h	102413
X	virtio_9p.h	2052
X	virtio_balloon.h	5279
X	virtio_blk.h	10005
X	virtio_bt.h	925
X	virtio_config.h	4821
X	virtio_console.h	3171
X	virtio_crypto.h	16472
X	virtio_fs.h	588
X	virtio_gpio.h	1714
X	virtio_gpu.h	11454
X	virtio_i2c.h	1201
X	virtio_ids.h	4303
X	virtio_input.h	2515
X	virtio_iommu.h	3941
X	virtio_mem.h	7157
X	virtio_mmio.h	4969
X	virtio_net.h	15452
X	virtio_pci.h	9631
X	virtio_pcidev.h	2462
X	virtio_pmem.h	892
X	virtio_ring.h	8753
X	virtio_rng.h	265
X	virtio_scmi.h	652
X	virtio_scsi.h	6085
X	virtio_snd.h	9304
X	virtio_types.h	2168
X	virtio_vsock.h	3363
X	vm_sockets.h	7501
X	vm_sockets_diag.h	978
X	vmcore.h	470
X	vsockmon.h	1895
X	vt.h	3074
X	vtpm_proxy.h	1734
X	wait.h	697
X	watch_queue.h	3505
X	watchdog.h	2350
X	wireguard.h	7748
X	wireless.h	42803
X	wmi.h	1718
X	wwan.h	310
X	x25.h	3562
X	xattr.h	3038
X	xdp_diag.h	1468
X	xfrm.h	12740
X	xilinx-v4l2-controls.h	2976
X	zorro.h	3266
X	zorro_ids.h	30065