割り込みの後半部、ファイルシステム

$ grep cd /etc/auto.misc 
cd              -fstype=iso9660,ro,nosuid,nodev :/dev/cdrom
$ 

◆stat()システム・コールとstatコマンド

STAT(2)                    Linux Programmer's Manual                   STAT(2)
...
       int stat(const char *path, struct stat *buf);
...
          struct stat {
              dev_t     st_dev;     /* ID of device containing file */
              ino_t     st_ino;     /* inode number */
              mode_t    st_mode;    /* protection */
              nlink_t   st_nlink;   /* number of hard links */
              uid_t     st_uid;     /* user ID of owner */
              gid_t     st_gid;     /* group ID of owner */
              dev_t     st_rdev;    /* device ID (if special file) */
              off_t     st_size;    /* total size, in bytes */
              blksize_t st_blksize; /* blocksize for filesystem I/O */
              blkcnt_t  st_blocks;  /* number of blocks allocated */
              time_t    st_atime;   /* time of last access */
              time_t    st_mtime;   /* time of last modification */
              time_t    st_ctime;   /* time of last status change */
          };

$ stat .bashrc 
  File: .bashrc
  Size: 181       	Blocks: 9          IO Block: 1048576 regular file
Device: 38h/56d	Inode: 28759903    Links: 1
Access: (0644/-rw-r--r--)  Uid: ( 1013/     yas)   Gid: ( 5510/    prof)
Access: 2026-02-01 22:12:30.143693000 +0900
Modify: 2025-05-16 14:42:05.705198901 +0900
Change: 2025-05-16 14:42:05.705198901 +0900
 Birth: -
$ 

■VFSのオブジェクト

• struct file, struct file_operations: 開いたファイル。シーク・ポイ ンタは別。
• struct dentry, struct dentry_operations: directory entry。ファイル の名前。
• struct inode, struct inode_operations: ファイル。開いていないもの も含む。
• struct super_block, struct super_operations: スーパーブロック（マ ウントされたファイルシステム）

図? スーパーブロック、inode、dentry、file

◆struct file

    int fd1 = open("file1",O_RDONLY);
    int fd2 = open("file1",O_RDONLY);

ディスク上には対応するデータ構造は存在しない。

linux-6.18.2/include/linux/fs.h
1211:	struct file {
...
1213:	        fmode_t                         f_mode;
1214:	        const struct file_operations    *f_op;
1215:	        struct address_space            *f_mapping;
1216:	        void                            *private_data;
1217:	        struct inode                    *f_inode;
...
1224:	                const struct path       f_path;
...
1233:	        loff_t                          f_pos;
...
1249:	        file_ref_t                      f_ref;
...
1251:	} __randomize_layout
1252:	  __attribute__((aligned(4)));  /* lest something weird decides that 2 is OK */

linux-6.18.2/include/linux/path.h
   8:	struct path {
   9:	        struct vfsmount *mnt;
  10:	        struct dentry *dentry;
  11:	} __randomize_layout;

• f_path.dentry: 対応する dentry オブジェクトへのポインタ。
• f_mode: open() システム・コールのモードを少し変形したもの。 FMODE_READ, FMODE_WRITE 等。
• f_pos: ファイルを読み書きする位置。シークポインタ。
• f_ref: 参照カウンタ。ファイルを開くと増える。fork() すると 増える。 close() すると減る。
• f_mapping: ファイルの内容をプロセスのアドレス空間にマップする時に 使う(ページキャッシュ)。
• private_data: ファイルシステムに固有のデータを保存する。 （継承、委譲の一実装方法。構造体を拡張する方法もある。）

◆継承・委譲の実装方法

図? 方法１

図? 方法２

図? 方法３

◆struct file_operations

struct fileの操作は、たとえば次のような形で行われる。 第1引数は、struct file *。

    struct file *file;
    file->f_op->read(file, buf, count, pos);

再掲

