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]))
182 static int vfat_valid_longname(const unsigned char *name, unsigned int len)
184 if (name[len - 1] == ' ')
187 return -ENAMETOOLONG;
191 static int vfat_find_form(struct inode *dir, unsigned char *name)
193 struct fat_slot_info sinfo;
194 int err = fat_scan(dir, name, &sinfo);
202 * 1) Valid characters for the 8.3 format alias are any combination of
203 * letters, uppercase alphabets, digits, any of the
204 * following special characters:
205 * $ % ' ` - @ { } ~ ! # ( ) & _ ^
206 * In this case Longfilename is not stored in disk.
209 * File name and extension name is contain uppercase/lowercase
210 * only. And it is expressed by CASE_LOWER_BASE and CASE_LOWER_EXT.
212 * 2) File name is 8.3 format, but it contain the uppercase and
213 * lowercase char, muliti bytes char, etc. In this case numtail is not
214 * added, but Longfilename is stored.
216 * 3) When the one except for the above, or the following special
217 * character are contained:
219 * numtail is added, and Longfilename must be stored in disk .
221 struct shortname_info {
222 unsigned char lower:1,
226 #define INIT_SHORTNAME_INFO(x) do { \
232 static inline int to_shortname_char(struct nls_table *nls,
233 unsigned char *buf, int buf_size,
234 wchar_t *src, struct shortname_info *info)
238 if (vfat_skip_char(*src)) {
242 if (vfat_replace_char(*src)) {
248 len = nls->uni2char(*src, buf, buf_size);
253 } else if (len == 1) {
254 unsigned char prev = buf[0];
256 if (buf[0] >= 0x7F) {
261 buf[0] = nls_toupper(nls, buf[0]);
262 if (isalpha(buf[0])) {
277 * Given a valid longname, create a unique shortname. Make sure the
278 * shortname does not exist
279 * Returns negative number on error, 0 for a normal
280 * return, and 1 for valid shortname
282 static int vfat_create_shortname(struct inode *dir, struct nls_table *nls,
283 wchar_t *uname, int ulen,
284 unsigned char *name_res, unsigned char *lcase)
286 struct fat_mount_options *opts = &MSDOS_SB(dir->i_sb)->options;
287 wchar_t *ip, *ext_start, *end, *name_start;
288 unsigned char base[9], ext[4], buf[8], *p;
289 unsigned char charbuf[NLS_MAX_CHARSET_SIZE];
291 int sz = 0, extlen, baselen, i, numtail_baselen, numtail2_baselen;
293 struct shortname_info base_info, ext_info;
296 INIT_SHORTNAME_INFO(&base_info);
297 INIT_SHORTNAME_INFO(&ext_info);
299 /* Now, we need to create a shortname from the long name */
300 ext_start = end = &uname[ulen];
301 while (--ext_start >= uname) {
302 if (*ext_start == 0x002E) { /* is `.' */
303 if (ext_start == end - 1) {
311 if (ext_start == uname - 1) {
314 } else if (ext_start) {
316 * Names which start with a dot could be just
317 * an extension eg. "...test". In this case Win95
318 * uses the extension as the name and sets no extension.
320 name_start = &uname[0];
321 while (name_start < ext_start) {
322 if (!vfat_skip_char(*name_start))
326 if (name_start != ext_start) {
327 sz = ext_start - uname;
336 numtail2_baselen = 2;
337 for (baselen = i = 0, p = base, ip = uname; i < sz; i++, ip++) {
338 chl = to_shortname_char(nls, charbuf, sizeof(charbuf),
343 if (baselen < 2 && (baselen + chl) > 2)
344 numtail2_baselen = baselen;
345 if (baselen < 6 && (baselen + chl) > 6)
346 numtail_baselen = baselen;
347 for (chi = 0; chi < chl; chi++) {
354 if ((chi < chl - 1) || (ip + 1) - uname < sz)
365 for (p = ext, ip = ext_start; extlen < 3 && ip < end; ip++) {
366 chl = to_shortname_char(nls, charbuf, sizeof(charbuf),
371 if ((extlen + chl) > 3) {
375 for (chi = 0; chi < chl; chi++) {
387 base[baselen] = '\0';
389 /* Yes, it can happen. ".\xe5" would do it. */
390 if (base[0] == DELETED_FLAG)
393 /* OK, at this point we know that base is not longer than 8 symbols,
394 * ext is not longer than 3, base is nonempty, both don't contain
395 * any bad symbols (lowercase transformed to uppercase).
398 memset(name_res, ' ', MSDOS_NAME);
399 memcpy(name_res, base, baselen);
400 memcpy(name_res + 8, ext, extlen);
402 if (is_shortname && base_info.valid && ext_info.valid) {
403 if (vfat_find_form(dir, name_res) == 0)
406 if (opts->shortname & VFAT_SFN_CREATE_WIN95) {
407 return (base_info.upper && ext_info.upper);
408 } else if (opts->shortname & VFAT_SFN_CREATE_WINNT) {
409 if ((base_info.upper || base_info.lower) &&
410 (ext_info.upper || ext_info.lower)) {
411 if (!base_info.upper && base_info.lower)
412 *lcase |= CASE_LOWER_BASE;
413 if (!ext_info.upper && ext_info.lower)
414 *lcase |= CASE_LOWER_EXT;
423 if (opts->numtail == 0)
424 if (vfat_find_form(dir, name_res) < 0)
428 * Try to find a unique extension. This used to
429 * iterate through all possibilities sequentially,
430 * but that gave extremely bad performance. Windows
431 * only tries a few cases before using random
432 * values for part of the base.
436 baselen = numtail_baselen;
439 name_res[baselen] = '~';
440 for (i = 1; i < 10; i++) {
441 name_res[baselen + 1] = i + '0';
442 if (vfat_find_form(dir, name_res) < 0)
446 i = jiffies & 0xffff;
447 sz = (jiffies >> 16) & 0x7;
449 baselen = numtail2_baselen;
452 name_res[baselen + 4] = '~';
453 name_res[baselen + 5] = '1' + sz;
455 sprintf(buf, "%04X", i);
456 memcpy(&name_res[baselen], buf, 4);
457 if (vfat_find_form(dir, name_res) < 0)
464 /* Translate a string, including coded sequences into Unicode */
466 xlate_to_uni(const unsigned char *name, int len, unsigned char *outname,
467 int *longlen, int *outlen, int escape, int utf8,
468 struct nls_table *nls)
470 const unsigned char *ip;
478 int name_len = strlen(name);
480 *outlen = utf8_mbstowcs((wchar_t *)outname, name, PAGE_SIZE);
483 * We stripped '.'s before and set len appropriately,
484 * but utf8_mbstowcs doesn't care about len
486 *outlen -= (name_len - len);
488 op = &outname[*outlen * sizeof(wchar_t)];
491 for (i = 0, ip = name, op = outname, *outlen = 0;
492 i < len && *outlen <= 260;
495 if (escape && (*ip == ':')) {
499 for (k = 1; k < 5; k++) {
502 if (nc >= '0' && nc <= '9') {
506 if (nc >= 'a' && nc <= 'f') {
507 ec |= nc - ('a' - 10);
510 if (nc >= 'A' && nc <= 'F') {
511 ec |= nc - ('A' - 10);
521 if ((charlen = nls->char2uni(ip, len - i, (wchar_t *)op)) < 0)
529 for (i = 0, ip = name, op = outname, *outlen = 0;
530 i < len && *outlen <= 260;
539 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;
569 unsigned char cksum, lcase;
570 unsigned char msdos_name[MSDOS_NAME];
573 int err, ulen, usize, i;
577 err = vfat_valid_longname(name, len);
581 page = __get_free_page(GFP_KERNEL);
585 uname = (wchar_t *)page;
586 err = xlate_to_uni(name, len, (unsigned char *)uname, &ulen, &usize,
587 opts->unicode_xlate, opts->utf8, sbi->nls_io);
591 err = vfat_is_used_badchars(uname, ulen);
595 err = vfat_create_shortname(dir, sbi->nls_disk, uname, ulen,
600 de = (struct msdos_dir_entry *)slots;
605 /* build the entry of long file name */
606 cksum = fat_checksum(msdos_name);
608 *nr_slots = usize / 13;
609 for (ps = slots, i = *nr_slots; i > 0; i--, ps++) {
613 ps->alias_checksum = cksum;
615 offset = (i - 1) * 13;
616 fatwchar_to16(ps->name0_4, uname + offset, 5);
617 fatwchar_to16(ps->name5_10, uname + offset + 5, 6);
618 fatwchar_to16(ps->name11_12, uname + offset + 11, 2);
621 de = (struct msdos_dir_entry *)ps;
624 /* build the entry of 8.3 alias name */
626 memcpy(de->name, msdos_name, MSDOS_NAME);
627 de->attr = is_dir ? ATTR_DIR : ATTR_ARCH;
629 fat_date_unix2dos(ts->tv_sec, &time, &date);
630 de->time = de->ctime = time;
631 de->date = de->cdate = de->adate = date;
633 de->start = cpu_to_le16(cluster);
634 de->starthi = cpu_to_le16(cluster >> 16);
641 static int vfat_add_entry(struct inode *dir, struct qstr *qname, int is_dir,
642 int cluster, struct timespec *ts,
643 struct fat_slot_info *sinfo)
645 struct msdos_dir_slot *slots;
649 len = vfat_striptail_len(qname);
653 slots = kmalloc(sizeof(*slots) * MSDOS_SLOTS, GFP_KERNEL);
657 err = vfat_build_slots(dir, qname->name, len, is_dir, cluster, ts,
662 err = fat_add_entries(dir, slots, nr_slots, sinfo);
666 /* update timestamp */
667 dir->i_ctime = dir->i_mtime = dir->i_atime = *ts;
669 (void)fat_sync_inode(dir);
671 mark_inode_dirty(dir);
677 static int vfat_find(struct inode *dir, struct qstr *qname,
678 struct fat_slot_info *sinfo)
680 unsigned int len = vfat_striptail_len(qname);
683 return fat_search_long(dir, qname->name, len, sinfo);
686 static struct dentry *vfat_lookup(struct inode *dir, struct dentry *dentry,
687 struct nameidata *nd)
689 struct super_block *sb = dir->i_sb;
690 struct fat_slot_info sinfo;
691 struct inode *inode = NULL;
692 struct dentry *alias;
696 table = (MSDOS_SB(sb)->options.name_check == 's') ? 2 : 0;
697 dentry->d_op = &vfat_dentry_ops[table];
699 err = vfat_find(dir, &dentry->d_name, &sinfo);
704 inode = fat_build_inode(sb, sinfo.de, sinfo.i_pos);
708 return ERR_PTR(PTR_ERR(inode));
710 alias = d_find_alias(inode);
712 if (d_invalidate(alias) == 0)
723 dentry->d_op = &vfat_dentry_ops[table];
724 dentry->d_time = dentry->d_parent->d_inode->i_version;
725 dentry = d_splice_alias(inode, dentry);
727 dentry->d_op = &vfat_dentry_ops[table];
728 dentry->d_time = dentry->d_parent->d_inode->i_version;
733 static int vfat_create(struct inode *dir, struct dentry *dentry, int mode,
734 struct nameidata *nd)
736 struct super_block *sb = dir->i_sb;
738 struct fat_slot_info sinfo;
744 ts = CURRENT_TIME_SEC;
745 err = vfat_add_entry(dir, &dentry->d_name, 0, 0, &ts, &sinfo);
750 inode = fat_build_inode(sb, sinfo.de, sinfo.i_pos);
753 err = PTR_ERR(inode);
757 inode->i_mtime = inode->i_atime = inode->i_ctime = ts;
758 /* timestamp is already written, so mark_inode_dirty() is unneeded. */
760 dentry->d_time = dentry->d_parent->d_inode->i_version;
761 d_instantiate(dentry, inode);
767 static int vfat_rmdir(struct inode *dir, struct dentry *dentry)
769 struct inode *inode = dentry->d_inode;
770 struct fat_slot_info sinfo;
775 err = fat_dir_empty(inode);
778 err = vfat_find(dir, &dentry->d_name, &sinfo);
782 err = fat_remove_entries(dir, &sinfo); /* and releases bh */
788 inode->i_mtime = inode->i_atime = CURRENT_TIME_SEC;
796 static int vfat_unlink(struct inode *dir, struct dentry *dentry)
798 struct inode *inode = dentry->d_inode;
799 struct fat_slot_info sinfo;
804 err = vfat_find(dir, &dentry->d_name, &sinfo);
808 err = fat_remove_entries(dir, &sinfo); /* and releases bh */
812 inode->i_mtime = inode->i_atime = CURRENT_TIME_SEC;
820 static int vfat_mkdir(struct inode *dir, struct dentry *dentry, int mode)
822 struct super_block *sb = dir->i_sb;
824 struct fat_slot_info sinfo;
830 ts = CURRENT_TIME_SEC;
831 cluster = fat_alloc_new_dir(dir, &ts);
836 err = vfat_add_entry(dir, &dentry->d_name, 1, cluster, &ts, &sinfo);
842 inode = fat_build_inode(sb, sinfo.de, sinfo.i_pos);
845 err = PTR_ERR(inode);
846 /* the directory was completed, just return a error */
851 inode->i_mtime = inode->i_atime = inode->i_ctime = ts;
852 /* timestamp is already written, so mark_inode_dirty() is unneeded. */
854 dentry->d_time = dentry->d_parent->d_inode->i_version;
855 d_instantiate(dentry, inode);
861 fat_free_clusters(dir, cluster);
867 static int vfat_rename(struct inode *old_dir, struct dentry *old_dentry,
868 struct inode *new_dir, struct dentry *new_dentry)
870 struct buffer_head *dotdot_bh;
871 struct msdos_dir_entry *dotdot_de;
872 struct inode *old_inode, *new_inode;
873 struct fat_slot_info old_sinfo, sinfo;
875 loff_t dotdot_i_pos, new_i_pos;
876 int err, is_dir, update_dotdot, corrupt = 0;
878 old_sinfo.bh = sinfo.bh = dotdot_bh = NULL;
879 old_inode = old_dentry->d_inode;
880 new_inode = new_dentry->d_inode;
882 err = vfat_find(old_dir, &old_dentry->d_name, &old_sinfo);
886 is_dir = S_ISDIR(old_inode->i_mode);
887 update_dotdot = (is_dir && old_dir != new_dir);
889 if (fat_get_dotdot_entry(old_inode, &dotdot_bh, &dotdot_de,
890 &dotdot_i_pos) < 0) {
896 ts = CURRENT_TIME_SEC;
899 err = fat_dir_empty(new_inode);
903 new_i_pos = MSDOS_I(new_inode)->i_pos;
904 fat_detach(new_inode);
906 err = vfat_add_entry(new_dir, &new_dentry->d_name, is_dir, 0,
910 new_i_pos = sinfo.i_pos;
912 new_dir->i_version++;
914 fat_detach(old_inode);
915 fat_attach(old_inode, new_i_pos);
916 if (IS_DIRSYNC(new_dir)) {
917 err = fat_sync_inode(old_inode);
921 mark_inode_dirty(old_inode);
924 int start = MSDOS_I(new_dir)->i_logstart;
925 dotdot_de->start = cpu_to_le16(start);
926 dotdot_de->starthi = cpu_to_le16(start >> 16);
927 mark_buffer_dirty(dotdot_bh);
928 if (IS_DIRSYNC(new_dir)) {
929 err = sync_dirty_buffer(dotdot_bh);
938 err = fat_remove_entries(old_dir, &old_sinfo); /* and releases bh */
942 old_dir->i_version++;
943 old_dir->i_ctime = old_dir->i_mtime = ts;
944 if (IS_DIRSYNC(old_dir))
945 (void)fat_sync_inode(old_dir);
947 mark_inode_dirty(old_dir);
950 drop_nlink(new_inode);
952 drop_nlink(new_inode);
953 new_inode->i_ctime = ts;
958 brelse(old_sinfo.bh);
964 /* data cluster is shared, serious corruption */
968 int start = MSDOS_I(old_dir)->i_logstart;
969 dotdot_de->start = cpu_to_le16(start);
970 dotdot_de->starthi = cpu_to_le16(start >> 16);
971 mark_buffer_dirty(dotdot_bh);
972 corrupt |= sync_dirty_buffer(dotdot_bh);
975 fat_detach(old_inode);
976 fat_attach(old_inode, old_sinfo.i_pos);
978 fat_attach(new_inode, new_i_pos);
980 corrupt |= fat_sync_inode(new_inode);
983 * If new entry was not sharing the data cluster, it
984 * shouldn't be serious corruption.
986 int err2 = fat_remove_entries(new_dir, &sinfo);
992 fat_fs_panic(new_dir->i_sb,
993 "%s: Filesystem corrupted (i_pos %lld)",
994 __FUNCTION__, sinfo.i_pos);
999 static const struct inode_operations vfat_dir_inode_operations = {
1000 .create = vfat_create,
1001 .lookup = vfat_lookup,
1002 .unlink = vfat_unlink,
1003 .mkdir = vfat_mkdir,
1004 .rmdir = vfat_rmdir,
1005 .rename = vfat_rename,
1006 .setattr = fat_notify_change,
1007 .getattr = fat_getattr,
1010 static int vfat_fill_super(struct super_block *sb, void *data, int silent)
1014 res = fat_fill_super(sb, data, silent, &vfat_dir_inode_operations, 1);
1018 if (MSDOS_SB(sb)->options.name_check != 's')
1019 sb->s_root->d_op = &vfat_dentry_ops[0];
1021 sb->s_root->d_op = &vfat_dentry_ops[2];
1026 static int vfat_get_sb(struct file_system_type *fs_type,
1027 int flags, const char *dev_name,
1028 void *data, struct vfsmount *mnt)
1030 return get_sb_bdev(fs_type, flags, dev_name, data, vfat_fill_super,
1034 static struct file_system_type vfat_fs_type = {
1035 .owner = THIS_MODULE,
1037 .get_sb = vfat_get_sb,
1038 .kill_sb = kill_block_super,
1039 .fs_flags = FS_REQUIRES_DEV,
1042 static int __init init_vfat_fs(void)
1044 return register_filesystem(&vfat_fs_type);
1047 static void __exit exit_vfat_fs(void)
1049 unregister_filesystem(&vfat_fs_type);
1052 MODULE_LICENSE("GPL");
1053 MODULE_DESCRIPTION("VFAT filesystem support");
1054 MODULE_AUTHOR("Gordon Chaffee");
1056 module_init(init_vfat_fs)
1057 module_exit(exit_vfat_fs)