1ACCEL-CONFIG-CONFI(1) accfg Manual ACCEL-CONFIG-CONFI(1)
2
6 accel-config-config-wq - configure individual attributes of a work
7 queue
8
10 accel-config config-wq <device name>/<wq name> [<options>]
11
13 accel-config config-wq dsa0/wq0.0 --wq-size=16
14
16 -g, --group-id=
17 specify the group id used by work queue, group id should be between
18 0 and the maximum number of groups per device. A group id of -1
19 disassociates the work queue from a group.
20 -s, --wq-size=
22 specify work queue size used by a work queue. The wq-size should be
23 between 0 and the maximum workqueue size exposed by the device in
24 the max_work_queue_size attribute under device.
25 -p, --priority
27 specify the priority of this work queue relative to other work
28 queues in the same group. This field ranges from 1 to 15 where the
29 larger value means higher priority. For example, if wq1 has a
30 priority of 6 and wq2 has priority of 2, wq1 will issue 3 times as
31 many descriptors to the engine compare to wq2.
32 -b, --block-on-fault
34 toggle block on fault enable for the work queue. block-on-fault
35 should be either 0 or 1. If block on fault is disabled, if a page
36 fault occurs on a source or destination memory access, the
37 operation stops and the page fault is reported to the software.
38 -t, --threshold
40 configure the threshold for the wq. The set up threshold value
41 should be larger than 0 and only for "shared" wq, and note that the
42 configured threshold value should be at least 1 less than the
43 configured wq-size value. The reason is threshold is set for
44 unprivileged users, and need to reserve at least 1 space for the
45 privileged user for commands.
46 -y, --type
48 configure the type for the wq. The wq type can be "kernel" for
49 kernel user case to request wq or "user" for regular character
50 device driver use case to wq.
51 -n, --name
53 configure the name for the wq. This can be any string defined by
54 the user. Typically it is used for identifying the wq in some
55 unique way. A possible suggestion would be using a uuid string.
56 -d, --driver-name
58 specify the name of the driver to bind. This should be one of the
59 valid wq drivers found in /sys/bus/dsa/drivers
60 -o, --op-config
62 specify the op config bitmask. The bitmask is of size 256 bits and
63 entered as 32 bit hex words separated by comma or space. e.g.
64 00000000,00000000,00000000,00000000,00000000,00000000,00fc00ff,003f03ff
65 -m, --mode
67 configure the mode for the wq. The wq mode can be set as
68 "dedicated" or "shared".
69 -c, --max-batch-size
71 specify the max batch size used by a work queue. The value should
72 be between 1 and the device maximum batch size found in the
73 max_batch_size attribute under device. If the value is not a power
74 of 2, it will be rounded up to the next power of 2.
75 -x, --max-transfer-size
77 specify the max transfer size used by a work queue. The value
78 should be between 1 and the device maximum transfer size found in
79 the max_transfer_size attribute under device. If the value is not a
80 power of 2, it will be rounded up to the next power of 2.
81 -a, --ats-disable
83 toggle whether ATS disable is turned on for the work queue. The
84 value should be either 0 or 1. 0 indicates ATS is on, and 1
85 indicates ATS is off for the work queue.
86 -r, --prs-disable
88 toggle whether PRS disable is turned on for the work queue. The
89 value should be either 0 or 1. 0 indicates PRS is on, and 1
90 indicates PRS is off for the work queue.
91
93 Copyright (c) 2016 - 2019, Intel Corporation. License GPLv2: GNU GPL
94 version 2 http://gnu.org/licenses/gpl.html. This is free software: you
95 are free to change and redistribute it. There is NO WARRANTY, to the
96 extent permitted by law.
97accfg 4.0 07/19/2023 ACCEL-CONFIG-CONFI(1)