1 /*-
2  * SPDX-License-Identifier: BSD-2-Clause-FreeBSD
3  *
4  * Copyright (c) 2007-2009 Ariff Abdullah <ariff@FreeBSD.org>
5  * All rights reserved.
6  *
7  * Redistribution and use in source and binary forms, with or without
8  * modification, are permitted provided that the following conditions
9  * are met:
10  * 1. Redistributions of source code must retain the above copyright
11  *    notice, this list of conditions and the following disclaimer.
12  * 2. Redistributions in binary form must reproduce the above copyright
13  *    notice, this list of conditions and the following disclaimer in the
14  *    documentation and/or other materials provided with the distribution.
15  *
16  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
17  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
18  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
19  * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
20  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
21  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
22  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
23  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
24  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
25  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
26  * SUCH DAMAGE.
27  *
28  * $FreeBSD: stable/12/sys/dev/sound/pcm/sndstat.h 326255 2017-11-27 14:52:40Z pfg $
29  */
30 
31 #ifndef _SND_SNDSTAT_H_
32 #define _SND_SNDSTAT_H_
33 
34 #define SNDSTAT_PREPARE_PCM_ARGS					\
35 	struct sbuf *s, device_t dev, int verbose
36 
37 #define SNDSTAT_PREPARE_PCM_BEGIN()	do {				\
38 	struct snddev_info *d;						\
39 	struct pcm_channel *c;						\
40 	struct pcm_feeder *f;						\
41 									\
42 	d = device_get_softc(dev);					\
43 	PCM_BUSYASSERT(d);						\
44 									\
45 	if (CHN_EMPTY(d, channels.pcm)) {				\
46 		sbuf_printf(s, " (mixer only)");			\
47 		return (0);						\
48 	}								\
49 									\
50 	if (verbose < 1) {						\
51 		sbuf_printf(s, " (%s%s%s",				\
52 		    d->playcount ? "play" : "",				\
53 		    (d->playcount && d->reccount) ? "/" : "",		\
54 		    d->reccount ? "rec" : "");				\
55 	} else {							\
56 		sbuf_printf(s, " (%dp:%dv/%dr:%dv",			\
57 		    d->playcount, d->pvchancount,			\
58 		    d->reccount, d->rvchancount);			\
59 	}								\
60 	sbuf_printf(s, "%s)%s",						\
61 	    ((d->playcount != 0 && d->reccount != 0) &&			\
62 	    (d->flags & SD_F_SIMPLEX)) ? " simplex" : "",		\
63 	    (device_get_unit(dev) == snd_unit) ? " default" : "")
64 
65 
66 #define SNDSTAT_PREPARE_PCM_END()					\
67 	if (verbose <= 1)						\
68 		return (0);						\
69 									\
70 	sbuf_printf(s, "\n\t");						\
71 	sbuf_printf(s, "snddev flags=0x%b", d->flags, SD_F_BITS);	\
72 									\
73 	CHN_FOREACH(c, d, channels.pcm) {				\
74 									\
75 		KASSERT(c->bufhard != NULL && c->bufsoft != NULL,	\
76 		    ("hosed pcm channel setup"));			\
77 									\
78 		sbuf_printf(s, "\n\t");					\
79 									\
80 		sbuf_printf(s, "%s[%s]: ",				\
81 		    (c->parentchannel != NULL) ?			\
82 		    c->parentchannel->name : "", c->name);		\
83 		sbuf_printf(s, "spd %d", c->speed);			\
84 		if (c->speed != sndbuf_getspd(c->bufhard))		\
85 			sbuf_printf(s, "/%d",				\
86 			    sndbuf_getspd(c->bufhard));			\
87 		sbuf_printf(s, ", fmt 0x%08x", c->format);		\
88 		if (c->format != sndbuf_getfmt(c->bufhard))		\
89 			sbuf_printf(s, "/0x%08x",			\
90 			    sndbuf_getfmt(c->bufhard));			\
91 		sbuf_printf(s, ", flags 0x%08x, 0x%08x",		\
92 		    c->flags, c->feederflags);				\
93 		if (c->pid != -1)					\
94 			sbuf_printf(s, ", pid %d (%s)",			\
95 			    c->pid, c->comm);				\
96 		sbuf_printf(s, "\n\t");					\
97 									\
98 		sbuf_printf(s, "interrupts %d, ", c->interrupts);	\
99 									\
100 		if (c->direction == PCMDIR_REC)				\
101 			sbuf_printf(s,					\
102 			    "overruns %d, feed %u, hfree %d, "		\
103 			    "sfree %d [b:%d/%d/%d|bs:%d/%d/%d]",	\
104 				c->xruns, c->feedcount,			\
105 				sndbuf_getfree(c->bufhard),		\
106 				sndbuf_getfree(c->bufsoft),		\
107 				sndbuf_getsize(c->bufhard),		\
108 				sndbuf_getblksz(c->bufhard),		\
109 				sndbuf_getblkcnt(c->bufhard),		\
110 				sndbuf_getsize(c->bufsoft),		\
111 				sndbuf_getblksz(c->bufsoft),		\
112 				sndbuf_getblkcnt(c->bufsoft));		\
113 		else							\
114 			sbuf_printf(s,					\
115 			    "underruns %d, feed %u, ready %d "		\
116 			    "[b:%d/%d/%d|bs:%d/%d/%d]",			\
117 				c->xruns, c->feedcount,			\
118 				sndbuf_getready(c->bufsoft),		\
119 				sndbuf_getsize(c->bufhard),		\
120 				sndbuf_getblksz(c->bufhard),		\
121 				sndbuf_getblkcnt(c->bufhard),		\
122 				sndbuf_getsize(c->bufsoft),		\
123 				sndbuf_getblksz(c->bufsoft),		\
124 				sndbuf_getblkcnt(c->bufsoft));		\
125 		sbuf_printf(s, "\n\t");					\
126 									\
127 		sbuf_printf(s, "channel flags=0x%b", c->flags,		\
128 		    CHN_F_BITS);					\
129 		sbuf_printf(s, "\n\t");					\
130 									\
131 		sbuf_printf(s, "{%s}",					\
132 		    (c->direction == PCMDIR_REC) ? "hardware" :		\
133 		    "userland");					\
134 		sbuf_printf(s, " -> ");					\
135 		f = c->feeder;						\
136 		while (f->source != NULL)				\
137 			f = f->source;					\
138 		while (f != NULL) {					\
139 			sbuf_printf(s, "%s", f->class->name);		\
140 			if (f->desc->type == FEEDER_FORMAT)		\
141 				sbuf_printf(s, "(0x%08x -> 0x%08x)",	\
142 				    f->desc->in, f->desc->out);		\
143 			else if (f->desc->type == FEEDER_MATRIX)	\
144 				sbuf_printf(s, "(%d.%d -> %d.%d)",	\
145 				    AFMT_CHANNEL(f->desc->in) -		\
146 				    AFMT_EXTCHANNEL(f->desc->in),	\
147 				    AFMT_EXTCHANNEL(f->desc->in),	\
148 				    AFMT_CHANNEL(f->desc->out) -	\
149 				    AFMT_EXTCHANNEL(f->desc->out),	\
150 				    AFMT_EXTCHANNEL(f->desc->out));	\
151 			else if (f->desc->type == FEEDER_RATE)		\
152 				sbuf_printf(s,				\
153 				    "(0x%08x q:%d %d -> %d)",		\
154 				    f->desc->out,			\
155 				    FEEDER_GET(f, FEEDRATE_QUALITY),	\
156 				    FEEDER_GET(f, FEEDRATE_SRC),	\
157 				    FEEDER_GET(f, FEEDRATE_DST));	\
158 			else						\
159 				sbuf_printf(s, "(0x%08x)",		\
160 				    f->desc->out);			\
161 			sbuf_printf(s, " -> ");				\
162 			f = f->parent;					\
163 		}							\
164 		sbuf_printf(s, "{%s}",					\
165 		    (c->direction == PCMDIR_REC) ? "userland" :		\
166 		    "hardware");					\
167 	}								\
168 									\
169 	return (0);							\
170 } while (0)
171 
172 #endif	/* !_SND_SNDSTAT_H_ */
173