/linux/Documentation/arch/arm64/ |
H A D | booting.rst | 53 The device tree blob (dtb) must be placed on an 8-byte boundary and must 55 using blocks of up to 2 megabytes in size, it must not be placed within 56 any 2M region which must be mapped with any specific attributes. 106 little-endian and must be respected. Where image_size is zero, 138 The Image must be placed text_offset bytes from a 2MB aligned base 142 At least image_size bytes from the start of the image must be free for 148 If an initrd/initramfs is passed to the kernel at boot, it must reside 157 Before jumping into the kernel, the following conditions must be met: 172 All forms of interrupts must b [all...] |
/linux/Documentation/devicetree/bindings/pci/ |
H A 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 b [all...] |
H A 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 b [all...] |
/linux/Documentation/devicetree/bindings/spi/ |
H A 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 b [all...] |
/linux/include/net/ |
H A 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 b [all...] |
/linux/Documentation/arch/arm/ |
H A 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 b [all...] |
/linux/include/uapi/drm/ |
H A 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 b [all...] |
/linux/Documentation/networking/ |
H A D | netmem.rst | 25 1. The driver must support page_pool. 27 2. The driver must support the tcp-data-split ethtool option. 29 3. The driver must use the page_pool netmem APIs for payload memory. The netmem 43 4. The driver must use the following PP_FLAGS: 46 must delegate the dma mapping to the page_pool, which knows when 49 by the driver. The driver must delegate the dma syncing to the page_pool, 51 - PP_FLAG_ALLOW_UNREADABLE_NETMEM. The driver must specify this flag iff 54 5. The driver must not assume the netmem is readable and/or backed by pages. 56 netmem_address() will return NULL. The driver must correctly handle 66 6. The driver must us [all...] |
/linux/include/uapi/linux/ |
H A 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 b [all...] |
/linux/Documentation/gpu/nova/ |
H A D | guidelines.rst | 21 - Unless technically necessary, unsafe Rust code must be avoided. In case of 50 - uAPIs must be fully documented with kernel-doc comments; additionally, the 51 semantical behavior must be explained including potential special or corner 55 must be fully documented. This includes doc comments, potential locking and 58 - Abbreviations must be explained when introduced; terminology must be uniquely 61 - Register addresses, layouts, shift values and masks must be defined properly; 62 unless obvious, the semantical sense must be documented. This only applies if 68 - Patches must only be applied if reviewed by at least one other person on the
|
/linux/Documentation/devicetree/bindings/sound/ |
H A 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 includ [all...] |
/linux/Documentation/userspace-api/media/v4l/ |
H A 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 chec [all...] |
/linux/Documentation/devicetree/bindings/dma/ |
H A 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/Documentation/devicetree/bindings/mips/img/ |
H A 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/Documentation/netlabel/ |
H A 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 b [all...] |
/linux/Documentation/crypto/ |
H A 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 se [all...] |
/linux/Documentation/devicetree/bindings/clock/ |
H A 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/include/linux/ |
H A 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 retur [all...] |
H A D | blk-crypto-profile.h | 18 * interface must be implemented by storage drivers that support inline 35 * Must return 0 on success, or -errno on failure. 44 * If the device has keyslots, this function must evict the key from the 49 * If the device doesn't have keyslots itself, this function must evict 55 * Must return 0 on success, or -errno on failure. 68 * Must return 0 on success, -EBADMSG if the key is invalid, or another 81 * On success, must write the new key in long-term wrapped form to 82 * @lt_key and return its size in bytes. On failure, must return a 95 * On success, must write the new key in long-term wrapped form to 96 * @lt_key and return its size in bytes. On failure, must retur [all...] |
/linux/Documentation/hid/ |
H A 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 no [all...] |
/linux/Documentation/filesystems/iomap/ |
H A D | design.rst | 120 Processes wishing to insert folios must hold this lock in shared 122 Processes wishing to remove folios must hold this lock in exclusive 131 internal to the filesystem and must protect the file mapping data 133 The filesystem author must determine how this coordination should 145 This implies that the filesystem must have already allocated space 146 on disk as ``IOMAP_MAPPED`` and the filesystem must not place any 177 These fields must always be set by the filesystem. 182 This type must never be returned in response to an ``IOMAP_WRITE`` 183 operation because writes must allocate and map space, and return 185 The ``addr`` field must b [all...] |
/linux/Documentation/devicetree/bindings/usb/ |
H A D | nvidia,tegra20-ehci.txt | 9 - compatible : For Tegra20, must contain "nvidia,tegra20-ehci". 10 For Tegra30, must contain "nvidia,tegra30-ehci". Otherwise, must contain 14 - clocks : Must contain one entry, for the module clock. 16 - resets : Must contain an entry for each entry in reset-names. 18 - reset-names : Must include the following entries:
|
/linux/Documentation/arch/sparc/oradax/ |
H A 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 resid [all...] |
/linux/Documentation/infiniband/ |
H A D | core_locking.rst | 26 which may not sleep and must be callable from any context. 52 driver must be fully reentrant. The low-level driver is required to 69 A low-level driver must not perform a callback directly from the 78 simultaneously. The driver must guarantee that only one CQ event 103 must be complete before this call. The device must remain usable 106 A low-level driver must call ib_register_device() and 107 ib_unregister_device() from process context. It must not hold any 113 device. A consumer must finish all cleanup and free all resources
|
/linux/Documentation/arch/powerpc/ |
H A 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 b [all...] |