You've already forked linux-apfs
mirror of
https://github.com/linux-apfs/linux-apfs.git
synced 2026-05-01 15:00:59 -07:00
Documentation/: it's -> its where appropriate
Fix obvious cases of "it's" being used when "its" was meant. Signed-off-by: Francis Galiegue <fgaliegue@gmail.com> Acked-by: Randy Dunlap <rdunlap@xenotime.net> Signed-off-by: Jiri Kosina <jkosina@suse.cz>
This commit is contained in:
committed by
Jiri Kosina
parent
6c9468e9eb
commit
a33f32244d
@@ -43,7 +43,7 @@ Date: September 2008
|
|||||||
Contact: Badari Pulavarty <pbadari@us.ibm.com>
|
Contact: Badari Pulavarty <pbadari@us.ibm.com>
|
||||||
Description:
|
Description:
|
||||||
The file /sys/devices/system/memory/memoryX/state
|
The file /sys/devices/system/memory/memoryX/state
|
||||||
is read-write. When read, it's contents show the
|
is read-write. When read, its contents show the
|
||||||
online/offline state of the memory section. When written,
|
online/offline state of the memory section. When written,
|
||||||
root can toggle the the online/offline state of a removable
|
root can toggle the the online/offline state of a removable
|
||||||
memory section (see removable file description above)
|
memory section (see removable file description above)
|
||||||
|
|||||||
@@ -742,7 +742,7 @@ failure can be determined by:
|
|||||||
|
|
||||||
Closing
|
Closing
|
||||||
|
|
||||||
This document, and the API itself, would not be in it's current
|
This document, and the API itself, would not be in its current
|
||||||
form without the feedback and suggestions from numerous individuals.
|
form without the feedback and suggestions from numerous individuals.
|
||||||
We would like to specifically mention, in no particular order, the
|
We would like to specifically mention, in no particular order, the
|
||||||
following people:
|
following people:
|
||||||
|
|||||||
@@ -490,7 +490,7 @@ void (*host_stop) (struct ata_host_set *host_set);
|
|||||||
allocates space for a legacy IDE PRD table and returns.
|
allocates space for a legacy IDE PRD table and returns.
|
||||||
</para>
|
</para>
|
||||||
<para>
|
<para>
|
||||||
->port_stop() is called after ->host_stop(). It's sole function
|
->port_stop() is called after ->host_stop(). Its sole function
|
||||||
is to release DMA/memory resources, now that they are no longer
|
is to release DMA/memory resources, now that they are no longer
|
||||||
actively being used. Many drivers also free driver-private
|
actively being used. Many drivers also free driver-private
|
||||||
data from port at this time.
|
data from port at this time.
|
||||||
|
|||||||
@@ -216,7 +216,7 @@ The driver should return one of the following result codes:
|
|||||||
|
|
||||||
- PCI_ERS_RESULT_NEED_RESET
|
- PCI_ERS_RESULT_NEED_RESET
|
||||||
Driver returns this if it thinks the device is not
|
Driver returns this if it thinks the device is not
|
||||||
recoverable in it's current state and it needs a slot
|
recoverable in its current state and it needs a slot
|
||||||
reset to proceed.
|
reset to proceed.
|
||||||
|
|
||||||
- PCI_ERS_RESULT_DISCONNECT
|
- PCI_ERS_RESULT_DISCONNECT
|
||||||
@@ -241,7 +241,7 @@ in working condition.
|
|||||||
|
|
||||||
The driver is not supposed to restart normal driver I/O operations
|
The driver is not supposed to restart normal driver I/O operations
|
||||||
at this point. It should limit itself to "probing" the device to
|
at this point. It should limit itself to "probing" the device to
|
||||||
check it's recoverability status. If all is right, then the platform
|
check its recoverability status. If all is right, then the platform
|
||||||
will call resume() once all drivers have ack'd link_reset().
|
will call resume() once all drivers have ack'd link_reset().
|
||||||
|
|
||||||
Result codes:
|
Result codes:
|
||||||
|
|||||||
@@ -73,7 +73,7 @@ NOTE: Smack labels are limited to 23 characters. The attr command
|
|||||||
If you don't do anything special all users will get the floor ("_")
|
If you don't do anything special all users will get the floor ("_")
|
||||||
label when they log in. If you do want to log in via the hacked ssh
|
label when they log in. If you do want to log in via the hacked ssh
|
||||||
at other labels use the attr command to set the smack value on the
|
at other labels use the attr command to set the smack value on the
|
||||||
home directory and it's contents.
|
home directory and its contents.
|
||||||
|
|
||||||
You can add access rules in /etc/smack/accesses. They take the form:
|
You can add access rules in /etc/smack/accesses. They take the form:
|
||||||
|
|
||||||
|
|||||||
@@ -32,7 +32,7 @@ Notes:
|
|||||||
|
|
||||||
- The flash on board is divided into 3 partitions.
|
- The flash on board is divided into 3 partitions.
|
||||||
You should be careful to use flash on board.
|
You should be careful to use flash on board.
|
||||||
It's partition is different from GraphicsClient Plus and GraphicsMaster
|
Its partition is different from GraphicsClient Plus and GraphicsMaster
|
||||||
|
|
||||||
- 16bpp mode requires a different cable than what ships with the board.
|
- 16bpp mode requires a different cable than what ships with the board.
|
||||||
Contact ADS or look through the manual to wire your own. Currently,
|
Contact ADS or look through the manual to wire your own. Currently,
|
||||||
|
|||||||
@@ -7,7 +7,7 @@ The driver only implements a four-wire touch panel protocol.
|
|||||||
|
|
||||||
The touchscreen driver is maintenance free except for the pen-down or
|
The touchscreen driver is maintenance free except for the pen-down or
|
||||||
touch threshold. Some resistive displays and board combinations may
|
touch threshold. Some resistive displays and board combinations may
|
||||||
require tuning of this threshold. The driver exposes some of it's
|
require tuning of this threshold. The driver exposes some of its
|
||||||
internal state in the sys filesystem. If the kernel is configured
|
internal state in the sys filesystem. If the kernel is configured
|
||||||
with it, CONFIG_SYSFS, and sysfs is mounted at /sys, there will be a
|
with it, CONFIG_SYSFS, and sysfs is mounted at /sys, there will be a
|
||||||
directory
|
directory
|
||||||
|
|||||||
@@ -320,7 +320,7 @@ counter decrement would not become globally visible until the
|
|||||||
obj->active update does.
|
obj->active update does.
|
||||||
|
|
||||||
As a historical note, 32-bit Sparc used to only allow usage of
|
As a historical note, 32-bit Sparc used to only allow usage of
|
||||||
24-bits of it's atomic_t type. This was because it used 8 bits
|
24-bits of its atomic_t type. This was because it used 8 bits
|
||||||
as a spinlock for SMP safety. Sparc32 lacked a "compare and swap"
|
as a spinlock for SMP safety. Sparc32 lacked a "compare and swap"
|
||||||
type instruction. However, 32-bit Sparc has since been moved over
|
type instruction. However, 32-bit Sparc has since been moved over
|
||||||
to a "hash table of spinlocks" scheme, that allows the full 32-bit
|
to a "hash table of spinlocks" scheme, that allows the full 32-bit
|
||||||
|
|||||||
@@ -43,7 +43,7 @@
|
|||||||
void bfin_gpio_irq_free(unsigned gpio);
|
void bfin_gpio_irq_free(unsigned gpio);
|
||||||
|
|
||||||
The request functions will record the function state for a certain pin,
|
The request functions will record the function state for a certain pin,
|
||||||
the free functions will clear it's function state.
|
the free functions will clear its function state.
|
||||||
Once a pin is requested, it can't be requested again before it is freed by
|
Once a pin is requested, it can't be requested again before it is freed by
|
||||||
previous caller, otherwise kernel will dump stacks, and the request
|
previous caller, otherwise kernel will dump stacks, and the request
|
||||||
function fail.
|
function fail.
|
||||||
|
|||||||
@@ -5,7 +5,7 @@
|
|||||||
|
|
||||||
This document describes the cache/tlb flushing interfaces called
|
This document describes the cache/tlb flushing interfaces called
|
||||||
by the Linux VM subsystem. It enumerates over each interface,
|
by the Linux VM subsystem. It enumerates over each interface,
|
||||||
describes it's intended purpose, and what side effect is expected
|
describes its intended purpose, and what side effect is expected
|
||||||
after the interface is invoked.
|
after the interface is invoked.
|
||||||
|
|
||||||
The side effects described below are stated for a uniprocessor
|
The side effects described below are stated for a uniprocessor
|
||||||
@@ -231,7 +231,7 @@ require a whole different set of interfaces to handle properly.
|
|||||||
The biggest problem is that of virtual aliasing in the data cache
|
The biggest problem is that of virtual aliasing in the data cache
|
||||||
of a processor.
|
of a processor.
|
||||||
|
|
||||||
Is your port susceptible to virtual aliasing in it's D-cache?
|
Is your port susceptible to virtual aliasing in its D-cache?
|
||||||
Well, if your D-cache is virtually indexed, is larger in size than
|
Well, if your D-cache is virtually indexed, is larger in size than
|
||||||
PAGE_SIZE, and does not prevent multiple cache lines for the same
|
PAGE_SIZE, and does not prevent multiple cache lines for the same
|
||||||
physical address from existing at once, you have this problem.
|
physical address from existing at once, you have this problem.
|
||||||
@@ -249,7 +249,7 @@ one way to solve this (in particular SPARC_FLAG_MMAPSHARED).
|
|||||||
Next, you have to solve the D-cache aliasing issue for all
|
Next, you have to solve the D-cache aliasing issue for all
|
||||||
other cases. Please keep in mind that fact that, for a given page
|
other cases. Please keep in mind that fact that, for a given page
|
||||||
mapped into some user address space, there is always at least one more
|
mapped into some user address space, there is always at least one more
|
||||||
mapping, that of the kernel in it's linear mapping starting at
|
mapping, that of the kernel in its linear mapping starting at
|
||||||
PAGE_OFFSET. So immediately, once the first user maps a given
|
PAGE_OFFSET. So immediately, once the first user maps a given
|
||||||
physical page into its address space, by implication the D-cache
|
physical page into its address space, by implication the D-cache
|
||||||
aliasing problem has the potential to exist since the kernel already
|
aliasing problem has the potential to exist since the kernel already
|
||||||
|
|||||||
@@ -244,7 +244,7 @@ Under below explanation, we assume CONFIG_MEM_RES_CTRL_SWAP=y.
|
|||||||
we have to check if OLDPAGE/NEWPAGE is a valid page after commit().
|
we have to check if OLDPAGE/NEWPAGE is a valid page after commit().
|
||||||
|
|
||||||
8. LRU
|
8. LRU
|
||||||
Each memcg has its own private LRU. Now, it's handling is under global
|
Each memcg has its own private LRU. Now, its handling is under global
|
||||||
VM's control (means that it's handled under global zone->lru_lock).
|
VM's control (means that it's handled under global zone->lru_lock).
|
||||||
Almost all routines around memcg's LRU is called by global LRU's
|
Almost all routines around memcg's LRU is called by global LRU's
|
||||||
list management functions under zone->lru_lock().
|
list management functions under zone->lru_lock().
|
||||||
|
|||||||
@@ -263,7 +263,7 @@ some of the pages cached in the cgroup (page cache pages).
|
|||||||
|
|
||||||
4.2 Task migration
|
4.2 Task migration
|
||||||
|
|
||||||
When a task migrates from one cgroup to another, it's charge is not
|
When a task migrates from one cgroup to another, its charge is not
|
||||||
carried forward by default. The pages allocated from the original cgroup still
|
carried forward by default. The pages allocated from the original cgroup still
|
||||||
remain charged to it, the charge is dropped when the page is freed or
|
remain charged to it, the charge is dropped when the page is freed or
|
||||||
reclaimed.
|
reclaimed.
|
||||||
|
|||||||
@@ -88,7 +88,7 @@ int cn_netlink_send(struct cn_msg *msg, u32 __groups, int gfp_mask);
|
|||||||
int gfp_mask - GFP mask.
|
int gfp_mask - GFP mask.
|
||||||
|
|
||||||
Note: When registering new callback user, connector core assigns
|
Note: When registering new callback user, connector core assigns
|
||||||
netlink group to the user which is equal to it's id.idx.
|
netlink group to the user which is equal to its id.idx.
|
||||||
|
|
||||||
/*****************************************/
|
/*****************************************/
|
||||||
Protocol description.
|
Protocol description.
|
||||||
|
|||||||
@@ -41,7 +41,7 @@ This application requires the following to function properly as of now.
|
|||||||
|
|
||||||
* Cards that fall in this category
|
* Cards that fall in this category
|
||||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||||
At present the cards that fall in this category are the Twinhan and it's
|
At present the cards that fall in this category are the Twinhan and its
|
||||||
clones, these cards are available as VVMER, Tomato, Hercules, Orange and
|
clones, these cards are available as VVMER, Tomato, Hercules, Orange and
|
||||||
so on.
|
so on.
|
||||||
|
|
||||||
|
|||||||
@@ -1,7 +1,7 @@
|
|||||||
Thanks go to the following people for patches and contributions:
|
Thanks go to the following people for patches and contributions:
|
||||||
|
|
||||||
Michael Hunold <m.hunold@gmx.de>
|
Michael Hunold <m.hunold@gmx.de>
|
||||||
for the initial saa7146 driver and it's recent overhaul
|
for the initial saa7146 driver and its recent overhaul
|
||||||
|
|
||||||
Christian Theiss
|
Christian Theiss
|
||||||
for his work on the initial Linux DVB driver
|
for his work on the initial Linux DVB driver
|
||||||
|
|||||||
@@ -146,7 +146,7 @@ found to be inadequate, in this case. The Generic Netlink system was
|
|||||||
used for this as raw Netlink would lead to a significant increase in
|
used for this as raw Netlink would lead to a significant increase in
|
||||||
complexity. There's no question that the Generic Netlink system is an
|
complexity. There's no question that the Generic Netlink system is an
|
||||||
elegant solution for common case ioctl functions but it's not a complete
|
elegant solution for common case ioctl functions but it's not a complete
|
||||||
replacement probably because it's primary purpose in life is to be a
|
replacement probably because its primary purpose in life is to be a
|
||||||
message bus implementation rather than specifically an ioctl replacement.
|
message bus implementation rather than specifically an ioctl replacement.
|
||||||
While it would be possible to work around this there is one concern
|
While it would be possible to work around this there is one concern
|
||||||
that lead to the decision to not use it. This is that the autofs
|
that lead to the decision to not use it. This is that the autofs
|
||||||
|
|||||||
@@ -90,7 +90,7 @@ Mount Options
|
|||||||
Specify the IP and/or port the client should bind to locally.
|
Specify the IP and/or port the client should bind to locally.
|
||||||
There is normally not much reason to do this. If the IP is not
|
There is normally not much reason to do this. If the IP is not
|
||||||
specified, the client's IP address is determined by looking at the
|
specified, the client's IP address is determined by looking at the
|
||||||
address it's connection to the monitor originates from.
|
address its connection to the monitor originates from.
|
||||||
|
|
||||||
wsize=X
|
wsize=X
|
||||||
Specify the maximum write size in bytes. By default there is no
|
Specify the maximum write size in bytes. By default there is no
|
||||||
|
|||||||
@@ -47,7 +47,7 @@ You'll want to start heartbeating on a volume which all the nodes in
|
|||||||
your lockspace can access. The easiest way to do this is via
|
your lockspace can access. The easiest way to do this is via
|
||||||
ocfs2_hb_ctl (distributed with ocfs2-tools). Right now it requires
|
ocfs2_hb_ctl (distributed with ocfs2-tools). Right now it requires
|
||||||
that an OCFS2 file system be in place so that it can automatically
|
that an OCFS2 file system be in place so that it can automatically
|
||||||
find it's heartbeat area, though it will eventually support heartbeat
|
find its heartbeat area, though it will eventually support heartbeat
|
||||||
against raw disks.
|
against raw disks.
|
||||||
|
|
||||||
Please see the ocfs2_hb_ctl and mkfs.ocfs2 manual pages distributed
|
Please see the ocfs2_hb_ctl and mkfs.ocfs2 manual pages distributed
|
||||||
|
|||||||
@@ -38,7 +38,7 @@ flags, it will return EBADR and the contents of fm_flags will contain
|
|||||||
the set of flags which caused the error. If the kernel is compatible
|
the set of flags which caused the error. If the kernel is compatible
|
||||||
with all flags passed, the contents of fm_flags will be unmodified.
|
with all flags passed, the contents of fm_flags will be unmodified.
|
||||||
It is up to userspace to determine whether rejection of a particular
|
It is up to userspace to determine whether rejection of a particular
|
||||||
flag is fatal to it's operation. This scheme is intended to allow the
|
flag is fatal to its operation. This scheme is intended to allow the
|
||||||
fiemap interface to grow in the future but without losing
|
fiemap interface to grow in the future but without losing
|
||||||
compatibility with old software.
|
compatibility with old software.
|
||||||
|
|
||||||
@@ -56,7 +56,7 @@ If this flag is set, the kernel will sync the file before mapping extents.
|
|||||||
|
|
||||||
* FIEMAP_FLAG_XATTR
|
* FIEMAP_FLAG_XATTR
|
||||||
If this flag is set, the extents returned will describe the inodes
|
If this flag is set, the extents returned will describe the inodes
|
||||||
extended attribute lookup tree, instead of it's data tree.
|
extended attribute lookup tree, instead of its data tree.
|
||||||
|
|
||||||
|
|
||||||
Extent Mapping
|
Extent Mapping
|
||||||
@@ -89,7 +89,7 @@ struct fiemap_extent {
|
|||||||
};
|
};
|
||||||
|
|
||||||
All offsets and lengths are in bytes and mirror those on disk. It is valid
|
All offsets and lengths are in bytes and mirror those on disk. It is valid
|
||||||
for an extents logical offset to start before the request or it's logical
|
for an extents logical offset to start before the request or its logical
|
||||||
length to extend past the request. Unless FIEMAP_EXTENT_NOT_ALIGNED is
|
length to extend past the request. Unless FIEMAP_EXTENT_NOT_ALIGNED is
|
||||||
returned, fe_logical, fe_physical, and fe_length will be aligned to the
|
returned, fe_logical, fe_physical, and fe_length will be aligned to the
|
||||||
block size of the file system. With the exception of extents flagged as
|
block size of the file system. With the exception of extents flagged as
|
||||||
@@ -125,7 +125,7 @@ been allocated for the file yet.
|
|||||||
|
|
||||||
* FIEMAP_EXTENT_DELALLOC
|
* FIEMAP_EXTENT_DELALLOC
|
||||||
- This will also set FIEMAP_EXTENT_UNKNOWN.
|
- This will also set FIEMAP_EXTENT_UNKNOWN.
|
||||||
Delayed allocation - while there is data for this extent, it's
|
Delayed allocation - while there is data for this extent, its
|
||||||
physical location has not been allocated yet.
|
physical location has not been allocated yet.
|
||||||
|
|
||||||
* FIEMAP_EXTENT_ENCODED
|
* FIEMAP_EXTENT_ENCODED
|
||||||
@@ -159,7 +159,7 @@ Data is located within a meta data block.
|
|||||||
Data is packed into a block with data from other files.
|
Data is packed into a block with data from other files.
|
||||||
|
|
||||||
* FIEMAP_EXTENT_UNWRITTEN
|
* FIEMAP_EXTENT_UNWRITTEN
|
||||||
Unwritten extent - the extent is allocated but it's data has not been
|
Unwritten extent - the extent is allocated but its data has not been
|
||||||
initialized. This indicates the extent's data will be all zero if read
|
initialized. This indicates the extent's data will be all zero if read
|
||||||
through the filesystem but the contents are undefined if read directly from
|
through the filesystem but the contents are undefined if read directly from
|
||||||
the device.
|
the device.
|
||||||
@@ -176,7 +176,7 @@ VFS -> File System Implementation
|
|||||||
|
|
||||||
File systems wishing to support fiemap must implement a ->fiemap callback on
|
File systems wishing to support fiemap must implement a ->fiemap callback on
|
||||||
their inode_operations structure. The fs ->fiemap call is responsible for
|
their inode_operations structure. The fs ->fiemap call is responsible for
|
||||||
defining it's set of supported fiemap flags, and calling a helper function on
|
defining its set of supported fiemap flags, and calling a helper function on
|
||||||
each discovered extent:
|
each discovered extent:
|
||||||
|
|
||||||
struct inode_operations {
|
struct inode_operations {
|
||||||
|
|||||||
@@ -91,7 +91,7 @@ Mount options
|
|||||||
'default_permissions'
|
'default_permissions'
|
||||||
|
|
||||||
By default FUSE doesn't check file access permissions, the
|
By default FUSE doesn't check file access permissions, the
|
||||||
filesystem is free to implement it's access policy or leave it to
|
filesystem is free to implement its access policy or leave it to
|
||||||
the underlying file access mechanism (e.g. in case of network
|
the underlying file access mechanism (e.g. in case of network
|
||||||
filesystems). This option enables permission checking, restricting
|
filesystems). This option enables permission checking, restricting
|
||||||
access based on file mode. It is usually useful together with the
|
access based on file mode. It is usually useful together with the
|
||||||
@@ -171,7 +171,7 @@ or may honor them by sending a reply to the _original_ request, with
|
|||||||
the error set to EINTR.
|
the error set to EINTR.
|
||||||
|
|
||||||
It is also possible that there's a race between processing the
|
It is also possible that there's a race between processing the
|
||||||
original request and it's INTERRUPT request. There are two possibilities:
|
original request and its INTERRUPT request. There are two possibilities:
|
||||||
|
|
||||||
1) The INTERRUPT request is processed before the original request is
|
1) The INTERRUPT request is processed before the original request is
|
||||||
processed
|
processed
|
||||||
|
|||||||
Some files were not shown because too many files have changed in this diff Show More
Reference in New Issue
Block a user