linux-6.18.2/include/linux/fs.h
2268:	struct file_operations {
2269:	        struct module *owner;
2270:	        fop_flags_t fop_flags;
2271:	        loff_t (*llseek) (struct file *, loff_t, int);
2272:	        ssize_t (*read) (struct file *, char __user *, size_t, loff_t *);
2273:	        ssize_t (*write) (struct file *, const char __user *, size_t, loff_t *);
2274:	        ssize_t (*read_iter) (struct kiocb *, struct iov_iter *);
2275:	        ssize_t (*write_iter) (struct kiocb *, struct iov_iter *);
2276:	        int (*iopoll)(struct kiocb *kiocb, struct io_comp_batch *,
2277:	                        unsigned int flags);
2278:	        int (*iterate_shared) (struct file *, struct dir_context *);
2279:	        __poll_t (*poll) (struct file *, struct poll_table_struct *);
2280:	        long (*unlocked_ioctl) (struct file *, unsigned int, unsigned long);
2281:	        long (*compat_ioctl) (struct file *, unsigned int, unsigned long);
2282:	        int (*mmap) (struct file *, struct vm_area_struct *);
2283:	        int (*open) (struct inode *, struct file *);
2284:	        int (*flush) (struct file *, fl_owner_t id);
2285:	        int (*release) (struct inode *, struct file *);
2286:	        int (*fsync) (struct file *, loff_t, loff_t, int datasync);
2287:	        int (*fasync) (int, struct file *, int);
2288:	        int (*lock) (struct file *, int, struct file_lock *);
2289:	        unsigned long (*get_unmapped_area)(struct file *, unsigned long, unsigned long, unsigned long, unsigned long);
2290:	        int (*check_flags)(int);
2291:	        int (*flock) (struct file *, int, struct file_lock *);
2292:	        ssize_t (*splice_write)(struct pipe_inode_info *, struct file *, loff_t *, size_t, unsigned int);
2293:	        ssize_t (*splice_read)(struct file *, loff_t *, struct pipe_inode_info *, size_t, unsigned int);
2294:	        void (*splice_eof)(struct file *file);
2295:	        int (*setlease)(struct file *, int, struct file_lease **, void **);
2296:	        long (*fallocate)(struct file *file, int mode, loff_t offset,
2297:	                          loff_t len);
2298:	        void (*show_fdinfo)(struct seq_file *m, struct file *f);
2299:	#ifndef CONFIG_MMU
2300:	        unsigned (*mmap_capabilities)(struct file *);
2301:	#endif
2302:	        ssize_t (*copy_file_range)(struct file *, loff_t, struct file *,
2303:	                        loff_t, size_t, unsigned int);
2304:	        loff_t (*remap_file_range)(struct file *file_in, loff_t pos_in,
2305:	                                   struct file *file_out, loff_t pos_out,
2306:	                                   loff_t len, unsigned int remap_flags);
2307:	        int (*fadvise)(struct file *, loff_t, loff_t, int);
2308:	        int (*uring_cmd)(struct io_uring_cmd *ioucmd, unsigned int issue_flags);
2309:	        int (*uring_cmd_iopoll)(struct io_uring_cmd *, struct io_comp_batch *,
2310:	                                unsigned int poll_flags);
2311:	        int (*mmap_prepare)(struct vm_area_desc *);
2312:	} __randomize_layout;

• 多くは同名のシステム・コールを実装するために使われる。

◆struct dentry (directory entry)

linux-6.18.2/include/linux/dcache.h
  90:	#define d_iname d_shortname.string

  92:	struct dentry {
...
  97:	        struct dentry *d_parent;        /* parent directory */
...
 100:	        const struct qstr d_name;
...
 102:	        struct inode *d_inode;          /* Where the name belongs to - NULL is
 103:	                                         * negative */
 104:	        union shortname_store d_shortname;
...
 108:	        const struct dentry_operations *d_op;
 109:	        struct super_block *d_sb;       /* The root of the dentry tree */
...
 111:	        void *d_fsdata;                 /* fs-specific data */
...
 113:	        struct lockref d_lockref;       /* per-dentry lock and refcount
 114:	                                         * keep separate from RCU lookup area if
 115:	                                         * possible!
 116:	                                         */
...
 122:	        struct hlist_node d_sib;        /* child of parent list */
 123:	        struct hlist_head d_children;   /* our children */
...
 128:	                struct hlist_node d_alias;      /* inode alias list */
...
 132:	};

 291:	static inline unsigned d_count(const struct dentry *dentry)
 292:	{
 293:	        return dentry->d_lockref.count;
 294:	}

  35:	 #define HASH_LEN_DECLARE u32 hash; u32 len

  49:	struct qstr {
  50:	        union {
  51:	                struct {
  52:	                        HASH_LEN_DECLARE;
  53:	                };
  54:	                u64 hash_len;
  55:	        };
  56:	        const unsigned char *name;
  57:	};

  84:	union shortname_store {
  85:	        unsigned char string[DNAME_INLINE_LEN];
  86:	        unsigned long words[DNAME_INLINE_WORDS];
  87:	};

  73:	# define DNAME_INLINE_WORDS 5 /* 192 bytes */
  82:	#define DNAME_INLINE_LEN (DNAME_INLINE_WORDS*sizeof(unsigned long))

• d_inode: この dentry に対応している inode 。NULL なら対応している ものがない(ネガティブキャッシュ)。
• d_name, d_shortname: 文字列の名前を保持する。 短いもの(DNAME_INLINE_LEN-1以下)は、dentry 構造体中の d_shortname に入れる。長いものは、 別の場所にメモリを確保して保存する。
• d_lockref.count: 参照カウンタ。
• d_op: dentry を操作するための手続き。
• d_sb: superblock へのポインタ
• d_parent: その dentry を含んでいるディレクトリの dentry 。たとえば、 /home/yas というパス名で、yas の d_parent は、home の dentry を指す。 home の dentry は、/ の dentry を指す。
• d_sib: 共通の d_parent に含まれている d_entry をつなぐ。shilling 。
• d_children: 自分がディレクトリの場合、子供の要素の先頭。
• d_fsdata: ファイルシステム固有のデータ。
• d_alias: 同じ inode を複数の dentry で指している時にそれらをつなぐために使う。

