| ACCEL-CONFIG CONFIG(1) | accfg Manual | ACCEL-CONFIG CONFIG(1) |
NAME¶
accel-config-config-wq - configure individual attributes of a work queue
SYNOPSIS¶
accel-config config-wq <device name>/<wq name> [<options>]
EXAMPLE¶
accel-config config-wq dsa0/wq0.0 --wq-size=16
OPTIONS¶
-g, --group-id=
specify the group id used by work queue, group id should
be between 0 and the maximum number of groups per device. A group id of -1
disassociates the work queue from a group.
-s, --wq-size=
specify work queue size used by a work queue. The wq-size
should be between 0 and the maximum workqueue size exposed by the device in
the max_work_queue_size attribute under device.
-p, --priority
specify the priority of this work queue relative to other
work queues in the same group. This field ranges from 1 to 15 where the larger
value means higher priority. For example, if wq1 has a priority of 6 and wq2
has priority of 2, wq1 will issue 3 times as many descriptors to the engine
compare to wq2.
-b, --block-on-fault
toggle block on fault enable for the work queue.
block-on-fault should be either 0 or 1. If block on fault is disabled, if a
page fault occurs on a source or destination memory access, the operation
stops and the page fault is reported to the software.
-t, --threshold
configure the threshold for the wq. The set up threshold
value should be larger than 0 and only for "shared" wq, and note
that the configured threshold value should be at least 1 less than the
configured wq-size value. The reason is threshold is set for unprivileged
users, and need to reserve at least 1 space for the privileged user for
commands.
-y, --type
configure the type for the wq. The wq type can be
"kernel" for kernel user case to request wq or "user" for
regular character device driver use case to wq.
-n, --name
configure the name for the wq. This can be any string
defined by the user. Typically it is used for identifying the wq in some
unique way. A possible suggestion would be using a uuid string.
-d, --driver-name
specify the name of the driver to bind. This should be
one of the valid wq drivers found in /sys/bus/dsa/drivers
-o, --op-config
specify the op config bitmask. The bitmask is of size 256
bits and entered as 32 bit hex words separated by comma or space. e.g.
00000000,00000000,00000000,00000000,00000000,00000000,00fc00ff,003f03ff
-m, --mode
configure the mode for the wq. The wq mode can be set as
"dedicated" or "shared".
-c, --max-batch-size
specify the max batch size used by a work queue. The
value should be between 1 and the device maximum batch size found in the
max_batch_size attribute under device. If the value is not a power of 2, it
will be rounded up to the next power of 2.
-x, --max-transfer-size
specify the max transfer size used by a work queue. The
value should be between 1 and the device maximum transfer size found in the
max_transfer_size attribute under device. If the value is not a power of 2, it
will be rounded up to the next power of 2.
-a, --ats-disable
toggle whether ATS disable is turned on for the work
queue. The value should be either 0 or 1. 0 indicates ATS is on, and 1
indicates ATS is off for the work queue.
-r, --prs-disable
toggle whether PRS disable is turned on for the work
queue. The value should be either 0 or 1. 0 indicates PRS is on, and 1
indicates PRS is off for the work queue.
COPYRIGHT¶
Copyright (c) 2023 - 2026, Intel Corporation. License GPLv2: GNU GPL version 2 http://gnu.org/licenses/gpl.html. This is free software: you are free to change and redistribute it. There is NO WARRANTY, to the extent permitted by law.
| 01/17/2024 | accfg 4.1.3 |