1What:		/sys/bus/pci/devices/<BDF>/qat/state
2Date:		June 2022
3KernelVersion:	5.20
4Contact:	qat-linux@intel.com
5Description:	Reports the current state of the QAT device and allows to
6		change it.
7
8		This attribute is RW.
9
10		Returned values:
11			up: the device is up and running
12			down: the device is down
13
14		Allowed values:
15			up: initialize and start the device
16			down: stop the device and bring it down
17
18		It is possible to transition the device from up to down only
19		if the device is up and vice versa.
20
21		This attribute is only available for qat_4xxx devices.
22
23What:		/sys/bus/pci/devices/<BDF>/qat/cfg_services
24Date:		June 2022
25KernelVersion:	5.20
26Contact:	qat-linux@intel.com
27Description:	Reports the current configuration of the QAT device and allows
28		to change it.
29
30		This attribute is RW.
31
32		Returned values:
33			sym;asym:	the device is configured for running
34					crypto services
35			dc:		the device is configured for running
36					compression services
37
38		Allowed values:
39			sym;asym:	configure the device for running
40					crypto services
41			dc:		configure the device for running
42					compression services
43
44		It is possible to set the configuration only if the device
45		is in the `down` state (see /sys/bus/pci/devices/<BDF>/qat/state)
46
47		The following example shows how to change the configuration of
48		a device configured for running crypto services in order to
49		run data compression:
50			# cat /sys/bus/pci/devices/<BDF>/qat/state
51			up
52			# cat /sys/bus/pci/devices/<BDF>/qat/cfg_services
53			sym;asym
54			# echo down > /sys/bus/pci/devices/<BDF>/qat/state
55			# echo dc > /sys/bus/pci/devices/<BDF>/qat/cfg_services
56			# echo up > /sys/bus/pci/devices/<BDF>/qat/state
57			# cat /sys/bus/pci/devices/<BDF>/qat/cfg_services
58			dc
59
60		This attribute is only available for qat_4xxx devices.
61