◆dentryの状態

• 使用中: count が 1 以上。有効なinodeを保持。
• 空き: count が 0。有効なinodeを保持。キャッシュとしてメモリ中に存在する。 同じファイルを再び open() した時に高速。 メモリが不足してきたら消されることがある>
• ネガティブ・キャッシュ: count が負。有効な inode を保持していない。 ファイルが削除されたか、存在しないファイルを open() しようとした時にそ のような dentry が作られる。 存在しないファイルを繰り返し open() した時にディスクに行かなくてもエラー ENOENT が返せる(ネガティブ・キャッシュ)。

◆struct inode

linux-6.18.2/include/linux/fs.h
 793:	struct inode {
 794:	        umode_t                 i_mode;
 795:	        unsigned short          i_opflags;
 796:	        kuid_t                  i_uid;
 797:	        kgid_t                  i_gid;
...
 805:	        const struct inode_operations   *i_op;
 806:	        struct super_block      *i_sb;
...
 814:	        unsigned long           i_ino;
...
 823:	                const unsigned int i_nlink;
...
 826:	        dev_t                   i_rdev;
 827:	        loff_t                  i_size;
 828:	        time64_t                i_atime_sec;
 829:	        time64_t                i_mtime_sec;
 830:	        time64_t                i_ctime_sec;
 831:	        u32                     i_atime_nsec;
 832:	        u32                     i_mtime_nsec;
 833:	        u32                     i_ctime_nsec;
 834:	        u32                     i_generation;
 835:	        spinlock_t              i_lock; /* i_blocks, i_bytes, maybe i_size */
 836:	        unsigned short          i_bytes;
 837:	        u8                      i_blkbits;
 838:	        enum rw_hint            i_write_hint;
 839:	        blkcnt_t                i_blocks;
...
 853:	        struct hlist_node       i_hash;
...
 867:	                struct hlist_head       i_dentry;
...
 902:	        void                    *i_private; /* fs or device private pointer */
 903:	} __randomize_layout;

• i_ino: inode番号。ファイルシステムでユニーク。
• i_uid, i_gid, i_nlink, i_uid, i_gid, i_rdev, i_blkbits, i_size, i_atime_{sec,nsec}, i_mtime_{sec,nsec}, i_ctime_{sec,nsec}, i_blocks, i_bytes, i_mode: 属性。stat() システム・コー ルで返される。ls -l で表示される。
• i_op: そのinodeに固有の手続きのリスト。後述
• i_sb: 属しているファイルシステムの superblock へのポインタ。
• i_state: inodeの状態(dirty かどうか、ディスクへの 書き込みを行っているかどうか、等)を表す。
• i_hash: ファイルを開くことの高速のためのハッシュ表を作るためのフィー ルド。　
• i_dentry: そのinodeを含んでいる dentry 構造体のリスト。
• i_count: 参照カウンタ。0 が未使用の意味。

◆struct inode_operations

    struct inode *inode;
    ...
    inode->i_op->create(idmap, inode, name, mode, true);

linux-6.18.2/include/linux/fs.h
2338:	struct inode_operations {
2339:	        struct dentry * (*lookup) (struct inode *,struct dentry *, unsigned int);
2340:	        const char * (*get_link) (struct dentry *, struct inode *, struct delayed_call *);
2341:	        int (*permission) (struct mnt_idmap *, struct inode *, int);
2342:	        struct posix_acl * (*get_inode_acl)(struct inode *, int, bool);
2343:	
2344:	        int (*readlink) (struct dentry *, char __user *,int);
2345:	
2346:	        int (*create) (struct mnt_idmap *, struct inode *,struct dentry *,
2347:	                       umode_t, bool);
2348:	        int (*link) (struct dentry *,struct inode *,struct dentry *);
2349:	        int (*unlink) (struct inode *,struct dentry *);
2350:	        int (*symlink) (struct mnt_idmap *, struct inode *,struct dentry *,
2351:	                        const char *);
2352:	        struct dentry *(*mkdir) (struct mnt_idmap *, struct inode *,
2353:	                                 struct dentry *, umode_t);
2354:	        int (*rmdir) (struct inode *,struct dentry *);
2355:	        int (*mknod) (struct mnt_idmap *, struct inode *,struct dentry *,
2356:	                      umode_t,dev_t);
2357:	        int (*rename) (struct mnt_idmap *, struct inode *, struct dentry *,
2358:	                        struct inode *, struct dentry *, unsigned int);
2359:	        int (*setattr) (struct mnt_idmap *, struct dentry *, struct iattr *);
2360:	        int (*getattr) (struct mnt_idmap *, const struct path *,
2361:	                        struct kstat *, u32, unsigned int);
2362:	        ssize_t (*listxattr) (struct dentry *, char *, size_t);
2363:	        int (*fiemap)(struct inode *, struct fiemap_extent_info *, u64 start,
2364:	                      u64 len);
2365:	        int (*update_time)(struct inode *, int);
2366:	        int (*atomic_open)(struct inode *, struct dentry *,
2367:	                           struct file *, unsigned open_flag,
2368:	                           umode_t create_mode);
2369:	        int (*tmpfile) (struct mnt_idmap *, struct inode *,
2370:	                        struct file *, umode_t);
2371:	        struct posix_acl *(*get_acl)(struct mnt_idmap *, struct dentry *,
2372:	                                     int);
2373:	        int (*set_acl)(struct mnt_idmap *, struct dentry *,
2374:	                       struct posix_acl *, int);
2375:	        int (*fileattr_set)(struct mnt_idmap *idmap,
2376:	                            struct dentry *dentry, struct file_kattr *fa);
2377:	        int (*fileattr_get)(struct dentry *dentry, struct file_kattr *fa);
2378:	        struct offset_ctx *(*get_offset_ctx)(struct inode *inode);
2379:	} ____cacheline_aligned;

