super.c 15 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667
  1. /* Block- or MTD-based romfs
  2. *
  3. * Copyright © 2007 Red Hat, Inc. All Rights Reserved.
  4. * Written by David Howells (dhowells@redhat.com)
  5. *
  6. * Derived from: ROMFS file system, Linux implementation
  7. *
  8. * Copyright © 1997-1999 Janos Farkas <chexum@shadow.banki.hu>
  9. *
  10. * Using parts of the minix filesystem
  11. * Copyright © 1991, 1992 Linus Torvalds
  12. *
  13. * and parts of the affs filesystem additionally
  14. * Copyright © 1993 Ray Burr
  15. * Copyright © 1996 Hans-Joachim Widmaier
  16. *
  17. * Changes
  18. * Changed for 2.1.19 modules
  19. * Jan 1997 Initial release
  20. * Jun 1997 2.1.43+ changes
  21. * Proper page locking in readpage
  22. * Changed to work with 2.1.45+ fs
  23. * Jul 1997 Fixed follow_link
  24. * 2.1.47
  25. * lookup shouldn't return -ENOENT
  26. * from Horst von Brand:
  27. * fail on wrong checksum
  28. * double unlock_super was possible
  29. * correct namelen for statfs
  30. * spotted by Bill Hawes:
  31. * readlink shouldn't iput()
  32. * Jun 1998 2.1.106 from Avery Pennarun: glibc scandir()
  33. * exposed a problem in readdir
  34. * 2.1.107 code-freeze spellchecker run
  35. * Aug 1998 2.1.118+ VFS changes
  36. * Sep 1998 2.1.122 another VFS change (follow_link)
  37. * Apr 1999 2.2.7 no more EBADF checking in
  38. * lookup/readdir, use ERR_PTR
  39. * Jun 1999 2.3.6 d_alloc_root use changed
  40. * 2.3.9 clean up usage of ENOENT/negative
  41. * dentries in lookup
  42. * clean up page flags setting
  43. * (error, uptodate, locking) in
  44. * in readpage
  45. * use init_special_inode for
  46. * fifos/sockets (and streamline) in
  47. * read_inode, fix _ops table order
  48. * Aug 1999 2.3.16 __initfunc() => __init change
  49. * Oct 1999 2.3.24 page->owner hack obsoleted
  50. * Nov 1999 2.3.27 2.3.25+ page->offset => index change
  51. *
  52. *
  53. * This program is free software; you can redistribute it and/or
  54. * modify it under the terms of the GNU General Public Licence
  55. * as published by the Free Software Foundation; either version
  56. * 2 of the Licence, or (at your option) any later version.
  57. */
  58. #include <linux/module.h>
  59. #include <linux/string.h>
  60. #include <linux/fs.h>
  61. #include <linux/time.h>
  62. #include <linux/slab.h>
  63. #include <linux/init.h>
  64. #include <linux/blkdev.h>
  65. #include <linux/parser.h>
  66. #include <linux/mount.h>
  67. #include <linux/namei.h>
  68. #include <linux/statfs.h>
  69. #include <linux/mtd/super.h>
  70. #include <linux/ctype.h>
  71. #include <linux/highmem.h>
  72. #include <linux/pagemap.h>
  73. #include <linux/uaccess.h>
  74. #include "internal.h"
  75. static struct kmem_cache *romfs_inode_cachep;
  76. static const umode_t romfs_modemap[8] = {
  77. 0, /* hard link */
  78. S_IFDIR | 0644, /* directory */
  79. S_IFREG | 0644, /* regular file */
  80. S_IFLNK | 0777, /* symlink */
  81. S_IFBLK | 0600, /* blockdev */
  82. S_IFCHR | 0600, /* chardev */
  83. S_IFSOCK | 0644, /* socket */
  84. S_IFIFO | 0644 /* FIFO */
  85. };
  86. static const unsigned char romfs_dtype_table[] = {
  87. DT_UNKNOWN, DT_DIR, DT_REG, DT_LNK, DT_BLK, DT_CHR, DT_SOCK, DT_FIFO
  88. };
  89. static struct inode *romfs_iget(struct super_block *sb, unsigned long pos);
  90. /*
  91. * read a page worth of data from the image
  92. */
  93. static int romfs_readpage(struct file *file, struct page *page)
  94. {
  95. struct inode *inode = page->mapping->host;
  96. loff_t offset, size;
  97. unsigned long fillsize, pos;
  98. void *buf;
  99. int ret;
  100. buf = kmap(page);
  101. if (!buf)
  102. return -ENOMEM;
  103. /* 32 bit warning -- but not for us :) */
  104. offset = page_offset(page);
  105. size = i_size_read(inode);
  106. fillsize = 0;
  107. ret = 0;
  108. if (offset < size) {
  109. size -= offset;
  110. fillsize = size > PAGE_SIZE ? PAGE_SIZE : size;
  111. pos = ROMFS_I(inode)->i_dataoffset + offset;
  112. ret = romfs_dev_read(inode->i_sb, pos, buf, fillsize);
  113. if (ret < 0) {
  114. SetPageError(page);
  115. fillsize = 0;
  116. ret = -EIO;
  117. }
  118. }
  119. if (fillsize < PAGE_SIZE)
  120. memset(buf + fillsize, 0, PAGE_SIZE - fillsize);
  121. if (ret == 0)
  122. SetPageUptodate(page);
  123. flush_dcache_page(page);
  124. kunmap(page);
  125. unlock_page(page);
  126. return ret;
  127. }
  128. static const struct address_space_operations romfs_aops = {
  129. .readpage = romfs_readpage
  130. };
  131. /*
  132. * read the entries from a directory
  133. */
  134. static int romfs_readdir(struct file *filp, void *dirent, filldir_t filldir)
  135. {
  136. struct inode *i = filp->f_dentry->d_inode;
  137. struct romfs_inode ri;
  138. unsigned long offset, maxoff;
  139. int j, ino, nextfh;
  140. int stored = 0;
  141. char fsname[ROMFS_MAXFN]; /* XXX dynamic? */
  142. int ret;
  143. maxoff = romfs_maxsize(i->i_sb);
  144. offset = filp->f_pos;
  145. if (!offset) {
  146. offset = i->i_ino & ROMFH_MASK;
  147. ret = romfs_dev_read(i->i_sb, offset, &ri, ROMFH_SIZE);
  148. if (ret < 0)
  149. goto out;
  150. offset = be32_to_cpu(ri.spec) & ROMFH_MASK;
  151. }
  152. /* Not really failsafe, but we are read-only... */
  153. for (;;) {
  154. if (!offset || offset >= maxoff) {
  155. offset = maxoff;
  156. filp->f_pos = offset;
  157. goto out;
  158. }
  159. filp->f_pos = offset;
  160. /* Fetch inode info */
  161. ret = romfs_dev_read(i->i_sb, offset, &ri, ROMFH_SIZE);
  162. if (ret < 0)
  163. goto out;
  164. j = romfs_dev_strnlen(i->i_sb, offset + ROMFH_SIZE,
  165. sizeof(fsname) - 1);
  166. if (j < 0)
  167. goto out;
  168. ret = romfs_dev_read(i->i_sb, offset + ROMFH_SIZE, fsname, j);
  169. if (ret < 0)
  170. goto out;
  171. fsname[j] = '\0';
  172. ino = offset;
  173. nextfh = be32_to_cpu(ri.next);
  174. if ((nextfh & ROMFH_TYPE) == ROMFH_HRD)
  175. ino = be32_to_cpu(ri.spec);
  176. if (filldir(dirent, fsname, j, offset, ino,
  177. romfs_dtype_table[nextfh & ROMFH_TYPE]) < 0)
  178. goto out;
  179. stored++;
  180. offset = nextfh & ROMFH_MASK;
  181. }
  182. out:
  183. return stored;
  184. }
  185. /*
  186. * look up an entry in a directory
  187. */
  188. static struct dentry *romfs_lookup(struct inode *dir, struct dentry *dentry,
  189. struct nameidata *nd)
  190. {
  191. unsigned long offset, maxoff;
  192. struct inode *inode;
  193. struct romfs_inode ri;
  194. const char *name; /* got from dentry */
  195. int len, ret;
  196. offset = dir->i_ino & ROMFH_MASK;
  197. ret = romfs_dev_read(dir->i_sb, offset, &ri, ROMFH_SIZE);
  198. if (ret < 0)
  199. goto error;
  200. /* search all the file entries in the list starting from the one
  201. * pointed to by the directory's special data */
  202. maxoff = romfs_maxsize(dir->i_sb);
  203. offset = be32_to_cpu(ri.spec) & ROMFH_MASK;
  204. name = dentry->d_name.name;
  205. len = dentry->d_name.len;
  206. for (;;) {
  207. if (!offset || offset >= maxoff)
  208. goto out0;
  209. ret = romfs_dev_read(dir->i_sb, offset, &ri, sizeof(ri));
  210. if (ret < 0)
  211. goto error;
  212. /* try to match the first 16 bytes of name */
  213. ret = romfs_dev_strcmp(dir->i_sb, offset + ROMFH_SIZE, name,
  214. len);
  215. if (ret < 0)
  216. goto error;
  217. if (ret == 1)
  218. break;
  219. /* next entry */
  220. offset = be32_to_cpu(ri.next) & ROMFH_MASK;
  221. }
  222. /* Hard link handling */
  223. if ((be32_to_cpu(ri.next) & ROMFH_TYPE) == ROMFH_HRD)
  224. offset = be32_to_cpu(ri.spec) & ROMFH_MASK;
  225. inode = romfs_iget(dir->i_sb, offset);
  226. if (IS_ERR(inode)) {
  227. ret = PTR_ERR(inode);
  228. goto error;
  229. }
  230. goto outi;
  231. /*
  232. * it's a bit funky, _lookup needs to return an error code
  233. * (negative) or a NULL, both as a dentry. ENOENT should not
  234. * be returned, instead we need to create a negative dentry by
  235. * d_add(dentry, NULL); and return 0 as no error.
  236. * (Although as I see, it only matters on writable file
  237. * systems).
  238. */
  239. out0:
  240. inode = NULL;
  241. outi:
  242. d_add(dentry, inode);
  243. ret = 0;
  244. error:
  245. return ERR_PTR(ret);
  246. }
  247. static const struct file_operations romfs_dir_operations = {
  248. .read = generic_read_dir,
  249. .readdir = romfs_readdir,
  250. .llseek = default_llseek,
  251. };
  252. static const struct inode_operations romfs_dir_inode_operations = {
  253. .lookup = romfs_lookup,
  254. };
  255. /*
  256. * get a romfs inode based on its position in the image (which doubles as the
  257. * inode number)
  258. */
  259. static struct inode *romfs_iget(struct super_block *sb, unsigned long pos)
  260. {
  261. struct romfs_inode_info *inode;
  262. struct romfs_inode ri;
  263. struct inode *i;
  264. unsigned long nlen;
  265. unsigned nextfh;
  266. int ret;
  267. umode_t mode;
  268. /* we might have to traverse a chain of "hard link" file entries to get
  269. * to the actual file */
  270. for (;;) {
  271. ret = romfs_dev_read(sb, pos, &ri, sizeof(ri));
  272. if (ret < 0)
  273. goto error;
  274. /* XXX: do romfs_checksum here too (with name) */
  275. nextfh = be32_to_cpu(ri.next);
  276. if ((nextfh & ROMFH_TYPE) != ROMFH_HRD)
  277. break;
  278. pos = be32_to_cpu(ri.spec) & ROMFH_MASK;
  279. }
  280. /* determine the length of the filename */
  281. nlen = romfs_dev_strnlen(sb, pos + ROMFH_SIZE, ROMFS_MAXFN);
  282. if (IS_ERR_VALUE(nlen))
  283. goto eio;
  284. /* get an inode for this image position */
  285. i = iget_locked(sb, pos);
  286. if (!i)
  287. return ERR_PTR(-ENOMEM);
  288. if (!(i->i_state & I_NEW))
  289. return i;
  290. /* precalculate the data offset */
  291. inode = ROMFS_I(i);
  292. inode->i_metasize = (ROMFH_SIZE + nlen + 1 + ROMFH_PAD) & ROMFH_MASK;
  293. inode->i_dataoffset = pos + inode->i_metasize;
  294. set_nlink(i, 1); /* Hard to decide.. */
  295. i->i_size = be32_to_cpu(ri.size);
  296. i->i_mtime.tv_sec = i->i_atime.tv_sec = i->i_ctime.tv_sec = 0;
  297. i->i_mtime.tv_nsec = i->i_atime.tv_nsec = i->i_ctime.tv_nsec = 0;
  298. /* set up mode and ops */
  299. mode = romfs_modemap[nextfh & ROMFH_TYPE];
  300. switch (nextfh & ROMFH_TYPE) {
  301. case ROMFH_DIR:
  302. i->i_size = ROMFS_I(i)->i_metasize;
  303. i->i_op = &romfs_dir_inode_operations;
  304. i->i_fop = &romfs_dir_operations;
  305. if (nextfh & ROMFH_EXEC)
  306. mode |= S_IXUGO;
  307. break;
  308. case ROMFH_REG:
  309. i->i_fop = &romfs_ro_fops;
  310. i->i_data.a_ops = &romfs_aops;
  311. if (i->i_sb->s_mtd)
  312. i->i_data.backing_dev_info =
  313. i->i_sb->s_mtd->backing_dev_info;
  314. if (nextfh & ROMFH_EXEC)
  315. mode |= S_IXUGO;
  316. break;
  317. case ROMFH_SYM:
  318. i->i_op = &page_symlink_inode_operations;
  319. i->i_data.a_ops = &romfs_aops;
  320. mode |= S_IRWXUGO;
  321. break;
  322. default:
  323. /* depending on MBZ for sock/fifos */
  324. nextfh = be32_to_cpu(ri.spec);
  325. init_special_inode(i, mode, MKDEV(nextfh >> 16,
  326. nextfh & 0xffff));
  327. break;
  328. }
  329. i->i_mode = mode;
  330. unlock_new_inode(i);
  331. return i;
  332. eio:
  333. ret = -EIO;
  334. error:
  335. printk(KERN_ERR "ROMFS: read error for inode 0x%lx\n", pos);
  336. return ERR_PTR(ret);
  337. }
  338. /*
  339. * allocate a new inode
  340. */
  341. static struct inode *romfs_alloc_inode(struct super_block *sb)
  342. {
  343. struct romfs_inode_info *inode;
  344. inode = kmem_cache_alloc(romfs_inode_cachep, GFP_KERNEL);
  345. return inode ? &inode->vfs_inode : NULL;
  346. }
  347. /*
  348. * return a spent inode to the slab cache
  349. */
  350. static void romfs_i_callback(struct rcu_head *head)
  351. {
  352. struct inode *inode = container_of(head, struct inode, i_rcu);
  353. kmem_cache_free(romfs_inode_cachep, ROMFS_I(inode));
  354. }
  355. static void romfs_destroy_inode(struct inode *inode)
  356. {
  357. call_rcu(&inode->i_rcu, romfs_i_callback);
  358. }
  359. /*
  360. * get filesystem statistics
  361. */
  362. static int romfs_statfs(struct dentry *dentry, struct kstatfs *buf)
  363. {
  364. struct super_block *sb = dentry->d_sb;
  365. u64 id = huge_encode_dev(sb->s_bdev->bd_dev);
  366. buf->f_type = ROMFS_MAGIC;
  367. buf->f_namelen = ROMFS_MAXFN;
  368. buf->f_bsize = ROMBSIZE;
  369. buf->f_bfree = buf->f_bavail = buf->f_ffree;
  370. buf->f_blocks =
  371. (romfs_maxsize(dentry->d_sb) + ROMBSIZE - 1) >> ROMBSBITS;
  372. buf->f_fsid.val[0] = (u32)id;
  373. buf->f_fsid.val[1] = (u32)(id >> 32);
  374. return 0;
  375. }
  376. /*
  377. * remounting must involve read-only
  378. */
  379. static int romfs_remount(struct super_block *sb, int *flags, char *data)
  380. {
  381. sync_filesystem(sb);
  382. *flags |= MS_RDONLY;
  383. return 0;
  384. }
  385. static const struct super_operations romfs_super_ops = {
  386. .alloc_inode = romfs_alloc_inode,
  387. .destroy_inode = romfs_destroy_inode,
  388. .statfs = romfs_statfs,
  389. .remount_fs = romfs_remount,
  390. };
  391. /*
  392. * checksum check on part of a romfs filesystem
  393. */
  394. static __u32 romfs_checksum(const void *data, int size)
  395. {
  396. const __be32 *ptr = data;
  397. __u32 sum;
  398. sum = 0;
  399. size >>= 2;
  400. while (size > 0) {
  401. sum += be32_to_cpu(*ptr++);
  402. size--;
  403. }
  404. return sum;
  405. }
  406. /*
  407. * fill in the superblock
  408. */
  409. static int romfs_fill_super(struct super_block *sb, void *data, int silent)
  410. {
  411. struct romfs_super_block *rsb;
  412. struct inode *root;
  413. unsigned long pos, img_size;
  414. const char *storage;
  415. size_t len;
  416. int ret;
  417. #ifdef CONFIG_BLOCK
  418. if (!sb->s_mtd) {
  419. sb_set_blocksize(sb, ROMBSIZE);
  420. } else {
  421. sb->s_blocksize = ROMBSIZE;
  422. sb->s_blocksize_bits = blksize_bits(ROMBSIZE);
  423. }
  424. #endif
  425. sb->s_maxbytes = 0xFFFFFFFF;
  426. sb->s_magic = ROMFS_MAGIC;
  427. sb->s_flags |= MS_RDONLY | MS_NOATIME;
  428. sb->s_op = &romfs_super_ops;
  429. /* read the image superblock and check it */
  430. rsb = kmalloc(512, GFP_KERNEL);
  431. if (!rsb)
  432. return -ENOMEM;
  433. sb->s_fs_info = (void *) 512;
  434. ret = romfs_dev_read(sb, 0, rsb, 512);
  435. if (ret < 0)
  436. goto error_rsb;
  437. img_size = be32_to_cpu(rsb->size);
  438. if (sb->s_mtd && img_size > sb->s_mtd->size)
  439. goto error_rsb_inval;
  440. sb->s_fs_info = (void *) img_size;
  441. if (rsb->word0 != ROMSB_WORD0 || rsb->word1 != ROMSB_WORD1 ||
  442. img_size < ROMFH_SIZE) {
  443. if (!silent)
  444. printk(KERN_WARNING "VFS:"
  445. " Can't find a romfs filesystem on dev %s.\n",
  446. sb->s_id);
  447. goto error_rsb_inval;
  448. }
  449. if (romfs_checksum(rsb, min_t(size_t, img_size, 512))) {
  450. printk(KERN_ERR "ROMFS: bad initial checksum on dev %s.\n",
  451. sb->s_id);
  452. goto error_rsb_inval;
  453. }
  454. storage = sb->s_mtd ? "MTD" : "the block layer";
  455. len = strnlen(rsb->name, ROMFS_MAXFN);
  456. if (!silent)
  457. printk(KERN_NOTICE "ROMFS: Mounting image '%*.*s' through %s\n",
  458. (unsigned) len, (unsigned) len, rsb->name, storage);
  459. kfree(rsb);
  460. rsb = NULL;
  461. /* find the root directory */
  462. pos = (ROMFH_SIZE + len + 1 + ROMFH_PAD) & ROMFH_MASK;
  463. root = romfs_iget(sb, pos);
  464. if (IS_ERR(root))
  465. goto error;
  466. sb->s_root = d_make_root(root);
  467. if (!sb->s_root)
  468. goto error;
  469. return 0;
  470. error:
  471. return -EINVAL;
  472. error_rsb_inval:
  473. ret = -EINVAL;
  474. error_rsb:
  475. kfree(rsb);
  476. return ret;
  477. }
  478. /*
  479. * get a superblock for mounting
  480. */
  481. static struct dentry *romfs_mount(struct file_system_type *fs_type,
  482. int flags, const char *dev_name,
  483. void *data)
  484. {
  485. struct dentry *ret = ERR_PTR(-EINVAL);
  486. #ifdef CONFIG_ROMFS_ON_MTD
  487. ret = mount_mtd(fs_type, flags, dev_name, data, romfs_fill_super);
  488. #endif
  489. #ifdef CONFIG_ROMFS_ON_BLOCK
  490. if (ret == ERR_PTR(-EINVAL))
  491. ret = mount_bdev(fs_type, flags, dev_name, data,
  492. romfs_fill_super);
  493. #endif
  494. return ret;
  495. }
  496. /*
  497. * destroy a romfs superblock in the appropriate manner
  498. */
  499. static void romfs_kill_sb(struct super_block *sb)
  500. {
  501. #ifdef CONFIG_ROMFS_ON_MTD
  502. if (sb->s_mtd) {
  503. kill_mtd_super(sb);
  504. return;
  505. }
  506. #endif
  507. #ifdef CONFIG_ROMFS_ON_BLOCK
  508. if (sb->s_bdev) {
  509. kill_block_super(sb);
  510. return;
  511. }
  512. #endif
  513. }
  514. static struct file_system_type romfs_fs_type = {
  515. .owner = THIS_MODULE,
  516. .name = "romfs",
  517. .mount = romfs_mount,
  518. .kill_sb = romfs_kill_sb,
  519. .fs_flags = FS_REQUIRES_DEV,
  520. };
  521. MODULE_ALIAS_FS("romfs");
  522. /*
  523. * inode storage initialiser
  524. */
  525. static void romfs_i_init_once(void *_inode)
  526. {
  527. struct romfs_inode_info *inode = _inode;
  528. inode_init_once(&inode->vfs_inode);
  529. }
  530. /*
  531. * romfs module initialisation
  532. */
  533. static int __init init_romfs_fs(void)
  534. {
  535. int ret;
  536. printk(KERN_INFO "ROMFS MTD (C) 2007 Red Hat, Inc.\n");
  537. romfs_inode_cachep =
  538. kmem_cache_create("romfs_i",
  539. sizeof(struct romfs_inode_info), 0,
  540. SLAB_RECLAIM_ACCOUNT | SLAB_MEM_SPREAD,
  541. romfs_i_init_once);
  542. if (!romfs_inode_cachep) {
  543. printk(KERN_ERR
  544. "ROMFS error: Failed to initialise inode cache\n");
  545. return -ENOMEM;
  546. }
  547. ret = register_filesystem(&romfs_fs_type);
  548. if (ret) {
  549. printk(KERN_ERR "ROMFS error: Failed to register filesystem\n");
  550. goto error_register;
  551. }
  552. return 0;
  553. error_register:
  554. kmem_cache_destroy(romfs_inode_cachep);
  555. return ret;
  556. }
  557. /*
  558. * romfs module removal
  559. */
  560. static void __exit exit_romfs_fs(void)
  561. {
  562. unregister_filesystem(&romfs_fs_type);
  563. /*
  564. * Make sure all delayed rcu free inodes are flushed before we
  565. * destroy cache.
  566. */
  567. rcu_barrier();
  568. kmem_cache_destroy(romfs_inode_cachep);
  569. }
  570. module_init(init_romfs_fs);
  571. module_exit(exit_romfs_fs);
  572. MODULE_DESCRIPTION("Direct-MTD Capable RomFS");
  573. MODULE_AUTHOR("Red Hat, Inc.");
  574. MODULE_LICENSE("GPL"); /* Actually dual-licensed, but it doesn't matter for */