<html>
<head>
<base href="https://bugs.freedesktop.org/">
</head>
<body><table border="1" cellspacing="0" cellpadding="8">
<tr>
<th>Bug ID</th>
<td><a class="bz_bug_link
bz_status_NEW "
title="NEW - pulse-cli-syntax man page should describe suspend and kill in more detail"
href="https://bugs.freedesktop.org/show_bug.cgi?id=105907">105907</a>
</td>
</tr>
<tr>
<th>Summary</th>
<td>pulse-cli-syntax man page should describe suspend and kill in more detail
</td>
</tr>
<tr>
<th>Product</th>
<td>PulseAudio
</td>
</tr>
<tr>
<th>Version</th>
<td>unspecified
</td>
</tr>
<tr>
<th>Hardware</th>
<td>x86-64 (AMD64)
</td>
</tr>
<tr>
<th>OS</th>
<td>Linux (All)
</td>
</tr>
<tr>
<th>Status</th>
<td>NEW
</td>
</tr>
<tr>
<th>Severity</th>
<td>minor
</td>
</tr>
<tr>
<th>Priority</th>
<td>medium
</td>
</tr>
<tr>
<th>Component</th>
<td>core
</td>
</tr>
<tr>
<th>Assignee</th>
<td>pulseaudio-bugs@lists.freedesktop.org
</td>
</tr>
<tr>
<th>Reporter</th>
<td>frederik-freedesktop@ofb.net
</td>
</tr>
<tr>
<th>QA Contact</th>
<td>pulseaudio-bugs@lists.freedesktop.org
</td>
</tr>
<tr>
<th>CC</th>
<td>lennart@poettering.net
</td>
</tr></table>
<p>
<div>
<pre>I've been reading pulse-cli-syntax(5) and I don't understand what is the
difference between 'suspend-sink' and 'kill-sink-input' and how they are used.
Is it true that I use the former when I want to free a hardware device so I can
open it from another sound server, and that I would use the latter command to
stop a client from playing sound without killing its process? Will Pulseaudio
just ignore any further samples that are sent by a client or sink input which
has been "killed", or will the client get an error of some kind?
Is there another manual page or document which describes these in more detail?
What is the meaning of the argument to 'suspend-sink' and 'suspend' which is
boolean?
What is the difference between removing a client or sink, and removing it
"forcibly" (as the manual page says is done by the "kill-" commands)?
I think all of this should be documented in a place which is easy for new users
to locate, such as the pulse-cli-syntax(5) man page or some document which is
referenced by it. As it is, I find a lot of examples on the web invoking things
like 'pacmd suspend true' and each time I read this stuff I go to your man page
and find it frustratingly incomplete.</pre>
</div>
</p>
<hr>
<span>You are receiving this mail because:</span>
<ul>
<li>You are the QA Contact for the bug.</li>
<li>You are the assignee for the bug.</li>
</ul>
</body>
</html>