linux-2.6.33/snd_card_create() の履歴(No.1)

• 履歴一覧
• 差分 を表示
• 現在との差分 を表示
• ソース を表示
• linux-2.6.33/snd_card_create() へ行く。
  • 1 (2013-08-08 (木) 08:49:41)

---

参照元†

説明†

• パス: [[linux-2.6.33/]]

• FIXME: これは何？
  • 説明

引数†

• int idx
• const char *xid
• struct module *module
  • linux-2.6.33/module
• int extra_size
• struct snd_card **card_ret
  • linux-2.6.33/snd_card

返り値†

• int

参考†

実装†

/**
 *  snd_card_create - create and initialize a soundcard structure
 *  @idx: card index (address) [0 ... (SNDRV_CARDS-1)]
 *  @xid: card identification (ASCII string)
 *  @module: top level module for locking
 *  @extra_size: allocate this extra size after the main soundcard structure
 *  @card_ret: the pointer to store the created card instance
 *
 *  Creates and initializes a soundcard structure.
 *
 *  The function allocates snd_card instance via kzalloc with the given
 *  space for the driver to use freely.  The allocated struct is stored
 *  in the given card_ret pointer.
 *
 *  Returns zero if successful or a negative error code.
 */
int snd_card_create(int idx, const char *xid,
		    struct module *module, int extra_size,
		    struct snd_card **card_ret)
{
	struct snd_card *card;
	int err, idx2;

	if (snd_BUG_ON(!card_ret))
		return -EINVAL;
	*card_ret = NULL;

• • linux-2.6.33/snd_BUG_ON()

	if (extra_size < 0)
		extra_size = 0;
	card = kzalloc(sizeof(*card) + extra_size, GFP_KERNEL);
	if (!card)
		return -ENOMEM;
	if (xid)
		strlcpy(card->id, xid, sizeof(card->id));

• • linux-2.6.33/kzalloc()

• linux-2.6.33/strlcpy()

	err = 0;
	mutex_lock(&snd_card_mutex);

• • linux-2.6.33/mutex_lock()

• linux-2.6.33/snd_card_mutex(global)

	if (idx < 0) {
		for (idx2 = 0; idx2 < SNDRV_CARDS; idx2++)
			/* idx == -1 == 0xffff means: take any free slot */
			if (~snd_cards_lock & idx & 1<<idx2) {
				if (module_slot_match(module, idx2)) {
					idx = idx2;
					break;
				}
			}
	}

• • linux-2.6.33/SNDRV_CARDS

• linux-2.6.33/module_slot_match()

• • linux-2.6.33/snd_cards_lock(global)

	if (idx < 0) {
		for (idx2 = 0; idx2 < SNDRV_CARDS; idx2++)
			/* idx == -1 == 0xffff means: take any free slot */
			if (~snd_cards_lock & idx & 1<<idx2) {
				if (!slots[idx2] || !*slots[idx2]) {
					idx = idx2;
					break;
				}
			}
	}
	if (idx < 0)
		err = -ENODEV;
	else if (idx < snd_ecards_limit) {
		if (snd_cards_lock & (1 << idx))
			err = -EBUSY;	/* invalid */
	} else if (idx >= SNDRV_CARDS)
		err = -ENODEV;

• • linux-2.6.33/snd_ecards_limit(global)

	if (err < 0) {
		mutex_unlock(&snd_card_mutex);
		snd_printk(KERN_ERR "cannot find the slot for index %d (range 0-%i), error: %d\n",
			 idx, snd_ecards_limit - 1, err);
		goto __error;
	}

• • linux-2.6.33/mutex_unlock()

• linux-2.6.33/snd_printk()

	snd_cards_lock |= 1 << idx;		/* lock it */
	if (idx >= snd_ecards_limit)
		snd_ecards_limit = idx + 1; /* increase the limit */
	mutex_unlock(&snd_card_mutex);
	card->number = idx;
	card->module = module;
	INIT_LIST_HEAD(&card->devices);
	init_rwsem(&card->controls_rwsem);
	rwlock_init(&card->ctl_files_rwlock);
	INIT_LIST_HEAD(&card->controls);
	INIT_LIST_HEAD(&card->ctl_files);
	spin_lock_init(&card->files_lock);
	INIT_LIST_HEAD(&card->files_list);
	init_waitqueue_head(&card->shutdown_sleep);

• • linux-2.6.33/INIT_LIST_HEAD()

• linux-2.6.33/init_rwsem()

• • linux-2.6.33/rwlock_init()

• linux-2.6.33/spin_lock_init()

• • linux-2.6.33/init_waitqueue_head()

#ifdef CONFIG_PM
	mutex_init(&card->power_lock);
	init_waitqueue_head(&card->power_sleep);
#endif
	/* the control interface cannot be accessed from the user space until */
	/* snd_cards_bitmask and snd_cards are set with snd_card_register */
	err = snd_ctl_create(card);
	if (err < 0) {
		snd_printk(KERN_ERR "unable to register control minors\n");
		goto __error;
	}

• • linux-2.6.33/snd_ctl_create()

	err = snd_info_card_create(card);
	if (err < 0) {
		snd_printk(KERN_ERR "unable to create card info\n");
		goto __error_ctl;
	}

• • linux-2.6.33/snd_info_card_create()

	if (extra_size > 0)
		card->private_data = (char *)card + sizeof(struct snd_card);
	*card_ret = card;
	return 0;

      __error_ctl:
	snd_device_free_all(card, SNDRV_DEV_CMD_PRE);

• • linux-2.6.33/snd_device_free_all()

• linux-2.6.33/SNDRV_DEV_CMD_PRE

      __error:
	kfree(card);

• • linux-2.6.33/kfree()

  	return err;
}
EXPORT_SYMBOL(snd_card_create);

• ライセンスに関係なくシンボルを公開する。
  • linux-2.6.33/EXPORT_SYMBOL()

コメント†