• 多くのものは、同名のシステム・コールと関連している。
• 引数によく現れる struct mnt_idmap * の中身は、名前空間を表す構造 体 struct user_namespace * (と参照カウンタ)。名前空間が別だと、ルート ディレクトリを別に持てる。
• create(): open() システム・コールや creat() システム・コールで、ファ イルを作成する時に呼ばれる。引数は、ディレクトリの inode、そのディレク トリの中の名前を示す dentry、名前解決で使うデータ。
• lookup(): ファイル名を引数にするシステム・コールの実装で、 既存のファイルを探すのに使う。 存在しない時には、空の inode (ネガティブキャッシュ)が作られる。 存在しないファイルを繰り返し open() した時にすぐにエラーになる。
• get_link(): シンボリック・リンクをたどる操作で用いる。
• permission(), get_acl(), set_acl(): アクセス権のチェックで用いる。
• kstat, iattr, fileattr は属性。

◆struct super_block

linux-6.18.2/include/linux/fs.h
1445:	struct super_block {
1446:	        struct list_head        s_list;         /* Keep this first */
...
1450:	        loff_t                  s_maxbytes;     /* Max file size */
...
1452:	        const struct super_operations   *s_op;
...
1459:	        struct dentry           *s_root;
...
1495:	        void                    *s_fs_info;     /* Filesystem private info */
...
1568:	        struct list_lru         s_dentry_lru;
1569:	        struct list_lru         s_inode_lru;
...
1582:	        struct list_head        s_inodes;       /* all inodes */
...
1586:	} __randomize_layout;

• s_list: 構造体 struct super_block のリストを作るためのフィールド。
• s_maxbytes: 作成できるファイルの大きさの最大。
• s_op: ファイルシステム固有の手続きのリスト。後述
• s_fs_info: ファイルシステムのインスタンス（マウントごとに異なる） に固有のデータ。インスタンス変数。
• s_root: どこにマウントしているかをしめすディレクトリ
• s_inodes, s_dentry_lru, s_inode_lru: ファイルシステムに含まれてい るinode や dentry を管理するためのフィールド。

◆struct super_operations

    struct super_block *sh;
    ...
    sh->s_op->write_super(sb);

linux-6.18.2/include/linux/fs.h
2456:	struct super_operations {
2457:	        struct inode *(*alloc_inode)(struct super_block *sb);
2458:	        void (*destroy_inode)(struct inode *);
2459:	        void (*free_inode)(struct inode *);
2460:	
2461:	        void (*dirty_inode) (struct inode *, int flags);
2462:	        int (*write_inode) (struct inode *, struct writeback_control *wbc);
2463:	        int (*drop_inode) (struct inode *);
2464:	        void (*evict_inode) (struct inode *);
2465:	        void (*put_super) (struct super_block *);
2466:	        int (*sync_fs)(struct super_block *sb, int wait);
2467:	        int (*freeze_super) (struct super_block *, enum freeze_holder who, const void *owner);
2468:	        int (*freeze_fs) (struct super_block *);
2469:	        int (*thaw_super) (struct super_block *, enum freeze_holder who, const void *owner);
2470:	        int (*unfreeze_fs) (struct super_block *);
2471:	        int (*statfs) (struct dentry *, struct kstatfs *);
2472:	        int (*remount_fs) (struct super_block *, int *, char *);
2473:	        void (*umount_begin) (struct super_block *);
2474:	
2475:	        int (*show_options)(struct seq_file *, struct dentry *);
2476:	        int (*show_devname)(struct seq_file *, struct dentry *);
2477:	        int (*show_path)(struct seq_file *, struct dentry *);
2478:	        int (*show_stats)(struct seq_file *, struct dentry *);
2479:	#ifdef CONFIG_QUOTA
2480:	        ssize_t (*quota_read)(struct super_block *, int, char *, size_t, loff_t);
2481:	        ssize_t (*quota_write)(struct super_block *, int, const char *, size_t, loff_t);
2482:	        struct dquot __rcu **(*get_dquots)(struct inode *);
2483:	#endif
2484:	        long (*nr_cached_objects)(struct super_block *,
2485:	                                  struct shrink_control *);
2486:	        long (*free_cached_objects)(struct super_block *,
2487:	                                    struct shrink_control *);
2488:	        /*
2489:	         * If a filesystem can support graceful removal of a device and
2490:	         * continue read-write operations, implement this callback.
2491:	         *
2492:	         * Return 0 if the filesystem can continue read-write.
2493:	         * Non-zero return value or no such callback means the fs will be shutdown
2494:	         * as usual.
2495:	         */
2496:	        int (*remove_bdev)(struct super_block *sb, struct block_device *bdev);
2497:	        void (*shutdown)(struct super_block *sb);
2498:	};

