1ACCEL-CONFIG-CONFI(1)            accfg Manual            ACCEL-CONFIG-CONFI(1)
2
3
4

NAME

6       accel-config-config-wq - configure individual attributes of a work
7       queue
8

SYNOPSIS

10       accel-config config-wq <device name>/<wq name> [<options>]
11

EXAMPLE

13       accel-config config-wq dsa0/wq0.0 --wq-size=16
14

OPTIONS

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
21       -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
26       -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
33       -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
39       -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
47       -y, --type
48           configure the type for the wq. The wq type can be "kernel" for
49           kernel user case to request wq, "mdev" for mediated device driver
50           use case to request wq or "user" for regular character device
51           driver use case to wq.
52
53       -n, --name
54           configure the name for the wq. This can be any string defined by
55           the user. Typically it is used for identifying the wq in some
56           unique way. A possible suggestion would be using a uuid string.
57
58       -m, --mode
59           configure the mode for the wq. The wq mode can be set as
60           "dedicated" or "shared".
61
62       -c, --max-batch-size
63           specify the max batch size used by a work queue. The value should
64           be between 1 and the device maximum batch size found in the
65           max_batch_size attribute under device. If the value is not a power
66           of 2, it will be rounded up to the next power of 2.
67
68       -x, --max-transfer-size
69           specify the max transfer size used by a work queue. The value
70           should be between 1 and the device maximum transfer size found in
71           the max_transfer_size attribute under device. If the value is not a
72           power of 2, it will be rounded up to the next power of 2.
73
75       Copyright (c) 2016 - 2019, Intel Corporation. License GPLv2: GNU GPL
76       version 2 http://gnu.org/licenses/gpl.html. This is free software: you
77       are free to change and redistribute it. There is NO WARRANTY, to the
78       extent permitted by law.
79
80
81
82accfg 3.1                         03/29/2021             ACCEL-CONFIG-CONFI(1)
Impressum