4 * Copyright (C) 1992, 1993, 1994, 1995
5 * Remy Card (card@masi.ibp.fr)
6 * Laboratoire MASI - Institut Blaise Pascal
7 * Universite Pierre et Marie Curie (Paris VI)
11 * linux/fs/minix/dir.c
13 * Copyright (C) 1991, 1992 Linus Torvalds
15 * ext2 directory handling functions
17 * Big-endian to little-endian byte-swapping/bitmaps by
18 * David S. Miller (davem@caip.rutgers.edu), 1995
20 * All code that works with directory layout had been switched to pagecache
25 #include <linux/pagemap.h>
26 #include <linux/smp_lock.h>
28 typedef struct ext2_dir_entry_2 ext2_dirent;
31 * ext2 uses block-sized chunks. Arguably, sector-sized ones would be
32 * more robust, but we have what we have
34 static inline unsigned ext2_chunk_size(struct inode *inode)
36 return inode->i_sb->s_blocksize;
39 static inline void ext2_put_page(struct page *page)
42 page_cache_release(page);
45 static inline unsigned long dir_pages(struct inode *inode)
47 return (inode->i_size+PAGE_CACHE_SIZE-1)>>PAGE_CACHE_SHIFT;
51 * Return the offset into page `page_nr' of the last valid
52 * byte in that page, plus one.
55 ext2_last_byte(struct inode *inode, unsigned long page_nr)
57 unsigned last_byte = inode->i_size;
59 last_byte -= page_nr << PAGE_CACHE_SHIFT;
60 if (last_byte > PAGE_CACHE_SIZE)
61 last_byte = PAGE_CACHE_SIZE;
65 static int ext2_commit_chunk(struct page *page, unsigned from, unsigned to)
67 struct inode *dir = page->mapping->host;
70 page->mapping->a_ops->commit_write(NULL, page, from, to);
72 err = write_one_page(page, 1);
78 static void ext2_check_page(struct page *page)
80 struct inode *dir = page->mapping->host;
81 struct super_block *sb = dir->i_sb;
82 unsigned chunk_size = ext2_chunk_size(dir);
83 char *kaddr = page_address(page);
84 u32 max_inumber = le32_to_cpu(EXT2_SB(sb)->s_es->s_inodes_count);
85 unsigned offs, rec_len;
86 unsigned limit = PAGE_CACHE_SIZE;
90 if ((dir->i_size >> PAGE_CACHE_SHIFT) == page->index) {
91 limit = dir->i_size & ~PAGE_CACHE_MASK;
92 if (limit & (chunk_size - 1))
97 for (offs = 0; offs <= limit - EXT2_DIR_REC_LEN(1); offs += rec_len) {
98 p = (ext2_dirent *)(kaddr + offs);
99 rec_len = le16_to_cpu(p->rec_len);
101 if (rec_len < EXT2_DIR_REC_LEN(1))
105 if (rec_len < EXT2_DIR_REC_LEN(p->name_len))
107 if (((offs + rec_len - 1) ^ offs) & ~(chunk_size-1))
109 if (le32_to_cpu(p->inode) > max_inumber)
115 SetPageChecked(page);
118 /* Too bad, we had an error */
121 ext2_error(sb, "ext2_check_page",
122 "size of directory #%lu is not a multiple of chunk size",
127 error = "rec_len is smaller than minimal";
130 error = "unaligned directory entry";
133 error = "rec_len is too small for name_len";
136 error = "directory entry across blocks";
139 error = "inode out of bounds";
141 ext2_error (sb, "ext2_check_page", "bad entry in directory #%lu: %s - "
142 "offset=%lu, inode=%lu, rec_len=%d, name_len=%d",
143 dir->i_ino, error, (page->index<<PAGE_CACHE_SHIFT)+offs,
144 (unsigned long) le32_to_cpu(p->inode),
145 rec_len, p->name_len);
148 p = (ext2_dirent *)(kaddr + offs);
149 ext2_error (sb, "ext2_check_page",
150 "entry in directory #%lu spans the page boundary"
151 "offset=%lu, inode=%lu",
152 dir->i_ino, (page->index<<PAGE_CACHE_SHIFT)+offs,
153 (unsigned long) le32_to_cpu(p->inode));
155 SetPageChecked(page);
159 static struct page * ext2_get_page(struct inode *dir, unsigned long n)
161 struct address_space *mapping = dir->i_mapping;
162 struct page *page = read_mapping_page(mapping, n, NULL);
164 wait_on_page_locked(page);
166 if (!PageUptodate(page))
168 if (!PageChecked(page))
169 ext2_check_page(page);
177 return ERR_PTR(-EIO);
181 * NOTE! unlike strncmp, ext2_match returns 1 for success, 0 for failure.
183 * len <= EXT2_NAME_LEN and de != NULL are guaranteed by caller.
185 static inline int ext2_match (int len, const char * const name,
186 struct ext2_dir_entry_2 * de)
188 if (len != de->name_len)
192 return !memcmp(name, de->name, len);
196 * p is at least 6 bytes before the end of page
198 static inline ext2_dirent *ext2_next_entry(ext2_dirent *p)
200 return (ext2_dirent *)((char*)p + le16_to_cpu(p->rec_len));
203 static inline unsigned
204 ext2_validate_entry(char *base, unsigned offset, unsigned mask)
206 ext2_dirent *de = (ext2_dirent*)(base + offset);
207 ext2_dirent *p = (ext2_dirent*)(base + (offset&mask));
208 while ((char*)p < (char*)de) {
211 p = ext2_next_entry(p);
213 return (char *)p - base;
216 static unsigned char ext2_filetype_table[EXT2_FT_MAX] = {
217 [EXT2_FT_UNKNOWN] = DT_UNKNOWN,
218 [EXT2_FT_REG_FILE] = DT_REG,
219 [EXT2_FT_DIR] = DT_DIR,
220 [EXT2_FT_CHRDEV] = DT_CHR,
221 [EXT2_FT_BLKDEV] = DT_BLK,
222 [EXT2_FT_FIFO] = DT_FIFO,
223 [EXT2_FT_SOCK] = DT_SOCK,
224 [EXT2_FT_SYMLINK] = DT_LNK,
228 static unsigned char ext2_type_by_mode[S_IFMT >> S_SHIFT] = {
229 [S_IFREG >> S_SHIFT] = EXT2_FT_REG_FILE,
230 [S_IFDIR >> S_SHIFT] = EXT2_FT_DIR,
231 [S_IFCHR >> S_SHIFT] = EXT2_FT_CHRDEV,
232 [S_IFBLK >> S_SHIFT] = EXT2_FT_BLKDEV,
233 [S_IFIFO >> S_SHIFT] = EXT2_FT_FIFO,
234 [S_IFSOCK >> S_SHIFT] = EXT2_FT_SOCK,
235 [S_IFLNK >> S_SHIFT] = EXT2_FT_SYMLINK,
238 static inline void ext2_set_de_type(ext2_dirent *de, struct inode *inode)
240 mode_t mode = inode->i_mode;
241 if (EXT2_HAS_INCOMPAT_FEATURE(inode->i_sb, EXT2_FEATURE_INCOMPAT_FILETYPE))
242 de->file_type = ext2_type_by_mode[(mode & S_IFMT)>>S_SHIFT];
248 ext2_readdir (struct file * filp, void * dirent, filldir_t filldir)
250 loff_t pos = filp->f_pos;
251 struct inode *inode = filp->f_dentry->d_inode;
252 struct super_block *sb = inode->i_sb;
253 unsigned int offset = pos & ~PAGE_CACHE_MASK;
254 unsigned long n = pos >> PAGE_CACHE_SHIFT;
255 unsigned long npages = dir_pages(inode);
256 unsigned chunk_mask = ~(ext2_chunk_size(inode)-1);
257 unsigned char *types = NULL;
258 int need_revalidate = filp->f_version != inode->i_version;
260 if (pos > inode->i_size - EXT2_DIR_REC_LEN(1))
263 if (EXT2_HAS_INCOMPAT_FEATURE(sb, EXT2_FEATURE_INCOMPAT_FILETYPE))
264 types = ext2_filetype_table;
266 for ( ; n < npages; n++, offset = 0) {
269 struct page *page = ext2_get_page(inode, n);
272 ext2_error(sb, __FUNCTION__,
275 filp->f_pos += PAGE_CACHE_SIZE - offset;
278 kaddr = page_address(page);
279 if (unlikely(need_revalidate)) {
281 offset = ext2_validate_entry(kaddr, offset, chunk_mask);
282 filp->f_pos = (n<<PAGE_CACHE_SHIFT) + offset;
284 filp->f_version = inode->i_version;
287 de = (ext2_dirent *)(kaddr+offset);
288 limit = kaddr + ext2_last_byte(inode, n) - EXT2_DIR_REC_LEN(1);
289 for ( ;(char*)de <= limit; de = ext2_next_entry(de)) {
290 if (de->rec_len == 0) {
291 ext2_error(sb, __FUNCTION__,
292 "zero-length directory entry");
298 unsigned char d_type = DT_UNKNOWN;
300 if (types && de->file_type < EXT2_FT_MAX)
301 d_type = types[de->file_type];
303 offset = (char *)de - kaddr;
304 over = filldir(dirent, de->name, de->name_len,
305 (n<<PAGE_CACHE_SHIFT) | offset,
306 le32_to_cpu(de->inode), d_type);
312 filp->f_pos += le16_to_cpu(de->rec_len);
322 * finds an entry in the specified directory with the wanted name. It
323 * returns the page in which the entry was found, and the entry itself
324 * (as a parameter - res_dir). Page is returned mapped and unlocked.
325 * Entry is guaranteed to be valid.
327 struct ext2_dir_entry_2 * ext2_find_entry (struct inode * dir,
328 struct dentry *dentry, struct page ** res_page)
330 const char *name = dentry->d_name.name;
331 int namelen = dentry->d_name.len;
332 unsigned reclen = EXT2_DIR_REC_LEN(namelen);
333 unsigned long start, n;
334 unsigned long npages = dir_pages(dir);
335 struct page *page = NULL;
336 struct ext2_inode_info *ei = EXT2_I(dir);
345 start = ei->i_dir_start_lookup;
351 page = ext2_get_page(dir, n);
353 kaddr = page_address(page);
354 de = (ext2_dirent *) kaddr;
355 kaddr += ext2_last_byte(dir, n) - reclen;
356 while ((char *) de <= kaddr) {
357 if (de->rec_len == 0) {
358 ext2_error(dir->i_sb, __FUNCTION__,
359 "zero-length directory entry");
363 if (ext2_match (namelen, name, de))
365 de = ext2_next_entry(de);
371 } while (n != start);
377 ei->i_dir_start_lookup = n;
381 struct ext2_dir_entry_2 * ext2_dotdot (struct inode *dir, struct page **p)
383 struct page *page = ext2_get_page(dir, 0);
384 ext2_dirent *de = NULL;
387 de = ext2_next_entry((ext2_dirent *) page_address(page));
393 ino_t ext2_inode_by_name(struct inode * dir, struct dentry *dentry)
396 struct ext2_dir_entry_2 * de;
399 de = ext2_find_entry (dir, dentry, &page);
401 res = le32_to_cpu(de->inode);
403 page_cache_release(page);
408 /* Releases the page */
409 void ext2_set_link(struct inode *dir, struct ext2_dir_entry_2 *de,
410 struct page *page, struct inode *inode)
412 unsigned from = (char *) de - (char *) page_address(page);
413 unsigned to = from + le16_to_cpu(de->rec_len);
417 err = page->mapping->a_ops->prepare_write(NULL, page, from, to);
419 de->inode = cpu_to_le32(inode->i_ino);
420 ext2_set_de_type (de, inode);
421 err = ext2_commit_chunk(page, from, to);
423 dir->i_mtime = dir->i_ctime = CURRENT_TIME_SEC;
424 EXT2_I(dir)->i_flags &= ~EXT2_BTREE_FL;
425 mark_inode_dirty(dir);
431 int ext2_add_link (struct dentry *dentry, struct inode *inode)
433 struct inode *dir = dentry->d_parent->d_inode;
434 const char *name = dentry->d_name.name;
435 int namelen = dentry->d_name.len;
436 unsigned chunk_size = ext2_chunk_size(dir);
437 unsigned reclen = EXT2_DIR_REC_LEN(namelen);
438 unsigned short rec_len, name_len;
439 struct page *page = NULL;
441 unsigned long npages = dir_pages(dir);
448 * We take care of directory expansion in the same loop.
449 * This code plays outside i_size, so it locks the page
450 * to protect that region.
452 for (n = 0; n <= npages; n++) {
455 page = ext2_get_page(dir, n);
460 kaddr = page_address(page);
461 dir_end = kaddr + ext2_last_byte(dir, n);
462 de = (ext2_dirent *)kaddr;
463 kaddr += PAGE_CACHE_SIZE - reclen;
464 while ((char *)de <= kaddr) {
465 if ((char *)de == dir_end) {
468 rec_len = chunk_size;
469 de->rec_len = cpu_to_le16(chunk_size);
473 if (de->rec_len == 0) {
474 ext2_error(dir->i_sb, __FUNCTION__,
475 "zero-length directory entry");
480 if (ext2_match (namelen, name, de))
482 name_len = EXT2_DIR_REC_LEN(de->name_len);
483 rec_len = le16_to_cpu(de->rec_len);
484 if (!de->inode && rec_len >= reclen)
486 if (rec_len >= name_len + reclen)
488 de = (ext2_dirent *) ((char *) de + rec_len);
497 from = (char*)de - (char*)page_address(page);
499 err = page->mapping->a_ops->prepare_write(NULL, page, from, to);
503 ext2_dirent *de1 = (ext2_dirent *) ((char *) de + name_len);
504 de1->rec_len = cpu_to_le16(rec_len - name_len);
505 de->rec_len = cpu_to_le16(name_len);
508 de->name_len = namelen;
509 memcpy (de->name, name, namelen);
510 de->inode = cpu_to_le32(inode->i_ino);
511 ext2_set_de_type (de, inode);
512 err = ext2_commit_chunk(page, from, to);
513 dir->i_mtime = dir->i_ctime = CURRENT_TIME_SEC;
514 EXT2_I(dir)->i_flags &= ~EXT2_BTREE_FL;
515 mark_inode_dirty(dir);
527 * ext2_delete_entry deletes a directory entry by merging it with the
528 * previous entry. Page is up-to-date. Releases the page.
530 int ext2_delete_entry (struct ext2_dir_entry_2 * dir, struct page * page )
532 struct address_space *mapping = page->mapping;
533 struct inode *inode = mapping->host;
534 char *kaddr = page_address(page);
535 unsigned from = ((char*)dir - kaddr) & ~(ext2_chunk_size(inode)-1);
536 unsigned to = ((char*)dir - kaddr) + le16_to_cpu(dir->rec_len);
537 ext2_dirent * pde = NULL;
538 ext2_dirent * de = (ext2_dirent *) (kaddr + from);
541 while ((char*)de < (char*)dir) {
542 if (de->rec_len == 0) {
543 ext2_error(inode->i_sb, __FUNCTION__,
544 "zero-length directory entry");
549 de = ext2_next_entry(de);
552 from = (char*)pde - (char*)page_address(page);
554 err = mapping->a_ops->prepare_write(NULL, page, from, to);
557 pde->rec_len = cpu_to_le16(to-from);
559 err = ext2_commit_chunk(page, from, to);
560 inode->i_ctime = inode->i_mtime = CURRENT_TIME_SEC;
561 EXT2_I(inode)->i_flags &= ~EXT2_BTREE_FL;
562 mark_inode_dirty(inode);
569 * Set the first fragment of directory.
571 int ext2_make_empty(struct inode *inode, struct inode *parent)
573 struct address_space *mapping = inode->i_mapping;
574 struct page *page = grab_cache_page(mapping, 0);
575 unsigned chunk_size = ext2_chunk_size(inode);
576 struct ext2_dir_entry_2 * de;
582 err = mapping->a_ops->prepare_write(NULL, page, 0, chunk_size);
587 kaddr = kmap_atomic(page, KM_USER0);
588 memset(kaddr, 0, chunk_size);
589 de = (struct ext2_dir_entry_2 *)kaddr;
591 de->rec_len = cpu_to_le16(EXT2_DIR_REC_LEN(1));
592 memcpy (de->name, ".\0\0", 4);
593 de->inode = cpu_to_le32(inode->i_ino);
594 ext2_set_de_type (de, inode);
596 de = (struct ext2_dir_entry_2 *)(kaddr + EXT2_DIR_REC_LEN(1));
598 de->rec_len = cpu_to_le16(chunk_size - EXT2_DIR_REC_LEN(1));
599 de->inode = cpu_to_le32(parent->i_ino);
600 memcpy (de->name, "..\0", 4);
601 ext2_set_de_type (de, inode);
602 kunmap_atomic(kaddr, KM_USER0);
603 err = ext2_commit_chunk(page, 0, chunk_size);
605 page_cache_release(page);
610 * routine to check that the specified directory is empty (for rmdir)
612 int ext2_empty_dir (struct inode * inode)
614 struct page *page = NULL;
615 unsigned long i, npages = dir_pages(inode);
617 for (i = 0; i < npages; i++) {
620 page = ext2_get_page(inode, i);
625 kaddr = page_address(page);
626 de = (ext2_dirent *)kaddr;
627 kaddr += ext2_last_byte(inode, i) - EXT2_DIR_REC_LEN(1);
629 while ((char *)de <= kaddr) {
630 if (de->rec_len == 0) {
631 ext2_error(inode->i_sb, __FUNCTION__,
632 "zero-length directory entry");
633 printk("kaddr=%p, de=%p\n", kaddr, de);
636 if (de->inode != 0) {
637 /* check for . and .. */
638 if (de->name[0] != '.')
640 if (de->name_len > 2)
642 if (de->name_len < 2) {
644 cpu_to_le32(inode->i_ino))
646 } else if (de->name[1] != '.')
649 de = ext2_next_entry(de);
660 const struct file_operations ext2_dir_operations = {
661 .llseek = generic_file_llseek,
662 .read = generic_read_dir,
663 .readdir = ext2_readdir,
665 .fsync = ext2_sync_file,