Scan the system to check which MDTs are active. The status of the MDTs is
required because the
.B barrier_freeze
-will be unsuccessful if any of the MDTs are permenantly offline. During
+will be unsuccessful if any of the MDTs are permanently offline. During
the rescan, the MDT status is updated. If an MDT does not respond the
.B barrier_rescan
within the given
Recursively show all of the parameter names below the specified name.
.TP
.B -y ", " --yaml
-Some paramters can be presented in a YAML format but are not by default. This
+Some parameters can be presented in a YAML format but are not by default. This
will format the parameter data in YAML. If the YAML provides a source: field
it can be suppressed with the -n option.
.TP
.B -A, --all
Start LFSCK on all available devices in the system by single LFSCK command.
-Such LFSCK command can be executed on any MDT deivce in the system.
+Such LFSCK command can be executed on any MDT device in the system.
.TP
.B -c, --create-ostobj [on | off]
Create the lost OST-object for dangling LOV EA: 'off' (default) or 'on'. Under
Delay to create the lost OST-object for dangling LOV EA until orphan OST-objects
handled: 'off' (default) or 'on'. If both "--create-ostobj" and the delay option
are 'on', then the LFSCK will NOT create the OST-object to repair dangling LOV
-EA unless all the OST-objects have been handled. It can avoid reparing dangling
+EA unless all the OST-objects have been handled. It can avoid repairing dangling
LOV EA incorrectly because of LOV EA corruption. The side-effect is that as long
as one OST does not join the layout LFSCK or fail to complete the scanning, then
-reparing dangling LOV EA will be skipped. For a large system with a lot of OSTs,
+repairing dangling LOV EA will be skipped. For a large system with a lot of OSTs,
such condition may be a bit strict. The default value is 'off'.
.TP
.B -e, --error <error_handle>
.TP
.B -A, --all
Stop LFSCK on all available devices in the system by single LFSCK command.
-Such LFSCK command can be executed on any MDT deivce in the system.
+Such LFSCK command can be executed on any MDT device in the system.
.TP
.B -h, --help
Show this help.
.SH SEE ALSO
.BR lustre (7),
.BR lctl-get_param (8),
-.BR lctl-set_parm (8),
+.BR lctl-set_param (8),
.BR lfs (1)
- "projid={100}&size>{1M}&size<{500G}"
- "projid>{100}&projid<{110}"
- "uid<{1500}&uid>{1000}"
-Currently each PCC backend only has one rule which is configed when setup PCC
+Currently each PCC backend only has one rule which is configured when setup PCC
backend on a client. If a user wants to change the rule, the PCC backend needs
to be removed first and then added back with a new rule.
.TP
.BR on ,
then the
.I timeout
-specifies the write barrier's lifetime in second. The default vaule is 30.
+specifies the write barrier's lifetime in second. The default value is 30.
.SH AVAILABILITY
.B lctl-snapshot-create
{-n | --name ssname} [-r | --rsh remote_shell]
.br
.SH DESCRIPTION
-Umount the specified snapshot on the servers.
+Unmount the specified snapshot on the servers.
.SH OPTIONS
.TP
.BR -F ", " --fsname " "\fIfsname
For help information.
.TP
.BR -n ", " --name " "\fIssname
-The snapshot (to be umounted) name must be specified.
+The snapshot (to be unmounted) name must be specified.
.TP
.BR -r ", " --rsh " "\fIremote_shell
Specify a shell to communicate with remote targets. The default value is
mount -t lustre <MDT partition> -o nosvc <mount point>
Note the replace_nids command skips any invalidated records in the configuration log.
The previous log is backed up with the suffix '.bak'.
-Failover nids must be passed after ':' symbol. More then
+Failover nids must be passed after ':' symbol. More than
one failover can be set (every failover nids after ':' symbol).
.TP
.BI ping " <nid> timeout"
including: corrupted or lost OI mapping, corrupted or lost link EA, corrupted
or lost FID in name entry, dangling name entry, multiple referenced name entry,
unmatched MDT-object and name entry pairs, orphan MDT-object, incorrect
-MDT-object links count, corrupted namespace, corrupted or lost lov EA, lost
+MDT-object links count, corrupted namespace, corrupted or lost LOV EA, lost
OST-object, multiple referenced OST-object, unmatched MDT-object and OST-object
pairs, orphan OST-object, and so on.
.TP
.I "foreign hostname"
The name of the host where the device runs when failed over.
-If failover is not used, insert a hypen as a placeholder.
+If failover is not used, insert a hyphen as a placeholder.
.TP
.I "label"
The Lustre label associated with the device in the form \fIfsname-SRVnnnn\fR
Turn on file heat support for the Lustre filesystem:
.B $ lctl set_param llite.$FSNAME*.file_heat=1
.TP
-Trun off file heat support for the Lustre filesystem:
+Turn off file heat support for the Lustre filesystem:
.B $ lctl set_param llite.$FSNAME*.file_heat=0
.TP
Display current file heat for foo:
-.so man1/lfs-heat.1
+.so man1/lfs-heat_get.1
.br
.SH DESCRIPTION
Give file access advices or hints to Lustre server side, usually OSS. This lfs
-command is simlar to the Linux
+command is similar to the Linux
.BR fadvise64 (2)
system call and
.BR posix_fadvise (2),
.B lfs ladvise
forwards the advice to Lustre servers without
guaranteeing how and when servers will react to the advice. Actions may or
-may not be triggered when the advices are recieved, depending on the type of
+may not be triggered when the advices are received, depending on the type of
the advice, whether the backing filesystem type supports that advice, as well
as the real-time decision of the affected server-side components.
is -1, the MDT index will be balanced by free space and inodes among
available MDTs. If multiple
.I MDT_INDEX
-values are specified in a comma-seperated list, then all
+values are specified in a comma-separated list, then all
subdirectories will be
.B striped
across all of the specified MDT indices as if an equivalent
the file is specified by the path name \fImirrored_file\fR, the mirrors are
specified by their mirror ID.
.SH NOTE
-Be ware that the written mirror(s) will be marked as non-stale mirror(s),
+Beware that the written mirror(s) will be marked as non-stale mirror(s),
be careful that after using this command, you could get a file with non-stale
mirrors while containing different contents.
.br
.TP
.BI prefer
is supported in mirror creation. This flag will be set to all components that
-belong to ths corresponding mirror. The \fBprefer\fR flag gives hint to Lustre
+belong to the corresponding mirror. The \fBprefer\fR flag gives hint to Lustre
for which mirrors should be used to serve I/O. When a mirrored file is being
read, the component(s) with \fBprefer\fR are likely to be picked to serve the
read; and when a mirrored file is prepared to be written, the MDT will
If \fIVICTIM_FILE\fR is specified, the utility will verify that the file contents
from \fIVICTIM_FILE\fR are the same as \fIFILENAME\fR. Otherwise the command
will return failure. However, option \fB\-\-no\-verify\fR can be used to
-override this verification. The option can save siginificant time on file
+override this verification. The option can save significant time on file
comparison if the file size is large, but use it only when the file contents
are known to be the same.
.br
.SH EXAMPLES
.TP
.B lfs mirror write --mirror-id 3 /mnt/lustre/file1 < /tmp/m2
-Write the content of /mnt/m2 to the mirror with miro ID 3 for
+Write the content of /mnt/m2 to the mirror with mirror ID 3 for
/mnt/lustre/file1.
.TP
.B lfs mirror write -N2 -i /tmp/m2 /mnt/lustre/file1
File system name for key.
.TP
.I "-g, --mgsnids <nids>"
-Comma seperated list of MGS NIDs. Only required when mgssec is used (Default: "").
+Comma-separated list of MGS NIDs. Only required when mgssec is used (Default: "").
.TP
.I "-n, --nodemap <name>"
Nodemap name for key (Default: "default").
.br
.SH DESCRIPTION
.B lhbadm
-simlifies heartbeat administration on Lustre clusters.
+simplifies heartbeat administration on Lustre clusters.
It offers the following operations:
.TP
.B status
614725, and 533088, respectively. The object sequence number (formerly
object group) is 0 for all current OST objects.
.PP
-The MDT parent inode FIDs are hexdecimal numbers of the form
+The MDT parent inode FIDs are hexadecimal numbers of the form
sequence:oid:idx. Since the sequence number is below 0x100000000 in
all these cases, the FIDs are in the IGIF (legacy Inode and Generation
In FID) namespace and are mapped directly to the MDT inode = seq and
.BR name_to_handle_at (2)
function, and is useful for Lustre-specific tools and interfaces. While the
.BR llapi_fid_to_handle (3)
-function does not requre root access itself, the
+function does not require root access itself, the
.BR open_by_handle_at (2)
function
.B does
.TH llapi_get_lum_file_fd 3 "2019 July 15" "Lustre User API"
.SH NAME
llapi_get_lum_file_fd, llapi_get_lum_dir_fd, llapi_get_lum_file,
-llapi_get_lum_dir \- get valid file attrbutes and LOV stripe information to
+llapi_get_lum_dir \- get valid file attributes and LOV stripe information to
the user.
.SH SYNOPSIS
The returned object type (mode & S_IFMT) is valid.
.TP
OBD_MD_FLUID
-The returned user ID is vaild.
+The returned user ID is valid.
.TP
OBD_MD_FLGID
The returned group ID is valid.
comp = llapi_layout_alloc();
llapi_layout_comp_add(head, comp);
llapi_layout_comp_extent_set(head, comp, 67108864,
- (u_int64t)-1); //[64M, EOF)
+ (uint64_t)-1); //[64M, EOF)
llapi_layout_stripe_count_set(comp, LLAPI_LAYOUT_WIDE);
/* Create file with specified composite layout */
.B NULL
on failure with
.B errno
-set to an approporiate error code.
+set to an appropriate error code.
.sp
.B llapi_layout_free()
returns no value.
.B NULL
on failure with
.B errno
-set to an approporiate error code.
+set to an appropriate error code.
.SH ERRORS
.TP 15
.SM ENOMEM
.B llapi_layout_ost_index_get()
with a
.I layout
-that was not initialized with with one of
+that was not initialized with one of
.BR llapi_layout_get_by_fd() ,
.BR llapi_layout_get_by_fid() ,
or
.fi
.TP
LU_PCC_NONE
-menas that the file is not cached on PCC.
+means that the file is not cached on PCC.
.TP
LU_PCC_READWRITE
means RW-PCC mode.
.I llapi_rmfid.
It tries to remove Lustre files by FIDs stored in
.I fa->fa_fids
-where path or device is pointed by an already verifed
+where path or device is pointed by an already verified
.I fd.
.SH RETURN VALUES
.B llapi_root_path_open(\|)
is called with
.I device
-which points to the FSNAME or complete path specifying a mountpount of Lustre
+which points to the FSNAME or complete path specifying a mountpoint of Lustre
filesystem. On success,
.I fd
is populated with valid descriptor.
.SH DESCRIPTION
.B lshowmount
Utility to show the hosts that have lustre currently mounted to a server.
-Ths utility looks for any exports from the mgs, mds, and obdfilter.
+This utility looks for any exports from the mgs, mds, and obdfilter.
.SH OPTIONS
.B lshowmount
accepts the following options:
The format of the config file is:
.br
<network>: { gateway: <gateway>@<exit network> [hop: <hop>]
- [priority: <prioirty>] }
+ [priority: <priority>] }
.LP
Usage:
.br
.SH SYNOPSIS
.B "lustre_routes_conversion"
.SH DESCRIPTION
-lustre_route_conversion takes as a first parameter a file with routes
+lustre_routes_conversion takes as a first parameter a file with routes
configured as follows:
.LP
<network> [<hop>] <gateway>@<exit network>[:<priority>];
Then converts it to:
.LP
<network>: { gateway: <gateway>@<exit network> [hop: <hop>]
- [priority: <prioirty>] }
+ [priority: <priority>] }
.LP
and appends it to the output file passed in as the second parameter to
the script.
.SH OPTIONS
.B --source=<src>
.br
-The path to the root of the Lustre filesytem which will be replicated.
+The path to the root of the Lustre filesystem which will be replicated.
Mandatory if a valid statuslog created during an previous replication operation
(--statuslog) is not specified.
.B --target=<tgt>
.br
-The path to the root where the filesystem we be replicated. Mandatory
+The path to the root where the filesystem will be replicated. Mandatory
if a valid statuslog created during an previous replication operation
(--statuslog) is not specified. This option can be repeated if
multiple replication targets are desired.
Print more information.
.TP
.B \-V, \-\-version
-Output build version of the mkfs.lustre utiltiy.
+Output build version of the mkfs.lustre utility.
.SH NID
A Lustre network identifier (NID) is used to uniquely identify a Lustre network
create mdt/mgs on filesystem 'zfspool/mdt1'.
.TP
.B mkfs.lustre --version
-Output build version of the mkfs.lustre utiltiy e.g. 2.15.52_175_ge7aa83d
+Output build version of the mkfs.lustre utility e.g. 2.15.52_175_ge7aa83d
.SH AVAILABILITY
.B mkfs.lustre
provides a full POSIX-compilant interface.
.TP
.I block_device
-specifies the phyisical disk or ZFS dataset uses to start the target service
+specifies the physical disk or ZFS dataset uses to start the target service
formatted by the
.IR mkfs.lustre (8)
command. The
git://git.whamcloud.com / fs / lustre-release.git / commitdiff