summaryrefslogblamecommitdiffstats
path: root/drivers/staging/lustre/sysfs-fs-lustre
blob: a99078c25d6a81e7b2fe255af8c8efcd3287d8a4 (plain) (tree)








































                                                                               





                                                                               



















                                                                                











                                                                       







                                                                          





                                                           





                                                         






                                                                       





                                                                                






                                                                            






                                                                                




















                                                                            















                                                                                







                                                                         













                                                                         






                                                                









                                                                             






                                                                              





                                                                     








                                                                              
 






                                                                         






                                                                           











                                                                             





























































                                                                             

















                                                                          






                                                                              















































                                                                              















                                                                            
What:		/sys/fs/lustre/version
Date:		May 2015
Contact:	"Oleg Drokin" <oleg.drokin@intel.com>
Description:
		Shows current running lustre version.

What:		/sys/fs/lustre/pinger
Date:		May 2015
Contact:	"Oleg Drokin" <oleg.drokin@intel.com>
Description:
		Shows if the lustre module has pinger support.
		"on" means yes and "off" means no.

What:		/sys/fs/lustre/health
Date:		May 2015
Contact:	"Oleg Drokin" <oleg.drokin@intel.com>
Description:
		Shows whenever current system state believed to be "healthy",
		"NOT HEALTHY", or "LBUG" whenever lustre has experienced
		an internal assertion failure

What:		/sys/fs/lustre/jobid_name
Date:		May 2015
Contact:	"Oleg Drokin" <oleg.drokin@intel.com>
Description:
		Currently running job "name" for this node to be transferred
		to Lustre servers for purposes of QoS and statistics gathering.
		Writing into this file will change the name, reading outputs
		currently set value.

What:		/sys/fs/lustre/jobid_var
Date:		May 2015
Contact:	"Oleg Drokin" <oleg.drokin@intel.com>
Description:
		Control file for lustre "jobstats" functionality, write new
		value from the list below to change the mode:
		disable - disable job name reporting to the servers (default)
		procname_uid - form the job name as the current running
			       command name and pid with a dot in between
			       e.g. dd.1253
		nodelocal - use jobid_name value from above.

What:		/sys/fs/lustre/llite/<fsname>-<uuid>/blocksize
Date:		May 2015
Contact:	"Oleg Drokin" <oleg.drokin@intel.com>
Description:
		Biggest blocksize on object storage server for this filesystem.

What:		/sys/fs/lustre/llite/<fsname>-<uuid>/kbytestotal
Date:		May 2015
Contact:	"Oleg Drokin" <oleg.drokin@intel.com>
Description:
		Shows total number of kilobytes of space on this filesystem

What:		/sys/fs/lustre/llite/<fsname>-<uuid>/kbytesfree
Date:		May 2015
Contact:	"Oleg Drokin" <oleg.drokin@intel.com>
Description:
		Shows total number of free kilobytes of space on this filesystem

What:		/sys/fs/lustre/llite/<fsname>-<uuid>/kbytesavail
Date:		May 2015
Contact:	"Oleg Drokin" <oleg.drokin@intel.com>
Description:
		Shows total number of free kilobytes of space on this filesystem
		actually available for use (taking into account per-client
		grants and filesystem reservations).

What:		/sys/fs/lustre/llite/<fsname>-<uuid>/filestotal
Date:		May 2015
Contact:	"Oleg Drokin" <oleg.drokin@intel.com>
Description:
		Shows total number of inodes on the filesystem.

What:		/sys/fs/lustre/llite/<fsname>-<uuid>/filesfree
Date:		May 2015
Contact:	"Oleg Drokin" <oleg.drokin@intel.com>
Description:
		Shows estimated number of free inodes on the filesystem

What:		/sys/fs/lustre/llite/<fsname>-<uuid>/client_type
Date:		May 2015
Contact:	"Oleg Drokin" <oleg.drokin@intel.com>
Description:
		Shows whenever this filesystem considers this client to be
		compute cluster-local or remote. Remote clients have
		additional uid/gid convrting logic applied.

What:		/sys/fs/lustre/llite/<fsname>-<uuid>/fstype
Date:		May 2015
Contact:	"Oleg Drokin" <oleg.drokin@intel.com>
Description:
		Shows filesystem type of the filesystem

