<commit_before>.\" $Id$
.\" %PSCGPL_START_COPYRIGHT%
.\" -----------------------------------------------------------------------------
.\" Copyright (c) 2008-2013, Pittsburgh Supercomputing Center (PSC).
.\"
.\" This program is free software; you can redistribute it and/or modify
.\" it under the terms of the GNU General Public License as published by
.\" the Free Software Foundation; either version 2 of the License, or (at
.\" your option) any later version.
.\"
.\" This program is distributed WITHOUT ANY WARRANTY; without even the
.\" implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
.\" PURPOSE.  See the GNU General Public License contained in the file
.\" `COPYING-GPL' at the top of this distribution or at
.\" https://www.gnu.org/licenses/gpl-2.0.html for more details.
.\"
.\" Pittsburgh Supercomputing Center	phone: 412.268.4960  fax: 412.268.5832
.\" 300 S. Craig Street			e-mail: <EMAIL>
.\" Pittsburgh, PA 15213			web: http://www.psc.edu/
.\" -----------------------------------------------------------------------------
.\" %PSC_END_COPYRIGHT%
.\" %PFL_MODULES ctl rpc %
.Dd November 26, 2014
.Dt SLMCTL 8
.ds volume PSC \- SLASH2 Administrator's Manual
.Os http://www.psc.edu/
.Sh NAME
.Nm slmctl
.Nd
.Tn SLASH2 MDS
daemon runtime control
.Sh SYNOPSIS
.Nm slmctl
.Op Fl HIn
.Op Fl p Ar paramspec
.Op Fl S Ar socket
.Op Fl s Ar showspec
.Op Ar cmd arg ...
.Sh DESCRIPTION
The
.Nm
utility examines and manipulates
.Xr slashd 8
behavior.
.Pp
.\" %PFL_INCLUDE $PFL_BASE/doc/pflctl/cmd.mdoc {
.\"	cmds => {
.\"		stop => <<'EOF'
.\"			Instruct
.\"			.Xr slashd 8
.\"			to completely terminate daemon execution.
.\"		EOF
.\"	}
The supported commands are as follows:
.Bl -tag -width 3n
.It Cm stop
Instruct
.Xr slashd 8
to completely terminate daemon execution.
.El
.\" }%
.Pp
The options are as follows:
.Bl -tag -width 3n
.\" %PFL_INCLUDE $PFL_BASE/doc/pflctl/H.mdoc {
.It Fl H
Suppress headers when showing data displays.
.\" }%
.\" %PFL_INCLUDE $PFL_BASE/doc/pflctl/I.mdoc {
.It Fl I
Display large numerical values accurately instead of rounded with
postfixes of demonination such as
.Sq G
for gibibytes,
.Sq M
for mebibytes, etc.\&
.Pq Do inhuman Dc number mode .
.\" }%
.\" %PFL_INCLUDE $PFL_BASE/doc/pflctl/n.mdoc {
.It Fl n
Suppress
.Tn DNS
lookups for network addresses.
.\" }%
.\" %PFL_INCLUDE $PFL_BASE/doc/pflctl/p.mdoc {
.\"	log_xr => "in\n.Xr slashd 8\n",
.\"	params => {
.\"		"namespace.stats" => "Communication statistics for\n.Tn MDS Ns -to- Ns Tn MDS\nnamespace updates.",
.\"		nextfid => "Next file identifier\n.Pq Tn FID\nthat will be used for new file creation.",
.\"		resources => <<EOF .
.\"			Settings and fields specific to network peers.
.\"			.Bl -tag -width 13n -offset 3n
.\"			EOF
.\"			build_list(
.\"				xid => <<EOF,
.\"					Highest journal transaction identifier peer has received
.\"					for either namespace metadata updates or garbage
.\"					reclamation updates.
.\"				EOF
.\"				disable_bia => <<EOF,
.\"					Whether bmap write lease assignments are administratively
.\"					disabled
.\"					.Pq ION only .
.\"					EOF
.\"				disable_gc => <<EOF,
.\"					Whether garbage collection and reclamation is administratively
.\"					disabled
.\"					.Pq ION only .
.\"					EOF
.\"			) . ".El",
.\"	}
.It Fl p Ar paramspec
Query/manipulate operational parameters.
.Ar paramspec
has the following format:
.Pp
.Bd -unfilled -offset 3n
.Sm off
.Oo Ar thread-name Ns Li .\& Oc Ar param
.Op Oo Li +- Oc Li = Ar value
.Sm on
.Ed
.Pp
Some parameters may be read- or write-only.
Some support modification by the assignment operators
.Li +=
and
.Li -= .
.Pp
See
.Sx Thread Specification
for details on specifying
.Ar thread-name .
The default behavior is to apply the operation to all applicable threads.
.Pp
.Ar param
may be one of the following:
.Bl -tag -width 1n -offset 3n
.It Cm lnet.networks
.Tn LNET
network configuration.
.It Cm lnet.port
If applicable,
.Xr tcp 7
port to use to connect to remote
.Tn LNET
peers.
.It Cm log.file
File path name where log messages will be written.
This value is write-only.
If the
.Li +=
assignment operator is used, this file will not be truncated.
.It Cm log.format
The header prepended to server log messages.
See the description of
.Ev PSC_LOG_FORMAT
in
.Xr slashd 8
for details on this format.
.It Cm log.level Ns Op . Ns Ar subsystem
The logging level of debug message output.
.Pp
See the description of
.Ev PSC_LOG_LEVEL_ Ns Ar subsys
in
.Xr slashd 8
for a list of available subsystems.
If
.Ar subsystem
is not specified, all subsystems will be accessed.
.Pp
See the description of
.Ev PSC_LOG_LEVEL
in
.Xr slashd 8
for recognized log level values.
.It Cm namespace.stats
Communication statistics for
.Tn MDS Ns -to- Ns Tn MDS
namespace updates.
.It Cm nextfid
Next file identifier
.Pq Tn FID
that will be used for new file creation.
.It Cm global
Turn on/off the global mount feature.
.It Cm pool. Ns Ar name
Access the memory pool specified by
.Ar name .
The following sub-fields are available:
.Pp
.Bl -tag -compact -offset 3n -width 13n
.It Cm max
Upper bound for number of entries to which auto-sized pools can grow.
.It Cm min
Lower bound for number of entries to which auto-sized pools can shrink.
.It Cm thres
Threshold for unused items for auto-sized pools before items are freed.
.It Cm total
Current number of entries contained in pool.
.El
.It Cm resources
Settings and fields specific to network peers.
.Bl -tag -width 13n -offset 3n
.It Cm disable_bia
Whether bmap write lease assignments are administratively
disabled
.Pq ION only .
.It Cm disable_gc
Whether garbage collection and reclamation is administratively
disabled
.Pq ION only .
.It Cm xid
Highest journal transaction identifier peer has received
for either namespace metadata updates or garbage
reclamation updates.
.El
.It Cm rlim
Process resource limits.
See
.Xr getrlimit 2
or
.Xr ulimit 1
for more information.
.Pp
.Bl -tag -compact -offset 3n -width 13n
.It Cm nofiles
Corresponds to
.Dv RLIMIT_NOFILE ,
the maximum number of open files.
.El
.El
.\" }%
.\" %PFL_INCLUDE $PFL_BASE/doc/pflctl/S.mdoc {
.\"	daemon	=> qq{slashd},
.\"	sock	=> "/var/run/slashd. Ns Ic %h Ns Pa .sock"
.It Fl S Ar socket
Specify an alternative socket file.
The following tokens are replaced in the file name specified:
.Pp
.Bl -tag -offset 3n -width Ds -compact
.It Cm %h
the machine hostname
.It Cm %n
the daemon executable base name, i.e.\&
.Dq slashd
.It Cm %%
a literal
.Sq %
character
.El
.Pp
The default is
.Pa /var/run/slashd. Ns Ic %h Ns Pa .sock .
.\" }%
.\" %PFL_INCLUDE $PFL_BASE/doc/pflctl/show.mdoc {
.\"	show => {
.\"		bmap		=> qq{In-memory bmaps},
.\"		bml		=> qq{Outstanding bmap leases.},
.\"		connections	=> qq{Status of\n.Tn SLASH2\npeers on network.},
.\"		fidcache	=> qq{.Tn FID\n.Pq file- Ns Tn ID\ncache members.},
.\"		odtables	=> qq{Disk-backed data files.},
.\"		replpairs	=> qq{Replica endpoint traffic.},
.\"		statfs		=> qq{.Tn I/O\nnode backing file system statistics.},
.\"	},
.\"	hashtables => {
.\"		fidc		=> qq{files\n.Po file\n.Tn ID\ncache\n.Pc},
.\"		resnid		=> qq{network resources\n.Pq network Tn ID},
.\"	},
.\"	iostats => {
.\"		qq{jrnlrd- Ns Ar fn ,} => "",
.\"		qq{jrnlwr- Ns Ar fn} =>
.\"		    qq{Data read/written to journal disk file\n.Ar fn .\n.Pp},
.\"	},
.\"	meters => {
.\"		qq{nsupd- Ns Ar peer}	=> qq{Namespace updates to\n.Tn MDS\npeers.},
.\"		qq{reclaim- Ns Ar peer}	=> qq{Garbage collection updates to\n.Tn IO\nsystems.},
.\"	},
.\"	journals => {
.\"		qq{op-journal}	=> qq{Pending operation journal},
.\"	},
.\"	listcaches => {
.\"		fcmhbusy	=> "Files with pending activity e.g.\\&\n.Tn I/O",
.\"		fcmhidle	=> "Clean\n.Pq reapable\nfiles",
.\"		inflightbml	=> "Active bmap lease mode updates",
.\"		pendingbml	=> "Pending bmap lease mode updates",
.\"		replstwkq	=> "Replication status work buffers",
.\"	},
.\"	pools => {
.\"		bmap		=> qq{Block map structures},
.\"	}
.It Fl s Ar showspec
Show values.
.Ar showspec
has the following format:
.Bd -unfilled -offset 3n
.Sm off
.Ar param
.Op : Ar subspec
.Sm on
.Ed
.Pp
.Ar param
may be specified as any non-ambiguous prefix abbreviation of the
following:
.Pp
.Bl -tag -width 1n -offset 3n
.It Cm bmap
In-memory bmaps
.It Cm bml
Outstanding bmap leases.
.It Cm connections
Status of
.Tn SLASH2
peers on network.
.It Cm fidcache
.Tn FID
.Pq file- Ns Tn ID
cache members.
.It Cm hashtables
Hash table statistics.
.Ar subspec
has the following format:
.Bd -unfilled -offset 3n
.Ar hash-table Ns Op , Ns Ar ...
.Ed
.Pp
.Ar hash-table
may be one of the following:
.Pp
.Bl -tag -compact -offset 3n -width 13n
.It Cm fidc
files
.Po file
.Tn ID
cache
.Pc
.It Cm resnid
network resources
.Pq network Tn ID
.El
.Pp
If
.Ar subspec
is left unspecified, all hash tables will be accessed.
.It Cm iostats
.Tn I/O
statistics.
.Ar subspec
has the following format:
.Pp
.Bd -unfilled -offset 3n
.Ar iostats Ns Op , Ns Ar ...
.Ed
.Pp
.Ar iostats
may be one of the following:
.Pp
.Bl -tag -compact -offset 3n -width 3n
.It Cm jrnlrd- Ns Ar fn ,
.It Cm jrnlwr- Ns Ar fn
Data read/written to journal disk file
.Ar fn .
.Pp
.It Cm lni-rcv- Ns Ar if ,
.It Cm lni-snd- Ns Ar if
Data sent/received per
.Tn LNET
networking interface.
.Pp
.It Cm lusklnd- Ns Ar mode Ns Cm -rcv ,
.It Cm lusklnd- Ns Ar mode Ns Cm -snd
Data sent/received over userland socket networking device.
.Ar mode
may be
.Cm pasv
.Pq passive
or
.Cm aggr
.Pq aggregate .
.Pp
.It Cm rpc- Ns Ar addr Ns Cm -rcv ,
.It Cm rpc- Ns Ar addr Ns Cm -snd
Data sent/received per
.Tn RPC
peer.
.Pp
.El
.Pp
If
.Ar subspec
is left unspecified, all
.Tn I/O
statistics will be accessed.
.It Cm journals
Journal statistics.
.Ar subspec
has the following format:
.Pp
.Bd -unfilled -offset 3n
.Ar journal Ns Op , Ns Ar ...
.Ed
.Pp
.Ar journal
may be one of the following:
.Pp
.Bl -tag -compact -offset 3n -width 13n
.It Cm op-journal
Pending operation journal
.El
.Pp
If
.Ar subspec
is left unspecified, all journals will be accessed.
.It Cm listcaches
List cache statistics.
.Ar subspec
has the following format:
.Pp
.Bd -unfilled -offset 3n
.Ar list Ns Op , Ns Ar ...
.Ed
.Pp
.Ar list
may be one of the following:
.Pp
.Bl -tag -compact -offset 3n -width 13n
.It Cm fcmhbusy
Files with pending activity e.g.\&
.Tn I/O
.It Cm fcmhidle
Clean
.Pq reapable
files
.It Cm inflightbml
Active bmap lease mode updates
.It Cm pendingbml
Pending bmap lease mode updates
.It Cm replstwkq
Replication status work buffers
.El
.Pp
If
.Ar subspec
is left unspecified, all list caches will be accessed.
.It Cm lni
Lustre network interfaces.
.It Cm loglevels
Thread logging levels.
.Ar subspec
has the following format:
.Bd -unfilled -offset 3n
.Ar thread Ns Op , Ns Ar ...
.Ed
.Pp
See
.Sx Thread Specification
for details on specifying
.Ar thread .
If
.Ar subspec
is left unspecified, all threads will be accessed.
.It Cm meters
Report on ongoing operations in progress meters.
.Ar subspec
has the following format:
.Bd -unfilled -offset 3n
.Ar meter Ns Op , Ns Ar ...
.Ed
.Pp
.Ar meter
may be one of the following:
.Pp
.Bl -tag -compact -offset 3n -width 13n
.It Cm nsupd- Ns Ar peer
Namespace updates to
.Tn MDS
peers.
.It Cm reclaim- Ns Ar peer
Garbage collection updates to
.Tn IO
systems.
.El
.Pp
If
.Ar subspec
is left unspecified, all ongoing operations will be reported.
.It Cm odtables
Disk-backed data files.
.It Cm pools
Memory pool statistics.
.Ar subspec
has the following format:
.Bd -unfilled -offset 3n
.Ar pool Ns Op , Ns Ar ...
.Ed
.Pp
.Ar pool
may be one of the following:
.Pp
.Bl -tag -compact -offset 3n -width 13n
.It Cm bmap
Block map structures
.El
.Pp
If
.Ar subspec
is left unspecified, all pools will be accessed.
.It Cm replpairs
Replica endpoint traffic.
.It Cm rpcsvcs
.Tn RPC
services.
.It Cm statfs
.Tn I/O
node backing file system statistics.
.It Cm threads
Daemon thread activity and statistics.
.Ar subspec
has the following format:
.Bd -unfilled -offset 3n
.Ar thread Ns Op , Ns Ar ...
.Ed
.Pp
See
.Sx Thread Specification
for details on specifying
.Ar thread .
If
.Ar subspec
is left unspecified, all threads will be accessed.
.El
.Pp
The special value
.Sq \&?
may also be specified to display a list of recognized values.
.\" }%
.El
.\" %PFL_INCLUDE $PFL_BASE/doc/pflctl/thr.mdoc {
.\"	thrs => {
.\"		"slmbchrqthr"			=> "Batch\n.Tn RPC\ntimeout monitor",
.\"		"slmbkdbthr"			=> "",
.\"		"slmbmaptimeothr"		=> "Bmap lease timeout monitor",
.\"		"slmconnthr"			=> "Peer resource connection monitor",
.\"		"slmctlacthr"			=> ".Nm\nconnection acceptor",
.\"		"slmctlthr"			=> ".Nm\nconnection processor",
.\"		"slmdbwkthr"			=> "",
.\"		"slmjcursorthr"			=> "Journal cursor updater thread",
.\"		"slmjnsthr"			=> "Peer\n.Pq Tn MDS\nnamespace updater",
.\"		"slmjreclaimthr"		=> "Peer\n.Pq Tn IOS\ngarbage collection notifier",
.\"		"slmjthr"			=> "Master journal thread",
.\"		"slmlnacthr- Ns Ar %s"		=> ".Tn LNET\nnetwork acceptor thread",
.\"		"slmnbrqthr"			=> "Non-blocking\n.Tn RPC\nreply handler",
.\"		"slmrcmthr"			=> "Client\n.Tn RPC\nrequest initiator thread",
.\"		"slmrmcthr Ns Ar %02d"		=> "Client\n.Tn RPC\nrequest service thread",
.\"		"slmrmithr Ns Ar %02d"		=> ".Tn I/O\nnode\n.Tn RPC\nrequest service thread",
.\"		"slmrmmthr Ns Ar %02d"		=> ".No Inter- Ns MDS RPC\nrequest service thread",
.\"		"slmtiosthr"			=> "Timed\n.Tn I/O\nstats updater thread",
.\"		"slmupschedthr"			=> "Peer update scheduler thread",
.\"		"slmusklndplthr Ns Ar %d"	=> ".Tn LNET\nuserland socket poll thread",
.\"		"slmwkthr Ns Ar %d"		=> "Generic worker",
.\"		"slmzfskstatmthr"		=> ".Tn ZFS\nstat mount thread",
.\"	}
.Ss Thread Specification
Options which take
.Ar thread-name
parameters may be specified by one or more of the following tokens,
separated by commas:
.Pp
.Bl -tag -compact -offset 3n -width 16n
.It Cm slmbchrqthr
Batch
.Tn RPC
timeout monitor
.It Cm slmbkdbthr
.It Cm slmbmaptimeothr
Bmap lease timeout monitor
.It Cm slmconnthr
Peer resource connection monitor
.It Cm slmctlacthr
.Nm
connection acceptor
.It Cm slmctlthr
.Nm
connection processor
.It Cm slmdbwkthr
.It Cm slmjcursorthr
Journal cursor updater thread
.It Cm slmjnsthr
Peer
.Pq Tn MDS
namespace updater
.It Cm slmjreclaimthr
Peer
.Pq Tn IOS
garbage collection notifier
.It Cm slmjthr
Master journal thread
.It Cm slmlnacthr- Ns Ar %s
.Tn LNET
network acceptor thread
.It Cm slmnbrqthr
Non-blocking
.Tn RPC
reply handler
.It Cm slmrcmthr
Client
.Tn RPC
request initiator thread
.It Cm slmrmcthr Ns Ar %02d
Client
.Tn RPC
request service thread
.It Cm slmrmithr Ns Ar %02d
.Tn I/O
node
.Tn RPC
request service thread
.It Cm slmrmmthr Ns Ar %02d
.No Inter- Ns MDS RPC
request service thread
.It Cm slmtiosthr
Timed
.Tn I/O
stats updater thread
.It Cm slmupschedthr
Peer update scheduler thread
.It Cm slmusklndplthr Ns Ar %d
.Tn LNET
userland socket poll thread
.It Cm slmwkthr Ns Ar %d
Generic worker
.It Cm slmzfskstatmthr
.Tn ZFS
stat mount thread
.It Cm everyone
All threads
.Pq default, where applicable
.El
.\" }%
.\" %PFL_INCLUDE $PFL_BASE/doc/env.mdoc {
.Sh ENVIRONMENT
.Bl -tag -width 3n
.It Ev CTL_SOCK_FILE
Override the default control socket file path.
.El
.\" }%
.Sh FILES
.Bl -tag -width Pa
.It Xo
.Pa /var/run/slashd. Ns Ic %h Ns Pa .sock
.Xc
default
.Xr slashd 8
control socket
.El
.Sh SEE ALSO
.Xr sladm 7 ,
.Xr slashd 8 ,
.Xr slictl 8
<commit_msg>Tweak slmctl.8<commit_after>.\" $Id$
.\" %PSCGPL_START_COPYRIGHT%
.\" -----------------------------------------------------------------------------
.\" Copyright (c) 2008-2013, Pittsburgh Supercomputing Center (PSC).
.\"
.\" This program is free software; you can redistribute it and/or modify
.\" it under the terms of the GNU General Public License as published by
.\" the Free Software Foundation; either version 2 of the License, or (at
.\" your option) any later version.
.\"
.\" This program is distributed WITHOUT ANY WARRANTY; without even the
.\" implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
.\" PURPOSE.  See the GNU General Public License contained in the file
.\" `COPYING-GPL' at the top of this distribution or at
.\" https://www.gnu.org/licenses/gpl-2.0.html for more details.
.\"
.\" Pittsburgh Supercomputing Center	phone: 412.268.4960  fax: 412.268.5832
.\" 300 S. Craig Street			e-mail: <EMAIL>
.\" Pittsburgh, PA 15213			web: http://www.psc.edu/
.\" -----------------------------------------------------------------------------
.\" %PSC_END_COPYRIGHT%
.\" %PFL_MODULES ctl rpc %
.Dd November 26, 2014
.Dt SLMCTL 8
.ds volume PSC \- SLASH2 Administrator's Manual
.Os http://www.psc.edu/
.Sh NAME
.Nm slmctl
.Nd
.Tn SLASH2 MDS
daemon runtime control
.Sh SYNOPSIS
.Nm slmctl
.Op Fl HIn
.Op Fl p Ar paramspec
.Op Fl S Ar socket
.Op Fl s Ar showspec
.Op Ar cmd arg ...
.Sh DESCRIPTION
The
.Nm
utility examines and manipulates
.Xr slashd 8
behavior.
.Pp
.\" %PFL_INCLUDE $PFL_BASE/doc/pflctl/cmd.mdoc {
.\"	cmds => {
.\"		stop => <<'EOF'
.\"			Instruct
.\"			.Xr slashd 8
.\"			to completely terminate daemon execution.
.\"		EOF
.\"	}
The supported commands are as follows:
.Bl -tag -width 3n
.It Cm stop
Instruct
.Xr slashd 8
to completely terminate daemon execution.
.El
.\" }%
.Pp
The options are as follows:
.Bl -tag -width 3n
.\" %PFL_INCLUDE $PFL_BASE/doc/pflctl/H.mdoc {
.It Fl H
Suppress headers when showing data displays.
.\" }%
.\" %PFL_INCLUDE $PFL_BASE/doc/pflctl/I.mdoc {
.It Fl I
Display large numerical values accurately instead of rounded with
postfixes of demonination such as
.Sq G
for gibibytes,
.Sq M
for mebibytes, etc.\&
.Pq Do inhuman Dc number mode .
.\" }%
.\" %PFL_INCLUDE $PFL_BASE/doc/pflctl/n.mdoc {
.It Fl n
Suppress
.Tn DNS
lookups for network addresses.
.\" }%
.\" %PFL_INCLUDE $PFL_BASE/doc/pflctl/p.mdoc {
.\"	log_xr => "in\n.Xr slashd 8\n",
.\"	params => {
.\"		"namespace.stats" => "Communication statistics for\n.Tn MDS Ns -to- Ns Tn MDS\nnamespace updates.",
.\"		nextfid => "Next file identifier\n.Pq Tn FID\nthat will be used for new file creation.",
.\"		resources => <<EOF .
.\"			Settings and fields specific to network peers.
.\"			.Bl -tag -width 13n -offset 3n
.\"			EOF
.\"			build_list(
.\"				xid => <<EOF,
.\"					Highest journal transaction identifier peer has received
.\"					for either namespace metadata updates or garbage
.\"					reclamation updates.
.\"				EOF
.\"				disable_bia => <<EOF,
.\"					Whether bmap write lease assignments are administratively
.\"					disabled
.\"					.Pq ION only .
.\"					EOF
.\"				disable_gc => <<EOF,
.\"					Whether garbage collection and reclamation is administratively
.\"					disabled
.\"					.Pq ION only .
.\"					EOF
.\"			) . ".El",
.\"	}
.It Fl p Ar paramspec
Query/manipulate operational parameters.
.Ar paramspec
has the following format:
.Pp
.Bd -unfilled -offset 3n
.Sm off
.Oo Ar thread-name Ns Li .\& Oc Ar param
.Op Oo Li +- Oc Li = Ar value
.Sm on
.Ed
.Pp
Some parameters may be read- or write-only.
Some support modification by the assignment operators
.Li +=
and
.Li -= .
.Pp
See
.Sx Thread Specification
for details on specifying
.Ar thread-name .
The default behavior is to apply the operation to all applicable threads.
.Pp
.Ar param
may be one of the following:
.Bl -tag -width 1n -offset 3n
.It Cm lnet.networks
.Tn LNET
network configuration.
.It Cm lnet.port
If applicable,
.Xr tcp 7
port to use to connect to remote
.Tn LNET
peers.
.It Cm log.file
File path name where log messages will be written.
This value is write-only.
If the
.Li +=
assignment operator is used, this file will not be truncated.
.It Cm log.format
The header prepended to server log messages.
See the description of
.Ev PSC_LOG_FORMAT
in
.Xr slashd 8
for details on this format.
.It Cm log.level Ns Op . Ns Ar subsystem
The logging level of debug message output.
.Pp
See the description of
.Ev PSC_LOG_LEVEL_ Ns Ar subsys
in
.Xr slashd 8
for a list of available subsystems.
If
.Ar subsystem
is not specified, all subsystems will be accessed.
.Pp
See the description of
.Ev PSC_LOG_LEVEL
in
.Xr slashd 8
for recognized log level values.
.It Cm namespace.stats
Communication statistics for
.Tn MDS Ns -to- Ns Tn MDS
namespace updates.
.It Cm sys.nextfid
Next file identifier
.Pq Tn FID
that will be used for new file creation.
.It Cm sys.global
Turn on/off the global mount feature.
.It Cm pool. Ns Ar name
Access the memory pool specified by
.Ar name .
The following sub-fields are available:
.Pp
.Bl -tag -compact -offset 3n -width 13n
.It Cm max
Upper bound for number of entries to which auto-sized pools can grow.
.It Cm min
Lower bound for number of entries to which auto-sized pools can shrink.
.It Cm thres
Threshold for unused items for auto-sized pools before items are freed.
.It Cm total
Current number of entries contained in pool.
.El
.It Cm resources
Settings and fields specific to network peers.
.Bl -tag -width 13n -offset 3n
.It Cm disable_bia
Whether bmap write lease assignments are administratively
disabled
.Pq ION only .
.It Cm disable_gc
Whether garbage collection and reclamation is administratively
disabled
.Pq ION only .
.It Cm xid
Highest journal transaction identifier peer has received
for either namespace metadata updates or garbage
reclamation updates.
.El
.It Cm rlim
Process resource limits.
See
.Xr getrlimit 2
or
.Xr ulimit 1
for more information.
.Pp
.Bl -tag -compact -offset 3n -width 13n
.It Cm nofiles
Corresponds to
.Dv RLIMIT_NOFILE ,
the maximum number of open files.
.El
.El
.\" }%
.\" %PFL_INCLUDE $PFL_BASE/doc/pflctl/S.mdoc {
.\"	daemon	=> qq{slashd},
.\"	sock	=> "/var/run/slashd. Ns Ic %h Ns Pa .sock"
.It Fl S Ar socket
Specify an alternative socket file.
The following tokens are replaced in the file name specified:
.Pp
.Bl -tag -offset 3n -width Ds -compact
.It Cm %h
the machine hostname
.It Cm %n
the daemon executable base name, i.e.\&
.Dq slashd
.It Cm %%
a literal
.Sq %
character
.El
.Pp
The default is
.Pa /var/run/slashd. Ns Ic %h Ns Pa .sock .
.\" }%
.\" %PFL_INCLUDE $PFL_BASE/doc/pflctl/show.mdoc {
.\"	show => {
.\"		bmap		=> qq{In-memory bmaps},
.\"		bml		=> qq{Outstanding bmap leases.},
.\"		connections	=> qq{Status of\n.Tn SLASH2\npeers on network.},
.\"		fidcache	=> qq{.Tn FID\n.Pq file- Ns Tn ID\ncache members.},
.\"		odtables	=> qq{Disk-backed data files.},
.\"		replpairs	=> qq{Replica endpoint traffic.},
.\"		statfs		=> qq{.Tn I/O\nnode backing file system statistics.},
.\"	},
.\"	hashtables => {
.\"		fidc		=> qq{files\n.Po file\n.Tn ID\ncache\n.Pc},
.\"		resnid		=> qq{network resources\n.Pq network Tn ID},
.\"	},
.\"	iostats => {
.\"		qq{jrnlrd- Ns Ar fn ,} => "",
.\"		qq{jrnlwr- Ns Ar fn} =>
.\"		    qq{Data read/written to journal disk file\n.Ar fn .\n.Pp},
.\"	},
.\"	meters => {
.\"		qq{nsupd- Ns Ar peer}	=> qq{Namespace updates to\n.Tn MDS\npeers.},
.\"		qq{reclaim- Ns Ar peer}	=> qq{Garbage collection updates to\n.Tn IO\nsystems.},
.\"	},
.\"	journals => {
.\"		qq{op-journal}	=> qq{Pending operation journal},
.\"	},
.\"	listcaches => {
.\"		fcmhbusy	=> "Files with pending activity e.g.\\&\n.Tn I/O",
.\"		fcmhidle	=> "Clean\n.Pq reapable\nfiles",
.\"		inflightbml	=> "Active bmap lease mode updates",
.\"		pendingbml	=> "Pending bmap lease mode updates",
.\"		replstwkq	=> "Replication status work buffers",
.\"	},
.\"	pools => {
.\"		bmap		=> qq{Block map structures},
.\"	}
.It Fl s Ar showspec
Show values.
.Ar showspec
has the following format:
.Bd -unfilled -offset 3n
.Sm off
.Ar param
.Op : Ar subspec
.Sm on
.Ed
.Pp
.Ar param
may be specified as any non-ambiguous prefix abbreviation of the
following:
.Pp
.Bl -tag -width 1n -offset 3n
.It Cm bmap
In-memory bmaps
.It Cm bml
Outstanding bmap leases.
.It Cm connections
Status of
.Tn SLASH2
peers on network.
.It Cm fidcache
.Tn FID
.Pq file- Ns Tn ID
cache members.
.It Cm hashtables
Hash table statistics.
.Ar subspec
has the following format:
.Bd -unfilled -offset 3n
.Ar hash-table Ns Op , Ns Ar ...
.Ed
.Pp
.Ar hash-table
may be one of the following:
.Pp
.Bl -tag -compact -offset 3n -width 13n
.It Cm fidc
files
.Po file
.Tn ID
cache
.Pc
.It Cm resnid
network resources
.Pq network Tn ID
.El
.Pp
If
.Ar subspec
is left unspecified, all hash tables will be accessed.
.It Cm iostats
.Tn I/O
statistics.
.Ar subspec
has the following format:
.Pp
.Bd -unfilled -offset 3n
.Ar iostats Ns Op , Ns Ar ...
.Ed
.Pp
.Ar iostats
may be one of the following:
.Pp
.Bl -tag -compact -offset 3n -width 3n
.It Cm jrnlrd- Ns Ar fn ,
.It Cm jrnlwr- Ns Ar fn
Data read/written to journal disk file
.Ar fn .
.Pp
.It Cm lni-rcv- Ns Ar if ,
.It Cm lni-snd- Ns Ar if
Data sent/received per
.Tn LNET
networking interface.
.Pp
.It Cm lusklnd- Ns Ar mode Ns Cm -rcv ,
.It Cm lusklnd- Ns Ar mode Ns Cm -snd
Data sent/received over userland socket networking device.
.Ar mode
may be
.Cm pasv
.Pq passive
or
.Cm aggr
.Pq aggregate .
.Pp
.It Cm rpc- Ns Ar addr Ns Cm -rcv ,
.It Cm rpc- Ns Ar addr Ns Cm -snd
Data sent/received per
.Tn RPC
peer.
.Pp
.El
.Pp
If
.Ar subspec
is left unspecified, all
.Tn I/O
statistics will be accessed.
.It Cm journals
Journal statistics.
.Ar subspec
has the following format:
.Pp
.Bd -unfilled -offset 3n
.Ar journal Ns Op , Ns Ar ...
.Ed
.Pp
.Ar journal
may be one of the following:
.Pp
.Bl -tag -compact -offset 3n -width 13n
.It Cm op-journal
Pending operation journal
.El
.Pp
If
.Ar subspec
is left unspecified, all journals will be accessed.
.It Cm listcaches
List cache statistics.
.Ar subspec
has the following format:
.Pp
.Bd -unfilled -offset 3n
.Ar list Ns Op , Ns Ar ...
.Ed
.Pp
.Ar list
may be one of the following:
.Pp
.Bl -tag -compact -offset 3n -width 13n
.It Cm fcmhbusy
Files with pending activity e.g.\&
.Tn I/O
.It Cm fcmhidle
Clean
.Pq reapable
files
.It Cm inflightbml
Active bmap lease mode updates
.It Cm pendingbml
Pending bmap lease mode updates
.It Cm replstwkq
Replication status work buffers
.El
.Pp
If
.Ar subspec
is left unspecified, all list caches will be accessed.
.It Cm lni
Lustre network interfaces.
.It Cm loglevels
Thread logging levels.
.Ar subspec
has the following format:
.Bd -unfilled -offset 3n
.Ar thread Ns Op , Ns Ar ...
.Ed
.Pp
See
.Sx Thread Specification
for details on specifying
.Ar thread .
If
.Ar subspec
is left unspecified, all threads will be accessed.
.It Cm meters
Report on ongoing operations in progress meters.
.Ar subspec
has the following format:
.Bd -unfilled -offset 3n
.Ar meter Ns Op , Ns Ar ...
.Ed
.Pp
.Ar meter
may be one of the following:
.Pp
.Bl -tag -compact -offset 3n -width 13n
.It Cm nsupd- Ns Ar peer
Namespace updates to
.Tn MDS
peers.
.It Cm reclaim- Ns Ar peer
Garbage collection updates to
.Tn IO
systems.
.El
.Pp
If
.Ar subspec
is left unspecified, all ongoing operations will be reported.
.It Cm odtables
Disk-backed data files.
.It Cm pools
Memory pool statistics.
.Ar subspec
has the following format:
.Bd -unfilled -offset 3n
.Ar pool Ns Op , Ns Ar ...
.Ed
.Pp
.Ar pool
may be one of the following:
.Pp
.Bl -tag -compact -offset 3n -width 13n
.It Cm bmap
Block map structures
.El
.Pp
If
.Ar subspec
is left unspecified, all pools will be accessed.
.It Cm replpairs
Replica endpoint traffic.
.It Cm rpcsvcs
.Tn RPC
services.
.It Cm statfs
.Tn I/O
node backing file system statistics.
.It Cm threads
Daemon thread activity and statistics.
.Ar subspec
has the following format:
.Bd -unfilled -offset 3n
.Ar thread Ns Op , Ns Ar ...
.Ed
.Pp
See
.Sx Thread Specification
for details on specifying
.Ar thread .
If
.Ar subspec
is left unspecified, all threads will be accessed.
.El
.Pp
The special value
.Sq \&?
may also be specified to display a list of recognized values.
.\" }%
.El
.\" %PFL_INCLUDE $PFL_BASE/doc/pflctl/thr.mdoc {
.\"	thrs => {
.\"		"slmbchrqthr"			=> "Batch\n.Tn RPC\ntimeout monitor",
.\"		"slmbkdbthr"			=> "",
.\"		"slmbmaptimeothr"		=> "Bmap lease timeout monitor",
.\"		"slmconnthr"			=> "Peer resource connection monitor",
.\"		"slmctlacthr"			=> ".Nm\nconnection acceptor",
.\"		"slmctlthr"			=> ".Nm\nconnection processor",
.\"		"slmdbwkthr"			=> "",
.\"		"slmjcursorthr"			=> "Journal cursor updater thread",
.\"		"slmjnsthr"			=> "Peer\n.Pq Tn MDS\nnamespace updater",
.\"		"slmjreclaimthr"		=> "Peer\n.Pq Tn IOS\ngarbage collection notifier",
.\"		"slmjthr"			=> "Master journal thread",
.\"		"slmlnacthr- Ns Ar %s"		=> ".Tn LNET\nnetwork acceptor thread",
.\"		"slmnbrqthr"			=> "Non-blocking\n.Tn RPC\nreply handler",
.\"		"slmrcmthr"			=> "Client\n.Tn RPC\nrequest initiator thread",
.\"		"slmrmcthr Ns Ar %02d"		=> "Client\n.Tn RPC\nrequest service thread",
.\"		"slmrmithr Ns Ar %02d"		=> ".Tn I/O\nnode\n.Tn RPC\nrequest service thread",
.\"		"slmrmmthr Ns Ar %02d"		=> ".No Inter- Ns MDS RPC\nrequest service thread",
.\"		"slmtiosthr"			=> "Timed\n.Tn I/O\nstats updater thread",
.\"		"slmupschedthr"			=> "Peer update scheduler thread",
.\"		"slmusklndplthr Ns Ar %d"	=> ".Tn LNET\nuserland socket poll thread",
.\"		"slmwkthr Ns Ar %d"		=> "Generic worker",
.\"		"slmzfskstatmthr"		=> ".Tn ZFS\nstat mount thread",
.\"	}
.Ss Thread Specification
Options which take
.Ar thread-name
parameters may be specified by one or more of the following tokens,
separated by commas:
.Pp
.Bl -tag -compact -offset 3n -width 16n
.It Cm slmbchrqthr
Batch
.Tn RPC
timeout monitor
.It Cm slmbkdbthr
.It Cm slmbmaptimeothr
Bmap lease timeout monitor
.It Cm slmconnthr
Peer resource connection monitor
.It Cm slmctlacthr
.Nm
connection acceptor
.It Cm slmctlthr
.Nm
connection processor
.It Cm slmdbwkthr
.It Cm slmjcursorthr
Journal cursor updater thread
.It Cm slmjnsthr
Peer
.Pq Tn MDS
namespace updater
.It Cm slmjreclaimthr
Peer
.Pq Tn IOS
garbage collection notifier
.It Cm slmjthr
Master journal thread
.It Cm slmlnacthr- Ns Ar %s
.Tn LNET
network acceptor thread
.It Cm slmnbrqthr
Non-blocking
.Tn RPC
reply handler
.It Cm slmrcmthr
Client
.Tn RPC
request initiator thread
.It Cm slmrmcthr Ns Ar %02d
Client
.Tn RPC
request service thread
.It Cm slmrmithr Ns Ar %02d
.Tn I/O
node
.Tn RPC
request service thread
.It Cm slmrmmthr Ns Ar %02d
.No Inter- Ns MDS RPC
request service thread
.It Cm slmtiosthr
Timed
.Tn I/O
stats updater thread
.It Cm slmupschedthr
Peer update scheduler thread
.It Cm slmusklndplthr Ns Ar %d
.Tn LNET
userland socket poll thread
.It Cm slmwkthr Ns Ar %d
Generic worker
.It Cm slmzfskstatmthr
.Tn ZFS
stat mount thread
.It Cm everyone
All threads
.Pq default, where applicable
.El
.\" }%
.\" %PFL_INCLUDE $PFL_BASE/doc/env.mdoc {
.Sh ENVIRONMENT
.Bl -tag -width 3n
.It Ev CTL_SOCK_FILE
Override the default control socket file path.
.El
.\" }%
.Sh FILES
.Bl -tag -width Pa
.It Xo
.Pa /var/run/slashd. Ns Ic %h Ns Pa .sock
.Xc
default
.Xr slashd 8
control socket
.El
.Sh SEE ALSO
.Xr sladm 7 ,
.Xr slashd 8 ,
.Xr slictl 8

{'fraction_non_alphanumeric': 0.12397073778827543, 'fraction_numerical': 0.008299708033986157, 'mean_word_length': 2.9278443499549027, 'pattern_counts': {'":': 0, '<': 25, '<?xml version=': 0, '>': 129, 'https://': 2, 'lorem ipsum': 0, 'www.': 6, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '1149854', 'n_tokens_mistral': 12373, 'n_tokens_neox': 11480, 'n_words': 4399}