| /Documentation/process/ |
| D | 6.Followthrough.rst | 7 addition of your own engineering skills, have posted a perfect series of
17 kernel community to ensure that your code is up to the kernel's quality
19 prevent the inclusion of your patches into the mainline.
31 - If you have explained your patch well, reviewers will understand its
48 agendas at the expense of your own. Kernel developers often expect to
56 making. Do not let their form of expression or your own pride keep that
63 reviewers. If you believe that the reviewer has misunderstood your code,
65 suggested change, describe it and justify your solution to the problem. If
66 your explanations make sense, the reviewer will accept them. Should your
69 be easy to become blinded by your own solution to a problem to the point
[all …]
|
| D | maintainer-pgp-guide.rst | 66 Your distro should already have GnuPG installed by default, you just
92 You can put that in your ``.bashrc`` to make sure it's always the case.
111 edit your ``~/.gnupg/gpg-agent.conf`` file to set your own values::
120 beginning of your shell session. You may want to check your rc files
127 You will need to regularly refresh your keyring in order to get the
133 Check the full path to your ``gpg`` or ``gpg2`` command and use the
138 Protect your master PGP key
146 You should also make a new key if your current one is weaker than 2048 bits
169 lose your private subkey, it cannot be recreated from the master key
186 If you used the default parameters when generating your key, then that
[all …]
|
| D | botching-up-ioctls.rst | 46 conversion or worse, fiddle the raw __u64 through your code since that
60 * Have a clear way for userspace to figure out whether your new ioctl or ioctl
73 and reject the ioctl if that's not the case. Otherwise your nice plan for
99 * Have simple testcases for every input validation failure case in your ioctl.
100 Check that the error code matches your expectations. And finally make sure
106 * Make all your ioctls restartable. First X really loves signals and second
108 interrupting your main test suite constantly with signals. Thanks to X's
109 love for signal you'll get an excellent base coverage of all your error
117 killable. GPUs just die and your users won't like you more if you hang their
122 * Have testcases for the really tricky corner cases in your error recovery code
[all …]
|
| D | submitting-patches.rst | 3 Submitting patches: the essential guide to getting your code into the kernel
9 can greatly increase the chances of your change being accepted.
18 This documentation assumes that you're using ``git`` to prepare your patches.
20 use it, it will make your life as a kernel developer and in general much
40 Describe your changes
43 Describe your problem. Whether your patch is a one-line bug fix or
55 from upstream, so include anything that could help route your change
64 different workloads. Describe the expected downsides of your
72 The maintainer will thank you if you write your patch description in a
76 Solve only one problem per patch. If your description starts to get
[all …]
|
| D | stable-api-nonsense.rst | 6 (all of your questions answered and then some)
30 you get that only if your driver is in the main kernel tree. You also
31 get lots of other good benefits if your driver is in the main kernel
84 Now a number of these issues can be addressed by simply compiling your
95 multiple versions of your module.
172 Simple, get your kernel driver into the main kernel tree (remember we are
173 talking about drivers released under a GPL-compatible license here, if your
174 code doesn't fall under this category, good luck, you are on your own here,
175 you leech). If your driver is in the tree, and a kernel interface changes,
177 place. This ensures that your driver is always buildable, and works over
[all …]
|
| D | howto.rst | 21 have been told by your manager, "Go write a Linux driver for this
55 documented; do not expect people to adapt to you or your company's way
215 will learn the basics of getting your patch into the Linux kernel tree,
361 One of the best ways to put into practice your hacking skills is by fixing
364 improve your skills, and other developers will be aware of your presence.
406 If multiple people respond to your mail, the CC: list of recipients may
412 Remember to keep the context and the attribution of your replies intact,
413 keep the "John Kernelhacker wrote ...:" lines at the top of your reply, and
414 add your statements between the individual quoted sections instead of
417 If you add patches to your mail, make sure they are plain readable text
[all …]
|
| D | submitting-drivers.rst | 34 If you don't use assigned numbers then when your device is submitted it will
66 licenses other than the GPL, you should include your
67 rationale for your license choices in your cover letter.
79 If your driver uses existing interfaces and behaves like
97 shouldn't use inline x86 assembler in your driver without
110 Since Linux is used on many portable and desktop systems, your
115 that your driver correctly handles the suspend and resume, but
118 implemented") error. You should also try to make sure that your
131 and include an entry in MAINTAINERS for your driver.
140 vendor' to get your driver chosen. Ideally work with the
[all …]
|
| D | email-clients.rst | 13 If you are new to ``git`` then send your first patch to yourself. Save it
28 It's also strongly recommended that you use plain text in your email body,
30 for information on how to configure your preferred email client, as well as
40 Don't let your email client do automatic word wrapping for you.
41 This can also corrupt your patch.
45 If you configure your email client to send emails with UTF-8 encoding,
132 way around this is to compose your email with word wrap enabled, then save
133 it as a draft. Once you pull it up again from your drafts it is now hard
137 At the bottom of your email, put the commonly-used patch delimiter before
138 inserting your patch: three hyphens (``---``).
[all …]
|
| /Documentation/hwmon/ |
| D | submitting-patches.rst | 1 How to Get Your Patch Accepted Into the Hwmon Subsystem
6 increase the chances of your change being accepted.
19 * Please run your patch through 'checkpatch --strict'. There should be no
27 * If your patch generates checkpatch errors, warnings, or check messages,
33 * Please test your patch thoroughly. We are not your test group.
39 * If your patch (or the driver) is affected by configuration options such as
52 your patch into a cleanup part and the actual addition. This makes it easier
53 to review your changes, and to bisect any resulting problems.
61 * Running your patch or driver file(s) through checkpatch does not mean its
62 formatting is clean. If unsure about formatting in your new driver, run it
[all …]
|
| /Documentation/power/ |
| D | swsusp-dmcrypt.rst | 16 Now your system is properly set up, your disk is encrypted except for
19 an initrd that does your current crypto setup already.
21 At this point you want to encrypt your swap, too. Still you want to
32 within your running system. The easiest way to achieve this is
38 Now set up your kernel to use /dev/mapper/swap0 as the default
39 resume partition, so your kernel .config contains::
43 Prepare your boot loader to use the initrd you will create or
52 Finally you need to create or modify your initrd. Lets assume
57 named "swapkey". /etc/fstab of your initrd contains something
65 of your crypto devices, again by reading the setup from the
[all …]
|
| /Documentation/driver-api/ |
| D | uio-howto.rst | 62 If you use UIO for your card's driver, here's what you get:
66 - develop the main part of your driver in user space, with all the
69 - bugs in your driver won't crash the kernel.
71 - updates of your driver can take place without recompiling the kernel.
82 :c:func:`mmap()` to access registers or RAM locations of your card.
112 To handle interrupts properly, your custom kernel module can provide its
130 - ``name``: The name of your device. It is recommended to use the name
131 of your kernel module for this.
133 - ``version``: A version string defined by your driver. This allows the
134 user space part of your driver to deal with different versions of the
[all …]
|
| /Documentation/admin-guide/ |
| D | reporting-bugs.rst | 18 contact your Linux distribution or embedded vendor for support.
31 Identifying which part of the Linux kernel might be causing your issue
32 increases your chances of getting your bug fixed. Simply posting to the
33 generic linux-kernel mailing list (LKML) may cause your bug report to be
38 maintainer doesn't answer, then expand your scope to mailing lists like
50 To find out where to send an emailed bug report, find your subsystem or
52 entries, and send your bug report to the person(s) listed in the "M:"
96 a netconsole trace, or type the message from your screen into the bug
97 report. Please read "Documentation/admin-guide/bug-hunting.rst" before posting your
105 relevant to your bug, feel free to exclude it.
[all …]
|
| D | kernel-per-CPU-kthreads.rst | 113 3. Once your application has started, prevent CPU-hotplug operations
116 bring it back online before you start your application.)
125 3. Once your application has started, prevent CPU-hotplug operations
128 bring it back online before you start your application.)
137 3. Once your application has started, prevent CPU-hotplug operations
140 bring it back online before you start your application.)
230 1. Run your workload at a real-time priority, which will allow
243 3. Do any of the following needed to avoid jitter that your
246 a. Build your kernel with CONFIG_SLUB=y rather than
252 c. Limit your CPU frequency so that a CPU-frequency
[all …]
|
| D | spkguide.txt | 29 capabilities, depending on how your system administrator has installed
42 If your system administrator has installed Speakup to work with your
44 is to boot your system, and Speakup should come up talking. This
45 assumes of course that your synthesizer is a supported hardware
46 synthesizer, and that it is either installed in or connected to your
50 kernel with no default synthesizer. It is even possible that your
53 your synthesizer is supported but not available, complain to the person
54 who compiled and installed your kernel. Or better yet, go to the web
55 site, and learn how to patch Speakup into your own kernel source, and
56 build and install your own kernel.
[all …]
|
| D | README.rst | 57 your kernel.
63 directory where you have permissions (e.g. your home directory) and
82 Replace "x" for all versions bigger than the version "x" of your current
90 directly to the base 5.x kernel. For example, if your base kernel is 5.0
154 as expected. If you want to carry your existing configuration to a
171 your existing ./.config file and asking about
188 platforms of your architecture.
243 nonexistent controller card may confuse your other controllers.
268 kernel makefiles, but you may want to check your particular lilo setup first.
293 are installing a new kernel with the same version number as your
[all …]
|
| /Documentation/s390/ |
| D | 3270.rst | 22 VM-ESA operating system, define a 3270 to your virtual machine by using
31 Your network connection from VM-ESA allows you to use x3270, tn3270, or
32 another 3270 emulator, started from an xterm window on your PC or
34 and this Linux-390 3270 driver, you have another way of talking to your
50 you should rerun the configuration script every time your set of 3270s,
63 3270 console support, then the driver automatically converts your console
97 login prompts appear on your 3270s as soon as boot is complete (or
98 with emulated 3270s, as soon as you dial into your vm guest using the
104 3. Define graphic devices to your vm guest machine, if you
115 you have chosen 3270 console support, your console now behaves
[all …]
|
| /Documentation/maintainer/ |
| D | modifying-patches.rst | 8 exactly the same in your tree and the submitters'. If you stick strictly to
12 one submitters code and make him endorse your bugs. To solve this problem, it
14 yours, indicating the nature of your changes. While there is nothing mandatory
15 about this, it seems like prepending the description with your mail and/or
49 tracking your trees, and to people trying to troubleshoot bugs in your
|
| /Documentation/networking/device_drivers/cable/ |
| D | sb1000.rst | 10 It's a one-way downstream-only cable modem, meaning that your upstream net link
11 is provided by your regular phone modem.
26 2. Several PPP scripts which live in /etc/ppp to make connecting via your
41 3. The standard isapnp tools. These are necessary to configure your SB1000
44 If you don't have these installed as a standard part of your Linux
49 or check your Linux distribution binary CD or their web site. For help with
60 you prefer, in the top kernel tree directory to set up your kernel
67 by isapnp to access your PnP cards. This is the value of READPORT in
72 4. Boot your new kernel following the usual procedures.
76 IRQ, and DMA settings for all your PnP cards. Make sure none of the settings
[all …]
|
| /Documentation/scsi/ |
| D | libsas.rst | 35 After initializing your hardware, from the probe() function
36 you call sas_register_ha(). It will register your LLDD with
38 register your SAS driver with the sysfs SAS tree it creates.
39 It will then return. Then you enable your phys to actually
40 start OOB (at which point your driver will start calling the
49 Normally this is statically embedded to your driver's
58 And then all the phys are an array of my_phy in your HA
61 Then as you go along and initialize your phys you also
62 initialize the sas_phy struct, along with your own
89 address of the phy, possibly somewhere in your my_phy
[all …]
|
| D | NinjaSCSI.rst | 27 (a) Check your PC card is true "NinjaSCSI-3" card.
29 If you installed pcmcia-cs already, pcmcia reports your card as UNKNOWN
31 your console or log file.
52 kernel source, I recommend rebuilding your kernel; this eliminates
136 If you eject card when doing some operation for your SCSI device or suspend
137 your computer, you encount some *BAD* error like disk crash.
140 your data. Please backup your data when you use this driver.
156 - your SCSI device name(hard drive, CD-ROM, etc...)
|
| /Documentation/x86/i386/ |
| D | IO-APIC.rst | 20 usually worked around by the kernel. If your MP-compliant SMP board does
23 If your box boots fine with enabled IO-APIC IRQs, then your
43 In the unlikely case that your board does not create a working mp-table,
50 The actual numbers depend on your system, on your PCI cards and on their
86 so if you have your SCSI card (IRQ11) in Slot1, Tulip card (IRQ9) in
92 your PCI configuration::
96 note that this script won't work if you have skipped a few slots or if your
98 connected in some strange way). E.g. if in the above case you have your SCSI
|
| /Documentation/networking/ |
| D | driver.rst | 11 there is no way your device can tell ahead of time when it's
45 And then at the end of your TX reclamation event handling::
69 3) Do not forget that once you return NETDEV_TX_OK from your
70 ndo_start_xmit method, it is your driver's responsibility to free
73 For example, this means that it is not allowed for your TX
85 1) Any hardware layer address you obtain for your device should
|
| /Documentation/driver-api/thermal/ |
| D | nouveau_thermal.rst | 20 interface is likely not to work. This document may then not cover your situation
38 Shut the computer down to protect your GPU.
42 on your chipset.
73 Speed in RPM of your fan.
75 Your fan can be driven in different modes:
87 depending on your hardware.
|
| /Documentation/admin-guide/laptops/ |
| D | sony-laptop.rst | 30 If your laptop model supports it, you will find sysfs files in the
67 by your particular laptop model.
115 your ACPI BIOS could have on your laptop), load the driver and
121 In your kernel logs you will find the list of all ACPI methods
122 the SNC device has on your laptop.
145 You can create other entries corresponding to your own laptop methods by
147 entry to this table with your get/set method names using the
150 Your mission, should you accept it, is to try finding out what
152 files and find out what is the impact on your laptop.
155 I will not disavow all knowledge of your actions :)
[all …]
|
| /Documentation/usb/ |
| D | iuu_phoenix.rst | 8 This module provide a serial interface to use your
11 used by your favorite application to pilot the IUU
14 occur and your system may freeze. As far I now,
16 guru, so don't blame me if your system is unstable
70 - xmas is completely useless except for your eyes. This is one of my friend who was
87 work for your software, disable detection mechanism in it.
|