Documentation/sound/designs/control-names.rst

Source file repositories/reference/linux-study-clean/Documentation/sound/designs/control-names.rst

File Facts

System: Linux kernel
Corpus path: Documentation/sound/designs/control-names.rst
Extension: .rst
Size: 3873 bytes
Lines: 143
Domain: Support Tooling And Documentation
Bucket: Documentation
Inferred role: Support Tooling And Documentation: documentation
Status: atlas-only

Why This File Exists

Repository support layer: documentation, build tooling, samples, user-space helper tools, generated initramfs support, licenses, and validation utilities.

Repository support layer: documentation, build tooling, samples, user-space helper tools, generated initramfs support, licenses, and validation utilities.

Dependency Surface

No C-style include directives detected by the generator.

Detected Declarations

No top-level syscall, struct, function, initcall, or export declaration detected by the generator.

Annotated Snippet

===========================
Standard ALSA Control Names
===========================

This document describes standard names of mixer controls.

Standard Syntax
---------------
Syntax: [LOCATION] SOURCE [CHANNEL] [DIRECTION] FUNCTION


DIRECTION
~~~~~~~~~
================	===============
<nothing>		both directions
Playback		one direction
Capture			one direction
Bypass Playback		one direction
Bypass Capture		one direction
================	===============

FUNCTION
~~~~~~~~
========	=================================
Switch		on/off switch
Volume		amplifier
Route		route control, hardware specific
========	=================================

CHANNEL
~~~~~~~
============	==================================================
<nothing>	channel independent, or applies to all channels
Front		front left/right channels
Surround	rear left/right in 4.0/5.1 surround
CLFE		C/LFE channels
Center		center channel
LFE		LFE channel
Side		side left/right for 7.1 surround
============	==================================================

LOCATION (Physical location of source)
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
============	=====================
Front		front position
Rear		rear position
Dock		on docking station
Internal	internal
============	=====================

SOURCE
~~~~~~
===================	=================================================
Master
Master Mono
Hardware Master
Speaker			internal speaker
Bass Speaker		internal LFE speaker
Headphone
Line Out
Beep			beep generator
Phone
Phone Input
Phone Output
Synth
FM
Mic
Headset Mic		mic part of combined headset jack - 4-pin
			headphone + mic
Headphone Mic		mic part of either/or - 3-pin headphone or mic

Annotation

Atlas domain: Support Tooling And Documentation / Documentation.
Implementation status: atlas-only.

Implementation Notes

This generated page is the file-by-file coverage layer; curated subsystem chapters should link here when they synthesize a multi-file control flow.
Core OS pages should be promoted from atlas-only to deep-reviewed when they explain data structures, invariants, locking, lifecycle, and C implementation snippets.
Driver-family pages are intentionally pattern-oriented unless they are part of the selected PCIe/NVMe representative device path.