root/include/linux/fs.h

/* */

INCLUDED FROM

DEFINITIONS

1. mark_buffer_clean
2. mark_buffer_dirty
3. iget

   1 #ifndef _LINUX_FS_H
   2 #define _LINUX_FS_H
   3 
   4 /*
   5  * This file has definitions for some important file table
   6  * structures etc.
   7  */
   8 
   9 #include <linux/linkage.h>
  10 #include <linux/limits.h>
  11 #include <linux/wait.h>
  12 #include <linux/types.h>
  13 #include <linux/dirent.h>
  14 #include <linux/vfs.h>
  15 #include <linux/net.h>
  16 
  17 /*
  18  * It's silly to have NR_OPEN bigger than NR_FILE, but I'll fix
  19  * that later. Anyway, now the file code is no longer dependent
  20  * on bitmaps in unsigned longs, but uses the new fd_set structure..
  21  *
  22  * Some programs (notably those using select()) may have to be 
  23  * recompiled to take full advantage of the new limits..
  24  */
  25 #undef NR_OPEN
  26 #define NR_OPEN 256
  27 
  28 #define NR_INODE 2048   /* this should be bigger than NR_FILE */
  29 #define NR_FILE 1024    /* this can well be larger on a larger system */
  30 #define NR_SUPER 32
  31 #define NR_IHASH 131
  32 #define NR_FILE_LOCKS 64
  33 #define BLOCK_SIZE 1024
  34 #define BLOCK_SIZE_BITS 10
  35 
  36 #define MAY_EXEC 1
  37 #define MAY_WRITE 2
  38 #define MAY_READ 4
  39 
  40 #define READ 0
  41 #define WRITE 1
  42 #define READA 2         /* read-ahead - don't pause */
  43 #define WRITEA 3        /* "write-ahead" - silly, but somewhat useful */
  44 
  45 extern void buffer_init(void);
  46 extern unsigned long inode_init(unsigned long start, unsigned long end);
  47 extern unsigned long file_table_init(unsigned long start, unsigned long end);
  48 extern unsigned long name_cache_init(unsigned long start, unsigned long end);
  49 
  50 #define MAJOR(a) (int)((unsigned short)(a) >> 8)
  51 #define MINOR(a) (int)((unsigned short)(a) & 0xFF)
  52 #define MKDEV(a,b) ((int)((((a) & 0xff) << 8) | ((b) & 0xff)))
  53 #define NODEV MKDEV(0,0)
  54 
  55 #ifndef NULL
  56 #define NULL ((void *) 0)
  57 #endif
  58 
  59 #define NIL_FILP        ((struct file *)0)
  60 #define SEL_IN          1
  61 #define SEL_OUT         2
  62 #define SEL_EX          4
  63 
  64 /*
  65  * These are the fs-independent mount-flags: up to 16 flags are supported
  66  */
  67 #define MS_RDONLY    1 /* mount read-only */
  68 #define MS_NOSUID    2 /* ignore suid and sgid bits */
  69 #define MS_NODEV     4 /* disallow access to device special files */
  70 #define MS_NOEXEC    8 /* disallow program execution */
  71 #define MS_SYNC     16 /* writes are synced at once */
  72 #define MS_REMOUNT  32 /* alter flags of a mounted FS */
  73 
  74 #define S_APPEND    256 /* append-only file */
  75 #define S_IMMUTABLE 512 /* immutable file */
  76 
  77 /*
  78  * Flags that can be altered by MS_REMOUNT
  79  */
  80 #define MS_RMT_MASK (MS_RDONLY)
  81 
  82 /*
  83  * Magic mount flag number. Has to be or-ed to the flag values.
  84  */
  85 #define MS_MGC_VAL 0xC0ED0000 /* magic flag number to indicate "new" flags */
  86 #define MS_MGC_MSK 0xffff0000 /* magic flag number mask */
  87 
  88 /*
  89  * Note that read-only etc flags are inode-specific: setting some file-system
  90  * flags just means all the inodes inherit those flags by default. It might be
  91  * possible to override it selectively if you really wanted to with some
  92  * ioctl() that is not currently implemented.
  93  *
  94  * Exception: MS_RDONLY is always applied to the entire file system.
  95  */
  96 #define IS_RDONLY(inode) (((inode)->i_sb) && ((inode)->i_sb->s_flags & MS_RDONLY))
  97 #define IS_NOSUID(inode) ((inode)->i_flags & MS_NOSUID)
  98 #define IS_NODEV(inode) ((inode)->i_flags & MS_NODEV)
  99 #define IS_NOEXEC(inode) ((inode)->i_flags & MS_NOEXEC)
 100 #define IS_SYNC(inode) ((inode)->i_flags & MS_SYNC)
 101 
 102 #define IS_APPEND(inode) ((inode)->i_flags & S_APPEND)
 103 #define IS_IMMUTABLE(inode) ((inode)->i_flags & S_IMMUTABLE)
 104 
 105 /* the read-only stuff doesn't really belong here, but any other place is
 106    probably as bad and I don't want to create yet another include file. */
 107 
 108 #define BLKROSET 4701 /* set device read-only (0 = read-write) */
 109 #define BLKROGET 4702 /* get read-only status (0 = read_write) */
 110 #define BLKRRPART 4703 /* re-read partition table */
 111 #define BLKGETSIZE 4704 /* return device size */
 112 #define BLKFLSBUF 4705 /* flush buffer cache */
 113 #define BLKRASET 4706 /* Set read ahead for block device */
 114 #define BLKRAGET 4707 /* get current read ahead setting */
 115 
 116 /* These are a few other constants  only used by scsi  devices */
 117 
 118 #define SCSI_IOCTL_GET_IDLUN 0x5382
 119 
 120 /* Used to turn on and off tagged queuing for scsi devices */
 121 
 122 #define SCSI_IOCTL_TAGGED_ENABLE 0x5383
 123 #define SCSI_IOCTL_TAGGED_DISABLE 0x5384
 124 
 125 
 126 #define BMAP_IOCTL 1    /* obsolete - kept for compatibility */
 127 #define FIBMAP     1    /* bmap access */
 128 #define FIGETBSZ   2    /* get the block size used for bmap */
 129 
 130 /* these flags tell notify_change what is being changed */
 131 
 132 #define NOTIFY_SIZE     1
 133 #define NOTIFY_MODE     2
 134 #define NOTIFY_TIME     4
 135 #define NOTIFY_UIDGID   8
 136 
 137 typedef char buffer_block[BLOCK_SIZE];
 138 
 139 struct buffer_head {
 140         char * b_data;                  /* pointer to data block (1024 bytes) */
 141         unsigned long b_size;           /* block size */
 142         unsigned long b_blocknr;        /* block number */
 143         dev_t b_dev;                    /* device (0 = free) */
 144         unsigned short b_count;         /* users using this block */
 145         unsigned char b_uptodate;
 146         unsigned char b_dirt;           /* 0-clean,1-dirty */
 147         unsigned char b_lock;           /* 0 - ok, 1 -locked */
 148         unsigned char b_req;            /* 0 if the buffer has been invalidated */
 149         unsigned char b_list;           /* List that this buffer appears */
 150         unsigned char b_retain;         /* Expected number of times this will
 151                                            be used.  Put on freelist when 0 */
 152         unsigned long b_flushtime;      /* Time when this (dirty) buffer should be written */
 153         unsigned long b_lru_time;       /* Time when this buffer was last used. */
 154         struct wait_queue * b_wait;
 155         struct buffer_head * b_prev;            /* doubly linked list of hash-queue */
 156         struct buffer_head * b_next;
 157         struct buffer_head * b_prev_free;       /* doubly linked list of buffers */
 158         struct buffer_head * b_next_free;
 159         struct buffer_head * b_this_page;       /* circular list of buffers in one page */
 160         struct buffer_head * b_reqnext;         /* request queue */
 161 };
 162 
 163 #include <linux/pipe_fs_i.h>
 164 #include <linux/minix_fs_i.h>
 165 #include <linux/ext_fs_i.h>
 166 #include <linux/ext2_fs_i.h>
 167 #include <linux/hpfs_fs_i.h>
 168 #include <linux/msdos_fs_i.h>
 169 #include <linux/umsdos_fs_i.h>
 170 #include <linux/iso_fs_i.h>
 171 #include <linux/nfs_fs_i.h>
 172 #include <linux/xia_fs_i.h>
 173 #include <linux/sysv_fs_i.h>
 174 
 175 #ifdef __KERNEL__
 176 
 177 struct inode {
 178         dev_t           i_dev;
 179         unsigned long   i_ino;
 180         umode_t         i_mode;
 181         nlink_t         i_nlink;
 182         uid_t           i_uid;
 183         gid_t           i_gid;
 184         dev_t           i_rdev;
 185         off_t           i_size;
 186         time_t          i_atime;
 187         time_t          i_mtime;
 188         time_t          i_ctime;
 189         unsigned long   i_blksize;
 190         unsigned long   i_blocks;
 191         unsigned long   i_version;
 192         struct semaphore i_sem;
 193         struct inode_operations * i_op;
 194         struct super_block * i_sb;
 195         struct wait_queue * i_wait;
 196         struct file_lock * i_flock;
 197         struct vm_area_struct * i_mmap;
 198         struct inode * i_next, * i_prev;
 199         struct inode * i_hash_next, * i_hash_prev;
 200         struct inode * i_bound_to, * i_bound_by;
 201         struct inode * i_mount;
 202         struct socket * i_socket;
 203         unsigned short i_count;
 204         unsigned short i_flags;
 205         unsigned char i_lock;
 206         unsigned char i_dirt;
 207         unsigned char i_pipe;
 208         unsigned char i_seek;
 209         unsigned char i_update;
 210         union {
 211                 struct pipe_inode_info pipe_i;
 212                 struct minix_inode_info minix_i;
 213                 struct ext_inode_info ext_i;
 214                 struct ext2_inode_info ext2_i;
 215                 struct hpfs_inode_info hpfs_i;
 216                 struct msdos_inode_info msdos_i;
 217                 struct umsdos_inode_info umsdos_i;
 218                 struct iso_inode_info isofs_i;
 219                 struct nfs_inode_info nfs_i;
 220                 struct xiafs_inode_info xiafs_i;
 221                 struct sysv_inode_info sysv_i;
 222                 void * generic_ip;
 223         } u;
 224 };
 225 
 226 struct file {
 227         mode_t f_mode;
 228         loff_t f_pos;
 229         unsigned short f_flags;
 230         unsigned short f_count;
 231         off_t f_reada;
 232         struct file *f_next, *f_prev;
 233         int f_owner;            /* pid or -pgrp where SIGIO should be sent */
 234         struct inode * f_inode;
 235         struct file_operations * f_op;
 236         void *private_data;     /* needed for tty driver, and maybe others */
 237 };
 238 
 239 struct file_lock {
 240         struct file_lock *fl_next;      /* singly linked list */
 241         struct task_struct *fl_owner;   /* NULL if on free list, for sanity checks */
 242         unsigned int fl_fd;             /* File descriptor for this lock */
 243         struct wait_queue *fl_wait;
 244         char fl_type;
 245         char fl_whence;
 246         off_t fl_start;
 247         off_t fl_end;
 248 };
 249 
 250 struct fasync_struct {
 251         int    magic;
 252         struct fasync_struct    *fa_next; /* singly linked list */
 253         struct file             *fa_file;
 254 };
 255 
 256 #define FASYNC_MAGIC 0x4601
 257 
 258 #include <linux/minix_fs_sb.h>
 259 #include <linux/ext_fs_sb.h>
 260 #include <linux/ext2_fs_sb.h>
 261 #include <linux/hpfs_fs_sb.h>
 262 #include <linux/msdos_fs_sb.h>
 263 #include <linux/iso_fs_sb.h>
 264 #include <linux/nfs_fs_sb.h>
 265 #include <linux/xia_fs_sb.h>
 266 #include <linux/sysv_fs_sb.h>
 267 
 268 struct super_block {
 269         dev_t s_dev;
 270         unsigned long s_blocksize;
 271         unsigned char s_blocksize_bits;
 272         unsigned char s_lock;
 273         unsigned char s_rd_only;
 274         unsigned char s_dirt;
 275         struct super_operations *s_op;
 276         unsigned long s_flags;
 277         unsigned long s_magic;
 278         unsigned long s_time;
 279         struct inode * s_covered;
 280         struct inode * s_mounted;
 281         struct wait_queue * s_wait;
 282         union {
 283                 struct minix_sb_info minix_sb;
 284                 struct ext_sb_info ext_sb;
 285                 struct ext2_sb_info ext2_sb;
 286                 struct hpfs_sb_info hpfs_sb;
 287                 struct msdos_sb_info msdos_sb;
 288                 struct isofs_sb_info isofs_sb;
 289                 struct nfs_sb_info nfs_sb;
 290                 struct xiafs_sb_info xiafs_sb;
 291                 struct sysv_sb_info sysv_sb;
 292                 void *generic_sbp;
 293         } u;
 294 };
 295 
 296 struct file_operations {
 297         int (*lseek) (struct inode *, struct file *, off_t, int);
 298         int (*read) (struct inode *, struct file *, char *, int);
 299         int (*write) (struct inode *, struct file *, char *, int);
 300         int (*readdir) (struct inode *, struct file *, struct dirent *, int);
 301         int (*select) (struct inode *, struct file *, int, select_table *);
 302         int (*ioctl) (struct inode *, struct file *, unsigned int, unsigned long);
 303         int (*mmap) (struct inode *, struct file *, struct vm_area_struct *);
 304         int (*open) (struct inode *, struct file *);
 305         void (*release) (struct inode *, struct file *);
 306         int (*fsync) (struct inode *, struct file *);
 307         int (*fasync) (struct inode *, struct file *, int);
 308         int (*check_media_change) (dev_t dev);
 309         int (*revalidate) (dev_t dev);
 310 };
 311 
 312 struct inode_operations {
 313         struct file_operations * default_file_ops;
 314         int (*create) (struct inode *,const char *,int,int,struct inode **);
 315         int (*lookup) (struct inode *,const char *,int,struct inode **);
 316         int (*link) (struct inode *,struct inode *,const char *,int);
 317         int (*unlink) (struct inode *,const char *,int);
 318         int (*symlink) (struct inode *,const char *,int,const char *);
 319         int (*mkdir) (struct inode *,const char *,int,int);
 320         int (*rmdir) (struct inode *,const char *,int);
 321         int (*mknod) (struct inode *,const char *,int,int,int);
 322         int (*rename) (struct inode *,const char *,int,struct inode *,const char *,int);
 323         int (*readlink) (struct inode *,char *,int);
 324         int (*follow_link) (struct inode *,struct inode *,int,int,struct inode **);
 325         int (*bmap) (struct inode *,int);
 326         void (*truncate) (struct inode *);
 327         int (*permission) (struct inode *, int);
 328         int (*smap) (struct inode *,int);
 329 };
 330 
 331 struct super_operations {
 332         void (*read_inode) (struct inode *);
 333         int (*notify_change) (int flags, struct inode *);
 334         void (*write_inode) (struct inode *);
 335         void (*put_inode) (struct inode *);
 336         void (*put_super) (struct super_block *);
 337         void (*write_super) (struct super_block *);
 338         void (*statfs) (struct super_block *, struct statfs *);
 339         int (*remount_fs) (struct super_block *, int *, char *);
 340 };
 341 
 342 struct file_system_type {
 343         struct super_block *(*read_super) (struct super_block *, void *, int);
 344         char *name;
 345         int requires_dev;
 346         struct file_system_type * next;
 347 };
 348 
 349 extern int register_filesystem(struct file_system_type *);
 350 extern int unregister_filesystem(struct file_system_type *);
 351 
 352 asmlinkage int sys_open(const char *, int, int);
 353 asmlinkage int sys_close(unsigned int);         /* yes, it's really unsigned */
 354 
 355 extern void kill_fasync(struct fasync_struct *fa, int sig);
 356 
 357 extern int getname(const char * filename, char **result);
 358 extern void putname(char * name);
 359 
 360 extern int register_blkdev(unsigned int, const char *, struct file_operations *);
 361 extern int unregister_blkdev(unsigned int major, const char * name);
 362 extern int blkdev_open(struct inode * inode, struct file * filp);
 363 extern struct file_operations def_blk_fops;
 364 extern struct inode_operations blkdev_inode_operations;
 365 
 366 extern int register_chrdev(unsigned int, const char *, struct file_operations *);
 367 extern int unregister_chrdev(unsigned int major, const char * name);
 368 extern int chrdev_open(struct inode * inode, struct file * filp);
 369 extern struct file_operations def_chr_fops;
 370 extern struct inode_operations chrdev_inode_operations;
 371 
 372 extern void init_fifo(struct inode * inode);
 373 
 374 extern struct file_operations connecting_fifo_fops;
 375 extern struct file_operations read_fifo_fops;
 376 extern struct file_operations write_fifo_fops;
 377 extern struct file_operations rdwr_fifo_fops;
 378 extern struct file_operations read_pipe_fops;
 379 extern struct file_operations write_pipe_fops;
 380 extern struct file_operations rdwr_pipe_fops;
 381 
 382 extern struct file_system_type *get_fs_type(char *name);
 383 
 384 extern int fs_may_mount(dev_t dev);
 385 extern int fs_may_umount(dev_t dev, struct inode * mount_root);
 386 extern int fs_may_remount_ro(dev_t dev);
 387 
 388 extern struct file *first_file;
 389 extern int nr_files;
 390 extern struct super_block super_blocks[NR_SUPER];
 391 
 392 extern int shrink_buffers(unsigned int priority);
 393 extern void refile_buffer(struct buffer_head * buf);
 394 extern void set_writetime(struct buffer_head * buf, int flag);
 395 extern void refill_freelist(int size);
 396 
 397 extern struct buffer_head ** buffer_pages;
 398 extern int nr_buffers;
 399 extern int buffermem;
 400 extern int nr_buffer_heads;
 401 
 402 #define BUF_CLEAN 0
 403 #define BUF_UNSHARED 1 /* Buffers that were shared but are not any more */
 404 #define BUF_LOCKED 2   /* Buffers scheduled for write */
 405 #define BUF_LOCKED1 3  /* Supers, inodes */
 406 #define BUF_DIRTY 4    /* Dirty buffers, not yet scheduled for write */
 407 #define BUF_SHARED 5   /* Buffers shared */
 408 #define NR_LIST 6
 409 
 410 extern inline void mark_buffer_clean(struct buffer_head * bh)
     /*  */
 411 {
 412   if(bh->b_dirt) {
 413     bh->b_dirt = 0;
 414     if(bh->b_list == BUF_DIRTY) refile_buffer(bh);
 415   }
 416 }
 417 
 418 extern inline void mark_buffer_dirty(struct buffer_head * bh, int flag)
     /*  */
 419 {
 420   if(!bh->b_dirt) {
 421     bh->b_dirt = 1;
 422     set_writetime(bh, flag);
 423     if(bh->b_list != BUF_DIRTY) refile_buffer(bh);
 424   }
 425 }
 426 
 427 
 428 extern int check_disk_change(dev_t dev);
 429 extern void invalidate_inodes(dev_t dev);
 430 extern void invalidate_buffers(dev_t dev);
 431 extern int floppy_is_wp(int minor);
 432 extern void sync_inodes(dev_t dev);
 433 extern void sync_dev(dev_t dev);
 434 extern int fsync_dev(dev_t dev);
 435 extern void sync_supers(dev_t dev);
 436 extern int bmap(struct inode * inode,int block);
 437 extern int notify_change(int flags, struct inode * inode);
 438 extern int namei(const char * pathname, struct inode ** res_inode);
 439 extern int lnamei(const char * pathname, struct inode ** res_inode);
 440 extern int permission(struct inode * inode,int mask);
 441 extern int open_namei(const char * pathname, int flag, int mode,
 442         struct inode ** res_inode, struct inode * base);
 443 extern int do_mknod(const char * filename, int mode, dev_t dev);
 444 extern void iput(struct inode * inode);
 445 extern struct inode * __iget(struct super_block * sb,int nr,int crsmnt);
 446 extern struct inode * get_empty_inode(void);
 447 extern void insert_inode_hash(struct inode *);
 448 extern void clear_inode(struct inode *);
 449 extern struct inode * get_pipe_inode(void);
 450 extern struct file * get_empty_filp(void);
 451 extern struct buffer_head * get_hash_table(dev_t dev, int block, int size);
 452 extern struct buffer_head * getblk(dev_t dev, int block, int size);
 453 extern void ll_rw_block(int rw, int nr, struct buffer_head * bh[]);
 454 extern void ll_rw_page(int rw, int dev, int nr, char * buffer);
 455 extern void ll_rw_swap_file(int rw, int dev, unsigned int *b, int nb, char *buffer);
 456 extern int is_read_only(int dev);
 457 extern void brelse(struct buffer_head * buf);
 458 extern void set_blocksize(dev_t dev, int size);
 459 extern struct buffer_head * bread(dev_t dev, int block, int size);
 460 extern unsigned long bread_page(unsigned long addr,dev_t dev,int b[],int size,int no_share);
 461 extern struct buffer_head * breada(dev_t dev,int block, int size, 
 462                                    unsigned int pos, unsigned int filesize);
 463 extern void put_super(dev_t dev);
 464 unsigned long generate_cluster(dev_t dev, int b[], int size);
 465 extern dev_t ROOT_DEV;
 466 
 467 extern void show_buffers(void);
 468 extern void mount_root(void);
 469 
 470 extern int char_read(struct inode *, struct file *, char *, int);
 471 extern int block_read(struct inode *, struct file *, char *, int);
 472 extern int read_ahead[];
 473 
 474 extern int char_write(struct inode *, struct file *, char *, int);
 475 extern int block_write(struct inode *, struct file *, char *, int);
 476 
 477 extern int generic_mmap(struct inode *, struct file *, struct vm_area_struct *);
 478 
 479 extern int block_fsync(struct inode *, struct file *);
 480 extern int file_fsync(struct inode *, struct file *);
 481 
 482 extern void dcache_add(struct inode *, const char *, int, unsigned long);
 483 extern int dcache_lookup(struct inode *, const char *, int, unsigned long *);
 484 
 485 extern inline struct inode * iget(struct super_block * sb,int nr)
     /*  */
 486 {
 487         return __iget(sb,nr,1);
 488 }
 489 
 490 #endif /* __KERNEL__ */
 491 
 492 #endif

/* */