What:		/sys/fs/lustre/llite/<fsname>-<uuid>/uuid
Date:		May 2015
Contact:	"Oleg Drokin" <oleg.drokin@intel.com>
Description:
		Shows this filesystem superblock uuid

What:		/sys/fs/lustre/llite/<fsname>-<uuid>/max_read_ahead_mb
Date:		May 2015
Contact:	"Oleg Drokin" <oleg.drokin@intel.com>
Description:
		Sets maximum number of megabytes in system memory to be
		given to read-ahead cache.

What:		/sys/fs/lustre/llite/<fsname>-<uuid>/max_read_ahead_per_file_mb
Date:		May 2015
Contact:	"Oleg Drokin" <oleg.drokin@intel.com>
Description:
		Sets maximum number of megabytes to read-ahead for a single file

What:		/sys/fs/lustre/llite/<fsname>-<uuid>/max_read_ahead_whole_mb
Date:		May 2015
Contact:	"Oleg Drokin" <oleg.drokin@intel.com>
Description:
		For small reads, how many megabytes to actually request from
		the server as initial read-ahead.

What:		/sys/fs/lustre/llite/<fsname>-<uuid>/checksum_pages
Date:		May 2015
Contact:	"Oleg Drokin" <oleg.drokin@intel.com>
Description:
		Enables or disables per-page checksum at llite layer, before
		the pages are actually given to lower level for network transfer

What:		/sys/fs/lustre/llite/<fsname>-<uuid>/stats_track_pid
Date:		May 2015
Contact:	"Oleg Drokin" <oleg.drokin@intel.com>
Description:
		Limit Lustre vfs operations gathering to just a single pid.
		0 to track everything.

What:		/sys/fs/lustre/llite/<fsname>-<uuid>/stats_track_ppid
Date:		May 2015
Contact:	"Oleg Drokin" <oleg.drokin@intel.com>
Description:
		Limit Lustre vfs operations gathering to just a single ppid.
		0 to track everything.

What:		/sys/fs/lustre/llite/<fsname>-<uuid>/stats_track_gid
Date:		May 2015
Contact:	"Oleg Drokin" <oleg.drokin@intel.com>
Description:
		Limit Lustre vfs operations gathering to just a single gid.
		0 to track everything.

What:		/sys/fs/lustre/llite/<fsname>-<uuid>/statahead_max
Date:		May 2015
Contact:	"Oleg Drokin" <oleg.drokin@intel.com>
Description:
		Controls maximum number of statahead requests to send when
		sequential readdir+stat pattern is detected.

What:		/sys/fs/lustre/llite/<fsname>-<uuid>/statahead_agl
Date:		May 2015
Contact:	"Oleg Drokin" <oleg.drokin@intel.com>
Description:
		Controls if AGL (async glimpse ahead - obtain object information
		from OSTs in parallel with MDS during statahead) should be
		enabled or disabled.
		0 to disable, 1 to enable.

What:		/sys/fs/lustre/llite/<fsname>-<uuid>/lazystatfs
Date:		May 2015
Contact:	"Oleg Drokin" <oleg.drokin@intel.com>
Description:
		Controls statfs(2) behaviour in the face of down servers.
		If 0, always wait for all servers to come online,
		if 1, ignote inactive servers.

What:		/sys/fs/lustre/llite/<fsname>-<uuid>/max_easize
Date:		May 2015
Contact:	"Oleg Drokin" <oleg.drokin@intel.com>
Description:
		Shows maximum number of bytes file striping data could be
		in current configuration of storage.

What:		/sys/fs/lustre/llite/<fsname>-<uuid>/default_easize
Date:		May 2015
Contact:	"Oleg Drokin" <oleg.drokin@intel.com>
Description:
		Shows maximum observed file striping data seen by this
		filesystem client instance.

What:		/sys/fs/lustre/llite/<fsname>-<uuid>/xattr_cache
Date:		May 2015
Contact:	"Oleg Drokin" <oleg.drokin@intel.com>
Description:
		Controls extended attributes client-side cache.
		1 to enable, 0 to disable.