• alloc_inode: そのファイルシステム内に inode 構造体を確保する。
• destroy_inode: メモリ中の inode 構造体を free する。
• dirty_inode: inode が dirty である(データの変更を行った)ことを伝える。
• write_inode: inode をディスクへ書く。
• put_super: マウントを解除(アンマウント)の時に、その構造体が参照さ れなくなったことを通知する。
• sync_fs: 更新されたスーパーブロックをディスクへ書き出す。
• freeze_fs, unfreeze_fs: ファイルシステムの変更を一時的に禁止する／ 禁止を解除する。LVM (Logical Volume Manager) で使う。
• statfs: 統計情報(空き容量、inode数等)を返す。
• remount_fs: マウントしなおす（オプションを変更する。例: ro (read-only)からrw (read-write) へ。）

◆task_struct と struct file

linux-6.18.2/include/linux/sched.h
 819:	struct task_struct {
...
1189:	        struct files_struct             *files;
...
1668:	} __attribute__ ((aligned (64)));

linux-6.18.2/include/linux/fdtable.h
  24:	#define NR_OPEN_DEFAULT BITS_PER_LONG

  38:	struct files_struct {
...
  46:	        struct fdtable __rcu *fdt;
  47:	        struct fdtable fdtab;
...
  56:	        struct file __rcu * fd_array[NR_OPEN_DEFAULT];
  57:	};

  26:	struct fdtable {
...
  28:	        struct file __rcu **fd;      /* current fd array */
...
  33:	};

linux-6.18.2/include/asm-generic/bitsperlong.h
   8:	#ifdef CONFIG_64BIT
   9:	#define BITS_PER_LONG 64
  10:	#else
  11:	#define BITS_PER_LONG 32
  12:	#endif /* CONFIG_64BIT */

図? task_struct、ファイル記述子、file構造体、その他

■read() システムコールと Ext4 ファイルシステム

◆read() システム・コール

linux-6.18.2/fs/read_write.c
 722:	SYSCALL_DEFINE3(read, unsigned int, fd, char __user *, buf, size_t, count)
 723:	{
 724:	        return ksys_read(fd, buf, count);
 725:	}

 704:	ssize_t ksys_read(unsigned int fd, char __user *buf, size_t count)
 705:	{
 706:	        CLASS(fd_pos, f)(fd);
 707:	        ssize_t ret = -EBADF;
 708:	
 709:	        if (!fd_empty(f)) {
 710:	                loff_t pos, *ppos = file_ppos(fd_file(f));
 711:	                if (ppos) {
 712:	                        pos = *ppos;
 713:	                        ppos = &pos;
 714:	                }
 715:	                ret = vfs_read(fd_file(f), buf, count, ppos);
 716:	                if (ret >= 0 && ppos)
 717:	                        fd_file(f)->f_pos = pos;
 718:	        }
 719:	        return ret;
 720:	}

linux-6.18.2/include/linux/file.h
  38:	struct fd {
  39:	        unsigned long word;
  40:	};

  44:	#define fd_file(f) ((struct file *)((f).word & ~(FDPUT_FPUT|FDPUT_POS_UNLOCK)))

linux-6.18.2/fs/read_write.c
 699:	static inline loff_t *file_ppos(struct file *file)
 700:	{
 701:	        return file->f_mode & FMODE_STREAM ? NULL : &file->f_pos;
 702:	}

• fdget_pos() で、fd (int型) から struct file * を含む struct fd へ変換する。 内部的には、current->files->fd_array[fd] とだいたい同じ。 さらに、pos を操作するためのロックも取得している。
• file_ppos() で、現在の読み書きする位置 pos へのポインタを得、さらに、その 内容をローカル変数に pos にコピーする。
• vfs_read() という VFS 層の手続きを呼び出して、実際にデータを読み込む。
• struct file の中にある pos を更新する。
• fdput_pos() で、pos を操作するためのロックを開放している。

◆vfs_read()

