227 lines · plain
1What: /sys/bus/pci/devices/<BDF>/qat_rl/sla_op2Date: January 20243KernelVersion: 6.74Contact: qat-linux@intel.com5Description:6 (WO) This attribute is used to perform an operation on an SLA.7 The supported operations are: add, update, rm, rm_all, and get.8 9 Input values must be filled through the associated attribute in10 this group before a write to this file.11 If the operation completes successfully, the associated12 attributes will be updated.13 The associated attributes are: cir, pir, srv, rp, and id.14 15 Supported operations:16 17 * add: Creates a new SLA with the provided inputs from user.18 * Inputs: cir, pir, srv, and rp19 * Output: id20 21 * get: Returns the configuration of the specified SLA in id attribute22 * Inputs: id23 * Outputs: cir, pir, srv, and rp24 25 * update: Updates the SLA with new values set in the following attributes26 * Inputs: id, cir, and pir27 28 * rm: Removes the specified SLA in the id attribute.29 * Inputs: id30 31 * rm_all: Removes all the configured SLAs.32 * Inputs: None33 34 This attribute is only available for qat_4xxx devices.35 36What: /sys/bus/pci/devices/<BDF>/qat_rl/rp37Date: January 202438KernelVersion: 6.739Contact: qat-linux@intel.com40Description:41 (RW) When read, reports the current assigned ring pairs for the42 queried SLA.43 When wrote to, configures the ring pairs associated to a new SLA.44 45 The value is a 64-bit bit mask and is written/displayed in hex.46 Each bit of this mask represents a single ring pair i.e.,47 bit 1 == ring pair id 0; bit 3 == ring pair id 2.48 49 Selected ring pairs must to be assigned to a single service,50 i.e. the one provided with the srv attribute. The service51 assigned to a certain ring pair can be checked by querying52 the attribute qat/rp2srv.53 54 The maximum number of ring pairs is 4 per SLA.55 56 Applicability in sla_op:57 58 * WRITE: add operation59 * READ: get operation60 61 Example usage::62 63 ## Read64 # echo 4 > /sys/bus/pci/devices/<BDF>/qat_rl/id65 # cat /sys/bus/pci/devices/<BDF>/qat_rl/rp66 0x567 68 ## Write69 # echo 0x5 > /sys/bus/pci/devices/<BDF>/qat_rl/rp70 71 This attribute is only available for qat_4xxx devices.72 73What: /sys/bus/pci/devices/<BDF>/qat_rl/id74Date: January 202475KernelVersion: 6.776Contact: qat-linux@intel.com77Description:78 (RW) If written to, the value is used to retrieve a particular79 SLA and operate on it.80 This is valid only for the following operations: update, rm,81 and get.82 A read of this attribute is only guaranteed to have correct data83 after creation of an SLA.84 85 Applicability in sla_op:86 87 * WRITE: rm and update operations88 * READ: add and get operations89 90 Example usage::91 92 ## Read93 ## Set attributes e.g. cir, pir, srv, etc94 # echo "add" > /sys/bus/pci/devices/<BDF>/qat_rl/sla_op95 # cat /sys/bus/pci/devices/<BDF>/qat_rl/id96 497 98 ## Write99 # echo 7 > /sys/bus/pci/devices/<BDF>/qat_rl/id100 # echo "get" > /sys/bus/pci/devices/<BDF>/qat_rl/sla_op101 # cat /sys/bus/pci/devices/<BDF>/qat_rl/rp102 0x5 ## ring pair ID 0 and ring pair ID 2103 104 This attribute is only available for qat_4xxx devices.105 106What: /sys/bus/pci/devices/<BDF>/qat_rl/cir107Date: January 2024108KernelVersion: 6.7109Contact: qat-linux@intel.com110Description:111 (RW) Committed information rate (CIR). Rate guaranteed to be112 achieved by a particular SLA. The value is expressed in113 permille scale, i.e. 1000 refers to the maximum device114 throughput for a selected service.115 116 After sending a "get" to sla_op, this will be populated with the117 CIR for that queried SLA.118 Write to this file before sending an "add/update" sla_op, to set119 the SLA to the specified value.120 121 Applicability in sla_op:122 123 * WRITE: add and update operations124 * READ: get operation125 126 Example usage::127 128 ## Write129 # echo 500 > /sys/bus/pci/devices/<BDF>/qat_rl/cir130 # echo "add" /sys/bus/pci/devices/<BDF>/qat_rl/sla_op131 132 ## Read133 # echo 4 > /sys/bus/pci/devices/<BDF>/qat_rl/id134 # echo "get" > /sys/bus/pci/devices/<BDF>/qat_rl/sla_op135 # cat /sys/bus/pci/devices/<BDF>/qat_rl/cir136 500137 138 This attribute is only available for qat_4xxx devices.139 140What: /sys/bus/pci/devices/<BDF>/qat_rl/pir141Date: January 2024142KernelVersion: 6.7143Contact: qat-linux@intel.com144Description:145 (RW) Peak information rate (PIR). The maximum rate that can be146 achieved by that particular SLA. An SLA can reach a value147 between CIR and PIR when the device is not fully utilized by148 requests from other users (assigned to different SLAs).149 150 After sending a "get" to sla_op, this will be populated with the151 PIR for that queried SLA.152 Write to this file before sending an "add/update" sla_op, to set153 the SLA to the specified value.154 155 Applicability in sla_op:156 157 * WRITE: add and update operations158 * READ: get operation159 160 Example usage::161 162 ## Write163 # echo 750 > /sys/bus/pci/devices/<BDF>/qat_rl/pir164 # echo "add" > /sys/bus/pci/devices/<BDF>/qat_rl/sla_op165 166 ## Read167 # echo 4 > /sys/bus/pci/devices/<BDF>/qat_rl/id168 # echo "get" > /sys/bus/pci/devices/<BDF>/qat_rl/sla_op169 # cat /sys/bus/pci/devices/<BDF>/qat_rl/pir170 750171 172 This attribute is only available for qat_4xxx devices.173 174What: /sys/bus/pci/devices/<BDF>/qat_rl/srv175Date: January 2024176KernelVersion: 6.7177Contact: qat-linux@intel.com178Description:179 (RW) Service (SRV). Represents the service (sym, asym, dc)180 associated to an SLA.181 Can be written to or queried to set/show the SRV type for an SLA.182 The SRV attribute is used to specify the SRV type before adding183 an SLA. After an SLA is configured, reports the service184 associated to that SLA.185 186 Applicability in sla_op:187 188 * WRITE: add and update operations189 * READ: get operation190 191 Example usage::192 193 ## Write194 # echo "dc" > /sys/bus/pci/devices/<BDF>/qat_rl/srv195 # echo "add" > /sys/bus/pci/devices/<BDF>/qat_rl/sla_op196 # cat /sys/bus/pci/devices/<BDF>/qat_rl/id197 4198 199 ## Read200 # echo 4 > /sys/bus/pci/devices/<BDF>/qat_rl/id201 # echo "get" > /sys/bus/pci/devices/<BDF>/qat_rl/sla_op202 # cat /sys/bus/pci/devices/<BDF>/qat_rl/srv203 dc204 205 This attribute is only available for qat_4xxx devices.206 207What: /sys/bus/pci/devices/<BDF>/qat_rl/cap_rem208Date: January 2024209KernelVersion: 6.7210Contact: qat-linux@intel.com211Description:212 (RW) This file will return the remaining capability for a213 particular service/sla. This is the remaining value that a new214 SLA can be set to or a current SLA can be increased with.215 216 Example usage::217 218 # echo "asym" > /sys/bus/pci/devices/<BDF>/qat_rl/cap_rem219 # cat /sys/bus/pci/devices/<BDF>/qat_rl/cap_rem220 250221 # echo 250 > /sys/bus/pci/devices/<BDF>/qat_rl/cir222 # echo "add" > /sys/bus/pci/devices/<BDF>/qat_rl/sla_op223 # cat /sys/bus/pci/devices/<BDF>/qat_rl/cap_rem224 0225 226 This attribute is only available for qat_4xxx devices.227