loop devices, write to /run/mount/utab or /etc/mtab, etc.
It would be nice to improve libmount to check for CAP_SYS_ADMIN if suid not
- set and allow to use it for simple tasks where no another operation is
+ set and allow using it for simple tasks where no another operation is
necessary.
partx
* @lc: context
* @flags: LOOPITER_FL_* flags
*
- * Iterator allows to scan list of the free or used loop devices.
+ * Iterator can be used to scan list of the free or used loop devices.
*
* Returns: <0 on error, 0 on success
*/
return par;
}
-/* allows to modify used partitions numbers (for example for logical partitions) */
+/* can be used to modify used partitions numbers (for example for logical partitions) */
int blkid_partlist_set_partno(blkid_partlist ls, int partno)
{
if (!ls)
return ls ? ls->next_partno++ : -1;
}
-/* allows to set "parent" for the next nested partition */
+/* can be used to set "parent" for the next nested partition */
static int blkid_partlist_set_parent(blkid_partlist ls, blkid_partition par)
{
if (!ls)
/*
* Solaris-x86 is always within primary dos partition (nested PT table). The
- * solaris-x86 vtoc allows to split the entire partition to "slices". The
+ * solaris-x86 vtoc can be used to split the entire partition to "slices". The
* offset (start) of the slice is always relatively to the primary dos
* partition.
*
* wiped area then the signature has been added later and LVM superblock
* should be ignore.
*
- * Note that this heuristic is not 100% reliable, for example "pvcreate --zero
- * n" allows to keep the begin of the device unmodified. It's probably better
+ * Note that this heuristic is not 100% reliable, for example "pvcreate --zero n"
+ * can be used to keep the begin of the device unmodified. It's probably better
* to use this heuristic for conflicts between superblocks and partition tables
* than for conflicts between filesystem superblocks -- existence of unwanted
* partition table is very unusual, because PT is pretty visible (parsed and
* fdisk_ask_number_is_wrap_negative:
* @ask: ask instance
*
- * The wrap-negative flag allows to accept negative number from user. In this
+ * The wrap-negative flag can be used to accept negative number from user. In this
* case the dialog result is calculated as "high - num" (-N from high limit).
*
* Returns: 1 or 0.
* @ask: ask instance
* @relative: 0 or 1
*
- * Inform libfdisk that user specified number in relative notation rather than
- * by explicit number. This info allows to fdisk do some optimization (e.g.
+ * Inform libfdisk that user can specify the number in relative notation rather than
+ * by explicit number. This is useful for some optimization (e.g.
* align end of partition, etc.)
*
* Returns: 0 on success, <0 on error
* @enable: 1 or 0
*
* The library zeroizes all the first sector when create a new disk label by
- * default. This function allows to control this behavior. For now it's
+ * default. This function can be used to control this behavior. For now it's
* supported for MBR and GPT.
*
* Returns: 0 on success, < 0 on error.
* @short_description: disk label (PT) specific data and functions
*
* The fdisk_new_context() initializes all label drivers, and allocate
- * per-label specific data struct. This concept allows to store label specific
+ * per-label specific data struct. This concept can be used to store label specific
* settings to the label driver independently on the currently active label
* driver. Note that label struct cannot be deallocated, so there is no
* reference counting for fdisk_label objects. All is destroyed by
rc = fdisk_get_partitions(cxt, &tb);
if (!rc) {
/* For resize we do not follow grain to detect free-space, but
- * we allow to resize with very small granulation. */
+ * we support to resize with very small granulation. */
unsigned long org = cxt->grain;
cxt->grain = cxt->sector_size;
* @title: Script
* @short_description: complex way to create and dump partition table
*
- * This interface allows to compose in-memory partition table with all details,
+ * This interface can be used to compose in-memory partition table with all details,
* write all partition table description to human readable text file, read it
* from the file, and apply the script to on-disk label.
*
* If no @data is specified then the header is removed. If header does not exist
* and @data is specified then a new header is added.
*
- * Note that libfdisk allows to specify arbitrary custom header, the default
+ * Note that libfdisk can be used to specify arbitrary custom header, the default
* built-in headers are "unit" and "label", and some label specific headers
* (for example "uuid" and "name" for GPT).
*
* @tb: table
*
* Replaces table used by script and creates a new reference to @tb. This
- * function allows to generate a new script table independently on the current
+ * function can be used to generate a new script table independently on the current
* context and without any file reading.
*
* This is useful for example to create partition table with the same basic
* @cache: cache pointer
* @mtab: table with already canonicalized mountpoints
*
- * Add to @cache reference to @mtab. This allows to avoid unnecessary paths
+ * Add to @cache reference to @mtab. This can be used to avoid unnecessary paths
* canonicalization in mnt_resolve_target().
*
* Returns: negative number in case of error, or 0 o success.
* @cxt: mount context
* @fs: filesystem description
*
- * The mount context uses private @fs by default. This function allows to
+ * The mount context uses private @fs by default. This function can be used to
* overwrite the private @fs with an external instance. This function
* increments @fs reference counter (and decrement reference counter of the
* old fs).
* @tb: fstab
*
* The mount context reads /etc/fstab to the private struct libmnt_table by default.
- * This function allows to overwrite the private fstab with an external
+ * This function can be used to overwrite the private fstab with an external
* instance.
*
* This function modify the @tb reference counter. This function does not set
* @cache: cache instance or NULL
*
* The mount context maintains a private struct libmnt_cache by default. This
- * function allows to overwrite the private cache with an external instance.
+ * function can be used to overwrite the private cache with an external instance.
* This function increments cache reference counter.
*
* If the @cache argument is NULL, then the current cache instance is reset.
*
* Sets mount flags (see mount(2) man page).
*
- * Note that mount context allows to define mount options by mount flags. It
+ * Note that mount context can be used to define mount options by mount flags. It
* means you can for example use
*
* mnt_context_set_mflags(cxt, MS_NOEXEC | MS_NOSUID);
* @data: mount(2) data
*
* The mount context generates mountdata from mount options by default. This
- * function allows to overwrite this behavior, and @data will be used instead
+ * function can be used to overwrite this behavior, and @data will be used instead
* of mount options.
*
* The libmount does not deallocate the data by mnt_free_context(). Note that
se_rem = 1;
else if (cxt->mountflags & MS_REMOUNT)
/*
- * Linux kernel < 2.6.39 does not allow to remount with any
- * selinux specific mount options.
+ * Linux kernel < 2.6.39 does not support remount operation
+ * with any selinux specific mount options.
*
* Kernel 2.6.39 commits: ff36fe2c845cab2102e4826c1ffa0a6ebf487c65
* 026eb167ae77244458fa4b4b9fc171209c079ba7
/*
* Mounted by mount(2), do some post-mount checks
*
- * Kernel allows to use MS_RDONLY for bind mounts, but the
+ * Kernel can be used to use MS_RDONLY for bind mounts, but the
* read-only request could be silently ignored. Check it to
* avoid 'ro' in mtab and 'rw' in /proc/mounts.
*/
/*
* The mount table may be huge, and on systems with utab we have to
* merge userspace mount options into /proc/self/mountinfo. This all is
- * expensive. The tab filter allows to filter out entries, then a mount
+ * expensive. The tab filter can be used to filter out entries, then a mount
* table and utab are very tiny files.
*
* The filter uses mnt_fs_streq_{target,srcpath} function where all
* @wrap_nextchunk: function to return next zero terminated data
* @userdata: optional stuff for callbacks
*
- * Extends SCOLS_FL_WRAP and allows to set custom wrap function. The default
+ * Extends SCOLS_FL_WRAP and can be used to set custom wrap function. The default
* is to wrap by column size, but you can create functions to wrap for example
* after \n or after words, etc.
*
* @title: Grouping
* @short_description: lines grouing
*
- * Lines groups manipulation API. The grouping API allows to create M:N
+ * Lines groups manipulation API. The grouping API can be used to create M:N
* relations between lines and on tree-like output it prints extra chart to
* visualize these relations. The group has unlimited number of members and
* group childs. See libsmartcols/sample/grouping* for more details.
/**
* SECTION: symbols
* @title: Symbols
- * @short_description: allows to overwrite default output chars (for ascii art)
+ * @short_description: can be used to overwrite default output chars (for ascii art)
*
* An API to access and modify data and information per symbol/symbol group.
*/
}
/*
- * This handler allows to inform a shell about signals to login. If you have
+ * This handler can be used to inform a shell about signals to login. If you have
* (root) permissions, you can kill all login children by one signal to the
* login process.
*
.BR hwclock (8)
or
.BR rtcwake (8)
-allow to use alternative location by command line options if write access to
+can use alternative location by command line options if write access to
/etc is unwanted. The default clock mode is "UTC" if the file is missing.
.PP
The Hardware Clock is usually not very accurate. However, much of its inaccuracy is completely predictable - it gains
lseek(ctl->kmsg, 0, ctl->end ? SEEK_END : SEEK_DATA);
/*
- * Old kernels (<3.5) allow to successfully open /dev/kmsg for
- * read-only, but read() returns -EINVAL :-(((
+ * Old kernels (<3.5) can successfully open /dev/kmsg for read-only,
+ * but read() returns -EINVAL :-(((
*
* Let's try to read the first record. The record is later processed in
* read_kmsg().
projects / thirdparty / util-linux.git / commitdiff