linux-6.18.2/fs/read_write.c
 552:	ssize_t vfs_read(struct file *file, char __user *buf, size_t count, loff_t *pos)
 553:	{
 554:	        ssize_t ret;
 555:	
 556:	        if (!(file->f_mode & FMODE_READ))
 557:	                return -EBADF;
 558:	        if (!(file->f_mode & FMODE_CAN_READ))
 559:	                return -EINVAL;
 560:	        if (unlikely(!access_ok(buf, count)))
 561:	                return -EFAULT;
 562:	
 563:	        ret = rw_verify_area(READ, file, pos, count);
 564:	        if (ret)
 565:	                return ret;
 566:	        if (count > MAX_RW_COUNT)
 567:	                count =  MAX_RW_COUNT;
 568:	
 569:	        if (file->f_op->read)
 570:	                ret = file->f_op->read(file, buf, count, pos);
 571:	        else if (file->f_op->read_iter)
 572:	                ret = new_sync_read(file, buf, count, pos);
 573:	        else
 574:	                ret = -EINVAL;
 575:	        if (ret > 0) {
 576:	                fsnotify_access(file);
 577:	                add_rchar(current, ret);
 578:	        }
 579:	        inc_syscr(current);
 580:	        return ret;
 581:	}

 481:	static ssize_t new_sync_read(struct file *filp, char __user *buf, size_t len, loff_t *ppos)
 482:	{
 483:	        struct kiocb kiocb;
 484:	        struct iov_iter iter;
 485:	        ssize_t ret;
 486:	
 487:	        init_sync_kiocb(&kiocb, filp);
 488:	        kiocb.ki_pos = (ppos ? *ppos : 0);
 489:	        iov_iter_ubuf(&iter, ITER_DEST, buf, len);
 490:	
 491:	        ret = filp->f_op->read_iter(&kiocb, &iter);
 492:	        BUG_ON(ret == -EIOCBQUEUED);
 493:	        if (ppos)
 494:	                *ppos = kiocb.ki_pos;
 495:	        return ret;
 496:	}

• file->f_modeを調べ、 ファイルが読み出しで open() されていなけければ()、エラー。
• access_ok() で、結果を保存するメモリ(buf, count)が書き込みできない とエラー。ファイルからすると、read() だが、メモリからすると書き込み。
• rw_verify_area() で、ファイルのその場所(posからpos+countまで)が存 在するかを確認する。
• file構造体の操作で file->f_op->read といった手続きが存在すれば、それを呼び出す。
• file構造体の操作で file->f_op->read_iter といった手続きが存在すれば、new_sync_read() を呼び出す。
• new_sync_read() は、file->f_op->read_iter() を呼ぶ。

◆Ext4 の file_operations

linux-6.18.2/fs/ext4/file.c
 963:	const struct file_operations ext4_file_operations = {
 964:	        .llseek         = ext4_llseek,
 965:	        .read_iter      = ext4_file_read_iter,
 966:	        .write_iter     = ext4_file_write_iter,
 967:	        .iopoll         = iocb_bio_iopoll,
 968:	        .unlocked_ioctl = ext4_ioctl,
 969:	#ifdef CONFIG_COMPAT
 970:	        .compat_ioctl   = ext4_compat_ioctl,
 971:	#endif
 972:	        .mmap_prepare   = ext4_file_mmap_prepare,
 973:	        .open           = ext4_file_open,
 974:	        .release        = ext4_release_file,
 975:	        .fsync          = ext4_sync_file,
 976:	        .get_unmapped_area = thp_get_unmapped_area,
 977:	        .splice_read    = ext4_file_splice_read,
 978:	        .splice_write   = iter_file_splice_write,
 979:	        .fallocate      = ext4_fallocate,
 980:	        .fop_flags      = FOP_MMAP_SYNC | FOP_BUFFER_RASYNC |
 981:	                          FOP_DIO_PARALLEL_WRITE |
 982:	                          FOP_DONTCACHE,
 983:	};
 984:	
 985:	const struct inode_operations ext4_file_inode_operations = {
 986:	        .setattr        = ext4_setattr,
 987:	        .getattr        = ext4_file_getattr,
...
 994:	};

linux-6.18.2/fs/ext4/super.c
1624:	static const struct super_operations ext4_sops = {
1625:	        .alloc_inode    = ext4_alloc_inode,
1626:	        .free_inode     = ext4_free_in_core_inode,
...
1644:	};

• file_operations 構造体の関数のうち、14 個を定義している。
• 主な操作は、read_iter, write_iter, ioctl, mmap, open, release, llseek, fsync。
• inode の操作、ext4_file_inode_operations もある。
• スーパーブロックの操作、ext4_sops もある。
• dentry の操作で特別な操作を行うための struct dentry_operations は、 ext4 では定義されていない。　

◆Ext4 の inode

linux-6.18.2/fs/ext4/ext4.h
1023:	struct ext4_inode_info {
...
1114:	        struct inode vfs_inode;
...
1193:	};

1789:	static inline struct ext4_inode_info *EXT4_I(struct inode *inode)
1790:	{
1791:	        return container_of(inode, struct ext4_inode_info, vfs_inode);
1792:	}

• Ext4 独自の構造体 struct ext4_inode_info の内部には、Linux 標準の struct inode がある。
• 標準の struct inode から Ext4 独自の struct ext4_inode_info を取り出すには、 EXT4_I() を用いる。
• EXT4_I() は、 container_of() マクロを使っている。
• container_of() は、当該メンバのオフセットを引き算して、外側の構造 体の番地を求めている。

