Lines Matching +full:write +full:- +full:to +full:- +full:read

1 .\"-
2 .\" SPDX-License-Identifier: BSD-2-Clause
4 .\" Copyright (c) 2024-2025 The FreeBSD Foundation
19 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
23 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
44 utility is used to set and display sound card properties, using a
45 control-driven interface, in order to filter and/or set specific properties.
48 .Bl -tag -width "-f device"
65 .Bl -column xxxxxxxxxxxxxxx xxxxx xxxxxxxx xxxxxxxxxxxxxxxxxxx -offset indent
66 .It Sy Name Ta Sy Type Ta Sy Read/Write Ta Sy Action
67 .It name Ta String Ta Read Ta Device name
68 .It desc Ta String Ta Read Ta Device description
69 .It status Ta String Ta Read Ta Device status
70 .It devnode Ta String Ta Read Ta Device node
71 .It from_user Ta Boolean Ta Read Ta Userland device
72 .It unit Ta Number Ta Read Ta Device unit
73 .It caps Ta String Ta Read Ta Device OSS capabitilies
74 .It bitperfect Ta Boolean Ta Read/Write Ta Bit-perfect mode enabled
75 .It autoconv Ta Boolean Ta Read/Write Ta Auto-conversions enabled
76 .It realtime Ta Boolean Ta Read/Write Ta Real-time mode enabled
77 .It play Ta Group Ta Read Ta Playback properties
78 .It play.format Ta String Ta Read/Write Ta Playback format
79 .It play.rate Ta Number Ta Read/Write Ta Playback sample rate
80 .It play.vchans Ta Boolean Ta Read/Write Ta Playback VCHANs (virtual channels) enabled
81 .It play.min_rate Ta Number Ta Read Ta Minimum playback sample rate
82 .It play.max_rate Ta Number Ta Read Ta Maximum playback sample rate
83 .It play.min_chans Ta Number Ta Read Ta Natively supported minimum playback sample channels
84 .It play.max_chans Ta Number Ta Read Ta Natively supported maximum playback sample channels
85 .It play.formats Ta String Ta Read Ta Natively supported playback formats
86 .It rec Ta Group Ta Read Ta Recording properties
87 .It rec.format Ta String Ta Read/Write Ta Recording format
88 .It rec.rate Ta Number Ta Read/Write Ta Recording sample rate
89 .It rec.vchans Ta Boolean Ta Read/Write Ta Recording VCHANs (virtual channels) enabled
90 .It rec.min_rate Ta Number Ta Read Ta Minimum recording sample rate
91 .It rec.max_rate Ta Number Ta Read Ta Maximum recording sample rate
92 .It rec.min_chans Ta Number Ta Read Ta Natively supported minimum recording sample channels
93 .It rec.max_chans Ta Number Ta Read Ta Natively supported maximum recording sample channels
94 .It rec.formats Ta String Ta Read Ta Natively supported recording formats
102 controls will be read-only if VCHANs are disabled.
105 .Bl -column xxxxxxxxxxxxxxx xxxxx xxxxxxxx xxxxxxxxxxxxxxxxxxx -offset indent
106 .It Sy Name Ta Sy Type Ta Sy Read/Write Ta Sy Action
107 .It name Ta String Ta Read Ta Channel name
108 .It parentchan Ta String Ta Read Ta Parent (primary) channel name
109 .It unit Ta Number Ta Read Ta Channel unit
110 .It caps Ta String Ta Read Ta Channel OSS capabilities
111 .It latency Ta Number Ta Read Ta Channel latency
112 .It format Ta String Ta Read Ta Channel format
113 .It rate Ta Number Ta Read Ta Channel sample rate
114 .It pid Ta Number Ta Read Ta PID of process consuming channel
115 .It proc Ta String Ta Read Ta Name of process consuming channel
116 .It interrupts Ta Number Ta Read Ta Number of interrupts since channel was opened
117 .It xruns Ta Number Ta Read Ta Number of playback underruns/recoring overruns
118 .It feedcount Ta Number Ta Read Ta Number of bytes fed to channel
119 .It volume Ta Volume Ta Read Ta Channel left-right volume in normalized form (0.00 to 1.00).
120 .It hwbuf Ta Group Ta Read Ta Hardware buffer properties
121 .It hwbuf.format Ta String Ta Read Ta Hardware buffer format
122 .It hwbuf.rate Ta String Ta Read Ta Hardware buffer sample rate
123 .It hwbuf.size_bytes Ta Number Ta Read Ta Hardware buffer size in bytes
124 .It hwbuf.size_frames Ta Number Ta Read Ta Hardware buffer size in frames
125 .It hwbuf.blksz Ta Number Ta Read Ta Hardware buffer block size
126 .It hwbuf.blkcnt Ta Number Ta Read Ta Hardware buffer block count
127 .It hwbuf.free Ta Number Ta Read Ta Hardware buffer free space in bytes
128 .It hwbuf.ready Ta Number Ta Read Ta Hardware buffer ready space in bytes
129 .It swbuf Ta Group Ta Read Ta Software buffer properties
130 .It swbuf.format Ta String Ta Read Ta Software buffer format
131 .It swbuf.rate Ta String Ta Read Ta Software buffer sample rate
132 .It swbuf.size_bytes Ta Number Ta Read Ta Software buffer size in bytes
133 .It swbuf.size_frames Ta Number Ta Read Ta Software buffer size in frames
134 .It swbuf.blksz Ta Number Ta Read Ta Software buffer block size
135 .It swbuf.blkcnt Ta Number Ta Read Ta Software buffer block count
136 .It swbuf.free Ta Number Ta Read Ta Software buffer free space in bytes
137 .It swbuf.ready Ta Number Ta Read Ta Software buffer ready space in bytes
138 .It feederchain Ta String Ta Read Ta Channel feeder chain
141 .Bl -tag -width /dev/dspX -compact
149 Disable auto-conversions and enable realtime mode to get as low latencies as
151 .Bd -literal -offset indent
155 Set the playback sample format to 2-channel signed 24-bit low endian, and sample
156 rate to 48000 Hz:
157 .Bd -literal -offset indent
163 .Bd -literal -offset indent
164 $ sndctl -f /dev/dsp1 pid proc
169 information to a file and retrieve back later:
170 .Bd -literal -offset indent
171 $ sndctl -f /dev/dsp0 -o > info
173 $ sndctl -f /dev/dsp0 `cat info`