From owner-dev-commits-doc-all@freebsd.org Fri Jun 25 07:35:50 2021 Return-Path: Delivered-To: dev-commits-doc-all@mailman.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.nyi.freebsd.org (Postfix) with ESMTP id D9E2365ABF7 for ; Fri, 25 Jun 2021 07:35:50 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "mxrelay.nyi.freebsd.org", Issuer "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4GB81f5vJ2z3NbF; Fri, 25 Jun 2021 07:35:50 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (Client did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id B2C7B27213; Fri, 25 Jun 2021 07:35:50 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.16.1/8.16.1) with ESMTP id 15P7ZofC088858; Fri, 25 Jun 2021 07:35:50 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 15P7ZoeF088857; Fri, 25 Jun 2021 07:35:50 GMT (envelope-from git) Date: Fri, 25 Jun 2021 07:35:50 GMT Message-Id: <202106250735.15P7ZoeF088857@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: =?utf-8?Q?Fernando Apestegu=C3=ADa?= Subject: git: 9f50b81142 - main - [handbook/multimedia] Add pulseaudio settings info MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: fernape X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 9f50b81142a006961672f25650dd77b8c020ca7a Auto-Submitted: auto-generated X-BeenThere: dev-commits-doc-all@freebsd.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: Commit messages for all branches of the doc repository List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 25 Jun 2021 07:35:50 -0000 The branch main has been updated by fernape: URL: https://cgit.FreeBSD.org/doc/commit/?id=9f50b81142a006961672f25650dd77b8c020ca7a commit 9f50b81142a006961672f25650dd77b8c020ca7a Author: Fernando Apesteguía AuthorDate: 2021-06-24 17:56:27 +0000 Commit: Fernando Apesteguía CommitDate: 2021-06-25 07:30:35 +0000 [handbook/multimedia] Add pulseaudio settings info Document that for applications using audio/pulseaudio, changing hw.snd.default_unit might require to restart the pulseaudio daemon. Document the use of pacmd(1) to change the default sink on the fly as an alternative. --- .../en/books/handbook/multimedia/_index.adoc | 28 ++++++++++++++++++++++ 1 file changed, 28 insertions(+) diff --git a/documentation/content/en/books/handbook/multimedia/_index.adoc b/documentation/content/en/books/handbook/multimedia/_index.adoc index dcd56eda90..cafcdb6f41 100644 --- a/documentation/content/en/books/handbook/multimedia/_index.adoc +++ b/documentation/content/en/books/handbook/multimedia/_index.adoc @@ -340,6 +340,34 @@ Make this change permanent by adding the following line to [.filename]#/etc/sysc hw.snd.default_unit=4 .... +Programs using package:audio/pulseaudio[] might need to restart the +package:audio/pulseaudio[] daemon for the changes in `hw.snd.default_unit` to +take effect. +Alternatively, package:audio/pulseaudio[] settings can be changed on the fly. +man:pacmd[1] opens a command line connection to the package:audio/pulseaudio[] +daemon: + +[source,shell] +.... +>>> # pacmd +Welcome to PulseAudio 14.2! Use "help" for usage information. +>>> +.... + +The following command changes the default sink to card number 4 as in +the previous example: + +[.programlisting] +.... +set-default-sink 4 +.... + +[WARNING] +==== +Do not use the `exit` command to exit the command line interface. That will kill +the package:audio/pulseaudio[] daemon. Use kbd:[Ctrl+D] instead. +==== + [[sound-multiple-sources]] === Utilizing Multiple Sound Sources