forked from torvalds/linux
-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Merge branch 'master' of master.kernel.org:/pub/scm/linux/kernel/git/…
…davem/net-2.6 Conflicts: drivers/net/smc911x.c
- Loading branch information
Showing
533 changed files
with
6,125 additions
and
3,204 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
|
@@ -327,6 +327,52 @@ Some people also put extra tags at the end. They'll just be ignored for | |
now, but you can do this to mark internal company procedures or just | ||
point out some special detail about the sign-off. | ||
|
||
If you are a subsystem or branch maintainer, sometimes you need to slightly | ||
modify patches you receive in order to merge them, because the code is not | ||
exactly the same in your tree and the submitters'. If you stick strictly to | ||
rule (c), you should ask the submitter to rediff, but this is a totally | ||
counter-productive waste of time and energy. Rule (b) allows you to adjust | ||
the code, but then it is very impolite to change one submitter's code and | ||
make him endorse your bugs. To solve this problem, it is recommended that | ||
you add a line between the last Signed-off-by header and yours, indicating | ||
the nature of your changes. While there is nothing mandatory about this, it | ||
seems like prepending the description with your mail and/or name, all | ||
enclosed in square brackets, is noticeable enough to make it obvious that | ||
you are responsible for last-minute changes. Example : | ||
|
||
Signed-off-by: Random J Developer <[email protected]> | ||
[[email protected]: struct foo moved from foo.c to foo.h] | ||
Signed-off-by: Lucky K Maintainer <[email protected]> | ||
|
||
This practise is particularly helpful if you maintain a stable branch and | ||
want at the same time to credit the author, track changes, merge the fix, | ||
and protect the submitter from complaints. Note that under no circumstances | ||
can you change the author's identity (the From header), as it is the one | ||
which appears in the changelog. | ||
|
||
Special note to back-porters: It seems to be a common and useful practise | ||
to insert an indication of the origin of a patch at the top of the commit | ||
message (just after the subject line) to facilitate tracking. For instance, | ||
here's what we see in 2.6-stable : | ||
|
||
Date: Tue May 13 19:10:30 2008 +0000 | ||
|
||
SCSI: libiscsi regression in 2.6.25: fix nop timer handling | ||
|
||
commit 4cf1043593db6a337f10e006c23c69e5fc93e722 upstream | ||
|
||
And here's what appears in 2.4 : | ||
|
||
Date: Tue May 13 22:12:27 2008 +0200 | ||
|
||
wireless, airo: waitbusy() won't delay | ||
|
||
[backport of 2.6 commit b7acbdfbd1f277c1eb23f344f899cfa4cd0bf36a] | ||
|
||
Whatever the format, this information provides a valuable help to people | ||
tracking your trees, and to people trying to trouble-shoot bugs in your | ||
tree. | ||
|
||
|
||
13) When to use Acked-by: and Cc: | ||
|
||
|
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,77 @@ | ||
pagemap, from the userspace perspective | ||
--------------------------------------- | ||
|
||
pagemap is a new (as of 2.6.25) set of interfaces in the kernel that allow | ||
userspace programs to examine the page tables and related information by | ||
reading files in /proc. | ||
|
||
There are three components to pagemap: | ||
|
||
* /proc/pid/pagemap. This file lets a userspace process find out which | ||
physical frame each virtual page is mapped to. It contains one 64-bit | ||
value for each virtual page, containing the following data (from | ||
fs/proc/task_mmu.c, above pagemap_read): | ||
|
||
* Bits 0-55 page frame number (PFN) if present | ||
* Bits 0-4 swap type if swapped | ||
* Bits 5-55 swap offset if swapped | ||
* Bits 55-60 page shift (page size = 1<<page shift) | ||
* Bit 61 reserved for future use | ||
* Bit 62 page swapped | ||
* Bit 63 page present | ||
|
||
If the page is not present but in swap, then the PFN contains an | ||
encoding of the swap file number and the page's offset into the | ||
swap. Unmapped pages return a null PFN. This allows determining | ||
precisely which pages are mapped (or in swap) and comparing mapped | ||
pages between processes. | ||
|
||
Efficient users of this interface will use /proc/pid/maps to | ||
determine which areas of memory are actually mapped and llseek to | ||
skip over unmapped regions. | ||
|
||
* /proc/kpagecount. This file contains a 64-bit count of the number of | ||
times each page is mapped, indexed by PFN. | ||
|
||
* /proc/kpageflags. This file contains a 64-bit set of flags for each | ||
page, indexed by PFN. | ||
|
||
The flags are (from fs/proc/proc_misc, above kpageflags_read): | ||
|
||
0. LOCKED | ||
1. ERROR | ||
2. REFERENCED | ||
3. UPTODATE | ||
4. DIRTY | ||
5. LRU | ||
6. ACTIVE | ||
7. SLAB | ||
8. WRITEBACK | ||
9. RECLAIM | ||
10. BUDDY | ||
|
||
Using pagemap to do something useful: | ||
|
||
The general procedure for using pagemap to find out about a process' memory | ||
usage goes like this: | ||
|
||
1. Read /proc/pid/maps to determine which parts of the memory space are | ||
mapped to what. | ||
2. Select the maps you are interested in -- all of them, or a particular | ||
library, or the stack or the heap, etc. | ||
3. Open /proc/pid/pagemap and seek to the pages you would like to examine. | ||
4. Read a u64 for each page from pagemap. | ||
5. Open /proc/kpagecount and/or /proc/kpageflags. For each PFN you just | ||
read, seek to that entry in the file, and read the data you want. | ||
|
||
For example, to find the "unique set size" (USS), which is the amount of | ||
memory that a process is using that is not shared with any other process, | ||
you can go through every map in the process, find the PFNs, look those up | ||
in kpagecount, and tally up the number of pages that are only referenced | ||
once. | ||
|
||
Other notes: | ||
|
||
Reading from any of the files will return -EINVAL if you are not starting | ||
the read on an 8-byte boundary (e.g., if you seeked an odd number of bytes | ||
into the file), or if the size of the read is not a multiple of 8 bytes. |
Oops, something went wrong.