1 // SPDX-License-Identifier: GPL-2.0
5 * Copyright (C) 1991, 1992 Linus Torvalds
8 #include <linux/init.h>
10 #include <linux/kdev_t.h>
11 #include <linux/slab.h>
12 #include <linux/string.h>
14 #include <linux/major.h>
15 #include <linux/errno.h>
16 #include <linux/module.h>
17 #include <linux/seq_file.h>
19 #include <linux/kobject.h>
20 #include <linux/kobj_map.h>
21 #include <linux/cdev.h>
22 #include <linux/mutex.h>
23 #include <linux/backing-dev.h>
24 #include <linux/tty.h>
28 static struct kobj_map
*cdev_map
;
30 static DEFINE_MUTEX(chrdevs_lock
);
32 #define CHRDEV_MAJOR_HASH_SIZE 255
34 static struct char_device_struct
{
35 struct char_device_struct
*next
;
37 unsigned int baseminor
;
40 struct cdev
*cdev
; /* will die */
41 } *chrdevs
[CHRDEV_MAJOR_HASH_SIZE
];
43 /* index in the above */
44 static inline int major_to_index(unsigned major
)
46 return major
% CHRDEV_MAJOR_HASH_SIZE
;
51 void chrdev_show(struct seq_file
*f
, off_t offset
)
53 struct char_device_struct
*cd
;
55 mutex_lock(&chrdevs_lock
);
56 for (cd
= chrdevs
[major_to_index(offset
)]; cd
; cd
= cd
->next
) {
57 if (cd
->major
== offset
)
58 seq_printf(f
, "%3d %s\n", cd
->major
, cd
->name
);
60 mutex_unlock(&chrdevs_lock
);
63 #endif /* CONFIG_PROC_FS */
65 static int find_dynamic_major(void)
68 struct char_device_struct
*cd
;
70 for (i
= ARRAY_SIZE(chrdevs
)-1; i
>= CHRDEV_MAJOR_DYN_END
; i
--) {
71 if (chrdevs
[i
] == NULL
)
75 for (i
= CHRDEV_MAJOR_DYN_EXT_START
;
76 i
>= CHRDEV_MAJOR_DYN_EXT_END
; i
--) {
77 for (cd
= chrdevs
[major_to_index(i
)]; cd
; cd
= cd
->next
)
89 * Register a single major with a specified minor range.
91 * If major == 0 this functions will dynamically allocate a major and return
94 * If major > 0 this function will attempt to reserve the passed range of
95 * minors and will return zero on success.
97 * Returns a -ve errno on failure.
99 static struct char_device_struct
*
100 __register_chrdev_region(unsigned int major
, unsigned int baseminor
,
101 int minorct
, const char *name
)
103 struct char_device_struct
*cd
, **cp
;
107 cd
= kzalloc(sizeof(struct char_device_struct
), GFP_KERNEL
);
109 return ERR_PTR(-ENOMEM
);
111 mutex_lock(&chrdevs_lock
);
114 ret
= find_dynamic_major();
116 pr_err("CHRDEV \"%s\" dynamic allocation region is full\n",
123 if (major
>= CHRDEV_MAJOR_MAX
) {
124 pr_err("CHRDEV \"%s\" major requested (%u) is greater than the maximum (%u)\n",
125 name
, major
, CHRDEV_MAJOR_MAX
-1);
131 cd
->baseminor
= baseminor
;
132 cd
->minorct
= minorct
;
133 strlcpy(cd
->name
, name
, sizeof(cd
->name
));
135 i
= major_to_index(major
);
137 for (cp
= &chrdevs
[i
]; *cp
; cp
= &(*cp
)->next
)
138 if ((*cp
)->major
> major
||
139 ((*cp
)->major
== major
&&
140 (((*cp
)->baseminor
>= baseminor
) ||
141 ((*cp
)->baseminor
+ (*cp
)->minorct
> baseminor
))))
144 /* Check for overlapping minor ranges. */
145 if (*cp
&& (*cp
)->major
== major
) {
146 int old_min
= (*cp
)->baseminor
;
147 int old_max
= (*cp
)->baseminor
+ (*cp
)->minorct
- 1;
148 int new_min
= baseminor
;
149 int new_max
= baseminor
+ minorct
- 1;
151 /* New driver overlaps from the left. */
152 if (new_max
>= old_min
&& new_max
<= old_max
) {
157 /* New driver overlaps from the right. */
158 if (new_min
<= old_max
&& new_min
>= old_min
) {
163 if (new_min
< old_min
&& new_max
> old_max
) {
172 mutex_unlock(&chrdevs_lock
);
175 mutex_unlock(&chrdevs_lock
);
180 static struct char_device_struct
*
181 __unregister_chrdev_region(unsigned major
, unsigned baseminor
, int minorct
)
183 struct char_device_struct
*cd
= NULL
, **cp
;
184 int i
= major_to_index(major
);
186 mutex_lock(&chrdevs_lock
);
187 for (cp
= &chrdevs
[i
]; *cp
; cp
= &(*cp
)->next
)
188 if ((*cp
)->major
== major
&&
189 (*cp
)->baseminor
== baseminor
&&
190 (*cp
)->minorct
== minorct
)
196 mutex_unlock(&chrdevs_lock
);
201 * register_chrdev_region() - register a range of device numbers
202 * @from: the first in the desired range of device numbers; must include
204 * @count: the number of consecutive device numbers required
205 * @name: the name of the device or driver.
207 * Return value is zero on success, a negative error code on failure.
209 int register_chrdev_region(dev_t from
, unsigned count
, const char *name
)
211 struct char_device_struct
*cd
;
212 dev_t to
= from
+ count
;
215 for (n
= from
; n
< to
; n
= next
) {
216 next
= MKDEV(MAJOR(n
)+1, 0);
219 cd
= __register_chrdev_region(MAJOR(n
), MINOR(n
),
227 for (n
= from
; n
< to
; n
= next
) {
228 next
= MKDEV(MAJOR(n
)+1, 0);
229 kfree(__unregister_chrdev_region(MAJOR(n
), MINOR(n
), next
- n
));
235 * alloc_chrdev_region() - register a range of char device numbers
236 * @dev: output parameter for first assigned number
237 * @baseminor: first of the requested range of minor numbers
238 * @count: the number of minor numbers required
239 * @name: the name of the associated device or driver
241 * Allocates a range of char device numbers. The major number will be
242 * chosen dynamically, and returned (along with the first minor number)
243 * in @dev. Returns zero or a negative error code.
245 int alloc_chrdev_region(dev_t
*dev
, unsigned baseminor
, unsigned count
,
248 struct char_device_struct
*cd
;
249 cd
= __register_chrdev_region(0, baseminor
, count
, name
);
252 *dev
= MKDEV(cd
->major
, cd
->baseminor
);
257 * __register_chrdev() - create and register a cdev occupying a range of minors
258 * @major: major device number or 0 for dynamic allocation
259 * @baseminor: first of the requested range of minor numbers
260 * @count: the number of minor numbers required
261 * @name: name of this range of devices
262 * @fops: file operations associated with this devices
264 * If @major == 0 this functions will dynamically allocate a major and return
267 * If @major > 0 this function will attempt to reserve a device with the given
268 * major number and will return zero on success.
270 * Returns a -ve errno on failure.
272 * The name of this device has nothing to do with the name of the device in
273 * /dev. It only helps to keep track of the different owners of devices. If
274 * your module name has only one type of devices it's ok to use e.g. the name
275 * of the module here.
277 int __register_chrdev(unsigned int major
, unsigned int baseminor
,
278 unsigned int count
, const char *name
,
279 const struct file_operations
*fops
)
281 struct char_device_struct
*cd
;
285 cd
= __register_chrdev_region(major
, baseminor
, count
, name
);
293 cdev
->owner
= fops
->owner
;
295 kobject_set_name(&cdev
->kobj
, "%s", name
);
297 err
= cdev_add(cdev
, MKDEV(cd
->major
, baseminor
), count
);
303 return major
? 0 : cd
->major
;
305 kobject_put(&cdev
->kobj
);
307 kfree(__unregister_chrdev_region(cd
->major
, baseminor
, count
));
312 * unregister_chrdev_region() - unregister a range of device numbers
313 * @from: the first in the range of numbers to unregister
314 * @count: the number of device numbers to unregister
316 * This function will unregister a range of @count device numbers,
317 * starting with @from. The caller should normally be the one who
318 * allocated those numbers in the first place...
320 void unregister_chrdev_region(dev_t from
, unsigned count
)
322 dev_t to
= from
+ count
;
325 for (n
= from
; n
< to
; n
= next
) {
326 next
= MKDEV(MAJOR(n
)+1, 0);
329 kfree(__unregister_chrdev_region(MAJOR(n
), MINOR(n
), next
- n
));
334 * __unregister_chrdev - unregister and destroy a cdev
335 * @major: major device number
336 * @baseminor: first of the range of minor numbers
337 * @count: the number of minor numbers this cdev is occupying
338 * @name: name of this range of devices
340 * Unregister and destroy the cdev occupying the region described by
341 * @major, @baseminor and @count. This function undoes what
342 * __register_chrdev() did.
344 void __unregister_chrdev(unsigned int major
, unsigned int baseminor
,
345 unsigned int count
, const char *name
)
347 struct char_device_struct
*cd
;
349 cd
= __unregister_chrdev_region(major
, baseminor
, count
);
355 static DEFINE_SPINLOCK(cdev_lock
);
357 static struct kobject
*cdev_get(struct cdev
*p
)
359 struct module
*owner
= p
->owner
;
360 struct kobject
*kobj
;
362 if (owner
&& !try_module_get(owner
))
364 kobj
= kobject_get_unless_zero(&p
->kobj
);
370 void cdev_put(struct cdev
*p
)
373 struct module
*owner
= p
->owner
;
374 kobject_put(&p
->kobj
);
380 * Called every time a character special file is opened
382 static int chrdev_open(struct inode
*inode
, struct file
*filp
)
384 const struct file_operations
*fops
;
386 struct cdev
*new = NULL
;
389 spin_lock(&cdev_lock
);
392 struct kobject
*kobj
;
394 spin_unlock(&cdev_lock
);
395 kobj
= kobj_lookup(cdev_map
, inode
->i_rdev
, &idx
);
398 new = container_of(kobj
, struct cdev
, kobj
);
399 spin_lock(&cdev_lock
);
400 /* Check i_cdev again in case somebody beat us to it while
401 we dropped the lock. */
404 inode
->i_cdev
= p
= new;
405 list_add(&inode
->i_devices
, &p
->list
);
407 } else if (!cdev_get(p
))
409 } else if (!cdev_get(p
))
411 spin_unlock(&cdev_lock
);
417 fops
= fops_get(p
->ops
);
421 replace_fops(filp
, fops
);
422 if (filp
->f_op
->open
) {
423 ret
= filp
->f_op
->open(inode
, filp
);
435 void cd_forget(struct inode
*inode
)
437 spin_lock(&cdev_lock
);
438 list_del_init(&inode
->i_devices
);
439 inode
->i_cdev
= NULL
;
440 inode
->i_mapping
= &inode
->i_data
;
441 spin_unlock(&cdev_lock
);
444 static void cdev_purge(struct cdev
*cdev
)
446 spin_lock(&cdev_lock
);
447 while (!list_empty(&cdev
->list
)) {
449 inode
= container_of(cdev
->list
.next
, struct inode
, i_devices
);
450 list_del_init(&inode
->i_devices
);
451 inode
->i_cdev
= NULL
;
453 spin_unlock(&cdev_lock
);
457 * Dummy default file-operations: the only thing this does
458 * is contain the open that then fills in the correct operations
459 * depending on the special file...
461 const struct file_operations def_chr_fops
= {
463 .llseek
= noop_llseek
,
466 static struct kobject
*exact_match(dev_t dev
, int *part
, void *data
)
468 struct cdev
*p
= data
;
472 static int exact_lock(dev_t dev
, void *data
)
474 struct cdev
*p
= data
;
475 return cdev_get(p
) ? 0 : -1;
479 * cdev_add() - add a char device to the system
480 * @p: the cdev structure for the device
481 * @dev: the first device number for which this device is responsible
482 * @count: the number of consecutive minor numbers corresponding to this
485 * cdev_add() adds the device represented by @p to the system, making it
486 * live immediately. A negative error code is returned on failure.
488 int cdev_add(struct cdev
*p
, dev_t dev
, unsigned count
)
495 error
= kobj_map(cdev_map
, dev
, count
, NULL
,
496 exact_match
, exact_lock
, p
);
500 kobject_get(p
->kobj
.parent
);
506 * cdev_set_parent() - set the parent kobject for a char device
507 * @p: the cdev structure
508 * @kobj: the kobject to take a reference to
510 * cdev_set_parent() sets a parent kobject which will be referenced
511 * appropriately so the parent is not freed before the cdev. This
512 * should be called before cdev_add.
514 void cdev_set_parent(struct cdev
*p
, struct kobject
*kobj
)
516 WARN_ON(!kobj
->state_initialized
);
517 p
->kobj
.parent
= kobj
;
521 * cdev_device_add() - add a char device and it's corresponding
522 * struct device, linkink
523 * @dev: the device structure
524 * @cdev: the cdev structure
526 * cdev_device_add() adds the char device represented by @cdev to the system,
527 * just as cdev_add does. It then adds @dev to the system using device_add
528 * The dev_t for the char device will be taken from the struct device which
529 * needs to be initialized first. This helper function correctly takes a
530 * reference to the parent device so the parent will not get released until
531 * all references to the cdev are released.
533 * This helper uses dev->devt for the device number. If it is not set
534 * it will not add the cdev and it will be equivalent to device_add.
536 * This function should be used whenever the struct cdev and the
537 * struct device are members of the same structure whose lifetime is
538 * managed by the struct device.
540 * NOTE: Callers must assume that userspace was able to open the cdev and
541 * can call cdev fops callbacks at any time, even if this function fails.
543 int cdev_device_add(struct cdev
*cdev
, struct device
*dev
)
548 cdev_set_parent(cdev
, &dev
->kobj
);
550 rc
= cdev_add(cdev
, dev
->devt
, 1);
555 rc
= device_add(dev
);
563 * cdev_device_del() - inverse of cdev_device_add
564 * @dev: the device structure
565 * @cdev: the cdev structure
567 * cdev_device_del() is a helper function to call cdev_del and device_del.
568 * It should be used whenever cdev_device_add is used.
570 * If dev->devt is not set it will not remove the cdev and will be equivalent
573 * NOTE: This guarantees that associated sysfs callbacks are not running
574 * or runnable, however any cdevs already open will remain and their fops
575 * will still be callable even after this function returns.
577 void cdev_device_del(struct cdev
*cdev
, struct device
*dev
)
584 static void cdev_unmap(dev_t dev
, unsigned count
)
586 kobj_unmap(cdev_map
, dev
, count
);
590 * cdev_del() - remove a cdev from the system
591 * @p: the cdev structure to be removed
593 * cdev_del() removes @p from the system, possibly freeing the structure
596 * NOTE: This guarantees that cdev device will no longer be able to be
597 * opened, however any cdevs already open will remain and their fops will
598 * still be callable even after cdev_del returns.
600 void cdev_del(struct cdev
*p
)
602 cdev_unmap(p
->dev
, p
->count
);
603 kobject_put(&p
->kobj
);
607 static void cdev_default_release(struct kobject
*kobj
)
609 struct cdev
*p
= container_of(kobj
, struct cdev
, kobj
);
610 struct kobject
*parent
= kobj
->parent
;
616 static void cdev_dynamic_release(struct kobject
*kobj
)
618 struct cdev
*p
= container_of(kobj
, struct cdev
, kobj
);
619 struct kobject
*parent
= kobj
->parent
;
626 static struct kobj_type ktype_cdev_default
= {
627 .release
= cdev_default_release
,
630 static struct kobj_type ktype_cdev_dynamic
= {
631 .release
= cdev_dynamic_release
,
635 * cdev_alloc() - allocate a cdev structure
637 * Allocates and returns a cdev structure, or NULL on failure.
639 struct cdev
*cdev_alloc(void)
641 struct cdev
*p
= kzalloc(sizeof(struct cdev
), GFP_KERNEL
);
643 INIT_LIST_HEAD(&p
->list
);
644 kobject_init(&p
->kobj
, &ktype_cdev_dynamic
);
650 * cdev_init() - initialize a cdev structure
651 * @cdev: the structure to initialize
652 * @fops: the file_operations for this device
654 * Initializes @cdev, remembering @fops, making it ready to add to the
655 * system with cdev_add().
657 void cdev_init(struct cdev
*cdev
, const struct file_operations
*fops
)
659 memset(cdev
, 0, sizeof *cdev
);
660 INIT_LIST_HEAD(&cdev
->list
);
661 kobject_init(&cdev
->kobj
, &ktype_cdev_default
);
665 static struct kobject
*base_probe(dev_t dev
, int *part
, void *data
)
667 if (request_module("char-major-%d-%d", MAJOR(dev
), MINOR(dev
)) > 0)
668 /* Make old-style 2.4 aliases work */
669 request_module("char-major-%d", MAJOR(dev
));
673 void __init
chrdev_init(void)
675 cdev_map
= kobj_map_init(base_probe
, &chrdevs_lock
);
679 /* Let modules do char dev stuff */
680 EXPORT_SYMBOL(register_chrdev_region
);
681 EXPORT_SYMBOL(unregister_chrdev_region
);
682 EXPORT_SYMBOL(alloc_chrdev_region
);
683 EXPORT_SYMBOL(cdev_init
);
684 EXPORT_SYMBOL(cdev_alloc
);
685 EXPORT_SYMBOL(cdev_del
);
686 EXPORT_SYMBOL(cdev_add
);
687 EXPORT_SYMBOL(cdev_set_parent
);
688 EXPORT_SYMBOL(cdev_device_add
);
689 EXPORT_SYMBOL(cdev_device_del
);
690 EXPORT_SYMBOL(__register_chrdev
);
691 EXPORT_SYMBOL(__unregister_chrdev
);