2 * linux/fs/vfat/namei.c
4 * Written 1992,1993 by Werner Almesberger
6 * Windows95/Windows NT compatible extended MSDOS filesystem
7 * by Gordon Chaffee Copyright (C) 1995. Send bug reports for the
8 * VFAT filesystem to <chaffee@cs.berkeley.edu>. Specify
9 * what file operation caused you trouble and if you can duplicate
10 * the problem, send a script that demonstrates it.
12 * Short name translation 1999, 2001 by Wolfram Pienkoss <wp@bszh.de>
14 * Support Multibyte characters and cleanup by
15 * OGAWA Hirofumi <hirofumi@mail.parknet.co.jp>
18 #include <linux/module.h>
20 #include <linux/jiffies.h>
21 #include <linux/msdos_fs.h>
22 #include <linux/ctype.h>
23 #include <linux/slab.h>
24 #include <linux/smp_lock.h>
25 #include <linux/buffer_head.h>
26 #include <linux/namei.h>
28 static int vfat_revalidate(struct dentry *dentry, struct nameidata *nd)
32 if (!dentry->d_inode &&
33 nd && !(nd->flags & LOOKUP_CONTINUE) && (nd->flags & LOOKUP_CREATE))
35 * negative dentry is dropped, in order to make sure
36 * to use the name which a user desires if this is
41 spin_lock(&dentry->d_lock);
42 if (dentry->d_time != dentry->d_parent->d_inode->i_version)
44 spin_unlock(&dentry->d_lock);
49 /* returns the length of a struct qstr, ignoring trailing dots */
50 static unsigned int vfat_striptail_len(struct qstr *qstr)
52 unsigned int len = qstr->len;
54 while (len && qstr->name[len - 1] == '.')
60 * Compute the hash for the vfat name corresponding to the dentry.
61 * Note: if the name is invalid, we leave the hash code unchanged so
62 * that the existing dentry can be used. The vfat fs routines will
63 * return ENOENT or EINVAL as appropriate.
65 static int vfat_hash(struct dentry *dentry, struct qstr *qstr)
67 qstr->hash = full_name_hash(qstr->name, vfat_striptail_len(qstr));
72 * Compute the hash for the vfat name corresponding to the dentry.
73 * Note: if the name is invalid, we leave the hash code unchanged so
74 * that the existing dentry can be used. The vfat fs routines will
75 * return ENOENT or EINVAL as appropriate.
77 static int vfat_hashi(struct dentry *dentry, struct qstr *qstr)
79 struct nls_table *t = MSDOS_SB(dentry->d_inode->i_sb)->nls_io;
80 const unsigned char *name;
85 len = vfat_striptail_len(qstr);
87 hash = init_name_hash();
89 hash = partial_name_hash(nls_tolower(t, *name++), hash);
90 qstr->hash = end_name_hash(hash);
96 * Case insensitive compare of two vfat names.
98 static int vfat_cmpi(struct dentry *dentry, struct qstr *a, struct qstr *b)
100 struct nls_table *t = MSDOS_SB(dentry->d_inode->i_sb)->nls_io;
101 unsigned int alen, blen;
103 /* A filename cannot end in '.' or we treat it like it has none */
104 alen = vfat_striptail_len(a);
105 blen = vfat_striptail_len(b);
107 if (nls_strnicmp(t, a->name, b->name, alen) == 0)
114 * Case sensitive compare of two vfat names.
116 static int vfat_cmp(struct dentry *dentry, struct qstr *a, struct qstr *b)
118 unsigned int alen, blen;
120 /* A filename cannot end in '.' or we treat it like it has none */
121 alen = vfat_striptail_len(a);
122 blen = vfat_striptail_len(b);
124 if (strncmp(a->name, b->name, alen) == 0)
130 static struct dentry_operations vfat_dentry_ops[4] = {
132 .d_hash = vfat_hashi,
133 .d_compare = vfat_cmpi,
136 .d_revalidate = vfat_revalidate,
137 .d_hash = vfat_hashi,
138 .d_compare = vfat_cmpi,
142 .d_compare = vfat_cmp,
145 .d_revalidate = vfat_revalidate,
147 .d_compare = vfat_cmp,
151 /* Characters that are undesirable in an MS-DOS file name */
153 static inline wchar_t vfat_bad_char(wchar_t w)
156 || (w == '*') || (w == '?') || (w == '<') || (w == '>')
157 || (w == '|') || (w == '"') || (w == ':') || (w == '/')
161 static inline wchar_t vfat_replace_char(wchar_t w)
163 return (w == '[') || (w == ']') || (w == ';') || (w == ',')
164 || (w == '+') || (w == '=');
167 static wchar_t vfat_skip_char(wchar_t w)
169 return (w == '.') || (w == ' ');
172 static inline int vfat_is_used_badchars(const wchar_t *s, int len)
176 for (i = 0; i < len; i++)
177 if (vfat_bad_char(s[i]))
180 if (s[i - 1] == ' ') /* last character cannot be space */
186 static int vfat_find_form(struct inode *dir, unsigned char *name)
188 struct fat_slot_info sinfo;
189 int err = fat_scan(dir, name, &sinfo);
197 * 1) Valid characters for the 8.3 format alias are any combination of
198 * letters, uppercase alphabets, digits, any of the
199 * following special characters:
200 * $ % ' ` - @ { } ~ ! # ( ) & _ ^
201 * In this case Longfilename is not stored in disk.
204 * File name and extension name is contain uppercase/lowercase
205 * only. And it is expressed by CASE_LOWER_BASE and CASE_LOWER_EXT.
207 * 2) File name is 8.3 format, but it contain the uppercase and
208 * lowercase char, muliti bytes char, etc. In this case numtail is not
209 * added, but Longfilename is stored.
211 * 3) When the one except for the above, or the following special
212 * character are contained:
214 * numtail is added, and Longfilename must be stored in disk .
216 struct shortname_info {
217 unsigned char lower:1,
221 #define INIT_SHORTNAME_INFO(x) do { \
227 static inline int to_shortname_char(struct nls_table *nls,
228 unsigned char *buf, int buf_size,
229 wchar_t *src, struct shortname_info *info)
233 if (vfat_skip_char(*src)) {
237 if (vfat_replace_char(*src)) {
243 len = nls->uni2char(*src, buf, buf_size);
248 } else if (len == 1) {
249 unsigned char prev = buf[0];
251 if (buf[0] >= 0x7F) {
256 buf[0] = nls_toupper(nls, buf[0]);
257 if (isalpha(buf[0])) {
272 * Given a valid longname, create a unique shortname. Make sure the
273 * shortname does not exist
274 * Returns negative number on error, 0 for a normal
275 * return, and 1 for valid shortname
277 static int vfat_create_shortname(struct inode *dir, struct nls_table *nls,
278 wchar_t *uname, int ulen,
279 unsigned char *name_res, unsigned char *lcase)
281 struct fat_mount_options *opts = &MSDOS_SB(dir->i_sb)->options;
282 wchar_t *ip, *ext_start, *end, *name_start;
283 unsigned char base[9], ext[4], buf[8], *p;
284 unsigned char charbuf[NLS_MAX_CHARSET_SIZE];
286 int sz = 0, extlen, baselen, i, numtail_baselen, numtail2_baselen;
288 struct shortname_info base_info, ext_info;
291 INIT_SHORTNAME_INFO(&base_info);
292 INIT_SHORTNAME_INFO(&ext_info);
294 /* Now, we need to create a shortname from the long name */
295 ext_start = end = &uname[ulen];
296 while (--ext_start >= uname) {
297 if (*ext_start == 0x002E) { /* is `.' */
298 if (ext_start == end - 1) {
306 if (ext_start == uname - 1) {
309 } else if (ext_start) {
311 * Names which start with a dot could be just
312 * an extension eg. "...test". In this case Win95
313 * uses the extension as the name and sets no extension.
315 name_start = &uname[0];
316 while (name_start < ext_start) {
317 if (!vfat_skip_char(*name_start))
321 if (name_start != ext_start) {
322 sz = ext_start - uname;
331 numtail2_baselen = 2;
332 for (baselen = i = 0, p = base, ip = uname; i < sz; i++, ip++) {
333 chl = to_shortname_char(nls, charbuf, sizeof(charbuf),
338 if (baselen < 2 && (baselen + chl) > 2)
339 numtail2_baselen = baselen;
340 if (baselen < 6 && (baselen + chl) > 6)
341 numtail_baselen = baselen;
342 for (chi = 0; chi < chl; chi++) {
349 if ((chi < chl - 1) || (ip + 1) - uname < sz)
360 for (p = ext, ip = ext_start; extlen < 3 && ip < end; ip++) {
361 chl = to_shortname_char(nls, charbuf, sizeof(charbuf),
366 if ((extlen + chl) > 3) {
370 for (chi = 0; chi < chl; chi++) {
382 base[baselen] = '\0';
384 /* Yes, it can happen. ".\xe5" would do it. */
385 if (base[0] == DELETED_FLAG)
388 /* OK, at this point we know that base is not longer than 8 symbols,
389 * ext is not longer than 3, base is nonempty, both don't contain
390 * any bad symbols (lowercase transformed to uppercase).
393 memset(name_res, ' ', MSDOS_NAME);
394 memcpy(name_res, base, baselen);
395 memcpy(name_res + 8, ext, extlen);
397 if (is_shortname && base_info.valid && ext_info.valid) {
398 if (vfat_find_form(dir, name_res) == 0)
401 if (opts->shortname & VFAT_SFN_CREATE_WIN95) {
402 return (base_info.upper && ext_info.upper);
403 } else if (opts->shortname & VFAT_SFN_CREATE_WINNT) {
404 if ((base_info.upper || base_info.lower) &&
405 (ext_info.upper || ext_info.lower)) {
406 if (!base_info.upper && base_info.lower)
407 *lcase |= CASE_LOWER_BASE;
408 if (!ext_info.upper && ext_info.lower)
409 *lcase |= CASE_LOWER_EXT;
418 if (opts->numtail == 0)
419 if (vfat_find_form(dir, name_res) < 0)
423 * Try to find a unique extension. This used to
424 * iterate through all possibilities sequentially,
425 * but that gave extremely bad performance. Windows
426 * only tries a few cases before using random
427 * values for part of the base.
431 baselen = numtail_baselen;
434 name_res[baselen] = '~';
435 for (i = 1; i < 10; i++) {
436 name_res[baselen + 1] = i + '0';
437 if (vfat_find_form(dir, name_res) < 0)
441 i = jiffies & 0xffff;
442 sz = (jiffies >> 16) & 0x7;
444 baselen = numtail2_baselen;
447 name_res[baselen + 4] = '~';
448 name_res[baselen + 5] = '1' + sz;
450 sprintf(buf, "%04X", i);
451 memcpy(&name_res[baselen], buf, 4);
452 if (vfat_find_form(dir, name_res) < 0)
459 /* Translate a string, including coded sequences into Unicode */
461 xlate_to_uni(const unsigned char *name, int len, unsigned char *outname,
462 int *longlen, int *outlen, int escape, int utf8,
463 struct nls_table *nls)
465 const unsigned char *ip;
473 int name_len = strlen(name);
475 *outlen = utf8_mbstowcs((wchar_t *)outname, name, PATH_MAX);
478 * We stripped '.'s before and set len appropriately,
479 * but utf8_mbstowcs doesn't care about len
481 *outlen -= (name_len - len);
484 return -ENAMETOOLONG;
486 op = &outname[*outlen * sizeof(wchar_t)];
489 for (i = 0, ip = name, op = outname, *outlen = 0;
490 i < len && *outlen <= 255;
493 if (escape && (*ip == ':')) {
497 for (k = 1; k < 5; k++) {
500 if (nc >= '0' && nc <= '9') {
504 if (nc >= 'a' && nc <= 'f') {
505 ec |= nc - ('a' - 10);
508 if (nc >= 'A' && nc <= 'F') {
509 ec |= nc - ('A' - 10);
519 if ((charlen = nls->char2uni(ip, len - i, (wchar_t *)op)) < 0)
527 return -ENAMETOOLONG;
529 for (i = 0, ip = name, op = outname, *outlen = 0;
530 i < len && *outlen <= 255;
537 return -ENAMETOOLONG;
547 fill = 13 - (*outlen % 13);
548 for (i = 0; i < fill; i++) {
559 static int vfat_build_slots(struct inode *dir, const unsigned char *name,
560 int len, int is_dir, int cluster,
562 struct msdos_dir_slot *slots, int *nr_slots)
564 struct msdos_sb_info *sbi = MSDOS_SB(dir->i_sb);
565 struct fat_mount_options *opts = &sbi->options;
566 struct msdos_dir_slot *ps;
567 struct msdos_dir_entry *de;
568 unsigned char cksum, lcase;
569 unsigned char msdos_name[MSDOS_NAME];
572 int err, ulen, usize, i;
581 err = xlate_to_uni(name, len, (unsigned char *)uname, &ulen, &usize,
582 opts->unicode_xlate, opts->utf8, sbi->nls_io);
586 err = vfat_is_used_badchars(uname, ulen);
590 err = vfat_create_shortname(dir, sbi->nls_disk, uname, ulen,
595 de = (struct msdos_dir_entry *)slots;
600 /* build the entry of long file name */
601 cksum = fat_checksum(msdos_name);
603 *nr_slots = usize / 13;
604 for (ps = slots, i = *nr_slots; i > 0; i--, ps++) {
608 ps->alias_checksum = cksum;
610 offset = (i - 1) * 13;
611 fatwchar_to16(ps->name0_4, uname + offset, 5);
612 fatwchar_to16(ps->name5_10, uname + offset + 5, 6);
613 fatwchar_to16(ps->name11_12, uname + offset + 11, 2);
616 de = (struct msdos_dir_entry *)ps;
619 /* build the entry of 8.3 alias name */
621 memcpy(de->name, msdos_name, MSDOS_NAME);
622 de->attr = is_dir ? ATTR_DIR : ATTR_ARCH;
624 fat_date_unix2dos(ts->tv_sec, &time, &date);
625 de->time = de->ctime = time;
626 de->date = de->cdate = de->adate = date;
628 de->start = cpu_to_le16(cluster);
629 de->starthi = cpu_to_le16(cluster >> 16);
636 static int vfat_add_entry(struct inode *dir, struct qstr *qname, int is_dir,
637 int cluster, struct timespec *ts,
638 struct fat_slot_info *sinfo)
640 struct msdos_dir_slot *slots;
644 len = vfat_striptail_len(qname);
648 slots = kmalloc(sizeof(*slots) * MSDOS_SLOTS, GFP_KERNEL);
652 err = vfat_build_slots(dir, qname->name, len, is_dir, cluster, ts,
657 err = fat_add_entries(dir, slots, nr_slots, sinfo);
661 /* update timestamp */
662 dir->i_ctime = dir->i_mtime = dir->i_atime = *ts;
664 (void)fat_sync_inode(dir);
666 mark_inode_dirty(dir);
672 static int vfat_find(struct inode *dir, struct qstr *qname,
673 struct fat_slot_info *sinfo)
675 unsigned int len = vfat_striptail_len(qname);
678 return fat_search_long(dir, qname->name, len, sinfo);
681 static struct dentry *vfat_lookup(struct inode *dir, struct dentry *dentry,
682 struct nameidata *nd)
684 struct super_block *sb = dir->i_sb;
685 struct fat_slot_info sinfo;
686 struct inode *inode = NULL;
687 struct dentry *alias;
691 table = (MSDOS_SB(sb)->options.name_check == 's') ? 2 : 0;
692 dentry->d_op = &vfat_dentry_ops[table];
694 err = vfat_find(dir, &dentry->d_name, &sinfo);
699 inode = fat_build_inode(sb, sinfo.de, sinfo.i_pos);
703 return ERR_CAST(inode);
705 alias = d_find_alias(inode);
707 if (d_invalidate(alias) == 0)
718 dentry->d_op = &vfat_dentry_ops[table];
719 dentry->d_time = dentry->d_parent->d_inode->i_version;
720 dentry = d_splice_alias(inode, dentry);
722 dentry->d_op = &vfat_dentry_ops[table];
723 dentry->d_time = dentry->d_parent->d_inode->i_version;
728 static int vfat_create(struct inode *dir, struct dentry *dentry, int mode,
729 struct nameidata *nd)
731 struct super_block *sb = dir->i_sb;
733 struct fat_slot_info sinfo;
739 ts = CURRENT_TIME_SEC;
740 err = vfat_add_entry(dir, &dentry->d_name, 0, 0, &ts, &sinfo);
745 inode = fat_build_inode(sb, sinfo.de, sinfo.i_pos);
748 err = PTR_ERR(inode);
752 inode->i_mtime = inode->i_atime = inode->i_ctime = ts;
753 /* timestamp is already written, so mark_inode_dirty() is unneeded. */
755 dentry->d_time = dentry->d_parent->d_inode->i_version;
756 d_instantiate(dentry, inode);
762 static int vfat_rmdir(struct inode *dir, struct dentry *dentry)
764 struct inode *inode = dentry->d_inode;
765 struct fat_slot_info sinfo;
770 err = fat_dir_empty(inode);
773 err = vfat_find(dir, &dentry->d_name, &sinfo);
777 err = fat_remove_entries(dir, &sinfo); /* and releases bh */
783 inode->i_mtime = inode->i_atime = CURRENT_TIME_SEC;
791 static int vfat_unlink(struct inode *dir, struct dentry *dentry)
793 struct inode *inode = dentry->d_inode;
794 struct fat_slot_info sinfo;
799 err = vfat_find(dir, &dentry->d_name, &sinfo);
803 err = fat_remove_entries(dir, &sinfo); /* and releases bh */
807 inode->i_mtime = inode->i_atime = CURRENT_TIME_SEC;
815 static int vfat_mkdir(struct inode *dir, struct dentry *dentry, int mode)
817 struct super_block *sb = dir->i_sb;
819 struct fat_slot_info sinfo;
825 ts = CURRENT_TIME_SEC;
826 cluster = fat_alloc_new_dir(dir, &ts);
831 err = vfat_add_entry(dir, &dentry->d_name, 1, cluster, &ts, &sinfo);
837 inode = fat_build_inode(sb, sinfo.de, sinfo.i_pos);
840 err = PTR_ERR(inode);
841 /* the directory was completed, just return a error */
846 inode->i_mtime = inode->i_atime = inode->i_ctime = ts;
847 /* timestamp is already written, so mark_inode_dirty() is unneeded. */
849 dentry->d_time = dentry->d_parent->d_inode->i_version;
850 d_instantiate(dentry, inode);
856 fat_free_clusters(dir, cluster);
862 static int vfat_rename(struct inode *old_dir, struct dentry *old_dentry,
863 struct inode *new_dir, struct dentry *new_dentry)
865 struct buffer_head *dotdot_bh;
866 struct msdos_dir_entry *dotdot_de;
867 struct inode *old_inode, *new_inode;
868 struct fat_slot_info old_sinfo, sinfo;
870 loff_t dotdot_i_pos, new_i_pos;
871 int err, is_dir, update_dotdot, corrupt = 0;
873 old_sinfo.bh = sinfo.bh = dotdot_bh = NULL;
874 old_inode = old_dentry->d_inode;
875 new_inode = new_dentry->d_inode;
877 err = vfat_find(old_dir, &old_dentry->d_name, &old_sinfo);
881 is_dir = S_ISDIR(old_inode->i_mode);
882 update_dotdot = (is_dir && old_dir != new_dir);
884 if (fat_get_dotdot_entry(old_inode, &dotdot_bh, &dotdot_de,
885 &dotdot_i_pos) < 0) {
891 ts = CURRENT_TIME_SEC;
894 err = fat_dir_empty(new_inode);
898 new_i_pos = MSDOS_I(new_inode)->i_pos;
899 fat_detach(new_inode);
901 err = vfat_add_entry(new_dir, &new_dentry->d_name, is_dir, 0,
905 new_i_pos = sinfo.i_pos;
907 new_dir->i_version++;
909 fat_detach(old_inode);
910 fat_attach(old_inode, new_i_pos);
911 if (IS_DIRSYNC(new_dir)) {
912 err = fat_sync_inode(old_inode);
916 mark_inode_dirty(old_inode);
919 int start = MSDOS_I(new_dir)->i_logstart;
920 dotdot_de->start = cpu_to_le16(start);
921 dotdot_de->starthi = cpu_to_le16(start >> 16);
922 mark_buffer_dirty(dotdot_bh);
923 if (IS_DIRSYNC(new_dir)) {
924 err = sync_dirty_buffer(dotdot_bh);
933 err = fat_remove_entries(old_dir, &old_sinfo); /* and releases bh */
937 old_dir->i_version++;
938 old_dir->i_ctime = old_dir->i_mtime = ts;
939 if (IS_DIRSYNC(old_dir))
940 (void)fat_sync_inode(old_dir);
942 mark_inode_dirty(old_dir);
945 drop_nlink(new_inode);
947 drop_nlink(new_inode);
948 new_inode->i_ctime = ts;
953 brelse(old_sinfo.bh);
959 /* data cluster is shared, serious corruption */
963 int start = MSDOS_I(old_dir)->i_logstart;
964 dotdot_de->start = cpu_to_le16(start);
965 dotdot_de->starthi = cpu_to_le16(start >> 16);
966 mark_buffer_dirty(dotdot_bh);
967 corrupt |= sync_dirty_buffer(dotdot_bh);
970 fat_detach(old_inode);
971 fat_attach(old_inode, old_sinfo.i_pos);
973 fat_attach(new_inode, new_i_pos);
975 corrupt |= fat_sync_inode(new_inode);
978 * If new entry was not sharing the data cluster, it
979 * shouldn't be serious corruption.
981 int err2 = fat_remove_entries(new_dir, &sinfo);
987 fat_fs_panic(new_dir->i_sb,
988 "%s: Filesystem corrupted (i_pos %lld)",
989 __func__, sinfo.i_pos);
994 static const struct inode_operations vfat_dir_inode_operations = {
995 .create = vfat_create,
996 .lookup = vfat_lookup,
997 .unlink = vfat_unlink,
1000 .rename = vfat_rename,
1001 .setattr = fat_setattr,
1002 .getattr = fat_getattr,
1005 static int vfat_fill_super(struct super_block *sb, void *data, int silent)
1009 res = fat_fill_super(sb, data, silent, &vfat_dir_inode_operations, 1);
1013 if (MSDOS_SB(sb)->options.name_check != 's')
1014 sb->s_root->d_op = &vfat_dentry_ops[0];
1016 sb->s_root->d_op = &vfat_dentry_ops[2];
1021 static int vfat_get_sb(struct file_system_type *fs_type,
1022 int flags, const char *dev_name,
1023 void *data, struct vfsmount *mnt)
1025 return get_sb_bdev(fs_type, flags, dev_name, data, vfat_fill_super,
1029 static struct file_system_type vfat_fs_type = {
1030 .owner = THIS_MODULE,
1032 .get_sb = vfat_get_sb,
1033 .kill_sb = kill_block_super,
1034 .fs_flags = FS_REQUIRES_DEV,
1037 static int __init init_vfat_fs(void)
1039 return register_filesystem(&vfat_fs_type);
1042 static void __exit exit_vfat_fs(void)
1044 unregister_filesystem(&vfat_fs_type);
1047 MODULE_LICENSE("GPL");
1048 MODULE_DESCRIPTION("VFAT filesystem support");
1049 MODULE_AUTHOR("Gordon Chaffee");
1051 module_init(init_vfat_fs)
1052 module_exit(exit_vfat_fs)