What:		/sys/fs/lustre/ldlm/cancel_unused_locks_before_replay
Date:		May 2015
Contact:	"Oleg Drokin" <oleg.drokin@intel.com>
Description:
		Controls if client should replay unused locks during recovery
		If a client tends to have a lot of unused locks in LRU,
		recovery times might become prolonged.
		1 - just locally cancel unused locks (default)
		0 - replay unused locks.

What:		/sys/fs/lustre/ldlm/namespaces/<name>/resource_count
Date:		May 2015
Contact:	"Oleg Drokin" <oleg.drokin@intel.com>
Description:
		Displays number of lock resources (objects on which individual
		locks are taken) currently allocated in this namespace.

What:		/sys/fs/lustre/ldlm/namespaces/<name>/lock_count
Date:		May 2015
Contact:	"Oleg Drokin" <oleg.drokin@intel.com>
Description:
		Displays number or locks allocated in this namespace.

What:		/sys/fs/lustre/ldlm/namespaces/<name>/lru_size
Date:		May 2015
Contact:	"Oleg Drokin" <oleg.drokin@intel.com>
Description:
		Controls and displays LRU size limit for unused locks for this
		namespace.
		0 - LRU size is unlimited, controlled by server resources
		positive number - number of locks to allow in lock LRU list

What:		/sys/fs/lustre/ldlm/namespaces/<name>/lock_unused_count
Date:		May 2015
Contact:	"Oleg Drokin" <oleg.drokin@intel.com>
Description:
		Display number of locks currently sitting in the LRU list
		of this namespace

What:		/sys/fs/lustre/ldlm/namespaces/<name>/lru_max_age
Date:		May 2015
Contact:	"Oleg Drokin" <oleg.drokin@intel.com>
Description:
		Maximum number of milliseconds a lock could sit in LRU list
		before client would voluntarily cancel it as unused.

What:		/sys/fs/lustre/ldlm/namespaces/<name>/early_lock_cancel
Date:		May 2015
Contact:	"Oleg Drokin" <oleg.drokin@intel.com>
Description:
		Controls "early lock cancellation" feature on this namespace
		if supported by the server.
		When enabled, tries to preemtively cancel locks that would be
		cancelled by verious operations and bundle the cancellation
		requests in the same RPC as the main operation, which results
		in significant speedups due to reduced lock-pingpong RPCs.
		0 - disabled
		1 - enabled (default)

What:		/sys/fs/lustre/ldlm/namespaces/<name>/pool/granted
Date:		May 2015
Contact:	"Oleg Drokin" <oleg.drokin@intel.com>
Description:
		Displays number of granted locks in this namespace

What:		/sys/fs/lustre/ldlm/namespaces/<name>/pool/grant_rate
Date:		May 2015
Contact:	"Oleg Drokin" <oleg.drokin@intel.com>
Description:
		Number of granted locks in this namespace during last
		time interval

What:		/sys/fs/lustre/ldlm/namespaces/<name>/pool/cancel_rate
Date:		May 2015
Contact:	"Oleg Drokin" <oleg.drokin@intel.com>
Description:
		Number of lock cancellations in this namespace during
		last time interval

What:		/sys/fs/lustre/ldlm/namespaces/<name>/pool/grant_speed
Date:		May 2015
Contact:	"Oleg Drokin" <oleg.drokin@intel.com>
Description:
		Calculated speed of lock granting (grant_rate - cancel_rate)
		in this namespace

What:		/sys/fs/lustre/ldlm/namespaces/<name>/pool/grant_plan
Date:		May 2015
Contact:	"Oleg Drokin" <oleg.drokin@intel.com>
Description:
		Estimated number of locks to be granted in the next time
		interval in this namespace

What:		/sys/fs/lustre/ldlm/namespaces/<name>/pool/limit
Date:		May 2015
Contact:	"Oleg Drokin" <oleg.drokin@intel.com>
Description:
		Controls number of allowed locks in this pool.
		When lru_size is 0, this is the actual limit then.

What:		/sys/fs/lustre/ldlm/namespaces/<name>/pool/lock_volume_factor
Date:		May 2015
Contact:	"Oleg Drokin" <oleg.drokin@intel.com>
Description:
		Multiplier for all lock volume calculations above.
		Default is 1. Increase to make the client to more agressively
		clean it's lock LRU list for this namespace.

