1 // SPDX-License-Identifier: GPL-2.0-or-later 2 /* 3 * Digital Audio (PCM) abstract layer 4 * Copyright (c) by Jaroslav Kysela <perex@perex.cz> 5 */ 6 7 #include <linux/compat.h> 8 #include <linux/mm.h> 9 #include <linux/module.h> 10 #include <linux/file.h> 11 #include <linux/slab.h> 12 #include <linux/sched/signal.h> 13 #include <linux/time.h> 14 #include <linux/pm_qos.h> 15 #include <linux/io.h> 16 #include <linux/dma-mapping.h> 17 #include <linux/vmalloc.h> 18 #include <sound/core.h> 19 #include <sound/control.h> 20 #include <sound/info.h> 21 #include <sound/pcm.h> 22 #include <sound/pcm_params.h> 23 #include <sound/timer.h> 24 #include <sound/minors.h> 25 #include <linux/uio.h> 26 #include <linux/delay.h> 27 28 #include "pcm_local.h" 29 30 #ifdef CONFIG_SND_DEBUG 31 #define CREATE_TRACE_POINTS 32 #include "pcm_param_trace.h" 33 #else 34 #define trace_hw_mask_param_enabled() 0 35 #define trace_hw_interval_param_enabled() 0 36 #define trace_hw_mask_param(substream, type, index, prev, curr) 37 #define trace_hw_interval_param(substream, type, index, prev, curr) 38 #endif 39 40 /* 41 * Compatibility 42 */ 43 44 struct snd_pcm_hw_params_old { 45 unsigned int flags; 46 unsigned int masks[SNDRV_PCM_HW_PARAM_SUBFORMAT - 47 SNDRV_PCM_HW_PARAM_ACCESS + 1]; 48 struct snd_interval intervals[SNDRV_PCM_HW_PARAM_TICK_TIME - 49 SNDRV_PCM_HW_PARAM_SAMPLE_BITS + 1]; 50 unsigned int rmask; 51 unsigned int cmask; 52 unsigned int info; 53 unsigned int msbits; 54 unsigned int rate_num; 55 unsigned int rate_den; 56 snd_pcm_uframes_t fifo_size; 57 unsigned char reserved[64]; 58 }; 59 60 #ifdef CONFIG_SND_SUPPORT_OLD_API 61 #define SNDRV_PCM_IOCTL_HW_REFINE_OLD _IOWR('A', 0x10, struct snd_pcm_hw_params_old) 62 #define SNDRV_PCM_IOCTL_HW_PARAMS_OLD _IOWR('A', 0x11, struct snd_pcm_hw_params_old) 63 64 static int snd_pcm_hw_refine_old_user(struct snd_pcm_substream *substream, 65 struct snd_pcm_hw_params_old __user * _oparams); 66 static int snd_pcm_hw_params_old_user(struct snd_pcm_substream *substream, 67 struct snd_pcm_hw_params_old __user * _oparams); 68 #endif 69 static int snd_pcm_open(struct file *file, struct snd_pcm *pcm, int stream); 70 71 /* 72 * 73 */ 74 75 static DECLARE_RWSEM(snd_pcm_link_rwsem); 76 77 void snd_pcm_group_init(struct snd_pcm_group *group) 78 { 79 spin_lock_init(&group->lock); 80 mutex_init(&group->mutex); 81 INIT_LIST_HEAD(&group->substreams); 82 refcount_set(&group->refs, 1); 83 } 84 85 /* define group lock helpers */ 86 #define DEFINE_PCM_GROUP_LOCK(action, mutex_action) \ 87 static void snd_pcm_group_ ## action(struct snd_pcm_group *group, bool nonatomic) \ 88 { \ 89 if (nonatomic) \ 90 mutex_ ## mutex_action(&group->mutex); \ 91 else \ 92 spin_ ## action(&group->lock); \ 93 } 94 95 DEFINE_PCM_GROUP_LOCK(lock, lock); 96 DEFINE_PCM_GROUP_LOCK(unlock, unlock); 97 DEFINE_PCM_GROUP_LOCK(lock_irq, lock); 98 DEFINE_PCM_GROUP_LOCK(unlock_irq, unlock); 99 100 /** 101 * snd_pcm_stream_lock - Lock the PCM stream 102 * @substream: PCM substream 103 * 104 * This locks the PCM stream's spinlock or mutex depending on the nonatomic 105 * flag of the given substream. This also takes the global link rw lock 106 * (or rw sem), too, for avoiding the race with linked streams. 107 */ 108 void snd_pcm_stream_lock(struct snd_pcm_substream *substream) 109 { 110 snd_pcm_group_lock(&substream->self_group, substream->pcm->nonatomic); 111 } 112 EXPORT_SYMBOL_GPL(snd_pcm_stream_lock); 113 114 /** 115 * snd_pcm_stream_unlock - Unlock the PCM stream 116 * @substream: PCM substream 117 * 118 * This unlocks the PCM stream that has been locked via snd_pcm_stream_lock(). 119 */ 120 void snd_pcm_stream_unlock(struct snd_pcm_substream *substream) 121 { 122 snd_pcm_group_unlock(&substream->self_group, substream->pcm->nonatomic); 123 } 124 EXPORT_SYMBOL_GPL(snd_pcm_stream_unlock); 125 126 /** 127 * snd_pcm_stream_lock_irq - Lock the PCM stream 128 * @substream: PCM substream 129 * 130 * This locks the PCM stream like snd_pcm_stream_lock() and disables the local 131 * IRQ (only when nonatomic is false). In nonatomic case, this is identical 132 * as snd_pcm_stream_lock(). 133 */ 134 void snd_pcm_stream_lock_irq(struct snd_pcm_substream *substream) 135 { 136 snd_pcm_group_lock_irq(&substream->self_group, 137 substream->pcm->nonatomic); 138 } 139 EXPORT_SYMBOL_GPL(snd_pcm_stream_lock_irq); 140 141 static void snd_pcm_stream_lock_nested(struct snd_pcm_substream *substream) 142 { 143 struct snd_pcm_group *group = &substream->self_group; 144 145 if (substream->pcm->nonatomic) 146 mutex_lock_nested(&group->mutex, SINGLE_DEPTH_NESTING); 147 else 148 spin_lock_nested(&group->lock, SINGLE_DEPTH_NESTING); 149 } 150 151 /** 152 * snd_pcm_stream_unlock_irq - Unlock the PCM stream 153 * @substream: PCM substream 154 * 155 * This is a counter-part of snd_pcm_stream_lock_irq(). 156 */ 157 void snd_pcm_stream_unlock_irq(struct snd_pcm_substream *substream) 158 { 159 snd_pcm_group_unlock_irq(&substream->self_group, 160 substream->pcm->nonatomic); 161 } 162 EXPORT_SYMBOL_GPL(snd_pcm_stream_unlock_irq); 163 164 unsigned long _snd_pcm_stream_lock_irqsave(struct snd_pcm_substream *substream) 165 { 166 unsigned long flags = 0; 167 if (substream->pcm->nonatomic) 168 mutex_lock(&substream->self_group.mutex); 169 else 170 spin_lock_irqsave(&substream->self_group.lock, flags); 171 return flags; 172 } 173 EXPORT_SYMBOL_GPL(_snd_pcm_stream_lock_irqsave); 174 175 unsigned long _snd_pcm_stream_lock_irqsave_nested(struct snd_pcm_substream *substream) 176 { 177 unsigned long flags = 0; 178 if (substream->pcm->nonatomic) 179 mutex_lock_nested(&substream->self_group.mutex, 180 SINGLE_DEPTH_NESTING); 181 else 182 spin_lock_irqsave_nested(&substream->self_group.lock, flags, 183 SINGLE_DEPTH_NESTING); 184 return flags; 185 } 186 EXPORT_SYMBOL_GPL(_snd_pcm_stream_lock_irqsave_nested); 187 188 /** 189 * snd_pcm_stream_unlock_irqrestore - Unlock the PCM stream 190 * @substream: PCM substream 191 * @flags: irq flags 192 * 193 * This is a counter-part of snd_pcm_stream_lock_irqsave(). 194 */ 195 void snd_pcm_stream_unlock_irqrestore(struct snd_pcm_substream *substream, 196 unsigned long flags) 197 { 198 if (substream->pcm->nonatomic) 199 mutex_unlock(&substream->self_group.mutex); 200 else 201 spin_unlock_irqrestore(&substream->self_group.lock, flags); 202 } 203 EXPORT_SYMBOL_GPL(snd_pcm_stream_unlock_irqrestore); 204 205 /* Run PCM ioctl ops */ 206 static int snd_pcm_ops_ioctl(struct snd_pcm_substream *substream, 207 unsigned cmd, void *arg) 208 { 209 if (substream->ops->ioctl) 210 return substream->ops->ioctl(substream, cmd, arg); 211 else 212 return snd_pcm_lib_ioctl(substream, cmd, arg); 213 } 214 215 int snd_pcm_info(struct snd_pcm_substream *substream, struct snd_pcm_info *info) 216 { 217 struct snd_pcm *pcm = substream->pcm; 218 struct snd_pcm_str *pstr = substream->pstr; 219 220 memset(info, 0, sizeof(*info)); 221 info->card = pcm->card->number; 222 info->device = pcm->device; 223 info->stream = substream->stream; 224 info->subdevice = substream->number; 225 strscpy(info->id, pcm->id, sizeof(info->id)); 226 strscpy(info->name, pcm->name, sizeof(info->name)); 227 info->dev_class = pcm->dev_class; 228 info->dev_subclass = pcm->dev_subclass; 229 info->subdevices_count = pstr->substream_count; 230 info->subdevices_avail = pstr->substream_count - pstr->substream_opened; 231 strscpy(info->subname, substream->name, sizeof(info->subname)); 232 233 return 0; 234 } 235 236 int snd_pcm_info_user(struct snd_pcm_substream *substream, 237 struct snd_pcm_info __user * _info) 238 { 239 struct snd_pcm_info *info; 240 int err; 241 242 info = kmalloc(sizeof(*info), GFP_KERNEL); 243 if (! info) 244 return -ENOMEM; 245 err = snd_pcm_info(substream, info); 246 if (err >= 0) { 247 if (copy_to_user(_info, info, sizeof(*info))) 248 err = -EFAULT; 249 } 250 kfree(info); 251 return err; 252 } 253 254 /* macro for simplified cast */ 255 #define PARAM_MASK_BIT(b) (1U << (__force int)(b)) 256 257 static bool hw_support_mmap(struct snd_pcm_substream *substream) 258 { 259 struct snd_dma_buffer *dmabuf; 260 261 if (!(substream->runtime->hw.info & SNDRV_PCM_INFO_MMAP)) 262 return false; 263 264 if (substream->ops->mmap || substream->ops->page) 265 return true; 266 267 dmabuf = snd_pcm_get_dma_buf(substream); 268 if (!dmabuf) 269 dmabuf = &substream->dma_buffer; 270 switch (dmabuf->dev.type) { 271 case SNDRV_DMA_TYPE_UNKNOWN: 272 /* we can't know the device, so just assume that the driver does 273 * everything right 274 */ 275 return true; 276 case SNDRV_DMA_TYPE_CONTINUOUS: 277 case SNDRV_DMA_TYPE_VMALLOC: 278 return true; 279 default: 280 return dma_can_mmap(dmabuf->dev.dev); 281 } 282 } 283 284 static int constrain_mask_params(struct snd_pcm_substream *substream, 285 struct snd_pcm_hw_params *params) 286 { 287 struct snd_pcm_hw_constraints *constrs = 288 &substream->runtime->hw_constraints; 289 struct snd_mask *m; 290 unsigned int k; 291 struct snd_mask old_mask; 292 int changed; 293 294 for (k = SNDRV_PCM_HW_PARAM_FIRST_MASK; k <= SNDRV_PCM_HW_PARAM_LAST_MASK; k++) { 295 m = hw_param_mask(params, k); 296 if (snd_mask_empty(m)) 297 return -EINVAL; 298 299 /* This parameter is not requested to change by a caller. */ 300 if (!(params->rmask & PARAM_MASK_BIT(k))) 301 continue; 302 303 if (trace_hw_mask_param_enabled()) 304 old_mask = *m; 305 306 changed = snd_mask_refine(m, constrs_mask(constrs, k)); 307 if (changed < 0) 308 return changed; 309 if (changed == 0) 310 continue; 311 312 /* Set corresponding flag so that the caller gets it. */ 313 trace_hw_mask_param(substream, k, 0, &old_mask, m); 314 params->cmask |= PARAM_MASK_BIT(k); 315 } 316 317 return 0; 318 } 319 320 static int constrain_interval_params(struct snd_pcm_substream *substream, 321 struct snd_pcm_hw_params *params) 322 { 323 struct snd_pcm_hw_constraints *constrs = 324 &substream->runtime->hw_constraints; 325 struct snd_interval *i; 326 unsigned int k; 327 struct snd_interval old_interval; 328 int changed; 329 330 for (k = SNDRV_PCM_HW_PARAM_FIRST_INTERVAL; k <= SNDRV_PCM_HW_PARAM_LAST_INTERVAL; k++) { 331 i = hw_param_interval(params, k); 332 if (snd_interval_empty(i)) 333 return -EINVAL; 334 335 /* This parameter is not requested to change by a caller. */ 336 if (!(params->rmask & PARAM_MASK_BIT(k))) 337 continue; 338 339 if (trace_hw_interval_param_enabled()) 340 old_interval = *i; 341 342 changed = snd_interval_refine(i, constrs_interval(constrs, k)); 343 if (changed < 0) 344 return changed; 345 if (changed == 0) 346 continue; 347 348 /* Set corresponding flag so that the caller gets it. */ 349 trace_hw_interval_param(substream, k, 0, &old_interval, i); 350 params->cmask |= PARAM_MASK_BIT(k); 351 } 352 353 return 0; 354 } 355 356 static int constrain_params_by_rules(struct snd_pcm_substream *substream, 357 struct snd_pcm_hw_params *params) 358 { 359 struct snd_pcm_hw_constraints *constrs = 360 &substream->runtime->hw_constraints; 361 unsigned int k; 362 unsigned int *rstamps; 363 unsigned int vstamps[SNDRV_PCM_HW_PARAM_LAST_INTERVAL + 1]; 364 unsigned int stamp; 365 struct snd_pcm_hw_rule *r; 366 unsigned int d; 367 struct snd_mask old_mask; 368 struct snd_interval old_interval; 369 bool again; 370 int changed, err = 0; 371 372 /* 373 * Each application of rule has own sequence number. 374 * 375 * Each member of 'rstamps' array represents the sequence number of 376 * recent application of corresponding rule. 377 */ 378 rstamps = kcalloc(constrs->rules_num, sizeof(unsigned int), GFP_KERNEL); 379 if (!rstamps) 380 return -ENOMEM; 381 382 /* 383 * Each member of 'vstamps' array represents the sequence number of 384 * recent application of rule in which corresponding parameters were 385 * changed. 386 * 387 * In initial state, elements corresponding to parameters requested by 388 * a caller is 1. For unrequested parameters, corresponding members 389 * have 0 so that the parameters are never changed anymore. 390 */ 391 for (k = 0; k <= SNDRV_PCM_HW_PARAM_LAST_INTERVAL; k++) 392 vstamps[k] = (params->rmask & PARAM_MASK_BIT(k)) ? 1 : 0; 393 394 /* Due to the above design, actual sequence number starts at 2. */ 395 stamp = 2; 396 retry: 397 /* Apply all rules in order. */ 398 again = false; 399 for (k = 0; k < constrs->rules_num; k++) { 400 r = &constrs->rules[k]; 401 402 /* 403 * Check condition bits of this rule. When the rule has 404 * some condition bits, parameter without the bits is 405 * never processed. SNDRV_PCM_HW_PARAMS_NO_PERIOD_WAKEUP 406 * is an example of the condition bits. 407 */ 408 if (r->cond && !(r->cond & params->flags)) 409 continue; 410 411 /* 412 * The 'deps' array includes maximum four dependencies 413 * to SNDRV_PCM_HW_PARAM_XXXs for this rule. The fifth 414 * member of this array is a sentinel and should be 415 * negative value. 416 * 417 * This rule should be processed in this time when dependent 418 * parameters were changed at former applications of the other 419 * rules. 420 */ 421 for (d = 0; r->deps[d] >= 0; d++) { 422 if (vstamps[r->deps[d]] > rstamps[k]) 423 break; 424 } 425 if (r->deps[d] < 0) 426 continue; 427 428 if (trace_hw_mask_param_enabled()) { 429 if (hw_is_mask(r->var)) 430 old_mask = *hw_param_mask(params, r->var); 431 } 432 if (trace_hw_interval_param_enabled()) { 433 if (hw_is_interval(r->var)) 434 old_interval = *hw_param_interval(params, r->var); 435 } 436 437 changed = r->func(params, r); 438 if (changed < 0) { 439 err = changed; 440 goto out; 441 } 442 443 /* 444 * When the parameter is changed, notify it to the caller 445 * by corresponding returned bit, then preparing for next 446 * iteration. 447 */ 448 if (changed && r->var >= 0) { 449 if (hw_is_mask(r->var)) { 450 trace_hw_mask_param(substream, r->var, 451 k + 1, &old_mask, 452 hw_param_mask(params, r->var)); 453 } 454 if (hw_is_interval(r->var)) { 455 trace_hw_interval_param(substream, r->var, 456 k + 1, &old_interval, 457 hw_param_interval(params, r->var)); 458 } 459 460 params->cmask |= PARAM_MASK_BIT(r->var); 461 vstamps[r->var] = stamp; 462 again = true; 463 } 464 465 rstamps[k] = stamp++; 466 } 467 468 /* Iterate to evaluate all rules till no parameters are changed. */ 469 if (again) 470 goto retry; 471 472 out: 473 kfree(rstamps); 474 return err; 475 } 476 477 static int fixup_unreferenced_params(struct snd_pcm_substream *substream, 478 struct snd_pcm_hw_params *params) 479 { 480 const struct snd_interval *i; 481 const struct snd_mask *m; 482 int err; 483 484 if (!params->msbits) { 485 i = hw_param_interval_c(params, SNDRV_PCM_HW_PARAM_SAMPLE_BITS); 486 if (snd_interval_single(i)) 487 params->msbits = snd_interval_value(i); 488 } 489 490 if (!params->rate_den) { 491 i = hw_param_interval_c(params, SNDRV_PCM_HW_PARAM_RATE); 492 if (snd_interval_single(i)) { 493 params->rate_num = snd_interval_value(i); 494 params->rate_den = 1; 495 } 496 } 497 498 if (!params->fifo_size) { 499 m = hw_param_mask_c(params, SNDRV_PCM_HW_PARAM_FORMAT); 500 i = hw_param_interval_c(params, SNDRV_PCM_HW_PARAM_CHANNELS); 501 if (snd_mask_single(m) && snd_interval_single(i)) { 502 err = snd_pcm_ops_ioctl(substream, 503 SNDRV_PCM_IOCTL1_FIFO_SIZE, 504 params); 505 if (err < 0) 506 return err; 507 } 508 } 509 510 if (!params->info) { 511 params->info = substream->runtime->hw.info; 512 params->info &= ~(SNDRV_PCM_INFO_FIFO_IN_FRAMES | 513 SNDRV_PCM_INFO_DRAIN_TRIGGER); 514 if (!hw_support_mmap(substream)) 515 params->info &= ~(SNDRV_PCM_INFO_MMAP | 516 SNDRV_PCM_INFO_MMAP_VALID); 517 } 518 519 return 0; 520 } 521 522 int snd_pcm_hw_refine(struct snd_pcm_substream *substream, 523 struct snd_pcm_hw_params *params) 524 { 525 int err; 526 527 params->info = 0; 528 params->fifo_size = 0; 529 if (params->rmask & PARAM_MASK_BIT(SNDRV_PCM_HW_PARAM_SAMPLE_BITS)) 530 params->msbits = 0; 531 if (params->rmask & PARAM_MASK_BIT(SNDRV_PCM_HW_PARAM_RATE)) { 532 params->rate_num = 0; 533 params->rate_den = 0; 534 } 535 536 err = constrain_mask_params(substream, params); 537 if (err < 0) 538 return err; 539 540 err = constrain_interval_params(substream, params); 541 if (err < 0) 542 return err; 543 544 err = constrain_params_by_rules(substream, params); 545 if (err < 0) 546 return err; 547 548 params->rmask = 0; 549 550 return 0; 551 } 552 EXPORT_SYMBOL(snd_pcm_hw_refine); 553 554 static int snd_pcm_hw_refine_user(struct snd_pcm_substream *substream, 555 struct snd_pcm_hw_params __user * _params) 556 { 557 struct snd_pcm_hw_params *params; 558 int err; 559 560 params = memdup_user(_params, sizeof(*params)); 561 if (IS_ERR(params)) 562 return PTR_ERR(params); 563 564 err = snd_pcm_hw_refine(substream, params); 565 if (err < 0) 566 goto end; 567 568 err = fixup_unreferenced_params(substream, params); 569 if (err < 0) 570 goto end; 571 572 if (copy_to_user(_params, params, sizeof(*params))) 573 err = -EFAULT; 574 end: 575 kfree(params); 576 return err; 577 } 578 579 static int period_to_usecs(struct snd_pcm_runtime *runtime) 580 { 581 int usecs; 582 583 if (! runtime->rate) 584 return -1; /* invalid */ 585 586 /* take 75% of period time as the deadline */ 587 usecs = (750000 / runtime->rate) * runtime->period_size; 588 usecs += ((750000 % runtime->rate) * runtime->period_size) / 589 runtime->rate; 590 591 return usecs; 592 } 593 594 static void snd_pcm_set_state(struct snd_pcm_substream *substream, 595 snd_pcm_state_t state) 596 { 597 snd_pcm_stream_lock_irq(substream); 598 if (substream->runtime->status->state != SNDRV_PCM_STATE_DISCONNECTED) 599 substream->runtime->status->state = state; 600 snd_pcm_stream_unlock_irq(substream); 601 } 602 603 static inline void snd_pcm_timer_notify(struct snd_pcm_substream *substream, 604 int event) 605 { 606 #ifdef CONFIG_SND_PCM_TIMER 607 if (substream->timer) 608 snd_timer_notify(substream->timer, event, 609 &substream->runtime->trigger_tstamp); 610 #endif 611 } 612 613 void snd_pcm_sync_stop(struct snd_pcm_substream *substream, bool sync_irq) 614 { 615 if (substream->runtime && substream->runtime->stop_operating) { 616 substream->runtime->stop_operating = false; 617 if (substream->ops && substream->ops->sync_stop) 618 substream->ops->sync_stop(substream); 619 else if (sync_irq && substream->pcm->card->sync_irq > 0) 620 synchronize_irq(substream->pcm->card->sync_irq); 621 } 622 } 623 624 /** 625 * snd_pcm_hw_params_choose - choose a configuration defined by @params 626 * @pcm: PCM instance 627 * @params: the hw_params instance 628 * 629 * Choose one configuration from configuration space defined by @params. 630 * The configuration chosen is that obtained fixing in this order: 631 * first access, first format, first subformat, min channels, 632 * min rate, min period time, max buffer size, min tick time 633 * 634 * Return: Zero if successful, or a negative error code on failure. 635 */ 636 static int snd_pcm_hw_params_choose(struct snd_pcm_substream *pcm, 637 struct snd_pcm_hw_params *params) 638 { 639 static const int vars[] = { 640 SNDRV_PCM_HW_PARAM_ACCESS, 641 SNDRV_PCM_HW_PARAM_FORMAT, 642 SNDRV_PCM_HW_PARAM_SUBFORMAT, 643 SNDRV_PCM_HW_PARAM_CHANNELS, 644 SNDRV_PCM_HW_PARAM_RATE, 645 SNDRV_PCM_HW_PARAM_PERIOD_TIME, 646 SNDRV_PCM_HW_PARAM_BUFFER_SIZE, 647 SNDRV_PCM_HW_PARAM_TICK_TIME, 648 -1 649 }; 650 const int *v; 651 struct snd_mask old_mask; 652 struct snd_interval old_interval; 653 int changed; 654 655 for (v = vars; *v != -1; v++) { 656 /* Keep old parameter to trace. */ 657 if (trace_hw_mask_param_enabled()) { 658 if (hw_is_mask(*v)) 659 old_mask = *hw_param_mask(params, *v); 660 } 661 if (trace_hw_interval_param_enabled()) { 662 if (hw_is_interval(*v)) 663 old_interval = *hw_param_interval(params, *v); 664 } 665 if (*v != SNDRV_PCM_HW_PARAM_BUFFER_SIZE) 666 changed = snd_pcm_hw_param_first(pcm, params, *v, NULL); 667 else 668 changed = snd_pcm_hw_param_last(pcm, params, *v, NULL); 669 if (changed < 0) 670 return changed; 671 if (changed == 0) 672 continue; 673 674 /* Trace the changed parameter. */ 675 if (hw_is_mask(*v)) { 676 trace_hw_mask_param(pcm, *v, 0, &old_mask, 677 hw_param_mask(params, *v)); 678 } 679 if (hw_is_interval(*v)) { 680 trace_hw_interval_param(pcm, *v, 0, &old_interval, 681 hw_param_interval(params, *v)); 682 } 683 } 684 685 return 0; 686 } 687 688 #if IS_ENABLED(CONFIG_SND_PCM_OSS) 689 #define is_oss_stream(substream) ((substream)->oss.oss) 690 #else 691 #define is_oss_stream(substream) false 692 #endif 693 694 static int snd_pcm_hw_params(struct snd_pcm_substream *substream, 695 struct snd_pcm_hw_params *params) 696 { 697 struct snd_pcm_runtime *runtime; 698 int err = 0, usecs; 699 unsigned int bits; 700 snd_pcm_uframes_t frames; 701 702 if (PCM_RUNTIME_CHECK(substream)) 703 return -ENXIO; 704 runtime = substream->runtime; 705 mutex_lock(&runtime->buffer_mutex); 706 snd_pcm_stream_lock_irq(substream); 707 switch (runtime->status->state) { 708 case SNDRV_PCM_STATE_OPEN: 709 case SNDRV_PCM_STATE_SETUP: 710 case SNDRV_PCM_STATE_PREPARED: 711 if (!is_oss_stream(substream) && 712 atomic_read(&substream->mmap_count)) 713 err = -EBADFD; 714 break; 715 default: 716 err = -EBADFD; 717 break; 718 } 719 snd_pcm_stream_unlock_irq(substream); 720 if (err) 721 goto unlock; 722 723 snd_pcm_sync_stop(substream, true); 724 725 params->rmask = ~0U; 726 err = snd_pcm_hw_refine(substream, params); 727 if (err < 0) 728 goto _error; 729 730 err = snd_pcm_hw_params_choose(substream, params); 731 if (err < 0) 732 goto _error; 733 734 err = fixup_unreferenced_params(substream, params); 735 if (err < 0) 736 goto _error; 737 738 if (substream->managed_buffer_alloc) { 739 err = snd_pcm_lib_malloc_pages(substream, 740 params_buffer_bytes(params)); 741 if (err < 0) 742 goto _error; 743 runtime->buffer_changed = err > 0; 744 } 745 746 if (substream->ops->hw_params != NULL) { 747 err = substream->ops->hw_params(substream, params); 748 if (err < 0) 749 goto _error; 750 } 751 752 runtime->access = params_access(params); 753 runtime->format = params_format(params); 754 runtime->subformat = params_subformat(params); 755 runtime->channels = params_channels(params); 756 runtime->rate = params_rate(params); 757 runtime->period_size = params_period_size(params); 758 runtime->periods = params_periods(params); 759 runtime->buffer_size = params_buffer_size(params); 760 runtime->info = params->info; 761 runtime->rate_num = params->rate_num; 762 runtime->rate_den = params->rate_den; 763 runtime->no_period_wakeup = 764 (params->info & SNDRV_PCM_INFO_NO_PERIOD_WAKEUP) && 765 (params->flags & SNDRV_PCM_HW_PARAMS_NO_PERIOD_WAKEUP); 766 767 bits = snd_pcm_format_physical_width(runtime->format); 768 runtime->sample_bits = bits; 769 bits *= runtime->channels; 770 runtime->frame_bits = bits; 771 frames = 1; 772 while (bits % 8 != 0) { 773 bits *= 2; 774 frames *= 2; 775 } 776 runtime->byte_align = bits / 8; 777 runtime->min_align = frames; 778 779 /* Default sw params */ 780 runtime->tstamp_mode = SNDRV_PCM_TSTAMP_NONE; 781 runtime->period_step = 1; 782 runtime->control->avail_min = runtime->period_size; 783 runtime->start_threshold = 1; 784 runtime->stop_threshold = runtime->buffer_size; 785 runtime->silence_threshold = 0; 786 runtime->silence_size = 0; 787 runtime->boundary = runtime->buffer_size; 788 while (runtime->boundary * 2 <= LONG_MAX - runtime->buffer_size) 789 runtime->boundary *= 2; 790 791 /* clear the buffer for avoiding possible kernel info leaks */ 792 if (runtime->dma_area && !substream->ops->copy_user) { 793 size_t size = runtime->dma_bytes; 794 795 if (runtime->info & SNDRV_PCM_INFO_MMAP) 796 size = PAGE_ALIGN(size); 797 memset(runtime->dma_area, 0, size); 798 } 799 800 snd_pcm_timer_resolution_change(substream); 801 snd_pcm_set_state(substream, SNDRV_PCM_STATE_SETUP); 802 803 if (cpu_latency_qos_request_active(&substream->latency_pm_qos_req)) 804 cpu_latency_qos_remove_request(&substream->latency_pm_qos_req); 805 usecs = period_to_usecs(runtime); 806 if (usecs >= 0) 807 cpu_latency_qos_add_request(&substream->latency_pm_qos_req, 808 usecs); 809 err = 0; 810 _error: 811 if (err) { 812 /* hardware might be unusable from this time, 813 * so we force application to retry to set 814 * the correct hardware parameter settings 815 */ 816 snd_pcm_set_state(substream, SNDRV_PCM_STATE_OPEN); 817 if (substream->ops->hw_free != NULL) 818 substream->ops->hw_free(substream); 819 if (substream->managed_buffer_alloc) 820 snd_pcm_lib_free_pages(substream); 821 } 822 unlock: 823 mutex_unlock(&runtime->buffer_mutex); 824 return err; 825 } 826 827 static int snd_pcm_hw_params_user(struct snd_pcm_substream *substream, 828 struct snd_pcm_hw_params __user * _params) 829 { 830 struct snd_pcm_hw_params *params; 831 int err; 832 833 params = memdup_user(_params, sizeof(*params)); 834 if (IS_ERR(params)) 835 return PTR_ERR(params); 836 837 err = snd_pcm_hw_params(substream, params); 838 if (err < 0) 839 goto end; 840 841 if (copy_to_user(_params, params, sizeof(*params))) 842 err = -EFAULT; 843 end: 844 kfree(params); 845 return err; 846 } 847 848 static int do_hw_free(struct snd_pcm_substream *substream) 849 { 850 int result = 0; 851 852 snd_pcm_sync_stop(substream, true); 853 if (substream->ops->hw_free) 854 result = substream->ops->hw_free(substream); 855 if (substream->managed_buffer_alloc) 856 snd_pcm_lib_free_pages(substream); 857 return result; 858 } 859 860 static int snd_pcm_hw_free(struct snd_pcm_substream *substream) 861 { 862 struct snd_pcm_runtime *runtime; 863 int result = 0; 864 865 if (PCM_RUNTIME_CHECK(substream)) 866 return -ENXIO; 867 runtime = substream->runtime; 868 mutex_lock(&runtime->buffer_mutex); 869 snd_pcm_stream_lock_irq(substream); 870 switch (runtime->status->state) { 871 case SNDRV_PCM_STATE_SETUP: 872 case SNDRV_PCM_STATE_PREPARED: 873 if (atomic_read(&substream->mmap_count)) 874 result = -EBADFD; 875 break; 876 default: 877 result = -EBADFD; 878 break; 879 } 880 snd_pcm_stream_unlock_irq(substream); 881 if (result) 882 goto unlock; 883 result = do_hw_free(substream); 884 snd_pcm_set_state(substream, SNDRV_PCM_STATE_OPEN); 885 cpu_latency_qos_remove_request(&substream->latency_pm_qos_req); 886 unlock: 887 mutex_unlock(&runtime->buffer_mutex); 888 return result; 889 } 890 891 static int snd_pcm_sw_params(struct snd_pcm_substream *substream, 892 struct snd_pcm_sw_params *params) 893 { 894 struct snd_pcm_runtime *runtime; 895 int err; 896 897 if (PCM_RUNTIME_CHECK(substream)) 898 return -ENXIO; 899 runtime = substream->runtime; 900 snd_pcm_stream_lock_irq(substream); 901 if (runtime->status->state == SNDRV_PCM_STATE_OPEN) { 902 snd_pcm_stream_unlock_irq(substream); 903 return -EBADFD; 904 } 905 snd_pcm_stream_unlock_irq(substream); 906 907 if (params->tstamp_mode < 0 || 908 params->tstamp_mode > SNDRV_PCM_TSTAMP_LAST) 909 return -EINVAL; 910 if (params->proto >= SNDRV_PROTOCOL_VERSION(2, 0, 12) && 911 params->tstamp_type > SNDRV_PCM_TSTAMP_TYPE_LAST) 912 return -EINVAL; 913 if (params->avail_min == 0) 914 return -EINVAL; 915 if (params->silence_size >= runtime->boundary) { 916 if (params->silence_threshold != 0) 917 return -EINVAL; 918 } else { 919 if (params->silence_size > params->silence_threshold) 920 return -EINVAL; 921 if (params->silence_threshold > runtime->buffer_size) 922 return -EINVAL; 923 } 924 err = 0; 925 snd_pcm_stream_lock_irq(substream); 926 runtime->tstamp_mode = params->tstamp_mode; 927 if (params->proto >= SNDRV_PROTOCOL_VERSION(2, 0, 12)) 928 runtime->tstamp_type = params->tstamp_type; 929 runtime->period_step = params->period_step; 930 runtime->control->avail_min = params->avail_min; 931 runtime->start_threshold = params->start_threshold; 932 runtime->stop_threshold = params->stop_threshold; 933 runtime->silence_threshold = params->silence_threshold; 934 runtime->silence_size = params->silence_size; 935 params->boundary = runtime->boundary; 936 if (snd_pcm_running(substream)) { 937 if (substream->stream == SNDRV_PCM_STREAM_PLAYBACK && 938 runtime->silence_size > 0) 939 snd_pcm_playback_silence(substream, ULONG_MAX); 940 err = snd_pcm_update_state(substream, runtime); 941 } 942 snd_pcm_stream_unlock_irq(substream); 943 return err; 944 } 945 946 static int snd_pcm_sw_params_user(struct snd_pcm_substream *substream, 947 struct snd_pcm_sw_params __user * _params) 948 { 949 struct snd_pcm_sw_params params; 950 int err; 951 if (copy_from_user(¶ms, _params, sizeof(params))) 952 return -EFAULT; 953 err = snd_pcm_sw_params(substream, ¶ms); 954 if (copy_to_user(_params, ¶ms, sizeof(params))) 955 return -EFAULT; 956 return err; 957 } 958 959 static inline snd_pcm_uframes_t 960 snd_pcm_calc_delay(struct snd_pcm_substream *substream) 961 { 962 snd_pcm_uframes_t delay; 963 964 if (substream->stream == SNDRV_PCM_STREAM_PLAYBACK) 965 delay = snd_pcm_playback_hw_avail(substream->runtime); 966 else 967 delay = snd_pcm_capture_avail(substream->runtime); 968 return delay + substream->runtime->delay; 969 } 970 971 int snd_pcm_status64(struct snd_pcm_substream *substream, 972 struct snd_pcm_status64 *status) 973 { 974 struct snd_pcm_runtime *runtime = substream->runtime; 975 976 snd_pcm_stream_lock_irq(substream); 977 978 snd_pcm_unpack_audio_tstamp_config(status->audio_tstamp_data, 979 &runtime->audio_tstamp_config); 980 981 /* backwards compatible behavior */ 982 if (runtime->audio_tstamp_config.type_requested == 983 SNDRV_PCM_AUDIO_TSTAMP_TYPE_COMPAT) { 984 if (runtime->hw.info & SNDRV_PCM_INFO_HAS_WALL_CLOCK) 985 runtime->audio_tstamp_config.type_requested = 986 SNDRV_PCM_AUDIO_TSTAMP_TYPE_LINK; 987 else 988 runtime->audio_tstamp_config.type_requested = 989 SNDRV_PCM_AUDIO_TSTAMP_TYPE_DEFAULT; 990 runtime->audio_tstamp_report.valid = 0; 991 } else 992 runtime->audio_tstamp_report.valid = 1; 993 994 status->state = runtime->status->state; 995 status->suspended_state = runtime->status->suspended_state; 996 if (status->state == SNDRV_PCM_STATE_OPEN) 997 goto _end; 998 status->trigger_tstamp_sec = runtime->trigger_tstamp.tv_sec; 999 status->trigger_tstamp_nsec = runtime->trigger_tstamp.tv_nsec; 1000 if (snd_pcm_running(substream)) { 1001 snd_pcm_update_hw_ptr(substream); 1002 if (runtime->tstamp_mode == SNDRV_PCM_TSTAMP_ENABLE) { 1003 status->tstamp_sec = runtime->status->tstamp.tv_sec; 1004 status->tstamp_nsec = 1005 runtime->status->tstamp.tv_nsec; 1006 status->driver_tstamp_sec = 1007 runtime->driver_tstamp.tv_sec; 1008 status->driver_tstamp_nsec = 1009 runtime->driver_tstamp.tv_nsec; 1010 status->audio_tstamp_sec = 1011 runtime->status->audio_tstamp.tv_sec; 1012 status->audio_tstamp_nsec = 1013 runtime->status->audio_tstamp.tv_nsec; 1014 if (runtime->audio_tstamp_report.valid == 1) 1015 /* backwards compatibility, no report provided in COMPAT mode */ 1016 snd_pcm_pack_audio_tstamp_report(&status->audio_tstamp_data, 1017 &status->audio_tstamp_accuracy, 1018 &runtime->audio_tstamp_report); 1019 1020 goto _tstamp_end; 1021 } 1022 } else { 1023 /* get tstamp only in fallback mode and only if enabled */ 1024 if (runtime->tstamp_mode == SNDRV_PCM_TSTAMP_ENABLE) { 1025 struct timespec64 tstamp; 1026 1027 snd_pcm_gettime(runtime, &tstamp); 1028 status->tstamp_sec = tstamp.tv_sec; 1029 status->tstamp_nsec = tstamp.tv_nsec; 1030 } 1031 } 1032 _tstamp_end: 1033 status->appl_ptr = runtime->control->appl_ptr; 1034 status->hw_ptr = runtime->status->hw_ptr; 1035 status->avail = snd_pcm_avail(substream); 1036 status->delay = snd_pcm_running(substream) ? 1037 snd_pcm_calc_delay(substream) : 0; 1038 status->avail_max = runtime->avail_max; 1039 status->overrange = runtime->overrange; 1040 runtime->avail_max = 0; 1041 runtime->overrange = 0; 1042 _end: 1043 snd_pcm_stream_unlock_irq(substream); 1044 return 0; 1045 } 1046 1047 static int snd_pcm_status_user64(struct snd_pcm_substream *substream, 1048 struct snd_pcm_status64 __user * _status, 1049 bool ext) 1050 { 1051 struct snd_pcm_status64 status; 1052 int res; 1053 1054 memset(&status, 0, sizeof(status)); 1055 /* 1056 * with extension, parameters are read/write, 1057 * get audio_tstamp_data from user, 1058 * ignore rest of status structure 1059 */ 1060 if (ext && get_user(status.audio_tstamp_data, 1061 (u32 __user *)(&_status->audio_tstamp_data))) 1062 return -EFAULT; 1063 res = snd_pcm_status64(substream, &status); 1064 if (res < 0) 1065 return res; 1066 if (copy_to_user(_status, &status, sizeof(status))) 1067 return -EFAULT; 1068 return 0; 1069 } 1070 1071 static int snd_pcm_status_user32(struct snd_pcm_substream *substream, 1072 struct snd_pcm_status32 __user * _status, 1073 bool ext) 1074 { 1075 struct snd_pcm_status64 status64; 1076 struct snd_pcm_status32 status32; 1077 int res; 1078 1079 memset(&status64, 0, sizeof(status64)); 1080 memset(&status32, 0, sizeof(status32)); 1081 /* 1082 * with extension, parameters are read/write, 1083 * get audio_tstamp_data from user, 1084 * ignore rest of status structure 1085 */ 1086 if (ext && get_user(status64.audio_tstamp_data, 1087 (u32 __user *)(&_status->audio_tstamp_data))) 1088 return -EFAULT; 1089 res = snd_pcm_status64(substream, &status64); 1090 if (res < 0) 1091 return res; 1092 1093 status32 = (struct snd_pcm_status32) { 1094 .state = status64.state, 1095 .trigger_tstamp_sec = status64.trigger_tstamp_sec, 1096 .trigger_tstamp_nsec = status64.trigger_tstamp_nsec, 1097 .tstamp_sec = status64.tstamp_sec, 1098 .tstamp_nsec = status64.tstamp_nsec, 1099 .appl_ptr = status64.appl_ptr, 1100 .hw_ptr = status64.hw_ptr, 1101 .delay = status64.delay, 1102 .avail = status64.avail, 1103 .avail_max = status64.avail_max, 1104 .overrange = status64.overrange, 1105 .suspended_state = status64.suspended_state, 1106 .audio_tstamp_data = status64.audio_tstamp_data, 1107 .audio_tstamp_sec = status64.audio_tstamp_sec, 1108 .audio_tstamp_nsec = status64.audio_tstamp_nsec, 1109 .driver_tstamp_sec = status64.audio_tstamp_sec, 1110 .driver_tstamp_nsec = status64.audio_tstamp_nsec, 1111 .audio_tstamp_accuracy = status64.audio_tstamp_accuracy, 1112 }; 1113 1114 if (copy_to_user(_status, &status32, sizeof(status32))) 1115 return -EFAULT; 1116 1117 return 0; 1118 } 1119 1120 static int snd_pcm_channel_info(struct snd_pcm_substream *substream, 1121 struct snd_pcm_channel_info * info) 1122 { 1123 struct snd_pcm_runtime *runtime; 1124 unsigned int channel; 1125 1126 channel = info->channel; 1127 runtime = substream->runtime; 1128 snd_pcm_stream_lock_irq(substream); 1129 if (runtime->status->state == SNDRV_PCM_STATE_OPEN) { 1130 snd_pcm_stream_unlock_irq(substream); 1131 return -EBADFD; 1132 } 1133 snd_pcm_stream_unlock_irq(substream); 1134 if (channel >= runtime->channels) 1135 return -EINVAL; 1136 memset(info, 0, sizeof(*info)); 1137 info->channel = channel; 1138 return snd_pcm_ops_ioctl(substream, SNDRV_PCM_IOCTL1_CHANNEL_INFO, info); 1139 } 1140 1141 static int snd_pcm_channel_info_user(struct snd_pcm_substream *substream, 1142 struct snd_pcm_channel_info __user * _info) 1143 { 1144 struct snd_pcm_channel_info info; 1145 int res; 1146 1147 if (copy_from_user(&info, _info, sizeof(info))) 1148 return -EFAULT; 1149 res = snd_pcm_channel_info(substream, &info); 1150 if (res < 0) 1151 return res; 1152 if (copy_to_user(_info, &info, sizeof(info))) 1153 return -EFAULT; 1154 return 0; 1155 } 1156 1157 static void snd_pcm_trigger_tstamp(struct snd_pcm_substream *substream) 1158 { 1159 struct snd_pcm_runtime *runtime = substream->runtime; 1160 if (runtime->trigger_master == NULL) 1161 return; 1162 if (runtime->trigger_master == substream) { 1163 if (!runtime->trigger_tstamp_latched) 1164 snd_pcm_gettime(runtime, &runtime->trigger_tstamp); 1165 } else { 1166 snd_pcm_trigger_tstamp(runtime->trigger_master); 1167 runtime->trigger_tstamp = runtime->trigger_master->runtime->trigger_tstamp; 1168 } 1169 runtime->trigger_master = NULL; 1170 } 1171 1172 #define ACTION_ARG_IGNORE (__force snd_pcm_state_t)0 1173 1174 struct action_ops { 1175 int (*pre_action)(struct snd_pcm_substream *substream, 1176 snd_pcm_state_t state); 1177 int (*do_action)(struct snd_pcm_substream *substream, 1178 snd_pcm_state_t state); 1179 void (*undo_action)(struct snd_pcm_substream *substream, 1180 snd_pcm_state_t state); 1181 void (*post_action)(struct snd_pcm_substream *substream, 1182 snd_pcm_state_t state); 1183 }; 1184 1185 /* 1186 * this functions is core for handling of linked stream 1187 * Note: the stream state might be changed also on failure 1188 * Note2: call with calling stream lock + link lock 1189 */ 1190 static int snd_pcm_action_group(const struct action_ops *ops, 1191 struct snd_pcm_substream *substream, 1192 snd_pcm_state_t state, 1193 bool stream_lock) 1194 { 1195 struct snd_pcm_substream *s = NULL; 1196 struct snd_pcm_substream *s1; 1197 int res = 0, depth = 1; 1198 1199 snd_pcm_group_for_each_entry(s, substream) { 1200 if (s != substream) { 1201 if (!stream_lock) 1202 mutex_lock_nested(&s->runtime->buffer_mutex, depth); 1203 else if (s->pcm->nonatomic) 1204 mutex_lock_nested(&s->self_group.mutex, depth); 1205 else 1206 spin_lock_nested(&s->self_group.lock, depth); 1207 depth++; 1208 } 1209 res = ops->pre_action(s, state); 1210 if (res < 0) 1211 goto _unlock; 1212 } 1213 snd_pcm_group_for_each_entry(s, substream) { 1214 res = ops->do_action(s, state); 1215 if (res < 0) { 1216 if (ops->undo_action) { 1217 snd_pcm_group_for_each_entry(s1, substream) { 1218 if (s1 == s) /* failed stream */ 1219 break; 1220 ops->undo_action(s1, state); 1221 } 1222 } 1223 s = NULL; /* unlock all */ 1224 goto _unlock; 1225 } 1226 } 1227 snd_pcm_group_for_each_entry(s, substream) { 1228 ops->post_action(s, state); 1229 } 1230 _unlock: 1231 /* unlock streams */ 1232 snd_pcm_group_for_each_entry(s1, substream) { 1233 if (s1 != substream) { 1234 if (!stream_lock) 1235 mutex_unlock(&s1->runtime->buffer_mutex); 1236 else if (s1->pcm->nonatomic) 1237 mutex_unlock(&s1->self_group.mutex); 1238 else 1239 spin_unlock(&s1->self_group.lock); 1240 } 1241 if (s1 == s) /* end */ 1242 break; 1243 } 1244 return res; 1245 } 1246 1247 /* 1248 * Note: call with stream lock 1249 */ 1250 static int snd_pcm_action_single(const struct action_ops *ops, 1251 struct snd_pcm_substream *substream, 1252 snd_pcm_state_t state) 1253 { 1254 int res; 1255 1256 res = ops->pre_action(substream, state); 1257 if (res < 0) 1258 return res; 1259 res = ops->do_action(substream, state); 1260 if (res == 0) 1261 ops->post_action(substream, state); 1262 else if (ops->undo_action) 1263 ops->undo_action(substream, state); 1264 return res; 1265 } 1266 1267 static void snd_pcm_group_assign(struct snd_pcm_substream *substream, 1268 struct snd_pcm_group *new_group) 1269 { 1270 substream->group = new_group; 1271 list_move(&substream->link_list, &new_group->substreams); 1272 } 1273 1274 /* 1275 * Unref and unlock the group, but keep the stream lock; 1276 * when the group becomes empty and no longer referred, destroy itself 1277 */ 1278 static void snd_pcm_group_unref(struct snd_pcm_group *group, 1279 struct snd_pcm_substream *substream) 1280 { 1281 bool do_free; 1282 1283 if (!group) 1284 return; 1285 do_free = refcount_dec_and_test(&group->refs); 1286 snd_pcm_group_unlock(group, substream->pcm->nonatomic); 1287 if (do_free) 1288 kfree(group); 1289 } 1290 1291 /* 1292 * Lock the group inside a stream lock and reference it; 1293 * return the locked group object, or NULL if not linked 1294 */ 1295 static struct snd_pcm_group * 1296 snd_pcm_stream_group_ref(struct snd_pcm_substream *substream) 1297 { 1298 bool nonatomic = substream->pcm->nonatomic; 1299 struct snd_pcm_group *group; 1300 bool trylock; 1301 1302 for (;;) { 1303 if (!snd_pcm_stream_linked(substream)) 1304 return NULL; 1305 group = substream->group; 1306 /* block freeing the group object */ 1307 refcount_inc(&group->refs); 1308 1309 trylock = nonatomic ? mutex_trylock(&group->mutex) : 1310 spin_trylock(&group->lock); 1311 if (trylock) 1312 break; /* OK */ 1313 1314 /* re-lock for avoiding ABBA deadlock */ 1315 snd_pcm_stream_unlock(substream); 1316 snd_pcm_group_lock(group, nonatomic); 1317 snd_pcm_stream_lock(substream); 1318 1319 /* check the group again; the above opens a small race window */ 1320 if (substream->group == group) 1321 break; /* OK */ 1322 /* group changed, try again */ 1323 snd_pcm_group_unref(group, substream); 1324 } 1325 return group; 1326 } 1327 1328 /* 1329 * Note: call with stream lock 1330 */ 1331 static int snd_pcm_action(const struct action_ops *ops, 1332 struct snd_pcm_substream *substream, 1333 snd_pcm_state_t state) 1334 { 1335 struct snd_pcm_group *group; 1336 int res; 1337 1338 group = snd_pcm_stream_group_ref(substream); 1339 if (group) 1340 res = snd_pcm_action_group(ops, substream, state, true); 1341 else 1342 res = snd_pcm_action_single(ops, substream, state); 1343 snd_pcm_group_unref(group, substream); 1344 return res; 1345 } 1346 1347 /* 1348 * Note: don't use any locks before 1349 */ 1350 static int snd_pcm_action_lock_irq(const struct action_ops *ops, 1351 struct snd_pcm_substream *substream, 1352 snd_pcm_state_t state) 1353 { 1354 int res; 1355 1356 snd_pcm_stream_lock_irq(substream); 1357 res = snd_pcm_action(ops, substream, state); 1358 snd_pcm_stream_unlock_irq(substream); 1359 return res; 1360 } 1361 1362 /* 1363 */ 1364 static int snd_pcm_action_nonatomic(const struct action_ops *ops, 1365 struct snd_pcm_substream *substream, 1366 snd_pcm_state_t state) 1367 { 1368 int res; 1369 1370 /* Guarantee the group members won't change during non-atomic action */ 1371 down_read(&snd_pcm_link_rwsem); 1372 mutex_lock(&substream->runtime->buffer_mutex); 1373 if (snd_pcm_stream_linked(substream)) 1374 res = snd_pcm_action_group(ops, substream, state, false); 1375 else 1376 res = snd_pcm_action_single(ops, substream, state); 1377 mutex_unlock(&substream->runtime->buffer_mutex); 1378 up_read(&snd_pcm_link_rwsem); 1379 return res; 1380 } 1381 1382 /* 1383 * start callbacks 1384 */ 1385 static int snd_pcm_pre_start(struct snd_pcm_substream *substream, 1386 snd_pcm_state_t state) 1387 { 1388 struct snd_pcm_runtime *runtime = substream->runtime; 1389 if (runtime->status->state != SNDRV_PCM_STATE_PREPARED) 1390 return -EBADFD; 1391 if (substream->stream == SNDRV_PCM_STREAM_PLAYBACK && 1392 !snd_pcm_playback_data(substream)) 1393 return -EPIPE; 1394 runtime->trigger_tstamp_latched = false; 1395 runtime->trigger_master = substream; 1396 return 0; 1397 } 1398 1399 static int snd_pcm_do_start(struct snd_pcm_substream *substream, 1400 snd_pcm_state_t state) 1401 { 1402 if (substream->runtime->trigger_master != substream) 1403 return 0; 1404 return substream->ops->trigger(substream, SNDRV_PCM_TRIGGER_START); 1405 } 1406 1407 static void snd_pcm_undo_start(struct snd_pcm_substream *substream, 1408 snd_pcm_state_t state) 1409 { 1410 if (substream->runtime->trigger_master == substream) 1411 substream->ops->trigger(substream, SNDRV_PCM_TRIGGER_STOP); 1412 } 1413 1414 static void snd_pcm_post_start(struct snd_pcm_substream *substream, 1415 snd_pcm_state_t state) 1416 { 1417 struct snd_pcm_runtime *runtime = substream->runtime; 1418 snd_pcm_trigger_tstamp(substream); 1419 runtime->hw_ptr_jiffies = jiffies; 1420 runtime->hw_ptr_buffer_jiffies = (runtime->buffer_size * HZ) / 1421 runtime->rate; 1422 runtime->status->state = state; 1423 if (substream->stream == SNDRV_PCM_STREAM_PLAYBACK && 1424 runtime->silence_size > 0) 1425 snd_pcm_playback_silence(substream, ULONG_MAX); 1426 snd_pcm_timer_notify(substream, SNDRV_TIMER_EVENT_MSTART); 1427 } 1428 1429 static const struct action_ops snd_pcm_action_start = { 1430 .pre_action = snd_pcm_pre_start, 1431 .do_action = snd_pcm_do_start, 1432 .undo_action = snd_pcm_undo_start, 1433 .post_action = snd_pcm_post_start 1434 }; 1435 1436 /** 1437 * snd_pcm_start - start all linked streams 1438 * @substream: the PCM substream instance 1439 * 1440 * Return: Zero if successful, or a negative error code. 1441 * The stream lock must be acquired before calling this function. 1442 */ 1443 int snd_pcm_start(struct snd_pcm_substream *substream) 1444 { 1445 return snd_pcm_action(&snd_pcm_action_start, substream, 1446 SNDRV_PCM_STATE_RUNNING); 1447 } 1448 1449 /* take the stream lock and start the streams */ 1450 static int snd_pcm_start_lock_irq(struct snd_pcm_substream *substream) 1451 { 1452 return snd_pcm_action_lock_irq(&snd_pcm_action_start, substream, 1453 SNDRV_PCM_STATE_RUNNING); 1454 } 1455 1456 /* 1457 * stop callbacks 1458 */ 1459 static int snd_pcm_pre_stop(struct snd_pcm_substream *substream, 1460 snd_pcm_state_t state) 1461 { 1462 struct snd_pcm_runtime *runtime = substream->runtime; 1463 if (runtime->status->state == SNDRV_PCM_STATE_OPEN) 1464 return -EBADFD; 1465 runtime->trigger_master = substream; 1466 return 0; 1467 } 1468 1469 static int snd_pcm_do_stop(struct snd_pcm_substream *substream, 1470 snd_pcm_state_t state) 1471 { 1472 if (substream->runtime->trigger_master == substream && 1473 snd_pcm_running(substream)) { 1474 substream->ops->trigger(substream, SNDRV_PCM_TRIGGER_STOP); 1475 substream->runtime->stop_operating = true; 1476 } 1477 return 0; /* unconditionally stop all substreams */ 1478 } 1479 1480 static void snd_pcm_post_stop(struct snd_pcm_substream *substream, 1481 snd_pcm_state_t state) 1482 { 1483 struct snd_pcm_runtime *runtime = substream->runtime; 1484 if (runtime->status->state != state) { 1485 snd_pcm_trigger_tstamp(substream); 1486 runtime->status->state = state; 1487 snd_pcm_timer_notify(substream, SNDRV_TIMER_EVENT_MSTOP); 1488 } 1489 wake_up(&runtime->sleep); 1490 wake_up(&runtime->tsleep); 1491 } 1492 1493 static const struct action_ops snd_pcm_action_stop = { 1494 .pre_action = snd_pcm_pre_stop, 1495 .do_action = snd_pcm_do_stop, 1496 .post_action = snd_pcm_post_stop 1497 }; 1498 1499 /** 1500 * snd_pcm_stop - try to stop all running streams in the substream group 1501 * @substream: the PCM substream instance 1502 * @state: PCM state after stopping the stream 1503 * 1504 * The state of each stream is then changed to the given state unconditionally. 1505 * 1506 * Return: Zero if successful, or a negative error code. 1507 */ 1508 int snd_pcm_stop(struct snd_pcm_substream *substream, snd_pcm_state_t state) 1509 { 1510 return snd_pcm_action(&snd_pcm_action_stop, substream, state); 1511 } 1512 EXPORT_SYMBOL(snd_pcm_stop); 1513 1514 /** 1515 * snd_pcm_drain_done - stop the DMA only when the given stream is playback 1516 * @substream: the PCM substream 1517 * 1518 * After stopping, the state is changed to SETUP. 1519 * Unlike snd_pcm_stop(), this affects only the given stream. 1520 * 1521 * Return: Zero if successful, or a negative error code. 1522 */ 1523 int snd_pcm_drain_done(struct snd_pcm_substream *substream) 1524 { 1525 return snd_pcm_action_single(&snd_pcm_action_stop, substream, 1526 SNDRV_PCM_STATE_SETUP); 1527 } 1528 1529 /** 1530 * snd_pcm_stop_xrun - stop the running streams as XRUN 1531 * @substream: the PCM substream instance 1532 * 1533 * This stops the given running substream (and all linked substreams) as XRUN. 1534 * Unlike snd_pcm_stop(), this function takes the substream lock by itself. 1535 * 1536 * Return: Zero if successful, or a negative error code. 1537 */ 1538 int snd_pcm_stop_xrun(struct snd_pcm_substream *substream) 1539 { 1540 unsigned long flags; 1541 1542 snd_pcm_stream_lock_irqsave(substream, flags); 1543 if (substream->runtime && snd_pcm_running(substream)) 1544 __snd_pcm_xrun(substream); 1545 snd_pcm_stream_unlock_irqrestore(substream, flags); 1546 return 0; 1547 } 1548 EXPORT_SYMBOL_GPL(snd_pcm_stop_xrun); 1549 1550 /* 1551 * pause callbacks: pass boolean (to start pause or resume) as state argument 1552 */ 1553 #define pause_pushed(state) (__force bool)(state) 1554 1555 static int snd_pcm_pre_pause(struct snd_pcm_substream *substream, 1556 snd_pcm_state_t state) 1557 { 1558 struct snd_pcm_runtime *runtime = substream->runtime; 1559 if (!(runtime->info & SNDRV_PCM_INFO_PAUSE)) 1560 return -ENOSYS; 1561 if (pause_pushed(state)) { 1562 if (runtime->status->state != SNDRV_PCM_STATE_RUNNING) 1563 return -EBADFD; 1564 } else if (runtime->status->state != SNDRV_PCM_STATE_PAUSED) 1565 return -EBADFD; 1566 runtime->trigger_master = substream; 1567 return 0; 1568 } 1569 1570 static int snd_pcm_do_pause(struct snd_pcm_substream *substream, 1571 snd_pcm_state_t state) 1572 { 1573 if (substream->runtime->trigger_master != substream) 1574 return 0; 1575 /* some drivers might use hw_ptr to recover from the pause - 1576 update the hw_ptr now */ 1577 if (pause_pushed(state)) 1578 snd_pcm_update_hw_ptr(substream); 1579 /* The jiffies check in snd_pcm_update_hw_ptr*() is done by 1580 * a delta between the current jiffies, this gives a large enough 1581 * delta, effectively to skip the check once. 1582 */ 1583 substream->runtime->hw_ptr_jiffies = jiffies - HZ * 1000; 1584 return substream->ops->trigger(substream, 1585 pause_pushed(state) ? 1586 SNDRV_PCM_TRIGGER_PAUSE_PUSH : 1587 SNDRV_PCM_TRIGGER_PAUSE_RELEASE); 1588 } 1589 1590 static void snd_pcm_undo_pause(struct snd_pcm_substream *substream, 1591 snd_pcm_state_t state) 1592 { 1593 if (substream->runtime->trigger_master == substream) 1594 substream->ops->trigger(substream, 1595 pause_pushed(state) ? 1596 SNDRV_PCM_TRIGGER_PAUSE_RELEASE : 1597 SNDRV_PCM_TRIGGER_PAUSE_PUSH); 1598 } 1599 1600 static void snd_pcm_post_pause(struct snd_pcm_substream *substream, 1601 snd_pcm_state_t state) 1602 { 1603 struct snd_pcm_runtime *runtime = substream->runtime; 1604 snd_pcm_trigger_tstamp(substream); 1605 if (pause_pushed(state)) { 1606 runtime->status->state = SNDRV_PCM_STATE_PAUSED; 1607 snd_pcm_timer_notify(substream, SNDRV_TIMER_EVENT_MPAUSE); 1608 wake_up(&runtime->sleep); 1609 wake_up(&runtime->tsleep); 1610 } else { 1611 runtime->status->state = SNDRV_PCM_STATE_RUNNING; 1612 snd_pcm_timer_notify(substream, SNDRV_TIMER_EVENT_MCONTINUE); 1613 } 1614 } 1615 1616 static const struct action_ops snd_pcm_action_pause = { 1617 .pre_action = snd_pcm_pre_pause, 1618 .do_action = snd_pcm_do_pause, 1619 .undo_action = snd_pcm_undo_pause, 1620 .post_action = snd_pcm_post_pause 1621 }; 1622 1623 /* 1624 * Push/release the pause for all linked streams. 1625 */ 1626 static int snd_pcm_pause(struct snd_pcm_substream *substream, bool push) 1627 { 1628 return snd_pcm_action(&snd_pcm_action_pause, substream, 1629 (__force snd_pcm_state_t)push); 1630 } 1631 1632 static int snd_pcm_pause_lock_irq(struct snd_pcm_substream *substream, 1633 bool push) 1634 { 1635 return snd_pcm_action_lock_irq(&snd_pcm_action_pause, substream, 1636 (__force snd_pcm_state_t)push); 1637 } 1638 1639 #ifdef CONFIG_PM 1640 /* suspend callback: state argument ignored */ 1641 1642 static int snd_pcm_pre_suspend(struct snd_pcm_substream *substream, 1643 snd_pcm_state_t state) 1644 { 1645 struct snd_pcm_runtime *runtime = substream->runtime; 1646 switch (runtime->status->state) { 1647 case SNDRV_PCM_STATE_SUSPENDED: 1648 return -EBUSY; 1649 /* unresumable PCM state; return -EBUSY for skipping suspend */ 1650 case SNDRV_PCM_STATE_OPEN: 1651 case SNDRV_PCM_STATE_SETUP: 1652 case SNDRV_PCM_STATE_DISCONNECTED: 1653 return -EBUSY; 1654 } 1655 runtime->trigger_master = substream; 1656 return 0; 1657 } 1658 1659 static int snd_pcm_do_suspend(struct snd_pcm_substream *substream, 1660 snd_pcm_state_t state) 1661 { 1662 struct snd_pcm_runtime *runtime = substream->runtime; 1663 if (runtime->trigger_master != substream) 1664 return 0; 1665 if (! snd_pcm_running(substream)) 1666 return 0; 1667 substream->ops->trigger(substream, SNDRV_PCM_TRIGGER_SUSPEND); 1668 runtime->stop_operating = true; 1669 return 0; /* suspend unconditionally */ 1670 } 1671 1672 static void snd_pcm_post_suspend(struct snd_pcm_substream *substream, 1673 snd_pcm_state_t state) 1674 { 1675 struct snd_pcm_runtime *runtime = substream->runtime; 1676 snd_pcm_trigger_tstamp(substream); 1677 runtime->status->suspended_state = runtime->status->state; 1678 runtime->status->state = SNDRV_PCM_STATE_SUSPENDED; 1679 snd_pcm_timer_notify(substream, SNDRV_TIMER_EVENT_MSUSPEND); 1680 wake_up(&runtime->sleep); 1681 wake_up(&runtime->tsleep); 1682 } 1683 1684 static const struct action_ops snd_pcm_action_suspend = { 1685 .pre_action = snd_pcm_pre_suspend, 1686 .do_action = snd_pcm_do_suspend, 1687 .post_action = snd_pcm_post_suspend 1688 }; 1689 1690 /* 1691 * snd_pcm_suspend - trigger SUSPEND to all linked streams 1692 * @substream: the PCM substream 1693 * 1694 * After this call, all streams are changed to SUSPENDED state. 1695 * 1696 * Return: Zero if successful, or a negative error code. 1697 */ 1698 static int snd_pcm_suspend(struct snd_pcm_substream *substream) 1699 { 1700 int err; 1701 unsigned long flags; 1702 1703 snd_pcm_stream_lock_irqsave(substream, flags); 1704 err = snd_pcm_action(&snd_pcm_action_suspend, substream, 1705 ACTION_ARG_IGNORE); 1706 snd_pcm_stream_unlock_irqrestore(substream, flags); 1707 return err; 1708 } 1709 1710 /** 1711 * snd_pcm_suspend_all - trigger SUSPEND to all substreams in the given pcm 1712 * @pcm: the PCM instance 1713 * 1714 * After this call, all streams are changed to SUSPENDED state. 1715 * 1716 * Return: Zero if successful (or @pcm is %NULL), or a negative error code. 1717 */ 1718 int snd_pcm_suspend_all(struct snd_pcm *pcm) 1719 { 1720 struct snd_pcm_substream *substream; 1721 int stream, err = 0; 1722 1723 if (! pcm) 1724 return 0; 1725 1726 for_each_pcm_substream(pcm, stream, substream) { 1727 /* FIXME: the open/close code should lock this as well */ 1728 if (!substream->runtime) 1729 continue; 1730 1731 /* 1732 * Skip BE dai link PCM's that are internal and may 1733 * not have their substream ops set. 1734 */ 1735 if (!substream->ops) 1736 continue; 1737 1738 err = snd_pcm_suspend(substream); 1739 if (err < 0 && err != -EBUSY) 1740 return err; 1741 } 1742 1743 for_each_pcm_substream(pcm, stream, substream) 1744 snd_pcm_sync_stop(substream, false); 1745 1746 return 0; 1747 } 1748 EXPORT_SYMBOL(snd_pcm_suspend_all); 1749 1750 /* resume callbacks: state argument ignored */ 1751 1752 static int snd_pcm_pre_resume(struct snd_pcm_substream *substream, 1753 snd_pcm_state_t state) 1754 { 1755 struct snd_pcm_runtime *runtime = substream->runtime; 1756 if (!(runtime->info & SNDRV_PCM_INFO_RESUME)) 1757 return -ENOSYS; 1758 runtime->trigger_master = substream; 1759 return 0; 1760 } 1761 1762 static int snd_pcm_do_resume(struct snd_pcm_substream *substream, 1763 snd_pcm_state_t state) 1764 { 1765 struct snd_pcm_runtime *runtime = substream->runtime; 1766 if (runtime->trigger_master != substream) 1767 return 0; 1768 /* DMA not running previously? */ 1769 if (runtime->status->suspended_state != SNDRV_PCM_STATE_RUNNING && 1770 (runtime->status->suspended_state != SNDRV_PCM_STATE_DRAINING || 1771 substream->stream != SNDRV_PCM_STREAM_PLAYBACK)) 1772 return 0; 1773 return substream->ops->trigger(substream, SNDRV_PCM_TRIGGER_RESUME); 1774 } 1775 1776 static void snd_pcm_undo_resume(struct snd_pcm_substream *substream, 1777 snd_pcm_state_t state) 1778 { 1779 if (substream->runtime->trigger_master == substream && 1780 snd_pcm_running(substream)) 1781 substream->ops->trigger(substream, SNDRV_PCM_TRIGGER_SUSPEND); 1782 } 1783 1784 static void snd_pcm_post_resume(struct snd_pcm_substream *substream, 1785 snd_pcm_state_t state) 1786 { 1787 struct snd_pcm_runtime *runtime = substream->runtime; 1788 snd_pcm_trigger_tstamp(substream); 1789 runtime->status->state = runtime->status->suspended_state; 1790 snd_pcm_timer_notify(substream, SNDRV_TIMER_EVENT_MRESUME); 1791 } 1792 1793 static const struct action_ops snd_pcm_action_resume = { 1794 .pre_action = snd_pcm_pre_resume, 1795 .do_action = snd_pcm_do_resume, 1796 .undo_action = snd_pcm_undo_resume, 1797 .post_action = snd_pcm_post_resume 1798 }; 1799 1800 static int snd_pcm_resume(struct snd_pcm_substream *substream) 1801 { 1802 return snd_pcm_action_lock_irq(&snd_pcm_action_resume, substream, 1803 ACTION_ARG_IGNORE); 1804 } 1805 1806 #else 1807 1808 static int snd_pcm_resume(struct snd_pcm_substream *substream) 1809 { 1810 return -ENOSYS; 1811 } 1812 1813 #endif /* CONFIG_PM */ 1814 1815 /* 1816 * xrun ioctl 1817 * 1818 * Change the RUNNING stream(s) to XRUN state. 1819 */ 1820 static int snd_pcm_xrun(struct snd_pcm_substream *substream) 1821 { 1822 struct snd_pcm_runtime *runtime = substream->runtime; 1823 int result; 1824 1825 snd_pcm_stream_lock_irq(substream); 1826 switch (runtime->status->state) { 1827 case SNDRV_PCM_STATE_XRUN: 1828 result = 0; /* already there */ 1829 break; 1830 case SNDRV_PCM_STATE_RUNNING: 1831 __snd_pcm_xrun(substream); 1832 result = 0; 1833 break; 1834 default: 1835 result = -EBADFD; 1836 } 1837 snd_pcm_stream_unlock_irq(substream); 1838 return result; 1839 } 1840 1841 /* 1842 * reset ioctl 1843 */ 1844 /* reset callbacks: state argument ignored */ 1845 static int snd_pcm_pre_reset(struct snd_pcm_substream *substream, 1846 snd_pcm_state_t state) 1847 { 1848 struct snd_pcm_runtime *runtime = substream->runtime; 1849 switch (runtime->status->state) { 1850 case SNDRV_PCM_STATE_RUNNING: 1851 case SNDRV_PCM_STATE_PREPARED: 1852 case SNDRV_PCM_STATE_PAUSED: 1853 case SNDRV_PCM_STATE_SUSPENDED: 1854 return 0; 1855 default: 1856 return -EBADFD; 1857 } 1858 } 1859 1860 static int snd_pcm_do_reset(struct snd_pcm_substream *substream, 1861 snd_pcm_state_t state) 1862 { 1863 struct snd_pcm_runtime *runtime = substream->runtime; 1864 int err = snd_pcm_ops_ioctl(substream, SNDRV_PCM_IOCTL1_RESET, NULL); 1865 if (err < 0) 1866 return err; 1867 snd_pcm_stream_lock_irq(substream); 1868 runtime->hw_ptr_base = 0; 1869 runtime->hw_ptr_interrupt = runtime->status->hw_ptr - 1870 runtime->status->hw_ptr % runtime->period_size; 1871 runtime->silence_start = runtime->status->hw_ptr; 1872 runtime->silence_filled = 0; 1873 snd_pcm_stream_unlock_irq(substream); 1874 return 0; 1875 } 1876 1877 static void snd_pcm_post_reset(struct snd_pcm_substream *substream, 1878 snd_pcm_state_t state) 1879 { 1880 struct snd_pcm_runtime *runtime = substream->runtime; 1881 snd_pcm_stream_lock_irq(substream); 1882 runtime->control->appl_ptr = runtime->status->hw_ptr; 1883 if (substream->stream == SNDRV_PCM_STREAM_PLAYBACK && 1884 runtime->silence_size > 0) 1885 snd_pcm_playback_silence(substream, ULONG_MAX); 1886 snd_pcm_stream_unlock_irq(substream); 1887 } 1888 1889 static const struct action_ops snd_pcm_action_reset = { 1890 .pre_action = snd_pcm_pre_reset, 1891 .do_action = snd_pcm_do_reset, 1892 .post_action = snd_pcm_post_reset 1893 }; 1894 1895 static int snd_pcm_reset(struct snd_pcm_substream *substream) 1896 { 1897 return snd_pcm_action_nonatomic(&snd_pcm_action_reset, substream, 1898 ACTION_ARG_IGNORE); 1899 } 1900 1901 /* 1902 * prepare ioctl 1903 */ 1904 /* pass f_flags as state argument */ 1905 static int snd_pcm_pre_prepare(struct snd_pcm_substream *substream, 1906 snd_pcm_state_t state) 1907 { 1908 struct snd_pcm_runtime *runtime = substream->runtime; 1909 int f_flags = (__force int)state; 1910 1911 if (runtime->status->state == SNDRV_PCM_STATE_OPEN || 1912 runtime->status->state == SNDRV_PCM_STATE_DISCONNECTED) 1913 return -EBADFD; 1914 if (snd_pcm_running(substream)) 1915 return -EBUSY; 1916 substream->f_flags = f_flags; 1917 return 0; 1918 } 1919 1920 static int snd_pcm_do_prepare(struct snd_pcm_substream *substream, 1921 snd_pcm_state_t state) 1922 { 1923 int err; 1924 snd_pcm_sync_stop(substream, true); 1925 err = substream->ops->prepare(substream); 1926 if (err < 0) 1927 return err; 1928 return snd_pcm_do_reset(substream, state); 1929 } 1930 1931 static void snd_pcm_post_prepare(struct snd_pcm_substream *substream, 1932 snd_pcm_state_t state) 1933 { 1934 struct snd_pcm_runtime *runtime = substream->runtime; 1935 runtime->control->appl_ptr = runtime->status->hw_ptr; 1936 snd_pcm_set_state(substream, SNDRV_PCM_STATE_PREPARED); 1937 } 1938 1939 static const struct action_ops snd_pcm_action_prepare = { 1940 .pre_action = snd_pcm_pre_prepare, 1941 .do_action = snd_pcm_do_prepare, 1942 .post_action = snd_pcm_post_prepare 1943 }; 1944 1945 /** 1946 * snd_pcm_prepare - prepare the PCM substream to be triggerable 1947 * @substream: the PCM substream instance 1948 * @file: file to refer f_flags 1949 * 1950 * Return: Zero if successful, or a negative error code. 1951 */ 1952 static int snd_pcm_prepare(struct snd_pcm_substream *substream, 1953 struct file *file) 1954 { 1955 int f_flags; 1956 1957 if (file) 1958 f_flags = file->f_flags; 1959 else 1960 f_flags = substream->f_flags; 1961 1962 snd_pcm_stream_lock_irq(substream); 1963 switch (substream->runtime->status->state) { 1964 case SNDRV_PCM_STATE_PAUSED: 1965 snd_pcm_pause(substream, false); 1966 fallthrough; 1967 case SNDRV_PCM_STATE_SUSPENDED: 1968 snd_pcm_stop(substream, SNDRV_PCM_STATE_SETUP); 1969 break; 1970 } 1971 snd_pcm_stream_unlock_irq(substream); 1972 1973 return snd_pcm_action_nonatomic(&snd_pcm_action_prepare, 1974 substream, 1975 (__force snd_pcm_state_t)f_flags); 1976 } 1977 1978 /* 1979 * drain ioctl 1980 */ 1981 1982 /* drain init callbacks: state argument ignored */ 1983 static int snd_pcm_pre_drain_init(struct snd_pcm_substream *substream, 1984 snd_pcm_state_t state) 1985 { 1986 struct snd_pcm_runtime *runtime = substream->runtime; 1987 switch (runtime->status->state) { 1988 case SNDRV_PCM_STATE_OPEN: 1989 case SNDRV_PCM_STATE_DISCONNECTED: 1990 case SNDRV_PCM_STATE_SUSPENDED: 1991 return -EBADFD; 1992 } 1993 runtime->trigger_master = substream; 1994 return 0; 1995 } 1996 1997 static int snd_pcm_do_drain_init(struct snd_pcm_substream *substream, 1998 snd_pcm_state_t state) 1999 { 2000 struct snd_pcm_runtime *runtime = substream->runtime; 2001 if (substream->stream == SNDRV_PCM_STREAM_PLAYBACK) { 2002 switch (runtime->status->state) { 2003 case SNDRV_PCM_STATE_PREPARED: 2004 /* start playback stream if possible */ 2005 if (! snd_pcm_playback_empty(substream)) { 2006 snd_pcm_do_start(substream, SNDRV_PCM_STATE_DRAINING); 2007 snd_pcm_post_start(substream, SNDRV_PCM_STATE_DRAINING); 2008 } else { 2009 runtime->status->state = SNDRV_PCM_STATE_SETUP; 2010 } 2011 break; 2012 case SNDRV_PCM_STATE_RUNNING: 2013 runtime->status->state = SNDRV_PCM_STATE_DRAINING; 2014 break; 2015 case SNDRV_PCM_STATE_XRUN: 2016 runtime->status->state = SNDRV_PCM_STATE_SETUP; 2017 break; 2018 default: 2019 break; 2020 } 2021 } else { 2022 /* stop running stream */ 2023 if (runtime->status->state == SNDRV_PCM_STATE_RUNNING) { 2024 snd_pcm_state_t new_state; 2025 2026 new_state = snd_pcm_capture_avail(runtime) > 0 ? 2027 SNDRV_PCM_STATE_DRAINING : SNDRV_PCM_STATE_SETUP; 2028 snd_pcm_do_stop(substream, new_state); 2029 snd_pcm_post_stop(substream, new_state); 2030 } 2031 } 2032 2033 if (runtime->status->state == SNDRV_PCM_STATE_DRAINING && 2034 runtime->trigger_master == substream && 2035 (runtime->hw.info & SNDRV_PCM_INFO_DRAIN_TRIGGER)) 2036 return substream->ops->trigger(substream, 2037 SNDRV_PCM_TRIGGER_DRAIN); 2038 2039 return 0; 2040 } 2041 2042 static void snd_pcm_post_drain_init(struct snd_pcm_substream *substream, 2043 snd_pcm_state_t state) 2044 { 2045 } 2046 2047 static const struct action_ops snd_pcm_action_drain_init = { 2048 .pre_action = snd_pcm_pre_drain_init, 2049 .do_action = snd_pcm_do_drain_init, 2050 .post_action = snd_pcm_post_drain_init 2051 }; 2052 2053 /* 2054 * Drain the stream(s). 2055 * When the substream is linked, sync until the draining of all playback streams 2056 * is finished. 2057 * After this call, all streams are supposed to be either SETUP or DRAINING 2058 * (capture only) state. 2059 */ 2060 static int snd_pcm_drain(struct snd_pcm_substream *substream, 2061 struct file *file) 2062 { 2063 struct snd_card *card; 2064 struct snd_pcm_runtime *runtime; 2065 struct snd_pcm_substream *s; 2066 struct snd_pcm_group *group; 2067 wait_queue_entry_t wait; 2068 int result = 0; 2069 int nonblock = 0; 2070 2071 card = substream->pcm->card; 2072 runtime = substream->runtime; 2073 2074 if (runtime->status->state == SNDRV_PCM_STATE_OPEN) 2075 return -EBADFD; 2076 2077 if (file) { 2078 if (file->f_flags & O_NONBLOCK) 2079 nonblock = 1; 2080 } else if (substream->f_flags & O_NONBLOCK) 2081 nonblock = 1; 2082 2083 snd_pcm_stream_lock_irq(substream); 2084 /* resume pause */ 2085 if (runtime->status->state == SNDRV_PCM_STATE_PAUSED) 2086 snd_pcm_pause(substream, false); 2087 2088 /* pre-start/stop - all running streams are changed to DRAINING state */ 2089 result = snd_pcm_action(&snd_pcm_action_drain_init, substream, 2090 ACTION_ARG_IGNORE); 2091 if (result < 0) 2092 goto unlock; 2093 /* in non-blocking, we don't wait in ioctl but let caller poll */ 2094 if (nonblock) { 2095 result = -EAGAIN; 2096 goto unlock; 2097 } 2098 2099 for (;;) { 2100 long tout; 2101 struct snd_pcm_runtime *to_check; 2102 if (signal_pending(current)) { 2103 result = -ERESTARTSYS; 2104 break; 2105 } 2106 /* find a substream to drain */ 2107 to_check = NULL; 2108 group = snd_pcm_stream_group_ref(substream); 2109 snd_pcm_group_for_each_entry(s, substream) { 2110 if (s->stream != SNDRV_PCM_STREAM_PLAYBACK) 2111 continue; 2112 runtime = s->runtime; 2113 if (runtime->status->state == SNDRV_PCM_STATE_DRAINING) { 2114 to_check = runtime; 2115 break; 2116 } 2117 } 2118 snd_pcm_group_unref(group, substream); 2119 if (!to_check) 2120 break; /* all drained */ 2121 init_waitqueue_entry(&wait, current); 2122 set_current_state(TASK_INTERRUPTIBLE); 2123 add_wait_queue(&to_check->sleep, &wait); 2124 snd_pcm_stream_unlock_irq(substream); 2125 if (runtime->no_period_wakeup) 2126 tout = MAX_SCHEDULE_TIMEOUT; 2127 else { 2128 tout = 10; 2129 if (runtime->rate) { 2130 long t = runtime->period_size * 2 / runtime->rate; 2131 tout = max(t, tout); 2132 } 2133 tout = msecs_to_jiffies(tout * 1000); 2134 } 2135 tout = schedule_timeout(tout); 2136 2137 snd_pcm_stream_lock_irq(substream); 2138 group = snd_pcm_stream_group_ref(substream); 2139 snd_pcm_group_for_each_entry(s, substream) { 2140 if (s->runtime == to_check) { 2141 remove_wait_queue(&to_check->sleep, &wait); 2142 break; 2143 } 2144 } 2145 snd_pcm_group_unref(group, substream); 2146 2147 if (card->shutdown) { 2148 result = -ENODEV; 2149 break; 2150 } 2151 if (tout == 0) { 2152 if (substream->runtime->status->state == SNDRV_PCM_STATE_SUSPENDED) 2153 result = -ESTRPIPE; 2154 else { 2155 dev_dbg(substream->pcm->card->dev, 2156 "playback drain error (DMA or IRQ trouble?)\n"); 2157 snd_pcm_stop(substream, SNDRV_PCM_STATE_SETUP); 2158 result = -EIO; 2159 } 2160 break; 2161 } 2162 } 2163 2164 unlock: 2165 snd_pcm_stream_unlock_irq(substream); 2166 2167 return result; 2168 } 2169 2170 /* 2171 * drop ioctl 2172 * 2173 * Immediately put all linked substreams into SETUP state. 2174 */ 2175 static int snd_pcm_drop(struct snd_pcm_substream *substream) 2176 { 2177 struct snd_pcm_runtime *runtime; 2178 int result = 0; 2179 2180 if (PCM_RUNTIME_CHECK(substream)) 2181 return -ENXIO; 2182 runtime = substream->runtime; 2183 2184 if (runtime->status->state == SNDRV_PCM_STATE_OPEN || 2185 runtime->status->state == SNDRV_PCM_STATE_DISCONNECTED) 2186 return -EBADFD; 2187 2188 snd_pcm_stream_lock_irq(substream); 2189 /* resume pause */ 2190 if (runtime->status->state == SNDRV_PCM_STATE_PAUSED) 2191 snd_pcm_pause(substream, false); 2192 2193 snd_pcm_stop(substream, SNDRV_PCM_STATE_SETUP); 2194 /* runtime->control->appl_ptr = runtime->status->hw_ptr; */ 2195 snd_pcm_stream_unlock_irq(substream); 2196 2197 return result; 2198 } 2199 2200 2201 static bool is_pcm_file(struct file *file) 2202 { 2203 struct inode *inode = file_inode(file); 2204 struct snd_pcm *pcm; 2205 unsigned int minor; 2206 2207 if (!S_ISCHR(inode->i_mode) || imajor(inode) != snd_major) 2208 return false; 2209 minor = iminor(inode); 2210 pcm = snd_lookup_minor_data(minor, SNDRV_DEVICE_TYPE_PCM_PLAYBACK); 2211 if (!pcm) 2212 pcm = snd_lookup_minor_data(minor, SNDRV_DEVICE_TYPE_PCM_CAPTURE); 2213 if (!pcm) 2214 return false; 2215 snd_card_unref(pcm->card); 2216 return true; 2217 } 2218 2219 /* 2220 * PCM link handling 2221 */ 2222 static int snd_pcm_link(struct snd_pcm_substream *substream, int fd) 2223 { 2224 int res = 0; 2225 struct snd_pcm_file *pcm_file; 2226 struct snd_pcm_substream *substream1; 2227 struct snd_pcm_group *group, *target_group; 2228 bool nonatomic = substream->pcm->nonatomic; 2229 struct fd f = fdget(fd); 2230 2231 if (!f.file) 2232 return -EBADFD; 2233 if (!is_pcm_file(f.file)) { 2234 res = -EBADFD; 2235 goto _badf; 2236 } 2237 pcm_file = f.file->private_data; 2238 substream1 = pcm_file->substream; 2239 2240 if (substream == substream1) { 2241 res = -EINVAL; 2242 goto _badf; 2243 } 2244 2245 group = kzalloc(sizeof(*group), GFP_KERNEL); 2246 if (!group) { 2247 res = -ENOMEM; 2248 goto _nolock; 2249 } 2250 snd_pcm_group_init(group); 2251 2252 down_write(&snd_pcm_link_rwsem); 2253 if (substream->runtime->status->state == SNDRV_PCM_STATE_OPEN || 2254 substream->runtime->status->state != substream1->runtime->status->state || 2255 substream->pcm->nonatomic != substream1->pcm->nonatomic) { 2256 res = -EBADFD; 2257 goto _end; 2258 } 2259 if (snd_pcm_stream_linked(substream1)) { 2260 res = -EALREADY; 2261 goto _end; 2262 } 2263 2264 snd_pcm_stream_lock_irq(substream); 2265 if (!snd_pcm_stream_linked(substream)) { 2266 snd_pcm_group_assign(substream, group); 2267 group = NULL; /* assigned, don't free this one below */ 2268 } 2269 target_group = substream->group; 2270 snd_pcm_stream_unlock_irq(substream); 2271 2272 snd_pcm_group_lock_irq(target_group, nonatomic); 2273 snd_pcm_stream_lock_nested(substream1); 2274 snd_pcm_group_assign(substream1, target_group); 2275 refcount_inc(&target_group->refs); 2276 snd_pcm_stream_unlock(substream1); 2277 snd_pcm_group_unlock_irq(target_group, nonatomic); 2278 _end: 2279 up_write(&snd_pcm_link_rwsem); 2280 _nolock: 2281 kfree(group); 2282 _badf: 2283 fdput(f); 2284 return res; 2285 } 2286 2287 static void relink_to_local(struct snd_pcm_substream *substream) 2288 { 2289 snd_pcm_stream_lock_nested(substream); 2290 snd_pcm_group_assign(substream, &substream->self_group); 2291 snd_pcm_stream_unlock(substream); 2292 } 2293 2294 static int snd_pcm_unlink(struct snd_pcm_substream *substream) 2295 { 2296 struct snd_pcm_group *group; 2297 bool nonatomic = substream->pcm->nonatomic; 2298 bool do_free = false; 2299 int res = 0; 2300 2301 down_write(&snd_pcm_link_rwsem); 2302 2303 if (!snd_pcm_stream_linked(substream)) { 2304 res = -EALREADY; 2305 goto _end; 2306 } 2307 2308 group = substream->group; 2309 snd_pcm_group_lock_irq(group, nonatomic); 2310 2311 relink_to_local(substream); 2312 refcount_dec(&group->refs); 2313 2314 /* detach the last stream, too */ 2315 if (list_is_singular(&group->substreams)) { 2316 relink_to_local(list_first_entry(&group->substreams, 2317 struct snd_pcm_substream, 2318 link_list)); 2319 do_free = refcount_dec_and_test(&group->refs); 2320 } 2321 2322 snd_pcm_group_unlock_irq(group, nonatomic); 2323 if (do_free) 2324 kfree(group); 2325 2326 _end: 2327 up_write(&snd_pcm_link_rwsem); 2328 return res; 2329 } 2330 2331 /* 2332 * hw configurator 2333 */ 2334 static int snd_pcm_hw_rule_mul(struct snd_pcm_hw_params *params, 2335 struct snd_pcm_hw_rule *rule) 2336 { 2337 struct snd_interval t; 2338 snd_interval_mul(hw_param_interval_c(params, rule->deps[0]), 2339 hw_param_interval_c(params, rule->deps[1]), &t); 2340 return snd_interval_refine(hw_param_interval(params, rule->var), &t); 2341 } 2342 2343 static int snd_pcm_hw_rule_div(struct snd_pcm_hw_params *params, 2344 struct snd_pcm_hw_rule *rule) 2345 { 2346 struct snd_interval t; 2347 snd_interval_div(hw_param_interval_c(params, rule->deps[0]), 2348 hw_param_interval_c(params, rule->deps[1]), &t); 2349 return snd_interval_refine(hw_param_interval(params, rule->var), &t); 2350 } 2351 2352 static int snd_pcm_hw_rule_muldivk(struct snd_pcm_hw_params *params, 2353 struct snd_pcm_hw_rule *rule) 2354 { 2355 struct snd_interval t; 2356 snd_interval_muldivk(hw_param_interval_c(params, rule->deps[0]), 2357 hw_param_interval_c(params, rule->deps[1]), 2358 (unsigned long) rule->private, &t); 2359 return snd_interval_refine(hw_param_interval(params, rule->var), &t); 2360 } 2361 2362 static int snd_pcm_hw_rule_mulkdiv(struct snd_pcm_hw_params *params, 2363 struct snd_pcm_hw_rule *rule) 2364 { 2365 struct snd_interval t; 2366 snd_interval_mulkdiv(hw_param_interval_c(params, rule->deps[0]), 2367 (unsigned long) rule->private, 2368 hw_param_interval_c(params, rule->deps[1]), &t); 2369 return snd_interval_refine(hw_param_interval(params, rule->var), &t); 2370 } 2371 2372 static int snd_pcm_hw_rule_format(struct snd_pcm_hw_params *params, 2373 struct snd_pcm_hw_rule *rule) 2374 { 2375 snd_pcm_format_t k; 2376 const struct snd_interval *i = 2377 hw_param_interval_c(params, rule->deps[0]); 2378 struct snd_mask m; 2379 struct snd_mask *mask = hw_param_mask(params, SNDRV_PCM_HW_PARAM_FORMAT); 2380 snd_mask_any(&m); 2381 pcm_for_each_format(k) { 2382 int bits; 2383 if (!snd_mask_test_format(mask, k)) 2384 continue; 2385 bits = snd_pcm_format_physical_width(k); 2386 if (bits <= 0) 2387 continue; /* ignore invalid formats */ 2388 if ((unsigned)bits < i->min || (unsigned)bits > i->max) 2389 snd_mask_reset(&m, (__force unsigned)k); 2390 } 2391 return snd_mask_refine(mask, &m); 2392 } 2393 2394 static int snd_pcm_hw_rule_sample_bits(struct snd_pcm_hw_params *params, 2395 struct snd_pcm_hw_rule *rule) 2396 { 2397 struct snd_interval t; 2398 snd_pcm_format_t k; 2399 2400 t.min = UINT_MAX; 2401 t.max = 0; 2402 t.openmin = 0; 2403 t.openmax = 0; 2404 pcm_for_each_format(k) { 2405 int bits; 2406 if (!snd_mask_test_format(hw_param_mask(params, SNDRV_PCM_HW_PARAM_FORMAT), k)) 2407 continue; 2408 bits = snd_pcm_format_physical_width(k); 2409 if (bits <= 0) 2410 continue; /* ignore invalid formats */ 2411 if (t.min > (unsigned)bits) 2412 t.min = bits; 2413 if (t.max < (unsigned)bits) 2414 t.max = bits; 2415 } 2416 t.integer = 1; 2417 return snd_interval_refine(hw_param_interval(params, rule->var), &t); 2418 } 2419 2420 #if SNDRV_PCM_RATE_5512 != 1 << 0 || SNDRV_PCM_RATE_192000 != 1 << 12 2421 #error "Change this table" 2422 #endif 2423 2424 static const unsigned int rates[] = { 2425 5512, 8000, 11025, 16000, 22050, 32000, 44100, 2426 48000, 64000, 88200, 96000, 176400, 192000, 352800, 384000 2427 }; 2428 2429 const struct snd_pcm_hw_constraint_list snd_pcm_known_rates = { 2430 .count = ARRAY_SIZE(rates), 2431 .list = rates, 2432 }; 2433 2434 static int snd_pcm_hw_rule_rate(struct snd_pcm_hw_params *params, 2435 struct snd_pcm_hw_rule *rule) 2436 { 2437 struct snd_pcm_hardware *hw = rule->private; 2438 return snd_interval_list(hw_param_interval(params, rule->var), 2439 snd_pcm_known_rates.count, 2440 snd_pcm_known_rates.list, hw->rates); 2441 } 2442 2443 static int snd_pcm_hw_rule_buffer_bytes_max(struct snd_pcm_hw_params *params, 2444 struct snd_pcm_hw_rule *rule) 2445 { 2446 struct snd_interval t; 2447 struct snd_pcm_substream *substream = rule->private; 2448 t.min = 0; 2449 t.max = substream->buffer_bytes_max; 2450 t.openmin = 0; 2451 t.openmax = 0; 2452 t.integer = 1; 2453 return snd_interval_refine(hw_param_interval(params, rule->var), &t); 2454 } 2455 2456 static int snd_pcm_hw_constraints_init(struct snd_pcm_substream *substream) 2457 { 2458 struct snd_pcm_runtime *runtime = substream->runtime; 2459 struct snd_pcm_hw_constraints *constrs = &runtime->hw_constraints; 2460 int k, err; 2461 2462 for (k = SNDRV_PCM_HW_PARAM_FIRST_MASK; k <= SNDRV_PCM_HW_PARAM_LAST_MASK; k++) { 2463 snd_mask_any(constrs_mask(constrs, k)); 2464 } 2465 2466 for (k = SNDRV_PCM_HW_PARAM_FIRST_INTERVAL; k <= SNDRV_PCM_HW_PARAM_LAST_INTERVAL; k++) { 2467 snd_interval_any(constrs_interval(constrs, k)); 2468 } 2469 2470 snd_interval_setinteger(constrs_interval(constrs, SNDRV_PCM_HW_PARAM_CHANNELS)); 2471 snd_interval_setinteger(constrs_interval(constrs, SNDRV_PCM_HW_PARAM_BUFFER_SIZE)); 2472 snd_interval_setinteger(constrs_interval(constrs, SNDRV_PCM_HW_PARAM_BUFFER_BYTES)); 2473 snd_interval_setinteger(constrs_interval(constrs, SNDRV_PCM_HW_PARAM_SAMPLE_BITS)); 2474 snd_interval_setinteger(constrs_interval(constrs, SNDRV_PCM_HW_PARAM_FRAME_BITS)); 2475 2476 err = snd_pcm_hw_rule_add(runtime, 0, SNDRV_PCM_HW_PARAM_FORMAT, 2477 snd_pcm_hw_rule_format, NULL, 2478 SNDRV_PCM_HW_PARAM_SAMPLE_BITS, -1); 2479 if (err < 0) 2480 return err; 2481 err = snd_pcm_hw_rule_add(runtime, 0, SNDRV_PCM_HW_PARAM_SAMPLE_BITS, 2482 snd_pcm_hw_rule_sample_bits, NULL, 2483 SNDRV_PCM_HW_PARAM_FORMAT, 2484 SNDRV_PCM_HW_PARAM_SAMPLE_BITS, -1); 2485 if (err < 0) 2486 return err; 2487 err = snd_pcm_hw_rule_add(runtime, 0, SNDRV_PCM_HW_PARAM_SAMPLE_BITS, 2488 snd_pcm_hw_rule_div, NULL, 2489 SNDRV_PCM_HW_PARAM_FRAME_BITS, SNDRV_PCM_HW_PARAM_CHANNELS, -1); 2490 if (err < 0) 2491 return err; 2492 err = snd_pcm_hw_rule_add(runtime, 0, SNDRV_PCM_HW_PARAM_FRAME_BITS, 2493 snd_pcm_hw_rule_mul, NULL, 2494 SNDRV_PCM_HW_PARAM_SAMPLE_BITS, SNDRV_PCM_HW_PARAM_CHANNELS, -1); 2495 if (err < 0) 2496 return err; 2497 err = snd_pcm_hw_rule_add(runtime, 0, SNDRV_PCM_HW_PARAM_FRAME_BITS, 2498 snd_pcm_hw_rule_mulkdiv, (void*) 8, 2499 SNDRV_PCM_HW_PARAM_PERIOD_BYTES, SNDRV_PCM_HW_PARAM_PERIOD_SIZE, -1); 2500 if (err < 0) 2501 return err; 2502 err = snd_pcm_hw_rule_add(runtime, 0, SNDRV_PCM_HW_PARAM_FRAME_BITS, 2503 snd_pcm_hw_rule_mulkdiv, (void*) 8, 2504 SNDRV_PCM_HW_PARAM_BUFFER_BYTES, SNDRV_PCM_HW_PARAM_BUFFER_SIZE, -1); 2505 if (err < 0) 2506 return err; 2507 err = snd_pcm_hw_rule_add(runtime, 0, SNDRV_PCM_HW_PARAM_CHANNELS, 2508 snd_pcm_hw_rule_div, NULL, 2509 SNDRV_PCM_HW_PARAM_FRAME_BITS, SNDRV_PCM_HW_PARAM_SAMPLE_BITS, -1); 2510 if (err < 0) 2511 return err; 2512 err = snd_pcm_hw_rule_add(runtime, 0, SNDRV_PCM_HW_PARAM_RATE, 2513 snd_pcm_hw_rule_mulkdiv, (void*) 1000000, 2514 SNDRV_PCM_HW_PARAM_PERIOD_SIZE, SNDRV_PCM_HW_PARAM_PERIOD_TIME, -1); 2515 if (err < 0) 2516 return err; 2517 err = snd_pcm_hw_rule_add(runtime, 0, SNDRV_PCM_HW_PARAM_RATE, 2518 snd_pcm_hw_rule_mulkdiv, (void*) 1000000, 2519 SNDRV_PCM_HW_PARAM_BUFFER_SIZE, SNDRV_PCM_HW_PARAM_BUFFER_TIME, -1); 2520 if (err < 0) 2521 return err; 2522 err = snd_pcm_hw_rule_add(runtime, 0, SNDRV_PCM_HW_PARAM_PERIODS, 2523 snd_pcm_hw_rule_div, NULL, 2524 SNDRV_PCM_HW_PARAM_BUFFER_SIZE, SNDRV_PCM_HW_PARAM_PERIOD_SIZE, -1); 2525 if (err < 0) 2526 return err; 2527 err = snd_pcm_hw_rule_add(runtime, 0, SNDRV_PCM_HW_PARAM_PERIOD_SIZE, 2528 snd_pcm_hw_rule_div, NULL, 2529 SNDRV_PCM_HW_PARAM_BUFFER_SIZE, SNDRV_PCM_HW_PARAM_PERIODS, -1); 2530 if (err < 0) 2531 return err; 2532 err = snd_pcm_hw_rule_add(runtime, 0, SNDRV_PCM_HW_PARAM_PERIOD_SIZE, 2533 snd_pcm_hw_rule_mulkdiv, (void*) 8, 2534 SNDRV_PCM_HW_PARAM_PERIOD_BYTES, SNDRV_PCM_HW_PARAM_FRAME_BITS, -1); 2535 if (err < 0) 2536 return err; 2537 err = snd_pcm_hw_rule_add(runtime, 0, SNDRV_PCM_HW_PARAM_PERIOD_SIZE, 2538 snd_pcm_hw_rule_muldivk, (void*) 1000000, 2539 SNDRV_PCM_HW_PARAM_PERIOD_TIME, SNDRV_PCM_HW_PARAM_RATE, -1); 2540 if (err < 0) 2541 return err; 2542 err = snd_pcm_hw_rule_add(runtime, 0, SNDRV_PCM_HW_PARAM_BUFFER_SIZE, 2543 snd_pcm_hw_rule_mul, NULL, 2544 SNDRV_PCM_HW_PARAM_PERIOD_SIZE, SNDRV_PCM_HW_PARAM_PERIODS, -1); 2545 if (err < 0) 2546 return err; 2547 err = snd_pcm_hw_rule_add(runtime, 0, SNDRV_PCM_HW_PARAM_BUFFER_SIZE, 2548 snd_pcm_hw_rule_mulkdiv, (void*) 8, 2549 SNDRV_PCM_HW_PARAM_BUFFER_BYTES, SNDRV_PCM_HW_PARAM_FRAME_BITS, -1); 2550 if (err < 0) 2551 return err; 2552 err = snd_pcm_hw_rule_add(runtime, 0, SNDRV_PCM_HW_PARAM_BUFFER_SIZE, 2553 snd_pcm_hw_rule_muldivk, (void*) 1000000, 2554 SNDRV_PCM_HW_PARAM_BUFFER_TIME, SNDRV_PCM_HW_PARAM_RATE, -1); 2555 if (err < 0) 2556 return err; 2557 err = snd_pcm_hw_rule_add(runtime, 0, SNDRV_PCM_HW_PARAM_PERIOD_BYTES, 2558 snd_pcm_hw_rule_muldivk, (void*) 8, 2559 SNDRV_PCM_HW_PARAM_PERIOD_SIZE, SNDRV_PCM_HW_PARAM_FRAME_BITS, -1); 2560 if (err < 0) 2561 return err; 2562 err = snd_pcm_hw_rule_add(runtime, 0, SNDRV_PCM_HW_PARAM_BUFFER_BYTES, 2563 snd_pcm_hw_rule_muldivk, (void*) 8, 2564 SNDRV_PCM_HW_PARAM_BUFFER_SIZE, SNDRV_PCM_HW_PARAM_FRAME_BITS, -1); 2565 if (err < 0) 2566 return err; 2567 err = snd_pcm_hw_rule_add(runtime, 0, SNDRV_PCM_HW_PARAM_PERIOD_TIME, 2568 snd_pcm_hw_rule_mulkdiv, (void*) 1000000, 2569 SNDRV_PCM_HW_PARAM_PERIOD_SIZE, SNDRV_PCM_HW_PARAM_RATE, -1); 2570 if (err < 0) 2571 return err; 2572 err = snd_pcm_hw_rule_add(runtime, 0, SNDRV_PCM_HW_PARAM_BUFFER_TIME, 2573 snd_pcm_hw_rule_mulkdiv, (void*) 1000000, 2574 SNDRV_PCM_HW_PARAM_BUFFER_SIZE, SNDRV_PCM_HW_PARAM_RATE, -1); 2575 if (err < 0) 2576 return err; 2577 return 0; 2578 } 2579 2580 static int snd_pcm_hw_constraints_complete(struct snd_pcm_substream *substream) 2581 { 2582 struct snd_pcm_runtime *runtime = substream->runtime; 2583 struct snd_pcm_hardware *hw = &runtime->hw; 2584 int err; 2585 unsigned int mask = 0; 2586 2587 if (hw->info & SNDRV_PCM_INFO_INTERLEAVED) 2588 mask |= PARAM_MASK_BIT(SNDRV_PCM_ACCESS_RW_INTERLEAVED); 2589 if (hw->info & SNDRV_PCM_INFO_NONINTERLEAVED) 2590 mask |= PARAM_MASK_BIT(SNDRV_PCM_ACCESS_RW_NONINTERLEAVED); 2591 if (hw_support_mmap(substream)) { 2592 if (hw->info & SNDRV_PCM_INFO_INTERLEAVED) 2593 mask |= PARAM_MASK_BIT(SNDRV_PCM_ACCESS_MMAP_INTERLEAVED); 2594 if (hw->info & SNDRV_PCM_INFO_NONINTERLEAVED) 2595 mask |= PARAM_MASK_BIT(SNDRV_PCM_ACCESS_MMAP_NONINTERLEAVED); 2596 if (hw->info & SNDRV_PCM_INFO_COMPLEX) 2597 mask |= PARAM_MASK_BIT(SNDRV_PCM_ACCESS_MMAP_COMPLEX); 2598 } 2599 err = snd_pcm_hw_constraint_mask(runtime, SNDRV_PCM_HW_PARAM_ACCESS, mask); 2600 if (err < 0) 2601 return err; 2602 2603 err = snd_pcm_hw_constraint_mask64(runtime, SNDRV_PCM_HW_PARAM_FORMAT, hw->formats); 2604 if (err < 0) 2605 return err; 2606 2607 err = snd_pcm_hw_constraint_mask(runtime, SNDRV_PCM_HW_PARAM_SUBFORMAT, 2608 PARAM_MASK_BIT(SNDRV_PCM_SUBFORMAT_STD)); 2609 if (err < 0) 2610 return err; 2611 2612 err = snd_pcm_hw_constraint_minmax(runtime, SNDRV_PCM_HW_PARAM_CHANNELS, 2613 hw->channels_min, hw->channels_max); 2614 if (err < 0) 2615 return err; 2616 2617 err = snd_pcm_hw_constraint_minmax(runtime, SNDRV_PCM_HW_PARAM_RATE, 2618 hw->rate_min, hw->rate_max); 2619 if (err < 0) 2620 return err; 2621 2622 err = snd_pcm_hw_constraint_minmax(runtime, SNDRV_PCM_HW_PARAM_PERIOD_BYTES, 2623 hw->period_bytes_min, hw->period_bytes_max); 2624 if (err < 0) 2625 return err; 2626 2627 err = snd_pcm_hw_constraint_minmax(runtime, SNDRV_PCM_HW_PARAM_PERIODS, 2628 hw->periods_min, hw->periods_max); 2629 if (err < 0) 2630 return err; 2631 2632 err = snd_pcm_hw_constraint_minmax(runtime, SNDRV_PCM_HW_PARAM_BUFFER_BYTES, 2633 hw->period_bytes_min, hw->buffer_bytes_max); 2634 if (err < 0) 2635 return err; 2636 2637 err = snd_pcm_hw_rule_add(runtime, 0, SNDRV_PCM_HW_PARAM_BUFFER_BYTES, 2638 snd_pcm_hw_rule_buffer_bytes_max, substream, 2639 SNDRV_PCM_HW_PARAM_BUFFER_BYTES, -1); 2640 if (err < 0) 2641 return err; 2642 2643 /* FIXME: remove */ 2644 if (runtime->dma_bytes) { 2645 err = snd_pcm_hw_constraint_minmax(runtime, SNDRV_PCM_HW_PARAM_BUFFER_BYTES, 0, runtime->dma_bytes); 2646 if (err < 0) 2647 return err; 2648 } 2649 2650 if (!(hw->rates & (SNDRV_PCM_RATE_KNOT | SNDRV_PCM_RATE_CONTINUOUS))) { 2651 err = snd_pcm_hw_rule_add(runtime, 0, SNDRV_PCM_HW_PARAM_RATE, 2652 snd_pcm_hw_rule_rate, hw, 2653 SNDRV_PCM_HW_PARAM_RATE, -1); 2654 if (err < 0) 2655 return err; 2656 } 2657 2658 /* FIXME: this belong to lowlevel */ 2659 snd_pcm_hw_constraint_integer(runtime, SNDRV_PCM_HW_PARAM_PERIOD_SIZE); 2660 2661 return 0; 2662 } 2663 2664 static void pcm_release_private(struct snd_pcm_substream *substream) 2665 { 2666 if (snd_pcm_stream_linked(substream)) 2667 snd_pcm_unlink(substream); 2668 } 2669 2670 void snd_pcm_release_substream(struct snd_pcm_substream *substream) 2671 { 2672 substream->ref_count--; 2673 if (substream->ref_count > 0) 2674 return; 2675 2676 snd_pcm_drop(substream); 2677 if (substream->hw_opened) { 2678 if (substream->runtime->status->state != SNDRV_PCM_STATE_OPEN) 2679 do_hw_free(substream); 2680 substream->ops->close(substream); 2681 substream->hw_opened = 0; 2682 } 2683 if (cpu_latency_qos_request_active(&substream->latency_pm_qos_req)) 2684 cpu_latency_qos_remove_request(&substream->latency_pm_qos_req); 2685 if (substream->pcm_release) { 2686 substream->pcm_release(substream); 2687 substream->pcm_release = NULL; 2688 } 2689 snd_pcm_detach_substream(substream); 2690 } 2691 EXPORT_SYMBOL(snd_pcm_release_substream); 2692 2693 int snd_pcm_open_substream(struct snd_pcm *pcm, int stream, 2694 struct file *file, 2695 struct snd_pcm_substream **rsubstream) 2696 { 2697 struct snd_pcm_substream *substream; 2698 int err; 2699 2700 err = snd_pcm_attach_substream(pcm, stream, file, &substream); 2701 if (err < 0) 2702 return err; 2703 if (substream->ref_count > 1) { 2704 *rsubstream = substream; 2705 return 0; 2706 } 2707 2708 err = snd_pcm_hw_constraints_init(substream); 2709 if (err < 0) { 2710 pcm_dbg(pcm, "snd_pcm_hw_constraints_init failed\n"); 2711 goto error; 2712 } 2713 2714 err = substream->ops->open(substream); 2715 if (err < 0) 2716 goto error; 2717 2718 substream->hw_opened = 1; 2719 2720 err = snd_pcm_hw_constraints_complete(substream); 2721 if (err < 0) { 2722 pcm_dbg(pcm, "snd_pcm_hw_constraints_complete failed\n"); 2723 goto error; 2724 } 2725 2726 /* automatically set EXPLICIT_SYNC flag in the managed mode whenever 2727 * the DMA buffer requires it 2728 */ 2729 if (substream->managed_buffer_alloc && 2730 substream->dma_buffer.dev.need_sync) 2731 substream->runtime->hw.info |= SNDRV_PCM_INFO_EXPLICIT_SYNC; 2732 2733 *rsubstream = substream; 2734 return 0; 2735 2736 error: 2737 snd_pcm_release_substream(substream); 2738 return err; 2739 } 2740 EXPORT_SYMBOL(snd_pcm_open_substream); 2741 2742 static int snd_pcm_open_file(struct file *file, 2743 struct snd_pcm *pcm, 2744 int stream) 2745 { 2746 struct snd_pcm_file *pcm_file; 2747 struct snd_pcm_substream *substream; 2748 int err; 2749 2750 err = snd_pcm_open_substream(pcm, stream, file, &substream); 2751 if (err < 0) 2752 return err; 2753 2754 pcm_file = kzalloc(sizeof(*pcm_file), GFP_KERNEL); 2755 if (pcm_file == NULL) { 2756 snd_pcm_release_substream(substream); 2757 return -ENOMEM; 2758 } 2759 pcm_file->substream = substream; 2760 if (substream->ref_count == 1) 2761 substream->pcm_release = pcm_release_private; 2762 file->private_data = pcm_file; 2763 2764 return 0; 2765 } 2766 2767 static int snd_pcm_playback_open(struct inode *inode, struct file *file) 2768 { 2769 struct snd_pcm *pcm; 2770 int err = nonseekable_open(inode, file); 2771 if (err < 0) 2772 return err; 2773 pcm = snd_lookup_minor_data(iminor(inode), 2774 SNDRV_DEVICE_TYPE_PCM_PLAYBACK); 2775 err = snd_pcm_open(file, pcm, SNDRV_PCM_STREAM_PLAYBACK); 2776 if (pcm) 2777 snd_card_unref(pcm->card); 2778 return err; 2779 } 2780 2781 static int snd_pcm_capture_open(struct inode *inode, struct file *file) 2782 { 2783 struct snd_pcm *pcm; 2784 int err = nonseekable_open(inode, file); 2785 if (err < 0) 2786 return err; 2787 pcm = snd_lookup_minor_data(iminor(inode), 2788 SNDRV_DEVICE_TYPE_PCM_CAPTURE); 2789 err = snd_pcm_open(file, pcm, SNDRV_PCM_STREAM_CAPTURE); 2790 if (pcm) 2791 snd_card_unref(pcm->card); 2792 return err; 2793 } 2794 2795 static int snd_pcm_open(struct file *file, struct snd_pcm *pcm, int stream) 2796 { 2797 int err; 2798 wait_queue_entry_t wait; 2799 2800 if (pcm == NULL) { 2801 err = -ENODEV; 2802 goto __error1; 2803 } 2804 err = snd_card_file_add(pcm->card, file); 2805 if (err < 0) 2806 goto __error1; 2807 if (!try_module_get(pcm->card->module)) { 2808 err = -EFAULT; 2809 goto __error2; 2810 } 2811 init_waitqueue_entry(&wait, current); 2812 add_wait_queue(&pcm->open_wait, &wait); 2813 mutex_lock(&pcm->open_mutex); 2814 while (1) { 2815 err = snd_pcm_open_file(file, pcm, stream); 2816 if (err >= 0) 2817 break; 2818 if (err == -EAGAIN) { 2819 if (file->f_flags & O_NONBLOCK) { 2820 err = -EBUSY; 2821 break; 2822 } 2823 } else 2824 break; 2825 set_current_state(TASK_INTERRUPTIBLE); 2826 mutex_unlock(&pcm->open_mutex); 2827 schedule(); 2828 mutex_lock(&pcm->open_mutex); 2829 if (pcm->card->shutdown) { 2830 err = -ENODEV; 2831 break; 2832 } 2833 if (signal_pending(current)) { 2834 err = -ERESTARTSYS; 2835 break; 2836 } 2837 } 2838 remove_wait_queue(&pcm->open_wait, &wait); 2839 mutex_unlock(&pcm->open_mutex); 2840 if (err < 0) 2841 goto __error; 2842 return err; 2843 2844 __error: 2845 module_put(pcm->card->module); 2846 __error2: 2847 snd_card_file_remove(pcm->card, file); 2848 __error1: 2849 return err; 2850 } 2851 2852 static int snd_pcm_release(struct inode *inode, struct file *file) 2853 { 2854 struct snd_pcm *pcm; 2855 struct snd_pcm_substream *substream; 2856 struct snd_pcm_file *pcm_file; 2857 2858 pcm_file = file->private_data; 2859 substream = pcm_file->substream; 2860 if (snd_BUG_ON(!substream)) 2861 return -ENXIO; 2862 pcm = substream->pcm; 2863 2864 /* block until the device gets woken up as it may touch the hardware */ 2865 snd_power_wait(pcm->card); 2866 2867 mutex_lock(&pcm->open_mutex); 2868 snd_pcm_release_substream(substream); 2869 kfree(pcm_file); 2870 mutex_unlock(&pcm->open_mutex); 2871 wake_up(&pcm->open_wait); 2872 module_put(pcm->card->module); 2873 snd_card_file_remove(pcm->card, file); 2874 return 0; 2875 } 2876 2877 /* check and update PCM state; return 0 or a negative error 2878 * call this inside PCM lock 2879 */ 2880 static int do_pcm_hwsync(struct snd_pcm_substream *substream) 2881 { 2882 switch (substream->runtime->status->state) { 2883 case SNDRV_PCM_STATE_DRAINING: 2884 if (substream->stream == SNDRV_PCM_STREAM_CAPTURE) 2885 return -EBADFD; 2886 fallthrough; 2887 case SNDRV_PCM_STATE_RUNNING: 2888 return snd_pcm_update_hw_ptr(substream); 2889 case SNDRV_PCM_STATE_PREPARED: 2890 case SNDRV_PCM_STATE_PAUSED: 2891 return 0; 2892 case SNDRV_PCM_STATE_SUSPENDED: 2893 return -ESTRPIPE; 2894 case SNDRV_PCM_STATE_XRUN: 2895 return -EPIPE; 2896 default: 2897 return -EBADFD; 2898 } 2899 } 2900 2901 /* increase the appl_ptr; returns the processed frames or a negative error */ 2902 static snd_pcm_sframes_t forward_appl_ptr(struct snd_pcm_substream *substream, 2903 snd_pcm_uframes_t frames, 2904 snd_pcm_sframes_t avail) 2905 { 2906 struct snd_pcm_runtime *runtime = substream->runtime; 2907 snd_pcm_sframes_t appl_ptr; 2908 int ret; 2909 2910 if (avail <= 0) 2911 return 0; 2912 if (frames > (snd_pcm_uframes_t)avail) 2913 frames = avail; 2914 appl_ptr = runtime->control->appl_ptr + frames; 2915 if (appl_ptr >= (snd_pcm_sframes_t)runtime->boundary) 2916 appl_ptr -= runtime->boundary; 2917 ret = pcm_lib_apply_appl_ptr(substream, appl_ptr); 2918 return ret < 0 ? ret : frames; 2919 } 2920 2921 /* decrease the appl_ptr; returns the processed frames or zero for error */ 2922 static snd_pcm_sframes_t rewind_appl_ptr(struct snd_pcm_substream *substream, 2923 snd_pcm_uframes_t frames, 2924 snd_pcm_sframes_t avail) 2925 { 2926 struct snd_pcm_runtime *runtime = substream->runtime; 2927 snd_pcm_sframes_t appl_ptr; 2928 int ret; 2929 2930 if (avail <= 0) 2931 return 0; 2932 if (frames > (snd_pcm_uframes_t)avail) 2933 frames = avail; 2934 appl_ptr = runtime->control->appl_ptr - frames; 2935 if (appl_ptr < 0) 2936 appl_ptr += runtime->boundary; 2937 ret = pcm_lib_apply_appl_ptr(substream, appl_ptr); 2938 /* NOTE: we return zero for errors because PulseAudio gets depressed 2939 * upon receiving an error from rewind ioctl and stops processing 2940 * any longer. Returning zero means that no rewind is done, so 2941 * it's not absolutely wrong to answer like that. 2942 */ 2943 return ret < 0 ? 0 : frames; 2944 } 2945 2946 static snd_pcm_sframes_t snd_pcm_rewind(struct snd_pcm_substream *substream, 2947 snd_pcm_uframes_t frames) 2948 { 2949 snd_pcm_sframes_t ret; 2950 2951 if (frames == 0) 2952 return 0; 2953 2954 snd_pcm_stream_lock_irq(substream); 2955 ret = do_pcm_hwsync(substream); 2956 if (!ret) 2957 ret = rewind_appl_ptr(substream, frames, 2958 snd_pcm_hw_avail(substream)); 2959 snd_pcm_stream_unlock_irq(substream); 2960 if (ret >= 0) 2961 snd_pcm_dma_buffer_sync(substream, SNDRV_DMA_SYNC_DEVICE); 2962 return ret; 2963 } 2964 2965 static snd_pcm_sframes_t snd_pcm_forward(struct snd_pcm_substream *substream, 2966 snd_pcm_uframes_t frames) 2967 { 2968 snd_pcm_sframes_t ret; 2969 2970 if (frames == 0) 2971 return 0; 2972 2973 snd_pcm_stream_lock_irq(substream); 2974 ret = do_pcm_hwsync(substream); 2975 if (!ret) 2976 ret = forward_appl_ptr(substream, frames, 2977 snd_pcm_avail(substream)); 2978 snd_pcm_stream_unlock_irq(substream); 2979 if (ret >= 0) 2980 snd_pcm_dma_buffer_sync(substream, SNDRV_DMA_SYNC_DEVICE); 2981 return ret; 2982 } 2983 2984 static int snd_pcm_delay(struct snd_pcm_substream *substream, 2985 snd_pcm_sframes_t *delay) 2986 { 2987 int err; 2988 2989 snd_pcm_stream_lock_irq(substream); 2990 err = do_pcm_hwsync(substream); 2991 if (delay && !err) 2992 *delay = snd_pcm_calc_delay(substream); 2993 snd_pcm_stream_unlock_irq(substream); 2994 snd_pcm_dma_buffer_sync(substream, SNDRV_DMA_SYNC_CPU); 2995 2996 return err; 2997 } 2998 2999 static inline int snd_pcm_hwsync(struct snd_pcm_substream *substream) 3000 { 3001 return snd_pcm_delay(substream, NULL); 3002 } 3003 3004 static int snd_pcm_sync_ptr(struct snd_pcm_substream *substream, 3005 struct snd_pcm_sync_ptr __user *_sync_ptr) 3006 { 3007 struct snd_pcm_runtime *runtime = substream->runtime; 3008 struct snd_pcm_sync_ptr sync_ptr; 3009 volatile struct snd_pcm_mmap_status *status; 3010 volatile struct snd_pcm_mmap_control *control; 3011 int err; 3012 3013 memset(&sync_ptr, 0, sizeof(sync_ptr)); 3014 if (get_user(sync_ptr.flags, (unsigned __user *)&(_sync_ptr->flags))) 3015 return -EFAULT; 3016 if (copy_from_user(&sync_ptr.c.control, &(_sync_ptr->c.control), sizeof(struct snd_pcm_mmap_control))) 3017 return -EFAULT; 3018 status = runtime->status; 3019 control = runtime->control; 3020 if (sync_ptr.flags & SNDRV_PCM_SYNC_PTR_HWSYNC) { 3021 err = snd_pcm_hwsync(substream); 3022 if (err < 0) 3023 return err; 3024 } 3025 snd_pcm_stream_lock_irq(substream); 3026 if (!(sync_ptr.flags & SNDRV_PCM_SYNC_PTR_APPL)) { 3027 err = pcm_lib_apply_appl_ptr(substream, 3028 sync_ptr.c.control.appl_ptr); 3029 if (err < 0) { 3030 snd_pcm_stream_unlock_irq(substream); 3031 return err; 3032 } 3033 } else { 3034 sync_ptr.c.control.appl_ptr = control->appl_ptr; 3035 } 3036 if (!(sync_ptr.flags & SNDRV_PCM_SYNC_PTR_AVAIL_MIN)) 3037 control->avail_min = sync_ptr.c.control.avail_min; 3038 else 3039 sync_ptr.c.control.avail_min = control->avail_min; 3040 sync_ptr.s.status.state = status->state; 3041 sync_ptr.s.status.hw_ptr = status->hw_ptr; 3042 sync_ptr.s.status.tstamp = status->tstamp; 3043 sync_ptr.s.status.suspended_state = status->suspended_state; 3044 sync_ptr.s.status.audio_tstamp = status->audio_tstamp; 3045 snd_pcm_stream_unlock_irq(substream); 3046 if (!(sync_ptr.flags & SNDRV_PCM_SYNC_PTR_APPL)) 3047 snd_pcm_dma_buffer_sync(substream, SNDRV_DMA_SYNC_DEVICE); 3048 if (copy_to_user(_sync_ptr, &sync_ptr, sizeof(sync_ptr))) 3049 return -EFAULT; 3050 return 0; 3051 } 3052 3053 struct snd_pcm_mmap_status32 { 3054 snd_pcm_state_t state; 3055 s32 pad1; 3056 u32 hw_ptr; 3057 s32 tstamp_sec; 3058 s32 tstamp_nsec; 3059 snd_pcm_state_t suspended_state; 3060 s32 audio_tstamp_sec; 3061 s32 audio_tstamp_nsec; 3062 } __attribute__((packed)); 3063 3064 struct snd_pcm_mmap_control32 { 3065 u32 appl_ptr; 3066 u32 avail_min; 3067 }; 3068 3069 struct snd_pcm_sync_ptr32 { 3070 u32 flags; 3071 union { 3072 struct snd_pcm_mmap_status32 status; 3073 unsigned char reserved[64]; 3074 } s; 3075 union { 3076 struct snd_pcm_mmap_control32 control; 3077 unsigned char reserved[64]; 3078 } c; 3079 } __attribute__((packed)); 3080 3081 /* recalcuate the boundary within 32bit */ 3082 static snd_pcm_uframes_t recalculate_boundary(struct snd_pcm_runtime *runtime) 3083 { 3084 snd_pcm_uframes_t boundary; 3085 3086 if (! runtime->buffer_size) 3087 return 0; 3088 boundary = runtime->buffer_size; 3089 while (boundary * 2 <= 0x7fffffffUL - runtime->buffer_size) 3090 boundary *= 2; 3091 return boundary; 3092 } 3093 3094 static int snd_pcm_ioctl_sync_ptr_compat(struct snd_pcm_substream *substream, 3095 struct snd_pcm_sync_ptr32 __user *src) 3096 { 3097 struct snd_pcm_runtime *runtime = substream->runtime; 3098 volatile struct snd_pcm_mmap_status *status; 3099 volatile struct snd_pcm_mmap_control *control; 3100 u32 sflags; 3101 struct snd_pcm_mmap_control scontrol; 3102 struct snd_pcm_mmap_status sstatus; 3103 snd_pcm_uframes_t boundary; 3104 int err; 3105 3106 if (snd_BUG_ON(!runtime)) 3107 return -EINVAL; 3108 3109 if (get_user(sflags, &src->flags) || 3110 get_user(scontrol.appl_ptr, &src->c.control.appl_ptr) || 3111 get_user(scontrol.avail_min, &src->c.control.avail_min)) 3112 return -EFAULT; 3113 if (sflags & SNDRV_PCM_SYNC_PTR_HWSYNC) { 3114 err = snd_pcm_hwsync(substream); 3115 if (err < 0) 3116 return err; 3117 } 3118 status = runtime->status; 3119 control = runtime->control; 3120 boundary = recalculate_boundary(runtime); 3121 if (! boundary) 3122 boundary = 0x7fffffff; 3123 snd_pcm_stream_lock_irq(substream); 3124 /* FIXME: we should consider the boundary for the sync from app */ 3125 if (!(sflags & SNDRV_PCM_SYNC_PTR_APPL)) { 3126 err = pcm_lib_apply_appl_ptr(substream, 3127 scontrol.appl_ptr); 3128 if (err < 0) { 3129 snd_pcm_stream_unlock_irq(substream); 3130 return err; 3131 } 3132 } else 3133 scontrol.appl_ptr = control->appl_ptr % boundary; 3134 if (!(sflags & SNDRV_PCM_SYNC_PTR_AVAIL_MIN)) 3135 control->avail_min = scontrol.avail_min; 3136 else 3137 scontrol.avail_min = control->avail_min; 3138 sstatus.state = status->state; 3139 sstatus.hw_ptr = status->hw_ptr % boundary; 3140 sstatus.tstamp = status->tstamp; 3141 sstatus.suspended_state = status->suspended_state; 3142 sstatus.audio_tstamp = status->audio_tstamp; 3143 snd_pcm_stream_unlock_irq(substream); 3144 if (!(sflags & SNDRV_PCM_SYNC_PTR_APPL)) 3145 snd_pcm_dma_buffer_sync(substream, SNDRV_DMA_SYNC_DEVICE); 3146 if (put_user(sstatus.state, &src->s.status.state) || 3147 put_user(sstatus.hw_ptr, &src->s.status.hw_ptr) || 3148 put_user(sstatus.tstamp.tv_sec, &src->s.status.tstamp_sec) || 3149 put_user(sstatus.tstamp.tv_nsec, &src->s.status.tstamp_nsec) || 3150 put_user(sstatus.suspended_state, &src->s.status.suspended_state) || 3151 put_user(sstatus.audio_tstamp.tv_sec, &src->s.status.audio_tstamp_sec) || 3152 put_user(sstatus.audio_tstamp.tv_nsec, &src->s.status.audio_tstamp_nsec) || 3153 put_user(scontrol.appl_ptr, &src->c.control.appl_ptr) || 3154 put_user(scontrol.avail_min, &src->c.control.avail_min)) 3155 return -EFAULT; 3156 3157 return 0; 3158 } 3159 #define __SNDRV_PCM_IOCTL_SYNC_PTR32 _IOWR('A', 0x23, struct snd_pcm_sync_ptr32) 3160 3161 static int snd_pcm_tstamp(struct snd_pcm_substream *substream, int __user *_arg) 3162 { 3163 struct snd_pcm_runtime *runtime = substream->runtime; 3164 int arg; 3165 3166 if (get_user(arg, _arg)) 3167 return -EFAULT; 3168 if (arg < 0 || arg > SNDRV_PCM_TSTAMP_TYPE_LAST) 3169 return -EINVAL; 3170 runtime->tstamp_type = arg; 3171 return 0; 3172 } 3173 3174 static int snd_pcm_xferi_frames_ioctl(struct snd_pcm_substream *substream, 3175 struct snd_xferi __user *_xferi) 3176 { 3177 struct snd_xferi xferi; 3178 struct snd_pcm_runtime *runtime = substream->runtime; 3179 snd_pcm_sframes_t result; 3180 3181 if (runtime->status->state == SNDRV_PCM_STATE_OPEN) 3182 return -EBADFD; 3183 if (put_user(0, &_xferi->result)) 3184 return -EFAULT; 3185 if (copy_from_user(&xferi, _xferi, sizeof(xferi))) 3186 return -EFAULT; 3187 if (substream->stream == SNDRV_PCM_STREAM_PLAYBACK) 3188 result = snd_pcm_lib_write(substream, xferi.buf, xferi.frames); 3189 else 3190 result = snd_pcm_lib_read(substream, xferi.buf, xferi.frames); 3191 if (put_user(result, &_xferi->result)) 3192 return -EFAULT; 3193 return result < 0 ? result : 0; 3194 } 3195 3196 static int snd_pcm_xfern_frames_ioctl(struct snd_pcm_substream *substream, 3197 struct snd_xfern __user *_xfern) 3198 { 3199 struct snd_xfern xfern; 3200 struct snd_pcm_runtime *runtime = substream->runtime; 3201 void *bufs; 3202 snd_pcm_sframes_t result; 3203 3204 if (runtime->status->state == SNDRV_PCM_STATE_OPEN) 3205 return -EBADFD; 3206 if (runtime->channels > 128) 3207 return -EINVAL; 3208 if (put_user(0, &_xfern->result)) 3209 return -EFAULT; 3210 if (copy_from_user(&xfern, _xfern, sizeof(xfern))) 3211 return -EFAULT; 3212 3213 bufs = memdup_user(xfern.bufs, sizeof(void *) * runtime->channels); 3214 if (IS_ERR(bufs)) 3215 return PTR_ERR(bufs); 3216 if (substream->stream == SNDRV_PCM_STREAM_PLAYBACK) 3217 result = snd_pcm_lib_writev(substream, bufs, xfern.frames); 3218 else 3219 result = snd_pcm_lib_readv(substream, bufs, xfern.frames); 3220 kfree(bufs); 3221 if (put_user(result, &_xfern->result)) 3222 return -EFAULT; 3223 return result < 0 ? result : 0; 3224 } 3225 3226 static int snd_pcm_rewind_ioctl(struct snd_pcm_substream *substream, 3227 snd_pcm_uframes_t __user *_frames) 3228 { 3229 snd_pcm_uframes_t frames; 3230 snd_pcm_sframes_t result; 3231 3232 if (get_user(frames, _frames)) 3233 return -EFAULT; 3234 if (put_user(0, _frames)) 3235 return -EFAULT; 3236 result = snd_pcm_rewind(substream, frames); 3237 if (put_user(result, _frames)) 3238 return -EFAULT; 3239 return result < 0 ? result : 0; 3240 } 3241 3242 static int snd_pcm_forward_ioctl(struct snd_pcm_substream *substream, 3243 snd_pcm_uframes_t __user *_frames) 3244 { 3245 snd_pcm_uframes_t frames; 3246 snd_pcm_sframes_t result; 3247 3248 if (get_user(frames, _frames)) 3249 return -EFAULT; 3250 if (put_user(0, _frames)) 3251 return -EFAULT; 3252 result = snd_pcm_forward(substream, frames); 3253 if (put_user(result, _frames)) 3254 return -EFAULT; 3255 return result < 0 ? result : 0; 3256 } 3257 3258 static int snd_pcm_common_ioctl(struct file *file, 3259 struct snd_pcm_substream *substream, 3260 unsigned int cmd, void __user *arg) 3261 { 3262 struct snd_pcm_file *pcm_file = file->private_data; 3263 int res; 3264 3265 if (PCM_RUNTIME_CHECK(substream)) 3266 return -ENXIO; 3267 3268 if (substream->runtime->status->state == SNDRV_PCM_STATE_DISCONNECTED) 3269 return -EBADFD; 3270 3271 res = snd_power_wait(substream->pcm->card); 3272 if (res < 0) 3273 return res; 3274 3275 switch (cmd) { 3276 case SNDRV_PCM_IOCTL_PVERSION: 3277 return put_user(SNDRV_PCM_VERSION, (int __user *)arg) ? -EFAULT : 0; 3278 case SNDRV_PCM_IOCTL_INFO: 3279 return snd_pcm_info_user(substream, arg); 3280 case SNDRV_PCM_IOCTL_TSTAMP: /* just for compatibility */ 3281 return 0; 3282 case SNDRV_PCM_IOCTL_TTSTAMP: 3283 return snd_pcm_tstamp(substream, arg); 3284 case SNDRV_PCM_IOCTL_USER_PVERSION: 3285 if (get_user(pcm_file->user_pversion, 3286 (unsigned int __user *)arg)) 3287 return -EFAULT; 3288 return 0; 3289 case SNDRV_PCM_IOCTL_HW_REFINE: 3290 return snd_pcm_hw_refine_user(substream, arg); 3291 case SNDRV_PCM_IOCTL_HW_PARAMS: 3292 return snd_pcm_hw_params_user(substream, arg); 3293 case SNDRV_PCM_IOCTL_HW_FREE: 3294 return snd_pcm_hw_free(substream); 3295 case SNDRV_PCM_IOCTL_SW_PARAMS: 3296 return snd_pcm_sw_params_user(substream, arg); 3297 case SNDRV_PCM_IOCTL_STATUS32: 3298 return snd_pcm_status_user32(substream, arg, false); 3299 case SNDRV_PCM_IOCTL_STATUS_EXT32: 3300 return snd_pcm_status_user32(substream, arg, true); 3301 case SNDRV_PCM_IOCTL_STATUS64: 3302 return snd_pcm_status_user64(substream, arg, false); 3303 case SNDRV_PCM_IOCTL_STATUS_EXT64: 3304 return snd_pcm_status_user64(substream, arg, true); 3305 case SNDRV_PCM_IOCTL_CHANNEL_INFO: 3306 return snd_pcm_channel_info_user(substream, arg); 3307 case SNDRV_PCM_IOCTL_PREPARE: 3308 return snd_pcm_prepare(substream, file); 3309 case SNDRV_PCM_IOCTL_RESET: 3310 return snd_pcm_reset(substream); 3311 case SNDRV_PCM_IOCTL_START: 3312 return snd_pcm_start_lock_irq(substream); 3313 case SNDRV_PCM_IOCTL_LINK: 3314 return snd_pcm_link(substream, (int)(unsigned long) arg); 3315 case SNDRV_PCM_IOCTL_UNLINK: 3316 return snd_pcm_unlink(substream); 3317 case SNDRV_PCM_IOCTL_RESUME: 3318 return snd_pcm_resume(substream); 3319 case SNDRV_PCM_IOCTL_XRUN: 3320 return snd_pcm_xrun(substream); 3321 case SNDRV_PCM_IOCTL_HWSYNC: 3322 return snd_pcm_hwsync(substream); 3323 case SNDRV_PCM_IOCTL_DELAY: 3324 { 3325 snd_pcm_sframes_t delay = 0; 3326 snd_pcm_sframes_t __user *res = arg; 3327 int err; 3328 3329 err = snd_pcm_delay(substream, &delay); 3330 if (err) 3331 return err; 3332 if (put_user(delay, res)) 3333 return -EFAULT; 3334 return 0; 3335 } 3336 case __SNDRV_PCM_IOCTL_SYNC_PTR32: 3337 return snd_pcm_ioctl_sync_ptr_compat(substream, arg); 3338 case __SNDRV_PCM_IOCTL_SYNC_PTR64: 3339 return snd_pcm_sync_ptr(substream, arg); 3340 #ifdef CONFIG_SND_SUPPORT_OLD_API 3341 case SNDRV_PCM_IOCTL_HW_REFINE_OLD: 3342 return snd_pcm_hw_refine_old_user(substream, arg); 3343 case SNDRV_PCM_IOCTL_HW_PARAMS_OLD: 3344 return snd_pcm_hw_params_old_user(substream, arg); 3345 #endif 3346 case SNDRV_PCM_IOCTL_DRAIN: 3347 return snd_pcm_drain(substream, file); 3348 case SNDRV_PCM_IOCTL_DROP: 3349 return snd_pcm_drop(substream); 3350 case SNDRV_PCM_IOCTL_PAUSE: 3351 return snd_pcm_pause_lock_irq(substream, (unsigned long)arg); 3352 case SNDRV_PCM_IOCTL_WRITEI_FRAMES: 3353 case SNDRV_PCM_IOCTL_READI_FRAMES: 3354 return snd_pcm_xferi_frames_ioctl(substream, arg); 3355 case SNDRV_PCM_IOCTL_WRITEN_FRAMES: 3356 case SNDRV_PCM_IOCTL_READN_FRAMES: 3357 return snd_pcm_xfern_frames_ioctl(substream, arg); 3358 case SNDRV_PCM_IOCTL_REWIND: 3359 return snd_pcm_rewind_ioctl(substream, arg); 3360 case SNDRV_PCM_IOCTL_FORWARD: 3361 return snd_pcm_forward_ioctl(substream, arg); 3362 } 3363 pcm_dbg(substream->pcm, "unknown ioctl = 0x%x\n", cmd); 3364 return -ENOTTY; 3365 } 3366 3367 static long snd_pcm_ioctl(struct file *file, unsigned int cmd, 3368 unsigned long arg) 3369 { 3370 struct snd_pcm_file *pcm_file; 3371 3372 pcm_file = file->private_data; 3373 3374 if (((cmd >> 8) & 0xff) != 'A') 3375 return -ENOTTY; 3376 3377 return snd_pcm_common_ioctl(file, pcm_file->substream, cmd, 3378 (void __user *)arg); 3379 } 3380 3381 /** 3382 * snd_pcm_kernel_ioctl - Execute PCM ioctl in the kernel-space 3383 * @substream: PCM substream 3384 * @cmd: IOCTL cmd 3385 * @arg: IOCTL argument 3386 * 3387 * The function is provided primarily for OSS layer and USB gadget drivers, 3388 * and it allows only the limited set of ioctls (hw_params, sw_params, 3389 * prepare, start, drain, drop, forward). 3390 */ 3391 int snd_pcm_kernel_ioctl(struct snd_pcm_substream *substream, 3392 unsigned int cmd, void *arg) 3393 { 3394 snd_pcm_uframes_t *frames = arg; 3395 snd_pcm_sframes_t result; 3396 3397 if (substream->runtime->status->state == SNDRV_PCM_STATE_DISCONNECTED) 3398 return -EBADFD; 3399 3400 switch (cmd) { 3401 case SNDRV_PCM_IOCTL_FORWARD: 3402 { 3403 /* provided only for OSS; capture-only and no value returned */ 3404 if (substream->stream != SNDRV_PCM_STREAM_CAPTURE) 3405 return -EINVAL; 3406 result = snd_pcm_forward(substream, *frames); 3407 return result < 0 ? result : 0; 3408 } 3409 case SNDRV_PCM_IOCTL_HW_PARAMS: 3410 return snd_pcm_hw_params(substream, arg); 3411 case SNDRV_PCM_IOCTL_SW_PARAMS: 3412 return snd_pcm_sw_params(substream, arg); 3413 case SNDRV_PCM_IOCTL_PREPARE: 3414 return snd_pcm_prepare(substream, NULL); 3415 case SNDRV_PCM_IOCTL_START: 3416 return snd_pcm_start_lock_irq(substream); 3417 case SNDRV_PCM_IOCTL_DRAIN: 3418 return snd_pcm_drain(substream, NULL); 3419 case SNDRV_PCM_IOCTL_DROP: 3420 return snd_pcm_drop(substream); 3421 case SNDRV_PCM_IOCTL_DELAY: 3422 return snd_pcm_delay(substream, frames); 3423 default: 3424 return -EINVAL; 3425 } 3426 } 3427 EXPORT_SYMBOL(snd_pcm_kernel_ioctl); 3428 3429 static ssize_t snd_pcm_read(struct file *file, char __user *buf, size_t count, 3430 loff_t * offset) 3431 { 3432 struct snd_pcm_file *pcm_file; 3433 struct snd_pcm_substream *substream; 3434 struct snd_pcm_runtime *runtime; 3435 snd_pcm_sframes_t result; 3436 3437 pcm_file = file->private_data; 3438 substream = pcm_file->substream; 3439 if (PCM_RUNTIME_CHECK(substream)) 3440 return -ENXIO; 3441 runtime = substream->runtime; 3442 if (runtime->status->state == SNDRV_PCM_STATE_OPEN || 3443 runtime->status->state == SNDRV_PCM_STATE_DISCONNECTED) 3444 return -EBADFD; 3445 if (!frame_aligned(runtime, count)) 3446 return -EINVAL; 3447 count = bytes_to_frames(runtime, count); 3448 result = snd_pcm_lib_read(substream, buf, count); 3449 if (result > 0) 3450 result = frames_to_bytes(runtime, result); 3451 return result; 3452 } 3453 3454 static ssize_t snd_pcm_write(struct file *file, const char __user *buf, 3455 size_t count, loff_t * offset) 3456 { 3457 struct snd_pcm_file *pcm_file; 3458 struct snd_pcm_substream *substream; 3459 struct snd_pcm_runtime *runtime; 3460 snd_pcm_sframes_t result; 3461 3462 pcm_file = file->private_data; 3463 substream = pcm_file->substream; 3464 if (PCM_RUNTIME_CHECK(substream)) 3465 return -ENXIO; 3466 runtime = substream->runtime; 3467 if (runtime->status->state == SNDRV_PCM_STATE_OPEN || 3468 runtime->status->state == SNDRV_PCM_STATE_DISCONNECTED) 3469 return -EBADFD; 3470 if (!frame_aligned(runtime, count)) 3471 return -EINVAL; 3472 count = bytes_to_frames(runtime, count); 3473 result = snd_pcm_lib_write(substream, buf, count); 3474 if (result > 0) 3475 result = frames_to_bytes(runtime, result); 3476 return result; 3477 } 3478 3479 static ssize_t snd_pcm_readv(struct kiocb *iocb, struct iov_iter *to) 3480 { 3481 struct snd_pcm_file *pcm_file; 3482 struct snd_pcm_substream *substream; 3483 struct snd_pcm_runtime *runtime; 3484 snd_pcm_sframes_t result; 3485 unsigned long i; 3486 void __user **bufs; 3487 snd_pcm_uframes_t frames; 3488 3489 pcm_file = iocb->ki_filp->private_data; 3490 substream = pcm_file->substream; 3491 if (PCM_RUNTIME_CHECK(substream)) 3492 return -ENXIO; 3493 runtime = substream->runtime; 3494 if (runtime->status->state == SNDRV_PCM_STATE_OPEN || 3495 runtime->status->state == SNDRV_PCM_STATE_DISCONNECTED) 3496 return -EBADFD; 3497 if (!iter_is_iovec(to)) 3498 return -EINVAL; 3499 if (to->nr_segs > 1024 || to->nr_segs != runtime->channels) 3500 return -EINVAL; 3501 if (!frame_aligned(runtime, to->iov->iov_len)) 3502 return -EINVAL; 3503 frames = bytes_to_samples(runtime, to->iov->iov_len); 3504 bufs = kmalloc_array(to->nr_segs, sizeof(void *), GFP_KERNEL); 3505 if (bufs == NULL) 3506 return -ENOMEM; 3507 for (i = 0; i < to->nr_segs; ++i) 3508 bufs[i] = to->iov[i].iov_base; 3509 result = snd_pcm_lib_readv(substream, bufs, frames); 3510 if (result > 0) 3511 result = frames_to_bytes(runtime, result); 3512 kfree(bufs); 3513 return result; 3514 } 3515 3516 static ssize_t snd_pcm_writev(struct kiocb *iocb, struct iov_iter *from) 3517 { 3518 struct snd_pcm_file *pcm_file; 3519 struct snd_pcm_substream *substream; 3520 struct snd_pcm_runtime *runtime; 3521 snd_pcm_sframes_t result; 3522 unsigned long i; 3523 void __user **bufs; 3524 snd_pcm_uframes_t frames; 3525 3526 pcm_file = iocb->ki_filp->private_data; 3527 substream = pcm_file->substream; 3528 if (PCM_RUNTIME_CHECK(substream)) 3529 return -ENXIO; 3530 runtime = substream->runtime; 3531 if (runtime->status->state == SNDRV_PCM_STATE_OPEN || 3532 runtime->status->state == SNDRV_PCM_STATE_DISCONNECTED) 3533 return -EBADFD; 3534 if (!iter_is_iovec(from)) 3535 return -EINVAL; 3536 if (from->nr_segs > 128 || from->nr_segs != runtime->channels || 3537 !frame_aligned(runtime, from->iov->iov_len)) 3538 return -EINVAL; 3539 frames = bytes_to_samples(runtime, from->iov->iov_len); 3540 bufs = kmalloc_array(from->nr_segs, sizeof(void *), GFP_KERNEL); 3541 if (bufs == NULL) 3542 return -ENOMEM; 3543 for (i = 0; i < from->nr_segs; ++i) 3544 bufs[i] = from->iov[i].iov_base; 3545 result = snd_pcm_lib_writev(substream, bufs, frames); 3546 if (result > 0) 3547 result = frames_to_bytes(runtime, result); 3548 kfree(bufs); 3549 return result; 3550 } 3551 3552 static __poll_t snd_pcm_poll(struct file *file, poll_table *wait) 3553 { 3554 struct snd_pcm_file *pcm_file; 3555 struct snd_pcm_substream *substream; 3556 struct snd_pcm_runtime *runtime; 3557 __poll_t mask, ok; 3558 snd_pcm_uframes_t avail; 3559 3560 pcm_file = file->private_data; 3561 3562 substream = pcm_file->substream; 3563 if (substream->stream == SNDRV_PCM_STREAM_PLAYBACK) 3564 ok = EPOLLOUT | EPOLLWRNORM; 3565 else 3566 ok = EPOLLIN | EPOLLRDNORM; 3567 if (PCM_RUNTIME_CHECK(substream)) 3568 return ok | EPOLLERR; 3569 3570 runtime = substream->runtime; 3571 if (runtime->status->state == SNDRV_PCM_STATE_DISCONNECTED) 3572 return ok | EPOLLERR; 3573 3574 poll_wait(file, &runtime->sleep, wait); 3575 3576 mask = 0; 3577 snd_pcm_stream_lock_irq(substream); 3578 avail = snd_pcm_avail(substream); 3579 switch (runtime->status->state) { 3580 case SNDRV_PCM_STATE_RUNNING: 3581 case SNDRV_PCM_STATE_PREPARED: 3582 case SNDRV_PCM_STATE_PAUSED: 3583 if (avail >= runtime->control->avail_min) 3584 mask = ok; 3585 break; 3586 case SNDRV_PCM_STATE_DRAINING: 3587 if (substream->stream == SNDRV_PCM_STREAM_CAPTURE) { 3588 mask = ok; 3589 if (!avail) 3590 mask |= EPOLLERR; 3591 } 3592 break; 3593 default: 3594 mask = ok | EPOLLERR; 3595 break; 3596 } 3597 snd_pcm_stream_unlock_irq(substream); 3598 return mask; 3599 } 3600 3601 /* 3602 * mmap support 3603 */ 3604 3605 /* 3606 * Only on coherent architectures, we can mmap the status and the control records 3607 * for effcient data transfer. On others, we have to use HWSYNC ioctl... 3608 */ 3609 #if defined(CONFIG_X86) || defined(CONFIG_PPC) || defined(CONFIG_ALPHA) 3610 /* 3611 * mmap status record 3612 */ 3613 static vm_fault_t snd_pcm_mmap_status_fault(struct vm_fault *vmf) 3614 { 3615 struct snd_pcm_substream *substream = vmf->vma->vm_private_data; 3616 struct snd_pcm_runtime *runtime; 3617 3618 if (substream == NULL) 3619 return VM_FAULT_SIGBUS; 3620 runtime = substream->runtime; 3621 vmf->page = virt_to_page(runtime->status); 3622 get_page(vmf->page); 3623 return 0; 3624 } 3625 3626 static const struct vm_operations_struct snd_pcm_vm_ops_status = 3627 { 3628 .fault = snd_pcm_mmap_status_fault, 3629 }; 3630 3631 static int snd_pcm_mmap_status(struct snd_pcm_substream *substream, struct file *file, 3632 struct vm_area_struct *area) 3633 { 3634 long size; 3635 if (!(area->vm_flags & VM_READ)) 3636 return -EINVAL; 3637 size = area->vm_end - area->vm_start; 3638 if (size != PAGE_ALIGN(sizeof(struct snd_pcm_mmap_status))) 3639 return -EINVAL; 3640 area->vm_ops = &snd_pcm_vm_ops_status; 3641 area->vm_private_data = substream; 3642 area->vm_flags |= VM_DONTEXPAND | VM_DONTDUMP; 3643 return 0; 3644 } 3645 3646 /* 3647 * mmap control record 3648 */ 3649 static vm_fault_t snd_pcm_mmap_control_fault(struct vm_fault *vmf) 3650 { 3651 struct snd_pcm_substream *substream = vmf->vma->vm_private_data; 3652 struct snd_pcm_runtime *runtime; 3653 3654 if (substream == NULL) 3655 return VM_FAULT_SIGBUS; 3656 runtime = substream->runtime; 3657 vmf->page = virt_to_page(runtime->control); 3658 get_page(vmf->page); 3659 return 0; 3660 } 3661 3662 static const struct vm_operations_struct snd_pcm_vm_ops_control = 3663 { 3664 .fault = snd_pcm_mmap_control_fault, 3665 }; 3666 3667 static int snd_pcm_mmap_control(struct snd_pcm_substream *substream, struct file *file, 3668 struct vm_area_struct *area) 3669 { 3670 long size; 3671 if (!(area->vm_flags & VM_READ)) 3672 return -EINVAL; 3673 size = area->vm_end - area->vm_start; 3674 if (size != PAGE_ALIGN(sizeof(struct snd_pcm_mmap_control))) 3675 return -EINVAL; 3676 area->vm_ops = &snd_pcm_vm_ops_control; 3677 area->vm_private_data = substream; 3678 area->vm_flags |= VM_DONTEXPAND | VM_DONTDUMP; 3679 return 0; 3680 } 3681 3682 static bool pcm_status_mmap_allowed(struct snd_pcm_file *pcm_file) 3683 { 3684 /* If drivers require the explicit sync (typically for non-coherent 3685 * pages), we have to disable the mmap of status and control data 3686 * to enforce the control via SYNC_PTR ioctl. 3687 */ 3688 if (pcm_file->substream->runtime->hw.info & SNDRV_PCM_INFO_EXPLICIT_SYNC) 3689 return false; 3690 /* See pcm_control_mmap_allowed() below. 3691 * Since older alsa-lib requires both status and control mmaps to be 3692 * coupled, we have to disable the status mmap for old alsa-lib, too. 3693 */ 3694 if (pcm_file->user_pversion < SNDRV_PROTOCOL_VERSION(2, 0, 14) && 3695 (pcm_file->substream->runtime->hw.info & SNDRV_PCM_INFO_SYNC_APPLPTR)) 3696 return false; 3697 return true; 3698 } 3699 3700 static bool pcm_control_mmap_allowed(struct snd_pcm_file *pcm_file) 3701 { 3702 if (pcm_file->no_compat_mmap) 3703 return false; 3704 /* see above */ 3705 if (pcm_file->substream->runtime->hw.info & SNDRV_PCM_INFO_EXPLICIT_SYNC) 3706 return false; 3707 /* Disallow the control mmap when SYNC_APPLPTR flag is set; 3708 * it enforces the user-space to fall back to snd_pcm_sync_ptr(), 3709 * thus it effectively assures the manual update of appl_ptr. 3710 */ 3711 if (pcm_file->substream->runtime->hw.info & SNDRV_PCM_INFO_SYNC_APPLPTR) 3712 return false; 3713 return true; 3714 } 3715 3716 #else /* ! coherent mmap */ 3717 /* 3718 * don't support mmap for status and control records. 3719 */ 3720 #define pcm_status_mmap_allowed(pcm_file) false 3721 #define pcm_control_mmap_allowed(pcm_file) false 3722 3723 static int snd_pcm_mmap_status(struct snd_pcm_substream *substream, struct file *file, 3724 struct vm_area_struct *area) 3725 { 3726 return -ENXIO; 3727 } 3728 static int snd_pcm_mmap_control(struct snd_pcm_substream *substream, struct file *file, 3729 struct vm_area_struct *area) 3730 { 3731 return -ENXIO; 3732 } 3733 #endif /* coherent mmap */ 3734 3735 /* 3736 * fault callback for mmapping a RAM page 3737 */ 3738 static vm_fault_t snd_pcm_mmap_data_fault(struct vm_fault *vmf) 3739 { 3740 struct snd_pcm_substream *substream = vmf->vma->vm_private_data; 3741 struct snd_pcm_runtime *runtime; 3742 unsigned long offset; 3743 struct page * page; 3744 size_t dma_bytes; 3745 3746 if (substream == NULL) 3747 return VM_FAULT_SIGBUS; 3748 runtime = substream->runtime; 3749 offset = vmf->pgoff << PAGE_SHIFT; 3750 dma_bytes = PAGE_ALIGN(runtime->dma_bytes); 3751 if (offset > dma_bytes - PAGE_SIZE) 3752 return VM_FAULT_SIGBUS; 3753 if (substream->ops->page) 3754 page = substream->ops->page(substream, offset); 3755 else if (!snd_pcm_get_dma_buf(substream)) 3756 page = virt_to_page(runtime->dma_area + offset); 3757 else 3758 page = snd_sgbuf_get_page(snd_pcm_get_dma_buf(substream), offset); 3759 if (!page) 3760 return VM_FAULT_SIGBUS; 3761 get_page(page); 3762 vmf->page = page; 3763 return 0; 3764 } 3765 3766 static const struct vm_operations_struct snd_pcm_vm_ops_data = { 3767 .open = snd_pcm_mmap_data_open, 3768 .close = snd_pcm_mmap_data_close, 3769 }; 3770 3771 static const struct vm_operations_struct snd_pcm_vm_ops_data_fault = { 3772 .open = snd_pcm_mmap_data_open, 3773 .close = snd_pcm_mmap_data_close, 3774 .fault = snd_pcm_mmap_data_fault, 3775 }; 3776 3777 /* 3778 * mmap the DMA buffer on RAM 3779 */ 3780 3781 /** 3782 * snd_pcm_lib_default_mmap - Default PCM data mmap function 3783 * @substream: PCM substream 3784 * @area: VMA 3785 * 3786 * This is the default mmap handler for PCM data. When mmap pcm_ops is NULL, 3787 * this function is invoked implicitly. 3788 */ 3789 int snd_pcm_lib_default_mmap(struct snd_pcm_substream *substream, 3790 struct vm_area_struct *area) 3791 { 3792 area->vm_flags |= VM_DONTEXPAND | VM_DONTDUMP; 3793 if (!substream->ops->page && 3794 !snd_dma_buffer_mmap(snd_pcm_get_dma_buf(substream), area)) 3795 return 0; 3796 /* mmap with fault handler */ 3797 area->vm_ops = &snd_pcm_vm_ops_data_fault; 3798 return 0; 3799 } 3800 EXPORT_SYMBOL_GPL(snd_pcm_lib_default_mmap); 3801 3802 /* 3803 * mmap the DMA buffer on I/O memory area 3804 */ 3805 #if SNDRV_PCM_INFO_MMAP_IOMEM 3806 /** 3807 * snd_pcm_lib_mmap_iomem - Default PCM data mmap function for I/O mem 3808 * @substream: PCM substream 3809 * @area: VMA 3810 * 3811 * When your hardware uses the iomapped pages as the hardware buffer and 3812 * wants to mmap it, pass this function as mmap pcm_ops. Note that this 3813 * is supposed to work only on limited architectures. 3814 */ 3815 int snd_pcm_lib_mmap_iomem(struct snd_pcm_substream *substream, 3816 struct vm_area_struct *area) 3817 { 3818 struct snd_pcm_runtime *runtime = substream->runtime; 3819 3820 area->vm_page_prot = pgprot_noncached(area->vm_page_prot); 3821 return vm_iomap_memory(area, runtime->dma_addr, runtime->dma_bytes); 3822 } 3823 EXPORT_SYMBOL(snd_pcm_lib_mmap_iomem); 3824 #endif /* SNDRV_PCM_INFO_MMAP */ 3825 3826 /* 3827 * mmap DMA buffer 3828 */ 3829 int snd_pcm_mmap_data(struct snd_pcm_substream *substream, struct file *file, 3830 struct vm_area_struct *area) 3831 { 3832 struct snd_pcm_runtime *runtime; 3833 long size; 3834 unsigned long offset; 3835 size_t dma_bytes; 3836 int err; 3837 3838 if (substream->stream == SNDRV_PCM_STREAM_PLAYBACK) { 3839 if (!(area->vm_flags & (VM_WRITE|VM_READ))) 3840 return -EINVAL; 3841 } else { 3842 if (!(area->vm_flags & VM_READ)) 3843 return -EINVAL; 3844 } 3845 runtime = substream->runtime; 3846 if (runtime->status->state == SNDRV_PCM_STATE_OPEN) 3847 return -EBADFD; 3848 if (!(runtime->info & SNDRV_PCM_INFO_MMAP)) 3849 return -ENXIO; 3850 if (runtime->access == SNDRV_PCM_ACCESS_RW_INTERLEAVED || 3851 runtime->access == SNDRV_PCM_ACCESS_RW_NONINTERLEAVED) 3852 return -EINVAL; 3853 size = area->vm_end - area->vm_start; 3854 offset = area->vm_pgoff << PAGE_SHIFT; 3855 dma_bytes = PAGE_ALIGN(runtime->dma_bytes); 3856 if ((size_t)size > dma_bytes) 3857 return -EINVAL; 3858 if (offset > dma_bytes - size) 3859 return -EINVAL; 3860 3861 area->vm_ops = &snd_pcm_vm_ops_data; 3862 area->vm_private_data = substream; 3863 if (substream->ops->mmap) 3864 err = substream->ops->mmap(substream, area); 3865 else 3866 err = snd_pcm_lib_default_mmap(substream, area); 3867 if (!err) 3868 atomic_inc(&substream->mmap_count); 3869 return err; 3870 } 3871 EXPORT_SYMBOL(snd_pcm_mmap_data); 3872 3873 static int snd_pcm_mmap(struct file *file, struct vm_area_struct *area) 3874 { 3875 struct snd_pcm_file * pcm_file; 3876 struct snd_pcm_substream *substream; 3877 unsigned long offset; 3878 3879 pcm_file = file->private_data; 3880 substream = pcm_file->substream; 3881 if (PCM_RUNTIME_CHECK(substream)) 3882 return -ENXIO; 3883 if (substream->runtime->status->state == SNDRV_PCM_STATE_DISCONNECTED) 3884 return -EBADFD; 3885 3886 offset = area->vm_pgoff << PAGE_SHIFT; 3887 switch (offset) { 3888 case SNDRV_PCM_MMAP_OFFSET_STATUS_OLD: 3889 if (pcm_file->no_compat_mmap || !IS_ENABLED(CONFIG_64BIT)) 3890 return -ENXIO; 3891 fallthrough; 3892 case SNDRV_PCM_MMAP_OFFSET_STATUS_NEW: 3893 if (!pcm_status_mmap_allowed(pcm_file)) 3894 return -ENXIO; 3895 return snd_pcm_mmap_status(substream, file, area); 3896 case SNDRV_PCM_MMAP_OFFSET_CONTROL_OLD: 3897 if (pcm_file->no_compat_mmap || !IS_ENABLED(CONFIG_64BIT)) 3898 return -ENXIO; 3899 fallthrough; 3900 case SNDRV_PCM_MMAP_OFFSET_CONTROL_NEW: 3901 if (!pcm_control_mmap_allowed(pcm_file)) 3902 return -ENXIO; 3903 return snd_pcm_mmap_control(substream, file, area); 3904 default: 3905 return snd_pcm_mmap_data(substream, file, area); 3906 } 3907 return 0; 3908 } 3909 3910 static int snd_pcm_fasync(int fd, struct file * file, int on) 3911 { 3912 struct snd_pcm_file * pcm_file; 3913 struct snd_pcm_substream *substream; 3914 struct snd_pcm_runtime *runtime; 3915 3916 pcm_file = file->private_data; 3917 substream = pcm_file->substream; 3918 if (PCM_RUNTIME_CHECK(substream)) 3919 return -ENXIO; 3920 runtime = substream->runtime; 3921 if (runtime->status->state == SNDRV_PCM_STATE_DISCONNECTED) 3922 return -EBADFD; 3923 return fasync_helper(fd, file, on, &runtime->fasync); 3924 } 3925 3926 /* 3927 * ioctl32 compat 3928 */ 3929 #ifdef CONFIG_COMPAT 3930 #include "pcm_compat.c" 3931 #else 3932 #define snd_pcm_ioctl_compat NULL 3933 #endif 3934 3935 /* 3936 * To be removed helpers to keep binary compatibility 3937 */ 3938 3939 #ifdef CONFIG_SND_SUPPORT_OLD_API 3940 #define __OLD_TO_NEW_MASK(x) ((x&7)|((x&0x07fffff8)<<5)) 3941 #define __NEW_TO_OLD_MASK(x) ((x&7)|((x&0xffffff00)>>5)) 3942 3943 static void snd_pcm_hw_convert_from_old_params(struct snd_pcm_hw_params *params, 3944 struct snd_pcm_hw_params_old *oparams) 3945 { 3946 unsigned int i; 3947 3948 memset(params, 0, sizeof(*params)); 3949 params->flags = oparams->flags; 3950 for (i = 0; i < ARRAY_SIZE(oparams->masks); i++) 3951 params->masks[i].bits[0] = oparams->masks[i]; 3952 memcpy(params->intervals, oparams->intervals, sizeof(oparams->intervals)); 3953 params->rmask = __OLD_TO_NEW_MASK(oparams->rmask); 3954 params->cmask = __OLD_TO_NEW_MASK(oparams->cmask); 3955 params->info = oparams->info; 3956 params->msbits = oparams->msbits; 3957 params->rate_num = oparams->rate_num; 3958 params->rate_den = oparams->rate_den; 3959 params->fifo_size = oparams->fifo_size; 3960 } 3961 3962 static void snd_pcm_hw_convert_to_old_params(struct snd_pcm_hw_params_old *oparams, 3963 struct snd_pcm_hw_params *params) 3964 { 3965 unsigned int i; 3966 3967 memset(oparams, 0, sizeof(*oparams)); 3968 oparams->flags = params->flags; 3969 for (i = 0; i < ARRAY_SIZE(oparams->masks); i++) 3970 oparams->masks[i] = params->masks[i].bits[0]; 3971 memcpy(oparams->intervals, params->intervals, sizeof(oparams->intervals)); 3972 oparams->rmask = __NEW_TO_OLD_MASK(params->rmask); 3973 oparams->cmask = __NEW_TO_OLD_MASK(params->cmask); 3974 oparams->info = params->info; 3975 oparams->msbits = params->msbits; 3976 oparams->rate_num = params->rate_num; 3977 oparams->rate_den = params->rate_den; 3978 oparams->fifo_size = params->fifo_size; 3979 } 3980 3981 static int snd_pcm_hw_refine_old_user(struct snd_pcm_substream *substream, 3982 struct snd_pcm_hw_params_old __user * _oparams) 3983 { 3984 struct snd_pcm_hw_params *params; 3985 struct snd_pcm_hw_params_old *oparams = NULL; 3986 int err; 3987 3988 params = kmalloc(sizeof(*params), GFP_KERNEL); 3989 if (!params) 3990 return -ENOMEM; 3991 3992 oparams = memdup_user(_oparams, sizeof(*oparams)); 3993 if (IS_ERR(oparams)) { 3994 err = PTR_ERR(oparams); 3995 goto out; 3996 } 3997 snd_pcm_hw_convert_from_old_params(params, oparams); 3998 err = snd_pcm_hw_refine(substream, params); 3999 if (err < 0) 4000 goto out_old; 4001 4002 err = fixup_unreferenced_params(substream, params); 4003 if (err < 0) 4004 goto out_old; 4005 4006 snd_pcm_hw_convert_to_old_params(oparams, params); 4007 if (copy_to_user(_oparams, oparams, sizeof(*oparams))) 4008 err = -EFAULT; 4009 out_old: 4010 kfree(oparams); 4011 out: 4012 kfree(params); 4013 return err; 4014 } 4015 4016 static int snd_pcm_hw_params_old_user(struct snd_pcm_substream *substream, 4017 struct snd_pcm_hw_params_old __user * _oparams) 4018 { 4019 struct snd_pcm_hw_params *params; 4020 struct snd_pcm_hw_params_old *oparams = NULL; 4021 int err; 4022 4023 params = kmalloc(sizeof(*params), GFP_KERNEL); 4024 if (!params) 4025 return -ENOMEM; 4026 4027 oparams = memdup_user(_oparams, sizeof(*oparams)); 4028 if (IS_ERR(oparams)) { 4029 err = PTR_ERR(oparams); 4030 goto out; 4031 } 4032 4033 snd_pcm_hw_convert_from_old_params(params, oparams); 4034 err = snd_pcm_hw_params(substream, params); 4035 if (err < 0) 4036 goto out_old; 4037 4038 snd_pcm_hw_convert_to_old_params(oparams, params); 4039 if (copy_to_user(_oparams, oparams, sizeof(*oparams))) 4040 err = -EFAULT; 4041 out_old: 4042 kfree(oparams); 4043 out: 4044 kfree(params); 4045 return err; 4046 } 4047 #endif /* CONFIG_SND_SUPPORT_OLD_API */ 4048 4049 #ifndef CONFIG_MMU 4050 static unsigned long snd_pcm_get_unmapped_area(struct file *file, 4051 unsigned long addr, 4052 unsigned long len, 4053 unsigned long pgoff, 4054 unsigned long flags) 4055 { 4056 struct snd_pcm_file *pcm_file = file->private_data; 4057 struct snd_pcm_substream *substream = pcm_file->substream; 4058 struct snd_pcm_runtime *runtime = substream->runtime; 4059 unsigned long offset = pgoff << PAGE_SHIFT; 4060 4061 switch (offset) { 4062 case SNDRV_PCM_MMAP_OFFSET_STATUS_NEW: 4063 return (unsigned long)runtime->status; 4064 case SNDRV_PCM_MMAP_OFFSET_CONTROL_NEW: 4065 return (unsigned long)runtime->control; 4066 default: 4067 return (unsigned long)runtime->dma_area + offset; 4068 } 4069 } 4070 #else 4071 # define snd_pcm_get_unmapped_area NULL 4072 #endif 4073 4074 /* 4075 * Register section 4076 */ 4077 4078 const struct file_operations snd_pcm_f_ops[2] = { 4079 { 4080 .owner = THIS_MODULE, 4081 .write = snd_pcm_write, 4082 .write_iter = snd_pcm_writev, 4083 .open = snd_pcm_playback_open, 4084 .release = snd_pcm_release, 4085 .llseek = no_llseek, 4086 .poll = snd_pcm_poll, 4087 .unlocked_ioctl = snd_pcm_ioctl, 4088 .compat_ioctl = snd_pcm_ioctl_compat, 4089 .mmap = snd_pcm_mmap, 4090 .fasync = snd_pcm_fasync, 4091 .get_unmapped_area = snd_pcm_get_unmapped_area, 4092 }, 4093 { 4094 .owner = THIS_MODULE, 4095 .read = snd_pcm_read, 4096 .read_iter = snd_pcm_readv, 4097 .open = snd_pcm_capture_open, 4098 .release = snd_pcm_release, 4099 .llseek = no_llseek, 4100 .poll = snd_pcm_poll, 4101 .unlocked_ioctl = snd_pcm_ioctl, 4102 .compat_ioctl = snd_pcm_ioctl_compat, 4103 .mmap = snd_pcm_mmap, 4104 .fasync = snd_pcm_fasync, 4105 .get_unmapped_area = snd_pcm_get_unmapped_area, 4106 } 4107 }; 4108