図? Ext4 ファイルシステムで使う構造体 ext4_inode_info での struct inode の保持

◆Ext4のext4_file_read_iter()

linux-6.18.2/fs/ext4/file.c
 130:	static ssize_t ext4_file_read_iter(struct kiocb *iocb, struct iov_iter *to)
 131:	{
...
 147:	        return generic_file_read_iter(iocb, to);
 148:	}

• ファイルの読み出しは、filp->f_op->read_iter() で実装されている。
• Ext4 では、read_iter() は、ext4_file_operations で定義されているように、 ext4_file_read_iter()。
• これは、Ext4 固有の処理が少しあるが、大部分の処理は 汎用の generic_file_read_iter() を呼んで実装している。

◆汎用のgeneric_file_read_iter()

linux-6.18.2/mm/filemap.c
2898:	ssize_t
2899:	generic_file_read_iter(struct kiocb *iocb, struct iov_iter *iter)
2900:	{
...
2940:	        return filemap_read(iocb, iter, retval);
2941:	}

• generic_file_read_iter() は、普通、generic_file_buffered_read() を呼ぶ。
• ファイルの入出力とメモリ管理が統合されている。入出力の実装は、mm/ 以下にあるファイルで実装されている。

◆汎用のfilemap_read()

linux-6.18.2/include/linux/mm_types.h
 375:	struct folio {
...
 419:	                struct page page;
...
 480:	};

linux-6.18.2/include/linux/pagevec.h
  28:	struct folio_batch {
  29:	        unsigned char nr;
  30:	        bool percpu_pvec_drained;
  31:	        struct folio *folios[PAGEVEC_SIZE];
  32:	};

linux-6.18.2/mm/filemap.c
2711:	ssize_t filemap_read(struct kiocb *iocb, struct iov_iter *iter,
2712:	                ssize_t already_read)
2713:	{
2714:	        struct file *filp = iocb->ki_filp;
2715:	        struct file_ra_state *ra = &filp->f_ra;
2716:	        struct address_space *mapping = filp->f_mapping;
2717:	        struct inode *inode = mapping->host;
2718:	        struct folio_batch fbatch;
2719:	        int i, error = 0;
2720:	        bool writably_mapped;
2721:	        loff_t isize, end_offset;
2722:	        loff_t last_pos = ra->prev_pos;
...
2732:	        folio_batch_init(&fbatch);
...
2734:	        do {
...
2748:	                error = filemap_get_pages(iocb, iter->count, &fbatch, false);
...
2779:	                for (i = 0; i < folio_batch_count(&fbatch); i++) {
2780:	                        struct folio *folio = fbatch.folios[i];
...
2799:	                        copied = copy_folio_to_iter(folio, offset, bytes, iter);
2800:	
2801:	                        already_read += copied;
2802:	                        iocb->ki_pos += copied;
2803:	                        last_pos = iocb->ki_pos;
...
:	                        }
2809:	                }
...
2818:	        } while (iov_iter_count(iter) && iocb->ki_pos < isize && !error);
...
2822:	        return already_read ? already_read : error;

linux-6.18.2/include/linux/uio.h
 201:	static inline size_t copy_folio_to_iter(struct folio *folio, size_t offset,
 202:	                size_t bytes, struct iov_iter *i)
 203:	{
 204:	        return copy_page_to_iter(&folio->page, offset, bytes, i);
 205:	}

• struct folio は、struct page をまとめたもの。紙の本(folio)が複数のページからなる。
• struct kiocb は、struct file *を含む。
• struct iov_iter は、ユーザ空間のメモリ番地を表す。readv(), writev() システム・コールの struct iovec と関連している。
• filemap_read() は、filemap_get_pages() を呼び、ページ単位で ファイルのブロックを読む。
• filemap_get_pages() は、ファイルのブロックを読み、 struct page *page の配列 (folio_batch) に結果を返す。 struct page *page は、物理ページと 1 対 1 に対応する構造体。 1月15日の 物理メモリの管理 で出てきた。 ここからファイル入出力のページングが統合的に実装されていることがわかる。 filemap_get_pages() は、既に読み込まれているページをかき集める。 まだ読み込まれていなければ、同期読み出しなら、完了までスリープする。 また、シーケンシャル・アクセスなら、ついでに次に読み出されそうなブロックの先読みを指示する。
• for 文の中では、ページ単位でファイルの内容をコピーしている。
• copy_page_to_iter() は、copy_to_user() と同様に、カーネルで管理し ている物理メモリ(struct page *page)からユーザ空間内のメモリ(iter)にコピー する。
• コピーできたら、ファイル中の読み書きする位置 pos や 読み込んだバイト数 already_read を更新する。
• already_read は、最後 read() システム・コールの返り値としても使われる。

■mkdir() システムコール

◆mkdir() システム・コール

