xref: /linux/include/uapi/linux/mmc/ioctl.h (revision 44f57d78)
1 /* SPDX-License-Identifier: GPL-2.0 WITH Linux-syscall-note */
2 #ifndef LINUX_MMC_IOCTL_H
3 #define LINUX_MMC_IOCTL_H
4 
5 #include <linux/types.h>
6 
7 struct mmc_ioc_cmd {
8 	/*
9 	 * Direction of data: nonzero = write, zero = read.
10 	 * Bit 31 selects 'Reliable Write' for RPMB.
11 	 */
12 	int write_flag;
13 
14 	/* Application-specific command.  true = precede with CMD55 */
15 	int is_acmd;
16 
17 	__u32 opcode;
18 	__u32 arg;
19 	__u32 response[4];  /* CMD response */
20 	unsigned int flags;
21 	unsigned int blksz;
22 	unsigned int blocks;
23 
24 	/*
25 	 * Sleep at least postsleep_min_us useconds, and at most
26 	 * postsleep_max_us useconds *after* issuing command.  Needed for
27 	 * some read commands for which cards have no other way of indicating
28 	 * they're ready for the next command (i.e. there is no equivalent of
29 	 * a "busy" indicator for read operations).
30 	 */
31 	unsigned int postsleep_min_us;
32 	unsigned int postsleep_max_us;
33 
34 	/*
35 	 * Override driver-computed timeouts.  Note the difference in units!
36 	 */
37 	unsigned int data_timeout_ns;
38 	unsigned int cmd_timeout_ms;
39 
40 	/*
41 	 * For 64-bit machines, the next member, ``__u64 data_ptr``, wants to
42 	 * be 8-byte aligned.  Make sure this struct is the same size when
43 	 * built for 32-bit.
44 	 */
45 	__u32 __pad;
46 
47 	/* DAT buffer */
48 	__u64 data_ptr;
49 };
50 #define mmc_ioc_cmd_set_data(ic, ptr) ic.data_ptr = (__u64)(unsigned long) ptr
51 
52 /**
53  * struct mmc_ioc_multi_cmd - multi command information
54  * @num_of_cmds: Number of commands to send. Must be equal to or less than
55  *	MMC_IOC_MAX_CMDS.
56  * @cmds: Array of commands with length equal to 'num_of_cmds'
57  */
58 struct mmc_ioc_multi_cmd {
59 	__u64 num_of_cmds;
60 	struct mmc_ioc_cmd cmds[0];
61 };
62 
63 #define MMC_IOC_CMD _IOWR(MMC_BLOCK_MAJOR, 0, struct mmc_ioc_cmd)
64 /*
65  * MMC_IOC_MULTI_CMD: Used to send an array of MMC commands described by
66  *	the structure mmc_ioc_multi_cmd. The MMC driver will issue all
67  *	commands in array in sequence to card.
68  */
69 #define MMC_IOC_MULTI_CMD _IOWR(MMC_BLOCK_MAJOR, 1, struct mmc_ioc_multi_cmd)
70 /*
71  * Since this ioctl is only meant to enhance (and not replace) normal access
72  * to the mmc bus device, an upper data transfer limit of MMC_IOC_MAX_BYTES
73  * is enforced per ioctl call.  For larger data transfers, use the normal
74  * block device operations.
75  */
76 #define MMC_IOC_MAX_BYTES  (512L * 1024)
77 #define MMC_IOC_MAX_CMDS    255
78 #endif /* LINUX_MMC_IOCTL_H */
79