2 * linux/drivers/char/mem.c
4 * Copyright (C) 1991, 1992 Linus Torvalds
7 * Jan-11-1998, C. Scott Ananian <cananian@alumni.princeton.edu>
8 * Shared /dev/zero mmaping support, Feb 2000, Kanoj Sarcar <kanoj@sgi.com>
12 #include <linux/miscdevice.h>
13 #include <linux/slab.h>
14 #include <linux/vmalloc.h>
15 #include <linux/mman.h>
16 #include <linux/random.h>
17 #include <linux/init.h>
18 #include <linux/raw.h>
19 #include <linux/tty.h>
20 #include <linux/capability.h>
21 #include <linux/ptrace.h>
22 #include <linux/device.h>
23 #include <linux/highmem.h>
24 #include <linux/crash_dump.h>
25 #include <linux/backing-dev.h>
26 #include <linux/bootmem.h>
27 #include <linux/splice.h>
28 #include <linux/pfn.h>
29 #include <linux/smp_lock.h>
31 #include <asm/uaccess.h>
35 # include <linux/efi.h>
39 * Architectures vary in how they handle caching for addresses
40 * outside of main memory.
43 static inline int uncached_access(struct file *file, unsigned long addr)
45 #if defined(CONFIG_IA64)
47 * On ia64, we ignore O_SYNC because we cannot tolerate memory attribute aliases.
49 return !(efi_mem_attributes(addr) & EFI_MEMORY_WB);
50 #elif defined(CONFIG_MIPS)
52 extern int __uncached_access(struct file *file,
55 return __uncached_access(file, addr);
59 * Accessing memory above the top the kernel knows about or through a file pointer
60 * that was marked O_SYNC will be done non-cached.
62 if (file->f_flags & O_SYNC)
64 return addr >= __pa(high_memory);
68 #ifndef ARCH_HAS_VALID_PHYS_ADDR_RANGE
69 static inline int valid_phys_addr_range(unsigned long addr, size_t count)
71 if (addr + count > __pa(high_memory))
77 static inline int valid_mmap_phys_addr_range(unsigned long pfn, size_t size)
83 #ifdef CONFIG_STRICT_DEVMEM
84 static inline int range_is_allowed(unsigned long pfn, unsigned long size)
86 u64 from = ((u64)pfn) << PAGE_SHIFT;
91 if (!devmem_is_allowed(pfn)) {
93 "Program %s tried to access /dev/mem between %Lx->%Lx.\n",
94 current->comm, from, to);
103 static inline int range_is_allowed(unsigned long pfn, unsigned long size)
109 void __attribute__((weak)) unxlate_dev_mem_ptr(unsigned long phys, void *addr)
114 * This funcion reads the *physical* memory. The f_pos points directly to the
117 static ssize_t read_mem(struct file * file, char __user * buf,
118 size_t count, loff_t *ppos)
120 unsigned long p = *ppos;
124 if (!valid_phys_addr_range(p, count))
127 #ifdef __ARCH_HAS_NO_PAGE_ZERO_MAPPED
128 /* we don't have page 0 mapped on sparc and m68k.. */
134 if (clear_user(buf, sz))
146 * Handle first page in case it's not aligned
148 if (-p & (PAGE_SIZE - 1))
149 sz = -p & (PAGE_SIZE - 1);
153 sz = min_t(unsigned long, sz, count);
155 if (!range_is_allowed(p >> PAGE_SHIFT, count))
159 * On ia64 if a page has been mapped somewhere as
160 * uncached, then it must also be accessed uncached
161 * by the kernel or data corruption may occur
163 ptr = xlate_dev_mem_ptr(p);
167 if (copy_to_user(buf, ptr, sz)) {
168 unxlate_dev_mem_ptr(p, ptr);
172 unxlate_dev_mem_ptr(p, ptr);
184 static ssize_t write_mem(struct file * file, const char __user * buf,
185 size_t count, loff_t *ppos)
187 unsigned long p = *ppos;
189 unsigned long copied;
192 if (!valid_phys_addr_range(p, count))
197 #ifdef __ARCH_HAS_NO_PAGE_ZERO_MAPPED
198 /* we don't have page 0 mapped on sparc and m68k.. */
200 unsigned long sz = PAGE_SIZE - p;
203 /* Hmm. Do something? */
213 * Handle first page in case it's not aligned
215 if (-p & (PAGE_SIZE - 1))
216 sz = -p & (PAGE_SIZE - 1);
220 sz = min_t(unsigned long, sz, count);
222 if (!range_is_allowed(p >> PAGE_SHIFT, sz))
226 * On ia64 if a page has been mapped somewhere as
227 * uncached, then it must also be accessed uncached
228 * by the kernel or data corruption may occur
230 ptr = xlate_dev_mem_ptr(p);
237 copied = copy_from_user(ptr, buf, sz);
239 written += sz - copied;
240 unxlate_dev_mem_ptr(p, ptr);
246 unxlate_dev_mem_ptr(p, ptr);
258 int __attribute__((weak)) phys_mem_access_prot_allowed(struct file *file,
259 unsigned long pfn, unsigned long size, pgprot_t *vma_prot)
264 #ifndef __HAVE_PHYS_MEM_ACCESS_PROT
265 static pgprot_t phys_mem_access_prot(struct file *file, unsigned long pfn,
266 unsigned long size, pgprot_t vma_prot)
268 #ifdef pgprot_noncached
269 unsigned long offset = pfn << PAGE_SHIFT;
271 if (uncached_access(file, offset))
272 return pgprot_noncached(vma_prot);
279 static unsigned long get_unmapped_area_mem(struct file *file,
285 if (!valid_mmap_phys_addr_range(pgoff, len))
286 return (unsigned long) -EINVAL;
287 return pgoff << PAGE_SHIFT;
290 /* can't do an in-place private mapping if there's no MMU */
291 static inline int private_mapping_ok(struct vm_area_struct *vma)
293 return vma->vm_flags & VM_MAYSHARE;
296 #define get_unmapped_area_mem NULL
298 static inline int private_mapping_ok(struct vm_area_struct *vma)
304 void __attribute__((weak))
305 map_devmem(unsigned long pfn, unsigned long len, pgprot_t prot)
307 /* nothing. architectures can override. */
310 void __attribute__((weak))
311 unmap_devmem(unsigned long pfn, unsigned long len, pgprot_t prot)
313 /* nothing. architectures can override. */
316 static void mmap_mem_open(struct vm_area_struct *vma)
318 map_devmem(vma->vm_pgoff, vma->vm_end - vma->vm_start,
322 static void mmap_mem_close(struct vm_area_struct *vma)
324 unmap_devmem(vma->vm_pgoff, vma->vm_end - vma->vm_start,
328 static struct vm_operations_struct mmap_mem_ops = {
329 .open = mmap_mem_open,
330 .close = mmap_mem_close,
331 #ifdef CONFIG_HAVE_IOREMAP_PROT
332 .access = generic_access_phys
336 static int mmap_mem(struct file * file, struct vm_area_struct * vma)
338 size_t size = vma->vm_end - vma->vm_start;
340 if (!valid_mmap_phys_addr_range(vma->vm_pgoff, size))
343 if (!private_mapping_ok(vma))
346 if (!range_is_allowed(vma->vm_pgoff, size))
349 if (!phys_mem_access_prot_allowed(file, vma->vm_pgoff, size,
353 vma->vm_page_prot = phys_mem_access_prot(file, vma->vm_pgoff,
357 vma->vm_ops = &mmap_mem_ops;
359 /* Remap-pfn-range will mark the range VM_IO and VM_RESERVED */
360 if (remap_pfn_range(vma,
364 vma->vm_page_prot)) {
365 unmap_devmem(vma->vm_pgoff, size, vma->vm_page_prot);
371 #ifdef CONFIG_DEVKMEM
372 static int mmap_kmem(struct file * file, struct vm_area_struct * vma)
376 /* Turn a kernel-virtual address into a physical page frame */
377 pfn = __pa((u64)vma->vm_pgoff << PAGE_SHIFT) >> PAGE_SHIFT;
380 * RED-PEN: on some architectures there is more mapped memory
381 * than available in mem_map which pfn_valid checks
382 * for. Perhaps should add a new macro here.
384 * RED-PEN: vmalloc is not supported right now.
390 return mmap_mem(file, vma);
394 #ifdef CONFIG_CRASH_DUMP
396 * Read memory corresponding to the old kernel.
398 static ssize_t read_oldmem(struct file *file, char __user *buf,
399 size_t count, loff_t *ppos)
401 unsigned long pfn, offset;
402 size_t read = 0, csize;
406 pfn = *ppos / PAGE_SIZE;
407 if (pfn > saved_max_pfn)
410 offset = (unsigned long)(*ppos % PAGE_SIZE);
411 if (count > PAGE_SIZE - offset)
412 csize = PAGE_SIZE - offset;
416 rc = copy_oldmem_page(pfn, buf, csize, offset, 1);
428 #ifdef CONFIG_DEVKMEM
430 * This function reads the *virtual* memory as seen by the kernel.
432 static ssize_t read_kmem(struct file *file, char __user *buf,
433 size_t count, loff_t *ppos)
435 unsigned long p = *ppos;
436 ssize_t low_count, read, sz;
437 char * kbuf; /* k-addr because vread() takes vmlist_lock rwlock */
440 if (p < (unsigned long) high_memory) {
442 if (count > (unsigned long) high_memory - p)
443 low_count = (unsigned long) high_memory - p;
445 #ifdef __ARCH_HAS_NO_PAGE_ZERO_MAPPED
446 /* we don't have page 0 mapped on sparc and m68k.. */
447 if (p < PAGE_SIZE && low_count > 0) {
448 size_t tmp = PAGE_SIZE - p;
449 if (tmp > low_count) tmp = low_count;
450 if (clear_user(buf, tmp))
459 while (low_count > 0) {
461 * Handle first page in case it's not aligned
463 if (-p & (PAGE_SIZE - 1))
464 sz = -p & (PAGE_SIZE - 1);
468 sz = min_t(unsigned long, sz, low_count);
471 * On ia64 if a page has been mapped somewhere as
472 * uncached, then it must also be accessed uncached
473 * by the kernel or data corruption may occur
475 kbuf = xlate_dev_kmem_ptr((char *)p);
477 if (copy_to_user(buf, kbuf, sz))
488 kbuf = (char *)__get_free_page(GFP_KERNEL);
496 len = vread(kbuf, (char *)p, len);
499 if (copy_to_user(buf, kbuf, len)) {
500 free_page((unsigned long)kbuf);
508 free_page((unsigned long)kbuf);
515 static inline ssize_t
516 do_write_kmem(void *p, unsigned long realp, const char __user * buf,
517 size_t count, loff_t *ppos)
520 unsigned long copied;
523 #ifdef __ARCH_HAS_NO_PAGE_ZERO_MAPPED
524 /* we don't have page 0 mapped on sparc and m68k.. */
525 if (realp < PAGE_SIZE) {
526 unsigned long sz = PAGE_SIZE - realp;
529 /* Hmm. Do something? */
541 * Handle first page in case it's not aligned
543 if (-realp & (PAGE_SIZE - 1))
544 sz = -realp & (PAGE_SIZE - 1);
548 sz = min_t(unsigned long, sz, count);
551 * On ia64 if a page has been mapped somewhere as
552 * uncached, then it must also be accessed uncached
553 * by the kernel or data corruption may occur
555 ptr = xlate_dev_kmem_ptr(p);
557 copied = copy_from_user(ptr, buf, sz);
559 written += sz - copied;
577 * This function writes to the *virtual* memory as seen by the kernel.
579 static ssize_t write_kmem(struct file * file, const char __user * buf,
580 size_t count, loff_t *ppos)
582 unsigned long p = *ppos;
586 char * kbuf; /* k-addr because vwrite() takes vmlist_lock rwlock */
588 if (p < (unsigned long) high_memory) {
591 if (count > (unsigned long) high_memory - p)
592 wrote = (unsigned long) high_memory - p;
594 written = do_write_kmem((void*)p, p, buf, wrote, ppos);
595 if (written != wrote)
604 kbuf = (char *)__get_free_page(GFP_KERNEL);
606 return wrote ? wrote : -ENOMEM;
613 written = copy_from_user(kbuf, buf, len);
617 free_page((unsigned long)kbuf);
621 len = vwrite(kbuf, (char *)p, len);
627 free_page((unsigned long)kbuf);
631 return virtr + wrote;
635 #ifdef CONFIG_DEVPORT
636 static ssize_t read_port(struct file * file, char __user * buf,
637 size_t count, loff_t *ppos)
639 unsigned long i = *ppos;
640 char __user *tmp = buf;
642 if (!access_ok(VERIFY_WRITE, buf, count))
644 while (count-- > 0 && i < 65536) {
645 if (__put_user(inb(i),tmp) < 0)
654 static ssize_t write_port(struct file * file, const char __user * buf,
655 size_t count, loff_t *ppos)
657 unsigned long i = *ppos;
658 const char __user * tmp = buf;
660 if (!access_ok(VERIFY_READ,buf,count))
662 while (count-- > 0 && i < 65536) {
664 if (__get_user(c, tmp)) {
678 static ssize_t read_null(struct file * file, char __user * buf,
679 size_t count, loff_t *ppos)
684 static ssize_t write_null(struct file * file, const char __user * buf,
685 size_t count, loff_t *ppos)
690 static int pipe_to_null(struct pipe_inode_info *info, struct pipe_buffer *buf,
691 struct splice_desc *sd)
696 static ssize_t splice_write_null(struct pipe_inode_info *pipe,struct file *out,
697 loff_t *ppos, size_t len, unsigned int flags)
699 return splice_from_pipe(pipe, out, ppos, len, flags, pipe_to_null);
702 static ssize_t read_zero(struct file * file, char __user * buf,
703 size_t count, loff_t *ppos)
710 if (!access_ok(VERIFY_WRITE, buf, count))
715 unsigned long unwritten;
716 size_t chunk = count;
718 if (chunk > PAGE_SIZE)
719 chunk = PAGE_SIZE; /* Just for latency reasons */
720 unwritten = clear_user(buf, chunk);
721 written += chunk - unwritten;
728 return written ? written : -EFAULT;
731 static int mmap_zero(struct file * file, struct vm_area_struct * vma)
736 if (vma->vm_flags & VM_SHARED)
737 return shmem_zero_setup(vma);
741 static ssize_t write_full(struct file * file, const char __user * buf,
742 size_t count, loff_t *ppos)
748 * Special lseek() function for /dev/null and /dev/zero. Most notably, you
749 * can fopen() both devices with "a" now. This was previously impossible.
753 static loff_t null_lseek(struct file * file, loff_t offset, int orig)
755 return file->f_pos = 0;
759 * The memory devices use the full 32/64 bits of the offset, and so we cannot
760 * check against negative addresses: they are ok. The return value is weird,
761 * though, in that case (0).
763 * also note that seeking relative to the "end of file" isn't supported:
764 * it has no meaning, so it returns -EINVAL.
766 static loff_t memory_lseek(struct file * file, loff_t offset, int orig)
770 mutex_lock(&file->f_path.dentry->d_inode->i_mutex);
773 file->f_pos = offset;
775 force_successful_syscall_return();
778 file->f_pos += offset;
780 force_successful_syscall_return();
785 mutex_unlock(&file->f_path.dentry->d_inode->i_mutex);
789 static int open_port(struct inode * inode, struct file * filp)
791 return capable(CAP_SYS_RAWIO) ? 0 : -EPERM;
794 #define zero_lseek null_lseek
795 #define full_lseek null_lseek
796 #define write_zero write_null
797 #define read_full read_zero
798 #define open_mem open_port
799 #define open_kmem open_mem
800 #define open_oldmem open_mem
802 static const struct file_operations mem_fops = {
803 .llseek = memory_lseek,
808 .get_unmapped_area = get_unmapped_area_mem,
811 #ifdef CONFIG_DEVKMEM
812 static const struct file_operations kmem_fops = {
813 .llseek = memory_lseek,
818 .get_unmapped_area = get_unmapped_area_mem,
822 static const struct file_operations null_fops = {
823 .llseek = null_lseek,
826 .splice_write = splice_write_null,
829 #ifdef CONFIG_DEVPORT
830 static const struct file_operations port_fops = {
831 .llseek = memory_lseek,
838 static const struct file_operations zero_fops = {
839 .llseek = zero_lseek,
846 * capabilities for /dev/zero
847 * - permits private mappings, "copies" are taken of the source of zeros
849 static struct backing_dev_info zero_bdi = {
850 .capabilities = BDI_CAP_MAP_COPY,
853 static const struct file_operations full_fops = {
854 .llseek = full_lseek,
859 #ifdef CONFIG_CRASH_DUMP
860 static const struct file_operations oldmem_fops = {
866 static ssize_t kmsg_write(struct file * file, const char __user * buf,
867 size_t count, loff_t *ppos)
872 tmp = kmalloc(count + 1, GFP_KERNEL);
876 if (!copy_from_user(tmp, buf, count)) {
878 ret = printk("%s", tmp);
880 /* printk can add a prefix */
887 static const struct file_operations kmsg_fops = {
891 static int memory_open(struct inode * inode, struct file * filp)
896 switch (iminor(inode)) {
898 filp->f_op = &mem_fops;
899 filp->f_mapping->backing_dev_info =
900 &directly_mappable_cdev_bdi;
902 #ifdef CONFIG_DEVKMEM
904 filp->f_op = &kmem_fops;
905 filp->f_mapping->backing_dev_info =
906 &directly_mappable_cdev_bdi;
910 filp->f_op = &null_fops;
912 #ifdef CONFIG_DEVPORT
914 filp->f_op = &port_fops;
918 filp->f_mapping->backing_dev_info = &zero_bdi;
919 filp->f_op = &zero_fops;
922 filp->f_op = &full_fops;
925 filp->f_op = &random_fops;
928 filp->f_op = &urandom_fops;
931 filp->f_op = &kmsg_fops;
933 #ifdef CONFIG_CRASH_DUMP
935 filp->f_op = &oldmem_fops;
942 if (filp->f_op && filp->f_op->open)
943 ret = filp->f_op->open(inode,filp);
948 static const struct file_operations memory_fops = {
949 .open = memory_open, /* just a selector for the real open */
952 static const struct {
956 const struct file_operations *fops;
957 } devlist[] = { /* list of minor devices */
958 {1, "mem", S_IRUSR | S_IWUSR | S_IRGRP, &mem_fops},
959 #ifdef CONFIG_DEVKMEM
960 {2, "kmem", S_IRUSR | S_IWUSR | S_IRGRP, &kmem_fops},
962 {3, "null", S_IRUGO | S_IWUGO, &null_fops},
963 #ifdef CONFIG_DEVPORT
964 {4, "port", S_IRUSR | S_IWUSR | S_IRGRP, &port_fops},
966 {5, "zero", S_IRUGO | S_IWUGO, &zero_fops},
967 {7, "full", S_IRUGO | S_IWUGO, &full_fops},
968 {8, "random", S_IRUGO | S_IWUSR, &random_fops},
969 {9, "urandom", S_IRUGO | S_IWUSR, &urandom_fops},
970 {11,"kmsg", S_IRUGO | S_IWUSR, &kmsg_fops},
971 #ifdef CONFIG_CRASH_DUMP
972 {12,"oldmem", S_IRUSR | S_IWUSR | S_IRGRP, &oldmem_fops},
976 static struct class *mem_class;
978 static int __init chr_dev_init(void)
983 err = bdi_init(&zero_bdi);
987 if (register_chrdev(MEM_MAJOR,"mem",&memory_fops))
988 printk("unable to get major %d for memory devs\n", MEM_MAJOR);
990 mem_class = class_create(THIS_MODULE, "mem");
991 for (i = 0; i < ARRAY_SIZE(devlist); i++)
992 device_create(mem_class, NULL,
993 MKDEV(MEM_MAJOR, devlist[i].minor), NULL,
999 fs_initcall(chr_dev_init);