linux-6.18.2/fs/namei.c
4506:	SYSCALL_DEFINE2(mkdir, const char __user *, pathname, umode_t, mode)
4507:	{
4508:	        return do_mkdirat(AT_FDCWD, getname(pathname), mode);
4509:	}

4501:	SYSCALL_DEFINE3(mkdirat, int, dfd, const char __user *, pathname, umode_t, mode)
4502:	{
4503:	        return do_mkdirat(dfd, getname(pathname), mode);
4504:	}

4470:	int do_mkdirat(int dfd, struct filename *name, umode_t mode)
4471:	{
4472:	        struct dentry *dentry;
4473:	        struct path path;
4474:	        int error;
4475:	        unsigned int lookup_flags = LOOKUP_DIRECTORY;
4476:	
4477:	retry:
4478:	        dentry = filename_create(dfd, name, &path, lookup_flags);
...
4486:	                dentry = vfs_mkdir(mnt_idmap(path.mnt), path.dentry->d_inode,
4487:	                                  dentry, mode);
...
4496:	out_putname:
4497:	        putname(name);
4498:	        return error;
4499:	}

• namei は、name to inode で、名前から inode を取り出す意味。
• mkdir() システム・コールの実装は、 mkdirat() システム・コールとも共通の do_mkdirat() を呼ぶ。 mkdir() の起点は、カレントワーキングディレクトリ(AT_FDCWD)。 mkdirat() の起点は、ファイル記述子で指定した任意のディレクトリ。
• getname() は、ユーザ空間にあるファイル名を カーネル空間にコピーし、構造体 struct filename に納める。
• do_mkdirat() は、filename_create() で新しく作成するディレクトリの dentry を作る。 この時点では、ファイル名だけが設定された状態になっており、inode は割当てられていない。
• vfs_mkdir() を呼び出す。 引数は、名前空間(を含むstruct mnt_idmap *)、 親ディレクトリの inode、新しく作られるディレクトリの dentry、 新しく作られるディレクトリのパーミッション(rwxrwxrwx)を表す mode (unsigned short)。

◆vfs_mkdir()

linux-6.18.2/fs/namei.c
4429:	struct dentry *vfs_mkdir(struct mnt_idmap *idmap, struct inode *dir,
4430:	                         struct dentry *dentry, umode_t mode)
4431:	{
...
4440:	        error = -EPERM;
4441:	        if (!dir->i_op->mkdir)
4442:	                goto err;
...
4453:	        de = dir->i_op->mkdir(idmap, dir, dentry, mode);
...
4459:	                dentry = de;
...
4462:	        return dentry;
...
4467:	}

4525:	int vfs_rmdir(struct mnt_idmap *idmap, struct inode *dir,
4526:	                     struct dentry *dentry)
4527:	{
...
4533:	        if (!dir->i_op->rmdir)
4534:	                return -EPERM;
...
4548:	        error = dir->i_op->rmdir(dir, dentry);
...
4562:	        return error;
4563:	}

• dir->i_op->mkdir()　という関数が存在しなければエラー。 たとえば、CD-ROM 等 mkdir() できない時は、存在しない。
• dir->i_op->mkdir()　という関数を呼ぶ。
• 同様に vfs_rmdir() は、dir->i_op->rmdir() を呼ぶ。

■授業評価アンケート

アンケートはTwinsから回答してください。

なお、皆さんの評価が成績に影響することは一切ありません。 また、評価結果を教育の改善以外の目的に利用することはありませんし、 評価結果を公開する場合には個人を特定できるような情報は含めません。

2月23日までに回答して下さい。

■課題5 割り込みの後半部、ファイルシステム

★問題(501) Work Queueの初期化

void f(int arg1, int arg2) {
   省略;
}

static struct /*空欄(a)*/ wq1;

void work_queue_handler(struct work_struct *work) { /* Work Queue ハンドラ */
    int arg1, arg2;
    arg1 = 省略; /* f() の引数 */
    arg2 = 省略; /* f() の引数 */
    /*空欄(b)*/
}

初期化
{
	/*空欄(c)*/(&wq1, /*空欄(d)*/);
}

★問題(502) Work Queueハンドラの実行

irqreturn_t irq_handler(int irq, void *dev) {
    /*空欄(e)*/(/*空欄(f)*/);
    return IRQ_HANDLED;
}

★問題(503) struct fileの役割

★問題(504) Ext4ファイルシステム

• read()
• open()

★問題(505) symlink()システムコール

int vfs_symlink(struct mnt_idmap *idmap, struct inode *dir,
                struct dentry *dentry, const char *oldname)
{
        int error;
...
        if (!/*空欄(g)*/->i_op->/*空欄(h)*/)
                return -EPERM;
...
        error = /*空欄(g)*/->i_op->/*空欄(h)*/(idmap, /*空欄(i)*/, /*空欄(j)*/, /*省略*/);
...
        return error;
}

★問題(506) 期末試験とアンケート

• 日付:
• 曜日:
• 開始時刻:
• 持ち込めるもの:

• アンケートに回答した。
• これからアンケートに回答する。
• 回答しない。
• 決めていない。
• その他。