What:		/sys/fs/lustre/ldlm/namespaces/<name>/pool/server_lock_volume
Date:		May 2015
Contact:	"Oleg Drokin" <oleg.drokin@intel.com>
Description:
		Calculated server lock volume.

What:		/sys/fs/lustre/ldlm/namespaces/<name>/pool/recalc_period
Date:		May 2015
Contact:	"Oleg Drokin" <oleg.drokin@intel.com>
Description:
		Controls length of time between recalculation of above
		values (in seconds).

What:		/sys/fs/lustre/ldlm/services/ldlm_cbd/threads_min
Date:		May 2015
Contact:	"Oleg Drokin" <oleg.drokin@intel.com>
Description:
		Controls minimum number of ldlm callback threads to start.

What:		/sys/fs/lustre/ldlm/services/ldlm_cbd/threads_max
Date:		May 2015
Contact:	"Oleg Drokin" <oleg.drokin@intel.com>
Description:
		Controls maximum number of ldlm callback threads to start.

What:		/sys/fs/lustre/ldlm/services/ldlm_cbd/threads_started
Date:		May 2015
Contact:	"Oleg Drokin" <oleg.drokin@intel.com>
Description:
		Shows actual number of ldlm callback threads running.

What:		/sys/fs/lustre/ldlm/services/ldlm_cbd/high_priority_ratio
Date:		May 2015
Contact:	"Oleg Drokin" <oleg.drokin@intel.com>
Description:
		Controls what percentage of ldlm callback threads is dedicated
		to "high priority" incoming requests.

What:		/sys/fs/lustre/{obdtype}/{connection_name}/blocksize
Date:		May 2015
Contact:	"Oleg Drokin" <oleg.drokin@intel.com>
Description:
		Blocksize on backend filesystem for service behind this obd
		device (or biggest blocksize for compound devices like lov
		and lmv)

What:		/sys/fs/lustre/{obdtype}/{connection_name}/kbytestotal
Date:		May 2015
Contact:	"Oleg Drokin" <oleg.drokin@intel.com>
Description:
		Total number of kilobytes of space on backend filesystem
		for service behind this obd (or total amount for compound
		devices like lov lmv)

What:		/sys/fs/lustre/{obdtype}/{connection_name}/kbytesfree
Date:		May 2015
Contact:	"Oleg Drokin" <oleg.drokin@intel.com>
Description:
		Number of free kilobytes on backend filesystem for service
		behind this obd (or total amount for compound devices
		like lov lmv)

What:		/sys/fs/lustre/{obdtype}/{connection_name}/kbytesavail
Date:		May 2015
Contact:	"Oleg Drokin" <oleg.drokin@intel.com>
Description:
		Number of kilobytes of free space on backend filesystem
		for service behind this obd (or total amount for compound
		devices like lov lmv) that is actually available for use
		(taking into account per-client and filesystem reservations).

What:		/sys/fs/lustre/{obdtype}/{connection_name}/filestotal
Date:		May 2015
Contact:	"Oleg Drokin" <oleg.drokin@intel.com>
Description:
		Number of inodes on backend filesystem for service behind this
		obd.

What:		/sys/fs/lustre/{obdtype}/{connection_name}/filesfree
Date:		May 2015
Contact:	"Oleg Drokin" <oleg.drokin@intel.com>
Description:
		Number of free inodes on backend filesystem for service
		behind this obd.

What:		/sys/fs/lustre/mdc/{connection_name}/max_pages_per_rpc
Date:		May 2015
Contact:	"Oleg Drokin" <oleg.drokin@intel.com>
Description:
		Maximum number of readdir pages to fit into a single readdir
		RPC.

What:		/sys/fs/lustre/mdc/{connection_name}/max_rpcs_in_flight
Date:		May 2015
Contact:	"Oleg Drokin" <oleg.drokin@intel.com>
Description:
		Maximum number of parallel RPCs on the wire to allow on
		this connection. Increasing this number would help on higher
		latency links, but has a chance of overloading a server
		if you have too many clients like this.
		Default: 8