| /linux-6.12.1/Documentation/arch/arm64/ |
| D | booting.rst | 50 The device tree blob (dtb) must be placed on an 8-byte boundary and must
52 using blocks of up to 2 megabytes in size, it must not be placed within
53 any 2M region which must be mapped with any specific attributes.
103 little-endian and must be respected. Where image_size is zero,
135 The Image must be placed text_offset bytes from a 2MB aligned base
139 At least image_size bytes from the start of the image must be free for
145 If an initrd/initramfs is passed to the kernel at boot, it must reside
154 Before jumping into the kernel, the following conditions must be met:
169 All forms of interrupts must be masked in PSTATE.DAIF (Debug, SError,
171 The CPU must be in non-secure state, either in EL2 (RECOMMENDED in order
[all …]
|
| /linux-6.12.1/Documentation/devicetree/bindings/clock/ |
| D | pistachio-clock.txt | 24 - compatible: Must be "img,pistachio-clk".
25 - reg: Must contain the base address and length of the core clock controller.
26 - #clock-cells: Must be 1. The single cell is the clock identifier.
28 - clocks: Must contain an entry for each clock in clock-names.
29 - clock-names: Must include "xtal" (see "External clocks") and
52 - compatible: Must be "img,pistachio-periph-clk".
53 - reg: Must contain the base address and length of the peripheral clock
55 - #clock-cells: Must be 1. The single cell is the clock identifier.
57 - clocks: Must contain an entry for each clock in clock-names.
58 - clock-names: Must include "periph_sys", the peripheral system clock generated
[all …]
|
| D | st,nomadik.txt | 10 - compatible: must be "stericsson,nomadik-src"
11 - reg: must contain the SRC register base and size
28 - compatible: must be "st,nomadik-pll-clock"
29 - clock-cells: must be 0
30 - clock-id: must be 1 or 2 for PLL1 and PLL2 respectively
39 - compatible: must be "st,nomadik-hclk-clock"
40 - clock-cells: must be 0
41 - clock-id: must be the clock ID from 0 to 63 according to
|
| /linux-6.12.1/Documentation/devicetree/bindings/pci/ |
| D | ralink,rt3883-pci.txt | 7 - compatible: must be "ralink,rt3883-pci"
13 address. The value must be 1.
16 of an address. The value must be 1.
24 Value must be either "disabled" or "okay".
28 The main node must have two child nodes which describes the built-in
38 address. The value must be 0. As such, 'interrupt-map' nodes do not
42 interrupt source. The value must be 1.
53 address. The value must be 0.
56 of an address. The value must be 2.
59 interrupt source. The value must be 1.
[all …]
|
| D | nvidia,tegra20-pcie.txt | 4 - compatible: Must be:
10 - power-domains: To ungate power partition by BPMP powergate driver. Must
13 - device_type: Must be "pci"
15 registers. Must contain an entry for each entry in the reg-names property.
16 - reg-names: Must include the following entries:
20 - interrupts: A list of interrupt outputs of the controller. Must contain an
22 - interrupt-names: Must include the following entries:
26 - #address-cells: Address representation for root ports (must be 3)
33 - #size-cells: Size representation for root ports (must be 2)
35 PCI regions. The entries must be 6 cells each, where the first three cells
[all …]
|
| /linux-6.12.1/Documentation/devicetree/bindings/spi/ |
| D | spi-img-spfi.txt | 4 - compatible: Must be "img,spfi".
5 - reg: Must contain the base address and length of the SPFI registers.
6 - interrupts: Must contain the SPFI interrupt.
7 - clocks: Must contain an entry for each entry in clock-names.
9 - clock-names: Must include the following entries:
12 - dmas: Must contain an entry for each entry in dma-names.
14 - dma-names: Must include the following entries:
17 - cs-gpios: Must specify the GPIOs used for chipselect lines.
18 - #address-cells: Must be 1.
19 - #size-cells: Must be 0.
|
| /linux-6.12.1/include/net/ |
| D | nsh.h | 21 * going forward with future NSH specification updates. It MUST be set
25 * document reserves version 01b and this value MUST NOT be used in
34 * The O bit MUST be set for OAM packets and MUST NOT be set for non-OAM
35 * packets. The O bit MUST NOT be modified along the SFP.
45 * prior to enabling this behavior. The configurable parameter MUST be
52 * provided, the default initial TTL value of 63 MUST be used. Each SFF
53 * involved in forwarding an NSH packet MUST decrement the TTL value by
55 * value of 0 shall result in a TTL value of 63. The packet MUST NOT be
59 * future use, see Section 11.2.1. Unassigned bits MUST be set to zero
60 * upon origination, and MUST be ignored and preserved unmodified by
[all …]
|
| /linux-6.12.1/Documentation/arch/arm/ |
| D | booting.rst | 74 The boot loader must ultimately be able to provide a MACH_TYPE_xxx
90 The boot loader must provide either a tagged list or a dtb image for
97 The boot loader must create and initialise the kernel tagged list.
100 has the size field set to '2' (0x00000002). The ATAG_NONE must set
108 The boot loader must pass at a minimum the size and location of
122 The tagged list must be placed in a region of memory where neither
129 The boot loader must load a device tree image (dtb) into system ram
136 The boot loader must pass at a minimum the size and location of the
137 system memory, and the root filesystem location. The dtb must be
152 If an initramfs is in use then, as with the dtb, it must be placed in
[all …]
|
| /linux-6.12.1/Documentation/devicetree/bindings/dma/ |
| D | adi,axi-dmac.txt | 4 - compatible: Must be "adi,axi-dmac-1.00.a".
8 - #dma-cells: Must be 1.
11 - adi,channels: This sub-node must contain a sub-node for each DMA channel. For
12 the channel sub-nodes the following bindings apply. They must match the
16 - #size-cells: Must be 0
17 - #address-cells: Must be 1
24 adi,destination-bus-type: Type of the source or destination bus. Must be one
32 - adi,cyclic: Must be set if the channel supports hardware cyclic DMA
34 - adi,2d: Must be set if the channel supports hardware 2D DMA transfers.
36 DMA clients connected to the AXI-DMAC DMA controller must use the format
|
| D | img-mdc-dma.txt | 4 - compatible: Must be "img,pistachio-mdc-dma".
5 - reg: Must contain the base address and length of the MDC registers.
6 - interrupts: Must contain all the per-channel DMA interrupts.
7 - clocks: Must contain an entry for each entry in clock-names.
9 - clock-names: Must include the following entries:
11 - img,cr-periph: Must contain a phandle to the peripheral control syscon
13 - img,max-burst-multiplier: Must be the maximum supported burst size multiplier.
16 - #dma-cells: Must be 3:
|
| /linux-6.12.1/Documentation/virt/kvm/ |
| D | review-checklist.rst | 7 1. The patch must follow Documentation/process/coding-style.rst and
13 - the API must be documented in Documentation/virt/kvm/api.rst
14 - the API must be discoverable using KVM_CHECK_EXTENSION
16 4. New state must include support for save/restore.
18 5. New features must default to off (userspace should explicitly request them).
32 10. User/kernel interfaces and guest/host interfaces must be 64-bit clean
36 11. New guest visible features must either be documented in a hardware manual
39 12. Features must be robust against reset and kexec - for example, shared
40 host/guest memory must be unshared to prevent the host from writing to
|
| /linux-6.12.1/include/uapi/drm/ |
| D | pvr_drm.h | 22 * - All members must be type-aligned.
23 * - The overall struct must be padded to 64-bit alignment.
27 * are never used for alignment. Padding fields must be zeroed; this is
32 * "implicit padding" and must be zeroed. This is always checked.
83 * @_mode: Must be one of %DRM_IOR, %DRM_IOW or %DRM_IOWR.
86 * The struct referred to by @_data must have a ``drm_pvr_ioctl_`` prefix and an
120 * When fetching this type &struct drm_pvr_ioctl_dev_query_args.type must be set
143 /** @_padding_c: Reserved. This field must be zeroed. */
151 * When fetching this type &struct drm_pvr_ioctl_dev_query_args.type must be set
198 * When fetching this type &struct drm_pvr_ioctl_dev_query_args.type must be set
[all …]
|
| /linux-6.12.1/include/uapi/linux/ |
| D | if_hippi.h | 82 __u8 ulp; /* must contain 4 */
84 __u8 d1_data_present:1; /* must be 1 */
85 __u8 start_d2_burst_boundary:1; /* must be zero */
86 __u8 reserved:6; /* must be zero */
89 __u16 d1_area_size:8; /* must be 3 */
90 __u16 d2_offset:3; /* must be zero */
93 __u8 reserved:6; /* must be zero */
94 __u8 start_d2_burst_boundary:1; /* must be zero */
95 __u8 d1_data_present:1; /* must be 1 */
97 __u16 d2_offset:3; /* must be zero */
[all …]
|
| /linux-6.12.1/Documentation/devicetree/bindings/sound/ |
| D | nvidia,tegra30-ahub.txt | 4 - compatible : For Tegra30, must contain "nvidia,tegra30-ahub". For Tegra114,
5 must contain "nvidia,tegra114-ahub". For Tegra124, must contain
6 "nvidia,tegra124-ahub". Otherwise, must contain "nvidia,<chip>-ahub",
13 - clocks : Must contain an entry for each entry in clock-names.
15 - clock-names : Must include the following entries:
18 - resets : Must contain an entry for each entry in reset-names.
20 - reset-names : Must include the following entries:
47 - dmas : Must contain an entry for each entry in clock-names.
49 - dma-names : Must include the following entries:
|
| /linux-6.12.1/Documentation/userspace-api/media/v4l/ |
| D | dev-stateless-decoder.rst | 25 decoder must expose the ``V4L2_BUF_CAP_SUPPORTS_REQUESTS`` capability on its
31 with multiple slices per frame). Decoders that support such formats must also
41 * The driver must always return the full set of supported ``OUTPUT`` formats,
44 * Simultaneously, the driver must restrain the set of values returned by
51 * The driver must return only the formats supported for the format currently
94 it must adjust it afterwards.
166 After performing this step, the client must perform step 3 again in order
190 requested count. The client must check this value after the ioctl returns
217 * The driver must adjust count to the minimum of required number of
219 requested count. The client must check this value after the ioctl
[all …]
|
| /linux-6.12.1/Documentation/netlabel/ |
| D | draft-ietf-cipso-ipsecurity-01.txt | 87 This option MUST be copied on fragmentation. This option appears at most
111 restriction of 40 octets the value of this field MUST not exceed 40.
116 This field is an unsigned 32 bit integer. The value 0 is reserved and MUST
164 that support a tag type greater than 127 MUST support at least one DOI that
350 value. The categories MUST be listed in ascending order within the tag.
415 assumed to be 0. The ranges MUST be non-overlapping and be listed in
422 A CIPSO implementation MUST be capable of generating at least tag type 1 in
423 the non-optimized form. In addition, a CIPSO implementation MUST be able
440 An implementation of CIPSO on a host MUST have the capability to reject a
444 MUST be able to reject datagrams going to networks that can not provide
[all …]
|
| /linux-6.12.1/Documentation/crypto/ |
| D | userspace-if.rst | 60 To interact with the kernel crypto API, a socket must be created by the
81 kernel, the file descriptor returned by accept must be used.
103 filled struct sockaddr data structure. This data structure must be
133 In order to set a message digest key, the calling application must use
142 initialization, the struct sockaddr data structure must be filled as
155 family, the consumer must set the key. The key setting is described with
183 must make sure that all data matches the constraints given in
187 cipher operation from the kernel crypto API. The output buffer must be
196 initialization, the struct sockaddr data structure must be filled as
209 family, the consumer must set the key. The key setting is described with
[all …]
|
| /linux-6.12.1/include/linux/ |
| D | zlib.h | 13 1. The origin of this software must not be misrepresented; you must not
17 2. Altered source versions must be plainly marked as such, and must not be
62 application must provide more input and/or consume the output
106 The application must update next_in and avail_in when avail_in has
107 dropped to zero. It must update next_out and avail_out when avail_out
108 has dropped to zero. The application must initialize zalloc, zfree and
110 compression library and must not be updated by the application.
117 zalloc must return NULL if there is not enough memory for the object.
118 If zlib is used in a multi-threaded application, zalloc and zfree must be
121 On 16-bit systems, the functions zalloc and zfree must be able to allocate
[all …]
|
| /linux-6.12.1/Documentation/devicetree/bindings/mips/img/ |
| D | pistachio.txt | 6 - compatible: Must include "img,pistachio".
11 - #address-cells: Must be 1.
12 - #size-cells: Must be 0.
16 - device_type: Must be "cpu".
17 - compatible: Must be "mti,interaptiv".
19 - clocks: Must include the CPU clock. See ../../clock/clock-bindings.txt for
37 In accordance with the MIPS UHI specification[1], the bootloader must pass the
|
| /linux-6.12.1/Documentation/devicetree/bindings/memory-controllers/ |
| D | arm,pl172.txt | 5 - compatible: Must be "arm,primecell" and exactly one from
8 - reg: Must contains offset/length value for controller.
10 - #address-cells: Must be 2. The partition number has to be encoded in the
15 - #size-cells: Must be set to 1.
17 - ranges: Must contain one or more chip select memory regions.
19 - clocks: Must contain references to controller clocks.
21 - clock-names: Must contain "mpmcclk" and "apb_pclk".
33 - #address-cells: Must be 2.
35 - #size-cells: Must be 1.
47 - mpmc,memory-width: Width of the chip select memory. Must be equal to
|
| /linux-6.12.1/Documentation/hid/ |
| D | hid-transport.rst | 73 must unregister the device from HID core and HID core will stop using the
80 transmission behavior regarding acknowledgements. An asynchronous channel must
82 verifications. Generally, HID calls operating on asynchronous channels must be
88 required on asynchronous channels, a transport-driver must implement that via
92 driver must provide two bi-directional I/O channels to each HID device. These
93 channels must not necessarily be bi-directional in the hardware itself. A
101 channel. Any unrequested incoming or outgoing data report must be sent on
106 device management. Unrequested data input events must not be sent on this
131 Feature reports are never sent without requests. A host must explicitly set
141 Plain reports must not be sent on the ctrl channel, though. Instead, the ctrl
[all …]
|
| /linux-6.12.1/Documentation/arch/sparc/oradax/ |
| D | oracle-dax.rst | 43 interrupt is generated upon completion; the completion area must be
70 request can be fed to the coprocessor, all the addresses in a CCB must
92 opened it, and must be used by that thread for all subsequent
117 request, the driver must be told when it may reclaim resources. No
125 executing once this call returns successfully. On success, read() must
134 CCB_KILL must be invoked on that CCB. Upon success, read() must be
150 and read() must be called to retrieve further status information. The
159 user process, and the mmap call must not specify PROT_WRITE.
203 or output, must reside in a physically contiguous region of memory.
214 page size must be used, or the transaction size will be truncated to
[all …]
|
| /linux-6.12.1/Documentation/core-api/ |
| D | dma-api.rst | 19 To get the dma_API, you must #include <linux/dma-mapping.h>. This
68 size and dma_handle must all be the same as those passed into
69 dma_alloc_coherent(). cpu_addr must be the virtual address returned by
79 To get this part of the dma_API, you must #include <linux/dmapool.h>
96 for use with a given device. It must be called in a context which
102 in bytes, and must be a power of two). If your device has no boundary
104 from this pool must not cross 4KByte boundaries.
145 dma_pool_destroy() frees the resources of the pool. It must be
270 Further, the DMA address of the memory must be within the
291 correctly, the mapped region must begin exactly on a cache line
[all …]
|
| /linux-6.12.1/Documentation/arch/powerpc/ |
| D | pmu-ebb.rst | 66 EBB events must be created with a particular, and restrictive, set of
70 An EBB event must be created with the "pinned" and "exclusive" attributes set.
74 An EBB event must NOT set any of the "inherit", "sample_period", "freq" or
77 An EBB event must be attached to a task. This is specified to perf_event_open()
80 All events in a group must agree on whether they want EBB. That is all events
81 must request EBB, or none may request EBB.
83 EBB events must specify the PMC they are to be counted on. This ensures
90 Once an EBB event has been successfully opened, it must be enabled with the
96 has been scheduled on the PMU, you must perform a read() on the event. If the
125 The EBB handler is just regular userspace code, however it must be written in
[all …]
|
| /linux-6.12.1/Documentation/filesystems/ |
| D | files.rst | 39 1. All references to the fdtable must be done through
55 The fdtable pointer must be read within the read-side
58 2. Reading of the fdtable as described above must be protected
61 3. For any update to the fd table, files->file_lock must
65 must use either lookup_fdget_rcu() or files_lookup_fdget_rcu() APIs. These
82 lock-free, they must be installed using rcu_assign_pointer()
84 must be used. However it is advisable to use files_fdtable()
88 6. While updating, the fdtable pointer must be looked up while
106 the fdtable pointer (fdt) must be loaded after locate_fd().
122 either first acquire a reference or they must hold the files_lock of the
|